express-storage 2.0.2 → 3.0.0

package/dist/cjs/drivers/azure.driver.js

@@ -0,0 +1,390 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureStorageDriver = void 0;
+const base_driver_js_1 = require("./base.driver.js");
+const file_utils_js_1 = require("../utils/file.utils.js");
+// Lazy SDK loaders — modules are imported on first use, not at import time.
+let _azureBlobMod;
+function loadAzureBlobSDK() {
+    if (!_azureBlobMod) {
+        _azureBlobMod = Promise.resolve().then(() => __importStar(require('@azure/storage-blob'))).catch(() => {
+            _azureBlobMod = undefined;
+            throw new Error('@azure/storage-blob is required for Azure storage.\n' +
+                'Install: npm install @azure/storage-blob @azure/identity');
+        });
+    }
+    return _azureBlobMod;
+}
+let _azureIdentityMod;
+function loadAzureIdentity() {
+    if (!_azureIdentityMod) {
+        _azureIdentityMod = Promise.resolve().then(() => __importStar(require('@azure/identity'))).catch(() => {
+            _azureIdentityMod = undefined;
+            throw new Error('@azure/identity is required for Azure Managed Identity authentication.\n' +
+                'Install: npm install @azure/identity');
+        });
+    }
+    return _azureIdentityMod;
+}
+/**
+ * AzureStorageDriver - Handles file operations with Azure Blob Storage.
+ *
+ * Supports three authentication methods:
+ * 1. Connection string (simplest — recommended for getting started)
+ * 2. Account name + Account key (more control)
+ * 3. Managed Identity (when running on Azure — no secrets needed!)
+ *
+ * Important: SAS URL generation requires an account key.
+ * Managed Identity works great for direct uploads but can't create presigned URLs.
+ *
+ * When driver is 'azure-presigned', upload() returns SAS URLs instead of
+ * uploading directly. Always call validateAndConfirmUpload() after client
+ * uploads — Azure doesn't enforce constraints on SAS URLs.
+ *
+ * Required packages: @azure/storage-blob, @azure/identity
+ */
+class AzureStorageDriver extends base_driver_js_1.BaseStorageDriver {
+    _blobServiceClient;
+    _containerClient;
+    containerName;
+    accountName;
+    accountKey;
+    constructor(config) {
+        super(config);
+        this.containerName = config.azureContainerName || config.bucketName || '';
+        if (!this.containerName) {
+            throw new Error('Azure container name is required. Set BUCKET_NAME environment variable or pass azureContainerName in credentials.');
+        }
+        this.accountName = '';
+        if (config.azureConnectionString) {
+            const accountNameMatch = config.azureConnectionString.match(/AccountName=([a-z0-9]{3,24})(?:;|$)/i);
+            if (accountNameMatch && accountNameMatch[1]) {
+                this.accountName = accountNameMatch[1].toLowerCase();
+            }
+            else {
+                throw new Error('Could not extract AccountName from Azure connection string. ' +
+                    'Ensure the connection string contains "AccountName=<name>" where name is 3-24 lowercase letters/numbers.');
+            }
+            const keyMatch = config.azureConnectionString.match(/AccountKey=([A-Za-z0-9+/=]{20,})(?:;|$)/);
+            if (keyMatch && keyMatch[1]) {
+                this.accountKey = keyMatch[1];
+            }
+        }
+        else if (config.azureAccountName) {
+            this.accountName = config.azureAccountName;
+            if (config.azureAccountKey) {
+                this.accountKey = config.azureAccountKey;
+            }
+        }
+        else {
+            throw new Error('Azure configuration requires either AZURE_CONNECTION_STRING, AZURE_ACCOUNT_NAME + AZURE_ACCOUNT_KEY, or AZURE_ACCOUNT_NAME (for Managed Identity)');
+        }
+        // Presigned mode requires an account key for SAS URL generation
+        if (this.presignedMode && this.accountKey === undefined) {
+            throw new Error('Azure presigned mode requires an account key for SAS URL generation. ' +
+                'Use AZURE_CONNECTION_STRING or provide both AZURE_ACCOUNT_NAME and AZURE_ACCOUNT_KEY. ' +
+                'Managed Identity cannot be used with presigned URLs - use the regular "azure" driver instead.');
+        }
+    }
+    async ensureContainerClient() {
+        if (this._containerClient)
+            return this._containerClient;
+        const azureBlob = await loadAzureBlobSDK();
+        if (this.config.azureConnectionString) {
+            this._blobServiceClient = azureBlob.BlobServiceClient.fromConnectionString(this.config.azureConnectionString);
+        }
+        else if (this.config.azureAccountName && this.config.azureAccountKey) {
+            const sharedKeyCredential = new azureBlob.StorageSharedKeyCredential(this.config.azureAccountName, this.config.azureAccountKey);
+            this._blobServiceClient = new azureBlob.BlobServiceClient(`https://${this.config.azureAccountName}.blob.core.windows.net`, sharedKeyCredential);
+        }
+        else if (this.config.azureAccountName) {
+            const azureIdentity = await loadAzureIdentity();
+            this._blobServiceClient = new azureBlob.BlobServiceClient(`https://${this.config.azureAccountName}.blob.core.windows.net`, new azureIdentity.DefaultAzureCredential());
+        }
+        else {
+            throw new Error('Azure configuration requires either AZURE_CONNECTION_STRING, AZURE_ACCOUNT_NAME + AZURE_ACCOUNT_KEY, or AZURE_ACCOUNT_NAME (for Managed Identity)');
+        }
+        this._containerClient = this._blobServiceClient.getContainerClient(this.containerName);
+        return this._containerClient;
+    }
+    destroy() {
+        this._blobServiceClient = undefined;
+        this._containerClient = undefined;
+    }
+    /**
+     * Uploads a file to Azure, or returns a SAS URL when in presigned mode.
+     *
+     * For large files (>100MB), uses streaming upload to reduce
+     * memory usage and improve reliability.
+     */
+    async upload(file, options) {
+        if (this.presignedMode) {
+            return this.presignedUpload(file);
+        }
+        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 blobPath = this.buildFilePath(fileName);
+            const containerClient = await this.ensureContainerClient();
+            const blockBlobClient = containerClient.getBlockBlobClient(blobPath);
+            const uploadOptions = {
+                blobHTTPHeaders: {
+                    blobContentType: options?.contentType || file.mimetype,
+                },
+            };
+            if (options?.cacheControl) {
+                uploadOptions.blobHTTPHeaders.blobCacheControl = options.cacheControl;
+            }
+            if (options?.contentDisposition) {
+                uploadOptions.blobHTTPHeaders.blobContentDisposition = options.contentDisposition;
+            }
+            if (options?.metadata) {
+                uploadOptions.metadata = options.metadata;
+            }
+            options?.signal?.throwIfAborted();
+            const abortSignal = options?.signal;
+            if (this.shouldUseStreaming(resolvedSize)) {
+                const fileStream = this.getFileStream(file);
+                const streamOptions = {
+                    blobHTTPHeaders: uploadOptions.blobHTTPHeaders,
+                };
+                if (uploadOptions.metadata) {
+                    streamOptions.metadata = uploadOptions.metadata;
+                }
+                if (abortSignal) {
+                    streamOptions.abortSignal = abortSignal;
+                }
+                await blockBlobClient.uploadStream(fileStream, 4 * 1024 * 1024, 4, streamOptions);
+            }
+            else {
+                const fileContent = await this.getFileContent(file);
+                await blockBlobClient.uploadData(fileContent, {
+                    ...uploadOptions,
+                    ...(abortSignal ? { abortSignal } : {}),
+                });
+            }
+            const fileUrl = `https://${this.accountName}.blob.core.windows.net/${this.containerName}/${(0, file_utils_js_1.encodePathSegments)(blobPath)}`;
+            return this.createSuccessResult(blobPath, fileUrl);
+        }
+        catch (error) {
+            await this.cleanupTempFile(file);
+            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to upload file to Azure');
+        }
+    }
+    /**
+     * Creates a SAS URL for uploading directly to Azure.
+     *
+     * Important: Unlike S3 and GCS, Azure SAS URLs do NOT enforce file size
+     * or content type. Always call validateAndConfirmUpload() after the
+     * client uploads to verify the file is what you expected.
+     */
+    async generateUploadUrl(fileName, contentType, _fileSize) {
+        try {
+            const decoded = this.decodeFileName(fileName);
+            const url = await this.generateSasUrl(decoded, 'cw', contentType || 'application/octet-stream');
+            return this.createPresignedSuccessResult(url);
+        }
+        catch (error) {
+            return this.createPresignedErrorResult(error instanceof Error ? error.message : 'Failed to generate upload URL');
+        }
+    }
+    /**
+     * Creates a SAS URL for downloading/viewing a file.
+     */
+    async generateViewUrl(fileName) {
+        try {
+            const decoded = this.decodeFileName(fileName);
+            const url = await this.generateSasUrl(decoded, 'r');
+            return this.createPresignedSuccessResult(undefined, url);
+        }
+        catch (error) {
+            return this.createPresignedErrorResult(error instanceof Error ? error.message : 'Failed to generate view URL');
+        }
+    }
+    /**
+     * Generates a SAS URL for a blob with the specified permissions.
+     */
+    async generateSasUrl(blobName, permissions, contentType) {
+        if (!this.accountKey) {
+            throw new Error('Account key is required for generating SAS URLs. Use connection string or provide AZURE_ACCOUNT_KEY.');
+        }
+        const azureBlob = await loadAzureBlobSDK();
+        const containerClient = await this.ensureContainerClient();
+        const blockBlobClient = containerClient.getBlockBlobClient(blobName);
+        const expiresOn = new Date(Date.now() + (this.getPresignedUrlExpiry() * 1000));
+        const sasOptions = {
+            containerName: this.containerName,
+            blobName,
+            permissions: azureBlob.BlobSASPermissions.parse(permissions),
+            expiresOn,
+            ...(contentType ? { contentType } : {}),
+        };
+        const sasToken = azureBlob.generateBlobSASQueryParameters(sasOptions, new azureBlob.StorageSharedKeyCredential(this.accountName, this.accountKey)).toString();
+        return `${blockBlobClient.url}?${sasToken}`;
+    }
+    /**
+     * Deletes a file from Azure Blob Storage.
+     */
+    async delete(fileName) {
+        try {
+            const decodedFileName = this.decodeFileName(fileName);
+            const containerClient = await this.ensureContainerClient();
+            const blockBlobClient = containerClient.getBlockBlobClient(decodedFileName);
+            const exists = await blockBlobClient.exists();
+            if (!exists) {
+                return { success: false, reference: fileName, error: 'File not found', code: 'FILE_NOT_FOUND' };
+            }
+            await blockBlobClient.delete();
+            return { success: true, reference: fileName };
+        }
+        catch (error) {
+            return { success: false, reference: fileName, error: error instanceof Error ? error.message : 'Failed to delete file', code: 'PROVIDER_ERROR' };
+        }
+    }
+    /**
+     * Validates an upload against expected values and deletes invalid files.
+     * Uses shared validation logic from BaseStorageDriver.
+     *
+     * This is CRITICAL for Azure presigned uploads because Azure doesn't
+     * enforce constraints at the URL level.
+     */
+    async validateAndConfirmUpload(reference, options) {
+        try {
+            const containerClient = await this.ensureContainerClient();
+            const blockBlobClient = containerClient.getBlockBlobClient(reference);
+            const properties = await blockBlobClient.getProperties();
+            const actual = {
+                contentType: properties.contentType,
+                fileSize: properties.contentLength,
+            };
+            const validationError = await this.checkUploadedFileMetadata(reference, actual, options);
+            if (validationError)
+                return validationError;
+            const viewResult = await this.generateViewUrl(reference);
+            return this.buildValidationSuccess(reference, viewResult.success ? viewResult.viewUrl : undefined, actual.contentType, actual.fileSize);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to validate upload',
+                code: 'PROVIDER_ERROR',
+            };
+        }
+    }
+    /**
+     * Returns metadata about a file from Azure without downloading it.
+     */
+    async getMetadata(reference) {
+        try {
+            const decoded = this.decodeFileName(reference);
+            const containerClient = await this.ensureContainerClient();
+            const blockBlobClient = containerClient.getBlockBlobClient(decoded);
+            const exists = await blockBlobClient.exists();
+            if (!exists)
+                return null;
+            const properties = await blockBlobClient.getProperties();
+            const info = { name: reference };
+            if (properties.contentLength !== undefined)
+                info.size = properties.contentLength;
+            if (properties.contentType)
+                info.contentType = properties.contentType;
+            if (properties.lastModified)
+                info.lastModified = properties.lastModified;
+            return info;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Lists files in the container with optional prefix filtering and pagination.
+     */
+    async listFiles(prefix, maxResults = 1000, continuationToken) {
+        try {
+            const validatedMaxResults = this.validateMaxResults(maxResults);
+            const containerClient = await this.ensureContainerClient();
+            const files = [];
+            let nextToken;
+            const listOptions = {};
+            if (prefix)
+                listOptions.prefix = prefix;
+            const pageOptions = {
+                maxPageSize: validatedMaxResults,
+            };
+            if (continuationToken)
+                pageOptions.continuationToken = continuationToken;
+            const iterator = containerClient.listBlobsFlat(listOptions)
+                .byPage(pageOptions);
+            const page = await iterator.next();
+            if (!page.done && page.value) {
+                for (const blob of page.value.segment.blobItems) {
+                    const fileInfo = { name: blob.name };
+                    if (blob.properties.contentLength !== undefined) {
+                        fileInfo.size = blob.properties.contentLength;
+                    }
+                    if (blob.properties.contentType) {
+                        fileInfo.contentType = blob.properties.contentType;
+                    }
+                    if (blob.properties.lastModified) {
+                        fileInfo.lastModified = blob.properties.lastModified;
+                    }
+                    files.push(fileInfo);
+                }
+                nextToken = page.value.continuationToken;
+            }
+            const result = {
+                success: true,
+                files,
+            };
+            if (nextToken) {
+                result.nextToken = nextToken;
+            }
+            return result;
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to list files',
+                code: 'PROVIDER_ERROR',
+            };
+        }
+    }
+}
+exports.AzureStorageDriver = AzureStorageDriver;
+//# sourceMappingURL=azure.driver.js.map

package/dist/cjs/drivers/azure.driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure.driver.js","sourceRoot":"","sources":["../../../src/drivers/azure.driver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,qDAAqD;AAErD,0DAA4D;AAE5D,4EAA4E;AAE5E,IAAI,aAAwE,CAAC;AAC7E,SAAS,gBAAgB;IACvB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,kDAAO,qBAAqB,IAAE,KAAK,CAAC,GAAG,EAAE;YACvD,aAAa,GAAG,SAAS,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,sDAAsD;gBACtD,0DAA0D,CAC3D,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,IAAI,iBAAwE,CAAC;AAC7E,SAAS,iBAAiB;IACxB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,kDAAO,iBAAiB,IAAE,KAAK,CAAC,GAAG,EAAE;YACvD,iBAAiB,GAAG,SAAS,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,0EAA0E;gBAC1E,sCAAsC,CACvC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,kBAAmB,SAAQ,kCAAiB;IAC/C,kBAAkB,CAAqC;IACvD,gBAAgB,CAAmC;IAC1C,aAAa,CAAS;IACtB,WAAW,CAAS;IACpB,UAAU,CAAU;IAErC,YAAY,MAAqB;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mHAAmH,CAAC,CAAC;QACvI,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QAEtB,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjC,MAAM,gBAAgB,GAAG,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACpG,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,8DAA8D;oBAC9D,0GAA0G,CAC3G,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC/F,IAAI,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC;YAC3C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC3B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;YAC3C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,mJAAmJ,CAAC,CAAC;QACvK,CAAC;QAED,gEAAgE;QAChE,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,uEAAuE;gBACvE,wFAAwF;gBACxF,+FAA+F,CAChG,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB;QACjC,IAAI,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAExD,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAE3C,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACtC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAChH,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACvE,MAAM,mBAAmB,GAAG,IAAI,SAAS,CAAC,0BAA0B,CAClE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAC5B,IAAI,CAAC,MAAM,CAAC,eAAe,CAC5B,CAAC;YACF,IAAI,CAAC,kBAAkB,GAAG,IAAI,SAAS,CAAC,iBAAiB,CACvD,WAAW,IAAI,CAAC,MAAM,CAAC,gBAAgB,wBAAwB,EAC/D,mBAAmB,CACpB,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAChD,IAAI,CAAC,kBAAkB,GAAG,IAAI,SAAS,CAAC,iBAAiB,CACvD,WAAW,IAAI,CAAC,MAAM,CAAC,gBAAgB,wBAAwB,EAC/D,IAAI,aAAa,CAAC,sBAAsB,EAAE,CAC3C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,mJAAmJ,CAAC,CAAC;QACvK,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAEQ,OAAO;QACd,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,IAAyB,EAAE,OAAuB;QAC7D,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACjF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAErE,MAAM,aAAa,GAOf;gBACF,eAAe,EAAE;oBACf,eAAe,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,QAAQ;iBACvD;aACF,CAAC;YAEF,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;gBAC1B,aAAa,CAAC,eAAe,CAAC,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;YACxE,CAAC;YACD,IAAI,OAAO,EAAE,kBAAkB,EAAE,CAAC;gBAChC,aAAa,CAAC,eAAe,CAAC,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YACpF,CAAC;YACD,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtB,aAAa,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAC5C,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YAElC,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,CAAC;YAEpC,IAAI,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,aAAa,GAIf;oBACF,eAAe,EAAE,aAAa,CAAC,eAAe;iBAC/C,CAAC;gBACF,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;oBAC3B,aAAa,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;gBAClD,CAAC;gBACD,IAAI,WAAW,EAAE,CAAC;oBAChB,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC;gBAC1C,CAAC;gBACD,MAAM,eAAe,CAAC,YAAY,CAChC,UAAU,EACV,CAAC,GAAG,IAAI,GAAG,IAAI,EACf,CAAC,EACD,aAAa,CACd,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBACpD,MAAM,eAAe,CAAC,UAAU,CAAC,WAAW,EAAE;oBAC5C,GAAG,aAAa;oBAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,WAAW,0BAA0B,IAAI,CAAC,aAAa,IAAI,IAAA,kCAAkB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAE1H,OAAO,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC,iBAAiB,CAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,WAAoB,EAAE,SAAkB;QAChF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,IAAI,0BAA0B,CAAC,CAAC;YAChG,OAAO,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,0BAA0B,CACpC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,4BAA4B,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,0BAA0B,CACpC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,WAAmB,EAAE,WAAoB;QACtF,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;QAC1H,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAC3C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3D,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAE/E,MAAM,UAAU,GAAG;YACjB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ;YACR,WAAW,EAAE,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC;YAC5D,SAAS;YACT,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QAEF,MAAM,QAAQ,GAAG,SAAS,CAAC,8BAA8B,CACvD,UAAU,EACV,IAAI,SAAS,CAAC,0BAA0B,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAC5E,CAAC,QAAQ,EAAE,CAAC;QAEb,OAAO,GAAG,eAAe,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAE5E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;YAClG,CAAC;YAED,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QAClJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACM,KAAK,CAAC,wBAAwB,CACrC,SAAiB,EACjB,OAA+B;QAE/B,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YACtE,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,aAAa,EAAE,CAAC;YAEzD,MAAM,MAAM,GAAG;gBACb,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,QAAQ,EAAE,UAAU,CAAC,aAAa;aACnC,CAAC;YAEF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACzF,IAAI,eAAe;gBAAE,OAAO,eAAe,CAAC;YAE5C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1I,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;gBAC3E,IAAI,EAAE,gBAAgB;aACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAEzB,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,aAAa,EAAE,CAAC;YACzD,MAAM,IAAI,GAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC;YACjF,IAAI,UAAU,CAAC,WAAW;gBAAE,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;YACtE,IAAI,UAAU,CAAC,YAAY;gBAAE,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,MAAe,EACf,aAAqB,IAAI,EACzB,iBAA0B;QAE1B,IAAI,CAAC;YACH,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAEhE,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAe,EAAE,CAAC;YAC7B,IAAI,SAA6B,CAAC;YAElC,MAAM,WAAW,GAAwB,EAAE,CAAC;YAC5C,IAAI,MAAM;gBAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;YAExC,MAAM,WAAW,GAAwD;gBACvE,WAAW,EAAE,mBAAmB;aACjC,CAAC;YACF,IAAI,iBAAiB;gBAAE,WAAW,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;YAEzE,MAAM,QAAQ,GAAG,eAAe,CAAC,aAAa,CAAC,WAAW,CAAC;iBACxD,MAAM,CAAC,WAAW,CAAC,CAAC;YAEvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBAChD,MAAM,QAAQ,GAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;wBAChD,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;oBAChD,CAAC;oBACD,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;wBAChC,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;oBACrD,CAAC;oBACD,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;wBACjC,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;oBACvD,CAAC;oBACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;gBACD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;YAC3C,CAAC;YAED,MAAM,MAAM,GAAoB;gBAC9B,OAAO,EAAE,IAAI;gBACb,KAAK;aACN,CAAC;YAEF,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;YAC/B,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB;gBACtE,IAAI,EAAE,gBAAgB;aACvB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA1XD,gDA0XC"}

package/dist/cjs/drivers/base.driver.d.ts

@@ -0,0 +1,136 @@
+import { Readable } from 'stream';
+import { IStorageDriver, FileUploadResult, PresignedUrlResult, PresignedUrlSuccess, StorageConfig, BlobValidationOptions, BlobValidationResult, BlobValidationSuccess, BlobValidationError, ListFilesResult, UploadOptions, DeleteResult, StorageErrorCode, FileInfo } from '../types/storage.types.js';
+/**
+ * BaseStorageDriver - The foundation that all storage drivers build upon.
+ *
+ * This abstract class provides common functionality that every driver needs:
+ * filename generation, file validation, content reading, and result formatting.
+ *
+ * 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 declare abstract class BaseStorageDriver implements IStorageDriver {
+    protected readonly config: StorageConfig;
+    protected readonly presignedMode: boolean;
+    constructor(config: StorageConfig);
+    /**
+     * Builds the full storage path by combining the bucket path with the filename.
+     * For example: 'uploads' + 'photo.jpg' = 'uploads/photo.jpg'
+     */
+    protected buildFilePath(fileName: string): string;
+    /**
+     * Uploads a single file. Each driver implements this differently.
+     * When presignedMode is true, returns a presigned URL instead of uploading directly.
+     */
+    abstract upload(file: Express.Multer.File, options?: UploadOptions): Promise<FileUploadResult>;
+    abstract generateUploadUrl(fileName: string, contentType?: string, fileSize?: number): Promise<PresignedUrlResult>;
+    abstract generateViewUrl(fileName: string): Promise<PresignedUrlResult>;
+    abstract delete(fileName: string): Promise<DeleteResult>;
+    abstract listFiles(prefix?: string, maxResults?: number, continuationToken?: string): Promise<ListFilesResult>;
+    abstract getMetadata(reference: string): Promise<FileInfo | null>;
+    /**
+     * Releases SDK clients and internal resources. Override in drivers that
+     * hold connection pools (S3Client, GCS Storage, Azure BlobServiceClient).
+     * Default implementation is a no-op.
+     */
+    destroy(): void;
+    /**
+     * Creates a unique filename that won't collide with existing files.
+     */
+    protected generateFileName(originalName: string): string;
+    protected createSuccessResult(reference: string, fileUrl: string): FileUploadResult;
+    protected createErrorResult(error: string, code?: StorageErrorCode): FileUploadResult;
+    protected createPresignedSuccessResult(uploadUrl?: string, viewUrl?: string): PresignedUrlSuccess;
+    protected createPresignedErrorResult(error: string, code?: StorageErrorCode): PresignedUrlResult;
+    /**
+     * Validates a file before upload.
+     *
+     * 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).
+     */
+    protected validateFile(file: Express.Multer.File): Promise<{
+        errors: string[];
+        resolvedSize: number;
+    }>;
+    /**
+     * Reads the file content, whether it's in memory or on disk.
+     *
+     * @warning **MEMORY IMPLICATIONS**: Loads the ENTIRE file into memory.
+     * ALWAYS call `shouldUseStreaming(file)` first and use `getFileStream()`
+     * for files larger than 100MB.
+     */
+    protected getFileContent(file: Express.Multer.File): Promise<Buffer>;
+    /**
+     * Returns a readable stream for the file content.
+     * Use this instead of getFileContent() for large files (>100MB).
+     */
+    protected getFileStream(file: Express.Multer.File): Readable;
+    /**
+     * Determines if a file should use streaming based on its size.
+     * Files larger than 100MB benefit from streaming to reduce memory usage.
+     */
+    protected shouldUseStreaming(fileSize: number): boolean;
+    /**
+     * Gets the file size, reading from disk if necessary.
+     */
+    protected getFileSize(file: Express.Multer.File): Promise<number>;
+    /**
+     * Cleans up a Multer disk storage temp file if it exists.
+     * Call this in upload error paths to prevent temp file leaks.
+     */
+    protected cleanupTempFile(file: Express.Multer.File): Promise<void>;
+    /**
+     * Returns how long presigned URLs should be valid (in seconds).
+     * Clamped to [1, 604800] (1 second to 7 days). Default: 600 (10 minutes).
+     */
+    protected getPresignedUrlExpiry(): number;
+    /**
+     * Decodes a URL-encoded filename and checks for path traversal attacks.
+     * Throws on malformed encoding or traversal sequences.
+     */
+    protected decodeFileName(fileName: string): string;
+    /**
+     * Validates and clamps maxResults for list operations.
+     */
+    protected validateMaxResults(maxResults: number): number;
+    /**
+     * Shared upload logic for presigned mode.
+     * Validates the file, generates a unique name, and returns a presigned upload URL.
+     */
+    protected presignedUpload(file: Express.Multer.File): Promise<FileUploadResult>;
+    /**
+     * Confirms that an upload completed successfully.
+     *
+     * The default implementation just checks if the file exists.
+     * Azure overrides this to validate file properties since Azure
+     * doesn't enforce constraints at the presigned URL level.
+     */
+    validateAndConfirmUpload(reference: string, _options?: BlobValidationOptions): Promise<BlobValidationResult>;
+    /**
+     * 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.
+     */
+    protected checkUploadedFileMetadata(reference: string, actual: {
+        contentType?: string | undefined;
+        fileSize?: number | undefined;
+    }, options?: BlobValidationOptions): Promise<BlobValidationError | null>;
+    /**
+     * Builds a successful validation result with optional view URL and metadata.
+     */
+    protected buildValidationSuccess(reference: string, viewUrl?: string, actualContentType?: string, actualFileSize?: number): BlobValidationSuccess;
+    private buildValidationError;
+}
+//# sourceMappingURL=base.driver.d.ts.map

package/dist/cjs/drivers/base.driver.d.ts.map

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