@zapier/zapier-sdk 0.13.1 → 0.13.3

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

@@ -1,6 +1,10 @@
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { ZapierValidationError, ZapierConfigurationError, ZapierApiError, } from "../../types/errors";
 import { listInputFieldsPlugin } from "./index";
+import { getActionPlugin } from "../getAction";
+import { getAppPlugin } from "../getApp";
+import { listActionsPlugin } from "../listActions";
+import { listAppsPlugin } from "../listApps";
 import { createSdk } from "../../sdk";
 const mockNeeds = [
     {
@@ -35,12 +39,34 @@ const mockNeedsResponse = {
     success: true,
     needs: mockNeeds,
 };
+const mockActionsResponse = {
+    results: [
+        {
+            slug: "slack",
+            selected_api: "slack",
+            actions: [
+                {
+                    key: "send_message",
+                    name: "Send Message",
+                    description: "Send a message to a channel",
+                    type_of: "write",
+                    type: "write",
+                    id: "core:12345",
+                },
+            ],
+        },
+    ],
+    meta: {
+        next_cursor: null,
+    },
+};
 describe("listInputFields plugin", () => {
     let mockApiClient;
     let mockGetVersionedImplementationId;
     beforeEach(() => {
         vi.clearAllMocks();
         mockApiClient = {
+            get: vi.fn().mockResolvedValue(mockActionsResponse),
             post: vi.fn().mockResolvedValue(mockNeedsResponse),
         };
         mockGetVersionedImplementationId = vi
@@ -52,7 +78,12 @@ describe("listInputFields plugin", () => {
             api: mockApiClient,
             meta: {},
             getVersionedImplementationId: mockGetVersionedImplementationId,
-        }).addPlugin(listInputFieldsPlugin);
+        })
+            .addPlugin(listAppsPlugin)
+            .addPlugin(listActionsPlugin)
+            .addPlugin(getAppPlugin)
+            .addPlugin(getActionPlugin)
+            .addPlugin(listInputFieldsPlugin);
     }
     describe("schema validation", () => {
         it("should throw validation error for missing required fields", () => {
@@ -255,19 +286,19 @@ describe("listInputFields plugin", () => {
         it("should throw ZapierApiError when API response indicates failure", async () => {
             mockApiClient.post = vi.fn().mockResolvedValue({
                 success: false,
-                errors: ["Invalid action", "Missing parameter"],
+                errors: ["Authentication failed", "Invalid credentials"],
             });
             const sdk = createTestSdk();
             await expect(sdk.listInputFields({
                 appKey: "slack",
                 actionType: "write",
-                actionKey: "invalid_action",
+                actionKey: "send_message", // Use valid action so we get to the POST call
             })).rejects.toThrow(ZapierApiError);
             await expect(sdk.listInputFields({
                 appKey: "slack",
                 actionType: "write",
-                actionKey: "invalid_action",
-            })).rejects.toThrow("Failed to get action fields: Invalid action, Missing parameter");
+                actionKey: "send_message", // Use valid action so we get to the POST call
+            })).rejects.toThrow("Failed to get action fields: Authentication failed, Invalid credentials");
         });
         it("should handle API errors gracefully", async () => {
             mockApiClient.post = vi

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/runAction/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EAEtB,MAAM,WAAW,CAAC;AAQnB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAQtD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC;QACjD,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACpD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,SAAS,EAAE;gBACT,WAAW,EAAE,OAAO,eAAe,CAAC;aACrC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AA4ED,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,UAAU,CAAC,uBAAuB,GAAG,oBAAoB,CAAC,EAAE,uCAAuC;AACnG;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,0BAA0B;AAC7B,uBAAuB,CAmFxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/runAction/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EAEtB,MAAM,WAAW,CAAC;AAQnB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAQtD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC;QACjD,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACpD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,SAAS,EAAE;gBACT,WAAW,EAAE,OAAO,eAAe,CAAC;aACrC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAgFD,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,UAAU,CAAC,uBAAuB,GAAG,oBAAoB,CAAC,EAAE,uCAAuC;AACnG;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,0BAA0B;AAC7B,uBAAuB,CAwFxB,CAAC"}

package/dist/plugins/runAction/index.js

@@ -4,7 +4,7 @@ import { ZapierValidationError, ZapierConfigurationError, ZapierActionError, } f
 import { createPaginatedFunction } from "../../utils/function-utils";
 import { appKeyResolver, actionTypeResolver, actionKeyResolver, authenticationIdResolver, inputsResolver, } from "../../resolvers";
 async function executeAction(actionOptions) {
-    const { api, context, appKey, actionKey, actionType, executionOptions, authenticationId, } = actionOptions;
+    const { api, context, appKey, actionId, actionKey, actionType, executionOptions, authenticationId, } = actionOptions;
     // Use the manifest plugin to get the current implementation ID
     const selectedApi = await context.getVersionedImplementationId(appKey);
     if (!selectedApi) {
@@ -13,6 +13,7 @@ async function executeAction(actionOptions) {
     // Step 1: POST to /actions/v1/runs to start execution
     const runRequestData = {
         selected_api: selectedApi,
+        action_id: actionId,
         action_key: actionKey,
         action_type: actionType,
         inputs: executionOptions.inputs || {},
@@ -47,11 +48,15 @@ export const runActionPlugin = ({ sdk, context }) => {
         if (actionData.data.action_type !== actionType) {
             throw new ZapierValidationError(`Action type mismatch: expected ${actionType}, got ${actionData.data.action_type}`);
         }
+        const actionId = actionData.data.id;
         // Execute the action using the Actions API (supports all action types)
         const result = await executeAction({
             api,
             context,
             appKey,
+            // Some actions require the action ID to run them, but technically the ID is not guaranteed to be available when
+            // we retrieve actions (probably legacy reasons), so we just pass along all the things!
+            actionId,
             actionKey,
             actionType,
             executionOptions: { inputs },

package/dist/schemas/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/schemas/App.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMtE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBzB,CAAC;AAMF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/schemas/App.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMtE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BzB,CAAC;AAMF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/App.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { withFormatter } from "../utils/schema-utils";
 import { ImplementationMetaSchema } from "../api/schemas";
+import { toSnakeCase } from "../utils/string-utils";
 // ============================================================================
 // App Item Schema (extends ImplementationMetaSchema with transformed fields)
 // ============================================================================
@@ -10,10 +11,19 @@ export const AppItemSchema = withFormatter(ImplementationMetaSchema.omit({ name:
     implementation_id: z.string(), // Mapped from id (full versioned ID)
 }), {
     format: (item) => {
+        // Create additional keys if slug exists
+        const additionalKeys = [];
+        if (item.slug && item.slug !== item.key) {
+            additionalKeys.push(item.slug);
+            const snakeCaseSlug = toSnakeCase(item.slug);
+            if (snakeCaseSlug !== item.slug && snakeCaseSlug !== item.key) {
+                additionalKeys.push(snakeCaseSlug);
+            }
+        }
         return {
             title: item.title,
             key: item.key,
-            keys: [item.slug, item.key].filter(Boolean),
+            keys: [item.key, ...additionalKeys],
             description: item.description,
             details: [],
         };

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

@@ -1 +1 @@
-{"version":3,"file":"domain-utils.d.ts","sourceRoot":"","sources":["../../src/utils/domain-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAgBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,kBAAkB,CAqCpB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAsB9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAgCA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAUA;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAkBvD;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,GACrB,UAAU,IAAI,kBAAkB,CAElC;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAEzE"}
+{"version":3,"file":"domain-utils.d.ts","sourceRoot":"","sources":["../../src/utils/domain-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAYT;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,kBAAkB,CAqCpB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAsB9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAgCA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAUA;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAkBvD;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,GACrB,UAAU,IAAI,kBAAkB,CAElC;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAEzE"}

package/dist/utils/domain-utils.js

@@ -27,18 +27,14 @@ export function splitVersionedKey(versionedKey) {
  * @returns Normalized AppItem with essential fields only
  */
 export function normalizeImplementationMetaToAppItem(implementationMeta) {
-    // Extract API name and version from the implementation ID
     const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
-    // Destructure to exclude id and name before spreading
     const { id, name, ...restOfImplementationMeta } = implementationMeta;
     return {
-        // Pass through all ImplementationMeta fields except id and name
         ...restOfImplementationMeta,
-        // Transform key fields
         title: name,
         key: selectedApi,
-        implementation_id: id, // Keep the full versioned ID
-        version: appVersion, // Extract version separately
+        implementation_id: id,
+        version: appVersion,
     };
 }
 /**

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

@@ -9,4 +9,13 @@
  * - mixed formats: "first_name-value" → "First Name Value"
  */
 export declare function toTitleCase(input: string): string;
+/**
+ * Converts a string to snake_case, handling various input formats:
+ * - camelCase: "firstName" → "first_name"
+ * - kebab-case: "first-name" → "first_name"
+ * - title case: "First Name" → "first_name"
+ * - mixed formats: "first-Name Value" → "first_name_value"
+ * - starts with number: "123abc" → "_123abc"
+ */
+export declare function toSnakeCase(input: string): string;
 //# sourceMappingURL=string-utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD"}
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjD"}

package/dist/utils/string-utils.js

@@ -21,3 +21,28 @@ export function toTitleCase(input) {
         .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
         .join(" "));
 }
+/**
+ * Converts a string to snake_case, handling various input formats:
+ * - camelCase: "firstName" → "first_name"
+ * - kebab-case: "first-name" → "first_name"
+ * - title case: "First Name" → "first_name"
+ * - mixed formats: "first-Name Value" → "first_name_value"
+ * - starts with number: "123abc" → "_123abc"
+ */
+export function toSnakeCase(input) {
+    let result = input
+        // insert underscore before capital letters (handles camelCase)
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        // replace spaces and dashes with underscores
+        .replace(/[\s\-]+/g, "_")
+        // replace multiple underscores with single underscore
+        .replace(/_+/g, "_")
+        // remove leading/trailing underscores and convert to lowercase
+        .replace(/^_|_$/g, "")
+        .toLowerCase();
+    // If the result starts with a number, prefix with underscore
+    if (/^[0-9]/.test(result)) {
+        result = "_" + result;
+    }
+    return result;
+}

package/package.json

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

package/src/api/debug.ts

@@ -7,13 +7,56 @@
 
 import type { DebugLogger } from "./types";
 
+import type { InspectOptions } from "util";
+
+type UtilModule = {
+  inspect: (object: unknown, options?: InspectOptions) => string;
+};
+
+// We don't want to import util since it might not work in a browser. So we'll lazily load it and cache the result so
+// we can use it synchronously after that. The types above are just to make our linter happy.
+let utilModule: UtilModule | null = null;
+let utilPromise: Promise<UtilModule | null> | null = null;
+
 export function createDebugLogger(enabled: boolean): DebugLogger {
   if (!enabled) {
     return () => {}; // No-op function when debug is disabled
   }
 
+  // Try to load util module on first use.
+  if (!utilPromise) {
+    utilPromise = import("util")
+      .then((util) => {
+        utilModule = util;
+        return util;
+      })
+      .catch(() => {
+        utilModule = null;
+        return null;
+      });
+  }
+
   return (message: string, data?: unknown) => {
-    console.log(`[Zapier SDK] ${message}`, data || "");
+    if (data === undefined || data === "") {
+      console.log(`[Zapier SDK] ${message}`);
+      return;
+    }
+
+    // Use cached module if available for sync logging. Yes, this means if the util module isn't yet loaded, we'll fall
+    // back to a plain old console.log, which might mean we don't see proper formatting/nesting. But that's unlikely
+    // since this logging happens during async fetching. Alternatively, we could switch to async logging, but this
+    // seems fine since we have to have a fallback anyway.
+    if (utilModule) {
+      const formatted = utilModule.inspect(data, {
+        colors: true,
+        depth: null,
+        breakLength: 80,
+      });
+      console.log(`[Zapier SDK] ${message}`, formatted);
+    } else {
+      // Fallback - browser will handle formatting automatically
+      console.log(`[Zapier SDK] ${message}`, data);
+    }
   };
 }
 

package/src/index.ts

@@ -42,6 +42,9 @@ export { isPositional, PositionalMetadata } from "./utils/schema-utils";
 export { createFunction } from "./utils/function-utils";
 export type { FormattedItem, FormatMetadata } from "./utils/schema-utils";
 
+// Export string utilities
+export { toSnakeCase, toTitleCase } from "./utils/string-utils";
+
 // Export resolver utilities for CLI
 export * from "./resolvers";
 

package/src/plugins/getAction/index.ts

@@ -36,9 +36,12 @@ export const getActionPlugin: Plugin<
     // Use the listActions function from the SDK to search for the specific action
     const actionsResult = await sdk.listActions({ appKey });
 
-    // Search through all actions to find the matching one
+    // Search through all actions to find the matching one (by key or ID)
     for (const action of actionsResult.data) {
-      if (action.key === actionKey && action.action_type === actionType) {
+      if (
+        (action.key === actionKey || action.id === actionKey) &&
+        action.action_type === actionType
+      ) {
         return { data: action };
       }
     }

package/src/plugins/listInputFields/index.test.ts

@@ -5,6 +5,10 @@ import {
   ZapierApiError,
 } from "../../types/errors";
 import { listInputFieldsPlugin } from "./index";
+import { getActionPlugin } from "../getAction";
+import { getAppPlugin } from "../getApp";
+import { listActionsPlugin } from "../listActions";
+import { listAppsPlugin } from "../listApps";
 import { createSdk } from "../../sdk";
 import type { ApiClient } from "../../api";
 import type { ListInputFieldsOptions } from "./schemas";
@@ -45,6 +49,28 @@ const mockNeedsResponse: NeedsResponse = {
   needs: mockNeeds,
 };
 
+const mockActionsResponse = {
+  results: [
+    {
+      slug: "slack",
+      selected_api: "slack",
+      actions: [
+        {
+          key: "send_message",
+          name: "Send Message",
+          description: "Send a message to a channel",
+          type_of: "write",
+          type: "write",
+          id: "core:12345",
+        },
+      ],
+    },
+  ],
+  meta: {
+    next_cursor: null,
+  },
+};
+
 describe("listInputFields plugin", () => {
   let mockApiClient: ApiClient;
   let mockGetVersionedImplementationId: any;
@@ -52,6 +78,7 @@ describe("listInputFields plugin", () => {
   beforeEach(() => {
     vi.clearAllMocks();
     mockApiClient = {
+      get: vi.fn().mockResolvedValue(mockActionsResponse),
       post: vi.fn().mockResolvedValue(mockNeedsResponse),
     } as Partial<ApiClient> as ApiClient;
 
@@ -69,7 +96,12 @@ describe("listInputFields plugin", () => {
         meta: {},
         getVersionedImplementationId: mockGetVersionedImplementationId,
       },
-    ).addPlugin(listInputFieldsPlugin as any);
+    )
+      .addPlugin(listAppsPlugin as any)
+      .addPlugin(listActionsPlugin as any)
+      .addPlugin(getAppPlugin as any)
+      .addPlugin(getActionPlugin as any)
+      .addPlugin(listInputFieldsPlugin as any);
   }
 
   describe("schema validation", () => {
@@ -319,7 +351,7 @@ describe("listInputFields plugin", () => {
     it("should throw ZapierApiError when API response indicates failure", async () => {
       mockApiClient.post = vi.fn().mockResolvedValue({
         success: false,
-        errors: ["Invalid action", "Missing parameter"],
+        errors: ["Authentication failed", "Invalid credentials"],
       });
 
       const sdk = createTestSdk();
@@ -327,7 +359,7 @@ describe("listInputFields plugin", () => {
         sdk.listInputFields({
           appKey: "slack",
           actionType: "write",
-          actionKey: "invalid_action",
+          actionKey: "send_message", // Use valid action so we get to the POST call
         }),
       ).rejects.toThrow(ZapierApiError);
 
@@ -335,10 +367,10 @@ describe("listInputFields plugin", () => {
         sdk.listInputFields({
           appKey: "slack",
           actionType: "write",
-          actionKey: "invalid_action",
+          actionKey: "send_message", // Use valid action so we get to the POST call
         }),
       ).rejects.toThrow(
-        "Failed to get action fields: Invalid action, Missing parameter",
+        "Failed to get action fields: Authentication failed, Invalid credentials",
       );
     });
 

package/src/plugins/listInputFields/index.ts

@@ -15,6 +15,7 @@ import {
 import { ZapierConfigurationError, ZapierApiError } from "../../types/errors";
 import { createPaginatedFunction } from "../../utils/function-utils";
 import type { GetAppPluginProvides } from "../getApp";
+import type { GetActionPluginProvides } from "../getAction";
 import type { GetVersionedImplementationId } from "../manifest/schemas";
 import {
   appKeyResolver,
@@ -196,13 +197,13 @@ export interface ListInputFieldsPluginProvides {
 }
 
 export const listInputFieldsPlugin: Plugin<
-  GetSdkType<GetAppPluginProvides>, // requires getApp in SDK
+  GetSdkType<GetAppPluginProvides & GetActionPluginProvides>, // requires getApp and getAction in SDK
   {
     api: ApiClient;
     getVersionedImplementationId: GetVersionedImplementationId;
   }, // requires api and getVersionedImplementationId in context
   ListInputFieldsPluginProvides
-> = ({ context }) => {
+> = ({ sdk, context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(
       options: ListInputFieldsOptions & { cursor?: string } & {
@@ -226,10 +227,16 @@ export const listInputFieldsPlugin: Plugin<
         );
       }
 
+      const { data: action } = await sdk.getAction({
+        appKey,
+        actionType,
+        actionKey,
+      });
+
       // Build needs request
       const needsRequest: NeedsRequest = {
         selected_api: selectedApi,
-        action: actionKey,
+        action: action.key,
         type_of: actionType,
         params: inputs || {},
       };

package/src/plugins/runAction/index.ts

@@ -46,6 +46,7 @@ interface ExecuteActionOptions {
     getVersionedImplementationId: GetVersionedImplementationId;
   };
   appKey: string;
+  actionId?: string;
   actionKey: string;
   actionType: string;
   executionOptions: { inputs: Record<string, unknown> };
@@ -61,6 +62,7 @@ async function executeAction(actionOptions: ExecuteActionOptions): Promise<{
     api,
     context,
     appKey,
+    actionId,
     actionKey,
     actionType,
     executionOptions,
@@ -80,12 +82,14 @@ async function executeAction(actionOptions: ExecuteActionOptions): Promise<{
   // Step 1: POST to /actions/v1/runs to start execution
   const runRequestData: {
     selected_api: string;
+    action_id?: string;
     action_key: string;
     action_type: string;
     inputs: Record<string, unknown>;
     authentication_id?: number | null;
   } = {
     selected_api: selectedApi,
+    action_id: actionId,
     action_key: actionKey,
     action_type: actionType,
     inputs: executionOptions.inputs || {},
@@ -148,11 +152,16 @@ export const runActionPlugin: Plugin<
       );
     }
 
+    const actionId = actionData.data.id;
+
     // Execute the action using the Actions API (supports all action types)
     const result = await executeAction({
       api,
       context,
       appKey,
+      // Some actions require the action ID to run them, but technically the ID is not guaranteed to be available when
+      // we retrieve actions (probably legacy reasons), so we just pass along all the things!
+      actionId,
       actionKey,
       actionType,
       executionOptions: { inputs },

package/src/schemas/App.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { withFormatter } from "../utils/schema-utils";
 import { ImplementationMetaSchema } from "../api/schemas";
+import { toSnakeCase } from "../utils/string-utils";
 
 export { FormattedItem, FormatMetadata } from "../utils/schema-utils";
 
@@ -16,10 +17,20 @@ export const AppItemSchema = withFormatter(
   }),
   {
     format: (item) => {
+      // Create additional keys if slug exists
+      const additionalKeys = [];
+      if (item.slug && item.slug !== item.key) {
+        additionalKeys.push(item.slug);
+        const snakeCaseSlug = toSnakeCase(item.slug);
+        if (snakeCaseSlug !== item.slug && snakeCaseSlug !== item.key) {
+          additionalKeys.push(snakeCaseSlug);
+        }
+      }
+
       return {
         title: item.title,
         key: item.key,
-        keys: [item.slug, item.key].filter(Boolean),
+        keys: [item.key, ...additionalKeys],
         description: item.description,
         details: [],
       };

package/src/utils/domain-utils.ts

@@ -36,20 +36,16 @@ export function splitVersionedKey(
 export function normalizeImplementationMetaToAppItem(
   implementationMeta: ImplementationMeta,
 ): AppItem {
-  // Extract API name and version from the implementation ID
   const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
 
-  // Destructure to exclude id and name before spreading
   const { id, name, ...restOfImplementationMeta } = implementationMeta;
 
   return {
-    // Pass through all ImplementationMeta fields except id and name
     ...restOfImplementationMeta,
-    // Transform key fields
     title: name,
     key: selectedApi,
-    implementation_id: id, // Keep the full versioned ID
-    version: appVersion, // Extract version separately
+    implementation_id: id,
+    version: appVersion,
   };
 }
 

package/src/utils/string-utils.ts

@@ -24,3 +24,31 @@ export function toTitleCase(input: string): string {
       .join(" ")
   );
 }
+
+/**
+ * Converts a string to snake_case, handling various input formats:
+ * - camelCase: "firstName" → "first_name"
+ * - kebab-case: "first-name" → "first_name"
+ * - title case: "First Name" → "first_name"
+ * - mixed formats: "first-Name Value" → "first_name_value"
+ * - starts with number: "123abc" → "_123abc"
+ */
+export function toSnakeCase(input: string): string {
+  let result = input
+    // insert underscore before capital letters (handles camelCase)
+    .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+    // replace spaces and dashes with underscores
+    .replace(/[\s\-]+/g, "_")
+    // replace multiple underscores with single underscore
+    .replace(/_+/g, "_")
+    // remove leading/trailing underscores and convert to lowercase
+    .replace(/^_|_$/g, "")
+    .toLowerCase();
+
+  // If the result starts with a number, prefix with underscore
+  if (/^[0-9]/.test(result)) {
+    result = "_" + result;
+  }
+
+  return result;
+}