@anvilkit/plugin-asset-manager 0.1.5 → 0.1.7

package/dist/utils/data-source.d.cts

@@ -0,0 +1,63 @@
+/**
+ * @file In-memory `AssetDataSource` (PRD 0002 §6). Adapts the synchronous
+ * `AssetRegistry` + the {@link FolderStore} into the async, folder-aware data
+ * plane, WITHOUT changing the registry's API. The registry stays the single
+ * store for assets; folder membership lives in the side-index the folder store
+ * owns. Lazy-importable so flat callers pay nothing for folder code.
+ */
+import type { AssetDataSource, AssetSourceStatus, ReplacePayload } from "../types/data-source.js";
+import type { AssetFilter, AssetListPage } from "../types/filter.js";
+import type { AssetFolder, FolderId } from "../types/folders.js";
+import type { AssetRegistry, UploadResult } from "../types/types.js";
+import { type FolderStore } from "./folders.js";
+/**
+ * Binary ingest used by `replace` — the same `uploadAsset`-bound callback the
+ * `StudioAssetSource` already threads, so the security pipeline is single-sourced.
+ */
+export type UploadFn = (file: File, options?: {
+    readonly signal?: AbortSignal;
+}) => Promise<UploadResult>;
+/** Fully-resolved data plane (no optional methods) stored on the runtime state. */
+export interface ResolvedAssetDataSource {
+    list(query: AssetFilter, signal?: AbortSignal): Promise<AssetListPage>;
+    remove(id: string, signal?: AbortSignal): Promise<void>;
+    replace(id: string, payload: ReplacePayload, signal?: AbortSignal): Promise<UploadResult>;
+    rename(id: string, name: string, signal?: AbortSignal): Promise<UploadResult>;
+    move(id: string, folderId: FolderId | null, signal?: AbortSignal): Promise<void>;
+    createFolder(parentId: FolderId | null, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    renameFolder(id: FolderId, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }, signal?: AbortSignal): Promise<void>;
+    moveFolder(id: FolderId, parentId: FolderId | null, signal?: AbortSignal): Promise<AssetFolder>;
+    /** Fires on any asset OR folder mutation (the sidebar re-lists). */
+    subscribe(listener: () => void): () => void;
+    subscribeStatus(listener: (status: AssetSourceStatus) => void): () => void;
+    /** The shared folder store (for the composite source / UI). */
+    readonly folders: FolderStore;
+}
+export interface CreateInMemoryDataSourceOptions {
+    readonly registry: AssetRegistry;
+    readonly upload: UploadFn;
+    /** Shared folder store — injected by the factory so the UI sees the same one. */
+    readonly folderStore?: FolderStore;
+    /** Max nesting depth from `FolderOptions`. */
+    readonly maxDepth?: number;
+}
+export declare function createInMemoryDataSource(options: CreateInMemoryDataSourceOptions): ResolvedAssetDataSource;
+export interface ResolveDataSourceInput extends CreateInMemoryDataSourceOptions {
+    /** Host-supplied backend. When absent, the full in-memory default is used. */
+    readonly hostDataSource?: AssetDataSource;
+    /** One-time dev warning sink (e.g. `ctx.log`). */
+    readonly warn?: (message: string) => void;
+}
+/**
+ * Per-PLANE resolution ladder (PRD 0002 §5). A host that supplies the FULL
+ * method set of a plane owns that plane; a PARTIAL set warns once and the WHOLE
+ * plane falls back to the in-memory default — so the read and write planes are
+ * never split across two stores. `subscribeStatus` is taken from the host when
+ * present; `subscribe`/`folders` always come from the in-memory layer (the
+ * composite re-lists after host mutations; external push is out of scope).
+ */
+export declare function resolveDataSource(input: ResolveDataSourceInput): ResolvedAssetDataSource;
+//# sourceMappingURL=data-source.d.cts.map

package/dist/utils/data-source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.cts","sourceRoot":"","sources":["../../src/utils/data-source.ts"],"names":[],"mappings":"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"}

package/dist/utils/data-source.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @file In-memory `AssetDataSource` (PRD 0002 §6). Adapts the synchronous
+ * `AssetRegistry` + the {@link FolderStore} into the async, folder-aware data
+ * plane, WITHOUT changing the registry's API. The registry stays the single
+ * store for assets; folder membership lives in the side-index the folder store
+ * owns. Lazy-importable so flat callers pay nothing for folder code.
+ */
+import type { AssetDataSource, AssetSourceStatus, ReplacePayload } from "../types/data-source.js";
+import type { AssetFilter, AssetListPage } from "../types/filter.js";
+import type { AssetFolder, FolderId } from "../types/folders.js";
+import type { AssetRegistry, UploadResult } from "../types/types.js";
+import { type FolderStore } from "./folders.js";
+/**
+ * Binary ingest used by `replace` — the same `uploadAsset`-bound callback the
+ * `StudioAssetSource` already threads, so the security pipeline is single-sourced.
+ */
+export type UploadFn = (file: File, options?: {
+    readonly signal?: AbortSignal;
+}) => Promise<UploadResult>;
+/** Fully-resolved data plane (no optional methods) stored on the runtime state. */
+export interface ResolvedAssetDataSource {
+    list(query: AssetFilter, signal?: AbortSignal): Promise<AssetListPage>;
+    remove(id: string, signal?: AbortSignal): Promise<void>;
+    replace(id: string, payload: ReplacePayload, signal?: AbortSignal): Promise<UploadResult>;
+    rename(id: string, name: string, signal?: AbortSignal): Promise<UploadResult>;
+    move(id: string, folderId: FolderId | null, signal?: AbortSignal): Promise<void>;
+    createFolder(parentId: FolderId | null, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    renameFolder(id: FolderId, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }, signal?: AbortSignal): Promise<void>;
+    moveFolder(id: FolderId, parentId: FolderId | null, signal?: AbortSignal): Promise<AssetFolder>;
+    /** Fires on any asset OR folder mutation (the sidebar re-lists). */
+    subscribe(listener: () => void): () => void;
+    subscribeStatus(listener: (status: AssetSourceStatus) => void): () => void;
+    /** The shared folder store (for the composite source / UI). */
+    readonly folders: FolderStore;
+}
+export interface CreateInMemoryDataSourceOptions {
+    readonly registry: AssetRegistry;
+    readonly upload: UploadFn;
+    /** Shared folder store — injected by the factory so the UI sees the same one. */
+    readonly folderStore?: FolderStore;
+    /** Max nesting depth from `FolderOptions`. */
+    readonly maxDepth?: number;
+}
+export declare function createInMemoryDataSource(options: CreateInMemoryDataSourceOptions): ResolvedAssetDataSource;
+export interface ResolveDataSourceInput extends CreateInMemoryDataSourceOptions {
+    /** Host-supplied backend. When absent, the full in-memory default is used. */
+    readonly hostDataSource?: AssetDataSource;
+    /** One-time dev warning sink (e.g. `ctx.log`). */
+    readonly warn?: (message: string) => void;
+}
+/**
+ * Per-PLANE resolution ladder (PRD 0002 §5). A host that supplies the FULL
+ * method set of a plane owns that plane; a PARTIAL set warns once and the WHOLE
+ * plane falls back to the in-memory default — so the read and write planes are
+ * never split across two stores. `subscribeStatus` is taken from the host when
+ * present; `subscribe`/`folders` always come from the in-memory layer (the
+ * composite re-lists after host mutations; external push is out of scope).
+ */
+export declare function resolveDataSource(input: ResolveDataSourceInput): ResolvedAssetDataSource;
+//# sourceMappingURL=data-source.d.ts.map

package/dist/utils/data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/utils/data-source.ts"],"names":[],"mappings":"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"}

package/dist/utils/data-source.js

@@ -0,0 +1,136 @@
+import { resolveFolderId } from "../types/folders.js";
+import { AssetSourceError } from "./errors.js";
+import { createFolderStore } from "./folders.js";
+import { assetMatchesSearch, paginateMatches } from "./registry.js";
+function makeAbortError() {
+    if ("u" > typeof DOMException) return new DOMException("Operation aborted", "AbortError");
+    const error = new Error("Operation aborted");
+    error.name = "AbortError";
+    return error;
+}
+function createInMemoryDataSource(options) {
+    const { registry, upload, maxDepth } = options;
+    const folders = options.folderStore ?? createFolderStore();
+    const buildPage = (page, query)=>{
+        const base = {
+            items: page.items,
+            total: page.total,
+            nextCursor: page.nextCursor
+        };
+        if (void 0 === query.folderId) return base;
+        return {
+            ...base,
+            folders: folders.listChildren(query.folderId),
+            folderPath: folders.path(query.folderId)
+        };
+    };
+    return {
+        folders,
+        list (query) {
+            if (void 0 === query.folderId) return Promise.resolve(buildPage(registry.search(query), query));
+            const target = resolveFolderId(query.folderId);
+            const recursive = true === query.recursive;
+            const subtree = recursive && null !== target ? folders.subtreeIds(target) : void 0;
+            const matches = registry.list().filter((entry)=>{
+                const owner = folders.folderOf(entry.id);
+                const folderOk = recursive ? null === target ? true : null !== owner && subtree?.has(owner) === true : owner === target;
+                return folderOk && assetMatchesSearch(entry, query);
+            });
+            return Promise.resolve(buildPage(paginateMatches(matches, query), query));
+        },
+        remove (id) {
+            registry.delete(id);
+            folders.removeAsset(id);
+            return Promise.resolve();
+        },
+        async replace (id, payload, signal) {
+            const result = await upload(payload, signal ? {
+                signal
+            } : void 0);
+            if (signal?.aborted) throw makeAbortError();
+            const replaced = registry.replace(id, result);
+            return replaced ?? result;
+        },
+        rename (id, name) {
+            const updated = registry.rename(id, name);
+            if (void 0 === updated) return Promise.reject(new AssetSourceError("ASSET_MUTATION_REJECTED", `Cannot rename unknown asset "${id}".`));
+            return Promise.resolve(updated);
+        },
+        move (id, folderId) {
+            folders.moveAsset(id, folderId);
+            return Promise.resolve();
+        },
+        createFolder (parentId, name) {
+            return Promise.resolve(folders.createFolder(parentId, name, maxDepth));
+        },
+        renameFolder (id, name) {
+            return Promise.resolve(folders.renameFolder(id, name));
+        },
+        removeFolder (id, opts) {
+            const { removedAssetIds } = folders.removeFolder(id, opts);
+            for (const assetId of removedAssetIds)registry.delete(assetId);
+            return Promise.resolve();
+        },
+        moveFolder (id, parentId) {
+            return Promise.resolve(folders.moveFolder(id, parentId, maxDepth));
+        },
+        subscribe (listener) {
+            const offRegistry = registry.subscribe(listener);
+            const offFolders = folders.subscribe(listener);
+            return ()=>{
+                offRegistry();
+                offFolders();
+            };
+        },
+        subscribeStatus (listener) {
+            listener({
+                phase: "idle"
+            });
+            return ()=>{};
+        }
+    };
+}
+const ASSET_PLANE = [
+    "list",
+    "remove",
+    "replace",
+    "rename",
+    "move"
+];
+const FOLDER_PLANE = [
+    "createFolder",
+    "renameFolder",
+    "removeFolder",
+    "moveFolder"
+];
+function resolveDataSource(input) {
+    const fallback = createInMemoryDataSource(input);
+    const host = input.hostDataSource;
+    if (void 0 === host) return fallback;
+    const ownsPlane = (plane, label)=>{
+        const provided = plane.filter((m)=>"function" == typeof host[m]);
+        if (0 === provided.length) return false;
+        if (provided.length === plane.length) return true;
+        input.warn?.(`asset-manager: dataSource provides a partial ${label} method set (${provided.join(", ")}) — falling back to the in-memory default for the whole ${label} plane. Provide all of {${plane.join(", ")}} or none.`);
+        return false;
+    };
+    const resolved = {
+        ...fallback
+    };
+    if (ownsPlane(ASSET_PLANE, "asset")) {
+        resolved.list = host.list.bind(host);
+        resolved.remove = host.remove.bind(host);
+        resolved.replace = host.replace.bind(host);
+        resolved.rename = host.rename.bind(host);
+        resolved.move = host.move.bind(host);
+    }
+    if (ownsPlane(FOLDER_PLANE, "folder")) {
+        resolved.createFolder = host.createFolder.bind(host);
+        resolved.renameFolder = host.renameFolder.bind(host);
+        resolved.removeFolder = host.removeFolder.bind(host);
+        resolved.moveFolder = host.moveFolder.bind(host);
+    }
+    if ("function" == typeof host.subscribeStatus) resolved.subscribeStatus = host.subscribeStatus.bind(host);
+    return resolved;
+}
+export { createInMemoryDataSource, resolveDataSource };

package/dist/utils/errors.cjs

@@ -1,11 +1,15 @@
 "use strict";
 var __webpack_require__ = {};
 (()=>{
-    __webpack_require__.d = (exports1, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-            enumerable: true,
-            get: definition[key]
-        });
+    __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");
     };
 })();
 (()=>{
@@ -23,10 +27,6 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-    AssetResolutionError: ()=>AssetResolutionError,
-    AssetValidationError: ()=>AssetValidationError
-});
 class AssetValidationError extends Error {
     code;
     constructor(code, message, options){
@@ -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;
@@ -47,10 +62,17 @@ class AssetResolutionError extends Error {
         if (options && "cause" in options) this.cause = options.cause;
     }
 }
+__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 };