workerstack 0.1.0-beta.0

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { OPERATION_ID_HEADER, type CallOptions, type Fetch } from './rpc-client'\n\nexport type RouteOperation<\n  TMethod extends string,\n  TPath extends string,\n  TQuery = undefined,\n  TBody = undefined,\n  TOutput = undefined,\n  TStream extends boolean = false,\n> = {\n  method: TMethod\n  path: TPath\n  query?: TQuery\n  body?: TBody\n  output?: TOutput\n  stream?: TStream\n}\n\ntype AnyOperation = {\n  method: string\n  path: string\n  query?: unknown\n  body?: unknown\n  output?: unknown\n  stream?: boolean\n}\n\ntype QueryOf<O extends AnyOperation> = NonNullable<O['query']>\ntype BodyOf<O extends AnyOperation> = NonNullable<O['body']>\ntype OutputOf<O extends AnyOperation> = NonNullable<O['output']>\n\nexport type RouteCallOptions = CallOptions\n\ntype PathParamNames<TPath extends string> =\n  TPath extends `${string}{${infer TParam}}${infer TRest}`\n    ? TParam extends `+${infer TName}`\n      ? TName | PathParamNames<TRest>\n      : TParam | PathParamNames<TRest>\n    : never\n\ntype PathArgs<O extends AnyOperation> = [PathParamNames<O['path']>] extends [\n  never,\n]\n  ? object\n  : { params: Record<PathParamNames<O['path']>, string> }\n\ntype QueryArgs<O extends AnyOperation> = [O['query']] extends [undefined]\n  ? object\n  : { query?: QueryOf<O> }\n\ntype BodyArgs<O extends AnyOperation> = [O['body']] extends [undefined]\n  ? object\n  : { body: BodyOf<O> }\n\ntype CallArgs<O extends AnyOperation> = PathArgs<O> & QueryArgs<O> & BodyArgs<O>\n\ntype HasRequiredArgs<O extends AnyOperation> = [\n  PathParamNames<O['path']>,\n] extends [never]\n  ? [O['body']] extends [undefined]\n    ? false\n    : true\n  : true\n\nexport type RouteMethod<O extends AnyOperation> = (\n  ...args: true extends HasRequiredArgs<O>\n    ? [args: CallArgs<O>, options?: RouteCallOptions]\n    : [args?: CallArgs<O>, options?: RouteCallOptions]\n) => true extends O['stream']\n  ? AsyncIterable<OutputOf<O>>\n  : Promise<OutputOf<O>>\n\nexport type ClientOf<TRoutes> = {\n  [K in keyof TRoutes]: TRoutes[K] extends AnyOperation\n    ? RouteMethod<TRoutes[K]>\n    : never\n}\n\nexport type RestClientOptions = {\n  baseUrl?: string\n  fetch?: Fetch\n}\n\ntype RouteDescriptor = { method: string; path: string; stream?: boolean }\n\nfunction joinUrl(baseUrl: string | undefined, path: string): string {\n  if (!baseUrl) return path\n  return `${baseUrl.replace(/\\/$/, '')}/${path.replace(/^\\//, '')}`\n}\n\nfunction fillPath(\n  path: string,\n  params: Record<string, string> | undefined,\n): string {\n  return path.replace(/\\{(\\+?)([^}]+)\\}/g, (_, catchAll, name: string) => {\n    const value = params?.[name]\n    if (value === undefined) throw new Error(`Missing path parameter: ${name}`)\n    if (catchAll) return value.split('/').map(encodeURIComponent).join('/')\n    return encodeURIComponent(value)\n  })\n}\n\nfunction buildUrl(\n  baseUrl: string | undefined,\n  path: string,\n  query: Record<string, unknown> | undefined,\n): string {\n  const url = joinUrl(baseUrl, path)\n  if (!query) return url\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) continue\n    params.set(key, typeof value === 'string' ? value : JSON.stringify(value))\n  }\n  return params.size ? `${url}?${params}` : url\n}\n\nasync function requestJson(\n  fetcher: Fetch,\n  url: string,\n  init: RequestInit,\n): Promise<unknown> {\n  const response = await fetcher(url, init)\n  if (!response.ok)\n    throw new Error(`${response.status} ${await response.text()}`)\n  if (response.status === 204) return undefined\n  return response.json()\n}\n\nasync function* streamJsonEvents(\n  fetcher: Fetch,\n  url: string,\n  init: RequestInit,\n): AsyncGenerator<unknown> {\n  const response = await fetcher(url, init)\n  if (!response.ok || !response.body) {\n    throw new Error(`Stream request failed (${response.status})`)\n  }\n  const reader = response.body.pipeThrough(new TextDecoderStream()).getReader()\n  let buffer = ''\n  let data: string[] = []\n  const flush = () => {\n    if (!data.length) return undefined\n    const value = JSON.parse(data.join('\\n')) as unknown\n    data = []\n    return value\n  }\n  try {\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n      buffer += value\n      let newline = buffer.indexOf('\\n')\n      while (newline !== -1) {\n        const line = buffer.slice(0, newline).replace(/\\r$/, '')\n        buffer = buffer.slice(newline + 1)\n        if (line === '') {\n          const event = flush()\n          if (event !== undefined) yield event\n        } else if (line.startsWith('data:')) {\n          data.push(line.slice(5).replace(/^ /, ''))\n        }\n        newline = buffer.indexOf('\\n')\n      }\n    }\n    const event = flush()\n    if (event !== undefined) yield event\n  } finally {\n    await reader.cancel().catch(() => {})\n  }\n}\n\nexport function createRestClient<TRoutes>(\n  routes: Record<string, RouteDescriptor>,\n  options: RestClientOptions = {},\n): ClientOf<TRoutes> {\n  const fetcher = options.fetch ?? globalThis.fetch\n  const client: Record<string, unknown> = {}\n  for (const [name, route] of Object.entries(routes)) {\n    client[name] = (\n      args: {\n        params?: Record<string, string>\n        query?: Record<string, unknown>\n        body?: unknown\n      } = {},\n      callOptions: RouteCallOptions = {},\n    ) => {\n      const path = fillPath(route.path, args.params)\n      const url = buildUrl(options.baseUrl, path, args.query)\n      const headers = new Headers(callOptions.headers)\n      if (callOptions.operationId)\n        headers.set(OPERATION_ID_HEADER, callOptions.operationId)\n      if (route.stream) {\n        headers.set('accept', 'text/event-stream')\n        return streamJsonEvents(fetcher, url, {\n          method: route.method,\n          signal: callOptions.signal,\n          headers,\n        })\n      }\n      if (args.body !== undefined)\n        headers.set('content-type', 'application/json')\n      return requestJson(fetcher, url, {\n        method: route.method,\n        signal: callOptions.signal,\n        headers,\n        ...(args.body === undefined ? {} : { body: JSON.stringify(args.body) }),\n      })\n    }\n  }\n  return client as ClientOf<TRoutes>\n}\n"]}

package/dist/client/index.d.ts

@@ -0,0 +1,4 @@
+export { createClient, createRpcClient, OPERATION_ID_HEADER, type AnyWorkerstackApp, type WorkerstackClient, type CallOptions, type ClientOptions, type ClientCarrier, type DirectClient, type Fetch, type InferApiRouter, type RpcClient, } from './rpc-client.js';
+export { createLiveView, type LiveView, type LiveViewFrame, type LiveViewOptions, type LiveViewSnapshot, type LiveViewStatus, type MutationMethod, } from './live-view.js';
+export { DEFAULT_KEEPALIVE_MS, DEFAULT_LIVENESS_FACTOR, isRealtimeHeartbeat, openRealtimeStream, type RealtimeAction, type RealtimeChange, type RealtimeClock, type RealtimeEvent, type RealtimeHeartbeat, type RealtimeProcedure, type RealtimeStreamOptions, type RealtimeSyncHandle, } from './realtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA"}

package/dist/client/index.js

@@ -0,0 +1,4 @@
+export { createClient, createRpcClient, OPERATION_ID_HEADER, } from './rpc-client.js';
+export { createLiveView, } from './live-view.js';
+export { DEFAULT_KEEPALIVE_MS, DEFAULT_LIVENESS_FACTOR, isRealtimeHeartbeat, openRealtimeStream, } from './realtime.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,GAUpB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,GAOf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,GASnB,MAAM,YAAY,CAAA","sourcesContent":["export {\n  createClient,\n  createRpcClient,\n  OPERATION_ID_HEADER,\n  type AnyWorkerstackApp,\n  type WorkerstackClient,\n  type CallOptions,\n  type ClientOptions,\n  type ClientCarrier,\n  type DirectClient,\n  type Fetch,\n  type InferApiRouter,\n  type RpcClient,\n} from './rpc-client'\nexport {\n  createLiveView,\n  type LiveView,\n  type LiveViewFrame,\n  type LiveViewOptions,\n  type LiveViewSnapshot,\n  type LiveViewStatus,\n  type MutationMethod,\n} from './live-view'\nexport {\n  DEFAULT_KEEPALIVE_MS,\n  DEFAULT_LIVENESS_FACTOR,\n  isRealtimeHeartbeat,\n  openRealtimeStream,\n  type RealtimeAction,\n  type RealtimeChange,\n  type RealtimeClock,\n  type RealtimeEvent,\n  type RealtimeHeartbeat,\n  type RealtimeProcedure,\n  type RealtimeStreamOptions,\n  type RealtimeSyncHandle,\n} from './realtime'\n"]}

package/dist/client/live-view.d.ts

@@ -0,0 +1,49 @@
+import type { CallOptions } from './rpc-client.js';
+export type LiveViewFrame<T> = {
+    type: 'snapshot';
+    items: T[];
+    operationId?: string;
+} | {
+    type: 'upsert';
+    record: T;
+    afterId?: string | null;
+    operationId?: string;
+} | {
+    type: 'remove';
+    id: string;
+    operationId?: string;
+} | {
+    type: 'heartbeat';
+    intervalMs?: number;
+};
+export type LiveViewStatus = 'connecting' | 'ready' | 'reconnecting' | 'error' | 'closed';
+export type LiveViewSnapshot<T> = {
+    readonly items: readonly T[];
+    readonly status: LiveViewStatus;
+    readonly error: unknown;
+};
+export type LiveViewOptions<T> = {
+    subscribe: (options: {
+        signal: AbortSignal;
+    }) => AsyncIterable<LiveViewFrame<T>> | Promise<AsyncIterable<LiveViewFrame<T>>>;
+    getKey?: (record: T) => string;
+    createOperationId?: () => string;
+    retryMs?: number;
+    /** Reconnect after this multiple of the server heartbeat interval is silent. */
+    livenessFactor?: number;
+    /** Maximum wait after HTTP success for the matching live frame. */
+    ackTimeoutMs?: number;
+};
+export type MutationMethod<TArgs, TResult> = (args: TArgs, options: CallOptions & {
+    operationId: string;
+}) => Promise<TResult>;
+export type LiveView<T> = {
+    getSnapshot(): LiveViewSnapshot<T>;
+    subscribe(listener: () => void): () => void;
+    mutate<TArgs, TResult>(method: MutationMethod<TArgs, TResult>, args: TArgs, options?: Omit<CallOptions, 'operationId'>): Promise<TResult>;
+    resync(): void;
+    close(): void;
+    readonly done: Promise<void>;
+};
+export declare function createLiveView<T>(options: LiveViewOptions<T>): LiveView<T>;
+//# sourceMappingURL=live-view.d.ts.map

package/dist/client/live-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-view.d.ts","sourceRoot":"","sources":["../../src/client/live-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,MAAM,EAAE,CAAC,CAAA;IACT,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9C,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,OAAO,GACP,cAAc,GACd,OAAO,GACP,QAAQ,CAAA;AAEZ,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,SAAS,EAAE,CAAC,OAAO,EAAE;QACnB,MAAM,EAAE,WAAW,CAAA;KACpB,KACG,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,IAAI,CAC3C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,WAAW,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,KAC3C,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,WAAW,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAClC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAC3C,MAAM,CAAC,KAAK,EAAE,OAAO,EACnB,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EACtC,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,MAAM,IAAI,IAAI,CAAA;IACd,KAAK,IAAI,IAAI,CAAA;IACb,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CAAA;AAQD,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAqL1E"}

package/dist/client/live-view.js

@@ -0,0 +1,184 @@
+export function createLiveView(options) {
+    const controller = new AbortController();
+    const listeners = new Set();
+    const waiters = new Map();
+    const getKey = options.getKey ?? ((record) => String(record.id));
+    let current;
+    let forceReconnect = false;
+    let hasSnapshot = false;
+    let snapshot = {
+        items: [],
+        status: 'connecting',
+        error: undefined,
+    };
+    const publish = (next) => {
+        snapshot = next;
+        for (const listener of listeners)
+            listener();
+    };
+    const apply = (frame) => {
+        if (frame.type !== 'heartbeat') {
+            let items;
+            if (frame.type === 'snapshot') {
+                hasSnapshot = true;
+                items = [...frame.items];
+            }
+            else if (frame.type === 'remove') {
+                items = snapshot.items.filter((record) => getKey(record) !== String(frame.id));
+            }
+            else {
+                const key = getKey(frame.record);
+                const index = snapshot.items.findIndex((record) => getKey(record) === key);
+                const next = snapshot.items.filter((record) => getKey(record) !== key);
+                if (frame.afterId === undefined) {
+                    if (index === -1)
+                        next.push(frame.record);
+                    else
+                        next.splice(index, 0, frame.record);
+                }
+                else {
+                    const anchor = frame.afterId === null
+                        ? -1
+                        : next.findIndex((record) => getKey(record) === String(frame.afterId));
+                    const placement = frame.afterId !== null && anchor === -1 ? next.length : anchor + 1;
+                    next.splice(placement, 0, frame.record);
+                }
+                items = next;
+            }
+            publish({ items, status: 'ready', error: undefined });
+            if (frame.type === 'snapshot') {
+                // A fresh snapshot is authoritative. Once the write request succeeded,
+                // it safely settles operations whose matching event was lost while the
+                // live connection was down.
+                for (const [operationId, waiter] of waiters) {
+                    if (!waiter.httpSucceeded)
+                        continue;
+                    waiter.resolve();
+                    waiters.delete(operationId);
+                }
+            }
+        }
+        if ('operationId' in frame && frame.operationId) {
+            waiters.get(frame.operationId)?.resolve();
+            waiters.delete(frame.operationId);
+        }
+    };
+    const done = (async () => {
+        let attempt = 0;
+        while (!controller.signal.aborted) {
+            current = new AbortController();
+            const signal = AbortSignal.any([controller.signal, current.signal]);
+            let heartbeatIntervalMs;
+            let livenessTimer;
+            const armLivenessTimer = () => {
+                if (livenessTimer)
+                    clearTimeout(livenessTimer);
+                if (!heartbeatIntervalMs)
+                    return;
+                livenessTimer = setTimeout(() => current?.abort(), heartbeatIntervalMs * (options.livenessFactor ?? 2.5));
+            };
+            try {
+                const frames = await options.subscribe({ signal });
+                for await (const frame of frames) {
+                    if (signal.aborted)
+                        break;
+                    attempt = 0;
+                    apply(frame);
+                    if (frame.type === 'heartbeat' && frame.intervalMs) {
+                        heartbeatIntervalMs = frame.intervalMs;
+                    }
+                    armLivenessTimer();
+                }
+                if (!signal.aborted)
+                    throw new Error('Live view closed');
+            }
+            catch (error) {
+                if (controller.signal.aborted)
+                    break;
+                publish({
+                    ...snapshot,
+                    status: hasSnapshot ? 'reconnecting' : 'error',
+                    error: hasSnapshot ? undefined : error,
+                });
+            }
+            finally {
+                if (livenessTimer)
+                    clearTimeout(livenessTimer);
+            }
+            if (!controller.signal.aborted) {
+                const delayMs = forceReconnect
+                    ? 0
+                    : Math.min(30_000, (options.retryMs ?? 1_000) * 2 ** attempt++);
+                forceReconnect = false;
+                if (delayMs > 0) {
+                    await new Promise((resolve) => {
+                        const timer = setTimeout(done, delayMs);
+                        function done() {
+                            clearTimeout(timer);
+                            controller.signal.removeEventListener('abort', done);
+                            resolve();
+                        }
+                        controller.signal.addEventListener('abort', done, { once: true });
+                    });
+                }
+            }
+        }
+        if (controller.signal.aborted) {
+            publish({ ...snapshot, status: 'closed' });
+        }
+    })();
+    return {
+        getSnapshot: () => snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        async mutate(method, args, callOptions = {}) {
+            const operationId = options.createOperationId?.() ?? crypto.randomUUID();
+            let waiter;
+            const acknowledged = new Promise((resolve, reject) => {
+                waiter = { httpSucceeded: false, resolve, reject };
+            });
+            // The HTTP request may fail before this promise is awaited. Attaching a
+            // handler now prevents that rejection from surfacing as unhandled.
+            void acknowledged.catch(() => { });
+            waiters.set(operationId, waiter);
+            let timer;
+            try {
+                const result = await method(args, { ...callOptions, operationId });
+                waiter.httpSucceeded = true;
+                const timedOut = new Promise((_resolve, reject) => {
+                    timer = setTimeout(() => {
+                        const error = new Error(`Operation ${operationId} acknowledgement timed out`);
+                        waiters.delete(operationId);
+                        reject(error);
+                    }, options.ackTimeoutMs ?? 30_000);
+                });
+                await Promise.race([acknowledged, timedOut]);
+                return result;
+            }
+            catch (error) {
+                waiters.delete(operationId);
+                waiter.reject(error);
+                throw error;
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+            }
+        },
+        resync() {
+            forceReconnect = true;
+            current?.abort();
+        },
+        close() {
+            controller.abort();
+            const error = new DOMException('Live view closed', 'AbortError');
+            for (const waiter of waiters.values())
+                waiter.reject(error);
+            waiters.clear();
+        },
+        done,
+    };
+}
+//# sourceMappingURL=live-view.js.map

package/dist/client/live-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-view.js","sourceRoot":"","sources":["../../src/client/live-view.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CallOptions } from './rpc-client'\n\nexport type LiveViewFrame<T> =\n  | { type: 'snapshot'; items: T[]; operationId?: string }\n  | {\n      type: 'upsert'\n      record: T\n      afterId?: string | null\n      operationId?: string\n    }\n  | { type: 'remove'; id: string; operationId?: string }\n  | { type: 'heartbeat'; intervalMs?: number }\n\nexport type LiveViewStatus =\n  | 'connecting'\n  | 'ready'\n  | 'reconnecting'\n  | 'error'\n  | 'closed'\n\nexport type LiveViewSnapshot<T> = {\n  readonly items: readonly T[]\n  readonly status: LiveViewStatus\n  readonly error: unknown\n}\n\nexport type LiveViewOptions<T> = {\n  subscribe: (options: {\n    signal: AbortSignal\n  }) =>\n    | AsyncIterable<LiveViewFrame<T>>\n    | Promise<AsyncIterable<LiveViewFrame<T>>>\n  getKey?: (record: T) => string\n  createOperationId?: () => string\n  retryMs?: number\n  /** Reconnect after this multiple of the server heartbeat interval is silent. */\n  livenessFactor?: number\n  /** Maximum wait after HTTP success for the matching live frame. */\n  ackTimeoutMs?: number\n}\n\nexport type MutationMethod<TArgs, TResult> = (\n  args: TArgs,\n  options: CallOptions & { operationId: string },\n) => Promise<TResult>\n\nexport type LiveView<T> = {\n  getSnapshot(): LiveViewSnapshot<T>\n  subscribe(listener: () => void): () => void\n  mutate<TArgs, TResult>(\n    method: MutationMethod<TArgs, TResult>,\n    args: TArgs,\n    options?: Omit<CallOptions, 'operationId'>,\n  ): Promise<TResult>\n  resync(): void\n  close(): void\n  readonly done: Promise<void>\n}\n\ntype Waiter = {\n  httpSucceeded: boolean\n  resolve: () => void\n  reject: (error: unknown) => void\n}\n\nexport function createLiveView<T>(options: LiveViewOptions<T>): LiveView<T> {\n  const controller = new AbortController()\n  const listeners = new Set<() => void>()\n  const waiters = new Map<string, Waiter>()\n  const getKey =\n    options.getKey ?? ((record: T) => String((record as { id: unknown }).id))\n  let current: AbortController | undefined\n  let forceReconnect = false\n  let hasSnapshot = false\n  let snapshot: LiveViewSnapshot<T> = {\n    items: [],\n    status: 'connecting',\n    error: undefined,\n  }\n\n  const publish = (next: LiveViewSnapshot<T>) => {\n    snapshot = next\n    for (const listener of listeners) listener()\n  }\n\n  const apply = (frame: LiveViewFrame<T>) => {\n    if (frame.type !== 'heartbeat') {\n      let items: readonly T[]\n      if (frame.type === 'snapshot') {\n        hasSnapshot = true\n        items = [...frame.items]\n      } else if (frame.type === 'remove') {\n        items = snapshot.items.filter(\n          (record) => getKey(record) !== String(frame.id),\n        )\n      } else {\n        const key = getKey(frame.record)\n        const index = snapshot.items.findIndex(\n          (record) => getKey(record) === key,\n        )\n        const next = snapshot.items.filter((record) => getKey(record) !== key)\n        if (frame.afterId === undefined) {\n          if (index === -1) next.push(frame.record)\n          else next.splice(index, 0, frame.record)\n        } else {\n          const anchor =\n            frame.afterId === null\n              ? -1\n              : next.findIndex(\n                  (record) => getKey(record) === String(frame.afterId),\n                )\n          const placement =\n            frame.afterId !== null && anchor === -1 ? next.length : anchor + 1\n          next.splice(placement, 0, frame.record)\n        }\n        items = next\n      }\n      publish({ items, status: 'ready', error: undefined })\n      if (frame.type === 'snapshot') {\n        // A fresh snapshot is authoritative. Once the write request succeeded,\n        // it safely settles operations whose matching event was lost while the\n        // live connection was down.\n        for (const [operationId, waiter] of waiters) {\n          if (!waiter.httpSucceeded) continue\n          waiter.resolve()\n          waiters.delete(operationId)\n        }\n      }\n    }\n    if ('operationId' in frame && frame.operationId) {\n      waiters.get(frame.operationId)?.resolve()\n      waiters.delete(frame.operationId)\n    }\n  }\n\n  const done = (async () => {\n    let attempt = 0\n    while (!controller.signal.aborted) {\n      current = new AbortController()\n      const signal = AbortSignal.any([controller.signal, current.signal])\n      let heartbeatIntervalMs: number | undefined\n      let livenessTimer: ReturnType<typeof setTimeout> | undefined\n      const armLivenessTimer = () => {\n        if (livenessTimer) clearTimeout(livenessTimer)\n        if (!heartbeatIntervalMs) return\n        livenessTimer = setTimeout(\n          () => current?.abort(),\n          heartbeatIntervalMs * (options.livenessFactor ?? 2.5),\n        )\n      }\n      try {\n        const frames = await options.subscribe({ signal })\n        for await (const frame of frames) {\n          if (signal.aborted) break\n          attempt = 0\n          apply(frame)\n          if (frame.type === 'heartbeat' && frame.intervalMs) {\n            heartbeatIntervalMs = frame.intervalMs\n          }\n          armLivenessTimer()\n        }\n        if (!signal.aborted) throw new Error('Live view closed')\n      } catch (error) {\n        if (controller.signal.aborted) break\n        publish({\n          ...snapshot,\n          status: hasSnapshot ? 'reconnecting' : 'error',\n          error: hasSnapshot ? undefined : error,\n        })\n      } finally {\n        if (livenessTimer) clearTimeout(livenessTimer)\n      }\n      if (!controller.signal.aborted) {\n        const delayMs = forceReconnect\n          ? 0\n          : Math.min(30_000, (options.retryMs ?? 1_000) * 2 ** attempt++)\n        forceReconnect = false\n        if (delayMs > 0) {\n          await new Promise<void>((resolve) => {\n            const timer = setTimeout(done, delayMs)\n            function done() {\n              clearTimeout(timer)\n              controller.signal.removeEventListener('abort', done)\n              resolve()\n            }\n            controller.signal.addEventListener('abort', done, { once: true })\n          })\n        }\n      }\n    }\n    if (controller.signal.aborted) {\n      publish({ ...snapshot, status: 'closed' })\n    }\n  })()\n\n  return {\n    getSnapshot: () => snapshot,\n    subscribe(listener) {\n      listeners.add(listener)\n      return () => listeners.delete(listener)\n    },\n    async mutate(method, args, callOptions = {}) {\n      const operationId = options.createOperationId?.() ?? crypto.randomUUID()\n      let waiter!: Waiter\n      const acknowledged = new Promise<void>((resolve, reject) => {\n        waiter = { httpSucceeded: false, resolve, reject }\n      })\n      // The HTTP request may fail before this promise is awaited. Attaching a\n      // handler now prevents that rejection from surfacing as unhandled.\n      void acknowledged.catch(() => {})\n      waiters.set(operationId, waiter)\n      let timer: ReturnType<typeof setTimeout> | undefined\n      try {\n        const result = await method(args, { ...callOptions, operationId })\n        waiter.httpSucceeded = true\n        const timedOut = new Promise<never>((_resolve, reject) => {\n          timer = setTimeout(() => {\n            const error = new Error(\n              `Operation ${operationId} acknowledgement timed out`,\n            )\n            waiters.delete(operationId)\n            reject(error)\n          }, options.ackTimeoutMs ?? 30_000)\n        })\n        await Promise.race([acknowledged, timedOut])\n        return result\n      } catch (error) {\n        waiters.delete(operationId)\n        waiter.reject(error)\n        throw error\n      } finally {\n        if (timer) clearTimeout(timer)\n      }\n    },\n    resync() {\n      forceReconnect = true\n      current?.abort()\n    },\n    close() {\n      controller.abort()\n      const error = new DOMException('Live view closed', 'AbortError')\n      for (const waiter of waiters.values()) waiter.reject(error)\n      waiters.clear()\n    },\n    done,\n  }\n}\n"]}

package/dist/client/react.d.ts

@@ -0,0 +1,4 @@
+import type { LiveView, LiveViewSnapshot } from './live-view.js';
+/** React owns scheduling; the shared LiveView remains an external store. */
+export declare function useLiveView<T>(view: LiveView<T>): LiveViewSnapshot<T>;
+//# sourceMappingURL=react.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/client/react.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7D,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAMrE"}

package/dist/client/react.js

@@ -0,0 +1,6 @@
+import { useSyncExternalStore } from 'react';
+/** React owns scheduling; the shared LiveView remains an external store. */
+export function useLiveView(view) {
+    return useSyncExternalStore(view.subscribe, view.getSnapshot, view.getSnapshot);
+}
+//# sourceMappingURL=react.js.map

package/dist/client/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/client/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAI5C,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAI,IAAiB;IAC9C,OAAO,oBAAoB,CACzB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,WAAW,CACjB,CAAA;AACH,CAAC","sourcesContent":["import { useSyncExternalStore } from 'react'\n\nimport type { LiveView, LiveViewSnapshot } from './live-view'\n\n/** React owns scheduling; the shared LiveView remains an external store. */\nexport function useLiveView<T>(view: LiveView<T>): LiveViewSnapshot<T> {\n  return useSyncExternalStore(\n    view.subscribe,\n    view.getSnapshot,\n    view.getSnapshot,\n  )\n}\n"]}

package/dist/client/realtime.d.ts

@@ -0,0 +1,54 @@
+export type RealtimeAction = 'create' | 'update' | 'delete';
+export type RealtimeChange = {
+    table: string;
+    action: RealtimeAction;
+    record: Record<string, unknown>;
+    operationId?: string;
+};
+export type RealtimeHeartbeat = {
+    type: 'heartbeat';
+    intervalMs?: number;
+};
+export type RealtimeEvent = RealtimeChange | RealtimeHeartbeat;
+export type RealtimeProcedure = {
+    call(input: {
+        tables: string[];
+    }, options?: {
+        signal?: AbortSignal;
+        lastEventId?: string;
+    }): Promise<AsyncIterable<RealtimeEvent>>;
+};
+export type RealtimeSyncHandle = {
+    close(): void;
+    done: Promise<void>;
+};
+export type RealtimeClock = {
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+};
+export declare const DEFAULT_KEEPALIVE_MS = 5000;
+export declare const DEFAULT_LIVENESS_FACTOR = 2.5;
+export type RealtimeStreamOptions = {
+    subscribe: (options: {
+        signal: AbortSignal;
+        lastEventId?: string;
+    }) => Promise<AsyncIterable<RealtimeEvent>>;
+    onChange: (change: RealtimeChange) => void;
+    onReconnect: () => void | Promise<void>;
+    onError?: (error: unknown) => void;
+    onRetry?: (retry: {
+        attempt: number;
+        delayMs: number;
+    }) => void;
+    signal: AbortSignal;
+    retryMs?: number;
+    maxRetryMs?: number;
+    livenessFactor?: number;
+    defaultKeepaliveMs?: number;
+    clock?: RealtimeClock;
+    random?: () => number;
+};
+export declare function isRealtimeHeartbeat(event: RealtimeEvent): event is RealtimeHeartbeat;
+/** Shared reconnecting transport used by LiveView, Query, and DB adapters. */
+export declare function openRealtimeStream(options: RealtimeStreamOptions): RealtimeSyncHandle;
+//# sourceMappingURL=realtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/client/realtime.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AACD,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC1E,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,iBAAiB,CAAA;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CACF,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAC3B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAA;CACzC,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,IAAI,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AACvE,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/C,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CACpC,CAAA;AACD,eAAO,MAAM,oBAAoB,OAAQ,CAAA;AACzC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAQ1C,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,CAAC,OAAO,EAAE;QACnB,MAAM,EAAE,WAAW,CAAA;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,KAAK,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;IAC1C,WAAW,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAC/D,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GACnB,KAAK,IAAI,iBAAiB,CAE5B;AAID,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,qBAAqB,GAC7B,kBAAkB,CAqFpB"}

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 = 'workerstack: 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 = 'workerstack: 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-workerstack-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 AnyWorkerstackApp = {
+    $inferClient?: ClientCarrier | undefined;
+};
+export type InferApiRouter<TApp extends AnyWorkerstackApp> = 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 WorkerstackClient<TApp extends AnyWorkerstackApp> = RpcClient<InferApiRouter<TApp>>;
+export declare function createRpcClient<TRouter extends AnyRouter>(options?: ClientOptions): RpcClient<TRouter>;
+export declare function createClient<TApp extends AnyWorkerstackApp>(options?: ClientOptions): WorkerstackClient<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"}