LuawardDocs

SDKs e CLI

Instale os pacotes oficiais @luaward/sdk, luaward (Python) e @luaward/cli via npm e PyPI e veja qual token cada um usa.

Confira os pacotes oficiais antes de instalar

Instale apenas pelos links oficiais abaixo e por github.com/luaward. Observe o tipo de credencial: os SDKs usam uma Developer API key do workspace (lwa_live_...), enquanto a CLI usa um Personal token (lwm_...).

Pacotes oficiais

FerramentaRegistro e pacoteAutenticaçãoRequisitos
SDK JavaScript / TypeScriptnpm @luaward/sdkDeveloper API key (lwa_live_...)Node.js / fetch padrão
SDK PythonPyPI luawardDeveloper API key (lwa_live_...)Python 3.10+, zero dependências externas
Luaward CLInpm @luaward/cliPersonal token (lwm_...)Node.js 20+
GitHub oficialgithub.com/luawardRepositórios e documentaçãoOrganização oficial

SDK JavaScript / TypeScript (@luaward/sdk)

Instale pelo npm:

npm install @luaward/sdk

Inicialize o LuawardClient no servidor usando sua Developer API key (lwa_live_...) e o ID do projeto:

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: O padrão é https://api.luaward.com, com /v3 adicionado automaticamente.
  • Recursos incluídos: projects, keys, scripts, stats, lw.request() genérico e LuarmorCompat (compare os campos antes de migrar).
  • Novas tentativas e erros: Repete respostas HTTP 429 e 503 até 3 vezes respeitando Retry-After e lança classes tipadas (LuawardAuthError, LuawardRateLimitError, LuawardPlanLimitError, LuawardNotFoundError, LuawardError).

Veja os scopes e endpoints completos em Visão geral da API e Referência da API v3.

SDK Python (luaward)

Instale pelo PyPI:

pip install luaward

Use LuawardClient em scripts síncronos ou AsyncLuawardClient em fluxos assí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"])
  • Zero dependências externas: Usa urllib da biblioteca padrão (requer Python 3.10+). AsyncLuawardClient executa chamadas usando asyncio.to_thread().
  • Cobertura: O cliente síncrono oferece keys, scripts, stats e request(), enquanto o cliente assíncrono oferece keys e request(). Inclui LuarmorCompat e AsyncLuarmorCompat.
  • Novas tentativas e exceções: Repete HTTP 429 e 503 até 3 vezes e usa exceções tipadas em luaward.exceptions.

Luaward CLI (@luaward/cli)

Instale globalmente pelo npm (requer Node.js 20+):

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

Ou instale pelo tarball oficial em luaward.com:

npm install -g https://luaward.com/luaward-cli.tgz
luaward --version
  • Credenciais e Early Access: Autentica com um Personal token (lwm_...) em https://luaward.com/api/ide (chaves lwa_live_... não funcionam na CLI). O acesso ao painel e ao IDE API está em Early Access.
  • Armazenamento local: Salvo em ~/.config/luaward/credentials.json (altere com LUAWARD_CONFIG_DIR) ou enviado via LUAWARD_TOKEN.
  • Comandos principais: login, init, scripts, pull, push, toggle, sessions, pair, dev, exec, stop, keys e errors, todos compatíveis com --json / -j para CI.

IDE, IA e MCP

  • Extensão para VS Code / Cursor: Ainda não está publicada no VS Code Marketplace ou Open VSX. Fale com o suporte para solicitar um pacote .vsix testado durante o Early Access.
  • IA e MCP: Conecte Claude, ChatGPT, Claude Code ou Cursor às suas sessões de teste e scripts seguindo Workspace MCP.