zenvx 0.1.3 → 0.2.1

package/README.md

@@ -33,6 +33,9 @@ Standard Zod is great, but environment variables are always strings. This leads
 - ✅ Strict validation for strings, URLs, emails, JSON, enums
 - ✅ Beautiful, human-readable error reporting
 - ✅ Seamless TypeScript integration
+- ✅ `.env.example` auto-generation
+- ✅ Runtime **and** build-time validation modes
+- ✅ Framework adapters: Node.js, Next.js (server + client), Vite
 
 ## Installation
 
@@ -76,6 +79,131 @@ console.log(`Server running on port ${env.PORT}`);
 // TypeScript knows env.PORT is a number!
 ```
 
+## Framework Adapters
+
+zenvx supports different frameworks with adapters for proper environment handling.
+
+### Node.js
+
+```ts
+import { loadNodeEnv } from "zenvx/node";
+
+const env = loadNodeEnv({
+  PORT: tx.port(),
+  DEBUG: tx.bool(),
+});
+```
+
+> Note: In Node.js, you must install dotenv separately and load it (e.g., via import "dotenv/config" or dotenv.config()) before calling loadNodeEnv().
+
+### Next.js
+
+Server-side
+
+```ts
+import { loadServerEnv } from "zenvx/next";
+
+const env = loadServerEnv({
+  PORT: tx.port(),
+  SECRET_KEY: tx.string(),
+});
+```
+
+Client-side (only NEXT*PUBLIC*\* allowed):
+
+```ts
+import { loadClientEnv } from "zenvx/next";
+
+const env = loadClientEnv({
+  NEXT_PUBLIC_API_URL: tx.string(),
+  NEXT_PUBLIC_DEBUG: tx.bool(),
+});
+```
+
+> Attempting to access a key without NEXT*PUBLIC* in client env throws an error.
+
+### Vite
+
+```ts
+import { loadViteEnv } from "zenvx/vite";
+
+const env = loadViteEnv({
+  VITE_API_URL: tx.string(),
+  VITE_DEBUG: tx.bool(),
+});
+```
+
+## .env.example Auto-Generation
+
+zenvx can automatically generate a .env.example file from your schema — keeping your documentation always in sync.
+
+```ts
+defineEnv(
+  {
+    DATABASE_URL: tx.url(),
+    PORT: tx.port().default(3000),
+    DEBUG: tx.bool(),
+  },
+  {
+    generateExample: true,
+  },
+);
+```
+
+This produces:
+
+```
+# Example environment variables
+# Copy this file to .env and fill in the values
+
+DATABASE_URL=  #string
+PORT=3000  # number
+DEBUG_MODE=  # boolean
+
+```
+
+No more forgotten or outdated .env.example files.
+
+## Runtime vs Build-Time Validation
+
+Different environments need different failure behavior. zenvx supports both.
+
+### Runtime Validation (default)
+
+In runtime mode, environment variables are validated as soon as your application starts.
+
+```ts
+defineEnv(schema, { mode: "runtime" });
+```
+
+Behavior:
+
+- Environment variables are loaded and validated immediately
+- If validation fails:
+  - A formatted error message is printed to the console
+  - The process exits using process.exit(1)
+- Prevents the application from running with invalid configuration
+
+This mode ensures misconfigured environments are caught early and stop execution entirely.
+
+### Build-Time Validation
+
+IIn build-time mode, validation errors are thrown instead of terminating the process.
+
+```ts
+defineEnv(schema, { mode: "build" });
+```
+
+Behavior:
+
+- Environment variables are validated during execution
+- If validation fails:
+  - An error is thrown
+  - process.exit() is not called
+- Allows the calling environment (bundler, test runner, or script) to handle the failure
+
+This mode avoids hard exits and lets external tooling decide how to respond to configuration errors.
+
 ## Beautiful Error Handling
 
 If your .env file is missing values or has invalid types, zenvx stops the process immediately and prints a clear message:
@@ -115,23 +243,6 @@ export const env = defineEnv({
 });
 ```
 
-## Advanced Configuration
-
-Custom .env Path
-
-By default, zenvx looks for .env in your project root. You can change this:
-
-```ts
-export const env = defineEnv(
-  {
-    PORT: tx.port(),
-  },
-  {
-    path: "./config/.env.production",
-  },
-);
-```
-
 ## Mixing with Standard Zod
 
 You can mix tx helpers with standard Zod schemas if you need specific logic.

package/dist/adapters/next.cjs

@@ -0,0 +1,151 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/next.ts
+var next_exports = {};
+__export(next_exports, {
+  loadClientEnv: () => loadClientEnv,
+  loadServerEnv: () => loadServerEnv
+});
+module.exports = __toCommonJS(next_exports);
+
+// src/core/define-env.ts
+var import_zod3 = require("zod");
+
+// src/core/parser.ts
+var import_zod = require("zod");
+function parseEnv(schema, source, mode = "runtime") {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    const header = mode === "build" ? [
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502  \u274C INVALID ENVIRONMENT VARIABLES DETECTED   \u2502",
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
+    ] : [
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502 \u26A0 WARNING INVALID ENVIRONMENT VARIABLES \u26A0  \u2502",
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
+    ];
+    const box = ["", ...header, issues, ""].join("\n");
+    if (mode === "build") {
+      throw new Error(box);
+    } else {
+      console.warn(box);
+      process.exit(1);
+    }
+  }
+  return result.success ? result.data : {};
+}
+
+// src/core/proxy.ts
+function createTypedProxy(obj) {
+  return new Proxy(obj, {
+    get(target, prop) {
+      if (!(prop in target)) {
+        console.error(
+          `\u274C Tried to access undefined environment variable "${prop}"`
+        );
+        process.exit(1);
+      }
+      return target[prop];
+    }
+  });
+}
+
+// src/core/generate-example.ts
+var import_zod2 = require("zod");
+var import_fs = __toESM(require("fs"), 1);
+function getZodTypeName(schema) {
+  let type = "unknown";
+  if (schema instanceof import_zod2.ZodString) type = "string";
+  else if (schema instanceof import_zod2.ZodNumber) type = "number";
+  else if (schema instanceof import_zod2.ZodBoolean) type = "boolean";
+  return type;
+}
+function generateExample(schema, path = ".env.example") {
+  const header = [
+    "# Example environment variables",
+    "# Copy this file to .env and fill in the values",
+    ""
+  ];
+  const lines = Object.entries(schema.shape).map(([key, zodSchema]) => {
+    let placeholder = "";
+    let othertype = null;
+    let actualSchema = zodSchema;
+    if (zodSchema instanceof import_zod2.ZodOptional) actualSchema = zodSchema.unwrap();
+    if (zodSchema instanceof import_zod2.ZodDefault) {
+      actualSchema = zodSchema.def.innerType;
+      placeholder = zodSchema.def.defaultValue ?? "";
+      othertype = typeof zodSchema.def.defaultValue;
+    }
+    const type = getZodTypeName(actualSchema);
+    return `${key}=${placeholder ?? ""}  # ${othertype ?? type}`;
+  });
+  const content = [...header, ...lines].join("\n") + "\n";
+  import_fs.default.writeFileSync(path, content);
+  console.log(`\u2705 .env.example generated at ${path}`);
+}
+
+// src/core/define-env.ts
+function defineEnv(shape, source, options) {
+  const schema = import_zod3.z.object(shape);
+  const parsed = parseEnv(schema, source, options?.mode ?? "runtime");
+  if (options?.generateExample) {
+    generateExample(schema);
+  }
+  return createTypedProxy(parsed);
+}
+
+// src/adapters/next.ts
+function loadServerEnv(shape) {
+  if (typeof window !== "undefined") {
+    throw new Error("Server env cannot be used in the browser");
+  }
+  return defineEnv(shape, process.env, {
+    mode: process.env.NEXT_PHASE === "phase-production-build" ? "build" : "runtime"
+  });
+}
+function loadClientEnv(shape) {
+  const clientEnv = {};
+  for (const key of Object.keys(shape)) {
+    if (!key.startsWith("NEXT_PUBLIC_")) {
+      throw new Error(`Client env "${key}" must start with NEXT_PUBLIC_`);
+    }
+    clientEnv[key] = process.env[key];
+  }
+  return defineEnv(shape, clientEnv, {
+    mode: "build"
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadClientEnv,
+  loadServerEnv
+});

package/dist/adapters/next.d.cts

@@ -0,0 +1,6 @@
+import * as zod from 'zod';
+
+declare function loadServerEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+declare function loadClientEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+
+export { loadClientEnv, loadServerEnv };

package/dist/adapters/next.d.ts

@@ -0,0 +1,6 @@
+import * as zod from 'zod';
+
+declare function loadServerEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+declare function loadClientEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+
+export { loadClientEnv, loadServerEnv };

package/dist/adapters/next.js

@@ -0,0 +1,32 @@
+import {
+  defineEnv
+} from "../chunk-ELPQSMQJ.js";
+import "../chunk-KGVPNFG3.js";
+import "../chunk-3HCQKBTL.js";
+import "../chunk-DX3SLVGQ.js";
+
+// src/adapters/next.ts
+function loadServerEnv(shape) {
+  if (typeof window !== "undefined") {
+    throw new Error("Server env cannot be used in the browser");
+  }
+  return defineEnv(shape, process.env, {
+    mode: process.env.NEXT_PHASE === "phase-production-build" ? "build" : "runtime"
+  });
+}
+function loadClientEnv(shape) {
+  const clientEnv = {};
+  for (const key of Object.keys(shape)) {
+    if (!key.startsWith("NEXT_PUBLIC_")) {
+      throw new Error(`Client env "${key}" must start with NEXT_PUBLIC_`);
+    }
+    clientEnv[key] = process.env[key];
+  }
+  return defineEnv(shape, clientEnv, {
+    mode: "build"
+  });
+}
+export {
+  loadClientEnv,
+  loadServerEnv
+};

package/dist/adapters/node.cjs

@@ -0,0 +1,135 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/node.ts
+var node_exports = {};
+__export(node_exports, {
+  loadNodeEnv: () => loadNodeEnv
+});
+module.exports = __toCommonJS(node_exports);
+
+// src/core/define-env.ts
+var import_zod3 = require("zod");
+
+// src/core/parser.ts
+var import_zod = require("zod");
+function parseEnv(schema, source, mode = "runtime") {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    const header = mode === "build" ? [
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502  \u274C INVALID ENVIRONMENT VARIABLES DETECTED   \u2502",
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
+    ] : [
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502 \u26A0 WARNING INVALID ENVIRONMENT VARIABLES \u26A0  \u2502",
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
+    ];
+    const box = ["", ...header, issues, ""].join("\n");
+    if (mode === "build") {
+      throw new Error(box);
+    } else {
+      console.warn(box);
+      process.exit(1);
+    }
+  }
+  return result.success ? result.data : {};
+}
+
+// src/core/proxy.ts
+function createTypedProxy(obj) {
+  return new Proxy(obj, {
+    get(target, prop) {
+      if (!(prop in target)) {
+        console.error(
+          `\u274C Tried to access undefined environment variable "${prop}"`
+        );
+        process.exit(1);
+      }
+      return target[prop];
+    }
+  });
+}
+
+// src/core/generate-example.ts
+var import_zod2 = require("zod");
+var import_fs = __toESM(require("fs"), 1);
+function getZodTypeName(schema) {
+  let type = "unknown";
+  if (schema instanceof import_zod2.ZodString) type = "string";
+  else if (schema instanceof import_zod2.ZodNumber) type = "number";
+  else if (schema instanceof import_zod2.ZodBoolean) type = "boolean";
+  return type;
+}
+function generateExample(schema, path = ".env.example") {
+  const header = [
+    "# Example environment variables",
+    "# Copy this file to .env and fill in the values",
+    ""
+  ];
+  const lines = Object.entries(schema.shape).map(([key, zodSchema]) => {
+    let placeholder = "";
+    let othertype = null;
+    let actualSchema = zodSchema;
+    if (zodSchema instanceof import_zod2.ZodOptional) actualSchema = zodSchema.unwrap();
+    if (zodSchema instanceof import_zod2.ZodDefault) {
+      actualSchema = zodSchema.def.innerType;
+      placeholder = zodSchema.def.defaultValue ?? "";
+      othertype = typeof zodSchema.def.defaultValue;
+    }
+    const type = getZodTypeName(actualSchema);
+    return `${key}=${placeholder ?? ""}  # ${othertype ?? type}`;
+  });
+  const content = [...header, ...lines].join("\n") + "\n";
+  import_fs.default.writeFileSync(path, content);
+  console.log(`\u2705 .env.example generated at ${path}`);
+}
+
+// src/core/define-env.ts
+function defineEnv(shape, source, options) {
+  const schema = import_zod3.z.object(shape);
+  const parsed = parseEnv(schema, source, options?.mode ?? "runtime");
+  if (options?.generateExample) {
+    generateExample(schema);
+  }
+  return createTypedProxy(parsed);
+}
+
+// src/adapters/node.ts
+function loadNodeEnv(shape) {
+  return defineEnv(shape, process.env, {
+    mode: "runtime",
+    generateExample: true
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadNodeEnv
+});

package/dist/adapters/node.d.cts

@@ -0,0 +1,5 @@
+import * as zod from 'zod';
+
+declare function loadNodeEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+
+export { loadNodeEnv };

package/dist/adapters/node.d.ts

@@ -0,0 +1,5 @@
+import * as zod from 'zod';
+
+declare function loadNodeEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+
+export { loadNodeEnv };

package/dist/adapters/node.js

@@ -0,0 +1,17 @@
+import {
+  defineEnv
+} from "../chunk-ELPQSMQJ.js";
+import "../chunk-KGVPNFG3.js";
+import "../chunk-3HCQKBTL.js";
+import "../chunk-DX3SLVGQ.js";
+
+// src/adapters/node.ts
+function loadNodeEnv(shape) {
+  return defineEnv(shape, process.env, {
+    mode: "runtime",
+    generateExample: true
+  });
+}
+export {
+  loadNodeEnv
+};

package/dist/adapters/vite.cjs

@@ -0,0 +1,135 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/vite.ts
+var vite_exports = {};
+__export(vite_exports, {
+  loadViteEnv: () => loadViteEnv
+});
+module.exports = __toCommonJS(vite_exports);
+
+// src/core/define-env.ts
+var import_zod3 = require("zod");
+
+// src/core/parser.ts
+var import_zod = require("zod");
+function parseEnv(schema, source, mode = "runtime") {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    const header = mode === "build" ? [
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502  \u274C INVALID ENVIRONMENT VARIABLES DETECTED   \u2502",
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
+    ] : [
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502 \u26A0 WARNING INVALID ENVIRONMENT VARIABLES \u26A0  \u2502",
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"
+    ];
+    const box = ["", ...header, issues, ""].join("\n");
+    if (mode === "build") {
+      throw new Error(box);
+    } else {
+      console.warn(box);
+      process.exit(1);
+    }
+  }
+  return result.success ? result.data : {};
+}
+
+// src/core/proxy.ts
+function createTypedProxy(obj) {
+  return new Proxy(obj, {
+    get(target, prop) {
+      if (!(prop in target)) {
+        console.error(
+          `\u274C Tried to access undefined environment variable "${prop}"`
+        );
+        process.exit(1);
+      }
+      return target[prop];
+    }
+  });
+}
+
+// src/core/generate-example.ts
+var import_zod2 = require("zod");
+var import_fs = __toESM(require("fs"), 1);
+function getZodTypeName(schema) {
+  let type = "unknown";
+  if (schema instanceof import_zod2.ZodString) type = "string";
+  else if (schema instanceof import_zod2.ZodNumber) type = "number";
+  else if (schema instanceof import_zod2.ZodBoolean) type = "boolean";
+  return type;
+}
+function generateExample(schema, path = ".env.example") {
+  const header = [
+    "# Example environment variables",
+    "# Copy this file to .env and fill in the values",
+    ""
+  ];
+  const lines = Object.entries(schema.shape).map(([key, zodSchema]) => {
+    let placeholder = "";
+    let othertype = null;
+    let actualSchema = zodSchema;
+    if (zodSchema instanceof import_zod2.ZodOptional) actualSchema = zodSchema.unwrap();
+    if (zodSchema instanceof import_zod2.ZodDefault) {
+      actualSchema = zodSchema.def.innerType;
+      placeholder = zodSchema.def.defaultValue ?? "";
+      othertype = typeof zodSchema.def.defaultValue;
+    }
+    const type = getZodTypeName(actualSchema);
+    return `${key}=${placeholder ?? ""}  # ${othertype ?? type}`;
+  });
+  const content = [...header, ...lines].join("\n") + "\n";
+  import_fs.default.writeFileSync(path, content);
+  console.log(`\u2705 .env.example generated at ${path}`);
+}
+
+// src/core/define-env.ts
+function defineEnv(shape, source, options) {
+  const schema = import_zod3.z.object(shape);
+  const parsed = parseEnv(schema, source, options?.mode ?? "runtime");
+  if (options?.generateExample) {
+    generateExample(schema);
+  }
+  return createTypedProxy(parsed);
+}
+
+// src/adapters/vite.ts
+var import_meta = {};
+function loadViteEnv(shape) {
+  return defineEnv(shape, import_meta.env, {
+    mode: "build"
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadViteEnv
+});

package/dist/adapters/vite.d.cts

@@ -0,0 +1,5 @@
+import * as zod from 'zod';
+
+declare function loadViteEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+
+export { loadViteEnv };

package/dist/adapters/vite.d.ts

@@ -0,0 +1,5 @@
+import * as zod from 'zod';
+
+declare function loadViteEnv<T extends Record<string, any>>(shape: T): { [K in keyof T]: zod.infer<T[K]>; };
+
+export { loadViteEnv };