@zapier/zapier-sdk 0.35.0 → 0.37.0

package/dist/index.mjs

@@ -42,6 +42,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_PAGE_SIZE = 100;
 var DEFAULT_ACTION_TIMEOUT_MS = 18e4;
 function parseIntEnvVar(name) {
   const value = process.env[name];
@@ -75,6 +76,9 @@ var ActionTypePropertySchema = z.enum([
 var ActionKeyPropertySchema = z.string().min(1).describe("Action key to execute");
 var ConnectionIdPropertySchema = z.union([z.string(), z.number().int().positive()]).describe("Connection ID to use for this action");
 var AuthenticationIdPropertySchema = ConnectionIdPropertySchema;
+var ConnectionPropertySchema = z.union([z.string(), z.number().int().positive()]).describe(
+  "Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly."
+);
 var InputsPropertySchema = z.record(z.string(), z.unknown()).describe("Input parameters for the action");
 var LimitPropertySchema = z.number().int().min(1).max(MAX_PAGE_LIMIT).default(50).describe("Maximum number of items to return");
 var OffsetPropertySchema = z.number().int().min(0).default(0).describe("Number of items to skip for pagination");
@@ -249,6 +253,7 @@ HTTP Status: ${error.statusCode}`;
 var ActionExecutionInputSchema = z.object({
   inputs: z.record(z.string(), z.unknown()).optional(),
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional(),
   timeoutMs: ActionTimeoutMsPropertySchema
@@ -257,9 +262,10 @@ var ActionExecutionInputSchema = z.object({
 );
 var AppFactoryInputSchema = z.object({
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional()
-}).describe("Bind a connection ID to an app");
+}).describe("Bind a connection alias or numeric connectionId to an app");
 function getStringProperty(obj, key) {
   if (typeof obj === "object" && obj !== null && key in obj) {
     const value = obj[key];
@@ -287,44 +293,80 @@ var ActionResultItemSchema = withFormatter(
 );
 
 // src/plugins/apps/index.ts
-function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId) {
+function resolveProxyConnection({
+  providedConnectionId,
+  providedConnection,
+  providedAuthenticationId,
+  pinnedAuthId,
+  pinnedConnection,
+  errorContext
+}) {
+  const hasDirectId = providedConnectionId != null || providedAuthenticationId != null;
+  if (hasDirectId && providedConnection != null) {
+    throw new ZapierValidationError(
+      "Cannot specify both connectionId/authenticationId and connection. Use connectionId for a direct ID, or connection for an alias or numeric ID."
+    );
+  }
+  const hasPerCall = providedConnectionId != null || providedConnection != null || providedAuthenticationId != null;
+  let finalConnectionId;
+  let finalConnection;
+  if (hasPerCall) {
+    finalConnectionId = providedConnectionId ?? providedAuthenticationId;
+    finalConnection = finalConnectionId != null ? void 0 : providedConnection;
+  } else {
+    finalConnectionId = pinnedAuthId;
+    finalConnection = pinnedAuthId != null ? void 0 : pinnedConnection;
+  }
+  if (finalConnectionId == null && finalConnection == null) {
+    throw new ZapierValidationError(errorContext);
+  }
+  return { connectionId: finalConnectionId, connection: finalConnection };
+}
+function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId, pinnedConnection) {
   return (actionOptions = {}) => {
     const { sdk } = options;
     const {
       inputs,
       connectionId: providedConnectionId,
+      connection: providedConnection,
       authenticationId: providedAuthenticationId,
       timeoutMs
     } = actionOptions;
-    const resolvedConnectionId = pinnedAuthId ?? providedConnectionId ?? providedAuthenticationId;
-    if (!resolvedConnectionId) {
-      throw new ZapierValidationError(
-        `Connection ID is required. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }) or provide connectionId in the action call.`
-      );
-    }
+    const { connectionId, connection } = resolveProxyConnection({
+      providedConnectionId,
+      providedConnection,
+      providedAuthenticationId,
+      pinnedAuthId,
+      pinnedConnection,
+      errorContext: `Connection is required. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }) or sdk.apps.${appKey}({ connection: "name" }), or provide connectionId/connection in the action call.`
+    });
     return sdk.runAction({
       appKey,
       actionType,
       actionKey,
       inputs,
-      connectionId: resolvedConnectionId,
+      connectionId,
+      connection,
       timeoutMs
     });
   };
 }
-function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
+function createActionTypeProxy(appKey, actionType, options, pinnedAuthId, pinnedConnection) {
   if (actionType === "fetch") {
     return async (url, init) => {
       const { sdk } = options;
-      const resolvedConnectionId = pinnedAuthId ?? init?.connectionId ?? init?.authenticationId;
-      if (!resolvedConnectionId) {
-        throw new ZapierValidationError(
-          `Connection ID is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId in the fetch call.`
-        );
-      }
+      const { connectionId, connection } = resolveProxyConnection({
+        providedConnectionId: init?.connectionId,
+        providedConnection: init?.connection,
+        providedAuthenticationId: init?.authenticationId,
+        pinnedAuthId,
+        pinnedConnection,
+        errorContext: `Connection is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId/connection in the fetch call.`
+      });
       return sdk.fetch(url, {
         ...init,
-        connectionId: resolvedConnectionId
+        connectionId,
+        connection
       });
     };
   }
@@ -338,7 +380,8 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
             actionType,
             actionKey,
             options,
-            pinnedAuthId
+            pinnedAuthId,
+            pinnedConnection
           );
         }
         return void 0;
@@ -346,7 +389,7 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
     }
   );
 }
-function createPinnedAppProxy(appKey, options, pinnedAuthId) {
+function createPinnedAppProxy(appKey, options, pinnedAuthId, pinnedConnection) {
   return new Proxy(
     {},
     {
@@ -356,7 +399,8 @@ function createPinnedAppProxy(appKey, options, pinnedAuthId) {
             appKey,
             actionType,
             options,
-            pinnedAuthId
+            pinnedAuthId,
+            pinnedConnection
           );
         }
         return void 0;
@@ -367,12 +411,23 @@ function createPinnedAppProxy(appKey, options, pinnedAuthId) {
 function createAppProxy(appKey, options) {
   const appFactory = (factoryOptions) => {
     const resolvedConnectionId = factoryOptions.connectionId ?? factoryOptions.authenticationId;
-    if (!resolvedConnectionId) {
+    const resolvedConnection = factoryOptions.connection;
+    if (resolvedConnectionId != null && resolvedConnection != null) {
+      throw new ZapierValidationError(
+        "Cannot specify both connectionId/authenticationId and connection. Use connectionId for a direct ID, or connection for an alias or numeric ID."
+      );
+    }
+    if (resolvedConnectionId == null && resolvedConnection == null) {
       throw new ZapierValidationError(
-        `Connection ID is required. Use sdk.apps.${appKey}({ connectionId: "..." })`
+        `Connection is required. Use sdk.apps.${appKey}({ connectionId: "..." }) or sdk.apps.${appKey}({ connection: "name" })`
       );
     }
-    return createPinnedAppProxy(appKey, options, resolvedConnectionId);
+    return createPinnedAppProxy(
+      appKey,
+      options,
+      resolvedConnectionId,
+      resolvedConnection
+    );
   };
   return new Proxy(appFactory, {
     get(_, actionType) {
@@ -435,6 +490,7 @@ var FetchInitSchema = z.object({
     "Request body \u2014 plain objects and JSON strings are auto-detected and Content-Type is set accordingly"
   ),
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional(),
   callbackUrl: z.string().optional().describe("URL to send async response to (makes request async)")
@@ -442,6 +498,119 @@ var FetchInitSchema = z.object({
   "Request options including method, headers, body, and authentication"
 );
 
+// src/utils/domain-utils.ts
+async function resolveConnectionId({
+  connectionId,
+  connection,
+  authenticationId,
+  resolveConnection,
+  label
+}) {
+  const hasDirectId = connectionId != null || authenticationId != null;
+  if (hasDirectId && connection != null) {
+    const context = label ? ` for ${label}` : "";
+    throw new ZapierValidationError(
+      `Cannot specify both connectionId/authenticationId and connection${context}. Use connectionId for a direct ID, or connection for an alias or numeric ID.`
+    );
+  }
+  let resolvedConnectionId = connectionId ?? authenticationId ?? void 0;
+  if (connection != null && resolvedConnectionId == null) {
+    if (typeof connection === "number") {
+      resolvedConnectionId = connection;
+    } else {
+      const entry = await resolveConnection(connection);
+      if (!entry) {
+        throw new ZapierConfigurationError(
+          `Connection "${connection}" not found in connections map. Ensure the connection is defined in the manifest connections, or use a numeric connectionId.`,
+          { configType: "connections" }
+        );
+      }
+      resolvedConnectionId = entry.connectionId;
+    }
+  }
+  return resolvedConnectionId;
+}
+function splitVersionedKey(versionedKey) {
+  const parts = versionedKey.split("@");
+  if (parts.length >= 2) {
+    const baseKey = parts[0];
+    const version = parts.slice(1).join("@");
+    return [baseKey, version];
+  }
+  return [versionedKey, void 0];
+}
+function normalizeImplementationMetaToAppItem(implementationMeta) {
+  const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
+  const { id, name, ...restOfImplementationMeta } = implementationMeta;
+  return {
+    ...restOfImplementationMeta,
+    title: name,
+    key: selectedApi,
+    implementation_id: id,
+    version: appVersion
+  };
+}
+function normalizeActionItem(action) {
+  const { name, type, selected_api: selectedApi } = action;
+  const [appKey, appVersion] = selectedApi ? splitVersionedKey(selectedApi) : ["", void 0];
+  return {
+    // Only include the fields we want - explicitly list them
+    id: action.id,
+    key: action.key,
+    description: action.description,
+    is_important: action.is_important,
+    is_hidden: action.is_hidden,
+    // Transformed fields
+    app_key: appKey,
+    app_version: appVersion,
+    action_type: type,
+    title: name,
+    // Map name to title
+    type: "action"
+  };
+}
+function isSlug(slug) {
+  return !!slug.match(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+}
+function isSnakeCasedSlug(slug) {
+  if (slug.match(/^_[0-9]/)) {
+    slug = slug.slice(1);
+  }
+  return !!slug.match(/^[a-z0-9]+(?:_[a-z0-9]+)*$/);
+}
+function dashifySnakeCasedSlug(slug) {
+  if (!isSnakeCasedSlug(slug)) {
+    return slug;
+  }
+  if (slug.startsWith("_")) {
+    slug = slug.slice(1);
+  }
+  return slug.replace(/_/g, "-");
+}
+function isUuid(appKey) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    appKey
+  );
+}
+function toAppLocator(appKey) {
+  const [appKeyWithoutVersion, version] = splitVersionedKey(appKey);
+  if (isUuid(appKeyWithoutVersion)) {
+    throw new Error(
+      `UUID app keys are not supported. Use app slug or implementation ID instead of: ${appKey}`
+    );
+  }
+  const slug = isSlug(appKeyWithoutVersion) ? appKeyWithoutVersion : isSnakeCasedSlug(appKeyWithoutVersion) ? dashifySnakeCasedSlug(appKeyWithoutVersion) : void 0;
+  return {
+    lookupAppKey: appKeyWithoutVersion,
+    slug,
+    implementationName: slug ? void 0 : appKeyWithoutVersion,
+    version
+  };
+}
+function isResolvedAppLocator(appLocator) {
+  return !!appLocator.implementationName;
+}
+
 // src/utils/id-utils.ts
 function coerceToNumericId(fieldName, value) {
   if (value === "") {
@@ -536,8 +705,20 @@ var fetchPlugin = ({ context }) => {
         const startTime = Date.now();
         const isNested = isTelemetryNested();
         try {
-          const { connectionId, authenticationId, callbackUrl, ...fetchInit } = init || {};
-          const resolvedConnectionId = connectionId ?? authenticationId;
+          const {
+            connectionId,
+            connection,
+            authenticationId,
+            callbackUrl,
+            ...fetchInit
+          } = init || {};
+          const resolvedConnectionId = await resolveConnectionId({
+            connectionId,
+            connection,
+            authenticationId,
+            resolveConnection: context.resolveConnection,
+            label: "fetch"
+          });
           const relayPath = transformUrlToRelayPath(url);
           const headers = normalizeHeaders(
             fetchInit.headers
@@ -1022,7 +1203,7 @@ function createPageFunction(coreFn) {
   };
   return namedFunctions[functionName];
 }
-function createPaginatedFunction(coreFn, schema, telemetry, explicitFunctionName) {
+function createPaginatedFunction(coreFn, schema, telemetry, explicitFunctionName, defaultPageSize) {
   const pageFunction = createPageFunction(coreFn);
   const functionName = explicitFunctionName || coreFn.name;
   const validator = schema ? createValidator(schema) : null;
@@ -1036,7 +1217,7 @@ function createPaginatedFunction(coreFn, schema, telemetry, explicitFunctionName
           ...normalizedOptions,
           ...validator ? validator(normalizedOptions) : normalizedOptions
         };
-        const pageSize = validatedOptions.pageSize || 100;
+        const pageSize = validatedOptions.pageSize ?? defaultPageSize;
         const optimizedOptions = {
           ...validatedOptions,
           pageSize
@@ -1210,7 +1391,9 @@ var listAppsPlugin = ({ context }) => {
       searchParams: {
         appKeys: implementationIds.join(","),
         ...options.search && { search: options.search },
-        pageSize: options.pageSize.toString(),
+        ...options.pageSize !== void 0 && {
+          pageSize: options.pageSize.toString()
+        },
         ...options.cursor && { offset: options.cursor }
       }
     });
@@ -1220,7 +1403,8 @@ var listAppsPlugin = ({ context }) => {
     listAppsPage,
     ListAppsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listApps: listAppsDefinition,
@@ -1237,88 +1421,6 @@ var listAppsPlugin = ({ context }) => {
     }
   };
 };
-
-// src/utils/domain-utils.ts
-function splitVersionedKey(versionedKey) {
-  const parts = versionedKey.split("@");
-  if (parts.length >= 2) {
-    const baseKey = parts[0];
-    const version = parts.slice(1).join("@");
-    return [baseKey, version];
-  }
-  return [versionedKey, void 0];
-}
-function normalizeImplementationMetaToAppItem(implementationMeta) {
-  const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
-  const { id, name, ...restOfImplementationMeta } = implementationMeta;
-  return {
-    ...restOfImplementationMeta,
-    title: name,
-    key: selectedApi,
-    implementation_id: id,
-    version: appVersion
-  };
-}
-function normalizeActionItem(action) {
-  const { name, type, selected_api: selectedApi } = action;
-  const [appKey, appVersion] = selectedApi ? splitVersionedKey(selectedApi) : ["", void 0];
-  return {
-    // Only include the fields we want - explicitly list them
-    id: action.id,
-    key: action.key,
-    description: action.description,
-    is_important: action.is_important,
-    is_hidden: action.is_hidden,
-    // Transformed fields
-    app_key: appKey,
-    app_version: appVersion,
-    action_type: type,
-    title: name,
-    // Map name to title
-    type: "action"
-  };
-}
-function isSlug(slug) {
-  return !!slug.match(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
-}
-function isSnakeCasedSlug(slug) {
-  if (slug.match(/^_[0-9]/)) {
-    slug = slug.slice(1);
-  }
-  return !!slug.match(/^[a-z0-9]+(?:_[a-z0-9]+)*$/);
-}
-function dashifySnakeCasedSlug(slug) {
-  if (!isSnakeCasedSlug(slug)) {
-    return slug;
-  }
-  if (slug.startsWith("_")) {
-    slug = slug.slice(1);
-  }
-  return slug.replace(/_/g, "-");
-}
-function isUuid(appKey) {
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
-    appKey
-  );
-}
-function toAppLocator(appKey) {
-  const [appKeyWithoutVersion, version] = splitVersionedKey(appKey);
-  if (isUuid(appKeyWithoutVersion)) {
-    throw new Error(
-      `UUID app keys are not supported. Use app slug or implementation ID instead of: ${appKey}`
-    );
-  }
-  const slug = isSlug(appKeyWithoutVersion) ? appKeyWithoutVersion : isSnakeCasedSlug(appKeyWithoutVersion) ? dashifySnakeCasedSlug(appKeyWithoutVersion) : void 0;
-  return {
-    lookupAppKey: appKeyWithoutVersion,
-    slug,
-    implementationName: slug ? void 0 : appKeyWithoutVersion,
-    version
-  };
-}
-function isResolvedAppLocator(appLocator) {
-  return !!appLocator.implementationName;
-}
 var ListActionsSchema = z.object({
   appKey: AppKeyPropertySchema.describe(
     "App key of actions to list (e.g., 'SlackCLIAPI' or slug like 'github')"
@@ -2601,7 +2703,8 @@ var listActionsPlugin = ({ context }) => {
     listActionsPage,
     ListActionsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listActions: listActionsDefinition,
@@ -2958,7 +3061,8 @@ var listInputFieldsPlugin = ({ sdk, context }) => {
     listInputFieldsPage,
     ListInputFieldsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listInputFields: listInputFieldsDefinition,
@@ -3044,9 +3148,10 @@ var ConnectionItemSchema = withFormatter(ConnectionItemSchema$1, {
 var listConnectionsPlugin = ({ context }) => {
   async function listConnectionsPage(options) {
     const { api, getVersionedImplementationId } = context;
-    const searchParams = {
-      page_size: options.pageSize.toString()
-    };
+    const searchParams = {};
+    if (options.pageSize !== void 0) {
+      searchParams.page_size = options.pageSize.toString();
+    }
     if (options.appKey) {
       const implementationId = await getVersionedImplementationId(
         options.appKey
@@ -3110,7 +3215,8 @@ var listConnectionsPlugin = ({ context }) => {
     listConnectionsPage,
     ListConnectionsQuerySchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listConnections: listConnectionsDefinition,
@@ -3188,9 +3294,10 @@ var ClientCredentialsCreatedItemSchema = withFormatter(
 var listClientCredentialsPlugin = ({ context }) => {
   async function listClientCredentialsPage(options) {
     const { api } = context;
-    const searchParams = {
-      pageSize: options.pageSize.toString()
-    };
+    const searchParams = {};
+    if (options.pageSize !== void 0) {
+      searchParams.pageSize = options.pageSize.toString();
+    }
     if (options.cursor) {
       searchParams.offset = options.cursor;
     }
@@ -3224,7 +3331,8 @@ var listClientCredentialsPlugin = ({ context }) => {
     listClientCredentialsPage,
     ListClientCredentialsQuerySchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listClientCredentials: listClientCredentialsDefinition,
@@ -3623,6 +3731,9 @@ var RunActionSchema = z.object({
   connectionId: ConnectionIdPropertySchema.nullable().optional().describe(
     "Connection ID to use when running the action. Required if the action needs a connection to authenticate and interact with the service."
   ),
+  connection: ConnectionPropertySchema.optional().describe(
+    "Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly. Mutually exclusive with connectionId."
+  ),
   /** @deprecated Use connectionId instead */
   authenticationId: ConnectionIdPropertySchema.nullable().optional(),
   inputs: InputsPropertySchema.optional().describe(
@@ -3643,6 +3754,7 @@ async function executeAction(actionOptions) {
     actionKey,
     actionType,
     executionOptions,
+    cursor,
     connectionId,
     timeoutMs
   } = actionOptions;
@@ -3656,6 +3768,9 @@ async function executeAction(actionOptions) {
   if (connectionId !== null && connectionId !== void 0) {
     runRequestData.authentication_id = connectionId;
   }
+  if (cursor) {
+    runRequestData.page = cursor;
+  }
   const runRequest = {
     data: runRequestData
   };
@@ -3675,19 +3790,52 @@ async function executeAction(actionOptions) {
     resultExtractor: (result) => result.data
   });
 }
+var CONTEXT_CACHE_TTL_MS = 6e4;
+var CONTEXT_CACHE_MAX_SIZE = 500;
 var runActionPlugin = ({ sdk, context }) => {
-  async function runActionPage(options) {
-    const { api } = context;
-    const {
-      appKey,
-      actionKey,
-      actionType,
-      connectionId,
-      authenticationId,
-      inputs = {},
-      timeoutMs
-    } = options;
-    const resolvedConnectionId = connectionId ?? authenticationId;
+  const runActionContextCache = /* @__PURE__ */ new Map();
+  function evictIfNeeded() {
+    if (runActionContextCache.size < CONTEXT_CACHE_MAX_SIZE) return;
+    const now = Date.now();
+    let oldestKey;
+    let oldestExpiry = Infinity;
+    let evictedAny = false;
+    for (const [key, entry] of runActionContextCache) {
+      if (now >= entry.expiresAt) {
+        runActionContextCache.delete(key);
+        evictedAny = true;
+      } else if (entry.expiresAt < oldestExpiry) {
+        oldestExpiry = entry.expiresAt;
+        oldestKey = key;
+      }
+    }
+    if (!evictedAny && oldestKey) {
+      runActionContextCache.delete(oldestKey);
+    }
+  }
+  function getRunActionContext(options) {
+    const { appKey, actionKey, actionType } = options;
+    const contextKey = `${appKey}:${actionKey}:${actionType}`;
+    const cached = runActionContextCache.get(contextKey);
+    if (cached && Date.now() < cached.expiresAt) {
+      return cached.promise;
+    }
+    const pendingContext = resolveRunActionContext(options).catch((error) => {
+      const current = runActionContextCache.get(contextKey);
+      if (current?.promise === pendingContext) {
+        runActionContextCache.delete(contextKey);
+      }
+      throw error;
+    });
+    evictIfNeeded();
+    runActionContextCache.set(contextKey, {
+      promise: pendingContext,
+      expiresAt: Date.now() + CONTEXT_CACHE_TTL_MS
+    });
+    return pendingContext;
+  }
+  async function resolveRunActionContext(options) {
+    const { appKey, actionKey, actionType } = options;
     const selectedApi = await context.getVersionedImplementationId(appKey);
     if (!selectedApi) {
       throw new ZapierConfigurationError(
@@ -3695,11 +3843,6 @@ var runActionPlugin = ({ sdk, context }) => {
         { configType: "current_implementation_id" }
       );
     }
-    setMethodMetadata({
-      selectedApi,
-      operationType: actionType,
-      operationKey: actionKey
-    });
     const actionData = await sdk.getAction({
       appKey,
       actionKey,
@@ -3710,7 +3853,33 @@ var runActionPlugin = ({ sdk, context }) => {
         `Action type mismatch: expected ${actionType}, got ${actionData.data.action_type}`
       );
     }
-    const actionId = actionData.data.id;
+    return { selectedApi, actionId: actionData.data.id };
+  }
+  async function runActionPage(options) {
+    const { api } = context;
+    const {
+      appKey,
+      actionKey,
+      actionType,
+      connectionId,
+      connection,
+      authenticationId,
+      inputs = {},
+      cursor,
+      timeoutMs
+    } = options;
+    const resolvedConnectionId = await resolveConnectionId({
+      connectionId,
+      connection,
+      authenticationId,
+      resolveConnection: context.resolveConnection
+    });
+    const { selectedApi, actionId } = await getRunActionContext(options);
+    setMethodMetadata({
+      selectedApi,
+      operationType: actionType,
+      operationKey: actionKey
+    });
     const result = await executeAction({
       api,
       selectedApi,
@@ -3720,6 +3889,7 @@ var runActionPlugin = ({ sdk, context }) => {
       actionKey,
       actionType,
       executionOptions: { inputs },
+      cursor,
       connectionId: resolvedConnectionId,
       timeoutMs
     });
@@ -3734,8 +3904,7 @@ var runActionPlugin = ({ sdk, context }) => {
     }
     return {
       data: result.results || [],
-      nextCursor: void 0
-      // No pagination implemented yet
+      nextCursor: result.next_page
     };
   }
   const methodName = stripPageSuffix(runActionPage.name);
@@ -3900,6 +4069,12 @@ async function readFile(filePath) {
   }
   throw new Error(`File not found: ${filePath}`);
 }
+var ConnectionEntrySchema = z.object({
+  connectionId: z.number().int().positive().describe("Zapier connection ID for the third-party service.")
+});
+var ConnectionsMapSchema = z.record(z.string(), ConnectionEntrySchema);
+
+// src/plugins/manifest/schemas.ts
 var DEFAULT_CONFIG_PATH = ".zapierrc";
 var ActionEntrySchema = z.object({
   appKey: z.string().describe("App key (slug or implementation name)"),
@@ -3923,18 +4098,17 @@ var ManifestSchema = z.object({
       ),
       version: z.string().describe("Version string (e.g., '1.21.1')")
     })
-  ),
-  actions: z.record(z.string(), ActionEntrySchema).optional().describe("Saved action configurations with their schemas")
-}).describe("Manifest for app version locking and action configurations");
+  ).optional(),
+  actions: z.record(z.string(), ActionEntrySchema).optional().describe("Saved action configurations with their schemas"),
+  connections: ConnectionsMapSchema.optional().describe(
+    "Named connections map. Keys are connection names, values contain a connectionId."
+  )
+}).describe(
+  "Manifest for app version locking, action configurations, and named connections"
+);
 z.object({
   manifestPath: z.string().optional().describe("Path to manifest file"),
-  manifest: z.record(
-    z.string(),
-    z.object({
-      implementationName: z.string(),
-      version: z.string().optional()
-    })
-  ).optional().describe("Direct manifest object")
+  manifest: ManifestSchema.optional().describe("Direct manifest object")
 });
 
 // src/utils/array-utils.ts
@@ -3950,13 +4124,14 @@ async function toArrayFromAsync(asyncIterable) {
 function parseManifestContent(content, source) {
   try {
     const parsed = JSON.parse(content);
-    if (parsed?.apps && typeof parsed?.apps === "object") {
-      const result = ManifestSchema.safeParse(parsed);
-      if (result.success) {
-        return result.data;
-      }
-      console.warn(`\u26A0\uFE0F Invalid manifest format in ${source}: ${result.error}`);
+    if (parsed == null || typeof parsed !== "object") {
+      return null;
     }
+    const result = ManifestSchema.safeParse(parsed);
+    if (result.success) {
+      return result.data;
+    }
+    console.warn(`\u26A0\uFE0F Invalid manifest format in ${source}: ${result.error}`);
     return null;
   } catch (error) {
     console.warn(`\u26A0\uFE0F Failed to parse manifest from ${source}:`, error);
@@ -4033,6 +4208,9 @@ function findManifestEntry({
   appKey,
   manifest
 }) {
+  if (!manifest.apps) {
+    return null;
+  }
   const [appKeyWithoutVersion] = splitVersionedKey(appKey);
   if (manifest.apps[appKeyWithoutVersion]) {
     return [appKeyWithoutVersion, manifest.apps[appKeyWithoutVersion]];
@@ -4290,7 +4468,11 @@ var manifestPlugin = (params) => {
       deleteActionEntry,
       hasActionEntry,
       findManifestEntry,
-      readManifestFromFile
+      readManifestFromFile,
+      getManifestConnections: async () => {
+        const manifest2 = await getResolvedManifest();
+        return manifest2?.connections ?? null;
+      }
     }
   };
 };
@@ -5653,6 +5835,29 @@ async function batch(tasks, options = {}) {
   await Promise.all(workers);
   return results;
 }
+
+// src/plugins/connections/index.ts
+var connectionsPlugin = (params) => {
+  const { context } = params;
+  let cachedMap;
+  async function loadConnectionsMap() {
+    if (cachedMap === void 0) {
+      cachedMap = await context.getManifestConnections() ?? null;
+    }
+    return cachedMap;
+  }
+  return {
+    context: {
+      resolveConnection: async (name) => {
+        const map = await loadConnectionsMap();
+        return map?.[name];
+      },
+      getConnectionsMap: async () => {
+        return loadConnectionsMap();
+      }
+    }
+  };
+};
 var TableApiItemSchema = z.object({
   id: z.string(),
   name: z.string(),
@@ -5710,9 +5915,10 @@ function extractNextCursor(links) {
 var listTablesPlugin = ({ context }) => {
   async function listTablesPage(options) {
     const { api } = context;
-    const searchParams = {
-      limit: options.pageSize.toString()
-    };
+    const searchParams = {};
+    if (options.pageSize !== void 0) {
+      searchParams.limit = options.pageSize.toString();
+    }
     if (options?.tableIds && options.tableIds.length > 0) {
       searchParams.ids = options.tableIds.join(",");
     }
@@ -5765,7 +5971,8 @@ var listTablesPlugin = ({ context }) => {
     listTablesPage,
     ListTablesOptionsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listTables: listTablesDefinition,
@@ -6379,9 +6586,10 @@ var listTableRecordsPlugin = ({ context }) => {
       tableId: options.tableId,
       keyMode: options.keyMode
     });
-    const body = {
-      limit: options.pageSize
-    };
+    const body = {};
+    if (options.pageSize !== void 0) {
+      body.limit = options.pageSize;
+    }
     if (options.filters) {
       body.filters = options.filters.map((f) => ({
         key: translator.translateFieldKey(f.fieldKey),
@@ -6444,7 +6652,8 @@ var listTableRecordsPlugin = ({ context }) => {
     listTableRecordsPage,
     ListTableRecordsOptionsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listTableRecords: listTableRecordsDefinition,
@@ -7144,7 +7353,8 @@ var listInputFieldChoicesPlugin = ({ context, sdk }) => {
     listInputFieldChoicesPage,
     ListInputFieldChoicesSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listInputFieldChoices: listInputFieldChoicesDefinition,
@@ -7329,7 +7539,7 @@ function getCpuTime() {
 }
 
 // src/plugins/eventEmission/builders.ts
-var SDK_VERSION = "0.35.0";
+var SDK_VERSION = "0.37.0";
 function createBaseEvent(context = {}) {
   return {
     event_id: generateEventId(),
@@ -7822,7 +8032,7 @@ 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(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(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);
+  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).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(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);
 }
 function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
@@ -7856,4 +8066,4 @@ var BaseSdkOptionsSchema = z.object({
   // Use credentials instead
 });
 
-export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, ClientCredentialsObjectSchema, ConnectionIdPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, 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, updateTableRecordsPlugin };
+export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DEFAULT_PAGE_SIZE, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, 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, updateTableRecordsPlugin };