unnbound-logger-sdk 1.0.0 → 1.1.0

package/README.md

@@ -169,7 +169,7 @@ logger.dbQueryTransaction({
 
 ### Express Trace Middleware
 
-The library provides a trace middleware for Express applications that automatically logs HTTP requests and maintains trace context:
+The library provides a comprehensive trace middleware for Express applications that automatically handles trace context and HTTP logging:
 
 ```typescript
 import { UnnboundLogger } from 'unnbound-logger';
@@ -178,20 +178,21 @@ import express from 'express';
 const app = express();
 const logger = new UnnboundLogger();
 
-// Apply the trace middleware globally
+// Apply the comprehensive trace middleware globally
 app.use(logger.traceMiddleware);
-
 ```
 
 The trace middleware automatically:
-- Logs incoming requests with method, URL, headers, and body
 - Generates and maintains trace IDs across the request lifecycle
-- Measures request duration
+- Logs incoming requests with method, URL, headers, and body (filtered for security)
+- Logs outgoing responses with status code, headers, body, and duration
+- Measures request duration automatically
 - Handles errors and logs them appropriately
+- Captures response bodies for logging
 
 ### Axios Trace Middleware
 
-For logging outgoing HTTP requests made with Axios:
+For comprehensive logging of outgoing HTTP requests made with Axios:
 
 ```typescript
 import { UnnboundLogger } from 'unnbound-logger';
@@ -199,20 +200,26 @@ import axios from 'axios';
 
 const logger = new UnnboundLogger();
 
-// Add Axios trace middleware
+// Add both request and response interceptors for complete HTTP logging
 axios.interceptors.request.use(
   logger.axiosTraceMiddleware.onFulfilled,
   logger.axiosTraceMiddleware.onRejected
 );
 
+axios.interceptors.response.use(
+  logger.axiosResponseInterceptor.onFulfilled,
+  logger.axiosResponseInterceptor.onRejected
+);
+
 // All requests made with axios will be automatically logged
 axios.get('https://api.example.com/data');
 ```
 
-The Axios trace middleware:
-- Logs outgoing requests with method, URL, headers, and body
-- Maintains trace context across requests
-- Handles errors and logs them appropriately
+The Axios middleware:
+- Logs outgoing requests with method, URL, headers, and body (filtered for security)
+- Maintains trace context across requests by propagating trace IDs
+- Logs successful responses with status, headers, body, and duration
+- Logs error responses with detailed error information
 - Supports request/response filtering through configuration
 
 ## Function Tracing with withTrace

package/dist/unnbound-logger.d.ts

@@ -1,6 +1,13 @@
 import { LogLevel, LoggerOptions, GeneralLogOptions, HttpRequestLogOptions, HttpResponseLogOptions, SftpTransactionLogOptions, DbQueryTransactionLogOptions } from './types';
 import { Request, Response, NextFunction } from 'express';
 import { InternalAxiosRequestConfig } from 'axios';
+declare module 'axios' {
+    interface InternalAxiosRequestConfig {
+        metadata?: {
+            startTime: number;
+        };
+    }
+}
 /**
  * UnnboundLogger provides typed, structured logging using Pino
  */
@@ -102,4 +109,8 @@ export declare class UnnboundLogger {
         onFulfilled: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
         onRejected: (error: any) => any;
     };
+    axiosResponseInterceptor: {
+        onFulfilled: (response: any) => any;
+        onRejected: (error: any) => any;
+    };
 }

package/dist/unnbound-logger.js

@@ -31,6 +31,18 @@ class UnnboundLogger {
             const traceId = req.header(this.traceHeaderKey) || (0, uuid_1.v4)();
             res.setHeader(this.traceHeaderKey, traceId);
             trace_context_1.traceContext.run(traceId, () => {
+                // Log the incoming request
+                const requestId = this.httpRequest(req, { traceId });
+                // Capture response body for logging
+                const originalSend = res.send;
+                res.send = function (body) {
+                    res.locals.body = body;
+                    return originalSend.call(this, body);
+                };
+                // Log the response when it finishes
+                res.on('finish', () => {
+                    this.httpResponse(res, req, { requestId, traceId });
+                });
                 next();
             });
         };
@@ -47,12 +59,71 @@ class UnnboundLogger {
                     headers.set(this.traceHeaderKey, traceId);
                     config.headers = headers;
                 }
+                // Store request start time for duration calculation
+                config.metadata = { startTime: Date.now() };
+                // Log the outgoing request
+                this.info(`HTTP Request: ${config.method?.toUpperCase()} ${config.baseURL || ''}${config.url}`, {
+                    type: 'httpRequest',
+                    httpRequest: {
+                        url: `${config.baseURL || ''}${config.url}`,
+                        method: config.method?.toUpperCase(),
+                        headers: (0, logger_utils_1.filterHeaders)(config.headers),
+                        body: config.data
+                    }
+                });
                 return config;
             },
             onRejected: (error) => {
                 return Promise.reject(error);
             }
         };
+        // Axios response interceptor (should be used separately)
+        this.axiosResponseInterceptor = {
+            onFulfilled: (response) => {
+                // Calculate duration
+                const startTime = response.config.metadata?.startTime || Date.now();
+                const duration = Date.now() - startTime;
+                // Log the successful response
+                this.info(`HTTP Response: ${response.config.method?.toUpperCase()} ${response.config.baseURL || ''}${response.config.url} - ${response.status}`, {
+                    type: 'httpResponse',
+                    duration,
+                    httpResponse: {
+                        url: `${response.config.baseURL || ''}${response.config.url}`,
+                        method: response.config.method?.toUpperCase(),
+                        status: response.status,
+                        headers: (0, logger_utils_1.filterHeaders)(response.headers),
+                        body: response.data
+                    }
+                });
+                return response;
+            },
+            onRejected: (error) => {
+                // Calculate duration for error responses
+                const startTime = error.config?.metadata?.startTime || Date.now();
+                const duration = Date.now() - startTime;
+                // Log the error response
+                if (error.response) {
+                    this.error(`HTTP Error Response: ${error.config?.method?.toUpperCase()} ${error.config?.baseURL || ''}${error.config?.url} - ${error.response.status}`, {
+                        type: 'httpResponse',
+                        duration,
+                        httpResponse: {
+                            url: `${error.config?.baseURL || ''}${error.config?.url}`,
+                            method: error.config?.method?.toUpperCase(),
+                            status: error.response.status,
+                            headers: (0, logger_utils_1.filterHeaders)(error.response.headers),
+                            body: error.response.data
+                        }
+                    });
+                }
+                else {
+                    this.error(`HTTP Request Failed: ${error.config?.method?.toUpperCase()} ${error.config?.baseURL || ''}${error.config?.url}`, {
+                        context: 'No response received',
+                        error: error.message
+                    });
+                }
+                return Promise.reject(error);
+            }
+        };
         this.defaultLevel = options.defaultLevel || 'info';
         this.serviceName = options.serviceName;
         this.environment = options.environment;

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "unnbound-logger-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A structured logging library with TypeScript support using Pino. Provides consistent, well-typed logging across different operational contexts with automatic trace ID propagation.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch",
+    "test": "npx jest",
+    "test:coverage": "npx jest --coverage",
+    "test:watch": "npx jest --watch",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint . --ext .ts --fix",
     "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
@@ -40,8 +40,8 @@
     "url": "https://github.com/unnbound/logger/issues"
   },
   "dependencies": {
-    "axios": "^1.9.0",
-    "express": "^5.1.0",
+    "axios": "^1.0.0",
+    "express": "^4.0.0 || ^5.0.0",
     "pino": "^8.17.2",
     "uuid": "^11.1.0"
   },
@@ -64,8 +64,8 @@
     "typescript": "^5.3.3"
   },
   "peerDependencies": {
-    "express": "^4.0.0 || ^5.0.0",
-    "axios": "^1.0.0"
+    "axios": "^1.0.0",
+    "express": "^4.0.0 || ^5.0.0"
   },
   "peerDependenciesMeta": {
     "express": {

package/dist/src/index.d.ts

@@ -1,38 +0,0 @@
-/**
- * unnbound-logger
- *
- * A structured logging library built on Pino with TypeScript support.
- * Provides consistent, well-typed logging across different operational contexts.
- */
-import { UnnboundLogger } from './unnbound-logger';
-import { LogLevel, LogType, HttpMethod, LoggerOptions, GeneralLogOptions, HttpRequestLogOptions, HttpResponseLogOptions, SftpTransactionLogOptions, DbQueryTransactionLogOptions, Log, LogTransaction, HttpRequestLog, HttpResponseLog, SftpTransactionLog, DbQueryTransactionLog, SerializableError } from './types';
-import { generateUuid, clearTraceId } from './utils/id-generator';
-export { UnnboundLogger, LogLevel, LogType, HttpMethod, LoggerOptions, GeneralLogOptions, HttpRequestLogOptions, HttpResponseLogOptions, SftpTransactionLogOptions, DbQueryTransactionLogOptions, Log, LogTransaction, HttpRequestLog, HttpResponseLog, SftpTransactionLog, DbQueryTransactionLog, SerializableError, generateUuid, clearTraceId, };
-declare const defaultLogger: UnnboundLogger;
-export { defaultLogger };
-export declare const log: (level: LogLevel, message: string | Error | Record<string, unknown>, options?: GeneralLogOptions) => void;
-export declare const error: (message: string | Error | Record<string, unknown>, options?: GeneralLogOptions) => void;
-export declare const warn: (message: string | Error | Record<string, unknown>, options?: GeneralLogOptions) => void;
-export declare const info: (message: string | Error | Record<string, unknown>, options?: GeneralLogOptions) => void;
-export declare const debug: (message: string | Error | Record<string, unknown>, options?: GeneralLogOptions) => void;
-export declare const httpRequest: (req: import("express").Request, options?: HttpRequestLogOptions) => string;
-export declare const httpResponse: (res: import("express").Response, req: import("express").Request, options?: HttpResponseLogOptions) => void;
-export declare const sftpTransaction: (operation: {
-    host: string;
-    username: string;
-    operation: "upload" | "download" | "list" | "delete" | "rename" | "stat";
-    path: string;
-    status: "success" | "failure";
-    bytesTransferred?: number;
-    filesListed?: number;
-    sourcePath?: string;
-}, options?: SftpTransactionLogOptions) => void;
-export declare const dbQueryTransaction: (query: {
-    instance: string;
-    vendor: "postgres" | "mysql" | "mssql" | "mongodb";
-    query?: string;
-    status: "success" | "failure";
-    rowsReturned?: number;
-    rowsAffected?: number;
-}, options?: DbQueryTransactionLogOptions) => void;
-export default UnnboundLogger;

package/dist/src/index.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dbQueryTransaction = exports.sftpTransaction = exports.httpResponse = exports.httpRequest = exports.debug = exports.info = exports.warn = exports.error = exports.log = exports.defaultLogger = exports.clearTraceId = exports.generateUuid = exports.UnnboundLogger = void 0;
-/**
- * unnbound-logger
- *
- * A structured logging library built on Pino with TypeScript support.
- * Provides consistent, well-typed logging across different operational contexts.
- */
-const unnbound_logger_1 = require("./unnbound-logger");
-Object.defineProperty(exports, "UnnboundLogger", { enumerable: true, get: function () { return unnbound_logger_1.UnnboundLogger; } });
-const id_generator_1 = require("./utils/id-generator");
-Object.defineProperty(exports, "generateUuid", { enumerable: true, get: function () { return id_generator_1.generateUuid; } });
-Object.defineProperty(exports, "clearTraceId", { enumerable: true, get: function () { return id_generator_1.clearTraceId; } });
-// Create a default logger instance
-const defaultLogger = new unnbound_logger_1.UnnboundLogger();
-exports.defaultLogger = defaultLogger;
-// Export default logger functions for convenience
-exports.log = defaultLogger.log.bind(defaultLogger);
-exports.error = defaultLogger.error.bind(defaultLogger);
-exports.warn = defaultLogger.warn.bind(defaultLogger);
-exports.info = defaultLogger.info.bind(defaultLogger);
-exports.debug = defaultLogger.debug.bind(defaultLogger);
-exports.httpRequest = defaultLogger.httpRequest.bind(defaultLogger);
-exports.httpResponse = defaultLogger.httpResponse.bind(defaultLogger);
-exports.sftpTransaction = defaultLogger.sftpTransaction.bind(defaultLogger);
-exports.dbQueryTransaction = defaultLogger.dbQueryTransaction.bind(defaultLogger);
-// Default export is the UnnboundLogger class
-exports.default = unnbound_logger_1.UnnboundLogger;

package/dist/src/types.d.ts

@@ -1,134 +0,0 @@
-/**
- * Type definitions for structured logging library
- */
-/**
- * Available log levels
- */
-export type LogLevel = "info" | "debug" | "error" | "warn";
-/**
- * Available log types
- */
-export type LogType = "general" | "httpRequest" | "httpResponse" | "sftpTransaction" | "dbQueryTransaction";
-/**
- * HTTP methods supported for HTTP logging
- */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD';
-export interface SerializableError {
-    name: string;
-    message: string;
-    stack?: string;
-}
-export interface Log<T extends LogType = 'general'> {
-    level: LogLevel;
-    type: T;
-    message: string;
-    traceId: string;
-    requestId: string;
-    error?: SerializableError;
-}
-export interface LogTransaction<T extends LogType> extends Log<T> {
-    duration: number;
-}
-export interface HttpRequestLog extends LogTransaction<'httpRequest'> {
-    httpRequest: {
-        url: string;
-        method: string;
-        headers: Record<string, string>;
-        ip?: string;
-        body?: unknown;
-    };
-}
-export interface HttpResponseLog extends LogTransaction<'httpResponse'> {
-    httpResponse: {
-        url: string;
-        method: string;
-        headers: Record<string, string>;
-        ip?: string;
-        status: number;
-        body?: unknown;
-    };
-}
-export interface SftpTransactionLog extends LogTransaction<'sftpTransaction'> {
-    sftp: {
-        host: string;
-        username: string;
-        operation: 'upload' | 'download' | 'list' | 'delete' | 'rename' | 'stat';
-        path: string;
-        status: 'success' | 'failure';
-        bytesTransferred?: number;
-        filesListed?: number;
-        sourcePath?: string;
-    };
-}
-export interface DbQueryTransactionLog extends LogTransaction<'dbQueryTransaction'> {
-    db: {
-        instance: string;
-        vendor: 'postgres' | 'mysql' | 'mssql' | 'mongodb';
-        query?: string;
-        status: 'success' | 'failure';
-        rowsReturned?: number;
-        rowsAffected?: number;
-    };
-}
-/**
- * Configuration options for the logger
- */
-export interface LoggerOptions {
-    /** Default log level */
-    defaultLevel?: LogLevel;
-    /** Optional service name to include in logs */
-    serviceName?: string;
-    /** Optional environment name to include in logs */
-    environment?: string;
-    /** Optional trace header key */
-    traceHeaderKey?: string;
-    /** Routes to ignore in trace middleware (supports glob patterns) */
-    ignoreTraceRoutes?: string[];
-    /** Routes to ignore in axios trace middleware (supports glob patterns) */
-    ignoreAxiosTraceRoutes?: string[];
-}
-/**
- * Options for general logs
- */
-export interface GeneralLogOptions {
-    /** Log level override */
-    level?: LogLevel;
-    /** Custom trace ID */
-    traceId?: string;
-    /** Custom request ID */
-    requestId?: string;
-    /** Custom metadata */
-    [key: string]: unknown;
-}
-/**
- * Options for HTTP request logs
- */
-export interface HttpRequestLogOptions extends GeneralLogOptions {
-    /** Start time of the request for duration calculation */
-    startTime?: number;
-}
-/**
- * Options for HTTP response logs
- */
-export interface HttpResponseLogOptions extends HttpRequestLogOptions {
-    /** Duration of the request in milliseconds */
-    duration?: number;
-}
-/**
- * Options for SFTP transaction logs
- */
-export interface SftpTransactionLogOptions extends GeneralLogOptions {
-    /** Start time of the transaction for duration calculation */
-    startTime?: number;
-    /** Duration of the transaction in milliseconds */
-    duration?: number;
-}
-/**
- * Options for database query transaction logs
- */
-export interface DbQueryTransactionLogOptions extends GeneralLogOptions {
-    /** Start time of the query for duration calculation */
-    startTime?: number;
-    /** Duration of the query in milliseconds */
-    duration?: number;
-}

package/dist/src/types.js

@@ -1,5 +0,0 @@
-"use strict";
-/**
- * Type definitions for structured logging library
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/unnbound-logger.d.ts

@@ -1,105 +0,0 @@
-import { LogLevel, LoggerOptions, GeneralLogOptions, HttpRequestLogOptions, HttpResponseLogOptions, SftpTransactionLogOptions, DbQueryTransactionLogOptions } from './types';
-import { Request, Response, NextFunction } from 'express';
-import { InternalAxiosRequestConfig } from 'axios';
-/**
- * UnnboundLogger provides typed, structured logging using Pino
- */
-export declare class UnnboundLogger {
-    private logger;
-    private defaultLevel;
-    private serviceName?;
-    private environment?;
-    private traceHeaderKey;
-    private ignoreTraceRoutes;
-    private ignoreAxiosTraceRoutes;
-    /**
-     * Creates a new UnnboundLogger instance
-     * @param options - Configuration options for the logger
-     */
-    constructor(options?: LoggerOptions);
-    /**
-     * Checks if a path matches any of the ignore patterns
-     * @param path - The path to check
-     * @param patterns - Array of glob patterns to match against
-     * @returns boolean indicating if the path should be ignored
-     */
-    private shouldIgnorePath;
-    /**
-     * Logs a general message
-     * @param level - Log level
-     * @param message - Log message
-     * @param options - Additional logging options
-     */
-    log(level: LogLevel, message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): void;
-    /**
-     * Logs an error message
-     * @param message - Error message or object
-     * @param options - Additional logging options
-     */
-    error(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): void;
-    /**
-     * Logs a warning message
-     * @param message - Warning message
-     * @param options - Additional logging options
-     */
-    warn(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): void;
-    /**
-     * Logs an info message
-     * @param message - Info message
-     * @param options - Additional logging options
-     */
-    info(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): void;
-    /**
-     * Logs a debug message
-     * @param message - Debug message
-     * @param options - Additional logging options
-     */
-    debug(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): void;
-    /**
-     * Logs an HTTP request
-     * @param req - Express request object
-     * @param options - Additional logging options
-     * @returns The request ID for correlating with the response
-     */
-    httpRequest(req: Request, options?: HttpRequestLogOptions): string;
-    /**
-     * Logs an HTTP response
-     * @param res - Express response object
-     * @param req - Express request object
-     * @param options - Additional logging options
-     */
-    httpResponse(res: Response, req: Request, options?: HttpResponseLogOptions): void;
-    /**
-     * Logs an SFTP transaction
-     * @param operation - SFTP operation details
-     * @param options - Additional logging options
-     */
-    sftpTransaction(operation: {
-        host: string;
-        username: string;
-        operation: 'upload' | 'download' | 'list' | 'delete' | 'rename' | 'stat';
-        path: string;
-        status: 'success' | 'failure';
-        bytesTransferred?: number;
-        filesListed?: number;
-        sourcePath?: string;
-    }, options?: SftpTransactionLogOptions): void;
-    /**
-     * Logs a database query transaction
-     * @param query - Database query details
-     * @param options - Additional logging options
-     */
-    dbQueryTransaction(query: {
-        instance: string;
-        vendor: 'postgres' | 'mysql' | 'mssql' | 'mongodb';
-        query?: string;
-        status: 'success' | 'failure';
-        rowsReturned?: number;
-        rowsAffected?: number;
-    }, options?: DbQueryTransactionLogOptions): void;
-    traceMiddleware: (req: Request, res: Response, next: NextFunction) => void;
-    axiosTraceMiddleware: {
-        onFulfilled: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
-        onRejected: (error: any) => any;
-    };
-}

package/dist/src/unnbound-logger.js

@@ -1,292 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnnboundLogger = void 0;
-/**
- * Core logger implementation
- */
-const pino_1 = __importDefault(require("pino"));
-const id_generator_1 = require("./utils/id-generator");
-const logger_utils_1 = require("./utils/logger-utils");
-const uuid_1 = require("uuid");
-const trace_context_1 = require("./utils/trace-context");
-const axios_1 = require("axios");
-/**
- * UnnboundLogger provides typed, structured logging using Pino
- */
-class UnnboundLogger {
-    /**
-     * Creates a new UnnboundLogger instance
-     * @param options - Configuration options for the logger
-     */
-    constructor(options = {}) {
-        // Trace middleware
-        this.traceMiddleware = (req, res, next) => {
-            // Check if the route should be ignored
-            if (this.shouldIgnorePath(req.path, this.ignoreTraceRoutes)) {
-                return next();
-            }
-            const traceId = req.header(this.traceHeaderKey) || (0, uuid_1.v4)();
-            res.setHeader(this.traceHeaderKey, traceId);
-            trace_context_1.traceContext.run(traceId, () => {
-                next();
-            });
-        };
-        // Axios trace middleware
-        this.axiosTraceMiddleware = {
-            onFulfilled: (config) => {
-                // Check if the URL should be ignored
-                if (config.url && this.shouldIgnorePath(config.url, this.ignoreAxiosTraceRoutes)) {
-                    return config;
-                }
-                const traceId = trace_context_1.traceContext.getTraceId();
-                if (traceId) {
-                    const headers = new axios_1.AxiosHeaders(config.headers);
-                    headers.set(this.traceHeaderKey, traceId);
-                    config.headers = headers;
-                }
-                return config;
-            },
-            onRejected: (error) => {
-                return Promise.reject(error);
-            }
-        };
-        this.defaultLevel = options.defaultLevel || 'info';
-        this.serviceName = options.serviceName;
-        this.environment = options.environment;
-        this.traceHeaderKey = options.traceHeaderKey || 'unnbound-trace-id';
-        this.ignoreTraceRoutes = options.ignoreTraceRoutes || [];
-        this.ignoreAxiosTraceRoutes = options.ignoreAxiosTraceRoutes || [];
-        // Create Pino logger
-        this.logger = (0, pino_1.default)({
-            level: this.defaultLevel,
-            base: {
-                ...(this.serviceName && { service: this.serviceName }),
-                ...(this.environment && { environment: this.environment }),
-            },
-            formatters: {
-                level: (label) => {
-                    return { level: label };
-                },
-            },
-            timestamp: () => `,"timestamp":"${new Date().toISOString()}"`,
-        });
-    }
-    /**
-     * Checks if a path matches any of the ignore patterns
-     * @param path - The path to check
-     * @param patterns - Array of glob patterns to match against
-     * @returns boolean indicating if the path should be ignored
-     */
-    shouldIgnorePath(path, patterns) {
-        return patterns.some(pattern => {
-            // Convert glob pattern to regex
-            const regexPattern = pattern
-                .replace(/\./g, '\\.') // Escape dots
-                .replace(/\*/g, '.*') // Convert * to .*
-                .replace(/\?/g, '.'); // Convert ? to .
-            const regex = new RegExp(`^${regexPattern}$`);
-            return regex.test(path);
-        });
-    }
-    /**
-     * Logs a general message
-     * @param level - Log level
-     * @param message - Log message
-     * @param options - Additional logging options
-     */
-    log(level, message, options = {}) {
-        const traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, id_generator_1.generateUuid)();
-        const requestId = options.requestId || (0, id_generator_1.generateUuid)();
-        let logEntry;
-        let error;
-        if (message instanceof Error) {
-            error = {
-                name: message.name,
-                message: message.message,
-                stack: message.stack,
-            };
-            logEntry = {
-                level,
-                type: 'general',
-                message: message.message,
-                traceId,
-                requestId,
-                error,
-            };
-        }
-        else if (typeof message === 'string') {
-            logEntry = {
-                level,
-                type: 'general',
-                message,
-                traceId,
-                requestId,
-            };
-        }
-        else {
-            // If message is an object, stringify it
-            logEntry = {
-                level,
-                type: 'general',
-                message: JSON.stringify(message),
-                traceId,
-                requestId,
-            };
-        }
-        this.logger[level](logEntry);
-    }
-    /**
-     * Logs an error message
-     * @param message - Error message or object
-     * @param options - Additional logging options
-     */
-    error(message, options = {}) {
-        this.log('error', message, options);
-    }
-    /**
-     * Logs a warning message
-     * @param message - Warning message
-     * @param options - Additional logging options
-     */
-    warn(message, options = {}) {
-        this.log('warn', message, options);
-    }
-    /**
-     * Logs an info message
-     * @param message - Info message
-     * @param options - Additional logging options
-     */
-    info(message, options = {}) {
-        this.log('info', message, options);
-    }
-    /**
-     * Logs a debug message
-     * @param message - Debug message
-     * @param options - Additional logging options
-     */
-    debug(message, options = {}) {
-        this.log('debug', message, options);
-    }
-    /**
-     * Logs an HTTP request
-     * @param req - Express request object
-     * @param options - Additional logging options
-     * @returns The request ID for correlating with the response
-     */
-    httpRequest(req, options = {}) {
-        const traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, id_generator_1.generateUuid)();
-        const requestId = options.requestId || (0, id_generator_1.generateUuid)();
-        const startTime = options.startTime || Date.now();
-        // Store request metadata in res.locals for later use
-        if (req.res) {
-            req.res.locals.requestId = requestId;
-            req.res.locals.startTime = startTime;
-            req.res.locals.traceId = traceId;
-        }
-        const logEntry = {
-            level: options.level || this.defaultLevel,
-            type: 'httpRequest',
-            message: `${req.method} ${req.originalUrl || req.url}`,
-            traceId,
-            requestId,
-            duration: 0, // Will be updated in response
-            httpRequest: {
-                url: req.originalUrl || req.url,
-                method: req.method,
-                headers: (0, logger_utils_1.filterHeaders)(req.headers),
-                ip: req.ip,
-                body: req.body,
-            },
-        };
-        this.logger[options.level || this.defaultLevel](logEntry);
-        return requestId;
-    }
-    /**
-     * Logs an HTTP response
-     * @param res - Express response object
-     * @param req - Express request object
-     * @param options - Additional logging options
-     */
-    httpResponse(res, req, options = {}) {
-        const requestId = res.locals.requestId || options.requestId || (0, id_generator_1.generateUuid)();
-        const startTime = res.locals.startTime || options.startTime || Date.now();
-        const traceId = res.locals.traceId || options.traceId || trace_context_1.traceContext.getTraceId() || (0, id_generator_1.generateUuid)();
-        const duration = options.duration || (Date.now() - startTime);
-        // Determine log level based on status code
-        let level = options.level || this.defaultLevel;
-        if (!options.level) {
-            if (res.statusCode >= 500) {
-                level = 'error';
-            }
-            else if (res.statusCode >= 400) {
-                level = 'warn';
-            }
-            else {
-                level = 'info';
-            }
-        }
-        const logEntry = {
-            level,
-            type: 'httpResponse',
-            message: `${req.method} ${req.originalUrl || req.url} - ${res.statusCode}`,
-            traceId,
-            requestId,
-            duration,
-            httpResponse: {
-                url: req.originalUrl || req.url,
-                method: req.method,
-                headers: (0, logger_utils_1.filterHeaders)(res.getHeaders()),
-                ip: req.ip,
-                status: res.statusCode,
-                body: res.locals.body,
-            },
-        };
-        this.logger[level](logEntry);
-    }
-    /**
-     * Logs an SFTP transaction
-     * @param operation - SFTP operation details
-     * @param options - Additional logging options
-     */
-    sftpTransaction(operation, options = {}) {
-        const traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, id_generator_1.generateUuid)();
-        const requestId = options.requestId || (0, id_generator_1.generateUuid)();
-        const duration = options.duration || (options.startTime ? Date.now() - options.startTime : 0);
-        const level = operation.status === 'success' ? 'info' : 'error';
-        const logEntry = {
-            level,
-            type: 'sftpTransaction',
-            message: `SFTP ${operation.operation} ${operation.status} - ${operation.path}`,
-            traceId,
-            requestId,
-            duration,
-            sftp: operation,
-        };
-        this.logger[level](logEntry);
-    }
-    /**
-     * Logs a database query transaction
-     * @param query - Database query details
-     * @param options - Additional logging options
-     */
-    dbQueryTransaction(query, options = {}) {
-        const traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, id_generator_1.generateUuid)();
-        const requestId = options.requestId || (0, id_generator_1.generateUuid)();
-        const duration = options.duration || (options.startTime ? Date.now() - options.startTime : 0);
-        const level = query.status === 'success' ? 'info' : 'error';
-        const logEntry = {
-            level,
-            type: 'dbQueryTransaction',
-            message: `DB Query ${query.status} - ${query.vendor}`,
-            traceId,
-            requestId,
-            duration,
-            db: query,
-        };
-        this.logger[level](logEntry);
-    }
-}
-exports.UnnboundLogger = UnnboundLogger;

package/dist/src/utils/id-generator.d.ts

@@ -1,21 +0,0 @@
-/**
- * Generates a new UUID v4
- * @returns A UUID v4 string
- */
-export declare function generateUuid(): string;
-/**
- * Generates the current timestamp in ISO format
- * @returns ISO timestamp string
- */
-export declare function generateTimestamp(): string;
-/**
- * Gets or creates a trace ID for a workflow
- * @param workflowId - The workflow ID to get a trace ID for
- * @returns A trace ID associated with the workflow
- */
-export declare function getTraceId(workflowId: string): string;
-/**
- * Clears a trace ID from the map
- * @param workflowId - The workflow ID to clear
- */
-export declare function clearTraceId(workflowId: string): void;

package/dist/src/utils/id-generator.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateUuid = generateUuid;
-exports.generateTimestamp = generateTimestamp;
-exports.getTraceId = getTraceId;
-exports.clearTraceId = clearTraceId;
-/**
- * Utilities for generating unique identifiers
- */
-const uuid_1 = require("uuid");
-/**
- * Generates a new UUID v4
- * @returns A UUID v4 string
- */
-function generateUuid() {
-    return (0, uuid_1.v4)();
-}
-/**
- * Generates the current timestamp in ISO format
- * @returns ISO timestamp string
- */
-function generateTimestamp() {
-    return new Date().toISOString();
-}
-/**
- * Stores trace IDs by workflow ID for consistent tracking
- */
-const traceIdMap = new Map();
-/**
- * Gets or creates a trace ID for a workflow
- * @param workflowId - The workflow ID to get a trace ID for
- * @returns A trace ID associated with the workflow
- */
-function getTraceId(workflowId) {
-    if (!traceIdMap.has(workflowId)) {
-        traceIdMap.set(workflowId, generateUuid());
-    }
-    return traceIdMap.get(workflowId);
-}
-/**
- * Clears a trace ID from the map
- * @param workflowId - The workflow ID to clear
- */
-function clearTraceId(workflowId) {
-    traceIdMap.delete(workflowId);
-}

package/dist/src/utils/logger-utils.d.ts

@@ -1,21 +0,0 @@
-/**
- * Utility functions for logging
- */
-/**
- * Filters an object of headers, returning a new object with only the allowed headers.
- * @param headers The original headers object.
- * @returns A new object containing only the headers from the allow-list.
- */
-export declare function filterHeaders(headers: Record<string, any>): Record<string, string>;
-/**
- * Safely parses JSON strings, returning the original data if parsing fails or if it's not a string.
- * @param data The data to potentially parse as JSON.
- * @returns Parsed JSON object or the original data.
- */
-export declare function safeJsonParse(data: any): any;
-/**
- * Normalizes IP addresses by removing IPv6 mapping prefix for IPv4 addresses.
- * @param ip The IP address to normalize.
- * @returns Normalized IP address string.
- */
-export declare function normalizeIp(ip: string | undefined): string | undefined;

package/dist/src/utils/logger-utils.js

@@ -1,63 +0,0 @@
-"use strict";
-/**
- * Utility functions for logging
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterHeaders = filterHeaders;
-exports.safeJsonParse = safeJsonParse;
-exports.normalizeIp = normalizeIp;
-// --- Header Allow-Listing ---
-const ALLOWED_HEADERS = new Set([
-    'content-type',
-    'accept',
-    'user-agent',
-    'host',
-    'x-forwarded-for',
-    'x-request-id',
-    'content-length',
-    'cache-control',
-]);
-/**
- * Filters an object of headers, returning a new object with only the allowed headers.
- * @param headers The original headers object.
- * @returns A new object containing only the headers from the allow-list.
- */
-function filterHeaders(headers) {
-    const filtered = {};
-    for (const key in headers) {
-        if (ALLOWED_HEADERS.has(key.toLowerCase())) {
-            filtered[key] = String(headers[key]);
-        }
-    }
-    return filtered;
-}
-/**
- * Safely parses JSON strings, returning the original data if parsing fails or if it's not a string.
- * @param data The data to potentially parse as JSON.
- * @returns Parsed JSON object or the original data.
- */
-function safeJsonParse(data) {
-    if (typeof data === 'string') {
-        try {
-            return JSON.parse(data);
-        }
-        catch {
-            return data;
-        }
-    }
-    return data;
-}
-/**
- * Normalizes IP addresses by removing IPv6 mapping prefix for IPv4 addresses.
- * @param ip The IP address to normalize.
- * @returns Normalized IP address string.
- */
-function normalizeIp(ip) {
-    if (!ip)
-        return ip;
-    // Remove IPv4-mapped IPv6 prefix (::ffff:) to get clean IPv4 address
-    if (ip.startsWith('::ffff:')) {
-        return ip.substring(7);
-    }
-    return ip;
-}

package/dist/src/utils/trace-context.d.ts

@@ -1,10 +0,0 @@
-declare class TraceContextManager {
-    private static instance;
-    private storage;
-    private constructor();
-    static getInstance(): TraceContextManager;
-    run<T>(traceId: string, callback: () => T): T;
-    getTraceId(): string | undefined;
-}
-export declare const traceContext: TraceContextManager;
-export {};

package/dist/src/utils/trace-context.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.traceContext = void 0;
-const async_hooks_1 = require("async_hooks");
-class TraceContextManager {
-    constructor() {
-        this.storage = new async_hooks_1.AsyncLocalStorage();
-    }
-    static getInstance() {
-        if (!TraceContextManager.instance) {
-            TraceContextManager.instance = new TraceContextManager();
-        }
-        return TraceContextManager.instance;
-    }
-    run(traceId, callback) {
-        return this.storage.run({ traceId }, callback);
-    }
-    getTraceId() {
-        const context = this.storage.getStore();
-        return context?.traceId;
-    }
-}
-exports.traceContext = TraceContextManager.getInstance();

package/dist/src/utils/with-trace.d.ts

@@ -1,7 +0,0 @@
-/**
- * Higher-order function that wraps a function with trace context
- * @param fn - Function to wrap with trace context
- * @param traceId - Optional trace ID to use (will generate new one if not provided)
- * @returns Wrapped function that maintains trace context
- */
-export declare function withTrace<T extends (...args: any[]) => any>(fn: T, traceId?: string): T;

package/dist/src/utils/with-trace.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTrace = withTrace;
-const uuid_1 = require("uuid");
-const trace_context_1 = require("./trace-context");
-/**
- * Higher-order function that wraps a function with trace context
- * @param fn - Function to wrap with trace context
- * @param traceId - Optional trace ID to use (will generate new one if not provided)
- * @returns Wrapped function that maintains trace context
- */
-function withTrace(fn, traceId) {
-    const id = traceId || (0, uuid_1.v4)();
-    return ((...args) => {
-        return trace_context_1.traceContext.run(id, () => fn(...args));
-    });
-}