Files
qqq-cli/packages/ui-api-client
james.maesandClaude Fable 5.1 8b2ee7946c test: let the shell expand the test glob so npm test runs on Node 20
node --test only expands glob patterns itself from Node 21. With the
pattern quoted, Node 20 looked for a file literally named
dist/test/*.test.js and every workspace's npm test failed, although
the packages declare engines node >=20. The orb's Node 22 image hid it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-31 18:32:36 -05:00
..

@qrun-io/qqq-ui-api-client

A typed TypeScript client for the QQQ UI API (/qqq/v1), generated from the merged OpenAPI document (core plus the extension documents of the qbits), with OAuth2 device-flow and PKCE sign-in, token refresh and a realtime (SSE) reader.

import { createUiApiClient, unwrap } from '@qrun-io/qqq-ui-api-client'

const api = createUiApiClient({ baseUrl: 'https://admin.example.com', token: () => process.env.QQQ_TOKEN!, clientChannel: 'tui/my-tui 1.0' })
const page = await unwrap(api.POST('/qqq/v1/table/{tableName}/query', {
  params: { path: { tableName: 'person' } },
  body: { filter: { criteria: [{ fieldName: 'lastName', operator: 'STARTS_WITH', values: ['K'] }], limit: 20 } },
}))

The package version follows the UI API version of the document it was generated from (UI_API_VERSION); the document itself is exported as @qrun-io/qqq-ui-api-client/openapi/qqq-v1.json. Node.js 20 or later, or any runtime with fetch.

More: the repository README and QQQ's UI-API-CLIENTS.md.

Apache-2.0