@gurezo/web-serial-rxjs 2.4.0 → 3.1.0

package/dist/internal/branded-numbers.d.ts

@@ -0,0 +1,37 @@
+declare const baudRateBrand: unique symbol;
+/** Validated serial port baud rate (safe integer > 0). */
+export type BaudRate = number & {
+    readonly [baudRateBrand]: true;
+};
+declare const serialPortBufferSizeBrand: unique symbol;
+/** Validated W3C {@link SerialOptions} `bufferSize`. */
+export type SerialPortBufferSize = number & {
+    readonly [serialPortBufferSizeBrand]: true;
+};
+declare const receiveReplayBufferSizeBrand: unique symbol;
+/** Validated receive replay chunk count limit. */
+export type ReceiveReplayBufferSize = number & {
+    readonly [receiveReplayBufferSizeBrand]: true;
+};
+declare const maxCharsBrand: unique symbol;
+/** Validated character limit for buffers (`0` means unlimited). */
+export type MaxChars = number & {
+    readonly [maxCharsBrand]: true;
+};
+declare const maxLinesBrand: unique symbol;
+/** Validated line count limit for terminal display (`0` means unlimited). */
+export type MaxLines = number & {
+    readonly [maxLinesBrand]: true;
+};
+/** @internal Brand a validated baud rate. */
+export declare function brandBaudRate(value: number): BaudRate;
+/** @internal Brand a validated serial port buffer size. */
+export declare function brandSerialPortBufferSize(value: number): SerialPortBufferSize;
+/** @internal Brand a validated receive replay buffer size. */
+export declare function brandReceiveReplayBufferSize(value: number): ReceiveReplayBufferSize;
+/** @internal Brand a validated max character limit. */
+export declare function brandMaxChars(value: number): MaxChars;
+/** @internal Brand a validated max line limit. */
+export declare function brandMaxLines(value: number): MaxLines;
+export {};
+//# sourceMappingURL=branded-numbers.d.ts.map

package/dist/internal/branded-numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded-numbers.d.ts","sourceRoot":"","sources":["../../src/internal/branded-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,OAAO,CAAC,MAAM,yBAAyB,EAAE,OAAO,MAAM,CAAC;AACvD,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAC1C,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,IAAI,CAAC;CAC5C,CAAC;AAEF,OAAO,CAAC,MAAM,4BAA4B,EAAE,OAAO,MAAM,CAAC;AAC1D,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG;IAC7C,QAAQ,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,CAAC;CAC/C,CAAC;AAEF,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAE7E;AAED,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GACZ,uBAAuB,CAEzB;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD"}

package/dist/internal/strip-ansi-sequences.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stateful ANSI escape stripper for streaming text chunks.
+ *
+ * Buffers incomplete sequences that span Web Serial read boundaries so
+ * partial ESC bytes are not emitted as visible text.
+ *
+ * @internal
+ */
+export interface AnsiStripper {
+    feed(chunk: string): string;
+    flush(): string;
+}
+/**
+ * Strips ANSI escape sequences from a complete string in one pass.
+ *
+ * @internal
+ */
+export declare function stripAnsiSequences(text: string): string;
+/**
+ * Creates a streaming ANSI escape stripper.
+ *
+ * @internal
+ */
+export declare function createAnsiStripper(): AnsiStripper;
+//# sourceMappingURL=strip-ansi-sequences.d.ts.map

package/dist/internal/strip-ansi-sequences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-ansi-sequences.d.ts","sourceRoot":"","sources":["../../src/internal/strip-ansi-sequences.ts"],"names":[],"mappings":"AA6BA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,KAAK,IAAI,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CA2EjD"}

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

@@ -1,7 +1,7 @@
 import type { SerialSession } from './serial-session';
 import { type SerialSessionOptions } from './serial-session-options';
 /**
- * Create a v2 {@link SerialSession}.
+ * Create a {@link SerialSession}.
  *
  * This release wires the internal read pump (#202) and the internal send
  * queue (#203) into the session so that `connect$`, `disconnect$`,
@@ -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;AAOlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAyGf"}

package/dist/session/index.d.ts

@@ -1,6 +1,11 @@
 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, SerialSessionFeatureOptions, 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 { isConnectedSessionState } from './is-connected-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,2BAA2B,EAC3B,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,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,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,CAkEhC"}

package/dist/session/is-connected-session-state.d.ts

@@ -0,0 +1,11 @@
+import { type ConnectedSessionState, type SerialSessionState } from './serial-session-state';
+/**
+ * Type predicate for {@link ConnectedSessionState}.
+ *
+ * Use with RxJS `filter()` to preserve discriminated union narrowing in
+ * pipelines so `portInfo` and other connected-only fields stay typed.
+ *
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/436 | Issue #436}
+ */
+export declare function isConnectedSessionState(state: SerialSessionState): state is ConnectedSessionState;
+//# sourceMappingURL=is-connected-session-state.d.ts.map

package/dist/session/is-connected-session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-connected-session-state.d.ts","sourceRoot":"","sources":["../../src/session/is-connected-session-state.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EAExB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,GACxB,KAAK,IAAI,qBAAqB,CAEhC"}

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

@@ -45,7 +45,7 @@ export interface NormalizeSerialErrorOptions {
  *    control-flow event, not a hard failure.
  * 3. Any other value is wrapped as a {@link SerialError} with
  *    {@link NormalizeSerialErrorOptions.fallbackCode}, preserving the
- *    original error as `originalError` for debugging.
+ *    underlying failure on {@link SerialError.context | context.cause}.
  *
  * @internal
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}

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

@@ -1 +1 @@
-{"version":3,"file":"normalize-serial-error.d.ts","sourceRoot":"","sources":["../../src/session/normalize-serial-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAW9D;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,YAAY,EAAE,eAAe,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,GACnC,WAAW,CAqBb"}
+{"version":3,"file":"normalize-serial-error.d.ts","sourceRoot":"","sources":["../../src/session/normalize-serial-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAW9D;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,YAAY,EAAE,eAAe,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,GACnC,WAAW,CAuBb"}