@composio/client 2.0.0-rc.6 → 2.0.0-rc.7

package/README.md

@@ -17,6 +17,54 @@ const session = await composio.toolRouter.session.create({ user_id: 'user_123' }
 console.log(session.session_id, session.mcp.url)
 ```
 
+### Pagination
+
+Use the `@composio/client/pagination` subpath to traverse list operations that return the standard
+`items` and `next_cursor` fields:
+
+```ts
+import { paginate } from '@composio/client/pagination'
+
+const toolkits = paginate(({ cursor }) =>
+  composio.toolkits.list({ cursor, limit: 100 }),
+)
+
+for await (const toolkit of toolkits) {
+  console.log(toolkit.slug)
+}
+```
+
+Item iteration is lazy. Each traversal starts from the first page, and breaking early stops fetching
+more pages. Use `iterPages()` when page metadata matters, or `toArray()` to collect every item; avoid
+`toArray()` when the full result may not fit comfortably in memory.
+
+```ts
+for await (const page of toolkits.iterPages()) {
+  console.log(page.items.length)
+}
+
+const allToolkits = await toolkits.toArray()
+```
+
+For another response shape, provide an adapter. Custom cursors must be strings or numbers so repeated
+values can be detected reliably across independently decoded pages:
+
+```ts
+const results = paginate(
+  ({ cursor }) => loadPage(cursor),
+  {
+    items: page => page.data,
+    nextCursor: page => page.nextCursor,
+  },
+)
+```
+
+A repeated cursor cycle throws `ComposioError` instead of requesting pages indefinitely. An empty
+cursor ends traversal. When a response omits `next_cursor` but numeric `current_page` and
+`total_pages` metadata shows that more pages exist, the default adapter fails instead of silently
+returning partial results; provide a custom adapter for that response shape. Requests are sequential
+and inherit the normal client retry/backoff path, but this is not proactive/shared rate-limit pacing.
+
 Use `fromEnv` when configuration must come from a specific environment snapshot instead of the
 host process. Explicit options replace mapped values, so this is safe for tests, workers, and
 applications that load configuration themselves:
@@ -27,7 +75,7 @@ const composio = Composio.fromEnv(config, { environment: 'staging' })
 
 `fromEnv` recognizes `COMPOSIO_API_KEY`, `COMPOSIO_USER_API_KEY`, `COMPOSIO_ORG_API_KEY`,
 `COMPOSIO_BASE_URL`, `COMPOSIO_ALLOW_INSECURE_HTTP`, `COMPOSIO_CUSTOM_HEADERS`, and
-`COMPOSIO_LOG`. Derived clients created with `withOptions()` keep using the resolved snapshot and do
+`COMPOSIO_LOG_LEVEL`. Derived clients created with `withOptions()` keep using the resolved snapshot and do
 not fall back to ambient values.
 
 Inject a `Transport` when an application or test needs to own HTTP dispatch. The transport receives
@@ -76,8 +124,8 @@ Toolchain is pinned via [mise](https://mise.jdx.dev) (`mise install`): Node 24,
 ```sh
 pnpm install
 pnpm generate       # hey-api + compat codegen: spec/openapi.json → src/generated + src/compat/resources (do not edit)
-pnpm lint           # eslint over src, test, packages/codegen
-pnpm typecheck      # tsgo (TS native) over src+test, incl. type tests
+pnpm lint           # eslint over src, test, codegen, parity, and demo
+pnpm typecheck      # tsgo (TS native), including type tests and demo
 pnpm typecheck:tsc  # same programs under tsc — both compilers must pass
 pnpm codegen:check  # verify committed src/compat/resources matches the generator
 pnpm test           # unit tests (MSW mocks) + codegen tests

package/dist/{api-key-revocation-CSNyQo6m.mjs → api-key-revocation-BPURmRJx.mjs}

@@ -1,4 +1,4 @@
-import { c as withOperation, n as generatedOperation } from "./generated-operations-BQO2JR1q.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-CJ7bbwvC.mjs";
 
 //#region src/compat/resources/api-key-revocation.ts
 const OP_CREATE = generatedOperation("apiKeyRevocation.create");

package/dist/{auth-configs-DAS68quO.mjs → auth-configs-DYkxc_It.mjs}

@@ -1,4 +1,4 @@
-import { a as path, c as withOperation, n as generatedOperation } from "./generated-operations-BQO2JR1q.mjs";
+import { a as path, c as withOperation, n as generatedOperation } from "./generated-operations-CJ7bbwvC.mjs";
 
 //#region src/compat/resources/auth-configs.ts
 const OP_CREATE = generatedOperation("authConfigs.create");

package/dist/{auth-BpeKOtkr.mjs → auth-iqhTmHa9.mjs}

@@ -1,4 +1,4 @@
-import { t as Session } from "./session-Byj-qri0.mjs";
+import { t as Session } from "./session-B78Twedd.mjs";
 
 //#region src/compat/resources/auth/auth.ts
 /**

package/dist/{clanker-CdTX3VrN.mjs → clanker-CzfQDpuy.mjs}

@@ -1,4 +1,4 @@
-import { c as withOperation, n as generatedOperation } from "./generated-operations-BQO2JR1q.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-CJ7bbwvC.mjs";
 
 //#region src/compat/resources/org/clanker.ts
 const OP_CREATE_CLAIM = generatedOperation("org.clanker.createClaim");

package/dist/{cli-BwAcGYUv.mjs → cli-Er9a9rGs.mjs}

@@ -1,5 +1,5 @@
-import { c as withOperation, n as generatedOperation, p as mergeHeaders } from "./generated-operations-BQO2JR1q.mjs";
-import { t as Realtime } from "./realtime-CtLFFEf8.mjs";
+import { c as withOperation, n as generatedOperation, p as mergeHeaders } from "./generated-operations-CJ7bbwvC.mjs";
+import { t as Realtime } from "./realtime-BNfA3u3B.mjs";
 
 //#region src/compat/resources/cli/cli.ts
 const OP_CREATE_CODACT_FAILURE = generatedOperation("cli.createCodactFailure");