@zapier/zapier-sdk 0.13.9 → 0.15.0

package/dist/plugins/manifest/index.js

@@ -62,7 +62,7 @@ export async function getPreferredManifestEntryKey({ appKey, api, }) {
     if (locator.implementationName) {
         try {
             // API call to get app metadata by implementation name using selected_apis parameter
-            const implementationsEnvelope = await api.get(`/api/v4/implementations-meta/lookup/`, {
+            const implementationsEnvelope = await api.get(`/zapier/api/v4/implementations-meta/lookup/`, {
                 searchParams: {
                     selected_apis: locator.implementationName,
                 },
@@ -88,7 +88,7 @@ async function listAppsForSlugsPage({ slugs, cursor, api, }) {
     if (cursor) {
         searchParams.offset = cursor;
     }
-    const implementationsEnvelope = await api.get("/api/v4/implementations-meta/lookup/", {
+    const implementationsEnvelope = await api.get("/zapier/api/v4/implementations-meta/lookup/", {
         searchParams,
     });
     return {

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

@@ -32,7 +32,7 @@ describe("manifestPlugin", () => {
         vi.spyOn(console, "warn").mockImplementation(() => { });
         mockApiClient = {
             get: vi.fn().mockImplementation((url, options) => {
-                if (url === "/api/v4/implementations/") {
+                if (url === "/zapier/api/v4/implementations/") {
                     // Mock for manifest entries (versioned)
                     return Promise.resolve({
                         count: 1,
@@ -87,7 +87,7 @@ describe("manifestPlugin", () => {
                         ],
                     });
                 }
-                else if (url === "/api/v4/implementations-meta/lookup/") {
+                else if (url === "/zapier/api/v4/implementations-meta/lookup/") {
                     // Mock for implementations-meta/lookup fallback
                     const searchParams = options?.searchParams || {};
                     // Check if we're looking for a nonexistent app
@@ -591,7 +591,7 @@ describe("readManifestFromFile", () => {
                 api: mockApi,
             });
             expect(result).toBe("slack");
-            expect(mockApi.get).toHaveBeenCalledWith("/api/v4/implementations-meta/lookup/", {
+            expect(mockApi.get).toHaveBeenCalledWith("/zapier/api/v4/implementations-meta/lookup/", {
                 searchParams: { selected_apis: "SlackCLIAPI" },
             });
         });

package/dist/plugins/runAction/index.js

@@ -25,10 +25,10 @@ async function executeAction(actionOptions) {
     const runRequest = {
         data: runRequestData,
     };
-    const runData = await api.post("/api/actions/v1/runs", runRequest);
+    const runData = await api.post("/zapier/api/actions/v1/runs", runRequest);
     const runId = runData.data.id;
     // Step 2: Poll GET /actions/v1/runs/{run_id} for results
-    return await api.poll(`/api/actions/v1/runs/${runId}`, {
+    return await api.poll(`/zapier/api/actions/v1/runs/${runId}`, {
         successStatus: 200,
         pendingStatus: 202,
         resultExtractor: (result) => result.data,

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

@@ -125,7 +125,7 @@ describe("runAction plugin", () => {
                 inputs: { message: "Hello", channel: "#general" },
                 authenticationId: 12345,
             });
-            expect(mockApiClient.post).toHaveBeenCalledWith("/api/actions/v1/runs", {
+            expect(mockApiClient.post).toHaveBeenCalledWith("/zapier/api/actions/v1/runs", {
                 data: {
                     selected_api: "SlackCLIAPI@1.21.1",
                     action_key: "send_message",
@@ -134,7 +134,7 @@ describe("runAction plugin", () => {
                     authentication_id: 12345,
                 },
             });
-            expect(mockApiClient.poll).toHaveBeenCalledWith("/api/actions/v1/runs/run_123", {
+            expect(mockApiClient.poll).toHaveBeenCalledWith("/zapier/api/actions/v1/runs/run_123", {
                 successStatus: 200,
                 pendingStatus: 202,
                 resultExtractor: expect.any(Function),
@@ -148,7 +148,7 @@ describe("runAction plugin", () => {
                 actionKey: "send_message",
                 inputs: { message: "Hello" },
             });
-            expect(mockApiClient.post).toHaveBeenCalledWith("/api/actions/v1/runs", {
+            expect(mockApiClient.post).toHaveBeenCalledWith("/zapier/api/actions/v1/runs", {
                 data: {
                     selected_api: "SlackCLIAPI@1.21.1",
                     action_key: "send_message",
@@ -168,7 +168,7 @@ describe("runAction plugin", () => {
             // Simulate pagination by getting an iterator
             const iterator = runActionResult[Symbol.asyncIterator]();
             await iterator.next();
-            expect(mockApiClient.post).toHaveBeenCalledWith("/api/actions/v1/runs", expect.objectContaining({
+            expect(mockApiClient.post).toHaveBeenCalledWith("/zapier/api/actions/v1/runs", expect.objectContaining({
                 data: expect.objectContaining({
                     inputs: { message: "Hello" },
                     selected_api: "SlackCLIAPI@1.21.1",

package/dist/sdk.test.js

@@ -206,7 +206,7 @@ describe("Environment Variable Support", () => {
         // Verify that the request was made to the default base URL
         expect(mockFetch).toHaveBeenCalledTimes(1);
         const [actualUrl] = mockFetch.mock.calls[0];
-        expect(actualUrl).toMatch(/^https:\/\/zapier\.com/);
+        expect(actualUrl).toMatch(/^https:\/\/sdkapi\.zapier\.com/);
         expect(actualUrl).toContain("/api/v4/");
     });
     it("should use explicit baseUrl option for SDK API requests", async () => {

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("/zapier/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("/zapier/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.15.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",