s3-client-dtb 0.0.1 → 1.0.2

package/dist/config/config-reader.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readOfflineConfig = readOfflineConfig;
+exports.readOnlineConfig = readOnlineConfig;
+exports.getStorageMode = getStorageMode;
+exports.readStorageConfig = readStorageConfig;
+exports.readClientConfig = readClientConfig;
+exports.toClientConfig = toClientConfig;
+/**
+ * Parsea un string que puede ser JSON array o comma-separated a un array
+ */
+function parseArray(value, fieldName) {
+    if (!value) {
+        throw new Error(`${fieldName} es requerido como variable de entorno`);
+    }
+    // Intentar parsear como JSON primero
+    try {
+        const parsed = JSON.parse(value);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Si no es JSON válido, intentar como comma-separated
+    }
+    // Parsear como comma-separated
+    const items = value.split(',').map((item) => item.trim()).filter((item) => item.length > 0);
+    if (items.length === 0) {
+        throw new Error(`${fieldName} debe contener al menos un valor`);
+    }
+    return items;
+}
+/**
+ * Lee la configuración del modo offline desde variables de entorno
+ */
+function readOfflineConfig() {
+    const rootPath = process.env.STORAGE_ROOT_PATH;
+    if (!rootPath || typeof rootPath !== 'string' || rootPath.trim().length === 0) {
+        throw new Error('STORAGE_ROOT_PATH es requerido para modo offline');
+    }
+    const maxFileSize = process.env.STORAGE_MAX_FILE_SIZE;
+    // MIME types permitidos (opcional)
+    let allowedMimeTypes;
+    const mimeTypesStr = process.env.STORAGE_ALLOWED_MIME_TYPES;
+    if (mimeTypesStr) {
+        try {
+            allowedMimeTypes = parseArray(mimeTypesStr, 'STORAGE_ALLOWED_MIME_TYPES');
+        }
+        catch {
+            // Si falla, intentar como string único
+            allowedMimeTypes = [mimeTypesStr.trim()];
+        }
+    }
+    return {
+        mode: 'offline',
+        rootPath: rootPath.trim(),
+        maxFileSize: maxFileSize?.trim(),
+        allowedMimeTypes,
+    };
+}
+/**
+ * Lee la configuración del modo online desde variables de entorno
+ */
+function readOnlineConfig() {
+    // Leer variables de entorno requeridas
+    const clientId = process.env.STORAGE_CLIENT_ID;
+    const name = process.env.STORAGE_CLIENT_NAME;
+    const baseUrl = process.env.STORAGE_BASE_URL;
+    const clientSecret = process.env.STORAGE_CLIENT_SECRET;
+    const totpSecret = process.env.STORAGE_TOTP_SECRET;
+    // Validar campos requeridos
+    if (!clientId || typeof clientId !== 'string' || clientId.trim().length === 0) {
+        throw new Error('STORAGE_CLIENT_ID es requerido como variable de entorno');
+    }
+    if (!name || typeof name !== 'string' || name.trim().length === 0) {
+        throw new Error('STORAGE_CLIENT_NAME es requerido como variable de entorno');
+    }
+    if (!baseUrl || typeof baseUrl !== 'string' || baseUrl.trim().length === 0) {
+        throw new Error('STORAGE_BASE_URL es requerido como variable de entorno');
+    }
+    if (!clientSecret || typeof clientSecret !== 'string' || clientSecret.trim().length === 0) {
+        throw new Error('STORAGE_CLIENT_SECRET es requerido como variable de entorno');
+    }
+    if (!totpSecret || typeof totpSecret !== 'string' || totpSecret.trim().length === 0) {
+        throw new Error('STORAGE_TOTP_SECRET es requerido como variable de entorno');
+    }
+    // Parsear arrays desde variables de entorno
+    const permissionsStr = process.env.STORAGE_PERMISSIONS;
+    const allowedPathsStr = process.env.STORAGE_ALLOWED_PATHS;
+    let permissions;
+    try {
+        permissions = parseArray(permissionsStr, 'STORAGE_PERMISSIONS');
+    }
+    catch (error) {
+        throw new Error(`STORAGE_PERMISSIONS es requerido: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    let allowedPaths;
+    try {
+        allowedPaths = parseArray(allowedPathsStr, 'STORAGE_ALLOWED_PATHS');
+    }
+    catch (error) {
+        throw new Error(`STORAGE_ALLOWED_PATHS es requerido: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Validar permisos
+    const validPermissions = ['read', 'write', 'delete'];
+    for (const perm of permissions) {
+        if (!validPermissions.includes(perm)) {
+            throw new Error(`Permiso inválido: ${perm}. Permisos válidos: read, write, delete`);
+        }
+    }
+    // Parsear configuración opcional de rate limit
+    let rateLimit;
+    const rateLimitRequests = process.env.STORAGE_RATE_LIMIT_REQUESTS;
+    const rateLimitWindow = process.env.STORAGE_RATE_LIMIT_WINDOW;
+    if (rateLimitRequests || rateLimitWindow) {
+        if (!rateLimitRequests || !rateLimitWindow) {
+            throw new Error('STORAGE_RATE_LIMIT_REQUESTS y STORAGE_RATE_LIMIT_WINDOW deben estar ambos definidos si se usa rate limit');
+        }
+        const requests = parseInt(rateLimitRequests, 10);
+        if (isNaN(requests) || requests <= 0) {
+            throw new Error('STORAGE_RATE_LIMIT_REQUESTS debe ser un número positivo');
+        }
+        rateLimit = {
+            requests,
+            window: rateLimitWindow,
+        };
+    }
+    // Token expires in (opcional)
+    const tokenExpiresIn = process.env.STORAGE_TOKEN_EXPIRES_IN;
+    // Período TOTP en segundos (opcional, default 30). Debe coincidir con TOTP_PERIOD del servidor.
+    let totpPeriod;
+    const totpPeriodStr = process.env.STORAGE_TOTP_PERIOD;
+    if (totpPeriodStr) {
+        const n = parseInt(totpPeriodStr, 10);
+        if (isNaN(n) || n < 15 || n > 300) {
+            throw new Error('STORAGE_TOTP_PERIOD debe ser un número entre 15 y 300 (segundos)');
+        }
+        totpPeriod = n;
+    }
+    return {
+        mode: 'online',
+        clientId: clientId.trim(),
+        name: name.trim(),
+        baseUrl: baseUrl.trim(),
+        permissions: permissions,
+        allowedPaths,
+        rateLimit,
+        tokenExpiresIn: tokenExpiresIn?.trim(),
+        clientSecret: clientSecret.trim(),
+        totpSecret: totpSecret.trim(),
+        totpPeriod,
+    };
+}
+/**
+ * Detecta el modo de almacenamiento desde STORAGE_MODE.
+ * Default: 'online' si no se especifica.
+ */
+function getStorageMode() {
+    const mode = process.env.STORAGE_MODE?.toLowerCase().trim();
+    if (!mode || mode === 'online') {
+        return 'online';
+    }
+    if (mode === 'offline' || mode === 'local') {
+        return 'offline';
+    }
+    throw new Error(`STORAGE_MODE inválido: "${mode}". Valores válidos: "online", "offline"`);
+}
+/**
+ * Lee la configuración del cliente desde variables de entorno.
+ * Detecta automáticamente el modo (online/offline) según STORAGE_MODE.
+ *
+ * @returns Configuración para modo online u offline
+ */
+function readStorageConfig() {
+    const mode = getStorageMode();
+    if (mode === 'offline') {
+        return readOfflineConfig();
+    }
+    return readOnlineConfig();
+}
+/**
+ * Lee la configuración del cliente desde variables de entorno (modo online)
+ * @deprecated Usa readStorageConfig() para soporte automático de modo online/offline
+ */
+function readClientConfig() {
+    return readOnlineConfig();
+}
+/**
+ * Convierte ClientConfigFile a ClientConfig (sin baseUrl y tiempos)
+ */
+function toClientConfig(config) {
+    return {
+        clientId: config.clientId,
+        name: config.name,
+        permissions: config.permissions,
+        allowedPaths: config.allowedPaths,
+        rateLimit: config.rateLimit,
+        tokenExpiresIn: config.tokenExpiresIn,
+    };
+}
+//# sourceMappingURL=config-reader.js.map

package/dist/config/config-reader.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export { StorageCore } from './core/storage-core';
 export type { StorageCoreOptions } from './types';
-export { StorageClient } from './client/storage-client';
+export { StorageClient, LocalStorageClient, createClientFromConfig, createOnlineClient, createOfflineClient, isOfflineClient, isOnlineClient, readClientConfig, readStorageConfig, readOfflineConfig, readOnlineConfig, getStorageMode, toClientConfig, } from './client';
 export type { StorageClientOptions } from './client/storage-client';
+export type { LocalStorageClientOptions } from './client/local-storage-client';
+export type { ClientConfig, ClientConfigFile, OfflineConfigFile, StorageConfigFile, StorageMode, UnifiedStorageClient, } from './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';

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,EAEL,aAAa,EACb,kBAAkB,EAElB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EAEnB,eAAe,EACf,cAAc,EAEd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,UAAU,CAAC;AAGlB,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAGlB,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

@@ -1,12 +1,28 @@
 "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;
+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.toClientConfig = exports.getStorageMode = exports.readOnlineConfig = exports.readOfflineConfig = exports.readStorageConfig = exports.readClientConfig = exports.isOnlineClient = exports.isOfflineClient = exports.createOfflineClient = exports.createOnlineClient = exports.createClientFromConfig = exports.LocalStorageClient = 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; } });
+// Client exports - Para conectarse al backend remoto o almacenamiento local
+var client_1 = require("./client");
+// Clientes
+Object.defineProperty(exports, "StorageClient", { enumerable: true, get: function () { return client_1.StorageClient; } });
+Object.defineProperty(exports, "LocalStorageClient", { enumerable: true, get: function () { return client_1.LocalStorageClient; } });
+// Factory functions
+Object.defineProperty(exports, "createClientFromConfig", { enumerable: true, get: function () { return client_1.createClientFromConfig; } });
+Object.defineProperty(exports, "createOnlineClient", { enumerable: true, get: function () { return client_1.createOnlineClient; } });
+Object.defineProperty(exports, "createOfflineClient", { enumerable: true, get: function () { return client_1.createOfflineClient; } });
+// Helpers
+Object.defineProperty(exports, "isOfflineClient", { enumerable: true, get: function () { return client_1.isOfflineClient; } });
+Object.defineProperty(exports, "isOnlineClient", { enumerable: true, get: function () { return client_1.isOnlineClient; } });
+// Config readers
+Object.defineProperty(exports, "readClientConfig", { enumerable: true, get: function () { return client_1.readClientConfig; } });
+Object.defineProperty(exports, "readStorageConfig", { enumerable: true, get: function () { return client_1.readStorageConfig; } });
+Object.defineProperty(exports, "readOfflineConfig", { enumerable: true, get: function () { return client_1.readOfflineConfig; } });
+Object.defineProperty(exports, "readOnlineConfig", { enumerable: true, get: function () { return client_1.readOnlineConfig; } });
+Object.defineProperty(exports, "getStorageMode", { enumerable: true, get: function () { return client_1.getStorageMode; } });
+Object.defineProperty(exports, "toClientConfig", { enumerable: true, get: function () { return client_1.toClientConfig; } });
 // Errors exports
 var storage_errors_1 = require("./errors/storage-errors");
 Object.defineProperty(exports, "StorageError", { enumerable: true, get: function () { return storage_errors_1.StorageError; } });

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,0DAA0D;AAC1D,oDAAkD;AAAzC,2GAAA,WAAW,OAAA;AAGpB,4EAA4E;AAC5E,mCAkBkB;AAjBhB,WAAW;AACX,uGAAA,aAAa,OAAA;AACb,4GAAA,kBAAkB,OAAA;AAClB,oBAAoB;AACpB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,UAAU;AACV,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,iBAAiB;AACjB,0GAAA,gBAAgB,OAAA;AAChB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAChB,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AAkBhB,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/types/index.d.ts

@@ -17,4 +17,17 @@ export interface StorageCoreOptions {
     maxFileSize?: string;
     allowedMimeTypes?: string[];
 }
+export type Permission = 'read' | 'write' | 'delete';
+export interface ClientRateLimit {
+    requests: number;
+    window: string;
+}
+export interface ClientConfig {
+    clientId: string;
+    name: string;
+    permissions: Permission[];
+    allowedPaths: string[];
+    rateLimit?: ClientRateLimit;
+    tokenExpiresIn?: string;
+}
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "s3-client-dtb",
-  "version": "0.0.1",
+  "version": "1.0.2",
   "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",
@@ -17,7 +16,9 @@
   },
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test:client": "ts-node test-client.ts",
+    "test:security": "ts-node test-security-and-usage.ts"
   },
   "keywords": [
     "storage",
@@ -31,8 +32,9 @@
   "author": "DTB",
   "license": "MIT",
   "dependencies": {
-    "form-data": "^4.0.0",
-    "uuid": "^10.0.0"
+    "jsonwebtoken": "^9.0.2",
+    "otplib": "^13.2.1",
+    "uuid": "^13.0.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0"
@@ -43,8 +45,11 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/jsonwebtoken": "^9.0.6",
+    "@types/node": "^25.0.10",
     "@types/uuid": "^10.0.0",
+    "dotenv": "^17.2.3",
+    "ts-node": "^10.9.2",
     "typescript": "^5.7.0"
   },
   "files": [