@feizk/logger 2.0.0 → 2.0.1

package/dist/index.d.mts

@@ -208,4 +208,32 @@ declare const LOG_LEVEL_PRIORITIES: Record<LogLevel, number>;
  */
 declare const LEVEL_LABELS: Record<LogLevel, string>;
 
-export { type ChildLoggerOptions, type Formatter, LEVEL_LABELS, LOG_LEVEL_PRIORITIES, type LogEntry, type LogLevel, Logger, type LoggerOptions, type TimestampOption, type Transport };
+/**
+ * Get the colored label for a log level.
+ * Results are cached for performance.
+ * @param level - The log level
+ * @param enableColors - Whether to apply colors
+ * @returns The label string (colored if enabled)
+ */
+declare function getColoredLabel(level: LogLevel, enableColors: boolean): string;
+/**
+ * Format a timestamp based on the provided option.
+ * @param option - Preset string or custom formatter
+ * @param date - Date to format (default: current date)
+ * @returns Formatted timestamp string
+ */
+declare function formatTimestamp(option: TimestampOption, date?: Date): string;
+/**
+ * Format a log entry as JSON for structured logging.
+ * @param entry - The log entry to format
+ * @returns JSON string representation
+ */
+declare function formatJson(entry: LogEntry): string;
+/**
+ * Build the message string from log arguments.
+ * @param args - The log arguments
+ * @returns Formatted message string
+ */
+declare function buildMessage(args: unknown[]): string;
+
+export { type ChildLoggerOptions, type Formatter, LEVEL_LABELS, LOG_LEVEL_PRIORITIES, type LogEntry, type LogLevel, Logger, type LoggerOptions, type TimestampOption, type Transport, buildMessage, formatJson, formatTimestamp, getColoredLabel };

package/dist/index.d.ts

@@ -208,4 +208,32 @@ declare const LOG_LEVEL_PRIORITIES: Record<LogLevel, number>;
  */
 declare const LEVEL_LABELS: Record<LogLevel, string>;
 
-export { type ChildLoggerOptions, type Formatter, LEVEL_LABELS, LOG_LEVEL_PRIORITIES, type LogEntry, type LogLevel, Logger, type LoggerOptions, type TimestampOption, type Transport };
+/**
+ * Get the colored label for a log level.
+ * Results are cached for performance.
+ * @param level - The log level
+ * @param enableColors - Whether to apply colors
+ * @returns The label string (colored if enabled)
+ */
+declare function getColoredLabel(level: LogLevel, enableColors: boolean): string;
+/**
+ * Format a timestamp based on the provided option.
+ * @param option - Preset string or custom formatter
+ * @param date - Date to format (default: current date)
+ * @returns Formatted timestamp string
+ */
+declare function formatTimestamp(option: TimestampOption, date?: Date): string;
+/**
+ * Format a log entry as JSON for structured logging.
+ * @param entry - The log entry to format
+ * @returns JSON string representation
+ */
+declare function formatJson(entry: LogEntry): string;
+/**
+ * Build the message string from log arguments.
+ * @param args - The log arguments
+ * @returns Formatted message string
+ */
+declare function buildMessage(args: unknown[]): string;
+
+export { type ChildLoggerOptions, type Formatter, LEVEL_LABELS, LOG_LEVEL_PRIORITIES, type LogEntry, type LogLevel, Logger, type LoggerOptions, type TimestampOption, type Transport, buildMessage, formatJson, formatTimestamp, getColoredLabel };

package/dist/index.js

@@ -22,7 +22,11 @@ var index_exports = {};
 __export(index_exports, {
   LEVEL_LABELS: () => LEVEL_LABELS,
   LOG_LEVEL_PRIORITIES: () => LOG_LEVEL_PRIORITIES,
-  Logger: () => Logger
+  Logger: () => Logger,
+  buildMessage: () => buildMessage,
+  formatJson: () => formatJson,
+  formatTimestamp: () => formatTimestamp,
+  getColoredLabel: () => getColoredLabel
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -102,14 +106,7 @@ function formatTimestamp(option, date = /* @__PURE__ */ new Date()) {
   return preset(date);
 }
 function formatJson(entry) {
-  const message = entry.args.map((arg) => {
-    if (typeof arg === "string") return arg;
-    try {
-      return JSON.stringify(arg);
-    } catch {
-      return String(arg);
-    }
-  }).join(" ");
+  const message = entry.args.map(formatArg).join(" ");
   const output = {
     level: entry.level,
     timestamp: entry.timestamp,
@@ -123,15 +120,47 @@ function formatJson(entry) {
   }
   return JSON.stringify(output);
 }
-function buildMessage(args) {
-  return args.map((arg) => {
-    if (typeof arg === "string") return arg;
+function formatArg(arg) {
+  if (arg === null) return "null";
+  if (arg === void 0) return "undefined";
+  if (typeof arg === "string") return arg;
+  if (typeof arg === "number") return String(arg);
+  if (typeof arg === "boolean") return String(arg);
+  if (typeof arg === "bigint") return `${arg}n`;
+  if (typeof arg === "symbol") return arg.toString();
+  if (arg instanceof Error) {
+    const parts = [arg.message];
+    if (arg.name && arg.name !== "Error") parts.unshift(arg.name);
+    if (arg.stack) parts.push(arg.stack);
+    return parts.join(": ");
+  }
+  if (Array.isArray(arg)) {
     try {
       return JSON.stringify(arg);
     } catch {
       return String(arg);
     }
-  }).join(" ");
+  }
+  try {
+    return JSON.stringify(arg, getCircularReplacer());
+  } catch {
+    return String(arg);
+  }
+}
+function getCircularReplacer() {
+  const seen = /* @__PURE__ */ new WeakSet();
+  return (_key, value) => {
+    if (typeof value === "object" && value !== null) {
+      if (seen.has(value)) {
+        return "[Circular]";
+      }
+      seen.add(value);
+    }
+    return value;
+  };
+}
+function buildMessage(args) {
+  return args.map(formatArg).join(" ");
 }
 
 // src/logger.ts
@@ -156,9 +185,6 @@ var Logger = class _Logger {
     this.prefix = this.options.prefix;
     this.context = this.options.context;
   }
-  // ============================================================================
-  // Public Log Methods
-  // ============================================================================
   /**
    * Log a trace message (most verbose).
    * @param args - Arguments to log
@@ -201,9 +227,6 @@ var Logger = class _Logger {
   fatal(...args) {
     this.log("fatal", args);
   }
-  // ============================================================================
-  // Level Management
-  // ============================================================================
   /**
    * Set the minimum log level.
    * @param level - The log level to set
@@ -218,9 +241,6 @@ var Logger = class _Logger {
   getLevel() {
     return this.options.level;
   }
-  // ============================================================================
-  // Transport Management
-  // ============================================================================
   /**
    * Add a transport to the logger.
    * @param transport - The transport to add
@@ -238,9 +258,6 @@ var Logger = class _Logger {
       this.transports.splice(index, 1);
     }
   }
-  // ============================================================================
-  // Child Logger
-  // ============================================================================
   /**
    * Create a child logger with additional prefix and context.
    * @param options - Child logger options
@@ -264,9 +281,6 @@ var Logger = class _Logger {
       context: combinedContext
     });
   }
-  // ============================================================================
-  // Cleanup
-  // ============================================================================
   /**
    * Destroy the logger and all its transports.
    * Calls destroy() on all registered transports.
@@ -280,9 +294,6 @@ var Logger = class _Logger {
     await Promise.all(destroyPromises);
     this.transports.length = 0;
   }
-  // ============================================================================
-  // Private Methods
-  // ============================================================================
   /**
    * Core logging method - all public methods delegate here.
    * @param level - The log level
@@ -352,5 +363,9 @@ var Logger = class _Logger {
 0 && (module.exports = {
   LEVEL_LABELS,
   LOG_LEVEL_PRIORITIES,
-  Logger
+  Logger,
+  buildMessage,
+  formatJson,
+  formatTimestamp,
+  getColoredLabel
 });

package/dist/index.mjs

@@ -74,14 +74,7 @@ function formatTimestamp(option, date = /* @__PURE__ */ new Date()) {
   return preset(date);
 }
 function formatJson(entry) {
-  const message = entry.args.map((arg) => {
-    if (typeof arg === "string") return arg;
-    try {
-      return JSON.stringify(arg);
-    } catch {
-      return String(arg);
-    }
-  }).join(" ");
+  const message = entry.args.map(formatArg).join(" ");
   const output = {
     level: entry.level,
     timestamp: entry.timestamp,
@@ -95,15 +88,47 @@ function formatJson(entry) {
   }
   return JSON.stringify(output);
 }
-function buildMessage(args) {
-  return args.map((arg) => {
-    if (typeof arg === "string") return arg;
+function formatArg(arg) {
+  if (arg === null) return "null";
+  if (arg === void 0) return "undefined";
+  if (typeof arg === "string") return arg;
+  if (typeof arg === "number") return String(arg);
+  if (typeof arg === "boolean") return String(arg);
+  if (typeof arg === "bigint") return `${arg}n`;
+  if (typeof arg === "symbol") return arg.toString();
+  if (arg instanceof Error) {
+    const parts = [arg.message];
+    if (arg.name && arg.name !== "Error") parts.unshift(arg.name);
+    if (arg.stack) parts.push(arg.stack);
+    return parts.join(": ");
+  }
+  if (Array.isArray(arg)) {
     try {
       return JSON.stringify(arg);
     } catch {
       return String(arg);
     }
-  }).join(" ");
+  }
+  try {
+    return JSON.stringify(arg, getCircularReplacer());
+  } catch {
+    return String(arg);
+  }
+}
+function getCircularReplacer() {
+  const seen = /* @__PURE__ */ new WeakSet();
+  return (_key, value) => {
+    if (typeof value === "object" && value !== null) {
+      if (seen.has(value)) {
+        return "[Circular]";
+      }
+      seen.add(value);
+    }
+    return value;
+  };
+}
+function buildMessage(args) {
+  return args.map(formatArg).join(" ");
 }
 
 // src/logger.ts
@@ -128,9 +153,6 @@ var Logger = class _Logger {
     this.prefix = this.options.prefix;
     this.context = this.options.context;
   }
-  // ============================================================================
-  // Public Log Methods
-  // ============================================================================
   /**
    * Log a trace message (most verbose).
    * @param args - Arguments to log
@@ -173,9 +195,6 @@ var Logger = class _Logger {
   fatal(...args) {
     this.log("fatal", args);
   }
-  // ============================================================================
-  // Level Management
-  // ============================================================================
   /**
    * Set the minimum log level.
    * @param level - The log level to set
@@ -190,9 +209,6 @@ var Logger = class _Logger {
   getLevel() {
     return this.options.level;
   }
-  // ============================================================================
-  // Transport Management
-  // ============================================================================
   /**
    * Add a transport to the logger.
    * @param transport - The transport to add
@@ -210,9 +226,6 @@ var Logger = class _Logger {
       this.transports.splice(index, 1);
     }
   }
-  // ============================================================================
-  // Child Logger
-  // ============================================================================
   /**
    * Create a child logger with additional prefix and context.
    * @param options - Child logger options
@@ -236,9 +249,6 @@ var Logger = class _Logger {
       context: combinedContext
     });
   }
-  // ============================================================================
-  // Cleanup
-  // ============================================================================
   /**
    * Destroy the logger and all its transports.
    * Calls destroy() on all registered transports.
@@ -252,9 +262,6 @@ var Logger = class _Logger {
     await Promise.all(destroyPromises);
     this.transports.length = 0;
   }
-  // ============================================================================
-  // Private Methods
-  // ============================================================================
   /**
    * Core logging method - all public methods delegate here.
    * @param level - The log level
@@ -323,5 +330,9 @@ var Logger = class _Logger {
 export {
   LEVEL_LABELS,
   LOG_LEVEL_PRIORITIES,
-  Logger
+  Logger,
+  buildMessage,
+  formatJson,
+  formatTimestamp,
+  getColoredLabel
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feizk/logger",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "A lightweight, pluggable logger with colored outputs, structured logging, and transport support",
   "main": "dist/index.cjs",
   "module": "dist/index.js",