syncorejs 0.1.0

package/dist/platform-node/src/index.d.ts

@@ -0,0 +1,145 @@
+import { SyncoreDevtoolsEvent, SyncoreDevtoolsSnapshot } from "../../devtools-protocol/src/index.js";
+import { AnySyncoreSchema, DevtoolsSink, SchedulerOptions, StorageObject, StorageWriteInput, SyncoreCapabilities, SyncoreClient, SyncoreExperimentalPlugin, SyncoreRuntime, SyncoreRuntimeOptions, SyncoreSqlDriver, SyncoreStorageAdapter } from "../../core/src/runtime/runtime.js";
+import { DevtoolsRequestHandler } from "../../core/src/runtime/devtools.js";
+import { AttachNodeIpcRuntimeOptions, AttachedNodeIpcRuntime, NodeIpcSyncoreSchema, RendererQueryWatch, SyncoreIpcMessageEndpoint, SyncoreMainProcessBridge, SyncoreRendererBridge, SyncoreRendererClient, SyncoreWindowBridge, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge } from "./ipc.js";
+
+//#region ../platform-node/src/index.d.ts
+type NodeSyncoreSchema = AnySyncoreSchema;
+declare class NodeSqliteDriver implements SyncoreSqlDriver {
+  private readonly database;
+  private transactionDepth;
+  constructor(filename: string);
+  exec(sql: string): Promise<void>;
+  run(sql: string, params?: unknown[]): Promise<{
+    changes: number;
+    lastInsertRowid?: number | string;
+  }>;
+  get<T>(sql: string, params?: unknown[]): Promise<T | undefined>;
+  all<T>(sql: string, params?: unknown[]): Promise<T[]>;
+  withTransaction<T>(callback: () => Promise<T>): Promise<T>;
+  withSavepoint<T>(name: string, callback: () => Promise<T>): Promise<T>;
+  close(): Promise<void>;
+}
+declare class NodeFileStorageAdapter implements SyncoreStorageAdapter {
+  private readonly directory;
+  constructor(directory: string);
+  private filePath;
+  put(id: string, input: StorageWriteInput): Promise<StorageObject>;
+  get(id: string): Promise<StorageObject | null>;
+  read(id: string): Promise<Uint8Array | null>;
+  delete(id: string): Promise<void>;
+  list(): Promise<StorageObject[]>;
+}
+interface CreateNodeRuntimeOptions {
+  databasePath: string;
+  storageDirectory: string;
+  schema: NodeSyncoreSchema;
+  functions: SyncoreRuntimeOptions<NodeSyncoreSchema>["functions"];
+  capabilities?: SyncoreCapabilities;
+  experimentalPlugins?: Array<SyncoreExperimentalPlugin<NodeSyncoreSchema>>;
+  appName?: string;
+  origin?: string;
+  sessionLabel?: string;
+  platform?: string;
+  devtools?: DevtoolsSink | false;
+  devtoolsUrl?: string;
+  scheduler?: SchedulerOptions;
+}
+/**
+ * Options for creating a managed Node Syncore client.
+ */
+type WithNodeSyncoreClientOptions = CreateNodeRuntimeOptions;
+/**
+ * A started local Node runtime paired with its client and a dispose helper.
+ */
+interface ManagedNodeSyncoreClient {
+  runtime: SyncoreRuntime<NodeSyncoreSchema>;
+  client: ReturnType<SyncoreRuntime<NodeSyncoreSchema>["createClient"]>;
+  dispose(): Promise<void>;
+}
+interface SyncoreElectronIpcBinding {
+  ready: Promise<void>;
+  dispose(): Promise<void>;
+}
+interface SyncoreElectronBridgeWindow {
+  isDestroyed(): boolean;
+  webContents: {
+    send(channel: string, message: unknown): void;
+  };
+}
+interface CreateElectronSyncoreBridgeOptions {
+  window: SyncoreElectronBridgeWindow;
+  onRendererMessage(listener: (message: unknown) => void): () => void;
+  channel?: string;
+}
+/**
+ * The subset of Electron's `ipcMain` used by Syncore's main-process helper.
+ */
+interface SyncoreElectronIpcMain {
+  on(channel: string, listener: (event: unknown, message: unknown) => void): void;
+  off(channel: string, listener: (event: unknown, message: unknown) => void): void;
+}
+interface CreateSyncoreRendererWindowClientOptions {
+  bridgeName?: string;
+}
+/**
+ * Create a Node or Electron runtime backed by SQLite and local file storage.
+ */
+declare function createNodeSyncoreRuntime(options: CreateNodeRuntimeOptions): SyncoreRuntime<NodeSyncoreSchema>;
+/**
+ * Create a same-process Syncore client from a started Node runtime.
+ */
+declare function createNodeSyncoreClient(runtime: SyncoreRuntime<NodeSyncoreSchema>): SyncoreClient;
+/**
+ * Start a Node Syncore runtime and return its client together with a dispose helper.
+ */
+declare function createManagedNodeSyncoreClient(options: WithNodeSyncoreClientOptions): Promise<ManagedNodeSyncoreClient>;
+/**
+ * Run a callback with a started local Node Syncore client and always stop the runtime.
+ *
+ * @example
+ * ```ts
+ * await withNodeSyncoreClient(options, async (client) => {
+ *   console.log(await client.query(api.tasks.list));
+ * });
+ * ```
+ */
+declare function withNodeSyncoreClient<TResult>(options: WithNodeSyncoreClientOptions, callback: (client: ReturnType<SyncoreRuntime<NodeSyncoreSchema>["createClient"]>, runtime: SyncoreRuntime<NodeSyncoreSchema>) => Promise<TResult> | TResult): Promise<TResult>;
+/**
+ * Create the default Electron main-process bridge used to connect a BrowserWindow
+ * to a Syncore runtime.
+ */
+declare function createElectronSyncoreBridge(options: CreateElectronSyncoreBridgeOptions): SyncoreIpcMessageEndpoint & {
+  dispose(): void;
+};
+/**
+ * Bind a BrowserWindow to a Syncore runtime with the default Electron IPC transport.
+ */
+declare function bindElectronWindowToSyncoreRuntime(options: {
+  runtime: SyncoreRuntime<NodeSyncoreSchema>;
+  window: SyncoreElectronBridgeWindow;
+  onRendererMessage(listener: (message: unknown) => void): () => void;
+  channel?: string;
+}): SyncoreElectronIpcBinding;
+declare function bindElectronWindowToSyncoreRuntime(options: {
+  runtime: SyncoreRuntime<NodeSyncoreSchema>;
+  window: SyncoreElectronBridgeWindow;
+  ipcMain: SyncoreElectronIpcMain;
+  channel?: string;
+}): SyncoreElectronIpcBinding;
+interface NodeWebSocketDevtoolsSinkOptions {
+  url: string;
+  reconnectDelayMs?: number;
+  appName?: string;
+  origin?: string;
+  sessionLabel?: string;
+}
+interface NodeWebSocketDevtoolsSink extends DevtoolsSink {
+  attachRuntime(getSnapshot: () => SyncoreDevtoolsSnapshot): void;
+  attachRequestHandler(handler: DevtoolsRequestHandler): void;
+  dispose(): void;
+}
+declare function createNodeWebSocketDevtoolsSink(options: NodeWebSocketDevtoolsSinkOptions): NodeWebSocketDevtoolsSink;
+//#endregion
+export { CreateElectronSyncoreBridgeOptions, CreateNodeRuntimeOptions, CreateSyncoreRendererWindowClientOptions, ManagedNodeSyncoreClient, NodeFileStorageAdapter, NodeSqliteDriver, NodeSyncoreSchema, NodeWebSocketDevtoolsSink, NodeWebSocketDevtoolsSinkOptions, SyncoreElectronBridgeWindow, SyncoreElectronIpcBinding, SyncoreElectronIpcMain, WithNodeSyncoreClientOptions, bindElectronWindowToSyncoreRuntime, createElectronSyncoreBridge, createManagedNodeSyncoreClient, createNodeSyncoreClient, createNodeSyncoreRuntime, createNodeWebSocketDevtoolsSink, withNodeSyncoreClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/platform-node/src/index.d.ts.map

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

package/dist/platform-node/src/index.js

@@ -0,0 +1,407 @@
+import { SyncoreRuntime } from "../../core/src/runtime/runtime.js";
+import { createDevtoolsRequestHandler } from "../../core/src/runtime/devtools.js";
+import "../../core/src/index.js";
+import { attachNodeIpcRuntime, createNodeIpcMessageEndpoint } from "./ipc.js";
+import { mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import WebSocket from "ws";
+//#region ../platform-node/src/index.ts
+function normalizeData(input) {
+	if (typeof input === "string") return Buffer.from(input);
+	if (input instanceof Uint8Array) return input;
+	return new Uint8Array(input);
+}
+function toSqlParameters(params) {
+	return params;
+}
+var NodeSqliteDriver = class {
+	database;
+	transactionDepth = 0;
+	constructor(filename) {
+		this.database = new DatabaseSync(filename);
+		this.database.exec("PRAGMA foreign_keys = ON;");
+		this.database.exec("PRAGMA journal_mode = WAL;");
+	}
+	async exec(sql) {
+		this.database.exec(sql);
+	}
+	async run(sql, params = []) {
+		const result = this.database.prepare(sql).run(...toSqlParameters(params));
+		return {
+			changes: Number(result.changes ?? 0),
+			lastInsertRowid: typeof result.lastInsertRowid === "bigint" ? Number(result.lastInsertRowid) : result.lastInsertRowid
+		};
+	}
+	async get(sql, params = []) {
+		return this.database.prepare(sql).get(...toSqlParameters(params));
+	}
+	async all(sql, params = []) {
+		return this.database.prepare(sql).all(...toSqlParameters(params));
+	}
+	async withTransaction(callback) {
+		if (this.transactionDepth > 0) return this.withSavepoint(`nested_${this.transactionDepth}`, callback);
+		this.transactionDepth += 1;
+		this.database.exec("BEGIN");
+		try {
+			const result = await callback();
+			this.database.exec("COMMIT");
+			return result;
+		} catch (error) {
+			this.database.exec("ROLLBACK");
+			throw error;
+		} finally {
+			this.transactionDepth -= 1;
+		}
+	}
+	async withSavepoint(name, callback) {
+		const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, "_");
+		this.database.exec(`SAVEPOINT ${safeName}`);
+		try {
+			const result = await callback();
+			this.database.exec(`RELEASE SAVEPOINT ${safeName}`);
+			return result;
+		} catch (error) {
+			this.database.exec(`ROLLBACK TO SAVEPOINT ${safeName}`);
+			this.database.exec(`RELEASE SAVEPOINT ${safeName}`);
+			throw error;
+		}
+	}
+	async close() {
+		this.database.close();
+	}
+};
+var NodeFileStorageAdapter = class {
+	constructor(directory) {
+		this.directory = directory;
+	}
+	filePath(id) {
+		return path.join(this.directory, id);
+	}
+	async put(id, input) {
+		await mkdir(this.directory, { recursive: true });
+		const filePath = this.filePath(id);
+		const bytes = normalizeData(input.data);
+		await writeFile(filePath, bytes);
+		return {
+			id,
+			path: filePath,
+			size: bytes.byteLength,
+			contentType: input.contentType ?? null
+		};
+	}
+	async get(id) {
+		const filePath = this.filePath(id);
+		try {
+			return {
+				id,
+				path: filePath,
+				size: (await stat(filePath)).size,
+				contentType: null
+			};
+		} catch {
+			return null;
+		}
+	}
+	async read(id) {
+		try {
+			return await readFile(this.filePath(id));
+		} catch {
+			return null;
+		}
+	}
+	async delete(id) {
+		await rm(this.filePath(id), { force: true });
+	}
+	async list() {
+		try {
+			const entries = await readdir(this.directory, { withFileTypes: true });
+			return await Promise.all(entries.filter((entry) => entry.isFile()).map(async (entry) => {
+				const filePath = this.filePath(entry.name);
+				const info = await stat(filePath);
+				return {
+					id: entry.name,
+					path: filePath,
+					size: info.size,
+					contentType: null
+				};
+			}));
+		} catch {
+			return [];
+		}
+	}
+};
+/**
+* Create a Node or Electron runtime backed by SQLite and local file storage.
+*/
+function createNodeSyncoreRuntime(options) {
+	const resolvedDevtoolsUrl = options.devtoolsUrl ?? resolveDefaultNodeDevtoolsUrl();
+	const websocketDevtools = options.devtools === void 0 && resolvedDevtoolsUrl && shouldAutoConnectNodeDevtools() ? createNodeWebSocketDevtoolsSink({
+		url: resolvedDevtoolsUrl,
+		...options.appName ? { appName: options.appName } : {},
+		...options.origin ? { origin: options.origin } : {},
+		...options.sessionLabel ? { sessionLabel: options.sessionLabel } : {}
+	}) : void 0;
+	const runtimeOptions = {
+		schema: options.schema,
+		functions: options.functions,
+		driver: new NodeSqliteDriver(options.databasePath),
+		storage: new NodeFileStorageAdapter(options.storageDirectory),
+		platform: options.platform ?? "node"
+	};
+	if (options.capabilities) runtimeOptions.capabilities = options.capabilities;
+	if (options.experimentalPlugins) runtimeOptions.experimentalPlugins = options.experimentalPlugins;
+	const resolvedDevtools = options.devtools === false ? void 0 : options.devtools ?? websocketDevtools;
+	if (resolvedDevtools) runtimeOptions.devtools = resolvedDevtools;
+	if (options.scheduler) runtimeOptions.scheduler = options.scheduler;
+	const runtime = new SyncoreRuntime(runtimeOptions);
+	websocketDevtools?.attachRuntime(() => runtime.getDevtoolsSnapshot());
+	if (websocketDevtools) {
+		websocketDevtools.attachRequestHandler(createDevtoolsRequestHandler({
+			driver: runtimeOptions.driver,
+			schema: options.schema,
+			functions: options.functions,
+			runtime
+		}));
+		const stop = runtime.stop.bind(runtime);
+		runtime.stop = async () => {
+			websocketDevtools.dispose();
+			await stop();
+		};
+	}
+	return runtime;
+}
+/**
+* Create a same-process Syncore client from a started Node runtime.
+*/
+function createNodeSyncoreClient(runtime) {
+	return runtime.createClient();
+}
+/**
+* Start a Node Syncore runtime and return its client together with a dispose helper.
+*/
+async function createManagedNodeSyncoreClient(options) {
+	const runtime = createNodeSyncoreRuntime(options);
+	await runtime.start();
+	return {
+		runtime,
+		client: runtime.createClient(),
+		async dispose() {
+			await runtime.stop();
+		}
+	};
+}
+/**
+* Run a callback with a started local Node Syncore client and always stop the runtime.
+*
+* @example
+* ```ts
+* await withNodeSyncoreClient(options, async (client) => {
+*   console.log(await client.query(api.tasks.list));
+* });
+* ```
+*/
+async function withNodeSyncoreClient(options, callback) {
+	const managed = await createManagedNodeSyncoreClient(options);
+	try {
+		return await callback(managed.client, managed.runtime);
+	} finally {
+		await managed.dispose();
+	}
+}
+/**
+* Create the default Electron main-process bridge used to connect a BrowserWindow
+* to a Syncore runtime.
+*/
+function createElectronSyncoreBridge(options) {
+	const channel = options.channel ?? "syncore:message";
+	return createNodeIpcMessageEndpoint({
+		postMessage(message) {
+			if (!options.window.isDestroyed()) options.window.webContents.send(channel, message);
+		},
+		onMessage(listener) {
+			return options.onRendererMessage(listener);
+		}
+	});
+}
+function bindElectronWindowToSyncoreRuntime(options) {
+	const cleanupCallbacks = [];
+	const channel = options.channel ?? "syncore:message";
+	let onRendererMessage;
+	if (!options.onRendererMessage) {
+		if (!options.ipcMain) throw new Error("bindElectronWindowToSyncoreRuntime requires either onRendererMessage() or ipcMain.");
+		const listeners = /* @__PURE__ */ new Set();
+		const handleRendererMessage = (_event, message) => {
+			for (const listener of listeners) listener(message);
+		};
+		options.ipcMain.on(channel, handleRendererMessage);
+		cleanupCallbacks.push(() => {
+			options.ipcMain?.off(channel, handleRendererMessage);
+			listeners.clear();
+		});
+		onRendererMessage = (listener) => {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		};
+	} else onRendererMessage = (listener) => options.onRendererMessage(listener);
+	const endpoint = createElectronSyncoreBridge({
+		window: options.window,
+		onRendererMessage,
+		channel
+	});
+	const attachedRuntime = attachNodeIpcRuntime({
+		endpoint,
+		createRuntime: () => options.runtime
+	});
+	return {
+		ready: attachedRuntime.ready,
+		async dispose() {
+			await attachedRuntime.dispose();
+			endpoint.dispose();
+			for (const cleanup of cleanupCallbacks) cleanup();
+		}
+	};
+}
+function createNodeWebSocketDevtoolsSink(options) {
+	let socket;
+	let disposed = false;
+	let connectTimer;
+	let getSnapshot;
+	let onRequest;
+	const pendingMessages = [];
+	let latestHello;
+	const connect = () => {
+		if (disposed) return;
+		socket = new WebSocket(options.url);
+		socket.on("open", () => {
+			if (latestHello) sendNow({
+				type: "hello",
+				runtimeId: latestHello.runtimeId,
+				platform: latestHello.platform,
+				...options.appName ? { appName: options.appName } : {},
+				...options.origin ? { origin: options.origin } : {},
+				...options.sessionLabel ? { sessionLabel: options.sessionLabel } : {}
+			});
+			if (getSnapshot) sendNow({
+				type: "snapshot",
+				snapshot: withSnapshotMeta(getSnapshot(), options)
+			});
+			flushPendingMessages();
+		});
+		socket.on("message", (payload) => {
+			const rawPayload = typeof payload === "string" ? payload : payload instanceof Buffer ? payload.toString("utf8") : Array.isArray(payload) ? Buffer.concat(payload).toString("utf8") : payload instanceof ArrayBuffer ? Buffer.from(payload).toString("utf8") : Buffer.from(payload.buffer, payload.byteOffset, payload.byteLength).toString("utf8");
+			if (rawPayload.length === 0) return;
+			const message = JSON.parse(rawPayload);
+			if (message.type === "ping") send({ type: "pong" });
+			else if (message.type === "request" && onRequest) onRequest(message.payload).then((responsePayload) => {
+				const runtimeId = latestHello?.runtimeId ?? getSnapshot?.().runtimeId;
+				if (!runtimeId) return;
+				send({
+					type: "response",
+					requestId: message.requestId,
+					runtimeId,
+					payload: responsePayload
+				});
+			}).catch((err) => {
+				const runtimeId = latestHello?.runtimeId ?? getSnapshot?.().runtimeId;
+				if (!runtimeId) return;
+				send({
+					type: "response",
+					requestId: message.requestId,
+					runtimeId,
+					payload: {
+						kind: "error",
+						message: err instanceof Error ? err.message : "Unknown error"
+					}
+				});
+			});
+		});
+		socket.on("close", scheduleReconnect);
+		socket.on("error", scheduleReconnect);
+	};
+	const scheduleReconnect = () => {
+		if (disposed || connectTimer) return;
+		connectTimer = setTimeout(() => {
+			connectTimer = void 0;
+			connect();
+		}, options.reconnectDelayMs ?? 1200);
+	};
+	const sendNow = (message) => {
+		if (socket?.readyState === WebSocket.OPEN) socket.send(JSON.stringify(message));
+	};
+	const flushPendingMessages = () => {
+		while (pendingMessages.length > 0) {
+			const nextMessage = pendingMessages.shift();
+			if (!nextMessage) continue;
+			sendNow(nextMessage);
+		}
+	};
+	const send = (message) => {
+		if (socket?.readyState === WebSocket.OPEN) {
+			sendNow(message);
+			return;
+		}
+		pendingMessages.push(message);
+	};
+	connect();
+	return {
+		emit(event) {
+			if (event.type === "runtime.connected") {
+				latestHello = {
+					runtimeId: event.runtimeId,
+					platform: event.platform
+				};
+				send({
+					type: "hello",
+					runtimeId: event.runtimeId,
+					platform: event.platform,
+					...options.appName ? { appName: options.appName } : {},
+					...options.origin ? { origin: options.origin } : {},
+					...options.sessionLabel ? { sessionLabel: options.sessionLabel } : {}
+				});
+			}
+			send({
+				type: "event",
+				event
+			});
+			if (getSnapshot) send({
+				type: "snapshot",
+				snapshot: withSnapshotMeta(getSnapshot(), options)
+			});
+		},
+		attachRuntime(snapshotGetter) {
+			getSnapshot = snapshotGetter;
+			if (socket?.readyState === WebSocket.OPEN) send({
+				type: "snapshot",
+				snapshot: withSnapshotMeta(getSnapshot(), options)
+			});
+		},
+		attachRequestHandler(handler) {
+			onRequest = handler;
+		},
+		dispose() {
+			disposed = true;
+			if (connectTimer) clearTimeout(connectTimer);
+			socket?.close();
+		}
+	};
+}
+function withSnapshotMeta(snapshot, options) {
+	return {
+		...snapshot,
+		...options.appName ? { appName: options.appName } : {},
+		...options.origin ? { origin: options.origin } : {},
+		...options.sessionLabel ? { sessionLabel: options.sessionLabel } : {}
+	};
+}
+function shouldAutoConnectNodeDevtools() {
+	return process.env.NODE_ENV !== "production";
+}
+function resolveDefaultNodeDevtoolsUrl() {
+	if (process.env.SYNCORE_DISABLE_DEVTOOLS === "1") return;
+	return process.env.SYNCORE_DEVTOOLS_URL ?? "ws://127.0.0.1:4311";
+}
+//#endregion
+export { NodeFileStorageAdapter, NodeSqliteDriver, bindElectronWindowToSyncoreRuntime, createElectronSyncoreBridge, createManagedNodeSyncoreClient, createNodeSyncoreClient, createNodeSyncoreRuntime, createNodeWebSocketDevtoolsSink, withNodeSyncoreClient };
+
+//# sourceMappingURL=index.js.map

package/dist/platform-node/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../platform-node/src/index.ts"],"sourcesContent":["import {\n  mkdir,\n  readdir,\n  readFile,\n  rm,\n  stat,\n  writeFile\n} from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DatabaseSync, type SQLInputValue } from \"node:sqlite\";\nimport WebSocket from \"ws\";\nimport type {\n  SyncoreDevtoolsMessage,\n  SyncoreDevtoolsRequest,\n  SyncoreDevtoolsSnapshot\n} from \"@syncore/devtools-protocol\";\nimport {\n  type AnySyncoreSchema,\n  createDevtoolsRequestHandler,\n  type DevtoolsRequestHandler,\n  type DevtoolsSink,\n  type SchedulerOptions,\n  type StorageObject,\n  type StorageWriteInput,\n  type SyncoreCapabilities,\n  type SyncoreExperimentalPlugin,\n  SyncoreRuntime,\n  type SyncoreRuntimeOptions,\n  type SyncoreSqlDriver,\n  type SyncoreStorageAdapter\n} from \"@syncore/core\";\nimport { attachNodeIpcRuntime, createNodeIpcMessageEndpoint } from \"./ipc.js\";\nexport * from \"./ipc.js\";\nexport type {\n  SyncoreDevtoolsEvent,\n  SyncoreDevtoolsSnapshot\n} from \"@syncore/devtools-protocol\";\n\nexport type NodeSyncoreSchema = AnySyncoreSchema;\n\nfunction normalizeData(input: StorageWriteInput[\"data\"]): Uint8Array {\n  if (typeof input === \"string\") {\n    return Buffer.from(input);\n  }\n  if (input instanceof Uint8Array) {\n    return input;\n  }\n  return new Uint8Array(input);\n}\n\nfunction toSqlParameters(params: unknown[]): SQLInputValue[] {\n  return params as SQLInputValue[];\n}\n\nexport class NodeSqliteDriver implements SyncoreSqlDriver {\n  private readonly database: DatabaseSync;\n  private transactionDepth = 0;\n\n  constructor(filename: string) {\n    this.database = new DatabaseSync(filename);\n    this.database.exec(\"PRAGMA foreign_keys = ON;\");\n    this.database.exec(\"PRAGMA journal_mode = WAL;\");\n  }\n\n  async exec(sql: string): Promise<void> {\n    this.database.exec(sql);\n  }\n\n  async run(\n    sql: string,\n    params: unknown[] = []\n  ): Promise<{ changes: number; lastInsertRowid?: number | string }> {\n    const statement = this.database.prepare(sql);\n    const result = statement.run(...toSqlParameters(params));\n    return {\n      changes: Number(result.changes ?? 0),\n      lastInsertRowid:\n        typeof result.lastInsertRowid === \"bigint\"\n          ? Number(result.lastInsertRowid)\n          : result.lastInsertRowid\n    };\n  }\n\n  async get<T>(sql: string, params: unknown[] = []): Promise<T | undefined> {\n    const statement = this.database.prepare(sql);\n    return statement.get(...toSqlParameters(params)) as T | undefined;\n  }\n\n  async all<T>(sql: string, params: unknown[] = []): Promise<T[]> {\n    const statement = this.database.prepare(sql);\n    return statement.all(...toSqlParameters(params)) as T[];\n  }\n\n  async withTransaction<T>(callback: () => Promise<T>): Promise<T> {\n    if (this.transactionDepth > 0) {\n      return this.withSavepoint(`nested_${this.transactionDepth}`, callback);\n    }\n\n    this.transactionDepth += 1;\n    this.database.exec(\"BEGIN\");\n    try {\n      const result = await callback();\n      this.database.exec(\"COMMIT\");\n      return result;\n    } catch (error) {\n      this.database.exec(\"ROLLBACK\");\n      throw error;\n    } finally {\n      this.transactionDepth -= 1;\n    }\n  }\n\n  async withSavepoint<T>(name: string, callback: () => Promise<T>): Promise<T> {\n    const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, \"_\");\n    this.database.exec(`SAVEPOINT ${safeName}`);\n    try {\n      const result = await callback();\n      this.database.exec(`RELEASE SAVEPOINT ${safeName}`);\n      return result;\n    } catch (error) {\n      this.database.exec(`ROLLBACK TO SAVEPOINT ${safeName}`);\n      this.database.exec(`RELEASE SAVEPOINT ${safeName}`);\n      throw error;\n    }\n  }\n\n  async close(): Promise<void> {\n    this.database.close();\n  }\n}\n\nexport class NodeFileStorageAdapter implements SyncoreStorageAdapter {\n  constructor(private readonly directory: string) {}\n\n  private filePath(id: string): string {\n    return path.join(this.directory, id);\n  }\n\n  async put(id: string, input: StorageWriteInput): Promise<StorageObject> {\n    await mkdir(this.directory, { recursive: true });\n    const filePath = this.filePath(id);\n    const bytes = normalizeData(input.data);\n    await writeFile(filePath, bytes);\n    return {\n      id,\n      path: filePath,\n      size: bytes.byteLength,\n      contentType: input.contentType ?? null\n    };\n  }\n\n  async get(id: string): Promise<StorageObject | null> {\n    const filePath = this.filePath(id);\n    try {\n      const info = await stat(filePath);\n      return {\n        id,\n        path: filePath,\n        size: info.size,\n        contentType: null\n      };\n    } catch {\n      return null;\n    }\n  }\n\n  async read(id: string): Promise<Uint8Array | null> {\n    try {\n      return await readFile(this.filePath(id));\n    } catch {\n      return null;\n    }\n  }\n\n  async delete(id: string): Promise<void> {\n    await rm(this.filePath(id), { force: true });\n  }\n\n  async list(): Promise<StorageObject[]> {\n    try {\n      const entries = await readdir(this.directory, { withFileTypes: true });\n      const objects = await Promise.all(\n        entries\n          .filter((entry) => entry.isFile())\n          .map(async (entry) => {\n            const filePath = this.filePath(entry.name);\n            const info = await stat(filePath);\n            return {\n              id: entry.name,\n              path: filePath,\n              size: info.size,\n              contentType: null\n            } satisfies StorageObject;\n          })\n      );\n      return objects;\n    } catch {\n      return [];\n    }\n  }\n}\n\nexport interface CreateNodeRuntimeOptions {\n  databasePath: string;\n  storageDirectory: string;\n  schema: NodeSyncoreSchema;\n  functions: SyncoreRuntimeOptions<NodeSyncoreSchema>[\"functions\"];\n  capabilities?: SyncoreCapabilities;\n  experimentalPlugins?: Array<SyncoreExperimentalPlugin<NodeSyncoreSchema>>;\n  appName?: string;\n  origin?: string;\n  sessionLabel?: string;\n  platform?: string;\n  devtools?: DevtoolsSink | false;\n  devtoolsUrl?: string;\n  scheduler?: SchedulerOptions;\n}\n\n/**\n * Options for creating a managed Node Syncore client.\n */\nexport type WithNodeSyncoreClientOptions = CreateNodeRuntimeOptions;\n\n/**\n * A started local Node runtime paired with its client and a dispose helper.\n */\nexport interface ManagedNodeSyncoreClient {\n  runtime: SyncoreRuntime<NodeSyncoreSchema>;\n  client: ReturnType<SyncoreRuntime<NodeSyncoreSchema>[\"createClient\"]>;\n  dispose(): Promise<void>;\n}\n\nexport interface SyncoreElectronIpcBinding {\n  ready: Promise<void>;\n  dispose(): Promise<void>;\n}\n\nexport interface SyncoreElectronBridgeWindow {\n  isDestroyed(): boolean;\n  webContents: {\n    send(channel: string, message: unknown): void;\n  };\n}\n\nexport interface CreateElectronSyncoreBridgeOptions {\n  window: SyncoreElectronBridgeWindow;\n  onRendererMessage(listener: (message: unknown) => void): () => void;\n  channel?: string;\n}\n\n/**\n * The subset of Electron's `ipcMain` used by Syncore's main-process helper.\n */\nexport interface SyncoreElectronIpcMain {\n  on(\n    channel: string,\n    listener: (event: unknown, message: unknown) => void\n  ): void;\n  off(\n    channel: string,\n    listener: (event: unknown, message: unknown) => void\n  ): void;\n}\n\nexport interface CreateSyncoreRendererWindowClientOptions {\n  bridgeName?: string;\n}\n\n/**\n * Create a Node or Electron runtime backed by SQLite and local file storage.\n */\nexport function createNodeSyncoreRuntime(\n  options: CreateNodeRuntimeOptions\n): SyncoreRuntime<NodeSyncoreSchema> {\n  const resolvedDevtoolsUrl =\n    options.devtoolsUrl ?? resolveDefaultNodeDevtoolsUrl();\n  const websocketDevtools =\n    options.devtools === undefined &&\n    resolvedDevtoolsUrl &&\n    shouldAutoConnectNodeDevtools()\n      ? createNodeWebSocketDevtoolsSink({\n          url: resolvedDevtoolsUrl,\n          ...(options.appName ? { appName: options.appName } : {}),\n          ...(options.origin ? { origin: options.origin } : {}),\n          ...(options.sessionLabel\n            ? { sessionLabel: options.sessionLabel }\n            : {})\n        })\n      : undefined;\n  const runtimeOptions: SyncoreRuntimeOptions<NodeSyncoreSchema> = {\n    schema: options.schema,\n    functions: options.functions,\n    driver: new NodeSqliteDriver(options.databasePath),\n    storage: new NodeFileStorageAdapter(options.storageDirectory),\n    platform: options.platform ?? \"node\"\n  };\n  if (options.capabilities) {\n    runtimeOptions.capabilities = options.capabilities;\n  }\n  if (options.experimentalPlugins) {\n    runtimeOptions.experimentalPlugins = options.experimentalPlugins;\n  }\n  const resolvedDevtools =\n    options.devtools === false\n      ? undefined\n      : (options.devtools ?? websocketDevtools);\n  if (resolvedDevtools) {\n    runtimeOptions.devtools = resolvedDevtools;\n  }\n  if (options.scheduler) {\n    runtimeOptions.scheduler = options.scheduler;\n  }\n  const runtime = new SyncoreRuntime(runtimeOptions);\n  websocketDevtools?.attachRuntime(() => runtime.getDevtoolsSnapshot());\n  if (websocketDevtools) {\n    websocketDevtools.attachRequestHandler(\n      createDevtoolsRequestHandler({\n        driver: runtimeOptions.driver,\n        schema: options.schema,\n        functions: options.functions,\n        runtime\n      })\n    );\n    const stop = runtime.stop.bind(runtime);\n    runtime.stop = async () => {\n      websocketDevtools.dispose();\n      await stop();\n    };\n  }\n  return runtime;\n}\n\n/**\n * Create a same-process Syncore client from a started Node runtime.\n */\nexport function createNodeSyncoreClient(\n  runtime: SyncoreRuntime<NodeSyncoreSchema>\n) {\n  return runtime.createClient();\n}\n\n/**\n * Start a Node Syncore runtime and return its client together with a dispose helper.\n */\nexport async function createManagedNodeSyncoreClient(\n  options: WithNodeSyncoreClientOptions\n): Promise<ManagedNodeSyncoreClient> {\n  const runtime = createNodeSyncoreRuntime(options);\n  await runtime.start();\n  return {\n    runtime,\n    client: runtime.createClient(),\n    async dispose() {\n      await runtime.stop();\n    }\n  };\n}\n\n/**\n * Run a callback with a started local Node Syncore client and always stop the runtime.\n *\n * @example\n * ```ts\n * await withNodeSyncoreClient(options, async (client) => {\n *   console.log(await client.query(api.tasks.list));\n * });\n * ```\n */\nexport async function withNodeSyncoreClient<TResult>(\n  options: WithNodeSyncoreClientOptions,\n  callback: (\n    client: ReturnType<SyncoreRuntime<NodeSyncoreSchema>[\"createClient\"]>,\n    runtime: SyncoreRuntime<NodeSyncoreSchema>\n  ) => Promise<TResult> | TResult\n): Promise<TResult> {\n  const managed = await createManagedNodeSyncoreClient(options);\n  try {\n    return await callback(managed.client, managed.runtime);\n  } finally {\n    await managed.dispose();\n  }\n}\n\n/**\n * Create the default Electron main-process bridge used to connect a BrowserWindow\n * to a Syncore runtime.\n */\nexport function createElectronSyncoreBridge(\n  options: CreateElectronSyncoreBridgeOptions\n) {\n  const channel = options.channel ?? \"syncore:message\";\n  return createNodeIpcMessageEndpoint({\n    postMessage(message: unknown) {\n      if (!options.window.isDestroyed()) {\n        options.window.webContents.send(channel, message);\n      }\n    },\n    onMessage(listener: (message: unknown) => void) {\n      return options.onRendererMessage(listener);\n    }\n  });\n}\n\n/**\n * Bind a BrowserWindow to a Syncore runtime with the default Electron IPC transport.\n */\nexport function bindElectronWindowToSyncoreRuntime(options: {\n  runtime: SyncoreRuntime<NodeSyncoreSchema>;\n  window: SyncoreElectronBridgeWindow;\n  onRendererMessage(listener: (message: unknown) => void): () => void;\n  channel?: string;\n}): SyncoreElectronIpcBinding;\nexport function bindElectronWindowToSyncoreRuntime(options: {\n  runtime: SyncoreRuntime<NodeSyncoreSchema>;\n  window: SyncoreElectronBridgeWindow;\n  ipcMain: SyncoreElectronIpcMain;\n  channel?: string;\n}): SyncoreElectronIpcBinding;\nexport function bindElectronWindowToSyncoreRuntime(options: {\n  runtime: SyncoreRuntime<NodeSyncoreSchema>;\n  window: SyncoreElectronBridgeWindow;\n  onRendererMessage?(listener: (message: unknown) => void): () => void;\n  ipcMain?: SyncoreElectronIpcMain;\n  channel?: string;\n}): SyncoreElectronIpcBinding {\n  const cleanupCallbacks: Array<() => void> = [];\n  const channel = options.channel ?? \"syncore:message\";\n  let onRendererMessage:\n    | ((listener: (message: unknown) => void) => () => void)\n    | undefined;\n\n  if (!options.onRendererMessage) {\n    if (!options.ipcMain) {\n      throw new Error(\n        \"bindElectronWindowToSyncoreRuntime requires either onRendererMessage() or ipcMain.\"\n      );\n    }\n    const listeners = new Set<(message: unknown) => void>();\n    const handleRendererMessage = (_event: unknown, message: unknown) => {\n      for (const listener of listeners) {\n        listener(message);\n      }\n    };\n    options.ipcMain.on(channel, handleRendererMessage);\n    cleanupCallbacks.push(() => {\n      options.ipcMain?.off(channel, handleRendererMessage);\n      listeners.clear();\n    });\n    onRendererMessage = (listener) => {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    };\n  } else {\n    onRendererMessage = (listener) => options.onRendererMessage!(listener);\n  }\n\n  const endpoint = createElectronSyncoreBridge({\n    window: options.window,\n    onRendererMessage,\n    channel\n  });\n  const attachedRuntime = attachNodeIpcRuntime({\n    endpoint,\n    createRuntime: () => options.runtime\n  });\n\n  return {\n    ready: attachedRuntime.ready,\n    async dispose() {\n      await attachedRuntime.dispose();\n      endpoint.dispose();\n      for (const cleanup of cleanupCallbacks) {\n        cleanup();\n      }\n    }\n  };\n}\n\n/* ------------------------------------------------------------------ */\n/*  Devtools request handler                                           */\n/* ------------------------------------------------------------------ */\n\nexport interface NodeWebSocketDevtoolsSinkOptions {\n  url: string;\n  reconnectDelayMs?: number;\n  appName?: string;\n  origin?: string;\n  sessionLabel?: string;\n}\n\nexport interface NodeWebSocketDevtoolsSink extends DevtoolsSink {\n  attachRuntime(getSnapshot: () => SyncoreDevtoolsSnapshot): void;\n  attachRequestHandler(handler: DevtoolsRequestHandler): void;\n  dispose(): void;\n}\n\nexport function createNodeWebSocketDevtoolsSink(\n  options: NodeWebSocketDevtoolsSinkOptions\n): NodeWebSocketDevtoolsSink {\n  let socket: WebSocket | undefined;\n  let disposed = false;\n  let connectTimer: ReturnType<typeof setTimeout> | undefined;\n  let getSnapshot: (() => SyncoreDevtoolsSnapshot) | undefined;\n  let onRequest: DevtoolsRequestHandler | undefined;\n  const pendingMessages: SyncoreDevtoolsMessage[] = [];\n  let latestHello:\n    | {\n        runtimeId: string;\n        platform: string;\n      }\n    | undefined;\n\n  const connect = () => {\n    if (disposed) {\n      return;\n    }\n    socket = new WebSocket(options.url);\n    socket.on(\"open\", () => {\n      if (latestHello) {\n        sendNow({\n          type: \"hello\",\n          runtimeId: latestHello.runtimeId,\n          platform: latestHello.platform,\n          ...(options.appName ? { appName: options.appName } : {}),\n          ...(options.origin ? { origin: options.origin } : {}),\n          ...(options.sessionLabel\n            ? { sessionLabel: options.sessionLabel }\n            : {})\n        });\n      }\n      if (getSnapshot) {\n        sendNow({\n          type: \"snapshot\",\n          snapshot: withSnapshotMeta(getSnapshot(), options)\n        });\n      }\n      flushPendingMessages();\n    });\n    socket.on(\"message\", (payload) => {\n      const rawPayload =\n        typeof payload === \"string\"\n          ? payload\n          : payload instanceof Buffer\n            ? payload.toString(\"utf8\")\n            : Array.isArray(payload)\n              ? Buffer.concat(payload).toString(\"utf8\")\n              : payload instanceof ArrayBuffer\n                ? Buffer.from(payload).toString(\"utf8\")\n                : Buffer.from(\n                    payload.buffer,\n                    payload.byteOffset,\n                    payload.byteLength\n                  ).toString(\"utf8\");\n      if (rawPayload.length === 0) {\n        return;\n      }\n      const message = JSON.parse(rawPayload) as\n        | SyncoreDevtoolsMessage\n        | SyncoreDevtoolsRequest;\n      if (message.type === \"ping\") {\n        send({ type: \"pong\" });\n      } else if (message.type === \"request\" && onRequest) {\n        onRequest(message.payload)\n          .then((responsePayload) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSnapshot?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"response\",\n              requestId: message.requestId,\n              runtimeId,\n              payload: responsePayload\n            });\n          })\n          .catch((err) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSnapshot?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"response\",\n              requestId: message.requestId,\n              runtimeId,\n              payload: {\n                kind: \"error\",\n                message: err instanceof Error ? err.message : \"Unknown error\"\n              }\n            });\n          });\n      }\n    });\n    socket.on(\"close\", scheduleReconnect);\n    socket.on(\"error\", scheduleReconnect);\n  };\n\n  const scheduleReconnect = () => {\n    if (disposed || connectTimer) {\n      return;\n    }\n    connectTimer = setTimeout(() => {\n      connectTimer = undefined;\n      connect();\n    }, options.reconnectDelayMs ?? 1200);\n  };\n\n  const sendNow = (message: SyncoreDevtoolsMessage) => {\n    if (socket?.readyState === WebSocket.OPEN) {\n      socket.send(JSON.stringify(message));\n    }\n  };\n\n  const flushPendingMessages = () => {\n    while (pendingMessages.length > 0) {\n      const nextMessage = pendingMessages.shift();\n      if (!nextMessage) {\n        continue;\n      }\n      sendNow(nextMessage);\n    }\n  };\n\n  const send = (message: SyncoreDevtoolsMessage) => {\n    if (socket?.readyState === WebSocket.OPEN) {\n      sendNow(message);\n      return;\n    }\n    pendingMessages.push(message);\n  };\n\n  connect();\n\n  return {\n    emit(event) {\n      if (event.type === \"runtime.connected\") {\n        latestHello = {\n          runtimeId: event.runtimeId,\n          platform: event.platform\n        };\n        send({\n          type: \"hello\",\n          runtimeId: event.runtimeId,\n          platform: event.platform,\n          ...(options.appName ? { appName: options.appName } : {}),\n          ...(options.origin ? { origin: options.origin } : {}),\n          ...(options.sessionLabel\n            ? { sessionLabel: options.sessionLabel }\n            : {})\n        });\n      }\n      send({\n        type: \"event\",\n        event\n      });\n      if (getSnapshot) {\n        send({\n          type: \"snapshot\",\n          snapshot: withSnapshotMeta(getSnapshot(), options)\n        });\n      }\n    },\n    attachRuntime(snapshotGetter) {\n      getSnapshot = snapshotGetter;\n      if (socket?.readyState === WebSocket.OPEN) {\n        send({\n          type: \"snapshot\",\n          snapshot: withSnapshotMeta(getSnapshot(), options)\n        });\n      }\n    },\n    attachRequestHandler(handler) {\n      onRequest = handler;\n    },\n    dispose() {\n      disposed = true;\n      if (connectTimer) {\n        clearTimeout(connectTimer);\n      }\n      socket?.close();\n    }\n  };\n}\n\nfunction withSnapshotMeta(\n  snapshot: SyncoreDevtoolsSnapshot,\n  options: NodeWebSocketDevtoolsSinkOptions\n): SyncoreDevtoolsSnapshot {\n  return {\n    ...snapshot,\n    ...(options.appName ? { appName: options.appName } : {}),\n    ...(options.origin ? { origin: options.origin } : {}),\n    ...(options.sessionLabel ? { sessionLabel: options.sessionLabel } : {})\n  };\n}\n\nfunction shouldAutoConnectNodeDevtools(): boolean {\n  return process.env.NODE_ENV !== \"production\";\n}\n\nfunction resolveDefaultNodeDevtoolsUrl(): string | undefined {\n  if (process.env.SYNCORE_DISABLE_DEVTOOLS === \"1\") {\n    return undefined;\n  }\n  return process.env.SYNCORE_DEVTOOLS_URL ?? \"ws://127.0.0.1:4311\";\n}\n"],"mappings":"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"}

package/dist/platform-node/src/ipc-react.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from "react";
+
+//#region ../platform-node/src/ipc-react.d.ts
+/**
+ * Props for {@link SyncoreElectronProvider}.
+ */
+interface SyncoreElectronProviderProps {
+  /** The React subtree that should receive the renderer Syncore client. */
+  children: ReactNode;
+  /** Optional custom bridge name exposed on `window`. */
+  bridgeName?: string;
+  /** Optional window-like object for tests or custom shells. */
+  windowObject?: Window & typeof globalThis;
+}
+/**
+ * Create a renderer Syncore client from `window.syncoreBridge` and provide it to React.
+ */
+declare function SyncoreElectronProvider({
+  children,
+  bridgeName,
+  windowObject
+}: SyncoreElectronProviderProps): ReactNode;
+//#endregion
+export { SyncoreElectronProvider, SyncoreElectronProviderProps };
+//# sourceMappingURL=ipc-react.d.ts.map

package/dist/platform-node/src/ipc-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-react.d.ts","names":[],"sources":["../../../../platform-node/src/ipc-react.tsx"],"mappings":";;;;;AAQA;UAAiB,4BAAA;;EAEf,QAAA,EAAU,SAAA;EAMK;EAHf,UAAA;EAGyC;EAAzC,YAAA,GAAe,MAAA,UAAgB,UAAA;AAAA;;;;iBAMjB,uBAAA,CAAA;EACd,QAAA;EACA,UAAA;EACA;AAAA,GACC,4BAAA,GAA+B,SAAA"}

package/dist/platform-node/src/ipc-react.js

@@ -0,0 +1,21 @@
+import { SyncoreProvider } from "../../react/src/index.js";
+import { createRendererSyncoreWindowClient } from "./ipc.js";
+import { useEffect, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region ../platform-node/src/ipc-react.tsx
+/**
+* Create a renderer Syncore client from `window.syncoreBridge` and provide it to React.
+*/
+function SyncoreElectronProvider({ children, bridgeName, windowObject }) {
+	const resolvedWindow = windowObject ?? window;
+	const client = useMemo(() => createRendererSyncoreWindowClient(resolvedWindow, bridgeName ?? "syncoreBridge"), [bridgeName, resolvedWindow]);
+	useEffect(() => () => client.dispose(), [client]);
+	return /* @__PURE__ */ jsx(SyncoreProvider, {
+		client,
+		children
+	});
+}
+//#endregion
+export { SyncoreElectronProvider };
+
+//# sourceMappingURL=ipc-react.js.map