unnbound-logger-sdk 3.0.0 → 3.0.1

package/dist/unnbound-logger.js

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

@@ -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,160 @@
+"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

@@ -0,0 +1,34 @@
+/**
+ * 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;