@zapier/zapier-sdk 0.69.3 → 0.70.0

package/dist/index.cjs

@@ -6488,13 +6488,16 @@ async function exchangeClientCredentials(options) {
       },
       timestamp: Date.now()
     });
-    throw new Error(
-      `Client credentials exchange failed: ${response.status} ${response.statusText}`
+    throw new ZapierAuthenticationError(
+      `Client credentials exchange failed: ${response.status} ${response.statusText}`,
+      { statusCode: response.status }
     );
   }
   const data = await response.json();
   if (!data.access_token) {
-    throw new Error("Client credentials response missing access_token");
+    throw new ZapierAuthenticationError(
+      "Client credentials response missing access_token"
+    );
   }
   onEvent?.({
     type: "auth_success",
@@ -6717,6 +6720,17 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/api/sse-parser.ts
+async function* jsonFrames(source) {
+  for await (const { data } of source) {
+    let frame;
+    try {
+      frame = { parsed: true, data: JSON.parse(data), raw: data };
+    } catch {
+      frame = { parsed: false, data: null, raw: data };
+    }
+    yield frame;
+  }
+}
 function createSseParserStream() {
   let buffer = "";
   let data = "";
@@ -6764,7 +6778,7 @@ function createSseParserStream() {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.69.3" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.70.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -7139,6 +7153,15 @@ var ZapierApiClient = class {
      * never pins a slot — see `withSemaphore`.
      */
     this.fetchStream = (path, init) => this.streamSse(path, init);
+    /**
+     * Like `fetchStream`, but parses each frame's `data` as JSON. Diverges from
+     * `fetchJson` deliberately: that throws on invalid JSON, but a long-lived
+     * stream must survive a single malformed frame, so a parse failure is yielded
+     * as `{ parsed: false, data: null, raw }` rather than thrown. A non-ok
+     * response still throws the shared `ZapierError` (from `fetchStream`, before
+     * any frame), so transport / auth failures surface as usual.
+     */
+    this.fetchJsonStream = (path, init) => jsonFrames(this.fetchStream(path, init));
     this.get = async (path, options = {}) => {
       return this.fetchJson("GET", path, void 0, options);
     };
@@ -7704,7 +7727,11 @@ var createZapierApi = (options) => {
 
 // src/api/error-classification.ts
 function isPermanentHttpError(err) {
-  const statusCode = err instanceof ZapierError ? err.statusCode : void 0;
+  if (!(err instanceof ZapierError)) return false;
+  if (err instanceof ZapierAuthenticationError && err.statusCode === void 0) {
+    return true;
+  }
+  const { statusCode } = err;
   return statusCode !== void 0 && statusCode >= 400 && statusCode < 500 && statusCode !== 429;
 }
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { x as Action, f as ActionEntry, cb as ActionExecutionOptions, I as ActionExecutionResult, J as ActionField, K as ActionFieldChoice, aP as ActionItem, bp as ActionKeyProperty, aZ as ActionKeyPropertySchema, bq as ActionProperty, a_ as ActionPropertySchema, aE as ActionResolverItem, bB as ActionTimeoutMsProperty, b9 as ActionTimeoutMsPropertySchema, aF as ActionTypeItem, bo as ActionTypeProperty, aY as ActionTypePropertySchema, d as AddActionEntryOptions, e as AddActionEntryResult, A as ApiClient, c7 as ApiError, dB as ApiEvent, cV as ApiPluginOptions, cX as ApiPluginProvides, y as App, cc as AppFactoryInput, aN as AppItem, bm as AppKeyProperty, aW as AppKeyPropertySchema, bn as AppProperty, aX as AppPropertySchema, eK as ApplicationLifecycleEventData, c3 as ApprovalStatus, ca as AppsPluginProvides, bG as AppsProperty, be as AppsPropertySchema, a5 as ArrayResolver, dA as AuthEvent, bu as AuthenticationIdProperty, b1 as AuthenticationIdPropertySchema, eS as BaseEvent, as as BaseSdkOptionsSchema, ag as BatchOptions, cI as CONTEXT_CACHE_MAX_SIZE, cH as CONTEXT_CACHE_TTL_MS, aw as CORE_ERROR_SYMBOL, H as Choice, dH as ClientCredentialsObject, dS as ClientCredentialsObjectSchema, V as Connection, d_ as ConnectionEntry, dZ as ConnectionEntrySchema, bs as ConnectionIdProperty, b0 as ConnectionIdPropertySchema, aO as ConnectionItem, bt as ConnectionProperty, b2 as ConnectionPropertySchema, e0 as ConnectionsMap, d$ as ConnectionsMapSchema, e2 as ConnectionsPluginProvides, bI as ConnectionsProperty, bg as ConnectionsPropertySchema, X as ConnectionsResponse, ax as CoreErrorCode, cu as CreateClientCredentialsPluginProvides, es as CreateTableFieldsPluginProvides, em as CreateTablePluginProvides, eA as CreateTableRecordsPluginProvides, dE as Credentials, dX as CredentialsFunction, dW as CredentialsFunctionSchema, dG as CredentialsObject, dU as CredentialsObjectSchema, dY as CredentialsSchema, e7 as DEFAULT_ACTION_TIMEOUT_MS, ef as DEFAULT_APPROVAL_TIMEOUT_MS, cR as DEFAULT_CONFIG_PATH, eg as DEFAULT_MAX_APPROVAL_RETRIES, e6 as DEFAULT_PAGE_SIZE, bz as DebugProperty, b7 as DebugPropertySchema, cw as DeleteClientCredentialsPluginProvides, eu as DeleteTableFieldsPluginProvides, eo as DeleteTablePluginProvides, eC as DeleteTableRecordsPluginProvides, s as DrainTriggerInboxCallback, t as DrainTriggerInboxErrorObserver, D as DrainTriggerInboxOptions, a8 as DynamicListResolver, l as DynamicResolver, a9 as DynamicSearchResolver, eL as EnhancedErrorEventData, bO as ErrorOptions, dD as EventCallback, eJ as EventContext, eG as EventEmissionConfig, E as EventEmissionContext, eI as EventEmissionProvides, ce as FetchPluginProvides, z as Field, bF as FieldsProperty, bd as FieldsPropertySchema, aa as FieldsResolver, F as FieldsetItem, v as FindFirstAuthenticationPluginProvides, cE as FindFirstConnectionPluginProvides, w as FindUniqueAuthenticationPluginProvides, cG as FindUniqueConnectionPluginProvides, a3 as FormattedItem, ar as FunctionDeprecation, aq as FunctionRegistryEntry, co as GetActionInputFieldsSchemaPluginProvides, cA as GetActionPluginProvides, cy as GetAppPluginProvides, G as GetAuthenticationPluginProvides, cC as GetConnectionPluginProvides, cU as GetProfilePluginProvides, ek as GetTablePluginProvides, ew as GetTableRecordPluginProvides, aR as InfoFieldItem, aQ as InputFieldItem, br as InputFieldProperty, a$ as InputFieldPropertySchema, bv as InputsProperty, b3 as InputsPropertySchema, bN as LeaseLimitProperty, bl as LeaseLimitPropertySchema, bL as LeaseProperty, bj as LeasePropertySchema, bM as LeaseSecondsProperty, bk as LeaseSecondsPropertySchema, L as LeasedTriggerMessageItem, bw as LimitProperty, b4 as LimitPropertySchema, cm as ListActionInputFieldChoicesPluginProvides, ck as ListActionInputFieldsPluginProvides, ci as ListActionsPluginProvides, cg as ListAppsPluginProvides, u as ListAuthenticationsPluginProvides, cs as ListClientCredentialsPluginProvides, cq as ListConnectionsPluginProvides, eq as ListTableFieldsPluginProvides, ey as ListTableRecordsPluginProvides, ei as ListTablesPluginProvides, dC as LoadingEvent, ea as MAX_CONCURRENCY_LIMIT, e5 as MAX_PAGE_LIMIT, b as Manifest, cS as ManifestEntry, cN as ManifestPluginOptions, cQ as ManifestPluginProvides, eT as MethodCalledEvent, eM as MethodCalledEventData, N as Need, Q as NeedsRequest, S as NeedsResponse, bx as OffsetProperty, b5 as OffsetPropertySchema, O as OutputFormatter, by as OutputProperty, b6 as OutputPropertySchema, aV as PaginatedSdkFunction, i as PaginatedSdkResult, bA as ParamsProperty, b8 as ParamsPropertySchema, dI as PkceCredentialsObject, dT as PkceCredentialsObjectSchema, ay as Plugin, a as PluginMeta, az as PluginProvides, aI as PollOptions, j as PositionalMetadata, c1 as RateLimitInfo, bD as RecordProperty, bb as RecordPropertySchema, bE as RecordsProperty, bc as RecordsPropertySchema, al as RelayFetchSchema, ak as RelayRequestSchema, aH as RequestOptions, cM as RequestPluginProvides, dm as ResolveAuthTokenOptions, dN as ResolveCredentialsOptions, R as ResolvedAppLocator, dF as ResolvedCredentials, dV as ResolvedCredentialsSchema, a4 as Resolver, a6 as ResolverMetadata, aS as RootFieldItem, cK as RunActionPluginProvides, dz as SdkEvent, aU as SdkPage, aM as SseMessage, a7 as StaticResolver, bC as TableProperty, ba as TablePropertySchema, bH as TablesProperty, bf as TablesPropertySchema, bK as TriggerInboxNameProperty, bi as TriggerInboxNamePropertySchema, bJ as TriggerInboxProperty, bh as TriggerInboxPropertySchema, T as TriggerMessageStatus, U as UpdateManifestEntryOptions, c as UpdateManifestEntryResult, eE as UpdateTableRecordsPluginProvides, Y as UserProfile, aT as UserProfileItem, W as WatchTriggerInboxOptions, o as WithAddPlugin, e3 as ZAPIER_BASE_URL, ec as ZAPIER_MAX_CONCURRENT_REQUESTS, e8 as ZAPIER_MAX_NETWORK_RETRIES, e9 as ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, p as ZapierAbortDrainSignal, b$ as ZapierActionError, bU as ZapierApiError, bV as ZapierAppNotFoundError, c4 as ZapierApprovalError, bS as ZapierAuthenticationError, bZ as ZapierBundleError, dv as ZapierCache, dw as ZapierCacheEntry, dx as ZapierCacheSetOptions, bY as ZapierConfigurationError, c0 as ZapierConflictError, bP as ZapierError, k as ZapierFetchInitOptions, bW as ZapierNotFoundError, c2 as ZapierRateLimitError, c5 as ZapierRelayError, q as ZapierReleaseTriggerMessageSignal, bX as ZapierResourceNotFoundError, f3 as ZapierSdk, n as ZapierSdkApps, Z as ZapierSdkOptions, c8 as ZapierSignal, b_ as ZapierTimeoutError, bR as ZapierUnknownError, bQ as ZapierValidationError, c_ as actionKeyResolver, cZ as actionTypeResolver, a2 as addPlugin, cW as apiPlugin, cY as appKeyResolver, c9 as appsPlugin, d0 as authenticationIdGenericResolver, c$ as authenticationIdResolver, af as batch, eN as buildApplicationLifecycleEvent, ah as buildCapabilityMessage, eP as buildErrorEvent, eO as buildErrorEventWithContext, eR as buildMethodCalledEvent, eF as cleanupEventListeners, dn as clearTokenCache, d4 as clientCredentialsNameResolver, d5 as clientIdResolver, aD as composePlugins, d0 as connectionIdGenericResolver, c$ as connectionIdResolver, e1 as connectionsPlugin, eQ as createBaseEvent, ct as createClientCredentialsPlugin, a1 as createCorePlugin, $ as createFunction, dy as createMemoryCache, ao as createOptionsPlugin, aC as createPaginatedPluginMethod, aB as createPluginMethod, a0 as createPluginStack, an as createSdk, er as createTableFieldsPlugin, el as createTablePlugin, ez as createTableRecordsPlugin, aJ as createZapierApi, ap as createZapierCoreStack, f1 as createZapierSdk, f2 as createZapierSdkStack, am as createZapierSdkWithoutRegistry, aA as definePlugin, cv as deleteClientCredentialsPlugin, et as deleteTableFieldsPlugin, en as deleteTablePlugin, eB as deleteTableRecordsPlugin, d9 as durableRunIdResolver, eH as eventEmissionPlugin, cd as fetchPlugin, cD as findFirstConnectionPlugin, g as findManifestEntry, cF as findUniqueConnectionPlugin, c6 as formatErrorMessage, eU as generateEventId, cn as getActionInputFieldsSchemaPlugin, cz as getActionPlugin, cx as getAppPlugin, dQ as getBaseUrlFromCredentials, e_ as getCiPlatform, dR as getClientIdFromCredentials, cB as getConnectionPlugin, av as getCoreErrorCause, au as getCoreErrorCode, f0 as getCpuTime, eV as getCurrentTimestamp, e$ as getMemoryUsage, aK as getOrCreateApiClient, eX as getOsInfo, eY as getPlatformVersions, cO as getPreferredManifestEntryKey, cT as getProfilePlugin, eW as getReleaseId, ej as getTablePlugin, ev as getTableRecordPlugin, ds as getTokenFromCliLogin, ed as getZapierApprovalMode, ee as getZapierDefaultApprovalMode, e4 as getZapierSdkService, dq as injectCliLogin, d3 as inputFieldKeyResolver, d2 as inputsAllOptionalResolver, d1 as inputsResolver, dp as invalidateCachedToken, du as invalidateCredentialsToken, eZ as isCi, dr as isCliLoginAvailable, dJ as isClientCredentials, at as isCoreError, dM as isCredentialsFunction, dL as isCredentialsObject, aL as isPermanentHttpError, dK as isPkceCredentials, _ as isPositional, cl as listActionInputFieldChoicesPlugin, cj as listActionInputFieldsPlugin, ch as listActionsPlugin, cf as listAppsPlugin, cr as listClientCredentialsPlugin, cp as listConnectionsPlugin, ep as listTableFieldsPlugin, ex as listTableRecordsPlugin, eh as listTablesPlugin, ai as logDeprecation, cP as manifestPlugin, eb as parseConcurrencyEnvVar, r as readManifestFromFile, aG as registryPlugin, cL as requestPlugin, aj as resetDeprecationWarnings, dt as resolveAuthToken, dP as resolveCredentials, dO as resolveCredentialsFromEnv, cJ as runActionPlugin, ab as runInMethodScope, ac as runWithTelemetryContext, df as tableFieldIdsResolver, dh as tableFieldsResolver, dk as tableFiltersResolver, d6 as tableIdResolver, dg as tableNameResolver, dd as tableRecordIdResolver, de as tableRecordIdsResolver, di as tableRecordsResolver, dl as tableSortResolver, dj as tableUpdateRecordsResolver, ad as toSnakeCase, ae as toTitleCase, d7 as triggerInboxResolver, dc as triggerMessagesResolver, eD as updateTableRecordsPlugin, d8 as workflowIdResolver, db as workflowRunIdResolver, da as workflowVersionIdResolver, bT as zapierAdaptError } from './index-DuFFW71E.mjs';
+export { x as Action, f as ActionEntry, cc as ActionExecutionOptions, I as ActionExecutionResult, J as ActionField, K as ActionFieldChoice, aQ as ActionItem, bq as ActionKeyProperty, a_ as ActionKeyPropertySchema, br as ActionProperty, a$ as ActionPropertySchema, aE as ActionResolverItem, bC as ActionTimeoutMsProperty, ba as ActionTimeoutMsPropertySchema, aF as ActionTypeItem, bp as ActionTypeProperty, aZ as ActionTypePropertySchema, d as AddActionEntryOptions, e as AddActionEntryResult, A as ApiClient, c8 as ApiError, dC as ApiEvent, cW as ApiPluginOptions, cY as ApiPluginProvides, y as App, cd as AppFactoryInput, aO as AppItem, bn as AppKeyProperty, aX as AppKeyPropertySchema, bo as AppProperty, aY as AppPropertySchema, eL as ApplicationLifecycleEventData, c4 as ApprovalStatus, cb as AppsPluginProvides, bH as AppsProperty, bf as AppsPropertySchema, a5 as ArrayResolver, dB as AuthEvent, bv as AuthenticationIdProperty, b2 as AuthenticationIdPropertySchema, eT as BaseEvent, as as BaseSdkOptionsSchema, ag as BatchOptions, cJ as CONTEXT_CACHE_MAX_SIZE, cI as CONTEXT_CACHE_TTL_MS, aw as CORE_ERROR_SYMBOL, H as Choice, dI as ClientCredentialsObject, dT as ClientCredentialsObjectSchema, V as Connection, d$ as ConnectionEntry, d_ as ConnectionEntrySchema, bt as ConnectionIdProperty, b1 as ConnectionIdPropertySchema, aP as ConnectionItem, bu as ConnectionProperty, b3 as ConnectionPropertySchema, e1 as ConnectionsMap, e0 as ConnectionsMapSchema, e3 as ConnectionsPluginProvides, bJ as ConnectionsProperty, bh as ConnectionsPropertySchema, X as ConnectionsResponse, ax as CoreErrorCode, cv as CreateClientCredentialsPluginProvides, et as CreateTableFieldsPluginProvides, en as CreateTablePluginProvides, eB as CreateTableRecordsPluginProvides, dF as Credentials, dY as CredentialsFunction, dX as CredentialsFunctionSchema, dH as CredentialsObject, dV as CredentialsObjectSchema, dZ as CredentialsSchema, e8 as DEFAULT_ACTION_TIMEOUT_MS, eg as DEFAULT_APPROVAL_TIMEOUT_MS, cS as DEFAULT_CONFIG_PATH, eh as DEFAULT_MAX_APPROVAL_RETRIES, e7 as DEFAULT_PAGE_SIZE, bA as DebugProperty, b8 as DebugPropertySchema, cx as DeleteClientCredentialsPluginProvides, ev as DeleteTableFieldsPluginProvides, ep as DeleteTablePluginProvides, eD as DeleteTableRecordsPluginProvides, s as DrainTriggerInboxCallback, t as DrainTriggerInboxErrorObserver, D as DrainTriggerInboxOptions, a8 as DynamicListResolver, l as DynamicResolver, a9 as DynamicSearchResolver, eM as EnhancedErrorEventData, bP as ErrorOptions, dE as EventCallback, eK as EventContext, eH as EventEmissionConfig, E as EventEmissionContext, eJ as EventEmissionProvides, cf as FetchPluginProvides, z as Field, bG as FieldsProperty, be as FieldsPropertySchema, aa as FieldsResolver, F as FieldsetItem, v as FindFirstAuthenticationPluginProvides, cF as FindFirstConnectionPluginProvides, w as FindUniqueAuthenticationPluginProvides, cH as FindUniqueConnectionPluginProvides, a3 as FormattedItem, ar as FunctionDeprecation, aq as FunctionRegistryEntry, cp as GetActionInputFieldsSchemaPluginProvides, cB as GetActionPluginProvides, cz as GetAppPluginProvides, G as GetAuthenticationPluginProvides, cD as GetConnectionPluginProvides, cV as GetProfilePluginProvides, el as GetTablePluginProvides, ex as GetTableRecordPluginProvides, aS as InfoFieldItem, aR as InputFieldItem, bs as InputFieldProperty, b0 as InputFieldPropertySchema, bw as InputsProperty, b4 as InputsPropertySchema, aN as JsonSseMessage, bO as LeaseLimitProperty, bm as LeaseLimitPropertySchema, bM as LeaseProperty, bk as LeasePropertySchema, bN as LeaseSecondsProperty, bl as LeaseSecondsPropertySchema, L as LeasedTriggerMessageItem, bx as LimitProperty, b5 as LimitPropertySchema, cn as ListActionInputFieldChoicesPluginProvides, cl as ListActionInputFieldsPluginProvides, cj as ListActionsPluginProvides, ch as ListAppsPluginProvides, u as ListAuthenticationsPluginProvides, ct as ListClientCredentialsPluginProvides, cr as ListConnectionsPluginProvides, er as ListTableFieldsPluginProvides, ez as ListTableRecordsPluginProvides, ej as ListTablesPluginProvides, dD as LoadingEvent, eb as MAX_CONCURRENCY_LIMIT, e6 as MAX_PAGE_LIMIT, b as Manifest, cT as ManifestEntry, cO as ManifestPluginOptions, cR as ManifestPluginProvides, eU as MethodCalledEvent, eN as MethodCalledEventData, N as Need, Q as NeedsRequest, S as NeedsResponse, by as OffsetProperty, b6 as OffsetPropertySchema, O as OutputFormatter, bz as OutputProperty, b7 as OutputPropertySchema, aW as PaginatedSdkFunction, i as PaginatedSdkResult, bB as ParamsProperty, b9 as ParamsPropertySchema, dJ as PkceCredentialsObject, dU as PkceCredentialsObjectSchema, ay as Plugin, a as PluginMeta, az as PluginProvides, aI as PollOptions, j as PositionalMetadata, c2 as RateLimitInfo, bE as RecordProperty, bc as RecordPropertySchema, bF as RecordsProperty, bd as RecordsPropertySchema, al as RelayFetchSchema, ak as RelayRequestSchema, aH as RequestOptions, cN as RequestPluginProvides, dn as ResolveAuthTokenOptions, dO as ResolveCredentialsOptions, R as ResolvedAppLocator, dG as ResolvedCredentials, dW as ResolvedCredentialsSchema, a4 as Resolver, a6 as ResolverMetadata, aT as RootFieldItem, cL as RunActionPluginProvides, dA as SdkEvent, aV as SdkPage, aM as SseMessage, a7 as StaticResolver, bD as TableProperty, bb as TablePropertySchema, bI as TablesProperty, bg as TablesPropertySchema, bL as TriggerInboxNameProperty, bj as TriggerInboxNamePropertySchema, bK as TriggerInboxProperty, bi as TriggerInboxPropertySchema, T as TriggerMessageStatus, U as UpdateManifestEntryOptions, c as UpdateManifestEntryResult, eF as UpdateTableRecordsPluginProvides, Y as UserProfile, aU as UserProfileItem, W as WatchTriggerInboxOptions, o as WithAddPlugin, e4 as ZAPIER_BASE_URL, ed as ZAPIER_MAX_CONCURRENT_REQUESTS, e9 as ZAPIER_MAX_NETWORK_RETRIES, ea as ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, p as ZapierAbortDrainSignal, c0 as ZapierActionError, bV as ZapierApiError, bW as ZapierAppNotFoundError, c5 as ZapierApprovalError, bT as ZapierAuthenticationError, b_ as ZapierBundleError, dw as ZapierCache, dx as ZapierCacheEntry, dy as ZapierCacheSetOptions, bZ as ZapierConfigurationError, c1 as ZapierConflictError, bQ as ZapierError, k as ZapierFetchInitOptions, bX as ZapierNotFoundError, c3 as ZapierRateLimitError, c6 as ZapierRelayError, q as ZapierReleaseTriggerMessageSignal, bY as ZapierResourceNotFoundError, f4 as ZapierSdk, n as ZapierSdkApps, Z as ZapierSdkOptions, c9 as ZapierSignal, b$ as ZapierTimeoutError, bS as ZapierUnknownError, bR as ZapierValidationError, c$ as actionKeyResolver, c_ as actionTypeResolver, a2 as addPlugin, cX as apiPlugin, cZ as appKeyResolver, ca as appsPlugin, d1 as authenticationIdGenericResolver, d0 as authenticationIdResolver, af as batch, eO as buildApplicationLifecycleEvent, ah as buildCapabilityMessage, eQ as buildErrorEvent, eP as buildErrorEventWithContext, eS as buildMethodCalledEvent, eG as cleanupEventListeners, dp as clearTokenCache, d5 as clientCredentialsNameResolver, d6 as clientIdResolver, aD as composePlugins, d1 as connectionIdGenericResolver, d0 as connectionIdResolver, e2 as connectionsPlugin, eR as createBaseEvent, cu as createClientCredentialsPlugin, a1 as createCorePlugin, $ as createFunction, dz as createMemoryCache, ao as createOptionsPlugin, aC as createPaginatedPluginMethod, aB as createPluginMethod, a0 as createPluginStack, an as createSdk, es as createTableFieldsPlugin, em as createTablePlugin, eA as createTableRecordsPlugin, aJ as createZapierApi, ap as createZapierCoreStack, f2 as createZapierSdk, f3 as createZapierSdkStack, am as createZapierSdkWithoutRegistry, aA as definePlugin, cw as deleteClientCredentialsPlugin, eu as deleteTableFieldsPlugin, eo as deleteTablePlugin, eC as deleteTableRecordsPlugin, da as durableRunIdResolver, eI as eventEmissionPlugin, ce as fetchPlugin, cE as findFirstConnectionPlugin, g as findManifestEntry, cG as findUniqueConnectionPlugin, c7 as formatErrorMessage, eV as generateEventId, co as getActionInputFieldsSchemaPlugin, cA as getActionPlugin, cy as getAppPlugin, dR as getBaseUrlFromCredentials, e$ as getCiPlatform, dS as getClientIdFromCredentials, cC as getConnectionPlugin, av as getCoreErrorCause, au as getCoreErrorCode, f1 as getCpuTime, eW as getCurrentTimestamp, f0 as getMemoryUsage, aK as getOrCreateApiClient, eY as getOsInfo, eZ as getPlatformVersions, cP as getPreferredManifestEntryKey, cU as getProfilePlugin, eX as getReleaseId, ek as getTablePlugin, ew as getTableRecordPlugin, dt as getTokenFromCliLogin, ee as getZapierApprovalMode, ef as getZapierDefaultApprovalMode, e5 as getZapierSdkService, dr as injectCliLogin, d4 as inputFieldKeyResolver, d3 as inputsAllOptionalResolver, d2 as inputsResolver, dq as invalidateCachedToken, dv as invalidateCredentialsToken, e_ as isCi, ds as isCliLoginAvailable, dK as isClientCredentials, at as isCoreError, dN as isCredentialsFunction, dM as isCredentialsObject, aL as isPermanentHttpError, dL as isPkceCredentials, _ as isPositional, cm as listActionInputFieldChoicesPlugin, ck as listActionInputFieldsPlugin, ci as listActionsPlugin, cg as listAppsPlugin, cs as listClientCredentialsPlugin, cq as listConnectionsPlugin, eq as listTableFieldsPlugin, ey as listTableRecordsPlugin, ei as listTablesPlugin, ai as logDeprecation, cQ as manifestPlugin, ec as parseConcurrencyEnvVar, r as readManifestFromFile, aG as registryPlugin, cM as requestPlugin, aj as resetDeprecationWarnings, du as resolveAuthToken, dQ as resolveCredentials, dP as resolveCredentialsFromEnv, cK as runActionPlugin, ab as runInMethodScope, ac as runWithTelemetryContext, dg as tableFieldIdsResolver, di as tableFieldsResolver, dl as tableFiltersResolver, d7 as tableIdResolver, dh as tableNameResolver, de as tableRecordIdResolver, df as tableRecordIdsResolver, dj as tableRecordsResolver, dm as tableSortResolver, dk as tableUpdateRecordsResolver, ad as toSnakeCase, ae as toTitleCase, d8 as triggerInboxResolver, dd as triggerMessagesResolver, eE as updateTableRecordsPlugin, d9 as workflowIdResolver, dc as workflowRunIdResolver, db as workflowVersionIdResolver, bU as zapierAdaptError } from './index-C0bQ5snd.mjs';
 import 'zod';
 import 'zod/v4/core';
 import '@zapier/zapier-sdk-core/v0/schemas/connections';

package/dist/index.d.ts

@@ -73,7 +73,7 @@ export { registryPlugin } from "./plugins/registry";
 export type { ApiClient, RequestOptions, PollOptions } from "./api/types";
 export { createZapierApi, getOrCreateApiClient } from "./api";
 export { isPermanentHttpError } from "./api";
-export type { SseMessage } from "./api";
+export type { SseMessage, JsonSseMessage } from "./api";
 export type { ZapierSdk } from "./sdk";
 export * from "./plugins/eventEmission";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -6486,13 +6486,16 @@ async function exchangeClientCredentials(options) {
       },
       timestamp: Date.now()
     });
-    throw new Error(
-      `Client credentials exchange failed: ${response.status} ${response.statusText}`
+    throw new ZapierAuthenticationError(
+      `Client credentials exchange failed: ${response.status} ${response.statusText}`,
+      { statusCode: response.status }
     );
   }
   const data = await response.json();
   if (!data.access_token) {
-    throw new Error("Client credentials response missing access_token");
+    throw new ZapierAuthenticationError(
+      "Client credentials response missing access_token"
+    );
   }
   onEvent?.({
     type: "auth_success",
@@ -6715,6 +6718,17 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/api/sse-parser.ts
+async function* jsonFrames(source) {
+  for await (const { data } of source) {
+    let frame;
+    try {
+      frame = { parsed: true, data: JSON.parse(data), raw: data };
+    } catch {
+      frame = { parsed: false, data: null, raw: data };
+    }
+    yield frame;
+  }
+}
 function createSseParserStream() {
   let buffer = "";
   let data = "";
@@ -6762,7 +6776,7 @@ function createSseParserStream() {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.69.3" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.70.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -7137,6 +7151,15 @@ var ZapierApiClient = class {
      * never pins a slot — see `withSemaphore`.
      */
     this.fetchStream = (path, init) => this.streamSse(path, init);
+    /**
+     * Like `fetchStream`, but parses each frame's `data` as JSON. Diverges from
+     * `fetchJson` deliberately: that throws on invalid JSON, but a long-lived
+     * stream must survive a single malformed frame, so a parse failure is yielded
+     * as `{ parsed: false, data: null, raw }` rather than thrown. A non-ok
+     * response still throws the shared `ZapierError` (from `fetchStream`, before
+     * any frame), so transport / auth failures surface as usual.
+     */
+    this.fetchJsonStream = (path, init) => jsonFrames(this.fetchStream(path, init));
     this.get = async (path, options = {}) => {
       return this.fetchJson("GET", path, void 0, options);
     };
@@ -7702,7 +7725,11 @@ var createZapierApi = (options) => {
 
 // src/api/error-classification.ts
 function isPermanentHttpError(err) {
-  const statusCode = err instanceof ZapierError ? err.statusCode : void 0;
+  if (!(err instanceof ZapierError)) return false;
+  if (err instanceof ZapierAuthenticationError && err.statusCode === void 0) {
+    return true;
+  }
+  const { statusCode } = err;
   return statusCode !== void 0 && statusCode >= 400 && statusCode < 500 && statusCode !== 429;
 }
 

package/dist/plugins/triggers/drainTriggerInbox/index.d.ts

@@ -5,6 +5,8 @@ import type { AckTriggerInboxMessagesPluginProvides } from "../ackTriggerInboxMe
 import type { ReleaseTriggerInboxMessagesPluginProvides } from "../releaseTriggerInboxMessages";
 import type { LeasedTriggerMessageItem } from "../../../schemas/TriggerMessage";
 export { ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, } from "./schemas";
+export declare function markNonRetryableDrainError<E>(err: E): E;
+export declare function isNonRetryableDrainError(err: unknown): boolean;
 interface RunDrainPassOptions {
     sdk: ApiPluginProvides & LeaseTriggerInboxMessagesPluginProvides & AckTriggerInboxMessagesPluginProvides & ReleaseTriggerInboxMessagesPluginProvides;
     inboxId: string;
@@ -28,8 +30,8 @@ export interface RunDrainPassOutcome {
 /**
  * One drain pass through `runBatchedDrainPipeline`. Used directly by
  * `drainTriggerInbox` (single pass) and as the inner loop body of
- * `watchTriggerInbox` (called repeatedly with poll backoff between
- * empty passes).
+ * `watchTriggerInbox` (called once per drain request, with bounded error
+ * backoff between passes that fail with a transient error).
  */
 export declare function runDrainPass(options: RunDrainPassOptions): Promise<RunDrainPassOutcome>;
 /**

package/dist/plugins/triggers/drainTriggerInbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/drainTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,gCAAgC,CAAC;AAIhG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAMhF,OAAO,EACL,sBAAsB,EACtB,iCAAiC,GAClC,MAAM,WAAW,CAAC;AAcnB,UAAU,mBAAmB;IAC3B,GAAG,EAAE,iBAAiB,GACpB,uCAAuC,GACvC,qCAAqC,GACrC,yCAAyC,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,yBAAyB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EACH,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACvE,SAAS,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAsI9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,yBAAyB,GAAG,SAAS,GAC/C,yBAAyB,CAK3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAI9C;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCASrB,wBAAwB,KAChC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,UAAU,CACtD,OAAO,uBAAuB,CAC/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/drainTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,gCAAgC,CAAC;AAIhG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAMhF,OAAO,EACL,sBAAsB,EACtB,iCAAiC,GAClC,MAAM,WAAW,CAAC;AAkBnB,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAKvD;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI9D;AAcD,UAAU,mBAAmB;IAC3B,GAAG,EAAE,iBAAiB,GACpB,uCAAuC,GACvC,qCAAqC,GACrC,yCAAyC,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,yBAAyB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EACH,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACvE,SAAS,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAmJ9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,yBAAyB,GAAG,SAAS,GAC/C,yBAAyB,CAK3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAI9C;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCASrB,wBAAwB,KAChC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,UAAU,CACtD,OAAO,uBAAuB,CAC/B,CAAC"}

package/dist/plugins/triggers/drainTriggerInbox/index.js

@@ -8,6 +8,30 @@ import { resolveTriggerInboxId } from "../utils";
 import { triggersDefaults } from "../shared";
 import { isAbortError } from "../../../utils/abort-utils";
 export { ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, } from "./schemas";
+/**
+ * Drain errors that must NOT be retried, by error identity: a fail-fast handler
+ * error (the user's own failure — retrying would re-run a handler that already
+ * chose to stop) and an `initialization_failure` (a permanent inbox setup
+ * problem). The watch loop retries transient infrastructure errors but consults
+ * this set to leave these fatal. A WeakSet rather than a marker property because
+ * handler errors are the user's own values and must reach their catch
+ * unmodified. `markNonRetryableDrainError` no-ops on a non-object throw (it
+ * can't be weakly held), but that case is still fatal without this set: the
+ * watch loop classifies any non-object thrown value as non-retryable on its own,
+ * since the API client only ever throws Error objects, so a primitive can only
+ * be a user fail-fast throw. Permanent HTTP errors are non-retryable too, but
+ * the caller classifies those by status code, not via this set.
+ */
+const nonRetryableDrainErrors = new WeakSet();
+export function markNonRetryableDrainError(err) {
+    if (typeof err === "object" && err !== null) {
+        nonRetryableDrainErrors.add(err);
+    }
+    return err;
+}
+export function isNonRetryableDrainError(err) {
+    return (typeof err === "object" && err !== null && nonRetryableDrainErrors.has(err));
+}
 /**
  * Server returns 400 lease_expired when a UUIDv7 timestamp is in the
  * past. The API atomically quarantines messages that have hit
@@ -23,13 +47,17 @@ function isLeaseExpiredError(err) {
 /**
  * One drain pass through `runBatchedDrainPipeline`. Used directly by
  * `drainTriggerInbox` (single pass) and as the inner loop body of
- * `watchTriggerInbox` (called repeatedly with poll backoff between
- * empty passes).
+ * `watchTriggerInbox` (called once per drain request, with bounded error
+ * backoff between passes that fail with a transient error).
  */
 export async function runDrainPass(options) {
     const { sdk, inboxId, onMessage, concurrency, leaseLimit, leaseSeconds, maxMessages, releaseOnError, continueOnError, onError, signal, } = options;
     let firstFetch = options.firstFetch;
     let abortedFromCallback = false;
+    // A boolean rather than a `firstHandlerError !== undefined` sentinel so a
+    // handler that throws a falsy value (`throw undefined` / `throw null`) is still
+    // captured and surfaced as fatal, not silently swallowed.
+    let handlerErrorCaptured = false;
     let firstHandlerError = undefined;
     const outcomes = await runBatchedDrainPipeline({
         concurrency,
@@ -59,7 +87,7 @@ export async function runDrainPass(options) {
             if (lease.results.length === 0) {
                 if (firstFetch &&
                     lease.inbox_attributes.status === "initialization_failure") {
-                    throw new ZapierApiError(`Trigger inbox ${inboxId} is in initialization_failure state — inspect via getTriggerInbox.`);
+                    throw markNonRetryableDrainError(new ZapierApiError(`Trigger inbox ${inboxId} is in initialization_failure state — inspect via getTriggerInbox.`));
                 }
                 firstFetch = false;
                 return "exhausted";
@@ -108,8 +136,10 @@ export async function runDrainPass(options) {
                 // Fail-fast: capture the first real error and tell the
                 // pipeline to abort. continueOnError keeps it running.
                 if (!continueOnError && !(err instanceof ZapierSignal)) {
-                    if (firstHandlerError === undefined)
+                    if (!handlerErrorCaptured) {
                         firstHandlerError = err;
+                        handlerErrorCaptured = true;
+                    }
                     abort = true;
                 }
                 return { value: message, action, abort };
@@ -142,8 +172,11 @@ export async function runDrainPass(options) {
             }
         },
     });
-    if (firstHandlerError !== undefined)
-        throw firstHandlerError;
+    // Mark so the watch loop treats this as fatal and never retries it (a
+    // fail-fast handler error means the user already chose to stop).
+    if (handlerErrorCaptured) {
+        throw markNonRetryableDrainError(firstHandlerError);
+    }
     return { abortedFromCallback, processed: outcomes.length };
 }
 /**

package/dist/plugins/triggers/watchTriggerInbox/index.d.ts

@@ -26,8 +26,10 @@ export declare function createDrainLatch(): DrainLatch;
  * `maxDrainIntervalSeconds` seconds (default: 300) to guarantee
  * forward progress if SSE events are missed or the connection drops
  * undetected. Resolves cleanly on `signal` abort or when a callback
- * throws `ZapierAbortDrainSignal`; rejects on a fatal error or a
- * fail-fast handler error.
+ * throws `ZapierAbortDrainSignal`. Transient drain failures (5xx, 429,
+ * network blips) are retried indefinitely with bounded backoff until they
+ * succeed or the watch is aborted; it rejects only on a fail-fast handler
+ * error, an `initialization_failure`, or a permanent HTTP error.
  */
 export declare const watchTriggerInboxPlugin: (sdk: {
     context: {

package/dist/plugins/triggers/watchTriggerInbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/watchTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAetC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA2BzD,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAC;IAChB,sEAAsE;IACtE,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CA2B7C;AAoLD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMnB;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE;;;;;;iCAI7B,wBAAwB,KAChC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiHnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,UAAU,CACtD,OAAO,uBAAuB,CAC/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/watchTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAoBtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoCzD,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAC;IAChB,sEAAsE;IACtE,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CA2B7C;AAqQD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMnB;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE;;;;;;iCAI7B,wBAAwB,KAChC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuHnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,UAAU,CACtD,OAAO,uBAAuB,CAC/B,CAAC"}

package/dist/plugins/triggers/watchTriggerInbox/index.js

@@ -1,11 +1,11 @@
 import { definePlugin } from "kitcore";
 import { WatchTriggerInboxSchema, } from "../drainTriggerInbox/schemas";
-import { requireOnMessage, resolveConcurrencyAndLease, runDrainPass, } from "../drainTriggerInbox";
+import { requireOnMessage, resolveConcurrencyAndLease, runDrainPass, isNonRetryableDrainError, } from "../drainTriggerInbox";
 import { resolveTriggerInboxId } from "../utils";
 import { triggerInboxResolver } from "../../../resolvers";
 import { triggersDefaults } from "../shared";
 import { isAbortError, combineAbortSignals } from "../../../utils/abort-utils";
-import { sleep } from "../../../utils/retry-utils";
+import { sleep, calculateErrorBackoffMs, BASE_ERROR_BACKOFF_MS, } from "../../../utils/retry-utils";
 import { isPermanentHttpError } from "../../../api";
 import { ZapierError } from "../../../types/errors";
 import { readInboxEvents } from "./sse";
@@ -22,6 +22,14 @@ const DEFAULT_SAFETY_DRAIN_INTERVAL_MS = 300000; // 5 minutes
 // recovery from routine server-side cycling (e.g. JWT expiry); a stream that
 // closes sooner is treated as unstable and escalates like any other.
 const SSE_HEALTHY_CONNECTION_MS = 5000;
+// Consecutive transient drain failures escalate the backoff via
+// calculateErrorBackoffMs, whose error term saturates at errorCount 4 (capped at
+// 2x the base interval). Past that the delay no longer grows, so we cap the
+// counter that feeds the backoff there, holding the steady-state ~3.5 s retry
+// cadence. (The separate, intentionally uncapped errorAttempts counter in
+// drainRunner is what the diagnostics report; its unbounded growth is harmless
+// since it only feeds a log string, never the backoff math.)
+const ERROR_BACKOFF_CAP = 4;
 /**
  * Coalescing wake latch between the drain producers (SSE connect, SSE frames,
  * the safety timer, abort) and the single drain consumer. A `request()` that
@@ -61,11 +69,29 @@ export function createDrainLatch() {
 /**
  * Sole caller of `runDrainPass`, so drains are serial and never overlap. Waits
  * for a request, drains the inbox to empty, repeats. The first pass carries
- * `firstFetch: true` (preserving the initialization_failure check). Returns how
- * the watch ended so the caller can resolve or re-throw.
+ * `firstFetch: true` (preserving the initialization_failure check).
+ *
+ * Transient infrastructure failures (5xx, 429, network blips on lease / ack /
+ * release) are retried indefinitely with bounded backoff until they succeed or
+ * the watch is aborted — a watch is a "consume until aborted" loop, so a blip (or
+ * even a multi-minute outage) must not kill it, mirroring the SSE loop's
+ * resilience. The backoff escalates with consecutive failures and resets on the
+ * first success. Once retries saturate the backoff, a single warning prints to
+ * stderr (re-armed on the next success), mirroring the SSE loop's degraded-state
+ * notice; per-retry diagnostics print only under `debug`. A fail-fast handler
+ * error, an `initialization_failure`, or a permanent HTTP error is fatal
+ * immediately. Returns how the watch ended so the caller can resolve or re-throw.
  */
-async function drainRunner({ drainOptions, drainRequest, signal, }) {
+async function drainRunner({ drainOptions, drainRequest, signal, inboxId, debug, }) {
     let firstFetch = true;
+    let consecutiveErrors = 0;
+    // Uncapped, unlike consecutiveErrors: reports the true consecutive-failure count
+    // in diagnostics so a long outage doesn't freeze the logged attempt at the
+    // backoff cap. Reset on a successful pass.
+    let errorAttempts = 0;
+    // Mirrors the SSE loop's `degraded`: warn once when retries saturate the
+    // backoff, re-armed (silently) on the first successful pass.
+    let drainDegraded = false;
     while (!signal.aborted) {
         await drainRequest.waitForRequest();
         if (signal.aborted)
@@ -78,19 +104,69 @@ async function drainRunner({ drainOptions, drainRequest, signal, }) {
             }));
         }
         catch (error) {
-            return { kind: "error", error };
+            // Abort is intent, not failure — surface it as a clean stop, uncounted.
+            // `signal.aborted` alone is the predicate: every abort of THIS watch has
+            // set it by the time the catch runs, so an abort-shaped error arriving
+            // without it can only be someone else's (e.g. the user's onMessage leaking
+            // its own aborted fetch) — that's a fail-fast handler error and must
+            // reject below, not resolve the watch as a clean stop.
+            if (signal.aborted)
+                return { kind: "aborted" };
+            // Fatal, never retried: fail-fast handler errors and initialization_failure
+            // are tagged non-retryable; permanent HTTP (4xx — auth / permission /
+            // not-found) won't fix itself; and a non-object thrown value can only be a
+            // user onMessage fail-fast throw (the API client only throws Error objects),
+            // which is the user's own failure. Everything else (5xx, 429, network blip)
+            // is transient and retried below.
+            const isNonObjectThrow = typeof error !== "object" || error === null;
+            if (isNonObjectThrow ||
+                isNonRetryableDrainError(error) ||
+                isPermanentHttpError(error)) {
+                return { kind: "error", error };
+            }
+            // Transient: retry indefinitely (a watch runs until aborted). The counter
+            // only escalates the backoff and is capped where the backoff saturates, so
+            // a long outage can't grow it unbounded; a successful pass resets it below.
+            consecutiveErrors = Math.min(consecutiveErrors + 1, ERROR_BACKOFF_CAP);
+            errorAttempts += 1;
+            const delay = calculateErrorBackoffMs(BASE_ERROR_BACKOFF_MS, consecutiveErrors);
+            const statusCode = errorStatusCode(error);
+            const httpPart = statusCode !== undefined ? ` (HTTP ${statusCode})` : "";
+            // Once retries saturate the backoff the watch is making no forward
+            // progress, so surface it once on stderr even without `debug` (re-armed on
+            // recovery), mirroring how the SSE loop warns when real-time wake-ups pause.
+            if (!drainDegraded && consecutiveErrors >= ERROR_BACKOFF_CAP) {
+                console.warn(`[zapier-sdk] Draining inbox ${inboxId}${httpPart} is failing ` +
+                    `repeatedly: ${errorMessage(error)}. Continuing to retry with backoff.`);
+                drainDegraded = true;
+            }
+            if (debug) {
+                console.error(`[zapier-sdk] Retrying drain for inbox ${inboxId} ` +
+                    `(attempt ${errorAttempts}, retry in ${delay}ms)${httpPart}: ${errorMessage(error)}`);
+            }
+            await sleep(delay, signal);
+            if (signal.aborted)
+                return { kind: "aborted" };
+            // Re-arm the latch so the loop drains again even without an external
+            // wake-up (SSE frame / safety timer). firstFetch stays set so a retry of
+            // the first pass still runs the initialization_failure check.
+            drainRequest.request();
+            continue;
         }
         firstFetch = false;
+        consecutiveErrors = 0;
+        errorAttempts = 0;
+        drainDegraded = false;
         if (abortedFromCallback)
             return { kind: "abortedFromCallback" };
     }
     return { kind: "aborted" };
 }
 /** statusCode off any ZapierError (ZapierApiError, ZapierApprovalError, …). */
-function sseErrorStatusCode(err) {
+function errorStatusCode(err) {
     return err instanceof ZapierError ? err.statusCode : undefined;
 }
-function sseErrorMessage(err) {
+function errorMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
 /**
@@ -152,8 +228,8 @@ async function sseLoop({ api, inboxId, drainRequest, safetyDrainMs, signal, debu
                 return;
             if (isPermanentHttpError(err)) {
                 if (!degraded) {
-                    const statusCode = sseErrorStatusCode(err);
-                    const errorMsg = sseErrorMessage(err);
+                    const statusCode = errorStatusCode(err);
+                    const errorMsg = errorMessage(err);
                     const httpPart = statusCode !== undefined ? ` (HTTP ${statusCode})` : "";
                     console.warn(`[zapier-sdk] Real-time wake-ups for inbox ${inboxId}${httpPart} ` +
                         `paused: ${errorMsg}. Falling back to the periodic safety drain.`);
@@ -176,8 +252,8 @@ async function sseLoop({ api, inboxId, drainRequest, safetyDrainMs, signal, debu
         const delay = SSE_RECONNECT_BACKOFF_MS[Math.min(attempt, SSE_RECONNECT_BACKOFF_MS.length - 1)];
         attempt = Math.min(attempt + 1, SSE_RECONNECT_BACKOFF_MS.length - 1);
         if (transientError !== undefined && debug) {
-            const statusCode = sseErrorStatusCode(transientError);
-            const errorMsg = sseErrorMessage(transientError);
+            const statusCode = errorStatusCode(transientError);
+            const errorMsg = errorMessage(transientError);
             const httpPart = statusCode !== undefined ? ` (HTTP ${statusCode})` : "";
             console.error(`[zapier-sdk] Reconnecting real-time wake-ups for inbox ${inboxId} ` +
                 `(attempt ${attempt}, retry in ${delay}ms)${httpPart}: ${errorMsg}`);
@@ -209,8 +285,10 @@ async function safetyTimerLoop({ safetyDrainMs, drainRequest, signal, }) {
  * `maxDrainIntervalSeconds` seconds (default: 300) to guarantee
  * forward progress if SSE events are missed or the connection drops
  * undetected. Resolves cleanly on `signal` abort or when a callback
- * throws `ZapierAbortDrainSignal`; rejects on a fatal error or a
- * fail-fast handler error.
+ * throws `ZapierAbortDrainSignal`. Transient drain failures (5xx, 429,
+ * network blips) are retried indefinitely with bounded backoff until they
+ * succeed or the watch is aborted; it rejects only on a fail-fast handler
+ * error, an `initialization_failure`, or a permanent HTTP error.
  */
 export const watchTriggerInboxPlugin = definePlugin((sdk) => {
     async function watchTriggerInbox(options) {
@@ -265,7 +343,13 @@ export const watchTriggerInboxPlugin = definePlugin((sdk) => {
         // in the inbox even if SSE never connects (e.g. a permanent 4xx). SSE and
         // the safety timer then layer on additional catch-up drains.
         drainRequest.request();
-        const runnerDone = drainRunner({ drainOptions, drainRequest, signal });
+        const runnerDone = drainRunner({
+            drainOptions,
+            drainRequest,
+            signal,
+            inboxId,
+            debug,
+        });
         const sseDone = sseLoop({
             api: sdk.context.api,
             inboxId,
@@ -300,7 +384,7 @@ export const watchTriggerInboxPlugin = definePlugin((sdk) => {
                 watchTriggerInbox: {
                     ...triggersDefaults,
                     type: "create",
-                    description: "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; rejects on fatal SDK errors or fail-fast handler errors. 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.",
+                    description: "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.",
                     itemType: "void",
                     // See drainTriggerInbox: override the doc generator's default
                     // suffix so the rendered return type is Promise<void>, not

package/dist/plugins/triggers/watchTriggerInbox/sse.d.ts

@@ -5,9 +5,10 @@ interface InboxSseEvent {
 }
 /**
  * Streams the trigger inbox events endpoint and yields the notification frames
- * for this inbox. The transport (SSE connection, parsing, reconnect-able error
- * mapping, abort/cleanup) lives in `api.fetchStream`; this only adds the inbox
- * URL and the `inbox_id` filter.
+ * for this inbox. The transport (SSE connection, JSON parsing, reconnect-able
+ * error mapping, abort/cleanup) lives in `api.fetchJsonStream`; this only adds
+ * the inbox URL and the `inbox_id` filter, skipping any frame whose data was
+ * not valid JSON.
  *
  * `onOpen` fires once the connection is live (response ok, body present) and
  * before the first frame. The endpoint is edge-triggered with no replay, so a
@@ -16,9 +17,10 @@ interface InboxSseEvent {
  *
  * The generator returns (without throwing) when the signal is aborted, when
  * the server closes the connection (JWT expiry, clean shutdown), or when the
- * body is empty. For a non-ok response `api.fetchStream` throws a `ZapierError`
- * carrying the HTTP `statusCode`; `isPermanentHttpError` classifies it so the
- * caller can tell permanent (4xx) failures from transient ones.
+ * body is empty. For a non-ok response `api.fetchJsonStream` throws a
+ * `ZapierError` carrying the HTTP `statusCode`; `isPermanentHttpError`
+ * classifies it so the caller can tell permanent (4xx) failures from transient
+ * ones.
  */
 export declare function readInboxEvents({ api, inboxId, signal, onOpen, }: {
     api: ApiClient;

package/dist/plugins/triggers/watchTriggerInbox/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/watchTriggerInbox/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IAIjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,eAAe,CAAC,EACrC,GAAG,EACH,OAAO,EACP,MAAM,EACN,MAAM,GACP,EAAE;IACD,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,GAAG,cAAc,CAAC,aAAa,CAAC,CAyBhC"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/watchTriggerInbox/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IAIjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,eAAe,CAAC,EACrC,GAAG,EACH,OAAO,EACP,MAAM,EACN,MAAM,GACP,EAAE;IACD,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,GAAG,cAAc,CAAC,aAAa,CAAC,CAqBhC"}