@hdriel/aws-utils 1.2.0 → 1.2.2

package/dist/index.cjs

@@ -89,7 +89,8 @@ __export(index_exports, {
   LambdaUtil: () => LambdaUtil,
   S3LocalstackUtil: () => S3LocalstackUtil,
   S3Util: () => S3Util,
-  SNSUtil: () => SNSUtil
+  SNSUtil: () => SNSUtil,
+  SUPPORTED_IFRAME_EXTENSIONS: () => SUPPORTED_IFRAME_EXTENSIONS
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -279,6 +280,7 @@ var import_archiver = __toESM(require("archiver"), 1);
 var import_node_stream2 = require("stream");
 var import_multer_s3 = __toESM(require("multer-s3"), 1);
 var import_multer = __toESM(require("multer"), 1);
+var import_p_limit = __toESM(require("p-limit"), 1);
 var import_client_s35 = require("@aws-sdk/client-s3");
 
 // src/utils/consts.ts
@@ -288,10 +290,91 @@ var ACLs = /* @__PURE__ */ ((ACLs2) => {
   ACLs2["publicReadWrite"] = "public-read-write";
   return ACLs2;
 })(ACLs || {});
-
-// src/utils/concurrency.ts
-var import_p_limit = __toESM(require("p-limit"), 1);
-var s3Limiter = (0, import_p_limit.default)(4);
+var SUPPORTED_IFRAME_EXTENSIONS = [
+  // Images
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "bmp",
+  "webp",
+  "svg",
+  "ico",
+  "tif",
+  "tiff",
+  "heic",
+  "heif",
+  "raw",
+  "cr2",
+  "nef",
+  "arw",
+  // Videos
+  "mp4",
+  "avi",
+  "mov",
+  "wmv",
+  "flv",
+  "mkv",
+  "webm",
+  "mpeg",
+  "mpg",
+  "m4v",
+  "3gp",
+  "ogv",
+  "ts",
+  "mts",
+  "m2ts",
+  // Documents
+  "pdf",
+  // Text
+  "txt",
+  "csv",
+  "json",
+  "xml",
+  "md",
+  "log",
+  "yaml",
+  "yml",
+  "ini",
+  "conf",
+  "cfg",
+  // Code
+  "js",
+  "ts",
+  "jsx",
+  "tsx",
+  "py",
+  "java",
+  "c",
+  "cpp",
+  "h",
+  "cs",
+  "php",
+  "rb",
+  "go",
+  "rs",
+  "swift",
+  "kt",
+  "scala",
+  // Audio
+  "mp3",
+  "wav",
+  "ogg",
+  "flac",
+  "aac",
+  "m4a",
+  "wma",
+  "aiff",
+  "ape",
+  "opus",
+  // Web
+  "html",
+  "htm",
+  "css",
+  "scss",
+  "sass",
+  "less"
+];
 
 // src/utils/helpers.ts
 var import_bytes = __toESM(require("bytes"), 1);
@@ -1110,7 +1193,7 @@ var S3File = class extends S3Directory {
       return url;
     });
   }
-  sizeOf(fileKey, unit) {
+  sizeOf(fileKey, unit = "b") {
     return __async(this, null, function* () {
       var _a2, _b, _c;
       const normalizedKey = getNormalizedPath(fileKey);
@@ -1232,15 +1315,16 @@ var S3File = class extends S3Directory {
 var pump = (0, import_util.promisify)(import_stream.pipeline);
 var S3Stream = class _S3Stream extends S3File {
   constructor(_a2) {
-    var _b = _a2, { maxUploadFileSizeRestriction = "10GB" } = _b, props = __objRest(_b, ["maxUploadFileSizeRestriction"]);
+    var _b = _a2, { maxUploadFileSizeRestriction = "10GB", concurrencyVideoLimit = 0 } = _b, props = __objRest(_b, ["maxUploadFileSizeRestriction", "concurrencyVideoLimit"]);
     super(props);
     __publicField(this, "maxUploadFileSizeRestriction");
+    __publicField(this, "s3Limiter");
     __publicField(this, "streamImageFileCtrl", ({
       fileKey: _fileKey,
       queryField = "file",
       paramsField = "file",
       headerField = "x-fileKey",
-      cachingAgeSeconds = "1y"
+      cachingAge: _cachingAge = "1y"
     } = {}) => {
       return (req, res, next) => __async(this, null, function* () {
         var _a2, _b, _c, _d, _e, _f, _g, _h;
@@ -1265,8 +1349,10 @@ var S3Stream = class _S3Stream extends S3File {
           const contentType = mimeTypeMap[ext] || "application/octet-stream";
           res.setHeader("Content-Type", contentType);
           res.setHeader("Content-Length", imageBuffer.length);
-          const cachingAge = !cachingAgeSeconds || typeof cachingAgeSeconds === "number" ? cachingAgeSeconds : getTotalSeconds(cachingAgeSeconds);
-          if (cachingAge) res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          const cachingAge = !_cachingAge || typeof _cachingAge === "number" ? _cachingAge : getTotalSeconds(_cachingAge);
+          if (cachingAge) {
+            res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          }
           res.status(200).send(imageBuffer);
         } catch (error) {
           (_h = this.logger) == null ? void 0 : _h.warn(req.id, "image fileKey not found", __spreadValues({
@@ -1276,19 +1362,20 @@ var S3Stream = class _S3Stream extends S3File {
         }
       });
     });
-    __publicField(this, "streamPdfFileCtrl", ({
+    __publicField(this, "streamBufferFileCtrl", ({
       fileKey: _fileKey,
+      filename: _filename,
       queryField = "file",
       paramsField = "file",
       headerField = "x-fileKey",
-      cachingAgeSeconds = "1y"
+      cachingAge: _cachingAge = "1h"
     } = {}) => {
       return (req, res, next) => __async(this, null, function* () {
         var _a2, _b, _c, _d, _e, _f, _g, _h;
         let fileKey = _fileKey || (((_a2 = req.params) == null ? void 0 : _a2[paramsField]) ? decodeURIComponent((_b = req.params) == null ? void 0 : _b[paramsField]) : void 0) || (((_c = req.query) == null ? void 0 : _c[queryField]) ? decodeURIComponent((_d = req.query) == null ? void 0 : _d[queryField]) : void 0) || (((_e = req.headers) == null ? void 0 : _e[headerField]) ? decodeURIComponent((_f = req.headers) == null ? void 0 : _f[headerField]) : void 0);
         if (!fileKey) {
-          (_g = this.logger) == null ? void 0 : _g.warn(req.id, "pdf fileKey is required");
-          next(Error("pdf fileKey is required"));
+          (_g = this.logger) == null ? void 0 : _g.warn(req.id, "iframe fileKey is required");
+          next(Error("iframe fileKey is required"));
           return;
         }
         try {
@@ -1305,12 +1392,14 @@ var S3Stream = class _S3Stream extends S3File {
             pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
           };
           const contentType = mimeTypeMap[ext] || "application/octet-stream";
-          const filename = (0, import_pathe2.basename)(fileKey);
+          const filename = _filename || (0, import_pathe2.basename)(fileKey);
           res.setHeader("Content-Type", contentType);
           res.setHeader("Content-Disposition", `inline; filename="${encodeURIComponent(filename)}"`);
-          res.setHeader("Content-Length", fileBuffer.length);
-          const cachingAge = !cachingAgeSeconds || typeof cachingAgeSeconds === "number" ? cachingAgeSeconds : getTotalSeconds(cachingAgeSeconds);
-          res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          res.setHeader("Content-Length", String(fileBuffer.length));
+          const cachingAge = !_cachingAge || typeof _cachingAge === "number" ? _cachingAge : getTotalSeconds(_cachingAge);
+          if (cachingAge) {
+            res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          }
           res.status(200).send(fileBuffer);
         } catch (error) {
           (_h = this.logger) == null ? void 0 : _h.warn(req.id, "pdf fileKey not found", __spreadValues({
@@ -1321,6 +1410,7 @@ var S3Stream = class _S3Stream extends S3File {
       });
     });
     this.maxUploadFileSizeRestriction = maxUploadFileSizeRestriction;
+    this.s3Limiter = concurrencyVideoLimit ? (0, import_p_limit.default)(concurrencyVideoLimit) : null;
   }
   streamObjectFile(_0) {
     return __async(this, arguments, function* (fileKey, {
@@ -1358,7 +1448,7 @@ var S3Stream = class _S3Stream extends S3File {
           Bucket: this.bucket,
           Key: normalizedKey
         }, Range ? { Range } : {}));
-        const data = yield s3Limiter(() => this.execute(cmd, { abortSignal }));
+        const data = this.s3Limiter ? yield this.s3Limiter(() => this.execute(cmd, { abortSignal })) : yield this.execute(cmd, { abortSignal });
         const body = data.Body;
         if (!body) return null;
         return {
@@ -1513,11 +1603,13 @@ var S3Stream = class _S3Stream extends S3File {
       forDownloading = false,
       paramsField = "file",
       queryField = "file",
-      headerField = "x-fileKey"
+      headerField = "x-fileKey",
+      streamMethod,
+      cachingAge: _cachingAge = "1h"
     } = {}) {
       return (req, res, next) => __async(this, null, function* () {
         var _a2, _b, _c, _d, _e, _f, _g, _h, _i;
-        let fileKey = _fileKey || (((_a2 = req.params) == null ? void 0 : _a2[paramsField]) ? (_b = req.params) == null ? void 0 : _b[paramsField] : void 0) || (((_c = req.query) == null ? void 0 : _c[queryField]) ? (_d = req.query) == null ? void 0 : _d[queryField] : void 0) || (((_e = req.headers) == null ? void 0 : _e[headerField]) ? decodeURIComponent((_f = req.headers) == null ? void 0 : _f[headerField]) : void 0);
+        const fileKey = _fileKey || (((_a2 = req.params) == null ? void 0 : _a2[paramsField]) ? (_b = req.params) == null ? void 0 : _b[paramsField] : void 0) || (((_c = req.query) == null ? void 0 : _c[queryField]) ? (_d = req.query) == null ? void 0 : _d[queryField] : void 0) || (((_e = req.headers) == null ? void 0 : _e[headerField]) ? decodeURIComponent((_f = req.headers) == null ? void 0 : _f[headerField]) : void 0);
         if (!fileKey || fileKey === "/") {
           (_g = this.logger) == null ? void 0 : _g.warn(req.id, "fileKey stream is required");
           next(Error("fileKey stream is required"));
@@ -1551,13 +1643,23 @@ var S3Stream = class _S3Stream extends S3File {
           }
           const fileInfo = yield this.fileInfo(normalizedKey);
           const fileName = filename || normalizedKey.split("/").pop() || "download";
-          res.setHeader("Content-Type", fileInfo.ContentType || "application/octet-stream");
-          if (forDownloading) {
-            res.setHeader("Content-Disposition", `attachment; filename="${encodeURIComponent(fileName)}"`);
-          }
+          const contentType = fileInfo.ContentType || "application/octet-stream";
+          const ext = (0, import_pathe2.extname)(fileKey).slice(1).toLowerCase();
+          const inlineTypes = ["text/", "image/", "application/pdf", "video/", "audio/"];
+          const canDisplayInline = SUPPORTED_IFRAME_EXTENSIONS.includes(ext) || inlineTypes.some((type) => contentType.startsWith(type));
+          res.setHeader("Content-Type", contentType);
           if (fileInfo.ContentLength) {
             res.setHeader("Content-Length", String(fileInfo.ContentLength));
           }
+          if (forDownloading || !canDisplayInline) {
+            res.setHeader("Content-Disposition", `attachment; filename="${encodeURIComponent(fileName)}"`);
+          } else {
+            res.setHeader("Content-Disposition", `inline; filename="${encodeURIComponent(fileName)}"`);
+          }
+          const cachingAge = !_cachingAge || typeof _cachingAge === "number" ? _cachingAge : getTotalSeconds(_cachingAge);
+          if (cachingAge) {
+            res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          }
           stream.on("error", (err) => {
             var _a3, _b2;
             (_a3 = this.logger) == null ? void 0 : _a3.warn(this.reqId, "Stream error", { fileKey: normalizedKey, error: err });
@@ -1569,7 +1671,12 @@ var S3Stream = class _S3Stream extends S3File {
             (_a3 = stream == null ? void 0 : stream.destroy) == null ? void 0 : _a3.call(stream);
             req.off("close", onClose);
           });
-          yield pump(stream, res);
+          streamMethod || (streamMethod = canDisplayInline ? "pipe" : "pipeline");
+          if (streamMethod === "pipeline") {
+            yield pump(stream, res);
+          } else {
+            stream.pipe(res);
+          }
           req.off("close", onClose);
         } catch (error) {
           abort.abort();
@@ -1785,6 +1892,7 @@ var S3Stream = class _S3Stream extends S3File {
         }),
         key: (req, file, cb) => __async(this, null, function* () {
           let filename;
+          file.originalname = decodeURIComponent(file.originalname);
           if (typeof _filename === "function") {
             filename = yield _filename(req, file);
           } else if (_filename) {
@@ -1896,6 +2004,14 @@ var S3Stream = class _S3Stream extends S3File {
    * Middleware for uploading multiple files with different field names
    * Adds the uploaded files info to req.s3FilesByField
    */
+  /*
+  example
+  uploadFieldsFiles([
+      { name: 'cardPosterSrc', maxCount: 1 },
+      { name: 'sectionPosterSrc', maxCount: 1 },
+      { name: 'imageSrc', maxCount: 1 },
+  ]) as any,
+  */
   // uploadFieldsFiles(
   //     fields: Array<{ name: string; directory: string; maxCount?: number; options?: S3UploadOptions }>
   // ): RequestHandler {
@@ -2083,5 +2199,6 @@ var SNSUtil = class {
   LambdaUtil,
   S3LocalstackUtil,
   S3Util,
-  SNSUtil
+  SNSUtil,
+  SUPPORTED_IFRAME_EXTENSIONS
 });

package/dist/index.d.cts

@@ -76,6 +76,7 @@ declare enum ACLs {
     publicRead = "public-read",
     publicReadWrite = "public-read-write"
 }
+declare const SUPPORTED_IFRAME_EXTENSIONS: string[];
 
 interface ContentFile {
     Key: string;
@@ -263,7 +264,7 @@ declare class S3File extends S3Directory {
     taggingFile(fileKey: string, tag: Tag | Tag[]): Promise<boolean>;
     fileVersion(fileKey: string): Promise<string>;
     fileUrl(fileKey: string, expiresIn?: number | StringValue): Promise<string>;
-    sizeOf(fileKey: string, unit: Unit): Promise<number>;
+    sizeOf(fileKey: string, unit?: Unit): Promise<number>;
     fileExists(fileKey: string): Promise<boolean>;
     fileContent(fileKey: string, format?: 'buffer' | 'base64' | 'utf8'): Promise<Buffer | string>;
     uploadFileContent(fileKey: string, fileData: Buffer | Readable | string | Uint8Array | object, { acl, version, prettier, }?: {
@@ -276,10 +277,12 @@ declare class S3File extends S3Directory {
 
 type S3StreamProps = S3FileProps & {
     maxUploadFileSizeRestriction?: ByteUnitStringValue;
+    concurrencyVideoLimit?: number | null;
 };
 declare class S3Stream extends S3File {
     private readonly maxUploadFileSizeRestriction;
-    constructor({ maxUploadFileSizeRestriction, ...props }: S3StreamProps);
+    private readonly s3Limiter;
+    constructor({ maxUploadFileSizeRestriction, concurrencyVideoLimit, ...props }: S3StreamProps);
     protected streamObjectFile(fileKey: string, { Range, checkFileExists, abortSignal, }?: {
         Range?: string;
         checkFileExists?: boolean;
@@ -309,27 +312,30 @@ declare class S3Stream extends S3File {
         headerField?: string;
         streamTimeoutMS?: number | undefined;
     }): Promise<(req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<any>>;
-    streamImageFileCtrl: ({ fileKey: _fileKey, queryField, paramsField, headerField, cachingAgeSeconds, }?: {
+    streamImageFileCtrl: ({ fileKey: _fileKey, queryField, paramsField, headerField, cachingAge: _cachingAge, }?: {
         fileKey?: string;
         queryField?: string;
         paramsField?: string;
         headerField?: string;
-        cachingAgeSeconds?: null | number | StringValue;
+        cachingAge?: null | number | StringValue;
     }) => (req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<void>;
-    streamPdfFileCtrl: ({ fileKey: _fileKey, queryField, paramsField, headerField, cachingAgeSeconds, }?: {
+    streamBufferFileCtrl: ({ fileKey: _fileKey, filename: _filename, queryField, paramsField, headerField, cachingAge: _cachingAge, }?: {
         fileKey?: string;
+        filename?: string;
         queryField?: string;
         paramsField?: string;
         headerField?: string;
-        cachingAgeSeconds?: null | number | StringValue;
+        cachingAge?: null | number | StringValue;
     }) => (req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<void>;
-    streamFileCtrl({ fileKey: _fileKey, filename, forDownloading, paramsField, queryField, headerField, }?: {
+    streamFileCtrl({ fileKey: _fileKey, filename, forDownloading, paramsField, queryField, headerField, streamMethod, cachingAge: _cachingAge, }?: {
         fileKey?: string;
         filename?: string;
         forDownloading?: boolean;
         paramsField?: string;
         queryField?: string;
         headerField?: string;
+        cachingAge?: null | number | StringValue;
+        streamMethod?: 'pipe' | 'pipeline';
     }): Promise<(req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<void>>;
     streamZipFileCtr({ fileKey: _fileKey, filename: _filename, queryField, paramsField, headerField, compressionLevel, }?: {
         filename?: string;
@@ -420,4 +426,4 @@ declare class AWSConfigSharingUtil {
     };
 }
 
-export { ACLs, AWSConfigSharingUtil, type BucketInfo, type FILE_EXT, type FILE_TYPE, IAMUtil, LambdaUtil, S3LocalstackUtil, S3Util, type S3UtilProps, SNSUtil, type TreeDirectoryItem, type TreeFileItem, type UploadedS3File };
+export { ACLs, AWSConfigSharingUtil, type BucketInfo, type FILE_EXT, type FILE_TYPE, IAMUtil, LambdaUtil, S3LocalstackUtil, S3Util, type S3UtilProps, SNSUtil, SUPPORTED_IFRAME_EXTENSIONS, type TreeDirectoryItem, type TreeFileItem, type UploadedS3File };

package/dist/index.d.ts

@@ -76,6 +76,7 @@ declare enum ACLs {
     publicRead = "public-read",
     publicReadWrite = "public-read-write"
 }
+declare const SUPPORTED_IFRAME_EXTENSIONS: string[];
 
 interface ContentFile {
     Key: string;
@@ -263,7 +264,7 @@ declare class S3File extends S3Directory {
     taggingFile(fileKey: string, tag: Tag | Tag[]): Promise<boolean>;
     fileVersion(fileKey: string): Promise<string>;
     fileUrl(fileKey: string, expiresIn?: number | StringValue): Promise<string>;
-    sizeOf(fileKey: string, unit: Unit): Promise<number>;
+    sizeOf(fileKey: string, unit?: Unit): Promise<number>;
     fileExists(fileKey: string): Promise<boolean>;
     fileContent(fileKey: string, format?: 'buffer' | 'base64' | 'utf8'): Promise<Buffer | string>;
     uploadFileContent(fileKey: string, fileData: Buffer | Readable | string | Uint8Array | object, { acl, version, prettier, }?: {
@@ -276,10 +277,12 @@ declare class S3File extends S3Directory {
 
 type S3StreamProps = S3FileProps & {
     maxUploadFileSizeRestriction?: ByteUnitStringValue;
+    concurrencyVideoLimit?: number | null;
 };
 declare class S3Stream extends S3File {
     private readonly maxUploadFileSizeRestriction;
-    constructor({ maxUploadFileSizeRestriction, ...props }: S3StreamProps);
+    private readonly s3Limiter;
+    constructor({ maxUploadFileSizeRestriction, concurrencyVideoLimit, ...props }: S3StreamProps);
     protected streamObjectFile(fileKey: string, { Range, checkFileExists, abortSignal, }?: {
         Range?: string;
         checkFileExists?: boolean;
@@ -309,27 +312,30 @@ declare class S3Stream extends S3File {
         headerField?: string;
         streamTimeoutMS?: number | undefined;
     }): Promise<(req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<any>>;
-    streamImageFileCtrl: ({ fileKey: _fileKey, queryField, paramsField, headerField, cachingAgeSeconds, }?: {
+    streamImageFileCtrl: ({ fileKey: _fileKey, queryField, paramsField, headerField, cachingAge: _cachingAge, }?: {
         fileKey?: string;
         queryField?: string;
         paramsField?: string;
         headerField?: string;
-        cachingAgeSeconds?: null | number | StringValue;
+        cachingAge?: null | number | StringValue;
     }) => (req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<void>;
-    streamPdfFileCtrl: ({ fileKey: _fileKey, queryField, paramsField, headerField, cachingAgeSeconds, }?: {
+    streamBufferFileCtrl: ({ fileKey: _fileKey, filename: _filename, queryField, paramsField, headerField, cachingAge: _cachingAge, }?: {
         fileKey?: string;
+        filename?: string;
         queryField?: string;
         paramsField?: string;
         headerField?: string;
-        cachingAgeSeconds?: null | number | StringValue;
+        cachingAge?: null | number | StringValue;
     }) => (req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<void>;
-    streamFileCtrl({ fileKey: _fileKey, filename, forDownloading, paramsField, queryField, headerField, }?: {
+    streamFileCtrl({ fileKey: _fileKey, filename, forDownloading, paramsField, queryField, headerField, streamMethod, cachingAge: _cachingAge, }?: {
         fileKey?: string;
         filename?: string;
         forDownloading?: boolean;
         paramsField?: string;
         queryField?: string;
         headerField?: string;
+        cachingAge?: null | number | StringValue;
+        streamMethod?: 'pipe' | 'pipeline';
     }): Promise<(req: Request$1 & any, res: Response & any, next: NextFunction & any) => Promise<void>>;
     streamZipFileCtr({ fileKey: _fileKey, filename: _filename, queryField, paramsField, headerField, compressionLevel, }?: {
         filename?: string;
@@ -420,4 +426,4 @@ declare class AWSConfigSharingUtil {
     };
 }
 
-export { ACLs, AWSConfigSharingUtil, type BucketInfo, type FILE_EXT, type FILE_TYPE, IAMUtil, LambdaUtil, S3LocalstackUtil, S3Util, type S3UtilProps, SNSUtil, type TreeDirectoryItem, type TreeFileItem, type UploadedS3File };
+export { ACLs, AWSConfigSharingUtil, type BucketInfo, type FILE_EXT, type FILE_TYPE, IAMUtil, LambdaUtil, S3LocalstackUtil, S3Util, type S3UtilProps, SNSUtil, SUPPORTED_IFRAME_EXTENSIONS, type TreeDirectoryItem, type TreeFileItem, type UploadedS3File };

package/dist/index.js

@@ -240,6 +240,7 @@ import archiver from "archiver";
 import { Readable as Readable2 } from "stream";
 import multerS3 from "multer-s3";
 import multer from "multer";
+import pLimit from "p-limit";
 import { GetObjectCommand as GetObjectCommand2 } from "@aws-sdk/client-s3";
 
 // src/utils/consts.ts
@@ -249,10 +250,91 @@ var ACLs = /* @__PURE__ */ ((ACLs2) => {
   ACLs2["publicReadWrite"] = "public-read-write";
   return ACLs2;
 })(ACLs || {});
-
-// src/utils/concurrency.ts
-import pLimit from "p-limit";
-var s3Limiter = pLimit(4);
+var SUPPORTED_IFRAME_EXTENSIONS = [
+  // Images
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "bmp",
+  "webp",
+  "svg",
+  "ico",
+  "tif",
+  "tiff",
+  "heic",
+  "heif",
+  "raw",
+  "cr2",
+  "nef",
+  "arw",
+  // Videos
+  "mp4",
+  "avi",
+  "mov",
+  "wmv",
+  "flv",
+  "mkv",
+  "webm",
+  "mpeg",
+  "mpg",
+  "m4v",
+  "3gp",
+  "ogv",
+  "ts",
+  "mts",
+  "m2ts",
+  // Documents
+  "pdf",
+  // Text
+  "txt",
+  "csv",
+  "json",
+  "xml",
+  "md",
+  "log",
+  "yaml",
+  "yml",
+  "ini",
+  "conf",
+  "cfg",
+  // Code
+  "js",
+  "ts",
+  "jsx",
+  "tsx",
+  "py",
+  "java",
+  "c",
+  "cpp",
+  "h",
+  "cs",
+  "php",
+  "rb",
+  "go",
+  "rs",
+  "swift",
+  "kt",
+  "scala",
+  // Audio
+  "mp3",
+  "wav",
+  "ogg",
+  "flac",
+  "aac",
+  "m4a",
+  "wma",
+  "aiff",
+  "ape",
+  "opus",
+  // Web
+  "html",
+  "htm",
+  "css",
+  "scss",
+  "sass",
+  "less"
+];
 
 // src/utils/helpers.ts
 import bytes from "bytes";
@@ -1099,7 +1181,7 @@ var S3File = class extends S3Directory {
       return url;
     });
   }
-  sizeOf(fileKey, unit) {
+  sizeOf(fileKey, unit = "b") {
     return __async(this, null, function* () {
       var _a2, _b, _c;
       const normalizedKey = getNormalizedPath(fileKey);
@@ -1221,15 +1303,16 @@ var S3File = class extends S3Directory {
 var pump = promisify(pipeline);
 var S3Stream = class _S3Stream extends S3File {
   constructor(_a2) {
-    var _b = _a2, { maxUploadFileSizeRestriction = "10GB" } = _b, props = __objRest(_b, ["maxUploadFileSizeRestriction"]);
+    var _b = _a2, { maxUploadFileSizeRestriction = "10GB", concurrencyVideoLimit = 0 } = _b, props = __objRest(_b, ["maxUploadFileSizeRestriction", "concurrencyVideoLimit"]);
     super(props);
     __publicField(this, "maxUploadFileSizeRestriction");
+    __publicField(this, "s3Limiter");
     __publicField(this, "streamImageFileCtrl", ({
       fileKey: _fileKey,
       queryField = "file",
       paramsField = "file",
       headerField = "x-fileKey",
-      cachingAgeSeconds = "1y"
+      cachingAge: _cachingAge = "1y"
     } = {}) => {
       return (req, res, next) => __async(this, null, function* () {
         var _a2, _b, _c, _d, _e, _f, _g, _h;
@@ -1254,8 +1337,10 @@ var S3Stream = class _S3Stream extends S3File {
           const contentType = mimeTypeMap[ext] || "application/octet-stream";
           res.setHeader("Content-Type", contentType);
           res.setHeader("Content-Length", imageBuffer.length);
-          const cachingAge = !cachingAgeSeconds || typeof cachingAgeSeconds === "number" ? cachingAgeSeconds : getTotalSeconds(cachingAgeSeconds);
-          if (cachingAge) res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          const cachingAge = !_cachingAge || typeof _cachingAge === "number" ? _cachingAge : getTotalSeconds(_cachingAge);
+          if (cachingAge) {
+            res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          }
           res.status(200).send(imageBuffer);
         } catch (error) {
           (_h = this.logger) == null ? void 0 : _h.warn(req.id, "image fileKey not found", __spreadValues({
@@ -1265,19 +1350,20 @@ var S3Stream = class _S3Stream extends S3File {
         }
       });
     });
-    __publicField(this, "streamPdfFileCtrl", ({
+    __publicField(this, "streamBufferFileCtrl", ({
       fileKey: _fileKey,
+      filename: _filename,
       queryField = "file",
       paramsField = "file",
       headerField = "x-fileKey",
-      cachingAgeSeconds = "1y"
+      cachingAge: _cachingAge = "1h"
     } = {}) => {
       return (req, res, next) => __async(this, null, function* () {
         var _a2, _b, _c, _d, _e, _f, _g, _h;
         let fileKey = _fileKey || (((_a2 = req.params) == null ? void 0 : _a2[paramsField]) ? decodeURIComponent((_b = req.params) == null ? void 0 : _b[paramsField]) : void 0) || (((_c = req.query) == null ? void 0 : _c[queryField]) ? decodeURIComponent((_d = req.query) == null ? void 0 : _d[queryField]) : void 0) || (((_e = req.headers) == null ? void 0 : _e[headerField]) ? decodeURIComponent((_f = req.headers) == null ? void 0 : _f[headerField]) : void 0);
         if (!fileKey) {
-          (_g = this.logger) == null ? void 0 : _g.warn(req.id, "pdf fileKey is required");
-          next(Error("pdf fileKey is required"));
+          (_g = this.logger) == null ? void 0 : _g.warn(req.id, "iframe fileKey is required");
+          next(Error("iframe fileKey is required"));
           return;
         }
         try {
@@ -1294,12 +1380,14 @@ var S3Stream = class _S3Stream extends S3File {
             pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
           };
           const contentType = mimeTypeMap[ext] || "application/octet-stream";
-          const filename = basename2(fileKey);
+          const filename = _filename || basename2(fileKey);
           res.setHeader("Content-Type", contentType);
           res.setHeader("Content-Disposition", `inline; filename="${encodeURIComponent(filename)}"`);
-          res.setHeader("Content-Length", fileBuffer.length);
-          const cachingAge = !cachingAgeSeconds || typeof cachingAgeSeconds === "number" ? cachingAgeSeconds : getTotalSeconds(cachingAgeSeconds);
-          res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          res.setHeader("Content-Length", String(fileBuffer.length));
+          const cachingAge = !_cachingAge || typeof _cachingAge === "number" ? _cachingAge : getTotalSeconds(_cachingAge);
+          if (cachingAge) {
+            res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          }
           res.status(200).send(fileBuffer);
         } catch (error) {
           (_h = this.logger) == null ? void 0 : _h.warn(req.id, "pdf fileKey not found", __spreadValues({
@@ -1310,6 +1398,7 @@ var S3Stream = class _S3Stream extends S3File {
       });
     });
     this.maxUploadFileSizeRestriction = maxUploadFileSizeRestriction;
+    this.s3Limiter = concurrencyVideoLimit ? pLimit(concurrencyVideoLimit) : null;
   }
   streamObjectFile(_0) {
     return __async(this, arguments, function* (fileKey, {
@@ -1347,7 +1436,7 @@ var S3Stream = class _S3Stream extends S3File {
           Bucket: this.bucket,
           Key: normalizedKey
         }, Range ? { Range } : {}));
-        const data = yield s3Limiter(() => this.execute(cmd, { abortSignal }));
+        const data = this.s3Limiter ? yield this.s3Limiter(() => this.execute(cmd, { abortSignal })) : yield this.execute(cmd, { abortSignal });
         const body = data.Body;
         if (!body) return null;
         return {
@@ -1502,11 +1591,13 @@ var S3Stream = class _S3Stream extends S3File {
       forDownloading = false,
       paramsField = "file",
       queryField = "file",
-      headerField = "x-fileKey"
+      headerField = "x-fileKey",
+      streamMethod,
+      cachingAge: _cachingAge = "1h"
     } = {}) {
       return (req, res, next) => __async(this, null, function* () {
         var _a2, _b, _c, _d, _e, _f, _g, _h, _i;
-        let fileKey = _fileKey || (((_a2 = req.params) == null ? void 0 : _a2[paramsField]) ? (_b = req.params) == null ? void 0 : _b[paramsField] : void 0) || (((_c = req.query) == null ? void 0 : _c[queryField]) ? (_d = req.query) == null ? void 0 : _d[queryField] : void 0) || (((_e = req.headers) == null ? void 0 : _e[headerField]) ? decodeURIComponent((_f = req.headers) == null ? void 0 : _f[headerField]) : void 0);
+        const fileKey = _fileKey || (((_a2 = req.params) == null ? void 0 : _a2[paramsField]) ? (_b = req.params) == null ? void 0 : _b[paramsField] : void 0) || (((_c = req.query) == null ? void 0 : _c[queryField]) ? (_d = req.query) == null ? void 0 : _d[queryField] : void 0) || (((_e = req.headers) == null ? void 0 : _e[headerField]) ? decodeURIComponent((_f = req.headers) == null ? void 0 : _f[headerField]) : void 0);
         if (!fileKey || fileKey === "/") {
           (_g = this.logger) == null ? void 0 : _g.warn(req.id, "fileKey stream is required");
           next(Error("fileKey stream is required"));
@@ -1540,13 +1631,23 @@ var S3Stream = class _S3Stream extends S3File {
           }
           const fileInfo = yield this.fileInfo(normalizedKey);
           const fileName = filename || normalizedKey.split("/").pop() || "download";
-          res.setHeader("Content-Type", fileInfo.ContentType || "application/octet-stream");
-          if (forDownloading) {
-            res.setHeader("Content-Disposition", `attachment; filename="${encodeURIComponent(fileName)}"`);
-          }
+          const contentType = fileInfo.ContentType || "application/octet-stream";
+          const ext = extname(fileKey).slice(1).toLowerCase();
+          const inlineTypes = ["text/", "image/", "application/pdf", "video/", "audio/"];
+          const canDisplayInline = SUPPORTED_IFRAME_EXTENSIONS.includes(ext) || inlineTypes.some((type) => contentType.startsWith(type));
+          res.setHeader("Content-Type", contentType);
           if (fileInfo.ContentLength) {
             res.setHeader("Content-Length", String(fileInfo.ContentLength));
           }
+          if (forDownloading || !canDisplayInline) {
+            res.setHeader("Content-Disposition", `attachment; filename="${encodeURIComponent(fileName)}"`);
+          } else {
+            res.setHeader("Content-Disposition", `inline; filename="${encodeURIComponent(fileName)}"`);
+          }
+          const cachingAge = !_cachingAge || typeof _cachingAge === "number" ? _cachingAge : getTotalSeconds(_cachingAge);
+          if (cachingAge) {
+            res.setHeader("Cache-Control", `public, max-age=${cachingAge}`);
+          }
           stream.on("error", (err) => {
             var _a3, _b2;
             (_a3 = this.logger) == null ? void 0 : _a3.warn(this.reqId, "Stream error", { fileKey: normalizedKey, error: err });
@@ -1558,7 +1659,12 @@ var S3Stream = class _S3Stream extends S3File {
             (_a3 = stream == null ? void 0 : stream.destroy) == null ? void 0 : _a3.call(stream);
             req.off("close", onClose);
           });
-          yield pump(stream, res);
+          streamMethod || (streamMethod = canDisplayInline ? "pipe" : "pipeline");
+          if (streamMethod === "pipeline") {
+            yield pump(stream, res);
+          } else {
+            stream.pipe(res);
+          }
           req.off("close", onClose);
         } catch (error) {
           abort.abort();
@@ -1774,6 +1880,7 @@ var S3Stream = class _S3Stream extends S3File {
         }),
         key: (req, file, cb) => __async(this, null, function* () {
           let filename;
+          file.originalname = decodeURIComponent(file.originalname);
           if (typeof _filename === "function") {
             filename = yield _filename(req, file);
           } else if (_filename) {
@@ -1885,6 +1992,14 @@ var S3Stream = class _S3Stream extends S3File {
    * Middleware for uploading multiple files with different field names
    * Adds the uploaded files info to req.s3FilesByField
    */
+  /*
+  example
+  uploadFieldsFiles([
+      { name: 'cardPosterSrc', maxCount: 1 },
+      { name: 'sectionPosterSrc', maxCount: 1 },
+      { name: 'imageSrc', maxCount: 1 },
+  ]) as any,
+  */
   // uploadFieldsFiles(
   //     fields: Array<{ name: string; directory: string; maxCount?: number; options?: S3UploadOptions }>
   // ): RequestHandler {
@@ -2071,5 +2186,6 @@ export {
   LambdaUtil,
   S3LocalstackUtil,
   S3Util,
-  SNSUtil
+  SNSUtil,
+  SUPPORTED_IFRAME_EXTENSIONS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hdriel/aws-utils",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Simplified AWS SDK (v3) utilities for S3 (upload, download, streaming) with TypeScript support",
   "author": "Hadriel Benjo (https://github.com/hdriel)",
   "type": "module",