autotel-subscribers 4.0.0

package/dist/webhook.js

@@ -0,0 +1,98 @@
+// src/webhook.ts
+var WebhookSubscriber = class {
+  name = "WebhookSubscriber";
+  version = "1.0.0";
+  config;
+  enabled;
+  pendingRequests = /* @__PURE__ */ new Set();
+  constructor(config) {
+    this.config = config;
+    this.enabled = config.enabled ?? true;
+  }
+  async send(payload) {
+    if (!this.enabled) return;
+    const maxRetries = this.config.maxRetries ?? 3;
+    let lastError;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      try {
+        const response = await fetch(this.config.url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            ...this.config.headers
+          },
+          body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+          throw new Error(`Webhook returned ${response.status}: ${response.statusText}`);
+        }
+        return;
+      } catch (error) {
+        lastError = error;
+        if (attempt < maxRetries - 1) {
+          await new Promise((resolve) => setTimeout(resolve, Math.pow(2, attempt) * 1e3));
+        }
+      }
+    }
+    console.error(`Webhook subscriber failed after ${maxRetries} attempts:`, lastError);
+  }
+  async trackEvent(name, attributes) {
+    const request = this.send({
+      type: "event",
+      name,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    this.trackRequest(request);
+    await request;
+  }
+  async trackFunnelStep(funnelName, step, attributes) {
+    const request = this.send({
+      type: "funnel",
+      funnel: funnelName,
+      step,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    this.trackRequest(request);
+    await request;
+  }
+  async trackOutcome(operationName, outcome, attributes) {
+    const request = this.send({
+      type: "outcome",
+      operation: operationName,
+      outcome,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    this.trackRequest(request);
+    await request;
+  }
+  async trackValue(name, value, attributes) {
+    const request = this.send({
+      type: "value",
+      name,
+      value,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    this.trackRequest(request);
+    await request;
+  }
+  trackRequest(request) {
+    this.pendingRequests.add(request);
+    void request.finally(() => {
+      this.pendingRequests.delete(request);
+    });
+  }
+  /** Wait for all pending webhook requests to complete */
+  async shutdown() {
+    if (this.pendingRequests.size > 0) {
+      await Promise.allSettled(this.pendingRequests);
+    }
+  }
+};
+
+export { WebhookSubscriber };
+//# sourceMappingURL=webhook.js.map
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/webhook.ts"],"names":[],"mappings":"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","file":"webhook.js","sourcesContent":["/**\n * Webhook Subscriber for autotel\n *\n * Send events to any webhook endpoint (custom integrations, Zapier, Make.com, etc.).\n *\n * @example\n * ```typescript\n * import { Events } from 'autotel/events';\n * import { WebhookSubscriber } from 'autotel-subscribers/webhook';\n *\n * const events = new Events('checkout', {\n *   subscribers: [\n *     new WebhookSubscriber({\n *       url: 'https://hooks.zapier.com/hooks/catch/...',\n *       headers: { 'X-API-Key': 'secret' }\n *     })\n *   ]\n * });\n *\n * events.trackEvent('order.completed', { userId: '123', amount: 99.99 });\n * ```\n */\n\nimport type {\n  EventSubscriber,\n  EventAttributes,\n  FunnelStatus,\n  OutcomeStatus,\n} from 'autotel/event-subscriber';\n\nexport interface WebhookConfig {\n  /** Webhook URL */\n  url: string;\n  /** Optional headers (e.g., API keys) */\n  headers?: Record<string, string>;\n  /** Enable/disable the subscriber */\n  enabled?: boolean;\n  /** Retry failed requests (default: 3) */\n  maxRetries?: number;\n}\n\nexport class WebhookSubscriber implements EventSubscriber {\n  readonly name = 'WebhookSubscriber';\n  readonly version = '1.0.0';\n\n  private config: WebhookConfig;\n  private enabled: boolean;\n  private pendingRequests: Set<Promise<void>> = new Set();\n\n  constructor(config: WebhookConfig) {\n    this.config = config;\n    this.enabled = config.enabled ?? true;\n  }\n\n  private async send(payload: any): Promise<void> {\n    if (!this.enabled) return;\n\n    const maxRetries = this.config.maxRetries ?? 3;\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        const response = await fetch(this.config.url, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            ...this.config.headers,\n          },\n          body: JSON.stringify(payload),\n        });\n\n        if (!response.ok) {\n          throw new Error(`Webhook returned ${response.status}: ${response.statusText}`);\n        }\n\n        return; // Success\n      } catch (error) {\n        lastError = error as Error;\n        if (attempt < maxRetries - 1) {\n          // Exponential backoff\n          await new Promise((resolve) => setTimeout(resolve, Math.pow(2, attempt) * 1000));\n        }\n      }\n    }\n\n    console.error(`Webhook subscriber failed after ${maxRetries} attempts:`, lastError);\n  }\n\n  async trackEvent(name: string, attributes?: EventAttributes): Promise<void> {\n    const request = this.send({\n      type: 'event',\n      name,\n      attributes,\n      timestamp: new Date().toISOString(),\n    });\n    this.trackRequest(request);\n    await request;\n  }\n\n  async trackFunnelStep(\n    funnelName: string,\n    step: FunnelStatus,\n    attributes?: EventAttributes,\n  ): Promise<void> {\n    const request = this.send({\n      type: 'funnel',\n      funnel: funnelName,\n      step,\n      attributes,\n      timestamp: new Date().toISOString(),\n    });\n    this.trackRequest(request);\n    await request;\n  }\n\n  async trackOutcome(\n    operationName: string,\n    outcome: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): Promise<void> {\n    const request = this.send({\n      type: 'outcome',\n      operation: operationName,\n      outcome,\n      attributes,\n      timestamp: new Date().toISOString(),\n    });\n    this.trackRequest(request);\n    await request;\n  }\n\n  async trackValue(name: string, value: number, attributes?: EventAttributes): Promise<void> {\n    const request = this.send({\n      type: 'value',\n      name,\n      value,\n      attributes,\n      timestamp: new Date().toISOString(),\n    });\n    this.trackRequest(request);\n    await request;\n  }\n\n  private trackRequest(request: Promise<void>): void {\n    this.pendingRequests.add(request);\n    void request.finally(() => {\n      this.pendingRequests.delete(request);\n    });\n  }\n\n  /** Wait for all pending webhook requests to complete */\n  async shutdown(): Promise<void> {\n    if (this.pendingRequests.size > 0) {\n      await Promise.allSettled(this.pendingRequests);\n    }\n  }\n}\n\n"]}

package/examples/quickstart-custom-subscriber.ts

@@ -0,0 +1,144 @@
+/**
+ * QUICKSTART: Your First Custom Subscriber in 5 Minutes
+ *
+ * This template shows you EVERYTHING you need to write a custom events subscriber.
+ * Just copy-paste this code and replace the console.log statements with your API calls.
+ *
+ * @example
+ * ```typescript
+ * import { Events } from 'autotel/events';
+ * import { MyFirstSubscriber } from './my-first-subscriber';
+ *
+ * const event =new Event('my-app', {
+ *   subscribers: [new MyFirstSubscriber()]
+ * });
+ *
+ * events.trackEvent('user.signup', { userId: '123', email: 'user@example.com' });
+ * ```
+ */
+
+import type { EventSubscriber, EventAttributes, FunnelStatus, OutcomeStatus } from '../src/event-subscriber-base';
+
+export class MyFirstSubscriber implements EventSubscriber {
+  // Required: Subscriber name (shows up in logs)
+  readonly name = 'MyFirstSubscriber';
+
+  // Optional: Version for debugging
+  readonly version = '1.0.0';
+
+  /**
+   * Track a business event (e.g., "user.signup", "order.completed")
+   */
+  async trackEvent(name: string, attributes?: EventAttributes): Promise<void> {
+    console.log('📊 EVENT:', name, attributes);
+
+    // TODO: Replace with your API call
+    // Example:
+    // await fetch('https://your-api.com/events', {
+    //   method: 'POST',
+    //   headers: { 'Content-Type': 'application/json' },
+    //   body: JSON.stringify({ event: name, properties: attributes })
+    // });
+  }
+
+  /**
+   * Track a funnel step (e.g., checkout flow: "started" → "completed")
+   */
+  async trackFunnelStep(
+    funnel: string,
+    step: FunnelStatus,
+    attributes?: EventAttributes
+  ): Promise<void> {
+    console.log('🔄 FUNNEL:', funnel, step, attributes);
+
+    // TODO: Replace with your API call
+    // Most platforms just treat this as a regular event:
+    // await this.trackEvent(`${funnel}.${step}`, { ...attributes, funnel, step });
+  }
+
+  /**
+   * Track an operation outcome (e.g., payment: "success" or "failure")
+   */
+  async trackOutcome(
+    operation: string,
+    outcome: OutcomeStatus,
+    attributes?: EventAttributes
+  ): Promise<void> {
+    console.log('✅ OUTCOME:', operation, outcome, attributes);
+
+    // TODO: Replace with your API call
+    // await this.trackEvent(`${operation}.${outcome}`, { ...attributes, operation, outcome });
+  }
+
+  /**
+   * Track a numeric value (e.g., revenue, response time)
+   */
+  async trackValue(
+    name: string,
+    value: number,
+    attributes?: EventAttributes
+  ): Promise<void> {
+    console.log('💰 VALUE:', name, value, attributes);
+
+    // TODO: Replace with your API call
+    // await this.trackEvent(name, { ...attributes, value });
+  }
+
+  /**
+   * Optional: Cleanup on shutdown
+   * Use this to flush buffered events, close connections, etc.
+   */
+  async shutdown(): Promise<void> {
+    console.log('👋 SHUTDOWN');
+
+    // TODO: Add cleanup logic
+    // Example:
+    // await this.flushBuffer();
+    // await this.httpClient.close();
+  }
+}
+
+// ============================================================================
+// USAGE EXAMPLE
+// ============================================================================
+
+// Uncomment to test:
+// import { Events } from 'autotel/events';
+//
+// const events = new Events('my-app', {
+//   subscribers: [new MyFirstSubscriber()]
+// });
+//
+// // Track events
+// await events.trackEvent('user.signup', {
+//   userId: 'user-123',
+//   email: 'user@example.com',
+//   plan: 'pro'
+// });
+//
+// await events.trackFunnelStep('checkout', 'started', {
+//   cartValue: 99.99
+// });
+//
+// await events.trackOutcome('payment', 'success', {
+//   amount: 99.99,
+//   method: 'credit_card'
+// });
+//
+// await events.trackValue('revenue', 99.99, {
+//   currency: 'USD',
+//   orderId: 'ord-456'
+// });
+//
+// // Cleanup
+// await events.shutdown();
+
+// ============================================================================
+// NEXT STEPS
+// ============================================================================
+
+// 1. Copy this file to your project
+// 2. Rename "MyFirstSubscriber" to your service name (e.g., "AmplitudeSubscriber")
+// 3. Replace console.log with your API calls
+// 4. Test it! (see examples/testing-custom-adapter.ts)
+// 5. Add error handling and retry logic (see docs/adapter-guide.md)

package/examples/subscriber-bigquery.ts

@@ -0,0 +1,219 @@
+/**
+ * BigQuery Subscriber Example
+ *
+ * Sends events events to Google BigQuery data warehouse.
+ * This is a complete, production-ready implementation.
+ *
+ * Installation:
+ * ```bash
+ * pnpm add @google-cloud/bigquery
+ * ```
+ *
+ * Setup BigQuery table:
+ * ```sql
+ * CREATE TABLE `project.dataset.events_events` (
+ *   event_id STRING NOT NULL,
+ *   event_type STRING NOT NULL,
+ *   event_name STRING NOT NULL,
+ *   attributes JSON,
+ *   funnel STRING,
+ *   step STRING,
+ *   operation STRING,
+ *   outcome STRING,
+ *   value NUMERIC,
+ *   timestamp TIMESTAMP NOT NULL,
+ *   created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP()
+ * )
+ * PARTITION BY DATE(timestamp)
+ * CLUSTER BY event_type, event_name;
+ * ```
+ *
+ * Setup Authentication:
+ * ```bash
+ * # Set environment variable
+ * export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"
+ * ```
+ *
+ * Usage:
+ * ```typescript
+ * import { Events } from 'autotel/events';
+ * import { BigQuerySubscriber } from './adapter-bigquery';
+ *
+ * const events = new Events('app', {
+ *   subscribers: [
+ *     new BigQuerySubscriber({
+ *       projectId: 'my-gcp-project',
+ *       dataset: 'events',
+ *       table: 'events'
+ *     })
+ *   ]
+ * });
+ *
+ * events.trackEvent('order.completed', { orderId: 'ord_123', amount: 99.99 });
+ * ```
+ */
+
+import {
+  EventSubscriber,
+  type EventPayload,
+} from '../src/event-subscriber-base';
+import { BigQuery } from '@google-cloud/bigquery';
+
+export interface BigQuerySubscriberConfig {
+  /** GCP Project ID */
+  projectId: string;
+  /** BigQuery dataset name */
+  dataset: string;
+  /** BigQuery table name */
+  table: string;
+  /** Service account key file path (optional, uses GOOGLE_APPLICATION_CREDENTIALS if not set) */
+  keyFilename?: string;
+  /** Enable/disable subscriber */
+  enabled?: boolean;
+  /** Batch size (default: 500) */
+  batchSize?: number;
+  /** Flush interval in ms (default: 10000) */
+  flushInterval?: number;
+}
+
+export class BigQuerySubscriber extends EventSubscriber {
+  readonly name = 'BigQuerySubscriber';
+  readonly version = '1.0.0';
+
+  private client: BigQuery;
+  private tableRef: any;
+  private config: Required<BigQuerySubscriberConfig>;
+  private buffer: EventPayload[] = [];
+  private flushIntervalHandle: NodeJS.Timeout | null = null;
+
+  constructor(config: BigQuerySubscriberConfig) {
+    super();
+
+    // Set defaults
+    this.config = {
+      keyFilename: '',
+      enabled: true,
+      batchSize: 500,
+      flushInterval: 10_000,
+      ...config,
+    };
+
+    this.enabled = this.config.enabled;
+
+    if (this.enabled) {
+      this.initializeClient();
+      this.startFlushInterval();
+    }
+  }
+
+  private initializeClient(): void {
+    try {
+      const options: any = {
+        projectId: this.config.projectId,
+      };
+
+      if (this.config.keyFilename) {
+        options.keyFilename = this.config.keyFilename;
+      }
+
+      this.client = new BigQuery(options);
+
+      const dataset = this.client.dataset(this.config.dataset);
+      this.tableRef = dataset.table(this.config.table);
+
+      console.log('[BigQuerySubscriber] Initialized successfully');
+    } catch (error) {
+      console.error('[BigQuerySubscriber] Failed to initialize:', error);
+      this.enabled = false;
+    }
+  }
+
+  private startFlushInterval(): void {
+    this.flushIntervalHandle = setInterval(() => {
+      void this.flushBuffer();
+    }, this.config.flushInterval);
+  }
+
+  protected async sendToDestination(payload: EventPayload): Promise<void> {
+    this.buffer.push(payload);
+
+    // Auto-flush at batch size
+    if (this.buffer.length >= this.config.batchSize) {
+      await this.flushBuffer();
+    }
+  }
+
+  private async flushBuffer(): Promise<void> {
+    if (this.buffer.length === 0) return;
+
+    const batch = [...this.buffer];
+    this.buffer = [];
+
+    try {
+      await this.insertBatch(batch);
+    } catch (error) {
+      console.error('[BigQuerySubscriber] Failed to flush batch:', error);
+      // Re-add to buffer for retry
+      this.buffer.unshift(...batch);
+    }
+  }
+
+  private async insertBatch(events: EventPayload[]): Promise<void> {
+    const rows = events.map((event) => ({
+      event_id: crypto.randomUUID(),
+      event_type: event.type,
+      event_name: event.name,
+      attributes: event.attributes || {},
+      funnel: event.funnel || null,
+      step: event.step || null,
+      operation: event.operation || null,
+      outcome: event.outcome || null,
+      value: event.value || null,
+      timestamp: event.timestamp,
+    }));
+
+    // Insert rows
+    await this.tableRef.insert(rows, {
+      // Skip invalid rows (don't fail entire batch)
+      skipInvalidRows: false,
+      // Don't ignore unknown values
+      ignoreUnknownValues: false,
+    });
+  }
+
+  protected handleError(error: Error, payload: EventPayload): void {
+    console.error(
+      `[BigQuerySubscriber] Failed to send ${payload.type}:`,
+      error,
+      {
+        eventName: payload.name,
+        attributes: payload.attributes,
+      }
+    );
+
+    // BigQuery-specific error handling
+    if (error.message.includes('quota')) {
+      console.error('[BigQuerySubscriber] Quota exceeded - consider increasing batchSize or flushInterval');
+    }
+
+    if (error.message.includes('schema')) {
+      console.error('[BigQuerySubscriber] Schema mismatch - check table schema');
+    }
+  }
+
+  async shutdown(): Promise<void> {
+    // Clear flush interval
+    if (this.flushIntervalHandle) {
+      clearInterval(this.flushIntervalHandle);
+      this.flushIntervalHandle = null;
+    }
+
+    // Flush remaining events
+    await this.flushBuffer();
+
+    // Wait for pending requests
+    await super.shutdown();
+
+    console.log('[BigQuerySubscriber] Shutdown complete');
+  }
+}