ultraenv 1.0.0

package/dist/chunk-CHVO6NWI.js

@@ -0,0 +1,203 @@
+import {
+  isSecretKey,
+  isSecretLike,
+  maskValue
+} from "./chunk-TE7HPLA6.js";
+import {
+  parseEnvFile
+} from "./chunk-HFXQGJY3.js";
+import {
+  exists,
+  readFile,
+  writeFile
+} from "./chunk-3VYXPTYV.js";
+
+// src/sync/generator.ts
+var HEADER = [
+  "# ============================================================",
+  "# Auto-generated by ultraenv \u2014 DO NOT EDIT",
+  "# Copy this file to .env and fill in the values",
+  "# ============================================================",
+  ""
+].join("\n");
+function schemaTypeToString(schema) {
+  const schemaRecord = schema;
+  if ("type" in schemaRecord) {
+    const schemaType = schemaRecord.type;
+    switch (schemaType) {
+      case "string":
+        return "string";
+      case "number":
+        return "number";
+      case "boolean":
+        return "boolean";
+      case "enum":
+        return "enum";
+      case "array":
+        return "array (comma-separated)";
+      case "json":
+        return "json";
+      case "date":
+        return "date (ISO 8601)";
+      case "bigint":
+        return "bigint";
+      default:
+        return "string";
+    }
+  }
+  return "string";
+}
+function extractEnumValues(schema) {
+  const schemaRecord = schema;
+  if (schemaRecord.type === "enum") {
+    const values = schemaRecord.values;
+    if (values !== void 0 && Array.isArray(values)) {
+      return [...values];
+    }
+  }
+  if (schemaRecord.type === "string") {
+    const enumValues = schemaRecord.enum;
+    if (enumValues !== void 0 && Array.isArray(enumValues)) {
+      return [...enumValues];
+    }
+  }
+  return null;
+}
+function isSecretVariable(key, value, schema) {
+  if (schema !== void 0) {
+    const schemaRecord = schema;
+    if (schemaRecord.isSecret === true) {
+      return true;
+    }
+  }
+  if (isSecretKey(key)) {
+    return true;
+  }
+  if (value.length > 0 && isSecretLike(value)) {
+    return true;
+  }
+  return false;
+}
+async function generateExampleFile(envPath, outputPath, options) {
+  const includeDescriptions = options?.includeDescriptions ?? true;
+  const includeTypes = options?.includeTypes ?? true;
+  const includeDefaults = options?.includeDefaults ?? true;
+  const content = await readFile(envPath);
+  const schema = options?.schemaPath !== void 0 ? await loadSchema(options.schemaPath) : void 0;
+  const parsed = parseEnvFile(content, envPath);
+  const generated = generateExampleContent(parsed.vars, schema, {
+    includeDescriptions,
+    includeTypes,
+    includeDefaults
+  });
+  await writeFile(outputPath, generated);
+}
+function generateExampleContent(vars, schema, options) {
+  const includeDescriptions = options?.includeDescriptions ?? true;
+  const includeTypes = options?.includeTypes ?? true;
+  const includeDefaults = options?.includeDefaults ?? true;
+  const lines = [];
+  let order = 0;
+  const emittedKeys = /* @__PURE__ */ new Set();
+  lines.push({ content: HEADER, order: order++ });
+  for (const envVar of vars) {
+    if (emittedKeys.has(envVar.key)) continue;
+    emittedKeys.add(envVar.key);
+    const schemaEntry = schema !== void 0 ? schema[envVar.key] : void 0;
+    const schemaRecord = schemaEntry !== void 0 ? schemaEntry : void 0;
+    const isRequired = schemaEntry === void 0 || schemaEntry.optional !== true;
+    const isSecret = isSecretVariable(envVar.key, envVar.value, schemaEntry);
+    const commentLines = [];
+    if (includeDescriptions && schemaEntry?.description !== void 0) {
+      commentLines.push(`# ${schemaEntry.description}`);
+    }
+    if (includeTypes && schemaEntry !== void 0) {
+      const typeStr = schemaTypeToString(schemaEntry);
+      commentLines.push(`# type: ${typeStr}`);
+      const enumValues = extractEnumValues(schemaEntry);
+      if (enumValues !== null) {
+        commentLines.push(`# values: ${enumValues.join(", ")}`);
+      }
+    }
+    if (isSecret) {
+      commentLines.push("# [SECRET]");
+    }
+    if (includeDescriptions) {
+      if (isRequired && schemaRecord?.default === void 0) {
+        commentLines.push("# required");
+      } else if (schemaRecord?.default !== void 0) {
+        commentLines.push("# optional");
+      } else if (schemaEntry?.optional === true) {
+        commentLines.push("# optional");
+      }
+    }
+    if (includeDefaults) {
+      if (schemaRecord?.default !== void 0) {
+        const defaultDisplay = isSecret ? "[REDACTED]" : String(schemaRecord.default);
+        commentLines.push(`# default: ${defaultDisplay}`);
+      } else if (schemaRecord?.hasDefault === true && typeof schemaRecord.rawDefaultValue === "string") {
+        const defaultDisplay = isSecret ? "[REDACTED]" : schemaRecord.rawDefaultValue;
+        commentLines.push(`# default: ${defaultDisplay}`);
+      }
+    }
+    for (const commentLine of commentLines) {
+      lines.push({ content: commentLine, order: order++ });
+    }
+    const exampleValue = buildExampleValue(envVar.value, isSecret, schemaEntry);
+    lines.push({
+      content: `${envVar.key}=${exampleValue}`,
+      order: order++
+    });
+    lines.push({ content: "", order: order++ });
+  }
+  lines.sort((a, b) => a.order - b.order);
+  return lines.map((line) => line.content).join("\n");
+}
+function buildExampleValue(value, isSecret, schema) {
+  if (isSecret) {
+    return "<your-secret-here>";
+  }
+  if (schema !== void 0) {
+    const enumValues = extractEnumValues(schema);
+    if (enumValues !== null && enumValues.length > 0) {
+      return enumValues[0] ?? "";
+    }
+  }
+  if (value === "") {
+    return "";
+  }
+  if (value.length <= 20 && !isSecretLike(value)) {
+    return maskValue(value, { visibleStart: 0, visibleEnd: 0, minLength: 1 });
+  }
+  return maskValue(value, { visibleStart: 0, visibleEnd: 0, minLength: 1 });
+}
+async function loadSchema(_schemaPath) {
+  void _schemaPath;
+  return void 0;
+}
+async function needsUpdate(envPath, examplePath, options) {
+  const envExists = await exists(envPath);
+  const exampleExists = await exists(examplePath);
+  if (envExists && !exampleExists) {
+    return true;
+  }
+  if (!envExists) {
+    return false;
+  }
+  const content = await readFile(envPath);
+  const schema = options?.schemaPath !== void 0 ? await loadSchema(options.schemaPath) : void 0;
+  const parsed = parseEnvFile(content, envPath);
+  const generated = generateExampleContent(parsed.vars, schema, {
+    includeDescriptions: options?.includeDescriptions ?? true,
+    includeTypes: options?.includeTypes ?? true,
+    includeDefaults: options?.includeDefaults ?? true
+  });
+  const existing = await readFile(examplePath);
+  return generated.trim() !== existing.trim();
+}
+
+export {
+  generateExampleFile,
+  generateExampleContent,
+  needsUpdate
+};