@vite-env/core 0.2.2 → 0.4.0

package/dist/plugin.mjs

@@ -1,11 +1,75 @@
-import { validateEnv } from "./schema.mjs";
+import { isStandardEnvDefinition, validateStandardEnv } from "./standard.mjs";
 import { loadEnvConfig } from "./config.mjs";
-import { generateDts } from "./dts.mjs";
-import { formatZodError } from "./format.mjs";
+import { generateStandardDts } from "./dts.mjs";
+import { formatGuardLogEntry, formatGuardWarning, formatHardError, formatStandardSchemaError } from "./format.mjs";
 import { detectServerLeak } from "./leak.mjs";
 import path from "node:path";
 import process from "node:process";
+import fs from "node:fs/promises";
 import { loadEnv } from "vite";
+//#region src/guard.ts
+/**
+* Determines whether the given Vite environment is allowed to import virtual:env/server.
+* Returns a GuardResult discriminated union — allowed or fail with context.
+* When this.environment is undefined (should not occur with Vite ≥ 8), callers default
+* envName to 'client' — failing closed (restrictive) is safer than failing open.
+*/
+function checkServerModuleAccess(envName, serverEnvironments, mode, importer) {
+	if (serverEnvironments.includes(envName)) return { allowed: true };
+	return {
+		allowed: false,
+		mode,
+		envName,
+		importer
+	};
+}
+/**
+* Generates the stub virtual module returned when onClientAccessOfServerModule is 'stub'.
+* The stub throws at runtime if executed — its message reflects that this import was
+* expected to be unreachable and the assumption was wrong.
+*/
+function buildServerStubModule(envName) {
+	return {
+		moduleType: "js",
+		code: `// Auto-generated by @vite-env/core — server-only module stub
+throw new Error(
+  '[vite-env] virtual:env/server was imported in the "${envName}" environment. ' +
+  'This module is server-only and was replaced with a stub. ' +
+  'To allow this environment: add it to serverEnvironments. ' +
+  'To suppress this stub: ensure this import never executes in the "${envName}" environment.'
+);`
+	};
+}
+//#endregion
+//#region src/log.ts
+const LOG_HEADER = `# vite-env warnings — generated by @vite-env/core
+# These warnings will become hard errors in 1.0.0.
+# To enforce immediately: ViteEnv({ onClientAccessOfServerModule: 'error' })
+# To acknowledge and suppress: ViteEnv({ onClientAccessOfServerModule: 'stub' })
+# To allow specific environments: ViteEnv({ serverEnvironments: ['ssr', 'workerd'] })`;
+/**
+* Writes accumulated GuardFail entries to vite-env-warnings.log in the project root.
+* Overwrites on each build — stale entries from previous builds must not persist.
+* Called only in 'warn' mode from buildEnd, after verifying the build succeeded.
+*/
+async function writeWarningsLog(fails, root) {
+	const seen = /* @__PURE__ */ new Set();
+	const unique = fails.filter((fail) => {
+		const key = `${fail.envName}::${fail.importer ?? ""}`;
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	});
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const content = `${LOG_HEADER}\n\n${unique.map((fail) => formatGuardLogEntry(fail, timestamp)).join("\n\n")}\n`;
+	const filePath = path.join(root, "vite-env-warnings.log");
+	try {
+		await fs.writeFile(filePath, content, "utf-8");
+	} catch (e) {
+		throw new Error(`[vite-env] Failed to write vite-env-warnings.log to ${root}. Check file permissions.`, { cause: e });
+	}
+}
+//#endregion
 //#region src/sources.ts
 /**
 * Merge priority (highest → lowest):
@@ -48,10 +112,31 @@ export default env;`
 }
 //#endregion
 //#region src/plugin.ts
+/**
+* Validates environment variables against the definition.
+* Routes to Zod or Standard Schema path based on definition type.
+* Zod modules are loaded dynamically to avoid requiring zod for Standard Schema users.
+*/
+async function validateAndFormat(def, rawEnv) {
+	if (isStandardEnvDefinition(def)) {
+		const result = await validateStandardEnv(def, rawEnv);
+		if (!result.success) return { error: formatStandardSchemaError(result.errors) };
+		return { data: result.data };
+	}
+	const { validateEnv } = await import("./schema.mjs");
+	const { formatZodError } = await import("./format.mjs");
+	const result = validateEnv(def, rawEnv);
+	if (!result.success) return { error: formatZodError(result.errors) };
+	return { data: result.data };
+}
 function ViteEnv(options = {}) {
 	let resolvedConfig;
 	let envDefinition;
 	let lastValidated = {};
+	let serverModuleGuardFails = [];
+	let didSetExitCode = false;
+	const serverEnvs = options.serverEnvironments ?? ["ssr"];
+	const guardMode = options.onClientAccessOfServerModule ?? "warn";
 	return {
 		name: "vite-env",
 		enforce: "pre",
@@ -65,24 +150,52 @@ function ViteEnv(options = {}) {
 			}
 		},
 		async buildStart() {
-			const rawEnv = await loadEnvSources(resolvedConfig);
-			const result = validateEnv(envDefinition, rawEnv);
-			if (!result.success) {
-				const formatted = formatZodError(result.errors);
-				throw new Error(`[vite-env] Environment validation failed:\n\n${formatted}`);
+			serverModuleGuardFails = [];
+			if (didSetExitCode) {
+				process.exitCode = 0;
+				didSetExitCode = false;
 			}
+			const rawEnv = await loadEnvSources(resolvedConfig);
+			const result = await validateAndFormat(envDefinition, rawEnv);
+			if ("error" in result) throw new Error(`[vite-env] Environment validation failed:\n\n${result.error}`);
 			lastValidated = result.data;
-			await generateDts(envDefinition, resolvedConfig.root);
-			const count = Object.keys(result.data).length;
+			if (isStandardEnvDefinition(envDefinition)) await generateStandardDts(envDefinition, resolvedConfig.root);
+			else {
+				const { generateDts } = await import("./dts.mjs");
+				await generateDts(envDefinition, resolvedConfig.root);
+			}
+			const count = Object.keys(lastValidated).length;
 			resolvedConfig.logger.info(`  \x1B[32m✓\x1B[0m \x1B[36m[vite-env]\x1B[0m ${count} variables validated`);
 		},
-		resolveId(id) {
-			if (id === "virtual:env/client") return "\0virtual:env/client";
-			if (id === "virtual:env/server") return "\0virtual:env/server";
+		resolveId(source, importer) {
+			if (source === "virtual:env/client") return "\0virtual:env/client";
+			if (source === "virtual:env/server") {
+				const result = checkServerModuleAccess(this.environment?.name ?? "client", serverEnvs, guardMode, importer);
+				if (!result.allowed) serverModuleGuardFails.push(result);
+				return "\0virtual:env/server";
+			}
 		},
 		load(id) {
 			if (id === "\0virtual:env/client") return buildClientModule(envDefinition, lastValidated);
-			if (id === "\0virtual:env/server") return buildServerModule(envDefinition, lastValidated);
+			if (id === "\0virtual:env/server") {
+				const envName = this.environment?.name ?? "client";
+				const envFails = serverModuleGuardFails.filter((f) => f.envName === envName);
+				if (envFails.length > 0) {
+					const latest = envFails.at(-1);
+					if (latest.mode === "error") throw new Error(formatHardError(latest));
+					if (latest.mode === "stub") return buildServerStubModule(envName);
+					resolvedConfig.logger.warn(`\n${formatGuardWarning(latest)}`);
+				}
+				return buildServerModule(envDefinition, lastValidated);
+			}
+		},
+		async buildEnd(error) {
+			if (error) return;
+			if (serverModuleGuardFails.length === 0) return;
+			if (guardMode !== "warn") return;
+			await writeWarningsLog(serverModuleGuardFails, resolvedConfig.root);
+			process.exitCode = 1;
+			didSetExitCode = true;
 		},
 		generateBundle(_options, bundle) {
 			if (resolvedConfig.build.ssr) return;
@@ -104,10 +217,9 @@ function ViteEnv(options = {}) {
 				debounceTimer = setTimeout(async () => {
 					try {
 						const rawEnv = await loadEnvSources(resolvedConfig);
-						const result = validateEnv(envDefinition, rawEnv);
-						if (!result.success) {
-							const formatted = formatZodError(result.errors);
-							resolvedConfig.logger.warn(`\n  \x1B[33m⚠\x1B[0m \x1B[36m[vite-env]\x1B[0m Env revalidation failed:\n${formatted}`);
+						const result = await validateAndFormat(envDefinition, rawEnv);
+						if ("error" in result) {
+							resolvedConfig.logger.warn(`\n  \x1B[33m⚠\x1B[0m \x1B[36m[vite-env]\x1B[0m Env revalidation failed:\n${result.error}`);
 							return;
 						}
 						lastValidated = result.data;
@@ -116,6 +228,7 @@ function ViteEnv(options = {}) {
 						if (clientMod) server.moduleGraph.invalidateModule(clientMod);
 						if (serverMod) server.moduleGraph.invalidateModule(serverMod);
 						if (clientMod || serverMod) {
+							serverModuleGuardFails = [];
 							server.hot.send({ type: "full-reload" });
 							resolvedConfig.logger.info(`  \x1B[32m✓\x1B[0m \x1B[36m[vite-env]\x1B[0m Env revalidated`);
 						}

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/sources.ts","../src/virtual.ts","../src/plugin.ts"],"sourcesContent":["// @env node\nimport type { ResolvedConfig } from 'vite'\nimport process from 'node:process'\nimport { loadEnv } from 'vite'\n\n/**\n * Merge priority (highest → lowest):\n *   1. process.env        (CI pipeline secrets win)\n *   2. .env.[mode].local\n *   3. .env.[mode]\n *   4. .env.local\n *   5. .env\n *\n * Prefix '' = load everything, schema decides what's valid.\n */\nexport async function loadEnvSources(\n  config: ResolvedConfig,\n): Promise<Record<string, string>> {\n  const fileEnv = loadEnv(\n    config.mode,\n    config.envDir || config.root,\n    '', // no prefix filter — schema is the filter\n  )\n\n  return {\n    ...fileEnv,\n    ...filterStrings(process.env),\n  }\n}\n\nfunction filterStrings(env: NodeJS.ProcessEnv): Record<string, string> {\n  return Object.fromEntries(\n    Object.entries(env).filter(\n      (entry): entry is [string, string] => typeof entry[1] === 'string',\n    ),\n  )\n}\n","import type { EnvDefinition } from './types'\n\nexport function buildClientModule(\n  def: EnvDefinition,\n  data: Record<string, unknown>,\n): { code: string, moduleType: 'js' } {\n  const clientKeys = new Set(Object.keys(def.client ?? {}))\n\n  const clientData = Object.fromEntries(\n    Object.entries(data).filter(([k]) => clientKeys.has(k)),\n  )\n\n  return {\n    moduleType: 'js', // Required: Vite 8 / Rolldown explicit moduleType\n    code: `// Auto-generated by @vite-env/core — do not edit\nexport const env = Object.freeze(${JSON.stringify(clientData, null, 2)});\nexport default env;`,\n  }\n}\n\nexport function buildServerModule(\n  _def: EnvDefinition,\n  data: Record<string, unknown>,\n): { code: string, moduleType: 'js' } {\n  return {\n    moduleType: 'js',\n    code: `// Auto-generated by @vite-env/core — do not edit\nexport const env = Object.freeze(${JSON.stringify(data, null, 2)});\nexport default env;`,\n  }\n}\n","// @env node\nimport type { Plugin, ResolvedConfig } from 'vite'\nimport type { EnvDefinition } from './types'\nimport path from 'node:path'\nimport { loadEnvConfig } from './config'\nimport { generateDts } from './dts'\nimport { formatZodError } from './format'\nimport { detectServerLeak } from './leak'\nimport { validateEnv } from './schema'\nimport { loadEnvSources } from './sources'\nimport { buildClientModule, buildServerModule } from './virtual'\n\nexport interface ViteEnvOptions {\n  /**\n   * Path to env definition file.\n   * @default './env.ts' (resolved from project root)\n   */\n  configFile?: string\n}\n\nexport default function ViteEnv(options: ViteEnvOptions = {}): Plugin {\n  let resolvedConfig: ResolvedConfig\n  let envDefinition: EnvDefinition\n  let lastValidated: Record<string, unknown> = {}\n\n  return {\n    name: 'vite-env',\n    enforce: 'pre',\n\n    async configResolved(config) {\n      resolvedConfig = config\n\n      const configPath = path.resolve(\n        config.root,\n        options.configFile ?? 'env.ts',\n      )\n\n      try {\n        envDefinition = await loadEnvConfig(configPath)\n      }\n      catch (e) {\n        throw new Error(\n          `[vite-env] Could not load env definition file at: ${configPath}\\n`\n          + `  Create an env.ts file and export default defineEnv({ ... })`,\n          { cause: e },\n        )\n      }\n    },\n\n    async buildStart() {\n      const rawEnv = await loadEnvSources(resolvedConfig)\n      const result = validateEnv(envDefinition, rawEnv)\n\n      if (!result.success) {\n        const formatted = formatZodError(result.errors)\n        throw new Error(\n          `[vite-env] Environment validation failed:\\n\\n${formatted}`,\n        )\n      }\n\n      lastValidated = result.data\n\n      await generateDts(envDefinition, resolvedConfig.root)\n\n      const count = Object.keys(result.data).length\n      resolvedConfig.logger.info(\n        `  \\x1B[32m✓\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m ${count} variables validated`,\n      )\n    },\n\n    resolveId(id) {\n      if (id === 'virtual:env/client')\n        return '\\0virtual:env/client'\n      if (id === 'virtual:env/server')\n        return '\\0virtual:env/server'\n    },\n\n    load(id) {\n      if (id === '\\0virtual:env/client')\n        return buildClientModule(envDefinition, lastValidated)\n      if (id === '\\0virtual:env/server')\n        return buildServerModule(envDefinition, lastValidated)\n    },\n\n    generateBundle(_options, bundle) {\n      if (resolvedConfig.build.ssr)\n        return\n\n      const leaks = detectServerLeak(\n        envDefinition,\n        lastValidated,\n        bundle as Record<string, { type: string, code?: string }>,\n        (keys) => {\n          resolvedConfig.logger.warn(\n            `  \\x1B[33m⚠\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Leak detection skipped ${keys.length} server variable(s) with values shorter than 8 chars: ${keys.join(', ')}`,\n          )\n        },\n      )\n\n      if (leaks.length > 0) {\n        const details = leaks.map(l => `  ✗ ${l.key} found in ${l.chunk}`).join('\\n')\n        throw new Error(\n          `[vite-env] Server environment variables detected in client bundle!\\n\\n${details}\\n\\n  These variables are marked as server-only and must never reach the browser.`,\n        )\n      }\n    },\n\n    configureServer(server) {\n      const envDir = resolvedConfig.envDir || resolvedConfig.root\n      server.watcher.add(path.join(envDir, '.env*'))\n\n      let debounceTimer: ReturnType<typeof setTimeout>\n\n      server.watcher.on('change', async (file) => {\n        if (!path.basename(file).startsWith('.env'))\n          return\n\n        clearTimeout(debounceTimer)\n        debounceTimer = setTimeout(async () => {\n          try {\n            const rawEnv = await loadEnvSources(resolvedConfig)\n            const result = validateEnv(envDefinition, rawEnv)\n\n            if (!result.success) {\n              const formatted = formatZodError(result.errors)\n              resolvedConfig.logger.warn(\n                `\\n  \\x1B[33m⚠\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Env revalidation failed:\\n${formatted}`,\n              )\n              return\n            }\n\n            lastValidated = result.data\n\n            const clientMod = server.moduleGraph.getModuleById('\\0virtual:env/client')\n            const serverMod = server.moduleGraph.getModuleById('\\0virtual:env/server')\n            if (clientMod)\n              server.moduleGraph.invalidateModule(clientMod)\n            if (serverMod)\n              server.moduleGraph.invalidateModule(serverMod)\n            if (clientMod || serverMod) {\n              server.hot.send({ type: 'full-reload' })\n              resolvedConfig.logger.info(\n                `  \\x1B[32m✓\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Env revalidated`,\n              )\n            }\n          }\n          catch (e) {\n            resolvedConfig.logger.error(\n              `\\n  \\x1B[31m✗\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Failed to reload env files: ${e instanceof Error ? e.message : String(e)}`,\n            )\n          }\n        }, 150) // 150ms debounce\n      })\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/guard.ts","../src/log.ts","../src/sources.ts","../src/virtual.ts","../src/plugin.ts"],"sourcesContent":["export type GuardMode = 'error' | 'stub' | 'warn'\n\nexport type GuardResult\n  = | { allowed: true }\n    | { allowed: false, mode: GuardMode, envName: string, importer: string | undefined }\n\nexport type GuardFail = Extract<GuardResult, { allowed: false }>\n\n/**\n * Determines whether the given Vite environment is allowed to import virtual:env/server.\n * Returns a GuardResult discriminated union — allowed or fail with context.\n * When this.environment is undefined (should not occur with Vite ≥ 8), callers default\n * envName to 'client' — failing closed (restrictive) is safer than failing open.\n */\nexport function checkServerModuleAccess(\n  envName: string,\n  serverEnvironments: string[],\n  mode: GuardMode,\n  importer: string | undefined,\n): GuardResult {\n  if (serverEnvironments.includes(envName))\n    return { allowed: true }\n  return { allowed: false, mode, envName, importer }\n}\n\n/**\n * Generates the stub virtual module returned when onClientAccessOfServerModule is 'stub'.\n * The stub throws at runtime if executed — its message reflects that this import was\n * expected to be unreachable and the assumption was wrong.\n */\nexport function buildServerStubModule(envName: string): { code: string, moduleType: 'js' } {\n  return {\n    moduleType: 'js',\n    code: `// Auto-generated by @vite-env/core — server-only module stub\nthrow new Error(\n  '[vite-env] virtual:env/server was imported in the \"${envName}\" environment. ' +\n  'This module is server-only and was replaced with a stub. ' +\n  'To allow this environment: add it to serverEnvironments. ' +\n  'To suppress this stub: ensure this import never executes in the \"${envName}\" environment.'\n);`,\n  }\n}\n","// @env node\nimport type { GuardFail } from './guard'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\nimport { formatGuardLogEntry } from './format'\n\nconst LOG_HEADER = `# vite-env warnings — generated by @vite-env/core\n# These warnings will become hard errors in 1.0.0.\n# To enforce immediately: ViteEnv({ onClientAccessOfServerModule: 'error' })\n# To acknowledge and suppress: ViteEnv({ onClientAccessOfServerModule: 'stub' })\n# To allow specific environments: ViteEnv({ serverEnvironments: ['ssr', 'workerd'] })`\n\n/**\n * Writes accumulated GuardFail entries to vite-env-warnings.log in the project root.\n * Overwrites on each build — stale entries from previous builds must not persist.\n * Called only in 'warn' mode from buildEnd, after verifying the build succeeded.\n */\nexport async function writeWarningsLog(fails: GuardFail[], root: string): Promise<void> {\n  const seen = new Set<string>()\n  const unique = fails.filter((fail) => {\n    const key = `${fail.envName}::${fail.importer ?? ''}`\n    if (seen.has(key))\n      return false\n    seen.add(key)\n    return true\n  })\n  const timestamp = new Date().toISOString()\n  const entries = unique.map(fail => formatGuardLogEntry(fail, timestamp)).join('\\n\\n')\n  const content = `${LOG_HEADER}\\n\\n${entries}\\n`\n  const filePath = path.join(root, 'vite-env-warnings.log')\n  try {\n    await fs.writeFile(filePath, content, 'utf-8')\n  }\n  catch (e) {\n    throw new Error(\n      `[vite-env] Failed to write vite-env-warnings.log to ${root}. Check file permissions.`,\n      { cause: e },\n    )\n  }\n}\n","// @env node\nimport type { ResolvedConfig } from 'vite'\nimport process from 'node:process'\nimport { loadEnv } from 'vite'\n\n/**\n * Merge priority (highest → lowest):\n *   1. process.env        (CI pipeline secrets win)\n *   2. .env.[mode].local\n *   3. .env.[mode]\n *   4. .env.local\n *   5. .env\n *\n * Prefix '' = load everything, schema decides what's valid.\n */\nexport async function loadEnvSources(\n  config: ResolvedConfig,\n): Promise<Record<string, string>> {\n  const fileEnv = loadEnv(\n    config.mode,\n    config.envDir || config.root,\n    '', // no prefix filter — schema is the filter\n  )\n\n  return {\n    ...fileEnv,\n    ...filterStrings(process.env),\n  }\n}\n\nfunction filterStrings(env: NodeJS.ProcessEnv): Record<string, string> {\n  return Object.fromEntries(\n    Object.entries(env).filter(\n      (entry): entry is [string, string] => typeof entry[1] === 'string',\n    ),\n  )\n}\n","import type { AnyEnvDefinition } from './types'\n\nexport function buildClientModule(\n  def: AnyEnvDefinition,\n  data: Record<string, unknown>,\n): { code: string, moduleType: 'js' } {\n  const clientKeys = new Set(Object.keys(def.client ?? {}))\n\n  const clientData = Object.fromEntries(\n    Object.entries(data).filter(([k]) => clientKeys.has(k)),\n  )\n\n  return {\n    moduleType: 'js', // Required: Vite 8 / Rolldown explicit moduleType\n    code: `// Auto-generated by @vite-env/core — do not edit\nexport const env = Object.freeze(${JSON.stringify(clientData, null, 2)});\nexport default env;`,\n  }\n}\n\nexport function buildServerModule(\n  _def: AnyEnvDefinition,\n  data: Record<string, unknown>,\n): { code: string, moduleType: 'js' } {\n  return {\n    moduleType: 'js',\n    code: `// Auto-generated by @vite-env/core — do not edit\nexport const env = Object.freeze(${JSON.stringify(data, null, 2)});\nexport default env;`,\n  }\n}\n","// @env node\nimport type { Plugin, ResolvedConfig, Rollup } from 'vite'\nimport type { GuardFail } from './guard'\nimport type { AnyEnvDefinition } from './types'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { loadEnvConfig } from './config'\nimport { generateStandardDts } from './dts'\nimport { formatGuardWarning, formatHardError, formatStandardSchemaError } from './format'\nimport { buildServerStubModule, checkServerModuleAccess } from './guard'\nimport { detectServerLeak } from './leak'\nimport { writeWarningsLog } from './log'\nimport { loadEnvSources } from './sources'\nimport { isStandardEnvDefinition, validateStandardEnv } from './standard'\nimport { buildClientModule, buildServerModule } from './virtual'\n\nexport interface ViteEnvOptions {\n  /**\n   * Path to env definition file.\n   * @default './env.ts' (resolved from project root)\n   */\n  configFile?: string\n\n  /**\n   * Vite 8 environment names that are allowed to import virtual:env/server.\n   * Use this to allow edge runtimes (Cloudflare Workers → 'workerd', Deno Deploy → 'ssr').\n   * @default ['ssr']\n   */\n  serverEnvironments?: string[]\n\n  /**\n   * Behavior when virtual:env/server is imported from a disallowed environment.\n   *\n   * - 'warn'  — Deprecation warning printed to terminal + vite-env-warnings.log written.\n   *             Build succeeds but exits with code 1. Default in 0.x releases.\n   *             The default will change to 'error' in 1.0.0.\n   *\n   * - 'error' — Hard build error. No artifacts emitted.\n   *\n   * - 'stub'  — Returns a module that throws at runtime if the import executes.\n   *             Use for testing environments (Vitest jsdom) or framework isomorphic files\n   *             where the import exists but the code path is never reached in a server context.\n   *\n   * @default 'warn'\n   */\n  onClientAccessOfServerModule?: 'error' | 'stub' | 'warn'\n}\n\n/**\n * Validates environment variables against the definition.\n * Routes to Zod or Standard Schema path based on definition type.\n * Zod modules are loaded dynamically to avoid requiring zod for Standard Schema users.\n */\nasync function validateAndFormat(\n  def: AnyEnvDefinition,\n  rawEnv: Record<string, string>,\n): Promise<{ data: Record<string, unknown> } | { error: string }> {\n  if (isStandardEnvDefinition(def)) {\n    const result = await validateStandardEnv(def, rawEnv)\n    if (!result.success) {\n      return { error: formatStandardSchemaError(result.errors) }\n    }\n    return { data: result.data }\n  }\n\n  const { validateEnv } = await import('./schema')\n  const { formatZodError } = await import('./format')\n  const result = validateEnv(def, rawEnv)\n  if (!result.success) {\n    return { error: formatZodError(result.errors) }\n  }\n  return { data: result.data }\n}\n\nexport default function ViteEnv(options: ViteEnvOptions = {}): Plugin {\n  let resolvedConfig: ResolvedConfig\n  let envDefinition: AnyEnvDefinition\n  let lastValidated: Record<string, unknown> = {}\n  let serverModuleGuardFails: GuardFail[] = []\n  let didSetExitCode = false\n\n  const serverEnvs = options.serverEnvironments ?? ['ssr']\n  const guardMode = options.onClientAccessOfServerModule ?? 'warn'\n\n  return {\n    name: 'vite-env',\n    enforce: 'pre',\n\n    async configResolved(config) {\n      resolvedConfig = config\n\n      const configPath = path.resolve(\n        config.root,\n        options.configFile ?? 'env.ts',\n      )\n\n      try {\n        envDefinition = await loadEnvConfig(configPath)\n      }\n      catch (e) {\n        throw new Error(\n          `[vite-env] Could not load env definition file at: ${configPath}\\n`\n          + `  Create an env.ts file and export default defineEnv({ ... })`,\n          { cause: e },\n        )\n      }\n    },\n\n    async buildStart() {\n      serverModuleGuardFails = []\n      if (didSetExitCode) {\n        process.exitCode = 0\n        didSetExitCode = false\n      }\n\n      const rawEnv = await loadEnvSources(resolvedConfig)\n      const result = await validateAndFormat(envDefinition, rawEnv)\n\n      if ('error' in result) {\n        throw new Error(\n          `[vite-env] Environment validation failed:\\n\\n${result.error}`,\n        )\n      }\n\n      lastValidated = result.data\n\n      if (isStandardEnvDefinition(envDefinition)) {\n        await generateStandardDts(envDefinition, resolvedConfig.root)\n      }\n      else {\n        const { generateDts } = await import('./dts')\n        await generateDts(envDefinition, resolvedConfig.root)\n      }\n\n      const count = Object.keys(lastValidated).length\n      resolvedConfig.logger.info(\n        `  \\x1B[32m✓\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m ${count} variables validated`,\n      )\n    },\n\n    resolveId(this: Rollup.PluginContext, source, importer) {\n      if (source === 'virtual:env/client')\n        return '\\0virtual:env/client'\n      if (source === 'virtual:env/server') {\n        const envName = this.environment?.name ?? 'client'\n        const result = checkServerModuleAccess(envName, serverEnvs, guardMode, importer)\n        if (!result.allowed)\n          serverModuleGuardFails.push(result)\n        return '\\0virtual:env/server'\n      }\n    },\n\n    load(this: Rollup.PluginContext, id) {\n      if (id === '\\0virtual:env/client')\n        return buildClientModule(envDefinition, lastValidated)\n      if (id === '\\0virtual:env/server') {\n        const envName = this.environment?.name ?? 'client'\n        // Filter to fails from this environment only — other envs may have recorded fails for their own loads\n        const envFails = serverModuleGuardFails.filter(f => f.envName === envName)\n        if (envFails.length > 0) {\n          // warn once per load cycle using the last recorded fail; unique importers are written to the log file\n          const latest = envFails.at(-1)!\n          if (latest.mode === 'error')\n            throw new Error(formatHardError(latest))\n          if (latest.mode === 'stub')\n            return buildServerStubModule(envName)\n          resolvedConfig.logger.warn(`\\n${formatGuardWarning(latest)}`)\n        }\n        return buildServerModule(envDefinition, lastValidated)\n      }\n    },\n\n    async buildEnd(error) {\n      if (error)\n        return\n      if (serverModuleGuardFails.length === 0)\n        return\n      if (guardMode !== 'warn')\n        return\n      await writeWarningsLog(serverModuleGuardFails, resolvedConfig.root)\n      process.exitCode = 1\n      didSetExitCode = true\n    },\n\n    generateBundle(_options, bundle) {\n      if (resolvedConfig.build.ssr)\n        return\n\n      const leaks = detectServerLeak(\n        envDefinition,\n        lastValidated,\n        bundle as Record<string, { type: string, code?: string }>,\n        (keys) => {\n          resolvedConfig.logger.warn(\n            `  \\x1B[33m⚠\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Leak detection skipped ${keys.length} server variable(s) with values shorter than 8 chars: ${keys.join(', ')}`,\n          )\n        },\n      )\n\n      if (leaks.length > 0) {\n        const details = leaks.map(l => `  ✗ ${l.key} found in ${l.chunk}`).join('\\n')\n        throw new Error(\n          `[vite-env] Server environment variables detected in client bundle!\\n\\n${details}\\n\\n  These variables are marked as server-only and must never reach the browser.`,\n        )\n      }\n    },\n\n    configureServer(server) {\n      const envDir = resolvedConfig.envDir || resolvedConfig.root\n      server.watcher.add(path.join(envDir, '.env*'))\n\n      let debounceTimer: ReturnType<typeof setTimeout>\n\n      server.watcher.on('change', async (file) => {\n        if (!path.basename(file).startsWith('.env'))\n          return\n\n        clearTimeout(debounceTimer)\n        debounceTimer = setTimeout(async () => {\n          try {\n            const rawEnv = await loadEnvSources(resolvedConfig)\n            const result = await validateAndFormat(envDefinition, rawEnv)\n\n            if ('error' in result) {\n              resolvedConfig.logger.warn(\n                `\\n  \\x1B[33m⚠\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Env revalidation failed:\\n${result.error}`,\n              )\n              return\n            }\n\n            lastValidated = result.data\n\n            const clientMod = server.moduleGraph.getModuleById('\\0virtual:env/client')\n            const serverMod = server.moduleGraph.getModuleById('\\0virtual:env/server')\n            if (clientMod)\n              server.moduleGraph.invalidateModule(clientMod)\n            if (serverMod)\n              server.moduleGraph.invalidateModule(serverMod)\n            if (clientMod || serverMod) {\n              serverModuleGuardFails = []\n              server.hot.send({ type: 'full-reload' })\n              resolvedConfig.logger.info(\n                `  \\x1B[32m✓\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Env revalidated`,\n              )\n            }\n          }\n          catch (e) {\n            resolvedConfig.logger.error(\n              `\\n  \\x1B[31m✗\\x1B[0m \\x1B[36m[vite-env]\\x1B[0m Failed to reload env files: ${e instanceof Error ? e.message : String(e)}`,\n            )\n          }\n        }, 150)\n      })\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/schema.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./dts-DF71HNdJ.cjs");
+require("./dts-BgHTl6hC.cjs");
 let zod = require("zod");
 //#region src/schema.ts
 function defineEnv(definition) {

package/dist/schema.d.cts

@@ -1,4 +1,4 @@
-import { i as ValidationResult, t as EnvDefinition } from "./types-DqTMuWwc.cjs";
+import { c as ValidationResult, n as EnvDefinition } from "./types-1okexcwM.cjs";
 
 //#region src/schema.d.ts
 declare function defineEnv<T extends EnvDefinition>(definition: T): T;

package/dist/schema.d.mts

@@ -1,4 +1,4 @@
-import { i as ValidationResult, t as EnvDefinition } from "./types-CluiDKAQ.mjs";
+import { c as ValidationResult, n as EnvDefinition } from "./types-DuWT_251.mjs";
 
 //#region src/schema.d.ts
 declare function defineEnv<T extends EnvDefinition>(definition: T): T;

package/dist/standard.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/standard.ts
+function defineStandardEnv(definition) {
+	if (definition.client) {
+		for (const key of Object.keys(definition.client)) if (!key.startsWith("VITE_")) throw new Error(`[vite-env] Client env var "${key}" must be prefixed with VITE_.\n  Rename it to "VITE_${key}" or move it to "server" if it's secret.`);
+	}
+	return {
+		...definition,
+		_standard: true
+	};
+}
+function isStandardEnvDefinition(def) {
+	return def != null && typeof def === "object" && "_standard" in def && def._standard === true;
+}
+async function validateStandardEnv(def, rawEnv) {
+	const combinedShape = {
+		...def.server,
+		...def.client
+	};
+	const errors = [];
+	const data = {};
+	for (const [key, schema] of Object.entries(combinedShape)) {
+		const result = await schema["~standard"].validate(rawEnv[key]);
+		if ("issues" in result && result.issues) for (const issue of result.issues) errors.push({
+			message: issue.message,
+			path: [key, ...issue.path ?? []]
+		});
+		else data[key] = result.value;
+	}
+	if (errors.length > 0) return {
+		success: false,
+		data: null,
+		errors
+	};
+	return {
+		success: true,
+		data,
+		errors: []
+	};
+}
+//#endregion
+exports.defineStandardEnv = defineStandardEnv;
+exports.isStandardEnvDefinition = isStandardEnvDefinition;
+exports.validateStandardEnv = validateStandardEnv;
+
+//# sourceMappingURL=standard.cjs.map

package/dist/standard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.cjs","names":[],"sources":["../src/standard.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { StandardEnvDefinition, StandardValidationIssue, StandardValidationResult } from './types'\n\nexport function defineStandardEnv<T extends Omit<StandardEnvDefinition, '_standard'>>(\n  definition: T,\n): T & { readonly _standard: true } {\n  if (definition.client) {\n    for (const key of Object.keys(definition.client)) {\n      if (!key.startsWith('VITE_')) {\n        throw new Error(\n          `[vite-env] Client env var \"${key}\" must be prefixed with VITE_.\\n`\n          + `  Rename it to \"VITE_${key}\" or move it to \"server\" if it's secret.`,\n        )\n      }\n    }\n  }\n\n  return { ...definition, _standard: true as const }\n}\n\nexport function isStandardEnvDefinition(\n  def: unknown,\n): def is StandardEnvDefinition {\n  return def != null && typeof def === 'object' && '_standard' in def && (def as any)._standard === true\n}\n\nexport async function validateStandardEnv(\n  def: StandardEnvDefinition,\n  rawEnv: Record<string, string>,\n): Promise<StandardValidationResult> {\n  const combinedShape: Record<string, StandardSchemaV1> = {\n    ...def.server,\n    ...def.client,\n  }\n\n  const errors: StandardValidationIssue[] = []\n  const data: Record<string, unknown> = {}\n\n  for (const [key, schema] of Object.entries(combinedShape)) {\n    const result = await schema['~standard'].validate(rawEnv[key])\n\n    if ('issues' in result && result.issues) {\n      for (const issue of result.issues) {\n        errors.push({\n          message: issue.message,\n          path: [key, ...(issue.path ?? [])],\n        })\n      }\n    }\n    else {\n      data[key] = (result as { value: unknown }).value\n    }\n  }\n\n  if (errors.length > 0) {\n    return { success: false, data: null, errors }\n  }\n\n  return { success: true, data, errors: [] as const }\n}\n"],"mappings":";;AAGA,SAAgB,kBACd,YACkC;AAClC,KAAI,WAAW;OACR,MAAM,OAAO,OAAO,KAAK,WAAW,OAAO,CAC9C,KAAI,CAAC,IAAI,WAAW,QAAQ,CAC1B,OAAM,IAAI,MACR,8BAA8B,IAAI,uDACR,IAAI,0CAC/B;;AAKP,QAAO;EAAE,GAAG;EAAY,WAAW;EAAe;;AAGpD,SAAgB,wBACd,KAC8B;AAC9B,QAAO,OAAO,QAAQ,OAAO,QAAQ,YAAY,eAAe,OAAQ,IAAY,cAAc;;AAGpG,eAAsB,oBACpB,KACA,QACmC;CACnC,MAAM,gBAAkD;EACtD,GAAG,IAAI;EACP,GAAG,IAAI;EACR;CAED,MAAM,SAAoC,EAAE;CAC5C,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,cAAc,EAAE;EACzD,MAAM,SAAS,MAAM,OAAO,aAAa,SAAS,OAAO,KAAK;AAE9D,MAAI,YAAY,UAAU,OAAO,OAC/B,MAAK,MAAM,SAAS,OAAO,OACzB,QAAO,KAAK;GACV,SAAS,MAAM;GACf,MAAM,CAAC,KAAK,GAAI,MAAM,QAAQ,EAAE,CAAE;GACnC,CAAC;MAIJ,MAAK,OAAQ,OAA8B;;AAI/C,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,SAAS;EAAO,MAAM;EAAM;EAAQ;AAG/C,QAAO;EAAE,SAAS;EAAM;EAAM,QAAQ,EAAE;EAAW"}

package/dist/standard.d.cts

@@ -0,0 +1,11 @@
+import { a as StandardEnvDefinition, s as StandardValidationResult } from "./types-1okexcwM.cjs";
+
+//#region src/standard.d.ts
+declare function defineStandardEnv<T extends Omit<StandardEnvDefinition, '_standard'>>(definition: T): T & {
+  readonly _standard: true;
+};
+declare function isStandardEnvDefinition(def: unknown): def is StandardEnvDefinition;
+declare function validateStandardEnv(def: StandardEnvDefinition, rawEnv: Record<string, string>): Promise<StandardValidationResult>;
+//#endregion
+export { defineStandardEnv, isStandardEnvDefinition, validateStandardEnv };
+//# sourceMappingURL=standard.d.cts.map

package/dist/standard.d.mts

@@ -0,0 +1,11 @@
+import { a as StandardEnvDefinition, s as StandardValidationResult } from "./types-DuWT_251.mjs";
+
+//#region src/standard.d.ts
+declare function defineStandardEnv<T extends Omit<StandardEnvDefinition, '_standard'>>(definition: T): T & {
+  readonly _standard: true;
+};
+declare function isStandardEnvDefinition(def: unknown): def is StandardEnvDefinition;
+declare function validateStandardEnv(def: StandardEnvDefinition, rawEnv: Record<string, string>): Promise<StandardValidationResult>;
+//#endregion
+export { defineStandardEnv, isStandardEnvDefinition, validateStandardEnv };
+//# sourceMappingURL=standard.d.mts.map

package/dist/standard.mjs

@@ -0,0 +1,43 @@
+//#region src/standard.ts
+function defineStandardEnv(definition) {
+	if (definition.client) {
+		for (const key of Object.keys(definition.client)) if (!key.startsWith("VITE_")) throw new Error(`[vite-env] Client env var "${key}" must be prefixed with VITE_.\n  Rename it to "VITE_${key}" or move it to "server" if it's secret.`);
+	}
+	return {
+		...definition,
+		_standard: true
+	};
+}
+function isStandardEnvDefinition(def) {
+	return def != null && typeof def === "object" && "_standard" in def && def._standard === true;
+}
+async function validateStandardEnv(def, rawEnv) {
+	const combinedShape = {
+		...def.server,
+		...def.client
+	};
+	const errors = [];
+	const data = {};
+	for (const [key, schema] of Object.entries(combinedShape)) {
+		const result = await schema["~standard"].validate(rawEnv[key]);
+		if ("issues" in result && result.issues) for (const issue of result.issues) errors.push({
+			message: issue.message,
+			path: [key, ...issue.path ?? []]
+		});
+		else data[key] = result.value;
+	}
+	if (errors.length > 0) return {
+		success: false,
+		data: null,
+		errors
+	};
+	return {
+		success: true,
+		data,
+		errors: []
+	};
+}
+//#endregion
+export { defineStandardEnv, isStandardEnvDefinition, validateStandardEnv };
+
+//# sourceMappingURL=standard.mjs.map

package/dist/standard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.mjs","names":[],"sources":["../src/standard.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { StandardEnvDefinition, StandardValidationIssue, StandardValidationResult } from './types'\n\nexport function defineStandardEnv<T extends Omit<StandardEnvDefinition, '_standard'>>(\n  definition: T,\n): T & { readonly _standard: true } {\n  if (definition.client) {\n    for (const key of Object.keys(definition.client)) {\n      if (!key.startsWith('VITE_')) {\n        throw new Error(\n          `[vite-env] Client env var \"${key}\" must be prefixed with VITE_.\\n`\n          + `  Rename it to \"VITE_${key}\" or move it to \"server\" if it's secret.`,\n        )\n      }\n    }\n  }\n\n  return { ...definition, _standard: true as const }\n}\n\nexport function isStandardEnvDefinition(\n  def: unknown,\n): def is StandardEnvDefinition {\n  return def != null && typeof def === 'object' && '_standard' in def && (def as any)._standard === true\n}\n\nexport async function validateStandardEnv(\n  def: StandardEnvDefinition,\n  rawEnv: Record<string, string>,\n): Promise<StandardValidationResult> {\n  const combinedShape: Record<string, StandardSchemaV1> = {\n    ...def.server,\n    ...def.client,\n  }\n\n  const errors: StandardValidationIssue[] = []\n  const data: Record<string, unknown> = {}\n\n  for (const [key, schema] of Object.entries(combinedShape)) {\n    const result = await schema['~standard'].validate(rawEnv[key])\n\n    if ('issues' in result && result.issues) {\n      for (const issue of result.issues) {\n        errors.push({\n          message: issue.message,\n          path: [key, ...(issue.path ?? [])],\n        })\n      }\n    }\n    else {\n      data[key] = (result as { value: unknown }).value\n    }\n  }\n\n  if (errors.length > 0) {\n    return { success: false, data: null, errors }\n  }\n\n  return { success: true, data, errors: [] as const }\n}\n"],"mappings":";AAGA,SAAgB,kBACd,YACkC;AAClC,KAAI,WAAW;OACR,MAAM,OAAO,OAAO,KAAK,WAAW,OAAO,CAC9C,KAAI,CAAC,IAAI,WAAW,QAAQ,CAC1B,OAAM,IAAI,MACR,8BAA8B,IAAI,uDACR,IAAI,0CAC/B;;AAKP,QAAO;EAAE,GAAG;EAAY,WAAW;EAAe;;AAGpD,SAAgB,wBACd,KAC8B;AAC9B,QAAO,OAAO,QAAQ,OAAO,QAAQ,YAAY,eAAe,OAAQ,IAAY,cAAc;;AAGpG,eAAsB,oBACpB,KACA,QACmC;CACnC,MAAM,gBAAkD;EACtD,GAAG,IAAI;EACP,GAAG,IAAI;EACR;CAED,MAAM,SAAoC,EAAE;CAC5C,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,cAAc,EAAE;EACzD,MAAM,SAAS,MAAM,OAAO,aAAa,SAAS,OAAO,KAAK;AAE9D,MAAI,YAAY,UAAU,OAAO,OAC/B,MAAK,MAAM,SAAS,OAAO,OACzB,QAAO,KAAK;GACV,SAAS,MAAM;GACf,MAAM,CAAC,KAAK,GAAI,MAAM,QAAQ,EAAE,CAAE;GACnC,CAAC;MAIJ,MAAK,OAAQ,OAA8B;;AAI/C,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,SAAS;EAAO,MAAM;EAAM;EAAQ;AAG/C,QAAO;EAAE,SAAS;EAAM;EAAM,QAAQ,EAAE;EAAW"}

package/dist/types-1okexcwM.d.cts

@@ -0,0 +1,43 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { z } from "zod";
+
+//#region src/types.d.ts
+interface EnvDefinition {
+  server?: z.ZodRawShape;
+  client?: z.ZodRawShape;
+}
+interface StandardEnvDefinition {
+  server?: Record<string, StandardSchemaV1>;
+  client?: Record<string, StandardSchemaV1>;
+  /** @internal */
+  readonly _standard: true;
+}
+type AnyEnvDefinition = EnvDefinition | StandardEnvDefinition;
+type ValidationResult = {
+  success: true;
+  data: Record<string, unknown>;
+  errors: [];
+} | {
+  success: false;
+  data: null;
+  errors: z.core.$ZodIssue[];
+};
+interface StandardValidationIssue {
+  message: string;
+  path: ReadonlyArray<PropertyKey | StandardSchemaV1.PathSegment>;
+}
+type StandardValidationResult = {
+  success: true;
+  data: Record<string, unknown>;
+  errors: [];
+} | {
+  success: false;
+  data: null;
+  errors: StandardValidationIssue[];
+};
+type OrEmptyShape<T> = T extends z.ZodRawShape ? T : Record<string, never>;
+type InferClientEnv<T extends EnvDefinition> = z.infer<z.ZodObject<OrEmptyShape<T['client']>>>;
+type InferServerEnv<T extends EnvDefinition> = z.infer<z.ZodObject<OrEmptyShape<T['server']> & OrEmptyShape<T['client']>>>;
+//#endregion
+export { StandardEnvDefinition as a, ValidationResult as c, InferServerEnv as i, EnvDefinition as n, StandardValidationIssue as o, InferClientEnv as r, StandardValidationResult as s, AnyEnvDefinition as t };
+//# sourceMappingURL=types-1okexcwM.d.cts.map

package/dist/types-DuWT_251.d.mts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/types.d.ts
+interface EnvDefinition {
+  server?: z.ZodRawShape;
+  client?: z.ZodRawShape;
+}
+interface StandardEnvDefinition {
+  server?: Record<string, StandardSchemaV1>;
+  client?: Record<string, StandardSchemaV1>;
+  /** @internal */
+  readonly _standard: true;
+}
+type AnyEnvDefinition = EnvDefinition | StandardEnvDefinition;
+type ValidationResult = {
+  success: true;
+  data: Record<string, unknown>;
+  errors: [];
+} | {
+  success: false;
+  data: null;
+  errors: z.core.$ZodIssue[];
+};
+interface StandardValidationIssue {
+  message: string;
+  path: ReadonlyArray<PropertyKey | StandardSchemaV1.PathSegment>;
+}
+type StandardValidationResult = {
+  success: true;
+  data: Record<string, unknown>;
+  errors: [];
+} | {
+  success: false;
+  data: null;
+  errors: StandardValidationIssue[];
+};
+type OrEmptyShape<T> = T extends z.ZodRawShape ? T : Record<string, never>;
+type InferClientEnv<T extends EnvDefinition> = z.infer<z.ZodObject<OrEmptyShape<T['client']>>>;
+type InferServerEnv<T extends EnvDefinition> = z.infer<z.ZodObject<OrEmptyShape<T['server']> & OrEmptyShape<T['client']>>>;
+//#endregion
+export { StandardEnvDefinition as a, ValidationResult as c, InferServerEnv as i, EnvDefinition as n, StandardValidationIssue as o, InferClientEnv as r, StandardValidationResult as s, AnyEnvDefinition as t };
+//# sourceMappingURL=types-DuWT_251.d.mts.map

package/package.json

@@ -2,7 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/vitejs/vite-plugin-registry/refs/heads/main/data/schema/extended-package-json.schema.json",
   "name": "@vite-env/core",
   "type": "module",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "The env.ts layer for Vite — define once, validate everywhere, import with types",
   "license": "MIT",
   "homepage": "https://github.com/pyyupsk/vite-env#readme",
@@ -20,7 +20,8 @@
     "zod",
     "validation",
     "rolldown",
-    "dotenv"
+    "dotenv",
+    "standard-schema"
   ],
   "exports": {
     ".": {
@@ -93,6 +94,16 @@
         "default": "./dist/schema.cjs"
       }
     },
+    "./standard": {
+      "import": {
+        "types": "./dist/standard.d.mts",
+        "default": "./dist/standard.mjs"
+      },
+      "require": {
+        "types": "./dist/standard.d.cts",
+        "default": "./dist/standard.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",
@@ -109,7 +120,13 @@
     "vite": ">=8.0.0",
     "zod": "^4.0.0"
   },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
   "dependencies": {
+    "@standard-schema/spec": "^1.1.0",
     "jiti": "^2.6.1"
   },
   "devDependencies": {