@contractspec/lib.logger 1.56.1 → 1.58.0

package/dist/tracer.mjs

@@ -1,3 +0,0 @@
-import { Tracer } from "./tracer.node.mjs";
-
-export { Tracer };

package/dist/tracer.node.d.mts

@@ -1,51 +0,0 @@
-import { TraceContext, TracingOptions } from "./types.mjs";
-
-//#region src/tracer.node.d.ts
-declare class Tracer {
-  private context;
-  private activeSpans;
-  constructor();
-  /**
-   * Start a new trace span
-   */
-  startSpan(options: TracingOptions): TraceContext;
-  /**
-   * Finish a trace span
-   */
-  finishSpan(spanId: string): number | undefined;
-  /**
-   * Execute a function within a trace span
-   */
-  trace<T>(options: TracingOptions, fn: () => T | Promise<T>): Promise<T>;
-  /**
-   * Add metadata to current span
-   */
-  addMetadata(key: string, value: unknown): void;
-  /**
-   * Add tags to current span
-   */
-  addTags(...tags: string[]): void;
-  /**
-   * Get current trace context
-   */
-  getCurrentTrace(): TraceContext | undefined;
-  /**
-   * Get all active spans
-   */
-  getActiveSpans(): TraceContext[];
-  /**
-   * Find a span by ID
-   */
-  findSpanById(spanId: string): TraceContext | undefined;
-  /**
-   * Generate a unique trace ID
-   */
-  private generateTraceId;
-  /**
-   * Generate a unique span ID
-   */
-  private generateSpanId;
-}
-//#endregion
-export { Tracer };
-//# sourceMappingURL=tracer.node.d.mts.map

package/dist/tracer.node.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracer.node.d.mts","names":[],"sources":["../src/tracer.node.ts"],"sourcesContent":[],"mappings":";;;cAIa,MAAA;;EAAA,QAAA,WAAM;EAWE,WAAA,CAAA;EAAiB;;;EAkDZ,SAAA,CAAA,OAAA,EAlDL,cAkDK,CAAA,EAlDY,YAkDZ;EAAR;;;EA+DG,UAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAOD;;;oBAvEP,0BACC,IAAI,QAAQ,KACrB,QAAQ;;;;;;;;;;;;qBA8DQ;;;;oBAOD;;;;gCAOY"}

package/dist/tracer.node.mjs

@@ -1,116 +0,0 @@
-import { LogContext } from "./context.node.mjs";
-import { Timer } from "./timer.mjs";
-
-//#region src/tracer.node.ts
-var Tracer = class {
-	context;
-	activeSpans = /* @__PURE__ */ new Map();
-	constructor() {
-		this.context = LogContext.getInstance();
-	}
-	/**
-	* Start a new trace span
-	*/
-	startSpan(options) {
-		const parentTrace = this.context.getCurrentTrace();
-		const span = {
-			traceId: parentTrace?.traceId || this.generateTraceId(),
-			parentId: parentTrace?.spanId,
-			spanId: this.generateSpanId(),
-			operationType: options.operationType,
-			operationName: options.operationName,
-			startTime: performance.now(),
-			metadata: { ...options.metadata },
-			tags: [...options.tags || []]
-		};
-		this.activeSpans.set(span.spanId, span);
-		this.context.setTrace(span);
-		return span;
-	}
-	/**
-	* Finish a trace span
-	*/
-	finishSpan(spanId) {
-		const span = this.activeSpans.get(spanId);
-		if (!span) return;
-		const duration = performance.now() - span.startTime;
-		this.activeSpans.delete(spanId);
-		if (this.context.getCurrentTrace()?.spanId === spanId && span.parentId) {
-			const parentSpan = this.findSpanById(span.parentId);
-			if (parentSpan) this.context.setTrace(parentSpan);
-		}
-		return duration;
-	}
-	/**
-	* Execute a function within a trace span
-	*/
-	async trace(options, fn) {
-		const span = this.startSpan(options);
-		const timer = options.autoTiming !== false ? new Timer(`trace-${span.spanId}`) : void 0;
-		try {
-			const result = await fn();
-			const duration = this.finishSpan(span.spanId);
-			if (timer) timer.stop();
-			if (duration !== void 0) span.metadata.duration = duration;
-			return result;
-		} catch (error) {
-			span.metadata.error = {
-				name: error.name || "Unknown",
-				message: error.message || "Unknown error",
-				stack: error.stack
-			};
-			const duration = this.finishSpan(span.spanId);
-			span.metadata.duration = duration;
-			if (timer) timer.stop();
-			throw error;
-		}
-	}
-	/**
-	* Add metadata to current span
-	*/
-	addMetadata(key, value) {
-		const currentTrace = this.context.getCurrentTrace();
-		if (currentTrace) currentTrace.metadata[key] = value;
-	}
-	/**
-	* Add tags to current span
-	*/
-	addTags(...tags) {
-		const currentTrace = this.context.getCurrentTrace();
-		if (currentTrace) currentTrace.tags.push(...tags);
-	}
-	/**
-	* Get current trace context
-	*/
-	getCurrentTrace() {
-		return this.context.getCurrentTrace();
-	}
-	/**
-	* Get all active spans
-	*/
-	getActiveSpans() {
-		return Array.from(this.activeSpans.values());
-	}
-	/**
-	* Find a span by ID
-	*/
-	findSpanById(spanId) {
-		return this.activeSpans.get(spanId);
-	}
-	/**
-	* Generate a unique trace ID
-	*/
-	generateTraceId() {
-		return crypto.randomUUID().replace(/-/g, "");
-	}
-	/**
-	* Generate a unique span ID
-	*/
-	generateSpanId() {
-		return crypto.randomUUID().replace(/-/g, "").substring(0, 16);
-	}
-};
-
-//#endregion
-export { Tracer };
-//# sourceMappingURL=tracer.node.mjs.map

package/dist/tracer.node.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracer.node.mjs","names":[],"sources":["../src/tracer.node.ts"],"sourcesContent":["import type { TraceContext, TracingOptions } from './types';\nimport { LogContext } from './context.node';\nimport { Timer } from './timer';\n\nexport class Tracer {\n  private context: LogContext;\n  private activeSpans = new Map<string, TraceContext>();\n\n  constructor() {\n    this.context = LogContext.getInstance();\n  }\n\n  /**\n   * Start a new trace span\n   */\n  startSpan(options: TracingOptions): TraceContext {\n    const parentTrace = this.context.getCurrentTrace();\n    const traceId = parentTrace?.traceId || this.generateTraceId();\n\n    const span: TraceContext = {\n      traceId,\n      parentId: parentTrace?.spanId,\n      spanId: this.generateSpanId(),\n      operationType: options.operationType,\n      operationName: options.operationName,\n      startTime: performance.now(),\n      metadata: { ...options.metadata },\n      tags: [...(options.tags || [])],\n    };\n\n    this.activeSpans.set(span.spanId, span);\n    this.context.setTrace(span);\n\n    return span;\n  }\n\n  /**\n   * Finish a trace span\n   */\n  finishSpan(spanId: string): number | undefined {\n    const span = this.activeSpans.get(spanId);\n    if (!span) {\n      return undefined;\n    }\n\n    const duration = performance.now() - span.startTime;\n    this.activeSpans.delete(spanId);\n\n    // If this was the current span, restore parent\n    const currentTrace = this.context.getCurrentTrace();\n    if (currentTrace?.spanId === spanId && span.parentId) {\n      const parentSpan = this.findSpanById(span.parentId);\n      if (parentSpan) {\n        this.context.setTrace(parentSpan);\n      }\n    }\n\n    return duration;\n  }\n\n  /**\n   * Execute a function within a trace span\n   */\n  async trace<T>(\n    options: TracingOptions,\n    fn: () => T | Promise<T>\n  ): Promise<T> {\n    const span = this.startSpan(options);\n    const timer =\n      options.autoTiming !== false\n        ? new Timer(`trace-${span.spanId}`)\n        : undefined;\n\n    try {\n      const result = await fn();\n\n      const duration = this.finishSpan(span.spanId);\n      if (timer) {\n        timer.stop();\n      }\n\n      // Add timing metadata\n      if (duration !== undefined) {\n        span.metadata.duration = duration;\n      }\n\n      return result;\n    } catch (error) {\n      // Add error metadata\n      span.metadata.error = {\n        name: (error as Error).name || 'Unknown',\n        message: (error as Error).message || 'Unknown error',\n        stack: (error as Error).stack,\n      };\n\n      const duration = this.finishSpan(span.spanId);\n      span.metadata.duration = duration;\n      if (timer) {\n        timer.stop();\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Add metadata to current span\n   */\n  addMetadata(key: string, value: unknown): void {\n    const currentTrace = this.context.getCurrentTrace();\n    if (currentTrace) {\n      currentTrace.metadata[key] = value;\n    }\n  }\n\n  /**\n   * Add tags to current span\n   */\n  addTags(...tags: string[]): void {\n    const currentTrace = this.context.getCurrentTrace();\n    if (currentTrace) {\n      currentTrace.tags.push(...tags);\n    }\n  }\n\n  /**\n   * Get current trace context\n   */\n  getCurrentTrace(): TraceContext | undefined {\n    return this.context.getCurrentTrace();\n  }\n\n  /**\n   * Get all active spans\n   */\n  getActiveSpans(): TraceContext[] {\n    return Array.from(this.activeSpans.values());\n  }\n\n  /**\n   * Find a span by ID\n   */\n  findSpanById(spanId: string): TraceContext | undefined {\n    return this.activeSpans.get(spanId);\n  }\n\n  /**\n   * Generate a unique trace ID\n   */\n  private generateTraceId(): string {\n    return crypto.randomUUID().replace(/-/g, '');\n  }\n\n  /**\n   * Generate a unique span ID\n   */\n  private generateSpanId(): string {\n    return crypto.randomUUID().replace(/-/g, '').substring(0, 16);\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,SAAb,MAAoB;CAClB,AAAQ;CACR,AAAQ,8BAAc,IAAI,KAA2B;CAErD,cAAc;AACZ,OAAK,UAAU,WAAW,aAAa;;;;;CAMzC,UAAU,SAAuC;EAC/C,MAAM,cAAc,KAAK,QAAQ,iBAAiB;EAGlD,MAAM,OAAqB;GACzB,SAHc,aAAa,WAAW,KAAK,iBAAiB;GAI5D,UAAU,aAAa;GACvB,QAAQ,KAAK,gBAAgB;GAC7B,eAAe,QAAQ;GACvB,eAAe,QAAQ;GACvB,WAAW,YAAY,KAAK;GAC5B,UAAU,EAAE,GAAG,QAAQ,UAAU;GACjC,MAAM,CAAC,GAAI,QAAQ,QAAQ,EAAE,CAAE;GAChC;AAED,OAAK,YAAY,IAAI,KAAK,QAAQ,KAAK;AACvC,OAAK,QAAQ,SAAS,KAAK;AAE3B,SAAO;;;;;CAMT,WAAW,QAAoC;EAC7C,MAAM,OAAO,KAAK,YAAY,IAAI,OAAO;AACzC,MAAI,CAAC,KACH;EAGF,MAAM,WAAW,YAAY,KAAK,GAAG,KAAK;AAC1C,OAAK,YAAY,OAAO,OAAO;AAI/B,MADqB,KAAK,QAAQ,iBAAiB,EACjC,WAAW,UAAU,KAAK,UAAU;GACpD,MAAM,aAAa,KAAK,aAAa,KAAK,SAAS;AACnD,OAAI,WACF,MAAK,QAAQ,SAAS,WAAW;;AAIrC,SAAO;;;;;CAMT,MAAM,MACJ,SACA,IACY;EACZ,MAAM,OAAO,KAAK,UAAU,QAAQ;EACpC,MAAM,QACJ,QAAQ,eAAe,QACnB,IAAI,MAAM,SAAS,KAAK,SAAS,GACjC;AAEN,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;GAEzB,MAAM,WAAW,KAAK,WAAW,KAAK,OAAO;AAC7C,OAAI,MACF,OAAM,MAAM;AAId,OAAI,aAAa,OACf,MAAK,SAAS,WAAW;AAG3B,UAAO;WACA,OAAO;AAEd,QAAK,SAAS,QAAQ;IACpB,MAAO,MAAgB,QAAQ;IAC/B,SAAU,MAAgB,WAAW;IACrC,OAAQ,MAAgB;IACzB;GAED,MAAM,WAAW,KAAK,WAAW,KAAK,OAAO;AAC7C,QAAK,SAAS,WAAW;AACzB,OAAI,MACF,OAAM,MAAM;AAGd,SAAM;;;;;;CAOV,YAAY,KAAa,OAAsB;EAC7C,MAAM,eAAe,KAAK,QAAQ,iBAAiB;AACnD,MAAI,aACF,cAAa,SAAS,OAAO;;;;;CAOjC,QAAQ,GAAG,MAAsB;EAC/B,MAAM,eAAe,KAAK,QAAQ,iBAAiB;AACnD,MAAI,aACF,cAAa,KAAK,KAAK,GAAG,KAAK;;;;;CAOnC,kBAA4C;AAC1C,SAAO,KAAK,QAAQ,iBAAiB;;;;;CAMvC,iBAAiC;AAC/B,SAAO,MAAM,KAAK,KAAK,YAAY,QAAQ,CAAC;;;;;CAM9C,aAAa,QAA0C;AACrD,SAAO,KAAK,YAAY,IAAI,OAAO;;;;;CAMrC,AAAQ,kBAA0B;AAChC,SAAO,OAAO,YAAY,CAAC,QAAQ,MAAM,GAAG;;;;;CAM9C,AAAQ,iBAAyB;AAC/B,SAAO,OAAO,YAAY,CAAC,QAAQ,MAAM,GAAG,CAAC,UAAU,GAAG,GAAG"}

package/dist/types.d.mts

@@ -1,71 +0,0 @@
-//#region src/types.d.ts
-declare enum LogLevel {
-  TRACE = 0,
-  DEBUG = 1,
-  INFO = 2,
-  WARN = 3,
-  ERROR = 4,
-  FATAL = 5,
-}
-interface LogEntry {
-  level: LogLevel;
-  message: string;
-  timestamp: Date;
-  traceId?: string;
-  parentId?: string;
-  spanId?: string;
-  context?: Record<string, any>;
-  metadata?: Record<string, any>;
-  duration?: number;
-  error?: Error;
-  tags?: string[];
-}
-interface TraceContext {
-  traceId: string;
-  parentId?: string;
-  spanId: string;
-  operationType: string;
-  operationName: string;
-  startTime: number;
-  metadata: Record<string, any>;
-  tags: string[];
-}
-interface TracingOptions {
-  operationType: 'http' | 'websocket' | 'cron' | 'queue' | 'database' | 'custom';
-  operationName: string;
-  metadata?: Record<string, any>;
-  tags?: string[];
-  autoTiming?: boolean;
-}
-interface LoggerConfig {
-  level: LogLevel;
-  environment: 'development' | 'production' | 'test';
-  enableTracing: boolean;
-  enableTiming: boolean;
-  enableContext: boolean;
-  enableColors: boolean;
-  maxContextDepth: number;
-  timestampFormat: 'iso' | 'epoch' | 'relative';
-}
-interface Formatter {
-  format(entry: LogEntry): string;
-}
-interface Timer {
-  readonly id: string;
-  stop(): number;
-  lap(label?: string): number;
-  getElapsed(): number;
-}
-interface ContextData {
-  [key: string]: any;
-  userId?: string;
-  requestId?: string;
-  sessionId?: string;
-  ip?: string;
-  userAgent?: string;
-}
-type LogMethod = (message: string, metadata?: Record<string, any>) => void;
-type TraceMethod = <T>(options: TracingOptions, fn: () => T | Promise<T>) => Promise<T>;
-//#endregion
-export { ContextData, Formatter, LogEntry, LogLevel, LogMethod, LoggerConfig, Timer, TraceContext, TraceMethod, TracingOptions };
-//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";aAAY,QAAA;EAAA,KAAA,GAAA,CAAA;EASK,KAAA,GAAA,CAAA;EACR,IAAA,GAAA,CAAA;EAEI,IAAA,GAAA,CAAA;EAKD,KAAA,GAAA,CAAA;EAEC,KAAA,GAAA,CAAA;;AAEE,UAZE,QAAA,CAYF;EAIE,KAAA,EAfR,QAeoB;EAYZ,OAAA,EAAA,MAAA;EAeA,SAAA,EAxCJ,IAwCgB;EAWZ,OAAA,CAAA,EAAA,MAAS;EAIT,QAAK,CAAA,EAAA,MAAA;EAQL,MAAA,CAAA,EAAA,MAAW;EAUhB,OAAA,CAAA,EApEA,MAoES,CAAA,MAAA,EAGR,GAAA,CAAA;EAED,QAAA,CAAA,EAvEC,MAuEU,CAAA,MAAA,EAAA,GAAA,CAAA;EACZ,QAAA,CAAA,EAAA,MAAA;EACC,KAAA,CAAA,EAvEF,KAuEE;EAAY,IAAA,CAAA,EAAA,MAAA,EAAA;;AACX,UApEI,YAAA,CAoEJ;EAAR,OAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EAAA,MAAA;;;;;YA5DA;;;UAIK,cAAA;;;aAUJ;;;;UAKI,YAAA;SACR;;;;;;;;;UAUQ,SAAA;gBACD;;UAGC,KAAA;;;;;;UAQA,WAAA;;;;;;;;KAUL,SAAA,gCAGC;KAED,WAAA,gBACD,0BACC,IAAI,QAAQ,OACnB,QAAQ"}

package/dist/types.mjs

@@ -1,14 +0,0 @@
-//#region src/types.ts
-let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
-	LogLevel$1[LogLevel$1["TRACE"] = 0] = "TRACE";
-	LogLevel$1[LogLevel$1["DEBUG"] = 1] = "DEBUG";
-	LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
-	LogLevel$1[LogLevel$1["WARN"] = 3] = "WARN";
-	LogLevel$1[LogLevel$1["ERROR"] = 4] = "ERROR";
-	LogLevel$1[LogLevel$1["FATAL"] = 5] = "FATAL";
-	return LogLevel$1;
-}({});
-
-//#endregion
-export { LogLevel };
-//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["export enum LogLevel {\n  TRACE = 0,\n  DEBUG = 1,\n  INFO = 2,\n  WARN = 3,\n  ERROR = 4,\n  FATAL = 5,\n}\n\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: Date;\n  traceId?: string;\n  parentId?: string;\n  spanId?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  context?: Record<string, any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  metadata?: Record<string, any>;\n  duration?: number;\n  error?: Error;\n  tags?: string[];\n}\n\nexport interface TraceContext {\n  traceId: string;\n  parentId?: string;\n  spanId: string;\n  operationType: string;\n  operationName: string;\n  startTime: number;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  metadata: Record<string, any>;\n  tags: string[];\n}\n\nexport interface TracingOptions {\n  operationType:\n    | 'http'\n    | 'websocket'\n    | 'cron'\n    | 'queue'\n    | 'database'\n    | 'custom';\n  operationName: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  metadata?: Record<string, any>;\n  tags?: string[];\n  autoTiming?: boolean;\n}\n\nexport interface LoggerConfig {\n  level: LogLevel;\n  environment: 'development' | 'production' | 'test';\n  enableTracing: boolean;\n  enableTiming: boolean;\n  enableContext: boolean;\n  enableColors: boolean;\n  maxContextDepth: number;\n  timestampFormat: 'iso' | 'epoch' | 'relative';\n}\n\nexport interface Formatter {\n  format(entry: LogEntry): string;\n}\n\nexport interface Timer {\n  readonly id: string;\n  // private startTime: number;\n  stop(): number;\n  lap(label?: string): number;\n  getElapsed(): number;\n}\n\nexport interface ContextData {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  [key: string]: any;\n  userId?: string;\n  requestId?: string;\n  sessionId?: string;\n  ip?: string;\n  userAgent?: string;\n}\n\nexport type LogMethod = (\n  message: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  metadata?: Record<string, any>\n) => void;\nexport type TraceMethod = <T>(\n  options: TracingOptions,\n  fn: () => T | Promise<T>\n) => Promise<T>;\n"],"mappings":";AAAA,IAAY,gDAAL;AACL;AACA;AACA;AACA;AACA;AACA"}