mvc-kit 2.12.5 → 2.13.0

package/dist/Channel.cjs

@@ -1,302 +1,278 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const bindPublicMethods = require("./bindPublicMethods.cjs");
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-const PROTECTED_KEYS = /* @__PURE__ */ new Set(["receive", "disconnected", "addCleanup", "subscribeTo", "listenTo"]);
-const INITIAL_STATUS = Object.freeze({
-  connected: false,
-  reconnecting: false,
-  attempt: 0,
-  error: null
+const require_bindPublicMethods = require("./bindPublicMethods.cjs");
+//#region src/Channel.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+var PROTECTED_KEYS = new Set([
+	"receive",
+	"disconnected",
+	"addCleanup",
+	"subscribeTo",
+	"listenTo"
+]);
+var ConnectionState = /* @__PURE__ */ function(ConnectionState) {
+	ConnectionState[ConnectionState["Idle"] = 0] = "Idle";
+	ConnectionState[ConnectionState["Connecting"] = 1] = "Connecting";
+	ConnectionState[ConnectionState["Connected"] = 2] = "Connected";
+	ConnectionState[ConnectionState["Reconnecting"] = 3] = "Reconnecting";
+	ConnectionState[ConnectionState["Disposed"] = 4] = "Disposed";
+	return ConnectionState;
+}(ConnectionState || {});
+var INITIAL_STATUS = Object.freeze({
+	connected: false,
+	reconnecting: false,
+	attempt: 0,
+	error: null
 });
-class Channel {
-  // Static config (subclass overrides)
-  /** Base delay (ms) for reconnection backoff. */
-  static RECONNECT_BASE = 1e3;
-  /** Maximum delay cap (ms) for reconnection backoff. */
-  static RECONNECT_MAX = 3e4;
-  /** Exponential backoff multiplier for reconnection delay. */
-  static RECONNECT_FACTOR = 2;
-  /** Maximum number of reconnection attempts before giving up. */
-  static MAX_ATTEMPTS = Infinity;
-  // ── Internal state ──────────────────────────────────────────────
-  _status = INITIAL_STATUS;
-  _connState = 0;
-  _disposed = false;
-  _initialized = false;
-  _listeners = /* @__PURE__ */ new Set();
-  _handlers = /* @__PURE__ */ new Map();
-  _abortController = null;
-  _connectAbort = null;
-  _reconnectTimer = null;
-  _cleanups = null;
-  constructor() {
-    bindPublicMethods.bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);
-  }
-  // ── Subscribable<ChannelStatus> ─────────────────────────────────
-  /** Current connection status. */
-  get state() {
-    return this._status;
-  }
-  /** Subscribes to connection status changes. Returns an unsubscribe function. */
-  subscribe(listener) {
-    if (this._disposed) return () => {
-    };
-    this._listeners.add(listener);
-    return () => {
-      this._listeners.delete(listener);
-    };
-  }
-  // ── Disposable / Initializable ──────────────────────────────────
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
-  }
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    if (!this._abortController) {
-      this._abortController = new AbortController();
-    }
-    return this._abortController.signal;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (this._initialized || this._disposed) return;
-    this._initialized = true;
-    return this.onInit?.();
-  }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (this._disposed) return;
-    this._disposed = true;
-    this._connState = 4;
-    if (this._reconnectTimer !== null) {
-      clearTimeout(this._reconnectTimer);
-      this._reconnectTimer = null;
-    }
-    this._connectAbort?.abort();
-    this._connectAbort = null;
-    this._abortController?.abort();
-    try {
-      this.close();
-    } catch {
-    }
-    if (this._cleanups) {
-      for (const fn of this._cleanups) fn();
-      this._cleanups = null;
-    }
-    this.onDispose?.();
-    this._listeners.clear();
-    this._handlers.clear();
-  }
-  // ── Connection control ──────────────────────────────────────────
-  /** Initiates a connection with automatic reconnection on failure. */
-  connect() {
-    if (this._disposed) {
-      if (__DEV__) {
-        console.warn("[mvc-kit] connect() called after dispose — ignored.");
-      }
-      return;
-    }
-    if (__DEV__ && !this._initialized) {
-      console.warn("[mvc-kit] connect() called before init().");
-    }
-    if (this._connState === 1 || this._connState === 2) {
-      return;
-    }
-    if (this._reconnectTimer !== null) {
-      clearTimeout(this._reconnectTimer);
-      this._reconnectTimer = null;
-    }
-    this._attemptConnect(0);
-  }
-  /** Closes the connection and cancels any pending reconnection. */
-  disconnect() {
-    if (this._disposed) return;
-    if (this._reconnectTimer !== null) {
-      clearTimeout(this._reconnectTimer);
-      this._reconnectTimer = null;
-    }
-    this._connectAbort?.abort();
-    this._connectAbort = null;
-    if (this._connState === 2 || this._connState === 1) {
-      this._connState = 0;
-      try {
-        this.close();
-      } catch {
-      }
-    } else {
-      this._connState = 0;
-    }
-    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });
-  }
-  // ── Subclass signals ────────────────────────────────────────────
-  /** Call from subclass when a message arrives from the transport. @protected */
-  receive(type, payload) {
-    if (this._disposed) {
-      if (__DEV__) {
-        console.warn(`[mvc-kit] receive("${String(type)}") called after dispose — ignored.`);
-      }
-      return;
-    }
-    const handlers = this._handlers.get(type);
-    if (handlers) {
-      for (const handler of handlers) {
-        handler(payload);
-      }
-    }
-  }
-  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */
-  disconnected() {
-    if (this._disposed) return;
-    if (this._connState !== 2 && this._connState !== 1) {
-      return;
-    }
-    this._connectAbort?.abort();
-    this._connectAbort = null;
-    this._connState = 3;
-    this._scheduleReconnect(1);
-  }
-  // ── Consumer API ────────────────────────────────────────────────
-  /** Subscribes to a specific message type. Returns an unsubscribe function. */
-  on(type, handler) {
-    if (this._disposed) return () => {
-    };
-    let handlers = this._handlers.get(type);
-    if (!handlers) {
-      handlers = /* @__PURE__ */ new Set();
-      this._handlers.set(type, handlers);
-    }
-    handlers.add(handler);
-    return () => {
-      handlers.delete(handler);
-    };
-  }
-  /** Subscribes to a message type, auto-removing the handler after the first invocation. */
-  once(type, handler) {
-    const unsubscribe = this.on(type, (payload) => {
-      unsubscribe();
-      handler(payload);
-    });
-    return unsubscribe;
-  }
-  // ── Infrastructure ──────────────────────────────────────────────
-  /** Registers a cleanup function to be called on dispose. @protected */
-  addCleanup(fn) {
-    if (!this._cleanups) {
-      this._cleanups = [];
-    }
-    this._cleanups.push(fn);
-  }
-  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
-  subscribeTo(source, listener) {
-    const unsubscribe = source.subscribe(listener);
-    this.addCleanup(unsubscribe);
-    return unsubscribe;
-  }
-  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
-  listenTo(source, event, handler) {
-    const unsubscribe = source.on(event, handler);
-    this.addCleanup(unsubscribe);
-    return unsubscribe;
-  }
-  // ── Backoff ─────────────────────────────────────────────────────
-  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */
-  _calculateDelay(attempt) {
-    const ctor = this.constructor;
-    const capped = Math.min(
-      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),
-      ctor.RECONNECT_MAX
-    );
-    return Math.random() * capped;
-  }
-  // ── Internals ───────────────────────────────────────────────────
-  _setStatus(next) {
-    const prev = this._status;
-    if (prev.connected === next.connected && prev.reconnecting === next.reconnecting && prev.attempt === next.attempt && prev.error === next.error) {
-      return;
-    }
-    this._status = Object.freeze(next);
-    for (const listener of this._listeners) {
-      listener(this._status, prev);
-    }
-  }
-  _attemptConnect(attempt) {
-    if (this._disposed) return;
-    this._connState = 1;
-    this._connectAbort?.abort();
-    this._connectAbort = new AbortController();
-    const signal = this._abortController ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal]) : this._connectAbort.signal;
-    this._setStatus({
-      connected: false,
-      reconnecting: attempt > 0,
-      attempt,
-      error: null
-    });
-    let result;
-    try {
-      result = this.open(signal);
-    } catch (e) {
-      this._onOpenFailed(attempt, e);
-      return;
-    }
-    if (result && typeof result.then === "function") {
-      result.then(
-        () => this._onOpenSucceeded(),
-        (e) => this._onOpenFailed(attempt, e)
-      );
-    } else {
-      this._onOpenSucceeded();
-    }
-  }
-  _onOpenSucceeded() {
-    if (this._disposed) return;
-    if (this._connState !== 1) return;
-    this._connState = 2;
-    this._setStatus({
-      connected: true,
-      reconnecting: false,
-      attempt: 0,
-      error: null
-    });
-  }
-  _onOpenFailed(attempt, error) {
-    if (this._disposed) return;
-    if (this._connState === 0) return;
-    this._connectAbort?.abort();
-    this._connectAbort = null;
-    this._connState = 3;
-    this._scheduleReconnect(attempt + 1, error);
-  }
-  _scheduleReconnect(attempt, error) {
-    const ctor = this.constructor;
-    if (attempt > ctor.MAX_ATTEMPTS) {
-      this._connState = 0;
-      this._setStatus({
-        connected: false,
-        reconnecting: false,
-        attempt,
-        error: error instanceof Error ? error.message : "Max reconnection attempts reached"
-      });
-      return;
-    }
-    const errorMsg = error instanceof Error ? error.message : error ? String(error) : null;
-    this._setStatus({
-      connected: false,
-      reconnecting: true,
-      attempt,
-      error: errorMsg
-    });
-    const delay = this._calculateDelay(attempt - 1);
-    this._reconnectTimer = setTimeout(() => {
-      this._reconnectTimer = null;
-      this._attemptConnect(attempt);
-    }, delay);
-  }
-}
+/**
+* Abstract persistent connection with automatic reconnection and exponential backoff.
+* Subclass to implement WebSocket, SSE, or other transport protocols.
+*/
+var Channel = class {
+	/** Base delay (ms) for reconnection backoff. */
+	static RECONNECT_BASE = 1e3;
+	/** Maximum delay cap (ms) for reconnection backoff. */
+	static RECONNECT_MAX = 3e4;
+	/** Exponential backoff multiplier for reconnection delay. */
+	static RECONNECT_FACTOR = 2;
+	/** Maximum number of reconnection attempts before giving up. */
+	static MAX_ATTEMPTS = Infinity;
+	_status = INITIAL_STATUS;
+	_connState = ConnectionState.Idle;
+	_disposed = false;
+	_initialized = false;
+	_listeners = /* @__PURE__ */ new Set();
+	_handlers = /* @__PURE__ */ new Map();
+	_abortController = null;
+	_connectAbort = null;
+	_reconnectTimer = null;
+	_cleanups = null;
+	constructor() {
+		require_bindPublicMethods.bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);
+	}
+	/** Current connection status. */
+	get state() {
+		return this._status;
+	}
+	/** Subscribes to connection status changes. Returns an unsubscribe function. */
+	subscribe(listener) {
+		if (this._disposed) return () => {};
+		this._listeners.add(listener);
+		return () => {
+			this._listeners.delete(listener);
+		};
+	}
+	/** Whether this instance has been disposed. */
+	get disposed() {
+		return this._disposed;
+	}
+	/** Whether init() has been called. */
+	get initialized() {
+		return this._initialized;
+	}
+	/** AbortSignal that fires when this instance is disposed. Lazily created. */
+	get disposeSignal() {
+		if (!this._abortController) this._abortController = new AbortController();
+		return this._abortController.signal;
+	}
+	/** Initializes the instance. Called automatically by React hooks after mount. */
+	init() {
+		if (this._initialized || this._disposed) return;
+		this._initialized = true;
+		return this.onInit?.();
+	}
+	/** Tears down the instance, releasing all subscriptions and resources. */
+	dispose() {
+		if (this._disposed) return;
+		this._disposed = true;
+		this._connState = ConnectionState.Disposed;
+		if (this._reconnectTimer !== null) {
+			clearTimeout(this._reconnectTimer);
+			this._reconnectTimer = null;
+		}
+		this._connectAbort?.abort();
+		this._connectAbort = null;
+		this._abortController?.abort();
+		try {
+			this.close();
+		} catch {}
+		if (this._cleanups) {
+			for (const fn of this._cleanups) fn();
+			this._cleanups = null;
+		}
+		this.onDispose?.();
+		this._listeners.clear();
+		this._handlers.clear();
+	}
+	/** Initiates a connection with automatic reconnection on failure. */
+	connect() {
+		if (this._disposed) {
+			if (__DEV__) console.warn("[mvc-kit] connect() called after dispose — ignored.");
+			return;
+		}
+		if (__DEV__ && !this._initialized) console.warn("[mvc-kit] connect() called before init().");
+		if (this._connState === ConnectionState.Connecting || this._connState === ConnectionState.Connected) return;
+		if (this._reconnectTimer !== null) {
+			clearTimeout(this._reconnectTimer);
+			this._reconnectTimer = null;
+		}
+		this._attemptConnect(0);
+	}
+	/** Closes the connection and cancels any pending reconnection. */
+	disconnect() {
+		if (this._disposed) return;
+		if (this._reconnectTimer !== null) {
+			clearTimeout(this._reconnectTimer);
+			this._reconnectTimer = null;
+		}
+		this._connectAbort?.abort();
+		this._connectAbort = null;
+		if (this._connState === ConnectionState.Connected || this._connState === ConnectionState.Connecting) {
+			this._connState = ConnectionState.Idle;
+			try {
+				this.close();
+			} catch {}
+		} else this._connState = ConnectionState.Idle;
+		this._setStatus({
+			connected: false,
+			reconnecting: false,
+			attempt: 0,
+			error: null
+		});
+	}
+	/** Call from subclass when a message arrives from the transport. @protected */
+	receive(type, payload) {
+		if (this._disposed) {
+			if (__DEV__) console.warn(`[mvc-kit] receive("${String(type)}") called after dispose — ignored.`);
+			return;
+		}
+		const handlers = this._handlers.get(type);
+		if (handlers) for (const handler of handlers) handler(payload);
+	}
+	/** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */
+	disconnected() {
+		if (this._disposed) return;
+		if (this._connState !== ConnectionState.Connected && this._connState !== ConnectionState.Connecting) return;
+		this._connectAbort?.abort();
+		this._connectAbort = null;
+		this._connState = ConnectionState.Reconnecting;
+		this._scheduleReconnect(1);
+	}
+	/** Subscribes to a specific message type. Returns an unsubscribe function. */
+	on(type, handler) {
+		if (this._disposed) return () => {};
+		let handlers = this._handlers.get(type);
+		if (!handlers) {
+			handlers = /* @__PURE__ */ new Set();
+			this._handlers.set(type, handlers);
+		}
+		handlers.add(handler);
+		return () => {
+			handlers.delete(handler);
+		};
+	}
+	/** Subscribes to a message type, auto-removing the handler after the first invocation. */
+	once(type, handler) {
+		const unsubscribe = this.on(type, (payload) => {
+			unsubscribe();
+			handler(payload);
+		});
+		return unsubscribe;
+	}
+	/** Registers a cleanup function to be called on dispose. @protected */
+	addCleanup(fn) {
+		if (!this._cleanups) this._cleanups = [];
+		this._cleanups.push(fn);
+	}
+	/** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
+	subscribeTo(source, listener) {
+		const unsubscribe = source.subscribe(listener);
+		this.addCleanup(unsubscribe);
+		return unsubscribe;
+	}
+	/** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+	listenTo(source, event, handler) {
+		const unsubscribe = source.on(event, handler);
+		this.addCleanup(unsubscribe);
+		return unsubscribe;
+	}
+	/** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */
+	_calculateDelay(attempt) {
+		const ctor = this.constructor;
+		const capped = Math.min(ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt), ctor.RECONNECT_MAX);
+		return Math.random() * capped;
+	}
+	_setStatus(next) {
+		const prev = this._status;
+		if (prev.connected === next.connected && prev.reconnecting === next.reconnecting && prev.attempt === next.attempt && prev.error === next.error) return;
+		this._status = Object.freeze(next);
+		for (const listener of this._listeners) listener(this._status, prev);
+	}
+	_attemptConnect(attempt) {
+		if (this._disposed) return;
+		this._connState = ConnectionState.Connecting;
+		this._connectAbort?.abort();
+		this._connectAbort = new AbortController();
+		const signal = this._abortController ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal]) : this._connectAbort.signal;
+		this._setStatus({
+			connected: false,
+			reconnecting: attempt > 0,
+			attempt,
+			error: null
+		});
+		let result;
+		try {
+			result = this.open(signal);
+		} catch (e) {
+			this._onOpenFailed(attempt, e);
+			return;
+		}
+		if (result && typeof result.then === "function") result.then(() => this._onOpenSucceeded(), (e) => this._onOpenFailed(attempt, e));
+		else this._onOpenSucceeded();
+	}
+	_onOpenSucceeded() {
+		if (this._disposed) return;
+		if (this._connState !== ConnectionState.Connecting) return;
+		this._connState = ConnectionState.Connected;
+		this._setStatus({
+			connected: true,
+			reconnecting: false,
+			attempt: 0,
+			error: null
+		});
+	}
+	_onOpenFailed(attempt, error) {
+		if (this._disposed) return;
+		if (this._connState === ConnectionState.Idle) return;
+		this._connectAbort?.abort();
+		this._connectAbort = null;
+		this._connState = ConnectionState.Reconnecting;
+		this._scheduleReconnect(attempt + 1, error);
+	}
+	_scheduleReconnect(attempt, error) {
+		if (attempt > this.constructor.MAX_ATTEMPTS) {
+			this._connState = ConnectionState.Idle;
+			this._setStatus({
+				connected: false,
+				reconnecting: false,
+				attempt,
+				error: error instanceof Error ? error.message : "Max reconnection attempts reached"
+			});
+			return;
+		}
+		const errorMsg = error instanceof Error ? error.message : error ? String(error) : null;
+		this._setStatus({
+			connected: false,
+			reconnecting: true,
+			attempt,
+			error: errorMsg
+		});
+		const delay = this._calculateDelay(attempt - 1);
+		this._reconnectTimer = setTimeout(() => {
+			this._reconnectTimer = null;
+			this._attemptConnect(attempt);
+		}, delay);
+	}
+};
+//#endregion
 exports.Channel = Channel;
-//# sourceMappingURL=Channel.cjs.map
+
+//# sourceMappingURL=Channel.cjs.map