@zapier/zapier-sdk 0.23.2 → 0.25.0

package/dist/index.mjs

@@ -37,6 +37,7 @@ function isPositional(schema) {
 // src/constants.ts
 var ZAPIER_BASE_URL = process.env.ZAPIER_BASE_URL || "https://zapier.com";
 var MAX_PAGE_LIMIT = 1e4;
+var DEFAULT_ACTION_TIMEOUT_MS = 18e4;
 var ZAPIER_CREDENTIALS = process.env.ZAPIER_CREDENTIALS;
 var ZAPIER_CREDENTIALS_CLIENT_ID = process.env.ZAPIER_CREDENTIALS_CLIENT_ID;
 var ZAPIER_CREDENTIALS_CLIENT_SECRET = process.env.ZAPIER_CREDENTIALS_CLIENT_SECRET;
@@ -68,6 +69,9 @@ var OffsetPropertySchema = z.number().int().min(0).default(0).describe("Number o
 var OutputPropertySchema = z.string().describe("Output file path");
 var DebugPropertySchema = z.boolean().default(false).describe("Enable debug logging");
 var ParamsPropertySchema = z.record(z.string(), z.unknown()).describe("Additional parameters");
+var ActionTimeoutMsPropertySchema = z.number().min(1e3).optional().describe(
+  `Maximum time to wait for action completion in milliseconds (default: ${DEFAULT_ACTION_TIMEOUT_MS})`
+);
 
 // src/types/errors.ts
 var ZapierError = class extends Error {
@@ -205,7 +209,8 @@ HTTP Status: ${error.statusCode}`;
 }
 var ActionExecutionInputSchema = z.object({
   inputs: z.record(z.string(), z.unknown()).optional(),
-  authenticationId: AuthenticationIdPropertySchema.optional()
+  authenticationId: AuthenticationIdPropertySchema.optional(),
+  timeoutMs: ActionTimeoutMsPropertySchema
 }).describe(
   "Execute an action with the given inputs for the bound app, as an alternative to runAction"
 );
@@ -242,7 +247,11 @@ var ActionResultItemSchema = withFormatter(
 function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId) {
   return (actionOptions = {}) => {
     const { sdk } = options;
-    const { inputs, authenticationId: providedAuthenticationId } = actionOptions;
+    const {
+      inputs,
+      authenticationId: providedAuthenticationId,
+      timeoutMs
+    } = actionOptions;
     const authenticationId = pinnedAuthId ?? providedAuthenticationId;
     if (!authenticationId) {
       throw new ZapierValidationError(
@@ -254,7 +263,8 @@ function createActionFunction(appKey, actionType, actionKey, options, pinnedAuth
       actionType,
       actionKey,
       inputs,
-      authenticationId
+      authenticationId,
+      timeoutMs
     });
   };
 }
@@ -362,71 +372,136 @@ var appsPlugin = ({ sdk }) => {
     }
   };
 };
-var FetchUrlSchema = z.union([z.string(), z.instanceof(URL)]).describe("The URL to fetch");
+var FetchUrlSchema = z.union([z.string(), z.instanceof(URL)]).describe(
+  "The full URL of the API endpoint to call (proxied through Zapier's Relay service)"
+);
 var FetchInitSchema = z.object({
-  method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional(),
-  headers: z.record(z.string(), z.string()).optional(),
+  method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional().describe("HTTP method for the request (defaults to GET)"),
+  headers: z.record(z.string(), z.string()).optional().describe("HTTP headers to include in the request"),
   body: z.union([
     z.string(),
     z.instanceof(FormData),
     z.instanceof(URLSearchParams)
-  ]).optional(),
+  ]).optional().describe(
+    "Request body \u2014 JSON strings are auto-detected and Content-Type is set accordingly"
+  ),
   authenticationId: AuthenticationIdPropertySchema.optional(),
   callbackUrl: z.string().optional().describe("URL to send async response to (makes request async)"),
   authenticationTemplate: z.string().optional().describe(
     "Optional JSON string authentication template to bypass Notary lookup"
   )
-}).optional().describe("Fetch options including authentication");
+}).optional().describe(
+  "Request options including method, headers, body, and authentication"
+);
+
+// src/utils/id-utils.ts
+function coerceToNumericId(fieldName, value) {
+  if (value === "") {
+    throw new ZapierValidationError(`The ${fieldName} cannot be empty`);
+  }
+  const numericValue = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numericValue)) {
+    throw new ZapierValidationError(
+      `The ${fieldName} "${value}" could not be converted to a number`
+    );
+  }
+  return numericValue;
+}
 
 // src/plugins/fetch/index.ts
-var fetchPlugin = ({ sdk, context }) => {
+function transformUrlToRelayPath(url) {
+  const targetUrl = new URL(url);
+  return `/relay/${targetUrl.host}${targetUrl.pathname}${targetUrl.search}${targetUrl.hash}`;
+}
+function normalizeHeaders(optionsHeaders) {
+  const headers = {};
+  if (!optionsHeaders) {
+    return headers;
+  }
+  const headerEntries = optionsHeaders instanceof Headers ? Array.from(optionsHeaders.entries()) : Array.isArray(optionsHeaders) ? optionsHeaders : Object.entries(optionsHeaders);
+  for (const [key, value] of headerEntries) {
+    headers[key] = value;
+  }
+  return headers;
+}
+var fetchPlugin = ({ context }) => {
   return {
     fetch: async function fetch2(url, init) {
+      const { api } = context;
       const startTime = Date.now();
+      const isNested = init?._telemetry?.isNested === true;
       try {
         const {
           authenticationId,
           callbackUrl,
           authenticationTemplate,
+          _telemetry,
           ...fetchInit
         } = init || {};
-        const result = await sdk.request({
-          url: url.toString(),
-          method: fetchInit.method,
+        const relayPath = transformUrlToRelayPath(url);
+        const headers = normalizeHeaders(
+          fetchInit.headers
+        );
+        const hasContentType = Object.keys(headers).some(
+          (k) => k.toLowerCase() === "content-type"
+        );
+        if (fetchInit.body && !hasContentType) {
+          const bodyStr = typeof fetchInit.body === "string" ? fetchInit.body : JSON.stringify(fetchInit.body);
+          const trimmed = bodyStr.trimStart();
+          if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+            headers["Content-Type"] = "application/json; charset=utf-8";
+          }
+        }
+        if (authenticationId) {
+          headers["X-Relay-Authentication-Id"] = coerceToNumericId(
+            "authenticationId",
+            authenticationId
+          ).toString();
+        }
+        if (callbackUrl) {
+          headers["X-Relay-Callback-Url"] = callbackUrl;
+        }
+        if (authenticationTemplate) {
+          headers["X-Authentication-Template"] = authenticationTemplate;
+        }
+        const result = await api.fetch(relayPath, {
+          method: fetchInit.method ?? "GET",
           body: fetchInit.body,
-          headers: fetchInit.headers,
-          authenticationId,
-          callbackUrl,
-          authenticationTemplate,
-          _telemetry: { isNested: true }
-        });
-        context.eventEmission.emitMethodCalled({
-          method_name: "fetch",
-          execution_duration_ms: Date.now() - startTime,
-          success_flag: true,
-          error_message: null,
-          error_type: null,
-          argument_count: init ? 2 : 1,
-          is_paginated: false
+          headers,
+          authRequired: true
         });
+        if (!isNested) {
+          context.eventEmission.emitMethodCalled({
+            method_name: "fetch",
+            execution_duration_ms: Date.now() - startTime,
+            success_flag: true,
+            error_message: null,
+            error_type: null,
+            argument_count: init ? 2 : 1,
+            is_paginated: false
+          });
+        }
         return result;
       } catch (error) {
-        context.eventEmission.emitMethodCalled({
-          method_name: "fetch",
-          execution_duration_ms: Date.now() - startTime,
-          success_flag: false,
-          error_message: error instanceof Error ? error.message : String(error),
-          error_type: error instanceof Error ? error.constructor.name : "Unknown",
-          argument_count: init ? 2 : 1,
-          is_paginated: false
-        });
+        if (!isNested) {
+          context.eventEmission.emitMethodCalled({
+            method_name: "fetch",
+            execution_duration_ms: Date.now() - startTime,
+            success_flag: false,
+            error_message: error instanceof Error ? error.message : String(error),
+            error_type: error instanceof Error ? error.constructor.name : "Unknown",
+            argument_count: init ? 2 : 1,
+            is_paginated: false
+          });
+        }
         throw error;
       }
     },
     context: {
       meta: {
         fetch: {
-          packages: ["sdk"],
+          description: "Make authenticated HTTP requests to any API through Zapier's Relay service. Pass an authenticationId to automatically inject the user's stored credentials (OAuth tokens, API keys, etc.) into the outgoing request. Mirrors the native fetch(url, init?) signature with additional Zapier-specific options.",
+          packages: ["sdk", "cli", "mcp"],
           categories: ["http"],
           returnType: "Response",
           inputParameters: [
@@ -1805,20 +1880,6 @@ var RootFieldItemSchema = z.union([
   FieldsetItemSchema
 ]);
 
-// src/utils/id-utils.ts
-function coerceToNumericId(fieldName, value) {
-  if (value === "") {
-    throw new ZapierValidationError(`The ${fieldName} cannot be empty`);
-  }
-  const numericValue = typeof value === "number" ? value : Number(value);
-  if (!Number.isFinite(numericValue)) {
-    throw new ZapierValidationError(
-      `The ${fieldName} "${value}" could not be converted to a number`
-    );
-  }
-  return numericValue;
-}
-
 // src/services/implementations.ts
 async function fetchImplementationNeeds({
   api,
@@ -2658,6 +2719,7 @@ var RunActionSchema = z.object({
   inputs: InputsPropertySchema.optional().describe(
     "Input parameters for the action"
   ),
+  timeoutMs: ActionTimeoutMsPropertySchema,
   pageSize: z.number().min(1).optional().describe("Number of results per page"),
   maxItems: z.number().min(1).optional().describe("Maximum total items to return across all pages"),
   cursor: z.string().optional().describe("Cursor to start from")
@@ -2673,7 +2735,8 @@ async function executeAction(actionOptions) {
     actionKey,
     actionType,
     executionOptions,
-    authenticationId
+    authenticationId,
+    timeoutMs
   } = actionOptions;
   const selectedApi = await context.getVersionedImplementationId(appKey);
   if (!selectedApi) {
@@ -2703,6 +2766,7 @@ async function executeAction(actionOptions) {
   return await api.poll(`/zapier/api/actions/v1/runs/${runId}`, {
     successStatus: 200,
     pendingStatus: 202,
+    timeoutMs: timeoutMs ?? DEFAULT_ACTION_TIMEOUT_MS,
     isPending: (result) => {
       const data = result?.data;
       return data?.status === "waiting";
@@ -2718,7 +2782,8 @@ var runActionPlugin = ({ sdk, context }) => {
       actionKey,
       actionType,
       authenticationId,
-      inputs = {}
+      inputs = {},
+      timeoutMs
     } = options;
     const actionData = await sdk.getAction({
       appKey,
@@ -2742,7 +2807,9 @@ var runActionPlugin = ({ sdk, context }) => {
       actionKey,
       actionType,
       executionOptions: { inputs },
-      authenticationId});
+      authenticationId,
+      timeoutMs
+    });
     if (result.errors && result.errors.length > 0) {
       const errorMessage = result.errors.map(
         (error) => error.detail || error.title || "Unknown error"
@@ -2801,64 +2868,41 @@ var RelayRequestSchema = z.object({
     z.instanceof(Headers),
     z.array(z.tuple([z.string(), z.string()]))
   ]).optional().describe("Request headers")
-}).extend({
-  relayBaseUrl: z.string().optional().describe("Base URL for Relay service")
 }).merge(TelemetryMarkerSchema).describe("Make authenticated HTTP requests through Zapier's Relay service");
 var RelayFetchSchema = RelayRequestSchema;
 
-// src/plugins/request/index.ts
-function transformUrlToRelayPath(url) {
-  const targetUrl = new URL(url);
-  const relayPath = `/relay/${targetUrl.host}${targetUrl.pathname}${targetUrl.search}${targetUrl.hash}`;
-  return relayPath;
+// src/utils/logging.ts
+var loggedDeprecations = /* @__PURE__ */ new Set();
+function logDeprecation(message) {
+  if (loggedDeprecations.has(message)) return;
+  loggedDeprecations.add(message);
+  console.warn(`[zapier-sdk] Deprecation: ${message}`);
+}
+function resetDeprecationWarnings() {
+  loggedDeprecations.clear();
 }
-var requestPlugin = ({ context }) => {
+
+// src/plugins/request/index.ts
+var requestPlugin = ({ sdk, context }) => {
   async function request(options) {
-    const { api } = context;
+    logDeprecation("request() is deprecated. Use fetch() instead.");
     const {
       url,
-      method = "GET",
+      method,
       body,
-      headers: optionsHeaders,
+      headers,
       authenticationId,
       callbackUrl,
       authenticationTemplate
     } = options;
-    const relayPath = transformUrlToRelayPath(url);
-    const headers = {};
-    if (optionsHeaders) {
-      const headerEntries = optionsHeaders instanceof Headers ? Array.from(optionsHeaders.entries()) : Array.isArray(optionsHeaders) ? optionsHeaders : Object.entries(optionsHeaders);
-      for (const [key, value] of headerEntries) {
-        headers[key] = value;
-      }
-    }
-    const hasContentType = Object.keys(headers).some(
-      (k) => k.toLowerCase() === "content-type"
-    );
-    if (body && !hasContentType) {
-      const bodyStr = typeof body === "string" ? body : JSON.stringify(body);
-      const trimmed = bodyStr.trimStart();
-      if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-        headers["Content-Type"] = "application/json; charset=utf-8";
-      }
-    }
-    if (authenticationId) {
-      headers["X-Relay-Authentication-Id"] = coerceToNumericId(
-        "authenticationId",
-        authenticationId
-      ).toString();
-    }
-    if (callbackUrl) {
-      headers["X-Relay-Callback-Url"] = callbackUrl;
-    }
-    if (authenticationTemplate) {
-      headers["X-Authentication-Template"] = authenticationTemplate;
-    }
-    return await api.fetch(relayPath, {
+    return sdk.fetch(url, {
       method,
       body,
       headers,
-      authRequired: true
+      authenticationId,
+      callbackUrl,
+      authenticationTemplate,
+      _telemetry: { isNested: true }
     });
   }
   const requestDefinition = createFunction(
@@ -2874,7 +2918,8 @@ var requestPlugin = ({ context }) => {
     context: {
       meta: {
         request: {
-          categories: ["http"],
+          packages: ["cli", "mcp"],
+          categories: ["http", "deprecated"],
           returnType: "Response",
           inputSchema: RelayRequestSchema
         }
@@ -3583,9 +3628,8 @@ 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_TIMEOUT_BUFFER_MS = 1e4;
-var DEFAULT_POLLING_STAGES = [
+var DEFAULT_MAX_POLLING_INTERVAL_MS = 6e4;
+var POLLING_STAGES = [
   [125, 125],
   // Up to 125ms: poll every 125ms
   [375, 250],
@@ -3596,9 +3640,16 @@ var DEFAULT_POLLING_STAGES = [
   // Up to 10s: poll every 1s
   [3e4, 2500],
   // Up to 30s: poll every 2.5s
-  [6e4, 5e3]
+  [6e4, 5e3],
   // Up to 60s: poll every 5s
+  [18e4, 1e4]
+  // Up to 3min: poll every 10s
+  // Beyond 3min: use DEFAULT_MAX_POLLING_INTERVAL_MS (60s)
 ];
+function getPollingInterval(elapsedMs) {
+  const stage = POLLING_STAGES.find(([threshold]) => elapsedMs < threshold);
+  return stage ? stage[1] : DEFAULT_MAX_POLLING_INTERVAL_MS;
+}
 var processResponse = async (response, successStatus, pendingStatus, isPending, resultExtractor, errorCount) => {
   if (!response.ok) {
     return {
@@ -3667,23 +3718,12 @@ async function pollUntilComplete(options) {
   const startTime = Date.now();
   let attempts = 0;
   let errorCount = 0;
-  const pollingStages = [
-    ...DEFAULT_POLLING_STAGES,
-    [timeoutMs + MAX_TIMEOUT_BUFFER_MS, DEFAULT_MAX_POLLING_INTERVAL_MS]
-    // Up to timeout + 10s: poll every 10s
-  ];
   if (initialDelay > 0) {
     await setTimeout$1(initialDelay);
   }
   while (true) {
-    attempts++;
     const elapsedTime = Date.now() - startTime;
-    const pollingInterval = pollingStages.find(
-      ([maxTimeForStage, _interval]) => {
-        return elapsedTime < maxTimeForStage;
-      }
-    );
-    if (!pollingInterval) {
+    if (elapsedTime >= timeoutMs) {
       throw new ZapierTimeoutError(
         `Operation timed out after ${Math.floor(elapsedTime / 1e3)}s (${attempts} attempts)`,
         {
@@ -3691,10 +3731,12 @@ async function pollUntilComplete(options) {
         }
       );
     }
-    if (attempts > 1) {
-      const waitTime = calculateWaitTime(pollingInterval[1], errorCount);
+    if (attempts > 0) {
+      const interval = getPollingInterval(elapsedTime);
+      const waitTime = calculateWaitTime(interval, errorCount);
       await setTimeout$1(waitTime);
     }
+    attempts++;
     try {
       const response = await fetchPoll();
       const {
@@ -3747,17 +3789,6 @@ function isCredentialsFunction(credentials) {
   return typeof credentials === "function";
 }
 
-// src/utils/logging.ts
-var loggedDeprecations = /* @__PURE__ */ new Set();
-function logDeprecation(message) {
-  if (loggedDeprecations.has(message)) return;
-  loggedDeprecations.add(message);
-  console.warn(`[zapier-sdk] Deprecation: ${message}`);
-}
-function resetDeprecationWarnings() {
-  loggedDeprecations.clear();
-}
-
 // src/utils/url-utils.ts
 function getZapierBaseUrl(baseUrl) {
   if (!baseUrl) {
@@ -4615,6 +4646,7 @@ var registryPlugin = ({ sdk, context }) => {
     const meta = context.meta[key];
     return {
       name: key,
+      description: meta.description,
       type: meta.type,
       itemType: meta.itemType,
       returnType: meta.returnType,
@@ -5075,7 +5107,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.23.2"};
+  version: "0.25.0"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5529,10 +5561,10 @@ function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} })
   };
 }
 function createZapierSdkWithoutRegistry(options = {}) {
-  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(requestPlugin).addPlugin(fetchPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
+  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 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_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listClientCredentialsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, toSnakeCase, toTitleCase };
+export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listClientCredentialsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, toSnakeCase, toTitleCase };

package/dist/plugins/apps/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGlE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAwJD,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,UAAU,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,oCAAoC;AAC/F,EAAE,EAAE,0BAA0B;AAC9B,kBAAkB,CAyBnB,CAAC;AAGF,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,WAAW,aAAa;CAAG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGlE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AA4JD,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,UAAU,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,oCAAoC;AAC/F,EAAE,EAAE,0BAA0B;AAC9B,kBAAkB,CAyBnB,CAAC;AAGF,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,WAAW,aAAa;CAAG"}

package/dist/plugins/apps/index.js

@@ -4,7 +4,7 @@ import { ActionResultItemSchema } from "../../schemas/Run";
 function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId) {
     return (actionOptions = {}) => {
         const { sdk } = options;
-        const { inputs, authenticationId: providedAuthenticationId } = actionOptions;
+        const { inputs, authenticationId: providedAuthenticationId, timeoutMs, } = actionOptions;
         // Use pinned auth ID first, then provided auth ID
         const authenticationId = pinnedAuthId ?? providedAuthenticationId;
         if (!authenticationId) {
@@ -17,6 +17,7 @@ function createActionFunction(appKey, actionType, actionKey, options, pinnedAuth
             actionKey,
             inputs,
             authenticationId,
+            timeoutMs,
         });
     };
 }

package/dist/plugins/apps/schemas.d.ts

@@ -3,6 +3,7 @@ import { type AuthenticationIdProperty } from "../../types/properties";
 export declare const ActionExecutionInputSchema: z.ZodObject<{
     inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     authenticationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ActionExecutionOptions = z.infer<typeof ActionExecutionInputSchema>;
 export declare const AppFactoryInputSchema: z.ZodObject<{

package/dist/plugins/apps/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,0BAA0B;;;iBAOpC,CAAC;AAGJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEhF,eAAO,MAAM,qBAAqB;;iBAIgB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,UAAU,mBAAmB;IAC3B,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC9D,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACpD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;CACL;AAGD,UAAU,eAAe;IACvB,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AAGD,KAAK,eAAe,GAAG,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEtE,UAAU,QAAQ;IAChB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;CACjC;AAED,UAAU,UAAU;IAClB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;CACtC;AAGD,KAAK,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACpC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,0BAA0B;;;;iBAQpC,CAAC;AAGJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEhF,eAAO,MAAM,qBAAqB;;iBAIgB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,UAAU,mBAAmB;IAC3B,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC9D,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACpD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;CACL;AAGD,UAAU,eAAe;IACvB,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AAGD,KAAK,eAAe,GAAG,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEtE,UAAU,QAAQ;IAChB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;CACjC;AAED,UAAU,UAAU;IAClB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;CACtC;AAGD,KAAK,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACpC"}

package/dist/plugins/apps/schemas.js

@@ -1,9 +1,10 @@
 import { z } from "zod";
-import { AuthenticationIdPropertySchema, } from "../../types/properties";
+import { AuthenticationIdPropertySchema, ActionTimeoutMsPropertySchema, } from "../../types/properties";
 export const ActionExecutionInputSchema = z
     .object({
     inputs: z.record(z.string(), z.unknown()).optional(),
     authenticationId: AuthenticationIdPropertySchema.optional(),
+    timeoutMs: ActionTimeoutMsPropertySchema,
 })
     .describe("Execute an action with the given inputs for the bound app, as an alternative to runAction");
 export const AppFactoryInputSchema = z

package/dist/plugins/fetch/index.d.ts

@@ -1,5 +1,5 @@
-import type { Plugin, GetSdkType } from "../../types/plugin";
-import type { RequestPluginProvides } from "../request";
+import type { Plugin } from "../../types/plugin";
+import type { ApiClient } from "../../api";
 import type { z } from "zod";
 import type { EventEmissionContext } from "../eventEmission";
 export interface FetchPluginProvides {
@@ -7,10 +7,14 @@ export interface FetchPluginProvides {
         authenticationId?: string | number;
         callbackUrl?: string;
         authenticationTemplate?: string;
+        _telemetry?: {
+            isNested?: boolean;
+        };
     }) => Promise<Response>;
     context: {
         meta: {
             fetch: {
+                description: string;
                 packages: string[];
                 categories: string[];
                 returnType: string;
@@ -23,10 +27,14 @@ export interface FetchPluginProvides {
     };
 }
 /**
- * Direct plugin function - takes options + sdk + context in one object
+ * Fetch plugin — the primary way to make authenticated HTTP requests through Zapier's Relay service.
+ * Mirrors the native fetch(url, init?) signature with additional Zapier-specific options.
  */
-export declare const fetchPlugin: Plugin<GetSdkType<RequestPluginProvides>, // requires request in SDK
-EventEmissionContext, // requires eventEmission context for telemetry
+export declare const fetchPlugin: Plugin<{}, // no SDK dependencies
+// no SDK dependencies
+{
+    api: ApiClient;
+} & EventEmissionContext, // requires api + eventEmission in context
 FetchPluginProvides>;
 export type ZapierFetchInitOptions = RequestInit & {
     authenticationId?: string | number;

package/dist/plugins/fetch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,UAAU,EAAE,MAAM,EAAE,CAAC;gBACrB,UAAU,EAAE,MAAM,CAAC;gBACnB,eAAe,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;iBAAE,CAAC,CAAC;aAC/D,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,UAAU,CAAC,qBAAqB,CAAC,EAAE,0BAA0B;AAC7D,oBAAoB,EAAE,+CAA+C;AACrE,mBAAmB,CA2EpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAoC7D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,UAAU,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,WAAW,EAAE,MAAM,CAAC;gBACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,UAAU,EAAE,MAAM,EAAE,CAAC;gBACrB,UAAU,EAAE,MAAM,CAAC;gBACnB,eAAe,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;iBAAE,CAAC,CAAC;aAC/D,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,EAAE,EAAE,sBAAsB;AAC1B,AADI,sBAAsB;AAC1B;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAAG,oBAAoB,EAAE,0CAA0C;AACrF,mBAAmB,CAsHpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC"}