@zapier/zapier-sdk-cli 0.62.0 → 0.64.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @zapier/zapier-sdk-cli
 
+## 0.64.0
+
+### Minor Changes
+
+- d09592b: Graduated Triggers and Trigger Inbox methods from the experimental interface to the stable one. Every trigger method (`listTriggers`, `listTriggerInputFields`, `createTriggerInbox`, `ensureTriggerInbox`, `drainTriggerInbox`, `watchTriggerInbox`, the inbox lifecycle methods, and the message lease/ack/release methods) is now available directly from `@zapier/zapier-sdk` and the `zapier-sdk` CLI — no `/experimental` import, `--experimental` flag, or `ZAPIER_EXPERIMENTAL` env var required. On the default MCP server the request/response trigger tools (`create-trigger-inbox`, `list-triggers`, the lease/ack/release tools, etc.) are now listed; the callback-driven `drainTriggerInbox` and `watchTriggerInbox` remain SDK/CLI-only. They stay available via the experimental subpath and `zapier-sdk-experimental` binary for backward compatibility.
+
+### Patch Changes
+
+- Updated dependencies [d09592b]
+  - @zapier/zapier-sdk-mcp@0.18.0
+  - @zapier/zapier-sdk@0.82.0
+
+## 0.63.0
+
+### Minor Changes
+
+- d96b5f6: Added `--callback-url` to `zapier-sdk login` and `zapier-sdk signup` for resuming pending non-interactive OAuth flows. Non-interactive login and signup now save pending state and exit immediately; run the same command later with `--callback-url <url>` to complete authentication from the browser callback URL.
+
+  Login and signup telemetry now includes `used_non_interactive_mode` and `is_headless` on CLI command and auth lifecycle events.
+
+### Patch Changes
+
+- Updated dependencies [d96b5f6]
+  - @zapier/zapier-sdk@0.81.1
+  - @zapier/zapier-sdk-mcp@0.17.1
+
 ## 0.62.0
 
 ### Minor Changes

package/README.md

@@ -68,25 +68,25 @@
   - [`list-table-records`](#list-table-records)
   - [`list-tables`](#list-tables)
   - [`update-table-records`](#update-table-records)
-- [Triggers (Experimental)](#triggers-experimental)
-  - [`ack-trigger-inbox-messages`](#ack-trigger-inbox-messages--experimental)
-  - [`create-trigger-inbox`](#create-trigger-inbox--experimental)
-  - [`delete-trigger-inbox`](#delete-trigger-inbox--experimental)
-  - [`drain-trigger-inbox`](#drain-trigger-inbox--experimental)
-  - [`ensure-trigger-inbox`](#ensure-trigger-inbox--experimental)
-  - [`get-trigger-inbox`](#get-trigger-inbox--experimental)
-  - [`get-trigger-input-fields-schema`](#get-trigger-input-fields-schema--experimental)
-  - [`lease-trigger-inbox-messages`](#lease-trigger-inbox-messages--experimental)
-  - [`list-trigger-inbox-messages`](#list-trigger-inbox-messages--experimental)
-  - [`list-trigger-inboxes`](#list-trigger-inboxes--experimental)
-  - [`list-trigger-input-field-choices`](#list-trigger-input-field-choices--experimental)
-  - [`list-trigger-input-fields`](#list-trigger-input-fields--experimental)
-  - [`list-triggers`](#list-triggers--experimental)
-  - [`pause-trigger-inbox`](#pause-trigger-inbox--experimental)
-  - [`release-trigger-inbox-messages`](#release-trigger-inbox-messages--experimental)
-  - [`resume-trigger-inbox`](#resume-trigger-inbox--experimental)
-  - [`update-trigger-inbox`](#update-trigger-inbox--experimental)
-  - [`watch-trigger-inbox`](#watch-trigger-inbox--experimental)
+- [Triggers](#triggers)
+  - [`ack-trigger-inbox-messages`](#ack-trigger-inbox-messages)
+  - [`create-trigger-inbox`](#create-trigger-inbox)
+  - [`delete-trigger-inbox`](#delete-trigger-inbox)
+  - [`drain-trigger-inbox`](#drain-trigger-inbox)
+  - [`ensure-trigger-inbox`](#ensure-trigger-inbox)
+  - [`get-trigger-inbox`](#get-trigger-inbox)
+  - [`get-trigger-input-fields-schema`](#get-trigger-input-fields-schema)
+  - [`lease-trigger-inbox-messages`](#lease-trigger-inbox-messages)
+  - [`list-trigger-inbox-messages`](#list-trigger-inbox-messages)
+  - [`list-trigger-inboxes`](#list-trigger-inboxes)
+  - [`list-trigger-input-field-choices`](#list-trigger-input-field-choices)
+  - [`list-trigger-input-fields`](#list-trigger-input-fields)
+  - [`list-triggers`](#list-triggers)
+  - [`pause-trigger-inbox`](#pause-trigger-inbox)
+  - [`release-trigger-inbox-messages`](#release-trigger-inbox-messages)
+  - [`resume-trigger-inbox`](#resume-trigger-inbox)
+  - [`update-trigger-inbox`](#update-trigger-inbox)
+  - [`watch-trigger-inbox`](#watch-trigger-inbox)
 - [Utilities](#utilities)
   - [`add`](#add)
   - [`build-manifest`](#build-manifest)
@@ -209,11 +209,12 @@ Log in to Zapier to access your account
 | `--use-approvals`   | `boolean` | ❌       | —       | —               | Require approvals for actions performed with these credentials                                                                                                                             |
 | `--non-interactive` | `boolean` | ❌       | —       | —               | Skip interactive prompts. Uses defaults where possible; errors instead of prompting when input is required. Useful in CI, piped output, or environments where TTY detection is unreliable. |
 | `--headless`        | `boolean` | ❌       | —       | —               | Use when logging in from a machine that has no browser. Prints a login link to open elsewhere, then accepts the pasted loopback callback URL.                                              |
+| `--callback-url`    | `string`  | ❌       | —       | —               | Resume a pending non-interactive login with the final OAuth callback URL from your browser.                                                                                                |
 
 **Usage:**
 
 ```bash
-npx zapier-sdk login [--name] [--timeout] [--use-approvals] [--non-interactive] [--headless]
+npx zapier-sdk login [--name] [--timeout] [--use-approvals] [--non-interactive] [--headless] [--callback-url]
 ```
 
 #### `logout`
@@ -238,11 +239,12 @@ Set up Zapier account access and SDK credentials
 | `--use-approvals`   | `boolean` | ❌       | —       | —               | Require approvals for actions performed with these credentials                                                                                                                             |
 | `--non-interactive` | `boolean` | ❌       | —       | —               | Skip interactive prompts. Uses defaults where possible; errors instead of prompting when input is required. Useful in CI, piped output, or environments where TTY detection is unreliable. |
 | `--headless`        | `boolean` | ❌       | —       | —               | Use when signing up from a machine that has no browser. Prints a signup link to open elsewhere, then accepts the pasted loopback callback URL.                                             |
+| `--callback-url`    | `string`  | ❌       | —       | —               | Resume a pending non-interactive signup with the final OAuth callback URL from your browser.                                                                                               |
 
 **Usage:**
 
 ```bash
-npx zapier-sdk signup [--timeout] [--use-approvals] [--non-interactive] [--headless]
+npx zapier-sdk signup [--timeout] [--use-approvals] [--non-interactive] [--headless] [--callback-url]
 ```
 
 ### Actions
@@ -1225,11 +1227,9 @@ Update one or more records in a table
 npx zapier-sdk update-table-records <table> <records> [--key-mode]
 ```
 
-### Triggers (Experimental)
+### Triggers
 
-> ℹ️ **Experimental.** Run commands via the `zapier-sdk-experimental` binary, pass `--experimental` to `zapier-sdk`, or set `ZAPIER_EXPERIMENTAL=true` in the environment. Flags and behavior may change between versions.
-
-#### `ack-trigger-inbox-messages` 🧪 _experimental_
+#### `ack-trigger-inbox-messages`
 
 Acknowledge messages from a lease. Acked messages are removed from the inbox; unacked ones return to the available pool when the lease expires.
 
@@ -1247,7 +1247,7 @@ Acknowledge messages from a lease. Acked messages are removed from the inbox; un
 npx zapier-sdk ack-trigger-inbox-messages <inbox> <lease> [--messages]
 ```
 
-#### `create-trigger-inbox` 🧪 _experimental_
+#### `create-trigger-inbox`
 
 Create a new trigger inbox subscription. Always creates a new inbox; use ensureTriggerInbox for get-or-create on a stable key.
 
@@ -1268,7 +1268,7 @@ Create a new trigger inbox subscription. Always creates a new inbox; use ensureT
 npx zapier-sdk create-trigger-inbox <app> <action> [--key] [--connection] [--inputs] [--notification-url]
 ```
 
-#### `delete-trigger-inbox` 🧪 _experimental_
+#### `delete-trigger-inbox`
 
 Mark a trigger inbox for deletion
 
@@ -1284,7 +1284,7 @@ Mark a trigger inbox for deletion
 npx zapier-sdk delete-trigger-inbox <inbox>
 ```
 
-#### `drain-trigger-inbox` 🧪 _experimental_
+#### `drain-trigger-inbox`
 
 Drain an existing trigger inbox: lease currently-available messages, process each via onMessage, return when the inbox is empty, maxMessages is reached, or the abort signal fires.
 
@@ -1309,7 +1309,7 @@ Drain an existing trigger inbox: lease currently-available messages, process eac
 npx zapier-sdk drain-trigger-inbox <inbox> [--concurrency] [--lease-limit] [--lease-seconds] [--release-on-error] [--continue-on-error] [--max-messages] [--exec] [--exec-shell] [--json]
 ```
 
-#### `ensure-trigger-inbox` 🧪 _experimental_
+#### `ensure-trigger-inbox`
 
 Get-or-create a trigger inbox by key. Idempotent on (user, account, key): returns the existing inbox if a matching subscription is registered, creates a new one otherwise. Throws ZapierConflictError if the key exists with a different subscription.
 
@@ -1330,7 +1330,7 @@ Get-or-create a trigger inbox by key. Idempotent on (user, account, key): return
 npx zapier-sdk ensure-trigger-inbox <key> <app> <action> [--connection] [--inputs] [--notification-url]
 ```
 
-#### `get-trigger-inbox` 🧪 _experimental_
+#### `get-trigger-inbox`
 
 Get details of a trigger inbox by ID
 
@@ -1346,7 +1346,7 @@ Get details of a trigger inbox by ID
 npx zapier-sdk get-trigger-inbox <inbox>
 ```
 
-#### `get-trigger-input-fields-schema` 🧪 _experimental_
+#### `get-trigger-input-fields-schema`
 
 Get the JSON Schema representation of input fields for a trigger. Returns a JSON Schema object describing the structure, types, and validation rules for the trigger's input parameters.
 
@@ -1365,7 +1365,7 @@ Get the JSON Schema representation of input fields for a trigger. Returns a JSON
 npx zapier-sdk get-trigger-input-fields-schema <app> <action> [--connection] [--inputs]
 ```
 
-#### `lease-trigger-inbox-messages` 🧪 _experimental_
+#### `lease-trigger-inbox-messages`
 
 Lease up to N messages from a trigger inbox. Returns messages plus a lease ID; ack within the lease window to remove from the inbox.
 
@@ -1383,7 +1383,7 @@ Lease up to N messages from a trigger inbox. Returns messages plus a lease ID; a
 npx zapier-sdk lease-trigger-inbox-messages <inbox> [--lease-limit] [--lease-seconds]
 ```
 
-#### `list-trigger-inbox-messages` 🧪 _experimental_
+#### `list-trigger-inbox-messages`
 
 List messages in a trigger inbox (no payload, status-only)
 
@@ -1402,7 +1402,7 @@ List messages in a trigger inbox (no payload, status-only)
 npx zapier-sdk list-trigger-inbox-messages <inbox> [--page-size] [--max-items] [--cursor]
 ```
 
-#### `list-trigger-inboxes` 🧪 _experimental_
+#### `list-trigger-inboxes`
 
 List all trigger inboxes for the authenticated user
 
@@ -1422,7 +1422,7 @@ List all trigger inboxes for the authenticated user
 npx zapier-sdk list-trigger-inboxes [--key] [--status] [--page-size] [--max-items] [--cursor]
 ```
 
-#### `list-trigger-input-field-choices` 🧪 _experimental_
+#### `list-trigger-input-field-choices`
 
 Get the available choices for a dynamic dropdown input field on a trigger
 
@@ -1446,7 +1446,7 @@ Get the available choices for a dynamic dropdown input field on a trigger
 npx zapier-sdk list-trigger-input-field-choices <app> <action> <input-field> [--connection] [--inputs] [--page] [--page-size] [--max-items] [--cursor]
 ```
 
-#### `list-trigger-input-fields` 🧪 _experimental_
+#### `list-trigger-input-fields`
 
 Get the input fields required for a specific trigger
 
@@ -1468,7 +1468,7 @@ Get the input fields required for a specific trigger
 npx zapier-sdk list-trigger-input-fields <app> <action> [--connection] [--inputs] [--page-size] [--max-items] [--cursor]
 ```
 
-#### `list-triggers` 🧪 _experimental_
+#### `list-triggers`
 
 List all triggers for a specific app
 
@@ -1487,7 +1487,7 @@ List all triggers for a specific app
 npx zapier-sdk list-triggers <app> [--page-size] [--max-items] [--cursor]
 ```
 
-#### `pause-trigger-inbox` 🧪 _experimental_
+#### `pause-trigger-inbox`
 
 Pause a trigger inbox; events stop being collected
 
@@ -1503,7 +1503,7 @@ Pause a trigger inbox; events stop being collected
 npx zapier-sdk pause-trigger-inbox <inbox>
 ```
 
-#### `release-trigger-inbox-messages` 🧪 _experimental_
+#### `release-trigger-inbox-messages`
 
 Release messages from a lease back to the inbox without acknowledging them. Released messages become immediately available for re-leasing. The lease attempt still counts against the per-message lease limit; releasing does not refund the attempt.
 
@@ -1521,7 +1521,7 @@ Release messages from a lease back to the inbox without acknowledging them. Rele
 npx zapier-sdk release-trigger-inbox-messages <inbox> <lease> [--messages]
 ```
 
-#### `resume-trigger-inbox` 🧪 _experimental_
+#### `resume-trigger-inbox`
 
 Resume a paused trigger inbox; events resume being collected
 
@@ -1537,7 +1537,7 @@ Resume a paused trigger inbox; events resume being collected
 npx zapier-sdk resume-trigger-inbox <inbox>
 ```
 
-#### `update-trigger-inbox` 🧪 _experimental_
+#### `update-trigger-inbox`
 
 Update settings on an existing trigger inbox
 
@@ -1554,7 +1554,7 @@ Update settings on an existing trigger inbox
 npx zapier-sdk update-trigger-inbox <inbox> [--notification-url]
 ```
 
-#### `watch-trigger-inbox` 🧪 _experimental_
+#### `watch-trigger-inbox`
 
 Continuously consume a trigger inbox: drain currently-available messages via onMessage, then subscribe to SSE notifications for new arrivals until aborted. A periodic safety drain runs every maxDrainIntervalSeconds (default: 300) to guarantee forward progress if SSE events are missed. Resolves cleanly on signal abort or ZapierAbortDrainSignal from a handler. Transient drain failures (5xx, 429, network blips) retry indefinitely with bounded backoff until they succeed or the watch is aborted; it rejects on a fail-fast handler error, an initialization_failure, or a permanent HTTP error. Real-time wake-up health is reported on stderr: a warning when wake-ups pause and the watch falls back to the safety drain, plus (with debug) transient reconnect notices. Persistent drain failures likewise warn once on stderr while bounded-backoff retries continue. stdout (including --json NDJSON) is unaffected.