autotel-subscribers 4.0.0

package/dist/slack.cjs

@@ -0,0 +1,368 @@
+'use strict';
+
+// src/event-subscriber-base.ts
+var EventSubscriber = class {
+  /**
+   * Subscriber version (optional)
+   */
+  version;
+  /**
+   * Enable/disable the subscriber (default: true)
+   */
+  enabled = true;
+  /**
+   * Track pending requests for graceful shutdown
+   */
+  pendingRequests = /* @__PURE__ */ new Set();
+  /**
+   * Optional: Handle errors
+   *
+   * Override this to customize error handling (logging, retries, etc.).
+   * Default behavior: log to console.error
+   *
+   * @param error - Error that occurred
+   * @param payload - Event payload that failed
+   */
+  handleError(error, payload) {
+    console.error(
+      `[${this.name}] Failed to send ${payload.type}:`,
+      error,
+      payload
+    );
+  }
+  /**
+   * Track an event
+   */
+  async trackEvent(name, attributes) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "event",
+      name,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track a funnel step
+   */
+  async trackFunnelStep(funnelName, step, attributes) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "funnel",
+      name: `${funnelName}.${step}`,
+      funnel: funnelName,
+      step,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track an outcome
+   */
+  async trackOutcome(operationName, outcome, attributes) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "outcome",
+      name: `${operationName}.${outcome}`,
+      operation: operationName,
+      outcome,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track a value/metric
+   */
+  async trackValue(name, value, attributes) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "value",
+      name,
+      value,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.send(payload);
+  }
+  /**
+   * Flush pending requests and clean up
+   *
+   * CRITICAL: Prevents race condition during shutdown
+   * 1. Disables subscriber to stop new events
+   * 2. Drains all pending requests (with retry logic)
+   * 3. Ensures flush guarantee
+   *
+   * Override this if you need custom cleanup logic (close connections, flush buffers, etc.),
+   * but ALWAYS call super.shutdown() first to drain pending requests.
+   */
+  async shutdown() {
+    this.enabled = false;
+    const maxDrainAttempts = 10;
+    const drainIntervalMs = 50;
+    for (let attempt = 0; attempt < maxDrainAttempts; attempt++) {
+      if (this.pendingRequests.size === 0) {
+        break;
+      }
+      await Promise.allSettled(this.pendingRequests);
+      if (this.pendingRequests.size > 0 && attempt < maxDrainAttempts - 1) {
+        await new Promise((resolve) => setTimeout(resolve, drainIntervalMs));
+      }
+    }
+    if (this.pendingRequests.size > 0) {
+      console.warn(
+        `[${this.name}] Shutdown completed with ${this.pendingRequests.size} pending requests still in-flight. This may indicate a bug in the subscriber or extremely slow destination.`
+      );
+    }
+  }
+  /**
+   * Internal: Send payload and track request
+   */
+  async send(payload) {
+    const request = this.sendWithErrorHandling(payload);
+    this.pendingRequests.add(request);
+    void request.finally(() => {
+      this.pendingRequests.delete(request);
+    });
+    return request;
+  }
+  /**
+   * Internal: Send with error handling
+   */
+  async sendWithErrorHandling(payload) {
+    try {
+      await this.sendToDestination(payload);
+    } catch (error) {
+      this.handleError(error, payload);
+    }
+  }
+};
+
+// src/slack.ts
+var SlackSubscriber = class extends EventSubscriber {
+  name = "SlackSubscriber";
+  version = "1.0.0";
+  config;
+  constructor(config) {
+    super();
+    this.config = {
+      webhookUrl: config.webhookUrl,
+      channel: config.channel,
+      username: config.username ?? "Events Bot",
+      iconEmoji: config.iconEmoji ?? ":chart_with_upwards_trend:",
+      includeTimestamp: config.includeTimestamp ?? true,
+      includeAttributes: config.includeAttributes ?? true,
+      maxAttributeFields: config.maxAttributeFields ?? 10,
+      filter: config.filter,
+      enabled: config.enabled ?? true
+    };
+    this.enabled = this.config.enabled;
+    if (!this.config.webhookUrl) {
+      console.error(
+        "[SlackSubscriber] No webhook URL provided - subscriber disabled"
+      );
+      this.enabled = false;
+    }
+  }
+  async sendToDestination(payload) {
+    if (this.config.filter) {
+      const filterFn = this.config.filter;
+      const shouldInclude = filterFn(payload);
+      if (!shouldInclude) {
+        return;
+      }
+    }
+    const message = this.formatSlackMessage(payload);
+    const response = await fetch(this.config.webhookUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(message)
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(
+        `Slack webhook failed (${response.status}): ${errorText}`
+      );
+    }
+  }
+  /**
+   * Format events payload as Slack message
+   */
+  formatSlackMessage(payload) {
+    const emoji = this.getEventEmoji(payload);
+    const color = this.getEventColor(payload);
+    const title = `${emoji} ${payload.name}`;
+    const fields = [
+      {
+        title: "Event Type",
+        value: this.formatEventType(payload),
+        short: true
+      }
+    ];
+    if (this.config.includeTimestamp) {
+      fields.push({
+        title: "Timestamp",
+        value: new Date(payload.timestamp).toLocaleString("en-US", {
+          month: "short",
+          day: "numeric",
+          hour: "2-digit",
+          minute: "2-digit",
+          second: "2-digit"
+        }),
+        short: true
+      });
+    }
+    if (this.config.includeAttributes && payload.attributes) {
+      const attributeFields = this.formatAttributes(payload.attributes);
+      fields.push(...attributeFields);
+    }
+    const attachment = {
+      color,
+      title,
+      fields,
+      footer: "Events Events",
+      footer_icon: "https://i.imgur.com/QpCKbNL.png"
+    };
+    if (this.config.includeTimestamp) {
+      attachment.ts = Math.floor(
+        new Date(payload.timestamp).getTime() / 1e3
+      );
+    }
+    return {
+      channel: this.config.channel,
+      username: this.config.username,
+      icon_emoji: this.config.iconEmoji,
+      attachments: [attachment]
+    };
+  }
+  /**
+   * Get emoji for event type
+   */
+  getEventEmoji(payload) {
+    switch (payload.type) {
+      case "outcome": {
+        return payload.outcome === "success" ? "\u2705" : "\u274C";
+      }
+      case "funnel": {
+        return "\u{1F504}";
+      }
+      case "value": {
+        return "\u{1F4CA}";
+      }
+      default: {
+        if (payload.name.includes("order") || payload.name.includes("payment"))
+          return "\u{1F4B0}";
+        if (payload.name.includes("signup") || payload.name.includes("user"))
+          return "\u{1F464}";
+        if (payload.name.includes("error") || payload.name.includes("fail"))
+          return "\u26A0\uFE0F";
+        return "\u{1F4CC}";
+      }
+    }
+  }
+  /**
+   * Get Slack attachment color for event type
+   */
+  getEventColor(payload) {
+    switch (payload.type) {
+      case "outcome": {
+        return payload.outcome === "success" ? "good" : "danger";
+      }
+      // Green or red
+      case "funnel": {
+        return "#3AA3E3";
+      }
+      // Blue
+      case "value": {
+        return "#764FA5";
+      }
+      // Purple
+      default: {
+        if (payload.name.includes("error") || payload.name.includes("fail"))
+          return "danger";
+        if (payload.name.includes("warning")) return "warning";
+        return "good";
+      }
+    }
+  }
+  /**
+   * Format event type for display
+   */
+  formatEventType(payload) {
+    switch (payload.type) {
+      case "event": {
+        return "Event";
+      }
+      case "funnel": {
+        return `Funnel: ${payload.step || "unknown"}`;
+      }
+      case "outcome": {
+        return `Outcome: ${payload.outcome || "unknown"}`;
+      }
+      case "value": {
+        return `Value: ${payload.value ?? "N/A"}`;
+      }
+      default: {
+        return payload.type;
+      }
+    }
+  }
+  /**
+   * Format attributes as Slack fields
+   */
+  formatAttributes(attributes) {
+    const fields = [];
+    const entries = Object.entries(attributes);
+    const limit = Math.min(entries.length, this.config.maxAttributeFields);
+    for (let i = 0; i < limit; i++) {
+      const [key, value] = entries[i];
+      if (key.startsWith("_") || key === "timestamp") continue;
+      fields.push({
+        title: this.formatFieldName(key),
+        value: this.formatFieldValue(value),
+        short: true
+      });
+    }
+    if (entries.length > this.config.maxAttributeFields) {
+      fields.push({
+        title: "Note",
+        value: `... and ${entries.length - this.config.maxAttributeFields} more fields`,
+        short: false
+      });
+    }
+    return fields;
+  }
+  /**
+   * Format field name (convert camelCase to Title Case)
+   */
+  formatFieldName(name) {
+    return name.replaceAll(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).trim();
+  }
+  /**
+   * Format field value
+   */
+  formatFieldValue(value) {
+    if (value === null || value === void 0) return "N/A";
+    if (typeof value === "boolean") return value ? "Yes" : "No";
+    if (typeof value === "object") return JSON.stringify(value);
+    if (typeof value === "number" && !Number.isInteger(value)) {
+      return value.toFixed(2);
+    }
+    return String(value);
+  }
+  /**
+   * Handle errors (override from EventSubscriber)
+   */
+  handleError(error, payload) {
+    console.error(
+      `[SlackSubscriber] Failed to send ${payload.type} event "${payload.name}":`,
+      error
+    );
+  }
+};
+
+exports.SlackSubscriber = SlackSubscriber;
+//# sourceMappingURL=slack.cjs.map
+//# sourceMappingURL=slack.cjs.map

package/dist/slack.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-subscriber-base.ts","../src/slack.ts"],"names":[],"mappings":"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","file":"slack.cjs","sourcesContent":["/**\n * EventSubscriber - Standard base class for building custom subscribers\n *\n * This is the recommended base class for creating custom events subscribers.\n * It provides production-ready features out of the box:\n *\n * **Built-in Features:**\n * - **Error Handling**: Automatic error catching with customizable handlers\n * - **Pending Request Tracking**: Ensures all requests complete during shutdown\n * - **Graceful Shutdown**: Drains pending requests before closing\n * - **Enable/Disable**: Runtime control to turn subscriber on/off\n * - **Normalized Payload**: Consistent event structure across all event types\n *\n * **When to use:**\n * - Building custom subscribers for any platform\n * - Production deployments requiring reliability\n * - Need graceful shutdown and error handling\n *\n * @example Basic usage\n * ```typescript\n * import { EventSubscriber, EventPayload } from 'autotel-subscribers';\n *\n * class SnowflakeSubscriber extends EventSubscriber {\n *   name = 'SnowflakeSubscriber';\n *   version = '1.0.0';\n *\n *   protected async sendToDestination(payload: EventPayload): Promise<void> {\n *     await snowflakeClient.execute(\n *       `INSERT INTO events VALUES (?, ?, ?)`,\n *       [payload.type, payload.name, JSON.stringify(payload.attributes)]\n *     );\n *   }\n * }\n * ```\n *\n * @example With buffering\n * ```typescript\n * class BufferedSubscriber extends EventSubscriber {\n *   name = 'BufferedSubscriber';\n *   private buffer: EventPayload[] = [];\n *\n *   protected async sendToDestination(payload: EventPayload): Promise<void> {\n *     this.buffer.push(payload);\n *\n *     if (this.buffer.length >= 100) {\n *       await this.flush();\n *     }\n *   }\n *\n *   async shutdown(): Promise<void> {\n *     await super.shutdown(); // Drain pending requests first\n *     await this.flush(); // Then flush buffer\n *   }\n *\n *   private async flush(): Promise<void> {\n *     if (this.buffer.length === 0) return;\n *\n *     const batch = [...this.buffer];\n *     this.buffer = [];\n *\n *     await apiClient.sendBatch(batch);\n *   }\n * }\n * ```\n */\n\nimport type {\n  EventSubscriber as IEventSubscriber,\n  EventAttributes,\n  FunnelStatus,\n  OutcomeStatus,\n} from 'autotel/event-subscriber';\n\n// Re-export types for convenience\n\n\n/**\n * Payload sent to destination\n */\nexport interface EventPayload {\n  /** Event type: 'event', 'funnel', 'outcome', or 'value' */\n  type: 'event' | 'funnel' | 'outcome' | 'value';\n\n  /** Event name or metric name */\n  name: string;\n\n  /** Optional attributes */\n  attributes?: EventAttributes;\n\n  /** For funnel events: funnel name */\n  funnel?: string;\n\n  /** For funnel events: step status */\n  step?: FunnelStatus;\n\n  /** For outcome events: operation name */\n  operation?: string;\n\n  /** For outcome events: outcome status */\n  outcome?: OutcomeStatus;\n\n  /** For value events: numeric value */\n  value?: number;\n\n  /** Timestamp (ISO 8601) */\n  timestamp: string;\n}\n\n/**\n * Standard base class for building custom events subscribers\n *\n * **What it provides:**\n * - Consistent payload structure (normalized across all event types)\n * - Enable/disable flag (runtime control)\n * - Automatic error handling (with customizable error handlers)\n * - Pending requests tracking (ensures no lost events during shutdown)\n * - Graceful shutdown (drains pending requests before closing)\n *\n * **Usage:**\n * Extend this class and implement `sendToDestination()`. All other methods\n * (trackEvent, trackFunnelStep, trackOutcome, trackValue, shutdown) are handled automatically.\n *\n * For high-throughput streaming platforms (Kafka, Kinesis, Pub/Sub), use `StreamingEventSubscriber` instead.\n */\nexport abstract class EventSubscriber implements IEventSubscriber {\n  /**\n   * Subscriber name (required for debugging)\n   */\n  abstract readonly name: string;\n\n  /**\n   * Subscriber version (optional)\n   */\n  readonly version?: string;\n\n  /**\n   * Enable/disable the subscriber (default: true)\n   */\n  protected enabled: boolean = true;\n\n  /**\n   * Track pending requests for graceful shutdown\n   */\n  private pendingRequests: Set<Promise<void>> = new Set();\n\n  /**\n   * Send payload to destination\n   *\n   * Override this method to implement your destination-specific logic.\n   * This is called for all event types (event, funnel, outcome, value).\n   *\n   * @param payload - Normalized event payload\n   */\n  protected abstract sendToDestination(payload: EventPayload): Promise<void>;\n\n  /**\n   * Optional: Handle errors\n   *\n   * Override this to customize error handling (logging, retries, etc.).\n   * Default behavior: log to console.error\n   *\n   * @param error - Error that occurred\n   * @param payload - Event payload that failed\n   */\n  protected handleError(error: Error, payload: EventPayload): void {\n    console.error(\n      `[${this.name}] Failed to send ${payload.type}:`,\n      error,\n      payload,\n    );\n  }\n\n  /**\n   * Track an event\n   */\n  async trackEvent(name: string, attributes?: EventAttributes): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'event',\n      name,\n      attributes,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track a funnel step\n   */\n  async trackFunnelStep(\n    funnelName: string,\n    step: FunnelStatus,\n    attributes?: EventAttributes,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'funnel',\n      name: `${funnelName}.${step}`,\n      funnel: funnelName,\n      step,\n      attributes,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track an outcome\n   */\n  async trackOutcome(\n    operationName: string,\n    outcome: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'outcome',\n      name: `${operationName}.${outcome}`,\n      operation: operationName,\n      outcome,\n      attributes,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track a value/metric\n   */\n  async trackValue(\n    name: string,\n    value: number,\n    attributes?: EventAttributes,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'value',\n      name,\n      value,\n      attributes,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Flush pending requests and clean up\n   *\n   * CRITICAL: Prevents race condition during shutdown\n   * 1. Disables subscriber to stop new events\n   * 2. Drains all pending requests (with retry logic)\n   * 3. Ensures flush guarantee\n   *\n   * Override this if you need custom cleanup logic (close connections, flush buffers, etc.),\n   * but ALWAYS call super.shutdown() first to drain pending requests.\n   */\n  async shutdown(): Promise<void> {\n    // 1. Stop accepting new events (prevents race condition)\n    this.enabled = false;\n\n    // 2. Drain pending requests with retry logic\n    // Loop until empty to handle race where new requests added during Promise.allSettled\n    const maxDrainAttempts = 10;\n    const drainIntervalMs = 50;\n\n    for (let attempt = 0; attempt < maxDrainAttempts; attempt++) {\n      if (this.pendingRequests.size === 0) {\n        break;\n      }\n\n      // Wait for current batch\n      await Promise.allSettled(this.pendingRequests);\n\n      // Small delay to catch any stragglers added during allSettled\n      if (this.pendingRequests.size > 0 && attempt < maxDrainAttempts - 1) {\n        await new Promise((resolve) => setTimeout(resolve, drainIntervalMs));\n      }\n    }\n\n    // 3. Warn if we still have pending requests (shouldn't happen, but be defensive)\n    if (this.pendingRequests.size > 0) {\n      console.warn(\n        `[${this.name}] Shutdown completed with ${this.pendingRequests.size} pending requests still in-flight. ` +\n        `This may indicate a bug in the subscriber or extremely slow destination.`\n      );\n    }\n  }\n\n  /**\n   * Internal: Send payload and track request\n   */\n  private async send(payload: EventPayload): Promise<void> {\n    const request = this.sendWithErrorHandling(payload);\n    this.pendingRequests.add(request);\n\n    void request.finally(() => {\n      this.pendingRequests.delete(request);\n    });\n\n    return request;\n  }\n\n  /**\n   * Internal: Send with error handling\n   */\n  private async sendWithErrorHandling(\n    payload: EventPayload,\n  ): Promise<void> {\n    try {\n      await this.sendToDestination(payload);\n    } catch (error) {\n      this.handleError(error as Error, payload);\n    }\n  }\n}\n\nexport {type EventAttributes, type FunnelStatus, type OutcomeStatus} from 'autotel/event-subscriber';","/**\n * Slack Subscriber for autotel\n *\n * Send events events as notifications to Slack channels via webhooks.\n *\n * Perfect for:\n * - Critical business events (orders, payments, signups)\n * - Real-time alerts for failures\n * - Team notifications for important milestones\n * - Monitoring funnel completions\n *\n * @example Basic usage\n * ```typescript\n * import { Events } from 'autotel/events';\n * import { SlackSubscriber } from 'autotel-subscribers/slack';\n *\n * const events = new Events('app', {\n *   subscribers: [\n *     new SlackSubscriber({\n *       webhookUrl: process.env.SLACK_WEBHOOK_URL!,\n *       channel: '#order-events'\n *     })\n *   ]\n * });\n *\n * // Sends to Slack\n * events.trackEvent('order.completed', {\n *   orderId: 'ord_123',\n *   userId: 'user_456',\n *   amount: 99.99\n * });\n * ```\n *\n * @example Filter critical events only\n * ```typescript\n * const events = new Events('app', {\n *   subscribers: [\n *     new SlackSubscriber({\n *       webhookUrl: process.env.SLACK_WEBHOOK_URL!,\n *       channel: '#alerts',\n *       filter: (payload) => {\n *         // Only send failures and high-value orders\n *         if (payload.type === 'outcome' && payload.outcome === 'failure') {\n *           return true;\n *         }\n *         if (payload.name === 'order.completed' && payload.attributes?.amount > 1000) {\n *           return true;\n *         }\n *         return false;\n *       }\n *     })\n *   ]\n * });\n * ```\n *\n * Setup:\n * 1. Create Slack App: https://api.slack.com/apps\n * 2. Enable Incoming Webhooks\n * 3. Add webhook to workspace\n * 4. Copy webhook URL (https://hooks.slack.com/services/...)\n */\n\nimport {\n  EventSubscriber,\n  type EventPayload,\n} from './event-subscriber-base';\n\nexport interface SlackSubscriberConfig {\n  /** Slack webhook URL (https://hooks.slack.com/services/...) */\n  webhookUrl: string;\n\n  /** Default channel to post to (optional, overrides webhook default) */\n  channel?: string;\n\n  /** Custom username for bot (default: 'Events Bot') */\n  username?: string;\n\n  /** Custom emoji icon (default: ':chart_with_upwards_trend:') */\n  iconEmoji?: string;\n\n  /** Include timestamp in messages (default: true) */\n  includeTimestamp?: boolean;\n\n  /** Include event attributes as fields (default: true) */\n  includeAttributes?: boolean;\n\n  /** Maximum attributes to show (default: 10) */\n  maxAttributeFields?: number;\n\n  /** Filter function - return true to send, false to skip */\n  filter?: (payload: EventPayload) => boolean;\n\n  /** Enable/disable subscriber */\n  enabled?: boolean;\n}\n\ninterface SlackMessage {\n  channel?: string;\n  username?: string;\n  icon_emoji?: string;\n  text?: string;\n  attachments: SlackAttachment[];\n}\n\ninterface SlackAttachment {\n  color?: string;\n  title?: string;\n  text?: string;\n  fields?: SlackField[];\n  footer?: string;\n  footer_icon?: string;\n  ts?: number;\n}\n\ninterface SlackField {\n  title: string;\n  value: string;\n  short: boolean;\n}\n\nexport class SlackSubscriber extends EventSubscriber {\n  readonly name = 'SlackSubscriber';\n  readonly version = '1.0.0';\n\n  private config: Required<Omit<SlackSubscriberConfig, 'channel' | 'filter'>> & {\n    channel?: string;\n    filter?: (payload: EventPayload) => boolean;\n  };\n\n  constructor(config: SlackSubscriberConfig) {\n    super();\n\n    this.config = {\n      webhookUrl: config.webhookUrl,\n      channel: config.channel,\n      username: config.username ?? 'Events Bot',\n      iconEmoji: config.iconEmoji ?? ':chart_with_upwards_trend:',\n      includeTimestamp: config.includeTimestamp ?? true,\n      includeAttributes: config.includeAttributes ?? true,\n      maxAttributeFields: config.maxAttributeFields ?? 10,\n      filter: config.filter,\n      enabled: config.enabled ?? true,\n    };\n\n    this.enabled = this.config.enabled;\n\n    if (!this.config.webhookUrl) {\n      console.error(\n        '[SlackSubscriber] No webhook URL provided - subscriber disabled'\n      );\n      this.enabled = false;\n    }\n  }\n\n  protected async sendToDestination(payload: EventPayload): Promise<void> {\n    // Apply filter if provided\n    if (this.config.filter) {\n      const filterFn = this.config.filter;\n      const shouldInclude = filterFn(payload);\n      if (!shouldInclude) {\n        return; // Skip this event\n      }\n    }\n\n    const message = this.formatSlackMessage(payload);\n\n    const response = await fetch(this.config.webhookUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(message),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      throw new Error(\n        `Slack webhook failed (${response.status}): ${errorText}`\n      );\n    }\n  }\n\n  /**\n   * Format events payload as Slack message\n   */\n  private formatSlackMessage(payload: EventPayload): SlackMessage {\n    const emoji = this.getEventEmoji(payload);\n    const color = this.getEventColor(payload);\n    const title = `${emoji} ${payload.name}`;\n\n    // Add event type\n    const fields: SlackField[] = [\n      {\n        title: 'Event Type',\n        value: this.formatEventType(payload),\n        short: true,\n      },\n    ];\n\n    // Add timestamp if enabled\n    if (this.config.includeTimestamp) {\n      fields.push({\n        title: 'Timestamp',\n        value: new Date(payload.timestamp).toLocaleString('en-US', {\n          month: 'short',\n          day: 'numeric',\n          hour: '2-digit',\n          minute: '2-digit',\n          second: '2-digit',\n        }),\n        short: true,\n      });\n    }\n\n    // Add attributes as fields\n    if (this.config.includeAttributes && payload.attributes) {\n      const attributeFields = this.formatAttributes(payload.attributes);\n      fields.push(...attributeFields);\n    }\n\n    const attachment: SlackAttachment = {\n      color,\n      title,\n      fields,\n      footer: 'Events Events',\n      footer_icon: 'https://i.imgur.com/QpCKbNL.png',\n    };\n\n    // Add Unix timestamp for Slack\n    if (this.config.includeTimestamp) {\n      attachment.ts = Math.floor(\n        new Date(payload.timestamp).getTime() / 1000\n      );\n    }\n\n    return {\n      channel: this.config.channel,\n      username: this.config.username,\n      icon_emoji: this.config.iconEmoji,\n      attachments: [attachment],\n    };\n  }\n\n  /**\n   * Get emoji for event type\n   */\n  private getEventEmoji(payload: EventPayload): string {\n    switch (payload.type) {\n      case 'outcome': {\n        return payload.outcome === 'success' ? '✅' : '❌';\n      }\n      case 'funnel': {\n        return '🔄';\n      }\n      case 'value': {\n        return '📊';\n      }\n      default: {\n        // Use custom emoji for common event patterns\n        if (payload.name.includes('order') || payload.name.includes('payment'))\n          return '💰';\n        if (payload.name.includes('signup') || payload.name.includes('user'))\n          return '👤';\n        if (payload.name.includes('error') || payload.name.includes('fail'))\n          return '⚠️';\n        return '📌';\n      }\n    }\n  }\n\n  /**\n   * Get Slack attachment color for event type\n   */\n  private getEventColor(payload: EventPayload): string {\n    switch (payload.type) {\n      case 'outcome': {\n        return payload.outcome === 'success' ? 'good' : 'danger';\n      } // Green or red\n      case 'funnel': {\n        return '#3AA3E3';\n      } // Blue\n      case 'value': {\n        return '#764FA5';\n      } // Purple\n      default: {\n        // Custom colors for patterns\n        if (payload.name.includes('error') || payload.name.includes('fail'))\n          return 'danger';\n        if (payload.name.includes('warning')) return 'warning';\n        return 'good';\n      } // Default green\n    }\n  }\n\n  /**\n   * Format event type for display\n   */\n  private formatEventType(payload: EventPayload): string {\n    switch (payload.type) {\n      case 'event': {\n        return 'Event';\n      }\n      case 'funnel': {\n        return `Funnel: ${payload.step || 'unknown'}`;\n      }\n      case 'outcome': {\n        return `Outcome: ${payload.outcome || 'unknown'}`;\n      }\n      case 'value': {\n        return `Value: ${payload.value ?? 'N/A'}`;\n      }\n      default: {\n        return payload.type;\n      }\n    }\n  }\n\n  /**\n   * Format attributes as Slack fields\n   */\n  private formatAttributes(attributes: Record<string, any>): SlackField[] {\n    const fields: SlackField[] = [];\n    const entries = Object.entries(attributes);\n\n    // Limit number of fields\n    const limit = Math.min(entries.length, this.config.maxAttributeFields);\n\n    for (let i = 0; i < limit; i++) {\n      const [key, value] = entries[i];\n\n      // Skip internal/system fields\n      if (key.startsWith('_') || key === 'timestamp') continue;\n\n      fields.push({\n        title: this.formatFieldName(key),\n        value: this.formatFieldValue(value),\n        short: true,\n      });\n    }\n\n    // Add truncation notice if needed\n    if (entries.length > this.config.maxAttributeFields) {\n      fields.push({\n        title: 'Note',\n        value: `... and ${entries.length - this.config.maxAttributeFields} more fields`,\n        short: false,\n      });\n    }\n\n    return fields;\n  }\n\n  /**\n   * Format field name (convert camelCase to Title Case)\n   */\n  private formatFieldName(name: string): string {\n    return name\n      .replaceAll(/([A-Z])/g, ' $1') // Add space before capitals\n      .replace(/^./, (str) => str.toUpperCase()) // Capitalize first letter\n      .trim();\n  }\n\n  /**\n   * Format field value\n   */\n  private formatFieldValue(value: any): string {\n    if (value === null || value === undefined) return 'N/A';\n    if (typeof value === 'boolean') return value ? 'Yes' : 'No';\n    if (typeof value === 'object') return JSON.stringify(value);\n    if (typeof value === 'number' && !Number.isInteger(value)) {\n      return value.toFixed(2);\n    }\n    return String(value);\n  }\n\n  /**\n   * Handle errors (override from EventSubscriber)\n   */\n  protected handleError(error: Error, payload: EventPayload): void {\n    console.error(\n      `[SlackSubscriber] Failed to send ${payload.type} event \"${payload.name}\":`,\n      error\n    );\n  }\n}\n"]}

package/dist/slack.d.cts

@@ -0,0 +1,126 @@
+import { E as EventSubscriber, a as EventPayload } from './event-subscriber-base-CnF3V56W.cjs';
+import 'autotel/event-subscriber';
+
+/**
+ * Slack Subscriber for autotel
+ *
+ * Send events events as notifications to Slack channels via webhooks.
+ *
+ * Perfect for:
+ * - Critical business events (orders, payments, signups)
+ * - Real-time alerts for failures
+ * - Team notifications for important milestones
+ * - Monitoring funnel completions
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Events } from 'autotel/events';
+ * import { SlackSubscriber } from 'autotel-subscribers/slack';
+ *
+ * const events = new Events('app', {
+ *   subscribers: [
+ *     new SlackSubscriber({
+ *       webhookUrl: process.env.SLACK_WEBHOOK_URL!,
+ *       channel: '#order-events'
+ *     })
+ *   ]
+ * });
+ *
+ * // Sends to Slack
+ * events.trackEvent('order.completed', {
+ *   orderId: 'ord_123',
+ *   userId: 'user_456',
+ *   amount: 99.99
+ * });
+ * ```
+ *
+ * @example Filter critical events only
+ * ```typescript
+ * const events = new Events('app', {
+ *   subscribers: [
+ *     new SlackSubscriber({
+ *       webhookUrl: process.env.SLACK_WEBHOOK_URL!,
+ *       channel: '#alerts',
+ *       filter: (payload) => {
+ *         // Only send failures and high-value orders
+ *         if (payload.type === 'outcome' && payload.outcome === 'failure') {
+ *           return true;
+ *         }
+ *         if (payload.name === 'order.completed' && payload.attributes?.amount > 1000) {
+ *           return true;
+ *         }
+ *         return false;
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ *
+ * Setup:
+ * 1. Create Slack App: https://api.slack.com/apps
+ * 2. Enable Incoming Webhooks
+ * 3. Add webhook to workspace
+ * 4. Copy webhook URL (https://hooks.slack.com/services/...)
+ */
+
+interface SlackSubscriberConfig {
+    /** Slack webhook URL (https://hooks.slack.com/services/...) */
+    webhookUrl: string;
+    /** Default channel to post to (optional, overrides webhook default) */
+    channel?: string;
+    /** Custom username for bot (default: 'Events Bot') */
+    username?: string;
+    /** Custom emoji icon (default: ':chart_with_upwards_trend:') */
+    iconEmoji?: string;
+    /** Include timestamp in messages (default: true) */
+    includeTimestamp?: boolean;
+    /** Include event attributes as fields (default: true) */
+    includeAttributes?: boolean;
+    /** Maximum attributes to show (default: 10) */
+    maxAttributeFields?: number;
+    /** Filter function - return true to send, false to skip */
+    filter?: (payload: EventPayload) => boolean;
+    /** Enable/disable subscriber */
+    enabled?: boolean;
+}
+declare class SlackSubscriber extends EventSubscriber {
+    readonly name = "SlackSubscriber";
+    readonly version = "1.0.0";
+    private config;
+    constructor(config: SlackSubscriberConfig);
+    protected sendToDestination(payload: EventPayload): Promise<void>;
+    /**
+     * Format events payload as Slack message
+     */
+    private formatSlackMessage;
+    /**
+     * Get emoji for event type
+     */
+    private getEventEmoji;
+    /**
+     * Get Slack attachment color for event type
+     */
+    private getEventColor;
+    /**
+     * Format event type for display
+     */
+    private formatEventType;
+    /**
+     * Format attributes as Slack fields
+     */
+    private formatAttributes;
+    /**
+     * Format field name (convert camelCase to Title Case)
+     */
+    private formatFieldName;
+    /**
+     * Format field value
+     */
+    private formatFieldValue;
+    /**
+     * Handle errors (override from EventSubscriber)
+     */
+    protected handleError(error: Error, payload: EventPayload): void;
+}
+
+export { SlackSubscriber, type SlackSubscriberConfig };

package/dist/slack.d.ts

@@ -0,0 +1,126 @@
+import { E as EventSubscriber, a as EventPayload } from './event-subscriber-base-CnF3V56W.js';
+import 'autotel/event-subscriber';
+
+/**
+ * Slack Subscriber for autotel
+ *
+ * Send events events as notifications to Slack channels via webhooks.
+ *
+ * Perfect for:
+ * - Critical business events (orders, payments, signups)
+ * - Real-time alerts for failures
+ * - Team notifications for important milestones
+ * - Monitoring funnel completions
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Events } from 'autotel/events';
+ * import { SlackSubscriber } from 'autotel-subscribers/slack';
+ *
+ * const events = new Events('app', {
+ *   subscribers: [
+ *     new SlackSubscriber({
+ *       webhookUrl: process.env.SLACK_WEBHOOK_URL!,
+ *       channel: '#order-events'
+ *     })
+ *   ]
+ * });
+ *
+ * // Sends to Slack
+ * events.trackEvent('order.completed', {
+ *   orderId: 'ord_123',
+ *   userId: 'user_456',
+ *   amount: 99.99
+ * });
+ * ```
+ *
+ * @example Filter critical events only
+ * ```typescript
+ * const events = new Events('app', {
+ *   subscribers: [
+ *     new SlackSubscriber({
+ *       webhookUrl: process.env.SLACK_WEBHOOK_URL!,
+ *       channel: '#alerts',
+ *       filter: (payload) => {
+ *         // Only send failures and high-value orders
+ *         if (payload.type === 'outcome' && payload.outcome === 'failure') {
+ *           return true;
+ *         }
+ *         if (payload.name === 'order.completed' && payload.attributes?.amount > 1000) {
+ *           return true;
+ *         }
+ *         return false;
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ *
+ * Setup:
+ * 1. Create Slack App: https://api.slack.com/apps
+ * 2. Enable Incoming Webhooks
+ * 3. Add webhook to workspace
+ * 4. Copy webhook URL (https://hooks.slack.com/services/...)
+ */
+
+interface SlackSubscriberConfig {
+    /** Slack webhook URL (https://hooks.slack.com/services/...) */
+    webhookUrl: string;
+    /** Default channel to post to (optional, overrides webhook default) */
+    channel?: string;
+    /** Custom username for bot (default: 'Events Bot') */
+    username?: string;
+    /** Custom emoji icon (default: ':chart_with_upwards_trend:') */
+    iconEmoji?: string;
+    /** Include timestamp in messages (default: true) */
+    includeTimestamp?: boolean;
+    /** Include event attributes as fields (default: true) */
+    includeAttributes?: boolean;
+    /** Maximum attributes to show (default: 10) */
+    maxAttributeFields?: number;
+    /** Filter function - return true to send, false to skip */
+    filter?: (payload: EventPayload) => boolean;
+    /** Enable/disable subscriber */
+    enabled?: boolean;
+}
+declare class SlackSubscriber extends EventSubscriber {
+    readonly name = "SlackSubscriber";
+    readonly version = "1.0.0";
+    private config;
+    constructor(config: SlackSubscriberConfig);
+    protected sendToDestination(payload: EventPayload): Promise<void>;
+    /**
+     * Format events payload as Slack message
+     */
+    private formatSlackMessage;
+    /**
+     * Get emoji for event type
+     */
+    private getEventEmoji;
+    /**
+     * Get Slack attachment color for event type
+     */
+    private getEventColor;
+    /**
+     * Format event type for display
+     */
+    private formatEventType;
+    /**
+     * Format attributes as Slack fields
+     */
+    private formatAttributes;
+    /**
+     * Format field name (convert camelCase to Title Case)
+     */
+    private formatFieldName;
+    /**
+     * Format field value
+     */
+    private formatFieldValue;
+    /**
+     * Handle errors (override from EventSubscriber)
+     */
+    protected handleError(error: Error, payload: EventPayload): void;
+}
+
+export { SlackSubscriber, type SlackSubscriberConfig };