s3-storage-dtb 0.0.1

package/dist/client/storage-client.js

@@ -0,0 +1,237 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageClient = void 0;
+const form_data_1 = __importDefault(require("form-data"));
+const storage_errors_1 = require("../errors/storage-errors");
+class StorageClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    apiPrefix = '/apifiles';
+    constructor(options) {
+        // Normalizar URL base (eliminar trailing slash)
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.apiKey = options.apiKey;
+        this.timeout = options.timeout ?? 30000;
+        if (!this.baseUrl) {
+            throw new Error('baseUrl es requerido');
+        }
+        if (!this.apiKey) {
+            throw new Error('apiKey es requerido');
+        }
+    }
+    getHeaders(additionalHeaders) {
+        return {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'x-api-key': this.apiKey,
+            ...additionalHeaders,
+        };
+    }
+    async request(method, endpoint, options = {}) {
+        const url = `${this.baseUrl}${this.apiPrefix}${endpoint}`;
+        const headers = this.getHeaders(options.headers);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: options.body instanceof form_data_1.default ? {} : headers,
+                body: options.body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (options.responseType === 'stream') {
+                if (!response.body) {
+                    throw new storage_errors_1.DownloadError('No se recibió contenido del servidor');
+                }
+                return response.body;
+            }
+            const data = (await response.json());
+            if (!data.success) {
+                const error = data.error;
+                if (!error) {
+                    throw new storage_errors_1.StorageError('Error desconocido del servidor', 'UNKNOWN_ERROR');
+                }
+                // Mapear códigos de error del backend a errores del cliente
+                switch (error.code) {
+                    case 'FILE_NOT_FOUND':
+                        throw new storage_errors_1.FileNotFoundError(error.message);
+                    case 'INVALID_MIME_TYPE':
+                        throw new storage_errors_1.InvalidMimeTypeError(error.message);
+                    case 'FILE_TOO_LARGE':
+                        throw new storage_errors_1.FileTooLargeError(error.message);
+                    case 'UPLOAD_ERROR':
+                        throw new storage_errors_1.UploadError(error.message);
+                    case 'DOWNLOAD_ERROR':
+                        throw new storage_errors_1.DownloadError(error.message);
+                    case 'DELETE_ERROR':
+                        throw new storage_errors_1.DeleteError(error.message);
+                    case 'METADATA_ERROR':
+                        throw new storage_errors_1.MetadataError(error.message);
+                    case 'LIST_ERROR':
+                        throw new storage_errors_1.ListError(error.message);
+                    default:
+                        throw new storage_errors_1.StorageError(error.message, error.code);
+                }
+            }
+            if (response.status === 401 || response.status === 403) {
+                throw new storage_errors_1.StorageError('No autorizado. Verifica tu API key y permisos', 'UNAUTHORIZED');
+            }
+            if (!data.data) {
+                throw new storage_errors_1.StorageError('Respuesta sin datos del servidor', 'NO_DATA');
+            }
+            return data.data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof storage_errors_1.StorageError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw new storage_errors_1.StorageError('Timeout al conectar con el servidor', 'TIMEOUT');
+                }
+                throw new storage_errors_1.StorageError(error.message, 'NETWORK_ERROR');
+            }
+            throw new storage_errors_1.StorageError('Error desconocido', 'UNKNOWN_ERROR');
+        }
+    }
+    async uploadFile(filePath, buffer, mimeType, prefix) {
+        try {
+            const formData = new form_data_1.default();
+            formData.append('file', buffer, {
+                filename: prefix ? `${prefix}@${Date.now()}` : `file-${Date.now()}`,
+                contentType: mimeType,
+            });
+            formData.append('filePath', filePath);
+            const headers = formData.getHeaders();
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+            headers['x-api-key'] = this.apiKey;
+            const result = await this.request('POST', '/files', {
+                body: formData,
+                headers,
+            });
+            return result.path;
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.StorageError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.UploadError(message);
+        }
+    }
+    async downloadFile(path) {
+        try {
+            const stream = await this.request('GET', `/files/${path}`, {
+                responseType: 'stream',
+            });
+            return stream;
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError || error instanceof storage_errors_1.DownloadError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.DownloadError(message);
+        }
+    }
+    async deleteFile(path) {
+        try {
+            await this.request('DELETE', `/files/${path}`);
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError || error instanceof storage_errors_1.DeleteError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.DeleteError(message);
+        }
+    }
+    async getFileMetadata(path) {
+        try {
+            const response = await fetch(`${this.baseUrl}${this.apiPrefix}/files/${path}`, {
+                method: 'HEAD',
+                headers: this.getHeaders(),
+            });
+            if (response.status === 404) {
+                throw new storage_errors_1.FileNotFoundError();
+            }
+            if (!response.ok) {
+                const error = (await response.json());
+                throw new storage_errors_1.MetadataError(error.error?.message ?? 'Error al obtener metadata');
+            }
+            const contentType = response.headers.get('content-type') ?? 'application/octet-stream';
+            const contentLength = parseInt(response.headers.get('content-length') ?? '0', 10);
+            const lastModified = response.headers.get('last-modified');
+            const contentDisposition = response.headers.get('content-disposition');
+            let fileName = path.split('/').pop() ?? '';
+            if (contentDisposition) {
+                const filenameMatch = contentDisposition.match(/filename="(.+)"/);
+                if (filenameMatch) {
+                    fileName = filenameMatch[1];
+                }
+            }
+            return {
+                name: fileName,
+                path,
+                size: contentLength,
+                mimeType: contentType,
+                createdAt: lastModified ? new Date(lastModified) : new Date(),
+                modifiedAt: lastModified ? new Date(lastModified) : new Date(),
+            };
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError || error instanceof storage_errors_1.MetadataError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.MetadataError(message);
+        }
+    }
+    async listFiles(directoryPath = '', options = {}) {
+        try {
+            const params = new URLSearchParams();
+            if (directoryPath) {
+                params.append('directory', directoryPath);
+            }
+            if (options.limit) {
+                params.append('limit', options.limit.toString());
+            }
+            if (options.offset) {
+                params.append('offset', options.offset.toString());
+            }
+            if (options.prefix) {
+                params.append('prefix', options.prefix);
+            }
+            const queryString = params.toString();
+            const endpoint = queryString ? `/files?${queryString}` : '/files';
+            const result = await this.request('GET', endpoint);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.ListError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.ListError(message);
+        }
+    }
+    async fileExists(path) {
+        try {
+            await this.getFileMetadata(path);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError) {
+                return false;
+            }
+            throw error;
+        }
+    }
+}
+exports.StorageClient = StorageClient;
+//# sourceMappingURL=storage-client.js.map

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

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

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

@@ -0,0 +1,20 @@
+import { Readable } from 'stream';
+import type { FileMetadata, ListFilesOptions, StorageCoreOptions } from '../types';
+export declare class StorageCore {
+    private readonly rootPath;
+    private readonly maxFileSize;
+    private readonly allowedMimeTypes;
+    constructor(options: StorageCoreOptions);
+    private ensureDirectoryExists;
+    uploadFile(filePath: string, buffer: Buffer, mimeType: string, prefix?: string): Promise<string>;
+    downloadFile(path: string): Promise<Readable>;
+    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>;
+    private getMimeTypeFromExtension;
+}
+//# sourceMappingURL=storage-core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-core.d.ts","sourceRoot":"","sources":["../../src/core/storage-core.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAKlC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAYnF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;gBAEhC,OAAO,EAAE,kBAAkB;IAOvC,OAAO,CAAC,qBAAqB;IAMvB,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IA2CZ,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiCpD,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;IAuD9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhD,OAAO,CAAC,wBAAwB;CAgBjC"}

package/dist/core/storage-core.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageCore = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const uuid_1 = require("uuid");
+const path_sanitizer_1 = require("../helpers/path-sanitizer");
+const mime_validator_1 = require("../helpers/mime-validator");
+const size_parser_1 = require("../helpers/size-parser");
+const storage_errors_1 = require("../errors/storage-errors");
+class StorageCore {
+    rootPath;
+    maxFileSize;
+    allowedMimeTypes;
+    constructor(options) {
+        this.rootPath = options.rootPath;
+        this.maxFileSize = (0, size_parser_1.parseMaxFileSize)(options.maxFileSize ?? '50mb');
+        this.allowedMimeTypes = options.allowedMimeTypes ?? ['*'];
+        this.ensureDirectoryExists(this.rootPath);
+    }
+    ensureDirectoryExists(path) {
+        if (!(0, fs_1.existsSync)(path)) {
+            (0, fs_1.mkdirSync)(path, { recursive: true });
+        }
+    }
+    async uploadFile(filePath, buffer, mimeType, prefix) {
+        try {
+            // Sanitizar path
+            const sanitizedPath = (0, path_sanitizer_1.sanitizePath)(filePath);
+            const fullPath = (0, path_1.join)(this.rootPath, sanitizedPath);
+            // Verificar MIME type permitido
+            if (!(0, mime_validator_1.isMimeTypeAllowed)(mimeType, this.allowedMimeTypes)) {
+                throw new storage_errors_1.InvalidMimeTypeError(mimeType);
+            }
+            // Verificar tamaño
+            if (buffer.length > this.maxFileSize) {
+                throw new storage_errors_1.FileTooLargeError(`${this.maxFileSize / (1024 * 1024)}mb`);
+            }
+            // Crear directorio si no existe
+            this.ensureDirectoryExists(fullPath);
+            // Generar nombre único. El prefix no debe contener / (evitar path en nombre).
+            const namePrefix = prefix && prefix.includes('/') ? prefix.split('/').pop() ?? undefined : prefix;
+            const fileExtension = mimeType.split('/')[1] ?? 'bin';
+            const fileName = namePrefix
+                ? `${namePrefix}@${(0, uuid_1.v4)()}.${fileExtension}`
+                : `${(0, uuid_1.v4)()}.${fileExtension}`;
+            const finalPath = (0, path_1.join)(fullPath, fileName);
+            // Escribir archivo
+            (0, fs_1.writeFileSync)(finalPath, buffer);
+            // Retornar ruta relativa desde rootPath
+            return (0, path_1.join)(sanitizedPath, fileName).replace(/\\/g, '/');
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.InvalidMimeTypeError || error instanceof storage_errors_1.FileTooLargeError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.UploadError(message);
+        }
+    }
+    async downloadFile(path) {
+        try {
+            const sanitizedPath = (0, path_sanitizer_1.sanitizePath)(path);
+            const fullPath = (0, path_1.join)(this.rootPath, sanitizedPath);
+            if (!(0, fs_1.existsSync)(fullPath)) {
+                throw new storage_errors_1.FileNotFoundError();
+            }
+            return (0, fs_1.createReadStream)(fullPath);
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.DownloadError(message);
+        }
+    }
+    async deleteFile(path) {
+        try {
+            const sanitizedPath = (0, path_sanitizer_1.sanitizePath)(path);
+            const fullPath = (0, path_1.join)(this.rootPath, sanitizedPath);
+            if (!(0, fs_1.existsSync)(fullPath)) {
+                throw new storage_errors_1.FileNotFoundError();
+            }
+            (0, fs_1.unlinkSync)(fullPath);
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.DeleteError(message);
+        }
+    }
+    async getFileMetadata(path) {
+        try {
+            const sanitizedPath = (0, path_sanitizer_1.sanitizePath)(path);
+            const fullPath = (0, path_1.join)(this.rootPath, sanitizedPath);
+            if (!(0, fs_1.existsSync)(fullPath)) {
+                throw new storage_errors_1.FileNotFoundError();
+            }
+            const stats = (0, fs_1.statSync)(fullPath);
+            const fileName = fullPath.split(/[/\\]/).pop() ?? '';
+            // Intentar detectar MIME type desde extensión
+            const extension = fileName.split('.').pop()?.toLowerCase() ?? '';
+            const mimeType = this.getMimeTypeFromExtension(extension);
+            return {
+                name: fileName,
+                path: sanitizedPath,
+                size: stats.size,
+                mimeType,
+                createdAt: stats.birthtime,
+                modifiedAt: stats.mtime,
+            };
+        }
+        catch (error) {
+            if (error instanceof storage_errors_1.FileNotFoundError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.MetadataError(message);
+        }
+    }
+    async listFiles(directoryPath = '', options = {}) {
+        try {
+            const sanitizedPath = (0, path_sanitizer_1.sanitizePath)(directoryPath, { allowEmpty: true });
+            const fullPath = (0, path_1.join)(this.rootPath, sanitizedPath);
+            if (!(0, fs_1.existsSync)(fullPath)) {
+                return { files: [], total: 0 };
+            }
+            const files = [];
+            const entries = (0, fs_1.readdirSync)(fullPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isFile()) {
+                    const filePath = (0, path_1.join)(fullPath, entry.name);
+                    const relativePath = (0, path_1.join)(sanitizedPath, entry.name).replace(/\\/g, '/');
+                    const stats = (0, fs_1.statSync)(filePath);
+                    // Filtrar por prefix si se especifica
+                    if (options.prefix && !entry.name.startsWith(options.prefix)) {
+                        continue;
+                    }
+                    const extension = entry.name.split('.').pop()?.toLowerCase() ?? '';
+                    const mimeType = this.getMimeTypeFromExtension(extension);
+                    files.push({
+                        name: entry.name,
+                        path: relativePath,
+                        size: stats.size,
+                        mimeType,
+                        createdAt: stats.birthtime,
+                        modifiedAt: stats.mtime,
+                    });
+                }
+            }
+            // Ordenar por fecha de modificación (más recientes primero)
+            files.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
+            // Aplicar paginación
+            const offset = options.offset ?? 0;
+            const limit = options.limit ?? files.length;
+            const paginatedFiles = files.slice(offset, offset + limit);
+            return {
+                files: paginatedFiles,
+                total: files.length,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new storage_errors_1.ListError(message);
+        }
+    }
+    async fileExists(path) {
+        const sanitizedPath = (0, path_sanitizer_1.sanitizePath)(path);
+        const fullPath = (0, path_1.join)(this.rootPath, sanitizedPath);
+        return (0, fs_1.existsSync)(fullPath);
+    }
+    getMimeTypeFromExtension(extension) {
+        const mimeTypes = {
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            png: 'image/png',
+            gif: 'image/gif',
+            svg: 'image/svg+xml',
+            webp: 'image/webp',
+            pdf: 'application/pdf',
+            mp4: 'video/mp4',
+            webm: 'video/webm',
+            mov: 'video/quicktime',
+        };
+        return mimeTypes[extension] ?? 'application/octet-stream';
+    }
+}
+exports.StorageCore = StorageCore;
+//# sourceMappingURL=storage-core.js.map

package/dist/core/storage-core.js.map

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

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

@@ -0,0 +1,29 @@
+export declare class StorageError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class FileNotFoundError extends StorageError {
+    constructor(message?: string);
+}
+export declare class InvalidMimeTypeError extends StorageError {
+    constructor(mimeType: string);
+}
+export declare class FileTooLargeError extends StorageError {
+    constructor(maxSize: string);
+}
+export declare class UploadError extends StorageError {
+    constructor(message: string);
+}
+export declare class DownloadError extends StorageError {
+    constructor(message: string);
+}
+export declare class DeleteError extends StorageError {
+    constructor(message: string);
+}
+export declare class MetadataError extends StorageError {
+    constructor(message: string);
+}
+export declare class ListError extends StorageError {
+    constructor(message: string);
+}
+//# sourceMappingURL=storage-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-errors.d.ts","sourceRoot":"","sources":["../../src/errors/storage-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM1C;AAED,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,OAAO,SAAyB;CAK7C;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,QAAQ,EAAE,MAAM;CAK7B;AAED,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,SAAU,SAAQ,YAAY;gBAC7B,OAAO,EAAE,MAAM;CAK5B"}

package/dist/errors/storage-errors.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListError = exports.MetadataError = exports.DeleteError = exports.DownloadError = exports.UploadError = exports.FileTooLargeError = exports.InvalidMimeTypeError = exports.FileNotFoundError = exports.StorageError = void 0;
+class StorageError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'StorageError';
+        this.code = code;
+        Object.setPrototypeOf(this, StorageError.prototype);
+    }
+}
+exports.StorageError = StorageError;
+class FileNotFoundError extends StorageError {
+    constructor(message = 'El archivo no existe') {
+        super(message, 'FILE_NOT_FOUND');
+        this.name = 'FileNotFoundError';
+        Object.setPrototypeOf(this, FileNotFoundError.prototype);
+    }
+}
+exports.FileNotFoundError = FileNotFoundError;
+class InvalidMimeTypeError extends StorageError {
+    constructor(mimeType) {
+        super(`Tipo de archivo ${mimeType} no permitido`, 'INVALID_MIME_TYPE');
+        this.name = 'InvalidMimeTypeError';
+        Object.setPrototypeOf(this, InvalidMimeTypeError.prototype);
+    }
+}
+exports.InvalidMimeTypeError = InvalidMimeTypeError;
+class FileTooLargeError extends StorageError {
+    constructor(maxSize) {
+        super(`El archivo excede el tamaño máximo de ${maxSize}`, 'FILE_TOO_LARGE');
+        this.name = 'FileTooLargeError';
+        Object.setPrototypeOf(this, FileTooLargeError.prototype);
+    }
+}
+exports.FileTooLargeError = FileTooLargeError;
+class UploadError extends StorageError {
+    constructor(message) {
+        super(`Error al subir el archivo: ${message}`, 'UPLOAD_ERROR');
+        this.name = 'UploadError';
+        Object.setPrototypeOf(this, UploadError.prototype);
+    }
+}
+exports.UploadError = UploadError;
+class DownloadError extends StorageError {
+    constructor(message) {
+        super(`Error al descargar el archivo: ${message}`, 'DOWNLOAD_ERROR');
+        this.name = 'DownloadError';
+        Object.setPrototypeOf(this, DownloadError.prototype);
+    }
+}
+exports.DownloadError = DownloadError;
+class DeleteError extends StorageError {
+    constructor(message) {
+        super(`Error al eliminar el archivo: ${message}`, 'DELETE_ERROR');
+        this.name = 'DeleteError';
+        Object.setPrototypeOf(this, DeleteError.prototype);
+    }
+}
+exports.DeleteError = DeleteError;
+class MetadataError extends StorageError {
+    constructor(message) {
+        super(`Error al obtener metadata: ${message}`, 'METADATA_ERROR');
+        this.name = 'MetadataError';
+        Object.setPrototypeOf(this, MetadataError.prototype);
+    }
+}
+exports.MetadataError = MetadataError;
+class ListError extends StorageError {
+    constructor(message) {
+        super(`Error al listar archivos: ${message}`, 'LIST_ERROR');
+        this.name = 'ListError';
+        Object.setPrototypeOf(this, ListError.prototype);
+    }
+}
+exports.ListError = ListError;
+//# sourceMappingURL=storage-errors.js.map

package/dist/errors/storage-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-errors.js","sourceRoot":"","sources":["../../src/errors/storage-errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AATD,oCASC;AAED,MAAa,iBAAkB,SAAQ,YAAY;IACjD,YAAY,OAAO,GAAG,sBAAsB;QAC1C,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAND,8CAMC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IACpD,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,eAAe,EAAE,mBAAmB,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAND,oDAMC;AAED,MAAa,iBAAkB,SAAQ,YAAY;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,yCAAyC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAND,8CAMC;AAED,MAAa,WAAY,SAAQ,YAAY;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,8BAA8B,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF;AAND,kCAMC;AAED,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,kCAAkC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAND,sCAMC;AAED,MAAa,WAAY,SAAQ,YAAY;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,iCAAiC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF;AAND,kCAMC;AAED,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,8BAA8B,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAND,sCAMC;AAED,MAAa,SAAU,SAAQ,YAAY;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,6BAA6B,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAND,8BAMC"}

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

@@ -0,0 +1,2 @@
+export declare function isMimeTypeAllowed(mimeType: string, allowedPatterns: string[]): boolean;
+//# sourceMappingURL=mime-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mime-validator.d.ts","sourceRoot":"","sources":["../../src/helpers/mime-validator.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAcT"}

package/dist/helpers/mime-validator.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMimeTypeAllowed = isMimeTypeAllowed;
+function isMimeTypeAllowed(mimeType, allowedPatterns) {
+    if (allowedPatterns.includes('*')) {
+        return true;
+    }
+    return allowedPatterns.some((pattern) => {
+        if (pattern.endsWith('/*')) {
+            // Patrón tipo "image/*"
+            const prefix = pattern.slice(0, -2);
+            return mimeType.startsWith(prefix + '/');
+        }
+        // Patrón exacto
+        return mimeType === pattern;
+    });
+}
+//# sourceMappingURL=mime-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mime-validator.js","sourceRoot":"","sources":["../../src/helpers/mime-validator.ts"],"names":[],"mappings":";;AAAA,8CAiBC;AAjBD,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,eAAyB;IAEzB,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,wBAAwB;YACxB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACpC,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,gBAAgB;QAChB,OAAO,QAAQ,KAAK,OAAO,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,8 @@
+import { type ValidatePathOptions } from './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).
+ */
+export declare function sanitizePath(inputPath: string, options?: ValidatePathOptions): string;
+//# sourceMappingURL=path-sanitizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-sanitizer.d.ts","sourceRoot":"","sources":["../../src/helpers/path-sanitizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAcR"}