@xlameiro/env-typegen 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.6
+
+### Patch Changes
+
+- 38a33eb: ## Fuzzy Dancers Find — env-typegen QA deficiency fixes (D1-D12)
+
+## 0.1.5
+
+### Patch Changes
+
+- 4ad0d2a: ## Fuzzy Dancers Find — env-typegen QA deficiency fixes (D1-D12)
+
 ## 0.1.4
 
 ### Patch Changes

package/README.md

@@ -1,9 +1,14 @@
 # env-typegen
 
 > From `.env.example` to typed outputs and contract-based environment governance.
+>
+> If this package saves debugging time for your team, consider starring the repository.
 
 [![npm version](https://badge.fury.io/js/%40xlameiro%2Fenv-typegen.svg)](https://npmjs.com/package/@xlameiro/env-typegen)
+[![npm downloads](https://img.shields.io/npm/dm/@xlameiro/env-typegen)](https://npmjs.com/package/@xlameiro/env-typegen)
 [![CI](https://github.com/xlameiro/env-typegen/actions/workflows/ci.yml/badge.svg)](https://github.com/xlameiro/env-typegen/actions/workflows/ci.yml)
+[![GitHub stars](https://img.shields.io/github/stars/xlameiro/env-typegen?style=social)](https://github.com/xlameiro/env-typegen/stargazers)
+[![Maintainer](https://img.shields.io/badge/maintainer-xlameiro-0ea5e9)](https://github.com/xlameiro)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 ## What this package does
@@ -134,6 +139,13 @@ Start with `check`. Add `diff` or `doctor` as your pipeline maturity grows.
 - Package docs index: [`/packages/env-typegen/docs`](./docs)
 - Changelog: [`CHANGELOG.md`](./CHANGELOG.md)
 
+## Trust signals
+
+- Maintained by [@xlameiro](https://github.com/xlameiro)
+- Security policy: [`SECURITY.md`](../../SECURITY.md)
+- Contribution guide: [`CONTRIBUTING.md`](../../CONTRIBUTING.md)
+- Published releases: [npm package page](https://www.npmjs.com/package/@xlameiro/env-typegen)
+
 ## Status
 
 `env-typegen` is actively maintained and published on npm.

package/dist/cli.js

@@ -99,7 +99,7 @@ var require_picocolors = __commonJS({
 });
 
 // src/cli.ts
-import { realpathSync } from "fs";
+import { existsSync as existsSync6, realpathSync } from "fs";
 import { createRequire } from "module";
 import path13 from "path";
 import { fileURLToPath, pathToFileURL as pathToFileURL5 } from "url";
@@ -388,7 +388,9 @@ var inferenceRules = [
   {
     id: "P10_url_scheme",
     priority: 10,
-    match: (_key, value) => /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(value),
+    // BUG-02: comma-separated URL lists (e.g. ALLOWED_ORIGINS) must NOT be inferred as
+    // a single URL — they don't pass z.string().url() or new URL() validation at runtime.
+    match: (_key, value) => !value.includes(",") && /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(value),
     type: "url"
   },
   {
@@ -599,7 +601,16 @@ function parseEnvFileContent(content, filePath, options) {
     );
     commentBlock = [];
   }
-  return { filePath, vars, groups };
+  const seenKeys = /* @__PURE__ */ new Set();
+  const deduped = [];
+  for (let i = vars.length - 1; i >= 0; i--) {
+    const variable = vars[i];
+    if (variable !== void 0 && !seenKeys.has(variable.key)) {
+      seenKeys.add(variable.key);
+      deduped.unshift(variable);
+    }
+  }
+  return { filePath, vars: deduped, groups };
 }
 function parseEnvFile(filePath) {
   const content = readFileSync(filePath, "utf8");
@@ -610,7 +621,15 @@ function parseEnvFile(filePath) {
 import { mkdir, readFile, writeFile } from "fs/promises";
 import path4 from "path";
 async function readEnvFile(filePath) {
-  return readFile(path4.resolve(filePath), "utf8");
+  const resolved = path4.resolve(filePath);
+  try {
+    return await readFile(resolved, "utf8");
+  } catch (err) {
+    if (err instanceof Error && err.code === "ENOENT") {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    throw err;
+  }
 }
 async function writeOutput(filePath, content) {
   const resolved = path4.resolve(filePath);
@@ -634,19 +653,30 @@ async function formatOutput(content, parser = "typescript") {
 
 // src/utils/logger.ts
 var import_picocolors = __toESM(require_picocolors(), 1);
+var { green, red, yellow } = import_picocolors.default;
 function log(message) {
   console.log(message);
 }
+function warn(message) {
+  console.warn(yellow(`\u26A0 ${message}`));
+}
 function error(message) {
-  console.error((0, import_picocolors.red)(`\u2716 ${message}`));
+  console.error(red(`\u2716 ${message}`));
 }
 function success(message) {
-  console.log((0, import_picocolors.green)(`\u2714 ${message}`));
+  console.log(green(`\u2714 ${message}`));
 }
 
 // src/pipeline.ts
 function deriveOutputPath(base, generator, isSingle) {
-  if (isSingle) return base;
+  if (isSingle) {
+    if (generator === "declaration" && !base.endsWith(".d.ts")) {
+      const ext2 = path5.extname(base);
+      const noExt2 = ext2.length > 0 ? base.slice(0, -ext2.length) : base;
+      return `${noExt2}.d.ts`;
+    }
+    return base;
+  }
   const ext = path5.extname(base);
   const noExt = ext.length > 0 ? base.slice(0, -ext.length) : base;
   const baseExt = ext.length > 0 ? ext : ".ts";
@@ -684,10 +714,6 @@ async function persistOutput(params) {
   }
   if (dryRun) {
     if (!silent) {
-      if (!isSingle) {
-        console.log(`// --- ${generator}: ${outputPath} ---`);
-      }
-      console.log(generated);
       success(`Dry run: would write ${outputPath}`);
     }
     return;
@@ -739,6 +765,7 @@ async function runGenerate(options) {
 }
 
 // src/validation-command.ts
+import { existsSync as existsSync4 } from "fs";
 import path11 from "path";
 import { pathToFileURL as pathToFileURL4 } from "url";
 import { parseArgs } from "util";
@@ -810,7 +837,15 @@ function parseProviderPayload(provider, value) {
 }
 async function loadCloudSource(options) {
   const resolvedPath = path6.resolve(options.filePath);
-  const raw = await readFile2(resolvedPath, "utf8");
+  let raw;
+  try {
+    raw = await readFile2(resolvedPath, "utf8");
+  } catch (err) {
+    if (err instanceof Error && err.code === "ENOENT") {
+      throw new Error(`File not found: ${options.filePath}`);
+    }
+    throw err;
+  }
   const parsed = JSON.parse(raw);
   return parseProviderPayload(options.provider, parsed);
 }
@@ -820,7 +855,7 @@ import { existsSync as existsSync2 } from "fs";
 import path7 from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 var SECRET_KEY_RE = /(SECRET|TOKEN|PASSWORD|PRIVATE|API_KEY|ACCESS_KEY|CLIENT_SECRET)/i;
-var CONTRACT_FILE_NAMES = ["env.contract.ts", "env.contract.mjs", "env.contract.js"];
+var CONTRACT_FILE_NAMES = ["env.contract.mjs", "env.contract.js", "env.contract.ts"];
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -944,6 +979,12 @@ async function loadValidationContract(options) {
   const discoveredContractPath = findDefaultContractPath(cwd);
   const resolvedContractPath = contractPath === void 0 ? discoveredContractPath : path7.resolve(cwd, contractPath);
   if (resolvedContractPath !== void 0 && existsSync2(resolvedContractPath)) {
+    if (resolvedContractPath.endsWith(".ts")) {
+      throw new Error(
+        `Contract file ${resolvedContractPath} is a TypeScript file and cannot be loaded at runtime by Node.js.
+Rename it to ${resolvedContractPath.replace(/\.ts$/, ".mjs")} and use ESM syntax (export default ...), or run via \`tsx\` / \`ts-node\` as a loader.`
+      );
+    }
     const moduleUrl = pathToFileURL2(resolvedContractPath).href;
     const moduleValue = await import(moduleUrl);
     const candidate = moduleValue.default ?? moduleValue.contract;
@@ -961,6 +1002,7 @@ async function loadValidationContract(options) {
 }
 
 // src/plugins.ts
+import { existsSync as existsSync3 } from "fs";
 import path8 from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 function isRecord3(value) {
@@ -982,6 +1024,9 @@ function isPlugin(value) {
 }
 async function loadPluginFromPath(pluginPath, cwd) {
   const resolvedPath = path8.resolve(cwd, pluginPath);
+  if (!existsSync3(resolvedPath)) {
+    throw new Error(`Plugin not found: ${pluginPath}`);
+  }
   const moduleValue = await import(pathToFileURL3(resolvedPath).href);
   const candidate = moduleValue.default ?? moduleValue.plugin;
   if (isPlugin(candidate)) return candidate;
@@ -1198,7 +1243,7 @@ function isClientSecret(variable, key) {
 function checkContractVariable(key, variable, context) {
   const { options, issues } = context;
   const value = options.values[key];
-  const hasValue = value !== void 0 && value.trim().length > 0;
+  const hasValue = value !== void 0 && (value !== "" || !variable.required);
   if (variable.required && !hasValue) {
     issues.push(
       createIssue({
@@ -1300,7 +1345,11 @@ function diffTypeConflicts(key, present, context) {
   for (const entry of present) {
     typeBySource.set(entry.sourceName, detectReceivedType(entry.value ?? ""));
   }
-  if (new Set(typeBySource.values()).size <= 1) return;
+  const knownTypes = /* @__PURE__ */ new Set();
+  for (const t of typeBySource.values()) {
+    if (t !== "unknown") knownTypes.add(t);
+  }
+  if (knownTypes.size <= 1) return;
   for (const [sourceName, detectedType] of typeBySource.entries()) {
     issues.push(
       createIssue({
@@ -1379,12 +1428,8 @@ function diffEnvironmentSources(options) {
       sourceName,
       value: options.sources[sourceName]?.[key]
     }));
-    const present = valuesBySource.filter(
-      (entry) => entry.value !== void 0 && entry.value !== ""
-    );
-    const missing = valuesBySource.filter(
-      (entry) => entry.value === void 0 || entry.value === ""
-    );
+    const present = valuesBySource.filter((entry) => entry.value !== void 0);
+    const missing = valuesBySource.filter((entry) => entry.value === void 0);
     if (present.length === 0 && variable?.required === true) {
       for (const entry of missing) {
         issues.push(
@@ -1475,6 +1520,7 @@ async function loadEnvSource(options) {
     return parseEnvSourceContent(content);
   } catch (error_) {
     if (options.allowMissing === true && error_ instanceof Error && "code" in error_ && error_.code === "ENOENT") {
+      warn(`Target file not found: ${options.filePath} \u2014 treating as empty`);
       return {};
     }
     throw error_;
@@ -1645,6 +1691,9 @@ async function loadCommandConfig(configPath) {
     return loadConfig(process.cwd());
   }
   const resolvedPath = path11.resolve(configPath);
+  if (!existsSync4(resolvedPath)) {
+    throw new Error(`Config file not found: ${configPath}`);
+  }
   const configDir = path11.dirname(resolvedPath);
   const moduleValue = await import(pathToFileURL4(resolvedPath).href);
   if (moduleValue.default === void 0) return void 0;
@@ -1904,6 +1953,7 @@ async function runValidationCommand(params) {
 
 // src/watch.ts
 import { watch } from "chokidar";
+import { existsSync as existsSync5 } from "fs";
 import path12 from "path";
 function debounce(fn, delay) {
   let timer;
@@ -1916,6 +1966,13 @@ function debounce(fn, delay) {
   };
 }
 function startWatch({ inputPath, runOptions, cwd = process.cwd() }) {
+  const inputPaths = Array.isArray(inputPath) ? inputPath : [inputPath];
+  for (const singlePath of inputPaths) {
+    if (!existsSync5(singlePath)) {
+      error(`File not found: ${singlePath}`);
+      return process.exit(1);
+    }
+  }
   const inputLabel = Array.isArray(inputPath) ? inputPath.join(", ") : inputPath;
   log(`Watching ${inputLabel} for changes...`);
   void runGenerate(runOptions).catch((err) => {
@@ -2061,6 +2118,15 @@ async function runValidationSubcommand(subcommand, argv) {
     process.exitCode = exitCode;
   }
 }
+async function loadExplicitConfig(configPath, userPath) {
+  if (!existsSync6(configPath)) {
+    throw new Error(`Config file not found: ${userPath}`);
+  }
+  const configDir = path13.dirname(configPath);
+  const mod = await import(pathToFileURL5(configPath).href);
+  const rawConfig = mod.default;
+  return rawConfig ? applyConfigPaths2(rawConfig, configDir) : void 0;
+}
 async function runCli(argv = process.argv.slice(2)) {
   const maybeSubcommand = argv[0];
   if (maybeSubcommand !== void 0 && VALIDATION_SUBCOMMANDS.has(maybeSubcommand)) {
@@ -2096,13 +2162,7 @@ async function runCli(argv = process.argv.slice(2)) {
   if (values.config === void 0) {
     fileConfig = await loadConfig(process.cwd());
   } else {
-    const configPath = path13.resolve(values.config);
-    const configDir = path13.dirname(configPath);
-    const mod = await import(pathToFileURL5(configPath).href);
-    const rawConfig = mod.default;
-    if (rawConfig) {
-      fileConfig = applyConfigPaths2(rawConfig, configDir);
-    }
+    fileConfig = await loadExplicitConfig(path13.resolve(values.config), values.config);
   }
   const cliInput = values.input?.length ? values.input : void 0;
   const input = cliInput ?? fileConfig?.input;