Metadata-Version: 2.4
Name: qubiz-game-sdk
Version: 0.1.0
Summary: Creator/admin tooling helpers for Qubiz game manifests.
Author: Qubiz
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# qubiz-game-sdk

Python helpers for validating Qubiz creator manifests before upload or release.

```python
from qubiz_game_sdk import GameManifest, SDKEvent, validate_event, validate_manifest

manifest = GameManifest(
    slug="my-game",
    title="My Game",
    description="A small HTML5 arcade game.",
    requested_scopes=["profile:username", "analytics:events"],
    tags=["arcade"],
)
validate_manifest(manifest)

event = SDKEvent(name="level_reached", stage="world-1", source="tutorial", value=3)
validate_event(event)
```

`SDKEvent` mirrors the browser SDK telemetry sink. Names are capped at 64
characters, stage/source at 80, metadata at 12 keys, and string metadata values
at 120 characters.

Publishing checklist:

```bash
python -m build
python -m twine check dist/*
python -m twine upload dist/*
```
