@zapier/zapier-sdk 0.18.3 → 0.19.0

package/dist/plugins/listApps/index.js

@@ -1,69 +0,0 @@
-import { createPaginatedFunction } from "../../utils/function-utils";
-import { ListAppsSchema, } from "./schemas";
-import { AppItemSchema } from "../../schemas/App";
-import { createTelemetryCallback } from "../../utils/telemetry-utils";
-import { stripPageSuffix } from "../../utils/string-utils";
-export const listAppsPlugin = ({ context }) => {
-    async function listAppsPage(options) {
-        const { api, resolveAppKeys } = context;
-        const appKeys = options.appKeys ?? [];
-        const appLocators = await resolveAppKeys({
-            appKeys: [...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(", ")}`);
-        }
-        // Step 2: Early return if user provided appKeys but they resolved to nothing AND no search
-        // This prevents the handler from returning all apps when the user explicitly filtered
-        // If search is provided, let the handler augment with search results
-        if (appKeys.length > 0 && appLocators.length === 0 && !options.search) {
-            return {
-                data: [],
-                nextCursor: undefined,
-            };
-        }
-        const implementationIds = appLocators.map((locator) => {
-            const version = locator.version || "latest";
-            return `${locator.implementationName}@${version}`;
-        });
-        // Call the API, which will be routed to the handler via handlerOverride in pathConfig.
-        // When the handler is migrated to sdkapi, this same API call will go over the network.
-        return await api.get("/api/v0/apps", {
-            searchParams: {
-                implementationIds: implementationIds.join(","),
-                ...(options.search && { search: options.search }),
-                pageSize: options.pageSize.toString(),
-                ...(options.cursor && { cursor: options.cursor }),
-            },
-        });
-    }
-    const methodName = stripPageSuffix(listAppsPage.name);
-    const listAppsDefinition = createPaginatedFunction(listAppsPage, ListAppsSchema, createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName), methodName);
-    // Return flat structure - listApps goes directly to SDK
-    return {
-        listApps: listAppsDefinition,
-        context: {
-            meta: {
-                listApps: {
-                    categories: ["app"],
-                    type: "list",
-                    itemType: "App",
-                    inputSchema: ListAppsSchema,
-                    outputSchema: AppItemSchema,
-                },
-            },
-        },
-    };
-};

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/listApps/index.test.ts"],"names":[],"mappings":""}

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

@@ -1,141 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { ZapierValidationError } from "../../types/errors";
-import { listAppsPlugin } from "./index";
-import { createSdk } from "../../sdk";
-import { apiPlugin } from "../api/index";
-import { eventEmissionPlugin } from "../eventEmission";
-const mockResolveAppKeys = vi
-    .fn()
-    .mockImplementation(async ({ appKeys }) => {
-    return appKeys.map((appKey) => ({
-        lookupAppKey: appKey,
-        implementationName: appKey,
-        slug: appKey.toLowerCase(),
-        version: undefined,
-    }));
-});
-function createTestSdk(mockFetch) {
-    return createSdk()
-        .addPlugin(() => ({
-        context: {
-            options: {},
-        },
-    }))
-        .addPlugin(apiPlugin, { fetch: mockFetch || global.fetch })
-        .addPlugin(eventEmissionPlugin)
-        .addPlugin(() => ({
-        context: {
-            resolveAppKeys: mockResolveAppKeys,
-        },
-    }))
-        .addPlugin(listAppsPlugin);
-}
-function createMockFetch(handlers) {
-    return vi.fn().mockImplementation(async (url, _init) => {
-        const urlString = typeof url === "string" ? url : url.toString();
-        const urlPath = new URL(urlString).pathname;
-        for (const [handlerPath, response] of Object.entries(handlers)) {
-            if (urlPath === handlerPath) {
-                const responseData = typeof response === "function" ? response() : response;
-                return {
-                    ok: true,
-                    status: 200,
-                    statusText: "OK",
-                    json: async () => responseData,
-                    headers: new Headers({ "content-type": "application/json" }),
-                };
-            }
-        }
-        return {
-            ok: false,
-            status: 404,
-            statusText: "Not Found",
-            json: async () => ({ message: `No mock for path: ${urlPath}` }),
-            headers: new Headers(),
-        };
-    });
-}
-describe("listApps plugin", () => {
-    beforeEach(() => {
-        vi.clearAllMocks();
-    });
-    describe("basic functionality", () => {
-        it("should provide listApps method that returns apps", async () => {
-            const mockFetch = createMockFetch({
-                "/api/v0/sdk/zapier/api/v4/implementations-meta/lookup/": {
-                    count: 2,
-                    results: [
-                        {
-                            id: "SlackCLIAPI@1.0.0",
-                            name: "Slack",
-                            description: "Team communication",
-                            primary_color: "#4A154B",
-                            categories: ["communication"],
-                        },
-                        {
-                            id: "GoogleSheetsCLIAPI@1.0.0",
-                            name: "Google Sheets",
-                            description: "Online spreadsheets",
-                            primary_color: "#34A853",
-                            categories: ["productivity"],
-                        },
-                    ],
-                    next: null,
-                },
-            });
-            const sdk = createTestSdk(mockFetch);
-            // Provide explicit pageSize to limit results
-            const result = await sdk.listApps({ pageSize: 2 });
-            // Just verify the structure - handler tests verify correct data
-            expect(result.data.length).toBeGreaterThan(0);
-            expect(result.data[0]).toHaveProperty("title");
-            expect(result.data[0]).toHaveProperty("key");
-            expect(result.data[0]).toHaveProperty("implementation_id");
-            expect(result.data[0]).toHaveProperty("version");
-        });
-    });
-    describe("plugin integration", () => {
-        it("should provide metadata in context for CLI introspection", () => {
-            const sdk = createTestSdk();
-            const context = sdk.getContext();
-            expect(context.meta.listApps).toBeDefined();
-            expect(context.meta.listApps.inputSchema).toBeDefined();
-        });
-        it("should integrate with resolveAppKeys", async () => {
-            const mockFetch = createMockFetch({
-                "/api/v0/sdk/zapier/api/v4/implementations-meta/lookup/": {
-                    count: 1,
-                    results: [
-                        {
-                            id: "SlackCLIAPI@1.0.0",
-                            name: "Slack",
-                            description: "Team communication",
-                            primary_color: "#4A154B",
-                            categories: ["communication"],
-                        },
-                    ],
-                    next: null,
-                },
-            });
-            const sdk = createTestSdk(mockFetch);
-            await sdk.listApps({ appKeys: ["SlackCLIAPI"] });
-            // Verify resolveAppKeys was called with the provided appKeys
-            expect(mockResolveAppKeys).toHaveBeenCalledWith(expect.objectContaining({
-                appKeys: ["SlackCLIAPI"],
-            }));
-        });
-    });
-    describe("validation", () => {
-        it("should throw validation error for invalid input", () => {
-            const sdk = createTestSdk();
-            // Invalid pageSize
-            expect(() => {
-                sdk.listApps({ pageSize: 0 });
-            }).toThrow(ZapierValidationError);
-            // Invalid appKeys type
-            expect(() => {
-                sdk.listApps({ appKeys: 123 });
-            }).toThrow(ZapierValidationError);
-        });
-    });
-});

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

@@ -1,26 +0,0 @@
-/**
- * Plugin schemas for listApps
- *
- * Re-exports from temporary-internal-core to maintain single source of truth.
- * Plugin-specific types (like PaginatedSdkFunction) remain here.
- *
- * Note: The handler (handleListApps) uses a different request interface (ListAppsHandlerRequest)
- * than the public API (ListAppsOptions). This is because:
- * - ListAppsOptions accepts user-friendly `appKeys` (slugs, implementation names, etc.) and `search`
- * - ListAppsHandlerRequest expects pre-resolved `implementationIds` and `search`
- * - The plugin is responsible for:
- *   1. App key resolution (slugs, implementation names → implementation IDs)
- *   2. Early returns for invalid appKeys (prevents returning all apps)
- * - The handler is responsible for:
- *   1. Search augmentation (merging search results with implementation IDs)
- *   2. Empty search handling (returns empty, not all apps)
- */
-import type { PaginatedSdkFunction } from "../../types/functions";
-import type { ZapierApiError, ZapierValidationError } from "../../types/errors";
-import type { ListAppsOptions, AppItem } from "../../temporary-internal-core/schemas/apps";
-export { ListAppsOptionsSchema as ListAppsSchema, ListAppsResponseSchema, type ListAppsOptions, type ListAppsResponse as ListAppsPage, type AppItem, } from "../../temporary-internal-core/schemas/apps";
-export type ListAppsError = ZapierApiError | ZapierValidationError;
-export interface ListAppsSdkFunction {
-    listApps: PaginatedSdkFunction<ListAppsOptions | undefined, AppItem>;
-}
-//# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/listApps/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACR,MAAM,4CAA4C,CAAC;AAGpD,OAAO,EACL,qBAAqB,IAAI,cAAc,EACvC,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,IAAI,YAAY,EACrC,KAAK,OAAO,GACb,MAAM,4CAA4C,CAAC;AAGpD,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAGnE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,oBAAoB,CAAC,eAAe,GAAG,SAAS,EAAE,OAAO,CAAC,CAAC;CACtE"}

package/dist/plugins/listApps/schemas.js

@@ -1,19 +0,0 @@
-/**
- * Plugin schemas for listApps
- *
- * Re-exports from temporary-internal-core to maintain single source of truth.
- * Plugin-specific types (like PaginatedSdkFunction) remain here.
- *
- * Note: The handler (handleListApps) uses a different request interface (ListAppsHandlerRequest)
- * than the public API (ListAppsOptions). This is because:
- * - ListAppsOptions accepts user-friendly `appKeys` (slugs, implementation names, etc.) and `search`
- * - ListAppsHandlerRequest expects pre-resolved `implementationIds` and `search`
- * - The plugin is responsible for:
- *   1. App key resolution (slugs, implementation names → implementation IDs)
- *   2. Early returns for invalid appKeys (prevents returning all apps)
- * - The handler is responsible for:
- *   1. Search augmentation (merging search results with implementation IDs)
- *   2. Empty search handling (returns empty, not all apps)
- */
-// Re-export core schemas and types
-export { ListAppsOptionsSchema as ListAppsSchema, ListAppsResponseSchema, } from "../../temporary-internal-core/schemas/apps";

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

@@ -1,24 +0,0 @@
-import type { Plugin, GetSdkType } from "../../types/plugin";
-import type { ApiClient } from "../../api";
-import type { AuthenticationItem } from "@zapier/zapier-sdk-core/v0/schemas/authentications";
-import { ListAuthenticationsQuerySchema, type ListAuthenticationsOptions, type ListAuthenticationsPage } from "./schemas";
-import type { GetVersionedImplementationId } from "../manifest/schemas";
-import type { ManifestPluginProvides } from "../manifest";
-import type { EventEmissionContext } from "../eventEmission";
-export interface ListAuthenticationsPluginProvides {
-    listAuthentications: (options?: ListAuthenticationsOptions) => Promise<ListAuthenticationsPage> & AsyncIterable<ListAuthenticationsPage> & {
-        items(): AsyncIterable<AuthenticationItem>;
-    };
-    context: {
-        meta: {
-            listAuthentications: {
-                inputSchema: typeof ListAuthenticationsQuerySchema;
-            };
-        };
-    };
-}
-export declare const listAuthenticationsPlugin: Plugin<GetSdkType<ManifestPluginProvides>, {
-    api: ApiClient;
-    getVersionedImplementationId: GetVersionedImplementationId;
-} & EventEmissionContext, ListAuthenticationsPluginProvides>;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,EACL,8BAA8B,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAInB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAK7D,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,EAAE,CACnB,OAAO,CAAC,EAAE,0BAA0B,KACjC,OAAO,CAAC,uBAAuB,CAAC,GACnC,aAAa,CAAC,uBAAuB,CAAC,GAAG;QACvC,KAAK,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC;KAC5C,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,mBAAmB,EAAE;gBACnB,WAAW,EAAE,OAAO,8BAA8B,CAAC;aACpD,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,GAAG,oBAAoB,EACxB,iCAAiC,CAiGlC,CAAC"}

package/dist/plugins/listAuthentications/index.js

@@ -1,77 +0,0 @@
-import { ListAuthenticationsQuerySchema, } from "./schemas";
-import { splitVersionedKey } from "../../utils/domain-utils";
-import { createPaginatedFunction } from "../../utils/function-utils";
-import { appKeyResolver } from "../../resolvers";
-import { AuthenticationItemSchema } from "../../schemas/Auth";
-import { createTelemetryCallback } from "../../utils/telemetry-utils";
-import { stripPageSuffix } from "../../utils/string-utils";
-import { ZapierAuthenticationError } from "../../types/errors";
-export const listAuthenticationsPlugin = ({ context }) => {
-    async function listAuthenticationsPage(options) {
-        const { api, getVersionedImplementationId } = context;
-        const searchParams = {
-            pageSize: options.pageSize.toString(),
-        };
-        // Resolve appKey to implementationId if provided
-        if (options.appKey) {
-            const implementationId = await getVersionedImplementationId(options.appKey);
-            if (implementationId) {
-                // Extract versionless app key to pass to handler
-                const [versionlessSelectedApi] = splitVersionedKey(implementationId);
-                searchParams.appKey = versionlessSelectedApi;
-            }
-        }
-        // Pass other filter options as searchParams
-        if (options.authenticationIds && options.authenticationIds.length > 0) {
-            searchParams.authenticationIds = options.authenticationIds.join(",");
-        }
-        if (options.search) {
-            searchParams.search = options.search;
-        }
-        if (options.title) {
-            searchParams.title = options.title;
-        }
-        if (options.accountId) {
-            searchParams.accountId = options.accountId;
-        }
-        if (options.owner) {
-            searchParams.owner = options.owner;
-        }
-        if (options.cursor) {
-            searchParams.offset = options.cursor;
-        }
-        const response = await api.get("/api/v0/authentications", {
-            searchParams,
-            customErrorHandler: ({ status }) => {
-                if (status === 401) {
-                    return new ZapierAuthenticationError(`Authentication failed. Your token may not have permission to access authentications or may be expired. (HTTP ${status})`, { statusCode: status });
-                }
-                if (status === 403) {
-                    return new ZapierAuthenticationError(`Access forbidden. Your token may not have the required scopes to list authentications. (HTTP ${status})`, { statusCode: status });
-                }
-                return undefined;
-            },
-            authRequired: true,
-        });
-        return response;
-    }
-    const methodName = stripPageSuffix(listAuthenticationsPage.name);
-    const listAuthenticationsDefinition = createPaginatedFunction(listAuthenticationsPage, ListAuthenticationsQuerySchema, createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName), methodName);
-    return {
-        listAuthentications: listAuthenticationsDefinition,
-        context: {
-            meta: {
-                listAuthentications: {
-                    categories: ["authentication"],
-                    type: "list",
-                    itemType: "Authentication",
-                    inputSchema: ListAuthenticationsQuerySchema,
-                    outputSchema: AuthenticationItemSchema,
-                    resolvers: {
-                        appKey: appKeyResolver,
-                    },
-                },
-            },
-        },
-    };
-};

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/listAuthentications/index.test.ts"],"names":[],"mappings":""}