@catbee/utils 2.0.0-next.0 → 2.0.0

package/http-status-codes/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -22,4 +22,270 @@
  * SOFTWARE.
  */
 
-export * from './http-status-codes';
+/**
+ * Complete HTTP status codes enum with descriptions.
+ * For use with API responses and error handling.
+ */
+declare enum HttpStatusCodes {
+    /**
+     * The server has received the request headers and the client should proceed to send the request body.
+     */
+    CONTINUE = 100,
+    /**
+     * The server is switching protocols according to the client's request.
+     */
+    SWITCHING_PROTOCOLS = 101,
+    /**
+     * Server has received the request and is still processing it.
+     */
+    PROCESSING = 102,
+    /**
+     * The server is sending preliminary headers while preparing the final response.
+     */
+    EARLY_HINTS = 103,
+    /**
+     * The request succeeded. The result meaning depends on the HTTP method used.
+     */
+    OK = 200,
+    /**
+     * The request succeeded and a new resource was created as a result.
+     */
+    CREATED = 201,
+    /**
+     * The request has been received but not yet acted upon.
+     */
+    ACCEPTED = 202,
+    /**
+     * The returned information is from a third-party source, not the origin server.
+     */
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    /**
+     * The request succeeded but there's no content to send in the response.
+     */
+    NO_CONTENT = 204,
+    /**
+     * The client should reset the document view that caused this request.
+     */
+    RESET_CONTENT = 205,
+    /**
+     * The server is delivering only part of the resource due to a range header sent by the client.
+     */
+    PARTIAL_CONTENT = 206,
+    /**
+     * Conveys information about multiple resources, for complex operations.
+     */
+    MULTI_STATUS = 207,
+    /**
+     * The members of a DAV binding have already been enumerated and are not included in the response.
+     */
+    ALREADY_REPORTED = 208,
+    /**
+     * The server has fulfilled a request for the resource, and the response represents the result of one or more instance-manipulations.
+     */
+    IM_USED = 226,
+    /**
+     * The request has more than one possible response and the client should choose one.
+     */
+    MULTIPLE_CHOICES = 300,
+    /**
+     * The resource has been permanently moved to a new URL.
+     */
+    MOVED_PERMANENTLY = 301,
+    /**
+     * The resource has been temporarily moved to another URL.
+     */
+    MOVED_TEMPORARILY = 302,
+    /**
+     * The response to the request can be found under another URI using the GET method.
+     */
+    SEE_OTHER = 303,
+    /**
+     * The resource hasn't been modified since the last request.
+     */
+    NOT_MODIFIED = 304,
+    /**
+     * @deprecated
+     * Response must be accessed through a proxy.
+     */
+    USE_PROXY = 305,
+    /**
+     * The resource is temporarily available at a different URI, using the same HTTP method.
+     */
+    TEMPORARY_REDIRECT = 307,
+    /**
+     * The resource has been permanently moved to another URL, using the same HTTP method.
+     */
+    PERMANENT_REDIRECT = 308,
+    /**
+     * The server cannot process the request due to a client error (malformed request).
+     */
+    BAD_REQUEST = 400,
+    /**
+     * Authentication is required and has failed or not been provided.
+     */
+    UNAUTHORIZED = 401,
+    /**
+     * Reserved for future use, originally intended for digital payment systems.
+     */
+    PAYMENT_REQUIRED = 402,
+    /**
+     * The client doesn't have permission to access the requested resource.
+     */
+    FORBIDDEN = 403,
+    /**
+     * The requested resource could not be found on the server.
+     */
+    NOT_FOUND = 404,
+    /**
+     * The request method is not supported for the requested resource.
+     */
+    METHOD_NOT_ALLOWED = 405,
+    /**
+     * The server can't provide a response matching the list of acceptable values in the client's headers.
+     */
+    NOT_ACCEPTABLE = 406,
+    /**
+     * Authentication by a proxy is required.
+     */
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    /**
+     * The server timed out waiting for the request.
+     */
+    REQUEST_TIMEOUT = 408,
+    /**
+     * The request conflicts with the current state of the server.
+     */
+    CONFLICT = 409,
+    /**
+     * The resource has been permanently deleted with no forwarding address.
+     */
+    GONE = 410,
+    /**
+     * The server requires a Content-Length header field.
+     */
+    LENGTH_REQUIRED = 411,
+    /**
+     * Preconditions in the client's headers failed.
+     */
+    PRECONDITION_FAILED = 412,
+    /**
+     * Request entity is larger than limits defined by server.
+     */
+    REQUEST_TOO_LONG = 413,
+    /**
+     * The request payload exceeds server size limits.
+     * Modern equivalent of REQUEST_TOO_LONG.
+     */
+    PAYLOAD_TOO_LARGE = 413,
+    /**
+     * The URI requested is too long for the server to interpret.
+     */
+    REQUEST_URI_TOO_LONG = 414,
+    /**
+     * The server does not support the media type requested by the client.
+     */
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    /**
+     * The range specified by the Range header cannot be fulfilled.
+     */
+    REQUESTED_RANGE_NOT_SATISFIABLE = 416,
+    /**
+     * The server cannot meet the expectations given in the Expect header.
+     */
+    EXPECTATION_FAILED = 417,
+    /**
+     * The server refuses to brew coffee because it is a teapot. (April Fools' joke)
+     */
+    IM_A_TEAPOT = 418,
+    /**
+     * The server cannot store the representation needed to complete the request.
+     */
+    INSUFFICIENT_SPACE_ON_RESOURCE = 419,
+    /**
+     * @deprecated
+     * A method has failed - specific to Spring Framework.
+     */
+    METHOD_FAILURE = 420,
+    /**
+     * The server cannot produce a response for the requested URI scheme and authority.
+     */
+    MISDIRECTED_REQUEST = 421,
+    /**
+     * The request was well-formed but has semantic errors preventing processing.
+     */
+    UNPROCESSABLE_ENTITY = 422,
+    /**
+     * The requested resource is locked against access.
+     */
+    LOCKED = 423,
+    /**
+     * The request failed due to the failure of a previous request.
+     */
+    FAILED_DEPENDENCY = 424,
+    /**
+     * The client should switch to a different protocol.
+     */
+    UPGRADE_REQUIRED = 426,
+    /**
+     * The server requires conditional requests to prevent lost updates.
+     */
+    PRECONDITION_REQUIRED = 428,
+    /**
+     * The client has sent too many requests in a given time period (rate limiting).
+     */
+    TOO_MANY_REQUESTS = 429,
+    /**
+     * Request headers are too large for the server to process.
+     */
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    /**
+     * Resource cannot be legally provided (e.g., censored by government).
+     */
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    /**
+     * The server encountered an unexpected error preventing it from fulfilling the request.
+     */
+    INTERNAL_SERVER_ERROR = 500,
+    /**
+     * The server does not support the functionality required to fulfill the request.
+     */
+    NOT_IMPLEMENTED = 501,
+    /**
+     * The server, acting as a gateway, received an invalid response from an upstream server.
+     */
+    BAD_GATEWAY = 502,
+    /**
+     * The server is currently unable to handle the request due to temporary overload or maintenance.
+     */
+    SERVICE_UNAVAILABLE = 503,
+    /**
+     * The server, acting as a gateway, did not receive a timely response from an upstream server.
+     */
+    GATEWAY_TIMEOUT = 504,
+    /**
+     * The server does not support the HTTP protocol version used in the request.
+     */
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    /**
+     * Transparent content negotiation for the request resulted in circular reference.
+     */
+    VARIANT_ALSO_NEGOTIATES = 506,
+    /**
+     * The server cannot store the representation needed to complete the request.
+     */
+    INSUFFICIENT_STORAGE = 507,
+    /**
+     * The server detected an infinite loop while processing the request.
+     */
+    LOOP_DETECTED = 508,
+    /**
+     * Further extensions to the request are required for the server to fulfill it.
+     */
+    NOT_EXTENDED = 510,
+    /**
+     * The client needs to authenticate to gain network access.
+     */
+    NETWORK_AUTHENTICATION_REQUIRED = 511
+}
+
+export { HttpStatusCodes };

package/http-status-codes/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/id/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/id/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -22,4 +22,40 @@
  * SOFTWARE.
  */
 
-export * from './id.utils';
+/**
+ * Generates a UUID v4 string (RFC 4122).
+ *
+ * @returns {string} UUID v4 (e.g., 'c0de1234-5678-9abc-def0-123456789abc')
+ */
+declare function uuid(): string;
+/**
+ * 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.
+ */
+declare function nanoId(length?: number): string;
+/**
+ * Generates a cryptographically strong random hex string.
+ *
+ * @param {number} byteLength - Number of random bytes (default: 16 -> 32 hex chars).
+ * @returns {string} Random hex string.
+ */
+declare function randomHex(byteLength?: number): string;
+/**
+ * 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.
+ */
+declare function randomInt(min: number, max: number): number;
+/**
+ * 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).
+ */
+declare function randomBase64(byteLength?: number): string;
+
+export { nanoId, randomBase64, randomHex, randomInt, uuid };

package/id/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -33,8 +33,8 @@ var cache = require("./cache/index.cjs");
 var contextStore = require("./context-store/index.cjs");
 var crypto = require("./crypto/index.cjs");
 var date = require("./date/index.cjs");
-var decorators = require("./decorators/index.cjs");
-var dir = require("./dir/index.cjs");
+var decorator = require("./decorator/index.cjs");
+var directory = require("./directory/index.cjs");
 var env = require("./env/index.cjs");
 var exception = require("./exception/index.cjs");
 var fs = require("./fs/index.cjs");
@@ -42,7 +42,7 @@ var httpStatusCodes = require("./http-status-codes/index.cjs");
 var id = require("./id/index.cjs");
 var logger = require("./logger/index.cjs");
 var middleware = require("./middleware/index.cjs");
-var obj = require("./obj/index.cjs");
+var object = require("./object/index.cjs");
 var performance = require("./performance/index.cjs");
 var request = require("./request/index.cjs");
 var response = require("./response/index.cjs");
@@ -50,7 +50,7 @@ var stream = require("./stream/index.cjs");
 var string = require("./string/index.cjs");
 var type = require("./type/index.cjs");
 var url = require("./url/index.cjs");
-var validate = require("./validate/index.cjs");
+var validation = require("./validation/index.cjs");
 
 
 
@@ -108,16 +108,16 @@ Object.keys(date).forEach(function (k) {
 		get: function () { return date[k]; }
 	});
 });
-Object.keys(decorators).forEach(function (k) {
+Object.keys(decorator).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return decorators[k]; }
+		get: function () { return decorator[k]; }
 	});
 });
-Object.keys(dir).forEach(function (k) {
+Object.keys(directory).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return dir[k]; }
+		get: function () { return directory[k]; }
 	});
 });
 Object.keys(env).forEach(function (k) {
@@ -162,10 +162,10 @@ Object.keys(middleware).forEach(function (k) {
 		get: function () { return middleware[k]; }
 	});
 });
-Object.keys(obj).forEach(function (k) {
+Object.keys(object).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return obj[k]; }
+		get: function () { return object[k]; }
 	});
 });
 Object.keys(performance).forEach(function (k) {
@@ -210,9 +210,9 @@ Object.keys(url).forEach(function (k) {
 		get: function () { return url[k]; }
 	});
 });
-Object.keys(validate).forEach(function (k) {
+Object.keys(validation).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
-		get: function () { return validate[k]; }
+		get: function () { return validation[k]; }
 	});
 });

package/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -31,8 +31,8 @@ export * from './cache';
 export * from './context-store';
 export * from './crypto';
 export * from './date';
-export * from './decorators';
-export * from './dir';
+export * from './decorator';
+export * from './directory';
 export * from './env';
 export * from './exception';
 export * from './fs';
@@ -40,7 +40,7 @@ export * from './http-status-codes';
 export * from './id';
 export * from './logger';
 export * from './middleware';
-export * from './obj';
+export * from './object';
 export * from './performance';
 export * from './request';
 export * from './response';
@@ -48,4 +48,4 @@ export * from './stream';
 export * from './string';
 export * from './type';
 export * from './url';
-export * from './validate';
+export * from './validation';

package/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -31,8 +31,8 @@ export * from "./cache/index.mjs";
 export * from "./context-store/index.mjs";
 export * from "./crypto/index.mjs";
 export * from "./date/index.mjs";
-export * from "./decorators/index.mjs";
-export * from "./dir/index.mjs";
+export * from "./decorator/index.mjs";
+export * from "./directory/index.mjs";
 export * from "./env/index.mjs";
 export * from "./exception/index.mjs";
 export * from "./fs/index.mjs";
@@ -40,7 +40,7 @@ export * from "./http-status-codes/index.mjs";
 export * from "./id/index.mjs";
 export * from "./logger/index.mjs";
 export * from "./middleware/index.mjs";
-export * from "./obj/index.mjs";
+export * from "./object/index.mjs";
 export * from "./performance/index.mjs";
 export * from "./request/index.mjs";
 export * from "./response/index.mjs";
@@ -48,4 +48,4 @@ export * from "./stream/index.mjs";
 export * from "./string/index.mjs";
 export * from "./type/index.mjs";
 export * from "./url/index.mjs";
-export * from "./validate/index.mjs";
+export * from "./validation/index.mjs";

package/logger/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -133,9 +133,7 @@ function addRedactFields(fields) {
 __name(addRedactFields, "addRedactFields");
 var cachedExpandedFields = null;
 function getExpandedSensitiveFields() {
-  if (!cachedExpandedFields) {
-    cachedExpandedFields = expandSensitiveFields(defaultSensitiveFields);
-  }
+  cachedExpandedFields ??= expandSensitiveFields(defaultSensitiveFields);
   return cachedExpandedFields;
 }
 __name(getExpandedSensitiveFields, "getExpandedSensitiveFields");
@@ -158,8 +156,8 @@ function setupLogger(isGlobal = true) {
     ...sensitiveFields.flatMap((field) => generateDeepPaths(field, 2))
   ]);
   const logParams = {
-    name: config.defaultCatbeeConfig.logger?.name || "@catbee/utils",
-    level: config.defaultCatbeeConfig.logger?.level || "info",
+    name: config.getCatbeeGlobalConfig().logger?.name || "@catbee/utils",
+    level: config.getCatbeeGlobalConfig().logger?.level || "info",
     redact: {
       paths: Array.from(paths),
       censor: /* @__PURE__ */ __name((value, path) => redact(value, path), "censor")
@@ -175,25 +173,25 @@ function setupLogger(isGlobal = true) {
     timestamp: pino.stdTimeFunctions.isoTime
   };
   let logger;
-  const logDir = config.defaultCatbeeConfig.logger?.dir?.trim();
+  const logDir = config.getCatbeeGlobalConfig().logger?.dir?.trim();
   const hasFileLogging = Boolean(logDir);
-  if (hasFileLogging && config.defaultCatbeeConfig.logger?.pretty) {
+  if (hasFileLogging && config.getCatbeeGlobalConfig().logger?.pretty) {
     logger = pino__default.default(logParams, pino__default.default.transport({
       targets: [
         {
           target: "pino-pretty",
-          level: config.defaultCatbeeConfig.logger?.level ?? "info",
+          level: config.getCatbeeGlobalConfig().logger?.level ?? "info",
           options: {
-            colorize: config.defaultCatbeeConfig.logger?.colorize,
+            colorize: config.getCatbeeGlobalConfig().logger?.colorize,
             translateTime: "SYS:standard",
             ignore: "pid,hostname",
-            singleLine: config.defaultCatbeeConfig.logger?.singleLine,
+            singleLine: config.getCatbeeGlobalConfig().logger?.singleLine,
             levelFirst: true
           }
         },
         {
           target: "pino/file",
-          level: config.defaultCatbeeConfig.logger?.level ?? "info",
+          level: config.getCatbeeGlobalConfig().logger?.level ?? "info",
           options: {
             destination: `${logDir}/app.log`,
             mkdir: true
@@ -209,14 +207,14 @@ function setupLogger(isGlobal = true) {
         mkdir: true
       }
     }));
-  } else if (config.defaultCatbeeConfig.logger?.pretty) {
+  } else if (config.getCatbeeGlobalConfig().logger?.pretty) {
     logger = pino__default.default(logParams, pino__default.default.transport({
       target: "pino-pretty",
       options: {
-        colorize: config.defaultCatbeeConfig.logger?.colorize,
+        colorize: config.getCatbeeGlobalConfig().logger?.colorize,
         translateTime: "SYS:standard",
         ignore: "pid,hostname",
-        singleLine: config.defaultCatbeeConfig.logger?.singleLine,
+        singleLine: config.getCatbeeGlobalConfig().logger?.singleLine,
         levelFirst: true
       }
     }));