@jmlq/logger-plugin-fs 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/infrastructure/fs/fs-writer.adapter.d.ts

@@ -0,0 +1,10 @@
+import { IFsProvider } from ".";
+import type { IStreamWriterPort } from "../../domain/contracts";
+export declare class FsWriterAdapter implements IStreamWriterPort {
+    private readonly stream;
+    constructor(fs: IFsProvider, path: string);
+    write(line: string): boolean;
+    once(event: "drain" | "error", cb: (...a: any[]) => void): void;
+    get writableNeedDrain(): boolean | undefined;
+    end(cb: () => void): void;
+}

package/dist/infrastructure/fs/fs-writer.adapter.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsWriterAdapter = void 0;
+class FsWriterAdapter {
+    constructor(fs, path) {
+        // Abre el stream en modo append ('a') para no truncar archivos existentes
+        this.stream = fs.createWriteStream(path, { flags: "a" });
+    }
+    write(line) {
+        // Escribe la línea; devuelve false si hay backpressure
+        return this.stream.write(line);
+    }
+    once(event, cb) {
+        // Suscribe un handler de un solo uso para 'drain' o 'error'
+        this.stream.once(event, cb);
+    }
+    get writableNeedDrain() {
+        // expone flag de backpressure si está presente
+        return this.stream.writableNeedDrain;
+    }
+    end(cb) {
+        // Cierra el stream drenando el buffer pendiente
+        this.stream.end(cb);
+    }
+}
+exports.FsWriterAdapter = FsWriterAdapter;

package/dist/infrastructure/fs/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./file-rotator.adapter";
+export * from "./fs-writer.adapter";
+export * from "./fs-provider";
+export * from "./path-utils";
+export * from "./node-clock.adapter";

package/dist/infrastructure/fs/index.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./file-rotator.adapter"), exports);
+__exportStar(require("./fs-writer.adapter"), exports);
+__exportStar(require("./fs-provider"), exports);
+__exportStar(require("./path-utils"), exports);
+__exportStar(require("./node-clock.adapter"), exports);

package/dist/infrastructure/fs/node-clock.adapter.d.ts

@@ -0,0 +1,4 @@
+import { IClock } from "../../domain/contracts";
+export declare class NodeClockAdapter implements IClock {
+    now(): Date;
+}

package/dist/infrastructure/fs/node-clock.adapter.js

@@ -0,0 +1,10 @@
+"use strict";
+// Reloj real del sistema.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeClockAdapter = void 0;
+class NodeClockAdapter {
+    now() {
+        return new Date();
+    }
+}
+exports.NodeClockAdapter = NodeClockAdapter;

package/dist/infrastructure/fs/path-utils.d.ts

@@ -0,0 +1,6 @@
+export declare function formatPattern(pattern: string, now: Date): string;
+export declare function splitBaseExt(fileName: string): {
+    base: string;
+    ext: string;
+};
+export declare function joinBase(basePath: string, fileName: string): string;

package/dist/infrastructure/fs/path-utils.js

@@ -0,0 +1,26 @@
+"use strict";
+// Utilidades puras de path y formateo de nombre.
+// Cambiamos a getters UTC para evitar desfaces por huso horario.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPattern = formatPattern;
+exports.splitBaseExt = splitBaseExt;
+exports.joinBase = joinBase;
+const path_1 = require("path");
+function formatPattern(pattern, now) {
+    // Usar UTC para que "2025-09-09T00:00:00Z" siga siendo 2025-09-09
+    const yyyy = now.getUTCFullYear().toString();
+    const MM = String(now.getUTCMonth() + 1).padStart(2, "0");
+    const dd = String(now.getUTCDate()).padStart(2, "0");
+    return pattern
+        .replace("{yyyy}", yyyy)
+        .replace("{MM}", MM)
+        .replace("{dd}", dd);
+}
+function splitBaseExt(fileName) {
+    const ext = (0, path_1.extname)(fileName);
+    const base = ext ? (0, path_1.basename)(fileName, ext) : fileName;
+    return { base, ext };
+}
+function joinBase(basePath, fileName) {
+    return (0, path_1.join)(basePath, fileName);
+}

package/dist/presentation/factory/create-fs-datasource.d.ts

@@ -0,0 +1,15 @@
+import { FsDatasourceService } from "../../application/services";
+import type { IFsSerializer } from "../../domain/contracts";
+export declare function createFsDatasource(input: {
+    basePath: string;
+    mkdir?: boolean;
+    fileNamePattern?: string;
+    rotation?: {
+        by: "none" | "day" | "size";
+        maxSizeMB?: number;
+        maxFiles?: number;
+    };
+    serializer?: IFsSerializer;
+    onRotate?: (oldPath: string, newPath: string) => void | Promise<void>;
+    onError?: (err: unknown) => void | Promise<void>;
+}): FsDatasourceService;

package/dist/presentation/factory/create-fs-datasource.js

@@ -0,0 +1,39 @@
+"use strict";
+// Ensambla el servicio de aplicación (que implementa ILogDatasource)
+// con los adaptadores de infraestructura. Aquí no hay lógica de negocio,
+// sólo wiring + defaults.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFsDatasource = createFsDatasource;
+const services_1 = require("../../application/services");
+const use_cases_1 = require("../../application/use-cases");
+const value_objects_1 = require("../../domain/value-objects");
+const fs_1 = require("../../infrastructure/fs");
+function createFsDatasource(input) {
+    // 1) Defaults de VO y opciones
+    const pattern = new value_objects_1.FileNamePattern(input.fileNamePattern ?? "app-{yyyy}{MM}{dd}.log");
+    const rotation = input.rotation
+        ? new value_objects_1.RotationPolicy(input.rotation.by, input.rotation.maxSizeMB, input.rotation.maxFiles)
+        : new value_objects_1.RotationPolicy("day");
+    const opts = {
+        basePath: input.basePath,
+        mkdir: !!input.mkdir,
+        pattern,
+        rotation,
+        serializer: input.serializer ?? { serialize: (x) => JSON.stringify(x) },
+        onRotate: input.onRotate,
+        onError: input.onError,
+    };
+    // 2) Adapters de infraestructura
+    const fs = (0, fs_1.createFsProvider)();
+    const clock = new fs_1.NodeClockAdapter();
+    const rotator = new fs_1.FileRotatorAdapter(fs, opts.basePath, clock, opts.pattern, !!opts.mkdir);
+    // 3) Casos de uso (application)
+    const rotateUC = new use_cases_1.RotateIfNeededUseCase(opts.rotation, rotator, clock);
+    const appendUC = new use_cases_1.AppendLogUseCase(opts.serializer);
+    // 4) Factory para abrir writers en el path que diga el rotator
+    const openWriter = (path) => new fs_1.FsWriterAdapter(fs, path);
+    // 5) Orquestador principal (application) que usará core: ILogDatasource
+    const persistUC = new use_cases_1.PersistLogUseCase(rotateUC, appendUC, rotator, openWriter, opts.onRotate, opts.onError);
+    // 6) Servicio que implementa ILogDatasource (core)
+    return new services_1.FsDatasourceService(persistUC);
+}

package/dist/presentation/factory/index.d.ts

@@ -0,0 +1 @@
+export * from "./create-fs-datasource";

package/dist/presentation/factory/index.js

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-fs-datasource"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmlq/logger-plugin-fs",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "author": "MLahuasi",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,14 +9,26 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
     "tsx": "^4.20.5",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "@swc/core": "^1.13.5",
+    "@swc/jest": "^0.2.39",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.1.3"
   },
   "dependencies": {
     "@jmlq/logger": "^0.1.0-alpha.2"
+  },
+  "overrides": {
+    "test-exclude": "^7.0.1",
+    "glob": "^10.4.5",
+    "minimatch": "^9.0.5"
   }
 }