@rawnodes/logger 2.6.0 → 2.7.0

package/dist/index.d.mts

@@ -336,6 +336,54 @@ interface GracefulShutdownOptions {
  */
 declare function registerShutdown<TContext extends LoggerContext>(logger: Logger<TContext>, options?: GracefulShutdownOptions): () => Promise<void>;
 
+/**
+ * HTTP error data extracted from axios/fetch errors
+ */
+interface HttpErrorData {
+    /** HTTP status code (e.g., 400, 500) */
+    status?: number;
+    /** HTTP status text (e.g., "Bad Request") */
+    statusText?: string;
+    /** Response body data */
+    responseData?: unknown;
+    /** Request URL */
+    url?: string;
+    /** HTTP method (GET, POST, etc.) */
+    method?: string;
+    /** Error code (e.g., ECONNREFUSED, ETIMEDOUT) */
+    code?: string;
+}
+/**
+ * Serialized error data for logging
+ */
+interface SerializedError {
+    /** Error message */
+    errorMessage: string;
+    /** Stack trace */
+    stack?: string;
+    /** HTTP-specific data if present */
+    http?: HttpErrorData;
+    /** Error code for non-HTTP errors */
+    code?: string;
+    /** Error name/type */
+    errorName?: string;
+}
+/**
+ * Serializes an Error object for logging, extracting HTTP-specific data
+ * from axios/fetch errors while preserving standard error properties.
+ *
+ * @example
+ * // Axios error
+ * try {
+ *   await axios.get('/api/data');
+ * } catch (error) {
+ *   const serialized = serializeError(error);
+ *   // serialized.http.status = 400
+ *   // serialized.http.responseData = { error: "invalid input" }
+ * }
+ */
+declare function serializeError(error: unknown): SerializedError;
+
 declare function flattenObject(obj: Record<string, unknown>, prefix?: string, ancestors?: WeakSet<object>, depth?: number): Record<string, unknown>;
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
@@ -381,4 +429,4 @@ declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
     autoShutdown?: boolean | AutoShutdownConfig | undefined;
 }>;
 
-export { type AutoShutdownConfig, AutoShutdownConfigSchema, BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type GracefulShutdownOptions, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, type LogStreamName, LogStreamNameSchema, type LogStreamPattern, type LogStreamPatternConfig, LogStreamPatternConfigSchema, LogStreamPatternSchema, type LogStreamTemplateConfig, LogStreamTemplateConfigSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, registerShutdown, safeValidateConfig, validateConfig };
+export { type AutoShutdownConfig, AutoShutdownConfigSchema, BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type GracefulShutdownOptions, type HttpErrorData, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, type LogStreamName, LogStreamNameSchema, type LogStreamPattern, type LogStreamPatternConfig, LogStreamPatternConfigSchema, LogStreamPatternSchema, type LogStreamTemplateConfig, LogStreamTemplateConfigSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SerializedError, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, registerShutdown, safeValidateConfig, serializeError, validateConfig };

package/dist/index.d.ts

@@ -336,6 +336,54 @@ interface GracefulShutdownOptions {
  */
 declare function registerShutdown<TContext extends LoggerContext>(logger: Logger<TContext>, options?: GracefulShutdownOptions): () => Promise<void>;
 
+/**
+ * HTTP error data extracted from axios/fetch errors
+ */
+interface HttpErrorData {
+    /** HTTP status code (e.g., 400, 500) */
+    status?: number;
+    /** HTTP status text (e.g., "Bad Request") */
+    statusText?: string;
+    /** Response body data */
+    responseData?: unknown;
+    /** Request URL */
+    url?: string;
+    /** HTTP method (GET, POST, etc.) */
+    method?: string;
+    /** Error code (e.g., ECONNREFUSED, ETIMEDOUT) */
+    code?: string;
+}
+/**
+ * Serialized error data for logging
+ */
+interface SerializedError {
+    /** Error message */
+    errorMessage: string;
+    /** Stack trace */
+    stack?: string;
+    /** HTTP-specific data if present */
+    http?: HttpErrorData;
+    /** Error code for non-HTTP errors */
+    code?: string;
+    /** Error name/type */
+    errorName?: string;
+}
+/**
+ * Serializes an Error object for logging, extracting HTTP-specific data
+ * from axios/fetch errors while preserving standard error properties.
+ *
+ * @example
+ * // Axios error
+ * try {
+ *   await axios.get('/api/data');
+ * } catch (error) {
+ *   const serialized = serializeError(error);
+ *   // serialized.http.status = 400
+ *   // serialized.http.responseData = { error: "invalid input" }
+ * }
+ */
+declare function serializeError(error: unknown): SerializedError;
+
 declare function flattenObject(obj: Record<string, unknown>, prefix?: string, ancestors?: WeakSet<object>, depth?: number): Record<string, unknown>;
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
@@ -381,4 +429,4 @@ declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
     autoShutdown?: boolean | AutoShutdownConfig | undefined;
 }>;
 
-export { type AutoShutdownConfig, AutoShutdownConfigSchema, BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type GracefulShutdownOptions, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, type LogStreamName, LogStreamNameSchema, type LogStreamPattern, type LogStreamPatternConfig, LogStreamPatternConfigSchema, LogStreamPatternSchema, type LogStreamTemplateConfig, LogStreamTemplateConfigSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, registerShutdown, safeValidateConfig, validateConfig };
+export { type AutoShutdownConfig, AutoShutdownConfigSchema, BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type GracefulShutdownOptions, type HttpErrorData, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, type LogStreamName, LogStreamNameSchema, type LogStreamPattern, type LogStreamPatternConfig, LogStreamPatternConfigSchema, LogStreamPatternSchema, type LogStreamTemplateConfig, LogStreamTemplateConfigSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SerializedError, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, registerShutdown, safeValidateConfig, serializeError, validateConfig };

package/dist/index.js

@@ -1147,6 +1147,129 @@ function registerShutdown(logger, options = {}) {
   return shutdown;
 }
 
+// src/utils/error.ts
+function isAxiosError(error) {
+  return error !== null && typeof error === "object" && "isAxiosError" in error && error.isAxiosError === true;
+}
+function sanitizeResponseData(data, maxStringLength = 1e4) {
+  if (data === null || data === void 0) {
+    return data;
+  }
+  if (typeof data === "string") {
+    return data.length > maxStringLength ? `${data.slice(0, maxStringLength)}...[truncated]` : data;
+  }
+  if (typeof data === "number" || typeof data === "boolean") {
+    return data;
+  }
+  if (Array.isArray(data)) {
+    return data.slice(0, 100).map((item) => sanitizeResponseData(item, maxStringLength));
+  }
+  if (typeof data === "object") {
+    const result = {};
+    const entries = Object.entries(data);
+    for (const [key, value] of entries.slice(0, 50)) {
+      result[key] = sanitizeResponseData(value, maxStringLength);
+    }
+    return result;
+  }
+  return String(data);
+}
+function extractAxiosHttpData(error) {
+  const httpData = {};
+  if (error.code) {
+    httpData.code = error.code;
+  }
+  if (error.response) {
+    httpData.status = error.response.status;
+    httpData.statusText = error.response.statusText;
+    if (error.response.data !== void 0) {
+      httpData.responseData = sanitizeResponseData(error.response.data);
+    }
+  }
+  if (error.config) {
+    const { url, baseURL, method } = error.config;
+    if (url) {
+      httpData.url = baseURL && !url.startsWith("http") ? `${baseURL}${url}` : url;
+    }
+    if (method) {
+      httpData.method = method.toUpperCase();
+    }
+  }
+  return httpData;
+}
+function extractGenericHttpData(error) {
+  const httpData = {};
+  let hasData = false;
+  if (typeof error.code === "string") {
+    httpData.code = error.code;
+    hasData = true;
+  }
+  const response = error.response;
+  if (response && typeof response === "object") {
+    if (typeof response.status === "number") {
+      httpData.status = response.status;
+      hasData = true;
+    }
+    if (typeof response.statusText === "string") {
+      httpData.statusText = response.statusText;
+      hasData = true;
+    }
+    if (response.data !== void 0) {
+      httpData.responseData = sanitizeResponseData(response.data);
+      hasData = true;
+    }
+  }
+  const config = error.config;
+  if (config && typeof config === "object") {
+    const url = config.url;
+    const baseURL = config.baseURL;
+    if (typeof url === "string") {
+      httpData.url = baseURL && !url.startsWith("http") ? `${baseURL}${url}` : url;
+      hasData = true;
+    }
+    if (typeof config.method === "string") {
+      httpData.method = config.method.toUpperCase();
+      hasData = true;
+    }
+  }
+  return hasData ? httpData : void 0;
+}
+function serializeError(error) {
+  if (!(error instanceof Error)) {
+    if (error === null || error === void 0) {
+      return { errorMessage: "Unknown error" };
+    }
+    if (typeof error === "string") {
+      return { errorMessage: error };
+    }
+    const httpData2 = typeof error === "object" ? extractGenericHttpData(error) : void 0;
+    return {
+      errorMessage: String(error),
+      http: httpData2
+    };
+  }
+  const serialized = {
+    errorMessage: error.message,
+    stack: error.stack
+  };
+  if (error.name && error.name !== "Error") {
+    serialized.errorName = error.name;
+  }
+  if (isAxiosError(error)) {
+    serialized.http = extractAxiosHttpData(error);
+    return serialized;
+  }
+  const errWithCode = error;
+  if (typeof errWithCode.code === "string") {
+    serialized.code = errWithCode.code;
+  }
+  const httpData = extractGenericHttpData(error);
+  if (httpData) {
+    serialized.http = httpData;
+  }
+  return serialized;
+}
+
 // src/logger.ts
 var Logger = class _Logger {
   constructor(state, context) {
@@ -1275,11 +1398,19 @@ var Logger = class _Logger {
         logMeta.caller = formatCallerInfo(callerInfo);
       }
     }
-    if (error instanceof Error) {
-      logMeta.errorMessage = error.message;
-      logMeta.stack = error.stack;
-    } else if (error !== void 0) {
-      logMeta.error = error;
+    if (error !== void 0) {
+      const serialized = serializeError(error);
+      logMeta.errorMessage = serialized.errorMessage;
+      logMeta.stack = serialized.stack;
+      if (serialized.errorName) {
+        logMeta.errorName = serialized.errorName;
+      }
+      if (serialized.code) {
+        logMeta.errorCode = serialized.code;
+      }
+      if (serialized.http) {
+        logMeta.http = serialized.http;
+      }
     }
     const pinoMethod = this.getPinoMethod(level);
     pinoMethod.call(this.state.pino, logMeta, message);
@@ -1573,6 +1704,7 @@ exports.measureAsync = measureAsync;
 exports.measureSync = measureSync;
 exports.registerShutdown = registerShutdown;
 exports.safeValidateConfig = safeValidateConfig;
+exports.serializeError = serializeError;
 exports.validateConfig = validateConfig;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map