@catbee/utils 0.0.8-rc.1 → 0.0.8-rc.3

package/build/{src → cjs}/utils/env.utils.js

@@ -42,6 +42,8 @@ var Environment;
  * Provides typed getters with fallback defaults and validation.
  */
 class Env {
+    // Cache for parsed values to avoid repeated parsing of complex values
+    static cache = new Map();
     /**
      * Checks if the current NODE_ENV is 'development'.
      *
@@ -112,13 +114,11 @@ class Env {
      * const url = Env.get('DATABASE_URL', ''); // "postgres://localhost:5432/myapp"
      */
     static get(key, defaultValue) {
-        var _a;
-        let value = (_a = process.env[key]) !== null && _a !== void 0 ? _a : defaultValue;
+        let value = process.env[key] ?? defaultValue;
         // Expand ${VAR} references
         if (value && value.includes('${')) {
             value = value.replace(/\${([A-Za-z0-9_]+)}/g, (_, varName) => {
-                var _a;
-                return (_a = process.env[varName]) !== null && _a !== void 0 ? _a : '';
+                return process.env[varName] ?? '';
             });
         }
         return value;
@@ -440,7 +440,7 @@ class Env {
         try {
             url = new URL(value);
         }
-        catch (_a) {
+        catch {
             throw new Error(`Environment variable '${key}' is not a valid URL: "${value}"`);
         }
         // Validate protocol
@@ -784,6 +784,3 @@ class Env {
     }
 }
 exports.Env = Env;
-// Cache for parsed values to avoid repeated parsing of complex values
-Env.cache = new Map();
-//# sourceMappingURL=env.utils.js.map

package/build/{src → cjs}/utils/exception.utils.d.ts

@@ -227,4 +227,3 @@ export declare function getErrorMessage(error: unknown): string;
  * @returns A function that always returns or throws an HTTP error.
  */
 export declare function withErrorHandling<T extends (...args: any[]) => Promise<any>>(handler: T): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>;
-//# sourceMappingURL=exception.utils.d.ts.map

package/build/{src → cjs}/utils/exception.utils.js

@@ -193,6 +193,7 @@ exports.GatewayTimeoutException = GatewayTimeoutException;
  * Used when the server understands the content type but cannot process the contained instructions.
  */
 class UnprocessableEntityException extends response_utils_1.ErrorResponse {
+    details;
     /**
      * @param message - Optional custom message. Defaults to "Unprocessable Entity".
      * @param details - Optional validation details or additional error context.
@@ -209,6 +210,7 @@ exports.UnprocessableEntityException = UnprocessableEntityException;
  * Used when the request method is not supported for the requested resource.
  */
 class MethodNotAllowedException extends response_utils_1.ErrorResponse {
+    allowedMethods;
     /**
      * @param message - Optional custom message. Defaults to "Method Not Allowed".
      * @param allowedMethods - Optional array of allowed HTTP methods.
@@ -404,4 +406,3 @@ function withErrorHandling(handler) {
         }
     };
 }
-//# sourceMappingURL=exception.utils.js.map

package/build/{src → cjs}/utils/fs.utils.d.ts

@@ -161,4 +161,3 @@ export declare function getFileSize(path: string): Promise<number>;
  * @returns {Promise<Buffer | null>} File contents as Buffer or null if reading fails.
  */
 export declare function readFileBuffer(path: string): Promise<Buffer | null>;
-//# sourceMappingURL=fs.utils.d.ts.map

package/build/{src → cjs}/utils/fs.utils.js

@@ -61,7 +61,7 @@ async function fileExists(path) {
         await promises_1.default.access(path);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -77,7 +77,7 @@ async function readJsonFile(path) {
         const data = await promises_1.default.readFile(path, 'utf-8');
         return JSON.parse(data);
     }
-    catch (_a) {
+    catch {
         return null;
     }
 }
@@ -121,7 +121,7 @@ async function readTextFile(path, encoding = 'utf-8') {
     try {
         return await promises_1.default.readFile(path, encoding);
     }
-    catch (_a) {
+    catch {
         return null;
     }
 }
@@ -138,7 +138,7 @@ async function writeTextFile(path, content, encoding = 'utf-8') {
         await promises_1.default.writeFile(path, content, encoding);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -155,7 +155,7 @@ async function appendTextFile(path, content, encoding = 'utf-8') {
         await promises_1.default.appendFile(path, content, encoding);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -173,7 +173,7 @@ async function copyFile(source, destination, overwrite = false) {
         await promises_1.default.copyFile(source, destination, flags);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -189,14 +189,14 @@ async function moveFile(oldPath, newPath) {
         await promises_1.default.rename(oldPath, newPath);
         return true;
     }
-    catch (_a) {
+    catch {
         // If rename fails (e.g., across devices), try copy+delete
         try {
             await promises_1.default.copyFile(oldPath, newPath);
             await promises_1.default.unlink(oldPath);
             return true;
         }
-        catch (_b) {
+        catch {
             return false;
         }
     }
@@ -211,7 +211,7 @@ async function getFileStats(path) {
     try {
         return await promises_1.default.stat(path);
     }
-    catch (_a) {
+    catch {
         return null;
     }
 }
@@ -336,7 +336,7 @@ async function isFile(path) {
         const stat = await promises_1.default.stat(path);
         return stat.isFile();
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -351,7 +351,7 @@ async function getFileSize(path) {
         const stat = await promises_1.default.stat(path);
         return stat.size;
     }
-    catch (_a) {
+    catch {
         return -1;
     }
 }
@@ -365,8 +365,7 @@ async function readFileBuffer(path) {
     try {
         return await promises_1.default.readFile(path);
     }
-    catch (_a) {
+    catch {
         return null;
     }
 }
-//# sourceMappingURL=fs.utils.js.map

package/build/{esnext → cjs}/utils/http-status-codes.d.ts

@@ -263,4 +263,3 @@ export declare enum HttpStatusCodes {
      */
     NETWORK_AUTHENTICATION_REQUIRED = 511
 }
-//# sourceMappingURL=http-status-codes.d.ts.map

package/build/{src → cjs}/utils/http-status-codes.js

@@ -295,4 +295,3 @@ var HttpStatusCodes;
      */
     HttpStatusCodes[HttpStatusCodes["NETWORK_AUTHENTICATION_REQUIRED"] = 511] = "NETWORK_AUTHENTICATION_REQUIRED";
 })(HttpStatusCodes || (exports.HttpStatusCodes = HttpStatusCodes = {}));
-//# sourceMappingURL=http-status-codes.js.map

package/build/{esnext → cjs}/utils/id.utils.d.ts

@@ -33,4 +33,3 @@ export declare function randomInt(min: number, max: number): number;
  * @returns {string} Random base64 string (URL-safe, no padding).
  */
 export declare function randomBase64(byteLength?: number): string;
-//# sourceMappingURL=id.utils.d.ts.map

package/build/{src → cjs}/utils/id.utils.js

@@ -88,4 +88,3 @@ function randomInt(min, max) {
 function randomBase64(byteLength = 16) {
     return (0, crypto_1.randomBytes)(byteLength).toString('base64url');
 }
-//# sourceMappingURL=id.utils.js.map

package/build/{src → cjs}/utils/logger.utils.d.ts

@@ -157,4 +157,3 @@ export declare function createRequestLogger(requestId: string, additionalContext
  * @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/{src → cjs}/utils/logger.utils.js

@@ -246,7 +246,6 @@ const _global = exports._globalThis;
  * - Uses singleton in global symbol registry.
  */
 function setupLogger() {
-    var _a;
     const logParams = {
         name: config_1.config.logger.name || '@catbee/utils',
         level: config_1.config.logger.level || 'info',
@@ -277,7 +276,7 @@ function setupLogger() {
         }))
         : (0, pino_1.default)(logParams);
     _global[GLOBAL_LOGGER_KEY] = logger;
-    (_a = _global[GLOBAL_LOGGER_KEY]) === null || _a === void 0 ? void 0 : _a.debug('Logger initialized');
+    _global[GLOBAL_LOGGER_KEY]?.debug('Logger initialized');
 }
 /**
  * Retrieves the current logger instance:
@@ -320,11 +319,14 @@ function createChildLogger(bindings, parentLogger) {
  * @returns {Logger} Request-scoped logger instance
  */
 function createRequestLogger(requestId, additionalContext = {}) {
-    const logger = createChildLogger(Object.assign({ requestId }, additionalContext));
+    const logger = createChildLogger({
+        requestId,
+        ...additionalContext
+    });
     try {
         context_store_utils_1.ContextStore.set(context_store_utils_1.StoreKeys.LOGGER, logger);
     }
-    catch (_a) {
+    catch {
         // Context not initialized, can't store logger
         logger.debug('Failed to store logger in context - AsyncLocalStorage not initialized');
     }
@@ -340,7 +342,9 @@ function createRequestLogger(requestId, additionalContext = {}) {
 function logError(error, message, context) {
     const logger = getLogger();
     const errObj = error instanceof Error ? error : new Error(String(error));
-    const logContext = Object.assign(Object.assign({}, context), { error: errObj });
+    const logContext = {
+        ...context,
+        error: errObj
+    };
     logger.error(logContext, message || errObj.message);
 }
-//# sourceMappingURL=logger.utils.js.map

package/build/{esnext → cjs}/utils/middleware.utils.d.ts

@@ -97,4 +97,3 @@ export declare function healthCheck(options?: {
     }>;
     detailed?: boolean;
 }): Middleware;
-//# sourceMappingURL=middleware.utils.d.ts.map

package/build/{src → cjs}/utils/middleware.utils.js

@@ -46,9 +46,9 @@ const exception_utils_1 = require("./exception.utils");
  * @returns {Middleware} Express-compatible middleware
  */
 function requestId(options) {
-    const headerName = (options === null || options === void 0 ? void 0 : options.headerName) || 'X-Request-ID';
-    const exposeHeader = (options === null || options === void 0 ? void 0 : options.exposeHeader) !== false;
-    const generateId = (options === null || options === void 0 ? void 0 : options.generator) || id_utils_1.uuid;
+    const headerName = options?.headerName || 'X-Request-ID';
+    const exposeHeader = options?.exposeHeader !== false;
+    const generateId = options?.generator || id_utils_1.uuid;
     return (req, res, next) => {
         // Use existing request ID from header or generate a new one
         const existingId = req.headers[headerName.toLowerCase()];
@@ -71,8 +71,8 @@ function requestId(options) {
  * @returns {Middleware} Express-compatible middleware
  */
 function responseTime(options) {
-    const addHeader = (options === null || options === void 0 ? void 0 : options.addHeader) !== false;
-    const logOnComplete = (options === null || options === void 0 ? void 0 : options.logOnComplete) === true;
+    const addHeader = options?.addHeader !== false;
+    const logOnComplete = options?.logOnComplete === true;
     return (req, res, next) => {
         const start = process.hrtime();
         // Function to calculate duration
@@ -129,7 +129,7 @@ function setupRequestContext(options = {}) {
     const { headerName = 'x-request-id', autoLog = true } = options;
     return (req, _res, next) => {
         // Generate or use existing request ID
-        const requestId = req.headers[headerName] || (req === null || req === void 0 ? void 0 : req['id']) || (0, id_utils_1.uuid)();
+        const requestId = req.headers[headerName] || req?.['id'] || (0, id_utils_1.uuid)();
         context_store_utils_1.ContextStore.run({ [context_store_utils_1.StoreKeys.REQUEST_ID]: requestId }, () => {
             // Create a child logger for this request
             const childLogger = (0, logger_utils_1.getLogger)().child({
@@ -174,11 +174,11 @@ function setupRequestContext(options = {}) {
  * });
  */
 function errorHandler(options) {
-    const logErrors = (options === null || options === void 0 ? void 0 : options.logErrors) !== false;
-    const includeDetails = (options === null || options === void 0 ? void 0 : options.includeDetails) === true;
+    const logErrors = options?.logErrors !== false;
+    const includeDetails = options?.includeDetails === true;
     return (err, req, res, _next) => {
         // Determine status code
-        const status = (err === null || err === void 0 ? void 0 : err.status) || (err === null || err === void 0 ? void 0 : err.statusCode) || http_status_codes_1.HttpStatusCodes.INTERNAL_SERVER_ERROR;
+        const status = err?.status || err?.statusCode || http_status_codes_1.HttpStatusCodes.INTERNAL_SERVER_ERROR;
         // Log error if enabled
         if (logErrors) {
             (0, logger_utils_1.getLogger)().error({ err }, `${err.message || 'Unknown error'}`);
@@ -189,11 +189,11 @@ function errorHandler(options) {
                 error: true,
                 message: err.message,
                 timestamp: err.timestamp,
-                requestId: (err === null || err === void 0 ? void 0 : err.requestId) || (req === null || req === void 0 ? void 0 : req.id) || (0, id_utils_1.uuid)(),
+                requestId: err?.requestId || req?.id || (0, id_utils_1.uuid)(),
                 status,
                 path: req.originalUrl || req.url
             };
-            if (includeDetails && (err === null || err === void 0 ? void 0 : err.stack)) {
+            if (includeDetails && err?.stack) {
                 result.stack = err.stack.split('\n').map((line) => line.trim());
             }
             return res.status(status).json(result);
@@ -201,7 +201,7 @@ function errorHandler(options) {
         // Handle any other errors
         return res
             .status(status)
-            .json((0, response_utils_1.createFinalErrorResponse)(req, status, (err === null || err === void 0 ? void 0 : err.message) || 'Internal Server Error', err, { includeDetails }));
+            .json((0, response_utils_1.createFinalErrorResponse)(req, status, err?.message || 'Internal Server Error', err, { includeDetails }));
     };
 }
 /**
@@ -214,9 +214,9 @@ function errorHandler(options) {
  * @returns {Middleware} Express-compatible middleware
  */
 function healthCheck(options) {
-    const path = (options === null || options === void 0 ? void 0 : options.path) || '/healthz';
-    const checks = (options === null || options === void 0 ? void 0 : options.checks) || [];
-    const detailed = (options === null || options === void 0 ? void 0 : options.detailed) !== false;
+    const path = options?.path || '/healthz';
+    const checks = options?.checks || [];
+    const detailed = options?.detailed !== false;
     return async (req, res, next) => {
         if (req.path !== path)
             return next();
@@ -229,7 +229,7 @@ function healthCheck(options) {
                 if (!result)
                     allHealthy = false;
             }
-            catch (_a) {
+            catch {
                 results[check.name] = false;
                 allHealthy = false;
             }
@@ -241,4 +241,3 @@ function healthCheck(options) {
         res.status(status).json(response);
     };
 }
-//# sourceMappingURL=middleware.utils.js.map

package/build/{esnext → cjs}/utils/obj.utils.d.ts

@@ -121,4 +121,3 @@ export declare function isObject(value: unknown): value is Record<string, any>;
  * @returns {string[]} Array of all paths in dot notation.
  */
 export declare function getAllPaths(obj: Record<string, any>, parentPath?: string): string[];
-//# sourceMappingURL=obj.utils.d.ts.map

package/build/{src → cjs}/utils/obj.utils.js

@@ -271,7 +271,7 @@ function getValueByPath(obj, path) {
         .replace(/\[(\d+)\]/g, '.$1') // convert [0] to .0
         .split('.')
         .filter(Boolean); // remove empty strings
-    return parts.reduce((acc, key) => acc === null || acc === void 0 ? void 0 : acc[key], obj);
+    return parts.reduce((acc, key) => acc?.[key], obj);
 }
 /**
  * Sets a value at a deeply nested key in an object using dot/bracket notation path.
@@ -426,4 +426,3 @@ function getAllPaths(obj, parentPath = '') {
         return [currentPath];
     });
 }
-//# sourceMappingURL=obj.utils.js.map

package/build/{src → cjs}/utils/performance.utils.d.ts

@@ -133,4 +133,3 @@ export declare function trackMemoryUsage<T>(fn: () => T, options?: {
         diff: Record<string, number>;
     };
 };
-//# sourceMappingURL=performance.utils.d.ts.map

package/build/{src → cjs}/utils/performance.utils.js

@@ -168,16 +168,19 @@ function timed(options = {}) {
         // ESNext decorator: second argument is context object
         if (typeof propertyKeyOrContext === 'object' && propertyKeyOrContext !== null && 'name' in propertyKeyOrContext) {
             propertyKey = propertyKeyOrContext.name;
-            actualDescriptor = descriptor !== null && descriptor !== void 0 ? descriptor : Object.getOwnPropertyDescriptor(target, propertyKey);
+            actualDescriptor = descriptor ?? Object.getOwnPropertyDescriptor(target, propertyKey);
         }
         else {
             // Legacy decorator: second argument is property key
             propertyKey = propertyKeyOrContext;
-            actualDescriptor = descriptor !== null && descriptor !== void 0 ? descriptor : Object.getOwnPropertyDescriptor(target, propertyKey);
+            actualDescriptor = descriptor ?? Object.getOwnPropertyDescriptor(target, propertyKey);
         }
         const originalMethod = actualDescriptor.value;
         actualDescriptor.value = function (...args) {
-            const methodOptions = Object.assign(Object.assign({}, options), { label: options.label || `${target.constructor.name}.${String(propertyKey)}` });
+            const methodOptions = {
+                ...options,
+                label: options.label || `${target.constructor.name}.${String(propertyKey)}`
+            };
             if (originalMethod.constructor.name === 'AsyncFunction') {
                 return timeAsync(() => originalMethod.apply(this, args), methodOptions).then(({ result }) => result);
             }
@@ -275,4 +278,3 @@ function trackMemoryUsage(fn, options = {}) {
         }
     };
 }
-//# sourceMappingURL=performance.utils.js.map

package/build/{esnext → cjs}/utils/request.utils.d.ts

@@ -83,4 +83,3 @@ export declare function extractSortParams(query: Record<string, string | string[
  * @returns Object containing the filters as key-value pairs
  */
 export declare function extractFilterParams(query: Record<string, string | string[]>, allowedFilters: string[]): Record<string, string | string[]>;
-//# sourceMappingURL=request.utils.d.ts.map

package/build/{src → cjs}/utils/request.utils.js

@@ -43,9 +43,14 @@ const getPaginationParams = (req) => {
     const { sortBy, sortOrder } = extractSortParams(query, []);
     // Optional search param
     const search = typeof query.search === 'string' ? query.search : undefined;
-    return Object.assign(Object.assign({}, query), { page,
+    return {
+        ...query,
+        page,
         limit,
-        sortBy, sortOrder: sortOrder, search });
+        sortBy,
+        sortOrder: sortOrder,
+        search
+    };
 };
 exports.getPaginationParams = getPaginationParams;
 /**
@@ -192,4 +197,3 @@ function extractFilterParams(query, allowedFilters) {
     }
     return filters;
 }
-//# sourceMappingURL=request.utils.js.map

package/build/{esnext → cjs}/utils/response.utils.d.ts

@@ -160,4 +160,3 @@ export declare function createPaginatedResponse<T>(allItems: T[], page: number,
  * @param {SuccessResponse<any> | ErrorResponse | RedirectResponse} apiResponse - API response instance.
  */
 export declare function sendResponse(res: any, apiResponse: SuccessResponse<any> | ErrorResponse | RedirectResponse): void;
-//# sourceMappingURL=response.utils.d.ts.map

package/build/{src → cjs}/utils/response.utils.js

@@ -39,6 +39,16 @@ const id_utils_1 = require("./id.utils");
  * @typeParam T - The shape of the data returned in the response.
  */
 class SuccessResponse {
+    /** Message describing the result of the operation. */
+    message = 'Success';
+    /** Whether the response is an error. Always false in success responses. */
+    error = false;
+    /** The payload returned from the API. */
+    data = null;
+    /** Timestamp when the response was generated, in ISO format. */
+    timestamp = new Date().toISOString();
+    /** Unique identifier for this response, useful for request tracing. */
+    requestId = (0, context_store_utils_1.getRequestId)() ?? (0, id_utils_1.uuid)();
     /**
      * Constructs a new success response.
      *
@@ -46,20 +56,9 @@ class SuccessResponse {
      * @param {T} [data] - Optional data payload.
      */
     constructor(message, data) {
-        var _a;
-        /** Message describing the result of the operation. */
-        this.message = 'Success';
-        /** Whether the response is an error. Always false in success responses. */
-        this.error = false;
-        /** The payload returned from the API. */
-        this.data = null;
-        /** Timestamp when the response was generated, in ISO format. */
-        this.timestamp = new Date().toISOString();
-        /** Unique identifier for this response, useful for request tracing. */
-        this.requestId = (_a = (0, context_store_utils_1.getRequestId)()) !== null && _a !== void 0 ? _a : (0, id_utils_1.uuid)();
         if (message)
             this.message = message;
-        this.data = data !== null && data !== void 0 ? data : null;
+        this.data = data ?? null;
     }
 }
 exports.SuccessResponse = SuccessResponse;
@@ -68,6 +67,14 @@ exports.SuccessResponse = SuccessResponse;
  * Implements `ApiResponse` but omits the `data` field (which should not be present in errors).
  */
 class ErrorResponse extends Error {
+    /** HTTP status code associated with the error (e.g., 404, 500). */
+    status;
+    /** Indicates that this is an error. Always true. */
+    error = true;
+    /** Timestamp when the error occurred, in ISO format. */
+    timestamp = new Date().toISOString();
+    /** Unique identifier for this error instance. */
+    requestId = (0, context_store_utils_1.getRequestId)() ?? (0, id_utils_1.uuid)();
     /**
      * Constructs a new error response.
      *
@@ -75,14 +82,7 @@ class ErrorResponse extends Error {
      * @param {number} [status=500] - Optional HTTP status code (defaults to 500).
      */
     constructor(message, status = 500) {
-        var _a;
         super(message);
-        /** Indicates that this is an error. Always true. */
-        this.error = true;
-        /** Timestamp when the error occurred, in ISO format. */
-        this.timestamp = new Date().toISOString();
-        /** Unique identifier for this error instance. */
-        this.requestId = (_a = (0, context_store_utils_1.getRequestId)()) !== null && _a !== void 0 ? _a : (0, id_utils_1.uuid)();
         this.status = status;
         this.name = this.constructor.name;
         Error.captureStackTrace(this, this.constructor);
@@ -96,6 +96,18 @@ exports.ErrorResponse = ErrorResponse;
  * @typeParam T - The shape of each item in the paginated collection.
  */
 class PaginatedResponse extends SuccessResponse {
+    /** Total number of items across all pages */
+    total;
+    /** Current page number (1-based) */
+    page;
+    /** Number of items per page */
+    pageSize;
+    /** Total number of pages */
+    totalPages;
+    /** Whether there's a next page available */
+    hasNext;
+    /** Whether there's a previous page available */
+    hasPrevious;
     /**
      * Constructs a new paginated response.
      *
@@ -135,6 +147,14 @@ exports.NoContentResponse = NoContentResponse;
  * Specialized response for redirects.
  */
 class RedirectResponse {
+    /** The URL to redirect to */
+    redirectUrl;
+    /** HTTP status code for the redirect (301, 302, 303, 307, 308) */
+    statusCode;
+    /** Whether the response is a redirect */
+    isRedirect = true;
+    /** Unique identifier for this response */
+    requestId = (0, context_store_utils_1.getRequestId)() ?? (0, id_utils_1.uuid)();
     /**
      * Constructs a new redirect response.
      *
@@ -142,11 +162,6 @@ class RedirectResponse {
      * @param {number} [statusCode=302] - HTTP status code for the redirect.
      */
     constructor(url, statusCode = 302) {
-        var _a;
-        /** Whether the response is a redirect */
-        this.isRedirect = true;
-        /** Unique identifier for this response */
-        this.requestId = (_a = (0, context_store_utils_1.getRequestId)()) !== null && _a !== void 0 ? _a : (0, id_utils_1.uuid)();
         this.redirectUrl = url;
         this.statusCode = statusCode;
     }
@@ -185,17 +200,17 @@ function createErrorResponse(message, statusCode = 500) {
  */
 function createFinalErrorResponse(req, status, message, error, options) {
     const isDev = env_utils_1.Env.isDev();
-    const includeDetails = (options === null || options === void 0 ? void 0 : options.includeDetails) && isDev;
+    const includeDetails = options?.includeDetails && isDev;
     const response = {
         error: true,
         message,
         timestamp: new Date().toISOString(),
-        requestId: (error === null || error === void 0 ? void 0 : error.requestId) || (req === null || req === void 0 ? void 0 : req.id) || (0, id_utils_1.uuid)(),
+        requestId: error?.requestId || req?.id || (0, id_utils_1.uuid)(),
         status,
         path: req.originalUrl || req.url
     };
     // Include stack trace in development mode if requested
-    if (includeDetails && (error === null || error === void 0 ? void 0 : error.stack)) {
+    if (includeDetails && error?.stack) {
         response.stack = error.stack.split('\n').map((line) => line.trim());
     }
     return response;
@@ -257,4 +272,3 @@ function sendResponse(res, apiResponse) {
     }
     res.status(200).json(successResponse);
 }
-//# sourceMappingURL=response.utils.js.map

package/build/{esnext → cjs}/utils/stream.utils.d.ts

@@ -85,4 +85,3 @@ export declare function createLineStream(options?: {
     encoding?: BufferEncoding;
     includeNewlines?: boolean;
 }): Transform;
-//# sourceMappingURL=stream.utils.d.ts.map

package/build/{src → cjs}/utils/stream.utils.js

@@ -215,4 +215,3 @@ function createLineStream(options = {}) {
         }
     });
 }
-//# sourceMappingURL=stream.utils.js.map

package/build/{esnext → cjs}/utils/string.utils.d.ts

@@ -90,4 +90,3 @@ export declare function reverse(str: string): string;
  * @returns {number} Number of occurrences.
  */
 export declare function countOccurrences(str: string, substring: string, caseSensitive?: boolean): number;
-//# sourceMappingURL=string.utils.d.ts.map

package/build/{src → cjs}/utils/string.utils.js

@@ -176,4 +176,3 @@ function countOccurrences(str, substring, caseSensitive = true) {
     }
     return str.split(substring).length - 1;
 }
-//# sourceMappingURL=string.utils.js.map

package/build/{src → cjs}/utils/type.utils.d.ts

@@ -87,4 +87,3 @@ export declare function toBool(value: unknown, defaultValue?: boolean): boolean;
  * ```
  */
 export declare function ensureType<T>(value: unknown, expectedType: string, defaultValue: T): T;
-//# sourceMappingURL=type.utils.d.ts.map

package/build/{src → cjs}/utils/type.utils.js

@@ -122,7 +122,7 @@ function toStr(value, defaultValue = '') {
         }
         return String(value);
     }
-    catch (_a) {
+    catch {
         return defaultValue;
     }
 }
@@ -142,7 +142,7 @@ function toNum(value, defaultValue = 0) {
         const num = Number(value);
         return isNaN(num) ? defaultValue : num;
     }
-    catch (_a) {
+    catch {
         return defaultValue;
     }
 }
@@ -193,4 +193,3 @@ function ensureType(value, expectedType, defaultValue) {
     }
     return defaultValue;
 }
-//# sourceMappingURL=type.utils.js.map

package/build/{src → cjs}/utils/url.utils.d.ts

@@ -138,4 +138,3 @@ export declare function getExtension(url: string): string;
  * // → { page: 2, q: 'test' }
  */
 export declare function parseTypedQueryParams<T extends Record<string, any>>(url: string, converters?: Record<keyof T, (val: string) => any>): Partial<T>;
-//# sourceMappingURL=url.utils.d.ts.map