bunderstack-sync 0.17.0-beta.2 → 0.17.0-beta.4

package/dist/collection.d.ts

@@ -0,0 +1,106 @@
+import type { QueryClient } from '@tanstack/react-query';
+import { type Collection, type StandardSchema } from '@tanstack/db';
+type TableListResult<TRow> = {
+    items: TRow[];
+    hasMore: boolean;
+    nextCursor?: string;
+    total?: number;
+    limit?: number;
+    offset?: number;
+};
+type TableProcedures<TRow, TCreate, TUpdate> = {
+    list: {
+        call(input?: Record<string, unknown>): Promise<TableListResult<TRow>>;
+    };
+    get: {
+        call(input: {
+            id: string;
+        }): Promise<TRow>;
+    };
+    create: {
+        call(input: TCreate): Promise<TRow>;
+    };
+    update: {
+        call(input: {
+            params: {
+                id: string;
+            };
+            query: {};
+            headers: {};
+            body: TUpdate;
+        }): Promise<TRow>;
+    };
+    delete: {
+        call(input: {
+            id: string;
+        }): Promise<void>;
+    };
+};
+export type DirectTableApi<TRow, TCreate, TUpdate> = {
+    list(input?: Record<string, unknown>): Promise<TableListResult<TRow>>;
+    get(id: string | number): Promise<TRow>;
+    create(input: TCreate): Promise<TRow>;
+    update(id: string | number, input: TUpdate): Promise<TRow>;
+    delete(id: string | number): Promise<void>;
+};
+export type TableCollectionConfig = {
+    tableName: string;
+    procedures: TableProcedures<any, any, any>;
+    queryClient: QueryClient;
+    /** Rows the default `.collection` syncs per fetch. Defaults to 100. For
+     * feed-shaped tables that need real pagination use `scopedCollection`. */
+    limit?: number;
+};
+export type ScopedFilterValue = string | number | boolean | null | readonly (string | number)[];
+export type ScopedCollectionOptions = {
+    /** Equality filters, e.g. `{ replyToId: null }` — columns must be in the
+     * table's `filterableColumns` server-side. Same name and shape as the
+     * `filters` accepted by the list procedure. */
+    filters?: Record<string, ScopedFilterValue>;
+    sort?: string;
+    order?: 'asc' | 'desc';
+    /** Rows per underlying request; clamped to the server cap (200). */
+    pageSize?: number;
+    /** Window size on first load and default `loadMore` step. Defaults to 20. */
+    initialCount?: number;
+};
+export declare function createTableCollection<TRow extends {
+    id: string | number;
+}, TCreate = Partial<TRow>, TUpdate = Partial<TRow>>(config: TableCollectionConfig): {
+    collection: import("@tanstack/db").Collection<TRow, string | number, import("@tanstack/query-db-collection").QueryCollectionUtils<TRow, string | number, TRow, unknown>, never, TRow> & import("@tanstack/db").NonSingleResult;
+    table: DirectTableApi<TRow, TCreate, TUpdate>;
+    scopedCollection: (options?: ScopedCollectionOptions) => {
+        collection: import("@tanstack/db").Collection<TRow, string | number, import("@tanstack/query-db-collection").QueryCollectionUtils<TRow, string | number, TRow, unknown>, never, TRow> & import("@tanstack/db").NonSingleResult;
+        /** Grow the window by `count` (default initialCount) and refetch in place. */
+        loadMore: (count?: number) => Promise<void>;
+        /** Whether the server reported rows beyond the window (as of last fetch). */
+        hasMore: () => boolean;
+        /** Current desired window size. */
+        size: () => number;
+    };
+    collectionByIds: (ids: readonly TRow["id"][], options?: {
+        column?: string;
+    }) => import("@tanstack/db").Collection<TRow, string | number, import("@tanstack/query-db-collection").QueryCollectionUtils<TRow, string | number, TRow, unknown>, never, TRow> & import("@tanstack/db").NonSingleResult;
+    applyRealtimeEvent: (action: "create" | "update" | "delete", record: Record<string, unknown>) => void;
+    refetchAll: () => Promise<void>;
+};
+export type ScopedCollection<TRow extends {
+    id: string | number;
+}> = {
+    collection: Collection<TRow, string | number, Record<string, any>, StandardSchema<TRow>>;
+    loadMore: (count?: number) => Promise<void>;
+    hasMore: () => boolean;
+    size: () => number;
+};
+export type TableCollection<TRow extends {
+    id: string | number;
+}, TCreate = Partial<TRow>, TUpdate = Partial<TRow>> = {
+    collection: Collection<TRow, string | number, Record<string, any>, StandardSchema<TRow>>;
+    table: DirectTableApi<TRow, TCreate, TUpdate>;
+    scopedCollection: (options?: ScopedCollectionOptions) => ScopedCollection<TRow>;
+    collectionByIds: (ids: readonly (string | number)[], column?: string) => Collection<TRow, string | number, Record<string, any>, StandardSchema<TRow>>;
+    applyRealtimeEvent: (action: 'create' | 'update' | 'delete', record: Record<string, unknown>) => void;
+    refetchAll: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

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

package/dist/collection.js

@@ -0,0 +1,258 @@
+import { createCollection, } from '@tanstack/db';
+import { queryCollectionOptions } from '@tanstack/query-db-collection';
+import { createUpdateQueue } from './update-queue.js';
+const MAX_LIST_LIMIT = 200;
+function matchesFilter(record, filters) {
+    for (const [col, expected] of Object.entries(filters)) {
+        const actual = record[col];
+        if (expected === null) {
+            if (actual != null)
+                return false;
+        }
+        else if (Array.isArray(expected)) {
+            if (!expected.map(String).includes(String(actual)))
+                return false;
+        }
+        else if (String(actual) !== String(expected))
+            return false;
+    }
+    return true;
+}
+/** Deterministic serialization for cache keys (object key order ignored). */
+function stableKey(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableKey).join(',')}]`;
+    const entries = Object.entries(value)
+        .sort(([a], [b]) => (a < b ? -1 : 1))
+        .map(([k, v]) => `${JSON.stringify(k)}:${stableKey(v)}`);
+    return `{${entries.join(',')}}`;
+}
+export function createTableCollection(config) {
+    const table = config.procedures;
+    const direct = {
+        list: (input = {}) => table.list.call(input),
+        get: (id) => table.get.call({ id: String(id) }),
+        create: (input) => table.create.call(input),
+        update: (id, input) => table.update.call({
+            params: { id: String(id) },
+            query: {},
+            headers: {},
+            body: input,
+        }),
+        delete: (id) => table.delete.call({ id: String(id) }),
+    };
+    const collection = createCollection(queryCollectionOptions({
+        queryKey: [config.tableName, 'collection'],
+        queryFn: async () => {
+            const page = await table.list.call({ limit: config.limit ?? 100 });
+            return page.items;
+        },
+        queryClient: config.queryClient,
+        getKey: (item) => item.id,
+        onInsert: async ({ transaction }) => {
+            let reconciled = true;
+            for (const mutation of transaction.mutations) {
+                // Pass the client-generated `id` through as-is. TanStack DB's
+                // optimistic insert keys the local row by this `id` (via `getKey`),
+                // and this matches `sanitizeWriteBody`'s default on the server: a
+                // client-supplied `id` on create is accepted unless the table's
+                // access config sets an explicit `writableColumns` allowlist that
+                // excludes `id`.
+                const row = (await table.create.call(mutation.modified));
+                // Apps that DO restrict it that way get a server-assigned id, which
+                // leaves the optimistic row keyed under the client's — `writeUpsert`
+                // can't retire that, so those fall back to the refetch.
+                if (row?.id != null && String(row.id) === String(mutation.key)) {
+                    applyRealtimeEvent('create', row);
+                }
+                else {
+                    reconciled = false;
+                }
+            }
+            return reconciled ? { refetch: false } : {};
+        },
+        onUpdate: async ({ transaction }) => {
+            await Promise.all(transaction.mutations.map((mutation) => updateQueue.enqueue(mutation.key, mutation.changes)));
+            return { refetch: false };
+        },
+        onDelete: async ({ transaction }) => {
+            for (const mutation of transaction.mutations) {
+                // Updates still queued for this row are superseded, and one already
+                // in flight must land before the DELETE or the two race.
+                await updateQueue.settle(mutation.key);
+                await table.delete.call({ id: String(mutation.key) });
+                applyRealtimeEvent('delete', { id: mutation.key });
+            }
+            return { refetch: false };
+        },
+    }));
+    // Cursor-shaped workloads call `update()` many times a second. The queue
+    // merges everything that piles up for a row while its request is in flight
+    // into a single follow-up, so request rate tracks RTT, not call rate.
+    const updateQueue = createUpdateQueue({
+        send: (id, changes) => table.update.call({
+            params: { id: String(id) },
+            query: {},
+            headers: {},
+            body: changes,
+        }),
+        onResult: async (row) => {
+            // `writeUpsert` writes the response whole, so mutation endpoints are
+            // contracted to return a full row. A body without an id can't be
+            // reconciled locally — fall back to the refetch rather than write it.
+            if (row?.id == null)
+                await collection.utils.refetch();
+            else
+                applyRealtimeEvent('update', row);
+        },
+    });
+    // Scoped/byIds collections register here so realtime events fan out to
+    // every live view of this table, filtered client-side by each view's
+    // own predicate (broadcasts are already access-filtered server-side).
+    const registry = [];
+    const scopedCache = new Map();
+    function scopedCollection(options = {}) {
+        const pageSize = Math.min(options.pageSize ?? MAX_LIST_LIMIT, MAX_LIST_LIMIT);
+        const initialCount = options.initialCount ?? 20;
+        const filters = options.filters ?? {};
+        const cacheKey = stableKey({
+            filters,
+            sort: options.sort ?? null,
+            order: options.order ?? null,
+            pageSize,
+            initialCount,
+        });
+        const cached = scopedCache.get(cacheKey);
+        if (cached)
+            return cached;
+        let desiredCount = initialCount;
+        let serverHasMore = false;
+        const scoped = createCollection(queryCollectionOptions({
+            queryKey: [config.tableName, 'scoped', cacheKey],
+            queryFn: async () => {
+                // Growing window: walk cursor pages (each ≤ the server cap) until
+                // the current desired count is collected or the table runs out.
+                // The collection stays stable across loadMore — refetching in
+                // place only ever adds rows, so already-rendered items never
+                // unmount (no scroll jumps or zero-item flashes).
+                const items = [];
+                let cursor;
+                let more = false;
+                while (items.length < desiredCount) {
+                    const remaining = Math.min(pageSize, desiredCount - items.length);
+                    const page = await table.list.call({
+                        ...(Object.keys(filters).length ? { filters } : {}),
+                        ...(options.sort ? { sort: options.sort } : {}),
+                        ...(options.order ? { order: options.order } : {}),
+                        limit: remaining,
+                        ...(cursor ? { cursor } : {}),
+                    });
+                    items.push(...page.items);
+                    more = Boolean(page.hasMore && page.nextCursor);
+                    if (!more)
+                        break;
+                    cursor = page.nextCursor;
+                }
+                serverHasMore = more;
+                return items.slice(0, desiredCount);
+            },
+            queryClient: config.queryClient,
+            getKey: (item) => item.id,
+        }));
+        const entry = {
+            collection: scoped,
+            loadMore: async (count) => {
+                desiredCount += count ?? initialCount;
+                await scoped.utils.refetch();
+            },
+            hasMore: () => serverHasMore,
+            size: () => desiredCount,
+        };
+        registry.push({
+            collection: scoped,
+            matches: (record) => matchesFilter(record, filters),
+            refetch: async () => {
+                await scoped.utils.refetch();
+            },
+        });
+        scopedCache.set(cacheKey, entry);
+        return entry;
+    }
+    const byIdsCache = new Map();
+    function collectionByIds(ids, options = {}) {
+        const column = options.column ?? 'id';
+        const unique = Array.from(new Set(ids.map(String))).sort();
+        const cacheKey = `${column}:${unique.join(',')}`;
+        const cached = byIdsCache.get(cacheKey);
+        if (cached)
+            return cached;
+        const idSet = new Set(unique);
+        const byIds = createCollection(queryCollectionOptions({
+            queryKey: [config.tableName, 'byIds', column, unique],
+            queryFn: async () => {
+                if (unique.length === 0)
+                    return [];
+                const items = [];
+                // Chunked at the server's IN-filter cap so any id set works.
+                for (let i = 0; i < unique.length; i += MAX_LIST_LIMIT) {
+                    const chunk = unique.slice(i, i + MAX_LIST_LIMIT);
+                    const page = await table.list.call({
+                        filters: { [column]: chunk },
+                        limit: chunk.length,
+                    });
+                    items.push(...page.items);
+                }
+                return items;
+            },
+            queryClient: config.queryClient,
+            getKey: (item) => item.id,
+        }));
+        registry.push({
+            collection: byIds,
+            matches: (record) => idSet.has(String(record[column])),
+            refetch: async () => {
+                await byIds.utils.refetch();
+            },
+        });
+        byIdsCache.set(cacheKey, byIds);
+        return byIds;
+    }
+    function applyRealtimeEvent(action, record) {
+        const id = record['id'];
+        const apply = (target, matches) => {
+            // Collections that never started syncing (no subscribers yet) can't
+            // accept manual writes — and don't need to: their first sync fetches
+            // fresh data anyway.
+            if (target.status !== 'ready')
+                return;
+            if (action === 'delete' || !matches(record)) {
+                if (target.get(id) !== undefined)
+                    target.utils.writeDelete(id);
+            }
+            else {
+                target.utils.writeUpsert(record);
+            }
+        };
+        apply(collection, () => true);
+        for (const entry of registry)
+            apply(entry.collection, entry.matches);
+    }
+    /** Refetch the base collection plus every scoped/byIds view after reconnect. */
+    async function refetchAll() {
+        await Promise.all([
+            collection.utils.refetch(),
+            ...registry.map((entry) => entry.refetch()),
+        ]);
+    }
+    return {
+        collection,
+        table: direct,
+        scopedCollection,
+        collectionByIds,
+        applyRealtimeEvent,
+        refetchAll,
+    };
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createSyncClient } from './sync-client.js';
+export type { BunderstackSyncClient, CreateFor, RowFor, SyncClientOptions } from './sync-client.js';
+export { createTableCollection } from './collection.js';
+export type { ScopedCollectionOptions, ScopedFilterValue, TableCollection, TableCollectionConfig } from './collection.js';
+export { createSyncRealtimeClient } from './realtime-sync.js';
+export type { SyncRealtimeConfig, SyncRealtimeTarget } from './realtime-sync.js';
+export type { AnyBunderstackApp, InferBuckets, InferInsert, InferSchema, InferSelect, InferTables, UploadedFile } from 'bunderstack-query';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACtH,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAC7E,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createSyncClient } from './sync-client.js';
+export { createTableCollection } from './collection.js';
+export { createSyncRealtimeClient } from './realtime-sync.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/realtime-sync.d.ts

@@ -0,0 +1,25 @@
+import type { QueryClient } from '@tanstack/react-query';
+import { type RealtimeQueryApi, type RealtimeSyncHandle } from 'bunderstack-query';
+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: RealtimeQueryApi;
+    queryClient: QueryClient;
+    tables: string[];
+    collections?: Record<string, SyncableCollection>;
+    resolve?: (table: string) => SyncRealtimeTarget | undefined;
+    resolveAll?: () => Iterable<SyncRealtimeTarget>;
+    retryMs?: number;
+};
+export declare function createSyncRealtimeClient(config: SyncRealtimeConfig): RealtimeSyncHandle;
+export {};
+//# sourceMappingURL=realtime-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sync.d.ts","sourceRoot":"","sources":["../src/realtime-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAA;AAE1B,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE;QACL,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;QACpC,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;QACnC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAC7B,CAAA;CACF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kBAAkB,EAAE,CAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,IAAI,CAAA;IACT,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,gBAAgB,CAAA;IACrB,WAAW,EAAE,WAAW,CAAA;IACxB,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,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAyBpB"}

package/dist/realtime-sync.js

@@ -0,0 +1,31 @@
+import { syncRealtime, } from 'bunderstack-query';
+export function createSyncRealtimeClient(config) {
+    const collections = config.collections ?? {};
+    return syncRealtime({
+        api: config.api,
+        queryClient: config.queryClient,
+        tables: config.tables,
+        retryMs: config.retryMs,
+        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()));
+        },
+    });
+}
+//# sourceMappingURL=realtime-sync.js.map

package/dist/realtime-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sync.js","sourceRoot":"","sources":["../src/realtime-sync.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAA;AA4B1B,MAAM,UAAU,wBAAwB,CACtC,MAA0B;IAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAA;IAC5C,OAAO,YAAY,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC3E,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;gBAAE,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;;gBAC1E,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,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;gBAChF,OAAM;YACR,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC/F,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/sync-client.d.ts

@@ -0,0 +1,32 @@
+import type { QueryClient } from '@tanstack/react-query';
+import { type AnyBunderstackApp, type BunderstackClient, type InferInsert, type InferSchema, type InferSelect, type InferTables } from 'bunderstack-query';
+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-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.d.ts","sourceRoot":"","sources":["../src/sync-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAG1E,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,OAAO,IACjF;IAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAAC,SAAS,CAAC,KAAK,CAAC,GACrC;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;AAE/B,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,OAAO,IACpF;IAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAAC,SAAS,CAAC,KAAK,CAAC,GACrC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAC3B,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAE7B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,CACN,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtB,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,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,SAAS,CAAA;CACpF,CAAA;AAED,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,EAAE,iBAAiB,GACzB,qBAAqB,CAAC,IAAI,CAAC,CA+C7B"}

package/dist/sync-client.js

@@ -0,0 +1,53 @@
+import { createClient, } from 'bunderstack-query';
+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,
+                    queryClient: options.queryClient,
+                    tables: [property],
+                    resolve: (table) => materialized.get(table),
+                    resolveAll: () => materialized.values(),
+                }));
+            }
+            return collection;
+        },
+    });
+    return result;
+}
+//# sourceMappingURL=sync-client.js.map

package/dist/sync-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.js","sourceRoot":"","sources":["../src/sync-client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,GAOb,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,qBAAqB,EAAwB,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,wBAAwB,EAA2B,MAAM,iBAAiB,CAAA;AAmCnF,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;gBAAE,OAAO,SAAS,CAAA;YACtF,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,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,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"}

package/dist/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/update-queue.d.ts.map

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