pushstream-client 0.1.0

package/dist/pushstream.js

@@ -0,0 +1,540 @@
+/*!
+ * PushStream JavaScript Client v0.1.0
+ * A lightweight, zero-dependency SSE client library
+ * (c) 2026
+ * Released under the MIT License
+ */
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+  typeof define === 'function' && define.amd ? define(['exports'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.PushStream = {}));
+})(this, (function (exports) { 'use strict';
+
+  /**
+   * Connection states for EventClient
+   * @readonly
+   * @enum {string}
+   */
+  const ConnectionState = Object.freeze({
+    /** Client is not connected */
+    DISCONNECTED: 'disconnected',
+    /** Client is attempting to connect */
+    CONNECTING: 'connecting',
+    /** Client is connected and receiving events */
+    CONNECTED: 'connected'
+  });
+
+  /**
+   * Built-in event names emitted by EventClient
+   * @readonly
+   * @enum {string}
+   */
+  const BuiltInEvents = Object.freeze({
+    /** Emitted when connection is established */
+    OPEN: 'stream.open',
+    /** Emitted when connection is closed */
+    CLOSE: 'stream.close',
+    /** Emitted when an error occurs */
+    ERROR: 'stream.error',
+    /** Emitted when connection state changes */
+    STATE_CHANGE: 'stream.statechange'
+  });
+
+  /**
+   * Default options for EventClient
+   * @readonly
+   */
+  const DefaultOptions = Object.freeze({
+    /** Whether to automatically reconnect on connection loss */
+    reconnect: true,
+    /** Base delay in milliseconds between reconnection attempts */
+    reconnectInterval: 1000,
+    /** Maximum number of reconnection attempts before giving up */
+    maxReconnectAttempts: 10,
+    /** Maximum delay cap for exponential backoff (30 seconds) */
+    maxReconnectDelay: 30000,
+    /** Whether to include credentials in cross-origin requests */
+    withCredentials: false
+  });
+
+  /**
+   * Manages event subscriptions with O(1) add/remove operations.
+   * Uses Map for event->callbacks storage and Set for callback deduplication.
+   */
+  class SubscriptionManager {
+    constructor() {
+      /** @type {Map<string, Set<Function>>} */
+      this._listeners = new Map();
+    }
+
+    /**
+     * Register a callback for a specific event.
+     * @param {string} event - The event name to subscribe to
+     * @param {Function} callback - The callback to invoke when the event occurs
+     * @returns {boolean} True if the callback was added, false if already exists
+     */
+    add(event, callback) {
+      if (typeof callback !== 'function') {
+        throw new TypeError('Callback must be a function');
+      }
+
+      if (!this._listeners.has(event)) {
+        this._listeners.set(event, new Set());
+      }
+
+      const callbacks = this._listeners.get(event);
+      const existed = callbacks.has(callback);
+      callbacks.add(callback);
+      
+      return !existed;
+    }
+
+    /**
+     * Remove a specific callback for an event.
+     * @param {string} event - The event name
+     * @param {Function} callback - The callback to remove
+     * @returns {boolean} True if the callback was removed
+     */
+    remove(event, callback) {
+      const callbacks = this._listeners.get(event);
+      if (!callbacks) {
+        return false;
+      }
+
+      const removed = callbacks.delete(callback);
+      
+      // Clean up empty sets
+      if (callbacks.size === 0) {
+        this._listeners.delete(event);
+      }
+
+      return removed;
+    }
+
+    /**
+     * Remove all callbacks for a specific event.
+     * @param {string} event - The event name
+     * @returns {boolean} True if any callbacks were removed
+     */
+    removeAll(event) {
+      return this._listeners.delete(event);
+    }
+
+    /**
+     * Emit an event to all registered callbacks.
+     * Creates a snapshot of callbacks to allow safe modification during iteration.
+     * @param {string} event - The event name
+     * @param {*} data - The data to pass to callbacks
+     */
+    emit(event, data) {
+      const callbacks = this._listeners.get(event);
+      if (!callbacks || callbacks.size === 0) {
+        return;
+      }
+
+      // Create snapshot to allow modifications during iteration
+      const snapshot = Array.from(callbacks);
+      
+      for (const callback of snapshot) {
+        try {
+          callback(data);
+        } catch (error) {
+          // Log but don't throw to prevent one bad callback from breaking others
+          console.error(`Error in event callback for "${event}":`, error);
+        }
+      }
+    }
+
+    /**
+     * Check if an event has any subscribers.
+     * @param {string} event - The event name
+     * @returns {boolean} True if the event has subscribers
+     */
+    has(event) {
+      const callbacks = this._listeners.get(event);
+      return callbacks !== undefined && callbacks.size > 0;
+    }
+
+    /**
+     * Get all registered event names.
+     * @returns {string[]} Array of event names
+     */
+    getEvents() {
+      return Array.from(this._listeners.keys());
+    }
+
+    /**
+     * Get the number of callbacks for a specific event.
+     * @param {string} event - The event name
+     * @returns {number} Number of callbacks
+     */
+    getCount(event) {
+      const callbacks = this._listeners.get(event);
+      return callbacks ? callbacks.size : 0;
+    }
+
+    /**
+     * Clear all subscriptions.
+     */
+    clear() {
+      this._listeners.clear();
+    }
+  }
+
+  /**
+   * EventClient provides a clean abstraction over EventSource for consuming SSE events.
+   * 
+   * Features:
+   * - Automatic reconnection with exponential backoff and jitter
+   * - Event subscription management
+   * - Automatic JSON payload parsing
+   * - Connection state tracking
+   * - Built-in lifecycle events
+   * 
+   * @example
+   * const client = new EventClient('/events');
+   * client.on('task.progress', (data) => console.log(data.percentage));
+   * client.connect();
+   */
+  class EventClient {
+    /**
+     * Create a new EventClient instance.
+     * @param {string} url - The SSE endpoint URL (relative or absolute)
+     * @param {Object} [options] - Configuration options
+     * @param {boolean} [options.reconnect=true] - Enable automatic reconnection
+     * @param {number} [options.reconnectInterval=1000] - Base reconnection delay in ms
+     * @param {number} [options.maxReconnectAttempts=10] - Maximum reconnection attempts
+     * @param {number} [options.maxReconnectDelay=30000] - Maximum delay cap in ms
+     * @param {boolean} [options.withCredentials=false] - Include credentials in CORS requests
+     */
+    constructor(url, options = {}) {
+      if (!url || typeof url !== 'string') {
+        throw new TypeError('URL must be a non-empty string');
+      }
+
+      this._url = url;
+      this._options = { ...DefaultOptions, ...options };
+      this._eventSource = null;
+      this._subscriptions = new SubscriptionManager();
+      this._state = ConnectionState.DISCONNECTED;
+      this._reconnectAttempts = 0;
+      this._reconnectTimer = null;
+      this._manualDisconnect = false;
+      this._registeredEventTypes = new Set();
+    }
+
+    /**
+     * Get the current connection state.
+     * @returns {string} One of: 'disconnected', 'connecting', 'connected'
+     */
+    get state() {
+      return this._state;
+    }
+
+    /**
+     * Get the endpoint URL.
+     * @returns {string} The SSE endpoint URL
+     */
+    get url() {
+      return this._url;
+    }
+
+    /**
+     * Establish an SSE connection to the server.
+     * This method is idempotent - calling it while already connected has no effect.
+     */
+    connect() {
+      // Idempotent: don't reconnect if already connecting or connected
+      if (this._state !== ConnectionState.DISCONNECTED) {
+        return;
+      }
+
+      this._manualDisconnect = false;
+      this._setState(ConnectionState.CONNECTING);
+
+      try {
+        this._eventSource = new EventSource(this._url, {
+          withCredentials: this._options.withCredentials
+        });
+
+        this._eventSource.onopen = () => this._handleOpen();
+        this._eventSource.onerror = (event) => this._handleError(event);
+
+        // Register event listeners for all currently subscribed event types
+        this._registerEventListeners();
+      } catch (error) {
+        this._handleConnectionError(error);
+      }
+    }
+
+    /**
+     * Close the SSE connection.
+     * This method is idempotent - calling it while already disconnected has no effect.
+     * After calling disconnect(), no automatic reconnection will be attempted.
+     */
+    disconnect() {
+      this._manualDisconnect = true;
+      this._cleanup();
+      
+      if (this._state !== ConnectionState.DISCONNECTED) {
+        this._setState(ConnectionState.DISCONNECTED);
+        this._emit(BuiltInEvents.CLOSE, { manual: true });
+      }
+    }
+
+    /**
+     * Subscribe to an event.
+     * Subscriptions can be registered before or after connecting.
+     * @param {string} event - The event name to subscribe to
+     * @param {Function} callback - The callback to invoke when the event occurs
+     * @returns {EventClient} This instance for chaining
+     */
+    on(event, callback) {
+      if (typeof event !== 'string' || !event) {
+        throw new TypeError('Event name must be a non-empty string');
+      }
+      if (typeof callback !== 'function') {
+        throw new TypeError('Callback must be a function');
+      }
+
+      this._subscriptions.add(event, callback);
+
+      // If already connected and this is a new event type, register it
+      if (this._eventSource && !this._isBuiltInEvent(event) && !this._registeredEventTypes.has(event)) {
+        this._registerSingleEventListener(event);
+      }
+
+      return this;
+    }
+
+    /**
+     * Unsubscribe from an event.
+     * @param {string} event - The event name
+     * @param {Function} [callback] - Specific callback to remove. If omitted, removes all callbacks for the event.
+     * @returns {EventClient} This instance for chaining
+     */
+    off(event, callback) {
+      if (typeof event !== 'string' || !event) {
+        throw new TypeError('Event name must be a non-empty string');
+      }
+
+      if (callback !== undefined) {
+        this._subscriptions.remove(event, callback);
+      } else {
+        this._subscriptions.removeAll(event);
+      }
+
+      return this;
+    }
+
+    // =====================
+    // Private Methods
+    // =====================
+
+    /**
+     * Update connection state and emit state change event.
+     * @private
+     */
+    _setState(newState) {
+      const oldState = this._state;
+      if (oldState === newState) {
+        return;
+      }
+
+      this._state = newState;
+      this._emit(BuiltInEvents.STATE_CHANGE, {
+        previousState: oldState,
+        currentState: newState
+      });
+    }
+
+    /**
+     * Emit an event to all subscribers.
+     * @private
+     */
+    _emit(event, data) {
+      this._subscriptions.emit(event, data);
+    }
+
+    /**
+     * Handle successful connection.
+     * @private
+     */
+    _handleOpen() {
+      this._reconnectAttempts = 0; // Reset on successful connection
+      this._setState(ConnectionState.CONNECTED);
+      this._emit(BuiltInEvents.OPEN, { url: this._url });
+    }
+
+    /**
+     * Handle connection error.
+     * @private
+     */
+    _handleError(event) {
+      // EventSource error event doesn't provide much detail
+      const errorInfo = {
+        message: 'Connection error',
+        readyState: this._eventSource?.readyState
+      };
+
+      this._emit(BuiltInEvents.ERROR, errorInfo);
+
+      // Check if connection was lost
+      if (this._eventSource?.readyState === EventSource.CLOSED) {
+        this._handleConnectionLoss();
+      }
+    }
+
+    /**
+     * Handle initial connection failure.
+     * @private
+     */
+    _handleConnectionError(error) {
+      this._setState(ConnectionState.DISCONNECTED);
+      this._emit(BuiltInEvents.ERROR, {
+        message: error.message || 'Failed to create connection',
+        error
+      });
+    }
+
+    /**
+     * Handle connection loss and schedule reconnection.
+     * @private
+     */
+    _handleConnectionLoss() {
+      this._cleanup();
+      this._setState(ConnectionState.DISCONNECTED);
+      this._emit(BuiltInEvents.CLOSE, { manual: false });
+
+      // Schedule reconnection if enabled and not manually disconnected
+      if (this._options.reconnect && !this._manualDisconnect) {
+        this._scheduleReconnect();
+      }
+    }
+
+    /**
+     * Schedule a reconnection attempt with exponential backoff and jitter.
+     * @private
+     */
+    _scheduleReconnect() {
+      if (this._manualDisconnect) {
+        return;
+      }
+
+      if (this._reconnectAttempts >= this._options.maxReconnectAttempts) {
+        this._emit(BuiltInEvents.ERROR, {
+          message: 'Max reconnection attempts reached',
+          attempts: this._reconnectAttempts
+        });
+        return;
+      }
+
+      // Exponential backoff: interval * 2^attempts
+      const exponentialDelay = this._options.reconnectInterval * Math.pow(2, this._reconnectAttempts);
+      
+      // Cap at max delay
+      const cappedDelay = Math.min(exponentialDelay, this._options.maxReconnectDelay);
+      
+      // Add jitter (0-1000ms random) to prevent thundering herd
+      const jitter = Math.random() * 1000;
+      const finalDelay = cappedDelay + jitter;
+
+      this._reconnectTimer = setTimeout(() => {
+        this._reconnectAttempts++;
+        this.connect();
+      }, finalDelay);
+    }
+
+    /**
+     * Register EventSource listeners for all subscribed event types.
+     * @private
+     */
+    _registerEventListeners() {
+      const events = this._subscriptions.getEvents();
+      
+      for (const event of events) {
+        if (!this._isBuiltInEvent(event)) {
+          this._registerSingleEventListener(event);
+        }
+      }
+    }
+
+    /**
+     * Register a single event listener on the EventSource.
+     * @private
+     */
+    _registerSingleEventListener(event) {
+      if (!this._eventSource || this._registeredEventTypes.has(event)) {
+        return;
+      }
+
+      this._registeredEventTypes.add(event);
+      
+      this._eventSource.addEventListener(event, (sseEvent) => {
+        this._handleMessage(event, sseEvent);
+      });
+    }
+
+    /**
+     * Handle incoming SSE message.
+     * @private
+     */
+    _handleMessage(eventType, sseEvent) {
+      let data;
+      
+      try {
+        // Attempt JSON parsing
+        data = JSON.parse(sseEvent.data);
+      } catch (parseError) {
+        // JSON parsing failed - emit error but don't disconnect
+        this._emit(BuiltInEvents.ERROR, {
+          message: 'Failed to parse JSON payload',
+          eventType,
+          originalData: sseEvent.data,
+          error: parseError.message
+        });
+        return;
+      }
+
+      // Emit the parsed event to subscribers
+      this._emit(eventType, data);
+    }
+
+    /**
+     * Check if an event name is a built-in event.
+     * @private
+     */
+    _isBuiltInEvent(event) {
+      return event.startsWith('stream.');
+    }
+
+    /**
+     * Clean up resources.
+     * @private
+     */
+    _cleanup() {
+      // Clear reconnection timer
+      if (this._reconnectTimer) {
+        clearTimeout(this._reconnectTimer);
+        this._reconnectTimer = null;
+      }
+
+      // Close EventSource
+      if (this._eventSource) {
+        this._eventSource.close();
+        this._eventSource = null;
+      }
+
+      // Clear registered event types (will be re-registered on reconnect)
+      this._registeredEventTypes.clear();
+    }
+  }
+
+  exports.BuiltInEvents = BuiltInEvents;
+  exports.ConnectionState = ConnectionState;
+  exports.DefaultOptions = DefaultOptions;
+  exports.EventClient = EventClient;
+  exports.SubscriptionManager = SubscriptionManager;
+
+}));
+//# sourceMappingURL=pushstream.js.map

package/dist/pushstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushstream.js","sources":["../src/constants.js","../src/SubscriptionManager.js","../src/EventClient.js"],"sourcesContent":["/**\r\n * Connection states for EventClient\r\n * @readonly\r\n * @enum {string}\r\n */\r\nexport const ConnectionState = Object.freeze({\r\n  /** Client is not connected */\r\n  DISCONNECTED: 'disconnected',\r\n  /** Client is attempting to connect */\r\n  CONNECTING: 'connecting',\r\n  /** Client is connected and receiving events */\r\n  CONNECTED: 'connected'\r\n});\r\n\r\n/**\r\n * Built-in event names emitted by EventClient\r\n * @readonly\r\n * @enum {string}\r\n */\r\nexport const BuiltInEvents = Object.freeze({\r\n  /** Emitted when connection is established */\r\n  OPEN: 'stream.open',\r\n  /** Emitted when connection is closed */\r\n  CLOSE: 'stream.close',\r\n  /** Emitted when an error occurs */\r\n  ERROR: 'stream.error',\r\n  /** Emitted when connection state changes */\r\n  STATE_CHANGE: 'stream.statechange'\r\n});\r\n\r\n/**\r\n * Default options for EventClient\r\n * @readonly\r\n */\r\nexport const DefaultOptions = Object.freeze({\r\n  /** Whether to automatically reconnect on connection loss */\r\n  reconnect: true,\r\n  /** Base delay in milliseconds between reconnection attempts */\r\n  reconnectInterval: 1000,\r\n  /** Maximum number of reconnection attempts before giving up */\r\n  maxReconnectAttempts: 10,\r\n  /** Maximum delay cap for exponential backoff (30 seconds) */\r\n  maxReconnectDelay: 30000,\r\n  /** Whether to include credentials in cross-origin requests */\r\n  withCredentials: false\r\n});\r\n\r\n","/**\r\n * Manages event subscriptions with O(1) add/remove operations.\r\n * Uses Map for event->callbacks storage and Set for callback deduplication.\r\n */\r\nexport class SubscriptionManager {\r\n  constructor() {\r\n    /** @type {Map<string, Set<Function>>} */\r\n    this._listeners = new Map();\r\n  }\r\n\r\n  /**\r\n   * Register a callback for a specific event.\r\n   * @param {string} event - The event name to subscribe to\r\n   * @param {Function} callback - The callback to invoke when the event occurs\r\n   * @returns {boolean} True if the callback was added, false if already exists\r\n   */\r\n  add(event, callback) {\r\n    if (typeof callback !== 'function') {\r\n      throw new TypeError('Callback must be a function');\r\n    }\r\n\r\n    if (!this._listeners.has(event)) {\r\n      this._listeners.set(event, new Set());\r\n    }\r\n\r\n    const callbacks = this._listeners.get(event);\r\n    const existed = callbacks.has(callback);\r\n    callbacks.add(callback);\r\n    \r\n    return !existed;\r\n  }\r\n\r\n  /**\r\n   * Remove a specific callback for an event.\r\n   * @param {string} event - The event name\r\n   * @param {Function} callback - The callback to remove\r\n   * @returns {boolean} True if the callback was removed\r\n   */\r\n  remove(event, callback) {\r\n    const callbacks = this._listeners.get(event);\r\n    if (!callbacks) {\r\n      return false;\r\n    }\r\n\r\n    const removed = callbacks.delete(callback);\r\n    \r\n    // Clean up empty sets\r\n    if (callbacks.size === 0) {\r\n      this._listeners.delete(event);\r\n    }\r\n\r\n    return removed;\r\n  }\r\n\r\n  /**\r\n   * Remove all callbacks for a specific event.\r\n   * @param {string} event - The event name\r\n   * @returns {boolean} True if any callbacks were removed\r\n   */\r\n  removeAll(event) {\r\n    return this._listeners.delete(event);\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered callbacks.\r\n   * Creates a snapshot of callbacks to allow safe modification during iteration.\r\n   * @param {string} event - The event name\r\n   * @param {*} data - The data to pass to callbacks\r\n   */\r\n  emit(event, data) {\r\n    const callbacks = this._listeners.get(event);\r\n    if (!callbacks || callbacks.size === 0) {\r\n      return;\r\n    }\r\n\r\n    // Create snapshot to allow modifications during iteration\r\n    const snapshot = Array.from(callbacks);\r\n    \r\n    for (const callback of snapshot) {\r\n      try {\r\n        callback(data);\r\n      } catch (error) {\r\n        // Log but don't throw to prevent one bad callback from breaking others\r\n        console.error(`Error in event callback for \"${event}\":`, error);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Check if an event has any subscribers.\r\n   * @param {string} event - The event name\r\n   * @returns {boolean} True if the event has subscribers\r\n   */\r\n  has(event) {\r\n    const callbacks = this._listeners.get(event);\r\n    return callbacks !== undefined && callbacks.size > 0;\r\n  }\r\n\r\n  /**\r\n   * Get all registered event names.\r\n   * @returns {string[]} Array of event names\r\n   */\r\n  getEvents() {\r\n    return Array.from(this._listeners.keys());\r\n  }\r\n\r\n  /**\r\n   * Get the number of callbacks for a specific event.\r\n   * @param {string} event - The event name\r\n   * @returns {number} Number of callbacks\r\n   */\r\n  getCount(event) {\r\n    const callbacks = this._listeners.get(event);\r\n    return callbacks ? callbacks.size : 0;\r\n  }\r\n\r\n  /**\r\n   * Clear all subscriptions.\r\n   */\r\n  clear() {\r\n    this._listeners.clear();\r\n  }\r\n}\r\n\r\n","import { ConnectionState, BuiltInEvents, DefaultOptions } from './constants.js';\r\nimport { SubscriptionManager } from './SubscriptionManager.js';\r\n\r\n/**\r\n * EventClient provides a clean abstraction over EventSource for consuming SSE events.\r\n * \r\n * Features:\r\n * - Automatic reconnection with exponential backoff and jitter\r\n * - Event subscription management\r\n * - Automatic JSON payload parsing\r\n * - Connection state tracking\r\n * - Built-in lifecycle events\r\n * \r\n * @example\r\n * const client = new EventClient('/events');\r\n * client.on('task.progress', (data) => console.log(data.percentage));\r\n * client.connect();\r\n */\r\nexport class EventClient {\r\n  /**\r\n   * Create a new EventClient instance.\r\n   * @param {string} url - The SSE endpoint URL (relative or absolute)\r\n   * @param {Object} [options] - Configuration options\r\n   * @param {boolean} [options.reconnect=true] - Enable automatic reconnection\r\n   * @param {number} [options.reconnectInterval=1000] - Base reconnection delay in ms\r\n   * @param {number} [options.maxReconnectAttempts=10] - Maximum reconnection attempts\r\n   * @param {number} [options.maxReconnectDelay=30000] - Maximum delay cap in ms\r\n   * @param {boolean} [options.withCredentials=false] - Include credentials in CORS requests\r\n   */\r\n  constructor(url, options = {}) {\r\n    if (!url || typeof url !== 'string') {\r\n      throw new TypeError('URL must be a non-empty string');\r\n    }\r\n\r\n    this._url = url;\r\n    this._options = { ...DefaultOptions, ...options };\r\n    this._eventSource = null;\r\n    this._subscriptions = new SubscriptionManager();\r\n    this._state = ConnectionState.DISCONNECTED;\r\n    this._reconnectAttempts = 0;\r\n    this._reconnectTimer = null;\r\n    this._manualDisconnect = false;\r\n    this._registeredEventTypes = new Set();\r\n  }\r\n\r\n  /**\r\n   * Get the current connection state.\r\n   * @returns {string} One of: 'disconnected', 'connecting', 'connected'\r\n   */\r\n  get state() {\r\n    return this._state;\r\n  }\r\n\r\n  /**\r\n   * Get the endpoint URL.\r\n   * @returns {string} The SSE endpoint URL\r\n   */\r\n  get url() {\r\n    return this._url;\r\n  }\r\n\r\n  /**\r\n   * Establish an SSE connection to the server.\r\n   * This method is idempotent - calling it while already connected has no effect.\r\n   */\r\n  connect() {\r\n    // Idempotent: don't reconnect if already connecting or connected\r\n    if (this._state !== ConnectionState.DISCONNECTED) {\r\n      return;\r\n    }\r\n\r\n    this._manualDisconnect = false;\r\n    this._setState(ConnectionState.CONNECTING);\r\n\r\n    try {\r\n      this._eventSource = new EventSource(this._url, {\r\n        withCredentials: this._options.withCredentials\r\n      });\r\n\r\n      this._eventSource.onopen = () => this._handleOpen();\r\n      this._eventSource.onerror = (event) => this._handleError(event);\r\n\r\n      // Register event listeners for all currently subscribed event types\r\n      this._registerEventListeners();\r\n    } catch (error) {\r\n      this._handleConnectionError(error);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Close the SSE connection.\r\n   * This method is idempotent - calling it while already disconnected has no effect.\r\n   * After calling disconnect(), no automatic reconnection will be attempted.\r\n   */\r\n  disconnect() {\r\n    this._manualDisconnect = true;\r\n    this._cleanup();\r\n    \r\n    if (this._state !== ConnectionState.DISCONNECTED) {\r\n      this._setState(ConnectionState.DISCONNECTED);\r\n      this._emit(BuiltInEvents.CLOSE, { manual: true });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Subscribe to an event.\r\n   * Subscriptions can be registered before or after connecting.\r\n   * @param {string} event - The event name to subscribe to\r\n   * @param {Function} callback - The callback to invoke when the event occurs\r\n   * @returns {EventClient} This instance for chaining\r\n   */\r\n  on(event, callback) {\r\n    if (typeof event !== 'string' || !event) {\r\n      throw new TypeError('Event name must be a non-empty string');\r\n    }\r\n    if (typeof callback !== 'function') {\r\n      throw new TypeError('Callback must be a function');\r\n    }\r\n\r\n    this._subscriptions.add(event, callback);\r\n\r\n    // If already connected and this is a new event type, register it\r\n    if (this._eventSource && !this._isBuiltInEvent(event) && !this._registeredEventTypes.has(event)) {\r\n      this._registerSingleEventListener(event);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from an event.\r\n   * @param {string} event - The event name\r\n   * @param {Function} [callback] - Specific callback to remove. If omitted, removes all callbacks for the event.\r\n   * @returns {EventClient} This instance for chaining\r\n   */\r\n  off(event, callback) {\r\n    if (typeof event !== 'string' || !event) {\r\n      throw new TypeError('Event name must be a non-empty string');\r\n    }\r\n\r\n    if (callback !== undefined) {\r\n      this._subscriptions.remove(event, callback);\r\n    } else {\r\n      this._subscriptions.removeAll(event);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  // =====================\r\n  // Private Methods\r\n  // =====================\r\n\r\n  /**\r\n   * Update connection state and emit state change event.\r\n   * @private\r\n   */\r\n  _setState(newState) {\r\n    const oldState = this._state;\r\n    if (oldState === newState) {\r\n      return;\r\n    }\r\n\r\n    this._state = newState;\r\n    this._emit(BuiltInEvents.STATE_CHANGE, {\r\n      previousState: oldState,\r\n      currentState: newState\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all subscribers.\r\n   * @private\r\n   */\r\n  _emit(event, data) {\r\n    this._subscriptions.emit(event, data);\r\n  }\r\n\r\n  /**\r\n   * Handle successful connection.\r\n   * @private\r\n   */\r\n  _handleOpen() {\r\n    this._reconnectAttempts = 0; // Reset on successful connection\r\n    this._setState(ConnectionState.CONNECTED);\r\n    this._emit(BuiltInEvents.OPEN, { url: this._url });\r\n  }\r\n\r\n  /**\r\n   * Handle connection error.\r\n   * @private\r\n   */\r\n  _handleError(event) {\r\n    // EventSource error event doesn't provide much detail\r\n    const errorInfo = {\r\n      message: 'Connection error',\r\n      readyState: this._eventSource?.readyState\r\n    };\r\n\r\n    this._emit(BuiltInEvents.ERROR, errorInfo);\r\n\r\n    // Check if connection was lost\r\n    if (this._eventSource?.readyState === EventSource.CLOSED) {\r\n      this._handleConnectionLoss();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Handle initial connection failure.\r\n   * @private\r\n   */\r\n  _handleConnectionError(error) {\r\n    this._setState(ConnectionState.DISCONNECTED);\r\n    this._emit(BuiltInEvents.ERROR, {\r\n      message: error.message || 'Failed to create connection',\r\n      error\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Handle connection loss and schedule reconnection.\r\n   * @private\r\n   */\r\n  _handleConnectionLoss() {\r\n    this._cleanup();\r\n    this._setState(ConnectionState.DISCONNECTED);\r\n    this._emit(BuiltInEvents.CLOSE, { manual: false });\r\n\r\n    // Schedule reconnection if enabled and not manually disconnected\r\n    if (this._options.reconnect && !this._manualDisconnect) {\r\n      this._scheduleReconnect();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Schedule a reconnection attempt with exponential backoff and jitter.\r\n   * @private\r\n   */\r\n  _scheduleReconnect() {\r\n    if (this._manualDisconnect) {\r\n      return;\r\n    }\r\n\r\n    if (this._reconnectAttempts >= this._options.maxReconnectAttempts) {\r\n      this._emit(BuiltInEvents.ERROR, {\r\n        message: 'Max reconnection attempts reached',\r\n        attempts: this._reconnectAttempts\r\n      });\r\n      return;\r\n    }\r\n\r\n    // Exponential backoff: interval * 2^attempts\r\n    const exponentialDelay = this._options.reconnectInterval * Math.pow(2, this._reconnectAttempts);\r\n    \r\n    // Cap at max delay\r\n    const cappedDelay = Math.min(exponentialDelay, this._options.maxReconnectDelay);\r\n    \r\n    // Add jitter (0-1000ms random) to prevent thundering herd\r\n    const jitter = Math.random() * 1000;\r\n    const finalDelay = cappedDelay + jitter;\r\n\r\n    this._reconnectTimer = setTimeout(() => {\r\n      this._reconnectAttempts++;\r\n      this.connect();\r\n    }, finalDelay);\r\n  }\r\n\r\n  /**\r\n   * Register EventSource listeners for all subscribed event types.\r\n   * @private\r\n   */\r\n  _registerEventListeners() {\r\n    const events = this._subscriptions.getEvents();\r\n    \r\n    for (const event of events) {\r\n      if (!this._isBuiltInEvent(event)) {\r\n        this._registerSingleEventListener(event);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Register a single event listener on the EventSource.\r\n   * @private\r\n   */\r\n  _registerSingleEventListener(event) {\r\n    if (!this._eventSource || this._registeredEventTypes.has(event)) {\r\n      return;\r\n    }\r\n\r\n    this._registeredEventTypes.add(event);\r\n    \r\n    this._eventSource.addEventListener(event, (sseEvent) => {\r\n      this._handleMessage(event, sseEvent);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Handle incoming SSE message.\r\n   * @private\r\n   */\r\n  _handleMessage(eventType, sseEvent) {\r\n    let data;\r\n    \r\n    try {\r\n      // Attempt JSON parsing\r\n      data = JSON.parse(sseEvent.data);\r\n    } catch (parseError) {\r\n      // JSON parsing failed - emit error but don't disconnect\r\n      this._emit(BuiltInEvents.ERROR, {\r\n        message: 'Failed to parse JSON payload',\r\n        eventType,\r\n        originalData: sseEvent.data,\r\n        error: parseError.message\r\n      });\r\n      return;\r\n    }\r\n\r\n    // Emit the parsed event to subscribers\r\n    this._emit(eventType, data);\r\n  }\r\n\r\n  /**\r\n   * Check if an event name is a built-in event.\r\n   * @private\r\n   */\r\n  _isBuiltInEvent(event) {\r\n    return event.startsWith('stream.');\r\n  }\r\n\r\n  /**\r\n   * Clean up resources.\r\n   * @private\r\n   */\r\n  _cleanup() {\r\n    // Clear reconnection timer\r\n    if (this._reconnectTimer) {\r\n      clearTimeout(this._reconnectTimer);\r\n      this._reconnectTimer = null;\r\n    }\r\n\r\n    // Close EventSource\r\n    if (this._eventSource) {\r\n      this._eventSource.close();\r\n      this._eventSource = null;\r\n    }\r\n\r\n    // Clear registered event types (will be re-registered on reconnect)\r\n    this._registeredEventTypes.clear();\r\n  }\r\n}\r\n\r\n"],"names":[],"mappings":"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"}

package/dist/pushstream.min.js

@@ -0,0 +1,8 @@
+/*!
+ * PushStream JavaScript Client v0.1.0
+ * A lightweight, zero-dependency SSE client library
+ * (c) 2026
+ * Released under the MIT License
+ */
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).PushStream={})}(this,function(e){"use strict";const t=Object.freeze({DISCONNECTED:"disconnected",CONNECTING:"connecting",CONNECTED:"connected"}),s=Object.freeze({OPEN:"stream.open",CLOSE:"stream.close",ERROR:"stream.error",STATE_CHANGE:"stream.statechange"}),n=Object.freeze({reconnect:!0,reconnectInterval:1e3,maxReconnectAttempts:10,maxReconnectDelay:3e4,withCredentials:!1});class i{constructor(){this._listeners=new Map}add(e,t){if("function"!=typeof t)throw new TypeError("Callback must be a function");this._listeners.has(e)||this._listeners.set(e,new Set);const s=this._listeners.get(e),n=s.has(t);return s.add(t),!n}remove(e,t){const s=this._listeners.get(e);if(!s)return!1;const n=s.delete(t);return 0===s.size&&this._listeners.delete(e),n}removeAll(e){return this._listeners.delete(e)}emit(e,t){const s=this._listeners.get(e);if(!s||0===s.size)return;const n=Array.from(s);for(const s of n)try{s(t)}catch(t){console.error(`Error in event callback for "${e}":`,t)}}has(e){const t=this._listeners.get(e);return void 0!==t&&t.size>0}getEvents(){return Array.from(this._listeners.keys())}getCount(e){const t=this._listeners.get(e);return t?t.size:0}clear(){this._listeners.clear()}}e.BuiltInEvents=s,e.ConnectionState=t,e.DefaultOptions=n,e.EventClient=class{constructor(e,s={}){if(!e||"string"!=typeof e)throw new TypeError("URL must be a non-empty string");this._url=e,this._options={...n,...s},this._eventSource=null,this._subscriptions=new i,this._state=t.DISCONNECTED,this._reconnectAttempts=0,this._reconnectTimer=null,this._manualDisconnect=!1,this._registeredEventTypes=new Set}get state(){return this._state}get url(){return this._url}connect(){if(this._state===t.DISCONNECTED){this._manualDisconnect=!1,this._setState(t.CONNECTING);try{this._eventSource=new EventSource(this._url,{withCredentials:this._options.withCredentials}),this._eventSource.onopen=()=>this._handleOpen(),this._eventSource.onerror=e=>this._handleError(e),this._registerEventListeners()}catch(e){this._handleConnectionError(e)}}}disconnect(){this._manualDisconnect=!0,this._cleanup(),this._state!==t.DISCONNECTED&&(this._setState(t.DISCONNECTED),this._emit(s.CLOSE,{manual:!0}))}on(e,t){if("string"!=typeof e||!e)throw new TypeError("Event name must be a non-empty string");if("function"!=typeof t)throw new TypeError("Callback must be a function");return this._subscriptions.add(e,t),!this._eventSource||this._isBuiltInEvent(e)||this._registeredEventTypes.has(e)||this._registerSingleEventListener(e),this}off(e,t){if("string"!=typeof e||!e)throw new TypeError("Event name must be a non-empty string");return void 0!==t?this._subscriptions.remove(e,t):this._subscriptions.removeAll(e),this}_setState(e){const t=this._state;t!==e&&(this._state=e,this._emit(s.STATE_CHANGE,{previousState:t,currentState:e}))}_emit(e,t){this._subscriptions.emit(e,t)}_handleOpen(){this._reconnectAttempts=0,this._setState(t.CONNECTED),this._emit(s.OPEN,{url:this._url})}_handleError(e){const t={message:"Connection error",readyState:this._eventSource?.readyState};this._emit(s.ERROR,t),this._eventSource?.readyState===EventSource.CLOSED&&this._handleConnectionLoss()}_handleConnectionError(e){this._setState(t.DISCONNECTED),this._emit(s.ERROR,{message:e.message||"Failed to create connection",error:e})}_handleConnectionLoss(){this._cleanup(),this._setState(t.DISCONNECTED),this._emit(s.CLOSE,{manual:!1}),this._options.reconnect&&!this._manualDisconnect&&this._scheduleReconnect()}_scheduleReconnect(){if(this._manualDisconnect)return;if(this._reconnectAttempts>=this._options.maxReconnectAttempts)return void this._emit(s.ERROR,{message:"Max reconnection attempts reached",attempts:this._reconnectAttempts});const e=this._options.reconnectInterval*Math.pow(2,this._reconnectAttempts),t=Math.min(e,this._options.maxReconnectDelay)+1e3*Math.random();this._reconnectTimer=setTimeout(()=>{this._reconnectAttempts++,this.connect()},t)}_registerEventListeners(){const e=this._subscriptions.getEvents();for(const t of e)this._isBuiltInEvent(t)||this._registerSingleEventListener(t)}_registerSingleEventListener(e){this._eventSource&&!this._registeredEventTypes.has(e)&&(this._registeredEventTypes.add(e),this._eventSource.addEventListener(e,t=>{this._handleMessage(e,t)}))}_handleMessage(e,t){let n;try{n=JSON.parse(t.data)}catch(n){return void this._emit(s.ERROR,{message:"Failed to parse JSON payload",eventType:e,originalData:t.data,error:n.message})}this._emit(e,n)}_isBuiltInEvent(e){return e.startsWith("stream.")}_cleanup(){this._reconnectTimer&&(clearTimeout(this._reconnectTimer),this._reconnectTimer=null),this._eventSource&&(this._eventSource.close(),this._eventSource=null),this._registeredEventTypes.clear()}},e.SubscriptionManager=i});
+//# sourceMappingURL=pushstream.min.js.map

package/dist/pushstream.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushstream.min.js","sources":["../src/constants.js","../src/SubscriptionManager.js","../src/EventClient.js"],"sourcesContent":["/**\r\n * Connection states for EventClient\r\n * @readonly\r\n * @enum {string}\r\n */\r\nexport const ConnectionState = Object.freeze({\r\n  /** Client is not connected */\r\n  DISCONNECTED: 'disconnected',\r\n  /** Client is attempting to connect */\r\n  CONNECTING: 'connecting',\r\n  /** Client is connected and receiving events */\r\n  CONNECTED: 'connected'\r\n});\r\n\r\n/**\r\n * Built-in event names emitted by EventClient\r\n * @readonly\r\n * @enum {string}\r\n */\r\nexport const BuiltInEvents = Object.freeze({\r\n  /** Emitted when connection is established */\r\n  OPEN: 'stream.open',\r\n  /** Emitted when connection is closed */\r\n  CLOSE: 'stream.close',\r\n  /** Emitted when an error occurs */\r\n  ERROR: 'stream.error',\r\n  /** Emitted when connection state changes */\r\n  STATE_CHANGE: 'stream.statechange'\r\n});\r\n\r\n/**\r\n * Default options for EventClient\r\n * @readonly\r\n */\r\nexport const DefaultOptions = Object.freeze({\r\n  /** Whether to automatically reconnect on connection loss */\r\n  reconnect: true,\r\n  /** Base delay in milliseconds between reconnection attempts */\r\n  reconnectInterval: 1000,\r\n  /** Maximum number of reconnection attempts before giving up */\r\n  maxReconnectAttempts: 10,\r\n  /** Maximum delay cap for exponential backoff (30 seconds) */\r\n  maxReconnectDelay: 30000,\r\n  /** Whether to include credentials in cross-origin requests */\r\n  withCredentials: false\r\n});\r\n\r\n","/**\r\n * Manages event subscriptions with O(1) add/remove operations.\r\n * Uses Map for event->callbacks storage and Set for callback deduplication.\r\n */\r\nexport class SubscriptionManager {\r\n  constructor() {\r\n    /** @type {Map<string, Set<Function>>} */\r\n    this._listeners = new Map();\r\n  }\r\n\r\n  /**\r\n   * Register a callback for a specific event.\r\n   * @param {string} event - The event name to subscribe to\r\n   * @param {Function} callback - The callback to invoke when the event occurs\r\n   * @returns {boolean} True if the callback was added, false if already exists\r\n   */\r\n  add(event, callback) {\r\n    if (typeof callback !== 'function') {\r\n      throw new TypeError('Callback must be a function');\r\n    }\r\n\r\n    if (!this._listeners.has(event)) {\r\n      this._listeners.set(event, new Set());\r\n    }\r\n\r\n    const callbacks = this._listeners.get(event);\r\n    const existed = callbacks.has(callback);\r\n    callbacks.add(callback);\r\n    \r\n    return !existed;\r\n  }\r\n\r\n  /**\r\n   * Remove a specific callback for an event.\r\n   * @param {string} event - The event name\r\n   * @param {Function} callback - The callback to remove\r\n   * @returns {boolean} True if the callback was removed\r\n   */\r\n  remove(event, callback) {\r\n    const callbacks = this._listeners.get(event);\r\n    if (!callbacks) {\r\n      return false;\r\n    }\r\n\r\n    const removed = callbacks.delete(callback);\r\n    \r\n    // Clean up empty sets\r\n    if (callbacks.size === 0) {\r\n      this._listeners.delete(event);\r\n    }\r\n\r\n    return removed;\r\n  }\r\n\r\n  /**\r\n   * Remove all callbacks for a specific event.\r\n   * @param {string} event - The event name\r\n   * @returns {boolean} True if any callbacks were removed\r\n   */\r\n  removeAll(event) {\r\n    return this._listeners.delete(event);\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered callbacks.\r\n   * Creates a snapshot of callbacks to allow safe modification during iteration.\r\n   * @param {string} event - The event name\r\n   * @param {*} data - The data to pass to callbacks\r\n   */\r\n  emit(event, data) {\r\n    const callbacks = this._listeners.get(event);\r\n    if (!callbacks || callbacks.size === 0) {\r\n      return;\r\n    }\r\n\r\n    // Create snapshot to allow modifications during iteration\r\n    const snapshot = Array.from(callbacks);\r\n    \r\n    for (const callback of snapshot) {\r\n      try {\r\n        callback(data);\r\n      } catch (error) {\r\n        // Log but don't throw to prevent one bad callback from breaking others\r\n        console.error(`Error in event callback for \"${event}\":`, error);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Check if an event has any subscribers.\r\n   * @param {string} event - The event name\r\n   * @returns {boolean} True if the event has subscribers\r\n   */\r\n  has(event) {\r\n    const callbacks = this._listeners.get(event);\r\n    return callbacks !== undefined && callbacks.size > 0;\r\n  }\r\n\r\n  /**\r\n   * Get all registered event names.\r\n   * @returns {string[]} Array of event names\r\n   */\r\n  getEvents() {\r\n    return Array.from(this._listeners.keys());\r\n  }\r\n\r\n  /**\r\n   * Get the number of callbacks for a specific event.\r\n   * @param {string} event - The event name\r\n   * @returns {number} Number of callbacks\r\n   */\r\n  getCount(event) {\r\n    const callbacks = this._listeners.get(event);\r\n    return callbacks ? callbacks.size : 0;\r\n  }\r\n\r\n  /**\r\n   * Clear all subscriptions.\r\n   */\r\n  clear() {\r\n    this._listeners.clear();\r\n  }\r\n}\r\n\r\n","import { ConnectionState, BuiltInEvents, DefaultOptions } from './constants.js';\r\nimport { SubscriptionManager } from './SubscriptionManager.js';\r\n\r\n/**\r\n * EventClient provides a clean abstraction over EventSource for consuming SSE events.\r\n * \r\n * Features:\r\n * - Automatic reconnection with exponential backoff and jitter\r\n * - Event subscription management\r\n * - Automatic JSON payload parsing\r\n * - Connection state tracking\r\n * - Built-in lifecycle events\r\n * \r\n * @example\r\n * const client = new EventClient('/events');\r\n * client.on('task.progress', (data) => console.log(data.percentage));\r\n * client.connect();\r\n */\r\nexport class EventClient {\r\n  /**\r\n   * Create a new EventClient instance.\r\n   * @param {string} url - The SSE endpoint URL (relative or absolute)\r\n   * @param {Object} [options] - Configuration options\r\n   * @param {boolean} [options.reconnect=true] - Enable automatic reconnection\r\n   * @param {number} [options.reconnectInterval=1000] - Base reconnection delay in ms\r\n   * @param {number} [options.maxReconnectAttempts=10] - Maximum reconnection attempts\r\n   * @param {number} [options.maxReconnectDelay=30000] - Maximum delay cap in ms\r\n   * @param {boolean} [options.withCredentials=false] - Include credentials in CORS requests\r\n   */\r\n  constructor(url, options = {}) {\r\n    if (!url || typeof url !== 'string') {\r\n      throw new TypeError('URL must be a non-empty string');\r\n    }\r\n\r\n    this._url = url;\r\n    this._options = { ...DefaultOptions, ...options };\r\n    this._eventSource = null;\r\n    this._subscriptions = new SubscriptionManager();\r\n    this._state = ConnectionState.DISCONNECTED;\r\n    this._reconnectAttempts = 0;\r\n    this._reconnectTimer = null;\r\n    this._manualDisconnect = false;\r\n    this._registeredEventTypes = new Set();\r\n  }\r\n\r\n  /**\r\n   * Get the current connection state.\r\n   * @returns {string} One of: 'disconnected', 'connecting', 'connected'\r\n   */\r\n  get state() {\r\n    return this._state;\r\n  }\r\n\r\n  /**\r\n   * Get the endpoint URL.\r\n   * @returns {string} The SSE endpoint URL\r\n   */\r\n  get url() {\r\n    return this._url;\r\n  }\r\n\r\n  /**\r\n   * Establish an SSE connection to the server.\r\n   * This method is idempotent - calling it while already connected has no effect.\r\n   */\r\n  connect() {\r\n    // Idempotent: don't reconnect if already connecting or connected\r\n    if (this._state !== ConnectionState.DISCONNECTED) {\r\n      return;\r\n    }\r\n\r\n    this._manualDisconnect = false;\r\n    this._setState(ConnectionState.CONNECTING);\r\n\r\n    try {\r\n      this._eventSource = new EventSource(this._url, {\r\n        withCredentials: this._options.withCredentials\r\n      });\r\n\r\n      this._eventSource.onopen = () => this._handleOpen();\r\n      this._eventSource.onerror = (event) => this._handleError(event);\r\n\r\n      // Register event listeners for all currently subscribed event types\r\n      this._registerEventListeners();\r\n    } catch (error) {\r\n      this._handleConnectionError(error);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Close the SSE connection.\r\n   * This method is idempotent - calling it while already disconnected has no effect.\r\n   * After calling disconnect(), no automatic reconnection will be attempted.\r\n   */\r\n  disconnect() {\r\n    this._manualDisconnect = true;\r\n    this._cleanup();\r\n    \r\n    if (this._state !== ConnectionState.DISCONNECTED) {\r\n      this._setState(ConnectionState.DISCONNECTED);\r\n      this._emit(BuiltInEvents.CLOSE, { manual: true });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Subscribe to an event.\r\n   * Subscriptions can be registered before or after connecting.\r\n   * @param {string} event - The event name to subscribe to\r\n   * @param {Function} callback - The callback to invoke when the event occurs\r\n   * @returns {EventClient} This instance for chaining\r\n   */\r\n  on(event, callback) {\r\n    if (typeof event !== 'string' || !event) {\r\n      throw new TypeError('Event name must be a non-empty string');\r\n    }\r\n    if (typeof callback !== 'function') {\r\n      throw new TypeError('Callback must be a function');\r\n    }\r\n\r\n    this._subscriptions.add(event, callback);\r\n\r\n    // If already connected and this is a new event type, register it\r\n    if (this._eventSource && !this._isBuiltInEvent(event) && !this._registeredEventTypes.has(event)) {\r\n      this._registerSingleEventListener(event);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from an event.\r\n   * @param {string} event - The event name\r\n   * @param {Function} [callback] - Specific callback to remove. If omitted, removes all callbacks for the event.\r\n   * @returns {EventClient} This instance for chaining\r\n   */\r\n  off(event, callback) {\r\n    if (typeof event !== 'string' || !event) {\r\n      throw new TypeError('Event name must be a non-empty string');\r\n    }\r\n\r\n    if (callback !== undefined) {\r\n      this._subscriptions.remove(event, callback);\r\n    } else {\r\n      this._subscriptions.removeAll(event);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  // =====================\r\n  // Private Methods\r\n  // =====================\r\n\r\n  /**\r\n   * Update connection state and emit state change event.\r\n   * @private\r\n   */\r\n  _setState(newState) {\r\n    const oldState = this._state;\r\n    if (oldState === newState) {\r\n      return;\r\n    }\r\n\r\n    this._state = newState;\r\n    this._emit(BuiltInEvents.STATE_CHANGE, {\r\n      previousState: oldState,\r\n      currentState: newState\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all subscribers.\r\n   * @private\r\n   */\r\n  _emit(event, data) {\r\n    this._subscriptions.emit(event, data);\r\n  }\r\n\r\n  /**\r\n   * Handle successful connection.\r\n   * @private\r\n   */\r\n  _handleOpen() {\r\n    this._reconnectAttempts = 0; // Reset on successful connection\r\n    this._setState(ConnectionState.CONNECTED);\r\n    this._emit(BuiltInEvents.OPEN, { url: this._url });\r\n  }\r\n\r\n  /**\r\n   * Handle connection error.\r\n   * @private\r\n   */\r\n  _handleError(event) {\r\n    // EventSource error event doesn't provide much detail\r\n    const errorInfo = {\r\n      message: 'Connection error',\r\n      readyState: this._eventSource?.readyState\r\n    };\r\n\r\n    this._emit(BuiltInEvents.ERROR, errorInfo);\r\n\r\n    // Check if connection was lost\r\n    if (this._eventSource?.readyState === EventSource.CLOSED) {\r\n      this._handleConnectionLoss();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Handle initial connection failure.\r\n   * @private\r\n   */\r\n  _handleConnectionError(error) {\r\n    this._setState(ConnectionState.DISCONNECTED);\r\n    this._emit(BuiltInEvents.ERROR, {\r\n      message: error.message || 'Failed to create connection',\r\n      error\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Handle connection loss and schedule reconnection.\r\n   * @private\r\n   */\r\n  _handleConnectionLoss() {\r\n    this._cleanup();\r\n    this._setState(ConnectionState.DISCONNECTED);\r\n    this._emit(BuiltInEvents.CLOSE, { manual: false });\r\n\r\n    // Schedule reconnection if enabled and not manually disconnected\r\n    if (this._options.reconnect && !this._manualDisconnect) {\r\n      this._scheduleReconnect();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Schedule a reconnection attempt with exponential backoff and jitter.\r\n   * @private\r\n   */\r\n  _scheduleReconnect() {\r\n    if (this._manualDisconnect) {\r\n      return;\r\n    }\r\n\r\n    if (this._reconnectAttempts >= this._options.maxReconnectAttempts) {\r\n      this._emit(BuiltInEvents.ERROR, {\r\n        message: 'Max reconnection attempts reached',\r\n        attempts: this._reconnectAttempts\r\n      });\r\n      return;\r\n    }\r\n\r\n    // Exponential backoff: interval * 2^attempts\r\n    const exponentialDelay = this._options.reconnectInterval * Math.pow(2, this._reconnectAttempts);\r\n    \r\n    // Cap at max delay\r\n    const cappedDelay = Math.min(exponentialDelay, this._options.maxReconnectDelay);\r\n    \r\n    // Add jitter (0-1000ms random) to prevent thundering herd\r\n    const jitter = Math.random() * 1000;\r\n    const finalDelay = cappedDelay + jitter;\r\n\r\n    this._reconnectTimer = setTimeout(() => {\r\n      this._reconnectAttempts++;\r\n      this.connect();\r\n    }, finalDelay);\r\n  }\r\n\r\n  /**\r\n   * Register EventSource listeners for all subscribed event types.\r\n   * @private\r\n   */\r\n  _registerEventListeners() {\r\n    const events = this._subscriptions.getEvents();\r\n    \r\n    for (const event of events) {\r\n      if (!this._isBuiltInEvent(event)) {\r\n        this._registerSingleEventListener(event);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Register a single event listener on the EventSource.\r\n   * @private\r\n   */\r\n  _registerSingleEventListener(event) {\r\n    if (!this._eventSource || this._registeredEventTypes.has(event)) {\r\n      return;\r\n    }\r\n\r\n    this._registeredEventTypes.add(event);\r\n    \r\n    this._eventSource.addEventListener(event, (sseEvent) => {\r\n      this._handleMessage(event, sseEvent);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Handle incoming SSE message.\r\n   * @private\r\n   */\r\n  _handleMessage(eventType, sseEvent) {\r\n    let data;\r\n    \r\n    try {\r\n      // Attempt JSON parsing\r\n      data = JSON.parse(sseEvent.data);\r\n    } catch (parseError) {\r\n      // JSON parsing failed - emit error but don't disconnect\r\n      this._emit(BuiltInEvents.ERROR, {\r\n        message: 'Failed to parse JSON payload',\r\n        eventType,\r\n        originalData: sseEvent.data,\r\n        error: parseError.message\r\n      });\r\n      return;\r\n    }\r\n\r\n    // Emit the parsed event to subscribers\r\n    this._emit(eventType, data);\r\n  }\r\n\r\n  /**\r\n   * Check if an event name is a built-in event.\r\n   * @private\r\n   */\r\n  _isBuiltInEvent(event) {\r\n    return event.startsWith('stream.');\r\n  }\r\n\r\n  /**\r\n   * Clean up resources.\r\n   * @private\r\n   */\r\n  _cleanup() {\r\n    // Clear reconnection timer\r\n    if (this._reconnectTimer) {\r\n      clearTimeout(this._reconnectTimer);\r\n      this._reconnectTimer = null;\r\n    }\r\n\r\n    // Close EventSource\r\n    if (this._eventSource) {\r\n      this._eventSource.close();\r\n      this._eventSource = null;\r\n    }\r\n\r\n    // Clear registered event types (will be re-registered on reconnect)\r\n    this._registeredEventTypes.clear();\r\n  }\r\n}\r\n\r\n"],"names":["ConnectionState","Object","freeze","DISCONNECTED","CONNECTING","CONNECTED","BuiltInEvents","OPEN","CLOSE","ERROR","STATE_CHANGE","DefaultOptions","reconnect","reconnectInterval","maxReconnectAttempts","maxReconnectDelay","withCredentials","SubscriptionManager","constructor","this","_listeners","Map","add","event","callback","TypeError","has","set","Set","callbacks","get","existed","remove","removed","delete","size","removeAll","emit","data","snapshot","Array","from","error","console","undefined","getEvents","keys","getCount","clear","url","options","_url","_options","_eventSource","_subscriptions","_state","_reconnectAttempts","_reconnectTimer","_manualDisconnect","_registeredEventTypes","state","connect","_setState","EventSource","onopen","_handleOpen","onerror","_handleError","_registerEventListeners","_handleConnectionError","disconnect","_cleanup","_emit","manual","on","_isBuiltInEvent","_registerSingleEventListener","off","newState","oldState","previousState","currentState","errorInfo","message","readyState","CLOSED","_handleConnectionLoss","_scheduleReconnect","attempts","exponentialDelay","Math","pow","finalDelay","min","random","setTimeout","events","addEventListener","sseEvent","_handleMessage","eventType","JSON","parse","parseError","originalData","startsWith","clearTimeout","close"],"mappings":"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"}