workerstack 0.1.0-beta.0

package/dist/client/rpc-client.js

@@ -0,0 +1,59 @@
+import { createORPCClient } from '@orpc/client';
+import { RPCLink } from '@orpc/client/fetch';
+export const OPERATION_ID_HEADER = 'x-workerstack-operation-id';
+function rpcUrl(baseUrl = '/api') {
+    return (baseUrl.endsWith('/') ? `${baseUrl}rpc` : `${baseUrl}/rpc`);
+}
+function adaptClient(client) {
+    const cache = new Map();
+    return new Proxy(function () { }, {
+        get(_target, property) {
+            if (!cache.has(property)) {
+                const value = Reflect.get(client, property);
+                cache.set(property, value === null ||
+                    (typeof value !== 'object' && typeof value !== 'function')
+                    ? value
+                    : adaptClient(value));
+            }
+            return cache.get(property);
+        },
+        apply(_target, _thisArg, args) {
+            const [input, options = {}] = args;
+            return Reflect.apply(client, undefined, [
+                input,
+                {
+                    signal: options.signal,
+                    lastEventId: options.lastEventId,
+                    context: {
+                        operationId: options.operationId,
+                        headers: options.headers,
+                    },
+                },
+            ]);
+        },
+    });
+}
+export function createRpcClient(options = {}) {
+    const fetcher = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+    const link = new RPCLink({
+        url: rpcUrl(options.baseUrl),
+        fetch: (url, init) => fetcher(url, init),
+        headers: async ({ context }) => {
+            const defaults = typeof options.headers === 'function'
+                ? await options.headers()
+                : options.headers;
+            const headers = new Headers(defaults);
+            new Headers(context.headers).forEach((value, key) => headers.set(key, value));
+            if (context.operationId) {
+                headers.set(OPERATION_ID_HEADER, context.operationId);
+            }
+            return headers;
+        },
+    });
+    const client = createORPCClient(link);
+    return adaptClient(client);
+}
+export function createClient(options = {}) {
+    return createRpcClient(options);
+}
+//# sourceMappingURL=rpc-client.js.map

package/dist/client/rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.js","sourceRoot":"","sources":["../../src/client/rpc-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,4BAA4B,CAAA;AAsD/D,SAAS,MAAM,CAAC,OAAO,GAAG,MAAM;IAC9B,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,CAC5C,CAAA;AAClB,CAAC;AAED,SAAS,WAAW,CAAI,MAAS;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAA;IAC7C,OAAO,IAAI,KAAK,CAAC,cAAa,CAAoC,EAAE;QAClE,GAAG,CAAC,OAAO,EAAE,QAAQ;YACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,EAAE,QAAQ,CAAC,CAAA;gBACrD,KAAK,CAAC,GAAG,CACP,QAAQ,EACR,KAAK,KAAK,IAAI;oBACZ,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;oBAC1D,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CACvB,CAAA;YACH,CAAC;YACD,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAA6B;YACpD,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,IAAI,CAAA;YAClC,OAAO,OAAO,CAAC,KAAK,CAClB,MAAyC,EACzC,SAAS,EACT;gBACE,KAAK;gBACL;oBACE,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE;wBACP,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;qBACzB;iBACF;aACF,CACF,CAAA;QACH,CAAC;KACF,CAA+B,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAyB,EAAE;IAE3B,MAAM,OAAO,GACX,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAa;QACnC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7B,MAAM,QAAQ,GACZ,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;gBACnC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE;gBACzB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAA;YACrB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAA;YACrC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAClD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CACxB,CAAA;YACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;YACvD,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAoC,IAAI,CAAC,CAAA;IACxE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,UAAyB,EAAE;IAE3B,OAAO,eAAe,CAAuB,OAAO,CAAC,CAAA;AACvD,CAAC","sourcesContent":["import type { StandardUrl } from '@orpc/client'\nimport type { AnyRouter, RouterClient } from '@orpc/server'\n\nimport { createORPCClient } from '@orpc/client'\nimport { RPCLink } from '@orpc/client/fetch'\n\nexport const OPERATION_ID_HEADER = 'x-workerstack-operation-id'\n\nexport type Fetch = (\n  input: RequestInfo | URL,\n  init?: RequestInit,\n) => Promise<Response>\n\nexport type ClientOptions = {\n  baseUrl?: string\n  fetch?: Fetch\n  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>)\n}\n\nexport type CallOptions = {\n  signal?: AbortSignal\n  lastEventId?: string\n  operationId?: string\n  headers?: HeadersInit\n}\n\nexport type ClientCarrier = {\n  api: AnyRouter\n  buckets: string\n}\n\nexport type AnyWorkerstackApp = {\n  $inferClient?: ClientCarrier | undefined\n}\n\nexport type InferApiRouter<TApp extends AnyWorkerstackApp> = NonNullable<\n  TApp['$inferClient']\n>['api']\n\ntype RpcContext = {\n  operationId?: string\n  headers?: HeadersInit\n}\n\ntype AdaptCallArgs<TArgs extends unknown[]> = {\n  [K in keyof TArgs]: K extends 1 | '1' ? CallOptions : TArgs[K]\n}\n\nexport type DirectClient<T> = T extends (...args: infer TArgs) => infer TResult\n  ? (...args: AdaptCallArgs<TArgs>) => TResult\n  : { [K in keyof T]: DirectClient<T[K]> }\n\nexport type RpcClient<TRouter extends AnyRouter> = DirectClient<\n  RouterClient<TRouter, RpcContext>\n>\n\nexport type WorkerstackClient<TApp extends AnyWorkerstackApp> = RpcClient<\n  InferApiRouter<TApp>\n>\n\nfunction rpcUrl(baseUrl = '/api'): StandardUrl {\n  return (\n    baseUrl.endsWith('/') ? `${baseUrl}rpc` : `${baseUrl}/rpc`\n  ) as StandardUrl\n}\n\nfunction adaptClient<T>(client: T): DirectClient<T> {\n  const cache = new Map<PropertyKey, unknown>()\n  return new Proxy(function () {} as (...args: unknown[]) => unknown, {\n    get(_target, property) {\n      if (!cache.has(property)) {\n        const value = Reflect.get(client as object, property)\n        cache.set(\n          property,\n          value === null ||\n            (typeof value !== 'object' && typeof value !== 'function')\n            ? value\n            : adaptClient(value),\n        )\n      }\n      return cache.get(property)\n    },\n    apply(_target, _thisArg, args: [unknown, CallOptions?]) {\n      const [input, options = {}] = args\n      return Reflect.apply(\n        client as (...args: unknown[]) => unknown,\n        undefined,\n        [\n          input,\n          {\n            signal: options.signal,\n            lastEventId: options.lastEventId,\n            context: {\n              operationId: options.operationId,\n              headers: options.headers,\n            },\n          },\n        ],\n      )\n    },\n  }) as unknown as DirectClient<T>\n}\n\nexport function createRpcClient<TRouter extends AnyRouter>(\n  options: ClientOptions = {},\n): RpcClient<TRouter> {\n  const fetcher =\n    options.fetch ?? ((input, init) => globalThis.fetch(input, init))\n  const link = new RPCLink<RpcContext>({\n    url: rpcUrl(options.baseUrl),\n    fetch: (url, init) => fetcher(url, init),\n    headers: async ({ context }) => {\n      const defaults =\n        typeof options.headers === 'function'\n          ? await options.headers()\n          : options.headers\n      const headers = new Headers(defaults)\n      new Headers(context.headers).forEach((value, key) =>\n        headers.set(key, value),\n      )\n      if (context.operationId) {\n        headers.set(OPERATION_ID_HEADER, context.operationId)\n      }\n      return headers\n    },\n  })\n  const client = createORPCClient<RouterClient<TRouter, RpcContext>>(link)\n  return adaptClient(client)\n}\n\nexport function createClient<TApp extends AnyWorkerstackApp>(\n  options: ClientOptions = {},\n): WorkerstackClient<TApp> {\n  return createRpcClient<InferApiRouter<TApp>>(options)\n}\n"]}

package/dist/client/solid.d.ts

@@ -0,0 +1,7 @@
+import { type Store } from 'solid-js';
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+/** Mirrors confirmed LiveView snapshots into a keyed Solid store. */
+export declare function createLiveStore<T extends {
+    id: unknown;
+}>(view: LiveView<T>): Store<LiveViewSnapshot<T>>;
+//# sourceMappingURL=solid.d.ts.map

package/dist/client/solid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../src/client/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,EACvD,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAiB5B"}

package/dist/client/solid.js

@@ -0,0 +1,21 @@
+import { createStore, onCleanup, reconcile } from 'solid-js';
+/** Mirrors confirmed LiveView snapshots into a keyed Solid store. */
+export function createLiveStore(view) {
+    const initial = view.getSnapshot();
+    const [state, setState] = createStore({
+        items: [...initial.items],
+        status: initial.status,
+        error: initial.error,
+    });
+    const unsubscribe = view.subscribe(() => {
+        const next = view.getSnapshot();
+        setState((draft) => {
+            reconcile([...next.items], (item) => item.id)(draft.items);
+            draft.status = next.status;
+            draft.error = next.error;
+        });
+    });
+    onCleanup(unsubscribe);
+    return state;
+}
+//# sourceMappingURL=solid.js.map

package/dist/client/solid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid.js","sourceRoot":"","sources":["../../src/client/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAc,MAAM,UAAU,CAAA;AAIxE,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC7B,IAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAClC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,WAAW,CAAC;QACpC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAA;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC/B,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC7D,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YAC1B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,SAAS,CAAC,WAAW,CAAC,CAAA;IACtB,OAAO,KAAmC,CAAA;AAC5C,CAAC","sourcesContent":["import { createStore, onCleanup, reconcile, type Store } from 'solid-js'\n\nimport type { LiveView, LiveViewSnapshot } from './live-view'\n\n/** Mirrors confirmed LiveView snapshots into a keyed Solid store. */\nexport function createLiveStore<T extends { id: unknown }>(\n  view: LiveView<T>,\n): Store<LiveViewSnapshot<T>> {\n  const initial = view.getSnapshot()\n  const [state, setState] = createStore({\n    items: [...initial.items],\n    status: initial.status,\n    error: initial.error,\n  })\n  const unsubscribe = view.subscribe(() => {\n    const next = view.getSnapshot()\n    setState((draft) => {\n      reconcile([...next.items], (item: T) => item.id)(draft.items)\n      draft.status = next.status\n      draft.error = next.error\n    })\n  })\n  onCleanup(unsubscribe)\n  return state as Store<LiveViewSnapshot<T>>\n}\n"]}

package/dist/client/svelte.d.ts

@@ -0,0 +1,6 @@
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+export type Readable<T> = {
+    subscribe(run: (value: T) => void): () => void;
+};
+export declare function liveStore<T>(view: LiveView<T>): Readable<LiveViewSnapshot<T>>;
+//# sourceMappingURL=svelte.d.ts.map

package/dist/client/svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../../src/client/svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAC/C,CAAA;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAO7E"}

package/dist/client/svelte.js

@@ -0,0 +1,9 @@
+export function liveStore(view) {
+    return {
+        subscribe(run) {
+            run(view.getSnapshot());
+            return view.subscribe(() => run(view.getSnapshot()));
+        },
+    };
+}
+//# sourceMappingURL=svelte.js.map

package/dist/client/svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.js","sourceRoot":"","sources":["../../src/client/svelte.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,SAAS,CAAI,IAAiB;IAC5C,OAAO;QACL,SAAS,CAAC,GAAG;YACX,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QACtD,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { LiveView, LiveViewSnapshot } from './live-view'\n\nexport type Readable<T> = {\n  subscribe(run: (value: T) => void): () => void\n}\n\nexport function liveStore<T>(view: LiveView<T>): Readable<LiveViewSnapshot<T>> {\n  return {\n    subscribe(run) {\n      run(view.getSnapshot())\n      return view.subscribe(() => run(view.getSnapshot()))\n    },\n  }\n}\n"]}

package/dist/client/vue.d.ts

@@ -0,0 +1,5 @@
+import { type ShallowRef } from 'vue';
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+/** Vue owns reactivity; LiveView supplies immutable external snapshots. */
+export declare function useLiveView<T>(view: LiveView<T>): ShallowRef<LiveViewSnapshot<T>>;
+//# sourceMappingURL=vue.d.ts.map

package/dist/client/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/client/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,KAAK,CAAA;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CASjC"}

package/dist/client/vue.js

@@ -0,0 +1,11 @@
+import { onScopeDispose, shallowRef } from 'vue';
+/** Vue owns reactivity; LiveView supplies immutable external snapshots. */
+export function useLiveView(view) {
+    const state = shallowRef(view.getSnapshot());
+    const unsubscribe = view.subscribe(() => {
+        state.value = view.getSnapshot();
+    });
+    onScopeDispose(unsubscribe);
+    return state;
+}
+//# sourceMappingURL=vue.js.map

package/dist/client/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/client/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAmB,MAAM,KAAK,CAAA;AAIjE,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CACzB,IAAiB;IAEjB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAE1C,CAAA;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;QACtC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC,CAAC,CAAA;IACF,cAAc,CAAC,WAAW,CAAC,CAAA;IAC3B,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["import { onScopeDispose, shallowRef, type ShallowRef } from 'vue'\n\nimport type { LiveView, LiveViewSnapshot } from './live-view'\n\n/** Vue owns reactivity; LiveView supplies immutable external snapshots. */\nexport function useLiveView<T>(\n  view: LiveView<T>,\n): ShallowRef<LiveViewSnapshot<T>> {\n  const state = shallowRef(view.getSnapshot()) as ShallowRef<\n    LiveViewSnapshot<T>\n  >\n  const unsubscribe = view.subscribe(() => {\n    state.value = view.getSnapshot()\n  })\n  onScopeDispose(unsubscribe)\n  return state\n}\n"]}

package/dist/codegen.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Typed route-map generation from the app's OpenAPI document.
+ *
+ * `generateRouteMap` turns `/api/openapi.json` into a small standalone module:
+ * an `ApiRoutes` type — one `Op` entry per operation, carrying its method,
+ * path literal, query/body/output types and whether it streams — plus a
+ * runtime `routes` descriptor object for that same list.
+ *
+ * The transport itself is deliberately NOT generated: a ~90-line handwritten
+ * client (`createRestClient`) consumes any route map. Types change with every API
+ * edit and are regenerated; the client never changes at all.
+ */
+type JsonSchema = {
+    $ref?: string;
+    type?: string | string[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    const?: unknown;
+    enum?: unknown[];
+    items?: JsonSchema;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+};
+/** JSON-schema subset → TypeScript type expression, with $refs inlined. */
+export declare function schemaToType(schema: JsonSchema | undefined, components?: Record<string, JsonSchema>, depth?: number): string;
+/**
+ * Deterministic operation names from the path shape:
+ * `/api/posts` GET → `postsList`; `/api/posts/{id}` PATCH → `postsUpdate`;
+ * `/api/posts/live` GET → `postsLive`; `/api/enrich` POST → `enrichCreate`.
+ */
+export declare function operationName(path: string, method: string): string;
+export declare function generateRouteMap(input: unknown): string;
+export {};
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CAC5C,CAAA;AAoCD,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAM,EAC3C,KAAK,SAAI,GACR,MAAM,CA+DR;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBlE;AA+FD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwDvD"}

package/dist/codegen.js

@@ -0,0 +1,235 @@
+/**
+ * Typed route-map generation from the app's OpenAPI document.
+ *
+ * `generateRouteMap` turns `/api/openapi.json` into a small standalone module:
+ * an `ApiRoutes` type — one `Op` entry per operation, carrying its method,
+ * path literal, query/body/output types and whether it streams — plus a
+ * runtime `routes` descriptor object for that same list.
+ *
+ * The transport itself is deliberately NOT generated: a ~90-line handwritten
+ * client (`createRestClient`) consumes any route map. Types change with every API
+ * edit and are regenerated; the client never changes at all.
+ */
+function pascal(value) {
+    return value
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part[0].toUpperCase() + part.slice(1))
+        .join('');
+}
+function camel(value) {
+    const asPascal = pascal(value);
+    return asPascal ? asPascal[0].toLowerCase() + asPascal.slice(1) : 'root';
+}
+/** JSON-schema subset → TypeScript type expression, with $refs inlined. */
+export function schemaToType(schema, components = {}, depth = 0) {
+    if (!schema || depth > 4)
+        return 'unknown';
+    if (schema.$ref) {
+        const name = schema.$ref.split('/').pop() ?? '';
+        return schemaToType(components[name], components, depth + 1);
+    }
+    if (schema.const !== undefined)
+        return JSON.stringify(schema.const);
+    if (schema.enum) {
+        return [...new Set(schema.enum.map((value) => JSON.stringify(value)))].join(' | ');
+    }
+    const variants = schema.anyOf ?? schema.oneOf;
+    if (variants) {
+        const members = [
+            ...new Set(variants.map((member) => schemaToType(member, components, depth))),
+        ];
+        const withoutNull = members.filter((member) => member !== 'null');
+        const joined = withoutNull.join(' | ');
+        const core = withoutNull.length > 1 ? `(${joined})` : joined || 'unknown';
+        return members.length !== withoutNull.length ? `${core} | null` : core;
+    }
+    if (schema.allOf) {
+        return schema.allOf
+            .map((member) => schemaToType(member, components, depth))
+            .join(' & ');
+    }
+    if (Array.isArray(schema.type)) {
+        return schema.type
+            .map((entry) => (entry === 'integer' ? 'number' : entry))
+            .join(' | ');
+    }
+    switch (schema.type) {
+        case 'string':
+            return 'string';
+        case 'integer':
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        case 'array':
+            return `${schemaToType(schema.items, components, depth)}[]`;
+        case 'object': {
+            const properties = schema.properties ?? {};
+            const required = new Set(schema.required ?? []);
+            if (Object.keys(properties).length === 0) {
+                return schema.additionalProperties === false
+                    ? 'Record<string, never>'
+                    : 'Record<string, unknown>';
+            }
+            const fields = Object.entries(properties).map(([key, child]) => {
+                const optional = required.has(key) ? '' : '?';
+                return `${JSON.stringify(key)}${optional}: ${schemaToType(child, components, depth)}`;
+            });
+            return `{ ${fields.join('; ')} }`;
+        }
+        default:
+            return 'unknown';
+    }
+}
+const METHOD_ACTIONS = {
+    get: 'Get',
+    post: 'Create',
+    patch: 'Update',
+    put: 'Update',
+    delete: 'Delete',
+};
+/**
+ * Deterministic operation names from the path shape:
+ * `/api/posts` GET → `postsList`; `/api/posts/{id}` PATCH → `postsUpdate`;
+ * `/api/posts/live` GET → `postsLive`; `/api/enrich` POST → `enrichCreate`.
+ */
+export function operationName(path, method) {
+    const segments = path.split('/').filter(Boolean);
+    if (segments[0] === 'api')
+        segments.shift();
+    const last = segments[segments.length - 1] ?? '';
+    const action = METHOD_ACTIONS[method] ?? pascal(method);
+    if (last.startsWith('{')) {
+        return `${camel(segments.slice(0, -1).join('_'))}${action}`;
+    }
+    const statics = segments.filter((segment) => !segment.startsWith('{'));
+    if (statics.length === 1 && method === 'get')
+        return `${camel(last)}List`;
+    if (statics.length === 1 && method === 'post')
+        return `${camel(last)}Create`;
+    // A deeper static path reads as its own name (`/api/posts/live`) — the
+    // method suffix would only add noise.
+    if (method === 'get')
+        return camel(statics.join('_'));
+    return `${camel(statics.join('_'))}${action}`;
+}
+const HTTP_METHODS = ['get', 'post', 'patch', 'put', 'delete'];
+function collectOperations(spec) {
+    const components = spec.components?.schemas ?? {};
+    const operations = [];
+    for (const [path, methods] of Object.entries(spec.paths ?? {})) {
+        // Better Auth owns its client contract. Keeping auth endpoints out of the
+        // generic REST artifact avoids a second, less capable auth API surface.
+        if (path === '/api/auth' || path.startsWith('/api/auth/'))
+            continue;
+        for (const rawMethod of Object.keys(methods)) {
+            if (!HTTP_METHODS.includes(rawMethod))
+                continue;
+            const operation = methods[rawMethod];
+            if (!operation)
+                continue;
+            const parameters = operation.parameters ?? [];
+            const queryParameters = parameters.filter((parameter) => parameter.in === 'query');
+            let queryType;
+            if (queryParameters.length > 0) {
+                const fields = queryParameters.map((parameter) => {
+                    const schema = parameter.schema ?? parameter.content?.['application/json']?.schema;
+                    return `${JSON.stringify(parameter.name)}?: ${schemaToType(schema, components)}`;
+                });
+                queryType = `{ ${fields.join('; ')} }`;
+            }
+            const requestSchema = operation.requestBody?.content?.['application/json']?.schema;
+            const rawBodyType = requestSchema
+                ? schemaToType(requestSchema, components)
+                : undefined;
+            // oRPC emits an empty-object request body even for body-less
+            // procedures like DELETE; a free-form record there is noise.
+            const bodyType = rawBodyType === 'Record<string, unknown>' && rawMethod === 'delete'
+                ? undefined
+                : rawBodyType;
+            const okResponse = operation.responses?.['200'] ?? operation.responses?.['201'];
+            const jsonSchema = okResponse?.content?.['application/json']?.schema;
+            const eventSchema = okResponse?.content?.['text/event-stream']?.schema;
+            let outputType = 'void';
+            let isStream = false;
+            if (eventSchema) {
+                isStream = true;
+                // oRPC wraps each SSE data frame as {event, data}; unwrap the payload.
+                // Wrapper variants that carry no data (or map to `unknown`) would
+                // swallow the whole union, so they are dropped here.
+                const wrapper = eventSchema.oneOf ?? eventSchema.anyOf ?? [];
+                outputType =
+                    [
+                        ...new Set(wrapper
+                            .map((variant) => variant.properties?.['data'])
+                            .filter((variant) => Boolean(variant))
+                            .map((variant) => schemaToType(variant, components))
+                            .filter((type) => type !== 'unknown')),
+                    ].join(' | ') || 'void';
+            }
+            else if (jsonSchema) {
+                outputType = schemaToType(jsonSchema, components);
+            }
+            operations.push({
+                name: operationName(path, rawMethod),
+                method: rawMethod.toUpperCase(),
+                path,
+                queryType,
+                bodyType,
+                outputType,
+                isStream,
+            });
+        }
+    }
+    return operations;
+}
+export function generateRouteMap(input) {
+    const spec = input;
+    const operations = collectOperations(spec);
+    const lines = [];
+    lines.push('// Generated by workerstack codegen from /api/openapi.json.');
+    lines.push('// Regenerate with `bun run gen`; do not edit by hand.');
+    lines.push('');
+    lines.push('/** One API operation: literals describe the wire, phantoms the shapes. */');
+    lines.push('export interface Op<');
+    lines.push('  M extends string,');
+    lines.push('  P extends string,');
+    lines.push('  Query = undefined,');
+    lines.push('  Body = undefined,');
+    lines.push('  Output = void,');
+    lines.push('  Stream extends boolean = false,');
+    lines.push('> {');
+    lines.push('  method: M');
+    lines.push('  path: P');
+    lines.push('  stream: Stream');
+    lines.push('  query?: Query');
+    lines.push('  body?: Body');
+    lines.push('  output?: Output');
+    lines.push('}');
+    lines.push('');
+    lines.push('export type ApiRoutes = {');
+    const runtimeEntries = [];
+    for (const operation of operations) {
+        const generics = [
+            `'${operation.method}'`,
+            `'${operation.path}'`,
+            operation.queryType ?? 'undefined',
+            operation.bodyType ?? 'undefined',
+            operation.isStream ? operation.outputType : operation.outputType,
+            String(operation.isStream),
+        ].join(', ');
+        lines.push(`  ${operation.name}: Op<${generics}>`);
+        runtimeEntries.push(`  ${operation.name}: { method: '${operation.method}', path: '${operation.path}'${operation.isStream ? ', stream: true' : ''} },`);
+    }
+    lines.push('}');
+    lines.push('');
+    lines.push('/** Wire descriptors for createRestClient — same keys, runtime values. */');
+    lines.push('export const routes = {');
+    lines.push(...runtimeEntries);
+    lines.push('} as const');
+    return lines.join('\n');
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Typed route-map generation from the app's OpenAPI document.\n *\n * `generateRouteMap` turns `/api/openapi.json` into a small standalone module:\n * an `ApiRoutes` type — one `Op` entry per operation, carrying its method,\n * path literal, query/body/output types and whether it streams — plus a\n * runtime `routes` descriptor object for that same list.\n *\n * The transport itself is deliberately NOT generated: a ~90-line handwritten\n * client (`createRestClient`) consumes any route map. Types change with every API\n * edit and are regenerated; the client never changes at all.\n */\n\ntype JsonSchema = {\n  $ref?: string\n  type?: string | string[]\n  anyOf?: JsonSchema[]\n  oneOf?: JsonSchema[]\n  allOf?: JsonSchema[]\n  const?: unknown\n  enum?: unknown[]\n  items?: JsonSchema\n  properties?: Record<string, JsonSchema>\n  required?: string[]\n  additionalProperties?: boolean | JsonSchema\n}\n\ntype Parameter = {\n  in: string\n  name: string\n  schema?: JsonSchema\n  content?: Record<string, { schema: JsonSchema }>\n}\n\ntype Operation = {\n  parameters?: Parameter[]\n  requestBody?: { content?: Record<string, { schema: JsonSchema }> }\n  responses?: Record<\n    string,\n    { content?: Record<string, { schema: JsonSchema }> }\n  >\n}\n\ntype OpenApiSpec = {\n  paths?: Record<string, Record<string, Operation | undefined>>\n  components?: { schemas?: Record<string, JsonSchema> }\n}\n\nfunction pascal(value: string): string {\n  return value\n    .split(/[^a-zA-Z0-9]+/)\n    .filter(Boolean)\n    .map((part) => part[0]!.toUpperCase() + part.slice(1))\n    .join('')\n}\n\nfunction camel(value: string): string {\n  const asPascal = pascal(value)\n  return asPascal ? asPascal[0]!.toLowerCase() + asPascal.slice(1) : 'root'\n}\n\n/** JSON-schema subset → TypeScript type expression, with $refs inlined. */\nexport function schemaToType(\n  schema: JsonSchema | undefined,\n  components: Record<string, JsonSchema> = {},\n  depth = 0,\n): string {\n  if (!schema || depth > 4) return 'unknown'\n  if (schema.$ref) {\n    const name = schema.$ref.split('/').pop() ?? ''\n    return schemaToType(components[name], components, depth + 1)\n  }\n  if (schema.const !== undefined) return JSON.stringify(schema.const)\n  if (schema.enum) {\n    return [...new Set(schema.enum.map((value) => JSON.stringify(value)))].join(\n      ' | ',\n    )\n  }\n  const variants = schema.anyOf ?? schema.oneOf\n  if (variants) {\n    const members = [\n      ...new Set(\n        variants.map((member) => schemaToType(member, components, depth)),\n      ),\n    ]\n    const withoutNull = members.filter((member) => member !== 'null')\n    const joined = withoutNull.join(' | ')\n    const core = withoutNull.length > 1 ? `(${joined})` : joined || 'unknown'\n    return members.length !== withoutNull.length ? `${core} | null` : core\n  }\n  if (schema.allOf) {\n    return schema.allOf\n      .map((member) => schemaToType(member, components, depth))\n      .join(' & ')\n  }\n  if (Array.isArray(schema.type)) {\n    return schema.type\n      .map((entry) => (entry === 'integer' ? 'number' : entry))\n      .join(' | ')\n  }\n  switch (schema.type) {\n    case 'string':\n      return 'string'\n    case 'integer':\n    case 'number':\n      return 'number'\n    case 'boolean':\n      return 'boolean'\n    case 'null':\n      return 'null'\n    case 'array':\n      return `${schemaToType(schema.items, components, depth)}[]`\n    case 'object': {\n      const properties = schema.properties ?? {}\n      const required = new Set(schema.required ?? [])\n      if (Object.keys(properties).length === 0) {\n        return schema.additionalProperties === false\n          ? 'Record<string, never>'\n          : 'Record<string, unknown>'\n      }\n      const fields = Object.entries(properties).map(([key, child]) => {\n        const optional = required.has(key) ? '' : '?'\n        return `${JSON.stringify(key)}${optional}: ${schemaToType(child, components, depth)}`\n      })\n      return `{ ${fields.join('; ')} }`\n    }\n    default:\n      return 'unknown'\n  }\n}\n\nconst METHOD_ACTIONS: Record<string, string> = {\n  get: 'Get',\n  post: 'Create',\n  patch: 'Update',\n  put: 'Update',\n  delete: 'Delete',\n}\n\n/**\n * Deterministic operation names from the path shape:\n * `/api/posts` GET → `postsList`; `/api/posts/{id}` PATCH → `postsUpdate`;\n * `/api/posts/live` GET → `postsLive`; `/api/enrich` POST → `enrichCreate`.\n */\nexport function operationName(path: string, method: string): string {\n  const segments = path.split('/').filter(Boolean)\n  if (segments[0] === 'api') segments.shift()\n  const last = segments[segments.length - 1] ?? ''\n  const action = METHOD_ACTIONS[method] ?? pascal(method)\n\n  if (last.startsWith('{')) {\n    return `${camel(segments.slice(0, -1).join('_'))}${action}`\n  }\n  const statics = segments.filter((segment) => !segment.startsWith('{'))\n  if (statics.length === 1 && method === 'get') return `${camel(last)}List`\n  if (statics.length === 1 && method === 'post') return `${camel(last)}Create`\n  // A deeper static path reads as its own name (`/api/posts/live`) — the\n  // method suffix would only add noise.\n  if (method === 'get') return camel(statics.join('_'))\n  return `${camel(statics.join('_'))}${action}`\n}\n\ntype EmittedOperation = {\n  name: string\n  method: string\n  path: string\n  queryType?: string\n  bodyType?: string\n  outputType: string\n  isStream: boolean\n}\n\nconst HTTP_METHODS = ['get', 'post', 'patch', 'put', 'delete']\n\nfunction collectOperations(spec: OpenApiSpec): EmittedOperation[] {\n  const components = spec.components?.schemas ?? {}\n  const operations: EmittedOperation[] = []\n\n  for (const [path, methods] of Object.entries(spec.paths ?? {})) {\n    // Better Auth owns its client contract. Keeping auth endpoints out of the\n    // generic REST artifact avoids a second, less capable auth API surface.\n    if (path === '/api/auth' || path.startsWith('/api/auth/')) continue\n    for (const rawMethod of Object.keys(methods)) {\n      if (!HTTP_METHODS.includes(rawMethod)) continue\n      const operation = methods[rawMethod]\n      if (!operation) continue\n\n      const parameters = operation.parameters ?? []\n      const queryParameters = parameters.filter(\n        (parameter) => parameter.in === 'query',\n      )\n\n      let queryType: string | undefined\n      if (queryParameters.length > 0) {\n        const fields = queryParameters.map((parameter) => {\n          const schema =\n            parameter.schema ?? parameter.content?.['application/json']?.schema\n          return `${JSON.stringify(parameter.name)}?: ${schemaToType(schema, components)}`\n        })\n        queryType = `{ ${fields.join('; ')} }`\n      }\n\n      const requestSchema =\n        operation.requestBody?.content?.['application/json']?.schema\n      const rawBodyType = requestSchema\n        ? schemaToType(requestSchema, components)\n        : undefined\n      // oRPC emits an empty-object request body even for body-less\n      // procedures like DELETE; a free-form record there is noise.\n      const bodyType =\n        rawBodyType === 'Record<string, unknown>' && rawMethod === 'delete'\n          ? undefined\n          : rawBodyType\n\n      const okResponse =\n        operation.responses?.['200'] ?? operation.responses?.['201']\n      const jsonSchema = okResponse?.content?.['application/json']?.schema\n      const eventSchema = okResponse?.content?.['text/event-stream']?.schema\n\n      let outputType = 'void'\n      let isStream = false\n      if (eventSchema) {\n        isStream = true\n        // oRPC wraps each SSE data frame as {event, data}; unwrap the payload.\n        // Wrapper variants that carry no data (or map to `unknown`) would\n        // swallow the whole union, so they are dropped here.\n        const wrapper = eventSchema.oneOf ?? eventSchema.anyOf ?? []\n        outputType =\n          [\n            ...new Set(\n              wrapper\n                .map((variant) => variant.properties?.['data'])\n                .filter((variant): variant is JsonSchema => Boolean(variant))\n                .map((variant) => schemaToType(variant, components))\n                .filter((type) => type !== 'unknown'),\n            ),\n          ].join(' | ') || 'void'\n      } else if (jsonSchema) {\n        outputType = schemaToType(jsonSchema, components)\n      }\n\n      operations.push({\n        name: operationName(path, rawMethod),\n        method: rawMethod.toUpperCase(),\n        path,\n        queryType,\n        bodyType,\n        outputType,\n        isStream,\n      })\n    }\n  }\n  return operations\n}\n\nexport function generateRouteMap(input: unknown): string {\n  const spec = input as OpenApiSpec\n  const operations = collectOperations(spec)\n\n  const lines: string[] = []\n  lines.push('// Generated by workerstack codegen from /api/openapi.json.')\n  lines.push('// Regenerate with `bun run gen`; do not edit by hand.')\n  lines.push('')\n  lines.push(\n    '/** One API operation: literals describe the wire, phantoms the shapes. */',\n  )\n  lines.push('export interface Op<')\n  lines.push('  M extends string,')\n  lines.push('  P extends string,')\n  lines.push('  Query = undefined,')\n  lines.push('  Body = undefined,')\n  lines.push('  Output = void,')\n  lines.push('  Stream extends boolean = false,')\n  lines.push('> {')\n  lines.push('  method: M')\n  lines.push('  path: P')\n  lines.push('  stream: Stream')\n  lines.push('  query?: Query')\n  lines.push('  body?: Body')\n  lines.push('  output?: Output')\n  lines.push('}')\n  lines.push('')\n  lines.push('export type ApiRoutes = {')\n\n  const runtimeEntries: string[] = []\n  for (const operation of operations) {\n    const generics = [\n      `'${operation.method}'`,\n      `'${operation.path}'`,\n      operation.queryType ?? 'undefined',\n      operation.bodyType ?? 'undefined',\n      operation.isStream ? operation.outputType : operation.outputType,\n      String(operation.isStream),\n    ].join(', ')\n    lines.push(`  ${operation.name}: Op<${generics}>`)\n    runtimeEntries.push(\n      `  ${operation.name}: { method: '${operation.method}', path: '${operation.path}'${\n        operation.isStream ? ', stream: true' : ''\n      } },`,\n    )\n  }\n  lines.push('}')\n  lines.push('')\n  lines.push(\n    '/** Wire descriptors for createRestClient — same keys, runtime values. */',\n  )\n  lines.push('export const routes = {')\n  lines.push(...runtimeEntries)\n  lines.push('} as const')\n\n  return lines.join('\\n')\n}\n"]}

package/dist/config.d.ts

@@ -0,0 +1,129 @@
+import type { AnyMiddleware, AnyRouter } from '@orpc/server';
+import { betterAuth } from 'better-auth';
+import type { AuthSessionResolver, SessionUserConfig, SessionUserExtraOf, TableAccessInput } from './access.js';
+import type { WorkerstackApiBuilder } from './api/builder.js';
+import type { DatabaseAdapter } from './database/adapter.js';
+import type { DbFor } from './db.js';
+import type { AnyDb } from './dialect.js';
+import type { IdempotencyConfig } from './idempotency.js';
+import type { MessagingConfig } from './messaging/index.js';
+import type { RateLimitConfig } from './rate-limit.js';
+import { type BaseEnv, type EnvConfigInput, type ValidatedEnv } from './env.js';
+import { type ResolvedStorageBuckets, type StorageConfigInput } from './storage/buckets.js';
+export type BetterAuthConfig = Omit<NonNullable<Parameters<typeof betterAuth>[0]>, 'database'>;
+/**
+ * What an `auth` builder is handed. `db` is the app's own connection, typed
+ * from `schema` alone — that is what keeps the builder cycle-free: better-auth
+ * hooks living in another file get a db without importing the app whose type
+ * they help produce.
+ */
+export type AuthConfigContext<TSchema extends Record<string, unknown>, TEnv extends EnvConfigInput | undefined = undefined> = {
+    db: DbFor<TSchema>;
+    env: ValidatedEnv<TEnv>;
+};
+export type AuthConfigInput<TSchema extends Record<string, unknown>, TEnv extends EnvConfigInput | undefined = undefined, TConfig extends BetterAuthConfig = BetterAuthConfig> = TConfig | ((ctx: AuthConfigContext<TSchema, TEnv>) => TConfig);
+/**
+ * Identity helper for defining an auth config in a separate file with full
+ * type inference — no explicit generic annotations required.
+ *
+ * Follows the `defineConfig` / `defineComponent` ecosystem convention:
+ * the function does nothing at runtime but gives TypeScript an inference
+ * anchor through the `schema` parameter.
+ *
+ * @example
+ * ```ts
+ * // Static config (no db/env access needed)
+ * export const authConfig = defineAuth({ ... })
+ *
+ * // Builder with schema-typed db
+ * export const authConfig = defineAuth(schema, ({ db }) => ({
+ *   databaseHooks: {
+ *     user: { create: { after: async (user) => { await db.insert(...) } } }
+ *   }
+ * }))
+ * ```
+ */
+export declare function defineAuth<const TConfig extends BetterAuthConfig>(config: TConfig): TConfig;
+export declare function defineAuth<TSchema extends Record<string, unknown>, TEnv extends EnvConfigInput | undefined, const TConfig extends BetterAuthConfig>(context: {
+    schema: TSchema;
+    env: TEnv;
+}, builder: (ctx: AuthConfigContext<TSchema, TEnv>) => TConfig): (ctx: AuthConfigContext<TSchema, TEnv>) => TConfig;
+export declare function defineAuth<TSchema extends Record<string, unknown>, const TConfig extends BetterAuthConfig, TEnv extends EnvConfigInput | undefined = undefined>(schema: TSchema, builder: (ctx: AuthConfigContext<TSchema, TEnv>) => TConfig): (ctx: AuthConfigContext<TSchema, TEnv>) => TConfig;
+/**
+ * The builder as {@link ResolvedConfig} carries it: schema-agnostic, because
+ * ResolvedConfig is not generic. {@link resolveAuthConfig} is the only caller.
+ */
+export type AuthConfigFactory = (ctx: {
+    db: AnyDb;
+    env: BaseEnv;
+}) => BetterAuthConfig;
+/** Realtime declaration. Independent of schema, storage, and env. */
+export type RealtimeConfigInput = boolean | {
+    bufferSize?: number;
+    resumeSeconds?: number;
+};
+export type WorkerstackConfig<TSchema extends Record<string, unknown>, TAccess extends Record<string, TableAccessInput> | undefined = Record<string, TableAccessInput> | undefined, TStorage extends StorageConfigInput | undefined = StorageConfigInput | undefined, TEnv extends EnvConfigInput | undefined = EnvConfigInput | undefined, TCustomApiRouter extends AnyRouter | undefined = AnyRouter | undefined, TAuthConfig extends BetterAuthConfig = BetterAuthConfig, TSession extends SessionUserConfig<Record<string, unknown>> | undefined = undefined> = {
+    schema: TSchema;
+    access?: TAccess;
+    database: {
+        adapter: DatabaseAdapter;
+        url?: string;
+        authToken?: string;
+        migrations?: string;
+    };
+    /**
+     * better-auth options, or a builder receiving `{ db, env }`. Use the builder
+     * form when database hooks need to write: it hands out the app's own
+     * connection, so the application never opens a second one just to satisfy a
+     * config that is built before the app exists.
+     */
+    auth?: AuthConfigInput<NoInfer<TSchema>, NoInfer<TEnv>, TAuthConfig>;
+    /**
+     * Reuse an application-owned session reader for the unified API while
+     * keeping Workerstack's auth handler available.
+     */
+    authResolver?: AuthSessionResolver<SessionUserExtraOf<TSession>>;
+    /** Explicitly project application fields from Better Auth into API users. */
+    session?: TSession;
+    storage?: TStorage;
+    messaging?: MessagingConfig;
+    /**
+     * The application's oRPC router. Pass the finished router object, or a
+     * callback when the router needs the framework builder at configuration
+     * time. Declare the router at module scope with `defineApi` and the object
+     * form keeps router modules free of factory wrappers.
+     */
+    api?: TCustomApiRouter | ((builder: WorkerstackApiBuilder<TSchema, ValidatedEnv<TEnv>, MessagingConfig, SessionUserExtraOf<TSession>>) => TCustomApiRouter);
+    /**
+     * Middleware applied to every procedure in the graph: generated CRUD,
+     * storage, realtime, health, and the application's own procedures. Declare
+     * each one with `o.middleware(...)` from `defineApi`.
+     *
+     * It runs before authentication, so `context.user` is not available inside
+     * it. Read an already-resolved caller with `context.peekSession()`.
+     */
+    middleware?: AnyMiddleware[];
+    rateLimit?: boolean | RateLimitConfig;
+    idempotency?: boolean | IdempotencyConfig;
+    /** Generate and serve `/api/openapi.json`. Disabled by default. */
+    openapi?: boolean;
+    realtime?: RealtimeConfigInput;
+};
+export type ResolvedConfig = {
+    database: {
+        adapter: DatabaseAdapter;
+        url: string;
+        authToken?: string;
+        migrations: string;
+    };
+    auth: BetterAuthConfig | AuthConfigFactory;
+    storage: ResolvedStorageBuckets;
+    realtime?: RealtimeConfigInput;
+};
+export declare function resolveConfig<TSchema extends Record<string, unknown>, TAccess extends Record<string, TableAccessInput> | undefined = undefined, TStorage extends StorageConfigInput | undefined = undefined, TEnv extends EnvConfigInput | undefined = undefined, TCustomApiRouter extends AnyRouter | undefined = undefined, TAuthConfig extends BetterAuthConfig = BetterAuthConfig, TSession extends SessionUserConfig<Record<string, unknown>> | undefined = undefined>(options: WorkerstackConfig<TSchema, TAccess, TStorage, TEnv, TCustomApiRouter, TAuthConfig, TSession>, env?: BaseEnv, platformSource?: Record<string, string | undefined>): ResolvedConfig;
+/** Collapse the object/builder union once the db is up. */
+export declare function resolveAuthConfig(auth: ResolvedConfig['auth'], ctx: {
+    db: AnyDb;
+    env: BaseEnv;
+}): BetterAuthConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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