@zapier/zapier-sdk 0.101.0 → 0.101.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.101.2
+
+### Patch Changes
+
+- 6bfea6d: Clarified that `pageSize` on `listConnections`, `listAuthentications`, and `listApps` may be capped by the upstream API — values above its limit are rejected rather than forwarded unbounded.
+
+## 0.101.1
+
+### Patch Changes
+
+- e0fcb04: `sdk.apps` now runs actions for apps that do not require a connection without rejecting the call before execution.
+
 ## 0.101.0
 
 ### Minor Changes

package/README.md

@@ -1021,14 +1021,14 @@ List all available apps with optional filtering
 
 **Parameters:**
 
-| Name           | Type     | Required | Default | Possible Values | Description                                                         |
-| -------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------- |
-| `options`      | `object` | ✅       | —       | —               |                                                                     |
-| ​ ↳ `search`   | `string` | ❌       | —       | —               | Search term to filter apps by name                                  |
-| ​ ↳ `pageSize` | `number` | ❌       | —       | —               | Number of apps per page                                             |
-| ​ ↳ `apps`     | `array`  | ❌       | —       | —               | Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github') |
-| ​ ↳ `maxItems` | `number` | ❌       | —       | —               | Maximum total items to return across all pages                      |
-| ​ ↳ `cursor`   | `string` | ❌       | —       | —               | Cursor to start from                                                |
+| Name           | Type     | Required | Default | Possible Values | Description                                                                               |
+| -------------- | -------- | -------- | ------- | --------------- | ----------------------------------------------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —               |                                                                                           |
+| ​ ↳ `search`   | `string` | ❌       | —       | —               | Search term to filter apps by name                                                        |
+| ​ ↳ `pageSize` | `number` | ❌       | —       | —               | Number of apps per page. The upstream API may cap this and reject values above its limit. |
+| ​ ↳ `apps`     | `array`  | ❌       | —       | —               | Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github')                       |
+| ​ ↳ `maxItems` | `number` | ❌       | —       | —               | Maximum total items to return across all pages                                            |
+| ​ ↳ `cursor`   | `string` | ❌       | —       | —               | Cursor to start from                                                                      |
 
 **Returns:** `Promise<PaginatedResult<AppItem>>`
 
@@ -2592,7 +2592,7 @@ List available connections with optional filtering
 | ​ ↳ `account`       | `string`  | ❌       | —       | —                          | Account to filter by                                                                                                                                |
 | ​ ↳ `includeShared` | `boolean` | ❌       | —       | —                          | Include connections shared with you. By default, only your own connections are returned (owner=me). Set to true to also include shared connections. |
 | ​ ↳ `status`        | `string`  | ❌       | —       | `active`, `expired`, `all` | Filter connections by expiry: 'active' (default) returns only non-expired connections, 'expired' only expired ones, and 'all' returns both.         |
-| ​ ↳ `pageSize`      | `number`  | ❌       | —       | —                          | Number of connections per page                                                                                                                      |
+| ​ ↳ `pageSize`      | `number`  | ❌       | —       | —                          | Number of connections per page. The upstream API may cap this and reject values above its limit.                                                    |
 | ​ ↳ `maxItems`      | `number`  | ❌       | —       | —                          | Maximum total items to return across all pages                                                                                                      |
 | ​ ↳ `cursor`        | `string`  | ❌       | —       | —                          | Cursor to start from                                                                                                                                |
 

package/dist/{chunk-R6U6HNVF.mjs → chunk-6VGEVTLJ.mjs}

@@ -6901,7 +6901,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.101.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.101.2" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -11343,8 +11343,7 @@ function resolveProxyConnection({
   providedConnection,
   providedAuthenticationId,
   pinnedAuthId,
-  pinnedConnection,
-  errorContext
+  pinnedConnection
 }) {
   const hasDirectId = providedConnectionId != null || providedAuthenticationId != null;
   if (hasDirectId && providedConnection != null) {
@@ -11362,9 +11361,6 @@ function resolveProxyConnection({
     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, imports, pinnedAuthId, pinnedConnection) {
@@ -11382,8 +11378,7 @@ function createActionFunction(appKey, actionType, actionKey, imports, pinnedAuth
       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.`
+      pinnedConnection
     });
     return imports.runAction({
       app: appKey,
@@ -11404,9 +11399,13 @@ function createActionTypeProxy(appKey, actionType, imports, pinnedAuthId, pinned
         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.`
+        pinnedConnection
       });
+      if (connectionId == null && connection == null) {
+        throw new ZapierValidationError(
+          `Connection is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId/connection in the fetch call.`
+        );
+      }
       return imports.fetch(url, {
         ...init,
         connection: connectionId ?? connection
@@ -11460,11 +11459,6 @@ function createAppProxy(appKey, imports) {
         "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 is required. Use sdk.apps.${appKey}({ connectionId: "..." }) or sdk.apps.${appKey}({ connection: "name" })`
-      );
-    }
     return createPinnedAppProxy(
       appKey,
       imports,
@@ -11545,7 +11539,9 @@ var ListAppsSchema = ListAppsQuerySchema.omit({
     "Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github')"
   ).meta({ deprecated: true }),
   // Override pageSize to make optional (base has default value)
-  pageSize: z.number().min(1).optional().describe("Number of apps per page"),
+  pageSize: z.number().min(1).optional().describe(
+    "Number of apps per page. The upstream API may cap this and reject values above its limit."
+  ),
   // SDK specific property for pagination/iterable helpers
   maxItems: z.number().min(1).optional().describe("Maximum total items to return across all pages"),
   // SDK specific property for pagination/iterable helpers
@@ -12334,7 +12330,9 @@ var ListConnectionsQuerySchema = ListConnectionsQuerySchema$1.omit({
     deprecationMessage: "Use --status expired instead to show only expired connections, or --status all for both."
   }),
   // Override pageSize to make optional
-  pageSize: z.number().min(1).optional().describe("Number of connections per page"),
+  pageSize: z.number().min(1).optional().describe(
+    "Number of connections per page. The upstream API may cap this and reject values above its limit."
+  ),
   // SDK specific property for pagination/iterable helpers
   maxItems: z.number().min(1).optional().describe("Maximum total items to return across all pages"),
   // SDK specific property for pagination/iterable helpers

package/dist/{chunk-EOGYMKVF.cjs → chunk-ID4JBWNX.cjs}

@@ -6903,7 +6903,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.101.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.101.2" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -11345,8 +11345,7 @@ function resolveProxyConnection({
   providedConnection,
   providedAuthenticationId,
   pinnedAuthId,
-  pinnedConnection,
-  errorContext
+  pinnedConnection
 }) {
   const hasDirectId = providedConnectionId != null || providedAuthenticationId != null;
   if (hasDirectId && providedConnection != null) {
@@ -11364,9 +11363,6 @@ function resolveProxyConnection({
     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, imports, pinnedAuthId, pinnedConnection) {
@@ -11384,8 +11380,7 @@ function createActionFunction(appKey, actionType, actionKey, imports, pinnedAuth
       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.`
+      pinnedConnection
     });
     return imports.runAction({
       app: appKey,
@@ -11406,9 +11401,13 @@ function createActionTypeProxy(appKey, actionType, imports, pinnedAuthId, pinned
         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.`
+        pinnedConnection
       });
+      if (connectionId == null && connection == null) {
+        throw new ZapierValidationError(
+          `Connection is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId/connection in the fetch call.`
+        );
+      }
       return imports.fetch(url, {
         ...init,
         connection: connectionId ?? connection
@@ -11462,11 +11461,6 @@ function createAppProxy(appKey, imports) {
         "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 is required. Use sdk.apps.${appKey}({ connectionId: "..." }) or sdk.apps.${appKey}({ connection: "name" })`
-      );
-    }
     return createPinnedAppProxy(
       appKey,
       imports,
@@ -11547,7 +11541,9 @@ var ListAppsSchema = apps.ListAppsQuerySchema.omit({
     "Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github')"
   ).meta({ deprecated: true }),
   // Override pageSize to make optional (base has default value)
-  pageSize: zod.z.number().min(1).optional().describe("Number of apps per page"),
+  pageSize: zod.z.number().min(1).optional().describe(
+    "Number of apps per page. The upstream API may cap this and reject values above its limit."
+  ),
   // SDK specific property for pagination/iterable helpers
   maxItems: zod.z.number().min(1).optional().describe("Maximum total items to return across all pages"),
   // SDK specific property for pagination/iterable helpers
@@ -12336,7 +12332,9 @@ var ListConnectionsQuerySchema = connections.ListConnectionsQuerySchema.omit({
     deprecationMessage: "Use --status expired instead to show only expired connections, or --status all for both."
   }),
   // Override pageSize to make optional
-  pageSize: zod.z.number().min(1).optional().describe("Number of connections per page"),
+  pageSize: zod.z.number().min(1).optional().describe(
+    "Number of connections per page. The upstream API may cap this and reject values above its limit."
+  ),
   // SDK specific property for pagination/iterable helpers
   maxItems: zod.z.number().min(1).optional().describe("Maximum total items to return across all pages"),
   // SDK specific property for pagination/iterable helpers