@romaintaillandier1978/dotenv-never-lies 0.4.0 → 1.1.0

package/dist/cli/commands/export.d.ts

@@ -13,6 +13,7 @@ export type ExportCliOptions = {
     hideSecret?: boolean;
     excludeSecret?: boolean;
     includeComments?: boolean;
+    serializeTyped?: boolean;
     out?: string | undefined;
     force?: boolean;
     k8sName?: string | undefined;
@@ -20,15 +21,15 @@ export type ExportCliOptions = {
 };
 export declare const exportCommand: (options: ExportCliOptions) => Promise<ExportResult>;
 export declare const contentByFormat: (format: ExportFormat, envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
-export declare const exportJson: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportEnv: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportDockerArgs: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportDockerEnv: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportK8sConfigmap: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportK8sSecret: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
-export declare const exportTs: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
-export declare const exportJs: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportGithubEnv: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportGithubSecret: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 export declare const exportGitlabEnv: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
+export declare const exportJson: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
+export declare const exportTs: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
+export declare const exportJs: (envDef: dnl.EnvDefinitionHelper<any>, options: ExportCliOptions, warnings: string[]) => string;
 //# sourceMappingURL=export.d.ts.map

package/dist/cli/commands/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,GAA4B,MAAM,gBAAgB,CAAC;AAM1D,eAAO,MAAM,kBAAkB,+IAYrB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AASF,eAAO,MAAM,aAAa,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,YAAY,CAwBnF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,YAAY,EAAE,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MA2B3I,CAAC;AAaF,eAAO,MAAM,SAAS,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAe/G,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAetH,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAgBrH,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAyBxH,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAsBrH,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAarH,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAqBxH,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAErH,CAAC;AA0BF,eAAO,MAAM,UAAU,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAehH,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAiB9G,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,gBAAgB,EAAE,UAAU,MAAM,EAAE,KAAG,MAiB9G,CAAC"}

package/dist/cli/commands/export.js

@@ -16,12 +16,21 @@ export const exportFormatsNames = [
     "ts",
     "js",
 ];
+const shellEscape = (value) => {
+    if (value.length === 0) {
+        return "''";
+    }
+    return `'${value.replace(/'/g, "'\\''")}'`;
+};
 export const exportCommand = async (options) => {
     if (options.githubOrg && options.format !== "github-secret") {
-        throw new UsageError("--github-org ne peut être utilisé qu’avec le format github-secret");
+        throw new UsageError("--github-org can only be used with the github-secret format");
     }
     if (options.k8sName && !options.format.startsWith("k8s-")) {
-        throw new UsageError("--k8s-name ne peut être utilisé qu’avec un format k8s-*");
+        throw new UsageError("--k8s-name can only be used with a k8s-* format");
+    }
+    if (options.serializeTyped && !["js", "ts", "json"].includes(options.format)) {
+        throw new UsageError("--serialize-typed is only valid for js, ts and json exports");
     }
     const schemaPath = resolveSchemaPath(options?.schema);
     const envDef = (await loadDef(schemaPath));
@@ -58,67 +67,47 @@ export const contentByFormat = (format, envDef, options, warnings) => {
         case "docker-env":
             return exportDockerEnv(envDef, options, warnings);
         default:
-            throw new UsageError(`Format ${format} non supporté`);
+            throw new UsageError(`Unsupported format: ${format}`);
     }
 };
-export const exportJson = (envDef, options, warnings) => {
-    if (options?.includeComments) {
-        warnings.push("--include-comments option ignorée pour le format json");
+// #region serialisation env-like
+const getRawValue = (key, source, envDef, options) => {
+    if (options?.hideSecret && envDef.def[key].secret) {
+        return "********";
     }
-    const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
-    const values = envDef.assert({ source });
-    const args = {};
-    for (const [key, value] of Object.entries(values)) {
-        if (options?.excludeSecret && envDef.def[key].secret) {
-            continue;
-        }
-        if (options?.hideSecret && envDef.def[key].secret) {
-            args[key] = "********";
-        }
-        else {
-            args[key] = value;
-        }
-    }
-    return JSON.stringify(args, null, 2);
+    const raw = source[key]; // raw value from source (i.e. .env or process.env)
+    return raw == null ? "" : String(raw);
 };
-// ca clone le .env
+// this clones the .env
 export const exportEnv = (envDef, options, warnings) => {
     const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
     const values = envDef.assert({ source });
     const args = [];
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (options?.excludeSecret && envDef.def[key].secret) {
             continue;
         }
         if (options?.includeComments && envDef.def[key].description) {
             args.push(`# ${envDef.def[key].description}`);
         }
-        if (options?.hideSecret && envDef.def[key].secret) {
-            args.push(`${key}=********`);
-        }
-        else {
-            args.push(`${key}=${value}`);
-        }
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`${key}=${rawValue}`);
     }
     return args.join("\n");
 };
 export const exportDockerArgs = (envDef, options, warnings) => {
     if (options?.includeComments) {
-        warnings.push("--include-comments option invalide avec le format docker-args");
+        warnings.push("The --include-comments option is invalid with the docker-args format");
     }
     const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
     const values = envDef.assert({ source });
     const args = [];
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (options?.excludeSecret && envDef.def[key].secret) {
             continue;
         }
-        if (options?.hideSecret && envDef.def[key].secret) {
-            args.push(`-e "${key}=********"`);
-        }
-        else {
-            args.push(`-e "${key}=${value}"`);
-        }
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`-e ${shellEscape(`${key}=${rawValue}`)}`);
     }
     return args.join(" ");
 };
@@ -126,19 +115,15 @@ export const exportDockerEnv = (envDef, options, warnings) => {
     const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
     const values = envDef.assert({ source });
     const args = [];
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (options?.excludeSecret && envDef.def[key].secret) {
             continue;
         }
         if (options?.includeComments && envDef.def[key].description) {
             args.push(`# ${envDef.def[key].description}`);
         }
-        if (options?.hideSecret && envDef.def[key].secret) {
-            args.push(`${key}=********`);
-        }
-        else {
-            args.push(`${key}=${value}`);
-        }
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`${key}=${rawValue}`);
     }
     return args.join("\n");
 };
@@ -152,16 +137,16 @@ export const exportK8sConfigmap = (envDef, options, warnings) => {
     const name = options?.k8sName ?? "env-config";
     args.push(`  name: ${name}`);
     args.push(`data:`);
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (envDef.def[key].secret) {
             if (options?.excludeSecret)
                 continue;
             if (!options?.hideSecret) {
-                warnings.push(`Secret ${key} exporté dans un ConfigMap. Utilisez le format k8s-secret.`);
+                warnings.push(`Secret ${key} exported in a ConfigMap. Use the k8s-secret format.`);
             }
         }
-        const v = options?.hideSecret && envDef.def[key].secret ? "********" : value;
-        args.push(`  ${key}: ${JSON.stringify(v)}`);
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`  ${key}: ${JSON.stringify(rawValue)}`);
     }
     return args.join("\n");
 };
@@ -176,88 +161,108 @@ export const exportK8sSecret = (envDef, options, warnings) => {
     const name = options?.k8sName ?? "env-secret";
     args.push(`  name: ${name}`);
     args.push(`stringData:`);
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (options?.excludeSecret && envDef.def[key].secret)
             continue;
         if (!envDef.def[key].secret)
-            continue; // Secret = uniquement les variables marquées secret
-        const v = options?.hideSecret ? "********" : value;
-        args.push(`  ${key}: ${JSON.stringify(v)}`);
+            continue; // Secret = only variables marked as secret
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`  ${key}: ${JSON.stringify(rawValue)}`);
     }
     return args.join("\n");
 };
-export const exportTs = (envDef, options, warnings) => {
-    const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
-    const values = envDef.assert({ source });
-    const middle = [];
-    for (const [key, value] of Object.entries(values)) {
-        if (options?.excludeSecret && envDef.def[key].secret) {
-            continue;
-        }
-        if (options?.includeComments && envDef.def[key].description) {
-            middle.push(`    // ${envDef.def[key].description}`);
-        }
-        if (options?.hideSecret && envDef.def[key].secret) {
-            middle.push(`    ${key}: "********",`);
-        }
-        else {
-            middle.push(`    ${key}: ${JSON.stringify(value, null, 2)},`);
-        }
-    }
-    return `export const env = {\n${middle.join("\n")}\n} as const;`;
-};
-export const exportJs = (envDef, options, warnings) => {
-    const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
-    const values = envDef.assert({ source });
-    const middle = [];
-    for (const [key, value] of Object.entries(values)) {
-        if (options?.excludeSecret && envDef.def[key].secret) {
-            continue;
-        }
-        if (options?.includeComments && envDef.def[key].description) {
-            middle.push(`    // ${envDef.def[key].description}`);
-        }
-        if (options?.hideSecret && envDef.def[key].secret) {
-            middle.push(`    ${key}: "********",`);
-        }
-        else {
-            middle.push(`    ${key}: ${JSON.stringify(value, null, 2)},`);
-        }
-    }
-    return `export const env = {\n${middle.join("\n")}\n};`;
-};
 export const exportGithubEnv = (envDef, options, warnings) => {
     const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
     const values = envDef.assert({ source });
     const args = [];
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (options?.excludeSecret && envDef.def[key].secret)
             continue;
-        const v = options?.hideSecret && envDef.def[key].secret ? "********" : value;
-        args.push(`echo "${key}=${v}" >> $GITHUB_ENV`);
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`printf '%s\\n' ${shellEscape(`${key}=${rawValue}`)} >> "$GITHUB_ENV"`);
     }
     return args.join("\n");
 };
 export const exportGithubSecret = (envDef, options, warnings) => {
     if (options?.hideSecret) {
-        warnings.push("--hide-secret est incompatible avec github-secret");
+        warnings.push("The --hide-secret option is incompatible with github-secret");
     }
     if (options?.githubOrg && options.githubOrg.includes(" ")) {
-        warnings.push("github-org contient un espace, commande gh probablement invalide");
+        warnings.push("github-org contains a space; gh command likely invalid");
     }
     const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
     const values = envDef.assert({ source });
-    const scopeFlag = options?.githubOrg ? `--org ${options?.githubOrg}` : "";
+    const scopeFlag = options?.githubOrg ? `--org ${shellEscape(options.githubOrg)}` : "";
     const args = [];
-    for (const [key, value] of Object.entries(values)) {
+    for (const key of Object.keys(values)) {
         if (!envDef.def[key].secret)
             continue;
         if (options?.excludeSecret)
             continue;
-        args.push(`echo ${JSON.stringify(value)} | gh secret set ${key} ${scopeFlag}`.trim());
+        const rawValue = getRawValue(key, source, envDef, options);
+        args.push(`printf '%s' ${shellEscape(rawValue)} | gh secret set ${key} ${scopeFlag} --body-file -`.trim());
     }
     return args.join("\n");
 };
 export const exportGitlabEnv = (envDef, options, warnings) => {
     return exportEnv(envDef, options, warnings);
 };
+// #endregion serialisation env-like
+// #region serialisation json/ts/js
+// WARNING : For design reasons and separation of concerns, do not attempt to merge getRawValue and getTypedOrRawValue into a single function.
+const getTypedOrRawValue = (key, source, values, envDef, options) => {
+    if (options?.hideSecret && envDef.def[key].secret) {
+        return "********";
+    }
+    if (options?.serializeTyped) {
+        return values[key]; // runtime validated value
+    }
+    const raw = source[key]; // raw value from source (i.e. .env or process.env)
+    return raw == null ? "" : String(raw);
+};
+export const exportJson = (envDef, options, warnings) => {
+    if (options?.includeComments) {
+        warnings.push("The --include-comments option is ignored for the json format");
+    }
+    const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
+    const values = envDef.assert({ source });
+    const args = {};
+    for (const key of Object.keys(values)) {
+        if (options?.excludeSecret && envDef.def[key].secret) {
+            continue;
+        }
+        args[key] = getTypedOrRawValue(key, source, values, envDef, options);
+    }
+    return JSON.stringify(args, null, 2);
+};
+export const exportTs = (envDef, options, warnings) => {
+    const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
+    const values = envDef.assert({ source });
+    const middle = [];
+    for (const key of Object.keys(values)) {
+        if (options?.excludeSecret && envDef.def[key].secret) {
+            continue;
+        }
+        if (options?.includeComments && envDef.def[key].description) {
+            middle.push(`    // ${envDef.def[key].description}`);
+        }
+        middle.push(`    ${key}: ${JSON.stringify(getTypedOrRawValue(key, source, values, envDef, options), null, 2)},`);
+    }
+    return `export const env = {\n${middle.join("\n")}\n} as const;`;
+};
+export const exportJs = (envDef, options, warnings) => {
+    const source = options?.source ? dnl.readEnvFile(path.resolve(process.cwd(), options.source)) : process.env;
+    const values = envDef.assert({ source });
+    const middle = [];
+    for (const key of Object.keys(values)) {
+        if (options?.excludeSecret && envDef.def[key].secret) {
+            continue;
+        }
+        if (options?.includeComments && envDef.def[key].description) {
+            middle.push(`    // ${envDef.def[key].description}`);
+        }
+        middle.push(`    ${key}: ${JSON.stringify(getTypedOrRawValue(key, source, values, envDef, options), null, 2)},`);
+    }
+    return `export const env = {\n${middle.join("\n")}\n};`;
+};
+// #endregion serialisation json/ts/js

package/dist/cli/commands/generate.d.ts

@@ -8,5 +8,8 @@ export type GenerateResult = {
     content: string;
     out: string;
 };
-export declare const generateCommand: (opts?: GenerateCliOptions | undefined) => Promise<GenerateResult>;
+export declare const generateCommand: (opts?: GenerateCliOptions | undefined) => Promise<{
+    content: string;
+    out: string;
+}>;
 //# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,OAAO,kBAAkB,GAAG,SAAS,KAAG,OAAO,CAAC,cAAc,CA6BnG,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,OAAO,kBAAkB,GAAG,SAAS,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA6BrH,CAAC"}

package/dist/cli/commands/reverseEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reverseEnv.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reverseEnv.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,OAAO,oBAAoB,GAAG,SAAS,KAAG,OAAO,CAAC,gBAAgB,CAuCzG,CAAC"}
+{"version":3,"file":"reverseEnv.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reverseEnv.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,OAAO,oBAAoB,GAAG,SAAS,KAAG,OAAO,CAAC,gBAAgB,CA6CzG,CAAC"}

package/dist/cli/commands/reverseEnv.js

@@ -15,6 +15,7 @@ export const reverseEnvCommand = async (opts) => {
     }
     const env = dnl.readEnvFile(source);
     const lines = [];
+    const warnings = [];
     lines.push(`// ⚠️ This file was generated by dotenv-never-lies`);
     lines.push(`// Review and adjust schemas, descriptions and secrets before using`);
     lines.push("");
@@ -23,7 +24,12 @@ export const reverseEnvCommand = async (opts) => {
     lines.push("");
     lines.push(`export default define({`);
     for (const [key, value] of Object.entries(env)) {
-        lines.push(`    ${key}: {`);
+        const isValidIdentifier = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key);
+        const safeKey = isValidIdentifier ? key : JSON.stringify(key);
+        if (!isValidIdentifier) {
+            warnings.push(`Key ${key} is not a valid identifier. It has been escaped to ${safeKey}.`);
+        }
+        lines.push(`    ${safeKey}: {`);
         lines.push(`        description: "TODO",`);
         lines.push(`        schema: ${inferSchema(value)},`);
         if (opts?.guessSecret && guessSecret(key)) {
@@ -35,6 +41,6 @@ export const reverseEnvCommand = async (opts) => {
     return {
         content: lines.join("\n"),
         out: target,
-        warnings: ["Generated schema is a prototype. Review schemas, descriptions and secrets before using."],
+        warnings: [...warnings, "Generated schema is a prototype. Review schemas, descriptions and secrets before using."],
     };
 };