@xlameiro/env-typegen 0.1.6 → 0.1.7

package/dist/index.d.cts

@@ -43,6 +43,21 @@ type ParsedEnvVar = {
      */
     isSecret?: boolean;
 };
+/**
+ * A non-fatal issue detected during parsing (e.g. a duplicate key).
+ * Collected in {@link ParsedEnvFile.warnings} when the parser encounters
+ * degenerate-but-valid input.
+ */
+type ParsedEnvWarning = {
+    /** Machine-readable code for programmatic handling. */
+    code: "ENV_DUPLICATE_KEY";
+    /** Human-readable description of the issue. */
+    message: string;
+    /** 1-based line number of the earlier (discarded) occurrence. */
+    line: number;
+    /** The duplicated variable name. */
+    key: string;
+};
 /**
  * The complete result of parsing a single .env.example file.
  * Passed to generators to produce TypeScript / Zod / t3-env output.
@@ -54,6 +69,11 @@ type ParsedEnvFile = {
     vars: ParsedEnvVar[];
     /** Unique group names found in the file, in order of appearance */
     groups: string[];
+    /**
+     * Non-fatal issues detected during parsing (e.g. duplicate keys).
+     * Undefined when no issues were found so the field is omitted in clean parses.
+     */
+    warnings?: ParsedEnvWarning[];
 };
 
 /**

package/dist/index.d.ts

@@ -43,6 +43,21 @@ type ParsedEnvVar = {
      */
     isSecret?: boolean;
 };
+/**
+ * A non-fatal issue detected during parsing (e.g. a duplicate key).
+ * Collected in {@link ParsedEnvFile.warnings} when the parser encounters
+ * degenerate-but-valid input.
+ */
+type ParsedEnvWarning = {
+    /** Machine-readable code for programmatic handling. */
+    code: "ENV_DUPLICATE_KEY";
+    /** Human-readable description of the issue. */
+    message: string;
+    /** 1-based line number of the earlier (discarded) occurrence. */
+    line: number;
+    /** The duplicated variable name. */
+    key: string;
+};
 /**
  * The complete result of parsing a single .env.example file.
  * Passed to generators to produce TypeScript / Zod / t3-env output.
@@ -54,6 +69,11 @@ type ParsedEnvFile = {
     vars: ParsedEnvVar[];
     /** Unique group names found in the file, in order of appearance */
     groups: string[];
+    /**
+     * Non-fatal issues detected during parsing (e.g. duplicate keys).
+     * Undefined when no issues were found so the field is omitted in clean parses.
+     */
+    warnings?: ParsedEnvWarning[];
 };
 
 /**

package/dist/index.js

@@ -245,6 +245,27 @@ function buildParsedVar(params, commentBlock, options) {
   }
   return parsedVar;
 }
+function deduplicateVars(vars) {
+  const seenKeys = /* @__PURE__ */ new Set();
+  const deduped = [];
+  const warnings = [];
+  for (let i = vars.length - 1; i >= 0; i--) {
+    const variable = vars[i];
+    if (variable === void 0) continue;
+    if (seenKeys.has(variable.key)) {
+      warnings.push({
+        code: "ENV_DUPLICATE_KEY",
+        message: `Duplicate key "${variable.key}" at line ${variable.lineNumber} \u2014 last occurrence wins.`,
+        line: variable.lineNumber,
+        key: variable.key
+      });
+    } else {
+      seenKeys.add(variable.key);
+      deduped.unshift(variable);
+    }
+  }
+  return { deduped, warnings };
+}
 function parseEnvFileContent(content, filePath, options) {
   const lines = content.split("\n");
   const vars = [];
@@ -287,16 +308,13 @@ function parseEnvFileContent(content, filePath, options) {
     );
     commentBlock = [];
   }
-  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 };
+  const { deduped, warnings } = deduplicateVars(vars);
+  return {
+    filePath,
+    vars: deduped,
+    groups,
+    ...warnings.length > 0 && { warnings }
+  };
 }
 function parseEnvFile(filePath) {
   const content = readFileSync(filePath, "utf8");
@@ -559,7 +577,8 @@ async function readEnvFile(filePath) {
     return await readFile(resolved, "utf8");
   } catch (err) {
     if (err instanceof Error && err.code === "ENOENT") {
-      throw new Error(`File not found: ${filePath}`);
+      const displayPath = path6.isAbsolute(filePath) ? filePath : `${filePath} (resolved: ${resolved})`;
+      throw new Error(`File not found: ${displayPath}`);
     }
     throw err;
   }
@@ -613,7 +632,8 @@ function deriveOutputPath(base, generator, isSingle) {
 function deriveOutputBaseForInput(output, inputPath) {
   const dir = path6.dirname(output);
   const ext = path6.extname(output);
-  const stem = path6.basename(inputPath, path6.extname(inputPath));
+  const rawBasename = path6.basename(inputPath);
+  const stem = rawBasename.startsWith(".") ? rawBasename.slice(1).replaceAll(".", "-") : path6.basename(inputPath, path6.extname(inputPath));
   return path6.join(dir, `${stem}${ext}`);
 }
 function buildOutput(generator, parsed) {
@@ -650,6 +670,12 @@ async function persistOutput(params) {
     success(`Generated ${outputPath}`);
   }
 }
+function emitParserWarnings(parsed) {
+  if (parsed.warnings === void 0) return;
+  for (const w of parsed.warnings) {
+    warn(`[${w.code}] ${w.message}`);
+  }
+}
 async function runGenerate(options) {
   const {
     input,
@@ -672,6 +698,7 @@ async function runGenerate(options) {
       inputPath,
       inferenceRules2 === void 0 ? void 0 : { inferenceRules: inferenceRules2 }
     );
+    emitParserWarnings(parsed);
     for (const generator of generators) {
       let generated = buildOutput(generator, parsed);
       if (shouldFormat && !dryRun) {
@@ -975,6 +1002,11 @@ function outputHuman(result) {
 async function runCheck(opts) {
   const contract = await resolveContract(opts.contract, opts.cwd);
   const parsed = parseEnvFile(opts.input);
+  if (parsed.warnings !== void 0) {
+    for (const w of parsed.warnings) {
+      warn(`[${w.code}] ${w.message}`);
+    }
+  }
   const validatorOpts = {};
   if (opts.environment !== void 0) validatorOpts.environment = opts.environment;
   if (opts.strict !== void 0) validatorOpts.strict = opts.strict;
@@ -1059,7 +1091,8 @@ async function loadCloudSource(options) {
     raw = await readFile(resolvedPath, "utf8");
   } catch (err) {
     if (err instanceof Error && err.code === "ENOENT") {
-      throw new Error(`File not found: ${options.filePath}`);
+      const displayPath = path6.isAbsolute(options.filePath) ? options.filePath : `${options.filePath} (resolved: ${resolvedPath})`;
+      throw new Error(`File not found: ${displayPath}`);
     }
     throw err;
   }
@@ -1891,7 +1924,8 @@ async function loadCommandConfig(configPath) {
   }
   const resolvedPath = path6.resolve(configPath);
   if (!existsSync(resolvedPath)) {
-    throw new Error(`Config file not found: ${configPath}`);
+    const displayPath = path6.isAbsolute(configPath) ? configPath : `${configPath} (resolved: ${resolvedPath})`;
+    throw new Error(`Config file not found: ${displayPath}`);
   }
   const configDir = path6.dirname(resolvedPath);
   const moduleValue = await import(pathToFileURL(resolvedPath).href);