@fgv/ts-web-extras 5.1.0-4 → 5.1.0-41

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

@@ -1 +1 @@
-{"version":3,"file":"localStorageTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/localStorageTreeAccessors.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 { 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    /* c8 ignore next 1 - intermittent branch coverage: ?? false branch when params is undefined */\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      /* c8 ignore next 1 - intermittent branch coverage: window.localStorage branch when params.storage is undefined */\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          /* c8 ignore next 3 - intermittent branch coverage: ternary branches in tight loop */\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    /* c8 ignore next 2 - intermittent branch coverage: slash-trimming edge cases */\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        /* c8 ignore next 1 - intermittent: overlapping-prefix branch requires two matching prefixes in iteration order */\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    /* c8 ignore next 1 - defensive: relativePath always starts with / when paths are absolute */\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   * Remove a file's entry from its localStorage key.\n   * @internal\n   */\n  private _deleteFileFromStorage(path: string): void {\n    const storageKey = this._getStorageKeyForPath(path);\n    if (!storageKey) {\n      return;\n    }\n\n    const collectionId = this._getCollectionIdFromPath(path);\n    const existingJson = this._storage.getItem(storageKey);\n    if (!existingJson) {\n      return;\n    }\n\n    try {\n      const parsed = JSON.parse(existingJson);\n      if (isJsonObject(parsed)) {\n        const existing = parsed as Record<string, unknown>;\n        delete existing[collectionId];\n        if (Object.keys(existing).length > 0) {\n          this._storage.setItem(storageKey, JSON.stringify(existing));\n        } else {\n          this._storage.removeItem(storageKey);\n        }\n      }\n    } catch {\n      // Storage is corrupted — nothing to clean up\n    }\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   * Delete a file and remove it from localStorage.\n   * @param path - File path to delete\n   * @returns Result with true if deleted, or error\n   * @public\n   */\n  public deleteFile(path: string): Result<boolean> {\n    const result = super.deleteFile(path);\n    if (result.isSuccess()) {\n      this._dirtyFiles.delete(path);\n      this._deleteFileFromStorage(path);\n    }\n    return result;\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"]}
+{"version":3,"file":"localStorageTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/localStorageTreeAccessors.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 { DetailedResult, fail, Result, succeed, succeedWithDetail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { isJsonObject } 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    /* c8 ignore next 1 - intermittent branch coverage: ?? false branch when params is undefined */\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      /* c8 ignore next 1 - intermittent branch coverage: window.localStorage branch when params.storage is undefined */\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          /* c8 ignore next 3 - intermittent branch coverage: ternary branches in tight loop */\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    /* c8 ignore next 2 - intermittent branch coverage: slash-trimming edge cases */\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        /* c8 ignore next 1 - intermittent: overlapping-prefix branch requires two matching prefixes in iteration order */\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    /* c8 ignore next 1 - defensive: relativePath always starts with / when paths are absolute */\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   * Remove a file's entry from its localStorage key.\n   * @internal\n   */\n  private _deleteFileFromStorage(path: string): void {\n    const storageKey = this._getStorageKeyForPath(path);\n    if (!storageKey) {\n      return;\n    }\n\n    const collectionId = this._getCollectionIdFromPath(path);\n    const existingJson = this._storage.getItem(storageKey);\n    if (!existingJson) {\n      return;\n    }\n\n    try {\n      const parsed = JSON.parse(existingJson);\n      if (isJsonObject(parsed)) {\n        const existing = parsed as Record<string, unknown>;\n        delete existing[collectionId];\n        if (Object.keys(existing).length > 0) {\n          this._storage.setItem(storageKey, JSON.stringify(existing));\n        } else {\n          this._storage.removeItem(storageKey);\n        }\n      }\n    } catch {\n      // Storage is corrupted — nothing to clean up\n    }\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   * Delete a file and remove it from localStorage.\n   * @param path - File path to delete\n   * @returns Result with true if deleted, or error\n   * @public\n   */\n  public deleteFile(path: string): Result<boolean> {\n    const result = super.deleteFile(path);\n    if (result.isSuccess()) {\n      this._dirtyFiles.delete(path);\n      this._deleteFileFromStorage(path);\n    }\n    return result;\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/dist/packlets/helpers/fileTreeHelpers.js

@@ -20,7 +20,7 @@
  * SOFTWARE.
  */
 import { FileTree } from '@fgv/ts-json-base';
-import { FileApiTreeAccessors } from '../file-tree/fileApiTreeAccessors';
+import { FileApiTreeAccessors } from '../file-tree';
 /**
  * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.
  * @public

package/dist/packlets/helpers/fileTreeHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileTreeHelpers.js","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAiB,MAAM,mCAAmC,CAAC;AAExF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAyC;IAChF,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,wBAAwB;CAC7D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,4BAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,oBAAoB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,4BAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB,EAAE,IAAY;IAC9D,OAAO,oBAAoB,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAU;IAC5C,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","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\nimport { Result } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { FileApiTreeAccessors, IFileMetadata } from '../file-tree/fileApiTreeAccessors';\n\n/**\n * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.\n * @public\n */\nexport const defaultFileApiTreeInitParams: FileTree.IFileTreeInitParams<string> = {\n  inferContentType: FileTree.FileItem.defaultAcceptContentType\n};\n\n/**\n * Helper function to create a new FileTree instance\n * from a browser FileList (e.g., from input[type=\"file\"]).\n * @param fileList - FileList from a file input element\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromFileList(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromFileList(fileList, params);\n}\n\n/**\n * Helper function to create a new FileTree instance\n * from a directory upload with webkitRelativePath support.\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * is used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromDirectoryUpload(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromDirectoryUpload(fileList, params);\n}\n\n/**\n * Helper function to get the original File object from a FileList by path.\n * @param fileList - The original FileList\n * @param path - The path to the file\n * @returns A successful Result with the File object if found,\n * or a failed Result with an error message otherwise\n * @public\n */\nexport function getOriginalFile(fileList: FileList, path: string): Result<File> {\n  return FileApiTreeAccessors.getOriginalFile(fileList, path);\n}\n\n/**\n * Helper function to extract metadata from a `FileList`.\n * @param fileList - The `FileList` to extract metadata from\n * @returns Array of {@link IFileMetadata | file metadata} objects\n * @public\n */\nexport function extractFileListMetadata(fileList: FileList): Array<IFileMetadata> {\n  return Array.from(fileList).map((f) => FileApiTreeAccessors.extractFileMetadata(f));\n}\n\n/**\n * Helper function to extract metadata from a `File`.\n * @param file - The File to extract metadata from\n * @returns {@link IFileMetadata | file metadata} object\n * @public\n */\nexport function extractFileMetadata(file: File): IFileMetadata {\n  return FileApiTreeAccessors.extractFileMetadata(file);\n}\n"]}
+{"version":3,"file":"fileTreeHelpers.js","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAiB,MAAM,cAAc,CAAC;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAyC;IAChF,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,wBAAwB;CAC7D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,4BAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,oBAAoB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,4BAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB,EAAE,IAAY;IAC9D,OAAO,oBAAoB,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAU;IAC5C,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","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\nimport { Result } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { FileApiTreeAccessors, IFileMetadata } from '../file-tree';\n\n/**\n * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.\n * @public\n */\nexport const defaultFileApiTreeInitParams: FileTree.IFileTreeInitParams<string> = {\n  inferContentType: FileTree.FileItem.defaultAcceptContentType\n};\n\n/**\n * Helper function to create a new FileTree instance\n * from a browser FileList (e.g., from input[type=\"file\"]).\n * @param fileList - FileList from a file input element\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromFileList(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromFileList(fileList, params);\n}\n\n/**\n * Helper function to create a new FileTree instance\n * from a directory upload with webkitRelativePath support.\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * is used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromDirectoryUpload(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromDirectoryUpload(fileList, params);\n}\n\n/**\n * Helper function to get the original File object from a FileList by path.\n * @param fileList - The original FileList\n * @param path - The path to the file\n * @returns A successful Result with the File object if found,\n * or a failed Result with an error message otherwise\n * @public\n */\nexport function getOriginalFile(fileList: FileList, path: string): Result<File> {\n  return FileApiTreeAccessors.getOriginalFile(fileList, path);\n}\n\n/**\n * Helper function to extract metadata from a `FileList`.\n * @param fileList - The `FileList` to extract metadata from\n * @returns Array of {@link IFileMetadata | file metadata} objects\n * @public\n */\nexport function extractFileListMetadata(fileList: FileList): Array<IFileMetadata> {\n  return Array.from(fileList).map((f) => FileApiTreeAccessors.extractFileMetadata(f));\n}\n\n/**\n * Helper function to extract metadata from a `File`.\n * @param file - The File to extract metadata from\n * @returns {@link IFileMetadata | file metadata} object\n * @public\n */\nexport function extractFileMetadata(file: File): IFileMetadata {\n  return FileApiTreeAccessors.extractFileMetadata(file);\n}\n"]}

package/dist/ts-web-extras.d.ts

@@ -14,6 +14,7 @@ import { DetailedResult } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
 import { Logging } from '@fgv/ts-utils';
 import { Result } from '@fgv/ts-utils';
+import { Uuid } from '@fgv/ts-utils';
 
 /**
  * Browser implementation of `ICryptoProvider` using the Web Crypto API.
@@ -24,7 +25,7 @@ import { Result } from '@fgv/ts-utils';
  *
  * @public
  */
-declare class BrowserCryptoProvider implements ICryptoProvider {
+declare class BrowserCryptoProvider implements CryptoUtils_2.ICryptoProvider {
     private readonly _crypto;
     /**
      * Creates a new {@link CryptoUtils.BrowserCryptoProvider | BrowserCryptoProvider}.
@@ -37,7 +38,7 @@ declare class BrowserCryptoProvider implements ICryptoProvider {
      * @param key - 32-byte encryption key
      * @returns `Success` with encryption result, or `Failure` with an error.
      */
-    encrypt(plaintext: string, key: Uint8Array): Promise<Result<IEncryptionResult>>;
+    encrypt(plaintext: string, key: Uint8Array): Promise<Result<CryptoUtils_2.IEncryptionResult>>;
     /**
      * Decrypts ciphertext using AES-256-GCM.
      * @param encryptedData - Encrypted bytes
@@ -60,12 +61,25 @@ declare class BrowserCryptoProvider implements ICryptoProvider {
      * @returns Success with derived 32-byte key, or Failure with error
      */
     deriveKey(password: string, salt: Uint8Array, iterations: number): Promise<Result<Uint8Array>>;
+    /**
+     * Computes a SHA-256 hash of the given data.
+     * @param data - UTF-8 string to hash
+     * @returns `Success` with hex-encoded hash string, or `Failure` with an error.
+     */
+    sha256(data: string): Promise<Result<string>>;
     /**
      * Generates cryptographically secure random bytes.
      * @param length - Number of bytes to generate
      * @returns Success with random bytes, or Failure with error
      */
     generateRandomBytes(length: number): Result<Uint8Array>;
+    /**
+     * Generates a cryptographically random UUIDv4 using the injected
+     * `Crypto` instance.
+     * @returns `Success` with the generated UUID, or `Failure` if the underlying
+     * `Crypto` instance does not expose `randomUUID`.
+     */
+    generateUuid(): Result<Uuid>;
     /**
      * Encodes binary data to base64 string.
      * @param data - Binary data to encode
@@ -78,6 +92,135 @@ declare class BrowserCryptoProvider implements ICryptoProvider {
      * @returns Success with decoded bytes, or Failure if invalid base64
      */
     fromBase64(base64: string): Result<Uint8Array>;
+    /**
+     * Generates a new asymmetric keypair via Web Crypto.
+     * @param algorithm - The algorithm to use.
+     * @param extractable - Whether the resulting keys may be exported.
+     * @returns `Success` with the generated `CryptoKeyPair`, or `Failure` with an error.
+     */
+    generateKeyPair(algorithm: CryptoUtils_2.KeyPairAlgorithm, extractable: boolean): Promise<Result<CryptoKeyPair>>;
+    /**
+     * Exports a public `CryptoKey` as a JSON Web Key.
+     * @remarks
+     * Rejects non-public keys at runtime. WebCrypto's `exportKey('jwk', ...)`
+     * does not enforce public-vs-private; without this guard a caller that
+     * passed an extractable private key would receive its private fields
+     * (`d`, `p`, `q`, ...) as JWK, defeating the method's name.
+     * @param publicKey - Extractable public key to export.
+     * @returns `Success` with the JWK, or `Failure` if not a public key or if export fails.
+     */
+    exportPublicKeyJwk(publicKey: CryptoKey): Promise<Result<JsonWebKey>>;
+    /**
+     * Imports a public-key JWK as a `CryptoKey` for the requested algorithm.
+     * @param jwk - The JSON Web Key produced by a prior export.
+     * @param algorithm - The algorithm the key was generated for.
+     * @returns `Success` with the imported public `CryptoKey`, or `Failure` with an error.
+     */
+    importPublicKeyJwk(jwk: JsonWebKey, algorithm: CryptoUtils_2.KeyPairAlgorithm): Promise<Result<CryptoKey>>;
+    /**
+     * Exports a public `CryptoKey` as a DER-encoded SPKI blob.
+     * @param publicKey - The public `CryptoKey` to export.
+     * @returns `Success` with the raw SPKI bytes, or `Failure` with error context.
+     */
+    exportPublicKeySpki(publicKey: CryptoKey): Promise<Result<Uint8Array>>;
+    /**
+     * Imports a public key from a DER-encoded SPKI blob.
+     * @param spkiBytes - The raw SPKI bytes.
+     * @param algorithm - The algorithm the key was generated for.
+     * @returns `Success` with the imported public `CryptoKey`, or `Failure` with error context.
+     */
+    importPublicKeySpki(spkiBytes: Uint8Array, algorithm: CryptoUtils_2.KeyPairAlgorithm): Promise<Result<CryptoKey>>;
+    /**
+     * Signs `data` with `privateKey` using the algorithm inferred from the key.
+     * @param privateKey - A signing `CryptoKey` (`'ecdsa-p256'` or `'ed25519'`).
+     * @param data - The bytes to sign.
+     * @returns `Success` with the raw signature bytes, or `Failure` with error context.
+     */
+    sign(privateKey: CryptoKey, data: Uint8Array): Promise<Result<Uint8Array>>;
+    /**
+     * Verifies a signature produced by {@link BrowserCryptoProvider.sign}.
+     * @param publicKey - A verify `CryptoKey` (`'ecdsa-p256'` or `'ed25519'`).
+     * @param signature - The raw signature bytes.
+     * @param data - The original data that was signed.
+     * @returns `Success` with `true` if valid, `false` if not, or `Failure` with error context.
+     */
+    verify(publicKey: CryptoKey, signature: Uint8Array, data: Uint8Array): Promise<Result<boolean>>;
+    /**
+     * Compares two byte arrays in constant time.
+     *
+     * Accumulates XOR differences with bitwise-OR; no early-return is possible
+     * once the length check passes, making timing independent of the byte
+     * values. Returns `false` immediately on length mismatch (length is not
+     * secret in normal use).
+     * @param a - First byte array.
+     * @param b - Second byte array.
+     * @returns `true` if lengths match and all bytes are equal, `false` otherwise.
+     */
+    timingSafeEqual(a: Uint8Array, b: Uint8Array): boolean;
+    /**
+     * Computes an HMAC-SHA256 MAC for `data` using `key`.
+     * @param key - An HMAC `CryptoKey` with `'sign'` usage.
+     * @param data - The bytes to authenticate.
+     * @returns `Success` with the 32-byte MAC, or `Failure` with error context.
+     */
+    hmacSha256(key: CryptoKey, data: Uint8Array): Promise<Result<Uint8Array>>;
+    /**
+     * Verifies an HMAC-SHA256 MAC in constant time.
+     * @param key - An HMAC `CryptoKey` with `'sign'` usage.
+     * @param signature - The MAC bytes to verify.
+     * @param data - The original data that was authenticated.
+     * @returns `Success` with `true` if valid, `false` if not, or `Failure` with error context.
+     */
+    verifyHmacSha256(key: CryptoKey, signature: Uint8Array, data: Uint8Array): Promise<Result<boolean>>;
+    /**
+     * Encrypts raw bytes using AES-256-GCM with a caller-supplied nonce and
+     * optional AAD. See {@link CryptoUtils.ICryptoProvider.encryptBytes | ICryptoProvider.encryptBytes}
+     * — in particular the caller's responsibility to use a unique `nonce` per
+     * message under a given `key`.
+     *
+     * Byte-identical to {@link CryptoUtils.NodeCryptoProvider.encryptBytes} for
+     * identical `(key, nonce, plaintext, aad)`: Web Crypto appends the 16-byte tag
+     * to the ciphertext, and this method splits it off so the returned
+     * `ciphertext`/`authTag` match Node's separated-tag layout exactly.
+     * @param key - 32-byte AES-256 key.
+     * @param nonce - 12-byte GCM nonce (must be unique per message under `key`).
+     * @param plaintext - The bytes to encrypt (empty permitted).
+     * @param aad - Optional additional authenticated data bound into the tag.
+     * @returns `Success` with the ciphertext and 16-byte auth tag, or `Failure` with an error.
+     */
+    encryptBytes(key: Uint8Array, nonce: Uint8Array, plaintext: Uint8Array, aad?: Uint8Array): Promise<Result<CryptoUtils_2.IEncryptBytesResult>>;
+    /**
+     * Decrypts raw bytes produced by {@link BrowserCryptoProvider.encryptBytes}
+     * using AES-256-GCM. See
+     * {@link CryptoUtils.ICryptoProvider.decryptBytes | ICryptoProvider.decryptBytes}.
+     * Fails (never throws) on any authentication failure, including a mismatched `aad`.
+     * @param key - 32-byte AES-256 key.
+     * @param nonce - 12-byte GCM nonce (the same one used to encrypt).
+     * @param ciphertext - The ciphertext from the `encryptBytes` result.
+     * @param authTag - The 16-byte GCM auth tag from the `encryptBytes` result.
+     * @param aad - The identical AAD supplied at encrypt time (or absent).
+     * @returns `Success` with the decrypted plaintext bytes, or `Failure` with an error.
+     */
+    decryptBytes(key: Uint8Array, nonce: Uint8Array, ciphertext: Uint8Array, authTag: Uint8Array, aad?: Uint8Array): Promise<Result<Uint8Array>>;
+    /**
+     * Wraps `plaintext` for the holder of `recipientPublicKey` using
+     * ECIES (ECDH P-256 + HKDF-SHA256 + AES-GCM-256). See
+     * {@link CryptoUtils.ICryptoProvider.wrapBytes | ICryptoProvider.wrapBytes}.
+     * @param plaintext - The bytes to wrap.
+     * @param recipientPublicKey - The recipient's ECDH P-256 public `CryptoKey`.
+     * @param options - HKDF salt and info; see {@link CryptoUtils.IWrapBytesOptions | IWrapBytesOptions}.
+     * @returns `Success` with the wrapped payload, or `Failure` with an error.
+     */
+    wrapBytes(plaintext: Uint8Array, recipientPublicKey: CryptoKey, options: CryptoUtils_2.IWrapBytesOptions): Promise<Result<CryptoUtils_2.IWrappedBytes>>;
+    /**
+     * Unwraps a payload produced by `wrapBytes` using the recipient's private
+     * key. See {@link CryptoUtils.ICryptoProvider.unwrapBytes | ICryptoProvider.unwrapBytes}.
+     * @param wrapped - The wrapped payload.
+     * @param recipientPrivateKey - The recipient's ECDH P-256 private `CryptoKey`.
+     * @param options - HKDF salt and info matching the wrap call.
+     * @returns `Success` with the original `plaintext`, or `Failure` with an error.
+     */
+    unwrapBytes(wrapped: CryptoUtils_2.IWrappedBytes, recipientPrivateKey: CryptoKey, options: CryptoUtils_2.IWrapBytesOptions): Promise<Result<Uint8Array>>;
 }
 
 /**
@@ -113,9 +256,13 @@ declare function createBrowserCryptoProvider(): Result<BrowserCryptoProvider>;
 
 declare namespace CryptoUtils {
     export {
+        HpkeProvider,
+        IHpkeSealResult,
         BrowserHashProvider,
         createBrowserCryptoProvider,
-        BrowserCryptoProvider
+        BrowserCryptoProvider,
+        IIdbPrivateKeyStorageCreateParams,
+        IdbPrivateKeyStorage
     }
 }
 export { CryptoUtils }
@@ -124,13 +271,13 @@ export { CryptoUtils }
  * Default IndexedDB database name for directory handles.
  * @public
  */
-export declare const DEFAULT_DIRECTORY_HANDLE_DB = "chocolate-lab-storage";
+export declare const DEFAULT_DIRECTORY_HANDLE_DB: string;
 
 /**
  * Default IndexedDB store name for directory handles.
  * @public
  */
-export declare const DEFAULT_DIRECTORY_HANDLE_STORE = "directory-handles";
+export declare const DEFAULT_DIRECTORY_HANDLE_STORE: string;
 
 /**
  * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.
@@ -229,7 +376,7 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
   * Supports File API (FileList) and File System Access API handles.
   * @public
   */
- export declare class FileApiTreeAccessors<TCT extends string = string> {
+ export declare class FileApiTreeAccessors {
      /**
       * Create a persistent FileTree from a File System Access API directory handle.
       * Changes to files can be synced back to disk.
@@ -325,7 +472,7 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
      static getOriginalFile(fileList: FileList, targetPath: string): Result<File>;
      /**
       * Extract file metadata from a File.
-      * @param fileList - The File to extract metadata from
+      * @param file - The File to extract metadata from
       * @returns The {@link IFileMetadata | file metadata}
       */
      static extractFileMetadata(file: File): IFileMetadata;
@@ -651,6 +798,14 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
   */
  declare function getOriginalFile(fileList: FileList, path: string): Result<File>;
 
+ /**
+  * HPKE base mode (RFC 9180) — `DHKEM(X25519, HKDF-SHA256) + HKDF-SHA256 + AES-256-GCM`.
+  * Re-exported from `@fgv/ts-extras` for browser consumers.
+  * @see {@link CryptoUtils.HpkeProvider}
+  * @public
+  */
+ declare const HpkeProvider: typeof CryptoUtils_2.HpkeProvider;
+
  /**
   * HTTP-backed file tree accessors that cache data in memory and persist via REST API.
   * @public
@@ -686,6 +841,12 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
       */
      syncToDisk(): Promise<Result<void>>;
      private _doSync;
+     /**
+      * Restores snapshotted items back into the live dirty sets so they
+      * are retried on the next sync attempt. Items that were added to
+      * the live sets while the sync was in flight are preserved.
+      */
+     private _restoreUnsynced;
      /**
       * Checks if there are any dirty files that need synchronization.
       * @returns True if there are dirty files, false otherwise.
@@ -739,7 +900,70 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
      private static _requestWithParams;
  }
 
- declare type ICryptoProvider = CryptoUtils_2.ICryptoProvider;
+ /**
+  * {@link CryptoUtils.KeyStore.IPrivateKeyStorage | IPrivateKeyStorage}
+  * implementation backed by IndexedDB. Stores `CryptoKey` objects directly via
+  * IndexedDB's structured-clone serialization — no JWK round-trip — so it works
+  * with non-extractable keys.
+  *
+  * `supportsNonExtractable` is `true`: because the `CryptoKey` is stored by
+  * reference (structured clone) rather than exported, the keystore may generate
+  * `extractable: false` keys for maximum security on browsers that support it.
+  *
+  * The database is opened lazily on first use and cached. Each operation runs in
+  * its own transaction, relying on IndexedDB's default serialization. Multi-tab
+  * concurrency is a known limitation: two tabs writing the same id can race; this
+  * implementation targets single-tab use.
+  *
+  * @public
+  */
+ declare class IdbPrivateKeyStorage implements CryptoUtils_2.KeyStore.IPrivateKeyStorage {
+     /**
+      * `true` — IndexedDB stores `CryptoKey` objects directly, so non-extractable
+      * keys are supported.
+      */
+     readonly supportsNonExtractable: true;
+     private readonly _factory;
+     private readonly _databaseName;
+     private readonly _storeName;
+     private _db;
+     private constructor();
+     /**
+      * Creates a new {@link CryptoUtils.IdbPrivateKeyStorage}.
+      * @param params - Optional {@link CryptoUtils.IIdbPrivateKeyStorageCreateParams}.
+      * @returns `Success` with the new instance, or `Failure` if no IndexedDB
+      * factory is available.
+      */
+     static create(params?: IIdbPrivateKeyStorageCreateParams): Result<IdbPrivateKeyStorage>;
+     /**
+      * Stores `key` under `id`.
+      * @param id - Storage handle to write under.
+      * @param key - The private `CryptoKey` to persist.
+      */
+     store(id: string, key: CryptoKey): Promise<Result<string>>;
+     /**
+      * Loads the private key stored under `id`.
+      * @param id - Storage handle to look up.
+      */
+     load(id: string): Promise<Result<CryptoKey>>;
+     /**
+      * Deletes the entry stored under `id`. Missing ids fail, mirroring the
+      * encrypted-file backend. The existence check and the delete run in separate
+      * transactions (single-tab assumption).
+      * @param id - Storage handle to remove.
+      */
+     delete(id: string): Promise<Result<string>>;
+     /**
+      * Lists every stored id.
+      */
+     list(): Promise<Result<readonly string[]>>;
+     private _getRaw;
+     private _openDb;
+     private _open;
+     private _withStore;
+     private _request;
+     private _awaitCompletion;
+ }
 
  /**
   * Tree initializer for File System Access API directory handles.
@@ -751,8 +975,6 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
      readonly nonRecursive?: boolean;
  }
 
- declare type IEncryptionResult = CryptoUtils_2.IEncryptionResult;
-
  /**
   * Tree initializer for File System Access API file handles.
   * @public
@@ -820,6 +1042,12 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
      showSaveFilePicker(options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle_2>;
  }
 
+ /**
+  * Output of `HpkeProvider.sealBase`. Re-exported from `@fgv/ts-extras`.
+  * @public
+  */
+ declare type IHpkeSealResult = CryptoUtils_2.IHpkeSealResult;
+
  /**
   * Configuration for creating HTTP-backed tree accessors.
   * @public
@@ -833,6 +1061,27 @@ declare function extractFileListMetadata(fileList: FileList): Array<IFileMetadat
      readonly logger?: Logging.LogReporter<unknown>;
  }
 
+ /**
+  * Parameters for {@link CryptoUtils.IdbPrivateKeyStorage.create}.
+  * @public
+  */
+ declare interface IIdbPrivateKeyStorageCreateParams {
+     /**
+      * IndexedDB database name. Default: `'fgv-keystore-private-keys'`.
+      */
+     readonly databaseName?: string;
+     /**
+      * IndexedDB object-store name. Default: `'privateKeys'`.
+      */
+     readonly storeName?: string;
+     /**
+      * IndexedDB factory to use. Defaults to `globalThis.indexedDB`. Supplied
+      * explicitly in tests (e.g. a `fake-indexeddb` factory) or to target a
+      * non-default factory.
+      */
+     readonly indexedDB?: IDBFactory;
+ }
+
  /**
   * Configuration for LocalStorageTreeAccessors.
   * @public

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.57.7"
+      "packageVersion": "7.58.9"
     }
   ]
 }

package/eslint.config.js

@@ -0,0 +1,32 @@
+// ESLint 9 flat config
+const nodeProfile = require('@rushstack/eslint-config/flat/profile/node');
+const packletsPlugin = require('@rushstack/eslint-config/flat/mixins/packlets');
+const tsdocPlugin = require('@rushstack/eslint-config/flat/mixins/tsdoc');
+
+module.exports = [
+  ...nodeProfile,
+  packletsPlugin,
+  ...tsdocPlugin,
+  {
+    rules: {
+      '@rushstack/packlets/mechanics': 'warn'
+    }
+  },
+  {
+    // file-api-types/ deliberately mirrors the browser File System Access API.
+    // Interface names match the DOM verbatim (no `I` prefix) and some APIs return `null`.
+    files: ['src/packlets/file-api-types/**/*.ts'],
+    rules: {
+      '@typescript-eslint/naming-convention': 'off',
+      '@rushstack/no-new-null': 'off'
+    }
+  },
+  {
+    // MockStorage implements the browser Storage interface (localStorage), which
+    // declares `getItem(key)` and `key(index)` as returning `string | null`.
+    files: ['src/test/unit/localStorageTreeAccessors.test.ts'],
+    rules: {
+      '@rushstack/no-new-null': 'off'
+    }
+  }
+];