LuawardDocs

SDKs y CLI

Instala los paquetes oficiales @luaward/sdk, luaward (Python) y @luaward/cli desde npm y PyPI y aprende qué token necesita cada uno.

Verifica los paquetes oficiales antes de instalar

Instala únicamente desde los enlaces oficiales de abajo y github.com/luaward. Usa la credencial correcta en cada herramienta: los SDK emplean una Developer API key del workspace (lwa_live_...), mientras que la CLI usa un Personal token (lwm_...).

Paquetes oficiales

HerramientaRegistro y paqueteAutenticaciónRequisitos
SDK JavaScript / TypeScriptnpm @luaward/sdkDeveloper API key (lwa_live_...)Node.js / fetch estándar
SDK PythonPyPI luawardDeveloper API key (lwa_live_...)Python 3.10+, cero dependencias externas
Luaward CLInpm @luaward/cliPersonal token (lwm_...)Node.js 20+
GitHub oficialgithub.com/luawardRepositorios y documentaciónOrganización oficial

SDK JavaScript / TypeScript (@luaward/sdk)

Instala desde npm:

npm install @luaward/sdk

Inicializa LuawardClient en el servidor con tu Developer API key (lwa_live_...) y el ID del proyecto:

import { LuawardClient } from "@luaward/sdk";

const lw = new LuawardClient({
  apiKey: process.env.LUAWARD_API_KEY,
  projectId: process.env.LUAWARD_PROJECT_ID,
});

const created = await lw.keys.create({
  discord_id: "123456789012345678",
  key_days: 30,
  note: "Monthly access",
});

const queued = await lw.scripts.upload(process.env.LUAWARD_SCRIPT_ID, {
  source: 'print("Hello from SDK")',
  preset: "balanced",
});
  • URL base: Por defecto usa https://api.luaward.com y añade /v3 automáticamente.
  • Recursos incluidos: projects, keys, scripts, stats, lw.request() genérico y LuarmorCompat (compara los campos antes de migrar).
  • Reintentos y errores: Reintenta HTTP 429 y 503 hasta 3 veces respetando Retry-After y lanza errores tipados (LuawardAuthError, LuawardRateLimitError, LuawardPlanLimitError, LuawardNotFoundError, LuawardError).

Consulta todos los scopes y endpoints en Resumen de la API y Referencia de la API v3.

SDK Python (luaward)

Instala desde PyPI:

pip install luaward

Usa LuawardClient en código síncrono o AsyncLuawardClient en flujos asíncronos:

import os
from luaward import LuawardClient

lw = LuawardClient(
    api_key=os.environ["LUAWARD_API_KEY"],
    project_id=os.environ["LUAWARD_PROJECT_ID"],
)

created = lw.keys.create(
    discord_id="123456789012345678",
    key_days=30,
    note="Monthly access",
)
print(created["user_key"])
  • Cero dependencias externas: Utiliza urllib estándar (requiere Python 3.10+). AsyncLuawardClient delega las llamadas mediante asyncio.to_thread().
  • Cobertura: El cliente síncrono incluye keys, scripts, stats y request(), mientras que el cliente asíncrono expone keys y request(). Incluye LuarmorCompat y AsyncLuarmorCompat.
  • Reintentos y excepciones: Reintenta HTTP 429 y 503 hasta 3 veces y define excepciones tipadas en luaward.exceptions.

Luaward CLI (@luaward/cli)

Instala globalmente desde npm (requiere Node.js 20+):

npm install -g @luaward/cli
luaward --version

O instala desde el tarball oficial en luaward.com:

npm install -g https://luaward.com/luaward-cli.tgz
luaward --version
  • Credenciales y Early Access: Se autentica con un Personal token (lwm_...) contra https://luaward.com/api/ide (las claves lwa_live_... no sirven en la CLI). El panel y la API de IDE están en Early Access.
  • Almacenamiento de credenciales: Se guardan en ~/.config/luaward/credentials.json (ajustable con LUAWARD_CONFIG_DIR) o mediante LUAWARD_TOKEN.
  • Comandos principales: login, init, scripts, pull, push, toggle, sessions, pair, dev, exec, stop, keys y errors, todos compatibles con --json / -j para CI.

IDE, IA y MCP

  • Extensión de VS Code / Cursor: Aún no está publicada en VS Code Marketplace ni Open VSX. Contacta con soporte para solicitar un archivo .vsix probado durante el Early Access.
  • IA y MCP: Conecta Claude, ChatGPT, Claude Code o Cursor a tus sesiones y scripts con Workspace MCP.