@zapier/zapier-sdk 0.13.9 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @zapier/zapier-sdk
 
+## 0.14.0
+
+### Minor Changes
+
+- 3f2f104: - Introduce a `services` layer for reusability between plugins
+  - `listInputFieldChoices` now supports returning static choices if they exist
+
 ## 0.13.9
 
 ### Patch Changes

package/dist/index.cjs

@@ -1812,6 +1812,64 @@ var RootFieldItemSchema = zod.z.union([
   FieldsetItemSchema
 ]);
 
+// src/services/implementations.ts
+async function fetchImplementationNeeds({
+  api,
+  selectedApi,
+  action,
+  actionType,
+  authenticationId,
+  inputs
+}) {
+  const request = {
+    selected_api: selectedApi,
+    action,
+    type_of: actionType,
+    params: inputs || {}
+  };
+  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;
+}
+async function fetchImplementationChoices({
+  api,
+  actionId,
+  inputFieldId,
+  authenticationId,
+  inputs,
+  page
+}) {
+  const request = {
+    action_id: actionId,
+    input_field_id: inputFieldId,
+    page,
+    params: inputs || {}
+  };
+  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;
+}
+
 // src/plugins/listInputFields/index.ts
 function getInputFieldTypeFromNeed(need) {
   if (need.list) {
@@ -1915,7 +1973,13 @@ var listInputFieldsPlugin = ({ sdk, context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(options) {
       const { api, getVersionedImplementationId } = context;
-      const { appKey, actionKey, actionType, authenticationId, inputs } = options;
+      const {
+        appKey,
+        actionKey,
+        actionType,
+        authenticationId = null,
+        inputs
+      } = options;
       const selectedApi = await getVersionedImplementationId(appKey);
       if (!selectedApi) {
         throw new ZapierConfigurationError(
@@ -1928,24 +1992,14 @@ var listInputFieldsPlugin = ({ sdk, context }) => {
         actionType,
         actionKey
       });
-      const needsRequest = {
-        selected_api: selectedApi,
+      const needsData = await fetchImplementationNeeds({
+        api,
+        selectedApi,
         action: action.key,
-        type_of: actionType,
-        params: inputs || {}
-      };
-      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
+      });
       const rootFieldset = transformNeedsToFields(needsData.needs || []);
       return {
         data: rootFieldset,
@@ -3855,43 +3909,62 @@ function transformNeedChoicesToInputFieldChoiceItem(choice) {
 }
 var listInputFieldChoicesPlugin = ({ context, sdk }) => {
   const listInputFieldChoices = createPaginatedFunction(async function listInputFieldChoicesPage(options) {
-    const { api } = context;
+    const { api, getVersionedImplementationId } = context;
     const {
       appKey,
       actionType,
       actionKey,
       inputFieldKey,
-      authenticationId,
+      authenticationId = null,
       inputs,
       page,
       cursor
     } = options;
-    const actionResult = await sdk.getAction({ appKey, actionType, actionKey });
-    const actionId = actionResult.data.id;
-    if (!actionId) {
-      throw new ZapierApiError(
-        `Action ${actionKey} does not have an ID - cannot retrieve input field choices`
+    const selectedApi = await getVersionedImplementationId(appKey);
+    if (!selectedApi) {
+      throw new ZapierConfigurationError(
+        "No current_implementation_id found for app",
+        { configType: "current_implementation_id" }
       );
     }
-    const requestPage = cursor ? parseInt(cursor, 10) : page ?? 0;
-    const choicesRequest = {
-      action_id: actionId,
-      input_field_id: inputFieldKey,
-      page: requestPage,
-      params: inputs || {}
-    };
-    if (authenticationId !== null) {
-      choicesRequest.authentication_id = authenticationId;
-    }
-    const choicesData = await api.post(
-      "/api/v4/implementations/choices/",
-      choicesRequest
+    const { data: action } = await sdk.getAction({
+      appKey,
+      actionType,
+      actionKey
+    });
+    const needsData = await fetchImplementationNeeds({
+      api,
+      selectedApi,
+      action: action.key,
+      actionType,
+      authenticationId,
+      inputs
+    });
+    const targetNeed = needsData.needs?.find(
+      (need) => need.key === inputFieldKey
     );
-    if (!choicesData.success) {
+    if (targetNeed?.choices && targetNeed.choices.length > 0) {
+      return {
+        data: targetNeed.choices.map(
+          transformNeedChoicesToInputFieldChoiceItem
+        ),
+        nextCursor: void 0
+      };
+    }
+    if (!action.id) {
       throw new ZapierApiError(
-        `Failed to get input field choices: ${choicesData.errors?.join(", ") || "Unknown error"}`
+        `Action ${actionKey} does not have an ID - cannot retrieve input field choices`
       );
     }
+    const requestPage = cursor ? parseInt(cursor, 10) : page ?? 0;
+    const choicesData = await fetchImplementationChoices({
+      api,
+      actionId: action.id,
+      inputFieldId: inputFieldKey,
+      authenticationId,
+      inputs,
+      page: requestPage
+    });
     const choices = (choicesData.choices || []).map(
       transformNeedChoicesToInputFieldChoiceItem
     );
@@ -4089,7 +4162,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.13.9"};
+  version: "0.14.0"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {

package/dist/index.mjs

@@ -1790,6 +1790,64 @@ var RootFieldItemSchema = z.union([
   FieldsetItemSchema
 ]);
 
+// src/services/implementations.ts
+async function fetchImplementationNeeds({
+  api,
+  selectedApi,
+  action,
+  actionType,
+  authenticationId,
+  inputs
+}) {
+  const request = {
+    selected_api: selectedApi,
+    action,
+    type_of: actionType,
+    params: inputs || {}
+  };
+  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;
+}
+async function fetchImplementationChoices({
+  api,
+  actionId,
+  inputFieldId,
+  authenticationId,
+  inputs,
+  page
+}) {
+  const request = {
+    action_id: actionId,
+    input_field_id: inputFieldId,
+    page,
+    params: inputs || {}
+  };
+  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;
+}
+
 // src/plugins/listInputFields/index.ts
 function getInputFieldTypeFromNeed(need) {
   if (need.list) {
@@ -1893,7 +1951,13 @@ var listInputFieldsPlugin = ({ sdk, context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(options) {
       const { api, getVersionedImplementationId } = context;
-      const { appKey, actionKey, actionType, authenticationId, inputs } = options;
+      const {
+        appKey,
+        actionKey,
+        actionType,
+        authenticationId = null,
+        inputs
+      } = options;
       const selectedApi = await getVersionedImplementationId(appKey);
       if (!selectedApi) {
         throw new ZapierConfigurationError(
@@ -1906,24 +1970,14 @@ var listInputFieldsPlugin = ({ sdk, context }) => {
         actionType,
         actionKey
       });
-      const needsRequest = {
-        selected_api: selectedApi,
+      const needsData = await fetchImplementationNeeds({
+        api,
+        selectedApi,
         action: action.key,
-        type_of: actionType,
-        params: inputs || {}
-      };
-      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
+      });
       const rootFieldset = transformNeedsToFields(needsData.needs || []);
       return {
         data: rootFieldset,
@@ -3833,43 +3887,62 @@ function transformNeedChoicesToInputFieldChoiceItem(choice) {
 }
 var listInputFieldChoicesPlugin = ({ context, sdk }) => {
   const listInputFieldChoices = createPaginatedFunction(async function listInputFieldChoicesPage(options) {
-    const { api } = context;
+    const { api, getVersionedImplementationId } = context;
     const {
       appKey,
       actionType,
       actionKey,
       inputFieldKey,
-      authenticationId,
+      authenticationId = null,
       inputs,
       page,
       cursor
     } = options;
-    const actionResult = await sdk.getAction({ appKey, actionType, actionKey });
-    const actionId = actionResult.data.id;
-    if (!actionId) {
-      throw new ZapierApiError(
-        `Action ${actionKey} does not have an ID - cannot retrieve input field choices`
+    const selectedApi = await getVersionedImplementationId(appKey);
+    if (!selectedApi) {
+      throw new ZapierConfigurationError(
+        "No current_implementation_id found for app",
+        { configType: "current_implementation_id" }
       );
     }
-    const requestPage = cursor ? parseInt(cursor, 10) : page ?? 0;
-    const choicesRequest = {
-      action_id: actionId,
-      input_field_id: inputFieldKey,
-      page: requestPage,
-      params: inputs || {}
-    };
-    if (authenticationId !== null) {
-      choicesRequest.authentication_id = authenticationId;
-    }
-    const choicesData = await api.post(
-      "/api/v4/implementations/choices/",
-      choicesRequest
+    const { data: action } = await sdk.getAction({
+      appKey,
+      actionType,
+      actionKey
+    });
+    const needsData = await fetchImplementationNeeds({
+      api,
+      selectedApi,
+      action: action.key,
+      actionType,
+      authenticationId,
+      inputs
+    });
+    const targetNeed = needsData.needs?.find(
+      (need) => need.key === inputFieldKey
     );
-    if (!choicesData.success) {
+    if (targetNeed?.choices && targetNeed.choices.length > 0) {
+      return {
+        data: targetNeed.choices.map(
+          transformNeedChoicesToInputFieldChoiceItem
+        ),
+        nextCursor: void 0
+      };
+    }
+    if (!action.id) {
       throw new ZapierApiError(
-        `Failed to get input field choices: ${choicesData.errors?.join(", ") || "Unknown error"}`
+        `Action ${actionKey} does not have an ID - cannot retrieve input field choices`
       );
     }
+    const requestPage = cursor ? parseInt(cursor, 10) : page ?? 0;
+    const choicesData = await fetchImplementationChoices({
+      api,
+      actionId: action.id,
+      inputFieldId: inputFieldKey,
+      authenticationId,
+      inputs,
+      page: requestPage
+    });
     const choices = (choicesData.choices || []).map(
       transformNeedChoicesToInputFieldChoiceItem
     );
@@ -4067,7 +4140,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.13.9"};
+  version: "0.14.0"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {

package/dist/plugins/listInputFieldChoices/index.d.ts

@@ -3,6 +3,7 @@ import type { ApiClient } from "../../api";
 import type { InputFieldChoiceItem } from "./schemas";
 import { ListInputFieldChoicesSchema, type ListInputFieldChoicesOptions } from "./schemas";
 import type { GetActionPluginProvides } from "../getAction";
+import type { GetVersionedImplementationId } from "../manifest/schemas";
 export interface ListInputFieldChoicesPluginProvides {
     listInputFieldChoices: (options: ListInputFieldChoicesOptions) => Promise<{
         data: InputFieldChoiceItem[];
@@ -24,6 +25,7 @@ export interface ListInputFieldChoicesPluginProvides {
 export declare const listInputFieldChoicesPlugin: Plugin<GetSdkType<GetActionPluginProvides>, // requires getAction in SDK
 {
     api: ApiClient;
-}, // requires api in context
+    getVersionedImplementationId: GetVersionedImplementationId;
+}, // requires api and getVersionedImplementationId in context
 ListInputFieldChoicesPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFieldChoices/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAM3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,KAAK,4BAA4B,EAGlC,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAsB5D,MAAM,WAAW,mCAAmC;IAClD,qBAAqB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC;QACxE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACrE,KAAK,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAAC;KAC9C,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,qBAAqB,EAAE;gBACrB,WAAW,EAAE,OAAO,2BAA2B,CAAC;aACjD,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,UAAU,CAAC,uBAAuB,CAAC,EAAE,4BAA4B;AACjE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,EAAE,0BAA0B;AAC9C,mCAAmC,CAkHpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFieldChoices/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,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,KAAK,4BAA4B,EAGlC,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AA0BxE,MAAM,WAAW,mCAAmC;IAClD,qBAAqB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC;QACxE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACrE,KAAK,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAAC;KAC9C,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,qBAAqB,EAAE;gBACrB,WAAW,EAAE,OAAO,2BAA2B,CAAC;aACjD,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,UAAU,CAAC,uBAAuB,CAAC,EAAE,4BAA4B;AACjE;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,mCAAmC,CAyIpC,CAAC"}

package/dist/plugins/listInputFieldChoices/index.js

@@ -1,7 +1,8 @@
 import { ListInputFieldChoicesSchema, InputFieldChoiceItemSchema, } from "./schemas";
-import { ZapierApiError } from "../../types/errors";
+import { ZapierApiError, ZapierConfigurationError } from "../../types/errors";
 import { createPaginatedFunction } from "../../utils/function-utils";
 import { appKeyResolver, actionTypeResolver, actionKeyResolver, authenticationIdResolver, inputFieldKeyResolver, inputsAllOptionalResolver, } from "../../resolvers";
+import { fetchImplementationNeeds, fetchImplementationChoices, } from "../../services/implementations";
 // Transform NeedChoices to InputFieldChoiceItem
 function transformNeedChoicesToInputFieldChoiceItem(choice) {
     return {
@@ -13,32 +14,52 @@ function transformNeedChoicesToInputFieldChoiceItem(choice) {
 }
 export const listInputFieldChoicesPlugin = ({ context, sdk }) => {
     const listInputFieldChoices = createPaginatedFunction(async function listInputFieldChoicesPage(options) {
-        const { api } = context;
+        const { api, getVersionedImplementationId } = context;
         // Extract parameters
-        const { appKey, actionType, actionKey, inputFieldKey, authenticationId, inputs, page, cursor, } = options;
-        // Use sdk.getAction to get the action ID
-        const actionResult = await sdk.getAction({ appKey, actionType, actionKey });
-        const actionId = actionResult.data.id;
-        if (!actionId) {
+        const { appKey, actionType, actionKey, inputFieldKey, authenticationId = null, inputs, page, cursor, } = options;
+        // Get versioned implementation ID for the app
+        const selectedApi = await getVersionedImplementationId(appKey);
+        if (!selectedApi) {
+            throw new ZapierConfigurationError("No current_implementation_id found for app", { configType: "current_implementation_id" });
+        }
+        // Get action details
+        const { data: action } = await sdk.getAction({
+            appKey,
+            actionType,
+            actionKey,
+        });
+        // First, check for static choices by fetching implementation needs directly
+        const needsData = await fetchImplementationNeeds({
+            api,
+            selectedApi,
+            action: action.key,
+            actionType,
+            authenticationId,
+            inputs,
+        });
+        // Find the specific Need by key - search through raw needs array
+        const targetNeed = needsData.needs?.find((need) => need.key === inputFieldKey);
+        // If the need has static choices, return them
+        if (targetNeed?.choices && targetNeed.choices.length > 0) {
+            return {
+                data: targetNeed.choices.map(transformNeedChoicesToInputFieldChoiceItem),
+                nextCursor: undefined,
+            };
+        }
+        if (!action.id) {
             throw new ZapierApiError(`Action ${actionKey} does not have an ID - cannot retrieve input field choices`);
         }
-        // Build choices request using action ID from getAction
         // Use cursor (from pagination) as page number if available, otherwise use explicit page or default to 0
         const requestPage = cursor ? parseInt(cursor, 10) : (page ?? 0);
-        const choicesRequest = {
-            action_id: actionId,
-            input_field_id: inputFieldKey,
+        // Use service layer to fetch dynamic choices
+        const choicesData = await fetchImplementationChoices({
+            api,
+            actionId: action.id,
+            inputFieldId: inputFieldKey,
+            authenticationId,
+            inputs,
             page: requestPage,
-            params: inputs || {},
-        };
-        // Only include authentication_id if it's not null (skip authentication when null)
-        if (authenticationId !== null) {
-            choicesRequest.authentication_id = authenticationId;
-        }
-        const choicesData = await api.post("/api/v4/implementations/choices/", choicesRequest);
-        if (!choicesData.success) {
-            throw new ZapierApiError(`Failed to get input field choices: ${choicesData.errors?.join(", ") || "Unknown error"}`);
-        }
+        });
         // Transform NeedChoices objects to InputFieldChoiceItem objects
         const choices = (choicesData.choices || []).map(transformNeedChoicesToInputFieldChoiceItem);
         // Handle pagination

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.13.9",
+  "version": "0.14.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",