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
| Herramienta | Registro y paquete | Autenticación | Requisitos |
|---|---|---|---|
| SDK JavaScript / TypeScript | npm @luaward/sdk | Developer API key (lwa_live_...) | Node.js / fetch estándar |
| SDK Python | PyPI luaward | Developer API key (lwa_live_...) | Python 3.10+, cero dependencias externas |
| Luaward CLI | npm @luaward/cli | Personal token (lwm_...) | Node.js 20+ |
| GitHub oficial | github.com/luaward | Repositorios y documentación | Organización oficial |
SDK JavaScript / TypeScript (@luaward/sdk)
Instala desde npm:
npm install @luaward/sdkInicializa 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.comy añade/v3automáticamente. - Recursos incluidos:
projects,keys,scripts,stats,lw.request()genérico yLuarmorCompat(compara los campos antes de migrar). - Reintentos y errores: Reintenta HTTP
429y503hasta 3 veces respetandoRetry-Aftery 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 luawardUsa 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
urllibestándar (requiere Python 3.10+).AsyncLuawardClientdelega las llamadas medianteasyncio.to_thread(). - Cobertura: El cliente síncrono incluye
keys,scripts,statsyrequest(), mientras que el cliente asíncrono exponekeysyrequest(). IncluyeLuarmorCompatyAsyncLuarmorCompat. - Reintentos y excepciones: Reintenta HTTP
429y503hasta 3 veces y define excepciones tipadas enluaward.exceptions.
Luaward CLI (@luaward/cli)
Instala globalmente desde npm (requiere Node.js 20+):
npm install -g @luaward/cli
luaward --versionO 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_...) contrahttps://luaward.com/api/ide(las claveslwa_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 conLUAWARD_CONFIG_DIR) o medianteLUAWARD_TOKEN. - Comandos principales:
login,init,scripts,pull,push,toggle,sessions,pair,dev,exec,stop,keysyerrors, todos compatibles con--json/-jpara 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
.vsixprobado durante el Early Access. - IA y MCP: Conecta Claude, ChatGPT, Claude Code o Cursor a tus sesiones y scripts con Workspace MCP.