cursedbelt 0.0.0

package/dist/server/sqlite/viewer.js

@@ -0,0 +1,92 @@
+import { Hono } from 'hono';
+import { isReadOnlySql } from './readonlySql';
+/**
+ * A read-only SQLite browser as a Hono sub-app — the from-scratch replacement for the
+ * `/admin/db-query` allowlist stub. Mount it behind the owner-only guard in the app:
+ *
+ * ```ts
+ * app.route('/api/v1/admin/sqlite', ownerOnly(createSqliteViewerMiddleware(db)));
+ * ```
+ *
+ * It exposes three endpoints — list tables + counts, paginate one table, run an ad-hoc
+ * `SELECT` — letting the owner inspect the live DB without shell access. Every path is
+ * read-only: table names are validated against `sqlite_master`, row/query params are
+ * bound, and the `/query` body is gated by {@link isReadOnlySql}. Authn/authz is the
+ * mounting app's job (this sub-app trusts that it is already owner-gated).
+ */
+/** Cap an admin page size to a sane window. */
+const clampLimit = (raw, fallback) => {
+    const n = Number.parseInt(raw ?? '', 10);
+    return Number.isFinite(n) ? Math.min(1000, Math.max(1, n)) : fallback;
+};
+const clampOffset = (raw) => {
+    const n = Number.parseInt(raw ?? '', 10);
+    return Number.isFinite(n) && n > 0 ? n : 0;
+};
+/** Is `name` an actual table in this DB? (The injection guard for `SELECT * FROM`.) */
+function isKnownTable(db, name) {
+    const row = db
+        .query("SELECT COUNT(*) AS n FROM sqlite_master WHERE type='table' AND name = ?")
+        .get(name);
+    return (row?.n ?? 0) > 0;
+}
+/** Double-quote a name already proven to exist in `sqlite_master`. */
+const quote = (name) => `"${name.replace(/"/g, '""')}"`;
+export function createSqliteViewerMiddleware(db) {
+    const app = new Hono();
+    // List user tables with row counts (FTS shadow + sqlite_* internals excluded).
+    app.get('/tables', (c) => {
+        const names = db
+            .query("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name")
+            .all()
+            .map((r) => r.name);
+        const items = names.map((name) => ({
+            name,
+            count: db.query(`SELECT COUNT(*) AS n FROM ${quote(name)}`).get()?.n ?? 0,
+        }));
+        return c.json({ items });
+    });
+    // Paginated rows from one table.
+    app.get('/tables/:table', (c) => {
+        const table = c.req.param('table');
+        if (!isKnownTable(db, table)) {
+            return c.json({ error: { message: 'Unknown table', code: 'unknown_table' } }, 404);
+        }
+        const limit = clampLimit(c.req.query('limit'), 50);
+        const offset = clampOffset(c.req.query('offset'));
+        const items = db
+            .query(`SELECT * FROM ${quote(table)} LIMIT ? OFFSET ?`)
+            .all(limit, offset);
+        const total = db.query(`SELECT COUNT(*) AS n FROM ${quote(table)}`).get()?.n ?? 0;
+        return c.json({ items, total, limit, offset });
+    });
+    // Ad-hoc read-only query (SELECT / WITH only).
+    app.post('/query', async (c) => {
+        let payload;
+        try {
+            payload = await c.req.json();
+        }
+        catch {
+            return c.json({ error: { message: 'Invalid JSON body', code: 'bad_request' } }, 400);
+        }
+        const sql = payload.sql;
+        if (typeof sql !== 'string' || !isReadOnlySql(sql)) {
+            return c.json({ error: { message: 'Only read-only SELECT queries are allowed', code: 'not_read_only' } }, 400);
+        }
+        const params = Array.isArray(payload.params) ? payload.params : [];
+        try {
+            const items = db.query(sql).all(...params);
+            return c.json({ items });
+        }
+        catch (err) {
+            return c.json({
+                error: {
+                    message: err instanceof Error ? err.message : String(err),
+                    code: 'query_failed',
+                },
+            }, 400);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=viewer.js.map

package/dist/server/sqlite/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../../src/server/sqlite/viewer.ts"],"names":[],"mappings":"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"}

package/dist/server/sqlite.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SQLite migration runner + column helpers (structural — no bun:sqlite import, so
+ * it typechecks without Bun types and works with any handle exposing `exec` +
+ * `query`, i.e. bun:sqlite's Database). Replaces the scattered
+ * addColumnIfMissing/PRAGMA-guarded-ALTER pattern with versioned, once-only
+ * migrations recorded in a `_migrations` sentinel table.
+ */
+/** Minimal structural SQLite handle, satisfied by a bun:sqlite `Database`. */
+export interface SqliteDb {
+    exec(sql: string): unknown;
+    query<Row = unknown>(sql: string): {
+        all: (...params: unknown[]) => Row[];
+        run: (...params: unknown[]) => unknown;
+    };
+}
+export interface Migration {
+    name: string;
+    up: (db: SqliteDb) => void;
+}
+/** Does `table` have a column named `column`? (via PRAGMA table_info). */
+export declare function columnExists(db: SqliteDb, table: string, column: string): boolean;
+/** Add a column if it's missing (idempotent). Returns true if it was added. */
+export declare function addColumnIfMissing(db: SqliteDb, table: string, column: string, ddl: string): boolean;
+/**
+ * Run each pending migration exactly once, in array order, recording it in
+ * `_migrations`. Returns the names actually run this call (empty if up to date).
+ * A migration's `up()` is the place to call `addColumnIfMissing`, create tables,
+ * or backfill data.
+ */
+export declare function runMigrations(db: SqliteDb, migrations: Migration[]): string[];
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/server/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/server/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,KAAK,CAAC,GAAG,GAAG,OAAO,EACjB,GAAG,EAAE,MAAM,GACV;QACD,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,EAAE,CAAC;QACrC,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5B;AAMD,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGjF;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAmB7E"}

package/dist/server/sqlite.js

@@ -0,0 +1,46 @@
+/**
+ * SQLite migration runner + column helpers (structural — no bun:sqlite import, so
+ * it typechecks without Bun types and works with any handle exposing `exec` +
+ * `query`, i.e. bun:sqlite's Database). Replaces the scattered
+ * addColumnIfMissing/PRAGMA-guarded-ALTER pattern with versioned, once-only
+ * migrations recorded in a `_migrations` sentinel table.
+ */
+function quoteIdent(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/** Does `table` have a column named `column`? (via PRAGMA table_info). */
+export function columnExists(db, table, column) {
+    const rows = db.query(`PRAGMA table_info(${quoteIdent(table)})`).all();
+    return rows.some((r) => r.name === column);
+}
+/** Add a column if it's missing (idempotent). Returns true if it was added. */
+export function addColumnIfMissing(db, table, column, ddl) {
+    if (columnExists(db, table, column))
+        return false;
+    db.exec(`ALTER TABLE ${quoteIdent(table)} ADD COLUMN ${quoteIdent(column)} ${ddl}`);
+    return true;
+}
+/**
+ * Run each pending migration exactly once, in array order, recording it in
+ * `_migrations`. Returns the names actually run this call (empty if up to date).
+ * A migration's `up()` is the place to call `addColumnIfMissing`, create tables,
+ * or backfill data.
+ */
+export function runMigrations(db, migrations) {
+    db.exec('CREATE TABLE IF NOT EXISTS _migrations (name TEXT PRIMARY KEY, applied_at TEXT NOT NULL)');
+    const applied = new Set(db
+        .query('SELECT name FROM _migrations')
+        .all()
+        .map((r) => r.name));
+    const insert = db.query('INSERT INTO _migrations (name, applied_at) VALUES (?, ?)');
+    const ran = [];
+    for (const m of migrations) {
+        if (applied.has(m.name))
+            continue;
+        m.up(db);
+        insert.run(m.name, new Date().toISOString());
+        ran.push(m.name);
+    }
+    return ran;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/server/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/server/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,EAAY,EAAE,KAAa,EAAE,MAAc;IACtE,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAmB,qBAAqB,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACzF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAChC,EAAY,EACZ,KAAa,EACb,MAAc,EACd,GAAW;IAEX,IAAI,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,EAAE,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,KAAK,CAAC,eAAe,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACpF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAAY,EAAE,UAAuB;IACjE,EAAE,CAAC,IAAI,CACL,0FAA0F,CAC3F,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,EAAE;SACC,KAAK,CAAmB,8BAA8B,CAAC;SACvD,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACtB,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACpF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/server/ws/eventBus.d.ts

@@ -0,0 +1,15 @@
+import type { EventBus } from './types';
+/**
+ * The push-only subset ru uses: broadcast-to-all, no auth, no inbound routing. ru
+ * mounts one bus and pushes from its task queue / caSync / Forge workers
+ * (`bus.broadcast('taskq-update', { … })`). Same Bun-native upgrade as the hub, minus
+ * the channel registry, presence, and heartbeat.
+ *
+ * @example
+ * const bus = createEventBus();
+ * app.get('/events', bus.upgradeHandler);
+ * serveBun(app, { port, websocket: bus.handlers });
+ * bus.broadcast('taskq-update', { running: 3 });
+ */
+export declare function createEventBus(): EventBus;
+//# sourceMappingURL=eventBus.d.ts.map

package/dist/server/ws/eventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../src/server/ws/eventBus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CA6BzC"}

package/dist/server/ws/eventBus.js

@@ -0,0 +1,43 @@
+/**
+ * The push-only subset ru uses: broadcast-to-all, no auth, no inbound routing. ru
+ * mounts one bus and pushes from its task queue / caSync / Forge workers
+ * (`bus.broadcast('taskq-update', { … })`). Same Bun-native upgrade as the hub, minus
+ * the channel registry, presence, and heartbeat.
+ *
+ * @example
+ * const bus = createEventBus();
+ * app.get('/events', bus.upgradeHandler);
+ * serveBun(app, { port, websocket: bus.handlers });
+ * bus.broadcast('taskq-update', { running: 3 });
+ */
+export function createEventBus() {
+    const sockets = new Set();
+    const upgradeHandler = async (c) => {
+        const server = c.env;
+        const upgraded = server.upgrade(c.req.raw, { data: {} });
+        if (!upgraded)
+            return c.text('Upgrade required', 426);
+        return c.body(null, 204);
+    };
+    return {
+        upgradeHandler,
+        handlers: {
+            open(ws) {
+                sockets.add(ws);
+            },
+            // Push-only: inbound frames are intentionally ignored. (Bun requires a `message`
+            // handler, so this is a documented no-op rather than an omitted key.)
+            message() { },
+            close(ws) {
+                sockets.delete(ws);
+            },
+        },
+        broadcast(event, data) {
+            const payload = JSON.stringify({ event, data });
+            for (const ws of sockets)
+                ws.send(payload);
+        },
+        clientCount: () => sockets.size,
+    };
+}
+//# sourceMappingURL=eventBus.js.map

package/dist/server/ws/eventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.js","sourceRoot":"","sources":["../../../src/server/ws/eventBus.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEzD,MAAM,cAAc,GAAsB,KAAK,EAAE,CAAC,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAsC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,OAAO;QACL,cAAc;QACd,QAAQ,EAAE;YACR,IAAI,CAAC,EAAE;gBACL,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YACD,iFAAiF;YACjF,sEAAsE;YACtE,OAAO,KAAI,CAAC;YACZ,KAAK,CAAC,EAAE;gBACN,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrB,CAAC;SACF;QACD,SAAS,CAAC,KAAK,EAAE,IAAI;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,KAAK,MAAM,EAAE,IAAI,OAAO;gBAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI;KAChC,CAAC;AACJ,CAAC"}

package/dist/server/ws/hub.d.ts

@@ -0,0 +1,21 @@
+import type { WsChannel, WsClient, WsHub, WsHubOpts } from './types';
+/**
+ * The heartbeat sweep, factored out as a pure function so it's testable without faking
+ * timers: ping every live client, close (don't delete — let the `close` handler fire
+ * `onDisconnect` + remove) any unheard-from past `staleMs`. The hub's `setInterval`
+ * calls this with `Date.now()`.
+ */
+export declare function sweepStaleClients(clients: Iterable<WsClient>, now: number, staleMs: number): void;
+/**
+ * Build a typed WebSocket hub on Bun's native upgrade. The hub owns the transport —
+ * connection registry, channel routing, heartbeat/stale-cull, and presence-as-a-view;
+ * the registered {@link WsChannel}s own the business logic. Mount {@link WsHub.upgradeHandler}
+ * on the Hono upgrade route(s) and hand {@link WsHub.handlers} to `serveBun`'s `websocket`.
+ *
+ * @example
+ * const hub = createWsHub({ channels: wsChannels, authenticate });
+ * app.get('/ws/:channel', hub.upgradeHandler);
+ * serveBun(app, { port, websocket: hub.handlers });
+ */
+export declare function createWsHub<T extends Record<string, WsChannel<any>>>(opts: WsHubOpts<T>): WsHub;
+//# sourceMappingURL=hub.d.ts.map

package/dist/server/ws/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../../src/server/ws/hub.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EAGR,KAAK,EACL,SAAS,EAEV,MAAM,SAAS,CAAC;AAUjB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQjG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAqH/F"}

package/dist/server/ws/hub.js

@@ -0,0 +1,155 @@
+import { ApiError, toErrorEnvelope } from '../errors';
+import { computePresence } from './presence';
+import { joinRoom, ROOM_META_KEY } from './room';
+const DEFAULT_HEARTBEAT_MS = 30_000;
+const DEFAULT_STALE_MS = 120_000;
+/** Bun's `idleTimeout` ceiling (seconds). */
+const BUN_IDLE_TIMEOUT_MAX_S = 960;
+/** Serialize the wire envelope once per fan-out. */
+const encode = (event, data) => JSON.stringify({ event, data });
+/**
+ * The heartbeat sweep, factored out as a pure function so it's testable without faking
+ * timers: ping every live client, close (don't delete — let the `close` handler fire
+ * `onDisconnect` + remove) any unheard-from past `staleMs`. The hub's `setInterval`
+ * calls this with `Date.now()`.
+ */
+export function sweepStaleClients(clients, now, staleMs) {
+    for (const client of clients) {
+        if (now - client.lastPingAt > staleMs) {
+            client.ws.close(1001, 'stale');
+        }
+        else {
+            client.ws.ping();
+        }
+    }
+}
+/**
+ * Build a typed WebSocket hub on Bun's native upgrade. The hub owns the transport —
+ * connection registry, channel routing, heartbeat/stale-cull, and presence-as-a-view;
+ * the registered {@link WsChannel}s own the business logic. Mount {@link WsHub.upgradeHandler}
+ * on the Hono upgrade route(s) and hand {@link WsHub.handlers} to `serveBun`'s `websocket`.
+ *
+ * @example
+ * const hub = createWsHub({ channels: wsChannels, authenticate });
+ * app.get('/ws/:channel', hub.upgradeHandler);
+ * serveBun(app, { port, websocket: hub.handlers });
+ */
+export function createWsHub(opts) {
+    const clients = new Map();
+    const staleMs = opts.staleMs ?? DEFAULT_STALE_MS;
+    const heartbeatMs = opts.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_MS;
+    const channelOf = (name) => opts.channels[name];
+    const clientFromWs = (ws) => clients.get(ws.data.clientId);
+    // Our heartbeat is authoritative (it also drives presence), so disable Bun's auto-ping
+    // and let its idle timeout backstop just beyond our stale window.
+    const idleTimeout = Math.min(Math.ceil(staleMs / 1000), BUN_IDLE_TIMEOUT_MAX_S);
+    const heartbeat = setInterval(() => {
+        sweepStaleClients(clients.values(), Date.now(), staleMs);
+    }, heartbeatMs);
+    // Don't keep the process alive for the heartbeat alone (server tests, graceful exit).
+    heartbeat.unref?.();
+    const upgradeHandler = async (c) => {
+        const channel = c.req.param('channel') ?? c.req.query('channel') ?? 'default';
+        const room = c.req.query('room') ?? undefined;
+        const handshake = { headers: c.req.raw.headers, url: c.req.url, channel, room };
+        let user;
+        try {
+            user = await opts.authenticate(handshake);
+        }
+        catch {
+            user = null;
+        }
+        if (!user)
+            return c.json(toErrorEnvelope(new ApiError(401, 'Unauthorized')), 401);
+        const data = { clientId: crypto.randomUUID(), user, channel, room };
+        const server = c.env;
+        const upgraded = server.upgrade(c.req.raw, { data });
+        if (!upgraded)
+            return c.text('Upgrade required', 426);
+        // Bun has taken over the socket and sent the 101; this Response is discarded by
+        // Bun.serve. (A real 101 can't be constructed — the Fetch Response ctor forbids 1xx.)
+        return c.body(null, 204);
+    };
+    const hub = {
+        upgradeHandler,
+        handlers: {
+            idleTimeout,
+            sendPings: false,
+            open(ws) {
+                const { clientId, user, channel, room } = ws.data;
+                const now = Date.now();
+                const client = {
+                    id: clientId,
+                    user,
+                    ws,
+                    channel,
+                    connectedAt: now,
+                    lastPingAt: now,
+                    meta: {},
+                };
+                if (room)
+                    joinRoom(client, room);
+                clients.set(clientId, client);
+                channelOf(channel)?.onConnect?.(client, hub);
+            },
+            message(ws, raw) {
+                const client = clientFromWs(ws);
+                if (!client)
+                    return;
+                client.lastPingAt = Date.now();
+                let msg;
+                try {
+                    msg = JSON.parse(typeof raw === 'string' ? raw : raw.toString());
+                }
+                catch {
+                    return; // ignore malformed frames rather than crash the socket
+                }
+                channelOf(client.channel)?.onMessage(client, msg, hub);
+            },
+            // A pong (reply to our heartbeat ping) proves liveness without an app message.
+            pong(ws) {
+                const client = clientFromWs(ws);
+                if (client)
+                    client.lastPingAt = Date.now();
+            },
+            close(ws) {
+                const client = clientFromWs(ws);
+                if (!client)
+                    return;
+                channelOf(client.channel)?.onDisconnect?.(client, hub);
+                clients.delete(client.id);
+            },
+        },
+        broadcast(channel, event, data) {
+            const payload = encode(event, data);
+            for (const client of clients.values()) {
+                if (client.channel === channel)
+                    client.ws.send(payload);
+            }
+        },
+        broadcastToRoom(channel, roomId, event, data) {
+            const payload = encode(event, data);
+            for (const client of clients.values()) {
+                if (client.channel === channel && client.meta[ROOM_META_KEY] === roomId) {
+                    client.ws.send(payload);
+                }
+            }
+        },
+        send(clientId, event, data) {
+            clients.get(clientId)?.ws.send(encode(event, data));
+        },
+        getClients(channel) {
+            const all = [...clients.values()];
+            return channel ? all.filter((client) => client.channel === channel) : all;
+        },
+        getClient: (id) => clients.get(id),
+        getPresence(channel) {
+            return computePresence(clients.values(), channel, channelOf(channel)?.presence ?? false);
+        },
+        close() {
+            clearInterval(heartbeat);
+        },
+    };
+    return hub;
+}
+//# sourceMappingURL=hub.js.map

package/dist/server/ws/hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.js","sourceRoot":"","sources":["../../../src/server/ws/hub.ts"],"names":[],"mappings":"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"}

package/dist/server/ws/index.d.ts

@@ -0,0 +1,6 @@
+export { createEventBus } from './eventBus';
+export { createWsHub } from './hub';
+export { computePresence } from './presence';
+export { joinRoom, leaveRoom, ROOM_META_KEY, roomOf } from './room';
+export type { EventBus, EventBusData, PresenceEntry, PresenceState, WsChannel, WsClient, WsData, WsHandshake, WsHub, WsHubOpts, WsMessage, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/ws/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACpE,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,EACT,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/server/ws/index.js

@@ -0,0 +1,8 @@
+// cursedbelt/server WS hub — Bun-native upgrade, typed channel registry, heartbeat,
+// presence-as-a-view, and the push-only event-bus subset. Pairs with the partysocket
+// client in `cursedbelt/client`.
+export { createEventBus } from './eventBus';
+export { createWsHub } from './hub';
+export { computePresence } from './presence';
+export { joinRoom, leaveRoom, ROOM_META_KEY, roomOf } from './room';
+//# sourceMappingURL=index.js.map

package/dist/server/ws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/ws/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,qFAAqF;AACrF,iCAAiC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}

package/dist/server/ws/presence.d.ts

@@ -0,0 +1,12 @@
+import type { PresenceState, WsClient } from './types';
+/**
+ * Presence is a *view* over the live client map, not a tracked structure — there is no
+ * `PresenceTracker` class to keep in sync. The hub's `getPresence(channel)` delegates
+ * here; a channel that wants to push presence does
+ * `hub.broadcast('chat', 'presence', hub.getPresence('chat'))` from its lifecycle hooks.
+ */
+/** The presence snapshot for `channel`: one `{ userId, connectedAt }` row per live
+ * client on that channel, or empty when the channel doesn't opt into presence.
+ * Pure (no timers, no state) so it's trivially testable. */
+export declare function computePresence(clients: Iterable<WsClient>, channel: string, presenceEnabled: boolean): PresenceState;
+//# sourceMappingURL=presence.d.ts.map

package/dist/server/ws/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/server/ws/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;GAKG;AAEH;;4DAE4D;AAC5D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,OAAO,GACvB,aAAa,CASf"}

package/dist/server/ws/presence.js

@@ -0,0 +1,21 @@
+/**
+ * Presence is a *view* over the live client map, not a tracked structure — there is no
+ * `PresenceTracker` class to keep in sync. The hub's `getPresence(channel)` delegates
+ * here; a channel that wants to push presence does
+ * `hub.broadcast('chat', 'presence', hub.getPresence('chat'))` from its lifecycle hooks.
+ */
+/** The presence snapshot for `channel`: one `{ userId, connectedAt }` row per live
+ * client on that channel, or empty when the channel doesn't opt into presence.
+ * Pure (no timers, no state) so it's trivially testable. */
+export function computePresence(clients, channel, presenceEnabled) {
+    if (!presenceEnabled)
+        return [];
+    const rows = [];
+    for (const client of clients) {
+        if (client.channel === channel) {
+            rows.push({ userId: client.user.id, connectedAt: client.connectedAt });
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=presence.js.map

package/dist/server/ws/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../../src/server/ws/presence.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;4DAE4D;AAC5D,MAAM,UAAU,eAAe,CAC7B,OAA2B,EAC3B,OAAe,EACf,eAAwB;IAExB,IAAI,CAAC,eAAe;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/server/ws/room.d.ts

@@ -0,0 +1,18 @@
+import type { WsClient } from './types';
+/**
+ * Rooms are not a separate stateful abstraction — they are a typed convention over
+ * {@link WsClient.meta}. A channel puts a client in a room with {@link joinRoom}; the
+ * hub's `broadcastToRoom` matches on the same key. This replaces the old `wsRoom.ts` /
+ * `reconnectableRoom.ts` classes: the hub owns connections + fan-out, the channel owns
+ * membership + any history buffer.
+ */
+/** The {@link WsClient.meta} key a client's current room id lives under. The hub's
+ * `broadcastToRoom` reads the same key — keep them in lockstep. */
+export declare const ROOM_META_KEY = "roomId";
+/** Put `client` in `roomId` (replaces any current room). */
+export declare function joinRoom(client: WsClient, roomId: string): void;
+/** Remove `client` from its room (a subsequent room broadcast won't reach it). */
+export declare function leaveRoom(client: WsClient): void;
+/** The client's current room id, or undefined if it isn't in one. */
+export declare function roomOf(client: WsClient): string | undefined;
+//# sourceMappingURL=room.d.ts.map

package/dist/server/ws/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../../src/server/ws/room.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;GAMG;AAEH;mEACmE;AACnE,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAEhD;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAG3D"}

package/dist/server/ws/room.js

@@ -0,0 +1,24 @@
+/**
+ * Rooms are not a separate stateful abstraction — they are a typed convention over
+ * {@link WsClient.meta}. A channel puts a client in a room with {@link joinRoom}; the
+ * hub's `broadcastToRoom` matches on the same key. This replaces the old `wsRoom.ts` /
+ * `reconnectableRoom.ts` classes: the hub owns connections + fan-out, the channel owns
+ * membership + any history buffer.
+ */
+/** The {@link WsClient.meta} key a client's current room id lives under. The hub's
+ * `broadcastToRoom` reads the same key — keep them in lockstep. */
+export const ROOM_META_KEY = 'roomId';
+/** Put `client` in `roomId` (replaces any current room). */
+export function joinRoom(client, roomId) {
+    client.meta[ROOM_META_KEY] = roomId;
+}
+/** Remove `client` from its room (a subsequent room broadcast won't reach it). */
+export function leaveRoom(client) {
+    delete client.meta[ROOM_META_KEY];
+}
+/** The client's current room id, or undefined if it isn't in one. */
+export function roomOf(client) {
+    const room = client.meta[ROOM_META_KEY];
+    return typeof room === 'string' ? room : undefined;
+}
+//# sourceMappingURL=room.js.map

package/dist/server/ws/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../../src/server/ws/room.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH;mEACmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAEtC,4DAA4D;AAC5D,MAAM,UAAU,QAAQ,CAAC,MAAgB,EAAE,MAAc;IACvD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,MAAgB;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,MAAM,CAAC,MAAgB;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}