SDK и CLI
Установка официальных пакетов @luaward/sdk, luaward (Python) и @luaward/cli из npm и PyPI, а также различия токенов.
Проверяйте официальные названия пакетов перед установкой
Устанавливайте пакеты только по официальным ссылкам ниже и через github.com/luaward. Следите за типом токена: SDK используют Developer API key воркспейса (lwa_live_...), а CLI требует Personal token (lwm_...).
Официальные пакеты
| Инструмент | Реестр и пакет | Аутентификация | Требования |
|---|---|---|---|
| JS / TS SDK | npm @luaward/sdk | Developer API key (lwa_live_...) | Node.js / стандартный fetch |
| Python SDK | PyPI luaward | Developer API key (lwa_live_...) | Python 3.10+, без внешних зависимостей |
| Luaward CLI | npm @luaward/cli | Personal token (lwm_...) | Node.js 20+ |
| Официальный GitHub | github.com/luaward | Репозитории и документация | Официальная организация |
JavaScript / TypeScript SDK (@luaward/sdk)
Установка из npm:
npm install @luaward/sdkИнициализируйте LuawardClient на сервере с помощью Developer API key (lwa_live_...) и ID проекта:
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: По умолчанию
https://api.luaward.com(префикс/v3добавляется автоматически). - Доступные модули:
projects,keys,scripts,stats, универсальныйlw.request()иLuarmorCompat(сверяйте поля перед миграцией). - Повторы и ошибки: Повторяет HTTP
429и503до 3 раз с учётомRetry-Afterи выбрасывает типизированные ошибки (LuawardAuthError,LuawardRateLimitError,LuawardPlanLimitError,LuawardNotFoundError,LuawardError).
Подробности по scope и эндпоинтам см. в Обзоре Developer API и Справочнике API v3.
Python SDK (luaward)
Установка из PyPI:
pip install luawardИспользуйте LuawardClient в синхронных скриптах или AsyncLuawardClient в асинхронном коде:
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"])- Без внешних зависимостей: Использует стандартный модуль
urllibи требует Python 3.10+.AsyncLuawardClientвыполняет запросы черезasyncio.to_thread(). - Функциональность: Синхронный клиент содержит
keys,scripts,statsиrequest(), асинхронный предоставляетkeysиrequest(). Также включеныLuarmorCompatиAsyncLuarmorCompat. - Повторы и исключения: Повторяет HTTP
429и503до 3 раз; типизированные исключения находятся вluaward.exceptions.
Luaward CLI (@luaward/cli)
Глобальная установка из npm (требуется Node.js 20+):
npm install -g @luaward/cli
luaward --versionЛибо установка из официального tarball с luaward.com:
npm install -g https://luaward.com/luaward-cli.tgz
luaward --version- Учётные данные и Early Access: Использует Personal token (
lwm_...) для эндпоинтаhttps://luaward.com/api/ide(ключlwa_live_...не подойдёт). Сейчас панель управления и IDE API находятся в режиме Early Access. - Хранение токена: В
~/.config/luaward/credentials.json(переопределяется черезLUAWARD_CONFIG_DIR) либо через переменнуюLUAWARD_TOKEN. - Основные команды:
login,init,scripts,pull,push,toggle,sessions,pair,dev,exec,stop,keysиerrors, с поддержкой--json/-jдля CI.
IDE, ИИ и MCP
- Расширение для VS Code / Cursor: Пока не опубликовано в VS Code Marketplace и Open VSX. Обратитесь в поддержку, чтобы получить проверенный
.vsixна этапе Early Access. - ИИ и MCP: Подключайте Claude, ChatGPT, Claude Code или Cursor к своим игровым сессиям и скриптам через Workspace MCP.