@zapier/zapier-sdk 0.13.8 → 0.13.9

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @zapier/zapier-sdk
 
+## 0.13.9
+
+### Patch Changes
+
+- 492e2f9: - Add new `batch` utility method to handle concurency limits, retries, timeouts and exponential backoffs.
+  - Refactor `generateAppTypes` in CLI to use the new `batch` utility
+
 ## 0.13.8
 
 ### Patch Changes

package/dist/api/polling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/api/polling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,OAAO;IAC5C,8CAA8C;IAC9C,SAAS,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;IACjD,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mBAAW,UAAU;IACnB,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,GAAG,OAAO,IAAI;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAuEF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAG,OAAO,EACvD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAyGlB"}
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/api/polling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,OAAO;IAC5C,8CAA8C;IAC9C,SAAS,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;IACjD,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mBAAW,UAAU;IACnB,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,GAAG,OAAO,IAAI;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAwDF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAG,OAAO,EACvD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAyGlB"}

package/dist/api/polling.js

@@ -6,16 +6,14 @@
  */
 import { ZapierTimeoutError, ZapierApiError, ZapierValidationError, } from "../types/errors";
 import { setTimeout } from "timers/promises";
+import { calculateWaitTime, MAX_CONSECUTIVE_ERRORS, } from "../utils/retry-utils";
 // Constants
 const DEFAULT_TIMEOUT_MS = 180000;
 const DEFAULT_SUCCESS_STATUS = 200;
 const DEFAULT_PENDING_STATUS = 202;
 const DEFAULT_INITIAL_DELAY_MS = 50;
 const DEFAULT_MAX_POLLING_INTERVAL_MS = 10000;
-const MAX_CONSECUTIVE_ERRORS = 3;
 const MAX_TIMEOUT_BUFFER_MS = 10000;
-const BASE_ERROR_BACKOFF_MS = 1000;
-const JITTER_FACTOR = 0.5;
 // Polling stages: [threshold_ms, interval_ms]
 // Note: These are default stages, actual hard timeout is enforced separately below
 const DEFAULT_POLLING_STAGES = [
@@ -26,14 +24,6 @@ const DEFAULT_POLLING_STAGES = [
     [30000, 2500], // Up to 30s: poll every 2.5s
     [60000, 5000], // Up to 60s: poll every 5s
 ];
-// Helper to calculate wait time with jitter and error backoff
-const calculateWaitTime = (baseInterval, errorCount) => {
-    // Jitter to avoid thundering herd
-    const jitter = Math.random() * JITTER_FACTOR * baseInterval;
-    // More backoff added if errors are seen
-    const errorBackoff = Math.min(BASE_ERROR_BACKOFF_MS * (errorCount / 2), baseInterval * 2);
-    return Math.floor(baseInterval + jitter + errorBackoff);
-};
 const processResponse = async (response, successStatus, pendingStatus, resultExtractor, errorCount) => {
     // Handle other error responses
     if (!response.ok) {

package/dist/index.cjs

@@ -3101,15 +3101,28 @@ function createDebugFetch(options) {
     }
   };
 }
+
+// src/utils/retry-utils.ts
+var MAX_CONSECUTIVE_ERRORS = 3;
+var BASE_ERROR_BACKOFF_MS = 1e3;
+var JITTER_FACTOR = 0.5;
+function calculateWaitTime(baseInterval, errorCount) {
+  const jitter = Math.random() * JITTER_FACTOR * baseInterval;
+  const errorBackoff = Math.min(
+    BASE_ERROR_BACKOFF_MS * (errorCount / 2),
+    baseInterval * 2
+    // Cap error backoff at 2x the base interval
+  );
+  return Math.floor(baseInterval + jitter + errorBackoff);
+}
+
+// src/api/polling.ts
 var DEFAULT_TIMEOUT_MS = 18e4;
 var DEFAULT_SUCCESS_STATUS = 200;
 var DEFAULT_PENDING_STATUS = 202;
 var DEFAULT_INITIAL_DELAY_MS = 50;
 var DEFAULT_MAX_POLLING_INTERVAL_MS = 1e4;
-var MAX_CONSECUTIVE_ERRORS = 3;
 var MAX_TIMEOUT_BUFFER_MS = 1e4;
-var BASE_ERROR_BACKOFF_MS = 1e3;
-var JITTER_FACTOR = 0.5;
 var DEFAULT_POLLING_STAGES = [
   [125, 125],
   // Up to 125ms: poll every 125ms
@@ -3124,15 +3137,6 @@ var DEFAULT_POLLING_STAGES = [
   [6e4, 5e3]
   // Up to 60s: poll every 5s
 ];
-var calculateWaitTime = (baseInterval, errorCount) => {
-  const jitter = Math.random() * JITTER_FACTOR * baseInterval;
-  const errorBackoff = Math.min(
-    BASE_ERROR_BACKOFF_MS * (errorCount / 2),
-    baseInterval * 2
-    // Cap error backoff at 2x the base interval
-  );
-  return Math.floor(baseInterval + jitter + errorBackoff);
-};
 var processResponse = async (response, successStatus, pendingStatus, resultExtractor, errorCount) => {
   if (!response.ok) {
     return {
@@ -3613,6 +3617,94 @@ var apiPlugin = (params) => {
     }
   };
 };
+var DEFAULT_CONCURRENCY = 10;
+var BATCH_START_DELAY_MS = 25;
+var DEFAULT_BATCH_TIMEOUT_MS = 18e4;
+async function batch(tasks, options = {}) {
+  const {
+    concurrency = DEFAULT_CONCURRENCY,
+    retry = true,
+    batchDelay = BATCH_START_DELAY_MS,
+    timeoutMs = DEFAULT_BATCH_TIMEOUT_MS,
+    taskTimeoutMs
+  } = options;
+  if (concurrency <= 0) {
+    throw new Error("Concurrency must be greater than 0");
+  }
+  if (timeoutMs <= 0) {
+    throw new Error("Timeout must be greater than 0");
+  }
+  if (taskTimeoutMs !== void 0 && taskTimeoutMs <= 0) {
+    throw new Error("Task timeout must be greater than 0");
+  }
+  if (tasks.length === 0) {
+    return [];
+  }
+  const startTime = Date.now();
+  const results = new Array(tasks.length);
+  const taskQueue = tasks.map((task, index) => ({
+    index,
+    task,
+    errorCount: 0
+  }));
+  async function executeTask(taskState) {
+    const { index, task, errorCount } = taskState;
+    try {
+      let result;
+      if (taskTimeoutMs !== void 0) {
+        const timeoutPromise = promises.setTimeout(taskTimeoutMs).then(() => {
+          throw new ZapierTimeoutError(
+            `Task timed out after ${taskTimeoutMs}ms`
+          );
+        });
+        result = await Promise.race([task(), timeoutPromise]);
+      } else {
+        result = await task();
+      }
+      results[index] = { status: "fulfilled", value: result };
+    } catch (error) {
+      const newErrorCount = errorCount + 1;
+      const isTimeout = error instanceof ZapierTimeoutError;
+      if (retry && !isTimeout && newErrorCount < MAX_CONSECUTIVE_ERRORS) {
+        const waitTime = calculateWaitTime(1e3, newErrorCount);
+        await promises.setTimeout(waitTime);
+        taskQueue.push({
+          index,
+          task,
+          errorCount: newErrorCount
+        });
+      } else {
+        results[index] = { status: "rejected", reason: error };
+      }
+    }
+  }
+  async function worker() {
+    while (taskQueue.length > 0) {
+      const elapsedTime = Date.now() - startTime;
+      if (elapsedTime >= timeoutMs) {
+        throw new ZapierTimeoutError(
+          `Batch operation timed out after ${Math.floor(elapsedTime / 1e3)}s. ${taskQueue.length} task(s) not completed.`
+        );
+      }
+      const taskState = taskQueue.shift();
+      if (!taskState) break;
+      await executeTask(taskState);
+      if (taskQueue.length > 0 && batchDelay > 0) {
+        await promises.setTimeout(batchDelay);
+      }
+    }
+  }
+  const workerCount = Math.min(concurrency, tasks.length);
+  const workers = [];
+  for (let i = 0; i < workerCount; i++) {
+    workers.push(worker());
+    if (i < workerCount - 1 && batchDelay > 0) {
+      await promises.setTimeout(batchDelay / 10);
+    }
+  }
+  await Promise.all(workers);
+  return results;
+}
 
 // src/plugins/registry/index.ts
 var registryPlugin = ({ sdk, context }) => {
@@ -3997,7 +4089,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.13.8"};
+  version: "0.13.9"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -4399,6 +4491,7 @@ exports.appKeyResolver = appKeyResolver;
 exports.appsPlugin = appsPlugin;
 exports.authenticationIdGenericResolver = authenticationIdGenericResolver;
 exports.authenticationIdResolver = authenticationIdResolver;
+exports.batch = batch;
 exports.buildApplicationLifecycleEvent = buildApplicationLifecycleEvent;
 exports.buildErrorEvent = buildErrorEvent;
 exports.buildErrorEventWithContext = buildErrorEventWithContext;

package/dist/index.d.mts

@@ -3133,6 +3133,78 @@ declare function toTitleCase(input: string): string;
  */
 declare function toSnakeCase(input: string): string;
 
+/**
+ * Batch Operation Utilities
+ *
+ * This module provides utilities for executing multiple async operations
+ * with concurrency control and retry logic.
+ */
+/**
+ * Options for batch execution
+ */
+interface BatchOptions {
+    /**
+     * Maximum number of concurrent operations (default: 10)
+     * Lower values are more "polite" but slower
+     * Higher values are faster but risk rate limits
+     */
+    concurrency?: number;
+    /**
+     * Whether to retry failed operations (default: true)
+     * When enabled, each operation gets up to MAX_CONSECUTIVE_ERRORS retries
+     */
+    retry?: boolean;
+    /**
+     * Delay in milliseconds between starting batches (default: 100ms)
+     * Adds a small delay between concurrent batches to avoid burst patterns
+     */
+    batchDelay?: number;
+    /**
+     * Overall timeout for the entire batch operation in milliseconds (default: 180000ms / 3 minutes)
+     * When exceeded, throws ZapierTimeoutError and stops processing remaining tasks
+     */
+    timeoutMs?: number;
+    /**
+     * Timeout for individual tasks in milliseconds (default: none)
+     * When set, each task will be cancelled if it exceeds this duration
+     * Tasks that timeout will be marked as rejected in the results
+     */
+    taskTimeoutMs?: number;
+}
+/**
+ * Execute multiple async operations with concurrency limiting and retry logic
+ *
+ * This prevents overwhelming APIs by:
+ * 1. Limiting concurrent operations (worker pool pattern)
+ * 2. Adding small delays between batches to avoid burst detection
+ * 3. Retrying failed operations with exponential backoff
+ *
+ * Problem Solved:
+ * - Rate limit prevention: Steady stream instead of burst requests
+ * - Connection pool management: Stays within browser/Node limits (~6-8 per domain)
+ * - Resilience: Transient failures are retried automatically
+ * - Observability: Returns detailed success/failure info for each operation
+ *
+ * Example Usage:
+ * ```typescript
+ * // Instead of Promise.allSettled (fires all at once):
+ * const results = await Promise.allSettled(
+ *   actions.map(a => sdk.listInputFields(a))
+ * );
+ *
+ * // Use batch (controlled concurrency):
+ * const results = await batch(
+ *   actions.map(a => () => sdk.listInputFields(a)),
+ *   { concurrency: 10, retry: true }
+ * );
+ * ```
+ *
+ * @param tasks - Array of functions that return promises (NOT promises themselves!)
+ * @param options - Configuration for concurrency and retry behavior
+ * @returns Promise resolving to array of settled results (same as Promise.allSettled)
+ */
+declare function batch<T>(tasks: (() => Promise<T>)[], options?: BatchOptions): Promise<PromiseSettledResult<T>[]>;
+
 declare const appKeyResolver: StaticResolver;
 
 interface ActionTypeItem {
@@ -3346,4 +3418,4 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk
 }>;
 declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 
-export { type Action, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type ApplicationLifecycleEventData, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type BaseEvent, type Choice, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindUniqueAuthenticationPluginProvides, type FormatMetadata, type FormattedItem, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, MAX_PAGE_LIMIT, type Manifest, type ManifestEntry, type ManifestPluginOptions, type ManifestPluginProvides, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type UpdateManifestEntryOptions, type UserProfile, type UserProfileItem, ZAPIER_BASE_URL, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, createBaseEvent, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getCiPlatform, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isCi, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };
+export { type Action, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type ApplicationLifecycleEventData, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type BaseEvent, type BatchOptions, type Choice, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindUniqueAuthenticationPluginProvides, type FormatMetadata, type FormattedItem, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, MAX_PAGE_LIMIT, type Manifest, type ManifestEntry, type ManifestPluginOptions, type ManifestPluginProvides, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type UpdateManifestEntryOptions, type UserProfile, type UserProfileItem, ZAPIER_BASE_URL, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, createBaseEvent, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getCiPlatform, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isCi, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };

package/dist/index.d.ts

@@ -23,6 +23,8 @@ export { isPositional, PositionalMetadata } from "./utils/schema-utils";
 export { createFunction } from "./utils/function-utils";
 export type { FormattedItem, FormatMetadata } from "./utils/schema-utils";
 export { toSnakeCase, toTitleCase } from "./utils/string-utils";
+export { batch } from "./utils/batch-utils";
+export type { BatchOptions } from "./utils/batch-utils";
 export * from "./resolvers";
 export * from "./auth";
 export * from "./constants";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAGvB,cAAc,aAAa,CAAC;AAI5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,cAAc,EACd,UAAU,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,GAChB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAGvB,cAAc,aAAa,CAAC;AAI5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,cAAc,EACd,UAAU,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,GAChB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -24,6 +24,8 @@ export { isPositional } from "./utils/schema-utils";
 export { createFunction } from "./utils/function-utils";
 // Export string utilities
 export { toSnakeCase, toTitleCase } from "./utils/string-utils";
+// Export batch utilities
+export { batch } from "./utils/batch-utils";
 // Export resolver utilities for CLI
 export * from "./resolvers";
 // Export auth utilities for CLI use

package/dist/index.mjs

@@ -3079,15 +3079,28 @@ function createDebugFetch(options) {
     }
   };
 }
+
+// src/utils/retry-utils.ts
+var MAX_CONSECUTIVE_ERRORS = 3;
+var BASE_ERROR_BACKOFF_MS = 1e3;
+var JITTER_FACTOR = 0.5;
+function calculateWaitTime(baseInterval, errorCount) {
+  const jitter = Math.random() * JITTER_FACTOR * baseInterval;
+  const errorBackoff = Math.min(
+    BASE_ERROR_BACKOFF_MS * (errorCount / 2),
+    baseInterval * 2
+    // Cap error backoff at 2x the base interval
+  );
+  return Math.floor(baseInterval + jitter + errorBackoff);
+}
+
+// src/api/polling.ts
 var DEFAULT_TIMEOUT_MS = 18e4;
 var DEFAULT_SUCCESS_STATUS = 200;
 var DEFAULT_PENDING_STATUS = 202;
 var DEFAULT_INITIAL_DELAY_MS = 50;
 var DEFAULT_MAX_POLLING_INTERVAL_MS = 1e4;
-var MAX_CONSECUTIVE_ERRORS = 3;
 var MAX_TIMEOUT_BUFFER_MS = 1e4;
-var BASE_ERROR_BACKOFF_MS = 1e3;
-var JITTER_FACTOR = 0.5;
 var DEFAULT_POLLING_STAGES = [
   [125, 125],
   // Up to 125ms: poll every 125ms
@@ -3102,15 +3115,6 @@ var DEFAULT_POLLING_STAGES = [
   [6e4, 5e3]
   // Up to 60s: poll every 5s
 ];
-var calculateWaitTime = (baseInterval, errorCount) => {
-  const jitter = Math.random() * JITTER_FACTOR * baseInterval;
-  const errorBackoff = Math.min(
-    BASE_ERROR_BACKOFF_MS * (errorCount / 2),
-    baseInterval * 2
-    // Cap error backoff at 2x the base interval
-  );
-  return Math.floor(baseInterval + jitter + errorBackoff);
-};
 var processResponse = async (response, successStatus, pendingStatus, resultExtractor, errorCount) => {
   if (!response.ok) {
     return {
@@ -3591,6 +3595,94 @@ var apiPlugin = (params) => {
     }
   };
 };
+var DEFAULT_CONCURRENCY = 10;
+var BATCH_START_DELAY_MS = 25;
+var DEFAULT_BATCH_TIMEOUT_MS = 18e4;
+async function batch(tasks, options = {}) {
+  const {
+    concurrency = DEFAULT_CONCURRENCY,
+    retry = true,
+    batchDelay = BATCH_START_DELAY_MS,
+    timeoutMs = DEFAULT_BATCH_TIMEOUT_MS,
+    taskTimeoutMs
+  } = options;
+  if (concurrency <= 0) {
+    throw new Error("Concurrency must be greater than 0");
+  }
+  if (timeoutMs <= 0) {
+    throw new Error("Timeout must be greater than 0");
+  }
+  if (taskTimeoutMs !== void 0 && taskTimeoutMs <= 0) {
+    throw new Error("Task timeout must be greater than 0");
+  }
+  if (tasks.length === 0) {
+    return [];
+  }
+  const startTime = Date.now();
+  const results = new Array(tasks.length);
+  const taskQueue = tasks.map((task, index) => ({
+    index,
+    task,
+    errorCount: 0
+  }));
+  async function executeTask(taskState) {
+    const { index, task, errorCount } = taskState;
+    try {
+      let result;
+      if (taskTimeoutMs !== void 0) {
+        const timeoutPromise = setTimeout$1(taskTimeoutMs).then(() => {
+          throw new ZapierTimeoutError(
+            `Task timed out after ${taskTimeoutMs}ms`
+          );
+        });
+        result = await Promise.race([task(), timeoutPromise]);
+      } else {
+        result = await task();
+      }
+      results[index] = { status: "fulfilled", value: result };
+    } catch (error) {
+      const newErrorCount = errorCount + 1;
+      const isTimeout = error instanceof ZapierTimeoutError;
+      if (retry && !isTimeout && newErrorCount < MAX_CONSECUTIVE_ERRORS) {
+        const waitTime = calculateWaitTime(1e3, newErrorCount);
+        await setTimeout$1(waitTime);
+        taskQueue.push({
+          index,
+          task,
+          errorCount: newErrorCount
+        });
+      } else {
+        results[index] = { status: "rejected", reason: error };
+      }
+    }
+  }
+  async function worker() {
+    while (taskQueue.length > 0) {
+      const elapsedTime = Date.now() - startTime;
+      if (elapsedTime >= timeoutMs) {
+        throw new ZapierTimeoutError(
+          `Batch operation timed out after ${Math.floor(elapsedTime / 1e3)}s. ${taskQueue.length} task(s) not completed.`
+        );
+      }
+      const taskState = taskQueue.shift();
+      if (!taskState) break;
+      await executeTask(taskState);
+      if (taskQueue.length > 0 && batchDelay > 0) {
+        await setTimeout$1(batchDelay);
+      }
+    }
+  }
+  const workerCount = Math.min(concurrency, tasks.length);
+  const workers = [];
+  for (let i = 0; i < workerCount; i++) {
+    workers.push(worker());
+    if (i < workerCount - 1 && batchDelay > 0) {
+      await setTimeout$1(batchDelay / 10);
+    }
+  }
+  await Promise.all(workers);
+  return results;
+}
 
 // src/plugins/registry/index.ts
 var registryPlugin = ({ sdk, context }) => {
@@ -3975,7 +4067,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.13.8"};
+  version: "0.13.9"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -4343,4 +4435,4 @@ function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
 }
 
-export { ActionKeyPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZAPIER_BASE_URL, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, createBaseEvent, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getCiPlatform, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isCi, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };
+export { ActionKeyPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZAPIER_BASE_URL, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, createBaseEvent, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getCiPlatform, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isCi, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };

package/dist/utils/batch-utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Batch Operation Utilities
+ *
+ * This module provides utilities for executing multiple async operations
+ * with concurrency control and retry logic.
+ */
+/**
+ * Options for batch execution
+ */
+export interface BatchOptions {
+    /**
+     * Maximum number of concurrent operations (default: 10)
+     * Lower values are more "polite" but slower
+     * Higher values are faster but risk rate limits
+     */
+    concurrency?: number;
+    /**
+     * Whether to retry failed operations (default: true)
+     * When enabled, each operation gets up to MAX_CONSECUTIVE_ERRORS retries
+     */
+    retry?: boolean;
+    /**
+     * Delay in milliseconds between starting batches (default: 100ms)
+     * Adds a small delay between concurrent batches to avoid burst patterns
+     */
+    batchDelay?: number;
+    /**
+     * Overall timeout for the entire batch operation in milliseconds (default: 180000ms / 3 minutes)
+     * When exceeded, throws ZapierTimeoutError and stops processing remaining tasks
+     */
+    timeoutMs?: number;
+    /**
+     * Timeout for individual tasks in milliseconds (default: none)
+     * When set, each task will be cancelled if it exceeds this duration
+     * Tasks that timeout will be marked as rejected in the results
+     */
+    taskTimeoutMs?: number;
+}
+/**
+ * Execute multiple async operations with concurrency limiting and retry logic
+ *
+ * This prevents overwhelming APIs by:
+ * 1. Limiting concurrent operations (worker pool pattern)
+ * 2. Adding small delays between batches to avoid burst detection
+ * 3. Retrying failed operations with exponential backoff
+ *
+ * Problem Solved:
+ * - Rate limit prevention: Steady stream instead of burst requests
+ * - Connection pool management: Stays within browser/Node limits (~6-8 per domain)
+ * - Resilience: Transient failures are retried automatically
+ * - Observability: Returns detailed success/failure info for each operation
+ *
+ * Example Usage:
+ * ```typescript
+ * // Instead of Promise.allSettled (fires all at once):
+ * const results = await Promise.allSettled(
+ *   actions.map(a => sdk.listInputFields(a))
+ * );
+ *
+ * // Use batch (controlled concurrency):
+ * const results = await batch(
+ *   actions.map(a => () => sdk.listInputFields(a)),
+ *   { concurrency: 10, retry: true }
+ * );
+ * ```
+ *
+ * @param tasks - Array of functions that return promises (NOT promises themselves!)
+ * @param options - Configuration for concurrency and retry behavior
+ * @returns Promise resolving to array of settled results (same as Promise.allSettled)
+ */
+export declare function batch<T>(tasks: (() => Promise<T>)[], options?: BatchOptions): Promise<PromiseSettledResult<T>[]>;
+//# sourceMappingURL=batch-utils.d.ts.map

package/dist/utils/batch-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-utils.d.ts","sourceRoot":"","sources":["../../src/utils/batch-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAuIpC"}