@gurezo/web-serial-rxjs 2.3.6 → 2.4.0

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/terminal/create-terminal-buffer.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 { createTerminalBuffer } from '../terminal/create-terminal-buffer';\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  const terminalText$ = createTerminalBuffer(receive$).text$;\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    terminalText$,\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 supported desktop browser (Chrome, Edge, Opera, or Firefox 151+)');\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. Supported desktop browsers are Chrome,\n   * Edge, Opera, and Firefox 151+. Safari and mobile browsers are not supported.\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 { 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", "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", "map", "Observable", "SerialErrorCode", "map", "BehaviorSubject", "options", "Observable"]
+  "sources": ["../src/session/create-serial-session.ts", "../src/errors/serial-error-code.ts", "../src/errors/serial-error.ts", "../src/terminal/create-terminal-buffer.ts", "../src/internal/newline-tokenizer.ts", "../src/session/internal/build-request-options.ts", "../src/session/internal/has-web-serial-support.ts", "../src/session/internal/line-buffer.ts", "../src/session/internal/receive-replay-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  share,\n  Subject,\n  switchMap,\n} from 'rxjs';\nimport { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { createTerminalBuffer } from '../terminal/create-terminal-buffer';\nimport { buildRequestOptions } from './internal/build-request-options';\nimport { hasWebSerialSupport } from './internal/has-web-serial-support';\nimport { createLineBuffer } from './internal/line-buffer';\nimport {\n  createReceiveReplayBuffer,\n  type ReceiveReplayBuffer,\n} from './internal/receive-replay-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  resolveReceiveReplayOptions,\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`. When called during `connecting`,\n *   it cancels the in-flight `connect$()` and returns to `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: resolveReceiveReplayOptions(options?.receiveReplay),\n    terminalBuffer: {\n      ...DEFAULT_SERIAL_SESSION_OPTIONS.terminalBuffer,\n      ...options?.terminalBuffer,\n    },\n    lineBuffer: {\n      ...DEFAULT_SERIAL_SESSION_OPTIONS.lineBuffer,\n      ...options?.lineBuffer,\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(resolvedOptions.lineBuffer);\n\n  const errors$ = errorsSubject.asObservable();\n  const receive$ = receiveSubject.asObservable();\n  const lines$ = linesSubject.asObservable();\n  const terminalText$ = createTerminalBuffer(\n    receive$,\n    resolvedOptions.terminalBuffer,\n  ).text$;\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: ReceiveReplayBuffer | 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 buffer = createReceiveReplayBuffer({\n      bufferSize: resolvedOptions.receiveReplay.bufferSize,\n      maxChars: resolvedOptions.receiveReplay.maxChars,\n    });\n    activeReceiveReplay = buffer;\n    receiveReplayStream$.next(buffer.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  let activeConnectCancel: (() => void) | null = null;\n  let disposed = false;\n\n  const createDisposedError = (): SerialError =>\n    new SerialError(\n      SerialErrorCode.SESSION_DISPOSED,\n      'SerialSession has been disposed',\n    );\n\n  const completeSession = async (): Promise<void> => {\n    const current = machine.current;\n\n    if (current === SerialSessionState.Connecting) {\n      activeConnectCancel?.();\n    }\n\n    sendQueue.clear();\n\n    if (\n      current === SerialSessionState.Connected ||\n      current === SerialSessionState.Error ||\n      current === SerialSessionState.Disconnecting\n    ) {\n      const portToClose = activePort;\n      await teardownPump();\n      await closePortSafely(portToClose);\n      setActivePort(null);\n    }\n\n    lineBuffer.clear();\n    machine.toDisposed();\n    machine.complete();\n    errorsSubject.complete();\n    receiveSubject.complete();\n    linesSubject.complete();\n    portInfoSubject.complete();\n    receiveReplayStream$?.complete();\n  };\n\n  const dispose$ = (): Observable<void> =>\n    new Observable<void>((subscriber) => {\n      if (disposed) {\n        subscriber.next();\n        subscriber.complete();\n        return;\n      }\n\n      disposed = true;\n\n      const run = async (): Promise<void> => {\n        try {\n          await completeSession();\n          subscriber.next();\n          subscriber.complete();\n        } catch (error) {\n          const serialError = normalizeSerialError(error, {\n            fallbackCode: SerialErrorCode.UNKNOWN,\n            messagePrefix: 'Unexpected dispose failure',\n          });\n          subscriber.error(serialError);\n        }\n      };\n\n      void run();\n    });\n\n  const clearActiveConnectCancel = (cancel: () => void): void => {\n    if (activeConnectCancel === cancel) {\n      activeConnectCancel = null;\n    }\n  };\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    if (disposed) {\n      return serialError;\n    }\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 (disposed) {\n          subscriber.error(createDisposedError());\n          return;\n        }\n\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        const cancelInFlightConnect = (): void => {\n          cancelled = true;\n          if (machine.current === SerialSessionState.Connecting) {\n            machine.toIdle();\n          }\n        };\n        activeConnectCancel = cancelInFlightConnect;\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 || disposed) {\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                const { overflowed } = activeReceiveReplay.next(text);\n                if (overflowed) {\n                  reportError(\n                    new SerialError(\n                      SerialErrorCode.RECEIVE_REPLAY_BUFFER_OVERFLOW,\n                      `Receive replay buffer exceeded configured limits; oldest chunks were discarded`,\n                    ),\n                    'non-fatal',\n                    {\n                      fallbackCode: SerialErrorCode.RECEIVE_REPLAY_BUFFER_OVERFLOW,\n                    },\n                  );\n                }\n              }\n              const { lines, overflowed } = lineBuffer.feed(text);\n              if (overflowed) {\n                reportError(\n                  new SerialError(\n                    SerialErrorCode.LINE_BUFFER_OVERFLOW,\n                    `Line buffer exceeded maxChars (${resolvedOptions.lineBuffer.maxChars}); leading data was discarded`,\n                  ),\n                  'non-fatal',\n                  { fallbackCode: SerialErrorCode.LINE_BUFFER_OVERFLOW },\n                );\n              }\n              for (const line of lines) {\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            onDone: () => {\n              if (machine.current !== SerialSessionState.Connected) {\n                return;\n              }\n              reportError(\n                new SerialError(\n                  SerialErrorCode.CONNECTION_LOST,\n                  'Read pump ended unexpectedly: stream closed while connected',\n                ),\n                'fatal',\n                {\n                  fallbackCode: SerialErrorCode.CONNECTION_LOST,\n                },\n              );\n            },\n          });\n          activePump.start();\n          sendQueue.clear();\n          if (disposed) {\n            await teardownPump();\n            await closePortSafely(selectedPort);\n            setActivePort(null);\n            return;\n          }\n          machine.toConnected();\n          subscriber.next();\n          subscriber.complete();\n        };\n\n        void run();\n\n        return () => {\n          clearActiveConnectCancel(cancelInFlightConnect);\n          cancelInFlightConnect();\n        };\n      });\n    },\n    disconnect$(): Observable<void> {\n      return new Observable<void>((subscriber) => {\n        if (disposed) {\n          subscriber.next();\n          subscriber.complete();\n          return;\n        }\n\n        const current = machine.current;\n\n        if (\n          current === SerialSessionState.Idle ||\n          current === SerialSessionState.Unsupported ||\n          current === SerialSessionState.Disconnecting\n        ) {\n          subscriber.next();\n          subscriber.complete();\n          return;\n        }\n\n        if (current === SerialSessionState.Connecting) {\n          activeConnectCancel?.();\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            if (!disposed) {\n              machine.toIdle();\n            }\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    dispose$,\n    destroy$: dispose$,\n    send$(data: string | Uint8Array): Observable<void> {\n      if (disposed) {\n        return new Observable<void>((subscriber) => {\n          subscriber.error(createDisposedError());\n        });\n      }\n\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    terminalText$,\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 supported desktop browser (Chrome, Edge, Opera, or Firefox 151+)');\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. Supported desktop browsers are Chrome,\n   * Edge, Opera, and Firefox 151+. Safari and mobile browsers are not supported.\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   * Internal line buffer exceeded its configured size limit.\n   *\n   * This error occurs when the incomplete line tail held by the {@link SerialSession.lines$}\n   * framing buffer grows beyond {@link SerialSessionOptions.lineBuffer} `maxChars`.\n   * Leading characters are discarded to bound memory; the session remains connected.\n   *\n   * **Suggested action**: Increase `lineBuffer.maxChars`, handle framing on `receive$`,\n   * or ensure the device sends line terminators.\n   */\n  LINE_BUFFER_OVERFLOW = 'LINE_BUFFER_OVERFLOW',\n\n  /**\n   * Invalid receive replay options provided.\n   *\n   * This error occurs when {@link SerialSessionOptions.receiveReplay} values are\n   * out of range, such as a non-integer `bufferSize` or `maxChars`.\n   *\n   * **Suggested action**: Verify `receiveReplay` options match the documented\n   * ranges and value types.\n   */\n  INVALID_RECEIVE_REPLAY_OPTIONS = 'INVALID_RECEIVE_REPLAY_OPTIONS',\n\n  /**\n   * Receive replay buffer exceeded its configured character limit.\n   *\n   * This error occurs when buffered chunks on {@link SerialSession.receiveReplay$}\n   * exceed {@link SerialSessionOptions.receiveReplay} `maxChars`. Oldest chunks\n   * are discarded to bound memory; the session remains connected.\n   *\n   * **Suggested action**: Increase `receiveReplay.maxChars`, reduce chunk size at\n   * the source, or subscribe earlier to avoid relying on a large replay buffer.\n   */\n  RECEIVE_REPLAY_BUFFER_OVERFLOW = 'RECEIVE_REPLAY_BUFFER_OVERFLOW',\n\n  /**\n   * Session has been disposed and can no longer be used.\n   *\n   * This error occurs when calling {@link SerialSession.connect$} or\n   * {@link SerialSession.send$} after {@link SerialSession.dispose$} has\n   * completed. Create a new session instead of reusing a disposed instance.\n   *\n   * **Suggested action**: Call {@link SerialSession.dispose$} only when\n   * permanently tearing down a session, then create a new one if needed.\n   */\n  SESSION_DISPOSED = 'SESSION_DISPOSED',\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 { type Observable, map, scan, shareReplay } from 'rxjs';\nimport { createNewlineTokenizer } from '../internal/newline-tokenizer';\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  const tokenizer = createNewlineTokenizer('terminal');\n  tokenizer.restorePending(state.currentLine);\n  const events = tokenizer.feed(chunk);\n\n  let { completed } = state;\n  for (const event of events) {\n    if (event.type === 'line') {\n      completed += event.content + '\\n';\n    }\n  }\n\n  return {\n    completed,\n    currentLine: tokenizer.getPendingText(),\n  };\n}\n\n/** @internal */\nexport function terminalDisplayText(state: TerminalBufferState): string {\n  return state.completed + state.currentLine;\n}\n\n/** Resolved limits for {@link trimTerminalState}. `0` means unlimited. */\nexport interface TerminalBufferLimits {\n  maxLines: number;\n  maxChars: number;\n}\n\n/** @internal Count newline-terminated rows in `completed`. */\nexport function countCompletedLines(completed: string): number {\n  if (completed.length === 0) {\n    return 0;\n  }\n  let count = 0;\n  for (let i = 0; i < completed.length; i++) {\n    if (completed.charAt(i) === '\\n') {\n      count++;\n    }\n  }\n  return count;\n}\n\n/**\n * Drops oldest completed lines when `maxLines` is exceeded.\n *\n * @internal Exported for unit tests.\n */\nexport function trimCompletedByMaxLines(\n  completed: string,\n  maxLines: number,\n): string {\n  if (maxLines <= 0) {\n    return completed;\n  }\n\n  let trimmed = completed;\n  while (countCompletedLines(trimmed) > maxLines) {\n    const firstNewline = trimmed.indexOf('\\n');\n    if (firstNewline < 0) {\n      break;\n    }\n    trimmed = trimmed.slice(firstNewline + 1);\n  }\n  return trimmed;\n}\n\n/**\n * Trims {@link TerminalBufferState} to respect memory limits. Oldest\n * `completed` content is removed first; `currentLine` is trimmed only when\n * the display text still exceeds `maxChars` after `completed` is empty.\n *\n * @internal Exported for unit tests.\n */\nexport function trimTerminalState(\n  state: TerminalBufferState,\n  limits: TerminalBufferLimits,\n): TerminalBufferState {\n  let { completed, currentLine } = state;\n\n  if (limits.maxLines > 0) {\n    completed = trimCompletedByMaxLines(completed, limits.maxLines);\n  }\n\n  if (limits.maxChars > 0) {\n    let total = completed.length + currentLine.length;\n    while (total > limits.maxChars) {\n      const excess = total - limits.maxChars;\n      if (completed.length >= excess) {\n        completed = completed.slice(excess);\n        break;\n      }\n      const removeFromCurrent = excess - completed.length;\n      completed = '';\n      currentLine = currentLine.slice(removeFromCurrent);\n      total = completed.length + currentLine.length;\n    }\n  }\n\n  return { completed, 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\n/** Options for {@link createTerminalBuffer} memory limits. `0` means unlimited. */\nexport interface TerminalBufferOptions {\n  /**\n   * Maximum number of completed lines to retain in the display buffer.\n   *\n   * @default 10000\n   */\n  maxLines?: number;\n\n  /**\n   * Maximum total characters in the cumulative display text\n   * (`completed` + `currentLine`). Oldest content is dropped first.\n   *\n   * @default 1048576\n   */\n  maxChars?: number;\n}\n\n/** Default limits applied when options are omitted. */\nexport const DEFAULT_TERMINAL_BUFFER_OPTIONS: Required<TerminalBufferOptions> =\n  {\n    maxLines: 10_000,\n    maxChars: 1_048_576,\n  };\n\nfunction resolveTerminalBufferLimits(\n  options?: TerminalBufferOptions,\n): TerminalBufferLimits {\n  return {\n    ...DEFAULT_TERMINAL_BUFFER_OPTIONS,\n    ...options,\n  };\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 *\n * By default, retains at most {@link DEFAULT_TERMINAL_BUFFER_OPTIONS.maxLines}\n * completed lines and {@link DEFAULT_TERMINAL_BUFFER_OPTIONS.maxChars} characters\n * so long-running sessions do not grow memory without bound. Pass `0` for either\n * limit to disable that constraint.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/370 | Issue #370}\n */\nexport function createTerminalBuffer(\n  receive$: Observable<string>,\n  options?: TerminalBufferOptions,\n): TerminalBuffer {\n  const limits = resolveTerminalBufferLimits(options);\n\n  const text$ = receive$.pipe(\n    scan((state, chunk: string) => {\n      const next = applyTerminalChunk(state, chunk);\n      return trimTerminalState(next, limits);\n    }, initialTerminalState),\n    map(terminalDisplayText),\n    shareReplay({ bufferSize: 1, refCount: true }),\n  );\n\n  return { text$ };\n}\n", "/**\n * Shared CR/LF/CRLF scanner for {@link createLineBuffer} and\n * {@link applyTerminalChunk}. Mode controls intentional semantic differences\n * between line-delimited output and terminal display redraw.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/376 | Issue #376}\n */\nexport type NewlineTokenizerMode = 'line' | 'terminal';\n\nexport type NewlineEvent =\n  | { type: 'line'; content: string }\n  | { type: 'carriage-return' };\n\nexport interface NewlineTokenizer {\n  feed(chunk: string): NewlineEvent[];\n  clear(): void;\n  /** Replaces the incomplete tail (used when folding external state in). */\n  restorePending(text: string): void;\n  /** Incomplete tail retained across feeds (line mode may end with `\\r`). */\n  getPendingText(): string;\n  /**\n   * Discards leading characters when pending text exceeds `maxChars`.\n   * @returns `true` when trimming occurred.\n   */\n  trimPending(maxChars: number): boolean;\n}\n\n/**\n * Creates a streaming newline tokenizer.\n *\n * - **line**: interior lone `\\r` completes a line (#237); trailing `\\r` is\n *   deferred until the next chunk disambiguates `\\r` vs `\\r\\n`.\n * - **terminal**: lone `\\r` clears the current line (#275); trailing `\\r`\n *   applies immediately.\n */\nexport function createNewlineTokenizer(\n  mode: NewlineTokenizerMode,\n): NewlineTokenizer {\n  let pending = '';\n  let deferredTrailingCr = false;\n\n  const clear = (): void => {\n    pending = '';\n    deferredTrailingCr = false;\n  };\n\n  const restorePending = (text: string): void => {\n    pending = text;\n    deferredTrailingCr = false;\n  };\n\n  const feed = (chunk: string): NewlineEvent[] => {\n    const events: NewlineEvent[] = [];\n    let i = 0;\n\n    if (mode === 'line' && deferredTrailingCr) {\n      deferredTrailingCr = false;\n      if (chunk.length > 0 && chunk.charAt(0) === '\\n') {\n        events.push({ type: 'line', content: pending });\n        pending = '';\n        i = 1;\n      } else {\n        events.push({ type: 'line', content: pending });\n        pending = '';\n      }\n    }\n\n    const len = chunk.length;\n    for (; 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          events.push({ type: 'line', content: pending });\n          pending = '';\n          i++;\n          continue;\n        }\n\n        if (mode === 'line') {\n          if (next !== '') {\n            events.push({ type: 'line', content: pending });\n            pending = '';\n            continue;\n          }\n          deferredTrailingCr = true;\n          break;\n        }\n\n        events.push({ type: 'carriage-return' });\n        pending = '';\n        continue;\n      }\n\n      if (c === '\\n') {\n        events.push({ type: 'line', content: pending });\n        pending = '';\n        continue;\n      }\n\n      pending += c;\n    }\n\n    return events;\n  };\n\n  const trimPending = (maxChars: number): boolean => {\n    if (maxChars <= 0) {\n      return false;\n    }\n\n    const text = deferredTrailingCr ? `${pending}\\r` : pending;\n    if (text.length <= maxChars) {\n      return false;\n    }\n\n    const trimmed = text.slice(text.length - maxChars);\n    if (trimmed.endsWith('\\r')) {\n      pending = trimmed.slice(0, -1);\n      deferredTrailingCr = true;\n    } else {\n      pending = trimmed;\n      deferredTrailingCr = false;\n    }\n    return true;\n  };\n\n  return {\n    feed,\n    clear,\n    restorePending,\n    getPendingText: () => (deferredTrailingCr ? `${pending}\\r` : pending),\n    trimPending,\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", "import { createNewlineTokenizer } from '../../internal/newline-tokenizer';\n\n/**\n * Options for {@link createLineBuffer}.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}\n */\nexport interface LineBufferOptions {\n  /**\n   * Maximum characters retained in the incomplete line tail (no line terminator yet).\n   * When exceeded, leading characters are discarded. `0` means unlimited.\n   *\n   * @default 1048576\n   */\n  maxChars?: number;\n}\n\n/** Default limits applied when {@link LineBufferOptions} fields are omitted. */\nexport const DEFAULT_LINE_BUFFER_OPTIONS: Required<LineBufferOptions> = {\n  maxChars: 1_048_576,\n};\n\n/** Result of {@link createLineBuffer.feed}. */\nexport interface LineBufferFeedResult {\n  lines: string[];\n  /** `true` when leading characters were discarded due to `maxChars`. */\n  overflowed: boolean;\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(options?: LineBufferOptions): {\n  feed(chunk: string): LineBufferFeedResult;\n  clear(): void;\n} {\n  const limits: Required<LineBufferOptions> = {\n    ...DEFAULT_LINE_BUFFER_OPTIONS,\n    ...options,\n  };\n\n  const tokenizer = createNewlineTokenizer('line');\n\n  const clear = (): void => {\n    tokenizer.clear();\n  };\n\n  const feed = (chunk: string): LineBufferFeedResult => {\n    const events = tokenizer.feed(chunk);\n    const out: string[] = [];\n\n    for (const event of events) {\n      if (event.type === 'line') {\n        out.push(event.content);\n      }\n    }\n\n    const overflowed = tokenizer.trimPending(limits.maxChars);\n\n    return { lines: out, overflowed };\n  };\n\n  return { feed, clear };\n}\n", "import { Observable, Subject } from 'rxjs';\n\n/**\n * Options for {@link createReceiveReplayBuffer}.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/372 | Issue #372}\n */\nexport interface ReceiveReplayBufferOptions {\n  /** Maximum number of chunks to retain. */\n  bufferSize: number;\n  /**\n   * Maximum total characters across retained chunks. `0` disables the limit.\n   */\n  maxChars: number;\n}\n\n/** Result of {@link ReceiveReplayBuffer.next}. */\nexport interface ReceiveReplayBufferNextResult {\n  /** `true` when oldest chunks were discarded to satisfy limits. */\n  overflowed: boolean;\n}\n\n/**\n * Bounded replay buffer for {@link SerialSession.receiveReplay$}.\n * Replays retained chunks to new subscribers, then forwards live emissions.\n *\n * @internal\n */\nexport interface ReceiveReplayBuffer {\n  next(chunk: string): ReceiveReplayBufferNextResult;\n  asObservable(): Observable<string>;\n  complete(): void;\n}\n\nfunction totalChars(chunks: string[]): number {\n  return chunks.reduce((sum, chunk) => sum + chunk.length, 0);\n}\n\n/**\n * Create a per-connection receive replay buffer.\n *\n * @internal\n */\nexport function createReceiveReplayBuffer(\n  options: ReceiveReplayBufferOptions,\n): ReceiveReplayBuffer {\n  const chunks: string[] = [];\n  const live$ = new Subject<string>();\n  let completed = false;\n\n  const trim = (): boolean => {\n    let overflowed = false;\n\n    while (chunks.length > options.bufferSize) {\n      chunks.shift();\n      overflowed = true;\n    }\n\n    if (options.maxChars > 0) {\n      let chars = totalChars(chunks);\n      while (chars > options.maxChars && chunks.length > 1) {\n        chars -= chunks.shift()!.length;\n        overflowed = true;\n      }\n    }\n\n    return overflowed;\n  };\n\n  const next = (chunk: string): ReceiveReplayBufferNextResult => {\n    if (completed) {\n      return { overflowed: false };\n    }\n\n    chunks.push(chunk);\n    const overflowed = trim();\n    live$.next(chunk);\n    return { overflowed };\n  };\n\n  const asObservable = (): Observable<string> =>\n    new Observable((subscriber) => {\n      for (const chunk of chunks) {\n        subscriber.next(chunk);\n      }\n      if (completed) {\n        subscriber.complete();\n        return;\n      }\n      return live$.subscribe(subscriber);\n    });\n\n  const complete = (): void => {\n    if (completed) {\n      return;\n    }\n    completed = true;\n    chunks.length = 0;\n    live$.complete();\n  };\n\n  return { next, asObservable, complete };\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 * Callback invoked when the read loop ends naturally (`reader.read()`\n * resolved with `done: true`) while the pump is still active.\n *\n * @internal\n */\nexport type ReadPumpDoneHandler = () => void;\n\n/**\n * Options accepted by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPumpOptions {\n  onChunk: ReadPumpChunkHandler;\n  onError: ReadPumpErrorHandler;\n  onDone?: ReadPumpDoneHandler;\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, onDone }: 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          if (!stopped) {\n            onDone?.();\n          }\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", "import type { TerminalBufferOptions } from '../terminal/create-terminal-buffer';\nimport { DEFAULT_TERMINAL_BUFFER_OPTIONS } from '../terminal/create-terminal-buffer';\nimport { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport {\n  DEFAULT_LINE_BUFFER_OPTIONS,\n  type LineBufferOptions,\n} from './internal/line-buffer';\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   * Limits for {@link SerialSession.terminalText$} display memory. Oldest\n   * completed lines and leading characters are dropped when exceeded.\n   *\n   * @default `{ maxLines: 10000, maxChars: 1048576 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})\n   * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/370 | Issue #370}\n   */\n  terminalBuffer?: TerminalBufferOptions;\n\n  /**\n   * Limits for the incomplete line tail held by {@link SerialSession.lines$}\n   * framing. When exceeded, leading characters are discarded and a non-fatal\n   * {@link SerialErrorCode.LINE_BUFFER_OVERFLOW} is emitted on {@link SerialSession.errors$}.\n   *\n   * @default `{ maxChars: 1048576 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})\n   * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}\n   */\n  lineBuffer?: LineBufferOptions;\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 * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/372 | Issue #372}\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  /**\n   * Maximum total characters retained across buffered replay chunks for the\n   * active connection. When exceeded, oldest chunks are discarded. `0` means\n   * unlimited (only `bufferSize` applies).\n   *\n   * @default 0\n   */\n  maxChars?: number;\n}\n\n/** Maximum allowed {@link SerialSessionReceiveReplayOptions.bufferSize}. */\nexport const MAX_RECEIVE_REPLAY_BUFFER_SIZE = 65_536;\n\n/** Maximum allowed {@link SerialSessionReceiveReplayOptions.maxChars}. */\nexport const MAX_RECEIVE_REPLAY_MAX_CHARS = 1_048_576;\n\nconst DEFAULT_RECEIVE_REPLAY: Required<SerialSessionReceiveReplayOptions> = {\n  enabled: false,\n  bufferSize: 512,\n  maxChars: 0,\n};\n\n/**\n * Merge and validate {@link SerialSessionReceiveReplayOptions}.\n *\n * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS}\n *         when `bufferSize` or `maxChars` are out of range.\n */\nexport function resolveReceiveReplayOptions(\n  options?: SerialSessionReceiveReplayOptions,\n): Required<SerialSessionReceiveReplayOptions> {\n  const merged: Required<SerialSessionReceiveReplayOptions> = {\n    ...DEFAULT_RECEIVE_REPLAY,\n    ...options,\n  };\n\n  const { bufferSize, maxChars } = merged;\n\n  if (\n    !Number.isSafeInteger(bufferSize) ||\n    bufferSize < 1 ||\n    bufferSize > MAX_RECEIVE_REPLAY_BUFFER_SIZE\n  ) {\n    throw new SerialError(\n      SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS,\n      `Invalid receiveReplay.bufferSize: ${bufferSize}. Must be a safe integer between 1 and ${MAX_RECEIVE_REPLAY_BUFFER_SIZE}.`,\n    );\n  }\n\n  if (\n    !Number.isSafeInteger(maxChars) ||\n    maxChars < 0 ||\n    maxChars > MAX_RECEIVE_REPLAY_MAX_CHARS\n  ) {\n    throw new SerialError(\n      SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS,\n      `Invalid receiveReplay.maxChars: ${maxChars}. Must be a safe integer between 0 and ${MAX_RECEIVE_REPLAY_MAX_CHARS}.`,\n    );\n  }\n\n  return merged;\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' | 'terminalBuffer' | 'lineBuffer'>\n> & {\n  filters?: SerialPortFilter[];\n  receiveReplay: Required<SerialSessionReceiveReplayOptions>;\n  terminalBuffer: Required<TerminalBufferOptions>;\n  lineBuffer: Required<LineBufferOptions>;\n} = {\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  terminalBuffer: { ...DEFAULT_TERMINAL_BUFFER_OPTIONS },\n  lineBuffer: { ...DEFAULT_LINE_BUFFER_OPTIONS },\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  Disposed: 'disposed',\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 * (any) -> disposed        (permanent teardown via dispose$)\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, S.Disposed],\n  [S.Connecting]: [S.Connected, S.Error, S.Idle, S.Disposed],\n  [S.Connected]: [S.Disconnecting, S.Error, S.Disposed],\n  [S.Disconnecting]: [S.Idle, S.Error, S.Disposed],\n  [S.Error]: [S.Idle, S.Connecting, S.Disposed],\n  [S.Unsupported]: [S.Disposed],\n  [S.Disposed]: [],\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  toDisposed(): boolean {\n    return this.transition(S.Disposed);\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", "map", "Observable", "Subject", "SerialErrorCode", "Observable", "Subject", "map", "BehaviorSubject", "Observable", "options", "overflowed"]
 }

package/dist/internal/newline-tokenizer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared CR/LF/CRLF scanner for {@link createLineBuffer} and
+ * {@link applyTerminalChunk}. Mode controls intentional semantic differences
+ * between line-delimited output and terminal display redraw.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/376 | Issue #376}
+ */
+export type NewlineTokenizerMode = 'line' | 'terminal';
+export type NewlineEvent = {
+    type: 'line';
+    content: string;
+} | {
+    type: 'carriage-return';
+};
+export interface NewlineTokenizer {
+    feed(chunk: string): NewlineEvent[];
+    clear(): void;
+    /** Replaces the incomplete tail (used when folding external state in). */
+    restorePending(text: string): void;
+    /** Incomplete tail retained across feeds (line mode may end with `\r`). */
+    getPendingText(): string;
+    /**
+     * Discards leading characters when pending text exceeds `maxChars`.
+     * @returns `true` when trimming occurred.
+     */
+    trimPending(maxChars: number): boolean;
+}
+/**
+ * Creates a streaming newline tokenizer.
+ *
+ * - **line**: interior lone `\r` completes a line (#237); trailing `\r` is
+ *   deferred until the next chunk disambiguates `\r` vs `\r\n`.
+ * - **terminal**: lone `\r` clears the current line (#275); trailing `\r`
+ *   applies immediately.
+ */
+export declare function createNewlineTokenizer(mode: NewlineTokenizerMode): NewlineTokenizer;
+//# sourceMappingURL=newline-tokenizer.d.ts.map

package/dist/internal/newline-tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newline-tokenizer.d.ts","sourceRoot":"","sources":["../../src/internal/newline-tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEhC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,0EAA0E;IAC1E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,2EAA2E;IAC3E,cAAc,IAAI,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,CAiGlB"}

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

@@ -18,7 +18,8 @@ import { type SerialSessionOptions } from './serial-session-options';
  * - `connect$()` opens a user-selected port, starts the internal read pump,
  *   and transitions `idle -> connecting -> connected`.
  * - `disconnect$()` stops the read pump, closes the port, and transitions
- *   `connected -> disconnecting -> idle`.
+ *   `connected -> disconnecting -> idle`. When called during `connecting`,
+ *   it cancels the in-flight `connect$()` and returns to `idle`.
  * - `receive$` emits UTF-8 decoded text chunks pushed by the pump. It is
  *   **not** subscription-lazy - the pump is started by `connect$` and
  *   decoded text is multicast to all subscribers; late subscribers see only

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

@@ -1 +1 @@
-{"version":3,"file":"create-serial-session.d.ts","sourceRoot":"","sources":["../../src/session/create-serial-session.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAgBlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAiWf"}
+{"version":3,"file":"create-serial-session.d.ts","sourceRoot":"","sources":["../../src/session/create-serial-session.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAgBlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAugBf"}

package/dist/session/index.d.ts

@@ -2,4 +2,5 @@ export { createSerialSession } from './create-serial-session';
 export type { SerialSession } from './serial-session';
 export type { SerialSessionOptions, SerialSessionReceiveReplayOptions, } from './serial-session-options';
 export { SerialSessionState } from './serial-session-state';
+export { DEFAULT_LINE_BUFFER_OPTIONS, type LineBufferOptions, } from './internal/line-buffer';
 //# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/session/internal/line-buffer.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Options for {@link createLineBuffer}.
+ *
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}
+ */
+export interface LineBufferOptions {
+    /**
+     * Maximum characters retained in the incomplete line tail (no line terminator yet).
+     * When exceeded, leading characters are discarded. `0` means unlimited.
+     *
+     * @default 1048576
+     */
+    maxChars?: number;
+}
+/** Default limits applied when {@link LineBufferOptions} fields are omitted. */
+export declare const DEFAULT_LINE_BUFFER_OPTIONS: Required<LineBufferOptions>;
+/** Result of {@link createLineBuffer.feed}. */
+export interface LineBufferFeedResult {
+    lines: string[];
+    /** `true` when leading characters were discarded due to `maxChars`. */
+    overflowed: boolean;
+}
 /**
  * Streaming UTF-16 text to newline-delimited lines for {@link createSerialSession}.
  * Supports `\r\n` and `\n` per #237; a lone `\r` that is not the last character
@@ -7,8 +29,8 @@
  *
  * @internal
  */
-export declare function createLineBuffer(): {
-    feed(chunk: string): string[];
+export declare function createLineBuffer(options?: LineBufferOptions): {
+    feed(chunk: string): LineBufferFeedResult;
     clear(): void;
 };
 //# sourceMappingURL=line-buffer.d.ts.map

package/dist/session/internal/line-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"line-buffer.d.ts","sourceRoot":"","sources":["../../../src/session/internal/line-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf,CA8CA"}
+{"version":3,"file":"line-buffer.d.ts","sourceRoot":"","sources":["../../../src/session/internal/line-buffer.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAEnE,CAAC;AAEF,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf,CA4BA"}

package/dist/session/internal/receive-replay-buffer.d.ts

@@ -0,0 +1,37 @@
+import { Observable } from 'rxjs';
+/**
+ * Options for {@link createReceiveReplayBuffer}.
+ *
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/372 | Issue #372}
+ */
+export interface ReceiveReplayBufferOptions {
+    /** Maximum number of chunks to retain. */
+    bufferSize: number;
+    /**
+     * Maximum total characters across retained chunks. `0` disables the limit.
+     */
+    maxChars: number;
+}
+/** Result of {@link ReceiveReplayBuffer.next}. */
+export interface ReceiveReplayBufferNextResult {
+    /** `true` when oldest chunks were discarded to satisfy limits. */
+    overflowed: boolean;
+}
+/**
+ * Bounded replay buffer for {@link SerialSession.receiveReplay$}.
+ * Replays retained chunks to new subscribers, then forwards live emissions.
+ *
+ * @internal
+ */
+export interface ReceiveReplayBuffer {
+    next(chunk: string): ReceiveReplayBufferNextResult;
+    asObservable(): Observable<string>;
+    complete(): void;
+}
+/**
+ * Create a per-connection receive replay buffer.
+ *
+ * @internal
+ */
+export declare function createReceiveReplayBuffer(options: ReceiveReplayBufferOptions): ReceiveReplayBuffer;
+//# sourceMappingURL=receive-replay-buffer.d.ts.map

package/dist/session/internal/receive-replay-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive-replay-buffer.d.ts","sourceRoot":"","sources":["../../../src/session/internal/receive-replay-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAW,MAAM,MAAM,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,6BAA6B,CAAC;IACnD,YAAY,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,IAAI,IAAI,CAAC;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAyDrB"}

package/dist/session/read-pump.d.ts

@@ -19,6 +19,13 @@ export type ReadPumpChunkHandler = (text: string) => void;
  * @internal
  */
 export type ReadPumpErrorHandler = (error: SerialError) => void;
+/**
+ * Callback invoked when the read loop ends naturally (`reader.read()`
+ * resolved with `done: true`) while the pump is still active.
+ *
+ * @internal
+ */
+export type ReadPumpDoneHandler = () => void;
 /**
  * Options accepted by {@link createReadPump}.
  *
@@ -27,6 +34,7 @@ export type ReadPumpErrorHandler = (error: SerialError) => void;
 export interface ReadPumpOptions {
     onChunk: ReadPumpChunkHandler;
     onError: ReadPumpErrorHandler;
+    onDone?: ReadPumpDoneHandler;
 }
 /**
  * Handle returned by {@link createReadPump}.
@@ -70,5 +78,5 @@ export interface ReadPump {
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}
  */
-export declare function createReadPump(port: SerialPort, { onChunk, onError }: ReadPumpOptions): ReadPump;
+export declare function createReadPump(port: SerialPort, { onChunk, onError, onDone }: ReadPumpOptions): ReadPump;
 //# sourceMappingURL=read-pump.d.ts.map

package/dist/session/read-pump.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-pump.d.ts","sourceRoot":"","sources":["../../src/session/read-pump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,eAAe,GACpC,QAAQ,CA8FV"}
+{"version":3,"file":"read-pump.d.ts","sourceRoot":"","sources":["../../src/session/read-pump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,eAAe,GAC5C,QAAQ,CAiGV"}