@zapier/zapier-sdk 0.49.0 → 0.51.0

package/dist/experimental.mjs

@@ -148,12 +148,10 @@ function parseIntEnvVar(name) {
 }
 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;
-function getZapierIsInteractive() {
-  return globalThis.process?.env?.ZAPIER_IS_INTERACTIVE === "true";
-}
 function getZapierApprovalMode() {
   const value = globalThis.process?.env?.ZAPIER_APPROVAL_MODE;
-  if (value === "poll" || value === "fail") return value;
+  if (value === "disabled" || value === "poll" || value === "throw")
+    return value;
   return void 0;
 }
 var DEFAULT_APPROVAL_TIMEOUT_MS = 10 * 60 * 1e3;
@@ -1836,33 +1834,40 @@ function getAuthorizationHeader(token) {
   }
   return `Bearer ${token}`;
 }
-function extractUserIdsFromJwt(token) {
+function readJwtPayload(token) {
   const parts = parseJwt(token);
-  if (!parts) {
-    return { customuser_id: null, account_id: null };
-  }
+  if (!parts) return null;
+  let payload;
   try {
-    const payload = JSON.parse(
-      Buffer.from(parts[1], "base64url").toString("utf-8")
-    );
-    let actualPayload = payload;
-    if (payload.sub_type === "service" && payload.njwt) {
-      const nestedParts = payload.njwt.split(".");
-      if (nestedParts.length === 3) {
-        actualPayload = JSON.parse(
+    payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf-8"));
+  } catch {
+    return null;
+  }
+  if (payload["sub_type"] === "service" && typeof payload["njwt"] === "string") {
+    const nestedParts = parseJwt(payload["njwt"]);
+    if (nestedParts) {
+      try {
+        return JSON.parse(
           Buffer.from(nestedParts[1], "base64url").toString("utf-8")
         );
+      } catch {
       }
     }
-    const accountId = actualPayload["zap:acc"] != null ? parseInt(String(actualPayload["zap:acc"]), 10) : null;
-    const customUserId = actualPayload.sub_type === "customuser" && actualPayload.sub != null ? parseInt(String(actualPayload.sub), 10) : null;
-    return {
-      customuser_id: customUserId !== null && !isNaN(customUserId) ? customUserId : null,
-      account_id: accountId !== null && !isNaN(accountId) ? accountId : null
-    };
-  } catch {
+  }
+  return payload;
+}
+function extractUserIdsFromJwt(token) {
+  const payload = readJwtPayload(token);
+  if (!payload) {
     return { customuser_id: null, account_id: null };
   }
+  const accRaw = payload["zap:acc"];
+  const accountId = accRaw != null ? parseInt(String(accRaw), 10) : null;
+  const customUserId = payload["sub_type"] === "customuser" && payload["sub"] != null ? parseInt(String(payload["sub"]), 10) : null;
+  return {
+    customuser_id: customUserId !== null && !isNaN(customUserId) ? customUserId : null,
+    account_id: accountId !== null && !isNaN(accountId) ? accountId : null
+  };
 }
 
 // src/api/debug.ts
@@ -2211,6 +2216,19 @@ function isCredentialsFunction(credentials) {
   return typeof credentials === "function";
 }
 
+// src/utils/telemetry.ts
+var emittedOnce = /* @__PURE__ */ new WeakMap();
+function emitOnce(onEvent, event) {
+  if (!emittedOnce.has(onEvent)) {
+    emittedOnce.set(onEvent, /* @__PURE__ */ new Set());
+  }
+  const fired = emittedOnce.get(onEvent);
+  if (!fired.has(event.type)) {
+    fired.add(event.type);
+    onEvent(event);
+  }
+}
+
 // src/utils/url-utils.ts
 function getZapierBaseUrl(baseUrl) {
   if (!baseUrl) {
@@ -2433,8 +2451,10 @@ async function resolveCache(options) {
   if (cliLogin?.createCache) {
     try {
       const cache = cliLogin.createCache();
-      cachedDefaultCache = cache;
-      return cache;
+      if (cache) {
+        cachedDefaultCache = cache;
+        return cache;
+      }
     } catch {
     }
   }
@@ -2446,6 +2466,11 @@ function entryIsValid(entry) {
   if (entry.expiresAt === void 0) return true;
   return entry.expiresAt > Date.now() + TOKEN_EXPIRATION_BUFFER_MS;
 }
+async function readCachedToken(cacheKey, cache) {
+  const cached = await cache.get(cacheKey);
+  if (cached && entryIsValid(cached)) return cached.value;
+  return void 0;
+}
 async function invalidateCachedToken(options) {
   const cacheKey = buildCacheKey(options);
   pendingExchanges.delete(cacheKey);
@@ -2559,11 +2584,76 @@ function isCliLoginAvailable() {
   if (cachedCliLogin === void 0) return void 0;
   return cachedCliLogin !== false;
 }
+function emitAuthResolved(onEvent, mechanism) {
+  if (onEvent) {
+    emitOnce(onEvent, {
+      type: "auth_resolved",
+      payload: { mechanism },
+      timestamp: Date.now()
+    });
+  }
+}
+async function getActiveCredentialsFromCli(baseUrl) {
+  const cliLogin = await getCliLogin();
+  return cliLogin?.getActiveCredentials?.({ baseUrl });
+}
+async function getStoredClientCredentialsFromCli(baseUrl) {
+  const cliLogin = await getCliLogin();
+  return cliLogin?.getStoredClientCredentials?.({ baseUrl });
+}
 async function getTokenFromCliLogin(options) {
   const cliLogin = await getCliLogin();
   if (!cliLogin) return void 0;
   return await cliLogin.getToken(options);
 }
+async function tryStoredClientCredentialToken(options) {
+  const activeCredential = await getActiveCredentialsFromCli(options.baseUrl);
+  if (!activeCredential) return void 0;
+  const resolvedBaseUrl = activeCredential.baseUrl || options.baseUrl || DEFAULT_AUTH_BASE_URL;
+  const mergedScopes = mergeScopes(
+    activeCredential.scopes.join(" "),
+    options.requiredScopes
+  );
+  const cacheKey = buildCacheKey({
+    clientId: activeCredential.clientId,
+    scopes: mergedScopes,
+    baseUrl: resolvedBaseUrl
+  });
+  const cache = await resolveCache(options);
+  const pending = pendingExchanges.get(cacheKey);
+  if (pending) return pending;
+  const cached = await readCachedToken(cacheKey, cache);
+  if (cached !== void 0) {
+    if (options.debug)
+      console.log(
+        `[auth] Using cached token (clientId: ${activeCredential.clientId})`
+      );
+    emitAuthResolved(options.onEvent, "client_credentials");
+    return cached;
+  }
+  const storedCredential = await getStoredClientCredentialsFromCli(resolvedBaseUrl);
+  if (!storedCredential) {
+    await invalidateCachedToken({
+      clientId: activeCredential.clientId,
+      scopes: activeCredential.scopes,
+      baseUrl: resolvedBaseUrl,
+      cache: options.cache
+    });
+    throw new ZapierAuthenticationError(
+      `Stored client credential is missing its secret (clientId: ${activeCredential.clientId}). Run \`zapier-sdk login\` to recreate it.`
+    );
+  }
+  if (options.debug)
+    console.log(
+      `[auth] Using stored client credential (clientId: ${storedCredential.clientId})`
+    );
+  const token = await resolveAuthTokenFromCredentials(
+    storedCredential,
+    options
+  );
+  emitAuthResolved(options.onEvent, "client_credentials");
+  return token;
+}
 async function resolveAuthToken(options = {}) {
   const credentials = await resolveCredentials({
     credentials: options.credentials,
@@ -2573,14 +2663,24 @@ async function resolveAuthToken(options = {}) {
   if (credentials !== void 0) {
     return resolveAuthTokenFromCredentials(credentials, options);
   }
-  return getTokenFromCliLogin({
+  const storedToken = await tryStoredClientCredentialToken(options);
+  if (storedToken !== void 0) return storedToken;
+  if (options.debug) {
+    console.log("[auth] Using JWT (no stored client credential found)");
+  }
+  const jwtToken = await getTokenFromCliLogin({
     onEvent: options.onEvent,
     fetch: options.fetch,
     debug: options.debug
   });
+  if (jwtToken !== void 0) {
+    emitAuthResolved(options.onEvent, "jwt");
+  }
+  return jwtToken;
 }
 async function resolveAuthTokenFromCredentials(credentials, options) {
   if (typeof credentials === "string") {
+    emitAuthResolved(options.onEvent, "token");
     return credentials;
   }
   if (isClientCredentials(credentials)) {
@@ -2593,15 +2693,25 @@ async function resolveAuthTokenFromCredentials(credentials, options) {
       baseUrl: resolvedBaseUrl
     });
     const cache = await resolveCache(options);
-    const cached = await cache.get(cacheKey);
-    if (cached && entryIsValid(cached)) {
-      return cached.value;
+    const cached = await readCachedToken(cacheKey, cache);
+    if (cached !== void 0) {
+      if (options.debug) {
+        console.log(`[auth] Using cached token (clientId: ${clientId})`);
+      }
+      return cached;
     }
     const pending = pendingExchanges.get(cacheKey);
     if (pending) return pending;
     const runLocked = async () => {
-      const recheck = await cache.get(cacheKey);
-      if (recheck && entryIsValid(recheck)) return recheck.value;
+      const recheck = await readCachedToken(cacheKey, cache);
+      if (recheck !== void 0) {
+        if (options.debug) {
+          console.log(
+            `[auth] Using cached token (clientId: ${clientId}, locked recheck)`
+          );
+        }
+        return recheck;
+      }
       const { accessToken, expiresIn } = await exchangeClientCredentials({
         clientId: credentials.clientId,
         clientSecret: credentials.clientSecret,
@@ -2659,7 +2769,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.49.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.51.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -2934,10 +3044,10 @@ var ZapierApiClient = class {
         }
         if (errorType !== "approval_required") return response;
         if (attempt === maxRetries) break;
-        const isInteractive = this.options.isInteractive ?? getZapierIsInteractive();
-        if (!isInteractive) {
+        const mode = this.options.approvalMode ?? getZapierApprovalMode() ?? "disabled";
+        if (mode === "disabled") {
           throw new ZapierApprovalError(
-            "Approval required but session is not interactive",
+            "Approvals are disabled. Set approvalMode to 'poll' or 'throw' (or ZAPIER_APPROVAL_MODE) to enable.",
             { status: "approval_required" }
           );
         }
@@ -2947,7 +3057,7 @@ var ZapierApiClient = class {
             { statusCode: 403 }
           );
         }
-        await this.runOneApprovalRound(init.approvalContext);
+        await this.runOneApprovalRound(init.approvalContext, mode);
       }
       throw new ZapierApprovalError(
         `Exceeded maximum approval retries (${maxRetries}) for ${path}`,
@@ -3240,7 +3350,9 @@ var ZapierApiClient = class {
     if (data && typeof data === "object") {
       headers["Content-Type"] = "application/json";
     }
-    const wasMissingAuthToken = options.authRequired && await this.getAuthToken({ requiredScopes: options.requiredScopes }) == null;
+    const wasMissingAuthToken = options.authRequired && await this.getAuthToken({
+      requiredScopes: options.requiredScopes
+    }) == null;
     const response = await this.fetch(path, {
       ...options,
       method,
@@ -3266,10 +3378,13 @@ var ZapierApiClient = class {
   }
   /**
    * Run a single approval round: create the approval, open the URL (poll mode)
-   * or throw (fail mode), poll until resolved, and emit events. Throws on
+   * or throw (throw mode), poll until resolved, and emit events. Throws on
    * denied/timeout/unexpected status. Returns on approved.
+   *
+   * Caller is responsible for passing a non-"disabled" mode; this method
+   * unconditionally creates an approval.
    */
-  async runOneApprovalRound(buildContext) {
+  async runOneApprovalRound(buildContext, mode) {
     const context = buildContext();
     let approvalResponse;
     try {
@@ -3344,8 +3459,7 @@ var ZapierApiClient = class {
       approvalId: approval.approval_id,
       approvalUrl: approval.approval_url
     });
-    const approvalMode = this.options.approvalMode ?? getZapierApprovalMode();
-    if (approvalMode === "fail") {
+    if (mode === "throw") {
       throw new ZapierApprovalError("This request requires approval.", {
         approvalId: approval.approval_id,
         approvalUrl: approval.approval_url,
@@ -3432,6 +3546,28 @@ var createZapierApi = (options) => {
   });
 };
 
+// src/api/index.ts
+function getOrCreateApiClient(config) {
+  const {
+    baseUrl = ZAPIER_BASE_URL,
+    credentials,
+    token,
+    api: providedApi,
+    debug = false,
+    fetch: customFetch
+  } = config;
+  if (providedApi) {
+    return providedApi;
+  }
+  return createZapierApi({
+    baseUrl,
+    credentials,
+    token,
+    debug,
+    fetch: customFetch
+  });
+}
+
 // src/plugins/api/index.ts
 var apiPlugin = definePlugin(
   (sdk) => {
@@ -3444,7 +3580,6 @@ var apiPlugin = definePlugin(
       debug = false,
       maxNetworkRetries = ZAPIER_MAX_NETWORK_RETRIES,
       maxNetworkRetryDelayMs = ZAPIER_MAX_NETWORK_RETRY_DELAY_MS,
-      isInteractive,
       approvalTimeoutMs,
       maxApprovalRetries,
       approvalMode,
@@ -3459,7 +3594,6 @@ var apiPlugin = definePlugin(
       onEvent,
       maxNetworkRetries,
       maxNetworkRetryDelayMs,
-      isInteractive,
       approvalTimeoutMs,
       maxApprovalRetries,
       approvalMode,
@@ -10165,16 +10299,13 @@ var BaseSdkOptionsSchema = z.object({
    * Default is 60000 (60 seconds).
    */
   maxNetworkRetryDelayMs: z.number().optional().describe("Max delay in ms to wait for retry (default: 60000).").meta({ valueHint: "ms" }),
-  isInteractive: z.boolean().optional().describe(
-    "Whether this session is interactive (user can visit approval URLs). Defaults to ZAPIER_IS_INTERACTIVE env var."
-  ).meta({ internal: true }),
-  approvalTimeoutMs: z.number().optional().describe("Timeout in ms for approval polling. Default: 600000 (10 min).").meta({ valueHint: "ms", internal: true }),
+  approvalTimeoutMs: z.number().optional().describe("Timeout in ms for approval polling. Default: 600000 (10 min).").meta({ valueHint: "ms" }),
   maxApprovalRetries: z.number().optional().describe(
     "Maximum number of sequential approval rounds per request (one per gating policy) before giving up. Default: 2."
-  ).meta({ internal: true }),
-  approvalMode: z.enum(["poll", "fail"]).optional().describe(
-    'Approval flow behavior. "poll" opens browser and polls (default). "fail" creates the approval and throws immediately with the approval URL.'
-  ).meta({ internal: true }),
+  ),
+  approvalMode: z.enum(["disabled", "poll", "throw"]).optional().describe(
+    'Approval flow behavior. "disabled" (default) throws a ZapierApprovalError on approval-required responses without creating an approval. "poll" creates the approval, opens it in a browser, polls until resolved, and retries the original request. "throw" creates the approval and throws a ZapierApprovalError with the approval URL so the caller can surface it. Defaults to the ZAPIER_APPROVAL_MODE env var, then "disabled".'
+  ),
   // Internal
   manifestPath: z.string().optional().describe("Path to a .zapierrc manifest file for app version locking.").meta({ internal: true }),
   manifest: z.custom().optional().describe("Manifest for app version locking.").meta({ internal: true }),
@@ -10204,4 +10335,4 @@ function createZapierSdk2(options = {}) {
   return createSdk().addPlugin(createOptionsPlugin(options)).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(capabilitiesPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listActionInputFieldsPlugin).addPlugin(getActionInputFieldsSchemaPlugin).addPlugin(listActionInputFieldChoicesPlugin).addPlugin(listInputFieldsDeprecatedPlugin).addPlugin(getInputFieldsSchemaDeprecatedPlugin).addPlugin(listInputFieldChoicesDeprecatedPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(createTriggerInboxPlugin).addPlugin(ensureTriggerInboxPlugin).addPlugin(listTriggerInboxesPlugin).addPlugin(getTriggerInboxPlugin).addPlugin(updateTriggerInboxPlugin).addPlugin(deleteTriggerInboxPlugin).addPlugin(pauseTriggerInboxPlugin).addPlugin(resumeTriggerInboxPlugin).addPlugin(listTriggerInboxMessagesPlugin).addPlugin(leaseTriggerInboxMessagesPlugin).addPlugin(ackTriggerInboxMessagesPlugin).addPlugin(releaseTriggerInboxMessagesPlugin).addPlugin(drainTriggerInboxPlugin).addPlugin(watchTriggerInboxPlugin).addPlugin(listTriggerInputFieldsPlugin).addPlugin(listTriggerInputFieldChoicesPlugin).addPlugin(getTriggerInputFieldsSchemaPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 
-export { ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_APPROVAL_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DebugPropertySchema, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, TablePropertySchema, TablesPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, composePlugins, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, createBaseEvent, createClientCredentialsPlugin, createFunction, createMemoryCache, createOptionsPlugin, createPaginatedPluginMethod, createPluginMethod, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierSdk2 as createZapierSdk, createZapierSdkWithoutRegistry, definePlugin, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getZapierApprovalMode, getZapierIsInteractive, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, triggerInboxResolver, updateTableRecordsPlugin };
+export { ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_APPROVAL_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DebugPropertySchema, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, TablePropertySchema, TablesPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, composePlugins, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, createBaseEvent, createClientCredentialsPlugin, createFunction, createMemoryCache, createOptionsPlugin, createPaginatedPluginMethod, createPluginMethod, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierApi, createZapierSdk2 as createZapierSdk, createZapierSdkWithoutRegistry, definePlugin, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOrCreateApiClient, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getZapierApprovalMode, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, triggerInboxResolver, updateTableRecordsPlugin };

package/dist/{index-C2vsvjgN.d.mts → index-C52BjTXh.d.mts}

@@ -677,6 +677,69 @@ declare const NeedsResponseSchema: z.ZodObject<{
  * to ensure a single source of truth and eliminate duplication.
  */
 
+interface ApiClientOptions {
+    baseUrl: string;
+    /**
+     * Authentication credentials.
+     */
+    credentials?: Credentials;
+    /**
+     * @deprecated Use `credentials` instead.
+     */
+    token?: string;
+    debug?: boolean;
+    fetch?: typeof globalThis.fetch;
+    onEvent?: (event: SdkEvent) => void;
+    /**
+     * Maximum number of retries for rate-limited requests (429 responses).
+     * Set to 0 to disable retries. Default is 3.
+     */
+    maxNetworkRetries?: number;
+    /**
+     * Maximum delay in milliseconds to wait for a rate limit retry.
+     * If the server requests a longer delay, the request fails immediately.
+     * Default is 60000 (60 seconds).
+     */
+    maxNetworkRetryDelayMs?: number;
+    /**
+     * Controls how the approval flow is handled.
+     * - "disabled": (default when env var is unset) Throw a ZapierApprovalError
+     *   on approval-required responses without creating an approval.
+     * - "poll": Create the approval, open the URL in a browser, poll until
+     *   resolved, and retry the original request on success.
+     * - "throw": Create the approval and throw a ZapierApprovalError immediately
+     *   with the approval URL so the caller can surface it.
+     * Defaults to the ZAPIER_APPROVAL_MODE env var, then "disabled".
+     */
+    approvalMode?: "disabled" | "poll" | "throw";
+    /**
+     * Timeout in ms for approval polling. Default: 600000 (10 minutes).
+     */
+    approvalTimeoutMs?: number;
+    /**
+     * Maximum number of sequential approval rounds for a single request before
+     * giving up. A single request can legitimately require multiple approvals
+     * (one per gating policy); this cap prevents a runaway loop if the server
+     * keeps returning approval_required. Default: 2.
+     */
+    maxApprovalRetries?: number;
+    /**
+     * Identifies the wrapping package that built this client (e.g., the CLI or
+     * MCP server). When set, emitted as `x-zapier-sdk-package` /
+     * `x-zapier-sdk-package-version` telemetry headers. Omitted by direct
+     * `createZapierSdk` callers — their identity is captured by
+     * `x-zapier-sdk-version` alone.
+     */
+    callerPackage?: {
+        name: string;
+        version: string;
+    };
+    /**
+     * Pluggable key-value cache used to cache access tokens across
+     * invocations. See ZapierCache in ../cache.ts.
+     */
+    cache?: ZapierCache;
+}
 interface ApiClient {
     get: <T = unknown>(path: string, options?: RequestOptions) => Promise<T>;
     post: <T = unknown>(path: string, data?: unknown, options?: RequestOptions) => Promise<T>;
@@ -848,6 +911,39 @@ interface CapabilitiesContext {
     hasCapability: (key: GatedFlag) => Promise<boolean>;
 }
 
+/**
+ * API Client Implementation
+ *
+ * This module contains the core API client implementation, including
+ * HTTP method handlers, response processing, and client factory functions.
+ */
+
+declare const createZapierApi: (options: ApiClientOptions) => ApiClient;
+
+/**
+ * Zapier API Client Module
+ *
+ * This module provides a centralized API layer for all HTTP interactions
+ * with Zapier's various APIs. It handles authentication, error handling,
+ * polling, and provides consistent patterns across all services.
+ */
+
+/**
+ * Utility function to get or create an API client for standalone functions
+ *
+ * @param config - Configuration that may include an existing API client
+ * @returns ApiClient instance
+ */
+declare function getOrCreateApiClient(config: {
+    baseUrl?: string;
+    credentials?: Credentials;
+    /** @deprecated Use `credentials` instead */
+    token?: string;
+    api?: ApiClient;
+    debug?: boolean;
+    fetch?: typeof globalThis.fetch;
+}): ApiClient;
+
 /**
  * Event emission types matching Avro schemas for SDK telemetry
  *
@@ -1399,12 +1495,12 @@ declare const BaseSdkOptionsSchema: z.ZodObject<{
     trackingBaseUrl: z.ZodOptional<z.ZodString>;
     maxNetworkRetries: z.ZodOptional<z.ZodNumber>;
     maxNetworkRetryDelayMs: z.ZodOptional<z.ZodNumber>;
-    isInteractive: z.ZodOptional<z.ZodBoolean>;
     approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
     maxApprovalRetries: z.ZodOptional<z.ZodNumber>;
     approvalMode: z.ZodOptional<z.ZodEnum<{
+        disabled: "disabled";
         poll: "poll";
-        fail: "fail";
+        throw: "throw";
     }>>;
     manifestPath: z.ZodOptional<z.ZodString>;
     manifest: z.ZodOptional<z.ZodCustom<Manifest, Manifest>>;
@@ -5621,15 +5717,15 @@ declare class ZapierRateLimitError extends ZapierError {
  * Terminal status of an approval attempt, exposed on `ZapierApprovalError.approvalStatus`.
  *
  * - `pending`: The approval was created but not yet resolved. Only thrown in
- *   `approvalMode: "fail"` — the caller is expected to surface the approval URL
+ *   `approvalMode: "throw"` — the caller is expected to surface the approval URL
  *   to an end user (e.g. an LLM instructing its user to click the link).
  * - `denied`: A human explicitly rejected the approval in the UI.
  * - `policy_denied`: A policy rule blocked the request before (or instead of)
  *   creating an approval. Cannot be approved by a human.
- * - `approval_required`: The backend requested approval, but the current
- *   session is non-interactive so the SDK cannot open the approval URL. Retry
- *   in an interactive session, or use `approvalMode: "fail"` to surface the
- *   approval URL to the caller.
+ * - `approval_required`: The backend requested approval, but `approvalMode` is
+ *   `"disabled"` (the default) so the SDK did not create an approval. Set
+ *   `approvalMode` to `"poll"` or `"throw"` (or the `ZAPIER_APPROVAL_MODE` env
+ *   var) to enable the approval flow.
  * - `timeout`: Poll mode exceeded `approvalTimeoutMs` without the approval
  *   being resolved.
  * - `max_retries_exceeded`: A single request triggered more sequential approval
@@ -8493,7 +8589,18 @@ interface CliLoginOptions {
     };
     debug?: boolean;
 }
-type CliLoginModule = typeof _zapier_zapier_sdk_cli_login;
+type CliLoginModule = typeof _zapier_zapier_sdk_cli_login & {
+    getActiveCredentials?: (options?: {
+        baseUrl?: string;
+    }) => {
+        clientId: string;
+        scopes: string[];
+        baseUrl?: string;
+    } | undefined;
+    getStoredClientCredentials?: (options?: {
+        baseUrl?: string;
+    }) => Promise<ClientCredentialsObject | undefined>;
+};
 /**
  * Inject an already-loaded CLI login module so the SDK skips its dynamic import.
  * This guarantees CLI and SDK share the same module instance in the same process.
@@ -8642,20 +8749,19 @@ declare const DEFAULT_ACTION_TIMEOUT_MS = 180000;
  */
 declare const ZAPIER_MAX_NETWORK_RETRIES: number;
 declare const ZAPIER_MAX_NETWORK_RETRY_DELAY_MS: number;
-/**
- * Whether this session is interactive (user can visit approval URLs).
- *
- * Read lazily so tests can set the env var after module import.
- */
-declare function getZapierIsInteractive(): boolean;
 /**
  * Approval flow behavior from environment variable.
- * - "poll": (default) Opens the approval URL in a browser and polls until resolved.
- * - "fail": Creates the approval and throws immediately with the approval URL.
+ * - "disabled": (default when env var is unset) Throw a ZapierApprovalError on
+ *   approval-required responses without creating an approval. Callers must
+ *   explicitly opt in to approvals via "poll" or "throw".
+ * - "poll": Create the approval, open the URL in a browser, poll until
+ *   resolved, and retry the original request on success.
+ * - "throw": Create the approval and throw a ZapierApprovalError immediately
+ *   with the approval URL so the caller can surface it.
  *
  * Read lazily so tests can set the env var after module import.
  */
-declare function getZapierApprovalMode(): "poll" | "fail" | undefined;
+declare function getZapierApprovalMode(): "disabled" | "poll" | "throw" | undefined;
 /**
  * Default timeout for approval polling (10 minutes)
  */
@@ -9536,4 +9642,4 @@ declare const registryPlugin: (sdk: {
     };
 }) => {};
 
-export { type Resolver as $, type ApiClient as A, type BaseSdkOptions as B, type CapabilitiesContext as C, type DrainTriggerInboxOptions as D, type EventEmissionContext as E, type FieldsetItem as F, type GetAuthenticationPluginProvides as G, type ActionFieldChoice as H, type NeedsRequest as I, type NeedsResponse as J, type Connection as K, type LeasedTriggerMessageItem as L, type Manifest as M, type Need as N, type ConnectionsResponse as O, type PluginMeta as P, type UserProfile as Q, type ResolvedAppLocator as R, isPositional as S, type TriggerMessageStatus as T, type UpdateManifestEntryOptions as U, createFunction as V, type WithAddPlugin as W, type FormattedItem as X, type FormatMetadata as Y, type ZapierSdkOptions as Z, type OutputFormatter as _, type UpdateManifestEntryResult as a, AppPropertySchema as a$, type ArrayResolver as a0, type ResolverMetadata as a1, type StaticResolver as a2, type FieldsResolver as a3, runWithTelemetryContext as a4, toSnakeCase as a5, toTitleCase as a6, batch as a7, type BatchOptions as a8, buildCapabilityMessage as a9, type EnhancedErrorEventData as aA, type MethodCalledEventData as aB, generateEventId as aC, getCurrentTimestamp as aD, getReleaseId as aE, getOsInfo as aF, getPlatformVersions as aG, isCi as aH, getCiPlatform as aI, getMemoryUsage as aJ, getCpuTime as aK, buildApplicationLifecycleEvent as aL, buildErrorEventWithContext as aM, buildErrorEvent as aN, createBaseEvent as aO, buildMethodCalledEvent as aP, type AppItem as aQ, type ConnectionItem as aR, type ActionItem$1 as aS, type InputFieldItem as aT, type InfoFieldItem as aU, type RootFieldItem as aV, type UserProfileItem as aW, type FunctionOptions as aX, type SdkPage as aY, type PaginatedSdkFunction as aZ, AppKeyPropertySchema as a_, logDeprecation as aa, resetDeprecationWarnings as ab, RelayRequestSchema as ac, RelayFetchSchema as ad, createZapierSdkWithoutRegistry as ae, createSdk as af, createOptionsPlugin as ag, type FunctionRegistryEntry as ah, type FunctionDeprecation as ai, BaseSdkOptionsSchema as aj, type Plugin as ak, type PluginProvides as al, definePlugin as am, createPluginMethod as an, createPaginatedPluginMethod as ao, composePlugins as ap, type ActionItem as aq, type ActionTypeItem as ar, type RequestOptions as as, type PollOptions as at, registryPlugin as au, type BaseEvent as av, type MethodCalledEvent as aw, type EventEmissionProvides as ax, type EventContext as ay, type ApplicationLifecycleEventData as az, type AddActionEntryOptions as b, ZapierResourceNotFoundError as b$, ActionTypePropertySchema as b0, ActionKeyPropertySchema as b1, ActionPropertySchema as b2, InputFieldPropertySchema as b3, ConnectionIdPropertySchema as b4, AuthenticationIdPropertySchema as b5, ConnectionPropertySchema as b6, InputsPropertySchema as b7, LimitPropertySchema as b8, OffsetPropertySchema as b9, type LimitProperty as bA, type OffsetProperty as bB, type OutputProperty as bC, type DebugProperty as bD, type ParamsProperty as bE, type ActionTimeoutMsProperty as bF, type TableProperty as bG, type RecordProperty as bH, type RecordsProperty as bI, type FieldsProperty as bJ, type AppsProperty as bK, type TablesProperty as bL, type ConnectionsProperty as bM, type TriggerInboxProperty as bN, type TriggerInboxNameProperty as bO, type LeaseProperty as bP, type LeaseSecondsProperty as bQ, type LeaseLimitProperty as bR, type ApiError as bS, type ErrorOptions as bT, ZapierError as bU, ZapierApiError as bV, ZapierAppNotFoundError as bW, ZapierValidationError as bX, ZapierUnknownError as bY, ZapierAuthenticationError as bZ, ZapierNotFoundError as b_, OutputPropertySchema as ba, DebugPropertySchema as bb, ParamsPropertySchema as bc, ActionTimeoutMsPropertySchema as bd, TablePropertySchema as be, RecordPropertySchema as bf, RecordsPropertySchema as bg, FieldsPropertySchema as bh, AppsPropertySchema as bi, TablesPropertySchema as bj, ConnectionsPropertySchema as bk, TriggerInboxPropertySchema as bl, TriggerInboxNamePropertySchema as bm, LeasePropertySchema as bn, LeaseSecondsPropertySchema as bo, LeaseLimitPropertySchema as bp, type AppKeyProperty as bq, type AppProperty as br, type ActionTypeProperty as bs, type ActionKeyProperty as bt, type ActionProperty as bu, type InputFieldProperty as bv, type ConnectionIdProperty as bw, type ConnectionProperty as bx, type AuthenticationIdProperty as by, type InputsProperty as bz, type AddActionEntryResult as c, appKeyResolver as c$, ZapierConfigurationError as c0, ZapierBundleError as c1, ZapierTimeoutError as c2, ZapierActionError as c3, ZapierConflictError as c4, type RateLimitInfo as c5, ZapierRateLimitError as c6, type ApprovalStatus as c7, ZapierApprovalError as c8, ZapierRelayError as c9, getAppPlugin as cA, type GetAppPluginProvides as cB, getActionPlugin as cC, type GetActionPluginProvides as cD, getConnectionPlugin as cE, type GetConnectionPluginProvides as cF, findFirstConnectionPlugin as cG, type FindFirstConnectionPluginProvides as cH, findUniqueConnectionPlugin as cI, type FindUniqueConnectionPluginProvides as cJ, CONTEXT_CACHE_TTL_MS as cK, CONTEXT_CACHE_MAX_SIZE as cL, runActionPlugin as cM, type RunActionPluginProvides as cN, requestPlugin as cO, type RequestPluginProvides as cP, type ManifestPluginOptions as cQ, getPreferredManifestEntryKey as cR, manifestPlugin as cS, type ManifestPluginProvides as cT, DEFAULT_CONFIG_PATH as cU, type ManifestEntry as cV, getProfilePlugin as cW, type GetProfilePluginProvides as cX, type ApiPluginOptions as cY, apiPlugin as cZ, type ApiPluginProvides as c_, formatErrorMessage as ca, ZapierSignal as cb, appsPlugin as cc, type AppsPluginProvides as cd, type ActionExecutionOptions as ce, type AppFactoryInput as cf, fetchPlugin as cg, type FetchPluginProvides as ch, listAppsPlugin as ci, type ListAppsPluginProvides as cj, listActionsPlugin as ck, type ListActionsPluginProvides as cl, listActionInputFieldsPlugin as cm, type ListActionInputFieldsPluginProvides as cn, listActionInputFieldChoicesPlugin as co, type ListActionInputFieldChoicesPluginProvides as cp, getActionInputFieldsSchemaPlugin as cq, type GetActionInputFieldsSchemaPluginProvides as cr, listConnectionsPlugin as cs, type ListConnectionsPluginProvides as ct, listClientCredentialsPlugin as cu, type ListClientCredentialsPluginProvides as cv, createClientCredentialsPlugin as cw, type CreateClientCredentialsPluginProvides as cx, deleteClientCredentialsPlugin as cy, type DeleteClientCredentialsPluginProvides as cz, type ActionEntry as d, connectionsPlugin as d$, actionTypeResolver as d0, actionKeyResolver as d1, connectionIdResolver as d2, connectionIdGenericResolver as d3, inputsResolver as d4, inputsAllOptionalResolver as d5, inputFieldKeyResolver as d6, clientCredentialsNameResolver as d7, clientIdResolver as d8, tableIdResolver as d9, type LoadingEvent as dA, type EventCallback as dB, type Credentials as dC, type ResolvedCredentials as dD, type CredentialsObject as dE, type ClientCredentialsObject as dF, type PkceCredentialsObject as dG, isClientCredentials as dH, isPkceCredentials as dI, isCredentialsObject as dJ, isCredentialsFunction as dK, type ResolveCredentialsOptions as dL, resolveCredentialsFromEnv as dM, resolveCredentials as dN, getBaseUrlFromCredentials as dO, getClientIdFromCredentials as dP, ClientCredentialsObjectSchema as dQ, PkceCredentialsObjectSchema as dR, CredentialsObjectSchema as dS, ResolvedCredentialsSchema as dT, CredentialsFunctionSchema as dU, type CredentialsFunction as dV, CredentialsSchema as dW, ConnectionEntrySchema as dX, type ConnectionEntry as dY, ConnectionsMapSchema as dZ, type ConnectionsMap as d_, triggerInboxResolver as da, tableRecordIdResolver as db, tableRecordIdsResolver as dc, tableFieldIdsResolver as dd, tableNameResolver as de, tableFieldsResolver as df, tableRecordsResolver as dg, tableUpdateRecordsResolver as dh, tableFiltersResolver as di, tableSortResolver as dj, type ResolveAuthTokenOptions as dk, clearTokenCache as dl, invalidateCachedToken as dm, injectCliLogin as dn, isCliLoginAvailable as dp, getTokenFromCliLogin as dq, resolveAuthToken as dr, invalidateCredentialsToken as ds, type ZapierCache as dt, type ZapierCacheEntry as du, type ZapierCacheSetOptions as dv, createMemoryCache as dw, type SdkEvent as dx, type AuthEvent as dy, type ApiEvent as dz, type PaginatedSdkResult as e, type ConnectionsPluginProvides as e0, ZAPIER_BASE_URL as e1, getZapierSdkService as e2, MAX_PAGE_LIMIT as e3, DEFAULT_PAGE_SIZE as e4, DEFAULT_ACTION_TIMEOUT_MS as e5, ZAPIER_MAX_NETWORK_RETRIES as e6, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS as e7, getZapierIsInteractive as e8, getZapierApprovalMode as e9, createZapierSdk as eA, type ZapierSdk as eB, DEFAULT_APPROVAL_TIMEOUT_MS as ea, DEFAULT_MAX_APPROVAL_RETRIES as eb, listTablesPlugin as ec, type ListTablesPluginProvides as ed, getTablePlugin as ee, type GetTablePluginProvides as ef, createTablePlugin as eg, type CreateTablePluginProvides as eh, deleteTablePlugin as ei, type DeleteTablePluginProvides as ej, listTableFieldsPlugin as ek, type ListTableFieldsPluginProvides as el, createTableFieldsPlugin as em, type CreateTableFieldsPluginProvides as en, deleteTableFieldsPlugin as eo, type DeleteTableFieldsPluginProvides as ep, getTableRecordPlugin as eq, type GetTableRecordPluginProvides as er, listTableRecordsPlugin as es, type ListTableRecordsPluginProvides as et, createTableRecordsPlugin as eu, type CreateTableRecordsPluginProvides as ev, deleteTableRecordsPlugin as ew, type DeleteTableRecordsPluginProvides as ex, updateTableRecordsPlugin as ey, type UpdateTableRecordsPluginProvides as ez, findManifestEntry as f, type PositionalMetadata as g, type ZapierFetchInitOptions as h, type DynamicResolver as i, type WatchTriggerInboxOptions as j, type ActionProxy as k, type ZapierSdkApps as l, ZapierAbortDrainSignal as m, ZapierReleaseTriggerMessageSignal as n, type DrainTriggerInboxCallback as o, type DrainTriggerInboxErrorObserver as p, type ListAuthenticationsPluginProvides as q, readManifestFromFile as r, type FindFirstAuthenticationPluginProvides as s, type FindUniqueAuthenticationPluginProvides as t, type Action as u, type App as v, type Field as w, type Choice as x, type ActionExecutionResult as y, type ActionField as z };
+export { type Resolver as $, type ApiClient as A, type BaseSdkOptions as B, type CapabilitiesContext as C, type DrainTriggerInboxOptions as D, type EventEmissionContext as E, type FieldsetItem as F, type GetAuthenticationPluginProvides as G, type ActionFieldChoice as H, type NeedsRequest as I, type NeedsResponse as J, type Connection as K, type LeasedTriggerMessageItem as L, type Manifest as M, type Need as N, type ConnectionsResponse as O, type PluginMeta as P, type UserProfile as Q, type ResolvedAppLocator as R, isPositional as S, type TriggerMessageStatus as T, type UpdateManifestEntryOptions as U, createFunction as V, type WithAddPlugin as W, type FormattedItem as X, type FormatMetadata as Y, type ZapierSdkOptions as Z, type OutputFormatter as _, type UpdateManifestEntryResult as a, type PaginatedSdkFunction as a$, type ArrayResolver as a0, type ResolverMetadata as a1, type StaticResolver as a2, type FieldsResolver as a3, runWithTelemetryContext as a4, toSnakeCase as a5, toTitleCase as a6, batch as a7, type BatchOptions as a8, buildCapabilityMessage as a9, type EventContext as aA, type ApplicationLifecycleEventData as aB, type EnhancedErrorEventData as aC, type MethodCalledEventData as aD, generateEventId as aE, getCurrentTimestamp as aF, getReleaseId as aG, getOsInfo as aH, getPlatformVersions as aI, isCi as aJ, getCiPlatform as aK, getMemoryUsage as aL, getCpuTime as aM, buildApplicationLifecycleEvent as aN, buildErrorEventWithContext as aO, buildErrorEvent as aP, createBaseEvent as aQ, buildMethodCalledEvent as aR, type AppItem as aS, type ConnectionItem as aT, type ActionItem$1 as aU, type InputFieldItem as aV, type InfoFieldItem as aW, type RootFieldItem as aX, type UserProfileItem as aY, type FunctionOptions as aZ, type SdkPage as a_, logDeprecation as aa, resetDeprecationWarnings as ab, RelayRequestSchema as ac, RelayFetchSchema as ad, createZapierSdkWithoutRegistry as ae, createSdk as af, createOptionsPlugin as ag, type FunctionRegistryEntry as ah, type FunctionDeprecation as ai, BaseSdkOptionsSchema as aj, type Plugin as ak, type PluginProvides as al, definePlugin as am, createPluginMethod as an, createPaginatedPluginMethod as ao, composePlugins as ap, type ActionItem as aq, type ActionTypeItem as ar, registryPlugin as as, type RequestOptions as at, type PollOptions as au, createZapierApi as av, getOrCreateApiClient as aw, type BaseEvent as ax, type MethodCalledEvent as ay, type EventEmissionProvides as az, type AddActionEntryOptions as b, ZapierAuthenticationError as b$, AppKeyPropertySchema as b0, AppPropertySchema as b1, ActionTypePropertySchema as b2, ActionKeyPropertySchema as b3, ActionPropertySchema as b4, InputFieldPropertySchema as b5, ConnectionIdPropertySchema as b6, AuthenticationIdPropertySchema as b7, ConnectionPropertySchema as b8, InputsPropertySchema as b9, type AuthenticationIdProperty as bA, type InputsProperty as bB, type LimitProperty as bC, type OffsetProperty as bD, type OutputProperty as bE, type DebugProperty as bF, type ParamsProperty as bG, type ActionTimeoutMsProperty as bH, type TableProperty as bI, type RecordProperty as bJ, type RecordsProperty as bK, type FieldsProperty as bL, type AppsProperty as bM, type TablesProperty as bN, type ConnectionsProperty as bO, type TriggerInboxProperty as bP, type TriggerInboxNameProperty as bQ, type LeaseProperty as bR, type LeaseSecondsProperty as bS, type LeaseLimitProperty as bT, type ApiError as bU, type ErrorOptions as bV, ZapierError as bW, ZapierApiError as bX, ZapierAppNotFoundError as bY, ZapierValidationError as bZ, ZapierUnknownError as b_, LimitPropertySchema as ba, OffsetPropertySchema as bb, OutputPropertySchema as bc, DebugPropertySchema as bd, ParamsPropertySchema as be, ActionTimeoutMsPropertySchema as bf, TablePropertySchema as bg, RecordPropertySchema as bh, RecordsPropertySchema as bi, FieldsPropertySchema as bj, AppsPropertySchema as bk, TablesPropertySchema as bl, ConnectionsPropertySchema as bm, TriggerInboxPropertySchema as bn, TriggerInboxNamePropertySchema as bo, LeasePropertySchema as bp, LeaseSecondsPropertySchema as bq, LeaseLimitPropertySchema as br, type AppKeyProperty as bs, type AppProperty as bt, type ActionTypeProperty as bu, type ActionKeyProperty as bv, type ActionProperty as bw, type InputFieldProperty as bx, type ConnectionIdProperty as by, type ConnectionProperty as bz, type AddActionEntryResult as c, apiPlugin as c$, ZapierNotFoundError as c0, ZapierResourceNotFoundError as c1, ZapierConfigurationError as c2, ZapierBundleError as c3, ZapierTimeoutError as c4, ZapierActionError as c5, ZapierConflictError as c6, type RateLimitInfo as c7, ZapierRateLimitError as c8, type ApprovalStatus as c9, deleteClientCredentialsPlugin as cA, type DeleteClientCredentialsPluginProvides as cB, getAppPlugin as cC, type GetAppPluginProvides as cD, getActionPlugin as cE, type GetActionPluginProvides as cF, getConnectionPlugin as cG, type GetConnectionPluginProvides as cH, findFirstConnectionPlugin as cI, type FindFirstConnectionPluginProvides as cJ, findUniqueConnectionPlugin as cK, type FindUniqueConnectionPluginProvides as cL, CONTEXT_CACHE_TTL_MS as cM, CONTEXT_CACHE_MAX_SIZE as cN, runActionPlugin as cO, type RunActionPluginProvides as cP, requestPlugin as cQ, type RequestPluginProvides as cR, type ManifestPluginOptions as cS, getPreferredManifestEntryKey as cT, manifestPlugin as cU, type ManifestPluginProvides as cV, DEFAULT_CONFIG_PATH as cW, type ManifestEntry as cX, getProfilePlugin as cY, type GetProfilePluginProvides as cZ, type ApiPluginOptions as c_, ZapierApprovalError as ca, ZapierRelayError as cb, formatErrorMessage as cc, ZapierSignal as cd, appsPlugin as ce, type AppsPluginProvides as cf, type ActionExecutionOptions as cg, type AppFactoryInput as ch, fetchPlugin as ci, type FetchPluginProvides as cj, listAppsPlugin as ck, type ListAppsPluginProvides as cl, listActionsPlugin as cm, type ListActionsPluginProvides as cn, listActionInputFieldsPlugin as co, type ListActionInputFieldsPluginProvides as cp, listActionInputFieldChoicesPlugin as cq, type ListActionInputFieldChoicesPluginProvides as cr, getActionInputFieldsSchemaPlugin as cs, type GetActionInputFieldsSchemaPluginProvides as ct, listConnectionsPlugin as cu, type ListConnectionsPluginProvides as cv, listClientCredentialsPlugin as cw, type ListClientCredentialsPluginProvides as cx, createClientCredentialsPlugin as cy, type CreateClientCredentialsPluginProvides as cz, type ActionEntry as d, ConnectionsMapSchema as d$, type ApiPluginProvides as d0, appKeyResolver as d1, actionTypeResolver as d2, actionKeyResolver as d3, connectionIdResolver as d4, connectionIdGenericResolver as d5, inputsResolver as d6, inputsAllOptionalResolver as d7, inputFieldKeyResolver as d8, clientCredentialsNameResolver as d9, type AuthEvent as dA, type ApiEvent as dB, type LoadingEvent as dC, type EventCallback as dD, type Credentials as dE, type ResolvedCredentials as dF, type CredentialsObject as dG, type ClientCredentialsObject as dH, type PkceCredentialsObject as dI, isClientCredentials as dJ, isPkceCredentials as dK, isCredentialsObject as dL, isCredentialsFunction as dM, type ResolveCredentialsOptions as dN, resolveCredentialsFromEnv as dO, resolveCredentials as dP, getBaseUrlFromCredentials as dQ, getClientIdFromCredentials as dR, ClientCredentialsObjectSchema as dS, PkceCredentialsObjectSchema as dT, CredentialsObjectSchema as dU, ResolvedCredentialsSchema as dV, CredentialsFunctionSchema as dW, type CredentialsFunction as dX, CredentialsSchema as dY, ConnectionEntrySchema as dZ, type ConnectionEntry as d_, clientIdResolver as da, tableIdResolver as db, triggerInboxResolver as dc, tableRecordIdResolver as dd, tableRecordIdsResolver as de, tableFieldIdsResolver as df, tableNameResolver as dg, tableFieldsResolver as dh, tableRecordsResolver as di, tableUpdateRecordsResolver as dj, tableFiltersResolver as dk, tableSortResolver as dl, type ResolveAuthTokenOptions as dm, clearTokenCache as dn, invalidateCachedToken as dp, injectCliLogin as dq, isCliLoginAvailable as dr, getTokenFromCliLogin as ds, resolveAuthToken as dt, invalidateCredentialsToken as du, type ZapierCache as dv, type ZapierCacheEntry as dw, type ZapierCacheSetOptions as dx, createMemoryCache as dy, type SdkEvent as dz, type PaginatedSdkResult as e, type ConnectionsMap as e0, connectionsPlugin as e1, type ConnectionsPluginProvides as e2, ZAPIER_BASE_URL as e3, getZapierSdkService as e4, MAX_PAGE_LIMIT as e5, DEFAULT_PAGE_SIZE as e6, DEFAULT_ACTION_TIMEOUT_MS as e7, ZAPIER_MAX_NETWORK_RETRIES as e8, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS as e9, type UpdateTableRecordsPluginProvides as eA, createZapierSdk as eB, type ZapierSdk as eC, getZapierApprovalMode as ea, DEFAULT_APPROVAL_TIMEOUT_MS as eb, DEFAULT_MAX_APPROVAL_RETRIES as ec, listTablesPlugin as ed, type ListTablesPluginProvides as ee, getTablePlugin as ef, type GetTablePluginProvides as eg, createTablePlugin as eh, type CreateTablePluginProvides as ei, deleteTablePlugin as ej, type DeleteTablePluginProvides as ek, listTableFieldsPlugin as el, type ListTableFieldsPluginProvides as em, createTableFieldsPlugin as en, type CreateTableFieldsPluginProvides as eo, deleteTableFieldsPlugin as ep, type DeleteTableFieldsPluginProvides as eq, getTableRecordPlugin as er, type GetTableRecordPluginProvides as es, listTableRecordsPlugin as et, type ListTableRecordsPluginProvides as eu, createTableRecordsPlugin as ev, type CreateTableRecordsPluginProvides as ew, deleteTableRecordsPlugin as ex, type DeleteTableRecordsPluginProvides as ey, updateTableRecordsPlugin as ez, findManifestEntry as f, type PositionalMetadata as g, type ZapierFetchInitOptions as h, type DynamicResolver as i, type WatchTriggerInboxOptions as j, type ActionProxy as k, type ZapierSdkApps as l, ZapierAbortDrainSignal as m, ZapierReleaseTriggerMessageSignal as n, type DrainTriggerInboxCallback as o, type DrainTriggerInboxErrorObserver as p, type ListAuthenticationsPluginProvides as q, readManifestFromFile as r, type FindFirstAuthenticationPluginProvides as s, type FindUniqueAuthenticationPluginProvides as t, type Action as u, type App as v, type Field as w, type Choice as x, type ActionExecutionResult as y, type ActionField as z };