syncorejs 0.1.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"opfs.js","names":[],"sources":["../src/opfs.ts"],"sourcesContent":["import type { SyncoreWebPersistence, StoredWebFile } from \"./persistence.js\";\r\n\r\nexport interface OpfsPersistenceOptions {\r\n  rootDirectoryName?: string;\r\n}\r\n\r\ntype StoredFileMetadata = {\r\n  contentType: string | null;\r\n};\r\n\r\ntype OpfsStorageManager = StorageManager & {\r\n  getDirectory?: () => Promise<FileSystemDirectoryHandle>;\r\n};\r\n\r\nexport class SyncoreOpfsPersistence implements SyncoreWebPersistence {\r\n  readonly storageProtocol = \"opfs\" as const;\r\n  private rootDirectoryPromise: Promise<FileSystemDirectoryHandle> | undefined;\r\n\r\n  constructor(private readonly options: OpfsPersistenceOptions = {}) {}\r\n\r\n  async loadDatabase(key: string): Promise<Uint8Array | null> {\r\n    const handle = await this.getOptionalFileHandle(\r\n      [\"databases\"],\r\n      `${encodePathComponent(key)}.sqlite`\r\n    );\r\n    if (!handle) {\r\n      return null;\r\n    }\r\n    return readFileBytes(handle);\r\n  }\r\n\r\n  async saveDatabase(key: string, bytes: Uint8Array): Promise<void> {\r\n    const directory = await this.ensureDirectory([\"databases\"]);\r\n    await writeBytes(\r\n      await directory.getFileHandle(`${encodePathComponent(key)}.sqlite`, {\r\n        create: true\r\n      }),\r\n      bytes\r\n    );\r\n  }\r\n\r\n  async getFile(namespace: string, id: string): Promise<StoredWebFile | null> {\r\n    const directory = await this.getOptionalDirectory([\"files\", encodePathComponent(namespace)]);\r\n    if (!directory) {\r\n      return null;\r\n    }\r\n\r\n    const fileName = `${encodePathComponent(id)}.bin`;\r\n    const metadataName = `${encodePathComponent(id)}.meta.json`;\r\n    const fileHandle = await this.getOptionalFileHandleFromDirectory(directory, fileName);\r\n    if (!fileHandle) {\r\n      return null;\r\n    }\r\n\r\n    const [bytes, metadata] = await Promise.all([\r\n      readFileBytes(fileHandle),\r\n      this.readMetadata(directory, metadataName)\r\n    ]);\r\n\r\n    return {\r\n      id,\r\n      bytes,\r\n      size: bytes.byteLength,\r\n      contentType: metadata?.contentType ?? null\r\n    };\r\n  }\r\n\r\n  async putFile(\r\n    namespace: string,\r\n    id: string,\r\n    bytes: Uint8Array,\r\n    contentType: string | null\r\n  ): Promise<void> {\r\n    const directory = await this.ensureDirectory([\"files\", encodePathComponent(namespace)]);\r\n    const encodedId = encodePathComponent(id);\r\n\r\n    await writeBytes(\r\n      await directory.getFileHandle(`${encodedId}.bin`, { create: true }),\r\n      bytes\r\n    );\r\n    await writeText(\r\n      await directory.getFileHandle(`${encodedId}.meta.json`, { create: true }),\r\n      JSON.stringify({ contentType } satisfies StoredFileMetadata)\r\n    );\r\n  }\r\n\r\n  async deleteFile(namespace: string, id: string): Promise<void> {\r\n    const directory = await this.getOptionalDirectory([\"files\", encodePathComponent(namespace)]);\r\n    if (!directory) {\r\n      return;\r\n    }\r\n\r\n    const encodedId = encodePathComponent(id);\r\n    await removeEntryIfExists(directory, `${encodedId}.bin`);\r\n    await removeEntryIfExists(directory, `${encodedId}.meta.json`);\r\n  }\r\n\r\n  async listFiles(namespace: string): Promise<StoredWebFile[]> {\r\n    const directory = await this.getOptionalDirectory([\"files\", encodePathComponent(namespace)]);\r\n    if (!directory) {\r\n      return [];\r\n    }\r\n\r\n    const files: StoredWebFile[] = [];\r\n    const iterableDirectory = directory as FileSystemDirectoryHandle & {\r\n      entries(): AsyncIterable<[string, FileSystemHandle]>;\r\n    };\r\n    for await (const [name, handle] of iterableDirectory.entries()) {\r\n      if (handle.kind !== \"file\" || !name.endsWith(\".bin\")) {\r\n        continue;\r\n      }\r\n      const encodedId = name.slice(0, -4);\r\n      const id = decodeURIComponent(encodedId);\r\n      const bytes = await readFileBytes(handle as FileSystemFileHandle);\r\n      const metadata = await this.readMetadata(directory, `${encodedId}.meta.json`);\r\n      files.push({\r\n        id,\r\n        bytes,\r\n        size: bytes.byteLength,\r\n        contentType: metadata?.contentType ?? null\r\n      });\r\n    }\r\n    return files;\r\n  }\r\n\r\n  private async ensureDirectory(\r\n    pathSegments: string[]\r\n  ): Promise<FileSystemDirectoryHandle> {\r\n    let directory = await this.getRootDirectory();\r\n    for (const segment of pathSegments) {\r\n      directory = await directory.getDirectoryHandle(segment, { create: true });\r\n    }\r\n    return directory;\r\n  }\r\n\r\n  private async getOptionalDirectory(\r\n    pathSegments: string[]\r\n  ): Promise<FileSystemDirectoryHandle | null> {\r\n    try {\r\n      let directory = await this.getRootDirectory();\r\n      for (const segment of pathSegments) {\r\n        directory = await directory.getDirectoryHandle(segment);\r\n      }\r\n      return directory;\r\n    } catch (error) {\r\n      if (isNotFoundError(error)) {\r\n        return null;\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  private async getOptionalFileHandle(\r\n    pathSegments: string[],\r\n    fileName: string\r\n  ): Promise<FileSystemFileHandle | null> {\r\n    const directory = await this.getOptionalDirectory(pathSegments);\r\n    if (!directory) {\r\n      return null;\r\n    }\r\n    return this.getOptionalFileHandleFromDirectory(directory, fileName);\r\n  }\r\n\r\n  private async getOptionalFileHandleFromDirectory(\r\n    directory: FileSystemDirectoryHandle,\r\n    fileName: string\r\n  ): Promise<FileSystemFileHandle | null> {\r\n    try {\r\n      return await directory.getFileHandle(fileName);\r\n    } catch (error) {\r\n      if (isNotFoundError(error)) {\r\n        return null;\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  private async readMetadata(\r\n    directory: FileSystemDirectoryHandle,\r\n    fileName: string\r\n  ): Promise<StoredFileMetadata | null> {\r\n    const handle = await this.getOptionalFileHandleFromDirectory(directory, fileName);\r\n    if (!handle) {\r\n      return null;\r\n    }\r\n\r\n    const bytes = await readFileBytes(handle);\r\n    return JSON.parse(new TextDecoder().decode(bytes)) as StoredFileMetadata;\r\n  }\r\n\r\n  private async getRootDirectory(): Promise<FileSystemDirectoryHandle> {\r\n    if (!this.rootDirectoryPromise) {\r\n      this.rootDirectoryPromise = (async () => {\r\n        const storageManager = getOpfsStorageManager();\r\n        if (!storageManager?.getDirectory) {\r\n          throw new Error(\"OPFS is not available in this environment.\");\r\n        }\r\n        const root = await storageManager.getDirectory();\r\n        return root.getDirectoryHandle(\r\n          this.options.rootDirectoryName ?? \"syncore\",\r\n          { create: true }\r\n        );\r\n      })();\r\n    }\r\n    return this.rootDirectoryPromise;\r\n  }\r\n}\r\n\r\nasync function readFileBytes(handle: FileSystemFileHandle): Promise<Uint8Array> {\r\n  const file = await handle.getFile();\r\n  return new Uint8Array(await file.arrayBuffer());\r\n}\r\n\r\nasync function writeBytes(\r\n  handle: FileSystemFileHandle,\r\n  bytes: Uint8Array\r\n): Promise<void> {\r\n  const writable = await handle.createWritable();\r\n  try {\r\n    await writable.write(sliceToArrayBuffer(bytes));\r\n    await writable.truncate(bytes.byteLength);\r\n  } finally {\r\n    await writable.close();\r\n  }\r\n}\r\n\r\nasync function writeText(\r\n  handle: FileSystemFileHandle,\r\n  value: string\r\n): Promise<void> {\r\n  await writeBytes(handle, new TextEncoder().encode(value));\r\n}\r\n\r\nasync function removeEntryIfExists(\r\n  directory: FileSystemDirectoryHandle,\r\n  name: string\r\n): Promise<void> {\r\n  try {\r\n    await directory.removeEntry(name);\r\n  } catch (error) {\r\n    if (!isNotFoundError(error)) {\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n\r\nfunction encodePathComponent(value: string): string {\r\n  return encodeURIComponent(value);\r\n}\r\n\r\nfunction sliceToArrayBuffer(bytes: Uint8Array): ArrayBuffer {\r\n  return bytes.buffer.slice(\r\n    bytes.byteOffset,\r\n    bytes.byteOffset + bytes.byteLength\r\n  ) as ArrayBuffer;\r\n}\r\n\r\nfunction getOpfsStorageManager(): OpfsStorageManager | undefined {\r\n  if (typeof navigator === \"undefined\") {\r\n    return undefined;\r\n  }\r\n  return navigator.storage as OpfsStorageManager | undefined;\r\n}\r\n\r\nfunction isNotFoundError(error: unknown): boolean {\r\n  return (\r\n    typeof error === \"object\" &&\r\n    error !== null &&\r\n    \"name\" in error &&\r\n    error.name === \"NotFoundError\"\r\n  );\r\n}\r\n"],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+//#region src/persistence.d.ts
+interface StoredWebFile {
+  id: string;
+  bytes: Uint8Array;
+  contentType: string | null;
+  size: number;
+}
+interface SyncoreWebPersistence {
+  readonly storageProtocol: "idb" | "opfs";
+  loadDatabase(key: string): Promise<Uint8Array | null>;
+  saveDatabase(key: string, bytes: Uint8Array): Promise<void>;
+  getFile(namespace: string, id: string): Promise<StoredWebFile | null>;
+  putFile(namespace: string, id: string, bytes: Uint8Array, contentType: string | null): Promise<void>;
+  deleteFile(namespace: string, id: string): Promise<void>;
+  listFiles(namespace: string): Promise<StoredWebFile[]>;
+}
+type WebPersistenceMode = "auto" | "indexeddb" | "opfs";
+interface CreateWebPersistenceOptions {
+  mode?: WebPersistenceMode;
+  indexedDbDatabaseName?: string;
+  opfsRootDirectoryName?: string;
+}
+declare function createWebPersistence(options?: CreateWebPersistenceOptions): Promise<SyncoreWebPersistence>;
+declare function isOpfsAvailable(): boolean;
+//#endregion
+export { CreateWebPersistenceOptions, StoredWebFile, SyncoreWebPersistence, WebPersistenceMode, createWebPersistence, isOpfsAvailable };
+//# sourceMappingURL=persistence.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+import { SyncoreIndexedDbPersistence } from "./indexeddb.js";
+import { SyncoreOpfsPersistence } from "./opfs.js";
+//#region src/persistence.ts
+async function createWebPersistence(options = {}) {
+	const mode = options.mode ?? "auto";
+	if (mode === "opfs") {
+		if (!isOpfsAvailable()) throw new Error("OPFS is not available in this environment.");
+		return new SyncoreOpfsPersistence(options.opfsRootDirectoryName ? { rootDirectoryName: options.opfsRootDirectoryName } : void 0);
+	}
+	if (mode === "auto" && isOpfsAvailable()) return new SyncoreOpfsPersistence(options.opfsRootDirectoryName ? { rootDirectoryName: options.opfsRootDirectoryName } : void 0);
+	return new SyncoreIndexedDbPersistence(options.indexedDbDatabaseName ? { databaseName: options.indexedDbDatabaseName } : void 0);
+}
+function isOpfsAvailable() {
+	return Boolean(getOpfsStorageManager()?.getDirectory);
+}
+function getOpfsStorageManager() {
+	if (typeof navigator === "undefined") return;
+	return navigator.storage;
+}
+//#endregion
+export { createWebPersistence, isOpfsAvailable };
+
+//# sourceMappingURL=persistence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","names":[],"sources":["../src/persistence.ts"],"sourcesContent":["import { SyncoreIndexedDbPersistence } from \"./indexeddb.js\";\r\nimport { SyncoreOpfsPersistence } from \"./opfs.js\";\r\n\r\nexport interface StoredWebFile {\r\n  id: string;\r\n  bytes: Uint8Array;\r\n  contentType: string | null;\r\n  size: number;\r\n}\r\n\r\nexport interface SyncoreWebPersistence {\r\n  readonly storageProtocol: \"idb\" | \"opfs\";\r\n  loadDatabase(key: string): Promise<Uint8Array | null>;\r\n  saveDatabase(key: string, bytes: Uint8Array): Promise<void>;\r\n  getFile(namespace: string, id: string): Promise<StoredWebFile | null>;\r\n  putFile(\r\n    namespace: string,\r\n    id: string,\r\n    bytes: Uint8Array,\r\n    contentType: string | null\r\n  ): Promise<void>;\r\n  deleteFile(namespace: string, id: string): Promise<void>;\r\n  listFiles(namespace: string): Promise<StoredWebFile[]>;\r\n}\r\n\r\nexport type WebPersistenceMode = \"auto\" | \"indexeddb\" | \"opfs\";\r\n\r\nexport interface CreateWebPersistenceOptions {\r\n  mode?: WebPersistenceMode;\r\n  indexedDbDatabaseName?: string;\r\n  opfsRootDirectoryName?: string;\r\n}\r\n\r\nexport async function createWebPersistence(\r\n  options: CreateWebPersistenceOptions = {}\r\n): Promise<SyncoreWebPersistence> {\r\n  const mode = options.mode ?? \"auto\";\r\n\r\n  if (mode === \"opfs\") {\r\n    if (!isOpfsAvailable()) {\r\n      throw new Error(\"OPFS is not available in this environment.\");\r\n    }\r\n    return new SyncoreOpfsPersistence(\r\n      options.opfsRootDirectoryName\r\n        ? { rootDirectoryName: options.opfsRootDirectoryName }\r\n        : undefined\r\n    );\r\n  }\r\n\r\n  if (mode === \"auto\" && isOpfsAvailable()) {\r\n    return new SyncoreOpfsPersistence(\r\n      options.opfsRootDirectoryName\r\n        ? { rootDirectoryName: options.opfsRootDirectoryName }\r\n        : undefined\r\n    );\r\n  }\r\n\r\n  return new SyncoreIndexedDbPersistence(\r\n    options.indexedDbDatabaseName\r\n      ? { databaseName: options.indexedDbDatabaseName }\r\n      : undefined\r\n  );\r\n}\r\n\r\nexport function isOpfsAvailable(): boolean {\r\n  return Boolean(getOpfsStorageManager()?.getDirectory);\r\n}\r\n\r\ntype OpfsStorageManager = StorageManager & {\r\n  getDirectory?: () => Promise<FileSystemDirectoryHandle>;\r\n};\r\n\r\nfunction getOpfsStorageManager(): OpfsStorageManager | undefined {\r\n  if (typeof navigator === \"undefined\") {\r\n    return undefined;\r\n  }\r\n  return navigator.storage as OpfsStorageManager | undefined;\r\n}\r\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"}

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

@@ -0,0 +1,35 @@
+import { CreateWebWorkerClientProviderOptions } from "./worker.js";
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/react.d.ts
+/**
+ * Props for {@link SyncoreWebProvider}.
+ */
+interface SyncoreWebProviderProps extends CreateWebWorkerClientProviderOptions {
+  /** The React subtree that should receive the Syncore client. */
+  children: ReactNode;
+  /** Optional fallback content rendered before the worker client is ready. */
+  fallback?: ReactNode;
+}
+/**
+ * Props for {@link SyncoreBrowserProvider}.
+ */
+type SyncoreBrowserProviderProps = SyncoreWebProviderProps;
+/**
+ * Start a worker-backed Syncore client and provide it to React descendants.
+ */
+declare function SyncoreWebProvider({
+  children,
+  workerUrl,
+  workerType,
+  workerName,
+  fallback
+}: SyncoreWebProviderProps): ReactNode;
+/**
+ * Start a worker-backed Syncore client and provide it to React descendants.
+ */
+declare function SyncoreBrowserProvider(props: SyncoreBrowserProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SyncoreBrowserProvider, SyncoreBrowserProviderProps, SyncoreWebProvider, SyncoreWebProviderProps };
+//# sourceMappingURL=react.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,42 @@
+import { createSyncoreWebWorkerClient } from "./worker.js";
+import { useEffect, useState } from "react";
+import { SyncoreProvider } from "../react/index.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/react.tsx
+/**
+* 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);
+	useEffect(() => {
+		const nextClient = createSyncoreWebWorkerClient({
+			workerUrl,
+			...workerType ? { workerType } : {},
+			...workerName ? { workerName } : {}
+		});
+		setManagedClient(nextClient);
+		return () => {
+			nextClient.dispose();
+			setManagedClient(null);
+		};
+	}, [
+		workerName,
+		workerType,
+		workerUrl
+	]);
+	if (!managedClient) return fallback;
+	return /* @__PURE__ */ jsx(SyncoreProvider, {
+		client: managedClient.client,
+		children
+	});
+}
+/**
+* Start a worker-backed Syncore client and provide it to React descendants.
+*/
+function SyncoreBrowserProvider(props) {
+	return /* @__PURE__ */ jsx(SyncoreWebProvider, { ...props });
+}
+//#endregion
+export { SyncoreBrowserProvider, SyncoreWebProvider };
+
+//# sourceMappingURL=react.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import { useEffect, useState } from \"react\";\r\nimport type { ReactNode } from \"react\";\r\nimport { SyncoreProvider } from \"@syncore/react\";\r\nimport {\r\n  createSyncoreWebWorkerClient,\r\n  type CreateWebWorkerClientProviderOptions,\r\n  type ManagedWebWorkerClient\r\n} from \"./worker.js\";\r\n\r\n/**\r\n * Props for {@link SyncoreWebProvider}.\r\n */\r\nexport interface SyncoreWebProviderProps extends CreateWebWorkerClientProviderOptions {\r\n  /** The React subtree that should receive the Syncore client. */\r\n  children: ReactNode;\r\n\r\n  /** Optional fallback content rendered before the worker client is ready. */\r\n  fallback?: ReactNode;\r\n}\r\n\r\n/**\r\n * Props for {@link SyncoreBrowserProvider}.\r\n */\r\nexport type SyncoreBrowserProviderProps = SyncoreWebProviderProps;\r\n\r\n/**\r\n * Start a worker-backed Syncore client and provide it to React descendants.\r\n */\r\nexport function SyncoreWebProvider({\r\n  children,\r\n  workerUrl,\r\n  workerType,\r\n  workerName,\r\n  fallback = null\r\n}: SyncoreWebProviderProps): ReactNode {\r\n  const [managedClient, setManagedClient] =\r\n    useState<ManagedWebWorkerClient | null>(null);\r\n\r\n  useEffect(() => {\r\n    const nextClient = createSyncoreWebWorkerClient({\r\n      workerUrl,\r\n      ...(workerType ? { workerType } : {}),\r\n      ...(workerName ? { workerName } : {})\r\n    });\r\n    setManagedClient(nextClient);\r\n\r\n    return () => {\r\n      nextClient.dispose();\r\n      setManagedClient(null);\r\n    };\r\n  }, [workerName, workerType, workerUrl]);\r\n\r\n  if (!managedClient) {\r\n    return fallback;\r\n  }\r\n\r\n  return (\r\n    <SyncoreProvider client={managedClient.client}>{children}</SyncoreProvider>\r\n  );\r\n}\r\n\r\n/**\r\n * Start a worker-backed Syncore client and provide it to React descendants.\r\n */\r\nexport function SyncoreBrowserProvider(props: SyncoreBrowserProviderProps) {\r\n  return <SyncoreWebProvider {...props} />;\r\n}\r\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"}

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

@@ -0,0 +1,133 @@
+import { SyncoreIndexedDbPersistence } from "./indexeddb.js";
+import initSqlJs from "sql.js";
+//#region src/sqljs.ts
+var SqlJsDriver = class SqlJsDriver {
+	transactionDepth = 0;
+	closed = false;
+	constructor(database, persistence, databaseName) {
+		this.database = database;
+		this.persistence = persistence;
+		this.databaseName = databaseName;
+	}
+	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 existingBytes = await persistence.loadDatabase(options.databaseName);
+		return new SqlJsDriver(existingBytes ? new SQL.Database(existingBytes) : new SQL.Database(), persistence, options.databaseName);
+	}
+	async exec(sql) {
+		this.ensureOpen();
+		this.database.run(sql);
+		await this.persistIfNeeded();
+	}
+	async run(sql, params = []) {
+		this.ensureOpen();
+		const statement = this.database.prepare(sql);
+		try {
+			statement.run(normalizeParams(params));
+			const lastInsertRowid = readScalarNumber(this.database, "SELECT last_insert_rowid()");
+			const result = {
+				changes: this.database.getRowsModified(),
+				...lastInsertRowid !== null ? { lastInsertRowid } : {}
+			};
+			await this.persistIfNeeded();
+			return result;
+		} finally {
+			statement.free();
+		}
+	}
+	async get(sql, params = []) {
+		this.ensureOpen();
+		const statement = this.database.prepare(sql);
+		try {
+			statement.bind(normalizeParams(params));
+			if (!statement.step()) return;
+			return statement.getAsObject();
+		} finally {
+			statement.free();
+		}
+	}
+	async all(sql, params = []) {
+		this.ensureOpen();
+		const statement = this.database.prepare(sql);
+		try {
+			statement.bind(normalizeParams(params));
+			const rows = [];
+			while (statement.step()) rows.push(statement.getAsObject());
+			return rows;
+		} finally {
+			statement.free();
+		}
+	}
+	async withTransaction(callback) {
+		this.ensureOpen();
+		if (this.transactionDepth > 0) return this.withSavepoint(`nested_${this.transactionDepth}`, callback);
+		this.transactionDepth += 1;
+		this.database.run("BEGIN IMMEDIATE");
+		try {
+			const result = await callback();
+			this.database.run("COMMIT");
+			await this.persistNow();
+			return result;
+		} catch (error) {
+			this.database.run("ROLLBACK");
+			throw error;
+		} finally {
+			this.transactionDepth -= 1;
+		}
+	}
+	async withSavepoint(name, callback) {
+		this.ensureOpen();
+		const safeName = name.replaceAll(/[^a-zA-Z0-9_]/g, "_");
+		this.database.run(`SAVEPOINT ${safeName}`);
+		this.transactionDepth += 1;
+		try {
+			const result = await callback();
+			this.database.run(`RELEASE SAVEPOINT ${safeName}`);
+			return result;
+		} catch (error) {
+			this.database.run(`ROLLBACK TO SAVEPOINT ${safeName}`);
+			this.database.run(`RELEASE SAVEPOINT ${safeName}`);
+			throw error;
+		} finally {
+			this.transactionDepth -= 1;
+		}
+	}
+	async close() {
+		if (this.closed) return;
+		await this.persistNow();
+		this.database.close();
+		this.closed = true;
+	}
+	async persistIfNeeded() {
+		if (this.transactionDepth === 0) await this.persistNow();
+	}
+	async persistNow() {
+		this.ensureOpen();
+		await this.persistence.saveDatabase(this.databaseName, this.database.export());
+	}
+	ensureOpen() {
+		if (this.closed) throw new Error("The sql.js driver is already closed.");
+	}
+};
+function normalizeParams(values) {
+	return values.map((value) => {
+		if (typeof value === "boolean") return value ? 1 : 0;
+		if (value === null || typeof value === "number" || typeof value === "string" || value instanceof Uint8Array) return value;
+		if (value instanceof ArrayBuffer) return new Uint8Array(value);
+		return JSON.stringify(value);
+	});
+}
+function readScalarNumber(database, sql) {
+	const firstValue = (database.exec(sql)[0]?.values[0])?.[0];
+	if (typeof firstValue === "number") return firstValue;
+	if (typeof firstValue === "string") {
+		const parsed = Number(firstValue);
+		return Number.isNaN(parsed) ? null : parsed;
+	}
+	return null;
+}
+//#endregion
+export { SqlJsDriver };
+
+//# sourceMappingURL=sqljs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqljs.js","names":[],"sources":["../src/sqljs.ts"],"sourcesContent":["import initSqlJs from \"sql.js\";\r\nimport type { RunResult, SyncoreSqlDriver } from \"@syncore/core\";\r\nimport { SyncoreIndexedDbPersistence } from \"./indexeddb.js\";\r\nimport type { SyncoreWebPersistence } from \"./persistence.js\";\r\n\r\ntype SqlJsDatabase = initSqlJs.Database;\r\ntype SqlJsValue = initSqlJs.SqlValue;\r\n\r\nexport interface CreateSqlJsDriverOptions {\r\n  databaseName: string;\r\n  persistence?: SyncoreWebPersistence;\r\n  wasmUrl?: string;\r\n  locateFile?: (fileName: string) => string;\r\n}\r\n\r\nexport class SqlJsDriver implements SyncoreSqlDriver {\r\n  private transactionDepth = 0;\r\n  private closed = false;\r\n\r\n  constructor(\r\n    private readonly database: SqlJsDatabase,\r\n    private readonly persistence: SyncoreWebPersistence,\r\n    private readonly databaseName: string\r\n  ) {}\r\n\r\n  static async create(options: CreateSqlJsDriverOptions): Promise<SqlJsDriver> {\r\n    const persistence =\r\n      options.persistence ?? new SyncoreIndexedDbPersistence();\r\n    const SQL = await initSqlJs(\r\n      typeof window === \"undefined\" && !options.locateFile && !options.wasmUrl\r\n        ? undefined\r\n        : {\r\n            locateFile:\r\n              options.locateFile ?? (() => options.wasmUrl ?? \"/sql-wasm.wasm\")\r\n          }\r\n    );\r\n    const existingBytes = await persistence.loadDatabase(options.databaseName);\r\n    const database = existingBytes\r\n      ? new SQL.Database(existingBytes)\r\n      : new SQL.Database();\r\n    return new SqlJsDriver(database, persistence, options.databaseName);\r\n  }\r\n\r\n  async exec(sql: string): Promise<void> {\r\n    this.ensureOpen();\r\n    this.database.run(sql);\r\n    await this.persistIfNeeded();\r\n  }\r\n\r\n  async run(sql: string, params: unknown[] = []): Promise<RunResult> {\r\n    this.ensureOpen();\r\n    const statement = this.database.prepare(sql);\r\n    try {\r\n      statement.run(normalizeParams(params));\r\n      const lastInsertRowid = readScalarNumber(\r\n        this.database,\r\n        \"SELECT last_insert_rowid()\"\r\n      );\r\n      const result = {\r\n        changes: this.database.getRowsModified(),\r\n        ...(lastInsertRowid !== null ? { lastInsertRowid } : {})\r\n      };\r\n      await this.persistIfNeeded();\r\n      return result;\r\n    } finally {\r\n      statement.free();\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 statement = this.database.prepare(sql);\r\n    try {\r\n      statement.bind(normalizeParams(params));\r\n      if (!statement.step()) {\r\n        return undefined;\r\n      }\r\n      return statement.getAsObject() as T;\r\n    } finally {\r\n      statement.free();\r\n    }\r\n  }\r\n\r\n  async all<T>(sql: string, params: unknown[] = []): Promise<T[]> {\r\n    this.ensureOpen();\r\n    const statement = this.database.prepare(sql);\r\n    try {\r\n      statement.bind(normalizeParams(params));\r\n      const rows: T[] = [];\r\n      while (statement.step()) {\r\n        rows.push(statement.getAsObject() as T);\r\n      }\r\n      return rows;\r\n    } finally {\r\n      statement.free();\r\n    }\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    this.database.run(\"BEGIN IMMEDIATE\");\r\n    try {\r\n      const result = await callback();\r\n      this.database.run(\"COMMIT\");\r\n      await this.persistNow();\r\n      return result;\r\n    } catch (error) {\r\n      this.database.run(\"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.database.run(`SAVEPOINT ${safeName}`);\r\n    this.transactionDepth += 1;\r\n    try {\r\n      const result = await callback();\r\n      this.database.run(`RELEASE SAVEPOINT ${safeName}`);\r\n      return result;\r\n    } catch (error) {\r\n      this.database.run(`ROLLBACK TO SAVEPOINT ${safeName}`);\r\n      this.database.run(`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.persistNow();\r\n    this.database.close();\r\n    this.closed = true;\r\n  }\r\n\r\n  private async persistIfNeeded(): Promise<void> {\r\n    if (this.transactionDepth === 0) {\r\n      await this.persistNow();\r\n    }\r\n  }\r\n\r\n  private async persistNow(): Promise<void> {\r\n    this.ensureOpen();\r\n    await this.persistence.saveDatabase(\r\n      this.databaseName,\r\n      this.database.export()\r\n    );\r\n  }\r\n\r\n  private ensureOpen(): void {\r\n    if (this.closed) {\r\n      throw new Error(\"The sql.js driver is already closed.\");\r\n    }\r\n  }\r\n}\r\n\r\nfunction normalizeParams(values: unknown[]): SqlJsValue[] {\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 === \"number\" ||\r\n      typeof value === \"string\" ||\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 readScalarNumber(database: SqlJsDatabase, sql: string): number | null {\r\n  const rows = database.exec(sql);\r\n  const firstSet = rows[0];\r\n  const firstRow = firstSet?.values[0];\r\n  const firstValue = firstRow?.[0];\r\n  if (typeof firstValue === \"number\") {\r\n    return firstValue;\r\n  }\r\n  if (typeof firstValue === \"string\") {\r\n    const parsed = Number(firstValue);\r\n    return Number.isNaN(parsed) ? null : parsed;\r\n  }\r\n  return null;\r\n}\r\n"],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+import { AnySyncoreSchema, FunctionReference, SyncoreClient, SyncoreRuntime, SyncoreWatch } 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>;
+}
+/**
+ * A worker-backed browser client plus the Worker instance it owns.
+ */
+interface ManagedWebWorkerClient {
+  client: SyncoreWebWorkerClient;
+  worker: Worker;
+  dispose(): void;
+}
+/**
+ * Options for creating a worker-backed Syncore client in the browser.
+ */
+interface CreateWebWorkerClientProviderOptions {
+  /** The worker module URL passed to `new Worker(...)`. */
+  workerUrl: URL | string;
+  /** Optional worker type, defaults to `module`. */
+  workerType?: WorkerOptions["type"];
+  /** Optional name shown in browser devtools. */
+  workerName?: string;
+}
+/**
+ * Create a web worker Syncore client from a low-level message endpoint.
+ */
+declare function createWebWorkerClient(endpoint: SyncoreWorkerMessageEndpoint): SyncoreWebWorkerClient;
+/**
+ * Create and manage both a browser Worker and the Syncore client that talks to it.
+ */
+declare function createManagedWebWorkerClient(options: {
+  createWorker: () => Worker;
+}): ManagedWebWorkerClient;
+/**
+ * Create a worker-backed Syncore client using the standard Worker constructor.
+ */
+declare function createSyncoreWebWorkerClient(options: CreateWebWorkerClientProviderOptions): ManagedWebWorkerClient;
+/**
+ * Attach a Syncore runtime implementation to a worker message endpoint.
+ */
+declare function attachWebWorkerRuntime(options: AttachWebWorkerRuntimeOptions): AttachedWebWorkerRuntime;
+//#endregion
+export { AttachWebWorkerRuntimeOptions, AttachedWebWorkerRuntime, CreateWebWorkerClientProviderOptions, ManagedWebWorkerClient, SyncoreWebWorkerClient, SyncoreWorkerMessageEndpoint, WebWorkerSyncoreSchema, WorkerQueryWatch, attachWebWorkerRuntime, createManagedWebWorkerClient, createSyncoreWebWorkerClient, createWebWorkerClient };
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +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"}