@zapier/zapier-sdk 0.13.2 → 0.13.4

package/src/plugins/runAction/index.ts

@@ -46,6 +46,7 @@ interface ExecuteActionOptions {
     getVersionedImplementationId: GetVersionedImplementationId;
   };
   appKey: string;
+  actionId?: string;
   actionKey: string;
   actionType: string;
   executionOptions: { inputs: Record<string, unknown> };
@@ -61,6 +62,7 @@ async function executeAction(actionOptions: ExecuteActionOptions): Promise<{
     api,
     context,
     appKey,
+    actionId,
     actionKey,
     actionType,
     executionOptions,
@@ -80,12 +82,14 @@ async function executeAction(actionOptions: ExecuteActionOptions): Promise<{
   // Step 1: POST to /actions/v1/runs to start execution
   const runRequestData: {
     selected_api: string;
+    action_id?: string;
     action_key: string;
     action_type: string;
     inputs: Record<string, unknown>;
     authentication_id?: number | null;
   } = {
     selected_api: selectedApi,
+    action_id: actionId,
     action_key: actionKey,
     action_type: actionType,
     inputs: executionOptions.inputs || {},
@@ -148,11 +152,16 @@ export const runActionPlugin: Plugin<
       );
     }
 
+    const actionId = actionData.data.id;
+
     // Execute the action using the Actions API (supports all action types)
     const result = await executeAction({
       api,
       context,
       appKey,
+      // Some actions require the action ID to run them, but technically the ID is not guaranteed to be available when
+      // we retrieve actions (probably legacy reasons), so we just pass along all the things!
+      actionId,
       actionKey,
       actionType,
       executionOptions: { inputs },

package/src/resolvers/actionType.ts

@@ -16,9 +16,10 @@ export const actionTypeResolver: DynamicResolver<
       appKey: resolvedParams.appKey,
     });
 
-    const types = [
-      ...new Set(actionsResponse.data.map((action) => action.action_type)),
-    ];
+    const actionTypes = actionsResponse.data.map(
+      (action) => action.action_type,
+    );
+    const types: string[] = [...new Set(actionTypes)];
     return types.map((type) => ({ key: type, name: type }));
   },
   prompt: (types) => ({

package/src/resolvers/authenticationId.ts

@@ -23,7 +23,8 @@ export const authenticationIdResolver: AuthenticationIdResolver = {
 
     // Filter out myAuths from allAuths
     const otherAuths = allAuths.data.filter(
-      (auth) => !myAuths.data.some((myAuth) => myAuth.id === auth.id),
+      (auth: { id: number }) =>
+        !myAuths.data.some((myAuth: { id: number }) => myAuth.id === auth.id),
     );
     return [...myAuths.data, ...otherAuths];
   },

package/src/sdk.ts

@@ -33,6 +33,7 @@ import { listInputFieldsPlugin } from "./plugins/listInputFields";
 import { listInputFieldChoicesPlugin } from "./plugins/listInputFieldChoices";
 import { requestPlugin } from "./plugins/request";
 import { manifestPlugin } from "./plugins/manifest";
+import { eventEmissionPlugin } from "./plugins/eventEmission";
 
 // Full SDK interface with plugins applied
 // Note: ZapierSdk is now defined as ReturnType<typeof createZapierSdk> at the bottom of this file
@@ -130,10 +131,13 @@ export function createSdk<
 export function createZapierSdkWithoutRegistry(options: ZapierSdkOptions = {}) {
   return (
     createSdk(options)
+      // Event emission (must be first to be available to other plugins)
+      .addPlugin(eventEmissionPlugin)
+
       // Provides the API client in context
       .addPlugin(apiPlugin)
 
-      // Manifest plugin (provides version locking context)
+      // Manifest plugin (provides version locking context) - must come after apiPlugin
       .addPlugin(manifestPlugin)
 
       // Apps/actions/fields

package/src/types/sdk.ts

@@ -3,6 +3,7 @@
  */
 
 import type { EventCallback } from "./events";
+import type { EventEmissionConfig } from "../plugins/eventEmission";
 
 // SDK Configuration Types
 export interface BaseSdkOptions {
@@ -21,6 +22,7 @@ export interface BaseSdkOptions {
       };
     };
   };
+  eventEmission?: EventEmissionConfig;
 }
 
 // SDK interface composed from individual function interfaces
@@ -33,6 +35,8 @@ import type { RelayRequestSdkFunction } from "../plugins/request/schemas";
 import type { z } from "zod";
 import type { RegistryPluginProvides } from "../plugins/registry";
 import type { GetProfilePluginProvides } from "../plugins/getProfile";
+import type { EventEmissionProvides } from "../plugins/eventEmission";
+import type { ApiPluginProvides } from "../plugins/api";
 import type { AppsPluginProvides, ZapierSdkApps } from "../plugins/apps";
 import type { ActionProxy } from "../plugins/apps/schemas";
 import type { FetchPluginProvides } from "../plugins/fetch";
@@ -104,7 +108,9 @@ export interface ZapierSdk
       ListInputFieldsPluginProvides &
       ListInputFieldChoicesPluginProvides &
       RequestPluginProvides &
-      GetProfilePluginProvides
+      GetProfilePluginProvides &
+      EventEmissionProvides &
+      ApiPluginProvides
   > {
   // Override apps property to intersect ActionProxy with our typed apps
   apps: ActionProxy & ZapierSdkApps;

package/src/types/telemetry-events.ts

@@ -0,0 +1,85 @@
+/**
+ * Event emission types matching Avro schemas for SDK telemetry
+ *
+ * These interfaces correspond to the Avro schemas:
+ * - application_lifecycle_event.avsc
+ * - error_occurred_event.avsc
+ */
+
+// Common fields present in all events
+export interface BaseEvent {
+  event_id: string;
+  timestamp_ms: number;
+  release_id: string;
+  customuser_id?: number | null;
+  account_id?: number | null;
+  identity_id?: number | null;
+  visitor_id?: string | null;
+  correlation_id?: string | null;
+}
+
+// Error Event - tracks SDK errors and exceptions
+export interface ErrorOccurredEvent extends BaseEvent {
+  zap_id?: number | null;
+  node_id?: number | null;
+  selected_api?: string | null;
+  app_id?: number | null;
+  app_version_id?: number | null;
+  error_message: string;
+  error_type?: string | null;
+  error_status_code?: number | null;
+  error_stack_trace?: string | null;
+  error_source_method?: string | null;
+  error_source_file?: string | null;
+  error_line_number?: number | null;
+  operation_type?: string | null;
+  operation_key?: string | null;
+  error_severity?: string | null;
+  is_user_facing: boolean;
+  is_recoverable?: boolean | null;
+  sdk_version?: string | null;
+  error_metadata?: Record<string, string | null> | null;
+  parent_error_id?: string | null;
+  error_occurred_timestamp_ms?: number | null;
+  error_code?: string | null;
+  recovery_attempted?: boolean | null;
+  recovery_action?: string | null;
+  recovery_successful?: boolean | null;
+  environment?: string | null;
+  execution_time_before_error_ms?: number | null;
+}
+
+// Application Lifecycle Event - tracks SDK application lifecycle transitions
+export interface ApplicationLifecycleEvent extends BaseEvent {
+  lifecycle_event_type: "startup" | "exit" | "signal_termination";
+  selected_api?: string | null;
+  app_id?: number | null;
+  app_version_id?: number | null;
+  sdk_version?: string | null;
+  cli_version?: string | null;
+  exit_code?: number | null;
+  signal_name?: string | null;
+  uptime_ms?: number | null;
+  memory_usage_bytes?: number | null;
+  peak_memory_usage_bytes?: number | null;
+  cpu_time_ms?: number | null;
+  os_platform?: string | null;
+  os_release?: string | null;
+  os_architecture?: string | null;
+  platform_versions?: Record<string, string | null> | null;
+  environment?: string | null;
+  is_ci_environment?: boolean | null;
+  ci_platform?: string | null;
+  session_id?: string | null;
+  metadata?: Record<string, string | null> | null;
+  process_argv?: (string | null)[] | null;
+  is_graceful_shutdown?: boolean | null;
+  shutdown_duration_ms?: number | null;
+  active_requests_count?: number | null;
+}
+
+// Union type for all telemetry events
+export type TelemetryEvent = ErrorOccurredEvent | ApplicationLifecycleEvent;
+
+// Event type discriminator
+export type TelemetryEventType = "error_occurred" | "application_lifecycle";