@sygnl/talon 1.0.1

package/README.md

@@ -0,0 +1,96 @@
+# @sygnl/talon
+
+> Bidirectional event delivery client with WebSocket and Webhook transports.
+
+## Install
+
+```bash
+npm install @sygnl/talon
+```
+
+## Quick Start
+
+### WebSocket (Bidirectional)
+
+```typescript
+import { TalonClient, WebSocketTransport } from '@sygnl/talon';
+
+const talon = new TalonClient({
+  transport: new WebSocketTransport('wss://edge.example.com'),
+  autoConnect: true
+});
+
+// Send events TO edge
+await talon.send({ event: 'purchase', order_id: '123', total: 99.99 });
+
+// Receive updates FROM edge
+talon.on('attribution_updated', (data) => {
+  console.log('Attribution:', data);
+});
+
+talon.on('context_synced', (data) => {
+  console.log('Context synced:', data);
+});
+```
+
+### Webhook (Fire-and-forget)
+
+```typescript
+import { TalonClient, WebhookTransport } from '@sygnl/talon';
+
+const talon = new TalonClient({
+  transport: new WebhookTransport('https://edge.example.com/webhook')
+});
+
+await talon.send({ event: 'page_view', url: '/products' });
+```
+
+## API
+
+### `TalonClient`
+
+```typescript
+const talon = new TalonClient({
+  transport: WebSocketTransport | WebhookTransport,
+  autoConnect?: boolean,
+  debug?: boolean
+});
+
+// Methods
+await talon.connect();
+await talon.disconnect();
+await talon.send(event);
+talon.on(eventName, handler);
+talon.off(eventName, handler);
+talon.isConnected(); // boolean
+```
+
+### Transports
+
+**WebSocketTransport** - Bidirectional, auto-reconnect
+```typescript
+new WebSocketTransport(url, {
+  reconnect?: boolean,
+  reconnectInterval?: number,
+  maxReconnectAttempts?: number
+});
+```
+
+**WebhookTransport** - One-way HTTP POST
+```typescript
+new WebhookTransport(url, {
+  method?: 'POST' | 'PUT',
+  retries?: number
+});
+```
+
+## Connection States
+
+- `disconnected` - Not connected
+- `connecting` - Connection in progress
+- `connected` - Ready to send/receive
+- `reconnecting` - Attempting to reconnect
+
+## License
+
+Apache-2.0

package/dist/index.cjs

@@ -0,0 +1,347 @@
+'use strict';
+
+// src/transports/WebSocketTransport.ts
+var WebSocketTransport = class {
+  constructor(options) {
+    this.ws = null;
+    this._state = "disconnected";
+    this.reconnectAttempts = 0;
+    this.reconnectTimeout = null;
+    this.messageHandlers = /* @__PURE__ */ new Set();
+    this.stateHandlers = /* @__PURE__ */ new Set();
+    this.errorHandlers = /* @__PURE__ */ new Set();
+    this.messageQueue = [];
+    this.url = options.url;
+    this.autoReconnect = options.autoReconnect ?? true;
+    this.reconnectDelay = options.reconnectDelay ?? 1e3;
+    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 0;
+    this.connectionTimeout = options.connectionTimeout ?? 1e4;
+    this.debug = options.debug ?? false;
+  }
+  get state() {
+    return this._state;
+  }
+  async connect() {
+    if (this._state === "connected" || this._state === "connecting") {
+      this.log("Already connected or connecting");
+      return;
+    }
+    this.setState("connecting");
+    this.log(`Connecting to ${this.url}`);
+    return new Promise((resolve, reject) => {
+      try {
+        this.ws = new WebSocket(this.url);
+        const timeout = setTimeout(() => {
+          reject(new Error("Connection timeout"));
+          this.ws?.close();
+        }, this.connectionTimeout);
+        this.ws.onopen = () => {
+          clearTimeout(timeout);
+          this.setState("connected");
+          this.reconnectAttempts = 0;
+          this.log("Connected");
+          this.flushMessageQueue();
+          resolve();
+        };
+        this.ws.onerror = () => {
+          clearTimeout(timeout);
+          const error = new Error("WebSocket connection error");
+          this.log("Connection error:", error);
+          this.emitError(error);
+          reject(error);
+        };
+        this.ws.onclose = () => {
+          clearTimeout(timeout);
+          this.handleDisconnect();
+        };
+        this.ws.onmessage = (event) => {
+          this.handleMessage(event.data);
+        };
+      } catch (error) {
+        this.setState("error");
+        const err = error instanceof Error ? error : new Error("Unknown error");
+        this.emitError(err);
+        reject(err);
+      }
+    });
+  }
+  disconnect() {
+    this.log("Disconnecting");
+    this.autoReconnect = false;
+    if (this.reconnectTimeout) {
+      clearTimeout(this.reconnectTimeout);
+      this.reconnectTimeout = null;
+    }
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.setState("disconnected");
+  }
+  async send(message) {
+    if (this._state !== "connected" || !this.ws) {
+      this.log("Not connected, queueing message");
+      this.messageQueue.push(message);
+      return;
+    }
+    try {
+      const payload = JSON.stringify(message);
+      this.ws.send(payload);
+      this.log("Sent message:", message);
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error("Send failed");
+      this.log("Send error:", err);
+      this.emitError(err);
+      throw err;
+    }
+  }
+  onMessage(handler) {
+    this.messageHandlers.add(handler);
+    return () => this.messageHandlers.delete(handler);
+  }
+  onStateChange(handler) {
+    this.stateHandlers.add(handler);
+    return () => this.stateHandlers.delete(handler);
+  }
+  onError(handler) {
+    this.errorHandlers.add(handler);
+    return () => this.errorHandlers.delete(handler);
+  }
+  /**
+   * Handle incoming WebSocket message
+   */
+  handleMessage(data) {
+    try {
+      const message = JSON.parse(data);
+      this.log("Received message:", message);
+      this.messageHandlers.forEach((handler) => {
+        try {
+          handler(message);
+        } catch (error) {
+          this.log("Handler error:", error);
+        }
+      });
+    } catch (error) {
+      this.log("Failed to parse message:", error);
+      this.emitError(new Error("Invalid message format"));
+    }
+  }
+  /**
+   * Handle WebSocket disconnect
+   */
+  handleDisconnect() {
+    this.log("Disconnected");
+    this.ws = null;
+    if (this.autoReconnect && (this.maxReconnectAttempts === 0 || this.reconnectAttempts < this.maxReconnectAttempts)) {
+      this.setState("reconnecting");
+      this.scheduleReconnect();
+    } else {
+      this.setState("disconnected");
+    }
+  }
+  /**
+   * Schedule reconnection attempt with exponential backoff
+   */
+  scheduleReconnect() {
+    const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts);
+    this.log(`Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts + 1})`);
+    this.reconnectTimeout = setTimeout(() => {
+      this.reconnectAttempts++;
+      this.connect().catch((error) => {
+        this.log("Reconnect failed:", error);
+        this.handleDisconnect();
+      });
+    }, delay);
+  }
+  /**
+   * Flush queued messages
+   */
+  flushMessageQueue() {
+    if (this.messageQueue.length === 0) {
+      return;
+    }
+    this.log(`Flushing ${this.messageQueue.length} queued messages`);
+    const queue = [...this.messageQueue];
+    this.messageQueue = [];
+    queue.forEach((message) => {
+      this.send(message).catch((error) => {
+        this.log("Failed to flush message:", error);
+      });
+    });
+  }
+  /**
+   * Set connection state
+   */
+  setState(state) {
+    if (this._state === state) {
+      return;
+    }
+    this._state = state;
+    this.stateHandlers.forEach((handler) => {
+      try {
+        handler(state);
+      } catch (error) {
+        this.log("State handler error:", error);
+      }
+    });
+  }
+  /**
+   * Emit error to handlers
+   */
+  emitError(error) {
+    this.errorHandlers.forEach((handler) => {
+      try {
+        handler(error);
+      } catch (err) {
+        this.log("Error handler error:", err);
+      }
+    });
+  }
+  /**
+   * Debug logging
+   */
+  log(message, data) {
+    if (this.debug && typeof console !== "undefined") {
+      console.log(`[WebSocketTransport] ${message}`, data || "");
+    }
+  }
+};
+
+// src/transports/WebhookTransport.ts
+var WebhookTransport = class {
+  constructor(options) {
+    this._state = "disconnected";
+    this.messageHandlers = /* @__PURE__ */ new Set();
+    this.stateHandlers = /* @__PURE__ */ new Set();
+    this.errorHandlers = /* @__PURE__ */ new Set();
+    this.url = options.url;
+    this.method = options.method ?? "POST";
+    this.headers = {
+      "Content-Type": "application/json",
+      ...options.headers
+    };
+    this.timeout = options.timeout ?? 1e4;
+    this.retry = options.retry ?? false;
+    this.maxRetries = options.maxRetries ?? 3;
+    this.retryDelay = options.retryDelay ?? 1e3;
+    this.debug = options.debug ?? false;
+  }
+  get state() {
+    return this._state;
+  }
+  async connect() {
+    this.log("Webhook transport ready");
+    this.setState("connected");
+  }
+  disconnect() {
+    this.log("Disconnecting webhook transport");
+    this.setState("disconnected");
+  }
+  async send(message) {
+    if (this._state !== "connected") {
+      throw new Error("Transport not connected");
+    }
+    let lastError = null;
+    const attempts = this.retry ? this.maxRetries + 1 : 1;
+    for (let attempt = 0; attempt < attempts; attempt++) {
+      try {
+        await this.sendRequest(message);
+        this.log(`Sent message (attempt ${attempt + 1})`);
+        return;
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error("Send failed");
+        this.log(`Send failed (attempt ${attempt + 1}):`, lastError);
+        if (attempt < attempts - 1) {
+          const delay = this.retryDelay * Math.pow(2, attempt);
+          await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+      }
+    }
+    if (lastError) {
+      this.emitError(lastError);
+      throw lastError;
+    }
+  }
+  onMessage(handler) {
+    this.messageHandlers.add(handler);
+    return () => this.messageHandlers.delete(handler);
+  }
+  onStateChange(handler) {
+    this.stateHandlers.add(handler);
+    return () => this.stateHandlers.delete(handler);
+  }
+  onError(handler) {
+    this.errorHandlers.add(handler);
+    return () => this.errorHandlers.delete(handler);
+  }
+  /**
+   * Send HTTP request
+   */
+  async sendRequest(message) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(this.url, {
+        method: this.method,
+        headers: this.headers,
+        body: JSON.stringify(message),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      this.log(`Request successful: ${response.status}`);
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new Error("Request timeout");
+        }
+        throw error;
+      }
+      throw new Error("Request failed");
+    }
+  }
+  /**
+   * Set connection state
+   */
+  setState(state) {
+    if (this._state === state) {
+      return;
+    }
+    this._state = state;
+    this.stateHandlers.forEach((handler) => {
+      try {
+        handler(state);
+      } catch (error) {
+        this.log("State handler error:", error);
+      }
+    });
+  }
+  /**
+   * Emit error to handlers
+   */
+  emitError(error) {
+    this.errorHandlers.forEach((handler) => {
+      try {
+        handler(error);
+      } catch (err) {
+        this.log("Error handler error:", err);
+      }
+    });
+  }
+  /**
+   * Debug logging
+   */
+  log(message, data) {
+    if (this.debug && typeof console !== "undefined") {
+      console.log(`[WebhookTransport] ${message}`, data || "");
+    }
+  }
+};
+
+exports.WebSocketTransport = WebSocketTransport;
+exports.WebhookTransport = WebhookTransport;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/TalonClient.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  TalonTransport,\n  TalonClientOptions,\n  OutboundMessage,\n  InboundMessage,\n  EventHandler,\n  TransportState,\n} from './types';\n\n/**\n * TalonClient - Bidirectional event delivery client\n * \n * Features:\n * - Send events TO the edge\n * - Receive updates FROM the edge\n * - Transport-agnostic (WebSocket, Webhook, etc.)\n * - Event emitter pattern for edge responses\n * \n * @example\n * ```typescript\n * import { TalonClient } from '@sygnl/talon';\n * import { WebSocketTransport } from '@sygnl/talon/transports';\n * \n * const talon = new TalonClient({\n *   transport: new WebSocketTransport('wss://edge.sygnl.io')\n * });\n * \n * // Send event TO edge\n * await talon.send({ event: 'add_to_cart', product_id: 'abc' });\n * \n * // Receive updates FROM edge\n * talon.on('attribution_updated', (data) => {\n *   console.log('Attribution:', data);\n * });\n * ```\n */\nexport class TalonClient {\n  private transport: TalonTransport;\n  private eventHandlers: Map<string, Set<EventHandler>>;\n  private messageUnsubscribe?: () => void;\n  private stateUnsubscribe?: () => void;\n  private errorUnsubscribe?: () => void;\n  private debug: boolean;\n\n  constructor(options: TalonClientOptions) {\n    this.transport = options.transport;\n    this.eventHandlers = new Map();\n    this.debug = options.debug ?? false;\n\n    // Subscribe to transport messages\n    this.messageUnsubscribe = this.transport.onMessage(this.handleMessage.bind(this));\n    this.stateUnsubscribe = this.transport.onStateChange(this.handleStateChange.bind(this));\n    this.errorUnsubscribe = this.transport.onError(this.handleError.bind(this));\n\n    // Auto-connect if requested\n    if (options.autoConnect !== false) {\n      this.connect().catch((error) => {\n        this.log('Auto-connect failed:', error);\n      });\n    }\n  }\n\n  /**\n   * Connect to the edge\n   */\n  public async connect(): Promise<void> {\n    return this.transport.connect();\n  }\n\n  /**\n   * Disconnect from the edge\n   */\n  public disconnect(): void {\n    this.transport.disconnect();\n    this.cleanup();\n  }\n\n  /**\n   * Send event TO the edge\n   * \n   * @param event - Event data to send\n   * @returns Promise that resolves when sent\n   * \n   * @example\n   * ```typescript\n   * await talon.send({\n   *   event: 'add_to_cart',\n   *   product_id: 'prod_123',\n   *   price: 99.99\n   * });\n   * ```\n   */\n  public async send(event: Record<string, unknown>): Promise<void> {\n    const message: OutboundMessage = {\n      type: 'event',\n      data: event,\n      id: this.generateId(),\n      timestamp: Date.now(),\n    };\n\n    this.log('Sending message:', message);\n    return this.transport.send(message);\n  }\n\n  /**\n   * Subscribe to events FROM the edge\n   * \n   * @param eventType - Event type to listen for\n   * @param handler - Function to call when event received\n   * @returns Unsubscribe function\n   * \n   * @example\n   * ```typescript\n   * const unsubscribe = talon.on('attribution_updated', (data) => {\n   *   console.log('Attribution:', data);\n   * });\n   * \n   * // Later: unsubscribe()\n   * ```\n   */\n  public on<T = any>(eventType: string, handler: EventHandler<T>): () => void {\n    if (!this.eventHandlers.has(eventType)) {\n      this.eventHandlers.set(eventType, new Set());\n    }\n\n    this.eventHandlers.get(eventType)!.add(handler);\n    this.log(`Subscribed to event: ${eventType}`);\n\n    // Return unsubscribe function\n    return () => {\n      const handlers = this.eventHandlers.get(eventType);\n      if (handlers) {\n        handlers.delete(handler);\n        if (handlers.size === 0) {\n          this.eventHandlers.delete(eventType);\n        }\n      }\n      this.log(`Unsubscribed from event: ${eventType}`);\n    };\n  }\n\n  /**\n   * Subscribe to event once (auto-unsubscribe after first call)\n   */\n  public once<T = any>(eventType: string, handler: EventHandler<T>): () => void {\n    const wrappedHandler = (data: T) => {\n      handler(data);\n      unsubscribe();\n    };\n\n    const unsubscribe = this.on(eventType, wrappedHandler);\n    return unsubscribe;\n  }\n\n  /**\n   * Remove all handlers for an event type\n   */\n  public off(eventType: string): void {\n    this.eventHandlers.delete(eventType);\n    this.log(`Removed all handlers for: ${eventType}`);\n  }\n\n  /**\n   * Get current connection state\n   */\n  public get state(): TransportState {\n    return this.transport.state;\n  }\n\n  /**\n   * Check if connected\n   */\n  public get connected(): boolean {\n    return this.transport.state === 'connected';\n  }\n\n  /**\n   * Handle incoming message from transport\n   */\n  private handleMessage(message: InboundMessage): void {\n    this.log('Received message:', message);\n\n    const handlers = this.eventHandlers.get(message.type);\n    if (handlers && handlers.size > 0) {\n      handlers.forEach((handler) => {\n        try {\n          handler(message.data);\n        } catch (error) {\n          this.log(`Error in handler for ${message.type}:`, error);\n        }\n      });\n    } else {\n      this.log(`No handlers for message type: ${message.type}`);\n    }\n  }\n\n  /**\n   * Handle transport state change\n   */\n  private handleStateChange(state: TransportState): void {\n    this.log(`State changed: ${state}`);\n    \n    // Emit state change event\n    const handlers = this.eventHandlers.get('_state_change');\n    if (handlers) {\n      handlers.forEach((handler) => handler({ state }));\n    }\n  }\n\n  /**\n   * Handle transport error\n   */\n  private handleError(error: Error): void {\n    this.log('Transport error:', error);\n    \n    // Emit error event\n    const handlers = this.eventHandlers.get('_error');\n    if (handlers) {\n      handlers.forEach((handler) => handler({ error }));\n    }\n  }\n\n  /**\n   * Cleanup subscriptions\n   */\n  private cleanup(): void {\n    this.messageUnsubscribe?.();\n    this.stateUnsubscribe?.();\n    this.errorUnsubscribe?.();\n    this.eventHandlers.clear();\n  }\n\n  /**\n   * Generate unique message ID\n   */\n  private generateId(): string {\n    return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(message: string, data?: unknown): void {\n    if (this.debug && typeof console !== 'undefined') {\n      console.log(`[TalonClient] ${message}`, data || '');\n    }\n  }\n}\n"]}  \n  /** Auto-reconnect on disconnect */\n  autoReconnect?: boolean;\n  \n  /** Reconnect delay in ms */\n  reconnectDelay?: number;\n  \n  /** Max reconnect attempts (0 = infinite) */\n  maxReconnectAttempts?: number;\n  \n  /** Connection timeout in ms */\n  connectionTimeout?: number;\n  \n  /** Debug mode */\n  debug?: boolean;\n}\n\n/**\n * WebSocket transport for bidirectional communication\n * \n * Features:\n * - Real-time bidirectional communication\n * - Auto-reconnect with exponential backoff\n * - Connection state management\n * - Message queuing during disconnection\n * \n * @example\n * ```typescript\n * const transport = new WebSocketTransport({\n *   url: 'wss://edge.sygnl.io',\n *   autoReconnect: true\n * });\n * ```\n */\nexport class WebSocketTransport implements TalonTransport {\n  private url: string;\n  private ws: WebSocket | null = null;\n  private _state: TransportState = 'disconnected';\n  private autoReconnect: boolean;\n  private reconnectDelay: number;\n  private maxReconnectAttempts: number;\n  private reconnectAttempts = 0;\n  private reconnectTimeout: ReturnType<typeof setTimeout> | null = null;\n  private connectionTimeout: number;\n  private debug: boolean;\n  \n  private messageHandlers = new Set<(message: InboundMessage) => void>();\n  private stateHandlers = new Set<(state: TransportState) => void>();\n  private errorHandlers = new Set<(error: Error) => void>();\n  private messageQueue: OutboundMessage[] = [];\n\n  constructor(options: WebSocketTransportOptions) {\n    this.url = options.url;\n    this.autoReconnect = options.autoReconnect ?? true;\n    this.reconnectDelay = options.reconnectDelay ?? 1000;\n    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 0; // 0 = infinite\n    this.connectionTimeout = options.connectionTimeout ?? 10000;\n    this.debug = options.debug ?? false;\n  }\n\n  public get state(): TransportState {\n    return this._state;\n  }\n\n  public async connect(): Promise<void> {\n    if (this._state === 'connected' || this._state === 'connecting') {\n      this.log('Already connected or connecting');\n      return;\n    }\n\n    this.setState('connecting');\n    this.log(`Connecting to ${this.url}`);\n\n    return new Promise((resolve, reject) => {\n      try {\n        this.ws = new WebSocket(this.url);\n\n        const timeout = setTimeout(() => {\n          reject(new Error('Connection timeout'));\n          this.ws?.close();\n        }, this.connectionTimeout);\n\n        this.ws.onopen = () => {\n          clearTimeout(timeout);\n          this.setState('connected');\n          this.reconnectAttempts = 0;\n          this.log('Connected');\n          \n          // Flush queued messages\n          this.flushMessageQueue();\n          \n          resolve();\n        };\n\n        this.ws.onerror = () => {\n          clearTimeout(timeout);\n          const error = new Error('WebSocket connection error');\n          this.log('Connection error:', error);\n          this.emitError(error);\n          reject(error);\n        };\n\n        this.ws.onclose = () => {\n          clearTimeout(timeout);\n          this.handleDisconnect();\n        };\n\n        this.ws.onmessage = (event) => {\n          this.handleMessage(event.data);\n        };\n      } catch (error) {\n        this.setState('error');\n        const err = error instanceof Error ? error : new Error('Unknown error');\n        this.emitError(err);\n        reject(err);\n      }\n    });\n  }\n\n  public disconnect(): void {\n    this.log('Disconnecting');\n    this.autoReconnect = false; // Disable auto-reconnect on manual disconnect\n    \n    if (this.reconnectTimeout) {\n      clearTimeout(this.reconnectTimeout);\n      this.reconnectTimeout = null;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    this.setState('disconnected');\n  }\n\n  public async send(message: OutboundMessage): Promise<void> {\n    if (this._state !== 'connected' || !this.ws) {\n      // Queue message if not connected\n      this.log('Not connected, queueing message');\n      this.messageQueue.push(message);\n      return;\n    }\n\n    try {\n      const payload = JSON.stringify(message);\n      this.ws.send(payload);\n      this.log('Sent message:', message);\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error('Send failed');\n      this.log('Send error:', err);\n      this.emitError(err);\n      throw err;\n    }\n  }\n\n  public onMessage(handler: (message: InboundMessage) => void): () => void {\n    this.messageHandlers.add(handler);\n    return () => this.messageHandlers.delete(handler);\n  }\n\n  public onStateChange(handler: (state: TransportState) => void): () => void {\n    this.stateHandlers.add(handler);\n    return () => this.stateHandlers.delete(handler);\n  }\n\n  public onError(handler: (error: Error) => void): () => void {\n    this.errorHandlers.add(handler);\n    return () => this.errorHandlers.delete(handler);\n  }\n\n  /**\n   * Handle incoming WebSocket message\n   */\n  private handleMessage(data: string): void {\n    try {\n      const message: InboundMessage = JSON.parse(data);\n      this.log('Received message:', message);\n      \n      this.messageHandlers.forEach((handler) => {\n        try {\n          handler(message);\n        } catch (error) {\n          this.log('Handler error:', error);\n        }\n      });\n    } catch (error) {\n      this.log('Failed to parse message:', error);\n      this.emitError(new Error('Invalid message format'));\n    }\n  }\n\n  /**\n   * Handle WebSocket disconnect\n   */\n  private handleDisconnect(): void {\n    this.log('Disconnected');\n    this.ws = null;\n\n    if (this.autoReconnect && \n        (this.maxReconnectAttempts === 0 || this.reconnectAttempts < this.maxReconnectAttempts)) {\n      this.setState('reconnecting');\n      this.scheduleReconnect();\n    } else {\n      this.setState('disconnected');\n    }\n  }\n\n  /**\n   * Schedule reconnection attempt with exponential backoff\n   */\n  private scheduleReconnect(): void {\n    const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts);\n    this.log(`Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts + 1})`);\n\n    this.reconnectTimeout = setTimeout(() => {\n      this.reconnectAttempts++;\n      this.connect().catch((error) => {\n        this.log('Reconnect failed:', error);\n        this.handleDisconnect();\n      });\n    }, delay);\n  }\n\n  /**\n   * Flush queued messages\n   */\n  private flushMessageQueue(): void {\n    if (this.messageQueue.length === 0) {\n      return;\n    }\n\n    this.log(`Flushing ${this.messageQueue.length} queued messages`);\n    const queue = [...this.messageQueue];\n    this.messageQueue = [];\n\n    queue.forEach((message) => {\n      this.send(message).catch((error) => {\n        this.log('Failed to flush message:', error);\n      });\n    });\n  }\n\n  /**\n   * Set connection state\n   */\n  private setState(state: TransportState): void {\n    if (this._state === state) {\n      return;\n    }\n\n    this._state = state;\n    this.stateHandlers.forEach((handler) => {\n      try {\n        handler(state);\n      } catch (error) {\n        this.log('State handler error:', error);\n      }\n    });\n  }\n\n  /**\n   * Emit error to handlers\n   */\n  private emitError(error: Error): void {\n    this.errorHandlers.forEach((handler) => {\n      try {\n        handler(error);\n      } catch (err) {\n        this.log('Error handler error:', err);\n      }\n    });\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(message: string, data?: unknown): void {\n    if (this.debug && typeof console !== 'undefined') {\n      console.log(`[WebSocketTransport] ${message}`, data || '');\n    }\n  }\n}\n","import type {\n  TalonTransport,\n  OutboundMessage,\n  InboundMessage,\n  TransportState,\n} from '../types';\n\n/**\n * Webhook transport options\n */\nexport interface WebhookTransportOptions {\n  /** Webhook URL */\n  url: string;\n  \n  /** HTTP method */\n  method?: 'POST' | 'PUT';\n  \n  /** Custom headers */\n  headers?: Record<string, string>;\n  \n  /** Request timeout in ms */\n  timeout?: number;\n  \n  /** Retry failed requests */\n  retry?: boolean;\n  \n  /** Max retry attempts */\n  maxRetries?: number;\n  \n  /** Retry delay in ms */\n  retryDelay?: number;\n  \n  /** Debug mode */\n  debug?: boolean;\n}\n\n/**\n * Webhook transport for fire-and-forget HTTP requests\n * \n * Features:\n * - One-way communication (no responses)\n * - HTTP POST/PUT requests\n * - Optional retry logic\n * - Custom headers support\n * \n * Use this for:\n * - Server-side event delivery\n * - Fire-and-forget scenarios\n * - When WebSocket not available/needed\n * \n * @example\n * ```typescript\n * const transport = new WebhookTransport({\n *   url: 'https://edge.sygnl.io/webhook',\n *   method: 'POST',\n *   retry: true\n * });\n * ```\n */\nexport class WebhookTransport implements TalonTransport {\n  private url: string;\n  private method: 'POST' | 'PUT';\n  private headers: Record<string, string>;\n  private timeout: number;\n  private retry: boolean;\n  private maxRetries: number;\n  private retryDelay: number;\n  private debug: boolean;\n  private _state: TransportState = 'disconnected';\n  \n  private messageHandlers = new Set<(message: InboundMessage) => void>();\n  private stateHandlers = new Set<(state: TransportState) => void>();\n  private errorHandlers = new Set<(error: Error) => void>();\n\n  constructor(options: WebhookTransportOptions) {\n    this.url = options.url;\n    this.method = options.method ?? 'POST';\n    this.headers = {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    };\n    this.timeout = options.timeout ?? 10000;\n    this.retry = options.retry ?? false;\n    this.maxRetries = options.maxRetries ?? 3;\n    this.retryDelay = options.retryDelay ?? 1000;\n    this.debug = options.debug ?? false;\n  }\n\n  public get state(): TransportState {\n    return this._state;\n  }\n\n  public async connect(): Promise<void> {\n    // Webhook is \"connected\" immediately (stateless)\n    this.log('Webhook transport ready');\n    this.setState('connected');\n  }\n\n  public disconnect(): void {\n    this.log('Disconnecting webhook transport');\n    this.setState('disconnected');\n  }\n\n  public async send(message: OutboundMessage): Promise<void> {\n    if (this._state !== 'connected') {\n      throw new Error('Transport not connected');\n    }\n\n    let lastError: Error | null = null;\n    const attempts = this.retry ? this.maxRetries + 1 : 1;\n\n    for (let attempt = 0; attempt < attempts; attempt++) {\n      try {\n        await this.sendRequest(message);\n        this.log(`Sent message (attempt ${attempt + 1})`);\n        return;\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error('Send failed');\n        this.log(`Send failed (attempt ${attempt + 1}):`, lastError);\n\n        if (attempt < attempts - 1) {\n          // Wait before retry (exponential backoff)\n          const delay = this.retryDelay * Math.pow(2, attempt);\n          await new Promise((resolve) => setTimeout(resolve, delay));\n        }\n      }\n    }\n\n    // All attempts failed\n    if (lastError) {\n      this.emitError(lastError);\n      throw lastError;\n    }\n  }\n\n  public onMessage(handler: (message: InboundMessage) => void): () => void {\n    // Webhook is one-way, but keep interface consistent\n    this.messageHandlers.add(handler);\n    return () => this.messageHandlers.delete(handler);\n  }\n\n  public onStateChange(handler: (state: TransportState) => void): () => void {\n    this.stateHandlers.add(handler);\n    return () => this.stateHandlers.delete(handler);\n  }\n\n  public onError(handler: (error: Error) => void): () => void {\n    this.errorHandlers.add(handler);\n    return () => this.errorHandlers.delete(handler);\n  }\n\n  /**\n   * Send HTTP request\n   */\n  private async sendRequest(message: OutboundMessage): Promise<void> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(this.url, {\n        method: this.method,\n        headers: this.headers,\n        body: JSON.stringify(message),\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      this.log(`Request successful: ${response.status}`);\n    } catch (error) {\n      clearTimeout(timeoutId);\n      \n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          throw new Error('Request timeout');\n        }\n        throw error;\n      }\n      \n      throw new Error('Request failed');\n    }\n  }\n\n  /**\n   * Set connection state\n   */\n  private setState(state: TransportState): void {\n    if (this._state === state) {\n      return;\n    }\n\n    this._state = state;\n    this.stateHandlers.forEach((handler) => {\n      try {\n        handler(state);\n      } catch (error) {\n        this.log('State handler error:', error);\n      }\n    });\n  }\n\n  /**\n   * Emit error to handlers\n   */\n  private emitError(error: Error): void {\n    this.errorHandlers.forEach((handler) => {\n      try {\n        handler(error);\n      } catch (err) {\n        this.log('Error handler error:', err);\n      }\n    });\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(message: string, data?: unknown): void {\n    if (this.debug && typeof console !== 'undefined') {\n      console.log(`[WebhookTransport] ${message}`, data || '');\n    }\n  }\n}\n"]}