@anvilkit/plugin-asset-manager 0.1.6 → 0.1.7

package/dist/utils/errors.cjs

@@ -36,6 +36,21 @@ class AssetValidationError extends Error {
         if (options && "cause" in options) this.cause = options.cause;
     }
 }
+class AssetSourceError extends Error {
+    code;
+    retryable;
+    status;
+    retryAfterMs;
+    constructor(code, message, options){
+        super(message);
+        this.name = "AssetSourceError";
+        this.code = code;
+        this.retryable = options?.retryable ?? false;
+        this.status = options?.status;
+        this.retryAfterMs = options?.retryAfterMs;
+        if (options && "cause" in options) this.cause = options.cause;
+    }
+}
 class AssetResolutionError extends Error {
     assetId;
     code;
@@ -49,12 +64,15 @@ class AssetResolutionError extends Error {
 }
 __webpack_require__.d(__webpack_exports__, {
     AssetResolutionError: ()=>AssetResolutionError,
+    AssetSourceError: ()=>AssetSourceError,
     AssetValidationError: ()=>AssetValidationError
 });
 exports.AssetResolutionError = __webpack_exports__.AssetResolutionError;
+exports.AssetSourceError = __webpack_exports__.AssetSourceError;
 exports.AssetValidationError = __webpack_exports__.AssetValidationError;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "AssetResolutionError",
+    "AssetSourceError",
     "AssetValidationError"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/utils/errors.d.cts

@@ -4,6 +4,33 @@ export declare class AssetValidationError extends Error {
         readonly cause?: unknown;
     });
 }
+/**
+ * Failure codes raised by the async data-source / folder / external-provider
+ * surfaces (PRD 0002 §3.6). Distinct from {@link AssetValidationError}
+ * (upload validation) and {@link AssetResolutionError} (resolver domain) — in
+ * particular `ASSET_NOT_FOUND` belongs to the resolver, never here.
+ */
+export type AssetSourceErrorCode = "DATA_SOURCE_UNAVAILABLE" | "DATA_SOURCE_TIMEOUT" | "ASSET_MUTATION_REJECTED" | "FOLDER_NOT_FOUND" | "FOLDER_CYCLE" | "FOLDER_NAME_CONFLICT" | "FOLDER_NOT_EMPTY" | "MOVE_REJECTED" | "PROVIDER_RATE_LIMITED" | "PROVIDER_UNAUTHORIZED" | "PROVIDER_NETWORK" | "PROVIDER_BAD_RESPONSE" | "READ_ONLY_SOURCE" | "OPTIMISTIC_ROLLBACK";
+/**
+ * Error for async catalog operations: host `dataSource` failures, folder
+ * mutations, and external `AssetSourceProvider` calls (e.g. Unsplash). Carries
+ * retry metadata so callers can drive backoff (`./retry`) without re-deriving
+ * it: `retryable` gates whether a retry is attempted at all, `status` mirrors
+ * an HTTP status (429, 401, …), and `retryAfterMs` is sourced from a
+ * `Retry-After` / `X-Ratelimit-Reset` header when present.
+ */
+export declare class AssetSourceError extends Error {
+    readonly code: AssetSourceErrorCode;
+    readonly retryable: boolean;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    constructor(code: AssetSourceErrorCode, message: string, options?: {
+        readonly cause?: unknown;
+        readonly retryable?: boolean;
+        readonly status?: number;
+        readonly retryAfterMs?: number;
+    });
+}
 export type AssetResolutionErrorCode = "ASSET_NOT_FOUND" | "ASSET_URL_REJECTED" | "ASSET_VALIDATION_FAILED";
 export declare class AssetResolutionError extends Error {
     readonly assetId: string;

package/dist/utils/errors.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.cts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}
+{"version":3,"file":"errors.d.cts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG9B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAC/B;CAaF;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}

package/dist/utils/errors.d.ts

@@ -4,6 +4,33 @@ export declare class AssetValidationError extends Error {
         readonly cause?: unknown;
     });
 }
+/**
+ * Failure codes raised by the async data-source / folder / external-provider
+ * surfaces (PRD 0002 §3.6). Distinct from {@link AssetValidationError}
+ * (upload validation) and {@link AssetResolutionError} (resolver domain) — in
+ * particular `ASSET_NOT_FOUND` belongs to the resolver, never here.
+ */
+export type AssetSourceErrorCode = "DATA_SOURCE_UNAVAILABLE" | "DATA_SOURCE_TIMEOUT" | "ASSET_MUTATION_REJECTED" | "FOLDER_NOT_FOUND" | "FOLDER_CYCLE" | "FOLDER_NAME_CONFLICT" | "FOLDER_NOT_EMPTY" | "MOVE_REJECTED" | "PROVIDER_RATE_LIMITED" | "PROVIDER_UNAUTHORIZED" | "PROVIDER_NETWORK" | "PROVIDER_BAD_RESPONSE" | "READ_ONLY_SOURCE" | "OPTIMISTIC_ROLLBACK";
+/**
+ * Error for async catalog operations: host `dataSource` failures, folder
+ * mutations, and external `AssetSourceProvider` calls (e.g. Unsplash). Carries
+ * retry metadata so callers can drive backoff (`./retry`) without re-deriving
+ * it: `retryable` gates whether a retry is attempted at all, `status` mirrors
+ * an HTTP status (429, 401, …), and `retryAfterMs` is sourced from a
+ * `Retry-After` / `X-Ratelimit-Reset` header when present.
+ */
+export declare class AssetSourceError extends Error {
+    readonly code: AssetSourceErrorCode;
+    readonly retryable: boolean;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    constructor(code: AssetSourceErrorCode, message: string, options?: {
+        readonly cause?: unknown;
+        readonly retryable?: boolean;
+        readonly status?: number;
+        readonly retryAfterMs?: number;
+    });
+}
 export type AssetResolutionErrorCode = "ASSET_NOT_FOUND" | "ASSET_URL_REJECTED" | "ASSET_VALIDATION_FAILED";
 export declare class AssetResolutionError extends Error {
     readonly assetId: string;

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG9B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAC/B;CAaF;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}

package/dist/utils/errors.js

@@ -7,6 +7,21 @@ class AssetValidationError extends Error {
         if (options && "cause" in options) this.cause = options.cause;
     }
 }
+class AssetSourceError extends Error {
+    code;
+    retryable;
+    status;
+    retryAfterMs;
+    constructor(code, message, options){
+        super(message);
+        this.name = "AssetSourceError";
+        this.code = code;
+        this.retryable = options?.retryable ?? false;
+        this.status = options?.status;
+        this.retryAfterMs = options?.retryAfterMs;
+        if (options && "cause" in options) this.cause = options.cause;
+    }
+}
 class AssetResolutionError extends Error {
     assetId;
     code;
@@ -18,4 +33,4 @@ class AssetResolutionError extends Error {
         if (options && "cause" in options) this.cause = options.cause;
     }
 }
-export { AssetResolutionError, AssetValidationError };
+export { AssetResolutionError, AssetSourceError, AssetValidationError };

package/dist/utils/folders.cjs

@@ -0,0 +1,261 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createFolderStore: ()=>createFolderStore
+});
+const folders_cjs_namespaceObject = require("../types/folders.cjs");
+const external_errors_cjs_namespaceObject = require("./errors.cjs");
+function createFolderStore(options = {}) {
+    const now = options.now ?? (()=>Date.now());
+    const records = new Map();
+    const assetFolder = new Map();
+    const listeners = new Set();
+    let seq = 0;
+    const notify = ()=>{
+        for (const listener of listeners)listener();
+    };
+    const requireRecord = (id)=>{
+        const rec = records.get(id);
+        if (void 0 === rec) throw new external_errors_cjs_namespaceObject.AssetSourceError("FOLDER_NOT_FOUND", `Unknown folder "${id}".`);
+        return rec;
+    };
+    const childFolderCount = (id)=>{
+        let n = 0;
+        for (const rec of records.values())if (rec.parentId === id) n += 1;
+        return n;
+    };
+    const directAssetCount = (id)=>{
+        let n = 0;
+        for (const folderId of assetFolder.values())if (folderId === id) n += 1;
+        return n;
+    };
+    const project = (rec)=>Object.freeze({
+            id: rec.id,
+            name: rec.name,
+            parentId: rec.parentId,
+            createdAt: rec.createdAt,
+            updatedAt: rec.updatedAt,
+            counts: Object.freeze({
+                assets: directAssetCount(rec.id),
+                folders: childFolderCount(rec.id)
+            })
+        });
+    const depthOf = (id)=>{
+        let depth = 0;
+        let cursor = id;
+        while(null !== cursor){
+            const rec = records.get(cursor);
+            if (void 0 === rec) break;
+            depth += 1;
+            cursor = rec.parentId;
+        }
+        return depth;
+    };
+    const subtree = (id)=>{
+        const out = new Set([
+            id
+        ]);
+        let added = true;
+        while(added){
+            added = false;
+            for (const rec of records.values())if (null !== rec.parentId && out.has(rec.parentId) && !out.has(rec.id)) {
+                out.add(rec.id);
+                added = true;
+            }
+        }
+        return out;
+    };
+    const heightOf = (id)=>{
+        let height = 0;
+        const ids = subtree(id);
+        for (const fid of ids){
+            const d = depthOf(fid) - depthOf(id);
+            if (d > height) height = d;
+        }
+        return height;
+    };
+    const assertNameFree = (parentId, name, exceptId)=>{
+        const lowered = name.toLowerCase();
+        for (const rec of records.values())if (rec.parentId === parentId) {
+            if (rec.id !== exceptId) {
+                if (rec.name.toLowerCase() === lowered) throw new external_errors_cjs_namespaceObject.AssetSourceError("FOLDER_NAME_CONFLICT", `A folder named "${name}" already exists here.`);
+            }
+        }
+    };
+    const normalizeName = (name)=>{
+        const trimmed = name.trim();
+        if ("" === trimmed) throw new external_errors_cjs_namespaceObject.AssetSourceError("FOLDER_NAME_CONFLICT", "Folder name must not be empty.");
+        return trimmed;
+    };
+    const assertDepthOk = (parentDepth, extraHeight, maxDepth)=>{
+        if (void 0 === maxDepth) return;
+        if (parentDepth + 1 + extraHeight > maxDepth) throw new external_errors_cjs_namespaceObject.AssetSourceError("MOVE_REJECTED", `Operation would exceed the maximum folder depth of ${maxDepth}.`);
+    };
+    return {
+        listChildren (parentId) {
+            const target = (0, folders_cjs_namespaceObject.resolveFolderId)(parentId);
+            const out = [];
+            for (const rec of records.values())if (rec.parentId === target) out.push(project(rec));
+            return Object.freeze(out);
+        },
+        listAll () {
+            return Object.freeze([
+                ...records.values()
+            ].map(project));
+        },
+        get (id) {
+            const rec = records.get(id);
+            return void 0 === rec ? void 0 : project(rec);
+        },
+        path (id) {
+            const target = (0, folders_cjs_namespaceObject.resolveFolderId)(id);
+            if (null === target) return Object.freeze([]);
+            const chain = [];
+            let cursor = target;
+            const seen = new Set();
+            while(null !== cursor){
+                if (seen.has(cursor)) break;
+                seen.add(cursor);
+                const rec = records.get(cursor);
+                if (void 0 === rec) break;
+                chain.unshift(project(rec));
+                cursor = rec.parentId;
+            }
+            return Object.freeze(chain);
+        },
+        createFolder (parentId, name, maxDepth) {
+            const target = (0, folders_cjs_namespaceObject.resolveFolderId)(parentId);
+            if (null !== target) requireRecord(target);
+            const clean = normalizeName(name);
+            assertNameFree(target, clean);
+            assertDepthOk(depthOf(target), 0, maxDepth);
+            const ts = now();
+            const rec = {
+                id: `folder-${seq += 1}`,
+                name: clean,
+                parentId: target,
+                createdAt: ts,
+                updatedAt: ts
+            };
+            records.set(rec.id, rec);
+            notify();
+            return project(rec);
+        },
+        renameFolder (id, name) {
+            const rec = requireRecord(id);
+            const clean = normalizeName(name);
+            assertNameFree(rec.parentId, clean, id);
+            rec.name = clean;
+            rec.updatedAt = now();
+            notify();
+            return project(rec);
+        },
+        moveFolder (id, parentId, maxDepth) {
+            const rec = requireRecord(id);
+            const target = (0, folders_cjs_namespaceObject.resolveFolderId)(parentId);
+            if (target === id) throw new external_errors_cjs_namespaceObject.AssetSourceError("FOLDER_CYCLE", "A folder cannot be moved into itself.");
+            if (null !== target) {
+                requireRecord(target);
+                if (subtree(id).has(target)) throw new external_errors_cjs_namespaceObject.AssetSourceError("FOLDER_CYCLE", "A folder cannot be moved into one of its own descendants.");
+            }
+            if (rec.parentId === target) return project(rec);
+            assertNameFree(target, rec.name, id);
+            assertDepthOk(depthOf(target), heightOf(id), maxDepth);
+            rec.parentId = target;
+            rec.updatedAt = now();
+            notify();
+            return project(rec);
+        },
+        removeFolder (id, opts) {
+            const rec = requireRecord(id);
+            if (opts?.cascade) {
+                const ids = subtree(id);
+                const removedAssetIds = [];
+                for (const [assetId, folderId] of assetFolder)if (ids.has(folderId)) {
+                    removedAssetIds.push(assetId);
+                    assetFolder.delete(assetId);
+                }
+                for (const fid of ids)records.delete(fid);
+                notify();
+                return {
+                    removedAssetIds: Object.freeze(removedAssetIds)
+                };
+            }
+            const newParent = rec.parentId;
+            for (const child of records.values())if (child.parentId === id) {
+                child.parentId = newParent;
+                child.updatedAt = now();
+            }
+            for (const [assetId, folderId] of assetFolder)if (folderId === id) if (null === newParent) assetFolder.delete(assetId);
+            else assetFolder.set(assetId, newParent);
+            records.delete(id);
+            notify();
+            return {
+                removedAssetIds: Object.freeze([])
+            };
+        },
+        folderOf (assetId) {
+            return assetFolder.get(assetId) ?? null;
+        },
+        moveAsset (assetId, folderId) {
+            const target = (0, folders_cjs_namespaceObject.resolveFolderId)(folderId);
+            if (null !== target) requireRecord(target);
+            if (null === target) assetFolder.delete(assetId);
+            else assetFolder.set(assetId, target);
+            notify();
+        },
+        moveAssets (assetIds, folderId) {
+            const target = (0, folders_cjs_namespaceObject.resolveFolderId)(folderId);
+            if (null !== target) requireRecord(target);
+            for (const assetId of assetIds)if (null === target) assetFolder.delete(assetId);
+            else assetFolder.set(assetId, target);
+            notify();
+        },
+        removeAsset (assetId) {
+            if (assetFolder.delete(assetId)) notify();
+        },
+        subtreeIds (id) {
+            return subtree(id);
+        },
+        subscribe (listener) {
+            listeners.add(listener);
+            return ()=>{
+                listeners.delete(listener);
+            };
+        }
+    };
+}
+exports.createFolderStore = __webpack_exports__.createFolderStore;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createFolderStore"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/utils/folders.d.cts

@@ -0,0 +1,49 @@
+/**
+ * @file In-memory folder store (PRD 0002 §7). Lazy-importable from the factory
+ * so flat callers pay zero headless bytes for it.
+ *
+ * Owns the folder tree (records) and the asset→folder side-index. Membership is
+ * stored ONLY for non-root assets (absence ⇒ root), so `UploadResult` is never
+ * extended and the registry's freeze reconstructor can't strip a folder field.
+ * `AssetFolder.counts` is computed fresh on read (never denormalized) so it can
+ * never drift from the side-index.
+ */
+import type { AssetFolder, FolderId } from "../types/folders.js";
+export interface CreateFolderStoreOptions {
+    /** Injectable clock for deterministic timestamps in tests. Defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+export interface FolderStore {
+    /** Direct child folders of `parentId` (`null`/undefined ⇒ root's children). */
+    listChildren(parentId?: FolderId | null): readonly AssetFolder[];
+    /** All folders, flat. */
+    listAll(): readonly AssetFolder[];
+    get(id: FolderId): AssetFolder | undefined;
+    /** Root → … → `id` (inclusive). `[]` for root/undefined. */
+    path(id?: FolderId | null): readonly AssetFolder[];
+    createFolder(parentId: FolderId | null, name: string, maxDepth?: number): AssetFolder;
+    renameFolder(id: FolderId, name: string): AssetFolder;
+    moveFolder(id: FolderId, parentId: FolderId | null, maxDepth?: number): AssetFolder;
+    /**
+     * Remove a folder. Default policy reparents children (folders + assets) to
+     * the removed folder's parent; `{ cascade: true }` instead returns every
+     * descendant asset id for the caller to delete from the registry.
+     */
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }): {
+        readonly removedAssetIds: readonly string[];
+    };
+    /** Owning folder of an asset (`null` ⇒ root). */
+    folderOf(assetId: string): FolderId | null;
+    moveAsset(assetId: string, folderId: FolderId | null): void;
+    /** Batch move — validates the target once (all-or-nothing) before applying. */
+    moveAssets(assetIds: readonly string[], folderId: FolderId | null): void;
+    /** Drop an asset's membership (call when the asset is deleted from the registry). */
+    removeAsset(assetId: string): void;
+    /** Folder id + every descendant folder id (for recursive listing). */
+    subtreeIds(id: FolderId): ReadonlySet<FolderId>;
+    subscribe(listener: () => void): () => void;
+}
+export declare function createFolderStore(options?: CreateFolderStoreOptions): FolderStore;
+//# sourceMappingURL=folders.d.cts.map

package/dist/utils/folders.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.cts","sourceRoot":"","sources":["../../src/utils/folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYjE,MAAM,WAAW,wBAAwB;IACxC,sFAAsF;IACtF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,WAAW,EAAE,CAAC;IACjE,yBAAyB;IACzB,OAAO,IAAI,SAAS,WAAW,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC3C,4DAA4D;IAC5D,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,WAAW,EAAE,CAAC;IAEnD,YAAY,CACX,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GACf,WAAW,CAAC;IACf,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACtD,UAAU,CACT,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,MAAM,GACf,WAAW,CAAC;IACf;;;;OAIG;IACH,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC;QAAE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAEnD,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,UAAU,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IACzE,qFAAqF;IACrF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,sEAAsE;IACtE,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEhD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AAED,wBAAgB,iBAAiB,CAChC,OAAO,GAAE,wBAA6B,GACpC,WAAW,CAsSb"}

package/dist/utils/folders.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @file In-memory folder store (PRD 0002 §7). Lazy-importable from the factory
+ * so flat callers pay zero headless bytes for it.
+ *
+ * Owns the folder tree (records) and the asset→folder side-index. Membership is
+ * stored ONLY for non-root assets (absence ⇒ root), so `UploadResult` is never
+ * extended and the registry's freeze reconstructor can't strip a folder field.
+ * `AssetFolder.counts` is computed fresh on read (never denormalized) so it can
+ * never drift from the side-index.
+ */
+import type { AssetFolder, FolderId } from "../types/folders.js";
+export interface CreateFolderStoreOptions {
+    /** Injectable clock for deterministic timestamps in tests. Defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+export interface FolderStore {
+    /** Direct child folders of `parentId` (`null`/undefined ⇒ root's children). */
+    listChildren(parentId?: FolderId | null): readonly AssetFolder[];
+    /** All folders, flat. */
+    listAll(): readonly AssetFolder[];
+    get(id: FolderId): AssetFolder | undefined;
+    /** Root → … → `id` (inclusive). `[]` for root/undefined. */
+    path(id?: FolderId | null): readonly AssetFolder[];
+    createFolder(parentId: FolderId | null, name: string, maxDepth?: number): AssetFolder;
+    renameFolder(id: FolderId, name: string): AssetFolder;
+    moveFolder(id: FolderId, parentId: FolderId | null, maxDepth?: number): AssetFolder;
+    /**
+     * Remove a folder. Default policy reparents children (folders + assets) to
+     * the removed folder's parent; `{ cascade: true }` instead returns every
+     * descendant asset id for the caller to delete from the registry.
+     */
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }): {
+        readonly removedAssetIds: readonly string[];
+    };
+    /** Owning folder of an asset (`null` ⇒ root). */
+    folderOf(assetId: string): FolderId | null;
+    moveAsset(assetId: string, folderId: FolderId | null): void;
+    /** Batch move — validates the target once (all-or-nothing) before applying. */
+    moveAssets(assetIds: readonly string[], folderId: FolderId | null): void;
+    /** Drop an asset's membership (call when the asset is deleted from the registry). */
+    removeAsset(assetId: string): void;
+    /** Folder id + every descendant folder id (for recursive listing). */
+    subtreeIds(id: FolderId): ReadonlySet<FolderId>;
+    subscribe(listener: () => void): () => void;
+}
+export declare function createFolderStore(options?: CreateFolderStoreOptions): FolderStore;
+//# sourceMappingURL=folders.d.ts.map

package/dist/utils/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/utils/folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYjE,MAAM,WAAW,wBAAwB;IACxC,sFAAsF;IACtF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,WAAW,EAAE,CAAC;IACjE,yBAAyB;IACzB,OAAO,IAAI,SAAS,WAAW,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC3C,4DAA4D;IAC5D,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,WAAW,EAAE,CAAC;IAEnD,YAAY,CACX,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GACf,WAAW,CAAC;IACf,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACtD,UAAU,CACT,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,MAAM,GACf,WAAW,CAAC;IACf;;;;OAIG;IACH,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC;QAAE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAEnD,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,UAAU,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IACzE,qFAAqF;IACrF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,sEAAsE;IACtE,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEhD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AAED,wBAAgB,iBAAiB,CAChC,OAAO,GAAE,wBAA6B,GACpC,WAAW,CAsSb"}