@putkoff/abstract-logger 0.0.17 → 0.0.18

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

@@ -1,4 +1,4 @@
-type LogType = "info" | "warn" | "error" | "debug" | null;
+export type LogType = "info" | "warn" | "error" | "debug" | null;
 /** Exported logger */
 export declare const logger: any;
 /**
@@ -6,5 +6,13 @@ export declare const logger: any;
  * Returns "unknown" ONLY if all inputs are invalid.
  */
 export declare function resolveValue<T = string>(...values: Array<T | string | null | undefined>): T | "unknown";
+export interface LogStringOptions {
+    message: string;
+    logType?: LogType;
+    details?: any;
+    function_name?: any;
+    file_location?: any;
+    consumerLogger?: any;
+}
+export declare function getLogString(options: LogStringOptions): string;
 export declare function getLogString(message: string, logType?: LogType, details?: any, function_name?: any, file_location?: any, consumerLogger?: any): string;
-export {};

package/dist/esm/index.js

@@ -14569,24 +14569,44 @@ function resolveLogger(candidate) {
 /* ------------------------------------------------------------------ */
 /* UNIVERSAL getLogString (cannot crash)                               */
 /* ------------------------------------------------------------------ */
-function getLogString(message, logType = null, details = null, function_name = null, file_location = null, consumerLogger = null) {
-    let { functionName, file } = getCallerInfo();
-    function_name = resolveValue(functionName !== "unknown" ? functionName : null, function_name);
-    file_location = resolveValue(file !== "unknown" ? file : null, file_location);
+function getLogString(messageOrOptions, logType = null, details = null, function_name = null, file_location = null, consumerLogger = null) {
+    // ---------------- Normalize inputs ----------------
+    let opts;
+    if (typeof messageOrOptions === "object" && messageOrOptions !== null) {
+        // Dict-style
+        opts = messageOrOptions;
+    }
+    else {
+        // Positional-style
+        opts = {
+            message: messageOrOptions,
+            logType,
+            details,
+            function_name,
+            file_location,
+            consumerLogger,
+        };
+    }
+    let { message, logType: resolvedLogType, details: resolvedDetails, function_name: resolvedFunctionName, file_location: resolvedFileLocation, consumerLogger: resolvedLoggerInput, } = opts;
+    // ---------------- Resolve caller info ----------------
+    const { functionName, file } = getCallerInfo();
+    resolvedFunctionName = resolveValue(functionName !== "unknown" ? functionName : null, resolvedFunctionName);
+    resolvedFileLocation = resolveValue(file !== "unknown" ? file : null, resolvedFileLocation);
     const emojiMap = {
         info: "ℹ️",
         warn: "⚠️",
         error: "❌",
         debug: "🔍",
     };
-    logType = logType || "info";
-    const emoji = emojiMap[logType] ?? "ℹ️";
+    const finalLogType = resolvedLogType ?? "info";
+    const emoji = emojiMap[finalLogType] ?? "ℹ️";
     const timestamp = new Date().toISOString();
-    let line = `${emoji} [${timestamp}] [${function_name}] ${message}`;
-    if (details !== null && details !== undefined) {
+    let line = `${emoji} [${timestamp}] [${resolvedFunctionName}] ${message}`;
+    // ---------------- Details serialization ----------------
+    if (resolvedDetails !== null && resolvedDetails !== undefined) {
         try {
             const seen = new WeakSet();
-            const safe = JSON.stringify(details, (key, value) => {
+            const safe = JSON.stringify(resolvedDetails, (key, value) => {
                 if (typeof value === "function")
                     return undefined;
                 if (typeof value === "bigint")
@@ -14604,22 +14624,26 @@ function getLogString(message, logType = null, details = null, function_name = n
             line += ` | [unserializable details]`;
         }
     }
-    line += ` | ${file_location}`;
-    /* ---------------- Browser ---------------- */
+    line += ` | ${resolvedFileLocation}`;
+    // ---------------- Browser ----------------
     if (IS_BROWSER) {
-        console[logType === "error" ? "error" :
-            logType === "warn" ? "warn" :
-                logType === "debug" ? "debug" : "log"](line);
+        console[finalLogType === "error"
+            ? "error"
+            : finalLogType === "warn"
+                ? "warn"
+                : finalLogType === "debug"
+                    ? "debug"
+                    : "log"](line);
         return line;
     }
-    /* ---------------- Node ---------------- */
-    const activeLogger = resolveLogger(consumerLogger);
+    // ---------------- Node ----------------
+    const activeLogger = resolveLogger(resolvedLoggerInput);
     if (!activeLogger) {
         console.log(line);
         return line;
     }
     try {
-        switch (logType) {
+        switch (finalLogType) {
             case "error":
                 activeLogger.error(line);
                 break;