bunderstack 0.20.0 → 0.21.1

package/dist/start/index.d.ts

@@ -0,0 +1,66 @@
+import { QueryClient } from '@tanstack/react-query';
+import { type AnyBunderstackApp, type BunderstackClient } from '../query/index.js';
+export { createIsomorphicFetch } from './isomorphic-fetch.js';
+export type BunderstackStartOptions = {
+    /** API mount point. Defaults to '/api'. */
+    baseUrl?: string;
+    /** Default query staleTime (ms). Defaults to 30_000. */
+    staleTime?: number;
+};
+/**
+ * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible
+ * QueryClient defaults, and a typed query client whose procedures and buckets are
+ * inferred from the server app type.
+ *
+ * @example
+ * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start
+ * // entry-point name (it would replace the hydration entry).
+ * import type { App } from './bunderstack'
+ * export const { createQueryClient, createApi } = bunderstackStart<App>()
+ */
+export declare function bunderstackStart<TApp extends AnyBunderstackApp>(options?: BunderstackStartOptions): {
+    createQueryClient: () => QueryClient;
+    createApi: (queryClient: QueryClient) => BunderstackClient<TApp>;
+};
+type StartRequestContext = {
+    request: Request;
+};
+type StartHandler = (ctx: StartRequestContext) => Promise<Response>;
+/**
+ * Handlers object for the catch-all API file route.
+ *
+ * @example
+ * // src/routes/api/$.tsx
+ * export const Route = createFileRoute('/api/$')({
+ *   server: { handlers: createApiHandlers(app) },
+ * })
+ */
+export declare function createApiHandlers(app: {
+    handler: (req: Request) => Promise<Response>;
+}): {
+    GET: StartHandler;
+    POST: StartHandler;
+    PATCH: StartHandler;
+    DELETE: StartHandler;
+};
+export type SessionUser = {
+    id: string;
+    email: string;
+    name: string;
+    image?: string | null;
+    role?: string;
+};
+type SessionApp = {
+    auth: {
+        api: {
+            getSession: (opts: {
+                headers: Headers;
+            }) => Promise<{
+                user: SessionUser | null;
+            } | null>;
+        };
+    };
+};
+/** Resolve the BetterAuth session user for an incoming request (server-side). */
+export declare function getSessionUser(app: SessionApp, request: Request): Promise<SessionUser | null>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,GAAE,uBAA4B;;6BAUV,WAAW,KAAG,iBAAiB,CAAC,IAAI,CAAC;EAOjE;AAED,KAAK,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C,GAAG;IACF,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;CACrB,CAGA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE;YACH,UAAU,EAAE,CAAC,IAAI,EAAE;gBACjB,OAAO,EAAE,OAAO,CAAA;aACjB,KAAK,OAAO,CAAC;gBAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAC,CAAA;SACnD,CAAA;KACF,CAAA;CACF,CAAA;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B"}

package/dist/start/index.js

@@ -0,0 +1,49 @@
+import { QueryClient } from '@tanstack/react-query';
+import { createClient, } from '../query/index.js';
+import { createIsomorphicFetch } from './isomorphic-fetch.js';
+export { createIsomorphicFetch } from './isomorphic-fetch.js';
+/**
+ * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible
+ * QueryClient defaults, and a typed query client whose procedures and buckets are
+ * inferred from the server app type.
+ *
+ * @example
+ * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start
+ * // entry-point name (it would replace the hydration entry).
+ * import type { App } from './bunderstack'
+ * export const { createQueryClient, createApi } = bunderstackStart<App>()
+ */
+export function bunderstackStart(options = {}) {
+    const isoFetch = createIsomorphicFetch();
+    return {
+        createQueryClient: () => new QueryClient({
+            defaultOptions: {
+                queries: { staleTime: options.staleTime ?? 30_000 },
+            },
+        }),
+        createApi: (queryClient) => createClient({
+            queryClient,
+            fetch: isoFetch,
+            baseUrl: options.baseUrl,
+        }),
+    };
+}
+/**
+ * Handlers object for the catch-all API file route.
+ *
+ * @example
+ * // src/routes/api/$.tsx
+ * export const Route = createFileRoute('/api/$')({
+ *   server: { handlers: createApiHandlers(app) },
+ * })
+ */
+export function createApiHandlers(app) {
+    const handle = ({ request }) => app.handler(request);
+    return { GET: handle, POST: handle, PATCH: handle, DELETE: handle };
+}
+/** Resolve the BetterAuth session user for an incoming request (server-side). */
+export async function getSessionUser(app, request) {
+    const session = await app.auth.api.getSession({ headers: request.headers });
+    return session?.user ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/start/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EACL,YAAY,GAGb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAS1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,OAAO;QACL,iBAAiB,EAAE,GAAG,EAAE,CACtB,IAAI,WAAW,CAAC;YACd,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE;aACpD;SACF,CAAC;QACJ,SAAS,EAAE,CAAC,WAAwB,EAA2B,EAAE,CAC/D,YAAY,CAAO;YACjB,WAAW;YACX,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;KACL,CAAA;AACH,CAAC;AAKD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAEjC;IAMC,MAAM,MAAM,GAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAClE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACrE,CAAC;AAoBD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,OAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3E,OAAO,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;AAC9B,CAAC","sourcesContent":["import { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createClient,\n  type AnyBunderstackApp,\n  type BunderstackClient,\n} from '../query/index'\nimport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport type BunderstackStartOptions = {\n  /** API mount point. Defaults to '/api'. */\n  baseUrl?: string\n  /** Default query staleTime (ms). Defaults to 30_000. */\n  staleTime?: number\n}\n\n/**\n * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible\n * QueryClient defaults, and a typed query client whose procedures and buckets are\n * inferred from the server app type.\n *\n * @example\n * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start\n * // entry-point name (it would replace the hydration entry).\n * import type { App } from './bunderstack'\n * export const { createQueryClient, createApi } = bunderstackStart<App>()\n */\nexport function bunderstackStart<TApp extends AnyBunderstackApp>(\n  options: BunderstackStartOptions = {},\n) {\n  const isoFetch = createIsomorphicFetch()\n  return {\n    createQueryClient: () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: { staleTime: options.staleTime ?? 30_000 },\n        },\n      }),\n    createApi: (queryClient: QueryClient): BunderstackClient<TApp> =>\n      createClient<TApp>({\n        queryClient,\n        fetch: isoFetch,\n        baseUrl: options.baseUrl,\n      }),\n  }\n}\n\ntype StartRequestContext = { request: Request }\ntype StartHandler = (ctx: StartRequestContext) => Promise<Response>\n\n/**\n * Handlers object for the catch-all API file route.\n *\n * @example\n * // src/routes/api/$.tsx\n * export const Route = createFileRoute('/api/$')({\n *   server: { handlers: createApiHandlers(app) },\n * })\n */\nexport function createApiHandlers(app: {\n  handler: (req: Request) => Promise<Response>\n}): {\n  GET: StartHandler\n  POST: StartHandler\n  PATCH: StartHandler\n  DELETE: StartHandler\n} {\n  const handle: StartHandler = ({ request }) => app.handler(request)\n  return { GET: handle, POST: handle, PATCH: handle, DELETE: handle }\n}\n\nexport type SessionUser = {\n  id: string\n  email: string\n  name: string\n  image?: string | null\n  role?: string\n}\n\ntype SessionApp = {\n  auth: {\n    api: {\n      getSession: (opts: {\n        headers: Headers\n      }) => Promise<{ user: SessionUser | null } | null>\n    }\n  }\n}\n\n/** Resolve the BetterAuth session user for an incoming request (server-side). */\nexport async function getSessionUser(\n  app: SessionApp,\n  request: Request,\n): Promise<SessionUser | null> {\n  const session = await app.auth.api.getSession({ headers: request.headers })\n  return session?.user ?? null\n}\n"]}

package/dist/start/isomorphic-fetch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SSR-aware fetch: the browser passes `/api/...` through as-is; on the
+ * server, relative URLs are resolved against the incoming request's origin
+ * (via @tanstack/react-start/server), falling back to APP_URL /
+ * BETTER_AUTH_URL / localhost:3000 outside a request context.
+ *
+ * The server-only module uses a literal dynamic import so bundlers can analyze
+ * the boundary statically; the `window` guard means it never runs in browsers.
+ */
+export declare function createIsomorphicFetch(options?: {
+    fetch?: typeof fetch;
+}): (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=isomorphic-fetch.d.ts.map

package/dist/start/isomorphic-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isomorphic-fetch.d.ts","sourceRoot":"","sources":["../../src/start/isomorphic-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,IAGxE,OAAO,WAAW,GAAG,GAAG,EACxB,OAAO,WAAW,KACjB,OAAO,CAAC,QAAQ,CAAC,CAkBrB"}

package/dist/start/isomorphic-fetch.js

@@ -0,0 +1,33 @@
+/**
+ * SSR-aware fetch: the browser passes `/api/...` through as-is; on the
+ * server, relative URLs are resolved against the incoming request's origin
+ * (via @tanstack/react-start/server), falling back to APP_URL /
+ * BETTER_AUTH_URL / localhost:3000 outside a request context.
+ *
+ * The server-only module uses a literal dynamic import so bundlers can analyze
+ * the boundary statically; the `window` guard means it never runs in browsers.
+ */
+export function createIsomorphicFetch(options = {}) {
+    const inner = options.fetch ?? fetch;
+    return async function isomorphicFetch(input, init) {
+        if (typeof window !== 'undefined')
+            return inner(input, init);
+        if (typeof input === 'string' && input.startsWith('/')) {
+            let origin;
+            try {
+                const mod = await import('@tanstack/react-start/server');
+                origin = new URL(mod.getRequest().url).origin;
+            }
+            catch {
+                // No request context (background job, test) — fall through to env.
+            }
+            origin ??=
+                process.env.APP_URL ??
+                    process.env.BETTER_AUTH_URL ??
+                    'http://localhost:3000';
+            return inner(new URL(input, origin), init);
+        }
+        return inner(input, init);
+    };
+}
+//# sourceMappingURL=isomorphic-fetch.js.map

package/dist/start/isomorphic-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isomorphic-fetch.js","sourceRoot":"","sources":["../../src/start/isomorphic-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAoC,EAAE;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IACpC,OAAO,KAAK,UAAU,eAAe,CACnC,KAAwB,EACxB,IAAkB;QAElB,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,MAA0B,CAAA;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAA;gBACxD,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;YACD,MAAM;gBACJ,OAAO,CAAC,GAAG,CAAC,OAAO;oBACnB,OAAO,CAAC,GAAG,CAAC,eAAe;oBAC3B,uBAAuB,CAAA;YACzB,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC3B,CAAC,CAAA;AACH,CAAC","sourcesContent":["/**\n * SSR-aware fetch: the browser passes `/api/...` through as-is; on the\n * server, relative URLs are resolved against the incoming request's origin\n * (via @tanstack/react-start/server), falling back to APP_URL /\n * BETTER_AUTH_URL / localhost:3000 outside a request context.\n *\n * The server-only module uses a literal dynamic import so bundlers can analyze\n * the boundary statically; the `window` guard means it never runs in browsers.\n */\nexport function createIsomorphicFetch(options: { fetch?: typeof fetch } = {}) {\n  const inner = options.fetch ?? fetch\n  return async function isomorphicFetch(\n    input: RequestInfo | URL,\n    init?: RequestInit,\n  ): Promise<Response> {\n    if (typeof window !== 'undefined') return inner(input, init)\n    if (typeof input === 'string' && input.startsWith('/')) {\n      let origin: string | undefined\n      try {\n        const mod = await import('@tanstack/react-start/server')\n        origin = new URL(mod.getRequest().url).origin\n      } catch {\n        // No request context (background job, test) — fall through to env.\n      }\n      origin ??=\n        process.env.APP_URL ??\n        process.env.BETTER_AUTH_URL ??\n        'http://localhost:3000'\n      return inner(new URL(input, origin), init)\n    }\n    return inner(input, init)\n  }\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":"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"}

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":"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","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 { 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 '../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  BunderstackSyncClient,\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  AnyBunderstackApp,\n  InferBuckets,\n  InferInsert,\n  InferSchema,\n  InferSelect,\n  InferTables,\n  UploadedFile,\n} from '../query/index'\n"]}