@lssm/lib.logger 1.2.0

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"}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@lssm/lib.logger",
+  "version": "1.2.0",
+  "description": "Comprehensive logging library optimized for Bun with ElysiaJS integration",
+  "keywords": [
+    "logging",
+    "bun",
+    "elysia",
+    "tracing",
+    "performance"
+  ],
+  "type": "module",
+  "scripts": {
+    "clean": "rm -rf dist",
+    "lint": "bun run lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch"
+  },
+  "devDependencies": {
+    "@lssm/tool.typescript": "workspace:*",
+    "@lssm/tool.tsdown": "workspace:*",
+    "tsdown": "^0.15.9",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "elysia": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "elysia": {
+      "optional": true
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./context": {
+      "import": "./dist/context.js",
+      "require": "./dist/context.cjs"
+    },
+    "./elysia-plugin": {
+      "import": "./dist/elysia-plugin.js",
+      "require": "./dist/elysia-plugin.cjs"
+    },
+    "./formatters": {
+      "import": "./dist/formatters.js",
+      "require": "./dist/formatters.cjs"
+    },
+    "./logger": {
+      "import": "./dist/logger.js",
+      "require": "./dist/logger.cjs"
+    },
+    "./timer": {
+      "import": "./dist/timer.js",
+      "require": "./dist/timer.cjs"
+    },
+    "./tracer": {
+      "import": "./dist/tracer.js",
+      "require": "./dist/tracer.cjs"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    },
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "require": "./dist/index.cjs",
+        "default": "./dist/index.js"
+      },
+      "./*": {
+        "types": "./dist/*.d.ts",
+        "import": "./dist/*.js",
+        "require": "./dist/*.cjs",
+        "default": "./dist/*.js"
+      },
+      "./*.css": "./dist/*.css",
+      "./package.json": "./package.json"
+    }
+  },
+  "module": "./dist/index.js"
+}