envzod 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -1,25 +1,7 @@
-import { ZodTypeAny, z } from 'zod';
-
-/** A record of field names to Zod types */
-type EnvSchema = Record<string, ZodTypeAny>;
-/** Infer the output type of an env schema */
-type InferEnv<T extends EnvSchema> = {
-    [K in keyof T]: z.infer<T[K]>;
-};
-interface EnvOptions<T extends EnvSchema> {
-    /** Custom env source. Defaults to process.env */
-    source?: Record<string, string | undefined>;
-    /** Log a success summary table in development. Defaults to false */
-    verbose?: boolean;
-    /** Called with formatted error string before throwing. Use for custom logging/alerting */
-    onError?: (errors: EnvValidationError[]) => void;
-}
-interface EnvValidationError {
-    field: string;
-    message: string;
-    received: string | undefined;
-}
+import { E as EnvSchema, a as EnvOptions, I as InferEnv } from './types-D3dpyeJh.mjs';
+export { b as EnvValidationError } from './types-D3dpyeJh.mjs';
+import 'zod';
 
 declare function createEnv<T extends EnvSchema>(schema: T, options?: EnvOptions<T>): InferEnv<T>;
 
-export { type EnvOptions, type EnvSchema, type EnvValidationError, type InferEnv, createEnv };
+export { EnvOptions, EnvSchema, InferEnv, createEnv };

package/dist/index.d.ts

@@ -1,25 +1,7 @@
-import { ZodTypeAny, z } from 'zod';
-
-/** A record of field names to Zod types */
-type EnvSchema = Record<string, ZodTypeAny>;
-/** Infer the output type of an env schema */
-type InferEnv<T extends EnvSchema> = {
-    [K in keyof T]: z.infer<T[K]>;
-};
-interface EnvOptions<T extends EnvSchema> {
-    /** Custom env source. Defaults to process.env */
-    source?: Record<string, string | undefined>;
-    /** Log a success summary table in development. Defaults to false */
-    verbose?: boolean;
-    /** Called with formatted error string before throwing. Use for custom logging/alerting */
-    onError?: (errors: EnvValidationError[]) => void;
-}
-interface EnvValidationError {
-    field: string;
-    message: string;
-    received: string | undefined;
-}
+import { E as EnvSchema, a as EnvOptions, I as InferEnv } from './types-D3dpyeJh.js';
+export { b as EnvValidationError } from './types-D3dpyeJh.js';
+import 'zod';
 
 declare function createEnv<T extends EnvSchema>(schema: T, options?: EnvOptions<T>): InferEnv<T>;
 
-export { type EnvOptions, type EnvSchema, type EnvValidationError, type InferEnv, createEnv };
+export { EnvOptions, EnvSchema, InferEnv, createEnv };

package/dist/index.js

@@ -57,7 +57,7 @@ function createEnv(schema, options) {
     const formatted = formatErrors(result.errors);
     console.error(formatted);
     options?.onError?.(result.errors);
-    throw new Error("zod-env: environment validation failed");
+    throw new Error(formatted);
   }
   if (options?.verbose) {
     console.log(formatSuccess(Object.keys(schema).length));
@@ -66,5 +66,3 @@ function createEnv(schema, options) {
 }
 
 exports.createEnv = createEnv;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/index.mjs

@@ -55,7 +55,7 @@ function createEnv(schema, options) {
     const formatted = formatErrors(result.errors);
     console.error(formatted);
     options?.onError?.(result.errors);
-    throw new Error("zod-env: environment validation failed");
+    throw new Error(formatted);
   }
   if (options?.verbose) {
     console.log(formatSuccess(Object.keys(schema).length));
@@ -64,5 +64,3 @@ function createEnv(schema, options) {
 }
 
 export { createEnv };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/next.d.mts

@@ -0,0 +1,30 @@
+import { E as EnvSchema, b as EnvValidationError, I as InferEnv } from './types-D3dpyeJh.mjs';
+import 'zod';
+
+interface NextEnvOptions<TServer extends EnvSchema, TClient extends EnvSchema> {
+    /** Server-only env vars — auto-sourced from process.env, never sent to the browser */
+    server?: TServer;
+    /** Client-safe env vars — must all start with NEXT_PUBLIC_ */
+    client?: TClient;
+    /**
+     * Explicit process.env references for each client key.
+     * Required because Next.js/webpack can only inline static process.env.KEY literals,
+     * not dynamic access. Server keys are auto-sourced and don't need to be listed here.
+     */
+    runtimeEnv: {
+        [K in keyof TClient]: string | undefined;
+    };
+    /** Log a success summary in development */
+    verbose?: boolean;
+    /** Called with validation errors before exiting */
+    onError?: (errors: EnvValidationError[]) => void;
+    /**
+     * Exit the process on validation failure instead of throwing.
+     * Default: false — throws an error normally.
+     * Set to true for a clean terminal output without Next.js stack trace noise.
+     */
+    bail?: boolean;
+}
+declare function createNextEnv<TServer extends EnvSchema = Record<never, never>, TClient extends EnvSchema = Record<never, never>>(options: NextEnvOptions<TServer, TClient>): InferEnv<TServer> & InferEnv<TClient>;
+
+export { type NextEnvOptions, createNextEnv };

package/dist/next.d.ts

@@ -0,0 +1,30 @@
+import { E as EnvSchema, b as EnvValidationError, I as InferEnv } from './types-D3dpyeJh.js';
+import 'zod';
+
+interface NextEnvOptions<TServer extends EnvSchema, TClient extends EnvSchema> {
+    /** Server-only env vars — auto-sourced from process.env, never sent to the browser */
+    server?: TServer;
+    /** Client-safe env vars — must all start with NEXT_PUBLIC_ */
+    client?: TClient;
+    /**
+     * Explicit process.env references for each client key.
+     * Required because Next.js/webpack can only inline static process.env.KEY literals,
+     * not dynamic access. Server keys are auto-sourced and don't need to be listed here.
+     */
+    runtimeEnv: {
+        [K in keyof TClient]: string | undefined;
+    };
+    /** Log a success summary in development */
+    verbose?: boolean;
+    /** Called with validation errors before exiting */
+    onError?: (errors: EnvValidationError[]) => void;
+    /**
+     * Exit the process on validation failure instead of throwing.
+     * Default: false — throws an error normally.
+     * Set to true for a clean terminal output without Next.js stack trace noise.
+     */
+    bail?: boolean;
+}
+declare function createNextEnv<TServer extends EnvSchema = Record<never, never>, TClient extends EnvSchema = Record<never, never>>(options: NextEnvOptions<TServer, TClient>): InferEnv<TServer> & InferEnv<TClient>;
+
+export { type NextEnvOptions, createNextEnv };

package/dist/next.js

@@ -0,0 +1,91 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/format.ts
+var BOX_WIDTH = 44;
+function pad(text, width) {
+  return text + " ".repeat(Math.max(0, width - text.length));
+}
+function formatErrors(errors) {
+  const lines = [];
+  const title = "  zod-env: Invalid Environment         ";
+  lines.push(`\u2554${"\u2550".repeat(BOX_WIDTH)}\u2557`);
+  lines.push(`\u2551${pad(title, BOX_WIDTH)}\u2551`);
+  lines.push(`\u255A${"\u2550".repeat(BOX_WIDTH)}\u255D`);
+  lines.push("");
+  for (const err of errors) {
+    lines.push(`  \u2717 ${err.field}`);
+    lines.push(`    ${err.message}`);
+    if (err.received !== void 0) {
+      lines.push(`    Got: "${err.received}"`);
+    }
+    lines.push("");
+  }
+  lines.push("  Fix the above and restart your server.");
+  return lines.join("\n");
+}
+function formatSuccess(count) {
+  return `\u2705 zod-env: ${count} variable${count === 1 ? "" : "s"} validated`;
+}
+function validate(schema, source) {
+  const shape = {};
+  for (const key of Object.keys(schema)) {
+    shape[key] = schema[key];
+  }
+  const zodObject = zod.z.object(shape);
+  const result = zodObject.safeParse(source);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  const errors = result.error.issues.map((issue) => {
+    const field = issue.path[0]?.toString() ?? "unknown";
+    return {
+      field,
+      message: issue.message,
+      received: source[field]
+    };
+  });
+  return { success: false, errors };
+}
+
+// src/next.ts
+function createNextEnv(options) {
+  const {
+    server = {},
+    client = {},
+    runtimeEnv,
+    verbose,
+    onError,
+    bail = false
+  } = options;
+  for (const key of Object.keys(client)) {
+    if (!key.startsWith("NEXT_PUBLIC_")) {
+      throw new Error(
+        `envzod/next: client key "${key}" must start with NEXT_PUBLIC_.
+Server-only keys belong in the "server" schema.`
+      );
+    }
+  }
+  const schema = { ...server, ...client };
+  const source = {
+    ...process.env,
+    ...runtimeEnv
+  };
+  const result = validate(schema, source);
+  if (!result.success) {
+    const formatted = formatErrors(result.errors);
+    console.error(formatted);
+    onError?.(result.errors);
+    if (bail) {
+      process.exit(1);
+    }
+    throw new Error(formatted);
+  }
+  if (verbose) {
+    console.log(formatSuccess(Object.keys(schema).length));
+  }
+  return result.data;
+}
+
+exports.createNextEnv = createNextEnv;

package/dist/next.mjs

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+
+// src/format.ts
+var BOX_WIDTH = 44;
+function pad(text, width) {
+  return text + " ".repeat(Math.max(0, width - text.length));
+}
+function formatErrors(errors) {
+  const lines = [];
+  const title = "  zod-env: Invalid Environment         ";
+  lines.push(`\u2554${"\u2550".repeat(BOX_WIDTH)}\u2557`);
+  lines.push(`\u2551${pad(title, BOX_WIDTH)}\u2551`);
+  lines.push(`\u255A${"\u2550".repeat(BOX_WIDTH)}\u255D`);
+  lines.push("");
+  for (const err of errors) {
+    lines.push(`  \u2717 ${err.field}`);
+    lines.push(`    ${err.message}`);
+    if (err.received !== void 0) {
+      lines.push(`    Got: "${err.received}"`);
+    }
+    lines.push("");
+  }
+  lines.push("  Fix the above and restart your server.");
+  return lines.join("\n");
+}
+function formatSuccess(count) {
+  return `\u2705 zod-env: ${count} variable${count === 1 ? "" : "s"} validated`;
+}
+function validate(schema, source) {
+  const shape = {};
+  for (const key of Object.keys(schema)) {
+    shape[key] = schema[key];
+  }
+  const zodObject = z.object(shape);
+  const result = zodObject.safeParse(source);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  const errors = result.error.issues.map((issue) => {
+    const field = issue.path[0]?.toString() ?? "unknown";
+    return {
+      field,
+      message: issue.message,
+      received: source[field]
+    };
+  });
+  return { success: false, errors };
+}
+
+// src/next.ts
+function createNextEnv(options) {
+  const {
+    server = {},
+    client = {},
+    runtimeEnv,
+    verbose,
+    onError,
+    bail = false
+  } = options;
+  for (const key of Object.keys(client)) {
+    if (!key.startsWith("NEXT_PUBLIC_")) {
+      throw new Error(
+        `envzod/next: client key "${key}" must start with NEXT_PUBLIC_.
+Server-only keys belong in the "server" schema.`
+      );
+    }
+  }
+  const schema = { ...server, ...client };
+  const source = {
+    ...process.env,
+    ...runtimeEnv
+  };
+  const result = validate(schema, source);
+  if (!result.success) {
+    const formatted = formatErrors(result.errors);
+    console.error(formatted);
+    onError?.(result.errors);
+    if (bail) {
+      process.exit(1);
+    }
+    throw new Error(formatted);
+  }
+  if (verbose) {
+    console.log(formatSuccess(Object.keys(schema).length));
+  }
+  return result.data;
+}
+
+export { createNextEnv };

package/dist/types-D3dpyeJh.d.mts

@@ -0,0 +1,23 @@
+import { ZodTypeAny, z } from 'zod';
+
+/** A record of field names to Zod types */
+type EnvSchema = Record<string, ZodTypeAny>;
+/** Infer the output type of an env schema */
+type InferEnv<T extends EnvSchema> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+interface EnvOptions<T extends EnvSchema> {
+    /** Custom env source. Defaults to process.env */
+    source?: Record<string, string | undefined>;
+    /** Log a success summary table in development. Defaults to false */
+    verbose?: boolean;
+    /** Called with formatted error string before throwing. Use for custom logging/alerting */
+    onError?: (errors: EnvValidationError[]) => void;
+}
+interface EnvValidationError {
+    field: string;
+    message: string;
+    received: string | undefined;
+}
+
+export type { EnvSchema as E, InferEnv as I, EnvOptions as a, EnvValidationError as b };

package/dist/types-D3dpyeJh.d.ts

@@ -0,0 +1,23 @@
+import { ZodTypeAny, z } from 'zod';
+
+/** A record of field names to Zod types */
+type EnvSchema = Record<string, ZodTypeAny>;
+/** Infer the output type of an env schema */
+type InferEnv<T extends EnvSchema> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+interface EnvOptions<T extends EnvSchema> {
+    /** Custom env source. Defaults to process.env */
+    source?: Record<string, string | undefined>;
+    /** Log a success summary table in development. Defaults to false */
+    verbose?: boolean;
+    /** Called with formatted error string before throwing. Use for custom logging/alerting */
+    onError?: (errors: EnvValidationError[]) => void;
+}
+interface EnvValidationError {
+    field: string;
+    message: string;
+    received: string | undefined;
+}
+
+export type { EnvSchema as E, InferEnv as I, EnvOptions as a, EnvValidationError as b };

package/package.json

@@ -1,74 +1,86 @@
-{
-  "name": "envzod",
-  "version": "1.0.0",
-  "description": "Universal, type-safe environment variable validation powered by Zod. Zero config, works everywhere.",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "sideEffects": false,
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist/index.js",
-    "dist/index.mjs",
-    "dist/index.d.ts",
-    "dist/index.d.mts",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "peerDependencies": {
-    "zod": ">=3.0.0"
-  },
-  "peerDependenciesMeta": {
-    "zod": {
-      "optional": false
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^1.0.0",
-    "zod": "^3.22.0"
-  },
-  "keywords": [
-    "zod",
-    "env",
-    "environment",
-    "validation",
-    "typescript",
-    "nodejs",
-    "nextjs",
-    "process.env",
-    "env-validation",
-    "type-safe",
-    "dotenv",
-    "schema"
-  ],
-  "author": "Sridhar-C-25",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Sridhar-C-25/zod-env"
-  },
-  "bugs": {
-    "url": "https://github.com/Sridhar-C-25/zod-env/issues"
-  },
-  "homepage": "https://github.com/Sridhar-C-25/zod-env#readme"
-}
+{
+  "name": "envzod",
+  "version": "1.1.0",
+  "description": "Universal, type-safe environment variable validation powered by Zod. Zero config, works everywhere.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.mjs",
+      "require": "./dist/next.js"
+    }
+  },
+  "bin": {
+    "envzod": "./dist/cli.js"
+  },
+  "files": [
+    "dist/index.js",
+    "dist/index.mjs",
+    "dist/next.js",
+    "dist/next.mjs",
+    "dist/cli.js",
+    "dist/*.d.ts",
+    "dist/*.d.mts",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "peerDependencies": {
+    "zod": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "jiti": "^2.6.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "keywords": [
+    "zod",
+    "env",
+    "environment",
+    "validation",
+    "typescript",
+    "nodejs",
+    "nextjs",
+    "process.env",
+    "env-validation",
+    "type-safe",
+    "dotenv",
+    "schema"
+  ],
+  "author": "Sridhar-C-25",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sridhar-C-25/zod-env"
+  },
+  "bugs": {
+    "url": "https://github.com/Sridhar-C-25/zod-env/issues"
+  },
+  "homepage": "https://github.com/Sridhar-C-25/zod-env#readme"
+}