Function resolveComponentEnv

ts/workflow-cli/cli/deploy/components.ts:127–160

(
  dir: string,
  name: string,
  opts: { interactive: boolean },
)

// are taken as-is, empty ones are prompted at a terminal (masked for secrets) or
// left as a stub otherwise. Returns null when the component ships no example.
export async function resolveComponentEnv(
  dir: string,
  name: string,
  opts: { interactive: boolean },
): Promise<string | null> {
  const file = path.join(dir, `${name}.env.example`);
  let raw: string;
  try {
    raw = await fs.readFile(file, "utf-8");
  } catch (err) {
    if ((err as NodeJS.ErrnoException).code === "ENOENT") return null;
    throw err;
  }

  const lines: string[] = [];
  for (const e of parseEnvExample(raw)) {
    if (e.kind === "comment") {
      lines.push(e.text);
    } else if (e.value !== "" || !opts.interactive) {
      lines.push(`${e.key}=${e.value}`);
    } else {
      const value = SECRET_HINT.test(e.key)
        ? await password({ message: `${name}: ${e.key}`, mask: "*" })
        : await input({ message: `${name}: ${e.key}` });
      lines.push(`${e.key}=${value}`);
    }
  }

  const header =
    `# Auto-generated by \`fh-workflow deploy\` from ${name}.env.example.\n` +
    `# Loaded into the ${name} container via compose env_file; chmod 600 if it holds\n` +
    `# secrets, and fill any empty values before \`up\`.\n`;
  return `${header}\n${lines.join("\n")}\n`;
}

// The interactive custom-components section of the wizard. Components supplied via
// --component arrive pre-validated and are shown as already added; a yes/no loop