kryten-webqueue 0.1.1__py3-none-any.whl

kryten_webqueue-0.1.1.dist-info/METADATA

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: kryten-webqueue
+Version: 0.1.1
+Summary: Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube
+Author: grobertson
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: apscheduler>=3.10
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: jinja2>=3.1
+Requires-Dist: pillow>=10.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyjwt>=2.8
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == 'dev'
+Requires-Dist: httpx; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# kryten-webqueue
+
+Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube.
+
+## Architecture
+
+```
+Browser → nginx (queue.dropsugar.co) → kryten-webqueue (:2010) → kryten-api-gate (:24444) → NATS services
+```
+
+- **HTTP-only** — webqueue never touches NATS directly
+- **SQLite** for all local state (catalog, OTPs, queue shadow, playlists, schedules)
+- **WebSocket** for real-time queue updates
+- **Polling** api-gate every 3 seconds for playlist state
+
+## Quick Start
+
+```bash
+# Install
+python -m venv .venv
+.venv/bin/pip install -e .
+
+# Configure
+cp config.example.json /etc/kryten-webqueue/config.json
+# Edit config.json with your secrets
+
+# Run
+WQ_CONFIG=/etc/kryten-webqueue/config.json python -m kryten_webqueue
+```
+
+## Configuration
+
+See `config.example.json` for all options. Required secrets:
+
+| Key | Description |
+|-----|-------------|
+| `secret_key` | Random string for JWT signing (≥32 chars) |
+| `api_gate_token` | Bearer token for kryten-api-gate |
+| `mediacms_token` | API token for MediaCMS catalog sync |
+
+## Deployment
+
+```bash
+# Install service
+sudo cp deploy/kryten-webqueue.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now kryten-webqueue
+
+# nginx
+sudo cp deploy/nginx-queue.conf /etc/nginx/sites-available/queue.dropsugar.co
+sudo ln -s /etc/nginx/sites-available/queue.dropsugar.co /etc/nginx/sites-enabled/
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+## API Endpoints
+
+### Auth
+- `POST /auth/otp/request` — Request OTP (delivered via PM)
+- `POST /auth/otp/verify` — Verify OTP, get session cookie
+- `POST /auth/logout` — Clear session
+- `GET /auth/me` — Current user info
+
+### Catalog
+- `GET /catalog/browse` — Paginated browse (with category filter)
+- `GET /catalog/search?q=...` — Full-text search
+- `GET /catalog/item/{token}` — Item detail
+- `GET /catalog/categories` — List categories
+
+### Queue
+- `GET /queue/state` — Current queue state
+- `POST /queue/add` — Add item (FIFO pay-queue)
+- `POST /queue/playnext` — Add as play-next (premium)
+- `GET /queue/preview?friendly_token=...&tier=...` — Cost preview
+- `GET /queue/history` — User's queue history
+
+### User
+- `GET /user/balance` — Economy balance
+- `GET /user/transactions` — Transaction history
+- `GET /user/profile` — Profile info
+
+### Admin (rank ≥ 3)
+- `GET/POST/PUT/DELETE /admin/playlists/...` — Saved playlists CRUD
+- `GET/POST/PUT/DELETE /admin/schedules/...` — Schedule CRUD
+- `POST /admin/schedules/{id}/fire` — Manual fire
+- `POST /admin/queue/clear` — Clear queue (refunds pay items)
+- `DELETE /admin/queue/{uid}` — Remove item
+- `POST /admin/queue/sync-now` — Trigger catalog sync
+
+### WebSocket
+- `ws://host/ws` — Real-time queue updates (auth via session cookie)
+
+## Dependencies
+
+- Python ≥ 3.12
+- kryten-api-gate ≥ 0.3.6
+- kryten-py ≥ 0.16.1 (upstream, not a direct dependency)
+- kryten-economy ≥ 0.8.11 (upstream, not a direct dependency)
+
+## License
+
+Proprietary — DropSugar / Q&A

kryten_webqueue-0.1.1.dist-info/RECORD

@@ -0,0 +1,46 @@
+kryten_webqueue/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/__main__.py,sha256=TEGuK2O7CWuIh6YwUbD7S3wfmUP8hmKm_GAmVgGIEg8,277
+kryten_webqueue/app.py,sha256=RRS6E4zCzqWFAxydZ3N4PJT1li3XAeWfAPfGfJtiEso,5783
+kryten_webqueue/config.py,sha256=1TyxH1VZqAOOfw8Ermn7yAo9tQvnNsoLt_ExjdNEHek,1102
+kryten_webqueue/api_gate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/api_gate/client.py,sha256=bFikl2c0JM-rkkGacKU6KrEGbfBamhvt5o-Dg2u0-wg,3998
+kryten_webqueue/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/auth/otp.py,sha256=P7K4gOTLhPdnABnG5lDNmqITwhVCRvb7OfI4l48JJkc,261
+kryten_webqueue/auth/rate_limit.py,sha256=cyK6e9ajoIMW-bKCjlNXnapmC2W-kAk4qjVxQ-DkwJA,915
+kryten_webqueue/auth/session.py,sha256=Cg7JHqrnQ9sVfst6X6BXzUNcZphdsSFx5djW7Dod8BU,1456
+kryten_webqueue/catalog/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/catalog/db.py,sha256=VxsTe03znFlynYnus-d9zCxM9mRR45rDza2h-ziKQn0,22846
+kryten_webqueue/catalog/images.py,sha256=k_o31JebREtbZuwn-l_N8BSMHlf9kU5Q_3e7JhREUVM,4026
+kryten_webqueue/catalog/sync.py,sha256=oiuUjI-hWuFr1pj7xHFSuP4qY1Sf_IZ8TKu013_wUaw,3379
+kryten_webqueue/playlists/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/playlists/fire.py,sha256=oVa7jUkZy9-kQERakU54artPZa4xCLxsynUTKuaBYcw,2554
+kryten_webqueue/playlists/importer.py,sha256=3h6tnZJ4OtH3gjhWqzLeHGcnbFfeR7LhA4Apb9CAgGI,3134
+kryten_webqueue/playlists/scheduler.py,sha256=HaY9LqgAap8NwVaJBdOnCVzyteH55HW0alECbL_CM0U,2338
+kryten_webqueue/queue/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/queue/ordering.py,sha256=PqXm_KICwUL65cb3AlUwJLCIhxvA-lLGorMum_s3drE,5530
+kryten_webqueue/queue/poller.py,sha256=xZq-YGI6hlAIMDm07W8pvXoG1dPOSKLk9cjyY62tjj0,1484
+kryten_webqueue/queue/shadow.py,sha256=AK0NY54PJUWdG-zNU0nSTxpl-6FAx84Umxu-UNhP4o8,4397
+kryten_webqueue/routes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/routes/admin_playlists.py,sha256=IFo2iQcCJhTcW96pKhtAaaVZsuNGJq9IYNVFVqxZOKc,3513
+kryten_webqueue/routes/admin_queue.py,sha256=ZU8j6Tt8zhWv2OTW2FWgEkrXTEAi4nLcYqzy8EdEHxA,2143
+kryten_webqueue/routes/admin_schedules.py,sha256=sTZNvOGbemUrT5384yQRHq1VPoUE_6Z0Fn3kH_660DQ,4079
+kryten_webqueue/routes/auth.py,sha256=Bgnnem2amfXROH4Ff6QhHnK0vBqkvpPlpuJZ3m9eKyo,2598
+kryten_webqueue/routes/catalog.py,sha256=B3BN9lyA4_-VHOkkWPY0YRf4uTOfkKIUx1WPwS62DfE,1537
+kryten_webqueue/routes/pages.py,sha256=UMmeqUPQSEMAOXyD6QXXMjMXZv52Rk9LM_-MzKmV_0Q,2861
+kryten_webqueue/routes/queue.py,sha256=cEe4rzT4DDcVD1lncXbNHjcropaas1-msAkSD2e6QSM,4321
+kryten_webqueue/routes/user.py,sha256=bti9N1NNY2pg_ow5T9rKWSykjPRbXJqKv2xqfBerxDo,1219
+kryten_webqueue/static/css/main.css,sha256=9RyqeGL75WbPl7eGXbxEtwRGownNKWpmLreSyCg7HEU,8990
+kryten_webqueue/static/js/main.js,sha256=ks3aLOPNRa60cz5WrvFnLmbHj1_rWFD0eQ106s7Cnjs,834
+kryten_webqueue/templates/base.html,sha256=ln_ag9ptFHDS4AH5i73iQMsR8p3COEC-poDTZ-g_VAA,1288
+kryten_webqueue/templates/admin/index.html,sha256=5ZwUUIv7SFsj9x2s-zFwUIKWnrueGcgkSf8E1Fe5Ja4,3327
+kryten_webqueue/templates/auth/login.html,sha256=wPKuX-T4LtjSwAT8yWH6e4Mt3nl073rTa2R612wjy9A,2524
+kryten_webqueue/templates/catalog/browse.html,sha256=_XPaxbA4V-9cz12BBgeDAB33ZGwu02WhSMnv3WTWXG8,3826
+kryten_webqueue/templates/queue/index.html,sha256=EcvGk-ew3OUn5iv9WLH7L7v6s6Z7fCs4l5WRFt7ulwE,4192
+kryten_webqueue/templates/user/dashboard.html,sha256=XER97ToXjZuyZaxH8FXmotYpmNA-xLJp6FP0FeU74mY,2782
+kryten_webqueue/ws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kryten_webqueue/ws/handler.py,sha256=3B8xcfMdFMLrTXkHerOFMIlcfYzhp_DSSP9-To8sYfc,1659
+kryten_webqueue/ws/manager.py,sha256=3-d92KbH3tegIKBWbClqv1nUut3nUZli7oBaNVTXzME,1928
+kryten_webqueue-0.1.1.dist-info/METADATA,sha256=NMwkl4rgev3FkaO336BxhmfUq_I8UUb8MeSPkBIoRHw,3854
+kryten_webqueue-0.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+kryten_webqueue-0.1.1.dist-info/entry_points.txt,sha256=QvrQn5MkZpYnumu_5gldPIW1cbyGl2f5oIfE0Dh3sGU,66
+kryten_webqueue-0.1.1.dist-info/RECORD,,

kryten_webqueue-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

kryten_webqueue-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kryten-webqueue = kryten_webqueue.__main__:main