@zapier/zapier-sdk 0.13.0 → 0.13.2

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.0",
+  "version": "0.13.2",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",

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/getApp/index.test.ts

@@ -52,19 +52,41 @@ describe("getApp plugin", () => {
       const sdk = createTestSdk();
       const context = sdk.getContext();
 
-      // Mock the API client in context to respond to listApps implementation
-      (context.api as any).get = vi.fn().mockResolvedValue({
-        results: [
-          {
-            id: "SlackCLIAPI@1.0.0",
-            name: "Slack",
-            description: "Team communication",
-            primary_color: "#4A154B",
-            categories: ["communication"],
-          },
-        ],
-        next: null,
-      });
+      // Mock the API client to handle both resolveAppKeys and listApps calls
+      (context.api as any).get = vi
+        .fn()
+        // First call: resolveAppKeys may call to resolve slug to implementation name
+        .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,
+        })
+        // 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,
+        });
 
       const result = await sdk.getApp({
         appKey: "slack",
@@ -82,11 +104,19 @@ describe("getApp plugin", () => {
       const sdk = createTestSdk();
       const context = sdk.getContext();
 
-      // Mock API to return empty results (app not found)
-      (context.api as any).get = vi.fn().mockResolvedValue({
-        results: [],
-        next: null,
-      });
+      // Mock API to return empty results for both potential calls
+      (context.api as any).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,
+        });
 
       await expect(
         sdk.getApp({
@@ -101,19 +131,41 @@ describe("getApp plugin", () => {
       const sdk = createTestSdk();
       const context = sdk.getContext();
 
-      // Mock the API client in context to respond to listApps implementation
-      (context.api as any).get = vi.fn().mockResolvedValue({
-        results: [
-          {
-            id: "TestCLIAPI@1.0.0",
-            name: "Test App",
-            description: "Test description",
-            primary_color: "#FF0000",
-            categories: ["testing"],
-          },
-        ],
-        next: null,
-      });
+      // Mock the API client to handle both resolveAppKeys and listApps calls
+      (context.api as any).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",
+              name: "Test App",
+              description: "Test description",
+              primary_color: "#FF0000",
+              categories: ["testing"],
+              slug: "test",
+              key: "TestCLIAPI",
+              version: "1.0.0",
+            },
+          ],
+          next: null,
+        });
 
       const result = await sdk.getApp({
         appKey: "test",

package/src/plugins/listApps/index.ts

@@ -41,11 +41,11 @@ export const listAppsPlugin: Plugin<
   const listApps = createPaginatedFunction(async function listAppsPage(
     options: ListAppsOptions & { cursor?: string } & { pageSize: number },
   ): Promise<ListAppsPage> {
-    const api = context.api;
-    const opts = options;
+    const { api, resolveAppKeys } = context;
+    const appKeys = options.appKeys ?? [];
 
-    const appLocators = await context.resolveAppKeys({
-      appKeys: [...(opts.appKeys ?? [])],
+    const appLocators = await resolveAppKeys({
+      appKeys: [...appKeys],
     });
     const implementationNameToLocator: Record<string, ResolvedAppLocator[]> =
       {};
@@ -67,10 +67,10 @@ export const listAppsPlugin: Plugin<
       );
     }
 
-    if (opts.search) {
+    if (options.search) {
       const searchParams: Record<string, string> = {};
 
-      searchParams.term = opts.search;
+      searchParams.term = options.search;
 
       const searchEnvelope: ImplementationsMetaResponse = await api.get(
         "/api/v4/implementations-meta/search/",
@@ -101,22 +101,31 @@ export const listAppsPlugin: Plugin<
 
     const searchParams: Record<string, string> = {};
 
-    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: ImplementationsMetaResponse = await api.get(
       "/api/v4/implementations-meta/lookup/",
       {

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;
+}