@zapier/zapier-sdk 0.13.1 → 0.13.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.13.3
+
+### Patch Changes
+
+- 53fa85e: Show id and key properties when listing actions. Allow getAction to use an id or key. Make runAction pass action_id to API to ensure it always works.
+
+## 0.13.2
+
+### Patch Changes
+
+- 325d5c2: Fix bug where adding apps with dashed slugs would create types with syntax errors. All valid keys are now valid properties on the apps interface.
+
 ## 0.13.1
 
 ### Patch Changes

package/README.md

@@ -47,14 +47,21 @@ npm install -D @zapier/zapier-sdk-cli @types/node typescript
 npx zapier-sdk login
 
 # Generate TypeScript types for actions and fields of any apps you want to use.
-npx zapier-sdk add slack github trello
+npx zapier-sdk add slack google-sheets
+
+# The names of apps are there slugs if available, otherwise internal keys. If
+# you don't know the slug or key, just use `list-apps` search to find it.
+zapier-sdk list-apps --search "google sheets"
+
+# The output will show you the valid keys next to the app title like this:
+# 1. Google Sheets (GoogleSheetsV2CLIAPI, google-sheets, google_sheets)
 
 # By default, types will be generated inside your `src` or `lib` folder if you
 # have one or otherwise the root folder. Make sure your `tsconfig.json` file
 # includes the generated type files.
 
 # Alternatively, you can specify a custom output directory.
-npx zapier-sdk add slack github trello --types-output ./types
+npx zapier-sdk add slack google-sheets --types-output ./types
 ```
 
 ```typescript
@@ -193,6 +200,11 @@ const { data: sameUsers } = await zapier.apps.slack.search.user_by_email({
 console.log({
   sameUsers,
 });
+
+// If the slug for an app has dashes, you can also use a snake_cased app key.
+// For example, either of the following are valid:
+// zapier.apps["google-sheets"]
+// zapier.apps.google_sheets
 ```
 
 ## Available Functions

package/dist/api/debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/api/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAQ/D;AAED,wBAAgB,aAAa,CAC3B,OAAO,CAAC,EAAE,WAAW,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwCpC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,aAAa,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACvC,QAAQ,EAAE,WAAW,CAAC;CACvB,IAEe,OAAO,WAAW,GAAG,GAAG,EAAE,UAAU,WAAW,uBA0C9D"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/api/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAa3C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAwC/D;AAED,wBAAgB,aAAa,CAC3B,OAAO,CAAC,EAAE,WAAW,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwCpC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,aAAa,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACvC,QAAQ,EAAE,WAAW,CAAC;CACvB,IAEe,OAAO,WAAW,GAAG,GAAG,EAAE,UAAU,WAAW,uBA0C9D"}

package/dist/api/debug.js

@@ -4,12 +4,47 @@
  * This module provides debug logging capabilities for API requests and responses,
  * including request timing and detailed logging of HTTP interactions.
  */
+// 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 = null;
+let utilPromise = null;
 export function createDebugLogger(enabled) {
     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, data) => {
-        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);
+        }
     };
 }
 export function censorHeaders(headers) {

package/dist/index.cjs

@@ -1082,6 +1082,18 @@ zod.z.object({
   links: NeedChoicesResponseLinksSchema.optional()
 });
 
+// src/utils/string-utils.ts
+function toTitleCase(input) {
+  return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_\-]+/g, " ").replace(/\s+/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
+function toSnakeCase(input) {
+  let result = input.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[\s\-]+/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "").toLowerCase();
+  if (/^[0-9]/.test(result)) {
+    result = "_" + result;
+  }
+  return result;
+}
+
 // src/schemas/App.ts
 var AppItemSchema = withFormatter(
   ImplementationMetaSchema.omit({ name: true, id: true }).extend({
@@ -1094,10 +1106,18 @@ var AppItemSchema = withFormatter(
   }),
   {
     format: (item) => {
+      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: []
       };
@@ -1119,15 +1139,11 @@ function normalizeImplementationMetaToAppItem(implementationMeta) {
   const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
   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
   };
 }
 function normalizeAuthenticationItem(auth, options = {}) {
@@ -1773,11 +1789,6 @@ var RootFieldItemSchema = zod.z.union([
   FieldsetItemSchema
 ]);
 
-// src/utils/string-utils.ts
-function toTitleCase(input) {
-  return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_\-]+/g, " ").replace(/\s+/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
-}
-
 // src/plugins/listInputFields/index.ts
 function getInputFieldTypeFromNeed(need) {
   if (need.list) {
@@ -1877,7 +1888,7 @@ function transformNeedsToFields(needs) {
   }
   return rootFields;
 }
-var listInputFieldsPlugin = ({ context }) => {
+var listInputFieldsPlugin = ({ sdk, context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(options) {
       const { api, getVersionedImplementationId } = context;
@@ -1889,9 +1900,14 @@ var listInputFieldsPlugin = ({ context }) => {
           { configType: "current_implementation_id" }
         );
       }
+      const { data: action } = await sdk.getAction({
+        appKey,
+        actionType,
+        actionKey
+      });
       const needsRequest = {
         selected_api: selectedApi,
-        action: actionKey,
+        action: action.key,
         type_of: actionType,
         params: inputs || {}
       };
@@ -2132,7 +2148,7 @@ var getActionPlugin = ({ sdk }) => {
     const { actionKey, actionType, appKey } = options;
     const actionsResult = await sdk.listActions({ appKey });
     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 };
       }
     }
@@ -2337,6 +2353,7 @@ async function executeAction(actionOptions) {
     api,
     context,
     appKey,
+    actionId,
     actionKey,
     actionType,
     executionOptions,
@@ -2351,6 +2368,7 @@ async function executeAction(actionOptions) {
   }
   const runRequestData = {
     selected_api: selectedApi,
+    action_id: actionId,
     action_key: actionKey,
     action_type: actionType,
     inputs: executionOptions.inputs || {}
@@ -2392,10 +2410,14 @@ var runActionPlugin = ({ sdk, context }) => {
         `Action type mismatch: expected ${actionType}, got ${actionData.data.action_type}`
       );
     }
+    const actionId = actionData.data.id;
     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 },
@@ -2940,13 +2962,37 @@ function getAuthorizationHeader(token) {
 }
 
 // src/api/debug.ts
+var utilModule = null;
+var utilPromise = null;
 function createDebugLogger(enabled) {
   if (!enabled) {
     return () => {
     };
   }
+  if (!utilPromise) {
+    utilPromise = import('util').then((util) => {
+      utilModule = util;
+      return util;
+    }).catch(() => {
+      utilModule = null;
+      return null;
+    });
+  }
   return (message, data) => {
-    console.log(`[Zapier SDK] ${message}`, data || "");
+    if (data === void 0 || data === "") {
+      console.log(`[Zapier SDK] ${message}`);
+      return;
+    }
+    if (utilModule) {
+      const formatted = utilModule.inspect(data, {
+        colors: true,
+        depth: null,
+        breakLength: 80
+      });
+      console.log(`[Zapier SDK] ${message}`, formatted);
+    } else {
+      console.log(`[Zapier SDK] ${message}`, data);
+    }
   };
 }
 function censorHeaders(headers) {
@@ -3882,3 +3928,5 @@ exports.readManifestFromFile = readManifestFromFile;
 exports.registryPlugin = registryPlugin;
 exports.requestPlugin = requestPlugin;
 exports.runActionPlugin = runActionPlugin;
+exports.toSnakeCase = toSnakeCase;
+exports.toTitleCase = toTitleCase;

package/dist/index.d.mts

@@ -1947,7 +1947,7 @@ interface ListInputFieldsPluginProvides {
         };
     };
 }
-declare const listInputFieldsPlugin: Plugin<GetSdkType<GetAppPluginProvides>, // requires getApp in SDK
+declare const listInputFieldsPlugin: Plugin<GetSdkType<GetAppPluginProvides & GetActionPluginProvides>, // requires getApp and getAction in SDK
 {
     api: ApiClient;
     getVersionedImplementationId: GetVersionedImplementationId;
@@ -2885,6 +2885,27 @@ type ParamsProperty = z.infer<typeof ParamsPropertySchema>;
  */
 declare function createFunction<TOptions, TResult, TSchemaOptions extends TOptions = TOptions>(coreFn: (options: TOptions) => Promise<TResult>, schema?: z.ZodSchema<TSchemaOptions>): (options?: TOptions) => Promise<TResult>;
 
+/**
+ * String utility functions for the Zapier SDK
+ */
+/**
+ * Converts a string to title case, handling various input formats:
+ * - camelCase: "firstName" → "First Name"
+ * - snake_case: "first_name" → "First Name"
+ * - kebab-case: "first-name" → "First Name"
+ * - mixed formats: "first_name-value" → "First Name Value"
+ */
+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"
+ */
+declare function toSnakeCase(input: string): string;
+
 declare const appKeyResolver: StaticResolver;
 
 interface ActionTypeItem {
@@ -3081,4 +3102,4 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk
 }>;
 declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 
-export { type Action, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type Choice, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type ErrorOptions, type EventCallback, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindUniqueAuthenticationPluginProvides, type FormatMetadata, type FormattedItem, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, type ManifestPluginOptions, type ManifestPluginProvides, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type UserProfile, type UserProfileItem, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin };
+export { type Action, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type Choice, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type ErrorOptions, type EventCallback, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindUniqueAuthenticationPluginProvides, type FormatMetadata, type FormattedItem, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, type ManifestPluginOptions, type ManifestPluginProvides, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type UserProfile, type UserProfileItem, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export type { Action, App, Need, Field, Choice, ActionExecutionResult, ActionFie
 export { isPositional, PositionalMetadata } from "./utils/schema-utils";
 export { createFunction } from "./utils/function-utils";
 export type { FormattedItem, FormatMetadata } from "./utils/schema-utils";
+export { toSnakeCase, toTitleCase } from "./utils/string-utils";
 export * from "./resolvers";
 export * from "./auth";
 export { RelayRequestSchema, RelayFetchSchema, } from "./plugins/request/schemas";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAIvB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAIvB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -22,6 +22,8 @@ export * from "./plugins/api";
 // Export schema utilities for CLI
 export { isPositional } from "./utils/schema-utils";
 export { createFunction } from "./utils/function-utils";
+// Export string utilities
+export { toSnakeCase, toTitleCase } from "./utils/string-utils";
 // Export resolver utilities for CLI
 export * from "./resolvers";
 // Export auth utilities for CLI use

package/dist/index.mjs

@@ -1080,6 +1080,18 @@ z.object({
   links: NeedChoicesResponseLinksSchema.optional()
 });
 
+// src/utils/string-utils.ts
+function toTitleCase(input) {
+  return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_\-]+/g, " ").replace(/\s+/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
+function toSnakeCase(input) {
+  let result = input.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[\s\-]+/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "").toLowerCase();
+  if (/^[0-9]/.test(result)) {
+    result = "_" + result;
+  }
+  return result;
+}
+
 // src/schemas/App.ts
 var AppItemSchema = withFormatter(
   ImplementationMetaSchema.omit({ name: true, id: true }).extend({
@@ -1092,10 +1104,18 @@ var AppItemSchema = withFormatter(
   }),
   {
     format: (item) => {
+      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: []
       };
@@ -1117,15 +1137,11 @@ function normalizeImplementationMetaToAppItem(implementationMeta) {
   const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
   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
   };
 }
 function normalizeAuthenticationItem(auth, options = {}) {
@@ -1771,11 +1787,6 @@ var RootFieldItemSchema = z.union([
   FieldsetItemSchema
 ]);
 
-// src/utils/string-utils.ts
-function toTitleCase(input) {
-  return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_\-]+/g, " ").replace(/\s+/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
-}
-
 // src/plugins/listInputFields/index.ts
 function getInputFieldTypeFromNeed(need) {
   if (need.list) {
@@ -1875,7 +1886,7 @@ function transformNeedsToFields(needs) {
   }
   return rootFields;
 }
-var listInputFieldsPlugin = ({ context }) => {
+var listInputFieldsPlugin = ({ sdk, context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(options) {
       const { api, getVersionedImplementationId } = context;
@@ -1887,9 +1898,14 @@ var listInputFieldsPlugin = ({ context }) => {
           { configType: "current_implementation_id" }
         );
       }
+      const { data: action } = await sdk.getAction({
+        appKey,
+        actionType,
+        actionKey
+      });
       const needsRequest = {
         selected_api: selectedApi,
-        action: actionKey,
+        action: action.key,
         type_of: actionType,
         params: inputs || {}
       };
@@ -2130,7 +2146,7 @@ var getActionPlugin = ({ sdk }) => {
     const { actionKey, actionType, appKey } = options;
     const actionsResult = await sdk.listActions({ appKey });
     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 };
       }
     }
@@ -2335,6 +2351,7 @@ async function executeAction(actionOptions) {
     api,
     context,
     appKey,
+    actionId,
     actionKey,
     actionType,
     executionOptions,
@@ -2349,6 +2366,7 @@ async function executeAction(actionOptions) {
   }
   const runRequestData = {
     selected_api: selectedApi,
+    action_id: actionId,
     action_key: actionKey,
     action_type: actionType,
     inputs: executionOptions.inputs || {}
@@ -2390,10 +2408,14 @@ var runActionPlugin = ({ sdk, context }) => {
         `Action type mismatch: expected ${actionType}, got ${actionData.data.action_type}`
       );
     }
+    const actionId = actionData.data.id;
     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 },
@@ -2938,13 +2960,37 @@ function getAuthorizationHeader(token) {
 }
 
 // src/api/debug.ts
+var utilModule = null;
+var utilPromise = null;
 function createDebugLogger(enabled) {
   if (!enabled) {
     return () => {
     };
   }
+  if (!utilPromise) {
+    utilPromise = import('util').then((util) => {
+      utilModule = util;
+      return util;
+    }).catch(() => {
+      utilModule = null;
+      return null;
+    });
+  }
   return (message, data) => {
-    console.log(`[Zapier SDK] ${message}`, data || "");
+    if (data === void 0 || data === "") {
+      console.log(`[Zapier SDK] ${message}`);
+      return;
+    }
+    if (utilModule) {
+      const formatted = utilModule.inspect(data, {
+        colors: true,
+        depth: null,
+        breakLength: 80
+      });
+      console.log(`[Zapier SDK] ${message}`, formatted);
+    } else {
+      console.log(`[Zapier SDK] ${message}`, data);
+    }
   };
 }
 function censorHeaders(headers) {
@@ -3818,4 +3864,4 @@ function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
 }
 
-export { ActionKeyPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin };
+export { ActionKeyPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/getAction/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,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAQhE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,SAAS,EAAE;gBACT,WAAW,EAAE,OAAO,eAAe,CAAC;aACrC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,UAAU,CAAC,yBAAyB,CAAC,EAAE,8BAA8B;AACrE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,EAAE,0BAA0B;AAC9C,uBAAuB,CA2CxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/getAction/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,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAQhE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,SAAS,EAAE;gBACT,WAAW,EAAE,OAAO,eAAe,CAAC;aACrC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,UAAU,CAAC,yBAAyB,CAAC,EAAE,8BAA8B;AACrE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,EAAE,0BAA0B;AAC9C,uBAAuB,CA8CxB,CAAC"}

package/dist/plugins/getAction/index.js

@@ -8,9 +8,10 @@ export const getActionPlugin = ({ sdk }) => {
         const { actionKey, actionType, appKey } = options;
         // 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/dist/plugins/listInputFields/index.d.ts

@@ -3,6 +3,7 @@ import type { ApiClient } from "../../api";
 import type { InputFieldItem, InfoFieldItem, FieldsetItem, RootFieldItem } from "../../types/domain";
 import { ListInputFieldsSchema, type ListInputFieldsOptions } from "./schemas";
 import type { GetAppPluginProvides } from "../getApp";
+import type { GetActionPluginProvides } from "../getAction";
 import type { GetVersionedImplementationId } from "../manifest/schemas";
 export interface ListInputFieldsPluginProvides {
     listInputFields: (options?: ListInputFieldsOptions) => Promise<{
@@ -22,7 +23,7 @@ export interface ListInputFieldsPluginProvides {
         };
     };
 }
-export declare const listInputFieldsPlugin: Plugin<GetSdkType<GetAppPluginProvides>, // requires getApp in SDK
+export declare const listInputFieldsPlugin: Plugin<GetSdkType<GetAppPluginProvides & GetActionPluginProvides>, // requires getApp and getAction in SDK
 {
     api: ApiClient;
     getVersionedImplementationId: GetVersionedImplementationId;

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,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,CAAC,EAAE,yBAAyB;AAC3D;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,6BAA6B,CAmF9B,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;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"}

package/dist/plugins/listInputFields/index.js

@@ -142,7 +142,7 @@ function transformNeedsToFields(needs) {
     }
     return rootFields;
 }
-export const listInputFieldsPlugin = ({ context }) => {
+export const listInputFieldsPlugin = ({ sdk, context }) => {
     const listInputFields = createPaginatedFunction(async function listInputFieldsPage(options) {
         // Note: This function ignores pageSize and cursor since it's not actually paginated internally
         const { api, getVersionedImplementationId } = context;
@@ -153,10 +153,15 @@ export const listInputFieldsPlugin = ({ context }) => {
         if (!selectedApi) {
             throw new ZapierConfigurationError("No current_implementation_id found for app", { configType: "current_implementation_id" });
         }
+        const { data: action } = await sdk.getAction({
+            appKey,
+            actionType,
+            actionKey,
+        });
         // Build needs request
         const needsRequest = {
             selected_api: selectedApi,
-            action: actionKey,
+            action: action.key,
             type_of: actionType,
             params: inputs || {},
         };