@catbee/utils 0.0.6 → 0.0.8-next.0

package/build/esm/utils/id.utils.js

@@ -1,87 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-import { randomUUID, randomBytes } from 'crypto';
-/**
- * Generates a UUID v4 string (RFC 4122).
- *
- * @returns {string} UUID v4 (e.g., 'c0de1234-5678-9abc-def0-123456789abc')
- */
-export function uuid() {
-    return randomUUID();
-}
-/**
- * Generates a nanoid-style random ID (URL-safe, customizable length).
- *
- * @param {number} length - Length of the ID (default: 21).
- * @returns {string} Nanoid-style random string.
- */
-export function nanoId(length) {
-    if (length === void 0) { length = 21; }
-    if (length <= 0)
-        return '';
-    var id = '';
-    while (id.length < length) {
-        id += randomBytes(Math.ceil((length * 3) / 4))
-            .toString('base64url')
-            .replace(/[+/=]/g, '');
-    }
-    return id.slice(0, length);
-}
-/**
- * Generates a cryptographically strong random hex string.
- *
- * @param {number} byteLength - Number of random bytes (default: 16 → 32 hex chars).
- * @returns {string} Random hex string.
- */
-export function randomHex(byteLength) {
-    if (byteLength === void 0) { byteLength = 16; }
-    // Use Node.js crypto for both Node and browser compatibility
-    // Prefer randomBytes if available (Node), fallback to getRandomValues for browser (not used here)
-    return randomBytes(byteLength)
-        .toString('hex')
-        .padStart(byteLength * 2, '0')
-        .slice(0, byteLength * 2);
-}
-/**
- * Generates a random integer between min (inclusive) and max (inclusive).
- *
- * @param {number} min - Minimum value.
- * @param {number} max - Maximum value.
- * @returns {number} Random integer in range.
- */
-export function randomInt(min, max) {
-    var range = max - min + 1;
-    return Math.floor(Math.random() * range) + min;
-}
-/**
- * Generates a cryptographically strong random base64 string.
- *
- * @param {number} byteLength - Number of random bytes (default: 16).
- * @returns {string} Random base64 string (URL-safe, no padding).
- */
-export function randomBase64(byteLength) {
-    if (byteLength === void 0) { byteLength = 16; }
-    return randomBytes(byteLength).toString('base64url');
-}
-//# sourceMappingURL=id.utils.js.map

package/build/esm/utils/id.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"id.utils.js","sourceRoot":"","sources":["../../../src/utils/id.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,MAAmB;IAAnB,uBAAA,EAAA,WAAmB;IACxC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC1B,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;aAC3C,QAAQ,CAAC,WAAW,CAAC;aACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,UAAuB;IAAvB,2BAAA,EAAA,eAAuB;IAC/C,6DAA6D;IAC7D,kGAAkG;IAClG,OAAO,WAAW,CAAC,UAAU,CAAC;SAC3B,QAAQ,CAAC,KAAK,CAAC;SACf,QAAQ,CAAC,UAAU,GAAG,CAAC,EAAE,GAAG,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,IAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAAuB;IAAvB,2BAAA,EAAA,eAAuB;IAClD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACvD,CAAC","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { randomUUID, randomBytes } from 'crypto';\n\n/**\n * Generates a UUID v4 string (RFC 4122).\n *\n * @returns {string} UUID v4 (e.g., 'c0de1234-5678-9abc-def0-123456789abc')\n */\nexport function uuid(): string {\n  return randomUUID();\n}\n\n/**\n * Generates a nanoid-style random ID (URL-safe, customizable length).\n *\n * @param {number} length - Length of the ID (default: 21).\n * @returns {string} Nanoid-style random string.\n */\nexport function nanoId(length: number = 21): string {\n  if (length <= 0) return '';\n  let id = '';\n  while (id.length < length) {\n    id += randomBytes(Math.ceil((length * 3) / 4))\n      .toString('base64url')\n      .replace(/[+/=]/g, '');\n  }\n  return id.slice(0, length);\n}\n\n/**\n * Generates a cryptographically strong random hex string.\n *\n * @param {number} byteLength - Number of random bytes (default: 16 → 32 hex chars).\n * @returns {string} Random hex string.\n */\nexport function randomHex(byteLength: number = 16): string {\n  // Use Node.js crypto for both Node and browser compatibility\n  // Prefer randomBytes if available (Node), fallback to getRandomValues for browser (not used here)\n  return randomBytes(byteLength)\n    .toString('hex')\n    .padStart(byteLength * 2, '0')\n    .slice(0, byteLength * 2);\n}\n\n/**\n * Generates a random integer between min (inclusive) and max (inclusive).\n *\n * @param {number} min - Minimum value.\n * @param {number} max - Maximum value.\n * @returns {number} Random integer in range.\n */\nexport function randomInt(min: number, max: number): number {\n  const range = max - min + 1;\n  return Math.floor(Math.random() * range) + min;\n}\n\n/**\n * Generates a cryptographically strong random base64 string.\n *\n * @param {number} byteLength - Number of random bytes (default: 16).\n * @returns {string} Random base64 string (URL-safe, no padding).\n */\nexport function randomBase64(byteLength: number = 16): string {\n  return randomBytes(byteLength).toString('base64url');\n}\n"]}

package/build/esm/utils/logger.utils.d.ts

@@ -1,166 +0,0 @@
-import pino from 'pino';
-import type { Logger as PinoLogger } from 'pino';
-/**
- * Logger type for application-wide logging.
- */
-export type Logger = pino.Logger;
-/**
- * Logger levels for application-wide logging.
- */
-export type LoggerLevels = pino.Level;
-export declare const defaultSensitiveFields: string[];
-/**
- * Sets the global redaction censor function used throughout the application for log redaction.
- *
- * Use this function to customize how sensitive data is redacted in logs. The provided function
- * will replace the default censor implementation.
- *
- * @example
- * ```typescript
- * // Custom censor that redacts only specific values
- * setRedactCensor((value, path, sensitiveFields) => {
- *   if (path.includes('password')) return '***';
- *   return value;
- * });
- * ```
- *
- * @param fn - The redaction censor function to use globally. This function receives:
- *   - value: The data value to potentially redact
- *   - path: Array of strings representing the path to the value in the object
- *   - sensitiveFields: Optional array of field names to consider sensitive
- * @returns void
- */
-export declare function setRedactCensor(fn: (value: unknown, path: string[], sensitiveFields?: string[]) => string): void;
-/**
- * Gets the current global redaction censor function used for log redaction.
- *
- * This function is called internally by the logger when determining how to redact
- * sensitive information. It can also be used to access the current censor implementation
- * for composition or extension.
- *
- * @example
- * ```typescript
- * const currentCensor = getRedactCensor();
- * // Create an enhanced censor that extends the current one
- * setRedactCensor((value, path, fields) => {
- *   // Add custom logic before delegating to current censor
- *   if (someCondition) return customHandling();
- *   return currentCensor(value, path, fields);
- * });
- * ```
- *
- * @returns The current redaction censor function
- */
-export declare function getRedactCensor(): (value: unknown, path: string[], sensitiveFields?: string[]) => string;
-/**
- * Convenience function to redact sensitive data using the current global redact censor.
- *
- * This is a direct wrapper around the global censor function that simplifies usage
- * in application code without needing to access the censor function directly.
- *
- * @example
- * ```typescript
- * // Redact a potential sensitive value
- * const safeValue = redact(value, ['user', 'apiKey']);
- * ```
- *
- * @param value - The value to potentially redact
- * @param path - Array of strings representing the path to the value in the object
- * @param sensitiveFields - Optional array of field names to consider sensitive
- * @returns The redacted string value or "***" for redacted content
- */
-export declare function redact(value: unknown, path: string[], sensitiveFields?: string[]): string;
-/**
- * Extends the current redaction function with additional fields to redact.
- *
- * This function wraps the existing censor while adding more fields to be considered
- * sensitive without replacing the entire redaction logic.
- *
- * @example
- * ```typescript
- * // Add custom fields to be redacted in all future redaction operations
- * addRedactFields(['customerId', 'accountNumber']);
- * ```
- *
- * @param fields - Array of additional field names to redact
- */
-export declare function addRedactFields(fields: string[]): void;
-/**
- * Replaces the default list of sensitive fields with a new list.
- *
- * This is useful when you want complete control over what fields are considered
- * sensitive by default, rather than using the library's built-in list.
- *
- * @example
- * ```typescript
- * // Replace default sensitive fields with a custom list
- * setSensitiveFields(['password', 'ssn', 'creditCard']);
- * ```
- *
- * @param fields - Array of field names to set as the new default sensitive fields
- */
-export declare function setSensitiveFields(fields: string[]): void;
-/**
- * Adds additional field names to the default sensitive fields list.
- *
- * This preserves the existing sensitive fields while adding new ones for
- * application-specific sensitive data.
- *
- * @example
- * ```typescript
- * // Add domain-specific sensitive fields to the default list
- * addSensitiveFields(['socialSecurityNumber', 'medicalRecordNumber']);
- * ```
- *
- * @param fields - Array of additional field names to add to the sensitive fields list
- */
-export declare function addSensitiveFields(fields: string[]): void;
-/**
- * Use an object compatible with either modern or legacy global scopes.
- */
-export declare const _globalThis: typeof globalThis;
-/**
- * Retrieves the current logger instance:
- * - Returns a request-scoped logger from AsyncLocalStorage if available
- * - Falls back to the global (singleton) logger
- * - Initializes the global logger if not created yet
- *
- * @returns {Logger} The logger instance (request-bound or global root logger)
- */
-export declare function getLogger(): PinoLogger;
-/**
- * Alias for the current logger instance.
- * - Returns a request-scoped logger from AsyncLocalStorage if available
- * - Falls back to the global (singleton) logger
- * - Initializes the global logger if not created yet
- */
-export declare const logger: typeof getLogger;
-/**
- * Global logger instance.
- */
-export declare const globalLogger: PinoLogger;
-/**
- * Creates a child logger with additional context.
- *
- * @param {Record<string, any>} bindings - Properties to attach to all log records
- * @param {Logger} [parentLogger] - Parent logger (defaults to current context logger or global)
- * @returns {Logger} Child logger with merged context
- */
-export declare function createChildLogger(bindings: Record<string, any>, parentLogger?: PinoLogger): PinoLogger;
-/**
- * Creates a request-scoped logger with request ID and stores it in context
- *
- * @param {string} requestId - Unique request identifier
- * @param {object} [additionalContext] - Additional context to include in logs
- * @returns {Logger} Request-scoped logger instance
- */
-export declare function createRequestLogger(requestId: string, additionalContext?: Record<string, any>): PinoLogger;
-/**
- * Utility to safely log errors with proper stack trace extraction
- *
- * @param {Error|unknown} error - Error object to log
- * @param {string} [message] - Optional message to include
- * @param {Record<string, any>} [context] - Additional context properties
- */
-export declare function logError(error: Error | unknown, message?: string, context?: Record<string, any>): void;
-//# sourceMappingURL=logger.utils.d.ts.map

package/build/esm/utils/logger.utils.js

@@ -1,347 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
-import pino, { stdTimeFunctions } from 'pino';
-import { config } from '../config';
-import { ContextStore, StoreKeys } from './context-store.utils';
-import { Env } from './env.utils';
-/**
- * Symbol used to store the root logger in the Node.js global object.
- */
-var GLOBAL_LOGGER_KEY = Symbol.for('logger');
-// Default sensitive fields
-export var defaultSensitiveFields = [
-    'password',
-    'secret',
-    'token',
-    'apiKey',
-    'api_key',
-    'auth',
-    'jwt',
-    'access_token',
-    'client_secret',
-    'session_token',
-    'refresh_token'
-];
-/**
- * The global censor function used by the logger.
- */
-var globalRedactCensor = function (value, path, sensitiveFields) {
-    if (sensitiveFields === void 0) { sensitiveFields = defaultSensitiveFields; }
-    if (typeof value !== 'string')
-        return '***';
-    var lowerPath = path.map(function (p) { return p.toLowerCase(); });
-    var lowerSensitiveFields = sensitiveFields.map(function (f) { return f.toLowerCase(); });
-    if (lowerPath.some(function (p) { return lowerSensitiveFields.includes(p); }))
-        return '***';
-    // Redact URLs
-    if (lowerPath[0] === 'url') {
-        return value.replace(new RegExp("([?&](".concat(lowerSensitiveFields.join('|'), ")=)[^&#]*"), 'gi'), '$1***');
-    }
-    if (lowerPath.some(function (p) { return p.includes('authorization') || p.includes('auth'); })) {
-        return value.replace(/^(\S+)\s+.+$/, '$1 ***') || '***';
-    }
-    // Redact sensitive fields - check each path segment against each sensitive field
-    if (lowerPath.some(function (pathPart) { return lowerSensitiveFields.some(function (field) { return pathPart.includes(field); }); })) {
-        return '***';
-    }
-    if (path.length > 0 && !['req', 'res', 'headers'].includes(lowerPath[0])) {
-        return value;
-    }
-    return value;
-};
-/**
- * Sets the global redaction censor function used throughout the application for log redaction.
- *
- * Use this function to customize how sensitive data is redacted in logs. The provided function
- * will replace the default censor implementation.
- *
- * @example
- * ```typescript
- * // Custom censor that redacts only specific values
- * setRedactCensor((value, path, sensitiveFields) => {
- *   if (path.includes('password')) return '***';
- *   return value;
- * });
- * ```
- *
- * @param fn - The redaction censor function to use globally. This function receives:
- *   - value: The data value to potentially redact
- *   - path: Array of strings representing the path to the value in the object
- *   - sensitiveFields: Optional array of field names to consider sensitive
- * @returns void
- */
-export function setRedactCensor(fn) {
-    globalRedactCensor = fn;
-}
-/**
- * Gets the current global redaction censor function used for log redaction.
- *
- * This function is called internally by the logger when determining how to redact
- * sensitive information. It can also be used to access the current censor implementation
- * for composition or extension.
- *
- * @example
- * ```typescript
- * const currentCensor = getRedactCensor();
- * // Create an enhanced censor that extends the current one
- * setRedactCensor((value, path, fields) => {
- *   // Add custom logic before delegating to current censor
- *   if (someCondition) return customHandling();
- *   return currentCensor(value, path, fields);
- * });
- * ```
- *
- * @returns The current redaction censor function
- */
-export function getRedactCensor() {
-    return globalRedactCensor;
-}
-/**
- * Convenience function to redact sensitive data using the current global redact censor.
- *
- * This is a direct wrapper around the global censor function that simplifies usage
- * in application code without needing to access the censor function directly.
- *
- * @example
- * ```typescript
- * // Redact a potential sensitive value
- * const safeValue = redact(value, ['user', 'apiKey']);
- * ```
- *
- * @param value - The value to potentially redact
- * @param path - Array of strings representing the path to the value in the object
- * @param sensitiveFields - Optional array of field names to consider sensitive
- * @returns The redacted string value or "***" for redacted content
- */
-export function redact(value, path, sensitiveFields) {
-    return globalRedactCensor(value, path, sensitiveFields);
-}
-/**
- * Extends the current redaction function with additional fields to redact.
- *
- * This function wraps the existing censor while adding more fields to be considered
- * sensitive without replacing the entire redaction logic.
- *
- * @example
- * ```typescript
- * // Add custom fields to be redacted in all future redaction operations
- * addRedactFields(['customerId', 'accountNumber']);
- * ```
- *
- * @param fields - Array of additional field names to redact
- */
-export function addRedactFields(fields) {
-    var prev = globalRedactCensor;
-    globalRedactCensor = function (value, path, sensitiveFields) {
-        if (sensitiveFields === void 0) { sensitiveFields = defaultSensitiveFields; }
-        return prev(value, path, __spreadArray(__spreadArray([], __read((sensitiveFields || [])), false), __read(fields), false));
-    };
-}
-/**
- * Replaces the default list of sensitive fields with a new list.
- *
- * This is useful when you want complete control over what fields are considered
- * sensitive by default, rather than using the library's built-in list.
- *
- * @example
- * ```typescript
- * // Replace default sensitive fields with a custom list
- * setSensitiveFields(['password', 'ssn', 'creditCard']);
- * ```
- *
- * @param fields - Array of field names to set as the new default sensitive fields
- */
-export function setSensitiveFields(fields) {
-    defaultSensitiveFields.splice.apply(defaultSensitiveFields, __spreadArray([0, defaultSensitiveFields.length], __read(fields), false));
-}
-/**
- * Adds additional field names to the default sensitive fields list.
- *
- * This preserves the existing sensitive fields while adding new ones for
- * application-specific sensitive data.
- *
- * @example
- * ```typescript
- * // Add domain-specific sensitive fields to the default list
- * addSensitiveFields(['socialSecurityNumber', 'medicalRecordNumber']);
- * ```
- *
- * @param fields - Array of additional field names to add to the sensitive fields list
- */
-export function addSensitiveFields(fields) {
-    defaultSensitiveFields.push.apply(defaultSensitiveFields, __spreadArray([], __read(fields), false));
-}
-/**
- * Use an object compatible with either modern or legacy global scopes.
- */
-export var _globalThis = typeof globalThis === 'object' ? globalThis : global;
-var _global = _globalThis;
-/**
- * Initializes the global root logger according to app configuration.
- *
- * - Sets log name, level, timestamp, and redaction for sensitive fields.
- * - Uses singleton in global symbol registry.
- */
-function setupLogger() {
-    var _a;
-    var logParams = {
-        name: config.logger.name || '@catbee/utils',
-        level: config.logger.level || 'info',
-        redact: {
-            paths: ['req.authorization', 'res.authorization', 'url', 'headers.authorization', 'headers.cookies'],
-            censor: function (value, path) { return redact(value, path); }
-        },
-        // serializers: {
-        //   req: pino.stdSerializers.req,
-        //   request: pino.stdSerializers.req,
-        //   res: pino.stdSerializers.res,
-        //   response: pino.stdSerializers.res,
-        //   err: pino.stdSerializers.err,
-        //   error: pino.stdSerializers.err
-        // },
-        timestamp: stdTimeFunctions.isoTime
-    };
-    var logger = config.logger.pretty && Env.isDev()
-        ? pino(logParams, pino.transport({
-            target: 'pino-pretty',
-            options: {
-                colorize: true,
-                translateTime: 'SYS:standard',
-                ignore: 'pid,hostname',
-                singleLine: config.logger.singleLine,
-                levelFirst: true
-            }
-        }))
-        : pino(logParams);
-    _global[GLOBAL_LOGGER_KEY] = logger;
-    (_a = _global[GLOBAL_LOGGER_KEY]) === null || _a === void 0 ? void 0 : _a.debug('Logger initialized');
-}
-/**
- * Retrieves the current logger instance:
- * - Returns a request-scoped logger from AsyncLocalStorage if available
- * - Falls back to the global (singleton) logger
- * - Initializes the global logger if not created yet
- *
- * @returns {Logger} The logger instance (request-bound or global root logger)
- */
-export function getLogger() {
-    var logger = ContextStore.get(StoreKeys.LOGGER);
-    if (logger)
-        return logger;
-    if (!_global[GLOBAL_LOGGER_KEY]) {
-        setupLogger();
-    }
-    return _global[GLOBAL_LOGGER_KEY];
-}
-/**
- * Alias for the current logger instance.
- * - Returns a request-scoped logger from AsyncLocalStorage if available
- * - Falls back to the global (singleton) logger
- * - Initializes the global logger if not created yet
- */
-export var logger = getLogger;
-/**
- * Global logger instance.
- */
-export var globalLogger = getLogger();
-/**
- * Creates a child logger with additional context.
- *
- * @param {Record<string, any>} bindings - Properties to attach to all log records
- * @param {Logger} [parentLogger] - Parent logger (defaults to current context logger or global)
- * @returns {Logger} Child logger with merged context
- */
-export function createChildLogger(bindings, parentLogger) {
-    var logger = parentLogger || getLogger();
-    return logger.child(bindings);
-}
-/**
- * Creates a request-scoped logger with request ID and stores it in context
- *
- * @param {string} requestId - Unique request identifier
- * @param {object} [additionalContext] - Additional context to include in logs
- * @returns {Logger} Request-scoped logger instance
- */
-export function createRequestLogger(requestId, additionalContext) {
-    if (additionalContext === void 0) { additionalContext = {}; }
-    var logger = createChildLogger(__assign({ requestId: requestId }, additionalContext));
-    try {
-        ContextStore.set(StoreKeys.LOGGER, logger);
-    }
-    catch (_a) {
-        // Context not initialized, can't store logger
-        logger.debug('Failed to store logger in context - AsyncLocalStorage not initialized');
-    }
-    return logger;
-}
-/**
- * Utility to safely log errors with proper stack trace extraction
- *
- * @param {Error|unknown} error - Error object to log
- * @param {string} [message] - Optional message to include
- * @param {Record<string, any>} [context] - Additional context properties
- */
-export function logError(error, message, context) {
-    var logger = getLogger();
-    var errObj = error instanceof Error ? error : new Error(String(error));
-    var logContext = __assign(__assign({}, context), { error: errObj });
-    logger.error(logContext, message || errObj.message);
-}
-//# sourceMappingURL=logger.utils.js.map

package/build/esm/utils/logger.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.utils.js","sourceRoot":"","sources":["../../../src/utils/logger.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,OAAO,IAAI,EAAE,EAAiB,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC;;GAEG;AACH,IAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAY/C,2BAA2B;AAC3B,MAAM,CAAC,IAAM,sBAAsB,GAAG;IACpC,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;IACN,KAAK;IACL,cAAc;IACd,eAAe;IACf,eAAe;IACf,eAAe;CAChB,CAAC;AAEF;;GAEG;AACH,IAAI,kBAAkB,GAA2E,UAC/F,KAAK,EACL,IAAI,EACJ,eAAwC;IAAxC,gCAAA,EAAA,wCAAwC;IAExC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5C,IAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,WAAW,EAAE,EAAf,CAAe,CAAC,CAAC;IACjD,IAAM,oBAAoB,GAAG,eAAe,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,WAAW,EAAE,EAAf,CAAe,CAAC,CAAC;IAEvE,IAAI,SAAS,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAhC,CAAgC,CAAC;QAAE,OAAO,KAAK,CAAC;IAExE,cAAc;IACd,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,gBAAS,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAjD,CAAiD,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC;IAC1D,CAAC;IAED,iFAAiF;IACjF,IAAI,SAAS,CAAC,IAAI,CAAC,UAAA,QAAQ,IAAI,OAAA,oBAAoB,CAAC,IAAI,CAAC,UAAA,KAAK,IAAI,OAAA,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAxB,CAAwB,CAAC,EAA5D,CAA4D,CAAC,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,EAA0E;IACxG,kBAAkB,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,IAAc,EAAE,eAA0B;IAC/E,OAAO,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,MAAgB;IAC9C,IAAM,IAAI,GAAG,kBAAkB,CAAC;IAChC,kBAAkB,GAAG,UAAC,KAAK,EAAE,IAAI,EAAE,eAAwC;QAAxC,gCAAA,EAAA,wCAAwC;QACzE,OAAA,IAAI,CAAC,KAAK,EAAE,IAAI,yCAAM,CAAC,eAAe,IAAI,EAAE,CAAC,kBAAK,MAAM,UAAE;IAA1D,CAA0D,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IACjD,sBAAsB,CAAC,MAAM,OAA7B,sBAAsB,iBAAQ,CAAC,EAAE,sBAAsB,CAAC,MAAM,UAAK,MAAM,WAAE;AAC7E,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IACjD,sBAAsB,CAAC,IAAI,OAA3B,sBAAsB,2BAAS,MAAM,WAAE;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,IAAM,WAAW,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAChF,IAAM,OAAO,GAAG,WAA6D,CAAC;AAE9E;;;;;GAKG;AACH,SAAS,WAAW;;IAClB,IAAM,SAAS,GAAkB;QAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,eAAe;QAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM;QACpC,MAAM,EAAE;YACN,KAAK,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,CAAC;YACpG,MAAM,EAAE,UAAC,KAAK,EAAE,IAAI,IAAK,OAAA,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAnB,CAAmB;SAC7C;QACD,iBAAiB;QACjB,kCAAkC;QAClC,sCAAsC;QACtC,kCAAkC;QAClC,uCAAuC;QACvC,kCAAkC;QAClC,mCAAmC;QACnC,KAAK;QACL,SAAS,EAAE,gBAAgB,CAAC,OAAO;KACpC,CAAC;IAEF,IAAM,MAAM,GACV,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE;QACjC,CAAC,CAAC,IAAI,CACF,SAAS,EACT,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,cAAc;gBACtB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;gBACpC,UAAU,EAAE,IAAI;aACjB;SACF,CAAC,CACH;QACH,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtB,OAAO,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC;IACpC,MAAA,OAAO,CAAC,iBAAiB,CAAC,0CAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,IAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAa,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAChC,WAAW,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,OAAO,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,IAAM,MAAM,GAAG,SAAS,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,IAAM,YAAY,GAAG,SAAS,EAAE,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA6B,EAAE,YAAyB;IACxF,IAAM,MAAM,GAAG,YAAY,IAAI,SAAS,EAAE,CAAC;IAC3C,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,iBAA2C;IAA3C,kCAAA,EAAA,sBAA2C;IAChG,IAAM,MAAM,GAAG,iBAAiB,YAC9B,SAAS,WAAA,IACN,iBAAiB,EACpB,CAAC;IAEH,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,WAAM,CAAC;QACP,8CAA8C;QAC9C,MAAM,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB,EAAE,OAAgB,EAAE,OAA6B;IAC9F,IAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,IAAM,UAAU,yBACX,OAAO,KACV,KAAK,EAAE,MAAM,GACd,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport pino, { LoggerOptions, stdTimeFunctions } from 'pino';\nimport type { Logger as PinoLogger } from 'pino'; // Type-only import\nimport { config } from '../config';\nimport { ContextStore, StoreKeys } from './context-store.utils';\nimport { Env } from './env.utils';\n\n/**\n * Symbol used to store the root logger in the Node.js global object.\n */\nconst GLOBAL_LOGGER_KEY = Symbol.for('logger');\n\n/**\n * Logger type for application-wide logging.\n */\nexport type Logger = pino.Logger;\n\n/**\n * Logger levels for application-wide logging.\n */\nexport type LoggerLevels = pino.Level;\n\n// Default sensitive fields\nexport const defaultSensitiveFields = [\n  'password',\n  'secret',\n  'token',\n  'apiKey',\n  'api_key',\n  'auth',\n  'jwt',\n  'access_token',\n  'client_secret',\n  'session_token',\n  'refresh_token'\n];\n\n/**\n * The global censor function used by the logger.\n */\nlet globalRedactCensor: (value: unknown, path: string[], sensitiveFields?: string[]) => string = (\n  value,\n  path,\n  sensitiveFields = defaultSensitiveFields\n) => {\n  if (typeof value !== 'string') return '***';\n\n  const lowerPath = path.map(p => p.toLowerCase());\n  const lowerSensitiveFields = sensitiveFields.map(f => f.toLowerCase());\n\n  if (lowerPath.some(p => lowerSensitiveFields.includes(p))) return '***';\n\n  // Redact URLs\n  if (lowerPath[0] === 'url') {\n    return value.replace(new RegExp(`([?&](${lowerSensitiveFields.join('|')})=)[^&#]*`, 'gi'), '$1***');\n  }\n\n  if (lowerPath.some(p => p.includes('authorization') || p.includes('auth'))) {\n    return value.replace(/^(\\S+)\\s+.+$/, '$1 ***') || '***';\n  }\n\n  // Redact sensitive fields - check each path segment against each sensitive field\n  if (lowerPath.some(pathPart => lowerSensitiveFields.some(field => pathPart.includes(field)))) {\n    return '***';\n  }\n\n  if (path.length > 0 && !['req', 'res', 'headers'].includes(lowerPath[0])) {\n    return value;\n  }\n\n  return value;\n};\n\n/**\n * Sets the global redaction censor function used throughout the application for log redaction.\n *\n * Use this function to customize how sensitive data is redacted in logs. The provided function\n * will replace the default censor implementation.\n *\n * @example\n * ```typescript\n * // Custom censor that redacts only specific values\n * setRedactCensor((value, path, sensitiveFields) => {\n *   if (path.includes('password')) return '***';\n *   return value;\n * });\n * ```\n *\n * @param fn - The redaction censor function to use globally. This function receives:\n *   - value: The data value to potentially redact\n *   - path: Array of strings representing the path to the value in the object\n *   - sensitiveFields: Optional array of field names to consider sensitive\n * @returns void\n */\nexport function setRedactCensor(fn: (value: unknown, path: string[], sensitiveFields?: string[]) => string) {\n  globalRedactCensor = fn;\n}\n\n/**\n * Gets the current global redaction censor function used for log redaction.\n *\n * This function is called internally by the logger when determining how to redact\n * sensitive information. It can also be used to access the current censor implementation\n * for composition or extension.\n *\n * @example\n * ```typescript\n * const currentCensor = getRedactCensor();\n * // Create an enhanced censor that extends the current one\n * setRedactCensor((value, path, fields) => {\n *   // Add custom logic before delegating to current censor\n *   if (someCondition) return customHandling();\n *   return currentCensor(value, path, fields);\n * });\n * ```\n *\n * @returns The current redaction censor function\n */\nexport function getRedactCensor() {\n  return globalRedactCensor;\n}\n\n/**\n * Convenience function to redact sensitive data using the current global redact censor.\n *\n * This is a direct wrapper around the global censor function that simplifies usage\n * in application code without needing to access the censor function directly.\n *\n * @example\n * ```typescript\n * // Redact a potential sensitive value\n * const safeValue = redact(value, ['user', 'apiKey']);\n * ```\n *\n * @param value - The value to potentially redact\n * @param path - Array of strings representing the path to the value in the object\n * @param sensitiveFields - Optional array of field names to consider sensitive\n * @returns The redacted string value or \"***\" for redacted content\n */\nexport function redact(value: unknown, path: string[], sensitiveFields?: string[]) {\n  return globalRedactCensor(value, path, sensitiveFields);\n}\n\n/**\n * Extends the current redaction function with additional fields to redact.\n *\n * This function wraps the existing censor while adding more fields to be considered\n * sensitive without replacing the entire redaction logic.\n *\n * @example\n * ```typescript\n * // Add custom fields to be redacted in all future redaction operations\n * addRedactFields(['customerId', 'accountNumber']);\n * ```\n *\n * @param fields - Array of additional field names to redact\n */\nexport function addRedactFields(fields: string[]) {\n  const prev = globalRedactCensor;\n  globalRedactCensor = (value, path, sensitiveFields = defaultSensitiveFields) =>\n    prev(value, path, [...(sensitiveFields || []), ...fields]);\n}\n\n/**\n * Replaces the default list of sensitive fields with a new list.\n *\n * This is useful when you want complete control over what fields are considered\n * sensitive by default, rather than using the library's built-in list.\n *\n * @example\n * ```typescript\n * // Replace default sensitive fields with a custom list\n * setSensitiveFields(['password', 'ssn', 'creditCard']);\n * ```\n *\n * @param fields - Array of field names to set as the new default sensitive fields\n */\nexport function setSensitiveFields(fields: string[]) {\n  defaultSensitiveFields.splice(0, defaultSensitiveFields.length, ...fields);\n}\n\n/**\n * Adds additional field names to the default sensitive fields list.\n *\n * This preserves the existing sensitive fields while adding new ones for\n * application-specific sensitive data.\n *\n * @example\n * ```typescript\n * // Add domain-specific sensitive fields to the default list\n * addSensitiveFields(['socialSecurityNumber', 'medicalRecordNumber']);\n * ```\n *\n * @param fields - Array of additional field names to add to the sensitive fields list\n */\nexport function addSensitiveFields(fields: string[]) {\n  defaultSensitiveFields.push(...fields);\n}\n\n/**\n * Use an object compatible with either modern or legacy global scopes.\n */\nexport const _globalThis = typeof globalThis === 'object' ? globalThis : global;\nconst _global = _globalThis as unknown as { [GLOBAL_LOGGER_KEY]: PinoLogger };\n\n/**\n * Initializes the global root logger according to app configuration.\n *\n * - Sets log name, level, timestamp, and redaction for sensitive fields.\n * - Uses singleton in global symbol registry.\n */\nfunction setupLogger(): void {\n  const logParams: LoggerOptions = {\n    name: config.logger.name || '@catbee/utils',\n    level: config.logger.level || 'info',\n    redact: {\n      paths: ['req.authorization', 'res.authorization', 'url', 'headers.authorization', 'headers.cookies'],\n      censor: (value, path) => redact(value, path)\n    },\n    // serializers: {\n    //   req: pino.stdSerializers.req,\n    //   request: pino.stdSerializers.req,\n    //   res: pino.stdSerializers.res,\n    //   response: pino.stdSerializers.res,\n    //   err: pino.stdSerializers.err,\n    //   error: pino.stdSerializers.err\n    // },\n    timestamp: stdTimeFunctions.isoTime\n  };\n\n  const logger =\n    config.logger.pretty && Env.isDev()\n      ? pino(\n          logParams,\n          pino.transport({\n            target: 'pino-pretty',\n            options: {\n              colorize: true,\n              translateTime: 'SYS:standard',\n              ignore: 'pid,hostname',\n              singleLine: config.logger.singleLine,\n              levelFirst: true\n            }\n          })\n        )\n      : pino(logParams);\n\n  _global[GLOBAL_LOGGER_KEY] = logger;\n  _global[GLOBAL_LOGGER_KEY]?.debug('Logger initialized');\n}\n\n/**\n * Retrieves the current logger instance:\n * - Returns a request-scoped logger from AsyncLocalStorage if available\n * - Falls back to the global (singleton) logger\n * - Initializes the global logger if not created yet\n *\n * @returns {Logger} The logger instance (request-bound or global root logger)\n */\nexport function getLogger(): PinoLogger {\n  const logger = ContextStore.get<PinoLogger>(StoreKeys.LOGGER);\n  if (logger) return logger;\n\n  if (!_global[GLOBAL_LOGGER_KEY]) {\n    setupLogger();\n  }\n\n  return _global[GLOBAL_LOGGER_KEY];\n}\n\n/**\n * Alias for the current logger instance.\n * - Returns a request-scoped logger from AsyncLocalStorage if available\n * - Falls back to the global (singleton) logger\n * - Initializes the global logger if not created yet\n */\nexport const logger = getLogger;\n\n/**\n * Global logger instance.\n */\nexport const globalLogger = getLogger();\n\n/**\n * Creates a child logger with additional context.\n *\n * @param {Record<string, any>} bindings - Properties to attach to all log records\n * @param {Logger} [parentLogger] - Parent logger (defaults to current context logger or global)\n * @returns {Logger} Child logger with merged context\n */\nexport function createChildLogger(bindings: Record<string, any>, parentLogger?: PinoLogger): PinoLogger {\n  const logger = parentLogger || getLogger();\n  return logger.child(bindings);\n}\n\n/**\n * Creates a request-scoped logger with request ID and stores it in context\n *\n * @param {string} requestId - Unique request identifier\n * @param {object} [additionalContext] - Additional context to include in logs\n * @returns {Logger} Request-scoped logger instance\n */\nexport function createRequestLogger(requestId: string, additionalContext: Record<string, any> = {}): PinoLogger {\n  const logger = createChildLogger({\n    requestId,\n    ...additionalContext\n  });\n\n  try {\n    ContextStore.set(StoreKeys.LOGGER, logger);\n  } catch {\n    // Context not initialized, can't store logger\n    logger.debug('Failed to store logger in context - AsyncLocalStorage not initialized');\n  }\n\n  return logger;\n}\n\n/**\n * Utility to safely log errors with proper stack trace extraction\n *\n * @param {Error|unknown} error - Error object to log\n * @param {string} [message] - Optional message to include\n * @param {Record<string, any>} [context] - Additional context properties\n */\nexport function logError(error: Error | unknown, message?: string, context?: Record<string, any>): void {\n  const logger = getLogger();\n\n  const errObj = error instanceof Error ? error : new Error(String(error));\n  const logContext = {\n    ...context,\n    error: errObj\n  };\n\n  logger.error(logContext, message || errObj.message);\n}\n"]}