@zh-moody/safe-env 0.4.0 → 0.4.2

package/README.en.md

@@ -6,9 +6,9 @@
 
 [简体中文](./README.md) | English
 
-**Say goodbye to `undefined`! Intercept all configuration risks at the first line of your app.**
+**Say goodbye to `undefined`! Intercept all configuration hazards on the first line of your app.**
 
-Whether you are writing Vue, React, or Node.js, environment variables are often a source of production incidents. `safe-env` ensures your app always runs on the expected configuration through strong-typed Schema validation and runtime protection.
+Whether you're building with Vue, React, or Node.js, environment variables are often the root of production incidents. `safe-env` ensures your application always runs on top of expected configurations through strong schema validation and runtime protection.
 
 ---
 
@@ -16,14 +16,14 @@ Whether you are writing Vue, React, or Node.js, environment variables are often
 
 ---
 
-### 🚀 Core Features
+### 🚀 Key Features
 
-- **Build-time Validation**: Provides a Vite plugin to intercept invalid configurations during development or build.
-- **Sensitive Data Masking**: Supports `.secret()` to ensure keys and passwords are masked as `********` in logs or error tables.
-- **Runtime Immutability**: Parsed config objects are deep-frozen with `Object.freeze` by default, preventing any illegal runtime modification.
-- **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.
+- **Build-time Pre-validation**: Vite plugin intercepts invalid configurations during dev startup or build.
+- **Sensitive Data Masking**: Supports `.secret()` to ensure keys/tokens are masked in logs or error reports.
+- **Runtime Lazy Protection**: ⚡ **HPC Ready**. Powered by **Lazy Proxy**, achieving $O(1)$ startup latency and on-demand read-only protection.
+- **Monorepo Ready**: Explicitly specify `.env` search directories via `cwd`, fitting complex architectures.
+- **IDE Enhancement**: `.description()` allows you to view variable purposes/documentation via hover.
+- **Robust Parsing**: Built-in `s.array()`, `s.boolean()` with intelligent conversion and `.transform()` pipe processing.
 
 ---
 
@@ -37,9 +37,15 @@ npm install @zh-moody/safe-env
 
 ### 🚀 Quick Start
 
-#### 🔹 [Vite / React / Vue]
+Ensure you have a **`.env`** file in your project root before starting:
 
-For frontend projects, use the Vite plugin for **build-time validation**.
+```bash
+# .env example
+VITE_API_URL=https://api.example.com
+VITE_PORT=8080
+```
+
+#### 🔹 [Vite / React / Vue] Usage
 
 **1. Configure Vite Plugin (`vite.config.ts`):**
 
@@ -52,14 +58,14 @@ export default {
 };
 ```
 
-**2. Define and Export Config (`src/env.ts`):**
+**2. Define and Export Schema (`src/env.ts`):**
 
 ```typescript
-import { safeEnv, s } from "@zh-moody/safe-env";
+import { safeEnv, s, isUrl } 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"),
+  VITE_API_URL: s.string().validate(isUrl, "Invalid URL").description("Backend API endpoint"),
+  VITE_PORT: s.number(3000).description("Server port"),
 };
 
 export const env = safeEnv(schema, {
@@ -67,33 +73,22 @@ export const env = safeEnv(schema, {
 });
 ```
 
-> **💡 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;
-> }
-> ```
-
 ---
 
-#### 🔸 [Node.js / Server-side]
+#### 🔸 [Node.js / Server-side] Usage
 
-In Node.js, the library automatically looks for and parses `.env` files on disk.
-
-**1. Define Config (`src/config.ts`):**
+**1. Define Configuration (`src/config.ts`):**
 
 ```typescript
 import { safeEnv, s } from "@zh-moody/safe-env";
 
 const config = safeEnv(
   {
-    DB_PASSWORD: s.string().secret().description("Database Password"),
+    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
+    // Explicitly specify .env root in Monorepo or deployment environments
     // cwd: '/path/to/project-root'
   },
 );
@@ -105,59 +100,100 @@ export default config;
 
 ### 🛠️ API Reference
 
-#### 1. Define Fields (`s.xxx`)
+#### 1. Global Options (`safeEnv`)
+
+`safeEnv(schema, options?)` accepts an optional object to control the parsing engine:
+
+- **`useCache (boolean)`**: Enable global memoization (default `true`). Significantly improves performance for high-frequency calls.
+- **`refreshCache (boolean)`**: Force flush and re-read disk/process variables (default `false`). Essential for HMR or switching envs in automated tests.
+- **`cwd (string)`**: Specify the search root for `.env` files (Node.js).
+- **`source (Record<string, any>)`**: Manually provide the data source (e.g., `import.meta.env`), skipping automatic file retrieval.
+- **`prefix (string)`**: Filter prefix for env variables (default `VITE_`).
+
+#### 2. Field Definitions (`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`.
-- `s.array(default?, separator?)`: Splits string by separator (default `,`) into an array.
-- `s.enum(options, default?)`: Value must be one of the provided options.
+- **`s.string(default?)`**: 
+  - **Logic**: If no default is provided, it's marked as **Required**.
+- **`s.number(default?)`**: 
+  - **Logic**: Executes `Number(v)`. Aborts with an error if result is `NaN` (e.g., `VITE_PORT=abc`).
+- **`s.boolean(default?)`**: Intelligent Boolean parsing.
+  - **Logic**: 
+    - **`true`**: `true`, `"true"`, `"1"`, `"yes"`, `"on"`.
+    - **`false`**: `false`, `"false"`, `"0"`, `"no"`, `"off"`, or empty strings.
+- **`s.array(default?, separator?)`**: 
+  - **Logic**: Default separator is `,`. Supports custom ones like `s.array([], '|')`.
+- **`s.enum(options, default?)`**: 
+  - **Logic**: Input must be one of the `options`. Perfect for mode locking (`dev`, `prod`, `test`).
 
-#### 2. Validation & Enhancement (Chainable)
+#### 3. Enhancements & Validation (Chaining)
 
-- **`.secret()`**: Masks the value as `********` in error reports.
+- **`.secret()`**: Mask sensitive data in error reports (`********`).
   ```typescript
   PASSWORD: s.string().secret();
   ```
-- **`.url()` / `.email()`**: Built-in format validation.
+- **`.description(text)`**: Hover hints for IDEs.
   ```typescript
-  API_URL: s.string().url();
+  PORT: s.number(3000).description("Server port");
   ```
-- **`.regex(pattern, msg?)`**: Custom regex validation.
+- **`.optional()`**: Explicitly declare this field as optional. Missing values drop back to `undefined` instead of throwing an error.
   ```typescript
-  VERSION: s.string().regex(/^v\d+\.\d+\.\d+$/, "Invalid format");
+  TRACKING_ID: s.string().optional();
   ```
-- **`.description(text)`**: Adds a description for IDE hover hints.
+- **`.requiredIf(fn)`**: Context-Aware validation. Dynamically determine if the field is required based on values parsed so far.
   ```typescript
-  PORT: s.number(3000).description("Server Port");
+  // ICP_NUMBER is required ONLY if parsed REGION equals 'CN'
+  ICP_NUMBER: s.string().requiredIf((ctx) => ctx.parsed.REGION === 'CN');
   ```
-- **`.transform(fn)`**: Custom data transformation, supports multi-level piping.
+- **`.transform(fn)`**: Custom data transformation (Multi-level pipe).
   ```typescript
   NAME: s.string()
     .transform((v) => v.trim())
     .transform((v) => v.toUpperCase());
   ```
-- **`.from(key)`**: Maps environment variable name (Alias).
+- **`.from(key)`**: Alias mapping (Environment key mapping).
   ```typescript
   port: s.number().from("VITE_SERVER_PORT");
   ```
-- **`.min(n)` / `.max(n)`**: Constraints for number values.
+- **`.min(n)` / `.max(n)`**: Number range constraints.
   ```typescript
   PORT: s.number().min(1024).max(65535);
   ```
-- **`.validate(fn, msg?)`**: Fully custom validation logic.
+- **`.validate(fn, msg?)`**: Custom logic validation. Supports context passing and native pure-function integration (See "Built-in Validation Rules").
   ```typescript
   INTERNAL_URL: s.string().validate(
-    (v) => v.endsWith(".internal.com"),
+    (v, ctx) => v.endsWith(".internal.com"),
     "Must be internal",
   );
   ```
 
+#### 4. Built-in Validation Rules
+
+To support an infinite amount of business validation logic without blowing up bundle sizes, all heavy string validators (like Regex) and transformers are separated from the core class. They are instead provided as **pure, perfectly tree-shakable higher-order functions** that can be imported directly.
+
+Seamlessly integrate them using native `validate`/`transform` methods:
+
+```typescript
+import { safeEnv, s, isUrl, isIPv4, isUUID, isJSON, toJSON, trim } from "@zh-moody/safe-env";
+
+const schema = {
+  // Dirty data processing: Trim whitespaces, then validate IPv4
+  HOST: s.string().transform(trim).validate(isIPv4, "Must be valid IPv4"),
+  // Serialization mapping natively
+  PAYLOAD: s.string().validate(isJSON).transform(toJSON),
+  // Common URL link checking
+  API_URL: s.string().validate(isUrl, "Must be a valid URL")
+};
+```
+
+Currently, `@zh-moody/safe-env` exports the following utility functions out-of-the-box:
+- **Validators**: `isUrl`, `isEmail`, `isIPv4`, `isUUID`, `isBase64`, `isJSON`, `isHexColor`, `isObjectId`, `matchesRegex(pattern)`
+- **Transformers**: `trim`, `toLowerCase`, `toUpperCase`, `toJSON`
+
 ---
 
 ### 🎨 Error Reporting
 
-When validation fails, `safe-env` outputs a structured, adaptive table in the console showing: **Key / Error Reason / Current Value (Masked)**.
+When validation fails, `safe-env` outputs an adaptive structured table showing: **Key / Error / Current Value (Masked)**.
 
 ---
 

package/README.md

@@ -37,6 +37,14 @@ npm install @zh-moody/safe-env
 
 ### 🚀 快速上手
 
+在开始之前，请确保你的项目根目录下已有相应的 **`.env`** 配置文件：
+
+```bash
+# .env 示例
+VITE_API_URL=https://api.example.com
+VITE_PORT=8080
+```
+
 #### 🔹 [Vite / React / Vue] 使用
 
 在前端，建议配合 Vite 插件实现**构建时校验**。
@@ -105,15 +113,33 @@ export default config;
 
 ### 🛠️ API 详解
 
-#### 1. 定义字段 (`s.xxx`)
+#### 1. 全局配置与选项 (`safeEnv`)
+
+`safeEnv(schema, options?)` 接收一个可选的配置对象，用于深度控制解析行为：
+
+- **`useCache (boolean)`**: 是否启用全局缓存（默认 `true`）。开启后，后续调用将优先从内存获取已解析的配置，极大提升高频调用的性能。
+- **`refreshCache (boolean)`**: 强制刷新并重新读取磁盘/进程变量（默认 `false`）。常用于开发环境下的热更新或自动化测试中切换不同的环境配置。
+- **`cwd (string)`**: 显式指定 `.env` 文件的检索根目录（Node.js 环境）。
+- **`source (Record<string, any>)`**: 手动指定数据源（如 `import.meta.env` 或 `process.env`），跳过自动文件检索。
+- **`prefix (string)`**: 过滤环境变量的前缀（默认 `VITE_`）。
+
+#### 2. 定义字段 (`s.xxx`)
 
-- `s.string(default?)`: 字符串。若无默认值则必填。
-- `s.number(default?)`: 数字。自动转换为 `number` 类型并校验合法性。
-- `s.boolean(default?)`: 布尔型。支持将 `"true"`, `"1"`, `"yes"`, `"on"` 解析为 `true`。
-- `s.array(default?, separator?)`: 数组型。支持将字符串按分隔符（默认 `,`）拆分为数组。
-- `s.enum(options, default?)`: 枚举。值必须在预设数组中。
+- **`s.string(default?)`**: 字符串解析。
+  - **逻辑**: 如果不提供默认值，该字段将被标记为 **必填 (Required)**，若 `.env` 中缺失会触发报错。
+- **`s.number(default?)`**: 数字解析。
+  - **逻辑**: 自动执行 `Number(v)`。若转换结果为 `NaN`（如 `VITE_PORT=abc`），解析会立即中止并报错。
+- **`s.boolean(default?)`**: 增强布尔解析。
+  - **逻辑**: 支持多种真假语义的自动转换：
+    - **`true`**: `true`, `"true"`, `"1"`, `"yes"`, `"on"`。
+    - **`false`**: `false`, `"false"`, `"0"`, `"no"`, `"off"`, 以及空字符串。
+- **`s.array(default?, separator?)`**: 数组解析。
+  - **逻辑**: 默认使用 `,` 作为分隔符。支持自定义，如 `s.array([], '|')`。
+  - **示例**: `VITE_MODS=auth,cache` ➡️ `['auth', 'cache']`。
+- **`s.enum(options, default?)`**: 枚举约束。
+  - **逻辑**: 强制输入值必须在 `options` 数组中，否则报错。非常适用于多环境（`dev`, `prod`, `test`）的模式锁定。
 
-#### 2. 校验与增强 (链式调用)
+#### 3. 校验与增强 (链式调用)
 
 每个字段都可以通过链式调用进行深度定制：
 
@@ -121,13 +147,14 @@ export default config;
   ```typescript
   PASSWORD: s.string().secret();
   ```
-- **`.url()` / `.email()`**: 常用格式校验。
+- **`.optional()`**: 显式声明该字段为非必填。解析如果不存在，则返回 `undefined` 而不报错。
   ```typescript
-  API_URL: s.string().url();
+  TRACKING_ID: s.string().optional();
   ```
-- **`.regex(pattern, msg?)`**: 自定义正则校验。
+- **`.requiredIf(fn)`**: 联动校验（Context-Aware）。依据当前已解析的其他配置动态决定该字段是否必填。
   ```typescript
-  VERSION: s.string().regex(/^v\d+\.\d+\.\d+$/, "格式错误");
+  // 只有当 REGION 明确被设为 CN 时，ICP 备案号才是必填的
+  ICP_NUMBER: s.string().requiredIf((ctx) => ctx.parsed.REGION === 'CN');
   ```
 - **`.description(text)`**: 添加变量描述，映射到 IDE 悬停提示中。
   ```typescript
@@ -147,14 +174,36 @@ export default config;
   ```typescript
   PORT: s.number().min(1024).max(65535);
   ```
-- **`.validate(fn, msg?)`**: 完全自定义的逻辑校验。
+- **`.validate(fn, msg?)`**: 传入纯函数进行校验。支持上下文透传以及库内置高阶纯函数的直接切入（详情见下文 "内置验证库"）。
   ```typescript
   INTERNAL_URL: s.string().validate(
-    (v) => v.endsWith(".internal.com"),
+    (v, ctx) => v.endsWith(".internal.com"),
     "Must be internal",
   );
   ```
 
+#### 4. 内置验证库
+
+为了支持无限的业务规则而不造成构建体积膨胀，所有重型字符串校验（长正则）和转换规则均剔除出了核心类，化作了**支持完美 Tree-Shaking 的扁平化导出的高阶函数**。只有你明确通过 `import` 引用的微小单点代码才会被真正打包！
+
+使用原生 `validate`/`transform` 方法无隙集成它们：
+```typescript
+import { safeEnv, s, isUrl, isIPv4, isUUID, isJSON, toJSON, trim } from "@zh-moody/safe-env";
+
+const schema = {
+  // 脏数据清理：先裁剪首尾空格、后校验 IPv4 格式
+  HOST: s.string().transform(trim).validate(isIPv4, "必需是合法 IPv4"),
+  // 支持链式序列化
+  PAYLOAD: s.string().validate(isJSON).transform(toJSON),
+  // 甚至只是普通的链接和格式判定
+  API_URL: s.string().validate(isUrl, "必须抛出无效链接")
+};
+```
+
+目前的 `@zh-moody/safe-env` 原生伴随导出了以下优质清洗函数组合，按需使用即可：
+- **Validators (验证器)**: `isUrl`, `isEmail`, `isIPv4`, `isUUID`, `isBase64`, `isJSON`, `isHexColor`, `isObjectId`, `matchesRegex(pattern)`
+- **Transformers (转换器)**: `trim`, `toLowerCase`, `toUpperCase`, `toJSON`
+
 ---
 
 ### 🎨 错误报告

package/dist/chunk-5KPNMU6R.js

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

package/dist/chunk-6NHVLNFI.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 F="development",j= exports.b ="serve",K= exports.c ="build",C= exports.d ="VITE_DEV_SERVER",k= exports.e ="VITE_";var O=typeof window<"u"&&typeof window.document<"u";function b(i,o=!0){if(O)return`SafeEnv Validation Failed: ${i.map(s=>`${s.key} (${s.error})`).join(", ")}`;let d={r:"\x1B[31m",g:"\x1B[32m",y:"\x1B[33m",b:"\x1B[1m",res:"\x1B[0m",d:"\x1B[2m",cy:"\x1B[36m"},n=(s,p)=>{let r=String(s),x=()=>r.length+(r.match(/[^\x00-\xff]/g)||[]).length;for(;x()>p;)r=r.slice(0,-1);return r+" ".repeat(p-x())},c=Math.max(80,(typeof process<"u"?process.stdout.columns:80)||80)-10,u=Math.floor(c*.3),y=Math.floor(c*.5),e=o?d:{r:"",g:"",y:"",b:"",res:"",d:"",cy:""},f=`
+${e.r}${e.b}\u274C SafeEnv Validation Failed${e.res}
+`;return f+=` ${e.b}${n("Key",u)} \u2502 ${n("Error",y)} \u2502 Value${e.res}
+`,f+=e.d+"\u2500".repeat(c+5)+e.res+`
+`,i.forEach(s=>{let p=s.value===void 0?"undefined":s.isSecret?"********":`"${s.value}"`,r=s.value===void 0?e.d:s.isSecret?e.y:e.cy;f+=` ${e.y}${n(s.key,u)}${e.res} \u2502 ${e.r}${n(s.error,y)}${e.res} \u2502 ${r}${p}${e.res}
+`}),f+=e.d+"\u2500".repeat(c+5)+e.res+`
+`,f+=` ${e.g}\u{1F4A1} Tip: Check your .env files or schema definitions.${e.res}
+`,f}function _(i){if(O){console.group("%c \u274C SafeEnv Validation Failed ","background: #fee2e2; color: #b91c1c; font-weight: bold; padding: 4px; border-radius: 2px;");let o=i.reduce((d,n)=>(d[n.key]={"Error Message":n.error,"Current Value":n.value===void 0?"undefined":n.isSecret?"********":n.value},d),{});console.table(o),console.log("%c \u{1F4A1} Tip: Check your .env files or schema definitions. ","color: #059669; font-style: italic;"),console.groupEnd()}else console.error(b(i,!0))}var l={},$=new WeakMap;function P(i){let o=b(i,!1);return new Proxy({},{get(d,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:
+${o}`)},ownKeys(){return[]},getOwnPropertyDescriptor(){}})}var w="[safe-env] Cannot modify read-only environment variables.";function I(i){if($.has(i))return $.get(i);let o=new Proxy(i,{get(d,n){if(n==="__isSafeEnv")return!0;let c=Reflect.get(d,n);return c!==null&&typeof c=="object"&&!Object.isFrozen(c)?I(c):c},set(){throw new Error(w)},deleteProperty(){throw new Error(w)},defineProperty(){throw new Error(w)},setPrototypeOf(){throw new Error(w)}});return $.set(i,o),o}function X(i,o={}){let{loadProcessEnv:d=!0,prefix:n=k,cwd:c,useCache:u=!0,refreshCache:y=!1,envLoader:e}=o;if(y)for(let t in l)delete l[t];let f=typeof window<"u",s=typeof process<"u"&&(!!process.env.VITE||!!process.env[C]),p=f||s||"source"in o,r={},x=!1;if("source"in o)o.source===void 0?(x=!0,r={}):r=o.source;else if(u&&!y&&Object.keys(l).length>0)r=l;else if(typeof process<"u"&&!f)try{let t=o.mode||process.env.NODE_ENV||F,a={};if(e)for(let v of[".env",`.env.${t}`,".env.local",`.env.${t}.local`])a={...a,...e(v,c)};r={...a,...d?process.env:{}}}catch (e2){r={}}u&&!y&&Object.keys(l).length>0?Object.keys(r).length===0?r=l:Object.assign(l,r):u&&Object.keys(r).length>0&&Object.assign(l,r);let h={},E=[];for(let t in i){let a=i[t],v=n&&!t.startsWith(n)?n+t:t,S=a.sourceKey||(r[v]!==void 0?v:r[t]!==void 0?t:v),m=r[S],R={source:r,parsed:h};try{let D=typeof a.required=="function"?a.required(R):a.required;if(m===void 0||m===""&&a.default!==void 0){if(D&&m===void 0)throw new Error("Missing required field");h[t]=a.default}else{let g=a.parse(m,R);if(g!==void 0&&a.metadata){let{min:T,max:V}=a.metadata;if(typeof g=="number"){if(T!==void 0&&g<T)throw new Error(`Below min ${T}`);if(V!==void 0&&g>V)throw new Error(`Above max ${V}`)}}h[t]=g}}catch(D){E.push({key:S,error:D.message,value:m,isSecret:_optionalChain([a, 'access', _2 => _2.metadata, 'optionalAccess', _3 => _3.isSecret])})}}if(E.length>0){if(o.throwOnError){let t=new Error(b(E,!0));throw t.plainMessage=b(E,!1),t}return x||_(E),typeof process<"u"&&process.exit&&!p&&process.exit(1),P(E)}return I(h)}exports.a = F; exports.b = j; exports.c = K; exports.d = C; exports.e = k; exports.f = b; exports.g = _; exports.h = X;

package/dist/chunk-JBML47XC.js

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

package/dist/chunk-TR6KYAQI.cjs

@@ -0,0 +1 @@
+"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 m(r){let n={},i=r.split(/\r?\n/);for(let d of i){let e=d.trim();if(!e||e.startsWith("#"))continue;let o=e.indexOf("=");if(o===-1)continue;let s=e.slice(0,o).trim(),t=e.slice(o+1).trim();if(!t){n[s]="";continue}let c=t[0];if(c==='"'||c==="'"){let l=t.indexOf(c,1);if(l!==-1){n[s]=t.slice(1,l);continue}}let f=t.indexOf("#");f!==-1&&(t=t.slice(0,f).trim()),n[s]=t}return n}function h(r=".env",n){try{let i=_path2.default.resolve(n||process.cwd(),r);if(_fs2.default.existsSync(i))return m(_fs2.default.readFileSync(i,"utf-8"))}catch (e2){}return{}}exports.a = m; exports.b = h;

package/dist/fs-browser.cjs

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

package/dist/fs-browser.js

@@ -1 +1 @@
-import"./chunk-I7AUKTXE.js";function r(n=".env",t){return{}}export{r as loadDotEnv};
+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}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }var _chunkPLO26PP5cjs = require('./chunk-PLO26PP5.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 _chunkPLO26PP5cjs.a.call(void 0, _fs2.default.readFileSync(r,"utf-8"))}catch (e2){}return{}}exports.loadDotEnv = p;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkTR6KYAQIcjs = require('./chunk-TR6KYAQI.cjs');exports.loadDotEnv = _chunkTR6KYAQIcjs.b;

package/dist/fs-node.js

@@ -1 +1 @@
-import{a as t}from"./chunk-7CVG4I6F.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};
+import{b as a}from"./chunk-5KPNMU6R.js";export{a as loadDotEnv};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkPLO26PP5cjs = require('./chunk-PLO26PP5.cjs');var _chunkPBYVLIUGcjs = require('./chunk-PBYVLIUG.cjs');require('./chunk-D6WM53FN.cjs');function a(r,e,n,s=[]){return{type:r,default:e,required:e===void 0,parse:n,metadata:s.length?{options:s}:{},from(t){return this.sourceKey=t,this},validate(t,i="Custom validation failed"){return this.metadata={...this.metadata,validate:{fn:t,message:i}},this},min(t){return this.metadata={...this.metadata,min:t},this},max(t){return this.metadata={...this.metadata,max:t},this},transform(t){let i=this.parse;return this.parse=o=>t(i(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,i="Value does not match pattern"){return this.validate(o=>t.test(String(o)),i)},description(t){return this.metadata={...this.metadata,description:t},this}}}var m={string:r=>a("string",r,e=>String(e)),number:r=>a("number",r,e=>{let n=Number(e);if(isNaN(n))throw new Error(`Invalid number: ${e}`);return n}),boolean:r=>a("boolean",r,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:(r,e)=>a("enum",e,n=>{if(!r.includes(n))throw new Error(`Value "${n}" is not one of: ${r.join(", ")}`);return n},r),array:(r,e=",")=>a("array",r,n=>Array.isArray(n)?n:typeof n!="string"?[]:n.split(e).map(s=>s.trim()).filter(Boolean))};exports.BUILD = _chunkPBYVLIUGcjs.c; exports.DEV = _chunkPBYVLIUGcjs.a; exports.SERVE = _chunkPBYVLIUGcjs.b; exports.VITE_DEV_FLAG = _chunkPBYVLIUGcjs.d; exports.VITE_PREFIX = _chunkPBYVLIUGcjs.e; exports.formatErrorReport = _chunkPBYVLIUGcjs.f; exports.parseDotEnv = _chunkPLO26PP5cjs.a; exports.reportErrors = _chunkPBYVLIUGcjs.g; exports.s = m; exports.safeEnv = _chunkPBYVLIUGcjs.h;
+"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 _chunkTR6KYAQIcjs = require('./chunk-TR6KYAQI.cjs');var _chunk6NHVLNFIcjs = require('./chunk-6NHVLNFI.cjs');var o=class{constructor(n,e,r,i=[]){this.type=n,this.default=e,this.required=e===void 0,this.parse=r,this.metadata=i.length?{options:i}:{}}from(n){return this.sourceKey=n,this}optional(){return this.required=!1,this}requiredIf(n){return this.required=n,this}validate(n,e="Custom validation failed"){let r=this.parse;return this.parse=(i,a)=>{let s=r(i,a);if(!n(s,a))throw new Error(e);return s},this}min(n){return this.metadata={...this.metadata,min:n},this}max(n){return this.metadata={...this.metadata,max:n},this}transform(n){let e=this.parse;return this.parse=(r,i)=>n(e(r,i),i),this}secret(){return this.metadata={...this.metadata,isSecret:!0},this}description(n){return this.metadata={...this.metadata,description:n},this}},m= exports.s ={string:t=>new o("string",t,n=>String(n)),number:t=>new o("number",t,n=>{let e=Number(n);if(isNaN(e))throw new Error(`Invalid number: ${n}`);return e}),boolean:t=>new o("boolean",t,n=>{if(typeof n=="boolean")return n;if(n===void 0||n==="")return!1;let e=String(n).toLowerCase().trim();if(["true","1","yes","on"].includes(e))return!0;if(["false","0","no","off"].includes(e))return!1;throw new Error(`Invalid boolean: ${n}`)}),enum:(t,n)=>new o("enum",n,e=>{if(!t.includes(e))throw new Error(`Value "${e}" is not one of: ${t.join(", ")}`);return e},t),array:(t,n=",")=>new o("array",t,e=>Array.isArray(e)?e:typeof e!="string"?[]:e.split(n).map(r=>r.trim()).filter(Boolean))};var b=t=>{try{return new URL(String(t)),!0}catch (e2){return!1}},D= exports.isEmail =t=>/^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/.test(String(t)),S= exports.matchesRegex =t=>n=>t.test(String(n)),T= exports.isIPv4 =t=>/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/.test(String(t)),F= exports.isUUID =t=>/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(t)),C= exports.isBase64 =t=>/^(?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{2}==|[A-Za-z0-9+\/]{3}=)?$/.test(String(t)),E= exports.isJSON =t=>{try{return JSON.parse(String(t)),!0}catch (e3){return!1}},N= exports.isHexColor =t=>/^#?([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/.test(String(t)),$= exports.isObjectId =t=>/^[0-9a-fA-F]{24}$/.test(String(t)),k= exports.trim =t=>String(t).trim(),v= exports.toLowerCase =t=>String(t).toLowerCase(),I= exports.toUpperCase =t=>String(t).toUpperCase(),O= exports.toJSON =t=>{try{return JSON.parse(String(t))}catch (e4){throw new Error("Invalid JSON string")}};function q(t,n={}){let e=typeof process<"u"&&(_optionalChain([process, 'access', _ => _.release, 'optionalAccess', _2 => _2.name])==="node"||!!_optionalChain([process, 'access', _3 => _3.versions, 'optionalAccess', _4 => _4.node]));return _chunk6NHVLNFIcjs.h.call(void 0, t,{...n,envLoader:e?_chunkTR6KYAQIcjs.b:void 0})}exports.BUILD = _chunk6NHVLNFIcjs.c; exports.DEV = _chunk6NHVLNFIcjs.a; exports.SERVE = _chunk6NHVLNFIcjs.b; exports.VITE_DEV_FLAG = _chunk6NHVLNFIcjs.d; exports.VITE_PREFIX = _chunk6NHVLNFIcjs.e; exports.formatErrorReport = _chunk6NHVLNFIcjs.f; exports.isBase64 = C; exports.isEmail = D; exports.isHexColor = N; exports.isIPv4 = T; exports.isJSON = E; exports.isObjectId = $; exports.isUUID = F; exports.isUrl = b; exports.matchesRegex = S; exports.parseDotEnv = _chunkTR6KYAQIcjs.a; exports.reportErrors = _chunk6NHVLNFIcjs.g; exports.s = m; exports.safeEnv = q; exports.toJSON = O; exports.toLowerCase = v; exports.toUpperCase = I; exports.trim = k;

package/dist/index.d.cts

@@ -1,10 +1,5 @@
-import { S as Schema, a as SafeEnvOptions, I as InferSchema, F as FieldDefinition, E as EnvError } from './types-Bx-JEkTH.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-Bx-JEkTH.cjs';
-
-declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions & {
-    throwOnError?: boolean;
-    useCache?: boolean;
-}): Readonly<InferSchema<T>>;
+import { F as FieldDefinition, E as EnvError, S as Schema, a as SafeEnvOptions, I as InferSchema } from './types-BsDPVktI.cjs';
+export { B as BUILD, b as BaseType, D as DEV, c as SERVE, V as VITE_DEV_FLAG, d as VITE_PREFIX, e as ValidationContext } from './types-BsDPVktI.cjs';
 
 declare const s: {
     string: (d?: string) => FieldDefinition<string>;
@@ -14,6 +9,20 @@ declare const s: {
     array: (d?: string[], sep?: string) => FieldDefinition<string[]>;
 };
 
+declare const isUrl: (v: string) => boolean;
+declare const isEmail: (v: string) => boolean;
+declare const matchesRegex: (pattern: RegExp) => (v: string) => boolean;
+declare const isIPv4: (v: string) => boolean;
+declare const isUUID: (v: string) => boolean;
+declare const isBase64: (v: string) => boolean;
+declare const isJSON: (v: string) => boolean;
+declare const isHexColor: (v: string) => boolean;
+declare const isObjectId: (v: string) => boolean;
+declare const trim: (v: string) => string;
+declare const toLowerCase: (v: string) => string;
+declare const toUpperCase: (v: string) => string;
+declare const toJSON: (v: string) => any;
+
 /***
  * 将 .env 内容字符串解析为对象
  * 兼容带引号的值、多层引号内部的注释标识符以及行尾注释
@@ -23,4 +32,9 @@ 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, SafeEnvOptions, Schema, formatErrorReport, parseDotEnv, reportErrors, s, safeEnv };
+declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions & {
+    throwOnError?: boolean;
+    useCache?: boolean;
+}): Readonly<InferSchema<T>>;
+
+export { EnvError, FieldDefinition, InferSchema, SafeEnvOptions, Schema, formatErrorReport, isBase64, isEmail, isHexColor, isIPv4, isJSON, isObjectId, isUUID, isUrl, matchesRegex, parseDotEnv, reportErrors, s, safeEnv, toJSON, toLowerCase, toUpperCase, trim };

package/dist/index.d.ts

@@ -1,10 +1,5 @@
-import { S as Schema, a as SafeEnvOptions, I as InferSchema, F as FieldDefinition, E as EnvError } from './types-Bx-JEkTH.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-Bx-JEkTH.js';
-
-declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions & {
-    throwOnError?: boolean;
-    useCache?: boolean;
-}): Readonly<InferSchema<T>>;
+import { F as FieldDefinition, E as EnvError, S as Schema, a as SafeEnvOptions, I as InferSchema } from './types-BsDPVktI.js';
+export { B as BUILD, b as BaseType, D as DEV, c as SERVE, V as VITE_DEV_FLAG, d as VITE_PREFIX, e as ValidationContext } from './types-BsDPVktI.js';
 
 declare const s: {
     string: (d?: string) => FieldDefinition<string>;
@@ -14,6 +9,20 @@ declare const s: {
     array: (d?: string[], sep?: string) => FieldDefinition<string[]>;
 };
 
+declare const isUrl: (v: string) => boolean;
+declare const isEmail: (v: string) => boolean;
+declare const matchesRegex: (pattern: RegExp) => (v: string) => boolean;
+declare const isIPv4: (v: string) => boolean;
+declare const isUUID: (v: string) => boolean;
+declare const isBase64: (v: string) => boolean;
+declare const isJSON: (v: string) => boolean;
+declare const isHexColor: (v: string) => boolean;
+declare const isObjectId: (v: string) => boolean;
+declare const trim: (v: string) => string;
+declare const toLowerCase: (v: string) => string;
+declare const toUpperCase: (v: string) => string;
+declare const toJSON: (v: string) => any;
+
 /***
  * 将 .env 内容字符串解析为对象
  * 兼容带引号的值、多层引号内部的注释标识符以及行尾注释
@@ -23,4 +32,9 @@ 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, SafeEnvOptions, Schema, formatErrorReport, parseDotEnv, reportErrors, s, safeEnv };
+declare function safeEnv<T extends Schema>(schema: T, options?: SafeEnvOptions & {
+    throwOnError?: boolean;
+    useCache?: boolean;
+}): Readonly<InferSchema<T>>;
+
+export { EnvError, FieldDefinition, InferSchema, SafeEnvOptions, Schema, formatErrorReport, isBase64, isEmail, isHexColor, isIPv4, isJSON, isObjectId, isUUID, isUrl, matchesRegex, parseDotEnv, reportErrors, s, safeEnv, toJSON, toLowerCase, toUpperCase, trim };

package/dist/index.js

@@ -1 +1 @@
-import{a as d}from"./chunk-7CVG4I6F.js";import{a as y,b as p,c as D,d as g,e as T,f,g as u,h as l}from"./chunk-K2JQKLKN.js";import"./chunk-I7AUKTXE.js";function a(r,e,n,s=[]){return{type:r,default:e,required:e===void 0,parse:n,metadata:s.length?{options:s}:{},from(t){return this.sourceKey=t,this},validate(t,i="Custom validation failed"){return this.metadata={...this.metadata,validate:{fn:t,message:i}},this},min(t){return this.metadata={...this.metadata,min:t},this},max(t){return this.metadata={...this.metadata,max:t},this},transform(t){let i=this.parse;return this.parse=o=>t(i(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,i="Value does not match pattern"){return this.validate(o=>t.test(String(o)),i)},description(t){return this.metadata={...this.metadata,description:t},this}}}var m={string:r=>a("string",r,e=>String(e)),number:r=>a("number",r,e=>{let n=Number(e);if(isNaN(n))throw new Error(`Invalid number: ${e}`);return n}),boolean:r=>a("boolean",r,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:(r,e)=>a("enum",e,n=>{if(!r.includes(n))throw new Error(`Value "${n}" is not one of: ${r.join(", ")}`);return n},r),array:(r,e=",")=>a("array",r,n=>Array.isArray(n)?n:typeof n!="string"?[]:n.split(e).map(s=>s.trim()).filter(Boolean))};export{D as BUILD,y as DEV,p as SERVE,g as VITE_DEV_FLAG,T as VITE_PREFIX,f as formatErrorReport,d as parseDotEnv,u as reportErrors,m as s,l as safeEnv};
+import{a as f,b as l}from"./chunk-5KPNMU6R.js";import{a as c,b as g,c as h,d as x,e as w,f as u,g as p,h as d}from"./chunk-JBML47XC.js";var o=class{type;default;required;sourceKey;metadata;parse;constructor(n,e,r,i=[]){this.type=n,this.default=e,this.required=e===void 0,this.parse=r,this.metadata=i.length?{options:i}:{}}from(n){return this.sourceKey=n,this}optional(){return this.required=!1,this}requiredIf(n){return this.required=n,this}validate(n,e="Custom validation failed"){let r=this.parse;return this.parse=(i,a)=>{let s=r(i,a);if(!n(s,a))throw new Error(e);return s},this}min(n){return this.metadata={...this.metadata,min:n},this}max(n){return this.metadata={...this.metadata,max:n},this}transform(n){let e=this.parse;return this.parse=(r,i)=>n(e(r,i),i),this}secret(){return this.metadata={...this.metadata,isSecret:!0},this}description(n){return this.metadata={...this.metadata,description:n},this}},m={string:t=>new o("string",t,n=>String(n)),number:t=>new o("number",t,n=>{let e=Number(n);if(isNaN(e))throw new Error(`Invalid number: ${n}`);return e}),boolean:t=>new o("boolean",t,n=>{if(typeof n=="boolean")return n;if(n===void 0||n==="")return!1;let e=String(n).toLowerCase().trim();if(["true","1","yes","on"].includes(e))return!0;if(["false","0","no","off"].includes(e))return!1;throw new Error(`Invalid boolean: ${n}`)}),enum:(t,n)=>new o("enum",n,e=>{if(!t.includes(e))throw new Error(`Value "${e}" is not one of: ${t.join(", ")}`);return e},t),array:(t,n=",")=>new o("array",t,e=>Array.isArray(e)?e:typeof e!="string"?[]:e.split(n).map(r=>r.trim()).filter(Boolean))};var b=t=>{try{return new URL(String(t)),!0}catch{return!1}},D=t=>/^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/.test(String(t)),S=t=>n=>t.test(String(n)),T=t=>/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/.test(String(t)),F=t=>/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(t)),C=t=>/^(?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{2}==|[A-Za-z0-9+\/]{3}=)?$/.test(String(t)),E=t=>{try{return JSON.parse(String(t)),!0}catch{return!1}},N=t=>/^#?([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/.test(String(t)),$=t=>/^[0-9a-fA-F]{24}$/.test(String(t)),k=t=>String(t).trim(),v=t=>String(t).toLowerCase(),I=t=>String(t).toUpperCase(),O=t=>{try{return JSON.parse(String(t))}catch{throw new Error("Invalid JSON string")}};function q(t,n={}){let e=typeof process<"u"&&(process.release?.name==="node"||!!process.versions?.node);return d(t,{...n,envLoader:e?l:void 0})}export{h as BUILD,c as DEV,g as SERVE,x as VITE_DEV_FLAG,w as VITE_PREFIX,u as formatErrorReport,C as isBase64,D as isEmail,N as isHexColor,T as isIPv4,E as isJSON,$ as isObjectId,F as isUUID,b as isUrl,S as matchesRegex,f as parseDotEnv,p as reportErrors,m as s,q as safeEnv,O as toJSON,v as toLowerCase,I as toUpperCase,k as trim};

package/dist/{types-Bx-JEkTH.d.cts → types-BsDPVktI.d.cts}

@@ -4,22 +4,25 @@ 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 ValidationContext {
+    source: Record<string, any>;
+    parsed: Record<string, any>;
+}
 interface FieldDefinition<T = any, D extends string = string> {
     type: BaseType;
     default?: T;
-    required: boolean;
+    required: boolean | ((ctx: ValidationContext) => boolean);
     sourceKey?: string;
     metadata?: any;
-    parse: (val: any) => T;
+    parse: (val: any, ctx: ValidationContext) => T;
     from: (key: string) => FieldDefinition<T, D>;
-    validate: (fn: (val: T) => boolean, message?: string) => FieldDefinition<T, D>;
+    optional: () => FieldDefinition<T | undefined, D>;
+    requiredIf: (fn: (ctx: ValidationContext) => boolean) => FieldDefinition<T, D>;
+    validate: (fn: (val: T, ctx: ValidationContext) => boolean, message?: string) => FieldDefinition<T, D>;
     min: (val: number) => FieldDefinition<T, D>;
     max: (val: number) => FieldDefinition<T, D>;
-    transform: <U>(fn: (val: T) => U) => FieldDefinition<U, D>;
+    transform: <U>(fn: (val: T, ctx: ValidationContext) => U) => FieldDefinition<U, D>;
     secret: () => FieldDefinition<T, D>;
-    url: () => FieldDefinition<T, D>;
-    email: () => FieldDefinition<T, D>;
-    regex: (pattern: RegExp, message?: string) => FieldDefinition<T, D>;
     description: <NewD extends string>(text: NewD) => FieldDefinition<T, NewD>;
 }
 type Schema = Record<string, FieldDefinition<any, any>>;
@@ -44,4 +47,4 @@ interface SafeEnvOptions {
     /** @internal */ devMode?: boolean;
 }
 
-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 };
+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, type ValidationContext as e };

package/dist/{types-Bx-JEkTH.d.ts → types-BsDPVktI.d.ts}

@@ -4,22 +4,25 @@ 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 ValidationContext {
+    source: Record<string, any>;
+    parsed: Record<string, any>;
+}
 interface FieldDefinition<T = any, D extends string = string> {
     type: BaseType;
     default?: T;
-    required: boolean;
+    required: boolean | ((ctx: ValidationContext) => boolean);
     sourceKey?: string;
     metadata?: any;
-    parse: (val: any) => T;
+    parse: (val: any, ctx: ValidationContext) => T;
     from: (key: string) => FieldDefinition<T, D>;
-    validate: (fn: (val: T) => boolean, message?: string) => FieldDefinition<T, D>;
+    optional: () => FieldDefinition<T | undefined, D>;
+    requiredIf: (fn: (ctx: ValidationContext) => boolean) => FieldDefinition<T, D>;
+    validate: (fn: (val: T, ctx: ValidationContext) => boolean, message?: string) => FieldDefinition<T, D>;
     min: (val: number) => FieldDefinition<T, D>;
     max: (val: number) => FieldDefinition<T, D>;
-    transform: <U>(fn: (val: T) => U) => FieldDefinition<U, D>;
+    transform: <U>(fn: (val: T, ctx: ValidationContext) => U) => FieldDefinition<U, D>;
     secret: () => FieldDefinition<T, D>;
-    url: () => FieldDefinition<T, D>;
-    email: () => FieldDefinition<T, D>;
-    regex: (pattern: RegExp, message?: string) => FieldDefinition<T, D>;
     description: <NewD extends string>(text: NewD) => FieldDefinition<T, NewD>;
 }
 type Schema = Record<string, FieldDefinition<any, any>>;
@@ -44,4 +47,4 @@ interface SafeEnvOptions {
     /** @internal */ devMode?: boolean;
 }
 
-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 };
+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, type ValidationContext as e };

package/dist/vite.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkPBYVLIUGcjs = require('./chunk-PBYVLIUG.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===_chunkPBYVLIUGcjs.b,process.env[_chunkPBYVLIUGcjs.d]=o?"true":"";let{envDir:t=e.root,prefix:r=e.envPrefix||_chunkPBYVLIUGcjs.e}=f,p=_vite.loadEnv.call(void 0, e.mode,t,r);try{_chunkPBYVLIUGcjs.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
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk6NHVLNFIcjs = require('./chunk-6NHVLNFI.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===_chunk6NHVLNFIcjs.b,process.env[_chunk6NHVLNFIcjs.d]=o?"true":"";let{envDir:t=e.root,prefix:r=e.envPrefix||_chunk6NHVLNFIcjs.e}=f,p=_vite.loadEnv.call(void 0, e.mode,t,r);try{_chunk6NHVLNFIcjs.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,5 +1,5 @@
 import { Plugin } from 'vite';
-import { S as Schema } from './types-Bx-JEkTH.cjs';
+import { S as Schema } from './types-BsDPVktI.cjs';
 
 /**
  * Vite 插件：在构建或开发启动时校验环境变量

package/dist/vite.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { S as Schema } from './types-Bx-JEkTH.js';
+import { S as Schema } from './types-BsDPVktI.js';
 
 /**
  * Vite 插件：在构建或开发启动时校验环境变量

package/dist/vite.js

@@ -1,2 +1,2 @@
-import{b as a,d as i,e as l,h as m}from"./chunk-K2JQKLKN.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
+import{b as a,d as i,e as l,h as m}from"./chunk-JBML47XC.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.4.0",
+  "version": "0.4.2",
   "description": "Type-safe environment variables for Node.js and Browser with schema validation.",
   "author": "Moody",
   "license": "MIT",

package/dist/chunk-7CVG4I6F.js

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

package/dist/chunk-D6WM53FN.cjs

@@ -1 +0,0 @@
-"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-I7AUKTXE.js

@@ -1 +0,0 @@
-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-K2JQKLKN.js

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

package/dist/chunk-PBYVLIUG.cjs

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

package/dist/chunk-PLO26PP5.cjs

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