@livestore/utils 0.4.0-dev.18 → 0.4.0-dev.19

package/dist/browser/Opfs/Opfs.d.ts

@@ -0,0 +1,51 @@
+import { Effect, Option, Schema, Stream } from 'effect';
+import * as WebError from '../WebError.ts';
+declare const Opfs_base: Effect.Service.Class<Opfs, "@livestore/utils/Opfs", {
+    readonly sync: () => {
+        readonly getRootDirectoryHandle: Effect.Effect<FileSystemDirectoryHandle, WebError.SecurityError | WebError.UnknownError, never>;
+        readonly getFileHandle: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemGetFileOptions) => Effect.Effect<FileSystemFileHandle, WebError.TypeError | WebError.NotFoundError | WebError.NotAllowedError | WebError.TypeMismatchError | WebError.UnknownError, never>;
+        readonly getDirectoryHandle: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemGetDirectoryOptions) => Effect.Effect<FileSystemDirectoryHandle, WebError.TypeError | WebError.NotFoundError | WebError.NotAllowedError | WebError.TypeMismatchError | WebError.UnknownError, never>;
+        readonly removeEntry: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemRemoveOptions) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.InvalidModificationError | WebError.UnknownError, never>;
+        readonly values: (directory: FileSystemDirectoryHandle) => Stream.Stream<FileSystemDirectoryHandle | FileSystemFileHandle, WebError.NotFoundError | WebError.NotAllowedError | WebError.UnknownError, never>;
+        readonly resolve: (parent: FileSystemDirectoryHandle, child: FileSystemHandle) => Effect.Effect<Option.None<string[]> | Option.Some<string[]>, WebError.WebError, never>;
+        readonly getFile: (handle: FileSystemFileHandle) => Effect.Effect<File, WebError.NotFoundError | WebError.NotAllowedError | WebError.UnknownError, never>;
+        readonly writeFile: (handle: FileSystemFileHandle, data: FileSystemWriteChunkType, options?: FileSystemCreateWritableOptions) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.AbortError | WebError.QuotaExceededError | WebError.UnknownError, never>;
+        readonly appendToFile: (handle: FileSystemFileHandle, data: FileSystemWriteChunkType) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.AbortError | WebError.QuotaExceededError | WebError.UnknownError, never>;
+        readonly truncateFile: (handle: FileSystemFileHandle, size: number) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.AbortError | WebError.QuotaExceededError | WebError.UnknownError, never>;
+        readonly createSyncAccessHandle: (handle: FileSystemFileHandle) => Effect.Effect<FileSystemSyncAccessHandle, WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.InvalidStateError | WebError.UnknownError, import("effect/Scope").Scope>;
+        readonly syncRead: (handle: FileSystemSyncAccessHandle, buffer: ArrayBuffer | ArrayBufferView, options?: FileSystemReadWriteOptions) => Effect.Effect<number, WebError.RangeError | WebError.TypeError | WebError.InvalidStateError | WebError.UnknownError, never>;
+        readonly syncWrite: (handle: FileSystemSyncAccessHandle, buffer: AllowSharedBufferSource, options?: FileSystemReadWriteOptions) => Effect.Effect<number, WebError.WebError, never>;
+        readonly syncTruncate: (handle: FileSystemSyncAccessHandle, size: number) => Effect.Effect<void, WebError.WebError, never>;
+        readonly syncGetSize: (handle: FileSystemSyncAccessHandle) => Effect.Effect<number, WebError.WebError, never>;
+        readonly syncFlush: (handle: FileSystemSyncAccessHandle) => Effect.Effect<void, WebError.WebError, never>;
+    };
+    readonly accessors: true;
+}>;
+/**
+ * Effect service that exposes ergonomic wrappers around Origin Private File System (OPFS) operations.
+ *
+ * @remarks
+ * - Helpers mirror the File System Access API where possible and parse web exceptions into Effect errors.
+ * - Sync access handle helpers can only be used in dedicated workers; invoking them in other contexts fails at runtime.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Origin_private_file_system | MDN Reference}
+ */
+export declare class Opfs extends Opfs_base {
+}
+/**
+ * A no-op Opfs service that can be used for testing.
+ */
+export declare const noopOpfs: Opfs;
+declare const OpfsError_base: Schema.TaggedErrorClass<OpfsError, "@livestore/utils/Opfs/Error", {
+    readonly _tag: Schema.tag<"@livestore/utils/Opfs/Error">;
+} & {
+    message: typeof Schema.String;
+    cause: Schema.optional<typeof Schema.Defect>;
+}>;
+/**
+ * Error raised when OPFS operations fail.
+ */
+export declare class OpfsError extends OpfsError_base {
+}
+export {};
+//# sourceMappingURL=Opfs.d.ts.map

package/dist/browser/Opfs/Opfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Opfs.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/Opfs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;;;;yCAkCP,yBAAyB,QAAQ,MAAM,YAAY,wBAAwB;8CAsBhG,yBAAyB,QAC3B,MAAM,YACF,6BAA6B;uCAsBZ,yBAAyB,QAAQ,MAAM,YAAY,uBAAuB;qCAqB5E,yBAAyB;mCAc3B,yBAAyB,SAAS,gBAAgB;mCAalD,oBAAoB;qCAgBnC,oBAAoB,QACtB,wBAAwB,YACpB,+BAA+B;wCAkCb,oBAAoB,QAAQ,wBAAwB;wCAwCpD,oBAAoB,QAAQ,MAAM;kDAqCxB,oBAAoB;oCA6BlD,0BAA0B,UAC1B,WAAW,GAAG,eAAe,YAC3B,0BAA0B;qCAqB5B,0BAA0B,UAC1B,uBAAuB,YACrB,0BAA0B;wCAkBR,0BAA0B,QAAQ,MAAM;uCAiBzC,0BAA0B;qCAgB5B,0BAA0B;;;;AAxWzD;;;;;;;;GAQG;AACH,qBAAa,IAAK,SAAQ,SAyXxB;CAAG;AAQL;;GAEG;AACH,eAAO,MAAM,QAAQ,MAiBnB,CAAA;;;;;;;AAEF;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAG7B;CAAG"}

package/dist/browser/Opfs/Opfs.js

@@ -0,0 +1,345 @@
+/// <reference lib="webworker" />
+import { Effect, Option, Schema, Stream } from 'effect';
+import * as WebError from "../WebError.js";
+/**
+ * Effect service that exposes ergonomic wrappers around Origin Private File System (OPFS) operations.
+ *
+ * @remarks
+ * - Helpers mirror the File System Access API where possible and parse web exceptions into Effect errors.
+ * - Sync access handle helpers can only be used in dedicated workers; invoking them in other contexts fails at runtime.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Origin_private_file_system | MDN Reference}
+ */
+export class Opfs extends Effect.Service()('@livestore/utils/Opfs', {
+    sync: () => {
+        /**
+         * Acquire the OPFS root directory handle.
+         *
+         * @returns Root directory handle for the current origin.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/StorageManager/getDirectory | MDN Reference}
+         */
+        const getRootDirectoryHandle = Effect.tryPromise({
+            try: () => navigator.storage.getDirectory(),
+            catch: (u) => WebError.parseWebError(u, [WebError.SecurityError]),
+        });
+        /**
+         * Resolve (and optionally create) a file handle relative to a directory.
+         *
+         * @param parent - Directory to search.
+         * @param name - Target file name.
+         * @param options - Forwarded `getFileHandle` options such as `{ create: true }`.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getFileHandle | MDN Reference}
+         */
+        const getFileHandle = (parent, name, options) => Effect.tryPromise({
+            try: () => parent.getFileHandle(name, options),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.NotAllowedError,
+                WebError.TypeError,
+                WebError.TypeMismatchError,
+                WebError.NotFoundError,
+            ]),
+        });
+        /**
+         * Resolve (and optionally create) a directory handle relative to another directory.
+         *
+         * @param parent - Directory to search.
+         * @param name - Target directory name.
+         * @param options - Forwarded `getDirectoryHandle` options such as `{ create: true }`.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle | MDN Reference}
+         */
+        const getDirectoryHandle = (parent, name, options) => Effect.tryPromise({
+            try: () => parent.getDirectoryHandle(name, options),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.NotAllowedError,
+                WebError.TypeError,
+                WebError.TypeMismatchError,
+                WebError.NotFoundError,
+            ]),
+        });
+        /**
+         * Remove a file-system entry (file or directory) from its parent directory.
+         *
+         * @param parent - Directory containing the entry.
+         * @param name - Entry name.
+         * @param options - Removal behavior (for example `{ recursive: true }`).
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/removeEntry | MDN Reference}
+         */
+        const removeEntry = (parent, name, options) => Effect.tryPromise({
+            try: () => parent.removeEntry(name, options),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.TypeError,
+                WebError.NotAllowedError,
+                WebError.InvalidModificationError,
+                WebError.NotFoundError,
+                WebError.NoModificationAllowedError,
+            ]),
+        });
+        /**
+         * Return a stream of child file-system handles for a directory.
+         *
+         * @param directory - Directory whose children are to be streamed
+         * @returns `Stream` of `FileSystemHandle`
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/values | MDN Reference}
+         */
+        const values = (directory) => Stream.fromAsyncIterable(directory.values(), (u) => WebError.parseWebError(u, [WebError.NotAllowedError, WebError.NotFoundError]));
+        /**
+         * Resolve the relative path from a parent directory to a descendant handle.
+         *
+         * @param parent - Reference directory.
+         * @param child - File or directory handle within the parent hierarchy.
+         * @returns `Option.some(pathSegments)` when reachable, otherwise `Option.none()`.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/resolve | MDN Reference}
+         */
+        const resolve = (parent, child) => Effect.tryPromise({
+            try: () => parent.resolve(child),
+            catch: (u) => WebError.parseWebError(u),
+        }).pipe(Effect.map((path) => (path === null ? Option.none() : Option.some(path))));
+        /**
+         * Read the underlying `File` for a file handle.
+         *
+         * @param handle - Handle referencing the target file.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/getFile | MDN Reference}
+         */
+        const getFile = (handle) => Effect.tryPromise({
+            try: () => handle.getFile(),
+            catch: (u) => WebError.parseWebError(u, [WebError.NotAllowedError, WebError.NotFoundError]),
+        });
+        /**
+         * Overwrite the contents of a file with the provided data.
+         *
+         * @param handle - File to write to.
+         * @param data - Chunk(s) accepted by `FileSystemWritableFileStream.write`.
+         * @param options - Stream creation options (for example `{ keepExistingData: false }`).
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createWritable | MDN Reference}
+         */
+        const writeFile = (handle, data, options) => Effect.acquireUseRelease(Effect.tryPromise({
+            try: () => handle.createWritable(options),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.NotAllowedError,
+                WebError.NotFoundError,
+                WebError.NoModificationAllowedError,
+                WebError.AbortError,
+            ]),
+        }), (stream) => Effect.tryPromise({
+            try: () => stream.write(data),
+            catch: (u) => WebError.parseWebError(u, [WebError.NotAllowedError, WebError.QuotaExceededError, WebError.TypeError]),
+        }), (stream) => Effect.tryPromise({
+            try: () => stream.close(),
+            catch: (u) => WebError.parseWebError(u, [WebError.TypeError]),
+        }).pipe(Effect.orElse(() => Effect.void)));
+        /**
+         * Append data to the end of an existing file.
+         *
+         * @param handle - File to extend.
+         * @param data - Data to append.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/write | MDN Reference}
+         */
+        const appendToFile = (handle, data) => Effect.acquireUseRelease(Effect.tryPromise({
+            try: () => handle.createWritable({ keepExistingData: true }),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.NotAllowedError,
+                WebError.NotFoundError,
+                WebError.NoModificationAllowedError,
+                WebError.AbortError,
+            ]),
+        }), (stream) => Effect.gen(function* () {
+            const file = yield* getFile(handle);
+            yield* Effect.tryPromise({
+                try: () => stream.seek(file.size),
+                catch: (u) => WebError.parseWebError(u, [WebError.NotAllowedError, WebError.TypeError]),
+            });
+            yield* Effect.tryPromise({
+                try: () => stream.write(data),
+                catch: (u) => WebError.parseWebError(u, [WebError.NotAllowedError, WebError.QuotaExceededError, WebError.TypeError]),
+            });
+        }), (stream) => Effect.tryPromise({
+            try: () => stream.close(),
+            catch: (u) => WebError.parseWebError(u, [WebError.TypeError]),
+        }).pipe(Effect.orElse(() => Effect.void)));
+        /**
+         * Truncate a file to the specified size in bytes.
+         *
+         * @param handle - File to shrink or pad.
+         * @param size - Target byte length.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/truncate | MDN Reference}
+         */
+        const truncateFile = (handle, size) => Effect.acquireUseRelease(Effect.tryPromise({
+            try: () => handle.createWritable({ keepExistingData: true }),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.NotAllowedError,
+                WebError.NotFoundError,
+                WebError.NoModificationAllowedError,
+                WebError.AbortError,
+            ]),
+        }), (stream) => Effect.tryPromise({
+            try: () => stream.truncate(size),
+            catch: (u) => WebError.parseWebError(u, [WebError.NotAllowedError, WebError.TypeError, WebError.QuotaExceededError]),
+        }), (stream) => Effect.tryPromise({
+            try: () => stream.close(),
+            catch: (u) => WebError.parseWebError(u, [WebError.TypeError]),
+        }).pipe(Effect.orElse(() => Effect.void)));
+        /**
+         * Create a synchronous access handle for a file.
+         *
+         * @param handle - File handle to open.
+         * @returns A managed handle that is automatically closed when released.
+         *
+         * @remarks
+         * - Only available in Dedicated Web Workers.
+         * - This method is asynchronous even though the `FileSystemSyncAccessHandle` APIs are synchronous.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle | MDN Reference}
+         */
+        const createSyncAccessHandle = (handle) => Effect.acquireRelease(Effect.tryPromise({
+            try: () => handle.createSyncAccessHandle(),
+            catch: (u) => WebError.parseWebError(u, [
+                WebError.NotAllowedError,
+                WebError.InvalidStateError,
+                WebError.NotFoundError,
+                WebError.NoModificationAllowedError,
+            ]),
+        }), (syncHandle) => Effect.sync(() => syncHandle.close()));
+        /**
+         * Perform a synchronous read into the provided buffer from a sync access handle.
+         *
+         * @param handle - Sync access handle to read from.
+         * @param buffer - Destination buffer (can be a specific view like Uint8Array).
+         * @param options - Read position options.
+         * @returns Number of bytes read.
+         *
+         * @remarks
+         * Only available in Dedicated Web Workers.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read | MDN Reference}
+         */
+        const syncRead = (handle, buffer, options) => Effect.try({
+            try: () => handle.read(buffer, options),
+            catch: (u) => WebError.parseWebError(u, [WebError.RangeError, WebError.InvalidStateError, WebError.TypeError]),
+        });
+        /**
+         * Perform a synchronous write from the provided buffer into the file.
+         *
+         * @param handle - Sync access handle to write to.
+         * @param buffer - Source data.
+         * @param options - Write position options.
+         * @returns Number of bytes written.
+         *
+         * @remarks
+         * Only available in Dedicated Web Workers.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/write | MDN Reference}
+         */
+        const syncWrite = (handle, buffer, options) => Effect.try({
+            try: () => handle.write(buffer, options),
+            catch: (u) => WebError.parseWebError(u),
+        });
+        /**
+         * Truncate the file associated with a sync access handle to the specified size.
+         *
+         * @param handle - Sync access handle to mutate.
+         * @param size - Desired byte length.
+         *
+         * @remarks
+         * Only available in Dedicated Web Workers.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate | MDN Reference}
+         */
+        const syncTruncate = (handle, size) => Effect.try({
+            try: () => handle.truncate(size),
+            catch: (u) => WebError.parseWebError(u),
+        });
+        /**
+         * Retrieve the current size of a file via its sync access handle.
+         *
+         * @param handle - Sync access handle.
+         * @returns File size in bytes.
+         *
+         * @remarks
+         * Only available in Dedicated Web Workers.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize | MDN Reference}
+         */
+        const syncGetSize = (handle) => Effect.try({
+            try: () => handle.getSize(),
+            catch: (u) => WebError.parseWebError(u),
+        });
+        /**
+         * Flush pending synchronous writes to durable storage.
+         *
+         * @param handle - Sync access handle to flush.
+         *
+         * @remarks
+         * Only available in Dedicated Web Workers.
+         *
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush | MDN Reference}
+         */
+        const syncFlush = (handle) => Effect.try({
+            try: () => handle.flush(),
+            catch: (u) => WebError.parseWebError(u),
+        });
+        return {
+            getRootDirectoryHandle,
+            getFileHandle,
+            getDirectoryHandle,
+            removeEntry,
+            values,
+            resolve,
+            getFile,
+            writeFile,
+            appendToFile,
+            truncateFile,
+            createSyncAccessHandle,
+            syncRead,
+            syncWrite,
+            syncTruncate,
+            syncGetSize,
+            syncFlush,
+        };
+    },
+    accessors: true,
+}) {
+}
+const notFoundError = new WebError.NotFoundError({
+    cause: new DOMException('The object can not be found here.', 'NotFoundError'),
+});
+const unknownError = (message) => new WebError.UnknownError({ description: message });
+/**
+ * A no-op Opfs service that can be used for testing.
+ */
+export const noopOpfs = new Opfs({
+    getRootDirectoryHandle: Effect.fail(unknownError('OPFS is not supported in this environment')),
+    getFileHandle: () => Effect.fail(notFoundError),
+    getDirectoryHandle: () => Effect.fail(notFoundError),
+    removeEntry: () => Effect.fail(notFoundError),
+    values: () => Effect.fail(notFoundError),
+    resolve: () => Effect.succeed(Option.none()),
+    getFile: () => Effect.fail(notFoundError),
+    writeFile: () => Effect.fail(notFoundError),
+    appendToFile: () => Effect.fail(notFoundError),
+    truncateFile: () => Effect.fail(notFoundError),
+    createSyncAccessHandle: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncRead: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncWrite: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncTruncate: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncGetSize: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncFlush: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+});
+/**
+ * Error raised when OPFS operations fail.
+ */
+export class OpfsError extends Schema.TaggedError()('@livestore/utils/Opfs/Error', {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect),
+}) {
+}
+//# sourceMappingURL=Opfs.js.map

package/dist/browser/Opfs/Opfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Opfs.js","sourceRoot":"","sources":["../../../src/browser/Opfs/Opfs.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAE1C;;;;;;;;GAQG;AACH,MAAM,OAAO,IAAK,SAAQ,MAAM,CAAC,OAAO,EAAQ,CAAC,uBAAuB,EAAE;IACxE,IAAI,EAAE,GAAG,EAAE;QACT;;;;;;WAMG;QACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC;YAC/C,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE;YAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;SAClE,CAAC,CAAA;QAEF;;;;;;;;WAQG;QACH,MAAM,aAAa,GAAG,CAAC,MAAiC,EAAE,IAAY,EAAE,OAAkC,EAAE,EAAE,CAC5G,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;YAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,SAAS;gBAClB,QAAQ,CAAC,iBAAiB;gBAC1B,QAAQ,CAAC,aAAa;aACvB,CAAC;SACL,CAAC,CAAA;QAEJ;;;;;;;;WAQG;QACH,MAAM,kBAAkB,GAAG,CACzB,MAAiC,EACjC,IAAY,EACZ,OAAuC,EACvC,EAAE,CACF,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC;YACnD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,SAAS;gBAClB,QAAQ,CAAC,iBAAiB;gBAC1B,QAAQ,CAAC,aAAa;aACvB,CAAC;SACL,CAAC,CAAA;QAEJ;;;;;;;;WAQG;QACH,MAAM,WAAW,GAAG,CAAC,MAAiC,EAAE,IAAY,EAAE,OAAiC,EAAE,EAAE,CACzG,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;YAC5C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,SAAS;gBAClB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,wBAAwB;gBACjC,QAAQ,CAAC,aAAa;gBACtB,QAAQ,CAAC,0BAA0B;aACpC,CAAC;SACL,CAAC,CAAA;QAEJ;;;;;;;WAOG;QACH,MAAM,MAAM,GAAG,CAAC,SAAoC,EAAE,EAAE,CACtD,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CACjD,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAC9E,CAAA;QAEH;;;;;;;;WAQG;QACH,MAAM,OAAO,GAAG,CAAC,MAAiC,EAAE,KAAuB,EAAE,EAAE,CAC7E,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;SACxC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAEpF;;;;;;WAMG;QACH,MAAM,OAAO,GAAG,CAAC,MAA4B,EAAE,EAAE,CAC/C,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;YAC3B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;SAC5F,CAAC,CAAA;QAEJ;;;;;;;;WAQG;QACH,MAAM,SAAS,GAAG,CAChB,MAA4B,EAC5B,IAA8B,EAC9B,OAAyC,EACzC,EAAE,CACF,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC;YACzC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,aAAa;gBACtB,QAAQ,CAAC,0BAA0B;gBACnC,QAAQ,CAAC,UAAU;aACpB,CAAC;SACL,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAC7B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;SACzG,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;SAC9D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAC5C,CAAA;QAEH;;;;;;;WAOG;QACH,MAAM,YAAY,GAAG,CAAC,MAA4B,EAAE,IAA8B,EAAE,EAAE,CACpF,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;YAC5D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,aAAa;gBACtB,QAAQ,CAAC,0BAA0B;gBACnC,QAAQ,CAAC,UAAU;aACpB,CAAC;SACL,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACnC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACvB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACjC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;aACxF,CAAC,CAAA;YACF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACvB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC7B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;aACzG,CAAC,CAAA;QACJ,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;SAC9D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAC5C,CAAA;QAEH;;;;;;;WAOG;QACH,MAAM,YAAY,GAAG,CAAC,MAA4B,EAAE,IAAY,EAAE,EAAE,CAClE,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;YAC5D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,aAAa;gBACtB,QAAQ,CAAC,0BAA0B;gBACnC,QAAQ,CAAC,UAAU;aACpB,CAAC;SACL,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;SACzG,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;SAC9D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAC5C,CAAA;QAEH;;;;;;;;;;;WAWG;QACH,MAAM,sBAAsB,GAAG,CAAC,MAA4B,EAAE,EAAE,CAC9D,MAAM,CAAC,cAAc,CACnB,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE;YAC1C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE;gBACxB,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,iBAAiB;gBAC1B,QAAQ,CAAC,aAAa;gBACtB,QAAQ,CAAC,0BAA0B;aACpC,CAAC;SACL,CAAC,EACF,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CACtD,CAAA;QAEH;;;;;;;;;;;;WAYG;QACH,MAAM,QAAQ,GAAG,CACf,MAAkC,EAClC,MAAqC,EACrC,OAAoC,EACpC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;YACvC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;SAC/G,CAAC,CAAA;QAEJ;;;;;;;;;;;;WAYG;QACH,MAAM,SAAS,GAAG,CAChB,MAAkC,EAClC,MAA+B,EAC/B,OAAoC,EACpC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;YACxC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;SACxC,CAAC,CAAA;QAEJ;;;;;;;;;;WAUG;QACH,MAAM,YAAY,GAAG,CAAC,MAAkC,EAAE,IAAY,EAAE,EAAE,CACxE,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;SACxC,CAAC,CAAA;QAEJ;;;;;;;;;;WAUG;QACH,MAAM,WAAW,GAAG,CAAC,MAAkC,EAAE,EAAE,CACzD,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;YAC3B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;SACxC,CAAC,CAAA;QAEJ;;;;;;;;;WASG;QACH,MAAM,SAAS,GAAG,CAAC,MAAkC,EAAE,EAAE,CACvD,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;SACxC,CAAC,CAAA;QAEJ,OAAO;YACL,sBAAsB;YACtB,aAAa;YACb,kBAAkB;YAClB,WAAW;YACX,MAAM;YACN,OAAO;YACP,OAAO;YACP,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,sBAAsB;YACtB,QAAQ;YACR,SAAS;YACT,YAAY;YACZ,WAAW;YACX,SAAS;SACD,CAAA;IACZ,CAAC;IACD,SAAS,EAAE,IAAI;CAChB,CAAC;CAAG;AAEL,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,aAAa,CAAC;IAC/C,KAAK,EAAE,IAAI,YAAY,CAAC,mCAAmC,EAAE,eAAe,CAAC;CAC9E,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAA;AAE7F;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IAC9F,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC/C,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACpD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC7C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACzC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC3C,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC9C,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC9C,sBAAsB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACpG,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACtF,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACvF,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IAC1F,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACzF,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;CACxF,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,WAAW,EAAa,CAAC,6BAA6B,EAAE;IAC5F,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACtC,CAAC;CAAG"}

package/dist/browser/Opfs/debug-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Debug utilities for OPFS (Origin Private File System) inspection and manipulation.
+ * These functions are designed for use in browser devtools console to help debug
+ * and inspect the OPFS structure during development.
+ */
+export declare const debugUtils: {
+    /**
+     * Print the entire OPFS tree structure to the console in an ASCII format.
+     */
+    readonly printTree: () => Promise<void>;
+    /**
+     * Reset the entire OPFS tree by removing all files and directories.
+     */
+    readonly resetTree: () => Promise<void>;
+    /**
+     * Get a directory handle for a given path, useful for inspecting or manipulating specific directories.
+     */
+    readonly getDirHandle: (path: string, options?: FileSystemGetDirectoryOptions) => Promise<FileSystemDirectoryHandle>;
+};
+//# sourceMappingURL=debug-utils.d.ts.map

package/dist/browser/Opfs/debug-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-utils.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/debug-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqIH,eAAO,MAAM,UAAU;IACrB;;OAEG;8BACY,OAAO,CAAC,IAAI,CAAC;IAC5B;;OAEG;8BACY,OAAO,CAAC,IAAI,CAAC;IAC5B;;OAEG;kCACkB,MAAM,YAAY,6BAA6B;CAC5D,CAAA"}

package/dist/browser/Opfs/debug-utils.js

@@ -0,0 +1,94 @@
+/**
+ * Debug utilities for OPFS (Origin Private File System) inspection and manipulation.
+ * These functions are designed for use in browser devtools console to help debug
+ * and inspect the OPFS structure during development.
+ */
+import { Effect, Stream } from 'effect';
+import prettyBytes from 'pretty-bytes';
+import { Opfs } from "./Opfs.js";
+import { getDirectoryHandleByPath, getMetadata, remove } from "./utils.js";
+const ROOT_NAME = '/';
+/**
+ * Materialize the entire OPFS tree starting from the origin root.
+ */
+const buildTree = Effect.fn('@livestore/utils:Opfs.buildTree')(function* () {
+    const rootHandle = yield* Opfs.getRootDirectoryHandle;
+    const collectDirectory = (handle, pathSegments) => Effect.gen(function* () {
+        const handlesStream = yield* Opfs.values(handle);
+        const handles = yield* handlesStream.pipe(Stream.runCollect, Effect.map((chunk) => Array.from(chunk).sort((a, b) => a.name.localeCompare(b.name))));
+        const children = yield* Effect.forEach(handles, (childHandle) => Effect.gen(function* () {
+            const nextSegments = [...pathSegments, childHandle.name];
+            const path = formatPath(nextSegments);
+            if (childHandle.kind === 'directory') {
+                return yield* collectDirectory(childHandle, nextSegments);
+            }
+            const metadata = yield* getMetadata(childHandle);
+            return {
+                metadata: {
+                    name: childHandle.name,
+                    path,
+                    kind: 'file',
+                    size: metadata.size,
+                    lastModified: metadata.lastModified,
+                },
+            };
+        }), { concurrency: 'unbounded' });
+        return {
+            metadata: {
+                name: pathSegments.length === 0 ? ROOT_NAME : pathSegments[pathSegments.length - 1],
+                path: formatPath(pathSegments),
+                kind: 'directory',
+            },
+            children,
+        };
+    });
+    return yield* collectDirectory(rootHandle, []);
+});
+const formatPath = (segments) => (segments.length === 0 ? ROOT_NAME : `/${segments.join('/')}`);
+const formatLabel = ({ name, kind, size, lastModified }) => {
+    let label = name;
+    if (kind === 'file' && lastModified !== undefined) {
+        const date = new Date(lastModified);
+        label += ` │ ${date.toISOString().split('T')[0]} ${date.toTimeString().split(' ')[0]}`;
+        if (size !== undefined) {
+            label += ` │ ${prettyBytes(size)}`;
+        }
+    }
+    return label;
+};
+const logAsciiTree = (node) => logAsciiNode(node, { prefix: '', isLast: true, isRoot: true });
+const logAsciiNode = (node, options) => Effect.gen(function* () {
+    const label = formatLabel(node.metadata);
+    const branch = options.isRoot ? '' : `${options.prefix}${options.isLast ? '└── ' : '├── '}`;
+    const nextPrefix = options.isRoot ? '' : `${options.prefix}${options.isLast ? '    ' : '│   '}`;
+    console.log(`${branch}${label}`);
+    if (node.children === undefined || node.children.length === 0)
+        return;
+    for (let index = 0; index < node.children.length; index++) {
+        const child = node.children[index];
+        const isLastChild = index === node.children.length - 1;
+        yield* logAsciiNode(child, { prefix: nextPrefix, isLast: isLastChild });
+    }
+});
+const printTree = Effect.gen(function* () {
+    const tree = yield* buildTree();
+    yield* logAsciiTree(tree);
+});
+const resetTree = remove('/');
+const getDirHandle = (path, options) => getDirectoryHandleByPath(path, options);
+const runOpfsEffect = (effect) => effect.pipe(Effect.provide(Opfs.Default), Effect.runPromise);
+export const debugUtils = {
+    /**
+     * Print the entire OPFS tree structure to the console in an ASCII format.
+     */
+    printTree: () => runOpfsEffect(printTree),
+    /**
+     * Reset the entire OPFS tree by removing all files and directories.
+     */
+    resetTree: () => runOpfsEffect(resetTree),
+    /**
+     * Get a directory handle for a given path, useful for inspecting or manipulating specific directories.
+     */
+    getDirHandle: (path, options) => runOpfsEffect(getDirHandle(path, options)),
+};
+//# sourceMappingURL=debug-utils.js.map

package/dist/browser/Opfs/debug-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-utils.js","sourceRoot":"","sources":["../../../src/browser/Opfs/debug-utils.ts"],"names":[],"mappings":"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"}

package/dist/browser/Opfs/mod.d.ts

@@ -0,0 +1,4 @@
+export * from './debug-utils.ts';
+export * from './Opfs.ts';
+export * from './utils.ts';
+//# sourceMappingURL=mod.d.ts.map

package/dist/browser/Opfs/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/dist/browser/Opfs/mod.js

@@ -0,0 +1,4 @@
+export * from "./debug-utils.js";
+export * from "./Opfs.js";
+export * from "./utils.js";
+//# sourceMappingURL=mod.js.map

package/dist/browser/Opfs/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/browser/Opfs/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/dist/browser/Opfs/utils.d.ts

@@ -0,0 +1,68 @@
+import { Effect } from 'effect';
+import { Opfs, OpfsError } from './Opfs.ts';
+/**
+ * Resolve a directory handle using a slash-delimited OPFS path.
+ *
+ * @param path - Directory path relative to the OPFS root.
+ * @param options - Options forwarded to `getDirectoryHandle` when traversing segments.
+ * @returns Directory handle for the final segment.
+ */
+export declare const getDirectoryHandleByPath: (path: string, options?: FileSystemGetDirectoryOptions | undefined) => Effect.Effect<FileSystemDirectoryHandle, import("../WebError.ts").TypeError | import("../WebError.ts").NotFoundError | import("../WebError.ts").NotAllowedError | import("../WebError.ts").TypeMismatchError | import("../WebError.ts").SecurityError | import("../WebError.ts").UnknownError | OpfsError, Opfs>;
+/**
+ * Remove a file or directory identified by an OPFS path.
+ *
+ * @param path - Slash-delimited path to delete.
+ * @param options.recursive - When `true`, recursively delete directory contents; defaults to `false`.
+ */
+export declare const remove: (path: string, options?: {
+    readonly recursive?: boolean;
+} | undefined) => Effect.Effect<void, import("../WebError.ts").TypeError | import("../WebError.ts").NoModificationAllowedError | import("../WebError.ts").NotFoundError | import("../WebError.ts").NotAllowedError | import("../WebError.ts").TypeMismatchError | import("../WebError.ts").InvalidModificationError | import("../WebError.ts").SecurityError | import("../WebError.ts").UnknownError | OpfsError, Opfs>;
+/**
+ * Determine whether a file or directory exists at the given OPFS path.
+ *
+ * @param path - Slash-delimited path to inspect.
+ * @returns `true` if the path resolves to a file or directory, otherwise `false`.
+ */
+export declare const exists: (path: string) => Effect.Effect<boolean, import("../WebError.ts").TypeError | import("../WebError.ts").NotAllowedError | import("../WebError.ts").TypeMismatchError | import("../WebError.ts").SecurityError | import("../WebError.ts").UnknownError | OpfsError, Opfs>;
+/**
+ * Create a directory at the provided path, optionally creating parents recursively.
+ *
+ * @param path - Slash-delimited directory path.
+ * @param options.recursive - When `true`, create all missing parent segments; defaults to `false`.
+ */
+export declare const makeDirectory: (path: string, options?: {
+    readonly recursive?: boolean;
+} | undefined) => Effect.Effect<void, import("../WebError.ts").TypeError | import("../WebError.ts").NotFoundError | import("../WebError.ts").NotAllowedError | import("../WebError.ts").TypeMismatchError | import("../WebError.ts").SecurityError | import("../WebError.ts").UnknownError | OpfsError, Opfs>;
+/**
+ * Extract basic metadata for a given file handle.
+ *
+ * @param handle - File handle whose metadata should be read.
+ * @returns Object containing name, size, MIME type, and last modification timestamp.
+ */
+export declare const getMetadata: (handle: FileSystemFileHandle) => Effect.Effect<{
+    name: string;
+    size: number;
+    type: string;
+    lastModified: number;
+}, import("../WebError.ts").NotFoundError | import("../WebError.ts").NotAllowedError | import("../WebError.ts").UnknownError, Opfs>;
+/**
+ * Write bytes to an OPFS path, creating or replacing the target file.
+ *
+ * @param path - Slash-delimited file path.
+ * @param data - Bytes to persist.
+ */
+export declare const writeFile: (path: string, data: Uint8Array<ArrayBufferLike>) => Effect.Effect<void, import("../WebError.ts").TypeError | import("../WebError.ts").NoModificationAllowedError | import("../WebError.ts").NotFoundError | import("../WebError.ts").NotAllowedError | import("../WebError.ts").TypeMismatchError | import("../WebError.ts").AbortError | import("../WebError.ts").SecurityError | import("../WebError.ts").QuotaExceededError | import("../WebError.ts").UnknownError | OpfsError, Opfs>;
+/**
+ * Synchronously write bytes to the target file handle, truncating any existing content.
+ *
+ * @param handle - Sync access handle to overwrite.
+ * @param buffer - Raw data to persist.
+ * @returns Effect that resolves once every byte is flushed to durable storage.
+ *
+ * @remarks
+ * - Only available in Dedicated Web Workers.
+ * - Crash safety: not atomic. A crash mid-write can leave the file truncated or partially written.
+ *   For atomic replacement, prefer `writeFile` or a temp-file pattern with two prepared handles.
+ */
+export declare const syncWriteFile: (handle: FileSystemSyncAccessHandle, buffer: AllowSharedBufferSource) => Effect.Effect<undefined, import("../WebError.ts").WebError | OpfsError, Opfs>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/browser/Opfs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAoG3C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,yXAQnC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM;yBAEgB,OAAO;uZAkBxC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,yQAiBjB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa;yBAES,OAAO;6SASxC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;mIAStB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,4dAoBpB,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,wJAsBxB,CAAA"}