@putkoff/abstract-logger 0.0.13 → 0.0.15

package/dist/cjs/types/detect/index.d.ts

@@ -0,0 +1 @@
+export * from './utils';

package/dist/cjs/types/detect/utils.d.ts

@@ -0,0 +1,5 @@
+/** ---------------------------------------------------------
+ * Detect Environment
+ * --------------------------------------------------------- */
+export declare const IS_BROWSER: boolean;
+export declare const IS_NODE: boolean;

package/dist/cjs/types/logger/logger.d.ts

@@ -1,10 +1,3 @@
-/** ---------------------------------------------------------
- *  Core Logger
- *  --------------------------------------------------------- */
-export declare const logger: import("winston").Logger;
-/** Child logger factory */
-export declare function createChildLogger(label: string): import("winston").Logger;
-/** ---------------------------------------------------------
- *  ZERO-BOILERPLATE getLogString
- * --------------------------------------------------------- */
+/** Exported logger */
+export declare const logger: any;
 export declare function getLogString(message: string, details?: any, logType?: "info" | "warn" | "error" | "debug", consumerLogger?: any): string;

package/dist/esm/index.js

@@ -14460,96 +14460,137 @@ var container = class Container {
 } (winston));
 
 /** ---------------------------------------------------------
- *  Core Logger
- *  --------------------------------------------------------- */
-const logger = winston.createLogger({
-    level: "info",
-    format: winston.format.combine(winston.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston.format.errors({ stack: true }), winston.format.splat(), winston.format.printf(({ timestamp, level, message, stack }) => {
-        return `${timestamp} [${level}] ${message}${stack ? "\n" + stack : ""}`;
-    })),
-    transports: [
-        new winston.transports.Console(),
-        new winston.transports.File({ filename: "logs/error.log", level: "error" }),
-        new winston.transports.File({ filename: "logs/combined.log" }),
-    ],
-});
-/** Child logger factory */
-function createChildLogger(label) {
-    return logger.child({ label });
-}
-/** ---------------------------------------------------------
- *  INTERNAL: capture calling stack frame
+ * Detect Environment
  * --------------------------------------------------------- */
+const IS_BROWSER = typeof window !== "undefined" &&
+    typeof window.document !== "undefined";
+const IS_NODE = typeof process !== "undefined" &&
+    process.release?.name === "node";
+
+/* ------------------------------------------------------------------ */
+/* Winston logger (Node only)                                          */
+/* ------------------------------------------------------------------ */
+let nodeLogger = null;
+if (IS_NODE) {
+    nodeLogger = winston.createLogger({
+        level: "info",
+        format: winston.format.combine(winston.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston.format.errors({ stack: true }), winston.format.printf(({ timestamp, level, message, stack }) => {
+            return `${timestamp} [${level}] ${message}${stack ? "\n" + stack : ""}`;
+        })),
+        transports: [
+            new winston.transports.Console(),
+            new winston.transports.File({ filename: "logs/error.log", level: "error" }),
+            new winston.transports.File({ filename: "logs/combined.log" }),
+        ],
+    });
+}
+/** Exported logger */
+const logger = nodeLogger;
+/* ------------------------------------------------------------------ */
+/* Stack inspection                                                    */
+/* ------------------------------------------------------------------ */
 function getCallerInfo() {
+    if (!IS_NODE) {
+        return { functionName: "browser", file: "browser" };
+    }
     const obj = {};
     Error.captureStackTrace(obj, getCallerInfo);
     const stack = obj.stack?.split("\n") ?? [];
-    // look for the first non-logger frame
-    const frame = stack.find((line) => !line.includes("getCallerInfo") && !line.includes("getLogString"));
-    if (!frame) {
-        return { file: "unknown", functionName: "unknown" };
-    }
-    /** Parse things like:
-     *   at processTxns (src/server/rabbitMq/processors/processLogs.ts:25:10)
-     *   at src/server/.../file.ts:10:5
-     */
-    const functionMatch = frame.match(/at\s+([^\s(]+)/);
+    const frame = stack.find((line) => !line.includes("getLogString") &&
+        !line.includes("logger.ts"));
+    if (!frame)
+        return { functionName: "unknown", file: "unknown" };
+    const fnMatch = frame.match(/at\s+([^\s(]+)/);
     const fileMatch = frame.match(/\((.*?):\d+:\d+\)|at\s+(.*?):\d+:\d+/);
     return {
-        functionName: functionMatch?.[1] ?? "anonymous",
+        functionName: fnMatch?.[1] ?? "anonymous",
         file: fileMatch?.[1] || fileMatch?.[2] || "unknown",
     };
 }
-/** ---------------------------------------------------------
- *  ZERO-BOILERPLATE getLogString
- * --------------------------------------------------------- */
+/* ------------------------------------------------------------------ */
+/* Safe logger resolver                                                */
+/* ------------------------------------------------------------------ */
+function resolveLogger(candidate) {
+    if (candidate &&
+        typeof candidate.info === "function" &&
+        typeof candidate.error === "function") {
+        return candidate;
+    }
+    if (logger &&
+        typeof logger.info === "function" &&
+        typeof logger.error === "function") {
+        return logger;
+    }
+    return null;
+}
+/* ------------------------------------------------------------------ */
+/* UNIVERSAL getLogString (cannot crash)                               */
+/* ------------------------------------------------------------------ */
 function getLogString(message, details = null, logType = "info", consumerLogger = null) {
-    const tempLogger = consumerLogger || logger;
     const { functionName, file } = getCallerInfo();
-    // Emoji mapping
     const emojiMap = {
-        info: "✅",
+        info: "ℹ️",
         warn: "⚠️",
         error: "❌",
         debug: "🔍",
     };
-    const emoji = emojiMap[logType] || "ℹ️";
+    const emoji = emojiMap[logType] ?? "ℹ️";
     const timestamp = new Date().toISOString();
-    // Build initial log line
-    let logMessage = `${emoji} [${timestamp}] [${functionName}] ${message} | File: ${file}`;
-    // JSON-safe details
-    if (details) {
-        const seen = new WeakSet();
-        const safe = JSON.stringify(details, (key, value) => {
-            if (typeof value === "function")
-                return undefined;
-            if (typeof value === "bigint")
-                return value.toString();
-            if (typeof value === "object" && value !== null) {
-                if (seen.has(value))
-                    return "[Circular]";
-                seen.add(value);
-            }
-            return value;
-        }, 2);
-        logMessage += ` | Details: ${safe}`;
+    let line = `${emoji} [${timestamp}] [${functionName}] ${message} | ${file}`;
+    if (details !== null && details !== undefined) {
+        try {
+            const seen = new WeakSet();
+            const safe = JSON.stringify(details, (key, value) => {
+                if (typeof value === "function")
+                    return undefined;
+                if (typeof value === "bigint")
+                    return value.toString();
+                if (typeof value === "object" && value !== null) {
+                    if (seen.has(value))
+                        return "[Circular]";
+                    seen.add(value);
+                }
+                return value;
+            }, 2);
+            line += ` | ${safe}`;
+        }
+        catch {
+            line += ` | [unserializable details]`;
+        }
+    }
+    /* ---------------- Browser ---------------- */
+    if (IS_BROWSER) {
+        console[logType === "error" ? "error" :
+            logType === "warn" ? "warn" :
+                logType === "debug" ? "debug" : "log"](line);
+        return line;
+    }
+    /* ---------------- Node ---------------- */
+    const activeLogger = resolveLogger(consumerLogger);
+    if (!activeLogger) {
+        console.log(line);
+        return line;
+    }
+    try {
+        switch (logType) {
+            case "error":
+                activeLogger.error(line);
+                break;
+            case "warn":
+                activeLogger.warn(line);
+                break;
+            case "debug":
+                activeLogger.debug(line);
+                break;
+            default:
+                activeLogger.info(line);
+        }
     }
-    // Dispatch to real logger
-    switch (logType) {
-        case "error":
-            tempLogger.error(logMessage);
-            break;
-        case "warn":
-            tempLogger.warn(logMessage);
-            break;
-        case "debug":
-            tempLogger.debug(logMessage);
-            break;
-        default:
-            tempLogger.info(logMessage);
+    catch {
+        console.log(line);
     }
-    return logMessage;
+    return line;
 }
 
-export { createChildLogger, getLogString, logger };
+export { getLogString, logger };
 //# sourceMappingURL=index.js.map