@quintal/environment 2.0.0 → 2.1.0

package/.dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("zod");function f(r){return Object.entries(r).reduce((n,[t,e])=>(typeof e=="string"||typeof e>"u"?n[t]=e:"value"in e?n[t]=e.value||void 0:n[t]=f(e),n),{})}function l(r,n){const t=Object.entries(r).reduce((e,[u,i])=>(typeof i=="string"||typeof i>"u"?e[u]=a.z.string():"value"in i?(!i.isServerOnly||n)&&(e[u]=i.schema??a.z.string()):e[u]=l(i,n),e),{});return a.z.object(t)}function d(r,n,t,e,u){return new Proxy(r,{get(i,s){const c=n[s];if(!c)return;if(typeof c=="string")return c;const o=u?`${u}.${s}`:s;return"value"in c?c.isServerOnly&&!t?e(o):i[s]:d(r[s],n[s],t,e,o)}})}function v(r){const n=r.isServer??typeof window>"u",t=r.onValidationError??(c=>{throw new Error(`❌ Invalid environment variables:
-${a.z.prettifyError(c)}`)}),e=r.onAccessError??(c=>{throw new Error(`❌ Attempted to access server-side environment variable '${c}' on the client`)}),u=l(r.values,n),i=f(r.values),s=u.safeParse(i);return s.success?d(s.data,r.values,n,e):t(s.error)}exports.createEnvironment=v;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("zod");function f(r){return Object.entries(r).reduce((n,[t,e])=>(typeof e=="string"||typeof e>"u"?n[t]=e:"value"in e?n[t]=e.value||void 0:n[t]=f(e),n),{})}function l(r,n){const t=Object.entries(r).reduce((e,[c,i])=>(typeof i=="string"||typeof i>"u"?e[c]=a.z.string():"value"in i?(!i.isServerOnly||n)&&(e[c]=i.schema??a.z.string()):e[c]=l(i,n),e),{});return a.z.object(t)}function d(r,n,t,e,c){return new Proxy(r,{get(i,s){const u=n[s];if(!u)return;if(typeof u=="string")return u;const o=c?`${c}.${s}`:s;return"value"in u?u.isServerOnly&&!t?e(o):i[s]:d(r[s],n[s],t,e,o)}})}function v(r){if(r.isDisabled)return null;const n=r.isServer??typeof window>"u",t=r.onValidationError??(u=>{throw new Error(`❌ Invalid environment variables:
+${a.z.prettifyError(u)}`)}),e=r.onAccessError??(u=>{throw new Error(`❌ Attempted to access server-side environment variable '${u}' on the client`)}),c=l(r.values,n),i=f(r.values),s=c.safeParse(i);return s.success?d(s.data,r.values,n,e):t(s.error)}exports.createEnvironment=v;

package/.dist/index.d.ts

@@ -4,6 +4,12 @@ import { ZodType } from 'zod';
 export declare function createEnvironment<TEnvValues extends EnvValues>(opts: CreateEnvironmentOptions<TEnvValues>): UnwrapEnvValues<TEnvValues>;
 
 declare type CreateEnvironmentOptions<TEnvValues extends EnvValues> = {
+    /**
+     * Whether or not the environment variable validation should be disabled.
+     * Enabling this option will make `createEnvironment` return `null`.
+     * @defaultValue false
+     */
+    isDisabled?: boolean;
     /**
      * Whether or not the application is running on the server.
      * @defaultValue typeof window === 'undefined'

package/.dist/index.mjs

@@ -1,43 +1,44 @@
-import { z as a } from "zod";
-function f(r) {
+import { z as c } from "zod";
+function o(r) {
   return Object.entries(r).reduce(
-    (n, [t, e]) => (typeof e == "string" || typeof e > "u" ? n[t] = e : "value" in e ? n[t] = e.value || void 0 : n[t] = f(e), n),
+    (n, [t, e]) => (typeof e == "string" || typeof e > "u" ? n[t] = e : "value" in e ? n[t] = e.value || void 0 : n[t] = o(e), n),
     {}
   );
 }
 function l(r, n) {
   const t = Object.entries(r).reduce(
-    (e, [u, i]) => (typeof i == "string" || typeof i > "u" ? e[u] = a.string() : "value" in i ? (!i.isServerOnly || n) && (e[u] = i.schema ?? a.string()) : e[u] = l(i, n), e),
+    (e, [a, i]) => (typeof i == "string" || typeof i > "u" ? e[a] = c.string() : "value" in i ? (!i.isServerOnly || n) && (e[a] = i.schema ?? c.string()) : e[a] = l(i, n), e),
     {}
   );
-  return a.object(t);
+  return c.object(t);
 }
-function d(r, n, t, e, u) {
+function d(r, n, t, e, a) {
   return new Proxy(r, {
     get(i, s) {
-      const c = n[s];
-      if (!c) return;
-      if (typeof c == "string") return c;
-      const o = u ? `${u}.${s}` : s;
-      return "value" in c ? c.isServerOnly && !t ? e(o) : i[s] : d(
+      const u = n[s];
+      if (!u) return;
+      if (typeof u == "string") return u;
+      const f = a ? `${a}.${s}` : s;
+      return "value" in u ? u.isServerOnly && !t ? e(f) : i[s] : d(
         r[s],
         n[s],
         t,
         e,
-        o
+        f
       );
     }
   });
 }
 function y(r) {
-  const n = r.isServer ?? typeof window > "u", t = r.onValidationError ?? ((c) => {
+  if (r.isDisabled) return null;
+  const n = r.isServer ?? typeof window > "u", t = r.onValidationError ?? ((u) => {
     throw new Error(`❌ Invalid environment variables:
-${a.prettifyError(c)}`);
-  }), e = r.onAccessError ?? ((c) => {
+${c.prettifyError(u)}`);
+  }), e = r.onAccessError ?? ((u) => {
     throw new Error(
-      `❌ Attempted to access server-side environment variable '${c}' on the client`
+      `❌ Attempted to access server-side environment variable '${u}' on the client`
     );
-  }), u = l(r.values, n), i = f(r.values), s = u.safeParse(i);
+  }), a = l(r.values, n), i = o(r.values), s = a.safeParse(i);
   return s.success ? d(
     s.data,
     r.values,

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Quintal Web Solutions
+Copyright (c) 2026 Quintal Web Solutions
 
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quintal/environment",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "license": "MIT",
   "description": "Framework-agnostic environment variable validation for TypeScript powered by Zod",
   "keywords": [