@zapier/zapier-sdk 0.81.1 → 0.82.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.82.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.
+
 ## 0.81.1
 
 ### Patch Changes

package/README.md

@@ -68,25 +68,25 @@
   - [`listTableRecords`](#listtablerecords)
   - [`listTables`](#listtables)
   - [`updateTableRecords`](#updatetablerecords)
-- [Triggers (Experimental)](#triggers-experimental)
-  - [`ackTriggerInboxMessages`](#acktriggerinboxmessages--experimental)
-  - [`createTriggerInbox`](#createtriggerinbox--experimental)
-  - [`deleteTriggerInbox`](#deletetriggerinbox--experimental)
-  - [`drainTriggerInbox`](#draintriggerinbox--experimental)
-  - [`ensureTriggerInbox`](#ensuretriggerinbox--experimental)
-  - [`getTriggerInbox`](#gettriggerinbox--experimental)
-  - [`getTriggerInputFieldsSchema`](#gettriggerinputfieldsschema--experimental)
-  - [`leaseTriggerInboxMessages`](#leasetriggerinboxmessages--experimental)
-  - [`listTriggerInboxMessages`](#listtriggerinboxmessages--experimental)
-  - [`listTriggerInboxes`](#listtriggerinboxes--experimental)
-  - [`listTriggerInputFieldChoices`](#listtriggerinputfieldchoices--experimental)
-  - [`listTriggerInputFields`](#listtriggerinputfields--experimental)
-  - [`listTriggers`](#listtriggers--experimental)
-  - [`pauseTriggerInbox`](#pausetriggerinbox--experimental)
-  - [`releaseTriggerInboxMessages`](#releasetriggerinboxmessages--experimental)
-  - [`resumeTriggerInbox`](#resumetriggerinbox--experimental)
-  - [`updateTriggerInbox`](#updatetriggerinbox--experimental)
-  - [`watchTriggerInbox`](#watchtriggerinbox--experimental)
+- [Triggers](#triggers)
+  - [`ackTriggerInboxMessages`](#acktriggerinboxmessages)
+  - [`createTriggerInbox`](#createtriggerinbox)
+  - [`deleteTriggerInbox`](#deletetriggerinbox)
+  - [`drainTriggerInbox`](#draintriggerinbox)
+  - [`ensureTriggerInbox`](#ensuretriggerinbox)
+  - [`getTriggerInbox`](#gettriggerinbox)
+  - [`getTriggerInputFieldsSchema`](#gettriggerinputfieldsschema)
+  - [`leaseTriggerInboxMessages`](#leasetriggerinboxmessages)
+  - [`listTriggerInboxMessages`](#listtriggerinboxmessages)
+  - [`listTriggerInboxes`](#listtriggerinboxes)
+  - [`listTriggerInputFieldChoices`](#listtriggerinputfieldchoices)
+  - [`listTriggerInputFields`](#listtriggerinputfields)
+  - [`listTriggers`](#listtriggers)
+  - [`pauseTriggerInbox`](#pausetriggerinbox)
+  - [`releaseTriggerInboxMessages`](#releasetriggerinboxmessages)
+  - [`resumeTriggerInbox`](#resumetriggerinbox)
+  - [`updateTriggerInbox`](#updatetriggerinbox)
+  - [`watchTriggerInbox`](#watchtriggerinbox)
 
 ## Documentation
 
@@ -2641,11 +2641,9 @@ const result = await zapier.updateTableRecords({
 });
 ```
 
-### Triggers (Experimental)
+### Triggers
 
-> ℹ️ **Experimental.** Import from `"@zapier/zapier-sdk/experimental"` to use these methods. Methods and behavior may change.
-
-#### `ackTriggerInboxMessages` 🧪 _experimental_
+#### `ackTriggerInboxMessages`
 
 Acknowledge messages from a lease. Acked messages are removed from the inbox; unacked ones return to the available pool when the lease expires.
 
@@ -2682,7 +2680,7 @@ const result = await zapier.ackTriggerInboxMessages({
 });
 ```
 
-#### `createTriggerInbox` 🧪 _experimental_
+#### `createTriggerInbox`
 
 Create a new trigger inbox subscription. Always creates a new inbox; use ensureTriggerInbox for get-or-create on a stable key.
 
@@ -2725,7 +2723,7 @@ const result = await zapier.createTriggerInbox({
 });
 ```
 
-#### `deleteTriggerInbox` 🧪 _experimental_
+#### `deleteTriggerInbox`
 
 Mark a trigger inbox for deletion
 
@@ -2762,7 +2760,7 @@ const result = await zapier.deleteTriggerInbox({
 });
 ```
 
-#### `drainTriggerInbox` 🧪 _experimental_
+#### `drainTriggerInbox`
 
 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.
 
@@ -2795,7 +2793,7 @@ const result = await zapier.drainTriggerInbox({
 });
 ```
 
-#### `ensureTriggerInbox` 🧪 _experimental_
+#### `ensureTriggerInbox`
 
 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.
 
@@ -2839,7 +2837,7 @@ const result = await zapier.ensureTriggerInbox({
 });
 ```
 
-#### `getTriggerInbox` 🧪 _experimental_
+#### `getTriggerInbox`
 
 Get details of a trigger inbox by ID
 
@@ -2876,7 +2874,7 @@ const { data: triggerInbox } = await zapier.getTriggerInbox({
 });
 ```
 
-#### `getTriggerInputFieldsSchema` 🧪 _experimental_
+#### `getTriggerInputFieldsSchema`
 
 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.
 
@@ -2901,7 +2899,7 @@ const result = await zapier.getTriggerInputFieldsSchema({
 });
 ```
 
-#### `leaseTriggerInboxMessages` 🧪 _experimental_
+#### `leaseTriggerInboxMessages`
 
 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.
 
@@ -2943,7 +2941,7 @@ const result = await zapier.leaseTriggerInboxMessages({
 });
 ```
 
-#### `listTriggerInboxMessages` 🧪 _experimental_
+#### `listTriggerInboxMessages`
 
 List messages in a trigger inbox (no payload, status-only)
 
@@ -2997,7 +2995,7 @@ for await (const triggerMessage of zapier
 }
 ```
 
-#### `listTriggerInboxes` 🧪 _experimental_
+#### `listTriggerInboxes`
 
 List all trigger inboxes for the authenticated user
 
@@ -3048,7 +3046,7 @@ for await (const triggerInbox of zapier.listTriggerInboxes().items()) {
 }
 ```
 
-#### `listTriggerInputFieldChoices` 🧪 _experimental_
+#### `listTriggerInputFieldChoices`
 
 Get the available choices for a dynamic dropdown input field on a trigger
 
@@ -3110,7 +3108,7 @@ for await (const inputFieldChoice of zapier
 }
 ```
 
-#### `listTriggerInputFields` 🧪 _experimental_
+#### `listTriggerInputFields`
 
 Get the input fields required for a specific trigger
 
@@ -3198,7 +3196,7 @@ for await (const rootField of zapier
 }
 ```
 
-#### `listTriggers` 🧪 _experimental_
+#### `listTriggers`
 
 List all triggers for a specific app
 
@@ -3254,7 +3252,7 @@ for await (const action of zapier
 }
 ```
 
-#### `pauseTriggerInbox` 🧪 _experimental_
+#### `pauseTriggerInbox`
 
 Pause a trigger inbox; events stop being collected
 
@@ -3291,7 +3289,7 @@ const result = await zapier.pauseTriggerInbox({
 });
 ```
 
-#### `releaseTriggerInboxMessages` 🧪 _experimental_
+#### `releaseTriggerInboxMessages`
 
 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.
 
@@ -3328,7 +3326,7 @@ const result = await zapier.releaseTriggerInboxMessages({
 });
 ```
 
-#### `resumeTriggerInbox` 🧪 _experimental_
+#### `resumeTriggerInbox`
 
 Resume a paused trigger inbox; events resume being collected
 
@@ -3365,7 +3363,7 @@ const result = await zapier.resumeTriggerInbox({
 });
 ```
 
-#### `updateTriggerInbox` 🧪 _experimental_
+#### `updateTriggerInbox`
 
 Update settings on an existing trigger inbox
 
@@ -3403,7 +3401,7 @@ const result = await zapier.updateTriggerInbox({
 });
 ```
 
-#### `watchTriggerInbox` 🧪 _experimental_
+#### `watchTriggerInbox`
 
 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.