@cosyte/mllp 0.0.1 → 0.0.2

package/dist/index.cjs

@@ -27,13 +27,13 @@ var MllpFramingError = class _MllpFramingError extends Error {
   /**
    * Up to 64 bytes copied from around the anomaly.
    *
-   * This is a **copied** Buffer — isolated from the source buffer so it remains
+   * This is a **copied** Buffer, isolated from the source buffer so it remains
    * valid after the underlying buffer is reused or overwritten.
    *
    * **PHI contract (MLLP-9):** the decoder only ever populates this with the single
    * framing-boundary byte that violated the frame structure (whose hex value the
-   * `message` already discloses) — never a run of payload content bytes. For anomalies
-   * whose fault is not a specific byte (`MLLP_FRAME_TOO_LARGE` — the accumulated size),
+   * `message` already discloses), never a run of payload content bytes. For anomalies
+   * whose fault is not a specific byte (`MLLP_FRAME_TOO_LARGE`, the accumulated size),
    * the snippet is **empty**: a payload slice on a public error field would leak a
    * field-body slice of clinical content. Callers constructing this directly are
    * responsible for the same discipline.
@@ -106,7 +106,7 @@ var FrameReader = class {
   _opts;
   _maxFrameSize;
   _state = "SCANNING_FOR_VT";
-  /** Reusable accumulator buffer — grown by doubling as needed. */
+  /** Reusable accumulator buffer, grown by doubling as needed. */
   _accumulator = Buffer.allocUnsafe(INITIAL_ACCUMULATOR_SIZE);
   /** Number of payload bytes written to accumulator in current frame. */
   _writePos = 0;
@@ -118,7 +118,7 @@ var FrameReader = class {
   _wsCount = 0;
   /** Byte offset of the VT byte that started the current frame. */
   _frameStartOffset = 0;
-  /** Per-frame warning accumulator — cleared after each _deliverFrame(). */
+  /** Per-frame warning accumulator, cleared after each _deliverFrame(). */
   _frameWarnings = [];
   /**
    * Construct a chunked MLLP frame reader.
@@ -242,7 +242,7 @@ var FrameReader = class {
       this._emitWarning(
         "MLLP_MISSING_LEADING_VT",
         this._byteOffset,
-        `Missing leading VT (0x0B) \u2014 treating byte 0x${byte.toString(16).padStart(2, "0")} at offset ${this._byteOffset} as payload start`
+        `Missing leading VT (0x0B), treating byte 0x${byte.toString(16).padStart(2, "0")} at offset ${this._byteOffset} as payload start`
       );
       this._frameStartOffset = this._byteOffset;
       this._state = "READING_PAYLOAD";
@@ -487,8 +487,8 @@ var TlsTransport = class {
     this._socket.on("data", fn);
   }
   /**
-   * See {@link Transport.onConnect}. Armed on `'secureConnect'` — the TLS
-   * handshake-complete event — not the raw TCP `'connect'` event.
+   * See {@link Transport.onConnect}. Armed on `'secureConnect'`, the TLS
+   * handshake-complete event, not the raw TCP `'connect'` event.
    */
   onConnect(fn) {
     this._socket.removeAllListeners("secureConnect");
@@ -569,14 +569,14 @@ var Connection = class extends events.EventEmitter {
   _lastByteOutAt = null;
   /** Ring buffer: last MAX_WARNINGS entries (OBS-05). */
   _warningBuffer = [];
-  /** Accurate total counts per code — unaffected by ring buffer truncation (OBS-05). */
+  /** Accurate total counts per code, unaffected by ring buffer truncation (OBS-05). */
   _warningsByCode = /* @__PURE__ */ new Map();
   /** Set to true once the ring buffer overflows (OBS-05). */
   _warningsTruncated = false;
   _onWarningFn = null;
   _drainPromise = null;
   /**
-   * beforeClose hook — no-op default that resolves immediately.
+   * beforeClose hook, no-op default that resolves immediately.
    *
    * Phase 4 (Server) and Phase 5 (Client) override this instance property to
    * register ACK-drain and send-queue drain logic respectively (D-07/D-08).
@@ -760,7 +760,7 @@ var Connection = class extends events.EventEmitter {
    * Abruptly destroy the connection, discarding any pending writes.
    *
    * Transitions from any non-terminal state directly to `CLOSED` and calls
-   * `transport.destroy(reason)`. Emits `'close'` event. Idempotent — safe to
+   * `transport.destroy(reason)`. Emits `'close'` event. Idempotent, safe to
    * call multiple times.
    *
    * @param reason - Optional error to propagate to the transport.
@@ -860,12 +860,12 @@ var Connection = class extends events.EventEmitter {
    * Node throws `ERR_UNHANDLED_ERROR` when `'error'` is emitted on an `EventEmitter` with no
    * listener. Every `'error'` emission in this class is reached from inside a transport callback
    * (the socket's `'data'`/`'error'` listener), so an unguarded emit would become an **uncaught
-   * exception that kills the process** — the exact failure the containment above exists to
+   * exception that kills the process**, the exact failure the containment above exists to
    * prevent, merely relocated one frame up the stack.
    *
    * `Connection` is a public export and can legitimately be driven with no `'error'` listener
    * (`MllpServer` and `MllpClient` each attach one; a bare `Connection` need not). The connection
-   * is still torn down and `'stateChange'`/`'close'` still fire, so a caller is never blind —
+   * is still torn down and `'stateChange'`/`'close'` still fire, so a caller is never blind,
    * they simply do not get the typed error object they never asked for. Mirrors
    * `MllpServer._emitErrorIfListened`.
    */
@@ -884,7 +884,7 @@ var Connection = class extends events.EventEmitter {
    * consumers keep the stable `code` and `byteOffset`), then **destroy this connection only**.
    *
    * Why destroy rather than resynchronize: once `push` has thrown, the reader's position within
-   * the byte stream is no longer trustworthy — the next bytes could be the middle of a message.
+   * the byte stream is no longer trustworthy, the next bytes could be the middle of a message.
    * Guessing where the next frame starts is how a clinical message gets silently mis-split, so
    * the connection is dropped instead. A server drops that one peer and keeps serving everyone
    * else.
@@ -896,7 +896,7 @@ var Connection = class extends events.EventEmitter {
    * engine that is already unwell. A compatibility failure is not a network blip.
    *
    * If a peer's quirk is *expected* (trailing junk, keepalive bytes, a missing leading VT), the
-   * decoder's tolerance opt-ins are the supported answer — they turn the throw into a warning.
+   * decoder's tolerance opt-ins are the supported answer, they turn the throw into a warning.
    */
   _onFatalFramingError(err) {
     if (this._state === "CLOSED") return;
@@ -910,13 +910,13 @@ var Connection = class extends events.EventEmitter {
     this.destroy(err);
   }
   /**
-   * Backstop for a NON-framing throw escaping `FrameReader.push` — i.e. our own bug, or a
+   * Backstop for a NON-framing throw escaping `FrameReader.push`, i.e. our own bug, or a
    * subscriber's, rather than the peer's bytes.
    *
    * `_onFrameDecoded` already contains subscriber throws at the dispatch site, so this should be
    * unreachable. It exists because "unreachable" and "cannot kill the process from inside a
    * socket `'data'` handler" are different claims, and only the second one is safe to bet a
-   * clinical interface on. Reported honestly as an internal receive error — never dressed up as
+   * clinical interface on. Reported honestly as an internal receive error, never dressed up as
    * a peer framing fault.
    */
   _onInternalReceiveError(err) {
@@ -992,9 +992,9 @@ var UNSAFE_FIELD_SEPARATORS = /* @__PURE__ */ new Set([
   SEGMENT_SEPARATOR_CR,
   SEGMENT_SEPARATOR_LF,
   11,
-  // VT — MLLP start block
+  // VT, MLLP start block
   28
-  // FS — MLLP end block
+  // FS, MLLP end block
 ]);
 function isMshSegmentAt(buf, i) {
   return i + 3 < buf.length && buf[i] === ASCII_M && buf[i + 1] === ASCII_S && buf[i + 2] === ASCII_H && !UNSAFE_FIELD_SEPARATORS.has(buf[i + 3]);
@@ -1227,13 +1227,13 @@ var MllpServer = class extends events.EventEmitter {
   _netServer;
   _connections = /* @__PURE__ */ new Set();
   _opts;
-  /** `true` when `ServerOptions.tls` is set — `_netServer` is actually a `tls.Server`. */
+  /** `true` when `ServerOptions.tls` is set, `_netServer` is actually a `tls.Server`. */
   _isTls;
   _listening = false;
-  /** Phase 8 — single-flight guard: `true` while a `listen()` call is settling. */
+  /** Phase 8, single-flight guard: `true` while a `listen()` call is settling. */
   _listenInFlight = false;
   /**
-   * Phase 8 — settle hook for an in-flight `listen()`. Non-null only while a
+   * Phase 8, settle hook for an in-flight `listen()`. Non-null only while a
    * `listen()` is in flight; invoked by `close()` so a close racing startup
    * rejects the pending `listen()` (typed) instead of leaving it hung with
    * the single-flight guard stuck. Cleared on every settle path.
@@ -1243,7 +1243,7 @@ var MllpServer = class extends events.EventEmitter {
   _host = null;
   _acceptedTotal = 0;
   _closedTotal = 0;
-  /** Phase 8 — count of `'tlsClientError'` events since listen(). */
+  /** Phase 8, count of `'tlsClientError'` events since listen(). */
   _tlsClientErrorsTotal = 0;
   /**
    * Construct an MLLP server. Created idle; call `listen()` (or use
@@ -1306,23 +1306,23 @@ var MllpServer = class extends events.EventEmitter {
    * `Object.freeze({ port: actualPort, host: actualHost })`.
    *
    * **Single-flight:** one `listen()` per server lifecycle at a time. A call
-   * while the server is already listening — or while another `listen()` is
-   * still in flight — rejects with a typed `MllpConnectionError` (concurrent
+   * while the server is already listening, or while another `listen()` is
+   * still in flight, rejects with a typed `MllpConnectionError` (concurrent
    * binds raced each other's post-bind safety checks). Call `close()` before
    * re-listening; sequential `listen()` → `close()` → `listen()` is fine.
    *
    * **`close()` during an in-flight `listen()`** rejects that `listen()` with
    * a typed `MllpConnectionError` (never a hang) and clears the single-flight
-   * guard — a subsequent `listen()` on the same server works. This makes
+   * guard, a subsequent `listen()` on the same server works. This makes
    * `Symbol.asyncDispose` (which delegates to `close()`) safe even before a
    * `listen()` has settled. (Exception: `close({ signal })` with an
-   * already-aborted signal is a no-op AbortError rejection — the in-flight
+   * already-aborted signal is a no-op AbortError rejection, the in-flight
    * `listen()` is left to settle on its own bind outcome; see `close()`.)
    *
    * @param port - TCP port to bind. Use `0` to let the OS assign an ephemeral port.
    * @param hostOrOpts - Host string or object with `host` and optional `signal`.
    *   Default host: `'127.0.0.1'` (Phase 8 bind-safety hardening). Wildcard hosts
-   *   are rejected unless `ServerOptions.allowWildcardBind: true` — literal
+   *   are rejected unless `ServerOptions.allowWildcardBind: true`, literal
    *   spellings pre-bind, resolver-only shorthands post-bind via the
    *   OS-normalized bound address.
    *
@@ -1342,7 +1342,7 @@ var MllpServer = class extends events.EventEmitter {
     if (this._listening || this._listenInFlight) {
       return Promise.reject(
         new MllpConnectionError(
-          this._listening ? "listen() rejected: server is already listening \u2014 call close() before re-listening" : "listen() rejected: another listen() is already in flight on this server",
+          this._listening ? "listen() rejected: server is already listening, call close() before re-listening" : "listen() rejected: another listen() is already in flight on this server",
           {
             cause: new Error("listen already listening or in flight"),
             phase: "connect"
@@ -1353,7 +1353,7 @@ var MllpServer = class extends events.EventEmitter {
     if (isWildcardHost(host) && this._opts.allowWildcardBind !== true) {
       return Promise.reject(
         new MllpConnectionError(
-          `refusing to bind wildcard host '${host}' \u2014 set ServerOptions.allowWildcardBind: true to bind all interfaces`,
+          `refusing to bind wildcard host '${host}', set ServerOptions.allowWildcardBind: true to bind all interfaces`,
           {
             cause: new Error("wildcard bind requires allowWildcardBind"),
             phase: "connect"
@@ -1432,7 +1432,7 @@ var MllpServer = class extends events.EventEmitter {
             {
               ok: false,
               error: new MllpConnectionError(
-                `refusing to bind wildcard host '${host}' (bound address '${actualHost}') \u2014 set ServerOptions.allowWildcardBind: true to bind all interfaces`,
+                `refusing to bind wildcard host '${host}' (bound address '${actualHost}'), set ServerOptions.allowWildcardBind: true to bind all interfaces`,
                 {
                   cause: new Error("wildcard bind requires allowWildcardBind"),
                   phase: "connect"
@@ -1459,7 +1459,7 @@ var MllpServer = class extends events.EventEmitter {
           }
         };
         const wildcardBound = isWildcardHost(actualHost);
-        const wildcardMessage = `MLLP server is bound to ALL network interfaces (host='${actualHost}') \u2014 set a specific bind address unless this is intentional.`;
+        const wildcardMessage = `MLLP server is bound to ALL network interfaces (host='${actualHost}'), set a specific bind address unless this is intentional.`;
         if (wildcardBound) {
           process.emitWarning(wildcardMessage, { code: MLLP_BIND_ALL_INTERFACES });
         }
@@ -1488,18 +1488,18 @@ var MllpServer = class extends events.EventEmitter {
    * Stop accepting new connections and gracefully close all active connections.
    *
    * Sequence (D-06):
-   * 1. `net.Server.close()` — stops accepting new connections immediately
+   * 1. `net.Server.close()`, stops accepting new connections immediately
    * 2. If `_connections` is empty: resolves immediately (no drain needed)
-   * 3. Calls `_drainAll(drainTimeoutMs)` — Promise.all + side-effect setTimeout
+   * 3. Calls `_drainAll(drainTimeoutMs)`, Promise.all + side-effect setTimeout
    *    that force-destroys stragglers after the drain window
    *
    * Calling `close()` while a `listen()` is still in flight proactively
    * settles that `listen()` with a typed `MllpConnectionError` rejection
-   * and clears the single-flight guard — the server is immediately
+   * and clears the single-flight guard, the server is immediately
    * re-listenable. `Symbol.asyncDispose` (which delegates here) is
    * therefore safe before `listen()` settles. **Qualification:** a
    * `close({ signal })` whose signal is **already aborted** rejects
-   * immediately with `AbortError` and performs no work — it does NOT close
+   * immediately with `AbortError` and performs no work, it does NOT close
    * the server and does NOT settle the in-flight `listen()`, which simply
    * continues and settles on its own bind outcome.
    *
@@ -1551,7 +1551,7 @@ var MllpServer = class extends events.EventEmitter {
   /**
    * Drain all active connections with a shared timeout.
    *
-   * Uses Promise.all (not Promise.race) for coordination — the timeout is a
+   * Uses Promise.all (not Promise.race) for coordination, the timeout is a
    * side effect that calls `conn.destroy()` on stragglers after `drainTimeoutMs`.
    * Promise.all resolves when all `conn.close()` promises settle (which happens
    * because `conn.destroy()` transitions connections to CLOSED).
@@ -1574,7 +1574,7 @@ var MllpServer = class extends events.EventEmitter {
     }
   }
   /**
-   * Async disposal — delegates to `close()` for `await using` support.
+   * Async disposal, delegates to `close()` for `await using` support.
    *
    * @example
    * ```typescript
@@ -1621,7 +1621,7 @@ var MllpServer = class extends events.EventEmitter {
     };
   }
   /**
-   * Emit on `'error'` only when a listener is attached — an unlistened
+   * Emit on `'error'` only when a listener is attached, an unlistened
    * `EventEmitter` `'error'` emission throws (see the class JSDoc error
    * contract). The single guard shared by the optional-tap forwarding sites
    * in this class; the constructor's net.Server forwarder deliberately does
@@ -1631,7 +1631,7 @@ var MllpServer = class extends events.EventEmitter {
   /**
    * Emit a server event, containing a throwing subscriber.
    *
-   * Every event this server emits is reachable from a callback we do not own — the `net.Server`
+   * Every event this server emits is reachable from a callback we do not own, the `net.Server`
    * `'connection'` listener, the `tls.Server` `'tlsClientError'` listener, a socket's `'data'`
    * listener (via `Connection`), or the `catch` block of a `void`-ed async ACK task. A throwing
    * subscriber would therefore unwind into that callback and kill the process (or reject a void-ed
@@ -1737,7 +1737,7 @@ var MllpServer = class extends events.EventEmitter {
   }
   /**
    * Extract a minimal, content-free peer-certificate summary (Phase 8, ATNA
-   * ITI-19 mutual authentication) — CN strings, expiry, and the verification
+   * ITI-19 mutual authentication), CN strings, expiry, and the verification
    * outcome (`authorized`) only; never the full certificate object. Returns
    * `null` when no peer certificate was presented (e.g. `clientAuth: 'WANT'`
    * with no client cert).
@@ -1755,7 +1755,7 @@ var MllpServer = class extends events.EventEmitter {
       subjectCN: asCn(cert.subject?.CN),
       issuerCN: asCn(cert.issuer?.CN),
       validTo: cert.valid_to ?? null,
-      // Verification outcome — under 'WANT' a certificate can be present yet
+      // Verification outcome, under 'WANT' a certificate can be present yet
       // UNVERIFIED (see PeerCertificateSummary.authorized JSDoc).
       authorized: socket.authorized === true
     });
@@ -1767,12 +1767,12 @@ var MllpServer = class extends events.EventEmitter {
    * then dispatches: resolve ⇒ `AA`; throw/reject ⇒ a negative ACK (`AE` by default,
    * `AR` via {@link MllpAckError}). A positive ACK can never precede a successful commit.
    *
-   * Without an `onMessage` handler, `'AA'` degrades to a **transport-accept** — `AA`
+   * Without an `onMessage` handler, `'AA'` degrades to a **transport-accept**, `AA`
    * meaning "bytes received and framed", not "application-processed".
    *
    * A handler failure is **expected flow**, not a server error: it produces a negative
    * ACK and a `'nack'` event. The thrown error's message is never placed on the wire or
-   * in the event (it may carry PHI) — only the static `ackCode` and the inbound control
+   * in the event (it may carry PHI), only the static `ackCode` and the inbound control
    * metadata reach the peer.
    */
   async _sendCommitAck(payload, meta, conn) {
@@ -1804,18 +1804,18 @@ var MllpServer = class extends events.EventEmitter {
   }
   /**
    * Resolve the auto-ACK code for a message the server would otherwise acknowledge
-   * **positively** (`AA`) — the no-handler transport-accept and the post-commit success
+   * **positively** (`AA`), the no-handler transport-accept and the post-commit success
    * paths. Fail-safe: downgrade to `AE` and emit a PHI-safe `'nack'` whenever the message
    * cannot carry a correlatable positive ACK, so `AA` never names a control ID the sender
    * cannot match (→ timeout → resend → **duplicate clinical message**).
    *
    * Two independent disqualifiers, one from the bytes and one from the frame:
    *
-   *   - **`rawAckUncorrelatable(payload)`** — no readable `MSH`, an empty MSH-10, or a
+   *   - **`rawAckUncorrelatable(payload)`**, no readable `MSH`, an empty MSH-10, or a
    *     batch/concatenated-message shape. This is the SAME predicate `buildRawAck` enforces
    *     on the wire; it is re-checked here so the downgrade is **observable** (a `'nack'`
    *     event) rather than a silent code change inside the builder.
-   *   - **`MLLP_TRAILING_BYTES`** in the frame's warnings — a mid-payload `VT` made the
+   *   - **`MLLP_TRAILING_BYTES`** in the frame's warnings, a mid-payload `VT` made the
    *     decoder discard accumulated bytes and deliver only the fragment after it. The
    *     clinical message was destroyed in transit, so even a fragment that happens to carry
    *     a readable MSH must not be positively acknowledged. This condition is invisible to
@@ -1824,7 +1824,7 @@ var MllpServer = class extends events.EventEmitter {
    *     accumulating the delivered frame, so it is frame-scoped: it names *this* payload's own
    *     discard, never a neighbouring frame's trailing junk.
    *
-   * `'discarded-bytes'` takes precedence in the reason when both hold — it is the root cause.
+   * `'discarded-bytes'` takes precedence in the reason when both hold, it is the root cause.
    */
   _resolveAutoAckPositive(payload, meta, conn) {
     const discarded = meta.warnings.some((w) => w.code === "MLLP_TRAILING_BYTES");
@@ -1859,7 +1859,7 @@ var MllpServer = class extends events.EventEmitter {
   /**
    * The custom-builder path for `autoAck: fn`. Awaits the builder and dispatches its
    * Buffer as the ACK; the caller owns MSA-1. A builder error is re-emitted as `'error'`
-   * on the connection — the server never crashes (D-04).
+   * on the connection, the server never crashes (D-04).
    */
   async _sendCustomAck(fn, payload, meta, conn) {
     try {
@@ -1873,7 +1873,7 @@ var MllpServer = class extends events.EventEmitter {
   /**
    * Frame an ACK payload and write it to the connection. `Connection.send()` returns
    * `false` under backpressure (socket write buffer full); that drops the ACK and emits
-   * a `MllpConnectionError({ phase: 'send' })` on the connection (D-04) — the peer will
+   * a `MllpConnectionError({ phase: 'send' })` on the connection (D-04), the peer will
    * time out waiting and may retry. The server never crashes.
    */
   _dispatchAck(conn, ackPayload) {
@@ -1938,7 +1938,7 @@ var Correlator = class {
   _sendSeq = 0;
   _queueBytes = 0;
   /**
-   * PLAN-06 — count of pending entries with `sentAt !== null` (D-26 / B-01).
+   * PLAN-06, count of pending entries with `sentAt !== null` (D-26 / B-01).
    * Maintained at every site that mutates `entry.sentAt` or removes a
    * flushed entry: `markFlushed`, `remove`, `matchAck`, `expireDue`, `clear`.
    */
@@ -1974,7 +1974,7 @@ var Correlator = class {
   /**
    * Enqueue a new send awaiting its ACK. Returns the assigned
    * `correlationKey`, or `null` if `maxInFlight` is reached (caller awaits
-   * drain — PLAN-05's `pipeline:false`).
+   * drain, PLAN-05's `pipeline:false`).
    */
   enqueue(frame, controlIdOrNull, resolve, reject) {
     if (this._pending.size >= this._opts.maxInFlight) return null;
@@ -1993,7 +1993,7 @@ var Correlator = class {
     return key;
   }
   /**
-   * Record write-flush timestamp (CLIENT-04 — clock starts at flush, NOT
+   * Record write-flush timestamp (CLIENT-04, clock starts at flush, NOT
    * at `send()` call). No-op if key is unknown (e.g. removed by abort).
    */
   markFlushed(key, now) {
@@ -2063,7 +2063,7 @@ var Correlator = class {
   /**
    * Sweep live entries; expire those past `sentAt + ackTimeoutMs`.
    * Fires `onTimeout(entry, elapsedMs)`; entries move to graveyard (D-04).
-   * Driven externally by `MllpClient`'s periodic sweep tick — Correlator
+   * Driven externally by `MllpClient`'s periodic sweep tick, Correlator
    * itself owns no timers (D-03).
    */
   expireDue(now) {
@@ -2086,7 +2086,7 @@ var Correlator = class {
   /**
    * Reject every live entry with `reason` (insertion order) and clear
    * the live store. Graveyard is left intact (ages out via lazy eviction).
-   * Used by FIFO reconnect-reject (D-07 — PLAN-04 wraps in MllpConnectionError)
+   * Used by FIFO reconnect-reject (D-07, PLAN-04 wraps in MllpConnectionError)
    * and `MllpClient.close()` to cancel pending sends.
    */
   clear(reason) {
@@ -2267,7 +2267,7 @@ var MllpClient = class extends events.EventEmitter {
   /** 0-indexed attempt counter for the current reconnect cycle. */
   _attempt = 0;
   /**
-   * W-02 — total reconnect attempts since construction. Read by PLAN-06 for
+   * W-02, total reconnect attempts since construction. Read by PLAN-06 for
    * `getStats().reconnectAttempts`. Incremented at the entry of every
    * `_handleDisconnect` invocation that proceeds to schedule a backoff.
    */
@@ -2289,7 +2289,7 @@ var MllpClient = class extends events.EventEmitter {
   _onBackpressure;
   /** Pipeline flag; default `true` (parallel up to highWaterMark). */
   _pipeline;
-  /** Dead-peer idle timer (Plan 05 — D-11). `null` when not armed. */
+  /** Dead-peer idle timer (Plan 05, D-11). `null` when not armed. */
   _deadPeerTimer = null;
   /** True once the self-'ack' listener that resets the dead-peer timer
    * has been attached. Guards against duplicate listeners on reconnect. */
@@ -2303,13 +2303,13 @@ var MllpClient = class extends events.EventEmitter {
   /** Listener-removal handle for the abort listener bound in connect(). */
   _abortListener = null;
   /**
-   * Test-only seam — when set, `_beginReconnectAttempt` builds the new
+   * Test-only seam, when set, `_beginReconnectAttempt` builds the new
    * Connection through this factory instead of opening a real net.Socket.
    *
    * @internal
    */
   _reconnectFactory = null;
-  // ── PLAN-06 — observability counters for getStats (OBS-01, D-26) ─────────
+  // ── PLAN-06, observability counters for getStats (OBS-01, D-26) ─────────
   /** Total successful `conn.send()` flushes since construction. */
   _sentTotal = 0;
   /** Total ACKs resolved since construction. */
@@ -2363,9 +2363,9 @@ var MllpClient = class extends events.EventEmitter {
     return this._connection?.state ?? this._state;
   }
   /**
-   * Open a TCP (or TLS — Phase 8) connection to the configured `host:port`
+   * Open a TCP (or TLS, Phase 8) connection to the configured `host:port`
    * and attach a Phase 3 {@link Connection} to it. Resolves once the FSM
-   * enters `CONNECTED` — for TLS, on `'secureConnect'` (handshake complete,
+   * enters `CONNECTED`, for TLS, on `'secureConnect'` (handshake complete,
    * including certificate verification when it is on).
    *
    * Rejects with:
@@ -2385,11 +2385,11 @@ var MllpClient = class extends events.EventEmitter {
    *
    * **TLS 1.3 + mutual TLS caveat (RFC 8446 §4.4.2):** `connect()` resolving
    * does NOT guarantee that a `clientAuth: 'MUST'` server accepted your
-   * client certificate. Under TLS 1.3 the client's handshake — and its
-   * `'secureConnect'` — can complete before the server finishes validating
+   * client certificate. Under TLS 1.3 the client's handshake, and its
+   * `'secureConnect'`, can complete before the server finishes validating
    * the certificate; a rejection then surfaces moments later as a typed
    * post-connect error (`'error'` event with an `ERR_SSL_*`/alert cause,
-   * classified **permanent** — no auto-reconnect loop). ACK correlation via
+   * classified **permanent**, no auto-reconnect loop). ACK correlation via
    * {@link MllpClient.send} remains the delivery guarantee: no send resolves
    * without its ACK, so a rejected session can never silently "deliver".
    *
@@ -2473,7 +2473,7 @@ var MllpClient = class extends events.EventEmitter {
    *
    * Plaintext (`ClientOptions.tls` unset): a `net.Socket` wrapped in
    * `NetTransport`. TLS (Phase 8): a `tls.TLSSocket` wrapped in
-   * `TlsTransport` — verification defaults **on**
+   * `TlsTransport`, verification defaults **on**
    * (`rejectUnauthorized: !allowUnverified`), floor `minVersion: 'TLSv1.2'`
    * (the IHE ATNA ITI-19 BCP195 floor), `servername` defaulting to
    * `ClientOptions.host`.
@@ -2504,12 +2504,12 @@ var MllpClient = class extends events.EventEmitter {
    * Wrap a connect-phase socket error as `MllpConnectionError`, classifying
    * TLS failures (Phase 8) into the additive `connectionCause`:
    *
-   * - `'tls-verify'` — certificate-verification failures
+   * - `'tls-verify'`, certificate-verification failures
    *   ({@link isTlsVerificationErrorCode}).
-   * - `'tls-handshake'` — TLS-**protocol**-shaped failures only
+   * - `'tls-handshake'`, TLS-**protocol**-shaped failures only
    *   ({@link isTlsProtocolError}): `ERR_SSL_*`, `EPROTO`, OpenSSL
    *   alert-bearing errors.
-   * - **No `connectionCause`** — pure TCP-level failures (`ECONNREFUSED`,
+   * - **No `connectionCause`**, pure TCP-level failures (`ECONNREFUSED`,
    *   `ETIMEDOUT`, …) even on a TLS-configured connection; these carry the
    *   same shape as plaintext connect failures.
    */
@@ -2537,7 +2537,7 @@ var MllpClient = class extends events.EventEmitter {
   /**
    * Emit a client event, containing a throwing subscriber.
    *
-   * Every event this client emits is reached from a callback we do not own — a socket's
+   * Every event this client emits is reached from a callback we do not own, a socket's
    * `'connect'`/`'secureConnect'`/`'data'`/`'error'` listener, or a backoff timer. A throwing
    * subscriber would unwind into it and kill the process, and on several paths it would also skip
    * the work queued after the emit (the `resolve()` of `connect()`, the backoff scheduling).
@@ -2551,7 +2551,7 @@ var MllpClient = class extends events.EventEmitter {
   }
   /**
    * Emit the per-connection insecure-TLS warning (Phase 8) when
-   * `tls.allowUnverified === true` — fires on EVERY successful
+   * `tls.allowUnverified === true`, fires on EVERY successful
    * `secureConnect`, initial connect and every reconnect. Emits both a frozen
    * `'securityWarning'` event and `process.emitWarning`. No-op for plaintext
    * connections or when verification is on.
@@ -2560,7 +2560,7 @@ var MllpClient = class extends events.EventEmitter {
     const tlsOpt = this._opts.tls;
     if (tlsOpt === void 0 || tlsOpt === true) return;
     if (tlsOpt.allowUnverified !== true) return;
-    const message = "MLLP TLS certificate verification is DISABLED (allowUnverified: true) \u2014 this connection does not authenticate the peer.";
+    const message = "MLLP TLS certificate verification is DISABLED (allowUnverified: true), this connection does not authenticate the peer.";
     const warning = Object.freeze({
       code: MLLP_TLS_VERIFY_DISABLED,
       message,
@@ -2574,7 +2574,7 @@ var MllpClient = class extends events.EventEmitter {
   /**
    * Wire a Connection's events through to this MllpClient. Every re-emitted
    * payload is `Object.freeze`'d before emission (D-25), even though the
-   * Connection layer already freezes — defense-in-depth, harmless on
+   * Connection layer already freezes, defense-in-depth, harmless on
    * already-frozen objects.
    *
    * Builds the unified `Correlator` (D-03/A1) bound to this Connection and
@@ -2588,7 +2588,7 @@ var MllpClient = class extends events.EventEmitter {
       this._correlator = new Correlator({
         mode: this._correlateByControlId ? "controlId" : "fifo",
         ackTimeoutMs: this._ackTimeoutMs,
-        // Plan 05 — pipeline:false collapses the in-flight set to ≤1 (D-06).
+        // Plan 05, pipeline:false collapses the in-flight set to ≤1 (D-06).
         maxInFlight: this._pipeline ? Number.POSITIVE_INFINITY : 1,
         onWarning: (code, ctx) => {
           this._aggregatedWarningsByCode[code] = (this._aggregatedWarningsByCode[code] ?? 0) + 1;
@@ -2687,7 +2687,7 @@ var MllpClient = class extends events.EventEmitter {
     }
   }
   /**
-   * Arm (or re-arm) the dead-peer idle timer (Plan 05 — CLIENT-08, D-11).
+   * Arm (or re-arm) the dead-peer idle timer (Plan 05, CLIENT-08, D-11).
    * No-op when `deadPeerTimeoutMs` is unset.
    */
   _armDeadPeerTimer() {
@@ -2701,7 +2701,7 @@ var MllpClient = class extends events.EventEmitter {
     this._deadPeerTimer.unref();
   }
   /**
-   * Clear the dead-peer idle timer (Plan 05 — D-14 timer cleanup on
+   * Clear the dead-peer idle timer (Plan 05, D-14 timer cleanup on
    * every transition out of CONNECTED).
    */
   _clearDeadPeerTimer() {
@@ -2711,13 +2711,13 @@ var MllpClient = class extends events.EventEmitter {
     }
   }
   /**
-   * Disconnect handler — Plan 04 reconnect FSM core.
+   * Disconnect handler, Plan 04 reconnect FSM core.
    *
    * Implements:
    * - CLIENT-17 hybrid in-flight handling (D-08): controlId mode preserves
    *   pending sends for resend; FIFO mode rejects in-flight with
    *   `connectionCause: 'in-flight-orphan'` and queued with `'fifo-unsafe'`.
-   * - CLIENT-18 classifier-first (Composition A — D-16): permanent errors
+   * - CLIENT-18 classifier-first (Composition A, D-16): permanent errors
    *   transition straight to CLOSED without invoking `retryStrategy`.
    * - W-01 backoff-reset on recent success: first disconnect after a
    *   successful ACK on the prior session resets `_attempt` to 0.
@@ -2725,7 +2725,7 @@ var MllpClient = class extends events.EventEmitter {
    * - D-15 frozen RetryContext + D-17 null-return halts.
    * - D-19 default exponential strategy.
    *
-   * Invoked from the SINGLE `_onStateChange` hook — no parallel listener
+   * Invoked from the SINGLE `_onStateChange` hook, no parallel listener
    * (B-04). Idempotent across same-cycle re-entry: cycle-start flag
    * coordinates first-disconnect vs subsequent-within-cycle behavior.
    */
@@ -2914,7 +2914,7 @@ var MllpClient = class extends events.EventEmitter {
     this._reconnectCycleStartedAt = null;
   }
   /**
-   * Test seam — install a factory that produces the next reconnect Connection.
+   * Test seam, install a factory that produces the next reconnect Connection.
    *
    * @internal
    */
@@ -2922,7 +2922,7 @@ var MllpClient = class extends events.EventEmitter {
     this._reconnectFactory = factory;
   }
   /**
-   * Test seam — capture or rebind the connect-signal mid-flight (W-07).
+   * Test seam, capture or rebind the connect-signal mid-flight (W-07).
    *
    * @internal
    */
@@ -2952,7 +2952,7 @@ var MllpClient = class extends events.EventEmitter {
    *   anchor and passes it to `matchAck` for keyed lookup.
    *
    * Called from the SINGLE `'message'` listener registered in `_attachConnection`.
-   * No parallel listener is registered — downstream plans extend at the named
+   * No parallel listener is registered, downstream plans extend at the named
    * anchor (B-04).
    */
   _onAckPayload(ackPayload, byteOffset) {
@@ -2991,9 +2991,9 @@ var MllpClient = class extends events.EventEmitter {
   }
   /**
    * Emit a frozen `'drain'` event when the queue depth and bytes fall below
-   * both configured caps (Plan 05 — D-24). Called from `_onAckMatched`
+   * both configured caps (Plan 05, D-24). Called from `_onAckMatched`
    * (every successful ACK) and from the Correlator's `onTimeout` callback
-   * (every expired send) — both code paths free a live-store slot.
+   * (every expired send), both code paths free a live-store slot.
    */
   _maybeEmitDrain() {
     const corr = this._correlator;
@@ -3068,7 +3068,7 @@ var MllpClient = class extends events.EventEmitter {
    * ```
    *
    * @param payload Raw bytes; MLLP framing is added internally via `encodeFrame`.
-   * @param opts.signal AbortSignal — aborting cancels the ACK wait (CLIENT-11).
+   * @param opts.signal AbortSignal, aborting cancels the ACK wait (CLIENT-11).
    */
   send(payload, opts) {
     const signal = opts?.signal;
@@ -3156,7 +3156,7 @@ var MllpClient = class extends events.EventEmitter {
     });
   }
   /**
-   * 'wait'-mode backpressure handler (Plan 05 — CLIENT-07/CLIENT-11).
+   * 'wait'-mode backpressure handler (Plan 05, CLIENT-07/CLIENT-11).
    *
    * Awaits one of three terminating signals, in order:
    * - `'drain'` event → re-enter `send()` (the gate will now pass).
@@ -3218,7 +3218,7 @@ var MllpClient = class extends events.EventEmitter {
     this._clearDeadPeerTimer();
   }
   /**
-   * **Test seam** — attach an externally-built {@link Connection} directly,
+   * **Test seam**, attach an externally-built {@link Connection} directly,
    * bypassing the `net.createConnection` + `NetTransport` path. Used by
    * lifecycle tests driving `InMemoryTransport.pair()` for determinism.
    *
@@ -3297,7 +3297,7 @@ var MllpClient = class extends events.EventEmitter {
     }
   }
   /**
-   * Abruptly destroy the client — force-transitions the underlying Connection
+   * Abruptly destroy the client, force-transitions the underlying Connection
    * to `CLOSED` immediately. No-op if no Connection is attached. Idempotent.
    *
    * @example
@@ -3323,7 +3323,7 @@ var MllpClient = class extends events.EventEmitter {
   /**
    * Returns a JSON-serializable observability snapshot (OBS-01, D-26).
    *
-   * All fields are plain values — no Buffers, no class instances, no Maps,
+   * All fields are plain values, no Buffers, no class instances, no Maps,
    * no circular refs. Safe to `JSON.stringify` directly.
    *
    * `inFlight` is the count of correlator entries with `sentAt !== null`
@@ -3367,7 +3367,7 @@ var MllpClient = class extends events.EventEmitter {
     };
   }
   /**
-   * Async disposal — delegates to {@link MllpClient.close} for `await using` support.
+   * Async disposal, delegates to {@link MllpClient.close} for `await using` support.
    *
    * @example
    * ```typescript
@@ -3423,7 +3423,7 @@ async function createStarterClient(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.0.1";
+var VERSION = "0.0.2";
 
 exports.Connection = Connection;
 exports.FrameReader = FrameReader;