Function promptCustomComponents

ts/workflow-cli/cli/deploy/components.ts:168–224

(
  preloaded: LoadedComponent[],
)

// Each component's <name>.env is resolved as it is added, so the operator answers
// a component's env right after picking it — never a second batch pass.
export async function promptCustomComponents(
  preloaded: LoadedComponent[],
): Promise<{ components: DeployComponent[]; env: Record<string, string> }> {
  const components: DeployComponent[] = [];
  const env: Record<string, string> = {};
  const seen = new Set<string>();

  // Take in a component: record it, then turn its env.example into env text.
  const add = async (loaded: LoadedComponent): Promise<void> => {
    seen.add(loaded.component.name);
    components.push(loaded.component);
    const text = await resolveComponentEnv(loaded.dir, loaded.component.name, { interactive: true });
    if (text !== null) env[loaded.component.name] = text;
  };

  if (preloaded.length > 0) {
    process.stdout.write(`  Already added: ${preloaded.map((c) => c.component.name).join(", ")}\n`);
  }
  for (const loaded of preloaded) await add(loaded);

  while (
    await confirm({
      message: components.length === 0 ? "Add a custom component?" : "Add another custom component?",
      default: false,
    })
  ) {
    const dir = (
      await input({
        message: "Custom component folder",
        // Full inline validation: path, component.json presence, contract shape,
        // and a name not already taken — the same checks the batch path runs, so
        // a bad folder is rejected here instead of failing late in the build.
        validate: async (v) => {
          const t = v.trim();
          if (!t) return "enter a folder path";
          if (!existsSync(t)) return `folder not found: ${t}`;
          if (!existsSync(path.join(t, "component.json"))) return `no component.json in ${t}`;
          let data: unknown;
          try {
            data = await readComponentJson(t);
          } catch (err) {
            return err instanceof Error ? err.message : String(err);
          }
          const errors = validateComponent(data);
          if (errors.length > 0) return errors.join("; ");
          const name = (data as DeployComponent).name;
          return seen.has(name) ? `"${name}" already added` : true;
        },
      })
    ).trim();

    // The prompt's validator proved the shape; re-read for the typed value.
    await add({ component: (await readComponentJson(dir)) as DeployComponent, dir });
  }

  return { components, env };
}