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

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

@@ -80,6 +80,8 @@ class HttpTreeAccessors extends ts_json_base_1.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(() => {
@@ -88,57 +90,85 @@ class HttpTreeAccessors extends ts_json_base_1.FileTree.InMemoryTreeAccessors {
         return this._syncPromise;
     }
     async _doSync() {
-        if (this._dirtyFiles.size === 0 && this._pendingDeletions.size === 0) {
-            return (0, ts_utils_1.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 (0, ts_utils_1.fail)(`delete ${path}: ${deleteResult.message}`);
+                }
             }
-            const deleteResult = await this._requestWithRetry(`/file?${query.toString()}`, {
-                method: 'DELETE'
-            });
-            if (deleteResult.isFailure()) {
-                return (0, ts_utils_1.fail)(`delete ${path}: ${deleteResult.message}`);
+            for (const path of dirty) {
+                const contentsResult = this.getFileContents(path);
+                if (contentsResult.isFailure()) {
+                    this._restoreUnsynced(deletions, dirty);
+                    return (0, ts_utils_1.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 (0, ts_utils_1.fail)(`sync ${path}: ${saveResult.message}`);
+                }
             }
         }
-        for (const path of dirty) {
-            const contentsResult = this.getFileContents(path);
-            if (contentsResult.isFailure()) {
-                return (0, ts_utils_1.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 (0, ts_utils_1.fail)(`sync ${path}: ${saveResult.message}`);
+            if (syncResult.isFailure()) {
+                return (0, ts_utils_1.fail)(syncResult.message);
             }
         }
-        const syncBody = {};
-        if (this._namespace) {
-            syncBody.namespace = this._namespace;
+        return (0, ts_utils_1.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() ? (0, ts_utils_1.fail)(syncResult.message) : (0, ts_utils_1.succeed)(undefined);
     }
     /**
      * Checks if there are any dirty files that need synchronization.
@@ -164,7 +194,7 @@ class HttpTreeAccessors extends ts_json_base_1.FileTree.InMemoryTreeAccessors {
         if (!this._autoSync) {
             return result;
         }
-        void this._runAutoSyncTask(path);
+        this._runAutoSyncTask(path).catch(() => undefined);
         return result;
     }
     /**
@@ -183,7 +213,7 @@ class HttpTreeAccessors extends ts_json_base_1.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;
     }
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"httpTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/httpTreeAccessors.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { DetailedResult, fail, type Result, succeed, succeedWithDetail, Logging } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n\ninterface IHttpStorageTreeItem {\n  readonly path: string;\n  readonly name: string;\n  readonly type: 'file' | 'directory';\n}\n\ninterface IHttpStorageTreeChildrenResponse {\n  readonly path: string;\n  readonly children: ReadonlyArray<IHttpStorageTreeItem>;\n}\n\ninterface IHttpStorageFileResponse {\n  readonly path: string;\n  readonly contents: string;\n  readonly contentType?: string;\n}\n\ninterface IHttpStorageSyncResponse {\n  readonly synced: number;\n}\n\nfunction normalizeFetch(fetchImpl?: typeof fetch): typeof fetch {\n  const resolved = fetchImpl ?? globalThis.fetch;\n  return resolved.bind(globalThis) as typeof fetch;\n}\n\n/**\n * Configuration for creating HTTP-backed tree accessors.\n * @public\n */\nexport interface IHttpTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {\n  readonly baseUrl: string;\n  readonly namespace?: string;\n  readonly autoSync?: boolean;\n  readonly fetchImpl?: typeof fetch;\n  readonly userId?: string;\n  readonly logger?: Logging.LogReporter<unknown>;\n}\n\n/**\n * HTTP-backed file tree accessors that cache data in memory and persist via REST API.\n * @public\n */\nexport class HttpTreeAccessors<TCT extends string = string>\n  extends FileTree.InMemoryTreeAccessors<TCT>\n  implements FileTree.IPersistentFileTreeAccessors<TCT>\n{\n  private readonly _baseUrl: string;\n  private readonly _namespace: string | undefined;\n  private readonly _fetchImpl: typeof fetch;\n  private readonly _dirtyFiles: Set<string> = new Set();\n  private readonly _pendingDeletions: Set<string> = new Set();\n  private readonly _autoSync: boolean;\n  private readonly _userId: string | undefined;\n  private readonly _logger: Logging.LogReporter<unknown>;\n\n  /** Guards against concurrent syncToDisk calls (thundering herd from autoSync). */\n  private _syncPromise: Promise<Result<void>> | undefined;\n\n  private constructor(files: FileTree.IInMemoryFile<TCT>[], params: IHttpTreeParams<TCT>) {\n    super(files, params);\n    this._baseUrl = params.baseUrl.replace(/\\/$/, '');\n    this._namespace = params.namespace;\n    this._fetchImpl = normalizeFetch(params.fetchImpl);\n    this._autoSync = params.autoSync ?? false;\n    this._userId = params.userId;\n    this._logger = params.logger ?? new Logging.LogReporter<unknown>();\n  }\n\n  private async _runAutoSyncTask(path: string): Promise<void> {\n    try {\n      const result = await this.syncToDisk();\n      if (result.isFailure()) {\n        this._logger.error(`Auto-sync failed for ${path}: ${result.message}`);\n      }\n    } catch (err) {\n      this._logger.error(`Auto-sync threw for ${path}: ${String(err)}`);\n    }\n  }\n\n  /**\n   * Creates a new HttpTreeAccessors instance from an HTTP backend.\n   * @param params - Configuration parameters for the HTTP tree accessors.\n   * @returns A promise that resolves to a result containing the new HttpTreeAccessors instance or an error message.\n   */\n  public static async fromHttp<TCT extends string = string>(\n    params: IHttpTreeParams<TCT>\n  ): Promise<Result<HttpTreeAccessors<TCT>>> {\n    const filesResult = await this._loadFiles<TCT>(params, '/');\n    if (filesResult.isFailure()) {\n      return fail(filesResult.message);\n    }\n    return succeed(new HttpTreeAccessors<TCT>(filesResult.value, params));\n  }\n\n  /**\n   * Synchronizes all dirty files to the HTTP backend.\n   *\n   * Uses a concurrency guard: if a sync is already in progress, callers\n   * await the existing operation rather than starting a parallel one.\n   * This prevents the thundering herd that occurs when autoSync fires\n   * for every file written during a bulk operation (e.g. restore).\n   *\n   * @returns A promise that resolves to a result indicating success or failure.\n   */\n  public async syncToDisk(): Promise<Result<void>> {\n    if (this._syncPromise) {\n      return this._syncPromise;\n    }\n\n    this._syncPromise = this._doSync().finally(() => {\n      this._syncPromise = undefined;\n    });\n    return this._syncPromise;\n  }\n\n  private async _doSync(): Promise<Result<void>> {\n    if (this._dirtyFiles.size === 0 && this._pendingDeletions.size === 0) {\n      return succeed(undefined);\n    }\n\n    // Snapshot and clear dirty sets so that changes arriving during\n    // the async sync are not dropped when we finish.\n    const deletions = new Set(this._pendingDeletions);\n    const dirty = new Set(this._dirtyFiles);\n    this._pendingDeletions.clear();\n    this._dirtyFiles.clear();\n\n    for (const path of deletions) {\n      const query = new URLSearchParams();\n      query.set('path', path);\n      if (this._namespace) {\n        query.set('namespace', this._namespace);\n      }\n\n      const deleteResult = await this._requestWithRetry<{ deleted: boolean }>(`/file?${query.toString()}`, {\n        method: 'DELETE'\n      });\n      if (deleteResult.isFailure()) {\n        return fail(`delete ${path}: ${deleteResult.message}`);\n      }\n    }\n\n    for (const path of dirty) {\n      const contentsResult = this.getFileContents(path);\n      if (contentsResult.isFailure()) {\n        return fail(`${path}: ${contentsResult.message}`);\n      }\n\n      const body: Record<string, unknown> = {\n        path,\n        contents: contentsResult.value\n      };\n      if (this._namespace) {\n        body.namespace = this._namespace;\n      }\n\n      const saveResult = await this._requestWithRetry<IHttpStorageFileResponse>('/file', {\n        method: 'PUT',\n        body: JSON.stringify(body)\n      });\n      if (saveResult.isFailure()) {\n        return fail(`sync ${path}: ${saveResult.message}`);\n      }\n    }\n\n    const syncBody: Record<string, unknown> = {};\n    if (this._namespace) {\n      syncBody.namespace = this._namespace;\n    }\n\n    const syncResult = await this._requestWithRetry<IHttpStorageSyncResponse>('/sync', {\n      method: 'POST',\n      body: JSON.stringify(syncBody)\n    });\n\n    return syncResult.isFailure() ? fail(syncResult.message) : succeed(undefined);\n  }\n\n  /**\n   * Checks if there are any dirty files that need synchronization.\n   * @returns True if there are dirty files, false otherwise.\n   */\n  public isDirty(): boolean {\n    return this._dirtyFiles.size > 0 || this._pendingDeletions.size > 0;\n  }\n\n  /**\n   * Gets the list of paths for all dirty files.\n   * @returns An array of file paths that have been modified but not yet synchronized.\n   */\n  public getDirtyPaths(): string[] {\n    return [...Array.from(this._dirtyFiles), ...Array.from(this._pendingDeletions)];\n  }\n\n  public deleteFile(path: string): Result<boolean> {\n    const result = super.deleteFile(path);\n    if (result.isFailure()) {\n      return result;\n    }\n\n    this._dirtyFiles.delete(path);\n    this._pendingDeletions.add(path);\n\n    if (!this._autoSync) {\n      return result;\n    }\n\n    void this._runAutoSyncTask(path);\n    return result;\n  }\n\n  /**\n   * Saves file contents and marks the file as dirty for synchronization.\n   * @param path - The path to the file.\n   * @param contents - The new contents of the file.\n   * @returns A result indicating success or failure.\n   */\n  public saveFileContents(path: string, contents: string): Result<string> {\n    const result = super.saveFileContents(path, contents);\n    if (result.isFailure()) {\n      return result;\n    }\n\n    this._dirtyFiles.add(path);\n    if (!this._autoSync) {\n      return result;\n    }\n\n    // fire-and-log-on-failure automatic sync for immediate persistence workflow\n    void this._runAutoSyncTask(path);\n    return result;\n  }\n\n  /**\n   * Checks if a file is mutable (can be modified).\n   * @param path - The path to the file.\n   * @returns A detailed result indicating if the file is mutable and the reason.\n   */\n  public fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail> {\n    const result = super.fileIsMutable(path);\n    if (result.isSuccess() && result.value === true) {\n      return succeedWithDetail(true, 'persistent');\n    }\n    return result;\n  }\n\n  /**\n   * Makes an HTTP request to the specified resource path.\n   * @param resourcePath - The path to the resource.\n   * @param init - Optional request initialization options.\n   * @returns A promise that resolves to a result containing the response data or an error message.\n   */\n  private async _request<T>(resourcePath: string, init?: RequestInit): Promise<Result<T>> {\n    const response = await this._fetchImpl(`${this._baseUrl}${resourcePath}`, {\n      headers: {\n        'Content-Type': 'application/json',\n        ...(this._userId ? { 'X-User-Id': this._userId } : {}),\n        /* c8 ignore next 1 - defensive coding: init.headers is never set by current callers */\n        ...(init?.headers ?? {})\n      },\n      ...init\n    }).catch((err: unknown) => ({ err } as const));\n\n    if ('err' in response) {\n      const message = response.err instanceof Error ? response.err.message : String(response.err);\n      return fail(message);\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => '');\n      const message = body\n        ? `HTTP ${response.status}: ${body}`\n        : `HTTP ${response.status} ${response.statusText}`;\n      return fail(message);\n    }\n\n    const json = await response.json().catch(() => undefined);\n    if (json === undefined) {\n      return fail('invalid JSON response');\n    }\n    return succeed(json as T);\n  }\n\n  /**\n   * Wraps `_request` with retry logic for transient failures\n   * (network errors, 503 service unavailable, etc.).\n   */\n  private async _requestWithRetry<T>(resourcePath: string, init?: RequestInit): Promise<Result<T>> {\n    const maxAttempts = 3;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      const result = await this._request<T>(resourcePath, init);\n      if (result.isSuccess() || attempt === maxAttempts) {\n        return result;\n      }\n      // Retry on transient-looking errors\n      const msg = result.message;\n      const lowerMsg = msg.toLowerCase();\n      const isTransient =\n        msg.includes('503') ||\n        msg.includes('502') ||\n        msg.includes('429') ||\n        lowerMsg.includes('disconnect') ||\n        lowerMsg.includes('econnreset') ||\n        lowerMsg.includes('failed to fetch') ||\n        lowerMsg.includes('network');\n      if (!isTransient) {\n        return result;\n      }\n      // Exponential backoff: 500ms, 1000ms\n      const delayMs = 500 * Math.pow(2, attempt - 1);\n      this._logger.detail(\n        `Retrying ${\n          init?.method ?? 'GET'\n        } ${resourcePath} after ${delayMs}ms (attempt ${attempt}/${maxAttempts})`\n      );\n      await new Promise((resolve) => setTimeout(resolve, delayMs));\n    }\n    /* c8 ignore next 1 - defensive coding: loop always returns */\n    return fail('retry loop exited unexpectedly');\n  }\n\n  /**\n   * Loads files from the HTTP backend for the specified directory path.\n   * @param params - Configuration parameters for the HTTP tree accessors.\n   * @param directoryPath - The path to the directory to load files from.\n   * @returns A promise that resolves to a result containing the loaded files or an error message.\n   */\n  private static async _loadFiles<TCT extends string = string>(\n    params: IHttpTreeParams<TCT>,\n    directoryPath: string\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const childrenResult = await this._requestWithParams<IHttpStorageTreeChildrenResponse>(\n      params,\n      '/tree/children',\n      {\n        path: directoryPath,\n        namespace: params.namespace\n      }\n    );\n    if (childrenResult.isFailure()) {\n      return fail(childrenResult.message);\n    }\n\n    const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (const item of childrenResult.value.children) {\n      if (item.type === 'directory') {\n        const nestedResult = await this._loadFiles(params, item.path);\n        if (nestedResult.isFailure()) {\n          return fail(nestedResult.message);\n        }\n        allFiles.push(...nestedResult.value);\n      } else {\n        const fileResult = await this._requestWithParams<IHttpStorageFileResponse>(params, '/file', {\n          path: item.path,\n          namespace: params.namespace\n        });\n        if (fileResult.isFailure()) {\n          return fail(fileResult.message);\n        }\n\n        const contentType = params.inferContentType?.(item.path, fileResult.value.contentType).orDefault();\n        allFiles.push({\n          path: item.path,\n          contents: fileResult.value.contents,\n          contentType\n        });\n      }\n    }\n\n    return succeed(allFiles);\n  }\n\n  /**\n   * Makes an HTTP request with query parameters to the specified resource path.\n   * @param params - Configuration parameters for the HTTP tree accessors.\n   * @param resourcePath - The path to the resource.\n   * @param query - Query parameters to include in the request.\n   * @returns A promise that resolves to a result containing the response data or an error message.\n   */\n  private static async _requestWithParams<T>(\n    params: IHttpTreeParams,\n    resourcePath: string,\n    query: Record<string, string | undefined>\n  ): Promise<Result<T>> {\n    const search = new URLSearchParams();\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined) {\n        search.set(key, value);\n      }\n    }\n\n    const fetchImpl = normalizeFetch(params.fetchImpl);\n    const userIdHeaders: RequestInit | undefined = /* c8 ignore next */ params.userId\n      ? { headers: { 'X-User-Id': params.userId } }\n      : undefined;\n    const response = await fetchImpl(\n      `${params.baseUrl.replace(/\\/$/, '')}${resourcePath}?${search.toString()}`,\n      userIdHeaders\n    ).catch((err: unknown) => ({ err } as const));\n\n    if ('err' in response) {\n      const message = response.err instanceof Error ? response.err.message : String(response.err);\n      return fail(message);\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => '');\n      const message = body\n        ? `HTTP ${response.status}: ${body}`\n        : `HTTP ${response.status} ${response.statusText}`;\n      return fail(message);\n    }\n\n    const json = await response.json().catch(() => undefined);\n    if (json === undefined) {\n      return fail('invalid JSON response');\n    }\n\n    return succeed(json as T);\n  }\n}\n"]}
+{"version":3,"file":"httpTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/httpTreeAccessors.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { DetailedResult, fail, type Result, succeed, succeedWithDetail, Logging } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n\ninterface IHttpStorageTreeItem {\n  readonly path: string;\n  readonly name: string;\n  readonly type: 'file' | 'directory';\n}\n\ninterface IHttpStorageTreeChildrenResponse {\n  readonly path: string;\n  readonly children: ReadonlyArray<IHttpStorageTreeItem>;\n}\n\ninterface IHttpStorageFileResponse {\n  readonly path: string;\n  readonly contents: string;\n  readonly contentType?: string;\n}\n\ninterface IHttpStorageSyncResponse {\n  readonly synced: number;\n}\n\nfunction normalizeFetch(fetchImpl?: typeof fetch): typeof fetch {\n  const resolved = fetchImpl ?? globalThis.fetch;\n  return resolved.bind(globalThis) as typeof fetch;\n}\n\n/**\n * Configuration for creating HTTP-backed tree accessors.\n * @public\n */\nexport interface IHttpTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {\n  readonly baseUrl: string;\n  readonly namespace?: string;\n  readonly autoSync?: boolean;\n  readonly fetchImpl?: typeof fetch;\n  readonly userId?: string;\n  readonly logger?: Logging.LogReporter<unknown>;\n}\n\n/**\n * HTTP-backed file tree accessors that cache data in memory and persist via REST API.\n * @public\n */\nexport class HttpTreeAccessors<TCT extends string = string>\n  extends FileTree.InMemoryTreeAccessors<TCT>\n  implements FileTree.IPersistentFileTreeAccessors<TCT>\n{\n  private readonly _baseUrl: string;\n  private readonly _namespace: string | undefined;\n  private readonly _fetchImpl: typeof fetch;\n  private readonly _dirtyFiles: Set<string> = new Set();\n  private readonly _pendingDeletions: Set<string> = new Set();\n  private readonly _autoSync: boolean;\n  private readonly _userId: string | undefined;\n  private readonly _logger: Logging.LogReporter<unknown>;\n\n  /** Guards against concurrent syncToDisk calls (thundering herd from autoSync). */\n  private _syncPromise: Promise<Result<void>> | undefined;\n\n  private constructor(files: FileTree.IInMemoryFile<TCT>[], params: IHttpTreeParams<TCT>) {\n    super(files, params);\n    this._baseUrl = params.baseUrl.replace(/\\/$/, '');\n    this._namespace = params.namespace;\n    this._fetchImpl = normalizeFetch(params.fetchImpl);\n    this._autoSync = params.autoSync ?? false;\n    this._userId = params.userId;\n    this._logger = params.logger ?? new Logging.LogReporter<unknown>();\n  }\n\n  private async _runAutoSyncTask(path: string): Promise<void> {\n    try {\n      const result = await this.syncToDisk();\n      if (result.isFailure()) {\n        this._logger.error(`Auto-sync failed for ${path}: ${result.message}`);\n      }\n    } catch (err) {\n      this._logger.error(`Auto-sync threw for ${path}: ${String(err)}`);\n    }\n  }\n\n  /**\n   * Creates a new HttpTreeAccessors instance from an HTTP backend.\n   * @param params - Configuration parameters for the HTTP tree accessors.\n   * @returns A promise that resolves to a result containing the new HttpTreeAccessors instance or an error message.\n   */\n  public static async fromHttp<TCT extends string = string>(\n    params: IHttpTreeParams<TCT>\n  ): Promise<Result<HttpTreeAccessors<TCT>>> {\n    const filesResult = await this._loadFiles<TCT>(params, '/');\n    if (filesResult.isFailure()) {\n      return fail(filesResult.message);\n    }\n    return succeed(new HttpTreeAccessors<TCT>(filesResult.value, params));\n  }\n\n  /**\n   * Synchronizes all dirty files to the HTTP backend.\n   *\n   * Uses a concurrency guard: if a sync is already in progress, callers\n   * await the existing operation rather than starting a parallel one.\n   * This prevents the thundering herd that occurs when autoSync fires\n   * for every file written during a bulk operation (e.g. restore).\n   *\n   * @returns A promise that resolves to a result indicating success or failure.\n   */\n  public async syncToDisk(): Promise<Result<void>> {\n    if (this._syncPromise) {\n      // Wait for the in-flight sync — it drains the queue in a loop,\n      // so any items added before it finishes will be included.\n      return this._syncPromise;\n    }\n\n    this._syncPromise = this._doSync().finally(() => {\n      this._syncPromise = undefined;\n    });\n    return this._syncPromise;\n  }\n\n  private async _doSync(): Promise<Result<void>> {\n    // Drain loop: keep processing as long as new items arrive.\n    // This is critical for bulk operations (e.g. reset) where many\n    // deleteFile/saveFileContents calls happen synchronously — only\n    // the first may be in the set when we snapshot, but the rest\n    // arrive during the async gaps and must be picked up before\n    // we return.\n    let didWork = false;\n    while (this._dirtyFiles.size > 0 || this._pendingDeletions.size > 0) {\n      didWork = true;\n      // Snapshot and clear so that changes arriving during the async\n      // requests land in the live sets for the next iteration.\n      const deletions = new Set(this._pendingDeletions);\n      const dirty = new Set(this._dirtyFiles);\n      this._pendingDeletions.clear();\n      this._dirtyFiles.clear();\n\n      for (const path of deletions) {\n        const query = new URLSearchParams();\n        query.set('path', path);\n        if (this._namespace) {\n          query.set('namespace', this._namespace);\n        }\n\n        const deleteResult = await this._requestWithRetry<{ deleted: boolean }>(`/file?${query.toString()}`, {\n          method: 'DELETE'\n        });\n        if (deleteResult.isFailure()) {\n          this._restoreUnsynced(deletions, dirty);\n          return fail(`delete ${path}: ${deleteResult.message}`);\n        }\n      }\n\n      for (const path of dirty) {\n        const contentsResult = this.getFileContents(path);\n        if (contentsResult.isFailure()) {\n          this._restoreUnsynced(deletions, dirty);\n          return fail(`${path}: ${contentsResult.message}`);\n        }\n\n        const body: Record<string, unknown> = {\n          path,\n          contents: contentsResult.value\n        };\n        if (this._namespace) {\n          body.namespace = this._namespace;\n        }\n\n        const saveResult = await this._requestWithRetry<IHttpStorageFileResponse>('/file', {\n          method: 'PUT',\n          body: JSON.stringify(body)\n        });\n        if (saveResult.isFailure()) {\n          this._restoreUnsynced(deletions, dirty);\n          return fail(`sync ${path}: ${saveResult.message}`);\n        }\n      }\n    }\n\n    if (didWork) {\n      const syncBody: Record<string, unknown> = {};\n      if (this._namespace) {\n        syncBody.namespace = this._namespace;\n      }\n\n      const syncResult = await this._requestWithRetry<IHttpStorageSyncResponse>('/sync', {\n        method: 'POST',\n        body: JSON.stringify(syncBody)\n      });\n\n      if (syncResult.isFailure()) {\n        return fail(syncResult.message);\n      }\n    }\n    return succeed(undefined);\n  }\n\n  /**\n   * Restores snapshotted items back into the live dirty sets so they\n   * are retried on the next sync attempt. Items that were added to\n   * the live sets while the sync was in flight are preserved.\n   */\n  private _restoreUnsynced(deletions: Set<string>, dirty: Set<string>): void {\n    for (const path of deletions) {\n      this._pendingDeletions.add(path);\n    }\n    for (const path of dirty) {\n      this._dirtyFiles.add(path);\n    }\n  }\n\n  /**\n   * Checks if there are any dirty files that need synchronization.\n   * @returns True if there are dirty files, false otherwise.\n   */\n  public isDirty(): boolean {\n    return this._dirtyFiles.size > 0 || this._pendingDeletions.size > 0;\n  }\n\n  /**\n   * Gets the list of paths for all dirty files.\n   * @returns An array of file paths that have been modified but not yet synchronized.\n   */\n  public getDirtyPaths(): string[] {\n    return [...Array.from(this._dirtyFiles), ...Array.from(this._pendingDeletions)];\n  }\n\n  public deleteFile(path: string): Result<boolean> {\n    const result = super.deleteFile(path);\n    if (result.isFailure()) {\n      return result;\n    }\n\n    this._dirtyFiles.delete(path);\n    this._pendingDeletions.add(path);\n\n    if (!this._autoSync) {\n      return result;\n    }\n\n    this._runAutoSyncTask(path).catch(() => undefined);\n    return result;\n  }\n\n  /**\n   * Saves file contents and marks the file as dirty for synchronization.\n   * @param path - The path to the file.\n   * @param contents - The new contents of the file.\n   * @returns A result indicating success or failure.\n   */\n  public saveFileContents(path: string, contents: string): Result<string> {\n    const result = super.saveFileContents(path, contents);\n    if (result.isFailure()) {\n      return result;\n    }\n\n    this._dirtyFiles.add(path);\n    if (!this._autoSync) {\n      return result;\n    }\n\n    // fire-and-log-on-failure automatic sync for immediate persistence workflow\n    this._runAutoSyncTask(path).catch(() => undefined);\n    return result;\n  }\n\n  /**\n   * Checks if a file is mutable (can be modified).\n   * @param path - The path to the file.\n   * @returns A detailed result indicating if the file is mutable and the reason.\n   */\n  public fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail> {\n    const result = super.fileIsMutable(path);\n    if (result.isSuccess() && result.value === true) {\n      return succeedWithDetail(true, 'persistent');\n    }\n    return result;\n  }\n\n  /**\n   * Makes an HTTP request to the specified resource path.\n   * @param resourcePath - The path to the resource.\n   * @param init - Optional request initialization options.\n   * @returns A promise that resolves to a result containing the response data or an error message.\n   */\n  private async _request<T>(resourcePath: string, init?: RequestInit): Promise<Result<T>> {\n    const response = await this._fetchImpl(`${this._baseUrl}${resourcePath}`, {\n      headers: {\n        'Content-Type': 'application/json',\n        ...(this._userId ? { 'X-User-Id': this._userId } : {}),\n        /* c8 ignore next 1 - defensive coding: init.headers is never set by current callers */\n        ...(init?.headers ?? {})\n      },\n      ...init\n    }).catch((err: unknown) => ({ err } as const));\n\n    if ('err' in response) {\n      const message = response.err instanceof Error ? response.err.message : String(response.err);\n      return fail(message);\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => '');\n      const message = body\n        ? `HTTP ${response.status}: ${body}`\n        : `HTTP ${response.status} ${response.statusText}`;\n      return fail(message);\n    }\n\n    const json = await response.json().catch(() => undefined);\n    if (json === undefined) {\n      return fail('invalid JSON response');\n    }\n    return succeed(json as T);\n  }\n\n  /**\n   * Wraps `_request` with retry logic for transient failures\n   * (network errors, 503 service unavailable, etc.).\n   */\n  private async _requestWithRetry<T>(resourcePath: string, init?: RequestInit): Promise<Result<T>> {\n    const maxAttempts = 3;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      const result = await this._request<T>(resourcePath, init);\n      if (result.isSuccess() || attempt === maxAttempts) {\n        return result;\n      }\n      // Retry on transient-looking errors\n      const msg = result.message;\n      const lowerMsg = msg.toLowerCase();\n      const isTransient =\n        msg.includes('503') ||\n        msg.includes('502') ||\n        msg.includes('429') ||\n        lowerMsg.includes('disconnect') ||\n        lowerMsg.includes('econnreset') ||\n        lowerMsg.includes('failed to fetch') ||\n        lowerMsg.includes('network');\n      if (!isTransient) {\n        return result;\n      }\n      // Exponential backoff: 500ms, 1000ms\n      const delayMs = 500 * Math.pow(2, attempt - 1);\n      this._logger.detail(\n        `Retrying ${\n          init?.method ?? 'GET'\n        } ${resourcePath} after ${delayMs}ms (attempt ${attempt}/${maxAttempts})`\n      );\n      await new Promise((resolve) => setTimeout(resolve, delayMs));\n    }\n    /* c8 ignore next 1 - defensive coding: loop always returns */\n    return fail('retry loop exited unexpectedly');\n  }\n\n  /**\n   * Loads files from the HTTP backend for the specified directory path.\n   * @param params - Configuration parameters for the HTTP tree accessors.\n   * @param directoryPath - The path to the directory to load files from.\n   * @returns A promise that resolves to a result containing the loaded files or an error message.\n   */\n  private static async _loadFiles<TCT extends string = string>(\n    params: IHttpTreeParams<TCT>,\n    directoryPath: string\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const childrenResult = await this._requestWithParams<IHttpStorageTreeChildrenResponse>(\n      params,\n      '/tree/children',\n      {\n        path: directoryPath,\n        namespace: params.namespace\n      }\n    );\n    if (childrenResult.isFailure()) {\n      return fail(childrenResult.message);\n    }\n\n    const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (const item of childrenResult.value.children) {\n      if (item.type === 'directory') {\n        const nestedResult = await this._loadFiles(params, item.path);\n        if (nestedResult.isFailure()) {\n          return fail(nestedResult.message);\n        }\n        allFiles.push(...nestedResult.value);\n      } else {\n        const fileResult = await this._requestWithParams<IHttpStorageFileResponse>(params, '/file', {\n          path: item.path,\n          namespace: params.namespace\n        });\n        if (fileResult.isFailure()) {\n          return fail(fileResult.message);\n        }\n\n        const contentType = params.inferContentType?.(item.path, fileResult.value.contentType).orDefault();\n        allFiles.push({\n          path: item.path,\n          contents: fileResult.value.contents,\n          contentType\n        });\n      }\n    }\n\n    return succeed(allFiles);\n  }\n\n  /**\n   * Makes an HTTP request with query parameters to the specified resource path.\n   * @param params - Configuration parameters for the HTTP tree accessors.\n   * @param resourcePath - The path to the resource.\n   * @param query - Query parameters to include in the request.\n   * @returns A promise that resolves to a result containing the response data or an error message.\n   */\n  private static async _requestWithParams<T>(\n    params: IHttpTreeParams,\n    resourcePath: string,\n    query: Record<string, string | undefined>\n  ): Promise<Result<T>> {\n    const search = new URLSearchParams();\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined) {\n        search.set(key, value);\n      }\n    }\n\n    const fetchImpl = normalizeFetch(params.fetchImpl);\n    const userIdHeaders: RequestInit | undefined = /* c8 ignore next */ params.userId\n      ? { headers: { 'X-User-Id': params.userId } }\n      : undefined;\n    const response = await fetchImpl(\n      `${params.baseUrl.replace(/\\/$/, '')}${resourcePath}?${search.toString()}`,\n      userIdHeaders\n    ).catch((err: unknown) => ({ err } as const));\n\n    if ('err' in response) {\n      const message = response.err instanceof Error ? response.err.message : String(response.err);\n      return fail(message);\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => '');\n      const message = body\n        ? `HTTP ${response.status}: ${body}`\n        : `HTTP ${response.status} ${response.statusText}`;\n      return fail(message);\n    }\n\n    const json = await response.json().catch(() => undefined);\n    if (json === undefined) {\n      return fail('invalid JSON response');\n    }\n\n    return succeed(json as T);\n  }\n}\n"]}

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

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

package/lib/packlets/helpers/fileTreeHelpers.d.ts

@@ -1,6 +1,6 @@
 import { Result } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
-import { IFileMetadata } from '../file-tree/fileApiTreeAccessors';
+import { IFileMetadata } from '../file-tree';
 /**
  * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.
  * @public

package/lib/packlets/helpers/fileTreeHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileTreeHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAwB,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAE7E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAG5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAG5C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CAE7D"}
+{"version":3,"file":"fileTreeHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAwB,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAE7E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAG5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAG5C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CAE7D"}

package/lib/packlets/helpers/fileTreeHelpers.js

@@ -28,7 +28,7 @@ exports.getOriginalFile = getOriginalFile;
 exports.extractFileListMetadata = extractFileListMetadata;
 exports.extractFileMetadata = extractFileMetadata;
 const ts_json_base_1 = require("@fgv/ts-json-base");
-const fileApiTreeAccessors_1 = require("../file-tree/fileApiTreeAccessors");
+const file_tree_1 = require("../file-tree");
 /**
  * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.
  * @public
@@ -51,7 +51,7 @@ exports.defaultFileApiTreeInitParams = {
  */
 function fromFileList(fileList, params) {
     params = Object.assign(Object.assign({}, exports.defaultFileApiTreeInitParams), (params !== null && params !== void 0 ? params : {}));
-    return fileApiTreeAccessors_1.FileApiTreeAccessors.fromFileList(fileList, params);
+    return file_tree_1.FileApiTreeAccessors.fromFileList(fileList, params);
 }
 /**
  * Helper function to create a new FileTree instance
@@ -68,7 +68,7 @@ function fromFileList(fileList, params) {
  */
 function fromDirectoryUpload(fileList, params) {
     params = Object.assign(Object.assign({}, exports.defaultFileApiTreeInitParams), (params !== null && params !== void 0 ? params : {}));
-    return fileApiTreeAccessors_1.FileApiTreeAccessors.fromDirectoryUpload(fileList, params);
+    return file_tree_1.FileApiTreeAccessors.fromDirectoryUpload(fileList, params);
 }
 /**
  * Helper function to get the original File object from a FileList by path.
@@ -79,7 +79,7 @@ function fromDirectoryUpload(fileList, params) {
  * @public
  */
 function getOriginalFile(fileList, path) {
-    return fileApiTreeAccessors_1.FileApiTreeAccessors.getOriginalFile(fileList, path);
+    return file_tree_1.FileApiTreeAccessors.getOriginalFile(fileList, path);
 }
 /**
  * Helper function to extract metadata from a `FileList`.
@@ -88,7 +88,7 @@ function getOriginalFile(fileList, path) {
  * @public
  */
 function extractFileListMetadata(fileList) {
-    return Array.from(fileList).map((f) => fileApiTreeAccessors_1.FileApiTreeAccessors.extractFileMetadata(f));
+    return Array.from(fileList).map((f) => file_tree_1.FileApiTreeAccessors.extractFileMetadata(f));
 }
 /**
  * Helper function to extract metadata from a `File`.
@@ -97,6 +97,6 @@ function extractFileListMetadata(fileList) {
  * @public
  */
 function extractFileMetadata(file) {
-    return fileApiTreeAccessors_1.FileApiTreeAccessors.extractFileMetadata(file);
+    return file_tree_1.FileApiTreeAccessors.extractFileMetadata(file);
 }
 //# sourceMappingURL=fileTreeHelpers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fileTreeHelpers.js","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA2BH,oCAMC;AAeD,kDAMC;AAUD,0CAEC;AAQD,0DAEC;AAQD,kDAEC;AAnFD,oDAA6C;AAC7C,4EAAwF;AAExF;;;GAGG;AACU,QAAA,4BAA4B,GAAyC;IAChF,gBAAgB,EAAE,uBAAQ,CAAC,QAAQ,CAAC,wBAAwB;CAC7D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAC1B,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,oCAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,2CAAoB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CACjC,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,oCAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,2CAAoB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,QAAkB,EAAE,IAAY;IAC9D,OAAO,2CAAoB,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,QAAkB;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,2CAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,IAAU;IAC5C,OAAO,2CAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { FileApiTreeAccessors, IFileMetadata } from '../file-tree/fileApiTreeAccessors';\n\n/**\n * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.\n * @public\n */\nexport const defaultFileApiTreeInitParams: FileTree.IFileTreeInitParams<string> = {\n  inferContentType: FileTree.FileItem.defaultAcceptContentType\n};\n\n/**\n * Helper function to create a new FileTree instance\n * from a browser FileList (e.g., from input[type=\"file\"]).\n * @param fileList - FileList from a file input element\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromFileList(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromFileList(fileList, params);\n}\n\n/**\n * Helper function to create a new FileTree instance\n * from a directory upload with webkitRelativePath support.\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * is used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromDirectoryUpload(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromDirectoryUpload(fileList, params);\n}\n\n/**\n * Helper function to get the original File object from a FileList by path.\n * @param fileList - The original FileList\n * @param path - The path to the file\n * @returns A successful Result with the File object if found,\n * or a failed Result with an error message otherwise\n * @public\n */\nexport function getOriginalFile(fileList: FileList, path: string): Result<File> {\n  return FileApiTreeAccessors.getOriginalFile(fileList, path);\n}\n\n/**\n * Helper function to extract metadata from a `FileList`.\n * @param fileList - The `FileList` to extract metadata from\n * @returns Array of {@link IFileMetadata | file metadata} objects\n * @public\n */\nexport function extractFileListMetadata(fileList: FileList): Array<IFileMetadata> {\n  return Array.from(fileList).map((f) => FileApiTreeAccessors.extractFileMetadata(f));\n}\n\n/**\n * Helper function to extract metadata from a `File`.\n * @param file - The File to extract metadata from\n * @returns {@link IFileMetadata | file metadata} object\n * @public\n */\nexport function extractFileMetadata(file: File): IFileMetadata {\n  return FileApiTreeAccessors.extractFileMetadata(file);\n}\n"]}
+{"version":3,"file":"fileTreeHelpers.js","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA2BH,oCAMC;AAeD,kDAMC;AAUD,0CAEC;AAQD,0DAEC;AAQD,kDAEC;AAnFD,oDAA6C;AAC7C,4CAAmE;AAEnE;;;GAGG;AACU,QAAA,4BAA4B,GAAyC;IAChF,gBAAgB,EAAE,uBAAQ,CAAC,QAAQ,CAAC,wBAAwB;CAC7D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAC1B,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,oCAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,gCAAoB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CACjC,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,oCAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,gCAAoB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,QAAkB,EAAE,IAAY;IAC9D,OAAO,gCAAoB,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,QAAkB;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gCAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,IAAU;IAC5C,OAAO,gCAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { FileApiTreeAccessors, IFileMetadata } from '../file-tree';\n\n/**\n * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.\n * @public\n */\nexport const defaultFileApiTreeInitParams: FileTree.IFileTreeInitParams<string> = {\n  inferContentType: FileTree.FileItem.defaultAcceptContentType\n};\n\n/**\n * Helper function to create a new FileTree instance\n * from a browser FileList (e.g., from input[type=\"file\"]).\n * @param fileList - FileList from a file input element\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromFileList(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromFileList(fileList, params);\n}\n\n/**\n * Helper function to create a new FileTree instance\n * from a directory upload with webkitRelativePath support.\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * is used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromDirectoryUpload(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromDirectoryUpload(fileList, params);\n}\n\n/**\n * Helper function to get the original File object from a FileList by path.\n * @param fileList - The original FileList\n * @param path - The path to the file\n * @returns A successful Result with the File object if found,\n * or a failed Result with an error message otherwise\n * @public\n */\nexport function getOriginalFile(fileList: FileList, path: string): Result<File> {\n  return FileApiTreeAccessors.getOriginalFile(fileList, path);\n}\n\n/**\n * Helper function to extract metadata from a `FileList`.\n * @param fileList - The `FileList` to extract metadata from\n * @returns Array of {@link IFileMetadata | file metadata} objects\n * @public\n */\nexport function extractFileListMetadata(fileList: FileList): Array<IFileMetadata> {\n  return Array.from(fileList).map((f) => FileApiTreeAccessors.extractFileMetadata(f));\n}\n\n/**\n * Helper function to extract metadata from a `File`.\n * @param file - The File to extract metadata from\n * @returns {@link IFileMetadata | file metadata} object\n * @public\n */\nexport function extractFileMetadata(file: File): IFileMetadata {\n  return FileApiTreeAccessors.extractFileMetadata(file);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-web-extras",
-  "version": "5.1.0-4",
+  "version": "5.1.0-41",
   "description": "Browser-compatible utilities and FileTree implementations",
   "main": "lib/index.js",
   "types": "dist/ts-web-extras.d.ts",
@@ -46,19 +46,20 @@
     "@types/react": "~19.2.8",
     "typedoc": "~0.28.16",
     "typedoc-plugin-markdown": "~4.9.0",
-    "@fgv/heft-dual-rig": "5.1.0-4",
-    "@fgv/typedoc-compact-theme": "5.1.0-4",
-    "@fgv/ts-json-base": "5.1.0-4",
-    "@fgv/ts-utils-jest": "5.1.0-4",
-    "@fgv/ts-utils": "5.1.0-4",
-    "@fgv/ts-extras": "5.1.0-4"
+    "fake-indexeddb": "~6.2.5",
+    "@fgv/heft-dual-rig": "5.1.0-41",
+    "@fgv/ts-utils": "5.1.0-41",
+    "@fgv/ts-json-base": "5.1.0-41",
+    "@fgv/ts-extras": "5.1.0-41",
+    "@fgv/typedoc-compact-theme": "5.1.0-41",
+    "@fgv/ts-utils-jest": "5.1.0-41"
   },
   "peerDependencies": {
     "react": ">=18 <20",
     "react-dom": ">=18 <20",
-    "@fgv/ts-json-base": "5.1.0-4",
-    "@fgv/ts-extras": "5.1.0-4",
-    "@fgv/ts-utils": "5.1.0-4"
+    "@fgv/ts-extras": "5.1.0-41",
+    "@fgv/ts-utils": "5.1.0-41",
+    "@fgv/ts-json-base": "5.1.0-41"
   },
   "exports": {
     ".": {
@@ -81,14 +82,14 @@
     "idb-keyval": "^6.2.2"
   },
   "scripts": {
-    "build": "heft test --clean",
+    "build": "NODE_OPTIONS=--disable-warning=DEP0040 heft test --clean",
     "clean": "heft clean",
-    "test": "heft test --clean",
+    "test": "NODE_OPTIONS=--disable-warning=DEP0040 heft test --clean",
     "build-docs": "typedoc --options ./config/typedoc.json",
     "build-all": "rushx build; rushx build-docs",
-    "test-handles": "jest --runInBand --detectOpenHandles",
+    "test-handles": "NODE_OPTIONS=--disable-warning=DEP0040 jest --runInBand --detectOpenHandles",
     "clean-jest": "jest --clear-cache",
-    "coverage": "jest --coverage",
+    "coverage": "NODE_OPTIONS=--disable-warning=DEP0040 jest --coverage",
     "lint": "eslint src --ext .ts",
     "fixlint": "eslint src --ext .ts --fix"
   }