@zh-moody/safe-env 0.3.4 → 0.3.6

package/README.en.md

@@ -20,7 +20,6 @@ Whether you are writing Vue, React, or Node.js, environment variables are often
 - **Monorepo Ready**: Supports `cwd` parameter to explicitly specify the `.env` directory, ideal for complex project architectures.
 - **IDE Enhancement**: Supports `.description()` to view variable usage and documentation directly via hover in your code.
 - **Rigorous Type Parsing**: Built-in `s.array()`, `s.boolean()` with enhanced conversion, and `.transform()` for chainable piping.
-- **Ultra-lightweight**: Only **1.9 KB** after Gzip, with zero runtime dependencies.
 
 ---
 
@@ -35,36 +34,38 @@ npm install @zh-moody/safe-env
 ### 🚀 Quick Start
 
 #### 🔹 [Vite / React / Vue]
+
 For frontend projects, use the Vite plugin for **build-time validation**.
 
 **1. Configure Vite Plugin (`vite.config.ts`):**
+
 ```typescript
-import { viteSafeEnv } from '@zh-moody/safe-env/vite';
-import { schema } from './src/env';
+import { viteSafeEnv } from "@zh-moody/safe-env/vite";
+import { schema } from "./src/env";
 
 export default {
-  plugins: [
-    viteSafeEnv(schema)
-  ]
-}
+  plugins: [viteSafeEnv(schema)],
+};
 ```
 
 **2. Define and Export Config (`src/env.ts`):**
+
 ```typescript
-import { safeEnv, s } from '@zh-moody/safe-env';
+import { safeEnv, s } from "@zh-moody/safe-env";
 
 export const schema = {
   VITE_API_URL: s.string().url().description("Backend API Base URL"),
   VITE_PORT: s.number(3000).description("Development Server Port"),
 };
 
-export const env = safeEnv(schema, { 
-  source: import.meta.env 
+export const env = safeEnv(schema, {
+  source: import.meta.env,
 });
 ```
 
 > **💡 Best Practice: Prevent Vite Type Pollution**
 > To completely disable the insecure original `import.meta.env.XXX` hints, modify `src/vite-env.d.ts`:
+>
 > ```typescript
 > interface ImportMetaEnv {
 >   [key: string]: never;
@@ -74,19 +75,24 @@ export const env = safeEnv(schema, {
 ---
 
 #### 🔸 [Node.js / Server-side]
+
 In Node.js, the library automatically looks for and parses `.env` files on disk.
 
 **1. Define Config (`src/config.ts`):**
+
 ```typescript
-import { safeEnv, s } from '@zh-moody/safe-env';
-
-const config = safeEnv({
-  DB_PASSWORD: s.string().secret().description("Database Password"),
-  DB_PORT: s.number(5432).min(1).max(65535),
-}, {
-  // Explicitly specify the .env directory for Monorepo or specific deployments
-  // cwd: '/path/to/project-root'
-});
+import { safeEnv, s } from "@zh-moody/safe-env";
+
+const config = safeEnv(
+  {
+    DB_PASSWORD: s.string().secret().description("Database Password"),
+    DB_PORT: s.number(5432).min(1).max(65535),
+  },
+  {
+    // Explicitly specify the .env directory for Monorepo or specific deployments
+    // cwd: '/path/to/project-root'
+  },
+);
 
 export default config;
 ```
@@ -96,6 +102,7 @@ export default config;
 ### 🛠️ API Reference
 
 #### 1. Define Fields (`s.xxx`)
+
 - `s.string(default?)`: String field. Required if no default value.
 - `s.number(default?)`: Automatically converted to `number` and validated.
 - `s.boolean(default?)`: Supports `"true"`, `"1"`, `"yes"`, `"on"` as `true`.
@@ -106,43 +113,50 @@ export default config;
 
 - **`.secret()`**: Masks the value as `********` in error reports.
   ```typescript
-  PASSWORD: s.string().secret()
+  PASSWORD: s.string().secret();
   ```
 - **`.url()` / `.email()`**: Built-in format validation.
   ```typescript
-  API_URL: s.string().url()
+  API_URL: s.string().url();
   ```
 - **`.regex(pattern, msg?)`**: Custom regex validation.
   ```typescript
-  VERSION: s.string().regex(/^v\d+\.\d+\.\d+$/, "Invalid format")
+  VERSION: s.string().regex(/^v\d+\.\d+\.\d+$/, "Invalid format");
   ```
 - **`.description(text)`**: Adds a description for IDE hover hints.
   ```typescript
-  PORT: s.number(3000).description("Server Port")
+  PORT: s.number(3000).description("Server Port");
   ```
 - **`.transform(fn)`**: Custom data transformation, supports multi-level piping.
   ```typescript
-  NAME: s.string().transform(v => v.trim()).transform(v => v.toUpperCase())
+  NAME: s.string()
+    .transform((v) => v.trim())
+    .transform((v) => v.toUpperCase());
   ```
 - **`.from(key)`**: Maps environment variable name (Alias).
   ```typescript
-  port: s.number().from('VITE_SERVER_PORT')
+  port: s.number().from("VITE_SERVER_PORT");
   ```
 - **`.min(n)` / `.max(n)`**: Constraints for number values.
   ```typescript
-  PORT: s.number().min(1024).max(65535)
+  PORT: s.number().min(1024).max(65535);
   ```
 - **`.validate(fn, msg?)`**: Fully custom validation logic.
   ```typescript
-  INTERNAL_URL: s.string().validate(v => v.endsWith('.internal.com'), 'Must be internal')
+  INTERNAL_URL: s.string().validate(
+    (v) => v.endsWith(".internal.com"),
+    "Must be internal",
+  );
   ```
 
 ---
 
 ### 🎨 Error Reporting
+
 When validation fails, `safe-env` outputs a structured, adaptive table in the console showing: **Key / Error Reason / Current Value (Masked)**.
 
 ---
 
 ### 📄 License
+
 [MIT License](./LICENSE) - Copyright (c) 2026 Moody.

package/README.md

@@ -20,7 +20,6 @@
 - **Monorepo 精准定位**：支持 `cwd` 参数，可显式指定配置文件检索目录，适配复杂的项目架构。
 - **IDE 增强**：支持 `.description()`，在代码中通过悬停直接查看变量用途与文档。
 - **严谨的类型解析**：内置 `s.array()`, `s.boolean()` 增强转换，支持 `.transform()` 链式 Pipe 处理。
-- **极致轻量**：Gzip 压缩后仅 **1.9 KB**，零运行时依赖。
 
 ---
 
@@ -35,36 +34,38 @@ npm install @zh-moody/safe-env
 ### 🚀 快速上手
 
 #### 🔹 [Vite / React / Vue] 使用
+
 在前端，建议配合 Vite 插件实现**构建时校验**。
 
 **1. 配置 Vite 插件 (`vite.config.ts`)：**
+
 ```typescript
-import { viteSafeEnv } from '@zh-moody/safe-env/vite';
-import { schema } from './src/env';
+import { viteSafeEnv } from "@zh-moody/safe-env/vite";
+import { schema } from "./src/env";
 
 export default {
-  plugins: [
-    viteSafeEnv(schema)
-  ]
-}
+  plugins: [viteSafeEnv(schema)],
+};
 ```
 
 **2. 定义配置并导出 (`src/env.ts`)：**
+
 ```typescript
-import { safeEnv, s } from '@zh-moody/safe-env';
+import { safeEnv, s } from "@zh-moody/safe-env";
 
 export const schema = {
   VITE_API_URL: s.string().url().description("后端 API 地址"),
   VITE_PORT: s.number(3000).description("服务端口"),
 };
 
-export const env = safeEnv(schema, { 
-  source: import.meta.env 
+export const env = safeEnv(schema, {
+  source: import.meta.env,
 });
 ```
 
 > **💡 最佳实践：防止 Vite 类型污染**
 > 为彻底禁用 `import.meta.env.XXX` 的原生提示，建议修改 `src/vite-env.d.ts`：
+>
 > ```typescript
 > interface ImportMetaEnv {
 >   [key: string]: never;
@@ -74,19 +75,24 @@ export const env = safeEnv(schema, {
 ---
 
 #### 🔸 [Node.js / 服务端] 使用
+
 在后端环境，库会自动检索并解析磁盘上的 `.env` 系列文件。
 
 **1. 定义配置 (`src/config.ts`)：**
+
 ```typescript
-import { safeEnv, s } from '@zh-moody/safe-env';
-
-const config = safeEnv({
-  DB_PASSWORD: s.string().secret().description("数据库密码"),
-  DB_PORT: s.number(5432).min(1).max(65535),
-}, {
-  // 在 Monorepo 或特定部署环境下，可显式指定 .env 所在目录
-  // cwd: '/path/to/project-root'
-});
+import { safeEnv, s } from "@zh-moody/safe-env";
+
+const config = safeEnv(
+  {
+    DB_PASSWORD: s.string().secret().description("数据库密码"),
+    DB_PORT: s.number(5432).min(1).max(65535),
+  },
+  {
+    // 在 Monorepo 或特定部署环境下，可显式指定 .env 所在目录
+    // cwd: '/path/to/project-root'
+  },
+);
 
 export default config;
 ```
@@ -96,6 +102,7 @@ export default config;
 ### 🛠️ API 详解
 
 #### 1. 定义字段 (`s.xxx`)
+
 - `s.string(default?)`: 字符串。若无默认值则必填。
 - `s.number(default?)`: 数字。自动转换为 `number` 类型并校验合法性。
 - `s.boolean(default?)`: 布尔型。支持将 `"true"`, `"1"`, `"yes"`, `"on"` 解析为 `true`。
@@ -108,43 +115,50 @@ export default config;
 
 - **`.secret()`**: 标记敏感数据，报错时该值会以 `********` 遮罩显示。
   ```typescript
-  PASSWORD: s.string().secret()
+  PASSWORD: s.string().secret();
   ```
 - **`.url()` / `.email()`**: 常用格式校验。
   ```typescript
-  API_URL: s.string().url()
+  API_URL: s.string().url();
   ```
 - **`.regex(pattern, msg?)`**: 自定义正则校验。
   ```typescript
-  VERSION: s.string().regex(/^v\d+\.\d+\.\d+$/, "格式错误")
+  VERSION: s.string().regex(/^v\d+\.\d+\.\d+$/, "格式错误");
   ```
 - **`.description(text)`**: 添加变量描述，映射到 IDE 悬停提示中。
   ```typescript
-  PORT: s.number(3000).description("服务端口")
+  PORT: s.number(3000).description("服务端口");
   ```
 - **`.transform(fn)`**: 自定义数据转换，支持多级 Pipe。
   ```typescript
-  NAME: s.string().transform(v => v.trim()).transform(v => v.toUpperCase())
+  NAME: s.string()
+    .transform((v) => v.trim())
+    .transform((v) => v.toUpperCase());
   ```
 - **`.from(key)`**: 映射环境变量名（别名）。
   ```typescript
-  port: s.number().from('VITE_SERVER_PORT')
+  port: s.number().from("VITE_SERVER_PORT");
   ```
 - **`.min(n)` / `.max(n)`**: 限制数字取值范围。
   ```typescript
-  PORT: s.number().min(1024).max(65535)
+  PORT: s.number().min(1024).max(65535);
   ```
 - **`.validate(fn, msg?)`**: 完全自定义的逻辑校验。
   ```typescript
-  INTERNAL_URL: s.string().validate(v => v.endsWith('.internal.com'), 'Must be internal')
+  INTERNAL_URL: s.string().validate(
+    (v) => v.endsWith(".internal.com"),
+    "Must be internal",
+  );
   ```
 
 ---
 
 ### 🎨 错误报告
+
 当校验失败时，`safe-env` 会在控制台输出结构化的自适应表格，清晰展示：**Key / 错误原因 / 当前值（已脱敏）**。
 
 ---
 
 ### 📄 开源协议 (License)
+
 [MIT License](./LICENSE) - Copyright (c) 2026 Moody.

package/dist/chunk-5LT4H5GX.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});function l(e){let s={},r=e.split(/\r?\n/);for(let o of r){let i=o.trim();if(!i||i.startsWith("#"))continue;let n=i.indexOf("=");if(n==-1)continue;let c=i.slice(0,n).trim(),t=i.slice(n+1).trim();(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))&&(t=t.slice(1,-1)),s[c]=t}return s}exports.a = l;

package/dist/chunk-D6WM53FN.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var d=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(b,c)=>(typeof require<"u"?require:b)[c]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});exports.a = d;

package/dist/chunk-E625KLX5.js

@@ -0,0 +1,9 @@
+import{a as k}from"./chunk-I7AUKTXE.js";var T="development",R="serve",I="build",$="VITE_DEV_SERVER",S="VITE_";var V=typeof window<"u"&&typeof window.document<"u";function g(s,t=!0){if(V)return`SafeEnv Validation Failed: ${s.map(e=>`${e.key} (${e.error})`).join(", ")}`;let l={r:"\x1B[31m",g:"\x1B[32m",y:"\x1B[33m",b:"\x1B[1m",res:"\x1B[0m",d:"\x1B[2m",cy:"\x1B[36m"},n=(e,p)=>{let i=String(e),d=()=>i.length+(i.match(/[^\x00-\xff]/g)||[]).length;for(;d()>p;)i=i.slice(0,-1);return i+" ".repeat(p-d())},E=Math.max(80,(typeof process<"u"?process.stdout.columns:80)||80)-10,y=Math.floor(E*.3),m=Math.floor(E*.5),r=t?l:{r:"",g:"",y:"",b:"",res:"",d:"",cy:""},c=`
+${r.r}${r.b}\u274C SafeEnv Validation Failed${r.res}
+`;return c+=` ${r.b}${n("Key",y)} \u2502 ${n("Error",m)} \u2502 Value${r.res}
+`,c+=r.d+"\u2500".repeat(E+5)+r.res+`
+`,s.forEach(e=>{let p=e.value===void 0?"undefined":e.isSecret?"********":`"${e.value}"`,i=e.value===void 0?r.d:e.isSecret?r.y:r.cy;c+=` ${r.y}${n(e.key,y)}${r.res} \u2502 ${r.r}${n(e.error,m)}${r.res} \u2502 ${i}${p}${r.res}
+`}),c+=r.d+"\u2500".repeat(E+5)+r.res+`
+`,c+=` ${r.g}\u{1F4A1} Tip: Check your .env files or schema definitions.${r.res}
+`,c}function F(s){if(V){console.group("%c \u274C SafeEnv Validation Failed ","background: #fee2e2; color: #b91c1c; font-weight: bold; padding: 4px; border-radius: 2px;");let t=s.reduce((l,n)=>(l[n.key]={"Error Message":n.error,"Current Value":n.value===void 0?"undefined":n.isSecret?"********":n.value},l),{});console.table(t),console.log("%c \u{1F4A1} Tip: Check your .env files or schema definitions. ","color: #059669; font-style: italic;"),console.groupEnd()}else console.error(g(s,!0))}var x={};function O(s){let t=g(s,!1);return new Proxy({},{get(l,n){if(n==="__isSafeEnvError")return!0;if(n==="toJSON")return()=>({error:"SafeEnv Validation Failed"});throw new Error(`[safe-env] Cannot access "${String(n)}" because validation failed:
+${t}`)},ownKeys(){return[]},getOwnPropertyDescriptor(){}})}function U(s,t={}){let{loadProcessEnv:l=!0,prefix:n=S,cwd:E,useCache:y=!0}=t,m=typeof window<"u",r=typeof process<"u"&&(!!process.env.VITE||!!process.env[$]),c=m||r||"source"in t,e={};if("source"in t)e=t.source||{};else if(y&&Object.keys(x).length>0)e=x;else if(typeof process<"u"&&!m)try{let o=t.mode||process.env.NODE_ENV||T,{loadDotEnv:a}=k("./fs-node.cjs"),u={};for(let b of[".env",`.env.${o}`,".env.local",`.env.${o}.local`])u={...u,...a(b,E)};e={...u,...l?process.env:{}}}catch{e={}}let p=Object.keys(e).length;if(y&&(p>0?Object.assign(x,e):Object.keys(x).length>0&&(e=x)),c&&Object.keys(e).length===0)return{};let i={},d=[];for(let o in s){let a=s[o],u=n&&!o.startsWith(n)?n+o:o,b=a.sourceKey||(e[u]!==void 0?u:e[o]!==void 0?o:u),v=e[b];try{if(v===void 0||v===""&&a.default!==void 0){if(a.required&&v===void 0)throw new Error("Missing required field");i[o]=a.default}else{let f=a.parse(v);if(f!==void 0&&a.metadata){let{min:h,max:D,validate:w}=a.metadata;if(typeof f=="number"){if(h!==void 0&&f<h)throw new Error(`Below min ${h}`);if(D!==void 0&&f>D)throw new Error(`Above max ${D}`)}if(w&&!w.fn(f))throw new Error(w.message)}i[o]=f}}catch(f){d.push({key:b,error:f.message,value:v,isSecret:a.metadata?.isSecret})}}if(d.length>0){if(t.throwOnError){let o=new Error(g(d,!0));throw o.plainMessage=g(d,!1),o}return F(d),typeof process<"u"&&process.exit&&!c&&process.exit(1),O(d)}return Object.freeze(i)}export{T as a,R as b,I as c,$ as d,S as e,g as f,F as g,U as h};

package/dist/chunk-FBIIFJ67.js

@@ -0,0 +1 @@
+function l(e){let s={},r=e.split(/\r?\n/);for(let o of r){let i=o.trim();if(!i||i.startsWith("#"))continue;let n=i.indexOf("=");if(n==-1)continue;let c=i.slice(0,n).trim(),t=i.slice(n+1).trim();(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))&&(t=t.slice(1,-1)),s[c]=t}return s}export{l as a};

package/dist/chunk-I7AUKTXE.js

@@ -0,0 +1 @@
+var d=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(b,c)=>(typeof require<"u"?require:b)[c]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});export{d as a};

package/dist/chunk-SHSPQLLU.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunkD6WM53FNcjs = require('./chunk-D6WM53FN.cjs');var T="development",R= exports.b ="serve",I= exports.c ="build",$= exports.d ="VITE_DEV_SERVER",S= exports.e ="VITE_";var V=typeof window<"u"&&typeof window.document<"u";function g(s,t=!0){if(V)return`SafeEnv Validation Failed: ${s.map(e=>`${e.key} (${e.error})`).join(", ")}`;let l={r:"\x1B[31m",g:"\x1B[32m",y:"\x1B[33m",b:"\x1B[1m",res:"\x1B[0m",d:"\x1B[2m",cy:"\x1B[36m"},n=(e,p)=>{let i=String(e),d=()=>i.length+(i.match(/[^\x00-\xff]/g)||[]).length;for(;d()>p;)i=i.slice(0,-1);return i+" ".repeat(p-d())},E=Math.max(80,(typeof process<"u"?process.stdout.columns:80)||80)-10,y=Math.floor(E*.3),m=Math.floor(E*.5),r=t?l:{r:"",g:"",y:"",b:"",res:"",d:"",cy:""},c=`
+${r.r}${r.b}\u274C SafeEnv Validation Failed${r.res}
+`;return c+=` ${r.b}${n("Key",y)} \u2502 ${n("Error",m)} \u2502 Value${r.res}
+`,c+=r.d+"\u2500".repeat(E+5)+r.res+`
+`,s.forEach(e=>{let p=e.value===void 0?"undefined":e.isSecret?"********":`"${e.value}"`,i=e.value===void 0?r.d:e.isSecret?r.y:r.cy;c+=` ${r.y}${n(e.key,y)}${r.res} \u2502 ${r.r}${n(e.error,m)}${r.res} \u2502 ${i}${p}${r.res}
+`}),c+=r.d+"\u2500".repeat(E+5)+r.res+`
+`,c+=` ${r.g}\u{1F4A1} Tip: Check your .env files or schema definitions.${r.res}
+`,c}function F(s){if(V){console.group("%c \u274C SafeEnv Validation Failed ","background: #fee2e2; color: #b91c1c; font-weight: bold; padding: 4px; border-radius: 2px;");let t=s.reduce((l,n)=>(l[n.key]={"Error Message":n.error,"Current Value":n.value===void 0?"undefined":n.isSecret?"********":n.value},l),{});console.table(t),console.log("%c \u{1F4A1} Tip: Check your .env files or schema definitions. ","color: #059669; font-style: italic;"),console.groupEnd()}else console.error(g(s,!0))}var x={};function O(s){let t=g(s,!1);return new Proxy({},{get(l,n){if(n==="__isSafeEnvError")return!0;if(n==="toJSON")return()=>({error:"SafeEnv Validation Failed"});throw new Error(`[safe-env] Cannot access "${String(n)}" because validation failed:
+${t}`)},ownKeys(){return[]},getOwnPropertyDescriptor(){}})}function U(s,t={}){let{loadProcessEnv:l=!0,prefix:n=S,cwd:E,useCache:y=!0}=t,m=typeof window<"u",r=typeof process<"u"&&(!!process.env.VITE||!!process.env[$]),c=m||r||"source"in t,e={};if("source"in t)e=t.source||{};else if(y&&Object.keys(x).length>0)e=x;else if(typeof process<"u"&&!m)try{let o=t.mode||process.env.NODE_ENV||T,{loadDotEnv:a}=_chunkD6WM53FNcjs.a.call(void 0, "./fs-node.cjs"),u={};for(let b of[".env",`.env.${o}`,".env.local",`.env.${o}.local`])u={...u,...a(b,E)};e={...u,...l?process.env:{}}}catch (e2){e={}}let p=Object.keys(e).length;if(y&&(p>0?Object.assign(x,e):Object.keys(x).length>0&&(e=x)),c&&Object.keys(e).length===0)return{};let i={},d=[];for(let o in s){let a=s[o],u=n&&!o.startsWith(n)?n+o:o,b=a.sourceKey||(e[u]!==void 0?u:e[o]!==void 0?o:u),v=e[b];try{if(v===void 0||v===""&&a.default!==void 0){if(a.required&&v===void 0)throw new Error("Missing required field");i[o]=a.default}else{let f=a.parse(v);if(f!==void 0&&a.metadata){let{min:h,max:D,validate:w}=a.metadata;if(typeof f=="number"){if(h!==void 0&&f<h)throw new Error(`Below min ${h}`);if(D!==void 0&&f>D)throw new Error(`Above max ${D}`)}if(w&&!w.fn(f))throw new Error(w.message)}i[o]=f}}catch(f){d.push({key:b,error:f.message,value:v,isSecret:_optionalChain([a, 'access', _ => _.metadata, 'optionalAccess', _2 => _2.isSecret])})}}if(d.length>0){if(t.throwOnError){let o=new Error(g(d,!0));throw o.plainMessage=g(d,!1),o}return F(d),typeof process<"u"&&process.exit&&!c&&process.exit(1),O(d)}return Object.freeze(i)}exports.a = T; exports.b = R; exports.c = I; exports.d = $; exports.e = S; exports.f = g; exports.g = F; exports.h = U;

package/dist/fs-browser.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});function r(n=".env",t){return{}}exports.loadDotEnv = r;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-D6WM53FN.cjs');function r(n=".env",t){return{}}exports.loadDotEnv = r;

package/dist/fs-browser.js

@@ -1 +1 @@
-function r(n=".env",t){return{}}export{r as loadDotEnv};
+import"./chunk-I7AUKTXE.js";function r(n=".env",t){return{}}export{r as loadDotEnv};

package/dist/fs-node.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkMODJPD2Xcjs = require('./chunk-MODJPD2X.cjs');exports.loadDotEnv = _chunkMODJPD2Xcjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }var _chunk5LT4H5GXcjs = require('./chunk-5LT4H5GX.cjs');require('./chunk-D6WM53FN.cjs');var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);var _path = require('path'); var _path2 = _interopRequireDefault(_path);function p(e=".env",n){try{let r=_path2.default.resolve(n||process.cwd(),e);if(_fs2.default.existsSync(r))return _chunk5LT4H5GXcjs.a.call(void 0, _fs2.default.readFileSync(r,"utf-8"))}catch (e2){}return{}}exports.loadDotEnv = p;

package/dist/fs-node.js

@@ -1 +1 @@
-import{b as a}from"./chunk-WZTPUQ3S.js";export{a as loadDotEnv};
+import{a as t}from"./chunk-FBIIFJ67.js";import"./chunk-I7AUKTXE.js";import o from"fs";import s from"path";function p(e=".env",n){try{let r=s.resolve(n||process.cwd(),e);if(o.existsSync(r))return t(o.readFileSync(r,"utf-8"))}catch{}return{}}export{p as loadDotEnv};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkWXZ32K3Gcjs = require('./chunk-WXZ32K3G.cjs');var _chunkMODJPD2Xcjs = require('./chunk-MODJPD2X.cjs');function a(n,t,e,o=[]){return{type:n,default:t,required:t===void 0,parse:e,metadata:o.length?{options:o}:{},from(i){return this.sourceKey=i,this},validate(i,r="Custom validation failed"){return this.metadata={...this.metadata,validate:{fn:i,message:r}},this},min(i){return this.metadata={...this.metadata,min:i},this},max(i){return this.metadata={...this.metadata,max:i},this},transform(i){let r=this.parse;return this.parse=s=>i(r(s)),this},secret(){return this.metadata={...this.metadata,isSecret:!0},this},url(){return this.validate(i=>{try{return new URL(String(i)),!0}catch (e2){return!1}},"Invalid URL format")},email(){let i=/^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/;return this.validate(r=>i.test(String(r)),"Invalid email format")},regex(i,r="Value does not match pattern"){return this.validate(s=>i.test(String(s)),r)},description(i){return this.metadata={...this.metadata,description:i},this}}}var m={string:n=>a("string",n,t=>String(t)),number:n=>a("number",n,t=>{let e=Number(t);if(isNaN(e))throw new Error(`Invalid number: ${t}`);return e}),boolean:n=>a("boolean",n,t=>{if(typeof t=="boolean")return t;if(t===void 0||t==="")return!1;let e=String(t).toLowerCase().trim();if(e==="true"||e==="1"||e==="yes"||e==="on")return!0;if(e==="false"||e==="0"||e==="no"||e==="off")return!1;throw new Error(`Invalid boolean: ${t}`)}),enum:(n,t)=>a("enum",t,e=>{if(!n.includes(e))throw new Error(`Value "${e}" is not one of: ${n.join(", ")}`);return e},n),array:(n,t=",")=>a("array",n,e=>Array.isArray(e)?e:typeof e!="string"?[]:e.split(t).map(o=>o.trim()).filter(Boolean))};exports.parseDotEnv = _chunkMODJPD2Xcjs.a; exports.reportErrors = _chunkWXZ32K3Gcjs.a; exports.s = m; exports.safeEnv = _chunkWXZ32K3Gcjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk5LT4H5GXcjs = require('./chunk-5LT4H5GX.cjs');var _chunkSHSPQLLUcjs = require('./chunk-SHSPQLLU.cjs');require('./chunk-D6WM53FN.cjs');function a(i,e,n,s=[]){return{type:i,default:e,required:e===void 0,parse:n,metadata:s.length?{options:s}:{},from(t){return this.sourceKey=t,this},validate(t,r="Custom validation failed"){return this.metadata={...this.metadata,validate:{fn:t,message:r}},this},min(t){return this.metadata={...this.metadata,min:t},this},max(t){return this.metadata={...this.metadata,max:t},this},transform(t){let r=this.parse;return this.parse=o=>t(r(o)),this},secret(){return this.metadata={...this.metadata,isSecret:!0},this},url(){return this.validate(t=>{try{return new URL(String(t)),!0}catch (e2){return!1}},"Invalid URL format")},email(){return this.validate(t=>/^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/.test(String(t)),"Invalid email format")},regex(t,r="Value does not match pattern"){return this.validate(o=>t.test(String(o)),r)},description(t){return this.metadata={...this.metadata,description:t},this}}}var p={string:i=>a("string",i,e=>String(e)),number:i=>a("number",i,e=>{let n=Number(e);if(isNaN(n))throw new Error(`Invalid number: ${e}`);return n}),boolean:i=>a("boolean",i,e=>{if(typeof e=="boolean")return e;if(e===void 0||e==="")return!1;let n=String(e).toLowerCase().trim();if(["true","1","yes","on"].includes(n))return!0;if(["false","0","no","off"].includes(n))return!1;throw new Error(`Invalid boolean: ${e}`)}),enum:(i,e)=>a("enum",e,n=>{if(!i.includes(n))throw new Error(`Value "${n}" is not one of: ${i.join(", ")}`);return n},i),array:(i,e=",")=>a("array",i,n=>Array.isArray(n)?n:typeof n!="string"?[]:n.split(e).map(s=>s.trim()).filter(Boolean))};exports.BUILD = _chunkSHSPQLLUcjs.c; exports.DEV = _chunkSHSPQLLUcjs.a; exports.SERVE = _chunkSHSPQLLUcjs.b; exports.VITE_DEV_FLAG = _chunkSHSPQLLUcjs.d; exports.VITE_PREFIX = _chunkSHSPQLLUcjs.e; exports.formatErrorReport = _chunkSHSPQLLUcjs.f; exports.parseDotEnv = _chunk5LT4H5GXcjs.a; exports.reportErrors = _chunkSHSPQLLUcjs.g; exports.s = p; exports.safeEnv = _chunkSHSPQLLUcjs.h;

package/dist/index.d.cts

@@ -1,28 +1,25 @@
-import { F as FieldDefinition, S as Schema, I as InferSchema, E as EnvError } from './types-CFipqnoe.cjs';
-export { B as BaseType } from './types-CFipqnoe.cjs';
+import { F as FieldDefinition, S as Schema, a as SafeEnvOptions, I as InferSchema, E as EnvError } from './types-C7kDNgjd.cjs';
+export { B as BUILD, b as BaseType, D as DEV, c as SERVE, V as VITE_DEV_FLAG, d as VITE_PREFIX } from './types-C7kDNgjd.cjs';
 
 declare const s: {
-    string: (defaultValue?: string) => FieldDefinition<string>;
-    number: (defaultValue?: number) => FieldDefinition<number>;
-    boolean: (defaultValue?: boolean) => FieldDefinition<boolean>;
-    enum: <T extends string>(options: T[], defaultValue?: T) => FieldDefinition<T>;
-    array: (defaultValue?: string[], separator?: string) => FieldDefinition<string[]>;
+    string: (d?: string) => FieldDefinition<string>;
+    number: (d?: number) => FieldDefinition<number>;
+    boolean: (d?: boolean) => FieldDefinition<boolean>;
+    enum: <T extends string>(o: T[], d?: T) => FieldDefinition<T>;
+    array: (d?: string[], sep?: string) => FieldDefinition<string[]>;
 };
 
-interface SafeEnvOptions {
-    mode?: string;
-    loadProcessEnv?: boolean;
-    source?: Record<string, any>;
-    prefix?: string;
-    cwd?: string;
-}
-declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions): Readonly<InferSchema<T>>;
+declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions & {
+    throwOnError?: boolean;
+    useCache?: boolean;
+}): Readonly<InferSchema<T>>;
 
 /***
  *  将 .env 内容字符串解析为对象
  * */
 declare function parseDotEnv(content: string): Record<string, string>;
 
+declare function formatErrorReport(errors: EnvError[], useColor?: boolean): string;
 declare function reportErrors(errors: EnvError[]): void;
 
-export { EnvError, FieldDefinition, InferSchema, Schema, parseDotEnv, reportErrors, s, safeEnv };
+export { EnvError, FieldDefinition, InferSchema, SafeEnvOptions, Schema, formatErrorReport, parseDotEnv, reportErrors, s, safeEnv };

package/dist/index.d.ts

@@ -1,28 +1,25 @@
-import { F as FieldDefinition, S as Schema, I as InferSchema, E as EnvError } from './types-CFipqnoe.js';
-export { B as BaseType } from './types-CFipqnoe.js';
+import { F as FieldDefinition, S as Schema, a as SafeEnvOptions, I as InferSchema, E as EnvError } from './types-C7kDNgjd.js';
+export { B as BUILD, b as BaseType, D as DEV, c as SERVE, V as VITE_DEV_FLAG, d as VITE_PREFIX } from './types-C7kDNgjd.js';
 
 declare const s: {
-    string: (defaultValue?: string) => FieldDefinition<string>;
-    number: (defaultValue?: number) => FieldDefinition<number>;
-    boolean: (defaultValue?: boolean) => FieldDefinition<boolean>;
-    enum: <T extends string>(options: T[], defaultValue?: T) => FieldDefinition<T>;
-    array: (defaultValue?: string[], separator?: string) => FieldDefinition<string[]>;
+    string: (d?: string) => FieldDefinition<string>;
+    number: (d?: number) => FieldDefinition<number>;
+    boolean: (d?: boolean) => FieldDefinition<boolean>;
+    enum: <T extends string>(o: T[], d?: T) => FieldDefinition<T>;
+    array: (d?: string[], sep?: string) => FieldDefinition<string[]>;
 };
 
-interface SafeEnvOptions {
-    mode?: string;
-    loadProcessEnv?: boolean;
-    source?: Record<string, any>;
-    prefix?: string;
-    cwd?: string;
-}
-declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions): Readonly<InferSchema<T>>;
+declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions & {
+    throwOnError?: boolean;
+    useCache?: boolean;
+}): Readonly<InferSchema<T>>;
 
 /***
  *  将 .env 内容字符串解析为对象
  * */
 declare function parseDotEnv(content: string): Record<string, string>;
 
+declare function formatErrorReport(errors: EnvError[], useColor?: boolean): string;
 declare function reportErrors(errors: EnvError[]): void;
 
-export { EnvError, FieldDefinition, InferSchema, Schema, parseDotEnv, reportErrors, s, safeEnv };
+export { EnvError, FieldDefinition, InferSchema, SafeEnvOptions, Schema, formatErrorReport, parseDotEnv, reportErrors, s, safeEnv };

package/dist/index.js

@@ -1 +1 @@
-import{a as l,b as u}from"./chunk-UONNQTFU.js";import{a as f}from"./chunk-WZTPUQ3S.js";function a(n,t,e,o=[]){return{type:n,default:t,required:t===void 0,parse:e,metadata:o.length?{options:o}:{},from(i){return this.sourceKey=i,this},validate(i,r="Custom validation failed"){return this.metadata={...this.metadata,validate:{fn:i,message:r}},this},min(i){return this.metadata={...this.metadata,min:i},this},max(i){return this.metadata={...this.metadata,max:i},this},transform(i){let r=this.parse;return this.parse=s=>i(r(s)),this},secret(){return this.metadata={...this.metadata,isSecret:!0},this},url(){return this.validate(i=>{try{return new URL(String(i)),!0}catch{return!1}},"Invalid URL format")},email(){let i=/^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/;return this.validate(r=>i.test(String(r)),"Invalid email format")},regex(i,r="Value does not match pattern"){return this.validate(s=>i.test(String(s)),r)},description(i){return this.metadata={...this.metadata,description:i},this}}}var m={string:n=>a("string",n,t=>String(t)),number:n=>a("number",n,t=>{let e=Number(t);if(isNaN(e))throw new Error(`Invalid number: ${t}`);return e}),boolean:n=>a("boolean",n,t=>{if(typeof t=="boolean")return t;if(t===void 0||t==="")return!1;let e=String(t).toLowerCase().trim();if(e==="true"||e==="1"||e==="yes"||e==="on")return!0;if(e==="false"||e==="0"||e==="no"||e==="off")return!1;throw new Error(`Invalid boolean: ${t}`)}),enum:(n,t)=>a("enum",t,e=>{if(!n.includes(e))throw new Error(`Value "${e}" is not one of: ${n.join(", ")}`);return e},n),array:(n,t=",")=>a("array",n,e=>Array.isArray(e)?e:typeof e!="string"?[]:e.split(t).map(o=>o.trim()).filter(Boolean))};export{f as parseDotEnv,l as reportErrors,m as s,u as safeEnv};
+import{a as u}from"./chunk-FBIIFJ67.js";import{a as l,b as f,c as m,d as h,e as y,f as g,g as D,h as T}from"./chunk-E625KLX5.js";import"./chunk-I7AUKTXE.js";function a(i,e,n,s=[]){return{type:i,default:e,required:e===void 0,parse:n,metadata:s.length?{options:s}:{},from(t){return this.sourceKey=t,this},validate(t,r="Custom validation failed"){return this.metadata={...this.metadata,validate:{fn:t,message:r}},this},min(t){return this.metadata={...this.metadata,min:t},this},max(t){return this.metadata={...this.metadata,max:t},this},transform(t){let r=this.parse;return this.parse=o=>t(r(o)),this},secret(){return this.metadata={...this.metadata,isSecret:!0},this},url(){return this.validate(t=>{try{return new URL(String(t)),!0}catch{return!1}},"Invalid URL format")},email(){return this.validate(t=>/^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/.test(String(t)),"Invalid email format")},regex(t,r="Value does not match pattern"){return this.validate(o=>t.test(String(o)),r)},description(t){return this.metadata={...this.metadata,description:t},this}}}var p={string:i=>a("string",i,e=>String(e)),number:i=>a("number",i,e=>{let n=Number(e);if(isNaN(n))throw new Error(`Invalid number: ${e}`);return n}),boolean:i=>a("boolean",i,e=>{if(typeof e=="boolean")return e;if(e===void 0||e==="")return!1;let n=String(e).toLowerCase().trim();if(["true","1","yes","on"].includes(n))return!0;if(["false","0","no","off"].includes(n))return!1;throw new Error(`Invalid boolean: ${e}`)}),enum:(i,e)=>a("enum",e,n=>{if(!i.includes(n))throw new Error(`Value "${n}" is not one of: ${i.join(", ")}`);return n},i),array:(i,e=",")=>a("array",i,n=>Array.isArray(n)?n:typeof n!="string"?[]:n.split(e).map(s=>s.trim()).filter(Boolean))};export{m as BUILD,l as DEV,f as SERVE,h as VITE_DEV_FLAG,y as VITE_PREFIX,g as formatErrorReport,u as parseDotEnv,D as reportErrors,p as s,T as safeEnv};

package/dist/{types-CFipqnoe.d.cts → types-C7kDNgjd.d.cts}

@@ -1,20 +1,15 @@
+declare const DEV = "development";
+declare const SERVE = "serve";
+declare const BUILD = "build";
+declare const VITE_DEV_FLAG = "VITE_DEV_SERVER";
+declare const VITE_PREFIX = "VITE_";
 type BaseType = "string" | "number" | "boolean" | "enum" | "array";
 interface FieldDefinition<T = any, D extends string = string> {
     type: BaseType;
     default?: T;
     required: boolean;
     sourceKey?: string;
-    metadata?: {
-        min?: number;
-        max?: number;
-        options?: T[];
-        description?: string;
-        isSecret?: boolean;
-        validate?: {
-            fn: (val: T) => boolean;
-            message: string;
-        };
-    };
+    metadata?: any;
     parse: (val: any) => T;
     from: (key: string) => FieldDefinition<T, D>;
     validate: (fn: (val: T) => boolean, message?: string) => FieldDefinition<T, D>;
@@ -35,9 +30,16 @@ interface EnvError {
     isSecret?: boolean;
 }
 type InferSchema<T> = {
-    [K in keyof T]: T[K] extends FieldDefinition<infer U, infer D> ? string extends D ? U : U & {
-        readonly __description?: D;
-    } : never;
+    [K in keyof T]: T[K] extends FieldDefinition<infer U, any> ? U : never;
 };
+interface SafeEnvOptions {
+    mode?: string;
+    loadProcessEnv?: boolean;
+    source?: Record<string, any>;
+    prefix?: string;
+    cwd?: string;
+    /** @internal */ manualSource?: boolean;
+    /** @internal */ devMode?: boolean;
+}
 
-export type { BaseType as B, EnvError as E, FieldDefinition as F, InferSchema as I, Schema as S };
+export { BUILD as B, DEV as D, type EnvError as E, type FieldDefinition as F, type InferSchema as I, type Schema as S, VITE_DEV_FLAG as V, type SafeEnvOptions as a, type BaseType as b, SERVE as c, VITE_PREFIX as d };

package/dist/{types-CFipqnoe.d.ts → types-C7kDNgjd.d.ts}

@@ -1,20 +1,15 @@
+declare const DEV = "development";
+declare const SERVE = "serve";
+declare const BUILD = "build";
+declare const VITE_DEV_FLAG = "VITE_DEV_SERVER";
+declare const VITE_PREFIX = "VITE_";
 type BaseType = "string" | "number" | "boolean" | "enum" | "array";
 interface FieldDefinition<T = any, D extends string = string> {
     type: BaseType;
     default?: T;
     required: boolean;
     sourceKey?: string;
-    metadata?: {
-        min?: number;
-        max?: number;
-        options?: T[];
-        description?: string;
-        isSecret?: boolean;
-        validate?: {
-            fn: (val: T) => boolean;
-            message: string;
-        };
-    };
+    metadata?: any;
     parse: (val: any) => T;
     from: (key: string) => FieldDefinition<T, D>;
     validate: (fn: (val: T) => boolean, message?: string) => FieldDefinition<T, D>;
@@ -35,9 +30,16 @@ interface EnvError {
     isSecret?: boolean;
 }
 type InferSchema<T> = {
-    [K in keyof T]: T[K] extends FieldDefinition<infer U, infer D> ? string extends D ? U : U & {
-        readonly __description?: D;
-    } : never;
+    [K in keyof T]: T[K] extends FieldDefinition<infer U, any> ? U : never;
 };
+interface SafeEnvOptions {
+    mode?: string;
+    loadProcessEnv?: boolean;
+    source?: Record<string, any>;
+    prefix?: string;
+    cwd?: string;
+    /** @internal */ manualSource?: boolean;
+    /** @internal */ devMode?: boolean;
+}
 
-export type { BaseType as B, EnvError as E, FieldDefinition as F, InferSchema as I, Schema as S };
+export { BUILD as B, DEV as D, type EnvError as E, type FieldDefinition as F, type InferSchema as I, type Schema as S, VITE_DEV_FLAG as V, type SafeEnvOptions as a, type BaseType as b, SERVE as c, VITE_PREFIX as d };

package/dist/vite.cjs

@@ -1 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkWXZ32K3Gcjs = require('./chunk-WXZ32K3G.cjs');require('./chunk-MODJPD2X.cjs');var _vite = require('vite');function m(t,i={}){return{name:"vite-plugin-safe-env",configResolved(r){let{envDir:o=r.root,prefix:e=r.envPrefix||"VITE_"}=i,s=r.mode,a=_vite.loadEnv.call(void 0, s,o,e);try{_chunkWXZ32K3Gcjs.b.call(void 0, t,{source:a,prefix:Array.isArray(e)?e[0]:e,loadProcessEnv:!1})}catch (e2){process.exit(1)}}}}exports.viteSafeEnv = m;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkSHSPQLLUcjs = require('./chunk-SHSPQLLU.cjs');require('./chunk-D6WM53FN.cjs');var _vite = require('vite');function g(v,f={}){let n=null,o=!1;return{name:"vite-plugin-safe-env",configResolved(e){o=e.command===_chunkSHSPQLLUcjs.b,process.env[_chunkSHSPQLLUcjs.d]=o?"true":"";let{envDir:t=e.root,prefix:r=e.envPrefix||_chunkSHSPQLLUcjs.e}=f,p=_vite.loadEnv.call(void 0, e.mode,t,r);try{_chunkSHSPQLLUcjs.h.call(void 0, v,{source:p,prefix:Array.isArray(r)?r[0]:r,loadProcessEnv:!1,throwOnError:!0}),n=null}catch(s){n=s,o?e.logger.error(s.message):(console.error(s.message),console.error(`\x1B[31m[safe-env] Fatal: Environment validation failed during build. Exiting...\x1B[0m
+`),process.exit(1))}},transform(e,t){if(o&&n&&(e.includes("import.meta.env")||e.includes("safeEnv"))){let r=new Error(n.plainMessage||n.message);throw r.stack="",r}return null}}}exports.viteSafeEnv = g;

package/dist/vite.d.cts

@@ -1,19 +1,9 @@
 import { Plugin } from 'vite';
-import { S as Schema } from './types-CFipqnoe.cjs';
+import { S as Schema } from './types-C7kDNgjd.cjs';
 
-interface ViteSafeEnvOptions {
-    /**
-     * 环境变量目录，默认为项目根目录
-     */
-    envDir?: string;
-    /**
-     * 环境变量前缀，默认是 VITE_
-     */
-    prefix?: string | string[];
-}
 /**
  * Vite 插件：在构建或开发启动时校验环境变量
  */
-declare function viteSafeEnv(schema: Schema, options?: ViteSafeEnvOptions): Plugin;
+declare function viteSafeEnv(schema: Schema, options?: any): Plugin;
 
 export { viteSafeEnv };

package/dist/vite.d.ts

@@ -1,19 +1,9 @@
 import { Plugin } from 'vite';
-import { S as Schema } from './types-CFipqnoe.js';
+import { S as Schema } from './types-C7kDNgjd.js';
 
-interface ViteSafeEnvOptions {
-    /**
-     * 环境变量目录，默认为项目根目录
-     */
-    envDir?: string;
-    /**
-     * 环境变量前缀，默认是 VITE_
-     */
-    prefix?: string | string[];
-}
 /**
  * Vite 插件：在构建或开发启动时校验环境变量
  */
-declare function viteSafeEnv(schema: Schema, options?: ViteSafeEnvOptions): Plugin;
+declare function viteSafeEnv(schema: Schema, options?: any): Plugin;
 
 export { viteSafeEnv };

package/dist/vite.js

@@ -1 +1,2 @@
-import{b as n}from"./chunk-UONNQTFU.js";import"./chunk-WZTPUQ3S.js";import{loadEnv as f}from"vite";function m(t,i={}){return{name:"vite-plugin-safe-env",configResolved(r){let{envDir:o=r.root,prefix:e=r.envPrefix||"VITE_"}=i,s=r.mode,a=f(s,o,e);try{n(t,{source:a,prefix:Array.isArray(e)?e[0]:e,loadProcessEnv:!1})}catch{process.exit(1)}}}}export{m as viteSafeEnv};
+import{b as a,d as i,e as l,h as m}from"./chunk-E625KLX5.js";import"./chunk-I7AUKTXE.js";import{loadEnv as u}from"vite";function g(v,f={}){let n=null,o=!1;return{name:"vite-plugin-safe-env",configResolved(e){o=e.command===a,process.env[i]=o?"true":"";let{envDir:t=e.root,prefix:r=e.envPrefix||l}=f,p=u(e.mode,t,r);try{m(v,{source:p,prefix:Array.isArray(r)?r[0]:r,loadProcessEnv:!1,throwOnError:!0}),n=null}catch(s){n=s,o?e.logger.error(s.message):(console.error(s.message),console.error(`\x1B[31m[safe-env] Fatal: Environment validation failed during build. Exiting...\x1B[0m
+`),process.exit(1))}},transform(e,t){if(o&&n&&(e.includes("import.meta.env")||e.includes("safeEnv"))){let r=new Error(n.plainMessage||n.message);throw r.stack="",r}return null}}}export{g as viteSafeEnv};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zh-moody/safe-env",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Type-safe environment variables for Node.js and Browser with schema validation.",
   "author": "Moody",
   "license": "MIT",

package/dist/chunk-MODJPD2X.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);var _path = require('path'); var _path2 = _interopRequireDefault(_path);function o(s){let i={},r=s.split(/\r?\n/);for(let f of r){let n=f.trim();if(!n||n.startsWith("#"))continue;let e=n.indexOf("=");if(e==-1)continue;let l=n.slice(0,e).trim(),t=n.slice(e+1).trim();(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))&&(t=t.slice(1,-1)),i[l]=t}return i}function g(s=".env",i){try{let r=_path2.default.resolve(i||process.cwd(),s);if(_fs2.default.existsSync(r))return o(_fs2.default.readFileSync(r,"utf-8"))}catch (e2){}return{}}exports.a = o; exports.b = g;

package/dist/chunk-UONNQTFU.js

@@ -1,3 +0,0 @@
-import{b as y}from"./chunk-WZTPUQ3S.js";function $(m){let e={r:"\x1B[31m",g:"\x1B[32m",y:"\x1B[33m",b:"\x1B[1m",res:"\x1B[0m",d:"\x1B[2m",cy:"\x1B[36m"},d=Math.max(80,process.stdout.columns||80)-10,f=Math.floor(d*.3),u=Math.floor(d*.5),l=(r,a)=>{let t=String(r),o=()=>t.length+(t.match(/[^\x00-\xff]/g)||[]).length;for(;o()>a;)t=t.slice(0,-1);return t+" ".repeat(a-o())};console.error(`
-${e.r}${e.b}\u274C SafeEnv Validation Failed${e.res}`),console.error(` ${e.b}${l("Key",f)} \u2502 ${l("Error",u)} \u2502 Value${e.res}`),console.error(e.d+"\u2500".repeat(d+5)+e.res),m.forEach(r=>{let a=r.isSecret?"********":r.value===void 0?"undefined":`"${r.value}"`,t=r.isSecret?e.y:r.value===void 0?e.d:e.cy;console.error(` ${e.y}${l(r.key,f)}${e.res} \u2502 ${e.r}${l(r.error,u)}${e.res} \u2502 ${t}${a}${e.res}`)}),console.error(e.d+"\u2500".repeat(d+5)+e.res),console.error(` ${e.g}\u{1F4A1} Tip: Check your .env files or schema definitions.${e.res}
-`)}function b(m,e={}){let{loadProcessEnv:d=!0,source:f,prefix:u="",cwd:l}=e,r;if(f!==void 0)r=f||{};else{let o=e.mode||(typeof process<"u"?process.env.NODE_ENV:"development"),s=[".env",`.env.${o}`,".env.local",`.env.${o}.local`],i={};for(let c of s)i={...i,...y(c,l)};r={...i,...d&&typeof process<"u"?process.env:{}}}let a={},t=[];for(let o in m){let s=m[o],i=s.sourceKey;if(!i){let n=u+o;r[n]!==void 0?i=n:r[o]!==void 0?i=o:i=u?n:o}let c=r[i];try{let n;if(c===void 0||c===""&&s.default!==void 0){if(s.required&&c===void 0)throw new Error("Required field missing");n=s.default}else n=s.parse(c);if(n!==void 0&&s.metadata){let{min:p,max:v,validate:E}=s.metadata;if(typeof n=="number"){if(p!==void 0&&n<p)throw new Error(`Below min ${p}`);if(v!==void 0&&n>v)throw new Error(`Above max ${v}`)}if(E&&!E.fn(n))throw new Error(E.message)}a[o]=n}catch(n){t.push({key:i,error:n.message,value:c,isSecret:s.metadata?.isSecret})}}if(t.length>0){$(t);let o=typeof process<"u"&&!!process.exit,s=typeof process<"u"&&process.env.NODE_ENV==="test";if(o&&!f&&!s)process.exit(1);else throw new Error("SafeEnv: Configuration validation failed.")}return Object.freeze(a)}export{$ as a,b};

package/dist/chunk-WXZ32K3G.cjs

@@ -1,3 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunkMODJPD2Xcjs = require('./chunk-MODJPD2X.cjs');function $(m){let e={r:"\x1B[31m",g:"\x1B[32m",y:"\x1B[33m",b:"\x1B[1m",res:"\x1B[0m",d:"\x1B[2m",cy:"\x1B[36m"},d=Math.max(80,process.stdout.columns||80)-10,f=Math.floor(d*.3),u=Math.floor(d*.5),l=(r,a)=>{let t=String(r),o=()=>t.length+(t.match(/[^\x00-\xff]/g)||[]).length;for(;o()>a;)t=t.slice(0,-1);return t+" ".repeat(a-o())};console.error(`
-${e.r}${e.b}\u274C SafeEnv Validation Failed${e.res}`),console.error(` ${e.b}${l("Key",f)} \u2502 ${l("Error",u)} \u2502 Value${e.res}`),console.error(e.d+"\u2500".repeat(d+5)+e.res),m.forEach(r=>{let a=r.isSecret?"********":r.value===void 0?"undefined":`"${r.value}"`,t=r.isSecret?e.y:r.value===void 0?e.d:e.cy;console.error(` ${e.y}${l(r.key,f)}${e.res} \u2502 ${e.r}${l(r.error,u)}${e.res} \u2502 ${t}${a}${e.res}`)}),console.error(e.d+"\u2500".repeat(d+5)+e.res),console.error(` ${e.g}\u{1F4A1} Tip: Check your .env files or schema definitions.${e.res}
-`)}function b(m,e={}){let{loadProcessEnv:d=!0,source:f,prefix:u="",cwd:l}=e,r;if(f!==void 0)r=f||{};else{let o=e.mode||(typeof process<"u"?process.env.NODE_ENV:"development"),s=[".env",`.env.${o}`,".env.local",`.env.${o}.local`],i={};for(let c of s)i={...i,..._chunkMODJPD2Xcjs.b.call(void 0, c,l)};r={...i,...d&&typeof process<"u"?process.env:{}}}let a={},t=[];for(let o in m){let s=m[o],i=s.sourceKey;if(!i){let n=u+o;r[n]!==void 0?i=n:r[o]!==void 0?i=o:i=u?n:o}let c=r[i];try{let n;if(c===void 0||c===""&&s.default!==void 0){if(s.required&&c===void 0)throw new Error("Required field missing");n=s.default}else n=s.parse(c);if(n!==void 0&&s.metadata){let{min:p,max:v,validate:E}=s.metadata;if(typeof n=="number"){if(p!==void 0&&n<p)throw new Error(`Below min ${p}`);if(v!==void 0&&n>v)throw new Error(`Above max ${v}`)}if(E&&!E.fn(n))throw new Error(E.message)}a[o]=n}catch(n){t.push({key:i,error:n.message,value:c,isSecret:_optionalChain([s, 'access', _ => _.metadata, 'optionalAccess', _2 => _2.isSecret])})}}if(t.length>0){$(t);let o=typeof process<"u"&&!!process.exit,s=typeof process<"u"&&process.env.NODE_ENV==="test";if(o&&!f&&!s)process.exit(1);else throw new Error("SafeEnv: Configuration validation failed.")}return Object.freeze(a)}exports.a = $; exports.b = b;

package/dist/chunk-WZTPUQ3S.js

@@ -1 +0,0 @@
-import c from"fs";import a from"path";function o(s){let i={},r=s.split(/\r?\n/);for(let f of r){let n=f.trim();if(!n||n.startsWith("#"))continue;let e=n.indexOf("=");if(e==-1)continue;let l=n.slice(0,e).trim(),t=n.slice(e+1).trim();(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))&&(t=t.slice(1,-1)),i[l]=t}return i}function g(s=".env",i){try{let r=a.resolve(i||process.cwd(),s);if(c.existsSync(r))return o(c.readFileSync(r,"utf-8"))}catch{}return{}}export{o as a,g as b};