@letterapp/cli 0.1.0 → 0.2.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/output.ts","../src/config.ts","../src/client.ts","../src/browser.ts","../src/env-file.ts","../src/pm.ts","../src/commands/login.ts","../src/commands/auth.ts","../src/commands/status.ts","../src/commands/config.ts"],"sourcesContent":["declare const PKG_VERSION: string;\nimport { Command } from \"commander\";\nimport { setJsonMode } from \"./output.js\";\nimport { registerLoginCommand } from \"./commands/login.js\";\nimport { registerAuthCommands } from \"./commands/auth.js\";\nimport { registerStatusCommand } from \"./commands/status.js\";\nimport { registerConfigCommands } from \"./commands/config.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"letter\")\n  .description(\"Connect your app to Letter, then manage it from the command line\")\n  .version(PKG_VERSION)\n  .option(\"--json\", \"Output raw JSON (for scripting / agents)\")\n  .hook(\"preAction\", (thisCommand) => {\n    if (thisCommand.opts().json) setJsonMode(true);\n  });\n\n// v1 ships the secure setup/login flow plus connection helpers. The command\n// structure is the extension point: future authenticated areas (sequences,\n// broadcast, contacts, events, keys) register the same way and reuse the\n// credential store in config.ts + the client in client.ts. See README roadmap.\nregisterLoginCommand(program); // default command (`letter` == `letter login`)\nregisterAuthCommands(program);\nregisterStatusCommand(program);\nregisterConfigCommands(program);\n\nprogram.parseAsync();\n","import chalk from \"chalk\";\nimport ora, { type Ora } from \"ora\";\nimport { createInterface } from \"node:readline\";\n\nlet jsonMode = false;\n\nexport function setJsonMode(enabled: boolean) {\n  jsonMode = enabled;\n}\nexport function isJsonMode() {\n  return jsonMode;\n}\n\nexport function printJson(data: unknown) {\n  console.log(JSON.stringify(data, null, 2));\n}\n\nexport function log(msg = \"\") {\n  if (jsonMode) return;\n  console.log(msg);\n}\n\nexport function printSuccess(msg: string) {\n  if (jsonMode) return;\n  console.log(chalk.green(\"✓\") + \" \" + msg);\n}\n\nexport function printInfo(msg: string) {\n  if (jsonMode) return;\n  console.log(chalk.cyan(\"›\") + \" \" + msg);\n}\n\nexport function printWarning(msg: string) {\n  if (jsonMode) return;\n  console.log(chalk.yellow(\"!\") + \" \" + msg);\n}\n\nexport function printError(err: unknown) {\n  const msg = err instanceof Error ? err.message : String(err);\n  if (jsonMode) {\n    printJson({ error: msg });\n    return;\n  }\n  console.error(chalk.red(\"✗\") + \" \" + msg);\n}\n\n/** The Letter wordmark banner. Suppressed in JSON mode. */\nexport function banner() {\n  if (jsonMode) return;\n  console.log(\"\");\n  console.log(\"  \" + chalk.bold(\"Letter\") + chalk.red(\".\") + \" \" + chalk.dim(\"CLI\"));\n  console.log(\"\");\n}\n\nexport function spinner(text: string): Ora {\n  return ora({ text, color: \"cyan\", isEnabled: !jsonMode });\n}\n\n/**\n * Prompts the user and resolves with their input. Returns \"\" immediately on a\n * non-interactive stdin so automated/agent runs don't hang.\n */\nexport function prompt(question: string): Promise<string> {\n  if (!process.stdin.isTTY) return Promise.resolve(\"\");\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  return new Promise((resolve) => {\n    rl.question(question, (answer) => {\n      rl.close();\n      resolve(answer.trim());\n    });\n  });\n}\n\nexport const c = chalk;\n","import Conf from \"conf\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { mkdir, readFile, writeFile, rm } from \"node:fs/promises\";\n\n/** The SDK / API default. When the resolved base equals this we don't bother\n * writing LETTER_BASE_URL into the project env. */\nexport const DEFAULT_BASE_URL = \"https://api.letter.app\";\n\n/* -------------------------------------------------------------------------- */\n/* Non-secret CLI preferences (base URL).                                      */\n/* Stored with `conf`, mirroring how the SDK/MCP resolve their endpoint.       */\n/* -------------------------------------------------------------------------- */\n\nconst config = new Conf({\n  projectName: \"letterapp-cli\",\n  schema: {\n    baseUrl: { type: \"string\", default: DEFAULT_BASE_URL },\n  },\n});\n\n/** Resolve the API base: explicit flag > env > stored config > prod default. */\nexport function getBaseUrl(flag?: string): string {\n  const raw =\n    flag ||\n    process.env.LETTER_BASE_URL ||\n    (config.get(\"baseUrl\") as string) ||\n    DEFAULT_BASE_URL;\n  return raw.replace(/\\/$/, \"\");\n}\n\nexport function setBaseUrl(url: string): void {\n  config.set(\"baseUrl\", url.replace(/\\/$/, \"\"));\n}\n\nexport function getConfigPath(): string {\n  return config.path;\n}\n\nexport function resetConfig(): void {\n  config.clear();\n}\n\n/* -------------------------------------------------------------------------- */\n/* Secret credential store (~/.letter/credentials.json).                       */\n/* Written here, read by @letterapp/mcp so the secret never lands in an MCP    */\n/* config. Kept separate from `conf` and locked to owner-only permissions.     */\n/* -------------------------------------------------------------------------- */\n\nexport type StoredCredential = {\n  apiKey: string;\n  baseUrl: string;\n  project: { slug: string; name: string };\n  savedAt: string;\n};\n\nexport function credentialsPath(): string {\n  return path.join(homedir(), \".letter\", \"credentials.json\");\n}\n\nexport async function saveCredential(cred: StoredCredential): Promise<string> {\n  const file = credentialsPath();\n  await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });\n  await writeFile(file, `${JSON.stringify(cred, null, 2)}\\n`, { mode: 0o600 });\n  return file;\n}\n\nexport async function readCredential(): Promise<StoredCredential | null> {\n  try {\n    const raw = await readFile(credentialsPath(), \"utf8\");\n    return JSON.parse(raw) as StoredCredential;\n  } catch {\n    return null;\n  }\n}\n\nexport async function clearCredential(): Promise<void> {\n  await rm(credentialsPath(), { force: true });\n}\n","import { getBaseUrl, readCredential } from \"./config.js\";\n\nconst USER_AGENT = \"@letterapp/cli\";\n\n/* -------------------------------------------------------------------------- */\n/* Device authorization (RFC 8628 style). No secret ever passes through argv.  */\n/* -------------------------------------------------------------------------- */\n\nexport type StartResponse = {\n  device_code: string;\n  user_code: string;\n  verification_uri: string;\n  verification_uri_complete: string;\n  interval: number;\n  expires_in: number;\n};\n\nexport type PollResponse =\n  | { status: \"authorization_pending\" }\n  | { status: \"slow_down\"; retryAfter?: number }\n  | { status: \"access_denied\" }\n  | { status: \"expired_token\" }\n  | {\n      status: \"approved\";\n      api_key: string;\n      base_url: string;\n      project: { slug: string; name: string };\n    };\n\n/** Starts a device-authorization flow against the given API base. */\nexport async function startDeviceAuth(base: string): Promise<StartResponse> {\n  const res = await fetch(`${base}/v1/cli/auth/start`, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\", \"user-agent\": USER_AGENT },\n    body: \"{}\",\n  });\n  if (!res.ok) {\n    throw new Error(\n      `Could not start login (HTTP ${res.status}). Is ${base} reachable?`,\n    );\n  }\n  return (await res.json()) as StartResponse;\n}\n\n/** Polls once for approval. */\nexport async function pollDeviceAuth(\n  base: string,\n  deviceCode: string,\n): Promise<PollResponse> {\n  const res = await fetch(`${base}/v1/cli/auth/poll`, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\", \"user-agent\": USER_AGENT },\n    body: JSON.stringify({ device_code: deviceCode }),\n  });\n\n  if (res.status === 429) {\n    const retryAfter = Number(res.headers.get(\"retry-after\") ?? \"5\");\n    return { status: \"slow_down\", retryAfter };\n  }\n  if (!res.ok) {\n    throw new Error(`Login poll failed (HTTP ${res.status}).`);\n  }\n  return (await res.json()) as PollResponse;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Authenticated client. Resolves the key from the stored credential (written  */\n/* by `letter login`) or LETTER_API_KEY. Used by data commands like `status`.  */\n/* -------------------------------------------------------------------------- */\n\nexport interface ApiResponse<T = unknown> {\n  status: number;\n  data: T;\n}\n\nclass LetterClient {\n  private maxRetries = 3;\n\n  private async resolveAuth(): Promise<{ base: string; token: string }> {\n    const cred = await readCredential();\n    const token = process.env.LETTER_API_KEY || cred?.apiKey || \"\";\n    if (!token) {\n      throw new Error(\n        \"Not connected. Run `letter login` (or set LETTER_API_KEY) first.\",\n      );\n    }\n    const base = getBaseUrl(process.env.LETTER_API_KEY ? undefined : cred?.baseUrl);\n    return { base, token };\n  }\n\n  private async request<T = unknown>(\n    method: string,\n    path: string,\n    attempt = 1,\n  ): Promise<ApiResponse<T>> {\n    const { base, token } = await this.resolveAuth();\n    const res = await fetch(`${base}${path}`, {\n      method,\n      headers: {\n        authorization: `Bearer ${token}`,\n        accept: \"application/json\",\n        \"user-agent\": USER_AGENT,\n      },\n    });\n\n    if (res.status === 429 && attempt <= this.maxRetries) {\n      const retryAfter = Number(res.headers.get(\"retry-after\") || 2);\n      await new Promise((r) => setTimeout(r, retryAfter * 1000 * attempt));\n      return this.request<T>(method, path, attempt + 1);\n    }\n\n    const data = (res.status === 204 ? {} : await res.json()) as T;\n    if (!res.ok) {\n      const msg =\n        (data as { error?: { message?: string } })?.error?.message ||\n        `HTTP ${res.status}`;\n      const err = new Error(msg) as Error & { status: number };\n      err.status = res.status;\n      throw err;\n    }\n    return { status: res.status, data };\n  }\n\n  get<T = unknown>(path: string) {\n    return this.request<T>(\"GET\", path);\n  }\n}\n\nexport const client = new LetterClient();\n","import { spawn } from \"node:child_process\";\n\n/**\n * Opens `url` in the default browser. Best-effort and non-blocking: if it fails\n * (headless box, no DISPLAY) the caller has already printed the URL so the user\n * can open it manually. Returns true if a launcher was spawned.\n */\nexport function openUrl(url: string): boolean {\n  const platform = process.platform;\n  let command: string;\n  let args: string[];\n\n  if (platform === \"darwin\") {\n    command = \"open\";\n    args = [url];\n  } else if (platform === \"win32\") {\n    command = \"cmd\";\n    // `start` needs an empty title arg; the comma-free form avoids quoting woes.\n    args = [\"/c\", \"start\", \"\", url];\n  } else {\n    command = \"xdg-open\";\n    args = [url];\n  }\n\n  try {\n    const child = spawn(command, args, { stdio: \"ignore\", detached: true });\n    child.on(\"error\", () => {});\n    child.unref();\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import path from \"node:path\";\nimport { readFile, writeFile, stat } from \"node:fs/promises\";\n\n/**\n * Upserts `key=value` in an env file, creating it if needed. Existing keys are\n * replaced in place; new keys are appended. Returns the file path. The value is\n * never logged by this module - callers print only the key name.\n */\nexport async function upsertEnv(\n  cwd: string,\n  file: string,\n  entries: Record<string, string>,\n): Promise<string> {\n  const filePath = path.join(cwd, file);\n  let contents = \"\";\n  try {\n    contents = await readFile(filePath, \"utf8\");\n  } catch {\n    contents = \"\";\n  }\n\n  let next = contents;\n  for (const [key, value] of Object.entries(entries)) {\n    const line = `${key}=${value}`;\n    const re = new RegExp(`^${escapeRegExp(key)}=.*$`, \"m\");\n    if (re.test(next)) {\n      next = next.replace(re, line);\n    } else {\n      if (next.length && !next.endsWith(\"\\n\")) next += \"\\n\";\n      next += `${line}\\n`;\n    }\n  }\n\n  await writeFile(filePath, next, \"utf8\");\n  return filePath;\n}\n\n/** True if a file exists at `cwd/name`. */\nexport async function fileExists(cwd: string, name: string): Promise<boolean> {\n  try {\n    await stat(path.join(cwd, name));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n","import { spawn } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { fileExists } from \"./env-file.js\";\n\nexport type PackageManager = \"pnpm\" | \"yarn\" | \"bun\" | \"npm\";\n\n/**\n * Detects the package manager from lockfiles (then the `npm_config_user_agent`\n * of the running process), defaulting to npm.\n */\nexport async function detectPackageManager(\n  cwd: string,\n): Promise<PackageManager> {\n  if (await fileExists(cwd, \"pnpm-lock.yaml\")) return \"pnpm\";\n  if (await fileExists(cwd, \"yarn.lock\")) return \"yarn\";\n  if (await fileExists(cwd, \"bun.lockb\")) return \"bun\";\n  if (await fileExists(cwd, \"package-lock.json\")) return \"npm\";\n\n  const ua = process.env.npm_config_user_agent ?? \"\";\n  if (ua.startsWith(\"pnpm\")) return \"pnpm\";\n  if (ua.startsWith(\"yarn\")) return \"yarn\";\n  if (ua.startsWith(\"bun\")) return \"bun\";\n  return \"npm\";\n}\n\n/** Detects a likely web framework for friendlier guidance. */\nexport async function detectFramework(cwd: string): Promise<string | null> {\n  try {\n    const pkg = JSON.parse(await readFile(`${cwd}/package.json`, \"utf8\")) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n    const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n    if (deps.next) return \"Next.js\";\n    if (deps.nuxt) return \"Nuxt\";\n    if (deps[\"@remix-run/node\"] || deps[\"@remix-run/react\"]) return \"Remix\";\n    if (deps.express) return \"Express\";\n    if (deps.fastify) return \"Fastify\";\n    if (deps.hono) return \"Hono\";\n    if (deps[\"@sveltejs/kit\"]) return \"SvelteKit\";\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nexport function installCommand(pm: PackageManager, pkg: string): string {\n  switch (pm) {\n    case \"pnpm\":\n      return `pnpm add ${pkg}`;\n    case \"yarn\":\n      return `yarn add ${pkg}`;\n    case \"bun\":\n      return `bun add ${pkg}`;\n    default:\n      return `npm install ${pkg}`;\n  }\n}\n\n/** Runs the install command, streaming output. Resolves to the exit code. */\nexport function runInstall(\n  pm: PackageManager,\n  pkg: string,\n  cwd: string,\n): Promise<number> {\n  const args = pm === \"npm\" ? [\"install\", pkg] : [\"add\", pkg];\n  return new Promise((resolve) => {\n    const child = spawn(pm, args, {\n      cwd,\n      stdio: \"inherit\",\n      shell: process.platform === \"win32\",\n    });\n    child.on(\"error\", () => resolve(1));\n    child.on(\"close\", (code) => resolve(code ?? 1));\n  });\n}\n","import { Command } from \"commander\";\nimport {\n  getBaseUrl,\n  DEFAULT_BASE_URL,\n  saveCredential,\n} from \"../config.js\";\nimport { startDeviceAuth, pollDeviceAuth } from \"../client.js\";\nimport { openUrl } from \"../browser.js\";\nimport { upsertEnv } from \"../env-file.js\";\nimport {\n  detectFramework,\n  detectPackageManager,\n  installCommand,\n  runInstall,\n} from \"../pm.js\";\nimport {\n  banner,\n  c,\n  log,\n  printError,\n  printInfo,\n  printSuccess,\n  printWarning,\n  prompt,\n} from \"../output.js\";\n\nconst SDK_PACKAGE = \"@letterapp/node\";\nconst ENV_FILE = \".env.local\";\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\ninterface LoginOptions {\n  open: boolean;\n  install: boolean;\n  yes?: boolean;\n  baseUrl?: string;\n  apiKey?: string;\n}\n\nexport function registerLoginCommand(program: Command) {\n  program\n    .command(\"login\", { isDefault: true })\n    .alias(\"init\")\n    .description(\"Connect this project to Letter (interactive device login)\")\n    .option(\"--no-open\", \"Don't open the browser; print the URL to open manually\")\n    .option(\"-y, --yes\", \"Non-interactive: don't wait for Enter (agents/CI)\")\n    .option(\"--no-install\", \"Skip installing the SDK\")\n    .option(\"--base-url <url>\", \"Target a self-hosted or local Letter instance\")\n    .option(\n      \"--api-key <key>\",\n      \"CI only: write a key without the device flow (never use in chat)\",\n    )\n    .action(async (opts: LoginOptions) => {\n      const code = await runLogin(opts);\n      if (code !== 0) process.exitCode = code;\n    });\n}\n\nasync function runLogin(opts: LoginOptions): Promise<number> {\n  const base = getBaseUrl(opts.baseUrl);\n  const cwd = process.cwd();\n  const interactive = process.stdin.isTTY && !opts.yes;\n\n  banner();\n\n  // CI escape hatch: write the provided key non-interactively. Documented as\n  // automation-only; interactive/agent use should rely on the device flow so\n  // no secret passes through the command line or chat.\n  if (opts.apiKey) {\n    const entries: Record<string, string> = { LETTER_API_KEY: opts.apiKey };\n    if (base !== DEFAULT_BASE_URL) entries.LETTER_BASE_URL = base;\n    const file = await upsertEnv(cwd, ENV_FILE, entries);\n    printSuccess(`Saved LETTER_API_KEY to ${rel(cwd, file)} (--api-key).`);\n    printWarning(\"--api-key is for CI. For interactive setup, run `letter login`.\");\n    return 0;\n  }\n\n  // 1. Begin the flow.\n  let flow;\n  try {\n    flow = await startDeviceAuth(base);\n  } catch (err) {\n    printError(err);\n    return 1;\n  }\n\n  log(c.bold(\"Confirm this code in your browser:\"));\n  log();\n  log(\"    \" + c.cyan(c.bold(flow.user_code)));\n  log();\n\n  // 2. Open the browser (interactive: wait for Enter; otherwise auto/print).\n  if (interactive && opts.open) {\n    await prompt(c.dim(\"Press Enter to open your browser… \"));\n  }\n  if (opts.open) openUrl(flow.verification_uri_complete);\n  printInfo(\"If your browser didn't open, visit:\");\n  log(\"    \" + c.blue(flow.verification_uri_complete));\n  log();\n  printInfo(\"Waiting for you to approve… (Ctrl+C to cancel)\");\n\n  // 3. Poll until the user approves/denies or the code expires.\n  const deadline = Date.now() + flow.expires_in * 1000;\n  let intervalMs = Math.max(1, flow.interval) * 1000;\n\n  while (Date.now() < deadline) {\n    await sleep(intervalMs);\n    let res;\n    try {\n      res = await pollDeviceAuth(base, flow.device_code);\n    } catch (err) {\n      printError(err);\n      return 1;\n    }\n\n    if (res.status === \"authorization_pending\") continue;\n    if (res.status === \"slow_down\") {\n      intervalMs += 1000;\n      continue;\n    }\n    if (res.status === \"access_denied\") {\n      printError(new Error(\"Request denied in the browser. Nothing was changed.\"));\n      return 1;\n    }\n    if (res.status === \"expired_token\") {\n      printError(new Error(\"This login expired. Run the command again to retry.\"));\n      return 1;\n    }\n\n    return finish(res.api_key, res.base_url, res.project, cwd, opts.install);\n  }\n\n  printError(new Error(\"Timed out waiting for approval. Run the command again.\"));\n  return 1;\n}\n\nasync function finish(\n  apiKey: string,\n  baseUrl: string,\n  project: { slug: string; name: string },\n  cwd: string,\n  doInstall: boolean,\n): Promise<number> {\n  log();\n  printSuccess(`Approved for project ${c.bold(project.name)}.`);\n\n  // Write the key to the project env (value never printed) + shared store.\n  const entries: Record<string, string> = { LETTER_API_KEY: apiKey };\n  if (baseUrl && baseUrl !== DEFAULT_BASE_URL) entries.LETTER_BASE_URL = baseUrl;\n  const envFile = await upsertEnv(cwd, ENV_FILE, entries);\n  printSuccess(`Saved LETTER_API_KEY to ${rel(cwd, envFile)}.`);\n\n  try {\n    const credFile = await saveCredential({\n      apiKey,\n      baseUrl: baseUrl || DEFAULT_BASE_URL,\n      project,\n      savedAt: new Date().toISOString(),\n    });\n    printSuccess(`Stored credentials in ${tildify(credFile)} for tooling (MCP).`);\n  } catch {\n    printWarning(\"Could not write ~/.letter/credentials.json (continuing).\");\n  }\n\n  // Install the SDK.\n  const pm = await detectPackageManager(cwd);\n  if (doInstall) {\n    printInfo(`Installing ${SDK_PACKAGE} with ${pm}…`);\n    const code = await runInstall(pm, SDK_PACKAGE, cwd);\n    if (code === 0) printSuccess(`Installed ${SDK_PACKAGE}.`);\n    else printWarning(`Install failed. Run: ${installCommand(pm, SDK_PACKAGE)}`);\n  } else {\n    printInfo(`Skipped install. Run: ${installCommand(pm, SDK_PACKAGE)}`);\n  }\n\n  printNextSteps(await detectFramework(cwd));\n  return 0;\n}\n\nfunction printNextSteps(framework: string | null): void {\n  log();\n  log(c.bold(\"Next steps\"));\n  if (framework) log(c.dim(`Detected ${framework}.`));\n  log(`  1. Create a server-side client that reads ${c.cyan(\"process.env.LETTER_API_KEY\")}.`);\n  log(`  2. Call ${c.cyan(\"letter.identify(...)\")} where users sign up or log in.`);\n  log(`  3. Call ${c.cyan(\"letter.track(...)\")} on 2-3 key actions.`);\n  log();\n  log(c.dim(\"Check it landed: \") + c.bold(\"letter status\"));\n  log(c.dim(\"Your API key is in .env.local - keep it out of source control.\"));\n  log();\n}\n\nfunction rel(cwd: string, file: string): string {\n  return file.startsWith(cwd) ? file.slice(cwd.length + 1) || file : file;\n}\n\nfunction tildify(file: string): string {\n  const home = process.env.HOME || process.env.USERPROFILE;\n  return home && file.startsWith(home) ? `~${file.slice(home.length)}` : file;\n}\n","import { Command } from \"commander\";\nimport { readCredential, clearCredential } from \"../config.js\";\nimport { c, isJsonMode, printJson, printInfo, printSuccess } from \"../output.js\";\n\nfunction mask(key: string): string {\n  return key.length > 12 ? key.slice(0, 8) + \"…\" + key.slice(-4) : \"set\";\n}\n\nexport function registerAuthCommands(program: Command) {\n  const auth = program.command(\"auth\").description(\"Manage the stored Letter connection\");\n\n  auth\n    .command(\"status\")\n    .description(\"Show whether this machine is connected to Letter\")\n    .action(async () => {\n      const cred = await readCredential();\n      const envKey = process.env.LETTER_API_KEY;\n\n      if (!cred && !envKey) {\n        if (isJsonMode()) printJson({ connected: false });\n        else printInfo(\"Not connected. Run \" + c.bold(\"letter login\") + \" to set up.\");\n        return;\n      }\n\n      if (isJsonMode()) {\n        printJson({\n          connected: true,\n          source: envKey ? \"env\" : \"credentials\",\n          project: cred?.project ?? null,\n          base_url: cred?.baseUrl ?? null,\n          key: envKey ? \"env\" : cred ? mask(cred.apiKey) : null,\n        });\n        return;\n      }\n\n      printSuccess(\"Connected\" + (cred ? ` to ${c.bold(cred.project.name)}` : \"\"));\n      if (cred) {\n        console.log(c.dim(\"  Project: \") + cred.project.slug);\n        console.log(c.dim(\"  Key:     \") + mask(cred.apiKey));\n        console.log(c.dim(\"  API:     \") + cred.baseUrl);\n      }\n      if (envKey) console.log(c.dim(\"  LETTER_API_KEY is set in the environment.\"));\n    });\n\n  auth\n    .command(\"logout\")\n    .description(\"Remove the stored credential (~/.letter/credentials.json)\")\n    .action(async () => {\n      await clearCredential();\n      printSuccess(\"Removed stored credential.\");\n    });\n}\n","import { Command } from \"commander\";\nimport { client } from \"../client.js\";\nimport { readCredential } from \"../config.js\";\nimport { c, isJsonMode, printError, printInfo, printJson, printSuccess, spinner } from \"../output.js\";\n\ntype StatusResponse = {\n  contacts?: number;\n  events?: number;\n  [k: string]: unknown;\n};\n\nexport function registerStatusCommand(program: Command) {\n  program\n    .command(\"status\")\n    .description(\"Check whether your project has received any contacts or events\")\n    .action(async () => {\n      const spin = spinner(\"Checking your Letter project…\").start();\n      try {\n        const { data } = await client.get<StatusResponse>(\"/v1/status\");\n        spin.stop();\n\n        if (isJsonMode()) {\n          printJson(data);\n          return;\n        }\n\n        const cred = await readCredential();\n        const contacts = data.contacts ?? 0;\n        const events = data.events ?? 0;\n\n        if (cred) printInfo(`Project ${c.bold(cred.project.name)}`);\n        if (contacts > 0 || events > 0) {\n          printSuccess(`Connected. ${contacts} contact(s), ${events} event(s) received.`);\n        } else {\n          printInfo(\"Connected, but no data yet. Fire your first identify/track call.\");\n        }\n      } catch (err) {\n        spin.stop();\n        printError(err);\n        process.exitCode = 1;\n      }\n    });\n}\n","import { Command } from \"commander\";\nimport {\n  getBaseUrl,\n  setBaseUrl,\n  getConfigPath,\n  resetConfig,\n} from \"../config.js\";\nimport { c, isJsonMode, printError, printJson, printSuccess } from \"../output.js\";\n\nexport function registerConfigCommands(program: Command) {\n  const cfg = program.command(\"config\").description(\"Manage CLI configuration\");\n\n  cfg\n    .command(\"set\")\n    .description(\"Set a config value\")\n    .argument(\"<key>\", \"Config key: base-url\")\n    .argument(\"<value>\", \"Value to set\")\n    .action((key: string, value: string) => {\n      switch (key) {\n        case \"base-url\":\n          setBaseUrl(value);\n          printSuccess(`Base URL set to ${getBaseUrl()}`);\n          break;\n        default:\n          printError(new Error(`Unknown config key: ${key}. Valid keys: base-url`));\n          process.exitCode = 1;\n      }\n    });\n\n  cfg\n    .command(\"get\")\n    .description(\"Show CLI configuration\")\n    .argument(\"[key]\", \"Config key (omit to show all)\")\n    .action((key?: string) => {\n      const all = { base_url: getBaseUrl(), config_path: getConfigPath() };\n      if (key && key !== \"base-url\" && key !== \"path\") {\n        printError(new Error(`Unknown config key: ${key}`));\n        process.exitCode = 1;\n        return;\n      }\n      if (isJsonMode()) {\n        printJson(key === \"base-url\" ? { base_url: all.base_url } : key === \"path\" ? { config_path: all.config_path } : all);\n        return;\n      }\n      if (key === \"base-url\") console.log(all.base_url);\n      else if (key === \"path\") console.log(all.config_path);\n      else for (const [k, v] of Object.entries(all)) console.log(c.bold(k + \":\") + \" \" + v);\n    });\n\n  cfg\n    .command(\"reset\")\n    .description(\"Reset CLI configuration to defaults\")\n    .action(() => {\n      resetConfig();\n      printSuccess(\"Configuration reset.\");\n    });\n}\n"],"mappings":";;;AACA,SAAS,eAAe;;;ACDxB,OAAO,WAAW;AAClB,OAAO,SAAuB;AAC9B,SAAS,uBAAuB;AAEhC,IAAI,WAAW;AAER,SAAS,YAAY,SAAkB;AAC5C,aAAW;AACb;AACO,SAAS,aAAa;AAC3B,SAAO;AACT;AAEO,SAAS,UAAU,MAAe;AACvC,UAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAC3C;AAEO,SAAS,IAAI,MAAM,IAAI;AAC5B,MAAI,SAAU;AACd,UAAQ,IAAI,GAAG;AACjB;AAEO,SAAS,aAAa,KAAa;AACxC,MAAI,SAAU;AACd,UAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,MAAM,GAAG;AAC1C;AAEO,SAAS,UAAU,KAAa;AACrC,MAAI,SAAU;AACd,UAAQ,IAAI,MAAM,KAAK,QAAG,IAAI,MAAM,GAAG;AACzC;AAEO,SAAS,aAAa,KAAa;AACxC,MAAI,SAAU;AACd,UAAQ,IAAI,MAAM,OAAO,GAAG,IAAI,MAAM,GAAG;AAC3C;AAEO,SAAS,WAAW,KAAc;AACvC,QAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,MAAI,UAAU;AACZ,cAAU,EAAE,OAAO,IAAI,CAAC;AACxB;AAAA,EACF;AACA,UAAQ,MAAM,MAAM,IAAI,QAAG,IAAI,MAAM,GAAG;AAC1C;AAGO,SAAS,SAAS;AACvB,MAAI,SAAU;AACd,UAAQ,IAAI,EAAE;AACd,UAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,MAAM,IAAI,KAAK,CAAC;AACjF,UAAQ,IAAI,EAAE;AAChB;AAEO,SAAS,QAAQ,MAAmB;AACzC,SAAO,IAAI,EAAE,MAAM,OAAO,QAAQ,WAAW,CAAC,SAAS,CAAC;AAC1D;AAMO,SAAS,OAAO,UAAmC;AACxD,MAAI,CAAC,QAAQ,MAAM,MAAO,QAAO,QAAQ,QAAQ,EAAE;AACnD,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,OAAG,SAAS,UAAU,CAAC,WAAW;AAChC,SAAG,MAAM;AACT,cAAQ,OAAO,KAAK,CAAC;AAAA,IACvB,CAAC;AAAA,EACH,CAAC;AACH;AAEO,IAAM,IAAI;;;ACzEjB,OAAO,UAAU;AACjB,SAAS,eAAe;AACxB,OAAO,UAAU;AACjB,SAAS,OAAO,UAAU,WAAW,UAAU;AAIxC,IAAM,mBAAmB;AAOhC,IAAM,SAAS,IAAI,KAAK;AAAA,EACtB,aAAa;AAAA,EACb,QAAQ;AAAA,IACN,SAAS,EAAE,MAAM,UAAU,SAAS,iBAAiB;AAAA,EACvD;AACF,CAAC;AAGM,SAAS,WAAW,MAAuB;AAChD,QAAM,MACJ,QACA,QAAQ,IAAI,mBACX,OAAO,IAAI,SAAS,KACrB;AACF,SAAO,IAAI,QAAQ,OAAO,EAAE;AAC9B;AAEO,SAAS,WAAW,KAAmB;AAC5C,SAAO,IAAI,WAAW,IAAI,QAAQ,OAAO,EAAE,CAAC;AAC9C;AAEO,SAAS,gBAAwB;AACtC,SAAO,OAAO;AAChB;AAEO,SAAS,cAAoB;AAClC,SAAO,MAAM;AACf;AAeO,SAAS,kBAA0B;AACxC,SAAO,KAAK,KAAK,QAAQ,GAAG,WAAW,kBAAkB;AAC3D;AAEA,eAAsB,eAAe,MAAyC;AAC5E,QAAM,OAAO,gBAAgB;AAC7B,QAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,MAAM,MAAM,IAAM,CAAC;AAChE,QAAM,UAAU,MAAM,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,GAAM,EAAE,MAAM,IAAM,CAAC;AAC3E,SAAO;AACT;AAEA,eAAsB,iBAAmD;AACvE,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,gBAAgB,GAAG,MAAM;AACpD,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,kBAAiC;AACrD,QAAM,GAAG,gBAAgB,GAAG,EAAE,OAAO,KAAK,CAAC;AAC7C;;;AC5EA,IAAM,aAAa;AA4BnB,eAAsB,gBAAgB,MAAsC;AAC1E,QAAM,MAAM,MAAM,MAAM,GAAG,IAAI,sBAAsB;AAAA,IACnD,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,oBAAoB,cAAc,WAAW;AAAA,IACxE,MAAM;AAAA,EACR,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI;AAAA,MACR,+BAA+B,IAAI,MAAM,SAAS,IAAI;AAAA,IACxD;AAAA,EACF;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGA,eAAsB,eACpB,MACA,YACuB;AACvB,QAAM,MAAM,MAAM,MAAM,GAAG,IAAI,qBAAqB;AAAA,IAClD,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,oBAAoB,cAAc,WAAW;AAAA,IACxE,MAAM,KAAK,UAAU,EAAE,aAAa,WAAW,CAAC;AAAA,EAClD,CAAC;AAED,MAAI,IAAI,WAAW,KAAK;AACtB,UAAM,aAAa,OAAO,IAAI,QAAQ,IAAI,aAAa,KAAK,GAAG;AAC/D,WAAO,EAAE,QAAQ,aAAa,WAAW;AAAA,EAC3C;AACA,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI,MAAM,2BAA2B,IAAI,MAAM,IAAI;AAAA,EAC3D;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAYA,IAAM,eAAN,MAAmB;AAAA,EACT,aAAa;AAAA,EAErB,MAAc,cAAwD;AACpE,UAAM,OAAO,MAAM,eAAe;AAClC,UAAM,QAAQ,QAAQ,IAAI,kBAAkB,MAAM,UAAU;AAC5D,QAAI,CAAC,OAAO;AACV,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,UAAM,OAAO,WAAW,QAAQ,IAAI,iBAAiB,SAAY,MAAM,OAAO;AAC9E,WAAO,EAAE,MAAM,MAAM;AAAA,EACvB;AAAA,EAEA,MAAc,QACZ,QACAA,OACA,UAAU,GACe;AACzB,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,YAAY;AAC/C,UAAM,MAAM,MAAM,MAAM,GAAG,IAAI,GAAGA,KAAI,IAAI;AAAA,MACxC;AAAA,MACA,SAAS;AAAA,QACP,eAAe,UAAU,KAAK;AAAA,QAC9B,QAAQ;AAAA,QACR,cAAc;AAAA,MAChB;AAAA,IACF,CAAC;AAED,QAAI,IAAI,WAAW,OAAO,WAAW,KAAK,YAAY;AACpD,YAAM,aAAa,OAAO,IAAI,QAAQ,IAAI,aAAa,KAAK,CAAC;AAC7D,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,aAAa,MAAO,OAAO,CAAC;AACnE,aAAO,KAAK,QAAW,QAAQA,OAAM,UAAU,CAAC;AAAA,IAClD;AAEA,UAAM,OAAQ,IAAI,WAAW,MAAM,CAAC,IAAI,MAAM,IAAI,KAAK;AACvD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,MACH,MAA2C,OAAO,WACnD,QAAQ,IAAI,MAAM;AACpB,YAAM,MAAM,IAAI,MAAM,GAAG;AACzB,UAAI,SAAS,IAAI;AACjB,YAAM;AAAA,IACR;AACA,WAAO,EAAE,QAAQ,IAAI,QAAQ,KAAK;AAAA,EACpC;AAAA,EAEA,IAAiBA,OAAc;AAC7B,WAAO,KAAK,QAAW,OAAOA,KAAI;AAAA,EACpC;AACF;AAEO,IAAM,SAAS,IAAI,aAAa;;;AChIvC,SAAS,aAAa;AAOf,SAAS,QAAQ,KAAsB;AAC5C,QAAM,WAAW,QAAQ;AACzB,MAAI;AACJ,MAAI;AAEJ,MAAI,aAAa,UAAU;AACzB,cAAU;AACV,WAAO,CAAC,GAAG;AAAA,EACb,WAAW,aAAa,SAAS;AAC/B,cAAU;AAEV,WAAO,CAAC,MAAM,SAAS,IAAI,GAAG;AAAA,EAChC,OAAO;AACL,cAAU;AACV,WAAO,CAAC,GAAG;AAAA,EACb;AAEA,MAAI;AACF,UAAM,QAAQ,MAAM,SAAS,MAAM,EAAE,OAAO,UAAU,UAAU,KAAK,CAAC;AACtE,UAAM,GAAG,SAAS,MAAM;AAAA,IAAC,CAAC;AAC1B,UAAM,MAAM;AACZ,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;AChCA,OAAOC,WAAU;AACjB,SAAS,YAAAC,WAAU,aAAAC,YAAW,YAAY;AAO1C,eAAsB,UACpB,KACA,MACA,SACiB;AACjB,QAAM,WAAWF,MAAK,KAAK,KAAK,IAAI;AACpC,MAAI,WAAW;AACf,MAAI;AACF,eAAW,MAAMC,UAAS,UAAU,MAAM;AAAA,EAC5C,QAAQ;AACN,eAAW;AAAA,EACb;AAEA,MAAI,OAAO;AACX,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAG;AAClD,UAAM,OAAO,GAAG,GAAG,IAAI,KAAK;AAC5B,UAAM,KAAK,IAAI,OAAO,IAAI,aAAa,GAAG,CAAC,QAAQ,GAAG;AACtD,QAAI,GAAG,KAAK,IAAI,GAAG;AACjB,aAAO,KAAK,QAAQ,IAAI,IAAI;AAAA,IAC9B,OAAO;AACL,UAAI,KAAK,UAAU,CAAC,KAAK,SAAS,IAAI,EAAG,SAAQ;AACjD,cAAQ,GAAG,IAAI;AAAA;AAAA,IACjB;AAAA,EACF;AAEA,QAAMC,WAAU,UAAU,MAAM,MAAM;AACtC,SAAO;AACT;AAGA,eAAsB,WAAW,KAAa,MAAgC;AAC5E,MAAI;AACF,UAAM,KAAKF,MAAK,KAAK,KAAK,IAAI,CAAC;AAC/B,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,aAAa,GAAmB;AACvC,SAAO,EAAE,QAAQ,uBAAuB,MAAM;AAChD;;;ACjDA,SAAS,SAAAG,cAAa;AACtB,SAAS,YAAAC,iBAAgB;AASzB,eAAsB,qBACpB,KACyB;AACzB,MAAI,MAAM,WAAW,KAAK,gBAAgB,EAAG,QAAO;AACpD,MAAI,MAAM,WAAW,KAAK,WAAW,EAAG,QAAO;AAC/C,MAAI,MAAM,WAAW,KAAK,WAAW,EAAG,QAAO;AAC/C,MAAI,MAAM,WAAW,KAAK,mBAAmB,EAAG,QAAO;AAEvD,QAAM,KAAK,QAAQ,IAAI,yBAAyB;AAChD,MAAI,GAAG,WAAW,MAAM,EAAG,QAAO;AAClC,MAAI,GAAG,WAAW,MAAM,EAAG,QAAO;AAClC,MAAI,GAAG,WAAW,KAAK,EAAG,QAAO;AACjC,SAAO;AACT;AAGA,eAAsB,gBAAgB,KAAqC;AACzE,MAAI;AACF,UAAM,MAAM,KAAK,MAAM,MAAMC,UAAS,GAAG,GAAG,iBAAiB,MAAM,CAAC;AAIpE,UAAM,OAAO,EAAE,GAAG,IAAI,cAAc,GAAG,IAAI,gBAAgB;AAC3D,QAAI,KAAK,KAAM,QAAO;AACtB,QAAI,KAAK,KAAM,QAAO;AACtB,QAAI,KAAK,iBAAiB,KAAK,KAAK,kBAAkB,EAAG,QAAO;AAChE,QAAI,KAAK,QAAS,QAAO;AACzB,QAAI,KAAK,QAAS,QAAO;AACzB,QAAI,KAAK,KAAM,QAAO;AACtB,QAAI,KAAK,eAAe,EAAG,QAAO;AAClC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,eAAe,IAAoB,KAAqB;AACtE,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO,YAAY,GAAG;AAAA,IACxB,KAAK;AACH,aAAO,YAAY,GAAG;AAAA,IACxB,KAAK;AACH,aAAO,WAAW,GAAG;AAAA,IACvB;AACE,aAAO,eAAe,GAAG;AAAA,EAC7B;AACF;AAGO,SAAS,WACd,IACA,KACA,KACiB;AACjB,QAAM,OAAO,OAAO,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,GAAG;AAC1D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,QAAQC,OAAM,IAAI,MAAM;AAAA,MAC5B;AAAA,MACA,OAAO;AAAA,MACP,OAAO,QAAQ,aAAa;AAAA,IAC9B,CAAC;AACD,UAAM,GAAG,SAAS,MAAM,QAAQ,CAAC,CAAC;AAClC,UAAM,GAAG,SAAS,CAAC,SAAS,QAAQ,QAAQ,CAAC,CAAC;AAAA,EAChD,CAAC;AACH;;;ACjDA,IAAM,cAAc;AACpB,IAAM,WAAW;AACjB,IAAM,QAAQ,CAAC,OAAe,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAU3D,SAAS,qBAAqBC,UAAkB;AACrD,EAAAA,SACG,QAAQ,SAAS,EAAE,WAAW,KAAK,CAAC,EACpC,MAAM,MAAM,EACZ,YAAY,2DAA2D,EACvE,OAAO,aAAa,wDAAwD,EAC5E,OAAO,aAAa,mDAAmD,EACvE,OAAO,gBAAgB,yBAAyB,EAChD,OAAO,oBAAoB,+CAA+C,EAC1E;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,OAAO,OAAO,SAAuB;AACpC,UAAM,OAAO,MAAM,SAAS,IAAI;AAChC,QAAI,SAAS,EAAG,SAAQ,WAAW;AAAA,EACrC,CAAC;AACL;AAEA,eAAe,SAAS,MAAqC;AAC3D,QAAM,OAAO,WAAW,KAAK,OAAO;AACpC,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,cAAc,QAAQ,MAAM,SAAS,CAAC,KAAK;AAEjD,SAAO;AAKP,MAAI,KAAK,QAAQ;AACf,UAAM,UAAkC,EAAE,gBAAgB,KAAK,OAAO;AACtE,QAAI,SAAS,iBAAkB,SAAQ,kBAAkB;AACzD,UAAM,OAAO,MAAM,UAAU,KAAK,UAAU,OAAO;AACnD,iBAAa,2BAA2B,IAAI,KAAK,IAAI,CAAC,eAAe;AACrE,iBAAa,iEAAiE;AAC9E,WAAO;AAAA,EACT;AAGA,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,gBAAgB,IAAI;AAAA,EACnC,SAAS,KAAK;AACZ,eAAW,GAAG;AACd,WAAO;AAAA,EACT;AAEA,MAAI,EAAE,KAAK,oCAAoC,CAAC;AAChD,MAAI;AACJ,MAAI,SAAS,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC;AAC3C,MAAI;AAGJ,MAAI,eAAe,KAAK,MAAM;AAC5B,UAAM,OAAO,EAAE,IAAI,yCAAoC,CAAC;AAAA,EAC1D;AACA,MAAI,KAAK,KAAM,SAAQ,KAAK,yBAAyB;AACrD,YAAU,qCAAqC;AAC/C,MAAI,SAAS,EAAE,KAAK,KAAK,yBAAyB,CAAC;AACnD,MAAI;AACJ,YAAU,qDAAgD;AAG1D,QAAM,WAAW,KAAK,IAAI,IAAI,KAAK,aAAa;AAChD,MAAI,aAAa,KAAK,IAAI,GAAG,KAAK,QAAQ,IAAI;AAE9C,SAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,UAAM,MAAM,UAAU;AACtB,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,eAAe,MAAM,KAAK,WAAW;AAAA,IACnD,SAAS,KAAK;AACZ,iBAAW,GAAG;AACd,aAAO;AAAA,IACT;AAEA,QAAI,IAAI,WAAW,wBAAyB;AAC5C,QAAI,IAAI,WAAW,aAAa;AAC9B,oBAAc;AACd;AAAA,IACF;AACA,QAAI,IAAI,WAAW,iBAAiB;AAClC,iBAAW,IAAI,MAAM,qDAAqD,CAAC;AAC3E,aAAO;AAAA,IACT;AACA,QAAI,IAAI,WAAW,iBAAiB;AAClC,iBAAW,IAAI,MAAM,qDAAqD,CAAC;AAC3E,aAAO;AAAA,IACT;AAEA,WAAO,OAAO,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS,KAAK,KAAK,OAAO;AAAA,EACzE;AAEA,aAAW,IAAI,MAAM,wDAAwD,CAAC;AAC9E,SAAO;AACT;AAEA,eAAe,OACb,QACA,SACA,SACA,KACA,WACiB;AACjB,MAAI;AACJ,eAAa,wBAAwB,EAAE,KAAK,QAAQ,IAAI,CAAC,GAAG;AAG5D,QAAM,UAAkC,EAAE,gBAAgB,OAAO;AACjE,MAAI,WAAW,YAAY,iBAAkB,SAAQ,kBAAkB;AACvE,QAAM,UAAU,MAAM,UAAU,KAAK,UAAU,OAAO;AACtD,eAAa,2BAA2B,IAAI,KAAK,OAAO,CAAC,GAAG;AAE5D,MAAI;AACF,UAAM,WAAW,MAAM,eAAe;AAAA,MACpC;AAAA,MACA,SAAS,WAAW;AAAA,MACpB;AAAA,MACA,UAAS,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,CAAC;AACD,iBAAa,yBAAyB,QAAQ,QAAQ,CAAC,qBAAqB;AAAA,EAC9E,QAAQ;AACN,iBAAa,0DAA0D;AAAA,EACzE;AAGA,QAAM,KAAK,MAAM,qBAAqB,GAAG;AACzC,MAAI,WAAW;AACb,cAAU,cAAc,WAAW,SAAS,EAAE,QAAG;AACjD,UAAM,OAAO,MAAM,WAAW,IAAI,aAAa,GAAG;AAClD,QAAI,SAAS,EAAG,cAAa,aAAa,WAAW,GAAG;AAAA,QACnD,cAAa,wBAAwB,eAAe,IAAI,WAAW,CAAC,EAAE;AAAA,EAC7E,OAAO;AACL,cAAU,yBAAyB,eAAe,IAAI,WAAW,CAAC,EAAE;AAAA,EACtE;AAEA,iBAAe,MAAM,gBAAgB,GAAG,CAAC;AACzC,SAAO;AACT;AAEA,SAAS,eAAe,WAAgC;AACtD,MAAI;AACJ,MAAI,EAAE,KAAK,YAAY,CAAC;AACxB,MAAI,UAAW,KAAI,EAAE,IAAI,YAAY,SAAS,GAAG,CAAC;AAClD,MAAI,+CAA+C,EAAE,KAAK,4BAA4B,CAAC,GAAG;AAC1F,MAAI,aAAa,EAAE,KAAK,sBAAsB,CAAC,iCAAiC;AAChF,MAAI,aAAa,EAAE,KAAK,mBAAmB,CAAC,sBAAsB;AAClE,MAAI;AACJ,MAAI,EAAE,IAAI,mBAAmB,IAAI,EAAE,KAAK,eAAe,CAAC;AACxD,MAAI,EAAE,IAAI,gEAAgE,CAAC;AAC3E,MAAI;AACN;AAEA,SAAS,IAAI,KAAa,MAAsB;AAC9C,SAAO,KAAK,WAAW,GAAG,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,KAAK,OAAO;AACrE;AAEA,SAAS,QAAQ,MAAsB;AACrC,QAAM,OAAO,QAAQ,IAAI,QAAQ,QAAQ,IAAI;AAC7C,SAAO,QAAQ,KAAK,WAAW,IAAI,IAAI,IAAI,KAAK,MAAM,KAAK,MAAM,CAAC,KAAK;AACzE;;;AClMA,SAAS,KAAK,KAAqB;AACjC,SAAO,IAAI,SAAS,KAAK,IAAI,MAAM,GAAG,CAAC,IAAI,WAAM,IAAI,MAAM,EAAE,IAAI;AACnE;AAEO,SAAS,qBAAqBC,UAAkB;AACrD,QAAM,OAAOA,SAAQ,QAAQ,MAAM,EAAE,YAAY,qCAAqC;AAEtF,OACG,QAAQ,QAAQ,EAChB,YAAY,kDAAkD,EAC9D,OAAO,YAAY;AAClB,UAAM,OAAO,MAAM,eAAe;AAClC,UAAM,SAAS,QAAQ,IAAI;AAE3B,QAAI,CAAC,QAAQ,CAAC,QAAQ;AACpB,UAAI,WAAW,EAAG,WAAU,EAAE,WAAW,MAAM,CAAC;AAAA,UAC3C,WAAU,wBAAwB,EAAE,KAAK,cAAc,IAAI,aAAa;AAC7E;AAAA,IACF;AAEA,QAAI,WAAW,GAAG;AAChB,gBAAU;AAAA,QACR,WAAW;AAAA,QACX,QAAQ,SAAS,QAAQ;AAAA,QACzB,SAAS,MAAM,WAAW;AAAA,QAC1B,UAAU,MAAM,WAAW;AAAA,QAC3B,KAAK,SAAS,QAAQ,OAAO,KAAK,KAAK,MAAM,IAAI;AAAA,MACnD,CAAC;AACD;AAAA,IACF;AAEA,iBAAa,eAAe,OAAO,OAAO,EAAE,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,GAAG;AAC3E,QAAI,MAAM;AACR,cAAQ,IAAI,EAAE,IAAI,aAAa,IAAI,KAAK,QAAQ,IAAI;AACpD,cAAQ,IAAI,EAAE,IAAI,aAAa,IAAI,KAAK,KAAK,MAAM,CAAC;AACpD,cAAQ,IAAI,EAAE,IAAI,aAAa,IAAI,KAAK,OAAO;AAAA,IACjD;AACA,QAAI,OAAQ,SAAQ,IAAI,EAAE,IAAI,6CAA6C,CAAC;AAAA,EAC9E,CAAC;AAEH,OACG,QAAQ,QAAQ,EAChB,YAAY,2DAA2D,EACvE,OAAO,YAAY;AAClB,UAAM,gBAAgB;AACtB,iBAAa,4BAA4B;AAAA,EAC3C,CAAC;AACL;;;ACxCO,SAAS,sBAAsBC,UAAkB;AACtD,EAAAA,SACG,QAAQ,QAAQ,EAChB,YAAY,gEAAgE,EAC5E,OAAO,YAAY;AAClB,UAAM,OAAO,QAAQ,oCAA+B,EAAE,MAAM;AAC5D,QAAI;AACF,YAAM,EAAE,KAAK,IAAI,MAAM,OAAO,IAAoB,YAAY;AAC9D,WAAK,KAAK;AAEV,UAAI,WAAW,GAAG;AAChB,kBAAU,IAAI;AACd;AAAA,MACF;AAEA,YAAM,OAAO,MAAM,eAAe;AAClC,YAAM,WAAW,KAAK,YAAY;AAClC,YAAM,SAAS,KAAK,UAAU;AAE9B,UAAI,KAAM,WAAU,WAAW,EAAE,KAAK,KAAK,QAAQ,IAAI,CAAC,EAAE;AAC1D,UAAI,WAAW,KAAK,SAAS,GAAG;AAC9B,qBAAa,cAAc,QAAQ,gBAAgB,MAAM,qBAAqB;AAAA,MAChF,OAAO;AACL,kBAAU,kEAAkE;AAAA,MAC9E;AAAA,IACF,SAAS,KAAK;AACZ,WAAK,KAAK;AACV,iBAAW,GAAG;AACd,cAAQ,WAAW;AAAA,IACrB;AAAA,EACF,CAAC;AACL;;;ACjCO,SAAS,uBAAuBC,UAAkB;AACvD,QAAM,MAAMA,SAAQ,QAAQ,QAAQ,EAAE,YAAY,0BAA0B;AAE5E,MACG,QAAQ,KAAK,EACb,YAAY,oBAAoB,EAChC,SAAS,SAAS,sBAAsB,EACxC,SAAS,WAAW,cAAc,EAClC,OAAO,CAAC,KAAa,UAAkB;AACtC,YAAQ,KAAK;AAAA,MACX,KAAK;AACH,mBAAW,KAAK;AAChB,qBAAa,mBAAmB,WAAW,CAAC,EAAE;AAC9C;AAAA,MACF;AACE,mBAAW,IAAI,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AACxE,gBAAQ,WAAW;AAAA,IACvB;AAAA,EACF,CAAC;AAEH,MACG,QAAQ,KAAK,EACb,YAAY,wBAAwB,EACpC,SAAS,SAAS,+BAA+B,EACjD,OAAO,CAAC,QAAiB;AACxB,UAAM,MAAM,EAAE,UAAU,WAAW,GAAG,aAAa,cAAc,EAAE;AACnE,QAAI,OAAO,QAAQ,cAAc,QAAQ,QAAQ;AAC/C,iBAAW,IAAI,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAClD,cAAQ,WAAW;AACnB;AAAA,IACF;AACA,QAAI,WAAW,GAAG;AAChB,gBAAU,QAAQ,aAAa,EAAE,UAAU,IAAI,SAAS,IAAI,QAAQ,SAAS,EAAE,aAAa,IAAI,YAAY,IAAI,GAAG;AACnH;AAAA,IACF;AACA,QAAI,QAAQ,WAAY,SAAQ,IAAI,IAAI,QAAQ;AAAA,aACvC,QAAQ,OAAQ,SAAQ,IAAI,IAAI,WAAW;AAAA,QAC/C,YAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,GAAG,EAAG,SAAQ,IAAI,EAAE,KAAK,IAAI,GAAG,IAAI,MAAM,CAAC;AAAA,EACtF,CAAC;AAEH,MACG,QAAQ,OAAO,EACf,YAAY,qCAAqC,EACjD,OAAO,MAAM;AACZ,gBAAY;AACZ,iBAAa,sBAAsB;AAAA,EACrC,CAAC;AACL;;;AVhDA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,QAAQ,EACb,YAAY,kEAAkE,EAC9E,QAAQ,OAAW,EACnB,OAAO,UAAU,0CAA0C,EAC3D,KAAK,aAAa,CAAC,gBAAgB;AAClC,MAAI,YAAY,KAAK,EAAE,KAAM,aAAY,IAAI;AAC/C,CAAC;AAMH,qBAAqB,OAAO;AAC5B,qBAAqB,OAAO;AAC5B,sBAAsB,OAAO;AAC7B,uBAAuB,OAAO;AAE9B,QAAQ,WAAW;","names":["path","path","readFile","writeFile","spawn","readFile","readFile","spawn","program","program","program","program"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letterapp/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Letter CLI - connect your app to Letter in one command. Interactive, secure device login: no API key ever touches your shell or chat.",
   "license": "MIT",
   "homepage": "https://letter.app",
@@ -30,19 +30,27 @@
     "cli",
     "analytics",
     "email",
-    "onboarding"
+    "onboarding",
+    "ai-agents"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "clean": "rm -rf dist tsconfig.tsbuildinfo",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run clean && npm run build"
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "conf": "^13.1.0",
+    "ora": "^8.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
+    "tsup": "^8.4.0",
     "typescript": "^5.7.2"
   }
 }

package/dist/commands/login.js

@@ -1,151 +0,0 @@
-import { parseArgs, flagString, flagBool } from "../lib/args.js";
-import { resolveApiBase, DEFAULT_API_BASE, saveCredential } from "../lib/config.js";
-import { startDeviceAuth, pollDeviceAuth } from "../lib/api.js";
-import { openUrl } from "../lib/browser.js";
-import { upsertEnv } from "../lib/env-file.js";
-import { detectFramework, detectPackageManager, installCommand, runInstall, } from "../lib/pm.js";
-import { banner, color, error, info, log, prompt, success, warn, } from "../lib/ui.js";
-const SDK_PACKAGE = "@letterapp/node";
-const ENV_FILE = ".env.local";
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-/**
- * `letter login` / `letter init` (the default command). Runs the interactive
- * device-authorization flow, writes the minted key to the project env + the
- * shared credential store, and installs the SDK. The API key is NEVER printed.
- */
-export async function runLogin(argv) {
-    const { flags } = parseArgs(argv);
-    const base = resolveApiBase(flagString(flags, "base-url"));
-    const cwd = process.cwd();
-    const autoYes = flagBool(flags, "yes") === true || flags.y === true;
-    const allowOpen = flagBool(flags, "open") !== false; // --no-open disables
-    const doInstall = flagBool(flags, "install") !== false; // --no-install disables
-    const ciKey = flagString(flags, "api-key");
-    banner();
-    // CI escape hatch: write the provided key non-interactively. Documented as
-    // for automation only - interactive/agent use should rely on the device flow
-    // so no secret is passed through the command line / chat.
-    if (ciKey) {
-        const entries = { LETTER_API_KEY: ciKey };
-        if (base !== DEFAULT_API_BASE)
-            entries.LETTER_BASE_URL = base;
-        const file = await upsertEnv(cwd, ENV_FILE, entries);
-        success(`Saved LETTER_API_KEY to ${rel(cwd, file)} (--api-key).`);
-        warn("--api-key is for CI. For interactive setup, run `letter login`.");
-        return 0;
-    }
-    // 1. Begin the flow.
-    let flow;
-    try {
-        flow = await startDeviceAuth(base);
-    }
-    catch (err) {
-        error(err.message);
-        return 1;
-    }
-    log(`${color.bold("Confirm this code in your browser:")}`);
-    log();
-    log(`    ${color.cyan(color.bold(flow.user_code))}`);
-    log();
-    // 2. Open the browser (interactive: wait for Enter; otherwise auto/print).
-    const interactive = process.stdin.isTTY && !autoYes;
-    if (interactive && allowOpen) {
-        await prompt(color.dim("Press Enter to open your browser… "));
-    }
-    if (allowOpen)
-        openUrl(flow.verification_uri_complete);
-    info(`If your browser didn't open, visit:`);
-    log(`    ${color.blue(flow.verification_uri_complete)}`);
-    log();
-    info("Waiting for you to approve… (Ctrl+C to cancel)");
-    // 3. Poll until the user approves/denies or the code expires.
-    const deadline = Date.now() + flow.expires_in * 1000;
-    let intervalMs = Math.max(1, flow.interval) * 1000;
-    while (Date.now() < deadline) {
-        await sleep(intervalMs);
-        let res;
-        try {
-            res = await pollDeviceAuth(base, flow.device_code);
-        }
-        catch (err) {
-            error(err.message);
-            return 1;
-        }
-        if (res.status === "authorization_pending")
-            continue;
-        if (res.status === "slow_down") {
-            intervalMs += 1000;
-            continue;
-        }
-        if (res.status === "access_denied") {
-            error("Request denied in the browser. Nothing was changed.");
-            return 1;
-        }
-        if (res.status === "expired_token") {
-            error("This login expired. Run the command again to retry.");
-            return 1;
-        }
-        // Approved.
-        return finish(res.api_key, res.base_url, res.project, cwd, doInstall);
-    }
-    error("Timed out waiting for approval. Run the command again to retry.");
-    return 1;
-}
-async function finish(apiKey, baseUrl, project, cwd, doInstall) {
-    log();
-    success(`Approved for project ${color.bold(project.name)}.`);
-    // Write the key to the project env (value never printed) + shared store.
-    const entries = { LETTER_API_KEY: apiKey };
-    if (baseUrl && baseUrl !== DEFAULT_API_BASE)
-        entries.LETTER_BASE_URL = baseUrl;
-    const envFile = await upsertEnv(cwd, ENV_FILE, entries);
-    success(`Saved LETTER_API_KEY to ${rel(cwd, envFile)}.`);
-    try {
-        const credFile = await saveCredential({
-            apiKey,
-            baseUrl: baseUrl || DEFAULT_API_BASE,
-            project,
-            savedAt: new Date().toISOString(),
-        });
-        success(`Stored credentials in ${tildify(credFile)} for tooling (MCP).`);
-    }
-    catch {
-        warn("Could not write ~/.letter/credentials.json (continuing).");
-    }
-    // Install the SDK.
-    const pm = await detectPackageManager(cwd);
-    if (doInstall) {
-        info(`Installing ${SDK_PACKAGE} with ${pm}…`);
-        const code = await runInstall(pm, SDK_PACKAGE, cwd);
-        if (code === 0)
-            success(`Installed ${SDK_PACKAGE}.`);
-        else
-            warn(`Install failed. Run: ${installCommand(pm, SDK_PACKAGE)}`);
-    }
-    else {
-        info(`Skipped install. Run: ${installCommand(pm, SDK_PACKAGE)}`);
-    }
-    const framework = await detectFramework(cwd);
-    printNextSteps(framework);
-    return 0;
-}
-function printNextSteps(framework) {
-    log();
-    log(color.bold("Next steps"));
-    if (framework)
-        log(color.dim(`Detected ${framework}.`));
-    log(`  1. Create a server-side client that reads ${color.cyan("process.env.LETTER_API_KEY")}.`);
-    log(`  2. Call ${color.cyan("letter.identify(...)")} where users sign up or log in.`);
-    log(`  3. Call ${color.cyan("letter.track(...)")} on 2-3 key actions.`);
-    log();
-    log(color.dim("Full guide: https://letter.app/docs/agent-setup"));
-    log(color.dim("Your API key is in .env.local - keep it out of source control."));
-    log();
-}
-function rel(cwd, file) {
-    return file.startsWith(cwd) ? file.slice(cwd.length + 1) || file : file;
-}
-function tildify(file) {
-    const home = process.env.HOME || process.env.USERPROFILE;
-    return home && file.startsWith(home) ? `~${file.slice(home.length)}` : file;
-}

package/dist/commands/registry.js

@@ -1,21 +0,0 @@
-import { runLogin } from "./login.js";
-/**
- * Command registry. v1 ships only the device-login setup flow (as `login`,
- * `init`, and the default), but the shape here is the extension point: future
- * authenticated subcommands (`sequences`, `broadcast`, `contacts`, `events`,
- * `keys`, `status`) register the same way and reuse the credential store in
- * lib/config.ts + the API client in lib/api.ts. See README "Roadmap".
- */
-export const COMMANDS = [
-    {
-        name: "login",
-        aliases: ["init"],
-        summary: "Connect this project to Letter (interactive device login)",
-        run: runLogin,
-    },
-];
-/** The command that runs when none is given. */
-export const DEFAULT_COMMAND = "login";
-export function findCommand(name) {
-    return COMMANDS.find((c) => c.name === name || c.aliases?.includes(name));
-}

package/dist/lib/api.js

@@ -1,29 +0,0 @@
-const USER_AGENT = "@letterapp/cli";
-/** Starts a device-authorization flow against the given API base. */
-export async function startDeviceAuth(base) {
-    const res = await fetch(`${base}/v1/cli/auth/start`, {
-        method: "POST",
-        headers: { "content-type": "application/json", "user-agent": USER_AGENT },
-        body: "{}",
-    });
-    if (!res.ok) {
-        throw new Error(`Could not start login (HTTP ${res.status}). Is ${base} reachable?`);
-    }
-    return (await res.json());
-}
-/** Polls once for approval. */
-export async function pollDeviceAuth(base, deviceCode) {
-    const res = await fetch(`${base}/v1/cli/auth/poll`, {
-        method: "POST",
-        headers: { "content-type": "application/json", "user-agent": USER_AGENT },
-        body: JSON.stringify({ device_code: deviceCode }),
-    });
-    if (res.status === 429) {
-        const retryAfter = Number(res.headers.get("retry-after") ?? "5");
-        return { status: "slow_down", retryAfter };
-    }
-    if (!res.ok) {
-        throw new Error(`Login poll failed (HTTP ${res.status}).`);
-    }
-    return (await res.json());
-}

package/dist/lib/args.js

@@ -1,49 +0,0 @@
-export function parseArgs(argv) {
-    const positionals = [];
-    const flags = {};
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (arg.startsWith("--")) {
-            const body = arg.slice(2);
-            const eq = body.indexOf("=");
-            if (eq !== -1) {
-                flags[body.slice(0, eq)] = body.slice(eq + 1);
-            }
-            else if (body.startsWith("no-")) {
-                flags[body.slice(3)] = false;
-            }
-            else {
-                const next = argv[i + 1];
-                if (next && !next.startsWith("-")) {
-                    flags[body] = next;
-                    i++;
-                }
-                else {
-                    flags[body] = true;
-                }
-            }
-        }
-        else if (arg.startsWith("-") && arg.length > 1) {
-            for (const ch of arg.slice(1))
-                flags[ch] = true;
-        }
-        else {
-            positionals.push(arg);
-        }
-    }
-    return { positionals, flags };
-}
-export function flagString(flags, ...names) {
-    for (const n of names) {
-        const v = flags[n];
-        if (typeof v === "string")
-            return v;
-    }
-    return undefined;
-}
-export function flagBool(flags, name) {
-    const v = flags[name];
-    if (typeof v === "boolean")
-        return v;
-    return undefined;
-}

package/dist/lib/browser.js

@@ -1,33 +0,0 @@
-import { spawn } from "node:child_process";
-/**
- * Opens `url` in the default browser. Best-effort and non-blocking: if it fails
- * (headless box, no DISPLAY) the caller has already printed the URL so the user
- * can open it manually. Returns true if a launcher was spawned.
- */
-export function openUrl(url) {
-    const platform = process.platform;
-    let command;
-    let args;
-    if (platform === "darwin") {
-        command = "open";
-        args = [url];
-    }
-    else if (platform === "win32") {
-        command = "cmd";
-        // `start` needs an empty title arg; the comma-free form avoids quoting woes.
-        args = ["/c", "start", "", url];
-    }
-    else {
-        command = "xdg-open";
-        args = [url];
-    }
-    try {
-        const child = spawn(command, args, { stdio: "ignore", detached: true });
-        child.on("error", () => { });
-        child.unref();
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/lib/config.js

@@ -1,35 +0,0 @@
-import { homedir } from "node:os";
-import path from "node:path";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-/** The SDK's built-in default; when the resolved base equals this we don't
- * write LETTER_BASE_URL to the project env. */
-export const DEFAULT_API_BASE = "https://api.letter.app";
-/** Resolve the API base: explicit flag > env > prod default. */
-export function resolveApiBase(flagValue) {
-    const raw = flagValue || process.env.LETTER_BASE_URL || DEFAULT_API_BASE;
-    return raw.replace(/\/$/, "");
-}
-function credentialsPath() {
-    return path.join(homedir(), ".letter", "credentials.json");
-}
-/**
- * Persists the credential to ~/.letter/credentials.json with owner-only
- * permissions. Read by tools like @letterapp/mcp so the secret never has to be
- * pasted into an MCP config.
- */
-export async function saveCredential(cred) {
-    const file = credentialsPath();
-    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
-    await writeFile(file, `${JSON.stringify(cred, null, 2)}\n`, { mode: 0o600 });
-    return file;
-}
-/** Reads the stored credential, or null if none. */
-export async function readCredential() {
-    try {
-        const raw = await readFile(credentialsPath(), "utf8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}

package/dist/lib/env-file.js

@@ -1,45 +0,0 @@
-import path from "node:path";
-import { readFile, writeFile, stat } from "node:fs/promises";
-/**
- * Upserts `key=value` in an env file, creating it if needed. Existing keys are
- * replaced in place; new keys are appended. Returns the file path. The value is
- * never logged by this module - callers print only the key name.
- */
-export async function upsertEnv(cwd, file, entries) {
-    const filePath = path.join(cwd, file);
-    let contents = "";
-    try {
-        contents = await readFile(filePath, "utf8");
-    }
-    catch {
-        contents = "";
-    }
-    let next = contents;
-    for (const [key, value] of Object.entries(entries)) {
-        const line = `${key}=${value}`;
-        const re = new RegExp(`^${escapeRegExp(key)}=.*$`, "m");
-        if (re.test(next)) {
-            next = next.replace(re, line);
-        }
-        else {
-            if (next.length && !next.endsWith("\n"))
-                next += "\n";
-            next += `${line}\n`;
-        }
-    }
-    await writeFile(filePath, next, "utf8");
-    return filePath;
-}
-/** True if a file exists at `cwd/name`. */
-export async function fileExists(cwd, name) {
-    try {
-        await stat(path.join(cwd, name));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function escapeRegExp(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}

package/dist/lib/pm.js

@@ -1,72 +0,0 @@
-import { spawn } from "node:child_process";
-import { fileExists } from "./env-file.js";
-/**
- * Detects the package manager from lockfiles (then the `npm_config_user_agent`
- * of the running process), defaulting to npm.
- */
-export async function detectPackageManager(cwd) {
-    if (await fileExists(cwd, "pnpm-lock.yaml"))
-        return "pnpm";
-    if (await fileExists(cwd, "yarn.lock"))
-        return "yarn";
-    if (await fileExists(cwd, "bun.lockb"))
-        return "bun";
-    if (await fileExists(cwd, "package-lock.json"))
-        return "npm";
-    const ua = process.env.npm_config_user_agent ?? "";
-    if (ua.startsWith("pnpm"))
-        return "pnpm";
-    if (ua.startsWith("yarn"))
-        return "yarn";
-    if (ua.startsWith("bun"))
-        return "bun";
-    return "npm";
-}
-/** Detects a likely web framework for friendlier guidance. */
-export async function detectFramework(cwd) {
-    try {
-        const pkgPath = `${cwd}/package.json`;
-        const { readFile } = await import("node:fs/promises");
-        const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
-        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-        if (deps.next)
-            return "Next.js";
-        if (deps.nuxt)
-            return "Nuxt";
-        if (deps["@remix-run/node"] || deps["@remix-run/react"])
-            return "Remix";
-        if (deps.express)
-            return "Express";
-        if (deps.fastify)
-            return "Fastify";
-        if (deps.hono)
-            return "Hono";
-        if (deps["@sveltejs/kit"])
-            return "SvelteKit";
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-export function installCommand(pm, pkg) {
-    switch (pm) {
-        case "pnpm":
-            return `pnpm add ${pkg}`;
-        case "yarn":
-            return `yarn add ${pkg}`;
-        case "bun":
-            return `bun add ${pkg}`;
-        default:
-            return `npm install ${pkg}`;
-    }
-}
-/** Runs the install command, streaming output. Resolves to the exit code. */
-export function runInstall(pm, pkg, cwd) {
-    const args = pm === "npm" ? ["install", pkg] : pm === "yarn" ? ["add", pkg] : ["add", pkg];
-    return new Promise((resolve) => {
-        const child = spawn(pm, args, { cwd, stdio: "inherit", shell: process.platform === "win32" });
-        child.on("error", () => resolve(1));
-        child.on("close", (code) => resolve(code ?? 1));
-    });
-}

package/dist/lib/ui.js

@@ -1,57 +0,0 @@
-import readline from "node:readline";
-const useColor = process.stdout.isTTY && !process.env.NO_COLOR && process.env.TERM !== "dumb";
-function wrap(open, close) {
-    return (s) => useColor ? `\u001b[${open}m${s}\u001b[${close}m` : s;
-}
-export const color = {
-    bold: wrap(1, 22),
-    dim: wrap(2, 22),
-    red: wrap(31, 39),
-    green: wrap(32, 39),
-    yellow: wrap(33, 39),
-    blue: wrap(34, 39),
-    cyan: wrap(36, 39),
-    gray: wrap(90, 39),
-};
-export function log(msg = "") {
-    process.stdout.write(`${msg}\n`);
-}
-export function info(msg) {
-    log(`${color.cyan("›")} ${msg}`);
-}
-export function success(msg) {
-    log(`${color.green("✓")} ${msg}`);
-}
-export function warn(msg) {
-    log(`${color.yellow("!")} ${msg}`);
-}
-export function error(msg) {
-    process.stderr.write(`${color.red("✗")} ${msg}\n`);
-}
-export function step(n, total, msg) {
-    log(`${color.dim(`[${n}/${total}]`)} ${msg}`);
-}
-/** The Letter wordmark banner. */
-export function banner() {
-    log();
-    log(`  ${color.bold("Letter")}${color.red(".")} ${color.dim("CLI")}`);
-    log();
-}
-/**
- * Prompts the user and resolves with their input. Returns "" immediately on a
- * non-interactive stdin so automated/agent runs don't hang.
- */
-export function prompt(question) {
-    if (!process.stdin.isTTY)
-        return Promise.resolve("");
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    return new Promise((resolve) => {
-        rl.question(question, (answer) => {
-            rl.close();
-            resolve(answer);
-        });
-    });
-}