workerstack 0.1.0-beta.0

package/dist/api/list-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-spec.js","sourceRoot":"","sources":["../../src/api/list-spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK3D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAY1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAa,EACb,UAA2B,EAAE;IAE7B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACzE,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAEhE,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,EAAE;QAC9C,iBAAiB,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QAC3C,eAAe;KAChB,CAGA,CAAA;IAED,0EAA0E;IAC1E,4EAA4E;IAC5E,wDAAwD;IACxD,MAAM,MAAM,GAAG;QACb,iBAAiB,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QAC3C,eAAe;QACf,iBAAiB,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QAC3C,WAAW;KACsB,CAAA;IAEnC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,4DAA4D,YAAY,CAAC,KAAK,CAAC,GAAG,CACnF,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,EAAE,cAGtB,EAA+C,EAAE;QAChD,MAAM,MAAM,GAAG,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,CAAA;QACpE,OAAO,WAAW,CAChB,cAAc,CAAC,OAAO,CAAC,EAAW,EAClC,KAAc,EACd,MAAM,EACN,MAAM,EACN,QAAQ,CACT,CAAA;IACH,CAAC,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAA;AACxC,CAAC","sourcesContent":["import type { Table } from 'drizzle-orm'\nimport type * as v from 'valibot'\n\nimport { getTableColumns, getTableName } from 'drizzle-orm'\n\nimport type { ResolvedTableAccess } from '../access'\nimport type { ListParamsInput, ListResult } from '../list-query'\n\nimport { executeList, resolveListParams } from '../list-query'\nimport { buildListInputSchema } from './list-input-schema'\n\nexport type ListSpecOptions = {\n  /** Columns a caller may filter on. Others are rejected by the schema. */\n  filterable?: readonly string[]\n  /** Columns a caller may sort on. Defaults to the default sort column. */\n  sortable?: readonly string[]\n  defaultSort?: { column: string; order: 'asc' | 'desc' }\n  /** Columns the `q` parameter searches. */\n  searchable?: readonly string[]\n}\n\n/**\n * The input schema and handler of a list endpoint, with the same filter, sort,\n * cursor, and count contract that the generated CRUD list uses.\n *\n * The caller applies both to its own base procedure:\n *\n * ```ts\n * const logsList = listSpec(appLogs, { filterable: ['level'] })\n * getLogs: adminProcedure.input(logsList.input).handler(logsList.handler)\n * ```\n *\n * The two parts are returned separately rather than as a finished procedure,\n * because a procedure built here would have to receive the builder as a\n * generic parameter. TypeScript resolves a method call on a generic parameter\n * through its constraint, which erases the input schema and the row type. With\n * this shape the builder stays concrete at the call site and keeps both.\n *\n * It reads no `access` configuration: the base procedure carries the policy.\n */\nexport function listSpec<TTable extends Table>(\n  table: TTable,\n  options: ListSpecOptions = {},\n) {\n  const defaultSort = options.defaultSort ?? { column: 'id', order: 'asc' }\n  const sortableColumns = options.sortable ?? [defaultSort.column]\n\n  const inputSchema = buildListInputSchema(table, {\n    filterableColumns: options.filterable ?? [],\n    sortableColumns,\n  }) as unknown as v.GenericSchema<\n    ListParamsInput | undefined,\n    ListParamsInput | undefined\n  >\n\n  // `executeList` reads its policy from a resolved access record. This spec\n  // declares that policy at the call site instead, because the base procedure\n  // — not `access.ts` — carries the authorization for it.\n  const access = {\n    filterableColumns: options.filterable ?? [],\n    sortableColumns,\n    searchableColumns: options.searchable ?? [],\n    defaultSort,\n  } as unknown as ResolvedTableAccess\n\n  const idColumn = getTableColumns(table).id\n  if (!idColumn) {\n    throw new Error(\n      `[workerstack] listSpec requires an \"id\" column on table \"${getTableName(table)}\"`,\n    )\n  }\n\n  const handler = async (handlerOptions: {\n    context: { db: unknown }\n    input: ListParamsInput | undefined\n  }): Promise<ListResult<TTable['$inferSelect']>> => {\n    const params = resolveListParams(handlerOptions.input ?? {}, access)\n    return executeList<TTable['$inferSelect']>(\n      handlerOptions.context.db as never,\n      table as never,\n      access,\n      params,\n      idColumn,\n    )\n  }\n\n  return { input: inputSchema, handler }\n}\n"]}

package/dist/api/live-view.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Server-side membership for a live view: does one record belong to a view,
+ * given that view's filters?
+ *
+ * The rule is evaluated per streamed record, so a change is routed to the
+ * views that want it without asking the database.
+ */
+/**
+ * Workerstack's filter contract — a scalar is `=`, an array is `IN`, `null` is
+ * `IS NULL` — evaluated against one record. The string `'null'` means the same
+ * as `null`, because a query string cannot carry a real null.
+ */
+export declare function matchesLiveFilters(record: Record<string, unknown>, filters: Record<string, unknown> | undefined): boolean;
+//# sourceMappingURL=live-view.d.ts.map

package/dist/api/live-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-view.d.ts","sourceRoot":"","sources":["../../src/api/live-view.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,OAAO,CAeT"}

package/dist/api/live-view.js

@@ -0,0 +1,42 @@
+/**
+ * Server-side membership for a live view: does one record belong to a view,
+ * given that view's filters?
+ *
+ * The rule is evaluated per streamed record, so a change is routed to the
+ * views that want it without asking the database.
+ */
+/** Same value semantics as list filters: dates by time, the rest by identity. */
+function sameValue(a, b) {
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    return a === b;
+}
+function isNullish(value) {
+    return value === null || value === undefined;
+}
+/**
+ * Workerstack's filter contract — a scalar is `=`, an array is `IN`, `null` is
+ * `IS NULL` — evaluated against one record. The string `'null'` means the same
+ * as `null`, because a query string cannot carry a real null.
+ */
+export function matchesLiveFilters(record, filters) {
+    for (const [column, expected] of Object.entries(filters ?? {})) {
+        if (expected === undefined)
+            continue;
+        const actual = record[column];
+        if (expected === null || expected === 'null') {
+            if (!isNullish(actual))
+                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;
+}
+//# sourceMappingURL=live-view.js.map

package/dist/api/live-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-view.js","sourceRoot":"","sources":["../../src/api/live-view.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iFAAiF;AACjF,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,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAA;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,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,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC7C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAA;YACpC,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","sourcesContent":["/**\n * Server-side membership for a live view: does one record belong to a view,\n * given that view's filters?\n *\n * The rule is evaluated per streamed record, so a change is routed to the\n * views that want it without asking the database.\n */\n\n/** Same value semantics as list filters: dates by time, the rest by identity. */\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\nfunction isNullish(value: unknown): boolean {\n  return value === null || value === undefined\n}\n\n/**\n * Workerstack's filter contract — a scalar is `=`, an array is `IN`, `null` is\n * `IS NULL` — evaluated against one record. The string `'null'` means the same\n * as `null`, because a query string cannot carry a real null.\n */\nexport function matchesLiveFilters(\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 || expected === 'null') {\n      if (!isNullish(actual)) 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"]}

package/dist/api/live-window.d.ts

@@ -0,0 +1,40 @@
+import type { LiveDeltaFrame } from '../live/protocol.js';
+import type { RealtimeChange } from '../realtime/publisher.js';
+/**
+ * The server-side state of one live-view connection: which rows the client
+ * holds, in view order, and whether rows exist below the window.
+ *
+ * The window is what lets the server place a row for the client (`afterId`)
+ * instead of making the browser repeat `ORDER BY`. It is also what makes a
+ * removal from a truncated view ask for a fresh snapshot instead of silently
+ * shrinking the view.
+ *
+ * Ordering follows `buildOrderBy` in `../list-query`: the sort column first,
+ * then `id`, both in the query's direction. Values are compared in the process
+ * on raw column values. That is exact for numbers, dates, and booleans, and
+ * matches the database for ordinary text. A collation that differs from
+ * code-unit order, or a NULLS rule other than "nulls first", can place a row
+ * inside the window differently from the database.
+ */
+export type LiveWindowOptions = {
+    sort: string;
+    order: 'asc' | 'desc';
+    limit: number;
+    filters?: Record<string, unknown>;
+};
+export type LiveWindowResult = {
+    type: 'none';
+} | {
+    type: 'frames';
+    frames: LiveDeltaFrame[];
+} | {
+    type: 'resnapshot';
+};
+export type LiveWindow = {
+    /** Adopt a query result as the current view. */
+    reset: (items: Record<string, unknown>[], hasMore: boolean) => void;
+    /** What this change means for this view. */
+    apply: (change: RealtimeChange) => LiveWindowResult;
+};
+export declare function createLiveWindow(options: LiveWindowOptions): LiveWindow;
+//# sourceMappingURL=live-window.d.ts.map

package/dist/api/live-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-window.d.ts","sourceRoot":"","sources":["../../src/api/live-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAI3D;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAA;AAE1B,MAAM,MAAM,UAAU,GAAG;IACvB,gDAAgD;IAChD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACnE,4CAA4C;IAC5C,KAAK,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,gBAAgB,CAAA;CACpD,CAAA;AAmBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAgFvE"}

package/dist/api/live-window.js

@@ -0,0 +1,93 @@
+import { matchesLiveFilters } from './live-view.js';
+function compareValues(a, b) {
+    if (a === b)
+        return 0;
+    const aNull = a === null || a === undefined;
+    const bNull = b === null || b === undefined;
+    if (aNull || bNull)
+        return aNull ? (bNull ? 0 : -1) : 1;
+    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);
+    }
+    const left = String(a);
+    const right = String(b);
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+export function createLiveWindow(options) {
+    const direction = options.order === 'desc' ? -1 : 1;
+    let rows = [];
+    let hasMore = false;
+    const compareRows = (a, b) => direction * (compareValues(a.key, b.key) || compareValues(a.id, b.id));
+    const rowOf = (record) => ({
+        id: String(record.id),
+        key: record[options.sort],
+    });
+    /** Where this row belongs among rows that are already in order. */
+    const placeOf = (row) => {
+        const index = rows.findIndex((current) => compareRows(row, current) < 0);
+        return index === -1 ? rows.length : index;
+    };
+    return {
+        reset(items, nextHasMore) {
+            rows = items.map(rowOf);
+            hasMore = nextHasMore;
+        },
+        apply(change) {
+            const id = String(change.record.id);
+            const metadata = change.operationId
+                ? { operationId: change.operationId }
+                : {};
+            const index = rows.findIndex((row) => row.id === id);
+            const held = index !== -1;
+            // The row left the view: deleted, or no longer a match for the filters.
+            if (change.action === 'delete' ||
+                !matchesLiveFilters(change.record, options.filters)) {
+                if (!held)
+                    return { type: 'none' };
+                rows.splice(index, 1);
+                // A row from below the window must take the free place, and only the
+                // database knows which one.
+                if (hasMore)
+                    return { type: 'resnapshot' };
+                return {
+                    type: 'frames',
+                    frames: [{ type: 'remove', id, ...metadata }],
+                };
+            }
+            if (held)
+                rows.splice(index, 1);
+            const row = rowOf(change.record);
+            const place = placeOf(row);
+            if (place >= options.limit) {
+                // It sorts below the window. If the client holds it, it moved out.
+                if (!held)
+                    return { type: 'none' };
+                hasMore = true;
+                return {
+                    type: 'frames',
+                    frames: [{ type: 'remove', id, ...metadata }],
+                };
+            }
+            rows.splice(place, 0, row);
+            const frames = [
+                {
+                    type: 'upsert',
+                    record: change.record,
+                    afterId: place === 0 ? null : rows[place - 1].id,
+                    ...metadata,
+                },
+            ];
+            if (rows.length > options.limit) {
+                const evicted = rows.pop();
+                hasMore = true;
+                frames.push({ type: 'remove', id: evicted.id, ...metadata });
+            }
+            return { type: 'frames', frames };
+        },
+    };
+}
+//# sourceMappingURL=live-window.js.map

package/dist/api/live-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-window.js","sourceRoot":"","sources":["../../src/api/live-window.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LiveDeltaFrame } from '../live/protocol'\nimport type { RealtimeChange } from '../realtime/publisher'\n\nimport { matchesLiveFilters } from './live-view'\n\n/**\n * The server-side state of one live-view connection: which rows the client\n * holds, in view order, and whether rows exist below the window.\n *\n * The window is what lets the server place a row for the client (`afterId`)\n * instead of making the browser repeat `ORDER BY`. It is also what makes a\n * removal from a truncated view ask for a fresh snapshot instead of silently\n * shrinking the view.\n *\n * Ordering follows `buildOrderBy` in `../list-query`: the sort column first,\n * then `id`, both in the query's direction. Values are compared in the process\n * on raw column values. That is exact for numbers, dates, and booleans, and\n * matches the database for ordinary text. A collation that differs from\n * code-unit order, or a NULLS rule other than \"nulls first\", can place a row\n * inside the window differently from the database.\n */\n\nexport type LiveWindowOptions = {\n  sort: string\n  order: 'asc' | 'desc'\n  limit: number\n  filters?: Record<string, unknown>\n}\n\nexport type LiveWindowResult =\n  | { type: 'none' }\n  | { type: 'frames'; frames: LiveDeltaFrame[] }\n  | { type: 'resnapshot' }\n\nexport type LiveWindow = {\n  /** Adopt a query result as the current view. */\n  reset: (items: Record<string, unknown>[], hasMore: boolean) => void\n  /** What this change means for this view. */\n  apply: (change: RealtimeChange) => LiveWindowResult\n}\n\ntype WindowRow = { id: string; key: unknown }\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a === b) return 0\n  const aNull = a === null || a === undefined\n  const bNull = b === null || b === undefined\n  if (aNull || bNull) return aNull ? (bNull ? 0 : -1) : 1\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  }\n  const left = String(a)\n  const right = String(b)\n  return left < right ? -1 : left > right ? 1 : 0\n}\n\nexport function createLiveWindow(options: LiveWindowOptions): LiveWindow {\n  const direction = options.order === 'desc' ? -1 : 1\n  let rows: WindowRow[] = []\n  let hasMore = false\n\n  const compareRows = (a: WindowRow, b: WindowRow): number =>\n    direction * (compareValues(a.key, b.key) || compareValues(a.id, b.id))\n\n  const rowOf = (record: Record<string, unknown>): WindowRow => ({\n    id: String(record.id),\n    key: record[options.sort],\n  })\n\n  /** Where this row belongs among rows that are already in order. */\n  const placeOf = (row: WindowRow): number => {\n    const index = rows.findIndex((current) => compareRows(row, current) < 0)\n    return index === -1 ? rows.length : index\n  }\n\n  return {\n    reset(items, nextHasMore) {\n      rows = items.map(rowOf)\n      hasMore = nextHasMore\n    },\n\n    apply(change) {\n      const id = String(change.record.id)\n      const metadata = change.operationId\n        ? { operationId: change.operationId }\n        : {}\n      const index = rows.findIndex((row) => row.id === id)\n      const held = index !== -1\n\n      // The row left the view: deleted, or no longer a match for the filters.\n      if (\n        change.action === 'delete' ||\n        !matchesLiveFilters(change.record, options.filters)\n      ) {\n        if (!held) return { type: 'none' }\n        rows.splice(index, 1)\n        // A row from below the window must take the free place, and only the\n        // database knows which one.\n        if (hasMore) return { type: 'resnapshot' }\n        return {\n          type: 'frames',\n          frames: [{ type: 'remove', id, ...metadata }],\n        }\n      }\n\n      if (held) rows.splice(index, 1)\n      const row = rowOf(change.record)\n      const place = placeOf(row)\n\n      if (place >= options.limit) {\n        // It sorts below the window. If the client holds it, it moved out.\n        if (!held) return { type: 'none' }\n        hasMore = true\n        return {\n          type: 'frames',\n          frames: [{ type: 'remove', id, ...metadata }],\n        }\n      }\n\n      rows.splice(place, 0, row)\n      const frames: LiveDeltaFrame[] = [\n        {\n          type: 'upsert',\n          record: change.record,\n          afterId: place === 0 ? null : rows[place - 1]!.id,\n          ...metadata,\n        },\n      ]\n      if (rows.length > options.limit) {\n        const evicted = rows.pop()!\n        hasMore = true\n        frames.push({ type: 'remove', id: evicted.id, ...metadata })\n      }\n      return { type: 'frames', frames }\n    },\n  }\n}\n"]}

package/dist/api/openapi.d.ts

@@ -0,0 +1,6 @@
+export interface MergeOpenAPISpecsOptions {
+    nativeSpec: Record<string, any>;
+    authSpec?: Record<string, any>;
+}
+export declare function mergeOpenAPISpecs(options: MergeOpenAPISpecsOptions): Record<string, any>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/api/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/api/openapi.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC/B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAsKrB"}

package/dist/api/openapi.js

@@ -0,0 +1,146 @@
+const HTTP_METHODS = new Set([
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+    'HEAD',
+    'OPTIONS',
+]);
+export function mergeOpenAPISpecs(options) {
+    const { nativeSpec, authSpec } = options;
+    const merged = {
+        openapi: nativeSpec.openapi || authSpec?.openapi || '3.1.0',
+        info: {
+            title: 'Workerstack API',
+            version: '1.0.0',
+            ...nativeSpec.info,
+        },
+        paths: JSON.parse(JSON.stringify(nativeSpec.paths || {})),
+        components: {},
+        security: [...(nativeSpec.security || [])],
+        tags: [...(nativeSpec.tags || [])],
+    };
+    if (authSpec) {
+        // Merge paths and check for overwrite collisions
+        if (authSpec.paths && typeof authSpec.paths === 'object') {
+            for (const [routePath, authPathItem] of Object.entries(authSpec.paths)) {
+                if (!authPathItem || typeof authPathItem !== 'object')
+                    continue;
+                const clonedPathItem = JSON.parse(JSON.stringify(authPathItem));
+                // Normalize tags for Better Auth operations (replace generic "Default" with "Auth")
+                if (routePath.startsWith('/api/auth')) {
+                    for (const [methodKey, operation] of Object.entries(clonedPathItem)) {
+                        if (HTTP_METHODS.has(methodKey.toUpperCase()) &&
+                            operation &&
+                            typeof operation === 'object') {
+                            if (Array.isArray(operation.tags)) {
+                                operation.tags = operation.tags.map((t) => t === 'Default' ? 'Auth' : t);
+                                if (!operation.tags.includes('Auth')) {
+                                    operation.tags.unshift('Auth');
+                                }
+                            }
+                            else {
+                                operation.tags = ['Auth'];
+                            }
+                        }
+                    }
+                }
+                if (!(routePath in merged.paths)) {
+                    merged.paths[routePath] = clonedPathItem;
+                }
+                else {
+                    const existingPathItem = merged.paths[routePath];
+                    const incomingPathItem = clonedPathItem;
+                    for (const [key, authVal] of Object.entries(incomingPathItem)) {
+                        const upperKey = key.toUpperCase();
+                        const isOperation = HTTP_METHODS.has(upperKey);
+                        if (key in existingPathItem) {
+                            const existingVal = existingPathItem[key];
+                            if (JSON.stringify(existingVal) !== JSON.stringify(authVal)) {
+                                if (isOperation) {
+                                    throw new Error(`[workerstack] OpenAPI path overwrite collision: operation "${upperKey} ${routePath}"`);
+                                }
+                                else {
+                                    throw new Error(`[workerstack] OpenAPI path property collision on "${routePath}": key "${key}"`);
+                                }
+                            }
+                        }
+                        else {
+                            existingPathItem[key] = JSON.parse(JSON.stringify(authVal));
+                        }
+                    }
+                }
+            }
+        }
+        // Merge security metadata
+        if (Array.isArray(authSpec.security)) {
+            for (const sec of authSpec.security) {
+                if (!merged.security.some((s) => JSON.stringify(s) === JSON.stringify(sec))) {
+                    merged.security.push(sec);
+                }
+            }
+        }
+        // Merge tags
+        if (!merged.tags.some((t) => t.name === 'Auth')) {
+            merged.tags.push({
+                name: 'Auth',
+                description: 'Authentication and session management',
+            });
+        }
+        if (Array.isArray(authSpec.tags)) {
+            for (const tag of authSpec.tags) {
+                if (tag.name !== 'Default' &&
+                    !merged.tags.some((t) => t.name === tag.name)) {
+                    merged.tags.push(tag);
+                }
+            }
+        }
+    }
+    // Merge components by category
+    const categories = new Set([
+        ...Object.keys(nativeSpec.components || {}),
+        ...Object.keys(authSpec?.components || {}),
+    ]);
+    for (const category of categories) {
+        const nativeCat = nativeSpec.components?.[category] || {};
+        const authCat = authSpec?.components?.[category] || {};
+        const mergedCat = { ...nativeCat };
+        for (const [key, authVal] of Object.entries(authCat)) {
+            if (key in nativeCat) {
+                const nativeVal = nativeCat[key];
+                if (JSON.stringify(nativeVal) !== JSON.stringify(authVal)) {
+                    throw new Error(`[workerstack] OpenAPI component collision: category "${category}" component "${key}"`);
+                }
+            }
+            else {
+                mergedCat[key] = authVal;
+            }
+        }
+        merged.components[category] = mergedCat;
+    }
+    // Ensure all tags used in path operations are declared in merged.tags
+    for (const pathItem of Object.values(merged.paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const [key, op] of Object.entries(pathItem)) {
+            if (HTTP_METHODS.has(key.toUpperCase()) &&
+                op &&
+                typeof op === 'object' &&
+                Array.isArray(op.tags)) {
+                for (const tagName of op.tags) {
+                    if (tagName &&
+                        tagName !== 'Default' &&
+                        !merged.tags.some((t) => t.name === tagName)) {
+                        merged.tags.push({
+                            name: tagName,
+                            description: `${tagName} operations`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/api/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/api/openapi.ts"],"names":[],"mappings":"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","sourcesContent":["const HTTP_METHODS = new Set([\n  'GET',\n  'POST',\n  'PUT',\n  'PATCH',\n  'DELETE',\n  'HEAD',\n  'OPTIONS',\n])\n\nexport interface MergeOpenAPISpecsOptions {\n  nativeSpec: Record<string, any>\n  authSpec?: Record<string, any>\n}\n\nexport function mergeOpenAPISpecs(\n  options: MergeOpenAPISpecsOptions,\n): Record<string, any> {\n  const { nativeSpec, authSpec } = options\n\n  const merged: Record<string, any> = {\n    openapi: nativeSpec.openapi || authSpec?.openapi || '3.1.0',\n    info: {\n      title: 'Workerstack API',\n      version: '1.0.0',\n      ...nativeSpec.info,\n    },\n    paths: JSON.parse(JSON.stringify(nativeSpec.paths || {})),\n    components: {},\n    security: [...(nativeSpec.security || [])],\n    tags: [...(nativeSpec.tags || [])],\n  }\n\n  if (authSpec) {\n    // Merge paths and check for overwrite collisions\n    if (authSpec.paths && typeof authSpec.paths === 'object') {\n      for (const [routePath, authPathItem] of Object.entries(authSpec.paths)) {\n        if (!authPathItem || typeof authPathItem !== 'object') continue\n\n        const clonedPathItem = JSON.parse(\n          JSON.stringify(authPathItem),\n        ) as Record<string, any>\n\n        // Normalize tags for Better Auth operations (replace generic \"Default\" with \"Auth\")\n        if (routePath.startsWith('/api/auth')) {\n          for (const [methodKey, operation] of Object.entries(clonedPathItem)) {\n            if (\n              HTTP_METHODS.has(methodKey.toUpperCase()) &&\n              operation &&\n              typeof operation === 'object'\n            ) {\n              if (Array.isArray(operation.tags)) {\n                operation.tags = operation.tags.map((t: string) =>\n                  t === 'Default' ? 'Auth' : t,\n                )\n                if (!operation.tags.includes('Auth')) {\n                  operation.tags.unshift('Auth')\n                }\n              } else {\n                operation.tags = ['Auth']\n              }\n            }\n          }\n        }\n\n        if (!(routePath in merged.paths)) {\n          merged.paths[routePath] = clonedPathItem\n        } else {\n          const existingPathItem = merged.paths[routePath]\n          const incomingPathItem = clonedPathItem\n\n          for (const [key, authVal] of Object.entries(incomingPathItem)) {\n            const upperKey = key.toUpperCase()\n            const isOperation = HTTP_METHODS.has(upperKey)\n\n            if (key in existingPathItem) {\n              const existingVal = existingPathItem[key]\n              if (JSON.stringify(existingVal) !== JSON.stringify(authVal)) {\n                if (isOperation) {\n                  throw new Error(\n                    `[workerstack] OpenAPI path overwrite collision: operation \"${upperKey} ${routePath}\"`,\n                  )\n                } else {\n                  throw new Error(\n                    `[workerstack] OpenAPI path property collision on \"${routePath}\": key \"${key}\"`,\n                  )\n                }\n              }\n            } else {\n              existingPathItem[key] = JSON.parse(JSON.stringify(authVal))\n            }\n          }\n        }\n      }\n    }\n\n    // Merge security metadata\n    if (Array.isArray(authSpec.security)) {\n      for (const sec of authSpec.security) {\n        if (\n          !merged.security.some(\n            (s: any) => JSON.stringify(s) === JSON.stringify(sec),\n          )\n        ) {\n          merged.security.push(sec)\n        }\n      }\n    }\n\n    // Merge tags\n    if (!merged.tags.some((t: any) => t.name === 'Auth')) {\n      merged.tags.push({\n        name: 'Auth',\n        description: 'Authentication and session management',\n      })\n    }\n    if (Array.isArray(authSpec.tags)) {\n      for (const tag of authSpec.tags) {\n        if (\n          tag.name !== 'Default' &&\n          !merged.tags.some((t: any) => t.name === tag.name)\n        ) {\n          merged.tags.push(tag)\n        }\n      }\n    }\n  }\n\n  // Merge components by category\n  const categories = new Set([\n    ...Object.keys(nativeSpec.components || {}),\n    ...Object.keys(authSpec?.components || {}),\n  ])\n\n  for (const category of categories) {\n    const nativeCat = nativeSpec.components?.[category] || {}\n    const authCat = authSpec?.components?.[category] || {}\n\n    const mergedCat: Record<string, any> = { ...nativeCat }\n\n    for (const [key, authVal] of Object.entries(authCat)) {\n      if (key in nativeCat) {\n        const nativeVal = nativeCat[key]\n        if (JSON.stringify(nativeVal) !== JSON.stringify(authVal)) {\n          throw new Error(\n            `[workerstack] OpenAPI component collision: category \"${category}\" component \"${key}\"`,\n          )\n        }\n      } else {\n        mergedCat[key] = authVal\n      }\n    }\n\n    merged.components[category] = mergedCat\n  }\n\n  // Ensure all tags used in path operations are declared in merged.tags\n  for (const pathItem of Object.values(merged.paths)) {\n    if (!pathItem || typeof pathItem !== 'object') continue\n    for (const [key, op] of Object.entries(pathItem as Record<string, any>)) {\n      if (\n        HTTP_METHODS.has(key.toUpperCase()) &&\n        op &&\n        typeof op === 'object' &&\n        Array.isArray(op.tags)\n      ) {\n        for (const tagName of op.tags) {\n          if (\n            tagName &&\n            tagName !== 'Default' &&\n            !merged.tags.some((t: any) => t.name === tagName)\n          ) {\n            merged.tags.push({\n              name: tagName,\n              description: `${tagName} operations`,\n            })\n          }\n        }\n      }\n    }\n  }\n\n  return merged\n}\n"]}

package/dist/api/realtime-router.d.ts

@@ -0,0 +1,94 @@
+import '@orpc/openapi/extensions/route';
+import * as v from 'valibot';
+import type { ResolvedAccess } from '../access.js';
+import type { RealtimePublisher } from '../realtime/publisher.js';
+type RealtimeRouterOptions = {
+    heartbeatMs?: number;
+};
+export declare function buildRealtimeApiRouter(publisher: RealtimePublisher | undefined, access: ResolvedAccess, options?: RealtimeRouterOptions): {
+    realtime: {
+        changes: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<Record<string, unknown>, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.StrictObjectSchema<{
+            readonly tables: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>], undefined>, v.TransformAction<string | string[], string[]>]>;
+        }, undefined>, import("@orpc/contract").Schema<AsyncIteratorObject<{
+            table: string;
+            action: "create" | "update" | "delete";
+            record: {
+                [x: string]: unknown;
+            };
+            operationId?: string | undefined;
+        } | {
+            type: "heartbeat";
+            intervalMs: number;
+        }, unknown, void>, import("@orpc/client").AsyncIteratorClass<{
+            table: string;
+            action: "create" | "update" | "delete";
+            record: {
+                [x: string]: unknown;
+            };
+            operationId?: string | undefined;
+        } | {
+            type: "heartbeat";
+            intervalMs: number;
+        }, unknown, void>>, {
+            readonly BAD_REQUEST: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"BAD_REQUEST", undefined>, "BAD_REQUEST">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "BAD_REQUEST";
+                }>;
+            };
+            readonly UNAUTHORIZED: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"UNAUTHORIZED", undefined>, "UNAUTHORIZED">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "UNAUTHORIZED";
+                }>;
+            };
+            readonly FORBIDDEN: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"FORBIDDEN", undefined>, "FORBIDDEN">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "FORBIDDEN";
+                }>;
+            };
+            readonly NOT_FOUND: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"NOT_FOUND", undefined>, "NOT_FOUND">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "NOT_FOUND";
+                }>;
+            };
+            readonly CONFLICT: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"CONFLICT", undefined>, "CONFLICT">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "CONFLICT";
+                }>;
+            };
+            readonly PAYLOAD_TOO_LARGE: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"PAYLOAD_TOO_LARGE", undefined>, "PAYLOAD_TOO_LARGE">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "PAYLOAD_TOO_LARGE";
+                }>;
+            };
+            readonly TOO_MANY_REQUESTS: {
+                readonly data: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly code: v.OptionalSchema<v.LiteralSchema<"TOO_MANY_REQUESTS", undefined>, "TOO_MANY_REQUESTS">;
+                    readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                }, undefined>, {
+                    readonly code: "TOO_MANY_REQUESTS";
+                }>;
+            };
+        }>;
+    };
+} | undefined;
+export type RealtimeApiRouter = NonNullable<ReturnType<typeof buildRealtimeApiRouter>>;
+export {};
+//# sourceMappingURL=realtime-router.d.ts.map

package/dist/api/realtime-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-router.d.ts","sourceRoot":"","sources":["../../src/api/realtime-router.ts"],"names":[],"mappings":"AACA,OAAO,gCAAgC,CAAA;AACvC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAyB9D,KAAK,qBAAqB,GAAG;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCpC;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,CACzC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAC1C,CAAA"}

package/dist/api/realtime-router.js

@@ -0,0 +1,45 @@
+import { eventIterator } from '@orpc/server';
+import '@orpc/openapi/extensions/route';
+import * as v from 'valibot';
+import { filterRealtimeChanges } from '../realtime/filter.js';
+import { withRealtimeHeartbeat } from '../realtime/heartbeat.js';
+import { createApiBuilder } from './builder.js';
+const tablesSchema = v.pipe(v.union([v.string(), v.array(v.string())]), v.transform((value) => (Array.isArray(value) ? value : [value])));
+const changeSchema = v.strictObject({
+    table: v.string(),
+    action: v.picklist(['create', 'update', 'delete']),
+    record: v.record(v.string(), v.unknown()),
+    operationId: v.optional(v.string()),
+});
+const heartbeatSchema = v.strictObject({
+    type: v.literal('heartbeat'),
+    // The cadence this stream sends heartbeats at, so a client can size its
+    // dead-stream timeout from the server's real setting.
+    intervalMs: v.number(),
+});
+export function buildRealtimeApiRouter(publisher, access, options = {}) {
+    if (!publisher)
+        return undefined;
+    const builder = createApiBuilder();
+    const changes = builder.public
+        .route({
+        method: 'GET',
+        path: '/api/realtime',
+        summary: 'Subscribe to realtime changes',
+        tags: ['realtime'],
+        queryStyles: { tables: 'array' },
+    })
+        .input(v.strictObject({ tables: tablesSchema }))
+        .output(eventIterator(v.union([changeSchema, heartbeatSchema])))
+        .handler(({ input, context, signal, lastEventId }) => withRealtimeHeartbeat(filterRealtimeChanges(publisher.subscribe('change', { signal, lastEventId }), {
+        subscriptions: input.tables,
+        access,
+        request: context.request,
+        getSession: context.getSession,
+    }), {
+        intervalMs: options.heartbeatMs,
+        signal,
+    }));
+    return { realtime: { changes } };
+}
+//# sourceMappingURL=realtime-router.js.map

package/dist/api/realtime-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-router.js","sourceRoot":"","sources":["../../src/api/realtime-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,gCAAgC,CAAA;AACvC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAK5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CACzB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAC1C,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CACjE,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,wEAAwE;IACxE,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAA;AAMF,MAAM,UAAU,sBAAsB,CACpC,SAAwC,EACxC,MAAsB,EACtB,UAAiC,EAAE;IAEnC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAChC,MAAM,OAAO,GAAG,gBAAgB,EAG7B,CAAA;IAEH,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;SAC3B,KAAK,CAAC;QACL,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,+BAA+B;QACxC,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;KACjC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;SAC/C,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;SAC/D,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CACnD,qBAAqB,CACnB,qBAAqB,CACnB,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EACtD;QACE,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CACF,EACD;QACE,UAAU,EAAE,OAAO,CAAC,WAAW;QAC/B,MAAM;KACP,CACF,CACF,CAAA;IAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,CAAA;AAClC,CAAC","sourcesContent":["import { eventIterator } from '@orpc/server'\nimport '@orpc/openapi/extensions/route'\nimport * as v from 'valibot'\n\nimport type { ResolvedAccess } from '../access'\nimport type { RealtimePublisher } from '../realtime/publisher'\n\nimport { filterRealtimeChanges } from '../realtime/filter'\nimport { withRealtimeHeartbeat } from '../realtime/heartbeat'\nimport { createApiBuilder } from './builder'\n\nconst tablesSchema = v.pipe(\n  v.union([v.string(), v.array(v.string())]),\n  v.transform((value) => (Array.isArray(value) ? value : [value])),\n)\n\nconst changeSchema = v.strictObject({\n  table: v.string(),\n  action: v.picklist(['create', 'update', 'delete']),\n  record: v.record(v.string(), v.unknown()),\n  operationId: v.optional(v.string()),\n})\n\nconst heartbeatSchema = v.strictObject({\n  type: v.literal('heartbeat'),\n  // The cadence this stream sends heartbeats at, so a client can size its\n  // dead-stream timeout from the server's real setting.\n  intervalMs: v.number(),\n})\n\ntype RealtimeRouterOptions = {\n  heartbeatMs?: number\n}\n\nexport function buildRealtimeApiRouter(\n  publisher: RealtimePublisher | undefined,\n  access: ResolvedAccess,\n  options: RealtimeRouterOptions = {},\n) {\n  if (!publisher) return undefined\n  const builder = createApiBuilder<\n    Record<string, unknown>,\n    Record<string, unknown>\n  >()\n\n  const changes = builder.public\n    .route({\n      method: 'GET',\n      path: '/api/realtime',\n      summary: 'Subscribe to realtime changes',\n      tags: ['realtime'],\n      queryStyles: { tables: 'array' },\n    })\n    .input(v.strictObject({ tables: tablesSchema }))\n    .output(eventIterator(v.union([changeSchema, heartbeatSchema])))\n    .handler(({ input, context, signal, lastEventId }) =>\n      withRealtimeHeartbeat(\n        filterRealtimeChanges(\n          publisher.subscribe('change', { signal, lastEventId }),\n          {\n            subscriptions: input.tables,\n            access,\n            request: context.request,\n            getSession: context.getSession,\n          },\n        ),\n        {\n          intervalMs: options.heartbeatMs,\n          signal,\n        },\n      ),\n    )\n\n  return { realtime: { changes } }\n}\n\nexport type RealtimeApiRouter = NonNullable<\n  ReturnType<typeof buildRealtimeApiRouter>\n>\n"]}

package/dist/api/registry.d.ts

@@ -0,0 +1,30 @@
+export interface ApiRegistryEntry {
+    handle: string;
+    operationId: string;
+    method: string;
+    path: string;
+    source: string;
+}
+export interface ApiRegistry {
+    entries: ApiRegistryEntry[];
+}
+export interface ForeignSpecEntry {
+    spec: Record<string, unknown>;
+    prefix?: string;
+    source?: string;
+}
+export interface BuildApiRegistryOptions {
+    nativeRouter?: Record<string, unknown>;
+    foreignSpecs?: Array<Record<string, unknown> | ForeignSpecEntry>;
+    /** Native procedures generated by Workerstack itself may own reserved paths. */
+    reservedCoreHandles?: ReadonlySet<string>;
+}
+export declare function normalizeApiPath(path: string, prefix?: string): string;
+export interface ForeignSpecOptions {
+    prefix?: string;
+    source?: string;
+}
+export declare function normalizeForeignOpenAPISpec(spec: Record<string, unknown>, options?: ForeignSpecOptions): Record<string, unknown>;
+export declare function mergeApiRoutersStrict(target: Record<string, unknown>, source?: Record<string, unknown>, prefix?: string[]): Record<string, unknown>;
+export declare function buildApiRegistry(options?: BuildApiRegistryOptions): Promise<ApiRegistry>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/api/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/api/registry.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAA;IAChE,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC1C;AAYD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CActE;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,GAAE,MAAM,EAAO,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB;AAiHD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,CAAC,CAgFtB"}