@zapier/zapier-sdk 0.8.2 → 0.9.0

package/dist/plugins/apps/index.d.ts

@@ -8,4 +8,8 @@ export interface AppsPluginProvides {
 export declare const appsPlugin: Plugin<GetSdkType<FetchPluginProvides & RunActionPluginProvides>, // requires fetch + runAction in SDK
 {}, // no context requirements
 AppsPluginProvides>;
+export type { ActionExecutionOptions } from "./types";
+export type { ActionExecutionResult } from "../../api/types";
+export interface ZapierSdkApps {
+}
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AA4JD,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,UAAU,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,oCAAoC;AAC/F,EAAE,EAAE,0BAA0B;AAC9B,kBAAkB,CAMnB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,WAAW,EAAE,MAAM,SAAS,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AA4JD,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,UAAU,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,oCAAoC;AAC/F,EAAE,EAAE,0BAA0B;AAC9B,kBAAkB,CAMnB,CAAC;AAGF,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,WAAW,aAAa;CAAG"}

package/dist/plugins/getApp/index.d.ts

@@ -3,8 +3,7 @@ import { GetAppSchema } from "./schemas";
 import type { GetAppOptions } from "./schemas";
 import type { AppItem } from "../../types/domain";
 import type { GetSdkType } from "../../types/plugin";
-import type { GetImplementation } from "../manifest/schemas";
-import type { ManifestPluginProvides } from "../manifest";
+import type { ListAppsPluginProvides } from "../listApps";
 export interface GetAppPluginProvides {
     getApp: (options: GetAppOptions) => Promise<{
         data: AppItem;
@@ -17,9 +16,5 @@ export interface GetAppPluginProvides {
         };
     };
 }
-export declare const getAppPlugin: Plugin<GetSdkType<ManifestPluginProvides>, // depends on manifest plugin with getImplementation in context
-{
-    getImplementation: GetImplementation;
-}, //
-GetAppPluginProvides>;
+export declare const getAppPlugin: Plugin<GetSdkType<ListAppsPluginProvides>, {}, GetAppPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/getApp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/D,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,MAAM,EAAE;gBACN,WAAW,EAAE,OAAO,YAAY,CAAC;aAClC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAGD,eAAO,MAAM,YAAY,EAAE,MAAM,CAC/B,UAAU,CAAC,sBAAsB,CAAC,EAAE,+DAA+D;AACnG;IAAE,iBAAiB,EAAE,iBAAiB,CAAA;CAAE,EAAE,EAAE;AAC5C,oBAAoB,CA2BrB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/getApp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/D,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,MAAM,EAAE;gBACN,WAAW,EAAE,OAAO,YAAY,CAAC;aAClC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAGD,eAAO,MAAM,YAAY,EAAE,MAAM,CAC/B,UAAU,CAAC,sBAAsB,CAAC,EAClC,EAAE,EACF,oBAAoB,CA0BrB,CAAC"}

package/dist/plugins/getApp/index.js

@@ -2,17 +2,17 @@ import { createFunction } from "../../utils/function-utils";
 import { GetAppSchema } from "./schemas";
 import { ZapierAppNotFoundError } from "../../types/errors";
 // GetApp plugin depends on listApps SDK function
-export const getAppPlugin = ({ context }) => {
+export const getAppPlugin = ({ sdk }) => {
     const getApp = createFunction(async function getApp(options) {
-        const app = await context.getImplementation(options.appKey);
-        if (!app) {
-            throw new ZapierAppNotFoundError("App not found", {
-                appKey: options.appKey,
-            });
+        const appsIterator = sdk.listApps({ appKeys: [options.appKey] }).items();
+        for await (const app of appsIterator) {
+            return {
+                data: app,
+            };
         }
-        return {
-            data: app,
-        };
+        throw new ZapierAppNotFoundError("App not found", {
+            appKey: options.appKey,
+        });
     }, GetAppSchema);
     // Return flat structure - getApp goes directly to SDK
     return {

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

@@ -8,8 +8,8 @@ import { manifestPlugin } from "../manifest";
 function createTestSdk() {
     return createSdk()
         .addPlugin(apiPlugin, { fetch: global.fetch })
-        .addPlugin(listAppsPlugin)
         .addPlugin(manifestPlugin)
+        .addPlugin(listAppsPlugin)
         .addPlugin(getAppPlugin);
 }
 describe("getApp plugin", () => {

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

@@ -33,8 +33,8 @@ describe("getAuthentication plugin", () => {
     function createTestSdk() {
         return createSdk()
             .addPlugin(apiPlugin)
-            .addPlugin(listAppsPlugin)
             .addPlugin(manifestPlugin)
+            .addPlugin(listAppsPlugin)
             .addPlugin(getAuthenticationPlugin);
     }
     describe("schema validation", () => {

package/dist/plugins/listActions/index.d.ts

@@ -21,10 +21,8 @@ export interface ListActionsPluginProvides {
         };
     };
 }
-export declare const listActionsPlugin: Plugin<GetSdkType<ManifestPluginProvides>, // requires getApp in SDK
-{
+export declare const listActionsPlugin: Plugin<GetSdkType<ManifestPluginProvides>, {
     api: ApiClient;
     getVersionedImplementationId: GetVersionedImplementationId;
-}, // requires api and getVersionedImplementationId in context
-ListActionsPluginProvides>;
+}, ListActionsPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listActions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EAExB,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC;QACrD,IAAI,EAAE,UAAU,EAAE,CAAC;KACpB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC3D,KAAK,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;KACpC,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,WAAW,EAAE,OAAO,iBAAiB,CAAC;aACvC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,UAAU,CAAC,sBAAsB,CAAC,EAAE,yBAAyB;AAC7D;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,yBAAyB,CAkF1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listActions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EAExB,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC;QACrD,IAAI,EAAE,UAAU,EAAE,CAAC;KACpB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC3D,KAAK,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;KACpC,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,WAAW,EAAE,OAAO,iBAAiB,CAAC;aACvC,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,UAAU,CAAC,sBAAsB,CAAC,EAClC;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EACD,yBAAyB,CAkF1B,CAAC"}

package/dist/plugins/listActions/index.js

@@ -5,7 +5,7 @@ import { createPaginatedFunction } from "../../utils/function-utils";
 export const listActionsPlugin = ({ context }) => {
     const listActions = createPaginatedFunction(async function listActionsPage(options) {
         const { api, getVersionedImplementationId } = context;
-        // Use the getApp function from the SDK (dependency injection)
+        // Use getVersionedImplementationId (optimized to check manifest first)
         const selectedApi = await getVersionedImplementationId(options.appKey);
         if (!selectedApi) {
             throw new ZapierConfigurationError("No current_implementation_id found for app", { configType: "current_implementation_id" });

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

@@ -55,6 +55,7 @@ describe("listActions plugin", () => {
             .fn()
             .mockResolvedValue("SlackCLIAPI@1.21.1");
     });
+    const mockResolveAppKeys = vi.fn().mockResolvedValue([]);
     function createTestSdk() {
         // Create a proper plugin chain with context dependencies
         // Build SDK with proper plugin composition, providing API in initial context
@@ -62,18 +63,17 @@ describe("listActions plugin", () => {
             .addPlugin(() => ({
             context: {
                 api: mockApiClient,
-                getVersionedImplementationId: mockGetVersionedImplementationId,
             },
         }))
-            .addPlugin(listAppsPlugin)
             .addPlugin(() => ({
             context: {
                 manifest: null,
-                getManifestEntry: () => null,
                 getVersionedImplementationId: mockGetVersionedImplementationId,
-                getImplementation: () => Promise.resolve(null),
+                resolveAppKeys: mockResolveAppKeys,
+                updateManifestEntry: vi.fn().mockResolvedValue(["test-key", {}]),
             },
         }))
+            .addPlugin(listAppsPlugin)
             .addPlugin(listActionsPlugin);
     }
     describe("schema validation", () => {

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

@@ -1,8 +1,9 @@
-import type { Plugin } from "../../types/plugin";
-import type { ApiClient } from "../../api/types";
+import type { GetContextType, Plugin } from "../../types/plugin";
 import { ListAppsSchema } from "./schemas";
 import type { ListAppsOptions } from "./schemas";
 import type { AppItem } from "../../types/domain";
+import type { ManifestPluginProvides } from "../manifest";
+import type { ApiPluginProvides } from "../api";
 export interface ListAppsPluginProvides {
     listApps: (options?: ListAppsOptions) => Promise<{
         data: AppItem[];
@@ -20,9 +21,5 @@ export interface ListAppsPluginProvides {
         };
     };
 }
-export declare const listAppsPlugin: Plugin<{}, // no SDK dependencies
-{
-    api: ApiClient;
-}, // requires api in context
-ListAppsPluginProvides>;
+export declare const listAppsPlugin: Plugin<{}, GetContextType<ApiPluginProvides & ManifestPluginProvides>, ListAppsPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,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;AASlD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GACnE,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;AAGD,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,EAAE,EAAE,sBAAsB;AAC1B;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,EAAE,0BAA0B;AAC9C,sBAAsB,CAyFvB,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;AAUlD,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;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GACnE,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,CA4GvB,CAAC"}

package/dist/plugins/listApps/index.js

@@ -1,13 +1,29 @@
 import { createPaginatedFunction } from "../../utils/function-utils";
 import { ListAppsSchema } from "./schemas";
-import { groupAppKeysByType, normalizeImplementationMetaToAppItem, splitVersionedKey, } from "../../utils/domain-utils";
+import { normalizeImplementationMetaToAppItem, splitVersionedKey, toAppLocator, toImplementationId, } from "../../utils/domain-utils";
 import { extractCursor } from "../../utils/function-utils";
-// Direct plugin function - takes options + sdk + context in one object
 export const listAppsPlugin = ({ context }) => {
     const listApps = createPaginatedFunction(async function listAppsPage(options) {
         const api = context.api;
         const opts = options;
-        const appKeys = [...(opts.appKeys ?? [])].map((key) => splitVersionedKey(key)[0]);
+        const appLocators = await context.resolveAppKeys({
+            appKeys: [...(opts.appKeys ?? [])],
+        });
+        const implementationNameToLocator = {};
+        for (const locator of appLocators) {
+            implementationNameToLocator[locator.implementationName] = [
+                ...(implementationNameToLocator[locator.implementationName] ?? []),
+                locator,
+            ];
+        }
+        const duplicatedLookupAppKeys = Object.keys(implementationNameToLocator)
+            .filter((key) => implementationNameToLocator[key].length > 1)
+            .map((key) => implementationNameToLocator[key])
+            .flat()
+            .map((locator) => locator.lookupAppKey);
+        if (duplicatedLookupAppKeys.length > 0) {
+            throw new Error(`Duplicate lookup app keys found: ${duplicatedLookupAppKeys.join(", ")}`);
+        }
         if (opts.search) {
             const searchParams = {};
             searchParams.term = opts.search;
@@ -15,11 +31,15 @@ export const listAppsPlugin = ({ context }) => {
                 searchParams,
             });
             const implementations = searchEnvelope.results.map(normalizeImplementationMetaToAppItem);
-            const appKeysSet = new Set(appKeys);
+            const implementationNameSet = new Set(appLocators.map((locator) => locator.implementationName));
             for (const implementation of implementations) {
-                if (!appKeysSet.has(implementation.key)) {
-                    appKeysSet.add(implementation.key);
-                    appKeys.push(implementation.key);
+                const [implementationName] = splitVersionedKey(implementation.key);
+                if (!implementationNameSet.has(implementationName)) {
+                    implementationNameSet.add(implementationName);
+                    appLocators.push({
+                        ...toAppLocator(implementation.key),
+                        implementationName,
+                    });
                 }
             }
         }
@@ -27,19 +47,15 @@ export const listAppsPlugin = ({ context }) => {
         if (opts.pageSize) {
             searchParams.limit = opts.pageSize.toString();
         }
-        searchParams.latest_only = "true";
+        if (appLocators.length === 0) {
+            searchParams.latest_only = "true";
+        }
         if (opts.cursor) {
             searchParams.offset = opts.cursor;
         }
-        if (appKeys.length > 0) {
-            const groupedAppKeys = groupAppKeysByType(appKeys);
-            if (groupedAppKeys.selectedApi.length > 0) {
-                searchParams.selected_apis = groupedAppKeys.selectedApi.join(",");
-            }
-            if (groupedAppKeys.slug.length > 0) {
-                searchParams.slugs = groupedAppKeys.slug.join(",");
-            }
-        }
+        searchParams.selected_apis = appLocators
+            .map((locator) => toImplementationId(locator))
+            .join(",");
         const implementationsEnvelope = await api.get("/api/v4/implementations-meta/lookup/", {
             searchParams,
         });

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

@@ -26,9 +26,25 @@ const mockAppsResponse = {
         next_cursor: null,
     },
 };
+const mockResolveAppKeys = vi
+    .fn()
+    .mockImplementation(async ({ appKeys }) => {
+    // Mock implementation that returns resolved locators for the app keys
+    return appKeys.map((appKey) => ({
+        lookupAppKey: appKey,
+        implementationName: appKey, // For testing, use appKey as implementationName
+        slug: appKey.toLowerCase(),
+        version: undefined,
+    }));
+});
 function createTestSdk() {
     return createSdk()
         .addPlugin(apiPlugin, { fetch: global.fetch })
+        .addPlugin(() => ({
+        context: {
+            resolveAppKeys: mockResolveAppKeys,
+        },
+    }))
         .addPlugin(listAppsPlugin);
 }
 describe("listApps plugin", () => {
@@ -88,7 +104,11 @@ describe("listApps plugin", () => {
                 title: "Slack",
             });
             expect(context.api.get).toHaveBeenCalledWith("/api/v4/implementations-meta/lookup/", {
-                searchParams: { latest_only: "true", limit: "100" },
+                searchParams: {
+                    latest_only: "true",
+                    limit: "100",
+                    selected_apis: "",
+                },
             });
         });
         it("should throw validation error for invalid pageSize", () => {
@@ -297,7 +317,7 @@ describe("listApps plugin", () => {
             await sdk.listApps({ appKeys: ["SlackCLIAPI", "GitHubCLIAPI"] });
             expect(mockGet).toHaveBeenCalledWith(expect.stringContaining("implementations-meta"), expect.objectContaining({
                 searchParams: expect.objectContaining({
-                    selected_apis: "SlackCLIAPI,GitHubCLIAPI",
+                    selected_apis: "SlackCLIAPI@latest,GitHubCLIAPI@latest",
                 }),
             }));
         });

package/dist/plugins/listAuthentications/index.d.ts

@@ -21,10 +21,8 @@ export interface ListAuthenticationsPluginProvides {
         };
     };
 }
-export declare const listAuthenticationsPlugin: Plugin<GetSdkType<ManifestPluginProvides>, // requires getApp in SDK
-{
+export declare const listAuthenticationsPlugin: Plugin<GetSdkType<ManifestPluginProvides>, {
     api: ApiClient;
     getVersionedImplementationId: GetVersionedImplementationId;
-}, // requires api in context
-ListAuthenticationsPluginProvides>;
+}, ListAuthenticationsPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listAuthentications/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,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAEhC,MAAM,WAAW,CAAC;AAUnB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,EAAE,CAAC,OAAO,CAAC,EAAE,0BAA0B,KAAK,OAAO,CAAC;QACrE,IAAI,EAAE,kBAAkB,EAAE,CAAC;KAC5B,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACnE,KAAK,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC;KAC5C,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,mBAAmB,EAAE;gBACnB,WAAW,EAAE,OAAO,yBAAyB,CAAC;aAC/C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,UAAU,CAAC,sBAAsB,CAAC,EAAE,yBAAyB;AAC7D;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,0BAA0B;AAC7B,iCAAiC,CA8FlC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listAuthentications/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,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAEhC,MAAM,WAAW,CAAC;AAUnB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,EAAE,CAAC,OAAO,CAAC,EAAE,0BAA0B,KAAK,OAAO,CAAC;QACrE,IAAI,EAAE,kBAAkB,EAAE,CAAC;KAC5B,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACnE,KAAK,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC;KAC5C,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,mBAAmB,EAAE;gBACnB,WAAW,EAAE,OAAO,yBAAyB,CAAC;aAC/C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,UAAU,CAAC,sBAAsB,CAAC,EAClC;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EACD,iCAAiC,CAmGlC,CAAC"}

package/dist/plugins/listAuthentications/index.js

@@ -15,6 +15,10 @@ export const listAuthenticationsPlugin = ({ context }) => {
                 searchParams.versionless_selected_api = versionlessSelectedApi;
             }
         }
+        // Add authenticationIds as ids parameter if provided
+        if (options.authenticationIds && options.authenticationIds.length > 0) {
+            searchParams.ids = options.authenticationIds.join(",");
+        }
         // Add other query parameters if provided
         // Use title as search if no explicit search provided
         if (options.search) {

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

@@ -35,14 +35,6 @@ const mockAuthenticationsResponse = {
     next: null,
     previous: null,
 };
-const mockSlackApp = {
-    title: "Slack",
-    key: "SlackCLIAPI",
-    current_implementation_id: "SlackCLIAPI@1.21.1",
-    version: "1.21.1",
-    description: "Team communication platform",
-    slug: "slack",
-};
 describe("listAuthentications plugin", () => {
     let mockApiClient;
     let mockGetVersionedImplementationId;
@@ -60,15 +52,13 @@ describe("listAuthentications plugin", () => {
             api: mockApiClient,
         },
     });
+    const mockResolveAppKeys = vi.fn().mockResolvedValue([]);
     const manifestPlugin = () => ({
         context: {
             manifest: null,
             getVersionedImplementationId: mockGetVersionedImplementationId,
-            getManifestEntry: () => ({
-                implementationName: "SlackCLIAPI",
-                version: "1.21.1",
-            }),
-            getImplementation: vi.fn().mockResolvedValue(mockSlackApp),
+            resolveAppKeys: mockResolveAppKeys,
+            updateManifestEntry: vi.fn().mockResolvedValue(["test-key", {}]),
         },
     });
     function createTestSdk() {
@@ -131,6 +121,19 @@ describe("listAuthentications plugin", () => {
                 });
             }).toThrow(ZapierValidationError);
         });
+        it("should throw validation error for invalid authenticationIds type", () => {
+            const sdk = createTestSdk();
+            expect(() => {
+                sdk.listAuthentications({
+                    authenticationIds: "123", // Should be array of strings
+                });
+            }).toThrow(ZapierValidationError);
+            expect(() => {
+                sdk.listAuthentications({
+                    authenticationIds: [123], // Should be array of strings, not numbers
+                });
+            }).toThrow(ZapierValidationError);
+        });
         it("should throw validation error for invalid pageSize", () => {
             const sdk = createTestSdk();
             expect(() => {
@@ -161,6 +164,7 @@ describe("listAuthentications plugin", () => {
             const sdk = createTestSdk();
             const result = await sdk.listAuthentications({
                 appKey: "slack",
+                authenticationIds: ["123", "456"],
                 search: "workspace",
                 title: "My Slack Workspace",
                 accountId: "acc_123",
@@ -273,6 +277,28 @@ describe("listAuthentications plugin", () => {
                 }),
             }));
         });
+        it("should pass authenticationIds as ids parameter to API", async () => {
+            const sdk = createTestSdk();
+            await sdk.listAuthentications({
+                authenticationIds: ["123", "456", "789"],
+            });
+            expect(mockApiClient.get).toHaveBeenCalledWith("/api/v4/authentications/", expect.objectContaining({
+                searchParams: expect.objectContaining({
+                    ids: "123,456,789",
+                }),
+            }));
+        });
+        it("should not include ids parameter when authenticationIds is empty", async () => {
+            const sdk = createTestSdk();
+            await sdk.listAuthentications({
+                authenticationIds: [],
+            });
+            expect(mockApiClient.get).toHaveBeenCalledWith("/api/v4/authentications/", expect.objectContaining({
+                searchParams: expect.not.objectContaining({
+                    ids: expect.anything(),
+                }),
+            }));
+        });
     });
     describe("pagination", () => {
         it("should handle pagination with maxItems by collecting all items", async () => {

package/dist/plugins/listAuthentications/schemas.d.ts

@@ -4,6 +4,7 @@ import type { AuthenticationItem } from "../../types/domain";
 import type { ZapierAuthenticationError, ZapierApiError, ZapierAppNotFoundError, ZapierValidationError, ZapierUnknownError } from "../../types/errors";
 export declare const ListAuthenticationsSchema: z.ZodObject<{
     appKey: z.ZodOptional<z.ZodString>;
+    authenticationIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     accountId: z.ZodOptional<z.ZodString>;
@@ -18,6 +19,7 @@ export declare const ListAuthenticationsSchema: z.ZodObject<{
     maxItems?: number | undefined;
     accountId?: string | undefined;
     owner?: string | undefined;
+    authenticationIds?: string[] | undefined;
 }, {
     title?: string | undefined;
     search?: string | undefined;
@@ -26,6 +28,7 @@ export declare const ListAuthenticationsSchema: z.ZodObject<{
     maxItems?: number | undefined;
     accountId?: string | undefined;
     owner?: string | undefined;
+    authenticationIds?: string[] | undefined;
 }>;
 export type ListAuthenticationsOptions = z.infer<typeof ListAuthenticationsSchema>;
 export interface ListAuthenticationsPage {

package/dist/plugins/listAuthentications/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/listAuthentications/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EACV,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EA0B+B,CAAC;AAGtE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,yBAAyB,CACjC,CAAC;AAGF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,MAAM,wBAAwB,GAChC,yBAAyB,GACzB,cAAc,GACd,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,8BAA8B;IAC7C,mBAAmB,EAAE,oBAAoB,CACvC,0BAA0B,EAC1B,kBAAkB,CACnB,CAAC;CACH"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/listAuthentications/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EACV,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B+B,CAAC;AAGtE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,yBAAyB,CACjC,CAAC;AAGF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,MAAM,wBAAwB,GAChC,yBAAyB,GACzB,cAAc,GACd,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,8BAA8B;IAC7C,mBAAmB,EAAE,oBAAoB,CACvC,0BAA0B,EAC1B,kBAAkB,CACnB,CAAC;CACH"}

package/dist/plugins/listAuthentications/schemas.js

@@ -4,6 +4,10 @@ import { AppKeyPropertySchema } from "../../types/properties";
 export const ListAuthenticationsSchema = z
     .object({
     appKey: AppKeyPropertySchema.optional().describe("App key of authentications to list (e.g., 'SlackCLIAPI')"),
+    authenticationIds: z
+        .array(z.string())
+        .optional()
+        .describe("List of authentication IDs to filter by"),
     search: z
         .string()
         .optional()

package/dist/plugins/manifest/index.d.ts

@@ -1,22 +1,38 @@
-import type { GetImplementation, GetManifestEntry, GetVersionedImplementationId, Manifest, ManifestPluginOptionsSchema } from "./schemas";
-import type { GetSdkType, Plugin } from "../../types/plugin";
+import type { GetVersionedImplementationId, Manifest, ManifestEntry, ManifestPluginOptionsSchema, ResolveAppKeys } from "./schemas";
+import type { Plugin } from "../../types/plugin";
 import type { z } from "zod";
 import type { ApiClient } from "../../api";
-import type { ListAppsPluginProvides } from "../listApps";
 export type ManifestPluginOptions = z.infer<typeof ManifestPluginOptionsSchema>;
 export interface ManifestPluginProvides {
     context: {
         getVersionedImplementationId: GetVersionedImplementationId;
-        getManifestEntry: GetManifestEntry;
-        getImplementation: GetImplementation;
+        resolveAppKeys: ResolveAppKeys;
+        updateManifestEntry: (appKey: string, entry: ManifestEntry, configPath?: string) => Promise<[string, ManifestEntry]>;
     };
 }
 /**
- * Load manifest from a file path synchronously
- * Supports local files (Node.js only)
+ * Read manifest from a file path asynchronously
+ * Supports local files (Node.js) and browser environments (fallback to global filesystem)
  */
-export declare function loadManifestFromFile(filePath: string): Manifest | null;
-export declare const manifestPlugin: Plugin<GetSdkType<ListAppsPluginProvides>, {
+export declare function readManifestFromFile(filePath: string): Promise<Manifest | null>;
+/**
+ * Get the preferred key for storing an app in the manifest
+ * Extracted from plugin to make it easier to test
+ */
+export declare function getPreferredManifestEntryKey({ appKey, api, }: {
+    appKey: string;
+    api: ApiClient;
+}): Promise<string>;
+/**
+ * Find a manifest entry by any app key (implementation name, slug, etc.).
+ */
+export declare function findManifestEntry({ appKey, manifest, }: {
+    appKey: string;
+    manifest: Manifest;
+}): [string, ManifestEntry] | null;
+export { DEFAULT_CONFIG_PATH } from "./schemas";
+export declare const manifestPlugin: Plugin<{}, // no SDK dependencies
+{
     api: ApiClient;
 }, ManifestPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/manifest/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,4BAA4B,EAC5B,QAAQ,EACR,2BAA2B,EAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAO1D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE;QACP,4BAA4B,EAAE,4BAA4B,CAAC;QAC3D,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,iBAAiB,EAAE,iBAAiB,CAAC;KACtC,CAAC;CACH;AA2BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAUtE;AAcD,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,UAAU,CAAC,sBAAsB,CAAC,EAClC;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,EAClB,sBAAsB,CA6FvB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/manifest/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,4BAA4B,EAC5B,QAAQ,EACR,aAAa,EACb,2BAA2B,EAC3B,cAAc,EACf,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAgB3C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE;QACP,4BAA4B,EAAE,4BAA4B,CAAC;QAC3D,cAAc,EAAE,cAAc,CAAC;QAC/B,mBAAmB,EAAE,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;KACvC,CAAC;CACH;AA2BD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAU1B;AAcD;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,EACjD,MAAM,EACN,GAAG,GACJ,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,SAAS,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkClB;AAoCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAyBjC;AA8GD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,EAAE,EAAE,sBAAsB;AAC1B;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,EAClB,sBAAsB,CA8GvB,CAAC"}