bunderstack 0.19.2 → 0.21.0

package/dist/client/realtime.js

@@ -0,0 +1,105 @@
+import { getEventMeta } from '@standardserver/core';
+export const DEFAULT_KEEPALIVE_MS = 5_000;
+export const DEFAULT_LIVENESS_FACTOR = 2.5;
+const systemClock = {
+    setTimeout: (fn, ms) => setTimeout(fn, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+export function isRealtimeHeartbeat(event) {
+    return 'type' in event && event.type === 'heartbeat';
+}
+const LIVENESS_ABORT = 'bunderstack: realtime stream went silent';
+/** Shared reconnecting transport used by LiveView, Query, and DB adapters. */
+export function openRealtimeStream(options) {
+    const controller = new AbortController();
+    const signal = AbortSignal.any([controller.signal, options.signal]);
+    const clock = options.clock ?? systemClock;
+    const random = options.random ?? Math.random;
+    const retryMs = Math.max(0, options.retryMs ?? 1_000);
+    const maxRetryMs = Math.max(retryMs, options.maxRetryMs ?? 30_000);
+    const livenessFactor = options.livenessFactor ?? DEFAULT_LIVENESS_FACTOR;
+    let keepaliveMs = options.defaultKeepaliveMs ?? DEFAULT_KEEPALIVE_MS;
+    const wait = (ms) => new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const timer = clock.setTimeout(done, ms);
+        function done() {
+            clock.clearTimeout(timer);
+            signal.removeEventListener('abort', done);
+            resolve();
+        }
+        signal.addEventListener('abort', done, { once: true });
+    });
+    const done = (async () => {
+        let connected = false;
+        let lastEventId;
+        let retryAttempt = 0;
+        while (!signal.aborted) {
+            const attempt = new AbortController();
+            const attemptSignal = AbortSignal.any([signal, attempt.signal]);
+            let timer;
+            let wentSilent = false;
+            const disarm = () => {
+                if (timer === undefined)
+                    return;
+                clock.clearTimeout(timer);
+                timer = undefined;
+            };
+            const arm = () => {
+                disarm();
+                timer = clock.setTimeout(() => {
+                    wentSilent = true;
+                    attempt.abort(new Error(LIVENESS_ABORT));
+                }, keepaliveMs * livenessFactor);
+            };
+            try {
+                const events = await options.subscribe({
+                    signal: attemptSignal,
+                    lastEventId,
+                });
+                arm();
+                if (connected)
+                    await options.onReconnect();
+                connected = true;
+                for await (const event of events) {
+                    retryAttempt = 0;
+                    if (isRealtimeHeartbeat(event)) {
+                        if (typeof event.intervalMs === 'number' && event.intervalMs > 0)
+                            keepaliveMs = event.intervalMs;
+                        arm();
+                        continue;
+                    }
+                    arm();
+                    const id = getEventMeta(event)?.id;
+                    if (id)
+                        lastEventId = id;
+                    try {
+                        options.onChange(event);
+                    }
+                    catch (error) {
+                        options.onError?.(error);
+                    }
+                    if (signal.aborted)
+                        break;
+                }
+            }
+            catch (error) {
+                if (!signal.aborted && !wentSilent)
+                    options.onError?.(error);
+            }
+            finally {
+                disarm();
+            }
+            if (!signal.aborted) {
+                const attemptNumber = retryAttempt + 1;
+                const ceiling = Math.min(maxRetryMs, retryMs * 2 ** retryAttempt);
+                const delayMs = Math.floor(random() * ceiling);
+                retryAttempt = attemptNumber;
+                options.onRetry?.({ attempt: attemptNumber, delayMs });
+                await wait(delayMs);
+            }
+        }
+    })();
+    return { close: () => controller.abort(), done };
+}
+//# sourceMappingURL=realtime.js.map

package/dist/client/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/client/realtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { getEventMeta } from '@standardserver/core'\n\nexport type RealtimeAction = 'create' | 'update' | 'delete'\nexport type RealtimeChange = {\n  table: string\n  action: RealtimeAction\n  record: Record<string, unknown>\n  operationId?: string\n}\nexport type RealtimeHeartbeat = { type: 'heartbeat'; intervalMs?: number }\nexport type RealtimeEvent = RealtimeChange | RealtimeHeartbeat\nexport type RealtimeProcedure = {\n  call(\n    input: { tables: string[] },\n    options?: { signal?: AbortSignal; lastEventId?: string },\n  ): Promise<AsyncIterable<RealtimeEvent>>\n}\nexport type RealtimeSyncHandle = { close(): void; done: Promise<void> }\nexport type RealtimeClock = {\n  setTimeout(fn: () => void, ms: number): unknown\n  clearTimeout(handle: unknown): void\n}\nexport const DEFAULT_KEEPALIVE_MS = 5_000\nexport const DEFAULT_LIVENESS_FACTOR = 2.5\n\nconst systemClock: RealtimeClock = {\n  setTimeout: (fn, ms) => setTimeout(fn, ms),\n  clearTimeout: (handle) =>\n    clearTimeout(handle as ReturnType<typeof setTimeout>),\n}\n\nexport type RealtimeStreamOptions = {\n  subscribe: (options: {\n    signal: AbortSignal\n    lastEventId?: string\n  }) => Promise<AsyncIterable<RealtimeEvent>>\n  onChange: (change: RealtimeChange) => void\n  onReconnect: () => void | Promise<void>\n  onError?: (error: unknown) => void\n  onRetry?: (retry: { attempt: number; delayMs: number }) => void\n  signal: AbortSignal\n  retryMs?: number\n  maxRetryMs?: number\n  livenessFactor?: number\n  defaultKeepaliveMs?: number\n  clock?: RealtimeClock\n  random?: () => number\n}\n\nexport function isRealtimeHeartbeat(\n  event: RealtimeEvent,\n): event is RealtimeHeartbeat {\n  return 'type' in event && event.type === 'heartbeat'\n}\n\nconst LIVENESS_ABORT = 'bunderstack: realtime stream went silent'\n\n/** Shared reconnecting transport used by LiveView, Query, and DB adapters. */\nexport function openRealtimeStream(\n  options: RealtimeStreamOptions,\n): RealtimeSyncHandle {\n  const controller = new AbortController()\n  const signal = AbortSignal.any([controller.signal, options.signal])\n  const clock = options.clock ?? systemClock\n  const random = options.random ?? Math.random\n  const retryMs = Math.max(0, options.retryMs ?? 1_000)\n  const maxRetryMs = Math.max(retryMs, options.maxRetryMs ?? 30_000)\n  const livenessFactor = options.livenessFactor ?? DEFAULT_LIVENESS_FACTOR\n  let keepaliveMs = options.defaultKeepaliveMs ?? DEFAULT_KEEPALIVE_MS\n\n  const wait = (ms: number) =>\n    new Promise<void>((resolve) => {\n      if (signal.aborted) return resolve()\n      const timer = clock.setTimeout(done, ms)\n      function done() {\n        clock.clearTimeout(timer)\n        signal.removeEventListener('abort', done)\n        resolve()\n      }\n      signal.addEventListener('abort', done, { once: true })\n    })\n\n  const done = (async () => {\n    let connected = false\n    let lastEventId: string | undefined\n    let retryAttempt = 0\n    while (!signal.aborted) {\n      const attempt = new AbortController()\n      const attemptSignal = AbortSignal.any([signal, attempt.signal])\n      let timer: unknown\n      let wentSilent = false\n      const disarm = () => {\n        if (timer === undefined) return\n        clock.clearTimeout(timer)\n        timer = undefined\n      }\n      const arm = () => {\n        disarm()\n        timer = clock.setTimeout(() => {\n          wentSilent = true\n          attempt.abort(new Error(LIVENESS_ABORT))\n        }, keepaliveMs * livenessFactor)\n      }\n      try {\n        const events = await options.subscribe({\n          signal: attemptSignal,\n          lastEventId,\n        })\n        arm()\n        if (connected) await options.onReconnect()\n        connected = true\n        for await (const event of events) {\n          retryAttempt = 0\n          if (isRealtimeHeartbeat(event)) {\n            if (typeof event.intervalMs === 'number' && event.intervalMs > 0)\n              keepaliveMs = event.intervalMs\n            arm()\n            continue\n          }\n          arm()\n          const id = getEventMeta(event)?.id\n          if (id) lastEventId = id\n          try {\n            options.onChange(event)\n          } catch (error) {\n            options.onError?.(error)\n          }\n          if (signal.aborted) break\n        }\n      } catch (error) {\n        if (!signal.aborted && !wentSilent) options.onError?.(error)\n      } finally {\n        disarm()\n      }\n      if (!signal.aborted) {\n        const attemptNumber = retryAttempt + 1\n        const ceiling = Math.min(maxRetryMs, retryMs * 2 ** retryAttempt)\n        const delayMs = Math.floor(random() * ceiling)\n        retryAttempt = attemptNumber\n        options.onRetry?.({ attempt: attemptNumber, delayMs })\n        await wait(delayMs)\n      }\n    }\n  })()\n  return { close: () => controller.abort(), done }\n}\n"]}

package/dist/client/rest.d.ts

@@ -0,0 +1,2 @@
+export { createRestClient, type ClientOf, type RestClientOptions, type RouteCallOptions, type RouteMethod, type RouteOperation, } from './client.js';
+//# sourceMappingURL=rest.d.ts.map

package/dist/client/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/client/rest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAA"}

package/dist/client/rest.js

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

package/dist/client/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../src/client/rest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAMjB,MAAM,UAAU,CAAA","sourcesContent":["export {\n  createRestClient,\n  type ClientOf,\n  type RestClientOptions,\n  type RouteCallOptions,\n  type RouteMethod,\n  type RouteOperation,\n} from './client'\n"]}

package/dist/client/rpc-client.d.ts

@@ -0,0 +1,38 @@
+import type { AnyRouter, RouterClient } from '@orpc/server';
+export declare const OPERATION_ID_HEADER = "x-bunderstack-operation-id";
+export type Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export type ClientOptions = {
+    baseUrl?: string;
+    fetch?: Fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+};
+export type CallOptions = {
+    signal?: AbortSignal;
+    lastEventId?: string;
+    operationId?: string;
+    headers?: HeadersInit;
+};
+export type ClientCarrier = {
+    api: AnyRouter;
+    buckets: string;
+};
+export type AnyBunderstackApp = {
+    $inferClient?: ClientCarrier | undefined;
+};
+export type InferApiRouter<TApp extends AnyBunderstackApp> = NonNullable<TApp['$inferClient']>['api'];
+type RpcContext = {
+    operationId?: string;
+    headers?: HeadersInit;
+};
+type AdaptCallArgs<TArgs extends unknown[]> = {
+    [K in keyof TArgs]: K extends 1 | '1' ? CallOptions : TArgs[K];
+};
+export type DirectClient<T> = T extends (...args: infer TArgs) => infer TResult ? (...args: AdaptCallArgs<TArgs>) => TResult : {
+    [K in keyof T]: DirectClient<T[K]>;
+};
+export type RpcClient<TRouter extends AnyRouter> = DirectClient<RouterClient<TRouter, RpcContext>>;
+export type BunderstackClient<TApp extends AnyBunderstackApp> = RpcClient<InferApiRouter<TApp>>;
+export declare function createRpcClient<TRouter extends AnyRouter>(options?: ClientOptions): RpcClient<TRouter>;
+export declare function createClient<TApp extends AnyBunderstackApp>(options?: ClientOptions): BunderstackClient<TApp>;
+export {};
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/client/rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../src/client/rpc-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAK3D,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAE/D,MAAM,MAAM,KAAK,GAAG,CAClB,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtB,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;CACnE,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,SAAS,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,iBAAiB,IAAI,WAAW,CACtE,IAAI,CAAC,cAAc,CAAC,CACrB,CAAC,KAAK,CAAC,CAAA;AAER,KAAK,UAAU,GAAG;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB,CAAA;AAED,KAAK,aAAa,CAAC,KAAK,SAAS,OAAO,EAAE,IAAI;KAC3C,CAAC,IAAI,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC;CAC/D,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,MAAM,OAAO,GAC3E,CAAC,GAAG,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,OAAO,GAC1C;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAE1C,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,SAAS,IAAI,YAAY,CAC7D,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAClC,CAAA;AAED,MAAM,MAAM,iBAAiB,CAAC,IAAI,SAAS,iBAAiB,IAAI,SAAS,CACvE,cAAc,CAAC,IAAI,CAAC,CACrB,CAAA;AA6CD,wBAAgB,eAAe,CAAC,OAAO,SAAS,SAAS,EACvD,OAAO,GAAE,aAAkB,GAC1B,SAAS,CAAC,OAAO,CAAC,CAuBpB;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAS,iBAAiB,EACzD,OAAO,GAAE,aAAkB,GAC1B,iBAAiB,CAAC,IAAI,CAAC,CAEzB"}

package/dist/client/rpc-client.js

@@ -0,0 +1,59 @@
+import { createORPCClient } from '@orpc/client';
+import { RPCLink } from '@orpc/client/fetch';
+export const OPERATION_ID_HEADER = 'x-bunderstack-operation-id';
+function rpcUrl(baseUrl = '/api') {
+    return (baseUrl.endsWith('/') ? `${baseUrl}rpc` : `${baseUrl}/rpc`);
+}
+function adaptClient(client) {
+    const cache = new Map();
+    return new Proxy(function () { }, {
+        get(_target, property) {
+            if (!cache.has(property)) {
+                const value = Reflect.get(client, property);
+                cache.set(property, value === null ||
+                    (typeof value !== 'object' && typeof value !== 'function')
+                    ? value
+                    : adaptClient(value));
+            }
+            return cache.get(property);
+        },
+        apply(_target, _thisArg, args) {
+            const [input, options = {}] = args;
+            return Reflect.apply(client, undefined, [
+                input,
+                {
+                    signal: options.signal,
+                    lastEventId: options.lastEventId,
+                    context: {
+                        operationId: options.operationId,
+                        headers: options.headers,
+                    },
+                },
+            ]);
+        },
+    });
+}
+export function createRpcClient(options = {}) {
+    const fetcher = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+    const link = new RPCLink({
+        url: rpcUrl(options.baseUrl),
+        fetch: (url, init) => fetcher(url, init),
+        headers: async ({ context }) => {
+            const defaults = typeof options.headers === 'function'
+                ? await options.headers()
+                : options.headers;
+            const headers = new Headers(defaults);
+            new Headers(context.headers).forEach((value, key) => headers.set(key, value));
+            if (context.operationId) {
+                headers.set(OPERATION_ID_HEADER, context.operationId);
+            }
+            return headers;
+        },
+    });
+    const client = createORPCClient(link);
+    return adaptClient(client);
+}
+export function createClient(options = {}) {
+    return createRpcClient(options);
+}
+//# sourceMappingURL=rpc-client.js.map

package/dist/client/rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.js","sourceRoot":"","sources":["../../src/client/rpc-client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StandardUrl } from '@orpc/client/standard'\nimport type { AnyRouter, RouterClient } from '@orpc/server'\n\nimport { createORPCClient } from '@orpc/client'\nimport { RPCLink } from '@orpc/client/fetch'\n\nexport const OPERATION_ID_HEADER = 'x-bunderstack-operation-id'\n\nexport type Fetch = (\n  input: RequestInfo | URL,\n  init?: RequestInit,\n) => Promise<Response>\n\nexport type ClientOptions = {\n  baseUrl?: string\n  fetch?: Fetch\n  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>)\n}\n\nexport type CallOptions = {\n  signal?: AbortSignal\n  lastEventId?: string\n  operationId?: string\n  headers?: HeadersInit\n}\n\nexport type ClientCarrier = {\n  api: AnyRouter\n  buckets: string\n}\n\nexport type AnyBunderstackApp = {\n  $inferClient?: ClientCarrier | undefined\n}\n\nexport type InferApiRouter<TApp extends AnyBunderstackApp> = NonNullable<\n  TApp['$inferClient']\n>['api']\n\ntype RpcContext = {\n  operationId?: string\n  headers?: HeadersInit\n}\n\ntype AdaptCallArgs<TArgs extends unknown[]> = {\n  [K in keyof TArgs]: K extends 1 | '1' ? CallOptions : TArgs[K]\n}\n\nexport type DirectClient<T> = T extends (...args: infer TArgs) => infer TResult\n  ? (...args: AdaptCallArgs<TArgs>) => TResult\n  : { [K in keyof T]: DirectClient<T[K]> }\n\nexport type RpcClient<TRouter extends AnyRouter> = DirectClient<\n  RouterClient<TRouter, RpcContext>\n>\n\nexport type BunderstackClient<TApp extends AnyBunderstackApp> = RpcClient<\n  InferApiRouter<TApp>\n>\n\nfunction rpcUrl(baseUrl = '/api'): StandardUrl {\n  return (\n    baseUrl.endsWith('/') ? `${baseUrl}rpc` : `${baseUrl}/rpc`\n  ) as StandardUrl\n}\n\nfunction adaptClient<T>(client: T): DirectClient<T> {\n  const cache = new Map<PropertyKey, unknown>()\n  return new Proxy(function () {} as (...args: unknown[]) => unknown, {\n    get(_target, property) {\n      if (!cache.has(property)) {\n        const value = Reflect.get(client as object, property)\n        cache.set(\n          property,\n          value === null ||\n            (typeof value !== 'object' && typeof value !== 'function')\n            ? value\n            : adaptClient(value),\n        )\n      }\n      return cache.get(property)\n    },\n    apply(_target, _thisArg, args: [unknown, CallOptions?]) {\n      const [input, options = {}] = args\n      return Reflect.apply(\n        client as (...args: unknown[]) => unknown,\n        undefined,\n        [\n          input,\n          {\n            signal: options.signal,\n            lastEventId: options.lastEventId,\n            context: {\n              operationId: options.operationId,\n              headers: options.headers,\n            },\n          },\n        ],\n      )\n    },\n  }) as unknown as DirectClient<T>\n}\n\nexport function createRpcClient<TRouter extends AnyRouter>(\n  options: ClientOptions = {},\n): RpcClient<TRouter> {\n  const fetcher =\n    options.fetch ?? ((input, init) => globalThis.fetch(input, init))\n  const link = new RPCLink<RpcContext>({\n    url: rpcUrl(options.baseUrl),\n    fetch: (url, init) => fetcher(url, init),\n    headers: async ({ context }) => {\n      const defaults =\n        typeof options.headers === 'function'\n          ? await options.headers()\n          : options.headers\n      const headers = new Headers(defaults)\n      new Headers(context.headers).forEach((value, key) =>\n        headers.set(key, value),\n      )\n      if (context.operationId) {\n        headers.set(OPERATION_ID_HEADER, context.operationId)\n      }\n      return headers\n    },\n  })\n  const client = createORPCClient<RouterClient<TRouter, RpcContext>>(link)\n  return adaptClient(client)\n}\n\nexport function createClient<TApp extends AnyBunderstackApp>(\n  options: ClientOptions = {},\n): BunderstackClient<TApp> {\n  return createRpcClient<InferApiRouter<TApp>>(options)\n}\n"]}

package/dist/client/solid.d.ts

@@ -0,0 +1,7 @@
+import { type Store } from 'solid-js';
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+/** Mirrors confirmed LiveView snapshots into a keyed Solid store. */
+export declare function createLiveStore<T extends {
+    id: unknown;
+}>(view: LiveView<T>): Store<LiveViewSnapshot<T>>;
+//# sourceMappingURL=solid.d.ts.map

package/dist/client/solid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../src/client/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,EACvD,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAiB5B"}

package/dist/client/solid.js

@@ -0,0 +1,21 @@
+import { createStore, onCleanup, reconcile } from 'solid-js';
+/** Mirrors confirmed LiveView snapshots into a keyed Solid store. */
+export function createLiveStore(view) {
+    const initial = view.getSnapshot();
+    const [state, setState] = createStore({
+        items: [...initial.items],
+        status: initial.status,
+        error: initial.error,
+    });
+    const unsubscribe = view.subscribe(() => {
+        const next = view.getSnapshot();
+        setState((draft) => {
+            reconcile([...next.items], (item) => item.id)(draft.items);
+            draft.status = next.status;
+            draft.error = next.error;
+        });
+    });
+    onCleanup(unsubscribe);
+    return state;
+}
+//# sourceMappingURL=solid.js.map

package/dist/client/solid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid.js","sourceRoot":"","sources":["../../src/client/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAc,MAAM,UAAU,CAAA;AAIxE,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC7B,IAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAClC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,WAAW,CAAC;QACpC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAA;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC/B,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC7D,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YAC1B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,SAAS,CAAC,WAAW,CAAC,CAAA;IACtB,OAAO,KAAmC,CAAA;AAC5C,CAAC","sourcesContent":["import { createStore, onCleanup, reconcile, type Store } from 'solid-js'\n\nimport type { LiveView, LiveViewSnapshot } from './live-view'\n\n/** Mirrors confirmed LiveView snapshots into a keyed Solid store. */\nexport function createLiveStore<T extends { id: unknown }>(\n  view: LiveView<T>,\n): Store<LiveViewSnapshot<T>> {\n  const initial = view.getSnapshot()\n  const [state, setState] = createStore({\n    items: [...initial.items],\n    status: initial.status,\n    error: initial.error,\n  })\n  const unsubscribe = view.subscribe(() => {\n    const next = view.getSnapshot()\n    setState((draft) => {\n      reconcile([...next.items], (item: T) => item.id)(draft.items)\n      draft.status = next.status\n      draft.error = next.error\n    })\n  })\n  onCleanup(unsubscribe)\n  return state as Store<LiveViewSnapshot<T>>\n}\n"]}

package/dist/client/svelte.d.ts

@@ -0,0 +1,6 @@
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+export type Readable<T> = {
+    subscribe(run: (value: T) => void): () => void;
+};
+export declare function liveStore<T>(view: LiveView<T>): Readable<LiveViewSnapshot<T>>;
+//# sourceMappingURL=svelte.d.ts.map

package/dist/client/svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../../src/client/svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAC/C,CAAA;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAO7E"}

package/dist/client/svelte.js

@@ -0,0 +1,9 @@
+export function liveStore(view) {
+    return {
+        subscribe(run) {
+            run(view.getSnapshot());
+            return view.subscribe(() => run(view.getSnapshot()));
+        },
+    };
+}
+//# sourceMappingURL=svelte.js.map

package/dist/client/svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.js","sourceRoot":"","sources":["../../src/client/svelte.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,SAAS,CAAI,IAAiB;IAC5C,OAAO;QACL,SAAS,CAAC,GAAG;YACX,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QACtD,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { LiveView, LiveViewSnapshot } from './live-view'\n\nexport type Readable<T> = {\n  subscribe(run: (value: T) => void): () => void\n}\n\nexport function liveStore<T>(view: LiveView<T>): Readable<LiveViewSnapshot<T>> {\n  return {\n    subscribe(run) {\n      run(view.getSnapshot())\n      return view.subscribe(() => run(view.getSnapshot()))\n    },\n  }\n}\n"]}

package/dist/client/vue.d.ts

@@ -0,0 +1,5 @@
+import { type ShallowRef } from 'vue';
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+/** Vue owns reactivity; LiveView supplies immutable external snapshots. */
+export declare function useLiveView<T>(view: LiveView<T>): ShallowRef<LiveViewSnapshot<T>>;
+//# sourceMappingURL=vue.d.ts.map

package/dist/client/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/client/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,KAAK,CAAA;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CASjC"}

package/dist/client/vue.js

@@ -0,0 +1,11 @@
+import { onScopeDispose, shallowRef } from 'vue';
+/** Vue owns reactivity; LiveView supplies immutable external snapshots. */
+export function useLiveView(view) {
+    const state = shallowRef(view.getSnapshot());
+    const unsubscribe = view.subscribe(() => {
+        state.value = view.getSnapshot();
+    });
+    onScopeDispose(unsubscribe);
+    return state;
+}
+//# sourceMappingURL=vue.js.map

package/dist/client/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/client/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAmB,MAAM,KAAK,CAAA;AAIjE,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CACzB,IAAiB;IAEjB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAE1C,CAAA;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;QACtC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC,CAAC,CAAA;IACF,cAAc,CAAC,WAAW,CAAC,CAAA;IAC3B,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["import { onScopeDispose, shallowRef, type ShallowRef } from 'vue'\n\nimport type { LiveView, LiveViewSnapshot } from './live-view'\n\n/** Vue owns reactivity; LiveView supplies immutable external snapshots. */\nexport function useLiveView<T>(\n  view: LiveView<T>,\n): ShallowRef<LiveViewSnapshot<T>> {\n  const state = shallowRef(view.getSnapshot()) as ShallowRef<\n    LiveViewSnapshot<T>\n  >\n  const unsubscribe = view.subscribe(() => {\n    state.value = view.getSnapshot()\n  })\n  onScopeDispose(unsubscribe)\n  return state\n}\n"]}

package/dist/codegen.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Typed route-map generation from the app's OpenAPI document.
+ *
+ * `generateRouteMap` turns `/api/openapi.json` into a small standalone module:
+ * an `ApiRoutes` type — one `Op` entry per operation, carrying its method,
+ * path literal, query/body/output types and whether it streams — plus a
+ * runtime `routes` descriptor object for that same list.
+ *
+ * The transport itself is deliberately NOT generated: a ~90-line handwritten
+ * client (`createRestClient`) consumes any route map. Types change with every API
+ * edit and are regenerated; the client never changes at all.
+ */
+type JsonSchema = {
+    $ref?: string;
+    type?: string | string[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    const?: unknown;
+    enum?: unknown[];
+    items?: JsonSchema;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+};
+/** JSON-schema subset → TypeScript type expression, with $refs inlined. */
+export declare function schemaToType(schema: JsonSchema | undefined, components?: Record<string, JsonSchema>, depth?: number): string;
+/**
+ * Deterministic operation names from the path shape:
+ * `/api/posts` GET → `postsList`; `/api/posts/{id}` PATCH → `postsUpdate`;
+ * `/api/posts/live` GET → `postsLive`; `/api/enrich` POST → `enrichCreate`.
+ */
+export declare function operationName(path: string, method: string): string;
+export declare function generateRouteMap(input: unknown): string;
+export {};
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CAC5C,CAAA;AAoCD,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAM,EAC3C,KAAK,SAAI,GACR,MAAM,CA+DR;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBlE;AA+FD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwDvD"}

package/dist/codegen.js

@@ -0,0 +1,235 @@
+/**
+ * Typed route-map generation from the app's OpenAPI document.
+ *
+ * `generateRouteMap` turns `/api/openapi.json` into a small standalone module:
+ * an `ApiRoutes` type — one `Op` entry per operation, carrying its method,
+ * path literal, query/body/output types and whether it streams — plus a
+ * runtime `routes` descriptor object for that same list.
+ *
+ * The transport itself is deliberately NOT generated: a ~90-line handwritten
+ * client (`createRestClient`) consumes any route map. Types change with every API
+ * edit and are regenerated; the client never changes at all.
+ */
+function pascal(value) {
+    return value
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part[0].toUpperCase() + part.slice(1))
+        .join('');
+}
+function camel(value) {
+    const asPascal = pascal(value);
+    return asPascal ? asPascal[0].toLowerCase() + asPascal.slice(1) : 'root';
+}
+/** JSON-schema subset → TypeScript type expression, with $refs inlined. */
+export function schemaToType(schema, components = {}, depth = 0) {
+    if (!schema || depth > 4)
+        return 'unknown';
+    if (schema.$ref) {
+        const name = schema.$ref.split('/').pop() ?? '';
+        return schemaToType(components[name], components, depth + 1);
+    }
+    if (schema.const !== undefined)
+        return JSON.stringify(schema.const);
+    if (schema.enum) {
+        return [...new Set(schema.enum.map((value) => JSON.stringify(value)))].join(' | ');
+    }
+    const variants = schema.anyOf ?? schema.oneOf;
+    if (variants) {
+        const members = [
+            ...new Set(variants.map((member) => schemaToType(member, components, depth))),
+        ];
+        const withoutNull = members.filter((member) => member !== 'null');
+        const joined = withoutNull.join(' | ');
+        const core = withoutNull.length > 1 ? `(${joined})` : joined || 'unknown';
+        return members.length !== withoutNull.length ? `${core} | null` : core;
+    }
+    if (schema.allOf) {
+        return schema.allOf
+            .map((member) => schemaToType(member, components, depth))
+            .join(' & ');
+    }
+    if (Array.isArray(schema.type)) {
+        return schema.type
+            .map((entry) => (entry === 'integer' ? 'number' : entry))
+            .join(' | ');
+    }
+    switch (schema.type) {
+        case 'string':
+            return 'string';
+        case 'integer':
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        case 'array':
+            return `${schemaToType(schema.items, components, depth)}[]`;
+        case 'object': {
+            const properties = schema.properties ?? {};
+            const required = new Set(schema.required ?? []);
+            if (Object.keys(properties).length === 0) {
+                return schema.additionalProperties === false
+                    ? 'Record<string, never>'
+                    : 'Record<string, unknown>';
+            }
+            const fields = Object.entries(properties).map(([key, child]) => {
+                const optional = required.has(key) ? '' : '?';
+                return `${JSON.stringify(key)}${optional}: ${schemaToType(child, components, depth)}`;
+            });
+            return `{ ${fields.join('; ')} }`;
+        }
+        default:
+            return 'unknown';
+    }
+}
+const METHOD_ACTIONS = {
+    get: 'Get',
+    post: 'Create',
+    patch: 'Update',
+    put: 'Update',
+    delete: 'Delete',
+};
+/**
+ * Deterministic operation names from the path shape:
+ * `/api/posts` GET → `postsList`; `/api/posts/{id}` PATCH → `postsUpdate`;
+ * `/api/posts/live` GET → `postsLive`; `/api/enrich` POST → `enrichCreate`.
+ */
+export function operationName(path, method) {
+    const segments = path.split('/').filter(Boolean);
+    if (segments[0] === 'api')
+        segments.shift();
+    const last = segments[segments.length - 1] ?? '';
+    const action = METHOD_ACTIONS[method] ?? pascal(method);
+    if (last.startsWith('{')) {
+        return `${camel(segments.slice(0, -1).join('_'))}${action}`;
+    }
+    const statics = segments.filter((segment) => !segment.startsWith('{'));
+    if (statics.length === 1 && method === 'get')
+        return `${camel(last)}List`;
+    if (statics.length === 1 && method === 'post')
+        return `${camel(last)}Create`;
+    // A deeper static path reads as its own name (`/api/posts/live`) — the
+    // method suffix would only add noise.
+    if (method === 'get')
+        return camel(statics.join('_'));
+    return `${camel(statics.join('_'))}${action}`;
+}
+const HTTP_METHODS = ['get', 'post', 'patch', 'put', 'delete'];
+function collectOperations(spec) {
+    const components = spec.components?.schemas ?? {};
+    const operations = [];
+    for (const [path, methods] of Object.entries(spec.paths ?? {})) {
+        // Better Auth owns its client contract. Keeping auth endpoints out of the
+        // generic REST artifact avoids a second, less capable auth API surface.
+        if (path === '/api/auth' || path.startsWith('/api/auth/'))
+            continue;
+        for (const rawMethod of Object.keys(methods)) {
+            if (!HTTP_METHODS.includes(rawMethod))
+                continue;
+            const operation = methods[rawMethod];
+            if (!operation)
+                continue;
+            const parameters = operation.parameters ?? [];
+            const queryParameters = parameters.filter((parameter) => parameter.in === 'query');
+            let queryType;
+            if (queryParameters.length > 0) {
+                const fields = queryParameters.map((parameter) => {
+                    const schema = parameter.schema ?? parameter.content?.['application/json']?.schema;
+                    return `${JSON.stringify(parameter.name)}?: ${schemaToType(schema, components)}`;
+                });
+                queryType = `{ ${fields.join('; ')} }`;
+            }
+            const requestSchema = operation.requestBody?.content?.['application/json']?.schema;
+            const rawBodyType = requestSchema
+                ? schemaToType(requestSchema, components)
+                : undefined;
+            // oRPC emits an empty-object request body even for body-less
+            // procedures like DELETE; a free-form record there is noise.
+            const bodyType = rawBodyType === 'Record<string, unknown>' && rawMethod === 'delete'
+                ? undefined
+                : rawBodyType;
+            const okResponse = operation.responses?.['200'] ?? operation.responses?.['201'];
+            const jsonSchema = okResponse?.content?.['application/json']?.schema;
+            const eventSchema = okResponse?.content?.['text/event-stream']?.schema;
+            let outputType = 'void';
+            let isStream = false;
+            if (eventSchema) {
+                isStream = true;
+                // oRPC wraps each SSE data frame as {event, data}; unwrap the payload.
+                // Wrapper variants that carry no data (or map to `unknown`) would
+                // swallow the whole union, so they are dropped here.
+                const wrapper = eventSchema.oneOf ?? eventSchema.anyOf ?? [];
+                outputType =
+                    [
+                        ...new Set(wrapper
+                            .map((variant) => variant.properties?.['data'])
+                            .filter((variant) => Boolean(variant))
+                            .map((variant) => schemaToType(variant, components))
+                            .filter((type) => type !== 'unknown')),
+                    ].join(' | ') || 'void';
+            }
+            else if (jsonSchema) {
+                outputType = schemaToType(jsonSchema, components);
+            }
+            operations.push({
+                name: operationName(path, rawMethod),
+                method: rawMethod.toUpperCase(),
+                path,
+                queryType,
+                bodyType,
+                outputType,
+                isStream,
+            });
+        }
+    }
+    return operations;
+}
+export function generateRouteMap(input) {
+    const spec = input;
+    const operations = collectOperations(spec);
+    const lines = [];
+    lines.push('// Generated by bunderstack codegen from /api/openapi.json.');
+    lines.push('// Regenerate with `bun run gen`; do not edit by hand.');
+    lines.push('');
+    lines.push('/** One API operation: literals describe the wire, phantoms the shapes. */');
+    lines.push('export interface Op<');
+    lines.push('  M extends string,');
+    lines.push('  P extends string,');
+    lines.push('  Query = undefined,');
+    lines.push('  Body = undefined,');
+    lines.push('  Output = void,');
+    lines.push('  Stream extends boolean = false,');
+    lines.push('> {');
+    lines.push('  method: M');
+    lines.push('  path: P');
+    lines.push('  stream: Stream');
+    lines.push('  query?: Query');
+    lines.push('  body?: Body');
+    lines.push('  output?: Output');
+    lines.push('}');
+    lines.push('');
+    lines.push('export type ApiRoutes = {');
+    const runtimeEntries = [];
+    for (const operation of operations) {
+        const generics = [
+            `'${operation.method}'`,
+            `'${operation.path}'`,
+            operation.queryType ?? 'undefined',
+            operation.bodyType ?? 'undefined',
+            operation.isStream ? operation.outputType : operation.outputType,
+            String(operation.isStream),
+        ].join(', ');
+        lines.push(`  ${operation.name}: Op<${generics}>`);
+        runtimeEntries.push(`  ${operation.name}: { method: '${operation.method}', path: '${operation.path}'${operation.isStream ? ', stream: true' : ''} },`);
+    }
+    lines.push('}');
+    lines.push('');
+    lines.push('/** Wire descriptors for createRestClient — same keys, runtime values. */');
+    lines.push('export const routes = {');
+    lines.push(...runtimeEntries);
+    lines.push('} as const');
+    return lines.join('\n');
+}
+//# sourceMappingURL=codegen.js.map