@catbee/utils 2.0.0-next.0 → 2.0.0-next.1

package/fs/index.mjs

@@ -22,8 +22,8 @@
  * SOFTWARE.
  */
 
-import { createReadStream, createWriteStream } from 'fs';
-import fs from 'fs/promises';
+import fs from 'fs';
+import fsp from 'fs/promises';
 import { tmpdir } from 'os';
 import path from 'path';
 import { pipeline } from 'stream/promises';
@@ -33,7 +33,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 async function fileExists(path2) {
   try {
-    await fs.access(path2);
+    await fsp.access(path2);
     return true;
   } catch {
     return false;
@@ -42,7 +42,7 @@ async function fileExists(path2) {
 __name(fileExists, "fileExists");
 async function readJsonFile(path2) {
   try {
-    const data = await fs.readFile(path2, "utf-8");
+    const data = await fsp.readFile(path2, "utf-8");
     return JSON.parse(data);
   } catch {
     return null;
@@ -56,12 +56,12 @@ async function readJsonOrDefault(path2, defaultValue) {
 __name(readJsonOrDefault, "readJsonOrDefault");
 async function writeJsonFile(path2, data, space = 2) {
   const json = JSON.stringify(data, null, space);
-  await fs.writeFile(path2, json, "utf-8");
+  await fsp.writeFile(path2, json, "utf-8");
 }
 __name(writeJsonFile, "writeJsonFile");
 async function deleteFileIfExists(path2) {
   try {
-    await fs.unlink(path2);
+    await fsp.unlink(path2);
     return true;
   } catch (err) {
     if (err.code === "ENOENT") return true;
@@ -69,36 +69,66 @@ async function deleteFileIfExists(path2) {
   }
 }
 __name(deleteFileIfExists, "deleteFileIfExists");
-async function readTextFile(path2, encoding = "utf-8") {
+async function readFile(path2, encoding = "utf-8") {
+  return await fsp.readFile(path2, encoding);
+}
+__name(readFile, "readFile");
+function readFileSync(path2, encoding = "utf-8") {
+  return fs.readFileSync(path2, encoding);
+}
+__name(readFileSync, "readFileSync");
+async function safeReadFile(path2, encoding = "utf-8") {
   try {
-    return await fs.readFile(path2, encoding);
-  } catch {
-    return null;
+    const data = await fsp.readFile(path2, encoding);
+    return {
+      data,
+      error: null
+    };
+  } catch (error) {
+    return {
+      data: null,
+      error: new Error(`Failed to read file ${path2}: ${error.message}`)
+    };
+  }
+}
+__name(safeReadFile, "safeReadFile");
+function safeReadFileSync(path2, encoding = "utf-8") {
+  try {
+    const data = fs.readFileSync(path2, encoding);
+    return {
+      data,
+      error: null
+    };
+  } catch (error) {
+    return {
+      data: null,
+      error: new Error(`Failed to read file ${path2}: ${error.message}`)
+    };
   }
 }
-__name(readTextFile, "readTextFile");
-async function writeTextFile(path2, content, encoding = "utf-8") {
+__name(safeReadFileSync, "safeReadFileSync");
+async function writeFile(path2, content, encoding = "utf-8") {
   try {
-    await fs.writeFile(path2, content, encoding);
+    await fsp.writeFile(path2, content, encoding);
     return true;
   } catch {
     return false;
   }
 }
-__name(writeTextFile, "writeTextFile");
-async function appendTextFile(path2, content, encoding = "utf-8") {
+__name(writeFile, "writeFile");
+async function appendFile(path2, content, encoding = "utf-8") {
   try {
-    await fs.appendFile(path2, content, encoding);
+    await fsp.appendFile(path2, content, encoding);
     return true;
   } catch {
     return false;
   }
 }
-__name(appendTextFile, "appendTextFile");
+__name(appendFile, "appendFile");
 async function copyFile(source, destination, overwrite = false) {
   try {
-    const flags = overwrite ? 0 : fs.constants.COPYFILE_EXCL;
-    await fs.copyFile(source, destination, flags);
+    const flags = overwrite ? 0 : fsp.constants.COPYFILE_EXCL;
+    await fsp.copyFile(source, destination, flags);
     return true;
   } catch {
     return false;
@@ -107,12 +137,12 @@ async function copyFile(source, destination, overwrite = false) {
 __name(copyFile, "copyFile");
 async function moveFile(oldPath, newPath) {
   try {
-    await fs.rename(oldPath, newPath);
+    await fsp.rename(oldPath, newPath);
     return true;
   } catch {
     try {
-      await fs.copyFile(oldPath, newPath);
-      await fs.unlink(oldPath);
+      await fsp.copyFile(oldPath, newPath);
+      await fsp.unlink(oldPath);
       return true;
     } catch {
       return false;
@@ -122,7 +152,7 @@ async function moveFile(oldPath, newPath) {
 __name(moveFile, "moveFile");
 async function getFileStats(path2) {
   try {
-    return await fs.stat(path2);
+    return await fsp.stat(path2);
   } catch {
     return null;
   }
@@ -133,16 +163,16 @@ async function createTempFile({ prefix = "tmp-", extension = "", dir = tmpdir(),
   const filename = `${prefix}${randomUUID()}${ext}`;
   const filepath = path.join(dir, filename);
   if (content) {
-    await fs.writeFile(filepath, content);
+    await fsp.writeFile(filepath, content);
   } else {
-    await fs.writeFile(filepath, "");
+    await fsp.writeFile(filepath, "");
   }
   return filepath;
 }
 __name(createTempFile, "createTempFile");
 async function streamFile(source, destination) {
-  const readStream = createReadStream(source);
-  const writeStream = createWriteStream(destination);
+  const readStream = fs.createReadStream(source);
+  const writeStream = fs.createWriteStream(destination);
   try {
     await pipeline(readStream, writeStream);
   } catch (error) {
@@ -153,7 +183,7 @@ async function streamFile(source, destination) {
 }
 __name(streamFile, "streamFile");
 async function readDirectory(dirPath, options = {}) {
-  const files = await fs.readdir(dirPath);
+  const files = await fsp.readdir(dirPath);
   let result = files;
   if (options.filter) {
     result = result.filter((file) => options.filter.test(file));
@@ -166,7 +196,7 @@ async function readDirectory(dirPath, options = {}) {
 __name(readDirectory, "readDirectory");
 async function createDirectory(dirPath, recursive = true) {
   try {
-    await fs.mkdir(dirPath, {
+    await fsp.mkdir(dirPath, {
       recursive
     });
     return true;
@@ -177,7 +207,7 @@ async function createDirectory(dirPath, recursive = true) {
 __name(createDirectory, "createDirectory");
 async function safeReadJsonFile(path2) {
   try {
-    const content = await fs.readFile(path2, "utf-8");
+    const content = await fsp.readFile(path2, "utf-8");
     try {
       const data = JSON.parse(content);
       return {
@@ -200,7 +230,7 @@ async function safeReadJsonFile(path2) {
 __name(safeReadJsonFile, "safeReadJsonFile");
 async function isFile(path2) {
   try {
-    const stat = await fs.stat(path2);
+    const stat = await fsp.stat(path2);
     return stat.isFile();
   } catch {
     return false;
@@ -209,7 +239,7 @@ async function isFile(path2) {
 __name(isFile, "isFile");
 async function getFileSize(path2) {
   try {
-    const stat = await fs.stat(path2);
+    const stat = await fsp.stat(path2);
     return stat.size;
   } catch {
     return -1;
@@ -218,11 +248,11 @@ async function getFileSize(path2) {
 __name(getFileSize, "getFileSize");
 async function readFileBuffer(path2) {
   try {
-    return await fs.readFile(path2);
+    return await fsp.readFile(path2);
   } catch {
     return null;
   }
 }
 __name(readFileBuffer, "readFileBuffer");
 
-export { appendTextFile, copyFile, createDirectory, createTempFile, deleteFileIfExists, fileExists, getFileSize, getFileStats, isFile, moveFile, readDirectory, readFileBuffer, readJsonFile, readJsonOrDefault, readTextFile, safeReadJsonFile, streamFile, writeJsonFile, writeTextFile };
+export { appendFile, copyFile, createDirectory, createTempFile, deleteFileIfExists, fileExists, getFileSize, getFileStats, isFile, moveFile, readDirectory, readFile, readFileBuffer, readFileSync, readJsonFile, readJsonOrDefault, safeReadFile, safeReadFileSync, safeReadJsonFile, streamFile, writeFile, writeJsonFile };

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

@@ -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/id/index.d.ts

@@ -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/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");
 
 
 
@@ -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

@@ -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

@@ -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

@@ -158,8 +158,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 +175,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 +209,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
       }
     }));