Function registerApiCommand

packages/cli/src/cli.ts:132–168

(cmd: Command, spec: CommandSpec, meta: OperationMeta)

type OperationMeta = (typeof operationMeta)[keyof typeof operationMeta]

function registerApiCommand(cmd: Command, spec: CommandSpec, meta: OperationMeta) {
  const seg = spec.path[spec.path.length - 1]!
  cmd.summary(meta.summary).description(meta.description)
  for (const p of meta.pathParams)
    if (seg === toKebab(p.name)) cmd.argument(`<${p.name}>`, `${p.name} (path param)`)
    else cmd.option(`--${p.name} <value>`, `${p.name} (path param)`)

  for (const p of meta.bodyParams) cmd.option(`--${p.name} <value>`, `body.${p.name}`)
  cmd.option('--body <json>', 'raw JSON body (overrides individual body opts)')
  cmd.action(async function (this: Command, ...positionalArgs: unknown[]) {
    const merged = this.optsWithGlobals() as Record<string, unknown>
    const baseUrl = (merged.baseUrl as string) ?? resolveBaseUrl()
    const optsFromCmd = merged
    const pathParamValues: Record<string, string> = {}
    meta.pathParams.forEach((p, i) => {
      const val = positionalArgs[i]
      if (val !== undefined) pathParamValues[p.name] = String(val)
    })
    const cmdOpts = { ...optsFromCmd, ...pathParamValues }
    const apiKey = await ensureApiKey()
    const client = createClient({ baseUrl, apiKey })
    const opts = buildOpts(meta, cmdOpts)
    try {
      const result = await runCommand({ client, spec, meta, opts })
      console.log(JSON.stringify(result, null, 2))
    } catch (err) {
      const msg = err instanceof Error ? err.message : String(err)
      const body =
        err && typeof err === 'object' && 'body' in err
          ? (err as { body: unknown }).body
          : undefined
      console.error('Error:', msg)
      if (body) console.error('Details:', JSON.stringify(body, null, 2))
      process.exit(1)
    }
  })
}

for (const spec of commandSpecs) {
  const meta = operationMeta[spec.operationId as keyof typeof operationMeta]