stack/packages/stack-cli/src/commands/project.ts

import { Command } from "commander";
import { getInternalUser } from "../lib/app.js";
import { resolveLoginConfig, resolveSessionAuth } from "../lib/auth.js";
import { listLocalEmulatorProjects } from "../lib/local-emulator-client.js";
import { createProjectInteractively } from "../lib/create-project.js";
import { CliError } from "../lib/errors.js";

export type ProjectTarget = "cloud" | "dev";

export type ProjectListEntry = {
  id: string,
  displayName: string,
  target: ProjectTarget,
};

export type ProjectListFlags = {
  cloud?: boolean,
  dev?: boolean,
};

// Returns which sources `project list` should query. Mutually exclusive; with
// no flags we hit both. Exported for unit tests.
export function resolveProjectListSources(opts: ProjectListFlags): { cloud: boolean, dev: boolean } {
  if (opts.cloud && opts.dev) {
    throw new CliError("Pass either --cloud or --dev, not both. Omit both flags to list projects from both sources.");
  }
  if (opts.cloud) return { cloud: true, dev: false };
  if (opts.dev) return { cloud: false, dev: true };
  return { cloud: true, dev: true };
}

// Render projects for the human-readable list output. Each line is
// `<id>\t<displayName>\t[cloud|dev]`. No projects → "No projects found." sentinel.
export function formatProjectList(projects: ProjectListEntry[]): string {
  if (projects.length === 0) {
    return "No projects found.";
  }
  return projects.map((p) => `${p.id}\t${p.displayName}\t[${p.target}]`).join("\n");
}

export function registerProjectCommand(program: Command) {
  const project = program
    .command("project")
    .description("Manage projects");

  project
    .command("list")
    .description("List your projects (defaults to both cloud and local emulator)")
    .option("--cloud", "Only list cloud projects")
    .option("--dev", "Only list local emulator (dev) projects")
    .action(async (opts: ProjectListFlags) => {
      const sources = resolveProjectListSources(opts);
      const results: ProjectListEntry[] = [];

      if (sources.cloud) {
        const auth = resolveSessionAuth();
        const user = await getInternalUser(auth);
        const cloudProjects = await user.listOwnedProjects();
        for (const p of cloudProjects) {
          results.push({ id: p.id, displayName: p.displayName, target: "cloud" });
        }
      }

      if (sources.dev) {
        try {
          const devProjects = await listLocalEmulatorProjects();
          for (const p of devProjects) {
            results.push({ id: p.projectId, displayName: p.displayName, target: "dev" });
          }
        } catch (err) {
          // When the user did not explicitly request --dev, treat an unreachable
          // emulator as a soft failure: warn on stderr and keep the cloud
          // results. With --dev (sources.cloud === false) we surface the error.
          if (!sources.cloud) {
            throw err;
          }
          const message = err instanceof Error ? err.message : String(err);
          console.error(`warning: skipping dev projects — local emulator not reachable (${message}). Start it with \`stack emulator start\`.`);
        }
      }

      if (program.opts().json) {
        console.log(JSON.stringify(results, null, 2));
      } else {
        console.log(formatProjectList(results));
      }
    });

  project
    .command("create")
    .description("Create a new cloud project")
    .option("--cloud", "Confirm that this creates a cloud (not local emulator) project")
    .option("--display-name <name>", "Project display name")
    .action(async (opts) => {
      if (!opts.cloud) {
        throw new CliError("stack project create currently only creates cloud projects. Pass --cloud to confirm.");
      }
      const auth = resolveSessionAuth();
      const user = await getInternalUser(auth);
      const { dashboardUrl } = resolveLoginConfig();

      const newProject = await createProjectInteractively(user, {
        displayName: opts.displayName,
        dashboardUrl,
      });

      if (program.opts().json) {
        console.log(JSON.stringify({ id: newProject.id, displayName: newProject.displayName, target: "cloud" }, null, 2));
      } else {
        console.log(`Project created: ${newProject.id} (${newProject.displayName})`);
      }
    });
}