@socketsecurity/lib 5.18.2 → 5.19.0

package/dist/env.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -28,6 +29,7 @@ __export(env_exports, {
 module.exports = __toCommonJS(env_exports);
 const NumberCtor = Number;
 const NumberIsFinite = Number.isFinite;
+const NumberIsNaN = Number.isNaN;
 const NumberParseInt = Number.parseInt;
 const StringCtor = String;
 const caseInsensitiveKeys = /* @__PURE__ */ new Set([
@@ -45,89 +47,95 @@ const caseInsensitiveKeys = /* @__PURE__ */ new Set([
   "WINDIR"
 ]);
 function createEnvProxy(base, overrides) {
-  return new Proxy(
-    {},
-    {
-      get(_target, prop) {
-        if (typeof prop !== "string") {
-          return void 0;
-        }
-        if (overrides && prop in overrides) {
-          return overrides[prop];
-        }
-        if (prop in base) {
-          return base[prop];
-        }
-        const upperProp = prop.toUpperCase();
-        if (caseInsensitiveKeys.has(upperProp)) {
-          if (overrides) {
-            const key2 = findCaseInsensitiveEnvKey(overrides, upperProp);
-            if (key2 !== void 0) {
-              return overrides[key2];
-            }
-          }
-          const key = findCaseInsensitiveEnvKey(base, upperProp);
-          if (key !== void 0) {
-            return base[key];
-          }
+  function lookupEnvValue(prop) {
+    if (overrides && prop in overrides) {
+      return overrides[prop];
+    }
+    if (prop in base) {
+      return base[prop];
+    }
+    const upperProp = prop.toUpperCase();
+    if (caseInsensitiveKeys.has(upperProp)) {
+      if (overrides) {
+        const key2 = findCaseInsensitiveEnvKey(overrides, upperProp);
+        if (key2 !== void 0) {
+          return overrides[key2];
         }
+      }
+      const key = findCaseInsensitiveEnvKey(base, upperProp);
+      if (key !== void 0) {
+        return base[key];
+      }
+    }
+    return void 0;
+  }
+  return new Proxy({}, {
+    get(_target, prop) {
+      if (typeof prop !== "string") {
         return void 0;
-      },
-      ownKeys(_target) {
-        const keys = /* @__PURE__ */ new Set([
-          ...Object.keys(base),
-          ...overrides ? Object.keys(overrides) : []
-        ]);
-        return [...keys];
-      },
-      getOwnPropertyDescriptor(_target, prop) {
-        if (typeof prop !== "string") {
-          return void 0;
-        }
-        const value = this.get?.(_target, prop, _target);
-        return value !== void 0 ? {
-          enumerable: true,
-          configurable: true,
-          writable: true,
-          value
-        } : void 0;
-      },
-      has(_target, prop) {
-        if (typeof prop !== "string") {
-          return false;
-        }
-        if (overrides && prop in overrides) {
-          return true;
-        }
-        if (prop in base) {
+      }
+      return lookupEnvValue(prop);
+    },
+    ownKeys(_target) {
+      const keys = /* @__PURE__ */ new Set([
+        ...Object.keys(base),
+        ...overrides ? Object.keys(overrides) : []
+      ]);
+      return [...keys];
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+      if (typeof prop !== "string") {
+        return void 0;
+      }
+      const value = lookupEnvValue(prop);
+      return value !== void 0 ? {
+        enumerable: true,
+        configurable: true,
+        writable: true,
+        value
+      } : void 0;
+    },
+    has(_target, prop) {
+      if (typeof prop !== "string") {
+        return false;
+      }
+      if (overrides && prop in overrides) {
+        return true;
+      }
+      if (prop in base) {
+        return true;
+      }
+      const upperProp = prop.toUpperCase();
+      if (caseInsensitiveKeys.has(upperProp)) {
+        if (overrides && findCaseInsensitiveEnvKey(overrides, upperProp) !== void 0) {
           return true;
         }
-        const upperProp = prop.toUpperCase();
-        if (caseInsensitiveKeys.has(upperProp)) {
-          if (overrides && findCaseInsensitiveEnvKey(overrides, upperProp) !== void 0) {
-            return true;
-          }
-          if (findCaseInsensitiveEnvKey(base, upperProp) !== void 0) {
-            return true;
-          }
-        }
-        return false;
-      },
-      set(_target, prop, value) {
-        if (typeof prop === "string" && overrides) {
-          overrides[prop] = value;
+        if (findCaseInsensitiveEnvKey(base, upperProp) !== void 0) {
           return true;
         }
-        return false;
       }
+      return false;
+    },
+    set(_target, prop, value) {
+      if (typeof prop === "string" && overrides) {
+        overrides[prop] = value;
+        return true;
+      }
+      return false;
     }
-  );
+  });
 }
 // @__NO_SIDE_EFFECTS__
-function envAsBoolean(value, defaultValue = false) {
+function envAsBoolean(value, defaultValueOrOptions = false) {
+  const opts = typeof defaultValueOrOptions === "boolean" ? { defaultValue: defaultValueOrOptions } : defaultValueOrOptions ?? {};
+  const { defaultValue = false, trim = true } = opts;
   if (typeof value === "string") {
-    const trimmed = value.trim();
-    return trimmed === "1" || trimmed.toLowerCase() === "true";
+    const candidate = trim ? value.trim() : value;
+    if (!candidate) {
+      return !!defaultValue;
+    }
+    const lower = candidate.toLowerCase();
+    return lower === "1" || lower === "true" || lower === "yes";
   }
   if (value === null || value === void 0) {
     return !!defaultValue;
@@ -135,20 +143,44 @@ function envAsBoolean(value, defaultValue = false) {
   return !!value;
 }
 // @__NO_SIDE_EFFECTS__
-function envAsNumber(value, defaultValue = 0) {
-  const numOrNaN = NumberParseInt(String(value), 10);
+function envAsNumber(value, defaultValueOrOptions = 0) {
+  const opts = typeof defaultValueOrOptions === "number" ? { defaultValue: defaultValueOrOptions } : defaultValueOrOptions ?? {};
+  const { allowInfinity = false, defaultValue = 0, mode = "int" } = opts;
+  if (value === void 0 || value === null) {
+    return defaultValue;
+  }
+  if (typeof value === "string") {
+    if (!value) {
+      return defaultValue;
+    }
+    const num = mode === "float" ? NumberCtor(value) : NumberParseInt(value, 10);
+    if (NumberIsNaN(num)) {
+      return defaultValue;
+    }
+    if (!NumberIsFinite(num)) {
+      return allowInfinity ? num : defaultValue;
+    }
+    return num || 0;
+  }
+  const numOrNaN = mode === "float" ? NumberCtor(String(value)) : NumberParseInt(String(value), 10);
   const numMayBeNegZero = NumberIsFinite(numOrNaN) ? numOrNaN : NumberCtor(defaultValue);
   return numMayBeNegZero || 0;
 }
 // @__NO_SIDE_EFFECTS__
-function envAsString(value, defaultValue = "") {
-  if (typeof value === "string") {
-    return value.trim();
+function envAsString(value, defaultValueOrOptions = "") {
+  const isOptionsObject = typeof defaultValueOrOptions === "object" && defaultValueOrOptions !== null && !Array.isArray(defaultValueOrOptions) && ("defaultValue" in defaultValueOrOptions || "trim" in defaultValueOrOptions);
+  const opts = isOptionsObject ? defaultValueOrOptions : {
+    defaultValue: defaultValueOrOptions === void 0 ? "" : typeof defaultValueOrOptions === "string" ? defaultValueOrOptions : StringCtor(defaultValueOrOptions)
+  };
+  const { defaultValue = "", trim = true } = opts;
+  if (value === void 0 || value === null) {
+    return defaultValue === "" || !trim ? defaultValue : StringCtor(defaultValue).trim();
   }
-  if (value === null || value === void 0) {
-    return defaultValue === "" ? defaultValue : StringCtor(defaultValue).trim();
+  if (typeof value === "string") {
+    return trim ? value.trim() : value;
   }
-  return StringCtor(value).trim();
+  const str = StringCtor(value);
+  return trim ? str.trim() : str;
 }
 function findCaseInsensitiveEnvKey(env, upperEnvVarName) {
   const targetLength = upperEnvVarName.length;

package/dist/errors.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;