s3-storage-dtb 0.0.1

package/dist/helpers/path-sanitizer.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizePath = sanitizePath;
+const path_validator_1 = require("./path-validator");
+/**
+ * Valida y normaliza un path. Usa las mismas reglas estrictas que validatePathSafe.
+ * Lanza si el path contiene caracteres prohibidos (;, ", ', #, .., cd, etc.).
+ * @param allowEmpty - Si true, permite '' (p. ej. directorio raíz en listFiles).
+ */
+function sanitizePath(inputPath, options = {}) {
+    const check = (0, path_validator_1.validatePathSafe)(inputPath, options);
+    if (!check.valid) {
+        throw new Error(check.message ?? 'Path inválido');
+    }
+    let sanitized = inputPath.trim();
+    if (sanitized.length === 0) {
+        return '';
+    }
+    // Eliminar barras al inicio y final
+    sanitized = sanitized.replace(/^\/+|\/+$/g, '');
+    return sanitized;
+}
+//# sourceMappingURL=path-sanitizer.js.map

package/dist/helpers/path-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-sanitizer.js","sourceRoot":"","sources":["../../src/helpers/path-sanitizer.ts"],"names":[],"mappings":";;AAUA,oCAiBC;AA3BD,qDAG0B;AAE1B;;;;GAIG;AACH,SAAgB,YAAY,CAC1B,SAAiB,EACjB,UAA+B,EAAE;IAEjC,MAAM,KAAK,GAAG,IAAA,iCAAgB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,oCAAoC;IACpC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAEhD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/helpers/path-validator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Validación estricta de paths.
+ * Solo permite: letras, números, / _ - .
+ * Prohibido: caracteres especiales, ; " ' # \ point-and-comma, comillas, cd, .., etc.
+ */
+export interface PathValidationResult {
+    valid: boolean;
+    message?: string;
+}
+export interface ValidatePathOptions {
+    /** Si true, permite '' (directorio raíz, p. ej. listFiles). Por defecto false. */
+    allowEmpty?: boolean;
+}
+/**
+ * Comprueba que un path sea seguro.
+ * - Solo a-z, A-Z, 0-9, /, _, -, ., @ (nombres prefix@uuid)
+ * - Sin ".." (path traversal)
+ * - Sin "cd" como segmento (cambio de ruta)
+ * - Sin punto y coma, comillas, #, barras invertidas, etc.
+ */
+export declare function validatePathSafe(path: string, options?: ValidatePathOptions): PathValidationResult;
+/**
+ * Versión que lanza si el path es inválido.
+ * Útil en guards/pipes donde se espera throw.
+ */
+export declare function assertPathSafe(path: string): void;
+//# sourceMappingURL=path-validator.d.ts.map

package/dist/helpers/path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.d.ts","sourceRoot":"","sources":["../../src/helpers/path-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,oBAAoB,CAyCtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKjD"}

package/dist/helpers/path-validator.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Validación estricta de paths.
+ * Solo permite: letras, números, / _ - .
+ * Prohibido: caracteres especiales, ; " ' # \ point-and-comma, comillas, cd, .., etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePathSafe = validatePathSafe;
+exports.assertPathSafe = assertPathSafe;
+/** Solo estos caracteres están permitidos en un path (@ en nombres prefix@uuid.ext) */
+const SAFE_PATH_REGEX = /^[a-zA-Z0-9/_.@-]+$/;
+/** Segmentos prohibidos (comandos / cambio de ruta) */
+const FORBIDDEN_SEGMENTS = ['cd', 'CD', 'Cd', 'cD'];
+/**
+ * Comprueba que un path sea seguro.
+ * - Solo a-z, A-Z, 0-9, /, _, -, ., @ (nombres prefix@uuid)
+ * - Sin ".." (path traversal)
+ * - Sin "cd" como segmento (cambio de ruta)
+ * - Sin punto y coma, comillas, #, barras invertidas, etc.
+ */
+function validatePathSafe(path, options = {}) {
+    if (typeof path !== 'string') {
+        return { valid: false, message: 'El path debe ser un string' };
+    }
+    const trimmed = path.trim();
+    if (trimmed.length === 0) {
+        if (options.allowEmpty) {
+            return { valid: true };
+        }
+        return { valid: false, message: 'El path no puede estar vacío' };
+    }
+    if (/\.\./.test(trimmed)) {
+        return {
+            valid: false,
+            message: 'El path no puede contener ".." (path traversal). Use solo rutas permitidas.',
+        };
+    }
+    if (!SAFE_PATH_REGEX.test(trimmed)) {
+        return {
+            valid: false,
+            message: 'El path solo puede contener letras, números, /, _, -, . y @. ' +
+                'Prohibidos: punto y coma, comillas, #, \\, espacios y demás caracteres especiales.',
+        };
+    }
+    const segments = trimmed.split('/').filter(Boolean);
+    for (const seg of segments) {
+        if (FORBIDDEN_SEGMENTS.includes(seg)) {
+            return {
+                valid: false,
+                message: 'El path no puede contener el segmento "cd" (cambio de ruta).',
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Versión que lanza si el path es inválido.
+ * Útil en guards/pipes donde se espera throw.
+ */
+function assertPathSafe(path) {
+    const result = validatePathSafe(path);
+    if (!result.valid) {
+        throw new Error(result.message ?? 'Path inválido');
+    }
+}
+//# sourceMappingURL=path-validator.js.map

package/dist/helpers/path-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.js","sourceRoot":"","sources":["../../src/helpers/path-validator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAyBH,4CA4CC;AAMD,wCAKC;AA9ED,uFAAuF;AACvF,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,uDAAuD;AACvD,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAYpD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,IAAY,EACZ,UAA+B,EAAE;IAEjC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;IACnE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EACL,6EAA6E;SAChF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EACL,+DAA+D;gBAC/D,oFAAoF;SACvF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,8DAA8D;aACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/helpers/size-parser.d.ts

@@ -0,0 +1,2 @@
+export declare function parseMaxFileSize(size: string): number;
+//# sourceMappingURL=size-parser.d.ts.map

package/dist/helpers/size-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-parser.d.ts","sourceRoot":"","sources":["../../src/helpers/size-parser.ts"],"names":[],"mappings":"AAUA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD"}

package/dist/helpers/size-parser.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMaxFileSize = parseMaxFileSize;
+/**
+ * Parsea strings de tamaño (ej. "50mb", "1gb") a bytes.
+ */
+const UNITS = {
+    b: 1,
+    kb: 1024,
+    mb: 1024 * 1024,
+    gb: 1024 * 1024 * 1024,
+};
+function parseMaxFileSize(size) {
+    const match = size.toLowerCase().match(/^(\d+)([a-z]+)$/);
+    if (!match) {
+        return 50 * 1024 * 1024;
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    return value * (UNITS[unit] ?? 1024 * 1024);
+}
+//# sourceMappingURL=size-parser.js.map

package/dist/helpers/size-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-parser.js","sourceRoot":"","sources":["../../src/helpers/size-parser.ts"],"names":[],"mappings":";;AAUA,4CAQC;AAlBD;;GAEG;AACH,MAAM,KAAK,GAA2B;IACpC,CAAC,EAAE,CAAC;IACJ,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI,GAAG,IAAI;IACf,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;CACvB,CAAC;AAEF,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { StorageCore } from './core/storage-core';
+export type { StorageCoreOptions } from './types';
+export { StorageClient } from './client/storage-client';
+export type { StorageClientOptions } from './client/storage-client';
+export type { FileMetadata, ListFilesOptions } from './types';
+export { StorageError, FileNotFoundError, InvalidMimeTypeError, FileTooLargeError, UploadError, DownloadError, DeleteError, MetadataError, ListError, } from './errors/storage-errors';
+export { sanitizePath } from './helpers/path-sanitizer';
+export { validatePathSafe, assertPathSafe } from './helpers/path-validator';
+export type { PathValidationResult, ValidatePathOptions } from './helpers/path-validator';
+export { isMimeTypeAllowed } from './helpers/mime-validator';
+export { parseMaxFileSize } from './helpers/size-parser';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMaxFileSize = exports.isMimeTypeAllowed = exports.assertPathSafe = exports.validatePathSafe = exports.sanitizePath = exports.ListError = exports.MetadataError = exports.DeleteError = exports.DownloadError = exports.UploadError = exports.FileTooLargeError = exports.InvalidMimeTypeError = exports.FileNotFoundError = exports.StorageError = exports.StorageClient = exports.StorageCore = void 0;
+// Core exports - Para Node.js puro (almacenamiento local)
+var storage_core_1 = require("./core/storage-core");
+Object.defineProperty(exports, "StorageCore", { enumerable: true, get: function () { return storage_core_1.StorageCore; } });
+// Client exports - Para conectarse al backend remoto
+var storage_client_1 = require("./client/storage-client");
+Object.defineProperty(exports, "StorageClient", { enumerable: true, get: function () { return storage_client_1.StorageClient; } });
+// Errors exports
+var storage_errors_1 = require("./errors/storage-errors");
+Object.defineProperty(exports, "StorageError", { enumerable: true, get: function () { return storage_errors_1.StorageError; } });
+Object.defineProperty(exports, "FileNotFoundError", { enumerable: true, get: function () { return storage_errors_1.FileNotFoundError; } });
+Object.defineProperty(exports, "InvalidMimeTypeError", { enumerable: true, get: function () { return storage_errors_1.InvalidMimeTypeError; } });
+Object.defineProperty(exports, "FileTooLargeError", { enumerable: true, get: function () { return storage_errors_1.FileTooLargeError; } });
+Object.defineProperty(exports, "UploadError", { enumerable: true, get: function () { return storage_errors_1.UploadError; } });
+Object.defineProperty(exports, "DownloadError", { enumerable: true, get: function () { return storage_errors_1.DownloadError; } });
+Object.defineProperty(exports, "DeleteError", { enumerable: true, get: function () { return storage_errors_1.DeleteError; } });
+Object.defineProperty(exports, "MetadataError", { enumerable: true, get: function () { return storage_errors_1.MetadataError; } });
+Object.defineProperty(exports, "ListError", { enumerable: true, get: function () { return storage_errors_1.ListError; } });
+// Helpers exports (opcional, para uso avanzado)
+var path_sanitizer_1 = require("./helpers/path-sanitizer");
+Object.defineProperty(exports, "sanitizePath", { enumerable: true, get: function () { return path_sanitizer_1.sanitizePath; } });
+var path_validator_1 = require("./helpers/path-validator");
+Object.defineProperty(exports, "validatePathSafe", { enumerable: true, get: function () { return path_validator_1.validatePathSafe; } });
+Object.defineProperty(exports, "assertPathSafe", { enumerable: true, get: function () { return path_validator_1.assertPathSafe; } });
+var mime_validator_1 = require("./helpers/mime-validator");
+Object.defineProperty(exports, "isMimeTypeAllowed", { enumerable: true, get: function () { return mime_validator_1.isMimeTypeAllowed; } });
+var size_parser_1 = require("./helpers/size-parser");
+Object.defineProperty(exports, "parseMaxFileSize", { enumerable: true, get: function () { return size_parser_1.parseMaxFileSize; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,0DAA0D;AAC1D,oDAAkD;AAAzC,2GAAA,WAAW,OAAA;AAGpB,qDAAqD;AACrD,0DAAwD;AAA/C,+GAAA,aAAa,OAAA;AAMtB,iBAAiB;AACjB,0DAUiC;AAT/B,8GAAA,YAAY,OAAA;AACZ,mHAAA,iBAAiB,OAAA;AACjB,sHAAA,oBAAoB,OAAA;AACpB,mHAAA,iBAAiB,OAAA;AACjB,6GAAA,WAAW,OAAA;AACX,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AACX,+GAAA,aAAa,OAAA;AACb,2GAAA,SAAS,OAAA;AAGX,gDAAgD;AAChD,2DAAwD;AAA/C,8GAAA,YAAY,OAAA;AACrB,2DAA4E;AAAnE,kHAAA,gBAAgB,OAAA;AAAE,gHAAA,cAAc,OAAA;AAEzC,2DAA6D;AAApD,mHAAA,iBAAiB,OAAA;AAC1B,qDAAyD;AAAhD,+GAAA,gBAAgB,OAAA"}

package/dist/nestjs/index.d.ts

@@ -0,0 +1,4 @@
+export { StorageModule } from './storage.module';
+export { StorageService } from './storage.service';
+export type { StorageModuleOptions, StorageModuleAsyncOptions } from './storage.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/nestjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/nestjs/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = exports.StorageModule = void 0;
+var storage_module_1 = require("./storage.module");
+Object.defineProperty(exports, "StorageModule", { enumerable: true, get: function () { return storage_module_1.StorageModule; } });
+var storage_service_1 = require("./storage.service");
+Object.defineProperty(exports, "StorageService", { enumerable: true, get: function () { return storage_service_1.StorageService; } });
+//# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist/nestjs/storage.module.d.ts

@@ -0,0 +1,13 @@
+import { DynamicModule } from '@nestjs/common';
+import type { StorageCoreOptions } from '../types';
+export interface StorageModuleOptions extends StorageCoreOptions {
+}
+export interface StorageModuleAsyncOptions {
+    useFactory: (...args: never[]) => Promise<StorageModuleOptions> | StorageModuleOptions;
+    inject?: never[];
+}
+export declare class StorageModule {
+    static forRoot(options: StorageModuleOptions): DynamicModule;
+    static forRootAsync(options: StorageModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=storage.module.d.ts.map

package/dist/nestjs/storage.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.d.ts","sourceRoot":"","sources":["../../src/nestjs/storage.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;CAAG;AAEnE,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IACvF,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CAClB;AAED,qBACa,aAAa;IACxB,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;IAa5D,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,aAAa;CAgBvE"}

package/dist/nestjs/storage.module.js

@@ -0,0 +1,86 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageModule = void 0;
+const common_1 = require("@nestjs/common");
+const storage_service_1 = require("./storage.service");
+let StorageModule = (() => {
+    let _classDecorators = [(0, common_1.Module)({})];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var StorageModule = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            StorageModule = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        static forRoot(options) {
+            return {
+                module: StorageModule,
+                providers: [
+                    {
+                        provide: storage_service_1.StorageService,
+                        useFactory: () => new storage_service_1.StorageService(options),
+                    },
+                ],
+                exports: [storage_service_1.StorageService],
+            };
+        }
+        static forRootAsync(options) {
+            return {
+                module: StorageModule,
+                providers: [
+                    {
+                        provide: storage_service_1.StorageService,
+                        useFactory: async (...args) => {
+                            const config = await options.useFactory(...args);
+                            return new storage_service_1.StorageService(config);
+                        },
+                        inject: options.inject ?? [],
+                    },
+                ],
+                exports: [storage_service_1.StorageService],
+            };
+        }
+    };
+    return StorageModule = _classThis;
+})();
+exports.StorageModule = StorageModule;
+//# sourceMappingURL=storage.module.js.map

package/dist/nestjs/storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.js","sourceRoot":"","sources":["../../src/nestjs/storage.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAuD;AACvD,uDAAmD;IAWtC,aAAa;4BADzB,IAAA,eAAM,EAAC,EAAE,CAAC;;;;;;;;YACX,6KA8BC;;;YA9BY,uDAAa;;QACxB,MAAM,CAAC,OAAO,CAAC,OAA6B;YAC1C,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE;oBACT;wBACE,OAAO,EAAE,gCAAc;wBACvB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,gCAAc,CAAC,OAAO,CAAC;qBAC9C;iBACF;gBACD,OAAO,EAAE,CAAC,gCAAc,CAAC;aAC1B,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,YAAY,CAAC,OAAkC;YACpD,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE;oBACT;wBACE,OAAO,EAAE,gCAAc;wBACvB,UAAU,EAAE,KAAK,EAAE,GAAG,IAAa,EAAE,EAAE;4BACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;4BACjD,OAAO,IAAI,gCAAc,CAAC,MAAM,CAAC,CAAC;wBACpC,CAAC;wBACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;qBAC7B;iBACF;gBACD,OAAO,EAAE,CAAC,gCAAc,CAAC;aAC1B,CAAC;QACJ,CAAC;;;;AA7BU,sCAAa"}

package/dist/nestjs/storage.service.d.ts

@@ -0,0 +1,17 @@
+import { StreamableFile } from '@nestjs/common';
+import type { FileMetadata, ListFilesOptions, StorageCoreOptions } from '../types';
+export declare class StorageService {
+    private readonly logger;
+    private readonly storageCore;
+    constructor(options: StorageCoreOptions);
+    uploadFile(filePath: string, buffer: Buffer, mimeType: string, prefix?: string): Promise<string>;
+    downloadFile(path: string): Promise<StreamableFile>;
+    deleteFile(path: string): Promise<void>;
+    getFileMetadata(path: string): Promise<FileMetadata>;
+    listFiles(directoryPath?: string, options?: ListFilesOptions): Promise<{
+        files: FileMetadata[];
+        total: number;
+    }>;
+    fileExists(path: string): Promise<boolean>;
+}
+//# sourceMappingURL=storage.service.d.ts.map

package/dist/nestjs/storage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.d.ts","sourceRoot":"","sources":["../../src/nestjs/storage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnF,qBACa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,OAAO,EAAE,kBAAkB;IAIjC,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAYZ,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWnD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpD,SAAS,CACb,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGjD"}

package/dist/nestjs/storage.service.js

@@ -0,0 +1,106 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = void 0;
+const common_1 = require("@nestjs/common");
+const storage_core_1 = require("../core/storage-core");
+let StorageService = (() => {
+    let _classDecorators = [(0, common_1.Injectable)()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var StorageService = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            StorageService = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        logger = new common_1.Logger(StorageService.name);
+        storageCore;
+        constructor(options) {
+            this.storageCore = new storage_core_1.StorageCore(options);
+        }
+        async uploadFile(filePath, buffer, mimeType, prefix) {
+            try {
+                const result = await this.storageCore.uploadFile(filePath, buffer, mimeType, prefix);
+                this.logger.log(`Archivo subido: ${filePath}`);
+                return result;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Error al subir archivo: ${message}`);
+                throw error;
+            }
+        }
+        async downloadFile(path) {
+            try {
+                const stream = await this.storageCore.downloadFile(path);
+                return new common_1.StreamableFile(stream);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Error al descargar archivo: ${message}`);
+                throw error;
+            }
+        }
+        async deleteFile(path) {
+            try {
+                await this.storageCore.deleteFile(path);
+                this.logger.log(`Archivo eliminado: ${path}`);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Error al eliminar archivo: ${message}`);
+                throw error;
+            }
+        }
+        async getFileMetadata(path) {
+            return this.storageCore.getFileMetadata(path);
+        }
+        async listFiles(directoryPath, options) {
+            return this.storageCore.listFiles(directoryPath, options);
+        }
+        async fileExists(path) {
+            return this.storageCore.fileExists(path);
+        }
+    };
+    return StorageService = _classThis;
+})();
+exports.StorageService = StorageService;
+//# sourceMappingURL=storage.service.js.map

package/dist/nestjs/storage.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.js","sourceRoot":"","sources":["../../src/nestjs/storage.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAoE;AACpE,uDAAmD;IAItC,cAAc;4BAD1B,IAAA,mBAAU,GAAE;;;;;;;;YACb,6KA6DC;;;YA7DY,uDAAc;;QACR,MAAM,GAAG,IAAI,eAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACzC,WAAW,CAAc;QAE1C,YAAY,OAA2B;YACrC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,MAAc,EACd,QAAgB,EAChB,MAAe;YAEf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACrF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;gBAC/C,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;gBACxD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAY;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBACzD,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;gBAC5D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,IAAY;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBAC3D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,IAAY;YAChC,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,SAAS,CACb,aAAsB,EACtB,OAA0B;YAE1B,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,IAAY;YAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;;;;AA5DU,wCAAc"}

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+export interface FileMetadata {
+    name: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    createdAt: Date;
+    modifiedAt: Date;
+    checksum?: string;
+}
+export interface ListFilesOptions {
+    limit?: number;
+    offset?: number;
+    prefix?: string;
+}
+export interface StorageCoreOptions {
+    rootPath: string;
+    maxFileSize?: string;
+    allowedMimeTypes?: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "s3-storage-dtb",
+  "version": "0.0.1",
+  "description": "Paquete de almacenamiento de archivos local para Node.js y NestJS",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./nestjs": {
+      "types": "./dist/nestjs/index.d.ts",
+      "default": "./dist/nestjs/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "storage",
+    "file-storage",
+    "local-storage",
+    "s3",
+    "filesystem",
+    "nestjs",
+    "DTB"
+  ],
+  "author": "DTB",
+  "license": "MIT",
+  "dependencies": {
+    "form-data": "^4.0.0",
+    "uuid": "^10.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.7.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}