@romaintaillandier1978/dotenv-never-lies 1.1.1 → 1.3.0

package/dist/cli/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { program, CommanderError } from "commander";
 import { assertCommand } from "./commands/assert.js";
-import { generateCommand } from "./commands/generate.js";
-import { reverseEnvCommand } from "./commands/reverseEnv.js";
+import { initCommand } from "./commands/init.js";
+import { inferCommand } from "./commands/infer.js";
 import { explainCommand, printHuman } from "./commands/explain.js";
 import { exportCommand } from "./commands/export.js";
 import { toFile } from "./utils/toFile.js";
@@ -56,7 +56,7 @@ program
   dnl generate --schema my-dnl.ts --out .env
   
   # Create an env.dnl.ts schema from an existing .env
-  dnl reverse-env --source .env
+  dnl infer --source .env
   
   # Display known variables and their description
   dnl explain
@@ -71,7 +71,10 @@ program
     .command("assert")
     .description("Verifies the runtime environment and exits the process if the schema is not satisfied.")
     .option("-s, --source <source>", "Variables source (default: process.env)")
-    .action(assertCommand)
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    await assertCommand({ ...opts, schema: globalOpts.schema });
+})
     .addHelpText("after", `\nExamples:
         
   # Validate environment variables from process.env
@@ -102,6 +105,7 @@ const exportHelp = {
     json: "Key/value JSON object",
     ts: "Typed TypeScript object",
     js: "JavaScript object",
+    types: "TypeScript declaration file (.d.ts) for your environment variables",
 };
 program
     .command("export")
@@ -117,7 +121,8 @@ program
     .option("--k8s-name <name>", "Name for the k8s resource. Default: env-secret for k8s-secret, env-config for k8s-configmap")
     .option("--github-org <org>", "GitHub organization name")
     .action(async (format, opts) => {
-    const { content, warnings, out } = await exportCommand({ ...opts, format });
+    const globalOpts = program.opts();
+    const { content, warnings, out } = await exportCommand({ ...opts, format, schema: globalOpts.schema });
     if (out) {
         await toFile(content, out, opts.force ?? false);
     }
@@ -225,49 +230,84 @@ program
   # Export variables as a typed TypeScript object, or js
   dnl export ts --out env.generated.ts --serialize-typed
   dnl export js --out env.generated.js --serialize-typed
+  `)
+    .addHelpText("after", `\nSpecific case of export types:
+      
+  This command generates a TypeScript declaration file (.d.ts)  describing the static contract of your environment variables.
+      
+  The generated types are intentionally conservative. Zod transforms are NOT reflected in the exported types.
+      
+  If a variable uses a Zod transform:
+    * a CLI warning is emitted
+    * the generated type is annotated with @dnl-transform
+    * the runtime value returned by assert() may differ from the declared type
+      
+  The --source option is NOT applicable to this format. Only the schema is used.
+      
+  # Example:
+  dnl export types --out src/types/env.dnl.d.ts
   `);
 // #endregion export
-// #region generate
+// #region init
 program
-    .command("generate")
-    .description("Generates a .env file from a DNL schema.\n" +
+    .command("init")
+    .description("Initialize an environment file from a DNL schema.\n" +
+    "This command does NOT read any existing environment variables.\n" +
     "Useful to bootstrap a project or facilitate onboarding of a new developer.\n" +
     "Only default values defined in the schema are written.")
     .option("-o, --out <file>", "Output file (default: .env)")
     .option("-f, --force", "Overwrite existing file")
     .action(async (opts) => {
-    const { content, out } = await generateCommand(opts);
+    const globalOpts = program.opts();
+    const { content, out } = await initCommand({ ...opts, schema: globalOpts.schema });
     await toFile(content, out, opts.force ?? false);
 })
     .addHelpText("after", `\nExamples:
         
-  # Generate a .env file from the default schema (env.dnl.ts)
-  dnl generate
+  # Initialize a .env file from the default DNL schema (env.dnl.ts)
+  dnl init
   
-  # Generate a .env file from a specified schema
-  dnl generate --schema my-dnl.ts
+  # Initialize a .env file from a specified DNL schema
+  dnl init --schema my-dnl.ts
   
-  # Generate a .env.local file from the schema
-  dnl generate --out .env.local
+  # Initialize a .env.local file from the DNL schema
+  dnl init --out .env.local
   
-  # Generate a .env file from a schema and overwrite the existing file
-  dnl generate --out .env --force
+  # Initialize a .env file from a DNL schema and overwrite the existing file
+  dnl init --out .env --force
       `);
-// #endregion generate
-// #region reverse-env
+// #endregion init
+// #region infer
 program
-    .command("reverse-env")
+    .command("infer")
     .description("Generates a dotenv-never-lies schema from a .env file.\n" +
     "Useful to migrate an existing project to dotenv-never-lies.\n" +
     "The generated schema is a starting point and must be refined manually.\n" +
-    "Keys in the .env file that are not valid identifiers are escaped to JSON strings. (e.g. MY-KEY -> 'MY-KEY')")
+    "Keys in the .env file that are not valid identifiers are escaped to JSON strings. (e.g. MY-KEY -> 'MY-KEY')\n" +
+    "By default, the command will try to guess sensitive variables (e.g. SECRET, KEY, TOKEN, PASSWORD) as secrets.\n" +
+    "This detection is intentionally aggressive and may flag variables that are not secrets.\n" +
+    "This is a deliberate design choice to avoid missing sensitive values.\n" +
+    "Use the --dont-guess-secret option to disable this behavior.\n" +
+    "\n" +
+    "Documentation: https://github.com/rtaillandier/dotenv-never-lies/blob/main/docs/commands/infer.md")
     .option("-s, --source <source>", "Source .env file", ".env")
     .option("-o, --out <file>", "Output DNL file", "env.dnl.ts")
     .option("-f, --force", "Overwrite existing file")
-    .option("--guess-secret", "Try to guess sensitive variables (heuristic)")
+    .option("--verbose", "Verbose mode")
+    .option("--dont-guess-secret", "Do not try to guess sensitive variables (heuristic)")
     .action(async (opts) => {
-    const { content, out, warnings } = await reverseEnvCommand(opts);
-    await toFile(content, out, opts.force ?? false);
+    const { content, out, warnings, verbose } = await inferCommand(opts);
+    if (opts.verbose) {
+        for (const v of verbose ?? []) {
+            console.log(v);
+        }
+    }
+    if (out) {
+        await toFile(content, out, opts.force ?? false);
+    }
+    else {
+        console.log(content);
+    }
     for (const warning of warnings) {
         console.error(`${warning}`);
     }
@@ -275,18 +315,21 @@ program
     .addHelpText("after", `\nExamples:
         
   # Generate an env.dnl.ts schema from a .env file, try to guess sensitive variables
-  dnl reverse-env --guess-secret
+  dnl infer --guess-secret
   
   # Generate an env.dnl.ts schema from a .env.local file
-  dnl reverse-env --source .env.local
+  dnl infer --source .env.local
   
   # Generate a my-dnl.ts schema from a .env file
-  dnl reverse-env --out my-dnl.ts
+  dnl infer --out my-dnl.ts
   
   # Generate an env.dnl.ts schema from a .env file and overwrite the existing file
-  dnl reverse-env --force 
+  dnl infer --force 
+  
+  # Full documentation:
+  # https://github.com/romaintaillandier1978/dotenv-never-lies/blob/main/docs/commands/infer.md
   `);
-// #endregion reverse-env
+// #endregion infer
 // #region explain
 program
     .command("explain")
@@ -294,7 +337,8 @@ program
     .argument("[keys...]", "Keys to explain (0..N). Without argument, all keys.")
     .option("-f, --format <format>", 'Output format ("human" | "json")', "human")
     .action(async (keys, opts) => {
-    const { format, result } = await explainCommand({ keys: keys ?? [], schema: opts.schema, format: opts.format });
+    const globalOpts = program.opts();
+    const { format, result } = await explainCommand({ keys: keys ?? [], schema: globalOpts.schema, format: opts.format });
     if (format === "human") {
         printHuman(result);
     }

package/dist/cli/utils/infer-schema.d.ts

@@ -1,3 +1,3 @@
-export declare const inferSchema: (value: string | undefined) => "z.string().optional()" | "z.coerce.boolean()" | "z.coerce.number()" | "z.string().url()" | "z.string().email()" | "z.string()";
-export declare const guessSecret: (value: string) => boolean;
+import { Import } from "../../infer/types.js";
+export declare const infer: (name: string, rawValue: string, imports: Array<Import>, verbose: Array<string>, warnings: Array<string>) => string;
 //# sourceMappingURL=infer-schema.d.ts.map

package/dist/cli/utils/infer-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infer-schema.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/infer-schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,GAAG,SAAS,oIAuBpD,CAAC;AAIF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,YAGxC,CAAC"}
+{"version":3,"file":"infer-schema.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/infer-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,EAAE,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,KAAK,CAAC,MAAM,CAAC,KAAG,MAsB/H,CAAC"}

package/dist/cli/utils/infer-schema.js

@@ -1,25 +1,23 @@
-export const inferSchema = (value) => {
-    if (value === undefined) {
-        return "z.string().optional()";
-    }
-    if (/^(true|false)$/i.test(value)) {
-        return "z.coerce.boolean()";
-    }
-    if (!isNaN(Number(value))) {
-        return "z.coerce.number()";
-    }
-    try {
-        new URL(value);
-        return "z.string().url()";
-    }
-    catch { }
-    if (/^[^@]+@[^@]+\.[^@]+$/.test(value)) {
-        return "z.string().email()";
+import { RULES } from "../../infer/index.js";
+export const infer = (name, rawValue, imports, verbose, warnings) => {
+    for (const pass of RULES) {
+        const result = pass.tryInfer({ name, rawValue });
+        if (!result)
+            continue;
+        if (result.confidence >= pass.threshold) {
+            verbose.push(`  Infer ${name} : `);
+            const importedNames = result.generated.imports.map((entry) => entry.name);
+            verbose.push(`    [${importedNames.join(", ")}]  confidence: ${result.confidence} / threshold: ${pass.threshold}`);
+            imports.push(...result.generated.imports);
+            if (result.reasons) {
+                verbose.push(...result.reasons.map((reason) => `    ${reason}`));
+            }
+            verbose.push(`    -> selected schema: ${result.generated.code}`);
+            if (result.warnings) {
+                warnings.push(...result.warnings);
+            }
+            return result.generated.code;
+        }
     }
     return "z.string()";
 };
-const secretMarkers = ["SECRET", "KEY", "TOKEN", "PASSWORD", "PASS", "AUTH"];
-export const guessSecret = (value) => {
-    const parts = value.toUpperCase().split(/[_\-]/);
-    return secretMarkers.some((marker) => parts.includes(marker));
-};

package/dist/cli/utils/printer.d.ts

@@ -11,6 +11,8 @@ export type Explanation = {
 };
 export declare const toExplanation: (key: string, value: EnvVarDefinition<any>) => Explanation;
 export declare function printZodType(def: z.core.$ZodTypeDef): string;
+export declare function printZodTypeDts(def: z.core.$ZodTypeDef): string;
 export declare function getDefaultEnvValue(def: z.core.$ZodTypeDef): string | undefined;
 export declare function isRequired(def: z.core.$ZodTypeDef): boolean;
+export declare function isTransform(def: z.core.$ZodTypeDef): boolean;
 //# sourceMappingURL=printer.d.ts.map

package/dist/cli/utils/printer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/printer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AACF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,KAAG,WAWzE,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAqE5D;AAuBD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,GAAG,SAAS,CAwB9E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,OAAO,CAyB3D"}
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/printer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AACF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,KAAG,WAWzE,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAqE5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CA6E/D;AAuBD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,GAAG,SAAS,CAwB9E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,OAAO,CAyB3D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,OAAO,CAkC5D"}

package/dist/cli/utils/printer.js

@@ -20,7 +20,7 @@ export function printZodType(def) {
         case "enum":
             if ("entries" in def) {
                 return Object.keys(def.entries)
-                    .map((k) => k)
+                    .map((k) => `"${k}"`)
                     .join(" | ");
             }
             return "unknown";
@@ -74,6 +74,78 @@ export function printZodType(def) {
             return "unknown";
     }
 }
+export function printZodTypeDts(def) {
+    switch (def.type) {
+        case "string":
+        case "number":
+        case "boolean":
+        case "transform":
+            return def.type;
+        case "enum":
+            if ("entries" in def) {
+                return Object.keys(def.entries)
+                    .map((k) => `"${k}"`)
+                    .join(" | ");
+            }
+            return "unknown";
+        case "literal":
+            if ("values" in def) {
+                return JSON.stringify(def.values[0]);
+            }
+            return "unknown";
+        case "array":
+            if ("element" in def) {
+                return printZodTypeDts(def.element) + "[]";
+            }
+            return "[]";
+        case "optional":
+            if ("innerType" in def) {
+                return printZodTypeDts(def.innerType) + " | undefined";
+            }
+            return "unknown  | undefined";
+        case "nullable":
+            if ("innerType" in def) {
+                return printZodTypeDts(def.innerType) + " | null";
+            }
+            return "unknown  | null";
+        case "default":
+            //TODO :  ignore les valeurs par défaut falsy (0, false, "") dans printZodType, donc dnl explain omet des defaults valides.
+            if ("innerType" in def) {
+                const result = printZodTypeDts(def.innerType);
+                const defaultValue = typeof def.defaultValue === "function" ? def.defaultValue() : (def.defaultValue ?? undefined);
+                // const defaultValue = (def as any).defaultValue;
+                if (defaultValue !== undefined) {
+                    return result;
+                }
+                return result;
+            }
+            return "unknown  | null";
+        // z.union
+        case "union":
+            if ("options" in def) {
+                return def.options.map(printZodTypeDts).join(" | ");
+            }
+            return "unknown";
+        // z.transform
+        case "pipe": {
+            if ("in" in def) {
+                return printZodTypeDts(def.in);
+            }
+            return "string"; // fallback défensif
+        }
+        case "transform": {
+            if (def.schema?.def) {
+                return printZodTypeDts(def.schema.def);
+            }
+            if (def.in) {
+                return printZodTypeDts(def.in);
+            }
+            return "string";
+        }
+        default:
+            return "unknown";
+    }
+}
 function stringifyEnvValue(value) {
     if (value === undefined || value === null) {
         return undefined;
@@ -136,3 +208,34 @@ export function isRequired(def) {
             return true;
     }
 }
+export function isTransform(def) {
+    switch (def.type) {
+        // Direct transform wrappers: if we see them anywhere in the tree, it's a transform.
+        case "pipe":
+        case "transform":
+            return true;
+        // Transparent wrappers: keep walking.
+        case "optional":
+        case "nullable":
+        case "default":
+            if ("innerType" in def) {
+                return isTransform(def.innerType);
+            }
+            return false;
+        // Arrays: check element.
+        case "array":
+            if ("element" in def) {
+                return isTransform(def.element);
+            }
+            return false;
+        // Unions: any option being a transform means transform.
+        case "union":
+            if ("options" in def) {
+                return def.options.some((opt) => isTransform(opt));
+            }
+            return false;
+        // Other types: no transform.
+        default:
+            return false;
+    }
+}

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC7D;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IACV;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAID;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI;KAClD,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;CAC1C,CAAC;AACF;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,IAAI;KAC3C,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CACnD,CAAC;AAEF,KAAK,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,KAAK,OAAO,CAAC;AACzE,KAAK,QAAQ,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEvG;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,aAAa,IAAI;IACvD;;OAEG;IACH,GAAG,EAAE,CAAC,CAAC;IACP;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C;;;;;;;;OAQG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;;;OASG;IACH,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,aAAa,EAAE,KAAK,CAAC,KAAG,mBAAmB,CAAC,CAAC,CAuB7E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,SAa1C,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAE7D;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IACV;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CAKvB;AAID;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI;KAClD,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;CAC1C,CAAC;AACF;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,IAAI;KAC3C,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CACnD,CAAC;AAEF,KAAK,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,KAAK,OAAO,CAAC;AACzE,KAAK,QAAQ,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEvG;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,aAAa,IAAI;IACvD;;OAEG;IACH,GAAG,EAAE,CAAC,CAAC;IACP;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C;;;;;;;;OAQG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;;;OASG;IACH,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,aAAa,EAAE,KAAK,CAAC,KAAG,mBAAmB,CAAC,CAAC,CAuB7E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,SAa1C,CAAC"}

package/dist/index.d.ts

@@ -2,4 +2,5 @@ import * as dnl from "./core.js";
 export * from "./core.js";
 export { dnl };
 export default dnl;
+export * from "./schemas/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AASjC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,eAAe,GAAG,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AASjC,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,eAAe,GAAG,CAAC;AAEnB,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -6,3 +6,4 @@ if (!("ZodFirstPartyTypeKind" in z)) {
 export * from "./core.js";
 export { dnl };
 export default dnl;
+export * from "./schemas/index.js";

package/dist/infer/__tests__/port-vs-version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=port-vs-version.test.d.ts.map

package/dist/infer/__tests__/port-vs-version.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-vs-version.test.d.ts","sourceRoot":"","sources":["../../../src/infer/__tests__/port-vs-version.test.ts"],"names":[],"mappings":""}

package/dist/infer/__tests__/port-vs-version.test.js

@@ -0,0 +1,32 @@
+import { describe, it, expect } from "vitest";
+import { portRule } from "../rules/port.js";
+import { versionRule } from "../rules/version.js";
+import { versionGenSchemaNoName } from "../generated/version.js";
+describe("Inference rules – port vs version", () => {
+    it("portRule should NOT match API_VERSION=2.0", () => {
+        const result = portRule.tryInfer({
+            name: "API_VERSION",
+            rawValue: "2.0",
+        });
+        // rule does not apply → null
+        expect(result).toBeNull();
+    });
+    it("versionRule should not match API_VERSION=2.0", () => {
+        const result = versionRule.tryInfer({
+            name: "API_VERSION",
+            rawValue: "2.0",
+        });
+        // rule does not recognizes a version pattern
+        expect(result).toBeNull();
+    });
+    it("versionRule should not match API_VERSION=2.0.0", () => {
+        const result = versionRule.tryInfer({
+            name: "API_VERSION",
+            rawValue: "2.0.0",
+        });
+        // rule recognizes a version pattern
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toContain(versionGenSchemaNoName.imports[0].name);
+        expect(result.confidence).toBeGreaterThanOrEqual(versionRule.threshold);
+    });
+});

package/dist/infer/__tests__/rules/basic.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=basic.test.d.ts.map

package/dist/infer/__tests__/rules/basic.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.test.d.ts","sourceRoot":"","sources":["../../../../src/infer/__tests__/rules/basic.test.ts"],"names":[],"mappings":""}

package/dist/infer/__tests__/rules/basic.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect } from "vitest";
+import { numberRule, emailRule, stringRule } from "../../rules/basic.js";
+import { zEmailGenSchema, zNumberGenSchema, zStringGenSchema } from "../../generated/basic.js";
+describe("Inference rules – basic", () => {
+    it("numberRule should match a valid number", () => {
+        const input = {
+            name: "NUMBER",
+            rawValue: "123",
+        };
+        const result = numberRule.tryInfer(input);
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toBe(zNumberGenSchema.code);
+        expect(result.confidence).toBeGreaterThanOrEqual(numberRule.threshold);
+    });
+    it("numberRule should match a valid number wrapped in quotes", () => {
+        const input = {
+            name: "NUMBER",
+            rawValue: '"123"',
+        };
+        const result = numberRule.tryInfer(input);
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toBe(zNumberGenSchema.code);
+        expect(result.confidence).toBeGreaterThanOrEqual(numberRule.threshold);
+    });
+    it("numberRule should match float values", () => {
+        const input = {
+            name: "RATE",
+            rawValue: "-12.5",
+        };
+        const result = numberRule.tryInfer(input);
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toBe(zNumberGenSchema.code);
+        expect(result.confidence).toBeGreaterThanOrEqual(numberRule.threshold);
+    });
+    it("numberRule should match integers outside port range", () => {
+        const input = {
+            name: "BIG_NUMBER",
+            rawValue: "+7e6",
+        };
+        const result = numberRule.tryInfer(input);
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toBe(zNumberGenSchema.code);
+        expect(result.confidence).toBeGreaterThanOrEqual(numberRule.threshold);
+    });
+});
+describe("Inference rules – email", () => {
+    it("emailRule should match a valid email-like value", () => {
+        const input = {
+            name: "CONTACT_EMAIL",
+            rawValue: "dev@example.com",
+        };
+        const result = emailRule.tryInfer(input);
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toBe(zEmailGenSchema.code);
+        expect(result.confidence).toBeGreaterThanOrEqual(emailRule.threshold);
+    });
+    it("emailRule should ignore non-email values", () => {
+        const input = {
+            name: "NOT_EMAIL",
+            rawValue: "dev@example",
+        };
+        const result = emailRule.tryInfer(input);
+        expect(result).toBeNull();
+    });
+    it("emailRule should ignore non-email values (database URL)", () => {
+        const input = {
+            name: "DATABASE_URL",
+            rawValue: "postgres://user:pass@localhost:5432/app",
+        };
+        const result = emailRule.tryInfer(input);
+        expect(result).toBeNull();
+    });
+});
+describe("Inference rules – string", () => {
+    it("stringRule should always fallback to string", () => {
+        const input = {
+            name: "ANY_VALUE",
+            rawValue: "whatever",
+        };
+        const result = stringRule.tryInfer(input);
+        expect(result).not.toBeNull();
+        expect(result?.generated.code).toBe(zStringGenSchema.code);
+        expect(result.confidence).toBeGreaterThanOrEqual(stringRule.threshold);
+    });
+});

package/dist/infer/__tests__/rules/boolean.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=boolean.test.d.ts.map

package/dist/infer/__tests__/rules/boolean.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.test.d.ts","sourceRoot":"","sources":["../../../../src/infer/__tests__/rules/boolean.test.ts"],"names":[],"mappings":""}

package/dist/infer/__tests__/rules/boolean.test.js

@@ -0,0 +1,34 @@
+import { booleanRule } from "../../rules/boolean.js";
+import { describe, it, expect } from "vitest";
+describe("Inference rules – boolean", () => {
+    it("booleanRule should match strict boolean values", () => {
+        const trueFalseValues = ["true", "false"];
+        for (const rawValue of trueFalseValues) {
+            const result = booleanRule.tryInfer({
+                name: "IS_ENABLED",
+                rawValue,
+            });
+            expect(result).not.toBeNull();
+        }
+    });
+    it("booleanRule should match 0 or 1 values", () => {
+        const zeroOneValues = ["0", "1"];
+        for (const rawValue of zeroOneValues) {
+            const result = booleanRule.tryInfer({
+                name: "IS_ENABLED",
+                rawValue,
+            });
+            expect(result).not.toBeNull();
+        }
+    });
+    it("booleanRule should match yes,no,y,n values", () => {
+        const yesNoValues = ["yes", "no", "y", "n"];
+        for (const rawValue of yesNoValues) {
+            const result = booleanRule.tryInfer({
+                name: "IS_ENABLED",
+                rawValue,
+            });
+            expect(result).not.toBeNull();
+        }
+    });
+});

package/dist/infer/__tests__/rules/duration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=duration.test.d.ts.map

package/dist/infer/__tests__/rules/duration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.test.d.ts","sourceRoot":"","sources":["../../../../src/infer/__tests__/rules/duration.test.ts"],"names":[],"mappings":""}

package/dist/infer/__tests__/rules/duration.test.js

@@ -0,0 +1,24 @@
+import { describe, it, expect } from "vitest";
+import { durationRule } from "../../rules/duration.js";
+describe("Inference rules – duration", () => {
+    it("durationRule should match a valid duration", () => {
+        const validDurations = ["5s", "10m", "2h", "3d", "4w", "5M", "6y"];
+        for (const rawValue of validDurations) {
+            const result = durationRule.tryInfer({
+                name: "REQUEST_TIMEOUT",
+                rawValue,
+            });
+            expect(result).not.toBeNull();
+        }
+    });
+    it("durationRule should ignore invalid durations", () => {
+        const invalidDurations = ["5", "-55.5h"];
+        for (const rawValue of invalidDurations) {
+            const result = durationRule.tryInfer({
+                name: "REQUEST_TIMEOUT",
+                rawValue,
+            });
+            expect(result).toBeNull();
+        }
+    });
+});

package/dist/infer/__tests__/rules/ip.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ip.test.d.ts.map

package/dist/infer/__tests__/rules/ip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.test.d.ts","sourceRoot":"","sources":["../../../../src/infer/__tests__/rules/ip.test.ts"],"names":[],"mappings":""}