@lssm/lib.logger 0.0.0-canary-20251120170226

package/dist/logger.js

@@ -0,0 +1,2 @@
+import{LogContext as e}from"./context.js";import{LogLevel as t}from"./types.js";import{TimerManager as n}from"./timer.js";import{Tracer as r}from"./tracer.js";import{DevFormatter as i,ProductionFormatter as a}from"./formatters.js";var o=class o{config;formatter;context;tracer;timerManager;constructor(o){this.config={level:t.INFO,environment:process.env.NODE_ENV||`development`,enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!0,maxContextDepth:10,timestampFormat:`iso`,...o},this.context=e.getInstance(),this.tracer=new r,this.timerManager=new n,this.formatter=this.config.environment===`production`?new a:new i(this.config.enableColors)}traceLog(e,n){this.log(t.TRACE,e,n)}debug(e,n){this.log(t.DEBUG,e,n)}info(e,n){this.log(t.INFO,e,n)}warn(e,n){this.log(t.WARN,e,n)}error(e,n,r){this.log(t.ERROR,e,n,r)}fatal(e,n,r){this.log(t.FATAL,e,n,r)}withContext(e,t){return this.context.run(e,t)}extendContext(e,t){return this.context.extend(e,t)}setContext(e,t){this.context.set(e,t)}getContext(){return this.context.getContext()}trace=async(e,t)=>this.config.enableTracing?this.tracer.trace(e,t):await t();getTraceId(){return this.tracer.getCurrentTrace()?.traceId}startSpan(e){return this.config.enableTracing?this.tracer.startSpan(e):null}finishSpan(e){if(this.config.enableTracing)return this.tracer.finishSpan(e)}addTraceMetadata(e,t){this.config.enableTracing&&this.tracer.addMetadata(e,t)}addTraceTags(...e){this.config.enableTracing&&this.tracer.addTags(...e)}startTimer(e){return this.config.enableTiming?this.timerManager.start(e):null}stopTimer(e){if(this.config.enableTiming)return this.timerManager.stop(e)}getTimer(e){return this.timerManager.get(e)}child(e){let t=new o(this.config);return Object.entries(e).forEach(([e,n])=>{t.setContext(e,n)}),t}setLevel(e){this.config.level=e}setFormatter(e){this.formatter=e}async profile(e,n,r){let i=this.startTimer(`profile-${e}`),a=performance.now();try{let o=await this.tracer.trace({operationType:`custom`,operationName:`profile:${e}`,autoTiming:!0},n),s=performance.now()-a;i?.stop();let c=r?.logLevel||t.DEBUG;return this.log(c,`Profile: ${e} completed`,{operation:e,duration:`${s.toFixed(2)}ms`,result:r?.logResult?o:`[result hidden]`}),o}catch(t){let n=performance.now()-a;throw i?.stop(),this.error(`Profile: ${e} failed`,{operation:e,duration:`${n.toFixed(2)}ms`,error:t.message},t),t}}logRequest(e,t,n,r){let i=this.getHttpLogLevel(n),a=`${e.toUpperCase()} ${t}${n?` ${n}`:``}`;this.log(i,a,{method:e,url:t,statusCode:n,duration:r?`${r.toFixed(2)}ms`:void 0,type:`http_request`})}async flush(){this.timerManager.clear()}getStats(){return{activeTimers:this.timerManager.getActive().length,activeSpans:this.tracer.getActiveSpans().length,config:{...this.config}}}output(e,n){n>=t.ERROR?console.error(e):console.log(e)}log(e,t,n,r){if(e<this.config.level)return;let i=this.config.enableTracing?this.tracer.getCurrentTrace():void 0,a=this.config.enableContext?this.context.getContext():void 0,o={level:e,message:t,timestamp:new Date,traceId:i?.traceId,parentId:i?.parentId,spanId:i?.spanId,context:a,metadata:n,error:r,tags:i?.tags};i?.metadata?.duration&&(o.duration=i.metadata.duration);let s=this.formatter.format(o);this.output(s,e)}getHttpLogLevel(e){return e?e>=500?t.ERROR:e>=400?t.WARN:t.INFO:t.INFO}};export{o as Logger};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":["entry: LogEntry"],"sources":["../src/logger.ts"],"sourcesContent":["import type {\n  ContextData,\n  Formatter,\n  LogEntry,\n  LoggerConfig,\n  TraceMethod,\n  TracingOptions,\n} from './types';\nimport { LogLevel } from './types';\nimport { LogContext } from './context';\nimport { Tracer } from './tracer';\nimport { Timer, TimerManager } from './timer';\nimport { DevFormatter, ProductionFormatter } from './formatters';\n\nexport class Logger {\n  private config: LoggerConfig;\n  private formatter: Formatter;\n  private context: LogContext;\n  private tracer: Tracer;\n  private timerManager: TimerManager;\n\n  constructor(config?: Partial<LoggerConfig>) {\n    this.config = {\n      level: LogLevel.INFO,\n      environment:\n        (process.env.NODE_ENV as LoggerConfig['environment']) || 'development',\n      enableTracing: true,\n      enableTiming: true,\n      enableContext: true,\n      enableColors: true,\n      maxContextDepth: 10,\n      timestampFormat: 'iso',\n      ...config,\n    };\n\n    this.context = LogContext.getInstance();\n    this.tracer = new Tracer();\n    this.timerManager = new TimerManager();\n\n    // Set up formatter based on environment\n    this.formatter =\n      this.config.environment === 'production'\n        ? new ProductionFormatter()\n        : new DevFormatter(this.config.enableColors);\n  }\n\n  // Core logging methods\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  traceLog(message: string, metadata?: Record<string, any>): void {\n    this.log(LogLevel.TRACE, message, metadata);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  debug(message: string, metadata?: Record<string, any>): void {\n    this.log(LogLevel.DEBUG, message, metadata);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  info(message: string, metadata?: Record<string, any>): void {\n    this.log(LogLevel.INFO, message, metadata);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  warn(message: string, metadata?: Record<string, any>): void {\n    this.log(LogLevel.WARN, message, metadata);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  error(message: string, metadata?: Record<string, any>, error?: Error): void {\n    this.log(LogLevel.ERROR, message, metadata, error);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  fatal(message: string, metadata?: Record<string, any>, error?: Error): void {\n    this.log(LogLevel.FATAL, message, metadata, error);\n  }\n\n  // Context management\n  withContext<T>(context: ContextData, fn: () => T): T {\n    return this.context.run(context, fn);\n  }\n\n  extendContext<T>(additionalContext: Partial<ContextData>, fn: () => T): T {\n    return this.context.extend(additionalContext, fn) as T;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  setContext(key: string, value: any): void {\n    this.context.set(key, value);\n  }\n\n  getContext(): ContextData {\n    return this.context.getContext();\n  }\n\n  // Tracing functionality\n  trace: TraceMethod = async <T>(\n    options: TracingOptions,\n    fn: () => T | Promise<T>\n  ): Promise<T> => {\n    if (!this.config.enableTracing) {\n      return await fn();\n    }\n\n    return this.tracer.trace(options, fn);\n  };\n\n  getTraceId(): string | undefined {\n    return this.tracer.getCurrentTrace()?.traceId;\n  }\n\n  startSpan(options: TracingOptions) {\n    if (!this.config.enableTracing) {\n      return null;\n    }\n    return this.tracer.startSpan(options);\n  }\n\n  finishSpan(spanId: string): number | undefined {\n    if (!this.config.enableTracing) {\n      return undefined;\n    }\n    return this.tracer.finishSpan(spanId);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  addTraceMetadata(key: string, value: any): void {\n    if (this.config.enableTracing) {\n      this.tracer.addMetadata(key, value);\n    }\n  }\n\n  addTraceTags(...tags: string[]): void {\n    if (this.config.enableTracing) {\n      this.tracer.addTags(...tags);\n    }\n  }\n\n  // Timer functionality\n  startTimer(id?: string): Timer | null {\n    if (!this.config.enableTiming) {\n      return null;\n    }\n    return this.timerManager.start(id);\n  }\n\n  stopTimer(id: string): number | undefined {\n    if (!this.config.enableTiming) {\n      return undefined;\n    }\n    return this.timerManager.stop(id);\n  }\n\n  getTimer(id: string): Timer | undefined {\n    return this.timerManager.get(id);\n  }\n\n  // Utility methods\n  child(context: Partial<ContextData>): Logger {\n    const childLogger = new Logger(this.config);\n    Object.entries(context).forEach(([key, value]) => {\n      childLogger.setContext(key, value);\n    });\n    return childLogger;\n  }\n\n  setLevel(level: LogLevel): void {\n    this.config.level = level;\n  }\n\n  setFormatter(formatter: Formatter): void {\n    this.formatter = formatter;\n  }\n\n  // Performance profiling\n  async profile<T>(\n    operationName: string,\n    fn: () => T | Promise<T>,\n    options?: { logResult?: boolean; logLevel?: LogLevel }\n  ): Promise<T> {\n    const timer = this.startTimer(`profile-${operationName}`);\n    const startTime = performance.now();\n\n    try {\n      const result = await this.tracer.trace(\n        {\n          operationType: 'custom',\n          operationName: `profile:${operationName}`,\n          autoTiming: true,\n        },\n        fn\n      );\n\n      const duration = performance.now() - startTime;\n      timer?.stop();\n\n      const logLevel = options?.logLevel || LogLevel.DEBUG;\n      this.log(logLevel, `Profile: ${operationName} completed`, {\n        operation: operationName,\n        duration: `${duration.toFixed(2)}ms`,\n        result: options?.logResult ? result : '[result hidden]',\n      });\n\n      return result;\n    } catch (error) {\n      const duration = performance.now() - startTime;\n      timer?.stop();\n\n      this.error(\n        `Profile: ${operationName} failed`,\n        {\n          operation: operationName,\n          duration: `${duration.toFixed(2)}ms`,\n          error: (error as Error).message,\n        },\n        error as Error\n      );\n\n      throw error;\n    }\n  }\n\n  // HTTP request logging helper\n  logRequest(\n    method: string,\n    url: string,\n    statusCode?: number,\n    duration?: number\n  ): void {\n    const level = this.getHttpLogLevel(statusCode);\n    const message = `${method.toUpperCase()} ${url}${statusCode ? ` ${statusCode}` : ''}`;\n\n    this.log(level, message, {\n      method,\n      url,\n      statusCode,\n      duration: duration ? `${duration.toFixed(2)}ms` : undefined,\n      type: 'http_request',\n    });\n  }\n\n  // Flush any pending logs (useful for graceful shutdown)\n  async flush(): Promise<void> {\n    // In a more advanced implementation, this might flush to external systems\n    // For now, it just clears internal state\n    this.timerManager.clear();\n    // this.tracer.clear();\n  }\n\n  // Get logger statistics\n  getStats(): {\n    activeTimers: number;\n    activeSpans: number;\n    config: LoggerConfig;\n  } {\n    return {\n      activeTimers: this.timerManager.getActive().length,\n      activeSpans: this.tracer.getActiveSpans().length,\n      config: { ...this.config },\n    };\n  }\n\n  // Output method (can be overridden for custom outputs)\n  protected output(message: string, level: LogLevel): void {\n    if (level >= LogLevel.ERROR) {\n      console.error(message);\n    } else {\n      console.log(message);\n    }\n  }\n\n  // Core log method\n  private log(\n    level: LogLevel,\n    message: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    metadata?: Record<string, any>,\n    error?: Error\n  ): void {\n    if (level < this.config.level) {\n      return; // Skip logs below configured level\n    }\n\n    const currentTrace = this.config.enableTracing\n      ? this.tracer.getCurrentTrace()\n      : undefined;\n    const contextData = this.config.enableContext\n      ? this.context.getContext()\n      : undefined;\n\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: new Date(),\n      traceId: currentTrace?.traceId,\n      parentId: currentTrace?.parentId,\n      spanId: currentTrace?.spanId,\n      context: contextData,\n      metadata,\n      error,\n      tags: currentTrace?.tags,\n    };\n\n    // Add duration if we're in a traced operation\n    if (currentTrace?.metadata?.duration) {\n      entry.duration = currentTrace.metadata.duration as number;\n    }\n\n    const formatted = this.formatter.format(entry);\n    this.output(formatted, level);\n  }\n\n  private getHttpLogLevel(statusCode?: number): LogLevel {\n    if (!statusCode) return LogLevel.INFO;\n    if (statusCode >= 500) return LogLevel.ERROR;\n    if (statusCode >= 400) return LogLevel.WARN;\n    return LogLevel.INFO;\n  }\n}\n"],"mappings":"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"}

package/dist/timer.cjs

@@ -0,0 +1 @@
+var e=class{id;startTime;laps=[];stopped=!1;stopTime;constructor(e){this.id=e||crypto.randomUUID(),this.startTime=performance.now()}stop(){if(this.stopped)return this.getElapsed();this.stopTime=performance.now(),this.stopped=!0;let e=this.stopTime-this.startTime;return this.laps.push({label:`stop`,time:this.stopTime,elapsed:e}),e}lap(e){if(this.stopped)return this.getElapsed();let t=performance.now(),n=t-this.startTime;return this.laps.push({label:e||`lap-${this.laps.length+1}`,time:t,elapsed:n}),n}getElapsed(){return this.stopped&&this.stopTime?this.stopTime-this.startTime:performance.now()-this.startTime}getLaps(){return[...this.laps]}getSummary(){return{id:this.id,totalTime:this.getElapsed(),isRunning:!this.stopped,laps:this.getLaps()}}reset(){this.startTime=performance.now(),this.laps=[],this.stopped=!1,this.stopTime=void 0}},t=class{timers=new Map;start(t){let n=new e(t);return this.timers.set(n.id,n),n}get(e){return this.timers.get(e)}stop(e){let t=this.timers.get(e);if(t){let n=t.stop();return this.timers.delete(e),n}}getActive(){return Array.from(this.timers.values()).filter(e=>!!e.getSummary().isRunning)}clear(){this.timers.clear()}getSummary(){return Array.from(this.timers.values()).map(e=>e.getSummary())}};async function n(t,n){let r=new e(n?.id);try{let e=await t(),i=r.stop();return n?.onComplete?.(i),{result:e,elapsed:i,timer:r}}catch(e){throw r.stop(),e}}function r(t,n){let r=new e(n?.id);try{let e=t(),i=r.stop();return n?.onComplete?.(i),{result:e,elapsed:i,timer:r}}catch(e){throw r.stop(),e}}exports.Timer=e,exports.TimerManager=t,exports.timed=n,exports.timedSync=r;

package/dist/timer.d.cts

@@ -0,0 +1,103 @@
+import { Timer as Timer$1 } from "./types.cjs";
+
+//#region src/timer.d.ts
+declare class Timer implements Timer$1 {
+  readonly id: string;
+  private startTime;
+  private laps;
+  private stopped;
+  private stopTime?;
+  constructor(id?: string);
+  /**
+   * Stop the timer and return elapsed time in milliseconds
+   */
+  stop(): number;
+  /**
+   * Record a lap time and return elapsed time since start
+   */
+  lap(label?: string): number;
+  /**
+   * Get elapsed time without stopping the timer
+   */
+  getElapsed(): number;
+  /**
+   * Get all recorded laps
+   */
+  getLaps(): {
+    label?: string;
+    time: number;
+    elapsed: number;
+  }[];
+  /**
+   * Get timer summary with total time and laps
+   */
+  getSummary(): {
+    id: string;
+    totalTime: number;
+    isRunning: boolean;
+    laps: {
+      label?: string;
+      time: number;
+      elapsed: number;
+    }[];
+  };
+  /**
+   * Reset the timer (starts a new timing session)
+   */
+  reset(): void;
+}
+/**
+ * Utility class for managing multiple timers
+ */
+declare class TimerManager {
+  private timers;
+  /**
+   * Start a new timer
+   */
+  start(id?: string): Timer;
+  /**
+   * Get an existing timer
+   */
+  get(id: string): Timer | undefined;
+  /**
+   * Stop and remove a timer
+   */
+  stop(id: string): number | undefined;
+  /**
+   * Get all active timers
+   */
+  getActive(): Timer[];
+  /**
+   * Clear all timers
+   */
+  clear(): void;
+  /**
+   * Get summary of all timers
+   */
+  getSummary(): ReturnType<Timer['getSummary']>[];
+}
+/**
+ * Decorator/wrapper function to time async operations
+ */
+declare function timed<T>(operation: () => Promise<T>, options?: {
+  id?: string;
+  onComplete?: (elapsed: number) => void;
+}): Promise<{
+  result: T;
+  elapsed: number;
+  timer: Timer;
+}>;
+/**
+ * Decorator/wrapper function to time synchronous operations
+ */
+declare function timedSync<T>(operation: () => T, options?: {
+  id?: string;
+  onComplete?: (elapsed: number) => void;
+}): {
+  result: T;
+  elapsed: number;
+  timer: Timer;
+};
+//#endregion
+export { Timer, TimerManager, timed, timedSync };
+//# sourceMappingURL=timer.d.cts.map

package/dist/timer.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.cts","names":[],"sources":["../src/timer.ts"],"sourcesContent":[],"mappings":";;;cAEa,KAAA,YAAiB;;EAAjB,QAAM,SAAA;EAqGN,QAAA,IAAA;EAMS,QAAA,OAAA;EASH,QAAA,QAAA;EAoBJ,WAAA,CAAA,EAAA,CAAA,EAAA,MAAA;EAgBY;;;EAQL,IAAA,CAAA,CAAA,EAAK,MAAA;EACA;;;EAEqB,GAAA,CAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAA7C;;AAmBH;EACmB,UAAA,CAAA,CAAA,EAAA,MAAA;EAEN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cApFA,YAAA;;;;;sBAMS;;;;mBASH;;;;;;;;eAoBJ;;;;;;;;gBAgBC,WAAW;;;;;iBAQL,0BACH,QAAQ;;;IAExB;UAAkB;;SAA2B;;;;;iBAmBhC,8BACG;;;;UAEN;;SAA2B"}

package/dist/timer.d.ts

@@ -0,0 +1,103 @@
+import { Timer as Timer$1 } from "./types.js";
+
+//#region src/timer.d.ts
+declare class Timer implements Timer$1 {
+  readonly id: string;
+  private startTime;
+  private laps;
+  private stopped;
+  private stopTime?;
+  constructor(id?: string);
+  /**
+   * Stop the timer and return elapsed time in milliseconds
+   */
+  stop(): number;
+  /**
+   * Record a lap time and return elapsed time since start
+   */
+  lap(label?: string): number;
+  /**
+   * Get elapsed time without stopping the timer
+   */
+  getElapsed(): number;
+  /**
+   * Get all recorded laps
+   */
+  getLaps(): {
+    label?: string;
+    time: number;
+    elapsed: number;
+  }[];
+  /**
+   * Get timer summary with total time and laps
+   */
+  getSummary(): {
+    id: string;
+    totalTime: number;
+    isRunning: boolean;
+    laps: {
+      label?: string;
+      time: number;
+      elapsed: number;
+    }[];
+  };
+  /**
+   * Reset the timer (starts a new timing session)
+   */
+  reset(): void;
+}
+/**
+ * Utility class for managing multiple timers
+ */
+declare class TimerManager {
+  private timers;
+  /**
+   * Start a new timer
+   */
+  start(id?: string): Timer;
+  /**
+   * Get an existing timer
+   */
+  get(id: string): Timer | undefined;
+  /**
+   * Stop and remove a timer
+   */
+  stop(id: string): number | undefined;
+  /**
+   * Get all active timers
+   */
+  getActive(): Timer[];
+  /**
+   * Clear all timers
+   */
+  clear(): void;
+  /**
+   * Get summary of all timers
+   */
+  getSummary(): ReturnType<Timer['getSummary']>[];
+}
+/**
+ * Decorator/wrapper function to time async operations
+ */
+declare function timed<T>(operation: () => Promise<T>, options?: {
+  id?: string;
+  onComplete?: (elapsed: number) => void;
+}): Promise<{
+  result: T;
+  elapsed: number;
+  timer: Timer;
+}>;
+/**
+ * Decorator/wrapper function to time synchronous operations
+ */
+declare function timedSync<T>(operation: () => T, options?: {
+  id?: string;
+  onComplete?: (elapsed: number) => void;
+}): {
+  result: T;
+  elapsed: number;
+  timer: Timer;
+};
+//#endregion
+export { Timer, TimerManager, timed, timedSync };
+//# sourceMappingURL=timer.d.ts.map

package/dist/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","names":[],"sources":["../src/timer.ts"],"sourcesContent":[],"mappings":";;;cAEa,KAAA,YAAiB;;EAAjB,QAAM,SAAA;EAqGN,QAAA,IAAA;EAMS,QAAA,OAAA;EASH,QAAA,QAAA;EAoBJ,WAAA,CAAA,EAAA,CAAA,EAAA,MAAA;EAgBY;;;EAQL,IAAA,CAAA,CAAA,EAAK,MAAA;EACA;;;EAEqB,GAAA,CAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAA7C;;AAmBH;EACmB,UAAA,CAAA,CAAA,EAAA,MAAA;EAEN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cApFA,YAAA;;;;;sBAMS;;;;mBASH;;;;;;;;eAoBJ;;;;;;;;gBAgBC,WAAW;;;;;iBAQL,0BACH,QAAQ;;;IAExB;UAAkB;;SAA2B;;;;;iBAmBhC,8BACG;;;;UAEN;;SAA2B"}

package/dist/timer.js

@@ -0,0 +1,2 @@
+var e=class{id;startTime;laps=[];stopped=!1;stopTime;constructor(e){this.id=e||crypto.randomUUID(),this.startTime=performance.now()}stop(){if(this.stopped)return this.getElapsed();this.stopTime=performance.now(),this.stopped=!0;let e=this.stopTime-this.startTime;return this.laps.push({label:`stop`,time:this.stopTime,elapsed:e}),e}lap(e){if(this.stopped)return this.getElapsed();let t=performance.now(),n=t-this.startTime;return this.laps.push({label:e||`lap-${this.laps.length+1}`,time:t,elapsed:n}),n}getElapsed(){return this.stopped&&this.stopTime?this.stopTime-this.startTime:performance.now()-this.startTime}getLaps(){return[...this.laps]}getSummary(){return{id:this.id,totalTime:this.getElapsed(),isRunning:!this.stopped,laps:this.getLaps()}}reset(){this.startTime=performance.now(),this.laps=[],this.stopped=!1,this.stopTime=void 0}},t=class{timers=new Map;start(t){let n=new e(t);return this.timers.set(n.id,n),n}get(e){return this.timers.get(e)}stop(e){let t=this.timers.get(e);if(t){let n=t.stop();return this.timers.delete(e),n}}getActive(){return Array.from(this.timers.values()).filter(e=>!!e.getSummary().isRunning)}clear(){this.timers.clear()}getSummary(){return Array.from(this.timers.values()).map(e=>e.getSummary())}};async function n(t,n){let r=new e(n?.id);try{let e=await t(),i=r.stop();return n?.onComplete?.(i),{result:e,elapsed:i,timer:r}}catch(e){throw r.stop(),e}}function r(t,n){let r=new e(n?.id);try{let e=t(),i=r.stop();return n?.onComplete?.(i),{result:e,elapsed:i,timer:r}}catch(e){throw r.stop(),e}}export{e as Timer,t as TimerManager,n as timed,r as timedSync};
+//# sourceMappingURL=timer.js.map

package/dist/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","names":[],"sources":["../src/timer.ts"],"sourcesContent":["import type { Timer as ITimer } from './types';\n\nexport class Timer implements ITimer {\n  readonly id: string;\n  private startTime: number;\n  private laps: { label?: string; time: number; elapsed: number }[] = [];\n  private stopped = false;\n  private stopTime?: number;\n\n  constructor(id?: string) {\n    this.id = id || crypto.randomUUID();\n    this.startTime = performance.now();\n  }\n\n  /**\n   * Stop the timer and return elapsed time in milliseconds\n   */\n  stop(): number {\n    if (this.stopped) {\n      return this.getElapsed();\n    }\n\n    this.stopTime = performance.now();\n    this.stopped = true;\n    const elapsed = this.stopTime - this.startTime;\n\n    this.laps.push({\n      label: 'stop',\n      time: this.stopTime,\n      elapsed,\n    });\n\n    return elapsed;\n  }\n\n  /**\n   * Record a lap time and return elapsed time since start\n   */\n  lap(label?: string): number {\n    if (this.stopped) {\n      return this.getElapsed();\n    }\n\n    const now = performance.now();\n    const elapsed = now - this.startTime;\n\n    this.laps.push({\n      label: label || `lap-${this.laps.length + 1}`,\n      time: now,\n      elapsed,\n    });\n\n    return elapsed;\n  }\n\n  /**\n   * Get elapsed time without stopping the timer\n   */\n  getElapsed(): number {\n    if (this.stopped && this.stopTime) {\n      return this.stopTime - this.startTime;\n    }\n    return performance.now() - this.startTime;\n  }\n\n  /**\n   * Get all recorded laps\n   */\n  getLaps(): { label?: string; time: number; elapsed: number }[] {\n    return [...this.laps];\n  }\n\n  /**\n   * Get timer summary with total time and laps\n   */\n  getSummary(): {\n    id: string;\n    totalTime: number;\n    isRunning: boolean;\n    laps: { label?: string; time: number; elapsed: number }[];\n  } {\n    return {\n      id: this.id,\n      totalTime: this.getElapsed(),\n      isRunning: !this.stopped,\n      laps: this.getLaps(),\n    };\n  }\n\n  /**\n   * Reset the timer (starts a new timing session)\n   */\n  reset(): void {\n    this.startTime = performance.now();\n    this.laps = [];\n    this.stopped = false;\n    this.stopTime = undefined;\n  }\n}\n\n/**\n * Utility class for managing multiple timers\n */\nexport class TimerManager {\n  private timers = new Map<string, Timer>();\n\n  /**\n   * Start a new timer\n   */\n  start(id?: string): Timer {\n    const timer = new Timer(id);\n    this.timers.set(timer.id, timer);\n    return timer;\n  }\n\n  /**\n   * Get an existing timer\n   */\n  get(id: string): Timer | undefined {\n    return this.timers.get(id);\n  }\n\n  /**\n   * Stop and remove a timer\n   */\n  stop(id: string): number | undefined {\n    const timer = this.timers.get(id);\n    if (timer) {\n      const elapsed = timer.stop();\n      this.timers.delete(id);\n      return elapsed;\n    }\n    return undefined;\n  }\n\n  /**\n   * Get all active timers\n   */\n  getActive(): Timer[] {\n    return Array.from(this.timers.values()).filter(\n      (timer) => !timer.getSummary().isRunning === false\n    );\n  }\n\n  /**\n   * Clear all timers\n   */\n  clear(): void {\n    this.timers.clear();\n  }\n\n  /**\n   * Get summary of all timers\n   */\n  getSummary(): ReturnType<Timer['getSummary']>[] {\n    return Array.from(this.timers.values()).map((timer) => timer.getSummary());\n  }\n}\n\n/**\n * Decorator/wrapper function to time async operations\n */\nexport async function timed<T>(\n  operation: () => Promise<T>,\n  options?: { id?: string; onComplete?: (elapsed: number) => void }\n): Promise<{ result: T; elapsed: number; timer: Timer }> {\n  const timer = new Timer(options?.id);\n\n  try {\n    const result = await operation();\n    const elapsed = timer.stop();\n\n    options?.onComplete?.(elapsed);\n\n    return { result, elapsed, timer };\n  } catch (error) {\n    timer.stop();\n    throw error;\n  }\n}\n\n/**\n * Decorator/wrapper function to time synchronous operations\n */\nexport function timedSync<T>(\n  operation: () => T,\n  options?: { id?: string; onComplete?: (elapsed: number) => void }\n): { result: T; elapsed: number; timer: Timer } {\n  const timer = new Timer(options?.id);\n\n  try {\n    const result = operation();\n    const elapsed = timer.stop();\n\n    options?.onComplete?.(elapsed);\n\n    return { result, elapsed, timer };\n  } catch (error) {\n    timer.stop();\n    throw error;\n  }\n}\n"],"mappings":"AAEA,IAAa,EAAb,KAAqC,CACnC,GACA,UACA,KAAoE,EAAE,CACtE,QAAkB,GAClB,SAEA,YAAY,EAAa,CACvB,KAAK,GAAK,GAAM,OAAO,YAAY,CACnC,KAAK,UAAY,YAAY,KAAK,CAMpC,MAAe,CACb,GAAI,KAAK,QACP,OAAO,KAAK,YAAY,CAG1B,KAAK,SAAW,YAAY,KAAK,CACjC,KAAK,QAAU,GACf,IAAM,EAAU,KAAK,SAAW,KAAK,UAQrC,OANA,KAAK,KAAK,KAAK,CACb,MAAO,OACP,KAAM,KAAK,SACX,UACD,CAAC,CAEK,EAMT,IAAI,EAAwB,CAC1B,GAAI,KAAK,QACP,OAAO,KAAK,YAAY,CAG1B,IAAM,EAAM,YAAY,KAAK,CACvB,EAAU,EAAM,KAAK,UAQ3B,OANA,KAAK,KAAK,KAAK,CACb,MAAO,GAAS,OAAO,KAAK,KAAK,OAAS,IAC1C,KAAM,EACN,UACD,CAAC,CAEK,EAMT,YAAqB,CAInB,OAHI,KAAK,SAAW,KAAK,SAChB,KAAK,SAAW,KAAK,UAEvB,YAAY,KAAK,CAAG,KAAK,UAMlC,SAA+D,CAC7D,MAAO,CAAC,GAAG,KAAK,KAAK,CAMvB,YAKE,CACA,MAAO,CACL,GAAI,KAAK,GACT,UAAW,KAAK,YAAY,CAC5B,UAAW,CAAC,KAAK,QACjB,KAAM,KAAK,SAAS,CACrB,CAMH,OAAc,CACZ,KAAK,UAAY,YAAY,KAAK,CAClC,KAAK,KAAO,EAAE,CACd,KAAK,QAAU,GACf,KAAK,SAAW,IAAA,KAOP,EAAb,KAA0B,CACxB,OAAiB,IAAI,IAKrB,MAAM,EAAoB,CACxB,IAAM,EAAQ,IAAI,EAAM,EAAG,CAE3B,OADA,KAAK,OAAO,IAAI,EAAM,GAAI,EAAM,CACzB,EAMT,IAAI,EAA+B,CACjC,OAAO,KAAK,OAAO,IAAI,EAAG,CAM5B,KAAK,EAAgC,CACnC,IAAM,EAAQ,KAAK,OAAO,IAAI,EAAG,CACjC,GAAI,EAAO,CACT,IAAM,EAAU,EAAM,MAAM,CAE5B,OADA,KAAK,OAAO,OAAO,EAAG,CACf,GAQX,WAAqB,CACnB,OAAO,MAAM,KAAK,KAAK,OAAO,QAAQ,CAAC,CAAC,OACrC,GAAU,EAAC,EAAM,YAAY,CAAC,UAChC,CAMH,OAAc,CACZ,KAAK,OAAO,OAAO,CAMrB,YAAgD,CAC9C,OAAO,MAAM,KAAK,KAAK,OAAO,QAAQ,CAAC,CAAC,IAAK,GAAU,EAAM,YAAY,CAAC,GAO9E,eAAsB,EACpB,EACA,EACuD,CACvD,IAAM,EAAQ,IAAI,EAAM,GAAS,GAAG,CAEpC,GAAI,CACF,IAAM,EAAS,MAAM,GAAW,CAC1B,EAAU,EAAM,MAAM,CAI5B,OAFA,GAAS,aAAa,EAAQ,CAEvB,CAAE,SAAQ,UAAS,QAAO,OAC1B,EAAO,CAEd,MADA,EAAM,MAAM,CACN,GAOV,SAAgB,EACd,EACA,EAC8C,CAC9C,IAAM,EAAQ,IAAI,EAAM,GAAS,GAAG,CAEpC,GAAI,CACF,IAAM,EAAS,GAAW,CACpB,EAAU,EAAM,MAAM,CAI5B,OAFA,GAAS,aAAa,EAAQ,CAEvB,CAAE,SAAQ,UAAS,QAAO,OAC1B,EAAO,CAEd,MADA,EAAM,MAAM,CACN"}

package/dist/tracer.cjs

@@ -0,0 +1 @@
+const e=require(`./context.cjs`),t=require(`./timer.cjs`);var n=class{context;activeSpans=new Map;constructor(){this.context=e.LogContext.getInstance()}startSpan(e){let t=this.context.getCurrentTrace(),n={traceId:t?.traceId||this.generateTraceId(),parentId:t?.spanId,spanId:this.generateSpanId(),operationType:e.operationType,operationName:e.operationName,startTime:performance.now(),metadata:{...e.metadata},tags:[...e.tags||[]]};return this.activeSpans.set(n.spanId,n),this.context.setTrace(n),n}finishSpan(e){let t=this.activeSpans.get(e);if(!t)return;let n=performance.now()-t.startTime;if(this.activeSpans.delete(e),this.context.getCurrentTrace()?.spanId===e&&t.parentId){let e=this.findSpanById(t.parentId);e&&this.context.setTrace(e)}return n}async trace(e,n){let r=this.startSpan(e),i=e.autoTiming===!1?void 0:new t.Timer(`trace-${r.spanId}`);try{let e=await n(),t=this.finishSpan(r.spanId);return i&&i.stop(),t!==void 0&&(r.metadata.duration=t),e}catch(e){r.metadata.error={name:e.name||`Unknown`,message:e.message||`Unknown error`,stack:e.stack};let t=this.finishSpan(r.spanId);throw r.metadata.duration=t,i&&i.stop(),e}}addMetadata(e,t){let n=this.context.getCurrentTrace();n&&(n.metadata[e]=t)}addTags(...e){let t=this.context.getCurrentTrace();t&&t.tags.push(...e)}getCurrentTrace(){return this.context.getCurrentTrace()}getActiveSpans(){return Array.from(this.activeSpans.values())}findSpanById(e){return this.activeSpans.get(e)}generateTraceId(){return crypto.randomUUID().replace(/-/g,``)}generateSpanId(){return crypto.randomUUID().replace(/-/g,``).substring(0,16)}};exports.Tracer=n;

package/dist/tracer.d.cts

@@ -0,0 +1,51 @@
+import { TraceContext, TracingOptions } from "./types.cjs";
+
+//#region src/tracer.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: any): 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.d.cts.map

package/dist/tracer.d.cts.map

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

package/dist/tracer.d.ts

@@ -0,0 +1,51 @@
+import { TraceContext, TracingOptions } from "./types.js";
+
+//#region src/tracer.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: any): 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.d.ts.map

package/dist/tracer.d.ts.map

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

package/dist/tracer.js

@@ -0,0 +1,2 @@
+import{LogContext as e}from"./context.js";import{Timer as t}from"./timer.js";var n=class{context;activeSpans=new Map;constructor(){this.context=e.getInstance()}startSpan(e){let t=this.context.getCurrentTrace(),n={traceId:t?.traceId||this.generateTraceId(),parentId:t?.spanId,spanId:this.generateSpanId(),operationType:e.operationType,operationName:e.operationName,startTime:performance.now(),metadata:{...e.metadata},tags:[...e.tags||[]]};return this.activeSpans.set(n.spanId,n),this.context.setTrace(n),n}finishSpan(e){let t=this.activeSpans.get(e);if(!t)return;let n=performance.now()-t.startTime;if(this.activeSpans.delete(e),this.context.getCurrentTrace()?.spanId===e&&t.parentId){let e=this.findSpanById(t.parentId);e&&this.context.setTrace(e)}return n}async trace(e,n){let r=this.startSpan(e),i=e.autoTiming===!1?void 0:new t(`trace-${r.spanId}`);try{let e=await n(),t=this.finishSpan(r.spanId);return i&&i.stop(),t!==void 0&&(r.metadata.duration=t),e}catch(e){r.metadata.error={name:e.name||`Unknown`,message:e.message||`Unknown error`,stack:e.stack};let t=this.finishSpan(r.spanId);throw r.metadata.duration=t,i&&i.stop(),e}}addMetadata(e,t){let n=this.context.getCurrentTrace();n&&(n.metadata[e]=t)}addTags(...e){let t=this.context.getCurrentTrace();t&&t.tags.push(...e)}getCurrentTrace(){return this.context.getCurrentTrace()}getActiveSpans(){return Array.from(this.activeSpans.values())}findSpanById(e){return this.activeSpans.get(e)}generateTraceId(){return crypto.randomUUID().replace(/-/g,``)}generateSpanId(){return crypto.randomUUID().replace(/-/g,``).substring(0,16)}};export{n as Tracer};
+//# sourceMappingURL=tracer.js.map

package/dist/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","names":["span: TraceContext"],"sources":["../src/tracer.ts"],"sourcesContent":["import type { TraceContext, TracingOptions } from './types';\nimport { LogContext } from './context';\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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  addMetadata(key: string, value: any): 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":"6EAIA,IAAa,EAAb,KAAoB,CAClB,QACA,YAAsB,IAAI,IAE1B,aAAc,CACZ,KAAK,QAAU,EAAW,aAAa,CAMzC,UAAU,EAAuC,CAC/C,IAAM,EAAc,KAAK,QAAQ,iBAAiB,CAG5CA,EAAqB,CACzB,QAHc,GAAa,SAAW,KAAK,iBAAiB,CAI5D,SAAU,GAAa,OACvB,OAAQ,KAAK,gBAAgB,CAC7B,cAAe,EAAQ,cACvB,cAAe,EAAQ,cACvB,UAAW,YAAY,KAAK,CAC5B,SAAU,CAAE,GAAG,EAAQ,SAAU,CACjC,KAAM,CAAC,GAAI,EAAQ,MAAQ,EAAE,CAAE,CAChC,CAKD,OAHA,KAAK,YAAY,IAAI,EAAK,OAAQ,EAAK,CACvC,KAAK,QAAQ,SAAS,EAAK,CAEpB,EAMT,WAAW,EAAoC,CAC7C,IAAM,EAAO,KAAK,YAAY,IAAI,EAAO,CACzC,GAAI,CAAC,EACH,OAGF,IAAM,EAAW,YAAY,KAAK,CAAG,EAAK,UAK1C,GAJA,KAAK,YAAY,OAAO,EAAO,CAGV,KAAK,QAAQ,iBAAiB,EACjC,SAAW,GAAU,EAAK,SAAU,CACpD,IAAM,EAAa,KAAK,aAAa,EAAK,SAAS,CAC/C,GACF,KAAK,QAAQ,SAAS,EAAW,CAIrC,OAAO,EAMT,MAAM,MACJ,EACA,EACY,CACZ,IAAM,EAAO,KAAK,UAAU,EAAQ,CAC9B,EACJ,EAAQ,aAAe,GAEnB,IAAA,GADA,IAAI,EAAM,SAAS,EAAK,SAAS,CAGvC,GAAI,CACF,IAAM,EAAS,MAAM,GAAI,CAEnB,EAAW,KAAK,WAAW,EAAK,OAAO,CAU7C,OATI,GACF,EAAM,MAAM,CAIV,IAAa,IAAA,KACf,EAAK,SAAS,SAAW,GAGpB,QACA,EAAO,CAEd,EAAK,SAAS,MAAQ,CACpB,KAAO,EAAgB,MAAQ,UAC/B,QAAU,EAAgB,SAAW,gBACrC,MAAQ,EAAgB,MACzB,CAED,IAAM,EAAW,KAAK,WAAW,EAAK,OAAO,CAM7C,KALA,GAAK,SAAS,SAAW,EACrB,GACF,EAAM,MAAM,CAGR,GAQV,YAAY,EAAa,EAAkB,CACzC,IAAM,EAAe,KAAK,QAAQ,iBAAiB,CAC/C,IACF,EAAa,SAAS,GAAO,GAOjC,QAAQ,GAAG,EAAsB,CAC/B,IAAM,EAAe,KAAK,QAAQ,iBAAiB,CAC/C,GACF,EAAa,KAAK,KAAK,GAAG,EAAK,CAOnC,iBAA4C,CAC1C,OAAO,KAAK,QAAQ,iBAAiB,CAMvC,gBAAiC,CAC/B,OAAO,MAAM,KAAK,KAAK,YAAY,QAAQ,CAAC,CAM9C,aAAa,EAA0C,CACrD,OAAO,KAAK,YAAY,IAAI,EAAO,CAMrC,iBAAkC,CAChC,OAAO,OAAO,YAAY,CAAC,QAAQ,KAAM,GAAG,CAM9C,gBAAiC,CAC/B,OAAO,OAAO,YAAY,CAAC,QAAQ,KAAM,GAAG,CAAC,UAAU,EAAG,GAAG"}

package/dist/types.cjs

@@ -0,0 +1 @@
+let e=function(e){return e[e.TRACE=0]=`TRACE`,e[e.DEBUG=1]=`DEBUG`,e[e.INFO=2]=`INFO`,e[e.WARN=3]=`WARN`,e[e.ERROR=4]=`ERROR`,e[e.FATAL=5]=`FATAL`,e}({});exports.LogLevel=e;

package/dist/types.d.cts

@@ -0,0 +1,71 @@
+//#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.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","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.d.ts

@@ -0,0 +1,71 @@
+//#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.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","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.js

@@ -0,0 +1,2 @@
+let e=function(e){return e[e.TRACE=0]=`TRACE`,e[e.DEBUG=1]=`DEBUG`,e[e.INFO=2]=`INFO`,e[e.WARN=3]=`WARN`,e[e.ERROR=4]=`ERROR`,e[e.FATAL=5]=`FATAL`,e}({});export{e as LogLevel};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","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,EAAA,SAAA,EAAL,OACL,GAAA,EAAA,MAAA,GAAA,QACA,EAAA,EAAA,MAAA,GAAA,QACA,EAAA,EAAA,KAAA,GAAA,OACA,EAAA,EAAA,KAAA,GAAA,OACA,EAAA,EAAA,MAAA,GAAA,QACA,EAAA,EAAA,MAAA,GAAA"}