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

package/dist/packlets/crypto-utils/idbPrivateKeyStorage.js

@@ -0,0 +1,238 @@
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { captureAsyncResult, captureResult, fail, succeed } from '@fgv/ts-utils';
+const DEFAULT_DATABASE_NAME = 'fgv-keystore-private-keys';
+const DEFAULT_STORE_NAME = 'privateKeys';
+/**
+ * {@link CryptoUtils.KeyStore.IPrivateKeyStorage | IPrivateKeyStorage}
+ * implementation backed by IndexedDB. Stores `CryptoKey` objects directly via
+ * IndexedDB's structured-clone serialization — no JWK round-trip — so it works
+ * with non-extractable keys.
+ *
+ * `supportsNonExtractable` is `true`: because the `CryptoKey` is stored by
+ * reference (structured clone) rather than exported, the keystore may generate
+ * `extractable: false` keys for maximum security on browsers that support it.
+ *
+ * The database is opened lazily on first use and cached. Each operation runs in
+ * its own transaction, relying on IndexedDB's default serialization. Multi-tab
+ * concurrency is a known limitation: two tabs writing the same id can race; this
+ * implementation targets single-tab use.
+ *
+ * @public
+ */
+export class IdbPrivateKeyStorage {
+    constructor(factory, databaseName, storeName) {
+        /**
+         * `true` — IndexedDB stores `CryptoKey` objects directly, so non-extractable
+         * keys are supported.
+         */
+        this.supportsNonExtractable = true;
+        this._factory = factory;
+        this._databaseName = databaseName;
+        this._storeName = storeName;
+    }
+    /**
+     * Creates a new {@link CryptoUtils.IdbPrivateKeyStorage}.
+     * @param params - Optional {@link CryptoUtils.IIdbPrivateKeyStorageCreateParams}.
+     * @returns `Success` with the new instance, or `Failure` if no IndexedDB
+     * factory is available.
+     */
+    static create(params = {}) {
+        var _a, _b, _c;
+        const factory = (_a = params.indexedDB) !== null && _a !== void 0 ? _a : globalThis.indexedDB;
+        if (factory === undefined) {
+            return fail('IdbPrivateKeyStorage: no IndexedDB factory available (pass params.indexedDB)');
+        }
+        return succeed(new IdbPrivateKeyStorage(factory, (_b = params.databaseName) !== null && _b !== void 0 ? _b : DEFAULT_DATABASE_NAME, (_c = params.storeName) !== null && _c !== void 0 ? _c : DEFAULT_STORE_NAME));
+    }
+    /**
+     * Stores `key` under `id`.
+     * @param id - Storage handle to write under.
+     * @param key - The private `CryptoKey` to persist.
+     */
+    async store(id, key) {
+        if (key.type !== 'private') {
+            return fail(`failed to store private key '${id}': expected a private key, got '${key.type}'`);
+        }
+        return (await this._withStore('readwrite', (store) => this._request(store.put(key, id))))
+            .withErrorFormat((msg) => `failed to store private key '${id}': ${msg}`)
+            .onSuccess(() => succeed(id));
+    }
+    /**
+     * Loads the private key stored under `id`.
+     * @param id - Storage handle to look up.
+     */
+    async load(id) {
+        return (await this._getRaw(id))
+            .withErrorFormat((msg) => `failed to load private key '${id}': ${msg}`)
+            .onSuccess((key) => (key === undefined ? fail(`key not found: '${id}'`) : succeed(key)));
+    }
+    /**
+     * Deletes the entry stored under `id`. Missing ids fail, mirroring the
+     * encrypted-file backend. The existence check and the delete run in separate
+     * transactions (single-tab assumption).
+     * @param id - Storage handle to remove.
+     */
+    async delete(id) {
+        const existingResult = await this._getRaw(id);
+        /* c8 ignore next 3 - defensive: the existence-check read only fails on an IndexedDB environment error */
+        if (existingResult.isFailure()) {
+            return fail(`failed to delete private key '${id}': ${existingResult.message}`);
+        }
+        if (existingResult.value === undefined) {
+            return fail(`key not found: '${id}'`);
+        }
+        return (await this._withStore('readwrite', (store) => this._request(store.delete(id))))
+            .withErrorFormat((msg) => `failed to delete private key '${id}': ${msg}`)
+            .onSuccess(() => succeed(id));
+    }
+    /**
+     * Lists every stored id.
+     */
+    async list() {
+        return (await this._withStore('readonly', (store) => this._request(store.getAllKeys())))
+            .withErrorFormat((msg) => `failed to list private keys: ${msg}`)
+            .onSuccess((keys) => succeed(keys.map((key) => String(key))));
+    }
+    async _getRaw(id) {
+        return this._withStore('readonly', (store) => this._request(store.get(id)));
+    }
+    async _openDb() {
+        if (this._db !== undefined) {
+            return succeed(this._db);
+        }
+        const firstOpen = await this._open(undefined);
+        /* c8 ignore next 3 - defensive: database open only fails on a corrupted/blocked IndexedDB environment */
+        if (firstOpen.isFailure()) {
+            return firstOpen;
+        }
+        // The object store is created in `onupgradeneeded`, which only fires when
+        // the version changes. If a database at this name already existed at the
+        // current version but without our store (e.g. a different `storeName` than
+        // a prior instance used), the store is absent. Re-open at the next version
+        // to add it via a version-bump upgrade rather than failing later writes
+        // with NotFoundError.
+        let db = firstOpen.value;
+        if (!db.objectStoreNames.contains(this._storeName)) {
+            const nextVersion = db.version + 1;
+            db.close();
+            const reopen = await this._open(nextVersion);
+            /* c8 ignore next 3 - defensive: the version-bump re-open only fails on an IndexedDB environment fault */
+            if (reopen.isFailure()) {
+                return reopen;
+            }
+            db = reopen.value;
+        }
+        this._db = db;
+        return succeed(db);
+    }
+    async _open(version) {
+        return captureAsyncResult(() => new Promise((resolve, reject) => {
+            const request = version === undefined
+                ? this._factory.open(this._databaseName)
+                : this._factory.open(this._databaseName, version);
+            request.onupgradeneeded = () => {
+                // Create our object store if absent. This fires on initial creation
+                // and on the version bump used to add a store to an existing
+                // database; future schema migrations extend this hook additively.
+                if (!request.result.objectStoreNames.contains(this._storeName)) {
+                    request.result.createObjectStore(this._storeName);
+                }
+            };
+            request.onsuccess = () => {
+                const db = request.result;
+                // If another connection (e.g. a sibling instance adding a store via
+                // version bump, or another tab) needs to upgrade, close this one so
+                // we don't block it. Clear the cached handle first so the next
+                // operation reopens rather than reusing the now-closed connection.
+                // Single-tab use is the documented assumption; this just prevents a
+                // deadlock when several instances share a db.
+                db.onversionchange = () => {
+                    if (this._db === db) {
+                        this._db = undefined;
+                    }
+                    db.close();
+                };
+                resolve(db);
+            };
+            /* c8 ignore next 2 - defensive: open errors require a corrupted/blocked IndexedDB environment */
+            request.onerror = () => { var _a; return reject((_a = request.error) !== null && _a !== void 0 ? _a : new Error('IndexedDB open failed')); };
+        }));
+    }
+    async _withStore(mode, op) {
+        const dbResult = await this._openDb();
+        /* c8 ignore next 3 - defensive: database open only fails on a corrupted/blocked IndexedDB environment */
+        if (dbResult.isFailure()) {
+            return fail(dbResult.message);
+        }
+        const txnResult = captureResult(() => dbResult.value.transaction(this._storeName, mode));
+        /* c8 ignore next 3 - transaction creation only throws if the store was deleted out from under us */
+        if (txnResult.isFailure()) {
+            return fail(txnResult.message);
+        }
+        const transaction = txnResult.value;
+        // For writes, a successful request is not durable until the transaction
+        // commits (oncomplete); it can still abort afterwards. Attach the completion
+        // listener BEFORE issuing the request so no event is missed, and wait for it
+        // before reporting success. Reads need no such wait.
+        const completion = mode === 'readwrite' ? this._awaitCompletion(transaction) : undefined;
+        // `op` builds and issues the IDB request synchronously (e.g. `store.put`),
+        // which can throw before any Promise is created — DataCloneError on a
+        // non-cloneable value, or a transaction-state DOMException. Run it inside a
+        // capture boundary so those surface as Failure rather than a rejection,
+        // preserving the Result contract.
+        const opOuter = await captureAsyncResult(() => op(transaction.objectStore(this._storeName)));
+        /* c8 ignore next 3 - defensive: synchronous IDB throws (e.g. DataCloneError) are unreachable for the typed public surface (private CryptoKeys clone; reads pass a string id), but the capture preserves the Result contract */
+        if (opOuter.isFailure()) {
+            return fail(opOuter.message);
+        }
+        const opResult = opOuter.value;
+        /* c8 ignore next 3 - defensive: the request itself only fails on an IndexedDB environment fault */
+        if (opResult.isFailure()) {
+            return opResult;
+        }
+        if (completion !== undefined) {
+            const commitResult = await completion;
+            /* c8 ignore next 3 - defensive: a transaction abort after a successful request requires an IndexedDB environment fault */
+            if (commitResult.isFailure()) {
+                return fail(commitResult.message);
+            }
+        }
+        return opResult;
+    }
+    async _request(request) {
+        return captureAsyncResult(() => new Promise((resolve, reject) => {
+            request.onsuccess = () => resolve(request.result);
+            /* c8 ignore next 2 - defensive: per-request errors require a corrupted IndexedDB environment */
+            request.onerror = () => { var _a; return reject((_a = request.error) !== null && _a !== void 0 ? _a : new Error('IndexedDB request failed')); };
+        }));
+    }
+    async _awaitCompletion(transaction) {
+        return captureAsyncResult(() => new Promise((resolve, reject) => {
+            transaction.oncomplete = () => resolve(true);
+            /* c8 ignore next 4 - defensive: abort/error after a successful write requires an IndexedDB environment fault */
+            transaction.onabort = () => { var _a; return reject((_a = transaction.error) !== null && _a !== void 0 ? _a : new Error('IndexedDB transaction aborted')); };
+            transaction.onerror = () => { var _a; return reject((_a = transaction.error) !== null && _a !== void 0 ? _a : new Error('IndexedDB transaction error')); };
+        }));
+    }
+}
+//# sourceMappingURL=idbPrivateKeyStorage.js.map

package/dist/packlets/crypto-utils/idbPrivateKeyStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idbPrivateKeyStorage.js","sourceRoot":"","sources":["../../../src/packlets/crypto-utils/idbPrivateKeyStorage.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 { captureAsyncResult, captureResult, fail, Result, succeed } from '@fgv/ts-utils';\nimport { CryptoUtils } from '@fgv/ts-extras';\n\n/**\n * Parameters for {@link CryptoUtils.IdbPrivateKeyStorage.create}.\n * @public\n */\nexport interface IIdbPrivateKeyStorageCreateParams {\n  /**\n   * IndexedDB database name. Default: `'fgv-keystore-private-keys'`.\n   */\n  readonly databaseName?: string;\n\n  /**\n   * IndexedDB object-store name. Default: `'privateKeys'`.\n   */\n  readonly storeName?: string;\n\n  /**\n   * IndexedDB factory to use. Defaults to `globalThis.indexedDB`. Supplied\n   * explicitly in tests (e.g. a `fake-indexeddb` factory) or to target a\n   * non-default factory.\n   */\n  readonly indexedDB?: IDBFactory;\n}\n\nconst DEFAULT_DATABASE_NAME: string = 'fgv-keystore-private-keys';\nconst DEFAULT_STORE_NAME: string = 'privateKeys';\n\n/**\n * {@link CryptoUtils.KeyStore.IPrivateKeyStorage | IPrivateKeyStorage}\n * implementation backed by IndexedDB. Stores `CryptoKey` objects directly via\n * IndexedDB's structured-clone serialization — no JWK round-trip — so it works\n * with non-extractable keys.\n *\n * `supportsNonExtractable` is `true`: because the `CryptoKey` is stored by\n * reference (structured clone) rather than exported, the keystore may generate\n * `extractable: false` keys for maximum security on browsers that support it.\n *\n * The database is opened lazily on first use and cached. Each operation runs in\n * its own transaction, relying on IndexedDB's default serialization. Multi-tab\n * concurrency is a known limitation: two tabs writing the same id can race; this\n * implementation targets single-tab use.\n *\n * @public\n */\nexport class IdbPrivateKeyStorage implements CryptoUtils.KeyStore.IPrivateKeyStorage {\n  /**\n   * `true` — IndexedDB stores `CryptoKey` objects directly, so non-extractable\n   * keys are supported.\n   */\n  public readonly supportsNonExtractable: true = true;\n\n  private readonly _factory: IDBFactory;\n  private readonly _databaseName: string;\n  private readonly _storeName: string;\n  private _db: IDBDatabase | undefined;\n\n  private constructor(factory: IDBFactory, databaseName: string, storeName: string) {\n    this._factory = factory;\n    this._databaseName = databaseName;\n    this._storeName = storeName;\n  }\n\n  /**\n   * Creates a new {@link CryptoUtils.IdbPrivateKeyStorage}.\n   * @param params - Optional {@link CryptoUtils.IIdbPrivateKeyStorageCreateParams}.\n   * @returns `Success` with the new instance, or `Failure` if no IndexedDB\n   * factory is available.\n   */\n  public static create(params: IIdbPrivateKeyStorageCreateParams = {}): Result<IdbPrivateKeyStorage> {\n    const factory: IDBFactory | undefined = params.indexedDB ?? globalThis.indexedDB;\n    if (factory === undefined) {\n      return fail('IdbPrivateKeyStorage: no IndexedDB factory available (pass params.indexedDB)');\n    }\n    return succeed(\n      new IdbPrivateKeyStorage(\n        factory,\n        params.databaseName ?? DEFAULT_DATABASE_NAME,\n        params.storeName ?? DEFAULT_STORE_NAME\n      )\n    );\n  }\n\n  /**\n   * Stores `key` under `id`.\n   * @param id - Storage handle to write under.\n   * @param key - The private `CryptoKey` to persist.\n   */\n  public async store(id: string, key: CryptoKey): Promise<Result<string>> {\n    if (key.type !== 'private') {\n      return fail(`failed to store private key '${id}': expected a private key, got '${key.type}'`);\n    }\n    return (await this._withStore('readwrite', (store) => this._request(store.put(key, id))))\n      .withErrorFormat((msg) => `failed to store private key '${id}': ${msg}`)\n      .onSuccess(() => succeed(id));\n  }\n\n  /**\n   * Loads the private key stored under `id`.\n   * @param id - Storage handle to look up.\n   */\n  public async load(id: string): Promise<Result<CryptoKey>> {\n    return (await this._getRaw(id))\n      .withErrorFormat((msg) => `failed to load private key '${id}': ${msg}`)\n      .onSuccess((key) => (key === undefined ? fail(`key not found: '${id}'`) : succeed(key)));\n  }\n\n  /**\n   * Deletes the entry stored under `id`. Missing ids fail, mirroring the\n   * encrypted-file backend. The existence check and the delete run in separate\n   * transactions (single-tab assumption).\n   * @param id - Storage handle to remove.\n   */\n  public async delete(id: string): Promise<Result<string>> {\n    const existingResult = await this._getRaw(id);\n    /* c8 ignore next 3 - defensive: the existence-check read only fails on an IndexedDB environment error */\n    if (existingResult.isFailure()) {\n      return fail(`failed to delete private key '${id}': ${existingResult.message}`);\n    }\n    if (existingResult.value === undefined) {\n      return fail(`key not found: '${id}'`);\n    }\n    return (await this._withStore('readwrite', (store) => this._request(store.delete(id))))\n      .withErrorFormat((msg) => `failed to delete private key '${id}': ${msg}`)\n      .onSuccess(() => succeed(id));\n  }\n\n  /**\n   * Lists every stored id.\n   */\n  public async list(): Promise<Result<readonly string[]>> {\n    return (await this._withStore('readonly', (store) => this._request<IDBValidKey[]>(store.getAllKeys())))\n      .withErrorFormat((msg) => `failed to list private keys: ${msg}`)\n      .onSuccess((keys) => succeed(keys.map((key) => String(key))));\n  }\n\n  private async _getRaw(id: string): Promise<Result<CryptoKey | undefined>> {\n    return this._withStore('readonly', (store) => this._request<CryptoKey | undefined>(store.get(id)));\n  }\n\n  private async _openDb(): Promise<Result<IDBDatabase>> {\n    if (this._db !== undefined) {\n      return succeed(this._db);\n    }\n    const firstOpen = await this._open(undefined);\n    /* c8 ignore next 3 - defensive: database open only fails on a corrupted/blocked IndexedDB environment */\n    if (firstOpen.isFailure()) {\n      return firstOpen;\n    }\n    // The object store is created in `onupgradeneeded`, which only fires when\n    // the version changes. If a database at this name already existed at the\n    // current version but without our store (e.g. a different `storeName` than\n    // a prior instance used), the store is absent. Re-open at the next version\n    // to add it via a version-bump upgrade rather than failing later writes\n    // with NotFoundError.\n    let db = firstOpen.value;\n    if (!db.objectStoreNames.contains(this._storeName)) {\n      const nextVersion = db.version + 1;\n      db.close();\n      const reopen = await this._open(nextVersion);\n      /* c8 ignore next 3 - defensive: the version-bump re-open only fails on an IndexedDB environment fault */\n      if (reopen.isFailure()) {\n        return reopen;\n      }\n      db = reopen.value;\n    }\n    this._db = db;\n    return succeed(db);\n  }\n\n  private async _open(version: number | undefined): Promise<Result<IDBDatabase>> {\n    return captureAsyncResult<IDBDatabase>(\n      () =>\n        new Promise<IDBDatabase>((resolve, reject) => {\n          const request =\n            version === undefined\n              ? this._factory.open(this._databaseName)\n              : this._factory.open(this._databaseName, version);\n          request.onupgradeneeded = (): void => {\n            // Create our object store if absent. This fires on initial creation\n            // and on the version bump used to add a store to an existing\n            // database; future schema migrations extend this hook additively.\n            if (!request.result.objectStoreNames.contains(this._storeName)) {\n              request.result.createObjectStore(this._storeName);\n            }\n          };\n          request.onsuccess = (): void => {\n            const db = request.result;\n            // If another connection (e.g. a sibling instance adding a store via\n            // version bump, or another tab) needs to upgrade, close this one so\n            // we don't block it. Clear the cached handle first so the next\n            // operation reopens rather than reusing the now-closed connection.\n            // Single-tab use is the documented assumption; this just prevents a\n            // deadlock when several instances share a db.\n            db.onversionchange = (): void => {\n              if (this._db === db) {\n                this._db = undefined;\n              }\n              db.close();\n            };\n            resolve(db);\n          };\n          /* c8 ignore next 2 - defensive: open errors require a corrupted/blocked IndexedDB environment */\n          request.onerror = (): void => reject(request.error ?? new Error('IndexedDB open failed'));\n        })\n    );\n  }\n\n  private async _withStore<T>(\n    mode: IDBTransactionMode,\n    op: (store: IDBObjectStore) => Promise<Result<T>>\n  ): Promise<Result<T>> {\n    const dbResult = await this._openDb();\n    /* c8 ignore next 3 - defensive: database open only fails on a corrupted/blocked IndexedDB environment */\n    if (dbResult.isFailure()) {\n      return fail(dbResult.message);\n    }\n    const txnResult = captureResult(() => dbResult.value.transaction(this._storeName, mode));\n    /* c8 ignore next 3 - transaction creation only throws if the store was deleted out from under us */\n    if (txnResult.isFailure()) {\n      return fail(txnResult.message);\n    }\n    const transaction = txnResult.value;\n\n    // For writes, a successful request is not durable until the transaction\n    // commits (oncomplete); it can still abort afterwards. Attach the completion\n    // listener BEFORE issuing the request so no event is missed, and wait for it\n    // before reporting success. Reads need no such wait.\n    const completion = mode === 'readwrite' ? this._awaitCompletion(transaction) : undefined;\n\n    // `op` builds and issues the IDB request synchronously (e.g. `store.put`),\n    // which can throw before any Promise is created — DataCloneError on a\n    // non-cloneable value, or a transaction-state DOMException. Run it inside a\n    // capture boundary so those surface as Failure rather than a rejection,\n    // preserving the Result contract.\n    const opOuter = await captureAsyncResult(() => op(transaction.objectStore(this._storeName)));\n    /* c8 ignore next 3 - defensive: synchronous IDB throws (e.g. DataCloneError) are unreachable for the typed public surface (private CryptoKeys clone; reads pass a string id), but the capture preserves the Result contract */\n    if (opOuter.isFailure()) {\n      return fail(opOuter.message);\n    }\n    const opResult = opOuter.value;\n    /* c8 ignore next 3 - defensive: the request itself only fails on an IndexedDB environment fault */\n    if (opResult.isFailure()) {\n      return opResult;\n    }\n    if (completion !== undefined) {\n      const commitResult = await completion;\n      /* c8 ignore next 3 - defensive: a transaction abort after a successful request requires an IndexedDB environment fault */\n      if (commitResult.isFailure()) {\n        return fail(commitResult.message);\n      }\n    }\n    return opResult;\n  }\n\n  private async _request<T>(request: IDBRequest<T>): Promise<Result<T>> {\n    return captureAsyncResult<T>(\n      () =>\n        new Promise<T>((resolve, reject) => {\n          request.onsuccess = (): void => resolve(request.result);\n          /* c8 ignore next 2 - defensive: per-request errors require a corrupted IndexedDB environment */\n          request.onerror = (): void => reject(request.error ?? new Error('IndexedDB request failed'));\n        })\n    );\n  }\n\n  private async _awaitCompletion(transaction: IDBTransaction): Promise<Result<true>> {\n    return captureAsyncResult<true>(\n      () =>\n        new Promise<true>((resolve, reject) => {\n          transaction.oncomplete = (): void => resolve(true);\n          /* c8 ignore next 4 - defensive: abort/error after a successful write requires an IndexedDB environment fault */\n          transaction.onabort = (): void =>\n            reject(transaction.error ?? new Error('IndexedDB transaction aborted'));\n          transaction.onerror = (): void =>\n            reject(transaction.error ?? new Error('IndexedDB transaction error'));\n        })\n    );\n  }\n}\n"]}

package/dist/packlets/crypto-utils/index.js

@@ -25,4 +25,17 @@
  */
 export * from './browserHashProvider';
 export * from './browserCryptoProvider';
+export * from './idbPrivateKeyStorage';
+// HpkeProvider re-export: implementation lives in @fgv/ts-extras CryptoUtils packlet;
+// re-exported here so browser callers can import from @fgv/ts-web-extras for this primitive.
+// We import from the top-level namespace to avoid relying on package.json exports path
+// resolution (which requires moduleResolution: node16 or bundler).
+import { CryptoUtils } from '@fgv/ts-extras';
+/**
+ * HPKE base mode (RFC 9180) — `DHKEM(X25519, HKDF-SHA256) + HKDF-SHA256 + AES-256-GCM`.
+ * Re-exported from `@fgv/ts-extras` for browser consumers.
+ * @see {@link CryptoUtils.HpkeProvider}
+ * @public
+ */
+export const HpkeProvider = CryptoUtils.HpkeProvider;
 //# sourceMappingURL=index.js.map

package/dist/packlets/crypto-utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/crypto-utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,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\n/**\n * Browser-compatible cryptographic utilities using the Web Crypto API.\n * @packageDocumentation\n */\n\nexport * from './browserHashProvider';\nexport * from './browserCryptoProvider';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/crypto-utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AAEvC,sFAAsF;AACtF,6FAA6F;AAC7F,uFAAuF;AACvF,mEAAmE;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAoC,WAAW,CAAC,YAAY,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\n/**\n * Browser-compatible cryptographic utilities using the Web Crypto API.\n * @packageDocumentation\n */\n\nexport * from './browserHashProvider';\nexport * from './browserCryptoProvider';\nexport * from './idbPrivateKeyStorage';\n\n// HpkeProvider re-export: implementation lives in @fgv/ts-extras CryptoUtils packlet;\n// re-exported here so browser callers can import from @fgv/ts-web-extras for this primitive.\n// We import from the top-level namespace to avoid relying on package.json exports path\n// resolution (which requires moduleResolution: node16 or bundler).\nimport { CryptoUtils } from '@fgv/ts-extras';\n\n/**\n * HPKE base mode (RFC 9180) — `DHKEM(X25519, HKDF-SHA256) + HKDF-SHA256 + AES-256-GCM`.\n * Re-exported from `@fgv/ts-extras` for browser consumers.\n * @see {@link CryptoUtils.HpkeProvider}\n * @public\n */\nexport const HpkeProvider: typeof CryptoUtils.HpkeProvider = CryptoUtils.HpkeProvider;\n\n/**\n * Output of `HpkeProvider.sealBase`. Re-exported from `@fgv/ts-extras`.\n * @public\n */\nexport type IHpkeSealResult = CryptoUtils.IHpkeSealResult;\n"]}

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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;AAEH,0EAA0E;AAC1E,OAAO,EAAU,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,iBAAiB,EAGlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAA+B,MAAM,iCAAiC,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAA2B,MAAM,6BAA6B,CAAC;AAWjG;;;GAGG;AACH,SAAS,mBAAmB,CAAC,IAAU;IACrC,OAAQ,IAAuC,CAAC,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC;AAClF,CAAC;AAkDD;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;;;;;;;;OAcG;IACI,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAClC,SAAoC,EACpC,MAAyC;QAEzC,MAAM,eAAe,GAAG,MAAM,6BAA6B,CAAC,mBAAmB,CAAM,SAAS,EAAE,MAAM,CAAC,CAAC;QACxG,IAAI,eAAe,CAAC,SAAS,EAAE,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,cAAc,CAChC,MAA4B;QAE5B,MAAM,eAAe,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAM,MAAM,CAAC,CAAC;QACtE,IAAI,eAAe,CAAC,SAAS,EAAE,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAC1C,UAAgC,EAChC,MAAyC;QAEzC,MAAM,eAAe,GAAG,MAAM,6BAA6B,CAAC,cAAc,CAAM,UAAU,EAAE,MAAM,CAAC,CAAC;QACpG,IAAI,eAAe,CAAC,SAAS,EAAE,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,MAAM,CAAC,sBAAsB,CAClC,MAAoC;QAEpC,MAAM,eAAe,GAAG,yBAAyB,CAAC,WAAW,CAAM,MAAM,CAAC,CAAC;QAC3E,qEAAqE;QACrE,IAAI,eAAe,CAAC,SAAS,EAAE,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CACxB,YAA+B,EAC/B,MAA0C;QAE1C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAkC,EAAE,CAAC;YAEnD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;gBACvC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAM,WAAW,EAAE,MAAM,CAAC,CAAC;gBAC7E,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;YAED,OAAO,QAAQ,CAAC,QAAQ,CAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChD,yCAAyC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,YAAY,CAC9B,QAAkB,EAClB,MAA0C;;QAE1C,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,KAAI,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAElE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,uDAAG,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC5E,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI;oBACJ,QAAQ;oBACR,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yCAAyC;gBACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAI,CAAC,uBAAuB,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAM,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACrC,QAAkB,EAClB,MAA0C;;QAE1C,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,KAAI,EAAE,EAAE,YAAY,CAAC,CAAC;YAErE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,uDAAG,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC5E,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI;oBACJ,QAAQ;oBACR,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yCAAyC;gBACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAI,CAAC,uBAAuB,YAAY,KAAK,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAM,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,eAAe,CAAC,QAAkB,EAAE,UAAkB;QAClE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAAU;QAC1C,OAAO;YACL,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACtC,WAA4B,EAC5B,MAA0C;;QAE1C,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,gBAAgB,CAAM,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,mBAAmB,CAAM,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,wBAAwB,CAClC,WAAW,CAAC,UAAU,EACtB,MAAA,WAAW,CAAC,MAAM,mCAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,EACpC,CAAC,WAAW,CAAC,YAAY,EACzB,MAAM,CACP,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,KAAK,CAAC,gBAAgB,CACnC,QAAkB,EAClB,MAA0C;;QAE1C,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;YACnC,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC;YAE9E,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,uDAAG,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;gBAChF,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI;oBACJ,QAAQ;oBACR,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yCAAyC;gBACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAI,CAAC,uBAAuB,YAAY,KAAK,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACtC,OAA+B,EAC/B,MAA0C;;QAE1C,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAChD,yCAAyC;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,mCAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACpE,MAAM,WAAW,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,uDAAG,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;gBAEhF,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI;oBACJ,QAAQ;oBACR,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yCAAyC;gBACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAI,CAAC,8BAA8B,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;OAQG;IACK,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAC3C,OAAoC,EACpC,MAAe,EACf,YAAqB,IAAI,EACzB,MAA0C;QAE1C,MAAM,QAAQ,GAAkC,EAAE,CAAC;QACnD,MAAM,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAC;QAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAM,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAClG,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC5B,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACK,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAC1C,MAAiC,EACjC,QAAgB,EAChB,SAAkB,EAClB,MAA0C;;;QAE1C,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,IAAI,CAAC;;gBACH,KAA0B,eAAA,KAAA,cAAA,MAAM,CAAC,MAAM,EAAE,CAAA,IAAA,sDAAE,CAAC;oBAAlB,cAAe;oBAAf,WAAe;oBAA9B,MAAM,KAAK,KAAA,CAAA;oBACpB,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;wBACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;wBACnC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;wBACvD,MAAM,WAAW,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,uDAAG,IAAI,EAAE,SAAS,EAAE,CAAC;wBAEjE,KAAK,CAAC,IAAI,CAAC;4BACT,IAAI;4BACJ,QAAQ;4BACR,WAAW;yBACZ,CAAC,CAAC;oBACL,CAAC;yBAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;wBACjD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC7D,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAM,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;wBACnG,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;4BAC7B,OAAO,YAAY,CAAC;wBACtB,CAAC;wBACD,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;;;;;;;;;YAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,+BAA+B,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,MAAc,EAAE,IAAY;QACxD,wEAAwE;QACxE,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,oFAAoF;QACpF,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpE,kEAAkE;QAClE,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;IACpE,CAAC;CACF","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;