react-ws-context 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-08-29
+
+### Added
+
+- `WsPhase` type — provider connection intent and reconnect strategy: `idle` | `connecting` | `open` | `reconnecting` | `stopped`
+- `WsState.phase` — subscribable provider lifecycle phase, orthogonal to `status` (WebSocket readyState mapping); use with `reconnectAttempt` / `reconnectExhausted` for reconnect UI
+- Exported `WsPhase` from the package entry
+
 ## [0.2.0] - 2026-08-28
 
 ### Added

package/README.md

@@ -93,7 +93,7 @@ createWsContext(options)
 ```
 
 - **Call `createWsContext` multiple times** for independent connections (e.g. app WS + notification WS).
-- **`WsState` holds low-frequency connection data only** — health (`status`), outbound queue (e.g. future `pendingCount`), reconnect (`reconnectAttempt`). **Not** message payloads or app data.
+- **`WsState` holds low-frequency connection data only** — health (`status`, `phase`), outbound queue (e.g. future `pendingCount`), reconnect (`reconnectAttempt`). **Not** message payloads or app data.
 - **Messages and errors** — use `useWsEvents`; keep message history in your own state, cache, or store.
 - **Connection errors are not a `WsStatus`** — use `useWsEvents("error")`; native `error` is usually followed by `close`.
 
@@ -182,6 +182,8 @@ useWsStore<T>(selector: (state: WsState) => T): T
 ```ts
 interface WsState {
   status: WsStatus;
+  /** Provider connection intent and reconnect strategy; orthogonal to `status` */
+  phase: WsPhase;
   /** Reconnects scheduled this cycle (+1 on unintentional close, not on success) */
   reconnectAttempt: number;
   /** `true` when `reconnectMax` is hit and the final attempt failed; cleared by `connect()` / `disconnect()` */
@@ -191,9 +193,9 @@ interface WsState {
 }
 ```
 
-| Belongs in store                                                                                              | Does not belong                              |
-| ------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
-| `status`, reconnect progress (`reconnectAttempt` / `reconnectExhausted`), pending queue size, liveness / stall summaries | `lastMessage`, message history, app payloads |
+| Belongs in store                                                                                                              | Does not belong                              |
+| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
+| `status`, `phase`, reconnect progress (`reconnectAttempt` / `reconnectExhausted`), pending queue size, liveness / stall summaries | `lastMessage`, message history, app payloads |
 
 `CreateWsContextOptions` (e.g. `url`, `reconnectMax`) are frozen at `createWsContext` and are **not** in `WsState`. For UI like `n/max`, keep the config alongside the store fields you subscribe to.
 
@@ -206,10 +208,31 @@ interface WsState {
 | `open`       | Connected     |
 | `closed`     | Disconnected  |
 
+Maps to the current WebSocket connection state (similar to readyState). Does **not** express provider intent such as “in an auto-reconnect cycle” or “user disconnected” — use `phase` for that.
+
+#### `WsPhase`
+
+| Value           | Meaning                                                                                          |
+| --------------- | ------------------------------------------------------------------------------------------------ |
+| `idle`          | Not connected, no reconnect scheduled (initial or manual `disconnect()`)                         |
+| `connecting`    | First connect or manual `connect()` in progress                                                  |
+| `open`          | Connected                                                                                        |
+| `reconnecting`  | Auto-reconnect cycle (waiting for timer or connecting); pair with `status`, `reconnectAttempt`   |
+| `stopped`       | Will not auto-reconnect; use `reconnectExhausted` to distinguish max retries vs reconnect disabled |
+
+`status` and `phase` often change together but mean different things. For example, `phase === "reconnecting"` with `status === "closed"` means waiting for the reconnect timer; `status === "connecting"` means the timer fired and a connect attempt is in progress.
+
 **Tip:** use a selector to subscribe to only the fields you need.
 
 ```tsx
+const phase = useWsStore((s) => s.phase);
 const status = useWsStore((s) => s.status);
+
+// Manual connect: only when idle or stopped
+const canConnect = phase === "idle" || phase === "stopped";
+// Intentional disconnect: while connected or in a connect/reconnect attempt
+const canDisconnect =
+  phase === "open" || phase === "connecting" || phase === "reconnecting";
 ```
 
 ---
@@ -292,7 +315,8 @@ From the main `react-ws-context` entry:
 | `CreateWsContextOptions` | Options for `createWsContext`                         |
 | `WsContextValue`         | Return type of `useWsActions()`                       |
 | `WsEvents`               | Event name → handler map                              |
-| `WsStatus`               | Connection lifecycle status                           |
+| `WsStatus`               | WebSocket connection state (`WsState`)                |
+| `WsPhase`                | Provider connection intent / reconnect phase (`WsState`) |
 | `WsState`                | Subscribable store shape (health / queue / reconnect) |
 
 ---
@@ -330,7 +354,7 @@ import {
 | Topic            | Notes                                                                          |
 | ---------------- | ------------------------------------------------------------------------------ |
 | Immutable config | `url`, `reconnectMs`, etc. are fixed at create time                            |
-| Reconnect        | Fixed interval only; no exponential backoff or max retries yet                 |
+| Reconnect        | Fixed interval only; no exponential backoff; optional cap via `reconnectMax` |
 | SSR              | No `WebSocket` on the server; `connect()` is a no-op without `window`          |
 | Error status     | No `"error"` in `WsStatus`; use `useWsEvents("error")`                         |
 | `WsState` scope  | Health / queue / reconnect only — not messages or app data                     |

package/README.zh-TW.md

@@ -93,7 +93,7 @@ createWsContext(options)
 ```
 
 - **同一應用可多次呼叫 `createWsContext`**，每次產生一組互不共用的 Provider 與 hooks（例如同時連業務 WS 與通知 WS）。
-- **`WsState` 只放連線層、低頻欄位** — 連線健康（如 `status`）、outbound 佇列（如未來 `pendingCount`）、重連（`reconnectAttempt`）。**不放**訊息 payload 或業務資料。
+- **`WsState` 只放連線層、低頻欄位** — 連線健康（`status`、`phase`）、outbound 佇列（如未來 `pendingCount`）、重連（`reconnectAttempt`）。**不放**訊息 payload 或業務資料。
 - **訊息與錯誤事件** — 請用 `useWsEvents`；訊息歷史請自行寫入 state、cache 或外部 store。
 - **連線錯誤不反映在 `WsStatus`** — 請用 `useWsEvents("error", …)` 處理；原生 `error` 事件後通常緊接 `close`。
 
@@ -182,6 +182,8 @@ useWsStore<T>(selector: (state: WsState) => T): T
 ```ts
 interface WsState {
   status: WsStatus;
+  /** Provider 連線意圖與重連策略階段；與 `status` 正交 */
+  phase: WsPhase;
   /** 本輪已排程的自動重連次數（意外斷線當下 +1，非重連成功才 +1） */
   reconnectAttempt: number;
   /** 本輪自動重連已達 `reconnectMax` 且最後一次也失敗；`connect()` / `disconnect()` 歸 `false` */
@@ -191,9 +193,9 @@ interface WsState {
 }
 ```
 
-| 適合放進 store                                                                                         | 不適合                                |
-| ------------------------------------------------------------------------------------------------------ | ------------------------------------- |
-| `status`、重連進度（`reconnectAttempt` / `reconnectExhausted`）、待送佇列長度、探活／stall 等連線健康摘要 | `lastMessage`、訊息歷史、業務 payload |
+| 適合放進 store                                                                                                        | 不適合                                |
+| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
+| `status`、`phase`、重連進度（`reconnectAttempt` / `reconnectExhausted`）、待送佇列長度、探活／stall 等連線健康摘要 | `lastMessage`、訊息歷史、業務 payload |
 
 `CreateWsContextOptions`（如 `url`、`reconnectMax`）在 `createWsContext` 時凍結，**不在** `WsState`；UI 若需顯示 `n/max` 請自行保存設定值，或訂閱時與 store 欄位組合。
 
@@ -206,10 +208,31 @@ interface WsState {
 | `open`       | 已連線   |
 | `closed`     | 已斷線   |
 
+反映 WebSocket 當下的連線狀態（類似 readyState 映射）。**不含**「是否在自動重連週期」「是否為使用者主動斷線」等 provider 意圖——請搭配 `phase`。
+
+#### `WsPhase`
+
+| 值              | 意義                                                                 |
+| --------------- | -------------------------------------------------------------------- |
+| `idle`          | 未連線、未排程重連（初始或手動 `disconnect()`）                    |
+| `connecting`    | 首次或手動 `connect()` 連線中                                        |
+| `open`          | 已連線                                                               |
+| `reconnecting`  | 自動重連週期（等待計時器或連線中）；搭配 `status`、`reconnectAttempt` |
+| `stopped`       | 不會再自動重連；`reconnectExhausted` 區分達上限或未啟用重連        |
+
+`status` 與 `phase` 常同時變化，但語意不同。例如 `phase === "reconnecting"` 且 `status === "closed"` 表示正在等待重連計時器；`status === "connecting"` 則表示計時器已觸發、正在嘗試連線。
+
 **建議：** 以 selector 只訂閱需要的欄位；state 擴充後可避免不必要的重繪。
 
 ```tsx
+const phase = useWsStore((s) => s.phase);
 const status = useWsStore((s) => s.status);
+
+// 手動連線：閒置或已停止時才可點
+const canConnect = phase === "idle" || phase === "stopped";
+// 主動斷線：連線中或重連週期內才可點
+const canDisconnect =
+  phase === "open" || phase === "connecting" || phase === "reconnecting";
 ```
 
 ---
@@ -292,7 +315,8 @@ createWsContext({
 | `CreateWsContextOptions` | `createWsContext` 的選項                           |
 | `WsContextValue`         | `useWsActions()` 回傳型別                          |
 | `WsEvents`               | 事件名稱與 handler 的型別對應                      |
-| `WsStatus`               | 連線生命週期狀態聯集（`WsState` 的一環）           |
+| `WsStatus`               | WebSocket 連線狀態（`WsState` 的一環）             |
+| `WsPhase`                | Provider 連線意圖與重連策略階段（`WsState` 的一環） |
 | `WsState`                | 可訂閱 store 的 state 形狀（連線健康／佇列／重連） |
 
 ---
@@ -343,7 +367,7 @@ sendJson(createStallMessage("stall"));
 | 項目           | 說明                                                                                       |
 | -------------- | ------------------------------------------------------------------------------------------ |
 | 設定不可變     | `url`、`reconnectMs` 等建立後固定；需換 URL 請另建 context 或手動 `disconnect` + `connect` |
-| 重連策略       | 固定間隔，無 exponential backoff、無最大重試次數                                           |
+| 重連策略       | 固定間隔，無 exponential backoff；`reconnectMax > 0` 可限制次數 |
 | SSR            | 不在 server 建立 `WebSocket`；`connect()` 在 `window` 不存在時為 no-op                     |
 | 錯誤狀態       | 不設 `"error"` status；請監聽 `useWsEvents("error")`                                       |
 | `WsState` 範圍 | 只含連線健康／佇列／重連；訊息與業務資料不走 store                                         |

package/dist/index.d.mts

@@ -11,6 +11,18 @@ import { PropsWithChildren } from "react";
  * 錯誤用 `useWsEvents("error")`；不另設 error status。
  */
 type WsStatus = "idle" | "connecting" | "open" | "closed";
+/**
+ * Provider 連線意圖與重連策略階段（`WsState` 的一環）。
+ *
+ * 與 `status`（WebSocket readyState 映射）正交，補足 UI 無法單靠 `status` 判斷的情境。
+ *
+ * - `idle` — 未連線、未排程重連（初始或手動 `disconnect()`）
+ * - `connecting` — 首次或手動 `connect()` 連線中
+ * - `open` — 已連線
+ * - `reconnecting` — 自動重連週期（等待計時器或連線中）；細節搭配 `status`、`reconnectAttempt`
+ * - `stopped` — 不會再自動重連；`reconnectExhausted` 區分達上限或未啟用重連
+ */
+type WsPhase = "idle" | "connecting" | "open" | "reconnecting" | "stopped";
 /**
  * 可訂閱的連線層 state（低頻更新）。
  *
@@ -23,6 +35,8 @@ type WsStatus = "idle" | "connecting" | "open" | "closed";
 type WsState = {
   /** 連線生命週期狀態 */
   status: WsStatus;
+  /** Provider 連線意圖與重連策略階段 */
+  phase: WsPhase;
   /**
    * 本輪已排程的自動重連次數（意外斷線當下 +1，非重連成功才 +1）。
    *
@@ -152,5 +166,5 @@ declare function createWsContext(options: CreateWsContextOptions): {
   useWsEvents: <E extends keyof WsEvents>(type: E, handler: WsEvents[E]) => void;
 };
 //#endregion
-export { type CreateWsContextOptions, type WsContextValue, type WsEvents, type WsState, type WsStatus, createWsContext };
+export { type CreateWsContextOptions, type WsContextValue, type WsEvents, type WsPhase, type WsState, type WsStatus, createWsContext };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/ws-context/ws-store.ts","../src/ws-context/liveness/types.ts","../src/ws-context/types.ts","../src/ws-context/index.tsx"],"mappings":";;;;;;;;;;;;KAcY;;;;;;;;;;KAWA;;EAEV,QAAQ;;;;;;;;EAQR;;;;;;EAMA;;;;;UCxCe;;EAEf;;EAEA;;EAEA;;EAEA,SAAS;;;;;UCLM;;EAEf;;EAEA;;;;;;EAMA;;;;;;EAMA;;;;;;;;;EASA;;;;;;EAMA;;;;;;EAMA,SAAS,MAAM;;EAEf,WAAW;;UAGI;;;;;;;EAOf,UAAU,eAAe,OAAO;;EAEhC,OAAO,OAAO;;EAEd,QAAQ,OAAO;;EAEf,QAAQ,OAAO;;;UAIA;;;;;;;EAOf,OAAO,MAAM,WAAW;;;;;;;EAOxB,WAAW;;EAEX;;EAEA;;EAEA,iBAAiB;;;;;;;;;;;iBC3CH,gBAAgB,SAAS;EAmBL,eAAA,YAAA,sCAAiB,IAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/ws-context/ws-store.ts","../src/ws-context/liveness/types.ts","../src/ws-context/types.ts","../src/ws-context/index.tsx"],"mappings":";;;;;;;;;;;;KAcY;;;;;;;;;;;;KAaA;;;;;;;;;;KAgBA;;EAEV,QAAQ;;EAER,OAAO;;;;;;;;EAQP;;;;;;EAMA;;;;;UC5De;;EAEf;;EAEA;;EAEA;;EAEA,SAAS;;;;;UCLM;;EAEf;;EAEA;;;;;;EAMA;;;;;;EAMA;;;;;;;;;EASA;;;;;;EAMA;;;;;;EAMA,SAAS,MAAM;;EAEf,WAAW;;UAGI;;;;;;;EAOf,UAAU,eAAe,OAAO;;EAEhC,OAAO,OAAO;;EAEd,QAAQ,OAAO;;EAEf,QAAQ,OAAO;;;UAIA;;;;;;;EAOf,OAAO,MAAM,WAAW;;;;;;;EAOxB,WAAW;;EAEX;;EAEA;;EAEA,iBAAiB;;;;;;;;;;;iBC1CH,gBAAgB,SAAS;EAmBL,eAAA,YAAA,sCAAiB,IAAA"}

package/dist/index.mjs

@@ -183,6 +183,7 @@ function useStore(store, selector) {
 function createWsStore(init = "idle") {
 	return createStore({
 		status: init,
+		phase: init === "open" ? "open" : init === "idle" ? "idle" : "connecting",
 		reconnectAttempt: 0,
 		reconnectExhausted: false
 	});
@@ -238,8 +239,10 @@ function createReconnect(reconnectMs, reconnectMax, callbacks) {
 		onConnectBegin() {
 			clearTimer();
 			intentionalClose = false;
+			const reconnecting = fromTimer;
 			if (!fromTimer) resetCycle();
 			fromTimer = false;
+			return reconnecting;
 		},
 		onOpen() {
 			resetCycle();
@@ -328,11 +331,15 @@ function createWsContext(options) {
 		const setStatus = useCallback((status) => {
 			store.setState({ status });
 		}, [store]);
+		const setPhase = useCallback((phase) => {
+			store.setState({ phase });
+		}, [store]);
 		const getStatus = useCallback(() => store.getState().status, [store]);
 		const disconnect = useCallback(() => {
 			reconnect.cancel();
 			livenessSession.stop();
 			outgoingQueue.clear();
+			setPhase("idle");
 			const ws = wsRef.current;
 			wsRef.current = null;
 			if (ws) {
@@ -342,6 +349,7 @@ function createWsContext(options) {
 			} else setStatus("closed");
 		}, [
 			setStatus,
+			setPhase,
 			emitter,
 			outgoingQueue,
 			livenessSession,
@@ -349,7 +357,7 @@ function createWsContext(options) {
 		]);
 		const connect = useCallback(() => {
 			if (typeof window === "undefined") return;
-			reconnect.onConnectBegin();
+			const fromReconnect = reconnect.onConnectBegin();
 			livenessSession.stop();
 			const prev = wsRef.current;
 			if (prev) {
@@ -358,12 +366,14 @@ function createWsContext(options) {
 				emitter.emit("close", clientCloseEvent("reconnect"));
 			}
 			setStatus("connecting");
+			setPhase(fromReconnect ? "reconnecting" : "connecting");
 			const ws = protocols ? new WebSocket(url, protocols) : new WebSocket(url);
 			wsRef.current = ws;
 			ws.onopen = (event) => {
 				if (wsRef.current !== ws) return;
 				reconnect.onOpen();
 				setStatus("open");
+				setPhase("open");
 				outgoingQueue.flush((data) => ws.send(data));
 				livenessSession.start(ws);
 				emitter.emit("open", event);
@@ -383,14 +393,17 @@ function createWsContext(options) {
 				livenessSession.stop();
 				setStatus("closed");
 				emitter.emit("close", event);
-				reconnect.scheduleAfterClose();
+				if (reconnect.scheduleAfterClose()) setPhase("reconnecting");
+				else if (store.getState().phase !== "idle") setPhase("stopped");
 			};
 		}, [
 			setStatus,
+			setPhase,
 			emitter,
 			outgoingQueue,
 			livenessSession,
-			reconnect
+			reconnect,
+			store
 		]);
 		reconnect.bindOnReconnect(connect);
 		useEffect(() => {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/ws-context/emitter.ts","../src/ws-context/ws-events.ts","../src/ws-context/liveness/resolve-ping.ts","../src/ws-context/liveness/controller.ts","../src/ws-context/liveness/liveness.ts","../src/ws-context/outgoing-queue.ts","../src/ws-context/store.ts","../src/ws-context/use-store.ts","../src/ws-context/ws-store.ts","../src/ws-context/ws-actions.ts","../src/ws-context/reconnect.ts","../src/ws-context/socket.ts","../src/ws-context/index.tsx"],"sourcesContent":["// Typed event emitter。\n// 執行期邏輯對齊 nanoevents 的 createNanoEvents（幾乎逐行相同）；型別為本套件收斂版。\n// Project: nanoevents — https://github.com/ai/nanoevents\n// Author: Andrey Sitnik — https://github.com/ai\n// License: MIT — https://github.com/ai/nanoevents/blob/main/LICENSE\n// Source:\n//   - https://github.com/ai/nanoevents/blob/main/index.js\n//   - https://github.com/ai/nanoevents/blob/main/index.d.ts\n// Modifications: 內嵌以達成零 runtime 依賴；新增 useEmitter（React useState 包裝）。\n\nimport { useState } from \"react\";\n\nexport interface Emitter<\n  Events extends { [E in keyof Events]: (...args: never[]) => void },\n> {\n  events: { [E in keyof Events]?: Array<Events[E]> };\n  emit<E extends keyof Events>(event: E, ...args: Parameters<Events[E]>): void;\n  on<E extends keyof Events>(event: E, cb: Events[E]): () => void;\n}\n\nexport function createEmitter<\n  Events extends { [E in keyof Events]: (...args: never[]) => void },\n>(): Emitter<Events> {\n  return {\n    events: {},\n    emit(event, ...args) {\n      const callbacks = this.events[event] || [];\n      for (let i = 0, len = callbacks.length; i < len; i++) {\n        callbacks[i]!(...args);\n      }\n    },\n    on(event, cb) {\n      (this.events[event] ||= []).push(cb);\n      return () => {\n        this.events[event] = this.events[event]?.filter((fn) => fn !== cb);\n      };\n    },\n  };\n}\n\nexport function useEmitter<\n  Events extends { [E in keyof Events]: (...args: never[]) => void },\n>(): Emitter<Events> {\n  const [emitter] = useState(() => createEmitter<Events>());\n  return emitter;\n}\n","import {\n  createContext,\n  useContext,\n  useEffect,\n  useRef,\n  type Context,\n} from \"react\";\nimport type { Emitter } from \"./emitter\";\nimport type { WsEvents } from \"./types\";\n\nexport function createWsEventsContext() {\n  return createContext<Emitter<WsEvents> | null>(null);\n}\n\nexport function createUseWsEvents(\n  EmitterCtx: Context<Emitter<WsEvents> | null>,\n) {\n  function useWsEvents<E extends keyof WsEvents>(\n    type: E,\n    handler: WsEvents[E],\n  ): void {\n    const emitter = useContext(EmitterCtx);\n    if (!emitter) {\n      throw new Error(\"useWsEvents 必須包在對應的 WsProvider 內\");\n    }\n\n    const handlerRef = useRef(handler);\n    handlerRef.current = handler;\n\n    useEffect(() => {\n      return emitter.on(type, ((...args: never[]) => {\n        (handlerRef.current as (...a: never[]) => void)(...args);\n      }) as WsEvents[E]);\n    }, [type, emitter]);\n  }\n\n  return useWsEvents;\n}\n","import type { LivenessOptions } from \"./types\";\n\nexport function resolvePingPayload(ping: LivenessOptions[\"ping\"]): unknown {\n  return typeof ping === \"function\" ? ping() : ping;\n}\n","import { resolvePingPayload } from \"./resolve-ping\";\nimport type { LivenessOptions } from \"./types\";\n\nexport interface LivenessController {\n  /** 開始探活 */\n  start: (sendPing: () => void) => void;\n  /** 停止探活 */\n  stop: () => void;\n  /** 收到訊息 */\n  onMessage: (data: unknown) => void;\n}\n\nexport function createLivenessController(\n  options: LivenessOptions,\n  onTimeout: () => void,\n): LivenessController {\n  const { intervalMs, timeoutMs, isPong } = options;\n\n  let intervalId: ReturnType<typeof setInterval> | null = null;\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let sendPingRef: (() => void) | null = null;\n\n  function clearTimeoutTimer(): void {\n    if (timeoutId != null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  }\n\n  function armTimeout(): void {\n    clearTimeoutTimer();\n    timeoutId = setTimeout(onTimeout, timeoutMs);\n  }\n\n  function tick(): void {\n    sendPingRef?.();\n    armTimeout();\n  }\n\n  return {\n    start(sendPing) {\n      sendPingRef = sendPing;\n      tick();\n      intervalId = setInterval(tick, intervalMs);\n    },\n\n    stop() {\n      if (intervalId != null) {\n        clearInterval(intervalId);\n        intervalId = null;\n      }\n      clearTimeoutTimer();\n      sendPingRef = null;\n    },\n\n    onMessage(data) {\n      if (isPong(data)) clearTimeoutTimer();\n    },\n  };\n}\n\nexport function createPingSender(\n  ping: LivenessOptions[\"ping\"],\n  sendJson: (data: unknown) => boolean,\n): () => void {\n  return () => {\n    sendJson(resolvePingPayload(ping));\n  };\n}\n","import { useState } from \"react\";\nimport {\n  createLivenessController,\n  createPingSender,\n  type LivenessController,\n} from \"./controller\";\nimport type { LivenessOptions } from \"./types\";\n\nexport interface Liveness {\n  /** 開始探活 */\n  start: (ws: WebSocket) => void;\n  /** 停止探活 */\n  stop: () => void;\n  /** 收到訊息 */\n  onMessage: (data: unknown) => void;\n}\n\nconst DISABLED_LIVENESS: Liveness = {\n  start() {},\n  stop() {},\n  onMessage() {},\n};\n\nexport function createLiveness(\n  options: LivenessOptions,\n  getActiveSocket: () => WebSocket | null,\n): Liveness {\n  let controller: LivenessController | null = null;\n\n  return {\n    start(ws) {\n      controller?.stop();\n      controller = createLivenessController(options, () => {\n        const current = getActiveSocket();\n        if (current?.readyState === WebSocket.OPEN) current.close();\n      });\n      const sendPing = createPingSender(options.ping, (data) => {\n        if (ws.readyState !== WebSocket.OPEN) return false;\n        ws.send(JSON.stringify(data));\n        return true;\n      });\n      controller.start(sendPing);\n    },\n\n    stop() {\n      controller?.stop();\n      controller = null;\n    },\n\n    onMessage(data) {\n      controller?.onMessage(data);\n    },\n  };\n}\n\nexport function useLiveness(\n  options: LivenessOptions | undefined,\n  getActiveSocket: () => WebSocket | null,\n): Liveness {\n  const [session] = useState(() =>\n    options ? createLiveness(options, getActiveSocket) : DISABLED_LIVENESS,\n  );\n  return session;\n}\n","import { useState } from \"react\";\n\nexport type OutgoingData = Parameters<WebSocket[\"send\"]>[0];\n\nexport interface OutgoingQueue {\n  /** 列隊 */\n  enqueue: (data: OutgoingData) => boolean;\n  /** 清空 */\n  clear: () => void;\n  /** 依序送出後清空 */\n  flush: (send: (data: OutgoingData) => void) => void;\n}\n\nexport function createOutgoingQueue(max: number): OutgoingQueue {\n  let items: OutgoingData[] = [];\n\n  return {\n    enqueue(data) {\n      if (max <= 0 || items.length >= max) return false;\n      items.push(data);\n      return true;\n    },\n    clear() {\n      items = [];\n    },\n    flush(send) {\n      const queued = items;\n      items = [];\n      for (const data of queued) send(data);\n    },\n  };\n}\n\nexport function useOutgoingQueue(max: number): OutgoingQueue {\n  const [queue] = useState(() => createOutgoingQueue(max));\n  return queue;\n}\n","// 精簡外部 store：只保留本套件需要的 getState / setState / subscribe / getInitialState。\n// 靈感與行為對齊 zustand/vanilla（非完整搬移；無 middleware、無 replace、無 initializer factory）。\n// Project: zustand — https://github.com/pmndrs/zustand\n// Author: pmndrs (Poimandres) — https://github.com/pmndrs\n// License: MIT — https://github.com/pmndrs/zustand/blob/main/LICENSE\n// Source: https://github.com/pmndrs/zustand/blob/main/src/vanilla.ts\n// Modifications: 內嵌子集以達成零 runtime 依賴。\n\nexport type StoreApi<State> = {\n  getState: () => State;\n  getInitialState: () => State;\n  setState: (\n    partial: Partial<State> | ((state: State) => Partial<State>),\n  ) => void;\n  subscribe: (listener: (state: State, prev: State) => void) => () => void;\n};\n\nexport function createStore<State extends object>(\n  initialState: State,\n): StoreApi<State> {\n  let state = initialState;\n  const listeners = new Set<(state: State, prev: State) => void>();\n\n  return {\n    getState: () => state,\n    getInitialState: () => initialState,\n    setState: (partial) => {\n      const nextPartial =\n        typeof partial === \"function\" ? partial(state) : partial;\n      if (Object.is(nextPartial, state)) return;\n      const prev = state;\n      state = Object.assign({}, state, nextPartial);\n      for (const listener of listeners) listener(state, prev);\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n","// 訂閱外部 store（selector + useSyncExternalStore）。\n// 靈感來自 zustand/react 的 useStore（非完整搬移；selector 必填、無 useDebugValue）。\n// Project: zustand — https://github.com/pmndrs/zustand\n// Author: pmndrs (Poimandres) — https://github.com/pmndrs\n// License: MIT — https://github.com/pmndrs/zustand/blob/main/LICENSE\n// Source: https://github.com/pmndrs/zustand/blob/main/src/react.ts\n// Modifications: 內嵌以達成零 runtime 依賴。\n// 用途：訂閱 WsState（連線健康／佇列／重連）；訊息不走此 store。\n\nimport { useSyncExternalStore } from \"react\";\nimport type { StoreApi } from \"./store\";\n\nexport function useStore<State, Selected>(\n  store: StoreApi<State>,\n  selector: (state: State) => Selected,\n): Selected {\n  return useSyncExternalStore(\n    store.subscribe,\n    () => selector(store.getState()),\n    () => selector(store.getInitialState()),\n  );\n}\n","import { createContext, useContext, useState, type Context } from \"react\";\nimport { createStore, type StoreApi } from \"./store\";\nimport { useStore } from \"./use-store\";\n\n/**\n * 連線生命週期狀態（`WsState` 的一環）。\n *\n * - `idle` — 尚未連線\n * - `connecting` — 連線中\n * - `open` — 已連線\n * - `closed` — 已斷線\n *\n * 錯誤用 `useWsEvents(\"error\")`；不另設 error status。\n */\nexport type WsStatus = \"idle\" | \"connecting\" | \"open\" | \"closed\";\n\n/**\n * 可訂閱的連線層 state（低頻更新）。\n *\n * 只放：**連線健康**、**outbound 佇列**、**重連** 等連線生命週期資訊。\n *\n * 不放：訊息 payload、訊息歷史、業務資料（請用 `useWsEvents` 或自行管理 state）。\n *\n * 未來可能擴充例如 `pendingCount`；新增欄位時請維持低頻、可 selector 訂閱。\n */\nexport type WsState = {\n  /** 連線生命週期狀態 */\n  status: WsStatus;\n  /**\n   * 本輪已排程的自動重連次數（意外斷線當下 +1，非重連成功才 +1）。\n   *\n   * 顯示為 `n` 時，代表第 `n` 次重連已排程或進行中。\n   *\n   * 成功 `open`、手動 `connect()` 或主動 `disconnect()` 歸零。\n   */\n  reconnectAttempt: number;\n  /**\n   * 本輪自動重連已達 `reconnectMax` 且最後一次也失敗。\n   *\n   * 手動 `connect()` 或 `disconnect()` 設定為 `false`\n   */\n  reconnectExhausted: boolean;\n};\n\nexport type WsStoreApi = StoreApi<WsState>;\n\nexport function createWsStore(init: WsStatus = \"idle\"): WsStoreApi {\n  return createStore<WsState>({\n    status: init,\n    reconnectAttempt: 0,\n    reconnectExhausted: false,\n  });\n}\n\n/** 每個 `WsProvider` 各有一份 {@link WsState} store */\nexport function useWsStoreApi(): WsStoreApi {\n  const [store] = useState(() => createWsStore());\n  return store;\n}\n\nexport function createWsStoreContext() {\n  return createContext<WsStoreApi | null>(null);\n}\n\n/** 訂閱 {@link WsState}；建議以 selector 只取需要的連線層欄位。 */\nexport function createUseWsStore(StoreCtx: Context<WsStoreApi | null>) {\n  function useWsStore(): WsState;\n  function useWsStore<T>(selector: (state: WsState) => T): T;\n  function useWsStore<T>(selector?: (state: WsState) => T): T {\n    const store = useContext(StoreCtx);\n    if (!store) {\n      throw new Error(\"useWsStore 必須包在對應的 WsProvider 內\");\n    }\n    const select = selector ?? ((state: WsState) => state as T);\n    return useStore(store, select);\n  }\n\n  return useWsStore;\n}\n","import { createContext, useContext, type Context } from \"react\";\nimport type { WsContextValue } from \"./types\";\n\nexport function createWsActionsContext() {\n  return createContext<WsContextValue | null>(null);\n}\n\nexport function createUseWsActions(ActionsCtx: Context<WsContextValue | null>) {\n  function useWsActions(): WsContextValue {\n    const value = useContext(ActionsCtx);\n    if (!value) {\n      throw new Error(\"useWsActions 必須包在對應的 WsProvider 內\");\n    }\n    return value;\n  }\n\n  return useWsActions;\n}\n","import { useState } from \"react\";\n\nexport interface ReconnectCallbacks {\n  /** 讀取 store 的 `reconnectAttempt` */\n  getAttempt: () => number;\n  /** 寫入 store 的 `reconnectAttempt` */\n  setAttempt: (attempt: number) => void;\n  /** 寫入 store 的 `reconnectExhausted` */\n  setExhausted: (exhausted: boolean) => void;\n}\n\nexport interface Reconnect {\n  /** 開始連線時呼叫 */\n  onConnectBegin: () => void;\n  /** 連線成功時呼叫 */\n  onOpen: () => void;\n  /** 意外斷線後嘗試重連；有排重連回 `true` */\n  scheduleAfterClose: () => boolean;\n  /** 主動斷線或元件卸載時呼叫 */\n  cancel: () => void;\n  /** 設定重連時要執行的 connect */\n  bindOnReconnect: (fn: () => void) => void;\n}\n\nexport function createReconnect(\n  reconnectMs: number,\n  reconnectMax: number,\n  callbacks: ReconnectCallbacks,\n): Reconnect {\n  let intentionalClose = false;\n  let fromTimer = false;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let onReconnect = () => {};\n\n  const clearTimer = () => {\n    if (timer != null) {\n      clearTimeout(timer);\n      timer = null;\n    }\n  };\n\n  const resetCycle = () => {\n    if (callbacks.getAttempt() !== 0) callbacks.setAttempt(0);\n    callbacks.setExhausted(false);\n  };\n\n  return {\n    onConnectBegin() {\n      clearTimer();\n      intentionalClose = false;\n      if (!fromTimer) resetCycle();\n      fromTimer = false;\n    },\n\n    onOpen() {\n      resetCycle();\n    },\n\n    scheduleAfterClose() {\n      if (intentionalClose || reconnectMs <= 0) return false;\n      const attempt = callbacks.getAttempt();\n      if (reconnectMax > 0 && attempt >= reconnectMax) {\n        callbacks.setExhausted(true);\n        return false;\n      }\n      callbacks.setAttempt(attempt + 1);\n      fromTimer = true;\n      // 固定間隔重連，無 backoff；之後可換成指數退避\n      timer = setTimeout(() => {\n        timer = null;\n        onReconnect();\n      }, reconnectMs);\n      return true;\n    },\n\n    cancel() {\n      intentionalClose = true;\n      clearTimer();\n      resetCycle();\n    },\n\n    bindOnReconnect(fn) {\n      onReconnect = fn;\n    },\n  };\n}\n\nexport function useReconnect(\n  reconnectMs: number,\n  reconnectMax: number,\n  callbacks: ReconnectCallbacks,\n): Reconnect {\n  const [session] = useState(() =>\n    createReconnect(reconnectMs, reconnectMax, callbacks),\n  );\n  return session;\n}\n","export function detachAndClose(ws: WebSocket): void {\n  ws.onopen = null;\n  ws.onmessage = null;\n  ws.onerror = null;\n  ws.onclose = null;\n  if (ws.readyState < WebSocket.CLOSING) ws.close();\n}\n\nexport function clientCloseEvent(reason: string): CloseEvent {\n  return new CloseEvent(\"close\", {\n    code: 1000,\n    reason,\n    wasClean: true,\n  });\n}\n","import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  type PropsWithChildren,\n} from \"react\";\nimport { useEmitter } from \"./emitter\";\nimport { createUseWsEvents, createWsEventsContext } from \"./ws-events\";\nimport type { CreateWsContextOptions, WsContextValue, WsEvents } from \"./types\";\nimport { useLiveness } from \"./liveness/liveness\";\nimport { useOutgoingQueue } from \"./outgoing-queue\";\nimport {\n  createUseWsStore,\n  createWsStoreContext,\n  useWsStoreApi,\n  type WsStatus,\n} from \"./ws-store\";\nimport { createUseWsActions, createWsActionsContext } from \"./ws-actions\";\nimport { useReconnect } from \"./reconnect\";\nimport { clientCloseEvent, detachAndClose } from \"./socket\";\n\nexport type { CreateWsContextOptions, WsContextValue, WsEvents } from \"./types\";\n\nfunction defaultParse(data: MessageEvent[\"data\"]): unknown {\n  if (typeof data !== \"string\") return data;\n  try {\n    return JSON.parse(data) as unknown;\n  } catch {\n    return data;\n  }\n}\n\n/**\n * @example\n * ```ts\n * export const { WsProvider, useWsActions, useWsStore, useWsEvents } =\n *   createWsContext({ url: \"ws://localhost:8080\" });\n * ```\n */\nexport function createWsContext(options: CreateWsContextOptions) {\n  const {\n    url,\n    protocols,\n    autoConnect = true,\n    reconnectMs = 0,\n    reconnectMax = 0,\n    outgoingQueueMax = 0,\n    parse = defaultParse,\n    liveness,\n  } = options;\n\n  const ActionsCtx = createWsActionsContext();\n  const useWsActions = createUseWsActions(ActionsCtx);\n  const StoreCtx = createWsStoreContext();\n  const useWsStore = createUseWsStore(StoreCtx);\n  const EmitterCtx = createWsEventsContext();\n  const useWsEvents = createUseWsEvents(EmitterCtx);\n\n  function WsProvider({ children }: PropsWithChildren) {\n    const wsRef = useRef<WebSocket | null>(null);\n    const store = useWsStoreApi();\n    const emitter = useEmitter<WsEvents>();\n    const reconnect = useReconnect(reconnectMs, reconnectMax, {\n      getAttempt: () => store.getState().reconnectAttempt,\n      setAttempt: (reconnectAttempt) => store.setState({ reconnectAttempt }),\n      setExhausted: (reconnectExhausted) =>\n        store.setState({ reconnectExhausted }),\n    });\n    const outgoingQueue = useOutgoingQueue(outgoingQueueMax);\n    const livenessSession = useLiveness(liveness, () => wsRef.current);\n\n    const setStatus = useCallback(\n      (status: WsStatus) => {\n        store.setState({ status });\n      },\n      [store],\n    );\n\n    const getStatus = useCallback<WsContextValue[\"getStatus\"]>(\n      () => store.getState().status,\n      [store],\n    );\n\n    const disconnect = useCallback<WsContextValue[\"disconnect\"]>(() => {\n      reconnect.cancel();\n      livenessSession.stop();\n      outgoingQueue.clear();\n      const ws = wsRef.current;\n      wsRef.current = null;\n      if (ws) {\n        detachAndClose(ws);\n        setStatus(\"closed\");\n        emitter.emit(\"close\", clientCloseEvent(\"client disconnect\"));\n      } else {\n        setStatus(\"closed\");\n      }\n    }, [setStatus, emitter, outgoingQueue, livenessSession, reconnect]);\n\n    const connect = useCallback<WsContextValue[\"connect\"]>(() => {\n      if (typeof window === \"undefined\") return;\n\n      reconnect.onConnectBegin();\n      livenessSession.stop();\n\n      const prev = wsRef.current;\n      if (prev) {\n        wsRef.current = null;\n        detachAndClose(prev);\n        emitter.emit(\"close\", clientCloseEvent(\"reconnect\"));\n      }\n\n      setStatus(\"connecting\");\n\n      const ws = protocols ? new WebSocket(url, protocols) : new WebSocket(url);\n      wsRef.current = ws;\n\n      ws.onopen = (event) => {\n        if (wsRef.current !== ws) return;\n        reconnect.onOpen();\n        setStatus(\"open\");\n        outgoingQueue.flush((data) => ws.send(data));\n        livenessSession.start(ws);\n        emitter.emit(\"open\", event);\n      };\n\n      ws.onmessage = (event) => {\n        if (wsRef.current !== ws) return;\n        const data = parse(event.data);\n        livenessSession.onMessage(data);\n        emitter.emit(\"message\", data, event);\n      };\n\n      ws.onerror = (event) => {\n        if (wsRef.current !== ws) return;\n        emitter.emit(\"error\", event);\n      };\n\n      ws.onclose = (event) => {\n        if (wsRef.current === ws) wsRef.current = null;\n        livenessSession.stop();\n        setStatus(\"closed\");\n        emitter.emit(\"close\", event);\n        reconnect.scheduleAfterClose();\n      };\n    }, [setStatus, emitter, outgoingQueue, livenessSession, reconnect]);\n\n    reconnect.bindOnReconnect(connect);\n\n    useEffect(() => {\n      if (autoConnect) connect();\n      return () => {\n        reconnect.cancel();\n        livenessSession.stop();\n        outgoingQueue.clear();\n        const ws = wsRef.current;\n        wsRef.current = null;\n        if (ws) {\n          detachAndClose(ws);\n          emitter.emit(\"close\", clientCloseEvent(\"provider unmount\"));\n        }\n      };\n    }, [connect, emitter, outgoingQueue, livenessSession, reconnect]);\n\n    const send = useCallback<WsContextValue[\"send\"]>(\n      (data) => {\n        const ws = wsRef.current;\n        if (ws && ws.readyState === WebSocket.OPEN) {\n          ws.send(data);\n          return true;\n        }\n        return outgoingQueue.enqueue(data);\n      },\n      [outgoingQueue],\n    );\n\n    const sendJson = useCallback<WsContextValue[\"sendJson\"]>(\n      (data) => send(JSON.stringify(data)),\n      [send],\n    );\n\n    const actions = useMemo<WsContextValue>(\n      () => ({\n        send,\n        sendJson,\n        connect,\n        disconnect,\n        getStatus,\n      }),\n      [send, sendJson, connect, disconnect, getStatus],\n    );\n\n    return (\n      <ActionsCtx.Provider value={actions}>\n        <StoreCtx.Provider value={store}>\n          <EmitterCtx.Provider value={emitter}>{children}</EmitterCtx.Provider>\n        </StoreCtx.Provider>\n      </ActionsCtx.Provider>\n    );\n  }\n\n  return {\n    WsProvider,\n    useWsActions,\n    useWsStore,\n    useWsEvents,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/ws-context/emitter.ts","../src/ws-context/ws-events.ts","../src/ws-context/liveness/resolve-ping.ts","../src/ws-context/liveness/controller.ts","../src/ws-context/liveness/liveness.ts","../src/ws-context/outgoing-queue.ts","../src/ws-context/store.ts","../src/ws-context/use-store.ts","../src/ws-context/ws-store.ts","../src/ws-context/ws-actions.ts","../src/ws-context/reconnect.ts","../src/ws-context/socket.ts","../src/ws-context/index.tsx"],"sourcesContent":["// Typed event emitter。\n// 執行期邏輯對齊 nanoevents 的 createNanoEvents（幾乎逐行相同）；型別為本套件收斂版。\n// Project: nanoevents — https://github.com/ai/nanoevents\n// Author: Andrey Sitnik — https://github.com/ai\n// License: MIT — https://github.com/ai/nanoevents/blob/main/LICENSE\n// Source:\n//   - https://github.com/ai/nanoevents/blob/main/index.js\n//   - https://github.com/ai/nanoevents/blob/main/index.d.ts\n// Modifications: 內嵌以達成零 runtime 依賴；新增 useEmitter（React useState 包裝）。\n\nimport { useState } from \"react\";\n\nexport interface Emitter<\n  Events extends { [E in keyof Events]: (...args: never[]) => void },\n> {\n  events: { [E in keyof Events]?: Array<Events[E]> };\n  emit<E extends keyof Events>(event: E, ...args: Parameters<Events[E]>): void;\n  on<E extends keyof Events>(event: E, cb: Events[E]): () => void;\n}\n\nexport function createEmitter<\n  Events extends { [E in keyof Events]: (...args: never[]) => void },\n>(): Emitter<Events> {\n  return {\n    events: {},\n    emit(event, ...args) {\n      const callbacks = this.events[event] || [];\n      for (let i = 0, len = callbacks.length; i < len; i++) {\n        callbacks[i]!(...args);\n      }\n    },\n    on(event, cb) {\n      (this.events[event] ||= []).push(cb);\n      return () => {\n        this.events[event] = this.events[event]?.filter((fn) => fn !== cb);\n      };\n    },\n  };\n}\n\nexport function useEmitter<\n  Events extends { [E in keyof Events]: (...args: never[]) => void },\n>(): Emitter<Events> {\n  const [emitter] = useState(() => createEmitter<Events>());\n  return emitter;\n}\n","import {\n  createContext,\n  useContext,\n  useEffect,\n  useRef,\n  type Context,\n} from \"react\";\nimport type { Emitter } from \"./emitter\";\nimport type { WsEvents } from \"./types\";\n\nexport function createWsEventsContext() {\n  return createContext<Emitter<WsEvents> | null>(null);\n}\n\nexport function createUseWsEvents(\n  EmitterCtx: Context<Emitter<WsEvents> | null>,\n) {\n  function useWsEvents<E extends keyof WsEvents>(\n    type: E,\n    handler: WsEvents[E],\n  ): void {\n    const emitter = useContext(EmitterCtx);\n    if (!emitter) {\n      throw new Error(\"useWsEvents 必須包在對應的 WsProvider 內\");\n    }\n\n    const handlerRef = useRef(handler);\n    handlerRef.current = handler;\n\n    useEffect(() => {\n      return emitter.on(type, ((...args: never[]) => {\n        (handlerRef.current as (...a: never[]) => void)(...args);\n      }) as WsEvents[E]);\n    }, [type, emitter]);\n  }\n\n  return useWsEvents;\n}\n","import type { LivenessOptions } from \"./types\";\n\nexport function resolvePingPayload(ping: LivenessOptions[\"ping\"]): unknown {\n  return typeof ping === \"function\" ? ping() : ping;\n}\n","import { resolvePingPayload } from \"./resolve-ping\";\nimport type { LivenessOptions } from \"./types\";\n\nexport interface LivenessController {\n  /** 開始探活 */\n  start: (sendPing: () => void) => void;\n  /** 停止探活 */\n  stop: () => void;\n  /** 收到訊息 */\n  onMessage: (data: unknown) => void;\n}\n\nexport function createLivenessController(\n  options: LivenessOptions,\n  onTimeout: () => void,\n): LivenessController {\n  const { intervalMs, timeoutMs, isPong } = options;\n\n  let intervalId: ReturnType<typeof setInterval> | null = null;\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let sendPingRef: (() => void) | null = null;\n\n  function clearTimeoutTimer(): void {\n    if (timeoutId != null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  }\n\n  function armTimeout(): void {\n    clearTimeoutTimer();\n    timeoutId = setTimeout(onTimeout, timeoutMs);\n  }\n\n  function tick(): void {\n    sendPingRef?.();\n    armTimeout();\n  }\n\n  return {\n    start(sendPing) {\n      sendPingRef = sendPing;\n      tick();\n      intervalId = setInterval(tick, intervalMs);\n    },\n\n    stop() {\n      if (intervalId != null) {\n        clearInterval(intervalId);\n        intervalId = null;\n      }\n      clearTimeoutTimer();\n      sendPingRef = null;\n    },\n\n    onMessage(data) {\n      if (isPong(data)) clearTimeoutTimer();\n    },\n  };\n}\n\nexport function createPingSender(\n  ping: LivenessOptions[\"ping\"],\n  sendJson: (data: unknown) => boolean,\n): () => void {\n  return () => {\n    sendJson(resolvePingPayload(ping));\n  };\n}\n","import { useState } from \"react\";\nimport {\n  createLivenessController,\n  createPingSender,\n  type LivenessController,\n} from \"./controller\";\nimport type { LivenessOptions } from \"./types\";\n\nexport interface Liveness {\n  /** 開始探活 */\n  start: (ws: WebSocket) => void;\n  /** 停止探活 */\n  stop: () => void;\n  /** 收到訊息 */\n  onMessage: (data: unknown) => void;\n}\n\nconst DISABLED_LIVENESS: Liveness = {\n  start() {},\n  stop() {},\n  onMessage() {},\n};\n\nexport function createLiveness(\n  options: LivenessOptions,\n  getActiveSocket: () => WebSocket | null,\n): Liveness {\n  let controller: LivenessController | null = null;\n\n  return {\n    start(ws) {\n      controller?.stop();\n      controller = createLivenessController(options, () => {\n        const current = getActiveSocket();\n        if (current?.readyState === WebSocket.OPEN) current.close();\n      });\n      const sendPing = createPingSender(options.ping, (data) => {\n        if (ws.readyState !== WebSocket.OPEN) return false;\n        ws.send(JSON.stringify(data));\n        return true;\n      });\n      controller.start(sendPing);\n    },\n\n    stop() {\n      controller?.stop();\n      controller = null;\n    },\n\n    onMessage(data) {\n      controller?.onMessage(data);\n    },\n  };\n}\n\nexport function useLiveness(\n  options: LivenessOptions | undefined,\n  getActiveSocket: () => WebSocket | null,\n): Liveness {\n  const [session] = useState(() =>\n    options ? createLiveness(options, getActiveSocket) : DISABLED_LIVENESS,\n  );\n  return session;\n}\n","import { useState } from \"react\";\n\nexport type OutgoingData = Parameters<WebSocket[\"send\"]>[0];\n\nexport interface OutgoingQueue {\n  /** 列隊 */\n  enqueue: (data: OutgoingData) => boolean;\n  /** 清空 */\n  clear: () => void;\n  /** 依序送出後清空 */\n  flush: (send: (data: OutgoingData) => void) => void;\n}\n\nexport function createOutgoingQueue(max: number): OutgoingQueue {\n  let items: OutgoingData[] = [];\n\n  return {\n    enqueue(data) {\n      if (max <= 0 || items.length >= max) return false;\n      items.push(data);\n      return true;\n    },\n    clear() {\n      items = [];\n    },\n    flush(send) {\n      const queued = items;\n      items = [];\n      for (const data of queued) send(data);\n    },\n  };\n}\n\nexport function useOutgoingQueue(max: number): OutgoingQueue {\n  const [queue] = useState(() => createOutgoingQueue(max));\n  return queue;\n}\n","// 精簡外部 store：只保留本套件需要的 getState / setState / subscribe / getInitialState。\n// 靈感與行為對齊 zustand/vanilla（非完整搬移；無 middleware、無 replace、無 initializer factory）。\n// Project: zustand — https://github.com/pmndrs/zustand\n// Author: pmndrs (Poimandres) — https://github.com/pmndrs\n// License: MIT — https://github.com/pmndrs/zustand/blob/main/LICENSE\n// Source: https://github.com/pmndrs/zustand/blob/main/src/vanilla.ts\n// Modifications: 內嵌子集以達成零 runtime 依賴。\n\nexport type StoreApi<State> = {\n  getState: () => State;\n  getInitialState: () => State;\n  setState: (\n    partial: Partial<State> | ((state: State) => Partial<State>),\n  ) => void;\n  subscribe: (listener: (state: State, prev: State) => void) => () => void;\n};\n\nexport function createStore<State extends object>(\n  initialState: State,\n): StoreApi<State> {\n  let state = initialState;\n  const listeners = new Set<(state: State, prev: State) => void>();\n\n  return {\n    getState: () => state,\n    getInitialState: () => initialState,\n    setState: (partial) => {\n      const nextPartial =\n        typeof partial === \"function\" ? partial(state) : partial;\n      if (Object.is(nextPartial, state)) return;\n      const prev = state;\n      state = Object.assign({}, state, nextPartial);\n      for (const listener of listeners) listener(state, prev);\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n","// 訂閱外部 store（selector + useSyncExternalStore）。\n// 靈感來自 zustand/react 的 useStore（非完整搬移；selector 必填、無 useDebugValue）。\n// Project: zustand — https://github.com/pmndrs/zustand\n// Author: pmndrs (Poimandres) — https://github.com/pmndrs\n// License: MIT — https://github.com/pmndrs/zustand/blob/main/LICENSE\n// Source: https://github.com/pmndrs/zustand/blob/main/src/react.ts\n// Modifications: 內嵌以達成零 runtime 依賴。\n// 用途：訂閱 WsState（連線健康／佇列／重連）；訊息不走此 store。\n\nimport { useSyncExternalStore } from \"react\";\nimport type { StoreApi } from \"./store\";\n\nexport function useStore<State, Selected>(\n  store: StoreApi<State>,\n  selector: (state: State) => Selected,\n): Selected {\n  return useSyncExternalStore(\n    store.subscribe,\n    () => selector(store.getState()),\n    () => selector(store.getInitialState()),\n  );\n}\n","import { createContext, useContext, useState, type Context } from \"react\";\nimport { createStore, type StoreApi } from \"./store\";\nimport { useStore } from \"./use-store\";\n\n/**\n * 連線生命週期狀態（`WsState` 的一環）。\n *\n * - `idle` — 尚未連線\n * - `connecting` — 連線中\n * - `open` — 已連線\n * - `closed` — 已斷線\n *\n * 錯誤用 `useWsEvents(\"error\")`；不另設 error status。\n */\nexport type WsStatus = \"idle\" | \"connecting\" | \"open\" | \"closed\";\n\n/**\n * Provider 連線意圖與重連策略階段（`WsState` 的一環）。\n *\n * 與 `status`（WebSocket readyState 映射）正交，補足 UI 無法單靠 `status` 判斷的情境。\n *\n * - `idle` — 未連線、未排程重連（初始或手動 `disconnect()`）\n * - `connecting` — 首次或手動 `connect()` 連線中\n * - `open` — 已連線\n * - `reconnecting` — 自動重連週期（等待計時器或連線中）；細節搭配 `status`、`reconnectAttempt`\n * - `stopped` — 不會再自動重連；`reconnectExhausted` 區分達上限或未啟用重連\n */\nexport type WsPhase =\n  | \"idle\"\n  | \"connecting\"\n  | \"open\"\n  | \"reconnecting\"\n  | \"stopped\";\n\n/**\n * 可訂閱的連線層 state（低頻更新）。\n *\n * 只放：**連線健康**、**outbound 佇列**、**重連** 等連線生命週期資訊。\n *\n * 不放：訊息 payload、訊息歷史、業務資料（請用 `useWsEvents` 或自行管理 state）。\n *\n * 未來可能擴充例如 `pendingCount`；新增欄位時請維持低頻、可 selector 訂閱。\n */\nexport type WsState = {\n  /** 連線生命週期狀態 */\n  status: WsStatus;\n  /** Provider 連線意圖與重連策略階段 */\n  phase: WsPhase;\n  /**\n   * 本輪已排程的自動重連次數（意外斷線當下 +1，非重連成功才 +1）。\n   *\n   * 顯示為 `n` 時，代表第 `n` 次重連已排程或進行中。\n   *\n   * 成功 `open`、手動 `connect()` 或主動 `disconnect()` 歸零。\n   */\n  reconnectAttempt: number;\n  /**\n   * 本輪自動重連已達 `reconnectMax` 且最後一次也失敗。\n   *\n   * 手動 `connect()` 或 `disconnect()` 設定為 `false`\n   */\n  reconnectExhausted: boolean;\n};\n\nexport type WsStoreApi = StoreApi<WsState>;\n\nexport function createWsStore(init: WsStatus = \"idle\"): WsStoreApi {\n  const phase: WsPhase = init === \"open\" ? \"open\" : init === \"idle\" ? \"idle\" : \"connecting\";\n  return createStore<WsState>({\n    status: init,\n    phase,\n    reconnectAttempt: 0,\n    reconnectExhausted: false,\n  });\n}\n\n/** 每個 `WsProvider` 各有一份 {@link WsState} store */\nexport function useWsStoreApi(): WsStoreApi {\n  const [store] = useState(() => createWsStore());\n  return store;\n}\n\nexport function createWsStoreContext() {\n  return createContext<WsStoreApi | null>(null);\n}\n\n/** 訂閱 {@link WsState}；建議以 selector 只取需要的連線層欄位。 */\nexport function createUseWsStore(StoreCtx: Context<WsStoreApi | null>) {\n  function useWsStore(): WsState;\n  function useWsStore<T>(selector: (state: WsState) => T): T;\n  function useWsStore<T>(selector?: (state: WsState) => T): T {\n    const store = useContext(StoreCtx);\n    if (!store) {\n      throw new Error(\"useWsStore 必須包在對應的 WsProvider 內\");\n    }\n    const select = selector ?? ((state: WsState) => state as T);\n    return useStore(store, select);\n  }\n\n  return useWsStore;\n}\n","import { createContext, useContext, type Context } from \"react\";\nimport type { WsContextValue } from \"./types\";\n\nexport function createWsActionsContext() {\n  return createContext<WsContextValue | null>(null);\n}\n\nexport function createUseWsActions(ActionsCtx: Context<WsContextValue | null>) {\n  function useWsActions(): WsContextValue {\n    const value = useContext(ActionsCtx);\n    if (!value) {\n      throw new Error(\"useWsActions 必須包在對應的 WsProvider 內\");\n    }\n    return value;\n  }\n\n  return useWsActions;\n}\n","import { useState } from \"react\";\n\nexport interface ReconnectCallbacks {\n  /** 讀取 store 的 `reconnectAttempt` */\n  getAttempt: () => number;\n  /** 寫入 store 的 `reconnectAttempt` */\n  setAttempt: (attempt: number) => void;\n  /** 寫入 store 的 `reconnectExhausted` */\n  setExhausted: (exhausted: boolean) => void;\n}\n\nexport interface Reconnect {\n  /** 開始連線時呼叫；回傳 `true` 表示由重連計時器觸發 */\n  onConnectBegin: () => boolean;\n  /** 連線成功時呼叫 */\n  onOpen: () => void;\n  /** 意外斷線後嘗試重連；有排重連回 `true` */\n  scheduleAfterClose: () => boolean;\n  /** 主動斷線或元件卸載時呼叫 */\n  cancel: () => void;\n  /** 設定重連時要執行的 connect */\n  bindOnReconnect: (fn: () => void) => void;\n}\n\nexport function createReconnect(\n  reconnectMs: number,\n  reconnectMax: number,\n  callbacks: ReconnectCallbacks,\n): Reconnect {\n  let intentionalClose = false;\n  let fromTimer = false;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let onReconnect = () => {};\n\n  const clearTimer = () => {\n    if (timer != null) {\n      clearTimeout(timer);\n      timer = null;\n    }\n  };\n\n  const resetCycle = () => {\n    if (callbacks.getAttempt() !== 0) callbacks.setAttempt(0);\n    callbacks.setExhausted(false);\n  };\n\n  return {\n    onConnectBegin() {\n      clearTimer();\n      intentionalClose = false;\n      const reconnecting = fromTimer;\n      if (!fromTimer) resetCycle();\n      fromTimer = false;\n      return reconnecting;\n    },\n\n    onOpen() {\n      resetCycle();\n    },\n\n    scheduleAfterClose() {\n      if (intentionalClose || reconnectMs <= 0) return false;\n      const attempt = callbacks.getAttempt();\n      if (reconnectMax > 0 && attempt >= reconnectMax) {\n        callbacks.setExhausted(true);\n        return false;\n      }\n      callbacks.setAttempt(attempt + 1);\n      fromTimer = true;\n      // 固定間隔重連，無 backoff；之後可換成指數退避\n      timer = setTimeout(() => {\n        timer = null;\n        onReconnect();\n      }, reconnectMs);\n      return true;\n    },\n\n    cancel() {\n      intentionalClose = true;\n      clearTimer();\n      resetCycle();\n    },\n\n    bindOnReconnect(fn) {\n      onReconnect = fn;\n    },\n  };\n}\n\nexport function useReconnect(\n  reconnectMs: number,\n  reconnectMax: number,\n  callbacks: ReconnectCallbacks,\n): Reconnect {\n  const [session] = useState(() =>\n    createReconnect(reconnectMs, reconnectMax, callbacks),\n  );\n  return session;\n}\n","export function detachAndClose(ws: WebSocket): void {\n  ws.onopen = null;\n  ws.onmessage = null;\n  ws.onerror = null;\n  ws.onclose = null;\n  if (ws.readyState < WebSocket.CLOSING) ws.close();\n}\n\nexport function clientCloseEvent(reason: string): CloseEvent {\n  return new CloseEvent(\"close\", {\n    code: 1000,\n    reason,\n    wasClean: true,\n  });\n}\n","import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  type PropsWithChildren,\n} from \"react\";\nimport { useEmitter } from \"./emitter\";\nimport { createUseWsEvents, createWsEventsContext } from \"./ws-events\";\nimport type { CreateWsContextOptions, WsContextValue, WsEvents } from \"./types\";\nimport { useLiveness } from \"./liveness/liveness\";\nimport { useOutgoingQueue } from \"./outgoing-queue\";\nimport {\n  createUseWsStore,\n  createWsStoreContext,\n  useWsStoreApi,\n  type WsPhase,\n  type WsStatus,\n} from \"./ws-store\";\nimport { createUseWsActions, createWsActionsContext } from \"./ws-actions\";\nimport { useReconnect } from \"./reconnect\";\nimport { clientCloseEvent, detachAndClose } from \"./socket\";\n\nexport type { CreateWsContextOptions, WsContextValue, WsEvents } from \"./types\";\n\nfunction defaultParse(data: MessageEvent[\"data\"]): unknown {\n  if (typeof data !== \"string\") return data;\n  try {\n    return JSON.parse(data) as unknown;\n  } catch {\n    return data;\n  }\n}\n\n/**\n * @example\n * ```ts\n * export const { WsProvider, useWsActions, useWsStore, useWsEvents } =\n *   createWsContext({ url: \"ws://localhost:8080\" });\n * ```\n */\nexport function createWsContext(options: CreateWsContextOptions) {\n  const {\n    url,\n    protocols,\n    autoConnect = true,\n    reconnectMs = 0,\n    reconnectMax = 0,\n    outgoingQueueMax = 0,\n    parse = defaultParse,\n    liveness,\n  } = options;\n\n  const ActionsCtx = createWsActionsContext();\n  const useWsActions = createUseWsActions(ActionsCtx);\n  const StoreCtx = createWsStoreContext();\n  const useWsStore = createUseWsStore(StoreCtx);\n  const EmitterCtx = createWsEventsContext();\n  const useWsEvents = createUseWsEvents(EmitterCtx);\n\n  function WsProvider({ children }: PropsWithChildren) {\n    const wsRef = useRef<WebSocket | null>(null);\n    const store = useWsStoreApi();\n    const emitter = useEmitter<WsEvents>();\n    const reconnect = useReconnect(reconnectMs, reconnectMax, {\n      getAttempt: () => store.getState().reconnectAttempt,\n      setAttempt: (reconnectAttempt) => store.setState({ reconnectAttempt }),\n      setExhausted: (reconnectExhausted) =>\n        store.setState({ reconnectExhausted }),\n    });\n    const outgoingQueue = useOutgoingQueue(outgoingQueueMax);\n    const livenessSession = useLiveness(liveness, () => wsRef.current);\n\n    const setStatus = useCallback(\n      (status: WsStatus) => {\n        store.setState({ status });\n      },\n      [store],\n    );\n\n    const setPhase = useCallback(\n      (phase: WsPhase) => {\n        store.setState({ phase });\n      },\n      [store],\n    );\n\n    const getStatus = useCallback<WsContextValue[\"getStatus\"]>(\n      () => store.getState().status,\n      [store],\n    );\n\n    const disconnect = useCallback<WsContextValue[\"disconnect\"]>(() => {\n      reconnect.cancel();\n      livenessSession.stop();\n      outgoingQueue.clear();\n      setPhase(\"idle\");\n      const ws = wsRef.current;\n      wsRef.current = null;\n      if (ws) {\n        detachAndClose(ws);\n        setStatus(\"closed\");\n        emitter.emit(\"close\", clientCloseEvent(\"client disconnect\"));\n      } else {\n        setStatus(\"closed\");\n      }\n    }, [setStatus, setPhase, emitter, outgoingQueue, livenessSession, reconnect]);\n\n    const connect = useCallback<WsContextValue[\"connect\"]>(() => {\n      if (typeof window === \"undefined\") return;\n\n      const fromReconnect = reconnect.onConnectBegin();\n      livenessSession.stop();\n\n      const prev = wsRef.current;\n      if (prev) {\n        wsRef.current = null;\n        detachAndClose(prev);\n        emitter.emit(\"close\", clientCloseEvent(\"reconnect\"));\n      }\n\n      setStatus(\"connecting\");\n      setPhase(fromReconnect ? \"reconnecting\" : \"connecting\");\n\n      const ws = protocols ? new WebSocket(url, protocols) : new WebSocket(url);\n      wsRef.current = ws;\n\n      ws.onopen = (event) => {\n        if (wsRef.current !== ws) return;\n        reconnect.onOpen();\n        setStatus(\"open\");\n        setPhase(\"open\");\n        outgoingQueue.flush((data) => ws.send(data));\n        livenessSession.start(ws);\n        emitter.emit(\"open\", event);\n      };\n\n      ws.onmessage = (event) => {\n        if (wsRef.current !== ws) return;\n        const data = parse(event.data);\n        livenessSession.onMessage(data);\n        emitter.emit(\"message\", data, event);\n      };\n\n      ws.onerror = (event) => {\n        if (wsRef.current !== ws) return;\n        emitter.emit(\"error\", event);\n      };\n\n      ws.onclose = (event) => {\n        if (wsRef.current === ws) wsRef.current = null;\n        livenessSession.stop();\n        setStatus(\"closed\");\n        emitter.emit(\"close\", event);\n        const scheduled = reconnect.scheduleAfterClose();\n        if (scheduled) {\n          setPhase(\"reconnecting\");\n        } else if (store.getState().phase !== \"idle\") {\n          setPhase(\"stopped\");\n        }\n      };\n    }, [setStatus, setPhase, emitter, outgoingQueue, livenessSession, reconnect, store]);\n\n    reconnect.bindOnReconnect(connect);\n\n    useEffect(() => {\n      if (autoConnect) connect();\n      return () => {\n        reconnect.cancel();\n        livenessSession.stop();\n        outgoingQueue.clear();\n        const ws = wsRef.current;\n        wsRef.current = null;\n        if (ws) {\n          detachAndClose(ws);\n          emitter.emit(\"close\", clientCloseEvent(\"provider unmount\"));\n        }\n      };\n    }, [connect, emitter, outgoingQueue, livenessSession, reconnect]);\n\n    const send = useCallback<WsContextValue[\"send\"]>(\n      (data) => {\n        const ws = wsRef.current;\n        if (ws && ws.readyState === WebSocket.OPEN) {\n          ws.send(data);\n          return true;\n        }\n        return outgoingQueue.enqueue(data);\n      },\n      [outgoingQueue],\n    );\n\n    const sendJson = useCallback<WsContextValue[\"sendJson\"]>(\n      (data) => send(JSON.stringify(data)),\n      [send],\n    );\n\n    const actions = useMemo<WsContextValue>(\n      () => ({\n        send,\n        sendJson,\n        connect,\n        disconnect,\n        getStatus,\n      }),\n      [send, sendJson, connect, disconnect, getStatus],\n    );\n\n    return (\n      <ActionsCtx.Provider value={actions}>\n        <StoreCtx.Provider value={store}>\n          <EmitterCtx.Provider value={emitter}>{children}</EmitterCtx.Provider>\n        </StoreCtx.Provider>\n      </ActionsCtx.Provider>\n    );\n  }\n\n  return {\n    WsProvider,\n    useWsActions,\n    useWsStore,\n    useWsEvents,\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-ws-context",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "React WebSocket connection layer — separate hooks for actions, connection state, and message events to avoid unnecessary re-renders",
   "keywords": [
     "react",