syncorejs 0.2.2 → 0.2.4

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

@@ -1,27 +1,111 @@
 //#region src/persistence.d.ts
+/**
+ * A binary file record stored in web persistence (OPFS or IndexedDB).
+ * Returned by `SyncoreWebPersistence.getFile` and `listFiles`.
+ */
 interface StoredWebFile {
+  /** Unique file identifier within its namespace. */
   id: string;
+  /** Raw file bytes. */
   bytes: Uint8Array;
+  /** MIME type, or `null` if none was recorded at write time. */
   contentType: string | null;
+  /** File size in bytes. */
   size: number;
 }
+/**
+ * A byte range from a web persistence file, plus total object metadata.
+ */
+interface StoredWebFileRange {
+  /** Unique file identifier within its namespace. */
+  id: string;
+  /** Raw bytes for the requested range. */
+  bytes: Uint8Array;
+  /** MIME type, or `null` if none was recorded at write time. */
+  contentType: string | null;
+  /** Total file size in bytes. */
+  size: number;
+  /** Offset used for this range. */
+  offset: number;
+}
+/**
+ * Metadata for a web persistence file without the raw bytes.
+ */
+interface StoredWebFileMetadata {
+  /** Unique file identifier within its namespace. */
+  id: string;
+  /** MIME type, or `null` if none was recorded at write time. */
+  contentType: string | null;
+  /** Total file size in bytes. */
+  size: number;
+}
+/**
+ * Abstraction over browser storage backends (OPFS or IndexedDB).
+ *
+ * Handles both the SQLite database blob and binary file objects. All
+ * implementations must persist data across page reloads.
+ *
+ * The concrete implementation is chosen by `createWebPersistence` based on
+ * browser capabilities and the requested `WebPersistenceMode`.
+ */
 interface SyncoreWebPersistence {
+  /** The storage protocol used: `"opfs"` (Origin Private File System) or `"idb"` (IndexedDB). */
   readonly storageProtocol: "idb" | "opfs";
+  /** Load the serialized SQLite database for `key`, or `null` if none has been saved yet. */
   loadDatabase(key: string): Promise<Uint8Array | null>;
+  /** Persist the serialized SQLite database bytes for `key`. */
   saveDatabase(key: string, bytes: Uint8Array): Promise<void>;
+  /** Retrieve a stored file from `namespace` by `id`, or `null` if not found. */
   getFile(namespace: string, id: string): Promise<StoredWebFile | null>;
+  /** Retrieve a byte range without loading the whole file when supported. */
+  getFileRange?(namespace: string, id: string, offset: number, length: number): Promise<StoredWebFileRange | null>;
+  /** Write a file into `namespace` under `id`, replacing any existing entry. */
   putFile(namespace: string, id: string, bytes: Uint8Array, contentType: string | null): Promise<void>;
+  /** Delete a file from `namespace` by `id`. No-op if the file does not exist. */
   deleteFile(namespace: string, id: string): Promise<void>;
+  /** List all stored files in `namespace`. */
   listFiles(namespace: string): Promise<StoredWebFile[]>;
+  /** List stored file metadata without loading file bytes when supported. */
+  listFileMetadata?(namespace: string): Promise<StoredWebFileMetadata[]>;
 }
+/**
+ * Which browser storage backend Syncore should use for SQLite persistence.
+ *
+ * - `"opfs"` — Origin Private File System. Fastest option; available in
+ *   Chrome 102+, Safari 15.2+, and modern Firefox. **Required** for
+ *   multi-tab coordination using `SharedArrayBuffer`.
+ * - `"indexeddb"` — Falls back to IndexedDB for browsers without OPFS.
+ *   Slower due to serialization overhead but universally available.
+ * - `"auto"` *(default)* — Picks `"opfs"` when available, otherwise
+ *   `"indexeddb"`.
+ */
 type WebPersistenceMode = "auto" | "indexeddb" | "opfs";
+/** Options for {@link createWebPersistence}. */
 interface CreateWebPersistenceOptions {
+  /** Persistence backend to use. Defaults to `"auto"`. */
   mode?: WebPersistenceMode;
+  /** Custom IndexedDB database name. Defaults to the Syncore database name. */
   indexedDbDatabaseName?: string;
+  /** Root directory name inside the OPFS bucket. Defaults to the Syncore database name. */
   opfsRootDirectoryName?: string;
 }
+/**
+ * Create the appropriate web persistence backend based on browser capabilities
+ * and the requested mode.
+ *
+ * Call this if you need a `SyncoreWebPersistence` instance outside of
+ * `createWebSyncoreRuntime` (e.g. in the Expo adapter). In a standard
+ * browser setup, `createWebSyncoreRuntime` calls this automatically.
+ */
 declare function createWebPersistence(options?: CreateWebPersistenceOptions): Promise<SyncoreWebPersistence>;
+/**
+ * Return `true` if the Origin Private File System API is available in the
+ * current browser context.
+ *
+ * Used internally to decide whether to prefer OPFS over IndexedDB in `"auto"`
+ * mode. Also useful in application code for displaying conditional UI.
+ */
 declare function isOpfsAvailable(): boolean;
 //#endregion
-export { CreateWebPersistenceOptions, StoredWebFile, SyncoreWebPersistence, WebPersistenceMode, createWebPersistence, isOpfsAvailable };
+export { CreateWebPersistenceOptions, StoredWebFile, StoredWebFileMetadata, StoredWebFileRange, SyncoreWebPersistence, WebPersistenceMode, createWebPersistence, isOpfsAvailable };
 //# sourceMappingURL=persistence.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.ts","names":[],"sources":["../src/persistence.ts"],"mappings":";UAGiB,aAAA;EACf,EAAA;EACA,KAAA,EAAO,UAAA;EACP,WAAA;EACA,IAAA;AAAA;AAAA,UAGe,qBAAA;EAAA,SACN,eAAA;EACT,YAAA,CAAa,GAAA,WAAc,OAAA,CAAQ,UAAA;EACnC,YAAA,CAAa,GAAA,UAAa,KAAA,EAAO,UAAA,GAAa,OAAA;EAC9C,OAAA,CAAQ,SAAA,UAAmB,EAAA,WAAa,OAAA,CAAQ,aAAA;EAChD,OAAA,CACE,SAAA,UACA,EAAA,UACA,KAAA,EAAO,UAAA,EACP,WAAA,kBACC,OAAA;EACH,UAAA,CAAW,SAAA,UAAmB,EAAA,WAAa,OAAA;EAC3C,SAAA,CAAU,SAAA,WAAoB,OAAA,CAAQ,aAAA;AAAA;AAAA,KAG5B,kBAAA;AAAA,UAEK,2BAAA;EACf,IAAA,GAAO,kBAAA;EACP,qBAAA;EACA,qBAAA;AAAA;AAAA,iBAGoB,oBAAA,CACpB,OAAA,GAAS,2BAAA,GACR,OAAA,CAAQ,qBAAA;AAAA,iBA6BK,eAAA,CAAA"}
+{"version":3,"file":"persistence.d.ts","names":[],"sources":["../src/persistence.ts"],"mappings":";;AAOA;;;UAAiB,aAAA;EAEf;EAAA,EAAA;EAEO;EAAP,KAAA,EAAO,UAAU;EAIjB;EAFA,WAAA;EAEI;EAAJ,IAAA;AAAA;;;;UAMe,kBAAA;EAIR;EAFP,EAAA;EAMA;EAJA,KAAA,EAAO,UAAU;EAMX;EAJN,WAAA;EAUe;EARf,IAAA;;EAEA,MAAA;AAAA;;;;UAMe,qBAAA;EAkBA;EAhBf,EAAA;;EAEA,WAAA;EAkB2B;EAhB3B,IAAA;AAAA;;;;;;;;;;UAYe,qBAAA;EA4BuB;EAAA,SA1B7B,eAAA;EA0BoC;EAxB7C,YAAA,CAAa,GAAA,WAAc,OAAA,CAAQ,UAAA;EAAnC;EAEA,YAAA,CAAa,GAAA,UAAa,KAAA,EAAO,UAAA,GAAa,OAAA;EAFnB;EAI3B,OAAA,CAAQ,SAAA,UAAmB,EAAA,WAAa,OAAA,CAAQ,aAAA;EAFhD;EAIA,YAAA,EACE,SAAA,UACA,EAAA,UACA,MAAA,UACA,MAAA,WACC,OAAA,CAAQ,kBAAA;EATsB;EAWjC,OAAA,CACE,SAAA,UACA,EAAA,UACA,KAAA,EAAO,UAAA,EACP,WAAA,kBACC,OAAA;EAhB2C;EAkB9C,UAAA,CAAW,SAAA,UAAmB,EAAA,WAAa,OAAA;EAhBnC;EAkBR,SAAA,CAAU,SAAA,WAAoB,OAAA,CAAQ,aAAA;EAlBE;EAoBxC,gBAAA,EAAkB,SAAA,WAAoB,OAAA,CAAQ,qBAAA;AAAA;;;;;;;;;;;;KAcpC,kBAAA;;UAGK,2BAAA;EArBJ;EAuBX,IAAA,GAAO,kBAAkB;EAvBkB;EAyB3C,qBAAA;EAvBU;EAyBV,qBAAA;AAAA;;;;;;AAvBmE;AAcrE;;iBAoBsB,oBAAA,CACpB,OAAA,GAAS,2BAAA,GACR,OAAA,CAAQ,qBAAA;;AAtBmB;AAG9B;;;;;iBAuDgB,eAAA,CAAA"}

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

@@ -1,6 +1,14 @@
 import { SyncoreIndexedDbPersistence } from "./indexeddb.js";
 import { SyncoreOpfsPersistence } from "./opfs.js";
 //#region src/persistence.ts
+/**
+* Create the appropriate web persistence backend based on browser capabilities
+* and the requested mode.
+*
+* Call this if you need a `SyncoreWebPersistence` instance outside of
+* `createWebSyncoreRuntime` (e.g. in the Expo adapter). In a standard
+* browser setup, `createWebSyncoreRuntime` calls this automatically.
+*/
 async function createWebPersistence(options = {}) {
 	const mode = options.mode ?? "auto";
 	if (mode === "opfs") {
@@ -10,6 +18,13 @@ async function createWebPersistence(options = {}) {
 	if (mode === "auto" && isOpfsAvailable()) return new SyncoreOpfsPersistence(options.opfsRootDirectoryName ? { rootDirectoryName: options.opfsRootDirectoryName } : void 0);
 	return new SyncoreIndexedDbPersistence(options.indexedDbDatabaseName ? { databaseName: options.indexedDbDatabaseName } : void 0);
 }
+/**
+* Return `true` if the Origin Private File System API is available in the
+* current browser context.
+*
+* Used internally to decide whether to prefer OPFS over IndexedDB in `"auto"`
+* mode. Also useful in application code for displaying conditional UI.
+*/
 function isOpfsAvailable() {
 	return Boolean(getOpfsStorageManager()?.getDirectory);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"persistence.js","names":[],"sources":["../src/persistence.ts"],"sourcesContent":["import { SyncoreIndexedDbPersistence } from \"./indexeddb.js\";\nimport { SyncoreOpfsPersistence } from \"./opfs.js\";\n\nexport interface StoredWebFile {\n  id: string;\n  bytes: Uint8Array;\n  contentType: string | null;\n  size: number;\n}\n\nexport interface SyncoreWebPersistence {\n  readonly storageProtocol: \"idb\" | \"opfs\";\n  loadDatabase(key: string): Promise<Uint8Array | null>;\n  saveDatabase(key: string, bytes: Uint8Array): Promise<void>;\n  getFile(namespace: string, id: string): Promise<StoredWebFile | null>;\n  putFile(\n    namespace: string,\n    id: string,\n    bytes: Uint8Array,\n    contentType: string | null\n  ): Promise<void>;\n  deleteFile(namespace: string, id: string): Promise<void>;\n  listFiles(namespace: string): Promise<StoredWebFile[]>;\n}\n\nexport type WebPersistenceMode = \"auto\" | \"indexeddb\" | \"opfs\";\n\nexport interface CreateWebPersistenceOptions {\n  mode?: WebPersistenceMode;\n  indexedDbDatabaseName?: string;\n  opfsRootDirectoryName?: string;\n}\n\nexport async function createWebPersistence(\n  options: CreateWebPersistenceOptions = {}\n): Promise<SyncoreWebPersistence> {\n  const mode = options.mode ?? \"auto\";\n\n  if (mode === \"opfs\") {\n    if (!isOpfsAvailable()) {\n      throw new Error(\"OPFS is not available in this environment.\");\n    }\n    return new SyncoreOpfsPersistence(\n      options.opfsRootDirectoryName\n        ? { rootDirectoryName: options.opfsRootDirectoryName }\n        : undefined\n    );\n  }\n\n  if (mode === \"auto\" && isOpfsAvailable()) {\n    return new SyncoreOpfsPersistence(\n      options.opfsRootDirectoryName\n        ? { rootDirectoryName: options.opfsRootDirectoryName }\n        : undefined\n    );\n  }\n\n  return new SyncoreIndexedDbPersistence(\n    options.indexedDbDatabaseName\n      ? { databaseName: options.indexedDbDatabaseName }\n      : undefined\n  );\n}\n\nexport function isOpfsAvailable(): boolean {\n  return Boolean(getOpfsStorageManager()?.getDirectory);\n}\n\ntype OpfsStorageManager = StorageManager & {\n  getDirectory?: () => Promise<FileSystemDirectoryHandle>;\n};\n\nfunction getOpfsStorageManager(): OpfsStorageManager | undefined {\n  if (typeof navigator === \"undefined\") {\n    return undefined;\n  }\n  return navigator.storage as OpfsStorageManager | undefined;\n}\n"],"mappings":";;;AAiCA,eAAsB,qBACpB,UAAuC,EAAE,EACT;CAChC,MAAM,OAAO,QAAQ,QAAQ;AAE7B,KAAI,SAAS,QAAQ;AACnB,MAAI,CAAC,iBAAiB,CACpB,OAAM,IAAI,MAAM,6CAA6C;AAE/D,SAAO,IAAI,uBACT,QAAQ,wBACJ,EAAE,mBAAmB,QAAQ,uBAAuB,GACpD,KAAA,EACL;;AAGH,KAAI,SAAS,UAAU,iBAAiB,CACtC,QAAO,IAAI,uBACT,QAAQ,wBACJ,EAAE,mBAAmB,QAAQ,uBAAuB,GACpD,KAAA,EACL;AAGH,QAAO,IAAI,4BACT,QAAQ,wBACJ,EAAE,cAAc,QAAQ,uBAAuB,GAC/C,KAAA,EACL;;AAGH,SAAgB,kBAA2B;AACzC,QAAO,QAAQ,uBAAuB,EAAE,aAAa;;AAOvD,SAAS,wBAAwD;AAC/D,KAAI,OAAO,cAAc,YACvB;AAEF,QAAO,UAAU"}
+{"version":3,"file":"persistence.js","names":[],"sources":["../src/persistence.ts"],"sourcesContent":["import { SyncoreIndexedDbPersistence } from \"./indexeddb.js\";\nimport { SyncoreOpfsPersistence } from \"./opfs.js\";\n\n/**\n * A binary file record stored in web persistence (OPFS or IndexedDB).\n * Returned by `SyncoreWebPersistence.getFile` and `listFiles`.\n */\nexport interface StoredWebFile {\n  /** Unique file identifier within its namespace. */\n  id: string;\n  /** Raw file bytes. */\n  bytes: Uint8Array;\n  /** MIME type, or `null` if none was recorded at write time. */\n  contentType: string | null;\n  /** File size in bytes. */\n  size: number;\n}\n\n/**\n * A byte range from a web persistence file, plus total object metadata.\n */\nexport interface StoredWebFileRange {\n  /** Unique file identifier within its namespace. */\n  id: string;\n  /** Raw bytes for the requested range. */\n  bytes: Uint8Array;\n  /** MIME type, or `null` if none was recorded at write time. */\n  contentType: string | null;\n  /** Total file size in bytes. */\n  size: number;\n  /** Offset used for this range. */\n  offset: number;\n}\n\n/**\n * Metadata for a web persistence file without the raw bytes.\n */\nexport interface StoredWebFileMetadata {\n  /** Unique file identifier within its namespace. */\n  id: string;\n  /** MIME type, or `null` if none was recorded at write time. */\n  contentType: string | null;\n  /** Total file size in bytes. */\n  size: number;\n}\n\n/**\n * Abstraction over browser storage backends (OPFS or IndexedDB).\n *\n * Handles both the SQLite database blob and binary file objects. All\n * implementations must persist data across page reloads.\n *\n * The concrete implementation is chosen by `createWebPersistence` based on\n * browser capabilities and the requested `WebPersistenceMode`.\n */\nexport interface SyncoreWebPersistence {\n  /** The storage protocol used: `\"opfs\"` (Origin Private File System) or `\"idb\"` (IndexedDB). */\n  readonly storageProtocol: \"idb\" | \"opfs\";\n  /** Load the serialized SQLite database for `key`, or `null` if none has been saved yet. */\n  loadDatabase(key: string): Promise<Uint8Array | null>;\n  /** Persist the serialized SQLite database bytes for `key`. */\n  saveDatabase(key: string, bytes: Uint8Array): Promise<void>;\n  /** Retrieve a stored file from `namespace` by `id`, or `null` if not found. */\n  getFile(namespace: string, id: string): Promise<StoredWebFile | null>;\n  /** Retrieve a byte range without loading the whole file when supported. */\n  getFileRange?(\n    namespace: string,\n    id: string,\n    offset: number,\n    length: number\n  ): Promise<StoredWebFileRange | null>;\n  /** Write a file into `namespace` under `id`, replacing any existing entry. */\n  putFile(\n    namespace: string,\n    id: string,\n    bytes: Uint8Array,\n    contentType: string | null\n  ): Promise<void>;\n  /** Delete a file from `namespace` by `id`. No-op if the file does not exist. */\n  deleteFile(namespace: string, id: string): Promise<void>;\n  /** List all stored files in `namespace`. */\n  listFiles(namespace: string): Promise<StoredWebFile[]>;\n  /** List stored file metadata without loading file bytes when supported. */\n  listFileMetadata?(namespace: string): Promise<StoredWebFileMetadata[]>;\n}\n\n/**\n * Which browser storage backend Syncore should use for SQLite persistence.\n *\n * - `\"opfs\"` — Origin Private File System. Fastest option; available in\n *   Chrome 102+, Safari 15.2+, and modern Firefox. **Required** for\n *   multi-tab coordination using `SharedArrayBuffer`.\n * - `\"indexeddb\"` — Falls back to IndexedDB for browsers without OPFS.\n *   Slower due to serialization overhead but universally available.\n * - `\"auto\"` *(default)* — Picks `\"opfs\"` when available, otherwise\n *   `\"indexeddb\"`.\n */\nexport type WebPersistenceMode = \"auto\" | \"indexeddb\" | \"opfs\";\n\n/** Options for {@link createWebPersistence}. */\nexport interface CreateWebPersistenceOptions {\n  /** Persistence backend to use. Defaults to `\"auto\"`. */\n  mode?: WebPersistenceMode;\n  /** Custom IndexedDB database name. Defaults to the Syncore database name. */\n  indexedDbDatabaseName?: string;\n  /** Root directory name inside the OPFS bucket. Defaults to the Syncore database name. */\n  opfsRootDirectoryName?: string;\n}\n\n/**\n * Create the appropriate web persistence backend based on browser capabilities\n * and the requested mode.\n *\n * Call this if you need a `SyncoreWebPersistence` instance outside of\n * `createWebSyncoreRuntime` (e.g. in the Expo adapter). In a standard\n * browser setup, `createWebSyncoreRuntime` calls this automatically.\n */\nexport async function createWebPersistence(\n  options: CreateWebPersistenceOptions = {}\n): Promise<SyncoreWebPersistence> {\n  const mode = options.mode ?? \"auto\";\n\n  if (mode === \"opfs\") {\n    if (!isOpfsAvailable()) {\n      throw new Error(\"OPFS is not available in this environment.\");\n    }\n    return new SyncoreOpfsPersistence(\n      options.opfsRootDirectoryName\n        ? { rootDirectoryName: options.opfsRootDirectoryName }\n        : undefined\n    );\n  }\n\n  if (mode === \"auto\" && isOpfsAvailable()) {\n    return new SyncoreOpfsPersistence(\n      options.opfsRootDirectoryName\n        ? { rootDirectoryName: options.opfsRootDirectoryName }\n        : undefined\n    );\n  }\n\n  return new SyncoreIndexedDbPersistence(\n    options.indexedDbDatabaseName\n      ? { databaseName: options.indexedDbDatabaseName }\n      : undefined\n  );\n}\n\n/**\n * Return `true` if the Origin Private File System API is available in the\n * current browser context.\n *\n * Used internally to decide whether to prefer OPFS over IndexedDB in `\"auto\"`\n * mode. Also useful in application code for displaying conditional UI.\n */\nexport function isOpfsAvailable(): boolean {\n  return Boolean(getOpfsStorageManager()?.getDirectory);\n}\n\ntype OpfsStorageManager = StorageManager & {\n  getDirectory?: () => Promise<FileSystemDirectoryHandle>;\n};\n\nfunction getOpfsStorageManager(): OpfsStorageManager | undefined {\n  if (typeof navigator === \"undefined\") {\n    return undefined;\n  }\n  return navigator.storage as OpfsStorageManager | undefined;\n}\n"],"mappings":";;;;;;;;;;;AAqHA,eAAsB,qBACpB,UAAuC,CAAC,GACR;CAChC,MAAM,OAAO,QAAQ,QAAQ;CAE7B,IAAI,SAAS,QAAQ;EACnB,IAAI,CAAC,gBAAgB,GACnB,MAAM,IAAI,MAAM,4CAA4C;EAE9D,OAAO,IAAI,uBACT,QAAQ,wBACJ,EAAE,mBAAmB,QAAQ,sBAAsB,IACnD,KAAA,CACN;CACF;CAEA,IAAI,SAAS,UAAU,gBAAgB,GACrC,OAAO,IAAI,uBACT,QAAQ,wBACJ,EAAE,mBAAmB,QAAQ,sBAAsB,IACnD,KAAA,CACN;CAGF,OAAO,IAAI,4BACT,QAAQ,wBACJ,EAAE,cAAc,QAAQ,sBAAsB,IAC9C,KAAA,CACN;AACF;;;;;;;;AASA,SAAgB,kBAA2B;CACzC,OAAO,QAAQ,sBAAsB,GAAG,YAAY;AACtD;AAMA,SAAS,wBAAwD;CAC/D,IAAI,OAAO,cAAc,aACvB;CAEF,OAAO,UAAU;AACnB"}

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

@@ -1,6 +1,5 @@
 import { CreateWebWorkerClientProviderOptions } from "./worker.js";
 import { ReactNode } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/react.d.ts
 /**
@@ -29,7 +28,7 @@ declare function SyncoreWebProvider({
 /**
  * Start a worker-backed Syncore client and provide it to React descendants.
  */
-declare function SyncoreBrowserProvider(props: SyncoreBrowserProviderProps): react_jsx_runtime0.JSX.Element;
+declare function SyncoreBrowserProvider(props: SyncoreBrowserProviderProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 export { SyncoreBrowserProvider, SyncoreBrowserProviderProps, SyncoreWebProvider, SyncoreWebProviderProps };
 //# sourceMappingURL=react.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react.tsx"],"mappings":";;;;;;;;UAgBiB,uBAAA,SAAgC,oCAAA;EAAR;EAEvC,QAAA,EAAU,SAAA;EAAA;EAGV,QAAA,GAAW,SAAA;AAAA;;;;KAMD,2BAAA,GAA8B,uBAAA;;;;iBAK1B,kBAAA,CAAA;EACd,QAAA;EACA,SAAA;EACA,UAAA;EACA,UAAA;EACA;AAAA,GACC,uBAAA,GAA0B,SAAA;;AAX7B;;iBAiEgB,sBAAA,CAAuB,KAAA,EAAO,2BAAA,GAA2B,kBAAA,CAAA,GAAA,CAAA,OAAA"}
+{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react.tsx"],"mappings":";;;;;;AAgBA;UAAiB,uBAAA,SAAgC,oCAAA;;EAE/C,QAAA,EAAU,SAAA;EAGC;EAAX,QAAA,GAAW,SAAA;AAAA;;;;KAMD,2BAAA,GAA8B,uBAAuB;;;;iBAKjD,kBAAA,CAAA;EACd,QAAA;EACA,SAAA;EACA,UAAA;EACA,UAAA;EACA;AAAA,GACC,uBAAA,GAA0B,SAAA;AAX7B;;;AAAA,iBAoEgB,sBAAA,CAAuB,KAAA,EAAO,2BAA2B,+BAAA,GAAA,CAAA,OAAA"}

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

@@ -10,11 +10,14 @@ import { jsx } from "react/jsx-runtime";
 function SyncoreWebProvider({ children, workerUrl, workerType, workerName, fallback = null }) {
 	const bootingClient = useMemo(() => createUnavailableSyncoreClient({
 		kind: "starting",
-		reason: "booting"
+		reason: "booting",
+		capabilities: { storage: {
+			available: false,
+			reason: "Syncore worker is booting."
+		} }
 	}), []);
 	const [client, setClient] = useState(bootingClient);
 	useEffect(() => {
-		let disposed = false;
 		let managedClient;
 		setClient(bootingClient);
 		try {
@@ -23,16 +26,19 @@ function SyncoreWebProvider({ children, workerUrl, workerType, workerName, fallb
 				...workerType ? { workerType } : {},
 				...workerName ? { workerName } : {}
 			});
-			if (!disposed) setClient(managedClient.client);
+			setClient(managedClient.client);
 		} catch (error) {
-			if (!disposed) setClient(createUnavailableSyncoreClient({
+			setClient(createUnavailableSyncoreClient({
 				kind: "unavailable",
 				reason: "worker-unavailable",
+				capabilities: { storage: {
+					available: false,
+					reason: "Syncore worker is unavailable."
+				} },
 				...error instanceof Error ? { error } : {}
 			}));
 		}
 		return () => {
-			disposed = true;
 			managedClient?.dispose();
 		};
 	}, [

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

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import {\n  createUnavailableSyncoreClient,\n  type SyncoreClient\n} from \"@syncore/core\";\nimport { useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { SyncoreProvider } from \"@syncore/react\";\nimport {\n  createSyncoreWebWorkerClient,\n  type CreateWebWorkerClientProviderOptions,\n  type ManagedWebWorkerClient\n} from \"./worker.js\";\n\n/**\n * Props for {@link SyncoreWebProvider}.\n */\nexport interface SyncoreWebProviderProps extends CreateWebWorkerClientProviderOptions {\n  /** The React subtree that should receive the Syncore client. */\n  children: ReactNode;\n\n  /** Optional fallback content rendered before the worker client is ready. */\n  fallback?: ReactNode;\n}\n\n/**\n * Props for {@link SyncoreBrowserProvider}.\n */\nexport type SyncoreBrowserProviderProps = SyncoreWebProviderProps;\n\n/**\n * Start a worker-backed Syncore client and provide it to React descendants.\n */\nexport function SyncoreWebProvider({\n  children,\n  workerUrl,\n  workerType,\n  workerName,\n  fallback = null\n}: SyncoreWebProviderProps): ReactNode {\n  const bootingClient = useMemo(\n    () =>\n      createUnavailableSyncoreClient({\n        kind: \"starting\",\n        reason: \"booting\"\n      }),\n    []\n  );\n  const [client, setClient] = useState<SyncoreClient>(bootingClient);\n\n  useEffect(() => {\n    let disposed = false;\n    let managedClient: ManagedWebWorkerClient | undefined;\n\n    setClient(bootingClient);\n\n    try {\n      managedClient = createSyncoreWebWorkerClient({\n        workerUrl,\n        ...(workerType ? { workerType } : {}),\n        ...(workerName ? { workerName } : {})\n      });\n      if (!disposed) {\n        setClient(managedClient.client);\n      }\n    } catch (error) {\n      if (!disposed) {\n        setClient(\n          createUnavailableSyncoreClient({\n            kind: \"unavailable\",\n            reason: \"worker-unavailable\",\n            ...(error instanceof Error ? { error } : {})\n          })\n        );\n      }\n    }\n\n    return () => {\n      disposed = true;\n      managedClient?.dispose();\n    };\n  }, [bootingClient, workerName, workerType, workerUrl]);\n\n  return (\n    <SyncoreProvider client={client}>\n      {children ?? fallback}\n    </SyncoreProvider>\n  );\n}\n\n/**\n * Start a worker-backed Syncore client and provide it to React descendants.\n */\nexport function SyncoreBrowserProvider(props: SyncoreBrowserProviderProps) {\n  return <SyncoreWebProvider {...props} />;\n}\n"],"mappings":";;;;;;;;;AAgCA,SAAgB,mBAAmB,EACjC,UACA,WACA,YACA,YACA,WAAW,QAC0B;CACrC,MAAM,gBAAgB,cAElB,+BAA+B;EAC7B,MAAM;EACN,QAAQ;EACT,CAAC,EACJ,EAAE,CACH;CACD,MAAM,CAAC,QAAQ,aAAa,SAAwB,cAAc;AAElE,iBAAgB;EACd,IAAI,WAAW;EACf,IAAI;AAEJ,YAAU,cAAc;AAExB,MAAI;AACF,mBAAgB,6BAA6B;IAC3C;IACA,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;IACpC,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;IACrC,CAAC;AACF,OAAI,CAAC,SACH,WAAU,cAAc,OAAO;WAE1B,OAAO;AACd,OAAI,CAAC,SACH,WACE,+BAA+B;IAC7B,MAAM;IACN,QAAQ;IACR,GAAI,iBAAiB,QAAQ,EAAE,OAAO,GAAG,EAAE;IAC5C,CAAC,CACH;;AAIL,eAAa;AACX,cAAW;AACX,kBAAe,SAAS;;IAEzB;EAAC;EAAe;EAAY;EAAY;EAAU,CAAC;AAEtD,QACE,oBAAC,iBAAD;EAAyB;YACtB,YAAY;EACG,CAAA;;;;;AAOtB,SAAgB,uBAAuB,OAAoC;AACzE,QAAO,oBAAC,oBAAD,EAAoB,GAAI,OAAS,CAAA"}
+{"version":3,"file":"react.js","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import {\n  createUnavailableSyncoreClient,\n  type SyncoreClient\n} from \"@syncore/core\";\nimport { useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { SyncoreProvider } from \"@syncore/react\";\nimport {\n  createSyncoreWebWorkerClient,\n  type CreateWebWorkerClientProviderOptions,\n  type ManagedWebWorkerClient\n} from \"./worker.js\";\n\n/**\n * Props for {@link SyncoreWebProvider}.\n */\nexport interface SyncoreWebProviderProps extends CreateWebWorkerClientProviderOptions {\n  /** The React subtree that should receive the Syncore client. */\n  children: ReactNode;\n\n  /** Optional fallback content rendered before the worker client is ready. */\n  fallback?: ReactNode;\n}\n\n/**\n * Props for {@link SyncoreBrowserProvider}.\n */\nexport type SyncoreBrowserProviderProps = SyncoreWebProviderProps;\n\n/**\n * Start a worker-backed Syncore client and provide it to React descendants.\n */\nexport function SyncoreWebProvider({\n  children,\n  workerUrl,\n  workerType,\n  workerName,\n  fallback = null\n}: SyncoreWebProviderProps): ReactNode {\n  const bootingClient = useMemo(\n    () =>\n      createUnavailableSyncoreClient({\n        kind: \"starting\",\n        reason: \"booting\",\n        capabilities: {\n          storage: { available: false, reason: \"Syncore worker is booting.\" }\n        }\n      }),\n    []\n  );\n  const [client, setClient] = useState<SyncoreClient>(bootingClient);\n\n  useEffect(() => {\n    let managedClient: ManagedWebWorkerClient | undefined;\n\n    setClient(bootingClient);\n\n    try {\n      managedClient = createSyncoreWebWorkerClient({\n        workerUrl,\n        ...(workerType ? { workerType } : {}),\n        ...(workerName ? { workerName } : {})\n      });\n      setClient(managedClient.client);\n    } catch (error) {\n      setClient(\n        createUnavailableSyncoreClient({\n          kind: \"unavailable\",\n          reason: \"worker-unavailable\",\n          capabilities: {\n            storage: {\n              available: false,\n              reason: \"Syncore worker is unavailable.\"\n            }\n          },\n          ...(error instanceof Error ? { error } : {})\n        })\n      );\n    }\n\n    return () => {\n      managedClient?.dispose();\n    };\n  }, [bootingClient, workerName, workerType, workerUrl]);\n\n  return (\n    <SyncoreProvider client={client}>\n      {children ?? fallback}\n    </SyncoreProvider>\n  );\n}\n\n/**\n * Start a worker-backed Syncore client and provide it to React descendants.\n */\nexport function SyncoreBrowserProvider(props: SyncoreBrowserProviderProps) {\n  return <SyncoreWebProvider {...props} />;\n}\n"],"mappings":";;;;;;;;;AAgCA,SAAgB,mBAAmB,EACjC,UACA,WACA,YACA,YACA,WAAW,QAC0B;CACrC,MAAM,gBAAgB,cAElB,+BAA+B;EAC7B,MAAM;EACN,QAAQ;EACR,cAAc,EACZ,SAAS;GAAE,WAAW;GAAO,QAAQ;EAA6B,EACpE;CACF,CAAC,GACH,CAAC,CACH;CACA,MAAM,CAAC,QAAQ,aAAa,SAAwB,aAAa;CAEjE,gBAAgB;EACd,IAAI;EAEJ,UAAU,aAAa;EAEvB,IAAI;GACF,gBAAgB,6BAA6B;IAC3C;IACA,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;IACnC,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;GACrC,CAAC;GACD,UAAU,cAAc,MAAM;EAChC,SAAS,OAAO;GACd,UACE,+BAA+B;IAC7B,MAAM;IACN,QAAQ;IACR,cAAc,EACZ,SAAS;KACP,WAAW;KACX,QAAQ;IACV,EACF;IACA,GAAI,iBAAiB,QAAQ,EAAE,MAAM,IAAI,CAAC;GAC5C,CAAC,CACH;EACF;EAEA,aAAa;GACX,eAAe,QAAQ;EACzB;CACF,GAAG;EAAC;EAAe;EAAY;EAAY;CAAS,CAAC;CAErD,OACE,oBAAC,iBAAD;EAAyB;YACtB,YAAY;CACE,CAAA;AAErB;;;;AAKA,SAAgB,uBAAuB,OAAoC;CACzE,OAAO,oBAAC,oBAAD,EAAoB,GAAI,MAAQ,CAAA;AACzC"}

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

@@ -2,6 +2,10 @@ import { SyncoreIndexedDbPersistence } from "./indexeddb.js";
 import initSqlJs from "sql.js";
 //#region src/sqljs.ts
 var SqlJsDriver = class SqlJsDriver {
+	database;
+	persistence;
+	databaseName;
+	createDatabase;
 	transactionDepth = 0;
 	closed = false;
 	constructor(database, persistence, databaseName, createDatabase) {
@@ -12,7 +16,9 @@ var SqlJsDriver = class SqlJsDriver {
 	}
 	static async create(options) {
 		const persistence = options.persistence ?? new SyncoreIndexedDbPersistence();
-		const SQL = await initSqlJs(typeof window === "undefined" && !options.locateFile && !options.wasmUrl ? void 0 : { locateFile: options.locateFile ?? (() => options.wasmUrl ?? "/sql-wasm.wasm") });
+		const hasExplicitWasmResolver = Boolean(options.locateFile ?? options.wasmUrl);
+		if (isBrowserLikeRuntime() && !hasExplicitWasmResolver) throw new Error("SqlJsDriver requires an explicit wasmUrl or locateFile in browser runtimes. Use createWebSyncoreRuntime/createBrowserWorkerRuntime for the default Syncore web resolver.");
+		const SQL = await initSqlJs(!hasExplicitWasmResolver ? void 0 : { locateFile: options.locateFile ?? (() => options.wasmUrl) });
 		const existingBytes = await persistence.loadDatabase(options.databaseName);
 		return new SqlJsDriver(existingBytes ? new SQL.Database(existingBytes) : new SQL.Database(), persistence, options.databaseName, (bytes) => bytes ? new SQL.Database(bytes) : new SQL.Database());
 	}
@@ -130,6 +136,9 @@ var SqlJsDriver = class SqlJsDriver {
 		previousDatabase.close();
 	}
 };
+function isBrowserLikeRuntime() {
+	return typeof window !== "undefined" || globalThis.WorkerGlobalScope !== void 0;
+}
 function normalizeParams(values) {
 	return values.map((value) => {
 		if (typeof value === "boolean") return value ? 1 : 0;

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

@@ -1 +1 @@
-{"version":3,"file":"sqljs.js","names":[],"sources":["../src/sqljs.ts"],"sourcesContent":["import initSqlJs from \"sql.js\";\nimport type { RunResult, SyncoreSqlDriver } from \"@syncore/core\";\nimport { SyncoreIndexedDbPersistence } from \"./indexeddb.js\";\nimport type { SyncoreWebPersistence } from \"./persistence.js\";\n\ntype SqlJsDatabase = initSqlJs.Database;\ntype SqlJsValue = initSqlJs.SqlValue;\n\nexport interface CreateSqlJsDriverOptions {\n  databaseName: string;\n  persistence?: SyncoreWebPersistence;\n  wasmUrl?: string;\n  locateFile?: (fileName: string) => string;\n}\n\nexport class SqlJsDriver implements SyncoreSqlDriver {\n  private transactionDepth = 0;\n  private closed = false;\n\n  constructor(\n    private database: SqlJsDatabase,\n    private readonly persistence: SyncoreWebPersistence,\n    private readonly databaseName: string,\n    private readonly createDatabase: (bytes?: Uint8Array) => SqlJsDatabase\n  ) {}\n\n  static async create(options: CreateSqlJsDriverOptions): Promise<SqlJsDriver> {\n    const persistence =\n      options.persistence ?? new SyncoreIndexedDbPersistence();\n    const SQL = await initSqlJs(\n      typeof window === \"undefined\" && !options.locateFile && !options.wasmUrl\n        ? undefined\n        : {\n            locateFile:\n              options.locateFile ?? (() => options.wasmUrl ?? \"/sql-wasm.wasm\")\n          }\n    );\n    const existingBytes = await persistence.loadDatabase(options.databaseName);\n    const database = existingBytes\n      ? new SQL.Database(existingBytes)\n      : new SQL.Database();\n    return new SqlJsDriver(\n      database,\n      persistence,\n      options.databaseName,\n      (bytes) => (bytes ? new SQL.Database(bytes) : new SQL.Database())\n    );\n  }\n\n  async exec(sql: string): Promise<void> {\n    this.ensureOpen();\n    this.database.run(sql);\n    await this.persistIfNeeded();\n  }\n\n  async run(sql: string, params: unknown[] = []): Promise<RunResult> {\n    this.ensureOpen();\n    const statement = this.database.prepare(sql);\n    try {\n      statement.run(normalizeParams(params));\n      const lastInsertRowid = readScalarNumber(\n        this.database,\n        \"SELECT last_insert_rowid()\"\n      );\n      const result = {\n        changes: this.database.getRowsModified(),\n        ...(lastInsertRowid !== null ? { lastInsertRowid } : {})\n      };\n      await this.persistIfNeeded();\n      return result;\n    } finally {\n      statement.free();\n    }\n  }\n\n  async get<T>(sql: string, params: unknown[] = []): Promise<T | undefined> {\n    this.ensureOpen();\n    const statement = this.database.prepare(sql);\n    try {\n      statement.bind(normalizeParams(params));\n      if (!statement.step()) {\n        return undefined;\n      }\n      return statement.getAsObject() as T;\n    } finally {\n      statement.free();\n    }\n  }\n\n  async all<T>(sql: string, params: unknown[] = []): Promise<T[]> {\n    this.ensureOpen();\n    const statement = this.database.prepare(sql);\n    try {\n      statement.bind(normalizeParams(params));\n      const rows: T[] = [];\n      while (statement.step()) {\n        rows.push(statement.getAsObject() as T);\n      }\n      return rows;\n    } finally {\n      statement.free();\n    }\n  }\n\n  async withTransaction<T>(callback: () => Promise<T>): Promise<T> {\n    this.ensureOpen();\n    if (this.transactionDepth > 0) {\n      return this.withSavepoint(`nested_${this.transactionDepth}`, callback);\n    }\n\n    this.transactionDepth += 1;\n    this.database.run(\"BEGIN IMMEDIATE\");\n    try {\n      const result = await callback();\n      this.database.run(\"COMMIT\");\n      await this.persistNow();\n      return result;\n    } catch (error) {\n      this.database.run(\"ROLLBACK\");\n      throw error;\n    } finally {\n      this.transactionDepth -= 1;\n    }\n  }\n\n  async withSavepoint<T>(name: string, callback: () => Promise<T>): Promise<T> {\n    this.ensureOpen();\n    const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, \"_\");\n    this.database.run(`SAVEPOINT ${safeName}`);\n    this.transactionDepth += 1;\n    try {\n      const result = await callback();\n      this.database.run(`RELEASE SAVEPOINT ${safeName}`);\n      return result;\n    } catch (error) {\n      this.database.run(`ROLLBACK TO SAVEPOINT ${safeName}`);\n      this.database.run(`RELEASE SAVEPOINT ${safeName}`);\n      throw error;\n    } finally {\n      this.transactionDepth -= 1;\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    await this.persistNow();\n    this.database.close();\n    this.closed = true;\n  }\n\n  async reloadFromPersistence(): Promise<boolean> {\n    this.ensureOpen();\n    const bytes = await this.persistence.loadDatabase(this.databaseName);\n    if (!bytes) {\n      return false;\n    }\n    const nextDatabase = this.createDatabase(bytes);\n    const previousDatabase = this.database;\n    this.database = nextDatabase;\n    previousDatabase.close();\n    return true;\n  }\n\n  createDatabaseFromBytes(bytes?: Uint8Array): SqlJsDatabase {\n    return this.createDatabase(bytes);\n  }\n\n  private async persistIfNeeded(): Promise<void> {\n    if (this.transactionDepth === 0) {\n      await this.persistNow();\n    }\n  }\n\n  private async persistNow(): Promise<void> {\n    this.ensureOpen();\n    await this.persistence.saveDatabase(\n      this.databaseName,\n      this.database.export()\n    );\n  }\n\n  private ensureOpen(): void {\n    if (this.closed) {\n      throw new Error(\"The sql.js driver is already closed.\");\n    }\n  }\n\n  replaceDatabase(database: SqlJsDatabase): void {\n    this.ensureOpen();\n    const previousDatabase = this.database;\n    this.database = database;\n    previousDatabase.close();\n  }\n}\n\nfunction normalizeParams(values: unknown[]): SqlJsValue[] {\n  return values.map((value) => {\n    if (typeof value === \"boolean\") {\n      return value ? 1 : 0;\n    }\n    if (\n      value === null ||\n      typeof value === \"number\" ||\n      typeof value === \"string\" ||\n      value instanceof Uint8Array\n    ) {\n      return value;\n    }\n    if (value instanceof ArrayBuffer) {\n      return new Uint8Array(value);\n    }\n    return JSON.stringify(value);\n  });\n}\n\nfunction readScalarNumber(database: SqlJsDatabase, sql: string): number | null {\n  const rows = database.exec(sql);\n  const firstSet = rows[0];\n  const firstRow = firstSet?.values[0];\n  const firstValue = firstRow?.[0];\n  if (typeof firstValue === \"number\") {\n    return firstValue;\n  }\n  if (typeof firstValue === \"string\") {\n    const parsed = Number(firstValue);\n    return Number.isNaN(parsed) ? null : parsed;\n  }\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sqljs.js","names":["scope"],"sources":["../src/sqljs.ts"],"sourcesContent":["import initSqlJs from \"sql.js\";\nimport type { RunResult, SyncoreSqlDriver } from \"@syncore/core\";\nimport { SyncoreIndexedDbPersistence } from \"./indexeddb.js\";\nimport type { SyncoreWebPersistence } from \"./persistence.js\";\n\ntype SqlJsDatabase = initSqlJs.Database;\ntype SqlJsValue = initSqlJs.SqlValue;\n\nexport interface CreateSqlJsDriverOptions {\n  databaseName: string;\n  persistence?: SyncoreWebPersistence;\n  wasmUrl?: string;\n  locateFile?: (fileName: string) => string;\n}\n\nexport class SqlJsDriver implements SyncoreSqlDriver {\n  private transactionDepth = 0;\n  private closed = false;\n\n  constructor(\n    private database: SqlJsDatabase,\n    private readonly persistence: SyncoreWebPersistence,\n    private readonly databaseName: string,\n    private readonly createDatabase: (bytes?: Uint8Array) => SqlJsDatabase\n  ) {}\n\n  static async create(options: CreateSqlJsDriverOptions): Promise<SqlJsDriver> {\n    const persistence =\n      options.persistence ?? new SyncoreIndexedDbPersistence();\n    const hasExplicitWasmResolver = Boolean(options.locateFile ?? options.wasmUrl);\n    if (isBrowserLikeRuntime() && !hasExplicitWasmResolver) {\n      throw new Error(\n        \"SqlJsDriver requires an explicit wasmUrl or locateFile in browser runtimes. \" +\n          \"Use createWebSyncoreRuntime/createBrowserWorkerRuntime for the default Syncore web resolver.\"\n      );\n    }\n    const SQL = await initSqlJs(\n      !hasExplicitWasmResolver\n        ? undefined\n        : {\n            locateFile:\n              options.locateFile ?? (() => options.wasmUrl as string)\n          }\n    );\n    const existingBytes = await persistence.loadDatabase(options.databaseName);\n    const database = existingBytes\n      ? new SQL.Database(existingBytes)\n      : new SQL.Database();\n    return new SqlJsDriver(\n      database,\n      persistence,\n      options.databaseName,\n      (bytes) => (bytes ? new SQL.Database(bytes) : new SQL.Database())\n    );\n  }\n\n  async exec(sql: string): Promise<void> {\n    this.ensureOpen();\n    this.database.run(sql);\n    await this.persistIfNeeded();\n  }\n\n  async run(sql: string, params: unknown[] = []): Promise<RunResult> {\n    this.ensureOpen();\n    const statement = this.database.prepare(sql);\n    try {\n      statement.run(normalizeParams(params));\n      const lastInsertRowid = readScalarNumber(\n        this.database,\n        \"SELECT last_insert_rowid()\"\n      );\n      const result = {\n        changes: this.database.getRowsModified(),\n        ...(lastInsertRowid !== null ? { lastInsertRowid } : {})\n      };\n      await this.persistIfNeeded();\n      return result;\n    } finally {\n      statement.free();\n    }\n  }\n\n  async get<T>(sql: string, params: unknown[] = []): Promise<T | undefined> {\n    this.ensureOpen();\n    const statement = this.database.prepare(sql);\n    try {\n      statement.bind(normalizeParams(params));\n      if (!statement.step()) {\n        return undefined;\n      }\n      return statement.getAsObject() as T;\n    } finally {\n      statement.free();\n    }\n  }\n\n  async all<T>(sql: string, params: unknown[] = []): Promise<T[]> {\n    this.ensureOpen();\n    const statement = this.database.prepare(sql);\n    try {\n      statement.bind(normalizeParams(params));\n      const rows: T[] = [];\n      while (statement.step()) {\n        rows.push(statement.getAsObject() as T);\n      }\n      return rows;\n    } finally {\n      statement.free();\n    }\n  }\n\n  async withTransaction<T>(callback: () => Promise<T>): Promise<T> {\n    this.ensureOpen();\n    if (this.transactionDepth > 0) {\n      return this.withSavepoint(`nested_${this.transactionDepth}`, callback);\n    }\n\n    this.transactionDepth += 1;\n    this.database.run(\"BEGIN IMMEDIATE\");\n    try {\n      const result = await callback();\n      this.database.run(\"COMMIT\");\n      await this.persistNow();\n      return result;\n    } catch (error) {\n      this.database.run(\"ROLLBACK\");\n      throw error;\n    } finally {\n      this.transactionDepth -= 1;\n    }\n  }\n\n  async withSavepoint<T>(name: string, callback: () => Promise<T>): Promise<T> {\n    this.ensureOpen();\n    const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, \"_\");\n    this.database.run(`SAVEPOINT ${safeName}`);\n    this.transactionDepth += 1;\n    try {\n      const result = await callback();\n      this.database.run(`RELEASE SAVEPOINT ${safeName}`);\n      return result;\n    } catch (error) {\n      this.database.run(`ROLLBACK TO SAVEPOINT ${safeName}`);\n      this.database.run(`RELEASE SAVEPOINT ${safeName}`);\n      throw error;\n    } finally {\n      this.transactionDepth -= 1;\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    await this.persistNow();\n    this.database.close();\n    this.closed = true;\n  }\n\n  async reloadFromPersistence(): Promise<boolean> {\n    this.ensureOpen();\n    const bytes = await this.persistence.loadDatabase(this.databaseName);\n    if (!bytes) {\n      return false;\n    }\n    const nextDatabase = this.createDatabase(bytes);\n    const previousDatabase = this.database;\n    this.database = nextDatabase;\n    previousDatabase.close();\n    return true;\n  }\n\n  createDatabaseFromBytes(bytes?: Uint8Array): SqlJsDatabase {\n    return this.createDatabase(bytes);\n  }\n\n  private async persistIfNeeded(): Promise<void> {\n    if (this.transactionDepth === 0) {\n      await this.persistNow();\n    }\n  }\n\n  private async persistNow(): Promise<void> {\n    this.ensureOpen();\n    await this.persistence.saveDatabase(\n      this.databaseName,\n      this.database.export()\n    );\n  }\n\n  private ensureOpen(): void {\n    if (this.closed) {\n      throw new Error(\"The sql.js driver is already closed.\");\n    }\n  }\n\n  replaceDatabase(database: SqlJsDatabase): void {\n    this.ensureOpen();\n    const previousDatabase = this.database;\n    this.database = database;\n    previousDatabase.close();\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\nfunction normalizeParams(values: unknown[]): SqlJsValue[] {\n  return values.map((value) => {\n    if (typeof value === \"boolean\") {\n      return value ? 1 : 0;\n    }\n    if (\n      value === null ||\n      typeof value === \"number\" ||\n      typeof value === \"string\" ||\n      value instanceof Uint8Array\n    ) {\n      return value;\n    }\n    if (value instanceof ArrayBuffer) {\n      return new Uint8Array(value);\n    }\n    return JSON.stringify(value);\n  });\n}\n\nfunction readScalarNumber(database: SqlJsDatabase, sql: string): number | null {\n  const rows = database.exec(sql);\n  const firstSet = rows[0];\n  const firstRow = firstSet?.values[0];\n  const firstValue = firstRow?.[0];\n  if (typeof firstValue === \"number\") {\n    return firstValue;\n  }\n  if (typeof firstValue === \"string\") {\n    const parsed = Number(firstValue);\n    return Number.isNaN(parsed) ? null : parsed;\n  }\n  return null;\n}\n"],"mappings":"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"}

package/dist/_vendor/platform-web/web-sqljs-wasm.js

@@ -0,0 +1,8 @@
+//#region src/web-sqljs-wasm.ts
+function resolveDefaultWebSqlJsWasmUrl() {
+	return new URL("sql.js/dist/sql-wasm.wasm", import.meta.url).toString();
+}
+//#endregion
+export { resolveDefaultWebSqlJsWasmUrl };
+
+//# sourceMappingURL=web-sqljs-wasm.js.map

package/dist/_vendor/platform-web/web-sqljs-wasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-sqljs-wasm.js","names":[],"sources":["../src/web-sqljs-wasm.ts"],"sourcesContent":["export function resolveDefaultWebSqlJsWasmUrl(): string {\n  return new URL(\"sql.js/dist/sql-wasm.wasm\", import.meta.url).toString();\n}\n"],"mappings":";AAAA,SAAgB,gCAAwC;CACtD,OAAO,IAAI,IAAI,6BAA6B,OAAO,KAAK,GAAG,EAAE,SAAS;AACxE"}

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

@@ -1,52 +1,103 @@
 import { AttachRuntimeBridgeOptions, AttachedRuntimeBridge, BridgeQueryWatch, SyncoreBridgeClient, SyncoreBridgeMessageEndpoint, SyncoreDataModel } from "../core/index.d.mts";
 
 //#region src/worker.d.ts
+/**
+ * Schema type constraint for worker-side Syncore runtimes.
+ *
+ * Pass any schema produced by `defineSchema()` where this type is expected.
+ * Defaults to the unconstrained `SyncoreDataModel` when omitted.
+ */
 type WebWorkerSyncoreSchema<TSchema extends SyncoreDataModel = SyncoreDataModel> = TSchema;
+/** Message endpoint shape required by the browser worker bridge (alias of `SyncoreBridgeMessageEndpoint`). */
 type SyncoreWorkerMessageEndpoint = SyncoreBridgeMessageEndpoint;
+/** Live-query subscription handle returned by `SyncoreWebWorkerClient.watchQuery`. */
 type WorkerQueryWatch<TValue> = BridgeQueryWatch<TValue>;
+/**
+ * Syncore client that communicates with a runtime running in a browser Worker
+ * over the `postMessage` bridge.
+ *
+ * Use `createSyncoreWebWorkerClient()` or `createManagedWebWorkerClient()` to
+ * create instances. Prefer the React hooks (`useQuery`, `useMutation`, etc.)
+ * over calling this directly in React apps.
+ */
 declare class SyncoreWebWorkerClient extends SyncoreBridgeClient {
   query: SyncoreBridgeClient["query"];
   mutation: SyncoreBridgeClient["mutation"];
   action: SyncoreBridgeClient["action"];
   watchQuery: SyncoreBridgeClient["watchQuery"];
 }
+/** Options for attaching a runtime to a worker bridge endpoint. Alias of `AttachRuntimeBridgeOptions`. */
 type AttachWebWorkerRuntimeOptions<TSchema extends WebWorkerSyncoreSchema = WebWorkerSyncoreSchema> = AttachRuntimeBridgeOptions<TSchema>;
+/** Handle returned by `attachWebWorkerRuntime` for controlling the attached bridge. */
 type AttachedWebWorkerRuntime = AttachedRuntimeBridge;
 /**
- * A worker-backed browser client plus the Worker instance it owns.
+ * A browser Worker and its associated Syncore client, bundled for easy
+ * lifecycle management.
+ *
+ * Returned by `createSyncoreWebWorkerClient` and `createManagedWebWorkerClient`.
+ * Call `dispose()` to terminate the worker and release its resources.
  */
 interface ManagedWebWorkerClient {
+  /** The Syncore client connected to the worker. */
   client: SyncoreWebWorkerClient;
+  /** The underlying `Worker` instance. Useful for low-level control. */
   worker: Worker;
+  /** Terminate the worker and dispose the client. Call on app unmount or navigation. */
   dispose(): void;
 }
 /**
- * Options for creating a worker-backed Syncore client in the browser.
+ * Options for creating a managed worker Syncore client via
+ * `createSyncoreWebWorkerClient`.
  */
 interface CreateWebWorkerClientProviderOptions {
-  /** The worker module URL passed to `new Worker(...)`. */
+  /** The worker module URL passed to `new Worker(...)`. Typically an `import.meta.url`-relative `URL`. */
   workerUrl: URL | string;
-  /** Optional worker type, defaults to `module`. */
+  /** Worker module type. Defaults to `"module"` (ESM worker). */
   workerType?: WorkerOptions["type"];
-  /** Optional name shown in browser devtools. */
+  /** Optional label shown in browser devtools’ Sources panel. */
   workerName?: string;
 }
 /**
- * Create a web worker Syncore client from a low-level message endpoint.
+ * Create a {@link SyncoreWebWorkerClient} from a low-level message endpoint.
+ *
+ * Use this when you already have a `Worker` or `MessagePort` reference and
+ * want to wrap it manually. For the common case of spawning a new Worker from
+ * a URL, use `createSyncoreWebWorkerClient` instead.
  */
 declare function createWebWorkerClient(endpoint: SyncoreWorkerMessageEndpoint): SyncoreWebWorkerClient;
 /**
- * Create and manage both a browser Worker and the Syncore client that talks to it.
+ * Create a {@link ManagedWebWorkerClient} using a provided Worker factory.
+ *
+ * Useful when you need control over how the Worker is constructed (e.g. to
+ * pass constructor options not exposed by `CreateWebWorkerClientProviderOptions`).
+ * For the common URL-based case, use `createSyncoreWebWorkerClient`.
  */
 declare function createManagedWebWorkerClient(options: {
   createWorker: () => Worker;
 }): ManagedWebWorkerClient;
 /**
- * Create a worker-backed Syncore client using the standard Worker constructor.
+ * Create a {@link ManagedWebWorkerClient} by spawning a new Worker from a URL.
+ *
+ * This is the standard way to create a main-thread client in a browser app.
+ * Pass the URL of your `syncore.worker.ts` file (which calls
+ * `createWebWorkerRuntime`) and connect the returned `client` to your React
+ * `SyncoreProvider` or Svelte context.
+ *
+ * ```ts
+ * // main.ts (or React root)
+ * import { createSyncoreWebWorkerClient } from "syncorejs/browser";
+ *
+ * const { client, dispose } = createSyncoreWebWorkerClient({
+ *   workerUrl: new URL("./syncore.worker.ts", import.meta.url),
+ * });
+ * ```
  */
 declare function createSyncoreWebWorkerClient(options: CreateWebWorkerClientProviderOptions): ManagedWebWorkerClient;
 /**
- * Attach a Syncore runtime implementation to a worker message endpoint.
+ * Wire a Syncore runtime factory to a worker message endpoint.
+ *
+ * Called internally by `createWebWorkerRuntime`. Exposed for cases where you
+ * need to attach a runtime to a custom bridge endpoint (e.g. a `MessagePort`).
  */
 declare function attachWebWorkerRuntime(options: AttachWebWorkerRuntimeOptions): AttachedWebWorkerRuntime;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","names":[],"sources":["../src/worker.ts"],"mappings":";;;KAUY,sBAAA,iBACM,gBAAA,GAAmB,gBAAA,IACjC,OAAA;AAAA,KACQ,4BAAA,GAA+B,4BAAA;AAAA,KAC/B,gBAAA,WAA2B,gBAAA,CAAiB,MAAA;AAAA,cAE3C,sBAAA,SAA+B,mBAAA;EAClC,KAAA,EAAO,mBAAA;EACP,QAAA,EAAU,mBAAA;EACV,MAAA,EAAQ,mBAAA;EACR,UAAA,EAAY,mBAAA;AAAA;AAAA,KAGV,6BAAA,iBACM,sBAAA,GAAyB,sBAAA,IACvC,0BAAA,CAA2B,OAAA;AAAA,KACnB,wBAAA,GAA2B,qBAAA;;;;UAKtB,sBAAA;EACf,MAAA,EAAQ,sBAAA;EACR,MAAA,EAAQ,MAAA;EACR,OAAA;AAAA;;;AApBF;UA0BiB,oCAAA;EA1BW;EA4B1B,SAAA,EAAW,GAAA;EA5BgB;EA+B3B,UAAA,GAAa,aAAA;EA/ByC;EAkCtD,UAAA;AAAA;AAhCF;;;AAAA,iBAsCgB,qBAAA,CACd,QAAA,EAAU,4BAAA,GACT,sBAAA;;;;iBAOa,4BAAA,CAA6B,OAAA;EAC3C,YAAA,QAAoB,MAAA;AAAA,IAClB,sBAAA;;;;iBAgBY,4BAAA,CACd,OAAA,EAAS,oCAAA,GACR,sBAAA;;;;iBAaa,sBAAA,CACd,OAAA,EAAS,6BAAA,GACR,wBAAA"}
+{"version":3,"file":"worker.d.ts","names":[],"sources":["../src/worker.ts"],"mappings":";;;;;AAgBA;;;;KAAY,sBAAA,iBACM,gBAAA,GAAmB,gBAAA,IACjC,OAAA;;KAEQ,4BAAA,GAA+B,4BAA4B;;KAE3D,gBAAA,WAA2B,gBAAgB,CAAC,MAAA;;;;;AAJ7C;AAEX;;;cAYa,sBAAA,SAA+B,mBAAA;EAClC,KAAA,EAAO,mBAAA;EACP,QAAA,EAAU,mBAAA;EACV,MAAA,EAAQ,mBAAA;EACR,UAAA,EAAY,mBAAA;AAAA;;KAIV,6BAAA,iBACM,sBAAA,GAAyB,sBAAA,IACvC,0BAAA,CAA2B,OAAA;;KAEnB,wBAAA,GAA2B,qBAAqB;AAtBE;AAU9D;;;;;;AAV8D,UA+B7C,sBAAA;EArB2B;EAuB1C,MAAA,EAAQ,sBAAA;EAvBqD;EAyB7D,MAAA,EAAQ,MAAM;EAxBN;EA0BR,OAAA;AAAA;;;;;UAOe,oCAAA;EA9BwB;EAgCvC,SAAA,EAAW,GAAA;EA5BD;EA8BV,UAAA,GAAa,aAAa;EA9Ba;EAgCvC,UAAA;AAAA;;;;;;;;iBAUc,qBAAA,CACd,QAAA,EAAU,4BAAA,GACT,sBAAsB;;;AA1Ca;AAEtC;;;;iBAmDgB,4BAAA,CAA6B,OAAA;EAC3C,YAAA,QAAoB,MAAA;AAAA,IAClB,sBAAsB;;;;;;;;;AAtCjB;AAOT;;;;;;;;iBA6DgB,4BAAA,CACd,OAAA,EAAS,oCAAA,GACR,sBAAsB;;AAzDb;AAUZ;;;;iBA+DgB,sBAAA,CACd,OAAA,EAAS,6BAAA,GACR,wBAAwB"}

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

@@ -1,14 +1,30 @@
 import { SyncoreBridgeClient, attachRuntimeBridge } from "../core/index.mjs";
 //#region src/worker.ts
+/**
+* Syncore client that communicates with a runtime running in a browser Worker
+* over the `postMessage` bridge.
+*
+* Use `createSyncoreWebWorkerClient()` or `createManagedWebWorkerClient()` to
+* create instances. Prefer the React hooks (`useQuery`, `useMutation`, etc.)
+* over calling this directly in React apps.
+*/
 var SyncoreWebWorkerClient = class extends SyncoreBridgeClient {};
 /**
-* Create a web worker Syncore client from a low-level message endpoint.
+* Create a {@link SyncoreWebWorkerClient} from a low-level message endpoint.
+*
+* Use this when you already have a `Worker` or `MessagePort` reference and
+* want to wrap it manually. For the common case of spawning a new Worker from
+* a URL, use `createSyncoreWebWorkerClient` instead.
 */
 function createWebWorkerClient(endpoint) {
 	return new SyncoreWebWorkerClient(endpoint);
 }
 /**
-* Create and manage both a browser Worker and the Syncore client that talks to it.
+* Create a {@link ManagedWebWorkerClient} using a provided Worker factory.
+*
+* Useful when you need control over how the Worker is constructed (e.g. to
+* pass constructor options not exposed by `CreateWebWorkerClientProviderOptions`).
+* For the common URL-based case, use `createSyncoreWebWorkerClient`.
 */
 function createManagedWebWorkerClient(options) {
 	const worker = options.createWorker();
@@ -23,7 +39,21 @@ function createManagedWebWorkerClient(options) {
 	};
 }
 /**
-* Create a worker-backed Syncore client using the standard Worker constructor.
+* Create a {@link ManagedWebWorkerClient} by spawning a new Worker from a URL.
+*
+* This is the standard way to create a main-thread client in a browser app.
+* Pass the URL of your `syncore.worker.ts` file (which calls
+* `createWebWorkerRuntime`) and connect the returned `client` to your React
+* `SyncoreProvider` or Svelte context.
+*
+* ```ts
+* // main.ts (or React root)
+* import { createSyncoreWebWorkerClient } from "syncorejs/browser";
+*
+* const { client, dispose } = createSyncoreWebWorkerClient({
+*   workerUrl: new URL("./syncore.worker.ts", import.meta.url),
+* });
+* ```
 */
 function createSyncoreWebWorkerClient(options) {
 	return createManagedWebWorkerClient({ createWorker: () => new Worker(options.workerUrl, {
@@ -32,7 +62,10 @@ function createSyncoreWebWorkerClient(options) {
 	}) });
 }
 /**
-* Attach a Syncore runtime implementation to a worker message endpoint.
+* Wire a Syncore runtime factory to a worker message endpoint.
+*
+* Called internally by `createWebWorkerRuntime`. Exposed for cases where you
+* need to attach a runtime to a custom bridge endpoint (e.g. a `MessagePort`).
 */
 function attachWebWorkerRuntime(options) {
 	return attachRuntimeBridge(options);

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

@@ -1 +1 @@
-{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import {\n  attachRuntimeBridge,\n  type AttachRuntimeBridgeOptions,\n  type AttachedRuntimeBridge,\n  type BridgeQueryWatch,\n  SyncoreBridgeClient,\n  type SyncoreDataModel,\n  type SyncoreBridgeMessageEndpoint,\n} from \"@syncore/core\";\n\nexport type WebWorkerSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = TSchema;\nexport type SyncoreWorkerMessageEndpoint = SyncoreBridgeMessageEndpoint;\nexport type WorkerQueryWatch<TValue> = BridgeQueryWatch<TValue>;\n\nexport class SyncoreWebWorkerClient extends SyncoreBridgeClient {\n  declare query: SyncoreBridgeClient[\"query\"];\n  declare mutation: SyncoreBridgeClient[\"mutation\"];\n  declare action: SyncoreBridgeClient[\"action\"];\n  declare watchQuery: SyncoreBridgeClient[\"watchQuery\"];\n}\n\nexport type AttachWebWorkerRuntimeOptions<\n  TSchema extends WebWorkerSyncoreSchema = WebWorkerSyncoreSchema\n> = AttachRuntimeBridgeOptions<TSchema>;\nexport type AttachedWebWorkerRuntime = AttachedRuntimeBridge;\n\n/**\n * A worker-backed browser client plus the Worker instance it owns.\n */\nexport interface ManagedWebWorkerClient {\n  client: SyncoreWebWorkerClient;\n  worker: Worker;\n  dispose(): void;\n}\n\n/**\n * Options for creating a worker-backed Syncore client in the browser.\n */\nexport interface CreateWebWorkerClientProviderOptions {\n  /** The worker module URL passed to `new Worker(...)`. */\n  workerUrl: URL | string;\n\n  /** Optional worker type, defaults to `module`. */\n  workerType?: WorkerOptions[\"type\"];\n\n  /** Optional name shown in browser devtools. */\n  workerName?: string;\n}\n\n/**\n * Create a web worker Syncore client from a low-level message endpoint.\n */\nexport function createWebWorkerClient(\n  endpoint: SyncoreWorkerMessageEndpoint\n): SyncoreWebWorkerClient {\n  return new SyncoreWebWorkerClient(endpoint);\n}\n\n/**\n * Create and manage both a browser Worker and the Syncore client that talks to it.\n */\nexport function createManagedWebWorkerClient(options: {\n  createWorker: () => Worker;\n}): ManagedWebWorkerClient {\n  const worker = options.createWorker();\n  const client = createWebWorkerClient(worker);\n  return {\n    client,\n    worker,\n    dispose() {\n      client.dispose();\n      worker.terminate();\n    }\n  };\n}\n\n/**\n * Create a worker-backed Syncore client using the standard Worker constructor.\n */\nexport function createSyncoreWebWorkerClient(\n  options: CreateWebWorkerClientProviderOptions\n): ManagedWebWorkerClient {\n  return createManagedWebWorkerClient({\n    createWorker: () =>\n      new Worker(options.workerUrl, {\n        type: options.workerType ?? \"module\",\n        ...(options.workerName ? { name: options.workerName } : {})\n      })\n  });\n}\n\n/**\n * Attach a Syncore runtime implementation to a worker message endpoint.\n */\nexport function attachWebWorkerRuntime(\n  options: AttachWebWorkerRuntimeOptions\n): AttachedWebWorkerRuntime {\n  return attachRuntimeBridge(options);\n}\n"],"mappings":";;AAgBA,IAAa,yBAAb,cAA4C,oBAAoB;;;;AAsChE,SAAgB,sBACd,UACwB;AACxB,QAAO,IAAI,uBAAuB,SAAS;;;;;AAM7C,SAAgB,6BAA6B,SAElB;CACzB,MAAM,SAAS,QAAQ,cAAc;CACrC,MAAM,SAAS,sBAAsB,OAAO;AAC5C,QAAO;EACL;EACA;EACA,UAAU;AACR,UAAO,SAAS;AAChB,UAAO,WAAW;;EAErB;;;;;AAMH,SAAgB,6BACd,SACwB;AACxB,QAAO,6BAA6B,EAClC,oBACE,IAAI,OAAO,QAAQ,WAAW;EAC5B,MAAM,QAAQ,cAAc;EAC5B,GAAI,QAAQ,aAAa,EAAE,MAAM,QAAQ,YAAY,GAAG,EAAE;EAC3D,CAAC,EACL,CAAC;;;;;AAMJ,SAAgB,uBACd,SAC0B;AAC1B,QAAO,oBAAoB,QAAQ"}
+{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import {\n  attachRuntimeBridge,\n  type AttachRuntimeBridgeOptions,\n  type AttachedRuntimeBridge,\n  type BridgeQueryWatch,\n  SyncoreBridgeClient,\n  type SyncoreDataModel,\n  type SyncoreBridgeMessageEndpoint,\n} from \"@syncore/core\";\n\n/**\n * Schema type constraint for worker-side 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 WebWorkerSyncoreSchema<\n  TSchema extends SyncoreDataModel = SyncoreDataModel\n> = TSchema;\n/** Message endpoint shape required by the browser worker bridge (alias of `SyncoreBridgeMessageEndpoint`). */\nexport type SyncoreWorkerMessageEndpoint = SyncoreBridgeMessageEndpoint;\n/** Live-query subscription handle returned by `SyncoreWebWorkerClient.watchQuery`. */\nexport type WorkerQueryWatch<TValue> = BridgeQueryWatch<TValue>;\n\n/**\n * Syncore client that communicates with a runtime running in a browser Worker\n * over the `postMessage` bridge.\n *\n * Use `createSyncoreWebWorkerClient()` or `createManagedWebWorkerClient()` to\n * create instances. Prefer the React hooks (`useQuery`, `useMutation`, etc.)\n * over calling this directly in React apps.\n */\nexport class SyncoreWebWorkerClient extends SyncoreBridgeClient {\n  declare query: SyncoreBridgeClient[\"query\"];\n  declare mutation: SyncoreBridgeClient[\"mutation\"];\n  declare action: SyncoreBridgeClient[\"action\"];\n  declare watchQuery: SyncoreBridgeClient[\"watchQuery\"];\n}\n\n/** Options for attaching a runtime to a worker bridge endpoint. Alias of `AttachRuntimeBridgeOptions`. */\nexport type AttachWebWorkerRuntimeOptions<\n  TSchema extends WebWorkerSyncoreSchema = WebWorkerSyncoreSchema\n> = AttachRuntimeBridgeOptions<TSchema>;\n/** Handle returned by `attachWebWorkerRuntime` for controlling the attached bridge. */\nexport type AttachedWebWorkerRuntime = AttachedRuntimeBridge;\n\n/**\n * A browser Worker and its associated Syncore client, bundled for easy\n * lifecycle management.\n *\n * Returned by `createSyncoreWebWorkerClient` and `createManagedWebWorkerClient`.\n * Call `dispose()` to terminate the worker and release its resources.\n */\nexport interface ManagedWebWorkerClient {\n  /** The Syncore client connected to the worker. */\n  client: SyncoreWebWorkerClient;\n  /** The underlying `Worker` instance. Useful for low-level control. */\n  worker: Worker;\n  /** Terminate the worker and dispose the client. Call on app unmount or navigation. */\n  dispose(): void;\n}\n\n/**\n * Options for creating a managed worker Syncore client via\n * `createSyncoreWebWorkerClient`.\n */\nexport interface CreateWebWorkerClientProviderOptions {\n  /** The worker module URL passed to `new Worker(...)`. Typically an `import.meta.url`-relative `URL`. */\n  workerUrl: URL | string;\n  /** Worker module type. Defaults to `\"module\"` (ESM worker). */\n  workerType?: WorkerOptions[\"type\"];\n  /** Optional label shown in browser devtools’ Sources panel. */\n  workerName?: string;\n}\n\n/**\n * Create a {@link SyncoreWebWorkerClient} from a low-level message endpoint.\n *\n * Use this when you already have a `Worker` or `MessagePort` reference and\n * want to wrap it manually. For the common case of spawning a new Worker from\n * a URL, use `createSyncoreWebWorkerClient` instead.\n */\nexport function createWebWorkerClient(\n  endpoint: SyncoreWorkerMessageEndpoint\n): SyncoreWebWorkerClient {\n  return new SyncoreWebWorkerClient(endpoint);\n}\n\n/**\n * Create a {@link ManagedWebWorkerClient} using a provided Worker factory.\n *\n * Useful when you need control over how the Worker is constructed (e.g. to\n * pass constructor options not exposed by `CreateWebWorkerClientProviderOptions`).\n * For the common URL-based case, use `createSyncoreWebWorkerClient`.\n */\nexport function createManagedWebWorkerClient(options: {\n  createWorker: () => Worker;\n}): ManagedWebWorkerClient {\n  const worker = options.createWorker();\n  const client = createWebWorkerClient(worker);\n  return {\n    client,\n    worker,\n    dispose() {\n      client.dispose();\n      worker.terminate();\n    }\n  };\n}\n\n/**\n * Create a {@link ManagedWebWorkerClient} by spawning a new Worker from a URL.\n *\n * This is the standard way to create a main-thread client in a browser app.\n * Pass the URL of your `syncore.worker.ts` file (which calls\n * `createWebWorkerRuntime`) and connect the returned `client` to your React\n * `SyncoreProvider` or Svelte context.\n *\n * ```ts\n * // main.ts (or React root)\n * import { createSyncoreWebWorkerClient } from \"syncorejs/browser\";\n *\n * const { client, dispose } = createSyncoreWebWorkerClient({\n *   workerUrl: new URL(\"./syncore.worker.ts\", import.meta.url),\n * });\n * ```\n */\nexport function createSyncoreWebWorkerClient(\n  options: CreateWebWorkerClientProviderOptions\n): ManagedWebWorkerClient {\n  return createManagedWebWorkerClient({\n    createWorker: () =>\n      new Worker(options.workerUrl, {\n        type: options.workerType ?? \"module\",\n        ...(options.workerName ? { name: options.workerName } : {})\n      })\n  });\n}\n\n/**\n * Wire a Syncore runtime factory to a worker message endpoint.\n *\n * Called internally by `createWebWorkerRuntime`. Exposed for cases where you\n * need to attach a runtime to a custom bridge endpoint (e.g. a `MessagePort`).\n */\nexport function attachWebWorkerRuntime(\n  options: AttachWebWorkerRuntimeOptions\n): AttachedWebWorkerRuntime {\n  return attachRuntimeBridge(options);\n}\n"],"mappings":";;;;;;;;;;AAgCA,IAAa,yBAAb,cAA4C,oBAAoB,CAKhE;;;;;;;;AA6CA,SAAgB,sBACd,UACwB;CACxB,OAAO,IAAI,uBAAuB,QAAQ;AAC5C;;;;;;;;AASA,SAAgB,6BAA6B,SAElB;CACzB,MAAM,SAAS,QAAQ,aAAa;CACpC,MAAM,SAAS,sBAAsB,MAAM;CAC3C,OAAO;EACL;EACA;EACA,UAAU;GACR,OAAO,QAAQ;GACf,OAAO,UAAU;EACnB;CACF;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,6BACd,SACwB;CACxB,OAAO,6BAA6B,EAClC,oBACE,IAAI,OAAO,QAAQ,WAAW;EAC5B,MAAM,QAAQ,cAAc;EAC5B,GAAI,QAAQ,aAAa,EAAE,MAAM,QAAQ,WAAW,IAAI,CAAC;CAC3D,CAAC,EACL,CAAC;AACH;;;;;;;AAQA,SAAgB,uBACd,SAC0B;CAC1B,OAAO,oBAAoB,OAAO;AACpC"}