@anvilkit/plugin-asset-manager 0.1.9 → 0.1.10

package/dist/adapters/s3-multipart.d.cts

@@ -0,0 +1,43 @@
+/**
+ * @file S3 multipart resumable adapter (PRD 0004 §5.1 — M4).
+ *
+ * A {@link ResumableUploadAdapter} that fronts an S3-compatible multipart
+ * upload WITHOUT bundling the AWS SDK — exactly like {@link s3PresignedAdapter}
+ * fronts a single presigned PUT. All S3 calls are brokered through one host
+ * `endpoint` that the adapter POSTs JSON to, discriminated by `action`:
+ *
+ *  - `create`     → host runs `CreateMultipartUpload`, returns `{ uploadId, key?, partSize? }`
+ *  - `sign-part`  → host presigns one `UploadPart` PUT, returns `{ url, headers? }`
+ *  - `complete`   → host runs `CompleteMultipartUpload`, returns `{ url, publicUrl?, id? }`
+ *  - `abort`      → host runs `AbortMultipartUpload`
+ *  - `list-parts` → host runs `ListParts` for resume, returns `{ parts, key? }` (404 ⇒ gone)
+ *
+ * Retry split: `begin` / `complete` / `abort` retry internally via `withRetry`
+ * (the runner does not retry them). `uploadPart` does NOT retry internally — the
+ * runner's per-part `withRetry` re-invokes it, which RE-SIGNS the part URL each
+ * attempt (presigned URLs expire), so a fresh URL is used on every retry.
+ *
+ * @experimental Public surface may change before v1.0.
+ */
+import type { ResumableUploadAdapter } from "../types/resumable.js";
+import { type RetryOptions } from "../utils/retry.js";
+/** Configuration for {@link s3MultipartAdapter}. */
+export interface S3MultipartAdapterOptions {
+    /** Endpoint that brokers the S3 multipart actions (see file header). */
+    readonly endpoint: string | URL;
+    /** Injectable `fetch`. Defaults to `globalThis.fetch`. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Bytes per part. Clamped to S3's 5 MiB minimum. Defaults to 8 MiB. */
+    readonly partSize?: number;
+    /** Forwarded to `withRetry()` for `begin` / `complete` / `abort`. */
+    readonly retry?: RetryOptions;
+    /** Construction-time signal, combined with each call's signal. */
+    readonly signal?: AbortSignal;
+    /** Extra headers applied to every broker POST (e.g. auth). */
+    readonly headers?: Record<string, string>;
+    /** Override the fallback asset id generator. Default: `crypto.randomUUID()`. */
+    readonly idGenerator?: () => string;
+}
+/** Create a resumable adapter backed by an S3 multipart broker endpoint. */
+export declare function s3MultipartAdapter(options: S3MultipartAdapterOptions): ResumableUploadAdapter;
+//# sourceMappingURL=s3-multipart.d.cts.map

package/dist/adapters/s3-multipart.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-multipart.d.cts","sourceRoot":"","sources":["../../src/adapters/s3-multipart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAEX,sBAAsB,EAGtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,mBAAmB,CAAC;AAM3B,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACzC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAqBD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,yBAAyB,GAChC,sBAAsB,CA2JxB"}

package/dist/adapters/s3-multipart.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @file S3 multipart resumable adapter (PRD 0004 §5.1 — M4).
+ *
+ * A {@link ResumableUploadAdapter} that fronts an S3-compatible multipart
+ * upload WITHOUT bundling the AWS SDK — exactly like {@link s3PresignedAdapter}
+ * fronts a single presigned PUT. All S3 calls are brokered through one host
+ * `endpoint` that the adapter POSTs JSON to, discriminated by `action`:
+ *
+ *  - `create`     → host runs `CreateMultipartUpload`, returns `{ uploadId, key?, partSize? }`
+ *  - `sign-part`  → host presigns one `UploadPart` PUT, returns `{ url, headers? }`
+ *  - `complete`   → host runs `CompleteMultipartUpload`, returns `{ url, publicUrl?, id? }`
+ *  - `abort`      → host runs `AbortMultipartUpload`
+ *  - `list-parts` → host runs `ListParts` for resume, returns `{ parts, key? }` (404 ⇒ gone)
+ *
+ * Retry split: `begin` / `complete` / `abort` retry internally via `withRetry`
+ * (the runner does not retry them). `uploadPart` does NOT retry internally — the
+ * runner's per-part `withRetry` re-invokes it, which RE-SIGNS the part URL each
+ * attempt (presigned URLs expire), so a fresh URL is used on every retry.
+ *
+ * @experimental Public surface may change before v1.0.
+ */
+import type { ResumableUploadAdapter } from "../types/resumable.js";
+import { type RetryOptions } from "../utils/retry.js";
+/** Configuration for {@link s3MultipartAdapter}. */
+export interface S3MultipartAdapterOptions {
+    /** Endpoint that brokers the S3 multipart actions (see file header). */
+    readonly endpoint: string | URL;
+    /** Injectable `fetch`. Defaults to `globalThis.fetch`. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Bytes per part. Clamped to S3's 5 MiB minimum. Defaults to 8 MiB. */
+    readonly partSize?: number;
+    /** Forwarded to `withRetry()` for `begin` / `complete` / `abort`. */
+    readonly retry?: RetryOptions;
+    /** Construction-time signal, combined with each call's signal. */
+    readonly signal?: AbortSignal;
+    /** Extra headers applied to every broker POST (e.g. auth). */
+    readonly headers?: Record<string, string>;
+    /** Override the fallback asset id generator. Default: `crypto.randomUUID()`. */
+    readonly idGenerator?: () => string;
+}
+/** Create a resumable adapter backed by an S3 multipart broker endpoint. */
+export declare function s3MultipartAdapter(options: S3MultipartAdapterOptions): ResumableUploadAdapter;
+//# sourceMappingURL=s3-multipart.d.ts.map

package/dist/adapters/s3-multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-multipart.d.ts","sourceRoot":"","sources":["../../src/adapters/s3-multipart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAEX,sBAAsB,EAGtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,mBAAmB,CAAC;AAM3B,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACzC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAqBD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,yBAAyB,GAChC,sBAAsB,CA2JxB"}

package/dist/adapters/s3-multipart.js

@@ -0,0 +1,387 @@
+import { AssetValidationError } from "../utils/errors.js";
+import { RetryableError, withRetry } from "../utils/retry.js";
+const DEFAULT_PART_SIZE = 8388608;
+const S3_MIN_PART_SIZE = 5242880;
+function s3MultipartAdapter(options) {
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if ("function" != typeof fetchImpl) throw new Error("s3MultipartAdapter: no `fetch` implementation available. Pass `options.fetch`.");
+    const generateId = options.idGenerator ?? defaultIdGenerator;
+    const partSize = Math.max(options.partSize ?? DEFAULT_PART_SIZE, S3_MIN_PART_SIZE);
+    const endpoint = "string" == typeof options.endpoint ? options.endpoint : options.endpoint.toString();
+    const retry = options.retry ?? {};
+    const keyOf = (session)=>"string" == typeof session.meta?.key ? session.meta.key : void 0;
+    return {
+        async begin (file, resume, callOptions) {
+            const { signal, dispose } = combineSignals(options.signal, callOptions?.signal);
+            try {
+                if (resume) {
+                    const resumeKey = "string" == typeof resume.meta?.key ? resume.meta.key : void 0;
+                    const listed = await withRetry(()=>listParts(endpoint, fetchImpl, options.headers, resume.uploadId, resumeKey, signal), {
+                        ...retry,
+                        ...signal ? {
+                            signal
+                        } : {}
+                    });
+                    if (void 0 !== listed) {
+                        const key = resumeKey ?? listed.key;
+                        return {
+                            uploadId: resume.uploadId,
+                            parts: listed.parts,
+                            partSize: resume.partSize,
+                            meta: buildMeta(key, resume.meta)
+                        };
+                    }
+                }
+                const created = await withRetry(()=>createSession(endpoint, fetchImpl, options.headers, file, partSize, signal), {
+                    ...retry,
+                    ...signal ? {
+                        signal
+                    } : {}
+                });
+                return {
+                    uploadId: created.uploadId,
+                    parts: [],
+                    partSize: clampPartSize(created.partSize) ?? partSize,
+                    meta: buildMeta(created.key, fileMeta(file))
+                };
+            } finally{
+                dispose();
+            }
+        },
+        async uploadPart (session, part, callOptions) {
+            const { signal, dispose } = combineSignals(options.signal, callOptions?.signal);
+            try {
+                const signed = await signPart(endpoint, fetchImpl, options.headers, session.uploadId, keyOf(session), part.partNumber, signal);
+                const etag = await putPart(fetchImpl, signed, part, signal);
+                return {
+                    partNumber: part.partNumber,
+                    etag
+                };
+            } finally{
+                dispose();
+            }
+        },
+        async complete (session, parts, callOptions) {
+            const { signal, dispose } = combineSignals(options.signal, callOptions?.signal);
+            try {
+                const completed = await withRetry(()=>completeSession(endpoint, fetchImpl, options.headers, session.uploadId, keyOf(session), parts, signal), {
+                    ...retry,
+                    ...signal ? {
+                        signal
+                    } : {}
+                });
+                const id = completed.id ?? generateId();
+                const url = completed.publicUrl ?? stripQueryAndFragment(completed.url);
+                return buildResult(id, url, session.meta);
+            } finally{
+                dispose();
+            }
+        },
+        async abort (session, callOptions) {
+            const { signal, dispose } = combineSignals(options.signal, callOptions?.signal);
+            try {
+                await withRetry(()=>abortSession(endpoint, fetchImpl, options.headers, session.uploadId, keyOf(session), signal), {
+                    ...retry,
+                    ...signal ? {
+                        signal
+                    } : {}
+                });
+            } finally{
+                dispose();
+            }
+        }
+    };
+}
+async function createSession(endpoint, fetchImpl, headers, file, partSize, signal) {
+    const payload = await postAction(endpoint, fetchImpl, headers, {
+        action: "create",
+        name: file.name,
+        type: file.type,
+        size: file.size,
+        partSize
+    }, signal);
+    if (!isObject(payload) || "string" != typeof payload.uploadId || "" === payload.uploadId) throw new AssetValidationError("UPLOAD_FAILED", "s3MultipartAdapter: create response missing `uploadId`.");
+    if (!isOptionalString(payload.key)) throw badShape("create", "`key` must be a string");
+    if (void 0 !== payload.partSize && !isPositiveSafeInteger(payload.partSize)) throw badShape("create", "`partSize` must be a positive integer");
+    return {
+        uploadId: payload.uploadId,
+        ...void 0 !== payload.key ? {
+            key: payload.key
+        } : {},
+        ...void 0 !== payload.partSize ? {
+            partSize: payload.partSize
+        } : {}
+    };
+}
+async function signPart(endpoint, fetchImpl, headers, uploadId, key, partNumber, signal) {
+    const payload = await postAction(endpoint, fetchImpl, headers, {
+        action: "sign-part",
+        uploadId,
+        key,
+        partNumber
+    }, signal);
+    if (!isObject(payload) || "string" != typeof payload.url || "" === payload.url) throw new AssetValidationError("UPLOAD_FAILED", "s3MultipartAdapter: sign-part response missing `url`.");
+    if (void 0 !== payload.headers && !isStringRecord(payload.headers)) throw badShape("sign-part", "`headers` must be a string map");
+    return {
+        url: payload.url,
+        ...void 0 !== payload.headers ? {
+            headers: payload.headers
+        } : {}
+    };
+}
+async function completeSession(endpoint, fetchImpl, headers, uploadId, key, parts, signal) {
+    const payload = await postAction(endpoint, fetchImpl, headers, {
+        action: "complete",
+        uploadId,
+        key,
+        parts
+    }, signal);
+    if (!isObject(payload) || "string" != typeof payload.url || "" === payload.url) throw new AssetValidationError("UPLOAD_FAILED", "s3MultipartAdapter: complete response missing `url`.");
+    if (!isOptionalString(payload.publicUrl)) throw badShape("complete", "`publicUrl` must be a string");
+    if (!isOptionalString(payload.id)) throw badShape("complete", "`id` must be a string");
+    return {
+        url: payload.url,
+        ...void 0 !== payload.publicUrl ? {
+            publicUrl: payload.publicUrl
+        } : {},
+        ...void 0 !== payload.id ? {
+            id: payload.id
+        } : {}
+    };
+}
+function abortSession(endpoint, fetchImpl, headers, uploadId, key, signal) {
+    return postAction(endpoint, fetchImpl, headers, {
+        action: "abort",
+        uploadId,
+        key
+    }, signal);
+}
+async function listParts(endpoint, fetchImpl, headers, uploadId, key, signal) {
+    let response;
+    try {
+        response = await fetchImpl(endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...headers ?? {}
+            },
+            body: JSON.stringify({
+                action: "list-parts",
+                uploadId,
+                key
+            }),
+            ...signal ? {
+                signal
+            } : {}
+        });
+    } catch (cause) {
+        throw new RetryableError(`s3MultipartAdapter: list-parts request failed (${describeError(cause)}).`, {
+            cause
+        });
+    }
+    if (404 === response.status) return;
+    if (response.status >= 500) throw new RetryableError(`s3MultipartAdapter: list-parts returned ${response.status}.`, {
+        retryAfterMs: parseRetryAfter(response.headers.get("retry-after"))
+    });
+    if (!response.ok) throw new AssetValidationError("UPLOAD_FAILED", `s3MultipartAdapter: list-parts returned ${response.status}.`);
+    const payload = await parseJson(response, "list-parts");
+    if (!isObject(payload) || !isPartTagArray(payload.parts)) throw new AssetValidationError("UPLOAD_FAILED", "s3MultipartAdapter: list-parts response has a missing or malformed `parts` array.");
+    if (!isOptionalString(payload.key)) throw badShape("list-parts", "`key` must be a string");
+    return {
+        parts: payload.parts,
+        ...void 0 !== payload.key ? {
+            key: payload.key
+        } : {}
+    };
+}
+async function putPart(fetchImpl, signed, part, signal) {
+    let response;
+    try {
+        response = await fetchImpl(signed.url, {
+            method: "PUT",
+            body: part.blob,
+            ...signed.headers ? {
+                headers: signed.headers
+            } : {},
+            ...signal ? {
+                signal
+            } : {}
+        });
+    } catch (cause) {
+        throw new RetryableError(`s3MultipartAdapter: part ${part.partNumber} PUT failed (${describeError(cause)}).`, {
+            cause
+        });
+    }
+    if (response.status >= 500) throw new RetryableError(`s3MultipartAdapter: part ${part.partNumber} PUT returned ${response.status}.`, {
+        retryAfterMs: parseRetryAfter(response.headers.get("retry-after"))
+    });
+    if (!response.ok) throw new AssetValidationError("UPLOAD_FAILED", `s3MultipartAdapter: part ${part.partNumber} PUT returned ${response.status}.`);
+    const etag = response.headers.get("etag");
+    if (null === etag || "" === etag) throw new AssetValidationError("UPLOAD_FAILED", `s3MultipartAdapter: part ${part.partNumber} PUT returned no ETag header. Expose it via S3 CORS \`ExposeHeaders: ["ETag"]\`.`);
+    return etag;
+}
+async function postAction(endpoint, fetchImpl, headers, body, signal) {
+    let response;
+    try {
+        response = await fetchImpl(endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...headers ?? {}
+            },
+            body: JSON.stringify(body),
+            ...signal ? {
+                signal
+            } : {}
+        });
+    } catch (cause) {
+        throw new RetryableError(`s3MultipartAdapter: ${String(body.action)} request failed (${describeError(cause)}).`, {
+            cause
+        });
+    }
+    if (response.status >= 500) throw new RetryableError(`s3MultipartAdapter: ${String(body.action)} returned ${response.status}.`, {
+        retryAfterMs: parseRetryAfter(response.headers.get("retry-after"))
+    });
+    if (!response.ok) throw new AssetValidationError("UPLOAD_FAILED", `s3MultipartAdapter: ${String(body.action)} returned ${response.status}.`);
+    if ("abort" === body.action) return;
+    return parseJson(response, String(body.action));
+}
+async function parseJson(response, action) {
+    try {
+        return await response.json();
+    } catch (cause) {
+        throw new AssetValidationError("UPLOAD_FAILED", `s3MultipartAdapter: ${action} response was not JSON.`, {
+            cause
+        });
+    }
+}
+function fileMeta(file) {
+    return {
+        name: file.name,
+        size: file.size,
+        ...file.type ? {
+            type: file.type
+        } : {}
+    };
+}
+function buildMeta(key, base) {
+    return Object.freeze({
+        ...base ?? {},
+        ...void 0 !== key ? {
+            key
+        } : {}
+    });
+}
+function buildResult(id, url, meta) {
+    const name = "string" == typeof meta?.name ? meta.name : void 0;
+    const size = "number" == typeof meta?.size ? meta.size : void 0;
+    const type = "string" == typeof meta?.type ? meta.type : void 0;
+    const resultMeta = void 0 !== size || void 0 !== type ? {
+        ...void 0 !== size ? {
+            size
+        } : {},
+        ...void 0 !== type ? {
+            mimeType: type
+        } : {}
+    } : void 0;
+    return {
+        id,
+        url,
+        ...name ? {
+            name
+        } : {},
+        ...resultMeta ? {
+            meta: resultMeta
+        } : {}
+    };
+}
+function clampPartSize(value) {
+    if ("number" != typeof value || !Number.isSafeInteger(value) || value <= 0) return;
+    return Math.max(value, S3_MIN_PART_SIZE);
+}
+function isObject(value) {
+    return null !== value && "object" == typeof value && !Array.isArray(value);
+}
+function isOptionalString(value) {
+    return void 0 === value || "string" == typeof value;
+}
+function isPositiveSafeInteger(value) {
+    return "number" == typeof value && Number.isSafeInteger(value) && value > 0;
+}
+function isStringRecord(value) {
+    return isObject(value) && Object.values(value).every((v)=>"string" == typeof v);
+}
+function isPartTagArray(value) {
+    return Array.isArray(value) && value.every((p)=>isObject(p) && "number" == typeof p.partNumber && Number.isInteger(p.partNumber) && p.partNumber >= 1 && "string" == typeof p.etag);
+}
+function badShape(action, detail) {
+    return new AssetValidationError("UPLOAD_FAILED", `s3MultipartAdapter: ${action} response has an invalid shape — ${detail}.`);
+}
+function stripQueryAndFragment(url) {
+    const cuts = [
+        url.indexOf("?"),
+        url.indexOf("#")
+    ].filter((i)=>-1 !== i);
+    return 0 === cuts.length ? url : url.slice(0, Math.min(...cuts));
+}
+function parseRetryAfter(header) {
+    if (null === header) return;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0) return 1000 * seconds;
+    const date = Date.parse(header);
+    if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
+}
+function describeError(error) {
+    if (error instanceof Error) return error.message || error.name;
+    return String(error);
+}
+function defaultIdGenerator() {
+    if (void 0 !== globalThis.crypto && "function" == typeof globalThis.crypto.randomUUID) return globalThis.crypto.randomUUID();
+    return `asset-${Math.random().toString(36).slice(2)}-${Date.now()}`;
+}
+const NOOP_DISPOSE = ()=>void 0;
+function combineSignals(a, b) {
+    if (!a) return {
+        signal: b,
+        dispose: NOOP_DISPOSE
+    };
+    if (!b) return {
+        signal: a,
+        dispose: NOOP_DISPOSE
+    };
+    if (a === b) return {
+        signal: a,
+        dispose: NOOP_DISPOSE
+    };
+    const anyImpl = AbortSignal.any;
+    if ("function" == typeof anyImpl) return {
+        signal: anyImpl([
+            a,
+            b
+        ]),
+        dispose: NOOP_DISPOSE
+    };
+    const controller = new AbortController();
+    const onAbortA = ()=>{
+        if (!controller.signal.aborted) controller.abort(a.reason);
+    };
+    const onAbortB = ()=>{
+        if (!controller.signal.aborted) controller.abort(b.reason);
+    };
+    if (a.aborted) onAbortA();
+    else a.addEventListener("abort", onAbortA, {
+        once: true
+    });
+    if (b.aborted) onAbortB();
+    else b.addEventListener("abort", onAbortB, {
+        once: true
+    });
+    return {
+        signal: controller.signal,
+        dispose: ()=>{
+            a.removeEventListener("abort", onAbortA);
+            b.removeEventListener("abort", onAbortB);
+        }
+    };
+}
+export { s3MultipartAdapter };

package/dist/adapters/s3-presigned.d.cts

@@ -22,6 +22,7 @@ import { type RetryOptions } from "../utils/retry.js";
 export type { RetryOptions } from "../utils/retry.js";
 /** @deprecated Import from `@anvilkit/plugin-asset-manager/retry` instead. */
 export { RetryableError } from "../utils/retry.js";
+/** Configuration for uploads through a host-provided S3 presign endpoint. */
 export interface S3PresignedAdapterOptions {
     /** Endpoint that returns a presigned PUT target for the file. */
     readonly presignEndpoint: string | URL;
@@ -56,5 +57,6 @@ export interface S3PresignResponse {
     /** Optional asset id; falls back to `idGenerator()`. */
     readonly id?: string;
 }
+/** Create an upload adapter backed by a host presign endpoint and S3 PUT. */
 export declare function s3PresignedAdapter(options: S3PresignedAdapterOptions): UploadAdapter;
 //# sourceMappingURL=s3-presigned.d.cts.map

package/dist/adapters/s3-presigned.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"s3-presigned.d.cts","sourceRoot":"","sources":["../../src/adapters/s3-presigned.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACzC,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,yBAAyB,GAChC,aAAa,CA+Cf"}
+{"version":3,"file":"s3-presigned.d.cts","sourceRoot":"","sources":["../../src/adapters/s3-presigned.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACzC,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,yBAAyB,GAChC,aAAa,CA+Cf"}

package/dist/adapters/s3-presigned.d.ts

@@ -22,6 +22,7 @@ import { type RetryOptions } from "../utils/retry.js";
 export type { RetryOptions } from "../utils/retry.js";
 /** @deprecated Import from `@anvilkit/plugin-asset-manager/retry` instead. */
 export { RetryableError } from "../utils/retry.js";
+/** Configuration for uploads through a host-provided S3 presign endpoint. */
 export interface S3PresignedAdapterOptions {
     /** Endpoint that returns a presigned PUT target for the file. */
     readonly presignEndpoint: string | URL;
@@ -56,5 +57,6 @@ export interface S3PresignResponse {
     /** Optional asset id; falls back to `idGenerator()`. */
     readonly id?: string;
 }
+/** Create an upload adapter backed by a host presign endpoint and S3 PUT. */
 export declare function s3PresignedAdapter(options: S3PresignedAdapterOptions): UploadAdapter;
 //# sourceMappingURL=s3-presigned.d.ts.map

package/dist/adapters/s3-presigned.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"s3-presigned.d.ts","sourceRoot":"","sources":["../../src/adapters/s3-presigned.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACzC,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,yBAAyB,GAChC,aAAa,CA+Cf"}
+{"version":3,"file":"s3-presigned.d.ts","sourceRoot":"","sources":["../../src/adapters/s3-presigned.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACzC,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,yBAAyB,GAChC,aAAa,CA+Cf"}

package/dist/i18n/provider.d.cts

@@ -10,6 +10,7 @@
  */
 import type { ReactNode } from "react";
 import { type AssetManagerMessageKey } from "./entry.js";
+/** Provide asset-manager i18n messages for standalone UI subpath mounts. */
 export declare function AssetManagerI18nProvider({ children, }: {
     readonly children: ReactNode;
 }): ReactNode;

package/dist/i18n/provider.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.cts","sourceRoot":"","sources":["../../src/i18n/provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE9E,wBAAgB,wBAAwB,CAAC,EACxC,QAAQ,GACR,EAAE;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC7B,GAAG,SAAS,CAMZ;AAGD,OAAO,QAAQ,qBAAqB,CAAC;IACpC,UAAU,gBAAiB,SAAQ,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC;KAAG;CAC5E"}
+{"version":3,"file":"provider.d.cts","sourceRoot":"","sources":["../../src/i18n/provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE9E,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,EACxC,QAAQ,GACR,EAAE;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC7B,GAAG,SAAS,CAMZ;AAGD,OAAO,QAAQ,qBAAqB,CAAC;IACpC,UAAU,gBAAiB,SAAQ,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC;KAAG;CAC5E"}

package/dist/i18n/provider.d.ts

@@ -10,6 +10,7 @@
  */
 import type { ReactNode } from "react";
 import { type AssetManagerMessageKey } from "./entry.js";
+/** Provide asset-manager i18n messages for standalone UI subpath mounts. */
 export declare function AssetManagerI18nProvider({ children, }: {
     readonly children: ReactNode;
 }): ReactNode;

package/dist/i18n/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/i18n/provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE9E,wBAAgB,wBAAwB,CAAC,EACxC,QAAQ,GACR,EAAE;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC7B,GAAG,SAAS,CAMZ;AAGD,OAAO,QAAQ,qBAAqB,CAAC;IACpC,UAAU,gBAAiB,SAAQ,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC;KAAG;CAC5E"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/i18n/provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE9E,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,EACxC,QAAQ,GACR,EAAE;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC7B,GAAG,SAAS,CAMZ;AAGD,OAAO,QAAQ,qBAAqB,CAAC;IACpC,UAAU,gBAAiB,SAAQ,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC;KAAG;CAC5E"}

package/dist/index.cjs

@@ -28,6 +28,8 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    ASSET_MANAGER_ERROR_EVENT: ()=>external_plugin_cjs_namespaceObject.ASSET_MANAGER_ERROR_EVENT,
+    ASSET_MANAGER_UPLOADED_EVENT: ()=>external_plugin_cjs_namespaceObject.ASSET_MANAGER_UPLOADED_EVENT,
     AssetResolutionError: ()=>errors_cjs_namespaceObject.AssetResolutionError,
     AssetSourceError: ()=>errors_cjs_namespaceObject.AssetSourceError,
     AssetValidationError: ()=>errors_cjs_namespaceObject.AssetValidationError,
@@ -42,6 +44,8 @@ __webpack_require__.d(__webpack_exports__, {
     inMemoryUploader: ()=>in_memory_cjs_namespaceObject.inMemoryUploader,
     inferAssetKind: ()=>infer_kind_cjs_namespaceObject.inferAssetKind,
     inferStudioAssetKind: ()=>studio_asset_source_cjs_namespaceObject.inferStudioAssetKind,
+    isResumableAdapter: ()=>resumable_cjs_namespaceObject.isResumableAdapter,
+    parseAssetReference: ()=>asset_reference_cjs_namespaceObject.parseAssetReference,
     resolveAssets: ()=>resolver_cjs_namespaceObject.resolveAssets,
     resolveFolderId: ()=>folders_cjs_namespaceObject.resolveFolderId,
     uploadAsset: ()=>external_plugin_cjs_namespaceObject.uploadAsset,
@@ -51,6 +55,8 @@ const data_url_cjs_namespaceObject = require("./adapters/data-url.cjs");
 const in_memory_cjs_namespaceObject = require("./adapters/in-memory.cjs");
 const external_plugin_cjs_namespaceObject = require("./plugin.cjs");
 const folders_cjs_namespaceObject = require("./types/folders.cjs");
+const resumable_cjs_namespaceObject = require("./types/resumable.cjs");
+const asset_reference_cjs_namespaceObject = require("./utils/asset-reference.cjs");
 const csp_cjs_namespaceObject = require("./utils/csp.cjs");
 const errors_cjs_namespaceObject = require("./utils/errors.cjs");
 const infer_kind_cjs_namespaceObject = require("./utils/infer-kind.cjs");
@@ -58,6 +64,8 @@ const registry_cjs_namespaceObject = require("./utils/registry.cjs");
 const resolver_cjs_namespaceObject = require("./utils/resolver.cjs");
 const studio_asset_source_cjs_namespaceObject = require("./utils/studio-asset-source.cjs");
 const validate_upload_result_cjs_namespaceObject = require("./utils/validate-upload-result.cjs");
+exports.ASSET_MANAGER_ERROR_EVENT = __webpack_exports__.ASSET_MANAGER_ERROR_EVENT;
+exports.ASSET_MANAGER_UPLOADED_EVENT = __webpack_exports__.ASSET_MANAGER_UPLOADED_EVENT;
 exports.AssetResolutionError = __webpack_exports__.AssetResolutionError;
 exports.AssetSourceError = __webpack_exports__.AssetSourceError;
 exports.AssetValidationError = __webpack_exports__.AssetValidationError;
@@ -72,11 +80,15 @@ exports.getRequiredCsp = __webpack_exports__.getRequiredCsp;
 exports.inMemoryUploader = __webpack_exports__.inMemoryUploader;
 exports.inferAssetKind = __webpack_exports__.inferAssetKind;
 exports.inferStudioAssetKind = __webpack_exports__.inferStudioAssetKind;
+exports.isResumableAdapter = __webpack_exports__.isResumableAdapter;
+exports.parseAssetReference = __webpack_exports__.parseAssetReference;
 exports.resolveAssets = __webpack_exports__.resolveAssets;
 exports.resolveFolderId = __webpack_exports__.resolveFolderId;
 exports.uploadAsset = __webpack_exports__.uploadAsset;
 exports.validateUploadResult = __webpack_exports__.validateUploadResult;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "ASSET_MANAGER_ERROR_EVENT",
+    "ASSET_MANAGER_UPLOADED_EVENT",
     "AssetResolutionError",
     "AssetSourceError",
     "AssetValidationError",
@@ -91,6 +103,8 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "inMemoryUploader",
     "inferAssetKind",
     "inferStudioAssetKind",
+    "isResumableAdapter",
+    "parseAssetReference",
     "resolveAssets",
     "resolveFolderId",
     "uploadAsset",

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 export type { DataUrlUploaderOptions } from "./adapters/data-url.js";
 export { dataUrlUploader } from "./adapters/data-url.js";
 export { inMemoryUploader } from "./adapters/in-memory.js";
-export { createAssetManagerPlugin, createAssetReference, getAssetRegistry, uploadAsset, } from "./plugin.js";
+export type { AssetManagerErrorEvent, AssetManagerEventMap, AssetManagerEventName, AssetManagerUploadedEvent, } from "./plugin.js";
+export { ASSET_MANAGER_ERROR_EVENT, ASSET_MANAGER_UPLOADED_EVENT, createAssetManagerPlugin, createAssetReference, getAssetRegistry, uploadAsset, } from "./plugin.js";
 export type { AssetSourceCapabilities, AssetSourceProvider, AssetTheme, } from "./sources/provider.js";
 export type { AssetCategory, AssetFacetDefinition, AssetFacetOption, } from "./types/categories.js";
 export type { AssetDataSource, AssetSourceStatus, ReplacePayload, } from "./types/data-source.js";
@@ -9,9 +10,14 @@ export type { AssetFilter, AssetListPage, AssetSort, AssetSortField, AssetSource
 export type { AssetFolder, FolderId, FolderOptions } from "./types/folders.js";
 export { resolveFolderId } from "./types/folders.js";
 export type { AssetManagerOptions } from "./types/options.js";
-export type { AssetKind, AssetMeta, AssetRegistry, AssetRegistryListener, AssetSearchOptions, AssetSearchPage, UploadAdapter, UploadAdapterOptions, UploadResult, } from "./types/types.js";
+export type { JsonValue, PartTag, PersistedUploadSession, ResumableUploadAdapter, ResumableUploadConfig, UploadPart, UploadSession, UploadSessionStore, } from "./types/resumable.js";
+export { isResumableAdapter } from "./types/resumable.js";
+export type { AssetTransform, TransformResolver, } from "./types/transform.js";
+export type { AssetDeletedHook, AssetKind, AssetMeta, AssetRegistry, AssetRegistryListener, AssetSearchOptions, AssetSearchPage, UploadAdapter, UploadAdapterOptions, UploadResult, } from "./types/types.js";
 export type { UnsplashSourceOptions, UnsplashTheme, UnsplashThemeConfig, } from "./types/unsplash.js";
-export type { RequiredCsp, RequiredCspOptions, S3CspOptions, } from "./utils/csp.js";
+export type { ParsedAssetReference } from "./utils/asset-reference.js";
+export { parseAssetReference } from "./utils/asset-reference.js";
+export type { RequiredCsp, RequiredCspOptions, S3CspOptions, S3MultipartCspOptions, } from "./utils/csp.js";
 export { getRequiredCsp } from "./utils/csp.js";
 export type { AssetResolutionErrorCode, AssetSourceErrorCode, } from "./utils/errors.js";
 export { AssetResolutionError, AssetSourceError, AssetValidationError, } from "./utils/errors.js";