bunderstack 0.20.0 → 0.21.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 AnyBunderstackApp, type BunderstackClient, 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 BunderstackSyncClient<TApp extends AnyBunderstackApp> = {
+    [K in InferTables<TApp>]: TableCollection<RowFor<InferSchema<TApp>, K>, CreateFor<InferSchema<TApp>, K>, Partial<RowFor<InferSchema<TApp>, K>>>;
+} & {
+    files: BunderstackClient<TApp>['files'];
+    realtime: {
+        close(): void;
+        subscribe(tables: string[]): Promise<void>;
+    } | undefined;
+};
+export declare function createSyncClient<TApp extends AnyBunderstackApp>(options: SyncClientOptions): BunderstackSyncClient<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 AnyBunderstackApp,\n  type BunderstackClient,\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 BunderstackSyncClient<TApp extends AnyBunderstackApp> = {\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: BunderstackClient<TApp>['files']\n  realtime:\n    | { close(): void; subscribe(tables: string[]): Promise<void> }\n    | undefined\n}\n\nexport function createSyncClient<TApp extends AnyBunderstackApp>(\n  options: SyncClientOptions,\n): BunderstackSyncClient<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 BunderstackSyncClient<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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunderstack",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Batteries-included backend framework for Bun: type-safe oRPC APIs, auth, storage, realtime, jobs, email, and validated env from one config.",
   "keywords": [
     "backend",
@@ -107,6 +107,50 @@
     "./api": {
       "types": "./dist/api/types.d.ts",
       "default": "./dist/api/types.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./client/rest": {
+      "types": "./dist/client/rest.d.ts",
+      "default": "./dist/client/rest.js"
+    },
+    "./client/react": {
+      "types": "./dist/client/react.d.ts",
+      "default": "./dist/client/react.js"
+    },
+    "./client/solid": {
+      "types": "./dist/client/solid.d.ts",
+      "default": "./dist/client/solid.js"
+    },
+    "./client/svelte": {
+      "types": "./dist/client/svelte.d.ts",
+      "default": "./dist/client/svelte.js"
+    },
+    "./client/vue": {
+      "types": "./dist/client/vue.d.ts",
+      "default": "./dist/client/vue.js"
+    },
+    "./query": {
+      "types": "./dist/query/index.d.ts",
+      "default": "./dist/query/index.js"
+    },
+    "./query/react": {
+      "types": "./dist/query/react.d.ts",
+      "default": "./dist/query/react.js"
+    },
+    "./sync": {
+      "types": "./dist/sync/index.d.ts",
+      "default": "./dist/sync/index.js"
+    },
+    "./start": {
+      "types": "./dist/start/index.d.ts",
+      "default": "./dist/start/index.js"
+    },
+    "./start/auth": {
+      "types": "./dist/start/auth-client.d.ts",
+      "default": "./dist/start/auth-client.js"
     }
   },
   "scripts": {
@@ -119,7 +163,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@orpc/client": "2.0.0-beta.26",
+    "@orpc/server": "2.0.0-beta.26",
     "@standard-schema/spec": "1.1.0",
+    "@standardserver/core": "0.7.1",
     "valibot": "1.4.2",
     "yaml": "^2.9.0"
   },
@@ -127,33 +174,56 @@
     "@electric-sql/pglite": ">=0.3.0",
     "@libsql/client": ">=0.14.0",
     "@orpc/bun": "2.0.0-beta.26",
+    "@orpc/client": "2.0.0-beta.26",
     "@orpc/json-schema": "2.0.0-beta.26",
     "@orpc/openapi": "2.0.0-beta.26",
     "@orpc/publisher": "2.0.0-beta.26",
     "@orpc/server": "2.0.0-beta.26",
+    "@orpc/tanstack-query": "2.0.0-beta.26",
     "@orpc/valibot": "2.0.0-beta.26",
+    "@standardserver/core": "0.7.1",
+    "@tanstack/db": "0.6.16",
+    "@tanstack/query-core": "^5.101.1",
+    "@tanstack/query-db-collection": "1.1.0",
+    "@tanstack/react-query": "^5.101.1",
+    "@tanstack/react-start": "^1.168.26",
     "@types/nodemailer": "^6",
+    "@types/react": "^19.0.0",
     "better-auth": "^1.0.0",
     "drizzle-kit": "^0.30.0",
     "drizzle-orm": "^0.45.0",
-    "drizzle-valibot": "0.4.2"
+    "drizzle-valibot": "0.4.2",
+    "react": "^19.0.0",
+    "solid-js": "2.0.0-rc.0",
+    "typescript": "^5.8.0",
+    "vue": "^3.5.0"
   },
   "peerDependencies": {
     "@electric-sql/pglite": ">=0.3.0",
     "@libsql/client": ">=0.14.0",
     "@orpc/bun": "2.0.0-beta.26",
+    "@orpc/client": "2.0.0-beta.26",
     "@orpc/json-schema": "2.0.0-beta.26",
     "@orpc/openapi": "2.0.0-beta.26",
     "@orpc/publisher": "2.0.0-beta.26",
     "@orpc/server": "2.0.0-beta.26",
+    "@orpc/tanstack-query": "2.0.0-beta.26",
     "@orpc/valibot": "2.0.0-beta.26",
+    "@tanstack/db": "0.6.16",
+    "@tanstack/query-core": "^5.101.0",
+    "@tanstack/query-db-collection": "1.1.0",
+    "@tanstack/react-query": "^5.101.0",
+    "@tanstack/react-start": ">=1.0.0",
     "better-auth": "^1.0.0",
     "drizzle-kit": "^0.30.0",
     "drizzle-orm": "^0.45.0",
     "drizzle-valibot": "0.4.2",
     "nodemailer": ">=6 <10",
     "postgres": ">=3.4.0",
-    "typescript": ">=5"
+    "react": ">=18",
+    "solid-js": ">=2.0.0-rc.0",
+    "typescript": ">=5",
+    "vue": ">=3.5"
   },
   "peerDependenciesMeta": {
     "@electric-sql/pglite": {
@@ -162,6 +232,27 @@
     "@libsql/client": {
       "optional": true
     },
+    "@orpc/tanstack-query": {
+      "optional": true
+    },
+    "@tanstack/db": {
+      "optional": true
+    },
+    "@tanstack/query-core": {
+      "optional": true
+    },
+    "@tanstack/query-db-collection": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "@tanstack/react-start": {
+      "optional": true
+    },
+    "better-auth": {
+      "optional": true
+    },
     "drizzle-kit": {
       "optional": true
     },
@@ -171,8 +262,17 @@
     "postgres": {
       "optional": true
     },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
+    },
+    "vue": {
+      "optional": true
     }
   }
 }

package/skills/creating-bunderstack-apps/references/runtime-integrations.md

@@ -61,7 +61,7 @@ client filters it before cache callbacks and does not advance the Publisher
 resume ID. Do not add an application polling loop or publish heartbeat events
 through oRPC Publisher.
 
-`bunderstack-sync` reconciles successful mutations from the canonical row
+`bunderstack/sync` reconciles successful mutations from the canonical row
 returned by generated CRUD, without a follow-up list refetch. Realtime echoes
 are idempotent, and reconnect performs the full refetch used to repair drift.
 Keep custom replacement procedures compatible by returning the complete row,

package/skills/migrating-to-bunderstack/references/runtime-replacements.md

@@ -94,7 +94,7 @@ circular evaluation loop at boot.
 One catch-all route, built by the adapter rather than by hand:
 
 ```ts
-import { createApiHandlers } from 'bunderstack-start'
+import { createApiHandlers } from 'bunderstack/start'
 import { createFileRoute } from '@tanstack/react-router'
 import { app } from '../../bunderstack'
 
@@ -188,7 +188,7 @@ query client consumes it automatically without updating cache state or the
 Publisher resume ID. Delete custom polling, keepalive, SSE registration, and
 client reconnect loops instead of wrapping them around the oRPC stream.
 
-For TanStack DB applications, use `bunderstack-sync`. Successful mutations are
+For TanStack DB applications, use `bunderstack/sync`. Successful mutations are
 reconciled from their complete server response without a follow-up `list`
 refetch, and same-row updates are coalesced while a request is in flight.