@gurezo/web-serial-rxjs 2.2.0 → 2.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +1 -1
- package/dist/index.js +48 -46
- package/dist/index.mjs +48 -46
- package/dist/index.mjs.map +4 -4
- package/dist/session/create-serial-session.d.ts.map +1 -1
- package/dist/session/serial-session.d.ts +17 -2
- package/dist/session/serial-session.d.ts.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*
|
|
11
11
|
* The v2 public API intentionally exposes a single, session-oriented surface
|
|
12
12
|
* so that apps (Angular, Vue, React, Svelte, vanilla JS/TS) can drive their
|
|
13
|
-
* UI entirely from `state$` + `isConnected$` + `receive$` + `lines$` + `errors$` without rebuilding any
|
|
13
|
+
* UI entirely from `state$` + `isConnected$` + `receive$` + `terminalText$` + `lines$` + `errors$` without rebuilding any
|
|
14
14
|
* state, read loops, or write queues themselves.
|
|
15
15
|
*
|
|
16
16
|
* - {@link createSerialSession} - factory for a {@link SerialSession}
|
package/dist/index.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
import {
|
|
3
3
|
BehaviorSubject as BehaviorSubject2,
|
|
4
4
|
distinctUntilChanged,
|
|
5
|
-
map,
|
|
5
|
+
map as map2,
|
|
6
6
|
Observable as Observable3,
|
|
7
7
|
ReplaySubject,
|
|
8
8
|
share,
|
|
@@ -66,6 +66,50 @@ var SerialError = class _SerialError extends Error {
|
|
|
66
66
|
}
|
|
67
67
|
};
|
|
68
68
|
|
|
69
|
+
// packages/web-serial-rxjs/src/terminal/create-terminal-buffer.ts
|
|
70
|
+
import { map, scan, shareReplay } from "rxjs";
|
|
71
|
+
function applyTerminalChunk(state, chunk) {
|
|
72
|
+
let { completed, currentLine } = state;
|
|
73
|
+
const len = chunk.length;
|
|
74
|
+
for (let i = 0; i < len; i++) {
|
|
75
|
+
const c = chunk.charAt(i);
|
|
76
|
+
if (c === "\r") {
|
|
77
|
+
const next = i + 1 < len ? chunk.charAt(i + 1) : "";
|
|
78
|
+
if (next === "\n") {
|
|
79
|
+
completed += currentLine + "\n";
|
|
80
|
+
currentLine = "";
|
|
81
|
+
i++;
|
|
82
|
+
} else {
|
|
83
|
+
currentLine = "";
|
|
84
|
+
}
|
|
85
|
+
} else if (c === "\n") {
|
|
86
|
+
completed += currentLine + "\n";
|
|
87
|
+
currentLine = "";
|
|
88
|
+
} else {
|
|
89
|
+
currentLine += c;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return { completed, currentLine };
|
|
93
|
+
}
|
|
94
|
+
function terminalDisplayText(state) {
|
|
95
|
+
return state.completed + state.currentLine;
|
|
96
|
+
}
|
|
97
|
+
var initialTerminalState = {
|
|
98
|
+
completed: "",
|
|
99
|
+
currentLine: ""
|
|
100
|
+
};
|
|
101
|
+
function createTerminalBuffer(receive$) {
|
|
102
|
+
const text$ = receive$.pipe(
|
|
103
|
+
scan(
|
|
104
|
+
(state, chunk) => applyTerminalChunk(state, chunk),
|
|
105
|
+
initialTerminalState
|
|
106
|
+
),
|
|
107
|
+
map(terminalDisplayText),
|
|
108
|
+
shareReplay({ bufferSize: 1, refCount: true })
|
|
109
|
+
);
|
|
110
|
+
return { text$ };
|
|
111
|
+
}
|
|
112
|
+
|
|
69
113
|
// packages/web-serial-rxjs/src/session/internal/build-request-options.ts
|
|
70
114
|
function buildRequestOptions(options) {
|
|
71
115
|
if (!options || !options.filters || options.filters.length === 0) {
|
|
@@ -407,8 +451,9 @@ function createSerialSession(options) {
|
|
|
407
451
|
const errors$ = errorsSubject.asObservable();
|
|
408
452
|
const receive$ = receiveSubject.asObservable();
|
|
409
453
|
const lines$ = linesSubject.asObservable();
|
|
454
|
+
const terminalText$ = createTerminalBuffer(receive$).text$;
|
|
410
455
|
const isConnected$ = machine.state$.pipe(
|
|
411
|
-
|
|
456
|
+
map2((state) => state === SerialSessionState.Connected),
|
|
412
457
|
distinctUntilChanged()
|
|
413
458
|
);
|
|
414
459
|
const portInfoSubject = new BehaviorSubject2(null);
|
|
@@ -665,54 +710,11 @@ function createSerialSession(options) {
|
|
|
665
710
|
},
|
|
666
711
|
errors$,
|
|
667
712
|
receive$,
|
|
713
|
+
terminalText$,
|
|
668
714
|
receiveReplay$,
|
|
669
715
|
lines$
|
|
670
716
|
};
|
|
671
717
|
}
|
|
672
|
-
|
|
673
|
-
// packages/web-serial-rxjs/src/terminal/create-terminal-buffer.ts
|
|
674
|
-
import { map as map2, scan, shareReplay } from "rxjs";
|
|
675
|
-
function applyTerminalChunk(state, chunk) {
|
|
676
|
-
let { completed, currentLine } = state;
|
|
677
|
-
const len = chunk.length;
|
|
678
|
-
for (let i = 0; i < len; i++) {
|
|
679
|
-
const c = chunk.charAt(i);
|
|
680
|
-
if (c === "\r") {
|
|
681
|
-
const next = i + 1 < len ? chunk.charAt(i + 1) : "";
|
|
682
|
-
if (next === "\n") {
|
|
683
|
-
completed += currentLine + "\n";
|
|
684
|
-
currentLine = "";
|
|
685
|
-
i++;
|
|
686
|
-
} else {
|
|
687
|
-
currentLine = "";
|
|
688
|
-
}
|
|
689
|
-
} else if (c === "\n") {
|
|
690
|
-
completed += currentLine + "\n";
|
|
691
|
-
currentLine = "";
|
|
692
|
-
} else {
|
|
693
|
-
currentLine += c;
|
|
694
|
-
}
|
|
695
|
-
}
|
|
696
|
-
return { completed, currentLine };
|
|
697
|
-
}
|
|
698
|
-
function terminalDisplayText(state) {
|
|
699
|
-
return state.completed + state.currentLine;
|
|
700
|
-
}
|
|
701
|
-
var initialTerminalState = {
|
|
702
|
-
completed: "",
|
|
703
|
-
currentLine: ""
|
|
704
|
-
};
|
|
705
|
-
function createTerminalBuffer(receive$) {
|
|
706
|
-
const text$ = receive$.pipe(
|
|
707
|
-
scan(
|
|
708
|
-
(state, chunk) => applyTerminalChunk(state, chunk),
|
|
709
|
-
initialTerminalState
|
|
710
|
-
),
|
|
711
|
-
map2(terminalDisplayText),
|
|
712
|
-
shareReplay({ bufferSize: 1, refCount: true })
|
|
713
|
-
);
|
|
714
|
-
return { text$ };
|
|
715
|
-
}
|
|
716
718
|
export {
|
|
717
719
|
SerialError,
|
|
718
720
|
SerialErrorCode,
|
package/dist/index.mjs
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
import {
|
|
3
3
|
BehaviorSubject as BehaviorSubject2,
|
|
4
4
|
distinctUntilChanged,
|
|
5
|
-
map,
|
|
5
|
+
map as map2,
|
|
6
6
|
Observable as Observable3,
|
|
7
7
|
ReplaySubject,
|
|
8
8
|
share,
|
|
@@ -66,6 +66,50 @@ var SerialError = class _SerialError extends Error {
|
|
|
66
66
|
}
|
|
67
67
|
};
|
|
68
68
|
|
|
69
|
+
// src/terminal/create-terminal-buffer.ts
|
|
70
|
+
import { map, scan, shareReplay } from "rxjs";
|
|
71
|
+
function applyTerminalChunk(state, chunk) {
|
|
72
|
+
let { completed, currentLine } = state;
|
|
73
|
+
const len = chunk.length;
|
|
74
|
+
for (let i = 0; i < len; i++) {
|
|
75
|
+
const c = chunk.charAt(i);
|
|
76
|
+
if (c === "\r") {
|
|
77
|
+
const next = i + 1 < len ? chunk.charAt(i + 1) : "";
|
|
78
|
+
if (next === "\n") {
|
|
79
|
+
completed += currentLine + "\n";
|
|
80
|
+
currentLine = "";
|
|
81
|
+
i++;
|
|
82
|
+
} else {
|
|
83
|
+
currentLine = "";
|
|
84
|
+
}
|
|
85
|
+
} else if (c === "\n") {
|
|
86
|
+
completed += currentLine + "\n";
|
|
87
|
+
currentLine = "";
|
|
88
|
+
} else {
|
|
89
|
+
currentLine += c;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return { completed, currentLine };
|
|
93
|
+
}
|
|
94
|
+
function terminalDisplayText(state) {
|
|
95
|
+
return state.completed + state.currentLine;
|
|
96
|
+
}
|
|
97
|
+
var initialTerminalState = {
|
|
98
|
+
completed: "",
|
|
99
|
+
currentLine: ""
|
|
100
|
+
};
|
|
101
|
+
function createTerminalBuffer(receive$) {
|
|
102
|
+
const text$ = receive$.pipe(
|
|
103
|
+
scan(
|
|
104
|
+
(state, chunk) => applyTerminalChunk(state, chunk),
|
|
105
|
+
initialTerminalState
|
|
106
|
+
),
|
|
107
|
+
map(terminalDisplayText),
|
|
108
|
+
shareReplay({ bufferSize: 1, refCount: true })
|
|
109
|
+
);
|
|
110
|
+
return { text$ };
|
|
111
|
+
}
|
|
112
|
+
|
|
69
113
|
// src/session/internal/build-request-options.ts
|
|
70
114
|
function buildRequestOptions(options) {
|
|
71
115
|
if (!options || !options.filters || options.filters.length === 0) {
|
|
@@ -407,8 +451,9 @@ function createSerialSession(options) {
|
|
|
407
451
|
const errors$ = errorsSubject.asObservable();
|
|
408
452
|
const receive$ = receiveSubject.asObservable();
|
|
409
453
|
const lines$ = linesSubject.asObservable();
|
|
454
|
+
const terminalText$ = createTerminalBuffer(receive$).text$;
|
|
410
455
|
const isConnected$ = machine.state$.pipe(
|
|
411
|
-
|
|
456
|
+
map2((state) => state === SerialSessionState.Connected),
|
|
412
457
|
distinctUntilChanged()
|
|
413
458
|
);
|
|
414
459
|
const portInfoSubject = new BehaviorSubject2(null);
|
|
@@ -665,54 +710,11 @@ function createSerialSession(options) {
|
|
|
665
710
|
},
|
|
666
711
|
errors$,
|
|
667
712
|
receive$,
|
|
713
|
+
terminalText$,
|
|
668
714
|
receiveReplay$,
|
|
669
715
|
lines$
|
|
670
716
|
};
|
|
671
717
|
}
|
|
672
|
-
|
|
673
|
-
// src/terminal/create-terminal-buffer.ts
|
|
674
|
-
import { map as map2, scan, shareReplay } from "rxjs";
|
|
675
|
-
function applyTerminalChunk(state, chunk) {
|
|
676
|
-
let { completed, currentLine } = state;
|
|
677
|
-
const len = chunk.length;
|
|
678
|
-
for (let i = 0; i < len; i++) {
|
|
679
|
-
const c = chunk.charAt(i);
|
|
680
|
-
if (c === "\r") {
|
|
681
|
-
const next = i + 1 < len ? chunk.charAt(i + 1) : "";
|
|
682
|
-
if (next === "\n") {
|
|
683
|
-
completed += currentLine + "\n";
|
|
684
|
-
currentLine = "";
|
|
685
|
-
i++;
|
|
686
|
-
} else {
|
|
687
|
-
currentLine = "";
|
|
688
|
-
}
|
|
689
|
-
} else if (c === "\n") {
|
|
690
|
-
completed += currentLine + "\n";
|
|
691
|
-
currentLine = "";
|
|
692
|
-
} else {
|
|
693
|
-
currentLine += c;
|
|
694
|
-
}
|
|
695
|
-
}
|
|
696
|
-
return { completed, currentLine };
|
|
697
|
-
}
|
|
698
|
-
function terminalDisplayText(state) {
|
|
699
|
-
return state.completed + state.currentLine;
|
|
700
|
-
}
|
|
701
|
-
var initialTerminalState = {
|
|
702
|
-
completed: "",
|
|
703
|
-
currentLine: ""
|
|
704
|
-
};
|
|
705
|
-
function createTerminalBuffer(receive$) {
|
|
706
|
-
const text$ = receive$.pipe(
|
|
707
|
-
scan(
|
|
708
|
-
(state, chunk) => applyTerminalChunk(state, chunk),
|
|
709
|
-
initialTerminalState
|
|
710
|
-
),
|
|
711
|
-
map2(terminalDisplayText),
|
|
712
|
-
shareReplay({ bufferSize: 1, refCount: true })
|
|
713
|
-
);
|
|
714
|
-
return { text$ };
|
|
715
|
-
}
|
|
716
718
|
export {
|
|
717
719
|
SerialError,
|
|
718
720
|
SerialErrorCode,
|
package/dist/index.mjs.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../src/session/create-serial-session.ts", "../src/errors/serial-error-code.ts", "../src/errors/serial-error.ts", "../src/session/internal/build-request-options.ts", "../src/session/internal/has-web-serial-support.ts", "../src/session/internal/line-buffer.ts", "../src/session/normalize-serial-error.ts", "../src/session/read-pump.ts", "../src/session/send-queue.ts", "../src/session/serial-session-options.ts", "../src/session/serial-session-state.ts", "../src/session/session-state-machine.ts"
|
|
4
|
-
"sourcesContent": ["import {\n BehaviorSubject,\n distinctUntilChanged,\n map,\n Observable,\n ReplaySubject,\n share,\n Subject,\n switchMap,\n} from 'rxjs';\nimport { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { buildRequestOptions } from './internal/build-request-options';\nimport { hasWebSerialSupport } from './internal/has-web-serial-support';\nimport { createLineBuffer } from './internal/line-buffer';\nimport {\n normalizeSerialError,\n type NormalizeSerialErrorOptions,\n} from './normalize-serial-error';\nimport { createReadPump, type ReadPump } from './read-pump';\nimport { createSendQueue } from './send-queue';\nimport type { SerialSession } from './serial-session';\nimport {\n DEFAULT_SERIAL_SESSION_OPTIONS,\n type SerialSessionOptions,\n} from './serial-session-options';\nimport { SerialSessionState } from './serial-session-state';\nimport { SessionStateMachine } from './session-state-machine';\n\n/**\n * Internal error classification used by the single `reportError` entry\n * point. `'fatal'` errors drive `state$` into `'error'` and tear down\n * the live session (pump stop + port close); `'non-fatal'` errors are\n * only multiplexed on `errors$` without mutating session state - this\n * matches the Issue #199 design note that write failures must not\n * implicitly disconnect the session.\n *\n * @internal\n */\ntype ReportErrorSeverity = 'fatal' | 'non-fatal';\n\n/**\n * Create a v2 {@link SerialSession}.\n *\n * This release wires the internal read pump (#202) and the internal send\n * queue (#203) into the session so that `connect$`, `disconnect$`,\n * `receive$`, and `send$` all operate end-to-end. Error handling is\n * centralised through a single `reportError` helper (#204) so every\n * failure path normalises through {@link normalizeSerialError} and emits\n * on the one `errors$` channel.\n *\n * Key behaviors:\n *\n * - `isBrowserSupported()` returns whether `navigator.serial` is available.\n * - `state$` replays the current lifecycle state driven by\n * {@link SessionStateMachine}.\n * - `connect$()` opens a user-selected port, starts the internal read pump,\n * and transitions `idle -> connecting -> connected`.\n * - `disconnect$()` stops the read pump, closes the port, and transitions\n * `connected -> disconnecting -> idle`.\n * - `receive$` emits UTF-8 decoded text chunks pushed by the pump. It is\n * **not** subscription-lazy - the pump is started by `connect$` and\n * decoded text is multicast to all subscribers; late subscribers see only\n * new data.\n * - `lines$` emits the same decoded stream split into line-terminated\n * segments (`\\n`, `\\r\\n`); a trailing line without a terminator is\n * buffered. It is also not subscription-lazy relative to the pump.\n * - `send$` enqueues each payload on an internal FIFO queue so concurrent\n * subscribers are written to the port in call order. String payloads are\n * UTF-8 encoded through a shared `TextEncoder`.\n * - `errors$` multiplexes every {@link SerialError} produced by the\n * session. Connect / read / close failures are treated as fatal and\n * also drive `state$` to `'error'`; write failures are non-fatal and\n * do not mutate `state$` because a real connection loss will be\n * observed by the read pump on the next tick anyway.\n *\n * @param options - Session options. Only `filters` is consulted by\n * `connect$` today (forwarded to `navigator.serial.requestPort`); the\n * remaining fields are passed to `port.open` using defaults when omitted.\n * @returns A {@link SerialSession} instance.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}\n */\nexport function createSerialSession(\n options?: SerialSessionOptions,\n): SerialSession {\n const resolvedOptions = {\n ...DEFAULT_SERIAL_SESSION_OPTIONS,\n ...options,\n filters: options?.filters,\n receiveReplay: {\n ...DEFAULT_SERIAL_SESSION_OPTIONS.receiveReplay,\n ...options?.receiveReplay,\n },\n };\n\n const supported = hasWebSerialSupport();\n const machine = new SessionStateMachine(\n supported ? SerialSessionState.Idle : SerialSessionState.Unsupported,\n );\n const errorsSubject = new Subject<SerialError>();\n const receiveSubject = new Subject<string>();\n const linesSubject = new Subject<string>();\n const sendQueue = createSendQueue();\n const textEncoder = new TextEncoder();\n const lineBuffer = createLineBuffer();\n\n const errors$ = errorsSubject.asObservable();\n const receive$ = receiveSubject.asObservable();\n const lines$ = linesSubject.asObservable();\n\n const isConnected$ = machine.state$.pipe(\n map((state) => state === SerialSessionState.Connected),\n distinctUntilChanged(),\n );\n\n const portInfoSubject = new BehaviorSubject<SerialPortInfo | null>(null);\n const portInfo$ = portInfoSubject.asObservable();\n\n const receiveReplayStream$ = resolvedOptions.receiveReplay.enabled\n ? new BehaviorSubject<Observable<string>>(receive$)\n : null;\n let activeReceiveReplay: ReplaySubject<string> | null = null;\n\n const clearLiveReceiveReplay = (): void => {\n if (receiveReplayStream$) {\n if (activeReceiveReplay) {\n activeReceiveReplay.complete();\n activeReceiveReplay = null;\n }\n receiveReplayStream$.next(receive$);\n }\n };\n\n const startLiveReceiveReplay = (): void => {\n if (!receiveReplayStream$) {\n return;\n }\n if (activeReceiveReplay) {\n activeReceiveReplay.complete();\n activeReceiveReplay = null;\n }\n const rs = new ReplaySubject<string>(resolvedOptions.receiveReplay.bufferSize);\n activeReceiveReplay = rs;\n receiveReplayStream$.next(rs.asObservable());\n };\n\n const receiveReplay$ = receiveReplayStream$\n ? receiveReplayStream$.pipe(switchMap((inner) => inner), share())\n : receive$;\n\n let activePort: SerialPort | null = null;\n let activePump: ReadPump | null = null;\n\n const setActivePort = (port: SerialPort | null): void => {\n activePort = port;\n portInfoSubject.next(port ? port.getInfo() : null);\n };\n\n const teardownPump = async (): Promise<void> => {\n clearLiveReceiveReplay();\n const pump = activePump;\n activePump = null;\n lineBuffer.clear();\n if (pump) {\n await pump.stop();\n }\n };\n\n const closePortSafely = async (port: SerialPort | null): Promise<void> => {\n if (!port) {\n return;\n }\n try {\n await port.close();\n } catch {\n // The read pump may already have errored the stream, which makes\n // close() reject. We ignore it here because disconnect$ has a\n // dedicated error path for close failures initiated by the user.\n }\n };\n\n /**\n * Single entry point for every error that should reach `errors$`.\n *\n * Responsibilities:\n *\n * 1. Normalise the input through {@link normalizeSerialError} so every\n * emission is a well-formed {@link SerialError}.\n * 2. Multiplex the normalised error on `errors$`.\n * 3. For fatal severities, drive `state$` to `'error'`, clear the send\n * queue so pending writes fail fast, and tear down the live pump +\n * port off the hot path.\n *\n * Returning the normalised error keeps call sites terse: they can hand\n * the result straight to `subscriber.error(...)` without re-normalising.\n */\n const reportError = (\n error: unknown,\n severity: ReportErrorSeverity,\n options: NormalizeSerialErrorOptions,\n ): SerialError => {\n const serialError = normalizeSerialError(error, options);\n errorsSubject.next(serialError);\n if (severity === 'fatal') {\n machine.toError();\n sendQueue.clear();\n const portToClose = activePort;\n setActivePort(null);\n void teardownPump().then(() => closePortSafely(portToClose));\n }\n return serialError;\n };\n\n const writeToPort = async (payload: Uint8Array): Promise<void> => {\n const port = activePort;\n if (machine.current !== SerialSessionState.Connected || !port || !port.writable) {\n throw new SerialError(\n SerialErrorCode.PORT_NOT_OPEN,\n 'Cannot send data while session is not connected',\n );\n }\n const writer = port.writable.getWriter();\n try {\n await writer.write(payload);\n } finally {\n try {\n writer.releaseLock();\n } catch {\n // releaseLock throws when the stream is already errored; the real\n // failure is surfaced through the write() rejection above so we\n // intentionally swallow this secondary error.\n }\n }\n };\n\n return {\n isBrowserSupported(): boolean {\n return hasWebSerialSupport();\n },\n connect$(): Observable<void> {\n return new Observable<void>((subscriber) => {\n if (!hasWebSerialSupport()) {\n const error = reportError(\n new SerialError(\n SerialErrorCode.BROWSER_NOT_SUPPORTED,\n 'Web Serial API is not supported in this environment',\n ),\n 'non-fatal',\n { fallbackCode: SerialErrorCode.BROWSER_NOT_SUPPORTED },\n );\n subscriber.error(error);\n return;\n }\n\n const current = machine.current;\n if (\n current !== SerialSessionState.Idle &&\n current !== SerialSessionState.Error\n ) {\n const error = reportError(\n new SerialError(\n SerialErrorCode.PORT_ALREADY_OPEN,\n `Cannot connect while session state is '${current}'`,\n ),\n 'non-fatal',\n { fallbackCode: SerialErrorCode.PORT_ALREADY_OPEN },\n );\n subscriber.error(error);\n return;\n }\n\n let cancelled = false;\n machine.toConnecting();\n\n const run = async (): Promise<void> => {\n let selectedPort: SerialPort | null = null;\n try {\n selectedPort = await navigator.serial.requestPort(\n buildRequestOptions(resolvedOptions),\n );\n await selectedPort.open({\n baudRate: resolvedOptions.baudRate,\n dataBits: resolvedOptions.dataBits,\n stopBits: resolvedOptions.stopBits,\n parity: resolvedOptions.parity,\n bufferSize: resolvedOptions.bufferSize,\n flowControl: resolvedOptions.flowControl,\n });\n } catch (error) {\n if (selectedPort) {\n await closePortSafely(selectedPort);\n }\n const serialError = reportError(error, 'fatal', {\n fallbackCode: SerialErrorCode.PORT_OPEN_FAILED,\n messagePrefix: 'Failed to open port',\n });\n if (!cancelled) {\n subscriber.error(serialError);\n }\n return;\n }\n\n if (cancelled) {\n await closePortSafely(selectedPort);\n return;\n }\n\n setActivePort(selectedPort);\n lineBuffer.clear();\n if (resolvedOptions.receiveReplay.enabled) {\n startLiveReceiveReplay();\n }\n activePump = createReadPump(selectedPort, {\n onChunk: (text) => {\n receiveSubject.next(text);\n if (activeReceiveReplay) {\n activeReceiveReplay.next(text);\n }\n for (const line of lineBuffer.feed(text)) {\n linesSubject.next(line);\n }\n },\n onError: (pumpError) =>\n reportError(pumpError, 'fatal', {\n fallbackCode: SerialErrorCode.READ_FAILED,\n messagePrefix: 'Read pump failed',\n }),\n });\n activePump.start();\n sendQueue.clear();\n machine.toConnected();\n subscriber.next();\n subscriber.complete();\n };\n\n void run();\n\n return () => {\n cancelled = true;\n };\n });\n },\n disconnect$(): Observable<void> {\n return new Observable<void>((subscriber) => {\n const current = machine.current;\n\n if (\n current === SerialSessionState.Idle ||\n current === SerialSessionState.Unsupported\n ) {\n subscriber.next();\n subscriber.complete();\n return;\n }\n\n if (\n current !== SerialSessionState.Connected &&\n current !== SerialSessionState.Error\n ) {\n const error = reportError(\n new SerialError(\n SerialErrorCode.PORT_NOT_OPEN,\n `Cannot disconnect while session state is '${current}'`,\n ),\n 'non-fatal',\n { fallbackCode: SerialErrorCode.PORT_NOT_OPEN },\n );\n subscriber.error(error);\n return;\n }\n\n machine.toDisconnecting();\n sendQueue.clear();\n const portToClose = activePort;\n\n const run = async (): Promise<void> => {\n try {\n await teardownPump();\n if (portToClose) {\n try {\n await portToClose.close();\n } catch (error) {\n setActivePort(null);\n const serialError = reportError(error, 'fatal', {\n fallbackCode: SerialErrorCode.CONNECTION_LOST,\n messagePrefix: 'Failed to close port',\n });\n subscriber.error(serialError);\n return;\n }\n }\n setActivePort(null);\n machine.toIdle();\n subscriber.next();\n subscriber.complete();\n } catch (error) {\n const serialError = reportError(error, 'fatal', {\n fallbackCode: SerialErrorCode.UNKNOWN,\n messagePrefix: 'Unexpected disconnect failure',\n });\n subscriber.error(serialError);\n }\n };\n\n void run();\n });\n },\n send$(data: string | Uint8Array): Observable<void> {\n return sendQueue.enqueue(async () => {\n const payload =\n typeof data === 'string' ? textEncoder.encode(data) : data;\n try {\n await writeToPort(payload);\n } catch (error) {\n throw reportError(error, 'non-fatal', {\n fallbackCode: SerialErrorCode.WRITE_FAILED,\n messagePrefix: 'Failed to write data',\n });\n }\n });\n },\n state$: machine.state$,\n isConnected$,\n portInfo$,\n getPortInfo(): SerialPortInfo | null {\n return portInfoSubject.getValue();\n },\n getCurrentPort(): SerialPort | null {\n return activePort;\n },\n errors$,\n receive$,\n receiveReplay$,\n lines$,\n };\n}\n", "/**\n * Error codes for serial port operations.\n *\n * These codes identify specific error conditions that can occur when working with\n * serial ports. Each error code corresponds to a specific failure scenario, making\n * it easier to handle errors programmatically.\n *\n * @example\n * ```typescript\n * try {\n * await client.connect().toPromise();\n * } catch (error) {\n * if (error instanceof SerialError) {\n * switch (error.code) {\n * case SerialErrorCode.BROWSER_NOT_SUPPORTED:\n * console.error('Please use a Chromium-based browser');\n * break;\n * case SerialErrorCode.OPERATION_CANCELLED:\n * console.log('User cancelled port selection');\n * break;\n * // ... handle other error codes\n * }\n * }\n * }\n * ```\n */\nexport enum SerialErrorCode {\n /**\n * Browser does not support the Web Serial API.\n *\n * This error occurs when attempting to use serial port functionality in a browser\n * that doesn't support the Web Serial API. Only Chromium-based browsers (Chrome,\n * Edge, Opera) support this API.\n *\n * **Suggested action**: Inform the user to use a supported browser.\n */\n BROWSER_NOT_SUPPORTED = 'BROWSER_NOT_SUPPORTED',\n\n /**\n * Serial port is not available.\n *\n * This error occurs when a requested port cannot be accessed, such as when\n * getting previously granted ports fails or when the port is already in use\n * by another application.\n *\n * **Suggested action**: Check if the port is available or being used by another application.\n */\n PORT_NOT_AVAILABLE = 'PORT_NOT_AVAILABLE',\n\n /**\n * Failed to open the serial port.\n *\n * This error occurs when the port cannot be opened, typically due to incorrect\n * connection parameters, hardware issues, or permission problems.\n *\n * **Suggested action**: Verify connection parameters and check hardware connections.\n */\n PORT_OPEN_FAILED = 'PORT_OPEN_FAILED',\n\n /**\n * Serial port is already open.\n *\n * This error occurs when attempting to open a port that is already connected.\n * Only one connection can be active at a time per SerialClient instance.\n *\n * **Suggested action**: Disconnect the current port before connecting a new one.\n */\n PORT_ALREADY_OPEN = 'PORT_ALREADY_OPEN',\n\n /**\n * Serial port is not open.\n *\n * This error occurs when attempting to read from or write to a port that hasn't\n * been opened yet. The port must be connected before performing I/O operations.\n *\n * **Suggested action**: Call {@link SerialClient.connect} before reading or writing.\n */\n PORT_NOT_OPEN = 'PORT_NOT_OPEN',\n\n /**\n * Failed to read from the serial port.\n *\n * This error occurs when reading data from the port fails, typically due to\n * connection loss, hardware issues, or stream errors.\n *\n * **Suggested action**: Check the connection and hardware, then retry the read operation.\n */\n READ_FAILED = 'READ_FAILED',\n\n /**\n * Failed to write to the serial port.\n *\n * This error occurs when writing data to the port fails, typically due to\n * connection loss, hardware issues, or stream errors.\n *\n * **Suggested action**: Check the connection and hardware, then retry the write operation.\n */\n WRITE_FAILED = 'WRITE_FAILED',\n\n /**\n * Serial port connection was lost.\n *\n * This error occurs when the connection to the serial port is unexpectedly\n * terminated, such as when the device is disconnected or the port is closed\n * by another process.\n *\n * **Suggested action**: Check the physical connection and reconnect if needed.\n */\n CONNECTION_LOST = 'CONNECTION_LOST',\n\n /**\n * Invalid filter options provided.\n *\n * This error occurs when port filter options are invalid, such as when\n * filter values are out of range or missing required fields.\n *\n * **Suggested action**: Verify filter options match the expected format and value ranges.\n */\n INVALID_FILTER_OPTIONS = 'INVALID_FILTER_OPTIONS',\n\n /**\n * Operation was cancelled by the user.\n *\n * This error occurs when the user cancels a port selection dialog or aborts\n * an operation before it completes.\n *\n * **Suggested action**: This is a normal condition - no action required, but you may want\n * to inform the user that the operation was cancelled.\n */\n OPERATION_CANCELLED = 'OPERATION_CANCELLED',\n\n /**\n * Operation timed out before completion.\n *\n * This error occurs when an operation waits for a condition (for example, prompt\n * detection) and the timeout period elapses first.\n */\n OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',\n\n /**\n * Unknown error occurred.\n *\n * This error code is used for errors that don't fit into any other category.\n * The original error details may be available in the error's message or originalError property.\n *\n * **Suggested action**: Check the error message and originalError for more details.\n */\n UNKNOWN = 'UNKNOWN',\n}\n", "import { SerialErrorCode } from './serial-error-code';\n\n// Re-export SerialErrorCode for convenience\nexport { SerialErrorCode };\n\n/**\n * Custom error class for serial port operations.\n *\n * This error class extends the standard Error class and includes additional information\n * about the type of error that occurred. It provides an error code for programmatic\n * error handling and may include the original error that caused the failure.\n *\n * @example\n * ```typescript\n * try {\n * await client.connect().toPromise();\n * } catch (error) {\n * if (error instanceof SerialError) {\n * console.error(`Error code: ${error.code}`);\n * console.error(`Message: ${error.message}`);\n * if (error.originalError) {\n * console.error(`Original error:`, error.originalError);\n * }\n *\n * // Check specific error code\n * if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {\n * // Handle browser not supported\n * }\n * }\n * }\n * ```\n */\nexport class SerialError extends Error {\n /**\n * The error code identifying the type of error that occurred.\n *\n * Use this code to programmatically handle specific error conditions.\n *\n * @see {@link SerialErrorCode} for all available error codes\n */\n public readonly code: SerialErrorCode;\n\n /**\n * The original error that caused this SerialError, if available.\n *\n * This property contains the underlying error (e.g., DOMException, TypeError)\n * that was wrapped in this SerialError. It may be undefined if no original error exists.\n */\n public readonly originalError?: Error;\n\n /**\n * Creates a new SerialError instance.\n *\n * @param code - The error code identifying the type of error\n * @param message - A human-readable error message\n * @param originalError - The original error that caused this SerialError, if any\n */\n constructor(code: SerialErrorCode, message: string, originalError?: Error) {\n super(message);\n this.name = 'SerialError';\n this.code = code;\n this.originalError = originalError;\n\n // Maintains proper stack trace for where our error was thrown (only available on V8)\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n if ((Error as any).captureStackTrace) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (Error as any).captureStackTrace(this, SerialError);\n }\n }\n\n /**\n * Check if the error matches a specific error code.\n *\n * This is a convenience method for checking the error code without directly\n * comparing the code property.\n *\n * @param code - The error code to check against\n * @returns `true` if this error's code matches the provided code, `false` otherwise\n *\n * @example\n * ```typescript\n * if (error.is(SerialErrorCode.PORT_NOT_OPEN)) {\n * // Handle port not open error\n * }\n * ```\n */\n public is(code: SerialErrorCode): boolean {\n return this.code === code;\n }\n}\n", "import { SerialError } from '../../errors/serial-error';\nimport { SerialErrorCode } from '../../errors/serial-error-code';\nimport type { SerialSessionOptions } from '../serial-session-options';\n\n/**\n * Build {@link SerialPortRequestOptions} from {@link SerialSessionOptions}.\n *\n * Converts the `filters` field of {@link SerialSessionOptions} into the\n * shape expected by `navigator.serial.requestPort` and validates USB\n * vendor / product identifiers. Returns `undefined` when no filters are\n * supplied so the browser shows all available ports.\n *\n * @param options - The session options supplied by the caller.\n * @returns The request options, or `undefined` when no filters are set.\n * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_FILTER_OPTIONS}\n * when a filter is empty or contains out-of-range IDs.\n *\n * @internal\n */\nexport function buildRequestOptions(\n options?: SerialSessionOptions,\n): SerialPortRequestOptions | undefined {\n if (!options || !options.filters || options.filters.length === 0) {\n return undefined;\n }\n\n for (const filter of options.filters) {\n if (!filter.usbVendorId && !filter.usbProductId) {\n throw new SerialError(\n SerialErrorCode.INVALID_FILTER_OPTIONS,\n 'Filter must have at least usbVendorId or usbProductId',\n );\n }\n\n if (filter.usbVendorId !== undefined) {\n if (\n !Number.isInteger(filter.usbVendorId) ||\n filter.usbVendorId < 0 ||\n filter.usbVendorId > 0xffff\n ) {\n throw new SerialError(\n SerialErrorCode.INVALID_FILTER_OPTIONS,\n `Invalid usbVendorId: ${filter.usbVendorId}. Must be an integer between 0 and 65535.`,\n );\n }\n }\n\n if (filter.usbProductId !== undefined) {\n if (\n !Number.isInteger(filter.usbProductId) ||\n filter.usbProductId < 0 ||\n filter.usbProductId > 0xffff\n ) {\n throw new SerialError(\n SerialErrorCode.INVALID_FILTER_OPTIONS,\n `Invalid usbProductId: ${filter.usbProductId}. Must be an integer between 0 and 65535.`,\n );\n }\n }\n }\n\n return {\n filters: options.filters,\n };\n}\n", "/**\n * Internal feature detection for the Web Serial API.\n *\n * This helper is intentionally kept package-private: the v2 public API\n * exposes browser support only through {@link SerialSession.isBrowserSupported}.\n *\n * @returns `true` when `navigator.serial` is available.\n *\n * @internal\n */\nexport function hasWebSerialSupport(): boolean {\n return (\n typeof navigator !== 'undefined' &&\n 'serial' in navigator &&\n navigator.serial !== undefined &&\n navigator.serial !== null\n );\n}\n", "/**\n * Streaming UTF-16 text to newline-delimited lines for {@link createSerialSession}.\n * Supports `\\r\\n` and `\\n` per #237; a lone `\\r` that is not the last character\n * in the buffer is treated as a line end (compatibility with some devices). A\n * trailing `\\r` is retained until a following chunk disambiguates `\\r` vs\n * `\\r\\n`.\n *\n * @internal\n */\nexport function createLineBuffer(): {\n feed(chunk: string): string[];\n clear(): void;\n} {\n let buffer = '';\n\n const clear = (): void => {\n buffer = '';\n };\n\n const feed = (chunk: string): string[] => {\n buffer += chunk;\n const out: string[] = [];\n\n for (;;) {\n const crlf = buffer.indexOf('\\r\\n');\n if (crlf >= 0) {\n out.push(buffer.slice(0, crlf));\n buffer = buffer.slice(crlf + 2);\n continue;\n }\n\n // Lone \\r (not the last character) is a line end so we must not let\n // a later \\n in the same buffer be matched first (e.g. \"a\\rb\\n\").\n const cr = buffer.indexOf('\\r');\n if (cr >= 0 && cr + 1 < buffer.length && buffer[cr + 1] !== '\\n') {\n out.push(buffer.slice(0, cr));\n buffer = buffer.slice(cr + 1);\n continue;\n }\n\n const nl = buffer.indexOf('\\n');\n if (nl >= 0) {\n out.push(buffer.slice(0, nl));\n buffer = buffer.slice(nl + 1);\n continue;\n }\n\n if (cr >= 0 && cr + 1 === buffer.length) {\n break;\n }\n\n break;\n }\n\n return out;\n };\n\n return { feed, clear };\n}\n", "import { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\n\n/**\n * Default human-readable prefix attached to normalized errors when the\n * caller does not supply one. Kept short so downstream messages remain\n * readable (e.g. `\"Serial operation failed: <cause>\"`).\n *\n * @internal\n */\nconst DEFAULT_MESSAGE_PREFIX = 'Serial operation failed';\n\n/**\n * Options accepted by {@link normalizeSerialError}.\n *\n * @internal\n */\nexport interface NormalizeSerialErrorOptions {\n /**\n * Error code assigned when the input cannot be classified more\n * specifically (for example a generic `Error` thrown from `port.open`).\n *\n * Most call sites in the session pipeline know which lifecycle phase\n * they are in (connect / read / write / close) and therefore pick a\n * phase-specific fallback such as {@link SerialErrorCode.PORT_OPEN_FAILED}\n * or {@link SerialErrorCode.WRITE_FAILED}.\n */\n fallbackCode: SerialErrorCode;\n /**\n * Prefix used when the input has to be wrapped. Ignored when the input\n * is already a {@link SerialError} so we never rewrite a well-formed\n * message the caller has already chosen.\n */\n messagePrefix?: string;\n}\n\nconst isDomExceptionWithName = (\n error: unknown,\n name: string,\n): error is DOMException =>\n typeof DOMException !== 'undefined' &&\n error instanceof DOMException &&\n error.name === name;\n\n/**\n * Normalize an arbitrary thrown value into a {@link SerialError}.\n *\n * This helper is the single entry point used by every v2 session\n * component (session factory, read pump, send queue) to coerce raw\n * platform errors into the library's error type. Centralising the\n * mapping here satisfies Issue #204's completion criterion that\n * \"error handling lives in one place\" and removes the duplicated\n * `toError` / `normalizeError` helpers previously scattered across\n * session modules.\n *\n * Mapping rules applied, in order:\n *\n * 1. `SerialError` instances pass through unchanged so a caller that has\n * already classified the failure (e.g. `PORT_NOT_OPEN` on a pre-open\n * `send$`) is not rewrapped.\n * 2. `DOMException('NotFoundError')` is mapped to\n * {@link SerialErrorCode.OPERATION_CANCELLED}. Chromium raises this\n * when the user dismisses the `requestPort` dialog; it is a normal\n * control-flow event, not a hard failure.\n * 3. Any other value is wrapped as a {@link SerialError} with\n * {@link NormalizeSerialErrorOptions.fallbackCode}, preserving the\n * original error as `originalError` for debugging.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/204 | Issue #204}\n */\nexport function normalizeSerialError(\n error: unknown,\n options: NormalizeSerialErrorOptions,\n): SerialError {\n if (error instanceof SerialError) {\n return error;\n }\n\n const prefix = options.messagePrefix ?? DEFAULT_MESSAGE_PREFIX;\n\n if (isDomExceptionWithName(error, 'NotFoundError')) {\n return new SerialError(\n SerialErrorCode.OPERATION_CANCELLED,\n 'Port selection was cancelled by the user',\n error,\n );\n }\n\n const cause = error instanceof Error ? error : new Error(String(error));\n return new SerialError(\n options.fallbackCode,\n `${prefix}: ${cause.message}`,\n cause,\n );\n}\n", "import { SerialError } from '../errors/serial-error';\nimport { SerialErrorCode } from '../errors/serial-error-code';\nimport { normalizeSerialError } from './normalize-serial-error';\n\n/**\n * Callback invoked for every decoded chunk the read pump produces.\n *\n * The text is decoded from the raw bytes using a shared `TextDecoder` with\n * `{ stream: true }`, so multi-byte characters that straddle chunk\n * boundaries are joined correctly before reaching the callback.\n *\n * @internal\n */\nexport type ReadPumpChunkHandler = (text: string) => void;\n\n/**\n * Callback invoked when the read pump cannot continue.\n *\n * The provided error is always a {@link SerialError}; raw platform errors\n * are normalized by the pump before they reach the caller so consumers only\n * ever observe the library's error type.\n *\n * @internal\n */\nexport type ReadPumpErrorHandler = (error: SerialError) => void;\n\n/**\n * Options accepted by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPumpOptions {\n onChunk: ReadPumpChunkHandler;\n onError: ReadPumpErrorHandler;\n}\n\n/**\n * Handle returned by {@link createReadPump}.\n *\n * @internal\n */\nexport interface ReadPump {\n /**\n * Start reading from the associated `SerialPort.readable` stream.\n *\n * Subsequent calls are ignored while the pump is already running.\n */\n start(): void;\n /**\n * Stop the read loop and release the underlying reader lock.\n *\n * Safe to call multiple times or before `start()`.\n */\n stop(): Promise<void>;\n /**\n * `true` while the internal loop is actively reading.\n */\n readonly isRunning: boolean;\n}\n\n/**\n * Create an internal read pump for a {@link SerialPort}.\n *\n * The pump is an implementation detail of the v2 `SerialSession` API: it\n * owns a single `TextDecoder` (with `stream: true`), drives a\n * `reader.read()` loop against `port.readable`, and forwards decoded text\n * to the provided sink. It is **not** subscription-lazy - the `SerialSession`\n * starts the pump as soon as `connect$` succeeds so that `receive$`\n * subscribers never miss data because of subscription timing.\n *\n * Errors are normalized into {@link SerialError} with\n * {@link SerialErrorCode.READ_FAILED} for read-side failures and\n * {@link SerialErrorCode.CONNECTION_LOST} for missing readable streams, so\n * the session can forward them to `errors$` without rewrapping.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/202 | Issue #202}\n */\nexport function createReadPump(\n port: SerialPort,\n { onChunk, onError }: ReadPumpOptions,\n): ReadPump {\n let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n let running = false;\n let stopped = false;\n const decoder = new TextDecoder(undefined, { fatal: false });\n\n const releaseReader = (): void => {\n if (!reader) {\n return;\n }\n try {\n reader.releaseLock();\n } catch {\n // releaseLock may throw when the reader is already detached; ignore.\n }\n reader = null;\n };\n\n const pump = async (stream: ReadableStream<Uint8Array>): Promise<void> => {\n reader = stream.getReader();\n running = true;\n try {\n while (!stopped) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n if (value && value.byteLength > 0) {\n const text = decoder.decode(value, { stream: true });\n if (text.length > 0) {\n onChunk(text);\n }\n }\n }\n if (!stopped) {\n const tail = decoder.decode();\n if (tail.length > 0) {\n onChunk(tail);\n }\n }\n } catch (error) {\n if (!stopped) {\n onError(\n normalizeSerialError(error, {\n fallbackCode: SerialErrorCode.READ_FAILED,\n messagePrefix: 'Read pump failed',\n }),\n );\n }\n } finally {\n running = false;\n releaseReader();\n }\n };\n\n return {\n start(): void {\n if (running || stopped) {\n return;\n }\n const stream = port.readable;\n if (!stream) {\n stopped = true;\n onError(\n new SerialError(\n SerialErrorCode.CONNECTION_LOST,\n 'Read pump failed: port.readable is not available',\n ),\n );\n return;\n }\n void pump(stream);\n },\n async stop(): Promise<void> {\n if (stopped) {\n return;\n }\n stopped = true;\n if (!reader) {\n return;\n }\n try {\n await reader.cancel();\n } catch {\n // Cancel can reject when the stream is already errored; ignore so\n // the caller's disconnect flow is not derailed by a read failure.\n } finally {\n releaseReader();\n }\n },\n get isRunning(): boolean {\n return running;\n },\n };\n}\n", "import { Observable, defer } from 'rxjs';\n\n/**\n * A single enqueued unit of work. Operations are awaited sequentially so\n * that `send$` guarantees call order even when the caller fires multiple\n * observables concurrently.\n *\n * @internal\n */\nexport type SendQueueOperation<T> = () => Promise<T>;\n\n/**\n * Internal helper returned by {@link createSendQueue}.\n *\n * The queue is intentionally not an RxJS operator because Issue #199 calls\n * out explicitly that `send$` must not be re-implemented with `mergeMap`\n * (or any other concurrency-altering operator). A chained `Promise<void>`\n * is the simplest way to guarantee strict FIFO ordering while still\n * surfacing per-operation completion back to the caller.\n *\n * @internal\n */\nexport interface SendQueue {\n /**\n * Schedule an operation to run after all previously enqueued operations\n * have settled (resolved or rejected). The returned Observable completes\n * with the operation's resolved value, or errors with its rejection.\n *\n * Subscribing is what actually schedules the work - the queue is driven\n * by `defer`, so late/never-subscribed Observables never enqueue.\n */\n enqueue<T>(operation: SendQueueOperation<T>): Observable<T>;\n /**\n * Reset the internal promise chain. Existing in-flight operations keep\n * running because we do not cancel native promises, but no newly\n * enqueued work will wait for them. Use this when the session is torn\n * down so a fresh `connect$` starts with a clean chain.\n */\n clear(): void;\n}\n\n/**\n * Create an internal send queue that serialises `send$` writes.\n *\n * Ordering model:\n *\n * - Each `enqueue` call appends its operation to a single `Promise<void>`\n * chain.\n * - A failure in one operation does not poison the chain - the next\n * operation still runs (the chain is advanced with a `.then(() => {},\n * () => {})` safety tail).\n * - Unsubscribing before the operation resolves suppresses `next` /\n * `complete` / `error` for that subscriber; the underlying promise is\n * still awaited so later operations continue to respect call order.\n *\n * @internal\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}\n */\nexport function createSendQueue(): SendQueue {\n let chain: Promise<void> = Promise.resolve();\n\n return {\n enqueue<T>(operation: SendQueueOperation<T>): Observable<T> {\n return defer(\n () =>\n new Observable<T>((subscriber) => {\n let cancelled = false;\n\n const run = async (): Promise<void> => {\n try {\n const value = await operation();\n if (!cancelled) {\n subscriber.next(value);\n subscriber.complete();\n }\n } catch (error) {\n if (!cancelled) {\n subscriber.error(error);\n }\n }\n };\n\n const scheduled = chain.then(run, run);\n chain = scheduled.then(\n () => undefined,\n () => undefined,\n );\n\n return () => {\n cancelled = true;\n };\n }),\n );\n },\n clear(): void {\n chain = Promise.resolve();\n },\n };\n}\n", "/**\n * Options for creating a {@link SerialSession} via {@link createSerialSession}.\n *\n * These options configure the serial port connection parameters used when\n * calling `port.open` and `navigator.serial.requestPort`. All properties\n * are optional; omitted fields fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}.\n *\n * @example\n * ```typescript\n * const session = createSerialSession({\n * baudRate: 115200,\n * dataBits: 8,\n * stopBits: 1,\n * parity: 'none',\n * flowControl: 'none',\n * filters: [{ usbVendorId: 0x1234, usbProductId: 0x5678 }],\n * });\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}\n */\nexport interface SerialSessionOptions {\n /**\n * Baud rate for the serial port connection (bits per second).\n *\n * Common values include 9600, 19200, 38400, 57600, 115200, etc.\n * Must match the baud rate configured on the connected device.\n *\n * @default 9600\n */\n baudRate?: number;\n\n /**\n * Number of data bits per character (7 or 8).\n *\n * @default 8\n */\n dataBits?: 7 | 8;\n\n /**\n * Number of stop bits (1 or 2).\n *\n * @default 1\n */\n stopBits?: 1 | 2;\n\n /**\n * Parity checking mode.\n *\n * @default 'none'\n */\n parity?: 'none' | 'even' | 'odd';\n\n /**\n * Buffer size for the underlying read stream, in bytes.\n *\n * @default 255\n */\n bufferSize?: number;\n\n /**\n * Flow control mode.\n *\n * @default 'none'\n */\n flowControl?: 'none' | 'hardware';\n\n /**\n * Filters for port selection when requesting a port.\n *\n * When specified, the port selection dialog will only show devices\n * matching these filters. Each filter can specify `usbVendorId` and/or\n * `usbProductId`.\n */\n filters?: SerialPortFilter[];\n\n /**\n * Optional receive replay: retain recent decoded text **chunks** so late\n * subscribers to {@link SerialSession.receiveReplay$} can read buffered\n * data while a connection is active. Does not change {@link SerialSession.receive$}.\n *\n * @default `{ enabled: false, bufferSize: 512 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})\n */\n receiveReplay?: SerialSessionReceiveReplayOptions;\n}\n\n/**\n * Options for {@link SerialSessionOptions.receiveReplay}.\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/265 | Issue #265}\n */\nexport interface SerialSessionReceiveReplayOptions {\n /**\n * When `true`, the session uses a replay buffer for {@link SerialSession.receiveReplay$}\n * for each open connection. When `false` (default), `receiveReplay$` is\n * the same hot stream as {@link SerialSession.receive$} (no chunk replay).\n */\n enabled?: boolean;\n\n /**\n * Retains the last **N** decoded text chunks (one emission per `onChunk`\n * from the read pump) in the replay buffer. Not the character count. Higher\n * `bufferSize` uses more memory.\n *\n * @default 512\n */\n bufferSize?: number;\n}\n\nconst DEFAULT_RECEIVE_REPLAY: Required<SerialSessionReceiveReplayOptions> = {\n enabled: false,\n bufferSize: 512,\n};\n\n/**\n * Default values applied to omitted {@link SerialSessionOptions} fields.\n *\n * @internal\n */\nexport const DEFAULT_SERIAL_SESSION_OPTIONS: Required<\n Omit<SerialSessionOptions, 'filters' | 'receiveReplay'>\n> & { filters?: SerialPortFilter[]; receiveReplay: Required<SerialSessionReceiveReplayOptions> } = {\n baudRate: 9600,\n dataBits: 8,\n stopBits: 1,\n parity: 'none',\n bufferSize: 255,\n flowControl: 'none',\n filters: undefined,\n receiveReplay: { ...DEFAULT_RECEIVE_REPLAY },\n};\n", "/**\n * Reactive lifecycle state for a {@link SerialSession}.\n *\n * This is the v2 API counterpart of the legacy `SerialState` used by\n * `SerialClient`. The runtime values are the same flat strings v1\n * consumers used for UI switches; the {@link SerialSessionState} const\n * object is the canonical source of those literals so call sites can\n * avoid string typos and get IDE completion.\n *\n * Lifecycle transitions:\n *\n * ```\n * idle -> connecting -> connected -> disconnecting -> idle\n * \\-> error\n * (any) -> unsupported (when Web Serial API is unavailable)\n * (any) -> error (when an unrecoverable failure occurs)\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}\n */\nexport const SerialSessionState = {\n Idle: 'idle',\n Connecting: 'connecting',\n Connected: 'connected',\n Disconnecting: 'disconnecting',\n Unsupported: 'unsupported',\n Error: 'error',\n} as const;\n\n/**\n * String union of allowed {@link SerialSessionState} runtime values\n * (same set as the values on the {@link SerialSessionState} object).\n */\nexport type SerialSessionState =\n (typeof SerialSessionState)[keyof typeof SerialSessionState];\n", "import { BehaviorSubject, Observable } from 'rxjs';\nimport { SerialSessionState } from './serial-session-state';\n\n/**\n * Allowed transitions for the internal SerialSession state machine.\n *\n * Keys are the source state, values are the set of states that the source\n * is allowed to transition into. Transitions missing from this map are\n * treated as invalid and silently rejected (with a `console.warn`) so that\n * a logic bug in one sub-issue cannot corrupt `state$` for downstream\n * consumers.\n *\n * Lifecycle model (matches {@link SerialSessionState}):\n *\n * ```\n * idle -> connecting -> connected -> disconnecting -> idle\n * \\-> error\n * error -> idle (reset / retry)\n * unsupported (terminal; entered only at construction time)\n * ```\n *\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}\n * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/201 | Issue #201}\n */\nconst S = SerialSessionState;\n\nconst ALLOWED_TRANSITIONS: Readonly<\n Record<SerialSessionState, readonly SerialSessionState[]>\n> = {\n [S.Idle]: [S.Connecting, S.Error],\n [S.Connecting]: [S.Connected, S.Error, S.Idle],\n [S.Connected]: [S.Disconnecting, S.Error],\n [S.Disconnecting]: [S.Idle, S.Error],\n [S.Error]: [S.Idle, S.Connecting],\n [S.Unsupported]: [],\n};\n\n/**\n * Internal state machine that backs {@link SerialSession.state$}.\n *\n * The machine is deliberately kept as an internal module (not exported\n * from the package) because the public surface is only the Observable.\n * Sub-issues of #199 (read pump / send queue / errors) drive transitions\n * through the dedicated `to*` methods below instead of mutating a shared\n * `BehaviorSubject` directly.\n *\n * Design notes:\n *\n * - Invalid transitions are silently rejected so that the `state$` stream\n * never emits a state that violates the lifecycle contract. A\n * `console.warn` is emitted in development builds to aid debugging.\n * - `unsupported` is terminal: once entered (during construction when\n * `navigator.serial` is missing), the machine refuses every further\n * transition.\n * - `state$` is derived from a {@link BehaviorSubject} so late subscribers\n * still receive the current state on subscription.\n *\n * @internal\n */\nexport class SessionStateMachine {\n private readonly subject: BehaviorSubject<SerialSessionState>;\n\n constructor(initial: SerialSessionState = SerialSessionState.Idle) {\n this.subject = new BehaviorSubject<SerialSessionState>(initial);\n }\n\n get current(): SerialSessionState {\n return this.subject.getValue();\n }\n\n get state$(): Observable<SerialSessionState> {\n return this.subject.asObservable();\n }\n\n toConnecting(): boolean {\n return this.transition(S.Connecting);\n }\n\n toConnected(): boolean {\n return this.transition(S.Connected);\n }\n\n toDisconnecting(): boolean {\n return this.transition(S.Disconnecting);\n }\n\n toIdle(): boolean {\n return this.transition(S.Idle);\n }\n\n toError(): boolean {\n return this.transition(S.Error);\n }\n\n toUnsupported(): boolean {\n return this.transition(S.Unsupported);\n }\n\n complete(): void {\n this.subject.complete();\n }\n\n private transition(next: SerialSessionState): boolean {\n const current = this.subject.getValue();\n\n if (current === next) {\n return false;\n }\n\n const allowed = ALLOWED_TRANSITIONS[current];\n if (!allowed.includes(next)) {\n if (typeof console !== 'undefined' && console.warn) {\n console.warn(\n `[web-serial-rxjs] Ignoring invalid SerialSession transition ${current} -> ${next}`,\n );\n }\n return false;\n }\n\n this.subject.next(next);\n return true;\n }\n}\n", "import { type Observable, map, scan, shareReplay } from 'rxjs';\n\n/** @internal Folded state between {@link createTerminalBuffer} emissions. */\nexport interface TerminalBufferState {\n completed: string;\n currentLine: string;\n}\n\n/**\n * Applies one raw decoder chunk to terminal display state.\n * Handles `\\r\\n` and lone `\\n` as line endings, and lone `\\r` as\n * carriage return (clear current line for redraw). Does not interpret ANSI escapes.\n *\n * @internal Exported for unit tests.\n */\nexport function applyTerminalChunk(\n state: TerminalBufferState,\n chunk: string,\n): TerminalBufferState {\n let { completed, currentLine } = state;\n const len = chunk.length;\n\n for (let i = 0; i < len; i++) {\n const c = chunk.charAt(i);\n if (c === '\\r') {\n const next = i + 1 < len ? chunk.charAt(i + 1) : '';\n if (next === '\\n') {\n completed += currentLine + '\\n';\n currentLine = '';\n i++;\n } else {\n currentLine = '';\n }\n } else if (c === '\\n') {\n completed += currentLine + '\\n';\n currentLine = '';\n } else {\n currentLine += c;\n }\n }\n\n return { completed, currentLine };\n}\n\n/** @internal */\nexport function terminalDisplayText(state: TerminalBufferState): string {\n return state.completed + state.currentLine;\n}\n\nexport interface TerminalBuffer {\n /**\n * Cumulative text suitable for terminal-style display: completed lines plus\n * the current line, with `\\r` redraws collapsed per Issue #275.\n */\n readonly text$: Observable<string>;\n}\n\nconst initialTerminalState: TerminalBufferState = {\n completed: '',\n currentLine: '',\n};\n\n/**\n * Builds a terminal-oriented text stream from {@link SerialSession.receive$} (or any\n * `Observable<string>` of decoded chunks). Uses internal buffering so callers need not\n * implement carriage-return collapse themselves.\n */\nexport function createTerminalBuffer(\n receive$: Observable<string>,\n): TerminalBuffer {\n const text$ = receive$.pipe(\n scan(\n (state, chunk: string) => applyTerminalChunk(state, chunk),\n initialTerminalState,\n ),\n map(terminalDisplayText),\n shareReplay({ bufferSize: 1, refCount: true }),\n );\n\n return { text$ };\n}\n"],
|
|
5
|
-
"mappings": "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",
|
|
6
|
-
"names": ["BehaviorSubject", "Observable", "SerialErrorCode", "
|
|
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"],
|
|
4
|
+
"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 Chromium-based browser');\n * break;\n * case SerialErrorCode.OPERATION_CANCELLED:\n * console.log('User cancelled port selection');\n * break;\n * // ... handle other error codes\n * }\n * }\n * }\n * ```\n */\nexport enum SerialErrorCode {\n /**\n * Browser does not support the Web Serial API.\n *\n * This error occurs when attempting to use serial port functionality in a browser\n * that doesn't support the Web Serial API. Only Chromium-based browsers (Chrome,\n * Edge, Opera) support this API.\n *\n * **Suggested action**: Inform the user to use a supported browser.\n */\n BROWSER_NOT_SUPPORTED = 'BROWSER_NOT_SUPPORTED',\n\n /**\n * Serial port is not available.\n *\n * This error occurs when a requested port cannot be accessed, such as when\n * getting previously granted ports fails or when the port is already in use\n * by another application.\n *\n * **Suggested action**: Check if the port is available or being used by another application.\n */\n PORT_NOT_AVAILABLE = 'PORT_NOT_AVAILABLE',\n\n /**\n * Failed to open the serial port.\n *\n * This error occurs when the port cannot be opened, typically due to incorrect\n * connection parameters, hardware issues, or permission problems.\n *\n * **Suggested action**: Verify connection parameters and check hardware connections.\n */\n PORT_OPEN_FAILED = 'PORT_OPEN_FAILED',\n\n /**\n * Serial port is already open.\n *\n * This error occurs when attempting to open a port that is already connected.\n * Only one connection can be active at a time per SerialClient instance.\n *\n * **Suggested action**: Disconnect the current port before connecting a new one.\n */\n PORT_ALREADY_OPEN = 'PORT_ALREADY_OPEN',\n\n /**\n * Serial port is not open.\n *\n * This error occurs when attempting to read from or write to a port that hasn't\n * been opened yet. The port must be connected before performing I/O operations.\n *\n * **Suggested action**: Call {@link SerialClient.connect} before reading or writing.\n */\n PORT_NOT_OPEN = 'PORT_NOT_OPEN',\n\n /**\n * Failed to read from the serial port.\n *\n * This error occurs when reading data from the port fails, typically due to\n * connection loss, hardware issues, or stream errors.\n *\n * **Suggested action**: Check the connection and hardware, then retry the read operation.\n */\n READ_FAILED = 'READ_FAILED',\n\n /**\n * Failed to write to the serial port.\n *\n * This error occurs when writing data to the port fails, typically due to\n * connection loss, hardware issues, or stream errors.\n *\n * **Suggested action**: Check the connection and hardware, then retry the write operation.\n */\n WRITE_FAILED = 'WRITE_FAILED',\n\n /**\n * Serial port connection was lost.\n *\n * This error occurs when the connection to the serial port is unexpectedly\n * terminated, such as when the device is disconnected or the port is closed\n * by another process.\n *\n * **Suggested action**: Check the physical connection and reconnect if needed.\n */\n CONNECTION_LOST = 'CONNECTION_LOST',\n\n /**\n * Invalid filter options provided.\n *\n * This error occurs when port filter options are invalid, such as when\n * filter values are out of range or missing required fields.\n *\n * **Suggested action**: Verify filter options match the expected format and value ranges.\n */\n INVALID_FILTER_OPTIONS = 'INVALID_FILTER_OPTIONS',\n\n /**\n * Operation was cancelled by the user.\n *\n * This error occurs when the user cancels a port selection dialog or aborts\n * an operation before it completes.\n *\n * **Suggested action**: This is a normal condition - no action required, but you may want\n * to inform the user that the operation was cancelled.\n */\n OPERATION_CANCELLED = 'OPERATION_CANCELLED',\n\n /**\n * Operation timed out before completion.\n *\n * This error occurs when an operation waits for a condition (for example, prompt\n * detection) and the timeout period elapses first.\n */\n OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',\n\n /**\n * Unknown error occurred.\n *\n * This error code is used for errors that don't fit into any other category.\n * The original error details may be available in the error's message or originalError property.\n *\n * **Suggested action**: Check the error message and originalError for more details.\n */\n UNKNOWN = 'UNKNOWN',\n}\n", "import { SerialErrorCode } from './serial-error-code';\n\n// Re-export SerialErrorCode for convenience\nexport { SerialErrorCode };\n\n/**\n * Custom error class for serial port operations.\n *\n * This error class extends the standard Error class and includes additional information\n * about the type of error that occurred. It provides an error code for programmatic\n * error handling and may include the original error that caused the failure.\n *\n * @example\n * ```typescript\n * try {\n * await client.connect().toPromise();\n * } catch (error) {\n * if (error instanceof SerialError) {\n * console.error(`Error code: ${error.code}`);\n * console.error(`Message: ${error.message}`);\n * if (error.originalError) {\n * console.error(`Original error:`, error.originalError);\n * }\n *\n * // Check specific error code\n * if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {\n * // Handle browser not supported\n * }\n * }\n * }\n * ```\n */\nexport class SerialError extends Error {\n /**\n * The error code identifying the type of error that occurred.\n *\n * Use this code to programmatically handle specific error conditions.\n *\n * @see {@link SerialErrorCode} for all available error codes\n */\n public readonly code: SerialErrorCode;\n\n /**\n * The original error that caused this SerialError, if available.\n *\n * This property contains the underlying error (e.g., DOMException, TypeError)\n * that was wrapped in this SerialError. It may be undefined if no original error exists.\n */\n public readonly originalError?: Error;\n\n /**\n * Creates a new SerialError instance.\n *\n * @param code - The error code identifying the type of error\n * @param message - A human-readable error message\n * @param originalError - The original error that caused this SerialError, if any\n */\n constructor(code: SerialErrorCode, message: string, originalError?: Error) {\n super(message);\n this.name = 'SerialError';\n this.code = code;\n this.originalError = originalError;\n\n // Maintains proper stack trace for where our error was thrown (only available on V8)\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n if ((Error as any).captureStackTrace) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (Error as any).captureStackTrace(this, SerialError);\n }\n }\n\n /**\n * Check if the error matches a specific error code.\n *\n * This is a convenience method for checking the error code without directly\n * comparing the code property.\n *\n * @param code - The error code to check against\n * @returns `true` if this error's code matches the provided code, `false` otherwise\n *\n * @example\n * ```typescript\n * if (error.is(SerialErrorCode.PORT_NOT_OPEN)) {\n * // Handle port not open error\n * }\n * ```\n */\n public is(code: SerialErrorCode): boolean {\n return this.code === code;\n }\n}\n", "import { 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"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["BehaviorSubject", "map", "Observable", "SerialErrorCode", "map", "BehaviorSubject", "options", "Observable"]
|
|
7
7
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-serial-session.d.ts","sourceRoot":"","sources":["../../src/session/create-serial-session.ts"],"names":[],"mappings":"
|
|
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"}
|
|
@@ -6,7 +6,7 @@ import type { SerialSessionState } from './serial-session-state';
|
|
|
6
6
|
* minimal, session-oriented surface.
|
|
7
7
|
*
|
|
8
8
|
* The session is intentionally slim so that apps (Angular, Vue, React, etc.)
|
|
9
|
-
* can drive their UI purely from `state$` + `isConnected$` + `receive$` + `lines$` + `errors$` and never
|
|
9
|
+
* can drive their UI purely from `state$` + `isConnected$` + `receive$` + `terminalText$` + `lines$` + `errors$` and never
|
|
10
10
|
* have to rebuild BehaviorSubjects, manage a read loop, or serialize writes
|
|
11
11
|
* themselves.
|
|
12
12
|
*
|
|
@@ -136,6 +136,20 @@ export interface SerialSession {
|
|
|
136
136
|
* @see {@link https://github.com/gurezo/web-serial-rxjs/issues/273 | Issue #273}
|
|
137
137
|
*/
|
|
138
138
|
readonly receive$: Observable<string>;
|
|
139
|
+
/**
|
|
140
|
+
* Terminal-display oriented cumulative text derived from {@link receive$}.
|
|
141
|
+
*
|
|
142
|
+
* This stream collapses carriage-return redraws (`\r`) and keeps normal
|
|
143
|
+
* newline behavior (`\n`, `\r\n`) so apps can bind terminal-like output
|
|
144
|
+
* directly without wrapping {@link createTerminalBuffer} in every consumer.
|
|
145
|
+
*
|
|
146
|
+
* Equivalent behavior:
|
|
147
|
+
*
|
|
148
|
+
* ```typescript
|
|
149
|
+
* createTerminalBuffer(receive$).text$
|
|
150
|
+
* ```
|
|
151
|
+
*/
|
|
152
|
+
readonly terminalText$: Observable<string>;
|
|
139
153
|
/**
|
|
140
154
|
* Same source data as {@link receive$} but, when
|
|
141
155
|
* {@link SerialSessionOptions.receiveReplay} has `enabled: true`, it uses a
|
|
@@ -152,7 +166,8 @@ export interface SerialSession {
|
|
|
152
166
|
* Decoded text split into **complete lines** using `\n`, `\r\n`, and
|
|
153
167
|
* lone interior `\r` (see implementation). Intended for **logs**,
|
|
154
168
|
* newline-framed command responses, and parsers—not for mirroring raw
|
|
155
|
-
* terminal output where `\r` must be preserved for progress/redraw.
|
|
169
|
+
* terminal output where `\r` must be preserved for progress/redraw. For
|
|
170
|
+
* rendering terminal text, prefer {@link terminalText$}.
|
|
156
171
|
*
|
|
157
172
|
* A trailing fragment without a line terminator is buffered until a later
|
|
158
173
|
* chunk completes a line, or discarded on disconnect. It is **not**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"serial-session.d.ts","sourceRoot":"","sources":["../../src/session/serial-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C
|
|
1
|
+
{"version":3,"file":"serial-session.d.ts","sourceRoot":"","sources":["../../src/session/serial-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;CACpD"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gurezo/web-serial-rxjs",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.3.0",
|
|
4
4
|
"description": "RxJS-based utilities for the Web Serial API, usable from Angular, React, Svelte, and Vanilla JavaScript/TypeScript.",
|
|
5
5
|
"author": "Akihiko Kigure <akihiko.kigure@gmail.com>",
|
|
6
6
|
"license": "MIT",
|