s3-client-dtb 0.0.1 → 1.0.2

package/dist/client/index.d.ts

@@ -1,3 +1,77 @@
+import { StorageClient } from './storage-client';
+import { LocalStorageClient } from './local-storage-client';
 export { StorageClient } from './storage-client';
+export { LocalStorageClient } from './local-storage-client';
 export type { StorageClientOptions } from './storage-client';
+export type { LocalStorageClientOptions } from './local-storage-client';
+export { readClientConfig, readStorageConfig, readOfflineConfig, readOnlineConfig, getStorageMode, toClientConfig, } from '../config/config-reader';
+export type { ClientConfigFile, ClientConfig, OfflineConfigFile, StorageConfigFile, StorageMode, } from '../config/config-reader';
+/** Tipo unificado para cualquier cliente de almacenamiento */
+export type UnifiedStorageClient = StorageClient | LocalStorageClient;
+/**
+ * Crea un cliente de almacenamiento desde variables de entorno.
+ * Detecta automáticamente el modo (online/offline) según STORAGE_MODE.
+ *
+ * ## Modo Online (servidor remoto) - STORAGE_MODE=online (o no definido)
+ *
+ * Requiere las siguientes variables de entorno:
+ * - STORAGE_CLIENT_ID
+ * - STORAGE_CLIENT_NAME
+ * - STORAGE_BASE_URL
+ * - STORAGE_PERMISSIONS (JSON array o comma-separated: "read,write,delete")
+ * - STORAGE_ALLOWED_PATHS (JSON array o comma-separated: "*" o ["path1", "path2"])
+ * - STORAGE_CLIENT_SECRET
+ * - STORAGE_TOTP_SECRET
+ *
+ * Opcionales:
+ * - STORAGE_TOKEN_EXPIRES_IN (ej: "5m", "30m")
+ * - STORAGE_TOTP_PERIOD (segundos, 15-300; default 30)
+ * - STORAGE_RATE_LIMIT_REQUESTS (número)
+ * - STORAGE_RATE_LIMIT_WINDOW (ej: "1h", "30m")
+ *
+ * ## Modo Offline (almacenamiento local) - STORAGE_MODE=offline
+ *
+ * Requiere las siguientes variables de entorno:
+ * - STORAGE_ROOT_PATH (directorio donde guardar archivos)
+ *
+ * Opcionales:
+ * - STORAGE_MAX_FILE_SIZE (ej: "50mb", "100kb". Default: "50mb")
+ * - STORAGE_ALLOWED_MIME_TYPES (JSON array o comma-separated. Default: "*")
+ *
+ * @example
+ * ```typescript
+ * // .env para desarrollo (offline)
+ * STORAGE_MODE=offline
+ * STORAGE_ROOT_PATH=./uploads
+ *
+ * // .env para producción (online)
+ * STORAGE_MODE=online
+ * STORAGE_BASE_URL=https://storage.example.com
+ * STORAGE_CLIENT_ID=mi-app
+ * // ... otras variables
+ * ```
+ *
+ * @returns StorageClient para modo online, LocalStorageClient para modo offline
+ */
+export declare function createClientFromConfig(): UnifiedStorageClient;
+/**
+ * Crea un StorageClient para modo online desde variables de entorno.
+ * Útil cuando quieres forzar el modo online ignorando STORAGE_MODE.
+ *
+ * @deprecated Usa createClientFromConfig() para detección automática de modo
+ */
+export declare function createOnlineClient(): StorageClient;
+/**
+ * Crea un LocalStorageClient para modo offline desde variables de entorno.
+ * Útil cuando quieres forzar el modo offline ignorando STORAGE_MODE.
+ */
+export declare function createOfflineClient(): LocalStorageClient;
+/**
+ * Helper para verificar si el cliente está en modo offline
+ */
+export declare function isOfflineClient(client: UnifiedStorageClient): client is LocalStorageClient;
+/**
+ * Helper para verificar si el cliente está en modo online
+ */
+export declare function isOnlineClient(client: UnifiedStorageClient): client is StorageClient;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAQ5D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,CAqB7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAWlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CAQxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,IAAI,kBAAkB,CAE1F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,IAAI,aAAa,CAEpF"}

package/dist/client/index.js

@@ -1,6 +1,128 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StorageClient = void 0;
-var storage_client_1 = require("./storage-client");
-Object.defineProperty(exports, "StorageClient", { enumerable: true, get: function () { return storage_client_1.StorageClient; } });
+exports.toClientConfig = exports.getStorageMode = exports.readOnlineConfig = exports.readOfflineConfig = exports.readStorageConfig = exports.readClientConfig = exports.LocalStorageClient = exports.StorageClient = void 0;
+exports.createClientFromConfig = createClientFromConfig;
+exports.createOnlineClient = createOnlineClient;
+exports.createOfflineClient = createOfflineClient;
+exports.isOfflineClient = isOfflineClient;
+exports.isOnlineClient = isOnlineClient;
+const storage_client_1 = require("./storage-client");
+const local_storage_client_1 = require("./local-storage-client");
+const config_reader_1 = require("../config/config-reader");
+var storage_client_2 = require("./storage-client");
+Object.defineProperty(exports, "StorageClient", { enumerable: true, get: function () { return storage_client_2.StorageClient; } });
+var local_storage_client_2 = require("./local-storage-client");
+Object.defineProperty(exports, "LocalStorageClient", { enumerable: true, get: function () { return local_storage_client_2.LocalStorageClient; } });
+var config_reader_2 = require("../config/config-reader");
+Object.defineProperty(exports, "readClientConfig", { enumerable: true, get: function () { return config_reader_2.readClientConfig; } });
+Object.defineProperty(exports, "readStorageConfig", { enumerable: true, get: function () { return config_reader_2.readStorageConfig; } });
+Object.defineProperty(exports, "readOfflineConfig", { enumerable: true, get: function () { return config_reader_2.readOfflineConfig; } });
+Object.defineProperty(exports, "readOnlineConfig", { enumerable: true, get: function () { return config_reader_2.readOnlineConfig; } });
+Object.defineProperty(exports, "getStorageMode", { enumerable: true, get: function () { return config_reader_2.getStorageMode; } });
+Object.defineProperty(exports, "toClientConfig", { enumerable: true, get: function () { return config_reader_2.toClientConfig; } });
+/**
+ * Crea un cliente de almacenamiento desde variables de entorno.
+ * Detecta automáticamente el modo (online/offline) según STORAGE_MODE.
+ *
+ * ## Modo Online (servidor remoto) - STORAGE_MODE=online (o no definido)
+ *
+ * Requiere las siguientes variables de entorno:
+ * - STORAGE_CLIENT_ID
+ * - STORAGE_CLIENT_NAME
+ * - STORAGE_BASE_URL
+ * - STORAGE_PERMISSIONS (JSON array o comma-separated: "read,write,delete")
+ * - STORAGE_ALLOWED_PATHS (JSON array o comma-separated: "*" o ["path1", "path2"])
+ * - STORAGE_CLIENT_SECRET
+ * - STORAGE_TOTP_SECRET
+ *
+ * Opcionales:
+ * - STORAGE_TOKEN_EXPIRES_IN (ej: "5m", "30m")
+ * - STORAGE_TOTP_PERIOD (segundos, 15-300; default 30)
+ * - STORAGE_RATE_LIMIT_REQUESTS (número)
+ * - STORAGE_RATE_LIMIT_WINDOW (ej: "1h", "30m")
+ *
+ * ## Modo Offline (almacenamiento local) - STORAGE_MODE=offline
+ *
+ * Requiere las siguientes variables de entorno:
+ * - STORAGE_ROOT_PATH (directorio donde guardar archivos)
+ *
+ * Opcionales:
+ * - STORAGE_MAX_FILE_SIZE (ej: "50mb", "100kb". Default: "50mb")
+ * - STORAGE_ALLOWED_MIME_TYPES (JSON array o comma-separated. Default: "*")
+ *
+ * @example
+ * ```typescript
+ * // .env para desarrollo (offline)
+ * STORAGE_MODE=offline
+ * STORAGE_ROOT_PATH=./uploads
+ *
+ * // .env para producción (online)
+ * STORAGE_MODE=online
+ * STORAGE_BASE_URL=https://storage.example.com
+ * STORAGE_CLIENT_ID=mi-app
+ * // ... otras variables
+ * ```
+ *
+ * @returns StorageClient para modo online, LocalStorageClient para modo offline
+ */
+function createClientFromConfig() {
+    const config = (0, config_reader_1.readStorageConfig)();
+    if (config.mode === 'offline') {
+        return new local_storage_client_1.LocalStorageClient({
+            rootPath: config.rootPath,
+            maxFileSize: config.maxFileSize,
+            allowedMimeTypes: config.allowedMimeTypes,
+        });
+    }
+    // Modo online
+    const clientConfig = (0, config_reader_1.toClientConfig)(config);
+    return new storage_client_1.StorageClient({
+        baseUrl: config.baseUrl,
+        clientConfig,
+        clientSecret: config.clientSecret,
+        totpSecret: config.totpSecret,
+        totpPeriodSeconds: config.totpPeriod ?? 30,
+    });
+}
+/**
+ * Crea un StorageClient para modo online desde variables de entorno.
+ * Útil cuando quieres forzar el modo online ignorando STORAGE_MODE.
+ *
+ * @deprecated Usa createClientFromConfig() para detección automática de modo
+ */
+function createOnlineClient() {
+    const config = (0, config_reader_1.readOnlineConfig)();
+    const clientConfig = (0, config_reader_1.toClientConfig)(config);
+    return new storage_client_1.StorageClient({
+        baseUrl: config.baseUrl,
+        clientConfig,
+        clientSecret: config.clientSecret,
+        totpSecret: config.totpSecret,
+        totpPeriodSeconds: config.totpPeriod ?? 30,
+    });
+}
+/**
+ * Crea un LocalStorageClient para modo offline desde variables de entorno.
+ * Útil cuando quieres forzar el modo offline ignorando STORAGE_MODE.
+ */
+function createOfflineClient() {
+    const config = (0, config_reader_1.readOfflineConfig)();
+    return new local_storage_client_1.LocalStorageClient({
+        rootPath: config.rootPath,
+        maxFileSize: config.maxFileSize,
+        allowedMimeTypes: config.allowedMimeTypes,
+    });
+}
+/**
+ * Helper para verificar si el cliente está en modo offline
+ */
+function isOfflineClient(client) {
+    return 'mode' in client && client.mode === 'offline';
+}
+/**
+ * Helper para verificar si el cliente está en modo online
+ */
+function isOnlineClient(client) {
+    return !('mode' in client) || client.mode !== 'offline';
+}
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AA6EA,wDAqBC;AAQD,gDAWC;AAMD,kDAQC;AAKD,0CAEC;AAKD,wCAEC;AAjJD,qDAAiD;AACjD,iEAA4D;AAC5D,2DAKiC;AAEjC,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAG3B,yDAOiC;AAN/B,iHAAA,gBAAgB,OAAA;AAChB,kHAAA,iBAAiB,OAAA;AACjB,kHAAA,iBAAiB,OAAA;AACjB,iHAAA,gBAAgB,OAAA;AAChB,+GAAA,cAAc,OAAA;AACd,+GAAA,cAAc,OAAA;AAahB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,SAAgB,sBAAsB;IACpC,MAAM,MAAM,GAAG,IAAA,iCAAiB,GAAE,CAAC;IAEnC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,IAAI,yCAAkB,CAAC;YAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,cAAc;IACd,MAAM,YAAY,GAAG,IAAA,8BAAc,EAAC,MAAM,CAAC,CAAC;IAE5C,OAAO,IAAI,8BAAa,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY;QACZ,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,iBAAiB,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;KAC3C,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAA,gCAAgB,GAAE,CAAC;IAClC,MAAM,YAAY,GAAG,IAAA,8BAAc,EAAC,MAAM,CAAC,CAAC;IAE5C,OAAO,IAAI,8BAAa,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY;QACZ,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,iBAAiB,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;KAC3C,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,MAAM,MAAM,GAAG,IAAA,iCAAiB,GAAE,CAAC;IAEnC,OAAO,IAAI,yCAAkB,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAA4B;IAC1D,OAAO,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAA4B;IACzD,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,IAAK,MAAc,CAAC,IAAI,KAAK,SAAS,CAAC;AACnE,CAAC"}

package/dist/client/local-storage-client.d.ts

@@ -0,0 +1,97 @@
+import { Readable } from 'stream';
+import type { FileMetadata, ListFilesOptions } from '../types';
+/**
+ * Opciones para el cliente de almacenamiento local (modo offline)
+ */
+export interface LocalStorageClientOptions {
+    /** Directorio raíz donde se guardarán los archivos */
+    rootPath: string;
+    /** Tamaño máximo de archivo (ej: "50mb", "100kb"). Default: "50mb" */
+    maxFileSize?: string;
+    /** MIME types permitidos. Default: ["*"] (todos) */
+    allowedMimeTypes?: string[];
+}
+/**
+ * Cliente de almacenamiento local para modo offline.
+ *
+ * Implementa la misma interfaz que StorageClient pero guarda
+ * los archivos localmente usando StorageCore.
+ *
+ * Ideal para desarrollo sin necesidad de un servidor en línea.
+ *
+ * @example
+ * ```typescript
+ * const client = new LocalStorageClient({
+ *   rootPath: './uploads',
+ *   maxFileSize: '50mb',
+ *   allowedMimeTypes: ['image/*', 'application/pdf']
+ * });
+ *
+ * // Subir archivo
+ * const path = await client.uploadFile('images', buffer, 'image/png');
+ *
+ * // Descargar archivo
+ * const stream = await client.downloadFile(path);
+ * ```
+ */
+export declare class LocalStorageClient {
+    private readonly storageCore;
+    readonly mode: "offline";
+    constructor(options: LocalStorageClientOptions);
+    /**
+     * Sube un archivo al almacenamiento local
+     *
+     * @param filePath - Ruta/carpeta donde guardar el archivo
+     * @param buffer - Contenido del archivo
+     * @param mimeType - Tipo MIME del archivo
+     * @param prefix - Prefijo opcional para el nombre del archivo
+     * @returns Ruta relativa del archivo guardado
+     */
+    uploadFile(filePath: string, buffer: Buffer, mimeType: string, prefix?: string): Promise<string>;
+    /**
+     * Descarga un archivo del almacenamiento local
+     *
+     * @param path - Ruta del archivo a descargar
+     * @returns Stream readable del archivo
+     */
+    downloadFile(path: string): Promise<Readable>;
+    /**
+     * Elimina un archivo del almacenamiento local
+     *
+     * @param path - Ruta del archivo a eliminar
+     */
+    deleteFile(path: string): Promise<void>;
+    /**
+     * Obtiene los metadatos de un archivo
+     *
+     * @param path - Ruta del archivo
+     * @returns Metadatos del archivo
+     */
+    getFileMetadata(path: string): Promise<FileMetadata>;
+    /**
+     * Lista los archivos en un directorio
+     *
+     * @param directoryPath - Ruta del directorio (opcional)
+     * @param options - Opciones de listado (limit, offset, prefix)
+     * @returns Lista de archivos y total
+     */
+    listFiles(directoryPath?: string, options?: ListFilesOptions): Promise<{
+        files: FileMetadata[];
+        total: number;
+    }>;
+    /**
+     * Verifica si un archivo existe
+     *
+     * @param path - Ruta del archivo
+     * @returns true si existe, false si no
+     */
+    fileExists(path: string): Promise<boolean>;
+    /**
+     * Método de compatibilidad con StorageClient.
+     * En modo offline no hay TOTP que verificar, siempre retorna éxito.
+     */
+    verifyTotp(): Promise<{
+        message: string;
+    }>;
+}
+//# sourceMappingURL=local-storage-client.d.ts.map

package/dist/client/local-storage-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage-client.d.ts","sourceRoot":"","sources":["../../src/client/local-storage-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAsB,MAAM,UAAU,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,SAAgB,IAAI,EAAG,SAAS,CAAU;gBAE9B,OAAO,EAAE,yBAAyB;IAc9C;;;;;;;;OAQG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;OAKG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAInD;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1D;;;;;;OAMG;IACG,SAAS,CACb,aAAa,GAAE,MAAW,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIpD;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGjD"}

package/dist/client/local-storage-client.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorageClient = void 0;
+const storage_core_1 = require("../core/storage-core");
+/**
+ * Cliente de almacenamiento local para modo offline.
+ *
+ * Implementa la misma interfaz que StorageClient pero guarda
+ * los archivos localmente usando StorageCore.
+ *
+ * Ideal para desarrollo sin necesidad de un servidor en línea.
+ *
+ * @example
+ * ```typescript
+ * const client = new LocalStorageClient({
+ *   rootPath: './uploads',
+ *   maxFileSize: '50mb',
+ *   allowedMimeTypes: ['image/*', 'application/pdf']
+ * });
+ *
+ * // Subir archivo
+ * const path = await client.uploadFile('images', buffer, 'image/png');
+ *
+ * // Descargar archivo
+ * const stream = await client.downloadFile(path);
+ * ```
+ */
+class LocalStorageClient {
+    storageCore;
+    mode = 'offline';
+    constructor(options) {
+        if (!options.rootPath) {
+            throw new Error('rootPath es requerido para el modo offline');
+        }
+        const coreOptions = {
+            rootPath: options.rootPath,
+            maxFileSize: options.maxFileSize,
+            allowedMimeTypes: options.allowedMimeTypes,
+        };
+        this.storageCore = new storage_core_1.StorageCore(coreOptions);
+    }
+    /**
+     * Sube un archivo al almacenamiento local
+     *
+     * @param filePath - Ruta/carpeta donde guardar el archivo
+     * @param buffer - Contenido del archivo
+     * @param mimeType - Tipo MIME del archivo
+     * @param prefix - Prefijo opcional para el nombre del archivo
+     * @returns Ruta relativa del archivo guardado
+     */
+    async uploadFile(filePath, buffer, mimeType, prefix) {
+        return this.storageCore.uploadFile(filePath, buffer, mimeType, prefix);
+    }
+    /**
+     * Descarga un archivo del almacenamiento local
+     *
+     * @param path - Ruta del archivo a descargar
+     * @returns Stream readable del archivo
+     */
+    async downloadFile(path) {
+        return this.storageCore.downloadFile(path);
+    }
+    /**
+     * Elimina un archivo del almacenamiento local
+     *
+     * @param path - Ruta del archivo a eliminar
+     */
+    async deleteFile(path) {
+        return this.storageCore.deleteFile(path);
+    }
+    /**
+     * Obtiene los metadatos de un archivo
+     *
+     * @param path - Ruta del archivo
+     * @returns Metadatos del archivo
+     */
+    async getFileMetadata(path) {
+        return this.storageCore.getFileMetadata(path);
+    }
+    /**
+     * Lista los archivos en un directorio
+     *
+     * @param directoryPath - Ruta del directorio (opcional)
+     * @param options - Opciones de listado (limit, offset, prefix)
+     * @returns Lista de archivos y total
+     */
+    async listFiles(directoryPath = '', options = {}) {
+        return this.storageCore.listFiles(directoryPath, options);
+    }
+    /**
+     * Verifica si un archivo existe
+     *
+     * @param path - Ruta del archivo
+     * @returns true si existe, false si no
+     */
+    async fileExists(path) {
+        return this.storageCore.fileExists(path);
+    }
+    /**
+     * Método de compatibilidad con StorageClient.
+     * En modo offline no hay TOTP que verificar, siempre retorna éxito.
+     */
+    async verifyTotp() {
+        return { message: 'Modo offline: verificación TOTP no requerida' };
+    }
+}
+exports.LocalStorageClient = LocalStorageClient;
+//# sourceMappingURL=local-storage-client.js.map

package/dist/client/local-storage-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage-client.js","sourceRoot":"","sources":["../../src/client/local-storage-client.ts"],"names":[],"mappings":";;;AACA,uDAAmD;AAenD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,kBAAkB;IACZ,WAAW,CAAc;IAC1B,IAAI,GAAG,SAAkB,CAAC;IAE1C,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,WAAW,GAAuB;YACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,MAAc,EACd,QAAgB,EAChB,MAAe;QAEf,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,gBAAwB,EAAE,EAC1B,UAA4B,EAAE;QAE9B,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;IACrE,CAAC;CACF;AAhGD,gDAgGC"}

package/dist/client/storage-client.d.ts

@@ -1,16 +1,34 @@
 import { Readable } from 'stream';
-import type { FileMetadata, ListFilesOptions } from '../types';
+import type { FileMetadata, ListFilesOptions, ClientConfig } from '../types';
 export interface StorageClientOptions {
     baseUrl: string;
-    apiKey: string;
     timeout?: number;
+    clientConfig: ClientConfig;
+    clientSecret: string;
+    totpSecret: string;
+    /** Período TOTP en segundos (default 30). Debe coincidir con TOTP_PERIOD del servidor. */
+    totpPeriodSeconds?: number;
 }
 export declare class StorageClient {
     private readonly baseUrl;
-    private readonly apiKey;
     private readonly timeout;
     private readonly apiPrefix;
+    private readonly clientConfig;
+    private readonly clientSecret;
+    private readonly totpSecret;
+    private readonly totpPeriodSec;
+    private readonly totpPeriodMs;
+    private tokenCache;
     constructor(options: StorageClientOptions);
+    /**
+     * Genera un token JWT firmado con HMAC usando CLIENT_SECRET + código TOTP actual.
+     * Genera un nuevo token cuando el TOTP cambia (cada totpPeriodSeconds).
+     */
+    private generateToken;
+    /**
+     * Convierte expiresIn string (ej: "30m", "7d") a segundos
+     */
+    private parseExpiresIn;
     private getHeaders;
     private request;
     uploadFile(filePath: string, buffer: Buffer, mimeType: string, prefix?: string): Promise<string>;
@@ -22,5 +40,12 @@ export declare class StorageClient {
         total: number;
     }>;
     fileExists(path: string): Promise<boolean>;
+    /**
+     * Verifica que el cliente puede generar el código TOTP correcto
+     * (opcional, para validar configuración)
+     */
+    verifyTotp(): Promise<{
+        message: string;
+    }>;
 }
 //# sourceMappingURL=storage-client.d.ts.map

package/dist/client/storage-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-client.d.ts","sourceRoot":"","sources":["../../src/client/storage-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAa/D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;gBAErC,OAAO,EAAE,oBAAoB;IAczC,OAAO,CAAC,UAAU;YAQJ,OAAO;IA6Ff,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IA4BZ,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAe7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA8CpD,SAAS,CACb,aAAa,GAAE,MAAW,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAWjD"}
+{"version":3,"file":"storage-client.d.ts","sourceRoot":"","sources":["../../src/client/storage-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAIlC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAa7E,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,UAAU,CAAyE;gBAE/E,OAAO,EAAE,oBAAoB;IAuBzC;;;OAGG;YACW,aAAa;IA4D3B;;OAEG;IACH,OAAO,CAAC,cAAc;YAuBR,UAAU;YASV,OAAO;IA8Lf,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IA+BZ,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAe7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiDpD,SAAS,CACb,aAAa,GAAE,MAAW,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYhD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAgEjD"}