logixia 1.1.4 → 1.2.0

package/dist/index-BDRSTjUt.d.ts

@@ -0,0 +1,247 @@
+//#region src/types/http.types.d.ts
+/**
+ * HTTP-related type definitions for Logitron
+ */
+interface HttpRequest {
+  method: string;
+  url: string;
+  headers: Record<string, string | string[]>;
+  query?: Record<string, unknown>;
+  params?: Record<string, unknown>;
+  body?: unknown;
+  ip?: string;
+  userAgent?: string;
+  timestamp: number;
+}
+interface HttpResponse {
+  statusCode: number;
+  headers: Record<string, string | string[]>;
+  body?: unknown;
+  timestamp: number;
+  contentLength?: number;
+}
+interface HttpError extends Error {
+  statusCode?: number;
+  code?: string;
+  details?: Record<string, unknown>;
+}
+interface RequestTiming {
+  start: number;
+  end?: number;
+  duration?: number;
+  phases?: {
+    dns?: number;
+    tcp?: number;
+    tls?: number;
+    request?: number;
+    response?: number;
+  };
+}
+interface RequestMetrics {
+  requestId: string;
+  method: string;
+  url: string;
+  statusCode?: number;
+  duration?: number;
+  contentLength?: number;
+  userAgent?: string;
+  ip?: string;
+  timestamp: number;
+}
+//#endregion
+//#region src/types/index.d.ts
+declare const LogLevel: {
+  readonly ERROR: "error";
+  readonly WARN: "warn";
+  readonly INFO: "info";
+  readonly DEBUG: "debug";
+  readonly TRACE: "trace";
+  readonly VERBOSE: "verbose";
+};
+type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+type LogLevelString = LogLevel | (string & {});
+type LogColor = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'gray' | 'grey' | 'brightRed' | 'brightGreen' | 'brightYellow' | 'brightBlue' | 'brightMagenta' | 'brightCyan' | 'brightWhite';
+type LogFieldKey = 'timestamp' | 'level' | 'appName' | 'service' | 'traceId' | 'message' | 'payload' | 'timeTaken' | 'context' | 'requestId' | 'userId' | 'sessionId' | 'environment';
+type Environment = 'development' | 'production';
+interface TraceIdExtractorConfig {
+  header?: string | string[];
+  query?: string | string[];
+  body?: string | string[];
+  params?: string | string[];
+}
+interface TraceIdConfig {
+  enabled: boolean;
+  generator?: () => string;
+  contextKey?: string;
+  extractor?: TraceIdExtractorConfig;
+}
+interface RedactConfig {
+  /**
+   * Dot-notation field paths to redact. Supports `*` (one segment) and `**` (any depth).
+   * @example `['req.headers.authorization', '*.password', 'user.creditCard']`
+   */
+  paths?: string[];
+  /**
+   * Regex patterns applied to string values — replaces matches with the censor string.
+   * @example `[/Bearer\s+\S+/gi, /sk-[a-z0-9]{32,}/gi]`
+   */
+  patterns?: RegExp[];
+  /** Replacement value for redacted content. Default: `"[REDACTED]"` */
+  censor?: string;
+}
+/**
+ * Per-namespace log level overrides.
+ * Keys are namespace patterns (dot-separated, `*` wildcard); values are log levels.
+ *
+ * @example
+ * ```ts
+ * namespaceLevels: {
+ *   'db.*':    'debug',   // all db.* namespaces → DEBUG
+ *   'http.*':  'warn',    // all http.* → WARN only
+ *   'payment': 'trace',   // payment namespace → TRACE
+ * }
+ * ```
+ * ENV overrides: `LOGIXIA_LEVEL_DB=debug` maps to namespace `db`.
+ */
+type NamespaceLevels = Record<string, LogLevelString>;
+interface GracefulShutdownConfig {
+  /** Auto-register SIGTERM/SIGINT handlers to flush this logger on exit. Default: false */
+  enabled: boolean;
+  /** Max ms to wait for transports to flush. Default: 5000 */
+  timeout?: number;
+  /** Signals to listen on. Default: ['SIGTERM', 'SIGINT'] */
+  signals?: NodeJS.Signals[];
+}
+interface LoggerConfig<TLevels extends Record<string, number> = Record<string, number>> {
+  appName?: string;
+  environment?: Environment;
+  traceId?: boolean | TraceIdConfig;
+  format?: {
+    timestamp?: boolean;
+    colorize?: boolean;
+    json?: boolean;
+  };
+  silent?: boolean;
+  levelOptions?: {
+    level?: keyof TLevels | LogLevelString;
+    levels?: TLevels;
+    colors?: Record<string, LogColor>;
+  } | undefined;
+  fields?: Partial<Record<LogFieldKey, string | boolean>>;
+  /**
+   * Built-in log redaction — masks sensitive fields before they reach any transport.
+   * @see RedactConfig
+   */
+  redact?: RedactConfig;
+  /**
+   * Per-namespace log level overrides.
+   * A child logger's context is used as its namespace for matching.
+   * ENV vars `LOGIXIA_LEVEL_<NS>=<level>` also apply.
+   */
+  namespaceLevels?: NamespaceLevels;
+  /**
+   * Automatically register SIGTERM/SIGINT handlers that flush all transports
+   * before the process exits — prevents losing the last N seconds of logs on
+   * deployments / restarts.
+   */
+  gracefulShutdown?: boolean | GracefulShutdownConfig;
+  [key: string]: unknown;
+}
+interface IBaseLogger {
+  error(message: string, data?: Record<string, unknown>): Promise<void>;
+  error(error: Error, data?: Record<string, unknown>): Promise<void>;
+  warn(message: string, data?: Record<string, unknown>): Promise<void>;
+  info(message: string, data?: Record<string, unknown>): Promise<void>;
+  debug(message: string, data?: Record<string, unknown>): Promise<void>;
+  trace(message: string, data?: Record<string, unknown>): Promise<void>;
+  verbose(message: string, data?: Record<string, unknown>): Promise<void>;
+  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void>;
+  time(label: string): void;
+  timeEnd(label: string): Promise<number | undefined>;
+  timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+  setLevel(level: LogLevel | string): void;
+  getLevel(): string;
+  setContext(context: string): void;
+  getContext(): string | undefined;
+  enableField(fieldName: string): void;
+  disableField(fieldName: string): void;
+  isFieldEnabled(fieldName: string): boolean;
+  getFieldState(): Record<string, boolean>;
+  resetFieldState(): void;
+  enableTransportLevelPrompting(): void;
+  disableTransportLevelPrompting(): void;
+  setTransportLevels(transportId: string, levels: string[]): void;
+  getTransportLevels(transportId: string): string[] | undefined;
+  clearTransportLevelPreferences(): void;
+  getAvailableTransports(): string[];
+  child(context: string, data?: Record<string, unknown>): ILogger;
+  close(): Promise<void>;
+}
+type CustomLevelMethods<T extends Record<string, number>> = { [K in keyof T]: (message: string, data?: Record<string, unknown>) => Promise<void> };
+type ILogger<TLevels extends Record<string, number> = {}> = IBaseLogger & CustomLevelMethods<TLevels>;
+interface ILoggerDefault extends IBaseLogger {}
+type LoggerWithLevels<T extends LoggerConfig<any>> = T['levelOptions'] extends {
+  levels: infer L;
+} ? L extends Record<string, number> ? ILogger<L> : ILoggerDefault : ILoggerDefault;
+type ExtractLevels<T> = T extends LoggerConfig<infer L> ? L : Record<string, number>;
+interface LogEntry {
+  timestamp: string;
+  level: string;
+  appName: string;
+  environment?: string;
+  traceId?: string;
+  message: string;
+  payload?: Record<string, unknown>;
+  context?: string;
+  error?: Error;
+}
+interface ErrorSerializationOptions {
+  includeStack?: boolean;
+  maxDepth?: number;
+  excludeFields?: string[];
+}
+interface TimingEntry {
+  label: string;
+  startTime: number;
+  endTime?: number;
+  duration?: number;
+}
+interface ContextData {
+  [key: string]: unknown;
+}
+interface ILogFormatter {
+  format(entry: LogEntry): string;
+}
+interface RequestContext {
+  requestId: string;
+  traceId?: string;
+  startTime: number;
+  endTime?: number;
+  duration?: number;
+  request: HttpRequest;
+  response?: HttpResponse;
+  error?: Error;
+  userId?: string;
+  sessionId?: string;
+  userAgent?: string;
+  ip?: string;
+}
+declare const DEFAULT_LOG_LEVELS: {
+  error: number;
+  warn: number;
+  info: number;
+  debug: number;
+  trace: number;
+  verbose: number;
+};
+declare const DEFAULT_LOG_COLORS: {
+  error: string;
+  warn: string;
+  info: string;
+  debug: string;
+  trace: string;
+  verbose: string;
+};
+//#endregion
+export { RequestTiming as A, TimingEntry as C, HttpRequest as D, HttpError as E, HttpResponse as O, RequestContext as S, TraceIdExtractorConfig as T, LogLevelString as _, Environment as a, NamespaceLevels as b, GracefulShutdownConfig as c, ILogger as d, ILoggerDefault as f, LogLevel as g, LogFieldKey as h, DEFAULT_LOG_LEVELS as i, RequestMetrics as k, IBaseLogger as l, LogEntry as m, CustomLevelMethods as n, ErrorSerializationOptions as o, LogColor as p, DEFAULT_LOG_COLORS as r, ExtractLevels as s, ContextData as t, ILogFormatter as u, LoggerConfig as v, TraceIdConfig as w, RedactConfig as x, LoggerWithLevels as y };
+//# sourceMappingURL=index-BDRSTjUt.d.ts.map

package/dist/index-BDRSTjUt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BDRSTjUt.d.ts","names":[],"sources":["../src/types/http.types.ts","../src/types/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index-Drrzn-Yg.d.mts

@@ -0,0 +1,247 @@
+//#region src/types/http.types.d.ts
+/**
+ * HTTP-related type definitions for Logitron
+ */
+interface HttpRequest {
+  method: string;
+  url: string;
+  headers: Record<string, string | string[]>;
+  query?: Record<string, unknown>;
+  params?: Record<string, unknown>;
+  body?: unknown;
+  ip?: string;
+  userAgent?: string;
+  timestamp: number;
+}
+interface HttpResponse {
+  statusCode: number;
+  headers: Record<string, string | string[]>;
+  body?: unknown;
+  timestamp: number;
+  contentLength?: number;
+}
+interface HttpError extends Error {
+  statusCode?: number;
+  code?: string;
+  details?: Record<string, unknown>;
+}
+interface RequestTiming {
+  start: number;
+  end?: number;
+  duration?: number;
+  phases?: {
+    dns?: number;
+    tcp?: number;
+    tls?: number;
+    request?: number;
+    response?: number;
+  };
+}
+interface RequestMetrics {
+  requestId: string;
+  method: string;
+  url: string;
+  statusCode?: number;
+  duration?: number;
+  contentLength?: number;
+  userAgent?: string;
+  ip?: string;
+  timestamp: number;
+}
+//#endregion
+//#region src/types/index.d.ts
+declare const LogLevel: {
+  readonly ERROR: "error";
+  readonly WARN: "warn";
+  readonly INFO: "info";
+  readonly DEBUG: "debug";
+  readonly TRACE: "trace";
+  readonly VERBOSE: "verbose";
+};
+type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+type LogLevelString = LogLevel | (string & {});
+type LogColor = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'gray' | 'grey' | 'brightRed' | 'brightGreen' | 'brightYellow' | 'brightBlue' | 'brightMagenta' | 'brightCyan' | 'brightWhite';
+type LogFieldKey = 'timestamp' | 'level' | 'appName' | 'service' | 'traceId' | 'message' | 'payload' | 'timeTaken' | 'context' | 'requestId' | 'userId' | 'sessionId' | 'environment';
+type Environment = 'development' | 'production';
+interface TraceIdExtractorConfig {
+  header?: string | string[];
+  query?: string | string[];
+  body?: string | string[];
+  params?: string | string[];
+}
+interface TraceIdConfig {
+  enabled: boolean;
+  generator?: () => string;
+  contextKey?: string;
+  extractor?: TraceIdExtractorConfig;
+}
+interface RedactConfig {
+  /**
+   * Dot-notation field paths to redact. Supports `*` (one segment) and `**` (any depth).
+   * @example `['req.headers.authorization', '*.password', 'user.creditCard']`
+   */
+  paths?: string[];
+  /**
+   * Regex patterns applied to string values — replaces matches with the censor string.
+   * @example `[/Bearer\s+\S+/gi, /sk-[a-z0-9]{32,}/gi]`
+   */
+  patterns?: RegExp[];
+  /** Replacement value for redacted content. Default: `"[REDACTED]"` */
+  censor?: string;
+}
+/**
+ * Per-namespace log level overrides.
+ * Keys are namespace patterns (dot-separated, `*` wildcard); values are log levels.
+ *
+ * @example
+ * ```ts
+ * namespaceLevels: {
+ *   'db.*':    'debug',   // all db.* namespaces → DEBUG
+ *   'http.*':  'warn',    // all http.* → WARN only
+ *   'payment': 'trace',   // payment namespace → TRACE
+ * }
+ * ```
+ * ENV overrides: `LOGIXIA_LEVEL_DB=debug` maps to namespace `db`.
+ */
+type NamespaceLevels = Record<string, LogLevelString>;
+interface GracefulShutdownConfig {
+  /** Auto-register SIGTERM/SIGINT handlers to flush this logger on exit. Default: false */
+  enabled: boolean;
+  /** Max ms to wait for transports to flush. Default: 5000 */
+  timeout?: number;
+  /** Signals to listen on. Default: ['SIGTERM', 'SIGINT'] */
+  signals?: NodeJS.Signals[];
+}
+interface LoggerConfig<TLevels extends Record<string, number> = Record<string, number>> {
+  appName?: string;
+  environment?: Environment;
+  traceId?: boolean | TraceIdConfig;
+  format?: {
+    timestamp?: boolean;
+    colorize?: boolean;
+    json?: boolean;
+  };
+  silent?: boolean;
+  levelOptions?: {
+    level?: keyof TLevels | LogLevelString;
+    levels?: TLevels;
+    colors?: Record<string, LogColor>;
+  } | undefined;
+  fields?: Partial<Record<LogFieldKey, string | boolean>>;
+  /**
+   * Built-in log redaction — masks sensitive fields before they reach any transport.
+   * @see RedactConfig
+   */
+  redact?: RedactConfig;
+  /**
+   * Per-namespace log level overrides.
+   * A child logger's context is used as its namespace for matching.
+   * ENV vars `LOGIXIA_LEVEL_<NS>=<level>` also apply.
+   */
+  namespaceLevels?: NamespaceLevels;
+  /**
+   * Automatically register SIGTERM/SIGINT handlers that flush all transports
+   * before the process exits — prevents losing the last N seconds of logs on
+   * deployments / restarts.
+   */
+  gracefulShutdown?: boolean | GracefulShutdownConfig;
+  [key: string]: unknown;
+}
+interface IBaseLogger {
+  error(message: string, data?: Record<string, unknown>): Promise<void>;
+  error(error: Error, data?: Record<string, unknown>): Promise<void>;
+  warn(message: string, data?: Record<string, unknown>): Promise<void>;
+  info(message: string, data?: Record<string, unknown>): Promise<void>;
+  debug(message: string, data?: Record<string, unknown>): Promise<void>;
+  trace(message: string, data?: Record<string, unknown>): Promise<void>;
+  verbose(message: string, data?: Record<string, unknown>): Promise<void>;
+  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void>;
+  time(label: string): void;
+  timeEnd(label: string): Promise<number | undefined>;
+  timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+  setLevel(level: LogLevel | string): void;
+  getLevel(): string;
+  setContext(context: string): void;
+  getContext(): string | undefined;
+  enableField(fieldName: string): void;
+  disableField(fieldName: string): void;
+  isFieldEnabled(fieldName: string): boolean;
+  getFieldState(): Record<string, boolean>;
+  resetFieldState(): void;
+  enableTransportLevelPrompting(): void;
+  disableTransportLevelPrompting(): void;
+  setTransportLevels(transportId: string, levels: string[]): void;
+  getTransportLevels(transportId: string): string[] | undefined;
+  clearTransportLevelPreferences(): void;
+  getAvailableTransports(): string[];
+  child(context: string, data?: Record<string, unknown>): ILogger;
+  close(): Promise<void>;
+}
+type CustomLevelMethods<T extends Record<string, number>> = { [K in keyof T]: (message: string, data?: Record<string, unknown>) => Promise<void> };
+type ILogger<TLevels extends Record<string, number> = {}> = IBaseLogger & CustomLevelMethods<TLevels>;
+interface ILoggerDefault extends IBaseLogger {}
+type LoggerWithLevels<T extends LoggerConfig<any>> = T['levelOptions'] extends {
+  levels: infer L;
+} ? L extends Record<string, number> ? ILogger<L> : ILoggerDefault : ILoggerDefault;
+type ExtractLevels<T> = T extends LoggerConfig<infer L> ? L : Record<string, number>;
+interface LogEntry {
+  timestamp: string;
+  level: string;
+  appName: string;
+  environment?: string;
+  traceId?: string;
+  message: string;
+  payload?: Record<string, unknown>;
+  context?: string;
+  error?: Error;
+}
+interface ErrorSerializationOptions {
+  includeStack?: boolean;
+  maxDepth?: number;
+  excludeFields?: string[];
+}
+interface TimingEntry {
+  label: string;
+  startTime: number;
+  endTime?: number;
+  duration?: number;
+}
+interface ContextData {
+  [key: string]: unknown;
+}
+interface ILogFormatter {
+  format(entry: LogEntry): string;
+}
+interface RequestContext {
+  requestId: string;
+  traceId?: string;
+  startTime: number;
+  endTime?: number;
+  duration?: number;
+  request: HttpRequest;
+  response?: HttpResponse;
+  error?: Error;
+  userId?: string;
+  sessionId?: string;
+  userAgent?: string;
+  ip?: string;
+}
+declare const DEFAULT_LOG_LEVELS: {
+  error: number;
+  warn: number;
+  info: number;
+  debug: number;
+  trace: number;
+  verbose: number;
+};
+declare const DEFAULT_LOG_COLORS: {
+  error: string;
+  warn: string;
+  info: string;
+  debug: string;
+  trace: string;
+  verbose: string;
+};
+//#endregion
+export { RequestTiming as A, TimingEntry as C, HttpRequest as D, HttpError as E, HttpResponse as O, RequestContext as S, TraceIdExtractorConfig as T, LogLevelString as _, Environment as a, NamespaceLevels as b, GracefulShutdownConfig as c, ILogger as d, ILoggerDefault as f, LogLevel as g, LogFieldKey as h, DEFAULT_LOG_LEVELS as i, RequestMetrics as k, IBaseLogger as l, LogEntry as m, CustomLevelMethods as n, ErrorSerializationOptions as o, LogColor as p, DEFAULT_LOG_COLORS as r, ExtractLevels as s, ContextData as t, ILogFormatter as u, LoggerConfig as v, TraceIdConfig as w, RedactConfig as x, LoggerWithLevels as y };
+//# sourceMappingURL=index-Drrzn-Yg.d.mts.map

package/dist/index-Drrzn-Yg.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Drrzn-Yg.d.mts","names":[],"sources":["../src/types/http.types.ts","../src/types/index.ts"],"sourcesContent":[],"mappings":"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"}