node-server-engine 1.8.0 → 1.9.0

package/dist/entities/AWSS3/AWSS3.d.ts

@@ -0,0 +1,157 @@
+import { Readable } from 'stream';
+import { S3Client } from '@aws-sdk/client-s3';
+import { S3UploadDestinationOptions, S3UploadedFile, S3UploaderOptions, S3GetResponse, S3DownloadResponse, AWSS3Config, S3FileMetadata } from './AWSS3.types';
+/**
+ * Generic AWS S3 wrapper for easy file operations
+ * Provides methods for uploading, downloading, streaming, and deleting files
+ * Compatible with AWS S3 and S3-compatible services (MinIO, LocalStack, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Initialize with custom configuration
+ * AWSS3.init({
+ *   region: 'us-east-1',
+ *   accessKeyId: 'YOUR_ACCESS_KEY',
+ *   secretAccessKey: 'YOUR_SECRET_KEY'
+ * });
+ *
+ * // Upload a file
+ * const result = await AWSS3.upload(
+ *   fileStream,
+ *   'my-bucket',
+ *   { directory: 'uploads', mime: 'image/png' }
+ * );
+ *
+ * // Download a file
+ * const { data, metadata } = await AWSS3.get('my-bucket', 'uploads/file.png');
+ *
+ * // Delete a file
+ * await AWSS3.delete('my-bucket', 'uploads/file.png');
+ * ```
+ */
+export declare const AWSS3: {
+    s3Client: S3Client | null;
+    /**
+     * Initialize AWS S3 with configuration
+     * Call this method before using any other methods
+     * @param config - AWS S3 configuration options
+     */
+    init(config?: AWSS3Config): void;
+    /**
+     * Get the S3 client instance (auto-initializes if needed)
+     * @private
+     */
+    getS3Client(): S3Client;
+    /**
+     * Upload a file to AWS S3
+     * @param readStream - Readable stream of the file content
+     * @param bucket - Bucket name where the file should be stored
+     * @param destinationOptions - Options for file destination (directory, fileName, etc.)
+     * @param uploaderOptions - Additional options like maxSize
+     * @param metadata - Optional metadata to attach to the file
+     * @returns Promise with file upload result
+     *
+     * @example
+     * ```typescript
+     * const fileStream = fs.createReadStream('photo.jpg');
+     * const result = await AWSS3.upload(
+     *   fileStream,
+     *   'my-bucket',
+     *   { directory: 'photos', mime: 'image/jpeg' },
+     *   { maxSize: '5MB' },
+     *   { userId: '123', uploadedBy: 'user@example.com' }
+     * );
+     * console.log(result.Key); // photos/uuid.jpeg
+     * ```
+     */
+    upload(readStream: Readable, bucket: string, destinationOptions?: S3UploadDestinationOptions, uploaderOptions?: S3UploaderOptions, metadata?: Record<string, string>): Promise<S3UploadedFile>;
+    /**
+     * Download a file from AWS S3 and return its content as Buffer
+     * @param bucket - Bucket name
+     * @param key - File key (path) in the bucket
+     * @returns Promise with file data and metadata
+     *
+     * @example
+     * ```typescript
+     * const { data, metadata } = await AWSS3.get('my-bucket', 'photos/image.jpg');
+     * console.log(metadata.ContentLength); // File size in bytes
+     * console.log(data); // Buffer with file content
+     * ```
+     */
+    get(bucket: string, key: string): Promise<S3GetResponse>;
+    /**
+     * Get a readable stream for a file from AWS S3
+     * Use this for large files or when you need to stream the content
+     * @param bucket - Bucket name
+     * @param key - File key (path) in the bucket
+     * @returns Promise with readable stream and metadata
+     *
+     * @example
+     * ```typescript
+     * const { stream, metadata } = await AWSS3.download('my-bucket', 'videos/video.mp4');
+     * stream.pipe(res); // Stream to HTTP response
+     * ```
+     */
+    download(bucket: string, key: string): Promise<S3DownloadResponse>;
+    /**
+     * Get a readable stream for a file (without fetching all metadata first)
+     * Use this when you don't need metadata and want faster streaming
+     * @param bucket - Bucket name
+     * @param key - File key (path) in the bucket
+     * @returns Promise with readable stream
+     *
+     * @example
+     * ```typescript
+     * const stream = await AWSS3.getFileStream('my-bucket', 'audio/song.mp3');
+     * stream.pipe(res); // Direct streaming
+     * ```
+     */
+    getFileStream(bucket: string, key: string): Promise<Readable>;
+    /**
+     * Get file metadata without downloading the file
+     * @param bucket - Bucket name
+     * @param key - File key (path) in the bucket
+     * @returns Promise with file metadata
+     *
+     * @example
+     * ```typescript
+     * const metadata = await AWSS3.getMetadata('my-bucket', 'photos/image.jpg');
+     * console.log(metadata.ContentLength); // File size
+     * console.log(metadata.ContentType); // MIME type
+     * ```
+     */
+    getMetadata(bucket: string, key: string): Promise<S3FileMetadata>;
+    /**
+     * Delete a file from AWS S3
+     * @param bucket - Bucket name
+     * @param key - File key (path) in the bucket
+     * @returns Promise that resolves when deletion is complete
+     *
+     * @example
+     * ```typescript
+     * await AWSS3.delete('my-bucket', 'temp/old-file.txt');
+     * ```
+     */
+    delete(bucket: string, key: string): Promise<void>;
+    /**
+     * Generate a random file path with optional directory and extension
+     * Useful for creating unique file names
+     * @param options - Options for file destination generation
+     * @returns Generated file path
+     *
+     * @example
+     * ```typescript
+     * // Generate UUID only
+     * const path1 = AWSS3.generateFileDestination();
+     * // 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+     *
+     * // With directory and MIME type
+     * const path2 = AWSS3.generateFileDestination({
+     *   directory: 'uploads/images',
+     *   mime: 'image/jpeg'
+     * });
+     * // 'uploads/images/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpeg'
+     * ```
+     */
+    generateFileDestination(options?: S3UploadDestinationOptions): string;
+};

package/dist/entities/AWSS3/AWSS3.js

@@ -0,0 +1,426 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AWSS3 = void 0;
+var _crypto = require("crypto");
+var _clientS = require("@aws-sdk/client-s3");
+var _filesizeParser = _interopRequireDefault(require("filesize-parser"));
+var _mimeTypes = _interopRequireDefault(require("mime-types"));
+var _WebError = require("../WebError");
+var _report = require("../../utils/report");
+var _trimPathSlash = require("../../utils/trimPathSlash");
+const namespace = 'engine:aws-s3';
+
+/**
+ * Generic AWS S3 wrapper for easy file operations
+ * Provides methods for uploading, downloading, streaming, and deleting files
+ * Compatible with AWS S3 and S3-compatible services (MinIO, LocalStack, etc.)
+ * 
+ * @example
+ * ```typescript
+ * // Initialize with custom configuration
+ * AWSS3.init({
+ *   region: 'us-east-1',
+ *   accessKeyId: 'YOUR_ACCESS_KEY',
+ *   secretAccessKey: 'YOUR_SECRET_KEY'
+ * });
+ * 
+ * // Upload a file
+ * const result = await AWSS3.upload(
+ *   fileStream,
+ *   'my-bucket',
+ *   { directory: 'uploads', mime: 'image/png' }
+ * );
+ * 
+ * // Download a file
+ * const { data, metadata } = await AWSS3.get('my-bucket', 'uploads/file.png');
+ * 
+ * // Delete a file
+ * await AWSS3.delete('my-bucket', 'uploads/file.png');
+ * ```
+ */
+const AWSS3 = exports.AWSS3 = {
+  s3Client: null,
+  /**
+   * Initialize AWS S3 with configuration
+   * Call this method before using any other methods
+   * @param config - AWS S3 configuration options
+   */
+  init(config) {
+    const s3Config = {};
+    if (config) {
+      if (config.region) s3Config.region = config.region;
+      if (config.endpoint) s3Config.endpoint = config.endpoint;
+      if (config.forcePathStyle !== undefined) s3Config.forcePathStyle = config.forcePathStyle;
+      if (config.accessKeyId && config.secretAccessKey) {
+        s3Config.credentials = {
+          accessKeyId: config.accessKeyId,
+          secretAccessKey: config.secretAccessKey,
+          ...(config.sessionToken && {
+            sessionToken: config.sessionToken
+          })
+        };
+      }
+    } else {
+      // Use environment variables as fallback
+      if (process.env.AWS_REGION) s3Config.region = process.env.AWS_REGION;
+      if (process.env.AWS_S3_ENDPOINT) s3Config.endpoint = process.env.AWS_S3_ENDPOINT;
+      if (process.env.AWS_S3_FORCE_PATH_STYLE === 'true') s3Config.forcePathStyle = true;
+      if (process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY) {
+        s3Config.credentials = {
+          accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+          secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+          ...(process.env.AWS_SESSION_TOKEN && {
+            sessionToken: process.env.AWS_SESSION_TOKEN
+          })
+        };
+      }
+    }
+    this.s3Client = new _clientS.S3Client(s3Config);
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'AWS S3 initialized',
+      data: {
+        region: s3Config.region,
+        endpoint: s3Config.endpoint
+      }
+    });
+  },
+  /**
+   * Get the S3 client instance (auto-initializes if needed)
+   * @private
+   */
+  getS3Client() {
+    if (!this.s3Client) {
+      this.init();
+    }
+    return this.s3Client;
+  },
+  /**
+   * Upload a file to AWS S3
+   * @param readStream - Readable stream of the file content
+   * @param bucket - Bucket name where the file should be stored
+   * @param destinationOptions - Options for file destination (directory, fileName, etc.)
+   * @param uploaderOptions - Additional options like maxSize
+   * @param metadata - Optional metadata to attach to the file
+   * @returns Promise with file upload result
+   * 
+   * @example
+   * ```typescript
+   * const fileStream = fs.createReadStream('photo.jpg');
+   * const result = await AWSS3.upload(
+   *   fileStream,
+   *   'my-bucket',
+   *   { directory: 'photos', mime: 'image/jpeg' },
+   *   { maxSize: '5MB' },
+   *   { userId: '123', uploadedBy: 'user@example.com' }
+   * );
+   * console.log(result.Key); // photos/uuid.jpeg
+   * ```
+   */
+  async upload(readStream, bucket, destinationOptions = {}, uploaderOptions = {}, metadata) {
+    const client = this.getS3Client();
+    const {
+      maxSize
+    } = uploaderOptions;
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'Uploading file to S3',
+      data: {
+        bucket,
+        destinationOptions,
+        uploaderOptions
+      }
+    });
+
+    // Generate the file path
+    const {
+      fileName,
+      directory
+    } = destinationOptions;
+    let key;
+    if (fileName) {
+      const trimmedDirectory = (0, _trimPathSlash.trimPathSlash)(directory ?? '/');
+      key = trimmedDirectory ? `${trimmedDirectory}/${fileName}` : fileName;
+    } else {
+      key = this.generateFileDestination(destinationOptions);
+    }
+
+    // Collect stream data with size validation
+    const chunks = [];
+    let receivedSize = 0;
+    const intMaxSize = maxSize && (0, _filesizeParser.default)(maxSize);
+    for await (const chunk of readStream) {
+      receivedSize += chunk.length;
+      if (intMaxSize && receivedSize > intMaxSize) {
+        throw new _WebError.WebError({
+          statusCode: 413,
+          errorCode: 'file-too-large',
+          message: 'File size exceeds the maximum allowed limit',
+          hint: {
+            maxSize
+          },
+          data: {
+            bucket,
+            destinationOptions,
+            receivedSize,
+            maxSize
+          }
+        });
+      }
+      chunks.push(chunk);
+    }
+    const body = Buffer.concat(chunks);
+
+    // Determine content type
+    const contentType = destinationOptions.mime || 'application/octet-stream';
+    const command = new _clientS.PutObjectCommand({
+      Bucket: bucket,
+      Key: key,
+      Body: body,
+      ContentType: contentType,
+      ...(metadata && {
+        Metadata: metadata
+      })
+    });
+    const response = await client.send(command);
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'File uploaded to S3',
+      data: {
+        bucket,
+        key,
+        etag: response.ETag
+      }
+    });
+    return {
+      Bucket: bucket,
+      Key: key,
+      ETag: response.ETag,
+      Location: `https://${bucket}.s3.amazonaws.com/${key}`,
+      ServerSideEncryption: response.ServerSideEncryption,
+      VersionId: response.VersionId
+    };
+  },
+  /**
+   * Download a file from AWS S3 and return its content as Buffer
+   * @param bucket - Bucket name
+   * @param key - File key (path) in the bucket
+   * @returns Promise with file data and metadata
+   * 
+   * @example
+   * ```typescript
+   * const { data, metadata } = await AWSS3.get('my-bucket', 'photos/image.jpg');
+   * console.log(metadata.ContentLength); // File size in bytes
+   * console.log(data); // Buffer with file content
+   * ```
+   */
+  async get(bucket, key) {
+    const client = this.getS3Client();
+    const command = new _clientS.GetObjectCommand({
+      Bucket: bucket,
+      Key: key
+    });
+    const response = await client.send(command);
+
+    // Convert stream to buffer
+    const chunks = [];
+    for await (const chunk of response.Body) {
+      chunks.push(chunk);
+    }
+    const data = Buffer.concat(chunks);
+    const metadata = {
+      ContentType: response.ContentType,
+      ContentLength: response.ContentLength,
+      LastModified: response.LastModified,
+      ETag: response.ETag,
+      Metadata: response.Metadata,
+      ServerSideEncryption: response.ServerSideEncryption,
+      VersionId: response.VersionId
+    };
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'Downloaded file from S3',
+      data: {
+        bucket,
+        key,
+        size: data.length
+      }
+    });
+    return {
+      data,
+      metadata
+    };
+  },
+  /**
+   * Get a readable stream for a file from AWS S3
+   * Use this for large files or when you need to stream the content
+   * @param bucket - Bucket name
+   * @param key - File key (path) in the bucket
+   * @returns Promise with readable stream and metadata
+   * 
+   * @example
+   * ```typescript
+   * const { stream, metadata } = await AWSS3.download('my-bucket', 'videos/video.mp4');
+   * stream.pipe(res); // Stream to HTTP response
+   * ```
+   */
+  async download(bucket, key) {
+    const client = this.getS3Client();
+    const command = new _clientS.GetObjectCommand({
+      Bucket: bucket,
+      Key: key
+    });
+    const response = await client.send(command);
+    const metadata = {
+      ContentType: response.ContentType,
+      ContentLength: response.ContentLength,
+      LastModified: response.LastModified,
+      ETag: response.ETag,
+      Metadata: response.Metadata,
+      ServerSideEncryption: response.ServerSideEncryption,
+      VersionId: response.VersionId
+    };
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'Fetched file stream from S3',
+      data: {
+        bucket,
+        key,
+        metadata
+      }
+    });
+    return {
+      stream: response.Body,
+      metadata
+    };
+  },
+  /**
+   * Get a readable stream for a file (without fetching all metadata first)
+   * Use this when you don't need metadata and want faster streaming
+   * @param bucket - Bucket name
+   * @param key - File key (path) in the bucket
+   * @returns Promise with readable stream
+   * 
+   * @example
+   * ```typescript
+   * const stream = await AWSS3.getFileStream('my-bucket', 'audio/song.mp3');
+   * stream.pipe(res); // Direct streaming
+   * ```
+   */
+  async getFileStream(bucket, key) {
+    const client = this.getS3Client();
+    const command = new _clientS.GetObjectCommand({
+      Bucket: bucket,
+      Key: key
+    });
+    const response = await client.send(command);
+    (0, _report.reportDebug)({
+      namespace,
+      message: "Fetched file stream from S3's bucket",
+      data: {
+        bucket,
+        key
+      }
+    });
+    return response.Body;
+  },
+  /**
+   * Get file metadata without downloading the file
+   * @param bucket - Bucket name
+   * @param key - File key (path) in the bucket
+   * @returns Promise with file metadata
+   * 
+   * @example
+   * ```typescript
+   * const metadata = await AWSS3.getMetadata('my-bucket', 'photos/image.jpg');
+   * console.log(metadata.ContentLength); // File size
+   * console.log(metadata.ContentType); // MIME type
+   * ```
+   */
+  async getMetadata(bucket, key) {
+    const client = this.getS3Client();
+    const command = new _clientS.HeadObjectCommand({
+      Bucket: bucket,
+      Key: key
+    });
+    const response = await client.send(command);
+    return {
+      ContentType: response.ContentType,
+      ContentLength: response.ContentLength,
+      LastModified: response.LastModified,
+      ETag: response.ETag,
+      Metadata: response.Metadata,
+      ServerSideEncryption: response.ServerSideEncryption,
+      VersionId: response.VersionId
+    };
+  },
+  /**
+   * Delete a file from AWS S3
+   * @param bucket - Bucket name
+   * @param key - File key (path) in the bucket
+   * @returns Promise that resolves when deletion is complete
+   * 
+   * @example
+   * ```typescript
+   * await AWSS3.delete('my-bucket', 'temp/old-file.txt');
+   * ```
+   */
+  async delete(bucket, key) {
+    const client = this.getS3Client();
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'Deleting file from S3',
+      data: {
+        bucket,
+        key
+      }
+    });
+    const command = new _clientS.DeleteObjectCommand({
+      Bucket: bucket,
+      Key: key
+    });
+    await client.send(command);
+  },
+  /**
+   * Generate a random file path with optional directory and extension
+   * Useful for creating unique file names
+   * @param options - Options for file destination generation
+   * @returns Generated file path
+   * 
+   * @example
+   * ```typescript
+   * // Generate UUID only
+   * const path1 = AWSS3.generateFileDestination();
+   * // 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+   * 
+   * // With directory and MIME type
+   * const path2 = AWSS3.generateFileDestination({
+   *   directory: 'uploads/images',
+   *   mime: 'image/jpeg'
+   * });
+   * // 'uploads/images/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpeg'
+   * ```
+   */
+  generateFileDestination(options = {}) {
+    const {
+      directory = '/',
+      mime,
+      noExtension = false
+    } = options;
+
+    // Determine file extension from MIME type
+    const extension = mime && _mimeTypes.default.extension(mime) ? _mimeTypes.default.extension(mime) : undefined;
+
+    // Build the full name with or without extension
+    const fullName = extension && !noExtension ? `${(0, _crypto.randomUUID)()}.${extension}` : (0, _crypto.randomUUID)();
+
+    // Clean up directory path
+    const trimmedDirectory = (0, _trimPathSlash.trimPathSlash)(directory);
+    return `${trimmedDirectory ? `${trimmedDirectory}/` : ''}${fullName}`;
+  }
+};
+//# sourceMappingURL=AWSS3.js.map

package/dist/entities/AWSS3/AWSS3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AWSS3.js","names":["_crypto","require","_clientS","_filesizeParser","_interopRequireDefault","_mimeTypes","_WebError","_report","_trimPathSlash","namespace","AWSS3","exports","s3Client","init","config","s3Config","region","endpoint","forcePathStyle","undefined","accessKeyId","secretAccessKey","credentials","sessionToken","process","env","AWS_REGION","AWS_S3_ENDPOINT","AWS_S3_FORCE_PATH_STYLE","AWS_ACCESS_KEY_ID","AWS_SECRET_ACCESS_KEY","AWS_SESSION_TOKEN","S3Client","reportDebug","message","data","getS3Client","upload","readStream","bucket","destinationOptions","uploaderOptions","metadata","client","maxSize","fileName","directory","key","trimmedDirectory","trimPathSlash","generateFileDestination","chunks","receivedSize","intMaxSize","fileSizeParser","chunk","length","WebError","statusCode","errorCode","hint","push","body","Buffer","concat","contentType","mime","command","PutObjectCommand","Bucket","Key","Body","ContentType","Metadata","response","send","etag","ETag","Location","ServerSideEncryption","VersionId","get","GetObjectCommand","ContentLength","LastModified","size","download","stream","getFileStream","getMetadata","HeadObjectCommand","delete","DeleteObjectCommand","options","noExtension","extension","mimeTypes","fullName","randomUUID"],"sources":["../../../src/entities/AWSS3/AWSS3.ts"],"sourcesContent":["import { randomUUID } from 'crypto';\nimport { Readable } from 'stream';\nimport {\n  S3Client,\n  PutObjectCommand,\n  GetObjectCommand,\n  DeleteObjectCommand,\n  HeadObjectCommand,\n  S3ClientConfig\n} from '@aws-sdk/client-s3';\nimport fileSizeParser from 'filesize-parser';\nimport mimeTypes from 'mime-types';\nimport {\n  S3UploadDestinationOptions,\n  S3UploadedFile,\n  S3UploaderOptions,\n  S3GetResponse,\n  S3DownloadResponse,\n  AWSS3Config,\n  S3FileMetadata\n} from './AWSS3.types';\nimport { WebError } from 'entities/WebError';\nimport { reportDebug } from 'utils/report';\nimport { trimPathSlash } from 'utils/trimPathSlash';\n\nconst namespace = 'engine:aws-s3';\n\n/**\n * Generic AWS S3 wrapper for easy file operations\n * Provides methods for uploading, downloading, streaming, and deleting files\n * Compatible with AWS S3 and S3-compatible services (MinIO, LocalStack, etc.)\n * \n * @example\n * ```typescript\n * // Initialize with custom configuration\n * AWSS3.init({\n *   region: 'us-east-1',\n *   accessKeyId: 'YOUR_ACCESS_KEY',\n *   secretAccessKey: 'YOUR_SECRET_KEY'\n * });\n * \n * // Upload a file\n * const result = await AWSS3.upload(\n *   fileStream,\n *   'my-bucket',\n *   { directory: 'uploads', mime: 'image/png' }\n * );\n * \n * // Download a file\n * const { data, metadata } = await AWSS3.get('my-bucket', 'uploads/file.png');\n * \n * // Delete a file\n * await AWSS3.delete('my-bucket', 'uploads/file.png');\n * ```\n */\nexport const AWSS3 = {\n  s3Client: null as S3Client | null,\n\n  /**\n   * Initialize AWS S3 with configuration\n   * Call this method before using any other methods\n   * @param config - AWS S3 configuration options\n   */\n  init(config?: AWSS3Config): void {\n    const s3Config: S3ClientConfig = {};\n\n    if (config) {\n      if (config.region) s3Config.region = config.region;\n      if (config.endpoint) s3Config.endpoint = config.endpoint;\n      if (config.forcePathStyle !== undefined) s3Config.forcePathStyle = config.forcePathStyle;\n      \n      if (config.accessKeyId && config.secretAccessKey) {\n        s3Config.credentials = {\n          accessKeyId: config.accessKeyId,\n          secretAccessKey: config.secretAccessKey,\n          ...(config.sessionToken && { sessionToken: config.sessionToken })\n        };\n      }\n    } else {\n      // Use environment variables as fallback\n      if (process.env.AWS_REGION) s3Config.region = process.env.AWS_REGION;\n      if (process.env.AWS_S3_ENDPOINT) s3Config.endpoint = process.env.AWS_S3_ENDPOINT;\n      if (process.env.AWS_S3_FORCE_PATH_STYLE === 'true') s3Config.forcePathStyle = true;\n      \n      if (process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY) {\n        s3Config.credentials = {\n          accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n          secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n          ...(process.env.AWS_SESSION_TOKEN && { sessionToken: process.env.AWS_SESSION_TOKEN })\n        };\n      }\n    }\n\n    this.s3Client = new S3Client(s3Config);\n    reportDebug({\n      namespace,\n      message: 'AWS S3 initialized',\n      data: { region: s3Config.region, endpoint: s3Config.endpoint }\n    });\n  },\n\n  /**\n   * Get the S3 client instance (auto-initializes if needed)\n   * @private\n   */\n  getS3Client(): S3Client {\n    if (!this.s3Client) {\n      this.init();\n    }\n    return this.s3Client!;\n  },\n\n  /**\n   * Upload a file to AWS S3\n   * @param readStream - Readable stream of the file content\n   * @param bucket - Bucket name where the file should be stored\n   * @param destinationOptions - Options for file destination (directory, fileName, etc.)\n   * @param uploaderOptions - Additional options like maxSize\n   * @param metadata - Optional metadata to attach to the file\n   * @returns Promise with file upload result\n   * \n   * @example\n   * ```typescript\n   * const fileStream = fs.createReadStream('photo.jpg');\n   * const result = await AWSS3.upload(\n   *   fileStream,\n   *   'my-bucket',\n   *   { directory: 'photos', mime: 'image/jpeg' },\n   *   { maxSize: '5MB' },\n   *   { userId: '123', uploadedBy: 'user@example.com' }\n   * );\n   * console.log(result.Key); // photos/uuid.jpeg\n   * ```\n   */\n  async upload(\n    readStream: Readable,\n    bucket: string,\n    destinationOptions: S3UploadDestinationOptions = {},\n    uploaderOptions: S3UploaderOptions = {},\n    metadata?: Record<string, string>\n  ): Promise<S3UploadedFile> {\n    const client = this.getS3Client();\n    const { maxSize } = uploaderOptions;\n\n    reportDebug({\n      namespace,\n      message: 'Uploading file to S3',\n      data: { bucket, destinationOptions, uploaderOptions }\n    });\n\n    // Generate the file path\n    const { fileName, directory } = destinationOptions;\n\n    let key: string;\n    if (fileName) {\n      const trimmedDirectory = trimPathSlash(directory ?? '/');\n      key = trimmedDirectory ? `${trimmedDirectory}/${fileName}` : fileName;\n    } else {\n      key = this.generateFileDestination(destinationOptions);\n    }\n\n    // Collect stream data with size validation\n    const chunks: Buffer[] = [];\n    let receivedSize = 0;\n    const intMaxSize = maxSize && fileSizeParser(maxSize);\n\n    for await (const chunk of readStream) {\n      receivedSize += chunk.length;\n      \n      if (intMaxSize && receivedSize > intMaxSize) {\n        throw new WebError({\n          statusCode: 413,\n          errorCode: 'file-too-large',\n          message: 'File size exceeds the maximum allowed limit',\n          hint: { maxSize },\n          data: {\n            bucket,\n            destinationOptions,\n            receivedSize,\n            maxSize\n          }\n        });\n      }\n      \n      chunks.push(chunk);\n    }\n\n    const body = Buffer.concat(chunks);\n\n    // Determine content type\n    const contentType = destinationOptions.mime || 'application/octet-stream';\n\n    const command = new PutObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Body: body,\n      ContentType: contentType,\n      ...(metadata && { Metadata: metadata })\n    });\n\n    const response = await client.send(command);\n\n    reportDebug({\n      namespace,\n      message: 'File uploaded to S3',\n      data: { bucket, key, etag: response.ETag }\n    });\n\n    return {\n      Bucket: bucket,\n      Key: key,\n      ETag: response.ETag,\n      Location: `https://${bucket}.s3.amazonaws.com/${key}`,\n      ServerSideEncryption: response.ServerSideEncryption,\n      VersionId: response.VersionId\n    };\n  },\n\n  /**\n   * Download a file from AWS S3 and return its content as Buffer\n   * @param bucket - Bucket name\n   * @param key - File key (path) in the bucket\n   * @returns Promise with file data and metadata\n   * \n   * @example\n   * ```typescript\n   * const { data, metadata } = await AWSS3.get('my-bucket', 'photos/image.jpg');\n   * console.log(metadata.ContentLength); // File size in bytes\n   * console.log(data); // Buffer with file content\n   * ```\n   */\n  async get(bucket: string, key: string): Promise<S3GetResponse> {\n    const client = this.getS3Client();\n\n    const command = new GetObjectCommand({\n      Bucket: bucket,\n      Key: key\n    });\n\n    const response = await client.send(command);\n\n    // Convert stream to buffer\n    const chunks: Buffer[] = [];\n    for await (const chunk of response.Body as Readable) {\n      chunks.push(chunk);\n    }\n    const data = Buffer.concat(chunks);\n\n    const metadata: S3FileMetadata = {\n      ContentType: response.ContentType,\n      ContentLength: response.ContentLength,\n      LastModified: response.LastModified,\n      ETag: response.ETag,\n      Metadata: response.Metadata,\n      ServerSideEncryption: response.ServerSideEncryption,\n      VersionId: response.VersionId\n    };\n\n    reportDebug({\n      namespace,\n      message: 'Downloaded file from S3',\n      data: { bucket, key, size: data.length }\n    });\n\n    return { data, metadata };\n  },\n\n  /**\n   * Get a readable stream for a file from AWS S3\n   * Use this for large files or when you need to stream the content\n   * @param bucket - Bucket name\n   * @param key - File key (path) in the bucket\n   * @returns Promise with readable stream and metadata\n   * \n   * @example\n   * ```typescript\n   * const { stream, metadata } = await AWSS3.download('my-bucket', 'videos/video.mp4');\n   * stream.pipe(res); // Stream to HTTP response\n   * ```\n   */\n  async download(bucket: string, key: string): Promise<S3DownloadResponse> {\n    const client = this.getS3Client();\n\n    const command = new GetObjectCommand({\n      Bucket: bucket,\n      Key: key\n    });\n\n    const response = await client.send(command);\n\n    const metadata: S3FileMetadata = {\n      ContentType: response.ContentType,\n      ContentLength: response.ContentLength,\n      LastModified: response.LastModified,\n      ETag: response.ETag,\n      Metadata: response.Metadata,\n      ServerSideEncryption: response.ServerSideEncryption,\n      VersionId: response.VersionId\n    };\n\n    reportDebug({\n      namespace,\n      message: 'Fetched file stream from S3',\n      data: { bucket, key, metadata }\n    });\n\n    return {\n      stream: response.Body as Readable,\n      metadata\n    };\n  },\n\n  /**\n   * Get a readable stream for a file (without fetching all metadata first)\n   * Use this when you don't need metadata and want faster streaming\n   * @param bucket - Bucket name\n   * @param key - File key (path) in the bucket\n   * @returns Promise with readable stream\n   * \n   * @example\n   * ```typescript\n   * const stream = await AWSS3.getFileStream('my-bucket', 'audio/song.mp3');\n   * stream.pipe(res); // Direct streaming\n   * ```\n   */\n  async getFileStream(bucket: string, key: string): Promise<Readable> {\n    const client = this.getS3Client();\n\n    const command = new GetObjectCommand({\n      Bucket: bucket,\n      Key: key\n    });\n\n    const response = await client.send(command);\n\n    reportDebug({\n      namespace,\n      message: \"Fetched file stream from S3's bucket\",\n      data: { bucket, key }\n    });\n\n    return response.Body as Readable;\n  },\n\n  /**\n   * Get file metadata without downloading the file\n   * @param bucket - Bucket name\n   * @param key - File key (path) in the bucket\n   * @returns Promise with file metadata\n   * \n   * @example\n   * ```typescript\n   * const metadata = await AWSS3.getMetadata('my-bucket', 'photos/image.jpg');\n   * console.log(metadata.ContentLength); // File size\n   * console.log(metadata.ContentType); // MIME type\n   * ```\n   */\n  async getMetadata(bucket: string, key: string): Promise<S3FileMetadata> {\n    const client = this.getS3Client();\n\n    const command = new HeadObjectCommand({\n      Bucket: bucket,\n      Key: key\n    });\n\n    const response = await client.send(command);\n\n    return {\n      ContentType: response.ContentType,\n      ContentLength: response.ContentLength,\n      LastModified: response.LastModified,\n      ETag: response.ETag,\n      Metadata: response.Metadata,\n      ServerSideEncryption: response.ServerSideEncryption,\n      VersionId: response.VersionId\n    };\n  },\n\n  /**\n   * Delete a file from AWS S3\n   * @param bucket - Bucket name\n   * @param key - File key (path) in the bucket\n   * @returns Promise that resolves when deletion is complete\n   * \n   * @example\n   * ```typescript\n   * await AWSS3.delete('my-bucket', 'temp/old-file.txt');\n   * ```\n   */\n  async delete(bucket: string, key: string): Promise<void> {\n    const client = this.getS3Client();\n\n    reportDebug({\n      namespace,\n      message: 'Deleting file from S3',\n      data: { bucket, key }\n    });\n\n    const command = new DeleteObjectCommand({\n      Bucket: bucket,\n      Key: key\n    });\n\n    await client.send(command);\n  },\n\n  /**\n   * Generate a random file path with optional directory and extension\n   * Useful for creating unique file names\n   * @param options - Options for file destination generation\n   * @returns Generated file path\n   * \n   * @example\n   * ```typescript\n   * // Generate UUID only\n   * const path1 = AWSS3.generateFileDestination();\n   * // 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'\n   * \n   * // With directory and MIME type\n   * const path2 = AWSS3.generateFileDestination({\n   *   directory: 'uploads/images',\n   *   mime: 'image/jpeg'\n   * });\n   * // 'uploads/images/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpeg'\n   * ```\n   */\n  generateFileDestination(options: S3UploadDestinationOptions = {}): string {\n    const { directory = '/', mime, noExtension = false } = options;\n\n    // Determine file extension from MIME type\n    const extension =\n      mime && mimeTypes.extension(mime) ? mimeTypes.extension(mime) : undefined;\n    \n    // Build the full name with or without extension\n    const fullName =\n      extension && !noExtension ? `${randomUUID()}.${extension}` : randomUUID();\n    \n    // Clean up directory path\n    const trimmedDirectory = trimPathSlash(directory);\n    return `${trimmedDirectory ? `${trimmedDirectory}/` : ''}${fullName}`;\n  }\n};\n"],"mappings":"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","ignoreList":[]}