@ackplus/nest-file-storage 1.1.22 → 2.0.0

package/dist/lib/validation.d.ts

@@ -0,0 +1,22 @@
+import { BadRequestException } from '@nestjs/common';
+import type { Options as MulterOptions } from 'multer';
+export interface UploadValidation {
+    maxSize?: number;
+    allowedMimeTypes?: string[];
+    allowedExtensions?: string[];
+    maxFiles?: number;
+    fileFilter?: MulterOptions['fileFilter'];
+}
+export declare class FileTooLargeException extends BadRequestException {
+    constructor(maxSize?: number);
+}
+export declare class InvalidFileTypeException extends BadRequestException {
+    constructor(received: string, allowed: string[]);
+}
+export declare class TooManyFilesException extends BadRequestException {
+    constructor(maxFiles?: number);
+}
+export declare function mergeValidation(base?: UploadValidation, override?: UploadValidation): UploadValidation;
+export declare function toMulterLimits(validation?: UploadValidation): MulterOptions['limits'] | undefined;
+export declare function buildFileFilter(validation?: UploadValidation): MulterOptions['fileFilter'] | undefined;
+export declare function formatBytes(bytes: number): string;

package/dist/lib/validation.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TooManyFilesException = exports.InvalidFileTypeException = exports.FileTooLargeException = void 0;
+exports.mergeValidation = mergeValidation;
+exports.toMulterLimits = toMulterLimits;
+exports.buildFileFilter = buildFileFilter;
+exports.formatBytes = formatBytes;
+const common_1 = require("@nestjs/common");
+const path_1 = require("path");
+class FileTooLargeException extends common_1.BadRequestException {
+    constructor(maxSize) {
+        super(maxSize
+            ? `File exceeds the maximum allowed size of ${formatBytes(maxSize)}.`
+            : 'File exceeds the maximum allowed size.');
+    }
+}
+exports.FileTooLargeException = FileTooLargeException;
+class InvalidFileTypeException extends common_1.BadRequestException {
+    constructor(received, allowed) {
+        super(`File type "${received}" is not allowed. Allowed: ${allowed.join(', ')}.`);
+    }
+}
+exports.InvalidFileTypeException = InvalidFileTypeException;
+class TooManyFilesException extends common_1.BadRequestException {
+    constructor(maxFiles) {
+        super(maxFiles
+            ? `Too many files. A maximum of ${maxFiles} file(s) is allowed.`
+            : 'Too many files uploaded.');
+    }
+}
+exports.TooManyFilesException = TooManyFilesException;
+function mergeValidation(base, override) {
+    return { ...(base ?? {}), ...(override ?? {}) };
+}
+function toMulterLimits(validation) {
+    if (!validation)
+        return undefined;
+    const limits = {};
+    if (validation.maxSize != null)
+        limits.fileSize = validation.maxSize;
+    if (validation.maxFiles != null)
+        limits.files = validation.maxFiles;
+    return Object.keys(limits).length > 0 ? limits : undefined;
+}
+function matchesMime(mime, patterns) {
+    const value = (mime || '').toLowerCase();
+    return patterns.some((pattern) => {
+        const p = pattern.toLowerCase().trim();
+        if (p === '*' || p === '*/*')
+            return true;
+        if (p.endsWith('/*'))
+            return value.startsWith(p.slice(0, -1));
+        return value === p;
+    });
+}
+function normalizeExtensions(extensions) {
+    return extensions.map((ext) => {
+        const e = ext.toLowerCase().trim();
+        return e.startsWith('.') ? e : `.${e}`;
+    });
+}
+function buildFileFilter(validation) {
+    if (!validation)
+        return undefined;
+    const { allowedMimeTypes, allowedExtensions, fileFilter } = validation;
+    if (!allowedMimeTypes?.length && !allowedExtensions?.length && !fileFilter) {
+        return undefined;
+    }
+    const normalizedExtensions = allowedExtensions?.length ? normalizeExtensions(allowedExtensions) : undefined;
+    return (req, file, cb) => {
+        if (allowedMimeTypes?.length && !matchesMime(file.mimetype, allowedMimeTypes)) {
+            return cb(new InvalidFileTypeException(file.mimetype, allowedMimeTypes));
+        }
+        if (normalizedExtensions) {
+            const ext = (0, path_1.extname)(file.originalname).toLowerCase();
+            if (!normalizedExtensions.includes(ext)) {
+                return cb(new InvalidFileTypeException(ext || file.originalname, normalizedExtensions));
+            }
+        }
+        if (fileFilter) {
+            return fileFilter(req, file, cb);
+        }
+        cb(null, true);
+    };
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let value = bytes / 1024;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value % 1 === 0 ? value : value.toFixed(1)} ${units[unit]}`;
+}
+//# sourceMappingURL=validation.js.map

package/dist/lib/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/lib/validation.ts"],"names":[],"mappings":";;;AAoDA,0CAKC;AAGD,wCAMC;AA0BD,0CAuBC;AAGD,kCAUC;AAhID,2CAAqD;AAErD,+BAA+B;AAqB/B,MAAa,qBAAsB,SAAQ,4BAAmB;IAC1D,YAAY,OAAgB;QACxB,KAAK,CACD,OAAO;YACH,CAAC,CAAC,4CAA4C,WAAW,CAAC,OAAO,CAAC,GAAG;YACrE,CAAC,CAAC,wCAAwC,CACjD,CAAC;IACN,CAAC;CACJ;AARD,sDAQC;AAGD,MAAa,wBAAyB,SAAQ,4BAAmB;IAC7D,YAAY,QAAgB,EAAE,OAAiB;QAC3C,KAAK,CAAC,cAAc,QAAQ,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrF,CAAC;CACJ;AAJD,4DAIC;AAGD,MAAa,qBAAsB,SAAQ,4BAAmB;IAC1D,YAAY,QAAiB;QACzB,KAAK,CACD,QAAQ;YACJ,CAAC,CAAC,gCAAgC,QAAQ,sBAAsB;YAChE,CAAC,CAAC,0BAA0B,CACnC,CAAC;IACN,CAAC;CACJ;AARD,sDAQC;AAGD,SAAgB,eAAe,CAC3B,IAAuB,EACvB,QAA2B;IAE3B,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;AACpD,CAAC;AAGD,SAAgB,cAAc,CAAC,UAA6B;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,IAAI,UAAU,CAAC,OAAO,IAAI,IAAI;QAAE,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;IACrE,IAAI,UAAU,CAAC,QAAQ,IAAI,IAAI;QAAE,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC;IACpE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAGD,SAAS,WAAW,CAAC,IAAY,EAAE,QAAkB;IACjD,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,KAAK,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC;AAGD,SAAS,mBAAmB,CAAC,UAAoB;IAC7C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC;AAOD,SAAgB,eAAe,CAAC,UAA6B;IACzD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;IACvE,IAAI,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,oBAAoB,GAAG,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5G,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;QACrB,IAAI,gBAAgB,EAAE,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAC5E,OAAO,EAAE,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,oBAAoB,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;YACrD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO,EAAE,CAAC,IAAI,wBAAwB,CAAC,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;YAC5F,CAAC;QACL,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,WAAW,CAAC,KAAa;IACrC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,IAAI,IAAI,CAAC;QACd,IAAI,IAAI,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC"}