@zapier/zapier-sdk 0.87.1 → 0.88.0

package/dist/{chunk-S6IN256D.cjs → chunk-AVB4LBN5.cjs}

@@ -3855,7 +3855,7 @@ function getZapierSdkService() {
 }
 var MAX_PAGE_LIMIT = 1e4;
 var DEFAULT_PAGE_SIZE = 100;
-var DEFAULT_ACTION_TIMEOUT_MS = 18e4;
+var DEFAULT_ACTION_TIMEOUT_MILLISECONDS = 18e4;
 function parseIntEnvVar(name) {
   const value = globalThis.process?.env?.[name];
   if (value === void 0) return void 0;
@@ -3869,7 +3869,10 @@ function parseIntEnvVar(name) {
   return parsed;
 }
 var ZAPIER_MAX_NETWORK_RETRIES = parseIntEnvVar("ZAPIER_MAX_NETWORK_RETRIES") ?? 3;
-var ZAPIER_MAX_NETWORK_RETRY_DELAY_MS = parseIntEnvVar("ZAPIER_MAX_NETWORK_RETRY_DELAY_MS") ?? 6e4;
+var maxNetworkRetryDelaySecondsEnv = parseIntEnvVar(
+  "ZAPIER_MAX_NETWORK_RETRY_DELAY_SECONDS"
+);
+var ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS = (maxNetworkRetryDelaySecondsEnv != null ? maxNetworkRetryDelaySecondsEnv * 1e3 : void 0) ?? parseIntEnvVar("ZAPIER_MAX_NETWORK_RETRY_DELAY_MS") ?? 6e4;
 var MAX_CONCURRENCY_LIMIT = 1e4;
 function parseConcurrencyEnvVar(name) {
   const value = globalThis.process?.env?.[name];
@@ -3900,7 +3903,7 @@ function getZapierDefaultApprovalMode() {
   const isInteractive = !!globalThis.process?.stdin?.isTTY && !!globalThis.process?.stdout?.isTTY;
   return isInteractive ? "poll" : "throw";
 }
-var DEFAULT_APPROVAL_TIMEOUT_MS = 10 * 60 * 1e3;
+var DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS = 10 * 60 * 1e3;
 var DEFAULT_MAX_APPROVAL_RETRIES = 2;
 
 // src/types/properties.ts
@@ -3942,8 +3945,11 @@ var OffsetPropertySchema = zod.z.number().int().min(0).default(0).describe("Numb
 var OutputPropertySchema = zod.z.string().describe("Output file path");
 var DebugPropertySchema = zod.z.boolean().default(false).describe("Enable debug logging");
 var ParamsPropertySchema = zod.z.record(zod.z.string(), zod.z.unknown()).describe("Additional parameters");
-var ActionTimeoutMsPropertySchema = zod.z.number().min(1e3).optional().describe(
-  `Maximum time to wait for action completion in milliseconds (default: ${DEFAULT_ACTION_TIMEOUT_MS})`
+var ActionTimeoutSecondsPropertySchema = zod.z.number().min(1).optional().describe(
+  `Maximum time to wait for action completion in seconds (default: ${DEFAULT_ACTION_TIMEOUT_MILLISECONDS / 1e3})`
+);
+var ActionTimeoutMillisecondsPropertySchema = zod.z.number().min(1e3).optional().describe(
+  `Maximum time to wait for action completion in milliseconds (default: ${DEFAULT_ACTION_TIMEOUT_MILLISECONDS})`
 );
 var TablePropertySchema = withPositional(
   zod.z.string().regex(/^[A-Z0-9]{26}$/, "Table ID must be a valid ULID").describe("The unique identifier of the table")
@@ -4351,11 +4357,18 @@ var ActionExecutionInputSchema = zod.z.object({
   authenticationId: AuthenticationIdPropertySchema.optional().meta({
     deprecated: true
   }),
-  timeoutMs: ActionTimeoutMsPropertySchema
+  timeoutSeconds: ActionTimeoutSecondsPropertySchema,
+  /** @deprecated Use `timeoutSeconds` instead. */
+  timeoutMs: ActionTimeoutMillisecondsPropertySchema.meta({
+    deprecated: true
+  })
 }).describe(
   "Execute an action with the given inputs for the bound app, as an alternative to runAction"
 ).meta({
-  aliases: { connectionId: "connection", authenticationId: "connection" }
+  aliases: {
+    connectionId: "connection",
+    authenticationId: "connection"
+  }
 });
 var AppFactoryInputSchema = zod.z.object({
   /** @deprecated Use `connection` instead. */
@@ -4533,19 +4546,19 @@ function createDebugFetch(options) {
 
 // src/utils/retry-utils.ts
 var MAX_CONSECUTIVE_ERRORS = 3;
-var BASE_ERROR_BACKOFF_MS = 1e3;
-var BASE_EXPONENTIAL_BACKOFF_MS = 1e3;
+var BASE_ERROR_BACKOFF_MILLISECONDS = 1e3;
+var BASE_EXPONENTIAL_BACKOFF_MILLISECONDS = 1e3;
 var JITTER_FACTOR = 0.5;
 function calculateErrorBackoffMs(baseInterval, errorCount) {
   const jitter = Math.random() * JITTER_FACTOR * baseInterval;
   const errorBackoff = Math.min(
-    BASE_ERROR_BACKOFF_MS * (errorCount / 2),
+    BASE_ERROR_BACKOFF_MILLISECONDS * (errorCount / 2),
     baseInterval * 2
     // Cap error backoff at 2x the base interval
   );
   return Math.floor(baseInterval + jitter + errorBackoff);
 }
-function calculateExponentialBackoffMs(attempt, baseDelayMs = BASE_EXPONENTIAL_BACKOFF_MS) {
+function calculateExponentialBackoffMs(attempt, baseDelayMs = BASE_EXPONENTIAL_BACKOFF_MILLISECONDS) {
   const baseDelay = baseDelayMs * Math.pow(2, attempt - 1);
   const jitter = Math.random() * JITTER_FACTOR * baseDelay;
   return Math.floor(baseDelay + jitter);
@@ -4648,11 +4661,11 @@ function combineAbortSignals({
 }
 
 // src/api/polling.ts
-var DEFAULT_TIMEOUT_MS = 18e4;
+var DEFAULT_TIMEOUT_MILLISECONDS = 18e4;
 var DEFAULT_SUCCESS_STATUS = 200;
 var DEFAULT_PENDING_STATUS = 202;
-var DEFAULT_INITIAL_DELAY_MS = 50;
-var DEFAULT_MAX_POLLING_INTERVAL_MS = 6e4;
+var DEFAULT_INITIAL_DELAY_MILLISECONDS = 50;
+var DEFAULT_MAX_POLLING_INTERVAL_MILLISECONDS = 6e4;
 var POLLING_STAGES = [
   [125, 125],
   // Up to 125ms: poll every 125ms
@@ -4668,11 +4681,11 @@ var POLLING_STAGES = [
   // Up to 60s: poll every 5s
   [18e4, 1e4]
   // Up to 3min: poll every 10s
-  // Beyond 3min: use DEFAULT_MAX_POLLING_INTERVAL_MS (60s)
+  // Beyond 3min: use DEFAULT_MAX_POLLING_INTERVAL_MILLISECONDS (60s)
 ];
 function getPollingInterval(elapsedMs) {
   const stage = POLLING_STAGES.find(([threshold]) => elapsedMs < threshold);
-  return stage ? stage[1] : DEFAULT_MAX_POLLING_INTERVAL_MS;
+  return stage ? stage[1] : DEFAULT_MAX_POLLING_INTERVAL_MILLISECONDS;
 }
 function makeAbortError() {
   if (typeof DOMException !== "undefined") {
@@ -4730,8 +4743,8 @@ var processResponse = async (response, successStatus, pendingStatus, isPending,
 async function pollUntilComplete(options) {
   const {
     fetchPoll,
-    timeoutMs = DEFAULT_TIMEOUT_MS,
-    initialDelay = DEFAULT_INITIAL_DELAY_MS,
+    timeoutMs = DEFAULT_TIMEOUT_MILLISECONDS,
+    initialDelay = DEFAULT_INITIAL_DELAY_MILLISECONDS,
     successStatus = DEFAULT_SUCCESS_STATUS,
     pendingStatus = DEFAULT_PENDING_STATUS,
     isPending,
@@ -5178,7 +5191,7 @@ function clearTokenCache() {
   cachedCliLogin = void 0;
   cachedDefaultCache = void 0;
 }
-var TOKEN_EXPIRATION_BUFFER_MS = 5 * 60 * 1e3;
+var TOKEN_EXPIRATION_BUFFER_MILLISECONDS = 5 * 60 * 1e3;
 async function resolveCache(options) {
   if (options.cache) return options.cache;
   if (cachedDefaultCache !== void 0) return cachedDefaultCache;
@@ -5199,7 +5212,7 @@ async function resolveCache(options) {
 }
 function entryIsValid(entry) {
   if (entry.expiresAt === void 0) return true;
-  return entry.expiresAt > Date.now() + TOKEN_EXPIRATION_BUFFER_MS;
+  return entry.expiresAt > Date.now() + TOKEN_EXPIRATION_BUFFER_MILLISECONDS;
 }
 async function readCachedToken(cacheKey, cache) {
   const cached = await cache.get(cacheKey);
@@ -5815,7 +5828,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.87.1" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.88.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -5926,7 +5939,7 @@ var PollApprovalResponseSchema = zod.z.object({
   mode: ApprovalModeSchema.optional(),
   reason: zod.z.string().optional()
 });
-var APPROVAL_MAX_POLLING_INTERVAL_MS = 5e3;
+var APPROVAL_MAX_POLLING_INTERVAL_MILLISECONDS = 5e3;
 function validateSdkPath(path) {
   if (!path.startsWith("/") || path.startsWith("//")) {
     throw new ZapierValidationError(
@@ -6091,7 +6104,7 @@ var ZapierApiClient = class {
         }
         const rateLimitInfo = parseRateLimitHeaders(response);
         const delayMs = rateLimitInfo.retryAfterMs ?? calculateExponentialBackoffMs(retries + 1);
-        if (delayMs > this.maxNetworkRetryDelayMs || retries >= this.maxNetworkRetries) {
+        if (delayMs > this.maxNetworkRetryDelayMilliseconds || retries >= this.maxNetworkRetries) {
           throw new ZapierRateLimitError("Rate limited", {
             statusCode: 429,
             rateLimit: rateLimitInfo,
@@ -6348,8 +6361,8 @@ var ZapierApiClient = class {
           authRequired: options.authRequired,
           signal: options.signal
         }),
-        initialDelay: options.initialDelay,
-        timeoutMs: options.timeoutMs,
+        initialDelay: options.initialDelayMilliseconds ?? options.initialDelay,
+        timeoutMs: options.timeoutMilliseconds ?? options.timeoutMs,
         successStatus: options.successStatus,
         pendingStatus: options.pendingStatus,
         isPending: options.isPending,
@@ -6358,7 +6371,7 @@ var ZapierApiClient = class {
       });
     };
     this.maxNetworkRetries = options.maxNetworkRetries ?? ZAPIER_MAX_NETWORK_RETRIES;
-    this.maxNetworkRetryDelayMs = options.maxNetworkRetryDelayMs ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MS;
+    this.maxNetworkRetryDelayMilliseconds = options.maxNetworkRetryDelayMilliseconds ?? options.maxNetworkRetryDelayMs ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS;
     const requested = options.maxConcurrentRequests;
     const limit = requested === void 0 || Number.isNaN(requested) ? ZAPIER_MAX_CONCURRENT_REQUESTS : requested;
     if (limit !== Infinity && (!Number.isInteger(limit) || limit < 1 || limit > MAX_CONCURRENCY_LIMIT)) {
@@ -6933,7 +6946,7 @@ var ZapierApiClient = class {
       }
       await openApproval(approval.approval_url);
     }
-    const timeoutMs = this.options.approvalTimeoutMs ?? DEFAULT_APPROVAL_TIMEOUT_MS;
+    const timeoutMs = this.options.approvalTimeoutMilliseconds ?? this.options.approvalTimeoutMs ?? DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS;
     let streamAbortController;
     let streamPromise;
     let removeStreamAbortListener;
@@ -6973,7 +6986,7 @@ var ZapierApiClient = class {
           })
         ),
         timeoutMs,
-        maxPollingIntervalMs: APPROVAL_MAX_POLLING_INTERVAL_MS,
+        maxPollingIntervalMs: APPROVAL_MAX_POLLING_INTERVAL_MILLISECONDS,
         signal,
         isPending: (body2) => {
           const parsed = PollApprovalResponseSchema.safeParse(body2);
@@ -7153,8 +7166,10 @@ var apiPlugin = defineProperty({
       onEvent,
       debug = false,
       maxNetworkRetries = ZAPIER_MAX_NETWORK_RETRIES,
-      maxNetworkRetryDelayMs = ZAPIER_MAX_NETWORK_RETRY_DELAY_MS,
+      maxNetworkRetryDelaySeconds,
+      maxNetworkRetryDelayMs,
       maxConcurrentRequests = ZAPIER_MAX_CONCURRENT_REQUESTS,
+      approvalTimeoutSeconds,
       approvalTimeoutMs,
       maxApprovalRetries,
       approvalMode,
@@ -7169,9 +7184,9 @@ var apiPlugin = defineProperty({
       fetch: customFetch,
       onEvent,
       maxNetworkRetries,
-      maxNetworkRetryDelayMs,
+      maxNetworkRetryDelayMilliseconds: (maxNetworkRetryDelaySeconds != null ? maxNetworkRetryDelaySeconds * 1e3 : maxNetworkRetryDelayMs) ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS,
       maxConcurrentRequests,
-      approvalTimeoutMs,
+      approvalTimeoutMilliseconds: approvalTimeoutSeconds != null ? approvalTimeoutSeconds * 1e3 : approvalTimeoutMs,
       maxApprovalRetries,
       approvalMode,
       openAutoModeApprovalsInBrowser,
@@ -7879,9 +7894,13 @@ var FetchInitZapierFieldsSchema = zod.z.object({
     deprecated: true
   }),
   callbackUrl: zod.z.string().optional().describe("URL to send async response to (makes request async)"),
+  maxTimeSeconds: zod.z.number().int().positive().optional().describe(
+    "Maximum seconds to wait for a response. Honored on a best-effort basis; the server may silently enforce a lower ceiling."
+  ),
+  /** @deprecated Use `maxTimeSeconds` instead. */
   maxTime: zod.z.number().int().positive().optional().describe(
     "Maximum seconds to wait for a response. Honored on a best-effort basis; the server may silently enforce a lower ceiling."
-  )
+  ).meta({ deprecated: true })
 });
 var FetchInitSchema = zod.z.object({
   method: zod.z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional().describe("HTTP method for the request (defaults to GET)"),
@@ -7897,7 +7916,11 @@ var FetchInitSchema = zod.z.object({
 }).extend(FetchInitZapierFieldsSchema.shape).optional().describe(
   "Request options including method, headers, body, and authentication"
 ).meta({
-  aliases: { connectionId: "connection", authenticationId: "connection" }
+  aliases: {
+    connectionId: "connection",
+    authenticationId: "connection",
+    maxTime: "maxTimeSeconds"
+  }
 });
 var FetchInputSchema = zod.z.object({
   url: FetchUrlSchema,
@@ -7948,7 +7971,7 @@ function rewrapIfMaxTimeTimeout({
   const reason = abortSignal.reason;
   if (!reason || reason.name !== "TimeoutError") return error;
   return new ZapierTimeoutError(
-    `fetch timed out after ${maxTimeSeconds}s (maxTime)`,
+    `fetch timed out after ${maxTimeSeconds}s (maxTimeSeconds)`,
     { cause: error }
   );
 }
@@ -8013,9 +8036,11 @@ var fetchPlugin = defineMethod({
       connection,
       authenticationId,
       callbackUrl,
+      maxTimeSeconds: maxTimeSecondsInput,
       maxTime,
       ...fetchInit
     } = init || {};
+    const maxTimeSeconds = maxTimeSecondsInput ?? maxTime;
     const resolvedConnectionId = await resolveConnectionId({
       connectionId,
       connection,
@@ -8044,13 +8069,13 @@ var fetchPlugin = defineMethod({
     if (callbackUrl) {
       headers["X-Relay-Callback-Url"] = callbackUrl;
     }
-    if (maxTime !== void 0) {
-      headers["X-Zapier-Sdk-Max-Time"] = String(maxTime);
+    if (maxTimeSeconds !== void 0) {
+      headers["X-Zapier-Sdk-Max-Time"] = String(maxTimeSeconds);
     }
     const upstreamUrl = new URL(url).toString();
     const method = (fetchInit.method ?? "GET").toUpperCase();
     const abortHandle = buildAbortHandle({
-      maxTimeSeconds: maxTime,
+      maxTimeSeconds,
       callerSignal: fetchInit.signal
     });
     try {
@@ -8080,7 +8105,7 @@ var fetchPlugin = defineMethod({
       throw rewrapIfMaxTimeTimeout({
         error,
         abortSignal: abortHandle?.signal,
-        maxTimeSeconds: maxTime
+        maxTimeSeconds
       });
     } finally {
       abortHandle?.dispose();
@@ -8100,7 +8125,9 @@ var RunActionBaseSchema = zod.z.object({
   inputs: InputsPropertySchema.optional().describe(
     "Input parameters for the action"
   ),
-  timeoutMs: ActionTimeoutMsPropertySchema,
+  timeoutSeconds: ActionTimeoutSecondsPropertySchema,
+  /** @deprecated Use `timeoutSeconds` instead. */
+  timeoutMs: ActionTimeoutMillisecondsPropertySchema.meta({ deprecated: true }),
   pageSize: zod.z.number().min(1).optional().describe("Number of results per page"),
   maxItems: zod.z.number().min(1).optional().describe("Maximum total items to return across all pages"),
   cursor: zod.z.string().optional().describe("Cursor to start from")
@@ -9854,7 +9881,7 @@ async function executeAction(actionOptions) {
     executionOptions,
     cursor,
     connectionId,
-    timeoutMs
+    timeoutMilliseconds
   } = actionOptions;
   const runRequestData = {
     selected_api: selectedApi,
@@ -9890,7 +9917,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,
+    timeoutMilliseconds: timeoutMilliseconds ?? DEFAULT_ACTION_TIMEOUT_MILLISECONDS,
     resource: { type: "run", id: runId },
     isPending: (result) => {
       const data = result?.data;
@@ -9899,7 +9926,7 @@ async function executeAction(actionOptions) {
     resultExtractor: (result) => result.data
   });
 }
-var CONTEXT_CACHE_TTL_MS = 6e4;
+var CONTEXT_CACHE_TTL_MILLISECONDS = 6e4;
 var CONTEXT_CACHE_MAX_SIZE = 500;
 var runActionPlugin = defineMethod({
   name: "runAction",
@@ -9980,7 +10007,7 @@ var runActionPlugin = defineMethod({
       evictIfNeeded();
       cache.set(contextKey, {
         promise: pending,
-        expiresAt: Date.now() + CONTEXT_CACHE_TTL_MS
+        expiresAt: Date.now() + CONTEXT_CACHE_TTL_MILLISECONDS
       });
       return pending;
     }
@@ -9997,9 +10024,9 @@ var runActionPlugin = defineMethod({
       connection,
       authenticationId,
       inputs = {},
-      cursor,
-      timeoutMs
+      cursor
     } = input;
+    const timeoutMilliseconds = input.timeoutSeconds != null ? input.timeoutSeconds * 1e3 : input.timeoutMs;
     const resolvedConnectionId = await resolveConnectionId({
       connectionId,
       connection,
@@ -10027,7 +10054,7 @@ var runActionPlugin = defineMethod({
       executionOptions: { inputs },
       cursor,
       connectionId: resolvedConnectionId,
-      timeoutMs
+      timeoutMilliseconds
     });
     if (result.errors && result.errors.length > 0) {
       const errorMessage2 = result.errors.map(
@@ -10084,6 +10111,7 @@ function createActionFunction(appKey, actionType, actionKey, imports, pinnedAuth
       connectionId: providedConnectionId,
       connection: providedConnection,
       authenticationId: providedAuthenticationId,
+      timeoutSeconds,
       timeoutMs
     } = actionOptions;
     const { connectionId, connection } = resolveProxyConnection({
@@ -10100,6 +10128,7 @@ function createActionFunction(appKey, actionType, actionKey, imports, pinnedAuth
       action: actionKey,
       inputs,
       connection: connectionId ?? connection,
+      timeoutSeconds,
       timeoutMs
     });
   };
@@ -11651,12 +11680,18 @@ var WaitForNewConnectionSchema = zod.z.object({
   startedAt: zod.z.number().int().nonnegative().describe(
     "Unix timestamp (seconds). Only connections whose `date` is at or after this value count as 'new'. Prefer the `startedAt` returned by `get-connection-start-url` \u2014 it's server-stamped, so the comparison isn't thrown off by client clock skew. If you mint the timestamp yourself, capture it *before* showing the start URL so a fast OAuth completion isn't missed."
   ),
+  timeoutSeconds: zod.z.number().int().positive().optional().describe("How long to wait before giving up. Default 5 minutes (300)."),
+  /** @deprecated Use `timeoutSeconds` instead. */
   timeoutMs: zod.z.number().int().positive().optional().describe(
     "How long to wait before giving up. Default 5 minutes (300_000)."
+  ).meta({ deprecated: true }),
+  pollIntervalMilliseconds: zod.z.number().int().positive().optional().describe(
+    "Delay before the first poll request, in ms. Default 3 seconds (3_000). Subsequent polling cadence is managed by the SDK's polling primitive (backoff with sane defaults)."
   ),
+  /** @deprecated Use `pollIntervalMilliseconds` instead. */
   pollIntervalMs: zod.z.number().int().positive().optional().describe(
     "Delay before the first poll request, in ms. Default 3 seconds (3_000). Subsequent polling cadence is managed by the SDK's polling primitive (backoff with sane defaults)."
-  )
+  ).meta({ deprecated: true })
 }).describe(
   "Wait for a new connection to appear for the given app. Polls `/api/v0/connections` with server-side `ordering=-date` until the most recent matching row's `date` is at or after the started-at timestamp, then returns it. Pair with `get-connection-start-url` \u2014 that mints the URL the user opens, this waits for the resulting connection to land. Errors with a timeout after the configured timeout (default 5 min). Example (JS):\n\n```ts\nconst { data: { url, app, startedAt } } = await zapier.getConnectionStartUrl({ app: 'slack' });\n// show `url` to the user via the channel they're reading from\nconst { data: conn } = await zapier.waitForNewConnection({ app, startedAt });\n```"
 );
@@ -11703,8 +11738,8 @@ var waitForNewConnectionPlugin = defineMethod({
           page_size: "1"
         },
         authRequired: true,
-        timeoutMs: input.timeoutMs ?? 3e5,
-        initialDelay: input.pollIntervalMs ?? 3e3,
+        timeoutMilliseconds: input.timeoutSeconds != null ? input.timeoutSeconds * 1e3 : input.timeoutMs ?? 3e5,
+        initialDelayMilliseconds: input.pollIntervalMilliseconds ?? input.pollIntervalMs ?? 3e3,
         isPending: (body) => {
           const rows = body.data ?? [];
           const head = rows[0];
@@ -11754,12 +11789,20 @@ var CreateConnectionSchema = zod.z.object({
   browser: zod.z.enum(["auto", "always", "never"]).default("auto").describe(
     "When to auto-open the URL in a browser. `auto` (default) opens in local sessions and skips opening in CI / SSH / headless-Linux. `always` forces the open attempt. `never` skips it. The URL is always printed to stderr regardless \u2014 a failed or skipped open degrades gracefully to copy-paste."
   ),
+  timeoutSeconds: zod.z.number().int().positive().optional().describe(
+    "How long to wait for the user to complete the connection flow before giving up. Default 5 minutes (300)."
+  ),
+  /** @deprecated Use `timeoutSeconds` instead. */
   timeoutMs: zod.z.number().int().positive().optional().describe(
     "How long to wait for the user to complete the connection flow before giving up. Default 5 minutes (300_000)."
+  ).meta({ deprecated: true }),
+  pollIntervalMilliseconds: zod.z.number().int().positive().optional().describe(
+    "Delay before the first poll request, in ms. Default 3 seconds (3_000). Subsequent polling cadence is managed by the SDK's polling primitive (backoff with sane defaults)."
   ),
+  /** @deprecated Use `pollIntervalMilliseconds` instead. */
   pollIntervalMs: zod.z.number().int().positive().optional().describe(
     "Delay before the first poll request, in ms. Default 3 seconds (3_000). Subsequent polling cadence is managed by the SDK's polling primitive (backoff with sane defaults)."
-  )
+  ).meta({ deprecated: true })
 }).describe(
   "Create a new app connection, end-to-end. Mints the start URL via `get-connection-start-url`, prints it to stderr, opportunistically opens it in a browser when it looks safe to do so (skipping CI / SSH / headless-Linux by default \u2014 pass `--browser always` to force, `--browser never` to suppress), then polls via `wait-for-new-connection` until the user completes OAuth and the new connection appears. Returns the connection.\n\nThis is the right command for most callers. Reach for the lower-level building blocks when you want either of: (a) hand off the URL and *not* block on completion \u2014 call `get-connection-start-url` alone, no `wait-for-new-connection` needed, or (b) do something custom between minting the URL and waiting \u2014 call `get-connection-start-url`, do your work (email or DM the URL, render a QR code, etc.), then `wait-for-new-connection`."
 );
@@ -11821,8 +11864,9 @@ Open this URL to complete the connection:
       // Server-stamped mint time: measured on the same clock as a connection's
       // `date`, so the freshness check is immune to client/server clock skew.
       startedAt: start2.startedAt,
+      timeoutSeconds: input.timeoutSeconds,
       timeoutMs: input.timeoutMs,
-      pollIntervalMs: input.pollIntervalMs
+      pollIntervalMilliseconds: input.pollIntervalMilliseconds ?? input.pollIntervalMs
     });
     return {
       data: CreateConnectionItemSchema.parse({
@@ -13181,9 +13225,9 @@ async function* readInboxEvents({
 }
 
 // src/plugins/triggers/watchTriggerInbox/index.ts
-var SSE_RECONNECT_BACKOFF_MS = [500, 1e3, 2e3, 5e3];
-var DEFAULT_SAFETY_DRAIN_INTERVAL_MS = 3e5;
-var SSE_HEALTHY_CONNECTION_MS = 5e3;
+var SSE_RECONNECT_BACKOFF_MILLISECONDS = [500, 1e3, 2e3, 5e3];
+var DEFAULT_SAFETY_DRAIN_INTERVAL_MILLISECONDS = 3e5;
+var SSE_HEALTHY_CONNECTION_MILLISECONDS = 5e3;
 var ERROR_BACKOFF_CAP = 4;
 function createDrainLatch() {
   let pending = false;
@@ -13241,7 +13285,7 @@ async function drainRunner({
       consecutiveErrors = Math.min(consecutiveErrors + 1, ERROR_BACKOFF_CAP);
       errorAttempts += 1;
       const delay = calculateErrorBackoffMs(
-        BASE_ERROR_BACKOFF_MS,
+        BASE_ERROR_BACKOFF_MILLISECONDS,
         consecutiveErrors
       );
       const statusCode = errorStatusCode(error);
@@ -13307,7 +13351,7 @@ async function sseLoop({
       })) {
         drainRequest.request();
       }
-      if (connected && Date.now() - connectedAt >= SSE_HEALTHY_CONNECTION_MS) {
+      if (connected && Date.now() - connectedAt >= SSE_HEALTHY_CONNECTION_MILLISECONDS) {
         attempt = 0;
       }
     } catch (err) {
@@ -13331,8 +13375,11 @@ async function sseLoop({
       transientError = err;
     }
     if (signal.aborted) return;
-    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);
+    const delay = SSE_RECONNECT_BACKOFF_MILLISECONDS[Math.min(attempt, SSE_RECONNECT_BACKOFF_MILLISECONDS.length - 1)];
+    attempt = Math.min(
+      attempt + 1,
+      SSE_RECONNECT_BACKOFF_MILLISECONDS.length - 1
+    );
     if (transientError !== void 0 && debug) {
       const statusCode = errorStatusCode(transientError);
       const errorMsg = errorMessage(transientError);
@@ -13389,7 +13436,7 @@ var watchTriggerInboxPlugin = defineMethod({
     const { concurrency, leaseLimit } = resolveConcurrencyAndLease(input);
     const inboxId = await resolveTriggerInboxId({ api, inbox: input.inbox });
     if (input.signal?.aborted) return;
-    const safetyDrainMs = input.maxDrainIntervalSeconds !== void 0 ? input.maxDrainIntervalSeconds * 1e3 : DEFAULT_SAFETY_DRAIN_INTERVAL_MS;
+    const safetyDrainMs = input.maxDrainIntervalSeconds !== void 0 ? input.maxDrainIntervalSeconds * 1e3 : DEFAULT_SAFETY_DRAIN_INTERVAL_MILLISECONDS;
     const stop = new AbortController();
     const combined = combineAbortSignals({
       handles: [
@@ -14418,7 +14465,7 @@ var updateTableRecordsPlugin = defineMethod({
 
 // src/plugins/eventEmission/transport.ts
 var DEFAULT_RETRY_ATTEMPTS = 2;
-var DEFAULT_RETRY_DELAY_MS = 300;
+var DEFAULT_RETRY_DELAY_MILLISECONDS = 300;
 function createHttpTransport(config) {
   const delay = async (ms) => {
     return new Promise((resolve2) => {
@@ -14443,12 +14490,12 @@ function createHttpTransport(config) {
         body: JSON.stringify(payload)
       });
       if (!response.ok && attemptsLeft > 1) {
-        await delay(config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
+        await delay(config.retryDelayMs || DEFAULT_RETRY_DELAY_MILLISECONDS);
         return emitWithRetry(subject, event, attemptsLeft - 1);
       }
     } catch (error) {
       if (attemptsLeft > 1) {
-        await delay(config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
+        await delay(config.retryDelayMs || DEFAULT_RETRY_DELAY_MILLISECONDS);
         return emitWithRetry(subject, event, attemptsLeft - 1);
       }
       throw error;
@@ -14741,7 +14788,7 @@ function makeMethodEndHook(emitMethodCalled) {
 }
 
 // src/plugins/eventEmission/index.ts
-var TELEMETRY_EMIT_TIMEOUT_MS = 300;
+var TELEMETRY_EMIT_TIMEOUT_MILLISECONDS = 300;
 var registeredListeners = {};
 function removeExistingListeners() {
   const events = [
@@ -14787,7 +14834,7 @@ async function emitWithTimeout(transport, subject, event) {
     await Promise.race([
       transport.emit(subject, event),
       new Promise((resolve2) => {
-        const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
+        const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MILLISECONDS);
         if (typeof timer.unref === "function") {
           timer.unref();
         }
@@ -15226,14 +15273,14 @@ function createZapierSdk(options = {}) {
 
 // src/utils/batch-utils.ts
 var DEFAULT_CONCURRENCY = 10;
-var BATCH_START_DELAY_MS = 25;
-var DEFAULT_BATCH_TIMEOUT_MS = 18e4;
+var BATCH_START_DELAY_MILLISECONDS = 25;
+var DEFAULT_BATCH_TIMEOUT_MILLISECONDS = 18e4;
 async function batch(tasks, options = {}) {
   const {
     concurrency = DEFAULT_CONCURRENCY,
     retry = true,
-    batchDelay = BATCH_START_DELAY_MS,
-    timeoutMs = DEFAULT_BATCH_TIMEOUT_MS,
+    batchDelay = BATCH_START_DELAY_MILLISECONDS,
+    timeoutMs = DEFAULT_BATCH_TIMEOUT_MILLISECONDS,
     taskTimeoutMs
   } = options;
   if (concurrency <= 0) {
@@ -15326,11 +15373,15 @@ var BaseSdkOptionsSchema = zod.z.object({
    */
   maxNetworkRetries: zod.z.number().optional().describe("Max retries for rate-limited requests (default: 3).").meta({ valueHint: "count" }),
   /**
-   * Maximum delay in milliseconds to wait for a rate limit retry.
+   * Maximum delay in seconds to wait for a rate-limit retry.
    * If the server requests a longer delay, the request fails immediately.
-   * Default is 60000 (60 seconds).
+   * Default is 60 (60 seconds).
    */
-  maxNetworkRetryDelayMs: zod.z.number().optional().describe("Max delay in ms to wait for retry (default: 60000).").meta({ valueHint: "ms" }),
+  maxNetworkRetryDelaySeconds: zod.z.number().optional().describe(
+    "Max delay in seconds to wait for a rate-limit retry (default: 60)."
+  ).meta({ valueHint: "seconds" }),
+  /** @deprecated Use `maxNetworkRetryDelaySeconds` instead. */
+  maxNetworkRetryDelayMs: zod.z.number().optional().describe("Max delay in ms to wait for retry (default: 60000).").meta({ valueHint: "ms", deprecated: true }),
   /**
    * Maximum number of concurrent in-flight HTTP requests per client.
    * Requests beyond this limit queue in FIFO order until a slot frees.
@@ -15349,7 +15400,9 @@ var BaseSdkOptionsSchema = zod.z.object({
   ]).optional().describe(
     `Max concurrent in-flight HTTP requests (default: 200, max: ${MAX_CONCURRENCY_LIMIT}).`
   ).meta({ valueHint: "count" }),
-  approvalTimeoutMs: zod.z.number().optional().describe("Timeout in ms for approval polling. Default: 600000 (10 min).").meta({ valueHint: "ms" }),
+  approvalTimeoutSeconds: zod.z.number().optional().describe("Timeout in seconds for approval polling. Default: 600 (10 min).").meta({ valueHint: "seconds" }),
+  /** @deprecated Use `approvalTimeoutSeconds` instead. */
+  approvalTimeoutMs: zod.z.number().optional().describe("Timeout in ms for approval polling. Default: 600000 (10 min).").meta({ valueHint: "ms", deprecated: true }),
   maxApprovalRetries: zod.z.number().optional().describe(
     "Maximum number of sequential approval rounds per request (one per gating policy) before giving up. Default: 2."
   ),
@@ -15386,7 +15439,8 @@ var registryPlugin = (_sdk) => {
 exports.API_ID = API_ID;
 exports.ActionKeyPropertySchema = ActionKeyPropertySchema;
 exports.ActionPropertySchema = ActionPropertySchema;
-exports.ActionTimeoutMsPropertySchema = ActionTimeoutMsPropertySchema;
+exports.ActionTimeoutMillisecondsPropertySchema = ActionTimeoutMillisecondsPropertySchema;
+exports.ActionTimeoutSecondsPropertySchema = ActionTimeoutSecondsPropertySchema;
 exports.ActionTypePropertySchema = ActionTypePropertySchema;
 exports.AppKeyPropertySchema = AppKeyPropertySchema;
 exports.AppPropertySchema = AppPropertySchema;
@@ -15397,7 +15451,7 @@ exports.BaseSdkOptionsSchema = BaseSdkOptionsSchema;
 exports.CONNECTIONS_ID = CONNECTIONS_ID;
 exports.CONTEXT = CONTEXT;
 exports.CONTEXT_CACHE_MAX_SIZE = CONTEXT_CACHE_MAX_SIZE;
-exports.CONTEXT_CACHE_TTL_MS = CONTEXT_CACHE_TTL_MS;
+exports.CONTEXT_CACHE_TTL_MILLISECONDS = CONTEXT_CACHE_TTL_MILLISECONDS;
 exports.CORE_ERROR_SYMBOL = CORE_ERROR_SYMBOL;
 exports.CORE_OPTIONS_ID = CORE_OPTIONS_ID;
 exports.CORE_SIGNAL_SYMBOL = CORE_SIGNAL_SYMBOL;
@@ -15414,8 +15468,8 @@ exports.CoreSignal = CoreSignal;
 exports.CredentialsFunctionSchema = CredentialsFunctionSchema;
 exports.CredentialsObjectSchema = CredentialsObjectSchema;
 exports.CredentialsSchema = CredentialsSchema;
-exports.DEFAULT_ACTION_TIMEOUT_MS = DEFAULT_ACTION_TIMEOUT_MS;
-exports.DEFAULT_APPROVAL_TIMEOUT_MS = DEFAULT_APPROVAL_TIMEOUT_MS;
+exports.DEFAULT_ACTION_TIMEOUT_MILLISECONDS = DEFAULT_ACTION_TIMEOUT_MILLISECONDS;
+exports.DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS = DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS;
 exports.DEFAULT_CONFIG_PATH = DEFAULT_CONFIG_PATH;
 exports.DEFAULT_MAX_APPROVAL_RETRIES = DEFAULT_MAX_APPROVAL_RETRIES;
 exports.DEFAULT_PAGE_SIZE = DEFAULT_PAGE_SIZE;
@@ -15453,7 +15507,7 @@ exports.WatchTriggerInboxSchema = WatchTriggerInboxSchema;
 exports.ZAPIER_BASE_URL = ZAPIER_BASE_URL;
 exports.ZAPIER_MAX_CONCURRENT_REQUESTS = ZAPIER_MAX_CONCURRENT_REQUESTS;
 exports.ZAPIER_MAX_NETWORK_RETRIES = ZAPIER_MAX_NETWORK_RETRIES;
-exports.ZAPIER_MAX_NETWORK_RETRY_DELAY_MS = ZAPIER_MAX_NETWORK_RETRY_DELAY_MS;
+exports.ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS = ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS;
 exports.ZapierAbortDrainSignal = ZapierAbortDrainSignal;
 exports.ZapierActionError = ZapierActionError;
 exports.ZapierApiError = ZapierApiError;