@lovrozagar/honey 0.6.8 → 0.7.1

package/dist/proxy.js

@@ -0,0 +1,274 @@
+import { clientInfo } from "./context.js";
+import { HoneyError } from "./error.js";
+import { registerFeature } from "./feature-slots.js";
+import { searchOfUrl } from "./request-path.js";
+import { EK, SK } from "./types.js";
+/* Bodies up to this size with a declared length are forwarded as bytes; larger or unsized ones
+   stream (uploads). */
+const MAX_BUFFERED_BODY_BYTES = 1024 * 1024;
+/** Default time allowed until the upstream's response headers arrive. */
+const DEFAULT_TIMEOUT_MS = 60_000;
+/**
+ * Hop-by-hop headers (RFC 9110 §7.6.1) describe one connection and never cross a proxy, in
+ * either direction. `proxy-connection` is the pre-standard spelling clients still send.
+ * Headers a `Connection` header names are hop-by-hop too, see `stripHopByHop`.
+ */
+const HOP_BY_HOP = [
+    "connection",
+    "keep-alive",
+    "proxy-authenticate",
+    "proxy-authorization",
+    "proxy-connection",
+    "te",
+    "trailer",
+    "transfer-encoding",
+    "upgrade",
+];
+/**
+ * Client-sent forwarding headers. The app's `trustProxy()` setting has already decided what is
+ * true about the client (`clientInfo`); what the client wrote is replaced, never passed on.
+ */
+const FORWARDING = ["forwarded", "x-forwarded-for", "x-forwarded-host", "x-forwarded-proto", "x-real-ip"];
+/** Statuses whose response can never carry a body: rebuilding one with a body throws. */
+const NULL_BODY = new Set([101, 103, 204, 205, 304]);
+function stripHopByHop(headers, keepUpgrade) {
+    const named = headers.get("connection");
+    if (named !== null) {
+        for (const token of named.split(",")) {
+            const name = token.trim().toLowerCase();
+            if (name === "" || (keepUpgrade && name === "upgrade"))
+                continue;
+            headers.delete(name);
+        }
+    }
+    for (const name of HOP_BY_HOP) {
+        if (keepUpgrade && name === "upgrade")
+            continue;
+        headers.delete(name);
+    }
+}
+/**
+ * A streamed body that the destination never reads (a route without input that was sent `{}`)
+ * can keep the call open until it times out: a service binding does not settle while the
+ * request stream is unconsumed, and a stream teed by `request.clone()` (a body-logging
+ * middleware) has no known length. Bytes have neither problem.
+ */
+async function forwardBody(request) {
+    if (request.body === null)
+        return null;
+    const declared = request.headers.get("content-length");
+    const length = declared === null ? Number.NaN : Number.parseInt(declared, 10);
+    if (Number.isFinite(length) && length <= MAX_BUFFERED_BODY_BYTES)
+        return request.arrayBuffer();
+    return request.body;
+}
+/** Network-level codes runtimes put on errors when the upstream cannot be reached or drops. */
+const NETWORK_CODES = /^(?:E[A-Z0-9_]+|Connection\w*|UND_ERR\w*|UNABLE_\w+|CERT_\w+|DEPTH_ZERO\w*)$/;
+/**
+ * Whether `error` means the upstream failed (502), as opposed to a bug in user code (500).
+ * Fetch reports network failures as a `TypeError` — so does a typo in `destination` — and the
+ * runtimes tell them apart differently: undici and Deno say "fetch failed" (with a `cause`),
+ * Bun puts a `code` on the error (`ConnectionRefused`, `ENOTFOUND`), Workers say the network
+ * connection was lost. An invalid URL is the destination's bug.
+ */
+function isUpstreamFailure(error) {
+    if (!(error instanceof Error))
+        return false;
+    const code = error.code;
+    if (typeof code === "string")
+        return !code.startsWith("ERR_INVALID") && NETWORK_CODES.test(code);
+    if (!(error instanceof TypeError))
+        return false;
+    const message = error.message;
+    return /^fetch failed/i.test(message) || /network connection (?:was )?lost/i.test(message);
+}
+function resolveMs(opt, ctx, fallback) {
+    const ms = typeof opt === "function" ? opt(ctx) : (opt ?? fallback);
+    return ms !== undefined && ms > 0 ? ms : undefined;
+}
+function timeoutError() {
+    return new DOMException("upstream timed out", "TimeoutError");
+}
+/**
+ * The body, erroring (and aborting the upstream through `onIdle`) when the upstream sends
+ * nothing for `ms`. The clock runs only while a read is outstanding: a client that reads slowly
+ * is backpressure, not an idle upstream.
+ */
+function withIdleTimeout(body, ms, onIdle) {
+    const reader = body.getReader();
+    return new ReadableStream({
+        async cancel(reason) {
+            await reader.cancel(reason);
+        },
+        async pull(controller) {
+            let timer;
+            const idle = new Promise((resolve) => {
+                timer = setTimeout(() => resolve("idle"), ms);
+            });
+            try {
+                const result = await Promise.race([reader.read(), idle]);
+                if (result === "idle") {
+                    onIdle();
+                    const error = timeoutError();
+                    /* the upstream may not react to the abort (a binding, a stub): drop it either way */
+                    reader.cancel(error).catch(() => { });
+                    controller.error(error);
+                }
+                else if (result.done) {
+                    controller.close();
+                }
+                else {
+                    controller.enqueue(result.value);
+                }
+            }
+            catch (error) {
+                controller.error(error);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    });
+}
+/**
+ * The response the client gets: hop-by-hop headers dropped, encoding headers made true for
+ * the bytes, in a copy whose headers are mutable (fetch() responses are immutable).
+ */
+function clientResponse(response, decoded, body) {
+    const headers = new Headers(response.headers);
+    stripHopByHop(headers, false);
+    if (decoded) {
+        const encoding = headers.get("content-encoding");
+        if (encoding !== null && encoding.trim().toLowerCase() !== "identity") {
+            headers.delete("content-encoding");
+            /* the length of the encoded bytes, not of the decoded body the client receives */
+            headers.delete("content-length");
+        }
+    }
+    return new Response(NULL_BODY.has(response.status) ? null : body, {
+        headers,
+        status: response.status,
+        statusText: response.statusText,
+    });
+}
+/**
+ * Creates a proxy handler function from config.
+ * Used internally by RouteBuilder.proxy() — not meant for direct consumption.
+ *
+ * TCtx is unconstrained because HandlerCtx uses Omit which breaks structural
+ * compatibility with { path, req }. At runtime ctx is always HoneyContext
+ * which has both fields — we access them via property access on the object.
+ */
+export function createProxyHandler(config) {
+    const decoded = config.decoded !== false;
+    const forwarded = config.forwardedHeaders !== false;
+    return async (ctx) => {
+        /* HoneyContext always has path + req + signal — safe at runtime */
+        const c = ctx;
+        const request = c.req;
+        const method = request.method.toUpperCase();
+        const isWs = request.headers.get("upgrade")?.trim().toLowerCase() === "websocket";
+        const headerMs = isWs ? undefined : resolveMs(config.timeout, ctx, DEFAULT_TIMEOUT_MS);
+        const idleMs = isWs ? undefined : resolveMs(config.idleTimeout, ctx);
+        /* URL: the normalized path the router matched, plus the raw query — no new URL() */
+        const pathQuery = c.path + searchOfUrl(request.url);
+        const url = config.rewriteUrl ? config.rewriteUrl(pathQuery, ctx) : pathQuery;
+        /* headers — one copy (the original is immutable) */
+        const headers = new Headers(request.headers);
+        stripHopByHop(headers, isWs);
+        if (isWs) {
+            headers.set("upgrade", "websocket");
+            headers.set("connection", "upgrade");
+        }
+        headers.delete("host");
+        headers.delete("expect");
+        for (const name of FORWARDING)
+            headers.delete(name);
+        if (forwarded) {
+            const client = clientInfo(c);
+            if (client.ip !== null)
+                headers.set("x-forwarded-for", client.ip);
+            headers.set("x-forwarded-proto", client.protocol);
+            if (client.host !== null)
+                headers.set("x-forwarded-host", client.host);
+        }
+        /* body: every method that can carry one (fetch refuses a GET or HEAD body) */
+        const body = method === "GET" || method === "HEAD" ? null : await forwardBody(request);
+        if (body === null || body instanceof ArrayBuffer) {
+            /* no body, or bytes whose length fetch() computes itself */
+            headers.delete("content-length");
+        }
+        if (config.requestHeaders) {
+            if (typeof config.requestHeaders === "function") {
+                config.requestHeaders(ctx, headers);
+            }
+            else {
+                for (const [k, v] of Object.entries(config.requestHeaders)) {
+                    headers.set(k, v);
+                }
+            }
+        }
+        /* one controller for the proxy's own timeouts, following the request's signal */
+        const upstream = new AbortController();
+        const clientSignal = c.signal;
+        const signal = clientSignal ? AbortSignal.any([clientSignal, upstream.signal]) : upstream.signal;
+        const init = {
+            body: body ?? undefined,
+            headers,
+            method,
+            redirect: "manual",
+            signal,
+        };
+        /* duplex required for streaming body (Node needs it, CF handles implicitly) */
+        if (body instanceof ReadableStream) {
+            ;
+            init["duplex"] = "half";
+        }
+        /* forward */
+        let headerTimedOut = false;
+        const headerTimer = headerMs === undefined
+            ? undefined
+            : setTimeout(() => {
+                headerTimedOut = true;
+                upstream.abort(timeoutError());
+            }, headerMs);
+        let response;
+        try {
+            response = await config.destination(ctx, url, init);
+        }
+        catch (error) {
+            /* ours, or the destination's own AbortSignal.timeout() */
+            if (headerTimedOut || (error instanceof DOMException && error.name === "TimeoutError")) {
+                throw new HoneyError({ errorKey: EK.gateway_timeout, status: SK.gateway_timeout });
+            }
+            if (clientSignal?.aborted)
+                throw error;
+            if (isUpstreamFailure(error)) {
+                throw new HoneyError({ errorKey: EK.bad_gateway, status: SK.bad_gateway });
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(headerTimer);
+        }
+        /* WS 101 — return immediately, opaque */
+        if (response.status === 101) {
+            return response;
+        }
+        let responseBody = response.body;
+        if (responseBody !== null && idleMs !== undefined) {
+            responseBody = withIdleTimeout(responseBody, idleMs, () => upstream.abort(timeoutError()));
+        }
+        let result = clientResponse(response, decoded, responseBody);
+        /* response hook */
+        if (config.onResponse) {
+            const replaced = await config.onResponse(ctx, result);
+            if (replaced)
+                result = replaced;
+        }
+        return result;
+    };
+}
+/* `import "@lovrozagar/honey/proxy"` is what makes `.proxy()` available; the core never imports this module */
+registerFeature("proxy", { createProxyHandler });
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAEnC;uBACuB;AACvB,MAAM,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE3C,yEAAyE;AACzE,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAEjC;;;;GAIG;AACH,MAAM,UAAU,GAAG;IAClB,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,kBAAkB;IAClB,IAAI;IACJ,SAAS;IACT,mBAAmB;IACnB,SAAS;CACT,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAA;AAEzG,yFAAyF;AACzF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAEpD,SAAS,aAAa,CAAC,OAAgB,EAAE,WAAoB;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YACvC,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,KAAK,SAAS,CAAC;gBAAE,SAAQ;YAChE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC;IACF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,WAAW,IAAI,IAAI,KAAK,SAAS;YAAE,SAAQ;QAC/C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,WAAW,CAAC,OAAgB;IAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAC7E,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,uBAAuB;QAAE,OAAO,OAAO,CAAC,WAAW,EAAE,CAAA;IAC9F,OAAO,OAAO,CAAC,IAAI,CAAA;AACpB,CAAC;AAED,+FAA+F;AAC/F,MAAM,aAAa,GAAG,8EAA8E,CAAA;AAEpG;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACxC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3C,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAA;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChG,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAC7B,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC3F,CAAC;AA0FD,SAAS,SAAS,CAAO,GAAiD,EAAE,GAAS,EAAE,QAAiB;IACvG,MAAM,EAAE,GAAG,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAA;IACnE,OAAO,EAAE,KAAK,SAAS,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACnD,CAAC;AAED,SAAS,YAAY;IACpB,OAAO,IAAI,YAAY,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAA;AAC9D,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAgC,EAAE,EAAU,EAAE,MAAkB;IACxF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;IAC/B,OAAO,IAAI,cAAc,CAAa;QACrC,KAAK,CAAC,MAAM,CAAC,MAAM;YAClB,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC5B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU;YACpB,IAAI,KAAgD,CAAA;YACpD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;gBAC5C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;YAC9C,CAAC,CAAC,CAAA;YACF,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAA;gBACxD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;oBACvB,MAAM,EAAE,CAAA;oBACR,MAAM,KAAK,GAAG,YAAY,EAAE,CAAA;oBAC5B,qFAAqF;oBACrF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;oBACpC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACxB,CAAC;qBAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBACxB,UAAU,CAAC,KAAK,EAAE,CAAA;gBACnB,CAAC;qBAAM,CAAC;oBACP,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACjC,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACxB,CAAC;oBAAS,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAkB,EAAE,OAAgB,EAAE,IAAuC;IACpG,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7B,IAAI,OAAO,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;QAChD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;YACvE,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;YAClC,kFAAkF;YAClF,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;QACjC,CAAC;IACF,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;QACjE,OAAO;QACP,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;KAC/B,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAO,MAAyB;IACjE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,KAAK,CAAA;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,KAAK,KAAK,CAAA;IAEnD,OAAO,KAAK,EAAE,GAAS,EAAE,EAAE;QAC1B,mEAAmE;QACnE,MAAM,CAAC,GAAG,GAA8B,CAAA;QACxC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAA;QACrB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,WAAW,CAAA;QACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAA;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QAEpE,oFAAoF;QACpF,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACnD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAE7E,oDAAoD;QACpD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAC5B,IAAI,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;YACnC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACxB,KAAK,MAAM,IAAI,IAAI,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACnD,IAAI,SAAS,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YAC5B,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;YACjE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;YACjD,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACvE,CAAC;QAED,8EAA8E;QAC9E,MAAM,IAAI,GAAG,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;QACtF,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;YAClD,4DAA4D;YAC5D,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;QACjC,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;gBACjD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YACpC,CAAC;iBAAM,CAAC;gBACP,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC5D,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBAClB,CAAC;YACF,CAAC;QACF,CAAC;QAED,iFAAiF;QACjF,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAA;QACtC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAiC,CAAA;QACxD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAA;QAEhG,MAAM,IAAI,GAAgB;YACzB,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,OAAO;YACP,MAAM;YACN,QAAQ,EAAE,QAAQ;YAClB,MAAM;SACN,CAAA;QAED,+EAA+E;QAC/E,IAAI,IAAI,YAAY,cAAc,EAAE,CAAC;YACpC,CAAC;YAAC,IAAgC,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAA;QACtD,CAAC;QAED,aAAa;QACb,IAAI,cAAc,GAAG,KAAK,CAAA;QAC1B,MAAM,WAAW,GAChB,QAAQ,KAAK,SAAS;YACrB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;gBAChB,cAAc,GAAG,IAAI,CAAA;gBACrB,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAA;YAC/B,CAAC,EAAE,QAAQ,CAAC,CAAA;QACf,IAAI,QAAkB,CAAA;QACtB,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,0DAA0D;YAC1D,IAAI,cAAc,IAAI,CAAC,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,CAAC;gBACxF,MAAM,IAAI,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,CAAC,eAAe,EAAE,CAAC,CAAA;YACnF,CAAC;YACD,IAAI,YAAY,EAAE,OAAO;gBAAE,MAAM,KAAK,CAAA;YACtC,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;YAC3E,CAAC;YACD,MAAM,KAAK,CAAA;QACZ,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,WAAW,CAAC,CAAA;QAC1B,CAAC;QAED,yCAAyC;QACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,IAAI,YAAY,GAAsC,QAAQ,CAAC,IAAI,CAAA;QACnE,IAAI,YAAY,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACnD,YAAY,GAAG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;QAC3F,CAAC;QACD,IAAI,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAE5D,mBAAmB;QACnB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACrD,IAAI,QAAQ;gBAAE,MAAM,GAAG,QAAQ,CAAA;QAChC,CAAC;QAED,OAAO,MAAM,CAAA;IACd,CAAC,CAAA;AACF,CAAC;AAED,+GAA+G;AAC/G,eAAe,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAA"}

package/dist/python-type-emitter.d.ts

@@ -1,11 +1,24 @@
 import type { IRSchema } from "./codegen-ir.ts";
-/** Suffix reserved words with `_` per PEP 8 convention. */
+/** Attribute-safe name that keeps the original casing (`apiKeys` stays `apiKeys`).
+ * Non-identifier characters become `_`; keywords get a `_` suffix per PEP 8. */
 export declare function pyIdent(name: string): string;
+/** Module-level naming for generated types. Without it, nested objects render inline. */
+export type PyTypeNames = {
+    ref: (schemaName: string) => string;
+    /** Hoists an object schema to a named TypedDict and returns its name. */
+    hoist: (key: string, base: string, schema: Extract<IRSchema, {
+        kind: "object";
+    }>) => string;
+};
 /**
  * Convert an IRSchema to a Python type string.
  * depth > 8 returns `Any` (mirrors TS `unknown` fallback).
  */
 export declare function irToPython(ir: IRSchema, depth?: number): string;
+/** `irToPython` with module naming: refs map to emitted class names, nested objects are hoisted. */
+export declare function irToPythonNamed(ir: IRSchema, names: PyTypeNames, parent: string, field: string): string;
 /** Thin shim — delegates to irToPython(schemaToIR(schema), depth). */
 export declare function jsonSchemaToPy(schema: Record<string, unknown> | undefined, depth?: number): string;
+/** A key usable as a TypedDict class-syntax attribute (else the functional syntax is used). */
+export declare function isPyAttributeKey(key: string): boolean;
 //# sourceMappingURL=python-type-emitter.d.ts.map

package/dist/python-type-emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-type-emitter.d.ts","sourceRoot":"","sources":["../src/python-type-emitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAwCxD,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AA6CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,SAAI,GAAG,MAAM,CAoE1D;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,CAG7F"}
+{"version":3,"file":"python-type-emitter.d.ts","sourceRoot":"","sources":["../src/python-type-emitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAGxD;gFACgF;AAChF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAmCD,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG;IACzB,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,yEAAyE;IACzE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,KAAK,MAAM,CAAA;CAC3F,CAAA;AA6BD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,SAAI,GAAG,MAAM,CAE1D;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvG;AA+ED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,CAG7F;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/python-type-emitter.js

@@ -0,0 +1,157 @@
+import { schemaToIR } from "./codegen-ir.js";
+import { cmpCodeUnit, pyClassName, pyString } from "./codegen-lang.js";
+/** Attribute-safe name that keeps the original casing (`apiKeys` stays `apiKeys`).
+ * Non-identifier characters become `_`; keywords get a `_` suffix per PEP 8. */
+export function pyIdent(name) {
+    let out = name.replace(/[^A-Za-z0-9_]/g, "_");
+    if (out === "")
+        out = "value";
+    if (/^[0-9]/.test(out))
+        out = `_${out}`;
+    if (PY_HARD_KEYWORDS.has(out) || out === "self")
+        return `${out}_`;
+    return out;
+}
+const PY_HARD_KEYWORDS = new Set("False None True and as assert async await break class continue def del elif else except finally for from global if import in is lambda nonlocal not or pass raise return try while with yield".split(" "));
+function primitiveToPy(t) {
+    if (t === "string")
+        return "str";
+    if (t === "integer")
+        return "int";
+    if (t === "number")
+        return "float";
+    if (t === "boolean")
+        return "bool";
+    if (t === "null")
+        return "None";
+    return "Any";
+}
+function formatConstPy(v) {
+    if (typeof v === "string")
+        return pyString(v);
+    if (typeof v === "boolean")
+        return v ? "True" : "False";
+    return String(v);
+}
+function emitScalarPy(ir) {
+    if (ir.enum) {
+        const members = ir.enum
+            .filter((v) => v !== null)
+            .map((v) => (typeof v === "string" ? pyString(v) : typeof v === "boolean" ? (v ? "True" : "False") : String(v)))
+            .join(", ");
+        if (members === "")
+            return primitiveToPy(ir.type);
+        return `Literal[${members}]`;
+    }
+    return primitiveToPy(ir.type);
+}
+function emitObjectPy(ir, depth, ctx) {
+    const { fields, additional } = ir;
+    if (fields.length === 0) {
+        if (additional) {
+            return `dict[str, ${irToPythonCtx(additional, depth + 1, { ...ctx, field: `${ctx.field}Value` })}]`;
+        }
+        return "dict[str, Any]";
+    }
+    if (ctx.names) {
+        const base = ctx.field === "" ? ctx.parent : `${ctx.parent}${pyClassName(ctx.field)}`;
+        return ctx.names.hoist(`${ctx.parent}.${ctx.field}`, base, ir);
+    }
+    const sortedFields = fields.slice().sort((a, b) => cmpCodeUnit(a.name, b.name));
+    const entries = sortedFields.map((f) => {
+        const pyType = irToPythonCtx(f.schema, depth + 1, ctx);
+        const annotation = f.required ? pyType : `NotRequired[${pyType}]`;
+        return `${pyString(f.name)}: ${annotation}`;
+    });
+    return `TypedDict("X", {${entries.join(", ")}})`;
+}
+/**
+ * Convert an IRSchema to a Python type string.
+ * depth > 8 returns `Any` (mirrors TS `unknown` fallback).
+ */
+export function irToPython(ir, depth = 0) {
+    return irToPythonCtx(ir, depth, { field: "Value", parent: "Model" });
+}
+/** `irToPython` with module naming: refs map to emitted class names, nested objects are hoisted. */
+export function irToPythonNamed(ir, names, parent, field) {
+    return irToPythonCtx(ir, 0, { field, names, parent });
+}
+function irToPythonCtx(ir, depth, ctx) {
+    if (depth > 8)
+        return "Any";
+    switch (ir.kind) {
+        case "scalar":
+            return emitScalarPy(ir);
+        case "const":
+            return `Literal[${formatConstPy(ir.value)}]`;
+        case "object":
+            return emitObjectPy(ir, depth, ctx);
+        case "array":
+            return `list[${irToPythonCtx(ir.items, depth + 1, { ...ctx, field: `${ctx.field}Item` })}]`;
+        case "tuple":
+            return ir.items.length === 0
+                ? "tuple[()]"
+                : `tuple[${ir.items.map((i, n) => irToPythonCtx(i, depth + 1, { ...ctx, field: `${ctx.field}${n}` })).join(", ")}]`;
+        case "union": {
+            /* union-of-const → single Literal[...] to match mixed enum behavior */
+            if (ir.variants.length > 0 && ir.variants.every((v) => v.kind === "const")) {
+                const members = ir.variants
+                    .map((v) => formatConstPy(v.value))
+                    .join(", ");
+                return `Literal[${members}]`;
+            }
+            return ir.variants
+                .map((v, n) => irToPythonCtx(v, depth + 1, { ...ctx, field: `${ctx.field}Variant${n}` }))
+                .join(" | ");
+        }
+        case "allOf": {
+            const allObjects = ir.parts.every((p) => p.kind === "object");
+            if (!allObjects) {
+                if (ctx.names && ir.parts.length === 1)
+                    return irToPythonCtx(ir.parts[0], depth + 1, ctx);
+                return "Any";
+            }
+            /* later parts overwrite earlier (mirrors Object.assign semantics in old jsonSchemaToPy) */
+            const mergedMap = new Map();
+            const requiredSet = new Set();
+            for (const part of ir.parts) {
+                const obj = part;
+                for (const f of obj.fields) {
+                    mergedMap.set(f.name, f);
+                    if (f.required)
+                        requiredSet.add(f.name);
+                }
+            }
+            const mergedFields = Array.from(mergedMap.values()).map((f) => {
+                const mf = Object.assign({}, f);
+                mf.required = requiredSet.has(f.name);
+                return mf;
+            });
+            return emitObjectPy({ fields: mergedFields, kind: "object" }, depth, ctx);
+        }
+        case "ref":
+            return ctx.names ? ctx.names.ref(ir.name) : ir.name;
+        case "nullable":
+            return `${irToPythonCtx(ir.inner, depth + 1, ctx)} | None`;
+        /*
+         * binary kind arises from {type:"string", format:"binary"}.
+         * dominant case matches "str"; bare {format:"binary"} with no type is
+         * a deliberate 1-case divergence from old jsonSchemaToPy (see spec §binary).
+         */
+        case "binary":
+            return "str";
+        case "unknown":
+            return "Any";
+    }
+}
+/** Thin shim — delegates to irToPython(schemaToIR(schema), depth). */
+export function jsonSchemaToPy(schema, depth = 0) {
+    if (!schema || depth > 8)
+        return "Any";
+    return irToPython(schemaToIR(schema), depth);
+}
+/** A key usable as a TypedDict class-syntax attribute (else the functional syntax is used). */
+export function isPyAttributeKey(key) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key) && !PY_HARD_KEYWORDS.has(key) && !key.startsWith("__");
+}
+//# sourceMappingURL=python-type-emitter.js.map

package/dist/python-type-emitter.js.map

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

package/dist/realtime/bus.d.ts

@@ -1,11 +1,27 @@
+/**
+ * In-process topic bus behind `app.realtime()`. Topics are opaque keys here; the realtime server
+ * namespaces them per route before they reach the bus. Each publish serializes its payload once and
+ * hands every subscriber the same JSON text frame.
+ */
 export interface RealtimeBus {
     subscribe(connId: string, topic: string): void;
     unsubscribe(connId: string, topic: string): void;
     unsubscribeAll(connId: string): void;
+    /** Serialize `data` once and deliver the frame to every subscriber of `topic`. Throws when `data` is not JSON-serializable. */
     publish(topic: string, data: unknown): void;
-    onMessage(connId: string, handler: (data: unknown) => void): void;
+    /** Deliver an already-serialized frame to every subscriber of `topic`. */
+    publishFrame(topic: string, frame: string): void;
+    onMessage(connId: string, handler: (frame: string) => void): void;
     removeHandler(connId: string): void;
     presence(topic: string): string[];
+    /** Number of topics `connId` is subscribed to. */
+    topicCount(connId: string): number;
+    isSubscribed(connId: string, topic: string): boolean;
 }
+/**
+ * The wire format of the shipped bus: every frame, in both directions, is one JSON text.
+ * Throws a `TypeError` for values JSON cannot represent (`undefined`, functions, symbols, BigInt, cycles).
+ */
+export declare function encodeRealtimeFrame(data: unknown): string;
 export declare function createBus(): RealtimeBus;
 //# sourceMappingURL=bus.d.ts.map

package/dist/realtime/bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/realtime/bus.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAChD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IACjE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CACjC;AAED,wBAAgB,SAAS,IAAI,WAAW,CAkFvC"}
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/realtime/bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAChD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,+HAA+H;IAC/H,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3C,0EAA0E;IAC1E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IACjE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACjC,kDAAkD;IAClD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IAClC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CACpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAMzD;AAED,wBAAgB,SAAS,IAAI,WAAW,CA0GvC"}

package/dist/realtime/bus.js

@@ -0,0 +1,112 @@
+/**
+ * The wire format of the shipped bus: every frame, in both directions, is one JSON text.
+ * Throws a `TypeError` for values JSON cannot represent (`undefined`, functions, symbols, BigInt, cycles).
+ */
+export function encodeRealtimeFrame(data) {
+    const frame = JSON.stringify(data);
+    if (frame === undefined) {
+        throw new TypeError(`realtime payload is not JSON-serializable (got ${typeof data})`);
+    }
+    return frame;
+}
+export function createBus() {
+    /* topic -> set of connIds subscribed to it */
+    const topicSubs = new Map();
+    /* connId -> set of topics it is subscribed to (reverse lookup for unsubscribeAll) */
+    const connTopics = new Map();
+    /* connId -> frame sink */
+    const handlers = new Map();
+    function subscribe(connId, topic) {
+        let subs = topicSubs.get(topic);
+        if (!subs) {
+            subs = new Set();
+            topicSubs.set(topic, subs);
+        }
+        subs.add(connId);
+        let topics = connTopics.get(connId);
+        if (!topics) {
+            topics = new Set();
+            connTopics.set(connId, topics);
+        }
+        topics.add(topic);
+    }
+    function unsubscribe(connId, topic) {
+        const subs = topicSubs.get(topic);
+        if (subs) {
+            subs.delete(connId);
+            if (subs.size === 0)
+                topicSubs.delete(topic);
+        }
+        const topics = connTopics.get(connId);
+        if (topics) {
+            topics.delete(topic);
+            if (topics.size === 0)
+                connTopics.delete(connId);
+        }
+    }
+    function unsubscribeAll(connId) {
+        const topics = connTopics.get(connId);
+        if (!topics)
+            return;
+        for (const topic of topics) {
+            const subs = topicSubs.get(topic);
+            if (subs) {
+                subs.delete(connId);
+                if (subs.size === 0)
+                    topicSubs.delete(topic);
+            }
+        }
+        connTopics.delete(connId);
+    }
+    function publishFrame(topic, frame) {
+        const subs = topicSubs.get(topic);
+        if (!subs)
+            return;
+        /* snapshot: a sink that closes its connection unsubscribes while we iterate */
+        for (const connId of Array.from(subs)) {
+            const handler = handlers.get(connId);
+            if (!handler)
+                continue;
+            try {
+                handler(frame);
+            }
+            catch {
+                /* sinks are internal and contain their own errors; one must never block the others */
+            }
+        }
+    }
+    function publish(topic, data) {
+        publishFrame(topic, encodeRealtimeFrame(data));
+    }
+    function onMessage(connId, handler) {
+        handlers.set(connId, handler);
+    }
+    function removeHandler(connId) {
+        handlers.delete(connId);
+    }
+    function presence(topic) {
+        const subs = topicSubs.get(topic);
+        if (!subs)
+            return [];
+        return [...subs];
+    }
+    function topicCount(connId) {
+        return connTopics.get(connId)?.size ?? 0;
+    }
+    function isSubscribed(connId, topic) {
+        return connTopics.get(connId)?.has(topic) ?? false;
+    }
+    return {
+        isSubscribed,
+        onMessage,
+        presence,
+        publish,
+        publishFrame,
+        removeHandler,
+        subscribe,
+        topicCount,
+        unsubscribe,
+        unsubscribeAll,
+    };
+}
+//# sourceMappingURL=bus.js.map

package/dist/realtime/bus.js.map

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

package/dist/realtime/register.d.ts

@@ -0,0 +1,3 @@
+export type { ConnContext, RealtimeLimits, RealtimeRouteOpts } from "./route.ts";
+export type { RealtimePublisher } from "./server.ts";
+//# sourceMappingURL=register.d.ts.map

package/dist/realtime/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/realtime/register.ts"],"names":[],"mappings":"AAWA,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}