ask-qwksearch-api-client

Import typed functions like agentSearch or listChats from the qwksearch-api-client package and pass one options object with body, path, query, or headers. Each call returns { data, error, request, response } and does not throw unless you set throwOnError: true.

Pass grab transport options per call, such as cache: true, cacheForTime, retryAttempts, rateLimit, or timeout. Requests go through api2client over grab rather than fetch, so these options work on every generated function.

The baseUrl resolver uses window.NEXT_PUBLIC_BASE_URL or location.origin in the browser, but on the server it falls back to https://qwksearch.com when NEXT_PUBLIC_BASE_URL is unset. Set that environment variable or pass a custom client with createClient.

The installed grab version predates 1.6.23 and lacks the onRawResponse hook, so api2client has no raw Response to return and error is a plain HTTP error string. Check grab.supports.onRawResponse and upgrade grab.

Update qwksearch-openapi.json, then run bun run build:api, which runs openapi-ts, api2client --rewire-only, and vite build. Commit both src/*.gen.ts and dist/, since the package has no build script and consumers use the committed dist.

Browser calls carry the session cookie automatically, but server or CLI callers must authenticate explicitly. Create your own client and set an Authorization header via client.setConfig, which is how the VS Code extension's API-key mode works.