@adonis-agora/media 0.1.1 → 0.2.1

package/dist/src/disks/s3.js

@@ -0,0 +1,357 @@
+import { AbortMultipartUploadCommand, CompleteMultipartUploadCommand, CopyObjectCommand, CreateMultipartUploadCommand, DeleteObjectCommand, DeleteObjectsCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, UploadPartCommand, } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { extractListObjectsV2FromXml, isXmlEntityDeserializationError } from './xml_fallback.js';
+/** Default presigned-URL lifetime when a caller passes no `expiresIn` (30 minutes). */
+const DEFAULT_SIGNED_URL_TTL_SECONDS = 1800;
+/** Human-readable duration units accepted in {@link SignedUrlOptions.expiresIn}. */
+const DURATION_UNITS = { s: 1, m: 60, h: 3600, d: 86_400 };
+/**
+ * Convert Drive's `expiresIn` (a number of seconds, or a string like `'30m'`/`'1h'`/`'45s'`/`'2d'`)
+ * into the whole-seconds the S3 request presigner expects.
+ */
+function toExpiresInSeconds(expiresIn) {
+    if (expiresIn === undefined)
+        return DEFAULT_SIGNED_URL_TTL_SECONDS;
+    if (typeof expiresIn === 'number')
+        return Math.max(1, Math.round(expiresIn));
+    const match = /^(\d+)\s*([smhd])$/.exec(expiresIn.trim());
+    if (match) {
+        const value = Number(match[1]);
+        const unit = DURATION_UNITS[match[2]];
+        return Math.max(1, value * unit);
+    }
+    const asNumber = Number(expiresIn);
+    if (Number.isFinite(asNumber) && asNumber > 0)
+        return Math.round(asNumber);
+    return DEFAULT_SIGNED_URL_TTL_SECONDS;
+}
+function isNotFound(err) {
+    const e = err;
+    return e?.name === 'NoSuchKey' || e?.name === 'NotFound' || e?.$metadata?.httpStatusCode === 404;
+}
+/**
+ * S3-backed {@link Disk} satisfying the same structural contract as an `@adonisjs/drive` disk, so it
+ * is a drop-in for the media-library and attachment layers. Backed by `@aws-sdk/client-s3` (an
+ * optional peer). Beyond the base {@link Disk} surface it also implements {@link MultipartUploadDisk}
+ * — native S3 multipart, powering the `proxy` and `direct` upload modes — which the upload layer
+ * detects structurally (`isMultipartCapable`) rather than through the base contract. It also
+ * implements the optional {@link ExtendedDisk} surface (copy/move, batched delete, list, size/stat,
+ * plus a {@link DiskCapabilities} descriptor), detected structurally via `isExtendedDisk`.
+ */
+export class S3Disk {
+    /** Coarse feature descriptor — S3 supports presign, native multipart, and prefix listing. */
+    capabilities;
+    client;
+    bucket;
+    keyPrefix;
+    publicBaseUrl;
+    region;
+    endpoint;
+    forcePathStyle;
+    constructor(options) {
+        this.client = options.client;
+        this.bucket = options.bucket;
+        this.keyPrefix = (options.keyPrefix ?? '').replace(/^\/+|\/+$/g, '');
+        this.publicBaseUrl = options.publicBaseUrl;
+        this.region = options.region;
+        this.endpoint = options.endpoint;
+        this.forcePathStyle = options.forcePathStyle ?? false;
+        this.capabilities = {
+            presign: true,
+            multipart: true,
+            // A stable public URL can always be synthesised (publicBaseUrl, endpoint, or the regional host).
+            publicUrls: true,
+            list: true,
+        };
+    }
+    /** Map a logical key to a fully-qualified S3 key, applying the configured prefix. */
+    key(path) {
+        const clean = path.replace(/^\/+/, '');
+        return this.keyPrefix ? `${this.keyPrefix}/${clean}` : clean;
+    }
+    async put(key, contents, options) {
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            Body: contents,
+            ContentType: options?.contentType,
+            ACL: options?.visibility === 'public' ? 'public-read' : undefined,
+        }));
+    }
+    /**
+     * `ContentLength` is required, not an optimization: S3 cannot size a stream, so the SDK
+     * derives `x-amz-decoded-content-length` from it and throws
+     * `Invalid value "undefined" for header "x-amz-decoded-content-length"` when it is absent.
+     * Callers that reach this path already know the size (it is what makes streaming eligible).
+     */
+    async putStream(key, contents, options) {
+        if (options?.contentLength === undefined) {
+            throw new Error(`S3Disk.putStream requires options.contentLength for key: ${key} — S3 cannot size a stream.`);
+        }
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            Body: contents,
+            ContentLength: options.contentLength,
+            ContentType: options.contentType,
+            ACL: options.visibility === 'public' ? 'public-read' : undefined,
+        }));
+    }
+    async getBytes(key) {
+        try {
+            const res = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+            const bytes = await res.Body?.transformToByteArray();
+            if (!bytes)
+                throw new Error(`S3Disk: empty body for key: ${key}`);
+            return bytes;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                throw new Error(`S3Disk: file not found: ${key}`);
+            throw err;
+        }
+    }
+    async getStream(key) {
+        try {
+            const res = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+            if (!res.Body)
+                throw new Error(`S3Disk: file not found: ${key}`);
+            return res.Body;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                throw new Error(`S3Disk: file not found: ${key}`);
+            throw err;
+        }
+    }
+    async exists(key) {
+        try {
+            await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+            return true;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return false;
+            throw err;
+        }
+    }
+    async delete(key) {
+        await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+    }
+    async getUrl(key) {
+        const objectKey = this.key(key);
+        if (this.publicBaseUrl) {
+            return `${this.publicBaseUrl.replace(/\/+$/, '')}/${objectKey}`;
+        }
+        if (this.endpoint) {
+            const base = this.endpoint.replace(/\/+$/, '');
+            if (this.forcePathStyle)
+                return `${base}/${this.bucket}/${objectKey}`;
+            const withHost = base.replace(/^(https?:\/\/)/, `$1${this.bucket}.`);
+            return `${withHost}/${objectKey}`;
+        }
+        const region = this.region ?? 'us-east-1';
+        return `https://${this.bucket}.s3.${region}.amazonaws.com/${objectKey}`;
+    }
+    async getSignedUrl(key, options) {
+        return getSignedUrl(this.client, new GetObjectCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            ResponseContentType: options?.contentType,
+            ResponseContentDisposition: options?.contentDisposition,
+        }), { expiresIn: toExpiresInSeconds(options?.expiresIn) });
+    }
+    async getMetaData(key) {
+        try {
+            const res = await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+            return {
+                contentLength: res.ContentLength ?? 0,
+                contentType: res.ContentType,
+                etag: res.ETag,
+                lastModified: res.LastModified,
+            };
+        }
+        catch (err) {
+            if (isNotFound(err))
+                throw new Error(`S3Disk: file not found: ${key}`);
+            throw err;
+        }
+    }
+    // --- Extended object operations (ExtendedDisk) --------------------------------------------
+    async size(key) {
+        try {
+            const res = await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+            return res.ContentLength ?? 0;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                throw new Error(`S3Disk: file not found: ${key}`);
+            throw err;
+        }
+    }
+    async stat(key) {
+        try {
+            const res = await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: this.key(key) }));
+            return {
+                size: res.ContentLength ?? 0,
+                contentType: res.ContentType,
+                lastModified: res.LastModified,
+            };
+        }
+        catch (err) {
+            if (isNotFound(err))
+                throw new Error(`S3Disk: file not found: ${key}`);
+            throw err;
+        }
+    }
+    async copy(from, to, options) {
+        const targetBucket = options?.toBucket ?? this.bucket;
+        await this.client.send(new CopyObjectCommand({
+            // Destination bucket (may differ from the source for cross-bucket copies).
+            Bucket: targetBucket,
+            // Source is always this disk's configured bucket + prefixed key.
+            CopySource: `${this.bucket}/${this.key(from)}`,
+            Key: this.key(to),
+        }));
+    }
+    async move(from, to, options) {
+        await this.copy(from, to, options);
+        await this.delete(from);
+    }
+    async deleteMany(keys) {
+        if (keys.length === 0)
+            return;
+        // S3 caps a DeleteObjects batch at 1000 keys.
+        for (let start = 0; start < keys.length; start += 1000) {
+            const batch = keys.slice(start, start + 1000);
+            const res = await this.client.send(new DeleteObjectsCommand({
+                Bucket: this.bucket,
+                Delete: { Objects: batch.map((key) => ({ Key: this.key(key) })) },
+            }));
+            // DeleteObjects returns 200 with a per-key Errors[] on partial failure; single delete()
+            // throws on failure, so match that here instead of swallowing.
+            if (res.Errors && res.Errors.length > 0) {
+                const failed = res.Errors.map((error) => error.Key ?? '?').join(', ');
+                throw new Error(`S3Disk: deleteMany failed for keys: ${failed}`);
+            }
+        }
+    }
+    async list(prefix, options) {
+        const bucket = options?.bucket ?? this.bucket;
+        const fullPrefix = this.key(prefix);
+        try {
+            const out = await this.client.send(new ListObjectsV2Command({
+                Bucket: bucket,
+                Prefix: fullPrefix,
+                Delimiter: options?.delimiter ?? '/',
+                MaxKeys: options?.limit,
+                ContinuationToken: options?.cursor,
+            }));
+            const folders = (out.CommonPrefixes ?? [])
+                .map((commonPrefix) => commonPrefix.Prefix)
+                .filter((value) => typeof value === 'string');
+            const files = (out.Contents ?? [])
+                .filter((object) => object.Key !== undefined && object.Key !== fullPrefix)
+                .map((object) => {
+                const objectKey = object.Key;
+                return {
+                    key: objectKey,
+                    name: objectKey.slice(fullPrefix.length),
+                    sizeBytes: object.Size ?? null,
+                    lastModified: object.LastModified ?? null,
+                };
+            });
+            const result = { folders, files };
+            if (out.IsTruncated && out.NextContinuationToken !== undefined) {
+                result.cursor = out.NextContinuationToken;
+            }
+            return result;
+        }
+        catch (err) {
+            if (!isXmlEntityDeserializationError(err))
+                throw err;
+            // fast-xml-parser rejected valid entity refs in the ListObjectsV2 XML — presign the same
+            // request and fetch the raw body, then parse it by hand into the same shape. The presigner is
+            // already bundled with this disk, so the fallback adds no new dependency (see xml_fallback.ts).
+            const signedUrl = await getSignedUrl(this.client, new ListObjectsV2Command({
+                Bucket: bucket,
+                Prefix: fullPrefix,
+                Delimiter: options?.delimiter ?? '/',
+                MaxKeys: options?.limit,
+                ContinuationToken: options?.cursor,
+            }), { expiresIn: 60 });
+            const response = await fetch(signedUrl);
+            if (!response.ok) {
+                throw new Error(`S3Disk: signed list fallback failed: HTTP ${response.status} ${response.statusText}`);
+            }
+            const xml = await response.text();
+            const parsed = extractListObjectsV2FromXml(xml);
+            const files = parsed.objects
+                .filter((object) => object.key !== fullPrefix)
+                .map((object) => ({
+                key: object.key,
+                name: object.key.slice(fullPrefix.length),
+                sizeBytes: object.size,
+                lastModified: object.lastModified ? new Date(object.lastModified) : null,
+            }));
+            const result = { folders: parsed.folders, files };
+            if (parsed.isTruncated && parsed.nextContinuationToken) {
+                result.cursor = parsed.nextContinuationToken;
+            }
+            return result;
+        }
+    }
+    // --- Native multipart (MultipartUploadDisk) -----------------------------------------------
+    async createMultipartUpload(key, options) {
+        const out = await this.client.send(new CreateMultipartUploadCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            ContentType: options?.contentType,
+            ACL: options?.visibility === 'public' ? 'public-read' : undefined,
+        }));
+        if (!out.UploadId)
+            throw new Error('S3Disk: S3 did not return an UploadId');
+        return { uploadId: out.UploadId };
+    }
+    async uploadPart(key, uploadId, partNumber, body) {
+        const out = await this.client.send(new UploadPartCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            UploadId: uploadId,
+            PartNumber: partNumber,
+            Body: body,
+        }));
+        if (!out.ETag)
+            throw new Error('S3Disk: S3 did not return an ETag for the uploaded part');
+        return { partNumber, etag: out.ETag };
+    }
+    async presignUploadPart(key, uploadId, partNumber, expiresInSeconds) {
+        return getSignedUrl(this.client, new UploadPartCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            UploadId: uploadId,
+            PartNumber: partNumber,
+        }), { expiresIn: Math.max(1, Math.round(expiresInSeconds)) });
+    }
+    async completeMultipartUpload(key, uploadId, parts) {
+        await this.client.send(new CompleteMultipartUploadCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            UploadId: uploadId,
+            MultipartUpload: {
+                Parts: parts
+                    .slice()
+                    .sort((a, b) => a.partNumber - b.partNumber)
+                    .map((p) => ({ PartNumber: p.partNumber, ETag: p.etag })),
+            },
+        }));
+    }
+    async abortMultipartUpload(key, uploadId) {
+        await this.client.send(new AbortMultipartUploadCommand({
+            Bucket: this.bucket,
+            Key: this.key(key),
+            UploadId: uploadId,
+        }));
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/src/disks/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../../src/disks/s3.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,iBAAiB,EACjB,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAEhB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAgB7D,OAAO,EAAE,2BAA2B,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAwBjG,uFAAuF;AACvF,MAAM,8BAA8B,GAAG,IAAI,CAAC;AAE5C,oFAAoF;AACpF,MAAM,cAAc,GAA2B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AAEnF;;;GAGG;AACH,SAAS,kBAAkB,CAAC,SAAsC;IAChE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,8BAA8B,CAAC;IACnE,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAW,CAAW,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3E,OAAO,8BAA8B,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,GAAY;IAC9B,MAAM,CAAC,GAAG,GAAiE,CAAC;IAC5E,OAAO,CAAC,EAAE,IAAI,KAAK,WAAW,IAAI,CAAC,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,EAAE,SAAS,EAAE,cAAc,KAAK,GAAG,CAAC;AACnG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAM;IACjB,6FAA6F;IACpF,YAAY,CAAmB;IACvB,MAAM,CAAW;IACjB,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,aAAa,CAAqB;IAClC,MAAM,CAAqB;IAC3B,QAAQ,CAAqB;IAC7B,cAAc,CAAU;IAEzC,YAAY,OAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QACtD,IAAI,CAAC,YAAY,GAAG;YAClB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,iGAAiG;YACjG,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,GAAG,CAAC,IAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,QAAoB,EAAE,OAA0B;QACrE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,gBAAgB,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,GAAG,EAAE,OAAO,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,QAAkB,EAAE,OAA0B;QACzE,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,4DAA4D,GAAG,6BAA6B,CAC7F,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,gBAAgB,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,EAAE,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAClE,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,oBAAoB,EAAE,CAAC;YACrD,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAClE,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACjE,OAAO,GAAG,CAAC,IAAgB,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3F,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YAClC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,cAAc;gBAAE,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YACrE,OAAO,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;QACpC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC;QAC1C,OAAO,WAAW,IAAI,CAAC,MAAM,OAAO,MAAM,kBAAkB,SAAS,EAAE,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,OAA0B;QACxD,OAAO,YAAY,CACjB,IAAI,CAAC,MAAM,EACX,IAAI,gBAAgB,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,mBAAmB,EAAE,OAAO,EAAE,WAAW;YACzC,0BAA0B,EAAE,OAAO,EAAE,kBAAkB;SACxD,CAAC,EACF,EAAE,SAAS,EAAE,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CACnE,CAAC;YACF,OAAO;gBACL,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC;gBACrC,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,6FAA6F;IAE7F,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CACnE,CAAC;YACF,OAAO,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CACnE,CAAC;YACF,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC;gBAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,EAAU,EAAE,OAAqB;QACxD,MAAM,YAAY,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;QACtD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,iBAAiB,CAAC;YACpB,2EAA2E;YAC3E,MAAM,EAAE,YAAY;YACpB,iEAAiE;YACjE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC9C,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;SAClB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,EAAU,EAAE,OAAqB;QACxD,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAc;QAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,8CAA8C;QAC9C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,oBAAoB,CAAC;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE;aAClE,CAAC,CACH,CAAC;YACF,wFAAwF;YACxF,+DAA+D;YAC/D,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,OAAqB;QAC9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,oBAAoB,CAAC;gBACvB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,UAAU;gBAClB,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG;gBACpC,OAAO,EAAE,OAAO,EAAE,KAAK;gBACvB,iBAAiB,EAAE,OAAO,EAAE,MAAM;aACnC,CAAC,CACH,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;iBACvC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;iBAC1C,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;YACjE,MAAM,KAAK,GAAgB,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;iBAC5C,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,UAAU,CAAC;iBACzE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBACd,MAAM,SAAS,GAAG,MAAM,CAAC,GAAa,CAAC;gBACvC,OAAO;oBACL,GAAG,EAAE,SAAS;oBACd,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;oBACxC,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;oBAC9B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI;iBAC1C,CAAC;YACJ,CAAC,CAAC,CAAC;YACL,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC9C,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,qBAAqB,KAAK,SAAS,EAAE,CAAC;gBAC/D,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,qBAAqB,CAAC;YAC5C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,+BAA+B,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YACrD,yFAAyF;YACzF,8FAA8F;YAC9F,gGAAgG;YAChG,MAAM,SAAS,GAAG,MAAM,YAAY,CAClC,IAAI,CAAC,MAAM,EACX,IAAI,oBAAoB,CAAC;gBACvB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,UAAU;gBAClB,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG;gBACpC,OAAO,EAAE,OAAO,EAAE,KAAK;gBACvB,iBAAiB,EAAE,OAAO,EAAE,MAAM;aACnC,CAAC,EACF,EAAE,SAAS,EAAE,EAAE,EAAE,CAClB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACtF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC;YAChD,MAAM,KAAK,GAAgB,MAAM,CAAC,OAAO;iBACtC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,UAAU,CAAC;iBAC7C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;gBACzC,SAAS,EAAE,MAAM,CAAC,IAAI;gBACtB,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;aACzE,CAAC,CAAC,CAAC;YACN,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YAC9D,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;gBACvD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;YAC/C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,6FAA6F;IAE7F,KAAK,CAAC,qBAAqB,CACzB,GAAW,EACX,OAA0B;QAE1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,4BAA4B,CAAC;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,GAAG,EAAE,OAAO,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC,CACH,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC5E,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAW,EACX,QAAgB,EAChB,UAAkB,EAClB,IAAgB;QAEhB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,IAAI,iBAAiB,CAAC;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,UAAU;YACtB,IAAI,EAAE,IAAI;SACX,CAAC,CACH,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC1F,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,GAAW,EACX,QAAgB,EAChB,UAAkB,EAClB,gBAAwB;QAExB,OAAO,YAAY,CACjB,IAAI,CAAC,MAAM,EACX,IAAI,iBAAiB,CAAC;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,UAAU;SACvB,CAAC,EACF,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,CACzD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,GAAW,EACX,QAAgB,EAChB,KAAsB;QAEtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,8BAA8B,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,QAAQ,EAAE,QAAQ;YAClB,eAAe,EAAE;gBACf,KAAK,EAAE,KAAK;qBACT,KAAK,EAAE;qBACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;qBAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;aAC5D;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,GAAW,EAAE,QAAgB;QACtD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,2BAA2B,CAAC;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,QAAQ,EAAE,QAAQ;SACnB,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

package/dist/src/disks/xml_fallback.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The AWS SDK deserializes S3's XML responses with `fast-xml-parser`. Some hosts pin
+ * `fast-xml-parser` v5 (CVE remediation), whose stricter mode rejects valid numeric character
+ * references (`
`, …) that S3 legitimately emits inside keys — surfacing as a deserialization
+ * error on `ListObjectsV2`. This module provides a fallback for {@link S3Disk.list}: re-issue the
+ * request as a signed raw GET (presigned with `@aws-sdk/s3-request-presigner`, an existing optional
+ * peer) and hand-parse the XML, bypassing `fast-xml-parser` entirely.
+ *
+ * NOTE: this fallback does NOT depend on `fast-xml-parser` — it exists precisely to work around it —
+ * and introduces NO new peer: the signing reuses the presigner already bundled with the S3 disk, so
+ * only regex XML parsing lives here.
+ */
+/** Is this the `fast-xml-parser` entity-rejection error the signed-GET fallback exists for? */
+export declare function isXmlEntityDeserializationError(error: unknown): boolean;
+export declare function decodeXmlEntities(value: string): string;
+export interface ListObjectsV2Entry {
+    key: string;
+    size: number | null;
+    lastModified: string | null;
+}
+export interface ListObjectsV2FromXml {
+    folders: string[];
+    objects: ListObjectsV2Entry[];
+    nextContinuationToken: string | null;
+    isTruncated: boolean;
+}
+/** Hand-parse a `ListObjectsV2` XML body into the shape {@link S3Disk.list} needs. */
+export declare function extractListObjectsV2FromXml(xml: string): ListObjectsV2FromXml;
+//# sourceMappingURL=xml_fallback.d.ts.map

package/dist/src/disks/xml_fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml_fallback.d.ts","sourceRoot":"","sources":["../../../src/disks/xml_fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,+FAA+F;AAC/F,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAiC7E"}

package/dist/src/disks/xml_fallback.js

@@ -0,0 +1,68 @@
+/**
+ * The AWS SDK deserializes S3's XML responses with `fast-xml-parser`. Some hosts pin
+ * `fast-xml-parser` v5 (CVE remediation), whose stricter mode rejects valid numeric character
+ * references (`
`, …) that S3 legitimately emits inside keys — surfacing as a deserialization
+ * error on `ListObjectsV2`. This module provides a fallback for {@link S3Disk.list}: re-issue the
+ * request as a signed raw GET (presigned with `@aws-sdk/s3-request-presigner`, an existing optional
+ * peer) and hand-parse the XML, bypassing `fast-xml-parser` entirely.
+ *
+ * NOTE: this fallback does NOT depend on `fast-xml-parser` — it exists precisely to work around it —
+ * and introduces NO new peer: the signing reuses the presigner already bundled with the S3 disk, so
+ * only regex XML parsing lives here.
+ */
+const ENTITY_NAME_REGEX = /Invalid character.*entity name/i;
+/** Is this the `fast-xml-parser` entity-rejection error the signed-GET fallback exists for? */
+export function isXmlEntityDeserializationError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message ?? '';
+    return (message.includes('EntityReplacer') ||
+        message.includes('Deserialization') ||
+        ENTITY_NAME_REGEX.test(message));
+}
+export function decodeXmlEntities(value) {
+    return value
+        .replace(/&#x([0-9A-Fa-f]+);/g, (_match, hex) => String.fromCodePoint(Number.parseInt(hex, 16)))
+        .replace(/&#(\d+);/g, (_match, dec) => String.fromCodePoint(Number.parseInt(dec, 10)))
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&');
+}
+/** Hand-parse a `ListObjectsV2` XML body into the shape {@link S3Disk.list} needs. */
+export function extractListObjectsV2FromXml(xml) {
+    const folders = matchAll(xml, /<CommonPrefixes>[\s\S]*?<Prefix>([\s\S]*?)<\/Prefix>[\s\S]*?<\/CommonPrefixes>/g).map((match) => decodeXmlEntities(match[1] ?? ''));
+    const objects = matchAll(xml, /<Contents>([\s\S]*?)<\/Contents>/g).map((match) => {
+        const block = match[1] ?? '';
+        const keyMatch = block.match(/<Key>([\s\S]*?)<\/Key>/);
+        const sizeMatch = block.match(/<Size>([\s\S]*?)<\/Size>/);
+        const lastModifiedMatch = block.match(/<LastModified>([\s\S]*?)<\/LastModified>/);
+        return {
+            key: keyMatch ? decodeXmlEntities(keyMatch[1] ?? '') : '',
+            size: sizeMatch ? Number(sizeMatch[1]) : null,
+            lastModified: lastModifiedMatch ? decodeXmlEntities(lastModifiedMatch[1] ?? '') : null,
+        };
+    });
+    const nextContinuationTokenMatch = xml.match(/<NextContinuationToken>([\s\S]*?)<\/NextContinuationToken>/);
+    const isTruncatedMatch = xml.match(/<IsTruncated>(true|false)<\/IsTruncated>/);
+    return {
+        folders,
+        objects,
+        nextContinuationToken: nextContinuationTokenMatch
+            ? decodeXmlEntities(nextContinuationTokenMatch[1] ?? '')
+            : null,
+        isTruncated: isTruncatedMatch?.[1] === 'true',
+    };
+}
+function matchAll(input, regex) {
+    const matches = [];
+    const localRegex = new RegExp(regex.source, regex.flags);
+    let match = localRegex.exec(input);
+    while (match !== null) {
+        matches.push(match);
+        match = localRegex.exec(input);
+    }
+    return matches;
+}
+//# sourceMappingURL=xml_fallback.js.map

package/dist/src/disks/xml_fallback.js.map

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

package/dist/src/errors.d.ts

@@ -14,4 +14,38 @@ export declare class ImageProcessorMissingError extends Error {
     readonly code = "E_MEDIA_IMAGE_PROCESSOR_MISSING";
     constructor();
 }
+export declare class VariantNotFoundError extends Error {
+    readonly code = "E_MEDIA_VARIANT_NOT_FOUND";
+    constructor(variant: string);
+}
+export declare class UploadNotSupportedError extends Error {
+    readonly code = "E_MEDIA_UPLOAD_NOT_SUPPORTED";
+    constructor(disk: string, operation?: string);
+}
+export declare class UploadSessionNotFoundError extends Error {
+    readonly code = "E_MEDIA_UPLOAD_SESSION_NOT_FOUND";
+    constructor(id: string);
+}
+export declare class UploadOffsetConflictError extends Error {
+    readonly expected: number;
+    readonly received: number;
+    readonly code = "E_MEDIA_UPLOAD_OFFSET_CONFLICT";
+    constructor(expected: number, received: number);
+}
+export declare class UploadSessionExpiredError extends Error {
+    readonly code = "E_MEDIA_UPLOAD_SESSION_EXPIRED";
+    constructor(id: string);
+}
+export declare class ResumableUploadsNotConfiguredError extends Error {
+    readonly code = "E_MEDIA_RESUMABLE_NOT_CONFIGURED";
+    constructor();
+}
+export declare class StoreNotConfiguredError extends Error {
+    readonly code = "E_MEDIA_STORE_NOT_CONFIGURED";
+    constructor(name: string);
+}
+export declare class UploadSessionStoreNotConfiguredError extends Error {
+    readonly code = "E_MEDIA_UPLOAD_SESSION_STORE_NOT_CONFIGURED";
+    constructor(name: string);
+}
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIjD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,oCAAoC;gBACrC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAInD;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,qCAAqC;;CAKnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIjD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,oCAAoC;gBACrC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAInD;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,qCAAqC;;CAKnD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,+BAA+B;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,kCAAkC;gBACnC,IAAI,EAAE,MAAM,EAAE,SAAS,SAA4B;CAMhE;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,sCAAsC;gBACvC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAGhD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAH3B,QAAQ,CAAC,IAAI,oCAAoC;gBAEtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAK5B;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,oCAAoC;gBACrC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,QAAQ,CAAC,IAAI,sCAAsC;;CAOpD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,kCAAkC;gBACnC,IAAI,EAAE,MAAM;CAMzB;AAED,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,IAAI,iDAAiD;gBAClD,IAAI,EAAE,MAAM;CAMzB"}

package/dist/src/errors.js

@@ -26,4 +26,64 @@ export class ImageProcessorMissingError extends Error {
         this.name = 'ImageProcessorMissingError';
     }
 }
+export class VariantNotFoundError extends Error {
+    code = 'E_MEDIA_VARIANT_NOT_FOUND';
+    constructor(variant) {
+        super(`Attachment has no variant "${variant}"`);
+        this.name = 'VariantNotFoundError';
+    }
+}
+export class UploadNotSupportedError extends Error {
+    code = 'E_MEDIA_UPLOAD_NOT_SUPPORTED';
+    constructor(disk, operation = 'direct multipart upload') {
+        super(`Disk "${disk}" does not support ${operation}. Use a multipart-capable disk (e.g. \`disks.s3()\`) or the \`proxy\` upload mode.`);
+        this.name = 'UploadNotSupportedError';
+    }
+}
+export class UploadSessionNotFoundError extends Error {
+    code = 'E_MEDIA_UPLOAD_SESSION_NOT_FOUND';
+    constructor(id) {
+        super(`Upload session not found: ${id}`);
+        this.name = 'UploadSessionNotFoundError';
+    }
+}
+export class UploadOffsetConflictError extends Error {
+    expected;
+    received;
+    code = 'E_MEDIA_UPLOAD_OFFSET_CONFLICT';
+    constructor(expected, received) {
+        super(`Upload offset conflict: expected ${expected}, received ${received}`);
+        this.expected = expected;
+        this.received = received;
+        this.name = 'UploadOffsetConflictError';
+    }
+}
+export class UploadSessionExpiredError extends Error {
+    code = 'E_MEDIA_UPLOAD_SESSION_EXPIRED';
+    constructor(id) {
+        super(`Upload session has expired: ${id}`);
+        this.name = 'UploadSessionExpiredError';
+    }
+}
+export class ResumableUploadsNotConfiguredError extends Error {
+    code = 'E_MEDIA_RESUMABLE_NOT_CONFIGURED';
+    constructor() {
+        super("Resumable (TUS) uploads are not configured. Set `uploads.resumable` in config/media.ts (e.g. `resumable: { store: 'lucid', stores: { lucid: uploadSessions.lucid() } }`) to enable the resumable upload session store.");
+        this.name = 'ResumableUploadsNotConfiguredError';
+    }
+}
+export class StoreNotConfiguredError extends Error {
+    code = 'E_MEDIA_STORE_NOT_CONFIGURED';
+    constructor(name) {
+        super(`Media config selects store "${name}" but no matching factory exists in \`stores\`. Add \`stores.${name}\` to config/media.ts (e.g. \`stores: { ${name}: stores.lucid() }\`), or omit \`store\` to use the in-memory store.`);
+        this.name = 'StoreNotConfiguredError';
+    }
+}
+export class UploadSessionStoreNotConfiguredError extends Error {
+    code = 'E_MEDIA_UPLOAD_SESSION_STORE_NOT_CONFIGURED';
+    constructor(name) {
+        super(`Media config selects resumable session store "${name}" but no matching factory exists in \`uploads.resumable.stores\`. Add \`uploads.resumable.stores.${name}\` to config/media.ts (e.g. \`stores: { ${name}: uploadSessions.lucid() }\`), or omit \`store\` to use the in-memory session store.`);
+        this.name = 'UploadSessionStoreNotConfiguredError';
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,UAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,cAAc,QAAQ,mCAAmC,UAAU,GAAG,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,EAAU;QACpB,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,gCAAgC,CAAC;IACjD,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CAAC,eAAe,UAAU,oCAAoC,UAAU,GAAG,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,iCAAiC,CAAC;IAClD;QACE,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/src/extended_disk.d.ts

@@ -0,0 +1,10 @@
+import type { Disk, ExtendedDisk } from './types.js';
+/**
+ * Structural guard: does this disk implement the optional {@link ExtendedDisk} surface (copy/move,
+ * batched delete, list, size/stat, plus a capabilities descriptor)? The base {@link Disk} contract
+ * deliberately omits these, so callers detect the richer operations here at runtime (the bundled
+ * `disks.s3()` disk provides them; the in-memory/Drive disks do not) rather than depending on them
+ * statically. A disk qualifies when it exposes the whole surface.
+ */
+export declare function isExtendedDisk(disk: Disk): disk is Disk & ExtendedDisk;
+//# sourceMappingURL=extended_disk.d.ts.map

package/dist/src/extended_disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended_disk.d.ts","sourceRoot":"","sources":["../../src/extended_disk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,YAAY,CAYtE"}

package/dist/src/extended_disk.js

@@ -0,0 +1,19 @@
+/**
+ * Structural guard: does this disk implement the optional {@link ExtendedDisk} surface (copy/move,
+ * batched delete, list, size/stat, plus a capabilities descriptor)? The base {@link Disk} contract
+ * deliberately omits these, so callers detect the richer operations here at runtime (the bundled
+ * `disks.s3()` disk provides them; the in-memory/Drive disks do not) rather than depending on them
+ * statically. A disk qualifies when it exposes the whole surface.
+ */
+export function isExtendedDisk(disk) {
+    const d = disk;
+    return (typeof d.copy === 'function' &&
+        typeof d.move === 'function' &&
+        typeof d.deleteMany === 'function' &&
+        typeof d.list === 'function' &&
+        typeof d.size === 'function' &&
+        typeof d.stat === 'function' &&
+        typeof d.capabilities === 'object' &&
+        d.capabilities !== null);
+}
+//# sourceMappingURL=extended_disk.js.map

package/dist/src/extended_disk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended_disk.js","sourceRoot":"","sources":["../../src/extended_disk.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,MAAM,CAAC,GAAG,IAA6B,CAAC;IACxC,OAAO,CACL,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU;QAC5B,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU;QAC5B,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU;QAClC,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU;QAC5B,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU;QAC5B,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU;QAC5B,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;QAClC,CAAC,CAAC,YAAY,KAAK,IAAI,CACxB,CAAC;AACJ,CAAC"}