Function runUsage

src/commands/usage.ts:81–133

(opts: CommonOptions, deps: UsageDeps = {})

 * omitted (forward-compat until the backend adds the projection).
 */
export async function runUsage(opts: CommonOptions, deps: UsageDeps = {}): Promise<UsageResponse> {
  const stderr = deps.stderr ?? ((line: string) => process.stderr.write(`${line}\n`));
  const out = makeOutput(opts.output, deps);

  if (opts.dryRun) {
    emitDryRunBanner(stderr);
    stderr('[note] credit balance requires a backend update — showing dry-run sample values');
    out.print(DRY_RUN_USAGE_SAMPLE, data => renderUsage(data as UsageResponse));
    return DRY_RUN_USAGE_SAMPLE;
  }

  const client = makeHttpClient(opts, {
    env: deps.env,
    credentialsPath: deps.credentialsPath,
    fetchImpl: deps.fetchImpl,
    stderr: deps.stderr,
  });

  // Environment-correct portal origin for billing/upgrade links (dev and prod
  // portals live on different domains — never hardcode). Resolved from the
  // same credentials the client was just built from; undefined for unknown
  // hosts (links then render as routes only).
  const portalBase = resolvePortalBase(
    loadConfig({
      profile: opts.profile,
      endpointUrl: opts.endpointUrl,
      env: deps.env,
      credentialsPath: deps.credentialsPath,
    }).apiUrl,
  );
  const billingUrl =
    portalBase !== undefined
      ? `${portalBase}/dashboard/settings/billing`
      : 'the portal Billing page (/dashboard/settings/billing)';

  // /me is the only available source of credits/plan today.
  // When the backend adds credits/subPlan to MeResponse (or adds /usage),
  // this single get call is sufficient — no code change needed in the CLI.
  const me = await client.get<UsageResponse>('/me');

  out.print(me, data => renderUsage(data as UsageResponse, portalBase));

  // In text mode, emit a backend-gap note when credits are missing so the
  // user knows why the balance isn't shown (instead of assuming zero or error).
  if (opts.output === 'text' && me.credits === undefined) {
    stderr(
      '[note] credit balance not available — backend does not yet expose credits on /me.' +
        ` Check ${billingUrl} for your current balance.`,
    );
  }

  return me;
}

function renderUsage(u: UsageResponse, portalBase?: string): string {
  const lines: string[] = [];