@zapier/zapier-sdk 0.108.0 → 0.109.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @zapier/zapier-sdk
 
+## 0.109.0
+
+### Minor Changes
+
+- f56765a: Deprecated `createZapierApi` and `getOrCreateApiClient` in favor of building an SDK with `createSdk` and accessing `apiPluginRef` with `resolvePlugin`. Both functions continue to work with a once-per-process warning.
+
+### Patch Changes
+
+- f56765a: `createZapierSdk({ cache })` now uses the caller-supplied cache for client-credentials access tokens instead of silently falling back to the default cache (the CLI's filesystem and keychain cache when installed, otherwise in-memory).
+
+## 0.108.1
+
+### Patch Changes
+
+- 47a61ba: `listConnections` and `waitForNewConnection` now:
+  - Raise a `ZapierValidationError` (`ZAPIER_VALIDATION_ERROR`) when a response or
+    connection row doesn't match the expected shape; previously the list path
+    did not validate rows. `waitForNewConnection` surfaces it on the first
+    malformed successful response — any number of pending responses may precede
+    it — rather than after exhausting its poll retries.
+  - Preserve error status codes and messages. Previously, some 4xx messages were
+    replaced with generic text and some 5xx responses were reported as generic
+    502 errors.
+  - Match an `app` filter with an explicit version (e.g. `"github@1.2.3"`) even
+    when it can't be resolved through the manifest, instead of failing to match
+    anything.
+
+  `waitForNewConnection` now checks the most recently created connection.
+  Previously the row it checked was not the newest, so it could keep waiting past
+  a connection that had already been created, or settle on a different one.
+
+  `ApiClient.poll` now propagates a throw from a caller's `isPending` or
+  `resultExtractor` unchanged and stops polling, instead of retrying it three
+  times and rebranding it as a JSON parse failure. Return `true` from `isPending`
+  to keep polling; throw only to abandon the poll. An unreadable response body
+  still retries, now reported as "Poll response body was not valid JSON".
+  Consecutive HTTP error responses that exhaust polling retries now preserve
+  the upstream status code and are no longer counted and wrapped twice.
+
+  Output is unchanged for conforming responses.
+
 ## 0.108.0
 
 ### Minor Changes

package/README.md

@@ -2854,7 +2854,7 @@ for await (const connection of zapier.listConnections().items()) {
 
 #### `waitForNewConnection`
 
-Wait for a new connection to appear for the given app. Polls `/api/v0/connections` with server-side `ordering=-date` until the most recent matching row's `date` is at or after the started-at timestamp, then returns it. Pair with `get-connection-start-url` — that mints the URL the user opens, this waits for the resulting connection to land. Errors with a timeout after the configured timeout (default 5 min). Example (JS):
+Wait for a new connection to appear for the given app. Polls the connections list newest-first until the most recent matching row's `date` is at or after the started-at timestamp, then returns it. Pair with `get-connection-start-url` — that mints the URL the user opens, this waits for the resulting connection to land. Errors with a timeout after the configured timeout (default 5 min). Example (JS):
 
 ```ts
 const {