@zapier/zapier-sdk 0.26.0 → 0.27.0

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":"AAAA,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,WAAW,CAAC;AAGnB,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;AAGlE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AA2JD,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,UAAU,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,oCAAoC;AAC/F,EAAE,EAAE,0BAA0B;AAC9B,kBAAkB,CAyBnB,CAAC;AAGF,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,WAAW,aAAa;CAAG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,WAAW,CAAC;AAGnB,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;AAGlE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAsKD,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,UAAU,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,oCAAoC;AAC/F,EAAE,EAAE,0BAA0B;AAC9B,kBAAkB,CA2BnB,CAAC;AAGF,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,WAAW,aAAa;CAAG"}

package/dist/plugins/apps/index.js

@@ -4,11 +4,11 @@ import { ActionResultItemSchema } from "../../schemas/Run";
 function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId) {
     return (actionOptions = {}) => {
         const { sdk } = options;
-        const { inputs, authenticationId: providedAuthenticationId, timeoutMs, } = actionOptions;
-        // Use pinned auth ID first, then provided auth ID
-        const authenticationId = pinnedAuthId ?? providedAuthenticationId;
-        if (!authenticationId) {
-            throw new ZapierValidationError(`Authentication ID is required. Either use the factory pattern: sdk.apps.${appKey}({ authenticationId }) or provide authenticationId in the action call.`);
+        const { inputs, connectionId: providedConnectionId, authenticationId: providedAuthenticationId, timeoutMs, } = actionOptions;
+        // Use pinned auth ID first, then provided connectionId, then deprecated authenticationId
+        const resolvedConnectionId = pinnedAuthId ?? providedConnectionId ?? providedAuthenticationId;
+        if (!resolvedConnectionId) {
+            throw new ZapierValidationError(`Connection ID is required. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }) or provide connectionId in the action call.`);
         }
         // Call sdk.runAction with the resolved parameters
         return sdk.runAction({
@@ -16,7 +16,7 @@ function createActionFunction(appKey, actionType, actionKey, options, pinnedAuth
             actionType: actionType,
             actionKey,
             inputs,
-            authenticationId,
+            connectionId: resolvedConnectionId,
             timeoutMs,
         });
     };
@@ -26,15 +26,15 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
     if (actionType === "fetch") {
         return async (url, init) => {
             const { sdk } = options;
-            // Use pinned auth ID first, then provided auth ID
-            const authenticationId = pinnedAuthId ?? init?.authenticationId;
-            if (!authenticationId) {
-                throw new ZapierValidationError(`Authentication ID is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ authenticationId }).fetch(...) or provide authenticationId in the fetch call.`);
+            // Use pinned auth ID first, then provided connectionId, then deprecated authenticationId
+            const resolvedConnectionId = pinnedAuthId ?? init?.connectionId ?? init?.authenticationId;
+            if (!resolvedConnectionId) {
+                throw new ZapierValidationError(`Connection ID is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId in the fetch call.`);
             }
-            // Call sdk.fetch with the resolved authenticationId
+            // Call sdk.fetch with the resolved connectionId
             return sdk.fetch(url, {
                 ...init,
-                authenticationId,
+                connectionId: resolvedConnectionId,
             });
         };
     }
@@ -60,7 +60,12 @@ function createPinnedAppProxy(appKey, options, pinnedAuthId) {
 function createAppProxy(appKey, options) {
     // Create the factory function that returns a pinned version
     const appFactory = (factoryOptions) => {
-        return createPinnedAppProxy(appKey, options, factoryOptions.authenticationId);
+        // Support both connectionId (new) and authenticationId (deprecated)
+        const resolvedConnectionId = factoryOptions.connectionId ?? factoryOptions.authenticationId;
+        if (!resolvedConnectionId) {
+            throw new ZapierValidationError(`Connection ID is required. Use sdk.apps.${appKey}({ connectionId: "..." })`);
+        }
+        return createPinnedAppProxy(appKey, options, resolvedConnectionId);
     };
     // Add properties for direct usage (backward compatibility)
     return new Proxy(appFactory, {
@@ -98,6 +103,7 @@ export const appsPlugin = ({ sdk }) => {
                     type: "function",
                     inputSchema: AppFactoryInputSchema,
                     returnType: "AppProxy",
+                    deprecatedParameters: ["authenticationId"],
                 },
                 "apps.{appKey}.{actionType}.{actionKey}": {
                     categories: ["app"],
@@ -106,6 +112,7 @@ export const appsPlugin = ({ sdk }) => {
                     inputSchema: ActionExecutionInputSchema,
                     itemType: "ActionResult",
                     outputSchema: ActionResultItemSchema,
+                    deprecatedParameters: ["authenticationId"],
                 },
             },
         },

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

@@ -1,13 +1,15 @@
 import { z } from "zod";
-import { type AuthenticationIdProperty } from "../../types/properties";
+import { type ConnectionIdProperty, type AuthenticationIdProperty } from "../../types/properties";
 export declare const ActionExecutionInputSchema: z.ZodObject<{
     inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     authenticationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ActionExecutionOptions = z.infer<typeof ActionExecutionInputSchema>;
 export declare const AppFactoryInputSchema: z.ZodObject<{
-    authenticationId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    authenticationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
 }, z.core.$strip>;
 export type AppFactoryInput = z.infer<typeof AppFactoryInputSchema>;
 interface BaseActionTypeProxy {
@@ -23,6 +25,8 @@ interface BaseActionTypeProxy {
 }
 interface FetchActionType {
     fetch: (url: string | URL, init?: RequestInit & {
+        connectionId?: ConnectionIdProperty;
+        /** @deprecated Use connectionId instead */
         authenticationId?: AuthenticationIdProperty;
         callbackUrl?: string;
     }) => Promise<Response>;

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,0BAA0B;;;;iBAQpC,CAAC;AAGJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEhF,eAAO,MAAM,qBAAqB;;iBAIgB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,UAAU,mBAAmB;IAC3B,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC9D,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACpD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;CACL;AAGD,UAAU,eAAe;IACvB,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AAGD,KAAK,eAAe,GAAG,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEtE,UAAU,QAAQ;IAChB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;CACjC;AAED,UAAU,UAAU;IAClB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;CACtC;AAGD,KAAK,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACpC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/apps/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,0BAA0B;;;;;iBAUpC,CAAC;AAGJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEhF,eAAO,MAAM,qBAAqB;;;iBAMW,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,UAAU,mBAAmB;IAC3B,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC9D,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QACpD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;CACL;AAGD,UAAU,eAAe;IACvB,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,YAAY,CAAC,EAAE,oBAAoB,CAAC;QACpC,2CAA2C;QAC3C,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AAGD,KAAK,eAAe,GAAG,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEtE,UAAU,QAAQ;IAChB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;CACjC;AAED,UAAU,UAAU;IAClB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;CACtC;AAGD,KAAK,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACpC"}

package/dist/plugins/apps/schemas.js

@@ -1,15 +1,19 @@
 import { z } from "zod";
-import { AuthenticationIdPropertySchema, ActionTimeoutMsPropertySchema, } from "../../types/properties";
+import { ConnectionIdPropertySchema, AuthenticationIdPropertySchema, ActionTimeoutMsPropertySchema, } from "../../types/properties";
 export const ActionExecutionInputSchema = z
     .object({
     inputs: z.record(z.string(), z.unknown()).optional(),
+    connectionId: ConnectionIdPropertySchema.optional(),
+    /** @deprecated Use connectionId instead */
     authenticationId: AuthenticationIdPropertySchema.optional(),
     timeoutMs: ActionTimeoutMsPropertySchema,
 })
     .describe("Execute an action with the given inputs for the bound app, as an alternative to runAction");
 export const AppFactoryInputSchema = z
     .object({
-    authenticationId: AuthenticationIdPropertySchema,
+    connectionId: ConnectionIdPropertySchema.optional(),
+    /** @deprecated Use connectionId instead */
+    authenticationId: AuthenticationIdPropertySchema.optional(),
 })
-    .describe("Bind an authentication ID to an app");
+    .describe("Bind a connection ID to an app");
 // Note: AppsPluginSdkExtension removed - now using AppsPluginProvides in index.ts

package/dist/plugins/deprecated/authentications.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Deprecated Authentication Plugins
+ *
+ * These plugins provide backward compatibility for the old authentication naming.
+ * They are simple aliases that delegate to the connection plugins.
+ * The connection plugins already accept both connectionId and authenticationId parameters.
+ *
+ * @deprecated Use the connection equivalents instead:
+ * - listAuthentications -> listConnections
+ * - getAuthentication -> getConnection
+ * - findFirstAuthentication -> findFirstConnection
+ * - findUniqueAuthentication -> findUniqueConnection
+ */
+import type { Plugin, GetSdkType } from "../../types/plugin";
+import type { ListConnectionsPluginProvides } from "../listConnections";
+import type { GetConnectionPluginProvides } from "../getConnection";
+import type { FindFirstConnectionPluginProvides } from "../findFirstConnection";
+import type { FindUniqueConnectionPluginProvides } from "../findUniqueConnection";
+import { ListConnectionsQuerySchema } from "../listConnections/schemas";
+import { GetConnectionParamSchema } from "../getConnection/schemas";
+import { FindFirstConnectionSchema } from "../findFirstConnection/schemas";
+import { FindUniqueConnectionSchema } from "../findUniqueConnection/schemas";
+export interface ListAuthenticationsPluginProvides {
+    listAuthentications: GetSdkType<ListConnectionsPluginProvides>["listConnections"];
+    context: {
+        meta: {
+            listAuthentications: {
+                inputSchema: typeof ListConnectionsQuerySchema;
+            };
+        };
+    };
+}
+export interface GetAuthenticationPluginProvides {
+    getAuthentication: GetSdkType<GetConnectionPluginProvides>["getConnection"];
+    context: {
+        meta: {
+            getAuthentication: {
+                inputSchema: typeof GetConnectionParamSchema;
+            };
+        };
+    };
+}
+export interface FindFirstAuthenticationPluginProvides {
+    findFirstAuthentication: GetSdkType<FindFirstConnectionPluginProvides>["findFirstConnection"];
+    context: {
+        meta: {
+            findFirstAuthentication: {
+                inputSchema: typeof FindFirstConnectionSchema;
+            };
+        };
+    };
+}
+export interface FindUniqueAuthenticationPluginProvides {
+    findUniqueAuthentication: GetSdkType<FindUniqueConnectionPluginProvides>["findUniqueConnection"];
+    context: {
+        meta: {
+            findUniqueAuthentication: {
+                inputSchema: typeof FindUniqueConnectionSchema;
+            };
+        };
+    };
+}
+/**
+ * @deprecated Use listConnections instead
+ */
+export declare const listAuthenticationsPlugin: Plugin<GetSdkType<ListConnectionsPluginProvides>, {}, ListAuthenticationsPluginProvides>;
+/**
+ * @deprecated Use getConnection instead
+ */
+export declare const getAuthenticationPlugin: Plugin<GetSdkType<GetConnectionPluginProvides>, {}, GetAuthenticationPluginProvides>;
+/**
+ * @deprecated Use findFirstConnection instead
+ */
+export declare const findFirstAuthenticationPlugin: Plugin<GetSdkType<FindFirstConnectionPluginProvides>, {}, FindFirstAuthenticationPluginProvides>;
+/**
+ * @deprecated Use findUniqueConnection instead
+ */
+export declare const findUniqueAuthenticationPlugin: Plugin<GetSdkType<FindUniqueConnectionPluginProvides>, {}, FindUniqueAuthenticationPluginProvides>;
+//# sourceMappingURL=authentications.d.ts.map

package/dist/plugins/deprecated/authentications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentications.d.ts","sourceRoot":"","sources":["../../../src/plugins/deprecated/authentications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAI7E,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,EAAE,UAAU,CAAC,6BAA6B,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAClF,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,mBAAmB,EAAE;gBACnB,WAAW,EAAE,OAAO,0BAA0B,CAAC;aAChD,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,iBAAiB,EAAE,UAAU,CAAC,2BAA2B,CAAC,CAAC,eAAe,CAAC,CAAC;IAC5E,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,iBAAiB,EAAE;gBACjB,WAAW,EAAE,OAAO,wBAAwB,CAAC;aAC9C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,qCAAqC;IACpD,uBAAuB,EAAE,UAAU,CAAC,iCAAiC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAC9F,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,uBAAuB,EAAE;gBACvB,WAAW,EAAE,OAAO,yBAAyB,CAAC;aAC/C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,sCAAsC;IACrD,wBAAwB,EAAE,UAAU,CAAC,kCAAkC,CAAC,CAAC,sBAAsB,CAAC,CAAC;IACjG,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,wBAAwB,EAAE;gBACxB,WAAW,EAAE,OAAO,0BAA0B,CAAC;aAChD,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,UAAU,CAAC,6BAA6B,CAAC,EACzC,EAAE,EACF,iCAAiC,CAejC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,UAAU,CAAC,2BAA2B,CAAC,EACvC,EAAE,EACF,+BAA+B,CAe/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAChD,UAAU,CAAC,iCAAiC,CAAC,EAC7C,EAAE,EACF,qCAAqC,CAerC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,UAAU,CAAC,kCAAkC,CAAC,EAC9C,EAAE,EACF,sCAAsC,CAetC,CAAC"}

package/dist/plugins/deprecated/authentications.js

@@ -0,0 +1,90 @@
+/**
+ * Deprecated Authentication Plugins
+ *
+ * These plugins provide backward compatibility for the old authentication naming.
+ * They are simple aliases that delegate to the connection plugins.
+ * The connection plugins already accept both connectionId and authenticationId parameters.
+ *
+ * @deprecated Use the connection equivalents instead:
+ * - listAuthentications -> listConnections
+ * - getAuthentication -> getConnection
+ * - findFirstAuthentication -> findFirstConnection
+ * - findUniqueAuthentication -> findUniqueConnection
+ */
+import { ListConnectionsQuerySchema } from "../listConnections/schemas";
+import { GetConnectionParamSchema } from "../getConnection/schemas";
+import { FindFirstConnectionSchema } from "../findFirstConnection/schemas";
+import { FindUniqueConnectionSchema } from "../findUniqueConnection/schemas";
+import { ConnectionItemSchema } from "../../schemas/Connection";
+/**
+ * @deprecated Use listConnections instead
+ */
+export const listAuthenticationsPlugin = ({ sdk }) => ({
+    listAuthentications: sdk.listConnections,
+    context: {
+        meta: {
+            listAuthentications: {
+                packages: ["cli", "mcp"],
+                categories: ["connection", "deprecated"],
+                type: "list",
+                itemType: "Connection",
+                inputSchema: ListConnectionsQuerySchema,
+                outputSchema: ConnectionItemSchema,
+            },
+        },
+    },
+});
+/**
+ * @deprecated Use getConnection instead
+ */
+export const getAuthenticationPlugin = ({ sdk }) => ({
+    getAuthentication: sdk.getConnection,
+    context: {
+        meta: {
+            getAuthentication: {
+                packages: ["cli", "mcp"],
+                categories: ["connection", "deprecated"],
+                type: "item",
+                itemType: "Connection",
+                inputSchema: GetConnectionParamSchema,
+                outputSchema: ConnectionItemSchema,
+            },
+        },
+    },
+});
+/**
+ * @deprecated Use findFirstConnection instead
+ */
+export const findFirstAuthenticationPlugin = ({ sdk }) => ({
+    findFirstAuthentication: sdk.findFirstConnection,
+    context: {
+        meta: {
+            findFirstAuthentication: {
+                packages: ["cli", "mcp"],
+                categories: ["connection", "deprecated"],
+                type: "item",
+                itemType: "Connection",
+                inputSchema: FindFirstConnectionSchema,
+                outputSchema: ConnectionItemSchema,
+            },
+        },
+    },
+});
+/**
+ * @deprecated Use findUniqueConnection instead
+ */
+export const findUniqueAuthenticationPlugin = ({ sdk }) => ({
+    findUniqueAuthentication: sdk.findUniqueConnection,
+    context: {
+        meta: {
+            findUniqueAuthentication: {
+                packages: ["cli", "mcp"],
+                categories: ["connection", "deprecated"],
+                type: "item",
+                itemType: "Connection",
+                inputSchema: FindUniqueConnectionSchema,
+                outputSchema: ConnectionItemSchema,
+            },
+        },
+    },
+});

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

@@ -4,6 +4,8 @@ import type { z } from "zod";
 import type { EventEmissionContext } from "../eventEmission";
 export interface FetchPluginProvides {
     fetch: (url: string | URL, init?: RequestInit & {
+        connectionId?: string | number;
+        /** @deprecated Use connectionId instead */
         authenticationId?: string | number;
         callbackUrl?: string;
         _telemetry?: {
@@ -36,6 +38,8 @@ export declare const fetchPlugin: Plugin<{}, // no SDK dependencies
 } & EventEmissionContext, // requires api + eventEmission in context
 FetchPluginProvides>;
 export type ZapierFetchInitOptions = RequestInit & {
+    connectionId?: string | number;
+    /** @deprecated Use connectionId instead */
     authenticationId?: string | number;
     callbackUrl?: string;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AA6D7D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,WAAW,EAAE,MAAM,CAAC;gBACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,UAAU,EAAE,MAAM,EAAE,CAAC;gBACrB,UAAU,EAAE,MAAM,CAAC;gBACnB,eAAe,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;iBAAE,CAAC,CAAC;aAC/D,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,EAAE,EAAE,sBAAsB;AAC1B,AADI,sBAAsB;AAC1B;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAAG,oBAAoB,EAAE,0CAA0C;AACrF,mBAAmB,CAyGpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AA6D7D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC/B,2CAA2C;QAC3C,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,WAAW,EAAE,MAAM,CAAC;gBACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,UAAU,EAAE,MAAM,EAAE,CAAC;gBACrB,UAAU,EAAE,MAAM,CAAC;gBACnB,eAAe,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;iBAAE,CAAC,CAAC;aAC/D,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,EAAE,EAAE,sBAAsB;AAC1B,AADI,sBAAsB;AAC1B;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAAG,oBAAoB,EAAE,0CAA0C;AACrF,mBAAmB,CAoHpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/plugins/fetch/index.js

@@ -59,7 +59,9 @@ export const fetchPlugin = ({ context }) => {
             const startTime = Date.now();
             const isNested = init?._telemetry?.isNested === true;
             try {
-                const { authenticationId, callbackUrl, _telemetry, ...fetchInit } = init || {};
+                const { connectionId, authenticationId, callbackUrl, _telemetry, ...fetchInit } = init || {};
+                // Support both connectionId (new) and authenticationId (deprecated)
+                const resolvedConnectionId = connectionId ?? authenticationId;
                 const relayPath = transformUrlToRelayPath(url);
                 const headers = normalizeHeaders(fetchInit.headers);
                 const hasContentType = Object.keys(headers).some((k) => k.toLowerCase() === "content-type");
@@ -69,8 +71,8 @@ export const fetchPlugin = ({ context }) => {
                         headers["Content-Type"] = inferred;
                     }
                 }
-                if (authenticationId) {
-                    headers["X-Relay-Authentication-Id"] = coerceToNumericId("authenticationId", authenticationId).toString();
+                if (resolvedConnectionId) {
+                    headers["X-Relay-Authentication-Id"] = coerceToNumericId("connectionId", resolvedConnectionId).toString();
                 }
                 if (callbackUrl) {
                     headers["X-Relay-Callback-Url"] = callbackUrl;
@@ -113,7 +115,7 @@ export const fetchPlugin = ({ context }) => {
             meta: {
                 fetch: {
                     description: "Make authenticated HTTP requests to any API through Zapier's Relay service. " +
-                        "Pass an authenticationId to automatically inject the user's stored credentials " +
+                        "Pass a connectionId to automatically inject the user's stored credentials " +
                         "(OAuth tokens, API keys, etc.) into the outgoing request. " +
                         "Mirrors the native fetch(url, init?) signature with additional Zapier-specific options.",
                     packages: ["sdk", "cli", "mcp"],
@@ -123,6 +125,7 @@ export const fetchPlugin = ({ context }) => {
                         { name: "url", schema: FetchUrlSchema },
                         { name: "init", schema: FetchInitSchema },
                     ],
+                    deprecatedParameters: ["authenticationId"],
                 },
             },
         },

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

@@ -12,6 +12,7 @@ export declare const FetchInitSchema: z.ZodOptional<z.ZodObject<{
     }>>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     body: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<FormData, FormData>, z.ZodCustom<URLSearchParams, URLSearchParams>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     authenticationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     callbackUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc,2DAIxB,CAAC;AAEJ,eAAO,MAAM,eAAe;;;;;;;;;;;;;;kBA8BzB,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,cAAc,2DAIxB,CAAC;AAEJ,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;kBAgCzB,CAAC"}

package/dist/plugins/fetch/schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AuthenticationIdPropertySchema } from "../../types/properties";
+import { ConnectionIdPropertySchema, AuthenticationIdPropertySchema, } from "../../types/properties";
 // Schemas for fetch function parameters
 export const FetchUrlSchema = z
     .union([z.string(), z.instanceof(URL)])
@@ -23,6 +23,8 @@ export const FetchInitSchema = z
     ])
         .optional()
         .describe("Request body — plain objects and JSON strings are auto-detected and Content-Type is set accordingly"),
+    connectionId: ConnectionIdPropertySchema.optional(),
+    /** @deprecated Use connectionId instead */
     authenticationId: AuthenticationIdPropertySchema.optional(),
     callbackUrl: z
         .string()

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

@@ -0,0 +1,21 @@
+import type { Plugin, GetSdkType } from "../../types/plugin";
+import type { ConnectionItem } from "../../types/domain";
+import { FindFirstConnectionSchema, type FindFirstConnectionOptions } from "./schemas";
+import type { ListConnectionsPluginProvides } from "../listConnections";
+import type { EventEmissionContext } from "../eventEmission";
+export interface FindFirstConnectionPluginProvides {
+    findFirstConnection: (options?: FindFirstConnectionOptions) => Promise<{
+        data: ConnectionItem;
+    }>;
+    context: {
+        meta: {
+            findFirstConnection: {
+                inputSchema: typeof FindFirstConnectionSchema;
+            };
+        };
+    };
+}
+export declare const findFirstConnectionPlugin: Plugin<GetSdkType<ListConnectionsPluginProvides>, // requires listConnections in SDK
+EventEmissionContext, // requires eventEmission in context
+FindFirstConnectionPluginProvides>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/findFirstConnection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAChC,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,EAAE,CACnB,OAAO,CAAC,EAAE,0BAA0B,KACjC,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IACvC,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,6BAA6B,CAAC,EAAE,kCAAkC;AAC7E,oBAAoB,EAAE,oCAAoC;AAC1D,iCAAiC,CA8ClC,CAAC"}

package/dist/plugins/findFirstConnection/index.js

@@ -0,0 +1,37 @@
+import { FindFirstConnectionSchema, } from "./schemas";
+import { createFunction } from "../../utils/function-utils";
+import { ConnectionItemSchema } from "../../schemas/Connection";
+import { ZapierResourceNotFoundError } from "../../types/errors";
+import { createTelemetryCallback } from "../../utils/telemetry-utils";
+export const findFirstConnectionPlugin = ({ sdk, context }) => {
+    async function findFirstConnection(options = {}) {
+        // Use listConnections with maxItems 1 to get the first result
+        const connectionsResponse = await sdk.listConnections({
+            ...options,
+            maxItems: 1,
+            _telemetry: { isNested: true },
+        });
+        if (connectionsResponse.data.length === 0) {
+            throw new ZapierResourceNotFoundError("No connection found matching the specified criteria", { resourceType: "Connection" });
+        }
+        return {
+            data: connectionsResponse.data[0],
+        };
+    }
+    const findFirstConnectionDefinition = createFunction(findFirstConnection, FindFirstConnectionSchema, createTelemetryCallback(context.eventEmission.emitMethodCalled, findFirstConnection.name));
+    return {
+        findFirstConnection: findFirstConnectionDefinition,
+        context: {
+            meta: {
+                findFirstConnection: {
+                    categories: ["connection"],
+                    type: "item",
+                    itemType: "Connection",
+                    inputSchema: FindFirstConnectionSchema,
+                    outputSchema: ConnectionItemSchema,
+                    deprecatedParameters: ["authenticationIds"],
+                },
+            },
+        },
+    };
+};

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

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