unnbound-logger-sdk 3.0.1 → 3.0.3

package/dist/types.d.ts

@@ -43,7 +43,7 @@ export interface HttpLog extends LogTransaction<'http'> {
         };
     };
 }
-export type SftpOperation = 'connect' | 'upload' | 'download' | 'list' | 'delete' | 'rename' | 'stat' | 'exists' | 'realPath' | 'get' | 'put' | 'cwd' | 'mkdir' | 'rmdir' | 'chmod' | 'append' | 'uploadDir' | 'downloadDir' | 'end';
+export type SftpOperation = 'connect' | 'upload' | 'download' | 'list' | 'delete' | 'rename' | 'stat' | 'exists' | 'realPath' | 'get' | 'put' | 'cwd' | 'mkdir' | 'rmdir' | 'chmod' | 'append' | 'uploadDir' | 'downloadDir' | 'close';
 export interface SftpPayload {
     host: string;
     operation: SftpOperation;
@@ -51,6 +51,8 @@ export interface SftpPayload {
     bytes?: number;
     destinationPath?: string;
     files?: number;
+    content?: string;
+    exists?: string | false;
 }
 export interface SftpLog extends LogTransaction<'sftp'> {
     sftp: SftpPayload;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unnbound-logger-sdk",
   "description": "A structured logging library with TypeScript support using Pino. Provides consistent, well-typed logging with automatic logId, workflowId, traceId, and deploymentId tracking across operational contexts.",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "keywords": [

package/dist/http.js

@@ -1 +0,0 @@
-"use strict";

package/dist/sftp.d.ts

@@ -1,10 +0,0 @@
-import { SftpPayload } from './types';
-/**
- * Builds a SFTP payload
- * @param payload - SFTP payload
- * @returns The SFTP payload
- */
-export declare const buildSftpPayload: (payload: SftpPayload) => {
-    type: string;
-    sftp: SftpPayload;
-};

package/dist/sftp.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSftpPayload = void 0;
-/**
- * Builds a SFTP payload
- * @param payload - SFTP payload
- * @returns The SFTP payload
- */
-const buildSftpPayload = (payload) => ({
-    type: 'sftp',
-    sftp: payload,
-});
-exports.buildSftpPayload = buildSftpPayload;

package/dist/unnbound-logger.d.ts

@@ -1,114 +0,0 @@
-/**
- * Core logger implementation
- */
-import pino from 'pino';
-import { LogLevel, LoggerOptions, GeneralLogOptions, HttpRequestLogOptions, HttpResponseLogOptions, DbQueryTransactionLogOptions, Log, HttpRequestLog, HttpResponseLog, DbQueryTransactionLog } from './types';
-import { Request, Response, NextFunction } from 'express';
-import { InternalAxiosRequestConfig } from 'axios';
-declare module 'axios' {
-    interface InternalAxiosRequestConfig {
-        metadata?: {
-            startTime: number;
-            requestId?: string;
-        };
-    }
-}
-export declare const logger: pino.Logger;
-/**
- * UnnboundLogger provides typed, structured logging using Pino
- */
-export declare class UnnboundLogger {
-    private logger;
-    private workflowId;
-    private workflowUrl;
-    private serviceId;
-    private deploymentId;
-    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): Log;
-    /**
-     * Logs an error message
-     * @param message - Error message or object
-     * @param options - Additional logging options
-     */
-    error(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): Log;
-    /**
-     * Logs a warning message
-     * @param message - Warning message
-     * @param options - Additional logging options
-     */
-    warn(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): Log;
-    /**
-     * Logs an info message
-     * @param message - Info message
-     * @param options - Additional logging options
-     */
-    info(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): Log;
-    /**
-     * Logs a debug message
-     * @param message - Debug message
-     * @param options - Additional logging options
-     */
-    debug(message: string | Error | Record<string, unknown>, options?: GeneralLogOptions): Log;
-    /**
-     * 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
-     * @param options - Additional logging options
-     * @returns The request ID for correlating with the response
-     */
-    httpRequest(req: Request, options?: HttpRequestLogOptions): HttpRequestLog;
-    /**
-     * 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): HttpResponseLog;
-    /**
-     * 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): DbQueryTransactionLog;
-    traceMiddleware: (req: Request, res: Response, next: NextFunction) => void;
-    axiosTraceMiddleware: {
-        onFulfilled: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
-        onRejected: (error: any) => any;
-    };
-    axiosResponseInterceptor: {
-        onFulfilled: (response: any) => any;
-        onRejected: (error: any) => any;
-    };
-}

package/dist/unnbound-logger.js

@@ -1,475 +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 = exports.logger = void 0;
-/**
- * Core logger implementation
- */
-const pino_1 = __importDefault(require("pino"));
-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");
-const storage_1 = require("./storage");
-exports.logger = (0, pino_1.default)({
-    level: process.env.LOG_LEVEL ?? 'info',
-    base: {
-        environment: process.env.ENVIRONMENT,
-        workflowId: process.env.UNNBOUND_WORKFLOW_ID,
-        workflowUrl: process.env.UNNBOUND_WORKFLOW_URL,
-        serviceId: process.env.UNNBOUND_SERVICE_ID,
-        deploymentId: process.env.UNNBOUND_DEPLOYMENT_ID,
-    },
-    mixin: () => {
-        console.log('storage', storage_1.storage.getStore());
-        return storage_1.storage.getStore() ?? {};
-    },
-    serializers: {
-        req: pino_1.default.stdSerializers.req,
-        res: pino_1.default.stdSerializers.res,
-        err: pino_1.default.stdSerializers.err,
-    },
-    // Let CloudWatch handle timestamps
-    timestamp: false,
-    // Change message field from 'msg' to 'messages'
-    messageKey: 'messages',
-    formatters: {
-        level: (level) => ({ level }),
-    },
-});
-/**
- * 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, () => {
-                // Log the incoming request
-                const reqLog = 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: reqLog.requestId, 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;
-                }
-                // 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: (0, logger_utils_1.safeJsonParse)(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;
-            },
-            onRejected: (error) => {
-                return Promise.reject(error);
-            },
-        };
-        // Axios response interceptor (should be used separately)
-        this.axiosResponseInterceptor = {
-            onFulfilled: (response) => {
-                // Check if the URL should be ignored
-                const url = `${response.config?.baseURL || ''}${response.config?.url}`;
-                if (url && this.shouldIgnorePath(url, this.ignoreAxiosTraceRoutes)) {
-                    return 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 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: (0, logger_utils_1.safeJsonParse)(response.data),
-                        startTime: startTime,
-                        traceId: trace_context_1.traceContext.getTraceId(),
-                        requestId: requestId,
-                    },
-                    getHeaders: () => response.headers || {},
-                };
-                this.httpResponse(mockRes, mockReq, {
-                    requestId,
-                    duration,
-                    traceId: trace_context_1.traceContext.getTraceId(),
-                });
-                return response;
-            },
-            onRejected: (error) => {
-                // Check if the URL should be ignored
-                const url = `${error.config?.baseURL || ''}${error.config?.url}`;
-                if (url && this.shouldIgnorePath(url, this.ignoreAxiosTraceRoutes)) {
-                    return Promise.reject(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 using proper httpResponse method
-                if (error.response) {
-                    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: (0, logger_utils_1.safeJsonParse)(error.response.data),
-                            startTime: startTime,
-                            traceId: trace_context_1.traceContext.getTraceId(),
-                            requestId: requestId,
-                        },
-                        getHeaders: () => error.response.headers || {},
-                    };
-                    this.httpResponse(mockRes, mockReq, {
-                        requestId,
-                        duration,
-                        traceId: trace_context_1.traceContext.getTraceId(),
-                    });
-                }
-                else {
-                    // 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);
-            },
-        };
-        this.workflowId = process.env.UNNBOUND_WORKFLOW_ID || '';
-        this.workflowUrl = process.env.UNNBOUND_WORKFLOW_URL || '';
-        this.serviceId = process.env.UNNBOUND_SERVICE_ID || '';
-        this.deploymentId = process.env.UNNBOUND_DEPLOYMENT_ID || '';
-        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: 'info',
-            base: {
-                // Disable all default base fields (pid, hostname) and add our own
-                workflowId: this.workflowId,
-                serviceId: this.serviceId,
-                deploymentId: this.deploymentId,
-            },
-            // Let CloudWatch handle timestamps
-            timestamp: false,
-            // Change message field from 'msg' to 'messages'
-            messageKey: 'messages',
-            formatters: {
-                level: (level) => ({ level }),
-            },
-        });
-    }
-    /**
-     * 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 logId = (0, uuid_1.v4)();
-        const traceId = options.traceId || trace_context_1.traceContext.getTraceId() || (0, uuid_1.v4)();
-        const requestId = options.requestId || (0, uuid_1.v4)();
-        let logEntry;
-        const { traceId: optionTraceId, requestId: optionRequestId, level: optionLevel, ...restOptions } = options;
-        // If restOptions has any properties, we'll add them to data later
-        const hasRestOptions = Object.keys(restOptions).length > 0;
-        const baseEntry = {
-            logId,
-            type: 'general',
-            workflowId: this.workflowId,
-            serviceId: this.serviceId,
-            traceId,
-            requestId,
-            deploymentId: this.deploymentId,
-        };
-        if (message instanceof Error) {
-            logEntry = {
-                ...baseEntry,
-                message: message.name,
-                error: message,
-                ...(hasRestOptions && { data: restOptions }),
-            };
-        }
-        else if (typeof message === 'string') {
-            logEntry = {
-                ...baseEntry,
-                message,
-                ...(hasRestOptions && { data: restOptions }),
-            };
-        }
-        else {
-            // If message is an object, wrap it in a 'data' key
-            const messageObj = message;
-            logEntry = {
-                ...baseEntry,
-                message: 'Structured log data',
-                data: hasRestOptions ? { ...messageObj, ...restOptions } : messageObj,
-            };
-        }
-        // Separate the message from the log data and explicitly exclude any level field
-        const { message: logMessage, level: excludedLevel, ...logData } = logEntry;
-        this.logger[level](logData, logMessage);
-        return logEntry;
-    }
-    /**
-     * Logs an error message
-     * @param message - Error message or object
-     * @param options - Additional logging options
-     */
-    error(message, options = {}) {
-        return this.log('error', message, options);
-    }
-    /**
-     * Logs a warning message
-     * @param message - Warning message
-     * @param options - Additional logging options
-     */
-    warn(message, options = {}) {
-        return this.log('warn', message, options);
-    }
-    /**
-     * Logs an info message
-     * @param message - Info message
-     * @param options - Additional logging options
-     */
-    info(message, options = {}) {
-        return this.log('info', message, options);
-    }
-    /**
-     * Logs a debug message
-     * @param message - Debug message
-     * @param options - Additional logging options
-     */
-    debug(message, options = {}) {
-        return 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 workflow URL configured (preferred method)
-        if (this.workflowUrl) {
-            // Use workflow URL as the base URL
-            return `${this.workflowUrl.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
-     * @param options - Additional logging options
-     * @returns The request ID for correlating with the response
-     */
-    httpRequest(req, options = {}) {
-        const logId = (0, uuid_1.v4)();
-        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) {
-            req.res.locals.requestId = requestId;
-            req.res.locals.startTime = startTime;
-            req.res.locals.traceId = traceId;
-            req.res.locals.workflowId = this.workflowId;
-            req.res.locals.workflowUrl = this.workflowUrl;
-            req.res.locals.serviceId = this.serviceId;
-        }
-        const logEntry = {
-            logId,
-            type: 'httpRequest',
-            message: req.ip === 'outgoing' ? 'Outgoing HTTP Request' : 'Incoming HTTP Request',
-            workflowId: this.workflowId,
-            serviceId: this.serviceId,
-            traceId,
-            requestId,
-            deploymentId: this.deploymentId,
-            duration: 0, // Will be updated in response
-            httpRequest: {
-                url: this.constructFullUrl(req),
-                method: req.method,
-                headers: (0, logger_utils_1.filterHeaders)(req.headers),
-                ip: (0, logger_utils_1.normalizeIp)(req.ip),
-                body: (0, logger_utils_1.safeJsonParse)(req.body),
-            },
-        };
-        const { message: logMessage, ...logData } = logEntry;
-        this.logger[options.level || 'info'](logData, logMessage);
-        return logEntry;
-    }
-    /**
-     * Logs an HTTP response
-     * @param res - Express response object
-     * @param req - Express request object
-     * @param options - Additional logging options
-     */
-    httpResponse(res, req, options = {}) {
-        const logId = (0, uuid_1.v4)();
-        const requestId = res.locals.requestId || options.requestId || (0, uuid_1.v4)();
-        const startTime = res.locals.startTime || options.startTime || Date.now();
-        const workflowId = res.locals.workflowId || this.workflowId;
-        const serviceId = res.locals.serviceId || this.serviceId;
-        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 || 'info';
-        if (!options.level) {
-            if (res.statusCode >= 400) {
-                level = 'error';
-            }
-            else {
-                level = 'info';
-            }
-        }
-        const logEntry = {
-            logId,
-            type: 'httpResponse',
-            message: (0, http_status_messages_1.getStatusMessage)(res.statusCode),
-            workflowId: workflowId || '',
-            serviceId: serviceId || '',
-            traceId,
-            requestId,
-            deploymentId: this.deploymentId,
-            duration,
-            httpResponse: {
-                url: this.constructFullUrl(req),
-                method: req.method,
-                headers: (0, logger_utils_1.filterHeaders)(res.getHeaders()),
-                ip: (0, logger_utils_1.normalizeIp)(req.ip),
-                status: res.statusCode,
-                body: (0, logger_utils_1.safeJsonParse)(res.locals.body),
-            },
-        };
-        const { message: logMessage, ...logData } = logEntry;
-        this.logger[level](logData, logMessage);
-        return logEntry;
-    }
-    /**
-     * Logs a database query transaction
-     * @param query - Database query details
-     * @param options - Additional logging options
-     */
-    dbQueryTransaction(query, options = {}) {
-        const logId = (0, uuid_1.v4)();
-        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 = {
-            logId,
-            type: 'dbQueryTransaction',
-            message: `DB Query ${query.status} - ${query.vendor}`,
-            workflowId: this.workflowId,
-            serviceId: this.serviceId,
-            traceId,
-            requestId,
-            deploymentId: this.deploymentId,
-            duration,
-            db: query,
-        };
-        const { message: logMessage, ...logData } = logEntry;
-        this.logger[level](logData, logMessage);
-        return logEntry;
-    }
-}
-exports.UnnboundLogger = UnnboundLogger;
-process.on('uncaughtException', (err, origin) => {
-    exports.logger.error({ err, origin }, `Uncaught exception.`);
-});

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

@@ -1,9 +0,0 @@
-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

@@ -1,160 +0,0 @@
-"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 `${statusCode} ${status.message} - ${status.description}`;
-    }
-    return `${statusCode} Unknown Status`;
-}

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

@@ -1,34 +0,0 @@
-/**
- * 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.
- * @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/utils/logger-utils.js

@@ -1,96 +0,0 @@
-"use strict";
-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',
-    '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/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/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/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/utils/with-trace.js

@@ -1,20 +0,0 @@
-"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");
-/**
- * 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));
-    });
-}