Function runList

src/commands/test.ts:419–475

(opts: ListOptions, deps: TestDeps = {})

}

export async function runList(opts: ListOptions, deps: TestDeps = {}): Promise<Page<CliTest>> {
  // Validate inputs before touching credentials so a missing `--project`
  // surfaces as `VALIDATION_ERROR` (exit 5) rather than `AUTH_REQUIRED`
  // (exit 3) when the caller also lacks a configured key. Order matters
  // for the CLI error spec §2 — bad input is a caller bug, not an auth
  // gate.
  requireProjectId(opts.projectId);

  const paginationFlags: PaginationFlags = validatePaginationFlags({
    pageSize: opts.pageSize,
    startingToken: opts.startingToken,
    maxItems: opts.maxItems,
  });

  const out = makeOutput(opts.output, deps);
  const client = makeClient(opts, deps);

  // Match P2's "explicit pageSize ⇒ single-page" convention so an
  // operator can grab one slice + cursor without auto-paging through a
  // huge project.
  const useSinglePage = opts.pageSize !== undefined && opts.maxItems === undefined;

  // M2.1 piece 2: validate `--status` tokens client-side before
  // sending. Friendlier error than waiting for the server's 400 with
  // a list of accepted tokens — and lets the user fix typos without
  // a round trip.
  validateStatusFilter(opts.status);

  const baseQuery: Record<string, string | number | boolean | undefined> = {
    projectId: opts.projectId,
    type: opts.type,
    createdFrom: opts.createdFrom,
    status: opts.status,
  };

  let page: Page<CliTest>;
  if (useSinglePage) {
    page = await fetchSinglePage<CliTest>(
      client,
      '/tests',
      paginationFlags.pageSize!,
      opts.startingToken,
      baseQuery,
    );
  } else {
    page = await paginate<CliTest>(
      async ({ pageSize, cursor }) =>
        client.get<Page<CliTest>>('/tests', {
          query: { ...baseQuery, pageSize, cursor },
        }),
      paginationFlags,
    );
  }

  out.print(page, data => renderTestListText(data as Page<CliTest>));
  return page;
}