@signaldb/opfs 2.0.0-beta.6 → 2.0.0-beta.7

package/dist/base/core/src/utils/isEqual.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Compares two values for deep equality.
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns - Returns `true` if the two values are deeply equal, otherwise `false`.
+ * @example
+ * isEqual({ a: 1 }, { a: 1 }); // true
+ * isEqual([1, 2], [1, 2]);     // true
+ * isEqual(new Date(0), new Date(0)); // true
+ * isEqual(/abc/, /abc/);       // true
+ * isEqual({ a: 1 }, { a: 2 }); // false
+ * isEqual(null, null);         // true
+ */
+export default function isEqual<T, K>(a: T, b: K): boolean;

package/dist/base/core/src/utils/isFieldExpression.d.ts

@@ -0,0 +1,11 @@
+import type { FieldExpression } from '../types/Selector';
+/**
+ * Determines whether a given object is a valid field expression.
+ * A field expression is an object containing query operators supported by MongoDB-style queries.
+ * @template T - The type of the field expression.
+ * @param expression - The object to test.
+ * @returns A boolean indicating whether the object is a valid field expression.
+ *   - `true` if the object contains only recognized query operators.
+ *   - `false` otherwise.
+ */
+export default function isFieldExpression<T>(expression: any): expression is FieldExpression<T>;

package/dist/base/core/src/utils/match.d.ts

@@ -0,0 +1,12 @@
+import type Selector from '../types/Selector';
+type BaseItem = Record<string, any>;
+/**
+ * Tests whether a given item matches a specified selector.
+ * Uses the `mingo` library to evaluate the query.
+ * @template T - The type of the item being tested.
+ * @param item - The item to test against the selector.
+ * @param selector - The query selector used to match the item.
+ * @returns A boolean indicating whether the item matches the selector.
+ */
+export default function match<T extends BaseItem = BaseItem>(item: T, selector: Selector<T>): boolean;
+export {};

package/dist/base/core/src/utils/modify.d.ts

@@ -0,0 +1,14 @@
+import type Modifier from '../types/Modifier';
+/**
+ * Applies a modifier to an object and returns a new modified object.
+ * @template T - The type of the object to be modified.
+ * @param item - The object to be modified.
+ * @param modifier - The modifier to apply. This can be any transformation logic.
+ * @returns - Returns a new object with the modifications applied.
+ * @example
+ * const item = { a: 1, b: 2 }
+ * const modifier = { $set: { b: 3, c: 4 } }
+ * const result = modify(item, modifier)
+ * // result: { a: 1, b: 3, c: 4 }
+ */
+export default function modify<T extends Record<string, any>>(item: T, modifier: Modifier): T;

package/dist/base/core/src/utils/project.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Projects the fields of an object based on a specified fields configuration.
+ * Supports inclusion (`1`) and exclusion (`0`) of specific fields. Creates a new object
+ * with the desired fields included or excluded, based on the configuration.
+ * @template T - The type of the object being projected.
+ * @param item - The original object to project fields from.
+ * @param fields - An object defining the fields to include (`1`) or exclude (`0`).
+ *   - Keys are the field names, and values are either `1` (include) or `0` (exclude).
+ * @returns A new object with the specified fields included or excluded.
+ *   - If all fields are set to `0`, the excluded fields are removed from the result.
+ *   - If fields are set to `1`, only the included fields are retained.
+ */
+export default function project<T extends Record<string, any>>(item: T, fields: {
+    [P in keyof T]?: 0 | 1;
+} & Record<string, 0 | 1>): T;

package/dist/base/core/src/utils/queryId.d.ts

@@ -0,0 +1,9 @@
+import type { QueryOptions } from '../DataAdapter';
+import type Selector from '../types/Selector';
+/**
+ * Generates a unique identifier for a query based on its selector and options.
+ * @param selector - The selector object.
+ * @param options - The query options object (optional).
+ * @returns A unique identifier string for the query.
+ */
+export default function queryId(selector: Selector<any>, options?: QueryOptions<any>): string;

package/dist/base/core/src/utils/randomId.d.ts

@@ -0,0 +1,7 @@
+/**
+ * creates a random id
+ * @returns a random string of 16 characters
+ * @example
+ * randomId() // '1234567890abcdef'
+ */
+export default function randomId(): string;

package/dist/base/core/src/utils/reactiveOrAsync.d.ts

@@ -0,0 +1,59 @@
+export type MaybePromise<T> = T | Promise<T>;
+/**
+ * Options that control execution mode (and potential future mode-specific behavior).
+ * Keep this minimal; you can extend it later (e.g. signal, timeoutMs, debugLabel).
+ */
+export type ModeOptions = {
+    async?: boolean;
+};
+/**
+ * A generator helper that makes TypeScript infer the “synchronous value type” for maybe-async expressions.
+ *
+ * Usage:
+ *   const doc = yield* unwrap(Collection.findOne(...))
+ *   const list = yield* unwrap(Collection.find(...).fetch())
+ *
+ * Runtime note:
+ *   This does not “unwrap” Promises by itself. It yields the value/Promise to the runner and returns the
+ *   value that the runner feeds back via `.next(...)`.
+ * @param value The value (or Promise of a value) to yield to the runner.
+ * @returns A generator that yields `value` and resolves to the runner-supplied unwrapped `T`.
+ */
+export declare function unwrap<T>(value: MaybePromise<T>): Generator<MaybePromise<T>, T, T>;
+/**
+ * Generator shape used by the factory.
+ *
+ * `TThis` is the type of `this` inside the generator.
+ * `Args` are the method parameters (excluding the mode flag).
+ * `TReturn` is the final return value of the workflow.
+ * `TNext` is the type that is yielded/awaited and fed back via `.next(...)`.
+ *
+ * Note:
+ * - For best inference at yield sites, prefer `yield* unwrap(expr)` for maybe-async expressions.
+ */
+export type ReactiveOrAsyncGen<TThis, Arguments extends any[], TReturn, TNext> = (this: TThis, a: boolean, ...args: Arguments) => Generator<MaybePromise<TNext>, TReturn, TNext>;
+/**
+ * The method type produced from the generator signature.
+ * Adds overloads so that `{ async: true }` yields a `Promise<...>` return type.
+ */
+export type ReactiveOrAsyncMethod<TThis, P extends any[], R, N> = {
+    (this: TThis, ...args: P): R;
+    (this: TThis, ...args: [...P, ModeOptions?]): MaybePromise<R>;
+    (this: TThis, ...args: [...P, {
+        async: true;
+    }]): Promise<R>;
+} & {
+    /** Exposes the underlying generator for composition via `yield* method.generator.call(this, a, ...)` */
+    generator: (this: TThis, a: boolean, ...args: P) => Generator<MaybePromise<N>, R, N>;
+};
+/**
+ * Factory that turns a generator workflow into a callable method that can run in sync (reactive) or async mode.
+ *
+ * Call style:
+ *   fn(a, b)                        -> sync/reactive return
+ *   await fn(a, b, { async: true }) -> async return
+ * @param gen Generator workflow. Receives `(a)` which indicates async mode and should `yield`/`yield* unwrap(...)`
+ *   any values that may be Promises.
+ * @returns A callable method with overloads plus a `.generator` property for composition.
+ */
+export default function reactiveOrAsync<TThis, P extends any[], R, N>(gen: (this: TThis, a: boolean, ...args: P) => Generator<MaybePromise<N>, R, N>): ReactiveOrAsyncMethod<TThis, P, R, N>;

package/dist/base/core/src/utils/serializeValue.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Serializes a value into a string representation.
+ * Handles various types, including strings, numbers, booleans, dates, and objects.
+ * Falls back to JSON stringification for unsupported types.
+ * @param value - The value to serialize.
+ *   - Strings are returned as-is.
+ *   - Numbers and booleans are converted to their string representation.
+ *   - Dates are converted to ISO string format.
+ *   - Other values are stringified using `JSON.stringify`.
+ * @returns A string representation of the value.
+ */
+export default function serializeValue(value: any): string | null;

package/dist/base/core/src/utils/set.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sets a value at a specified path within an object. Creates nested structures
+ * (arrays or objects) as needed to set the value at the correct location. Supports
+ * deleting the key if the value is `undefined` and the `deleteIfUndefined` flag is set to `true`.
+ * @template T - The type of the object to modify.
+ * @template K - The type of the value to set.
+ * @param object - The object to modify. The object is mutated directly.
+ * @param path - The path (dot or bracket notation) where the value should be set.
+ * @param value - The value to set at the specified path.
+ * @param deleteIfUndefined - A boolean indicating whether to delete the key if the value is `undefined` (default: `false`).
+ * @returns The modified object.
+ */
+export default function set<T extends object, K>(object: T, path: string, value: K, deleteIfUndefined?: boolean): T;

package/dist/base/core/src/utils/sortItems.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sorts an array of items based on multiple fields and their specified sort order.
+ * Uses the `fast-sort` library for efficient sorting.
+ * @template T - The type of the items in the array.
+ * @param items - The array of items to be sorted.
+ * @param sortFields - An object defining the sort order for each field.
+ *   - Keys are the field names, and values are either `1` (ascending) or `-1` (descending).
+ * @returns A new array of items sorted based on the specified fields and their order.
+ */
+export default function sortItems<T extends Record<string, any>>(items: T[], sortFields: {
+    [P in keyof T]?: -1 | 1;
+} & Record<string, -1 | 1>): T[];

package/dist/base/core/src/utils/uniqueBy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Filters an array to ensure unique values based on a specified key or transformation function.
+ * @template T - The type of the elements in the array.
+ * @param array - The array to filter for unique values.
+ * @param fn - A key or transformation function to determine uniqueness.
+ *   - If a key is provided, it will use the corresponding property of each element for uniqueness.
+ *   - If a function is provided, it will use the return value of the function applied to each element for uniqueness.
+ * @returns A new array containing only unique elements based on the specified key or transformation.
+ */
+export default function uniqueBy<T>(array: T[], fn: keyof T | ((item: T) => any)): T[];

package/dist/index.mjs

@@ -1,101 +1,93 @@
-import p from "@signaldb/generic-fs";
-import { serializeValue as m } from "@signaldb/core";
-function u(l) {
-  let i = l.normalize("NFC");
-  const d = (s) => s.replaceAll(/[-/\\^$*+?.()|[\]{}]/g, String.raw`\$&`);
-  return i = i.replaceAll("/", "_"), i = i.replaceAll(new RegExp(`${d("_")}{2,}`, "g"), "_"), i || (i = "unnamed"), i;
+import e from "@signaldb/generic-fs";
+import { serializeValue as t } from "@signaldb/core";
+//#region src/index.ts
+function n(e) {
+	let t = e.normalize("NFC");
+	return t = t.replaceAll("/", "_"), t = t.replaceAll(RegExp(`${((e) => e.replaceAll(/[-/\\^$*+?.()|[\]{}]/g, String.raw`\$&`))("_")}{2,}`, "g"), "_"), t ||= "unnamed", t;
 }
-async function g(l, y) {
-  const i = `opfs:${l}`;
-  return navigator.locks.request(i, { mode: "exclusive" }, y);
+async function r(e, t) {
+	let n = `opfs:${e}`;
+	return navigator.locks.request(n, { mode: "exclusive" }, t);
 }
-function D(l, y) {
-  const { serialize: i = JSON.stringify, deserialize: d = JSON.parse } = y || {}, s = async (e, a, o) => {
-    const r = a.split("/").filter(Boolean);
-    let t = e;
-    for (const n of r)
-      t = await t.getDirectoryHandle(n, { create: o });
-    return t;
-  }, w = async (e, a, o) => {
-    const r = a.split("/").filter(Boolean), t = r.pop();
-    return (await s(e, r.join("/"), o)).getFileHandle(t, { create: o });
-  }, f = {
-    fileNameForId: (e) => Promise.resolve(u(m(e))),
-    fileNameForIndexKey: (e) => Promise.resolve(u(e)),
-    joinPath: (...e) => Promise.resolve(e.join("/")),
-    ensureDir: async (e) => {
-      const a = await navigator.storage.getDirectory();
-      await s(a, e, !0);
-    },
-    fileExists: async (e) => {
-      const a = await navigator.storage.getDirectory();
-      try {
-        return await w(a, e, !1), !0;
-      } catch {
-        const o = e.split("/").filter(Boolean);
-        let r = a;
-        for (const t of o)
-          try {
-            r = await r.getDirectoryHandle(t);
-          } catch {
-            return !1;
-          }
-        return !0;
-      }
-    },
-    readObject: async (e) => g(e, async () => {
-      const a = await navigator.storage.getDirectory(), t = await (await (await w(a, e, !1)).getFile()).text();
-      return d(t);
-    }),
-    writeObject: async (e, a) => g(e, async () => {
-      const o = await navigator.storage.getDirectory(), r = await w(o, e, !0), t = i(a);
-      if (typeof t != "string")
-        throw new TypeError("serialize() must return a string");
-      const n = await r.createWritable();
-      try {
-        const c = new TextEncoder().encode(t);
-        await n.write({ type: "write", position: 0, data: c }), await n.truncate(c.byteLength), await n.close();
-      } catch (c) {
-        throw await n.abort(), c;
-      }
-    }),
-    readIndexObject: async (e) => g(e, async () => {
-      const a = await navigator.storage.getDirectory(), t = await (await (await w(a, e, !1)).getFile()).text();
-      return d(t);
-    }),
-    writeIndexObject: async (e, a) => g(e, async () => {
-      const o = await navigator.storage.getDirectory(), r = await w(o, e, !0), t = i(a);
-      if (typeof t != "string")
-        throw new TypeError("serialize() must return a string");
-      const n = await r.createWritable();
-      try {
-        const c = new TextEncoder().encode(t);
-        await n.write({ type: "write", position: 0, data: c }), await n.truncate(c.byteLength), await n.close();
-      } catch (c) {
-        throw await n.abort(), c;
-      }
-    }),
-    listFilesRecursive: async (e) => {
-      const a = await navigator.storage.getDirectory(), o = await s(a, e, !1), r = [];
-      for await (const t of o.values())
-        if (t.kind === "file")
-          r.push(t.name);
-        else if (t.kind === "directory") {
-          const n = await f.listFilesRecursive(`${e}/${t.name}`);
-          r.push(...n.map((c) => `${t.name}/${c}`));
-        }
-      return r;
-    },
-    removeEntry: async (e, a) => {
-      const o = await navigator.storage.getDirectory(), r = e.split("/").filter(Boolean), t = r.pop();
-      if (!t)
-        throw new Error("Invalid path");
-      await (r.length > 0 ? await s(o, r.join("/"), !1) : o).removeEntry(t, { recursive: !!a?.recursive });
-    }
-  };
-  return p(f, l);
+function i(i, a) {
+	let { serialize: o = JSON.stringify, deserialize: s = JSON.parse } = a || {}, c = async (e, t, n) => {
+		let r = t.split("/").filter(Boolean), i = e;
+		for (let e of r) i = await i.getDirectoryHandle(e, { create: n });
+		return i;
+	}, l = async (e, t, n) => {
+		let r = t.split("/").filter(Boolean), i = r.pop();
+		return (await c(e, r.join("/"), n)).getFileHandle(i, { create: n });
+	}, u = {
+		fileNameForId: (e) => Promise.resolve(n(t(e))),
+		fileNameForIndexKey: (e) => Promise.resolve(n(e)),
+		joinPath: (...e) => Promise.resolve(e.join("/")),
+		ensureDir: async (e) => {
+			await c(await navigator.storage.getDirectory(), e, !0);
+		},
+		fileExists: async (e) => {
+			let t = await navigator.storage.getDirectory();
+			try {
+				return await l(t, e, !1), !0;
+			} catch {
+				let n = e.split("/").filter(Boolean), r = t;
+				for (let e of n) try {
+					r = await r.getDirectoryHandle(e);
+				} catch {
+					return !1;
+				}
+				return !0;
+			}
+		},
+		readObject: async (e) => r(e, async () => s(await (await (await l(await navigator.storage.getDirectory(), e, !1)).getFile()).text())),
+		writeObject: async (e, t) => r(e, async () => {
+			let n = await l(await navigator.storage.getDirectory(), e, !0), r = o(t);
+			if (typeof r != "string") throw TypeError("serialize() must return a string");
+			let i = await n.createWritable();
+			try {
+				let e = new TextEncoder().encode(r);
+				await i.write({
+					type: "write",
+					position: 0,
+					data: e
+				}), await i.truncate(e.byteLength), await i.close();
+			} catch (e) {
+				throw await i.abort(), e;
+			}
+		}),
+		readIndexObject: async (e) => r(e, async () => s(await (await (await l(await navigator.storage.getDirectory(), e, !1)).getFile()).text())),
+		writeIndexObject: async (e, t) => r(e, async () => {
+			let n = await l(await navigator.storage.getDirectory(), e, !0), r = o(t);
+			if (typeof r != "string") throw TypeError("serialize() must return a string");
+			let i = await n.createWritable();
+			try {
+				let e = new TextEncoder().encode(r);
+				await i.write({
+					type: "write",
+					position: 0,
+					data: e
+				}), await i.truncate(e.byteLength), await i.close();
+			} catch (e) {
+				throw await i.abort(), e;
+			}
+		}),
+		listFilesRecursive: async (e) => {
+			let t = await c(await navigator.storage.getDirectory(), e, !1), n = [];
+			for await (let r of t.values()) if (r.kind === "file") n.push(r.name);
+			else if (r.kind === "directory") {
+				let t = await u.listFilesRecursive(`${e}/${r.name}`);
+				n.push(...t.map((e) => `${r.name}/${e}`));
+			}
+			return n;
+		},
+		removeEntry: async (e, t) => {
+			let n = await navigator.storage.getDirectory(), r = e.split("/").filter(Boolean), i = r.pop();
+			if (!i) throw Error("Invalid path");
+			await (r.length > 0 ? await c(n, r.join("/"), !1) : n).removeEntry(i, { recursive: !!t?.recursive });
+		}
+	};
+	return e(u, i);
 }
-export {
-  D as default
-};
-//# sourceMappingURL=index.mjs.map
+//#endregion
+export { i as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["import createGenericFSAdapter from '@signaldb/generic-fs';\nimport { serializeValue } from '@signaldb/core';\n/**\n * Convert an arbitrary filename into a OPFS safe filename.\n * @param input - The input filename to sanitize.\n * @returns A safe filename.\n */\nfunction toSafeFilename(input) {\n    const replacement = '_';\n    let name = input.normalize('NFC');\n    const escapeRegex = (s) => s.replaceAll(/[-/\\\\^$*+?.()|[\\]{}]/g, String.raw `\\$&`);\n    name = name.replaceAll('/', replacement);\n    name = name.replaceAll(new RegExp(`${escapeRegex(replacement)}{2,}`, 'g'), replacement);\n    if (!name)\n        name = 'unnamed';\n    return name;\n}\n/**\n * Acquire a lock for a specific file path to ensure exclusive access during read/write operations.\n * @param path - The file path to lock.\n * @param fn - The asynchronous function to execute while holding the lock.\n * @returns The result of the function `fn`.\n */\nasync function withPathLock(path, fn) {\n    const lockName = `opfs:${path}`;\n    // Use exclusive mode so reads cannot interleave with writes\n    return navigator.locks.request(lockName, { mode: 'exclusive' }, fn);\n}\n/**\n * Creates a persistence adapter for managing a SignalDB collection using the\n * Origin Private File System (OPFS). This adapter allows data to be stored and managed\n * directly in the browser's file system with support for customizable serialization\n * and deserialization.\n * @template T - The type of the items in the collection.\n * @template I - The type of the unique identifier for the items.\n * @param folderName - The name of the file in OPFS where data will be stored.\n * @param options - Optional configuration for serialization and deserialization.\n * @param options.serialize - A function to serialize items to a string (default: `JSON.stringify`).\n * @param options.deserialize - A function to deserialize a string into items (default: `JSON.parse`).\n * @returns A SignalDB persistence adapter for managing data in OPFS.\n * @example\n * import createOPFSAdapter from './createOPFSAdapter';\n * import { Collection } from '@signaldb/core';\n *\n * const adapter = createOPFSAdapter('myCollection.json', {\n *   serialize: (items) => JSON.stringify(items, null, 2), // Pretty-print JSON\n *   deserialize: (itemsString) => JSON.parse(itemsString), // Default JSON parse\n * });\n *\n * const collection = new Collection({\n *   persistence: adapter,\n * });\n *\n * // Perform operations on the collection, and changes will be reflected in the OPFS file.\n */\nexport default function createOPFSAdapter(folderName, options) {\n    const { serialize = JSON.stringify, deserialize = JSON.parse, } = options || {};\n    const ensureDirectoryExists = async (rootDirectory, directoryPath, createIfMissing) => {\n        const parts = directoryPath.split('/').filter(Boolean);\n        let current = rootDirectory;\n        for (const part of parts) {\n            current = await current.getDirectoryHandle(part, { create: createIfMissing });\n        }\n        return current;\n    };\n    const getFileHandleForPath = async (rootDirectory, fullPath, createIfMissing) => {\n        const parts = fullPath.split('/').filter(Boolean);\n        const fileName = parts.pop();\n        const directoryHandle = await ensureDirectoryExists(rootDirectory, parts.join('/'), createIfMissing);\n        return directoryHandle.getFileHandle(fileName, { create: createIfMissing });\n    };\n    const driver = {\n        fileNameForId: id => Promise.resolve(toSafeFilename(serializeValue(id))),\n        fileNameForIndexKey: key => Promise.resolve(toSafeFilename(key)),\n        joinPath: (...parts) => Promise.resolve(parts.join('/')),\n        ensureDir: async (directoryPath) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            await ensureDirectoryExists(rootDirectory, directoryPath, true);\n        },\n        fileExists: async (path) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            try {\n                await getFileHandleForPath(rootDirectory, path, false);\n                return true;\n            }\n            catch {\n                const parts = path.split('/').filter(Boolean);\n                let directory = rootDirectory;\n                for (const part of parts) {\n                    try {\n                        directory = await directory.getDirectoryHandle(part);\n                    }\n                    catch {\n                        return false;\n                    }\n                }\n                return true;\n            }\n        },\n        readObject: async (path) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, false);\n            const file = await handle.getFile();\n            const text = await file.text();\n            return deserialize(text);\n        }),\n        writeObject: async (path, value) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, true);\n            const text = serialize(value);\n            if (typeof text !== 'string') {\n                throw new TypeError('serialize() must return a string');\n            }\n            const writableStream = await handle.createWritable();\n            try {\n                const encoded = new TextEncoder().encode(text);\n                await writableStream.write({ type: 'write', position: 0, data: encoded });\n                await writableStream.truncate(encoded.byteLength);\n                await writableStream.close();\n            }\n            catch (error) {\n                await writableStream.abort();\n                throw error;\n            }\n        }),\n        readIndexObject: async (path) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, false);\n            const file = await handle.getFile();\n            const text = await file.text();\n            return deserialize(text);\n        }),\n        writeIndexObject: async (path, value) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, true);\n            const text = serialize(value);\n            if (typeof text !== 'string') {\n                throw new TypeError('serialize() must return a string');\n            }\n            const writableStream = await handle.createWritable();\n            try {\n                const encoded = new TextEncoder().encode(text);\n                await writableStream.write({ type: 'write', position: 0, data: encoded });\n                await writableStream.truncate(encoded.byteLength);\n                await writableStream.close();\n            }\n            catch (error) {\n                await writableStream.abort();\n                throw error;\n            }\n        }),\n        listFilesRecursive: async (directoryPath) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const directoryHandle = await ensureDirectoryExists(rootDirectory, directoryPath, false);\n            const files = [];\n            // @ts-expect-error -- for-await-of on FileSystemDirectoryHandle is not in types yet\n            for await (const entry of directoryHandle.values()) {\n                if (entry.kind === 'file') {\n                    files.push(entry.name);\n                }\n                else if (entry.kind === 'directory') {\n                    const subFiles = await driver.listFilesRecursive(`${directoryPath}/${entry.name}`);\n                    files.push(...subFiles.map(f => `${entry.name}/${f}`));\n                }\n            }\n            return files;\n        },\n        removeEntry: async (path, removeOptions) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const pathParts = path.split('/').filter(Boolean);\n            const name = pathParts.pop();\n            if (!name)\n                throw new Error('Invalid path');\n            const parent = pathParts.length > 0\n                ? await ensureDirectoryExists(rootDirectory, pathParts.join('/'), false)\n                : rootDirectory;\n            await parent.removeEntry(name, { recursive: Boolean(removeOptions?.recursive) });\n        },\n    };\n    return createGenericFSAdapter(driver, folderName);\n}\n"],"names":["toSafeFilename","input","name","escapeRegex","withPathLock","path","fn","lockName","createOPFSAdapter","folderName","options","serialize","deserialize","ensureDirectoryExists","rootDirectory","directoryPath","createIfMissing","parts","current","part","getFileHandleForPath","fullPath","fileName","driver","serializeValue","id","key","directory","text","value","handle","writableStream","encoded","error","directoryHandle","files","entry","subFiles","f","removeOptions","pathParts","createGenericFSAdapter"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Driver } from '@signaldb/generic-fs'\nimport createGenericFSAdapter from '@signaldb/generic-fs'\nimport { serializeValue } from '@signaldb/core'\n\n/**\n * Convert an arbitrary filename into a OPFS safe filename.\n * @param input - The input filename to sanitize.\n * @returns A safe filename.\n */\nfunction toSafeFilename(input: string): string {\n  const replacement = '_'\n\n  let name = input.normalize('NFC')\n\n  const escapeRegex = (s: string) => s.replaceAll(/[-/\\\\^$*+?.()|[\\]{}]/g, String.raw`\\$&`)\n  name = name.replaceAll('/', replacement)\n  name = name.replaceAll(new RegExp(`${escapeRegex(replacement)}{2,}`, 'g'), replacement)\n\n  if (!name) name = 'unnamed'\n\n  return name\n}\n\n/**\n * Acquire a lock for a specific file path to ensure exclusive access during read/write operations.\n * @param path - The file path to lock.\n * @param fn - The asynchronous function to execute while holding the lock.\n * @returns The result of the function `fn`.\n */\nasync function withPathLock<T>(path: string, fn: () => Promise<T>): Promise<T> {\n  const lockName = `opfs:${path}`\n  // Use exclusive mode so reads cannot interleave with writes\n  return navigator.locks.request(lockName, { mode: 'exclusive' }, fn)\n}\n\n/**\n * Creates a persistence adapter for managing a SignalDB collection using the\n * Origin Private File System (OPFS). This adapter allows data to be stored and managed\n * directly in the browser's file system with support for customizable serialization\n * and deserialization.\n * @template T - The type of the items in the collection.\n * @template I - The type of the unique identifier for the items.\n * @param folderName - The name of the file in OPFS where data will be stored.\n * @param options - Optional configuration for serialization and deserialization.\n * @param options.serialize - A function to serialize items to a string (default: `JSON.stringify`).\n * @param options.deserialize - A function to deserialize a string into items (default: `JSON.parse`).\n * @returns A SignalDB persistence adapter for managing data in OPFS.\n * @example\n * import createOPFSAdapter from './createOPFSAdapter';\n * import { Collection } from '@signaldb/core';\n *\n * const adapter = createOPFSAdapter('myCollection.json', {\n *   serialize: (items) => JSON.stringify(items, null, 2), // Pretty-print JSON\n *   deserialize: (itemsString) => JSON.parse(itemsString), // Default JSON parse\n * });\n *\n * const collection = new Collection({\n *   persistence: adapter,\n * });\n *\n * // Perform operations on the collection, and changes will be reflected in the OPFS file.\n */\nexport default function createOPFSAdapter<\n  T extends { id: I } & Record<string, any>,\n  I,\n>(\n  folderName: string,\n  options?: {\n    serialize?: (data: any) => string,\n    deserialize?: (input: string) => any,\n  },\n) {\n  const {\n    serialize = JSON.stringify,\n    deserialize = JSON.parse,\n  } = options || {}\n\n  const ensureDirectoryExists = async (\n    rootDirectory: FileSystemDirectoryHandle,\n    directoryPath: string,\n    createIfMissing: boolean,\n  ) => {\n    const parts = directoryPath.split('/').filter(Boolean)\n    let current = rootDirectory\n    for (const part of parts) {\n      current = await current.getDirectoryHandle(part, { create: createIfMissing })\n    }\n    return current\n  }\n\n  const getFileHandleForPath = async (\n    rootDirectory: FileSystemDirectoryHandle,\n    fullPath: string,\n    createIfMissing: boolean,\n  ): Promise<FileSystemFileHandle> => {\n    const parts = fullPath.split('/').filter(Boolean)\n    const fileName = parts.pop() as string\n    const directoryHandle = await ensureDirectoryExists(rootDirectory, parts.join('/'), createIfMissing)\n    return directoryHandle.getFileHandle(fileName, { create: createIfMissing })\n  }\n\n  const driver: Driver<T, I> = {\n    fileNameForId: id => Promise.resolve(toSafeFilename(serializeValue(id) as string)),\n    fileNameForIndexKey: key => Promise.resolve(toSafeFilename(key)),\n    joinPath: (...parts) => Promise.resolve(parts.join('/')),\n    ensureDir: async (directoryPath) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      await ensureDirectoryExists(rootDirectory, directoryPath, true)\n    },\n\n    fileExists: async (path) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      try {\n        await getFileHandleForPath(rootDirectory, path, false)\n        return true\n      } catch {\n        const parts = path.split('/').filter(Boolean)\n        let directory = rootDirectory\n        for (const part of parts) {\n          try {\n            directory = await directory.getDirectoryHandle(part)\n          } catch {\n            return false\n          }\n        }\n        return true\n      }\n    },\n\n    readObject: async path => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, false)\n      const file = await handle.getFile()\n      const text = await file.text()\n      return deserialize(text)\n    }),\n\n    writeObject: async (path, value) => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, true)\n      const text = serialize(value)\n      if (typeof text !== 'string') {\n        throw new TypeError('serialize() must return a string')\n      }\n      const writableStream = await handle.createWritable()\n      try {\n        const encoded = new TextEncoder().encode(text)\n        await writableStream.write({ type: 'write', position: 0, data: encoded })\n        await writableStream.truncate(encoded.byteLength)\n        await writableStream.close()\n      } catch (error) {\n        await writableStream.abort()\n        throw error\n      }\n    }),\n\n    readIndexObject: async path => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, false)\n      const file = await handle.getFile()\n      const text = await file.text()\n      return deserialize(text)\n    }),\n\n    writeIndexObject: async (path, value) => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, true)\n      const text = serialize(value)\n      if (typeof text !== 'string') {\n        throw new TypeError('serialize() must return a string')\n      }\n      const writableStream = await handle.createWritable()\n      try {\n        const encoded = new TextEncoder().encode(text)\n        await writableStream.write({ type: 'write', position: 0, data: encoded })\n        await writableStream.truncate(encoded.byteLength)\n        await writableStream.close()\n      } catch (error) {\n        await writableStream.abort()\n        throw error\n      }\n    }),\n\n    listFilesRecursive: async (directoryPath) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const directoryHandle = await ensureDirectoryExists(rootDirectory, directoryPath, false)\n\n      const files: string[] = []\n      // @ts-expect-error -- for-await-of on FileSystemDirectoryHandle is not in types yet\n      for await (const entry of directoryHandle.values()) {\n        if (entry.kind === 'file') {\n          files.push(entry.name as string)\n        } else if (entry.kind === 'directory') {\n          const subFiles = await driver.listFilesRecursive(`${directoryPath}/${entry.name}`)\n          files.push(...subFiles.map(f => `${entry.name}/${f}`))\n        }\n      }\n      return files\n    },\n\n    removeEntry: async (path, removeOptions) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const pathParts = path.split('/').filter(Boolean)\n      const name = pathParts.pop()\n      if (!name) throw new Error('Invalid path')\n      const parent = pathParts.length > 0\n        ? await ensureDirectoryExists(rootDirectory, pathParts.join('/'), false)\n        : rootDirectory\n      await parent.removeEntry(name, { recursive: Boolean(removeOptions?.recursive) })\n    },\n  }\n  return createGenericFSAdapter<T, I>(driver, folderName)\n}\n"],"mappings":"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"}

package/dist/index.umd.js

@@ -1,2 +1,2 @@
-(function(c,w){typeof exports=="object"&&typeof module<"u"?module.exports=w(require("@signaldb/generic-fs"),require("@signaldb/core")):typeof define=="function"&&define.amd?define(["@signaldb/generic-fs","@signaldb/core"],w):(c=typeof globalThis<"u"?globalThis:c||self,c.SignalDB=w(c.createGenericFSAdapter,c.core))})(this,(function(c,w){"use strict";function p(y){let i=y.normalize("NFC");const g=l=>l.replaceAll(/[-/\\^$*+?.()|[\]{}]/g,String.raw`\$&`);return i=i.replaceAll("/","_"),i=i.replaceAll(new RegExp(`${g("_")}{2,}`,"g"),"_"),i||(i="unnamed"),i}async function f(y,u){const i=`opfs:${y}`;return navigator.locks.request(i,{mode:"exclusive"},u)}function h(y,u){const{serialize:i=JSON.stringify,deserialize:g=JSON.parse}=u||{},l=async(e,a,n)=>{const r=a.split("/").filter(Boolean);let t=e;for(const o of r)t=await t.getDirectoryHandle(o,{create:n});return t},d=async(e,a,n)=>{const r=a.split("/").filter(Boolean),t=r.pop();return(await l(e,r.join("/"),n)).getFileHandle(t,{create:n})},m={fileNameForId:e=>Promise.resolve(p(w.serializeValue(e))),fileNameForIndexKey:e=>Promise.resolve(p(e)),joinPath:(...e)=>Promise.resolve(e.join("/")),ensureDir:async e=>{const a=await navigator.storage.getDirectory();await l(a,e,!0)},fileExists:async e=>{const a=await navigator.storage.getDirectory();try{return await d(a,e,!1),!0}catch{const n=e.split("/").filter(Boolean);let r=a;for(const t of n)try{r=await r.getDirectoryHandle(t)}catch{return!1}return!0}},readObject:async e=>f(e,async()=>{const a=await navigator.storage.getDirectory(),t=await(await(await d(a,e,!1)).getFile()).text();return g(t)}),writeObject:async(e,a)=>f(e,async()=>{const n=await navigator.storage.getDirectory(),r=await d(n,e,!0),t=i(a);if(typeof t!="string")throw new TypeError("serialize() must return a string");const o=await r.createWritable();try{const s=new TextEncoder().encode(t);await o.write({type:"write",position:0,data:s}),await o.truncate(s.byteLength),await o.close()}catch(s){throw await o.abort(),s}}),readIndexObject:async e=>f(e,async()=>{const a=await navigator.storage.getDirectory(),t=await(await(await d(a,e,!1)).getFile()).text();return g(t)}),writeIndexObject:async(e,a)=>f(e,async()=>{const n=await navigator.storage.getDirectory(),r=await d(n,e,!0),t=i(a);if(typeof t!="string")throw new TypeError("serialize() must return a string");const o=await r.createWritable();try{const s=new TextEncoder().encode(t);await o.write({type:"write",position:0,data:s}),await o.truncate(s.byteLength),await o.close()}catch(s){throw await o.abort(),s}}),listFilesRecursive:async e=>{const a=await navigator.storage.getDirectory(),n=await l(a,e,!1),r=[];for await(const t of n.values())if(t.kind==="file")r.push(t.name);else if(t.kind==="directory"){const o=await m.listFilesRecursive(`${e}/${t.name}`);r.push(...o.map(s=>`${t.name}/${s}`))}return r},removeEntry:async(e,a)=>{const n=await navigator.storage.getDirectory(),r=e.split("/").filter(Boolean),t=r.pop();if(!t)throw new Error("Invalid path");await(r.length>0?await l(n,r.join("/"),!1):n).removeEntry(t,{recursive:!!a?.recursive})}};return c(m,y)}return h}));
-//# sourceMappingURL=index.umd.js.map
+(function(e,t){typeof exports==`object`&&typeof module<`u`?module.exports=t(require("@signaldb/generic-fs"),require("@signaldb/core")):typeof define==`function`&&define.amd?define([`@signaldb/generic-fs`,`@signaldb/core`],t):(e=typeof globalThis<`u`?globalThis:e||self,e.SignalDB=t(e._signaldb_generic_fs,e._signaldb_core))})(this,function(e,t){var n=Object.create,r=Object.defineProperty,i=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,o=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,c=(e,t,n,o)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=a(t),l=0,u=c.length,d;l<u;l++)d=c[l],!s.call(e,d)&&d!==n&&r(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(o=i(t,d))||o.enumerable});return e};e=((e,t,i)=>(i=e==null?{}:n(o(e)),c(t||!e||!e.__esModule?r(i,`default`,{value:e,enumerable:!0}):i,e)))(e);function l(e){let t=e.normalize(`NFC`);return t=t.replaceAll(`/`,`_`),t=t.replaceAll(RegExp(`${(e=>e.replaceAll(/[-/\\^$*+?.()|[\]{}]/g,String.raw`\$&`))(`_`)}{2,}`,`g`),`_`),t||=`unnamed`,t}async function u(e,t){let n=`opfs:${e}`;return navigator.locks.request(n,{mode:`exclusive`},t)}function d(n,r){let{serialize:i=JSON.stringify,deserialize:a=JSON.parse}=r||{},o=async(e,t,n)=>{let r=t.split(`/`).filter(Boolean),i=e;for(let e of r)i=await i.getDirectoryHandle(e,{create:n});return i},s=async(e,t,n)=>{let r=t.split(`/`).filter(Boolean),i=r.pop();return(await o(e,r.join(`/`),n)).getFileHandle(i,{create:n})},c={fileNameForId:e=>Promise.resolve(l((0,t.serializeValue)(e))),fileNameForIndexKey:e=>Promise.resolve(l(e)),joinPath:(...e)=>Promise.resolve(e.join(`/`)),ensureDir:async e=>{await o(await navigator.storage.getDirectory(),e,!0)},fileExists:async e=>{let t=await navigator.storage.getDirectory();try{return await s(t,e,!1),!0}catch{let n=e.split(`/`).filter(Boolean),r=t;for(let e of n)try{r=await r.getDirectoryHandle(e)}catch{return!1}return!0}},readObject:async e=>u(e,async()=>a(await(await(await s(await navigator.storage.getDirectory(),e,!1)).getFile()).text())),writeObject:async(e,t)=>u(e,async()=>{let n=await s(await navigator.storage.getDirectory(),e,!0),r=i(t);if(typeof r!=`string`)throw TypeError(`serialize() must return a string`);let a=await n.createWritable();try{let e=new TextEncoder().encode(r);await a.write({type:`write`,position:0,data:e}),await a.truncate(e.byteLength),await a.close()}catch(e){throw await a.abort(),e}}),readIndexObject:async e=>u(e,async()=>a(await(await(await s(await navigator.storage.getDirectory(),e,!1)).getFile()).text())),writeIndexObject:async(e,t)=>u(e,async()=>{let n=await s(await navigator.storage.getDirectory(),e,!0),r=i(t);if(typeof r!=`string`)throw TypeError(`serialize() must return a string`);let a=await n.createWritable();try{let e=new TextEncoder().encode(r);await a.write({type:`write`,position:0,data:e}),await a.truncate(e.byteLength),await a.close()}catch(e){throw await a.abort(),e}}),listFilesRecursive:async e=>{let t=await o(await navigator.storage.getDirectory(),e,!1),n=[];for await(let r of t.values())if(r.kind===`file`)n.push(r.name);else if(r.kind===`directory`){let t=await c.listFilesRecursive(`${e}/${r.name}`);n.push(...t.map(e=>`${r.name}/${e}`))}return n},removeEntry:async(e,t)=>{let n=await navigator.storage.getDirectory(),r=e.split(`/`).filter(Boolean),i=r.pop();if(!i)throw Error(`Invalid path`);await(r.length>0?await o(n,r.join(`/`),!1):n).removeEntry(i,{recursive:!!t?.recursive})}};return(0,e.default)(c,n)}return d});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","sources":["../src/index.ts"],"sourcesContent":["import createGenericFSAdapter from '@signaldb/generic-fs';\nimport { serializeValue } from '@signaldb/core';\n/**\n * Convert an arbitrary filename into a OPFS safe filename.\n * @param input - The input filename to sanitize.\n * @returns A safe filename.\n */\nfunction toSafeFilename(input) {\n    const replacement = '_';\n    let name = input.normalize('NFC');\n    const escapeRegex = (s) => s.replaceAll(/[-/\\\\^$*+?.()|[\\]{}]/g, String.raw `\\$&`);\n    name = name.replaceAll('/', replacement);\n    name = name.replaceAll(new RegExp(`${escapeRegex(replacement)}{2,}`, 'g'), replacement);\n    if (!name)\n        name = 'unnamed';\n    return name;\n}\n/**\n * Acquire a lock for a specific file path to ensure exclusive access during read/write operations.\n * @param path - The file path to lock.\n * @param fn - The asynchronous function to execute while holding the lock.\n * @returns The result of the function `fn`.\n */\nasync function withPathLock(path, fn) {\n    const lockName = `opfs:${path}`;\n    // Use exclusive mode so reads cannot interleave with writes\n    return navigator.locks.request(lockName, { mode: 'exclusive' }, fn);\n}\n/**\n * Creates a persistence adapter for managing a SignalDB collection using the\n * Origin Private File System (OPFS). This adapter allows data to be stored and managed\n * directly in the browser's file system with support for customizable serialization\n * and deserialization.\n * @template T - The type of the items in the collection.\n * @template I - The type of the unique identifier for the items.\n * @param folderName - The name of the file in OPFS where data will be stored.\n * @param options - Optional configuration for serialization and deserialization.\n * @param options.serialize - A function to serialize items to a string (default: `JSON.stringify`).\n * @param options.deserialize - A function to deserialize a string into items (default: `JSON.parse`).\n * @returns A SignalDB persistence adapter for managing data in OPFS.\n * @example\n * import createOPFSAdapter from './createOPFSAdapter';\n * import { Collection } from '@signaldb/core';\n *\n * const adapter = createOPFSAdapter('myCollection.json', {\n *   serialize: (items) => JSON.stringify(items, null, 2), // Pretty-print JSON\n *   deserialize: (itemsString) => JSON.parse(itemsString), // Default JSON parse\n * });\n *\n * const collection = new Collection({\n *   persistence: adapter,\n * });\n *\n * // Perform operations on the collection, and changes will be reflected in the OPFS file.\n */\nexport default function createOPFSAdapter(folderName, options) {\n    const { serialize = JSON.stringify, deserialize = JSON.parse, } = options || {};\n    const ensureDirectoryExists = async (rootDirectory, directoryPath, createIfMissing) => {\n        const parts = directoryPath.split('/').filter(Boolean);\n        let current = rootDirectory;\n        for (const part of parts) {\n            current = await current.getDirectoryHandle(part, { create: createIfMissing });\n        }\n        return current;\n    };\n    const getFileHandleForPath = async (rootDirectory, fullPath, createIfMissing) => {\n        const parts = fullPath.split('/').filter(Boolean);\n        const fileName = parts.pop();\n        const directoryHandle = await ensureDirectoryExists(rootDirectory, parts.join('/'), createIfMissing);\n        return directoryHandle.getFileHandle(fileName, { create: createIfMissing });\n    };\n    const driver = {\n        fileNameForId: id => Promise.resolve(toSafeFilename(serializeValue(id))),\n        fileNameForIndexKey: key => Promise.resolve(toSafeFilename(key)),\n        joinPath: (...parts) => Promise.resolve(parts.join('/')),\n        ensureDir: async (directoryPath) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            await ensureDirectoryExists(rootDirectory, directoryPath, true);\n        },\n        fileExists: async (path) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            try {\n                await getFileHandleForPath(rootDirectory, path, false);\n                return true;\n            }\n            catch {\n                const parts = path.split('/').filter(Boolean);\n                let directory = rootDirectory;\n                for (const part of parts) {\n                    try {\n                        directory = await directory.getDirectoryHandle(part);\n                    }\n                    catch {\n                        return false;\n                    }\n                }\n                return true;\n            }\n        },\n        readObject: async (path) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, false);\n            const file = await handle.getFile();\n            const text = await file.text();\n            return deserialize(text);\n        }),\n        writeObject: async (path, value) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, true);\n            const text = serialize(value);\n            if (typeof text !== 'string') {\n                throw new TypeError('serialize() must return a string');\n            }\n            const writableStream = await handle.createWritable();\n            try {\n                const encoded = new TextEncoder().encode(text);\n                await writableStream.write({ type: 'write', position: 0, data: encoded });\n                await writableStream.truncate(encoded.byteLength);\n                await writableStream.close();\n            }\n            catch (error) {\n                await writableStream.abort();\n                throw error;\n            }\n        }),\n        readIndexObject: async (path) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, false);\n            const file = await handle.getFile();\n            const text = await file.text();\n            return deserialize(text);\n        }),\n        writeIndexObject: async (path, value) => withPathLock(path, async () => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const handle = await getFileHandleForPath(rootDirectory, path, true);\n            const text = serialize(value);\n            if (typeof text !== 'string') {\n                throw new TypeError('serialize() must return a string');\n            }\n            const writableStream = await handle.createWritable();\n            try {\n                const encoded = new TextEncoder().encode(text);\n                await writableStream.write({ type: 'write', position: 0, data: encoded });\n                await writableStream.truncate(encoded.byteLength);\n                await writableStream.close();\n            }\n            catch (error) {\n                await writableStream.abort();\n                throw error;\n            }\n        }),\n        listFilesRecursive: async (directoryPath) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const directoryHandle = await ensureDirectoryExists(rootDirectory, directoryPath, false);\n            const files = [];\n            // @ts-expect-error -- for-await-of on FileSystemDirectoryHandle is not in types yet\n            for await (const entry of directoryHandle.values()) {\n                if (entry.kind === 'file') {\n                    files.push(entry.name);\n                }\n                else if (entry.kind === 'directory') {\n                    const subFiles = await driver.listFilesRecursive(`${directoryPath}/${entry.name}`);\n                    files.push(...subFiles.map(f => `${entry.name}/${f}`));\n                }\n            }\n            return files;\n        },\n        removeEntry: async (path, removeOptions) => {\n            const rootDirectory = await navigator.storage.getDirectory();\n            const pathParts = path.split('/').filter(Boolean);\n            const name = pathParts.pop();\n            if (!name)\n                throw new Error('Invalid path');\n            const parent = pathParts.length > 0\n                ? await ensureDirectoryExists(rootDirectory, pathParts.join('/'), false)\n                : rootDirectory;\n            await parent.removeEntry(name, { recursive: Boolean(removeOptions?.recursive) });\n        },\n    };\n    return createGenericFSAdapter(driver, folderName);\n}\n"],"names":["toSafeFilename","input","name","escapeRegex","s","withPathLock","path","fn","lockName","createOPFSAdapter","folderName","options","serialize","deserialize","ensureDirectoryExists","rootDirectory","directoryPath","createIfMissing","parts","current","part","getFileHandleForPath","fullPath","fileName","driver","serializeValue","id","key","directory","text","value","handle","writableStream","encoded","error","directoryHandle","files","entry","subFiles","f","removeOptions","pathParts","createGenericFSAdapter"],"mappings":"+VAOA,SAASA,EAAeC,EAAO,CAE3B,IAAIC,EAAOD,EAAM,UAAU,KAAK,EAChC,MAAME,EAAeC,GAAMA,EAAE,WAAW,wBAAyB,OAAO,QAAS,EACjF,OAAAF,EAAOA,EAAK,WAAW,IAAK,GAAW,EACvCA,EAAOA,EAAK,WAAW,IAAI,OAAO,GAAGC,EAAY,GAAW,CAAC,OAAQ,GAAG,EAAG,GAAW,EACjFD,IACDA,EAAO,WACJA,CACX,CAOA,eAAeG,EAAaC,EAAMC,EAAI,CAClC,MAAMC,EAAW,QAAQF,CAAI,GAE7B,OAAO,UAAU,MAAM,QAAQE,EAAU,CAAE,KAAM,WAAA,EAAeD,CAAE,CACtE,CA4BA,SAAwBE,EAAkBC,EAAYC,EAAS,CAC3D,KAAM,CAAE,UAAAC,EAAY,KAAK,UAAW,YAAAC,EAAc,KAAK,OAAWF,GAAW,CAAA,EACvEG,EAAwB,MAAOC,EAAeC,EAAeC,IAAoB,CACnF,MAAMC,EAAQF,EAAc,MAAM,GAAG,EAAE,OAAO,OAAO,EACrD,IAAIG,EAAUJ,EACd,UAAWK,KAAQF,EACfC,EAAU,MAAMA,EAAQ,mBAAmBC,EAAM,CAAE,OAAQH,EAAiB,EAEhF,OAAOE,CACX,EACME,EAAuB,MAAON,EAAeO,EAAUL,IAAoB,CAC7E,MAAMC,EAAQI,EAAS,MAAM,GAAG,EAAE,OAAO,OAAO,EAC1CC,EAAWL,EAAM,IAAA,EAEvB,OADwB,MAAMJ,EAAsBC,EAAeG,EAAM,KAAK,GAAG,EAAGD,CAAe,GAC5E,cAAcM,EAAU,CAAE,OAAQN,EAAiB,CAC9E,EACMO,EAAS,CACX,iBAAqB,QAAQ,QAAQxB,EAAeyB,EAAAA,eAAeC,CAAE,CAAC,CAAC,EACvE,oBAAqBC,GAAO,QAAQ,QAAQ3B,EAAe2B,CAAG,CAAC,EAC/D,SAAU,IAAIT,IAAU,QAAQ,QAAQA,EAAM,KAAK,GAAG,CAAC,EACvD,UAAW,MAAOF,GAAkB,CAChC,MAAMD,EAAgB,MAAM,UAAU,QAAQ,aAAA,EAC9C,MAAMD,EAAsBC,EAAeC,EAAe,EAAI,CAClE,EACA,WAAY,MAAOV,GAAS,CACxB,MAAMS,EAAgB,MAAM,UAAU,QAAQ,aAAA,EAC9C,GAAI,CACA,aAAMM,EAAqBN,EAAeT,EAAM,EAAK,EAC9C,EACX,MACM,CACF,MAAMY,EAAQZ,EAAK,MAAM,GAAG,EAAE,OAAO,OAAO,EAC5C,IAAIsB,EAAYb,EAChB,UAAWK,KAAQF,EACf,GAAI,CACAU,EAAY,MAAMA,EAAU,mBAAmBR,CAAI,CACvD,MACM,CACF,MAAO,EACX,CAEJ,MAAO,EACX,CACJ,EACA,WAAY,MAAOd,GAASD,EAAaC,EAAM,SAAY,CACvD,MAAMS,EAAgB,MAAM,UAAU,QAAQ,aAAA,EAGxCc,EAAO,MADA,MADE,MAAMR,EAAqBN,EAAeT,EAAM,EAAK,GAC1C,QAAA,GACF,KAAA,EACxB,OAAOO,EAAYgB,CAAI,CAC3B,CAAC,EACD,YAAa,MAAOvB,EAAMwB,IAAUzB,EAAaC,EAAM,SAAY,CAC/D,MAAMS,EAAgB,MAAM,UAAU,QAAQ,aAAA,EACxCgB,EAAS,MAAMV,EAAqBN,EAAeT,EAAM,EAAI,EAC7DuB,EAAOjB,EAAUkB,CAAK,EAC5B,GAAI,OAAOD,GAAS,SAChB,MAAM,IAAI,UAAU,kCAAkC,EAE1D,MAAMG,EAAiB,MAAMD,EAAO,eAAA,EACpC,GAAI,CACA,MAAME,EAAU,IAAI,cAAc,OAAOJ,CAAI,EAC7C,MAAMG,EAAe,MAAM,CAAE,KAAM,QAAS,SAAU,EAAG,KAAMC,EAAS,EACxE,MAAMD,EAAe,SAASC,EAAQ,UAAU,EAChD,MAAMD,EAAe,MAAA,CACzB,OACOE,EAAO,CACV,YAAMF,EAAe,MAAA,EACfE,CACV,CACJ,CAAC,EACD,gBAAiB,MAAO5B,GAASD,EAAaC,EAAM,SAAY,CAC5D,MAAMS,EAAgB,MAAM,UAAU,QAAQ,aAAA,EAGxCc,EAAO,MADA,MADE,MAAMR,EAAqBN,EAAeT,EAAM,EAAK,GAC1C,QAAA,GACF,KAAA,EACxB,OAAOO,EAAYgB,CAAI,CAC3B,CAAC,EACD,iBAAkB,MAAOvB,EAAMwB,IAAUzB,EAAaC,EAAM,SAAY,CACpE,MAAMS,EAAgB,MAAM,UAAU,QAAQ,aAAA,EACxCgB,EAAS,MAAMV,EAAqBN,EAAeT,EAAM,EAAI,EAC7DuB,EAAOjB,EAAUkB,CAAK,EAC5B,GAAI,OAAOD,GAAS,SAChB,MAAM,IAAI,UAAU,kCAAkC,EAE1D,MAAMG,EAAiB,MAAMD,EAAO,eAAA,EACpC,GAAI,CACA,MAAME,EAAU,IAAI,cAAc,OAAOJ,CAAI,EAC7C,MAAMG,EAAe,MAAM,CAAE,KAAM,QAAS,SAAU,EAAG,KAAMC,EAAS,EACxE,MAAMD,EAAe,SAASC,EAAQ,UAAU,EAChD,MAAMD,EAAe,MAAA,CACzB,OACOE,EAAO,CACV,YAAMF,EAAe,MAAA,EACfE,CACV,CACJ,CAAC,EACD,mBAAoB,MAAOlB,GAAkB,CACzC,MAAMD,EAAgB,MAAM,UAAU,QAAQ,aAAA,EACxCoB,EAAkB,MAAMrB,EAAsBC,EAAeC,EAAe,EAAK,EACjFoB,EAAQ,CAAA,EAEd,gBAAiBC,KAASF,EAAgB,SACtC,GAAIE,EAAM,OAAS,OACfD,EAAM,KAAKC,EAAM,IAAI,UAEhBA,EAAM,OAAS,YAAa,CACjC,MAAMC,EAAW,MAAMd,EAAO,mBAAmB,GAAGR,CAAa,IAAIqB,EAAM,IAAI,EAAE,EACjFD,EAAM,KAAK,GAAGE,EAAS,IAAIC,GAAK,GAAGF,EAAM,IAAI,IAAIE,CAAC,EAAE,CAAC,CACzD,CAEJ,OAAOH,CACX,EACA,YAAa,MAAO9B,EAAMkC,IAAkB,CACxC,MAAMzB,EAAgB,MAAM,UAAU,QAAQ,aAAA,EACxC0B,EAAYnC,EAAK,MAAM,GAAG,EAAE,OAAO,OAAO,EAC1CJ,EAAOuC,EAAU,IAAA,EACvB,GAAI,CAACvC,EACD,MAAM,IAAI,MAAM,cAAc,EAIlC,MAHeuC,EAAU,OAAS,EAC5B,MAAM3B,EAAsBC,EAAe0B,EAAU,KAAK,GAAG,EAAG,EAAK,EACrE1B,GACO,YAAYb,EAAM,CAAE,UAAW,EAAQsC,GAAe,UAAY,CACnF,CAAA,EAEJ,OAAOE,EAAuBlB,EAAQd,CAAU,CACpD"}
+{"version":3,"file":"index.umd.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Driver } from '@signaldb/generic-fs'\nimport createGenericFSAdapter from '@signaldb/generic-fs'\nimport { serializeValue } from '@signaldb/core'\n\n/**\n * Convert an arbitrary filename into a OPFS safe filename.\n * @param input - The input filename to sanitize.\n * @returns A safe filename.\n */\nfunction toSafeFilename(input: string): string {\n  const replacement = '_'\n\n  let name = input.normalize('NFC')\n\n  const escapeRegex = (s: string) => s.replaceAll(/[-/\\\\^$*+?.()|[\\]{}]/g, String.raw`\\$&`)\n  name = name.replaceAll('/', replacement)\n  name = name.replaceAll(new RegExp(`${escapeRegex(replacement)}{2,}`, 'g'), replacement)\n\n  if (!name) name = 'unnamed'\n\n  return name\n}\n\n/**\n * Acquire a lock for a specific file path to ensure exclusive access during read/write operations.\n * @param path - The file path to lock.\n * @param fn - The asynchronous function to execute while holding the lock.\n * @returns The result of the function `fn`.\n */\nasync function withPathLock<T>(path: string, fn: () => Promise<T>): Promise<T> {\n  const lockName = `opfs:${path}`\n  // Use exclusive mode so reads cannot interleave with writes\n  return navigator.locks.request(lockName, { mode: 'exclusive' }, fn)\n}\n\n/**\n * Creates a persistence adapter for managing a SignalDB collection using the\n * Origin Private File System (OPFS). This adapter allows data to be stored and managed\n * directly in the browser's file system with support for customizable serialization\n * and deserialization.\n * @template T - The type of the items in the collection.\n * @template I - The type of the unique identifier for the items.\n * @param folderName - The name of the file in OPFS where data will be stored.\n * @param options - Optional configuration for serialization and deserialization.\n * @param options.serialize - A function to serialize items to a string (default: `JSON.stringify`).\n * @param options.deserialize - A function to deserialize a string into items (default: `JSON.parse`).\n * @returns A SignalDB persistence adapter for managing data in OPFS.\n * @example\n * import createOPFSAdapter from './createOPFSAdapter';\n * import { Collection } from '@signaldb/core';\n *\n * const adapter = createOPFSAdapter('myCollection.json', {\n *   serialize: (items) => JSON.stringify(items, null, 2), // Pretty-print JSON\n *   deserialize: (itemsString) => JSON.parse(itemsString), // Default JSON parse\n * });\n *\n * const collection = new Collection({\n *   persistence: adapter,\n * });\n *\n * // Perform operations on the collection, and changes will be reflected in the OPFS file.\n */\nexport default function createOPFSAdapter<\n  T extends { id: I } & Record<string, any>,\n  I,\n>(\n  folderName: string,\n  options?: {\n    serialize?: (data: any) => string,\n    deserialize?: (input: string) => any,\n  },\n) {\n  const {\n    serialize = JSON.stringify,\n    deserialize = JSON.parse,\n  } = options || {}\n\n  const ensureDirectoryExists = async (\n    rootDirectory: FileSystemDirectoryHandle,\n    directoryPath: string,\n    createIfMissing: boolean,\n  ) => {\n    const parts = directoryPath.split('/').filter(Boolean)\n    let current = rootDirectory\n    for (const part of parts) {\n      current = await current.getDirectoryHandle(part, { create: createIfMissing })\n    }\n    return current\n  }\n\n  const getFileHandleForPath = async (\n    rootDirectory: FileSystemDirectoryHandle,\n    fullPath: string,\n    createIfMissing: boolean,\n  ): Promise<FileSystemFileHandle> => {\n    const parts = fullPath.split('/').filter(Boolean)\n    const fileName = parts.pop() as string\n    const directoryHandle = await ensureDirectoryExists(rootDirectory, parts.join('/'), createIfMissing)\n    return directoryHandle.getFileHandle(fileName, { create: createIfMissing })\n  }\n\n  const driver: Driver<T, I> = {\n    fileNameForId: id => Promise.resolve(toSafeFilename(serializeValue(id) as string)),\n    fileNameForIndexKey: key => Promise.resolve(toSafeFilename(key)),\n    joinPath: (...parts) => Promise.resolve(parts.join('/')),\n    ensureDir: async (directoryPath) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      await ensureDirectoryExists(rootDirectory, directoryPath, true)\n    },\n\n    fileExists: async (path) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      try {\n        await getFileHandleForPath(rootDirectory, path, false)\n        return true\n      } catch {\n        const parts = path.split('/').filter(Boolean)\n        let directory = rootDirectory\n        for (const part of parts) {\n          try {\n            directory = await directory.getDirectoryHandle(part)\n          } catch {\n            return false\n          }\n        }\n        return true\n      }\n    },\n\n    readObject: async path => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, false)\n      const file = await handle.getFile()\n      const text = await file.text()\n      return deserialize(text)\n    }),\n\n    writeObject: async (path, value) => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, true)\n      const text = serialize(value)\n      if (typeof text !== 'string') {\n        throw new TypeError('serialize() must return a string')\n      }\n      const writableStream = await handle.createWritable()\n      try {\n        const encoded = new TextEncoder().encode(text)\n        await writableStream.write({ type: 'write', position: 0, data: encoded })\n        await writableStream.truncate(encoded.byteLength)\n        await writableStream.close()\n      } catch (error) {\n        await writableStream.abort()\n        throw error\n      }\n    }),\n\n    readIndexObject: async path => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, false)\n      const file = await handle.getFile()\n      const text = await file.text()\n      return deserialize(text)\n    }),\n\n    writeIndexObject: async (path, value) => withPathLock(path, async () => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const handle = await getFileHandleForPath(rootDirectory, path, true)\n      const text = serialize(value)\n      if (typeof text !== 'string') {\n        throw new TypeError('serialize() must return a string')\n      }\n      const writableStream = await handle.createWritable()\n      try {\n        const encoded = new TextEncoder().encode(text)\n        await writableStream.write({ type: 'write', position: 0, data: encoded })\n        await writableStream.truncate(encoded.byteLength)\n        await writableStream.close()\n      } catch (error) {\n        await writableStream.abort()\n        throw error\n      }\n    }),\n\n    listFilesRecursive: async (directoryPath) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const directoryHandle = await ensureDirectoryExists(rootDirectory, directoryPath, false)\n\n      const files: string[] = []\n      // @ts-expect-error -- for-await-of on FileSystemDirectoryHandle is not in types yet\n      for await (const entry of directoryHandle.values()) {\n        if (entry.kind === 'file') {\n          files.push(entry.name as string)\n        } else if (entry.kind === 'directory') {\n          const subFiles = await driver.listFilesRecursive(`${directoryPath}/${entry.name}`)\n          files.push(...subFiles.map(f => `${entry.name}/${f}`))\n        }\n      }\n      return files\n    },\n\n    removeEntry: async (path, removeOptions) => {\n      const rootDirectory = await navigator.storage.getDirectory()\n      const pathParts = path.split('/').filter(Boolean)\n      const name = pathParts.pop()\n      if (!name) throw new Error('Invalid path')\n      const parent = pathParts.length > 0\n        ? await ensureDirectoryExists(rootDirectory, pathParts.join('/'), false)\n        : rootDirectory\n      await parent.removeEntry(name, { recursive: Boolean(removeOptions?.recursive) })\n    },\n  }\n  return createGenericFSAdapter<T, I>(driver, folderName)\n}\n"],"mappings":"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"}

package/dist/storage-adapters/generic-fs/src/deltaHelpers.d.ts

@@ -0,0 +1,55 @@
+export type IndexDelta<I> = {
+    adds: Map<string, Set<I>>;
+    removes: Map<string, Set<I>>;
+};
+/**
+ * Records a single index mutation into the delta map for a given indexed field.
+ *
+ * The delta map is grouped by `fieldPath`, and then by stringified key (`rawKey`).
+ * Each key maps to a set of identifiers to add/remove for that key.
+ * @param deltas - Accumulator of per-field index deltas.
+ * @param fieldPath - Dot-path of the indexed field (used as the delta bucket key).
+ * @param changeKind - Whether this identifier should be added to or removed from the index key.
+ * @param rawKey - The stringified index key value.
+ * @param identifier - The item identifier to add/remove for `rawKey`.
+ */
+export declare function addToDelta<I>(deltas: Map<string, IndexDelta<I>>, fieldPath: string, changeKind: 'add' | 'remove', rawKey: string, identifier: I): void;
+/**
+ * Computes the delta for a change in a single indexed field.
+ *
+ * Values are coerced to string keys (with `null`/`undefined` treated as "no key").
+ * If the derived keys are equal, no delta is recorded.
+ * @param deltas - Accumulator of per-field index deltas.
+ * @param fieldPath - Dot-path of the indexed field being tracked.
+ * @param oldValue - Previous value of the field.
+ * @param newValue - Next value of the field.
+ * @param identifier - The item identifier affected by the change.
+ */
+export declare function addDeltaForChange<I>(deltas: Map<string, IndexDelta<I>>, fieldPath: string, oldValue: any, newValue: any, identifier: I): void;
+/**
+ * Accumulates index deltas for an upsert operation.
+ *
+ * - If `existingItem` is present, compares each maintained index field between the old and new item,
+ *   recording removes/adds for key changes.
+ * - If `existingItem` is absent, treats the operation as an insert and records adds for each
+ *   maintained index field that has a non-null value.
+ * @param deltas - Accumulator of per-field index deltas.
+ * @param indicesToMaintain - List of dot-paths for fields that are indexed.
+ * @param existingItem - Previous stored item (if any).
+ * @param nextItem - Incoming item to upsert.
+ */
+export declare const accumulateUpsertDelta: <T extends {
+    id: I;
+}, I>(deltas: Map<string, IndexDelta<I>>, indicesToMaintain: string[], existingItem: T | undefined, nextItem: T) => void;
+/**
+ * Accumulates index deltas for a remove/delete operation.
+ *
+ * For each maintained index field, records a removal of the item's identifier from the
+ * corresponding stringified key (skipping `null`/`undefined` values).
+ * @param deltas - Accumulator of per-field index deltas.
+ * @param indicesToMaintain - List of dot-paths for fields that are indexed.
+ * @param existingItem - The item being removed.
+ */
+export declare function accumulateRemoveDelta<T extends {
+    id: I;
+}, I>(deltas: Map<string, IndexDelta<I>>, indicesToMaintain: string[], existingItem: T): void;