@zapier/zapier-sdk 0.15.11 → 0.15.13

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

@@ -7,24 +7,36 @@ import type { EventEmissionContext } from "../plugins/eventEmission";
  * of the onMethodCalled callback used by createFunction and createPaginatedFunction.
  *
  * @param emitMethodCalled - The event emission function from EventEmissionContext
- * @param methodName - The explicit method name to use in telemetry. This avoids bundler
- *   mangling where esbuild/tsup renames inner functions to avoid collisions. For example:
- *   ```typescript
- *   // Source code:
- *   const getAction = createFunction(async function getAction(options) { ... });
- *
- *   // Bundled output (inner function renamed to avoid collision with outer const):
- *   const getAction = createFunction(async function getAction2(options) { ... });
- *   ```
- *   Without an explicit methodName, telemetry would report "getAction2" instead of "getAction".
+ * @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
- * const listApps = createFunction(
- *   async function listApps(options) { ... },
+ * 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, "listApps"),
+ *   createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
+ *   methodName,
  * );
  * ```
  */

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC,EAC3E,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAcpB"}
+{"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

@@ -5,24 +5,36 @@
  * of the onMethodCalled callback used by createFunction and createPaginatedFunction.
  *
  * @param emitMethodCalled - The event emission function from EventEmissionContext
- * @param methodName - The explicit method name to use in telemetry. This avoids bundler
- *   mangling where esbuild/tsup renames inner functions to avoid collisions. For example:
- *   ```typescript
- *   // Source code:
- *   const getAction = createFunction(async function getAction(options) { ... });
- *
- *   // Bundled output (inner function renamed to avoid collision with outer const):
- *   const getAction = createFunction(async function getAction2(options) { ... });
- *   ```
- *   Without an explicit methodName, telemetry would report "getAction2" instead of "getAction".
+ * @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
- * const listApps = createFunction(
- *   async function listApps(options) { ... },
+ * 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, "listApps"),
+ *   createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
+ *   methodName,
  * );
  * ```
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.15.11",
+  "version": "0.15.13",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -31,7 +31,7 @@
     "complete"
   ],
   "author": "",
-  "license": "ISC",
+  "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
     "access": "public"
   },
@@ -51,7 +51,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.3",
-    "@zapier/zapier-sdk-cli-login": "0.3.4"
+    "@zapier/zapier-sdk-cli-login": "0.3.5"
   },
   "scripts": {
     "build": "tsup",