syncorejs 0.1.0

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

@@ -0,0 +1,311 @@
+import { SyncoreRuntime } from "../../core/src/runtime/runtime.js";
+import { createDevtoolsRequestHandler } from "../../core/src/runtime/devtools.js";
+import "../../core/src/index.js";
+import "./indexeddb.js";
+import "./opfs.js";
+import { createWebPersistence } from "./persistence.js";
+import { SqlJsDriver } from "./sqljs.js";
+import { attachWebWorkerRuntime } from "./worker.js";
+//#region ../platform-web/src/index.ts
+/**
+* Create a full Syncore runtime directly in the browser.
+*
+* Most React apps should use a worker runtime instead so queries and SQLite work
+* stay off the main thread.
+*/
+async function createWebSyncoreRuntime(options) {
+	const persistence = options.persistence ?? await createWebPersistence({
+		...options.persistenceMode ? { mode: options.persistenceMode } : {},
+		...options.persistenceDatabaseName ? { indexedDbDatabaseName: options.persistenceDatabaseName } : {},
+		opfsRootDirectoryName: options.opfsRootDirectoryName ?? options.databaseName ?? "syncore"
+	});
+	const driver = options.driver ?? await SqlJsDriver.create({
+		databaseName: options.databaseName ?? "syncore",
+		persistence,
+		...options.wasmUrl ? { wasmUrl: options.wasmUrl } : {},
+		...options.locateFile ? { locateFile: options.locateFile } : {}
+	});
+	const storage = options.storage ?? new BrowserFileStorageAdapter(persistence, options.storageNamespace ?? options.databaseName ?? "syncore");
+	const appName = resolveWebAppName();
+	const origin = resolveWebOrigin();
+	const sessionLabel = resolveWebSessionLabel();
+	const autoDevtools = options.devtools === void 0 && shouldAutoConnectDevtools() ? (() => {
+		const sinkOptions = { url: resolveDefaultDevtoolsUrl() };
+		if (appName) sinkOptions.appName = appName;
+		if (origin) sinkOptions.origin = origin;
+		if (sessionLabel) sinkOptions.sessionLabel = sessionLabel;
+		return createBrowserWebSocketDevtoolsSink(sinkOptions);
+	})() : void 0;
+	const resolvedDevtools = options.devtools === false ? void 0 : options.devtools ?? autoDevtools;
+	const runtime = new SyncoreRuntime({
+		schema: options.schema,
+		functions: options.functions,
+		driver,
+		storage,
+		platform: options.platform ?? "browser",
+		...options.capabilities ? { capabilities: options.capabilities } : {},
+		...resolvedDevtools ? { devtools: resolvedDevtools } : {},
+		...options.experimentalPlugins ? { experimentalPlugins: options.experimentalPlugins } : {},
+		...options.scheduler ? { scheduler: options.scheduler } : {}
+	});
+	if (autoDevtools) {
+		autoDevtools.attachRuntime(() => runtime.getDevtoolsSnapshot());
+		autoDevtools.attachRequestHandler(createDevtoolsRequestHandler({
+			driver,
+			schema: options.schema,
+			functions: options.functions,
+			runtime
+		}));
+	}
+	return runtime;
+}
+/**
+* Attach a Syncore runtime to a browser Worker endpoint.
+*/
+function createWebWorkerRuntime(options) {
+	return attachWebWorkerRuntime({
+		endpoint: options.endpoint,
+		createRuntime: () => createWebSyncoreRuntime(options)
+	});
+}
+/**
+* Attach a Syncore runtime to a browser Worker endpoint.
+*/
+function createBrowserWorkerRuntime(options) {
+	return createWebWorkerRuntime(options);
+}
+/**
+* Create a client directly from a browser Syncore runtime.
+*/
+function createWebSyncoreClient(runtime) {
+	return runtime.createClient();
+}
+/**
+* Create a full Syncore runtime directly in the browser.
+*/
+function createBrowserSyncoreRuntime(options) {
+	return createWebSyncoreRuntime(options);
+}
+/**
+* Create a client directly from a browser Syncore runtime.
+*/
+function createBrowserSyncoreClient(runtime) {
+	return createWebSyncoreClient(runtime);
+}
+function createBrowserWebSocketDevtoolsSink(options) {
+	let socket;
+	let disposed = false;
+	let connectTimer;
+	let getSnapshot;
+	let onRequest;
+	const pendingMessages = [];
+	let latestHello;
+	const connect = () => {
+		if (disposed || typeof WebSocket === "undefined") return;
+		socket = new WebSocket(options.url);
+		socket.onopen = () => {
+			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.onmessage = (event) => {
+			if (typeof event.data !== "string") return;
+			const message = JSON.parse(event.data);
+			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.onclose = scheduleReconnect;
+		socket.onerror = () => {
+			socket?.close();
+		};
+	};
+	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) 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 shouldAutoConnectDevtools() {
+	if (typeof globalThis === "undefined") return false;
+	try {
+		return globalThis.location?.hostname === "localhost" || globalThis.location?.hostname === "127.0.0.1" ? true : Boolean(globalThis.location?.hostname?.endsWith?.(".local"));
+	} catch {
+		return false;
+	}
+}
+function resolveDefaultDevtoolsUrl() {
+	return "ws://127.0.0.1:4311";
+}
+function resolveWebOrigin() {
+	try {
+		return globalThis.location?.origin;
+	} catch {
+		return;
+	}
+}
+function resolveWebAppName() {
+	try {
+		return globalThis.location?.hostname ?? globalThis.document?.title ?? void 0;
+	} catch {
+		return;
+	}
+}
+function resolveWebSessionLabel() {
+	try {
+		if (typeof navigator === "undefined") return;
+		return navigator.userAgent.includes("Firefox") ? "Firefox" : navigator.userAgent.includes("Chrome") ? "Chrome" : navigator.userAgent.includes("Safari") ? "Safari" : navigator.userAgent;
+	} catch {
+		return;
+	}
+}
+/**
+* Browser file/blob storage built on top of Syncore web persistence.
+*/
+var BrowserFileStorageAdapter = class {
+	constructor(persistence, namespace) {
+		this.persistence = persistence;
+		this.namespace = namespace;
+	}
+	async put(id, input) {
+		const bytes = normalizeBinary(input.data);
+		await this.persistence.putFile(this.namespace, id, bytes, input.contentType ?? null);
+		return {
+			id,
+			path: `${this.persistence.storageProtocol}://${this.namespace}/${id}`,
+			size: bytes.byteLength,
+			contentType: input.contentType ?? null
+		};
+	}
+	async get(id) {
+		const file = await this.persistence.getFile(this.namespace, id);
+		if (!file) return null;
+		return {
+			id,
+			path: `${this.persistence.storageProtocol}://${this.namespace}/${id}`,
+			size: file.size,
+			contentType: file.contentType
+		};
+	}
+	async read(id) {
+		return (await this.persistence.getFile(this.namespace, id))?.bytes ?? null;
+	}
+	async delete(id) {
+		await this.persistence.deleteFile(this.namespace, id);
+	}
+	async list() {
+		return (await this.persistence.listFiles(this.namespace)).map((file) => ({
+			id: file.id,
+			path: `${this.persistence.storageProtocol}://${this.namespace}/${file.id}`,
+			size: file.size,
+			contentType: file.contentType
+		}));
+	}
+};
+function normalizeBinary(data) {
+	if (typeof data === "string") return new TextEncoder().encode(data);
+	if (data instanceof Uint8Array) return data;
+	return new Uint8Array(data);
+}
+//#endregion
+export { BrowserFileStorageAdapter, createBrowserSyncoreClient, createBrowserSyncoreRuntime, createBrowserWorkerRuntime, createWebSyncoreClient, createWebSyncoreRuntime, createWebWorkerRuntime };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../platform-web/src/index.ts"],"sourcesContent":["import {\n  type AnySyncoreSchema,\n  createDevtoolsRequestHandler,\n  type DevtoolsRequestHandler,\n  type DevtoolsSink,\n  SyncoreRuntime,\n  type SchedulerOptions,\n  type SyncoreCapabilities,\n  type SyncoreExperimentalPlugin,\n  type SyncoreRuntimeOptions,\n  type SyncoreStorageAdapter,\n  type StorageObject,\n  type StorageWriteInput\n} from \"@syncore/core\";\nimport {\n  type SyncoreDevtoolsMessage,\n  type SyncoreDevtoolsRequest,\n  type SyncoreDevtoolsSnapshot\n} from \"@syncore/devtools-protocol\";\nimport {\n  createWebPersistence,\n  type SyncoreWebPersistence,\n  type WebPersistenceMode\n} from \"./persistence.js\";\nimport { SqlJsDriver } from \"./sqljs.js\";\nimport {\n  attachWebWorkerRuntime,\n  type SyncoreWorkerMessageEndpoint\n} from \"./worker.js\";\nexport * from \"./worker.js\";\nexport * from \"./persistence.js\";\nexport * from \"./indexeddb.js\";\nexport * from \"./opfs.js\";\n\nexport type WebSyncoreSchema = AnySyncoreSchema;\nexport type BrowserSyncoreSchema = WebSyncoreSchema;\n\n/**\n * Options for constructing a browser Syncore runtime.\n *\n * Use this when you want to host the full runtime in a browser tab or worker.\n */\nexport interface CreateWebRuntimeOptions {\n  /** The schema for the local Syncore app. */\n  schema: WebSyncoreSchema;\n\n  /** The generated function registry for the local Syncore app. */\n  functions: SyncoreRuntimeOptions<WebSyncoreSchema>[\"functions\"];\n\n  /** Optional platform capabilities exposed to function handlers. */\n  capabilities?: SyncoreCapabilities;\n\n  /** Optional custom SQL driver. Defaults to SQL.js with local persistence. */\n  driver?: SyncoreRuntimeOptions<WebSyncoreSchema>[\"driver\"];\n\n  /** Optional custom file/blob storage adapter. */\n  storage?: SyncoreStorageAdapter;\n\n  /** Optional experimental plugins for runtime hooks. */\n  experimentalPlugins?: Array<SyncoreExperimentalPlugin<WebSyncoreSchema>>;\n\n  /** Optional explicit persistence implementation. */\n  persistence?: SyncoreWebPersistence;\n\n  /** Which browser persistence mode to use when Syncore creates one for you. */\n  persistenceMode?: WebPersistenceMode;\n\n  /** Logical database name for SQL.js and local storage namespaces. */\n  databaseName?: string;\n\n  /** Optional IndexedDB database name for persistence metadata. */\n  persistenceDatabaseName?: string;\n\n  /** Optional OPFS directory name for persistent files. */\n  opfsRootDirectoryName?: string;\n\n  /** Optional namespace for file/blob storage. */\n  storageNamespace?: string;\n\n  /** Optional direct wasm URL for SQL.js. */\n  wasmUrl?: string;\n\n  /** Optional callback for resolving SQL.js support files. */\n  locateFile?: (fileName: string) => string;\n\n  /** Optional runtime platform label shown in devtools snapshots. */\n  platform?: string;\n\n  /** Optional devtools sink used during development. */\n  devtools?: DevtoolsSink | false;\n\n  /** Optional scheduler configuration for jobs and recurring work. */\n  scheduler?: SchedulerOptions;\n}\n\n/**\n * Options for hosting a Syncore runtime inside a browser Worker.\n */\nexport interface CreateWebWorkerRuntimeOptions extends CreateWebRuntimeOptions {\n  /** The message endpoint exposed by the current worker global. */\n  endpoint: SyncoreWorkerMessageEndpoint;\n}\n\n/**\n * Options for constructing a browser Syncore runtime.\n */\nexport type CreateBrowserRuntimeOptions = CreateWebRuntimeOptions;\n\n/**\n * Options for hosting a Syncore runtime inside a browser Worker.\n */\nexport type CreateBrowserWorkerRuntimeOptions = CreateWebWorkerRuntimeOptions;\n\n/**\n * Create a full Syncore runtime directly in the browser.\n *\n * Most React apps should use a worker runtime instead so queries and SQLite work\n * stay off the main thread.\n */\nexport async function createWebSyncoreRuntime(\n  options: CreateWebRuntimeOptions\n): Promise<SyncoreRuntime<WebSyncoreSchema>> {\n  const persistence =\n    options.persistence ??\n    (await createWebPersistence({\n      ...(options.persistenceMode ? { mode: options.persistenceMode } : {}),\n      ...(options.persistenceDatabaseName\n        ? { indexedDbDatabaseName: options.persistenceDatabaseName }\n        : {}),\n      opfsRootDirectoryName:\n        options.opfsRootDirectoryName ?? options.databaseName ?? \"syncore\"\n    }));\n  const driver =\n    options.driver ??\n    (await SqlJsDriver.create({\n      databaseName: options.databaseName ?? \"syncore\",\n      persistence,\n      ...(options.wasmUrl ? { wasmUrl: options.wasmUrl } : {}),\n      ...(options.locateFile ? { locateFile: options.locateFile } : {})\n    }));\n  const storage =\n    options.storage ??\n    new BrowserFileStorageAdapter(\n      persistence,\n      options.storageNamespace ?? options.databaseName ?? \"syncore\"\n    );\n  const appName = resolveWebAppName();\n  const origin = resolveWebOrigin();\n  const sessionLabel = resolveWebSessionLabel();\n  const autoDevtools =\n    options.devtools === undefined && shouldAutoConnectDevtools()\n      ? (() => {\n          const sinkOptions: BrowserWebSocketDevtoolsSinkOptions = {\n            url: resolveDefaultDevtoolsUrl()\n          };\n          if (appName) {\n            sinkOptions.appName = appName;\n          }\n          if (origin) {\n            sinkOptions.origin = origin;\n          }\n          if (sessionLabel) {\n            sinkOptions.sessionLabel = sessionLabel;\n          }\n          return createBrowserWebSocketDevtoolsSink(sinkOptions);\n        })()\n      : undefined;\n  const resolvedDevtools =\n    options.devtools === false ? undefined : (options.devtools ?? autoDevtools);\n\n  const runtime = new SyncoreRuntime({\n    schema: options.schema,\n    functions: options.functions,\n    driver,\n    storage,\n    platform: options.platform ?? \"browser\",\n    ...(options.capabilities ? { capabilities: options.capabilities } : {}),\n    ...(resolvedDevtools ? { devtools: resolvedDevtools } : {}),\n    ...(options.experimentalPlugins\n      ? { experimentalPlugins: options.experimentalPlugins }\n      : {}),\n    ...(options.scheduler ? { scheduler: options.scheduler } : {})\n  });\n\n  if (autoDevtools) {\n    autoDevtools.attachRuntime(() => runtime.getDevtoolsSnapshot());\n    autoDevtools.attachRequestHandler(\n      createDevtoolsRequestHandler({\n        driver,\n        schema: options.schema,\n        functions: options.functions,\n        runtime\n      })\n    );\n  }\n\n  return runtime;\n}\n\n/**\n * Attach a Syncore runtime to a browser Worker endpoint.\n */\nexport function createWebWorkerRuntime(options: CreateWebWorkerRuntimeOptions) {\n  return attachWebWorkerRuntime({\n    endpoint: options.endpoint,\n    createRuntime: () => createWebSyncoreRuntime(options)\n  });\n}\n\n/**\n * Attach a Syncore runtime to a browser Worker endpoint.\n */\nexport function createBrowserWorkerRuntime(\n  options: CreateBrowserWorkerRuntimeOptions\n) {\n  return createWebWorkerRuntime(options);\n}\n\n/**\n * Create a client directly from a browser Syncore runtime.\n */\nexport function createWebSyncoreClient(\n  runtime: SyncoreRuntime<WebSyncoreSchema>\n) {\n  return runtime.createClient();\n}\n\n/**\n * Create a full Syncore runtime directly in the browser.\n */\nexport function createBrowserSyncoreRuntime(\n  options: CreateBrowserRuntimeOptions\n) {\n  return createWebSyncoreRuntime(options);\n}\n\n/**\n * Create a client directly from a browser Syncore runtime.\n */\nexport function createBrowserSyncoreClient(\n  runtime: SyncoreRuntime<BrowserSyncoreSchema>\n) {\n  return createWebSyncoreClient(runtime);\n}\n\nexport interface BrowserWebSocketDevtoolsSinkOptions {\n  url: string;\n  reconnectDelayMs?: number;\n  appName?: string;\n  origin?: string;\n  sessionLabel?: string;\n}\n\nexport interface BrowserWebSocketDevtoolsSink extends DevtoolsSink {\n  attachRuntime(getSnapshot: () => SyncoreDevtoolsSnapshot): void;\n  attachRequestHandler(handler: DevtoolsRequestHandler): void;\n  dispose(): void;\n}\n\nexport function createBrowserWebSocketDevtoolsSink(\n  options: BrowserWebSocketDevtoolsSinkOptions\n): BrowserWebSocketDevtoolsSink {\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 || typeof WebSocket === \"undefined\") {\n      return;\n    }\n    socket = new WebSocket(options.url);\n    socket.onopen = () => {\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.onmessage = (event) => {\n      if (typeof event.data !== \"string\") {\n        return;\n      }\n      const message = JSON.parse(event.data) 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.onclose = scheduleReconnect;\n    socket.onerror = () => {\n      socket?.close();\n    };\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        sendNow(nextMessage);\n      }\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({ type: \"event\", event });\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: BrowserWebSocketDevtoolsSinkOptions\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 shouldAutoConnectDevtools(): boolean {\n  if (typeof globalThis === \"undefined\") {\n    return false;\n  }\n  try {\n    return globalThis.location?.hostname === \"localhost\" ||\n      globalThis.location?.hostname === \"127.0.0.1\"\n      ? true\n      : Boolean(globalThis.location?.hostname?.endsWith?.(\".local\"));\n  } catch {\n    return false;\n  }\n}\n\nfunction resolveDefaultDevtoolsUrl(): string {\n  return \"ws://127.0.0.1:4311\";\n}\n\nfunction resolveWebOrigin(): string | undefined {\n  try {\n    return globalThis.location?.origin;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWebAppName(): string | undefined {\n  try {\n    return (\n      globalThis.location?.hostname ?? globalThis.document?.title ?? undefined\n    );\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWebSessionLabel(): string | undefined {\n  try {\n    if (typeof navigator === \"undefined\") {\n      return undefined;\n    }\n    return navigator.userAgent.includes(\"Firefox\")\n      ? \"Firefox\"\n      : navigator.userAgent.includes(\"Chrome\")\n        ? \"Chrome\"\n        : navigator.userAgent.includes(\"Safari\")\n          ? \"Safari\"\n          : navigator.userAgent;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Browser file/blob storage built on top of Syncore web persistence.\n */\nexport class BrowserFileStorageAdapter implements SyncoreStorageAdapter {\n  constructor(\n    private readonly persistence: SyncoreWebPersistence,\n    private readonly namespace: string\n  ) {}\n\n  async put(id: string, input: StorageWriteInput): Promise<StorageObject> {\n    const bytes = normalizeBinary(input.data);\n    await this.persistence.putFile(\n      this.namespace,\n      id,\n      bytes,\n      input.contentType ?? null\n    );\n    return {\n      id,\n      path: `${this.persistence.storageProtocol}://${this.namespace}/${id}`,\n      size: bytes.byteLength,\n      contentType: input.contentType ?? null\n    };\n  }\n\n  async get(id: string): Promise<StorageObject | null> {\n    const file = await this.persistence.getFile(this.namespace, id);\n    if (!file) {\n      return null;\n    }\n    return {\n      id,\n      path: `${this.persistence.storageProtocol}://${this.namespace}/${id}`,\n      size: file.size,\n      contentType: file.contentType\n    };\n  }\n\n  async read(id: string): Promise<Uint8Array | null> {\n    const file = await this.persistence.getFile(this.namespace, id);\n    return file?.bytes ?? null;\n  }\n\n  async delete(id: string): Promise<void> {\n    await this.persistence.deleteFile(this.namespace, id);\n  }\n\n  async list(): Promise<StorageObject[]> {\n    const files = await this.persistence.listFiles(this.namespace);\n    return files.map((file) => ({\n      id: file.id,\n      path: `${this.persistence.storageProtocol}://${this.namespace}/${file.id}`,\n      size: file.size,\n      contentType: file.contentType\n    }));\n  }\n}\n\nfunction normalizeBinary(data: StorageWriteInput[\"data\"]): Uint8Array {\n  if (typeof data === \"string\") {\n    return new TextEncoder().encode(data);\n  }\n  if (data instanceof Uint8Array) {\n    return data;\n  }\n  return new Uint8Array(data);\n}\n"],"mappings":"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"}

package/dist/platform-web/src/indexeddb.js

@@ -0,0 +1,125 @@
+//#region ../platform-web/src/indexeddb.ts
+var SyncoreIndexedDbPersistence = class {
+	storageProtocol = "idb";
+	databaseName;
+	constructor(options) {
+		this.databaseName = options?.databaseName ?? "syncore-web";
+	}
+	async loadDatabase(key) {
+		const record = await this.getRecord("databases", key);
+		if (!record) return null;
+		return new Uint8Array(record.bytes);
+	}
+	async saveDatabase(key, bytes) {
+		await this.putRecord("databases", {
+			key,
+			bytes: sliceToArrayBuffer(bytes),
+			updatedAt: Date.now()
+		});
+	}
+	async getFile(namespace, id) {
+		const record = await this.getRecord("files", createNamespacedKey(namespace, id));
+		if (!record) return null;
+		return {
+			id,
+			bytes: new Uint8Array(record.bytes),
+			contentType: record.contentType,
+			size: record.size
+		};
+	}
+	async putFile(namespace, id, bytes, contentType) {
+		await this.putRecord("files", {
+			key: createNamespacedKey(namespace, id),
+			bytes: sliceToArrayBuffer(bytes),
+			contentType,
+			size: bytes.byteLength,
+			updatedAt: Date.now()
+		});
+	}
+	async deleteFile(namespace, id) {
+		await this.deleteRecord("files", createNamespacedKey(namespace, id));
+	}
+	async listFiles(namespace) {
+		const prefix = `${namespace}:`;
+		return (await this.listRecords("files")).filter((record) => record.key.startsWith(prefix)).map((record) => ({
+			id: record.key.slice(prefix.length),
+			bytes: new Uint8Array(record.bytes),
+			contentType: record.contentType,
+			size: record.size
+		}));
+	}
+	async getDatabase() {
+		const indexedDb = globalThis.indexedDB;
+		if (!indexedDb) throw new Error("IndexedDB is not available in this environment.");
+		return new Promise((resolve, reject) => {
+			const request = indexedDb.open(this.databaseName, 1);
+			request.onupgradeneeded = () => {
+				const database = request.result;
+				if (!database.objectStoreNames.contains("databases")) database.createObjectStore("databases", { keyPath: "key" });
+				if (!database.objectStoreNames.contains("files")) database.createObjectStore("files", { keyPath: "key" });
+			};
+			request.onsuccess = () => resolve(request.result);
+			request.onerror = () => reject(request.error ?? /* @__PURE__ */ new Error("Failed to open IndexedDB."));
+		});
+	}
+	async getRecord(storeName, key) {
+		const database = await this.getDatabase();
+		try {
+			return await new Promise((resolve, reject) => {
+				const request = database.transaction(storeName, "readonly").objectStore(storeName).get(key);
+				request.onsuccess = () => resolve(request.result ?? null);
+				request.onerror = () => reject(request.error ?? /* @__PURE__ */ new Error(`Failed to read ${storeName}/${key}.`));
+			});
+		} finally {
+			database.close();
+		}
+	}
+	async putRecord(storeName, record) {
+		const database = await this.getDatabase();
+		try {
+			await new Promise((resolve, reject) => {
+				const transaction = database.transaction(storeName, "readwrite");
+				transaction.oncomplete = () => resolve();
+				transaction.onerror = () => reject(transaction.error ?? /* @__PURE__ */ new Error(`Failed to write ${storeName}/${record.key}.`));
+				transaction.objectStore(storeName).put(record);
+			});
+		} finally {
+			database.close();
+		}
+	}
+	async deleteRecord(storeName, key) {
+		const database = await this.getDatabase();
+		try {
+			await new Promise((resolve, reject) => {
+				const transaction = database.transaction(storeName, "readwrite");
+				transaction.oncomplete = () => resolve();
+				transaction.onerror = () => reject(transaction.error ?? /* @__PURE__ */ new Error(`Failed to delete ${storeName}/${key}.`));
+				transaction.objectStore(storeName).delete(key);
+			});
+		} finally {
+			database.close();
+		}
+	}
+	async listRecords(storeName) {
+		const database = await this.getDatabase();
+		try {
+			return await new Promise((resolve, reject) => {
+				const request = database.transaction(storeName, "readonly").objectStore(storeName).getAll();
+				request.onsuccess = () => resolve(request.result ?? []);
+				request.onerror = () => reject(request.error ?? /* @__PURE__ */ new Error(`Failed to list records from ${storeName}.`));
+			});
+		} finally {
+			database.close();
+		}
+	}
+};
+function createNamespacedKey(namespace, id) {
+	return `${namespace}:${id}`;
+}
+function sliceToArrayBuffer(bytes) {
+	return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+//#endregion
+export { SyncoreIndexedDbPersistence };
+
+//# sourceMappingURL=indexeddb.js.map

package/dist/platform-web/src/indexeddb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.js","names":[],"sources":["../../../../platform-web/src/indexeddb.ts"],"sourcesContent":["import type { SyncoreWebPersistence, StoredWebFile } from \"./persistence.js\";\r\n\r\nexport interface IndexedDbPersistenceOptions {\r\n  databaseName?: string;\r\n}\r\n\r\ntype StoredDatabaseRecord = {\r\n  key: string;\r\n  bytes: ArrayBuffer;\r\n  updatedAt: number;\r\n};\r\n\r\ntype StoredFileRecord = {\r\n  key: string;\r\n  bytes: ArrayBuffer;\r\n  contentType: string | null;\r\n  size: number;\r\n  updatedAt: number;\r\n};\r\n\r\nexport class SyncoreIndexedDbPersistence implements SyncoreWebPersistence {\r\n  readonly storageProtocol = \"idb\" as const;\r\n  private readonly databaseName: string;\r\n\r\n  constructor(options?: IndexedDbPersistenceOptions) {\r\n    this.databaseName = options?.databaseName ?? \"syncore-web\";\r\n  }\r\n\r\n  async loadDatabase(key: string): Promise<Uint8Array | null> {\r\n    const record = await this.getRecord<StoredDatabaseRecord>(\"databases\", key);\r\n    if (!record) {\r\n      return null;\r\n    }\r\n    return new Uint8Array(record.bytes);\r\n  }\r\n\r\n  async saveDatabase(key: string, bytes: Uint8Array): Promise<void> {\r\n    await this.putRecord<StoredDatabaseRecord>(\"databases\", {\r\n      key,\r\n      bytes: sliceToArrayBuffer(bytes),\r\n      updatedAt: Date.now()\r\n    });\r\n  }\r\n\r\n  async getFile(\r\n    namespace: string,\r\n    id: string\r\n  ): Promise<StoredWebFile | null> {\r\n    const record = await this.getRecord<StoredFileRecord>(\r\n      \"files\",\r\n      createNamespacedKey(namespace, id)\r\n    );\r\n    if (!record) {\r\n      return null;\r\n    }\r\n    return {\r\n      id,\r\n      bytes: new Uint8Array(record.bytes),\r\n      contentType: record.contentType,\r\n      size: record.size\r\n    };\r\n  }\r\n\r\n  async putFile(\r\n    namespace: string,\r\n    id: string,\r\n    bytes: Uint8Array,\r\n    contentType: string | null\r\n  ): Promise<void> {\r\n    await this.putRecord<StoredFileRecord>(\"files\", {\r\n      key: createNamespacedKey(namespace, id),\r\n      bytes: sliceToArrayBuffer(bytes),\r\n      contentType,\r\n      size: bytes.byteLength,\r\n      updatedAt: Date.now()\r\n    });\r\n  }\r\n\r\n  async deleteFile(namespace: string, id: string): Promise<void> {\r\n    await this.deleteRecord(\"files\", createNamespacedKey(namespace, id));\r\n  }\r\n\r\n  async listFiles(namespace: string): Promise<StoredWebFile[]> {\r\n    const prefix = `${namespace}:`;\r\n    const records = await this.listRecords<StoredFileRecord>(\"files\");\r\n    return records\r\n      .filter((record) => record.key.startsWith(prefix))\r\n      .map((record) => ({\r\n        id: record.key.slice(prefix.length),\r\n        bytes: new Uint8Array(record.bytes),\r\n        contentType: record.contentType,\r\n        size: record.size\r\n      }));\r\n  }\r\n\r\n  private async getDatabase(): Promise<IDBDatabase> {\r\n    const indexedDb = globalThis.indexedDB;\r\n    if (!indexedDb) {\r\n      throw new Error(\"IndexedDB is not available in this environment.\");\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      const request = indexedDb.open(this.databaseName, 1);\r\n      request.onupgradeneeded = () => {\r\n        const database = request.result;\r\n        if (!database.objectStoreNames.contains(\"databases\")) {\r\n          database.createObjectStore(\"databases\", { keyPath: \"key\" });\r\n        }\r\n        if (!database.objectStoreNames.contains(\"files\")) {\r\n          database.createObjectStore(\"files\", { keyPath: \"key\" });\r\n        }\r\n      };\r\n      request.onsuccess = () => resolve(request.result);\r\n      request.onerror = () =>\r\n        reject(request.error ?? new Error(\"Failed to open IndexedDB.\"));\r\n    });\r\n  }\r\n\r\n  private async getRecord<TRecord>(\r\n    storeName: \"databases\" | \"files\",\r\n    key: string\r\n  ): Promise<TRecord | null> {\r\n    const database = await this.getDatabase();\r\n    try {\r\n      return await new Promise<TRecord | null>((resolve, reject) => {\r\n        const transaction = database.transaction(storeName, \"readonly\");\r\n        const request = transaction.objectStore(storeName).get(key);\r\n        request.onsuccess = () => resolve((request.result as TRecord | undefined) ?? null);\r\n        request.onerror = () =>\r\n          reject(request.error ?? new Error(`Failed to read ${storeName}/${key}.`));\r\n      });\r\n    } finally {\r\n      database.close();\r\n    }\r\n  }\r\n\r\n  private async putRecord<TRecord extends { key: string }>(\r\n    storeName: \"databases\" | \"files\",\r\n    record: TRecord\r\n  ): Promise<void> {\r\n    const database = await this.getDatabase();\r\n    try {\r\n      await new Promise<void>((resolve, reject) => {\r\n        const transaction = database.transaction(storeName, \"readwrite\");\r\n        transaction.oncomplete = () => resolve();\r\n        transaction.onerror = () =>\r\n          reject(transaction.error ?? new Error(`Failed to write ${storeName}/${record.key}.`));\r\n        transaction.objectStore(storeName).put(record);\r\n      });\r\n    } finally {\r\n      database.close();\r\n    }\r\n  }\r\n\r\n  private async deleteRecord(\r\n    storeName: \"databases\" | \"files\",\r\n    key: string\r\n  ): Promise<void> {\r\n    const database = await this.getDatabase();\r\n    try {\r\n      await new Promise<void>((resolve, reject) => {\r\n        const transaction = database.transaction(storeName, \"readwrite\");\r\n        transaction.oncomplete = () => resolve();\r\n        transaction.onerror = () =>\r\n          reject(transaction.error ?? new Error(`Failed to delete ${storeName}/${key}.`));\r\n        transaction.objectStore(storeName).delete(key);\r\n      });\r\n    } finally {\r\n      database.close();\r\n    }\r\n  }\r\n\r\n  private async listRecords<TRecord>(\r\n    storeName: \"databases\" | \"files\"\r\n  ): Promise<TRecord[]> {\r\n    const database = await this.getDatabase();\r\n    try {\r\n      return await new Promise<TRecord[]>((resolve, reject) => {\r\n        const transaction = database.transaction(storeName, \"readonly\");\r\n        const request = transaction.objectStore(storeName).getAll();\r\n        request.onsuccess = () => resolve((request.result as TRecord[] | undefined) ?? []);\r\n        request.onerror = () =>\r\n          reject(request.error ?? new Error(`Failed to list records from ${storeName}.`));\r\n      });\r\n    } finally {\r\n      database.close();\r\n    }\r\n  }\r\n}\r\n\r\nfunction createNamespacedKey(namespace: string, id: string): string {\r\n  return `${namespace}:${id}`;\r\n}\r\n\r\nfunction sliceToArrayBuffer(bytes: Uint8Array): ArrayBuffer {\r\n  return bytes.buffer.slice(\r\n    bytes.byteOffset,\r\n    bytes.byteOffset + bytes.byteLength\r\n  ) as ArrayBuffer;\r\n}\r\n"],"mappings":"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"}

package/dist/platform-web/src/opfs.js

@@ -0,0 +1,146 @@
+//#region ../platform-web/src/opfs.ts
+var SyncoreOpfsPersistence = class {
+	storageProtocol = "opfs";
+	rootDirectoryPromise;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	async loadDatabase(key) {
+		const handle = await this.getOptionalFileHandle(["databases"], `${encodePathComponent(key)}.sqlite`);
+		if (!handle) return null;
+		return readFileBytes(handle);
+	}
+	async saveDatabase(key, bytes) {
+		await writeBytes(await (await this.ensureDirectory(["databases"])).getFileHandle(`${encodePathComponent(key)}.sqlite`, { create: true }), bytes);
+	}
+	async getFile(namespace, id) {
+		const directory = await this.getOptionalDirectory(["files", encodePathComponent(namespace)]);
+		if (!directory) return null;
+		const fileName = `${encodePathComponent(id)}.bin`;
+		const metadataName = `${encodePathComponent(id)}.meta.json`;
+		const fileHandle = await this.getOptionalFileHandleFromDirectory(directory, fileName);
+		if (!fileHandle) return null;
+		const [bytes, metadata] = await Promise.all([readFileBytes(fileHandle), this.readMetadata(directory, metadataName)]);
+		return {
+			id,
+			bytes,
+			size: bytes.byteLength,
+			contentType: metadata?.contentType ?? null
+		};
+	}
+	async putFile(namespace, id, bytes, contentType) {
+		const directory = await this.ensureDirectory(["files", encodePathComponent(namespace)]);
+		const encodedId = encodePathComponent(id);
+		await writeBytes(await directory.getFileHandle(`${encodedId}.bin`, { create: true }), bytes);
+		await writeText(await directory.getFileHandle(`${encodedId}.meta.json`, { create: true }), JSON.stringify({ contentType }));
+	}
+	async deleteFile(namespace, id) {
+		const directory = await this.getOptionalDirectory(["files", encodePathComponent(namespace)]);
+		if (!directory) return;
+		const encodedId = encodePathComponent(id);
+		await removeEntryIfExists(directory, `${encodedId}.bin`);
+		await removeEntryIfExists(directory, `${encodedId}.meta.json`);
+	}
+	async listFiles(namespace) {
+		const directory = await this.getOptionalDirectory(["files", encodePathComponent(namespace)]);
+		if (!directory) return [];
+		const files = [];
+		const iterableDirectory = directory;
+		for await (const [name, handle] of iterableDirectory.entries()) {
+			if (handle.kind !== "file" || !name.endsWith(".bin")) continue;
+			const encodedId = name.slice(0, -4);
+			const id = decodeURIComponent(encodedId);
+			const bytes = await readFileBytes(handle);
+			const metadata = await this.readMetadata(directory, `${encodedId}.meta.json`);
+			files.push({
+				id,
+				bytes,
+				size: bytes.byteLength,
+				contentType: metadata?.contentType ?? null
+			});
+		}
+		return files;
+	}
+	async ensureDirectory(pathSegments) {
+		let directory = await this.getRootDirectory();
+		for (const segment of pathSegments) directory = await directory.getDirectoryHandle(segment, { create: true });
+		return directory;
+	}
+	async getOptionalDirectory(pathSegments) {
+		try {
+			let directory = await this.getRootDirectory();
+			for (const segment of pathSegments) directory = await directory.getDirectoryHandle(segment);
+			return directory;
+		} catch (error) {
+			if (isNotFoundError(error)) return null;
+			throw error;
+		}
+	}
+	async getOptionalFileHandle(pathSegments, fileName) {
+		const directory = await this.getOptionalDirectory(pathSegments);
+		if (!directory) return null;
+		return this.getOptionalFileHandleFromDirectory(directory, fileName);
+	}
+	async getOptionalFileHandleFromDirectory(directory, fileName) {
+		try {
+			return await directory.getFileHandle(fileName);
+		} catch (error) {
+			if (isNotFoundError(error)) return null;
+			throw error;
+		}
+	}
+	async readMetadata(directory, fileName) {
+		const handle = await this.getOptionalFileHandleFromDirectory(directory, fileName);
+		if (!handle) return null;
+		const bytes = await readFileBytes(handle);
+		return JSON.parse(new TextDecoder().decode(bytes));
+	}
+	async getRootDirectory() {
+		if (!this.rootDirectoryPromise) this.rootDirectoryPromise = (async () => {
+			const storageManager = getOpfsStorageManager();
+			if (!storageManager?.getDirectory) throw new Error("OPFS is not available in this environment.");
+			return (await storageManager.getDirectory()).getDirectoryHandle(this.options.rootDirectoryName ?? "syncore", { create: true });
+		})();
+		return this.rootDirectoryPromise;
+	}
+};
+async function readFileBytes(handle) {
+	const file = await handle.getFile();
+	return new Uint8Array(await file.arrayBuffer());
+}
+async function writeBytes(handle, bytes) {
+	const writable = await handle.createWritable();
+	try {
+		await writable.write(sliceToArrayBuffer(bytes));
+		await writable.truncate(bytes.byteLength);
+	} finally {
+		await writable.close();
+	}
+}
+async function writeText(handle, value) {
+	await writeBytes(handle, new TextEncoder().encode(value));
+}
+async function removeEntryIfExists(directory, name) {
+	try {
+		await directory.removeEntry(name);
+	} catch (error) {
+		if (!isNotFoundError(error)) throw error;
+	}
+}
+function encodePathComponent(value) {
+	return encodeURIComponent(value);
+}
+function sliceToArrayBuffer(bytes) {
+	return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+function getOpfsStorageManager() {
+	if (typeof navigator === "undefined") return;
+	return navigator.storage;
+}
+function isNotFoundError(error) {
+	return typeof error === "object" && error !== null && "name" in error && error.name === "NotFoundError";
+}
+//#endregion
+export { SyncoreOpfsPersistence };
+
+//# sourceMappingURL=opfs.js.map