@zapier/zapier-sdk 0.13.0 → 0.13.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 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
+
+- a607e3a: Fixes a bug where listApps would return all apps if no appKeys were resolved to app locators. This in turn fixes the `add` command hanging when using only invalid app keys (since it would try to add all apps), and it fixes getApp which returned the first app of all apps for an invalid slug, since it just calls to listApps.
+
 ## 0.13.0
 
 ### Minor Changes

package/README.md

@@ -30,9 +30,14 @@
 ## Installation
 
 ```bash
+# If starting a new project:
+cd your-project-dir
+npm init -y
+npx tsc --init
+# Also, set `"type": "module"` in your package.json for the code examples below.
+
 npm install @zapier/zapier-sdk
 npm install -D @zapier/zapier-sdk-cli @types/node typescript
-npx tsc --init
 ```
 
 ## Quick Start
@@ -41,15 +46,22 @@ npx tsc --init
 # Authenticates through your browser, automatically handling token management
 npx zapier-sdk login
 
-# Generate TypeScript types for the request/response signatures of apps.
-# By default, the types will be generated inside of your `src` folder, if you have one, or the root folder.
-# To use these types, ensure they are added to your `tsconfig.json` file.
+# Generate TypeScript types for actions and fields of any apps you want to use.
+npx zapier-sdk add slack google-sheets
 
-# Single app
-npx zapier-sdk add slack --types-output ./types/slack.ts
+# 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"
 
-# Multiple apps
-npx zapier-sdk add slack github trello
+# 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 google-sheets --types-output ./types
 ```
 
 ```typescript
@@ -94,7 +106,7 @@ for await (const app of zapier.listApps({ maxItems: 100 }).items()) {
 
 // You can collect all results, but this could take a while for long lists!
 const allApps = await Array.fromAsync(
-  zapier.listApps({ maxItems: 1000 }).items(),
+  zapier.listApps({ maxItems: 100 }).items(),
 );
 
 console.log({
@@ -115,6 +127,10 @@ const { data: myAuths } = await zapier.listAuthentications({
   owner: "me",
 });
 
+console.log({
+  myAuths,
+});
+
 // ######## Find Actions ########
 // Option 1: List actions
 // Remember, this is just the first page which may not include them all!
@@ -157,7 +173,13 @@ console.log({
 const { data: profile } = await zapier.getProfile();
 
 // Option 2:
-const { data: users } = await zapier.apps.slack.search.user_by_email({
+// Create an app binding to your authentication.
+const mySlack = zapier.apps.slack({
+  authenticationId: myAuths[0].id,
+});
+
+// Use your app binding to run the action.
+const { data: users } = await mySlack.search.user_by_email({
   inputs: {
     email: profile.email,
   },
@@ -166,6 +188,23 @@ const { data: users } = await zapier.apps.slack.search.user_by_email({
 console.log({
   users,
 });
+
+// You can also skip the app binding and pass the auth into the action.
+const { data: sameUsers } = await zapier.apps.slack.search.user_by_email({
+  inputs: {
+    email: profile.email,
+  },
+  authenticationId: myAuths[0].id,
+});
+
+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/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 = {}) {
@@ -1235,10 +1251,10 @@ function toImplementationId(appLocator) {
 // src/plugins/listApps/index.ts
 var listAppsPlugin = ({ context }) => {
   const listApps = createPaginatedFunction(async function listAppsPage(options) {
-    const api = context.api;
-    const opts = options;
-    const appLocators = await context.resolveAppKeys({
-      appKeys: [...opts.appKeys ?? []]
+    const { api, resolveAppKeys: resolveAppKeys2 } = context;
+    const appKeys = options.appKeys ?? [];
+    const appLocators = await resolveAppKeys2({
+      appKeys: [...appKeys]
     });
     const implementationNameToLocator = {};
     for (const locator of appLocators) {
@@ -1253,9 +1269,9 @@ var listAppsPlugin = ({ context }) => {
         `Duplicate lookup app keys found: ${duplicatedLookupAppKeys.join(", ")}`
       );
     }
-    if (opts.search) {
+    if (options.search) {
       const searchParams2 = {};
-      searchParams2.term = opts.search;
+      searchParams2.term = options.search;
       const searchEnvelope = await api.get(
         "/api/v4/implementations-meta/search/",
         {
@@ -1280,16 +1296,22 @@ var listAppsPlugin = ({ context }) => {
       }
     }
     const searchParams = {};
-    if (opts.pageSize) {
-      searchParams.limit = opts.pageSize.toString();
+    if (options.pageSize) {
+      searchParams.limit = options.pageSize.toString();
     }
     if (appLocators.length === 0) {
       searchParams.latest_only = "true";
     }
-    if (opts.cursor) {
-      searchParams.offset = opts.cursor;
+    if (options.cursor) {
+      searchParams.offset = options.cursor;
     }
     searchParams.selected_apis = appLocators.map((locator) => toImplementationId(locator)).join(",");
+    if (appKeys.length > 0 && appLocators.length === 0) {
+      return {
+        data: [],
+        nextCursor: void 0
+      };
+    }
     const implementationsEnvelope = await api.get(
       "/api/v4/implementations-meta/lookup/",
       {
@@ -1767,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) {
@@ -3876,3 +3893,5 @@ exports.readManifestFromFile = readManifestFromFile;
 exports.registryPlugin = registryPlugin;
 exports.requestPlugin = requestPlugin;
 exports.runActionPlugin = runActionPlugin;
+exports.toSnakeCase = toSnakeCase;
+exports.toTitleCase = toTitleCase;

package/dist/index.d.mts

@@ -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 = {}) {
@@ -1233,10 +1249,10 @@ function toImplementationId(appLocator) {
 // src/plugins/listApps/index.ts
 var listAppsPlugin = ({ context }) => {
   const listApps = createPaginatedFunction(async function listAppsPage(options) {
-    const api = context.api;
-    const opts = options;
-    const appLocators = await context.resolveAppKeys({
-      appKeys: [...opts.appKeys ?? []]
+    const { api, resolveAppKeys: resolveAppKeys2 } = context;
+    const appKeys = options.appKeys ?? [];
+    const appLocators = await resolveAppKeys2({
+      appKeys: [...appKeys]
     });
     const implementationNameToLocator = {};
     for (const locator of appLocators) {
@@ -1251,9 +1267,9 @@ var listAppsPlugin = ({ context }) => {
         `Duplicate lookup app keys found: ${duplicatedLookupAppKeys.join(", ")}`
       );
     }
-    if (opts.search) {
+    if (options.search) {
       const searchParams2 = {};
-      searchParams2.term = opts.search;
+      searchParams2.term = options.search;
       const searchEnvelope = await api.get(
         "/api/v4/implementations-meta/search/",
         {
@@ -1278,16 +1294,22 @@ var listAppsPlugin = ({ context }) => {
       }
     }
     const searchParams = {};
-    if (opts.pageSize) {
-      searchParams.limit = opts.pageSize.toString();
+    if (options.pageSize) {
+      searchParams.limit = options.pageSize.toString();
     }
     if (appLocators.length === 0) {
       searchParams.latest_only = "true";
     }
-    if (opts.cursor) {
-      searchParams.offset = opts.cursor;
+    if (options.cursor) {
+      searchParams.offset = options.cursor;
     }
     searchParams.selected_apis = appLocators.map((locator) => toImplementationId(locator)).join(",");
+    if (appKeys.length > 0 && appLocators.length === 0) {
+      return {
+        data: [],
+        nextCursor: void 0
+      };
+    }
     const implementationsEnvelope = await api.get(
       "/api/v4/implementations-meta/lookup/",
       {
@@ -1765,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) {
@@ -3812,4 +3829,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/getApp/index.test.js

@@ -36,8 +36,11 @@ describe("getApp plugin", () => {
         it("should pass validation with valid appKey", async () => {
             const sdk = createTestSdk();
             const context = sdk.getContext();
-            // Mock the API client in context to respond to listApps implementation
-            context.api.get = vi.fn().mockResolvedValue({
+            // Mock the API client to handle both resolveAppKeys and listApps calls
+            context.api.get = vi
+                .fn()
+                // First call: resolveAppKeys may call to resolve slug to implementation name
+                .mockResolvedValueOnce({
                 results: [
                     {
                         id: "SlackCLIAPI@1.0.0",
@@ -45,6 +48,25 @@ describe("getApp plugin", () => {
                         description: "Team communication",
                         primary_color: "#4A154B",
                         categories: ["communication"],
+                        slug: "slack",
+                        key: "SlackCLIAPI",
+                        version: "1.0.0",
+                    },
+                ],
+                next: null,
+            })
+                // Second call: listApps main API call
+                .mockResolvedValueOnce({
+                results: [
+                    {
+                        id: "SlackCLIAPI@1.0.0",
+                        name: "Slack",
+                        description: "Team communication",
+                        primary_color: "#4A154B",
+                        categories: ["communication"],
+                        slug: "slack",
+                        key: "SlackCLIAPI",
+                        version: "1.0.0",
                     },
                 ],
                 next: null,
@@ -62,8 +84,16 @@ describe("getApp plugin", () => {
         it("should throw ZapierAppNotFoundError when app does not exist", async () => {
             const sdk = createTestSdk();
             const context = sdk.getContext();
-            // Mock API to return empty results (app not found)
-            context.api.get = vi.fn().mockResolvedValue({
+            // Mock API to return empty results for both potential calls
+            context.api.get = vi
+                .fn()
+                // First call: resolveAppKeys may call to resolve slug
+                .mockResolvedValueOnce({
+                results: [],
+                next: null,
+            })
+                // Second call: listApps main API call
+                .mockResolvedValueOnce({
                 results: [],
                 next: null,
             });
@@ -76,8 +106,27 @@ describe("getApp plugin", () => {
         it("should return essential app properties", async () => {
             const sdk = createTestSdk();
             const context = sdk.getContext();
-            // Mock the API client in context to respond to listApps implementation
-            context.api.get = vi.fn().mockResolvedValue({
+            // Mock the API client to handle both resolveAppKeys and listApps calls
+            context.api.get = vi
+                .fn()
+                // First call: resolveAppKeys may call to resolve slug to implementation name
+                .mockResolvedValueOnce({
+                results: [
+                    {
+                        id: "TestCLIAPI@1.0.0",
+                        name: "Test App",
+                        description: "Test description",
+                        primary_color: "#FF0000",
+                        categories: ["testing"],
+                        slug: "test",
+                        key: "TestCLIAPI",
+                        version: "1.0.0",
+                    },
+                ],
+                next: null,
+            })
+                // Second call: listApps main API call
+                .mockResolvedValueOnce({
                 results: [
                     {
                         id: "TestCLIAPI@1.0.0",
@@ -85,6 +134,9 @@ describe("getApp plugin", () => {
                         description: "Test description",
                         primary_color: "#FF0000",
                         categories: ["testing"],
+                        slug: "test",
+                        key: "TestCLIAPI",
+                        version: "1.0.0",
                     },
                 ],
                 next: null,

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listApps/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAWlD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC;QAC/C,IAAI,EAAE,OAAO,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACxD,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;KACjC,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,QAAQ,EAAE;gBACR,WAAW,EAAE,OAAO,cAAc,CAAC;aACpC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,EAAE,EACF,cAAc,CAAC,iBAAiB,GAAG,sBAAsB,CAAC,EAC1D,sBAAsB,CA+GvB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listApps/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAWlD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC;QAC/C,IAAI,EAAE,OAAO,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACxD,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;KACjC,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,QAAQ,EAAE;gBACR,WAAW,EAAE,OAAO,cAAc,CAAC;aACpC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,EAAE,EACF,cAAc,CAAC,iBAAiB,GAAG,sBAAsB,CAAC,EAC1D,sBAAsB,CAwHvB,CAAC"}

package/dist/plugins/listApps/index.js

@@ -5,10 +5,10 @@ import { normalizeImplementationMetaToAppItem, splitVersionedKey, toAppLocator,
 import { extractCursor } from "../../utils/function-utils";
 export const listAppsPlugin = ({ context }) => {
     const listApps = createPaginatedFunction(async function listAppsPage(options) {
-        const api = context.api;
-        const opts = options;
-        const appLocators = await context.resolveAppKeys({
-            appKeys: [...(opts.appKeys ?? [])],
+        const { api, resolveAppKeys } = context;
+        const appKeys = options.appKeys ?? [];
+        const appLocators = await resolveAppKeys({
+            appKeys: [...appKeys],
         });
         const implementationNameToLocator = {};
         for (const locator of appLocators) {
@@ -25,9 +25,9 @@ export const listAppsPlugin = ({ context }) => {
         if (duplicatedLookupAppKeys.length > 0) {
             throw new Error(`Duplicate lookup app keys found: ${duplicatedLookupAppKeys.join(", ")}`);
         }
-        if (opts.search) {
+        if (options.search) {
             const searchParams = {};
-            searchParams.term = opts.search;
+            searchParams.term = options.search;
             const searchEnvelope = await api.get("/api/v4/implementations-meta/search/", {
                 searchParams,
             });
@@ -45,18 +45,26 @@ export const listAppsPlugin = ({ context }) => {
             }
         }
         const searchParams = {};
-        if (opts.pageSize) {
-            searchParams.limit = opts.pageSize.toString();
+        if (options.pageSize) {
+            searchParams.limit = options.pageSize.toString();
         }
         if (appLocators.length === 0) {
             searchParams.latest_only = "true";
         }
-        if (opts.cursor) {
-            searchParams.offset = opts.cursor;
+        if (options.cursor) {
+            searchParams.offset = options.cursor;
         }
         searchParams.selected_apis = appLocators
             .map((locator) => toImplementationId(locator))
             .join(",");
+        // If we have app keys, but they resolved to an empty list, then we need to short-circuit and return an empty list.
+        // Otherwise, the API will return all apps, since no selected_apis are provided.
+        if (appKeys.length > 0 && appLocators.length === 0) {
+            return {
+                data: [],
+                nextCursor: undefined,
+            };
+        }
         const implementationsEnvelope = await api.get("/api/v4/implementations-meta/lookup/", {
             searchParams,
         });

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: [],
         };