@venizia/ignis-helpers 0.2.0-8 → 0.2.0

package/dist/esm/modules/storage/base.d.ts.map

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

package/dist/esm/modules/storage/base.js

@@ -1,133 +1,121 @@
-import { MimeTypes } from '../../common/index.js';
-import { BaseHelper } from '../../modules/base.js';
-import { getError } from '../../modules/error/index.js';
-import isEmpty from 'lodash/isEmpty';
-import path from 'node:path';
+import { isEmpty } from '@venizia/ignis-inversion';
+import { ContentTypeTable, MimeTypes } from '../../common/index.js';
+import { BaseHelper } from '../base.js';
+import { getError } from '../error/index.js';
+import { executePromiseWithLimit } from '../../utilities/promise.utility.js';
+import { Readable } from 'node:stream';
+import { isNotFoundError, StorageConcurrency, StorageErrors } from './common/index.js';
 export class BaseStorageHelper extends BaseHelper {
-    static { this.MIME_MAP = {
-        '.png': 'image/png',
-        '.jpg': 'image/jpeg',
-        '.jpeg': 'image/jpeg',
-        '.gif': 'image/gif',
-        '.webp': 'image/webp',
-        '.svg': 'image/svg+xml',
-        '.pdf': 'application/pdf',
-        '.json': 'application/json',
-        '.txt': 'text/plain',
-        '.html': 'text/html',
-        '.css': 'text/css',
-        '.js': 'text/javascript',
-        '.mp4': 'video/mp4',
-        '.webm': 'video/webm',
-        '.mp3': 'audio/mpeg',
-        '.wav': 'audio/wav',
-        '.zip': 'application/zip',
-        '.csv': 'text/csv',
-        '.xml': 'application/xml',
-    }; }
     constructor(opts) {
         super(opts);
     }
-    getMimeType(filename) {
-        const ext = path.extname(filename).toLowerCase();
-        return BaseStorageHelper.MIME_MAP[ext] || 'application/octet-stream';
+    getMimeType(opts) {
+        return ContentTypeTable.resolve(opts);
     }
-    isValidName(name) {
+    /** One path segment or file name: no separator, no traversal, no control or shell character. */
+    isValidSegment(opts) {
+        const name = opts.segment;
         if (typeof name !== 'string') {
-            this.logger.for(this.isValidName.name).error('Invalid name provided: %j', name);
+            this.logger.for(this.isValidSegment.name).error('Invalid name provided: %j', name);
             return false;
         }
-        if (!name || isEmpty(name)) {
-            this.logger.for(this.isValidName.name).error('Empty name provided');
+        if (!name || isEmpty({ value: name })) {
+            this.logger.for(this.isValidSegment.name).error('Empty name provided');
             return false;
         }
-        // Prevent path traversal
         if (name.includes('..') || name.includes('/') || name.includes('\\')) {
             this.logger
-                .for(this.isValidName.name)
+                .for(this.isValidSegment.name)
                 .error('Name contains invalid path characters: %s', name);
             return false;
         }
-        // Prevent hidden files (starting with dot)
         if (name.startsWith('.')) {
-            this.logger.for(this.isValidName.name).error('Name cannot start with a dot: %s', name);
+            this.logger.for(this.isValidSegment.name).error('Name cannot start with a dot: %s', name);
             return false;
         }
-        // Prevent special shell characters
         const dangerousChars = /[;|&$`<>{}[\]!#]/;
         if (dangerousChars.test(name)) {
-            this.logger.for(this.isValidName.name).error('Name contains dangerous characters: %s', name);
+            this.logger
+                .for(this.isValidSegment.name)
+                .error('Name contains dangerous characters: %s', name);
             return false;
         }
-        // Prevent newlines/carriage returns (header injection)
         if (name.includes('\n') || name.includes('\r') || name.includes('\0')) {
             this.logger
-                .for(this.isValidName.name)
+                .for(this.isValidSegment.name)
                 .error('Name contains invalid control characters: %s', name);
             return false;
         }
-        // Prevent extremely long names (DoS)
         if (name.length > 255) {
             this.logger
-                .for(this.isValidName.name)
+                .for(this.isValidSegment.name)
                 .error('Name is too long (%d characters): %s', name.length, name);
             return false;
         }
-        // Prevent empty or whitespace-only names
         if (name.trim().length === 0) {
             this.logger
-                .for(this.isValidName.name)
+                .for(this.isValidSegment.name)
                 .error('Name cannot be empty or whitespace only: "%s"', name);
             return false;
         }
         return true;
     }
     static { this.DEFAULT_MAX_FOLDER_DEPTH = 2; }
-    isValidPath(pathStr, opts) {
-        const maxDepth = opts?.maxDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;
-        if (typeof pathStr !== 'string' || !pathStr || isEmpty(pathStr)) {
-            this.logger.for(this.isValidPath.name).error('Empty or invalid path provided');
+    /** A bucket name is one segment; a separator in it would silently address a different bucket. */
+    isValidBucketName(opts) {
+        return this.isValidSegment({ segment: opts.bucket.name });
+    }
+    /** A whole object key: every segment valid, and no deeper than `maxDepth` folders. */
+    isValidObjectKey(opts) {
+        return this.isValidKeyPath({ path: opts.object.key, maxDepth: opts.maxDepth });
+    }
+    /** The shared rule behind `isValidObjectKey` and the folder check inside `upload`. */
+    isValidKeyPath(opts) {
+        const { path: pathStr } = opts;
+        const maxDepth = opts.maxDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;
+        if (typeof pathStr !== 'string' || !pathStr || isEmpty({ value: pathStr })) {
+            this.logger.for(this.isValidKeyPath.name).error('Empty or invalid path provided');
             return false;
         }
-        // Trim leading/trailing slashes for normalization
         const normalized = pathStr.replace(/^\/+|\/+$/g, '');
         if (!normalized) {
-            this.logger.for(this.isValidPath.name).error('Path resolved to empty after trimming slashes');
+            this.logger
+                .for(this.isValidKeyPath.name)
+                .error('Path resolved to empty after trimming slashes');
             return false;
         }
         const segments = normalized.split('/');
-        // Reject empty segments (double slashes like "a//b")
         if (segments.some(s => s.length === 0)) {
             this.logger
-                .for(this.isValidPath.name)
+                .for(this.isValidKeyPath.name)
                 .error('Path contains empty segments (double slashes): %s', pathStr);
             return false;
         }
-        // Enforce max depth: segments include folders + filename, so depth = segments.length - 1
+        // segments include the filename, so depth is one less.
         const folderDepth = segments.length - 1;
         if (folderDepth > maxDepth) {
             this.logger
-                .for(this.isValidPath.name)
+                .for(this.isValidKeyPath.name)
                 .error('Path exceeds max folder depth (%d): %s (depth: %d)', maxDepth, pathStr, folderDepth);
             return false;
         }
         for (const segment of segments) {
-            if (!this.isValidName(segment)) {
+            if (!this.isValidSegment({ segment })) {
                 this.logger
-                    .for(this.isValidPath.name)
+                    .for(this.isValidKeyPath.name)
                     .error('Path segment failed validation: %s (in path: %s)', segment, pathStr);
                 return false;
             }
         }
         if (normalized.length > 1024) {
             this.logger
-                .for(this.isValidPath.name)
+                .for(this.isValidKeyPath.name)
                 .error('Path is too long (%d characters): %s', normalized.length, pathStr);
             return false;
         }
         return true;
     }
-    getFileType(opts) {
+    getMediaType(opts) {
         const { mimeType } = opts;
         if (mimeType?.toLowerCase()?.startsWith(MimeTypes.IMAGE)) {
             return MimeTypes.IMAGE;
@@ -141,7 +129,7 @@ export class BaseStorageHelper extends BaseHelper {
         return MimeTypes.UNKNOWN;
     }
     normalizeObjectName(opts) {
-        const { originalName, folderPath } = opts;
+        const { originalName, folderPath } = opts.file;
         const normalizedFileName = originalName.toLowerCase().replace(/ /g, '_');
         if (!folderPath) {
             return normalizedFileName;
@@ -149,8 +137,8 @@ export class BaseStorageHelper extends BaseHelper {
         return `${folderPath.toLowerCase().replace(/ /g, '_')}/${normalizedFileName}`;
     }
     normalizeObjectLink(opts) {
-        const { bucketName, normalizeName } = opts;
-        const encodedName = normalizeName
+        const bucketName = opts.bucket.name;
+        const encodedName = opts.object.key
             .split('/')
             .map(segment => encodeURIComponent(segment))
             .join('/');
@@ -165,10 +153,11 @@ export class BaseStorageHelper extends BaseHelper {
     validateUploadFile(opts) {
         const { file, maxFolderDepth } = opts;
         const { originalName, size, folderPath } = file;
-        if (!this.isValidName(originalName)) {
+        if (!this.isValidSegment({ segment: originalName })) {
             throw getError({ message: '[upload] Invalid original file name' });
         }
-        // Honours the CALLER's depth (not the hard default) so a deeper-tree app fails fast here rather than after spooling the whole body; isValidPath measures an OBJECT path (folder + filename, one folder more than a bare folderPath), so folderPath's depth is checked directly instead.
+        // Checked against the CALLER's depth, before the body is spooled. `isValidKeyPath` measures an
+        // object path (one folder deeper than a bare folderPath), so the depth is checked directly.
         if (folderPath) {
             const depthLimit = maxFolderDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;
             const folderSegments = folderPath.replace(/^\/+|\/+$/g, '').split('/');
@@ -177,11 +166,11 @@ export class BaseStorageHelper extends BaseHelper {
                     message: `[upload] Invalid folder path | depth: ${folderSegments.length} | max: ${depthLimit}`,
                 });
             }
-            if (!this.isValidPath(folderPath, { maxDepth: depthLimit })) {
+            if (!this.isValidKeyPath({ path: folderPath, maxDepth: depthLimit })) {
                 throw getError({ message: '[upload] Invalid folder path' });
             }
         }
-        // What is invalid is a missing or negative size, not a zero-byte upload - a bare `!size` also rejected a legitimate EMPTY file.
+        // Missing or negative is invalid; zero is a legitimate empty file.
         if (size === undefined || size === null || size < 0) {
             throw getError({ message: `[upload] Invalid file size | size: ${size}` });
         }
@@ -191,39 +180,161 @@ export class BaseStorageHelper extends BaseHelper {
         if (!files || files.length === 0) {
             return [];
         }
-        const isExists = await this.isBucketExists({ name: bucket });
+        const isExists = await this.hasBucket({ bucket });
         if (!isExists) {
             throw getError({
-                message: `[upload] Bucket does not exist | name: ${bucket}`,
+                message: `[upload] Bucket does not exist | name: ${bucket.name}`,
             });
         }
         this.validateUploadFiles({ files, maxFolderDepth });
-        const uploadPromises = files.map(async (file) => {
-            const { originalName, mimetype: mimeType, size, encoding, folderPath } = file;
-            const t = performance.now();
-            const normalizeName = normalizeNameFn
-                ? normalizeNameFn({ originalName, folderPath })
-                : this.normalizeObjectName({ originalName, folderPath });
-            // The caller's normalizeNameFn output is what DiskHelper path.join()s under the bucket root - an unvalidated `../../../etc/cron.d/pwn` writes outside it; the original name was validated above, this validates what actually reaches the filesystem.
-            if (!this.isValidPath(normalizeName, { maxDepth: maxFolderDepth })) {
-                throw getError({
-                    message: `[upload] Invalid normalized object name | name: ${normalizeName}`,
-                });
-            }
-            const normalizeLink = normalizeLinkFn
-                ? normalizeLinkFn({ bucketName: bucket, normalizeName })
-                : this.normalizeObjectLink({ bucketName: bucket, normalizeName });
-            await this.writeObject({ bucket, normalizeName, file });
-            this.logger
-                .for(this.upload.name)
-                .info('Uploaded: %j | Took: %s (ms)', { normalizeName, normalizeLink, mimeType, encoding, size }, performance.now() - t);
-            return {
-                bucketName: bucket,
-                objectName: normalizeName,
-                link: normalizeLink,
-            };
+        return this.mapWithConcurrency({
+            items: files,
+            task: async ({ item: file }) => {
+                const { originalName, mimetype: mimeType, size, encoding, folderPath } = file;
+                const t = performance.now();
+                const naming = { originalName, folderPath };
+                const key = normalizeNameFn
+                    ? normalizeNameFn({ file: naming })
+                    : this.normalizeObjectName({ file: naming });
+                // `normalizeNameFn` output is what reaches the filesystem; the original name was validated
+                // above, this validates what a caller's own normalizer produced.
+                if (!this.isValidObjectKey({ object: { key }, maxDepth: maxFolderDepth })) {
+                    throw getError({
+                        message: `[upload] Invalid normalized object name | name: ${key}`,
+                    });
+                }
+                const object = { key };
+                const link = normalizeLinkFn
+                    ? normalizeLinkFn({ bucket, object })
+                    : this.normalizeObjectLink({ bucket, object });
+                await this.writeObject({ bucket, object, file });
+                this.logger
+                    .for(this.upload.name)
+                    .info('Uploaded: %j | Took: %s (ms)', { key, link, mimeType, encoding, size }, performance.now() - t);
+                return {
+                    bucket: { name: bucket.name },
+                    object: { key, size, contentType: mimeType },
+                    link,
+                };
+            },
+        });
+    }
+    /** Correct anywhere; overridden by a backend whose transport is already a web stream. */
+    async getObjectStream(opts) {
+        const { bucket, object, range } = opts;
+        const source = await this.getObject({ bucket, object });
+        if (!range) {
+            return Readable.toWeb(source);
+        }
+        // No native range here: take the window off the front of the full stream. `pull` rather than
+        // `start`, so one chunk is read per demand instead of the whole range landing in memory.
+        const { start, end } = range;
+        const chunks = source[Symbol.asyncIterator]();
+        let offset = 0;
+        return new ReadableStream({
+            async pull(controller) {
+                while (true) {
+                    const next = await chunks.next();
+                    if (next.done) {
+                        controller.close();
+                        return;
+                    }
+                    const bytes = next.value;
+                    const chunkEnd = offset + bytes.byteLength;
+                    const from = Math.max(start - offset, 0);
+                    const to = end === undefined ? bytes.byteLength : Math.min(end + 1 - offset, bytes.byteLength);
+                    const isWanted = chunkEnd > start && from < to;
+                    if (isWanted) {
+                        controller.enqueue(bytes.subarray(from, to));
+                    }
+                    offset = chunkEnd;
+                    if (end !== undefined && offset > end) {
+                        source.destroy();
+                        controller.close();
+                        return;
+                    }
+                    if (isWanted) {
+                        return;
+                    }
+                }
+            },
+            // Without this a client that aborts leaves the backend stream draining to nowhere.
+            cancel() {
+                source.destroy();
+            },
+        });
+    }
+    /**
+     * Correct anywhere, and the wrong path to stay on: it buffers, so a backend whose transport takes
+     * a stream overrides it. `BunS3Helper` does.
+     */
+    async writeStream(opts) {
+        const { bucket, object, source, contentType } = opts;
+        const body = source instanceof Response || source instanceof Request ? source : new Response(source);
+        const buffer = Buffer.from(await body.arrayBuffer());
+        await this.writeObject({
+            bucket,
+            object,
+            file: {
+                originalName: object.key,
+                mimetype: contentType ?? this.getMimeType({ filename: object.key }),
+                buffer,
+                size: buffer.length,
+            },
+        });
+    }
+    /** Bounded fan-out on the shared limiter; unbounded exhausts sockets and gets rate limited. */
+    async mapWithConcurrency(opts) {
+        const { items, task } = opts;
+        if (items.length === 0) {
+            return [];
+        }
+        return executePromiseWithLimit({
+            limit: Math.max(1, opts.limit ?? StorageConcurrency.DEFAULT_LIMIT),
+            tasks: items.map((item, index) => () => task({ item, index })),
+        });
+    }
+    /** A "not there" failure becomes a catalogued 404; every other failure passes through unchanged. */
+    asStorageError(opts) {
+        const { error, operation, bucket, object } = opts;
+        if (!isNotFoundError({ error })) {
+            return error;
+        }
+        return getError({
+            error: StorageErrors.OBJECT_NOT_FOUND,
+            message: `[${operation}] Object not found | bucket: ${bucket.name} | key: ${object.key}`,
+        });
+    }
+    // No transport for these: throwing beats returning undefined, which reads as a valid empty result.
+    async copyObject(_opts) {
+        throw getError({
+            message: `[${this.constructor.name}.copyObject] Server-side copy is not supported by this helper`,
+        });
+    }
+    async presignPost(_opts) {
+        throw getError({
+            message: `[${this.constructor.name}.presignPost] Signed POST policies are not supported by this helper`,
+        });
+    }
+    async presignPut(_opts) {
+        throw getError({
+            message: `[${this.constructor.name}.presignPut] Presigned PUT URLs are not supported by this helper`,
+        });
+    }
+    async presignGet(_opts) {
+        throw getError({
+            message: `[${this.constructor.name}.presignGet] Presigned GET URLs are not supported by this helper`,
+        });
+    }
+    async getObjectTags(_opts) {
+        throw getError({
+            message: `[${this.constructor.name}.getObjectTags] Object tagging is not supported by this helper`,
+        });
+    }
+    async replaceObjectTags(_opts) {
+        throw getError({
+            message: `[${this.constructor.name}.replaceObjectTags] Object tagging is not supported by this helper`,
         });
-        return Promise.all(uploadPromises);
     }
 }
 //# sourceMappingURL=base.js.map

package/dist/esm/modules/storage/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/modules/storage/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/modules/storage/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAevC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9E,MAAM,OAAgB,iBAAkB,SAAQ,UAAU;IACxD,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAA0B;QACpC,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,gGAAgG;IAChG,cAAc,CAAC,IAAyB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;QAE1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;YACnF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,2CAA2C,EAAE,IAAI,CAAC,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC;YAC1F,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,kBAAkB,CAAC;QAC1C,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,wCAAwC,EAAE,IAAI,CAAC,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,8CAA8C,EAAE,IAAI,CAAC,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,sCAAsC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,+CAA+C,EAAE,IAAI,CAAC,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;aAEe,6BAAwB,GAAG,CAAC,CAAC;IAE7C,iGAAiG;IACjG,iBAAiB,CAAC,IAA4B;QAC5C,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,sFAAsF;IACtF,gBAAgB,CAAC,IAA+C;QAC9D,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,sFAAsF;IAC5E,cAAc,CAAC,IAAyC;QAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC,wBAAwB,CAAC;QAE7E,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAClF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,mDAAmD,EAAE,OAAO,CAAC,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uDAAuD;QACvD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,IAAI,WAAW,GAAG,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,oDAAoD,EACpD,QAAQ,EACR,OAAO,EACP,WAAW,CACZ,CAAC;YACJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;qBAC7B,KAAK,CAAC,kDAAkD,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC/E,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,sCAAsC,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,IAA0B;QACrC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC1B,IAAI,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC;QAED,OAAO,SAAS,CAAC,OAAO,CAAC;IAC3B,CAAC;IAQS,mBAAmB,CAAC,IAA6B;QACzD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/C,MAAM,kBAAkB,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAEzE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,kBAAkB,EAAE,CAAC;IAChF,CAAC;IAES,mBAAmB,CAAC,IAAqB;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG;aAChC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;aAC3C,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,OAAO,GAAG,IAAI,CAAC,iBAAiB,GAAG,UAAU,IAAI,WAAW,EAAE,CAAC;IACjE,CAAC;IAES,mBAAmB,CAAC,IAAuD;QACnF,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,IAAoD;QAC7E,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QACtC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEhD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;YACpD,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,+FAA+F;QAC/F,4FAA4F;QAC5F,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,cAAc,IAAI,iBAAiB,CAAC,wBAAwB,CAAC;YAChF,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEvE,IAAI,cAAc,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBACvC,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,yCAAyC,cAAc,CAAC,MAAM,WAAW,UAAU,EAAE;iBAC/F,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;gBACrE,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,sCAAsC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAOZ;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAEjF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,0CAA0C,MAAM,CAAC,IAAI,EAAE;aACjE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAEpD,OAAO,IAAI,CAAC,kBAAkB,CAAC;YAC7B,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC7B,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;gBAC9E,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBAE5B,MAAM,MAAM,GAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;gBAC3D,MAAM,GAAG,GAAG,eAAe;oBACzB,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBACnC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBAE/C,2FAA2F;gBAC3F,iEAAiE;gBACjE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;oBAC1E,MAAM,QAAQ,CAAC;wBACb,OAAO,EAAE,mDAAmD,GAAG,EAAE;qBAClE,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,MAAM,GAAe,EAAE,GAAG,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,eAAe;oBAC1B,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;oBACrC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAEjD,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAEjD,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;qBACrB,IAAI,CACH,8BAA8B,EAC9B,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EACvC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CACtB,CAAC;gBAEJ,OAAO;oBACL,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;oBAC7B,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;oBAC5C,IAAI;iBACL,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,eAAe,CACnB,IAAmE;QAEnE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAA+B,CAAC;QAC9D,CAAC;QAED,6FAA6F;QAC7F,yFAAyF;QACzF,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,OAAO,IAAI,cAAc,CAAa;YACpC,KAAK,CAAC,IAAI,CAAC,UAAU;gBACnB,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;oBAEjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBACd,UAAU,CAAC,KAAK,EAAE,CAAC;wBACnB,OAAO;oBACT,CAAC;oBAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAmB,CAAC;oBACvC,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;oBAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;oBACzC,MAAM,EAAE,GACN,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;oBACtF,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,IAAI,IAAI,GAAG,EAAE,CAAC;oBAE/C,IAAI,QAAQ,EAAE,CAAC;wBACb,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBAC/C,CAAC;oBAED,MAAM,GAAG,QAAQ,CAAC;oBAElB,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;wBACtC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,UAAU,CAAC,KAAK,EAAE,CAAC;wBACnB,OAAO;oBACT,CAAC;oBAED,IAAI,QAAQ,EAAE,CAAC;wBACb,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mFAAmF;YACnF,MAAM;gBACJ,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,IAIC;QAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QACrD,MAAM,IAAI,GACR,MAAM,YAAY,QAAQ,IAAI,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,CAAC,WAAW,CAAC;YACrB,MAAM;YACN,MAAM;YACN,IAAI,EAAE;gBACJ,YAAY,EAAE,MAAM,CAAC,GAAG;gBACxB,QAAQ,EAAE,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;gBACnE,MAAM;gBACN,IAAI,EAAE,MAAM,CAAC,MAAM;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IAED,+FAA+F;IACrF,KAAK,CAAC,kBAAkB,CAAe,IAIhD;QACC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,uBAAuB,CAAC;YAC7B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,kBAAkB,CAAC,aAAa,CAAC;YAClE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,oGAAoG;IAC1F,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAElD,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,QAAQ,CAAC;YACd,KAAK,EAAE,aAAa,CAAC,gBAAgB;YACrC,OAAO,EAAE,IAAI,SAAS,gCAAgC,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,GAAG,EAAE;SACzF,CAAC,CAAC;IACL,CAAC;IAED,mGAAmG;IACnG,KAAK,CAAC,UAAU,CAAC,KAIhB;QACC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,+DAA+D;SAClG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAMjB;QACC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,qEAAqE;SACxG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAKC;QAED,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,kEAAkE;SACrG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAgF;QAEhF,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,kEAAkE;SACrG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAsB;QACxC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,gEAAgE;SACnG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,KAAyD;QAEzD,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,oEAAoE;SACvG,CAAC,CAAC;IACL,CAAC"}

package/dist/esm/modules/storage/bun-s3/helper.d.ts

@@ -1,58 +1,103 @@
+import type { IDuration } from '../../../common/index.js';
 import { Readable } from 'node:stream';
 import { BaseStorageHelper } from '../base.js';
-import type { IBucketInfo, IFileStat, IObjectInfo, IStorageHelperOptions, IUploadFile } from '../types.js';
+import type { IBucketInfo, IBucketRef, IFileStat, IListObjectsOptions, IObjectInfo, IObjectLocation, IObjectRef, IPostPolicy, IStorageHelperOptions, IUploadFile } from '../common/index.js';
 export interface IBunS3HelperOptions extends IStorageHelperOptions {
     accessKey: string;
     secretKey: string;
-    endpoint: string;
     region?: string;
     sessionToken?: string;
+    /** `default` is the host THIS process talks to; `public` is the host a browser is handed. `host` is inside every SigV4 signature, so a URL signed against an internal name cannot be rewritten later - which is why the two are separate rather than one value patched afterwards. */
+    endpoint: {
+        default: string;
+        public?: string;
+    };
+    /** `https://<bucket>.<endpoint>/<key>` instead of `<endpoint>/<bucket>/<key>`. AWS requires it; MinIO and R2 do not. */
+    virtualHostedStyle?: boolean;
+    partSize?: number;
+    queueSize?: number;
+    /** Retries Bun performs on a failed part before the write fails. */
+    retry?: number;
 }
 export declare class BunS3Helper extends BaseStorageHelper {
     private client;
     private credentials;
+    /** Undefined leaves Bun's own defaults in force. */
+    private transfer;
     constructor(options: IBunS3HelperOptions);
-    isBucketExists(opts: {
-        name: string;
+    /** One bucket's objects, in either addressing style. `audience` picks the host: `server` for a call this process makes, `browser` for a URL it hands out. Virtual-hosted derives the per-bucket host, because the bucket arrives per call. */
+    private objectEndpoint;
+    /** Per-call overrides, so one client serves every bucket in either addressing style. */
+    private presignOptions;
+    hasBucket(opts: {
+        bucket: IBucketRef;
     }): Promise<boolean>;
     getBuckets(): Promise<IBucketInfo[]>;
+    /** S3 exposes a creation date only through `ListBuckets`, so one full listing is the cheapest correct answer. */
     getBucket(opts: {
-        name: string;
+        bucket: IBucketRef;
     }): Promise<IBucketInfo | null>;
     createBucket(opts: {
-        name: string;
+        bucket: IBucketRef;
     }): Promise<IBucketInfo | null>;
     removeBucket(opts: {
-        name: string;
+        bucket: IBucketRef;
     }): Promise<boolean>;
+    copyObject(opts: {
+        bucket: IBucketRef;
+        source: IObjectRef;
+        destination: IObjectRef;
+    }): Promise<void>;
+    presignPost(opts: {
+        bucket: IBucketRef;
+        keyPrefix: string;
+        maxBytes: number;
+        contentType?: string;
+        expiresIn?: IDuration;
+    }): Promise<IPostPolicy>;
+    presignPut(opts: IObjectLocation & {
+        expiresIn?: IDuration;
+        tagging?: Record<string, string>;
+        contentLength?: number;
+        contentType?: string;
+    }): Promise<string>;
+    presignGet(opts: IObjectLocation & {
+        expiresIn?: IDuration;
+        responseContentType?: string;
+        responseContentDisposition?: string;
+    }): Promise<string>;
+    getObjectTags(opts: IObjectLocation): Promise<Record<string, string>>;
+    replaceObjectTags(opts: IObjectLocation & {
+        tags: Record<string, string>;
+    }): Promise<void>;
     protected get defaultLinkPrefix(): string;
-    protected writeObject(opts: {
-        bucket: string;
-        normalizeName: string;
+    protected writeObject(opts: IObjectLocation & {
         file: IUploadFile;
     }): Promise<void>;
-    getFile(opts: {
-        bucket: string;
-        name: string;
+    /** Streams without holding the object in memory. `upload` carries a `Buffer`, so it cannot; this is the path for anything large. */
+    writeStream(opts: IObjectLocation & {
+        source: ReadableStream<Uint8Array> | Blob | Response | Request;
+        contentType?: string;
+        maxFolderDepth?: number;
+    }): Promise<void>;
+    /** `S3File.stream()` is lazy: it reaches the network on first read, so a `try` here never sees a 404 - the failure arrives on the stream. */
+    getObject(opts: IObjectLocation & {
         options?: any;
     }): Promise<Readable>;
-    getStat(opts: {
-        bucket: string;
-        name: string;
-    }): Promise<IFileStat>;
-    removeObject(opts: {
-        bucket: string;
-        name: string;
-    }): Promise<void>;
+    /** The conversion-free path a `Response` body wants. `slice` makes it a ranged GET, so only the requested bytes leave S3. */
+    getObjectStream(opts: IObjectLocation & {
+        range?: {
+            start: number;
+            end?: number;
+        };
+    }): Promise<ReadableStream<Uint8Array>>;
+    getStat(opts: IObjectLocation): Promise<IFileStat>;
+    removeObject(opts: IObjectLocation): Promise<void>;
     removeObjects(opts: {
-        bucket: string;
-        names: string[];
+        bucket: IBucketRef;
+        objects: IObjectRef[];
     }): Promise<void>;
-    listObjects(opts: {
-        bucket: string;
-        prefix?: string;
-        useRecursive?: boolean;
-        maxKeys?: number;
-    }): Promise<IObjectInfo[]>;
+    /** S3 caps a call at 1000 keys and continues through `nextContinuationToken`. `useRecursive: false` maps to `delimiter: '/'`. */
+    listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;
 }
 //# sourceMappingURL=helper.d.ts.map