zod-envkit 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -1,16 +1,41 @@
-## [1.1.1](https://github.com/nxtxe/zod-envkit/compare/v1.1.0...v1.1.1) (2026-01-29)
+# [1.2.0](https://github.com/nxtxe/zod-envkit/compare/v1.1.2...v1.2.0) (2026-02-16)
+
+
+### Features
+
+* stabilize preprod test suite, CLI E2E coverage, and CI pipeline ([463ea6e](https://github.com/nxtxe/zod-envkit/commit/463ea6e4676662dbbbe82bc79e0d85b079b524f8))
+
+## [1.1.2](https://github.com/nxtxe/zod-envkit/compare/v1.1.1...v1.1.2) (2026-01-29)
 
 
 ### Bug Fixes
 
-* **cli:** stabilize options validation and docs links ([640b12b](https://github.com/nxtxe/zod-envkit/commit/640b12bf95304da40c998374ba7ed08b7400e88d))
-* stabilize public API, CLI behavior, and documentation ([4604298](https://github.com/nxtxe/zod-envkit/commit/46042981f146f021919da8a4a713b2d251c542d9))
+* stabilize strict env validation and CI ([3055f18](https://github.com/nxtxe/zod-envkit/commit/3055f1859479212fbdc105cb0f183c6018df2376))
+* tests ([a691dab](https://github.com/nxtxe/zod-envkit/commit/a691dab0f207685bd96688e36aaabcdb5784f956))
 
 # Changelog
 
 All notable changes to this project will be documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.1.2](https://github.com/nxtxe/zod-envkit/compare/v1.1.1...v1.1.2) (2026-01-29)
+
+### Bug Fixes
+
+* **cli:** fix strict mode to validate only dotenv-loaded variables
+* **cli:** stabilize option validation and documentation links
+* **ci:** ensure CLI smoke tests and docs build in CI
+* internal cleanup to align behavior with documented API contract
+
+
+## [1.1.1](https://github.com/nxtxe/zod-envkit/compare/v1.1.0...v1.1.1) (2026-01-29)
+
+
+### Bug Fixes
+
+* **cli:** stabilize options validation and docs links ([640b12b](https://github.com/nxtxe/zod-envkit/commit/640b12bf95304da40c998374ba7ed08b7400e88d))
+* stabilize public API, CLI behavior, and documentation ([4604298](https://github.com/nxtxe/zod-envkit/commit/46042981f146f021919da8a4a713b2d251c542d9))
+
 ---
 
 ## [1.1.0] – 2026-01-27

package/dist/cli/index.cjs

@@ -346,6 +346,7 @@ function loadDotEnv(files) {
   const list = files?.split(",").map((s) => s.trim()).filter(Boolean) ?? [".env"];
   const loaded = [];
   const skipped = [];
+  const merged = {};
   for (const f of list) {
     const abs = resolvePath(f);
     if (!import_node_fs3.default.existsSync(abs)) {
@@ -354,10 +355,11 @@ function loadDotEnv(files) {
     }
     const raw = import_node_fs3.default.readFileSync(abs, "utf8");
     const parsed = import_dotenv.default.parse(raw);
+    for (const [k, v] of Object.entries(parsed)) merged[k] = v;
     for (const [k, v] of Object.entries(parsed)) process.env[k] = v;
     loaded.push(f);
   }
-  return { loaded, skipped };
+  return { loaded, skipped, env: merged };
 }
 
 // src/env.ts
@@ -491,9 +493,9 @@ function registerShow(program2, getLang2) {
 
 // src/cli/commands/check.ts
 function registerCheck(program2, getLang2) {
-  program2.command("check").description("Exit with code 1 if env is invalid (loads dotenv)").option("-c, --config <file>", "Path to env meta json", "env.meta.json").option("--dotenv <list>", "Comma-separated dotenv files (default: .env)", ".env").option("--strict", "Fail if unknown env vars are present").action((opts) => {
+  program2.command("check").description("Exit with code 1 if env is invalid (loads dotenv)").option("-c, --config <file>", "Path to env meta json", "env.meta.json").option("--dotenv <list>", "Comma-separated dotenv files (default: .env)", ".env").option("--strict", "Fail if unknown env vars are present (dotenv-only)").action((opts) => {
     const lang = getLang2();
-    loadDotEnv(String(opts.dotenv ?? ".env"));
+    const loaded = loadDotEnv(opts.dotenv);
     const { meta } = loadMeta(lang, opts.config);
     const missing = getMissingEnv(meta, process.env);
     if (missing.length) {
@@ -501,8 +503,8 @@ function registerCheck(program2, getLang2) {
       for (const k of missing) console.error(`- ${k}`);
       process.exit(1);
     }
-    if (Boolean(opts.strict)) {
-      const unknown = getUnknownEnv(meta, process.env);
+    if (opts.strict) {
+      const unknown = getUnknownEnv(meta, loaded.env);
       if (unknown.length) {
         console.error(`\u274C ${t(lang, "UNKNOWN_ENV")}`);
         for (const k of unknown) console.error(`- ${k}`);
@@ -538,18 +540,19 @@ function metaFromEnv(env, defaultGroup) {
   return meta;
 }
 function registerInit(program2, getLang2) {
-  program2.command("init").description("Initialize env.meta.json from .env.example (or generate .env.example from meta)").option("--input <file>", "Input file (default: .env.example)", ".env.example").option("--output <file>", "Output file (default: env.meta.json)", "env.meta.json").option("--from-meta", "Generate .env.example from env.meta.json instead").option("--group <name>", "Default group for all vars (when generating meta)").action((opts) => {
+  program2.command("init").description("Initialize env.meta.json from .env.example (or generate .env.example from meta)").option("--input <file>", "Input file (.env.example or env.meta.json)").option("--output <file>", "Output file (env.meta.json or .env.example)").option("--from-meta", "Generate .env.example from env.meta.json instead").option("--group <name>", "Default group for all vars (when generating meta)").action((opts) => {
     const lang = getLang2();
-    const input = String(opts.input ?? ".env.example");
-    const output = String(opts.output ?? "env.meta.json");
-    if (Boolean(opts.fromMeta)) {
+    const fromMeta = Boolean(opts.fromMeta);
+    const input = String(opts.input ?? (fromMeta ? "env.meta.json" : ".env.example"));
+    const output = String(opts.output ?? (fromMeta ? ".env.example" : "env.meta.json"));
+    if (fromMeta) {
       const { meta: meta2 } = loadMeta(lang, input);
       import_node_fs4.default.writeFileSync(output, generateEnvExample(meta2), "utf8");
       process.exit(0);
     }
     const env = readEnvFile(input);
     if (Object.keys(env).length === 0) {
-      fail(lang, "INIT_INPUT_EMPTY", [`- ${input}`]);
+      fail(lang, "META_PARSE_FAILED", [`- ${t(lang, "INIT_INPUT_EMPTY")} ${input}`]);
     }
     const meta = metaFromEnv(env, opts.group ? String(opts.group) : void 0);
     import_node_fs4.default.writeFileSync(output, JSON.stringify(meta, null, 2) + "\n", "utf8");

package/dist/cli/index.js

@@ -167,6 +167,7 @@ function loadDotEnv(files) {
   const list = files?.split(",").map((s) => s.trim()).filter(Boolean) ?? [".env"];
   const loaded = [];
   const skipped = [];
+  const merged = {};
   for (const f of list) {
     const abs = resolvePath(f);
     if (!fs3.existsSync(abs)) {
@@ -175,10 +176,11 @@ function loadDotEnv(files) {
     }
     const raw = fs3.readFileSync(abs, "utf8");
     const parsed = dotenv.parse(raw);
+    for (const [k, v] of Object.entries(parsed)) merged[k] = v;
     for (const [k, v] of Object.entries(parsed)) process.env[k] = v;
     loaded.push(f);
   }
-  return { loaded, skipped };
+  return { loaded, skipped, env: merged };
 }
 
 // src/cli/lib/mask.ts
@@ -279,9 +281,9 @@ function registerShow(program2, getLang2) {
 
 // src/cli/commands/check.ts
 function registerCheck(program2, getLang2) {
-  program2.command("check").description("Exit with code 1 if env is invalid (loads dotenv)").option("-c, --config <file>", "Path to env meta json", "env.meta.json").option("--dotenv <list>", "Comma-separated dotenv files (default: .env)", ".env").option("--strict", "Fail if unknown env vars are present").action((opts) => {
+  program2.command("check").description("Exit with code 1 if env is invalid (loads dotenv)").option("-c, --config <file>", "Path to env meta json", "env.meta.json").option("--dotenv <list>", "Comma-separated dotenv files (default: .env)", ".env").option("--strict", "Fail if unknown env vars are present (dotenv-only)").action((opts) => {
     const lang = getLang2();
-    loadDotEnv(String(opts.dotenv ?? ".env"));
+    const loaded = loadDotEnv(opts.dotenv);
     const { meta } = loadMeta(lang, opts.config);
     const missing = getMissingEnv(meta, process.env);
     if (missing.length) {
@@ -289,8 +291,8 @@ function registerCheck(program2, getLang2) {
       for (const k of missing) console.error(`- ${k}`);
       process.exit(1);
     }
-    if (Boolean(opts.strict)) {
-      const unknown = getUnknownEnv(meta, process.env);
+    if (opts.strict) {
+      const unknown = getUnknownEnv(meta, loaded.env);
       if (unknown.length) {
         console.error(`\u274C ${t(lang, "UNKNOWN_ENV")}`);
         for (const k of unknown) console.error(`- ${k}`);
@@ -326,18 +328,19 @@ function metaFromEnv(env, defaultGroup) {
   return meta;
 }
 function registerInit(program2, getLang2) {
-  program2.command("init").description("Initialize env.meta.json from .env.example (or generate .env.example from meta)").option("--input <file>", "Input file (default: .env.example)", ".env.example").option("--output <file>", "Output file (default: env.meta.json)", "env.meta.json").option("--from-meta", "Generate .env.example from env.meta.json instead").option("--group <name>", "Default group for all vars (when generating meta)").action((opts) => {
+  program2.command("init").description("Initialize env.meta.json from .env.example (or generate .env.example from meta)").option("--input <file>", "Input file (.env.example or env.meta.json)").option("--output <file>", "Output file (env.meta.json or .env.example)").option("--from-meta", "Generate .env.example from env.meta.json instead").option("--group <name>", "Default group for all vars (when generating meta)").action((opts) => {
     const lang = getLang2();
-    const input = String(opts.input ?? ".env.example");
-    const output = String(opts.output ?? "env.meta.json");
-    if (Boolean(opts.fromMeta)) {
+    const fromMeta = Boolean(opts.fromMeta);
+    const input = String(opts.input ?? (fromMeta ? "env.meta.json" : ".env.example"));
+    const output = String(opts.output ?? (fromMeta ? ".env.example" : "env.meta.json"));
+    if (fromMeta) {
       const { meta: meta2 } = loadMeta(lang, input);
       fs4.writeFileSync(output, generateEnvExample(meta2), "utf8");
       process.exit(0);
     }
     const env = readEnvFile(input);
     if (Object.keys(env).length === 0) {
-      fail(lang, "INIT_INPUT_EMPTY", [`- ${input}`]);
+      fail(lang, "META_PARSE_FAILED", [`- ${t(lang, "INIT_INPUT_EMPTY")} ${input}`]);
     }
     const meta = metaFromEnv(env, opts.group ? String(opts.group) : void 0);
     fs4.writeFileSync(output, JSON.stringify(meta, null, 2) + "\n", "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-envkit",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Validate environment variables with Zod and generate .env.example",
   "license": "MIT",
   "author": "",
@@ -38,16 +38,24 @@
     "README.md",
     "README.RU.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "package.json"
   ],
   "scripts": {
     "build": "rm -rf dist && tsup src/index.ts src/cli/index.ts --format esm,cjs --dts --outDir dist",
     "dev": "tsup src/index.ts src/cli/index.ts --watch --dts --outDir dist",
-    "test": "vitest run",
-    "release": "semantic-release",
-    "docs:api": "typedoc",
+    "test": "pnpm test:preprod",
+    "test:preprod": "pnpm build && vitest run tests/test/preprod",
+    "test:preprod:robust": "pnpm build && PREPROD_ITER=30 vitest run tests/test/preprod/30-robustness",
+    "test:before-release": "pnpm build && pnpm test:preprod && pnpm test:preprod:robust",
+    "ci:smoke": "pnpm build && node dist/cli/index.js --help",
+    "ci:docs": "pnpm docs:build",
+    "ci:all": "pnpm ci:smoke && pnpm test && pnpm ci:docs",
+    "prepublishOnly": "pnpm build && pnpm test",
+    "docs:api": "typedoc --tsconfig tsconfig.docs.json --entryPoints src/index.ts",
     "docs:build": "pnpm docs:api && vitepress build docs",
-    "docs:dev": "vitepress dev docs"
+    "docs:dev": "vitepress dev docs",
+    "release": "semantic-release"
   },
   "dependencies": {
     "commander": "^13.1.0",
@@ -63,7 +71,9 @@
     "@semantic-release/release-notes-generator": "^12.1.0",
     "@types/node": "^25.0.10",
     "eslint": "^9.39.2",
+    "execa": "^9.6.1",
     "semantic-release": "^22.0.12",
+    "tmp-promise": "^3.0.3",
     "tsup": "^8.5.1",
     "typedoc": "^0.28.16",
     "typedoc-plugin-markdown": "^4.9.0",