kryten-webqueue 0.20.1__tar.gz → 0.22.0__tar.gz

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/CHANGELOG.md

@@ -4,7 +4,20 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-## [Unreleased]
+## [0.22.0] - 2026-06-19
+
+### Added
+
+- **Shoutout on the Vanity Items tab.** The dashboard's Vanity tab gains a third item — **Shoutout** — alongside Greeting and Chat color, each now with a short call-to-action. Sending a shoutout posts the user's message to public chat (`📢 <user>: …`) via the new `POST /user/vanity/shoutout` route, which proxies the api-gate `POST /economy/vanity/shoutout` endpoint. The message is the user's own input (validated server-side: trimmed, non-empty, max 200 chars); the cost/availability come from the account summary; the username is always taken from the authenticated session.
+
+## [0.21.0] — 2026-06-17
+
+### Changed
+
+- **Catalog sync no longer runs on startup.** The background sync loop now waits a full interval before its first run instead of syncing immediately when the process starts, so a restart won't kick off a sync. Admins can still trigger it on demand with the "Sync Catalog" button.
+- **Friendlier job buttons.** Jobs that open a parameter dialog before running now show **"Begin…"** instead of "Run…", signalling that a dialog (with a Cancel) comes next rather than an immediate action. One-click jobs keep the plain **"Run"** label.
+
+[0.21.0]: https://github.com/grobertson/kryten-webqueue/releases/tag/v0.21.0
 
 ## [0.20.1] — 2026-06-17
 

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kryten-webqueue
-Version: 0.20.1
+Version: 0.22.0
 Summary: Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube
 Author: grobertson
 License-Expression: MIT

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/kryten_webqueue/api_gate/client.py

@@ -108,6 +108,12 @@ class ApiGateClient:
             "value": value,
         })
 
+    async def set_vanity_shoutout(self, username: str, value: str) -> dict:
+        return await self.post("/economy/vanity/shoutout", json={
+            "username": username,
+            "value": value,
+        })
+
     async def queue_preview(self, username: str, duration_sec: int, tier: str = "queue") -> dict:
         return await self.post("/economy/queue-preview", json={
             "username": username,

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/kryten_webqueue/app.py

@@ -163,12 +163,15 @@ async def lifespan(app: FastAPI):
     # Background workers
     async def _catalog_sync_loop():
         interval = config.catalog_sync_interval_hours * 3600
+        # Sync on the interval, NOT immediately on startup — a restart should
+        # not trigger a catalog sync. Admins can run it on demand from the
+        # "Sync Catalog" button.
         while True:
+            await asyncio.sleep(interval)
             try:
                 await catalog_sync.sync()
             except Exception as e:
                 logger.exception(f"Catalog sync error: {type(e).__name__}: {e}")
-            await asyncio.sleep(interval)
 
     async def _otp_cleanup_loop():
         while True:

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/kryten_webqueue/routes/user.py

@@ -1,5 +1,5 @@
 from fastapi import APIRouter, Request, Depends, HTTPException
-from pydantic import BaseModel
+from pydantic import BaseModel, field_validator
 
 from ..auth.session import get_current_user
 
@@ -28,6 +28,22 @@ class ColorUpdate(BaseModel):
     value: str
 
 
+class ShoutoutRequest(BaseModel):
+    # Mirrors the economy's shoutout limits so a bypassed UI still gets a
+    # consistent, early rejection instead of forwarding arbitrary-length text.
+    value: str
+
+    @field_validator("value")
+    @classmethod
+    def _validate_value(cls, v: str) -> str:
+        v = v.strip()
+        if not v:
+            raise ValueError("Shoutout message is required.")
+        if len(v) > 200:
+            raise ValueError("Message too long (max 200 characters).")
+        return v
+
+
 @router.post("/vanity/greeting")
 async def set_vanity_greeting(
     body: GreetingUpdate, request: Request, user: dict = Depends(get_current_user)
@@ -52,6 +68,18 @@ async def set_vanity_color(
         raise HTTPException(status_code=400, detail=_economy_error(exc)) from exc
 
 
+@router.post("/vanity/shoutout")
+async def set_vanity_shoutout(
+    body: ShoutoutRequest, request: Request, user: dict = Depends(get_current_user)
+):
+    """Purchase a shoutout — the bot posts the message to public chat."""
+    api_gate = request.app.state.api_gate
+    try:
+        return await api_gate.set_vanity_shoutout(user["username"], body.value)
+    except Exception as exc:  # noqa: BLE001
+        raise HTTPException(status_code=400, detail=_economy_error(exc)) from exc
+
+
 def _economy_error(exc: Exception) -> str:
     """Extract a human-readable message from an api-gate HTTP error."""
     import httpx

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/kryten_webqueue/static/css/main.css

@@ -975,6 +975,10 @@ a.np-chip {
     color: var(--text-secondary);
     font-style: italic;
 }
+.vanity-cta {
+    font-size: 0.78rem;
+    margin-top: 0.2rem;
+}
 .color-swatch {
     display: inline-block;
     width: 1rem;

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/kryten_webqueue/templates/admin/index.html

@@ -199,7 +199,7 @@ async function loadJobs() {
                     <span class="job-label">${escapeHtml(j.label)}${hasParams ? ' <span class="job-badge">params</span>' : ''}</span>
                     ${summary}
                     <button class="btn btn-sm" onclick="startJob('${j.name}')" ${j.running ? 'disabled' : ''}>
-                        ${j.running ? 'Running…' : (hasParams ? 'Run…' : 'Run')}
+                        ${j.running ? 'Running…' : (hasParams ? 'Begin…' : 'Run')}
                     </button>
                 </div>`;
             }).join('')

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/kryten_webqueue/templates/user/dashboard.html

@@ -48,13 +48,14 @@
             </div>
 
             <div class="tab-panel" id="tab-vanity" role="tabpanel" hidden>
-                <p class="muted">Personalize how the bot greets you and your chat color. Each update is a one-time purchase.</p>
+                <p class="muted">Personalize how the bot greets you, your chat color, and shout yourself out. Each update is a one-time purchase.</p>
                 <div class="vanity-item">
                     <div class="vanity-row">
                         <span class="vanity-label">Greeting</span>
                         <button class="btn btn-sm" id="edit-greeting" disabled>Edit</button>
                     </div>
                     <div class="vanity-value" id="vanity-greeting">—</div>
+                    <div class="vanity-cta muted" id="cta-greeting">The bot welcomes you by name when you join.</div>
                 </div>
                 <div class="vanity-item">
                     <div class="vanity-row">
@@ -62,6 +63,15 @@
                         <button class="btn btn-sm" id="edit-color" disabled>Edit</button>
                     </div>
                     <div class="vanity-value" id="vanity-color">—</div>
+                    <div class="vanity-cta muted" id="cta-color">Stand out — pick a custom color for your chat messages.</div>
+                </div>
+                <div class="vanity-item">
+                    <div class="vanity-row">
+                        <span class="vanity-label">Shoutout</span>
+                        <button class="btn btn-sm" id="buy-shoutout" disabled>Send</button>
+                    </div>
+                    <div class="vanity-value" id="vanity-shoutout">—</div>
+                    <div class="vanity-cta muted" id="cta-shoutout">Have the bot post your message to the whole channel.</div>
                 </div>
             </div>
         </div>
@@ -223,6 +233,20 @@ function renderAccount(a) {
     cBtn.disabled = enabled.custom_color === false;
     gBtn.title = costs.custom_greeting ? `${fmt(costs.custom_greeting, sym)} per update` : '';
     cBtn.title = costs.custom_color ? `${fmt(costs.custom_color, sym)} per update` : '';
+
+    const shoutEl = document.getElementById('vanity-shoutout');
+    const shoutCost = costs.shoutout;
+    const shoutAvailable = enabled.shoutout !== false && shoutCost != null;
+    if (shoutAvailable) {
+        shoutEl.textContent = `Post a one-off message to chat for ${fmt(shoutCost, sym)}.`;
+        shoutEl.classList.remove('vanity-unset');
+    } else {
+        shoutEl.textContent = 'Unavailable';
+        shoutEl.classList.add('vanity-unset');
+    }
+    const sBtn = document.getElementById('buy-shoutout');
+    sBtn.disabled = !shoutAvailable;
+    sBtn.title = shoutAvailable ? `${fmt(shoutCost, sym)} per shoutout` : '';
 }
 
 // ── Vanity edit dialogs ────────────────────────────────────────
@@ -328,6 +352,55 @@ async function saveColor() {
     }
 }
 
+// ── Shoutout dialog ────────────────────────────────────────────
+function buyShoutout() {
+    if (!accountState) return;
+    const sym = accountState.currency_symbol || 'Z';
+    const costs = accountState.vanity_costs || {};
+    const enabled = accountState.vanity_enabled || {};
+    const cost = costs.shoutout;
+    if (enabled.shoutout === false || cost == null) {
+        showToast('Shoutouts are currently unavailable', 'error');
+        return;
+    }
+    showModal(`
+        <h3>Shoutout</h3>
+        <p class="muted">The bot posts your message to public chat as <strong>📢 ${escapeHtml(accountState.username || 'you')}: …</strong>. Cost: ${fmt(cost, sym)} each.</p>
+        <label class="field"><span>Message (max 200 characters)</span>
+          <textarea id="shoutout-input" maxlength="200" rows="3" placeholder="Say something to the whole channel"></textarea></label>
+        <div class="modal-actions">
+          <button class="btn" onclick="closeModal()">Cancel</button>
+          <button class="btn btn-primary" id="shoutout-save">Send shoutout</button>
+        </div>`);
+    document.getElementById('shoutout-save').addEventListener('click', saveShoutout);
+}
+
+async function saveShoutout() {
+    const value = document.getElementById('shoutout-input').value.trim();
+    if (!value) { showToast('Message cannot be empty', 'error'); return; }
+    const btn = document.getElementById('shoutout-save');
+    btn.disabled = true;
+    let resp;
+    try {
+        resp = await fetch('/user/vanity/shoutout', {
+            method: 'POST',
+            headers: {'Content-Type': 'application/json'},
+            body: JSON.stringify({value}),
+        });
+    } catch (e) {
+        showToast('Network error', 'error'); btn.disabled = false; return;
+    }
+    const data = await resp.json().catch(() => ({}));
+    if (resp.ok) {
+        showToast('Shoutout sent', 'success');
+        closeModal();
+        loadAccount();
+    } else {
+        showToast(data.detail || 'Shoutout failed', 'error');
+        btn.disabled = false;
+    }
+}
+
 // ── Queue history (MIDDLE column, paginated) ───────────────────
 const QUEUE_LIMIT = 20;
 let queueOffset = 0;
@@ -440,6 +513,7 @@ function closeModal() {
 // ── Init ───────────────────────────────────────────────────────
 document.getElementById('edit-greeting').addEventListener('click', editGreeting);
 document.getElementById('edit-color').addEventListener('click', editColor);
+document.getElementById('buy-shoutout').addEventListener('click', buyShoutout);
 document.querySelectorAll('.tx-toggle-btn').forEach(b => b.addEventListener('click', () => {
     document.querySelectorAll('.tx-toggle-btn').forEach(x => x.classList.remove('active'));
     b.classList.add('active');

{kryten_webqueue-0.20.1 → kryten_webqueue-0.22.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kryten-webqueue"
-version = "0.20.1"
+version = "0.22.0"
 description = "Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube"
 readme = "README.md"
 license = "MIT"