@zapier/zapier-sdk 0.15.10 → 0.15.12

package/dist/temporary-internal-core/schemas/apps/index.js

@@ -8,6 +8,7 @@
  */
 import { z } from "zod";
 import { ImplementationMetaSchema } from "../implementations";
+import { TelemetryMarkerSchema } from "../../../utils/function-utils";
 /**
  * Public API schema for listApps operation
  *
@@ -29,6 +30,7 @@ export const ListAppsOptionsSchema = z
         .describe("Maximum total items to return across all pages"),
     cursor: z.string().optional().describe("Cursor to start from"),
 })
+    .merge(TelemetryMarkerSchema)
     .describe("List all available apps with optional filtering");
 /**
  * Normalized app item returned by listApps

package/dist/types/telemetry-events.d.ts

@@ -71,6 +71,35 @@ export interface ApplicationLifecycleEvent extends BaseEvent {
     shutdown_duration_ms?: number | null;
     active_requests_count?: number | null;
 }
-export type TelemetryEvent = ErrorOccurredEvent | ApplicationLifecycleEvent;
-export type TelemetryEventType = "error_occurred" | "application_lifecycle";
+export interface MethodCalledEvent extends BaseEvent {
+    method_name: string;
+    method_module: string | null;
+    execution_duration_ms: number;
+    success_flag: boolean;
+    error_message: string | null;
+    error_type: string | null;
+    argument_count: number;
+    is_paginated: boolean;
+    sdk_version: string;
+    environment: string | null;
+    selected_api: string | null;
+    app_id: number | null;
+    app_version_id: number | null;
+    zap_id: number | null;
+    node_id: number | null;
+    operation_type: string | null;
+    operation_key: string | null;
+    call_context: string | null;
+    is_retry: boolean;
+    retry_attempt: number | null;
+    argument_types: string[] | null;
+    return_type: string | null;
+    caller_method: string | null;
+    call_stack_depth: number | null;
+    is_synchronous: boolean | null;
+    cpu_time_ms: number | null;
+    memory_usage_bytes: number | null;
+}
+export type TelemetryEvent = ErrorOccurredEvent | ApplicationLifecycleEvent | MethodCalledEvent;
+export type TelemetryEventType = "error_occurred" | "application_lifecycle" | "method_called";
 //# sourceMappingURL=telemetry-events.d.ts.map

package/dist/types/telemetry-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-events.d.ts","sourceRoot":"","sources":["../../src/types/telemetry-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telemetry-events.d.ts","sourceRoot":"","sources":["../../src/types/telemetry-events.ts"],"names":[],"mappings":"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"}

package/dist/utils/function-utils.d.ts

@@ -1,7 +1,45 @@
 /**
  * Generic utility functions for creating paginated SDK functions
  */
-import type { z } from "zod";
+import { z } from "zod";
+/**
+ * Zod schema for telemetry marker to prevent nested telemetry emissions.
+ * Used to extend options schemas with proper typing.
+ */
+export declare const TelemetryMarkerSchema: z.ZodObject<{
+    _telemetry: z.ZodOptional<z.ZodObject<{
+        isNested: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        isNested?: boolean | undefined;
+    }, {
+        isNested?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    _telemetry?: {
+        isNested?: boolean | undefined;
+    } | undefined;
+}, {
+    _telemetry?: {
+        isNested?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Marker for SDK method calls to control telemetry behavior
+ */
+export type TelemetryMarker = z.infer<typeof TelemetryMarkerSchema>;
+/**
+ * Callbacks for telemetry events during function execution
+ */
+export interface TelemetryCallbacks {
+    onMethodCalled?: (data: {
+        methodName: string;
+        durationMs: number;
+        success: boolean;
+        error?: Error;
+        argumentCount: number;
+        isPaginated: boolean;
+    }) => void;
+}
 /**
  * Helper function to extract cursor from pagination data
  */
@@ -13,9 +51,10 @@ export declare function extractCursor(data: {
  *
  * @param coreFn - Function that returns T directly or throws errors
  * @param schema - Optional Zod schema for validation
+ * @param telemetry - Optional telemetry callbacks
  * @returns A function that normalizes and rethrows errors
  */
-export declare function createFunction<TOptions, TResult, TSchemaOptions extends TOptions = TOptions>(coreFn: (options: TOptions) => Promise<TResult>, schema?: z.ZodSchema<TSchemaOptions>): (options?: TOptions) => Promise<TResult>;
+export declare function createFunction<TOptions, TResult, TSchemaOptions extends TOptions = TOptions>(coreFn: (options: TOptions) => Promise<TResult>, schema?: z.ZodSchema<TSchemaOptions>, telemetry?: TelemetryCallbacks): (options?: TOptions) => Promise<TResult>;
 /**
  * Higher-order function that creates a paginated function that wraps results in {data}
  *
@@ -34,7 +73,7 @@ type ItemType<TResult> = TResult extends {
 } ? TData extends readonly (infer TItem)[] ? TItem : TData : TResult extends readonly (infer TItem)[] ? TItem : TResult;
 export declare function createPaginatedFunction<TOptions, TResult, TSchemaOptions extends TOptions = TOptions>(coreFn: (options: TOptions & {
     pageSize: number;
-}) => Promise<TResult>, schema?: z.ZodSchema<TSchemaOptions>): (options?: TOptions & {
+}) => Promise<TResult>, schema?: z.ZodSchema<TSchemaOptions>, telemetry?: TelemetryCallbacks, explicitFunctionName?: string): (options?: TOptions & {
     cursor?: string;
     pageSize?: number;
     maxItems?: number;

package/dist/utils/function-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-utils.d.ts","sourceRoot":"","sources":["../../src/utils/function-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAK7B;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,GAAG,SAAS,CAYpB;AAcD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EACR,OAAO,EACP,cAAc,SAAS,QAAQ,GAAG,QAAQ,EAE1C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,EAC/C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,cAMQ,QAAQ,KAAG,OAAO,CAAC,OAAO,CAAC,CAqBxE;AAiDD;;;;;GAKG;AACH,KAAK,eAAe,CAAC,OAAO,IAAI,OAAO,SAAS;IAC9C,IAAI,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACG,OAAO,GACP;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,KAAK,QAAQ,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,GAC1D,KAAK,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACpC,KAAK,GACL,KAAK,GACP,OAAO,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACtC,KAAK,GACL,OAAO,CAAC;AAEd,wBAAgB,uBAAuB,CACrC,QAAQ,EACR,OAAO,EACP,cAAc,SAAS,QAAQ,GAAG,QAAQ,EAE1C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACtE,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,GACnC,CACD,OAAO,CAAC,EAAE,QAAQ,GAAG;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GACpC,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG;IACxC,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3C,CA8EF"}
+{"version":3,"file":"function-utils.d.ts","sourceRoot":"","sources":["../../src/utils/function-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;KACtB,KAAK,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,GAAG,SAAS,CAYpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EACR,OAAO,EACP,cAAc,SAAS,QAAQ,GAAG,QAAQ,EAE1C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,EAC/C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EACpC,SAAS,CAAC,EAAE,kBAAkB,cAMc,QAAQ,KAAG,OAAO,CAAC,OAAO,CAAC,CAsExE;AAiDD;;;;;GAKG;AACH,KAAK,eAAe,CAAC,OAAO,IAAI,OAAO,SAAS;IAC9C,IAAI,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACG,OAAO,GACP;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,KAAK,QAAQ,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,GAC1D,KAAK,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACpC,KAAK,GACL,KAAK,GACP,OAAO,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACtC,KAAK,GACL,OAAO,CAAC;AAEd,wBAAgB,uBAAuB,CACrC,QAAQ,EACR,OAAO,EACP,cAAc,SAAS,QAAQ,GAAG,QAAQ,EAE1C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACtE,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EACpC,SAAS,CAAC,EAAE,kBAAkB,EAC9B,oBAAoB,CAAC,EAAE,MAAM,GAC5B,CACD,OAAO,CAAC,EAAE,QAAQ,GAAG;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GACpC,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG;IACxC,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3C,CAgHF"}

package/dist/utils/function-utils.js

@@ -1,9 +1,21 @@
 /**
  * Generic utility functions for creating paginated SDK functions
  */
+import { z } from "zod";
 import { ZapierError, ZapierUnknownError } from "../types/errors";
 import { paginate } from "./pagination-utils";
 import { createValidator, validateOptions } from "./validation";
+/**
+ * Zod schema for telemetry marker to prevent nested telemetry emissions.
+ * Used to extend options schemas with proper typing.
+ */
+export const TelemetryMarkerSchema = z.object({
+    _telemetry: z
+        .object({
+        isNested: z.boolean().optional(),
+    })
+        .optional(),
+});
 /**
  * Helper function to extract cursor from pagination data
  */
@@ -35,28 +47,64 @@ function normalizeError(error) {
  *
  * @param coreFn - Function that returns T directly or throws errors
  * @param schema - Optional Zod schema for validation
+ * @param telemetry - Optional telemetry callbacks
  * @returns A function that normalizes and rethrows errors
  */
-export function createFunction(coreFn, schema) {
+export function createFunction(coreFn, schema, telemetry) {
     const functionName = coreFn.name;
     // Create a named function using dynamic property access
     const namedFunctions = {
         [functionName]: async function (options) {
+            const startTime = Date.now();
+            const normalizedOptions = (options ?? {});
+            const isNested = normalizedOptions?._telemetry?.isNested === true;
             try {
-                // Convert undefined options to empty object
-                const normalizedOptions = (options ?? {});
                 if (schema) {
                     const validatedOptions = validateOptions(schema, normalizedOptions);
-                    return await coreFn({
+                    const result = await coreFn({
                         ...normalizedOptions,
                         ...validatedOptions,
                     });
+                    // Emit telemetry only for top-level calls
+                    if (!isNested && telemetry?.onMethodCalled) {
+                        const argumentCount = Object.keys(normalizedOptions).filter((k) => k !== "_telemetry").length;
+                        telemetry.onMethodCalled({
+                            methodName: functionName,
+                            durationMs: Date.now() - startTime,
+                            success: true,
+                            argumentCount,
+                            isPaginated: false,
+                        });
+                    }
+                    return result;
                 }
-                return await coreFn(normalizedOptions);
+                const result = await coreFn(normalizedOptions);
+                if (!isNested && telemetry?.onMethodCalled) {
+                    const argumentCount = Object.keys(normalizedOptions).filter((k) => k !== "_telemetry").length;
+                    telemetry.onMethodCalled({
+                        methodName: functionName,
+                        durationMs: Date.now() - startTime,
+                        success: true,
+                        argumentCount,
+                        isPaginated: false,
+                    });
+                }
+                return result;
             }
             catch (error) {
-                // Catch and normalize any errors, then rethrow
-                throw normalizeError(error);
+                const normalizedError = normalizeError(error);
+                if (!isNested && telemetry?.onMethodCalled) {
+                    const argumentCount = Object.keys(normalizedOptions).filter((k) => k !== "_telemetry").length;
+                    telemetry.onMethodCalled({
+                        methodName: functionName,
+                        durationMs: Date.now() - startTime,
+                        success: false,
+                        error: normalizedError,
+                        argumentCount,
+                        isPaginated: false,
+                    });
+                }
+                throw normalizedError;
             }
         },
     };
@@ -96,15 +144,17 @@ function createPageFunction(coreFn) {
     };
     return namedFunctions[functionName];
 }
-export function createPaginatedFunction(coreFn, schema) {
+export function createPaginatedFunction(coreFn, schema, telemetry, explicitFunctionName) {
     const pageFunction = createPageFunction(coreFn);
-    const functionName = coreFn.name;
+    const functionName = explicitFunctionName || coreFn.name;
     const validator = schema ? createValidator(schema) : null;
     // Create the main paginated function
     const namedFunctions = {
         [functionName]: function (options) {
+            const startTime = Date.now();
             // Convert undefined options to empty object
             const normalizedOptions = (options ?? {});
+            const isNested = normalizedOptions?._telemetry?.isNested === true;
             // Validate options if schema provided (validated fields take precedence)
             const validatedOptions = {
                 ...normalizedOptions,
@@ -124,6 +174,31 @@ export function createPaginatedFunction(coreFn, schema) {
                 }
                 return result.value;
             });
+            // Emit telemetry after first page completes
+            if (!isNested && telemetry?.onMethodCalled) {
+                firstPagePromise
+                    .then(() => {
+                    const argumentCount = Object.keys(normalizedOptions).filter((k) => k !== "_telemetry").length;
+                    telemetry.onMethodCalled({
+                        methodName: functionName,
+                        durationMs: Date.now() - startTime,
+                        success: true,
+                        argumentCount,
+                        isPaginated: true,
+                    });
+                })
+                    .catch((error) => {
+                    const argumentCount = Object.keys(normalizedOptions).filter((k) => k !== "_telemetry").length;
+                    telemetry.onMethodCalled({
+                        methodName: functionName,
+                        durationMs: Date.now() - startTime,
+                        success: false,
+                        error: error instanceof Error ? error : new Error(String(error)),
+                        argumentCount,
+                        isPaginated: true,
+                    });
+                });
+            }
             // Add Symbol.asyncIterator to make the promise iterable
             return Object.assign(firstPagePromise, {
                 [Symbol.asyncIterator]: async function* () {

package/dist/utils/string-utils.d.ts

@@ -18,4 +18,23 @@ export declare function toTitleCase(input: string): string;
  * - starts with number: "123abc" → "_123abc"
  */
 export declare function toSnakeCase(input: string): string;
+/**
+ * Strips the "Page" suffix from a function name, used for deriving method names
+ * from paginated function implementations.
+ *
+ * This is commonly used with `createPaginatedFunction` where the internal function
+ * has a "Page" suffix (e.g., "listAppsPage") but the public method name should not
+ * (e.g., "listApps").
+ *
+ * @param functionName - The function name, typically from `function.name`
+ * @returns The function name with "Page" suffix removed, or original if no suffix
+ *
+ * @example
+ * ```typescript
+ * stripPageSuffix("listAppsPage") // "listApps"
+ * stripPageSuffix("listApps") // "listApps" (no change)
+ * stripPageSuffix("myPageFunction") // "myPageFunction" (only strips from end)
+ * ```
+ */
+export declare function stripPageSuffix(functionName: string): string;
 //# sourceMappingURL=string-utils.d.ts.map

package/dist/utils/string-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjD"}
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/string-utils.js

@@ -46,3 +46,24 @@ export function toSnakeCase(input) {
     }
     return result;
 }
+/**
+ * Strips the "Page" suffix from a function name, used for deriving method names
+ * from paginated function implementations.
+ *
+ * This is commonly used with `createPaginatedFunction` where the internal function
+ * has a "Page" suffix (e.g., "listAppsPage") but the public method name should not
+ * (e.g., "listApps").
+ *
+ * @param functionName - The function name, typically from `function.name`
+ * @returns The function name with "Page" suffix removed, or original if no suffix
+ *
+ * @example
+ * ```typescript
+ * stripPageSuffix("listAppsPage") // "listApps"
+ * stripPageSuffix("listApps") // "listApps" (no change)
+ * stripPageSuffix("myPageFunction") // "myPageFunction" (only strips from end)
+ * ```
+ */
+export function stripPageSuffix(functionName) {
+    return functionName.replace(/Page$/, "");
+}

package/dist/utils/string-utils.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { toTitleCase } from "./string-utils";
+import { toTitleCase, stripPageSuffix } from "./string-utils";
 describe("toTitleCase", () => {
     it("converts snake_case to title case", () => {
         expect(toTitleCase("first_name")).toBe("First Name");
@@ -34,3 +34,26 @@ describe("toTitleCase", () => {
         expect(toTitleCase("_")).toBe("");
     });
 });
+describe("stripPageSuffix", () => {
+    it("strips Page suffix from function names", () => {
+        expect(stripPageSuffix("listAppsPage")).toBe("listApps");
+        expect(stripPageSuffix("listActionsPage")).toBe("listActions");
+        expect(stripPageSuffix("runActionPage")).toBe("runAction");
+        expect(stripPageSuffix("listAuthenticationsPage")).toBe("listAuthentications");
+    });
+    it("leaves names without Page suffix unchanged", () => {
+        expect(stripPageSuffix("listApps")).toBe("listApps");
+        expect(stripPageSuffix("getProfile")).toBe("getProfile");
+        expect(stripPageSuffix("request")).toBe("request");
+    });
+    it("only strips Page from the end", () => {
+        expect(stripPageSuffix("myPageFunction")).toBe("myPageFunction");
+        expect(stripPageSuffix("PageList")).toBe("PageList");
+        expect(stripPageSuffix("getPageData")).toBe("getPageData");
+    });
+    it("handles edge cases", () => {
+        expect(stripPageSuffix("Page")).toBe("");
+        expect(stripPageSuffix("")).toBe("");
+        expect(stripPageSuffix("p")).toBe("p");
+    });
+});

package/dist/utils/telemetry-utils.d.ts

@@ -0,0 +1,44 @@
+import type { TelemetryCallbacks } from "./function-utils";
+import type { EventEmissionContext } from "../plugins/eventEmission";
+/**
+ * Creates a standardized telemetry callback for SDK method invocations.
+ *
+ * This factory eliminates boilerplate by providing a consistent implementation
+ * of the onMethodCalled callback used by createFunction and createPaginatedFunction.
+ *
+ * @param emitMethodCalled - The event emission function from EventEmissionContext
+ * @param methodName - The method name to report in telemetry. Use `function.name` to derive
+ *   this automatically from the function declaration, ensuring DRY principles and making
+ *   refactoring easier. Function names are preserved through bundling.
+ * @returns TelemetryCallbacks object with standardized onMethodCalled implementation
+ *
+ * @example
+ * Basic usage with createFunction:
+ * ```typescript
+ * async function listApps(options: ListAppsOptions) { ... }
+ *
+ * const listAppsDefinition = createFunction(
+ *   listApps,
+ *   ListAppsSchema,
+ *   createTelemetryCallback(context.eventEmission.emitMethodCalled, listApps.name),
+ * );
+ * ```
+ *
+ * @example
+ * For paginated functions, use stripPageSuffix to remove the "Page" suffix:
+ * ```typescript
+ * import { stripPageSuffix } from "./string-utils";
+ *
+ * async function listAppsPage(options: ListAppsOptions & { pageSize: number }) { ... }
+ *
+ * const methodName = stripPageSuffix(listAppsPage.name);
+ * const listAppsDefinition = createPaginatedFunction(
+ *   listAppsPage,
+ *   ListAppsSchema,
+ *   createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
+ *   methodName,
+ * );
+ * ```
+ */
+export declare function createTelemetryCallback(emitMethodCalled: EventEmissionContext["eventEmission"]["emitMethodCalled"], methodName: string): TelemetryCallbacks;
+//# sourceMappingURL=telemetry-utils.d.ts.map

package/dist/utils/telemetry-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-utils.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC,EAC3E,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAcpB"}

package/dist/utils/telemetry-utils.js

@@ -0,0 +1,55 @@
+/**
+ * Creates a standardized telemetry callback for SDK method invocations.
+ *
+ * This factory eliminates boilerplate by providing a consistent implementation
+ * of the onMethodCalled callback used by createFunction and createPaginatedFunction.
+ *
+ * @param emitMethodCalled - The event emission function from EventEmissionContext
+ * @param methodName - The method name to report in telemetry. Use `function.name` to derive
+ *   this automatically from the function declaration, ensuring DRY principles and making
+ *   refactoring easier. Function names are preserved through bundling.
+ * @returns TelemetryCallbacks object with standardized onMethodCalled implementation
+ *
+ * @example
+ * Basic usage with createFunction:
+ * ```typescript
+ * async function listApps(options: ListAppsOptions) { ... }
+ *
+ * const listAppsDefinition = createFunction(
+ *   listApps,
+ *   ListAppsSchema,
+ *   createTelemetryCallback(context.eventEmission.emitMethodCalled, listApps.name),
+ * );
+ * ```
+ *
+ * @example
+ * For paginated functions, use stripPageSuffix to remove the "Page" suffix:
+ * ```typescript
+ * import { stripPageSuffix } from "./string-utils";
+ *
+ * async function listAppsPage(options: ListAppsOptions & { pageSize: number }) { ... }
+ *
+ * const methodName = stripPageSuffix(listAppsPage.name);
+ * const listAppsDefinition = createPaginatedFunction(
+ *   listAppsPage,
+ *   ListAppsSchema,
+ *   createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
+ *   methodName,
+ * );
+ * ```
+ */
+export function createTelemetryCallback(emitMethodCalled, methodName) {
+    return {
+        onMethodCalled: (data) => {
+            emitMethodCalled({
+                method_name: methodName,
+                execution_duration_ms: data.durationMs,
+                success_flag: data.success,
+                error_message: data.error?.message ?? null,
+                error_type: data.error?.constructor.name ?? null,
+                argument_count: data.argumentCount,
+                is_paginated: data.isPaginated,
+            });
+        },
+    };
+}

package/dist/utils/telemetry-utils.test.d.ts

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

package/dist/utils/telemetry-utils.test.d.ts.map

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

package/dist/utils/telemetry-utils.test.js

@@ -0,0 +1,94 @@
+import { describe, it, expect, vi } from "vitest";
+import { createTelemetryCallback } from "./telemetry-utils";
+describe("createTelemetryCallback", () => {
+    it("should create callback that emits telemetry with explicit method name", () => {
+        const mockEmit = vi.fn();
+        const callback = createTelemetryCallback(mockEmit, "testMethod");
+        callback.onMethodCalled({
+            methodName: "ignoredName",
+            durationMs: 123,
+            success: true,
+            argumentCount: 2,
+            isPaginated: false,
+        });
+        expect(mockEmit).toHaveBeenCalledWith({
+            method_name: "testMethod",
+            execution_duration_ms: 123,
+            success_flag: true,
+            error_message: null,
+            error_type: null,
+            argument_count: 2,
+            is_paginated: false,
+        });
+    });
+    it("should include error details when method fails", () => {
+        const mockEmit = vi.fn();
+        const callback = createTelemetryCallback(mockEmit, "failingMethod");
+        const testError = new Error("Test failure");
+        callback.onMethodCalled({
+            methodName: "ignoredName",
+            durationMs: 50,
+            success: false,
+            error: testError,
+            argumentCount: 1,
+            isPaginated: false,
+        });
+        expect(mockEmit).toHaveBeenCalledWith({
+            method_name: "failingMethod",
+            execution_duration_ms: 50,
+            success_flag: false,
+            error_message: "Test failure",
+            error_type: "Error",
+            argument_count: 1,
+            is_paginated: false,
+        });
+    });
+    it("should handle paginated method calls", () => {
+        const mockEmit = vi.fn();
+        const callback = createTelemetryCallback(mockEmit, "listItems");
+        callback.onMethodCalled({
+            methodName: "ignoredName",
+            durationMs: 200,
+            success: true,
+            argumentCount: 1,
+            isPaginated: true,
+        });
+        expect(mockEmit).toHaveBeenCalledWith({
+            method_name: "listItems",
+            execution_duration_ms: 200,
+            success_flag: true,
+            error_message: null,
+            error_type: null,
+            argument_count: 1,
+            is_paginated: true,
+        });
+    });
+    it("should handle custom error types", () => {
+        const mockEmit = vi.fn();
+        const callback = createTelemetryCallback(mockEmit, "customFailMethod");
+        class CustomError extends Error {
+            constructor(message) {
+                super(message);
+                this.name = "CustomError";
+            }
+        }
+        const customError = new CustomError("Custom failure");
+        callback.onMethodCalled({
+            methodName: "ignoredName",
+            durationMs: 75,
+            success: false,
+            error: customError,
+            argumentCount: 3,
+            isPaginated: false,
+        });
+        expect(mockEmit).toHaveBeenCalledWith({
+            method_name: "customFailMethod",
+            execution_duration_ms: 75,
+            success_flag: false,
+            error_message: "Custom failure",
+            error_type: "CustomError",
+            argument_count: 3,
+            is_paginated: false,
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.15.10",
+  "version": "0.15.12",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",