workerstack 0.1.0-beta.0

package/dist/storage/sigv4.js

@@ -0,0 +1,107 @@
+const encoder = new TextEncoder();
+function hex(bytes) {
+    return Array.from(new Uint8Array(bytes), (b) => b.toString(16).padStart(2, '0')).join('');
+}
+async function sha256Hex(data) {
+    const bytes = typeof data === 'string' ? encoder.encode(data) : data;
+    return hex(await crypto.subtle.digest('SHA-256', bytes));
+}
+async function hmac(key, data) {
+    const cryptoKey = await crypto.subtle.importKey('raw', key, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    return crypto.subtle.sign('HMAC', cryptoKey, encoder.encode(data));
+}
+async function signingKey(secret, day, region, service) {
+    const kDate = await hmac(encoder.encode(`AWS4${secret}`), day);
+    const kRegion = await hmac(kDate, region);
+    const kService = await hmac(kRegion, service);
+    return hmac(kService, 'aws4_request');
+}
+/** RFC 3986 encoding, as SigV4 requires: only A-Z a-z 0-9 - _ . ~ stay. */
+function uriEncode(value) {
+    return encodeURIComponent(value).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+/** S3 does not normalize paths: encode each segment once, keep the slashes. */
+function canonicalPath(pathname) {
+    return pathname
+        .split('/')
+        .map((segment) => uriEncode(decodeURIComponent(segment)))
+        .join('/');
+}
+function canonicalQuery(params) {
+    return [...params.entries()]
+        .map(([k, v]) => [uriEncode(k), uriEncode(v)])
+        .sort(([a, av], [b, bv]) => a < b ? -1 : a > b ? 1 : av < bv ? -1 : av > bv ? 1 : 0)
+        .map(([k, v]) => `${k}=${v}`)
+        .join('&');
+}
+function amzDates(date) {
+    const amzDate = date.toISOString().replace(/[:-]|\.\d{3}/g, '');
+    return { amzDate, day: amzDate.slice(0, 8) };
+}
+async function signature(credentials, day, amzDate, canonicalRequest) {
+    const service = credentials.service ?? 's3';
+    const scope = `${day}/${credentials.region}/${service}/aws4_request`;
+    const stringToSign = [
+        'AWS4-HMAC-SHA256',
+        amzDate,
+        scope,
+        await sha256Hex(canonicalRequest),
+    ].join('\n');
+    const key = await signingKey(credentials.secretAccessKey, day, credentials.region, service);
+    return { scope, signature: hex(await hmac(key, stringToSign)) };
+}
+export async function signRequest(input) {
+    const url = new URL(input.url);
+    const { amzDate, day } = amzDates(input.date ?? new Date());
+    const payloadHash = input.unsignedPayload
+        ? 'UNSIGNED-PAYLOAD'
+        : await sha256Hex(input.body ?? '');
+    const headers = {};
+    for (const [k, v] of Object.entries(input.headers ?? {})) {
+        headers[k.toLowerCase()] = v.trim();
+    }
+    headers['host'] = url.host;
+    headers['x-amz-date'] = amzDate;
+    headers['x-amz-content-sha256'] = payloadHash;
+    const names = Object.keys(headers).sort();
+    const canonicalRequest = [
+        input.method.toUpperCase(),
+        canonicalPath(url.pathname),
+        canonicalQuery(url.searchParams),
+        names.map((n) => `${n}:${headers[n]}\n`).join(''),
+        names.join(';'),
+        payloadHash,
+    ].join('\n');
+    const signed = await signature(input.credentials, day, amzDate, canonicalRequest);
+    headers['authorization'] =
+        `AWS4-HMAC-SHA256 Credential=${input.credentials.accessKeyId}/${signed.scope}, ` +
+            `SignedHeaders=${names.join(';')}, Signature=${signed.signature}`;
+    return headers;
+}
+export async function presignUrl(input) {
+    const url = new URL(input.url);
+    const { amzDate, day } = amzDates(input.date ?? new Date());
+    const service = input.credentials.service ?? 's3';
+    const headers = { host: url.host };
+    for (const [k, v] of Object.entries(input.signedHeaders ?? {})) {
+        headers[k.toLowerCase()] = v.trim();
+    }
+    const names = Object.keys(headers).sort();
+    url.searchParams.set('X-Amz-Algorithm', 'AWS4-HMAC-SHA256');
+    url.searchParams.set('X-Amz-Credential', `${input.credentials.accessKeyId}/${day}/${input.credentials.region}/${service}/aws4_request`);
+    url.searchParams.set('X-Amz-Date', amzDate);
+    url.searchParams.set('X-Amz-Expires', String(input.expiresIn));
+    url.searchParams.set('X-Amz-SignedHeaders', names.join(';'));
+    const canonicalRequest = [
+        input.method.toUpperCase(),
+        canonicalPath(url.pathname),
+        canonicalQuery(url.searchParams),
+        names.map((n) => `${n}:${headers[n]}\n`).join(''),
+        names.join(';'),
+        'UNSIGNED-PAYLOAD',
+    ].join('\n');
+    const signed = await signature(input.credentials, day, amzDate, canonicalRequest);
+    url.searchParams.set('X-Amz-Signature', signed.signature);
+    return url.toString();
+}
+//# sourceMappingURL=sigv4.js.map

package/dist/storage/sigv4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sigv4.js","sourceRoot":"","sources":["../../src/storage/sigv4.ts"],"names":[],"mappings":"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","sourcesContent":["// src/storage/sigv4.ts — AWS Signature Version 4 on WebCrypto, so S3 access\n// and presigned URLs work in Bun, workerd, and celld without Bun.S3Client.\nexport type SigV4Credentials = {\n  accessKeyId: string\n  secretAccessKey: string\n  region: string\n  service?: string\n}\n\nconst encoder = new TextEncoder()\n\nfunction hex(bytes: ArrayBuffer): string {\n  return Array.from(new Uint8Array(bytes), (b) =>\n    b.toString(16).padStart(2, '0'),\n  ).join('')\n}\n\nasync function sha256Hex(\n  data: ArrayBuffer | Uint8Array<ArrayBuffer> | string,\n): Promise<string> {\n  const bytes = typeof data === 'string' ? encoder.encode(data) : data\n  return hex(await crypto.subtle.digest('SHA-256', bytes))\n}\n\nasync function hmac(\n  key: ArrayBuffer | Uint8Array<ArrayBuffer>,\n  data: string,\n): Promise<ArrayBuffer> {\n  const cryptoKey = await crypto.subtle.importKey(\n    'raw',\n    key,\n    { name: 'HMAC', hash: 'SHA-256' },\n    false,\n    ['sign'],\n  )\n  return crypto.subtle.sign('HMAC', cryptoKey, encoder.encode(data))\n}\n\nasync function signingKey(\n  secret: string,\n  day: string,\n  region: string,\n  service: string,\n): Promise<ArrayBuffer> {\n  const kDate = await hmac(encoder.encode(`AWS4${secret}`), day)\n  const kRegion = await hmac(kDate, region)\n  const kService = await hmac(kRegion, service)\n  return hmac(kService, 'aws4_request')\n}\n\n/** RFC 3986 encoding, as SigV4 requires: only A-Z a-z 0-9 - _ . ~ stay. */\nfunction uriEncode(value: string): string {\n  return encodeURIComponent(value).replace(\n    /[!'()*]/g,\n    (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`,\n  )\n}\n\n/** S3 does not normalize paths: encode each segment once, keep the slashes. */\nfunction canonicalPath(pathname: string): string {\n  return pathname\n    .split('/')\n    .map((segment) => uriEncode(decodeURIComponent(segment)))\n    .join('/')\n}\n\nfunction canonicalQuery(params: URLSearchParams): string {\n  return [...params.entries()]\n    .map(([k, v]) => [uriEncode(k), uriEncode(v)] as const)\n    .sort(([a, av], [b, bv]) =>\n      a < b ? -1 : a > b ? 1 : av < bv ? -1 : av > bv ? 1 : 0,\n    )\n    .map(([k, v]) => `${k}=${v}`)\n    .join('&')\n}\n\nfunction amzDates(date: Date): { amzDate: string; day: string } {\n  const amzDate = date.toISOString().replace(/[:-]|\\.\\d{3}/g, '')\n  return { amzDate, day: amzDate.slice(0, 8) }\n}\n\nasync function signature(\n  credentials: SigV4Credentials,\n  day: string,\n  amzDate: string,\n  canonicalRequest: string,\n): Promise<{ scope: string; signature: string }> {\n  const service = credentials.service ?? 's3'\n  const scope = `${day}/${credentials.region}/${service}/aws4_request`\n  const stringToSign = [\n    'AWS4-HMAC-SHA256',\n    amzDate,\n    scope,\n    await sha256Hex(canonicalRequest),\n  ].join('\\n')\n  const key = await signingKey(\n    credentials.secretAccessKey,\n    day,\n    credentials.region,\n    service,\n  )\n  return { scope, signature: hex(await hmac(key, stringToSign)) }\n}\n\nexport async function signRequest(input: {\n  method: string\n  url: string\n  headers?: Record<string, string>\n  body?: ArrayBuffer | Uint8Array<ArrayBuffer> | string | null\n  credentials: SigV4Credentials\n  date?: Date\n  unsignedPayload?: boolean\n}): Promise<Record<string, string>> {\n  const url = new URL(input.url)\n  const { amzDate, day } = amzDates(input.date ?? new Date())\n  const payloadHash = input.unsignedPayload\n    ? 'UNSIGNED-PAYLOAD'\n    : await sha256Hex(input.body ?? '')\n  const headers: Record<string, string> = {}\n  for (const [k, v] of Object.entries(input.headers ?? {})) {\n    headers[k.toLowerCase()] = v.trim()\n  }\n  headers['host'] = url.host\n  headers['x-amz-date'] = amzDate\n  headers['x-amz-content-sha256'] = payloadHash\n  const names = Object.keys(headers).sort()\n  const canonicalRequest = [\n    input.method.toUpperCase(),\n    canonicalPath(url.pathname),\n    canonicalQuery(url.searchParams),\n    names.map((n) => `${n}:${headers[n]}\\n`).join(''),\n    names.join(';'),\n    payloadHash,\n  ].join('\\n')\n  const signed = await signature(\n    input.credentials,\n    day,\n    amzDate,\n    canonicalRequest,\n  )\n  headers['authorization'] =\n    `AWS4-HMAC-SHA256 Credential=${input.credentials.accessKeyId}/${signed.scope}, ` +\n    `SignedHeaders=${names.join(';')}, Signature=${signed.signature}`\n  return headers\n}\n\nexport async function presignUrl(input: {\n  method: string\n  url: string\n  credentials: SigV4Credentials\n  expiresIn: number\n  date?: Date\n  signedHeaders?: Record<string, string>\n}): Promise<string> {\n  const url = new URL(input.url)\n  const { amzDate, day } = amzDates(input.date ?? new Date())\n  const service = input.credentials.service ?? 's3'\n  const headers: Record<string, string> = { host: url.host }\n  for (const [k, v] of Object.entries(input.signedHeaders ?? {})) {\n    headers[k.toLowerCase()] = v.trim()\n  }\n  const names = Object.keys(headers).sort()\n  url.searchParams.set('X-Amz-Algorithm', 'AWS4-HMAC-SHA256')\n  url.searchParams.set(\n    'X-Amz-Credential',\n    `${input.credentials.accessKeyId}/${day}/${input.credentials.region}/${service}/aws4_request`,\n  )\n  url.searchParams.set('X-Amz-Date', amzDate)\n  url.searchParams.set('X-Amz-Expires', String(input.expiresIn))\n  url.searchParams.set('X-Amz-SignedHeaders', names.join(';'))\n  const canonicalRequest = [\n    input.method.toUpperCase(),\n    canonicalPath(url.pathname),\n    canonicalQuery(url.searchParams),\n    names.map((n) => `${n}:${headers[n]}\\n`).join(''),\n    names.join(';'),\n    'UNSIGNED-PAYLOAD',\n  ].join('\\n')\n  const signed = await signature(\n    input.credentials,\n    day,\n    amzDate,\n    canonicalRequest,\n  )\n  url.searchParams.set('X-Amz-Signature', signed.signature)\n  return url.toString()\n}\n"]}

package/dist/storage/sweep.d.ts

@@ -0,0 +1,9 @@
+import type { AnyDb } from '../dialect.js';
+import type { BucketStorageRegistry } from './registry.js';
+/**
+ * Reap stale `pending` file-meta rows (two-phase uploads that never confirmed)
+ * older than `olderThanMs`. For each, best-effort delete the object (it may
+ * never have landed) then remove the meta row. Returns the number reaped.
+ */
+export declare function sweepOrphans(registry: BucketStorageRegistry, db: AnyDb, olderThanMs: number): Promise<number>;
+//# sourceMappingURL=sweep.d.ts.map

package/dist/storage/sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../../src/storage/sweep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAIvD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,qBAAqB,EAC/B,EAAE,EAAE,KAAK,EACT,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/storage/sweep.js

@@ -0,0 +1,17 @@
+import { deleteFileMetaRow, listStalePendingFiles } from './file-meta.js';
+/**
+ * Reap stale `pending` file-meta rows (two-phase uploads that never confirmed)
+ * older than `olderThanMs`. For each, best-effort delete the object (it may
+ * never have landed) then remove the meta row. Returns the number reaped.
+ */
+export async function sweepOrphans(registry, db, olderThanMs) {
+    const cutoff = Date.now() - olderThanMs;
+    const rows = await listStalePendingFiles(db, cutoff);
+    for (const row of rows) {
+        const adapter = registry.get(row.bucket)?.adapter;
+        await adapter?.delete(row.fileId).catch(() => { });
+        await deleteFileMetaRow(db, row.fileId);
+    }
+    return rows.length;
+}
+//# sourceMappingURL=sweep.js.map

package/dist/storage/sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.js","sourceRoot":"","sources":["../../src/storage/sweep.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEtE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA+B,EAC/B,EAAS,EACT,WAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IACpD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;QACjD,MAAM,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACjD,MAAM,iBAAiB,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAA;AACpB,CAAC","sourcesContent":["// src/storage/sweep.ts\nimport type { AnyDb } from '../dialect'\nimport type { BucketStorageRegistry } from './registry'\n\nimport { deleteFileMetaRow, listStalePendingFiles } from './file-meta'\n\n/**\n * Reap stale `pending` file-meta rows (two-phase uploads that never confirmed)\n * older than `olderThanMs`. For each, best-effort delete the object (it may\n * never have landed) then remove the meta row. Returns the number reaped.\n */\nexport async function sweepOrphans(\n  registry: BucketStorageRegistry,\n  db: AnyDb,\n  olderThanMs: number,\n): Promise<number> {\n  const cutoff = Date.now() - olderThanMs\n  const rows = await listStalePendingFiles(db, cutoff)\n  for (const row of rows) {\n    const adapter = registry.get(row.bucket)?.adapter\n    await adapter?.delete(row.fileId).catch(() => {})\n    await deleteFileMetaRow(db, row.fileId)\n  }\n  return rows.length\n}\n"]}

package/dist/sync/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/sync/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/sync/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,cAAc,CAAA;AAMrB,KAAK,eAAe,CAAC,IAAI,IAAI;IAC3B,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,KAAK,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI;IAC7C,IAAI,EAAE;QACJ,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;KACtE,CAAA;IACD,GAAG,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;IACnD,MAAM,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;IAC/C,MAAM,EAAE;QACN,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;YACtB,KAAK,EAAE,EAAE,CAAA;YACT,OAAO,EAAE,EAAE,CAAA;YACX,IAAI,EAAE,OAAO,CAAA;SACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAClB,CAAA;IACD,MAAM,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;CACvD,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI;IACnD,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC1C,WAAW,EAAE,WAAW,CAAA;IACxB;8EAC0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;AAEhC,MAAM,MAAM,uBAAuB,GAAG;IACpC;;mDAE+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AA2BD,wBAAgB,qBAAqB,CACnC,IAAI,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACpC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,EACvB,MAAM,EAAE,qBAAqB;;;iCAqHlB,uBAAuB;;QAThC,8EAA8E;kBACpE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;QAC3C,6EAA6E;iBACpE,MAAM,OAAO;QACtB,mCAAmC;cAC7B,MAAM,MAAM;;2BAkFb,SAAS,IAAI,CAAC,IAAI,CAAC,EAAE,YACjB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;iCA0CpB,QAAQ,GAAG,QAAQ,GAAG,QAAQ,UAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAqClC;AAED,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,IAAI;IACnE,UAAU,EAAE,UAAU,CACpB,IAAI,EACJ,MAAM,GAAG,MAAM,EACf,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnB,cAAc,CAAC,IAAI,CAAC,CACrB,CAAA;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,IAAI,EAAE,MAAM,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,eAAe,CACzB,IAAI,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACpC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IACrB;IACF,UAAU,EAAE,UAAU,CACpB,IAAI,EACJ,MAAM,GAAG,MAAM,EACf,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnB,cAAc,CAAC,IAAI,CAAC,CACrB,CAAA;IACD,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7C,gBAAgB,EAAE,CAChB,OAAO,CAAC,EAAE,uBAAuB,KAC9B,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC3B,eAAe,EAAE,CACf,GAAG,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACjC,MAAM,CAAC,EAAE,MAAM,KACZ,UAAU,CACb,IAAI,EACJ,MAAM,GAAG,MAAM,EACf,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnB,cAAc,CAAC,IAAI,CAAC,CACrB,CAAA;IACD,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"}

package/dist/sync/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/sync/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/sync/collection.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,GAGjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,MAAM,cAAc,GAAG,GAAG,CAAA;AAiE1B,SAAS,aAAa,CACpB,MAA+B,EAC/B,OAA0C;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAO,KAAK,CAAA;QAClC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;QAClE,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAA;IAC9D,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,6EAA6E;AAC7E,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;SAC7D,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC1D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAInC,MAA6B;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAqD,CAAA;IAC1E,MAAM,MAAM,GAA2C;QACrD,IAAI,EAAE,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAC5C,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CACpB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;YAChB,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE;YAC1B,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,KAAK;SACZ,CAAC;QACJ,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;KACtD,CAAA;IAED,MAAM,UAAU,GAAG,gBAAgB,CACjC,sBAAsB,CAAO;QAC3B,QAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC;QAC1C,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;YAClE,OAAO,IAAI,CAAC,KAAK,CAAA;QACnB,CAAC;QACD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAClC,IAAI,UAAU,GAAG,IAAI,CAAA;YACrB,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;gBAC7C,8DAA8D;gBAC9D,oEAAoE;gBACpE,kEAAkE;gBAClE,gEAAgE;gBAChE,kEAAkE;gBAClE,iBAAiB;gBACjB,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAClC,QAAQ,CAAC,QAA8B,CACxC,CAAqB,CAAA;gBACtB,oEAAoE;gBACpE,qEAAqE;gBACrE,wDAAwD;gBACxD,IAAI,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/D,kBAAkB,CAAC,QAAQ,EAAE,GAA8B,CAAC,CAAA;gBAC9D,CAAC;qBAAM,CAAC;oBACN,UAAU,GAAG,KAAK,CAAA;gBACpB,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7C,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAClC,MAAM,OAAO,CAAC,GAAG,CACf,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrC,WAAW,CAAC,OAAO,CACjB,QAAQ,CAAC,GAAiB,EAC1B,QAAQ,CAAC,OAAkC,CAC5C,CACF,CACF,CAAA;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QAC3B,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAClC,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;gBAC7C,oEAAoE;gBACpE,yDAAyD;gBACzD,MAAM,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAiB,CAAC,CAAA;gBACpD,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACrD,kBAAkB,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAA;YACpD,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QAC3B,CAAC;KACF,CAAC,CACH,CAAA;IAED,yEAAyE;IACzE,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,WAAW,GAAG,iBAAiB,CAAmB;QACtD,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CACpB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;YAChB,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE;YAC1B,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,OAA6B;SACpC,CAAC;QACJ,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,qEAAqE;YACrE,iEAAiE;YACjE,sEAAsE;YACtE,IAAK,GAAwB,EAAE,EAAE,IAAI,IAAI;gBACvC,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;;gBAC7B,kBAAkB,CAAC,QAAQ,EAAE,GAA8B,CAAC,CAAA;QACnE,CAAC;KACF,CAAC,CAAA;IAIF,uEAAuE;IACvE,qEAAqE;IACrE,sEAAsE;IACtE,MAAM,QAAQ,GAIR,EAAE,CAAA;IAER,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAA;IAYvD,SAAS,gBAAgB,CACvB,UAAmC,EAAE;QAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,OAAO,CAAC,QAAQ,IAAI,cAAc,EAClC,cAAc,CACf,CAAA;QACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAA;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAA;QACrC,MAAM,QAAQ,GAAG,SAAS,CAAC;YACzB,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;YAC5B,QAAQ;YACR,YAAY;SACb,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,IAAI,YAAY,GAAG,YAAY,CAAA;QAC/B,IAAI,aAAa,GAAG,KAAK,CAAA;QAEzB,MAAM,MAAM,GAAG,gBAAgB,CAC7B,sBAAsB,CAAO;YAC3B,QAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;YAChD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,kEAAkE;gBAClE,gEAAgE;gBAChE,8DAA8D;gBAC9D,6DAA6D;gBAC7D,kDAAkD;gBAClD,MAAM,KAAK,GAAW,EAAE,CAAA;gBACxB,IAAI,MAA0B,CAAA;gBAC9B,IAAI,IAAI,GAAG,KAAK,CAAA;gBAChB,OAAO,KAAK,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;oBACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;oBACjE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;wBACjC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACnD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC/C,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClD,KAAK,EAAE,SAAS;wBAChB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC9B,CAAC,CAAA;oBACF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;oBACzB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAA;oBAC/C,IAAI,CAAC,IAAI;wBAAE,MAAK;oBAChB,MAAM,GAAG,IAAI,CAAC,UAAU,CAAA;gBAC1B,CAAC;gBACD,aAAa,GAAG,IAAI,CAAA;gBACpB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;YACrC,CAAC;YACD,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;SAC1B,CAAC,CACH,CAAA;QAED,MAAM,KAAK,GAAqB;YAC9B,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACxB,YAAY,IAAI,KAAK,IAAI,YAAY,CAAA;gBACrC,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;YAC9B,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa;YAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY;SACzB,CAAA;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC;YACnD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;YAC9B,CAAC;SACF,CAAC,CAAA;QACF,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAChC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAA;IAEhD,SAAS,eAAe,CACtB,GAA0B,EAC1B,UAA+B,EAAE;QAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAA;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1D,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;QAChD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,gBAAgB,CAC5B,sBAAsB,CAAO;YAC3B,QAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;YACrD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAA;gBAClC,MAAM,KAAK,GAAW,EAAE,CAAA;gBACxB,6DAA6D;gBAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC;oBACvD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,CAAA;oBACjD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;wBACjC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;wBAC5B,KAAK,EAAE,KAAK,CAAC,MAAM;qBACpB,CAAC,CAAA;oBACF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC3B,CAAC;gBACD,OAAO,KAAK,CAAA;YACd,CAAC;YACD,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;SAC1B,CAAC,CACH,CAAA;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;YAC7B,CAAC;SACF,CAAC,CAAA;QACF,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC/B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,SAAS,kBAAkB,CACzB,MAAsC,EACtC,MAA+B;QAE/B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAoB,CAAA;QAC1C,MAAM,KAAK,GAAG,CACZ,MAAkB,EAClB,OAAqD,EACrD,EAAE;YACF,oEAAoE;YACpE,qEAAqE;YACrE,qBAAqB;YACrB,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;gBAAE,OAAM;YACrC,IAAI,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS;oBAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YAChE,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAyB,CAAC,CAAA;YACrD,CAAC;QACH,CAAC,CAAA;QACD,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAC7B,KAAK,MAAM,KAAK,IAAI,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACtE,CAAC;IAED,gFAAgF;IAChF,KAAK,UAAU,UAAU;QACvB,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE;YAC1B,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;SAC5C,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,UAAU;QACV,KAAK,EAAE,MAAM;QACb,gBAAgB;QAChB,eAAe;QACf,kBAAkB;QAClB,UAAU;KACX,CAAA;AACH,CAAC","sourcesContent":["import type { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createCollection,\n  type Collection,\n  type StandardSchema,\n} from '@tanstack/db'\nimport { queryCollectionOptions } from '@tanstack/query-db-collection'\n\nimport { createUpdateQueue } from './update-queue'\nconst MAX_LIST_LIMIT = 200\n\ntype TableListResult<TRow> = {\n  items: TRow[]\n  hasMore: boolean\n  nextCursor?: string\n  total?: number\n  limit?: number\n  offset?: number\n}\n\ntype TableProcedures<TRow, TCreate, TUpdate> = {\n  list: {\n    call(input?: Record<string, unknown>): Promise<TableListResult<TRow>>\n  }\n  get: { call(input: { id: string }): Promise<TRow> }\n  create: { call(input: TCreate): Promise<TRow> }\n  update: {\n    call(input: {\n      params: { id: string }\n      query: {}\n      headers: {}\n      body: TUpdate\n    }): Promise<TRow>\n  }\n  delete: { call(input: { id: string }): Promise<void> }\n}\n\nexport type DirectTableApi<TRow, TCreate, TUpdate> = {\n  list(input?: Record<string, unknown>): Promise<TableListResult<TRow>>\n  get(id: string | number): Promise<TRow>\n  create(input: TCreate): Promise<TRow>\n  update(id: string | number, input: TUpdate): Promise<TRow>\n  delete(id: string | number): Promise<void>\n}\n\nexport type TableCollectionConfig = {\n  tableName: string\n  procedures: TableProcedures<any, any, any>\n  queryClient: QueryClient\n  /** Rows the default `.collection` syncs per fetch. Defaults to 100. For\n   * feed-shaped tables that need real pagination use `scopedCollection`. */\n  limit?: number\n}\n\nexport type ScopedFilterValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly (string | number)[]\n\nexport type ScopedCollectionOptions = {\n  /** Equality filters, e.g. `{ replyToId: null }` — columns must be in the\n   * table's `filterableColumns` server-side. Same name and shape as the\n   * `filters` accepted by the list procedure. */\n  filters?: Record<string, ScopedFilterValue>\n  sort?: string\n  order?: 'asc' | 'desc'\n  /** Rows per underlying request; clamped to the server cap (200). */\n  pageSize?: number\n  /** Window size on first load and default `loadMore` step. Defaults to 20. */\n  initialCount?: number\n}\n\nfunction matchesFilter(\n  record: Record<string, unknown>,\n  filters: Record<string, ScopedFilterValue>,\n): boolean {\n  for (const [col, expected] of Object.entries(filters)) {\n    const actual = record[col]\n    if (expected === null) {\n      if (actual != null) return false\n    } else if (Array.isArray(expected)) {\n      if (!expected.map(String).includes(String(actual))) return false\n    } else if (String(actual) !== String(expected)) return false\n  }\n  return true\n}\n\n/** Deterministic serialization for cache keys (object key order ignored). */\nfunction stableKey(value: unknown): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value)\n  if (Array.isArray(value)) return `[${value.map(stableKey).join(',')}]`\n  const entries = Object.entries(value as Record<string, unknown>)\n    .sort(([a], [b]) => (a < b ? -1 : 1))\n    .map(([k, v]) => `${JSON.stringify(k)}:${stableKey(v)}`)\n  return `{${entries.join(',')}}`\n}\n\nexport function createTableCollection<\n  TRow extends { id: string | number },\n  TCreate = Partial<TRow>,\n  TUpdate = Partial<TRow>,\n>(config: TableCollectionConfig) {\n  const table = config.procedures as TableProcedures<TRow, TCreate, TUpdate>\n  const direct: DirectTableApi<TRow, TCreate, TUpdate> = {\n    list: (input = {}) => table.list.call(input),\n    get: (id) => table.get.call({ id: String(id) }),\n    create: (input) => table.create.call(input),\n    update: (id, input) =>\n      table.update.call({\n        params: { id: String(id) },\n        query: {},\n        headers: {},\n        body: input,\n      }),\n    delete: (id) => table.delete.call({ id: String(id) }),\n  }\n\n  const collection = createCollection(\n    queryCollectionOptions<TRow>({\n      queryKey: [config.tableName, 'collection'],\n      queryFn: async () => {\n        const page = await table.list.call({ limit: config.limit ?? 100 })\n        return page.items\n      },\n      queryClient: config.queryClient,\n      getKey: (item) => item.id,\n      onInsert: async ({ transaction }) => {\n        let reconciled = true\n        for (const mutation of transaction.mutations) {\n          // Pass the client-generated `id` through as-is. TanStack DB's\n          // optimistic insert keys the local row by this `id` (via `getKey`),\n          // and this matches `sanitizeWriteBody`'s default on the server: a\n          // client-supplied `id` on create is accepted unless the table's\n          // access config sets an explicit `writableColumns` allowlist that\n          // excludes `id`.\n          const row = (await table.create.call(\n            mutation.modified as unknown as TCreate,\n          )) as TRow | undefined\n          // Apps that DO restrict it that way get a server-assigned id, which\n          // leaves the optimistic row keyed under the client's — `writeUpsert`\n          // can't retire that, so those fall back to the refetch.\n          if (row?.id != null && String(row.id) === String(mutation.key)) {\n            applyRealtimeEvent('create', row as Record<string, unknown>)\n          } else {\n            reconciled = false\n          }\n        }\n        return reconciled ? { refetch: false } : {}\n      },\n      onUpdate: async ({ transaction }) => {\n        await Promise.all(\n          transaction.mutations.map((mutation) =>\n            updateQueue.enqueue(\n              mutation.key as TRow['id'],\n              mutation.changes as Record<string, unknown>,\n            ),\n          ),\n        )\n        return { refetch: false }\n      },\n      onDelete: async ({ transaction }) => {\n        for (const mutation of transaction.mutations) {\n          // Updates still queued for this row are superseded, and one already\n          // in flight must land before the DELETE or the two race.\n          await updateQueue.settle(mutation.key as TRow['id'])\n          await table.delete.call({ id: String(mutation.key) })\n          applyRealtimeEvent('delete', { id: mutation.key })\n        }\n        return { refetch: false }\n      },\n    }),\n  )\n\n  // Cursor-shaped workloads call `update()` many times a second. The queue\n  // merges everything that piles up for a row while its request is in flight\n  // into a single follow-up, so request rate tracks RTT, not call rate.\n  const updateQueue = createUpdateQueue<TRow['id'], TRow>({\n    send: (id, changes) =>\n      table.update.call({\n        params: { id: String(id) },\n        query: {},\n        headers: {},\n        body: changes as unknown as TUpdate,\n      }),\n    onResult: async (row) => {\n      // `writeUpsert` writes the response whole, so mutation endpoints are\n      // contracted to return a full row. A body without an id can't be\n      // reconciled locally — fall back to the refetch rather than write it.\n      if ((row as TRow | undefined)?.id == null)\n        await collection.utils.refetch()\n      else applyRealtimeEvent('update', row as Record<string, unknown>)\n    },\n  })\n\n  type Collection = typeof collection\n\n  // Scoped/byIds collections register here so realtime events fan out to\n  // every live view of this table, filtered client-side by each view's\n  // own predicate (broadcasts are already access-filtered server-side).\n  const registry: {\n    collection: Collection\n    matches: (record: Record<string, unknown>) => boolean\n    refetch: () => Promise<void>\n  }[] = []\n\n  const scopedCache = new Map<string, ScopedCollection>()\n\n  type ScopedCollection = {\n    collection: Collection\n    /** Grow the window by `count` (default initialCount) and refetch in place. */\n    loadMore: (count?: number) => Promise<void>\n    /** Whether the server reported rows beyond the window (as of last fetch). */\n    hasMore: () => boolean\n    /** Current desired window size. */\n    size: () => number\n  }\n\n  function scopedCollection(\n    options: ScopedCollectionOptions = {},\n  ): ScopedCollection {\n    const pageSize = Math.min(\n      options.pageSize ?? MAX_LIST_LIMIT,\n      MAX_LIST_LIMIT,\n    )\n    const initialCount = options.initialCount ?? 20\n    const filters = options.filters ?? {}\n    const cacheKey = stableKey({\n      filters,\n      sort: options.sort ?? null,\n      order: options.order ?? null,\n      pageSize,\n      initialCount,\n    })\n    const cached = scopedCache.get(cacheKey)\n    if (cached) return cached\n\n    let desiredCount = initialCount\n    let serverHasMore = false\n\n    const scoped = createCollection(\n      queryCollectionOptions<TRow>({\n        queryKey: [config.tableName, 'scoped', cacheKey],\n        queryFn: async () => {\n          // Growing window: walk cursor pages (each ≤ the server cap) until\n          // the current desired count is collected or the table runs out.\n          // The collection stays stable across loadMore — refetching in\n          // place only ever adds rows, so already-rendered items never\n          // unmount (no scroll jumps or zero-item flashes).\n          const items: TRow[] = []\n          let cursor: string | undefined\n          let more = false\n          while (items.length < desiredCount) {\n            const remaining = Math.min(pageSize, desiredCount - items.length)\n            const page = await table.list.call({\n              ...(Object.keys(filters).length ? { filters } : {}),\n              ...(options.sort ? { sort: options.sort } : {}),\n              ...(options.order ? { order: options.order } : {}),\n              limit: remaining,\n              ...(cursor ? { cursor } : {}),\n            })\n            items.push(...page.items)\n            more = Boolean(page.hasMore && page.nextCursor)\n            if (!more) break\n            cursor = page.nextCursor\n          }\n          serverHasMore = more\n          return items.slice(0, desiredCount)\n        },\n        queryClient: config.queryClient,\n        getKey: (item) => item.id,\n      }),\n    )\n\n    const entry: ScopedCollection = {\n      collection: scoped,\n      loadMore: async (count) => {\n        desiredCount += count ?? initialCount\n        await scoped.utils.refetch()\n      },\n      hasMore: () => serverHasMore,\n      size: () => desiredCount,\n    }\n    registry.push({\n      collection: scoped,\n      matches: (record) => matchesFilter(record, filters),\n      refetch: async () => {\n        await scoped.utils.refetch()\n      },\n    })\n    scopedCache.set(cacheKey, entry)\n    return entry\n  }\n\n  const byIdsCache = new Map<string, Collection>()\n\n  function collectionByIds(\n    ids: readonly TRow['id'][],\n    options: { column?: string } = {},\n  ): Collection {\n    const column = options.column ?? 'id'\n    const unique = Array.from(new Set(ids.map(String))).sort()\n    const cacheKey = `${column}:${unique.join(',')}`\n    const cached = byIdsCache.get(cacheKey)\n    if (cached) return cached\n\n    const idSet = new Set(unique)\n    const byIds = createCollection(\n      queryCollectionOptions<TRow>({\n        queryKey: [config.tableName, 'byIds', column, unique],\n        queryFn: async () => {\n          if (unique.length === 0) return []\n          const items: TRow[] = []\n          // Chunked at the server's IN-filter cap so any id set works.\n          for (let i = 0; i < unique.length; i += MAX_LIST_LIMIT) {\n            const chunk = unique.slice(i, i + MAX_LIST_LIMIT)\n            const page = await table.list.call({\n              filters: { [column]: chunk },\n              limit: chunk.length,\n            })\n            items.push(...page.items)\n          }\n          return items\n        },\n        queryClient: config.queryClient,\n        getKey: (item) => item.id,\n      }),\n    )\n    registry.push({\n      collection: byIds,\n      matches: (record) => idSet.has(String(record[column])),\n      refetch: async () => {\n        await byIds.utils.refetch()\n      },\n    })\n    byIdsCache.set(cacheKey, byIds)\n    return byIds\n  }\n\n  function applyRealtimeEvent(\n    action: 'create' | 'update' | 'delete',\n    record: Record<string, unknown>,\n  ) {\n    const id = record['id'] as string | number\n    const apply = (\n      target: Collection,\n      matches: (record: Record<string, unknown>) => boolean,\n    ) => {\n      // Collections that never started syncing (no subscribers yet) can't\n      // accept manual writes — and don't need to: their first sync fetches\n      // fresh data anyway.\n      if (target.status !== 'ready') return\n      if (action === 'delete' || !matches(record)) {\n        if (target.get(id) !== undefined) target.utils.writeDelete(id)\n      } else {\n        target.utils.writeUpsert(record as unknown as TRow)\n      }\n    }\n    apply(collection, () => true)\n    for (const entry of registry) apply(entry.collection, entry.matches)\n  }\n\n  /** Refetch the base collection plus every scoped/byIds view after reconnect. */\n  async function refetchAll() {\n    await Promise.all([\n      collection.utils.refetch(),\n      ...registry.map((entry) => entry.refetch()),\n    ])\n  }\n\n  return {\n    collection,\n    table: direct,\n    scopedCollection,\n    collectionByIds,\n    applyRealtimeEvent,\n    refetchAll,\n  }\n}\n\nexport type ScopedCollection<TRow extends { id: string | number }> = {\n  collection: Collection<\n    TRow,\n    string | number,\n    Record<string, any>,\n    StandardSchema<TRow>\n  >\n  loadMore: (count?: number) => Promise<void>\n  hasMore: () => boolean\n  size: () => number\n}\n\nexport type TableCollection<\n  TRow extends { id: string | number },\n  TCreate = Partial<TRow>,\n  TUpdate = Partial<TRow>,\n> = {\n  collection: Collection<\n    TRow,\n    string | number,\n    Record<string, any>,\n    StandardSchema<TRow>\n  >\n  table: DirectTableApi<TRow, TCreate, TUpdate>\n  scopedCollection: (\n    options?: ScopedCollectionOptions,\n  ) => ScopedCollection<TRow>\n  collectionByIds: (\n    ids: readonly (string | number)[],\n    column?: string,\n  ) => Collection<\n    TRow,\n    string | number,\n    Record<string, any>,\n    StandardSchema<TRow>\n  >\n  applyRealtimeEvent: (\n    action: 'create' | 'update' | 'delete',\n    record: Record<string, unknown>,\n  ) => void\n  refetchAll: () => Promise<void>\n}\n"]}

package/dist/sync/index.d.ts

@@ -0,0 +1,8 @@
+export { createSyncClient } from './sync-client.js';
+export type { WorkerstackSyncClient, 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 { AnyWorkerstackApp, InferBuckets, InferInsert, InferSchema, InferSelect, InferTables, UploadedFile, } from '../query/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EACV,qBAAqB,EACrB,SAAS,EACT,MAAM,EACN,iBAAiB,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAC7E,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAA"}

package/dist/sync/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/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAOhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAOpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA","sourcesContent":["export { createSyncClient } from './sync-client'\nexport type {\n  WorkerstackSyncClient,\n  CreateFor,\n  RowFor,\n  SyncClientOptions,\n} from './sync-client'\nexport { createTableCollection } from './collection'\nexport type {\n  ScopedCollectionOptions,\n  ScopedFilterValue,\n  TableCollection,\n  TableCollectionConfig,\n} from './collection'\nexport { createSyncRealtimeClient } from './realtime-sync'\nexport type { SyncRealtimeConfig, SyncRealtimeTarget } from './realtime-sync'\nexport type {\n  AnyWorkerstackApp,\n  InferBuckets,\n  InferInsert,\n  InferSchema,\n  InferSelect,\n  InferTables,\n  UploadedFile,\n} from '../query/index'\n"]}