mvc-kit 2.5.3 → 2.5.5

package/dist/Channel.cjs

@@ -0,0 +1,291 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+const 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;
+  // ── 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;
+  }
+  // ── 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);
+  }
+}
+exports.Channel = Channel;
+//# sourceMappingURL=Channel.cjs.map

package/dist/Channel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.cjs","sources":["../src/Channel.ts"],"sourcesContent":["import type { Listener, Subscribable, Disposable, Initializable } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Describes the current connection state of a Channel. */\nexport interface ChannelStatus {\n  readonly connected: boolean;\n  readonly reconnecting: boolean;\n  readonly attempt: number;\n  readonly error: string | null;\n}\n\ntype Handler<T> = (payload: T) => void;\n\nconst enum ConnectionState {\n  Idle,\n  Connecting,\n  Connected,\n  Reconnecting,\n  Disposed,\n}\n\nconst INITIAL_STATUS: ChannelStatus = Object.freeze({\n  connected: false,\n  reconnecting: false,\n  attempt: 0,\n  error: null,\n});\n\n// ── Channel ───────────────────────────────────────────────────────\n\n/**\n * Abstract persistent connection with automatic reconnection and exponential backoff.\n * Subclass to implement WebSocket, SSE, or other transport protocols.\n */\nexport abstract class Channel<M extends Record<string, any>>\n  implements Subscribable<ChannelStatus>, Initializable, Disposable\n{\n  // Static config (subclass overrides)\n  /** Base delay (ms) for reconnection backoff. */\n  static RECONNECT_BASE = 1000;\n  /** Maximum delay cap (ms) for reconnection backoff. */\n  static RECONNECT_MAX = 30000;\n  /** Exponential backoff multiplier for reconnection delay. */\n  static RECONNECT_FACTOR = 2;\n  /** Maximum number of reconnection attempts before giving up. */\n  static MAX_ATTEMPTS = Infinity;\n\n  // ── Internal state ──────────────────────────────────────────────\n  private _status: ChannelStatus = INITIAL_STATUS;\n  private _connState: ConnectionState = ConnectionState.Idle;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<ChannelStatus>>();\n  private _handlers = new Map<keyof M, Set<Handler<unknown>>>();\n  private _abortController: AbortController | null = null;\n  private _connectAbort: AbortController | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  // ── Subscribable<ChannelStatus> ─────────────────────────────────\n\n  /** Current connection status. */\n  get state(): ChannelStatus {\n    return this._status;\n  }\n\n  /** Subscribes to connection status changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<ChannelStatus>): () => void {\n    if (this._disposed) return () => {};\n    this._listeners.add(listener);\n    return () => { this._listeners.delete(listener); };\n  }\n\n  // ── Disposable / Initializable ──────────────────────────────────\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._connState = ConnectionState.Disposed;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort per-connection signal\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Abort dispose signal\n    this._abortController?.abort();\n\n    // Close transport\n    try { this.close(); } catch { /* swallow close errors during dispose */ }\n\n    // Run cleanups\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n\n    this.onDispose?.();\n    this._listeners.clear();\n    this._handlers.clear();\n  }\n\n  // ── Subclass contract ───────────────────────────────────────────\n\n  /** Establishes the underlying connection. Called internally by connect(). @protected */\n  protected abstract open(signal: AbortSignal): void | Promise<void>;\n  /** Tears down the underlying connection. Called internally by disconnect() and dispose(). @protected */\n  protected abstract close(): void;\n\n  // ── Connection control ──────────────────────────────────────────\n\n  /** Initiates a connection with automatic reconnection on failure. */\n  connect(): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] connect() called after dispose — ignored.');\n      }\n      return;\n    }\n    if (__DEV__ && !this._initialized) {\n      console.warn('[mvc-kit] connect() called before init().');\n    }\n    if (\n      this._connState === ConnectionState.Connecting ||\n      this._connState === ConnectionState.Connected\n    ) {\n      return;\n    }\n\n    // Cancel any pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    this._attemptConnect(0);\n  }\n\n  /** Closes the connection and cancels any pending reconnection. */\n  disconnect(): void {\n    if (this._disposed) return;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort current connection attempt\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Close transport\n    if (\n      this._connState === ConnectionState.Connected ||\n      this._connState === ConnectionState.Connecting\n    ) {\n      this._connState = ConnectionState.Idle;\n      try { this.close(); } catch { /* swallow */ }\n    } else {\n      this._connState = ConnectionState.Idle;\n    }\n\n    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });\n  }\n\n  // ── Subclass signals ────────────────────────────────────────────\n\n  /** Call from subclass when a message arrives from the transport. @protected */\n  protected receive<K extends keyof M>(type: K, payload: M[K]): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn(`[mvc-kit] receive(\"${String(type)}\") called after dispose — ignored.`);\n      }\n      return;\n    }\n\n    const handlers = this._handlers.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(payload);\n      }\n    }\n  }\n\n  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */\n  protected disconnected(): void {\n    if (this._disposed) return;\n    // Only trigger reconnect from connected or connecting states\n    if (\n      this._connState !== ConnectionState.Connected &&\n      this._connState !== ConnectionState.Connecting\n    ) {\n      return;\n    }\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(1);\n  }\n\n  // ── Consumer API ────────────────────────────────────────────────\n\n  /** Subscribes to a specific message type. Returns an unsubscribe function. */\n  on<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    if (this._disposed) return () => {};\n\n    let handlers = this._handlers.get(type);\n    if (!handlers) {\n      handlers = new Set();\n      this._handlers.set(type, handlers);\n    }\n    handlers.add(handler as Handler<unknown>);\n\n    return () => { handlers!.delete(handler as Handler<unknown>); };\n  }\n\n  /** Subscribes to a message type, auto-removing the handler after the first invocation. */\n  once<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      handler(payload);\n    });\n    return unsubscribe;\n  }\n\n  // ── Infrastructure ──────────────────────────────────────────────\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  // ── Backoff ─────────────────────────────────────────────────────\n\n  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */\n  protected _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Channel;\n    const capped = Math.min(\n      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),\n      ctor.RECONNECT_MAX,\n    );\n    return Math.random() * capped;\n  }\n\n  // ── Internals ───────────────────────────────────────────────────\n\n  private _setStatus(next: ChannelStatus): void {\n    const prev = this._status;\n    if (\n      prev.connected === next.connected &&\n      prev.reconnecting === next.reconnecting &&\n      prev.attempt === next.attempt &&\n      prev.error === next.error\n    ) {\n      return;\n    }\n\n    this._status = Object.freeze(next);\n    for (const listener of this._listeners) {\n      listener(this._status, prev);\n    }\n  }\n\n  private _attemptConnect(attempt: number): void {\n    if (this._disposed) return;\n\n    this._connState = ConnectionState.Connecting;\n\n    // Create per-connection abort controller\n    this._connectAbort?.abort();\n    this._connectAbort = new AbortController();\n\n    const signal = this._abortController\n      ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal])\n      : this._connectAbort.signal;\n\n    this._setStatus({\n      connected: false,\n      reconnecting: attempt > 0,\n      attempt,\n      error: null,\n    });\n\n    let result: void | Promise<void>;\n    try {\n      result = this.open(signal);\n    } catch (e) {\n      this._onOpenFailed(attempt, e);\n      return;\n    }\n\n    if (result && typeof (result as Promise<void>).then === 'function') {\n      (result as Promise<void>).then(\n        () => this._onOpenSucceeded(),\n        (e) => this._onOpenFailed(attempt, e),\n      );\n    } else {\n      this._onOpenSucceeded();\n    }\n  }\n\n  private _onOpenSucceeded(): void {\n    if (this._disposed) return;\n    // Only transition if we're still connecting (disconnect may have been called)\n    if (this._connState !== ConnectionState.Connecting) return;\n\n    this._connState = ConnectionState.Connected;\n    this._setStatus({\n      connected: true,\n      reconnecting: false,\n      attempt: 0,\n      error: null,\n    });\n  }\n\n  private _onOpenFailed(attempt: number, error: unknown): void {\n    if (this._disposed) return;\n    // If disconnect was called during open, don't reconnect\n    if (this._connState === ConnectionState.Idle) return;\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(attempt + 1, error);\n  }\n\n  private _scheduleReconnect(attempt: number, error?: unknown): void {\n    const ctor = this.constructor as typeof Channel;\n\n    if (attempt > ctor.MAX_ATTEMPTS) {\n      this._connState = ConnectionState.Idle;\n      this._setStatus({\n        connected: false,\n        reconnecting: false,\n        attempt,\n        error: error instanceof Error ? error.message : 'Max reconnection attempts reached',\n      });\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : (error ? String(error) : null);\n\n    this._setStatus({\n      connected: false,\n      reconnecting: true,\n      attempt,\n      error: errorMsg,\n    });\n\n    const delay = this._calculateDelay(attempt - 1);\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      this._attemptConnect(attempt);\n    }, delay);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Channel.js

@@ -0,0 +1,291 @@
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+const 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;
+  // ── 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;
+  }
+  // ── 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);
+  }
+}
+export {
+  Channel
+};
+//# sourceMappingURL=Channel.js.map

package/dist/Channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.js","sources":["../src/Channel.ts"],"sourcesContent":["import type { Listener, Subscribable, Disposable, Initializable } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Describes the current connection state of a Channel. */\nexport interface ChannelStatus {\n  readonly connected: boolean;\n  readonly reconnecting: boolean;\n  readonly attempt: number;\n  readonly error: string | null;\n}\n\ntype Handler<T> = (payload: T) => void;\n\nconst enum ConnectionState {\n  Idle,\n  Connecting,\n  Connected,\n  Reconnecting,\n  Disposed,\n}\n\nconst INITIAL_STATUS: ChannelStatus = Object.freeze({\n  connected: false,\n  reconnecting: false,\n  attempt: 0,\n  error: null,\n});\n\n// ── Channel ───────────────────────────────────────────────────────\n\n/**\n * Abstract persistent connection with automatic reconnection and exponential backoff.\n * Subclass to implement WebSocket, SSE, or other transport protocols.\n */\nexport abstract class Channel<M extends Record<string, any>>\n  implements Subscribable<ChannelStatus>, Initializable, Disposable\n{\n  // Static config (subclass overrides)\n  /** Base delay (ms) for reconnection backoff. */\n  static RECONNECT_BASE = 1000;\n  /** Maximum delay cap (ms) for reconnection backoff. */\n  static RECONNECT_MAX = 30000;\n  /** Exponential backoff multiplier for reconnection delay. */\n  static RECONNECT_FACTOR = 2;\n  /** Maximum number of reconnection attempts before giving up. */\n  static MAX_ATTEMPTS = Infinity;\n\n  // ── Internal state ──────────────────────────────────────────────\n  private _status: ChannelStatus = INITIAL_STATUS;\n  private _connState: ConnectionState = ConnectionState.Idle;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<ChannelStatus>>();\n  private _handlers = new Map<keyof M, Set<Handler<unknown>>>();\n  private _abortController: AbortController | null = null;\n  private _connectAbort: AbortController | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  // ── Subscribable<ChannelStatus> ─────────────────────────────────\n\n  /** Current connection status. */\n  get state(): ChannelStatus {\n    return this._status;\n  }\n\n  /** Subscribes to connection status changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<ChannelStatus>): () => void {\n    if (this._disposed) return () => {};\n    this._listeners.add(listener);\n    return () => { this._listeners.delete(listener); };\n  }\n\n  // ── Disposable / Initializable ──────────────────────────────────\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._connState = ConnectionState.Disposed;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort per-connection signal\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Abort dispose signal\n    this._abortController?.abort();\n\n    // Close transport\n    try { this.close(); } catch { /* swallow close errors during dispose */ }\n\n    // Run cleanups\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n\n    this.onDispose?.();\n    this._listeners.clear();\n    this._handlers.clear();\n  }\n\n  // ── Subclass contract ───────────────────────────────────────────\n\n  /** Establishes the underlying connection. Called internally by connect(). @protected */\n  protected abstract open(signal: AbortSignal): void | Promise<void>;\n  /** Tears down the underlying connection. Called internally by disconnect() and dispose(). @protected */\n  protected abstract close(): void;\n\n  // ── Connection control ──────────────────────────────────────────\n\n  /** Initiates a connection with automatic reconnection on failure. */\n  connect(): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] connect() called after dispose — ignored.');\n      }\n      return;\n    }\n    if (__DEV__ && !this._initialized) {\n      console.warn('[mvc-kit] connect() called before init().');\n    }\n    if (\n      this._connState === ConnectionState.Connecting ||\n      this._connState === ConnectionState.Connected\n    ) {\n      return;\n    }\n\n    // Cancel any pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    this._attemptConnect(0);\n  }\n\n  /** Closes the connection and cancels any pending reconnection. */\n  disconnect(): void {\n    if (this._disposed) return;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort current connection attempt\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Close transport\n    if (\n      this._connState === ConnectionState.Connected ||\n      this._connState === ConnectionState.Connecting\n    ) {\n      this._connState = ConnectionState.Idle;\n      try { this.close(); } catch { /* swallow */ }\n    } else {\n      this._connState = ConnectionState.Idle;\n    }\n\n    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });\n  }\n\n  // ── Subclass signals ────────────────────────────────────────────\n\n  /** Call from subclass when a message arrives from the transport. @protected */\n  protected receive<K extends keyof M>(type: K, payload: M[K]): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn(`[mvc-kit] receive(\"${String(type)}\") called after dispose — ignored.`);\n      }\n      return;\n    }\n\n    const handlers = this._handlers.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(payload);\n      }\n    }\n  }\n\n  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */\n  protected disconnected(): void {\n    if (this._disposed) return;\n    // Only trigger reconnect from connected or connecting states\n    if (\n      this._connState !== ConnectionState.Connected &&\n      this._connState !== ConnectionState.Connecting\n    ) {\n      return;\n    }\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(1);\n  }\n\n  // ── Consumer API ────────────────────────────────────────────────\n\n  /** Subscribes to a specific message type. Returns an unsubscribe function. */\n  on<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    if (this._disposed) return () => {};\n\n    let handlers = this._handlers.get(type);\n    if (!handlers) {\n      handlers = new Set();\n      this._handlers.set(type, handlers);\n    }\n    handlers.add(handler as Handler<unknown>);\n\n    return () => { handlers!.delete(handler as Handler<unknown>); };\n  }\n\n  /** Subscribes to a message type, auto-removing the handler after the first invocation. */\n  once<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      handler(payload);\n    });\n    return unsubscribe;\n  }\n\n  // ── Infrastructure ──────────────────────────────────────────────\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  // ── Backoff ─────────────────────────────────────────────────────\n\n  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */\n  protected _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Channel;\n    const capped = Math.min(\n      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),\n      ctor.RECONNECT_MAX,\n    );\n    return Math.random() * capped;\n  }\n\n  // ── Internals ───────────────────────────────────────────────────\n\n  private _setStatus(next: ChannelStatus): void {\n    const prev = this._status;\n    if (\n      prev.connected === next.connected &&\n      prev.reconnecting === next.reconnecting &&\n      prev.attempt === next.attempt &&\n      prev.error === next.error\n    ) {\n      return;\n    }\n\n    this._status = Object.freeze(next);\n    for (const listener of this._listeners) {\n      listener(this._status, prev);\n    }\n  }\n\n  private _attemptConnect(attempt: number): void {\n    if (this._disposed) return;\n\n    this._connState = ConnectionState.Connecting;\n\n    // Create per-connection abort controller\n    this._connectAbort?.abort();\n    this._connectAbort = new AbortController();\n\n    const signal = this._abortController\n      ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal])\n      : this._connectAbort.signal;\n\n    this._setStatus({\n      connected: false,\n      reconnecting: attempt > 0,\n      attempt,\n      error: null,\n    });\n\n    let result: void | Promise<void>;\n    try {\n      result = this.open(signal);\n    } catch (e) {\n      this._onOpenFailed(attempt, e);\n      return;\n    }\n\n    if (result && typeof (result as Promise<void>).then === 'function') {\n      (result as Promise<void>).then(\n        () => this._onOpenSucceeded(),\n        (e) => this._onOpenFailed(attempt, e),\n      );\n    } else {\n      this._onOpenSucceeded();\n    }\n  }\n\n  private _onOpenSucceeded(): void {\n    if (this._disposed) return;\n    // Only transition if we're still connecting (disconnect may have been called)\n    if (this._connState !== ConnectionState.Connecting) return;\n\n    this._connState = ConnectionState.Connected;\n    this._setStatus({\n      connected: true,\n      reconnecting: false,\n      attempt: 0,\n      error: null,\n    });\n  }\n\n  private _onOpenFailed(attempt: number, error: unknown): void {\n    if (this._disposed) return;\n    // If disconnect was called during open, don't reconnect\n    if (this._connState === ConnectionState.Idle) return;\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(attempt + 1, error);\n  }\n\n  private _scheduleReconnect(attempt: number, error?: unknown): void {\n    const ctor = this.constructor as typeof Channel;\n\n    if (attempt > ctor.MAX_ATTEMPTS) {\n      this._connState = ConnectionState.Idle;\n      this._setStatus({\n        connected: false,\n        reconnecting: false,\n        attempt,\n        error: error instanceof Error ? error.message : 'Max reconnection attempts reached',\n      });\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : (error ? String(error) : null);\n\n    this._setStatus({\n      connected: false,\n      reconnecting: true,\n      attempt,\n      error: errorMsg,\n    });\n\n    const delay = this._calculateDelay(attempt - 1);\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      this._attemptConnect(attempt);\n    }, delay);\n  }\n}\n"],"names":[],"mappings":"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"}