express-storage 2.0.2 → 3.0.0

package/dist/esm/drivers/local.driver.js

@@ -0,0 +1,549 @@
+import fs from 'fs';
+import fsPromises from 'fs/promises';
+import path from 'path';
+import { BaseStorageDriver } from './base.driver.js';
+import { createMonthBasedPath, ensureDirectoryExists } from '../utils/file.utils.js';
+/**
+ * Magic byte signatures for common file types.
+ * Used to detect actual file content type regardless of extension.
+ * This provides security against extension spoofing attacks.
+ */
+const MAGIC_BYTES = [
+    // Images
+    { bytes: [0xFF, 0xD8, 0xFF], mimeType: 'image/jpeg' },
+    { bytes: [0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A], mimeType: 'image/png' },
+    { bytes: [0x47, 0x49, 0x46, 0x38, 0x37, 0x61], mimeType: 'image/gif' },
+    { bytes: [0x47, 0x49, 0x46, 0x38, 0x39, 0x61], mimeType: 'image/gif' },
+    { bytes: [0x42, 0x4D], mimeType: 'image/bmp' },
+    // Documents
+    { bytes: [0x25, 0x50, 0x44, 0x46], mimeType: 'application/pdf' },
+    { bytes: [0x50, 0x4B, 0x03, 0x04], mimeType: 'application/zip' },
+    { bytes: [0x50, 0x4B, 0x05, 0x06], mimeType: 'application/zip' },
+    { bytes: [0x50, 0x4B, 0x07, 0x08], mimeType: 'application/zip' },
+    // Archives
+    { bytes: [0x1F, 0x8B], mimeType: 'application/gzip' },
+    { bytes: [0x52, 0x61, 0x72, 0x21, 0x1A, 0x07], mimeType: 'application/vnd.rar' },
+    { bytes: [0x37, 0x7A, 0xBC, 0xAF, 0x27, 0x1C], mimeType: 'application/x-7z-compressed' },
+    // Audio/Video
+    { bytes: [0x49, 0x44, 0x33], mimeType: 'audio/mpeg' },
+    { bytes: [0xFF, 0xFB], mimeType: 'audio/mpeg' },
+    { bytes: [0xFF, 0xFA], mimeType: 'audio/mpeg' },
+    { bytes: [0x4F, 0x67, 0x67, 0x53], mimeType: 'audio/ogg' },
+    { bytes: [0x66, 0x74, 0x79, 0x70], mimeType: 'video/mp4', offset: 4 },
+    // Executables (for security detection)
+    { bytes: [0x4D, 0x5A], mimeType: 'application/x-msdownload' },
+    { bytes: [0x7F, 0x45, 0x4C, 0x46], mimeType: 'application/x-executable' },
+];
+/**
+ * Detects MIME type from file content using magic bytes.
+ * Returns undefined if no match is found (falls back to extension-based detection).
+ */
+async function detectMimeTypeFromMagicBytes(filePath) {
+    try {
+        const fd = await fsPromises.open(filePath, 'r');
+        const buffer = Buffer.alloc(16);
+        const { bytesRead } = await fd.read(buffer, 0, 16, 0);
+        await fd.close();
+        if (bytesRead === 0) {
+            return undefined;
+        }
+        for (const signature of MAGIC_BYTES) {
+            const offset = signature.offset || 0;
+            if (offset + signature.bytes.length > bytesRead) {
+                continue;
+            }
+            let matches = true;
+            for (let i = 0; i < signature.bytes.length; i++) {
+                if (buffer[offset + i] !== signature.bytes[i]) {
+                    matches = false;
+                    break;
+                }
+            }
+            if (matches) {
+                return signature.mimeType;
+            }
+        }
+        // RIFF container: bytes 0-3 = 'RIFF', bytes 8-11 = sub-format identifier
+        if (bytesRead >= 12 &&
+            buffer[0] === 0x52 && buffer[1] === 0x49 &&
+            buffer[2] === 0x46 && buffer[3] === 0x46) {
+            const subFormat = buffer.subarray(8, 12).toString('ascii');
+            switch (subFormat) {
+                case 'WEBP': return 'image/webp';
+                case 'WAVE': return 'audio/wav';
+                case 'AVI ': return 'video/x-msvideo';
+            }
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Detects content type using magic bytes first, then extension as fallback.
+ */
+async function detectContentType(filePath, reference) {
+    const magicMime = await detectMimeTypeFromMagicBytes(filePath);
+    if (magicMime)
+        return magicMime;
+    const ext = path.extname(reference).toLowerCase();
+    return ext && EXTENSION_MIME_MAP[ext] ? EXTENSION_MIME_MAP[ext] : undefined;
+}
+/**
+ * Maps file extensions to MIME types.
+ * Used as fallback when magic byte detection doesn't match.
+ */
+const EXTENSION_MIME_MAP = {
+    // Images
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.bmp': 'image/bmp',
+    '.tiff': 'image/tiff',
+    '.tif': 'image/tiff',
+    // Documents
+    '.pdf': 'application/pdf',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.txt': 'text/plain',
+    '.csv': 'text/csv',
+    '.json': 'application/json',
+    '.xml': 'application/xml',
+    // Audio
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.ogg': 'audio/ogg',
+    '.m4a': 'audio/mp4',
+    // Video
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.avi': 'video/x-msvideo',
+    '.mov': 'video/quicktime',
+    '.mkv': 'video/x-matroska',
+    // Archives
+    '.zip': 'application/zip',
+    '.tar': 'application/x-tar',
+    '.gz': 'application/gzip',
+    '.rar': 'application/vnd.rar',
+    '.7z': 'application/x-7z-compressed',
+    // Web
+    '.html': 'text/html',
+    '.htm': 'text/html',
+    '.css': 'text/css',
+    '.js': 'application/javascript',
+    '.ts': 'application/typescript',
+    // Fonts
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+};
+// ---------------------------------------------------------------------------
+// listFiles helpers — extracted for testability and clarity
+// ---------------------------------------------------------------------------
+const MAX_RECURSION_DEPTH = 100;
+const MAX_ENTRIES_SCANNED = 50_000;
+function couldContainPrefix(dirRelativePath, targetPrefix) {
+    if (!targetPrefix)
+        return true;
+    return targetPrefix.startsWith(dirRelativePath) ||
+        dirRelativePath.startsWith(targetPrefix) ||
+        dirRelativePath === '';
+}
+function isAfterToken(filePath, token) {
+    if (!token)
+        return true;
+    return filePath.localeCompare(token) > 0;
+}
+async function buildFileInfo(absolutePath, relativePath) {
+    try {
+        const stat = await fsPromises.stat(absolutePath);
+        const ext = path.extname(relativePath).toLowerCase();
+        return {
+            name: relativePath,
+            size: stat.size,
+            lastModified: stat.mtime,
+            contentType: (ext && EXTENSION_MIME_MAP[ext]) ? EXTENSION_MIME_MAP[ext] : 'application/octet-stream',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function walkDirectory(baseDir, options) {
+    const files = [];
+    let hasMore = false;
+    let entriesScanned = 0;
+    const walk = async (dir, dirRelativePath, depth) => {
+        if (depth > MAX_RECURSION_DEPTH || files.length >= options.maxCollect || entriesScanned >= MAX_ENTRIES_SCANNED) {
+            if (files.length >= options.maxCollect || entriesScanned >= MAX_ENTRIES_SCANNED)
+                hasMore = true;
+            return files.length < options.maxCollect && entriesScanned < MAX_ENTRIES_SCANNED;
+        }
+        if (options.prefix && !couldContainPrefix(dirRelativePath, options.prefix)) {
+            return true;
+        }
+        let entries;
+        try {
+            entries = await fsPromises.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return true;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            entriesScanned++;
+            if (files.length >= options.maxCollect || entriesScanned >= MAX_ENTRIES_SCANNED) {
+                hasMore = true;
+                return false;
+            }
+            if (entry.isSymbolicLink())
+                continue;
+            const itemPath = path.join(dir, entry.name);
+            const relativePath = dirRelativePath ? `${dirRelativePath}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                if (options.continuationToken && !couldContainPrefix(relativePath, options.continuationToken.split('/')[0] || '')) {
+                    if (relativePath.localeCompare(options.continuationToken) < 0 && !options.continuationToken.startsWith(relativePath + '/')) {
+                        continue;
+                    }
+                }
+                if (!await walk(itemPath, relativePath, depth + 1))
+                    return false;
+            }
+            else if (entry.isFile()) {
+                if (options.prefix && !relativePath.startsWith(options.prefix))
+                    continue;
+                if (!isAfterToken(relativePath, options.continuationToken))
+                    continue;
+                const info = await buildFileInfo(itemPath, relativePath);
+                if (info)
+                    files.push(info);
+            }
+        }
+        return true;
+    };
+    await walk(baseDir, '', 0);
+    return { files, hasMore };
+}
+function paginateFiles(files, maxResults, hasMore) {
+    files.sort((a, b) => a.name.localeCompare(b.name));
+    const page = files.slice(0, maxResults);
+    const result = { success: true, files: page };
+    if (files.length > maxResults || hasMore) {
+        const lastFile = page[page.length - 1];
+        if (lastFile)
+            result.nextToken = lastFile.name;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// LocalStorageDriver
+// ---------------------------------------------------------------------------
+/**
+ * LocalStorageDriver - Saves files to your local filesystem.
+ *
+ * Great for development and small-scale applications.
+ * Files are organized by year/month folders automatically.
+ *
+ * **Security features:**
+ * - Path traversal prevention (blocks ../ and null bytes)
+ * - Symlinks are NOT followed or deleted (prevents directory escape attacks)
+ * - Magic byte detection for content-type validation (prevents extension spoofing)
+ * - Files stay within the configured base directory
+ *
+ * Note: Local storage doesn't support presigned URLs since
+ * there's no external service to sign requests against.
+ */
+export class LocalStorageDriver extends BaseStorageDriver {
+    basePath;
+    originalLocalPath;
+    constructor(config) {
+        super(config);
+        this.originalLocalPath = config.localPath || 'public/express-storage';
+        this.basePath = path.resolve(this.originalLocalPath);
+    }
+    /**
+     * Saves a file to the local filesystem.
+     *
+     * Files are automatically organized into YYYY/MM folders.
+     * For large files (>100MB), uses streaming to reduce memory usage.
+     */
+    async upload(file, options) {
+        try {
+            const { errors: validationErrors, resolvedSize } = await this.validateFile(file);
+            if (validationErrors.length > 0) {
+                return this.createErrorResult(validationErrors.join(', '), 'VALIDATION_FAILED');
+            }
+            const fileName = this.generateFileName(file.originalname);
+            const monthPath = createMonthBasedPath(this.basePath);
+            const fullDirPath = path.resolve(monthPath);
+            await ensureDirectoryExists(fullDirPath);
+            const filePath = path.join(fullDirPath, fileName);
+            options?.signal?.throwIfAborted();
+            if (this.shouldUseStreaming(resolvedSize)) {
+                await this.uploadWithStream(file, filePath);
+            }
+            else {
+                const fileContent = await this.getFileContent(file);
+                await fsPromises.writeFile(filePath, fileContent);
+            }
+            if (options?.metadata && Object.keys(options.metadata).length > 0) {
+                const meta = { metadata: options.metadata };
+                if (options.contentType)
+                    meta['contentType'] = options.contentType;
+                if (options.cacheControl)
+                    meta['cacheControl'] = options.cacheControl;
+                if (options.contentDisposition)
+                    meta['contentDisposition'] = options.contentDisposition;
+                const metaPath = filePath + '.meta.json';
+                await fsPromises.writeFile(metaPath, JSON.stringify(meta));
+            }
+            const fileUrl = this.generateFileUrl(filePath);
+            const relativePath = this.normalizePathSeparators(path.relative(this.basePath, path.resolve(filePath)));
+            return this.createSuccessResult(relativePath, fileUrl);
+        }
+        catch (error) {
+            await this.cleanupTempFile(file);
+            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to upload file');
+        }
+    }
+    /**
+     * Uploads a large file using streaming.
+     * Pipes the file stream directly to disk for memory efficiency.
+     */
+    async uploadWithStream(file, filePath) {
+        return new Promise((resolve, reject) => {
+            const readStream = this.getFileStream(file);
+            const writeStream = fs.createWriteStream(filePath);
+            readStream
+                .pipe(writeStream)
+                .on('finish', resolve)
+                .on('error', (err) => {
+                void fsPromises.unlink(filePath).catch(() => { });
+                reject(err);
+            });
+            readStream.on('error', (err) => {
+                writeStream.destroy();
+                void fsPromises.unlink(filePath).catch(() => { });
+                reject(err);
+            });
+        });
+    }
+    /**
+     * Builds a URL for accessing the file.
+     *
+     * If basePath starts with 'public/', strips that prefix since
+     * Express.static('public') serves files from /
+     */
+    generateFileUrl(filePath) {
+        const absoluteFilePath = path.resolve(filePath);
+        const relativeFromBase = this.normalizePathSeparators(path.relative(this.basePath, absoluteFilePath));
+        const normalizedLocalPath = this.normalizePathSeparators(this.originalLocalPath);
+        if (normalizedLocalPath.startsWith('public/')) {
+            const webBasePath = normalizedLocalPath.replace(/^public\//, '');
+            return this.normalizeUrl(`/${webBasePath}/${relativeFromBase}`);
+        }
+        return this.normalizeUrl(`/${normalizedLocalPath}/${relativeFromBase}`);
+    }
+    normalizePathSeparators(pathStr) {
+        return pathStr.replace(/\\/g, '/');
+    }
+    normalizeUrl(url) {
+        return url.replace(/\/+/g, '/');
+    }
+    /**
+     * Local storage doesn't support presigned upload URLs.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async generateUploadUrl(_fileName, _contentType, _maxSize) {
+        return this.createPresignedErrorResult('Presigned URLs are not supported for local storage', 'PRESIGNED_NOT_SUPPORTED');
+    }
+    /**
+     * Local storage doesn't support presigned view URLs.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async generateViewUrl(_fileName) {
+        return this.createPresignedErrorResult('Presigned URLs are not supported for local storage', 'PRESIGNED_NOT_SUPPORTED');
+    }
+    /**
+     * Validates a local file exists and matches expected values.
+     *
+     * Content type detection uses a two-tier approach:
+     * 1. Magic byte detection (examines actual file content for security)
+     * 2. Extension-based fallback (when magic bytes don't match)
+     */
+    async validateAndConfirmUpload(reference, options) {
+        try {
+            const filePath = await this.resolveFilePath(reference);
+            if (!filePath) {
+                return { success: false, error: 'File not found', code: 'FILE_NOT_FOUND' };
+            }
+            const stats = await fsPromises.stat(filePath);
+            const actual = {
+                contentType: await detectContentType(filePath, reference),
+                fileSize: stats.size,
+            };
+            const validationError = await this.checkUploadedFileMetadata(reference, actual, options);
+            if (validationError)
+                return validationError;
+            const result = {
+                success: true,
+                reference,
+                viewUrl: this.generateFileUrl(filePath),
+                actualFileSize: actual.fileSize,
+            };
+            if (actual.contentType)
+                result.actualContentType = actual.contentType;
+            return result;
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to validate upload',
+                code: 'PROVIDER_ERROR',
+            };
+        }
+    }
+    /**
+     * Deletes a file from local storage.
+     *
+     * Security: decodeFileName() rejects traversal/encoding attacks.
+     * Containment check ensures resolved path stays within basePath.
+     * Symlinks and non-files are rejected.
+     */
+    async delete(reference) {
+        try {
+            const decoded = this.decodeFileName(reference);
+            const baseDir = this.basePath;
+            const resolvedPath = path.resolve(path.join(baseDir, decoded));
+            if (!resolvedPath.startsWith(baseDir + path.sep) && resolvedPath !== baseDir) {
+                return { success: false, reference, error: 'Invalid reference: path is outside storage directory', code: 'PATH_TRAVERSAL' };
+            }
+            let stat;
+            try {
+                stat = await fsPromises.lstat(resolvedPath);
+            }
+            catch {
+                return { success: false, reference, error: 'File not found', code: 'FILE_NOT_FOUND' };
+            }
+            if (stat.isSymbolicLink()) {
+                return { success: false, reference, error: 'Symbolic links cannot be deleted', code: 'VALIDATION_FAILED' };
+            }
+            if (!stat.isFile()) {
+                return { success: false, reference, error: 'Path is not a regular file', code: 'VALIDATION_FAILED' };
+            }
+            await fsPromises.unlink(resolvedPath);
+            return { success: true, reference };
+        }
+        catch (error) {
+            return { success: false, reference, error: error instanceof Error ? error.message : 'Failed to delete file', code: 'PROVIDER_ERROR' };
+        }
+    }
+    /**
+     * Resolves a decoded reference to a verified file path within basePath.
+     * Checks containment (path stays inside basePath), rejects symlinks,
+     * and verifies the target is a regular file.
+     *
+     * Callers are responsible for decoding/validating the reference first
+     * (via decodeFileName or StorageManager's hasPathTraversal check).
+     */
+    async resolveFilePath(reference) {
+        const baseDir = this.basePath;
+        let decoded;
+        try {
+            decoded = this.decodeFileName(reference);
+        }
+        catch {
+            return null;
+        }
+        const directPath = path.join(baseDir, decoded);
+        const resolvedPath = path.resolve(directPath);
+        if (!resolvedPath.startsWith(baseDir + path.sep) && resolvedPath !== baseDir) {
+            return null;
+        }
+        try {
+            const stat = await fsPromises.lstat(directPath);
+            if (stat.isSymbolicLink() || !stat.isFile())
+                return null;
+            return directPath;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Returns metadata about a file without downloading it.
+     * Uses magic byte detection for accurate content type identification.
+     */
+    async getMetadata(reference) {
+        const filePath = await this.resolveFilePath(reference);
+        if (!filePath)
+            return null;
+        try {
+            const stats = await fsPromises.stat(filePath);
+            const contentType = await detectContentType(filePath, reference);
+            const info = {
+                name: reference,
+                size: stats.size,
+                lastModified: stats.mtime,
+            };
+            if (contentType) {
+                info.contentType = contentType;
+            }
+            return info;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Lists files in local storage with optional prefix filtering and pagination.
+     */
+    async listFiles(prefix, maxResults = 1000, continuationToken) {
+        try {
+            let decodedPrefix;
+            if (prefix) {
+                try {
+                    decodedPrefix = decodeURIComponent(prefix);
+                }
+                catch {
+                    return { success: false, error: 'Invalid prefix: malformed URL encoding', code: 'INVALID_INPUT' };
+                }
+            }
+            if (decodedPrefix && (decodedPrefix.includes('..') || decodedPrefix.includes('\0'))) {
+                return { success: false, error: 'Invalid prefix: path traversal sequences are not allowed', code: 'PATH_TRAVERSAL' };
+            }
+            const validatedMaxResults = this.validateMaxResults(maxResults);
+            const baseDir = this.basePath;
+            try {
+                await fsPromises.access(baseDir);
+            }
+            catch {
+                return { success: true, files: [] };
+            }
+            const { files, hasMore } = await walkDirectory(baseDir, {
+                prefix: decodedPrefix,
+                continuationToken,
+                maxCollect: validatedMaxResults + 1,
+            });
+            return paginateFiles(files, validatedMaxResults, hasMore);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to list files',
+                code: 'PROVIDER_ERROR',
+            };
+        }
+    }
+}
+//# sourceMappingURL=local.driver.js.map

package/dist/esm/drivers/local.driver.js.map

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

package/dist/esm/drivers/s3.driver.d.ts

@@ -0,0 +1,69 @@
+import { BaseStorageDriver } from './base.driver.js';
+import { FileUploadResult, PresignedUrlResult, StorageConfig, BlobValidationOptions, BlobValidationResult, ListFilesResult, UploadOptions, FileInfo, DeleteResult } from '../types/storage.types.js';
+/**
+ * S3StorageDriver - Handles file operations with Amazon S3.
+ *
+ * Supports two authentication methods:
+ * 1. Explicit credentials (AWS_ACCESS_KEY + AWS_SECRET_KEY)
+ * 2. IAM roles (when running on AWS infrastructure)
+ *
+ * If you don't provide credentials, the AWS SDK automatically uses
+ * IAM roles, environment variables, or the shared credentials file.
+ *
+ * When driver is 's3-presigned', upload() returns presigned URLs
+ * instead of uploading directly.
+ *
+ * Required packages: @aws-sdk/client-s3, @aws-sdk/lib-storage, @aws-sdk/s3-request-presigner
+ */
+export declare class S3StorageDriver extends BaseStorageDriver {
+    private _client?;
+    private readonly bucketName;
+    private readonly region;
+    constructor(config: StorageConfig);
+    private ensureClient;
+    destroy(): void;
+    /**
+     * Uploads a file to S3, or returns a presigned URL when in presigned mode.
+     *
+     * For large files (>100MB), uses streaming multipart upload to reduce
+     * memory usage and improve reliability.
+     */
+    upload(file: Express.Multer.File, options?: UploadOptions): Promise<FileUploadResult>;
+    /**
+     * Uploads a large file using streaming multipart upload.
+     * Uses @aws-sdk/lib-storage which handles chunking and concurrency automatically.
+     */
+    private uploadWithStream;
+    /**
+     * Creates a presigned URL for uploading directly to S3.
+     *
+     * The URL enforces:
+     * - Exact content type (baked into the signature)
+     * - Exact file size (if provided)
+     *
+     * Clients that try to upload different content will get a 403.
+     */
+    generateUploadUrl(fileName: string, contentType?: string, fileSize?: number): Promise<PresignedUrlResult>;
+    /**
+     * Creates a presigned URL for downloading/viewing a file.
+     */
+    generateViewUrl(fileName: string): Promise<PresignedUrlResult>;
+    /**
+     * Deletes a file from S3.
+     */
+    delete(fileName: string): Promise<DeleteResult>;
+    /**
+     * Confirms an upload and optionally validates the file.
+     * Uses shared validation logic from BaseStorageDriver.
+     */
+    validateAndConfirmUpload(reference: string, options?: BlobValidationOptions): Promise<BlobValidationResult>;
+    /**
+     * Returns metadata about a file from S3 without downloading it.
+     */
+    getMetadata(reference: string): Promise<FileInfo | null>;
+    /**
+     * Lists files in the bucket with optional prefix filtering and pagination.
+     */
+    listFiles(prefix?: string, maxResults?: number, continuationToken?: string): Promise<ListFilesResult>;
+}
+//# sourceMappingURL=s3.driver.d.ts.map

package/dist/esm/drivers/s3.driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.driver.d.ts","sourceRoot":"","sources":["../../../src/drivers/s3.driver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAgDrM;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,OAAO,CAAC,OAAO,CAAC,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,aAAa;YAcnB,YAAY;IAmBjB,OAAO,IAAI,IAAI;IAKxB;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+D3F;;;OAGG;YACW,gBAAgB;IAyD9B;;;;;;;;OAQG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsC/G;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwBpE;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmCrD;;;OAGG;IACY,wBAAwB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA6BhC;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoB9D;;OAEG;IACG,SAAS,CACb,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,GAAE,MAAa,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,eAAe,CAAC;CAyC5B"}