@contractspec/lib.logger 1.57.0 → 1.59.0

package/dist/context.browser.d.ts

@@ -0,0 +1,44 @@
+import 'zone.js';
+import type { ContextData, TraceContext } from './types';
+/**
+ * Browser implementation of LogContext using Zone.js for async context
+ * propagation (similar to AsyncLocalStorage in Node).
+ */
+export declare class LogContext {
+    private static instance;
+    private static fallbackCounter;
+    static getInstance(): LogContext;
+    /**
+     * Run a function with a new context
+     */
+    run<T>(context: ContextData, fn: () => T): T;
+    /**
+     * Run a function with an extended context (merges with current)
+     */
+    extend<T>(additionalContext: Partial<ContextData>, fn: () => T): T;
+    /**
+     * Set context data for the current execution context
+     */
+    set(key: string, value: unknown): void;
+    /**
+     * Get a specific context value
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Get all context data
+     */
+    getContext(): ContextData;
+    /**
+     * Set trace context
+     */
+    setTrace(trace: TraceContext): void;
+    /**
+     * Get current trace context
+     */
+    getCurrentTrace(): TraceContext | undefined;
+    /**
+     * Generate a unique ID for requests/operations
+     */
+    generateId(): string;
+}
+//# sourceMappingURL=context.browser.d.ts.map

package/dist/context.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.browser.d.ts","sourceRoot":"","sources":["../src/context.browser.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BzD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAa;IACpC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAK;IAEnC,MAAM,CAAC,WAAW,IAAI,UAAU;IAOhC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAkB5C;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IASlE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAOtC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKlC;;OAEG;IACH,UAAU,IAAI,WAAW;IAKzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAOnC;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,SAAS;IAK3C;;OAEG;IACH,UAAU,IAAI,MAAM;CAYrB"}

package/dist/context.browser.js

@@ -0,0 +1,77 @@
+// @bun
+// src/context.browser.ts
+import"zone.js";
+var ZONE = globalThis.Zone;
+var STORE_KEY = "__lssm_log_context_data__";
+function getStore() {
+  if (!ZONE)
+    return;
+  return ZONE.current.get(STORE_KEY);
+}
+
+class LogContext {
+  static instance;
+  static fallbackCounter = 0;
+  static getInstance() {
+    if (!LogContext.instance) {
+      LogContext.instance = new LogContext;
+    }
+    return LogContext.instance;
+  }
+  run(context, fn) {
+    const contextData = {
+      context: { ...context },
+      trace: this.getCurrentTrace()
+    };
+    if (!ZONE) {
+      return fn();
+    }
+    const zone = ZONE.current.fork({
+      name: "log-context",
+      properties: { [STORE_KEY]: contextData }
+    });
+    return zone.run(fn);
+  }
+  extend(additionalContext, fn) {
+    const currentContext = this.getContext();
+    const mergedContext = {
+      ...currentContext,
+      ...additionalContext
+    };
+    return this.run(mergedContext, fn);
+  }
+  set(key, value) {
+    const current = getStore();
+    if (current) {
+      current.context[key] = value;
+    }
+  }
+  get(key) {
+    const current = getStore();
+    return current?.context?.[key];
+  }
+  getContext() {
+    const current = getStore();
+    return current?.context || {};
+  }
+  setTrace(trace) {
+    const current = getStore();
+    if (current) {
+      current.trace = trace;
+    }
+  }
+  getCurrentTrace() {
+    const current = getStore();
+    return current?.trace;
+  }
+  generateId() {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+      return crypto.randomUUID();
+    }
+    LogContext.fallbackCounter += 1;
+    return `log-${LogContext.fallbackCounter}`;
+  }
+}
+export {
+  LogContext
+};

package/dist/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared context types / interface.
+ *
+ * Runtime-specific implementations live in:
+ * - `./context.node.ts` (Node.js / Bun)
+ * - `./context.browser.ts` (Browser, via Zone.js)
+ *
+ * This file must remain free of runtime-specific imports so it can be safely
+ * referenced in any compilation context.
+ */
+export type { ContextData, TraceContext } from './types';
+export interface LogContextApi {
+    run<T>(context: import('./types').ContextData, fn: () => T): T;
+    extend<T>(additionalContext: Partial<import('./types').ContextData>, fn: () => T): T;
+    set(key: string, value: unknown): void;
+    get<T>(key: string): T | undefined;
+    getContext(): import('./types').ContextData;
+    setTrace(trace: import('./types').TraceContext): void;
+    getCurrentTrace(): import('./types').TraceContext | undefined;
+    generateId(): string;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,CAAC,CAAC,EACN,iBAAiB,EAAE,OAAO,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC,EACzD,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAAC;IACL,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,UAAU,IAAI,OAAO,SAAS,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IACtD,eAAe,IAAI,OAAO,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9D,UAAU,IAAI,MAAM,CAAC;CACtB"}

package/dist/context.js

@@ -0,0 +1 @@
+// @bun

package/dist/context.node.d.ts

@@ -0,0 +1,43 @@
+import type { ContextData, TraceContext } from './types';
+/**
+ * Node.js implementation of LogContext using AsyncLocalStorage.
+ */
+export declare class LogContext {
+    private static instance;
+    private storage;
+    constructor();
+    static getInstance(): LogContext;
+    /**
+     * Run a function with a new context
+     */
+    run<T>(context: ContextData, fn: () => T): T;
+    /**
+     * Run a function with an extended context (merges with current)
+     */
+    extend<T>(additionalContext: Partial<ContextData>, fn: () => T): T;
+    /**
+     * Set context data for the current execution context
+     */
+    set(key: string, value: unknown): void;
+    /**
+     * Get a specific context value
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Get all context data
+     */
+    getContext(): ContextData;
+    /**
+     * Set trace context
+     */
+    setTrace(trace: TraceContext): void;
+    /**
+     * Get current trace context
+     */
+    getCurrentTrace(): TraceContext | undefined;
+    /**
+     * Generate a unique ID for requests/operations
+     */
+    generateId(): string;
+}
+//# sourceMappingURL=context.node.d.ts.map

package/dist/context.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.node.d.ts","sourceRoot":"","sources":["../src/context.node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOzD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAa;IACpC,OAAO,CAAC,OAAO,CAAoC;;IAMnD,MAAM,CAAC,WAAW,IAAI,UAAU;IAOhC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAQ5C;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IASlE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAOtC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKlC;;OAEG;IACH,UAAU,IAAI,WAAW;IAKzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAOnC;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,SAAS;IAK3C;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}

package/dist/context.node.js

@@ -0,0 +1,62 @@
+// @bun
+// src/context.node.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+class LogContext {
+  static instance;
+  storage;
+  constructor() {
+    this.storage = new AsyncLocalStorage;
+  }
+  static getInstance() {
+    if (!LogContext.instance) {
+      LogContext.instance = new LogContext;
+    }
+    return LogContext.instance;
+  }
+  run(context, fn) {
+    const contextData = {
+      context: { ...context },
+      trace: this.getCurrentTrace()
+    };
+    return this.storage.run(contextData, fn);
+  }
+  extend(additionalContext, fn) {
+    const currentContext = this.getContext();
+    const mergedContext = {
+      ...currentContext,
+      ...additionalContext
+    };
+    return this.run(mergedContext, fn);
+  }
+  set(key, value) {
+    const current = this.storage.getStore();
+    if (current) {
+      current.context[key] = value;
+    }
+  }
+  get(key) {
+    const current = this.storage.getStore();
+    return current?.context?.[key];
+  }
+  getContext() {
+    const current = this.storage.getStore();
+    return current?.context || {};
+  }
+  setTrace(trace) {
+    const current = this.storage.getStore();
+    if (current) {
+      current.trace = trace;
+    }
+  }
+  getCurrentTrace() {
+    const current = this.storage.getStore();
+    return current?.trace;
+  }
+  generateId() {
+    return crypto.randomUUID();
+  }
+}
+export {
+  LogContext
+};

package/dist/elysia-plugin.d.ts

@@ -0,0 +1,58 @@
+import { Logger } from './logger.node';
+import type { ContextData } from './types';
+import { Elysia } from 'elysia';
+export interface ElysiaLoggerConfig {
+    logger?: Logger;
+    logRequests?: boolean;
+    logResponses?: boolean;
+    excludePaths?: string[];
+}
+/**
+ * Simple ElysiaJS Logger Plugin
+ * Provides automatic request logging and tracing
+ */
+export declare function elysiaLogger<T extends Elysia>(config?: ElysiaLoggerConfig): (app: T) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: ({
+        readonly logger: Logger;
+        readonly requestContext?: undefined;
+        readonly startTime?: undefined;
+    } | {
+        readonly logger: Logger;
+        readonly requestContext: ContextData;
+        readonly startTime: number;
+    }) & {
+        readonly logInfo: (message: string, metadata?: Record<string, any>) => void;
+        readonly logError: (message: string, error?: Error, metadata?: Record<string, any>) => void;
+        readonly traceOperation: <T_1>(operationName: string, operation: () => T_1 | Promise<T_1>) => Promise<T_1>;
+    };
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: import("elysia").ExtractErrorFromHandle<{
+        readonly logInfo: (message: string, metadata?: Record<string, any>) => void;
+        readonly logError: (message: string, error?: Error, metadata?: Record<string, any>) => void;
+        readonly traceOperation: <T_1>(operationName: string, operation: () => T_1 | Promise<T_1>) => Promise<T_1>;
+    }>;
+}>;
+//# sourceMappingURL=elysia-plugin.d.ts.map

package/dist/elysia-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elysia-plugin.d.ts","sourceRoot":"","sources":["../src/elysia-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,MAAM,GAAE,kBAAuB,IAYd,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCA+EE,MAAM,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;qCAI9C,MAAM,UACP,KAAK,aAEF,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;sDAKf,MAAM,aACV,MAAM,GAAC,GAAG,OAAO,CAAC,GAAC,CAAC,KAC9B,OAAO,CAAC,GAAC,CAAC;;;;;;oCAdM,MAAM,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;qCAI9C,MAAM,UACP,KAAK,aAEF,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;sDAKf,MAAM,aACV,MAAM,GAAC,GAAG,OAAO,CAAC,GAAC,CAAC,KAC9B,OAAO,CAAC,GAAC,CAAC;;GAYpB"}