@fgv/ts-web-extras 5.1.0-3 → 5.1.0-30

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

@@ -1 +1 @@
-{"version":3,"file":"directoryHandleStore.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/directoryHandleStore.ts"],"names":[],"mappings":"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","sourcesContent":["// 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/**\n * Persistent storage for FileSystemDirectoryHandle objects using IndexedDB.\n * Allows directory handles to survive page reloads without re-prompting the user.\n * @packageDocumentation\n */\n\nimport { fail, Result, succeed } from '@fgv/ts-utils';\nimport { createStore, del, get, keys, set } from 'idb-keyval';\nimport { FileSystemDirectoryHandle } from '../file-api-types';\n\n/**\n * Default IndexedDB database name for directory handles.\n * @public\n */\nexport const DEFAULT_DIRECTORY_HANDLE_DB = 'chocolate-lab-storage';\n\n/**\n * Default IndexedDB store name for directory handles.\n * @public\n */\nexport const DEFAULT_DIRECTORY_HANDLE_STORE = 'directory-handles';\n\n/**\n * Manages persistence of {@link FileSystemDirectoryHandle} objects in IndexedDB.\n * Keyed by a label (typically the directory name).\n * @public\n */\nexport class DirectoryHandleStore {\n  private readonly _store: ReturnType<typeof createStore>;\n\n  public constructor(\n    dbName: string = DEFAULT_DIRECTORY_HANDLE_DB,\n    storeName: string = DEFAULT_DIRECTORY_HANDLE_STORE\n  ) {\n    this._store = createStore(dbName, storeName);\n  }\n\n  /**\n   * Saves a directory handle to IndexedDB under the given label.\n   * @param label - Key to store the handle under (typically dirHandle.name)\n   * @param handle - The FileSystemDirectoryHandle to persist\n   * @returns Success or Failure\n   */\n  public async save(label: string, handle: FileSystemDirectoryHandle): Promise<Result<void>> {\n    try {\n      await set(label, handle, this._store);\n      return succeed(undefined);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.save \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Retrieves a directory handle by label.\n   * @param label - Key to look up\n   * @returns Success with handle (or undefined if not found), or Failure on error\n   */\n  public async load(label: string): Promise<Result<FileSystemDirectoryHandle | undefined>> {\n    try {\n      const handle = await get<FileSystemDirectoryHandle>(label, this._store);\n      return succeed(handle);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.load \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Removes a directory handle from IndexedDB.\n   * @param label - Key to remove\n   * @returns Success or Failure\n   */\n  public async remove(label: string): Promise<Result<void>> {\n    try {\n      await del(label, this._store);\n      return succeed(undefined);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.remove \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Returns all stored labels (keys).\n   * @returns Success with array of labels, or Failure\n   */\n  public async getAllLabels(): Promise<Result<string[]>> {\n    try {\n      const allKeys = await keys<string>(this._store);\n      return succeed(allKeys);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.getAllLabels: ${String(e)}`);\n    }\n  }\n\n  /**\n   * Returns all stored handles as label/handle pairs.\n   * @returns Success with array of entries, or Failure\n   */\n  public async getAll(): Promise<Result<Array<{ label: string; handle: FileSystemDirectoryHandle }>>> {\n    const labelsResult = await this.getAllLabels();\n    if (labelsResult.isFailure()) {\n      return fail(labelsResult.message);\n    }\n\n    const entries: Array<{ label: string; handle: FileSystemDirectoryHandle }> = [];\n    for (const label of labelsResult.value) {\n      const handleResult = await this.load(label);\n      if (handleResult.isFailure()) {\n        return fail(handleResult.message);\n      }\n      if (handleResult.value !== undefined) {\n        entries.push({ label, handle: handleResult.value });\n      }\n    }\n    return succeed(entries);\n  }\n}\n"]}
+{"version":3,"file":"directoryHandleStore.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/directoryHandleStore.ts"],"names":[],"mappings":"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","sourcesContent":["// 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/**\n * Persistent storage for FileSystemDirectoryHandle objects using IndexedDB.\n * Allows directory handles to survive page reloads without re-prompting the user.\n * @packageDocumentation\n */\n\nimport { fail, Result, succeed } from '@fgv/ts-utils';\nimport { createStore, del, get, keys, set } from 'idb-keyval';\nimport { FileSystemDirectoryHandle } from '../file-api-types';\n\n/**\n * Default IndexedDB database name for directory handles.\n * @public\n */\nexport const DEFAULT_DIRECTORY_HANDLE_DB: string = 'chocolate-lab-storage';\n\n/**\n * Default IndexedDB store name for directory handles.\n * @public\n */\nexport const DEFAULT_DIRECTORY_HANDLE_STORE: string = 'directory-handles';\n\n/**\n * Manages persistence of {@link FileSystemDirectoryHandle} objects in IndexedDB.\n * Keyed by a label (typically the directory name).\n * @public\n */\nexport class DirectoryHandleStore {\n  private readonly _store: ReturnType<typeof createStore>;\n\n  public constructor(\n    dbName: string = DEFAULT_DIRECTORY_HANDLE_DB,\n    storeName: string = DEFAULT_DIRECTORY_HANDLE_STORE\n  ) {\n    this._store = createStore(dbName, storeName);\n  }\n\n  /**\n   * Saves a directory handle to IndexedDB under the given label.\n   * @param label - Key to store the handle under (typically dirHandle.name)\n   * @param handle - The FileSystemDirectoryHandle to persist\n   * @returns Success or Failure\n   */\n  public async save(label: string, handle: FileSystemDirectoryHandle): Promise<Result<void>> {\n    try {\n      await set(label, handle, this._store);\n      return succeed(undefined);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.save \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Retrieves a directory handle by label.\n   * @param label - Key to look up\n   * @returns Success with handle (or undefined if not found), or Failure on error\n   */\n  public async load(label: string): Promise<Result<FileSystemDirectoryHandle | undefined>> {\n    try {\n      const handle = await get<FileSystemDirectoryHandle>(label, this._store);\n      return succeed(handle);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.load \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Removes a directory handle from IndexedDB.\n   * @param label - Key to remove\n   * @returns Success or Failure\n   */\n  public async remove(label: string): Promise<Result<void>> {\n    try {\n      await del(label, this._store);\n      return succeed(undefined);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.remove \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Returns all stored labels (keys).\n   * @returns Success with array of labels, or Failure\n   */\n  public async getAllLabels(): Promise<Result<string[]>> {\n    try {\n      const allKeys = await keys<string>(this._store);\n      return succeed(allKeys);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.getAllLabels: ${String(e)}`);\n    }\n  }\n\n  /**\n   * Returns all stored handles as label/handle pairs.\n   * @returns Success with array of entries, or Failure\n   */\n  public async getAll(): Promise<Result<Array<{ label: string; handle: FileSystemDirectoryHandle }>>> {\n    const labelsResult = await this.getAllLabels();\n    if (labelsResult.isFailure()) {\n      return fail(labelsResult.message);\n    }\n\n    const entries: Array<{ label: string; handle: FileSystemDirectoryHandle }> = [];\n    for (const label of labelsResult.value) {\n      const handleResult = await this.load(label);\n      if (handleResult.isFailure()) {\n        return fail(handleResult.message);\n      }\n      if (handleResult.value !== undefined) {\n        entries.push({ label, handle: handleResult.value });\n      }\n    }\n    return succeed(entries);\n  }\n}\n"]}

package/dist/packlets/file-tree/fileApiTreeAccessors.js

@@ -236,7 +236,7 @@ export class FileApiTreeAccessors {
     }
     /**
      * 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) {

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

@@ -1 +1 @@
-{"version":3,"file":"fileApiTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileApiTreeAccessors.ts"],"names":[],"mappings":"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","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// File System Access API types are imported via the file-api-types module\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  isFileHandle,\n  isDirectoryHandle,\n  FileSystemFileHandle,\n  FileSystemDirectoryHandle\n} from '../file-api-types';\nimport { FileSystemAccessTreeAccessors, IFileSystemAccessTreeParams } from './fileSystemAccessTreeAccessors';\nimport { HttpTreeAccessors, IHttpTreeParams } from './httpTreeAccessors';\nimport { LocalStorageTreeAccessors, ILocalStorageTreeParams } from './localStorageTreeAccessors';\n\n/**\n * Interface for File objects that may have the webkitRelativePath property.\n * This property is added by browsers when using directory upload (webkitdirectory).\n * @internal\n */\ninterface IFileWithWebkitPath {\n  readonly webkitRelativePath?: string;\n}\n\n/**\n * Helper function to safely get webkitRelativePath from a File object.\n * @internal\n */\nfunction getFileRelativePath(file: File): string {\n  return (file as unknown as IFileWithWebkitPath).webkitRelativePath || file.name;\n}\n\n/**\n * Tree initializer for FileList objects (from File API).\n * @public\n */\nexport interface IFileListTreeInitializer {\n  readonly fileList: FileList;\n}\n\n/**\n * Tree initializer for File System Access API file handles.\n * @public\n */\nexport interface IFileHandleTreeInitializer {\n  readonly prefix?: string;\n  readonly fileHandles: FileSystemFileHandle[];\n}\n\n/**\n * Tree initializer for File System Access API directory handles.\n * @public\n */\nexport interface IDirectoryHandleTreeInitializer {\n  readonly prefix?: string;\n  readonly dirHandles: FileSystemDirectoryHandle[];\n  readonly nonRecursive?: boolean; // Default: false (recursive by default)\n}\n\n/**\n * Union type for all supported tree initializers.\n * @public\n */\nexport type TreeInitializer =\n  | IFileListTreeInitializer\n  | IFileHandleTreeInitializer\n  | IDirectoryHandleTreeInitializer;\n\n/**\n * Interface for file metadata.\n * @public\n */\nexport interface IFileMetadata {\n  path: string;\n  name: string;\n  size: number;\n  type: string;\n  lastModified: number;\n}\n\n/**\n * Helper class to create FileTree instances from various file sources.\n * Supports File API (FileList) and File System Access API handles.\n * @public\n */\nexport class FileApiTreeAccessors<TCT extends string = string> {\n  /**\n   * Create a persistent FileTree from a File System Access API directory handle.\n   * Changes to files can be synced back to disk.\n   *\n   * @param dirHandle - FileSystemDirectoryHandle to load files from\n   * @param params - Optional parameters including autoSync and permission settings\n   * @returns Promise resolving to a FileTree with persistence capability\n   *\n   * @remarks\n   * - Only works in browsers supporting File System Access API (Chrome, Edge, Opera)\n   * - Requires 'readwrite' permission on the directory handle\n   * - Falls back to read-only mode if permissions unavailable (unless requireWritePermission is true)\n   *\n   * @public\n   */\n  public static async createPersistent<TCT extends string = string>(\n    dirHandle: FileSystemDirectoryHandle,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const accessorsResult = await FileSystemAccessTreeAccessors.fromDirectoryHandle<TCT>(dirHandle, params);\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create a persistent FileTree from an HTTP storage service.\n   *\n   * @param params - Configuration including API base URL, namespace, and optional autoSync\n   * @returns Promise resolving to a FileTree with persistence capability\n   * @public\n   */\n  public static async createFromHttp<TCT extends string = string>(\n    params: IHttpTreeParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const accessorsResult = await HttpTreeAccessors.fromHttp<TCT>(params);\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create a persistent FileTree from a single File System Access API file handle.\n   * The tree contains exactly one file at `/<filename>`.\n   * Changes can be synced back to the original file via `syncToDisk()`.\n   *\n   * @param fileHandle - FileSystemFileHandle to load\n   * @param params - Optional parameters including autoSync and permission settings\n   * @returns Promise resolving to a FileTree with persistence capability\n   * @public\n   */\n  public static async createPersistentFromFile<TCT extends string = string>(\n    fileHandle: FileSystemFileHandle,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const accessorsResult = await FileSystemAccessTreeAccessors.fromFileHandle<TCT>(fileHandle, params);\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create a persistent FileTree from browser localStorage.\n   * Changes to files can be synced back to localStorage.\n   *\n   * @param params - Configuration including path-to-key mappings and optional autoSync\n   * @returns Result containing a FileTree with persistence capability\n   *\n   * @remarks\n   * - Works in all browsers with localStorage support\n   * - Maps directory paths to localStorage keys\n   * - Each key stores multiple collections as JSON\n   * - Files are automatically discovered from storage\n   *\n   * @example\n   * ```typescript\n   * const tree = FileApiTreeAccessors.createFromLocalStorage({\n   *   pathToKeyMap: {\n   *     '/data/ingredients': 'myapp:ingredients:v1',\n   *     '/data/fillings': 'myapp:fillings:v1'\n   *   },\n   *   mutable: true,\n   *   autoSync: false\n   * });\n   * ```\n   *\n   * @public\n   */\n  public static createFromLocalStorage<TCT extends string = string>(\n    params: ILocalStorageTreeParams<TCT>\n  ): Result<FileTree.FileTree<TCT>> {\n    const accessorsResult = LocalStorageTreeAccessors.fromStorage<TCT>(params);\n    /* c8 ignore next 3 - coverage intermittently missed in full suite */\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create FileTree from various file sources using TreeInitializer array.\n   * @param initializers - Array of TreeInitializer objects specifying file sources\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to a FileTree with all content pre-loaded\n   */\n  public static async create<TCT extends string = string>(\n    initializers: TreeInitializer[],\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    try {\n      const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n\n      for (const initializer of initializers) {\n        const filesResult = await this._processInitializer<TCT>(initializer, params);\n        if (filesResult.isFailure()) {\n          return fail(filesResult.message);\n        }\n        allFiles.push(...filesResult.value);\n      }\n\n      return FileTree.inMemory<TCT>(allFiles, params);\n      /* c8 ignore next 5 - defense in depth */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to process initializers: ${message}`);\n    }\n  }\n\n  /**\n   * Create FileTree from 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 FileTree with all content pre-loaded\n   */\n  public static async fromFileList<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const path = this._normalizePath(params?.prefix || '', file.name);\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, file.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${file.name}: ${message}`);\n      }\n    }\n\n    return FileTree.inMemory<TCT>(files, params);\n  }\n\n  /**\n   * Create FileTree from directory upload with webkitRelativePath.\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 FileTree with all content pre-loaded\n   */\n  public static async fromDirectoryUpload<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const relativePath = getFileRelativePath(file);\n      const path = this._normalizePath(params?.prefix || '', relativePath);\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, file.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${relativePath}: ${message}`);\n      }\n    }\n\n    return FileTree.inMemory<TCT>(files, params);\n  }\n\n  /**\n   * Get the File object for a specific path from the original FileList.\n   * This is useful for accessing the original File API object for operations\n   * like getting file metadata, MIME type, etc.\n   * @param fileList - The original FileList\n   * @param targetPath - The path to find\n   * @returns Result containing the File object if found\n   */\n  public static getOriginalFile(fileList: FileList, targetPath: string): Result<File> {\n    for (const file of Array.from(fileList)) {\n      const filePath = getFileRelativePath(file);\n      if (filePath === targetPath) {\n        return succeed(file);\n      }\n    }\n    return fail(`File not found: ${targetPath}`);\n  }\n\n  /**\n   * Extract file metadata from a File.\n   * @param fileList - The File to extract metadata from\n   * @returns The {@link IFileMetadata | file metadata}\n   */\n  public static extractFileMetadata(file: File): IFileMetadata {\n    return {\n      path: getFileRelativePath(file),\n      name: file.name,\n      size: file.size,\n      type: file.type,\n      lastModified: file.lastModified\n    };\n  }\n\n  /**\n   * Process a single TreeInitializer and return the resulting files.\n   * @param initializer - The TreeInitializer to process\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processInitializer<TCT extends string = string>(\n    initializer: TreeInitializer,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    if ('fileList' in initializer) {\n      return this._processFileList<TCT>(initializer.fileList, params);\n    } else if ('fileHandles' in initializer) {\n      return this._processFileHandles<TCT>(initializer.fileHandles, params);\n    } else if ('dirHandles' in initializer) {\n      return this._processDirectoryHandles<TCT>(\n        initializer.dirHandles,\n        initializer.prefix ?? params?.prefix,\n        !initializer.nonRecursive,\n        params\n      );\n    } else {\n      return fail('Unknown initializer type');\n    }\n  }\n\n  /**\n   * Process a FileList and return IInMemoryFile array.\n   * @param fileList - The FileList to process\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processFileList<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const metadata = this.extractFileMetadata(file);\n      const relativePath = metadata.path;\n      const path = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, metadata.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${relativePath}: ${message}`);\n      }\n    }\n\n    return succeed(files);\n  }\n\n  /**\n   * Process FileSystemFileHandles and return IInMemoryFile array.\n   * @internal\n   */\n  private static async _processFileHandles<TCT extends string = string>(\n    handles: FileSystemFileHandle[],\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (const handle of handles) {\n      try {\n        const file = await handle.getFile();\n        const contents = await file.text();\n        const metadata = this.extractFileMetadata(file);\n        /* c8 ignore next 1 - defense in depth */\n        const path = this._normalizePath(params?.prefix ?? '', handle.name);\n        const contentType = params?.inferContentType?.(path, metadata.type).orDefault();\n\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file handle ${handle.name}: ${message}`);\n      }\n    }\n\n    return succeed(files);\n  }\n\n  /**\n   * Process FileSystemDirectoryHandles and return IInMemoryFile array.\n   * @param handles - The FileSystemDirectoryHandle[] to process\n   * @param prefix - The prefix to use for the file paths\n   * @param recursive - Whether to process the directory recursively\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processDirectoryHandles<TCT extends string = string>(\n    handles: FileSystemDirectoryHandle[],\n    prefix?: string,\n    recursive: boolean = true,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n    prefix = prefix ?? params?.prefix;\n\n    for (const handle of handles) {\n      const dirPrefix = this._normalizePath(prefix ?? '', handle.name);\n      const filesResult = await this._processDirectoryHandle<TCT>(handle, dirPrefix, recursive, params);\n      if (filesResult.isFailure()) {\n        return filesResult;\n      }\n      allFiles.push(...filesResult.value);\n    }\n\n    return succeed(allFiles);\n  }\n\n  /**\n   * Process a single FileSystemDirectoryHandle recursively.\n   * @param handle - The FileSystemDirectoryHandle to process\n   * @param basePath - The base path to use for the file paths\n   * @param recursive - Whether to process the directory recursively\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processDirectoryHandle<TCT extends string = string>(\n    handle: FileSystemDirectoryHandle,\n    basePath: string,\n    recursive: boolean,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    try {\n      for await (const entry of handle.values()) {\n        if (isFileHandle(entry)) {\n          const file = await entry.getFile();\n          const contents = await file.text();\n          const path = this._normalizePath(basePath, entry.name);\n          const contentType = params?.inferContentType?.(path).orDefault();\n\n          files.push({\n            path,\n            contents,\n            contentType\n          });\n        } else if (isDirectoryHandle(entry) && recursive) {\n          const subDirPath = this._normalizePath(basePath, entry.name);\n          const subdirResult = await this._processDirectoryHandle<TCT>(entry, subDirPath, recursive, params);\n          if (subdirResult.isFailure()) {\n            return subdirResult;\n          }\n          files.push(...subdirResult.value);\n        }\n      }\n\n      return succeed(files);\n    } catch (error) {\n      /* c8 ignore next 1 - defense in depth */\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to process directory ${handle.name}: ${message}`);\n    }\n  }\n\n  private static _normalizePath(prefix: string, path: string): string {\n    // Remove leading slash from prefix if it exists to avoid double slashes\n    const cleanPrefix = prefix ? prefix.replace(/^\\/+/, '') : '';\n    const combined = cleanPrefix ? `${cleanPrefix}/${path}` : path;\n    // Normalize multiple slashes and ensure it starts with / for FileTree compatibility\n    const normalized = combined.replace(/\\/+/g, '/').replace(/\\/$/, '');\n    /* c8 ignore next 1 - tested but coverage intermittently missed */\n    return normalized.startsWith('/') ? normalized : `/${normalized}`;\n  }\n}\n"]}
+{"version":3,"file":"fileApiTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileApiTreeAccessors.ts"],"names":[],"mappings":"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","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// File System Access API types are imported via the file-api-types module\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  isFileHandle,\n  isDirectoryHandle,\n  FileSystemFileHandle,\n  FileSystemDirectoryHandle\n} from '../file-api-types';\nimport { FileSystemAccessTreeAccessors, IFileSystemAccessTreeParams } from './fileSystemAccessTreeAccessors';\nimport { HttpTreeAccessors, IHttpTreeParams } from './httpTreeAccessors';\nimport { LocalStorageTreeAccessors, ILocalStorageTreeParams } from './localStorageTreeAccessors';\n\n/**\n * Interface for File objects that may have the webkitRelativePath property.\n * This property is added by browsers when using directory upload (webkitdirectory).\n * @internal\n */\ninterface IFileWithWebkitPath {\n  readonly webkitRelativePath?: string;\n}\n\n/**\n * Helper function to safely get webkitRelativePath from a File object.\n * @internal\n */\nfunction getFileRelativePath(file: File): string {\n  return (file as unknown as IFileWithWebkitPath).webkitRelativePath || file.name;\n}\n\n/**\n * Tree initializer for FileList objects (from File API).\n * @public\n */\nexport interface IFileListTreeInitializer {\n  readonly fileList: FileList;\n}\n\n/**\n * Tree initializer for File System Access API file handles.\n * @public\n */\nexport interface IFileHandleTreeInitializer {\n  readonly prefix?: string;\n  readonly fileHandles: FileSystemFileHandle[];\n}\n\n/**\n * Tree initializer for File System Access API directory handles.\n * @public\n */\nexport interface IDirectoryHandleTreeInitializer {\n  readonly prefix?: string;\n  readonly dirHandles: FileSystemDirectoryHandle[];\n  readonly nonRecursive?: boolean; // Default: false (recursive by default)\n}\n\n/**\n * Union type for all supported tree initializers.\n * @public\n */\nexport type TreeInitializer =\n  | IFileListTreeInitializer\n  | IFileHandleTreeInitializer\n  | IDirectoryHandleTreeInitializer;\n\n/**\n * Interface for file metadata.\n * @public\n */\nexport interface IFileMetadata {\n  path: string;\n  name: string;\n  size: number;\n  type: string;\n  lastModified: number;\n}\n\n/**\n * Helper class to create FileTree instances from various file sources.\n * Supports File API (FileList) and File System Access API handles.\n * @public\n */\nexport class FileApiTreeAccessors {\n  /**\n   * Create a persistent FileTree from a File System Access API directory handle.\n   * Changes to files can be synced back to disk.\n   *\n   * @param dirHandle - FileSystemDirectoryHandle to load files from\n   * @param params - Optional parameters including autoSync and permission settings\n   * @returns Promise resolving to a FileTree with persistence capability\n   *\n   * @remarks\n   * - Only works in browsers supporting File System Access API (Chrome, Edge, Opera)\n   * - Requires 'readwrite' permission on the directory handle\n   * - Falls back to read-only mode if permissions unavailable (unless requireWritePermission is true)\n   *\n   * @public\n   */\n  public static async createPersistent<TCT extends string = string>(\n    dirHandle: FileSystemDirectoryHandle,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const accessorsResult = await FileSystemAccessTreeAccessors.fromDirectoryHandle<TCT>(dirHandle, params);\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create a persistent FileTree from an HTTP storage service.\n   *\n   * @param params - Configuration including API base URL, namespace, and optional autoSync\n   * @returns Promise resolving to a FileTree with persistence capability\n   * @public\n   */\n  public static async createFromHttp<TCT extends string = string>(\n    params: IHttpTreeParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const accessorsResult = await HttpTreeAccessors.fromHttp<TCT>(params);\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create a persistent FileTree from a single File System Access API file handle.\n   * The tree contains exactly one file at `/<filename>`.\n   * Changes can be synced back to the original file via `syncToDisk()`.\n   *\n   * @param fileHandle - FileSystemFileHandle to load\n   * @param params - Optional parameters including autoSync and permission settings\n   * @returns Promise resolving to a FileTree with persistence capability\n   * @public\n   */\n  public static async createPersistentFromFile<TCT extends string = string>(\n    fileHandle: FileSystemFileHandle,\n    params?: IFileSystemAccessTreeParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const accessorsResult = await FileSystemAccessTreeAccessors.fromFileHandle<TCT>(fileHandle, params);\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create a persistent FileTree from browser localStorage.\n   * Changes to files can be synced back to localStorage.\n   *\n   * @param params - Configuration including path-to-key mappings and optional autoSync\n   * @returns Result containing a FileTree with persistence capability\n   *\n   * @remarks\n   * - Works in all browsers with localStorage support\n   * - Maps directory paths to localStorage keys\n   * - Each key stores multiple collections as JSON\n   * - Files are automatically discovered from storage\n   *\n   * @example\n   * ```typescript\n   * const tree = FileApiTreeAccessors.createFromLocalStorage({\n   *   pathToKeyMap: {\n   *     '/data/ingredients': 'myapp:ingredients:v1',\n   *     '/data/fillings': 'myapp:fillings:v1'\n   *   },\n   *   mutable: true,\n   *   autoSync: false\n   * });\n   * ```\n   *\n   * @public\n   */\n  public static createFromLocalStorage<TCT extends string = string>(\n    params: ILocalStorageTreeParams<TCT>\n  ): Result<FileTree.FileTree<TCT>> {\n    const accessorsResult = LocalStorageTreeAccessors.fromStorage<TCT>(params);\n    /* c8 ignore next 3 - coverage intermittently missed in full suite */\n    if (accessorsResult.isFailure()) {\n      return fail(accessorsResult.message);\n    }\n\n    return FileTree.FileTree.create<TCT>(accessorsResult.value);\n  }\n\n  /**\n   * Create FileTree from various file sources using TreeInitializer array.\n   * @param initializers - Array of TreeInitializer objects specifying file sources\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to a FileTree with all content pre-loaded\n   */\n  public static async create<TCT extends string = string>(\n    initializers: TreeInitializer[],\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    try {\n      const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n\n      for (const initializer of initializers) {\n        const filesResult = await this._processInitializer<TCT>(initializer, params);\n        if (filesResult.isFailure()) {\n          return fail(filesResult.message);\n        }\n        allFiles.push(...filesResult.value);\n      }\n\n      return FileTree.inMemory<TCT>(allFiles, params);\n      /* c8 ignore next 5 - defense in depth */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to process initializers: ${message}`);\n    }\n  }\n\n  /**\n   * Create FileTree from 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 FileTree with all content pre-loaded\n   */\n  public static async fromFileList<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const path = this._normalizePath(params?.prefix || '', file.name);\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, file.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${file.name}: ${message}`);\n      }\n    }\n\n    return FileTree.inMemory<TCT>(files, params);\n  }\n\n  /**\n   * Create FileTree from directory upload with webkitRelativePath.\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 FileTree with all content pre-loaded\n   */\n  public static async fromDirectoryUpload<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const relativePath = getFileRelativePath(file);\n      const path = this._normalizePath(params?.prefix || '', relativePath);\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, file.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${relativePath}: ${message}`);\n      }\n    }\n\n    return FileTree.inMemory<TCT>(files, params);\n  }\n\n  /**\n   * Get the File object for a specific path from the original FileList.\n   * This is useful for accessing the original File API object for operations\n   * like getting file metadata, MIME type, etc.\n   * @param fileList - The original FileList\n   * @param targetPath - The path to find\n   * @returns Result containing the File object if found\n   */\n  public static getOriginalFile(fileList: FileList, targetPath: string): Result<File> {\n    for (const file of Array.from(fileList)) {\n      const filePath = getFileRelativePath(file);\n      if (filePath === targetPath) {\n        return succeed(file);\n      }\n    }\n    return fail(`File not found: ${targetPath}`);\n  }\n\n  /**\n   * Extract file metadata from a File.\n   * @param file - The File to extract metadata from\n   * @returns The {@link IFileMetadata | file metadata}\n   */\n  public static extractFileMetadata(file: File): IFileMetadata {\n    return {\n      path: getFileRelativePath(file),\n      name: file.name,\n      size: file.size,\n      type: file.type,\n      lastModified: file.lastModified\n    };\n  }\n\n  /**\n   * Process a single TreeInitializer and return the resulting files.\n   * @param initializer - The TreeInitializer to process\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processInitializer<TCT extends string = string>(\n    initializer: TreeInitializer,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    if ('fileList' in initializer) {\n      return this._processFileList<TCT>(initializer.fileList, params);\n    } else if ('fileHandles' in initializer) {\n      return this._processFileHandles<TCT>(initializer.fileHandles, params);\n    } else if ('dirHandles' in initializer) {\n      return this._processDirectoryHandles<TCT>(\n        initializer.dirHandles,\n        initializer.prefix ?? params?.prefix,\n        !initializer.nonRecursive,\n        params\n      );\n    } else {\n      return fail('Unknown initializer type');\n    }\n  }\n\n  /**\n   * Process a FileList and return IInMemoryFile array.\n   * @param fileList - The FileList to process\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processFileList<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const metadata = this.extractFileMetadata(file);\n      const relativePath = metadata.path;\n      const path = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, metadata.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${relativePath}: ${message}`);\n      }\n    }\n\n    return succeed(files);\n  }\n\n  /**\n   * Process FileSystemFileHandles and return IInMemoryFile array.\n   * @internal\n   */\n  private static async _processFileHandles<TCT extends string = string>(\n    handles: FileSystemFileHandle[],\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (const handle of handles) {\n      try {\n        const file = await handle.getFile();\n        const contents = await file.text();\n        const metadata = this.extractFileMetadata(file);\n        /* c8 ignore next 1 - defense in depth */\n        const path = this._normalizePath(params?.prefix ?? '', handle.name);\n        const contentType = params?.inferContentType?.(path, metadata.type).orDefault();\n\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file handle ${handle.name}: ${message}`);\n      }\n    }\n\n    return succeed(files);\n  }\n\n  /**\n   * Process FileSystemDirectoryHandles and return IInMemoryFile array.\n   * @param handles - The FileSystemDirectoryHandle[] to process\n   * @param prefix - The prefix to use for the file paths\n   * @param recursive - Whether to process the directory recursively\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processDirectoryHandles<TCT extends string = string>(\n    handles: FileSystemDirectoryHandle[],\n    prefix?: string,\n    recursive: boolean = true,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n    prefix = prefix ?? params?.prefix;\n\n    for (const handle of handles) {\n      const dirPrefix = this._normalizePath(prefix ?? '', handle.name);\n      const filesResult = await this._processDirectoryHandle<TCT>(handle, dirPrefix, recursive, params);\n      if (filesResult.isFailure()) {\n        return filesResult;\n      }\n      allFiles.push(...filesResult.value);\n    }\n\n    return succeed(allFiles);\n  }\n\n  /**\n   * Process a single FileSystemDirectoryHandle recursively.\n   * @param handle - The FileSystemDirectoryHandle to process\n   * @param basePath - The base path to use for the file paths\n   * @param recursive - Whether to process the directory recursively\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processDirectoryHandle<TCT extends string = string>(\n    handle: FileSystemDirectoryHandle,\n    basePath: string,\n    recursive: boolean,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    try {\n      for await (const entry of handle.values()) {\n        if (isFileHandle(entry)) {\n          const file = await entry.getFile();\n          const contents = await file.text();\n          const path = this._normalizePath(basePath, entry.name);\n          const contentType = params?.inferContentType?.(path).orDefault();\n\n          files.push({\n            path,\n            contents,\n            contentType\n          });\n        } else if (isDirectoryHandle(entry) && recursive) {\n          const subDirPath = this._normalizePath(basePath, entry.name);\n          const subdirResult = await this._processDirectoryHandle<TCT>(entry, subDirPath, recursive, params);\n          if (subdirResult.isFailure()) {\n            return subdirResult;\n          }\n          files.push(...subdirResult.value);\n        }\n      }\n\n      return succeed(files);\n    } catch (error) {\n      /* c8 ignore next 1 - defense in depth */\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to process directory ${handle.name}: ${message}`);\n    }\n  }\n\n  private static _normalizePath(prefix: string, path: string): string {\n    // Remove leading slash from prefix if it exists to avoid double slashes\n    const cleanPrefix = prefix ? prefix.replace(/^\\/+/, '') : '';\n    const combined = cleanPrefix ? `${cleanPrefix}/${path}` : path;\n    // Normalize multiple slashes and ensure it starts with / for FileTree compatibility\n    const normalized = combined.replace(/\\/+/g, '/').replace(/\\/$/, '');\n    /* c8 ignore next 1 - tested but coverage intermittently missed */\n    return normalized.startsWith('/') ? normalized : `/${normalized}`;\n  }\n}\n"]}

package/dist/packlets/file-tree/fileSystemAccessTreeAccessors.js

@@ -290,7 +290,7 @@ export class FileSystemAccessTreeAccessors extends FileTree.InMemoryTreeAccessor
             if (this._hasWritePermission) {
                 this._pendingDeletions.add(path);
                 if (this._autoSync) {
-                    void this._runAutoSyncTask(path, 'delete', () => this._deleteFileFromDisk(path));
+                    this._runAutoSyncTask(path, 'delete', () => this._deleteFileFromDisk(path)).catch(() => undefined);
                 }
             }
         }
@@ -307,7 +307,7 @@ export class FileSystemAccessTreeAccessors extends FileTree.InMemoryTreeAccessor
             // Auto-sync if enabled
             if (this._autoSync) {
                 // Fire and log-on-failure; don't block the save path.
-                void this._runAutoSyncTask(path, 'save', () => this._syncFile(path));
+                this._runAutoSyncTask(path, 'save', () => this._syncFile(path)).catch(() => undefined);
             }
         }
         return result;

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

@@ -1 +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 {\n  Result,\n  succeed,\n  fail,\n  captureResult,\n  DetailedResult,\n  succeedWithDetail,\n  Logging\n} 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  /** Optional logger for auto-sync and persistence failures. */\n  logger?: Logging.LogReporter<unknown>;\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 _pendingDeletions: Set<string>;\n  private readonly _autoSync: boolean;\n  private readonly _hasWritePermission: boolean;\n  private readonly _logger: Logging.LogReporter<unknown>;\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._pendingDeletions = new Set();\n    /* c8 ignore next 3 - intermittent branch coverage: ?? fallback branches in constructor */\n    this._autoSync = params?.autoSync ?? false;\n    this._hasWritePermission = hasWritePermission;\n    this._logger = params?.logger ?? new Logging.LogReporter<unknown>();\n  }\n\n  private async _runAutoSyncTask(\n    path: string,\n    operation: 'save' | 'delete',\n    action: () => Promise<Result<void>>\n  ): Promise<void> {\n    try {\n      const result = await action();\n      if (result.isFailure()) {\n        this._logger.error(`Auto-${operation} failed for ${path}: ${result.message}`);\n      }\n    } catch (err) {\n      this._logger.error(`Auto-${operation} threw for ${path}: ${String(err)}`);\n    }\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      /* c8 ignore next 1 - intermittent branch coverage: ?? true fallback */\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      /* c8 ignore next 3 - intermittent branch coverage: ternary for inferContentType */\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        /* c8 ignore next 1 - intermittent branch coverage: ?? false fallback */\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      /* c8 ignore next 1 - intermittent branch coverage: error instanceof Error false branch */\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    // Process pending deletions from disk\n    for (const path of this._pendingDeletions) {\n      const deleteResult = await this._deleteFileFromDisk(path);\n      if (deleteResult.isFailure()) {\n        errors.push(`delete ${path}: ${deleteResult.message}`);\n      }\n    }\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._pendingDeletions.clear();\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 || this._pendingDeletions.size > 0;\n  }\n\n  /**\n   * Implements `FileTree.IPersistentFileTreeAccessors.getDirtyPaths`\n   */\n  public getDirtyPaths(): string[] {\n    return [...Array.from(this._dirtyFiles), ...Array.from(this._pendingDeletions)];\n  }\n\n  /**\n   * Override deleteFile to track pending deletions for syncToDisk.\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._handles.delete(path);\n\n      if (this._hasWritePermission) {\n        this._pendingDeletions.add(path);\n\n        if (this._autoSync) {\n          void this._runAutoSyncTask(path, 'delete', () => this._deleteFileFromDisk(path));\n        }\n      }\n    }\n    return result;\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 log-on-failure; don't block the save path.\n        void this._runAutoSyncTask(path, 'save', () => this._syncFile(path));\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   * Delete a file from disk using the File System Access API.\n   * @param path - The path of the file to delete.\n   * @returns Promise resolving to success or failure.\n   * @internal\n   */\n  private async _deleteFileFromDisk(path: string): Promise<Result<void>> {\n    try {\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 - defensive: invalid path */\n      if (!filename) {\n        return fail(`Invalid file path: ${path}`);\n      }\n\n      // Navigate to the parent directory\n      let currentDir = this._rootDir;\n      for (const part of parts) {\n        currentDir = await currentDir.getDirectoryHandle(part);\n      }\n\n      await currentDir.removeEntry(filename);\n      return succeed(undefined);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to delete file ${path}: ${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"]}
+{"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, DetailedResult, succeedWithDetail, Logging } 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  /** Optional logger for auto-sync and persistence failures. */\n  logger?: Logging.LogReporter<unknown>;\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 _pendingDeletions: Set<string>;\n  private readonly _autoSync: boolean;\n  private readonly _hasWritePermission: boolean;\n  private readonly _logger: Logging.LogReporter<unknown>;\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._pendingDeletions = new Set();\n    /* c8 ignore next 3 - intermittent branch coverage: ?? fallback branches in constructor */\n    this._autoSync = params?.autoSync ?? false;\n    this._hasWritePermission = hasWritePermission;\n    this._logger = params?.logger ?? new Logging.LogReporter<unknown>();\n  }\n\n  private async _runAutoSyncTask(\n    path: string,\n    operation: 'save' | 'delete',\n    action: () => Promise<Result<void>>\n  ): Promise<void> {\n    try {\n      const result = await action();\n      if (result.isFailure()) {\n        this._logger.error(`Auto-${operation} failed for ${path}: ${result.message}`);\n      }\n    } catch (err) {\n      this._logger.error(`Auto-${operation} threw for ${path}: ${String(err)}`);\n    }\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      /* c8 ignore next 1 - intermittent branch coverage: ?? true fallback */\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      /* c8 ignore next 3 - intermittent branch coverage: ternary for inferContentType */\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        /* c8 ignore next 1 - intermittent branch coverage: ?? false fallback */\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      /* c8 ignore next 1 - intermittent branch coverage: error instanceof Error false branch */\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    // Process pending deletions from disk\n    for (const path of this._pendingDeletions) {\n      const deleteResult = await this._deleteFileFromDisk(path);\n      if (deleteResult.isFailure()) {\n        errors.push(`delete ${path}: ${deleteResult.message}`);\n      }\n    }\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._pendingDeletions.clear();\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 || this._pendingDeletions.size > 0;\n  }\n\n  /**\n   * Implements `FileTree.IPersistentFileTreeAccessors.getDirtyPaths`\n   */\n  public getDirtyPaths(): string[] {\n    return [...Array.from(this._dirtyFiles), ...Array.from(this._pendingDeletions)];\n  }\n\n  /**\n   * Override deleteFile to track pending deletions for syncToDisk.\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._handles.delete(path);\n\n      if (this._hasWritePermission) {\n        this._pendingDeletions.add(path);\n\n        if (this._autoSync) {\n          this._runAutoSyncTask(path, 'delete', () => this._deleteFileFromDisk(path)).catch(() => undefined);\n        }\n      }\n    }\n    return result;\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 log-on-failure; don't block the save path.\n        this._runAutoSyncTask(path, 'save', () => this._syncFile(path)).catch(() => undefined);\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   * Delete a file from disk using the File System Access API.\n   * @param path - The path of the file to delete.\n   * @returns Promise resolving to success or failure.\n   * @internal\n   */\n  private async _deleteFileFromDisk(path: string): Promise<Result<void>> {\n    try {\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 - defensive: invalid path */\n      if (!filename) {\n        return fail(`Invalid file path: ${path}`);\n      }\n\n      // Navigate to the parent directory\n      let currentDir = this._rootDir;\n      for (const part of parts) {\n        currentDir = await currentDir.getDirectoryHandle(part);\n      }\n\n      await currentDir.removeEntry(filename);\n      return succeed(undefined);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to delete file ${path}: ${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/dist/packlets/file-tree/httpTreeAccessors.js

@@ -77,6 +77,8 @@ export class HttpTreeAccessors extends FileTree.InMemoryTreeAccessors {
      */
     async syncToDisk() {
         if (this._syncPromise) {
+            // Wait for the in-flight sync — it drains the queue in a loop,
+            // so any items added before it finishes will be included.
             return this._syncPromise;
         }
         this._syncPromise = this._doSync().finally(() => {
@@ -85,57 +87,85 @@ export class HttpTreeAccessors extends FileTree.InMemoryTreeAccessors {
         return this._syncPromise;
     }
     async _doSync() {
-        if (this._dirtyFiles.size === 0 && this._pendingDeletions.size === 0) {
-            return succeed(undefined);
-        }
-        // Snapshot and clear dirty sets so that changes arriving during
-        // the async sync are not dropped when we finish.
-        const deletions = new Set(this._pendingDeletions);
-        const dirty = new Set(this._dirtyFiles);
-        this._pendingDeletions.clear();
-        this._dirtyFiles.clear();
-        for (const path of deletions) {
-            const query = new URLSearchParams();
-            query.set('path', path);
-            if (this._namespace) {
-                query.set('namespace', this._namespace);
+        // Drain loop: keep processing as long as new items arrive.
+        // This is critical for bulk operations (e.g. reset) where many
+        // deleteFile/saveFileContents calls happen synchronously — only
+        // the first may be in the set when we snapshot, but the rest
+        // arrive during the async gaps and must be picked up before
+        // we return.
+        let didWork = false;
+        while (this._dirtyFiles.size > 0 || this._pendingDeletions.size > 0) {
+            didWork = true;
+            // Snapshot and clear so that changes arriving during the async
+            // requests land in the live sets for the next iteration.
+            const deletions = new Set(this._pendingDeletions);
+            const dirty = new Set(this._dirtyFiles);
+            this._pendingDeletions.clear();
+            this._dirtyFiles.clear();
+            for (const path of deletions) {
+                const query = new URLSearchParams();
+                query.set('path', path);
+                if (this._namespace) {
+                    query.set('namespace', this._namespace);
+                }
+                const deleteResult = await this._requestWithRetry(`/file?${query.toString()}`, {
+                    method: 'DELETE'
+                });
+                if (deleteResult.isFailure()) {
+                    this._restoreUnsynced(deletions, dirty);
+                    return fail(`delete ${path}: ${deleteResult.message}`);
+                }
             }
-            const deleteResult = await this._requestWithRetry(`/file?${query.toString()}`, {
-                method: 'DELETE'
-            });
-            if (deleteResult.isFailure()) {
-                return fail(`delete ${path}: ${deleteResult.message}`);
+            for (const path of dirty) {
+                const contentsResult = this.getFileContents(path);
+                if (contentsResult.isFailure()) {
+                    this._restoreUnsynced(deletions, dirty);
+                    return fail(`${path}: ${contentsResult.message}`);
+                }
+                const body = {
+                    path,
+                    contents: contentsResult.value
+                };
+                if (this._namespace) {
+                    body.namespace = this._namespace;
+                }
+                const saveResult = await this._requestWithRetry('/file', {
+                    method: 'PUT',
+                    body: JSON.stringify(body)
+                });
+                if (saveResult.isFailure()) {
+                    this._restoreUnsynced(deletions, dirty);
+                    return fail(`sync ${path}: ${saveResult.message}`);
+                }
             }
         }
-        for (const path of dirty) {
-            const contentsResult = this.getFileContents(path);
-            if (contentsResult.isFailure()) {
-                return fail(`${path}: ${contentsResult.message}`);
-            }
-            const body = {
-                path,
-                contents: contentsResult.value
-            };
+        if (didWork) {
+            const syncBody = {};
             if (this._namespace) {
-                body.namespace = this._namespace;
+                syncBody.namespace = this._namespace;
             }
-            const saveResult = await this._requestWithRetry('/file', {
-                method: 'PUT',
-                body: JSON.stringify(body)
+            const syncResult = await this._requestWithRetry('/sync', {
+                method: 'POST',
+                body: JSON.stringify(syncBody)
             });
-            if (saveResult.isFailure()) {
-                return fail(`sync ${path}: ${saveResult.message}`);
+            if (syncResult.isFailure()) {
+                return fail(syncResult.message);
             }
         }
-        const syncBody = {};
-        if (this._namespace) {
-            syncBody.namespace = this._namespace;
+        return succeed(undefined);
+    }
+    /**
+     * 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.
+     */
+    _restoreUnsynced(deletions, dirty) {
+        for (const path of deletions) {
+            this._pendingDeletions.add(path);
+        }
+        for (const path of dirty) {
+            this._dirtyFiles.add(path);
         }
-        const syncResult = await this._requestWithRetry('/sync', {
-            method: 'POST',
-            body: JSON.stringify(syncBody)
-        });
-        return syncResult.isFailure() ? fail(syncResult.message) : succeed(undefined);
     }
     /**
      * Checks if there are any dirty files that need synchronization.
@@ -161,7 +191,7 @@ export class HttpTreeAccessors extends FileTree.InMemoryTreeAccessors {
         if (!this._autoSync) {
             return result;
         }
-        void this._runAutoSyncTask(path);
+        this._runAutoSyncTask(path).catch(() => undefined);
         return result;
     }
     /**
@@ -180,7 +210,7 @@ export class HttpTreeAccessors extends FileTree.InMemoryTreeAccessors {
             return result;
         }
         // fire-and-log-on-failure automatic sync for immediate persistence workflow
-        void this._runAutoSyncTask(path);
+        this._runAutoSyncTask(path).catch(() => undefined);
         return result;
     }
     /**