Metadata-Version: 2.4
Name: luaward
Version: 0.1.0
Summary: Official Luaward Python SDK (Sync & Async) with Luarmor drop-in compatibility wrapper
Author-email: Luaward <support@luaward.com>
License: MIT
Project-URL: Homepage, https://luaward.com
Project-URL: Documentation, https://luaward.com/docs
Project-URL: Repository, https://github.com/luaward
Keywords: luaward,luau,roblox,sdk,licensing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# luaward — Python SDK

Client แบบ sync และ async สำหรับ Luaward Developer REST API `/v3` พร้อม `LuarmorCompat` ต้องใช้ Python **3.10 ขึ้นไป**

## การติดตั้ง (Installation)

```bash
pip install luaward
```

Official Python SDK สำหรับ [Luaward](https://luaward.com) — รองรับทั้ง sync และ async โดยไม่ต้องติดตั้ง dependency เพิ่ม (async เรียก sync HTTP client ผ่าน `asyncio.to_thread()` และใช้ `urllib` มาตรฐาน ไม่มี dependency ภายนอก; ดูเอกสารเพิ่มเติมที่ [luaward.com/docs](https://luaward.com/docs) และ [github.com/luaward](https://github.com/luaward))

## Credentials และ URL

ใช้ **Developer API key** `lwa_live_…` จาก Developer API ของ workspace ผ่าน argument `api_key` ไม่ใช่ `token` และไม่ใช่ personal token `lwm_…` ของ CLI/IDE/MCP ค่าเริ่มต้น `base_url` คือ `https://api.luaward.com` โดย client เติม `/v3` เอง ID ของโปรเจกต์และสคริปต์เป็นค่าจริง 32 ตัวอักษรฐานสิบหกจาก dashboard/API เก็บ credentials ไว้ใน environment ฝั่งเซิร์ฟเวอร์

## Sync client

```python
import os
from luaward import LuawardClient, LuarmorCompat

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("Generated key:", created["user_key"])
lw.keys.reset_hwid(created["user_key"])

queued = lw.scripts.upload(
    os.environ["LUAWARD_SCRIPT_ID"],
    'print("Hello from SDK")',
    preset="balanced",
)
print("Queued build:", queued["build_id"])

compat = LuarmorCompat(
    api_key=os.environ["LUAWARD_API_KEY"],
    project_id=os.environ["LUAWARD_PROJECT_ID"],
)
compat.reset_hwid(user_key=created["user_key"], force=True)
```

`key_days` เริ่มนับเมื่อใช้คีย์ครั้งแรก ส่วน `auth_expire` กำหนดเวลาหมดอายุเป็น Unix seconds และมีลำดับความสำคัญเหนือ `key_days` ค่าของ preset คือ `fast`, `balanced` หรือ `max` เมื่อ build ใหม่ **Ready** loader จะใช้ build นั้นอัตโนมัติหากไม่มีรุ่นใหม่กว่าถูกเลือกไว้

## Async client

```python
import os
from luaward import AsyncLuawardClient

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

async def on_redeem(discord_id: str):
    created = await lw.keys.create(discord_id=discord_id, key_days=30, note="Discord redeem")
    return created["user_key"]
```

Sync client มี `keys`, `scripts` และ `stats` ส่วน async client มี `keys` และ `request()` เท่านั้น ใช้ `await lw.request(method, path, body)` สำหรับ endpoint อื่น โดยเทียบ fields/scopes กับ [REST reference](https://luaward.com/docs/api/overview) ไม่มีการรับรองความเข้ากันได้กับ wrapper Luarmor ทุกตัว ต้องทดสอบ automation เดิมแยกก่อนย้าย

Retry HTTP `429`/`503` สูงสุด 3 ครั้งเป็นค่าเริ่มต้น ปรับผ่าน `max_retries` และ `retry_base_delay` ได้ มี typed errors ใน `luaward.exceptions`; รายละเอียดคำตอบ API อยู่ใน `error.payload`
