@jmlq/logger-plugin-fs 0.1.0-alpha.8 → 0.1.0-alpha.9

package/dist/infrastructure/adapters/node-file-path.adapter.d.ts

@@ -1,16 +0,0 @@
-import { FilePath } from "../../domain/value-objects/file-path.vo";
-import { IFilePathAdapterPort } from "../../domain/ports/file-path-adapter.port";
-/**
- * Adapter concreto basado en Node.js (`path`) que construye y transforma FilePath.
- * Es infraestructura pura que implementa el port de dominio.
- */
-export declare class NodeFilePathAdapter implements IFilePathAdapterPort {
-    fromRaw(inputPath: string): FilePath;
-    fromBasename(directory: string, basename: string, extension: string): FilePath;
-    withExtension(filePath: FilePath, newExtension: string): FilePath;
-    withBasename(filePath: FilePath, newBasename: string): FilePath;
-    join(filePath: FilePath, ...segments: string[]): FilePath;
-    resolve(filePath: FilePath, ...segments: string[]): FilePath;
-    relativeTo(basePath: string, filePath: FilePath): string;
-    private buildFromAbsolute;
-}

package/dist/infrastructure/adapters/node-file-path.adapter.js

@@ -1,117 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeFilePathAdapter = void 0;
-const path = __importStar(require("path"));
-const file_path_vo_1 = require("../../domain/value-objects/file-path.vo");
-/**
- * Adapter concreto basado en Node.js (`path`) que construye y transforma FilePath.
- * Es infraestructura pura que implementa el port de dominio.
- */
-class NodeFilePathAdapter {
-    fromRaw(inputPath) {
-        if (!inputPath || typeof inputPath !== "string") {
-            throw new Error("NodeFilePathAdapter.fromRaw: inputPath must be a non-empty string");
-        }
-        const trimmed = inputPath.trim();
-        if (!trimmed) {
-            throw new Error("NodeFilePathAdapter.fromRaw: inputPath cannot be empty or whitespace");
-        }
-        const absolutePath = path.resolve(trimmed);
-        return this.buildFromAbsolute(absolutePath);
-    }
-    fromBasename(directory, basename, extension) {
-        if (!directory || !basename) {
-            throw new Error("NodeFilePathAdapter.fromBasename: directory and basename are required");
-        }
-        const ext = extension
-            ? extension.startsWith(".")
-                ? extension
-                : `.${extension}`
-            : "";
-        const fullPath = path.join(directory, basename + ext);
-        const absolutePath = path.resolve(fullPath);
-        return this.buildFromAbsolute(absolutePath);
-    }
-    withExtension(filePath, newExtension) {
-        const ext = newExtension.startsWith(".")
-            ? newExtension
-            : `.${newExtension}`;
-        const filename = filePath.basename + ext;
-        const absolutePath = path.join(filePath.directory, filename);
-        return this.buildFromAbsolute(absolutePath);
-    }
-    withBasename(filePath, newBasename) {
-        if (!newBasename || !newBasename.trim()) {
-            throw new Error("NodeFilePathAdapter.withBasename: newBasename must be a non-empty string");
-        }
-        const filename = newBasename + filePath.extension;
-        const absolutePath = path.join(filePath.directory, filename);
-        return this.buildFromAbsolute(absolutePath);
-    }
-    join(filePath, ...segments) {
-        const absolutePath = path.join(filePath.absolutePath, ...segments);
-        return this.buildFromAbsolute(absolutePath);
-    }
-    resolve(filePath, ...segments) {
-        const absolutePath = path.resolve(filePath.absolutePath, ...segments);
-        return this.buildFromAbsolute(absolutePath);
-    }
-    relativeTo(basePath, filePath) {
-        if (!basePath || !basePath.trim()) {
-            throw new Error("NodeFilePathAdapter.relativeTo: basePath must be a non-empty string");
-        }
-        return path.relative(path.resolve(basePath.trim()), filePath.absolutePath);
-    }
-    // ────────────────────────────────────────────
-    // Helper privado: construye IFilePathProps
-    // ────────────────────────────────────────────
-    buildFromAbsolute(absolutePath) {
-        const normalized = path.resolve(absolutePath);
-        const directory = path.dirname(normalized);
-        const filename = path.basename(normalized);
-        const extension = path.extname(normalized);
-        const basename = path.basename(normalized, extension);
-        const props = {
-            absolutePath: normalized,
-            directory,
-            filename,
-            extension,
-            basename,
-        };
-        return new file_path_vo_1.FilePath(props);
-    }
-}
-exports.NodeFilePathAdapter = NodeFilePathAdapter;

package/dist/infrastructure/filesystem/polices/index.d.ts

@@ -1 +0,0 @@
-export { RotationPolicy } from "./rotation-policy";

package/dist/infrastructure/filesystem/polices/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RotationPolicy = void 0;
-var rotation_policy_1 = require("./rotation-policy");
-Object.defineProperty(exports, "RotationPolicy", { enumerable: true, get: function () { return rotation_policy_1.RotationPolicy; } });

package/dist/infrastructure/filesystem/polices/rotation-policy.d.ts

@@ -1,29 +0,0 @@
-import { FsRotationBy } from "..";
-import { FileSize } from "../../../domain/value-objects/file-size.vo";
-/**
- * Es un Value Object de dominio que encapsula la política de rotación de logs
- * by: cómo se rota → "none" | "day" | "size".
- * maxSizeMB: umbral de tamaño (solo tiene sentido para "size").
- * maxFiles: cuántos archivos rotados se mantienen (concepto típico en rotation).
- */
-export declare class RotationPolicy {
-    private readonly _by;
-    private readonly _maxSize?;
-    private readonly _maxFiles?;
-    constructor(by: FsRotationBy, maxSizeMB?: number, maxFiles?: number);
-    get by(): FsRotationBy;
-    get maxSizeMB(): number | undefined;
-    get maxSize(): FileSize | undefined;
-    get maxFiles(): number | undefined;
-    /**
-     * Lógica de negocio mejorada usando FileSize value object
-     * @param currentSize Tamaño actual del archivo como FileSize
-     * @returns true si debe rotar por tamaño
-     */
-    shouldRotateBySize(currentSize: FileSize): boolean;
-    /**
-     * Método de compatibilidad para tamaños en bytes
-     * Usar shouldRotateBySize(FileSize) en su lugar
-     */
-    shouldRotateBySizeBytes(currentSizeBytes: number): boolean;
-}

package/dist/infrastructure/filesystem/polices/rotation-policy.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RotationPolicy = void 0;
-const file_size_vo_1 = require("../../../domain/value-objects/file-size.vo");
-/**
- * Es un Value Object de dominio que encapsula la política de rotación de logs
- * by: cómo se rota → "none" | "day" | "size".
- * maxSizeMB: umbral de tamaño (solo tiene sentido para "size").
- * maxFiles: cuántos archivos rotados se mantienen (concepto típico en rotation).
- */
-class RotationPolicy {
-    constructor(by, maxSizeMB, maxFiles) {
-        if (!["none", "day", "size"].includes(by)) {
-            throw new Error("RotationPolicy: invalid rotation strategy");
-        }
-        if (by === "size" && (maxSizeMB == null || maxSizeMB <= 0)) {
-            throw new Error("RotationPolicy: maxSizeMB must be positive for size rotation");
-        }
-        this._by = by;
-        this._maxSize = maxSizeMB ? file_size_vo_1.FileSize.fromMegabytes(maxSizeMB) : undefined;
-        this._maxFiles = maxFiles;
-    }
-    get by() {
-        return this._by;
-    }
-    get maxSizeMB() {
-        return this._maxSize?.megabytes;
-    }
-    get maxSize() {
-        return this._maxSize;
-    }
-    get maxFiles() {
-        return this._maxFiles;
-    }
-    /**
-     * Lógica de negocio mejorada usando FileSize value object
-     * @param currentSize Tamaño actual del archivo como FileSize
-     * @returns true si debe rotar por tamaño
-     */
-    shouldRotateBySize(currentSize) {
-        if (this._by !== "size" || !this._maxSize) {
-            return false;
-        }
-        return (currentSize.isGreaterThan(this._maxSize) ||
-            currentSize.equals(this._maxSize));
-    }
-    /**
-     * Método de compatibilidad para tamaños en bytes
-     * Usar shouldRotateBySize(FileSize) en su lugar
-     */
-    shouldRotateBySizeBytes(currentSizeBytes) {
-        return this.shouldRotateBySize(new file_size_vo_1.FileSize(currentSizeBytes));
-    }
-}
-exports.RotationPolicy = RotationPolicy;

package/dist/infrastructure/filesystem/ports/file-rotator.port.d.ts

@@ -1,32 +0,0 @@
-import { FileSize, FilePath } from "../../../domain/value-objects";
-import { RotationPolicy } from "../polices";
-/**
- * "Puente" entre dominio y filesystem
- */
-export interface IFileRotatorPort {
-    /**
-     * Saber qué archivo de log está activo ahora
-     */
-    getCurrentPath(): FilePath | null;
-    /**
-     * Calcular cómo se va a llamar el archivo según una fecha
-     * @param date Fecha para la que se quiere el path
-     */
-    getExpectedPathForDate(date: Date): FilePath;
-    /**
-     * Consultar metadata del archivo usando FileSize value object
-     * @param filePath Ruta del archivo como FilePath
-     */
-    getFileSize(filePath: FilePath): Promise<FileSize>;
-    /**
-     * Saber qué índice usar para el siguiente archivo rotado
-     * @param baseFilePath Ruta base del archivo como FilePath
-     */
-    getNextRotationIndex(baseFilePath: FilePath): Promise<number>;
-    /**
-     * Decidir si corresponde rotar de acuerdo a una RotationPolicy y la fecha actual
-     * @param policy Política de rotación
-     * @param currentDate Fecha actual
-     */
-    shouldRotate(policy: RotationPolicy, currentDate: Date): Promise<boolean>;
-}

package/dist/infrastructure/filesystem/types/filesystem-serializer.type.d.ts

@@ -1,10 +0,0 @@
-/**
- * Es una estrategia de serialización usada por el datasource de filesystem para convertir cualquier entrada (entry: unknown) en una cadena (string) antes de escribirla en el archivo.
- */
-export interface IFsSerializer {
-    /**
-     * Serializa una entrada genérica a string
-     * @param entry Entrada a serializar
-     */
-    serialize(entry: unknown): string;
-}

package/dist/infrastructure/filesystem/value-objects/file-name-pattern.vo.d.ts

@@ -1,22 +0,0 @@
-/**
- * representa el patrón de nombrado de archivos de log
- */
-export declare class FileNamePattern {
-    private readonly _pattern;
-    constructor(pattern: string);
-    /**
-     * Retorna el valor inmutable
-     */
-    get pattern(): string;
-    /**
-     * Indica si el patrón contiene tokens de fecha
-     * Útil para detectar si el nombre del archivo depende de fecha
-     * @returns true si el patrón contiene tokens de fecha, false en caso contrario
-     */
-    hasDateTokens(): boolean;
-    /**
-     * Devuelve todos los tokens encerrados en llaves presentes en el patrón
-     * @returns Array de tokens encontrados en el patrón
-     */
-    getTokens(): string[];
-}

package/dist/infrastructure/filesystem/value-objects/file-name-pattern.vo.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileNamePattern = void 0;
-/**
- * representa el patrón de nombrado de archivos de log
- */
-class FileNamePattern {
-    constructor(pattern) {
-        if (!pattern || typeof pattern !== "string") {
-            throw new Error("FileNamePattern: pattern must be a non-empty string");
-        }
-        this._pattern = pattern.trim();
-    }
-    /**
-     * Retorna el valor inmutable
-     */
-    get pattern() {
-        return this._pattern;
-    }
-    /**
-     * Indica si el patrón contiene tokens de fecha
-     * Útil para detectar si el nombre del archivo depende de fecha
-     * @returns true si el patrón contiene tokens de fecha, false en caso contrario
-     */
-    hasDateTokens() {
-        return /\{(yyyy|MM|dd|HH|mm|ss)\}/.test(this._pattern);
-    }
-    /**
-     * Devuelve todos los tokens encerrados en llaves presentes en el patrón
-     * @returns Array de tokens encontrados en el patrón
-     */
-    getTokens() {
-        const matches = this._pattern.match(/\{([^}]+)\}/g);
-        return matches ? matches.map((m) => m.slice(1, -1)) : [];
-    }
-}
-exports.FileNamePattern = FileNamePattern;

package/dist/infrastructure/filesystem/value-objects/index.d.ts

@@ -1 +0,0 @@
-export * from "./file-name-pattern.vo";

package/dist/shared/errors/file-operation.error.d.ts

@@ -1,12 +0,0 @@
-export declare class FileOperationError extends Error {
-    readonly operation: string;
-    readonly filePath?: string | undefined;
-    readonly cause?: Error | undefined;
-    constructor(message: string, operation: string, filePath?: string | undefined, cause?: Error | undefined);
-    static create(operation: string, filePath: string, cause?: Error): FileOperationError;
-    static createForRead(filePath: string, cause?: Error): FileOperationError;
-    static createForWrite(filePath: string, cause?: Error): FileOperationError;
-    static createForDelete(filePath: string, cause?: Error): FileOperationError;
-    static createForMkdir(filePath: string, cause?: Error): FileOperationError;
-    static createForMove(filePath: string, cause?: Error): FileOperationError;
-}

package/dist/shared/errors/file-operation.error.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileOperationError = void 0;
-class FileOperationError extends Error {
-    constructor(message, operation, filePath, cause) {
-        super(message);
-        this.operation = operation;
-        this.filePath = filePath;
-        this.cause = cause;
-        this.name = "FileOperationError";
-    }
-    static create(operation, filePath, cause) {
-        const message = `Failed to ${operation} file: ${filePath}`;
-        return new FileOperationError(message, operation, filePath, cause);
-    }
-    static createForRead(filePath, cause) {
-        return FileOperationError.create("read", filePath, cause);
-    }
-    static createForWrite(filePath, cause) {
-        return FileOperationError.create("write", filePath, cause);
-    }
-    static createForDelete(filePath, cause) {
-        return FileOperationError.create("delete", filePath, cause);
-    }
-    static createForMkdir(filePath, cause) {
-        return FileOperationError.create("create directory", filePath, cause);
-    }
-    static createForMove(filePath, cause) {
-        return FileOperationError.create("move", filePath, cause);
-    }
-}
-exports.FileOperationError = FileOperationError;

package/dist/shared/errors/fs-plugin.error.d.ts

@@ -1,4 +0,0 @@
-export declare class FsPluginError extends Error {
-    readonly cause?: Error | undefined;
-    constructor(message: string, cause?: Error | undefined);
-}

package/dist/shared/errors/fs-plugin.error.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FsPluginError = void 0;
-class FsPluginError extends Error {
-    constructor(message, cause) {
-        super(message);
-        this.cause = cause;
-        this.name = "FsPluginError";
-    }
-}
-exports.FsPluginError = FsPluginError;

package/dist/shared/errors/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./file-operation.error";
-export * from "./fs-plugin.error";
-export * from "./rotation.error";

package/dist/shared/errors/rotation.error.d.ts

@@ -1,10 +0,0 @@
-export declare class RotationError extends Error {
-    readonly rotationType: string;
-    readonly filePath?: string | undefined;
-    readonly cause?: Error | undefined;
-    constructor(message: string, rotationType: string, filePath?: string | undefined, cause?: Error | undefined);
-    static createForPolicyViolation(policy: string, reason: string): RotationError;
-    static createForFileRotation(filePath: string, cause?: Error): RotationError;
-    static createForSizeCheck(filePath: string, cause?: Error): RotationError;
-    static createForDateCheck(filePath: string, cause?: Error): RotationError;
-}

package/dist/shared/errors/rotation.error.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RotationError = void 0;
-class RotationError extends Error {
-    constructor(message, rotationType, filePath, cause) {
-        super(message);
-        this.rotationType = rotationType;
-        this.filePath = filePath;
-        this.cause = cause;
-        this.name = "RotationError";
-    }
-    static createForPolicyViolation(policy, reason) {
-        return new RotationError(`Rotation policy '${policy}' violation: ${reason}`, policy);
-    }
-    static createForFileRotation(filePath, cause) {
-        return new RotationError(`Failed to rotate file: ${filePath}`, "file", filePath, cause);
-    }
-    static createForSizeCheck(filePath, cause) {
-        return new RotationError(`Failed to check file size for rotation: ${filePath}`, "size-check", filePath, cause);
-    }
-    static createForDateCheck(filePath, cause) {
-        return new RotationError(`Failed to check file date for rotation: ${filePath}`, "date-check", filePath, cause);
-    }
-}
-exports.RotationError = RotationError;