express-storage 2.0.3 → 3.0.0

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

@@ -1,6 +1,7 @@
 import fs from 'fs';
+import fsPromises from 'fs/promises';
 import { Readable } from 'stream';
-import { generateUniqueFileName, withConcurrencyLimit } from '../utils/file.utils.js';
+import { generateUniqueFileName } from '../utils/file.utils.js';
 /** Threshold for using streaming uploads (100MB) */
 const STREAM_THRESHOLD = 100 * 1024 * 1024;
 /**
@@ -11,10 +12,23 @@ const STREAM_THRESHOLD = 100 * 1024 * 1024;
  *
  * If you're building a custom driver, extend this class and implement the
  * abstract methods. You'll get all the helper methods for free.
+ *
+ * **Security validation contract:**
+ * - **StorageManager** (layer 1): validates raw user input at the public API
+ *   boundary — path traversal, MIME type format, file size limits.
+ * - **Driver** (layer 2): decodes URL-encoded filenames via `decodeFileName()`
+ *   and rejects traversal/encoding attacks. This ensures safety when drivers
+ *   are used directly without StorageManager.
+ * - **Local driver internals** (layer 3): containment checks (`path.resolve`
+ *   stays within `basePath`), symlink rejection, file-type verification.
+ *   These are filesystem-specific concerns, not input validation.
  */
 export class BaseStorageDriver {
+    config;
+    presignedMode;
     constructor(config) {
         this.config = config;
+        this.presignedMode = config.driver.endsWith('-presigned');
     }
     /**
      * Builds the full storage path by combining the bucket path with the filename.
@@ -29,126 +43,55 @@ export class BaseStorageDriver {
         return `${normalizedPath}/${fileName}`;
     }
     /**
-     * Returns the configured bucket path, cleaned up and ready to use.
-     */
-    getBucketPath() {
-        return this.config.bucketPath?.trim()?.replace(/^\/+|\/+$/g, '') || '';
-    }
-    /**
-     * Uploads multiple files with smart concurrency control.
-     * Processes up to 10 files at a time to balance speed and system resources.
-     */
-    async uploadMultiple(files, options) {
-        if (!files || files.length === 0) {
-            return [];
-        }
-        return withConcurrencyLimit(files, async (file) => {
-            try {
-                return await this.upload(file, options);
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    error: error instanceof Error ? error.message : 'Failed to upload file',
-                };
-            }
-        }, { maxConcurrent: 10 });
-    }
-    /**
-     * Deletes multiple files with smart concurrency control.
-     * Returns detailed results so you know exactly what happened with each file.
+     * Releases SDK clients and internal resources. Override in drivers that
+     * hold connection pools (S3Client, GCS Storage, Azure BlobServiceClient).
+     * Default implementation is a no-op.
      */
-    async deleteMultiple(fileNames) {
-        if (!fileNames || fileNames.length === 0) {
-            return [];
-        }
-        return withConcurrencyLimit(fileNames, async (fileName) => {
-            try {
-                const success = await this.delete(fileName);
-                const result = { success, fileName };
-                if (!success) {
-                    result.error = 'File not found or already deleted';
-                }
-                return result;
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    fileName,
-                    error: error instanceof Error ? error.message : 'Failed to delete file',
-                };
-            }
-        }, { maxConcurrent: 10 });
+    destroy() {
+        // No-op — subclasses override to close SDK clients
     }
     /**
      * Creates a unique filename that won't collide with existing files.
-     * Format: {timestamp}_{random}_{original_name}.{ext}
      */
     generateFileName(originalName) {
         return generateUniqueFileName(originalName);
     }
-    /**
-     * Builds a success response for upload operations.
-     */
-    createSuccessResult(fileName, fileUrl) {
-        const result = {
-            success: true,
-            fileName,
-        };
-        if (fileUrl) {
-            result.fileUrl = fileUrl;
-        }
-        return result;
+    // ---------------------------------------------------------------------------
+    // Result builders — return proper discriminated union variants
+    // ---------------------------------------------------------------------------
+    createSuccessResult(reference, fileUrl) {
+        return { success: true, reference, fileUrl };
     }
-    /**
-     * Builds an error response for upload operations.
-     */
-    createErrorResult(error) {
-        return {
-            success: false,
-            error,
-        };
+    createErrorResult(error, code = 'PROVIDER_ERROR') {
+        return { success: false, error, code };
     }
-    /**
-     * Builds a success response for presigned URL operations.
-     */
     createPresignedSuccessResult(uploadUrl, viewUrl) {
-        const result = {
-            success: true,
-        };
-        if (uploadUrl) {
+        const result = { success: true };
+        if (uploadUrl)
             result.uploadUrl = uploadUrl;
-        }
-        if (viewUrl) {
+        if (viewUrl)
             result.viewUrl = viewUrl;
-        }
         return result;
     }
-    /**
-     * Builds an error response for presigned URL operations.
-     */
-    createPresignedErrorResult(error) {
-        return {
-            success: false,
-            error,
-        };
+    createPresignedErrorResult(error, code = 'PROVIDER_ERROR') {
+        return { success: false, error, code };
     }
+    // ---------------------------------------------------------------------------
+    // File validation
+    // ---------------------------------------------------------------------------
     /**
      * Validates a file before upload.
      *
-     * Checks for common issues:
-     * - Missing file
-     * - No original name
-     * - No MIME type
-     * - Empty content
+     * Checks: missing file, no name, no MIME type, empty content, and
+     * maxFileSize from config (enforced here so direct driver usage is safe).
      *
      * Works with both Multer memory storage (file.buffer) and disk storage (file.path).
      */
-    validateFile(file) {
+    async validateFile(file) {
         const errors = [];
         if (!file) {
             errors.push('No file provided');
-            return errors;
+            return { errors, resolvedSize: 0 };
         }
         if (!file.originalname) {
             errors.push('File must have an original name');
@@ -156,77 +99,58 @@ export class BaseStorageDriver {
         if (!file.mimetype) {
             errors.push('File must have a MIME type');
         }
-        // Check for file content (could be in memory or on disk)
         const hasBuffer = (file.buffer?.length ?? 0) > 0;
         const hasPath = typeof file.path === 'string' && file.path.length > 0;
         const hasEmptyBuffer = file.buffer !== null && file.buffer !== undefined && file.buffer.length === 0;
+        let resolvedSize = file.size || 0;
         if (hasEmptyBuffer && !hasPath) {
             errors.push('File is empty (0 bytes)');
         }
         else if (!hasBuffer && !hasPath) {
             errors.push('File must have either buffer (memory storage) or path (disk storage)');
         }
-        // For disk storage, verify the file exists and isn't empty
         if (hasPath && !hasBuffer) {
             try {
-                const stats = fs.statSync(file.path);
+                const stats = await fsPromises.stat(file.path);
                 if (stats.size === 0) {
                     errors.push('File is empty (0 bytes)');
                 }
-                if (!file.size || file.size === 0) {
-                    file.size = stats.size;
-                }
+                resolvedSize = stats.size;
             }
             catch {
                 errors.push('Cannot read file from disk storage path');
             }
         }
-        return errors;
+        if (hasBuffer && !resolvedSize) {
+            resolvedSize = file.buffer.length;
+        }
+        if (this.config.maxFileSize && resolvedSize > this.config.maxFileSize) {
+            errors.push(`File size ${resolvedSize} exceeds maximum allowed size of ${this.config.maxFileSize} bytes`);
+        }
+        return { errors, resolvedSize };
     }
+    // ---------------------------------------------------------------------------
+    // File content helpers
+    // ---------------------------------------------------------------------------
     /**
      * Reads the file content, whether it's in memory or on disk.
      *
-     * Note: For disk storage, this reads the file but doesn't delete it.
-     * Call cleanupTempFile() afterward if you need to remove the temp file.
-     *
-     * @warning **MEMORY IMPLICATIONS**: This method loads the ENTIRE file into memory.
-     * For large files, this can cause memory exhaustion and application crashes.
-     *
-     * **ALWAYS call `shouldUseStreaming(file)` first** and use `getFileStream()`
-     * for files larger than 100MB. Example:
-     *
-     * ```typescript
-     * if (this.shouldUseStreaming(file)) {
-     *   return this.uploadWithStream(file);
-     * }
-     * const content = this.getFileContent(file); // Safe for smaller files
-     * ```
-     *
-     * Memory usage: A 1GB file will allocate ~1GB of heap memory.
-     * Node.js default heap limit is ~1.5GB, so large files WILL crash your app.
-     *
-     * @param file - The Multer file object
-     * @returns Buffer containing the entire file contents
-     * @throws Error if file has neither buffer nor path
+     * @warning **MEMORY IMPLICATIONS**: Loads the ENTIRE file into memory.
+     * ALWAYS call `shouldUseStreaming(file)` first and use `getFileStream()`
+     * for files larger than 100MB.
      */
-    getFileContent(file) {
+    async getFileContent(file) {
         if ((file.buffer?.length ?? 0) > 0) {
             return file.buffer;
         }
         if (file.path) {
-            return fs.readFileSync(file.path);
+            return fsPromises.readFile(file.path);
         }
         throw new Error('File has neither buffer nor path - cannot read content');
     }
     /**
      * Returns a readable stream for the file content.
-     *
-     * Use this instead of getFileContent() for large files to avoid
-     * loading the entire file into memory. Particularly useful for
-     * files larger than 100MB.
-     *
-     * @param file - The Multer file object
-     * @returns A readable stream of the file content
+     * Use this instead of getFileContent() for large files (>100MB).
      */
     getFileStream(file) {
         if ((file.buffer?.length ?? 0) > 0) {
@@ -239,23 +163,15 @@ export class BaseStorageDriver {
     }
     /**
      * Determines if a file should use streaming based on its size.
-     *
      * Files larger than 100MB benefit from streaming to reduce memory usage.
-     *
-     * @param file - The Multer file object
-     * @returns true if the file should use streaming
      */
-    shouldUseStreaming(file) {
-        const size = file.size || 0;
-        return size > STREAM_THRESHOLD;
+    shouldUseStreaming(fileSize) {
+        return fileSize > STREAM_THRESHOLD;
     }
     /**
      * Gets the file size, reading from disk if necessary.
-     *
-     * @param file - The Multer file object
-     * @returns The file size in bytes
      */
-    getFileSize(file) {
+    async getFileSize(file) {
         if (file.size && file.size > 0) {
             return file.size;
         }
@@ -264,7 +180,7 @@ export class BaseStorageDriver {
         }
         if (file.path) {
             try {
-                const stats = fs.statSync(file.path);
+                const stats = await fsPromises.stat(file.path);
                 return stats.size;
             }
             catch {
@@ -274,40 +190,30 @@ export class BaseStorageDriver {
         return 0;
     }
     /**
-     * Removes a temporary file created by Multer disk storage.
-     *
-     * Call this after a successful upload if you're using disk storage
-     * and want to clean up. Memory storage doesn't need this — the
-     * garbage collector handles cleanup automatically.
-     *
-     * @returns true if the file was deleted, false otherwise
+     * Cleans up a Multer disk storage temp file if it exists.
+     * Call this in upload error paths to prevent temp file leaks.
      */
-    cleanupTempFile(file) {
-        if (file.path && fs.existsSync(file.path)) {
+    async cleanupTempFile(file) {
+        if (file.path) {
             try {
-                fs.unlinkSync(file.path);
-                return true;
-            }
-            catch {
-                return false;
+                await fsPromises.unlink(file.path);
             }
+            catch { /* best-effort */ }
         }
-        return false;
     }
+    // ---------------------------------------------------------------------------
+    // Presigned URL helpers
+    // ---------------------------------------------------------------------------
     /**
      * Returns how long presigned URLs should be valid (in seconds).
-     *
-     * Clamps the value to stay within cloud provider limits:
-     * - Minimum: 1 second
-     * - Maximum: 7 days (604800 seconds)
-     * - Default: 10 minutes (600 seconds)
+     * Clamped to [1, 604800] (1 second to 7 days). Default: 600 (10 minutes).
      */
     getPresignedUrlExpiry() {
         const MAX_EXPIRY = 604800;
         const MIN_EXPIRY = 1;
         const DEFAULT_EXPIRY = 600;
         const expiry = this.config.presignedUrlExpiry;
-        if (expiry === undefined || expiry === null || Number.isNaN(expiry)) {
+        if (expiry === undefined || Number.isNaN(expiry)) {
             return DEFAULT_EXPIRY;
         }
         if (expiry < MIN_EXPIRY) {
@@ -318,6 +224,54 @@ export class BaseStorageDriver {
         }
         return expiry;
     }
+    /**
+     * Decodes a URL-encoded filename and checks for path traversal attacks.
+     * Throws on malformed encoding or traversal sequences.
+     */
+    decodeFileName(fileName) {
+        let decoded;
+        try {
+            decoded = decodeURIComponent(fileName);
+        }
+        catch {
+            throw new Error('Invalid fileName: malformed URL encoding');
+        }
+        if (decoded.includes('..') || decoded.includes('\0')) {
+            throw new Error('Invalid fileName: path traversal sequences are not allowed');
+        }
+        return decoded;
+    }
+    /**
+     * Validates and clamps maxResults for list operations.
+     */
+    validateMaxResults(maxResults) {
+        return Math.floor(Math.max(1, Math.min(Number.isNaN(maxResults) ? 1000 : maxResults, 1000)));
+    }
+    /**
+     * Shared upload logic for presigned mode.
+     * Validates the file, generates a unique name, and returns a presigned upload URL.
+     */
+    async presignedUpload(file) {
+        try {
+            const { errors, resolvedSize } = await this.validateFile(file);
+            if (errors.length > 0) {
+                return this.createErrorResult(errors.join(', '), 'VALIDATION_FAILED');
+            }
+            const fileName = this.generateFileName(file.originalname);
+            const filePath = this.buildFilePath(fileName);
+            const presignedResult = await this.generateUploadUrl(filePath, file.mimetype, resolvedSize);
+            if (!presignedResult.success) {
+                return this.createErrorResult(presignedResult.error, presignedResult.code);
+            }
+            return this.createSuccessResult(filePath, presignedResult.uploadUrl || '');
+        }
+        catch (error) {
+            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to generate presigned URL');
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Upload validation (post-upload confirmation)
+    // ---------------------------------------------------------------------------
     /**
      * Confirms that an upload completed successfully.
      *
@@ -340,8 +294,57 @@ export class BaseStorageDriver {
         }
         return {
             success: false,
-            error: viewResult.error || 'File not found',
+            error: viewResult.error,
+            code: 'FILE_NOT_FOUND',
         };
     }
+    /**
+     * Validates uploaded file metadata against expected values.
+     * Shared by cloud drivers to avoid duplicating content-type and file-size checks.
+     * Returns a validation error result if checks fail, null if everything passes.
+     */
+    async checkUploadedFileMetadata(reference, actual, options) {
+        const deleteOnFailure = options?.deleteOnFailure !== false;
+        if (options?.expectedContentType && actual.contentType !== options.expectedContentType) {
+            if (deleteOnFailure)
+                await this.delete(reference);
+            return this.buildValidationError(`Content type mismatch: expected '${options.expectedContentType}', got '${actual.contentType}'`, deleteOnFailure, actual.contentType, actual.fileSize);
+        }
+        if (options?.expectedFileSize !== undefined && actual.fileSize !== options.expectedFileSize) {
+            if (deleteOnFailure)
+                await this.delete(reference);
+            return this.buildValidationError(`File size mismatch: expected ${options.expectedFileSize} bytes, got ${actual.fileSize} bytes`, deleteOnFailure, actual.contentType, actual.fileSize);
+        }
+        return null;
+    }
+    /**
+     * Builds a successful validation result with optional view URL and metadata.
+     */
+    buildValidationSuccess(reference, viewUrl, actualContentType, actualFileSize) {
+        const result = {
+            success: true,
+            reference,
+            expiresIn: this.getPresignedUrlExpiry(),
+        };
+        if (viewUrl)
+            result.viewUrl = viewUrl;
+        if (actualContentType)
+            result.actualContentType = actualContentType;
+        if (actualFileSize !== undefined)
+            result.actualFileSize = actualFileSize;
+        return result;
+    }
+    buildValidationError(message, deleted, contentType, fileSize) {
+        const result = {
+            success: false,
+            error: `${message}${deleted ? ' (file deleted)' : ' (file kept for inspection)'}`,
+            code: 'VALIDATION_FAILED',
+        };
+        if (contentType)
+            result.actualContentType = contentType;
+        if (fileSize !== undefined)
+            result.actualFileSize = fileSize;
+        return result;
+    }
 }
 //# sourceMappingURL=base.driver.js.map

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

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

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

@@ -1,5 +1,5 @@
 import { BaseStorageDriver } from './base.driver.js';
-import { FileUploadResult, PresignedUrlResult, StorageConfig, BlobValidationOptions, BlobValidationResult, ListFilesResult, UploadOptions } from '../types/storage.types.js';
+import { FileUploadResult, PresignedUrlResult, StorageConfig, BlobValidationOptions, BlobValidationResult, ListFilesResult, UploadOptions, FileInfo, DeleteResult } from '../types/storage.types.js';
 /**
  * GCSStorageDriver - Handles file operations with Google Cloud Storage.
  *
@@ -9,16 +9,22 @@ import { FileUploadResult, PresignedUrlResult, StorageConfig, BlobValidationOpti
  *
  * If you're running on GCP (Cloud Run, GKE, etc.), you usually don't need
  * to provide credentials — the SDK picks them up automatically.
+ *
+ * When driver is 'gcs-presigned', upload() returns presigned URLs
+ * instead of uploading directly.
+ *
+ * Required package: @google-cloud/storage
  */
 export declare class GCSStorageDriver extends BaseStorageDriver {
-    private storage;
-    private bucket;
-    private bucketName;
-    private projectId;
+    private _storage?;
+    private _bucket?;
+    private readonly bucketName;
+    private readonly projectId;
     constructor(config: StorageConfig);
+    private ensureBucket;
+    destroy(): void;
     /**
-     * Uploads a file directly to GCS.
-     * Handles both memory and disk storage from Multer.
+     * Uploads a file to GCS, or returns a presigned URL when in presigned mode.
      *
      * For large files (>100MB), uses streaming upload to reduce
      * memory usage and improve reliability.
@@ -26,9 +32,7 @@ export declare class GCSStorageDriver extends BaseStorageDriver {
     upload(file: Express.Multer.File, options?: UploadOptions): Promise<FileUploadResult>;
     /**
      * Uploads a large file using streaming.
-     *
-     * This method pipes the file stream directly to GCS, which is more
-     * memory-efficient for large files.
+     * Pipes the file stream directly to GCS for memory efficiency.
      */
     private uploadWithStream;
     /**
@@ -37,8 +41,6 @@ export declare class GCSStorageDriver extends BaseStorageDriver {
      * The URL enforces:
      * - Exact content type
      * - Exact file size (via x-goog-content-length-range header)
-     *
-     * Clients that try to upload different content will get a 403.
      */
     generateUploadUrl(fileName: string, contentType?: string, fileSize?: number): Promise<PresignedUrlResult>;
     /**
@@ -47,40 +49,20 @@ export declare class GCSStorageDriver extends BaseStorageDriver {
     generateViewUrl(fileName: string): Promise<PresignedUrlResult>;
     /**
      * Deletes a file from GCS.
-     * Returns false if the file doesn't exist, throws on real errors.
      */
-    delete(fileName: string): Promise<boolean>;
+    delete(fileName: string): Promise<DeleteResult>;
     /**
      * Confirms an upload and optionally validates the file.
-     *
-     * For GCS, validation is optional since constraints are enforced at URL level.
-     * But you can still use this to verify the file matches expectations.
+     * Uses shared validation logic from BaseStorageDriver.
      */
     validateAndConfirmUpload(reference: string, options?: BlobValidationOptions): Promise<BlobValidationResult>;
     /**
-     * Lists files in the bucket with optional prefix filtering and pagination.
+     * Returns metadata about a file from GCS without downloading it.
      */
-    listFiles(prefix?: string, maxResults?: number, continuationToken?: string): Promise<ListFilesResult>;
-}
-/**
- * GCSPresignedStorageDriver - GCS driver that returns presigned URLs from upload().
- *
- * Use this when you want clients to upload directly to GCS without
- * the file passing through your server.
- */
-export declare class GCSPresignedStorageDriver extends GCSStorageDriver {
-    constructor(config: StorageConfig);
+    getMetadata(reference: string): Promise<FileInfo | null>;
     /**
-     * Instead of uploading the file, returns a presigned URL for the client to use.
-     *
-     * The returned fileUrl is the presigned upload URL.
-     * After the client uploads, use validateAndConfirmUpload() to get a view URL.
-     *
-     * Note: The `options` parameter (metadata, cacheControl, etc.) is NOT applied
-     * when using presigned uploads. These options must be set by the client when
-     * making the actual upload request to GCS, or configured via bucket settings.
-     * For server-side uploads with full options support, use the regular 'gcs' driver.
+     * Lists files in the bucket with optional prefix filtering and pagination.
      */
-    upload(file: Express.Multer.File, _options?: UploadOptions): Promise<FileUploadResult>;
+    listFiles(prefix?: string, maxResults?: number, continuationToken?: string): Promise<ListFilesResult>;
 }
 //# sourceMappingURL=gcs.driver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gcs.driver.d.ts","sourceRoot":"","sources":["../../../src/drivers/gcs.driver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAY,MAAM,2BAA2B,CAAC;AAGvL;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,aAAa;IAkBjC;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkD3F;;;;;OAKG;YACW,gBAAgB;IAuB9B;;;;;;;;OAQG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiD/G;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgCpE;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBhD;;;;;OAKG;IACY,wBAAwB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAsEhC;;OAEG;IACG,SAAS,CACb,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,GAAE,MAAa,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,eAAe,CAAC;CAkD5B;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,MAAM,EAAE,aAAa;IAIjC;;;;;;;;;;OAUG;IACY,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA2BtG"}
+{"version":3,"file":"gcs.driver.d.ts","sourceRoot":"","sources":["../../../src/drivers/gcs.driver.ts"],"names":[],"mappings":"AACA,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;AAwBrM;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,aAAa;YAcnB,YAAY;IAiBjB,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;IAuD3F;;;OAGG;YACW,gBAAgB;IAqB9B;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqC/G;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqBpE;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBrD;;;OAGG;IACY,wBAAwB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAyBhC;;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;CA6C5B"}