@zapier/zapier-sdk 0.35.0 → 0.37.0

package/dist/index.cjs

@@ -64,6 +64,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];
@@ -97,6 +98,9 @@ var ActionTypePropertySchema = zod.z.enum([
 var ActionKeyPropertySchema = zod.z.string().min(1).describe("Action key to execute");
 var ConnectionIdPropertySchema = zod.z.union([zod.z.string(), zod.z.number().int().positive()]).describe("Connection ID to use for this action");
 var AuthenticationIdPropertySchema = ConnectionIdPropertySchema;
+var ConnectionPropertySchema = zod.z.union([zod.z.string(), zod.z.number().int().positive()]).describe(
+  "Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly."
+);
 var InputsPropertySchema = zod.z.record(zod.z.string(), zod.z.unknown()).describe("Input parameters for the action");
 var LimitPropertySchema = zod.z.number().int().min(1).max(MAX_PAGE_LIMIT).default(50).describe("Maximum number of items to return");
 var OffsetPropertySchema = zod.z.number().int().min(0).default(0).describe("Number of items to skip for pagination");
@@ -271,6 +275,7 @@ HTTP Status: ${error.statusCode}`;
 var ActionExecutionInputSchema = zod.z.object({
   inputs: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional(),
   timeoutMs: ActionTimeoutMsPropertySchema
@@ -279,9 +284,10 @@ var ActionExecutionInputSchema = zod.z.object({
 );
 var AppFactoryInputSchema = zod.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];
@@ -309,44 +315,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
       });
     };
   }
@@ -360,7 +402,8 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
             actionType,
             actionKey,
             options,
-            pinnedAuthId
+            pinnedAuthId,
+            pinnedConnection
           );
         }
         return void 0;
@@ -368,7 +411,7 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
     }
   );
 }
-function createPinnedAppProxy(appKey, options, pinnedAuthId) {
+function createPinnedAppProxy(appKey, options, pinnedAuthId, pinnedConnection) {
   return new Proxy(
     {},
     {
@@ -378,7 +421,8 @@ function createPinnedAppProxy(appKey, options, pinnedAuthId) {
             appKey,
             actionType,
             options,
-            pinnedAuthId
+            pinnedAuthId,
+            pinnedConnection
           );
         }
         return void 0;
@@ -389,12 +433,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) {
@@ -457,6 +512,7 @@ var FetchInitSchema = zod.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: zod.z.string().optional().describe("URL to send async response to (makes request async)")
@@ -464,6 +520,119 @@ var FetchInitSchema = zod.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 === "") {
@@ -558,8 +727,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
@@ -1044,7 +1225,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;
@@ -1058,7 +1239,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
@@ -1232,7 +1413,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 }
       }
     });
@@ -1242,7 +1425,8 @@ var listAppsPlugin = ({ context }) => {
     listAppsPage,
     ListAppsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listApps: listAppsDefinition,
@@ -1259,88 +1443,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 = zod.z.object({
   appKey: AppKeyPropertySchema.describe(
     "App key of actions to list (e.g., 'SlackCLIAPI' or slug like 'github')"
@@ -2623,7 +2725,8 @@ var listActionsPlugin = ({ context }) => {
     listActionsPage,
     ListActionsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listActions: listActionsDefinition,
@@ -2980,7 +3083,8 @@ var listInputFieldsPlugin = ({ sdk, context }) => {
     listInputFieldsPage,
     ListInputFieldsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listInputFields: listInputFieldsDefinition,
@@ -3066,9 +3170,10 @@ var ConnectionItemSchema = withFormatter(connections.ConnectionItemSchema, {
 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
@@ -3132,7 +3237,8 @@ var listConnectionsPlugin = ({ context }) => {
     listConnectionsPage,
     ListConnectionsQuerySchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listConnections: listConnectionsDefinition,
@@ -3210,9 +3316,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;
     }
@@ -3246,7 +3353,8 @@ var listClientCredentialsPlugin = ({ context }) => {
     listClientCredentialsPage,
     ListClientCredentialsQuerySchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listClientCredentials: listClientCredentialsDefinition,
@@ -3645,6 +3753,9 @@ var RunActionSchema = zod.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(
@@ -3665,6 +3776,7 @@ async function executeAction(actionOptions) {
     actionKey,
     actionType,
     executionOptions,
+    cursor,
     connectionId,
     timeoutMs
   } = actionOptions;
@@ -3678,6 +3790,9 @@ async function executeAction(actionOptions) {
   if (connectionId !== null && connectionId !== void 0) {
     runRequestData.authentication_id = connectionId;
   }
+  if (cursor) {
+    runRequestData.page = cursor;
+  }
   const runRequest = {
     data: runRequestData
   };
@@ -3697,19 +3812,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(
@@ -3717,11 +3865,6 @@ var runActionPlugin = ({ sdk, context }) => {
         { configType: "current_implementation_id" }
       );
     }
-    setMethodMetadata({
-      selectedApi,
-      operationType: actionType,
-      operationKey: actionKey
-    });
     const actionData = await sdk.getAction({
       appKey,
       actionKey,
@@ -3732,7 +3875,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,
@@ -3742,6 +3911,7 @@ var runActionPlugin = ({ sdk, context }) => {
       actionKey,
       actionType,
       executionOptions: { inputs },
+      cursor,
       connectionId: resolvedConnectionId,
       timeoutMs
     });
@@ -3756,8 +3926,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);
@@ -3922,6 +4091,12 @@ async function readFile(filePath) {
   }
   throw new Error(`File not found: ${filePath}`);
 }
+var ConnectionEntrySchema = zod.z.object({
+  connectionId: zod.z.number().int().positive().describe("Zapier connection ID for the third-party service.")
+});
+var ConnectionsMapSchema = zod.z.record(zod.z.string(), ConnectionEntrySchema);
+
+// src/plugins/manifest/schemas.ts
 var DEFAULT_CONFIG_PATH = ".zapierrc";
 var ActionEntrySchema = zod.z.object({
   appKey: zod.z.string().describe("App key (slug or implementation name)"),
@@ -3945,18 +4120,17 @@ var ManifestSchema = zod.z.object({
       ),
       version: zod.z.string().describe("Version string (e.g., '1.21.1')")
     })
-  ),
-  actions: zod.z.record(zod.z.string(), ActionEntrySchema).optional().describe("Saved action configurations with their schemas")
-}).describe("Manifest for app version locking and action configurations");
+  ).optional(),
+  actions: zod.z.record(zod.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"
+);
 zod.z.object({
   manifestPath: zod.z.string().optional().describe("Path to manifest file"),
-  manifest: zod.z.record(
-    zod.z.string(),
-    zod.z.object({
-      implementationName: zod.z.string(),
-      version: zod.z.string().optional()
-    })
-  ).optional().describe("Direct manifest object")
+  manifest: ManifestSchema.optional().describe("Direct manifest object")
 });
 
 // src/utils/array-utils.ts
@@ -3972,13 +4146,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);
@@ -4055,6 +4230,9 @@ function findManifestEntry({
   appKey,
   manifest
 }) {
+  if (!manifest.apps) {
+    return null;
+  }
   const [appKeyWithoutVersion] = splitVersionedKey(appKey);
   if (manifest.apps[appKeyWithoutVersion]) {
     return [appKeyWithoutVersion, manifest.apps[appKeyWithoutVersion]];
@@ -4312,7 +4490,11 @@ var manifestPlugin = (params) => {
       deleteActionEntry,
       hasActionEntry,
       findManifestEntry,
-      readManifestFromFile
+      readManifestFromFile,
+      getManifestConnections: async () => {
+        const manifest2 = await getResolvedManifest();
+        return manifest2?.connections ?? null;
+      }
     }
   };
 };
@@ -5675,6 +5857,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 = zod.z.object({
   id: zod.z.string(),
   name: zod.z.string(),
@@ -5732,9 +5937,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(",");
     }
@@ -5787,7 +5993,8 @@ var listTablesPlugin = ({ context }) => {
     listTablesPage,
     ListTablesOptionsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listTables: listTablesDefinition,
@@ -6401,9 +6608,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),
@@ -6466,7 +6674,8 @@ var listTableRecordsPlugin = ({ context }) => {
     listTableRecordsPage,
     ListTableRecordsOptionsSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listTableRecords: listTableRecordsDefinition,
@@ -7166,7 +7375,8 @@ var listInputFieldChoicesPlugin = ({ context, sdk }) => {
     listInputFieldChoicesPage,
     ListInputFieldChoicesSchema,
     createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
-    methodName
+    methodName,
+    DEFAULT_PAGE_SIZE
   );
   return {
     listInputFieldChoices: listInputFieldChoicesDefinition,
@@ -7351,7 +7561,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(),
@@ -7844,7 +8054,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);
@@ -7884,13 +8094,19 @@ exports.ActionTypePropertySchema = ActionTypePropertySchema;
 exports.AppKeyPropertySchema = AppKeyPropertySchema;
 exports.AuthenticationIdPropertySchema = AuthenticationIdPropertySchema;
 exports.BaseSdkOptionsSchema = BaseSdkOptionsSchema;
+exports.CONTEXT_CACHE_MAX_SIZE = CONTEXT_CACHE_MAX_SIZE;
+exports.CONTEXT_CACHE_TTL_MS = CONTEXT_CACHE_TTL_MS;
 exports.ClientCredentialsObjectSchema = ClientCredentialsObjectSchema;
+exports.ConnectionEntrySchema = ConnectionEntrySchema;
 exports.ConnectionIdPropertySchema = ConnectionIdPropertySchema;
+exports.ConnectionPropertySchema = ConnectionPropertySchema;
+exports.ConnectionsMapSchema = ConnectionsMapSchema;
 exports.CredentialsFunctionSchema = CredentialsFunctionSchema;
 exports.CredentialsObjectSchema = CredentialsObjectSchema;
 exports.CredentialsSchema = CredentialsSchema;
 exports.DEFAULT_ACTION_TIMEOUT_MS = DEFAULT_ACTION_TIMEOUT_MS;
 exports.DEFAULT_CONFIG_PATH = DEFAULT_CONFIG_PATH;
+exports.DEFAULT_PAGE_SIZE = DEFAULT_PAGE_SIZE;
 exports.DebugPropertySchema = DebugPropertySchema;
 exports.InputsPropertySchema = InputsPropertySchema;
 exports.LimitPropertySchema = LimitPropertySchema;
@@ -7936,6 +8152,7 @@ exports.clientCredentialsNameResolver = clientCredentialsNameResolver;
 exports.clientIdResolver = clientIdResolver;
 exports.connectionIdGenericResolver = connectionIdGenericResolver;
 exports.connectionIdResolver = connectionIdResolver;
+exports.connectionsPlugin = connectionsPlugin;
 exports.createBaseEvent = createBaseEvent;
 exports.createClientCredentialsPlugin = createClientCredentialsPlugin;
 exports.createFunction = createFunction;