workerstack 0.1.0-beta.0

package/dist/api/catalog.js

@@ -0,0 +1,56 @@
+// src/api/catalog.ts — static description of the application's own procedures.
+import { getOpenAPIMeta } from '@orpc/openapi';
+const READ_METHODS = new Set(['GET', 'HEAD', 'OPTIONS']);
+const MAX_SUMMARY = 200;
+function summaryText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const collapsed = value.trim().replace(/\s+/g, ' ');
+    if (!collapsed)
+        return undefined;
+    return collapsed.length > MAX_SUMMARY
+        ? `${collapsed.slice(0, MAX_SUMMARY - 1)}…`
+        : collapsed;
+}
+function walk(router, segments) {
+    const operations = [];
+    for (const [key, value] of Object.entries(router)) {
+        if (!value || typeof value !== 'object')
+            continue;
+        const current = [...segments, key];
+        if (!('~orpc' in value)) {
+            operations.push(...walk(value, current));
+            continue;
+        }
+        const meta = (getOpenAPIMeta(value) ?? {});
+        const handle = current.join('.');
+        const method = typeof meta.method === 'string' ? meta.method.toUpperCase() : undefined;
+        const summary = summaryText(meta.summary);
+        operations.push({
+            handle,
+            operationId: typeof meta.operationId === 'string' ? meta.operationId : handle,
+            // A procedure that declares no method could be anything. Calling it a
+            // read would tell a host it is safe to invoke without asking anyone.
+            effect: method === undefined
+                ? 'unknown'
+                : READ_METHODS.has(method)
+                    ? 'read'
+                    : 'mutation',
+            ...(method === undefined ? {} : { method }),
+            ...(typeof meta.path === 'string' ? { path: meta.path } : {}),
+            ...(summary === undefined ? {} : { summary }),
+        });
+    }
+    return operations;
+}
+/**
+ * Describes the procedures an application declared itself. Generated CRUD,
+ * storage, and realtime routes are excluded: a host derives those from the
+ * blueprint's `resources`.
+ */
+export function describeApiOperations(router) {
+    if (!router || typeof router !== 'object')
+        return [];
+    return walk(router, []).sort((left, right) => left.handle.localeCompare(right.handle));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/api/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["// src/api/catalog.ts — static description of the application's own procedures.\nimport { getOpenAPIMeta } from '@orpc/openapi'\n\nimport type { ApiOperation } from '../manifest'\n\nconst READ_METHODS = new Set(['GET', 'HEAD', 'OPTIONS'])\nconst MAX_SUMMARY = 200\n\nfunction summaryText(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined\n  const collapsed = value.trim().replace(/\\s+/g, ' ')\n  if (!collapsed) return undefined\n  return collapsed.length > MAX_SUMMARY\n    ? `${collapsed.slice(0, MAX_SUMMARY - 1)}…`\n    : collapsed\n}\n\nfunction walk(\n  router: Record<string, unknown>,\n  segments: string[],\n): ApiOperation[] {\n  const operations: ApiOperation[] = []\n\n  for (const [key, value] of Object.entries(router)) {\n    if (!value || typeof value !== 'object') continue\n    const current = [...segments, key]\n\n    if (!('~orpc' in value)) {\n      operations.push(...walk(value as Record<string, unknown>, current))\n      continue\n    }\n\n    const meta = (getOpenAPIMeta(value as never) ?? {}) as Record<\n      string,\n      unknown\n    >\n    const handle = current.join('.')\n    const method =\n      typeof meta.method === 'string' ? meta.method.toUpperCase() : undefined\n    const summary = summaryText(meta.summary)\n\n    operations.push({\n      handle,\n      operationId:\n        typeof meta.operationId === 'string' ? meta.operationId : handle,\n      // A procedure that declares no method could be anything. Calling it a\n      // read would tell a host it is safe to invoke without asking anyone.\n      effect:\n        method === undefined\n          ? 'unknown'\n          : READ_METHODS.has(method)\n            ? 'read'\n            : 'mutation',\n      ...(method === undefined ? {} : { method }),\n      ...(typeof meta.path === 'string' ? { path: meta.path } : {}),\n      ...(summary === undefined ? {} : { summary }),\n    })\n  }\n\n  return operations\n}\n\n/**\n * Describes the procedures an application declared itself. Generated CRUD,\n * storage, and realtime routes are excluded: a host derives those from the\n * blueprint's `resources`.\n */\nexport function describeApiOperations(router: unknown): ApiOperation[] {\n  if (!router || typeof router !== 'object') return []\n  return walk(router as Record<string, unknown>, []).sort((left, right) =>\n    left.handle.localeCompare(right.handle),\n  )\n}\n"]}

package/dist/api/context.d.ts

@@ -0,0 +1,47 @@
+import type { AccessUser, AuthSessionResolver } from '../access.js';
+import type { DbFor } from '../db.js';
+import type { JobsRuntimeFacade } from '../jobs/define.js';
+import type { WorkerstackLogger } from '../logging.js';
+import type { MessagingConfig, MessagingFacadesFor } from '../messaging/index.js';
+import type { RealtimeFacade } from '../realtime/facade.js';
+import type { AuthInstance, StorageFacade } from '../runtime.js';
+export interface ApiContextDeps<TSchema extends Record<string, unknown> = Record<string, unknown>, TEnv = Record<string, unknown>, TMessaging extends MessagingConfig | undefined = MessagingConfig, TSessionUser extends Record<string, unknown> = Record<never, never>> {
+    db: DbFor<TSchema>;
+    env: TEnv;
+    storage: StorageFacade;
+    messaging: MessagingFacadesFor<TMessaging>;
+    jobs: JobsRuntimeFacade;
+    realtime: RealtimeFacade<TSchema>;
+    auth: AuthInstance;
+    authResolver?: AuthSessionResolver<TSessionUser>;
+    logger?: WorkerstackLogger;
+}
+export interface ApiContext<TSchema extends Record<string, unknown> = Record<string, unknown>, TEnv = Record<string, unknown>, TMessaging extends MessagingConfig | undefined = MessagingConfig, TSessionUser extends Record<string, unknown> = Record<never, never>> {
+    db: DbFor<TSchema>;
+    env: TEnv;
+    storage: StorageFacade;
+    messaging: MessagingFacadesFor<TMessaging>;
+    jobs: JobsRuntimeFacade;
+    realtime: RealtimeFacade<TSchema>;
+    auth: AuthInstance;
+    logger: WorkerstackLogger;
+    request: Request;
+    resHeaders: Headers;
+    getRawBody: () => Promise<string>;
+    getSession: () => Promise<{
+        user: AccessUser<TSessionUser> | null;
+        activeOrganizationId: string | null;
+    }>;
+    /**
+     * The session that some earlier code already resolved, or `undefined`.
+     * Never starts a resolution, so a global middleware can log the caller
+     * without removing the lazy session behavior that signed webhooks rely on.
+     * Use it for observability only. Never use it for authorization.
+     */
+    peekSession: () => {
+        user: AccessUser<TSessionUser> | null;
+        activeOrganizationId: string | null;
+    } | undefined;
+}
+export declare function createApiContext<TSchema extends Record<string, unknown> = Record<string, unknown>, TEnv = Record<string, unknown>, TMessaging extends MessagingConfig | undefined = MessagingConfig, TSessionUser extends Record<string, unknown> = Record<never, never>>(deps: ApiContextDeps<TSchema, TEnv, TMessaging, TSessionUser>, request: Request): ApiContext<TSchema, TEnv, TMessaging, TSessionUser>;
+//# sourceMappingURL=context.d.ts.map

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

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

package/dist/api/context.js

@@ -0,0 +1,40 @@
+import { resolveSession } from '../access.js';
+import { consoleLogger } from '../logging.js';
+export function createApiContext(deps, request) {
+    // Reserve the body stream before a transport codec consumes `request`.
+    const rawBodyRequest = request.clone();
+    let rawBodyPromise;
+    let sessionPromise;
+    let settledSession;
+    const getSession = () => {
+        if (!sessionPromise) {
+            sessionPromise = resolveSession(deps.authResolver, request.headers).then((session) => {
+                settledSession = session;
+                return session;
+            });
+        }
+        return sessionPromise;
+    };
+    const peekSession = () => settledSession;
+    const getRawBody = () => {
+        if (!rawBodyPromise)
+            rawBodyPromise = rawBodyRequest.text();
+        return rawBodyPromise;
+    };
+    return {
+        db: deps.db,
+        env: deps.env,
+        storage: deps.storage,
+        messaging: deps.messaging,
+        jobs: deps.jobs,
+        realtime: deps.realtime,
+        auth: deps.auth,
+        logger: deps.logger ?? consoleLogger,
+        request,
+        resHeaders: new Headers(),
+        getRawBody,
+        getSession,
+        peekSession,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/api/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/api/context.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAsD1C,MAAM,UAAU,gBAAgB,CAM9B,IAA6D,EAC7D,OAAgB;IAEhB,uEAAuE;IACvE,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;IACtC,IAAI,cAA2C,CAAA;IAC/C,IAAI,cAKS,CAAA;IAEb,IAAI,cAKS,CAAA;IAEb,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CACtE,CAAC,OAAO,EAAE,EAAE;gBACV,cAAc,GAAG,OAAO,CAAA;gBACxB,OAAO,OAAO,CAAA;YAChB,CAAC,CACF,CAAA;QACH,CAAC;QACD,OAAO,cAAc,CAAA;IACvB,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,cAAc,CAAA;IAExC,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,CAAC,cAAc;YAAE,cAAc,GAAG,cAAc,CAAC,IAAI,EAAE,CAAA;QAC3D,OAAO,cAAc,CAAA;IACvB,CAAC,CAAA;IAED,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa;QACpC,OAAO;QACP,UAAU,EAAE,IAAI,OAAO,EAAE;QACzB,UAAU;QACV,UAAU;QACV,WAAW;KACZ,CAAA;AACH,CAAC","sourcesContent":["import type { AccessUser, AuthSessionResolver } from '../access'\nimport type { DbFor } from '../db'\nimport type { JobsRuntimeFacade } from '../jobs/define'\nimport type { WorkerstackLogger } from '../logging'\nimport type { MessagingConfig, MessagingFacadesFor } from '../messaging'\nimport type { RealtimeFacade } from '../realtime/facade'\nimport type { AuthInstance, StorageFacade } from '../runtime'\n\nimport { resolveSession } from '../access'\nimport { consoleLogger } from '../logging'\n\nexport interface ApiContextDeps<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnv = Record<string, unknown>,\n  TMessaging extends MessagingConfig | undefined = MessagingConfig,\n  TSessionUser extends Record<string, unknown> = Record<never, never>,\n> {\n  db: DbFor<TSchema>\n  env: TEnv\n  storage: StorageFacade\n  messaging: MessagingFacadesFor<TMessaging>\n  jobs: JobsRuntimeFacade\n  realtime: RealtimeFacade<TSchema>\n  auth: AuthInstance\n  authResolver?: AuthSessionResolver<TSessionUser>\n  logger?: WorkerstackLogger\n}\n\nexport interface ApiContext<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnv = Record<string, unknown>,\n  TMessaging extends MessagingConfig | undefined = MessagingConfig,\n  TSessionUser extends Record<string, unknown> = Record<never, never>,\n> {\n  db: DbFor<TSchema>\n  env: TEnv\n  storage: StorageFacade\n  messaging: MessagingFacadesFor<TMessaging>\n  jobs: JobsRuntimeFacade\n  realtime: RealtimeFacade<TSchema>\n  auth: AuthInstance\n  logger: WorkerstackLogger\n  request: Request\n  resHeaders: Headers\n  getRawBody: () => Promise<string>\n  getSession: () => Promise<{\n    user: AccessUser<TSessionUser> | null\n    activeOrganizationId: string | null\n  }>\n  /**\n   * The session that some earlier code already resolved, or `undefined`.\n   * Never starts a resolution, so a global middleware can log the caller\n   * without removing the lazy session behavior that signed webhooks rely on.\n   * Use it for observability only. Never use it for authorization.\n   */\n  peekSession: () =>\n    | {\n        user: AccessUser<TSessionUser> | null\n        activeOrganizationId: string | null\n      }\n    | undefined\n}\n\nexport function createApiContext<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnv = Record<string, unknown>,\n  TMessaging extends MessagingConfig | undefined = MessagingConfig,\n  TSessionUser extends Record<string, unknown> = Record<never, never>,\n>(\n  deps: ApiContextDeps<TSchema, TEnv, TMessaging, TSessionUser>,\n  request: Request,\n): ApiContext<TSchema, TEnv, TMessaging, TSessionUser> {\n  // Reserve the body stream before a transport codec consumes `request`.\n  const rawBodyRequest = request.clone()\n  let rawBodyPromise: Promise<string> | undefined\n  let sessionPromise:\n    | Promise<{\n        user: AccessUser<TSessionUser> | null\n        activeOrganizationId: string | null\n      }>\n    | undefined\n\n  let settledSession:\n    | {\n        user: AccessUser<TSessionUser> | null\n        activeOrganizationId: string | null\n      }\n    | undefined\n\n  const getSession = () => {\n    if (!sessionPromise) {\n      sessionPromise = resolveSession(deps.authResolver, request.headers).then(\n        (session) => {\n          settledSession = session\n          return session\n        },\n      )\n    }\n    return sessionPromise\n  }\n\n  const peekSession = () => settledSession\n\n  const getRawBody = () => {\n    if (!rawBodyPromise) rawBodyPromise = rawBodyRequest.text()\n    return rawBodyPromise\n  }\n\n  return {\n    db: deps.db,\n    env: deps.env,\n    storage: deps.storage,\n    messaging: deps.messaging,\n    jobs: deps.jobs,\n    realtime: deps.realtime,\n    auth: deps.auth,\n    logger: deps.logger ?? consoleLogger,\n    request,\n    resHeaders: new Headers(),\n    getRawBody,\n    getSession,\n    peekSession,\n  }\n}\n"]}

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

@@ -0,0 +1,476 @@
+import { type Table } from 'drizzle-orm';
+import '@orpc/openapi/extensions/route';
+import * as v from 'valibot';
+import type { AnyDb } from '../dialect.js';
+import type { IdempotencyConfig } from '../idempotency.js';
+import type { RealtimeFacade } from '../realtime/facade.js';
+import type { RealtimePublisher } from '../realtime/publisher.js';
+import type { CrudApiRouterFor } from './types.js';
+import { type ResolvedAccess, type ResolvedTableAccess, type TableAccessInput } from '../access.js';
+import { type CrudOperations } from '../crud-operations.js';
+import { createApiBuilder } from './builder.js';
+export type CrudApiRouterOptions<TSchema extends Record<string, unknown> = Record<string, unknown>> = {
+    access: ResolvedAccess;
+    idempotency?: boolean | IdempotencyConfig;
+    realtime?: RealtimeFacade<TSchema>;
+    /**
+     * The raw realtime publisher, present when realtime is enabled. The CRUD
+     * router subscribes on behalf of live views (`GET /{table}:live`);
+     * publishing stays behind the facade.
+     */
+    livePublisher?: RealtimePublisher;
+};
+/** A filter accepts one value (`=`), a list (`IN`), or null (`IS NULL`). */
+export type ListFilterValue<T> = T | readonly T[] | null | 'null';
+export type ListFilters<TTable extends Table, TFilterable extends string> = {
+    [K in Extract<keyof TTable['$inferSelect'], TFilterable>]?: ListFilterValue<TTable['$inferSelect'][K]>;
+};
+/**
+ * The `list` input as callers see it. Filter columns and sortable columns come
+ * from the table's `access` entry, so `filters` autocompletes to real columns
+ * and rejects wrong value types at compile time.
+ */
+export type ListInputFor<TTable extends Table, TFilterable extends string, TSortable extends string> = {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    sort?: TSortable;
+    order?: 'asc' | 'desc';
+    q?: string;
+    count?: boolean;
+    filters?: ListFilters<TTable, TFilterable>;
+} | undefined;
+/**
+ * The live-view input as callers see it: the list contract narrowed to what a
+ * stream can honor — no text search, no pagination.
+ */
+export type LiveInputFor<TTable extends Table, TFilterable extends string, TSortable extends string> = {
+    limit?: number;
+    sort?: TSortable;
+    order?: 'asc' | 'desc';
+    filters?: ListFilters<TTable, TFilterable>;
+} | undefined;
+export type BuildTableCrudProceduresArgs<TSchema extends Record<string, unknown>, TTable extends Table> = {
+    table: TTable;
+    operations: CrudOperations;
+    builder: ReturnType<typeof createApiBuilder<TSchema>>;
+    access: ResolvedTableAccess;
+    /** The schema key events are published under. */
+    schemaKey: string;
+    /** Present when realtime is enabled; without it no live procedure is built. */
+    livePublisher?: RealtimePublisher;
+};
+export declare function buildTableCrudProcedures<TSchema extends Record<string, unknown>, TTable extends Table, TFilterable extends string = string, TSortable extends string = string>(args: BuildTableCrudProceduresArgs<TSchema, TTable>): {
+    list: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<TSchema, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.GenericSchema<ListInputFor<TTable, TFilterable, TSortable>, ListInputFor<TTable, TFilterable, TSortable>>, v.StrictObjectSchema<{
+        readonly items: v.ArraySchema<v.GenericSchema<TTable["$inferSelect"], TTable["$inferSelect"]>, undefined>;
+        readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly hasMore: v.BooleanSchema<undefined>;
+        readonly total: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly limit: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly offset: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly q: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly sort: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly order: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, {
+        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";
+            }>;
+        };
+    }>;
+    get: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<TSchema, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.StrictObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+    }, undefined>, v.GenericSchema<TTable["$inferSelect"], TTable["$inferSelect"]>, {
+        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";
+            }>;
+        };
+    }>;
+    create: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<TSchema, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.GenericSchema<Partial<TTable["$inferInsert"]>, Partial<TTable["$inferInsert"]>>, v.GenericSchema<TTable["$inferSelect"], TTable["$inferSelect"]>, {
+        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";
+            }>;
+        };
+    }>;
+    update: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<TSchema, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.GenericSchema<{
+        id: string;
+    } & Partial<Omit<TTable["$inferInsert"], "id">>, {
+        id: string;
+    } & Partial<Omit<TTable["$inferInsert"], "id">>>, v.GenericSchema<TTable["$inferSelect"], TTable["$inferSelect"]>, {
+        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";
+            }>;
+        };
+    }>;
+    delete: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<TSchema, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.StrictObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+    }, undefined>, v.UndefinedSchema<undefined>, {
+        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";
+            }>;
+        };
+    }>;
+    live: import("@orpc/server").DecoratedProcedure<import("./context.js").ApiContext<TSchema, Record<string, unknown>, import("..").MessagingConfig, Record<never, never>> & object, object, v.GenericSchema<LiveInputFor<TTable, TFilterable, TSortable>, LiveInputFor<TTable, TFilterable, TSortable>>, import("@orpc/contract").Schema<AsyncIteratorObject<{
+        type: "snapshot";
+        items: TTable["$inferSelect"][];
+        sort: string;
+        order: "asc" | "desc";
+        limit: number;
+        hasMore: boolean;
+        operationId?: string | undefined;
+    } | {
+        type: "upsert";
+        record: TTable["$inferSelect"];
+        afterId: string | null;
+        operationId?: string | undefined;
+    } | {
+        type: "remove";
+        id: string;
+        operationId?: string | undefined;
+    } | {
+        type: "heartbeat";
+        intervalMs: number;
+    }, unknown, void>, import("@orpc/client").AsyncIteratorClass<{
+        type: "snapshot";
+        items: TTable["$inferSelect"][];
+        sort: string;
+        order: "asc" | "desc";
+        limit: number;
+        hasMore: boolean;
+        operationId?: string | undefined;
+    } | {
+        type: "upsert";
+        record: TTable["$inferSelect"];
+        afterId: string | null;
+        operationId?: string | undefined;
+    } | {
+        type: "remove";
+        id: string;
+        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";
+            }>;
+        };
+    }>;
+};
+export type TableCrudProcedures<TTable extends Table, TFilterable extends string = string, TSortable extends string = string, TLive extends boolean = false> = Omit<ReturnType<typeof buildTableCrudProcedures<Record<string, unknown>, TTable, TFilterable, TSortable>>, 'live'> & (TLive extends true ? {
+    live: ReturnType<typeof buildTableCrudProcedures<Record<string, unknown>, TTable, TFilterable, TSortable>>['live'];
+} : {});
+export declare function buildCrudApiRouter<TSchema extends Record<string, unknown>, TAccess extends Record<string, TableAccessInput> | undefined = undefined, TLive extends boolean = false>(schema: TSchema, db: AnyDb, options: CrudApiRouterOptions<TSchema>): CrudApiRouterFor<TSchema, TAccess, TLive>;
+//# sourceMappingURL=crud-router.d.ts.map