unnbound-logger-sdk 1.1.3 → 2.0.0

package/README.md

@@ -53,6 +53,7 @@ interface Log<T extends LogType = 'general'> {
   message: string;
   traceId: string;
   requestId: string;
+  deploymentId: string; // Automatically populated from DEPLOYMENT_ID environment variable
   error?: SerializableError; // Only present for Error objects
 }
 
@@ -61,6 +62,25 @@ interface LogTransaction<T extends LogType> extends Log<T> {
 }
 ```
 
+## Deployment Tracking
+
+The logger automatically includes a `deploymentId` field in all log entries. This field is populated from the `DEPLOYMENT_ID` environment variable, allowing you to track logs across different deployments of your application.
+
+```bash
+# Set the deployment ID in your environment
+export DEPLOYMENT_ID="v1.2.3-prod-20231201"
+
+# Or in your deployment configuration
+DEPLOYMENT_ID=v1.2.3-prod-20231201
+```
+
+If the `DEPLOYMENT_ID` environment variable is not set, the `deploymentId` field will be an empty string. This field helps with:
+
+- Tracking logs across different application deployments
+- Correlating issues with specific releases
+- Monitoring deployment health and performance
+- Debugging problems in specific deployment versions
+
 ## HTTP Request/Response Logging
 
 ```typescript

package/dist/index.d.ts

@@ -6,8 +6,8 @@
  */
 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, };
+import { clearTraceId } from './utils/logger-utils';
+export { UnnboundLogger, LogLevel, LogType, HttpMethod, LoggerOptions, GeneralLogOptions, HttpRequestLogOptions, HttpResponseLogOptions, SftpTransactionLogOptions, DbQueryTransactionLogOptions, Log, LogTransaction, HttpRequestLog, HttpResponseLog, SftpTransactionLog, DbQueryTransactionLog, SerializableError, clearTraceId, };
 declare const defaultLogger: UnnboundLogger;
 export { defaultLogger };
 export declare const log: (level: LogLevel, message: string | Error | Record<string, unknown>, options?: GeneralLogOptions) => void;

package/dist/index.js

@@ -1,6 +1,6 @@
 "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;
+exports.dbQueryTransaction = exports.sftpTransaction = exports.httpResponse = exports.httpRequest = exports.debug = exports.info = exports.warn = exports.error = exports.log = exports.defaultLogger = exports.clearTraceId = exports.UnnboundLogger = void 0;
 /**
  * unnbound-logger
  *
@@ -9,9 +9,8 @@ exports.dbQueryTransaction = exports.sftpTransaction = exports.httpResponse = ex
  */
 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; } });
+const logger_utils_1 = require("./utils/logger-utils");
+Object.defineProperty(exports, "clearTraceId", { enumerable: true, get: function () { return logger_utils_1.clearTraceId; } });
 // Create a default logger instance
 const defaultLogger = new unnbound_logger_1.UnnboundLogger();
 exports.defaultLogger = defaultLogger;

package/dist/types.d.ts

@@ -22,6 +22,7 @@ export interface Log<T extends LogType = 'general'> {
     level: LogLevel;
     type: T;
     message: string;
+    deploymentId: string;
     traceId: string;
     requestId: string;
     error?: SerializableError;

package/dist/unnbound-logger.d.ts

@@ -5,6 +5,7 @@ declare module 'axios' {
     interface InternalAxiosRequestConfig {
         metadata?: {
             startTime: number;
+            requestId?: string;
         };
     }
 }
@@ -16,6 +17,7 @@ export declare class UnnboundLogger {
     private defaultLevel;
     private serviceName?;
     private environment?;
+    private deploymentId;
     private traceHeaderKey;
     private ignoreTraceRoutes;
     private ignoreAxiosTraceRoutes;
@@ -62,6 +64,12 @@ export declare class UnnboundLogger {
      * @param options - Additional logging options
      */
     debug(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): void;
+    /**
+     * Constructs the full URL from request information
+     * @param req - Express request object
+     * @returns Full URL string
+     */
+    private constructFullUrl;
     /**
      * Logs an HTTP request
      * @param req - Express request object

package/dist/unnbound-logger.js

@@ -8,11 +8,11 @@ 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");
+const http_status_messages_1 = require("./utils/http-status-messages");
 /**
  * UnnboundLogger provides typed, structured logging using Pino
  */
@@ -59,17 +59,26 @@ 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
-                    }
+                // Store request start time and generate requestId for duration calculation and correlation
+                const startTime = Date.now();
+                const requestId = (0, uuid_1.v4)();
+                config.metadata = { startTime, requestId };
+                // Log the outgoing request using proper httpRequest method
+                const mockReq = {
+                    method: config.method?.toUpperCase() || 'UNKNOWN',
+                    url: `${config.baseURL || ''}${config.url}`,
+                    originalUrl: `${config.baseURL || ''}${config.url}`,
+                    headers: config.headers || {},
+                    body: config.data,
+                    ip: 'outgoing', // Mark as outgoing request
+                    protocol: 'https', // Default for outgoing
+                    secure: true,
+                    get: () => undefined // Mock get method for constructFullUrl
+                };
+                this.httpRequest(mockReq, {
+                    traceId,
+                    requestId,
+                    startTime
                 });
                 return config;
             },
@@ -82,43 +91,78 @@ class UnnboundLogger {
             onFulfilled: (response) => {
                 // Calculate duration
                 const startTime = response.config.metadata?.startTime || Date.now();
+                const requestId = response.config.metadata?.requestId;
                 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',
+                // Log the successful response using proper httpResponse method
+                const mockReq = {
+                    method: response.config.method?.toUpperCase() || 'UNKNOWN',
+                    url: `${response.config.baseURL || ''}${response.config.url}`,
+                    originalUrl: `${response.config.baseURL || ''}${response.config.url}`,
+                    ip: 'outgoing', // Mark as outgoing request
+                    protocol: 'https', // Default for outgoing
+                    secure: true,
+                    get: () => undefined // Mock get method for constructFullUrl
+                };
+                const mockRes = {
+                    statusCode: response.status,
+                    locals: {
+                        body: response.data,
+                        startTime: startTime,
+                        traceId: trace_context_1.traceContext.getTraceId(),
+                        requestId: requestId
+                    },
+                    getHeaders: () => response.headers || {}
+                };
+                this.httpResponse(mockRes, mockReq, {
+                    requestId,
                     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
-                    }
+                    traceId: trace_context_1.traceContext.getTraceId()
                 });
                 return response;
             },
             onRejected: (error) => {
                 // Calculate duration for error responses
                 const startTime = error.config?.metadata?.startTime || Date.now();
+                const requestId = error.config?.metadata?.requestId;
                 const duration = Date.now() - startTime;
-                // Log the error response
+                // Log the error response using proper httpResponse method
                 if (error.response) {
-                    this.error(`HTTP Error Response: ${error.config?.method?.toUpperCase()} ${error.config?.baseURL || ''}${error.config?.url} - ${error.response.status}`, {
-                        type: 'httpResponse',
+                    const mockReq = {
+                        method: error.config?.method?.toUpperCase() || 'UNKNOWN',
+                        url: `${error.config?.baseURL || ''}${error.config?.url}`,
+                        originalUrl: `${error.config?.baseURL || ''}${error.config?.url}`,
+                        ip: 'outgoing', // Mark as outgoing request
+                        protocol: 'https', // Default for outgoing
+                        secure: true,
+                        get: () => undefined // Mock get method for constructFullUrl
+                    };
+                    const mockRes = {
+                        statusCode: error.response.status,
+                        locals: {
+                            body: error.response.data,
+                            startTime: startTime,
+                            traceId: trace_context_1.traceContext.getTraceId(),
+                            requestId: requestId
+                        },
+                        getHeaders: () => error.response.headers || {}
+                    };
+                    this.httpResponse(mockRes, mockReq, {
+                        requestId,
                         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
-                        }
+                        traceId: trace_context_1.traceContext.getTraceId()
                     });
                 }
                 else {
-                    this.error(`HTTP Request Failed: ${error.config?.method?.toUpperCase()} ${error.config?.baseURL || ''}${error.config?.url}`, {
-                        context: 'No response received',
-                        error: error.message
+                    // For network errors without response, log as general error
+                    this.error('HTTP Request Failed', {
+                        context: {
+                            reason: 'No response received',
+                            method: error.config?.method?.toUpperCase() || 'UNKNOWN',
+                            url: `${error.config?.baseURL || ''}${error.config?.url}`,
+                        },
+                        error: error.message,
+                        requestId,
+                        traceId: trace_context_1.traceContext.getTraceId()
                     });
                 }
                 return Promise.reject(error);
@@ -127,6 +171,7 @@ class UnnboundLogger {
         this.defaultLevel = options.defaultLevel || 'info';
         this.serviceName = options.serviceName;
         this.environment = options.environment;
+        this.deploymentId = process.env.DEPLOYMENT_ID || '';
         this.traceHeaderKey = options.traceHeaderKey || 'unnbound-trace-id';
         this.ignoreTraceRoutes = options.ignoreTraceRoutes || [];
         this.ignoreAxiosTraceRoutes = options.ignoreAxiosTraceRoutes || [];
@@ -169,39 +214,46 @@ class UnnboundLogger {
      * @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)();
+        const traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, uuid_1.v4)();
+        const requestId = options.requestId || (0, uuid_1.v4)();
         let logEntry;
-        let error;
+        const { traceId: optionTraceId, requestId: optionRequestId, ...restOptions } = options;
         if (message instanceof Error) {
-            error = {
+            const error = {
                 name: message.name,
                 message: message.message,
                 stack: message.stack,
             };
             logEntry = {
                 type: 'general',
-                message: message.message,
                 traceId,
                 requestId,
+                deploymentId: this.deploymentId,
+                message: message.name,
                 error,
+                ...restOptions,
             };
         }
         else if (typeof message === 'string') {
             logEntry = {
                 type: 'general',
-                message,
                 traceId,
                 requestId,
+                deploymentId: this.deploymentId,
+                message,
+                ...restOptions,
             };
         }
         else {
-            // If message is an object, stringify it
+            // If message is an object, it's part of the log entry
             logEntry = {
                 type: 'general',
-                message: JSON.stringify(message),
                 traceId,
                 requestId,
+                deploymentId: this.deploymentId,
+                ...message,
+                message: message.message || 'Structured log data',
+                ...restOptions,
             };
         }
         this.logger[level](logEntry);
@@ -238,6 +290,28 @@ class UnnboundLogger {
     debug(message, options = {}) {
         this.log('debug', message, options);
     }
+    /**
+     * Constructs the full URL from request information
+     * @param req - Express request object
+     * @returns Full URL string
+     */
+    constructFullUrl(req) {
+        // If the URL is already absolute, return it directly
+        const reqUrl = req.originalUrl || req.url;
+        if (reqUrl?.startsWith('http://') || reqUrl?.startsWith('https://')) {
+            return reqUrl;
+        }
+        // Check if we have a base URL configured via environment variable
+        const serviceBaseUrl = process.env.SERVICE_BASE_URL;
+        if (serviceBaseUrl) {
+            // Use configured base URL (useful for ECS when you know your service URL)
+            return `${serviceBaseUrl.replace(/\/$/, '')}${reqUrl}`;
+        }
+        // Fallback to constructing from request info for incoming requests
+        const protocol = req.protocol || (req.secure ? 'https' : 'http');
+        const host = req.get('host') || req.get('x-forwarded-host') || 'localhost';
+        return `${protocol}://${host}${reqUrl}`;
+    }
     /**
      * Logs an HTTP request
      * @param req - Express request object
@@ -245,8 +319,8 @@ class UnnboundLogger {
      * @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 traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, uuid_1.v4)();
+        const requestId = options.requestId || (0, uuid_1.v4)();
         const startTime = options.startTime || Date.now();
         // Store request metadata in res.locals for later use
         if (req.res) {
@@ -256,15 +330,16 @@ class UnnboundLogger {
         }
         const logEntry = {
             type: 'httpRequest',
-            message: `${req.method} ${req.originalUrl || req.url}`,
+            message: req.ip === 'outgoing' ? 'Outgoing HTTP Request' : 'Incoming HTTP Request',
             traceId,
             requestId,
+            deploymentId: this.deploymentId,
             duration: 0, // Will be updated in response
             httpRequest: {
-                url: req.originalUrl || req.url,
+                url: this.constructFullUrl(req),
                 method: req.method,
                 headers: (0, logger_utils_1.filterHeaders)(req.headers),
-                ip: req.ip,
+                ip: (0, logger_utils_1.normalizeIp)(req.ip),
                 body: req.body,
             },
         };
@@ -278,9 +353,9 @@ class UnnboundLogger {
      * @param options - Additional logging options
      */
     httpResponse(res, req, options = {}) {
-        const requestId = res.locals.requestId || options.requestId || (0, id_generator_1.generateUuid)();
+        const requestId = res.locals.requestId || options.requestId || (0, uuid_1.v4)();
         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 traceId = res.locals.traceId || options.traceId || trace_context_1.traceContext.getTraceId() || (0, uuid_1.v4)();
         const duration = options.duration || (Date.now() - startTime);
         // Determine log level based on status code
         let level = options.level || this.defaultLevel;
@@ -297,15 +372,16 @@ class UnnboundLogger {
         }
         const logEntry = {
             type: 'httpResponse',
-            message: `${req.method} ${req.originalUrl || req.url} - ${res.statusCode}`,
+            message: (0, http_status_messages_1.getStatusMessage)(res.statusCode),
             traceId,
             requestId,
+            deploymentId: this.deploymentId,
             duration,
             httpResponse: {
-                url: req.originalUrl || req.url,
+                url: this.constructFullUrl(req),
                 method: req.method,
                 headers: (0, logger_utils_1.filterHeaders)(res.getHeaders()),
-                ip: req.ip,
+                ip: (0, logger_utils_1.normalizeIp)(req.ip),
                 status: res.statusCode,
                 body: res.locals.body,
             },
@@ -318,8 +394,8 @@ class UnnboundLogger {
      * @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 traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, uuid_1.v4)();
+        const requestId = options.requestId || (0, uuid_1.v4)();
         const duration = options.duration || (options.startTime ? Date.now() - options.startTime : 0);
         const level = operation.status === 'success' ? 'info' : 'error';
         const logEntry = {
@@ -327,6 +403,7 @@ class UnnboundLogger {
             message: `SFTP ${operation.operation} ${operation.status} - ${operation.path}`,
             traceId,
             requestId,
+            deploymentId: this.deploymentId,
             duration,
             sftp: operation,
         };
@@ -338,8 +415,8 @@ class UnnboundLogger {
      * @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 traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, uuid_1.v4)();
+        const requestId = options.requestId || (0, uuid_1.v4)();
         const duration = options.duration || (options.startTime ? Date.now() - options.startTime : 0);
         const level = query.status === 'success' ? 'info' : 'error';
         const logEntry = {
@@ -347,6 +424,7 @@ class UnnboundLogger {
             message: `DB Query ${query.status} - ${query.vendor}`,
             traceId,
             requestId,
+            deploymentId: this.deploymentId,
             duration,
             db: query,
         };

package/dist/utils/http-status-messages.d.ts

@@ -0,0 +1,9 @@
+interface HttpStatus {
+    message: string;
+    description: string;
+}
+export declare const httpStatusDetails: {
+    [key: number]: HttpStatus;
+};
+export declare function getStatusMessage(statusCode: number): string;
+export {};

package/dist/utils/http-status-messages.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpStatusDetails = void 0;
+exports.getStatusMessage = getStatusMessage;
+exports.httpStatusDetails = {
+    100: { message: 'Continue', description: 'The server has received the request headers, and the client should proceed to send the request body' },
+    101: { message: 'Switching Protocols', description: 'The requester has asked the server to switch protocols' },
+    103: { message: 'Early Hints', description: 'Used with the Link header to allow the browser to start preloading resources while the server prepares a response' },
+    200: { message: 'OK', description: 'The request is OK' },
+    201: { message: 'Created', description: 'The request has been fulfilled, and a new resource is created' },
+    202: { message: 'Accepted', description: 'The request has been accepted for processing, but the processing has not been completed' },
+    203: { message: 'Non-Authoritative Information', description: 'The request has been successfully processed, but is returning information that may be from another source' },
+    204: { message: 'No Content', description: 'The request has been successfully processed, but is not returning any content' },
+    205: { message: 'Reset Content', description: 'The request has been successfully processed, but is not returning any content, and requires that the requester reset the document view' },
+    206: { message: 'Partial Content', description: 'The server is delivering only part of the resource due to a range header sent by the client' },
+    300: { message: 'Multiple Choices', description: 'A link list. The user can select a link and go to that location. Maximum five addresses' },
+    301: { message: 'Moved Permanently', description: 'The requested page has moved to a new URL' },
+    302: { message: 'Found', description: 'The requested page has moved temporarily to a new URL' },
+    303: { message: 'See Other', description: 'The requested page can be found under a different URL' },
+    304: { message: 'Not Modified', description: 'Indicates the requested page has not been modified since last requested' },
+    307: { message: 'Temporary Redirect', description: 'The requested page has moved temporarily to a new URL' },
+    308: { message: 'Permanent Redirect', description: 'The requested page has moved permanently to a new URL' },
+    400: { message: 'Bad Request', description: 'The request cannot be fulfilled due to bad syntax' },
+    401: { message: 'Unauthorized', description: 'The request was a legal request, but the server is refusing to respond to it. For use when authentication is possible but has failed or not yet been provided' },
+    402: { message: 'Payment Required', description: 'Reserved for future use' },
+    403: { message: 'Forbidden', description: 'The request was a legal request, but the server is refusing to respond to it' },
+    404: { message: 'Not Found', description: 'The requested page could not be found but may be available again in the future' },
+    405: { message: 'Method Not Allowed', description: 'A request was made of a page using a request method not supported by that page' },
+    406: { message: 'Not Acceptable', description: 'The server can only generate a response that is not accepted by the client' },
+    407: { message: 'Proxy Authentication Required', description: 'The client must first authenticate itself with the proxy' },
+    408: { message: 'Request Timeout', description: 'The server timed out waiting for the request' },
+    409: { message: 'Conflict', description: 'The request could not be completed because of a conflict in the request' },
+    410: { message: 'Gone', description: 'The requested page is no longer available' },
+    411: { message: 'Length Required', description: 'The "Content-Length" is not defined. The server will not accept the request without it' },
+    412: { message: 'Precondition Failed', description: 'The precondition given in the request evaluated to false by the server' },
+    413: { message: 'Request Too Large', description: 'The server will not accept the request, because the request entity is too large' },
+    414: { message: 'Request-URI Too Long', description: 'The server will not accept the request, because the URI is too long. Occurs when you convert a POST request to a GET request with a long query information' },
+    415: { message: 'Unsupported Media Type', description: 'The server will not accept the request, because the media type is not supported' },
+    416: { message: 'Range Not Satisfiable', description: 'The client has asked for a portion of the file, but the server cannot supply that portion' },
+    417: { message: 'Expectation Failed', description: 'The server cannot meet the requirements of the Expect request-header field' },
+    500: { message: 'Internal Server Error', description: 'A generic error message, given when no more specific message is suitable' },
+    501: { message: 'Not Implemented', description: 'The server either does not recognize the request method, or it lacks the ability to fulfill the request' },
+    502: { message: 'Bad Gateway', description: 'The server was acting as a gateway or proxy and received an invalid response from the upstream server' },
+    503: { message: 'Service Unavailable', description: 'The server is currently unavailable (overloaded or down)' },
+    504: { message: 'Gateway Timeout', description: 'The server was acting as a gateway or proxy and did not receive a timely response from the upstream server' },
+    505: { message: 'HTTP Version Not Supported', description: 'The server does not support the HTTP protocol version used in the request' },
+    511: { message: 'Network Authentication Required', description: 'The client needs to authenticate to gain network access' },
+};
+function getStatusMessage(statusCode) {
+    const status = exports.httpStatusDetails[statusCode];
+    if (status) {
+        return `${status.message} - ${status.description}`;
+    }
+    return 'Unknown Status';
+}

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

@@ -1,6 +1,19 @@
 /**
- * Utility functions for logging
+ * 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;
 /**
  * Filters an object of headers, returning a new object with only the allowed headers.
  * @param headers The original headers object.

package/dist/utils/logger-utils.js

@@ -1,11 +1,44 @@
 "use strict";
-/**
- * Utility functions for logging
- */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTimestamp = generateTimestamp;
+exports.getTraceId = getTraceId;
+exports.clearTraceId = clearTraceId;
 exports.filterHeaders = filterHeaders;
 exports.safeJsonParse = safeJsonParse;
 exports.normalizeIp = normalizeIp;
+/**
+ * Utility functions for logging
+ */
+const uuid_1 = require("uuid");
+/**
+ * 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, (0, uuid_1.v4)());
+    }
+    return traceIdMap.get(workflowId);
+}
+/**
+ * Clears a trace ID from the map
+ * @param workflowId - The workflow ID to clear
+ */
+function clearTraceId(workflowId) {
+    traceIdMap.delete(workflowId);
+}
 // --- Header Allow-Listing ---
 const ALLOWED_HEADERS = new Set([
     'content-type',

package/dist/utils/with-trace.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withTrace = withTrace;
+/**
+ * Utility function to wrap a function with trace context
+ */
 const uuid_1 = require("uuid");
 const trace_context_1 = require("./trace-context");
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unnbound-logger-sdk",
-  "version": "1.1.3",
+  "version": "2.0.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",