@fgv/ts-web-extras 5.0.2 → 5.1.0-0

package/lib/packlets/file-tree/fileSystemAccessTreeAccessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystemAccessTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileSystemAccessTreeAccessors.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, succeed, fail, captureResult, DetailedResult, succeedWithDetail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { FileSystemDirectoryHandle, FileSystemFileHandle } from '../file-api-types';\n\n/**\n * Options for creating persistent file trees.\n * @public\n */\nexport interface IFileSystemAccessTreeParams<TCT extends string = string>\n  extends FileTree.IFileTreeInitParams<TCT> {\n  /**\n   * Automatically sync changes to disk immediately after each save.\n   * If false, changes are batched and written on explicit syncToDisk() call.\n   * @defaultValue false\n   */\n  autoSync?: boolean;\n\n  /**\n   * Require write permission on the directory handle.\n   * If true, fails if write permission cannot be obtained.\n   * If false, falls back to read-only mode.\n   * @defaultValue true\n   */\n  requireWritePermission?: boolean;\n\n  /**\n   * Override the path at which the file is stored in the tree (for fromFileHandle).\n   * Must be an absolute path (e.g., '/data/confections/common.yaml').\n   * If omitted, defaults to `/<filename>`.\n   */\n  filePath?: string;\n}\n\n/**\n * Implementation of `FileTree.IPersistentFileTreeAccessors` that uses the File System Access API\n * to provide persistent file editing in browsers.\n * @public\n */\nexport class FileSystemAccessTreeAccessors<TCT extends string = string>\n  extends FileTree.InMemoryTreeAccessors<TCT>\n  implements FileTree.IPersistentFileTreeAccessors<TCT>\n{\n  private readonly _handles: Map<string, FileSystemFileHandle>;\n  private readonly _rootDir: FileSystemDirectoryHandle;\n  private readonly _dirtyFiles: Set<string>;\n  private readonly _autoSync: boolean;\n  private readonly _hasWritePermission: boolean;\n\n  /**\n   * Protected constructor for FileSystemAccessTreeAccessors.\n   * @param files - An array of in-memory files to include in the tree.\n   * @param rootDir - The root directory handle.\n   * @param handles - Map of file paths to their handles.\n   * @param params - Optional params for the tree.\n   * @param hasWritePermission - Whether write permission was granted.\n   */\n  protected constructor(\n    files: FileTree.IInMemoryFile<TCT>[],\n    rootDir: FileSystemDirectoryHandle,\n    handles: Map<string, FileSystemFileHandle>,\n    params: IFileSystemAccessTreeParams<TCT> | undefined,\n    hasWritePermission: boolean\n  ) {\n    super(files, params);\n    this._rootDir = rootDir;\n    this._handles = handles;\n    this._dirtyFiles = new Set();\n    this._autoSync = params?.autoSync ?? false;\n    this._hasWritePermission = hasWritePermission;\n  }\n\n  /**\n   * Creates a new FileSystemAccessTreeAccessors instance from a directory handle.\n   * @param dirHandle - The FileSystemDirectoryHandle to load files from.\n   * @param params - Optional parameters including autoSync and permission settings.\n   * @returns Promise resolving to a FileSystemAccessTreeAccessors instance.\n   * @public\n   */\n  public static async fromDirectoryHandle<TCT extends string = string>(\n    dirHandle: FileSystemDirectoryHandle,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<Result<FileSystemAccessTreeAccessors<TCT>>> {\n    try {\n      // Check write permission\n      const hasWritePermission = await this._checkWritePermission(dirHandle);\n\n      /* c8 ignore next 3 - coverage intermittently missed in full suite */\n      if (!hasWritePermission && (params?.requireWritePermission ?? true)) {\n        return fail('Write permission required but not granted');\n      }\n\n      // Load all files from the directory (always use '/' as base, prefix is handled by parent)\n      const { files, handles } = await this._loadDirectory<TCT>(dirHandle, '/', params);\n\n      // Enable tree mutability when write permission is granted and caller didn't explicitly set mutable\n      const effectiveParams: IFileSystemAccessTreeParams<TCT> = {\n        ...params,\n        mutable: params?.mutable ?? (hasWritePermission ? true : false)\n      };\n\n      return succeed(\n        new FileSystemAccessTreeAccessors<TCT>(files, dirHandle, handles, effectiveParams, hasWritePermission)\n      );\n      /* c8 ignore next 4 - defensive: outer catch for unexpected errors */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to create FileSystemAccessTreeAccessors: ${message}`);\n    }\n  }\n\n  /**\n   * Creates a new FileSystemAccessTreeAccessors instance from a single file handle.\n   *\n   * The resulting tree contains exactly one file at `/<filename>`.\n   * `syncToDisk()` writes changes back to the original file via the File System Access API.\n   * New file creation is not supported on this tree (no parent directory handle).\n   *\n   * @param fileHandle - The FileSystemFileHandle to load.\n   * @param params - Optional parameters including autoSync and permission settings.\n   * @returns Promise resolving to a FileSystemAccessTreeAccessors instance.\n   * @public\n   */\n  public static async fromFileHandle<TCT extends string = string>(\n    fileHandle: FileSystemFileHandle,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<Result<FileSystemAccessTreeAccessors<TCT>>> {\n    try {\n      const hasWritePermission = await this._checkFileWritePermission(fileHandle);\n\n      if (!hasWritePermission && (params?.requireWritePermission ?? true)) {\n        return fail('Write permission required but not granted');\n      }\n\n      const file = await fileHandle.getFile();\n      const contents = await file.text();\n      const path = params?.filePath ?? `/${fileHandle.name}`;\n      const contentType = params?.inferContentType\n        ? params.inferContentType(path, file.type).orDefault()\n        : undefined;\n\n      const files: FileTree.IInMemoryFile<TCT>[] = [{ path, contents, contentType }];\n      const handles = new Map<string, FileSystemFileHandle>([[path, fileHandle]]);\n\n      const dummyRoot = {} as FileSystemDirectoryHandle;\n      const effectiveParams: IFileSystemAccessTreeParams<TCT> = {\n        ...params,\n        mutable: hasWritePermission ? true : params?.mutable ?? false\n      };\n\n      return succeed(\n        new FileSystemAccessTreeAccessors<TCT>(files, dummyRoot, handles, effectiveParams, hasWritePermission)\n      );\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to create FileSystemAccessTreeAccessors from file: ${message}`);\n    }\n  }\n\n  /**\n   * Check if the directory handle has write permission.\n   * @param handle - The directory handle to check.\n   * @returns Promise resolving to true if write permission is granted.\n   * @internal\n   */\n  private static async _checkWritePermission(handle: FileSystemDirectoryHandle): Promise<boolean> {\n    try {\n      const permission = await handle.queryPermission({ mode: 'readwrite' });\n\n      if (permission === 'granted') {\n        return true;\n      }\n\n      if (permission === 'prompt') {\n        const requested = await handle.requestPermission({ mode: 'readwrite' });\n        return requested === 'granted';\n      }\n\n      return false;\n    } catch (error) {\n      // Permission API might not be available or might throw\n      return false;\n    }\n  }\n\n  /**\n   * Check if the file handle has write permission.\n   * @param handle - The file handle to check.\n   * @returns Promise resolving to true if write permission is granted.\n   * @internal\n   */\n  private static async _checkFileWritePermission(handle: FileSystemFileHandle): Promise<boolean> {\n    try {\n      const permission = await handle.queryPermission({ mode: 'readwrite' });\n\n      if (permission === 'granted') {\n        return true;\n      }\n\n      if (permission === 'prompt') {\n        const requested = await handle.requestPermission({ mode: 'readwrite' });\n        return requested === 'granted';\n      }\n\n      return false;\n    } catch (error) {\n      return false;\n    }\n  }\n\n  /**\n   * Load all files from a directory handle recursively.\n   * @param dirHandle - The directory handle to load from.\n   * @param basePath - The base path for files.\n   * @param params - Optional parameters.\n   * @returns Promise resolving to files and handles.\n   * @internal\n   */\n  private static async _loadDirectory<TCT extends string = string>(\n    dirHandle: FileSystemDirectoryHandle,\n    basePath: string,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<{ files: FileTree.IInMemoryFile<TCT>[]; handles: Map<string, FileSystemFileHandle> }> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n    const handles = new Map<string, FileSystemFileHandle>();\n\n    for await (const [name, handle] of dirHandle.entries()) {\n      if (handle.kind === 'file') {\n        const fileHandle = handle as FileSystemFileHandle;\n        const file = await fileHandle.getFile();\n        const contents = await file.text();\n        const path = this._joinPath(basePath, name);\n        /* c8 ignore next 2 - coverage intermittently missed in full suite */\n        const contentType = params?.inferContentType\n          ? params.inferContentType(path, file.type).orDefault()\n          : undefined;\n\n        files.push({ path, contents, contentType });\n        handles.set(path, fileHandle);\n      } else if (handle.kind === 'directory') {\n        const subDirHandle = handle as FileSystemDirectoryHandle;\n        const subPath = this._joinPath(basePath, name);\n        const subResult = await this._loadDirectory<TCT>(subDirHandle, subPath, params);\n        files.push(...subResult.files);\n        for (const [path, fileHandle] of subResult.handles) {\n          handles.set(path, fileHandle);\n        }\n      }\n    }\n\n    return { files, handles };\n  }\n\n  /**\n   * Join path segments.\n   * @param base - The base path.\n   * @param name - The name to append.\n   * @returns The joined path.\n   * @internal\n   */\n  private static _joinPath(base: string, name: string): string {\n    const normalized = base.endsWith('/') ? base.slice(0, -1) : base;\n    return `${normalized}/${name}`;\n  }\n\n  /**\n   * Implements `FileTree.IPersistentFileTreeAccessors.syncToDisk`\n   */\n  public async syncToDisk(): Promise<Result<void>> {\n    if (!this._hasWritePermission) {\n      return fail('Write permission not granted - cannot sync to disk');\n    }\n\n    const errors: string[] = [];\n\n    for (const path of this._dirtyFiles) {\n      const syncResult = await this._syncFile(path);\n      if (syncResult.isFailure()) {\n        errors.push(`${path}: ${syncResult.message}`);\n      }\n    }\n\n    if (errors.length > 0) {\n      return fail(`Failed to sync ${errors.length} file(s):\\n${errors.join('\\n')}`);\n    }\n\n    this._dirtyFiles.clear();\n    return succeed(undefined);\n  }\n\n  /**\n   * Implements `FileTree.IPersistentFileTreeAccessors.isDirty`\n   */\n  public isDirty(): boolean {\n    return this._dirtyFiles.size > 0;\n  }\n\n  /**\n   * Implements `FileTree.IPersistentFileTreeAccessors.getDirtyPaths`\n   */\n  public getDirtyPaths(): string[] {\n    return Array.from(this._dirtyFiles);\n  }\n\n  /**\n   * Implements `FileTree.IMutableFileTreeAccessors.saveFileContents`\n   */\n  public saveFileContents(path: string, contents: string): Result<string> {\n    // Call parent to update in-memory state\n    const result = super.saveFileContents(path, contents);\n\n    if (result.isSuccess() && this._hasWritePermission) {\n      this._dirtyFiles.add(path);\n\n      // Auto-sync if enabled\n      if (this._autoSync) {\n        // Fire and forget - errors logged but don't block\n        this._syncFile(path).catch((err) => {\n          /* c8 ignore next 1 - defensive: async auto-sync error logging */\n          console.error(`Auto-sync failed for ${path}:`, err);\n        });\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Implements `FileTree.IMutableFileTreeAccessors.fileIsMutable`\n   */\n  public fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail> {\n    const baseResult = super.fileIsMutable(path);\n\n    if (baseResult.isSuccess() && baseResult.detail === 'transient' && this._hasWritePermission) {\n      // Upgrade to 'persistent' if we have write permission\n      return succeedWithDetail(true, 'persistent');\n    }\n\n    return baseResult;\n  }\n\n  /**\n   * Sync a single file to disk.\n   * @param path - The path of the file to sync.\n   * @returns Promise resolving to success or failure.\n   * @internal\n   */\n  private async _syncFile(path: string): Promise<Result<void>> {\n    const handle = this._handles.get(path);\n    if (!handle) {\n      return this._createAndWriteFile(path);\n    }\n\n    const contents = this.getFileContents(path);\n    if (contents.isFailure()) {\n      return fail(contents.message);\n    }\n\n    try {\n      const writable = await handle.createWritable();\n      await writable.write(contents.value);\n      await writable.close();\n      return succeed(undefined);\n      /* c8 ignore next 4 - coverage intermittently missed in full suite */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to write file: ${message}`);\n    }\n  }\n\n  /**\n   * Create a new file and write its contents.\n   * @param path - The path of the file to create.\n   * @returns Promise resolving to success or failure.\n   * @internal\n   */\n  private async _createAndWriteFile(path: string): Promise<Result<void>> {\n    try {\n      // Parse path to get directory and filename\n      const absolutePath = this.resolveAbsolutePath(path);\n      const parts = absolutePath.split('/').filter((p) => p.length > 0);\n      const filename = parts.pop();\n\n      /* c8 ignore next 3 - coverage intermittently missed in full suite */\n      if (!filename) {\n        return fail(`Invalid file path: ${path}`);\n      }\n\n      // Navigate/create directory structure\n      let currentDir = this._rootDir;\n      for (const part of parts) {\n        currentDir = await currentDir.getDirectoryHandle(part, { create: true });\n      }\n\n      // Create file and write contents\n      const fileHandle = await currentDir.getFileHandle(filename, { create: true });\n      this._handles.set(path, fileHandle);\n\n      return this._syncFile(path);\n      /* c8 ignore next 4 - coverage intermittently missed in full suite */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to create file ${path}: ${message}`);\n    }\n  }\n}\n"]}

package/lib/packlets/file-tree/index.d.ts

@@ -2,5 +2,8 @@
  * Browser-compatible FileTree implementations using the File API.
  * @packageDocumentation
  */
+export * from './directoryHandleStore';
 export * from './fileApiTreeAccessors';
+export * from './fileSystemAccessTreeAccessors';
+export * from './localStorageTreeAccessors';
 //# sourceMappingURL=index.d.ts.map

package/lib/packlets/file-tree/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC"}

package/lib/packlets/file-tree/index.js

@@ -39,5 +39,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Browser-compatible FileTree implementations using the File API.
  * @packageDocumentation
  */
+__exportStar(require("./directoryHandleStore"), exports);
 __exportStar(require("./fileApiTreeAccessors"), exports);
+__exportStar(require("./fileSystemAccessTreeAccessors"), exports);
+__exportStar(require("./localStorageTreeAccessors"), exports);
 //# sourceMappingURL=index.js.map

package/lib/packlets/file-tree/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH;;;GAGG;AAEH,yDAAuC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Browser-compatible FileTree implementations using the File API.\n * @packageDocumentation\n */\n\nexport * from './fileApiTreeAccessors';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH;;;GAGG;AAEH,yDAAuC;AACvC,yDAAuC;AACvC,kEAAgD;AAChD,8DAA4C","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Browser-compatible FileTree implementations using the File API.\n * @packageDocumentation\n */\n\nexport * from './directoryHandleStore';\nexport * from './fileApiTreeAccessors';\nexport * from './fileSystemAccessTreeAccessors';\nexport * from './localStorageTreeAccessors';\n"]}

package/lib/packlets/file-tree/localStorageTreeAccessors.d.ts

@@ -0,0 +1,129 @@
+import { DetailedResult, Result } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+/**
+ * Configuration for LocalStorageTreeAccessors.
+ * @public
+ */
+export interface ILocalStorageTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
+    /**
+     * Map of directory path prefixes to localStorage keys.
+     * Files under each prefix are stored in the corresponding localStorage key.
+     * Example: \{ '/data/ingredients': 'myapp:ingredients:v1' \}
+     */
+    pathToKeyMap: Record<string, string>;
+    /**
+     * Storage instance to use. Defaults to window.localStorage.
+     * Can be overridden for testing with mock storage.
+     */
+    storage?: Storage;
+    /**
+     * If true, automatically sync changes to localStorage on every modification.
+     * If false (default), changes are only synced when syncToDisk() is called.
+     */
+    autoSync?: boolean;
+}
+/**
+ * Browser localStorage-backed file tree accessors with persistence support.
+ *
+ * Maps filesystem-like directory paths to localStorage keys, where each key stores
+ * multiple collections as a JSON object. This provides a general-purpose implementation
+ * for browser-based file tree persistence without requiring File System Access API.
+ *
+ * Storage format per key: `{ "collection-id": "<raw file content>" }`
+ * File paths map as: `/data/ingredients/collection-id.yaml` → stored in key for `/data/ingredients`
+ *
+ * Legacy format (v1): `{ "collection-id": { ...parsedJsonObject } }` is auto-migrated on load.
+ *
+ * @public
+ */
+export declare class LocalStorageTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
+    private readonly _storage;
+    private readonly _pathToKeyMap;
+    private readonly _keyToPathMap;
+    private readonly _dirtyFiles;
+    private readonly _autoSync;
+    /**
+     * Private constructor. Use fromStorage() factory method instead.
+     * @internal
+     */
+    private constructor();
+    /**
+     * Create LocalStorageTreeAccessors from browser localStorage.
+     * Loads all collections from the configured storage keys.
+     *
+     * @param params - Configuration including path-to-key mappings
+     * @returns Result containing the accessors or an error
+     * @public
+     */
+    static fromStorage<TCT extends string = string>(params: ILocalStorageTreeParams<TCT>): Result<LocalStorageTreeAccessors<TCT>>;
+    /**
+     * Load all files from localStorage based on path-to-key mappings.
+     * @internal
+     */
+    private static _loadFromStorage;
+    /**
+     * Heuristic check: does the content look like JSON?
+     * @internal
+     */
+    private static _looksLikeJson;
+    /**
+     * Join path components, handling leading/trailing slashes.
+     * @internal
+     */
+    private static _joinPath;
+    /**
+     * Get the storage key for a given file path.
+     * @internal
+     */
+    private _getStorageKeyForPath;
+    /**
+     * Get the data path prefix for a given file path.
+     * @internal
+     */
+    private _getDataPathForPath;
+    /**
+     * Extract collection ID from a file path.
+     * Example: '/data/ingredients/my-collection.yaml' → 'my-collection'
+     * @internal
+     */
+    private _getCollectionIdFromPath;
+    /**
+     * Sync a single dirty file to localStorage.
+     * @internal
+     */
+    private _syncFile;
+    /**
+     * Sync all dirty files to localStorage.
+     * @returns Result indicating success or failure
+     * @public
+     */
+    syncToDisk(): Promise<Result<void>>;
+    /**
+     * Check if there are unsaved changes.
+     * @returns True if there are dirty files
+     * @public
+     */
+    isDirty(): boolean;
+    /**
+     * Get list of file paths with unsaved changes.
+     * @returns Array of dirty file paths
+     * @public
+     */
+    getDirtyPaths(): string[];
+    /**
+     * Save file contents. Marks file as dirty and optionally auto-syncs.
+     * @param path - File path
+     * @param contents - New file contents
+     * @returns Result with the saved contents or error
+     * @public
+     */
+    saveFileContents(path: string, contents: string): Result<string>;
+    /**
+     * Check if a file is mutable and return persistence detail.
+     * @param path - File path to check
+     * @returns DetailedResult with mutability status and 'persistent' detail if mutable
+     * @public
+     */
+    fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
+}
+//# sourceMappingURL=localStorageTreeAccessors.d.ts.map

package/lib/packlets/file-tree/localStorageTreeAccessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorageTreeAccessors.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/localStorageTreeAccessors.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,cAAc,EAAQ,MAAM,EAA8B,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAClE,SAAQ,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACzC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAAyB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAChE,SAAQ,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAC1C,YAAW,QAAQ,CAAC,4BAA4B,CAAC,GAAG,CAAC;IAErD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IAEpC;;;OAGG;IACH,OAAO;IAcP;;;;;;;OAOG;WACW,WAAW,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EACnD,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC,GACnC,MAAM,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAkBzC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAuD/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAMxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAehC;;;OAGG;IACH,OAAO,CAAC,SAAS;IAyCjB;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAqBhD;;;;OAIG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,aAAa,IAAI,MAAM,EAAE;IAIhC;;;;;;OAMG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAgBvE;;;;;OAKG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC;CAOjF"}

package/lib/packlets/file-tree/localStorageTreeAccessors.js

@@ -0,0 +1,312 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorageTreeAccessors = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const ts_json_base_2 = require("@fgv/ts-json-base");
+/**
+ * Browser localStorage-backed file tree accessors with persistence support.
+ *
+ * Maps filesystem-like directory paths to localStorage keys, where each key stores
+ * multiple collections as a JSON object. This provides a general-purpose implementation
+ * for browser-based file tree persistence without requiring File System Access API.
+ *
+ * Storage format per key: `{ "collection-id": "<raw file content>" }`
+ * File paths map as: `/data/ingredients/collection-id.yaml` → stored in key for `/data/ingredients`
+ *
+ * Legacy format (v1): `{ "collection-id": { ...parsedJsonObject } }` is auto-migrated on load.
+ *
+ * @public
+ */
+class LocalStorageTreeAccessors extends ts_json_base_1.FileTree.InMemoryTreeAccessors {
+    /**
+     * Private constructor. Use fromStorage() factory method instead.
+     * @internal
+     */
+    constructor(files, storage, pathToKeyMap, params) {
+        var _a;
+        super(files, params);
+        this._storage = storage;
+        this._pathToKeyMap = pathToKeyMap;
+        this._keyToPathMap = new Map(Array.from(pathToKeyMap.entries()).map(([k, v]) => [v, k]));
+        this._dirtyFiles = new Set();
+        this._autoSync = (_a = params === null || params === void 0 ? void 0 : params.autoSync) !== null && _a !== void 0 ? _a : false;
+    }
+    /**
+     * Create LocalStorageTreeAccessors from browser localStorage.
+     * Loads all collections from the configured storage keys.
+     *
+     * @param params - Configuration including path-to-key mappings
+     * @returns Result containing the accessors or an error
+     * @public
+     */
+    static fromStorage(params) {
+        var _a;
+        try {
+            const storage = (_a = params.storage) !== null && _a !== void 0 ? _a : (typeof window !== 'undefined' ? window.localStorage : undefined);
+            if (!storage) {
+                return (0, ts_utils_1.fail)('localStorage is not available');
+            }
+            const pathToKeyMap = new Map(Object.entries(params.pathToKeyMap));
+            const files = this._loadFromStorage(storage, pathToKeyMap, params);
+            return (0, ts_utils_1.succeed)(new LocalStorageTreeAccessors(files, storage, pathToKeyMap, params));
+            /* c8 ignore next 4 - defensive: outer catch for unexpected errors */
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return (0, ts_utils_1.fail)(`Failed to create LocalStorageTreeAccessors: ${message}`);
+        }
+    }
+    /**
+     * Load all files from localStorage based on path-to-key mappings.
+     * @internal
+     */
+    static _loadFromStorage(storage, pathToKeyMap, params) {
+        const files = [];
+        for (const [dataPath, storageKey] of pathToKeyMap.entries()) {
+            const rawJson = storage.getItem(storageKey);
+            if (!rawJson) {
+                continue;
+            }
+            try {
+                const parsed = JSON.parse(rawJson);
+                if (!(0, ts_json_base_2.isJsonObject)(parsed)) {
+                    continue;
+                }
+                for (const [collectionId, contents] of Object.entries(parsed)) {
+                    // Support both new format (string values) and legacy format (JsonObject values)
+                    let rawContent;
+                    let extension;
+                    if (typeof contents === 'string') {
+                        rawContent = contents;
+                        // Infer extension: if content looks like JSON, use .json; otherwise .yaml
+                        extension = this._looksLikeJson(contents) ? '.json' : '.yaml';
+                    }
+                    else if ((0, ts_json_base_2.isJsonObject)(contents)) {
+                        // Legacy format: migrate by stringifying
+                        rawContent = JSON.stringify(contents);
+                        extension = '.json';
+                    }
+                    else {
+                        continue;
+                    }
+                    const filePath = this._joinPath(dataPath, `${collectionId}${extension}`);
+                    const contentType = (params === null || params === void 0 ? void 0 : params.inferContentType)
+                        ? params.inferContentType(filePath, undefined).orDefault()
+                        : undefined;
+                    files.push({
+                        path: filePath,
+                        contents: rawContent,
+                        contentType
+                    });
+                }
+            }
+            catch (_a) {
+                // Skip corrupted data
+                continue;
+            }
+        }
+        return files;
+    }
+    /**
+     * Heuristic check: does the content look like JSON?
+     * @internal
+     */
+    static _looksLikeJson(content) {
+        const trimmed = content.trimStart();
+        return trimmed.startsWith('{') || trimmed.startsWith('[');
+    }
+    /**
+     * Join path components, handling leading/trailing slashes.
+     * @internal
+     */
+    static _joinPath(base, name) {
+        const cleanBase = base.endsWith('/') ? base.slice(0, -1) : base;
+        const cleanName = name.startsWith('/') ? name.slice(1) : name;
+        return `${cleanBase}/${cleanName}`;
+    }
+    /**
+     * Get the storage key for a given file path.
+     * @internal
+     */
+    _getStorageKeyForPath(path) {
+        // Find the longest matching prefix
+        let bestMatch;
+        for (const [prefix, key] of this._pathToKeyMap.entries()) {
+            if (path.startsWith(prefix)) {
+                if (!bestMatch || prefix.length > bestMatch.prefix.length) {
+                    bestMatch = { prefix, key };
+                }
+            }
+        }
+        return bestMatch === null || bestMatch === void 0 ? void 0 : bestMatch.key;
+    }
+    /**
+     * Get the data path prefix for a given file path.
+     * @internal
+     */
+    _getDataPathForPath(path) {
+        for (const prefix of this._pathToKeyMap.keys()) {
+            if (path.startsWith(prefix)) {
+                return prefix;
+            }
+        }
+        /* c8 ignore next 2 - coverage intermittently missed in full suite */
+        return undefined;
+    }
+    /**
+     * Extract collection ID from a file path.
+     * Example: '/data/ingredients/my-collection.yaml' → 'my-collection'
+     * @internal
+     */
+    _getCollectionIdFromPath(path) {
+        const dataPath = this._getDataPathForPath(path);
+        /* c8 ignore next 3 - coverage intermittently missed in full suite */
+        if (!dataPath) {
+            return path;
+        }
+        const relativePath = path.slice(dataPath.length);
+        const cleanPath = relativePath.startsWith('/') ? relativePath.slice(1) : relativePath;
+        // Remove any file extension
+        const dotIndex = cleanPath.lastIndexOf('.');
+        return dotIndex > 0 ? cleanPath.slice(0, dotIndex) : cleanPath;
+    }
+    /**
+     * Sync a single dirty file to localStorage.
+     * @internal
+     */
+    _syncFile(path) {
+        const storageKey = this._getStorageKeyForPath(path);
+        if (!storageKey) {
+            return (0, ts_utils_1.fail)(`No storage key configured for path: ${path}`);
+        }
+        const collectionId = this._getCollectionIdFromPath(path);
+        const contentsResult = this.getFileContents(path);
+        if (contentsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(`Failed to get file contents for ${path}: ${contentsResult.message}`);
+        }
+        try {
+            const contents = contentsResult.value;
+            // Load existing data from storage
+            const existingJson = this._storage.getItem(storageKey);
+            let existing = {};
+            if (existingJson) {
+                try {
+                    const parsed = JSON.parse(existingJson);
+                    if ((0, ts_json_base_2.isJsonObject)(parsed)) {
+                        existing = parsed;
+                    }
+                }
+                catch (_a) {
+                    // Start fresh if corrupted
+                }
+            }
+            // Store raw content string (content-agnostic: JSON, YAML, etc.)
+            existing[collectionId] = contents;
+            this._storage.setItem(storageKey, JSON.stringify(existing));
+            return (0, ts_utils_1.succeed)(undefined);
+            /* c8 ignore next 4 - defensive: only triggers on storage quota or similar runtime errors */
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return (0, ts_utils_1.fail)(`Failed to sync file ${path}: ${message}`);
+        }
+    }
+    /**
+     * Sync all dirty files to localStorage.
+     * @returns Result indicating success or failure
+     * @public
+     */
+    async syncToDisk() {
+        if (this._dirtyFiles.size === 0) {
+            return (0, ts_utils_1.succeed)(undefined);
+        }
+        const errors = [];
+        for (const path of this._dirtyFiles) {
+            const result = this._syncFile(path);
+            if (result.isFailure()) {
+                errors.push(result.message);
+            }
+        }
+        if (errors.length > 0) {
+            return (0, ts_utils_1.fail)(`Failed to sync ${errors.length} file(s): ${errors.join('; ')}`);
+        }
+        this._dirtyFiles.clear();
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    /**
+     * Check if there are unsaved changes.
+     * @returns True if there are dirty files
+     * @public
+     */
+    isDirty() {
+        return this._dirtyFiles.size > 0;
+    }
+    /**
+     * Get list of file paths with unsaved changes.
+     * @returns Array of dirty file paths
+     * @public
+     */
+    getDirtyPaths() {
+        return Array.from(this._dirtyFiles);
+    }
+    /**
+     * Save file contents. Marks file as dirty and optionally auto-syncs.
+     * @param path - File path
+     * @param contents - New file contents
+     * @returns Result with the saved contents or error
+     * @public
+     */
+    saveFileContents(path, contents) {
+        const result = super.saveFileContents(path, contents);
+        if (result.isSuccess()) {
+            this._dirtyFiles.add(path);
+            if (this._autoSync) {
+                const syncResult = this._syncFile(path);
+                if (syncResult.isSuccess()) {
+                    this._dirtyFiles.delete(path);
+                }
+                else {
+                    return (0, ts_utils_1.fail)(syncResult.message);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Check if a file is mutable and return persistence detail.
+     * @param path - File path to check
+     * @returns DetailedResult with mutability status and 'persistent' detail if mutable
+     * @public
+     */
+    fileIsMutable(path) {
+        const baseResult = super.fileIsMutable(path);
+        if (baseResult.isSuccess() && baseResult.value === true) {
+            return (0, ts_utils_1.succeedWithDetail)(true, 'persistent');
+        }
+        return baseResult;
+    }
+}
+exports.LocalStorageTreeAccessors = LocalStorageTreeAccessors;
+//# sourceMappingURL=localStorageTreeAccessors.js.map

package/lib/packlets/file-tree/localStorageTreeAccessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorageTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/localStorageTreeAccessors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAyF;AACzF,oDAA6C;AAC7C,oDAAkE;AA4BlE;;;;;;;;;;;;;GAaG;AACH,MAAa,yBACX,SAAQ,uBAAQ,CAAC,qBAA0B;IAS3C;;;OAGG;IACH,YACE,KAAoC,EACpC,OAAgB,EAChB,YAAiC,EACjC,MAAqC;;QAErC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,mCAAI,KAAK,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,WAAW,CACvB,MAAoC;;QAEpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAA,MAAM,CAAC,OAAO,mCAAI,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACpG,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,IAAA,eAAI,EAAC,+BAA+B,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAM,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;YAExE,OAAO,IAAA,kBAAO,EAAC,IAAI,yBAAyB,CAAM,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;YACzF,qEAAqE;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAA,eAAI,EAAC,+CAA+C,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,gBAAgB,CAC7B,OAAgB,EAChB,YAAiC,EACjC,MAAqC;QAErC,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,CAAC,IAAA,2BAAY,EAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,SAAS;gBACX,CAAC;gBAED,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC9D,gFAAgF;oBAChF,IAAI,UAAkB,CAAC;oBACvB,IAAI,SAAiB,CAAC;oBACtB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;wBACjC,UAAU,GAAG,QAAQ,CAAC;wBACtB,0EAA0E;wBAC1E,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;oBAChE,CAAC;yBAAM,IAAI,IAAA,2BAAY,EAAC,QAAQ,CAAC,EAAE,CAAC;wBAClC,yCAAyC;wBACzC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;wBACtC,SAAS,GAAG,OAAO,CAAC;oBACtB,CAAC;yBAAM,CAAC;wBACN,SAAS;oBACX,CAAC;oBAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,YAAY,GAAG,SAAS,EAAE,CAAC,CAAC;oBACzE,MAAM,WAAW,GAAG,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB;wBAC1C,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,SAAS,EAAE;wBAC1D,CAAC,CAAC,SAAS,CAAC;oBAEd,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,UAAU;wBACpB,WAAW;qBACZ,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,WAAM,CAAC;gBACP,sBAAsB;gBACtB,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,cAAc,CAAC,OAAe;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,SAAS,CAAC,IAAY,EAAE,IAAY;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,OAAO,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;IACrC,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,IAAY;QACxC,mCAAmC;QACnC,IAAI,SAAsD,CAAC;QAC3D,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBAC1D,SAAS,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,GAAG,CAAC;IACxB,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,IAAY;QACtC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,qEAAqE;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACK,wBAAwB,CAAC,IAAY;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAChD,qEAAqE;QACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAEtF,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,IAAY;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAA,eAAI,EAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAA,eAAI,EAAC,mCAAmC,IAAI,KAAK,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC;YAEtC,kCAAkC;YAClC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACvD,IAAI,QAAQ,GAA4B,EAAE,CAAC;YAC3C,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;oBACxC,IAAI,IAAA,2BAAY,EAAC,MAAM,CAAC,EAAE,CAAC;wBACzB,QAAQ,GAAG,MAAiC,CAAC;oBAC/C,CAAC;gBACH,CAAC;gBAAC,WAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;YACH,CAAC;YAED,gEAAgE;YAChE,QAAQ,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE5D,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;YAC1B,4FAA4F;QAC9F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAA,eAAI,EAAC,uBAAuB,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,IAAA,eAAI,EAAC,kBAAkB,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACI,gBAAgB,CAAC,IAAY,EAAE,QAAgB;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC3B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAA,eAAI,EAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,IAAY;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,SAAS,EAAE,IAAI,UAAU,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,IAAA,4BAAiB,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAtTD,8DAsTC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { DetailedResult, fail, Result, succeed, succeedWithDetail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { isJsonObject, type JsonObject } from '@fgv/ts-json-base';\n\n/**\n * Configuration for LocalStorageTreeAccessors.\n * @public\n */\nexport interface ILocalStorageTreeParams<TCT extends string = string>\n  extends FileTree.IFileTreeInitParams<TCT> {\n  /**\n   * Map of directory path prefixes to localStorage keys.\n   * Files under each prefix are stored in the corresponding localStorage key.\n   * Example: \\{ '/data/ingredients': 'myapp:ingredients:v1' \\}\n   */\n  pathToKeyMap: Record<string, string>;\n\n  /**\n   * Storage instance to use. Defaults to window.localStorage.\n   * Can be overridden for testing with mock storage.\n   */\n  storage?: Storage;\n\n  /**\n   * If true, automatically sync changes to localStorage on every modification.\n   * If false (default), changes are only synced when syncToDisk() is called.\n   */\n  autoSync?: boolean;\n}\n\n/**\n * Browser localStorage-backed file tree accessors with persistence support.\n *\n * Maps filesystem-like directory paths to localStorage keys, where each key stores\n * multiple collections as a JSON object. This provides a general-purpose implementation\n * for browser-based file tree persistence without requiring File System Access API.\n *\n * Storage format per key: `{ \"collection-id\": \"<raw file content>\" }`\n * File paths map as: `/data/ingredients/collection-id.yaml` → stored in key for `/data/ingredients`\n *\n * Legacy format (v1): `{ \"collection-id\": { ...parsedJsonObject } }` is auto-migrated on load.\n *\n * @public\n */\nexport class LocalStorageTreeAccessors<TCT extends string = string>\n  extends FileTree.InMemoryTreeAccessors<TCT>\n  implements FileTree.IPersistentFileTreeAccessors<TCT>\n{\n  private readonly _storage: Storage;\n  private readonly _pathToKeyMap: Map<string, string>;\n  private readonly _keyToPathMap: Map<string, string>;\n  private readonly _dirtyFiles: Set<string>;\n  private readonly _autoSync: boolean;\n\n  /**\n   * Private constructor. Use fromStorage() factory method instead.\n   * @internal\n   */\n  private constructor(\n    files: FileTree.IInMemoryFile<TCT>[],\n    storage: Storage,\n    pathToKeyMap: Map<string, string>,\n    params?: ILocalStorageTreeParams<TCT>\n  ) {\n    super(files, params);\n    this._storage = storage;\n    this._pathToKeyMap = pathToKeyMap;\n    this._keyToPathMap = new Map(Array.from(pathToKeyMap.entries()).map(([k, v]) => [v, k]));\n    this._dirtyFiles = new Set();\n    this._autoSync = params?.autoSync ?? false;\n  }\n\n  /**\n   * Create LocalStorageTreeAccessors from browser localStorage.\n   * Loads all collections from the configured storage keys.\n   *\n   * @param params - Configuration including path-to-key mappings\n   * @returns Result containing the accessors or an error\n   * @public\n   */\n  public static fromStorage<TCT extends string = string>(\n    params: ILocalStorageTreeParams<TCT>\n  ): Result<LocalStorageTreeAccessors<TCT>> {\n    try {\n      const storage = params.storage ?? (typeof window !== 'undefined' ? window.localStorage : undefined);\n      if (!storage) {\n        return fail('localStorage is not available');\n      }\n\n      const pathToKeyMap = new Map(Object.entries(params.pathToKeyMap));\n      const files = this._loadFromStorage<TCT>(storage, pathToKeyMap, params);\n\n      return succeed(new LocalStorageTreeAccessors<TCT>(files, storage, pathToKeyMap, params));\n      /* c8 ignore next 4 - defensive: outer catch for unexpected errors */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to create LocalStorageTreeAccessors: ${message}`);\n    }\n  }\n\n  /**\n   * Load all files from localStorage based on path-to-key mappings.\n   * @internal\n   */\n  private static _loadFromStorage<TCT extends string = string>(\n    storage: Storage,\n    pathToKeyMap: Map<string, string>,\n    params?: ILocalStorageTreeParams<TCT>\n  ): FileTree.IInMemoryFile<TCT>[] {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (const [dataPath, storageKey] of pathToKeyMap.entries()) {\n      const rawJson = storage.getItem(storageKey);\n      if (!rawJson) {\n        continue;\n      }\n\n      try {\n        const parsed: unknown = JSON.parse(rawJson);\n        if (!isJsonObject(parsed)) {\n          continue;\n        }\n\n        for (const [collectionId, contents] of Object.entries(parsed)) {\n          // Support both new format (string values) and legacy format (JsonObject values)\n          let rawContent: string;\n          let extension: string;\n          if (typeof contents === 'string') {\n            rawContent = contents;\n            // Infer extension: if content looks like JSON, use .json; otherwise .yaml\n            extension = this._looksLikeJson(contents) ? '.json' : '.yaml';\n          } else if (isJsonObject(contents)) {\n            // Legacy format: migrate by stringifying\n            rawContent = JSON.stringify(contents);\n            extension = '.json';\n          } else {\n            continue;\n          }\n\n          const filePath = this._joinPath(dataPath, `${collectionId}${extension}`);\n          const contentType = params?.inferContentType\n            ? params.inferContentType(filePath, undefined).orDefault()\n            : undefined;\n\n          files.push({\n            path: filePath,\n            contents: rawContent,\n            contentType\n          });\n        }\n      } catch {\n        // Skip corrupted data\n        continue;\n      }\n    }\n\n    return files;\n  }\n\n  /**\n   * Heuristic check: does the content look like JSON?\n   * @internal\n   */\n  private static _looksLikeJson(content: string): boolean {\n    const trimmed = content.trimStart();\n    return trimmed.startsWith('{') || trimmed.startsWith('[');\n  }\n\n  /**\n   * Join path components, handling leading/trailing slashes.\n   * @internal\n   */\n  private static _joinPath(base: string, name: string): string {\n    const cleanBase = base.endsWith('/') ? base.slice(0, -1) : base;\n    const cleanName = name.startsWith('/') ? name.slice(1) : name;\n    return `${cleanBase}/${cleanName}`;\n  }\n\n  /**\n   * Get the storage key for a given file path.\n   * @internal\n   */\n  private _getStorageKeyForPath(path: string): string | undefined {\n    // Find the longest matching prefix\n    let bestMatch: { prefix: string; key: string } | undefined;\n    for (const [prefix, key] of this._pathToKeyMap.entries()) {\n      if (path.startsWith(prefix)) {\n        if (!bestMatch || prefix.length > bestMatch.prefix.length) {\n          bestMatch = { prefix, key };\n        }\n      }\n    }\n    return bestMatch?.key;\n  }\n\n  /**\n   * Get the data path prefix for a given file path.\n   * @internal\n   */\n  private _getDataPathForPath(path: string): string | undefined {\n    for (const prefix of this._pathToKeyMap.keys()) {\n      if (path.startsWith(prefix)) {\n        return prefix;\n      }\n    }\n    /* c8 ignore next 2 - coverage intermittently missed in full suite */\n    return undefined;\n  }\n\n  /**\n   * Extract collection ID from a file path.\n   * Example: '/data/ingredients/my-collection.yaml' → 'my-collection'\n   * @internal\n   */\n  private _getCollectionIdFromPath(path: string): string {\n    const dataPath = this._getDataPathForPath(path);\n    /* c8 ignore next 3 - coverage intermittently missed in full suite */\n    if (!dataPath) {\n      return path;\n    }\n\n    const relativePath = path.slice(dataPath.length);\n    const cleanPath = relativePath.startsWith('/') ? relativePath.slice(1) : relativePath;\n\n    // Remove any file extension\n    const dotIndex = cleanPath.lastIndexOf('.');\n    return dotIndex > 0 ? cleanPath.slice(0, dotIndex) : cleanPath;\n  }\n\n  /**\n   * Sync a single dirty file to localStorage.\n   * @internal\n   */\n  private _syncFile(path: string): Result<void> {\n    const storageKey = this._getStorageKeyForPath(path);\n    if (!storageKey) {\n      return fail(`No storage key configured for path: ${path}`);\n    }\n\n    const collectionId = this._getCollectionIdFromPath(path);\n    const contentsResult = this.getFileContents(path);\n    if (contentsResult.isFailure()) {\n      return fail(`Failed to get file contents for ${path}: ${contentsResult.message}`);\n    }\n\n    try {\n      const contents = contentsResult.value;\n\n      // Load existing data from storage\n      const existingJson = this._storage.getItem(storageKey);\n      let existing: Record<string, unknown> = {};\n      if (existingJson) {\n        try {\n          const parsed = JSON.parse(existingJson);\n          if (isJsonObject(parsed)) {\n            existing = parsed as Record<string, unknown>;\n          }\n        } catch {\n          // Start fresh if corrupted\n        }\n      }\n\n      // Store raw content string (content-agnostic: JSON, YAML, etc.)\n      existing[collectionId] = contents;\n      this._storage.setItem(storageKey, JSON.stringify(existing));\n\n      return succeed(undefined);\n      /* c8 ignore next 4 - defensive: only triggers on storage quota or similar runtime errors */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to sync file ${path}: ${message}`);\n    }\n  }\n\n  /**\n   * Sync all dirty files to localStorage.\n   * @returns Result indicating success or failure\n   * @public\n   */\n  public async syncToDisk(): Promise<Result<void>> {\n    if (this._dirtyFiles.size === 0) {\n      return succeed(undefined);\n    }\n\n    const errors: string[] = [];\n    for (const path of this._dirtyFiles) {\n      const result = this._syncFile(path);\n      if (result.isFailure()) {\n        errors.push(result.message);\n      }\n    }\n\n    if (errors.length > 0) {\n      return fail(`Failed to sync ${errors.length} file(s): ${errors.join('; ')}`);\n    }\n\n    this._dirtyFiles.clear();\n    return succeed(undefined);\n  }\n\n  /**\n   * Check if there are unsaved changes.\n   * @returns True if there are dirty files\n   * @public\n   */\n  public isDirty(): boolean {\n    return this._dirtyFiles.size > 0;\n  }\n\n  /**\n   * Get list of file paths with unsaved changes.\n   * @returns Array of dirty file paths\n   * @public\n   */\n  public getDirtyPaths(): string[] {\n    return Array.from(this._dirtyFiles);\n  }\n\n  /**\n   * Save file contents. Marks file as dirty and optionally auto-syncs.\n   * @param path - File path\n   * @param contents - New file contents\n   * @returns Result with the saved contents or error\n   * @public\n   */\n  public saveFileContents(path: string, contents: string): Result<string> {\n    const result = super.saveFileContents(path, contents);\n    if (result.isSuccess()) {\n      this._dirtyFiles.add(path);\n      if (this._autoSync) {\n        const syncResult = this._syncFile(path);\n        if (syncResult.isSuccess()) {\n          this._dirtyFiles.delete(path);\n        } else {\n          return fail(syncResult.message);\n        }\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Check if a file is mutable and return persistence detail.\n   * @param path - File path to check\n   * @returns DetailedResult with mutability status and 'persistent' detail if mutable\n   * @public\n   */\n  public fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail> {\n    const baseResult = super.fileIsMutable(path);\n    if (baseResult.isSuccess() && baseResult.value === true) {\n      return succeedWithDetail(true, 'persistent');\n    }\n    return baseResult;\n  }\n}\n"]}

package/lib/test/mocks/idb-keyval.d.ts

@@ -0,0 +1,6 @@
+export declare const createStore: jest.Mock<{}, [], any>;
+export declare const get: jest.Mock<any, any, any>;
+export declare const set: jest.Mock<any, any, any>;
+export declare const del: jest.Mock<any, any, any>;
+export declare const keys: jest.Mock<any, any, any>;
+//# sourceMappingURL=idb-keyval.d.ts.map

package/lib/test/mocks/idb-keyval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-keyval.d.ts","sourceRoot":"","sources":["../../../src/test/mocks/idb-keyval.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,wBAAsB,CAAC;AAC/C,eAAO,MAAM,GAAG,0BAAY,CAAC;AAC7B,eAAO,MAAM,GAAG,0BAAY,CAAC;AAC7B,eAAO,MAAM,GAAG,0BAAY,CAAC;AAC7B,eAAO,MAAM,IAAI,0BAAY,CAAC"}

package/lib/test/mocks/idb-keyval.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keys = exports.del = exports.set = exports.get = exports.createStore = void 0;
+exports.createStore = jest.fn(() => ({}));
+exports.get = jest.fn();
+exports.set = jest.fn();
+exports.del = jest.fn();
+exports.keys = jest.fn();
+//# sourceMappingURL=idb-keyval.js.map

package/lib/test/mocks/idb-keyval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-keyval.js","sourceRoot":"","sources":["../../../src/test/mocks/idb-keyval.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClC,QAAA,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAChB,QAAA,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAChB,QAAA,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAChB,QAAA,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC","sourcesContent":["export const createStore = jest.fn(() => ({}));\nexport const get = jest.fn();\nexport const set = jest.fn();\nexport const del = jest.fn();\nexport const keys = jest.fn();\n"]}