syncorejs 0.1.0

package/dist/next/src/index.d.ts

@@ -0,0 +1,80 @@
+import { ManagedWebWorkerClient } from "../../platform-web/src/worker.js";
+import { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl } from "./config.js";
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region ../next/src/index.d.ts
+interface SyncoreNextOptions {
+  /** Optional service worker URL used to cache the application shell. */
+  serviceWorkerUrl?: string;
+  /** Optional URL for the `sql.js` wasm asset. */
+  wasmAssetUrl?: string;
+  /** Optional URL for the worker asset used by the local Syncore runtime. */
+  workerAssetUrl?: string;
+}
+/**
+ * The result of registering the Syncore service worker in a Next app.
+ */
+interface SyncoreServiceWorkerRegistration {
+  /** Unregister the installed service worker. */
+  unregister(): Promise<boolean>;
+  /** Ask the browser to check for an updated service worker. */
+  update(): Promise<ServiceWorkerRegistration>;
+}
+/**
+ * Register the Syncore service worker used by the Next integration.
+ */
+declare function registerSyncoreServiceWorker(options?: SyncoreNextOptions): Promise<SyncoreServiceWorkerRegistration | null>;
+/**
+ * Resolve the public URL used by SQL.js to load its wasm file in a Next app.
+ */
+declare function resolveSqlJsWasmUrl(options?: SyncoreNextOptions): string;
+/**
+ * Create a worker-backed Syncore client for a Next app.
+ */
+declare function createNextSyncoreClient(options: {
+  /**
+   * Optional custom worker factory for tests or framework-specific worker
+   * bundling patterns such as Next App Router development.
+   */
+  createWorker?: () => Worker; /** Optional explicit module URL for an already-public worker asset. */
+  workerUrl?: URL | string; /** Optional public worker asset path for production builds. */
+  workerAssetUrl?: string;
+}): ManagedWebWorkerClient;
+/**
+ * Register a service worker while rendering a React subtree.
+ */
+declare function SyncoreServiceWorker({
+  children,
+  serviceWorkerUrl,
+  onRegistered
+}: {
+  children: ReactNode;
+  serviceWorkerUrl?: string;
+  onRegistered?: (registration: ServiceWorkerRegistration) => void;
+}): ReactNode;
+/**
+ * Provides a worker-backed Syncore client to a Next React tree.
+ *
+ * This is the shortest recommended integration for App Router pages that run
+ * fully local in the browser.
+ */
+declare function SyncoreNextProvider({
+  children,
+  createWorker,
+  serviceWorkerUrl,
+  workerUrl,
+  workerAssetUrl
+}: {
+  /** The React subtree that should receive the Syncore client. */children: ReactNode;
+  /**
+   * Optional custom worker factory for tests or Next colocated worker modules.
+   */
+  createWorker?: () => Worker; /** Optional service worker URL used to cache the application shell. */
+  serviceWorkerUrl?: string; /** Optional explicit module URL for an already-public worker asset. */
+  workerUrl?: URL | string; /** Optional public worker asset path for production builds. */
+  workerAssetUrl?: string;
+}): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { SyncoreNextOptions, SyncoreNextProvider, SyncoreServiceWorker, SyncoreServiceWorkerRegistration, createNextSyncoreClient, registerSyncoreServiceWorker, resolveSqlJsWasmUrl };
+//# sourceMappingURL=index.d.ts.map

package/dist/next/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../next/src/index.tsx"],"mappings":";;;;;;UAYiB,kBAAA;;EAEf,gBAAA;EAFiC;EAKjC,YAAA;EALiC;EAQjC,cAAA;AAAA;;;;UAMe,gCAAA;EAAgC;EAE/C,UAAA,IAAc,OAAA;EAAA;EAGd,MAAA,IAAU,OAAA,CAAQ,yBAAA;AAAA;;;;iBAME,4BAAA,CACpB,OAAA,GAAU,kBAAA,GACT,OAAA,CAAQ,gCAAA;;;;iBAkBK,mBAAA,CAAoB,OAAA,GAAU,kBAAA;;AApB9C;;iBA2BgB,uBAAA,CAAwB,OAAA;EA1B5B;;;;EA+BV,YAAA,SAAqB,MAAA,EA/BX;EAkCV,SAAA,GAAY,GAAA,WAjCX;EAoCD,cAAA;AAAA,IACE,sBAAA;;AAnBJ;;iBAmCgB,oBAAA,CAAA;EACd,QAAA;EACA,gBAAA;EACA;AAAA;EAEA,QAAA,EAAU,SAAA;EACV,gBAAA;EACA,YAAA,IAAgB,YAAA,EAAc,yBAAA;AAAA,IAC/B,SAAA;;;;;;;iBAsBe,mBAAA,CAAA;EACd,QAAA;EACA,YAAA;EACA,gBAAA;EACA,SAAA;EACA;AAAA;EA1DqB,gEA6DrB,QAAA,EAAU,SAAA;EA1DE;;;EA+DZ,YAAA,SAAqB,MAAA,EA3DG;EA8DxB,gBAAA,WA9Cc;EAiDd,SAAA,GAAY,GAAA;EAGZ,cAAA;AAAA,IACD,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/next/src/index.js

@@ -0,0 +1,82 @@
+import { createManagedWebWorkerClient, createSyncoreWebWorkerClient } from "../../platform-web/src/worker.js";
+import "../../platform-web/src/index.js";
+import { SyncoreProvider } from "../../react/src/index.js";
+import { getSyncoreWorkerUrl } from "./config.js";
+import { useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region ../next/src/index.tsx
+/**
+* Register the Syncore service worker used by the Next integration.
+*/
+async function registerSyncoreServiceWorker(options) {
+	if (typeof window === "undefined" || !("serviceWorker" in navigator)) return null;
+	const registration = await navigator.serviceWorker.register(options?.serviceWorkerUrl ?? "/sw.js");
+	return {
+		unregister: () => registration.unregister(),
+		update: () => registration.update()
+	};
+}
+/**
+* Resolve the public URL used by SQL.js to load its wasm file in a Next app.
+*/
+function resolveSqlJsWasmUrl(options) {
+	return options?.wasmAssetUrl ?? "/sql-wasm.wasm";
+}
+/**
+* Create a worker-backed Syncore client for a Next app.
+*/
+function createNextSyncoreClient(options) {
+	if (options.createWorker) return createManagedWebWorkerClient({ createWorker: options.createWorker });
+	return createSyncoreWebWorkerClient({ workerUrl: options.workerUrl ?? options.workerAssetUrl ?? "/syncore.worker.js" });
+}
+/**
+* Register a service worker while rendering a React subtree.
+*/
+function SyncoreServiceWorker({ children, serviceWorkerUrl, onRegistered }) {
+	useEffect(() => {
+		(async () => {
+			if (typeof window === "undefined" || !("serviceWorker" in navigator)) return;
+			const registration = await navigator.serviceWorker.register(serviceWorkerUrl ?? "/sw.js");
+			onRegistered?.(registration);
+		})();
+	}, [onRegistered, serviceWorkerUrl]);
+	return children;
+}
+/**
+* Provides a worker-backed Syncore client to a Next React tree.
+*
+* This is the shortest recommended integration for App Router pages that run
+* fully local in the browser.
+*/
+function SyncoreNextProvider({ children, createWorker, serviceWorkerUrl, workerUrl, workerAssetUrl }) {
+	const [managedClient, setManagedClient] = useState(null);
+	const resolvedWorkerUrl = typeof workerUrl === "string" ? workerUrl : workerUrl?.toString();
+	useEffect(() => {
+		const nextClient = createNextSyncoreClient({
+			...createWorker ? { createWorker } : {},
+			...resolvedWorkerUrl ? { workerUrl: process.env.NODE_ENV === "production" ? getSyncoreWorkerUrl() : resolvedWorkerUrl } : {},
+			...workerAssetUrl ? { workerAssetUrl } : {}
+		});
+		setManagedClient(nextClient);
+		return () => {
+			nextClient.dispose();
+			setManagedClient(null);
+		};
+	}, [
+		createWorker,
+		resolvedWorkerUrl,
+		workerAssetUrl
+	]);
+	if (!managedClient) return null;
+	return /* @__PURE__ */ jsx(SyncoreServiceWorker, {
+		...serviceWorkerUrl ? { serviceWorkerUrl } : {},
+		children: /* @__PURE__ */ jsx(SyncoreProvider, {
+			client: managedClient.client,
+			children
+		})
+	});
+}
+//#endregion
+export { SyncoreNextProvider, SyncoreServiceWorker, createNextSyncoreClient, registerSyncoreServiceWorker, resolveSqlJsWasmUrl };
+
+//# sourceMappingURL=index.js.map

package/dist/next/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../next/src/index.tsx"],"sourcesContent":["import {\n  createManagedWebWorkerClient,\n  createSyncoreWebWorkerClient,\n  type ManagedWebWorkerClient\n} from \"@syncore/platform-web\";\nimport { SyncoreProvider } from \"@syncore/react\";\nimport { useEffect, useState, type ReactNode } from \"react\";\nimport { getSyncoreWorkerUrl } from \"./config.js\";\n\nexport { getSyncoreWorkerUrl } from \"./config.js\";\nexport { createSyncoreNextWorkerUrl } from \"./config.js\";\n\nexport interface SyncoreNextOptions {\n  /** Optional service worker URL used to cache the application shell. */\n  serviceWorkerUrl?: string;\n\n  /** Optional URL for the `sql.js` wasm asset. */\n  wasmAssetUrl?: string;\n\n  /** Optional URL for the worker asset used by the local Syncore runtime. */\n  workerAssetUrl?: string;\n}\n\n/**\n * The result of registering the Syncore service worker in a Next app.\n */\nexport interface SyncoreServiceWorkerRegistration {\n  /** Unregister the installed service worker. */\n  unregister(): Promise<boolean>;\n\n  /** Ask the browser to check for an updated service worker. */\n  update(): Promise<ServiceWorkerRegistration>;\n}\n\n/**\n * Register the Syncore service worker used by the Next integration.\n */\nexport async function registerSyncoreServiceWorker(\n  options?: SyncoreNextOptions\n): Promise<SyncoreServiceWorkerRegistration | null> {\n  if (typeof window === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n    return null;\n  }\n\n  const registration = await navigator.serviceWorker.register(\n    options?.serviceWorkerUrl ?? \"/sw.js\"\n  );\n\n  return {\n    unregister: () => registration.unregister(),\n    update: () => registration.update()\n  };\n}\n\n/**\n * Resolve the public URL used by SQL.js to load its wasm file in a Next app.\n */\nexport function resolveSqlJsWasmUrl(options?: SyncoreNextOptions): string {\n  return options?.wasmAssetUrl ?? \"/sql-wasm.wasm\";\n}\n\n/**\n * Create a worker-backed Syncore client for a Next app.\n */\nexport function createNextSyncoreClient(options: {\n  /**\n   * Optional custom worker factory for tests or framework-specific worker\n   * bundling patterns such as Next App Router development.\n   */\n  createWorker?: () => Worker;\n\n  /** Optional explicit module URL for an already-public worker asset. */\n  workerUrl?: URL | string;\n\n  /** Optional public worker asset path for production builds. */\n  workerAssetUrl?: string;\n}): ManagedWebWorkerClient {\n  if (options.createWorker) {\n    return createManagedWebWorkerClient({\n      createWorker: options.createWorker\n    });\n  }\n\n  return createSyncoreWebWorkerClient({\n    workerUrl:\n      options.workerUrl ?? options.workerAssetUrl ?? \"/syncore.worker.js\"\n  });\n}\n\n/**\n * Register a service worker while rendering a React subtree.\n */\nexport function SyncoreServiceWorker({\n  children,\n  serviceWorkerUrl,\n  onRegistered\n}: {\n  children: ReactNode;\n  serviceWorkerUrl?: string;\n  onRegistered?: (registration: ServiceWorkerRegistration) => void;\n}) {\n  useEffect(() => {\n    void (async () => {\n      if (typeof window === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n        return;\n      }\n      const registration = await navigator.serviceWorker.register(\n        serviceWorkerUrl ?? \"/sw.js\"\n      );\n      onRegistered?.(registration);\n    })();\n  }, [onRegistered, serviceWorkerUrl]);\n\n  return children;\n}\n\n/**\n * Provides a worker-backed Syncore client to a Next React tree.\n *\n * This is the shortest recommended integration for App Router pages that run\n * fully local in the browser.\n */\nexport function SyncoreNextProvider({\n  children,\n  createWorker,\n  serviceWorkerUrl,\n  workerUrl,\n  workerAssetUrl\n}: {\n  /** The React subtree that should receive the Syncore client. */\n  children: ReactNode;\n\n  /**\n   * Optional custom worker factory for tests or Next colocated worker modules.\n   */\n  createWorker?: () => Worker;\n\n  /** Optional service worker URL used to cache the application shell. */\n  serviceWorkerUrl?: string;\n\n  /** Optional explicit module URL for an already-public worker asset. */\n  workerUrl?: URL | string;\n\n  /** Optional public worker asset path for production builds. */\n  workerAssetUrl?: string;\n}) {\n  const [managedClient, setManagedClient] =\n    useState<ManagedWebWorkerClient | null>(null);\n  const resolvedWorkerUrl =\n    typeof workerUrl === \"string\" ? workerUrl : workerUrl?.toString();\n\n  useEffect(() => {\n    const nextClient = createNextSyncoreClient({\n      ...(createWorker ? { createWorker } : {}),\n      ...(resolvedWorkerUrl\n        ? {\n            workerUrl:\n              process.env.NODE_ENV === \"production\"\n                ? getSyncoreWorkerUrl()\n                : resolvedWorkerUrl\n          }\n        : {}),\n      ...(workerAssetUrl ? { workerAssetUrl } : {})\n    });\n    setManagedClient(nextClient);\n\n    return () => {\n      nextClient.dispose();\n      setManagedClient(null);\n    };\n  }, [createWorker, resolvedWorkerUrl, workerAssetUrl]);\n\n  if (!managedClient) {\n    return null;\n  }\n\n  return (\n    <SyncoreServiceWorker {...(serviceWorkerUrl ? { serviceWorkerUrl } : {})}>\n      <SyncoreProvider client={managedClient.client}>\n        {children}\n      </SyncoreProvider>\n    </SyncoreServiceWorker>\n  );\n}\n"],"mappings":";;;;;;;;;;AAqCA,eAAsB,6BACpB,SACkD;AAClD,KAAI,OAAO,WAAW,eAAe,EAAE,mBAAmB,WACxD,QAAO;CAGT,MAAM,eAAe,MAAM,UAAU,cAAc,SACjD,SAAS,oBAAoB,SAC9B;AAED,QAAO;EACL,kBAAkB,aAAa,YAAY;EAC3C,cAAc,aAAa,QAAQ;EACpC;;;;;AAMH,SAAgB,oBAAoB,SAAsC;AACxE,QAAO,SAAS,gBAAgB;;;;;AAMlC,SAAgB,wBAAwB,SAYb;AACzB,KAAI,QAAQ,aACV,QAAO,6BAA6B,EAClC,cAAc,QAAQ,cACvB,CAAC;AAGJ,QAAO,6BAA6B,EAClC,WACE,QAAQ,aAAa,QAAQ,kBAAkB,sBAClD,CAAC;;;;;AAMJ,SAAgB,qBAAqB,EACnC,UACA,kBACA,gBAKC;AACD,iBAAgB;AACd,GAAM,YAAY;AAChB,OAAI,OAAO,WAAW,eAAe,EAAE,mBAAmB,WACxD;GAEF,MAAM,eAAe,MAAM,UAAU,cAAc,SACjD,oBAAoB,SACrB;AACD,kBAAe,aAAa;MAC1B;IACH,CAAC,cAAc,iBAAiB,CAAC;AAEpC,QAAO;;;;;;;;AAST,SAAgB,oBAAoB,EAClC,UACA,cACA,kBACA,WACA,kBAkBC;CACD,MAAM,CAAC,eAAe,oBACpB,SAAwC,KAAK;CAC/C,MAAM,oBACJ,OAAO,cAAc,WAAW,YAAY,WAAW,UAAU;AAEnE,iBAAgB;EACd,MAAM,aAAa,wBAAwB;GACzC,GAAI,eAAe,EAAE,cAAc,GAAG,EAAE;GACxC,GAAI,oBACA,EACE,WACE,QAAQ,IAAI,aAAa,eACrB,qBAAqB,GACrB,mBACP,GACD,EAAE;GACN,GAAI,iBAAiB,EAAE,gBAAgB,GAAG,EAAE;GAC7C,CAAC;AACF,mBAAiB,WAAW;AAE5B,eAAa;AACX,cAAW,SAAS;AACpB,oBAAiB,KAAK;;IAEvB;EAAC;EAAc;EAAmB;EAAe,CAAC;AAErD,KAAI,CAAC,cACH,QAAO;AAGT,QACE,oBAAC,sBAAD;EAAsB,GAAK,mBAAmB,EAAE,kBAAkB,GAAG,EAAE;YACrE,oBAAC,iBAAD;GAAiB,QAAQ,cAAc;GACpC;GACe,CAAA;EACG,CAAA"}

package/dist/next-config.d.ts

@@ -0,0 +1,2 @@
+import { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl, withSyncoreNext } from "./next/src/config.js";
+export { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl, withSyncoreNext };

package/dist/next-config.js

@@ -0,0 +1,2 @@
+import { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl, withSyncoreNext } from "./next/src/config.js";
+export { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl, withSyncoreNext };

package/dist/next.d.ts

@@ -0,0 +1,3 @@
+import { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl } from "./next/src/config.js";
+import { SyncoreNextOptions, SyncoreNextProvider, SyncoreServiceWorker, SyncoreServiceWorkerRegistration, createNextSyncoreClient, registerSyncoreServiceWorker, resolveSqlJsWasmUrl } from "./next/src/index.js";
+export { SyncoreNextOptions, SyncoreNextProvider, SyncoreServiceWorker, SyncoreServiceWorkerRegistration, createNextSyncoreClient, createSyncoreNextWorkerUrl, getSyncoreWorkerUrl, registerSyncoreServiceWorker, resolveSqlJsWasmUrl };

package/dist/next.js

@@ -0,0 +1,3 @@
+import { createSyncoreNextWorkerUrl, getSyncoreWorkerUrl } from "./next/src/config.js";
+import { SyncoreNextProvider, SyncoreServiceWorker, createNextSyncoreClient, registerSyncoreServiceWorker, resolveSqlJsWasmUrl } from "./next/src/index.js";
+export { SyncoreNextProvider, SyncoreServiceWorker, createNextSyncoreClient, createSyncoreNextWorkerUrl, getSyncoreWorkerUrl, registerSyncoreServiceWorker, resolveSqlJsWasmUrl };

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

@@ -0,0 +1,2 @@
+import { SyncoreElectronProvider, SyncoreElectronProviderProps } from "./platform-node/src/ipc-react.js";
+export { SyncoreElectronProvider, type SyncoreElectronProviderProps };

package/dist/node-ipc-react.js

@@ -0,0 +1,2 @@
+import { SyncoreElectronProvider } from "./platform-node/src/ipc-react.js";
+export { SyncoreElectronProvider };

package/dist/node-ipc.d.ts

@@ -0,0 +1,2 @@
+import { AttachNodeIpcRuntimeOptions, AttachedNodeIpcRuntime, NodeIpcSyncoreSchema, RendererQueryWatch, SyncoreIpcMessageEndpoint, SyncoreMainProcessBridge, SyncoreRendererBridge, SyncoreRendererClient, SyncoreWindowBridge, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge } from "./platform-node/src/ipc.js";
+export { AttachNodeIpcRuntimeOptions, AttachedNodeIpcRuntime, NodeIpcSyncoreSchema, RendererQueryWatch, SyncoreIpcMessageEndpoint, SyncoreMainProcessBridge, SyncoreRendererBridge, SyncoreRendererClient, SyncoreWindowBridge, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge };

package/dist/node-ipc.js

@@ -0,0 +1,2 @@
+import { SyncoreRendererClient, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge } from "./platform-node/src/ipc.js";
+export { SyncoreRendererClient, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge };

package/dist/node.d.ts

@@ -0,0 +1,4 @@
+import { SyncoreDevtoolsEvent, SyncoreDevtoolsSnapshot } from "./devtools-protocol/src/index.js";
+import { AttachNodeIpcRuntimeOptions, AttachedNodeIpcRuntime, NodeIpcSyncoreSchema, RendererQueryWatch, SyncoreIpcMessageEndpoint, SyncoreMainProcessBridge, SyncoreRendererBridge, SyncoreRendererClient, SyncoreWindowBridge, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge } from "./platform-node/src/ipc.js";
+import { CreateElectronSyncoreBridgeOptions, CreateNodeRuntimeOptions, CreateSyncoreRendererWindowClientOptions, ManagedNodeSyncoreClient, NodeFileStorageAdapter, NodeSqliteDriver, NodeSyncoreSchema, NodeWebSocketDevtoolsSink, NodeWebSocketDevtoolsSinkOptions, SyncoreElectronBridgeWindow, SyncoreElectronIpcBinding, SyncoreElectronIpcMain, WithNodeSyncoreClientOptions, bindElectronWindowToSyncoreRuntime, createElectronSyncoreBridge, createManagedNodeSyncoreClient, createNodeSyncoreClient, createNodeSyncoreRuntime, createNodeWebSocketDevtoolsSink, withNodeSyncoreClient } from "./platform-node/src/index.js";
+export { AttachNodeIpcRuntimeOptions, AttachedNodeIpcRuntime, CreateElectronSyncoreBridgeOptions, CreateNodeRuntimeOptions, CreateSyncoreRendererWindowClientOptions, ManagedNodeSyncoreClient, NodeFileStorageAdapter, NodeIpcSyncoreSchema, NodeSqliteDriver, NodeSyncoreSchema, NodeWebSocketDevtoolsSink, NodeWebSocketDevtoolsSinkOptions, RendererQueryWatch, SyncoreDevtoolsEvent, SyncoreDevtoolsSnapshot, SyncoreElectronBridgeWindow, SyncoreElectronIpcBinding, SyncoreElectronIpcMain, SyncoreIpcMessageEndpoint, SyncoreMainProcessBridge, SyncoreRendererBridge, SyncoreRendererClient, SyncoreWindowBridge, WithNodeSyncoreClientOptions, attachNodeIpcRuntime, bindElectronWindowToSyncoreRuntime, createElectronSyncoreBridge, createManagedNodeSyncoreClient, createNodeIpcMessageEndpoint, createNodeSyncoreClient, createNodeSyncoreRuntime, createNodeWebSocketDevtoolsSink, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge, withNodeSyncoreClient };

package/dist/node.js

@@ -0,0 +1,3 @@
+import { SyncoreRendererClient, attachNodeIpcRuntime, createNodeIpcMessageEndpoint, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge } from "./platform-node/src/ipc.js";
+import { NodeFileStorageAdapter, NodeSqliteDriver, bindElectronWindowToSyncoreRuntime, createElectronSyncoreBridge, createManagedNodeSyncoreClient, createNodeSyncoreClient, createNodeSyncoreRuntime, createNodeWebSocketDevtoolsSink, withNodeSyncoreClient } from "./platform-node/src/index.js";
+export { NodeFileStorageAdapter, NodeSqliteDriver, SyncoreRendererClient, attachNodeIpcRuntime, bindElectronWindowToSyncoreRuntime, createElectronSyncoreBridge, createManagedNodeSyncoreClient, createNodeIpcMessageEndpoint, createNodeSyncoreClient, createNodeSyncoreRuntime, createNodeWebSocketDevtoolsSink, createRendererSyncoreBridgeClient, createRendererSyncoreClient, createRendererSyncoreWindowClient, installSyncoreWindowBridge, withNodeSyncoreClient };

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

@@ -0,0 +1,96 @@
+import { AnySyncoreSchema, DevtoolsSink, SchedulerOptions, StorageObject, StorageWriteInput, SyncoreCapabilities, SyncoreClient, SyncoreExperimentalPlugin, SyncoreRuntime, SyncoreRuntimeOptions, SyncoreSqlDriver, SyncoreStorageAdapter } from "../../core/src/runtime/runtime.js";
+import { SQLiteDatabase } from "expo-sqlite";
+
+//#region ../platform-expo/src/index.d.ts
+type ExpoSyncoreSchema = AnySyncoreSchema;
+/**
+ * Options for constructing an Expo Syncore runtime.
+ *
+ * Use this when you want Syncore to persist locally with `expo-sqlite` and the
+ * Expo file system.
+ */
+interface CreateExpoRuntimeOptions {
+  /** The schema for the local Syncore app. */
+  schema: ExpoSyncoreSchema;
+  /** The generated function registry for the local Syncore app. */
+  functions: SyncoreRuntimeOptions<ExpoSyncoreSchema>["functions"];
+  /** Optional platform capabilities exposed to function handlers. */
+  capabilities?: SyncoreCapabilities;
+  /** Optional custom SQL driver. Defaults to `expo-sqlite`. */
+  driver?: SyncoreSqlDriver;
+  /** Optional experimental plugins for runtime hooks. */
+  experimentalPlugins?: Array<SyncoreExperimentalPlugin<ExpoSyncoreSchema>>;
+  /** Optional custom file/blob storage adapter. */
+  storage?: SyncoreStorageAdapter;
+  /** The SQLite database filename to open locally. */
+  databaseName?: string;
+  /** Optional directory for the SQLite database file. */
+  databaseDirectory?: string;
+  /** Directory name used for local file/blob storage. */
+  storageDirectoryName?: string;
+  /** Optional runtime platform label shown in devtools snapshots. */
+  platform?: string;
+  /** Optional devtools sink used during development. */
+  devtools?: DevtoolsSink;
+  /** Optional scheduler configuration for jobs and recurring work. */
+  scheduler?: SchedulerOptions;
+}
+/**
+ * A reusable bootstrap that lazily creates, starts, and stops an Expo Syncore runtime.
+ */
+interface ExpoSyncoreBootstrap {
+  /** Return the local runtime instance, creating it if needed. */
+  getRuntime(): SyncoreRuntime<ExpoSyncoreSchema>;
+  /** Start the runtime if needed and return a ready client. */
+  getClient(): Promise<ReturnType<SyncoreRuntime<ExpoSyncoreSchema>["createClient"]>>;
+  /** Stop the current runtime instance if one exists. */
+  stop(): Promise<void>;
+  /** Fully discard the runtime so the next call recreates it. */
+  reset(): Promise<void>;
+}
+/**
+ * Create an Expo Syncore runtime backed by `expo-sqlite` and local file storage.
+ */
+declare function createExpoSyncoreRuntime(options: CreateExpoRuntimeOptions): SyncoreRuntime<ExpoSyncoreSchema>;
+/**
+ * Create a same-process Syncore client from a started Expo runtime.
+ */
+declare function createExpoSyncoreClient(runtime: SyncoreRuntime<ExpoSyncoreSchema>): SyncoreClient;
+/**
+ * Create a reusable Expo bootstrap that lazily starts the local runtime.
+ */
+declare function createExpoSyncoreBootstrap(options: CreateExpoRuntimeOptions): ExpoSyncoreBootstrap;
+/**
+ * Syncore SQL driver implementation backed by `expo-sqlite`.
+ */
+declare class ExpoSqliteDriver implements SyncoreSqlDriver {
+  private readonly database;
+  private transactionDepth;
+  private closed;
+  constructor(database: SQLiteDatabase);
+  exec(sql: string): Promise<void>;
+  run(sql: string, params?: unknown[]): Promise<{
+    changes: number;
+    lastInsertRowid?: number | string;
+  }>;
+  get<T>(sql: string, params?: unknown[]): Promise<T | undefined>;
+  all<T>(sql: string, params?: unknown[]): Promise<T[]>;
+  withTransaction<T>(callback: () => Promise<T>): Promise<T>;
+  withSavepoint<T>(name: string, callback: () => Promise<T>): Promise<T>;
+  close(): Promise<void>;
+  private ensureOpen;
+}
+/**
+ * Syncore file/blob storage backed by the Expo file system.
+ */
+declare class ExpoFileStorageAdapter implements SyncoreStorageAdapter {
+  private readonly rootDirectory;
+  constructor(storageDirectoryName: string);
+  put(id: string, input: StorageWriteInput): Promise<StorageObject>;
+  get(id: string): Promise<StorageObject | null>;
+  read(id: string): Promise<Uint8Array | null>;
+  delete(id: string): Promise<void>;
+}
+//#endregion
+export { CreateExpoRuntimeOptions, ExpoFileStorageAdapter, ExpoSqliteDriver, ExpoSyncoreBootstrap, ExpoSyncoreSchema, createExpoSyncoreBootstrap, createExpoSyncoreClient, createExpoSyncoreRuntime };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../platform-expo/src/index.ts"],"mappings":";;;;KAoBY,iBAAA,GAAoB,gBAAA;;AAAhC;;;;;UAQiB,wBAAA;EAAwB;EAEvC,MAAA,EAAQ,iBAAA;EAAA;EAGR,SAAA,EAAW,qBAAA,CAAsB,iBAAA;EAAtB;EAGX,YAAA,GAAe,mBAAA;EAGN;EAAT,MAAA,GAAS,gBAAA;EAGmB;EAA5B,mBAAA,GAAsB,KAAA,CAAM,yBAAA,CAA0B,iBAAA;EAG5C;EAAV,OAAA,GAAU,qBAAA;EAkBE;EAfZ,YAAA;EAe4B;EAZ5B,iBAAA;EArBQ;EAwBR,oBAAA;EArBW;EAwBX,QAAA;EArBA;EAwBA,QAAA,GAAW,YAAA;EArBX;EAwBA,SAAA,GAAY,gBAAA;AAAA;;;;UAMG,oBAAA;EAxBL;EA0BV,UAAA,IAAc,cAAA,CAAe,iBAAA;EApB7B;EAuBA,SAAA,IAAa,OAAA,CACX,UAAA,CAAW,cAAA,CAAe,iBAAA;EAlB5B;EAsBA,IAAA,IAAQ,OAAA;EAnBG;EAsBX,KAAA,IAAS,OAAA;AAAA;;;AAbX;iBAmBgB,wBAAA,CACd,OAAA,EAAS,wBAAA,GACR,cAAA,CAAe,iBAAA;;;;iBAuCF,uBAAA,CACd,OAAA,EAAS,cAAA,CAAe,iBAAA,IAAD,aAAA;;;;iBAQT,0BAAA,CACd,OAAA,EAAS,wBAAA,GACR,oBAAA;;;;cA4CU,gBAAA,YAA4B,gBAAA;EAAA,iBAIV,QAAA;EAAA,QAHrB,gBAAA;EAAA,QACA,MAAA;cAEqB,QAAA,EAAU,cAAA;EAEjC,IAAA,CAAK,GAAA,WAAc,OAAA;EAKnB,GAAA,CACJ,GAAA,UACA,MAAA,eACC,OAAA;IAAU,OAAA;IAAiB,eAAA;EAAA;EASxB,GAAA,GAAA,CAAO,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,CAAA;EASrD,GAAA,GAAA,CAAO,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,CAAA;EAKrD,eAAA,GAAA,CAAmB,QAAA,QAAgB,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;EAoBxD,aAAA,GAAA,CAAiB,IAAA,UAAc,QAAA,QAAgB,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;EAkBpE,KAAA,CAAA,GAAS,OAAA;EAAA,QAQP,UAAA;AAAA;;;;cAUG,sBAAA,YAAkC,qBAAA;EAAA,iBAC5B,aAAA;cAEL,oBAAA;EAON,GAAA,CAAI,EAAA,UAAY,KAAA,EAAO,iBAAA,GAAoB,OAAA,CAAQ,aAAA;EAenD,GAAA,CAAI,EAAA,WAAa,OAAA,CAAQ,aAAA;EAazB,IAAA,CAAK,EAAA,WAAa,OAAA,CAAQ,UAAA;EAQ1B,MAAA,CAAO,EAAA,WAAa,OAAA;AAAA"}

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

@@ -0,0 +1,198 @@
+import { SyncoreRuntime } from "../../core/src/runtime/runtime.js";
+import "../../core/src/index.js";
+import { Directory, File, Paths } from "expo-file-system";
+import { defaultDatabaseDirectory, openDatabaseSync } from "expo-sqlite";
+//#region ../platform-expo/src/index.ts
+/**
+* Create an Expo Syncore runtime backed by `expo-sqlite` and local file storage.
+*/
+function createExpoSyncoreRuntime(options) {
+	const databaseDirectory = options.databaseDirectory ?? (typeof defaultDatabaseDirectory === "string" ? defaultDatabaseDirectory : void 0);
+	const driver = options.driver ?? new ExpoSqliteDriver(openDatabaseSync(options.databaseName ?? "syncore.db", void 0, databaseDirectory));
+	const storage = options.storage ?? new ExpoFileStorageAdapter(options.storageDirectoryName ?? "syncore-storage");
+	return new SyncoreRuntime({
+		schema: options.schema,
+		functions: options.functions,
+		driver,
+		storage,
+		platform: options.platform ?? "expo",
+		...options.capabilities ? { capabilities: options.capabilities } : {},
+		...options.devtools ? { devtools: options.devtools } : {},
+		...options.experimentalPlugins ? { experimentalPlugins: options.experimentalPlugins } : {},
+		...options.scheduler ? { scheduler: options.scheduler } : {}
+	});
+}
+/**
+* Create a same-process Syncore client from a started Expo runtime.
+*/
+function createExpoSyncoreClient(runtime) {
+	return runtime.createClient();
+}
+/**
+* Create a reusable Expo bootstrap that lazily starts the local runtime.
+*/
+function createExpoSyncoreBootstrap(options) {
+	let runtime = null;
+	let started = null;
+	const ensureRuntime = () => {
+		runtime ??= createExpoSyncoreRuntime(options);
+		return runtime;
+	};
+	return {
+		getRuntime() {
+			return ensureRuntime();
+		},
+		async getClient() {
+			if (!started) {
+				const activeRuntime = ensureRuntime();
+				started = activeRuntime.start().then(() => activeRuntime.createClient());
+			}
+			return started;
+		},
+		async stop() {
+			if (!runtime) return;
+			await runtime.stop();
+			started = null;
+		},
+		async reset() {
+			if (runtime) await runtime.stop();
+			runtime = null;
+			started = null;
+		}
+	};
+}
+/**
+* Syncore SQL driver implementation backed by `expo-sqlite`.
+*/
+var ExpoSqliteDriver = class {
+	transactionDepth = 0;
+	closed = false;
+	constructor(database) {
+		this.database = database;
+	}
+	async exec(sql) {
+		this.ensureOpen();
+		await this.database.execAsync(sql);
+	}
+	async run(sql, params = []) {
+		this.ensureOpen();
+		const result = await this.database.runAsync(sql, normalizeParams(params));
+		return {
+			changes: result.changes,
+			lastInsertRowid: result.lastInsertRowId
+		};
+	}
+	async get(sql, params = []) {
+		this.ensureOpen();
+		return await this.database.getFirstAsync(sql, normalizeParams(params)) ?? void 0;
+	}
+	async all(sql, params = []) {
+		this.ensureOpen();
+		return this.database.getAllAsync(sql, normalizeParams(params));
+	}
+	async withTransaction(callback) {
+		this.ensureOpen();
+		if (this.transactionDepth > 0) return this.withSavepoint(`nested_${this.transactionDepth}`, callback);
+		this.transactionDepth += 1;
+		await this.database.execAsync("BEGIN IMMEDIATE");
+		try {
+			const result = await callback();
+			await this.database.execAsync("COMMIT");
+			return result;
+		} catch (error) {
+			await this.database.execAsync("ROLLBACK");
+			throw error;
+		} finally {
+			this.transactionDepth -= 1;
+		}
+	}
+	async withSavepoint(name, callback) {
+		this.ensureOpen();
+		const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, "_");
+		this.transactionDepth += 1;
+		await this.database.execAsync(`SAVEPOINT ${safeName}`);
+		try {
+			const result = await callback();
+			await this.database.execAsync(`RELEASE SAVEPOINT ${safeName}`);
+			return result;
+		} catch (error) {
+			await this.database.execAsync(`ROLLBACK TO SAVEPOINT ${safeName}`);
+			await this.database.execAsync(`RELEASE SAVEPOINT ${safeName}`);
+			throw error;
+		} finally {
+			this.transactionDepth -= 1;
+		}
+	}
+	async close() {
+		if (this.closed) return;
+		await this.database.closeAsync();
+		this.closed = true;
+	}
+	ensureOpen() {
+		if (this.closed) throw new Error("The Expo SQLite driver is already closed.");
+	}
+};
+/**
+* Syncore file/blob storage backed by the Expo file system.
+*/
+var ExpoFileStorageAdapter = class {
+	rootDirectory;
+	constructor(storageDirectoryName) {
+		this.rootDirectory = new Directory(Paths.document, storageDirectoryName);
+		if (!this.rootDirectory.exists) this.rootDirectory.create({
+			idempotent: true,
+			intermediates: true
+		});
+	}
+	async put(id, input) {
+		const file = new File(this.rootDirectory, id);
+		if (!file.exists) file.create({
+			intermediates: true,
+			overwrite: true
+		});
+		const bytes = normalizeBinary(input.data);
+		file.write(bytes);
+		return {
+			id,
+			path: file.uri,
+			size: bytes.byteLength,
+			contentType: input.contentType ?? null
+		};
+	}
+	async get(id) {
+		const file = new File(this.rootDirectory, id);
+		if (!file.exists) return null;
+		return {
+			id,
+			path: file.uri,
+			size: file.size,
+			contentType: file.type || null
+		};
+	}
+	async read(id) {
+		const file = new File(this.rootDirectory, id);
+		if (!file.exists) return null;
+		return file.bytes();
+	}
+	async delete(id) {
+		const file = new File(this.rootDirectory, id);
+		if (file.exists) file.delete();
+	}
+};
+function normalizeParams(values) {
+	return values.map((value) => {
+		if (typeof value === "boolean") return value ? 1 : 0;
+		if (value === null || typeof value === "string" || typeof value === "number" || value instanceof Uint8Array) return value;
+		if (value instanceof ArrayBuffer) return new Uint8Array(value);
+		return JSON.stringify(value);
+	});
+}
+function normalizeBinary(data) {
+	if (typeof data === "string") return new TextEncoder().encode(data);
+	if (data instanceof Uint8Array) return data;
+	return new Uint8Array(data);
+}
+//#endregion
+export { ExpoFileStorageAdapter, ExpoSqliteDriver, createExpoSyncoreBootstrap, createExpoSyncoreClient, createExpoSyncoreRuntime };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../platform-expo/src/index.ts"],"sourcesContent":["import { Directory, File, Paths } from \"expo-file-system\";\r\nimport {\r\n  defaultDatabaseDirectory,\r\n  openDatabaseSync,\r\n  type SQLiteDatabase\r\n} from \"expo-sqlite\";\r\nimport {\r\n  type AnySyncoreSchema,\r\n  type DevtoolsSink,\r\n  SyncoreRuntime,\r\n  type SchedulerOptions,\r\n  type SyncoreCapabilities,\r\n  type SyncoreExperimentalPlugin,\r\n  type SyncoreRuntimeOptions,\r\n  type SyncoreSqlDriver,\r\n  type SyncoreStorageAdapter,\r\n  type StorageObject,\r\n  type StorageWriteInput\r\n} from \"@syncore/core\";\r\n\r\nexport type ExpoSyncoreSchema = AnySyncoreSchema;\r\n\r\n/**\r\n * Options for constructing an Expo Syncore runtime.\r\n *\r\n * Use this when you want Syncore to persist locally with `expo-sqlite` and the\r\n * Expo file system.\r\n */\r\nexport interface CreateExpoRuntimeOptions {\r\n  /** The schema for the local Syncore app. */\r\n  schema: ExpoSyncoreSchema;\r\n\r\n  /** The generated function registry for the local Syncore app. */\r\n  functions: SyncoreRuntimeOptions<ExpoSyncoreSchema>[\"functions\"];\r\n\r\n  /** Optional platform capabilities exposed to function handlers. */\r\n  capabilities?: SyncoreCapabilities;\r\n\r\n  /** Optional custom SQL driver. Defaults to `expo-sqlite`. */\r\n  driver?: SyncoreSqlDriver;\r\n\r\n  /** Optional experimental plugins for runtime hooks. */\r\n  experimentalPlugins?: Array<SyncoreExperimentalPlugin<ExpoSyncoreSchema>>;\r\n\r\n  /** Optional custom file/blob storage adapter. */\r\n  storage?: SyncoreStorageAdapter;\r\n\r\n  /** The SQLite database filename to open locally. */\r\n  databaseName?: string;\r\n\r\n  /** Optional directory for the SQLite database file. */\r\n  databaseDirectory?: string;\r\n\r\n  /** Directory name used for local file/blob storage. */\r\n  storageDirectoryName?: string;\r\n\r\n  /** Optional runtime platform label shown in devtools snapshots. */\r\n  platform?: string;\r\n\r\n  /** Optional devtools sink used during development. */\r\n  devtools?: DevtoolsSink;\r\n\r\n  /** Optional scheduler configuration for jobs and recurring work. */\r\n  scheduler?: SchedulerOptions;\r\n}\r\n\r\n/**\r\n * A reusable bootstrap that lazily creates, starts, and stops an Expo Syncore runtime.\r\n */\r\nexport interface ExpoSyncoreBootstrap {\r\n  /** Return the local runtime instance, creating it if needed. */\r\n  getRuntime(): SyncoreRuntime<ExpoSyncoreSchema>;\r\n\r\n  /** Start the runtime if needed and return a ready client. */\r\n  getClient(): Promise<\r\n    ReturnType<SyncoreRuntime<ExpoSyncoreSchema>[\"createClient\"]>\r\n  >;\r\n\r\n  /** Stop the current runtime instance if one exists. */\r\n  stop(): Promise<void>;\r\n\r\n  /** Fully discard the runtime so the next call recreates it. */\r\n  reset(): Promise<void>;\r\n}\r\n\r\n/**\r\n * Create an Expo Syncore runtime backed by `expo-sqlite` and local file storage.\r\n */\r\nexport function createExpoSyncoreRuntime(\r\n  options: CreateExpoRuntimeOptions\r\n): SyncoreRuntime<ExpoSyncoreSchema> {\r\n  const databaseDirectory =\r\n    options.databaseDirectory ??\r\n    (typeof defaultDatabaseDirectory === \"string\"\r\n      ? defaultDatabaseDirectory\r\n      : undefined);\r\n  const driver =\r\n    options.driver ??\r\n    new ExpoSqliteDriver(\r\n      openDatabaseSync(\r\n        options.databaseName ?? \"syncore.db\",\r\n        undefined,\r\n        databaseDirectory\r\n      )\r\n    );\r\n  const storage =\r\n    options.storage ??\r\n    new ExpoFileStorageAdapter(\r\n      options.storageDirectoryName ?? \"syncore-storage\"\r\n    );\r\n\r\n  return new SyncoreRuntime({\r\n    schema: options.schema,\r\n    functions: options.functions,\r\n    driver,\r\n    storage,\r\n    platform: options.platform ?? \"expo\",\r\n    ...(options.capabilities ? { capabilities: options.capabilities } : {}),\r\n    ...(options.devtools ? { devtools: options.devtools } : {}),\r\n    ...(options.experimentalPlugins\r\n      ? { experimentalPlugins: options.experimentalPlugins }\r\n      : {}),\r\n    ...(options.scheduler ? { scheduler: options.scheduler } : {})\r\n  });\r\n}\r\n\r\n/**\r\n * Create a same-process Syncore client from a started Expo runtime.\r\n */\r\nexport function createExpoSyncoreClient(\r\n  runtime: SyncoreRuntime<ExpoSyncoreSchema>\r\n) {\r\n  return runtime.createClient();\r\n}\r\n\r\n/**\r\n * Create a reusable Expo bootstrap that lazily starts the local runtime.\r\n */\r\nexport function createExpoSyncoreBootstrap(\r\n  options: CreateExpoRuntimeOptions\r\n): ExpoSyncoreBootstrap {\r\n  let runtime: SyncoreRuntime<ExpoSyncoreSchema> | null = null;\r\n  let started: Promise<\r\n    ReturnType<SyncoreRuntime<ExpoSyncoreSchema>[\"createClient\"]>\r\n  > | null = null;\r\n\r\n  const ensureRuntime = () => {\r\n    runtime ??= createExpoSyncoreRuntime(options);\r\n    return runtime;\r\n  };\r\n\r\n  return {\r\n    getRuntime() {\r\n      return ensureRuntime();\r\n    },\r\n    async getClient() {\r\n      if (!started) {\r\n        const activeRuntime = ensureRuntime();\r\n        started = activeRuntime\r\n          .start()\r\n          .then(() => activeRuntime.createClient());\r\n      }\r\n      return started;\r\n    },\r\n    async stop() {\r\n      if (!runtime) {\r\n        return;\r\n      }\r\n      await runtime.stop();\r\n      started = null;\r\n    },\r\n    async reset() {\r\n      if (runtime) {\r\n        await runtime.stop();\r\n      }\r\n      runtime = null;\r\n      started = null;\r\n    }\r\n  };\r\n}\r\n\r\n/**\r\n * Syncore SQL driver implementation backed by `expo-sqlite`.\r\n */\r\nexport class ExpoSqliteDriver implements SyncoreSqlDriver {\r\n  private transactionDepth = 0;\r\n  private closed = false;\r\n\r\n  constructor(private readonly database: SQLiteDatabase) {}\r\n\r\n  async exec(sql: string): Promise<void> {\r\n    this.ensureOpen();\r\n    await this.database.execAsync(sql);\r\n  }\r\n\r\n  async run(\r\n    sql: string,\r\n    params: unknown[] = []\r\n  ): Promise<{ changes: number; lastInsertRowid?: number | string }> {\r\n    this.ensureOpen();\r\n    const result = await this.database.runAsync(sql, normalizeParams(params));\r\n    return {\r\n      changes: result.changes,\r\n      lastInsertRowid: result.lastInsertRowId\r\n    };\r\n  }\r\n\r\n  async get<T>(sql: string, params: unknown[] = []): Promise<T | undefined> {\r\n    this.ensureOpen();\r\n    const row = await this.database.getFirstAsync<T>(\r\n      sql,\r\n      normalizeParams(params)\r\n    );\r\n    return row ?? undefined;\r\n  }\r\n\r\n  async all<T>(sql: string, params: unknown[] = []): Promise<T[]> {\r\n    this.ensureOpen();\r\n    return this.database.getAllAsync<T>(sql, normalizeParams(params));\r\n  }\r\n\r\n  async withTransaction<T>(callback: () => Promise<T>): Promise<T> {\r\n    this.ensureOpen();\r\n    if (this.transactionDepth > 0) {\r\n      return this.withSavepoint(`nested_${this.transactionDepth}`, callback);\r\n    }\r\n\r\n    this.transactionDepth += 1;\r\n    await this.database.execAsync(\"BEGIN IMMEDIATE\");\r\n    try {\r\n      const result = await callback();\r\n      await this.database.execAsync(\"COMMIT\");\r\n      return result;\r\n    } catch (error) {\r\n      await this.database.execAsync(\"ROLLBACK\");\r\n      throw error;\r\n    } finally {\r\n      this.transactionDepth -= 1;\r\n    }\r\n  }\r\n\r\n  async withSavepoint<T>(name: string, callback: () => Promise<T>): Promise<T> {\r\n    this.ensureOpen();\r\n    const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, \"_\");\r\n    this.transactionDepth += 1;\r\n    await this.database.execAsync(`SAVEPOINT ${safeName}`);\r\n    try {\r\n      const result = await callback();\r\n      await this.database.execAsync(`RELEASE SAVEPOINT ${safeName}`);\r\n      return result;\r\n    } catch (error) {\r\n      await this.database.execAsync(`ROLLBACK TO SAVEPOINT ${safeName}`);\r\n      await this.database.execAsync(`RELEASE SAVEPOINT ${safeName}`);\r\n      throw error;\r\n    } finally {\r\n      this.transactionDepth -= 1;\r\n    }\r\n  }\r\n\r\n  async close(): Promise<void> {\r\n    if (this.closed) {\r\n      return;\r\n    }\r\n    await this.database.closeAsync();\r\n    this.closed = true;\r\n  }\r\n\r\n  private ensureOpen(): void {\r\n    if (this.closed) {\r\n      throw new Error(\"The Expo SQLite driver is already closed.\");\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Syncore file/blob storage backed by the Expo file system.\r\n */\r\nexport class ExpoFileStorageAdapter implements SyncoreStorageAdapter {\r\n  private readonly rootDirectory: Directory;\r\n\r\n  constructor(storageDirectoryName: string) {\r\n    this.rootDirectory = new Directory(Paths.document, storageDirectoryName);\r\n    if (!this.rootDirectory.exists) {\r\n      this.rootDirectory.create({ idempotent: true, intermediates: true });\r\n    }\r\n  }\r\n\r\n  async put(id: string, input: StorageWriteInput): Promise<StorageObject> {\r\n    const file = new File(this.rootDirectory, id);\r\n    if (!file.exists) {\r\n      file.create({ intermediates: true, overwrite: true });\r\n    }\r\n    const bytes = normalizeBinary(input.data);\r\n    file.write(bytes);\r\n    return {\r\n      id,\r\n      path: file.uri,\r\n      size: bytes.byteLength,\r\n      contentType: input.contentType ?? null\r\n    };\r\n  }\r\n\r\n  async get(id: string): Promise<StorageObject | null> {\r\n    const file = new File(this.rootDirectory, id);\r\n    if (!file.exists) {\r\n      return null;\r\n    }\r\n    return {\r\n      id,\r\n      path: file.uri,\r\n      size: file.size,\r\n      contentType: file.type || null\r\n    };\r\n  }\r\n\r\n  async read(id: string): Promise<Uint8Array | null> {\r\n    const file = new File(this.rootDirectory, id);\r\n    if (!file.exists) {\r\n      return null;\r\n    }\r\n    return file.bytes();\r\n  }\r\n\r\n  async delete(id: string): Promise<void> {\r\n    const file = new File(this.rootDirectory, id);\r\n    if (file.exists) {\r\n      file.delete();\r\n    }\r\n  }\r\n}\r\n\r\nfunction normalizeParams(\r\n  values: unknown[]\r\n): Array<string | number | Uint8Array | null> {\r\n  return values.map((value) => {\r\n    if (typeof value === \"boolean\") {\r\n      return value ? 1 : 0;\r\n    }\r\n    if (\r\n      value === null ||\r\n      typeof value === \"string\" ||\r\n      typeof value === \"number\" ||\r\n      value instanceof Uint8Array\r\n    ) {\r\n      return value;\r\n    }\r\n    if (value instanceof ArrayBuffer) {\r\n      return new Uint8Array(value);\r\n    }\r\n    return JSON.stringify(value);\r\n  });\r\n}\r\n\r\nfunction normalizeBinary(data: StorageWriteInput[\"data\"]): Uint8Array {\r\n  if (typeof data === \"string\") {\r\n    return new TextEncoder().encode(data);\r\n  }\r\n  if (data instanceof Uint8Array) {\r\n    return data;\r\n  }\r\n  return new Uint8Array(data);\r\n}\r\n"],"mappings":"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"}

package/dist/platform-expo/src/react.d.ts

@@ -0,0 +1,26 @@
+import { ExpoSyncoreBootstrap } from "./index.js";
+import { ReactNode } from "react";
+
+//#region ../platform-expo/src/react.d.ts
+/**
+ * Props for {@link SyncoreExpoProvider}.
+ */
+interface SyncoreExpoProviderProps {
+  /** The bootstrap created with `createExpoSyncoreBootstrap`. */
+  bootstrap: ExpoSyncoreBootstrap;
+  /** The React subtree that should receive the Syncore client. */
+  children: ReactNode;
+  /** Optional fallback content rendered while the local runtime starts. */
+  fallback?: ReactNode;
+}
+/**
+ * Start an Expo Syncore bootstrap and provide its client to React descendants.
+ */
+declare function SyncoreExpoProvider({
+  bootstrap,
+  children,
+  fallback
+}: SyncoreExpoProviderProps): ReactNode;
+//#endregion
+export { SyncoreExpoProvider, SyncoreExpoProviderProps };
+//# sourceMappingURL=react.d.ts.map

package/dist/platform-expo/src/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":[],"sources":["../../../../platform-expo/src/react.tsx"],"mappings":";;;;;;AAWA;UAAiB,wBAAA;;EAEf,SAAA,EAAW,oBAAA;EAGD;EAAV,QAAA,EAAU,SAAA;EAGU;EAApB,QAAA,GAAW,SAAA;AAAA;;;;iBAMG,mBAAA,CAAA;EACd,SAAA;EACA,QAAA;EACA;AAAA,GACC,wBAAA,GAA2B,SAAA"}

package/dist/platform-expo/src/react.js

@@ -0,0 +1,30 @@
+import { SyncoreProvider } from "../../react/src/index.js";
+import { useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region ../platform-expo/src/react.tsx
+/**
+* Start an Expo Syncore bootstrap and provide its client to React descendants.
+*/
+function SyncoreExpoProvider({ bootstrap, children, fallback = null }) {
+	const [client, setClient] = useState(null);
+	useEffect(() => {
+		let cancelled = false;
+		bootstrap.getClient().then((nextClient) => {
+			if (!cancelled) setClient(nextClient);
+		});
+		return () => {
+			cancelled = true;
+			setClient(null);
+			bootstrap.stop();
+		};
+	}, [bootstrap]);
+	if (!client) return fallback;
+	return /* @__PURE__ */ jsx(SyncoreProvider, {
+		client,
+		children
+	});
+}
+//#endregion
+export { SyncoreExpoProvider };
+
+//# sourceMappingURL=react.js.map

package/dist/platform-expo/src/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../../../../platform-expo/src/react.tsx"],"sourcesContent":["import { useEffect, useState } from \"react\";\r\nimport type { ReactNode } from \"react\";\r\nimport { SyncoreProvider } from \"@syncore/react\";\r\nimport type { SyncoreClient } from \"@syncore/core\";\r\nimport type { ExpoSyncoreBootstrap } from \"./index.js\";\r\n\r\ntype ExpoSyncoreClient = SyncoreClient;\r\n\r\n/**\r\n * Props for {@link SyncoreExpoProvider}.\r\n */\r\nexport interface SyncoreExpoProviderProps {\r\n  /** The bootstrap created with `createExpoSyncoreBootstrap`. */\r\n  bootstrap: ExpoSyncoreBootstrap;\r\n\r\n  /** The React subtree that should receive the Syncore client. */\r\n  children: ReactNode;\r\n\r\n  /** Optional fallback content rendered while the local runtime starts. */\r\n  fallback?: ReactNode;\r\n}\r\n\r\n/**\r\n * Start an Expo Syncore bootstrap and provide its client to React descendants.\r\n */\r\nexport function SyncoreExpoProvider({\r\n  bootstrap,\r\n  children,\r\n  fallback = null\r\n}: SyncoreExpoProviderProps): ReactNode {\r\n  const [client, setClient] = useState<ExpoSyncoreClient | null>(null);\r\n\r\n  useEffect(() => {\r\n    let cancelled = false;\r\n    void bootstrap.getClient().then((nextClient: ExpoSyncoreClient) => {\r\n      if (!cancelled) {\r\n        setClient(nextClient);\r\n      }\r\n    });\r\n\r\n    return () => {\r\n      cancelled = true;\r\n      setClient(null);\r\n      void bootstrap.stop();\r\n    };\r\n  }, [bootstrap]);\r\n\r\n  if (!client) {\r\n    return fallback;\r\n  }\r\n\r\n  return <SyncoreProvider client={client}>{children}</SyncoreProvider>;\r\n}\r\n"],"mappings":";;;;;;;AAyBA,SAAgB,oBAAoB,EAClC,WACA,UACA,WAAW,QAC2B;CACtC,MAAM,CAAC,QAAQ,aAAa,SAAmC,KAAK;AAEpE,iBAAgB;EACd,IAAI,YAAY;AACX,YAAU,WAAW,CAAC,MAAM,eAAkC;AACjE,OAAI,CAAC,UACH,WAAU,WAAW;IAEvB;AAEF,eAAa;AACX,eAAY;AACZ,aAAU,KAAK;AACV,aAAU,MAAM;;IAEtB,CAAC,UAAU,CAAC;AAEf,KAAI,CAAC,OACH,QAAO;AAGT,QAAO,oBAAC,iBAAD;EAAyB;EAAS;EAA2B,CAAA"}