workerstack 0.1.0-beta.0

package/dist/sync/realtime-sync.d.ts

@@ -0,0 +1,31 @@
+import { type RealtimeProcedure, type RealtimeSyncHandle } from '../client/realtime.js';
+type SyncableCollection = {
+    utils: {
+        writeUpsert(item: unknown): void;
+        writeDelete(key: unknown): void;
+        refetch(): Promise<void>;
+    };
+};
+export type SyncRealtimeTarget = {
+    applyRealtimeEvent(action: 'create' | 'update' | 'delete', record: Record<string, unknown>): void;
+    refetchAll(): Promise<void>;
+};
+export type SyncRealtimeConfig = {
+    api: {
+        realtime: {
+            changes: RealtimeProcedure;
+        };
+    };
+    tables: string[];
+    collections?: Record<string, SyncableCollection>;
+    resolve?: (table: string) => SyncRealtimeTarget | undefined;
+    resolveAll?: () => Iterable<SyncRealtimeTarget>;
+    signal?: AbortSignal;
+    retryMs?: number;
+    maxRetryMs?: number;
+    onError?: (error: unknown) => void;
+};
+/** TanStack DB consumes the shared raw stream without a QueryClient detour. */
+export declare function createSyncRealtimeClient(config: SyncRealtimeConfig): RealtimeSyncHandle;
+export {};
+//# sourceMappingURL=realtime-sync.d.ts.map

package/dist/sync/realtime-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sync.d.ts","sourceRoot":"","sources":["../../src/sync/realtime-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAA;AAE3B,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE;QACL,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;QAChC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KACzB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kBAAkB,CAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAAA;IACP,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE;QAAE,QAAQ,EAAE;YAAE,OAAO,EAAE,iBAAiB,CAAA;SAAE,CAAA;KAAE,CAAA;IACjD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAA;IAC3D,UAAU,CAAC,EAAE,MAAM,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAAA;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAoDpB"}

package/dist/sync/realtime-sync.js

@@ -0,0 +1,46 @@
+import { openRealtimeStream, } from '../client/realtime.js';
+/** TanStack DB consumes the shared raw stream without a QueryClient detour. */
+export function createSyncRealtimeClient(config) {
+    const collections = config.collections ?? {};
+    const caller = new AbortController();
+    const signal = config.signal
+        ? AbortSignal.any([caller.signal, config.signal])
+        : caller.signal;
+    const stream = openRealtimeStream({
+        signal,
+        retryMs: config.retryMs,
+        maxRetryMs: config.maxRetryMs,
+        onError: config.onError,
+        subscribe: ({ signal, lastEventId }) => config.api.realtime.changes.call({ tables: config.tables }, { signal, lastEventId }),
+        onChange: (event) => {
+            if (config.resolve) {
+                config
+                    .resolve(event.table)
+                    ?.applyRealtimeEvent(event.action, event.record);
+                return;
+            }
+            const collection = collections[event.table];
+            if (!collection)
+                return;
+            if (event.action === 'delete')
+                collection.utils.writeDelete(event.record['id']);
+            else
+                collection.utils.writeUpsert(event.record);
+        },
+        onReconnect: async () => {
+            if (config.resolveAll) {
+                await Promise.all([...config.resolveAll()].map((target) => target.refetchAll()));
+                return;
+            }
+            await Promise.all(Object.values(collections).map((collection) => collection.utils.refetch()));
+        },
+    });
+    return {
+        close() {
+            caller.abort();
+            stream.close();
+        },
+        done: stream.done,
+    };
+}
+//# sourceMappingURL=realtime-sync.js.map

package/dist/sync/realtime-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sync.js","sourceRoot":"","sources":["../../src/sync/realtime-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAA;AA8B3B,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB,CACtC,MAA0B;IAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAA;IAC5C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM;QAC1B,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IAEjB,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAC9B,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EACzB,EAAE,MAAM,EAAE,WAAW,EAAE,CACxB;QACH,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM;qBACH,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;oBACrB,EAAE,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;gBAClD,OAAM;YACR,CAAC;YACD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC3C,IAAI,CAAC,UAAU;gBAAE,OAAM;YACvB,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAC3B,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;;gBAC7C,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACjD,CAAC;QACD,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAC9D,CAAA;gBACD,OAAM;YACR,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAC5C,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAC3B,CACF,CAAA;QACH,CAAC;KACF,CAAC,CAAA;IAEF,OAAO;QACL,KAAK;YACH,MAAM,CAAC,KAAK,EAAE,CAAA;YACd,MAAM,CAAC,KAAK,EAAE,CAAA;QAChB,CAAC;QACD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC","sourcesContent":["import {\n  openRealtimeStream,\n  type RealtimeProcedure,\n  type RealtimeSyncHandle,\n} from '../client/realtime'\n\ntype SyncableCollection = {\n  utils: {\n    writeUpsert(item: unknown): void\n    writeDelete(key: unknown): void\n    refetch(): Promise<void>\n  }\n}\n\nexport type SyncRealtimeTarget = {\n  applyRealtimeEvent(\n    action: 'create' | 'update' | 'delete',\n    record: Record<string, unknown>,\n  ): void\n  refetchAll(): Promise<void>\n}\n\nexport type SyncRealtimeConfig = {\n  api: { realtime: { changes: RealtimeProcedure } }\n  tables: string[]\n  collections?: Record<string, SyncableCollection>\n  resolve?: (table: string) => SyncRealtimeTarget | undefined\n  resolveAll?: () => Iterable<SyncRealtimeTarget>\n  signal?: AbortSignal\n  retryMs?: number\n  maxRetryMs?: number\n  onError?: (error: unknown) => void\n}\n\n/** TanStack DB consumes the shared raw stream without a QueryClient detour. */\nexport function createSyncRealtimeClient(\n  config: SyncRealtimeConfig,\n): RealtimeSyncHandle {\n  const collections = config.collections ?? {}\n  const caller = new AbortController()\n  const signal = config.signal\n    ? AbortSignal.any([caller.signal, config.signal])\n    : caller.signal\n\n  const stream = openRealtimeStream({\n    signal,\n    retryMs: config.retryMs,\n    maxRetryMs: config.maxRetryMs,\n    onError: config.onError,\n    subscribe: ({ signal, lastEventId }) =>\n      config.api.realtime.changes.call(\n        { tables: config.tables },\n        { signal, lastEventId },\n      ),\n    onChange: (event) => {\n      if (config.resolve) {\n        config\n          .resolve(event.table)\n          ?.applyRealtimeEvent(event.action, event.record)\n        return\n      }\n      const collection = collections[event.table]\n      if (!collection) return\n      if (event.action === 'delete')\n        collection.utils.writeDelete(event.record['id'])\n      else collection.utils.writeUpsert(event.record)\n    },\n    onReconnect: async () => {\n      if (config.resolveAll) {\n        await Promise.all(\n          [...config.resolveAll()].map((target) => target.refetchAll()),\n        )\n        return\n      }\n      await Promise.all(\n        Object.values(collections).map((collection) =>\n          collection.utils.refetch(),\n        ),\n      )\n    },\n  })\n\n  return {\n    close() {\n      caller.abort()\n      stream.close()\n    },\n    done: stream.done,\n  }\n}\n"]}

package/dist/sync/sync-client.d.ts

@@ -0,0 +1,28 @@
+import type { QueryClient } from '@tanstack/react-query';
+import { type AnyWorkerstackApp, type WorkerstackClient, type InferInsert, type InferSchema, type InferSelect, type InferTables } from '../query/index.js';
+import { type TableCollection } from './collection.js';
+export type RowFor<TSchema extends Record<string, unknown>, K extends keyof TSchema> = [InferSelect<TSchema[K]>] extends [never] ? {
+    id: string | number;
+} : InferSelect<TSchema[K]> extends {
+    id: string | number;
+} ? InferSelect<TSchema[K]> : {
+    id: string | number;
+};
+export type CreateFor<TSchema extends Record<string, unknown>, K extends keyof TSchema> = [InferInsert<TSchema[K]>] extends [never] ? Partial<RowFor<TSchema, K>> : InferInsert<TSchema[K]>;
+export type SyncClientOptions = {
+    baseUrl?: string;
+    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    queryClient: QueryClient;
+    realtime?: boolean;
+};
+export type WorkerstackSyncClient<TApp extends AnyWorkerstackApp> = {
+    [K in InferTables<TApp>]: TableCollection<RowFor<InferSchema<TApp>, K>, CreateFor<InferSchema<TApp>, K>, Partial<RowFor<InferSchema<TApp>, K>>>;
+} & {
+    files: WorkerstackClient<TApp>['files'];
+    realtime: {
+        close(): void;
+        subscribe(tables: string[]): Promise<void>;
+    } | undefined;
+};
+export declare function createSyncClient<TApp extends AnyWorkerstackApp>(options: SyncClientOptions): WorkerstackSyncClient<TApp>;
+//# sourceMappingURL=sync-client.d.ts.map

package/dist/sync/sync-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.d.ts","sourceRoot":"","sources":["../../src/sync/sync-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAM1E,MAAM,MAAM,MAAM,CAChB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,MAAM,OAAO,IACrB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACzC;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACvB,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACrD,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACvB;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAA;AAE7B,MAAM,MAAM,SAAS,CACnB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,MAAM,OAAO,IACrB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAC3B,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAE3B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3E,WAAW,EAAE,WAAW,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,qBAAqB,CAAC,IAAI,SAAS,iBAAiB,IAAI;KACjE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,eAAe,CACvC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAC5B,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAC/B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CACtC;CACF,GAAG;IACF,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;IACvC,QAAQ,EACJ;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAC7D,SAAS,CAAA;CACd,CAAA;AAED,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,EAAE,iBAAiB,GACzB,qBAAqB,CAAC,IAAI,CAAC,CA+C7B"}

package/dist/sync/sync-client.js

@@ -0,0 +1,52 @@
+import { createClient, } from '../query/index.js';
+import { createTableCollection } from './collection.js';
+import { createSyncRealtimeClient, } from './realtime-sync.js';
+export function createSyncClient(options) {
+    const api = createClient(options);
+    const materialized = new Map();
+    const realtimeHandles = new Map();
+    const tables = new Map();
+    const realtimeEnabled = options.realtime ?? typeof window !== 'undefined';
+    const result = new Proxy({}, {
+        get(_target, property) {
+            if (typeof property !== 'string')
+                return undefined;
+            if (property === 'files')
+                return api.files;
+            if (property === 'realtime') {
+                return realtimeEnabled
+                    ? {
+                        close: () => realtimeHandles.forEach((handle) => handle.close()),
+                        subscribe: async (names) => {
+                            for (const name of names)
+                                void result[name];
+                        },
+                    }
+                    : undefined;
+            }
+            if (['then', 'toJSON', 'constructor', '$$typeof'].includes(property))
+                return undefined;
+            const cached = tables.get(property);
+            if (cached)
+                return cached;
+            const collection = createTableCollection({
+                tableName: property,
+                procedures: api[property],
+                queryClient: options.queryClient,
+            });
+            tables.set(property, collection);
+            materialized.set(property, collection);
+            if (realtimeEnabled) {
+                realtimeHandles.set(property, createSyncRealtimeClient({
+                    api: api,
+                    tables: [property],
+                    resolve: (table) => materialized.get(table),
+                    resolveAll: () => materialized.values(),
+                }));
+            }
+            return collection;
+        },
+    });
+    return result;
+}
+//# sourceMappingURL=sync-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.js","sourceRoot":"","sources":["../../src/sync/sync-client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,GAOb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,qBAAqB,EAAwB,MAAM,cAAc,CAAA;AAC1E,OAAO,EACL,wBAAwB,GAEzB,MAAM,iBAAiB,CAAA;AAsCxB,MAAM,UAAU,gBAAgB,CAC9B,OAA0B;IAE1B,MAAM,GAAG,GAAG,YAAY,CAAO,OAAO,CAAC,CAAA;IACvC,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAA;IAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,EAA6B,CAAA;IAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAA;IACzC,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,MAAM,KAAK,WAAW,CAAA;IAEzE,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,EAAiC,EAAE;QAC1D,GAAG,CAAC,OAAO,EAAE,QAAQ;YACnB,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAClD,IAAI,QAAQ,KAAK,OAAO;gBAAE,OAAO,GAAG,CAAC,KAAK,CAAA;YAC1C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC5B,OAAO,eAAe;oBACpB,CAAC,CAAC;wBACE,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;wBAChE,SAAS,EAAE,KAAK,EAAE,KAAe,EAAE,EAAE;4BACnC,KAAK,MAAM,IAAI,IAAI,KAAK;gCAAE,KAAM,MAAc,CAAC,IAAI,CAAC,CAAA;wBACtD,CAAC;qBACF;oBACH,CAAC,CAAC,SAAS,CAAA;YACf,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAClE,OAAO,SAAS,CAAA;YAClB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACnC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;YACzB,MAAM,UAAU,GAAG,qBAAqB,CAAC;gBACvC,SAAS,EAAE,QAAQ;gBACnB,UAAU,EAAG,GAAW,CAAC,QAAQ,CAAC;gBAClC,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;YAChC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;YACtC,IAAI,eAAe,EAAE,CAAC;gBACpB,eAAe,CAAC,GAAG,CACjB,QAAQ,EACR,wBAAwB,CAAC;oBACvB,GAAG,EAAE,GAAU;oBACf,MAAM,EAAE,CAAC,QAAQ,CAAC;oBAClB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;oBAC3C,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE;iBACxC,CAAC,CACH,CAAA;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import type { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createClient,\n  type AnyWorkerstackApp,\n  type WorkerstackClient,\n  type InferInsert,\n  type InferSchema,\n  type InferSelect,\n  type InferTables,\n} from '../query/index'\nimport { createTableCollection, type TableCollection } from './collection'\nimport {\n  createSyncRealtimeClient,\n  type SyncRealtimeTarget,\n} from './realtime-sync'\n\nexport type RowFor<\n  TSchema extends Record<string, unknown>,\n  K extends keyof TSchema,\n> = [InferSelect<TSchema[K]>] extends [never]\n  ? { id: string | number }\n  : InferSelect<TSchema[K]> extends { id: string | number }\n    ? InferSelect<TSchema[K]>\n    : { id: string | number }\n\nexport type CreateFor<\n  TSchema extends Record<string, unknown>,\n  K extends keyof TSchema,\n> = [InferInsert<TSchema[K]>] extends [never]\n  ? Partial<RowFor<TSchema, K>>\n  : InferInsert<TSchema[K]>\n\nexport type SyncClientOptions = {\n  baseUrl?: string\n  fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>\n  queryClient: QueryClient\n  realtime?: boolean\n}\n\nexport type WorkerstackSyncClient<TApp extends AnyWorkerstackApp> = {\n  [K in InferTables<TApp>]: TableCollection<\n    RowFor<InferSchema<TApp>, K>,\n    CreateFor<InferSchema<TApp>, K>,\n    Partial<RowFor<InferSchema<TApp>, K>>\n  >\n} & {\n  files: WorkerstackClient<TApp>['files']\n  realtime:\n    | { close(): void; subscribe(tables: string[]): Promise<void> }\n    | undefined\n}\n\nexport function createSyncClient<TApp extends AnyWorkerstackApp>(\n  options: SyncClientOptions,\n): WorkerstackSyncClient<TApp> {\n  const api = createClient<TApp>(options)\n  const materialized = new Map<string, SyncRealtimeTarget>()\n  const realtimeHandles = new Map<string, { close(): void }>()\n  const tables = new Map<string, unknown>()\n  const realtimeEnabled = options.realtime ?? typeof window !== 'undefined'\n\n  const result = new Proxy({} as WorkerstackSyncClient<TApp>, {\n    get(_target, property) {\n      if (typeof property !== 'string') return undefined\n      if (property === 'files') return api.files\n      if (property === 'realtime') {\n        return realtimeEnabled\n          ? {\n              close: () => realtimeHandles.forEach((handle) => handle.close()),\n              subscribe: async (names: string[]) => {\n                for (const name of names) void (result as any)[name]\n              },\n            }\n          : undefined\n      }\n      if (['then', 'toJSON', 'constructor', '$$typeof'].includes(property))\n        return undefined\n      const cached = tables.get(property)\n      if (cached) return cached\n      const collection = createTableCollection({\n        tableName: property,\n        procedures: (api as any)[property],\n        queryClient: options.queryClient,\n      })\n      tables.set(property, collection)\n      materialized.set(property, collection)\n      if (realtimeEnabled) {\n        realtimeHandles.set(\n          property,\n          createSyncRealtimeClient({\n            api: api as any,\n            tables: [property],\n            resolve: (table) => materialized.get(table),\n            resolveAll: () => materialized.values(),\n          }),\n        )\n      }\n      return collection\n    },\n  })\n  return result\n}\n"]}

package/dist/sync/update-queue.d.ts

@@ -0,0 +1,27 @@
+/** Per-key coalescing queue for high-frequency row updates.
+ *
+ * Cursor-shaped workloads call `collection.update()` many times a second. Sent
+ * one-for-one, each call is a request, a database write and a broadcast. This
+ * queue holds a single merged slot per row key: while a request is in flight,
+ * further updates for that key merge into the slot and go out as one follow-up
+ * once it lands. Request frequency settles at `min(update rate, 1/RTT)` without
+ * a tuned throttle constant, and the optimistic UI is untouched — only the
+ * network is coalesced.
+ */
+export type UpdateQueueConfig<TKey, TRow> = {
+    /** Sends one merged batch of changes and resolves with the canonical row. */
+    send: (key: TKey, changes: Record<string, unknown>) => Promise<TRow>;
+    /** Called with the server's row before the batch's waiters resolve. Awaited,
+     * so a handler that needs to recover (refetch) finishes first. */
+    onResult: (row: TRow) => void | Promise<void>;
+};
+export type UpdateQueue<TKey> = {
+    /** Queues changes for `key`. Resolves once a request carrying them lands. */
+    enqueue: (key: TKey, changes: Record<string, unknown>) => Promise<void>;
+    /** Drops changes still queued for `key` (resolving their waiters) and waits
+     * for any in-flight request to land. For operations that supersede pending
+     * updates and must not race them — a delete of the same row. */
+    settle: (key: TKey) => Promise<void>;
+};
+export declare function createUpdateQueue<TKey, TRow>(config: UpdateQueueConfig<TKey, TRow>): UpdateQueue<TKey>;
+//# sourceMappingURL=update-queue.d.ts.map

package/dist/sync/update-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-queue.d.ts","sourceRoot":"","sources":["../../src/sync/update-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,MAAM,MAAM,iBAAiB,CAAC,IAAI,EAAE,IAAI,IAAI;IAC1C,6EAA6E;IAC7E,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE;sEACkE;IAClE,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE;;oEAEgE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC,CAAA;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAC1C,MAAM,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,GACpC,WAAW,CAAC,IAAI,CAAC,CAkDnB"}

package/dist/sync/update-queue.js

@@ -0,0 +1,66 @@
+/** Per-key coalescing queue for high-frequency row updates.
+ *
+ * Cursor-shaped workloads call `collection.update()` many times a second. Sent
+ * one-for-one, each call is a request, a database write and a broadcast. This
+ * queue holds a single merged slot per row key: while a request is in flight,
+ * further updates for that key merge into the slot and go out as one follow-up
+ * once it lands. Request frequency settles at `min(update rate, 1/RTT)` without
+ * a tuned throttle constant, and the optimistic UI is untouched — only the
+ * network is coalesced.
+ */
+export function createUpdateQueue(config) {
+    const slots = new Map();
+    async function drain(key, slot) {
+        while (Object.keys(slot.changes).length > 0) {
+            // Taking changes and waiters as one snapshot is what guarantees a waiter
+            // resolves only after a request that carried its own changes.
+            const changes = slot.changes;
+            const waiters = slot.waiters;
+            slot.changes = {};
+            slot.waiters = [];
+            try {
+                await config.onResult(await config.send(key, changes));
+                for (const waiter of waiters)
+                    waiter.resolve();
+            }
+            catch (error) {
+                // Replaying queued changes on top of a failed base would diverge from
+                // the server silently, so the whole key is rolled back instead.
+                const queued = slot.waiters;
+                slot.changes = {};
+                slot.waiters = [];
+                for (const waiter of [...waiters, ...queued])
+                    waiter.reject(error);
+            }
+        }
+        slots.delete(key);
+    }
+    return {
+        enqueue(key, changes) {
+            let slot = slots.get(key);
+            if (!slot) {
+                slot = { changes: {}, waiters: [], done: null };
+                slots.set(key, slot);
+            }
+            Object.assign(slot.changes, changes);
+            const promise = new Promise((resolve, reject) => {
+                slot.waiters.push({ resolve, reject });
+            });
+            if (!slot.done)
+                slot.done = drain(key, slot);
+            return promise;
+        },
+        settle(key) {
+            const slot = slots.get(key);
+            if (!slot)
+                return Promise.resolve();
+            const waiters = slot.waiters;
+            slot.changes = {};
+            slot.waiters = [];
+            for (const waiter of waiters)
+                waiter.resolve();
+            return slot.done ?? Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=update-queue.js.map

package/dist/sync/update-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-queue.js","sourceRoot":"","sources":["../../src/sync/update-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,MAAM,UAAU,iBAAiB,CAC/B,MAAqC;IAErC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAc,CAAA;IAEnC,KAAK,UAAU,KAAK,CAAC,GAAS,EAAE,IAAU;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,yEAAyE;YACzE,8DAA8D;YAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC5B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;YACjB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;YACjB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;gBACtD,KAAK,MAAM,MAAM,IAAI,OAAO;oBAAE,MAAM,CAAC,OAAO,EAAE,CAAA;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sEAAsE;gBACtE,gEAAgE;gBAChE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;gBAC3B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;gBACjB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;gBACjB,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;oBAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACpE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,EAAE,OAAO;YAClB,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;gBAC/C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACtB,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACpD,IAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;YACzC,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC5C,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,MAAM,CAAC,GAAG;YACR,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC3B,IAAI,CAAC,IAAI;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC5B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;YACjB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;YACjB,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAA;YAC9C,OAAO,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QACvC,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["/** Per-key coalescing queue for high-frequency row updates.\n *\n * Cursor-shaped workloads call `collection.update()` many times a second. Sent\n * one-for-one, each call is a request, a database write and a broadcast. This\n * queue holds a single merged slot per row key: while a request is in flight,\n * further updates for that key merge into the slot and go out as one follow-up\n * once it lands. Request frequency settles at `min(update rate, 1/RTT)` without\n * a tuned throttle constant, and the optimistic UI is untouched — only the\n * network is coalesced.\n */\n\ntype Waiter = {\n  resolve: () => void\n  reject: (error: unknown) => void\n}\n\ntype Slot = {\n  changes: Record<string, unknown>\n  waiters: Waiter[]\n  /** Promise of the running drain loop; never rejects. */\n  done: Promise<void> | null\n}\n\nexport type UpdateQueueConfig<TKey, TRow> = {\n  /** Sends one merged batch of changes and resolves with the canonical row. */\n  send: (key: TKey, changes: Record<string, unknown>) => Promise<TRow>\n  /** Called with the server's row before the batch's waiters resolve. Awaited,\n   * so a handler that needs to recover (refetch) finishes first. */\n  onResult: (row: TRow) => void | Promise<void>\n}\n\nexport type UpdateQueue<TKey> = {\n  /** Queues changes for `key`. Resolves once a request carrying them lands. */\n  enqueue: (key: TKey, changes: Record<string, unknown>) => Promise<void>\n  /** Drops changes still queued for `key` (resolving their waiters) and waits\n   * for any in-flight request to land. For operations that supersede pending\n   * updates and must not race them — a delete of the same row. */\n  settle: (key: TKey) => Promise<void>\n}\n\nexport function createUpdateQueue<TKey, TRow>(\n  config: UpdateQueueConfig<TKey, TRow>,\n): UpdateQueue<TKey> {\n  const slots = new Map<TKey, Slot>()\n\n  async function drain(key: TKey, slot: Slot) {\n    while (Object.keys(slot.changes).length > 0) {\n      // Taking changes and waiters as one snapshot is what guarantees a waiter\n      // resolves only after a request that carried its own changes.\n      const changes = slot.changes\n      const waiters = slot.waiters\n      slot.changes = {}\n      slot.waiters = []\n      try {\n        await config.onResult(await config.send(key, changes))\n        for (const waiter of waiters) waiter.resolve()\n      } catch (error) {\n        // Replaying queued changes on top of a failed base would diverge from\n        // the server silently, so the whole key is rolled back instead.\n        const queued = slot.waiters\n        slot.changes = {}\n        slot.waiters = []\n        for (const waiter of [...waiters, ...queued]) waiter.reject(error)\n      }\n    }\n    slots.delete(key)\n  }\n\n  return {\n    enqueue(key, changes) {\n      let slot = slots.get(key)\n      if (!slot) {\n        slot = { changes: {}, waiters: [], done: null }\n        slots.set(key, slot)\n      }\n      Object.assign(slot.changes, changes)\n      const promise = new Promise<void>((resolve, reject) => {\n        slot!.waiters.push({ resolve, reject })\n      })\n      if (!slot.done) slot.done = drain(key, slot)\n      return promise\n    },\n    settle(key) {\n      const slot = slots.get(key)\n      if (!slot) return Promise.resolve()\n      const waiters = slot.waiters\n      slot.changes = {}\n      slot.waiters = []\n      for (const waiter of waiters) waiter.resolve()\n      return slot.done ?? Promise.resolve()\n    },\n  }\n}\n"]}

package/dist/testing/auth.d.ts

@@ -0,0 +1,85 @@
+export type TestUser = {
+    id: string;
+    email: string;
+    name: string;
+    emailVerified?: boolean;
+    image?: string | null;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+};
+export type TestIdentity = {
+    user: TestUser;
+    headers: Headers;
+};
+export declare class TestAuthError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+export type SignUpEmailInput = {
+    email: string;
+    name: string;
+    password?: string;
+};
+export type SignInEmailInput = {
+    email: string;
+    password?: string;
+};
+export type TestSession = {
+    user: TestUser;
+    session: {
+        activeOrganizationId?: string | null;
+    } | null;
+};
+export type TestAuth = {
+    signUpEmail(input: SignUpEmailInput): Promise<TestIdentity>;
+    signInEmail(input: SignInEmailInput): Promise<TestIdentity>;
+    getSession(identity: TestIdentity): Promise<TestSession | null>;
+    signOut(identity: TestIdentity): Promise<void>;
+    verifyEmail(identity: TestIdentity): Promise<TestIdentity>;
+    mockSession<TUser extends TestUser>(user: TUser, session?: {
+        activeOrganizationId?: string | null;
+    } | null): TestIdentity & {
+        user: TUser;
+    };
+};
+export type AuthSessionResolverLike = {
+    api: {
+        getSession: (opts: {
+            headers: Headers;
+        }) => Promise<unknown>;
+    };
+};
+export type WorkerstackAppLike = {
+    auth: unknown;
+};
+export type TestSessionRegistry = {
+    readonly resolver: AuthSessionResolver;
+    mocked(headers: Headers): TestSession | undefined;
+    mock<TUser extends TestUser>(user: TUser, session?: {
+        activeOrganizationId?: string | null;
+    } | null): TestIdentity & {
+        user: TUser;
+    };
+};
+export declare function createTestSessionRegistry(): TestSessionRegistry;
+export declare function mockAuthSession<TUser extends {
+    id: string;
+    email: string;
+    name?: string;
+    role?: string;
+}>(app: WorkerstackAppLike, resolver: (opts: {
+    headers: Headers;
+}) => Promise<{
+    user: TUser;
+    session?: {
+        activeOrganizationId?: string | null;
+    } | null;
+} | null>): void;
+export declare function createTestAuth(app: {
+    handler(request: Request): Promise<Response>;
+    auth: unknown;
+}, email: TestEmail, sessions: TestSessionRegistry): TestAuth;
+import type { AuthSessionResolver } from '../access.js';
+import type { TestEmail } from './email.js';
+//# sourceMappingURL=auth.d.ts.map

package/dist/testing/auth.d.ts.map

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

package/dist/testing/auth.js

@@ -0,0 +1,140 @@
+export class TestAuthError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Better Auth request failed (${status})`);
+        this.name = 'TestAuthError';
+        this.status = status;
+        this.body = body;
+    }
+}
+const TEST_SESSION_HEADER = 'x-workerstack-test-session';
+export function createTestSessionRegistry() {
+    const sessions = new Map();
+    return {
+        resolver: {
+            api: {
+                async getSession({ headers }) {
+                    const token = headers.get(TEST_SESSION_HEADER);
+                    if (token)
+                        return sessions.get(token) ?? null;
+                    return null;
+                },
+            },
+        },
+        mocked(headers) {
+            const token = headers.get(TEST_SESSION_HEADER);
+            return token ? sessions.get(token) : undefined;
+        },
+        mock(user, session = null) {
+            const token = crypto.randomUUID();
+            sessions.set(token, { user, session });
+            return {
+                user,
+                headers: new Headers({ [TEST_SESSION_HEADER]: token }),
+            };
+        },
+    };
+}
+export function mockAuthSession(app, resolver) {
+    const auth = app.auth;
+    if (auth?.api) {
+        auth.api.getSession = resolver;
+    }
+}
+function cookieHeaders(response) {
+    const values = response.headers.getSetCookie();
+    const cookie = values
+        .map((value) => value.split(';', 1)[0])
+        .filter((value) => Boolean(value))
+        .join('; ');
+    return new Headers(cookie ? { cookie } : undefined);
+}
+export function createTestAuth(app, email, sessions) {
+    const request = async (path, init = {}, headers) => {
+        const mergedHeaders = new Headers(headers);
+        if (init.body !== undefined && !mergedHeaders.has('content-type')) {
+            mergedHeaders.set('content-type', 'application/json');
+        }
+        return app.handler(new Request(new URL(path, 'http://workerstack.test'), {
+            ...init,
+            headers: mergedHeaders,
+        }));
+    };
+    const identityFromResponse = async (response) => {
+        const body = await response.json().catch(() => null);
+        if (!response.ok)
+            throw new TestAuthError(response.status, body);
+        const user = body?.user;
+        if (!user)
+            throw new TestAuthError(response.status, body);
+        return { user, headers: cookieHeaders(response) };
+    };
+    const currentSession = async (identity) => {
+        const mocked = sessions.mocked(identity.headers);
+        if (mocked)
+            return mocked;
+        const auth = app.auth;
+        const result = await auth.api.getSession({ headers: identity.headers });
+        if (!result || typeof result !== 'object' || !('user' in result)) {
+            return null;
+        }
+        const value = result;
+        return value.user
+            ? { user: value.user, session: value.session ?? null }
+            : null;
+    };
+    return {
+        async signUpEmail(input) {
+            return identityFromResponse(await request('/api/auth/sign-up/email', {
+                method: 'POST',
+                body: JSON.stringify({
+                    email: input.email,
+                    name: input.name,
+                    password: input.password ?? 'password-123',
+                }),
+            }));
+        },
+        async signInEmail(input) {
+            return identityFromResponse(await request('/api/auth/sign-in/email', {
+                method: 'POST',
+                body: JSON.stringify({
+                    email: input.email,
+                    password: input.password ?? 'password-123',
+                }),
+            }));
+        },
+        async getSession(identity) {
+            return currentSession(identity);
+        },
+        async signOut(identity) {
+            const response = await request('/api/auth/sign-out', { method: 'POST' }, identity.headers);
+            if (!response.ok) {
+                throw new TestAuthError(response.status, await response.json().catch(() => null));
+            }
+        },
+        async verifyEmail(identity) {
+            const message = [...email.sent]
+                .reverse()
+                .find((candidate) => candidate.to.includes(identity.user.email));
+            const content = `${message?.text ?? ''}\n${message?.html ?? ''}`;
+            const url = content.match(/https?:\/\/[^\s<>"']+\/api\/auth\/verify-email\?[^\s<>"']+/)?.[0];
+            if (!url) {
+                throw new Error(`[workerstack] no verification link captured for ${identity.user.email}`);
+            }
+            const response = await request(url, {}, identity.headers);
+            if (response.status >= 400) {
+                throw new TestAuthError(response.status, await response.text());
+            }
+            const user = (await currentSession(identity))?.user;
+            if (!user) {
+                throw new Error('[workerstack] verified identity has no active session');
+            }
+            return { user, headers: identity.headers };
+        },
+        mockSession(user, session) {
+            return sessions.mock(user, session);
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/testing/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/testing/auth.ts"],"names":[],"mappings":"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","sourcesContent":["export type TestUser = {\n  id: string\n  email: string\n  name: string\n  emailVerified?: boolean\n  image?: string | null\n  createdAt?: string | Date\n  updatedAt?: string | Date\n}\n\nexport type TestIdentity = {\n  user: TestUser\n  headers: Headers\n}\n\nexport class TestAuthError extends Error {\n  readonly status: number\n  readonly body: unknown\n\n  constructor(status: number, body: unknown) {\n    super(`Better Auth request failed (${status})`)\n    this.name = 'TestAuthError'\n    this.status = status\n    this.body = body\n  }\n}\n\nexport type SignUpEmailInput = {\n  email: string\n  name: string\n  password?: string\n}\n\nexport type SignInEmailInput = {\n  email: string\n  password?: string\n}\n\nexport type TestSession = {\n  user: TestUser\n  session: { activeOrganizationId?: string | null } | null\n}\n\nexport type TestAuth = {\n  signUpEmail(input: SignUpEmailInput): Promise<TestIdentity>\n  signInEmail(input: SignInEmailInput): Promise<TestIdentity>\n  getSession(identity: TestIdentity): Promise<TestSession | null>\n  signOut(identity: TestIdentity): Promise<void>\n  verifyEmail(identity: TestIdentity): Promise<TestIdentity>\n  mockSession<TUser extends TestUser>(\n    user: TUser,\n    session?: { activeOrganizationId?: string | null } | null,\n  ): TestIdentity & { user: TUser }\n}\n\nexport type AuthSessionResolverLike = {\n  api: {\n    getSession: (opts: { headers: Headers }) => Promise<unknown>\n  }\n}\n\nexport type WorkerstackAppLike = {\n  auth: unknown\n}\n\nconst TEST_SESSION_HEADER = 'x-workerstack-test-session'\n\nexport type TestSessionRegistry = {\n  readonly resolver: AuthSessionResolver\n  mocked(headers: Headers): TestSession | undefined\n  mock<TUser extends TestUser>(\n    user: TUser,\n    session?: { activeOrganizationId?: string | null } | null,\n  ): TestIdentity & { user: TUser }\n}\n\nexport function createTestSessionRegistry(): TestSessionRegistry {\n  const sessions = new Map<string, TestSession>()\n  return {\n    resolver: {\n      api: {\n        async getSession({ headers }) {\n          const token = headers.get(TEST_SESSION_HEADER)\n          if (token) return sessions.get(token) ?? null\n          return null\n        },\n      },\n    },\n    mocked(headers) {\n      const token = headers.get(TEST_SESSION_HEADER)\n      return token ? sessions.get(token) : undefined\n    },\n    mock(user, session = null) {\n      const token = crypto.randomUUID()\n      sessions.set(token, { user, session })\n      return {\n        user,\n        headers: new Headers({ [TEST_SESSION_HEADER]: token }),\n      }\n    },\n  }\n}\n\nexport function mockAuthSession<\n  TUser extends { id: string; email: string; name?: string; role?: string },\n>(\n  app: WorkerstackAppLike,\n  resolver: (opts: { headers: Headers }) => Promise<{\n    user: TUser\n    session?: { activeOrganizationId?: string | null } | null\n  } | null>,\n): void {\n  const auth = app.auth as unknown as AuthSessionResolverLike\n  if (auth?.api) {\n    auth.api.getSession = resolver as unknown as (opts: {\n      headers: Headers\n    }) => Promise<unknown>\n  }\n}\n\nfunction cookieHeaders(response: Response): Headers {\n  const values = response.headers.getSetCookie()\n  const cookie = values\n    .map((value) => value.split(';', 1)[0])\n    .filter((value): value is string => Boolean(value))\n    .join('; ')\n  return new Headers(cookie ? { cookie } : undefined)\n}\n\nexport function createTestAuth(\n  app: {\n    handler(request: Request): Promise<Response>\n    auth: unknown\n  },\n  email: TestEmail,\n  sessions: TestSessionRegistry,\n): TestAuth {\n  const request = async (\n    path: string,\n    init: RequestInit = {},\n    headers?: Headers,\n  ) => {\n    const mergedHeaders = new Headers(headers)\n    if (init.body !== undefined && !mergedHeaders.has('content-type')) {\n      mergedHeaders.set('content-type', 'application/json')\n    }\n    return app.handler(\n      new Request(new URL(path, 'http://workerstack.test'), {\n        ...init,\n        headers: mergedHeaders,\n      }),\n    )\n  }\n\n  const identityFromResponse = async (response: Response) => {\n    const body = await response.json().catch(() => null)\n    if (!response.ok) throw new TestAuthError(response.status, body)\n    const user = (body as { user?: TestUser } | null)?.user\n    if (!user) throw new TestAuthError(response.status, body)\n    return { user, headers: cookieHeaders(response) }\n  }\n\n  const currentSession = async (\n    identity: TestIdentity,\n  ): Promise<TestSession | null> => {\n    const mocked = sessions.mocked(identity.headers)\n    if (mocked) return mocked\n    const auth = app.auth as {\n      api: {\n        getSession(options: { headers: Headers }): Promise<unknown>\n      }\n    }\n    const result = await auth.api.getSession({ headers: identity.headers })\n    if (!result || typeof result !== 'object' || !('user' in result)) {\n      return null\n    }\n    const value = result as {\n      user?: TestUser\n      session?: TestSession['session']\n    }\n    return value.user\n      ? { user: value.user, session: value.session ?? null }\n      : null\n  }\n\n  return {\n    async signUpEmail(input) {\n      return identityFromResponse(\n        await request('/api/auth/sign-up/email', {\n          method: 'POST',\n          body: JSON.stringify({\n            email: input.email,\n            name: input.name,\n            password: input.password ?? 'password-123',\n          }),\n        }),\n      )\n    },\n    async signInEmail(input) {\n      return identityFromResponse(\n        await request('/api/auth/sign-in/email', {\n          method: 'POST',\n          body: JSON.stringify({\n            email: input.email,\n            password: input.password ?? 'password-123',\n          }),\n        }),\n      )\n    },\n    async getSession(identity) {\n      return currentSession(identity)\n    },\n    async signOut(identity) {\n      const response = await request(\n        '/api/auth/sign-out',\n        { method: 'POST' },\n        identity.headers,\n      )\n      if (!response.ok) {\n        throw new TestAuthError(\n          response.status,\n          await response.json().catch(() => null),\n        )\n      }\n    },\n    async verifyEmail(identity) {\n      const message = [...email.sent]\n        .reverse()\n        .find((candidate) => candidate.to.includes(identity.user.email))\n      const content = `${message?.text ?? ''}\\n${message?.html ?? ''}`\n      const url = content.match(\n        /https?:\\/\\/[^\\s<>\"']+\\/api\\/auth\\/verify-email\\?[^\\s<>\"']+/,\n      )?.[0]\n      if (!url) {\n        throw new Error(\n          `[workerstack] no verification link captured for ${identity.user.email}`,\n        )\n      }\n      const response = await request(url, {}, identity.headers)\n      if (response.status >= 400) {\n        throw new TestAuthError(response.status, await response.text())\n      }\n      const user = (await currentSession(identity))?.user\n      if (!user) {\n        throw new Error('[workerstack] verified identity has no active session')\n      }\n      return { user, headers: identity.headers }\n    },\n    mockSession(user, session) {\n      return sessions.mock(user, session)\n    },\n  }\n}\nimport type { AuthSessionResolver } from '../access'\nimport type { TestEmail } from './email'\n"]}

package/dist/testing/client.d.ts

@@ -0,0 +1,6 @@
+import type { AnyWorkerstackApp, WorkerstackClient } from '../client/rpc-client.js';
+import type { TestIdentity } from './auth.js';
+export declare function testClient<TApp extends AnyWorkerstackApp>(app: TApp & {
+    handler(request: Request): Promise<Response>;
+}, identity?: TestIdentity): WorkerstackClient<TApp>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/testing/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAI1C,wBAAgB,UAAU,CAAC,IAAI,SAAS,iBAAiB,EACvD,GAAG,EAAE,IAAI,GAAG;IAAE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,EAC5D,QAAQ,CAAC,EAAE,YAAY,GACtB,iBAAiB,CAAC,IAAI,CAAC,CAMzB"}

package/dist/testing/client.js

@@ -0,0 +1,9 @@
+import { createClient } from '../client/rpc-client.js';
+export function testClient(app, identity) {
+    return createClient({
+        baseUrl: 'http://workerstack.test/api',
+        fetch: (input, init) => app.handler(new Request(input, init)),
+        headers: identity?.headers,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/testing/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/testing/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,UAAU,UAAU,CACxB,GAA4D,EAC5D,QAAuB;IAEvB,OAAO,YAAY,CAAO;QACxB,OAAO,EAAE,6BAA6B;QACtC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,OAAO;KAC3B,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import type { AnyWorkerstackApp, WorkerstackClient } from '../client/rpc-client'\nimport type { TestIdentity } from './auth'\n\nimport { createClient } from '../client/rpc-client'\n\nexport function testClient<TApp extends AnyWorkerstackApp>(\n  app: TApp & { handler(request: Request): Promise<Response> },\n  identity?: TestIdentity,\n): WorkerstackClient<TApp> {\n  return createClient<TApp>({\n    baseUrl: 'http://workerstack.test/api',\n    fetch: (input, init) => app.handler(new Request(input, init)),\n    headers: identity?.headers,\n  })\n}\n"]}

package/dist/testing/database.d.ts

@@ -0,0 +1,6 @@
+import type { DatabaseAdapter, TestDatabaseStrategy, TestDatabaseTarget } from '../database/adapter.js';
+export declare function createTestDatabaseTarget(adapter: DatabaseAdapter, options: {
+    mode: 'memory' | 'temporary';
+    strategy?: TestDatabaseStrategy;
+}): Promise<TestDatabaseTarget>;
+//# sourceMappingURL=database.d.ts.map

package/dist/testing/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/testing/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAA;AAE5B,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACP,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAA;IAC5B,QAAQ,CAAC,EAAE,oBAAoB,CAAA;CAChC,GACA,OAAO,CAAC,kBAAkB,CAAC,CAQ7B"}

package/dist/testing/database.js

@@ -0,0 +1,8 @@
+export async function createTestDatabaseTarget(adapter, options) {
+    const strategy = options.strategy ?? adapter.testing;
+    if (!strategy) {
+        throw new Error(`[workerstack] ${adapter.driver} requires an explicit test database strategy`);
+    }
+    return strategy.createTarget({ mode: options.mode });
+}
+//# sourceMappingURL=database.js.map

package/dist/testing/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/testing/database.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAwB,EACxB,OAGC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAA;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,iBAAiB,OAAO,CAAC,MAAM,8CAA8C,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AACtD,CAAC","sourcesContent":["import type {\n  DatabaseAdapter,\n  TestDatabaseStrategy,\n  TestDatabaseTarget,\n} from '../database/adapter'\n\nexport async function createTestDatabaseTarget(\n  adapter: DatabaseAdapter,\n  options: {\n    mode: 'memory' | 'temporary'\n    strategy?: TestDatabaseStrategy\n  },\n): Promise<TestDatabaseTarget> {\n  const strategy = options.strategy ?? adapter.testing\n  if (!strategy) {\n    throw new Error(\n      `[workerstack] ${adapter.driver} requires an explicit test database strategy`,\n    )\n  }\n  return strategy.createTarget({ mode: options.mode })\n}\n"]}