@cimplify/sdk 0.41.0 → 0.42.0

package/dist/cli/commands/logs.mjs

@@ -0,0 +1,358 @@
+import { promises } from 'fs';
+import os from 'os';
+import path from 'path';
+
+// src/cli/errors.ts
+var CLI_ERROR_CODE = {
+  NOT_LOGGED_IN: "NOT_LOGGED_IN",
+  NOT_LINKED: "NOT_LINKED",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  AUTH_FAILED: "AUTH_FAILED",
+  PROJECT_NOT_FOUND: "PROJECT_NOT_FOUND",
+  INVALID_INPUT: "INVALID_INPUT",
+  ALREADY_LINKED: "ALREADY_LINKED",
+  SERVER_ERROR: "SERVER_ERROR"};
+var EXIT_CODE = {
+  ERROR: 1};
+var CliError = class extends Error {
+  constructor(code, message, exitCode = EXIT_CODE.ERROR) {
+    super(message);
+    this.name = "CliError";
+    this.code = code;
+    this.exitCode = exitCode;
+  }
+};
+
+// src/cli/api-client.ts
+var DEFAULT_API_BASE_URL = "https://api.cimplify.io";
+var ENV_API_BASE_URL = "CIMPLIFY_API_URL";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var HEADER_AUTHORIZATION = "Authorization";
+var HEADER_CONTENT_TYPE = "Content-Type";
+var HEADER_ACCEPT = "Accept";
+var HEADER_USER_AGENT = "User-Agent";
+var BEARER_PREFIX = "Bearer ";
+var CONTENT_TYPE_JSON = "application/json";
+var USER_AGENT = "cimplify-cli";
+var METHOD_GET = "GET";
+var METHOD_POST = "POST";
+var METHOD_PUT = "PUT";
+var METHOD_DELETE = "DELETE";
+var STATUS_UNAUTHORIZED = 401;
+var STATUS_FORBIDDEN = 403;
+var STATUS_NOT_FOUND = 404;
+var STATUS_CONFLICT = 409;
+var STATUS_BAD_REQUEST_MIN = 400;
+var STATUS_SERVER_ERROR_MIN = 500;
+var ApiClient = class _ApiClient {
+  constructor(baseUrl, apiKey) {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.apiKey = apiKey;
+  }
+  static fromAuth(auth) {
+    return new _ApiClient(auth.apiBaseUrl, auth.apiKey);
+  }
+  static unauthenticated(baseUrl = resolveBaseUrl()) {
+    return new _ApiClient(baseUrl, "");
+  }
+  static withKey(apiKey, baseUrl = resolveBaseUrl()) {
+    return new _ApiClient(baseUrl, apiKey);
+  }
+  get(pathname, options) {
+    return this.request(METHOD_GET, pathname, void 0, options);
+  }
+  post(pathname, body, options) {
+    return this.request(METHOD_POST, pathname, body, options);
+  }
+  put(pathname, body, options) {
+    return this.request(METHOD_PUT, pathname, body, options);
+  }
+  delete(pathname, options) {
+    return this.request(METHOD_DELETE, pathname, void 0, options);
+  }
+  async request(method, pathname, body, options) {
+    const url = this.buildUrl(pathname, options?.query);
+    const headers = {
+      [HEADER_ACCEPT]: CONTENT_TYPE_JSON,
+      [HEADER_USER_AGENT]: USER_AGENT
+    };
+    if (this.apiKey) {
+      headers[HEADER_AUTHORIZATION] = `${BEARER_PREFIX}${this.apiKey}`;
+    }
+    let payload;
+    if (body !== void 0) {
+      headers[HEADER_CONTENT_TYPE] = CONTENT_TYPE_JSON;
+      payload = JSON.stringify(body);
+    }
+    const controller = new AbortController();
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+      response = await fetch(url, {
+        method,
+        headers,
+        body: payload,
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      throw toNetworkError(err);
+    }
+    clearTimeout(timer);
+    return parseResponse(response);
+  }
+  buildUrl(pathname, query) {
+    const base = pathname.startsWith("/") ? pathname : `/${pathname}`;
+    const url = new URL(`${this.baseUrl}${base}`);
+    if (query) {
+      for (const [k, v] of Object.entries(query)) {
+        if (v === void 0 || v === null) continue;
+        url.searchParams.set(k, String(v));
+      }
+    }
+    return url.toString();
+  }
+};
+function resolveBaseUrl(override) {
+  const fromEnv = process.env[ENV_API_BASE_URL];
+  return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_API_BASE_URL;
+}
+async function parseResponse(response) {
+  const text = await response.text();
+  let body = void 0;
+  if (text.length > 0) {
+    try {
+      body = JSON.parse(text);
+    } catch {
+      throw new CliError(
+        CLI_ERROR_CODE.SERVER_ERROR,
+        `Server returned non-JSON response (status ${response.status}): ${truncate(text)}`
+      );
+    }
+  }
+  if (response.ok) {
+    if (body && typeof body === "object" && "data" in body) {
+      return body.data;
+    }
+    return body;
+  }
+  const code = mapStatusToCode(response.status);
+  const message = extractErrorMessage(body, response.status);
+  throw new CliError(code, message);
+}
+function mapStatusToCode(status) {
+  if (status === STATUS_UNAUTHORIZED) return CLI_ERROR_CODE.AUTH_FAILED;
+  if (status === STATUS_FORBIDDEN) return CLI_ERROR_CODE.AUTH_FAILED;
+  if (status === STATUS_NOT_FOUND) return CLI_ERROR_CODE.PROJECT_NOT_FOUND;
+  if (status === STATUS_CONFLICT) return CLI_ERROR_CODE.ALREADY_LINKED;
+  if (status >= STATUS_SERVER_ERROR_MIN) return CLI_ERROR_CODE.SERVER_ERROR;
+  if (status >= STATUS_BAD_REQUEST_MIN) return CLI_ERROR_CODE.INVALID_INPUT;
+  return CLI_ERROR_CODE.SERVER_ERROR;
+}
+function extractErrorMessage(body, status) {
+  if (body && typeof body === "object") {
+    const envelope = body;
+    if (envelope.error && typeof envelope.error.error_message === "string") {
+      return envelope.error.error_code ? `${envelope.error.error_code}: ${envelope.error.error_message}` : envelope.error.error_message;
+    }
+    if (typeof envelope.message === "string") return envelope.message;
+  }
+  return `HTTP ${status}`;
+}
+function toNetworkError(err) {
+  if (err instanceof DOMException && err.name === "AbortError") {
+    return new CliError(CLI_ERROR_CODE.NETWORK_ERROR, "Request timed out.");
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  return new CliError(CLI_ERROR_CODE.NETWORK_ERROR, `Network error: ${message}`);
+}
+function truncate(value, max = 200) {
+  return value.length > max ? `${value.slice(0, max)}\u2026` : value;
+}
+
+// src/cli/args.ts
+function parseArgs(argv) {
+  const positional = [];
+  const flags = /* @__PURE__ */ new Map();
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (!arg.startsWith("--")) {
+      positional.push(arg);
+      continue;
+    }
+    const eq = arg.indexOf("=");
+    if (eq !== -1) {
+      flags.set(arg.slice(2, eq), arg.slice(eq + 1));
+      continue;
+    }
+    const name = arg.slice(2);
+    const next = argv[i + 1];
+    if (next !== void 0 && !next.startsWith("--")) {
+      flags.set(name, next);
+      i++;
+    } else {
+      flags.set(name, true);
+    }
+  }
+  return { positional, flags };
+}
+function flagString(args, name) {
+  const v = args.flags.get(name);
+  return typeof v === "string" ? v : void 0;
+}
+function flagBool(args, name) {
+  return args.flags.has(name);
+}
+var AUTH_FILE_NAME = "auth.json";
+var PROJECT_FILE_NAME = "project.json";
+var STATE_FILE_NAME = "state.json";
+var PROJECT_DIR_NAME = ".cimplify";
+var ENV_XDG_CONFIG_HOME = "XDG_CONFIG_HOME";
+var APP_CONFIG_DIR_NAME = "cimplify";
+var HOME_CONFIG_DIR_NAME = ".config";
+var ENCODING_UTF8 = "utf8";
+function authConfigDir() {
+  const xdg = process.env[ENV_XDG_CONFIG_HOME];
+  return xdg ? path.join(xdg, APP_CONFIG_DIR_NAME) : path.join(os.homedir(), HOME_CONFIG_DIR_NAME, APP_CONFIG_DIR_NAME);
+}
+function authConfigPath() {
+  return path.join(authConfigDir(), AUTH_FILE_NAME);
+}
+function projectConfigDir(cwd = process.cwd()) {
+  return path.join(cwd, PROJECT_DIR_NAME);
+}
+function projectConfigPath(cwd = process.cwd()) {
+  return path.join(projectConfigDir(cwd), PROJECT_FILE_NAME);
+}
+function projectStatePath(cwd = process.cwd()) {
+  return path.join(projectConfigDir(cwd), STATE_FILE_NAME);
+}
+async function readJsonFile(filePath) {
+  try {
+    const raw = await promises.readFile(filePath, ENCODING_UTF8);
+    return JSON.parse(raw);
+  } catch (err) {
+    if (err.code === "ENOENT") return null;
+    throw err;
+  }
+}
+async function readAuth() {
+  const data = await readJsonFile(authConfigPath());
+  if (!data) {
+    throw new CliError(
+      CLI_ERROR_CODE.NOT_LOGGED_IN,
+      "Not logged in. Run `cimplify login` first."
+    );
+  }
+  return data;
+}
+async function readProjectLink(cwd = process.cwd()) {
+  const data = await readJsonFile(projectConfigPath(cwd));
+  if (!data) {
+    throw new CliError(
+      CLI_ERROR_CODE.NOT_LINKED,
+      "No project linked. Run `cimplify link <project-id>` first."
+    );
+  }
+  return data;
+}
+async function readProjectState(cwd = process.cwd()) {
+  return readJsonFile(projectStatePath(cwd));
+}
+
+// src/cli/output.ts
+var RESET = "\x1B[0m";
+var RED_OPEN = "\x1B[31m";
+var PREFIX_FAILURE = "\u2717";
+function wrap(open, value) {
+  return `${open}${value}${RESET}`;
+}
+function red(value) {
+  return wrap(RED_OPEN, value);
+}
+function failure(message) {
+  console.error(`${red(PREFIX_FAILURE)} ${message}`);
+}
+
+// src/cli/types.ts
+var DEPLOYMENT_STATUS = {
+  ACTIVE: "active",
+  FAILED: "failed",
+  CANCELLED: "cancelled",
+  SUPERSEDED: "superseded"
+};
+var TERMINAL_DEPLOYMENT_STATUSES = /* @__PURE__ */ new Set([
+  DEPLOYMENT_STATUS.ACTIVE,
+  DEPLOYMENT_STATUS.FAILED,
+  DEPLOYMENT_STATUS.CANCELLED,
+  DEPLOYMENT_STATUS.SUPERSEDED
+]);
+
+// src/cli/commands/logs.ts
+var FLAG_DEPLOYMENT = "deployment";
+var FLAG_FOLLOW = "follow";
+var POLL_INTERVAL_MS = 1e3;
+var POLL_MAX_MS = 60 * 60 * 1e3;
+function progressEndpoint(businessId, projectId, deploymentId) {
+  return `/v1/businesses/${encodeURIComponent(businessId)}/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(deploymentId)}/progress`;
+}
+function nextChunk(cursor, full) {
+  if (!full) return "";
+  if (full.length <= cursor.printed) return "";
+  const chunk = full.slice(cursor.printed);
+  cursor.printed = full.length;
+  return chunk;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function run(argv) {
+  const args = parseArgs(argv);
+  const auth = await readAuth();
+  const link = await readProjectLink();
+  const client = ApiClient.fromAuth(auth);
+  let deploymentId = flagString(args, FLAG_DEPLOYMENT);
+  if (!deploymentId) {
+    const state = await readProjectState();
+    deploymentId = state?.lastDeploymentId;
+  }
+  if (!deploymentId) {
+    throw new CliError(
+      CLI_ERROR_CODE.INVALID_INPUT,
+      "No deployment specified and no recent deployment in state.\nPass --deployment <id> or run `cimplify deploy` first."
+    );
+  }
+  const endpoint = progressEndpoint(link.businessId, link.projectId, deploymentId);
+  const follow = flagBool(args, FLAG_FOLLOW);
+  if (!follow) {
+    const progress = await client.get(endpoint);
+    if (progress.build_logs) process.stdout.write(progress.build_logs);
+    if (progress.error_message) failure(progress.error_message);
+    return;
+  }
+  const cursor = { printed: 0 };
+  const startedAt = Date.now();
+  let lastErrorMessage;
+  while (true) {
+    const progress = await client.get(endpoint);
+    const chunk = nextChunk(cursor, progress.build_logs);
+    if (chunk.length > 0) process.stdout.write(chunk);
+    if (progress.error_message && progress.error_message !== lastErrorMessage) {
+      process.stdout.write(`
+${red(progress.error_message)}
+`);
+      lastErrorMessage = progress.error_message;
+    }
+    if (TERMINAL_DEPLOYMENT_STATUSES.has(progress.status)) return;
+    if (Date.now() - startedAt > POLL_MAX_MS) {
+      throw new CliError(
+        CLI_ERROR_CODE.NETWORK_ERROR,
+        "Logs polling timed out (1 hour). Re-run `cimplify logs --follow` to resume."
+      );
+    }
+    await sleep(POLL_INTERVAL_MS);
+  }
+}
+
+export { run as default, nextChunk };

package/dist/cli/commands/projects.mjs

@@ -0,0 +1,327 @@
+import { promises } from 'fs';
+import os from 'os';
+import path from 'path';
+
+// src/cli/errors.ts
+var CLI_ERROR_CODE = {
+  NOT_LOGGED_IN: "NOT_LOGGED_IN",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  AUTH_FAILED: "AUTH_FAILED",
+  PROJECT_NOT_FOUND: "PROJECT_NOT_FOUND",
+  INVALID_INPUT: "INVALID_INPUT",
+  ALREADY_LINKED: "ALREADY_LINKED",
+  SERVER_ERROR: "SERVER_ERROR"};
+var EXIT_CODE = {
+  ERROR: 1};
+var CliError = class extends Error {
+  constructor(code, message, exitCode = EXIT_CODE.ERROR) {
+    super(message);
+    this.name = "CliError";
+    this.code = code;
+    this.exitCode = exitCode;
+  }
+};
+
+// src/cli/api-client.ts
+var DEFAULT_API_BASE_URL = "https://api.cimplify.io";
+var ENV_API_BASE_URL = "CIMPLIFY_API_URL";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var HEADER_AUTHORIZATION = "Authorization";
+var HEADER_CONTENT_TYPE = "Content-Type";
+var HEADER_ACCEPT = "Accept";
+var HEADER_USER_AGENT = "User-Agent";
+var BEARER_PREFIX = "Bearer ";
+var CONTENT_TYPE_JSON = "application/json";
+var USER_AGENT = "cimplify-cli";
+var METHOD_GET = "GET";
+var METHOD_POST = "POST";
+var METHOD_PUT = "PUT";
+var METHOD_DELETE = "DELETE";
+var STATUS_UNAUTHORIZED = 401;
+var STATUS_FORBIDDEN = 403;
+var STATUS_NOT_FOUND = 404;
+var STATUS_CONFLICT = 409;
+var STATUS_BAD_REQUEST_MIN = 400;
+var STATUS_SERVER_ERROR_MIN = 500;
+var ApiClient = class _ApiClient {
+  constructor(baseUrl, apiKey) {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.apiKey = apiKey;
+  }
+  static fromAuth(auth) {
+    return new _ApiClient(auth.apiBaseUrl, auth.apiKey);
+  }
+  static unauthenticated(baseUrl = resolveBaseUrl()) {
+    return new _ApiClient(baseUrl, "");
+  }
+  static withKey(apiKey, baseUrl = resolveBaseUrl()) {
+    return new _ApiClient(baseUrl, apiKey);
+  }
+  get(pathname, options) {
+    return this.request(METHOD_GET, pathname, void 0, options);
+  }
+  post(pathname, body, options) {
+    return this.request(METHOD_POST, pathname, body, options);
+  }
+  put(pathname, body, options) {
+    return this.request(METHOD_PUT, pathname, body, options);
+  }
+  delete(pathname, options) {
+    return this.request(METHOD_DELETE, pathname, void 0, options);
+  }
+  async request(method, pathname, body, options) {
+    const url = this.buildUrl(pathname, options?.query);
+    const headers = {
+      [HEADER_ACCEPT]: CONTENT_TYPE_JSON,
+      [HEADER_USER_AGENT]: USER_AGENT
+    };
+    if (this.apiKey) {
+      headers[HEADER_AUTHORIZATION] = `${BEARER_PREFIX}${this.apiKey}`;
+    }
+    let payload;
+    if (body !== void 0) {
+      headers[HEADER_CONTENT_TYPE] = CONTENT_TYPE_JSON;
+      payload = JSON.stringify(body);
+    }
+    const controller = new AbortController();
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+      response = await fetch(url, {
+        method,
+        headers,
+        body: payload,
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      throw toNetworkError(err);
+    }
+    clearTimeout(timer);
+    return parseResponse(response);
+  }
+  buildUrl(pathname, query) {
+    const base = pathname.startsWith("/") ? pathname : `/${pathname}`;
+    const url = new URL(`${this.baseUrl}${base}`);
+    if (query) {
+      for (const [k, v] of Object.entries(query)) {
+        if (v === void 0 || v === null) continue;
+        url.searchParams.set(k, String(v));
+      }
+    }
+    return url.toString();
+  }
+};
+function resolveBaseUrl(override) {
+  const fromEnv = process.env[ENV_API_BASE_URL];
+  return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_API_BASE_URL;
+}
+async function parseResponse(response) {
+  const text = await response.text();
+  let body = void 0;
+  if (text.length > 0) {
+    try {
+      body = JSON.parse(text);
+    } catch {
+      throw new CliError(
+        CLI_ERROR_CODE.SERVER_ERROR,
+        `Server returned non-JSON response (status ${response.status}): ${truncate(text)}`
+      );
+    }
+  }
+  if (response.ok) {
+    if (body && typeof body === "object" && "data" in body) {
+      return body.data;
+    }
+    return body;
+  }
+  const code = mapStatusToCode(response.status);
+  const message = extractErrorMessage(body, response.status);
+  throw new CliError(code, message);
+}
+function mapStatusToCode(status) {
+  if (status === STATUS_UNAUTHORIZED) return CLI_ERROR_CODE.AUTH_FAILED;
+  if (status === STATUS_FORBIDDEN) return CLI_ERROR_CODE.AUTH_FAILED;
+  if (status === STATUS_NOT_FOUND) return CLI_ERROR_CODE.PROJECT_NOT_FOUND;
+  if (status === STATUS_CONFLICT) return CLI_ERROR_CODE.ALREADY_LINKED;
+  if (status >= STATUS_SERVER_ERROR_MIN) return CLI_ERROR_CODE.SERVER_ERROR;
+  if (status >= STATUS_BAD_REQUEST_MIN) return CLI_ERROR_CODE.INVALID_INPUT;
+  return CLI_ERROR_CODE.SERVER_ERROR;
+}
+function extractErrorMessage(body, status) {
+  if (body && typeof body === "object") {
+    const envelope = body;
+    if (envelope.error && typeof envelope.error.error_message === "string") {
+      return envelope.error.error_code ? `${envelope.error.error_code}: ${envelope.error.error_message}` : envelope.error.error_message;
+    }
+    if (typeof envelope.message === "string") return envelope.message;
+  }
+  return `HTTP ${status}`;
+}
+function toNetworkError(err) {
+  if (err instanceof DOMException && err.name === "AbortError") {
+    return new CliError(CLI_ERROR_CODE.NETWORK_ERROR, "Request timed out.");
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  return new CliError(CLI_ERROR_CODE.NETWORK_ERROR, `Network error: ${message}`);
+}
+function truncate(value, max = 200) {
+  return value.length > max ? `${value.slice(0, max)}\u2026` : value;
+}
+
+// src/cli/args.ts
+function parseArgs(argv) {
+  const positional = [];
+  const flags = /* @__PURE__ */ new Map();
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (!arg.startsWith("--")) {
+      positional.push(arg);
+      continue;
+    }
+    const eq = arg.indexOf("=");
+    if (eq !== -1) {
+      flags.set(arg.slice(2, eq), arg.slice(eq + 1));
+      continue;
+    }
+    const name = arg.slice(2);
+    const next = argv[i + 1];
+    if (next !== void 0 && !next.startsWith("--")) {
+      flags.set(name, next);
+      i++;
+    } else {
+      flags.set(name, true);
+    }
+  }
+  return { positional, flags };
+}
+var AUTH_FILE_NAME = "auth.json";
+var ENV_XDG_CONFIG_HOME = "XDG_CONFIG_HOME";
+var APP_CONFIG_DIR_NAME = "cimplify";
+var HOME_CONFIG_DIR_NAME = ".config";
+var ENCODING_UTF8 = "utf8";
+function authConfigDir() {
+  const xdg = process.env[ENV_XDG_CONFIG_HOME];
+  return xdg ? path.join(xdg, APP_CONFIG_DIR_NAME) : path.join(os.homedir(), HOME_CONFIG_DIR_NAME, APP_CONFIG_DIR_NAME);
+}
+function authConfigPath() {
+  return path.join(authConfigDir(), AUTH_FILE_NAME);
+}
+async function readJsonFile(filePath) {
+  try {
+    const raw = await promises.readFile(filePath, ENCODING_UTF8);
+    return JSON.parse(raw);
+  } catch (err) {
+    if (err.code === "ENOENT") return null;
+    throw err;
+  }
+}
+async function readAuth() {
+  const data = await readJsonFile(authConfigPath());
+  if (!data) {
+    throw new CliError(
+      CLI_ERROR_CODE.NOT_LOGGED_IN,
+      "Not logged in. Run `cimplify login` first."
+    );
+  }
+  return data;
+}
+
+// src/cli/output.ts
+var RESET = "\x1B[0m";
+var BOLD_OPEN = "\x1B[1m";
+var DIM_OPEN = "\x1B[2m";
+var GREEN_OPEN = "\x1B[32m";
+var PREFIX_SUCCESS = "\u2713";
+function wrap(open, value) {
+  return `${open}${value}${RESET}`;
+}
+function bold(value) {
+  return wrap(BOLD_OPEN, value);
+}
+function dim(value) {
+  return wrap(DIM_OPEN, value);
+}
+function green(value) {
+  return wrap(GREEN_OPEN, value);
+}
+function success(message) {
+  console.log(`${green(PREFIX_SUCCESS)} ${message}`);
+}
+function info(message) {
+  console.log(message);
+}
+
+// src/cli/commands/projects.ts
+var SUB_LS = "ls";
+var SUB_LIST = "list";
+var SUB_CREATE = "create";
+var PROJECT_TYPE_DEFAULT = "nextjs-app";
+var COL_GAP = "  ";
+function projectsEndpoint(businessId) {
+  return `/v1/businesses/${encodeURIComponent(businessId)}/projects`;
+}
+async function run(argv) {
+  const args = parseArgs(argv);
+  const sub = args.positional[0];
+  if (!sub) {
+    throw new CliError(
+      CLI_ERROR_CODE.INVALID_INPUT,
+      `Usage: cimplify projects <${SUB_LS}|${SUB_CREATE}>`
+    );
+  }
+  const auth = await readAuth();
+  const client = ApiClient.fromAuth(auth);
+  if (sub === SUB_LS || sub === SUB_LIST) {
+    await listProjects(client, auth.businessId);
+    return;
+  }
+  if (sub === SUB_CREATE) {
+    const name = args.positional[1];
+    if (!name) {
+      throw new CliError(
+        CLI_ERROR_CODE.INVALID_INPUT,
+        `Usage: cimplify projects ${SUB_CREATE} <name>`
+      );
+    }
+    await createProject(client, auth.businessId, name);
+    return;
+  }
+  throw new CliError(CLI_ERROR_CODE.INVALID_INPUT, `Unknown subcommand "${sub}"`);
+}
+async function listProjects(client, businessId) {
+  const projects = await client.get(projectsEndpoint(businessId));
+  if (projects.length === 0) {
+    info(dim("No projects yet. Create one: `cimplify projects create <name>`"));
+    return;
+  }
+  const idWidth = Math.max(...projects.map((p) => p.id.length));
+  const nameWidth = Math.max(...projects.map((p) => p.name.length));
+  info(
+    bold(
+      [
+        "ID".padEnd(idWidth),
+        "NAME".padEnd(nameWidth),
+        "TYPE"
+      ].join(COL_GAP)
+    )
+  );
+  for (const p of projects) {
+    info(
+      [
+        p.id.padEnd(idWidth),
+        p.name.padEnd(nameWidth),
+        p.project_type ?? ""
+      ].join(COL_GAP)
+    );
+  }
+}
+async function createProject(client, businessId, name) {
+  const body = { name, project_type: PROJECT_TYPE_DEFAULT };
+  const project = await client.post(projectsEndpoint(businessId), body);
+  success(`Created project ${project.name} (${project.id})`);
+  info(dim(`Link it: cimplify link ${project.id}`));
+}
+
+export { run as default };