syncorejs 0.2.1 → 0.2.3

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

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react.tsx"],"mappings":";;;;;;;;UAYiB,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;;iBAyCgB,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,iBA2DgB,sBAAA,CAAuB,KAAA,EAAO,2BAA2B,+BAAA,GAAA,CAAA,OAAA"}

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

@@ -1,5 +1,6 @@
 import { createSyncoreWebWorkerClient } from "./worker.js";
-import { useEffect, useState } from "react";
+import { createUnavailableSyncoreClient } from "../core/index.mjs";
+import { useEffect, useMemo, useState } from "react";
 import { SyncoreProvider } from "../react/index.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/react.tsx
@@ -7,27 +8,40 @@ import { jsx } from "react/jsx-runtime";
 * Start a worker-backed Syncore client and provide it to React descendants.
 */
 function SyncoreWebProvider({ children, workerUrl, workerType, workerName, fallback = null }) {
-	const [managedClient, setManagedClient] = useState(null);
+	const bootingClient = useMemo(() => createUnavailableSyncoreClient({
+		kind: "starting",
+		reason: "booting"
+	}), []);
+	const [client, setClient] = useState(bootingClient);
 	useEffect(() => {
-		const nextClient = createSyncoreWebWorkerClient({
-			workerUrl,
-			...workerType ? { workerType } : {},
-			...workerName ? { workerName } : {}
-		});
-		setManagedClient(nextClient);
+		let managedClient;
+		setClient(bootingClient);
+		try {
+			managedClient = createSyncoreWebWorkerClient({
+				workerUrl,
+				...workerType ? { workerType } : {},
+				...workerName ? { workerName } : {}
+			});
+			setClient(managedClient.client);
+		} catch (error) {
+			setClient(createUnavailableSyncoreClient({
+				kind: "unavailable",
+				reason: "worker-unavailable",
+				...error instanceof Error ? { error } : {}
+			}));
+		}
 		return () => {
-			nextClient.dispose();
-			setManagedClient(null);
+			managedClient?.dispose();
 		};
 	}, [
+		bootingClient,
 		workerName,
 		workerType,
 		workerUrl
 	]);
-	if (!managedClient) return fallback;
 	return /* @__PURE__ */ jsx(SyncoreProvider, {
-		client: managedClient.client,
-		children
+		client,
+		children: children ?? fallback
 	});
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import { useEffect, 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 [managedClient, setManagedClient] =\n    useState<ManagedWebWorkerClient | null>(null);\n\n  useEffect(() => {\n    const nextClient = createSyncoreWebWorkerClient({\n      workerUrl,\n      ...(workerType ? { workerType } : {}),\n      ...(workerName ? { workerName } : {})\n    });\n    setManagedClient(nextClient);\n\n    return () => {\n      nextClient.dispose();\n      setManagedClient(null);\n    };\n  }, [workerName, workerType, workerUrl]);\n\n  if (!managedClient) {\n    return fallback;\n  }\n\n  return (\n    <SyncoreProvider client={managedClient.client}>{children}</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":";;;;;;;;AA4BA,SAAgB,mBAAmB,EACjC,UACA,WACA,YACA,YACA,WAAW,QAC0B;CACrC,MAAM,CAAC,eAAe,oBACpB,SAAwC,KAAK;AAE/C,iBAAgB;EACd,MAAM,aAAa,6BAA6B;GAC9C;GACA,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;GACpC,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;GACrC,CAAC;AACF,mBAAiB,WAAW;AAE5B,eAAa;AACX,cAAW,SAAS;AACpB,oBAAiB,KAAK;;IAEvB;EAAC;EAAY;EAAY;EAAU,CAAC;AAEvC,KAAI,CAAC,cACH,QAAO;AAGT,QACE,oBAAC,iBAAD;EAAiB,QAAQ,cAAc;EAAS;EAA2B,CAAA;;;;;AAO/E,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      }),\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          ...(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;CACV,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,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,76 +1,103 @@
-import { AnySyncoreSchema, FunctionReference, SyncoreClient, SyncoreRuntime, SyncoreWatch } from "../core/index.d.mts";
+import { AttachRuntimeBridgeOptions, AttachedRuntimeBridge, BridgeQueryWatch, SyncoreBridgeClient, SyncoreBridgeMessageEndpoint, SyncoreDataModel } from "../core/index.d.mts";
 
 //#region src/worker.d.ts
-type WebWorkerSyncoreSchema = AnySyncoreSchema;
-interface SyncoreWorkerMessageEndpoint {
-  postMessage(message: unknown): void;
-  addEventListener(type: "message", listener: (event: MessageEvent<unknown>) => void): void;
-  removeEventListener(type: "message", listener: (event: MessageEvent<unknown>) => void): void;
-}
-type WorkerQueryWatch<TValue> = SyncoreWatch<TValue> & {
-  dispose(): void;
-};
-type OptionalArgsTuple<TArgs> = Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];
-declare class SyncoreWebWorkerClient implements SyncoreClient {
-  private readonly endpoint;
-  private readonly pendingRequests;
-  private readonly watchRecordsByKey;
-  private readonly watchKeyBySubscriptionId;
-  private disposed;
-  private readonly handleMessage;
-  constructor(endpoint: SyncoreWorkerMessageEndpoint);
-  query<TArgs, TResult>(reference: FunctionReference<"query", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs>): Promise<TResult>;
-  mutation<TArgs, TResult>(reference: FunctionReference<"mutation", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs>): Promise<TResult>;
-  action<TArgs, TResult>(reference: FunctionReference<"action", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs>): Promise<TResult>;
-  watchQuery<TArgs, TResult>(reference: FunctionReference<"query", TArgs, TResult>, ...args: OptionalArgsTuple<TArgs>): WorkerQueryWatch<TResult>;
-  dispose(): void;
-  private invoke;
-  private rejectAllPending;
-  private ensureNotDisposed;
-}
-interface AttachWebWorkerRuntimeOptions {
-  endpoint: SyncoreWorkerMessageEndpoint;
-  createRuntime: (() => Promise<SyncoreRuntime<WebWorkerSyncoreSchema>>) | (() => SyncoreRuntime<WebWorkerSyncoreSchema>);
-}
-interface AttachedWebWorkerRuntime {
-  ready: Promise<void>;
-  dispose(): Promise<void>;
+/**
+ * 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":";;;KASY,sBAAA,GAAyB,gBAAA;AAAA,UAEpB,4BAAA;EACf,WAAA,CAAY,OAAA;EACZ,gBAAA,CACE,IAAA,aACA,QAAA,GAAW,KAAA,EAAO,YAAA;EAEpB,mBAAA,CACE,IAAA,aACA,QAAA,GAAW,KAAA,EAAO,YAAA;AAAA;AAAA,KAmFV,gBAAA,WAA2B,YAAA,CAAa,MAAA;EAClD,OAAA;AAAA;AAAA,KAGG,iBAAA,UACH,MAAA,uBAA6B,KAAA,IAAS,IAAA,GAAO,KAAA,KAAU,IAAA,EAAM,KAAA;AAAA,cAElD,sBAAA,YAAkC,aAAA;EAAA,iBAuDhB,QAAA;EAAA,iBAtDZ,eAAA;EAAA,iBACA,iBAAA;EAAA,iBACA,wBAAA;EAAA,QACT,QAAA;EAAA,iBAES,aAAA;cAiDY,QAAA,EAAU,4BAAA;EAIvC,KAAA,gBAAA,CACE,SAAA,EAAW,iBAAA,UAA2B,KAAA,EAAO,OAAA,MAC1C,IAAA,EAAM,iBAAA,CAAkB,KAAA,IAC1B,OAAA,CAAQ,OAAA;EAQX,QAAA,gBAAA,CACE,SAAA,EAAW,iBAAA,aAA8B,KAAA,EAAO,OAAA,MAC7C,IAAA,EAAM,iBAAA,CAAkB,KAAA,IAC1B,OAAA,CAAQ,OAAA;EAQX,MAAA,gBAAA,CACE,SAAA,EAAW,iBAAA,WAA4B,KAAA,EAAO,OAAA,MAC3C,IAAA,EAAM,iBAAA,CAAkB,KAAA,IAC1B,OAAA,CAAQ,OAAA;EAQX,UAAA,gBAAA,CACE,SAAA,EAAW,iBAAA,UAA2B,KAAA,EAAO,OAAA,MAC1C,IAAA,EAAM,iBAAA,CAAkB,KAAA,IAC1B,gBAAA,CAAiB,OAAA;EA8DpB,OAAA,CAAA;EAAA,QAiBQ,MAAA;EAAA,QAqCA,gBAAA;EAAA,QAOA,iBAAA;AAAA;AAAA,UAOO,6BAAA;EACf,QAAA,EAAU,4BAAA;EACV,aAAA,SACW,OAAA,CAAQ,cAAA,CAAe,sBAAA,aACvB,cAAA,CAAe,sBAAA;AAAA;AAAA,UAGX,wBAAA;EACf,KAAA,EAAO,OAAA;EACP,OAAA,IAAW,OAAA;AAAA;AA/OX;;;AAAA,UAqPe,sBAAA;EACf,MAAA,EAAQ,sBAAA;EACR,MAAA,EAAQ,MAAA;EACR,OAAA;AAAA;;;;UAMe,oCAAA;EA3PuB;EA6PtC,SAAA,EAAW,GAAA;EA7P4C;EAgQvD,UAAA,GAAa,aAAA;EAhQqD;EAmQlE,UAAA;AAAA;;;;iBAMc,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"}