@gurezo/web-serial-rxjs 2.4.0 → 3.0.0

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

@@ -13,8 +13,8 @@ import { type SerialSessionOptions } from './serial-session-options';
  * Key behaviors:
  *
  * - `isBrowserSupported()` returns whether `navigator.serial` is available.
- * - `state$` replays the current lifecycle state driven by
- *   {@link SessionStateMachine}.
+ * - `state$` replays the current lifecycle state driven by the internal
+ *   {@link SessionRuntime} controller.
  * - `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
@@ -45,6 +45,9 @@ import { type SerialSessionOptions } from './serial-session-options';
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/397 | Issue #397}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/399 | Issue #399}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/401 | Issue #401}
  */
 export declare function createSerialSession(options?: SerialSessionOptions): SerialSession;
 //# sourceMappingURL=create-serial-session.d.ts.map

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":"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"}
+{"version":3,"file":"create-serial-session.d.ts","sourceRoot":"","sources":["../../src/session/create-serial-session.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAQlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CA4Gf"}

package/dist/session/index.d.ts

@@ -1,6 +1,10 @@
 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 type { SerialSessionOptions, SerialSessionReceiveReplayOptions, ResolvedSerialSessionOptions, } from './serial-session-options';
+export { resolveSerialSessionOptions } from './serial-session-options';
+export { MAX_RECEIVE_REPLAY_BUFFER_SIZE, MAX_RECEIVE_REPLAY_MAX_CHARS, } from './serial-session-options';
+export type { SerialPayload, SerialConnectionOptions } from '../types';
+export { SerialSessionStatus } from './serial-session-state';
+export type { SerialSessionState, IdleSessionState, ConnectingSessionState, ConnectedSessionState, DisconnectingSessionState, UnsupportedSessionState, ErrorSessionState, DisposedSessionState, } 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;AAC5D,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,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,EACjC,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/session/internal/build-request-options.d.ts

@@ -1,16 +1,16 @@
 import type { SerialSessionOptions } from '../serial-session-options';
 /**
- * Build {@link SerialPortRequestOptions} from {@link SerialSessionOptions}.
+ * Build {@link SerialPortRequestOptions} from resolved {@link SerialSessionOptions}.
  *
- * Converts the `filters` field of {@link SerialSessionOptions} into the
- * shape expected by `navigator.serial.requestPort` and validates USB
- * vendor / product identifiers. Returns `undefined` when no filters are
+ * Converts the `filters` field into the shape expected by
+ * `navigator.serial.requestPort`. Returns `undefined` when no filters are
  * supplied so the browser shows all available ports.
  *
- * @param options - The session options supplied by the caller.
+ * Filter validation is performed earlier by
+ * {@link resolveSerialSessionOptions} at factory time.
+ *
+ * @param options - Resolved session options (filters already validated).
  * @returns The request options, or `undefined` when no filters are set.
- * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_FILTER_OPTIONS}
- *         when a filter is empty or contains out-of-range IDs.
  *
  * @internal
  */

package/dist/session/internal/build-request-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-options.d.ts","sourceRoot":"","sources":["../../../src/session/internal/build-request-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,wBAAwB,GAAG,SAAS,CA2CtC"}
+{"version":3,"file":"build-request-options.d.ts","sourceRoot":"","sources":["../../../src/session/internal/build-request-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,wBAAwB,GAAG,SAAS,CAQtC"}

package/dist/session/internal/error-severity.d.ts

@@ -0,0 +1,38 @@
+import { SerialErrorCode } from '../../errors/serial-error-code';
+/**
+ * Internal error classification used by the single `reportError` entry
+ * point. `'fatal'` errors drive `state$` into `'error'` and tear down
+ * the live session (pump stop + port close); `'non-fatal'` errors are
+ * only multiplexed on `errors$` without mutating session state.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/399 | Issue #399}
+ */
+export type ReportErrorSeverity = 'fatal' | 'non-fatal';
+/**
+ * Maps each {@link SerialErrorCode} that can surface through session
+ * `reportError` to its severity. Unmapped codes fall back to `'fatal'`
+ * in {@link resolveErrorSeverity}.
+ *
+ * @internal
+ */
+export declare const ERROR_SEVERITY: {
+    readonly READ_FAILED: "fatal";
+    readonly CONNECTION_LOST: "fatal";
+    readonly PORT_OPEN_FAILED: "fatal";
+    readonly OPERATION_CANCELLED: "fatal";
+    readonly UNKNOWN: "fatal";
+    readonly LINE_BUFFER_OVERFLOW: "non-fatal";
+    readonly RECEIVE_REPLAY_BUFFER_OVERFLOW: "non-fatal";
+    readonly BROWSER_NOT_SUPPORTED: "non-fatal";
+    readonly PORT_ALREADY_OPEN: "non-fatal";
+    readonly PORT_NOT_OPEN: "non-fatal";
+    readonly WRITE_FAILED: "non-fatal";
+};
+/**
+ * Resolve the reporting severity for a normalised {@link SerialErrorCode}.
+ *
+ * @internal
+ */
+export declare function resolveErrorSeverity(code: SerialErrorCode): ReportErrorSeverity;
+//# sourceMappingURL=error-severity.d.ts.map

package/dist/session/internal/error-severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-severity.d.ts","sourceRoot":"","sources":["../../../src/session/internal/error-severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,WAAW,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY+C,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,GACpB,mBAAmB,CAKrB"}

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

@@ -1,3 +1,4 @@
+import type { MaxChars } from '../../internal/branded-numbers';
 /**
  * Options for {@link createLineBuffer}.
  *
@@ -20,6 +21,19 @@ export interface LineBufferFeedResult {
     /** `true` when leading characters were discarded due to `maxChars`. */
     overflowed: boolean;
 }
+/**
+ * Handle returned by {@link createLineBuffer}.
+ *
+ * @internal
+ */
+export interface LineBuffer {
+    feed(chunk: string): LineBufferFeedResult;
+    clear(): void;
+}
+/** @internal Resolved limits for {@link createLineBuffer}. */
+export interface LineBufferLimits {
+    maxChars: MaxChars;
+}
 /**
  * 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
@@ -29,8 +43,5 @@ export interface LineBufferFeedResult {
  *
  * @internal
  */
-export declare function createLineBuffer(options?: LineBufferOptions): {
-    feed(chunk: string): LineBufferFeedResult;
-    clear(): void;
-};
+export declare function createLineBuffer(options?: LineBufferOptions | LineBufferLimits): LineBuffer;
 //# 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":"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"}
+{"version":3,"file":"line-buffer.d.ts","sourceRoot":"","sources":["../../../src/session/internal/line-buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;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;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAC7C,UAAU,CA6BZ"}

package/dist/session/internal/receive-pipeline.d.ts

@@ -0,0 +1,34 @@
+import { type Observable } from 'rxjs';
+import { SerialError } from '../../errors/serial-error';
+import type { NormalizeSerialErrorOptions } from '../normalize-serial-error';
+import type { ResolvedSerialSessionOptions } from '../serial-session-options';
+/**
+ * Dependencies for {@link createReceivePipeline}.
+ *
+ * @internal
+ */
+export interface ReceivePipelineDeps {
+    resolvedOptions: ResolvedSerialSessionOptions;
+    reportError: (error: unknown, options: NormalizeSerialErrorOptions) => SerialError;
+}
+/**
+ * Receive-side stream wiring for {@link createSerialSession}.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/401 | Issue #401}
+ */
+export interface ReceivePipeline {
+    receive$: Observable<string>;
+    lines$: Observable<string>;
+    receiveReplay$: Observable<string>;
+    clearReplay: () => void;
+    startLiveReceiveReplay: () => void;
+    clearLineBuffer: () => void;
+    handleChunk: (text: string) => void;
+    complete: () => void;
+}
+/**
+ * @internal
+ */
+export declare function createReceivePipeline(deps: ReceivePipelineDeps): ReceivePipeline;
+//# sourceMappingURL=receive-pipeline.d.ts.map

package/dist/session/internal/receive-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive-pipeline.d.ts","sourceRoot":"","sources":["../../../src/session/internal/receive-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAIhB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAOxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GACxB,eAAe,CAuGjB"}

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

@@ -1,4 +1,5 @@
 import { Observable } from 'rxjs';
+import type { MaxChars, ReceiveReplayBufferSize } from '../../internal/branded-numbers';
 /**
  * Options for {@link createReceiveReplayBuffer}.
  *
@@ -6,11 +7,11 @@ import { Observable } from 'rxjs';
  */
 export interface ReceiveReplayBufferOptions {
     /** Maximum number of chunks to retain. */
-    bufferSize: number;
+    bufferSize: ReceiveReplayBufferSize;
     /**
      * Maximum total characters across retained chunks. `0` disables the limit.
      */
-    maxChars: number;
+    maxChars: MaxChars;
 }
 /** Result of {@link ReceiveReplayBuffer.next}. */
 export interface ReceiveReplayBufferNextResult {

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

@@ -1 +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"}
+{"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;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,uBAAuB,EACxB,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,0CAA0C;IAC1C,UAAU,EAAE,uBAAuB,CAAC;IACpC;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACpB;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/internal/session-error-reporter.d.ts

@@ -0,0 +1,32 @@
+import type { Subject } from 'rxjs';
+import { SerialError } from '../../errors/serial-error';
+import { type NormalizeSerialErrorOptions } from '../normalize-serial-error';
+import type { ReadPump } from '../read-pump';
+import type { SendQueue } from '../send-queue';
+import { type SessionRuntimeController } from '../session-runtime';
+/**
+ * Dependencies for {@link createSessionErrorReporter}.
+ *
+ * @internal
+ */
+export interface SessionErrorReporterDeps {
+    controller: SessionRuntimeController;
+    errorsSubject: Subject<SerialError>;
+    sendQueue: SendQueue;
+    isDisposed: () => boolean;
+    updatePortInfo: (port: SerialPort | null) => void;
+    teardownPump: (pump: ReadPump | null) => Promise<void>;
+    closePortSafely: (port: SerialPort | null) => Promise<void>;
+}
+/**
+ * Centralised error reporting for {@link createSerialSession}.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/401 | Issue #401}
+ */
+export declare function createSessionErrorReporter(deps: SessionErrorReporterDeps): {
+    reportError: (error: unknown, options: NormalizeSerialErrorOptions) => SerialError;
+    createDisposedError: () => SerialError;
+};
+//# sourceMappingURL=session-error-reporter.d.ts.map

package/dist/session/internal/session-error-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-error-reporter.d.ts","sourceRoot":"","sources":["../../../src/session/internal/session-error-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,wBAAwB,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG;IAC1E,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;IACjB,mBAAmB,EAAE,MAAM,WAAW,CAAC;CACxC,CAyDA"}

package/dist/session/internal/session-lifecycle.d.ts

@@ -0,0 +1,44 @@
+import { type BehaviorSubject, Observable, type Subject } from 'rxjs';
+import { SerialError } from '../../errors/serial-error';
+import type { ReceivePipeline } from './receive-pipeline';
+import { type NormalizeSerialErrorOptions } from '../normalize-serial-error';
+import { type ReadPump } from '../read-pump';
+import type { SendQueue } from '../send-queue';
+import type { ResolvedSerialSessionOptions } from '../serial-session-options';
+import { type SessionRuntimeController } from '../session-runtime';
+/**
+ * Dependencies for {@link createSessionLifecycle}.
+ *
+ * @internal
+ */
+export interface SessionLifecycleDeps {
+    controller: SessionRuntimeController;
+    resolvedOptions: ResolvedSerialSessionOptions;
+    sendQueue: SendQueue;
+    receivePipeline: ReceivePipeline;
+    portInfoSubject: BehaviorSubject<SerialPortInfo | null>;
+    errorsSubject: Subject<SerialError>;
+    isDisposed: () => boolean;
+    reportError: (error: unknown, options: NormalizeSerialErrorOptions) => SerialError;
+    createDisposedError: () => SerialError;
+}
+/**
+ * Port and pump lifecycle operations for {@link createSerialSession}.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/401 | Issue #401}
+ */
+export interface SessionLifecycle {
+    connect$: () => Observable<void>;
+    disconnect$: () => Observable<void>;
+    dispose$: () => Observable<void>;
+    writeToPort: (payload: Uint8Array) => Promise<void>;
+    teardownPump: (pump: ReadPump | null) => Promise<void>;
+    closePortSafely: (port: SerialPort | null) => Promise<void>;
+    updatePortInfo: (port: SerialPort | null) => void;
+}
+/**
+ * @internal
+ */
+export declare function createSessionLifecycle(deps: SessionLifecycleDeps): SessionLifecycle;
+//# sourceMappingURL=session-lifecycle.d.ts.map

package/dist/session/internal/session-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/session/internal/session-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EASL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,wBAAwB,CAAC;IACrC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;IACjB,mBAAmB,EAAE,MAAM,WAAW,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,CAgVlB"}

package/dist/session/internal/validate-serial-port-filters.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validate {@link SerialPortFilter} entries for session creation.
+ *
+ * @param filters - Optional filters from {@link SerialSessionOptions}.
+ * @returns The same filters reference when valid, or `undefined` when omitted/empty.
+ * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_FILTER_OPTIONS}
+ *         when a filter is empty or contains out-of-range IDs.
+ *
+ * @internal
+ */
+export declare function validateSerialPortFilters(filters?: SerialPortFilter[]): SerialPortFilter[] | undefined;
+//# sourceMappingURL=validate-serial-port-filters.d.ts.map

package/dist/session/internal/validate-serial-port-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-serial-port-filters.d.ts","sourceRoot":"","sources":["../../../src/session/internal/validate-serial-port-filters.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,gBAAgB,EAAE,GAC3B,gBAAgB,EAAE,GAAG,SAAS,CAyChC"}

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

@@ -1,11 +1,21 @@
+import { type BaudRate, type MaxChars, type MaxLines, type ReceiveReplayBufferSize, type SerialPortBufferSize } from '../internal/branded-numbers';
 import type { TerminalBufferOptions } from '../terminal/create-terminal-buffer';
 import { type LineBufferOptions } from './internal/line-buffer';
+/**
+ * W3C connection fields shared with {@link SerialOptions}.
+ *
+ * @internal
+ */
+type SerialSessionConnectionFields = Pick<SerialOptions, 'baudRate' | 'dataBits' | 'stopBits' | 'parity' | 'bufferSize' | 'flowControl'>;
 /**
  * Options for creating a {@link SerialSession} via {@link createSerialSession}.
  *
- * These options configure the serial port connection parameters used when
- * calling `port.open` and `navigator.serial.requestPort`. All properties
- * are optional; omitted fields fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}.
+ * Connection parameters (`baudRate`, `dataBits`, `stopBits`, `parity`,
+ * `bufferSize`, `flowControl`) are derived from the W3C {@link SerialOptions}
+ * type and passed to `port.open`. All connection fields are optional here;
+ * omitted values fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}
+ * (`baudRate` 9600, `dataBits` 8, `stopBits` 1, `parity` `'none'`,
+ * `bufferSize` 255, `flowControl` `'none'`).
  *
  * @example
  * ```typescript
@@ -19,49 +29,12 @@ import { type LineBufferOptions } from './internal/line-buffer';
  * });
  * ```
  *
+ * @see {@link SerialOptions}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/402 | Issue #402}
  */
-export interface SerialSessionOptions {
-    /**
-     * Baud rate for the serial port connection (bits per second).
-     *
-     * Common values include 9600, 19200, 38400, 57600, 115200, etc.
-     * Must match the baud rate configured on the connected device.
-     *
-     * @default 9600
-     */
-    baudRate?: number;
-    /**
-     * Number of data bits per character (7 or 8).
-     *
-     * @default 8
-     */
-    dataBits?: 7 | 8;
-    /**
-     * Number of stop bits (1 or 2).
-     *
-     * @default 1
-     */
-    stopBits?: 1 | 2;
-    /**
-     * Parity checking mode.
-     *
-     * @default 'none'
-     */
-    parity?: 'none' | 'even' | 'odd';
-    /**
-     * Buffer size for the underlying read stream, in bytes.
-     *
-     * @default 255
-     */
-    bufferSize?: number;
-    /**
-     * Flow control mode.
-     *
-     * @default 'none'
-     */
-    flowControl?: 'none' | 'hardware';
+export interface SerialSessionOptions extends Partial<SerialSessionConnectionFields> {
     /**
      * Filters for port selection when requesting a port.
      *
@@ -136,16 +109,89 @@ export declare const MAX_RECEIVE_REPLAY_MAX_CHARS = 1048576;
  * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS}
  *         when `bufferSize` or `maxChars` are out of range.
  */
-export declare function resolveReceiveReplayOptions(options?: SerialSessionReceiveReplayOptions): Required<SerialSessionReceiveReplayOptions>;
+/** Resolved receive replay options with validated branded numeric fields. */
+export type ResolvedSerialSessionReceiveReplayOptions = {
+    enabled: boolean;
+    bufferSize: ReceiveReplayBufferSize;
+    maxChars: MaxChars;
+};
+export declare function resolveReceiveReplayOptions(options?: SerialSessionReceiveReplayOptions): ResolvedSerialSessionReceiveReplayOptions;
+/**
+ * Merge and validate {@link TerminalBufferOptions}.
+ *
+ * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_TERMINAL_BUFFER_OPTIONS}
+ *         when `maxLines` or `maxChars` are out of range.
+ */
+/** Resolved terminal buffer options with validated branded numeric fields. */
+export type ResolvedTerminalBufferOptions = {
+    maxLines: MaxLines;
+    maxChars: MaxChars;
+};
+export declare function resolveTerminalBufferOptions(options?: TerminalBufferOptions): ResolvedTerminalBufferOptions;
+/**
+ * Merge and validate {@link LineBufferOptions}.
+ *
+ * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS}
+ *         when `maxChars` is out of range.
+ */
+/** Resolved line buffer options with validated branded numeric fields. */
+export type ResolvedLineBufferOptions = {
+    maxChars: MaxChars;
+};
+export declare function resolveLineBufferOptions(options?: LineBufferOptions): ResolvedLineBufferOptions;
+/**
+ * Fully resolved session options after merging {@link SerialSessionOptions}
+ * with {@link DEFAULT_SERIAL_SESSION_OPTIONS}. All invariant fields are
+ * required; `filters` remains optional.
+ */
+export type ResolvedSerialSessionOptions = Required<Omit<SerialSessionOptions, 'filters' | 'receiveReplay' | 'terminalBuffer' | 'lineBuffer' | 'baudRate' | 'bufferSize'>> & {
+    baudRate: BaudRate;
+    bufferSize: SerialPortBufferSize;
+    filters?: SerialPortFilter[];
+    receiveReplay: ResolvedSerialSessionReceiveReplayOptions;
+    terminalBuffer: ResolvedTerminalBufferOptions;
+    lineBuffer: ResolvedLineBufferOptions;
+};
 /**
  * Default values applied to omitted {@link SerialSessionOptions} fields.
  *
  * @internal
  */
-export declare const DEFAULT_SERIAL_SESSION_OPTIONS: Required<Omit<SerialSessionOptions, 'filters' | 'receiveReplay' | 'terminalBuffer' | 'lineBuffer'>> & {
-    filters?: SerialPortFilter[];
-    receiveReplay: Required<SerialSessionReceiveReplayOptions>;
-    terminalBuffer: Required<TerminalBufferOptions>;
-    lineBuffer: Required<LineBufferOptions>;
+export declare const DEFAULT_SERIAL_SESSION_OPTIONS: {
+    baudRate: BaudRate;
+    dataBits: 8;
+    stopBits: 1;
+    parity: "none";
+    bufferSize: SerialPortBufferSize;
+    flowControl: "none";
+    receiveReplay: ResolvedSerialSessionReceiveReplayOptions;
+    terminalBuffer: ResolvedTerminalBufferOptions;
+    lineBuffer: ResolvedLineBufferOptions;
+};
+/** Resolved W3C connection fields for {@link ResolvedSerialSessionOptions}. */
+export type ResolvedSerialSessionConnectionOptions = Required<Omit<SerialSessionConnectionFields, 'baudRate' | 'bufferSize'>> & {
+    baudRate: BaudRate;
+    bufferSize: SerialPortBufferSize;
 };
+/**
+ * Merge and validate W3C connection fields from {@link SerialSessionOptions}.
+ *
+ * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_CONNECTION_OPTIONS}
+ *         when `baudRate` is out of range.
+ */
+export declare function resolveConnectionOptions(options?: Pick<SerialSessionOptions, 'baudRate' | 'dataBits' | 'stopBits' | 'parity' | 'bufferSize' | 'flowControl'>): ResolvedSerialSessionConnectionOptions;
+/**
+ * Merge and validate {@link SerialSessionOptions} into a fully resolved
+ * options object for internal session use.
+ *
+ * @throws {@link SerialError} when option values are out of range:
+ *         {@link SerialErrorCode.INVALID_CONNECTION_OPTIONS},
+ *         {@link SerialErrorCode.INVALID_FILTER_OPTIONS},
+ *         {@link SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS},
+ *         {@link SerialErrorCode.INVALID_TERMINAL_BUFFER_OPTIONS}, or
+ *         {@link SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS}.
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/403 | Issue #403}
+ */
+export declare function resolveSerialSessionOptions(options?: SerialSessionOptions): ResolvedSerialSessionOptions;
+export {};
 //# sourceMappingURL=serial-session-options.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serial-session-options.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAIhF,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAEjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAElC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,iCAAiC,CAAC;IAElD;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,UAAY,CAAC;AAQtD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,iCAAiC,GAC1C,QAAQ,CAAC,iCAAiC,CAAC,CA+B7C;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CACnD,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,eAAe,GAAG,gBAAgB,GAAG,YAAY,CAAC,CAC1F,GAAG;IACF,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,EAAE,QAAQ,CAAC,iCAAiC,CAAC,CAAC;IAC3D,cAAc,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAChD,UAAU,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CAYzC,CAAC"}
+{"version":3,"file":"serial-session-options.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-options.ts"],"names":[],"mappings":"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"}

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

@@ -1,11 +1,9 @@
+import type { SerialError } from '../errors/serial-error';
 /**
- * Reactive lifecycle state for a {@link SerialSession}.
+ * Canonical status literals for a {@link SerialSession} lifecycle.
  *
- * This is the v2 API counterpart of the legacy `SerialState` used by
- * `SerialClient`. The runtime values are the same flat strings v1
- * consumers used for UI switches; the {@link SerialSessionState} const
- * object is the canonical source of those literals so call sites can
- * avoid string typos and get IDE completion.
+ * Use these constants when comparing {@link SerialSessionState.status}
+ * so call sites avoid string typos and get IDE completion.
  *
  * Lifecycle transitions:
  *
@@ -14,12 +12,12 @@
  *                                \-> error
  * (any)  -> unsupported   (when Web Serial API is unavailable)
  * (any)  -> error         (when an unrecoverable failure occurs)
+ * (any)  -> disposed      (when dispose$ completes)
  * ```
  *
- * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}
- * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/406 | Issue #406}
  */
-export declare const SerialSessionState: {
+export declare const SerialSessionStatus: {
     readonly Idle: "idle";
     readonly Connecting: "connecting";
     readonly Connected: "connected";
@@ -29,8 +27,47 @@ export declare const SerialSessionState: {
     readonly Disposed: "disposed";
 };
 /**
- * String union of allowed {@link SerialSessionState} runtime values
- * (same set as the values on the {@link SerialSessionState} object).
+ * String union of allowed {@link SerialSessionStatus} runtime values
+ * (same set as the values on the {@link SerialSessionStatus} object).
  */
-export type SerialSessionState = (typeof SerialSessionState)[keyof typeof SerialSessionState];
+export type SerialSessionStatus = (typeof SerialSessionStatus)[keyof typeof SerialSessionStatus];
+/** @see {@link SerialSessionState} */
+export interface IdleSessionState {
+    readonly status: typeof SerialSessionStatus.Idle;
+}
+/** @see {@link SerialSessionState} */
+export interface ConnectingSessionState {
+    readonly status: typeof SerialSessionStatus.Connecting;
+}
+/** @see {@link SerialSessionState} */
+export interface ConnectedSessionState {
+    readonly status: typeof SerialSessionStatus.Connected;
+    readonly portInfo: SerialPortInfo;
+}
+/** @see {@link SerialSessionState} */
+export interface DisconnectingSessionState {
+    readonly status: typeof SerialSessionStatus.Disconnecting;
+}
+/** @see {@link SerialSessionState} */
+export interface UnsupportedSessionState {
+    readonly status: typeof SerialSessionStatus.Unsupported;
+}
+/** @see {@link SerialSessionState} */
+export interface ErrorSessionState {
+    readonly status: typeof SerialSessionStatus.Error;
+    readonly error: SerialError;
+}
+/** @see {@link SerialSessionState} */
+export interface DisposedSessionState {
+    readonly status: typeof SerialSessionStatus.Disposed;
+}
+/**
+ * Discriminated union emitted by {@link SerialSession.state$}.
+ *
+ * Each variant carries the lifecycle `status` plus optional detail fields
+ * (`portInfo` when connected, `error` when in a fatal error state).
+ *
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/406 | Issue #406}
+ */
+export type SerialSessionState = IdleSessionState | ConnectingSessionState | ConnectedSessionState | DisconnectingSessionState | UnsupportedSessionState | ErrorSessionState | DisposedSessionState;
 //# sourceMappingURL=serial-session-state.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serial-session-state.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"serial-session-state.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,IAAI,CAAC;CAClD;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,UAAU,CAAC;CACxD;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,sCAAsC;AACtC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,aAAa,CAAC;CAC3D;AAED,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,WAAW,CAAC;CACzD;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,QAAQ,CAAC;CACtD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,sBAAsB,GACtB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,GACvB,iBAAiB,GACjB,oBAAoB,CAAC"}