@jmlq/logger 0.1.0-alpha.0

package/dist/Composite/index.d.ts

@@ -0,0 +1,9 @@
+import { GetLogsFilter, ILogDatasource, Log } from "..";
+export declare class CompositeDatasource implements ILogDatasource {
+    private readonly datasources;
+    constructor(datasources: ILogDatasource[]);
+    save(log: Log): Promise<void>;
+    find(filter?: GetLogsFilter): Promise<Log[]>;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}

package/dist/Composite/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositeDatasource = void 0;
+// ---- Composite fan-out ----
+class CompositeDatasource {
+    constructor(datasources) {
+        this.datasources = datasources;
+    }
+    async save(log) {
+        await Promise.allSettled(this.datasources.map((ds) => ds.save(log)));
+    }
+    async find(filter = {}) {
+        const primary = this.datasources[0];
+        return (await primary?.find?.(filter)) ?? [];
+    }
+    async flush() {
+        await Promise.all(this.datasources.map((ds) => ds.flush?.() ?? Promise.resolve()));
+    }
+    async dispose() {
+        await Promise.all(this.datasources.map((ds) => ds.dispose?.() ?? Promise.resolve()));
+    }
+}
+exports.CompositeDatasource = CompositeDatasource;

package/dist/Factory/index.d.ts

@@ -0,0 +1,5 @@
+import { ILogDatasource, Logger, LogLevel } from "..";
+export declare function createLogger(ds: ILogDatasource, opts: {
+    minLevel: LogLevel;
+    redactPII?: boolean;
+}): Logger;

package/dist/Factory/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const __1 = require("..");
+function createLogger(ds, opts) {
+    const write = async (level, message, meta) => {
+        if (level < opts.minLevel)
+            return;
+        // (Opcional) redactor PII aquí si opts.redactPII === true
+        await ds.save({ level, message, meta, timestamp: Date.now() });
+    };
+    const logger = {
+        trace: (m, meta) => write(__1.LogLevel.TRACE, m, meta),
+        debug: (m, meta) => write(__1.LogLevel.DEBUG, m, meta),
+        info: (m, meta) => write(__1.LogLevel.INFO, m, meta),
+        warn: (m, meta) => write(__1.LogLevel.WARN, m, meta),
+        error: (m, meta) => write(__1.LogLevel.ERROR, m, meta),
+        fatal: (m, meta) => write(__1.LogLevel.FATAL, m, meta),
+        flush: () => ds.flush?.() ?? Promise.resolve(),
+        dispose: () => ds.dispose?.() ?? Promise.resolve(),
+    };
+    return logger;
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./interfaces";
+export * from "./Factory";
+export * from "./Composite";

package/dist/index.js

@@ -0,0 +1,19 @@
+"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("./interfaces"), exports);
+__exportStar(require("./Factory"), exports);
+__exportStar(require("./Composite"), exports);

package/dist/interfaces/index.d.ts

@@ -0,0 +1,35 @@
+export declare enum LogLevel {
+    TRACE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    FATAL = 5
+}
+export interface Log {
+    level: LogLevel;
+    message: string;
+    meta?: unknown;
+    timestamp: number;
+}
+export interface GetLogsFilter {
+    levelMin?: LogLevel;
+    since?: number;
+    until?: number;
+}
+export interface ILogDatasource {
+    save(log: Log): Promise<void>;
+    find?(filter?: GetLogsFilter): Promise<Log[]>;
+    flush?(): Promise<void>;
+    dispose?(): Promise<void>;
+}
+export interface Logger {
+    trace: (msg: string, meta?: unknown) => Promise<void>;
+    debug: (msg: string, meta?: unknown) => Promise<void>;
+    info: (msg: string, meta?: unknown) => Promise<void>;
+    warn: (msg: string, meta?: unknown) => Promise<void>;
+    error: (msg: string, meta?: unknown) => Promise<void>;
+    fatal: (msg: string, meta?: unknown) => Promise<void>;
+    flush?: () => Promise<void>;
+    dispose?: () => Promise<void>;
+}

package/dist/interfaces/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+// ---- Types & contratos ----
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 5] = "FATAL";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@jmlq/logger",
+  "version": "0.1.0-alpha.0",
+  "author": "MLahuasi",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "pnpm build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  }
+}