@zapier/zapier-sdk 0.13.3 → 0.13.5

package/dist/index.d.ts

@@ -31,4 +31,7 @@ export type { FunctionRegistryEntry } from "./types/sdk";
 export type { Plugin, PluginProvides, PluginDependencies, PluginOptions, GetSdkType, GetContextType, Sdk, } from "./types/plugin";
 export { registryPlugin } from "./plugins/registry";
 export type { ZapierSdk } from "./types/sdk";
+export type { BaseEvent } from "./types/telemetry-events";
+export type { EventEmissionContext, EventContext, ApplicationLifecycleEventData, EnhancedErrorEventData, } from "./plugins/eventEmission";
+export { generateEventId, getCurrentTimestamp, getReleaseId, getOsInfo, getPlatformVersions, isCi, getCiPlatform, getMemoryUsage, getCpuTime, buildApplicationLifecycleEvent, buildErrorEventWithContext, buildErrorEvent, createBaseEvent, } from "./plugins/eventEmission";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAIvB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAIvB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,cAAc,EACd,UAAU,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,GAChB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -35,3 +35,4 @@ export { RelayRequestSchema, RelayFetchSchema, } from "./plugins/request/schemas
 export { createZapierSdk, createZapierSdkWithoutRegistry, createSdk, } from "./sdk";
 // Export registry plugin for manual use
 export { registryPlugin } from "./plugins/registry";
+export { generateEventId, getCurrentTimestamp, getReleaseId, getOsInfo, getPlatformVersions, isCi, getCiPlatform, getMemoryUsage, getCpuTime, buildApplicationLifecycleEvent, buildErrorEventWithContext, buildErrorEvent, createBaseEvent, } from "./plugins/eventEmission";

package/dist/index.mjs

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { setTimeout } from 'timers/promises';
+import { setTimeout as setTimeout$1 } from 'timers/promises';
+import * as os from 'os';
 
 // src/types/properties.ts
 function withFormatter(schema, formatMeta) {
@@ -32,6 +33,7 @@ function isPositional(schema) {
 
 // src/constants.ts
 var MAX_PAGE_LIMIT = 1e4;
+var TRACKING_API_ENDPOINT = "https://zapier.com/api/v4/tracking/event/";
 
 // src/types/properties.ts
 var AppKeyPropertySchema = withPositional(
@@ -368,7 +370,7 @@ var FetchInitSchema = z.object({
 // src/plugins/fetch/index.ts
 var fetchPlugin = ({ sdk }) => {
   return {
-    fetch: async function fetch(url, init) {
+    fetch: async function fetch2(url, init) {
       const {
         authenticationId,
         callbackUrl,
@@ -1407,9 +1409,10 @@ var actionTypeResolver = {
     const actionsResponse = await sdk.listActions({
       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 = [...new Set(actionTypes)];
     return types.map((type) => ({ key: type, name: type }));
   },
   prompt: (types) => ({
@@ -2822,8 +2825,15 @@ var manifestPlugin = (params) => {
     if (!resolvedApp) return null;
     return `${resolvedApp.implementationName}@${resolvedApp.version || "latest"}`;
   };
-  const updateManifestEntry = async (appKey, entry, configPath = DEFAULT_CONFIG_PATH) => {
-    const manifest2 = await readManifestFromFile(configPath) || { apps: {} };
+  const updateManifestEntry = async (options2) => {
+    const {
+      appKey,
+      entry,
+      configPath = DEFAULT_CONFIG_PATH,
+      skipWrite = false,
+      manifest: inputManifest
+    } = options2;
+    const manifest2 = inputManifest || await readManifestFromFile(configPath) || { apps: {} };
     let existingEntry = findManifestEntry({
       appKey,
       manifest: manifest2
@@ -2854,10 +2864,18 @@ var manifestPlugin = (params) => {
         api
       });
     }
-    manifest2.apps[manifestKey] = entry;
-    await writeManifestToFile(manifest2, configPath);
-    resolvedManifest = void 0;
-    return [manifestKey, entry];
+    const updatedManifest = {
+      ...manifest2,
+      apps: {
+        ...manifest2.apps,
+        [manifestKey]: entry
+      }
+    };
+    if (!skipWrite) {
+      await writeManifestToFile(updatedManifest, configPath);
+      resolvedManifest = void 0;
+    }
+    return [manifestKey, entry, updatedManifest];
   };
   return {
     context: {
@@ -3160,7 +3178,7 @@ async function pollUntilComplete(options) {
     // Up to timeout + 10s: poll every 10s
   ];
   if (initialDelay > 0) {
-    await setTimeout(initialDelay);
+    await setTimeout$1(initialDelay);
   }
   while (true) {
     attempts++;
@@ -3180,7 +3198,7 @@ async function pollUntilComplete(options) {
     }
     if (attempts > 1) {
       const waitTime = calculateWaitTime(pollingInterval[1], errorCount);
-      await setTimeout(waitTime);
+      await setTimeout$1(waitTime);
     }
     try {
       const response = await fetchPoll();
@@ -3809,6 +3827,401 @@ var listInputFieldChoicesPlugin = ({ context, sdk }) => {
   };
 };
 
+// src/plugins/eventEmission/transport.ts
+var DEFAULT_RETRY_ATTEMPTS = 2;
+var DEFAULT_RETRY_DELAY_MS = 300;
+var HttpTransport = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async emit(subject, event) {
+    try {
+      await this.emitWithRetry(
+        subject,
+        event,
+        this.config.retryAttempts || DEFAULT_RETRY_ATTEMPTS
+      );
+    } catch {
+    }
+  }
+  async emitWithRetry(subject, event, attemptsLeft) {
+    try {
+      const payload = {
+        subject,
+        properties: event
+      };
+      const response = await fetch(this.config.endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...this.config.headers
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok && attemptsLeft > 1) {
+        await this.delay(this.config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
+        return this.emitWithRetry(subject, event, attemptsLeft - 1);
+      }
+    } catch (error) {
+      if (attemptsLeft > 1) {
+        await this.delay(this.config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
+        return this.emitWithRetry(subject, event, attemptsLeft - 1);
+      }
+      throw error;
+    }
+  }
+  async delay(ms) {
+    return new Promise((resolve2) => setTimeout(resolve2, ms));
+  }
+};
+var ConsoleTransport = class {
+  async emit(subject, event) {
+    try {
+      console.log(
+        "[SDK Telemetry]",
+        JSON.stringify({ subject, properties: event }, null, 2)
+      );
+    } catch {
+    }
+  }
+};
+var NoopTransport = class {
+  async emit(_subject, _event) {
+  }
+};
+function createTransport(config) {
+  try {
+    switch (config.type) {
+      case "http":
+        if (!config.endpoint) {
+          throw new Error("HTTP transport requires endpoint");
+        }
+        return new HttpTransport({
+          endpoint: config.endpoint,
+          headers: config.headers,
+          retryAttempts: config.retryAttempts,
+          retryDelayMs: config.retryDelayMs
+        });
+      case "console":
+        return new ConsoleTransport();
+      case "noop":
+      default:
+        return new NoopTransport();
+    }
+  } catch {
+    return new NoopTransport();
+  }
+}
+function generateEventId() {
+  return crypto.randomUUID();
+}
+function getCurrentTimestamp() {
+  return Date.now();
+}
+function getReleaseId() {
+  return process?.env?.SDK_RELEASE_ID || "development";
+}
+function getOsInfo() {
+  try {
+    return {
+      platform: os.platform() || null,
+      release: os.release() || null,
+      architecture: os.arch() || null
+    };
+  } catch {
+    return {
+      platform: null,
+      release: null,
+      architecture: null
+    };
+  }
+}
+function getPlatformVersions() {
+  const versions = {};
+  if (typeof process?.versions === "object") {
+    for (const [key, value] of Object.entries(process.versions)) {
+      versions[key] = value || null;
+    }
+  }
+  return versions;
+}
+function isCi() {
+  return !!(process?.env?.CI || process?.env?.CONTINUOUS_INTEGRATION || process?.env?.GITHUB_ACTIONS || process?.env?.JENKINS_URL || process?.env?.GITLAB_CI || process?.env?.CIRCLECI || process?.env?.TRAVIS || process?.env?.BUILDKITE || process?.env?.DRONE || process?.env?.BITBUCKET_PIPELINES_UUID);
+}
+function getCiPlatform() {
+  if (process?.env?.GITHUB_ACTIONS) return "github-actions";
+  if (process?.env?.JENKINS_URL) return "jenkins";
+  if (process?.env?.GITLAB_CI) return "gitlab-ci";
+  if (process?.env?.CIRCLECI) return "circleci";
+  if (process?.env?.TRAVIS) return "travis";
+  if (process?.env?.BUILDKITE) return "buildkite";
+  if (process?.env?.DRONE) return "drone";
+  if (process?.env?.BITBUCKET_PIPELINES_UUID) return "bitbucket-pipelines";
+  if (process?.env?.CI || process?.env?.CONTINUOUS_INTEGRATION)
+    return "unknown-ci";
+  return null;
+}
+function getMemoryUsage() {
+  if (process?.memoryUsage) {
+    const usage = process.memoryUsage();
+    return usage.rss || null;
+  }
+  return null;
+}
+function getCpuTime() {
+  if (process?.cpuUsage) {
+    const usage = process.cpuUsage();
+    return Math.round((usage.user + usage.system) / 1e3);
+  }
+  return null;
+}
+
+// package.json
+var package_default = {
+  version: "0.13.5"};
+
+// src/plugins/eventEmission/builders.ts
+function createBaseEvent(context = {}) {
+  return {
+    event_id: generateEventId(),
+    timestamp_ms: getCurrentTimestamp(),
+    release_id: getReleaseId(),
+    customuser_id: context.customuser_id,
+    account_id: context.account_id,
+    identity_id: context.identity_id,
+    visitor_id: context.visitor_id,
+    correlation_id: context.correlation_id
+  };
+}
+function buildErrorEvent(data, context = {}) {
+  return {
+    ...createBaseEvent(context),
+    zap_id: context.zap_id,
+    node_id: context.node_id,
+    selected_api: context.selected_api,
+    app_id: context.app_id,
+    app_version_id: context.app_version_id,
+    environment: context.environment,
+    sdk_version: package_default.version,
+    ...data
+  };
+}
+function buildApplicationLifecycleEvent(data, context = {}) {
+  const osInfo = getOsInfo();
+  const platformVersions = getPlatformVersions();
+  return {
+    ...createBaseEvent(context),
+    selected_api: context.selected_api,
+    app_id: context.app_id,
+    app_version_id: context.app_version_id,
+    sdk_version: package_default.version,
+    cli_version: null,
+    memory_usage_bytes: data.memory_usage_bytes ?? getMemoryUsage(),
+    peak_memory_usage_bytes: data.peak_memory_usage_bytes ?? getMemoryUsage(),
+    cpu_time_ms: data.cpu_time_ms ?? getCpuTime(),
+    os_platform: osInfo.platform,
+    os_release: osInfo.release,
+    os_architecture: osInfo.architecture,
+    platform_versions: platformVersions,
+    environment: context.environment ?? (process.env.NODE_ENV || null),
+    is_ci_environment: isCi(),
+    ci_platform: getCiPlatform(),
+    session_id: null,
+    metadata: null,
+    process_argv: process.argv || null,
+    ...data
+  };
+}
+function buildErrorEventWithContext(data, context = {}) {
+  const executionTime = data.execution_start_time ? Date.now() - data.execution_start_time : null;
+  return {
+    ...createBaseEvent(context),
+    zap_id: context.zap_id,
+    node_id: context.node_id,
+    selected_api: context.selected_api,
+    app_id: context.app_id,
+    app_version_id: context.app_version_id,
+    environment: context.environment ?? (process.env.NODE_ENV || null),
+    sdk_version: package_default.version,
+    execution_time_before_error_ms: executionTime,
+    ...data
+  };
+}
+
+// src/plugins/eventEmission/index.ts
+var APPLICATION_LIFECYCLE_EVENT_SUBJECT = "platform.sdk.ApplicationLifecycleEvent";
+var ERROR_OCCURRED_EVENT_SUBJECT = "platform.sdk.ErrorOccurredEvent";
+async function silentEmit(transport, subject, event) {
+  try {
+    transport.emit(subject, event).catch(() => {
+    });
+  } catch {
+  }
+}
+function getTransportConfig() {
+  const envTransport = process?.env?.ZAPIER_SDK_TELEMETRY_TRANSPORT;
+  if (envTransport === "noop" || envTransport === "disabled") {
+    return { type: "noop" };
+  }
+  if (envTransport === "console") {
+    return { type: "console" };
+  }
+  const endpoint = process?.env?.ZAPIER_SDK_TELEMETRY_ENDPOINT || TRACKING_API_ENDPOINT;
+  return {
+    type: "http",
+    endpoint
+  };
+}
+var eventEmissionPlugin = ({ context }) => {
+  const defaultTransport = getTransportConfig();
+  const config = {
+    enabled: context.options.eventEmission?.enabled ?? true,
+    transport: (
+      // If env var is set, use it (defaultTransport will be from env)
+      process?.env?.ZAPIER_SDK_TELEMETRY_TRANSPORT ? defaultTransport : (
+        // Otherwise, use option transport or default
+        context.options.eventEmission?.transport ?? defaultTransport
+      )
+    )
+  };
+  const startupTime = Date.now();
+  let shutdownStartTime = null;
+  if (!config.enabled) {
+    return {
+      context: {
+        eventEmission: {
+          transport: createTransport({ type: "noop" }),
+          config,
+          emit: () => {
+          },
+          createBaseEvent: () => ({
+            event_id: generateEventId(),
+            timestamp_ms: getCurrentTimestamp(),
+            release_id: getReleaseId(),
+            customuser_id: null,
+            account_id: null,
+            identity_id: null,
+            visitor_id: null,
+            correlation_id: null
+          })
+        }
+      }
+    };
+  }
+  let transport;
+  try {
+    transport = createTransport(config.transport || { type: "noop" });
+  } catch {
+    transport = createTransport({ type: "noop" });
+  }
+  const createBaseEventHelper = () => ({
+    event_id: generateEventId(),
+    timestamp_ms: getCurrentTimestamp(),
+    release_id: getReleaseId(),
+    customuser_id: null,
+    account_id: null,
+    identity_id: null,
+    visitor_id: null,
+    correlation_id: null
+  });
+  if (config.enabled) {
+    const startupEvent = buildApplicationLifecycleEvent({
+      lifecycle_event_type: "startup"
+    });
+    silentEmit(transport, APPLICATION_LIFECYCLE_EVENT_SUBJECT, startupEvent);
+    if (typeof process?.on === "function") {
+      process.on("exit", (code) => {
+        const uptime = Date.now() - startupTime;
+        const shutdownDuration = shutdownStartTime ? Date.now() - shutdownStartTime : null;
+        const exitEvent = buildApplicationLifecycleEvent({
+          lifecycle_event_type: "exit",
+          exit_code: code,
+          uptime_ms: uptime,
+          is_graceful_shutdown: code === 0,
+          shutdown_duration_ms: shutdownDuration
+        });
+        silentEmit(transport, APPLICATION_LIFECYCLE_EVENT_SUBJECT, exitEvent);
+      });
+      process.on("uncaughtException", async (error) => {
+        const errorEvent = buildErrorEventWithContext({
+          error_message: error.message || "Unknown error",
+          error_type: "UncaughtException",
+          error_stack_trace: error.stack || null,
+          error_severity: "critical",
+          is_user_facing: false,
+          is_recoverable: false,
+          execution_start_time: startupTime
+        });
+        try {
+          await Promise.race([
+            transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
+            new Promise((resolve2) => setTimeout(resolve2, 300))
+          ]);
+        } catch {
+        }
+      });
+      process.on(
+        "unhandledRejection",
+        async (reason, promise) => {
+          const errorMessage = reason instanceof Error ? reason.message : typeof reason === "string" ? reason : "Unhandled promise rejection";
+          const errorStack = reason instanceof Error ? reason.stack : null;
+          const errorEvent = buildErrorEventWithContext({
+            error_message: errorMessage,
+            error_type: "UnhandledRejection",
+            error_stack_trace: errorStack,
+            error_severity: "critical",
+            is_user_facing: false,
+            is_recoverable: false,
+            execution_start_time: startupTime,
+            error_metadata: {
+              promise: String(promise)
+            }
+          });
+          try {
+            await Promise.race([
+              transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
+              new Promise((resolve2) => setTimeout(resolve2, 300))
+            ]);
+          } catch {
+          }
+        }
+      );
+      const handleSignal = async (signal) => {
+        shutdownStartTime = Date.now();
+        const uptime = Date.now() - startupTime;
+        const signalEvent = buildApplicationLifecycleEvent({
+          lifecycle_event_type: "signal_termination",
+          signal_name: signal,
+          uptime_ms: uptime,
+          is_graceful_shutdown: true
+        });
+        try {
+          await Promise.race([
+            transport.emit(APPLICATION_LIFECYCLE_EVENT_SUBJECT, signalEvent),
+            new Promise((resolve2) => setTimeout(resolve2, 300))
+          ]);
+        } catch {
+        }
+      };
+      ["SIGINT", "SIGTERM"].forEach((signal) => {
+        process.on(signal, () => handleSignal(signal));
+      });
+    }
+  }
+  return {
+    context: {
+      eventEmission: {
+        transport,
+        config,
+        emit: (subject, event) => {
+          silentEmit(transport, subject, event);
+        },
+        createBaseEvent: createBaseEventHelper
+      }
+    }
+  };
+};
+
 // src/sdk.ts
 function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} }) {
   return {
@@ -3858,10 +4271,10 @@ function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} })
   };
 }
 function createZapierSdkWithoutRegistry(options = {}) {
-  return createSdk(options).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).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(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(requestPlugin).addPlugin(fetchPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
 }
 
-export { ActionKeyPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };
+export { ActionKeyPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, createBaseEvent, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getCiPlatform, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isCi, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin, toSnakeCase, toTitleCase };

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

@@ -8,7 +8,5 @@ export interface ApiPluginProvides {
         api: ApiClient;
     };
 }
-export declare const apiPlugin: Plugin<{}, // no SDK dependencies
-{}, // requires no context
-ApiPluginProvides>;
+export declare const apiPlugin: Plugin<{}, {}, ApiPluginProvides>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/api/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE;QACP,GAAG,EAAE,SAAS,CAAC;KAChB,CAAC;CACH;AAGD,eAAO,MAAM,SAAS,EAAE,MAAM,CAC5B,EAAE,EAAE,sBAAsB;AAC1B,EAAE,EAAE,sBAAsB;AAC1B,iBAAiB,CA4BlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/api/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE;QACP,GAAG,EAAE,SAAS,CAAC;KAChB,CAAC;CACH;AAGD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,iBAAiB,CA2BvD,CAAC"}

package/dist/plugins/eventEmission/builders.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Event builder utilities for creating telemetry events
+ *
+ * Provides builder functions that auto-populate common fields and ensure
+ * schema compliance for all event types.
+ */
+import type { ErrorOccurredEvent, ApplicationLifecycleEvent, BaseEvent } from "../../types/telemetry-events";
+import type { ApplicationLifecycleEventData, EnhancedErrorEventData, ErrorEventData, EventContext } from "./types";
+export declare function createBaseEvent(context?: EventContext): BaseEvent;
+export declare function buildErrorEvent(data: ErrorEventData, context?: EventContext): ErrorOccurredEvent;
+export declare function buildApplicationLifecycleEvent(data: ApplicationLifecycleEventData, context?: EventContext): ApplicationLifecycleEvent;
+export declare function buildErrorEventWithContext(data: EnhancedErrorEventData, context?: EventContext): ErrorOccurredEvent;
+//# sourceMappingURL=builders.d.ts.map

package/dist/plugins/eventEmission/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/plugins/eventEmission/builders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,SAAS,EACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACtB,cAAc,EACd,YAAY,EACb,MAAM,SAAS,CAAC;AAgBjB,wBAAgB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,SAAS,CAWrE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,YAAiB,GACzB,kBAAkB,CAYpB;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE,YAAiB,GACzB,yBAAyB,CA0B3B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,GAAE,YAAiB,GACzB,kBAAkB,CAiBpB"}

package/dist/plugins/eventEmission/builders.js

@@ -0,0 +1,78 @@
+/**
+ * Event builder utilities for creating telemetry events
+ *
+ * Provides builder functions that auto-populate common fields and ensure
+ * schema compliance for all event types.
+ */
+import { generateEventId, getCurrentTimestamp, getReleaseId, getOsInfo, getPlatformVersions, getMemoryUsage, getCpuTime, isCi, getCiPlatform, } from "./utils";
+import sdkPackageJson from "../../../package.json";
+// Create base event with auto-populated common fields
+// Kept for backward compatibility but can be replaced with direct construction
+export function createBaseEvent(context = {}) {
+    return {
+        event_id: generateEventId(),
+        timestamp_ms: getCurrentTimestamp(),
+        release_id: getReleaseId(),
+        customuser_id: context.customuser_id,
+        account_id: context.account_id,
+        identity_id: context.identity_id,
+        visitor_id: context.visitor_id,
+        correlation_id: context.correlation_id,
+    };
+}
+export function buildErrorEvent(data, context = {}) {
+    return {
+        ...createBaseEvent(context),
+        zap_id: context.zap_id,
+        node_id: context.node_id,
+        selected_api: context.selected_api,
+        app_id: context.app_id,
+        app_version_id: context.app_version_id,
+        environment: context.environment,
+        sdk_version: sdkPackageJson.version,
+        ...data,
+    };
+}
+export function buildApplicationLifecycleEvent(data, context = {}) {
+    const osInfo = getOsInfo();
+    const platformVersions = getPlatformVersions();
+    return {
+        ...createBaseEvent(context),
+        selected_api: context.selected_api,
+        app_id: context.app_id,
+        app_version_id: context.app_version_id,
+        sdk_version: sdkPackageJson.version,
+        cli_version: null,
+        memory_usage_bytes: data.memory_usage_bytes ?? getMemoryUsage(),
+        peak_memory_usage_bytes: data.peak_memory_usage_bytes ?? getMemoryUsage(),
+        cpu_time_ms: data.cpu_time_ms ?? getCpuTime(),
+        os_platform: osInfo.platform,
+        os_release: osInfo.release,
+        os_architecture: osInfo.architecture,
+        platform_versions: platformVersions,
+        environment: context.environment ?? (process.env.NODE_ENV || null),
+        is_ci_environment: isCi(),
+        ci_platform: getCiPlatform(),
+        session_id: null,
+        metadata: null,
+        process_argv: process.argv || null,
+        ...data,
+    };
+}
+export function buildErrorEventWithContext(data, context = {}) {
+    const executionTime = data.execution_start_time
+        ? Date.now() - data.execution_start_time
+        : null;
+    return {
+        ...createBaseEvent(context),
+        zap_id: context.zap_id,
+        node_id: context.node_id,
+        selected_api: context.selected_api,
+        app_id: context.app_id,
+        app_version_id: context.app_version_id,
+        environment: context.environment ?? (process.env.NODE_ENV || null),
+        sdk_version: sdkPackageJson.version,
+        execution_time_before_error_ms: executionTime,
+        ...data,
+    };
+}

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

@@ -0,0 +1,34 @@
+/**
+ * Event Emission Plugin for Zapier SDK
+ *
+ * Provides silent telemetry event emission capability to the SDK.
+ * All events are emitted asynchronously and failures are silently handled.
+ */
+import type { Plugin } from "../../types/plugin";
+import type { BaseEvent } from "../../types/telemetry-events";
+import type { EventTransport, TransportConfig } from "./transport";
+export interface EventEmissionConfig {
+    enabled?: boolean;
+    transport?: TransportConfig;
+}
+export interface EventEmissionContext {
+    eventEmission: {
+        transport: EventTransport;
+        config: EventEmissionConfig;
+        emit<T extends any>(subject: string, event: T): void;
+        createBaseEvent(): BaseEvent;
+    };
+}
+export interface EventEmissionProvides {
+    context: EventEmissionContext;
+}
+export declare const eventEmissionPlugin: Plugin<{}, {
+    options: {
+        eventEmission?: EventEmissionConfig;
+    };
+}, EventEmissionProvides>;
+export type { EventContext, ApplicationLifecycleEventData, EnhancedErrorEventData, } from "./types";
+export { buildApplicationLifecycleEvent, buildErrorEventWithContext, buildErrorEvent, createBaseEvent, } from "./builders";
+export type { BaseEvent } from "../../types/telemetry-events";
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map