syncorejs 0.1.0

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

@@ -0,0 +1,307 @@
+import { generateId } 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.");
+	}
+};
+/**
+* Create a web worker Syncore client from a low-level message endpoint.
+*/
+function createWebWorkerClient(endpoint) {
+	return new SyncoreWebWorkerClient(endpoint);
+}
+/**
+* Create and manage both a browser Worker and the Syncore client that talks to it.
+*/
+function createManagedWebWorkerClient(options) {
+	const worker = options.createWorker();
+	const client = createWebWorkerClient(worker);
+	return {
+		client,
+		worker,
+		dispose() {
+			client.dispose();
+			worker.terminate();
+		}
+	};
+}
+/**
+* Create a worker-backed Syncore client using the standard Worker constructor.
+*/
+function createSyncoreWebWorkerClient(options) {
+	return createManagedWebWorkerClient({ createWorker: () => new Worker(options.workerUrl, {
+		type: options.workerType ?? "module",
+		...options.workerName ? { name: options.workerName } : {}
+	}) });
+}
+/**
+* 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] ?? {};
+}
+//#endregion
+export { SyncoreWebWorkerClient, attachWebWorkerRuntime, createManagedWebWorkerClient, createSyncoreWebWorkerClient, createWebWorkerClient };
+
+//# sourceMappingURL=worker.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,58 @@
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { FunctionReference, SyncoreClient } from "../core/index.d.mts";
+
+//#region src/index.d.ts
+type OptionalArgsTuple<TArgs> = Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];
+/**
+ * Pass `"skip"` as the args argument to `useQuery` to suppress the subscription
+ * entirely and return `undefined` without contacting the runtime.
+ */
+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,
+  children
+}: {
+  client: SyncoreClient;
+  children: ReactNode;
+}): 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.
+ */
+declare function useQuery<TArgs, TResult>(reference: FunctionReference<"query", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs> | [Skip]): TResult | undefined;
+/**
+ * Construct a stable function that executes a Syncore mutation.
+ */
+declare function useMutation<TArgs, TResult>(reference: FunctionReference<"mutation", TArgs, TResult>): (...args: OptionalArgsTuple<TArgs>) => Promise<TResult>;
+/**
+ * Construct a stable function that executes a Syncore action.
+ */
+declare function useAction<TArgs, TResult>(reference: FunctionReference<"action", TArgs, TResult>): (...args: OptionalArgsTuple<TArgs>) => Promise<TResult>;
+/**
+ * Load several Syncore queries at once using explicit keys.
+ */
+declare function useQueries<TResult>(entries: Array<{
+  key: string;
+  reference: FunctionReference<"query">;
+  args?: Record<string, unknown>;
+}>): Record<string, TResult | undefined>;
+//#endregion
+export { SyncoreProvider, skip, useAction, useMutation, useQueries, useQuery, useSyncore };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/_vendor/react/index.js

@@ -0,0 +1,151 @@
+import { createContext, useContext, useEffect, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/index.tsx
+/**
+* Pass `"skip"` as the args argument to `useQuery` to suppress the subscription
+* entirely and return `undefined` without contacting the runtime.
+*/
+const skip = "skip";
+const SyncoreContext = createContext(null);
+/**
+* Provide a Syncore client to React descendants.
+*
+* Wrap your app with this component to use Syncore hooks like `useQuery` and
+* `useMutation`.
+*/
+function SyncoreProvider({ client, children }) {
+	return /* @__PURE__ */ jsx(SyncoreContext.Provider, {
+		value: client,
+		children
+	});
+}
+/**
+* Read the active Syncore client from React context.
+*
+* Throws if used outside of {@link SyncoreProvider}.
+*/
+function useSyncore() {
+	const client = useContext(SyncoreContext);
+	if (!client) throw new Error("SyncoreProvider is missing from the React tree.");
+	return client;
+}
+/**
+* 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.
+*/
+function useQuery(reference, ...args) {
+	const isSkipped = args[0] === skip;
+	const watch = useManagedQueryWatch(useSyncore(), reference, isSkipped ? void 0 : normalizeOptionalArgs(args), isSkipped);
+	const [snapshot, setSnapshot] = useState(() => isSkipped ? noOpSnapshot : readWatchSnapshot(watch));
+	useEffect(() => {
+		if (isSkipped) {
+			setSnapshot(noOpSnapshot);
+			return;
+		}
+		const sync = () => {
+			setSnapshot(readWatchSnapshot(watch));
+		};
+		sync();
+		return watch.onUpdate(sync);
+	}, [watch, isSkipped]);
+	if (snapshot.error) throw snapshot.error;
+	return snapshot.result;
+}
+const noOpSnapshot = {
+	result: void 0,
+	error: void 0
+};
+const noOpWatch = {
+	onUpdate: () => () => {},
+	localQueryResult: () => void 0,
+	localQueryError: () => void 0
+};
+/**
+* Construct a stable function that executes a Syncore mutation.
+*/
+function useMutation(reference) {
+	const client = useSyncore();
+	return (...args) => client.mutation(reference, normalizeOptionalArgs(args));
+}
+/**
+* Construct a stable function that executes a Syncore action.
+*/
+function useAction(reference) {
+	const client = useSyncore();
+	return (...args) => client.action(reference, normalizeOptionalArgs(args));
+}
+/**
+* Load several Syncore queries at once using explicit keys.
+*/
+function useQueries(entries) {
+	const client = useSyncore();
+	const entriesKey = stableStringify(entries.map((entry) => ({
+		key: entry.key,
+		referenceName: entry.reference.name,
+		args: entry.args ?? {}
+	})));
+	const normalizedEntries = useMemo(() => JSON.parse(entriesKey), [entriesKey]);
+	const watches = useMemo(() => normalizedEntries.map((entry) => ({
+		key: entry.key,
+		watch: client.watchQuery({
+			kind: "query",
+			name: entry.referenceName
+		}, entry.args)
+	})), [client, normalizedEntries]);
+	const [snapshot, setSnapshot] = useState(() => readQueriesSnapshot(watches));
+	useEffect(() => () => {
+		for (const entry of watches) entry.watch.dispose?.();
+	}, [watches]);
+	useEffect(() => {
+		const sync = () => {
+			setSnapshot(readQueriesSnapshot(watches));
+		};
+		sync();
+		const cleanups = watches.map((entry) => entry.watch.onUpdate(sync));
+		return () => {
+			for (const cleanup of cleanups) cleanup();
+		};
+	}, [watches]);
+	return snapshot;
+}
+function useManagedQueryWatch(client, reference, args, isSkipped) {
+	const argsKey = isSkipped ? "skip" : stableStringify(args ?? {});
+	const normalizedArgs = useMemo(() => isSkipped ? void 0 : JSON.parse(argsKey), [argsKey, isSkipped]);
+	const watch = useMemo(() => isSkipped ? noOpWatch : client.watchQuery(reference, normalizedArgs), [
+		client,
+		normalizedArgs,
+		reference,
+		isSkipped
+	]);
+	useEffect(() => () => {
+		if (!isSkipped) watch.dispose?.();
+	}, [watch, isSkipped]);
+	return watch;
+}
+function normalizeOptionalArgs(args) {
+	return args[0] ?? {};
+}
+function readWatchSnapshot(watch) {
+	return {
+		result: watch.localQueryResult(),
+		error: watch.localQueryError()
+	};
+}
+function readQueriesSnapshot(watches) {
+	return Object.fromEntries(watches.map((entry) => [entry.key, entry.watch.localQueryResult()]));
+}
+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;
+}
+//#endregion
+export { SyncoreProvider, skip, useAction, useMutation, useQueries, useQuery, useSyncore };
+
+//# sourceMappingURL=index.js.map

package/dist/_vendor/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.tsx"],"sourcesContent":["import {\n  createContext,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useMemo,\n  useState\n} from \"react\";\nimport type {\n  FunctionReference,\n  SyncoreClient,\n  SyncoreWatch\n} from \"@syncore/core\";\n\ntype ManagedSyncoreWatch<TResult> = SyncoreWatch<TResult> & {\n  dispose?: () => void;\n};\n\ntype OptionalArgsTuple<TArgs> =\n  Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];\n\n/**\n * Pass `\"skip\"` as the args argument to `useQuery` to suppress the subscription\n * entirely and return `undefined` without contacting the runtime.\n */\nexport const skip = \"skip\" as const;\ntype Skip = typeof skip;\n\nconst SyncoreContext = createContext<SyncoreClient | null>(null);\n\n/**\n * Provide a Syncore client to React descendants.\n *\n * Wrap your app with this component to use Syncore hooks like `useQuery` and\n * `useMutation`.\n */\nexport function SyncoreProvider({\n  client,\n  children\n}: {\n  client: SyncoreClient;\n  children: ReactNode;\n}) {\n  return (\n    <SyncoreContext.Provider value={client}>{children}</SyncoreContext.Provider>\n  );\n}\n\n/**\n * Read the active Syncore client from React context.\n *\n * Throws if used outside of {@link SyncoreProvider}.\n */\nexport function useSyncore(): SyncoreClient {\n  const client = useContext(SyncoreContext);\n  if (!client) {\n    throw new Error(\"SyncoreProvider is missing from the React tree.\");\n  }\n  return client;\n}\n\n/**\n * Load a reactive Syncore query within a React component.\n *\n * The hook subscribes automatically and re-renders whenever the local query\n * result changes. Pass `\"skip\"` as the second argument to suppress the\n * subscription entirely and return `undefined` without contacting the runtime.\n */\nexport function useQuery<TArgs, TResult>(\n  reference: FunctionReference<\"query\", TArgs, TResult>,\n  ...args: OptionalArgsTuple<TArgs> | [Skip]\n): TResult | undefined {\n  const isSkipped = args[0] === skip;\n  const client = useSyncore();\n  const watch = useManagedQueryWatch(\n    client,\n    reference,\n    isSkipped\n      ? undefined\n      : normalizeOptionalArgs(args as OptionalArgsTuple<TArgs>),\n    isSkipped\n  );\n  const [snapshot, setSnapshot] = useState(() =>\n    isSkipped ? noOpSnapshot : readWatchSnapshot(watch)\n  );\n\n  useEffect(() => {\n    if (isSkipped) {\n      setSnapshot(noOpSnapshot);\n      return;\n    }\n    const sync = () => {\n      setSnapshot(readWatchSnapshot(watch));\n    };\n    sync();\n    return watch.onUpdate(sync);\n  }, [watch, isSkipped]);\n\n  if (snapshot.error) {\n    throw snapshot.error;\n  }\n\n  return snapshot.result;\n}\n\nconst noOpSnapshot = { result: undefined, error: undefined };\n\nconst noOpWatch: ManagedSyncoreWatch<never> = {\n  onUpdate: () => () => {},\n  localQueryResult: () => undefined,\n  localQueryError: () => undefined\n};\n\n/**\n * Construct a stable function that executes a Syncore mutation.\n */\nexport function useMutation<TArgs, TResult>(\n  reference: FunctionReference<\"mutation\", TArgs, TResult>\n): (...args: OptionalArgsTuple<TArgs>) => Promise<TResult> {\n  const client = useSyncore();\n  return (...args) => client.mutation(reference, normalizeOptionalArgs(args));\n}\n\n/**\n * Construct a stable function that executes a Syncore action.\n */\nexport function useAction<TArgs, TResult>(\n  reference: FunctionReference<\"action\", TArgs, TResult>\n): (...args: OptionalArgsTuple<TArgs>) => Promise<TResult> {\n  const client = useSyncore();\n  return (...args) => client.action(reference, normalizeOptionalArgs(args));\n}\n\n/**\n * Load several Syncore queries at once using explicit keys.\n */\nexport function useQueries<TResult>(\n  entries: Array<{\n    key: string;\n    reference: FunctionReference<\"query\">;\n    args?: Record<string, unknown>;\n  }>\n): Record<string, TResult | undefined> {\n  const client = useSyncore();\n  const entriesKey = stableStringify(\n    entries.map((entry) => ({\n      key: entry.key,\n      referenceName: entry.reference.name,\n      args: entry.args ?? {}\n    }))\n  );\n  const normalizedEntries = useMemo(\n    () =>\n      JSON.parse(entriesKey) as Array<{\n        key: string;\n        referenceName: string;\n        args: Record<string, unknown>;\n      }>,\n    [entriesKey]\n  );\n  const watches = useMemo(\n    () =>\n      normalizedEntries.map((entry) => ({\n        key: entry.key,\n        watch: client.watchQuery(\n          { kind: \"query\", name: entry.referenceName },\n          entry.args\n        ) as ManagedSyncoreWatch<TResult>\n      })),\n    [client, normalizedEntries]\n  );\n  const [snapshot, setSnapshot] = useState(() => readQueriesSnapshot(watches));\n\n  useEffect(\n    () => () => {\n      for (const entry of watches) {\n        entry.watch.dispose?.();\n      }\n    },\n    [watches]\n  );\n\n  useEffect(() => {\n    const sync = () => {\n      setSnapshot(readQueriesSnapshot(watches));\n    };\n    sync();\n    const cleanups = watches.map((entry) => entry.watch.onUpdate(sync));\n    return () => {\n      for (const cleanup of cleanups) {\n        cleanup();\n      }\n    };\n  }, [watches]);\n\n  return snapshot;\n}\n\nfunction useManagedQueryWatch<TArgs, TResult>(\n  client: SyncoreClient,\n  reference: FunctionReference<\"query\", TArgs, TResult>,\n  args?: TArgs,\n  isSkipped?: boolean\n): ManagedSyncoreWatch<TResult> {\n  const argsKey = isSkipped ? \"skip\" : stableStringify(args ?? {});\n  const normalizedArgs = useMemo(\n    () => (isSkipped ? undefined : (JSON.parse(argsKey) as TArgs)),\n    [argsKey, isSkipped]\n  );\n  const watch = useMemo<ManagedSyncoreWatch<TResult>>(\n    () =>\n      isSkipped\n        ? noOpWatch\n        : (client.watchQuery(\n            reference,\n            normalizedArgs!\n          ) as ManagedSyncoreWatch<TResult>),\n    [client, normalizedArgs, reference, isSkipped]\n  );\n\n  useEffect(\n    () => () => {\n      if (!isSkipped) watch.dispose?.();\n    },\n    [watch, isSkipped]\n  );\n\n  return watch;\n}\n\nfunction normalizeOptionalArgs<TArgs>(\n  args: [] | [TArgs] | readonly unknown[]\n): TArgs {\n  return (args[0] ?? {}) as TArgs;\n}\n\nfunction readWatchSnapshot<TResult>(watch: SyncoreWatch<TResult>): {\n  result: TResult | undefined;\n  error: Error | undefined;\n} {\n  return {\n    result: watch.localQueryResult(),\n    error: watch.localQueryError()\n  };\n}\n\nfunction readQueriesSnapshot<TResult>(\n  watches: Array<{\n    key: string;\n    watch: ManagedSyncoreWatch<TResult>;\n  }>\n): Record<string, TResult | undefined> {\n  return Object.fromEntries(\n    watches.map((entry) => [entry.key, entry.watch.localQueryResult()])\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"],"mappings":"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"}