@gurezo/web-serial-rxjs 2.1.0 → 2.2.0

package/README.ja.md

@@ -20,6 +20,40 @@ Web Serial API は **Chromium 系**のブラウザ（**Chrome** 89+、**Edge** 8
 
 `receive$` は **non-replay** のままです。購読後に届くチャンクだけが見えます。接続ごとに直近 *N* 件のデコード済みテキスト**チャンク**（read pump の 1 回の `onChunk` あたり 1 件。文字数ではありません）を遅延購読者にも渡したい場合は、`createSerialSession` に `receiveReplay: { enabled: true, bufferSize: 512 }` を指定し、`receiveReplay$` を購読します。`bufferSize` を大きくするとメモリ負荷が増えます。receive replay が **無効**（既定）のとき、`receiveReplay$` は `receive$` と同じ hot ストリームです。`lines$` の行分割に replay は付きません。生チャンクの `receiveReplay$` のみが対象です。
 
+## `receive$` と `lines$`
+
+購読するストリームはユースケースに合わせて選んでください。**`lines$`** をターミナル表示に使うと `\r` が失われ再描画できず、シェル出力（例: `ls -la` の整形）が崩れます。詳細は [概要](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.ja.md) を参照してください。
+
+### `receive$`（raw ストリーム）
+
+- UTF-8 の**デコードチャンク**をそのまま届く順に（行揃えではありません）。
+- `\r` や行途中の断片など制御文字も保持します。
+- **ターミナル表示**、**プロンプト判定**、自前の**バッファ**/スクロールバック、raw を前提にした処理に使います。
+
+### `lines$`（行単位のイベント）
+
+- **完了した行**だけを emit（`\n` / `\r\n` / 実装どおり内部の `\r`）。
+- **ログ出力**、**行単位の解析**、改行フレームのプロトコル向き。
+- 対話 CLI の**画面ミラーには不向き**です（`\r` での上書き表示の意味が落ちます）。
+
+### 避ける／推奨する書き方
+
+画面にそのまま足していく用途で **`lines$`** の文字列を連結すると、再描画情報が欠けレイアウトが崩れます。**避けてください**。
+
+```ts
+session.lines$.subscribe((line) => {
+  output += line + '\n';
+});
+```
+
+ミラーやシェル風バッファには **`receive$`** のチャンクを連結します。**推奨**です。
+
+```ts
+session.receive$.subscribe((chunk) => {
+  output += chunk;
+});
+```
+
 ## インストール
 
 ```bash

package/README.md

@@ -20,6 +20,40 @@ After a successful `connect$`, use `getPortInfo()` or subscribe to `portInfo$` f
 
 `receive$` is **non-replay**: late subscribers only see chunks emitted after they subscribe. To retain the last *N* decoded text **chunks** per open connection (same bytes as `receive$`, e.g. for boot logs), pass `receiveReplay: { enabled: true, bufferSize: 512 }` to `createSerialSession` and subscribe to `receiveReplay$`. Larger `bufferSize` uses more memory. When receive replay is **off** (default), `receiveReplay$` is the same hot stream as `receive$`. This option does not add replay to `lines$`—only raw decoder chunks on `receiveReplay$`.
 
+## `receive$` vs `lines$`
+
+Pick the stream that matches your use case. Using **`lines$`** for a terminal mirror drops `\r` and redraw behaviour, which breaks shells and tools that rely on carriage-return updates ([overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.md)).
+
+### `receive$` (raw stream)
+
+- UTF-8 **decoder chunks** as they arrive—not line-aligned.
+- Preserves `\r`, partial lines, and other control characters.
+- Use for: **terminal display**, **prompt detection**, **buffering** / scrollback you control, and other **raw-stream** handling.
+
+### `lines$` (line-delimited events)
+
+- Emits **complete lines** (`\n`, `\r\n`, interior `\r` per implementation).
+- Use for **logs**, **structured parsing**, and protocols framed on newlines.
+- **Not suitable** for mirroring interactive CLI output when peers use `\r` for in-place redraws—you lose those semantics.
+
+### Avoid / Prefer
+
+**Avoid**—appending **`lines$`** strings for a terminal-style view hides redraws and corrupts layouts.
+
+```ts
+session.lines$.subscribe((line) => {
+  output += line + '\n';
+});
+```
+
+**Prefer**—concatenate **chunks** from **`receive$`** for mirrors and shell-style buffers.
+
+```ts
+session.receive$.subscribe((chunk) => {
+  output += chunk;
+});
+```
+
 ## Installation
 
 ```bash

package/dist/index.d.ts

@@ -14,6 +14,7 @@
  * state, read loops, or write queues themselves.
  *
  * - {@link createSerialSession} - factory for a {@link SerialSession}
+ * - {@link createTerminalBuffer} - terminal-style display text from {@link SerialSession.receive$}
  * - {@link SerialSession} - the runtime interface
  * - {@link SerialSessionOptions} - connection options
  * - {@link SerialSessionState} - `state$` payload values (const + type)
@@ -52,4 +53,6 @@ export { createSerialSession, SerialSessionState } from './session';
 export type { SerialSession, SerialSessionOptions, SerialSessionReceiveReplayOptions, } from './session';
 export { SerialError } from './errors/serial-error';
 export { SerialErrorCode } from './errors/serial-error-code';
+export { createTerminalBuffer } from './terminal/create-terminal-buffer';
+export type { TerminalBuffer } from './terminal/create-terminal-buffer';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -669,9 +669,54 @@ function createSerialSession(options) {
     lines$
   };
 }
+
+// packages/web-serial-rxjs/src/terminal/create-terminal-buffer.ts
+import { map as map2, scan, shareReplay } from "rxjs";
+function applyTerminalChunk(state, chunk) {
+  let { completed, currentLine } = state;
+  const len = chunk.length;
+  for (let i = 0; i < len; i++) {
+    const c = chunk.charAt(i);
+    if (c === "\r") {
+      const next = i + 1 < len ? chunk.charAt(i + 1) : "";
+      if (next === "\n") {
+        completed += currentLine + "\n";
+        currentLine = "";
+        i++;
+      } else {
+        currentLine = "";
+      }
+    } else if (c === "\n") {
+      completed += currentLine + "\n";
+      currentLine = "";
+    } else {
+      currentLine += c;
+    }
+  }
+  return { completed, currentLine };
+}
+function terminalDisplayText(state) {
+  return state.completed + state.currentLine;
+}
+var initialTerminalState = {
+  completed: "",
+  currentLine: ""
+};
+function createTerminalBuffer(receive$) {
+  const text$ = receive$.pipe(
+    scan(
+      (state, chunk) => applyTerminalChunk(state, chunk),
+      initialTerminalState
+    ),
+    map2(terminalDisplayText),
+    shareReplay({ bufferSize: 1, refCount: true })
+  );
+  return { text$ };
+}
 export {
   SerialError,
   SerialErrorCode,
   SerialSessionState,
-  createSerialSession
+  createSerialSession,
+  createTerminalBuffer
 };

package/dist/index.mjs

@@ -669,10 +669,55 @@ function createSerialSession(options) {
     lines$
   };
 }
+
+// src/terminal/create-terminal-buffer.ts
+import { map as map2, scan, shareReplay } from "rxjs";
+function applyTerminalChunk(state, chunk) {
+  let { completed, currentLine } = state;
+  const len = chunk.length;
+  for (let i = 0; i < len; i++) {
+    const c = chunk.charAt(i);
+    if (c === "\r") {
+      const next = i + 1 < len ? chunk.charAt(i + 1) : "";
+      if (next === "\n") {
+        completed += currentLine + "\n";
+        currentLine = "";
+        i++;
+      } else {
+        currentLine = "";
+      }
+    } else if (c === "\n") {
+      completed += currentLine + "\n";
+      currentLine = "";
+    } else {
+      currentLine += c;
+    }
+  }
+  return { completed, currentLine };
+}
+function terminalDisplayText(state) {
+  return state.completed + state.currentLine;
+}
+var initialTerminalState = {
+  completed: "",
+  currentLine: ""
+};
+function createTerminalBuffer(receive$) {
+  const text$ = receive$.pipe(
+    scan(
+      (state, chunk) => applyTerminalChunk(state, chunk),
+      initialTerminalState
+    ),
+    map2(terminalDisplayText),
+    shareReplay({ bufferSize: 1, refCount: true })
+  );
+  return { text$ };
+}
 export {
   SerialError,
   SerialErrorCode,
   SerialSessionState,
-  createSerialSession
+  createSerialSession,
+  createTerminalBuffer
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/session/create-serial-session.ts", "../src/errors/serial-error-code.ts", "../src/errors/serial-error.ts", "../src/session/internal/build-request-options.ts", "../src/session/internal/has-web-serial-support.ts", "../src/session/internal/line-buffer.ts", "../src/session/normalize-serial-error.ts", "../src/session/read-pump.ts", "../src/session/send-queue.ts", "../src/session/serial-session-options.ts", "../src/session/serial-session-state.ts", "../src/session/session-state-machine.ts"],
-  "sourcesContent": ["import {\n  BehaviorSubject,\n  distinctUntilChanged,\n  map,\n  Observable,\n  ReplaySubject,\n  share,\n  Subject,\n  switchMap,\n} from 'rxjs';\nimport { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { buildRequestOptions } from './internal/build-request-options';\nimport { hasWebSerialSupport } from './internal/has-web-serial-support';\nimport { createLineBuffer } from './internal/line-buffer';\nimport {\n  normalizeSerialError,\n  type NormalizeSerialErrorOptions,\n} from './normalize-serial-error';\nimport { createReadPump, type ReadPump } from './read-pump';\nimport { createSendQueue } from './send-queue';\nimport type { SerialSession } from './serial-session';\nimport {\n  DEFAULT_SERIAL_SESSION_OPTIONS,\n  type SerialSessionOptions,\n} from './serial-session-options';\nimport { SerialSessionState } from './serial-session-state';\nimport { SessionStateMachine } from './session-state-machine';\n\n/**\n * Internal error classification used by the single `reportError` entry\n * point. `'fatal'` errors drive `state$` into `'error'` and tear down\n * the live session (pump stop + port close); `'non-fatal'` errors are\n * only multiplexed on `errors$` without mutating session state - this\n * matches the Issue #199 design note that write failures must not\n * implicitly disconnect the session.\n *\n * @internal\n */\ntype ReportErrorSeverity = 'fatal' | 'non-fatal';\n\n/**\n * Create a v2 {@link SerialSession}.\n *\n * This release wires the internal read pump (#202) and the internal send\n * queue (#203) into the session so that `connect$`, `disconnect$`,\n * `receive$`, and `send$` all operate end-to-end. Error handling is\n * centralised through a single `reportError` helper (#204) so every\n * failure path normalises through {@link normalizeSerialError} and emits\n * on the one `errors$` channel.\n *\n * Key behaviors:\n *\n * - `isBrowserSupported()` returns whether `navigator.serial` is available.\n * - `state$` replays the current lifecycle state driven by\n *   {@link SessionStateMachine}.\n * - `connect$()` opens a user-selected port, starts the internal read pump,\n *   and transitions `idle -> connecting -> connected`.\n * - `disconnect$()` stops the read pump, closes the port, and transitions\n *   `connected -> disconnecting -> idle`.\n * - `receive$` emits UTF-8 decoded text chunks pushed by the pump. It is\n *   **not** subscription-lazy - the pump is started by `connect$` and\n *   decoded text is multicast to all subscribers; late subscribers see only\n *   new data.\n * - `lines$` emits the same decoded stream split into line-terminated\n *   segments (`\\n`, `\\r\\n`); a trailing line without a terminator is\n *   buffered. It is also not subscription-lazy relative to the pump.\n * - `send$` enqueues each payload on an internal FIFO queue so concurrent\n *   subscribers are written to the port in call order. String payloads are\n *   UTF-8 encoded through a shared `TextEncoder`.\n * - `errors$` multiplexes every {@link SerialError} produced by the\n *   session. Connect / read / close failures are treated as fatal and\n *   also drive `state$` to `'error'`; write failures are non-fatal and\n *   do not mutate `state$` because a real connection loss will be\n *   observed by the read pump on the next tick anyway.\n *\n * @param options - Session options. Only `filters` is consulted by\n *   `connect$` today (forwarded to `navigator.serial.requestPort`); the\n *   remaining fields are passed to `port.open` using defaults when omitted.\n * @returns A {@link SerialSession} instance.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}\n */\nexport function createSerialSession(\n  options?: SerialSessionOptions,\n): SerialSession {\n  const resolvedOptions = {\n    ...DEFAULT_SERIAL_SESSION_OPTIONS,\n    ...options,\n    filters: options?.filters,\n    receiveReplay: {\n      ...DEFAULT_SERIAL_SESSION_OPTIONS.receiveReplay,\n      ...options?.receiveReplay,\n    },\n  };\n\n  const supported = hasWebSerialSupport();\n  const machine = new SessionStateMachine(\n    supported ? SerialSessionState.Idle : SerialSessionState.Unsupported,\n  );\n  const errorsSubject = new Subject<SerialError>();\n  const receiveSubject = new Subject<string>();\n  const linesSubject = new Subject<string>();\n  const sendQueue = createSendQueue();\n  const textEncoder = new TextEncoder();\n  const lineBuffer = createLineBuffer();\n\n  const errors$ = errorsSubject.asObservable();\n  const receive$ = receiveSubject.asObservable();\n  const lines$ = linesSubject.asObservable();\n\n  const isConnected$ = machine.state$.pipe(\n    map((state) => state === SerialSessionState.Connected),\n    distinctUntilChanged(),\n  );\n\n  const portInfoSubject = new BehaviorSubject<SerialPortInfo | null>(null);\n  const portInfo$ = portInfoSubject.asObservable();\n\n  const receiveReplayStream$ = resolvedOptions.receiveReplay.enabled\n    ? new BehaviorSubject<Observable<string>>(receive$)\n    : null;\n  let activeReceiveReplay: ReplaySubject<string> | null = null;\n\n  const clearLiveReceiveReplay = (): void => {\n    if (receiveReplayStream$) {\n      if (activeReceiveReplay) {\n        activeReceiveReplay.complete();\n        activeReceiveReplay = null;\n      }\n      receiveReplayStream$.next(receive$);\n    }\n  };\n\n  const startLiveReceiveReplay = (): void => {\n    if (!receiveReplayStream$) {\n      return;\n    }\n    if (activeReceiveReplay) {\n      activeReceiveReplay.complete();\n      activeReceiveReplay = null;\n    }\n    const rs = new ReplaySubject<string>(resolvedOptions.receiveReplay.bufferSize);\n    activeReceiveReplay = rs;\n    receiveReplayStream$.next(rs.asObservable());\n  };\n\n  const receiveReplay$ = receiveReplayStream$\n    ? receiveReplayStream$.pipe(switchMap((inner) => inner), share())\n    : receive$;\n\n  let activePort: SerialPort | null = null;\n  let activePump: ReadPump | null = null;\n\n  const setActivePort = (port: SerialPort | null): void => {\n    activePort = port;\n    portInfoSubject.next(port ? port.getInfo() : null);\n  };\n\n  const teardownPump = async (): Promise<void> => {\n    clearLiveReceiveReplay();\n    const pump = activePump;\n    activePump = null;\n    lineBuffer.clear();\n    if (pump) {\n      await pump.stop();\n    }\n  };\n\n  const closePortSafely = async (port: SerialPort | null): Promise<void> => {\n    if (!port) {\n      return;\n    }\n    try {\n      await port.close();\n    } catch {\n      // The read pump may already have errored the stream, which makes\n      // close() reject. We ignore it here because disconnect$ has a\n      // dedicated error path for close failures initiated by the user.\n    }\n  };\n\n  /**\n   * Single entry point for every error that should reach `errors$`.\n   *\n   * Responsibilities:\n   *\n   * 1. Normalise the input through {@link normalizeSerialError} so every\n   *    emission is a well-formed {@link SerialError}.\n   * 2. Multiplex the normalised error on `errors$`.\n   * 3. For fatal severities, drive `state$` to `'error'`, clear the send\n   *    queue so pending writes fail fast, and tear down the live pump +\n   *    port off the hot path.\n   *\n   * Returning the normalised error keeps call sites terse: they can hand\n   * the result straight to `subscriber.error(...)` without re-normalising.\n   */\n  const reportError = (\n    error: unknown,\n    severity: ReportErrorSeverity,\n    options: NormalizeSerialErrorOptions,\n  ): SerialError => {\n    const serialError = normalizeSerialError(error, options);\n    errorsSubject.next(serialError);\n    if (severity === 'fatal') {\n      machine.toError();\n      sendQueue.clear();\n      const portToClose = activePort;\n      setActivePort(null);\n      void teardownPump().then(() => closePortSafely(portToClose));\n    }\n    return serialError;\n  };\n\n  const writeToPort = async (payload: Uint8Array): Promise<void> => {\n    const port = activePort;\n    if (machine.current !== SerialSessionState.Connected || !port || !port.writable) {\n      throw new SerialError(\n        SerialErrorCode.PORT_NOT_OPEN,\n        'Cannot send data while session is not connected',\n      );\n    }\n    const writer = port.writable.getWriter();\n    try {\n      await writer.write(payload);\n    } finally {\n      try {\n        writer.releaseLock();\n      } catch {\n        // releaseLock throws when the stream is already errored; the real\n        // failure is surfaced through the write() rejection above so we\n        // intentionally swallow this secondary error.\n      }\n    }\n  };\n\n  return {\n    isBrowserSupported(): boolean {\n      return hasWebSerialSupport();\n    },\n    connect$(): Observable<void> {\n      return new Observable<void>((subscriber) => {\n        if (!hasWebSerialSupport()) {\n          const error = reportError(\n            new SerialError(\n              SerialErrorCode.BROWSER_NOT_SUPPORTED,\n              'Web Serial API is not supported in this environment',\n            ),\n            'non-fatal',\n            { fallbackCode: SerialErrorCode.BROWSER_NOT_SUPPORTED },\n          );\n          subscriber.error(error);\n          return;\n        }\n\n        const current = machine.current;\n        if (\n          current !== SerialSessionState.Idle &&\n          current !== SerialSessionState.Error\n        ) {\n          const error = reportError(\n            new SerialError(\n              SerialErrorCode.PORT_ALREADY_OPEN,\n              `Cannot connect while session state is '${current}'`,\n            ),\n            'non-fatal',\n            { fallbackCode: SerialErrorCode.PORT_ALREADY_OPEN },\n          );\n          subscriber.error(error);\n          return;\n        }\n\n        let cancelled = false;\n        machine.toConnecting();\n\n        const run = async (): Promise<void> => {\n          let selectedPort: SerialPort | null = null;\n          try {\n            selectedPort = await navigator.serial.requestPort(\n              buildRequestOptions(resolvedOptions),\n            );\n            await selectedPort.open({\n              baudRate: resolvedOptions.baudRate,\n              dataBits: resolvedOptions.dataBits,\n              stopBits: resolvedOptions.stopBits,\n              parity: resolvedOptions.parity,\n              bufferSize: resolvedOptions.bufferSize,\n              flowControl: resolvedOptions.flowControl,\n            });\n          } catch (error) {\n            if (selectedPort) {\n              await closePortSafely(selectedPort);\n            }\n            const serialError = reportError(error, 'fatal', {\n              fallbackCode: SerialErrorCode.PORT_OPEN_FAILED,\n              messagePrefix: 'Failed to open port',\n            });\n            if (!cancelled) {\n              subscriber.error(serialError);\n            }\n            return;\n          }\n\n          if (cancelled) {\n            await closePortSafely(selectedPort);\n            return;\n          }\n\n          setActivePort(selectedPort);\n          lineBuffer.clear();\n          if (resolvedOptions.receiveReplay.enabled) {\n            startLiveReceiveReplay();\n          }\n          activePump = createReadPump(selectedPort, {\n            onChunk: (text) => {\n              receiveSubject.next(text);\n              if (activeReceiveReplay) {\n                activeReceiveReplay.next(text);\n              }\n              for (const line of lineBuffer.feed(text)) {\n                linesSubject.next(line);\n              }\n            },\n            onError: (pumpError) =>\n              reportError(pumpError, 'fatal', {\n                fallbackCode: SerialErrorCode.READ_FAILED,\n                messagePrefix: 'Read pump failed',\n              }),\n          });\n          activePump.start();\n          sendQueue.clear();\n          machine.toConnected();\n          subscriber.next();\n          subscriber.complete();\n        };\n\n        void run();\n\n        return () => {\n          cancelled = true;\n        };\n      });\n    },\n    disconnect$(): Observable<void> {\n      return new Observable<void>((subscriber) => {\n        const current = machine.current;\n\n        if (\n          current === SerialSessionState.Idle ||\n          current === SerialSessionState.Unsupported\n        ) {\n          subscriber.next();\n          subscriber.complete();\n          return;\n        }\n\n        if (\n          current !== SerialSessionState.Connected &&\n          current !== SerialSessionState.Error\n        ) {\n          const error = reportError(\n            new SerialError(\n              SerialErrorCode.PORT_NOT_OPEN,\n              `Cannot disconnect while session state is '${current}'`,\n            ),\n            'non-fatal',\n            { fallbackCode: SerialErrorCode.PORT_NOT_OPEN },\n          );\n          subscriber.error(error);\n          return;\n        }\n\n        machine.toDisconnecting();\n        sendQueue.clear();\n        const portToClose = activePort;\n\n        const run = async (): Promise<void> => {\n          try {\n            await teardownPump();\n            if (portToClose) {\n              try {\n                await portToClose.close();\n              } catch (error) {\n                setActivePort(null);\n                const serialError = reportError(error, 'fatal', {\n                  fallbackCode: SerialErrorCode.CONNECTION_LOST,\n                  messagePrefix: 'Failed to close port',\n                });\n                subscriber.error(serialError);\n                return;\n              }\n            }\n            setActivePort(null);\n            machine.toIdle();\n            subscriber.next();\n            subscriber.complete();\n          } catch (error) {\n            const serialError = reportError(error, 'fatal', {\n              fallbackCode: SerialErrorCode.UNKNOWN,\n              messagePrefix: 'Unexpected disconnect failure',\n            });\n            subscriber.error(serialError);\n          }\n        };\n\n        void run();\n      });\n    },\n    send$(data: string | Uint8Array): Observable<void> {\n      return sendQueue.enqueue(async () => {\n        const payload =\n          typeof data === 'string' ? textEncoder.encode(data) : data;\n        try {\n          await writeToPort(payload);\n        } catch (error) {\n          throw reportError(error, 'non-fatal', {\n            fallbackCode: SerialErrorCode.WRITE_FAILED,\n            messagePrefix: 'Failed to write data',\n          });\n        }\n      });\n    },\n    state$: machine.state$,\n    isConnected$,\n    portInfo$,\n    getPortInfo(): SerialPortInfo | null {\n      return portInfoSubject.getValue();\n    },\n    getCurrentPort(): SerialPort | null {\n      return activePort;\n    },\n    errors$,\n    receive$,\n    receiveReplay$,\n    lines$,\n  };\n}\n", "/**\n * Error codes for serial port operations.\n *\n * These codes identify specific error conditions that can occur when working with\n * serial ports. Each error code corresponds to a specific failure scenario, making\n * it easier to handle errors programmatically.\n *\n * @example\n * ```typescript\n * try {\n *   await client.connect().toPromise();\n * } catch (error) {\n *   if (error instanceof SerialError) {\n *     switch (error.code) {\n *       case SerialErrorCode.BROWSER_NOT_SUPPORTED:\n *         console.error('Please use a Chromium-based browser');\n *         break;\n *       case SerialErrorCode.OPERATION_CANCELLED:\n *         console.log('User cancelled port selection');\n *         break;\n *       // ... handle other error codes\n *     }\n *   }\n * }\n * ```\n */\nexport enum SerialErrorCode {\n  /**\n   * Browser does not support the Web Serial API.\n   *\n   * This error occurs when attempting to use serial port functionality in a browser\n   * that doesn't support the Web Serial API. Only Chromium-based browsers (Chrome,\n   * Edge, Opera) support this API.\n   *\n   * **Suggested action**: Inform the user to use a supported browser.\n   */\n  BROWSER_NOT_SUPPORTED = 'BROWSER_NOT_SUPPORTED',\n\n  /**\n   * Serial port is not available.\n   *\n   * This error occurs when a requested port cannot be accessed, such as when\n   * getting previously granted ports fails or when the port is already in use\n   * by another application.\n   *\n   * **Suggested action**: Check if the port is available or being used by another application.\n   */\n  PORT_NOT_AVAILABLE = 'PORT_NOT_AVAILABLE',\n\n  /**\n   * Failed to open the serial port.\n   *\n   * This error occurs when the port cannot be opened, typically due to incorrect\n   * connection parameters, hardware issues, or permission problems.\n   *\n   * **Suggested action**: Verify connection parameters and check hardware connections.\n   */\n  PORT_OPEN_FAILED = 'PORT_OPEN_FAILED',\n\n  /**\n   * Serial port is already open.\n   *\n   * This error occurs when attempting to open a port that is already connected.\n   * Only one connection can be active at a time per SerialClient instance.\n   *\n   * **Suggested action**: Disconnect the current port before connecting a new one.\n   */\n  PORT_ALREADY_OPEN = 'PORT_ALREADY_OPEN',\n\n  /**\n   * Serial port is not open.\n   *\n   * This error occurs when attempting to read from or write to a port that hasn't\n   * been opened yet. The port must be connected before performing I/O operations.\n   *\n   * **Suggested action**: Call {@link SerialClient.connect} before reading or writing.\n   */\n  PORT_NOT_OPEN = 'PORT_NOT_OPEN',\n\n  /**\n   * Failed to read from the serial port.\n   *\n   * This error occurs when reading data from the port fails, typically due to\n   * connection loss, hardware issues, or stream errors.\n   *\n   * **Suggested action**: Check the connection and hardware, then retry the read operation.\n   */\n  READ_FAILED = 'READ_FAILED',\n\n  /**\n   * Failed to write to the serial port.\n   *\n   * This error occurs when writing data to the port fails, typically due to\n   * connection loss, hardware issues, or stream errors.\n   *\n   * **Suggested action**: Check the connection and hardware, then retry the write operation.\n   */\n  WRITE_FAILED = 'WRITE_FAILED',\n\n  /**\n   * Serial port connection was lost.\n   *\n   * This error occurs when the connection to the serial port is unexpectedly\n   * terminated, such as when the device is disconnected or the port is closed\n   * by another process.\n   *\n   * **Suggested action**: Check the physical connection and reconnect if needed.\n   */\n  CONNECTION_LOST = 'CONNECTION_LOST',\n\n  /**\n   * Invalid filter options provided.\n   *\n   * This error occurs when port filter options are invalid, such as when\n   * filter values are out of range or missing required fields.\n   *\n   * **Suggested action**: Verify filter options match the expected format and value ranges.\n   */\n  INVALID_FILTER_OPTIONS = 'INVALID_FILTER_OPTIONS',\n\n  /**\n   * Operation was cancelled by the user.\n   *\n   * This error occurs when the user cancels a port selection dialog or aborts\n   * an operation before it completes.\n   *\n   * **Suggested action**: This is a normal condition - no action required, but you may want\n   * to inform the user that the operation was cancelled.\n   */\n  OPERATION_CANCELLED = 'OPERATION_CANCELLED',\n\n  /**\n   * Operation timed out before completion.\n   *\n   * This error occurs when an operation waits for a condition (for example, prompt\n   * detection) and the timeout period elapses first.\n   */\n  OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',\n\n  /**\n   * Unknown error occurred.\n   *\n   * This error code is used for errors that don't fit into any other category.\n   * The original error details may be available in the error's message or originalError property.\n   *\n   * **Suggested action**: Check the error message and originalError for more details.\n   */\n  UNKNOWN = 'UNKNOWN',\n}\n", "import { SerialErrorCode } from './serial-error-code';\n\n// Re-export SerialErrorCode for convenience\nexport { SerialErrorCode };\n\n/**\n * Custom error class for serial port operations.\n *\n * This error class extends the standard Error class and includes additional information\n * about the type of error that occurred. It provides an error code for programmatic\n * error handling and may include the original error that caused the failure.\n *\n * @example\n * ```typescript\n * try {\n *   await client.connect().toPromise();\n * } catch (error) {\n *   if (error instanceof SerialError) {\n *     console.error(`Error code: ${error.code}`);\n *     console.error(`Message: ${error.message}`);\n *     if (error.originalError) {\n *       console.error(`Original error:`, error.originalError);\n *     }\n *\n *     // Check specific error code\n *     if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {\n *       // Handle browser not supported\n *     }\n *   }\n * }\n * ```\n */\nexport class SerialError extends Error {\n  /**\n   * The error code identifying the type of error that occurred.\n   *\n   * Use this code to programmatically handle specific error conditions.\n   *\n   * @see {@link SerialErrorCode} for all available error codes\n   */\n  public readonly code: SerialErrorCode;\n\n  /**\n   * The original error that caused this SerialError, if available.\n   *\n   * This property contains the underlying error (e.g., DOMException, TypeError)\n   * that was wrapped in this SerialError. It may be undefined if no original error exists.\n   */\n  public readonly originalError?: Error;\n\n  /**\n   * Creates a new SerialError instance.\n   *\n   * @param code - The error code identifying the type of error\n   * @param message - A human-readable error message\n   * @param originalError - The original error that caused this SerialError, if any\n   */\n  constructor(code: SerialErrorCode, message: string, originalError?: Error) {\n    super(message);\n    this.name = 'SerialError';\n    this.code = code;\n    this.originalError = originalError;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    if ((Error as any).captureStackTrace) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (Error as any).captureStackTrace(this, SerialError);\n    }\n  }\n\n  /**\n   * Check if the error matches a specific error code.\n   *\n   * This is a convenience method for checking the error code without directly\n   * comparing the code property.\n   *\n   * @param code - The error code to check against\n   * @returns `true` if this error's code matches the provided code, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (error.is(SerialErrorCode.PORT_NOT_OPEN)) {\n   *   // Handle port not open error\n   * }\n   * ```\n   */\n  public is(code: SerialErrorCode): boolean {\n    return this.code === code;\n  }\n}\n", "import { SerialError } from '../../errors/serial-error';\nimport { SerialErrorCode } from '../../errors/serial-error-code';\nimport type { SerialSessionOptions } from '../serial-session-options';\n\n/**\n * Build {@link SerialPortRequestOptions} from {@link SerialSessionOptions}.\n *\n * Converts the `filters` field of {@link SerialSessionOptions} into the\n * shape expected by `navigator.serial.requestPort` and validates USB\n * vendor / product identifiers. Returns `undefined` when no filters are\n * supplied so the browser shows all available ports.\n *\n * @param options - The session options supplied by the caller.\n * @returns The request options, or `undefined` when no filters are set.\n * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_FILTER_OPTIONS}\n *         when a filter is empty or contains out-of-range IDs.\n *\n * @internal\n */\nexport function buildRequestOptions(\n  options?: SerialSessionOptions,\n): SerialPortRequestOptions | undefined {\n  if (!options || !options.filters || options.filters.length === 0) {\n    return undefined;\n  }\n\n  for (const filter of options.filters) {\n    if (!filter.usbVendorId && !filter.usbProductId) {\n      throw new SerialError(\n        SerialErrorCode.INVALID_FILTER_OPTIONS,\n        'Filter must have at least usbVendorId or usbProductId',\n      );\n    }\n\n    if (filter.usbVendorId !== undefined) {\n      if (\n        !Number.isInteger(filter.usbVendorId) ||\n        filter.usbVendorId < 0 ||\n        filter.usbVendorId > 0xffff\n      ) {\n        throw new SerialError(\n          SerialErrorCode.INVALID_FILTER_OPTIONS,\n          `Invalid usbVendorId: ${filter.usbVendorId}. Must be an integer between 0 and 65535.`,\n        );\n      }\n    }\n\n    if (filter.usbProductId !== undefined) {\n      if (\n        !Number.isInteger(filter.usbProductId) ||\n        filter.usbProductId < 0 ||\n        filter.usbProductId > 0xffff\n      ) {\n        throw new SerialError(\n          SerialErrorCode.INVALID_FILTER_OPTIONS,\n          `Invalid usbProductId: ${filter.usbProductId}. Must be an integer between 0 and 65535.`,\n        );\n      }\n    }\n  }\n\n  return {\n    filters: options.filters,\n  };\n}\n", "/**\n * Internal feature detection for the Web Serial API.\n *\n * This helper is intentionally kept package-private: the v2 public API\n * exposes browser support only through {@link SerialSession.isBrowserSupported}.\n *\n * @returns `true` when `navigator.serial` is available.\n *\n * @internal\n */\nexport function hasWebSerialSupport(): boolean {\n  return (\n    typeof navigator !== 'undefined' &&\n    'serial' in navigator &&\n    navigator.serial !== undefined &&\n    navigator.serial !== null\n  );\n}\n", "/**\n * Streaming UTF-16 text to newline-delimited lines for {@link createSerialSession}.\n * Supports `\\r\\n` and `\\n` per #237; a lone `\\r` that is not the last character\n * in the buffer is treated as a line end (compatibility with some devices). A\n * trailing `\\r` is retained until a following chunk disambiguates `\\r` vs\n * `\\r\\n`.\n *\n * @internal\n */\nexport function createLineBuffer(): {\n  feed(chunk: string): string[];\n  clear(): void;\n} {\n  let buffer = '';\n\n  const clear = (): void => {\n    buffer = '';\n  };\n\n  const feed = (chunk: string): string[] => {\n    buffer += chunk;\n    const out: string[] = [];\n\n    for (;;) {\n      const crlf = buffer.indexOf('\\r\\n');\n      if (crlf >= 0) {\n        out.push(buffer.slice(0, crlf));\n        buffer = buffer.slice(crlf + 2);\n        continue;\n      }\n\n      // Lone \\r (not the last character) is a line end so we must not let\n      // a later \\n in the same buffer be matched first (e.g. \"a\\rb\\n\").\n      const cr = buffer.indexOf('\\r');\n      if (cr >= 0 && cr + 1 < buffer.length && buffer[cr + 1] !== '\\n') {\n        out.push(buffer.slice(0, cr));\n        buffer = buffer.slice(cr + 1);\n        continue;\n      }\n\n      const nl = buffer.indexOf('\\n');\n      if (nl >= 0) {\n        out.push(buffer.slice(0, nl));\n        buffer = buffer.slice(nl + 1);\n        continue;\n      }\n\n      if (cr >= 0 && cr + 1 === buffer.length) {\n        break;\n      }\n\n      break;\n    }\n\n    return out;\n  };\n\n  return { feed, clear };\n}\n", "import { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\n\n/**\n * Default human-readable prefix attached to normalized errors when the\n * caller does not supply one. Kept short so downstream messages remain\n * readable (e.g. `\"Serial operation failed: <cause>\"`).\n *\n * @internal\n */\nconst DEFAULT_MESSAGE_PREFIX = 'Serial operation failed';\n\n/**\n * Options accepted by {@link normalizeSerialError}.\n *\n * @internal\n */\nexport interface NormalizeSerialErrorOptions {\n  /**\n   * Error code assigned when the input cannot be classified more\n   * specifically (for example a generic `Error` thrown from `port.open`).\n   *\n   * Most call sites in the session pipeline know which lifecycle phase\n   * they are in (connect / read / write / close) and therefore pick a\n   * phase-specific fallback such as {@link SerialErrorCode.PORT_OPEN_FAILED}\n   * or {@link SerialErrorCode.WRITE_FAILED}.\n   */\n  fallbackCode: SerialErrorCode;\n  /**\n   * Prefix used when the input has to be wrapped. Ignored when the input\n   * is already a {@link SerialError} so we never rewrite a well-formed\n   * message the caller has already chosen.\n   */\n  messagePrefix?: string;\n}\n\nconst isDomExceptionWithName = (\n  error: unknown,\n  name: string,\n): error is DOMException =>\n  typeof DOMException !== 'undefined' &&\n  error instanceof DOMException &&\n  error.name === name;\n\n/**\n * Normalize an arbitrary thrown value into a {@link SerialError}.\n *\n * This helper is the single entry point used by every v2 session\n * component (session factory, read pump, send queue) to coerce raw\n * platform errors into the library's error type. Centralising the\n * mapping here satisfies Issue #204's completion criterion that\n * \"error handling lives in one place\" and removes the duplicated\n * `toError` / `normalizeError` helpers previously scattered across\n * session modules.\n *\n * Mapping rules applied, in order:\n *\n * 1. `SerialError` instances pass through unchanged so a caller that has\n *    already classified the failure (e.g. `PORT_NOT_OPEN` on a pre-open\n *    `send$`) is not rewrapped.\n * 2. `DOMException('NotFoundError')` is mapped to\n *    {@link SerialErrorCode.OPERATION_CANCELLED}. Chromium raises this\n *    when the user dismisses the `requestPort` dialog; it is a normal\n *    control-flow event, not a hard failure.\n * 3. Any other value is wrapped as a {@link SerialError} with\n *    {@link NormalizeSerialErrorOptions.fallbackCode}, preserving the\n *    original error as `originalError` for debugging.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}\n */\nexport function normalizeSerialError(\n  error: unknown,\n  options: NormalizeSerialErrorOptions,\n): SerialError {\n  if (error instanceof SerialError) {\n    return error;\n  }\n\n  const prefix = options.messagePrefix ?? DEFAULT_MESSAGE_PREFIX;\n\n  if (isDomExceptionWithName(error, 'NotFoundError')) {\n    return new SerialError(\n      SerialErrorCode.OPERATION_CANCELLED,\n      'Port selection was cancelled by the user',\n      error,\n    );\n  }\n\n  const cause = error instanceof Error ? error : new Error(String(error));\n  return new SerialError(\n    options.fallbackCode,\n    `${prefix}: ${cause.message}`,\n    cause,\n  );\n}\n", "import { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { normalizeSerialError } from './normalize-serial-error';\n\n/**\n * Callback invoked for every decoded chunk the read pump produces.\n *\n * The text is decoded from the raw bytes using a shared `TextDecoder` with\n * `{ stream: true }`, so multi-byte characters that straddle chunk\n * boundaries are joined correctly before reaching the callback.\n *\n * @internal\n */\nexport type ReadPumpChunkHandler = (text: string) => void;\n\n/**\n * Callback invoked when the read pump cannot continue.\n *\n * The provided error is always a {@link SerialError}; raw platform errors\n * are normalized by the pump before they reach the caller so consumers only\n * ever observe the library's error type.\n *\n * @internal\n */\nexport type ReadPumpErrorHandler = (error: SerialError) => void;\n\n/**\n * Options accepted by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPumpOptions {\n  onChunk: ReadPumpChunkHandler;\n  onError: ReadPumpErrorHandler;\n}\n\n/**\n * Handle returned by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPump {\n  /**\n   * Start reading from the associated `SerialPort.readable` stream.\n   *\n   * Subsequent calls are ignored while the pump is already running.\n   */\n  start(): void;\n  /**\n   * Stop the read loop and release the underlying reader lock.\n   *\n   * Safe to call multiple times or before `start()`.\n   */\n  stop(): Promise<void>;\n  /**\n   * `true` while the internal loop is actively reading.\n   */\n  readonly isRunning: boolean;\n}\n\n/**\n * Create an internal read pump for a {@link SerialPort}.\n *\n * The pump is an implementation detail of the v2 `SerialSession` API: it\n * owns a single `TextDecoder` (with `stream: true`), drives a\n * `reader.read()` loop against `port.readable`, and forwards decoded text\n * to the provided sink. It is **not** subscription-lazy - the `SerialSession`\n * starts the pump as soon as `connect$` succeeds so that `receive$`\n * subscribers never miss data because of subscription timing.\n *\n * Errors are normalized into {@link SerialError} with\n * {@link SerialErrorCode.READ_FAILED} for read-side failures and\n * {@link SerialErrorCode.CONNECTION_LOST} for missing readable streams, so\n * the session can forward them to `errors$` without rewrapping.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}\n */\nexport function createReadPump(\n  port: SerialPort,\n  { onChunk, onError }: ReadPumpOptions,\n): ReadPump {\n  let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n  let running = false;\n  let stopped = false;\n  const decoder = new TextDecoder(undefined, { fatal: false });\n\n  const releaseReader = (): void => {\n    if (!reader) {\n      return;\n    }\n    try {\n      reader.releaseLock();\n    } catch {\n      // releaseLock may throw when the reader is already detached; ignore.\n    }\n    reader = null;\n  };\n\n  const pump = async (stream: ReadableStream<Uint8Array>): Promise<void> => {\n    reader = stream.getReader();\n    running = true;\n    try {\n      while (!stopped) {\n        const { done, value } = await reader.read();\n        if (done) {\n          break;\n        }\n        if (value && value.byteLength > 0) {\n          const text = decoder.decode(value, { stream: true });\n          if (text.length > 0) {\n            onChunk(text);\n          }\n        }\n      }\n      if (!stopped) {\n        const tail = decoder.decode();\n        if (tail.length > 0) {\n          onChunk(tail);\n        }\n      }\n    } catch (error) {\n      if (!stopped) {\n        onError(\n          normalizeSerialError(error, {\n            fallbackCode: SerialErrorCode.READ_FAILED,\n            messagePrefix: 'Read pump failed',\n          }),\n        );\n      }\n    } finally {\n      running = false;\n      releaseReader();\n    }\n  };\n\n  return {\n    start(): void {\n      if (running || stopped) {\n        return;\n      }\n      const stream = port.readable;\n      if (!stream) {\n        stopped = true;\n        onError(\n          new SerialError(\n            SerialErrorCode.CONNECTION_LOST,\n            'Read pump failed: port.readable is not available',\n          ),\n        );\n        return;\n      }\n      void pump(stream);\n    },\n    async stop(): Promise<void> {\n      if (stopped) {\n        return;\n      }\n      stopped = true;\n      if (!reader) {\n        return;\n      }\n      try {\n        await reader.cancel();\n      } catch {\n        // Cancel can reject when the stream is already errored; ignore so\n        // the caller's disconnect flow is not derailed by a read failure.\n      } finally {\n        releaseReader();\n      }\n    },\n    get isRunning(): boolean {\n      return running;\n    },\n  };\n}\n", "import { Observable, defer } from 'rxjs';\n\n/**\n * A single enqueued unit of work. Operations are awaited sequentially so\n * that `send$` guarantees call order even when the caller fires multiple\n * observables concurrently.\n *\n * @internal\n */\nexport type SendQueueOperation<T> = () => Promise<T>;\n\n/**\n * Internal helper returned by {@link createSendQueue}.\n *\n * The queue is intentionally not an RxJS operator because Issue #199 calls\n * out explicitly that `send$` must not be re-implemented with `mergeMap`\n * (or any other concurrency-altering operator). A chained `Promise<void>`\n * is the simplest way to guarantee strict FIFO ordering while still\n * surfacing per-operation completion back to the caller.\n *\n * @internal\n */\nexport interface SendQueue {\n  /**\n   * Schedule an operation to run after all previously enqueued operations\n   * have settled (resolved or rejected). The returned Observable completes\n   * with the operation's resolved value, or errors with its rejection.\n   *\n   * Subscribing is what actually schedules the work - the queue is driven\n   * by `defer`, so late/never-subscribed Observables never enqueue.\n   */\n  enqueue<T>(operation: SendQueueOperation<T>): Observable<T>;\n  /**\n   * Reset the internal promise chain. Existing in-flight operations keep\n   * running because we do not cancel native promises, but no newly\n   * enqueued work will wait for them. Use this when the session is torn\n   * down so a fresh `connect$` starts with a clean chain.\n   */\n  clear(): void;\n}\n\n/**\n * Create an internal send queue that serialises `send$` writes.\n *\n * Ordering model:\n *\n * - Each `enqueue` call appends its operation to a single `Promise<void>`\n *   chain.\n * - A failure in one operation does not poison the chain - the next\n *   operation still runs (the chain is advanced with a `.then(() => {},\n *   () => {})` safety tail).\n * - Unsubscribing before the operation resolves suppresses `next` /\n *   `complete` / `error` for that subscriber; the underlying promise is\n *   still awaited so later operations continue to respect call order.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}\n */\nexport function createSendQueue(): SendQueue {\n  let chain: Promise<void> = Promise.resolve();\n\n  return {\n    enqueue<T>(operation: SendQueueOperation<T>): Observable<T> {\n      return defer(\n        () =>\n          new Observable<T>((subscriber) => {\n            let cancelled = false;\n\n            const run = async (): Promise<void> => {\n              try {\n                const value = await operation();\n                if (!cancelled) {\n                  subscriber.next(value);\n                  subscriber.complete();\n                }\n              } catch (error) {\n                if (!cancelled) {\n                  subscriber.error(error);\n                }\n              }\n            };\n\n            const scheduled = chain.then(run, run);\n            chain = scheduled.then(\n              () => undefined,\n              () => undefined,\n            );\n\n            return () => {\n              cancelled = true;\n            };\n          }),\n      );\n    },\n    clear(): void {\n      chain = Promise.resolve();\n    },\n  };\n}\n", "/**\n * Options for creating a {@link SerialSession} via {@link createSerialSession}.\n *\n * These options configure the serial port connection parameters used when\n * calling `port.open` and `navigator.serial.requestPort`. All properties\n * are optional; omitted fields fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}.\n *\n * @example\n * ```typescript\n * const session = createSerialSession({\n *   baudRate: 115200,\n *   dataBits: 8,\n *   stopBits: 1,\n *   parity: 'none',\n *   flowControl: 'none',\n *   filters: [{ usbVendorId: 0x1234, usbProductId: 0x5678 }],\n * });\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}\n */\nexport interface SerialSessionOptions {\n  /**\n   * Baud rate for the serial port connection (bits per second).\n   *\n   * Common values include 9600, 19200, 38400, 57600, 115200, etc.\n   * Must match the baud rate configured on the connected device.\n   *\n   * @default 9600\n   */\n  baudRate?: number;\n\n  /**\n   * Number of data bits per character (7 or 8).\n   *\n   * @default 8\n   */\n  dataBits?: 7 | 8;\n\n  /**\n   * Number of stop bits (1 or 2).\n   *\n   * @default 1\n   */\n  stopBits?: 1 | 2;\n\n  /**\n   * Parity checking mode.\n   *\n   * @default 'none'\n   */\n  parity?: 'none' | 'even' | 'odd';\n\n  /**\n   * Buffer size for the underlying read stream, in bytes.\n   *\n   * @default 255\n   */\n  bufferSize?: number;\n\n  /**\n   * Flow control mode.\n   *\n   * @default 'none'\n   */\n  flowControl?: 'none' | 'hardware';\n\n  /**\n   * Filters for port selection when requesting a port.\n   *\n   * When specified, the port selection dialog will only show devices\n   * matching these filters. Each filter can specify `usbVendorId` and/or\n   * `usbProductId`.\n   */\n  filters?: SerialPortFilter[];\n\n  /**\n   * Optional receive replay: retain recent decoded text **chunks** so late\n   * subscribers to {@link SerialSession.receiveReplay$} can read buffered\n   * data while a connection is active. Does not change {@link SerialSession.receive$}.\n   *\n   * @default `{ enabled: false, bufferSize: 512 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})\n   */\n  receiveReplay?: SerialSessionReceiveReplayOptions;\n}\n\n/**\n * Options for {@link SerialSessionOptions.receiveReplay}.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/265 | Issue #265}\n */\nexport interface SerialSessionReceiveReplayOptions {\n  /**\n   * When `true`, the session uses a replay buffer for {@link SerialSession.receiveReplay$}\n   * for each open connection. When `false` (default), `receiveReplay$` is\n   * the same hot stream as {@link SerialSession.receive$} (no chunk replay).\n   */\n  enabled?: boolean;\n\n  /**\n   * Retains the last **N** decoded text chunks (one emission per `onChunk`\n   * from the read pump) in the replay buffer. Not the character count. Higher\n   * `bufferSize` uses more memory.\n   *\n   * @default 512\n   */\n  bufferSize?: number;\n}\n\nconst DEFAULT_RECEIVE_REPLAY: Required<SerialSessionReceiveReplayOptions> = {\n  enabled: false,\n  bufferSize: 512,\n};\n\n/**\n * Default values applied to omitted {@link SerialSessionOptions} fields.\n *\n * @internal\n */\nexport const DEFAULT_SERIAL_SESSION_OPTIONS: Required<\n  Omit<SerialSessionOptions, 'filters' | 'receiveReplay'>\n> & { filters?: SerialPortFilter[]; receiveReplay: Required<SerialSessionReceiveReplayOptions> } = {\n  baudRate: 9600,\n  dataBits: 8,\n  stopBits: 1,\n  parity: 'none',\n  bufferSize: 255,\n  flowControl: 'none',\n  filters: undefined,\n  receiveReplay: { ...DEFAULT_RECEIVE_REPLAY },\n};\n", "/**\n * Reactive lifecycle state for a {@link SerialSession}.\n *\n * This is the v2 API counterpart of the legacy `SerialState` used by\n * `SerialClient`. The runtime values are the same flat strings v1\n * consumers used for UI switches; the {@link SerialSessionState} const\n * object is the canonical source of those literals so call sites can\n * avoid string typos and get IDE completion.\n *\n * Lifecycle transitions:\n *\n * ```\n * idle -> connecting -> connected -> disconnecting -> idle\n *                                \\-> error\n * (any)  -> unsupported   (when Web Serial API is unavailable)\n * (any)  -> error         (when an unrecoverable failure occurs)\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}\n */\nexport const SerialSessionState = {\n  Idle: 'idle',\n  Connecting: 'connecting',\n  Connected: 'connected',\n  Disconnecting: 'disconnecting',\n  Unsupported: 'unsupported',\n  Error: 'error',\n} as const;\n\n/**\n * String union of allowed {@link SerialSessionState} runtime values\n * (same set as the values on the {@link SerialSessionState} object).\n */\nexport type SerialSessionState =\n  (typeof SerialSessionState)[keyof typeof SerialSessionState];\n", "import { BehaviorSubject, Observable } from 'rxjs';\nimport { SerialSessionState } from './serial-session-state';\n\n/**\n * Allowed transitions for the internal SerialSession state machine.\n *\n * Keys are the source state, values are the set of states that the source\n * is allowed to transition into. Transitions missing from this map are\n * treated as invalid and silently rejected (with a `console.warn`) so that\n * a logic bug in one sub-issue cannot corrupt `state$` for downstream\n * consumers.\n *\n * Lifecycle model (matches {@link SerialSessionState}):\n *\n * ```\n * idle -> connecting -> connected -> disconnecting -> idle\n *                                                \\-> error\n * error -> idle            (reset / retry)\n * unsupported              (terminal; entered only at construction time)\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/201 | Issue #201}\n */\nconst S = SerialSessionState;\n\nconst ALLOWED_TRANSITIONS: Readonly<\n  Record<SerialSessionState, readonly SerialSessionState[]>\n> = {\n  [S.Idle]: [S.Connecting, S.Error],\n  [S.Connecting]: [S.Connected, S.Error, S.Idle],\n  [S.Connected]: [S.Disconnecting, S.Error],\n  [S.Disconnecting]: [S.Idle, S.Error],\n  [S.Error]: [S.Idle, S.Connecting],\n  [S.Unsupported]: [],\n};\n\n/**\n * Internal state machine that backs {@link SerialSession.state$}.\n *\n * The machine is deliberately kept as an internal module (not exported\n * from the package) because the public surface is only the Observable.\n * Sub-issues of #199 (read pump / send queue / errors) drive transitions\n * through the dedicated `to*` methods below instead of mutating a shared\n * `BehaviorSubject` directly.\n *\n * Design notes:\n *\n * - Invalid transitions are silently rejected so that the `state$` stream\n *   never emits a state that violates the lifecycle contract. A\n *   `console.warn` is emitted in development builds to aid debugging.\n * - `unsupported` is terminal: once entered (during construction when\n *   `navigator.serial` is missing), the machine refuses every further\n *   transition.\n * - `state$` is derived from a {@link BehaviorSubject} so late subscribers\n *   still receive the current state on subscription.\n *\n * @internal\n */\nexport class SessionStateMachine {\n  private readonly subject: BehaviorSubject<SerialSessionState>;\n\n  constructor(initial: SerialSessionState = SerialSessionState.Idle) {\n    this.subject = new BehaviorSubject<SerialSessionState>(initial);\n  }\n\n  get current(): SerialSessionState {\n    return this.subject.getValue();\n  }\n\n  get state$(): Observable<SerialSessionState> {\n    return this.subject.asObservable();\n  }\n\n  toConnecting(): boolean {\n    return this.transition(S.Connecting);\n  }\n\n  toConnected(): boolean {\n    return this.transition(S.Connected);\n  }\n\n  toDisconnecting(): boolean {\n    return this.transition(S.Disconnecting);\n  }\n\n  toIdle(): boolean {\n    return this.transition(S.Idle);\n  }\n\n  toError(): boolean {\n    return this.transition(S.Error);\n  }\n\n  toUnsupported(): boolean {\n    return this.transition(S.Unsupported);\n  }\n\n  complete(): void {\n    this.subject.complete();\n  }\n\n  private transition(next: SerialSessionState): boolean {\n    const current = this.subject.getValue();\n\n    if (current === next) {\n      return false;\n    }\n\n    const allowed = ALLOWED_TRANSITIONS[current];\n    if (!allowed.includes(next)) {\n      if (typeof console !== 'undefined' && console.warn) {\n        console.warn(\n          `[web-serial-rxjs] Ignoring invalid SerialSession transition ${current} -> ${next}`,\n        );\n      }\n      return false;\n    }\n\n    this.subject.next(next);\n    return true;\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["BehaviorSubject", "Observable", "SerialErrorCode", "BehaviorSubject", "options", "Observable"]
+  "sources": ["../src/session/create-serial-session.ts", "../src/errors/serial-error-code.ts", "../src/errors/serial-error.ts", "../src/session/internal/build-request-options.ts", "../src/session/internal/has-web-serial-support.ts", "../src/session/internal/line-buffer.ts", "../src/session/normalize-serial-error.ts", "../src/session/read-pump.ts", "../src/session/send-queue.ts", "../src/session/serial-session-options.ts", "../src/session/serial-session-state.ts", "../src/session/session-state-machine.ts", "../src/terminal/create-terminal-buffer.ts"],
+  "sourcesContent": ["import {\n  BehaviorSubject,\n  distinctUntilChanged,\n  map,\n  Observable,\n  ReplaySubject,\n  share,\n  Subject,\n  switchMap,\n} from 'rxjs';\nimport { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { buildRequestOptions } from './internal/build-request-options';\nimport { hasWebSerialSupport } from './internal/has-web-serial-support';\nimport { createLineBuffer } from './internal/line-buffer';\nimport {\n  normalizeSerialError,\n  type NormalizeSerialErrorOptions,\n} from './normalize-serial-error';\nimport { createReadPump, type ReadPump } from './read-pump';\nimport { createSendQueue } from './send-queue';\nimport type { SerialSession } from './serial-session';\nimport {\n  DEFAULT_SERIAL_SESSION_OPTIONS,\n  type SerialSessionOptions,\n} from './serial-session-options';\nimport { SerialSessionState } from './serial-session-state';\nimport { SessionStateMachine } from './session-state-machine';\n\n/**\n * Internal error classification used by the single `reportError` entry\n * point. `'fatal'` errors drive `state$` into `'error'` and tear down\n * the live session (pump stop + port close); `'non-fatal'` errors are\n * only multiplexed on `errors$` without mutating session state - this\n * matches the Issue #199 design note that write failures must not\n * implicitly disconnect the session.\n *\n * @internal\n */\ntype ReportErrorSeverity = 'fatal' | 'non-fatal';\n\n/**\n * Create a v2 {@link SerialSession}.\n *\n * This release wires the internal read pump (#202) and the internal send\n * queue (#203) into the session so that `connect$`, `disconnect$`,\n * `receive$`, and `send$` all operate end-to-end. Error handling is\n * centralised through a single `reportError` helper (#204) so every\n * failure path normalises through {@link normalizeSerialError} and emits\n * on the one `errors$` channel.\n *\n * Key behaviors:\n *\n * - `isBrowserSupported()` returns whether `navigator.serial` is available.\n * - `state$` replays the current lifecycle state driven by\n *   {@link SessionStateMachine}.\n * - `connect$()` opens a user-selected port, starts the internal read pump,\n *   and transitions `idle -> connecting -> connected`.\n * - `disconnect$()` stops the read pump, closes the port, and transitions\n *   `connected -> disconnecting -> idle`.\n * - `receive$` emits UTF-8 decoded text chunks pushed by the pump. It is\n *   **not** subscription-lazy - the pump is started by `connect$` and\n *   decoded text is multicast to all subscribers; late subscribers see only\n *   new data.\n * - `lines$` emits the same decoded stream split into line-terminated\n *   segments (`\\n`, `\\r\\n`); a trailing line without a terminator is\n *   buffered. It is also not subscription-lazy relative to the pump.\n * - `send$` enqueues each payload on an internal FIFO queue so concurrent\n *   subscribers are written to the port in call order. String payloads are\n *   UTF-8 encoded through a shared `TextEncoder`.\n * - `errors$` multiplexes every {@link SerialError} produced by the\n *   session. Connect / read / close failures are treated as fatal and\n *   also drive `state$` to `'error'`; write failures are non-fatal and\n *   do not mutate `state$` because a real connection loss will be\n *   observed by the read pump on the next tick anyway.\n *\n * @param options - Session options. Only `filters` is consulted by\n *   `connect$` today (forwarded to `navigator.serial.requestPort`); the\n *   remaining fields are passed to `port.open` using defaults when omitted.\n * @returns A {@link SerialSession} instance.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}\n */\nexport function createSerialSession(\n  options?: SerialSessionOptions,\n): SerialSession {\n  const resolvedOptions = {\n    ...DEFAULT_SERIAL_SESSION_OPTIONS,\n    ...options,\n    filters: options?.filters,\n    receiveReplay: {\n      ...DEFAULT_SERIAL_SESSION_OPTIONS.receiveReplay,\n      ...options?.receiveReplay,\n    },\n  };\n\n  const supported = hasWebSerialSupport();\n  const machine = new SessionStateMachine(\n    supported ? SerialSessionState.Idle : SerialSessionState.Unsupported,\n  );\n  const errorsSubject = new Subject<SerialError>();\n  const receiveSubject = new Subject<string>();\n  const linesSubject = new Subject<string>();\n  const sendQueue = createSendQueue();\n  const textEncoder = new TextEncoder();\n  const lineBuffer = createLineBuffer();\n\n  const errors$ = errorsSubject.asObservable();\n  const receive$ = receiveSubject.asObservable();\n  const lines$ = linesSubject.asObservable();\n\n  const isConnected$ = machine.state$.pipe(\n    map((state) => state === SerialSessionState.Connected),\n    distinctUntilChanged(),\n  );\n\n  const portInfoSubject = new BehaviorSubject<SerialPortInfo | null>(null);\n  const portInfo$ = portInfoSubject.asObservable();\n\n  const receiveReplayStream$ = resolvedOptions.receiveReplay.enabled\n    ? new BehaviorSubject<Observable<string>>(receive$)\n    : null;\n  let activeReceiveReplay: ReplaySubject<string> | null = null;\n\n  const clearLiveReceiveReplay = (): void => {\n    if (receiveReplayStream$) {\n      if (activeReceiveReplay) {\n        activeReceiveReplay.complete();\n        activeReceiveReplay = null;\n      }\n      receiveReplayStream$.next(receive$);\n    }\n  };\n\n  const startLiveReceiveReplay = (): void => {\n    if (!receiveReplayStream$) {\n      return;\n    }\n    if (activeReceiveReplay) {\n      activeReceiveReplay.complete();\n      activeReceiveReplay = null;\n    }\n    const rs = new ReplaySubject<string>(resolvedOptions.receiveReplay.bufferSize);\n    activeReceiveReplay = rs;\n    receiveReplayStream$.next(rs.asObservable());\n  };\n\n  const receiveReplay$ = receiveReplayStream$\n    ? receiveReplayStream$.pipe(switchMap((inner) => inner), share())\n    : receive$;\n\n  let activePort: SerialPort | null = null;\n  let activePump: ReadPump | null = null;\n\n  const setActivePort = (port: SerialPort | null): void => {\n    activePort = port;\n    portInfoSubject.next(port ? port.getInfo() : null);\n  };\n\n  const teardownPump = async (): Promise<void> => {\n    clearLiveReceiveReplay();\n    const pump = activePump;\n    activePump = null;\n    lineBuffer.clear();\n    if (pump) {\n      await pump.stop();\n    }\n  };\n\n  const closePortSafely = async (port: SerialPort | null): Promise<void> => {\n    if (!port) {\n      return;\n    }\n    try {\n      await port.close();\n    } catch {\n      // The read pump may already have errored the stream, which makes\n      // close() reject. We ignore it here because disconnect$ has a\n      // dedicated error path for close failures initiated by the user.\n    }\n  };\n\n  /**\n   * Single entry point for every error that should reach `errors$`.\n   *\n   * Responsibilities:\n   *\n   * 1. Normalise the input through {@link normalizeSerialError} so every\n   *    emission is a well-formed {@link SerialError}.\n   * 2. Multiplex the normalised error on `errors$`.\n   * 3. For fatal severities, drive `state$` to `'error'`, clear the send\n   *    queue so pending writes fail fast, and tear down the live pump +\n   *    port off the hot path.\n   *\n   * Returning the normalised error keeps call sites terse: they can hand\n   * the result straight to `subscriber.error(...)` without re-normalising.\n   */\n  const reportError = (\n    error: unknown,\n    severity: ReportErrorSeverity,\n    options: NormalizeSerialErrorOptions,\n  ): SerialError => {\n    const serialError = normalizeSerialError(error, options);\n    errorsSubject.next(serialError);\n    if (severity === 'fatal') {\n      machine.toError();\n      sendQueue.clear();\n      const portToClose = activePort;\n      setActivePort(null);\n      void teardownPump().then(() => closePortSafely(portToClose));\n    }\n    return serialError;\n  };\n\n  const writeToPort = async (payload: Uint8Array): Promise<void> => {\n    const port = activePort;\n    if (machine.current !== SerialSessionState.Connected || !port || !port.writable) {\n      throw new SerialError(\n        SerialErrorCode.PORT_NOT_OPEN,\n        'Cannot send data while session is not connected',\n      );\n    }\n    const writer = port.writable.getWriter();\n    try {\n      await writer.write(payload);\n    } finally {\n      try {\n        writer.releaseLock();\n      } catch {\n        // releaseLock throws when the stream is already errored; the real\n        // failure is surfaced through the write() rejection above so we\n        // intentionally swallow this secondary error.\n      }\n    }\n  };\n\n  return {\n    isBrowserSupported(): boolean {\n      return hasWebSerialSupport();\n    },\n    connect$(): Observable<void> {\n      return new Observable<void>((subscriber) => {\n        if (!hasWebSerialSupport()) {\n          const error = reportError(\n            new SerialError(\n              SerialErrorCode.BROWSER_NOT_SUPPORTED,\n              'Web Serial API is not supported in this environment',\n            ),\n            'non-fatal',\n            { fallbackCode: SerialErrorCode.BROWSER_NOT_SUPPORTED },\n          );\n          subscriber.error(error);\n          return;\n        }\n\n        const current = machine.current;\n        if (\n          current !== SerialSessionState.Idle &&\n          current !== SerialSessionState.Error\n        ) {\n          const error = reportError(\n            new SerialError(\n              SerialErrorCode.PORT_ALREADY_OPEN,\n              `Cannot connect while session state is '${current}'`,\n            ),\n            'non-fatal',\n            { fallbackCode: SerialErrorCode.PORT_ALREADY_OPEN },\n          );\n          subscriber.error(error);\n          return;\n        }\n\n        let cancelled = false;\n        machine.toConnecting();\n\n        const run = async (): Promise<void> => {\n          let selectedPort: SerialPort | null = null;\n          try {\n            selectedPort = await navigator.serial.requestPort(\n              buildRequestOptions(resolvedOptions),\n            );\n            await selectedPort.open({\n              baudRate: resolvedOptions.baudRate,\n              dataBits: resolvedOptions.dataBits,\n              stopBits: resolvedOptions.stopBits,\n              parity: resolvedOptions.parity,\n              bufferSize: resolvedOptions.bufferSize,\n              flowControl: resolvedOptions.flowControl,\n            });\n          } catch (error) {\n            if (selectedPort) {\n              await closePortSafely(selectedPort);\n            }\n            const serialError = reportError(error, 'fatal', {\n              fallbackCode: SerialErrorCode.PORT_OPEN_FAILED,\n              messagePrefix: 'Failed to open port',\n            });\n            if (!cancelled) {\n              subscriber.error(serialError);\n            }\n            return;\n          }\n\n          if (cancelled) {\n            await closePortSafely(selectedPort);\n            return;\n          }\n\n          setActivePort(selectedPort);\n          lineBuffer.clear();\n          if (resolvedOptions.receiveReplay.enabled) {\n            startLiveReceiveReplay();\n          }\n          activePump = createReadPump(selectedPort, {\n            onChunk: (text) => {\n              receiveSubject.next(text);\n              if (activeReceiveReplay) {\n                activeReceiveReplay.next(text);\n              }\n              for (const line of lineBuffer.feed(text)) {\n                linesSubject.next(line);\n              }\n            },\n            onError: (pumpError) =>\n              reportError(pumpError, 'fatal', {\n                fallbackCode: SerialErrorCode.READ_FAILED,\n                messagePrefix: 'Read pump failed',\n              }),\n          });\n          activePump.start();\n          sendQueue.clear();\n          machine.toConnected();\n          subscriber.next();\n          subscriber.complete();\n        };\n\n        void run();\n\n        return () => {\n          cancelled = true;\n        };\n      });\n    },\n    disconnect$(): Observable<void> {\n      return new Observable<void>((subscriber) => {\n        const current = machine.current;\n\n        if (\n          current === SerialSessionState.Idle ||\n          current === SerialSessionState.Unsupported\n        ) {\n          subscriber.next();\n          subscriber.complete();\n          return;\n        }\n\n        if (\n          current !== SerialSessionState.Connected &&\n          current !== SerialSessionState.Error\n        ) {\n          const error = reportError(\n            new SerialError(\n              SerialErrorCode.PORT_NOT_OPEN,\n              `Cannot disconnect while session state is '${current}'`,\n            ),\n            'non-fatal',\n            { fallbackCode: SerialErrorCode.PORT_NOT_OPEN },\n          );\n          subscriber.error(error);\n          return;\n        }\n\n        machine.toDisconnecting();\n        sendQueue.clear();\n        const portToClose = activePort;\n\n        const run = async (): Promise<void> => {\n          try {\n            await teardownPump();\n            if (portToClose) {\n              try {\n                await portToClose.close();\n              } catch (error) {\n                setActivePort(null);\n                const serialError = reportError(error, 'fatal', {\n                  fallbackCode: SerialErrorCode.CONNECTION_LOST,\n                  messagePrefix: 'Failed to close port',\n                });\n                subscriber.error(serialError);\n                return;\n              }\n            }\n            setActivePort(null);\n            machine.toIdle();\n            subscriber.next();\n            subscriber.complete();\n          } catch (error) {\n            const serialError = reportError(error, 'fatal', {\n              fallbackCode: SerialErrorCode.UNKNOWN,\n              messagePrefix: 'Unexpected disconnect failure',\n            });\n            subscriber.error(serialError);\n          }\n        };\n\n        void run();\n      });\n    },\n    send$(data: string | Uint8Array): Observable<void> {\n      return sendQueue.enqueue(async () => {\n        const payload =\n          typeof data === 'string' ? textEncoder.encode(data) : data;\n        try {\n          await writeToPort(payload);\n        } catch (error) {\n          throw reportError(error, 'non-fatal', {\n            fallbackCode: SerialErrorCode.WRITE_FAILED,\n            messagePrefix: 'Failed to write data',\n          });\n        }\n      });\n    },\n    state$: machine.state$,\n    isConnected$,\n    portInfo$,\n    getPortInfo(): SerialPortInfo | null {\n      return portInfoSubject.getValue();\n    },\n    getCurrentPort(): SerialPort | null {\n      return activePort;\n    },\n    errors$,\n    receive$,\n    receiveReplay$,\n    lines$,\n  };\n}\n", "/**\n * Error codes for serial port operations.\n *\n * These codes identify specific error conditions that can occur when working with\n * serial ports. Each error code corresponds to a specific failure scenario, making\n * it easier to handle errors programmatically.\n *\n * @example\n * ```typescript\n * try {\n *   await client.connect().toPromise();\n * } catch (error) {\n *   if (error instanceof SerialError) {\n *     switch (error.code) {\n *       case SerialErrorCode.BROWSER_NOT_SUPPORTED:\n *         console.error('Please use a Chromium-based browser');\n *         break;\n *       case SerialErrorCode.OPERATION_CANCELLED:\n *         console.log('User cancelled port selection');\n *         break;\n *       // ... handle other error codes\n *     }\n *   }\n * }\n * ```\n */\nexport enum SerialErrorCode {\n  /**\n   * Browser does not support the Web Serial API.\n   *\n   * This error occurs when attempting to use serial port functionality in a browser\n   * that doesn't support the Web Serial API. Only Chromium-based browsers (Chrome,\n   * Edge, Opera) support this API.\n   *\n   * **Suggested action**: Inform the user to use a supported browser.\n   */\n  BROWSER_NOT_SUPPORTED = 'BROWSER_NOT_SUPPORTED',\n\n  /**\n   * Serial port is not available.\n   *\n   * This error occurs when a requested port cannot be accessed, such as when\n   * getting previously granted ports fails or when the port is already in use\n   * by another application.\n   *\n   * **Suggested action**: Check if the port is available or being used by another application.\n   */\n  PORT_NOT_AVAILABLE = 'PORT_NOT_AVAILABLE',\n\n  /**\n   * Failed to open the serial port.\n   *\n   * This error occurs when the port cannot be opened, typically due to incorrect\n   * connection parameters, hardware issues, or permission problems.\n   *\n   * **Suggested action**: Verify connection parameters and check hardware connections.\n   */\n  PORT_OPEN_FAILED = 'PORT_OPEN_FAILED',\n\n  /**\n   * Serial port is already open.\n   *\n   * This error occurs when attempting to open a port that is already connected.\n   * Only one connection can be active at a time per SerialClient instance.\n   *\n   * **Suggested action**: Disconnect the current port before connecting a new one.\n   */\n  PORT_ALREADY_OPEN = 'PORT_ALREADY_OPEN',\n\n  /**\n   * Serial port is not open.\n   *\n   * This error occurs when attempting to read from or write to a port that hasn't\n   * been opened yet. The port must be connected before performing I/O operations.\n   *\n   * **Suggested action**: Call {@link SerialClient.connect} before reading or writing.\n   */\n  PORT_NOT_OPEN = 'PORT_NOT_OPEN',\n\n  /**\n   * Failed to read from the serial port.\n   *\n   * This error occurs when reading data from the port fails, typically due to\n   * connection loss, hardware issues, or stream errors.\n   *\n   * **Suggested action**: Check the connection and hardware, then retry the read operation.\n   */\n  READ_FAILED = 'READ_FAILED',\n\n  /**\n   * Failed to write to the serial port.\n   *\n   * This error occurs when writing data to the port fails, typically due to\n   * connection loss, hardware issues, or stream errors.\n   *\n   * **Suggested action**: Check the connection and hardware, then retry the write operation.\n   */\n  WRITE_FAILED = 'WRITE_FAILED',\n\n  /**\n   * Serial port connection was lost.\n   *\n   * This error occurs when the connection to the serial port is unexpectedly\n   * terminated, such as when the device is disconnected or the port is closed\n   * by another process.\n   *\n   * **Suggested action**: Check the physical connection and reconnect if needed.\n   */\n  CONNECTION_LOST = 'CONNECTION_LOST',\n\n  /**\n   * Invalid filter options provided.\n   *\n   * This error occurs when port filter options are invalid, such as when\n   * filter values are out of range or missing required fields.\n   *\n   * **Suggested action**: Verify filter options match the expected format and value ranges.\n   */\n  INVALID_FILTER_OPTIONS = 'INVALID_FILTER_OPTIONS',\n\n  /**\n   * Operation was cancelled by the user.\n   *\n   * This error occurs when the user cancels a port selection dialog or aborts\n   * an operation before it completes.\n   *\n   * **Suggested action**: This is a normal condition - no action required, but you may want\n   * to inform the user that the operation was cancelled.\n   */\n  OPERATION_CANCELLED = 'OPERATION_CANCELLED',\n\n  /**\n   * Operation timed out before completion.\n   *\n   * This error occurs when an operation waits for a condition (for example, prompt\n   * detection) and the timeout period elapses first.\n   */\n  OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',\n\n  /**\n   * Unknown error occurred.\n   *\n   * This error code is used for errors that don't fit into any other category.\n   * The original error details may be available in the error's message or originalError property.\n   *\n   * **Suggested action**: Check the error message and originalError for more details.\n   */\n  UNKNOWN = 'UNKNOWN',\n}\n", "import { SerialErrorCode } from './serial-error-code';\n\n// Re-export SerialErrorCode for convenience\nexport { SerialErrorCode };\n\n/**\n * Custom error class for serial port operations.\n *\n * This error class extends the standard Error class and includes additional information\n * about the type of error that occurred. It provides an error code for programmatic\n * error handling and may include the original error that caused the failure.\n *\n * @example\n * ```typescript\n * try {\n *   await client.connect().toPromise();\n * } catch (error) {\n *   if (error instanceof SerialError) {\n *     console.error(`Error code: ${error.code}`);\n *     console.error(`Message: ${error.message}`);\n *     if (error.originalError) {\n *       console.error(`Original error:`, error.originalError);\n *     }\n *\n *     // Check specific error code\n *     if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {\n *       // Handle browser not supported\n *     }\n *   }\n * }\n * ```\n */\nexport class SerialError extends Error {\n  /**\n   * The error code identifying the type of error that occurred.\n   *\n   * Use this code to programmatically handle specific error conditions.\n   *\n   * @see {@link SerialErrorCode} for all available error codes\n   */\n  public readonly code: SerialErrorCode;\n\n  /**\n   * The original error that caused this SerialError, if available.\n   *\n   * This property contains the underlying error (e.g., DOMException, TypeError)\n   * that was wrapped in this SerialError. It may be undefined if no original error exists.\n   */\n  public readonly originalError?: Error;\n\n  /**\n   * Creates a new SerialError instance.\n   *\n   * @param code - The error code identifying the type of error\n   * @param message - A human-readable error message\n   * @param originalError - The original error that caused this SerialError, if any\n   */\n  constructor(code: SerialErrorCode, message: string, originalError?: Error) {\n    super(message);\n    this.name = 'SerialError';\n    this.code = code;\n    this.originalError = originalError;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    if ((Error as any).captureStackTrace) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (Error as any).captureStackTrace(this, SerialError);\n    }\n  }\n\n  /**\n   * Check if the error matches a specific error code.\n   *\n   * This is a convenience method for checking the error code without directly\n   * comparing the code property.\n   *\n   * @param code - The error code to check against\n   * @returns `true` if this error's code matches the provided code, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (error.is(SerialErrorCode.PORT_NOT_OPEN)) {\n   *   // Handle port not open error\n   * }\n   * ```\n   */\n  public is(code: SerialErrorCode): boolean {\n    return this.code === code;\n  }\n}\n", "import { SerialError } from '../../errors/serial-error';\nimport { SerialErrorCode } from '../../errors/serial-error-code';\nimport type { SerialSessionOptions } from '../serial-session-options';\n\n/**\n * Build {@link SerialPortRequestOptions} from {@link SerialSessionOptions}.\n *\n * Converts the `filters` field of {@link SerialSessionOptions} into the\n * shape expected by `navigator.serial.requestPort` and validates USB\n * vendor / product identifiers. Returns `undefined` when no filters are\n * supplied so the browser shows all available ports.\n *\n * @param options - The session options supplied by the caller.\n * @returns The request options, or `undefined` when no filters are set.\n * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_FILTER_OPTIONS}\n *         when a filter is empty or contains out-of-range IDs.\n *\n * @internal\n */\nexport function buildRequestOptions(\n  options?: SerialSessionOptions,\n): SerialPortRequestOptions | undefined {\n  if (!options || !options.filters || options.filters.length === 0) {\n    return undefined;\n  }\n\n  for (const filter of options.filters) {\n    if (!filter.usbVendorId && !filter.usbProductId) {\n      throw new SerialError(\n        SerialErrorCode.INVALID_FILTER_OPTIONS,\n        'Filter must have at least usbVendorId or usbProductId',\n      );\n    }\n\n    if (filter.usbVendorId !== undefined) {\n      if (\n        !Number.isInteger(filter.usbVendorId) ||\n        filter.usbVendorId < 0 ||\n        filter.usbVendorId > 0xffff\n      ) {\n        throw new SerialError(\n          SerialErrorCode.INVALID_FILTER_OPTIONS,\n          `Invalid usbVendorId: ${filter.usbVendorId}. Must be an integer between 0 and 65535.`,\n        );\n      }\n    }\n\n    if (filter.usbProductId !== undefined) {\n      if (\n        !Number.isInteger(filter.usbProductId) ||\n        filter.usbProductId < 0 ||\n        filter.usbProductId > 0xffff\n      ) {\n        throw new SerialError(\n          SerialErrorCode.INVALID_FILTER_OPTIONS,\n          `Invalid usbProductId: ${filter.usbProductId}. Must be an integer between 0 and 65535.`,\n        );\n      }\n    }\n  }\n\n  return {\n    filters: options.filters,\n  };\n}\n", "/**\n * Internal feature detection for the Web Serial API.\n *\n * This helper is intentionally kept package-private: the v2 public API\n * exposes browser support only through {@link SerialSession.isBrowserSupported}.\n *\n * @returns `true` when `navigator.serial` is available.\n *\n * @internal\n */\nexport function hasWebSerialSupport(): boolean {\n  return (\n    typeof navigator !== 'undefined' &&\n    'serial' in navigator &&\n    navigator.serial !== undefined &&\n    navigator.serial !== null\n  );\n}\n", "/**\n * Streaming UTF-16 text to newline-delimited lines for {@link createSerialSession}.\n * Supports `\\r\\n` and `\\n` per #237; a lone `\\r` that is not the last character\n * in the buffer is treated as a line end (compatibility with some devices). A\n * trailing `\\r` is retained until a following chunk disambiguates `\\r` vs\n * `\\r\\n`.\n *\n * @internal\n */\nexport function createLineBuffer(): {\n  feed(chunk: string): string[];\n  clear(): void;\n} {\n  let buffer = '';\n\n  const clear = (): void => {\n    buffer = '';\n  };\n\n  const feed = (chunk: string): string[] => {\n    buffer += chunk;\n    const out: string[] = [];\n\n    for (;;) {\n      const crlf = buffer.indexOf('\\r\\n');\n      if (crlf >= 0) {\n        out.push(buffer.slice(0, crlf));\n        buffer = buffer.slice(crlf + 2);\n        continue;\n      }\n\n      // Lone \\r (not the last character) is a line end so we must not let\n      // a later \\n in the same buffer be matched first (e.g. \"a\\rb\\n\").\n      const cr = buffer.indexOf('\\r');\n      if (cr >= 0 && cr + 1 < buffer.length && buffer[cr + 1] !== '\\n') {\n        out.push(buffer.slice(0, cr));\n        buffer = buffer.slice(cr + 1);\n        continue;\n      }\n\n      const nl = buffer.indexOf('\\n');\n      if (nl >= 0) {\n        out.push(buffer.slice(0, nl));\n        buffer = buffer.slice(nl + 1);\n        continue;\n      }\n\n      if (cr >= 0 && cr + 1 === buffer.length) {\n        break;\n      }\n\n      break;\n    }\n\n    return out;\n  };\n\n  return { feed, clear };\n}\n", "import { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\n\n/**\n * Default human-readable prefix attached to normalized errors when the\n * caller does not supply one. Kept short so downstream messages remain\n * readable (e.g. `\"Serial operation failed: <cause>\"`).\n *\n * @internal\n */\nconst DEFAULT_MESSAGE_PREFIX = 'Serial operation failed';\n\n/**\n * Options accepted by {@link normalizeSerialError}.\n *\n * @internal\n */\nexport interface NormalizeSerialErrorOptions {\n  /**\n   * Error code assigned when the input cannot be classified more\n   * specifically (for example a generic `Error` thrown from `port.open`).\n   *\n   * Most call sites in the session pipeline know which lifecycle phase\n   * they are in (connect / read / write / close) and therefore pick a\n   * phase-specific fallback such as {@link SerialErrorCode.PORT_OPEN_FAILED}\n   * or {@link SerialErrorCode.WRITE_FAILED}.\n   */\n  fallbackCode: SerialErrorCode;\n  /**\n   * Prefix used when the input has to be wrapped. Ignored when the input\n   * is already a {@link SerialError} so we never rewrite a well-formed\n   * message the caller has already chosen.\n   */\n  messagePrefix?: string;\n}\n\nconst isDomExceptionWithName = (\n  error: unknown,\n  name: string,\n): error is DOMException =>\n  typeof DOMException !== 'undefined' &&\n  error instanceof DOMException &&\n  error.name === name;\n\n/**\n * Normalize an arbitrary thrown value into a {@link SerialError}.\n *\n * This helper is the single entry point used by every v2 session\n * component (session factory, read pump, send queue) to coerce raw\n * platform errors into the library's error type. Centralising the\n * mapping here satisfies Issue #204's completion criterion that\n * \"error handling lives in one place\" and removes the duplicated\n * `toError` / `normalizeError` helpers previously scattered across\n * session modules.\n *\n * Mapping rules applied, in order:\n *\n * 1. `SerialError` instances pass through unchanged so a caller that has\n *    already classified the failure (e.g. `PORT_NOT_OPEN` on a pre-open\n *    `send$`) is not rewrapped.\n * 2. `DOMException('NotFoundError')` is mapped to\n *    {@link SerialErrorCode.OPERATION_CANCELLED}. Chromium raises this\n *    when the user dismisses the `requestPort` dialog; it is a normal\n *    control-flow event, not a hard failure.\n * 3. Any other value is wrapped as a {@link SerialError} with\n *    {@link NormalizeSerialErrorOptions.fallbackCode}, preserving the\n *    original error as `originalError` for debugging.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}\n */\nexport function normalizeSerialError(\n  error: unknown,\n  options: NormalizeSerialErrorOptions,\n): SerialError {\n  if (error instanceof SerialError) {\n    return error;\n  }\n\n  const prefix = options.messagePrefix ?? DEFAULT_MESSAGE_PREFIX;\n\n  if (isDomExceptionWithName(error, 'NotFoundError')) {\n    return new SerialError(\n      SerialErrorCode.OPERATION_CANCELLED,\n      'Port selection was cancelled by the user',\n      error,\n    );\n  }\n\n  const cause = error instanceof Error ? error : new Error(String(error));\n  return new SerialError(\n    options.fallbackCode,\n    `${prefix}: ${cause.message}`,\n    cause,\n  );\n}\n", "import { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { normalizeSerialError } from './normalize-serial-error';\n\n/**\n * Callback invoked for every decoded chunk the read pump produces.\n *\n * The text is decoded from the raw bytes using a shared `TextDecoder` with\n * `{ stream: true }`, so multi-byte characters that straddle chunk\n * boundaries are joined correctly before reaching the callback.\n *\n * @internal\n */\nexport type ReadPumpChunkHandler = (text: string) => void;\n\n/**\n * Callback invoked when the read pump cannot continue.\n *\n * The provided error is always a {@link SerialError}; raw platform errors\n * are normalized by the pump before they reach the caller so consumers only\n * ever observe the library's error type.\n *\n * @internal\n */\nexport type ReadPumpErrorHandler = (error: SerialError) => void;\n\n/**\n * Options accepted by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPumpOptions {\n  onChunk: ReadPumpChunkHandler;\n  onError: ReadPumpErrorHandler;\n}\n\n/**\n * Handle returned by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPump {\n  /**\n   * Start reading from the associated `SerialPort.readable` stream.\n   *\n   * Subsequent calls are ignored while the pump is already running.\n   */\n  start(): void;\n  /**\n   * Stop the read loop and release the underlying reader lock.\n   *\n   * Safe to call multiple times or before `start()`.\n   */\n  stop(): Promise<void>;\n  /**\n   * `true` while the internal loop is actively reading.\n   */\n  readonly isRunning: boolean;\n}\n\n/**\n * Create an internal read pump for a {@link SerialPort}.\n *\n * The pump is an implementation detail of the v2 `SerialSession` API: it\n * owns a single `TextDecoder` (with `stream: true`), drives a\n * `reader.read()` loop against `port.readable`, and forwards decoded text\n * to the provided sink. It is **not** subscription-lazy - the `SerialSession`\n * starts the pump as soon as `connect$` succeeds so that `receive$`\n * subscribers never miss data because of subscription timing.\n *\n * Errors are normalized into {@link SerialError} with\n * {@link SerialErrorCode.READ_FAILED} for read-side failures and\n * {@link SerialErrorCode.CONNECTION_LOST} for missing readable streams, so\n * the session can forward them to `errors$` without rewrapping.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}\n */\nexport function createReadPump(\n  port: SerialPort,\n  { onChunk, onError }: ReadPumpOptions,\n): ReadPump {\n  let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n  let running = false;\n  let stopped = false;\n  const decoder = new TextDecoder(undefined, { fatal: false });\n\n  const releaseReader = (): void => {\n    if (!reader) {\n      return;\n    }\n    try {\n      reader.releaseLock();\n    } catch {\n      // releaseLock may throw when the reader is already detached; ignore.\n    }\n    reader = null;\n  };\n\n  const pump = async (stream: ReadableStream<Uint8Array>): Promise<void> => {\n    reader = stream.getReader();\n    running = true;\n    try {\n      while (!stopped) {\n        const { done, value } = await reader.read();\n        if (done) {\n          break;\n        }\n        if (value && value.byteLength > 0) {\n          const text = decoder.decode(value, { stream: true });\n          if (text.length > 0) {\n            onChunk(text);\n          }\n        }\n      }\n      if (!stopped) {\n        const tail = decoder.decode();\n        if (tail.length > 0) {\n          onChunk(tail);\n        }\n      }\n    } catch (error) {\n      if (!stopped) {\n        onError(\n          normalizeSerialError(error, {\n            fallbackCode: SerialErrorCode.READ_FAILED,\n            messagePrefix: 'Read pump failed',\n          }),\n        );\n      }\n    } finally {\n      running = false;\n      releaseReader();\n    }\n  };\n\n  return {\n    start(): void {\n      if (running || stopped) {\n        return;\n      }\n      const stream = port.readable;\n      if (!stream) {\n        stopped = true;\n        onError(\n          new SerialError(\n            SerialErrorCode.CONNECTION_LOST,\n            'Read pump failed: port.readable is not available',\n          ),\n        );\n        return;\n      }\n      void pump(stream);\n    },\n    async stop(): Promise<void> {\n      if (stopped) {\n        return;\n      }\n      stopped = true;\n      if (!reader) {\n        return;\n      }\n      try {\n        await reader.cancel();\n      } catch {\n        // Cancel can reject when the stream is already errored; ignore so\n        // the caller's disconnect flow is not derailed by a read failure.\n      } finally {\n        releaseReader();\n      }\n    },\n    get isRunning(): boolean {\n      return running;\n    },\n  };\n}\n", "import { Observable, defer } from 'rxjs';\n\n/**\n * A single enqueued unit of work. Operations are awaited sequentially so\n * that `send$` guarantees call order even when the caller fires multiple\n * observables concurrently.\n *\n * @internal\n */\nexport type SendQueueOperation<T> = () => Promise<T>;\n\n/**\n * Internal helper returned by {@link createSendQueue}.\n *\n * The queue is intentionally not an RxJS operator because Issue #199 calls\n * out explicitly that `send$` must not be re-implemented with `mergeMap`\n * (or any other concurrency-altering operator). A chained `Promise<void>`\n * is the simplest way to guarantee strict FIFO ordering while still\n * surfacing per-operation completion back to the caller.\n *\n * @internal\n */\nexport interface SendQueue {\n  /**\n   * Schedule an operation to run after all previously enqueued operations\n   * have settled (resolved or rejected). The returned Observable completes\n   * with the operation's resolved value, or errors with its rejection.\n   *\n   * Subscribing is what actually schedules the work - the queue is driven\n   * by `defer`, so late/never-subscribed Observables never enqueue.\n   */\n  enqueue<T>(operation: SendQueueOperation<T>): Observable<T>;\n  /**\n   * Reset the internal promise chain. Existing in-flight operations keep\n   * running because we do not cancel native promises, but no newly\n   * enqueued work will wait for them. Use this when the session is torn\n   * down so a fresh `connect$` starts with a clean chain.\n   */\n  clear(): void;\n}\n\n/**\n * Create an internal send queue that serialises `send$` writes.\n *\n * Ordering model:\n *\n * - Each `enqueue` call appends its operation to a single `Promise<void>`\n *   chain.\n * - A failure in one operation does not poison the chain - the next\n *   operation still runs (the chain is advanced with a `.then(() => {},\n *   () => {})` safety tail).\n * - Unsubscribing before the operation resolves suppresses `next` /\n *   `complete` / `error` for that subscriber; the underlying promise is\n *   still awaited so later operations continue to respect call order.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}\n */\nexport function createSendQueue(): SendQueue {\n  let chain: Promise<void> = Promise.resolve();\n\n  return {\n    enqueue<T>(operation: SendQueueOperation<T>): Observable<T> {\n      return defer(\n        () =>\n          new Observable<T>((subscriber) => {\n            let cancelled = false;\n\n            const run = async (): Promise<void> => {\n              try {\n                const value = await operation();\n                if (!cancelled) {\n                  subscriber.next(value);\n                  subscriber.complete();\n                }\n              } catch (error) {\n                if (!cancelled) {\n                  subscriber.error(error);\n                }\n              }\n            };\n\n            const scheduled = chain.then(run, run);\n            chain = scheduled.then(\n              () => undefined,\n              () => undefined,\n            );\n\n            return () => {\n              cancelled = true;\n            };\n          }),\n      );\n    },\n    clear(): void {\n      chain = Promise.resolve();\n    },\n  };\n}\n", "/**\n * Options for creating a {@link SerialSession} via {@link createSerialSession}.\n *\n * These options configure the serial port connection parameters used when\n * calling `port.open` and `navigator.serial.requestPort`. All properties\n * are optional; omitted fields fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}.\n *\n * @example\n * ```typescript\n * const session = createSerialSession({\n *   baudRate: 115200,\n *   dataBits: 8,\n *   stopBits: 1,\n *   parity: 'none',\n *   flowControl: 'none',\n *   filters: [{ usbVendorId: 0x1234, usbProductId: 0x5678 }],\n * });\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}\n */\nexport interface SerialSessionOptions {\n  /**\n   * Baud rate for the serial port connection (bits per second).\n   *\n   * Common values include 9600, 19200, 38400, 57600, 115200, etc.\n   * Must match the baud rate configured on the connected device.\n   *\n   * @default 9600\n   */\n  baudRate?: number;\n\n  /**\n   * Number of data bits per character (7 or 8).\n   *\n   * @default 8\n   */\n  dataBits?: 7 | 8;\n\n  /**\n   * Number of stop bits (1 or 2).\n   *\n   * @default 1\n   */\n  stopBits?: 1 | 2;\n\n  /**\n   * Parity checking mode.\n   *\n   * @default 'none'\n   */\n  parity?: 'none' | 'even' | 'odd';\n\n  /**\n   * Buffer size for the underlying read stream, in bytes.\n   *\n   * @default 255\n   */\n  bufferSize?: number;\n\n  /**\n   * Flow control mode.\n   *\n   * @default 'none'\n   */\n  flowControl?: 'none' | 'hardware';\n\n  /**\n   * Filters for port selection when requesting a port.\n   *\n   * When specified, the port selection dialog will only show devices\n   * matching these filters. Each filter can specify `usbVendorId` and/or\n   * `usbProductId`.\n   */\n  filters?: SerialPortFilter[];\n\n  /**\n   * Optional receive replay: retain recent decoded text **chunks** so late\n   * subscribers to {@link SerialSession.receiveReplay$} can read buffered\n   * data while a connection is active. Does not change {@link SerialSession.receive$}.\n   *\n   * @default `{ enabled: false, bufferSize: 512 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})\n   */\n  receiveReplay?: SerialSessionReceiveReplayOptions;\n}\n\n/**\n * Options for {@link SerialSessionOptions.receiveReplay}.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/265 | Issue #265}\n */\nexport interface SerialSessionReceiveReplayOptions {\n  /**\n   * When `true`, the session uses a replay buffer for {@link SerialSession.receiveReplay$}\n   * for each open connection. When `false` (default), `receiveReplay$` is\n   * the same hot stream as {@link SerialSession.receive$} (no chunk replay).\n   */\n  enabled?: boolean;\n\n  /**\n   * Retains the last **N** decoded text chunks (one emission per `onChunk`\n   * from the read pump) in the replay buffer. Not the character count. Higher\n   * `bufferSize` uses more memory.\n   *\n   * @default 512\n   */\n  bufferSize?: number;\n}\n\nconst DEFAULT_RECEIVE_REPLAY: Required<SerialSessionReceiveReplayOptions> = {\n  enabled: false,\n  bufferSize: 512,\n};\n\n/**\n * Default values applied to omitted {@link SerialSessionOptions} fields.\n *\n * @internal\n */\nexport const DEFAULT_SERIAL_SESSION_OPTIONS: Required<\n  Omit<SerialSessionOptions, 'filters' | 'receiveReplay'>\n> & { filters?: SerialPortFilter[]; receiveReplay: Required<SerialSessionReceiveReplayOptions> } = {\n  baudRate: 9600,\n  dataBits: 8,\n  stopBits: 1,\n  parity: 'none',\n  bufferSize: 255,\n  flowControl: 'none',\n  filters: undefined,\n  receiveReplay: { ...DEFAULT_RECEIVE_REPLAY },\n};\n", "/**\n * Reactive lifecycle state for a {@link SerialSession}.\n *\n * This is the v2 API counterpart of the legacy `SerialState` used by\n * `SerialClient`. The runtime values are the same flat strings v1\n * consumers used for UI switches; the {@link SerialSessionState} const\n * object is the canonical source of those literals so call sites can\n * avoid string typos and get IDE completion.\n *\n * Lifecycle transitions:\n *\n * ```\n * idle -> connecting -> connected -> disconnecting -> idle\n *                                \\-> error\n * (any)  -> unsupported   (when Web Serial API is unavailable)\n * (any)  -> error         (when an unrecoverable failure occurs)\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}\n */\nexport const SerialSessionState = {\n  Idle: 'idle',\n  Connecting: 'connecting',\n  Connected: 'connected',\n  Disconnecting: 'disconnecting',\n  Unsupported: 'unsupported',\n  Error: 'error',\n} as const;\n\n/**\n * String union of allowed {@link SerialSessionState} runtime values\n * (same set as the values on the {@link SerialSessionState} object).\n */\nexport type SerialSessionState =\n  (typeof SerialSessionState)[keyof typeof SerialSessionState];\n", "import { BehaviorSubject, Observable } from 'rxjs';\nimport { SerialSessionState } from './serial-session-state';\n\n/**\n * Allowed transitions for the internal SerialSession state machine.\n *\n * Keys are the source state, values are the set of states that the source\n * is allowed to transition into. Transitions missing from this map are\n * treated as invalid and silently rejected (with a `console.warn`) so that\n * a logic bug in one sub-issue cannot corrupt `state$` for downstream\n * consumers.\n *\n * Lifecycle model (matches {@link SerialSessionState}):\n *\n * ```\n * idle -> connecting -> connected -> disconnecting -> idle\n *                                                \\-> error\n * error -> idle            (reset / retry)\n * unsupported              (terminal; entered only at construction time)\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/201 | Issue #201}\n */\nconst S = SerialSessionState;\n\nconst ALLOWED_TRANSITIONS: Readonly<\n  Record<SerialSessionState, readonly SerialSessionState[]>\n> = {\n  [S.Idle]: [S.Connecting, S.Error],\n  [S.Connecting]: [S.Connected, S.Error, S.Idle],\n  [S.Connected]: [S.Disconnecting, S.Error],\n  [S.Disconnecting]: [S.Idle, S.Error],\n  [S.Error]: [S.Idle, S.Connecting],\n  [S.Unsupported]: [],\n};\n\n/**\n * Internal state machine that backs {@link SerialSession.state$}.\n *\n * The machine is deliberately kept as an internal module (not exported\n * from the package) because the public surface is only the Observable.\n * Sub-issues of #199 (read pump / send queue / errors) drive transitions\n * through the dedicated `to*` methods below instead of mutating a shared\n * `BehaviorSubject` directly.\n *\n * Design notes:\n *\n * - Invalid transitions are silently rejected so that the `state$` stream\n *   never emits a state that violates the lifecycle contract. A\n *   `console.warn` is emitted in development builds to aid debugging.\n * - `unsupported` is terminal: once entered (during construction when\n *   `navigator.serial` is missing), the machine refuses every further\n *   transition.\n * - `state$` is derived from a {@link BehaviorSubject} so late subscribers\n *   still receive the current state on subscription.\n *\n * @internal\n */\nexport class SessionStateMachine {\n  private readonly subject: BehaviorSubject<SerialSessionState>;\n\n  constructor(initial: SerialSessionState = SerialSessionState.Idle) {\n    this.subject = new BehaviorSubject<SerialSessionState>(initial);\n  }\n\n  get current(): SerialSessionState {\n    return this.subject.getValue();\n  }\n\n  get state$(): Observable<SerialSessionState> {\n    return this.subject.asObservable();\n  }\n\n  toConnecting(): boolean {\n    return this.transition(S.Connecting);\n  }\n\n  toConnected(): boolean {\n    return this.transition(S.Connected);\n  }\n\n  toDisconnecting(): boolean {\n    return this.transition(S.Disconnecting);\n  }\n\n  toIdle(): boolean {\n    return this.transition(S.Idle);\n  }\n\n  toError(): boolean {\n    return this.transition(S.Error);\n  }\n\n  toUnsupported(): boolean {\n    return this.transition(S.Unsupported);\n  }\n\n  complete(): void {\n    this.subject.complete();\n  }\n\n  private transition(next: SerialSessionState): boolean {\n    const current = this.subject.getValue();\n\n    if (current === next) {\n      return false;\n    }\n\n    const allowed = ALLOWED_TRANSITIONS[current];\n    if (!allowed.includes(next)) {\n      if (typeof console !== 'undefined' && console.warn) {\n        console.warn(\n          `[web-serial-rxjs] Ignoring invalid SerialSession transition ${current} -> ${next}`,\n        );\n      }\n      return false;\n    }\n\n    this.subject.next(next);\n    return true;\n  }\n}\n", "import { type Observable, map, scan, shareReplay } from 'rxjs';\n\n/** @internal Folded state between {@link createTerminalBuffer} emissions. */\nexport interface TerminalBufferState {\n  completed: string;\n  currentLine: string;\n}\n\n/**\n * Applies one raw decoder chunk to terminal display state.\n * Handles `\\r\\n` and lone `\\n` as line endings, and lone `\\r` as\n * carriage return (clear current line for redraw). Does not interpret ANSI escapes.\n *\n * @internal Exported for unit tests.\n */\nexport function applyTerminalChunk(\n  state: TerminalBufferState,\n  chunk: string,\n): TerminalBufferState {\n  let { completed, currentLine } = state;\n  const len = chunk.length;\n\n  for (let i = 0; i < len; i++) {\n    const c = chunk.charAt(i);\n    if (c === '\\r') {\n      const next = i + 1 < len ? chunk.charAt(i + 1) : '';\n      if (next === '\\n') {\n        completed += currentLine + '\\n';\n        currentLine = '';\n        i++;\n      } else {\n        currentLine = '';\n      }\n    } else if (c === '\\n') {\n      completed += currentLine + '\\n';\n      currentLine = '';\n    } else {\n      currentLine += c;\n    }\n  }\n\n  return { completed, currentLine };\n}\n\n/** @internal */\nexport function terminalDisplayText(state: TerminalBufferState): string {\n  return state.completed + state.currentLine;\n}\n\nexport interface TerminalBuffer {\n  /**\n   * Cumulative text suitable for terminal-style display: completed lines plus\n   * the current line, with `\\r` redraws collapsed per Issue #275.\n   */\n  readonly text$: Observable<string>;\n}\n\nconst initialTerminalState: TerminalBufferState = {\n  completed: '',\n  currentLine: '',\n};\n\n/**\n * Builds a terminal-oriented text stream from {@link SerialSession.receive$} (or any\n * `Observable<string>` of decoded chunks). Uses internal buffering so callers need not\n * implement carriage-return collapse themselves.\n */\nexport function createTerminalBuffer(\n  receive$: Observable<string>,\n): TerminalBuffer {\n  const text$ = receive$.pipe(\n    scan(\n      (state, chunk: string) => applyTerminalChunk(state, chunk),\n      initialTerminalState,\n    ),\n    map(terminalDisplayText),\n    shareReplay({ bufferSize: 1, refCount: true }),\n  );\n\n  return { text$ };\n}\n"],
+  "mappings": "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",
+  "names": ["BehaviorSubject", "Observable", "SerialErrorCode", "BehaviorSubject", "options", "Observable", "map"]
 }

package/dist/session/serial-session.d.ts

@@ -124,9 +124,16 @@ export interface SerialSession {
      * subscription-lazy: emissions happen regardless of whether a consumer
      * is currently subscribed, so late subscribers see only new data.
      *
-     * Emits **raw decoder chunks** (not line-aligned). For newline-framed
-     * protocols, use {@link lines$} or derive your own framing from
-     * `receive$`.
+     * Emits **raw decoder chunks** (not line-aligned): carriage returns and
+     * other control characters from the peer are preserved. Use this for
+     * terminal-like mirrors, progress output that relies on `\r`, or raw
+     * inspection. Do **not** drive those UIs from {@link lines$}, which may
+     * split on interior `\r` and break redraw semantics.
+     *
+     * For newline-framed protocols, logs, or line-by-line parsing, prefer
+     * {@link lines$} or derive custom framing from `receive$`.
+     *
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/273 | Issue #273}
      */
     readonly receive$: Observable<string>;
     /**
@@ -143,11 +150,16 @@ export interface SerialSession {
     readonly receiveReplay$: Observable<string>;
     /**
      * Decoded text split into **complete lines** using `\n`, `\r\n`, and
-     * lone interior `\r` (see implementation). A trailing fragment without
-     * a line terminator is buffered until a later chunk completes a line, or
-     * discarded on disconnect. It is **not** subscription-lazy: the same
-     * framing runs whenever the read pump is active, independent of
-     * subscribers.
+     * lone interior `\r` (see implementation). Intended for **logs**,
+     * newline-framed command responses, and parsers—not for mirroring raw
+     * terminal output where `\r` must be preserved for progress/redraw.
+     *
+     * A trailing fragment without a line terminator is buffered until a later
+     * chunk completes a line, or discarded on disconnect. It is **not**
+     * subscription-lazy: the same framing runs whenever the read pump is active,
+     * independent of subscribers.
+     *
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/273 | Issue #273}
      */
     readonly lines$: Observable<string>;
     /**

package/dist/session/serial-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-session.d.ts","sourceRoot":"","sources":["../../src/session/serial-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;CACpD"}
+{"version":3,"file":"serial-session.d.ts","sourceRoot":"","sources":["../../src/session/serial-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;CACpD"}

package/dist/terminal/create-terminal-buffer.d.ts

@@ -0,0 +1,30 @@
+import { type Observable } from 'rxjs';
+/** @internal Folded state between {@link createTerminalBuffer} emissions. */
+export interface TerminalBufferState {
+    completed: string;
+    currentLine: string;
+}
+/**
+ * Applies one raw decoder chunk to terminal display state.
+ * Handles `\r\n` and lone `\n` as line endings, and lone `\r` as
+ * carriage return (clear current line for redraw). Does not interpret ANSI escapes.
+ *
+ * @internal Exported for unit tests.
+ */
+export declare function applyTerminalChunk(state: TerminalBufferState, chunk: string): TerminalBufferState;
+/** @internal */
+export declare function terminalDisplayText(state: TerminalBufferState): string;
+export interface TerminalBuffer {
+    /**
+     * Cumulative text suitable for terminal-style display: completed lines plus
+     * the current line, with `\r` redraws collapsed per Issue #275.
+     */
+    readonly text$: Observable<string>;
+}
+/**
+ * Builds a terminal-oriented text stream from {@link SerialSession.receive$} (or any
+ * `Observable<string>` of decoded chunks). Uses internal buffering so callers need not
+ * implement carriage-return collapse themselves.
+ */
+export declare function createTerminalBuffer(receive$: Observable<string>): TerminalBuffer;
+//# sourceMappingURL=create-terminal-buffer.d.ts.map

package/dist/terminal/create-terminal-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-terminal-buffer.d.ts","sourceRoot":"","sources":["../../src/terminal/create-terminal-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAA0B,MAAM,MAAM,CAAC;AAE/D,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAwBrB;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEtE;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CACpC;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAC3B,cAAc,CAWhB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurezo/web-serial-rxjs",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "RxJS-based utilities for the Web Serial API, usable from Angular, React, Svelte, and Vanilla JavaScript/TypeScript.",
   "author": "Akihiko Kigure <akihiko.kigure@gmail.com>",
   "license": "MIT",