syncorejs 0.2.1 → 0.2.2

package/dist/_vendor/platform-web/worker.js

@@ -1,137 +1,6 @@
-import { generateId } from "../core/index.mjs";
+import { SyncoreBridgeClient, attachRuntimeBridge } from "../core/index.mjs";
 //#region src/worker.ts
-var SyncoreWebWorkerClient = class {
-	pendingRequests = /* @__PURE__ */ new Map();
-	watchRecordsByKey = /* @__PURE__ */ new Map();
-	watchKeyBySubscriptionId = /* @__PURE__ */ new Map();
-	disposed = false;
-	handleMessage = (event) => {
-		const message = event.data;
-		if (!message || typeof message !== "object" || !("type" in message)) return;
-		switch (message.type) {
-			case "runtime.ready": return;
-			case "runtime.error":
-				this.rejectAllPending(new Error(message.error));
-				return;
-			case "invoke.result": {
-				const pending = this.pendingRequests.get(message.requestId);
-				if (!pending) return;
-				this.pendingRequests.delete(message.requestId);
-				if (message.success) pending.resolve(message.value);
-				else pending.reject(new Error(message.error));
-				return;
-			}
-			case "watch.update": {
-				const watchKey = this.watchKeyBySubscriptionId.get(message.subscriptionId);
-				if (!watchKey) return;
-				const watchRecord = this.watchRecordsByKey.get(watchKey);
-				if (!watchRecord) return;
-				if (message.success) {
-					watchRecord.result = message.value;
-					watchRecord.error = void 0;
-				} else watchRecord.error = new Error(message.error);
-				for (const listener of watchRecord.listeners) listener();
-			}
-		}
-	};
-	constructor(endpoint) {
-		this.endpoint = endpoint;
-		this.endpoint.addEventListener("message", this.handleMessage);
-	}
-	query(reference, ...args) {
-		return this.invoke("query", reference, normalizeOptionalArgs(args));
-	}
-	mutation(reference, ...args) {
-		return this.invoke("mutation", reference, normalizeOptionalArgs(args));
-	}
-	action(reference, ...args) {
-		return this.invoke("action", reference, normalizeOptionalArgs(args));
-	}
-	watchQuery(reference, ...args) {
-		this.ensureNotDisposed();
-		const normalizedArgs = normalizeOptionalArgs(args);
-		const watchKey = createWatchKey(reference, normalizedArgs);
-		let watchRecord = this.watchRecordsByKey.get(watchKey);
-		if (!watchRecord) {
-			watchRecord = {
-				subscriptionId: generateId(),
-				listeners: /* @__PURE__ */ new Set(),
-				consumers: 0,
-				result: void 0,
-				error: void 0
-			};
-			this.watchRecordsByKey.set(watchKey, watchRecord);
-			this.watchKeyBySubscriptionId.set(watchRecord.subscriptionId, watchKey);
-			this.endpoint.postMessage({
-				type: "watch.subscribe",
-				subscriptionId: watchRecord.subscriptionId,
-				reference,
-				args: normalizedArgs
-			});
-		}
-		watchRecord.consumers += 1;
-		let disposed = false;
-		const ownedListeners = /* @__PURE__ */ new Set();
-		return {
-			onUpdate: (callback) => {
-				watchRecord.listeners.add(callback);
-				ownedListeners.add(callback);
-				queueMicrotask(callback);
-				return () => {
-					watchRecord.listeners.delete(callback);
-					ownedListeners.delete(callback);
-				};
-			},
-			localQueryResult: () => watchRecord.result,
-			localQueryError: () => watchRecord.error,
-			dispose: () => {
-				if (disposed) return;
-				disposed = true;
-				for (const callback of ownedListeners) watchRecord.listeners.delete(callback);
-				ownedListeners.clear();
-				watchRecord.consumers = Math.max(0, watchRecord.consumers - 1);
-				if (watchRecord.consumers > 0) return;
-				this.endpoint.postMessage({
-					type: "watch.unsubscribe",
-					subscriptionId: watchRecord.subscriptionId
-				});
-				this.watchKeyBySubscriptionId.delete(watchRecord.subscriptionId);
-				this.watchRecordsByKey.delete(watchKey);
-			}
-		};
-	}
-	dispose() {
-		if (this.disposed) return;
-		this.disposed = true;
-		this.endpoint.removeEventListener("message", this.handleMessage);
-		for (const watchRecord of this.watchRecordsByKey.values()) this.endpoint.postMessage({
-			type: "watch.unsubscribe",
-			subscriptionId: watchRecord.subscriptionId
-		});
-		this.watchKeyBySubscriptionId.clear();
-		this.watchRecordsByKey.clear();
-		this.rejectAllPending(/* @__PURE__ */ new Error("Syncore worker client was disposed."));
-	}
-	invoke(kind, reference, args) {
-		this.ensureNotDisposed();
-		const requestId = generateId();
-		const promise = new Promise((resolve, reject) => {
-			this.pendingRequests.set(requestId, {
-				resolve,
-				reject
-			});
-		});
-		this.endpoint.postMessage(createInvokeRequest(requestId, kind, reference, args));
-		return promise;
-	}
-	rejectAllPending(error) {
-		for (const pending of this.pendingRequests.values()) pending.reject(error);
-		this.pendingRequests.clear();
-	}
-	ensureNotDisposed() {
-		if (this.disposed) throw new Error("Syncore worker client was disposed.");
-	}
-};
+var SyncoreWebWorkerClient = class extends SyncoreBridgeClient {};
 /**
 * Create a web worker Syncore client from a low-level message endpoint.
 */
@@ -166,140 +35,7 @@ function createSyncoreWebWorkerClient(options) {
 * Attach a Syncore runtime implementation to a worker message endpoint.
 */
 function attachWebWorkerRuntime(options) {
-	const subscriptions = /* @__PURE__ */ new Map();
-	const runtimePromise = Promise.resolve(options.createRuntime()).then(async (runtime) => {
-		await runtime.start();
-		return runtime;
-	});
-	const clientPromise = runtimePromise.then((runtime) => runtime.createClient());
-	const ready = clientPromise.then(() => {
-		options.endpoint.postMessage({ type: "runtime.ready" });
-	}).catch((error) => {
-		options.endpoint.postMessage({
-			type: "runtime.error",
-			error: error instanceof Error ? error.message : String(error)
-		});
-		throw error;
-	});
-	const handleMessage = (event) => {
-		(async () => {
-			const message = event.data;
-			if (!message || typeof message !== "object" || !("type" in message)) return;
-			try {
-				const client = await clientPromise;
-				switch (message.type) {
-					case "invoke": {
-						const value = message.kind === "query" ? await client.query(message.reference, message.args) : message.kind === "mutation" ? await client.mutation(message.reference, message.args) : await client.action(message.reference, message.args);
-						options.endpoint.postMessage({
-							type: "invoke.result",
-							requestId: message.requestId,
-							success: true,
-							value
-						});
-						return;
-					}
-					case "watch.subscribe": {
-						if (subscriptions.has(message.subscriptionId)) return;
-						const watch = client.watchQuery(message.reference, message.args);
-						const sendCurrentState = () => {
-							const error = watch.localQueryError();
-							if (error) {
-								options.endpoint.postMessage({
-									type: "watch.update",
-									subscriptionId: message.subscriptionId,
-									success: false,
-									error: error.message
-								});
-								return;
-							}
-							options.endpoint.postMessage({
-								type: "watch.update",
-								subscriptionId: message.subscriptionId,
-								success: true,
-								value: watch.localQueryResult()
-							});
-						};
-						const unsubscribe = watch.onUpdate(sendCurrentState);
-						subscriptions.set(message.subscriptionId, {
-							watch,
-							unsubscribe
-						});
-						sendCurrentState();
-						return;
-					}
-					case "watch.unsubscribe": {
-						const subscription = subscriptions.get(message.subscriptionId);
-						if (!subscription) return;
-						subscription.unsubscribe();
-						subscriptions.delete(message.subscriptionId);
-					}
-				}
-			} catch (error) {
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				if (message.type === "invoke") options.endpoint.postMessage({
-					type: "invoke.result",
-					requestId: message.requestId,
-					success: false,
-					error: errorMessage
-				});
-				if (message.type === "watch.subscribe") options.endpoint.postMessage({
-					type: "watch.update",
-					subscriptionId: message.subscriptionId,
-					success: false,
-					error: errorMessage
-				});
-			}
-		})();
-	};
-	options.endpoint.addEventListener("message", handleMessage);
-	return {
-		ready,
-		async dispose() {
-			options.endpoint.removeEventListener("message", handleMessage);
-			for (const subscription of subscriptions.values()) subscription.unsubscribe();
-			subscriptions.clear();
-			await (await runtimePromise).stop();
-		}
-	};
-}
-function createWatchKey(reference, args) {
-	return `${reference.name}:${stableStringify(args)}`;
-}
-function createInvokeRequest(requestId, kind, reference, args) {
-	switch (kind) {
-		case "query": return {
-			type: "invoke",
-			requestId,
-			kind,
-			reference,
-			args
-		};
-		case "mutation": return {
-			type: "invoke",
-			requestId,
-			kind,
-			reference,
-			args
-		};
-		case "action": return {
-			type: "invoke",
-			requestId,
-			kind,
-			reference,
-			args
-		};
-	}
-}
-function stableStringify(value) {
-	return JSON.stringify(sortValue(value));
-}
-function sortValue(value) {
-	if (Array.isArray(value)) return value.map(sortValue);
-	if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortValue(nested)]));
-	return value;
-}
-function normalizeOptionalArgs(args) {
-	return args[0] ?? {};
+	return attachRuntimeBridge(options);
 }
 //#endregion
 export { SyncoreWebWorkerClient, attachWebWorkerRuntime, createManagedWebWorkerClient, createSyncoreWebWorkerClient, createWebWorkerClient };

package/dist/_vendor/platform-web/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import {\n  generateId,\n  type AnySyncoreSchema,\n  type FunctionReference,\n  type JsonObject,\n  type SyncoreClient,\n  type SyncoreRuntime,\n  type SyncoreWatch\n} from \"@syncore/core\";\nexport type WebWorkerSyncoreSchema = AnySyncoreSchema;\n\nexport interface SyncoreWorkerMessageEndpoint {\n  postMessage(message: unknown): void;\n  addEventListener(\n    type: \"message\",\n    listener: (event: MessageEvent<unknown>) => void\n  ): void;\n  removeEventListener(\n    type: \"message\",\n    listener: (event: MessageEvent<unknown>) => void\n  ): void;\n}\n\ntype SyncoreWorkerRequest =\n  | {\n      type: \"invoke\";\n      requestId: string;\n      kind: \"query\";\n      reference: FunctionReference<\"query\", unknown, unknown>;\n      args: JsonObject;\n    }\n  | {\n      type: \"invoke\";\n      requestId: string;\n      kind: \"mutation\";\n      reference: FunctionReference<\"mutation\", unknown, unknown>;\n      args: JsonObject;\n    }\n  | {\n      type: \"invoke\";\n      requestId: string;\n      kind: \"action\";\n      reference: FunctionReference<\"action\", unknown, unknown>;\n      args: JsonObject;\n    }\n  | {\n      type: \"watch.subscribe\";\n      subscriptionId: string;\n      reference: FunctionReference<\"query\", unknown, unknown>;\n      args: JsonObject;\n    }\n  | {\n      type: \"watch.unsubscribe\";\n      subscriptionId: string;\n    };\n\ntype SyncoreWorkerResponse =\n  | {\n      type: \"runtime.ready\";\n    }\n  | {\n      type: \"runtime.error\";\n      error: string;\n    }\n  | {\n      type: \"invoke.result\";\n      requestId: string;\n      success: true;\n      value: unknown;\n    }\n  | {\n      type: \"invoke.result\";\n      requestId: string;\n      success: false;\n      error: string;\n    }\n  | {\n      type: \"watch.update\";\n      subscriptionId: string;\n      success: true;\n      value: unknown;\n    }\n  | {\n      type: \"watch.update\";\n      subscriptionId: string;\n      success: false;\n      error: string;\n    };\n\ninterface PendingRequest {\n  resolve(value: unknown): void;\n  reject(error: Error): void;\n}\n\ninterface WatchRecord {\n  subscriptionId: string;\n  listeners: Set<() => void>;\n  consumers: number;\n  result: unknown;\n  error: Error | undefined;\n}\n\nexport type WorkerQueryWatch<TValue> = SyncoreWatch<TValue> & {\n  dispose(): void;\n};\n\ntype OptionalArgsTuple<TArgs> =\n  Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];\n\nexport class SyncoreWebWorkerClient implements SyncoreClient {\n  private readonly pendingRequests = new Map<string, PendingRequest>();\n  private readonly watchRecordsByKey = new Map<string, WatchRecord>();\n  private readonly watchKeyBySubscriptionId = new Map<string, string>();\n  private disposed = false;\n\n  private readonly handleMessage = (event: MessageEvent<unknown>) => {\n    const message = event.data as SyncoreWorkerResponse;\n    if (!message || typeof message !== \"object\" || !(\"type\" in message)) {\n      return;\n    }\n\n    switch (message.type) {\n      case \"runtime.ready\":\n        return;\n      case \"runtime.error\":\n        this.rejectAllPending(new Error(message.error));\n        return;\n      case \"invoke.result\": {\n        const pending = this.pendingRequests.get(message.requestId);\n        if (!pending) {\n          return;\n        }\n        this.pendingRequests.delete(message.requestId);\n        if (message.success) {\n          pending.resolve(message.value);\n        } else {\n          pending.reject(new Error(message.error));\n        }\n        return;\n      }\n      case \"watch.update\": {\n        const watchKey = this.watchKeyBySubscriptionId.get(\n          message.subscriptionId\n        );\n        if (!watchKey) {\n          return;\n        }\n        const watchRecord = this.watchRecordsByKey.get(watchKey);\n        if (!watchRecord) {\n          return;\n        }\n        if (message.success) {\n          watchRecord.result = message.value;\n          watchRecord.error = undefined;\n        } else {\n          watchRecord.error = new Error(message.error);\n        }\n        for (const listener of watchRecord.listeners) {\n          listener();\n        }\n      }\n    }\n  };\n\n  constructor(private readonly endpoint: SyncoreWorkerMessageEndpoint) {\n    this.endpoint.addEventListener(\"message\", this.handleMessage);\n  }\n\n  query<TArgs, TResult>(\n    reference: FunctionReference<\"query\", TArgs, TResult>,\n    ...args: OptionalArgsTuple<TArgs>\n  ): Promise<TResult> {\n    return this.invoke(\n      \"query\",\n      reference,\n      normalizeOptionalArgs(args) as JsonObject\n    );\n  }\n\n  mutation<TArgs, TResult>(\n    reference: FunctionReference<\"mutation\", TArgs, TResult>,\n    ...args: OptionalArgsTuple<TArgs>\n  ): Promise<TResult> {\n    return this.invoke(\n      \"mutation\",\n      reference,\n      normalizeOptionalArgs(args) as JsonObject\n    );\n  }\n\n  action<TArgs, TResult>(\n    reference: FunctionReference<\"action\", TArgs, TResult>,\n    ...args: OptionalArgsTuple<TArgs>\n  ): Promise<TResult> {\n    return this.invoke(\n      \"action\",\n      reference,\n      normalizeOptionalArgs(args) as JsonObject\n    );\n  }\n\n  watchQuery<TArgs, TResult>(\n    reference: FunctionReference<\"query\", TArgs, TResult>,\n    ...args: OptionalArgsTuple<TArgs>\n  ): WorkerQueryWatch<TResult> {\n    this.ensureNotDisposed();\n    const normalizedArgs = normalizeOptionalArgs(args) as JsonObject;\n    const watchKey = createWatchKey(reference, normalizedArgs);\n    let watchRecord = this.watchRecordsByKey.get(watchKey);\n    if (!watchRecord) {\n      watchRecord = {\n        subscriptionId: generateId(),\n        listeners: new Set<() => void>(),\n        consumers: 0,\n        result: undefined,\n        error: undefined\n      };\n      this.watchRecordsByKey.set(watchKey, watchRecord);\n      this.watchKeyBySubscriptionId.set(watchRecord.subscriptionId, watchKey);\n      this.endpoint.postMessage({\n        type: \"watch.subscribe\",\n        subscriptionId: watchRecord.subscriptionId,\n        reference,\n        args: normalizedArgs\n      } satisfies SyncoreWorkerRequest);\n    }\n\n    watchRecord.consumers += 1;\n    let disposed = false;\n    const ownedListeners = new Set<() => void>();\n\n    return {\n      onUpdate: (callback) => {\n        watchRecord.listeners.add(callback);\n        ownedListeners.add(callback);\n        queueMicrotask(callback);\n        return () => {\n          watchRecord.listeners.delete(callback);\n          ownedListeners.delete(callback);\n        };\n      },\n      localQueryResult: () => watchRecord.result as TResult | undefined,\n      localQueryError: () => watchRecord.error,\n      dispose: () => {\n        if (disposed) {\n          return;\n        }\n        disposed = true;\n        for (const callback of ownedListeners) {\n          watchRecord.listeners.delete(callback);\n        }\n        ownedListeners.clear();\n        watchRecord.consumers = Math.max(0, watchRecord.consumers - 1);\n        if (watchRecord.consumers > 0) {\n          return;\n        }\n        this.endpoint.postMessage({\n          type: \"watch.unsubscribe\",\n          subscriptionId: watchRecord.subscriptionId\n        } satisfies SyncoreWorkerRequest);\n        this.watchKeyBySubscriptionId.delete(watchRecord.subscriptionId);\n        this.watchRecordsByKey.delete(watchKey);\n      }\n    };\n  }\n\n  dispose(): void {\n    if (this.disposed) {\n      return;\n    }\n    this.disposed = true;\n    this.endpoint.removeEventListener(\"message\", this.handleMessage);\n    for (const watchRecord of this.watchRecordsByKey.values()) {\n      this.endpoint.postMessage({\n        type: \"watch.unsubscribe\",\n        subscriptionId: watchRecord.subscriptionId\n      } satisfies SyncoreWorkerRequest);\n    }\n    this.watchKeyBySubscriptionId.clear();\n    this.watchRecordsByKey.clear();\n    this.rejectAllPending(new Error(\"Syncore worker client was disposed.\"));\n  }\n\n  private invoke<TArgs, TResult>(\n    kind: \"query\",\n    reference: FunctionReference<\"query\", TArgs, TResult>,\n    args: JsonObject\n  ): Promise<TResult>;\n  private invoke<TArgs, TResult>(\n    kind: \"mutation\",\n    reference: FunctionReference<\"mutation\", TArgs, TResult>,\n    args: JsonObject\n  ): Promise<TResult>;\n  private invoke<TArgs, TResult>(\n    kind: \"action\",\n    reference: FunctionReference<\"action\", TArgs, TResult>,\n    args: JsonObject\n  ): Promise<TResult>;\n  private invoke<TArgs, TResult>(\n    kind: \"query\" | \"mutation\" | \"action\",\n    reference: FunctionReference<\n      \"query\" | \"mutation\" | \"action\",\n      TArgs,\n      TResult\n    >,\n    args: JsonObject\n  ): Promise<TResult> {\n    this.ensureNotDisposed();\n    const requestId = generateId();\n    const promise = new Promise<TResult>((resolve, reject) => {\n      this.pendingRequests.set(requestId, { resolve, reject });\n    });\n\n    this.endpoint.postMessage(\n      createInvokeRequest(requestId, kind, reference, args)\n    );\n\n    return promise;\n  }\n\n  private rejectAllPending(error: Error): void {\n    for (const pending of this.pendingRequests.values()) {\n      pending.reject(error);\n    }\n    this.pendingRequests.clear();\n  }\n\n  private ensureNotDisposed(): void {\n    if (this.disposed) {\n      throw new Error(\"Syncore worker client was disposed.\");\n    }\n  }\n}\n\nexport interface AttachWebWorkerRuntimeOptions {\n  endpoint: SyncoreWorkerMessageEndpoint;\n  createRuntime:\n    | (() => Promise<SyncoreRuntime<WebWorkerSyncoreSchema>>)\n    | (() => SyncoreRuntime<WebWorkerSyncoreSchema>);\n}\n\nexport interface AttachedWebWorkerRuntime {\n  ready: Promise<void>;\n  dispose(): Promise<void>;\n}\n\n/**\n * A worker-backed browser client plus the Worker instance it owns.\n */\nexport interface ManagedWebWorkerClient {\n  client: SyncoreWebWorkerClient;\n  worker: Worker;\n  dispose(): void;\n}\n\n/**\n * Options for creating a worker-backed Syncore client in the browser.\n */\nexport interface CreateWebWorkerClientProviderOptions {\n  /** The worker module URL passed to `new Worker(...)`. */\n  workerUrl: URL | string;\n\n  /** Optional worker type, defaults to `module`. */\n  workerType?: WorkerOptions[\"type\"];\n\n  /** Optional name shown in browser devtools. */\n  workerName?: string;\n}\n\n/**\n * Create a web worker Syncore client from a low-level message endpoint.\n */\nexport function createWebWorkerClient(\n  endpoint: SyncoreWorkerMessageEndpoint\n): SyncoreWebWorkerClient {\n  return new SyncoreWebWorkerClient(endpoint);\n}\n\n/**\n * Create and manage both a browser Worker and the Syncore client that talks to it.\n */\nexport function createManagedWebWorkerClient(options: {\n  createWorker: () => Worker;\n}): ManagedWebWorkerClient {\n  const worker = options.createWorker();\n  const client = createWebWorkerClient(worker);\n  return {\n    client,\n    worker,\n    dispose() {\n      client.dispose();\n      worker.terminate();\n    }\n  };\n}\n\n/**\n * Create a worker-backed Syncore client using the standard Worker constructor.\n */\nexport function createSyncoreWebWorkerClient(\n  options: CreateWebWorkerClientProviderOptions\n): ManagedWebWorkerClient {\n  return createManagedWebWorkerClient({\n    createWorker: () =>\n      new Worker(options.workerUrl, {\n        type: options.workerType ?? \"module\",\n        ...(options.workerName ? { name: options.workerName } : {})\n      })\n  });\n}\n\n/**\n * Attach a Syncore runtime implementation to a worker message endpoint.\n */\nexport function attachWebWorkerRuntime(\n  options: AttachWebWorkerRuntimeOptions\n): AttachedWebWorkerRuntime {\n  const subscriptions = new Map<\n    string,\n    {\n      watch: SyncoreWatch<unknown>;\n      unsubscribe: () => void;\n    }\n  >();\n\n  const runtimePromise = Promise.resolve(options.createRuntime()).then(\n    async (runtime) => {\n      await runtime.start();\n      return runtime;\n    }\n  );\n\n  const clientPromise = runtimePromise.then((runtime) =>\n    runtime.createClient()\n  );\n\n  const ready = clientPromise\n    .then(() => {\n      options.endpoint.postMessage({\n        type: \"runtime.ready\"\n      } satisfies SyncoreWorkerResponse);\n    })\n    .catch((error) => {\n      options.endpoint.postMessage({\n        type: \"runtime.error\",\n        error: error instanceof Error ? error.message : String(error)\n      } satisfies SyncoreWorkerResponse);\n      throw error;\n    });\n\n  const handleMessage = (event: MessageEvent<unknown>) => {\n    void (async () => {\n      const message = event.data as SyncoreWorkerRequest;\n      if (!message || typeof message !== \"object\" || !(\"type\" in message)) {\n        return;\n      }\n\n      try {\n        const client = await clientPromise;\n        switch (message.type) {\n          case \"invoke\": {\n            const value =\n              message.kind === \"query\"\n                ? await client.query(message.reference, message.args)\n                : message.kind === \"mutation\"\n                  ? await client.mutation(message.reference, message.args)\n                  : await client.action(message.reference, message.args);\n            options.endpoint.postMessage({\n              type: \"invoke.result\",\n              requestId: message.requestId,\n              success: true,\n              value\n            } satisfies SyncoreWorkerResponse);\n            return;\n          }\n          case \"watch.subscribe\": {\n            if (subscriptions.has(message.subscriptionId)) {\n              return;\n            }\n            const watch = client.watchQuery(message.reference, message.args);\n            const sendCurrentState = () => {\n              const error = watch.localQueryError();\n              if (error) {\n                options.endpoint.postMessage({\n                  type: \"watch.update\",\n                  subscriptionId: message.subscriptionId,\n                  success: false,\n                  error: error.message\n                } satisfies SyncoreWorkerResponse);\n                return;\n              }\n              options.endpoint.postMessage({\n                type: \"watch.update\",\n                subscriptionId: message.subscriptionId,\n                success: true,\n                value: watch.localQueryResult()\n              } satisfies SyncoreWorkerResponse);\n            };\n            const unsubscribe = watch.onUpdate(sendCurrentState);\n            subscriptions.set(message.subscriptionId, { watch, unsubscribe });\n            sendCurrentState();\n            return;\n          }\n          case \"watch.unsubscribe\": {\n            const subscription = subscriptions.get(message.subscriptionId);\n            if (!subscription) {\n              return;\n            }\n            subscription.unsubscribe();\n            subscriptions.delete(message.subscriptionId);\n          }\n        }\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error ? error.message : String(error);\n        if (message.type === \"invoke\") {\n          options.endpoint.postMessage({\n            type: \"invoke.result\",\n            requestId: message.requestId,\n            success: false,\n            error: errorMessage\n          } satisfies SyncoreWorkerResponse);\n        }\n        if (message.type === \"watch.subscribe\") {\n          options.endpoint.postMessage({\n            type: \"watch.update\",\n            subscriptionId: message.subscriptionId,\n            success: false,\n            error: errorMessage\n          } satisfies SyncoreWorkerResponse);\n        }\n      }\n    })();\n  };\n\n  options.endpoint.addEventListener(\"message\", handleMessage);\n\n  return {\n    ready,\n    async dispose() {\n      options.endpoint.removeEventListener(\"message\", handleMessage);\n      for (const subscription of subscriptions.values()) {\n        subscription.unsubscribe();\n      }\n      subscriptions.clear();\n      const runtime = await runtimePromise;\n      await runtime.stop();\n    }\n  };\n}\n\nfunction createWatchKey(\n  reference: FunctionReference<\"query\", unknown, unknown>,\n  args: JsonObject\n): string {\n  return `${reference.name}:${stableStringify(args)}`;\n}\n\nfunction createInvokeRequest(\n  requestId: string,\n  kind: \"query\" | \"mutation\" | \"action\",\n  reference:\n    | FunctionReference<\"query\", unknown, unknown>\n    | FunctionReference<\"mutation\", unknown, unknown>\n    | FunctionReference<\"action\", unknown, unknown>,\n  args: JsonObject\n): SyncoreWorkerRequest {\n  switch (kind) {\n    case \"query\":\n      return {\n        type: \"invoke\",\n        requestId,\n        kind,\n        reference: reference as FunctionReference<\"query\">,\n        args\n      };\n    case \"mutation\":\n      return {\n        type: \"invoke\",\n        requestId,\n        kind,\n        reference: reference as FunctionReference<\"mutation\">,\n        args\n      };\n    case \"action\":\n      return {\n        type: \"invoke\",\n        requestId,\n        kind,\n        reference: reference as FunctionReference<\"action\">,\n        args\n      };\n  }\n}\n\nfunction stableStringify(value: unknown): string {\n  return JSON.stringify(sortValue(value));\n}\n\nfunction sortValue(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(sortValue);\n  }\n  if (value && typeof value === \"object\") {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, nested]) => [key, sortValue(nested)])\n    );\n  }\n  return value;\n}\n\nfunction normalizeOptionalArgs<TArgs>(\n  args: [] | [TArgs] | readonly unknown[]\n): TArgs {\n  return (args[0] ?? {}) as TArgs;\n}\n"],"mappings":"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"}
+{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import {\n  attachRuntimeBridge,\n  type AttachRuntimeBridgeOptions,\n  type AttachedRuntimeBridge,\n  type BridgeQueryWatch,\n  SyncoreBridgeClient,\n  type SyncoreDataModel,\n  type SyncoreBridgeMessageEndpoint,\n} from \"@syncore/core\";\n\nexport type WebWorkerSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = TSchema;\nexport type SyncoreWorkerMessageEndpoint = SyncoreBridgeMessageEndpoint;\nexport type WorkerQueryWatch<TValue> = BridgeQueryWatch<TValue>;\n\nexport class SyncoreWebWorkerClient extends SyncoreBridgeClient {\n  declare query: SyncoreBridgeClient[\"query\"];\n  declare mutation: SyncoreBridgeClient[\"mutation\"];\n  declare action: SyncoreBridgeClient[\"action\"];\n  declare watchQuery: SyncoreBridgeClient[\"watchQuery\"];\n}\n\nexport type AttachWebWorkerRuntimeOptions<\n  TSchema extends WebWorkerSyncoreSchema = WebWorkerSyncoreSchema\n> = AttachRuntimeBridgeOptions<TSchema>;\nexport type AttachedWebWorkerRuntime = AttachedRuntimeBridge;\n\n/**\n * A worker-backed browser client plus the Worker instance it owns.\n */\nexport interface ManagedWebWorkerClient {\n  client: SyncoreWebWorkerClient;\n  worker: Worker;\n  dispose(): void;\n}\n\n/**\n * Options for creating a worker-backed Syncore client in the browser.\n */\nexport interface CreateWebWorkerClientProviderOptions {\n  /** The worker module URL passed to `new Worker(...)`. */\n  workerUrl: URL | string;\n\n  /** Optional worker type, defaults to `module`. */\n  workerType?: WorkerOptions[\"type\"];\n\n  /** Optional name shown in browser devtools. */\n  workerName?: string;\n}\n\n/**\n * Create a web worker Syncore client from a low-level message endpoint.\n */\nexport function createWebWorkerClient(\n  endpoint: SyncoreWorkerMessageEndpoint\n): SyncoreWebWorkerClient {\n  return new SyncoreWebWorkerClient(endpoint);\n}\n\n/**\n * Create and manage both a browser Worker and the Syncore client that talks to it.\n */\nexport function createManagedWebWorkerClient(options: {\n  createWorker: () => Worker;\n}): ManagedWebWorkerClient {\n  const worker = options.createWorker();\n  const client = createWebWorkerClient(worker);\n  return {\n    client,\n    worker,\n    dispose() {\n      client.dispose();\n      worker.terminate();\n    }\n  };\n}\n\n/**\n * Create a worker-backed Syncore client using the standard Worker constructor.\n */\nexport function createSyncoreWebWorkerClient(\n  options: CreateWebWorkerClientProviderOptions\n): ManagedWebWorkerClient {\n  return createManagedWebWorkerClient({\n    createWorker: () =>\n      new Worker(options.workerUrl, {\n        type: options.workerType ?? \"module\",\n        ...(options.workerName ? { name: options.workerName } : {})\n      })\n  });\n}\n\n/**\n * Attach a Syncore runtime implementation to a worker message endpoint.\n */\nexport function attachWebWorkerRuntime(\n  options: AttachWebWorkerRuntimeOptions\n): AttachedWebWorkerRuntime {\n  return attachRuntimeBridge(options);\n}\n"],"mappings":";;AAgBA,IAAa,yBAAb,cAA4C,oBAAoB;;;;AAsChE,SAAgB,sBACd,UACwB;AACxB,QAAO,IAAI,uBAAuB,SAAS;;;;;AAM7C,SAAgB,6BAA6B,SAElB;CACzB,MAAM,SAAS,QAAQ,cAAc;CACrC,MAAM,SAAS,sBAAsB,OAAO;AAC5C,QAAO;EACL;EACA;EACA,UAAU;AACR,UAAO,SAAS;AAChB,UAAO,WAAW;;EAErB;;;;;AAMH,SAAgB,6BACd,SACwB;AACxB,QAAO,6BAA6B,EAClC,oBACE,IAAI,OAAO,QAAQ,WAAW;EAC5B,MAAM,QAAQ,cAAc;EAC5B,GAAI,QAAQ,aAAa,EAAE,MAAM,QAAQ,YAAY,GAAG,EAAE;EAC3D,CAAC,EACL,CAAC;;;;;AAMJ,SAAgB,uBACd,SAC0B;AAC1B,QAAO,oBAAoB,QAAQ"}

package/dist/_vendor/react/index.d.ts

@@ -1,20 +1,32 @@
 import { ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { FunctionReference, SyncoreClient } from "../core/index.d.mts";
+import { FunctionArgs, FunctionReference, FunctionResult, PaginationOptions, PaginationResult, SyncoreClient, SyncoreQueryState, SyncoreRuntimeStatus, UsePaginatedQueryResult } from "../core/index.d.mts";
 
 //#region src/index.d.ts
 type OptionalArgsTuple<TArgs> = Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];
+type QueryRequestInput<TReference extends FunctionReference<"query"> = FunctionReference<"query">> = Record<never, never> extends FunctionArgs<TReference> ? {
+  query: TReference;
+  args?: FunctionArgs<TReference> | Skip;
+} : {
+  query: TReference;
+  args: FunctionArgs<TReference> | Skip;
+};
+type QueriesRequestInput = Record<string, QueryRequestInput>;
+type QueryStateForEntry<TEntry> = TEntry extends QueryRequestInput<infer TReference> ? SyncoreQueryState<FunctionResult<TReference>> : never;
+type UseQueriesResult<TEntries extends QueriesRequestInput> = { [TKey in keyof TEntries]: QueryStateForEntry<TEntries[TKey]> };
+type PaginatedQueryReference = FunctionReference<"query", Record<string, unknown>, PaginationResult<unknown>>;
+type PaginatedQueryArgs<TReference extends FunctionReference<"query">> = FunctionArgs<TReference> extends {
+  paginationOpts: PaginationOptions;
+} ? Omit<FunctionArgs<TReference>, "paginationOpts"> : never;
+type PaginatedQueryItem<TReference extends FunctionReference<"query">> = FunctionResult<TReference> extends PaginationResult<infer TItem> ? TItem : never;
 /**
- * Pass `"skip"` as the args argument to `useQuery` to suppress the subscription
- * entirely and return `undefined` without contacting the runtime.
+ * Pass `"skip"` as the args argument to `useQuery`, `useQueryState`,
+ * `useQueries`, or `usePaginatedQuery` to suppress the subscription entirely.
  */
 declare const skip: "skip";
 type Skip = typeof skip;
 /**
  * Provide a Syncore client to React descendants.
- *
- * Wrap your app with this component to use Syncore hooks like `useQuery` and
- * `useMutation`.
  */
 declare function SyncoreProvider({
   client,
@@ -25,18 +37,20 @@ declare function SyncoreProvider({
 }): react_jsx_runtime0.JSX.Element;
 /**
  * Read the active Syncore client from React context.
- *
- * Throws if used outside of {@link SyncoreProvider}.
  */
 declare function useSyncore(): SyncoreClient;
 /**
- * Load a reactive Syncore query within a React component.
- *
- * The hook subscribes automatically and re-renders whenever the local query
- * result changes. Pass `"skip"` as the second argument to suppress the
- * subscription entirely and return `undefined` without contacting the runtime.
+ * Subscribe to the active Syncore client's runtime lifecycle status.
+ */
+declare function useSyncoreStatus(): SyncoreRuntimeStatus;
+/**
+ * Load a reactive Syncore query and return only the data for the common case.
  */
 declare function useQuery<TArgs, TResult>(reference: FunctionReference<"query", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs> | [Skip]): TResult | undefined;
+/**
+ * Load a reactive Syncore query and keep the full local state.
+ */
+declare function useQueryState<TArgs, TResult>(reference: FunctionReference<"query", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs> | [Skip]): SyncoreQueryState<TResult>;
 /**
  * Construct a stable function that executes a Syncore mutation.
  */
@@ -46,13 +60,15 @@ declare function useMutation<TArgs, TResult>(reference: FunctionReference<"mutat
  */
 declare function useAction<TArgs, TResult>(reference: FunctionReference<"action", TArgs, TResult>): (...args: OptionalArgsTuple<TArgs>) => Promise<TResult>;
 /**
- * Load several Syncore queries at once using explicit keys.
+ * Load a keyed set of Syncore queries at once with per-entry state.
+ */
+declare function useQueries<TEntries extends QueriesRequestInput>(entries: TEntries): UseQueriesResult<TEntries>;
+/**
+ * Load a paginated Syncore query as a growing reactive list.
  */
-declare function useQueries<TResult>(entries: Array<{
-  key: string;
-  reference: FunctionReference<"query">;
-  args?: Record<string, unknown>;
-}>): Record<string, TResult | undefined>;
+declare function usePaginatedQuery<TReference extends PaginatedQueryReference>(reference: TReference, args: PaginatedQueryArgs<TReference> | Skip, options: {
+  initialNumItems: number;
+}): UsePaginatedQueryResult<PaginatedQueryItem<TReference>>;
 //#endregion
-export { SyncoreProvider, skip, useAction, useMutation, useQueries, useQuery, useSyncore };
+export { SyncoreProvider, UseQueriesResult, skip, useAction, useMutation, usePaginatedQuery, useQueries, useQuery, useQueryState, useSyncore, useSyncoreStatus };
 //# sourceMappingURL=index.d.ts.map

package/dist/_vendor/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;KAkBK,iBAAA,UACH,MAAA,uBAA6B,KAAA,IAAS,IAAA,GAAO,KAAA,KAAU,IAAA,EAAM,KAAA;;;AAPxC;;cAaV,IAAA;AAAA,KACR,IAAA,UAAc,IAAA;;;;;;;iBAUH,eAAA,CAAA;EACd,MAAA;EACA;AAAA;EAEA,MAAA,EAAQ,aAAA;EACR,QAAA,EAAU,SAAA;AAAA,IACX,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;AAjBD;iBA4BgB,UAAA,CAAA,GAAc,aAAA;;;;AA5BM;;;;iBA2CpB,QAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,UAA2B,KAAA,EAAO,OAAA,MAC1C,IAAA,EAAM,iBAAA,CAAkB,KAAA,KAAU,IAAA,IACpC,OAAA;AAnCH;;;AAAA,iBAgFgB,WAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,aAA8B,KAAA,EAAO,OAAA,QAC3C,IAAA,EAAM,iBAAA,CAAkB,KAAA,MAAW,OAAA,CAAQ,OAAA;;;;iBAQlC,SAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,WAA4B,KAAA,EAAO,OAAA,QACzC,IAAA,EAAM,iBAAA,CAAkB,KAAA,MAAW,OAAA,CAAQ,OAAA;;;;iBAQlC,UAAA,SAAA,CACd,OAAA,EAAS,KAAA;EACP,GAAA;EACA,SAAA,EAAW,iBAAA;EACX,IAAA,GAAO,MAAA;AAAA,KAER,MAAA,SAAe,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;KA0BK,iBAAA,UACH,MAAA,uBAA6B,KAAA,IAAS,IAAA,GAAO,KAAA,KAAU,IAAA,EAAM,KAAA;AAAA,KAE1D,iBAAA,oBACgB,iBAAA,YAA6B,iBAAA,aAC9C,MAAA,uBAA6B,YAAA,CAAa,UAAA;EAExC,KAAA,EAAO,UAAA;EACP,IAAA,GAAO,YAAA,CAAa,UAAA,IAAc,IAAA;AAAA;EAGlC,KAAA,EAAO,UAAA;EACP,IAAA,EAAM,YAAA,CAAa,UAAA,IAAc,IAAA;AAAA;AAAA,KAGlC,mBAAA,GAAsB,MAAA,SAAe,iBAAA;AAAA,KAErC,kBAAA,WAA6B,MAAA,SAAe,iBAAA,qBAG7C,iBAAA,CAAkB,cAAA,CAAe,UAAA;AAAA,KAGzB,gBAAA,kBAAkC,mBAAA,qBAC7B,QAAA,GAAW,kBAAA,CAAmB,QAAA,CAAS,IAAA;AAAA,KAGnD,uBAAA,GAA0B,iBAAA,UAE7B,MAAA,mBACA,gBAAA;AAAA,KAGG,kBAAA,oBAAsC,iBAAA,aACzC,YAAA,CAAa,UAAA;EAAsB,cAAA,EAAgB,iBAAA;AAAA,IAC/C,IAAA,CAAK,YAAA,CAAa,UAAA;AAAA,KAGnB,kBAAA,oBAAsC,iBAAA,aACzC,cAAA,CAAe,UAAA,UAAoB,gBAAA,gBAC/B,KAAA;;;;AAvC8D;cA2EvD,IAAA;AAAA,KACR,IAAA,UAAc,IAAA;;;;iBAYH,eAAA,CAAA;EACd,MAAA;EACA;AAAA;EAEA,MAAA,EAAQ,aAAA;EACR,QAAA,EAAU,SAAA;AAAA,IACX,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;iBASe,UAAA,CAAA,GAAc,aAAA;;;;iBAWd,gBAAA,CAAA,GAAoB,oBAAA;;;;iBA+BpB,QAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,UAA2B,KAAA,EAAO,OAAA,MAC1C,IAAA,EAAM,iBAAA,CAAkB,KAAA,KAAU,IAAA,IACpC,OAAA;;;;iBAWa,aAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,UAA2B,KAAA,EAAO,OAAA,MAC1C,IAAA,EAAM,iBAAA,CAAkB,KAAA,KAAU,IAAA,IACpC,iBAAA,CAAkB,OAAA;;;;iBAkCL,WAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,aAA8B,KAAA,EAAO,OAAA,QAC3C,IAAA,EAAM,iBAAA,CAAkB,KAAA,MAAW,OAAA,CAAQ,OAAA;;;;iBAQlC,SAAA,gBAAA,CACd,SAAA,EAAW,iBAAA,WAA4B,KAAA,EAAO,OAAA,QACzC,IAAA,EAAM,iBAAA,CAAkB,KAAA,MAAW,OAAA,CAAQ,OAAA;;;;iBAQlC,UAAA,kBAA4B,mBAAA,CAAA,CAC1C,OAAA,EAAS,QAAA,GACR,gBAAA,CAAiB,QAAA;AA/MuB;;;AAAA,iBAuQ3B,iBAAA,oBAAqC,uBAAA,CAAA,CACnD,SAAA,EAAW,UAAA,EACX,IAAA,EAAM,kBAAA,CAAmB,UAAA,IAAc,IAAA,EACvC,OAAA;EACE,eAAA;AAAA,IAED,uBAAA,CAAwB,kBAAA,CAAmB,UAAA"}