@zapier/zapier-sdk 0.23.2 → 0.24.0

package/dist/index.mjs

@@ -362,71 +362,136 @@ var appsPlugin = ({ sdk }) => {
     }
   };
 };
-var FetchUrlSchema = z.union([z.string(), z.instanceof(URL)]).describe("The URL to fetch");
+var FetchUrlSchema = z.union([z.string(), z.instanceof(URL)]).describe(
+  "The full URL of the API endpoint to call (proxied through Zapier's Relay service)"
+);
 var FetchInitSchema = z.object({
-  method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional(),
-  headers: z.record(z.string(), z.string()).optional(),
+  method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional().describe("HTTP method for the request (defaults to GET)"),
+  headers: z.record(z.string(), z.string()).optional().describe("HTTP headers to include in the request"),
   body: z.union([
     z.string(),
     z.instanceof(FormData),
     z.instanceof(URLSearchParams)
-  ]).optional(),
+  ]).optional().describe(
+    "Request body \u2014 JSON strings are auto-detected and Content-Type is set accordingly"
+  ),
   authenticationId: AuthenticationIdPropertySchema.optional(),
   callbackUrl: z.string().optional().describe("URL to send async response to (makes request async)"),
   authenticationTemplate: z.string().optional().describe(
     "Optional JSON string authentication template to bypass Notary lookup"
   )
-}).optional().describe("Fetch options including authentication");
+}).optional().describe(
+  "Request options including method, headers, body, and authentication"
+);
+
+// src/utils/id-utils.ts
+function coerceToNumericId(fieldName, value) {
+  if (value === "") {
+    throw new ZapierValidationError(`The ${fieldName} cannot be empty`);
+  }
+  const numericValue = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numericValue)) {
+    throw new ZapierValidationError(
+      `The ${fieldName} "${value}" could not be converted to a number`
+    );
+  }
+  return numericValue;
+}
 
 // src/plugins/fetch/index.ts
-var fetchPlugin = ({ sdk, context }) => {
+function transformUrlToRelayPath(url) {
+  const targetUrl = new URL(url);
+  return `/relay/${targetUrl.host}${targetUrl.pathname}${targetUrl.search}${targetUrl.hash}`;
+}
+function normalizeHeaders(optionsHeaders) {
+  const headers = {};
+  if (!optionsHeaders) {
+    return headers;
+  }
+  const headerEntries = optionsHeaders instanceof Headers ? Array.from(optionsHeaders.entries()) : Array.isArray(optionsHeaders) ? optionsHeaders : Object.entries(optionsHeaders);
+  for (const [key, value] of headerEntries) {
+    headers[key] = value;
+  }
+  return headers;
+}
+var fetchPlugin = ({ context }) => {
   return {
     fetch: async function fetch2(url, init) {
+      const { api } = context;
       const startTime = Date.now();
+      const isNested = init?._telemetry?.isNested === true;
       try {
         const {
           authenticationId,
           callbackUrl,
           authenticationTemplate,
+          _telemetry,
           ...fetchInit
         } = init || {};
-        const result = await sdk.request({
-          url: url.toString(),
-          method: fetchInit.method,
+        const relayPath = transformUrlToRelayPath(url);
+        const headers = normalizeHeaders(
+          fetchInit.headers
+        );
+        const hasContentType = Object.keys(headers).some(
+          (k) => k.toLowerCase() === "content-type"
+        );
+        if (fetchInit.body && !hasContentType) {
+          const bodyStr = typeof fetchInit.body === "string" ? fetchInit.body : JSON.stringify(fetchInit.body);
+          const trimmed = bodyStr.trimStart();
+          if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+            headers["Content-Type"] = "application/json; charset=utf-8";
+          }
+        }
+        if (authenticationId) {
+          headers["X-Relay-Authentication-Id"] = coerceToNumericId(
+            "authenticationId",
+            authenticationId
+          ).toString();
+        }
+        if (callbackUrl) {
+          headers["X-Relay-Callback-Url"] = callbackUrl;
+        }
+        if (authenticationTemplate) {
+          headers["X-Authentication-Template"] = authenticationTemplate;
+        }
+        const result = await api.fetch(relayPath, {
+          method: fetchInit.method ?? "GET",
           body: fetchInit.body,
-          headers: fetchInit.headers,
-          authenticationId,
-          callbackUrl,
-          authenticationTemplate,
-          _telemetry: { isNested: true }
-        });
-        context.eventEmission.emitMethodCalled({
-          method_name: "fetch",
-          execution_duration_ms: Date.now() - startTime,
-          success_flag: true,
-          error_message: null,
-          error_type: null,
-          argument_count: init ? 2 : 1,
-          is_paginated: false
+          headers,
+          authRequired: true
         });
+        if (!isNested) {
+          context.eventEmission.emitMethodCalled({
+            method_name: "fetch",
+            execution_duration_ms: Date.now() - startTime,
+            success_flag: true,
+            error_message: null,
+            error_type: null,
+            argument_count: init ? 2 : 1,
+            is_paginated: false
+          });
+        }
         return result;
       } catch (error) {
-        context.eventEmission.emitMethodCalled({
-          method_name: "fetch",
-          execution_duration_ms: Date.now() - startTime,
-          success_flag: false,
-          error_message: error instanceof Error ? error.message : String(error),
-          error_type: error instanceof Error ? error.constructor.name : "Unknown",
-          argument_count: init ? 2 : 1,
-          is_paginated: false
-        });
+        if (!isNested) {
+          context.eventEmission.emitMethodCalled({
+            method_name: "fetch",
+            execution_duration_ms: Date.now() - startTime,
+            success_flag: false,
+            error_message: error instanceof Error ? error.message : String(error),
+            error_type: error instanceof Error ? error.constructor.name : "Unknown",
+            argument_count: init ? 2 : 1,
+            is_paginated: false
+          });
+        }
         throw error;
       }
     },
     context: {
       meta: {
         fetch: {
-          packages: ["sdk"],
+          description: "Make authenticated HTTP requests to any API through Zapier's Relay service. Pass an authenticationId 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"],
           categories: ["http"],
           returnType: "Response",
           inputParameters: [
@@ -1805,20 +1870,6 @@ var RootFieldItemSchema = z.union([
   FieldsetItemSchema
 ]);
 
-// src/utils/id-utils.ts
-function coerceToNumericId(fieldName, value) {
-  if (value === "") {
-    throw new ZapierValidationError(`The ${fieldName} cannot be empty`);
-  }
-  const numericValue = typeof value === "number" ? value : Number(value);
-  if (!Number.isFinite(numericValue)) {
-    throw new ZapierValidationError(
-      `The ${fieldName} "${value}" could not be converted to a number`
-    );
-  }
-  return numericValue;
-}
-
 // src/services/implementations.ts
 async function fetchImplementationNeeds({
   api,
@@ -2801,64 +2852,41 @@ var RelayRequestSchema = z.object({
     z.instanceof(Headers),
     z.array(z.tuple([z.string(), z.string()]))
   ]).optional().describe("Request headers")
-}).extend({
-  relayBaseUrl: z.string().optional().describe("Base URL for Relay service")
 }).merge(TelemetryMarkerSchema).describe("Make authenticated HTTP requests through Zapier's Relay service");
 var RelayFetchSchema = RelayRequestSchema;
 
-// src/plugins/request/index.ts
-function transformUrlToRelayPath(url) {
-  const targetUrl = new URL(url);
-  const relayPath = `/relay/${targetUrl.host}${targetUrl.pathname}${targetUrl.search}${targetUrl.hash}`;
-  return relayPath;
+// src/utils/logging.ts
+var loggedDeprecations = /* @__PURE__ */ new Set();
+function logDeprecation(message) {
+  if (loggedDeprecations.has(message)) return;
+  loggedDeprecations.add(message);
+  console.warn(`[zapier-sdk] Deprecation: ${message}`);
+}
+function resetDeprecationWarnings() {
+  loggedDeprecations.clear();
 }
-var requestPlugin = ({ context }) => {
+
+// src/plugins/request/index.ts
+var requestPlugin = ({ sdk, context }) => {
   async function request(options) {
-    const { api } = context;
+    logDeprecation("request() is deprecated. Use fetch() instead.");
     const {
       url,
-      method = "GET",
+      method,
       body,
-      headers: optionsHeaders,
+      headers,
       authenticationId,
       callbackUrl,
       authenticationTemplate
     } = options;
-    const relayPath = transformUrlToRelayPath(url);
-    const headers = {};
-    if (optionsHeaders) {
-      const headerEntries = optionsHeaders instanceof Headers ? Array.from(optionsHeaders.entries()) : Array.isArray(optionsHeaders) ? optionsHeaders : Object.entries(optionsHeaders);
-      for (const [key, value] of headerEntries) {
-        headers[key] = value;
-      }
-    }
-    const hasContentType = Object.keys(headers).some(
-      (k) => k.toLowerCase() === "content-type"
-    );
-    if (body && !hasContentType) {
-      const bodyStr = typeof body === "string" ? body : JSON.stringify(body);
-      const trimmed = bodyStr.trimStart();
-      if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-        headers["Content-Type"] = "application/json; charset=utf-8";
-      }
-    }
-    if (authenticationId) {
-      headers["X-Relay-Authentication-Id"] = coerceToNumericId(
-        "authenticationId",
-        authenticationId
-      ).toString();
-    }
-    if (callbackUrl) {
-      headers["X-Relay-Callback-Url"] = callbackUrl;
-    }
-    if (authenticationTemplate) {
-      headers["X-Authentication-Template"] = authenticationTemplate;
-    }
-    return await api.fetch(relayPath, {
+    return sdk.fetch(url, {
       method,
       body,
       headers,
-      authRequired: true
+      authenticationId,
+      callbackUrl,
+      authenticationTemplate,
+      _telemetry: { isNested: true }
     });
   }
   const requestDefinition = createFunction(
@@ -2874,7 +2902,8 @@ var requestPlugin = ({ context }) => {
     context: {
       meta: {
         request: {
-          categories: ["http"],
+          packages: ["cli", "mcp"],
+          categories: ["http", "deprecated"],
           returnType: "Response",
           inputSchema: RelayRequestSchema
         }
@@ -3747,17 +3776,6 @@ function isCredentialsFunction(credentials) {
   return typeof credentials === "function";
 }
 
-// src/utils/logging.ts
-var loggedDeprecations = /* @__PURE__ */ new Set();
-function logDeprecation(message) {
-  if (loggedDeprecations.has(message)) return;
-  loggedDeprecations.add(message);
-  console.warn(`[zapier-sdk] Deprecation: ${message}`);
-}
-function resetDeprecationWarnings() {
-  loggedDeprecations.clear();
-}
-
 // src/utils/url-utils.ts
 function getZapierBaseUrl(baseUrl) {
   if (!baseUrl) {
@@ -4615,6 +4633,7 @@ var registryPlugin = ({ sdk, context }) => {
     const meta = context.meta[key];
     return {
       name: key,
+      description: meta.description,
       type: meta.type,
       itemType: meta.itemType,
       returnType: meta.returnType,
@@ -5075,7 +5094,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.23.2"};
+  version: "0.24.0"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5529,7 +5548,7 @@ function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} })
   };
 }
 function createZapierSdkWithoutRegistry(options = {}) {
-  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(requestPlugin).addPlugin(fetchPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
+  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);

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

@@ -1,5 +1,5 @@
-import type { Plugin, GetSdkType } from "../../types/plugin";
-import type { RequestPluginProvides } from "../request";
+import type { Plugin } from "../../types/plugin";
+import type { ApiClient } from "../../api";
 import type { z } from "zod";
 import type { EventEmissionContext } from "../eventEmission";
 export interface FetchPluginProvides {
@@ -7,10 +7,14 @@ export interface FetchPluginProvides {
         authenticationId?: string | number;
         callbackUrl?: string;
         authenticationTemplate?: string;
+        _telemetry?: {
+            isNested?: boolean;
+        };
     }) => Promise<Response>;
     context: {
         meta: {
             fetch: {
+                description: string;
                 packages: string[];
                 categories: string[];
                 returnType: string;
@@ -23,10 +27,14 @@ export interface FetchPluginProvides {
     };
 }
 /**
- * Direct plugin function - takes options + sdk + context in one object
+ * Fetch plugin — the primary way to make authenticated HTTP requests through Zapier's Relay service.
+ * Mirrors the native fetch(url, init?) signature with additional Zapier-specific options.
  */
-export declare const fetchPlugin: Plugin<GetSdkType<RequestPluginProvides>, // requires request in SDK
-EventEmissionContext, // requires eventEmission context for telemetry
+export declare const fetchPlugin: Plugin<{}, // no SDK dependencies
+// no SDK dependencies
+{
+    api: ApiClient;
+} & EventEmissionContext, // requires api + eventEmission in context
 FetchPluginProvides>;
 export type ZapierFetchInitOptions = RequestInit & {
     authenticationId?: string | number;

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":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,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,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,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;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,UAAU,CAAC,qBAAqB,CAAC,EAAE,0BAA0B;AAC7D,oBAAoB,EAAE,+CAA+C;AACrE,mBAAmB,CA2EpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,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;AAoC7D,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,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,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,CAsHpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC"}

package/dist/plugins/fetch/index.js

@@ -1,54 +1,106 @@
 import { FetchUrlSchema, FetchInitSchema } from "./schemas";
+import { coerceToNumericId } from "../../utils/id-utils";
 /**
- * Direct plugin function - takes options + sdk + context in one object
+ * Transforms full URLs into Relay format: /relay/{domain}/{path}
  */
-export const fetchPlugin = ({ sdk, context }) => {
-    // Return flat structure - fetch goes directly to SDK
+function transformUrlToRelayPath(url) {
+    const targetUrl = new URL(url);
+    return `/relay/${targetUrl.host}${targetUrl.pathname}${targetUrl.search}${targetUrl.hash}`;
+}
+/**
+ * Normalizes various header formats into a plain Record<string, string>.
+ */
+function normalizeHeaders(optionsHeaders) {
+    const headers = {};
+    if (!optionsHeaders) {
+        return headers;
+    }
+    const headerEntries = optionsHeaders instanceof Headers
+        ? Array.from(optionsHeaders.entries())
+        : Array.isArray(optionsHeaders)
+            ? optionsHeaders
+            : Object.entries(optionsHeaders);
+    for (const [key, value] of headerEntries) {
+        headers[key] = value;
+    }
+    return headers;
+}
+/**
+ * Fetch plugin — the primary way to make authenticated HTTP requests through Zapier's Relay service.
+ * Mirrors the native fetch(url, init?) signature with additional Zapier-specific options.
+ */
+export const fetchPlugin = ({ context }) => {
     return {
         fetch: async function fetch(url, init) {
+            const { api } = context;
             const startTime = Date.now();
+            const isNested = init?._telemetry?.isNested === true;
             try {
-                const { authenticationId, callbackUrl, authenticationTemplate, ...fetchInit } = init || {};
-                const result = await sdk.request({
-                    url: url.toString(),
-                    method: fetchInit.method,
+                const { authenticationId, callbackUrl, authenticationTemplate, _telemetry, ...fetchInit } = init || {};
+                const relayPath = transformUrlToRelayPath(url);
+                const headers = normalizeHeaders(fetchInit.headers);
+                // Auto-set Content-Type for JSON bodies if not already specified
+                const hasContentType = Object.keys(headers).some((k) => k.toLowerCase() === "content-type");
+                if (fetchInit.body && !hasContentType) {
+                    const bodyStr = typeof fetchInit.body === "string"
+                        ? fetchInit.body
+                        : JSON.stringify(fetchInit.body);
+                    const trimmed = bodyStr.trimStart();
+                    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+                        headers["Content-Type"] = "application/json; charset=utf-8";
+                    }
+                }
+                if (authenticationId) {
+                    headers["X-Relay-Authentication-Id"] = coerceToNumericId("authenticationId", authenticationId).toString();
+                }
+                if (callbackUrl) {
+                    headers["X-Relay-Callback-Url"] = callbackUrl;
+                }
+                if (authenticationTemplate) {
+                    headers["X-Authentication-Template"] = authenticationTemplate;
+                }
+                const result = await api.fetch(relayPath, {
+                    method: fetchInit.method ?? "GET",
                     body: fetchInit.body,
-                    headers: fetchInit.headers,
-                    authenticationId,
-                    callbackUrl,
-                    authenticationTemplate,
-                    _telemetry: { isNested: true },
-                });
-                // Emit success telemetry
-                context.eventEmission.emitMethodCalled({
-                    method_name: "fetch",
-                    execution_duration_ms: Date.now() - startTime,
-                    success_flag: true,
-                    error_message: null,
-                    error_type: null,
-                    argument_count: init ? 2 : 1,
-                    is_paginated: false,
+                    headers,
+                    authRequired: true,
                 });
+                if (!isNested) {
+                    context.eventEmission.emitMethodCalled({
+                        method_name: "fetch",
+                        execution_duration_ms: Date.now() - startTime,
+                        success_flag: true,
+                        error_message: null,
+                        error_type: null,
+                        argument_count: init ? 2 : 1,
+                        is_paginated: false,
+                    });
+                }
                 return result;
             }
             catch (error) {
-                // Emit failure telemetry
-                context.eventEmission.emitMethodCalled({
-                    method_name: "fetch",
-                    execution_duration_ms: Date.now() - startTime,
-                    success_flag: false,
-                    error_message: error instanceof Error ? error.message : String(error),
-                    error_type: error instanceof Error ? error.constructor.name : "Unknown",
-                    argument_count: init ? 2 : 1,
-                    is_paginated: false,
-                });
+                if (!isNested) {
+                    context.eventEmission.emitMethodCalled({
+                        method_name: "fetch",
+                        execution_duration_ms: Date.now() - startTime,
+                        success_flag: false,
+                        error_message: error instanceof Error ? error.message : String(error),
+                        error_type: error instanceof Error ? error.constructor.name : "Unknown",
+                        argument_count: init ? 2 : 1,
+                        is_paginated: false,
+                    });
+                }
                 throw error;
             }
         },
         context: {
             meta: {
                 fetch: {
-                    packages: ["sdk"],
+                    description: "Make authenticated HTTP requests to any API through Zapier's Relay service. " +
+                        "Pass an authenticationId 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"],
                     categories: ["http"],
                     returnType: "Response",
                     inputParameters: [

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

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

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

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