@catbee/utils 2.0.0-next.1 → 2.0.1

package/{dir → directory}/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/{dir → directory}/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

package/{dir → directory}/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/env/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
@@ -85,9 +85,7 @@ var Env = class _Env {
   static set(key, value) {
     process.env[key] = value;
     this.cache.delete(key);
-    for (const cacheKey of [
-      ...this.cache.keys()
-    ]) {
+    for (const cacheKey of this.cache.keys()) {
       if (cacheKey.includes(`:${key}`)) {
         this.cache.delete(cacheKey);
       }
@@ -441,20 +439,33 @@ var Env = class _Env {
     if (!value) {
       throw new Error(`URL environment variable '${key}' is missing or empty`);
     }
-    let url;
+    const url = this.parseUrl(value, key);
+    this.validateProtocol(url, key, options);
+    this.validateHostname(url, key, options);
+    this.cache.set(cacheKey, value);
+    return value;
+  }
+  static parseUrl(value, key) {
     try {
-      url = new URL(value);
+      return new URL(value);
     } catch {
       throw new Error(`Environment variable '${key}' is not a valid URL: "${value}"`);
     }
+  }
+  static validateProtocol(url, key, options) {
     if (options.protocols && options.protocols.length > 0) {
       const protocol = url.protocol.replace(":", "");
       if (!options.protocols.includes(protocol)) {
         throw new Error(`Environment variable '${key}' must use one of the protocols: ${options.protocols.join(", ")}. Got: ${protocol}`);
       }
     }
+  }
+  static isIp(hostname) {
+    return /^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$/.test(hostname);
+  }
+  static validateHostname(url, key, options) {
     const { hostname } = url;
-    const isIp = /^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$/.test(hostname);
+    const isIp = _Env.isIp(hostname);
     const isLocalhost = hostname === "localhost";
     if (isIp && options.allowIp === false) {
       throw new Error(`Environment variable '${key}' cannot be an IP address: "${hostname}"`);
@@ -467,8 +478,6 @@ var Env = class _Env {
         throw new Error(`Environment variable '${key}' must have a valid host with TLD: "${hostname}"`);
       }
     }
-    this.cache.set(cacheKey, value);
-    return value;
   }
   /**
   * Retrieves an email environment variable and validates it.
@@ -651,63 +660,102 @@ var Env = class _Env {
       throw new Error(`Environment file not found: "${path}"`);
     }
     const content = fs.readFileSync(path, "utf8");
+    const variables = this.parseEnvContent(content);
+    for (const [k, v] of Object.entries(variables)) {
+      if (!process.env[k]) {
+        process.env[k] = v;
+      }
+    }
+    return variables;
+  }
+  static parseEnvContent(content) {
     const variables = {};
     const lines = content.split(/\r?\n/);
     let i = 0;
     while (i < lines.length) {
       let line = lines[i].trim();
-      if (!line || line.startsWith("#")) {
+      if (this.isCommentOrEmpty(line)) {
         i++;
         continue;
       }
-      const match = line.match(/^([^=]+)=(.*)$/);
+      const match = this.extractKeyValue(line);
       if (!match) {
         i++;
         continue;
       }
       const key = match[1].trim();
       let value = match[2].trim();
-      if (!/^['"]/.test(value)) {
-        const hashIndex = value.indexOf(" #");
-        if (hashIndex !== -1) {
-          value = value.slice(0, hashIndex).trim();
-        }
+      if (!this.isQuoted(value)) {
+        value = this.stripInlineComment(value);
       }
-      if ((value.startsWith('"') || value.startsWith("'")) && value.length > 1) {
-        const quote = value[0];
-        if (!value.endsWith(quote) || value.length === 1) {
-          let multilineValue = value.slice(1);
-          i++;
-          while (i < lines.length) {
-            const nextLine = lines[i];
-            if (nextLine.endsWith(quote)) {
-              multilineValue += "\n" + nextLine.slice(0, -1);
-              break;
-            } else {
-              multilineValue += "\n" + nextLine;
-            }
-            i++;
-          }
-          value = multilineValue;
-        } else {
-          value = value.slice(1, -1);
-        }
+      if (this.isQuoted(value) && value.length > 1) {
+        const result = this.parseQuotedValue(lines, i, value);
+        value = result.value;
+        i = result.nextIndex;
       } else {
-        i++;
-        while (i < lines.length && !lines[i].includes("=") && lines[i].trim() !== "") {
-          value += "\n" + lines[i];
-          i++;
-        }
-        i--;
+        const result = this.parseUnquotedMultiline(lines, i, value);
+        value = result.value;
+        i = result.nextIndex;
       }
       if (!process.env[key]) {
-        process.env[key] = value;
         variables[key] = value;
       }
       i++;
     }
     return variables;
   }
+  static isCommentOrEmpty(line) {
+    return !line || line.startsWith("#");
+  }
+  static extractKeyValue(line) {
+    return line.match(/^([^=]+)=(.*)$/);
+  }
+  static isQuoted(value) {
+    return /^['"]/.test(value);
+  }
+  static stripInlineComment(value) {
+    const hashIndex = value.indexOf(" #");
+    if (hashIndex !== -1) {
+      return value.slice(0, hashIndex).trim();
+    }
+    return value;
+  }
+  static parseQuotedValue(lines, currentIndex, value) {
+    const quote = value[0];
+    if (!value.endsWith(quote) || value.length === 1) {
+      let multilineValue = value.slice(1);
+      let i = currentIndex + 1;
+      while (i < lines.length) {
+        const nextLine = lines[i];
+        if (nextLine.endsWith(quote)) {
+          multilineValue += "\n" + nextLine.slice(0, -1);
+          break;
+        } else {
+          multilineValue += "\n" + nextLine;
+        }
+        i++;
+      }
+      return {
+        value: multilineValue,
+        nextIndex: i
+      };
+    }
+    return {
+      value: value.slice(1, -1),
+      nextIndex: currentIndex
+    };
+  }
+  static parseUnquotedMultiline(lines, currentIndex, value) {
+    let i = currentIndex + 1;
+    while (i < lines.length && !lines[i].includes("=") && lines[i].trim() !== "") {
+      value += "\n" + lines[i];
+      i++;
+    }
+    return {
+      value,
+      nextIndex: i - 1
+    };
+  }
   /**
   * Checks whether the specified environment variable exists.
   *

package/env/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
@@ -287,6 +287,10 @@ declare class Env {
      * });
      */
     static getUrl(key: string, defaultValue: string, options?: UrlOptions): string;
+    private static parseUrl;
+    private static validateProtocol;
+    private static isIp;
+    private static validateHostname;
     /**
      * Retrieves an email environment variable and validates it.
      *
@@ -378,6 +382,13 @@ declare class Env {
      * Env.loadFromFile('.env.development');
      */
     static loadFromFile(path?: string): Record<string, string>;
+    private static parseEnvContent;
+    private static isCommentOrEmpty;
+    private static extractKeyValue;
+    private static isQuoted;
+    private static stripInlineComment;
+    private static parseQuotedValue;
+    private static parseUnquotedMultiline;
     /**
      * Checks whether the specified environment variable exists.
      *

package/env/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
@@ -83,9 +83,7 @@ var Env = class _Env {
   static set(key, value) {
     process.env[key] = value;
     this.cache.delete(key);
-    for (const cacheKey of [
-      ...this.cache.keys()
-    ]) {
+    for (const cacheKey of this.cache.keys()) {
       if (cacheKey.includes(`:${key}`)) {
         this.cache.delete(cacheKey);
       }
@@ -439,20 +437,33 @@ var Env = class _Env {
     if (!value) {
       throw new Error(`URL environment variable '${key}' is missing or empty`);
     }
-    let url;
+    const url = this.parseUrl(value, key);
+    this.validateProtocol(url, key, options);
+    this.validateHostname(url, key, options);
+    this.cache.set(cacheKey, value);
+    return value;
+  }
+  static parseUrl(value, key) {
     try {
-      url = new URL(value);
+      return new URL(value);
     } catch {
       throw new Error(`Environment variable '${key}' is not a valid URL: "${value}"`);
     }
+  }
+  static validateProtocol(url, key, options) {
     if (options.protocols && options.protocols.length > 0) {
       const protocol = url.protocol.replace(":", "");
       if (!options.protocols.includes(protocol)) {
         throw new Error(`Environment variable '${key}' must use one of the protocols: ${options.protocols.join(", ")}. Got: ${protocol}`);
       }
     }
+  }
+  static isIp(hostname) {
+    return /^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$/.test(hostname);
+  }
+  static validateHostname(url, key, options) {
     const { hostname } = url;
-    const isIp = /^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$/.test(hostname);
+    const isIp = _Env.isIp(hostname);
     const isLocalhost = hostname === "localhost";
     if (isIp && options.allowIp === false) {
       throw new Error(`Environment variable '${key}' cannot be an IP address: "${hostname}"`);
@@ -465,8 +476,6 @@ var Env = class _Env {
         throw new Error(`Environment variable '${key}' must have a valid host with TLD: "${hostname}"`);
       }
     }
-    this.cache.set(cacheKey, value);
-    return value;
   }
   /**
   * Retrieves an email environment variable and validates it.
@@ -649,63 +658,102 @@ var Env = class _Env {
       throw new Error(`Environment file not found: "${path}"`);
     }
     const content = readFileSync(path, "utf8");
+    const variables = this.parseEnvContent(content);
+    for (const [k, v] of Object.entries(variables)) {
+      if (!process.env[k]) {
+        process.env[k] = v;
+      }
+    }
+    return variables;
+  }
+  static parseEnvContent(content) {
     const variables = {};
     const lines = content.split(/\r?\n/);
     let i = 0;
     while (i < lines.length) {
       let line = lines[i].trim();
-      if (!line || line.startsWith("#")) {
+      if (this.isCommentOrEmpty(line)) {
         i++;
         continue;
       }
-      const match = line.match(/^([^=]+)=(.*)$/);
+      const match = this.extractKeyValue(line);
       if (!match) {
         i++;
         continue;
       }
       const key = match[1].trim();
       let value = match[2].trim();
-      if (!/^['"]/.test(value)) {
-        const hashIndex = value.indexOf(" #");
-        if (hashIndex !== -1) {
-          value = value.slice(0, hashIndex).trim();
-        }
+      if (!this.isQuoted(value)) {
+        value = this.stripInlineComment(value);
       }
-      if ((value.startsWith('"') || value.startsWith("'")) && value.length > 1) {
-        const quote = value[0];
-        if (!value.endsWith(quote) || value.length === 1) {
-          let multilineValue = value.slice(1);
-          i++;
-          while (i < lines.length) {
-            const nextLine = lines[i];
-            if (nextLine.endsWith(quote)) {
-              multilineValue += "\n" + nextLine.slice(0, -1);
-              break;
-            } else {
-              multilineValue += "\n" + nextLine;
-            }
-            i++;
-          }
-          value = multilineValue;
-        } else {
-          value = value.slice(1, -1);
-        }
+      if (this.isQuoted(value) && value.length > 1) {
+        const result = this.parseQuotedValue(lines, i, value);
+        value = result.value;
+        i = result.nextIndex;
       } else {
-        i++;
-        while (i < lines.length && !lines[i].includes("=") && lines[i].trim() !== "") {
-          value += "\n" + lines[i];
-          i++;
-        }
-        i--;
+        const result = this.parseUnquotedMultiline(lines, i, value);
+        value = result.value;
+        i = result.nextIndex;
       }
       if (!process.env[key]) {
-        process.env[key] = value;
         variables[key] = value;
       }
       i++;
     }
     return variables;
   }
+  static isCommentOrEmpty(line) {
+    return !line || line.startsWith("#");
+  }
+  static extractKeyValue(line) {
+    return line.match(/^([^=]+)=(.*)$/);
+  }
+  static isQuoted(value) {
+    return /^['"]/.test(value);
+  }
+  static stripInlineComment(value) {
+    const hashIndex = value.indexOf(" #");
+    if (hashIndex !== -1) {
+      return value.slice(0, hashIndex).trim();
+    }
+    return value;
+  }
+  static parseQuotedValue(lines, currentIndex, value) {
+    const quote = value[0];
+    if (!value.endsWith(quote) || value.length === 1) {
+      let multilineValue = value.slice(1);
+      let i = currentIndex + 1;
+      while (i < lines.length) {
+        const nextLine = lines[i];
+        if (nextLine.endsWith(quote)) {
+          multilineValue += "\n" + nextLine.slice(0, -1);
+          break;
+        } else {
+          multilineValue += "\n" + nextLine;
+        }
+        i++;
+      }
+      return {
+        value: multilineValue,
+        nextIndex: i
+      };
+    }
+    return {
+      value: value.slice(1, -1),
+      nextIndex: currentIndex
+    };
+  }
+  static parseUnquotedMultiline(lines, currentIndex, value) {
+    let i = currentIndex + 1;
+    while (i < lines.length && !lines[i].includes("=") && lines[i].trim() !== "") {
+      value += "\n" + lines[i];
+      i++;
+    }
+    return {
+      value,
+      nextIndex: i - 1
+    };
+  }
   /**
   * Checks whether the specified environment variable exists.
   *

package/exception/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/exception/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

package/exception/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/fs/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/fs/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

package/fs/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/http-status-codes/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/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

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

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