bunderstack 0.20.0 → 0.21.1

package/dist/query/index.d.ts

@@ -0,0 +1,8 @@
+export { createClient } from './client.js';
+export type { BunderstackClient, ClientOptions, FileBucketHelpers, FileTransformOptions, UploadedFile, } from './client.js';
+export { createApiClient } from './api.js';
+export type { ApiClientOptions, ApiQueryUtils } from './api.js';
+export type { AnyBunderstackApp, ClientCarrier, ExposedTables, InferApiRouter, InferBuckets, InferInsert, InferSelect, InferSchema, InferTables, } from './infer.js';
+export { syncRealtime } from './realtime.js';
+export type { NotifyScheduler, RealtimeApplyStrategy, RealtimeChange, RealtimeEvent, RealtimeHeartbeat, RealtimeProcedure, RealtimeQueryApi, RealtimeSyncHandle, RealtimeSyncOptions, RealtimeClock, } from './realtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GACb,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACvC,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC5D,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/query/index.js

@@ -0,0 +1,4 @@
+export { createClient } from './client.js';
+export { createApiClient } from './api.js';
+export { syncRealtime } from './realtime.js';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAQvC,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAavC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA","sourcesContent":["export { createClient } from './client'\nexport type {\n  BunderstackClient,\n  ClientOptions,\n  FileBucketHelpers,\n  FileTransformOptions,\n  UploadedFile,\n} from './client'\nexport { createApiClient } from './api'\nexport type { ApiClientOptions, ApiQueryUtils } from './api'\nexport type {\n  AnyBunderstackApp,\n  ClientCarrier,\n  ExposedTables,\n  InferApiRouter,\n  InferBuckets,\n  InferInsert,\n  InferSelect,\n  InferSchema,\n  InferTables,\n} from './infer'\nexport { syncRealtime } from './realtime'\nexport type {\n  NotifyScheduler,\n  RealtimeApplyStrategy,\n  RealtimeChange,\n  RealtimeEvent,\n  RealtimeHeartbeat,\n  RealtimeProcedure,\n  RealtimeQueryApi,\n  RealtimeSyncHandle,\n  RealtimeSyncOptions,\n  RealtimeClock,\n} from './realtime'\n"]}

package/dist/query/infer.d.ts

@@ -0,0 +1,25 @@
+import type { AnyRouter } from '@orpc/server';
+import type { ExposedApiTables } from '../api/types.js';
+/** Shape of the `$inferClient` phantom `createBunderstack` puts on the app. */
+export type ClientCarrier = {
+    schema: Record<string, unknown>;
+    access: unknown;
+    buckets: string;
+    api: AnyRouter;
+};
+export type AnyBunderstackApp = {
+    $inferClient?: ClientCarrier | undefined;
+};
+export type InferCarrier<TApp extends AnyBunderstackApp> = NonNullable<TApp['$inferClient']>;
+export type InferSchema<TApp extends AnyBunderstackApp> = InferCarrier<TApp>['schema'];
+export type InferBuckets<TApp extends AnyBunderstackApp> = InferCarrier<TApp>['buckets'];
+export type InferSelect<T> = T extends {
+    $inferSelect: infer R;
+} ? R : never;
+export type InferInsert<T> = T extends {
+    $inferInsert: infer R;
+} ? R : never;
+export type InferApiRouter<TApp extends AnyBunderstackApp> = InferCarrier<TApp>['api'];
+export type ExposedTables<TSchema extends Record<string, unknown>, TAccess = undefined> = ExposedApiTables<TSchema, TAccess>;
+export type InferTables<TApp extends AnyBunderstackApp> = ExposedTables<InferSchema<TApp>, InferCarrier<TApp>['access']> & keyof InferSchema<TApp> & string;
+//# sourceMappingURL=infer.d.ts.map

package/dist/query/infer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.d.ts","sourceRoot":"","sources":["../../src/query/infer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,SAAS,CAAA;CACf,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAA;AAE5E,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,iBAAiB,IAAI,WAAW,CACpE,IAAI,CAAC,cAAc,CAAC,CACrB,CAAA;AACD,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,iBAAiB,IACpD,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC9B,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,iBAAiB,IACrD,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAA;AAE/B,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAC5E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5E,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,iBAAiB,IACvD,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAA;AAE3B,MAAM,MAAM,aAAa,CACvB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,GAAG,SAAS,IACjB,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAEtC,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,iBAAiB,IAAI,aAAa,CACrE,WAAW,CAAC,IAAI,CAAC,EACjB,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAC7B,GACC,MAAM,WAAW,CAAC,IAAI,CAAC,GACvB,MAAM,CAAA"}

package/dist/query/infer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=infer.js.map

package/dist/query/infer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.js","sourceRoot":"","sources":["../../src/query/infer.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnyRouter } from '@orpc/server'\n\nimport type { ExposedApiTables } from '../api/types'\n\n/** Shape of the `$inferClient` phantom `createBunderstack` puts on the app. */\nexport type ClientCarrier = {\n  schema: Record<string, unknown>\n  access: unknown\n  buckets: string\n  api: AnyRouter\n}\n\nexport type AnyBunderstackApp = { $inferClient?: ClientCarrier | undefined }\n\nexport type InferCarrier<TApp extends AnyBunderstackApp> = NonNullable<\n  TApp['$inferClient']\n>\nexport type InferSchema<TApp extends AnyBunderstackApp> =\n  InferCarrier<TApp>['schema']\nexport type InferBuckets<TApp extends AnyBunderstackApp> =\n  InferCarrier<TApp>['buckets']\n\nexport type InferSelect<T> = T extends { $inferSelect: infer R } ? R : never\nexport type InferInsert<T> = T extends { $inferInsert: infer R } ? R : never\n\nexport type InferApiRouter<TApp extends AnyBunderstackApp> =\n  InferCarrier<TApp>['api']\n\nexport type ExposedTables<\n  TSchema extends Record<string, unknown>,\n  TAccess = undefined,\n> = ExposedApiTables<TSchema, TAccess>\n\nexport type InferTables<TApp extends AnyBunderstackApp> = ExposedTables<\n  InferSchema<TApp>,\n  InferCarrier<TApp>['access']\n> &\n  keyof InferSchema<TApp> &\n  string\n"]}

package/dist/query/react.d.ts

@@ -0,0 +1,3 @@
+export { createClient } from './client.js';
+export type { BunderstackClient, ClientOptions } from './client.js';
+//# sourceMappingURL=react.d.ts.map

package/dist/query/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/query/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA"}

package/dist/query/react.js

@@ -0,0 +1,2 @@
+export { createClient } from './client.js';
+//# sourceMappingURL=react.js.map

package/dist/query/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/query/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA","sourcesContent":["export { createClient } from './client'\nexport type { BunderstackClient, ClientOptions } from './client'\n"]}

package/dist/query/realtime-flush.d.ts

@@ -0,0 +1,26 @@
+/**
+ * When buffered realtime work runs.
+ *
+ * `'frame'` coalesces a burst of events into one cache write per animation
+ * frame. `'sync'` restores the older behaviour of writing as each event
+ * arrives. A number debounces by that many milliseconds.
+ */
+export type NotifyScheduler = 'sync' | 'frame' | number;
+/** The timer functions the scheduler needs, injectable so tests control time. */
+export type RealtimeClock = {
+    setTimeout: (fn: () => void, ms: number) => unknown;
+    clearTimeout: (handle: unknown) => void;
+};
+export type FlushScheduler = {
+    /**
+     * Ask for `flush` to run. Calls made while a flush is already pending are
+     * absorbed into it, so the flush runs once per window however many events
+     * arrived.
+     */
+    schedule: (flush: () => void) => void;
+    /** Drop a pending flush without running it. */
+    cancel: () => void;
+};
+export declare const systemClock: RealtimeClock;
+export declare function createFlushScheduler(mode: NotifyScheduler, clock?: RealtimeClock): FlushScheduler;
+//# sourceMappingURL=realtime-flush.d.ts.map

package/dist/query/realtime-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-flush.d.ts","sourceRoot":"","sources":["../../src/query/realtime-flush.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAEvD,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IACnD,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IACrC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,aAIzB,CAAA;AAiBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,KAAK,CAAC,EAAE,aAAa,GACpB,cAAc,CAuBhB"}

package/dist/query/realtime-flush.js

@@ -0,0 +1,45 @@
+export const systemClock = {
+    setTimeout: (fn, ms) => setTimeout(fn, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+/**
+ * A frame is `requestAnimationFrame` in a browser and a zero-delay timer
+ * everywhere else, so the same code paces correctly under SSR and in tests.
+ * An injected clock always wins — a test that supplies one is asking for its
+ * timers to be the only ones.
+ */
+function frameClock(clock) {
+    if (clock)
+        return clock;
+    if (typeof requestAnimationFrame !== 'function')
+        return systemClock;
+    return {
+        setTimeout: (fn) => requestAnimationFrame(fn),
+        clearTimeout: (handle) => cancelAnimationFrame(handle),
+    };
+}
+export function createFlushScheduler(mode, clock) {
+    if (mode === 'sync') {
+        return { schedule: (flush) => flush(), cancel: () => { } };
+    }
+    const timers = mode === 'frame' ? frameClock(clock) : (clock ?? systemClock);
+    const delayMs = mode === 'frame' ? 0 : Math.max(0, mode);
+    let pending;
+    return {
+        schedule(flush) {
+            if (pending !== undefined)
+                return;
+            pending = timers.setTimeout(() => {
+                pending = undefined;
+                flush();
+            }, delayMs);
+        },
+        cancel() {
+            if (pending === undefined)
+                return;
+            timers.clearTimeout(pending);
+            pending = undefined;
+        },
+    };
+}
+//# sourceMappingURL=realtime-flush.js.map

package/dist/query/realtime-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-flush.js","sourceRoot":"","sources":["../../src/query/realtime-flush.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;IAC1C,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CACvB,YAAY,CAAC,MAAuC,CAAC;CACxD,CAAA;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,KAAgC;IAClD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,IAAI,OAAO,qBAAqB,KAAK,UAAU;QAAE,OAAO,WAAW,CAAA;IACnE,OAAO;QACL,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC7C,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAgB,CAAC;KACjE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAqB,EACrB,KAAqB;IAErB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,CAAA;IAC5E,MAAM,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IACxD,IAAI,OAAgB,CAAA;IAEpB,OAAO;QACL,QAAQ,CAAC,KAAK;YACZ,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAM;YACjC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBAC/B,OAAO,GAAG,SAAS,CAAA;gBACnB,KAAK,EAAE,CAAA;YACT,CAAC,EAAE,OAAO,CAAC,CAAA;QACb,CAAC;QACD,MAAM;YACJ,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAM;YACjC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;YAC5B,OAAO,GAAG,SAAS,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * When buffered realtime work runs.\n *\n * `'frame'` coalesces a burst of events into one cache write per animation\n * frame. `'sync'` restores the older behaviour of writing as each event\n * arrives. A number debounces by that many milliseconds.\n */\nexport type NotifyScheduler = 'sync' | 'frame' | number\n\n/** The timer functions the scheduler needs, injectable so tests control time. */\nexport type RealtimeClock = {\n  setTimeout: (fn: () => void, ms: number) => unknown\n  clearTimeout: (handle: unknown) => void\n}\n\nexport type FlushScheduler = {\n  /**\n   * Ask for `flush` to run. Calls made while a flush is already pending are\n   * absorbed into it, so the flush runs once per window however many events\n   * arrived.\n   */\n  schedule: (flush: () => void) => void\n  /** Drop a pending flush without running it. */\n  cancel: () => void\n}\n\nexport const systemClock: RealtimeClock = {\n  setTimeout: (fn, ms) => setTimeout(fn, ms),\n  clearTimeout: (handle) =>\n    clearTimeout(handle as ReturnType<typeof setTimeout>),\n}\n\n/**\n * A frame is `requestAnimationFrame` in a browser and a zero-delay timer\n * everywhere else, so the same code paces correctly under SSR and in tests.\n * An injected clock always wins — a test that supplies one is asking for its\n * timers to be the only ones.\n */\nfunction frameClock(clock: RealtimeClock | undefined): RealtimeClock {\n  if (clock) return clock\n  if (typeof requestAnimationFrame !== 'function') return systemClock\n  return {\n    setTimeout: (fn) => requestAnimationFrame(fn),\n    clearTimeout: (handle) => cancelAnimationFrame(handle as number),\n  }\n}\n\nexport function createFlushScheduler(\n  mode: NotifyScheduler,\n  clock?: RealtimeClock,\n): FlushScheduler {\n  if (mode === 'sync') {\n    return { schedule: (flush) => flush(), cancel: () => {} }\n  }\n\n  const timers = mode === 'frame' ? frameClock(clock) : (clock ?? systemClock)\n  const delayMs = mode === 'frame' ? 0 : Math.max(0, mode)\n  let pending: unknown\n\n  return {\n    schedule(flush) {\n      if (pending !== undefined) return\n      pending = timers.setTimeout(() => {\n        pending = undefined\n        flush()\n      }, delayMs)\n    },\n    cancel() {\n      if (pending === undefined) return\n      timers.clearTimeout(pending)\n      pending = undefined\n    },\n  }\n}\n"]}

package/dist/query/realtime-stream.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import transport primitives from `bunderstack/client`. */
+export { DEFAULT_KEEPALIVE_MS, DEFAULT_LIVENESS_FACTOR, isRealtimeHeartbeat, openRealtimeStream, type RealtimeAction, type RealtimeChange, type RealtimeEvent, type RealtimeHeartbeat, type RealtimeProcedure, type RealtimeStreamOptions, type RealtimeSyncHandle, } from '../client/realtime.js';
+//# sourceMappingURL=realtime-stream.d.ts.map

package/dist/query/realtime-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-stream.d.ts","sourceRoot":"","sources":["../../src/query/realtime-stream.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAA"}

package/dist/query/realtime-stream.js

@@ -0,0 +1,3 @@
+/** @deprecated Import transport primitives from `bunderstack/client`. */
+export { DEFAULT_KEEPALIVE_MS, DEFAULT_LIVENESS_FACTOR, isRealtimeHeartbeat, openRealtimeStream, } from '../client/realtime.js';
+//# sourceMappingURL=realtime-stream.js.map

package/dist/query/realtime-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-stream.js","sourceRoot":"","sources":["../../src/query/realtime-stream.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,GAQnB,MAAM,oBAAoB,CAAA","sourcesContent":["/** @deprecated Import transport primitives from `bunderstack/client`. */\nexport {\n  DEFAULT_KEEPALIVE_MS,\n  DEFAULT_LIVENESS_FACTOR,\n  isRealtimeHeartbeat,\n  openRealtimeStream,\n  type RealtimeAction,\n  type RealtimeChange,\n  type RealtimeEvent,\n  type RealtimeHeartbeat,\n  type RealtimeProcedure,\n  type RealtimeStreamOptions,\n  type RealtimeSyncHandle,\n} from '../client/realtime'\n"]}

package/dist/query/realtime.d.ts

@@ -0,0 +1,88 @@
+import type { QueryClient } from '@tanstack/query-core';
+import type { AnyBunderstackApp, InferSchema, InferSelect, InferTables } from './infer.js';
+import type { NotifyScheduler, RealtimeClock } from './realtime-flush.js';
+import type { RealtimeAction, RealtimeChange, RealtimeProcedure, RealtimeSyncHandle } from './realtime-stream.js';
+export type { NotifyScheduler, RealtimeClock } from './realtime-flush.js';
+export type { RealtimeAction, RealtimeChange, RealtimeEvent, RealtimeHeartbeat, RealtimeProcedure, RealtimeSyncHandle, } from './realtime-stream.js';
+/**
+ * The change for one table, with `record` typed as that table's row.
+ *
+ * Passing the app type to `syncRealtime` turns `tables` into a checked list of
+ * exposed table names and `onChange` into a union discriminated by `table`, so
+ * `change.table === 'todos'` narrows `change.record` to the todo row:
+ *
+ * ```ts
+ * syncRealtime<App>({
+ *   api,
+ *   queryClient,
+ *   tables: ['todos'],
+ *   onChange: (change) => {
+ *     if (change.table === 'todos') console.log(change.record.done)
+ *   },
+ * })
+ * ```
+ */
+export type RealtimeChangeFor<TApp extends AnyBunderstackApp, TTable extends InferTables<TApp>> = {
+    table: TTable;
+    action: RealtimeAction;
+    record: InferSelect<InferSchema<TApp>[TTable]>;
+    operationId?: string;
+};
+/**
+ * Untyped when no app type is supplied, so existing callers — and consumers
+ * that only have a structural client — keep the loose `RealtimeChange`.
+ */
+export type RealtimeChangeOf<TApp, TTable extends string> = [TApp] extends [
+    never
+] ? RealtimeChange : TApp extends AnyBunderstackApp ? TTable extends InferTables<TApp> ? RealtimeChangeFor<TApp, TTable> : RealtimeChange : RealtimeChange;
+/** Every exposed table name, or any string when no app type is supplied. */
+export type RealtimeTableName<TApp> = [TApp] extends [never] ? string : TApp extends AnyBunderstackApp ? InferTables<TApp> : string;
+export type RealtimeQueryApi = {
+    realtime: {
+        changes: RealtimeProcedure;
+    };
+    [table: string]: any;
+};
+/**
+ * How a change reaches the cache.
+ *
+ * `invalidate` (default) marks the table's queries stale and lets TanStack
+ * Query refetch them — always correct, one request per change.
+ *
+ * `patch` writes the change into cached list results instead, so a write costs
+ * no extra request. The event carries the action and the full row, and
+ * Bunderstack's list contract is narrow enough to decide membership locally:
+ * filters are `=`, `IN`, or `IS NULL`, and ordering is a single column. Any
+ * list where that is not decidable — a text search, or a page that is not the
+ * complete result — falls back to invalidation.
+ */
+export type RealtimeApplyStrategy = 'invalidate' | 'patch';
+export type RealtimeSyncOptions<TApp = never, TTable extends string = RealtimeTableName<TApp>> = {
+    api: RealtimeQueryApi;
+    queryClient: QueryClient;
+    tables: TTable[];
+    signal?: AbortSignal;
+    /** Defaults to `'invalidate'`. */
+    apply?: RealtimeApplyStrategy;
+    /**
+     * When buffered changes reach the cache. Defaults to `'frame'`, which
+     * collapses a burst into one cache write and one invalidation per table.
+     * Pass `'sync'` to write as each change arrives, as versions before 0.18 did.
+     */
+    notifyScheduler?: NotifyScheduler;
+    /** Timer functions, injectable for tests. */
+    clock?: RealtimeClock;
+    /** Initial reconnect delay before jitter. Defaults to 1 second. */
+    retryMs?: number;
+    /** Maximum reconnect delay before jitter. Defaults to 30 seconds. */
+    maxRetryMs?: number;
+    onChange?: (change: RealtimeChangeOf<TApp, TTable>) => void;
+    onReconnect?: () => void | Promise<void>;
+    onError?: (error: unknown) => void;
+    onRetry?: (retry: {
+        attempt: number;
+        delayMs: number;
+    }) => void;
+};
+export declare function syncRealtime<TApp = never, TTable extends string = RealtimeTableName<TApp>>(options: RealtimeSyncOptions<TApp, TTable>): RealtimeSyncHandle;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/query/realtime.d.ts.map

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

package/dist/query/realtime.js

@@ -0,0 +1,255 @@
+import { hashKey, notifyManager } from '@tanstack/query-core';
+import { createFlushScheduler } from './realtime-flush.js';
+import { openRealtimeStream } from './realtime-stream.js';
+function tableQueryKey(api, table) {
+    return api[table]?.key?.({ type: 'query' }) ?? [[table], { type: 'query' }];
+}
+function detailQueryKey(api, table, id) {
+    return (api[table]?.get?.queryKey?.({ input: { id } }) ?? [
+        [table, 'get'],
+        { type: 'query', input: { id } },
+    ]);
+}
+function listQueryKey(api, table) {
+    return (api[table]?.list?.key?.({ type: 'query' }) ?? [
+        [table, 'list'],
+        { type: 'query' },
+    ]);
+}
+function isListSnapshot(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Array.isArray(value.items));
+}
+/** Dates arrive as Dates over the wire, so identity is not enough. */
+function sameValue(a, b) {
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    return a === b;
+}
+/**
+ * Bunderstack's filter contract is narrow by design — a scalar is `=`, an
+ * array is `IN`, and `null` is `IS NULL` — so membership is decidable against
+ * a single record without asking the server.
+ */
+function matchesFilters(record, filters) {
+    for (const [column, expected] of Object.entries(filters ?? {})) {
+        if (expected === undefined)
+            continue;
+        const actual = record[column];
+        if (expected === null) {
+            if (actual !== null && actual !== undefined)
+                return false;
+            continue;
+        }
+        if (Array.isArray(expected)) {
+            if (!expected.some((value) => sameValue(value, actual)))
+                return false;
+            continue;
+        }
+        if (!sameValue(expected, actual))
+            return false;
+    }
+    return true;
+}
+function compareValues(a, b) {
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() - b.getTime();
+    if (typeof a === 'number' && typeof b === 'number')
+        return a - b;
+    if (typeof a === 'boolean' && typeof b === 'boolean')
+        return Number(a) - Number(b);
+    return String(a).localeCompare(String(b));
+}
+/**
+ * Where the row goes in an already-sorted page.
+ *
+ * Ties are common rather than exotic: a `timestamp` column stores seconds, so
+ * rows written in the same second share a sort value. SQL does not define an
+ * order within a tie, so the new row is placed as the most recent of its
+ * equals — first under `desc`, last under `asc` — which is where a reader
+ * expects a just-written row to appear.
+ */
+function insertionIndex(items, record, sort, order) {
+    const value = record[sort];
+    const index = items.findIndex((item) => {
+        const comparison = compareValues(value, item[sort]);
+        return order === 'desc' ? comparison >= 0 : comparison < 0;
+    });
+    return index === -1 ? items.length : index;
+}
+/**
+ * A cached page can only absorb an insert when it already holds every row the
+ * query would return. A partial page cannot: the new row may belong to another
+ * page, and inserting would shift the boundary the server drew.
+ */
+function holdsCompleteResult(snapshot) {
+    return (snapshot.hasMore === false &&
+        !snapshot.cursor &&
+        (snapshot.offset === undefined || snapshot.offset === 0));
+}
+function readInput(queryKey) {
+    const meta = queryKey[1];
+    const input = meta?.input;
+    return typeof input === 'object' && input !== null
+        ? input
+        : {};
+}
+export function syncRealtime(options) {
+    const scheduler = createFlushScheduler(options.notifyScheduler ?? 'frame', options.clock);
+    /** Changes waiting for the next flush, in arrival order. */
+    const buffered = [];
+    /**
+     * Query keys the flush must invalidate, deduplicated by their hash. Keyed
+     * this way rather than by table so a list that cannot absorb a change still
+     * invalidates only itself, while a burst against one key collapses to one
+     * call.
+     */
+    const stale = new Map();
+    const invalidateAll = async () => {
+        await Promise.all(options.tables.map((table) => options.queryClient.invalidateQueries({
+            queryKey: tableQueryKey(options.api, table),
+        })));
+    };
+    /**
+     * Write the change into every cached list for the table, marking the table
+     * stale for any list whose membership or ordering cannot be settled locally.
+     * A list is only patched when the answer is certain.
+     */
+    const patchLists = (change) => {
+        const prefix = listQueryKey(options.api, change.table);
+        const queries = options.queryClient
+            .getQueryCache()
+            .findAll({ queryKey: prefix });
+        const id = change.record['id'];
+        for (const query of queries) {
+            const snapshot = query.state.data;
+            if (!isListSnapshot(snapshot))
+                continue;
+            const queryKey = query.queryKey;
+            const items = snapshot.items;
+            const present = items.some((item) => sameValue(item['id'], id));
+            if (change.action === 'delete') {
+                if (!present)
+                    continue;
+                options.queryClient.setQueryData(queryKey, {
+                    ...snapshot,
+                    items: items.filter((item) => !sameValue(item['id'], id)),
+                    ...(typeof snapshot.total === 'number'
+                        ? { total: Math.max(0, snapshot.total - 1) }
+                        : {}),
+                });
+                continue;
+            }
+            const input = readInput(queryKey);
+            const belongs = matchesFilters(change.record, input['filters']);
+            // An update can move a row out of a filtered list.
+            if (!belongs) {
+                if (!present)
+                    continue;
+                options.queryClient.setQueryData(queryKey, {
+                    ...snapshot,
+                    items: items.filter((item) => !sameValue(item['id'], id)),
+                    ...(typeof snapshot.total === 'number'
+                        ? { total: Math.max(0, snapshot.total - 1) }
+                        : {}),
+                });
+                continue;
+            }
+            // Already here: replace in place and keep the row where it is.
+            if (present) {
+                options.queryClient.setQueryData(queryKey, {
+                    ...snapshot,
+                    items: items.map((item) => sameValue(item['id'], id) ? change.record : item),
+                });
+                continue;
+            }
+            // The row joins this list. Only safe on a page that holds everything,
+            // and only when `q` is absent — a text match needs the server's
+            // searchable columns to evaluate.
+            const searched = snapshot.q ?? input['q'];
+            const sort = snapshot.sort ?? input['sort'];
+            const order = snapshot.order ?? input['order'];
+            if (searched || !sort || !order || !holdsCompleteResult(snapshot)) {
+                stale.set(hashKey(queryKey), queryKey);
+                continue;
+            }
+            const next = items.slice();
+            next.splice(insertionIndex(items, change.record, sort, order), 0, change.record);
+            options.queryClient.setQueryData(queryKey, {
+                ...snapshot,
+                items: next,
+                ...(typeof snapshot.total === 'number'
+                    ? { total: snapshot.total + 1 }
+                    : {}),
+            });
+        }
+    };
+    const applyOne = (change) => {
+        // The runtime shape is the same either way; the generic only narrows what
+        // callers see.
+        options.onChange?.(change);
+        const id = change.record['id'];
+        if (id !== undefined) {
+            const queryKey = detailQueryKey(options.api, change.table, id);
+            if (change.action === 'delete')
+                options.queryClient.removeQueries({ queryKey });
+            else
+                options.queryClient.setQueryData(queryKey, change.record);
+        }
+        if (options.apply === 'patch') {
+            patchLists(change);
+            return;
+        }
+        const tableKey = tableQueryKey(options.api, change.table);
+        stale.set(hashKey(tableKey), tableKey);
+    };
+    /**
+     * One pass over the buffer, then one invalidation per stale table. The
+     * second part is the point: a burst of changes to a table used to issue one
+     * `invalidateQueries` each, and now issues one in total.
+     */
+    const flush = () => {
+        if (buffered.length === 0)
+            return;
+        const batch = buffered.splice(0, buffered.length);
+        notifyManager.batch(() => {
+            for (const change of batch)
+                applyOne(change);
+            for (const queryKey of stale.values())
+                void options.queryClient.invalidateQueries({ queryKey });
+            stale.clear();
+        });
+    };
+    const stream = openRealtimeStream({
+        subscribe: ({ signal, lastEventId }) => options.api.realtime.changes.call({ tables: options.tables }, { signal, lastEventId }),
+        onChange: (change) => {
+            buffered.push(change);
+            scheduler.schedule(flush);
+        },
+        onReconnect: async () => {
+            // A refetch of everything supersedes whatever was still buffered.
+            scheduler.cancel();
+            buffered.length = 0;
+            stale.clear();
+            await invalidateAll();
+            await options.onReconnect?.();
+        },
+        onError: options.onError,
+        onRetry: options.onRetry,
+        signal: options.signal ?? new AbortController().signal,
+        retryMs: options.retryMs,
+        maxRetryMs: options.maxRetryMs,
+        clock: options.clock,
+    });
+    return {
+        close: () => {
+            stream.close();
+            // Anything already delivered is still owed to the cache.
+            scheduler.cancel();
+            flush();
+        },
+        done: stream.done,
+    };
+}
+//# sourceMappingURL=realtime.js.map

package/dist/query/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/query/realtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAgB7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AA+GtD,SAAS,aAAa,CAAC,GAAqB,EAAE,KAAa;IACzD,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,cAAc,CACrB,GAAqB,EACrB,KAAa,EACb,EAAW;IAEX,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI;QAChD,CAAC,KAAK,EAAE,KAAK,CAAC;QACd,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE;KACjC,CACF,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAqB,EAAE,KAAa;IACxD,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI;QAC5C,CAAC,KAAK,EAAE,MAAM,CAAC;QACf,EAAE,IAAI,EAAE,OAAO,EAAE;KAClB,CACF,CAAA;AACH,CAAC;AAcD,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAE,KAAsB,CAAC,KAAK,CAAC,CAC7C,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;IAC9E,OAAO,CAAC,KAAK,CAAC,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,MAA+B,EAC/B,OAA4C;IAE5C,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/D,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAQ;QACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAA;YACzD,SAAQ;QACV,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;YACrE,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;YAAE,OAAO,KAAK,CAAA;IAChD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,aAAa,CAAC,CAAU,EAAE,CAAU;IAC3C,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;IAC5E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAChE,IAAI,OAAO,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,SAAS;QAClD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,cAAc,CACrB,KAAgC,EAChC,MAA+B,EAC/B,IAAY,EACZ,KAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACnD,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IACF,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,QAAsB;IACjD,OAAO,CACL,QAAQ,CAAC,OAAO,KAAK,KAAK;QAC1B,CAAC,QAAQ,CAAC,MAAM;QAChB,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CACzD,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,QAAkB;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAoC,CAAA;IAC3D,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAChD,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,MAAM,UAAU,YAAY,CAG1B,OAA0C;IAC1C,MAAM,SAAS,GAAG,oBAAoB,CACpC,OAAO,CAAC,eAAe,IAAI,OAAO,EAClC,OAAO,CAAC,KAAK,CACd,CAAA;IACD,4DAA4D;IAC5D,MAAM,QAAQ,GAAqB,EAAE,CAAA;IACrC;;;;;OAKG;IACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEzC,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;QAC/B,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACpC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;SAC5C,CAAC,CACH,CACF,CAAA;IACH,CAAC,CAAA;IAED;;;;OAIG;IACH,MAAM,UAAU,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW;aAChC,aAAa,EAAE;aACf,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAChC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAE9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;YACjC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;gBAAE,SAAQ;YAEvC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;YAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;YAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;YAE/D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,OAAO;oBAAE,SAAQ;gBACtB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACzC,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzD,GAAG,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;wBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE;wBAC5C,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;YACjC,MAAM,OAAO,GAAG,cAAc,CAC5B,MAAM,CAAC,MAAM,EACb,KAAK,CAAC,SAAS,CAAwC,CACxD,CAAA;YAED,mDAAmD;YACnD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO;oBAAE,SAAQ;gBACtB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACzC,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzD,GAAG,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;wBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE;wBAC5C,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YAED,+DAA+D;YAC/D,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACzC,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CACjD;iBACF,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YAED,sEAAsE;YACtE,gEAAgE;YAChE,kCAAkC;YAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAK,KAAK,CAAC,GAAG,CAAwB,CAAA;YACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAK,KAAK,CAAC,MAAM,CAAwB,CAAA;YACnE,MAAM,KAAK,GACT,QAAQ,CAAC,KAAK,IAAK,KAAK,CAAC,OAAO,CAAgC,CAAA;YAElE,IAAI,QAAQ,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACtC,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YAC1B,IAAI,CAAC,MAAM,CACT,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EACjD,CAAC,EACD,MAAM,CAAC,MAAM,CACd,CAAA;YACD,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;gBACzC,GAAG,QAAQ;gBACX,KAAK,EAAE,IAAI;gBACX,GAAG,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;oBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE;oBAC/B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC1C,0EAA0E;QAC1E,eAAe;QACf,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAwC,CAAC,CAAA;QAC5D,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAC5B,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;;gBAC5C,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAChE,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC9B,UAAU,CAAC,MAAM,CAAC,CAAA;YAClB,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACzD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC,CAAA;IAED;;;;OAIG;IACH,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;QACjD,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE;YACvB,KAAK,MAAM,MAAM,IAAI,KAAK;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC5C,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE;gBACnC,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC1D,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAC/B,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAC1B,EAAE,MAAM,EAAE,WAAW,EAAE,CACxB;QACH,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YACnB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrB,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;QACD,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,kEAAkE;YAClE,SAAS,CAAC,MAAM,EAAE,CAAA;YAClB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YACnB,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,MAAM,aAAa,EAAE,CAAA;YACrB,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;QAC/B,CAAC;QACD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAA;IAEF,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,EAAE,CAAA;YACd,yDAAyD;YACzD,SAAS,CAAC,MAAM,EAAE,CAAA;YAClB,KAAK,EAAE,CAAA;QACT,CAAC;QACD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC","sourcesContent":["import type { QueryClient, QueryKey } from '@tanstack/query-core'\n\nimport { hashKey, notifyManager } from '@tanstack/query-core'\n\nimport type {\n  AnyBunderstackApp,\n  InferSchema,\n  InferSelect,\n  InferTables,\n} from './infer'\nimport type { NotifyScheduler, RealtimeClock } from './realtime-flush'\nimport type {\n  RealtimeAction,\n  RealtimeChange,\n  RealtimeProcedure,\n  RealtimeSyncHandle,\n} from './realtime-stream'\n\nimport { createFlushScheduler } from './realtime-flush'\nimport { openRealtimeStream } from './realtime-stream'\n\n// The event types live with the stream that produces them; re-exported here so\n// the package's public surface is unchanged.\nexport type { NotifyScheduler, RealtimeClock } from './realtime-flush'\nexport type {\n  RealtimeAction,\n  RealtimeChange,\n  RealtimeEvent,\n  RealtimeHeartbeat,\n  RealtimeProcedure,\n  RealtimeSyncHandle,\n} from './realtime-stream'\n\n/**\n * The change for one table, with `record` typed as that table's row.\n *\n * Passing the app type to `syncRealtime` turns `tables` into a checked list of\n * exposed table names and `onChange` into a union discriminated by `table`, so\n * `change.table === 'todos'` narrows `change.record` to the todo row:\n *\n * ```ts\n * syncRealtime<App>({\n *   api,\n *   queryClient,\n *   tables: ['todos'],\n *   onChange: (change) => {\n *     if (change.table === 'todos') console.log(change.record.done)\n *   },\n * })\n * ```\n */\nexport type RealtimeChangeFor<\n  TApp extends AnyBunderstackApp,\n  TTable extends InferTables<TApp>,\n> = {\n  table: TTable\n  action: RealtimeAction\n  record: InferSelect<InferSchema<TApp>[TTable]>\n  operationId?: string\n}\n\n/**\n * Untyped when no app type is supplied, so existing callers — and consumers\n * that only have a structural client — keep the loose `RealtimeChange`.\n */\nexport type RealtimeChangeOf<TApp, TTable extends string> = [TApp] extends [\n  never,\n]\n  ? RealtimeChange\n  : TApp extends AnyBunderstackApp\n    ? TTable extends InferTables<TApp>\n      ? RealtimeChangeFor<TApp, TTable>\n      : RealtimeChange\n    : RealtimeChange\n\n/** Every exposed table name, or any string when no app type is supplied. */\nexport type RealtimeTableName<TApp> = [TApp] extends [never]\n  ? string\n  : TApp extends AnyBunderstackApp\n    ? InferTables<TApp>\n    : string\n\nexport type RealtimeQueryApi = {\n  realtime: { changes: RealtimeProcedure }\n  [table: string]: any\n}\n\n/**\n * How a change reaches the cache.\n *\n * `invalidate` (default) marks the table's queries stale and lets TanStack\n * Query refetch them — always correct, one request per change.\n *\n * `patch` writes the change into cached list results instead, so a write costs\n * no extra request. The event carries the action and the full row, and\n * Bunderstack's list contract is narrow enough to decide membership locally:\n * filters are `=`, `IN`, or `IS NULL`, and ordering is a single column. Any\n * list where that is not decidable — a text search, or a page that is not the\n * complete result — falls back to invalidation.\n */\nexport type RealtimeApplyStrategy = 'invalidate' | 'patch'\n\nexport type RealtimeSyncOptions<\n  TApp = never,\n  TTable extends string = RealtimeTableName<TApp>,\n> = {\n  api: RealtimeQueryApi\n  queryClient: QueryClient\n  tables: TTable[]\n  signal?: AbortSignal\n  /** Defaults to `'invalidate'`. */\n  apply?: RealtimeApplyStrategy\n  /**\n   * When buffered changes reach the cache. Defaults to `'frame'`, which\n   * collapses a burst into one cache write and one invalidation per table.\n   * Pass `'sync'` to write as each change arrives, as versions before 0.18 did.\n   */\n  notifyScheduler?: NotifyScheduler\n  /** Timer functions, injectable for tests. */\n  clock?: RealtimeClock\n  /** Initial reconnect delay before jitter. Defaults to 1 second. */\n  retryMs?: number\n  /** Maximum reconnect delay before jitter. Defaults to 30 seconds. */\n  maxRetryMs?: number\n  onChange?: (change: RealtimeChangeOf<TApp, TTable>) => void\n  onReconnect?: () => void | Promise<void>\n  onError?: (error: unknown) => void\n  onRetry?: (retry: { attempt: number; delayMs: number }) => void\n}\n\nfunction tableQueryKey(api: RealtimeQueryApi, table: string): QueryKey {\n  return api[table]?.key?.({ type: 'query' }) ?? [[table], { type: 'query' }]\n}\n\nfunction detailQueryKey(\n  api: RealtimeQueryApi,\n  table: string,\n  id: unknown,\n): QueryKey {\n  return (\n    api[table]?.get?.queryKey?.({ input: { id } }) ?? [\n      [table, 'get'],\n      { type: 'query', input: { id } },\n    ]\n  )\n}\n\nfunction listQueryKey(api: RealtimeQueryApi, table: string): QueryKey {\n  return (\n    api[table]?.list?.key?.({ type: 'query' }) ?? [\n      [table, 'list'],\n      { type: 'query' },\n    ]\n  )\n}\n\n/** The shape every generated list endpoint returns, as far as patching cares. */\ntype ListSnapshot = {\n  items: Record<string, unknown>[]\n  hasMore?: boolean\n  total?: number\n  offset?: number\n  cursor?: string\n  q?: string\n  sort?: string\n  order?: 'asc' | 'desc'\n}\n\nfunction isListSnapshot(value: unknown): value is ListSnapshot {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Array.isArray((value as ListSnapshot).items)\n  )\n}\n\n/** Dates arrive as Dates over the wire, so identity is not enough. */\nfunction sameValue(a: unknown, b: unknown): boolean {\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime()\n  return a === b\n}\n\n/**\n * Bunderstack's filter contract is narrow by design — a scalar is `=`, an\n * array is `IN`, and `null` is `IS NULL` — so membership is decidable against\n * a single record without asking the server.\n */\nfunction matchesFilters(\n  record: Record<string, unknown>,\n  filters: Record<string, unknown> | undefined,\n): boolean {\n  for (const [column, expected] of Object.entries(filters ?? {})) {\n    if (expected === undefined) continue\n    const actual = record[column]\n    if (expected === null) {\n      if (actual !== null && actual !== undefined) return false\n      continue\n    }\n    if (Array.isArray(expected)) {\n      if (!expected.some((value) => sameValue(value, actual))) return false\n      continue\n    }\n    if (!sameValue(expected, actual)) return false\n  }\n  return true\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime()\n  if (typeof a === 'number' && typeof b === 'number') return a - b\n  if (typeof a === 'boolean' && typeof b === 'boolean')\n    return Number(a) - Number(b)\n  return String(a).localeCompare(String(b))\n}\n\n/**\n * Where the row goes in an already-sorted page.\n *\n * Ties are common rather than exotic: a `timestamp` column stores seconds, so\n * rows written in the same second share a sort value. SQL does not define an\n * order within a tie, so the new row is placed as the most recent of its\n * equals — first under `desc`, last under `asc` — which is where a reader\n * expects a just-written row to appear.\n */\nfunction insertionIndex(\n  items: Record<string, unknown>[],\n  record: Record<string, unknown>,\n  sort: string,\n  order: 'asc' | 'desc',\n): number {\n  const value = record[sort]\n  const index = items.findIndex((item) => {\n    const comparison = compareValues(value, item[sort])\n    return order === 'desc' ? comparison >= 0 : comparison < 0\n  })\n  return index === -1 ? items.length : index\n}\n\n/**\n * A cached page can only absorb an insert when it already holds every row the\n * query would return. A partial page cannot: the new row may belong to another\n * page, and inserting would shift the boundary the server drew.\n */\nfunction holdsCompleteResult(snapshot: ListSnapshot): boolean {\n  return (\n    snapshot.hasMore === false &&\n    !snapshot.cursor &&\n    (snapshot.offset === undefined || snapshot.offset === 0)\n  )\n}\n\nfunction readInput(queryKey: QueryKey): Record<string, unknown> {\n  const meta = queryKey[1] as { input?: unknown } | undefined\n  const input = meta?.input\n  return typeof input === 'object' && input !== null\n    ? (input as Record<string, unknown>)\n    : {}\n}\n\nexport function syncRealtime<\n  TApp = never,\n  TTable extends string = RealtimeTableName<TApp>,\n>(options: RealtimeSyncOptions<TApp, TTable>): RealtimeSyncHandle {\n  const scheduler = createFlushScheduler(\n    options.notifyScheduler ?? 'frame',\n    options.clock,\n  )\n  /** Changes waiting for the next flush, in arrival order. */\n  const buffered: RealtimeChange[] = []\n  /**\n   * Query keys the flush must invalidate, deduplicated by their hash. Keyed\n   * this way rather than by table so a list that cannot absorb a change still\n   * invalidates only itself, while a burst against one key collapses to one\n   * call.\n   */\n  const stale = new Map<string, QueryKey>()\n\n  const invalidateAll = async () => {\n    await Promise.all(\n      options.tables.map((table) =>\n        options.queryClient.invalidateQueries({\n          queryKey: tableQueryKey(options.api, table),\n        }),\n      ),\n    )\n  }\n\n  /**\n   * Write the change into every cached list for the table, marking the table\n   * stale for any list whose membership or ordering cannot be settled locally.\n   * A list is only patched when the answer is certain.\n   */\n  const patchLists = (change: RealtimeChange) => {\n    const prefix = listQueryKey(options.api, change.table)\n    const queries = options.queryClient\n      .getQueryCache()\n      .findAll({ queryKey: prefix })\n    const id = change.record['id']\n\n    for (const query of queries) {\n      const snapshot = query.state.data\n      if (!isListSnapshot(snapshot)) continue\n\n      const queryKey = query.queryKey\n      const items = snapshot.items\n      const present = items.some((item) => sameValue(item['id'], id))\n\n      if (change.action === 'delete') {\n        if (!present) continue\n        options.queryClient.setQueryData(queryKey, {\n          ...snapshot,\n          items: items.filter((item) => !sameValue(item['id'], id)),\n          ...(typeof snapshot.total === 'number'\n            ? { total: Math.max(0, snapshot.total - 1) }\n            : {}),\n        })\n        continue\n      }\n\n      const input = readInput(queryKey)\n      const belongs = matchesFilters(\n        change.record,\n        input['filters'] as Record<string, unknown> | undefined,\n      )\n\n      // An update can move a row out of a filtered list.\n      if (!belongs) {\n        if (!present) continue\n        options.queryClient.setQueryData(queryKey, {\n          ...snapshot,\n          items: items.filter((item) => !sameValue(item['id'], id)),\n          ...(typeof snapshot.total === 'number'\n            ? { total: Math.max(0, snapshot.total - 1) }\n            : {}),\n        })\n        continue\n      }\n\n      // Already here: replace in place and keep the row where it is.\n      if (present) {\n        options.queryClient.setQueryData(queryKey, {\n          ...snapshot,\n          items: items.map((item) =>\n            sameValue(item['id'], id) ? change.record : item,\n          ),\n        })\n        continue\n      }\n\n      // The row joins this list. Only safe on a page that holds everything,\n      // and only when `q` is absent — a text match needs the server's\n      // searchable columns to evaluate.\n      const searched = snapshot.q ?? (input['q'] as string | undefined)\n      const sort = snapshot.sort ?? (input['sort'] as string | undefined)\n      const order =\n        snapshot.order ?? (input['order'] as 'asc' | 'desc' | undefined)\n\n      if (searched || !sort || !order || !holdsCompleteResult(snapshot)) {\n        stale.set(hashKey(queryKey), queryKey)\n        continue\n      }\n\n      const next = items.slice()\n      next.splice(\n        insertionIndex(items, change.record, sort, order),\n        0,\n        change.record,\n      )\n      options.queryClient.setQueryData(queryKey, {\n        ...snapshot,\n        items: next,\n        ...(typeof snapshot.total === 'number'\n          ? { total: snapshot.total + 1 }\n          : {}),\n      })\n    }\n  }\n\n  const applyOne = (change: RealtimeChange) => {\n    // The runtime shape is the same either way; the generic only narrows what\n    // callers see.\n    options.onChange?.(change as RealtimeChangeOf<TApp, TTable>)\n    const id = change.record['id']\n    if (id !== undefined) {\n      const queryKey = detailQueryKey(options.api, change.table, id)\n      if (change.action === 'delete')\n        options.queryClient.removeQueries({ queryKey })\n      else options.queryClient.setQueryData(queryKey, change.record)\n    }\n\n    if (options.apply === 'patch') {\n      patchLists(change)\n      return\n    }\n\n    const tableKey = tableQueryKey(options.api, change.table)\n    stale.set(hashKey(tableKey), tableKey)\n  }\n\n  /**\n   * One pass over the buffer, then one invalidation per stale table. The\n   * second part is the point: a burst of changes to a table used to issue one\n   * `invalidateQueries` each, and now issues one in total.\n   */\n  const flush = () => {\n    if (buffered.length === 0) return\n    const batch = buffered.splice(0, buffered.length)\n    notifyManager.batch(() => {\n      for (const change of batch) applyOne(change)\n      for (const queryKey of stale.values())\n        void options.queryClient.invalidateQueries({ queryKey })\n      stale.clear()\n    })\n  }\n\n  const stream = openRealtimeStream({\n    subscribe: ({ signal, lastEventId }) =>\n      options.api.realtime.changes.call(\n        { tables: options.tables },\n        { signal, lastEventId },\n      ),\n    onChange: (change) => {\n      buffered.push(change)\n      scheduler.schedule(flush)\n    },\n    onReconnect: async () => {\n      // A refetch of everything supersedes whatever was still buffered.\n      scheduler.cancel()\n      buffered.length = 0\n      stale.clear()\n      await invalidateAll()\n      await options.onReconnect?.()\n    },\n    onError: options.onError,\n    onRetry: options.onRetry,\n    signal: options.signal ?? new AbortController().signal,\n    retryMs: options.retryMs,\n    maxRetryMs: options.maxRetryMs,\n    clock: options.clock,\n  })\n\n  return {\n    close: () => {\n      stream.close()\n      // Anything already delivered is still owed to the cache.\n      scheduler.cancel()\n      flush()\n    },\n    done: stream.done,\n  }\n}\n"]}

package/dist/start/auth-client.d.ts

@@ -0,0 +1,11 @@
+/**
+ * BetterAuth browser client pointed at the Bunderstack handler's
+ * /api/auth/* routes. Defaults to the current origin in the browser and
+ * APP_URL (or localhost:3000) during SSR.
+ */
+export declare function createStartAuthClient(options?: {
+    baseURL?: string;
+}): import("better-auth/react").ReactAuthClient<{
+    baseURL: string;
+}>;
+//# sourceMappingURL=auth-client.d.ts.map

package/dist/start/auth-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../src/start/auth-client.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO;;GAQvE"}

package/dist/start/auth-client.js

@@ -0,0 +1,15 @@
+import { createAuthClient } from 'better-auth/react';
+/**
+ * BetterAuth browser client pointed at the Bunderstack handler's
+ * /api/auth/* routes. Defaults to the current origin in the browser and
+ * APP_URL (or localhost:3000) during SSR.
+ */
+export function createStartAuthClient(options = {}) {
+    return createAuthClient({
+        baseURL: options.baseURL ??
+            (typeof window !== 'undefined'
+                ? window.location.origin
+                : (process.env.APP_URL ?? 'http://localhost:3000')),
+    });
+}
+//# sourceMappingURL=auth-client.js.map

package/dist/start/auth-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-client.js","sourceRoot":"","sources":["../../src/start/auth-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAgC,EAAE;IACtE,OAAO,gBAAgB,CAAC;QACtB,OAAO,EACL,OAAO,CAAC,OAAO;YACf,CAAC,OAAO,MAAM,KAAK,WAAW;gBAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;gBACxB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC;KACxD,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import { createAuthClient } from 'better-auth/react'\n\n/**\n * BetterAuth browser client pointed at the Bunderstack handler's\n * /api/auth/* routes. Defaults to the current origin in the browser and\n * APP_URL (or localhost:3000) during SSR.\n */\nexport function createStartAuthClient(options: { baseURL?: string } = {}) {\n  return createAuthClient({\n    baseURL:\n      options.baseURL ??\n      (typeof window !== 'undefined'\n        ? window.location.origin\n        : (process.env.APP_URL ?? 'http://localhost:3000')),\n  })\n}\n"]}