@zapier/zapier-sdk 0.12.0 → 0.13.0

package/README.md

@@ -14,6 +14,8 @@
   - [`listInputFields`](#listinputfields)
   - [`runAction`](#runaction)
 - [Apps](#apps)
+  - [`apps.{appKey}`](#appsappkey)
+  - [`apps.{appKey}.{actionType}.{actionKey}`](#appsappkeyactiontypeactionkey)
   - [`getApp`](#getapp)
   - [`listApps`](#listapps)
 - [Authentications](#authentications)
@@ -29,7 +31,7 @@
 
 ```bash
 npm install @zapier/zapier-sdk
-npm install -D @types/node typescript
+npm install -D @zapier/zapier-sdk-cli @types/node typescript
 npx tsc --init
 ```
 
@@ -63,22 +65,74 @@ const zapier = createZapierSdk();
 // });
 
 // ######## Access Apps ########
-const apps = await zapier.listApps();
-const singleApp = await zapier.getApp({ appKey: "SlackCLIAPI" });
+// List methods return a promise for a page with {data, nextCursor}.
+const { data: firstPageApps, nextCursor } = await zapier.listApps();
+// Use the cursor to get the next page:
+const { data: secondPageApps } = await zapier.listApps({ cursor: nextCursor });
+
+console.log({
+  firstPageApps,
+  secondPageApps,
+});
+
+// List methods also return an iterator for all pages.
+// Be careful with lots of pages, note the `search` to filter.
+for await (const page of zapier.listApps({ search: "slack" })) {
+  const { data: apps } = page;
+  console.log({
+    apps,
+  });
+}
+
+// Use `.items()` to iterate over all items of all pages:
+// Again, be careful with lots of items. Note the `maxItems` to limit the total items.
+for await (const app of zapier.listApps({ maxItems: 100 }).items()) {
+  console.log({
+    app,
+  });
+}
+
+// You can collect all results, but this could take a while for long lists!
+const allApps = await Array.fromAsync(
+  zapier.listApps({ maxItems: 1000 }).items(),
+);
+
+console.log({
+  allApps,
+});
+
+// The item methods return a promise for a single item, wrapped with {data}.
+// This is just to give us room to add metadata in the future.
+const { data: app } = await zapier.getApp({ appKey: "slack" });
+
+console.log({
+  app,
+});
 
 // ######## Authentication Usage ########
-const myAuths = await zapier.listAuthentications({
-  appKey: "SlackCLIAPI",
+const { data: myAuths } = await zapier.listAuthentications({
+  appKey: "slack",
   owner: "me",
 });
 
 // ######## Find Actions ########
 // Option 1: List actions
-const actions = await zapier.listActions({ appKey: "SlackCLIAPI" });
+// Remember, this is just the first page which may not include them all!
+// See `.items()` usage above, which can be used to make sure you get all actions.
+const { data: actions } = await zapier.listActions({ appKey: "slack" });
+
+console.log({
+  actions,
+});
+
 const singleAction = await zapier.getAction({
-  appKey: "SlackCLIAPI",
-  actionType: actions.data[0].action_type,
-  actionKey: actions.data[0].key,
+  appKey: "slack",
+  actionType: actions[0].action_type,
+  actionKey: actions[0].key,
+});
+
+console.log({
+  singleAction,
 });
 
 // Option 2: Access actions via the `apps` proxy
@@ -89,25 +143,28 @@ const singleAction = await zapier.getAction({
 
 // ######## Run Actions ########
 // Option 1:
-const allChannels = await zapier.runAction({
-  appKey: "SlackCLIAPI",
+const { data: channels } = await zapier.runAction({
+  appKey: "slack",
   actionType: "read",
   actionKey: "channels",
-  authenticationId: myAuths.data[0].id,
+  authenticationId: myAuths[0].id,
+});
+
+console.log({
+  channels,
 });
 
+const { data: profile } = await zapier.getProfile();
+
 // Option 2:
-const allChannelsResult = await zapier.apps.slack.read.channels({
-  authenticationId: myAuths.data[0].id,
+const { data: users } = await zapier.apps.slack.search.user_by_email({
+  inputs: {
+    email: profile.email,
+  },
 });
 
 console.log({
-  apps: apps.data[0],
-  singleApp,
-  actions: actions.data[0],
-  singleAction,
-  allChannels: allChannels.data[0],
-  allChannelsResult,
+  users,
 });
 ```
 
@@ -121,16 +178,16 @@ Get current user's profile information
 
 **Parameters:**
 
-| Name      | Type     | Required | Default | Possible Values | Description                            |
-| --------- | -------- | -------- | ------- | --------------- | -------------------------------------- |
-| `options` | `string` | ❌       | —       | —               | Get current user's profile information |
+| Name      | Type     | Required | Default | Possible Values | Description |
+| --------- | -------- | -------- | ------- | --------------- | ----------- |
+| `options` | `object` | ❌       | —       | —               |             |
 
 **Returns:** `Promise<ProfileItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.getProfile();
+const { data: profile } = await sdk.getProfile();
 ```
 
 ### Actions
@@ -141,20 +198,19 @@ Get detailed information about a specific action
 
 **Parameters:**
 
-| Name           | Type     | Required | Default | Possible Values                                                                                | Description                                        |
-| -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------- |
-| `options`      | `string` | ✅       | —       | —                                                                                              | Get detailed information about a specific action   |
-| ↳ `appKey`     | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                      |
-| ↳ `actionType` | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type |
-| ↳ `actionKey`  | `string` | ✅       | —       | —                                                                                              | Action key to execute                              |
+| Name           | Type     | Required | Default | Possible Values                                                                                | Description                                         |
+| -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —                                                                                              |                                                     |
+| ↳ `appKey`     | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ↳ `actionType` | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type  |
+| ↳ `actionKey`  | `string` | ✅       | —       | —                                                                                              | Action key to execute                               |
 
 **Returns:** `Promise<ActionItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.getAction({
-  options: "example-value",
+const { data: action } = await sdk.getAction({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
@@ -167,23 +223,40 @@ List all actions for a specific app
 
 **Parameters:**
 
-| Name           | Type     | Required | Default | Possible Values                                                                                | Description                                      |
-| -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------ |
-| `options`      | `string` | ✅       | —       | —                                                                                              | List all actions for a specific app              |
-| ↳ `appKey`     | `string` | ✅       | —       | —                                                                                              | App key of actions to list (e.g., 'SlackCLIAPI') |
-| ↳ `actionType` | `string` | ❌       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Filter actions by type                           |
-| ↳ `pageSize`   | `number` | ❌       | —       | —                                                                                              | Number of actions per page                       |
-| ↳ `maxItems`   | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages   |
+| Name           | Type     | Required | Default | Possible Values                                                                                | Description                                                            |
+| -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —                                                                                              |                                                                        |
+| ↳ `appKey`     | `string` | ✅       | —       | —                                                                                              | App key of actions to list (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ↳ `actionType` | `string` | ❌       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Filter actions by type                                                 |
+| ↳ `pageSize`   | `number` | ❌       | —       | —                                                                                              | Number of actions per page                                             |
+| ↳ `maxItems`   | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                         |
+| ↳ `cursor`     | `string` | ❌       | —       | —                                                                                              | Cursor to start from                                                   |
 
 **Returns:** `Promise<PaginatedResult<ActionItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.listActions({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: actions, nextCursor } = await sdk.listActions({
   appKey: "example-key",
 });
+
+// Or iterate over all pages
+for await (const page of sdk.listActions({
+  appKey: "example-key",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const action of sdk
+  .listActions({
+    appKey: "example-key",
+  })
+  .items()) {
+  // Do something with each action
+}
 ```
 
 #### `listInputFieldChoices`
@@ -192,31 +265,56 @@ Get the available choices for a dynamic dropdown input field
 
 **Parameters:**
 
-| Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                                  |
-| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| `options`            | `string` | ✅       | —       | —                                                                                              | Get the available choices for a dynamic dropdown input field |
-| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                                |
-| ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type           |
-| ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                                        |
-| ↳ `inputFieldKey`    | `string` | ✅       | —       | —                                                                                              | Input field key to get choices for.                          |
-| ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action                     |
-| ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Current input values that may affect available choices       |
-| ↳ `page`             | `number` | ❌       | —       | —                                                                                              | Page number for paginated results                            |
-| ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of choices per page                                   |
-| ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages               |
+| Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                            |
+| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `options`            | `object` | ✅       | —       | —                                                                                              |                                                        |
+| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')    |
+| ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type     |
+| ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                                  |
+| ↳ `inputFieldKey`    | `string` | ✅       | —       | —                                                                                              | Input field key to get choices for.                    |
+| ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action               |
+| ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Current input values that may affect available choices |
+| ↳ `page`             | `number` | ❌       | —       | —                                                                                              | Page number for paginated results                      |
+| ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of choices per page                             |
+| ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages         |
+| ↳ `cursor`           | `string` | ❌       | —       | —                                                                                              | Cursor to start from                                   |
 
 **Returns:** `Promise<PaginatedResult<InputFieldChoiceItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.listInputFieldChoices({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: inputFieldChoices, nextCursor } = await sdk.listInputFieldChoices(
+  {
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+    inputFieldKey: "example-key",
+  },
+);
+
+// Or iterate over all pages
+for await (const page of sdk.listInputFieldChoices({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
   inputFieldKey: "example-key",
-});
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const inputFieldChoice of sdk
+  .listInputFieldChoices({
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+    inputFieldKey: "example-key",
+  })
+  .items()) {
+  // Do something with each inputFieldChoice
+}
 ```
 
 #### `listInputFields`
@@ -227,26 +325,47 @@ Get the input fields required for a specific action
 
 | Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                           |
 | -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
-| `options`            | `string` | ✅       | —       | —                                                                                              | Get the input fields required for a specific action   |
-| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                         |
+| `options`            | `object` | ✅       | —       | —                                                                                              |                                                       |
+| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')   |
 | ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type    |
 | ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                                 |
 | ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action              |
 | ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Current input values that may affect available fields |
 | ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of input fields per page                       |
 | ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages        |
+| ↳ `cursor`           | `string` | ❌       | —       | —                                                                                              | Cursor to start from                                  |
 
 **Returns:** `Promise<PaginatedResult<RootFieldItemItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.listInputFields({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: rootFieldItems, nextCursor } = await sdk.listInputFields({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
 });
+
+// Or iterate over all pages
+for await (const page of sdk.listInputFields({
+  appKey: "example-key",
+  actionType: "read",
+  actionKey: "example-key",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const rootFieldItem of sdk
+  .listInputFields({
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+  })
+  .items()) {
+  // Do something with each rootFieldItem
+}
 ```
 
 #### `runAction`
@@ -255,50 +374,125 @@ Execute an action with the given inputs
 
 **Parameters:**
 
-| Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                        |
-| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------- |
-| `options`            | `string` | ✅       | —       | —                                                                                              | Execute an action with the given inputs            |
-| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                      |
-| ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type |
-| ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                              |
-| ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action           |
-| ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Input parameters for the action                    |
-| ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of results per page                         |
-| ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages     |
+| Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                         |
+| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `options`            | `object` | ✅       | —       | —                                                                                              |                                                     |
+| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type  |
+| ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                               |
+| ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action            |
+| ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Input parameters for the action                     |
+| ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of results per page                          |
+| ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages      |
+| ↳ `cursor`           | `string` | ❌       | —       | —                                                                                              | Cursor to start from                                |
 
 **Returns:** `Promise<PaginatedResult<ActionResultItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.runAction({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: actionResults, nextCursor } = await sdk.runAction({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
 });
+
+// Or iterate over all pages
+for await (const page of sdk.runAction({
+  appKey: "example-key",
+  actionType: "read",
+  actionKey: "example-key",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const actionResult of sdk
+  .runAction({
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+  })
+  .items()) {
+  // Do something with each actionResult
+}
 ```
 
 ### Apps
 
+#### `apps.{appKey}`
+
+Bind an authentication ID to an app
+
+**Parameters:**
+
+| Name                 | Type     | Required | Default | Possible Values | Description |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------- |
+| `options`            | `object` | ✅       | —       | —               |             |
+| ↳ `authenticationId` | `number` | ✅       | —       | —               |             |
+
+**Returns:** `Promise<AppProxy>`
+
+**Example:**
+
+```typescript
+const result = await sdk.apps.appKey({
+  authenticationId: 12345,
+});
+```
+
+#### `apps.{appKey}.{actionType}.{actionKey}`
+
+Execute an action with the given inputs for the bound app, as an alternative to runAction
+
+**Parameters:**
+
+| Name                 | Type     | Required | Default | Possible Values | Description |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------- |
+| `options`            | `object` | ✅       | —       | —               |             |
+| ↳ `inputs`           | `object` | ❌       | —       | —               |             |
+| ↳ `authenticationId` | `number` | ❌       | —       | —               |             |
+
+**Returns:** `Promise<PaginatedResult<ActionResultItem>>`
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: actionResults, nextCursor } =
+  await sdk.apps.appKey.actionType.actionKey();
+
+// Or iterate over all pages
+for await (const page of sdk.apps.appKey.actionType.actionKey()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const actionResult of sdk.apps.appKey.actionType
+  .actionKey()
+  .items()) {
+  // Do something with each actionResult
+}
+```
+
 #### `getApp`
 
 Get detailed information about a specific app
 
 **Parameters:**
 
-| Name       | Type     | Required | Default | Possible Values | Description                                   |
-| ---------- | -------- | -------- | ------- | --------------- | --------------------------------------------- |
-| `options`  | `string` | ✅       | —       | —               | Get detailed information about a specific app |
-| ↳ `appKey` | `string` | ✅       | —       | —               | App key of app to fetch (e.g., 'SlackCLIAPI') |
+| Name       | Type     | Required | Default | Possible Values | Description                                                         |
+| ---------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------- |
+| `options`  | `object` | ✅       | —       | —               |                                                                     |
+| ↳ `appKey` | `string` | ✅       | —       | —               | App key of app to fetch (e.g., 'SlackCLIAPI' or slug like 'github') |
 
 **Returns:** `Promise<AppItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.getApp({
-  options: "example-value",
+const { data: app } = await sdk.getApp({
   appKey: "example-key",
 });
 ```
@@ -311,20 +505,30 @@ List all available apps with optional filtering
 
 | Name         | Type     | Required | Default | Possible Values | Description                                                         |
 | ------------ | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------- |
-| `options`    | `string` | ✅       | —       | —               | List all available apps with optional filtering                     |
+| `options`    | `object` | ✅       | —       | —               |                                                                     |
 | ↳ `appKeys`  | `array`  | ❌       | —       | —               | Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github') |
 | ↳ `search`   | `string` | ❌       | —       | —               | Search for apps by name                                             |
 | ↳ `pageSize` | `number` | ❌       | —       | —               | Number of apps per page                                             |
 | ↳ `maxItems` | `number` | ❌       | —       | —               | Maximum total items to return across all pages                      |
+| ↳ `cursor`   | `string` | ❌       | —       | —               | Cursor to start from                                                |
 
 **Returns:** `Promise<PaginatedResult<AppItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.listApps({
-  options: "example-value",
-});
+// Get first page and a cursor for the second page
+const { data: apps, nextCursor } = await sdk.listApps();
+
+// Or iterate over all pages
+for await (const page of sdk.listApps()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const app of sdk.listApps().items()) {
+  // Do something with each app
+}
 ```
 
 ### Authentications
@@ -335,23 +539,21 @@ Find the first authentication matching the criteria
 
 **Parameters:**
 
-| Name          | Type     | Required | Default | Possible Values | Description                                             |
-| ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------- |
-| `options`     | `string` | ✅       | —       | —               | Find the first authentication matching the criteria     |
-| ↳ `appKey`    | `string` | ❌       | —       | —               | App key of authentication to find (e.g., 'SlackCLIAPI') |
-| ↳ `search`    | `string` | ❌       | —       | —               | Search term to filter authentications by title          |
-| ↳ `title`     | `string` | ❌       | —       | —               | Filter authentications by exact title match             |
-| ↳ `accountId` | `string` | ❌       | —       | —               | Filter by account ID                                    |
-| ↳ `owner`     | `string` | ❌       | —       | —               | Filter by owner                                         |
+| Name          | Type     | Required | Default | Possible Values | Description                                                                   |
+| ------------- | -------- | -------- | ------- | --------------- | ----------------------------------------------------------------------------- |
+| `options`     | `object` | ✅       | —       | —               |                                                                               |
+| ↳ `appKey`    | `string` | ❌       | —       | —               | App key of authentication to find (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ↳ `search`    | `string` | ❌       | —       | —               | Search term to filter authentications by title                                |
+| ↳ `title`     | `string` | ❌       | —       | —               | Filter authentications by exact title match                                   |
+| ↳ `accountId` | `string` | ❌       | —       | —               | Filter by account ID                                                          |
+| ↳ `owner`     | `string` | ❌       | —       | —               | Filter by owner                                                               |
 
 **Returns:** `Promise<AuthenticationItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.findFirstAuthentication({
-  options: "example-value",
-});
+const { data: authentication } = await sdk.findFirstAuthentication();
 ```
 
 #### `findUniqueAuthentication`
@@ -360,23 +562,21 @@ Find a unique authentication matching the criteria
 
 **Parameters:**
 
-| Name          | Type     | Required | Default | Possible Values | Description                                             |
-| ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------- |
-| `options`     | `string` | ✅       | —       | —               | Find a unique authentication matching the criteria      |
-| ↳ `appKey`    | `string` | ❌       | —       | —               | App key of authentication to find (e.g., 'SlackCLIAPI') |
-| ↳ `search`    | `string` | ❌       | —       | —               | Search term to filter authentications by title          |
-| ↳ `title`     | `string` | ❌       | —       | —               | Filter authentications by exact title match             |
-| ↳ `accountId` | `string` | ❌       | —       | —               | Filter by account ID                                    |
-| ↳ `owner`     | `string` | ❌       | —       | —               | Filter by owner                                         |
+| Name          | Type     | Required | Default | Possible Values | Description                                                                   |
+| ------------- | -------- | -------- | ------- | --------------- | ----------------------------------------------------------------------------- |
+| `options`     | `object` | ✅       | —       | —               |                                                                               |
+| ↳ `appKey`    | `string` | ❌       | —       | —               | App key of authentication to find (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ↳ `search`    | `string` | ❌       | —       | —               | Search term to filter authentications by title                                |
+| ↳ `title`     | `string` | ❌       | —       | —               | Filter authentications by exact title match                                   |
+| ↳ `accountId` | `string` | ❌       | —       | —               | Filter by account ID                                                          |
+| ↳ `owner`     | `string` | ❌       | —       | —               | Filter by owner                                                               |
 
 **Returns:** `Promise<AuthenticationItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.findUniqueAuthentication({
-  options: "example-value",
-});
+const { data: authentication } = await sdk.findUniqueAuthentication();
 ```
 
 #### `getAuthentication`
@@ -385,18 +585,17 @@ Get a specific authentication by ID
 
 **Parameters:**
 
-| Name                 | Type     | Required | Default | Possible Values | Description                         |
-| -------------------- | -------- | -------- | ------- | --------------- | ----------------------------------- |
-| `options`            | `string` | ✅       | —       | —               | Get a specific authentication by ID |
-| ↳ `authenticationId` | `number` | ✅       | —       | —               | Authentication ID to retrieve       |
+| Name                 | Type     | Required | Default | Possible Values | Description                   |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------------------------- |
+| `options`            | `object` | ✅       | —       | —               |                               |
+| ↳ `authenticationId` | `number` | ✅       | —       | —               | Authentication ID to retrieve |
 
 **Returns:** `Promise<AuthenticationItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.getAuthentication({
-  options: "example-value",
+const { data: authentication } = await sdk.getAuthentication({
   authenticationId: 12345,
 });
 ```
@@ -407,26 +606,36 @@ List available authentications with optional filtering
 
 **Parameters:**
 
-| Name                  | Type     | Required | Default | Possible Values | Description                                                              |
-| --------------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------------ |
-| `options`             | `string` | ✅       | —       | —               | List available authentications with optional filtering                   |
-| ↳ `appKey`            | `string` | ❌       | —       | —               | App key of authentications to list (e.g., 'SlackCLIAPI')                 |
-| ↳ `authenticationIds` | `array`  | ❌       | —       | —               | List of authentication IDs to filter by                                  |
-| ↳ `search`            | `string` | ❌       | —       | —               | Search term to filter authentications by title                           |
-| ↳ `title`             | `string` | ❌       | —       | —               | Filter authentications by exact title match                              |
-| ↳ `accountId`         | `string` | ❌       | —       | —               | Filter by account ID                                                     |
-| ↳ `owner`             | `string` | ❌       | —       | —               | Filter by owner, 'me' for your own authentications or a specific user ID |
-| ↳ `pageSize`          | `number` | ❌       | —       | —               | Number of authentications per page                                       |
-| ↳ `maxItems`          | `number` | ❌       | —       | —               | Maximum total items to return across all pages                           |
+| Name                  | Type     | Required | Default | Possible Values | Description                                                                    |
+| --------------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------ |
+| `options`             | `object` | ✅       | —       | —               |                                                                                |
+| ↳ `appKey`            | `string` | ❌       | —       | —               | App key of authentications to list (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ↳ `authenticationIds` | `array`  | ❌       | —       | —               | List of authentication IDs to filter by                                        |
+| ↳ `search`            | `string` | ❌       | —       | —               | Search term to filter authentications by title                                 |
+| ↳ `title`             | `string` | ❌       | —       | —               | Filter authentications by exact title match                                    |
+| ↳ `accountId`         | `string` | ❌       | —       | —               | Filter by account ID                                                           |
+| ↳ `owner`             | `string` | ❌       | —       | —               | Filter by owner, 'me' for your own authentications or a specific user ID       |
+| ↳ `pageSize`          | `number` | ❌       | —       | —               | Number of authentications per page                                             |
+| ↳ `maxItems`          | `number` | ❌       | —       | —               | Maximum total items to return across all pages                                 |
+| ↳ `cursor`            | `string` | ❌       | —       | —               | Cursor to start from                                                           |
 
 **Returns:** `Promise<PaginatedResult<AuthenticationItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.listAuthentications({
-  options: "example-value",
-});
+// Get first page and a cursor for the second page
+const { data: authentications, nextCursor } = await sdk.listAuthentications();
+
+// Or iterate over all pages
+for await (const page of sdk.listAuthentications()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const authentication of sdk.listAuthentications().items()) {
+  // Do something with each authentication
+}
 ```
 
 ### HTTP Requests
@@ -440,7 +649,7 @@ Execute fetch
 | Name                       | Type     | Required | Default | Possible Values                                            | Description                                                          |
 | -------------------------- | -------- | -------- | ------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
 | `url`                      | `string` | ✅       | —       | —                                                          | The URL to fetch                                                     |
-| `init`                     | `string` | ❌       | —       | —                                                          | Fetch options including authentication                               |
+| `init`                     | `object` | ❌       | —       | —                                                          | Fetch options including authentication                               |
 | ↳ `method`                 | `string` | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` |                                                                      |
 | ↳ `headers`                | `object` | ❌       | —       | —                                                          |                                                                      |
 | ↳ `body`                   | `string` | ❌       | —       | —                                                          |                                                                      |
@@ -453,7 +662,7 @@ Execute fetch
 **Example:**
 
 ```typescript
-const result = await sdk.fetch("https://example.com");
+const result = await sdk.fetch("https://example.com", { key: "value" });
 ```
 
 #### `request`
@@ -464,7 +673,7 @@ Make authenticated HTTP requests through Zapier's Relay service
 
 | Name                       | Type     | Required | Default | Possible Values                                            | Description                                                          |
 | -------------------------- | -------- | -------- | ------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
-| `options`                  | `string` | ✅       | —       | —                                                          | Make authenticated HTTP requests through Zapier's Relay service      |
+| `options`                  | `object` | ✅       | —       | —                                                          |                                                                      |
 | ↳ `url`                    | `string` | ✅       | —       | —                                                          | The URL to request (will be proxied through Relay)                   |
 | ↳ `method`                 | `string` | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method                                                          |
 | ↳ `body`                   | `string` | ❌       | —       | —                                                          | Request body as a string                                             |
@@ -480,7 +689,6 @@ Make authenticated HTTP requests through Zapier's Relay service
 
 ```typescript
 const result = await sdk.request({
-  options: "example-value",
   url: "https://example.com",
 });
 ```