@zapier/zapier-sdk 0.13.8 → 0.14.0

package/dist/plugins/listInputFieldChoices/index.test.js

@@ -41,17 +41,73 @@ const mockExternalChoicesResponse = {
         prev: null,
     },
 };
+// Mock needs data for static choices
+const mockNeedsWithStaticChoices = [
+    {
+        key: "priority",
+        label: "Priority",
+        help_text: "Select priority",
+        required: true,
+        type: "string",
+        choices: [
+            {
+                key: "high",
+                sample: "high",
+                label: "High Priority",
+                value: "high",
+            },
+            {
+                key: "medium",
+                sample: "medium",
+                label: "Medium Priority",
+                value: "medium",
+            },
+        ],
+    },
+];
+const mockNeedsWithoutChoices = [
+    {
+        key: "channel",
+        label: "Channel",
+        help_text: "Select a channel",
+        required: true,
+        type: "string",
+        choices: [], // Empty choices
+    },
+];
+const mockNeedsResponse = {
+    success: true,
+    needs: mockNeedsWithoutChoices,
+};
+const mockNeedsResponseWithStaticChoices = {
+    success: true,
+    needs: mockNeedsWithStaticChoices,
+};
 describe("listInputFieldChoices plugin", () => {
     let mockApiClient;
     let mockGetAction;
+    let mockGetVersionedImplementationId;
     beforeEach(() => {
         vi.clearAllMocks();
+        // Mock api.post to handle both endpoints
+        const mockPost = vi.fn().mockImplementation((path) => {
+            if (path === "/api/v4/implementations/needs/") {
+                return Promise.resolve(mockNeedsResponse);
+            }
+            else if (path === "/api/v4/implementations/choices/") {
+                return Promise.resolve(mockChoicesResponse);
+            }
+            return Promise.reject(new Error(`Unexpected endpoint: ${path}`));
+        });
         mockApiClient = {
-            post: vi.fn().mockResolvedValue(mockChoicesResponse),
+            post: mockPost,
         };
         mockGetAction = vi.fn().mockResolvedValue({
             data: { id: "core:123", key: "send_message", action_type: "read" },
         });
+        mockGetVersionedImplementationId = vi
+            .fn()
+            .mockResolvedValue("SlackCLIAPI@1.21.1");
     });
     function createTestSdk() {
         // Create a mock getAction plugin
@@ -66,7 +122,11 @@ describe("listInputFieldChoices plugin", () => {
             },
         });
         // Build SDK with proper plugin composition
-        return createSdk({}, {}, { api: mockApiClient, meta: {} })
+        return createSdk({}, {}, {
+            api: mockApiClient,
+            meta: {},
+            getVersionedImplementationId: mockGetVersionedImplementationId,
+        })
             .addPlugin(mockGetActionPlugin)
             .addPlugin(listInputFieldChoicesPlugin);
     }
@@ -155,6 +215,122 @@ describe("listInputFieldChoices plugin", () => {
             }
         });
     });
+    describe("static choices from needs endpoint", () => {
+        it("should return static choices when field has them", async () => {
+            // Mock api.post to return needs with static choices
+            const mockPost = vi.fn().mockImplementation((path) => {
+                if (path === "/api/v4/implementations/needs/") {
+                    return Promise.resolve(mockNeedsResponseWithStaticChoices);
+                }
+                else if (path === "/api/v4/implementations/choices/") {
+                    return Promise.resolve(mockChoicesResponse);
+                }
+                return Promise.reject(new Error(`Unexpected endpoint: ${path}`));
+            });
+            mockApiClient.post = mockPost;
+            const sdk = createTestSdk();
+            const result = await sdk.listInputFieldChoices({
+                appKey: "slack",
+                actionType: "read",
+                actionKey: "send_message",
+                inputFieldKey: "priority",
+            });
+            // Should return static choices
+            expect(result.data).toHaveLength(2);
+            expect(result.data[0]).toEqual({
+                key: "high",
+                label: "High Priority",
+                sample: "high",
+                value: "high",
+            });
+            expect(result.data[1]).toEqual({
+                key: "medium",
+                label: "Medium Priority",
+                sample: "medium",
+                value: "medium",
+            });
+            // Should have called needs endpoint to check for static choices
+            expect(mockApiClient.post).toHaveBeenCalledWith("/api/v4/implementations/needs/", {
+                selected_api: "SlackCLIAPI@1.21.1",
+                action: "send_message",
+                type_of: "read",
+                params: {},
+            });
+            // Should not call choices endpoint since static choices were found
+            expect(mockApiClient.post).not.toHaveBeenCalledWith("/api/v4/implementations/choices/", expect.anything());
+        });
+        it("should fall back to dynamic choices when field has empty choices array", async () => {
+            // Mock api.post - needs endpoint returns field with empty choices
+            const mockPost = vi.fn().mockImplementation((path) => {
+                if (path === "/api/v4/implementations/needs/") {
+                    return Promise.resolve(mockNeedsResponse); // Has empty choices
+                }
+                else if (path === "/api/v4/implementations/choices/") {
+                    return Promise.resolve(mockChoicesResponse);
+                }
+                return Promise.reject(new Error(`Unexpected endpoint: ${path}`));
+            });
+            mockApiClient.post = mockPost;
+            const sdk = createTestSdk();
+            const result = await sdk.listInputFieldChoices({
+                appKey: "slack",
+                actionType: "read",
+                actionKey: "send_message",
+                inputFieldKey: "channel",
+            });
+            // Should first call needs endpoint
+            expect(mockApiClient.post).toHaveBeenCalledWith("/api/v4/implementations/needs/", {
+                selected_api: "SlackCLIAPI@1.21.1",
+                action: "send_message",
+                type_of: "read",
+                params: {},
+            });
+            // Should then call choices endpoint for dynamic choices
+            expect(mockApiClient.post).toHaveBeenCalledWith("/api/v4/implementations/choices/", expect.objectContaining({
+                action_id: "core:123",
+                input_field_id: "channel",
+            }));
+            // Should return dynamic choices
+            expect(result.data).toHaveLength(3);
+        });
+        it("should fall back to dynamic choices when field is not found", async () => {
+            // Mock api.post - needs endpoint returns different field
+            const mockNeedsWithOtherField = {
+                success: true,
+                needs: [
+                    {
+                        key: "other_field",
+                        label: "Other Field",
+                        help_text: "Some other field",
+                        required: false,
+                        type: "string",
+                        choices: [],
+                    },
+                ],
+            };
+            const mockPost = vi.fn().mockImplementation((path) => {
+                if (path === "/api/v4/implementations/needs/") {
+                    return Promise.resolve(mockNeedsWithOtherField);
+                }
+                else if (path === "/api/v4/implementations/choices/") {
+                    return Promise.resolve(mockChoicesResponse);
+                }
+                return Promise.reject(new Error(`Unexpected endpoint: ${path}`));
+            });
+            mockApiClient.post = mockPost;
+            const sdk = createTestSdk();
+            await sdk.listInputFieldChoices({
+                appKey: "slack",
+                actionType: "read",
+                actionKey: "send_message",
+                inputFieldKey: "channel",
+            });
+            // Should call needs endpoint first
+            expect(mockApiClient.post).toHaveBeenCalledWith("/api/v4/implementations/needs/", expect.anything());
+            // Should call choices endpoint since field was not found in needs
+            expect(mockApiClient.post).toHaveBeenCalledWith("/api/v4/implementations/choices/", expect.anything());
+        });
+    });
     describe("API integration - action method", () => {
         it("should call the correct API endpoint with action method", async () => {
             const sdk = createTestSdk();
@@ -439,12 +615,13 @@ describe("listInputFieldChoices plugin", () => {
                 actionKey: "send_message",
                 inputFieldKey: "invalid_field",
             })).rejects.toThrow(ZapierApiError);
+            // Error comes from needs endpoint (first call) with user-friendly message
             await expect(sdk.listInputFieldChoices({
                 appKey: "slack",
                 actionType: "read",
                 actionKey: "send_message",
                 inputFieldKey: "invalid_field",
-            })).rejects.toThrow("Failed to get input field choices: Invalid field, Missing authentication");
+            })).rejects.toThrow("Failed to get input fields: Invalid field, Missing authentication");
         });
         it("should handle API errors gracefully", async () => {
             mockApiClient.post = vi
@@ -497,7 +674,7 @@ describe("listInputFieldChoices plugin", () => {
                 actionType: "read",
                 actionKey: "send_message",
                 inputFieldKey: "channel",
-            })).rejects.toThrow("Failed to get input field choices: Unknown error");
+            })).rejects.toThrow("Failed to get input fields: Unknown error");
         });
         it("should handle API response with errors but no error messages", async () => {
             mockApiClient.post = vi.fn().mockResolvedValue({
@@ -510,7 +687,7 @@ describe("listInputFieldChoices plugin", () => {
                 actionType: "read",
                 actionKey: "send_message",
                 inputFieldKey: "channel",
-            })).rejects.toThrow("Failed to get input field choices: Unknown error");
+            })).rejects.toThrow("Failed to get input fields: Unknown error");
         });
         it("should handle API response with empty errors array", async () => {
             mockApiClient.post = vi.fn().mockResolvedValue({
@@ -523,7 +700,7 @@ describe("listInputFieldChoices plugin", () => {
                 actionType: "read",
                 actionKey: "send_message",
                 inputFieldKey: "channel",
-            })).rejects.toThrow("Failed to get input field choices: Unknown error");
+            })).rejects.toThrow("Failed to get input fields: Unknown error");
         });
     });
     describe("context and metadata", () => {

package/dist/plugins/listInputFields/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFields/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAE5B,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAmKxE,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC7D,IAAI,EAAE,aAAa,EAAE,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC9D,KAAK,IAAI,aAAa,CAAC,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC,CAAC;KACvE,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,eAAe,EAAE;gBACf,WAAW,EAAE,OAAO,qBAAqB,CAAC;aAC3C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,UAAU,CAAC,oBAAoB,GAAG,uBAAuB,CAAC,EAAE,uCAAuC;AACnG;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,6BAA6B,CAyF9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFields/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAE5B,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAoKxE,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC7D,IAAI,EAAE,aAAa,EAAE,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC9D,KAAK,IAAI,aAAa,CAAC,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC,CAAC;KACvE,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,eAAe,EAAE;gBACf,WAAW,EAAE,OAAO,qBAAqB,CAAC;aAC3C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,UAAU,CAAC,oBAAoB,GAAG,uBAAuB,CAAC,EAAE,uCAAuC;AACnG;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,6BAA6B,CA8E9B,CAAC"}

package/dist/plugins/listInputFields/index.js

@@ -1,9 +1,10 @@
 import { ListInputFieldsSchema, } from "./schemas";
-import { ZapierConfigurationError, ZapierApiError } from "../../types/errors";
+import { ZapierConfigurationError } from "../../types/errors";
 import { createPaginatedFunction } from "../../utils/function-utils";
 import { appKeyResolver, actionTypeResolver, actionKeyResolver, authenticationIdResolver, inputsAllOptionalResolver, } from "../../resolvers";
 import { RootFieldItemSchema } from "../../schemas/Field";
 import { toTitleCase } from "../../utils/string-utils";
+import { fetchImplementationNeeds } from "../../services/implementations";
 // Enums for input field transformation
 var InputFieldType;
 (function (InputFieldType) {
@@ -147,7 +148,7 @@ export const listInputFieldsPlugin = ({ sdk, context }) => {
         // Note: This function ignores pageSize and cursor since it's not actually paginated internally
         const { api, getVersionedImplementationId } = context;
         // Extract parameters
-        const { appKey, actionKey, actionType, authenticationId, inputs } = options;
+        const { appKey, actionKey, actionType, authenticationId = null, inputs, } = options;
         // Use the manifest plugin
         const selectedApi = await getVersionedImplementationId(appKey);
         if (!selectedApi) {
@@ -158,21 +159,15 @@ export const listInputFieldsPlugin = ({ sdk, context }) => {
             actionType,
             actionKey,
         });
-        // Build needs request
-        const needsRequest = {
-            selected_api: selectedApi,
+        // Use service layer to fetch implementation needs
+        const needsData = await fetchImplementationNeeds({
+            api,
+            selectedApi,
             action: action.key,
-            type_of: actionType,
-            params: inputs || {},
-        };
-        // Only include authentication_id if it's not null (skip authentication when null)
-        if (authenticationId !== null) {
-            needsRequest.authentication_id = authenticationId;
-        }
-        const needsData = await api.post("/api/v4/implementations/needs/", needsRequest);
-        if (!needsData.success) {
-            throw new ZapierApiError(`Failed to get action fields: ${needsData.errors?.join(", ") || "Unknown error"}`);
-        }
+            actionType,
+            authenticationId,
+            inputs,
+        });
         // Transform Need objects to Root Fieldset with proper nesting
         const rootFieldset = transformNeedsToFields(needsData.needs || []);
         return {

package/dist/plugins/listInputFields/index.test.js

@@ -208,7 +208,7 @@ describe("listInputFields plugin", () => {
                 placeholder: "Enter your message",
                 default_value: "",
             }));
-            // Check channel field with SELECT format
+            // Check channel field with SELECT format (choices should NOT be exposed)
             expect(result.data[1]).toEqual(expect.objectContaining({
                 key: "channel",
                 title: "Channel",
@@ -217,6 +217,8 @@ describe("listInputFields plugin", () => {
                 value_type: "STRING",
                 format: "SELECT",
             }));
+            // Verify choices are NOT exposed in listInputFields output
+            expect(result.data[1]).not.toHaveProperty("choices");
             // Check array field
             expect(result.data[2]).toEqual(expect.objectContaining({
                 key: "tags",
@@ -298,7 +300,7 @@ describe("listInputFields plugin", () => {
                 appKey: "slack",
                 actionType: "write",
                 actionKey: "send_message", // Use valid action so we get to the POST call
-            })).rejects.toThrow("Failed to get action fields: Authentication failed, Invalid credentials");
+            })).rejects.toThrow("Failed to get input fields: Authentication failed, Invalid credentials");
         });
         it("should handle API errors gracefully", async () => {
             mockApiClient.post = vi

package/dist/services/implementations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Implementation Services
+ *
+ * This module provides domain-specific service functions for interacting with
+ * the /api/v4/implementations/* endpoints. These services handle request building,
+ * validation, error handling, and authentication for implementation-related API calls.
+ *
+ * Services are consumed by plugins to avoid code duplication while maintaining
+ * separation between the generic HTTP client layer and business logic.
+ */
+import type { ApiClient } from "../api";
+import type { NeedsResponse, NeedChoicesResponse } from "../api/types";
+/**
+ * Fetches implementation needs (input fields) for a specific action.
+ *
+ * This service calls the /api/v4/implementations/needs/ endpoint and returns
+ * the raw response after validating success. The response includes all field
+ * metadata including static choices, field types, and validation rules.
+ *
+ * @param params - Request parameters
+ * @param params.api - API client instance
+ * @param params.selectedApi - Versioned implementation ID (e.g., "SlackCLIAPI@1.21.1")
+ * @param params.action - Action key
+ * @param params.actionType - Action type (read, write, etc.)
+ * @param params.authenticationId - Authentication ID (null to skip authentication)
+ * @param params.inputs - Input values that may affect available fields
+ * @returns Promise resolving to NeedsResponse
+ * @throws {ZapierApiError} When the API request fails or returns success: false
+ */
+export declare function fetchImplementationNeeds({ api, selectedApi, action, actionType, authenticationId, inputs, }: {
+    api: ApiClient;
+    selectedApi: string;
+    action: string;
+    actionType: string;
+    authenticationId: number | null;
+    inputs?: Record<string, unknown>;
+}): Promise<NeedsResponse>;
+/**
+ * Fetches dynamic choices for a specific input field.
+ *
+ * This service calls the /api/v4/implementations/choices/ endpoint and returns
+ * the raw response after validating success. The response includes available
+ * choices for dropdown fields with pagination support.
+ *
+ * @param params - Request parameters
+ * @param params.api - API client instance
+ * @param params.actionId - Action ID (e.g., "core:123")
+ * @param params.inputFieldId - Input field key
+ * @param params.authenticationId - Authentication ID (null to skip authentication)
+ * @param params.inputs - Input values that may affect available choices
+ * @param params.page - Page number for pagination (0-indexed)
+ * @returns Promise resolving to NeedChoicesResponse
+ * @throws {ZapierApiError} When the API request fails or returns success: false
+ */
+export declare function fetchImplementationChoices({ api, actionId, inputFieldId, authenticationId, inputs, page, }: {
+    api: ApiClient;
+    actionId: string;
+    inputFieldId: string;
+    authenticationId: number | null;
+    inputs?: Record<string, unknown>;
+    page: number;
+}): Promise<NeedChoicesResponse>;
+//# sourceMappingURL=implementations.d.ts.map

package/dist/services/implementations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementations.d.ts","sourceRoot":"","sources":["../../src/services/implementations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAEV,aAAa,EAEb,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAGtB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,wBAAwB,CAAC,EAC7C,GAAG,EACH,WAAW,EACX,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,MAAM,GACP,EAAE;IACD,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,0BAA0B,CAAC,EAC/C,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,IAAI,GACL,EAAE;IACD,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyB/B"}

package/dist/services/implementations.js

@@ -0,0 +1,79 @@
+/**
+ * Implementation Services
+ *
+ * This module provides domain-specific service functions for interacting with
+ * the /api/v4/implementations/* endpoints. These services handle request building,
+ * validation, error handling, and authentication for implementation-related API calls.
+ *
+ * Services are consumed by plugins to avoid code duplication while maintaining
+ * separation between the generic HTTP client layer and business logic.
+ */
+import { ZapierApiError } from "../types/errors";
+/**
+ * Fetches implementation needs (input fields) for a specific action.
+ *
+ * This service calls the /api/v4/implementations/needs/ endpoint and returns
+ * the raw response after validating success. The response includes all field
+ * metadata including static choices, field types, and validation rules.
+ *
+ * @param params - Request parameters
+ * @param params.api - API client instance
+ * @param params.selectedApi - Versioned implementation ID (e.g., "SlackCLIAPI@1.21.1")
+ * @param params.action - Action key
+ * @param params.actionType - Action type (read, write, etc.)
+ * @param params.authenticationId - Authentication ID (null to skip authentication)
+ * @param params.inputs - Input values that may affect available fields
+ * @returns Promise resolving to NeedsResponse
+ * @throws {ZapierApiError} When the API request fails or returns success: false
+ */
+export async function fetchImplementationNeeds({ api, selectedApi, action, actionType, authenticationId, inputs, }) {
+    const request = {
+        selected_api: selectedApi,
+        action,
+        type_of: actionType,
+        params: inputs || {},
+    };
+    // Only include authentication_id if it's not null (skip authentication when null)
+    if (authenticationId !== null) {
+        request.authentication_id = authenticationId;
+    }
+    const response = await api.post("/api/v4/implementations/needs/", request);
+    if (!response.success) {
+        throw new ZapierApiError(`Failed to get input fields: ${response.errors?.join(", ") || "Unknown error"}`);
+    }
+    return response;
+}
+/**
+ * Fetches dynamic choices for a specific input field.
+ *
+ * This service calls the /api/v4/implementations/choices/ endpoint and returns
+ * the raw response after validating success. The response includes available
+ * choices for dropdown fields with pagination support.
+ *
+ * @param params - Request parameters
+ * @param params.api - API client instance
+ * @param params.actionId - Action ID (e.g., "core:123")
+ * @param params.inputFieldId - Input field key
+ * @param params.authenticationId - Authentication ID (null to skip authentication)
+ * @param params.inputs - Input values that may affect available choices
+ * @param params.page - Page number for pagination (0-indexed)
+ * @returns Promise resolving to NeedChoicesResponse
+ * @throws {ZapierApiError} When the API request fails or returns success: false
+ */
+export async function fetchImplementationChoices({ api, actionId, inputFieldId, authenticationId, inputs, page, }) {
+    const request = {
+        action_id: actionId,
+        input_field_id: inputFieldId,
+        page,
+        params: inputs || {},
+    };
+    // Only include authentication_id if it's not null (skip authentication when null)
+    if (authenticationId !== null) {
+        request.authentication_id = authenticationId;
+    }
+    const response = await api.post("/api/v4/implementations/choices/", request);
+    if (!response.success) {
+        throw new ZapierApiError(`Failed to get input field choices: ${response.errors?.join(", ") || "Unknown error"}`);
+    }
+    return response;
+}

package/dist/utils/batch-utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Batch Operation Utilities
+ *
+ * This module provides utilities for executing multiple async operations
+ * with concurrency control and retry logic.
+ */
+/**
+ * Options for batch execution
+ */
+export interface BatchOptions {
+    /**
+     * Maximum number of concurrent operations (default: 10)
+     * Lower values are more "polite" but slower
+     * Higher values are faster but risk rate limits
+     */
+    concurrency?: number;
+    /**
+     * Whether to retry failed operations (default: true)
+     * When enabled, each operation gets up to MAX_CONSECUTIVE_ERRORS retries
+     */
+    retry?: boolean;
+    /**
+     * Delay in milliseconds between starting batches (default: 100ms)
+     * Adds a small delay between concurrent batches to avoid burst patterns
+     */
+    batchDelay?: number;
+    /**
+     * Overall timeout for the entire batch operation in milliseconds (default: 180000ms / 3 minutes)
+     * When exceeded, throws ZapierTimeoutError and stops processing remaining tasks
+     */
+    timeoutMs?: number;
+    /**
+     * Timeout for individual tasks in milliseconds (default: none)
+     * When set, each task will be cancelled if it exceeds this duration
+     * Tasks that timeout will be marked as rejected in the results
+     */
+    taskTimeoutMs?: number;
+}
+/**
+ * Execute multiple async operations with concurrency limiting and retry logic
+ *
+ * This prevents overwhelming APIs by:
+ * 1. Limiting concurrent operations (worker pool pattern)
+ * 2. Adding small delays between batches to avoid burst detection
+ * 3. Retrying failed operations with exponential backoff
+ *
+ * Problem Solved:
+ * - Rate limit prevention: Steady stream instead of burst requests
+ * - Connection pool management: Stays within browser/Node limits (~6-8 per domain)
+ * - Resilience: Transient failures are retried automatically
+ * - Observability: Returns detailed success/failure info for each operation
+ *
+ * Example Usage:
+ * ```typescript
+ * // Instead of Promise.allSettled (fires all at once):
+ * const results = await Promise.allSettled(
+ *   actions.map(a => sdk.listInputFields(a))
+ * );
+ *
+ * // Use batch (controlled concurrency):
+ * const results = await batch(
+ *   actions.map(a => () => sdk.listInputFields(a)),
+ *   { concurrency: 10, retry: true }
+ * );
+ * ```
+ *
+ * @param tasks - Array of functions that return promises (NOT promises themselves!)
+ * @param options - Configuration for concurrency and retry behavior
+ * @returns Promise resolving to array of settled results (same as Promise.allSettled)
+ */
+export declare function batch<T>(tasks: (() => Promise<T>)[], options?: BatchOptions): Promise<PromiseSettledResult<T>[]>;
+//# sourceMappingURL=batch-utils.d.ts.map

package/dist/utils/batch-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-utils.d.ts","sourceRoot":"","sources":["../../src/utils/batch-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAuIpC"}