workerstack 0.1.0-beta.0

package/dist/query/realtime.js

@@ -0,0 +1,255 @@
+import { hashKey, notifyManager } from '@tanstack/query-core';
+import { createFlushScheduler } from './realtime-flush.js';
+import { openRealtimeStream } from './realtime-stream.js';
+function tableQueryKey(api, table) {
+    return api[table]?.key?.({ type: 'query' }) ?? [[table], { type: 'query' }];
+}
+function detailQueryKey(api, table, id) {
+    return (api[table]?.get?.queryKey?.({ input: { id } }) ?? [
+        [table, 'get'],
+        { type: 'query', input: { id } },
+    ]);
+}
+function listQueryKey(api, table) {
+    return (api[table]?.list?.key?.({ type: 'query' }) ?? [
+        [table, 'list'],
+        { type: 'query' },
+    ]);
+}
+function isListSnapshot(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Array.isArray(value.items));
+}
+/** Dates arrive as Dates over the wire, so identity is not enough. */
+function sameValue(a, b) {
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    return a === b;
+}
+/**
+ * Workerstack's filter contract is narrow by design — a scalar is `=`, an
+ * array is `IN`, and `null` is `IS NULL` — so membership is decidable against
+ * a single record without asking the server.
+ */
+function matchesFilters(record, filters) {
+    for (const [column, expected] of Object.entries(filters ?? {})) {
+        if (expected === undefined)
+            continue;
+        const actual = record[column];
+        if (expected === null) {
+            if (actual !== null && actual !== undefined)
+                return false;
+            continue;
+        }
+        if (Array.isArray(expected)) {
+            if (!expected.some((value) => sameValue(value, actual)))
+                return false;
+            continue;
+        }
+        if (!sameValue(expected, actual))
+            return false;
+    }
+    return true;
+}
+function compareValues(a, b) {
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() - b.getTime();
+    if (typeof a === 'number' && typeof b === 'number')
+        return a - b;
+    if (typeof a === 'boolean' && typeof b === 'boolean')
+        return Number(a) - Number(b);
+    return String(a).localeCompare(String(b));
+}
+/**
+ * Where the row goes in an already-sorted page.
+ *
+ * Ties are common rather than exotic: a `timestamp` column stores seconds, so
+ * rows written in the same second share a sort value. SQL does not define an
+ * order within a tie, so the new row is placed as the most recent of its
+ * equals — first under `desc`, last under `asc` — which is where a reader
+ * expects a just-written row to appear.
+ */
+function insertionIndex(items, record, sort, order) {
+    const value = record[sort];
+    const index = items.findIndex((item) => {
+        const comparison = compareValues(value, item[sort]);
+        return order === 'desc' ? comparison >= 0 : comparison < 0;
+    });
+    return index === -1 ? items.length : index;
+}
+/**
+ * A cached page can only absorb an insert when it already holds every row the
+ * query would return. A partial page cannot: the new row may belong to another
+ * page, and inserting would shift the boundary the server drew.
+ */
+function holdsCompleteResult(snapshot) {
+    return (snapshot.hasMore === false &&
+        !snapshot.cursor &&
+        (snapshot.offset === undefined || snapshot.offset === 0));
+}
+function readInput(queryKey) {
+    const meta = queryKey[1];
+    const input = meta?.input;
+    return typeof input === 'object' && input !== null
+        ? input
+        : {};
+}
+export function syncRealtime(options) {
+    const scheduler = createFlushScheduler(options.notifyScheduler ?? 'frame', options.clock);
+    /** Changes waiting for the next flush, in arrival order. */
+    const buffered = [];
+    /**
+     * Query keys the flush must invalidate, deduplicated by their hash. Keyed
+     * this way rather than by table so a list that cannot absorb a change still
+     * invalidates only itself, while a burst against one key collapses to one
+     * call.
+     */
+    const stale = new Map();
+    const invalidateAll = async () => {
+        await Promise.all(options.tables.map((table) => options.queryClient.invalidateQueries({
+            queryKey: tableQueryKey(options.api, table),
+        })));
+    };
+    /**
+     * Write the change into every cached list for the table, marking the table
+     * stale for any list whose membership or ordering cannot be settled locally.
+     * A list is only patched when the answer is certain.
+     */
+    const patchLists = (change) => {
+        const prefix = listQueryKey(options.api, change.table);
+        const queries = options.queryClient
+            .getQueryCache()
+            .findAll({ queryKey: prefix });
+        const id = change.record['id'];
+        for (const query of queries) {
+            const snapshot = query.state.data;
+            if (!isListSnapshot(snapshot))
+                continue;
+            const queryKey = query.queryKey;
+            const items = snapshot.items;
+            const present = items.some((item) => sameValue(item['id'], id));
+            if (change.action === 'delete') {
+                if (!present)
+                    continue;
+                options.queryClient.setQueryData(queryKey, {
+                    ...snapshot,
+                    items: items.filter((item) => !sameValue(item['id'], id)),
+                    ...(typeof snapshot.total === 'number'
+                        ? { total: Math.max(0, snapshot.total - 1) }
+                        : {}),
+                });
+                continue;
+            }
+            const input = readInput(queryKey);
+            const belongs = matchesFilters(change.record, input['filters']);
+            // An update can move a row out of a filtered list.
+            if (!belongs) {
+                if (!present)
+                    continue;
+                options.queryClient.setQueryData(queryKey, {
+                    ...snapshot,
+                    items: items.filter((item) => !sameValue(item['id'], id)),
+                    ...(typeof snapshot.total === 'number'
+                        ? { total: Math.max(0, snapshot.total - 1) }
+                        : {}),
+                });
+                continue;
+            }
+            // Already here: replace in place and keep the row where it is.
+            if (present) {
+                options.queryClient.setQueryData(queryKey, {
+                    ...snapshot,
+                    items: items.map((item) => sameValue(item['id'], id) ? change.record : item),
+                });
+                continue;
+            }
+            // The row joins this list. Only safe on a page that holds everything,
+            // and only when `q` is absent — a text match needs the server's
+            // searchable columns to evaluate.
+            const searched = snapshot.q ?? input['q'];
+            const sort = snapshot.sort ?? input['sort'];
+            const order = snapshot.order ?? input['order'];
+            if (searched || !sort || !order || !holdsCompleteResult(snapshot)) {
+                stale.set(hashKey(queryKey), queryKey);
+                continue;
+            }
+            const next = items.slice();
+            next.splice(insertionIndex(items, change.record, sort, order), 0, change.record);
+            options.queryClient.setQueryData(queryKey, {
+                ...snapshot,
+                items: next,
+                ...(typeof snapshot.total === 'number'
+                    ? { total: snapshot.total + 1 }
+                    : {}),
+            });
+        }
+    };
+    const applyOne = (change) => {
+        // The runtime shape is the same either way; the generic only narrows what
+        // callers see.
+        options.onChange?.(change);
+        const id = change.record['id'];
+        if (id !== undefined) {
+            const queryKey = detailQueryKey(options.api, change.table, id);
+            if (change.action === 'delete')
+                options.queryClient.removeQueries({ queryKey });
+            else
+                options.queryClient.setQueryData(queryKey, change.record);
+        }
+        if (options.apply === 'patch') {
+            patchLists(change);
+            return;
+        }
+        const tableKey = tableQueryKey(options.api, change.table);
+        stale.set(hashKey(tableKey), tableKey);
+    };
+    /**
+     * One pass over the buffer, then one invalidation per stale table. The
+     * second part is the point: a burst of changes to a table used to issue one
+     * `invalidateQueries` each, and now issues one in total.
+     */
+    const flush = () => {
+        if (buffered.length === 0)
+            return;
+        const batch = buffered.splice(0, buffered.length);
+        notifyManager.batch(() => {
+            for (const change of batch)
+                applyOne(change);
+            for (const queryKey of stale.values())
+                void options.queryClient.invalidateQueries({ queryKey });
+            stale.clear();
+        });
+    };
+    const stream = openRealtimeStream({
+        subscribe: ({ signal, lastEventId }) => options.api.realtime.changes.call({ tables: options.tables }, { signal, lastEventId }),
+        onChange: (change) => {
+            buffered.push(change);
+            scheduler.schedule(flush);
+        },
+        onReconnect: async () => {
+            // A refetch of everything supersedes whatever was still buffered.
+            scheduler.cancel();
+            buffered.length = 0;
+            stale.clear();
+            await invalidateAll();
+            await options.onReconnect?.();
+        },
+        onError: options.onError,
+        onRetry: options.onRetry,
+        signal: options.signal ?? new AbortController().signal,
+        retryMs: options.retryMs,
+        maxRetryMs: options.maxRetryMs,
+        clock: options.clock,
+    });
+    return {
+        close: () => {
+            stream.close();
+            // Anything already delivered is still owed to the cache.
+            scheduler.cancel();
+            flush();
+        },
+        done: stream.done,
+    };
+}
+//# sourceMappingURL=realtime.js.map

package/dist/query/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/query/realtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAgB7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AA+GtD,SAAS,aAAa,CAAC,GAAqB,EAAE,KAAa;IACzD,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,cAAc,CACrB,GAAqB,EACrB,KAAa,EACb,EAAW;IAEX,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI;QAChD,CAAC,KAAK,EAAE,KAAK,CAAC;QACd,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE;KACjC,CACF,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAqB,EAAE,KAAa;IACxD,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI;QAC5C,CAAC,KAAK,EAAE,MAAM,CAAC;QACf,EAAE,IAAI,EAAE,OAAO,EAAE;KAClB,CACF,CAAA;AACH,CAAC;AAcD,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAE,KAAsB,CAAC,KAAK,CAAC,CAC7C,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;IAC9E,OAAO,CAAC,KAAK,CAAC,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,MAA+B,EAC/B,OAA4C;IAE5C,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/D,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAQ;QACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAA;YACzD,SAAQ;QACV,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;YACrE,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;YAAE,OAAO,KAAK,CAAA;IAChD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,aAAa,CAAC,CAAU,EAAE,CAAU;IAC3C,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;IAC5E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAChE,IAAI,OAAO,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,SAAS;QAClD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,cAAc,CACrB,KAAgC,EAChC,MAA+B,EAC/B,IAAY,EACZ,KAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACnD,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IACF,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,QAAsB;IACjD,OAAO,CACL,QAAQ,CAAC,OAAO,KAAK,KAAK;QAC1B,CAAC,QAAQ,CAAC,MAAM;QAChB,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CACzD,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,QAAkB;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAoC,CAAA;IAC3D,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAChD,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,MAAM,UAAU,YAAY,CAG1B,OAA0C;IAC1C,MAAM,SAAS,GAAG,oBAAoB,CACpC,OAAO,CAAC,eAAe,IAAI,OAAO,EAClC,OAAO,CAAC,KAAK,CACd,CAAA;IACD,4DAA4D;IAC5D,MAAM,QAAQ,GAAqB,EAAE,CAAA;IACrC;;;;;OAKG;IACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEzC,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;QAC/B,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACpC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;SAC5C,CAAC,CACH,CACF,CAAA;IACH,CAAC,CAAA;IAED;;;;OAIG;IACH,MAAM,UAAU,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW;aAChC,aAAa,EAAE;aACf,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAChC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAE9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;YACjC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;gBAAE,SAAQ;YAEvC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;YAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;YAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;YAE/D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,OAAO;oBAAE,SAAQ;gBACtB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACzC,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzD,GAAG,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;wBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE;wBAC5C,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;YACjC,MAAM,OAAO,GAAG,cAAc,CAC5B,MAAM,CAAC,MAAM,EACb,KAAK,CAAC,SAAS,CAAwC,CACxD,CAAA;YAED,mDAAmD;YACnD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO;oBAAE,SAAQ;gBACtB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACzC,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzD,GAAG,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;wBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE;wBAC5C,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YAED,+DAA+D;YAC/D,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACzC,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CACjD;iBACF,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YAED,sEAAsE;YACtE,gEAAgE;YAChE,kCAAkC;YAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAK,KAAK,CAAC,GAAG,CAAwB,CAAA;YACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAK,KAAK,CAAC,MAAM,CAAwB,CAAA;YACnE,MAAM,KAAK,GACT,QAAQ,CAAC,KAAK,IAAK,KAAK,CAAC,OAAO,CAAgC,CAAA;YAElE,IAAI,QAAQ,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACtC,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YAC1B,IAAI,CAAC,MAAM,CACT,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EACjD,CAAC,EACD,MAAM,CAAC,MAAM,CACd,CAAA;YACD,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;gBACzC,GAAG,QAAQ;gBACX,KAAK,EAAE,IAAI;gBACX,GAAG,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;oBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE;oBAC/B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC1C,0EAA0E;QAC1E,eAAe;QACf,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAwC,CAAC,CAAA;QAC5D,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAC5B,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;;gBAC5C,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAChE,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC9B,UAAU,CAAC,MAAM,CAAC,CAAA;YAClB,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACzD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC,CAAA;IAED;;;;OAIG;IACH,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;QACjD,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE;YACvB,KAAK,MAAM,MAAM,IAAI,KAAK;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC5C,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE;gBACnC,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC1D,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAC/B,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAC1B,EAAE,MAAM,EAAE,WAAW,EAAE,CACxB;QACH,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YACnB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrB,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;QACD,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,kEAAkE;YAClE,SAAS,CAAC,MAAM,EAAE,CAAA;YAClB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YACnB,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,MAAM,aAAa,EAAE,CAAA;YACrB,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;QAC/B,CAAC;QACD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAA;IAEF,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,EAAE,CAAA;YACd,yDAAyD;YACzD,SAAS,CAAC,MAAM,EAAE,CAAA;YAClB,KAAK,EAAE,CAAA;QACT,CAAC;QACD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC","sourcesContent":["import type { QueryClient, QueryKey } from '@tanstack/query-core'\n\nimport { hashKey, notifyManager } from '@tanstack/query-core'\n\nimport type {\n  AnyWorkerstackApp,\n  InferSchema,\n  InferSelect,\n  InferTables,\n} from './infer'\nimport type { NotifyScheduler, RealtimeClock } from './realtime-flush'\nimport type {\n  RealtimeAction,\n  RealtimeChange,\n  RealtimeProcedure,\n  RealtimeSyncHandle,\n} from './realtime-stream'\n\nimport { createFlushScheduler } from './realtime-flush'\nimport { openRealtimeStream } from './realtime-stream'\n\n// The event types live with the stream that produces them; re-exported here so\n// the package's public surface is unchanged.\nexport type { NotifyScheduler, RealtimeClock } from './realtime-flush'\nexport type {\n  RealtimeAction,\n  RealtimeChange,\n  RealtimeEvent,\n  RealtimeHeartbeat,\n  RealtimeProcedure,\n  RealtimeSyncHandle,\n} from './realtime-stream'\n\n/**\n * The change for one table, with `record` typed as that table's row.\n *\n * Passing the app type to `syncRealtime` turns `tables` into a checked list of\n * exposed table names and `onChange` into a union discriminated by `table`, so\n * `change.table === 'todos'` narrows `change.record` to the todo row:\n *\n * ```ts\n * syncRealtime<App>({\n *   api,\n *   queryClient,\n *   tables: ['todos'],\n *   onChange: (change) => {\n *     if (change.table === 'todos') console.log(change.record.done)\n *   },\n * })\n * ```\n */\nexport type RealtimeChangeFor<\n  TApp extends AnyWorkerstackApp,\n  TTable extends InferTables<TApp>,\n> = {\n  table: TTable\n  action: RealtimeAction\n  record: InferSelect<InferSchema<TApp>[TTable]>\n  operationId?: string\n}\n\n/**\n * Untyped when no app type is supplied, so existing callers — and consumers\n * that only have a structural client — keep the loose `RealtimeChange`.\n */\nexport type RealtimeChangeOf<TApp, TTable extends string> = [TApp] extends [\n  never,\n]\n  ? RealtimeChange\n  : TApp extends AnyWorkerstackApp\n    ? TTable extends InferTables<TApp>\n      ? RealtimeChangeFor<TApp, TTable>\n      : RealtimeChange\n    : RealtimeChange\n\n/** Every exposed table name, or any string when no app type is supplied. */\nexport type RealtimeTableName<TApp> = [TApp] extends [never]\n  ? string\n  : TApp extends AnyWorkerstackApp\n    ? InferTables<TApp>\n    : string\n\nexport type RealtimeQueryApi = {\n  realtime: { changes: RealtimeProcedure }\n  [table: string]: any\n}\n\n/**\n * How a change reaches the cache.\n *\n * `invalidate` (default) marks the table's queries stale and lets TanStack\n * Query refetch them — always correct, one request per change.\n *\n * `patch` writes the change into cached list results instead, so a write costs\n * no extra request. The event carries the action and the full row, and\n * Workerstack's list contract is narrow enough to decide membership locally:\n * filters are `=`, `IN`, or `IS NULL`, and ordering is a single column. Any\n * list where that is not decidable — a text search, or a page that is not the\n * complete result — falls back to invalidation.\n */\nexport type RealtimeApplyStrategy = 'invalidate' | 'patch'\n\nexport type RealtimeSyncOptions<\n  TApp = never,\n  TTable extends string = RealtimeTableName<TApp>,\n> = {\n  api: RealtimeQueryApi\n  queryClient: QueryClient\n  tables: TTable[]\n  signal?: AbortSignal\n  /** Defaults to `'invalidate'`. */\n  apply?: RealtimeApplyStrategy\n  /**\n   * When buffered changes reach the cache. Defaults to `'frame'`, which\n   * collapses a burst into one cache write and one invalidation per table.\n   * Pass `'sync'` to write as each change arrives, as versions before 0.18 did.\n   */\n  notifyScheduler?: NotifyScheduler\n  /** Timer functions, injectable for tests. */\n  clock?: RealtimeClock\n  /** Initial reconnect delay before jitter. Defaults to 1 second. */\n  retryMs?: number\n  /** Maximum reconnect delay before jitter. Defaults to 30 seconds. */\n  maxRetryMs?: number\n  onChange?: (change: RealtimeChangeOf<TApp, TTable>) => void\n  onReconnect?: () => void | Promise<void>\n  onError?: (error: unknown) => void\n  onRetry?: (retry: { attempt: number; delayMs: number }) => void\n}\n\nfunction tableQueryKey(api: RealtimeQueryApi, table: string): QueryKey {\n  return api[table]?.key?.({ type: 'query' }) ?? [[table], { type: 'query' }]\n}\n\nfunction detailQueryKey(\n  api: RealtimeQueryApi,\n  table: string,\n  id: unknown,\n): QueryKey {\n  return (\n    api[table]?.get?.queryKey?.({ input: { id } }) ?? [\n      [table, 'get'],\n      { type: 'query', input: { id } },\n    ]\n  )\n}\n\nfunction listQueryKey(api: RealtimeQueryApi, table: string): QueryKey {\n  return (\n    api[table]?.list?.key?.({ type: 'query' }) ?? [\n      [table, 'list'],\n      { type: 'query' },\n    ]\n  )\n}\n\n/** The shape every generated list endpoint returns, as far as patching cares. */\ntype ListSnapshot = {\n  items: Record<string, unknown>[]\n  hasMore?: boolean\n  total?: number\n  offset?: number\n  cursor?: string\n  q?: string\n  sort?: string\n  order?: 'asc' | 'desc'\n}\n\nfunction isListSnapshot(value: unknown): value is ListSnapshot {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Array.isArray((value as ListSnapshot).items)\n  )\n}\n\n/** Dates arrive as Dates over the wire, so identity is not enough. */\nfunction sameValue(a: unknown, b: unknown): boolean {\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime()\n  return a === b\n}\n\n/**\n * Workerstack's filter contract is narrow by design — a scalar is `=`, an\n * array is `IN`, and `null` is `IS NULL` — so membership is decidable against\n * a single record without asking the server.\n */\nfunction matchesFilters(\n  record: Record<string, unknown>,\n  filters: Record<string, unknown> | undefined,\n): boolean {\n  for (const [column, expected] of Object.entries(filters ?? {})) {\n    if (expected === undefined) continue\n    const actual = record[column]\n    if (expected === null) {\n      if (actual !== null && actual !== undefined) return false\n      continue\n    }\n    if (Array.isArray(expected)) {\n      if (!expected.some((value) => sameValue(value, actual))) return false\n      continue\n    }\n    if (!sameValue(expected, actual)) return false\n  }\n  return true\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime()\n  if (typeof a === 'number' && typeof b === 'number') return a - b\n  if (typeof a === 'boolean' && typeof b === 'boolean')\n    return Number(a) - Number(b)\n  return String(a).localeCompare(String(b))\n}\n\n/**\n * Where the row goes in an already-sorted page.\n *\n * Ties are common rather than exotic: a `timestamp` column stores seconds, so\n * rows written in the same second share a sort value. SQL does not define an\n * order within a tie, so the new row is placed as the most recent of its\n * equals — first under `desc`, last under `asc` — which is where a reader\n * expects a just-written row to appear.\n */\nfunction insertionIndex(\n  items: Record<string, unknown>[],\n  record: Record<string, unknown>,\n  sort: string,\n  order: 'asc' | 'desc',\n): number {\n  const value = record[sort]\n  const index = items.findIndex((item) => {\n    const comparison = compareValues(value, item[sort])\n    return order === 'desc' ? comparison >= 0 : comparison < 0\n  })\n  return index === -1 ? items.length : index\n}\n\n/**\n * A cached page can only absorb an insert when it already holds every row the\n * query would return. A partial page cannot: the new row may belong to another\n * page, and inserting would shift the boundary the server drew.\n */\nfunction holdsCompleteResult(snapshot: ListSnapshot): boolean {\n  return (\n    snapshot.hasMore === false &&\n    !snapshot.cursor &&\n    (snapshot.offset === undefined || snapshot.offset === 0)\n  )\n}\n\nfunction readInput(queryKey: QueryKey): Record<string, unknown> {\n  const meta = queryKey[1] as { input?: unknown } | undefined\n  const input = meta?.input\n  return typeof input === 'object' && input !== null\n    ? (input as Record<string, unknown>)\n    : {}\n}\n\nexport function syncRealtime<\n  TApp = never,\n  TTable extends string = RealtimeTableName<TApp>,\n>(options: RealtimeSyncOptions<TApp, TTable>): RealtimeSyncHandle {\n  const scheduler = createFlushScheduler(\n    options.notifyScheduler ?? 'frame',\n    options.clock,\n  )\n  /** Changes waiting for the next flush, in arrival order. */\n  const buffered: RealtimeChange[] = []\n  /**\n   * Query keys the flush must invalidate, deduplicated by their hash. Keyed\n   * this way rather than by table so a list that cannot absorb a change still\n   * invalidates only itself, while a burst against one key collapses to one\n   * call.\n   */\n  const stale = new Map<string, QueryKey>()\n\n  const invalidateAll = async () => {\n    await Promise.all(\n      options.tables.map((table) =>\n        options.queryClient.invalidateQueries({\n          queryKey: tableQueryKey(options.api, table),\n        }),\n      ),\n    )\n  }\n\n  /**\n   * Write the change into every cached list for the table, marking the table\n   * stale for any list whose membership or ordering cannot be settled locally.\n   * A list is only patched when the answer is certain.\n   */\n  const patchLists = (change: RealtimeChange) => {\n    const prefix = listQueryKey(options.api, change.table)\n    const queries = options.queryClient\n      .getQueryCache()\n      .findAll({ queryKey: prefix })\n    const id = change.record['id']\n\n    for (const query of queries) {\n      const snapshot = query.state.data\n      if (!isListSnapshot(snapshot)) continue\n\n      const queryKey = query.queryKey\n      const items = snapshot.items\n      const present = items.some((item) => sameValue(item['id'], id))\n\n      if (change.action === 'delete') {\n        if (!present) continue\n        options.queryClient.setQueryData(queryKey, {\n          ...snapshot,\n          items: items.filter((item) => !sameValue(item['id'], id)),\n          ...(typeof snapshot.total === 'number'\n            ? { total: Math.max(0, snapshot.total - 1) }\n            : {}),\n        })\n        continue\n      }\n\n      const input = readInput(queryKey)\n      const belongs = matchesFilters(\n        change.record,\n        input['filters'] as Record<string, unknown> | undefined,\n      )\n\n      // An update can move a row out of a filtered list.\n      if (!belongs) {\n        if (!present) continue\n        options.queryClient.setQueryData(queryKey, {\n          ...snapshot,\n          items: items.filter((item) => !sameValue(item['id'], id)),\n          ...(typeof snapshot.total === 'number'\n            ? { total: Math.max(0, snapshot.total - 1) }\n            : {}),\n        })\n        continue\n      }\n\n      // Already here: replace in place and keep the row where it is.\n      if (present) {\n        options.queryClient.setQueryData(queryKey, {\n          ...snapshot,\n          items: items.map((item) =>\n            sameValue(item['id'], id) ? change.record : item,\n          ),\n        })\n        continue\n      }\n\n      // The row joins this list. Only safe on a page that holds everything,\n      // and only when `q` is absent — a text match needs the server's\n      // searchable columns to evaluate.\n      const searched = snapshot.q ?? (input['q'] as string | undefined)\n      const sort = snapshot.sort ?? (input['sort'] as string | undefined)\n      const order =\n        snapshot.order ?? (input['order'] as 'asc' | 'desc' | undefined)\n\n      if (searched || !sort || !order || !holdsCompleteResult(snapshot)) {\n        stale.set(hashKey(queryKey), queryKey)\n        continue\n      }\n\n      const next = items.slice()\n      next.splice(\n        insertionIndex(items, change.record, sort, order),\n        0,\n        change.record,\n      )\n      options.queryClient.setQueryData(queryKey, {\n        ...snapshot,\n        items: next,\n        ...(typeof snapshot.total === 'number'\n          ? { total: snapshot.total + 1 }\n          : {}),\n      })\n    }\n  }\n\n  const applyOne = (change: RealtimeChange) => {\n    // The runtime shape is the same either way; the generic only narrows what\n    // callers see.\n    options.onChange?.(change as RealtimeChangeOf<TApp, TTable>)\n    const id = change.record['id']\n    if (id !== undefined) {\n      const queryKey = detailQueryKey(options.api, change.table, id)\n      if (change.action === 'delete')\n        options.queryClient.removeQueries({ queryKey })\n      else options.queryClient.setQueryData(queryKey, change.record)\n    }\n\n    if (options.apply === 'patch') {\n      patchLists(change)\n      return\n    }\n\n    const tableKey = tableQueryKey(options.api, change.table)\n    stale.set(hashKey(tableKey), tableKey)\n  }\n\n  /**\n   * One pass over the buffer, then one invalidation per stale table. The\n   * second part is the point: a burst of changes to a table used to issue one\n   * `invalidateQueries` each, and now issues one in total.\n   */\n  const flush = () => {\n    if (buffered.length === 0) return\n    const batch = buffered.splice(0, buffered.length)\n    notifyManager.batch(() => {\n      for (const change of batch) applyOne(change)\n      for (const queryKey of stale.values())\n        void options.queryClient.invalidateQueries({ queryKey })\n      stale.clear()\n    })\n  }\n\n  const stream = openRealtimeStream({\n    subscribe: ({ signal, lastEventId }) =>\n      options.api.realtime.changes.call(\n        { tables: options.tables },\n        { signal, lastEventId },\n      ),\n    onChange: (change) => {\n      buffered.push(change)\n      scheduler.schedule(flush)\n    },\n    onReconnect: async () => {\n      // A refetch of everything supersedes whatever was still buffered.\n      scheduler.cancel()\n      buffered.length = 0\n      stale.clear()\n      await invalidateAll()\n      await options.onReconnect?.()\n    },\n    onError: options.onError,\n    onRetry: options.onRetry,\n    signal: options.signal ?? new AbortController().signal,\n    retryMs: options.retryMs,\n    maxRetryMs: options.maxRetryMs,\n    clock: options.clock,\n  })\n\n  return {\n    close: () => {\n      stream.close()\n      // Anything already delivered is still owed to the cache.\n      scheduler.cancel()\n      flush()\n    },\n    done: stream.done,\n  }\n}\n"]}

package/dist/rate-limit.d.ts

@@ -0,0 +1,8 @@
+import { type RateLimitStore } from './platform.js';
+export type RateLimitConfig = {
+    windowMs?: number;
+    max?: number;
+    skip?: (req: Request) => boolean;
+};
+export declare function createRateLimiter(config: boolean | RateLimitConfig | undefined, store?: RateLimitStore): (req: Request) => Promise<Response | null>;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAE5E,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CACjC,CAAA;AAkBD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,EAC7C,KAAK,GAAE,cAA6C,GACnD,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgC5C"}

package/dist/rate-limit.js

@@ -0,0 +1,46 @@
+import { createMemoryRateLimitStore } from './platform.js';
+function resolveConfig(config) {
+    if (!config)
+        return null;
+    if (config === true)
+        return {};
+    return config;
+}
+function clientKey(req) {
+    const cloudflare = req.headers.get('cf-connecting-ip');
+    if (cloudflare)
+        return cloudflare;
+    const forwarded = req.headers.get('x-forwarded-for');
+    if (forwarded)
+        return forwarded.split(',')[0].trim();
+    return req.headers.get('x-real-ip') ?? 'local';
+}
+export function createRateLimiter(config, store = createMemoryRateLimitStore()) {
+    const resolved = resolveConfig(config);
+    if (!resolved) {
+        return async (_req) => null;
+    }
+    const windowMs = resolved.windowMs ?? 60_000;
+    const max = resolved.max ?? 100;
+    return async (req) => {
+        if (resolved.skip?.(req))
+            return null;
+        const key = `${clientKey(req)}:${new URL(req.url).pathname}`;
+        const now = Date.now();
+        const { allowed, resetAt } = await store.hit(key, windowMs, max, now);
+        if (allowed)
+            return null;
+        const retryAfter = Math.max(1, Math.ceil((resetAt - now) / 1000));
+        return new Response(JSON.stringify({
+            error: 'Too many requests',
+            code: 'TOO_MANY_REQUESTS',
+        }), {
+            status: 429,
+            headers: {
+                'Content-Type': 'application/json',
+                'Retry-After': String(retryAfter),
+            },
+        });
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAuB,MAAM,YAAY,CAAA;AAQ5E,SAAS,aAAa,CACpB,MAA6C;IAE7C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAC9B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IACtD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IACjC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;IACpD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAA;IACrD,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAA6C,EAC7C,QAAwB,0BAA0B,EAAE;IAEpD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC,IAAI,CAAA;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAA;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,CAAA;IAE/B,OAAO,KAAK,EAAE,GAAY,EAA4B,EAAE;QACtD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAErC,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QACrE,IAAI,OAAO;YAAE,OAAO,IAAI,CAAA;QAExB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;QACjE,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,mBAAmB;SAC1B,CAAC,EACF;YACE,MAAM,EAAE,GAAG;YACX,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC;aAClC;SACF,CACF,CAAA;IACH,CAAC,CAAA;AACH,CAAC","sourcesContent":["import { createMemoryRateLimitStore, type RateLimitStore } from './platform'\n\nexport type RateLimitConfig = {\n  windowMs?: number\n  max?: number\n  skip?: (req: Request) => boolean\n}\n\nfunction resolveConfig(\n  config: boolean | RateLimitConfig | undefined,\n): RateLimitConfig | null {\n  if (!config) return null\n  if (config === true) return {}\n  return config\n}\n\nfunction clientKey(req: Request): string {\n  const cloudflare = req.headers.get('cf-connecting-ip')\n  if (cloudflare) return cloudflare\n  const forwarded = req.headers.get('x-forwarded-for')\n  if (forwarded) return forwarded.split(',')[0]!.trim()\n  return req.headers.get('x-real-ip') ?? 'local'\n}\n\nexport function createRateLimiter(\n  config: boolean | RateLimitConfig | undefined,\n  store: RateLimitStore = createMemoryRateLimitStore(),\n): (req: Request) => Promise<Response | null> {\n  const resolved = resolveConfig(config)\n  if (!resolved) {\n    return async (_req: Request) => null\n  }\n\n  const windowMs = resolved.windowMs ?? 60_000\n  const max = resolved.max ?? 100\n\n  return async (req: Request): Promise<Response | null> => {\n    if (resolved.skip?.(req)) return null\n\n    const key = `${clientKey(req)}:${new URL(req.url).pathname}`\n    const now = Date.now()\n    const { allowed, resetAt } = await store.hit(key, windowMs, max, now)\n    if (allowed) return null\n\n    const retryAfter = Math.max(1, Math.ceil((resetAt - now) / 1000))\n    return new Response(\n      JSON.stringify({\n        error: 'Too many requests',\n        code: 'TOO_MANY_REQUESTS',\n      }),\n      {\n        status: 429,\n        headers: {\n          'Content-Type': 'application/json',\n          'Retry-After': String(retryAfter),\n        },\n      },\n    )\n  }\n}\n"]}

package/dist/readiness-probes.d.ts

@@ -0,0 +1,4 @@
+import type { AnyDb } from './dialect.js';
+import type { ReadinessProbes } from './readiness.js';
+export declare function createReadinessProbes(db: AnyDb, now?: () => number): Pick<ReadinessProbes, 'probeDatabase' | 'countOverdueJobs'>;
+//# sourceMappingURL=readiness-probes.d.ts.map

package/dist/readiness-probes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-probes.d.ts","sourceRoot":"","sources":["../src/readiness-probes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,KAAK,EACT,GAAG,GAAE,MAAM,MAAiB,GAC3B,IAAI,CAAC,eAAe,EAAE,eAAe,GAAG,kBAAkB,CAAC,CAe7D"}

package/dist/readiness-probes.js

@@ -0,0 +1,23 @@
+// src/readiness-probes.ts — the internal jobs table doubles as the liveness
+// query: reaching it proves the connection, and a missing-relation error proves
+// the schema was never provisioned.
+import { and, count, eq, lt } from 'drizzle-orm';
+import { workerstackJobs } from './internal-tables.js';
+/** A pending job this far past its `runAt` means nothing is draining the queue. */
+const OVERDUE_MS = 60_000;
+export function createReadinessProbes(db, now = Date.now) {
+    const t = workerstackJobs;
+    return {
+        probeDatabase: async () => {
+            await db.select({ id: t.id }).from(t).limit(1);
+        },
+        countOverdueJobs: async () => {
+            const rows = await db
+                .select({ overdue: count() })
+                .from(t)
+                .where(and(eq(t.status, 'pending'), lt(t.runAt, now() - OVERDUE_MS)));
+            return Number(rows[0]?.overdue ?? 0);
+        },
+    };
+}
+//# sourceMappingURL=readiness-probes.js.map

package/dist/readiness-probes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-probes.js","sourceRoot":"","sources":["../src/readiness-probes.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,oCAAoC;AACpC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAKhD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,mFAAmF;AACnF,MAAM,UAAU,GAAG,MAAM,CAAA;AAEzB,MAAM,UAAU,qBAAqB,CACnC,EAAS,EACT,MAAoB,IAAI,CAAC,GAAG;IAE5B,MAAM,CAAC,GAAG,eAAe,CAAA;IAEzB,OAAO;QACL,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAChD,CAAC;QACD,gBAAgB,EAAE,KAAK,IAAI,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,EAAE;iBAClB,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;iBAC5B,IAAI,CAAC,CAAC,CAAC;iBACP,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YACvE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAA;QACtC,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["// src/readiness-probes.ts — the internal jobs table doubles as the liveness\n// query: reaching it proves the connection, and a missing-relation error proves\n// the schema was never provisioned.\nimport { and, count, eq, lt } from 'drizzle-orm'\n\nimport type { AnyDb } from './dialect'\nimport type { ReadinessProbes } from './readiness'\n\nimport { workerstackJobs } from './internal-tables'\n\n/** A pending job this far past its `runAt` means nothing is draining the queue. */\nconst OVERDUE_MS = 60_000\n\nexport function createReadinessProbes(\n  db: AnyDb,\n  now: () => number = Date.now,\n): Pick<ReadinessProbes, 'probeDatabase' | 'countOverdueJobs'> {\n  const t = workerstackJobs\n\n  return {\n    probeDatabase: async () => {\n      await db.select({ id: t.id }).from(t).limit(1)\n    },\n    countOverdueJobs: async () => {\n      const rows = await db\n        .select({ overdue: count() })\n        .from(t)\n        .where(and(eq(t.status, 'pending'), lt(t.runAt, now() - OVERDUE_MS)))\n      return Number(rows[0]?.overdue ?? 0)\n    },\n  }\n}\n"]}

package/dist/readiness.d.ts

@@ -0,0 +1,39 @@
+import * as v from 'valibot';
+export type ReadinessStatus = 'ok' | 'degraded' | 'error' | 'skipped';
+export type ReadinessCode = 'unreachable' | 'not_provisioned' | 'backlog';
+export type ReadinessCheckName = 'database' | 'schema' | 'background';
+export type ReadinessCheck = {
+    name: ReadinessCheckName;
+    status: ReadinessStatus;
+    code?: ReadinessCode;
+    overdue?: number;
+};
+export type ReadinessReport = {
+    status: 'ok' | 'degraded' | 'error';
+    revision?: string;
+    checks: ReadinessCheck[];
+};
+export type ReadinessProbes = {
+    /** Deployed commit, when the platform injects `WORKERSTACK_REVISION`. */
+    revision?: string;
+    queueJobsDeclared: boolean;
+    probeDatabase: () => Promise<void>;
+    countOverdueJobs: () => Promise<number>;
+};
+export declare const readinessReportSchema: v.StrictObjectSchema<{
+    readonly status: v.PicklistSchema<["ok", "degraded", "error"], undefined>;
+    readonly revision: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly checks: v.ArraySchema<v.StrictObjectSchema<{
+        readonly name: v.PicklistSchema<["database", "schema", "background"], undefined>;
+        readonly status: v.PicklistSchema<["ok", "degraded", "error", "skipped"], undefined>;
+        readonly code: v.OptionalSchema<v.PicklistSchema<["unreachable", "not_provisioned", "backlog"], undefined>, undefined>;
+        readonly overdue: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+/**
+ * A query that fails this way reached the database and found no schema.
+ * Drizzle wraps the driver error, so the relation name lives on `cause`.
+ */
+export declare function isMissingRelationError(error: unknown): boolean;
+export declare function buildReadinessReport(probes: ReadinessProbes): Promise<ReadinessReport>;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;AACrE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAAA;AACzE,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAA;AAErE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,CAAA;IACxB,MAAM,EAAE,eAAe,CAAA;IACvB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACxC,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;aAahC,CAAA;AAKF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAa9D;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAgD1B"}

package/dist/readiness.js

@@ -0,0 +1,72 @@
+// src/readiness.ts — machine-readable "did this release come up" report.
+// Public endpoint: results carry a closed set of codes and never a driver
+// message, a connection string, or a stack trace.
+import * as v from 'valibot';
+export const readinessReportSchema = v.strictObject({
+    status: v.picklist(['ok', 'degraded', 'error']),
+    revision: v.optional(v.string()),
+    checks: v.array(v.strictObject({
+        name: v.picklist(['database', 'schema', 'background']),
+        status: v.picklist(['ok', 'degraded', 'error', 'skipped']),
+        code: v.optional(v.picklist(['unreachable', 'not_provisioned', 'backlog'])),
+        overdue: v.optional(v.number()),
+    })),
+});
+const MISSING_RELATION = /no such table|does not exist|undefined table|unknown table/i;
+/**
+ * A query that fails this way reached the database and found no schema.
+ * Drizzle wraps the driver error, so the relation name lives on `cause`.
+ */
+export function isMissingRelationError(error) {
+    let current = error;
+    for (let depth = 0; current !== undefined && current !== null && depth < 8; depth += 1) {
+        const message = current instanceof Error ? current.message : String(current);
+        if (MISSING_RELATION.test(message))
+            return true;
+        if (!(current instanceof Error))
+            return false;
+        current = current.cause;
+    }
+    return false;
+}
+export async function buildReadinessReport(probes) {
+    const checks = [];
+    let queryable = false;
+    try {
+        await probes.probeDatabase();
+        checks.push({ name: 'database', status: 'ok' }, { name: 'schema', status: 'ok' });
+        queryable = true;
+    }
+    catch (error) {
+        checks.push(isMissingRelationError(error)
+            ? { name: 'database', status: 'ok' }
+            : { name: 'database', status: 'error', code: 'unreachable' }, isMissingRelationError(error)
+            ? { name: 'schema', status: 'error', code: 'not_provisioned' }
+            : { name: 'schema', status: 'skipped' });
+    }
+    if (!queryable || !probes.queueJobsDeclared) {
+        checks.push({ name: 'background', status: 'skipped' });
+    }
+    else {
+        try {
+            const overdue = await probes.countOverdueJobs();
+            checks.push(overdue > 0
+                ? { name: 'background', status: 'degraded', code: 'backlog', overdue }
+                : { name: 'background', status: 'ok' });
+        }
+        catch {
+            checks.push({ name: 'background', status: 'skipped' });
+        }
+    }
+    const status = checks.some((check) => check.status === 'error')
+        ? 'error'
+        : checks.some((check) => check.status === 'degraded')
+            ? 'degraded'
+            : 'ok';
+    return {
+        status,
+        ...(probes.revision === undefined ? {} : { revision: probes.revision }),
+        checks,
+    };
+}
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"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","sourcesContent":["// src/readiness.ts — machine-readable \"did this release come up\" report.\n// Public endpoint: results carry a closed set of codes and never a driver\n// message, a connection string, or a stack trace.\nimport * as v from 'valibot'\n\nexport type ReadinessStatus = 'ok' | 'degraded' | 'error' | 'skipped'\nexport type ReadinessCode = 'unreachable' | 'not_provisioned' | 'backlog'\nexport type ReadinessCheckName = 'database' | 'schema' | 'background'\n\nexport type ReadinessCheck = {\n  name: ReadinessCheckName\n  status: ReadinessStatus\n  code?: ReadinessCode\n  overdue?: number\n}\n\nexport type ReadinessReport = {\n  status: 'ok' | 'degraded' | 'error'\n  revision?: string\n  checks: ReadinessCheck[]\n}\n\nexport type ReadinessProbes = {\n  /** Deployed commit, when the platform injects `WORKERSTACK_REVISION`. */\n  revision?: string\n  queueJobsDeclared: boolean\n  probeDatabase: () => Promise<void>\n  countOverdueJobs: () => Promise<number>\n}\n\nexport const readinessReportSchema = v.strictObject({\n  status: v.picklist(['ok', 'degraded', 'error']),\n  revision: v.optional(v.string()),\n  checks: v.array(\n    v.strictObject({\n      name: v.picklist(['database', 'schema', 'background']),\n      status: v.picklist(['ok', 'degraded', 'error', 'skipped']),\n      code: v.optional(\n        v.picklist(['unreachable', 'not_provisioned', 'backlog']),\n      ),\n      overdue: v.optional(v.number()),\n    }),\n  ),\n})\n\nconst MISSING_RELATION =\n  /no such table|does not exist|undefined table|unknown table/i\n\n/**\n * A query that fails this way reached the database and found no schema.\n * Drizzle wraps the driver error, so the relation name lives on `cause`.\n */\nexport function isMissingRelationError(error: unknown): boolean {\n  let current: unknown = error\n  for (\n    let depth = 0;\n    current !== undefined && current !== null && depth < 8;\n    depth += 1\n  ) {\n    const message = current instanceof Error ? current.message : String(current)\n    if (MISSING_RELATION.test(message)) return true\n    if (!(current instanceof Error)) return false\n    current = current.cause\n  }\n  return false\n}\n\nexport async function buildReadinessReport(\n  probes: ReadinessProbes,\n): Promise<ReadinessReport> {\n  const checks: ReadinessCheck[] = []\n  let queryable = false\n\n  try {\n    await probes.probeDatabase()\n    checks.push(\n      { name: 'database', status: 'ok' },\n      { name: 'schema', status: 'ok' },\n    )\n    queryable = true\n  } catch (error) {\n    checks.push(\n      isMissingRelationError(error)\n        ? { name: 'database', status: 'ok' }\n        : { name: 'database', status: 'error', code: 'unreachable' },\n      isMissingRelationError(error)\n        ? { name: 'schema', status: 'error', code: 'not_provisioned' }\n        : { name: 'schema', status: 'skipped' },\n    )\n  }\n\n  if (!queryable || !probes.queueJobsDeclared) {\n    checks.push({ name: 'background', status: 'skipped' })\n  } else {\n    try {\n      const overdue = await probes.countOverdueJobs()\n      checks.push(\n        overdue > 0\n          ? { name: 'background', status: 'degraded', code: 'backlog', overdue }\n          : { name: 'background', status: 'ok' },\n      )\n    } catch {\n      checks.push({ name: 'background', status: 'skipped' })\n    }\n  }\n\n  const status = checks.some((check) => check.status === 'error')\n    ? 'error'\n    : checks.some((check) => check.status === 'degraded')\n      ? 'degraded'\n      : 'ok'\n\n  return {\n    status,\n    ...(probes.revision === undefined ? {} : { revision: probes.revision }),\n    checks,\n  }\n}\n"]}

package/dist/realtime/facade.d.ts

@@ -0,0 +1,20 @@
+import { type InferSelectModel, type Table } from 'drizzle-orm';
+import type { RealtimeAction, RealtimePublisher } from './publisher.js';
+export type RealtimeTransport = 'disabled' | 'memory' | 'platform';
+export type SchemaTable<TSchema extends Record<string, unknown>> = Extract<TSchema[keyof TSchema], Table>;
+export interface RealtimeFacade<TSchema extends Record<string, unknown> = Record<string, unknown>> {
+    readonly enabled: boolean;
+    readonly transport: RealtimeTransport;
+    publish<TTable extends SchemaTable<TSchema>>(table: TTable, action: RealtimeAction, record: InferSelectModel<TTable>, metadata?: {
+        operationId?: string;
+    }): Promise<void>;
+}
+/**
+ * One name for a table everywhere: events, subscriptions, and the CRUD router
+ * all use the schema key. Pass the schema so a key like `creditBalances` is not
+ * published as its SQL name `credit_balances` — clients subscribe with the key
+ * they call procedures with. Without a schema, the SQL name is the only name
+ * available and is used as-is.
+ */
+export declare function createRealtimeFacade<TSchema extends Record<string, unknown>>(publisher?: RealtimePublisher, transport?: RealtimeTransport, schema?: TSchema): RealtimeFacade<TSchema>;
+//# sourceMappingURL=facade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../../src/realtime/facade.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACX,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAA;AAElE,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,OAAO,CACxE,OAAO,CAAC,MAAM,OAAO,CAAC,EACtB,KAAK,CACN,CAAA;AAED,MAAM,WAAW,cAAc,CAC7B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IAErC,OAAO,CAAC,MAAM,SAAS,WAAW,CAAC,OAAO,CAAC,EACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAChC,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,SAAS,CAAC,EAAE,iBAAiB,EAC7B,SAAS,GAAE,iBAAqD,EAChE,MAAM,CAAC,EAAE,OAAO,GACf,cAAc,CAAC,OAAO,CAAC,CA+BzB"}

package/dist/realtime/facade.js

@@ -0,0 +1,37 @@
+import { getTableName, isTable, } from 'drizzle-orm';
+/**
+ * One name for a table everywhere: events, subscriptions, and the CRUD router
+ * all use the schema key. Pass the schema so a key like `creditBalances` is not
+ * published as its SQL name `credit_balances` — clients subscribe with the key
+ * they call procedures with. Without a schema, the SQL name is the only name
+ * available and is used as-is.
+ */
+export function createRealtimeFacade(publisher, transport = publisher ? 'memory' : 'disabled', schema) {
+    if (!publisher && transport !== 'disabled') {
+        throw new Error('[workerstack] an enabled realtime transport requires a publisher');
+    }
+    if (publisher && transport === 'disabled') {
+        throw new Error('[workerstack] a realtime publisher cannot use the disabled transport');
+    }
+    const keyByTableName = new Map();
+    for (const [key, value] of Object.entries(schema ?? {})) {
+        if (isTable(value))
+            keyByTableName.set(getTableName(value), key);
+    }
+    return {
+        enabled: publisher !== undefined,
+        transport,
+        async publish(table, action, record, metadata) {
+            if (!publisher)
+                return;
+            const tableName = getTableName(table);
+            await publisher.publish('change', {
+                table: keyByTableName.get(tableName) ?? tableName,
+                action,
+                record: record,
+                ...(metadata?.operationId ? { operationId: metadata.operationId } : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=facade.js.map

package/dist/realtime/facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.js","sourceRoot":"","sources":["../../src/realtime/facade.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,OAAO,GAGR,MAAM,aAAa,CAAA;AAyBpB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA6B,EAC7B,YAA+B,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,EAChE,MAAgB;IAEhB,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAA;IACH,CAAC;IACD,IAAI,SAAS,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAA;IACH,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAA;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;IAClE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,SAAS,KAAK,SAAS;QAChC,SAAS;QACT,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;YAC3C,IAAI,CAAC,SAAS;gBAAE,OAAM;YACtB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;YACrC,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAChC,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS;gBACjD,MAAM;gBACN,MAAM,EAAE,MAA4C;gBACpD,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxE,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import {\n  getTableName,\n  isTable,\n  type InferSelectModel,\n  type Table,\n} from 'drizzle-orm'\n\nimport type { RealtimeAction, RealtimePublisher } from './publisher'\n\nexport type RealtimeTransport = 'disabled' | 'memory' | 'platform'\n\nexport type SchemaTable<TSchema extends Record<string, unknown>> = Extract<\n  TSchema[keyof TSchema],\n  Table\n>\n\nexport interface RealtimeFacade<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly enabled: boolean\n  readonly transport: RealtimeTransport\n\n  publish<TTable extends SchemaTable<TSchema>>(\n    table: TTable,\n    action: RealtimeAction,\n    record: InferSelectModel<TTable>,\n    metadata?: { operationId?: string },\n  ): Promise<void>\n}\n\n/**\n * One name for a table everywhere: events, subscriptions, and the CRUD router\n * all use the schema key. Pass the schema so a key like `creditBalances` is not\n * published as its SQL name `credit_balances` — clients subscribe with the key\n * they call procedures with. Without a schema, the SQL name is the only name\n * available and is used as-is.\n */\nexport function createRealtimeFacade<TSchema extends Record<string, unknown>>(\n  publisher?: RealtimePublisher,\n  transport: RealtimeTransport = publisher ? 'memory' : 'disabled',\n  schema?: TSchema,\n): RealtimeFacade<TSchema> {\n  if (!publisher && transport !== 'disabled') {\n    throw new Error(\n      '[workerstack] an enabled realtime transport requires a publisher',\n    )\n  }\n  if (publisher && transport === 'disabled') {\n    throw new Error(\n      '[workerstack] a realtime publisher cannot use the disabled transport',\n    )\n  }\n\n  const keyByTableName = new Map<string, string>()\n  for (const [key, value] of Object.entries(schema ?? {})) {\n    if (isTable(value)) keyByTableName.set(getTableName(value), key)\n  }\n\n  return {\n    enabled: publisher !== undefined,\n    transport,\n    async publish(table, action, record, metadata) {\n      if (!publisher) return\n      const tableName = getTableName(table)\n      await publisher.publish('change', {\n        table: keyByTableName.get(tableName) ?? tableName,\n        action,\n        record: record as unknown as Record<string, unknown>,\n        ...(metadata?.operationId ? { operationId: metadata.operationId } : {}),\n      })\n    },\n  }\n}\n"]}