syncorejs 0.2.3 → 0.2.5

package/dist/_vendor/platform-web/index.d.ts

@@ -1,4 +1,4 @@
-import { CreateWebPersistenceOptions, StoredWebFile, SyncoreWebPersistence, WebPersistenceMode, createWebPersistence, isOpfsAvailable } from "./persistence.js";
+import { CreateWebPersistenceOptions, StoredWebFile, StoredWebFileMetadata, StoredWebFileRange, SyncoreWebPersistence, WebPersistenceMode, createWebPersistence, isOpfsAvailable } from "./persistence.js";
 import { BroadcastChannelExternalChangeSignal, BroadcastChannelExternalChangeSignalOptions, SqlJsExternalChangeApplier, SqlJsExternalChangeApplierOptions, createDefaultSyncChannelName } from "./external-change.js";
 import { AttachWebWorkerRuntimeOptions, AttachedWebWorkerRuntime, CreateWebWorkerClientProviderOptions, ManagedWebWorkerClient, SyncoreWebWorkerClient, SyncoreWorkerMessageEndpoint, WebWorkerSyncoreSchema, WorkerQueryWatch, attachWebWorkerRuntime, createManagedWebWorkerClient, createSyncoreWebWorkerClient, createWebWorkerClient } from "./worker.js";
 import { IndexedDbPersistenceOptions, SyncoreIndexedDbPersistence } from "./indexeddb.js";
@@ -66,7 +66,8 @@ interface CreateWebRuntimeOptions<TSchema extends WebSyncoreSchema = WebSyncoreS
   driver?: SyncoreRuntimeOptions<TSchema>["driver"];
   /**
    * Custom blob storage adapter. Defaults to `BrowserFileStorageAdapter`
-   * backed by the same persistence layer as the SQL driver.
+   * only when the resolved persistence layer is OPFS. IndexedDB persistence is
+   * data-only unless a custom adapter is provided explicitly.
    *
    * Override when you want to store files in a different location (e.g. an
    * in-memory adapter for tests).
@@ -203,8 +204,8 @@ interface WebExternalChangeSupport {
  * Create a full Syncore runtime directly in the browser (main thread or
  * shared worker).
  *
- * This function sets up SQL.js, the OPFS/IndexedDB persistence layer, blob
- * storage, cross-tab change synchronisation via `BroadcastChannel`, and
+ * This function sets up SQL.js, the OPFS/IndexedDB persistence layer,
+ * OPFS-backed blob storage when available, cross-tab change synchronisation via `BroadcastChannel`, and
  * auto-connects to the devtools server in development.
  *
  * @remarks
@@ -243,7 +244,7 @@ declare function createWebExternalChangeSupport(options: {
  *
  * Behaves identically to {@link createWebExternalChangeSupport} but accepts
  * the same options shape used by `createExpoSyncoreRuntime`, making it easy
- * to share config when bootstrapping an Expo web runtime.\
+ * to share config when bootstrapping an Expo web runtime.
  *
  * Called internally by the Expo platform adapter. Use directly only when
  * constructing the runtime outside of `createExpoSyncoreRuntime`.
@@ -348,7 +349,7 @@ interface BrowserWebSocketDevtoolsSinkOptions {
   capabilities?: SyncoreDevtoolsCapabilities;
 }
 /**
- * A {@link DevtoolsSink} that forwards runtime events to the Syncore devtools
+ * A DevtoolsSink that forwards runtime events to the Syncore devtools
  * dashboard over a persistent WebSocket connection with auto-reconnect.
  *
  * Returned by {@link createBrowserWebSocketDevtoolsSink}. You typically do not
@@ -389,8 +390,8 @@ declare function createBrowserWebSocketDevtoolsSink(options: BrowserWebSocketDev
 /**
  * Browser file/blob storage adapter backed by `SyncoreWebPersistence`.
  *
- * Stores binary blobs (images, documents, etc.) in the same OPFS or
- * IndexedDB store as the SQLite database. Pass an instance to
+ * Stores binary blobs (images, documents, etc.) in OPFS alongside the SQLite
+ * database. Pass an instance to
  * `CreateWebRuntimeOptions.storage` to enable Syncore's Storage API
  * (`ctx.storage.put`, `ctx.storage.get`, etc.) in browser functions.
  *
@@ -398,7 +399,7 @@ declare function createBrowserWebSocketDevtoolsSink(options: BrowserWebSocketDev
  * const runtime = await createWebSyncoreRuntime({
  *   schema,
  *   functions,
- *   storage: (persistence) => new BrowserFileStorageAdapter(persistence, "files"),
+ *   storage: new BrowserFileStorageAdapter(persistence, "files"),
  * });
  * ```
  */
@@ -409,9 +410,11 @@ declare class BrowserFileStorageAdapter implements SyncoreStorageAdapter {
   put(id: string, input: StorageWriteInput): Promise<StorageObject>;
   get(id: string): Promise<StorageObject | null>;
   read(id: string): Promise<Uint8Array | null>;
+  supportsRange(): boolean;
+  readRange(id: string, offset: number, length: number): Promise<Uint8Array | null>;
   delete(id: string): Promise<void>;
   list(): Promise<StorageObject[]>;
 }
 //#endregion
-export { AttachWebWorkerRuntimeOptions, AttachedWebWorkerRuntime, BroadcastChannelExternalChangeSignal, BroadcastChannelExternalChangeSignalOptions, BrowserFileStorageAdapter, BrowserSyncoreSchema, BrowserWebSocketDevtoolsSink, BrowserWebSocketDevtoolsSinkOptions, CreateBrowserRuntimeOptions, CreateBrowserWorkerRuntimeOptions, CreateWebPersistenceOptions, CreateWebRuntimeOptions, CreateWebWorkerClientProviderOptions, CreateWebWorkerRuntimeOptions, IndexedDbPersistenceOptions, ManagedWebWorkerClient, OpfsPersistenceOptions, SqlJsExternalChangeApplier, SqlJsExternalChangeApplierOptions, StoredWebFile, SyncoreIndexedDbPersistence, SyncoreOpfsPersistence, SyncoreWebPersistence, SyncoreWebWorkerClient, SyncoreWorkerMessageEndpoint, WebExternalChangeSupport, WebPersistenceMode, WebSyncoreSchema, WebWorkerSyncoreSchema, WorkerQueryWatch, attachWebWorkerRuntime, createBrowserSyncoreClient, createBrowserSyncoreRuntime, createBrowserWebSocketDevtoolsSink, createBrowserWorkerRuntime, createDefaultSyncChannelName, createExpoWebExternalChangeSupport, createManagedWebWorkerClient, createSyncoreWebWorkerClient, createWebExternalChangeSupport, createWebPersistence, createWebSyncoreClient, createWebSyncoreRuntime, createWebWorkerClient, createWebWorkerRuntime, isOpfsAvailable };
+export { AttachWebWorkerRuntimeOptions, AttachedWebWorkerRuntime, BroadcastChannelExternalChangeSignal, BroadcastChannelExternalChangeSignalOptions, BrowserFileStorageAdapter, BrowserSyncoreSchema, BrowserWebSocketDevtoolsSink, BrowserWebSocketDevtoolsSinkOptions, CreateBrowserRuntimeOptions, CreateBrowserWorkerRuntimeOptions, CreateWebPersistenceOptions, CreateWebRuntimeOptions, CreateWebWorkerClientProviderOptions, CreateWebWorkerRuntimeOptions, IndexedDbPersistenceOptions, ManagedWebWorkerClient, OpfsPersistenceOptions, SqlJsExternalChangeApplier, SqlJsExternalChangeApplierOptions, StoredWebFile, StoredWebFileMetadata, StoredWebFileRange, SyncoreIndexedDbPersistence, SyncoreOpfsPersistence, SyncoreWebPersistence, SyncoreWebWorkerClient, SyncoreWorkerMessageEndpoint, WebExternalChangeSupport, WebPersistenceMode, WebSyncoreSchema, WebWorkerSyncoreSchema, WorkerQueryWatch, attachWebWorkerRuntime, createBrowserSyncoreClient, createBrowserSyncoreRuntime, createBrowserWebSocketDevtoolsSink, createBrowserWorkerRuntime, createDefaultSyncChannelName, createExpoWebExternalChangeSupport, createManagedWebWorkerClient, createSyncoreWebWorkerClient, createWebExternalChangeSupport, createWebPersistence, createWebSyncoreClient, createWebSyncoreRuntime, createWebWorkerClient, createWebWorkerRuntime, isOpfsAvailable };
 //# sourceMappingURL=index.d.ts.map

package/dist/_vendor/platform-web/index.d.ts.map

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

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

@@ -14,8 +14,8 @@ const DATA_SOURCE_ALIAS_PREFIX = "data-source-alias";
 * Create a full Syncore runtime directly in the browser (main thread or
 * shared worker).
 *
-* This function sets up SQL.js, the OPFS/IndexedDB persistence layer, blob
-* storage, cross-tab change synchronisation via `BroadcastChannel`, and
+* This function sets up SQL.js, the OPFS/IndexedDB persistence layer,
+* OPFS-backed blob storage when available, cross-tab change synchronisation via `BroadcastChannel`, and
 * auto-connects to the devtools server in development.
 *
 * @remarks
@@ -43,7 +43,9 @@ async function createWebSyncoreRuntime(options) {
 		...wasmUrl ? { wasmUrl } : {},
 		...options.locateFile ? { locateFile: options.locateFile } : {}
 	});
-	const storage = options.storage ?? new BrowserFileStorageAdapter(persistence, options.storageNamespace ?? options.databaseName ?? "syncore");
+	const storageNamespace = options.storageNamespace ?? options.databaseName ?? "syncore";
+	const storage = options.storage ?? (persistence.storageProtocol === "opfs" ? new BrowserFileStorageAdapter(persistence, storageNamespace) : new UnavailableBrowserStorageAdapter(BROWSER_STORAGE_UNAVAILABLE_REASON));
+	const runtimeCapabilities = createBrowserRuntimeCapabilities(persistence, storage, Boolean(options.storage));
 	const externalChangeSupport = createWebExternalChangeSupport({
 		databaseName: options.databaseName ?? "syncore",
 		persistence,
@@ -69,7 +71,7 @@ async function createWebSyncoreRuntime(options) {
 			databaseLabel,
 			dataSourceAlias,
 			storageIdentity,
-			capabilities: createBrowserDevtoolsCapabilities()
+			capabilities: createBrowserDevtoolsCapabilities(runtimeCapabilities)
 		};
 		if (appName) sinkOptions.appName = appName;
 		if (origin) sinkOptions.origin = origin;
@@ -94,6 +96,7 @@ async function createWebSyncoreRuntime(options) {
 		...externalChangeSupport.applier ? { externalChangeApplier: externalChangeSupport.applier } : {},
 		platform: options.platform ?? "browser",
 		...options.capabilities ? { capabilities: options.capabilities } : {},
+		runtimeCapabilities,
 		...resolvedDevtools ? { devtools: resolvedDevtools } : {},
 		...options.scheduler ? { scheduler: options.scheduler } : {}
 	});
@@ -151,7 +154,7 @@ function createWebExternalChangeSupport(options) {
 *
 * Behaves identically to {@link createWebExternalChangeSupport} but accepts
 * the same options shape used by `createExpoSyncoreRuntime`, making it easy
-* to share config when bootstrapping an Expo web runtime.\
+* to share config when bootstrapping an Expo web runtime.
 *
 * Called internally by the Expo platform adapter. Use directly only when
 * constructing the runtime outside of `createExpoSyncoreRuntime`.
@@ -437,7 +440,22 @@ function withRuntimeSummaryMeta(summary, options) {
 		capabilities: options.capabilities ?? createBrowserDevtoolsCapabilities()
 	};
 }
-function createBrowserDevtoolsCapabilities() {
+function createBrowserRuntimeCapabilities(persistence, storage, hasExplicitStorage) {
+	if (!hasExplicitStorage && persistence.storageProtocol !== "opfs") return { storage: {
+		available: false,
+		reason: BROWSER_STORAGE_UNAVAILABLE_REASON,
+		protocol: persistence.storageProtocol,
+		supportsRange: false
+	} };
+	return { storage: {
+		available: true,
+		protocol: hasExplicitStorage ? "custom" : persistence.storageProtocol,
+		...storage.supportsRange ? { supportsRange: storage.supportsRange() !== false } : {}
+	} };
+}
+function createBrowserDevtoolsCapabilities(runtimeCapabilities) {
+	const storageCapability = runtimeCapabilities?.storage;
+	const storageAvailable = storageCapability?.available !== false;
 	return {
 		sql: {
 			read: false,
@@ -450,6 +468,14 @@ function createBrowserDevtoolsCapabilities() {
 			mutate: true,
 			importExport: true
 		},
+		storage: {
+			browse: storageAvailable,
+			download: storageAvailable,
+			readRange: storageCapability?.supportsRange === true,
+			delete: storageAvailable,
+			maxPreviewBytes: 8e4,
+			...!storageAvailable && storageCapability?.reason ? { reason: storageCapability.reason } : {}
+		},
 		scheduler: {
 			read: true,
 			edit: true
@@ -706,14 +732,15 @@ const SESSION_NOUNS = [
 	"Thunder",
 	"Drift"
 ];
+const BROWSER_STORAGE_UNAVAILABLE_REASON = "Browser file storage requires OPFS. IndexedDB is used for data only.";
 function generateUniqueSessionName() {
 	return `${SESSION_ADJECTIVES[Math.floor(Math.random() * SESSION_ADJECTIVES.length)]} ${SESSION_NOUNS[Math.floor(Math.random() * SESSION_NOUNS.length)]}`;
 }
 /**
 * Browser file/blob storage adapter backed by `SyncoreWebPersistence`.
 *
-* Stores binary blobs (images, documents, etc.) in the same OPFS or
-* IndexedDB store as the SQLite database. Pass an instance to
+* Stores binary blobs (images, documents, etc.) in OPFS alongside the SQLite
+* database. Pass an instance to
 * `CreateWebRuntimeOptions.storage` to enable Syncore's Storage API
 * (`ctx.storage.put`, `ctx.storage.get`, etc.) in browser functions.
 *
@@ -721,7 +748,7 @@ function generateUniqueSessionName() {
 * const runtime = await createWebSyncoreRuntime({
 *   schema,
 *   functions,
-*   storage: (persistence) => new BrowserFileStorageAdapter(persistence, "files"),
+*   storage: new BrowserFileStorageAdapter(persistence, "files"),
 * });
 * ```
 */
@@ -731,6 +758,7 @@ var BrowserFileStorageAdapter = class {
 	constructor(persistence, namespace) {
 		this.persistence = persistence;
 		this.namespace = namespace;
+		if (persistence.storageProtocol !== "opfs") throw new Error(BROWSER_STORAGE_UNAVAILABLE_REASON);
 	}
 	async put(id, input) {
 		const bytes = normalizeBinary(input.data);
@@ -755,11 +783,18 @@ var BrowserFileStorageAdapter = class {
 	async read(id) {
 		return (await this.persistence.getFile(this.namespace, id))?.bytes ?? null;
 	}
+	supportsRange() {
+		return Boolean(this.persistence.getFileRange);
+	}
+	async readRange(id, offset, length) {
+		if (!this.persistence.getFileRange) return null;
+		return (await this.persistence.getFileRange(this.namespace, id, offset, length))?.bytes ?? null;
+	}
 	async delete(id) {
 		await this.persistence.deleteFile(this.namespace, id);
 	}
 	async list() {
-		return (await this.persistence.listFiles(this.namespace)).map((file) => ({
+		return (this.persistence.listFileMetadata ? await this.persistence.listFileMetadata(this.namespace) : await this.persistence.listFiles(this.namespace)).map((file) => ({
 			id: file.id,
 			path: `${this.persistence.storageProtocol}://${this.namespace}/${file.id}`,
 			size: file.size,
@@ -767,6 +802,27 @@ var BrowserFileStorageAdapter = class {
 		}));
 	}
 };
+var UnavailableBrowserStorageAdapter = class {
+	reason;
+	constructor(reason) {
+		this.reason = reason;
+	}
+	async put() {
+		throw new Error(this.reason);
+	}
+	async get() {
+		throw new Error(this.reason);
+	}
+	async read() {
+		throw new Error(this.reason);
+	}
+	supportsRange() {
+		return false;
+	}
+	async delete() {
+		throw new Error(this.reason);
+	}
+};
 function normalizeBinary(data) {
 	if (typeof data === "string") return new TextEncoder().encode(data);
 	if (data instanceof Uint8Array) return data;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["scope"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  createDevtoolsCommandHandler,\n  createDevtoolsSubscriptionHost,\n  type DevtoolsCommandHandler,\n  type DevtoolsSink,\n  type DevtoolsSubscriptionHost,\n  type SyncoreDataModel,\n  generateId,\n  SyncoreRuntime,\n  type SchedulerOptions,\n  type SyncoreCapabilities,\n  type SyncoreRuntimeOptions,\n  type SyncoreStorageAdapter,\n  type StorageObject,\n  type StorageWriteInput\n} from \"@syncore/core\";\nimport {\n  SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION,\n  SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION,\n  SYNCORE_DEVTOOLS_PROTOCOL_VERSION,\n  type SyncoreDevtoolsClientMessage,\n  type SyncoreDevtoolsCapabilities,\n  type SyncoreDevtoolsMessage,\n  type SyncoreRuntimeSummary\n} from \"@syncore/devtools-protocol\";\nimport {\n  createWebPersistence,\n  type SyncoreWebPersistence,\n  type WebPersistenceMode\n} from \"./persistence.js\";\nimport {\n  BroadcastChannelExternalChangeSignal,\n  createDefaultSyncChannelName,\n  SqlJsExternalChangeApplier\n} from \"./external-change.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\";\nexport * from \"./external-change.js\";\n\n/**\n * Schema type constraint for web-platform Syncore runtimes.\n *\n * Pass any schema produced by `defineSchema()` where this type is expected.\n * Defaults to the unconstrained `SyncoreDataModel` when omitted.\n */\nexport type WebSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = TSchema;\n/**\n * Alias of {@link WebSyncoreSchema} for the `syncorejs/browser` surface.\n * @see WebSyncoreSchema\n */\nexport type BrowserSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = WebSyncoreSchema<TSchema>;\n\nconst DEVTOOLS_META_NAMESPACE = \"__syncore_devtools_meta__\";\nconst STORAGE_SCOPE_ID_PREFIX = \"storage-scope\";\nconst DATA_SOURCE_ALIAS_PREFIX = \"data-source-alias\";\n\n/**\n * Options for constructing a browser Syncore runtime.\n *\n * Use this when you want to host the full runtime directly in a browser tab or\n * dedicated Web Worker. In most React or Svelte apps you should call\n * `createWebWorkerSyncoreRuntime()` inside a worker file instead, so that\n * SQLite and query execution run off the main thread.\n *\n * At minimum you must supply `schema` and `functions`. Everything else has\n * sensible defaults (OPFS persistence, SQL.js driver, auto-devtools connect).\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({\n *   schema,\n *   functions,\n *   databaseName: \"my-app\",\n * });\n * ```\n */\nexport interface CreateWebRuntimeOptions<\n  TSchema extends WebSyncoreSchema = WebSyncoreSchema\n> {\n  /** The data model that defines the available tables and indexes. */\n  schema: TSchema;\n\n  /**\n   * The registered function map. In practice this is always the `functions`\n   * export from `syncore/_generated/functions.ts`.\n   */\n  functions: SyncoreRuntimeOptions<TSchema>[\"functions\"];\n\n  /**\n   * Resolved Syncore component instances to mount alongside the root app.\n   * Only required when your app installs Syncore component packages.\n   */\n  components?: SyncoreRuntimeOptions<TSchema>[\"components\"];\n\n  /**\n   * Platform capabilities injected into `ctx.capabilities` inside function\n   * handlers. Use this to expose browser APIs (e.g. `navigator.geolocation`)\n   * to your Syncore functions in a portable way.\n   */\n  capabilities?: SyncoreCapabilities;\n\n  /**\n   * Custom SQLite driver. Defaults to a `SqlJsDriver` backed by the\n   * persistence layer chosen by `persistenceMode` / `persistence`.\n   *\n   * Override only when you need a non-standard SQLite binding.\n   */\n  driver?: SyncoreRuntimeOptions<TSchema>[\"driver\"];\n\n  /**\n   * Custom blob storage adapter. Defaults to `BrowserFileStorageAdapter`\n   * backed by the same persistence layer as the SQL driver.\n   *\n   * Override when you want to store files in a different location (e.g. an\n   * in-memory adapter for tests).\n   */\n  storage?: SyncoreStorageAdapter;\n\n  /**\n   * An explicit persistence implementation. When provided, `persistenceMode`,\n   * `persistenceDatabaseName`, and `opfsRootDirectoryName` are ignored.\n   *\n   * Most apps should omit this and let Syncore choose the best available mode\n   * automatically via `persistenceMode`.\n   */\n  persistence?: SyncoreWebPersistence;\n\n  /**\n   * Which browser storage backend Syncore should use when it creates the\n   * persistence layer for you.\n   *\n   * - `\"opfs\"` — Origin Private File System (recommended for modern browsers;\n   *   supports large databases and true WAL mode).\n   * - `\"indexeddb\"` — IndexedDB-backed persistence (wider compatibility).\n   *\n   * Defaults to the best mode available in the current browser.\n   */\n  persistenceMode?: WebPersistenceMode;\n\n  /**\n   * Logical name used to namespace the SQL.js database and local storage keys.\n   *\n   * Set a stable value (e.g. your app’s slug) so the database persists across\n   * page reloads with a predictable name. Defaults to `\"syncore\"`.\n   */\n  databaseName?: string;\n\n  /**\n   * IndexedDB database name used to store persistence metadata (e.g. the OPFS\n   * scope identifier). Defaults to `databaseName`.\n   */\n  persistenceDatabaseName?: string;\n\n  /**\n   * OPFS root directory name for the SQLite database file and blob storage.\n   * Defaults to `databaseName` or `\"syncore\"`.\n   */\n  opfsRootDirectoryName?: string;\n\n  /**\n   * Namespace prefix for blob storage keys. Defaults to `databaseName` or\n   * `\"syncore\"`.\n   */\n  storageNamespace?: string;\n\n  /**\n   * Explicit URL for the `sql.js` WebAssembly binary.\n   *\n   * Syncore resolves the URL automatically in most bundler setups. Override\n   * this only if the auto-resolved URL is incorrect (e.g. in a custom CDN\n   * deploy or a worker with a different asset base path).\n   */\n  wasmUrl?: string;\n\n  /**\n   * Custom file resolver for SQL.js support files (wasm + worker scripts).\n   *\n   * Takes a filename (e.g. `\"sql-wasm.wasm\"`) and returns the full URL.\n   * Equivalent to sql.js’s `locateFile` option. Use `wasmUrl` instead when\n   * you only need to override the `.wasm` path.\n   */\n  locateFile?: (fileName: string) => string;\n\n  /**\n   * Platform label reported to the devtools dashboard.\n   * Defaults to `\"browser\"`.\n   */\n  platform?: string;\n\n  /** Human-readable app name shown in the devtools dashboard header. */\n  appName?: string;\n\n  /**\n   * Explicit devtools WebSocket server URL.\n   * Defaults to `ws://127.0.0.1:4311` (the Syncore devtools default port).\n   */\n  devtoolsUrl?: string;\n\n  /**\n   * Devtools event sink. Pass `false` to disable devtools entirely\n   * (recommended for production builds). Omit to auto-connect to the local\n   * devtools server when running in development.\n   */\n  devtools?: DevtoolsSink | false;\n\n  /** Scheduler configuration for background and recurring jobs. */\n  scheduler?: SchedulerOptions;\n}\n\n/**\n * Options for hosting a Syncore runtime inside a dedicated browser Worker.\n *\n * Extends {@link CreateWebRuntimeOptions} with the `endpoint` field that wires\n * the runtime to the worker’s message port. Use this inside a worker entry\n * file (`syncore.worker.ts`):\n *\n * ```ts\n * // syncore.worker.ts\n * import { createWebWorkerSyncoreRuntime } from \"syncorejs/browser\";\n * import schema from \"./syncore/schema\";\n * import { functions } from \"./syncore/_generated/functions\";\n *\n * createWebWorkerSyncoreRuntime({\n *   schema,\n *   functions,\n *   endpoint: self as unknown as SyncoreWorkerMessageEndpoint,\n * });\n * ```\n */\nexport interface CreateWebWorkerRuntimeOptions<\n  TSchema extends WebSyncoreSchema = WebSyncoreSchema\n> extends CreateWebRuntimeOptions<TSchema> {\n  /** The message endpoint exposed by the current worker global. */\n  endpoint: SyncoreWorkerMessageEndpoint;\n}\n\n/**\n * Alias of {@link CreateWebRuntimeOptions} for the `syncorejs/browser` surface.\n * @see CreateWebRuntimeOptions\n */\nexport type CreateBrowserRuntimeOptions<\n  TSchema extends BrowserSyncoreSchema = BrowserSyncoreSchema\n> = CreateWebRuntimeOptions<TSchema>;\n\n/**\n * Alias of {@link CreateWebWorkerRuntimeOptions} for the `syncorejs/browser` surface.\n * @see CreateWebWorkerRuntimeOptions\n */\nexport type CreateBrowserWorkerRuntimeOptions<\n  TSchema extends BrowserSyncoreSchema = BrowserSyncoreSchema\n> = CreateWebWorkerRuntimeOptions<TSchema>;\n\n/**\n * Internal bookkeeping for the browser cross-tab change synchronisation layer.\n *\n * Holds the `BroadcastChannel`-based signal that publishes and receives\n * database-change events between tabs, and optionally an `applier` that\n * reconciles incoming changes into an in-memory SQL.js database.\n *\n * You do not need to use this directly — `createWebSyncoreRuntime` builds it\n * for you from your options. Exposed for advanced setups (e.g. Expo web) that\n * construct the change support layer independently.\n */\nexport interface WebExternalChangeSupport {\n  signal: BroadcastChannelExternalChangeSignal;\n  applier?: SqlJsExternalChangeApplier;\n}\n\n/**\n * Create a full Syncore runtime directly in the browser (main thread or\n * shared worker).\n *\n * This function sets up SQL.js, the OPFS/IndexedDB persistence layer, blob\n * storage, cross-tab change synchronisation via `BroadcastChannel`, and\n * auto-connects to the devtools server in development.\n *\n * @remarks\n * Most React/Svelte apps should run the runtime inside a `Worker` using\n * `createWebWorkerSyncoreRuntime()` instead, so that SQLite queries don’t\n * block the main thread. Use `createWebSyncoreRuntime` only when a worker is\n * not practical (e.g. in Electron renderer processes or certain test setups).\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({ schema, functions });\n * await runtime.start();\n * const client = runtime.createClient();\n * ```\n */\nexport async function createWebSyncoreRuntime<\n  TSchema extends WebSyncoreSchema\n>(\n  options: CreateWebRuntimeOptions<TSchema>\n): Promise<SyncoreRuntime<TSchema>> {\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 wasmUrl =\n    options.wasmUrl ??\n    (options.locateFile || !isBrowserLikeRuntime()\n      ? undefined\n      : await resolveDefaultWebWasmUrl());\n  const driver =\n    options.driver ??\n    (await SqlJsDriver.create({\n      databaseName: options.databaseName ?? \"syncore\",\n      persistence,\n      ...(wasmUrl ? { 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 externalChangeSupport = createWebExternalChangeSupport({\n    databaseName: options.databaseName ?? \"syncore\",\n    persistence,\n    driver\n  });\n  const appName = options.appName ?? resolveWebAppName();\n  const origin = resolveWebOrigin();\n  const sessionLabel = resolveWebSessionLabel();\n  const databaseLabel = options.databaseName ?? \"syncore\";\n  const storageScopeId = await resolvePersistedStorageScopeId(\n    persistence,\n    databaseLabel\n  );\n  const dataSourceAlias = await resolvePersistedDataSourceAlias(\n    persistence,\n    databaseLabel\n  );\n  const storageIdentity = [\n    origin ?? \"unknown-origin\",\n    persistence.storageProtocol,\n    databaseLabel,\n    storageScopeId\n  ].join(\"::\");\n  const autoDevtools =\n    options.devtools === undefined && shouldAutoConnectDevtools()\n      ? (() => {\n          const sinkOptions: BrowserWebSocketDevtoolsSinkOptions = {\n            url: options.devtoolsUrl ?? resolveDefaultDevtoolsUrl(),\n            targetKind: \"client\",\n            storageProtocol: persistence.storageProtocol,\n            databaseLabel,\n            dataSourceAlias,\n            storageIdentity,\n            capabilities: createBrowserDevtoolsCapabilities()\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  announceBrowserSession({\n    enabled: resolvedDevtools !== undefined,\n    sessionLabel,\n    appName,\n    origin,\n    devtoolsUrl:\n      options.devtools && typeof options.devtools === \"object\"\n        ? undefined\n        : options.devtoolsUrl ?? resolveDefaultDevtoolsUrl()\n  });\n\n  const runtime = new SyncoreRuntime({\n    schema: options.schema,\n    functions: options.functions,\n    ...(options.components ? { components: options.components } : {}),\n    driver,\n    storage,\n    externalChangeSignal: externalChangeSupport.signal,\n    ...(externalChangeSupport.applier\n      ? { externalChangeApplier: externalChangeSupport.applier }\n      : {}),\n    platform: options.platform ?? \"browser\",\n    ...(options.capabilities ? { capabilities: options.capabilities } : {}),\n    ...(resolvedDevtools ? { devtools: resolvedDevtools } : {}),\n    ...(options.scheduler ? { scheduler: options.scheduler } : {})\n  });\n\n  if (isAttachableBrowserDevtoolsSink(resolvedDevtools)) {\n    resolvedDevtools.attachRuntime(runtime);\n    resolvedDevtools.attachCommandHandler(\n      createDevtoolsCommandHandler({\n        driver,\n        schema: options.schema,\n        functions: options.functions,\n        admin: runtime.getAdmin()\n      })\n    );\n    resolvedDevtools.attachSubscriptionHost(\n      createDevtoolsSubscriptionHost({\n        driver,\n        schema: options.schema,\n        functions: options.functions,\n        admin: runtime.getAdmin()\n      })\n    );\n  }\n\n  return runtime;\n}\n\nfunction isAttachableBrowserDevtoolsSink(\n  sink: DevtoolsSink | undefined\n): sink is BrowserWebSocketDevtoolsSink {\n  return (\n    !!sink &&\n    typeof (sink as BrowserWebSocketDevtoolsSink).attachRuntime === \"function\" &&\n    typeof (sink as BrowserWebSocketDevtoolsSink).attachCommandHandler ===\n      \"function\" &&\n    typeof (sink as BrowserWebSocketDevtoolsSink).attachSubscriptionHost ===\n      \"function\"\n  );\n}\n\n/**\n * Build a {@link WebExternalChangeSupport} bundle for a given database and\n * persistence layer.\n *\n * Creates a `BroadcastChannel`-based signal so that all tabs sharing the same\n * `databaseName` are notified when a mutation commits. When `driver` is a\n * `SqlJsDriver` (i.e. an in-memory database), an `applier` is also created so\n * the local database can be updated from the latest on-disk snapshot.\n *\n * Called automatically by `createWebSyncoreRuntime`. Exposed for advanced use\n * cases such as the Expo web adapter.\n */\nexport function createWebExternalChangeSupport(options: {\n  databaseName: string;\n  persistence: SyncoreWebPersistence;\n  driver: CreateWebRuntimeOptions<SyncoreDataModel>[\"driver\"] | undefined;\n}): WebExternalChangeSupport {\n  const signal = new BroadcastChannelExternalChangeSignal({\n    channelName: createDefaultSyncChannelName(options.databaseName)\n  });\n  const sqlDriver =\n    options.driver instanceof SqlJsDriver ? options.driver : undefined;\n\n  if (!sqlDriver) {\n    return { signal };\n  }\n\n  return {\n    signal,\n    applier: new SqlJsExternalChangeApplier({\n      databaseName: options.databaseName,\n      persistence: options.persistence,\n      createDatabase: (bytes) => sqlDriver.createDatabaseFromBytes(bytes),\n      replaceDatabase: (database) => {\n        sqlDriver.replaceDatabase(database);\n      }\n    })\n  };\n}\n\n/**\n * Build a {@link WebExternalChangeSupport} bundle for an Expo app running on\n * the web platform.\n *\n * Behaves identically to {@link createWebExternalChangeSupport} but accepts\n * the same options shape used by `createExpoSyncoreRuntime`, making it easy\n * to share config when bootstrapping an Expo web runtime.\\\n *\n * Called internally by the Expo platform adapter. Use directly only when\n * constructing the runtime outside of `createExpoSyncoreRuntime`.\n */\nexport async function createExpoWebExternalChangeSupport(options: {\n  databaseName: string;\n  locateFile?: (fileName: string) => string;\n  wasmUrl?: string;\n  persistenceDatabaseName?: string;\n  opfsRootDirectoryName?: string;\n  persistenceMode?: WebPersistenceMode;\n}): Promise<WebExternalChangeSupport> {\n  const persistence = await createWebPersistence({\n    ...(options.persistenceMode ? { mode: options.persistenceMode } : {}),\n    ...(options.persistenceDatabaseName\n      ? { indexedDbDatabaseName: options.persistenceDatabaseName }\n      : {}),\n    opfsRootDirectoryName: options.opfsRootDirectoryName ?? options.databaseName\n  });\n  const wasmUrl =\n    options.wasmUrl ??\n    (options.locateFile || !isBrowserLikeRuntime()\n      ? undefined\n      : await resolveDefaultWebWasmUrl());\n  const driver = await SqlJsDriver.create({\n    databaseName: options.databaseName,\n    persistence,\n    ...(wasmUrl ? { wasmUrl } : {}),\n    ...(options.locateFile ? { locateFile: options.locateFile } : {})\n  });\n\n  return createWebExternalChangeSupport({\n    databaseName: options.databaseName,\n    persistence,\n    driver\n  });\n}\n\n/**\n * Start a Syncore runtime inside a browser `Worker` and wire it to the\n * worker’s own message endpoint.\n *\n * This is the function you call **inside your worker file** (`syncore.worker.ts`).\n * It creates the full runtime (SQL.js + OPFS + BroadcastChannel) in the worker\n * context and begins listening for messages from the main-thread client.\n *\n * ```ts\n * // syncore.worker.ts\n * import { createWebWorkerRuntime } from \"syncorejs/browser\";\n * import schema from \"./syncore/schema\";\n * import { functions } from \"./syncore/_generated/functions\";\n *\n * void createWebWorkerRuntime({\n *   schema,\n *   functions,\n *   endpoint: self as unknown as SyncoreWorkerMessageEndpoint,\n * });\n * ```\n *\n * On the main thread, connect with `createManagedWebWorkerClient()` or\n * `SyncoreNextProvider` (Next.js).\n */\nexport function createWebWorkerRuntime<\n  TSchema extends WebSyncoreSchema\n>(options: CreateWebWorkerRuntimeOptions<TSchema>) {\n  return attachWebWorkerRuntime({\n    endpoint: options.endpoint,\n    createRuntime: () =>\n      createWebSyncoreRuntime({\n        ...options,\n        platform: options.platform ?? \"browser-worker\"\n      })\n  });\n}\n\n/**\n * Alias of {@link createWebWorkerRuntime} for the `syncorejs/browser` surface.\n * @see createWebWorkerRuntime\n */\nexport function createBrowserWorkerRuntime(\n  options: CreateBrowserWorkerRuntimeOptions\n) {\n  return createWebWorkerRuntime(options);\n}\n\n/**\n * Create a same-process Syncore client from a started browser runtime.\n *\n * Use this when the runtime lives in the same context as the client (e.g.\n * main-thread runtime in an Electron renderer or a test harness). For\n * worker-based setups use `createManagedWebWorkerClient()` instead, which\n * communicates with the worker over `postMessage`.\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({ schema, functions });\n * await runtime.start();\n * const client = createWebSyncoreClient(runtime);\n * ```\n */\nexport function createWebSyncoreClient<\n  TSchema extends WebSyncoreSchema\n>(runtime: SyncoreRuntime<TSchema>) {\n  return runtime.createClient();\n}\n\n/**\n * Alias of {@link createWebSyncoreRuntime} for the `syncorejs/browser` surface.\n * @see createWebSyncoreRuntime\n */\nexport function createBrowserSyncoreRuntime<\n  TSchema extends BrowserSyncoreSchema\n>(options: CreateBrowserRuntimeOptions<TSchema>) {\n  return createWebSyncoreRuntime(options);\n}\n\n/**\n * Alias of {@link createWebSyncoreClient} for the `syncorejs/browser` surface.\n * @see createWebSyncoreClient\n */\nexport function createBrowserSyncoreClient<\n  TSchema extends BrowserSyncoreSchema\n>(runtime: SyncoreRuntime<TSchema>) {\n  return createWebSyncoreClient(runtime);\n}\n\n/**\n * Configuration options for {@link createBrowserWebSocketDevtoolsSink}.\n *\n * All fields except `url` are optional — `createWebSyncoreRuntime` fills them\n * in automatically from the runtime’s own metadata.\n */\nexport interface BrowserWebSocketDevtoolsSinkOptions {\n  /** WebSocket URL of the Syncore devtools server, e.g. `\"ws://127.0.0.1:4311\"`. */\n  url: string;\n  /**\n   * How long to wait before attempting a reconnect after the WebSocket closes,\n   * in milliseconds. Defaults to `1200`.\n   */\n  reconnectDelayMs?: number;\n  /** Human-readable app name shown in the devtools dashboard header. */\n  appName?: string;\n  /** Origin label (e.g. `window.location.origin`) shown in the devtools session list. */\n  origin?: string;\n  /** Session label auto-generated from the tab’s URL path; helps distinguish multiple open tabs. */\n  sessionLabel?: string;\n  /** Kind of this devtools participant. Always `\"client\"` for browser runtimes. */\n  targetKind?: \"client\";\n  /** Persistence protocol tag reported to devtools (e.g. `\"opfs\"`, `\"indexeddb\"`). */\n  storageProtocol?: string;\n  /** Logical database name used to group sessions in the devtools UI. */\n  databaseLabel?: string;\n  /** Stable alias for the data source, used by devtools for cross-session continuity. */\n  dataSourceAlias?: string;\n  /**\n   * Opaque identity string that uniquely identifies this database across origin\n   * + persistence protocol + name, used by devtools for data-source tracking.\n   */\n  storageIdentity?: string;\n  /** Capability flags advertising what devtools features this runtime supports. */\n  capabilities?: SyncoreDevtoolsCapabilities;\n}\n\nasync function resolveDefaultWebWasmUrl(): Promise<string | undefined> {\n  try {\n    const module = await import(\"./web-sqljs-wasm.js\");\n    return module.resolveDefaultWebSqlJsWasmUrl();\n  } catch (error) {\n    if (!isBrowserLikeRuntime()) {\n      return undefined;\n    }\n    throw new Error(\n      \"Syncore could not resolve the default sql.js WebAssembly asset. \" +\n        \"Pass wasmUrl or locateFile to createWebSyncoreRuntime/createBrowserWorkerRuntime for this bundler.\",\n      { cause: error }\n    );\n  }\n}\n\nfunction isBrowserLikeRuntime(): boolean {\n  const scope = globalThis as typeof globalThis & {\n    WorkerGlobalScope?: unknown;\n  };\n  return typeof window !== \"undefined\" || scope.WorkerGlobalScope !== undefined;\n}\n\n/**\n * A {@link DevtoolsSink} that forwards runtime events to the Syncore devtools\n * dashboard over a persistent WebSocket connection with auto-reconnect.\n *\n * Returned by {@link createBrowserWebSocketDevtoolsSink}. You typically do not\n * use this interface directly — `createWebSyncoreRuntime` creates and manages\n * the sink automatically when running in development.\n */\nexport interface BrowserWebSocketDevtoolsSink extends DevtoolsSink {\n  /** Attach the runtime so the sink can pull metadata for devtools messages. */\n  attachRuntime(runtime: SyncoreRuntime<WebSyncoreSchema>): void;\n  /** Attach the command handler that processes devtools RPC commands. */\n  attachCommandHandler(handler: DevtoolsCommandHandler): void;\n  /** Attach the subscription host for live query streaming. */\n  attachSubscriptionHost(host: DevtoolsSubscriptionHost): void;\n  /** Close the WebSocket and stop reconnecting. Call on runtime shutdown. */\n  dispose(): void;\n}\n\n/**\n * Create a WebSocket-based devtools sink that connects to the Syncore devtools\n * server and forwards runtime events in real time.\n *\n * The sink auto-reconnects if the connection drops (e.g. while the devtools\n * dashboard is restarting) and buffers events that arrive before the socket is\n * open.\n *\n * In most cases you do not need to call this directly — `createWebSyncoreRuntime`\n * creates and attaches the sink automatically when `devtools` is omitted and the\n * page is served from a local/private hostname.\n *\n * ```ts\n * const sink = createBrowserWebSocketDevtoolsSink({\n *   url: \"ws://127.0.0.1:4311\",\n *   appName: \"My App\",\n * });\n * const runtime = await createWebSyncoreRuntime({ schema, functions, devtools: sink });\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 getSummary: (() => SyncoreRuntimeSummary) | undefined;\n  let onCommand: DevtoolsCommandHandler | undefined;\n  let subscriptionHost: DevtoolsSubscriptionHost | 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          protocolVersion: SYNCORE_DEVTOOLS_PROTOCOL_VERSION,\n          minSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION,\n          maxSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION,\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          ...(options.targetKind ? { targetKind: options.targetKind } : {}),\n          ...(options.storageProtocol\n            ? { storageProtocol: options.storageProtocol }\n            : {}),\n          ...(options.databaseLabel ? { databaseLabel: options.databaseLabel } : {}),\n          ...(options.dataSourceAlias\n            ? { dataSourceAlias: options.dataSourceAlias }\n            : {}),\n          ...(options.storageIdentity\n            ? { storageIdentity: options.storageIdentity }\n            : {}),\n          capabilities: options.capabilities ?? createBrowserDevtoolsCapabilities()\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        | SyncoreDevtoolsClientMessage;\n      if (message.type === \"ping\") {\n        send({ type: \"pong\" });\n      } else if (message.type === \"command\" && onCommand) {\n        onCommand(message.payload)\n          .then((responsePayload) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSummary?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"command.result\",\n              commandId: message.commandId,\n              runtimeId,\n              payload: responsePayload\n            });\n          })\n          .catch((err) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSummary?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"command.result\",\n              commandId: message.commandId,\n              runtimeId,\n              payload: {\n                kind: \"error\",\n                message: err instanceof Error ? err.message : \"Unknown error\"\n              }\n            });\n          });\n      } else if (message.type === \"subscribe\" && subscriptionHost) {\n        void subscriptionHost.subscribe(\n          message.subscriptionId,\n          message.payload,\n          (payload) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSummary?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"subscription.data\",\n              subscriptionId: message.subscriptionId,\n              runtimeId,\n              payload\n            });\n          }\n        );\n      } else if (message.type === \"unsubscribe\") {\n        subscriptionHost?.unsubscribe(message.subscriptionId);\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          protocolVersion: SYNCORE_DEVTOOLS_PROTOCOL_VERSION,\n          minSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION,\n          maxSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION,\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          ...(options.targetKind ? { targetKind: options.targetKind } : {}),\n          ...(options.storageProtocol\n            ? { storageProtocol: options.storageProtocol }\n            : {}),\n          ...(options.databaseLabel ? { databaseLabel: options.databaseLabel } : {}),\n          ...(options.dataSourceAlias\n            ? { dataSourceAlias: options.dataSourceAlias }\n            : {}),\n          ...(options.storageIdentity\n            ? { storageIdentity: options.storageIdentity }\n            : {}),\n          capabilities: options.capabilities ?? createBrowserDevtoolsCapabilities()\n        });\n      }\n      send({ type: \"event\", event });\n    },\n    attachRuntime(runtime) {\n      getSummary = () =>\n        withRuntimeSummaryMeta(runtime.getAdmin().getRuntimeSummary(), options);\n    },\n    attachCommandHandler(handler) {\n      onCommand = handler;\n    },\n    attachSubscriptionHost(host) {\n      subscriptionHost = host;\n    },\n    dispose() {\n      disposed = true;\n      if (connectTimer) {\n        clearTimeout(connectTimer);\n      }\n      subscriptionHost?.dispose();\n      socket?.close();\n    }\n  };\n}\n\nfunction withRuntimeSummaryMeta(\n  summary: SyncoreRuntimeSummary,\n  options: BrowserWebSocketDevtoolsSinkOptions\n): SyncoreRuntimeSummary {\n  return {\n    ...summary,\n    ...(options.appName ? { appName: options.appName } : {}),\n    ...(options.origin ? { origin: options.origin } : {}),\n    ...(options.sessionLabel ? { sessionLabel: options.sessionLabel } : {}),\n    ...(options.targetKind ? { targetKind: options.targetKind } : {}),\n    ...(options.storageProtocol\n      ? { storageProtocol: options.storageProtocol }\n      : {}),\n    ...(options.databaseLabel ? { databaseLabel: options.databaseLabel } : {}),\n    ...(options.dataSourceAlias ? { dataSourceAlias: options.dataSourceAlias } : {}),\n    ...(options.storageIdentity\n      ? { storageIdentity: options.storageIdentity }\n      : {}),\n    capabilities: options.capabilities ?? createBrowserDevtoolsCapabilities()\n  };\n}\n\nfunction createBrowserDevtoolsCapabilities(): SyncoreDevtoolsCapabilities {\n  return {\n    sql: {\n      read: false,\n      write: false,\n      live: false,\n      reason: \"SQL Console is not available for browser runtimes.\"\n    },\n    data: {\n      browse: true,\n      mutate: true,\n      importExport: true\n    },\n    scheduler: {\n      read: true,\n      edit: true\n    }\n  };\n}\n\nfunction shouldAutoConnectDevtools(): boolean {\n  const hostname = resolveWebHostname();\n  if (!hostname) {\n    return false;\n  }\n  return (\n    hostname === \"localhost\" ||\n    isPrivateNetworkHostname(hostname) ||\n    hostname.endsWith(\".local\")\n  );\n}\n\nfunction resolveDefaultDevtoolsUrl(): string {\n  return \"ws://127.0.0.1:4311\";\n}\n\nfunction resolveLocationString(\n  key: \"href\" | \"origin\" | \"hostname\"\n): string | undefined {\n  try {\n    const value = globalThis.location?.[key];\n    return typeof value === \"string\" && value.length > 0 ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveGlobalOrigin(): string | undefined {\n  try {\n    const value = (globalThis as { origin?: unknown }).origin;\n    return typeof value === \"string\" && value.length > 0 ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction parseUrlCandidate(candidate: string | undefined): URL | undefined {\n  if (!candidate || candidate === \"null\") {\n    return undefined;\n  }\n  try {\n    const parsed = new URL(candidate);\n    if (parsed.protocol === \"blob:\" && parsed.pathname.length > 0) {\n      try {\n        return new URL(parsed.pathname);\n      } catch {\n        return parsed;\n      }\n    }\n    return parsed;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWebHostname(): string | undefined {\n  const directHostname = resolveLocationString(\"hostname\");\n  if (directHostname) {\n    return directHostname;\n  }\n  return (\n    parseUrlCandidate(resolveLocationString(\"href\"))?.hostname ||\n    parseUrlCandidate(resolveLocationString(\"origin\"))?.hostname ||\n    parseUrlCandidate(resolveGlobalOrigin())?.hostname ||\n    undefined\n  );\n}\n\nfunction isPrivateNetworkHostname(hostname: string): boolean {\n  const normalized = hostname.toLowerCase().replace(/^\\[|\\]$/g, \"\");\n  if (normalized === \"::1\") {\n    return true;\n  }\n  if (normalized.startsWith(\"fc\") || normalized.startsWith(\"fd\")) {\n    return true;\n  }\n  const match = /^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/.exec(normalized);\n  if (!match) {\n    return false;\n  }\n  const octets = match.slice(1).map((part) => Number(part));\n  if (octets.some((part) => Number.isNaN(part) || part < 0 || part > 255)) {\n    return false;\n  }\n  const first = octets[0];\n  const second = octets[1];\n  if (first === undefined || second === undefined) {\n    return false;\n  }\n  return (\n    first === 10 ||\n    first === 127 ||\n    (first === 169 && second === 254) ||\n    (first === 172 && second >= 16 && second <= 31) ||\n    (first === 192 && second === 168)\n  );\n}\n\nfunction resolveWebOrigin(): string | undefined {\n  const directOrigin = resolveLocationString(\"origin\");\n  if (directOrigin && directOrigin !== \"null\") {\n    return directOrigin;\n  }\n  const parsedOrigin =\n    parseUrlCandidate(resolveLocationString(\"href\"))?.origin ||\n    parseUrlCandidate(resolveGlobalOrigin())?.origin;\n  return parsedOrigin && parsedOrigin !== \"null\" ? parsedOrigin : undefined;\n}\n\nfunction resolveWebAppName(): string | undefined {\n  try {\n    return resolveWebHostname() ?? globalThis.document?.title ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWebSessionLabel(): string | undefined {\n  try {\n    if (typeof navigator === \"undefined\") {\n      return undefined;\n    }\n\n    // Generate or retrieve a persistent unique name for this browser instance.\n    // This makes it much easier to identify which browser tab/window you're\n    // looking at in the devtools dashboard.\n    const STORAGE_KEY = \"syncore-session-name\";\n    let uniqueName: string | null = null;\n\n    try {\n      uniqueName = globalThis.localStorage?.getItem(STORAGE_KEY) ?? null;\n    } catch {\n      /* localStorage may not be available */\n    }\n\n    if (!uniqueName) {\n      uniqueName = generateUniqueSessionName();\n\n      try {\n        globalThis.localStorage?.setItem(STORAGE_KEY, uniqueName);\n      } catch {\n        /* ignore storage errors */\n      }\n    }\n\n    const browser = resolveBrowserName(navigator);\n\n    return `${uniqueName} (${browser})`;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveBrowserName(\n  nav: Navigator & {\n    userAgentData?: {\n      brands?: Array<{\n        brand: string;\n      }>;\n    };\n  }\n): string {\n  const brands = nav.userAgentData?.brands?.map((entry) => entry.brand) ?? [];\n\n  if (brands.some((brand) => /microsoft edge/i.test(brand))) {\n    return \"Edge\";\n  }\n  if (brands.some((brand) => /firefox/i.test(brand))) {\n    return \"Firefox\";\n  }\n  if (brands.some((brand) => /opera/i.test(brand))) {\n    return \"Opera\";\n  }\n  if (brands.some((brand) => /chrome|chromium/i.test(brand))) {\n    return \"Chrome\";\n  }\n  if (brands.some((brand) => /safari/i.test(brand))) {\n    return \"Safari\";\n  }\n\n  const userAgent = nav.userAgent;\n  if (/Firefox\\//i.test(userAgent)) {\n    return \"Firefox\";\n  }\n  if (/Edg\\//i.test(userAgent)) {\n    return \"Edge\";\n  }\n  if (/OPR\\/|Opera/i.test(userAgent)) {\n    return \"Opera\";\n  }\n  if (/Chrome\\/|CriOS\\//i.test(userAgent)) {\n    return \"Chrome\";\n  }\n  if (/Safari\\//i.test(userAgent)) {\n    return \"Safari\";\n  }\n  return \"Browser\";\n}\n\nasync function resolvePersistedStorageScopeId(\n  persistence: SyncoreWebPersistence,\n  databaseLabel: string\n): Promise<string> {\n  const id = `${STORAGE_SCOPE_ID_PREFIX}:${databaseLabel}`;\n  const existing = await persistence.getFile(DEVTOOLS_META_NAMESPACE, id);\n\n  if (existing) {\n    const value = new TextDecoder().decode(existing.bytes).trim();\n    if (value.length > 0) {\n      return value;\n    }\n  }\n\n  const nextValue = generateId();\n  await persistence.putFile(\n    DEVTOOLS_META_NAMESPACE,\n    id,\n    new TextEncoder().encode(nextValue),\n    \"text/plain\"\n  );\n  return nextValue;\n}\n\nasync function resolvePersistedDataSourceAlias(\n  persistence: SyncoreWebPersistence,\n  databaseLabel: string\n): Promise<string> {\n  const id = `${DATA_SOURCE_ALIAS_PREFIX}:${databaseLabel}`;\n  const existing = await persistence.getFile(DEVTOOLS_META_NAMESPACE, id);\n\n  if (existing) {\n    const value = new TextDecoder().decode(existing.bytes).trim();\n    if (value.length > 0) {\n      return value;\n    }\n  }\n\n  const nextValue = generateUniqueSessionName();\n  await persistence.putFile(\n    DEVTOOLS_META_NAMESPACE,\n    id,\n    new TextEncoder().encode(nextValue),\n    \"text/plain\"\n  );\n  return nextValue;\n}\n\nfunction announceBrowserSession(options: {\n  enabled: boolean;\n  sessionLabel?: string | undefined;\n  appName?: string | undefined;\n  origin?: string | undefined;\n  devtoolsUrl?: string | undefined;\n}): void {\n  if (!options.enabled || !options.sessionLabel) {\n    return;\n  }\n\n  const announcedSessions = getAnnouncedBrowserSessions();\n  if (announcedSessions.has(options.sessionLabel)) {\n    return;\n  }\n  announcedSessions.add(options.sessionLabel);\n\n  try {\n    const details = [\n      options.appName ? `app=${options.appName}` : undefined,\n      options.origin ? `origin=${options.origin}` : undefined,\n      options.devtoolsUrl ? `devtools=${options.devtoolsUrl}` : undefined\n    ].filter((value): value is string => value !== undefined);\n\n    console.info(\n      `[syncore] Browser session: ${options.sessionLabel}${details.length > 0 ? ` (${details.join(\", \")})` : \"\"}`\n    );\n  } catch {\n    /* ignore console failures */\n  }\n}\n\nfunction getAnnouncedBrowserSessions(): Set<string> {\n  const key = \"__syncoreAnnouncedBrowserSessions\";\n  const scope = globalThis as typeof globalThis & {\n    [key]?: Set<string>;\n  };\n  if (!scope[key]) {\n    scope[key] = new Set<string>();\n  }\n  return scope[key];\n}\n\n/* ------------------------------------------------------------------ */\n/*  Unique session name generator                                      */\n/* ------------------------------------------------------------------ */\n\nconst SESSION_ADJECTIVES = [\n  \"Acrobatic\",\n  \"Bold\",\n  \"Cosmic\",\n  \"Daring\",\n  \"Electric\",\n  \"Fierce\",\n  \"Golden\",\n  \"Hidden\",\n  \"Iron\",\n  \"Jade\",\n  \"Keen\",\n  \"Lunar\",\n  \"Mystic\",\n  \"Noble\",\n  \"Orbital\",\n  \"Primal\",\n  \"Quick\",\n  \"Radiant\",\n  \"Shadow\",\n  \"Turbo\",\n  \"Ultra\",\n  \"Vivid\",\n  \"Wicked\",\n  \"Xenon\",\n  \"Zen\",\n  \"Arctic\",\n  \"Binary\",\n  \"Cyber\",\n  \"Digital\",\n  \"Ember\",\n  \"Frozen\",\n  \"Galactic\",\n  \"Hyper\",\n  \"Infra\",\n  \"Jumbo\",\n  \"Kinetic\",\n  \"Liquid\",\n  \"Magnetic\",\n  \"Neon\",\n  \"Onyx\",\n  \"Phantom\",\n  \"Quantum\",\n  \"Rapid\",\n  \"Sonic\",\n  \"Titan\",\n  \"Velvet\",\n  \"Wild\",\n  \"Blazing\",\n  \"Crystal\",\n  \"Dynamic\"\n] as const;\n\nconst SESSION_NOUNS = [\n  \"Monkey\",\n  \"Phoenix\",\n  \"Tiger\",\n  \"Dragon\",\n  \"Falcon\",\n  \"Panther\",\n  \"Wolf\",\n  \"Eagle\",\n  \"Cobra\",\n  \"Shark\",\n  \"Raven\",\n  \"Fox\",\n  \"Lynx\",\n  \"Hawk\",\n  \"Bear\",\n  \"Jaguar\",\n  \"Viper\",\n  \"Owl\",\n  \"Stallion\",\n  \"Dolphin\",\n  \"Developer\",\n  \"Hacker\",\n  \"Wizard\",\n  \"Ninja\",\n  \"Pilot\",\n  \"Pioneer\",\n  \"Voyager\",\n  \"Explorer\",\n  \"Runner\",\n  \"Ranger\",\n  \"Maverick\",\n  \"Spartan\",\n  \"Viking\",\n  \"Sentinel\",\n  \"Guardian\",\n  \"Nomad\",\n  \"Cipher\",\n  \"Vector\",\n  \"Matrix\",\n  \"Prism\",\n  \"Nebula\",\n  \"Comet\",\n  \"Pulse\",\n  \"Vertex\",\n  \"Flux\",\n  \"Storm\",\n  \"Blaze\",\n  \"Frost\",\n  \"Thunder\",\n  \"Drift\"\n] as const;\n\nfunction generateUniqueSessionName(): string {\n  const adj =\n    SESSION_ADJECTIVES[Math.floor(Math.random() * SESSION_ADJECTIVES.length)]!;\n  const noun = SESSION_NOUNS[Math.floor(Math.random() * SESSION_NOUNS.length)]!;\n  return `${adj} ${noun}`;\n}\n\n/**\n * Browser file/blob storage adapter backed by `SyncoreWebPersistence`.\n *\n * Stores binary blobs (images, documents, etc.) in the same OPFS or\n * IndexedDB store as the SQLite database. Pass an instance to\n * `CreateWebRuntimeOptions.storage` to enable Syncore's Storage API\n * (`ctx.storage.put`, `ctx.storage.get`, etc.) in browser functions.\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({\n *   schema,\n *   functions,\n *   storage: (persistence) => new BrowserFileStorageAdapter(persistence, \"files\"),\n * });\n * ```\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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,UAAU,QAAQ,WAAW,KAAA;GAC9C,QAAQ,cAAc,YAAY,QAAQ,gBAAgB,KAAA;EAC5D,EAAE,QAAQ,UAA2B,UAAU,KAAA,CAAS;EAExD,QAAQ,KACN,8BAA8B,QAAQ,eAAe,QAAQ,SAAS,IAAI,KAAK,QAAQ,KAAK,IAAI,EAAE,KAAK,IACzG;CACF,QAAQ,CAER;AACF;AAEA,SAAS,8BAA2C;CAClD,MAAM,MAAM;CACZ,MAAM,QAAQ;CAGd,IAAI,CAAC,MAAM,MACT,MAAM,uBAAO,IAAI,IAAY;CAE/B,OAAO,MAAM;AACf;AAMA,MAAM,qBAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,gBAAgB;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,SAAS,4BAAoC;CAI3C,OAAO,GAFL,mBAAmB,KAAK,MAAM,KAAK,OAAO,IAAI,mBAAmB,MAAM,GAE3D,GADD,cAAc,KAAK,MAAM,KAAK,OAAO,IAAI,cAAc,MAAM;AAE5E;;;;;;;;;;;;;;;;;AAkBA,IAAa,4BAAb,MAAwE;CAEnD;CACA;CAFnB,YACE,aACA,WACA;EAFiB,KAAA,cAAA;EACA,KAAA,YAAA;CAChB;CAEH,MAAM,IAAI,IAAY,OAAkD;EACtE,MAAM,QAAQ,gBAAgB,MAAM,IAAI;EACxC,MAAM,KAAK,YAAY,QACrB,KAAK,WACL,IACA,OACA,MAAM,eAAe,IACvB;EACA,OAAO;GACL;GACA,MAAM,GAAG,KAAK,YAAY,gBAAgB,KAAK,KAAK,UAAU,GAAG;GACjE,MAAM,MAAM;GACZ,aAAa,MAAM,eAAe;EACpC;CACF;CAEA,MAAM,IAAI,IAA2C;EACnD,MAAM,OAAO,MAAM,KAAK,YAAY,QAAQ,KAAK,WAAW,EAAE;EAC9D,IAAI,CAAC,MACH,OAAO;EAET,OAAO;GACL;GACA,MAAM,GAAG,KAAK,YAAY,gBAAgB,KAAK,KAAK,UAAU,GAAG;GACjE,MAAM,KAAK;GACX,aAAa,KAAK;EACpB;CACF;CAEA,MAAM,KAAK,IAAwC;EAEjD,QAAO,MADY,KAAK,YAAY,QAAQ,KAAK,WAAW,EAAE,IACjD,SAAS;CACxB;CAEA,MAAM,OAAO,IAA2B;EACtC,MAAM,KAAK,YAAY,WAAW,KAAK,WAAW,EAAE;CACtD;CAEA,MAAM,OAAiC;EAErC,QAAO,MADa,KAAK,YAAY,UAAU,KAAK,SAAS,GAChD,KAAK,UAAU;GAC1B,IAAI,KAAK;GACT,MAAM,GAAG,KAAK,YAAY,gBAAgB,KAAK,KAAK,UAAU,GAAG,KAAK;GACtE,MAAM,KAAK;GACX,aAAa,KAAK;EACpB,EAAE;CACJ;AACF;AAEA,SAAS,gBAAgB,MAA6C;CACpE,IAAI,OAAO,SAAS,UAClB,OAAO,IAAI,YAAY,EAAE,OAAO,IAAI;CAEtC,IAAI,gBAAgB,YAClB,OAAO;CAET,OAAO,IAAI,WAAW,IAAI;AAC5B"}
+{"version":3,"file":"index.js","names":["scope"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  createDevtoolsCommandHandler,\n  createDevtoolsSubscriptionHost,\n  type DevtoolsCommandHandler,\n  type DevtoolsSink,\n  type DevtoolsSubscriptionHost,\n  type SyncoreDataModel,\n  generateId,\n  SyncoreRuntime,\n  type SchedulerOptions,\n  type SyncoreCapabilities,\n  type SyncoreRuntimeCapabilities,\n  type SyncoreRuntimeOptions,\n  type SyncoreStorageAdapter,\n  type StorageObject,\n  type StorageWriteInput\n} from \"@syncore/core\";\nimport {\n  SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION,\n  SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION,\n  SYNCORE_DEVTOOLS_PROTOCOL_VERSION,\n  type SyncoreDevtoolsClientMessage,\n  type SyncoreDevtoolsCapabilities,\n  type SyncoreDevtoolsMessage,\n  type SyncoreRuntimeSummary\n} from \"@syncore/devtools-protocol\";\nimport {\n  createWebPersistence,\n  type SyncoreWebPersistence,\n  type WebPersistenceMode\n} from \"./persistence.js\";\nimport {\n  BroadcastChannelExternalChangeSignal,\n  createDefaultSyncChannelName,\n  SqlJsExternalChangeApplier\n} from \"./external-change.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\";\nexport * from \"./external-change.js\";\n\n/**\n * Schema type constraint for web-platform Syncore runtimes.\n *\n * Pass any schema produced by `defineSchema()` where this type is expected.\n * Defaults to the unconstrained `SyncoreDataModel` when omitted.\n */\nexport type WebSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = TSchema;\n/**\n * Alias of {@link WebSyncoreSchema} for the `syncorejs/browser` surface.\n * @see WebSyncoreSchema\n */\nexport type BrowserSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = WebSyncoreSchema<TSchema>;\n\nconst DEVTOOLS_META_NAMESPACE = \"__syncore_devtools_meta__\";\nconst STORAGE_SCOPE_ID_PREFIX = \"storage-scope\";\nconst DATA_SOURCE_ALIAS_PREFIX = \"data-source-alias\";\n\n/**\n * Options for constructing a browser Syncore runtime.\n *\n * Use this when you want to host the full runtime directly in a browser tab or\n * dedicated Web Worker. In most React or Svelte apps you should call\n * `createWebWorkerSyncoreRuntime()` inside a worker file instead, so that\n * SQLite and query execution run off the main thread.\n *\n * At minimum you must supply `schema` and `functions`. Everything else has\n * sensible defaults (OPFS persistence, SQL.js driver, auto-devtools connect).\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({\n *   schema,\n *   functions,\n *   databaseName: \"my-app\",\n * });\n * ```\n */\nexport interface CreateWebRuntimeOptions<\n  TSchema extends WebSyncoreSchema = WebSyncoreSchema\n> {\n  /** The data model that defines the available tables and indexes. */\n  schema: TSchema;\n\n  /**\n   * The registered function map. In practice this is always the `functions`\n   * export from `syncore/_generated/functions.ts`.\n   */\n  functions: SyncoreRuntimeOptions<TSchema>[\"functions\"];\n\n  /**\n   * Resolved Syncore component instances to mount alongside the root app.\n   * Only required when your app installs Syncore component packages.\n   */\n  components?: SyncoreRuntimeOptions<TSchema>[\"components\"];\n\n  /**\n   * Platform capabilities injected into `ctx.capabilities` inside function\n   * handlers. Use this to expose browser APIs (e.g. `navigator.geolocation`)\n   * to your Syncore functions in a portable way.\n   */\n  capabilities?: SyncoreCapabilities;\n\n  /**\n   * Custom SQLite driver. Defaults to a `SqlJsDriver` backed by the\n   * persistence layer chosen by `persistenceMode` / `persistence`.\n   *\n   * Override only when you need a non-standard SQLite binding.\n   */\n  driver?: SyncoreRuntimeOptions<TSchema>[\"driver\"];\n\n  /**\n   * Custom blob storage adapter. Defaults to `BrowserFileStorageAdapter`\n   * only when the resolved persistence layer is OPFS. IndexedDB persistence is\n   * data-only unless a custom adapter is provided explicitly.\n   *\n   * Override when you want to store files in a different location (e.g. an\n   * in-memory adapter for tests).\n   */\n  storage?: SyncoreStorageAdapter;\n\n  /**\n   * An explicit persistence implementation. When provided, `persistenceMode`,\n   * `persistenceDatabaseName`, and `opfsRootDirectoryName` are ignored.\n   *\n   * Most apps should omit this and let Syncore choose the best available mode\n   * automatically via `persistenceMode`.\n   */\n  persistence?: SyncoreWebPersistence;\n\n  /**\n   * Which browser storage backend Syncore should use when it creates the\n   * persistence layer for you.\n   *\n   * - `\"opfs\"` — Origin Private File System (recommended for modern browsers;\n   *   supports large databases and true WAL mode).\n   * - `\"indexeddb\"` — IndexedDB-backed persistence (wider compatibility).\n   *\n   * Defaults to the best mode available in the current browser.\n   */\n  persistenceMode?: WebPersistenceMode;\n\n  /**\n   * Logical name used to namespace the SQL.js database and local storage keys.\n   *\n   * Set a stable value (e.g. your app’s slug) so the database persists across\n   * page reloads with a predictable name. Defaults to `\"syncore\"`.\n   */\n  databaseName?: string;\n\n  /**\n   * IndexedDB database name used to store persistence metadata (e.g. the OPFS\n   * scope identifier). Defaults to `databaseName`.\n   */\n  persistenceDatabaseName?: string;\n\n  /**\n   * OPFS root directory name for the SQLite database file and blob storage.\n   * Defaults to `databaseName` or `\"syncore\"`.\n   */\n  opfsRootDirectoryName?: string;\n\n  /**\n   * Namespace prefix for blob storage keys. Defaults to `databaseName` or\n   * `\"syncore\"`.\n   */\n  storageNamespace?: string;\n\n  /**\n   * Explicit URL for the `sql.js` WebAssembly binary.\n   *\n   * Syncore resolves the URL automatically in most bundler setups. Override\n   * this only if the auto-resolved URL is incorrect (e.g. in a custom CDN\n   * deploy or a worker with a different asset base path).\n   */\n  wasmUrl?: string;\n\n  /**\n   * Custom file resolver for SQL.js support files (wasm + worker scripts).\n   *\n   * Takes a filename (e.g. `\"sql-wasm.wasm\"`) and returns the full URL.\n   * Equivalent to sql.js’s `locateFile` option. Use `wasmUrl` instead when\n   * you only need to override the `.wasm` path.\n   */\n  locateFile?: (fileName: string) => string;\n\n  /**\n   * Platform label reported to the devtools dashboard.\n   * Defaults to `\"browser\"`.\n   */\n  platform?: string;\n\n  /** Human-readable app name shown in the devtools dashboard header. */\n  appName?: string;\n\n  /**\n   * Explicit devtools WebSocket server URL.\n   * Defaults to `ws://127.0.0.1:4311` (the Syncore devtools default port).\n   */\n  devtoolsUrl?: string;\n\n  /**\n   * Devtools event sink. Pass `false` to disable devtools entirely\n   * (recommended for production builds). Omit to auto-connect to the local\n   * devtools server when running in development.\n   */\n  devtools?: DevtoolsSink | false;\n\n  /** Scheduler configuration for background and recurring jobs. */\n  scheduler?: SchedulerOptions;\n}\n\n/**\n * Options for hosting a Syncore runtime inside a dedicated browser Worker.\n *\n * Extends {@link CreateWebRuntimeOptions} with the `endpoint` field that wires\n * the runtime to the worker’s message port. Use this inside a worker entry\n * file (`syncore.worker.ts`):\n *\n * ```ts\n * // syncore.worker.ts\n * import { createWebWorkerSyncoreRuntime } from \"syncorejs/browser\";\n * import schema from \"./syncore/schema\";\n * import { functions } from \"./syncore/_generated/functions\";\n *\n * createWebWorkerSyncoreRuntime({\n *   schema,\n *   functions,\n *   endpoint: self as unknown as SyncoreWorkerMessageEndpoint,\n * });\n * ```\n */\nexport interface CreateWebWorkerRuntimeOptions<\n  TSchema extends WebSyncoreSchema = WebSyncoreSchema\n> extends CreateWebRuntimeOptions<TSchema> {\n  /** The message endpoint exposed by the current worker global. */\n  endpoint: SyncoreWorkerMessageEndpoint;\n}\n\n/**\n * Alias of {@link CreateWebRuntimeOptions} for the `syncorejs/browser` surface.\n * @see CreateWebRuntimeOptions\n */\nexport type CreateBrowserRuntimeOptions<\n  TSchema extends BrowserSyncoreSchema = BrowserSyncoreSchema\n> = CreateWebRuntimeOptions<TSchema>;\n\n/**\n * Alias of {@link CreateWebWorkerRuntimeOptions} for the `syncorejs/browser` surface.\n * @see CreateWebWorkerRuntimeOptions\n */\nexport type CreateBrowserWorkerRuntimeOptions<\n  TSchema extends BrowserSyncoreSchema = BrowserSyncoreSchema\n> = CreateWebWorkerRuntimeOptions<TSchema>;\n\n/**\n * Internal bookkeeping for the browser cross-tab change synchronisation layer.\n *\n * Holds the `BroadcastChannel`-based signal that publishes and receives\n * database-change events between tabs, and optionally an `applier` that\n * reconciles incoming changes into an in-memory SQL.js database.\n *\n * You do not need to use this directly — `createWebSyncoreRuntime` builds it\n * for you from your options. Exposed for advanced setups (e.g. Expo web) that\n * construct the change support layer independently.\n */\nexport interface WebExternalChangeSupport {\n  signal: BroadcastChannelExternalChangeSignal;\n  applier?: SqlJsExternalChangeApplier;\n}\n\n/**\n * Create a full Syncore runtime directly in the browser (main thread or\n * shared worker).\n *\n * This function sets up SQL.js, the OPFS/IndexedDB persistence layer,\n * OPFS-backed blob storage when available, cross-tab change synchronisation via `BroadcastChannel`, and\n * auto-connects to the devtools server in development.\n *\n * @remarks\n * Most React/Svelte apps should run the runtime inside a `Worker` using\n * `createWebWorkerSyncoreRuntime()` instead, so that SQLite queries don’t\n * block the main thread. Use `createWebSyncoreRuntime` only when a worker is\n * not practical (e.g. in Electron renderer processes or certain test setups).\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({ schema, functions });\n * await runtime.start();\n * const client = runtime.createClient();\n * ```\n */\nexport async function createWebSyncoreRuntime<TSchema extends WebSyncoreSchema>(\n  options: CreateWebRuntimeOptions<TSchema>\n): Promise<SyncoreRuntime<TSchema>> {\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 wasmUrl =\n    options.wasmUrl ??\n    (options.locateFile || !isBrowserLikeRuntime()\n      ? undefined\n      : await resolveDefaultWebWasmUrl());\n  const driver =\n    options.driver ??\n    (await SqlJsDriver.create({\n      databaseName: options.databaseName ?? \"syncore\",\n      persistence,\n      ...(wasmUrl ? { wasmUrl } : {}),\n      ...(options.locateFile ? { locateFile: options.locateFile } : {})\n    }));\n  const storageNamespace =\n    options.storageNamespace ?? options.databaseName ?? \"syncore\";\n  const storage =\n    options.storage ??\n    (persistence.storageProtocol === \"opfs\"\n      ? new BrowserFileStorageAdapter(persistence, storageNamespace)\n      : new UnavailableBrowserStorageAdapter(\n          BROWSER_STORAGE_UNAVAILABLE_REASON\n        ));\n  const runtimeCapabilities = createBrowserRuntimeCapabilities(\n    persistence,\n    storage,\n    Boolean(options.storage)\n  );\n  const externalChangeSupport = createWebExternalChangeSupport({\n    databaseName: options.databaseName ?? \"syncore\",\n    persistence,\n    driver\n  });\n  const appName = options.appName ?? resolveWebAppName();\n  const origin = resolveWebOrigin();\n  const sessionLabel = resolveWebSessionLabel();\n  const databaseLabel = options.databaseName ?? \"syncore\";\n  const storageScopeId = await resolvePersistedStorageScopeId(\n    persistence,\n    databaseLabel\n  );\n  const dataSourceAlias = await resolvePersistedDataSourceAlias(\n    persistence,\n    databaseLabel\n  );\n  const storageIdentity = [\n    origin ?? \"unknown-origin\",\n    persistence.storageProtocol,\n    databaseLabel,\n    storageScopeId\n  ].join(\"::\");\n  const autoDevtools =\n    options.devtools === undefined && shouldAutoConnectDevtools()\n      ? (() => {\n          const sinkOptions: BrowserWebSocketDevtoolsSinkOptions = {\n            url: options.devtoolsUrl ?? resolveDefaultDevtoolsUrl(),\n            targetKind: \"client\",\n            storageProtocol: persistence.storageProtocol,\n            databaseLabel,\n            dataSourceAlias,\n            storageIdentity,\n            capabilities: createBrowserDevtoolsCapabilities(runtimeCapabilities)\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  announceBrowserSession({\n    enabled: resolvedDevtools !== undefined,\n    sessionLabel,\n    appName,\n    origin,\n    devtoolsUrl:\n      options.devtools && typeof options.devtools === \"object\"\n        ? undefined\n        : (options.devtoolsUrl ?? resolveDefaultDevtoolsUrl())\n  });\n\n  const runtime = new SyncoreRuntime({\n    schema: options.schema,\n    functions: options.functions,\n    ...(options.components ? { components: options.components } : {}),\n    driver,\n    storage,\n    externalChangeSignal: externalChangeSupport.signal,\n    ...(externalChangeSupport.applier\n      ? { externalChangeApplier: externalChangeSupport.applier }\n      : {}),\n    platform: options.platform ?? \"browser\",\n    ...(options.capabilities ? { capabilities: options.capabilities } : {}),\n    runtimeCapabilities,\n    ...(resolvedDevtools ? { devtools: resolvedDevtools } : {}),\n    ...(options.scheduler ? { scheduler: options.scheduler } : {})\n  });\n\n  if (isAttachableBrowserDevtoolsSink(resolvedDevtools)) {\n    resolvedDevtools.attachRuntime(runtime);\n    resolvedDevtools.attachCommandHandler(\n      createDevtoolsCommandHandler({\n        driver,\n        schema: options.schema,\n        functions: options.functions,\n        admin: runtime.getAdmin()\n      })\n    );\n    resolvedDevtools.attachSubscriptionHost(\n      createDevtoolsSubscriptionHost({\n        driver,\n        schema: options.schema,\n        functions: options.functions,\n        admin: runtime.getAdmin()\n      })\n    );\n  }\n\n  return runtime;\n}\n\nfunction isAttachableBrowserDevtoolsSink(\n  sink: DevtoolsSink | undefined\n): sink is BrowserWebSocketDevtoolsSink {\n  return (\n    !!sink &&\n    typeof (sink as BrowserWebSocketDevtoolsSink).attachRuntime ===\n      \"function\" &&\n    typeof (sink as BrowserWebSocketDevtoolsSink).attachCommandHandler ===\n      \"function\" &&\n    typeof (sink as BrowserWebSocketDevtoolsSink).attachSubscriptionHost ===\n      \"function\"\n  );\n}\n\n/**\n * Build a {@link WebExternalChangeSupport} bundle for a given database and\n * persistence layer.\n *\n * Creates a `BroadcastChannel`-based signal so that all tabs sharing the same\n * `databaseName` are notified when a mutation commits. When `driver` is a\n * `SqlJsDriver` (i.e. an in-memory database), an `applier` is also created so\n * the local database can be updated from the latest on-disk snapshot.\n *\n * Called automatically by `createWebSyncoreRuntime`. Exposed for advanced use\n * cases such as the Expo web adapter.\n */\nexport function createWebExternalChangeSupport(options: {\n  databaseName: string;\n  persistence: SyncoreWebPersistence;\n  driver: CreateWebRuntimeOptions<SyncoreDataModel>[\"driver\"] | undefined;\n}): WebExternalChangeSupport {\n  const signal = new BroadcastChannelExternalChangeSignal({\n    channelName: createDefaultSyncChannelName(options.databaseName)\n  });\n  const sqlDriver =\n    options.driver instanceof SqlJsDriver ? options.driver : undefined;\n\n  if (!sqlDriver) {\n    return { signal };\n  }\n\n  return {\n    signal,\n    applier: new SqlJsExternalChangeApplier({\n      databaseName: options.databaseName,\n      persistence: options.persistence,\n      createDatabase: (bytes) => sqlDriver.createDatabaseFromBytes(bytes),\n      replaceDatabase: (database) => {\n        sqlDriver.replaceDatabase(database);\n      }\n    })\n  };\n}\n\n/**\n * Build a {@link WebExternalChangeSupport} bundle for an Expo app running on\n * the web platform.\n *\n * Behaves identically to {@link createWebExternalChangeSupport} but accepts\n * the same options shape used by `createExpoSyncoreRuntime`, making it easy\n * to share config when bootstrapping an Expo web runtime.\n *\n * Called internally by the Expo platform adapter. Use directly only when\n * constructing the runtime outside of `createExpoSyncoreRuntime`.\n */\nexport async function createExpoWebExternalChangeSupport(options: {\n  databaseName: string;\n  locateFile?: (fileName: string) => string;\n  wasmUrl?: string;\n  persistenceDatabaseName?: string;\n  opfsRootDirectoryName?: string;\n  persistenceMode?: WebPersistenceMode;\n}): Promise<WebExternalChangeSupport> {\n  const persistence = await createWebPersistence({\n    ...(options.persistenceMode ? { mode: options.persistenceMode } : {}),\n    ...(options.persistenceDatabaseName\n      ? { indexedDbDatabaseName: options.persistenceDatabaseName }\n      : {}),\n    opfsRootDirectoryName: options.opfsRootDirectoryName ?? options.databaseName\n  });\n  const wasmUrl =\n    options.wasmUrl ??\n    (options.locateFile || !isBrowserLikeRuntime()\n      ? undefined\n      : await resolveDefaultWebWasmUrl());\n  const driver = await SqlJsDriver.create({\n    databaseName: options.databaseName,\n    persistence,\n    ...(wasmUrl ? { wasmUrl } : {}),\n    ...(options.locateFile ? { locateFile: options.locateFile } : {})\n  });\n\n  return createWebExternalChangeSupport({\n    databaseName: options.databaseName,\n    persistence,\n    driver\n  });\n}\n\n/**\n * Start a Syncore runtime inside a browser `Worker` and wire it to the\n * worker’s own message endpoint.\n *\n * This is the function you call **inside your worker file** (`syncore.worker.ts`).\n * It creates the full runtime (SQL.js + OPFS + BroadcastChannel) in the worker\n * context and begins listening for messages from the main-thread client.\n *\n * ```ts\n * // syncore.worker.ts\n * import { createWebWorkerRuntime } from \"syncorejs/browser\";\n * import schema from \"./syncore/schema\";\n * import { functions } from \"./syncore/_generated/functions\";\n *\n * void createWebWorkerRuntime({\n *   schema,\n *   functions,\n *   endpoint: self as unknown as SyncoreWorkerMessageEndpoint,\n * });\n * ```\n *\n * On the main thread, connect with `createManagedWebWorkerClient()` or\n * `SyncoreNextProvider` (Next.js).\n */\nexport function createWebWorkerRuntime<TSchema extends WebSyncoreSchema>(\n  options: CreateWebWorkerRuntimeOptions<TSchema>\n) {\n  return attachWebWorkerRuntime({\n    endpoint: options.endpoint,\n    createRuntime: () =>\n      createWebSyncoreRuntime({\n        ...options,\n        platform: options.platform ?? \"browser-worker\"\n      })\n  });\n}\n\n/**\n * Alias of {@link createWebWorkerRuntime} for the `syncorejs/browser` surface.\n * @see createWebWorkerRuntime\n */\nexport function createBrowserWorkerRuntime(\n  options: CreateBrowserWorkerRuntimeOptions\n) {\n  return createWebWorkerRuntime(options);\n}\n\n/**\n * Create a same-process Syncore client from a started browser runtime.\n *\n * Use this when the runtime lives in the same context as the client (e.g.\n * main-thread runtime in an Electron renderer or a test harness). For\n * worker-based setups use `createManagedWebWorkerClient()` instead, which\n * communicates with the worker over `postMessage`.\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({ schema, functions });\n * await runtime.start();\n * const client = createWebSyncoreClient(runtime);\n * ```\n */\nexport function createWebSyncoreClient<TSchema extends WebSyncoreSchema>(\n  runtime: SyncoreRuntime<TSchema>\n) {\n  return runtime.createClient();\n}\n\n/**\n * Alias of {@link createWebSyncoreRuntime} for the `syncorejs/browser` surface.\n * @see createWebSyncoreRuntime\n */\nexport function createBrowserSyncoreRuntime<\n  TSchema extends BrowserSyncoreSchema\n>(options: CreateBrowserRuntimeOptions<TSchema>) {\n  return createWebSyncoreRuntime(options);\n}\n\n/**\n * Alias of {@link createWebSyncoreClient} for the `syncorejs/browser` surface.\n * @see createWebSyncoreClient\n */\nexport function createBrowserSyncoreClient<\n  TSchema extends BrowserSyncoreSchema\n>(runtime: SyncoreRuntime<TSchema>) {\n  return createWebSyncoreClient(runtime);\n}\n\n/**\n * Configuration options for {@link createBrowserWebSocketDevtoolsSink}.\n *\n * All fields except `url` are optional — `createWebSyncoreRuntime` fills them\n * in automatically from the runtime’s own metadata.\n */\nexport interface BrowserWebSocketDevtoolsSinkOptions {\n  /** WebSocket URL of the Syncore devtools server, e.g. `\"ws://127.0.0.1:4311\"`. */\n  url: string;\n  /**\n   * How long to wait before attempting a reconnect after the WebSocket closes,\n   * in milliseconds. Defaults to `1200`.\n   */\n  reconnectDelayMs?: number;\n  /** Human-readable app name shown in the devtools dashboard header. */\n  appName?: string;\n  /** Origin label (e.g. `window.location.origin`) shown in the devtools session list. */\n  origin?: string;\n  /** Session label auto-generated from the tab’s URL path; helps distinguish multiple open tabs. */\n  sessionLabel?: string;\n  /** Kind of this devtools participant. Always `\"client\"` for browser runtimes. */\n  targetKind?: \"client\";\n  /** Persistence protocol tag reported to devtools (e.g. `\"opfs\"`, `\"indexeddb\"`). */\n  storageProtocol?: string;\n  /** Logical database name used to group sessions in the devtools UI. */\n  databaseLabel?: string;\n  /** Stable alias for the data source, used by devtools for cross-session continuity. */\n  dataSourceAlias?: string;\n  /**\n   * Opaque identity string that uniquely identifies this database across origin\n   * + persistence protocol + name, used by devtools for data-source tracking.\n   */\n  storageIdentity?: string;\n  /** Capability flags advertising what devtools features this runtime supports. */\n  capabilities?: SyncoreDevtoolsCapabilities;\n}\n\nasync function resolveDefaultWebWasmUrl(): Promise<string | undefined> {\n  try {\n    const module = await import(\"./web-sqljs-wasm.js\");\n    return module.resolveDefaultWebSqlJsWasmUrl();\n  } catch (error) {\n    if (!isBrowserLikeRuntime()) {\n      return undefined;\n    }\n    throw new Error(\n      \"Syncore could not resolve the default sql.js WebAssembly asset. \" +\n        \"Pass wasmUrl or locateFile to createWebSyncoreRuntime/createBrowserWorkerRuntime for this bundler.\",\n      { cause: error }\n    );\n  }\n}\n\nfunction isBrowserLikeRuntime(): boolean {\n  const scope = globalThis as typeof globalThis & {\n    WorkerGlobalScope?: unknown;\n  };\n  return typeof window !== \"undefined\" || scope.WorkerGlobalScope !== undefined;\n}\n\n/**\n * A DevtoolsSink that forwards runtime events to the Syncore devtools\n * dashboard over a persistent WebSocket connection with auto-reconnect.\n *\n * Returned by {@link createBrowserWebSocketDevtoolsSink}. You typically do not\n * use this interface directly — `createWebSyncoreRuntime` creates and manages\n * the sink automatically when running in development.\n */\nexport interface BrowserWebSocketDevtoolsSink extends DevtoolsSink {\n  /** Attach the runtime so the sink can pull metadata for devtools messages. */\n  attachRuntime(runtime: SyncoreRuntime<WebSyncoreSchema>): void;\n  /** Attach the command handler that processes devtools RPC commands. */\n  attachCommandHandler(handler: DevtoolsCommandHandler): void;\n  /** Attach the subscription host for live query streaming. */\n  attachSubscriptionHost(host: DevtoolsSubscriptionHost): void;\n  /** Close the WebSocket and stop reconnecting. Call on runtime shutdown. */\n  dispose(): void;\n}\n\n/**\n * Create a WebSocket-based devtools sink that connects to the Syncore devtools\n * server and forwards runtime events in real time.\n *\n * The sink auto-reconnects if the connection drops (e.g. while the devtools\n * dashboard is restarting) and buffers events that arrive before the socket is\n * open.\n *\n * In most cases you do not need to call this directly — `createWebSyncoreRuntime`\n * creates and attaches the sink automatically when `devtools` is omitted and the\n * page is served from a local/private hostname.\n *\n * ```ts\n * const sink = createBrowserWebSocketDevtoolsSink({\n *   url: \"ws://127.0.0.1:4311\",\n *   appName: \"My App\",\n * });\n * const runtime = await createWebSyncoreRuntime({ schema, functions, devtools: sink });\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 getSummary: (() => SyncoreRuntimeSummary) | undefined;\n  let onCommand: DevtoolsCommandHandler | undefined;\n  let subscriptionHost: DevtoolsSubscriptionHost | 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          protocolVersion: SYNCORE_DEVTOOLS_PROTOCOL_VERSION,\n          minSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION,\n          maxSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION,\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          ...(options.targetKind ? { targetKind: options.targetKind } : {}),\n          ...(options.storageProtocol\n            ? { storageProtocol: options.storageProtocol }\n            : {}),\n          ...(options.databaseLabel\n            ? { databaseLabel: options.databaseLabel }\n            : {}),\n          ...(options.dataSourceAlias\n            ? { dataSourceAlias: options.dataSourceAlias }\n            : {}),\n          ...(options.storageIdentity\n            ? { storageIdentity: options.storageIdentity }\n            : {}),\n          capabilities:\n            options.capabilities ?? createBrowserDevtoolsCapabilities()\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        | SyncoreDevtoolsClientMessage;\n      if (message.type === \"ping\") {\n        send({ type: \"pong\" });\n      } else if (message.type === \"command\" && onCommand) {\n        onCommand(message.payload)\n          .then((responsePayload) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSummary?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"command.result\",\n              commandId: message.commandId,\n              runtimeId,\n              payload: responsePayload\n            });\n          })\n          .catch((err) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSummary?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"command.result\",\n              commandId: message.commandId,\n              runtimeId,\n              payload: {\n                kind: \"error\",\n                message: err instanceof Error ? err.message : \"Unknown error\"\n              }\n            });\n          });\n      } else if (message.type === \"subscribe\" && subscriptionHost) {\n        void subscriptionHost.subscribe(\n          message.subscriptionId,\n          message.payload,\n          (payload) => {\n            const runtimeId =\n              latestHello?.runtimeId ?? getSummary?.().runtimeId;\n            if (!runtimeId) {\n              return;\n            }\n            send({\n              type: \"subscription.data\",\n              subscriptionId: message.subscriptionId,\n              runtimeId,\n              payload\n            });\n          }\n        );\n      } else if (message.type === \"unsubscribe\") {\n        subscriptionHost?.unsubscribe(message.subscriptionId);\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          protocolVersion: SYNCORE_DEVTOOLS_PROTOCOL_VERSION,\n          minSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION,\n          maxSupportedProtocolVersion:\n            SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION,\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          ...(options.targetKind ? { targetKind: options.targetKind } : {}),\n          ...(options.storageProtocol\n            ? { storageProtocol: options.storageProtocol }\n            : {}),\n          ...(options.databaseLabel\n            ? { databaseLabel: options.databaseLabel }\n            : {}),\n          ...(options.dataSourceAlias\n            ? { dataSourceAlias: options.dataSourceAlias }\n            : {}),\n          ...(options.storageIdentity\n            ? { storageIdentity: options.storageIdentity }\n            : {}),\n          capabilities:\n            options.capabilities ?? createBrowserDevtoolsCapabilities()\n        });\n      }\n      send({ type: \"event\", event });\n    },\n    attachRuntime(runtime) {\n      getSummary = () =>\n        withRuntimeSummaryMeta(runtime.getAdmin().getRuntimeSummary(), options);\n    },\n    attachCommandHandler(handler) {\n      onCommand = handler;\n    },\n    attachSubscriptionHost(host) {\n      subscriptionHost = host;\n    },\n    dispose() {\n      disposed = true;\n      if (connectTimer) {\n        clearTimeout(connectTimer);\n      }\n      subscriptionHost?.dispose();\n      socket?.close();\n    }\n  };\n}\n\nfunction withRuntimeSummaryMeta(\n  summary: SyncoreRuntimeSummary,\n  options: BrowserWebSocketDevtoolsSinkOptions\n): SyncoreRuntimeSummary {\n  return {\n    ...summary,\n    ...(options.appName ? { appName: options.appName } : {}),\n    ...(options.origin ? { origin: options.origin } : {}),\n    ...(options.sessionLabel ? { sessionLabel: options.sessionLabel } : {}),\n    ...(options.targetKind ? { targetKind: options.targetKind } : {}),\n    ...(options.storageProtocol\n      ? { storageProtocol: options.storageProtocol }\n      : {}),\n    ...(options.databaseLabel ? { databaseLabel: options.databaseLabel } : {}),\n    ...(options.dataSourceAlias\n      ? { dataSourceAlias: options.dataSourceAlias }\n      : {}),\n    ...(options.storageIdentity\n      ? { storageIdentity: options.storageIdentity }\n      : {}),\n    capabilities: options.capabilities ?? createBrowserDevtoolsCapabilities()\n  };\n}\n\nfunction createBrowserRuntimeCapabilities(\n  persistence: SyncoreWebPersistence,\n  storage: SyncoreStorageAdapter,\n  hasExplicitStorage: boolean\n): SyncoreRuntimeCapabilities {\n  if (!hasExplicitStorage && persistence.storageProtocol !== \"opfs\") {\n    return {\n      storage: {\n        available: false,\n        reason: BROWSER_STORAGE_UNAVAILABLE_REASON,\n        protocol: persistence.storageProtocol,\n        supportsRange: false\n      }\n    };\n  }\n  return {\n    storage: {\n      available: true,\n      protocol: hasExplicitStorage ? \"custom\" : persistence.storageProtocol,\n      ...(storage.supportsRange\n        ? { supportsRange: storage.supportsRange() !== false }\n        : {})\n    }\n  };\n}\n\nfunction createBrowserDevtoolsCapabilities(\n  runtimeCapabilities?: SyncoreRuntimeCapabilities\n): SyncoreDevtoolsCapabilities {\n  const storageCapability = runtimeCapabilities?.storage;\n  const storageAvailable = storageCapability?.available !== false;\n  return {\n    sql: {\n      read: false,\n      write: false,\n      live: false,\n      reason: \"SQL Console is not available for browser runtimes.\"\n    },\n    data: {\n      browse: true,\n      mutate: true,\n      importExport: true\n    },\n    storage: {\n      browse: storageAvailable,\n      download: storageAvailable,\n      readRange: storageCapability?.supportsRange === true,\n      delete: storageAvailable,\n      maxPreviewBytes: 80_000,\n      ...(!storageAvailable && storageCapability?.reason\n        ? { reason: storageCapability.reason }\n        : {})\n    },\n    scheduler: {\n      read: true,\n      edit: true\n    }\n  };\n}\n\nfunction shouldAutoConnectDevtools(): boolean {\n  const hostname = resolveWebHostname();\n  if (!hostname) {\n    return false;\n  }\n  return (\n    hostname === \"localhost\" ||\n    isPrivateNetworkHostname(hostname) ||\n    hostname.endsWith(\".local\")\n  );\n}\n\nfunction resolveDefaultDevtoolsUrl(): string {\n  return \"ws://127.0.0.1:4311\";\n}\n\nfunction resolveLocationString(\n  key: \"href\" | \"origin\" | \"hostname\"\n): string | undefined {\n  try {\n    const value = globalThis.location?.[key];\n    return typeof value === \"string\" && value.length > 0 ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveGlobalOrigin(): string | undefined {\n  try {\n    const value = (globalThis as { origin?: unknown }).origin;\n    return typeof value === \"string\" && value.length > 0 ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction parseUrlCandidate(candidate: string | undefined): URL | undefined {\n  if (!candidate || candidate === \"null\") {\n    return undefined;\n  }\n  try {\n    const parsed = new URL(candidate);\n    if (parsed.protocol === \"blob:\" && parsed.pathname.length > 0) {\n      try {\n        return new URL(parsed.pathname);\n      } catch {\n        return parsed;\n      }\n    }\n    return parsed;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWebHostname(): string | undefined {\n  const directHostname = resolveLocationString(\"hostname\");\n  if (directHostname) {\n    return directHostname;\n  }\n  return (\n    parseUrlCandidate(resolveLocationString(\"href\"))?.hostname ||\n    parseUrlCandidate(resolveLocationString(\"origin\"))?.hostname ||\n    parseUrlCandidate(resolveGlobalOrigin())?.hostname ||\n    undefined\n  );\n}\n\nfunction isPrivateNetworkHostname(hostname: string): boolean {\n  const normalized = hostname.toLowerCase().replace(/^\\[|\\]$/g, \"\");\n  if (normalized === \"::1\") {\n    return true;\n  }\n  if (normalized.startsWith(\"fc\") || normalized.startsWith(\"fd\")) {\n    return true;\n  }\n  const match = /^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/.exec(normalized);\n  if (!match) {\n    return false;\n  }\n  const octets = match.slice(1).map((part) => Number(part));\n  if (octets.some((part) => Number.isNaN(part) || part < 0 || part > 255)) {\n    return false;\n  }\n  const first = octets[0];\n  const second = octets[1];\n  if (first === undefined || second === undefined) {\n    return false;\n  }\n  return (\n    first === 10 ||\n    first === 127 ||\n    (first === 169 && second === 254) ||\n    (first === 172 && second >= 16 && second <= 31) ||\n    (first === 192 && second === 168)\n  );\n}\n\nfunction resolveWebOrigin(): string | undefined {\n  const directOrigin = resolveLocationString(\"origin\");\n  if (directOrigin && directOrigin !== \"null\") {\n    return directOrigin;\n  }\n  const parsedOrigin =\n    parseUrlCandidate(resolveLocationString(\"href\"))?.origin ||\n    parseUrlCandidate(resolveGlobalOrigin())?.origin;\n  return parsedOrigin && parsedOrigin !== \"null\" ? parsedOrigin : undefined;\n}\n\nfunction resolveWebAppName(): string | undefined {\n  try {\n    return resolveWebHostname() ?? globalThis.document?.title ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWebSessionLabel(): string | undefined {\n  try {\n    if (typeof navigator === \"undefined\") {\n      return undefined;\n    }\n\n    // Generate or retrieve a persistent unique name for this browser instance.\n    // This makes it much easier to identify which browser tab/window you're\n    // looking at in the devtools dashboard.\n    const STORAGE_KEY = \"syncore-session-name\";\n    let uniqueName: string | null = null;\n\n    try {\n      uniqueName = globalThis.localStorage?.getItem(STORAGE_KEY) ?? null;\n    } catch {\n      /* localStorage may not be available */\n    }\n\n    if (!uniqueName) {\n      uniqueName = generateUniqueSessionName();\n\n      try {\n        globalThis.localStorage?.setItem(STORAGE_KEY, uniqueName);\n      } catch {\n        /* ignore storage errors */\n      }\n    }\n\n    const browser = resolveBrowserName(navigator);\n\n    return `${uniqueName} (${browser})`;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveBrowserName(\n  nav: Navigator & {\n    userAgentData?: {\n      brands?: Array<{\n        brand: string;\n      }>;\n    };\n  }\n): string {\n  const brands = nav.userAgentData?.brands?.map((entry) => entry.brand) ?? [];\n\n  if (brands.some((brand) => /microsoft edge/i.test(brand))) {\n    return \"Edge\";\n  }\n  if (brands.some((brand) => /firefox/i.test(brand))) {\n    return \"Firefox\";\n  }\n  if (brands.some((brand) => /opera/i.test(brand))) {\n    return \"Opera\";\n  }\n  if (brands.some((brand) => /chrome|chromium/i.test(brand))) {\n    return \"Chrome\";\n  }\n  if (brands.some((brand) => /safari/i.test(brand))) {\n    return \"Safari\";\n  }\n\n  const userAgent = nav.userAgent;\n  if (/Firefox\\//i.test(userAgent)) {\n    return \"Firefox\";\n  }\n  if (/Edg\\//i.test(userAgent)) {\n    return \"Edge\";\n  }\n  if (/OPR\\/|Opera/i.test(userAgent)) {\n    return \"Opera\";\n  }\n  if (/Chrome\\/|CriOS\\//i.test(userAgent)) {\n    return \"Chrome\";\n  }\n  if (/Safari\\//i.test(userAgent)) {\n    return \"Safari\";\n  }\n  return \"Browser\";\n}\n\nasync function resolvePersistedStorageScopeId(\n  persistence: SyncoreWebPersistence,\n  databaseLabel: string\n): Promise<string> {\n  const id = `${STORAGE_SCOPE_ID_PREFIX}:${databaseLabel}`;\n  const existing = await persistence.getFile(DEVTOOLS_META_NAMESPACE, id);\n\n  if (existing) {\n    const value = new TextDecoder().decode(existing.bytes).trim();\n    if (value.length > 0) {\n      return value;\n    }\n  }\n\n  const nextValue = generateId();\n  await persistence.putFile(\n    DEVTOOLS_META_NAMESPACE,\n    id,\n    new TextEncoder().encode(nextValue),\n    \"text/plain\"\n  );\n  return nextValue;\n}\n\nasync function resolvePersistedDataSourceAlias(\n  persistence: SyncoreWebPersistence,\n  databaseLabel: string\n): Promise<string> {\n  const id = `${DATA_SOURCE_ALIAS_PREFIX}:${databaseLabel}`;\n  const existing = await persistence.getFile(DEVTOOLS_META_NAMESPACE, id);\n\n  if (existing) {\n    const value = new TextDecoder().decode(existing.bytes).trim();\n    if (value.length > 0) {\n      return value;\n    }\n  }\n\n  const nextValue = generateUniqueSessionName();\n  await persistence.putFile(\n    DEVTOOLS_META_NAMESPACE,\n    id,\n    new TextEncoder().encode(nextValue),\n    \"text/plain\"\n  );\n  return nextValue;\n}\n\nfunction announceBrowserSession(options: {\n  enabled: boolean;\n  sessionLabel?: string | undefined;\n  appName?: string | undefined;\n  origin?: string | undefined;\n  devtoolsUrl?: string | undefined;\n}): void {\n  if (!options.enabled || !options.sessionLabel) {\n    return;\n  }\n\n  const announcedSessions = getAnnouncedBrowserSessions();\n  if (announcedSessions.has(options.sessionLabel)) {\n    return;\n  }\n  announcedSessions.add(options.sessionLabel);\n\n  try {\n    const details = [\n      options.appName ? `app=${options.appName}` : undefined,\n      options.origin ? `origin=${options.origin}` : undefined,\n      options.devtoolsUrl ? `devtools=${options.devtoolsUrl}` : undefined\n    ].filter((value): value is string => value !== undefined);\n\n    console.info(\n      `[syncore] Browser session: ${options.sessionLabel}${details.length > 0 ? ` (${details.join(\", \")})` : \"\"}`\n    );\n  } catch {\n    /* ignore console failures */\n  }\n}\n\nfunction getAnnouncedBrowserSessions(): Set<string> {\n  const key = \"__syncoreAnnouncedBrowserSessions\";\n  const scope = globalThis as typeof globalThis & {\n    [key]?: Set<string>;\n  };\n  if (!scope[key]) {\n    scope[key] = new Set<string>();\n  }\n  return scope[key];\n}\n\n/* ------------------------------------------------------------------ */\n/*  Unique session name generator                                      */\n/* ------------------------------------------------------------------ */\n\nconst SESSION_ADJECTIVES = [\n  \"Acrobatic\",\n  \"Bold\",\n  \"Cosmic\",\n  \"Daring\",\n  \"Electric\",\n  \"Fierce\",\n  \"Golden\",\n  \"Hidden\",\n  \"Iron\",\n  \"Jade\",\n  \"Keen\",\n  \"Lunar\",\n  \"Mystic\",\n  \"Noble\",\n  \"Orbital\",\n  \"Primal\",\n  \"Quick\",\n  \"Radiant\",\n  \"Shadow\",\n  \"Turbo\",\n  \"Ultra\",\n  \"Vivid\",\n  \"Wicked\",\n  \"Xenon\",\n  \"Zen\",\n  \"Arctic\",\n  \"Binary\",\n  \"Cyber\",\n  \"Digital\",\n  \"Ember\",\n  \"Frozen\",\n  \"Galactic\",\n  \"Hyper\",\n  \"Infra\",\n  \"Jumbo\",\n  \"Kinetic\",\n  \"Liquid\",\n  \"Magnetic\",\n  \"Neon\",\n  \"Onyx\",\n  \"Phantom\",\n  \"Quantum\",\n  \"Rapid\",\n  \"Sonic\",\n  \"Titan\",\n  \"Velvet\",\n  \"Wild\",\n  \"Blazing\",\n  \"Crystal\",\n  \"Dynamic\"\n] as const;\n\nconst SESSION_NOUNS = [\n  \"Monkey\",\n  \"Phoenix\",\n  \"Tiger\",\n  \"Dragon\",\n  \"Falcon\",\n  \"Panther\",\n  \"Wolf\",\n  \"Eagle\",\n  \"Cobra\",\n  \"Shark\",\n  \"Raven\",\n  \"Fox\",\n  \"Lynx\",\n  \"Hawk\",\n  \"Bear\",\n  \"Jaguar\",\n  \"Viper\",\n  \"Owl\",\n  \"Stallion\",\n  \"Dolphin\",\n  \"Developer\",\n  \"Hacker\",\n  \"Wizard\",\n  \"Ninja\",\n  \"Pilot\",\n  \"Pioneer\",\n  \"Voyager\",\n  \"Explorer\",\n  \"Runner\",\n  \"Ranger\",\n  \"Maverick\",\n  \"Spartan\",\n  \"Viking\",\n  \"Sentinel\",\n  \"Guardian\",\n  \"Nomad\",\n  \"Cipher\",\n  \"Vector\",\n  \"Matrix\",\n  \"Prism\",\n  \"Nebula\",\n  \"Comet\",\n  \"Pulse\",\n  \"Vertex\",\n  \"Flux\",\n  \"Storm\",\n  \"Blaze\",\n  \"Frost\",\n  \"Thunder\",\n  \"Drift\"\n] as const;\n\nconst BROWSER_STORAGE_UNAVAILABLE_REASON =\n  \"Browser file storage requires OPFS. IndexedDB is used for data only.\";\n\nfunction generateUniqueSessionName(): string {\n  const adj =\n    SESSION_ADJECTIVES[Math.floor(Math.random() * SESSION_ADJECTIVES.length)]!;\n  const noun = SESSION_NOUNS[Math.floor(Math.random() * SESSION_NOUNS.length)]!;\n  return `${adj} ${noun}`;\n}\n\n/**\n * Browser file/blob storage adapter backed by `SyncoreWebPersistence`.\n *\n * Stores binary blobs (images, documents, etc.) in OPFS alongside the SQLite\n * database. Pass an instance to\n * `CreateWebRuntimeOptions.storage` to enable Syncore's Storage API\n * (`ctx.storage.put`, `ctx.storage.get`, etc.) in browser functions.\n *\n * ```ts\n * const runtime = await createWebSyncoreRuntime({\n *   schema,\n *   functions,\n *   storage: new BrowserFileStorageAdapter(persistence, \"files\"),\n * });\n * ```\n */\nexport class BrowserFileStorageAdapter implements SyncoreStorageAdapter {\n  constructor(\n    private readonly persistence: SyncoreWebPersistence,\n    private readonly namespace: string\n  ) {\n    if (persistence.storageProtocol !== \"opfs\") {\n      throw new Error(BROWSER_STORAGE_UNAVAILABLE_REASON);\n    }\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  supportsRange(): boolean {\n    return Boolean(this.persistence.getFileRange);\n  }\n\n  async readRange(\n    id: string,\n    offset: number,\n    length: number\n  ): Promise<Uint8Array | null> {\n    if (!this.persistence.getFileRange) {\n      return null;\n    }\n    const file = await this.persistence.getFileRange(\n      this.namespace,\n      id,\n      offset,\n      length\n    );\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 = this.persistence.listFileMetadata\n      ? await this.persistence.listFileMetadata(this.namespace)\n      : 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\nclass UnavailableBrowserStorageAdapter implements SyncoreStorageAdapter {\n  constructor(private readonly reason: string) {}\n\n  async put(): Promise<StorageObject> {\n    throw new Error(this.reason);\n  }\n\n  async get(): Promise<StorageObject | null> {\n    throw new Error(this.reason);\n  }\n\n  async read(): Promise<Uint8Array | null> {\n    throw new Error(this.reason);\n  }\n\n  supportsRange(): boolean {\n    return false;\n  }\n\n  async delete(): Promise<void> {\n    throw new Error(this.reason);\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/_vendor/platform-web/indexeddb.d.ts

@@ -9,9 +9,9 @@ interface IndexedDbPersistenceOptions {
 /**
  * IndexedDB-backed {@link SyncoreWebPersistence} implementation.
  *
- * Stores the SQLite database blob and file objects in dedicated IndexedDB
- * object stores. Used automatically when OPFS is unavailable or when the
- * persistence mode is explicitly set to `"indexeddb"`.
+ * Stores the SQLite database blob in IndexedDB. It still satisfies the lower
+ * level persistence interface for compatibility, but Syncore's default browser
+ * file storage is OPFS-only and will not use IndexedDB for blobs.
  *
  * Prefer `createWebPersistence()` over constructing this directly unless
  * you need to pass a specific IndexedDB database name.

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

@@ -2,9 +2,9 @@
 /**
 * IndexedDB-backed {@link SyncoreWebPersistence} implementation.
 *
-* Stores the SQLite database blob and file objects in dedicated IndexedDB
-* object stores. Used automatically when OPFS is unavailable or when the
-* persistence mode is explicitly set to `"indexeddb"`.
+* Stores the SQLite database blob in IndexedDB. It still satisfies the lower
+* level persistence interface for compatibility, but Syncore's default browser
+* file storage is OPFS-only and will not use IndexedDB for blobs.
 *
 * Prefer `createWebPersistence()` over constructing this directly unless
 * you need to pass a specific IndexedDB database name.