@lssm/lib.logger 1.7.4 → 1.9.0

package/README.md

@@ -1,550 +1,51 @@
 # @lssm/lib.logger
 
-This library builds with tsdown using the shared `@lssm/tool.tsdown` presets.
+High-performance logging library optimized for Bun, with native ElysiaJS integration.
 
-A comprehensive logging library optimized for Bun with **first-class ElysiaJS integration**, distributed tracing, context management, and beautiful development output.
+## Purpose
 
-## Features
-
-- 🚀 **Optimized for Bun** - Uses Bun's native performance APIs and optimized for Bun runtime
-- 🦋 **ElysiaJS Native** - Seamless integration with [ElysiaJS](https://elysiajs.com) lifecycle and context
-- 🔍 **Distributed Tracing** - Track operations across HTTP, WebSocket, cron, and queue processing
-- ⏱️ **Performance Timing** - Built-in high-precision timing for operations
-- 🔄 **Context Management** - Maintain context across async operations (like cls-hooked/nestjs-cls)
-- 🎨 **Environment-aware Output** - Pretty logs in dev, structured JSON in production
-- 🔌 **Easy Integrations** - Built-in middleware for HTTP, WebSocket, cron, and queues
+To provide structured, performant logging with support for request tracing, timing, and varied output formats (JSON/Pretty). It includes a plugin for ElysiaJS to automatically log HTTP requests.
 
 ## Installation
 
 ```bash
+npm install @lssm/lib.logger
+# or
 bun add @lssm/lib.logger
-# If using ElysiaJS
-bun add elysia @lssm/lib.logger
-```
-
-## Quick Start
-
-```typescript
-import { logger, Logger, LogLevel } from "@lssm/lib.logger";
-
-// Basic logging
-logger.info("Server started", { port: 3000 });
-logger.error("Database error", { table: "users" }, error);
-
-// Create a custom logger
-const customLogger = new Logger({
-  level: LogLevel.DEBUG,
-  environment: "production",
-  enableTracing: true,
-});
-```
-
-## Core Logging
-
-```typescript
-import { logger } from "@lssm/lib.logger";
-
-// Different log levels
-logger.trace("Detailed debug info"); // TRACE level
-logger.debug("Debug information"); // DEBUG level
-logger.info("General information"); // INFO level
-logger.warn("Warning message"); // WARN level
-logger.error("Error occurred", {}, err); // ERROR level
-logger.fatal("Critical error", {}, err); // FATAL level
-```
-
-## Context Management
-
-The logger maintains context across async operations using AsyncLocalStorage:
-
-```typescript
-import { logger } from "@lssm/lib.logger";
-
-// Run code within a context
-logger.withContext({ userId: "123", requestId: "abc" }, () => {
-  logger.info("Processing user request"); // Will include userId and requestId
-
-  someAsyncOperation(); // Context is maintained across async calls
-});
-
-// Extend existing context
-logger.extendContext({ operation: "payment" }, () => {
-  logger.info("Processing payment"); // Includes all previous context + operation
-});
-
-// Set individual context values
-logger.setContext("sessionId", "xyz789");
-logger.info("User action"); // Will include sessionId
-
-// Get current context
-const context = logger.getContext();
-console.log(context); // { userId: '123', requestId: 'abc', sessionId: 'xyz789' }
-```
-
-## Distributed Tracing
-
-Track operations across your application with automatic span management:
-
-```typescript
-import { logger } from "@lssm/lib.logger";
-
-// Trace an operation
-await logger.trace(
-  {
-    operationType: "http",
-    operationName: "GET /api/users",
-    metadata: { userId: "123" },
-    tags: ["api", "users"],
-    autoTiming: true,
-  },
-  async () => {
-    // Your operation code here
-    const users = await fetchUsers();
-    return users;
-  }
-);
-
-// Manual span management
-const span = logger.startSpan({
-  operationType: "database",
-  operationName: "user-query",
-});
-
-try {
-  const result = await database.query("SELECT * FROM users");
-  logger.addTraceMetadata("rowCount", result.length);
-  logger.addTraceTags("database", "users");
-  return result;
-} finally {
-  logger.finishSpan(span.spanId);
-}
 ```
 
-## Performance Timing
-
-Measure execution times with high precision:
-
-```typescript
-import { logger } from "@lssm/lib.logger";
+## Key Concepts
 
-// Start a timer
-const timer = logger.startTimer("database-operation");
+- **Structured Logging**: Logs are JSON objects by default for easy parsing.
+- **Context Awareness**: Supports AsyncLocalStorage for request-scoped context (Trace IDs).
+- **Elysia Plugin**: Drop-in middleware for Elysia apps.
 
-// ... do some work ...
+## Exports
 
-const duration = timer.stop();
-console.log(`Operation took ${duration}ms`);
+- `logger`: The main logger instance.
+- `elysiaPlugin`: Middleware for Elysia.
+- `timer`: Utilities for measuring execution time.
+- `tracer`: Request tracing utilities.
 
-// Profile function execution
-const result = await logger.profile(
-  "expensive-calculation",
-  async () => {
-    return await someExpensiveOperation();
-  },
-  { logResult: true, logLevel: LogLevel.INFO }
-);
+## Usage
 
-// Manual timing with laps
-const timer2 = logger.startTimer("multi-step-process");
-timer2.lap("step-1-complete");
-// ... more work ...
-timer2.lap("step-2-complete");
-const total = timer2.stop();
-```
-
-## ElysiaJS Integration
+### Basic Logging
 
-### Basic Setup
+```ts
+import { logger } from '@lssm/lib.logger';
 
-```typescript
-import { Elysia } from "elysia";
-import { elysiaLogger } from "@lssm/lib.logger";
-
-const app = new Elysia()
-  .use(
-    elysiaLogger({
-      logRequests: true,
-      logResponses: true,
-      excludePaths: ["/health", "/metrics"],
-    })
-  )
-  .get("/", ({ logInfo }) => {
-    logInfo("Processing request");
-    return "Hello World";
-  })
-  .listen(3000);
+logger.info('Server started', { port: 3000 });
+logger.error('Database connection failed', { error: err });
 ```
 
-The plugin automatically:
+### With Elysia
 
-- ✅ Logs all incoming requests with timing
-- ✅ Logs responses with status codes and duration
-- ✅ Traces operations with correlation IDs
-- ✅ Maintains context across async operations
-- ✅ Provides helper functions in route context
+```ts
+import { Elysia } from 'elysia';
+import { elysiaLogger } from '@lssm/lib.logger/elysia-plugin';
 
-### Advanced ElysiaJS Usage
-
-```typescript
-import { Elysia } from "elysia";
-import {
-  elysiaLogger,
-  createDatabaseUtils,
-  Logger,
-  LogLevel,
-} from "@lssm/lib.logger";
-
-const customLogger = new Logger({
-  level: LogLevel.DEBUG,
-  environment: "production",
-});
-
-const db = createDatabaseUtils(customLogger);
-
-const app = new Elysia()
-  .use(
-    elysiaLogger({
-      logger: customLogger,
-      maskSensitiveData: true,
-    })
-  )
-  .derive(() => ({ db }))
-  .get("/users", async ({ logInfo, traceOperation, db }) => {
-    logInfo("Fetching users from database");
-
-    const users = await traceOperation("fetch-users", async () => {
-      return db.query("select-users", () =>
-        // Your database query here
-        Promise.resolve([{ id: 1, name: "John" }])
-      );
-    });
-
-    return users;
-  })
-  .listen(3000);
-```
-
-### ElysiaJS WebSocket Logging
-
-```typescript
-import { Elysia } from "elysia";
-import { elysiaLogger, createWebSocketUtils } from "@lssm/lib.logger";
-
-const wsLogger = createWebSocketUtils();
-
-const app = new Elysia()
+new Elysia()
   .use(elysiaLogger())
-  .ws("/chat", {
-    open(ws) {
-      const connectionId = crypto.randomUUID();
-      wsLogger.logConnection(connectionId, {
-        userAgent: ws.data.headers?.["user-agent"],
-      });
-    },
-    message(ws, message) {
-      wsLogger.logMessage(ws.id, typeof message, message.length);
-      ws.send(`Echo: ${message}`);
-    },
-    close(ws, code, reason) {
-      wsLogger.logDisconnection(ws.id, code, reason);
-    },
-  })
+  .get('/', () => 'Hello World')
   .listen(3000);
 ```
-
-### ElysiaJS with Authentication Logging
-
-```typescript
-import { Elysia } from "elysia";
-import { elysiaLogger, createAuthUtils } from "@lssm/lib.logger";
-
-const authLogger = createAuthUtils();
-
-const app = new Elysia()
-  .use(elysiaLogger())
-  .derive(() => ({ authLogger }))
-  .post("/auth/login", async ({ body, authLogger }) => {
-    try {
-      // Your authentication logic
-      const user = await authenticateUser(body.email, body.password);
-
-      authLogger.logLogin(user.id, {
-        email: body.email,
-        ip: request.headers.get("x-forwarded-for"),
-      });
-
-      return { success: true, token: generateToken(user) };
-    } catch (error) {
-      authLogger.logAuthFailure("invalid_credentials", {
-        email: body.email,
-      });
-      throw error;
-    }
-  })
-  .listen(3000);
-```
-
-### Production Configuration for ElysiaJS
-
-```typescript
-import { Elysia } from "elysia";
-import { elysiaLogger, Logger, LogLevel } from "@lssm/lib.logger";
-
-const productionLogger = new Logger({
-  level: LogLevel.INFO,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-});
-
-const app = new Elysia()
-  .use(
-    elysiaLogger({
-      logger: productionLogger,
-      logRequests: true,
-      logResponses: true,
-      excludePaths: ["/health", "/metrics", "/favicon.ico"],
-      maskSensitiveData: true,
-    })
-  )
-  .get("/health", () => ({ status: "ok" })) // This won't be logged
-  .get("/api/*", ({ logInfo, traceOperation }) => {
-    // All API routes automatically logged and traced
-    return traceOperation("business-logic", async () => {
-      // Your business logic here
-      return { success: true };
-    });
-  })
-  .listen(3000);
-```
-
-## HTTP Integration (Non-ElysiaJS)
-
-### Express/Hono Middleware
-
-```typescript
-import { createHttpMiddleware } from "@lssm/lib.logger";
-import express from "express";
-
-const app = express();
-
-// Add logging middleware
-app.use(createHttpMiddleware()); // Uses default logger
-
-// All subsequent requests will have context and tracing
-app.get("/api/users", (req, res) => {
-  logger.info("Fetching users"); // Automatically includes request context
-  // ... handle request
-});
-```
-
-### Bun HTTP Server
-
-```typescript
-import { createBunHttpHandler } from "@lssm/lib.logger";
-
-const handler = createBunHttpHandler(async (req) => {
-  // Request is automatically traced and timed
-  logger.info("Processing request"); // Includes request context
-
-  return new Response("Hello World");
-});
-
-Bun.serve({
-  fetch: handler,
-  port: 3000,
-});
-```
-
-## WebSocket Integration
-
-```typescript
-import { createWebSocketMiddleware } from "@lssm/lib.logger";
-
-const wsMiddleware = createWebSocketMiddleware();
-
-// WebSocket server setup
-const server = Bun.serve({
-  websocket: {
-    open: wsMiddleware.onOpen,
-    message: wsMiddleware.onMessage,
-    close: wsMiddleware.onClose,
-    error: wsMiddleware.onError,
-  },
-});
-```
-
-## Cron Job Integration
-
-```typescript
-import { createCronWrapper } from "@lssm/lib.logger";
-
-const cronWrapper = createCronWrapper();
-
-// Wrap your cron jobs
-const wrappedJob = cronWrapper("daily-cleanup", async () => {
-  logger.info("Starting daily cleanup");
-  await cleanupOldData();
-  logger.info("Cleanup completed");
-});
-
-// Schedule with your preferred cron library
-schedule.scheduleJob("0 2 * * *", wrappedJob);
-```
-
-## Queue Processing Integration
-
-```typescript
-import { createQueueWrapper } from "@lssm/lib.logger";
-
-const queueWrapper = createQueueWrapper();
-
-// Wrap queue processors
-const processEmailJob = queueWrapper.wrapProcessor(
-  "email-queue",
-  async (job: EmailJob, jobId: string) => {
-    logger.info("Processing email job", { recipient: job.recipient });
-    await sendEmail(job);
-    return { success: true };
-  }
-);
-
-// Log queue events
-queueWrapper.logEnqueue("email-queue", "job-123", emailData);
-queueWrapper.logDequeue("email-queue", "job-123");
-queueWrapper.logRetry("email-queue", "job-123", 2, 5);
-```
-
-## Database Integration
-
-```typescript
-import { createDatabaseWrapper } from "@lssm/lib.logger";
-
-const dbWrapper = createDatabaseWrapper();
-
-// Wrap database operations
-const users = await dbWrapper.wrapQuery(
-  "fetch-users",
-  () => prisma.user.findMany(),
-  { table: "users", operation: "findMany" }
-);
-```
-
-## Configuration
-
-```typescript
-import { Logger, LogLevel } from "@lssm/lib.logger";
-
-const logger = new Logger({
-  level: LogLevel.INFO, // Minimum log level
-  environment: "production", // 'development' | 'production' | 'test'
-  enableTracing: true, // Enable distributed tracing
-  enableTiming: true, // Enable performance timing
-  enableContext: true, // Enable context management
-  enableColors: true, // Enable colors in dev output
-  maxContextDepth: 10, // Max nested context depth
-  timestampFormat: "iso", // 'iso' | 'epoch' | 'relative'
-});
-```
-
-## Custom Formatters
-
-```typescript
-import {
-  Logger,
-  CustomFormatter,
-  DevFormatter,
-  ProductionFormatter,
-} from "@lssm/lib.logger";
-
-// Use custom formatter
-const customFormatter = new CustomFormatter(
-  "{timestamp} [{level}] {traceId} {message}",
-  (date) => date.toLocaleDateString()
-);
-
-const logger = new Logger();
-logger.setFormatter(customFormatter);
-
-// Or create your own
-class MyFormatter implements Formatter {
-  format(entry: LogEntry): string {
-    return `${entry.timestamp} - ${entry.message}`;
-  }
-}
-```
-
-## Example Output
-
-### Development Mode (Pretty)
-
-```
-14:32:15.123 ● INFO  [trace:a1b2c3d4|span:e5f6g7h8] HTTP request started (12.34ms)
-Context: { userId: "123", requestId: "req-456" }
-Metadata: { method: "GET", url: "/api/users", userAgent: "Mozilla/5.0..." }
-
-14:32:15.135 ✖ ERROR Database connection failed (156.78ms)
-Error: ConnectionError: Unable to connect to database
-  at DatabaseClient.connect (database.js:45:12)
-  at UserService.fetchUsers (user-service.js:23:8)
-  at ApiHandler.getUsers (api-handler.js:67:15)
-```
-
-### Production Mode (JSON)
-
-```json
-{"timestamp":"2024-01-15T14:32:15.123Z","level":"info","message":"HTTP request started","traceId":"a1b2c3d4e5f6g7h8","spanId":"e5f6g7h8","duration":12.34,"context":{"userId":"123","requestId":"req-456"},"metadata":{"method":"GET","url":"/api/users"}}
-
-{"timestamp":"2024-01-15T14:32:15.135Z","level":"error","message":"Database connection failed","traceId":"a1b2c3d4e5f6g7h8","duration":156.78,"error":{"name":"ConnectionError","message":"Unable to connect to database","stack":"ConnectionError: Unable to connect to database\n    at DatabaseClient.connect..."}}
-```
-
-## Best Practices
-
-1. **Use context for request correlation**:
-
-   ```typescript
-   logger.withContext({ requestId, userId }, () => {
-     // All logs in this scope will include requestId and userId
-   });
-   ```
-
-2. **Trace important operations**:
-
-   ```typescript
-   await logger.trace(
-     {
-       operationType: "database",
-       operationName: "user-creation",
-     },
-     () => createUser(userData)
-   );
-   ```
-
-3. **Profile performance-critical code**:
-
-   ```typescript
-   const result = await logger.profile("data-processing", () => {
-     return processLargeDataset(data);
-   });
-   ```
-
-4. **Use appropriate log levels**:
-
-   - `trace`: Very detailed debugging (typically disabled in production)
-   - `debug`: Debugging information
-   - `info`: General application flow
-   - `warn`: Warning conditions
-   - `error`: Error conditions
-   - `fatal`: Critical errors that might cause the application to exit
-
-5. **Clean up in production**:
-   ```typescript
-   process.on("SIGTERM", async () => {
-     await logger.flush();
-     process.exit(0);
-   });
-   ```
-
-## License
-
-MIT

package/dist/{context.d.ts → context.d.mts}

@@ -1,4 +1,4 @@
-import { ContextData, TraceContext } from "./types.js";
+import { ContextData, TraceContext } from "./types.mjs";
 
 //#region src/context.d.ts
 declare class LogContext {
@@ -41,4 +41,4 @@ declare class LogContext {
 }
 //#endregion
 export { LogContext };
-//# sourceMappingURL=context.d.ts.map
+//# sourceMappingURL=context.d.mts.map

package/dist/{context.d.cts.map → context.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"context.d.cts","names":[],"sources":["../src/context.ts"],"sourcesContent":[],"mappings":";;;cAQa,UAAA;;EAAA,QAAA,OAAU;EAQC,WAAA,CAAA;EAUN,OAAA,WAAA,CAAA,CAAA,EAVM,UAUN;EAAuB;;;EAWV,GAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAXb,WAWa,EAAA,EAAA,EAAA,GAAA,GAXU,CAWV,CAAA,EAXc,CAWd;EAAgC;;;EA+B/C,MAAA,CAAA,CAAA,CAAA,CAAA,iBAAA,EA/Be,OA+Bf,CA/BuB,WA+BvB,CAAA,EAAA,EAAA,EAAA,GAAA,GA/B+C,CA+B/C,CAAA,EA/BmD,CA+BnD;EAQE;;;;;;;uBAhBK;;;;gBAQP;;;;kBAQE;;;;qBAUG"}
+{"version":3,"file":"context.d.mts","names":[],"sources":["../src/context.ts"],"sourcesContent":[],"mappings":";;;cAQa,UAAA;;EAAA,QAAA,OAAU;EAQC,WAAA,CAAA;EAUN,OAAA,WAAA,CAAA,CAAA,EAVM,UAUN;EAAuB;;;EAWV,GAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAXb,WAWa,EAAA,EAAA,EAAA,GAAA,GAXU,CAWV,CAAA,EAXc,CAWd;EAAgC;;;EA+B/C,MAAA,CAAA,CAAA,CAAA,CAAA,iBAAA,EA/Be,OA+Bf,CA/BuB,WA+BvB,CAAA,EAAA,EAAA,EAAA,GAAA,GA/B+C,CA+B/C,CAAA,EA/BmD,CA+BnD;EAQE;;;;;;;uBAhBK;;;;gBAQP;;;;kBAQE;;;;qBAUG"}

package/dist/{context.js → context.mjs}

@@ -1,2 +1,2 @@
 import{AsyncLocalStorage as e}from"node:async_hooks";var t=class t{static instance;storage;constructor(){this.storage=new e}static getInstance(){return t.instance||=new t,t.instance}run(e,t){let n={context:{...e},trace:this.getCurrentTrace()};return this.storage.run(n,t)}extend(e,t){let n={...this.getContext(),...e};return this.run(n,t)}set(e,t){let n=this.storage.getStore();n&&(n.context[e]=t)}get(e){return this.storage.getStore()?.context?.[e]}getContext(){return this.storage.getStore()?.context||{}}setTrace(e){let t=this.storage.getStore();t&&(t.trace=e)}getCurrentTrace(){return this.storage.getStore()?.trace}generateId(){return crypto.randomUUID()}};export{t as LogContext};
-//# sourceMappingURL=context.js.map
+//# sourceMappingURL=context.mjs.map

package/dist/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","names":["contextData: LogContextData","mergedContext: ContextData"],"sources":["../src/context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { ContextData, TraceContext } from './types';\n\ninterface LogContextData {\n  context: ContextData;\n  trace?: TraceContext;\n}\n\nexport class LogContext {\n  private static instance: LogContext;\n  private storage: AsyncLocalStorage<LogContextData>;\n\n  constructor() {\n    this.storage = new AsyncLocalStorage<LogContextData>();\n  }\n\n  static getInstance(): LogContext {\n    if (!LogContext.instance) {\n      LogContext.instance = new LogContext();\n    }\n    return LogContext.instance;\n  }\n\n  /**\n   * Run a function with a new context\n   */\n  run<T>(context: ContextData, fn: () => T): T {\n    const contextData: LogContextData = {\n      context: { ...context },\n      trace: this.getCurrentTrace(),\n    };\n    return this.storage.run(contextData, fn) as T;\n  }\n\n  /**\n   * Run a function with an extended context (merges with current)\n   */\n  extend<T>(additionalContext: Partial<ContextData>, fn: () => T): T {\n    const currentContext = this.getContext();\n    const mergedContext: ContextData = {\n      ...currentContext,\n      ...additionalContext,\n    };\n    return this.run(mergedContext, fn);\n  }\n\n  /**\n   * Set context data for the current execution context\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  set(key: string, value: any): void {\n    const current = this.storage.getStore();\n    if (current) {\n      current.context[key] = value;\n    }\n  }\n\n  /**\n   * Get a specific context value\n   */\n  get<T>(key: string): T | undefined {\n    const current = this.storage.getStore();\n    return current?.context?.[key];\n  }\n\n  /**\n   * Get all context data\n   */\n  getContext(): ContextData {\n    const current = this.storage.getStore();\n    return current?.context || {};\n  }\n\n  /**\n   * Set trace context\n   */\n  setTrace(trace: TraceContext): void {\n    const current = this.storage.getStore();\n    if (current) {\n      current.trace = trace;\n    }\n  }\n\n  /**\n   * Get current trace context\n   */\n  getCurrentTrace(): TraceContext | undefined {\n    const current = this.storage.getStore();\n    return current?.trace;\n  }\n  /**\n   * Generate a unique ID for requests/operations\n   */\n  generateId(): string {\n    return crypto.randomUUID();\n  }\n}\n"],"mappings":"qDAQA,IAAa,EAAb,MAAa,CAAW,CACtB,OAAe,SACf,QAEA,aAAc,CACZ,KAAK,QAAU,IAAI,EAGrB,OAAO,aAA0B,CAI/B,MAHA,CACE,EAAW,WAAW,IAAI,EAErB,EAAW,SAMpB,IAAO,EAAsB,EAAgB,CAC3C,IAAMA,EAA8B,CAClC,QAAS,CAAE,GAAG,EAAS,CACvB,MAAO,KAAK,iBAAiB,CAC9B,CACD,OAAO,KAAK,QAAQ,IAAI,EAAa,EAAG,CAM1C,OAAU,EAAyC,EAAgB,CAEjE,IAAMC,EAA6B,CACjC,GAFqB,KAAK,YAAY,CAGtC,GAAG,EACJ,CACD,OAAO,KAAK,IAAI,EAAe,EAAG,CAOpC,IAAI,EAAa,EAAkB,CACjC,IAAM,EAAU,KAAK,QAAQ,UAAU,CACnC,IACF,EAAQ,QAAQ,GAAO,GAO3B,IAAO,EAA4B,CAEjC,OADgB,KAAK,QAAQ,UAAU,EACvB,UAAU,GAM5B,YAA0B,CAExB,OADgB,KAAK,QAAQ,UAAU,EACvB,SAAW,EAAE,CAM/B,SAAS,EAA2B,CAClC,IAAM,EAAU,KAAK,QAAQ,UAAU,CACnC,IACF,EAAQ,MAAQ,GAOpB,iBAA4C,CAE1C,OADgB,KAAK,QAAQ,UAAU,EACvB,MAKlB,YAAqB,CACnB,OAAO,OAAO,YAAY"}

package/dist/{elysia-plugin.d.cts → elysia-plugin.d.mts}

@@ -1,5 +1,5 @@
-import { ContextData } from "./types.cjs";
-import { Logger } from "./logger.cjs";
+import { ContextData } from "./types.mjs";
+import { Logger } from "./logger.mjs";
 import * as elysia0 from "elysia";
 import { Elysia } from "elysia";
 
@@ -61,4 +61,4 @@ declare function elysiaLogger<T extends Elysia>(config?: ElysiaLoggerConfig): (a
 declare const createElysiaLogger: typeof elysiaLogger;
 //#endregion
 export { ElysiaLoggerConfig, createElysiaLogger, elysiaLogger };
-//# sourceMappingURL=elysia-plugin.d.cts.map
+//# sourceMappingURL=elysia-plugin.d.mts.map

package/dist/{elysia-plugin.d.cts.map → elysia-plugin.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"elysia-plugin.d.cts","names":[],"sources":["../src/elysia-plugin.ts"],"sourcesContent":[],"mappings":";;;;;;UAKiB,kBAAA;WACN;;EADM,YAAA,CAAA,EAAA,OAAkB;EAWnB,YAAA,CAAA,EAAY,MAAA,EAAA;;;;;;iBAAZ,uBAAuB,iBAC7B,2BAYc,MAAC;EA+EqB,SAAA,EAAA,CAAA,CAAA;EAK5B,KAAA,EAAA,CAAA,CAAA;EAEG,MAAA,EAAA,CAAA,CAAA;EAMM,OAAA,EAAA,CAAA,CAAA;CAAY,EAAA;EAAR,OAAA,EAAA,CAAA,CAAA;EACZ,KAAA,EAAA,CAAA,CAAA;CAAR,EAAA;EAdmC,MAAA,EAAA,CAAA,CAAA;EAK5B,gBAAA,EAAA,CAAA,CAAA;EAEG,KAAA,EAAA,CAAA,CAAA;EAMM,OAAA,EAAA,CAAA,CAAA;EAAY,MAAA,EAAA,CAAA,CAAA;EAAR,QAAA,EAAA,CAAA,CAAA;CACZ,EAAA,CAAA,CAAA,EAAA;EAAR,MAAA,EAAA,CAAA,CAAA;EAAO,OAAA,EAAA,CAAA,CAAA;EA7FO,MAAA,EAAA,CAAA,CAAA;EAAA,gBAAA,EAAA,CAAA,CAAA;EA4GZ,QAAA,EAAA,CAAA,CAAA;;;;;;;;;;;mDA7BiC;iDAK5B,kBAEG;2EAMM,MAAI,QAAQ,SAC5B,QAAQ;;;;;YAAD,OAAA,CAAA;mDAd4B;iDAK5B,kBAEG;2EAMM,MAAI,QAAQ,SAC5B,QAAQ;;;cAeN,2BAAkB"}
+{"version":3,"file":"elysia-plugin.d.mts","names":[],"sources":["../src/elysia-plugin.ts"],"sourcesContent":[],"mappings":";;;;;;UAKiB,kBAAA;WACN;;EADM,YAAA,CAAA,EAAA,OAAkB;EAWnB,YAAA,CAAA,EAAY,MAAA,EAAA;;;;;;iBAAZ,uBAAuB,iBAC7B,2BAYc,MAAC;EA+EqB,SAAA,EAAA,CAAA,CAAA;EAK5B,KAAA,EAAA,CAAA,CAAA;EAEG,MAAA,EAAA,CAAA,CAAA;EAMM,OAAA,EAAA,CAAA,CAAA;CAAY,EAAA;EAAR,OAAA,EAAA,CAAA,CAAA;EACZ,KAAA,EAAA,CAAA,CAAA;CAAR,EAAA;EAdmC,MAAA,EAAA,CAAA,CAAA;EAK5B,gBAAA,EAAA,CAAA,CAAA;EAEG,KAAA,EAAA,CAAA,CAAA;EAMM,OAAA,EAAA,CAAA,CAAA;EAAY,MAAA,EAAA,CAAA,CAAA;EAAR,QAAA,EAAA,CAAA,CAAA;CACZ,EAAA,CAAA,CAAA,EAAA;EAAR,MAAA,EAAA,CAAA,CAAA;EAAO,OAAA,EAAA,CAAA,CAAA;EA7FO,MAAA,EAAA,CAAA,CAAA;EAAA,gBAAA,EAAA,CAAA,CAAA;EA4GZ,QAAA,EAAA,CAAA,CAAA;;;;;;;;;;;mDA7BiC;iDAK5B,kBAEG;2EAMM,MAAI,QAAQ,SAC5B,QAAQ;;;;;YAAD,OAAA,CAAA;mDAd4B;iDAK5B,kBAEG;2EAMM,MAAI,QAAQ,SAC5B,QAAQ;;;cAeN,2BAAkB"}

package/dist/elysia-plugin.mjs

@@ -0,0 +1,2 @@
+import{LogContext as e}from"./context.mjs";import{Logger as t}from"./logger.mjs";import{Elysia as n}from"elysia";function r(n={}){let{logger:r=new t,logRequests:i=!0,logResponses:a=!0,excludePaths:o=[`/health`,`/metrics`]}=n,s=e.getInstance();return function(e){return e.derive(e=>{let{request:t,path:n}=e;if(o.some(e=>n.startsWith(e)))return{logger:r};let a=new URL(t.url),c={requestId:s.generateId(),method:t.method,url:t.url,path:a.pathname,userAgent:t.headers.get(`user-agent`)||void 0,timestamp:new Date().toISOString()},l=performance.now();return s.run(c,()=>{i&&r.info(`→ ${t.method} ${n}`,{method:t.method,path:n,userAgent:c.userAgent,requestId:c.requestId})}),{logger:r,requestContext:c,startTime:l}}).onAfterHandle(e=>{let{request:t,startTime:n,requestContext:r,logger:i}=e;if(!n||!r)return;let o=performance.now()-n,s=new URL(t.url).pathname;a&&i.info(`← 200 ${t.method} ${s}`,{method:t.method,path:s,duration:`${o.toFixed(2)}ms`,requestId:r.requestId})}).onError(e=>{let{request:t,error:n,code:r,startTime:i,requestContext:a,logger:o}=e;if(!i||!a)return;let s=performance.now()-i,c=new URL(t.url).pathname;o?.error(`✖ ${r} ${t.method} ${c}`,{method:t.method,path:c,error:n?.toString?.()||`Unknown error`,code:r,duration:`${s.toFixed(2)}ms`,requestId:a.requestId})}).derive(()=>({logInfo:(e,t)=>{r.info(e,t)},logError:(e,t,n)=>{r.error(e,n,t)},traceOperation:async(e,t)=>r.trace({operationType:`custom`,operationName:e,autoTiming:!0},t)}))}}const i=r;export{i as createElysiaLogger,r as elysiaLogger};
+//# sourceMappingURL=elysia-plugin.mjs.map

package/dist/elysia-plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"elysia-plugin.mjs","names":["requestContext: ContextData"],"sources":["../src/elysia-plugin.ts"],"sourcesContent":["import { Logger } from './logger';\nimport { LogContext } from './context';\nimport type { ContextData } from './types';\nimport { Elysia } from 'elysia';\n\nexport interface ElysiaLoggerConfig {\n  logger?: Logger;\n  logRequests?: boolean;\n  logResponses?: boolean;\n  excludePaths?: string[];\n}\n\n/**\n * Simple ElysiaJS Logger Plugin\n * Provides automatic request logging and tracing\n */\nexport function elysiaLogger<T extends Elysia>(\n  config: ElysiaLoggerConfig = {}\n) {\n  const {\n    logger = new Logger(),\n    logRequests = true,\n    logResponses = true,\n    excludePaths = ['/health', '/metrics'],\n  } = config;\n\n  const context = LogContext.getInstance();\n\n  // For type compatibility, we use a factory function\n  return function (app: T) {\n    return app\n      .derive((ctx) => {\n        const { request, path } = ctx;\n\n        // Skip excluded paths\n        if (excludePaths.some((excludePath) => path.startsWith(excludePath))) {\n          return { logger };\n        }\n\n        // Create request context\n        const url = new URL(request.url);\n        const requestContext: ContextData = {\n          requestId: context.generateId(),\n          method: request.method,\n          url: request.url,\n          path: url.pathname,\n          userAgent: request.headers.get('user-agent') || undefined,\n          timestamp: new Date().toISOString(),\n        };\n\n        const startTime = performance.now();\n\n        // Run in context\n        context.run(requestContext, () => {\n          // Log request\n          if (logRequests) {\n            logger.info(`→ ${request.method} ${path}`, {\n              method: request.method,\n              path,\n              userAgent: requestContext.userAgent,\n              requestId: requestContext.requestId,\n            });\n          }\n        });\n\n        return {\n          logger,\n          requestContext,\n          startTime,\n        };\n      })\n      .onAfterHandle((ctx) => {\n        const { request, startTime, requestContext, logger } = ctx;\n\n        if (!startTime || !requestContext) return;\n\n        const duration = performance.now() - startTime;\n        const path = new URL(request.url).pathname;\n\n        if (logResponses) {\n          logger.info(`← 200 ${request.method} ${path}`, {\n            method: request.method,\n            path,\n            duration: `${duration.toFixed(2)}ms`,\n            requestId: requestContext.requestId,\n          });\n        }\n      })\n      .onError((ctx) => {\n        const { request, error, code, startTime, requestContext, logger } = ctx;\n\n        if (!startTime || !requestContext) return;\n\n        const duration = performance.now() - startTime;\n        const path = new URL(request.url).pathname;\n\n        logger?.error(`✖ ${code} ${request.method} ${path}`, {\n          method: request.method,\n          path,\n          error: error?.toString?.() || 'Unknown error',\n          code,\n          duration: `${duration.toFixed(2)}ms`,\n          requestId: requestContext.requestId,\n        });\n      })\n      .derive(() => ({\n        // Helper functions available in route handlers\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        logInfo: (message: string, metadata?: Record<string, any>) => {\n          logger.info(message, metadata);\n        },\n        logError: (\n          message: string,\n          error?: Error,\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          metadata?: Record<string, any>\n        ) => {\n          logger.error(message, metadata, error);\n        },\n        traceOperation: async <T>(\n          operationName: string,\n          operation: () => T | Promise<T>\n        ): Promise<T> => {\n          return logger.trace(\n            {\n              operationType: 'custom',\n              operationName,\n              autoTiming: true,\n            },\n            operation\n          );\n        },\n      }));\n  };\n}\n\n// Export convenience functions\nexport const createElysiaLogger = elysiaLogger;\n"],"mappings":"iHAgBA,SAAgB,EACd,EAA6B,EAAE,CAC/B,CACA,GAAM,CACJ,SAAS,IAAI,EACb,cAAc,GACd,eAAe,GACf,eAAe,CAAC,UAAW,WAAW,EACpC,EAEE,EAAU,EAAW,aAAa,CAGxC,OAAO,SAAU,EAAQ,CACvB,OAAO,EACJ,OAAQ,GAAQ,CACf,GAAM,CAAE,UAAS,QAAS,EAG1B,GAAI,EAAa,KAAM,GAAgB,EAAK,WAAW,EAAY,CAAC,CAClE,MAAO,CAAE,SAAQ,CAInB,IAAM,EAAM,IAAI,IAAI,EAAQ,IAAI,CAC1BA,EAA8B,CAClC,UAAW,EAAQ,YAAY,CAC/B,OAAQ,EAAQ,OAChB,IAAK,EAAQ,IACb,KAAM,EAAI,SACV,UAAW,EAAQ,QAAQ,IAAI,aAAa,EAAI,IAAA,GAChD,UAAW,IAAI,MAAM,CAAC,aAAa,CACpC,CAEK,EAAY,YAAY,KAAK,CAenC,OAZA,EAAQ,IAAI,MAAsB,CAE5B,GACF,EAAO,KAAK,KAAK,EAAQ,OAAO,GAAG,IAAQ,CACzC,OAAQ,EAAQ,OAChB,OACA,UAAW,EAAe,UAC1B,UAAW,EAAe,UAC3B,CAAC,EAEJ,CAEK,CACL,SACA,iBACA,YACD,EACD,CACD,cAAe,GAAQ,CACtB,GAAM,CAAE,UAAS,YAAW,iBAAgB,OAAA,GAAW,EAEvD,GAAI,CAAC,GAAa,CAAC,EAAgB,OAEnC,IAAM,EAAW,YAAY,KAAK,CAAG,EAC/B,EAAO,IAAI,IAAI,EAAQ,IAAI,CAAC,SAE9B,GACF,EAAO,KAAK,SAAS,EAAQ,OAAO,GAAG,IAAQ,CAC7C,OAAQ,EAAQ,OAChB,OACA,SAAU,GAAG,EAAS,QAAQ,EAAE,CAAC,IACjC,UAAW,EAAe,UAC3B,CAAC,EAEJ,CACD,QAAS,GAAQ,CAChB,GAAM,CAAE,UAAS,QAAO,OAAM,YAAW,iBAAgB,OAAA,GAAW,EAEpE,GAAI,CAAC,GAAa,CAAC,EAAgB,OAEnC,IAAM,EAAW,YAAY,KAAK,CAAG,EAC/B,EAAO,IAAI,IAAI,EAAQ,IAAI,CAAC,SAElC,GAAQ,MAAM,KAAK,EAAK,GAAG,EAAQ,OAAO,GAAG,IAAQ,CACnD,OAAQ,EAAQ,OAChB,OACA,MAAO,GAAO,YAAY,EAAI,gBAC9B,OACA,SAAU,GAAG,EAAS,QAAQ,EAAE,CAAC,IACjC,UAAW,EAAe,UAC3B,CAAC,EACF,CACD,YAAc,CAGb,SAAU,EAAiB,IAAmC,CAC5D,EAAO,KAAK,EAAS,EAAS,EAEhC,UACE,EACA,EAEA,IACG,CACH,EAAO,MAAM,EAAS,EAAU,EAAM,EAExC,eAAgB,MACd,EACA,IAEO,EAAO,MACZ,CACE,cAAe,SACf,gBACA,WAAY,GACb,CACD,EACD,CAEJ,EAAE,EAKT,MAAa,EAAqB"}

package/dist/{formatters.d.cts → formatters.d.mts}

@@ -1,4 +1,4 @@
-import { Formatter, LogEntry } from "./types.cjs";
+import { Formatter, LogEntry } from "./types.mjs";
 
 //#region src/formatters.d.ts
 declare class DevFormatter implements Formatter {
@@ -26,4 +26,4 @@ declare class CustomFormatter implements Formatter {
 }
 //#endregion
 export { CustomFormatter, DevFormatter, ProductionFormatter };
-//# sourceMappingURL=formatters.d.cts.map
+//# sourceMappingURL=formatters.d.mts.map

package/dist/{formatters.d.cts.map → formatters.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"formatters.d.cts","names":[],"sources":["../src/formatters.ts"],"sourcesContent":[],"mappings":";;;cAkCa,YAAA,YAAwB;;EAAxB,WAAA,CAAA,YAOG,CAPU,EAOV,OAAA;EAkJH,MAAA,CAAA,KAAA,EAlJG,QAkJiB,CAAA,EAAA,MAAA;EAkDpB,QAAA,eAAgB;EAML,QAAA,eAAA;EAMR,QAAA,cAAA;EAZwB,QAAA,aAAA;EAAS,QAAA,cAAA;;;;;;cAlDpC,mBAAA,YAA+B;gBAC5B;;cAiDH,eAAA,YAA2B;;;qDAMhB;gBAMR"}
+{"version":3,"file":"formatters.d.mts","names":[],"sources":["../src/formatters.ts"],"sourcesContent":[],"mappings":";;;cAkCa,YAAA,YAAwB;;EAAxB,WAAA,CAAA,YAOG,CAPU,EAOV,OAAA;EAkJH,MAAA,CAAA,KAAA,EAlJG,QAkJiB,CAAA,EAAA,MAAA;EAkDpB,QAAA,eAAgB;EAML,QAAA,eAAA;EAMR,QAAA,cAAA;EAZwB,QAAA,aAAA;EAAS,QAAA,cAAA;;;;;;cAlDpC,mBAAA,YAA+B;gBAC5B;;cAiDH,eAAA,YAA2B;;;qDAMhB;gBAMR"}