@sempdev/semp 0.4.3

package/dist/transport/h2.js

@@ -0,0 +1,397 @@
+/**
+ * HTTP/2 transport binding per TRANSPORT.md §4.2.
+ *
+ * Unlike WebSocket — which gives us a single bidirectional pipe —
+ * the SEMP HTTP/2 binding is a collection of HTTP endpoints with
+ * path-based routing:
+ *
+ *  - `POST /v1/discovery`     — discovery lookup
+ *  - `POST /v1/keys`          — key request
+ *  - `POST /v1/handshake`     — handshake step
+ *  - `POST /v1/envelope`      — envelope submit
+ *  - `POST /v1/session/{id}`  — long-lived bidirectional session
+ *                                stream (server pushes via SSE,
+ *                                client posts additional messages
+ *                                to the same URL)
+ *
+ * This module exposes:
+ *
+ *  - {@link h2Post}: a typed JSON POST helper for the four
+ *    request/response endpoints. Surfaces the `Semp-Session-Id`
+ *    response header to the caller.
+ *  - {@link dialH2Session}: opens a long-lived POST to
+ *    `/v1/session/{id}` and returns a {@link Transport} whose
+ *    `receive()` reads SSE events from the open stream and `send()`
+ *    POSTs additional messages to the same URL.
+ *  - {@link encodeSSE} / {@link decodeSSE}: encode/decode helpers
+ *    for callers that want to roll their own.
+ *
+ * @module
+ */
+/** Header name the server sets on its response to handshake init. */
+export const SempSessionIdHeader = "Semp-Session-Id";
+/**
+ * POST a SEMP message to one of the request/response endpoints
+ * (`/v1/handshake`, `/v1/keys`, `/v1/envelope`, `/v1/discovery`).
+ * Resolves with the response body and the `Semp-Session-Id` header.
+ *
+ * Translates HTTP status codes per §4.2.2:
+ *  - 2xx: resolves successfully.
+ *  - 400, 413, 429, 503: rejects with a structured error.
+ *  - other non-2xx: rejects with the status as the message.
+ */
+export async function h2Post(url, message, opts = {}) {
+    if (url === "") {
+        throw new Error("h2: empty url");
+    }
+    const fetchImpl = opts.fetchImpl ?? defaultFetch();
+    const headers = {
+        "Content-Type": "application/json; charset=utf-8",
+        Accept: "application/json",
+        ...(opts.headers ?? {}),
+    };
+    if (opts.sessionId !== undefined && opts.sessionId !== "") {
+        headers[SempSessionIdHeader] = opts.sessionId;
+    }
+    const { signal, cleanup } = composeSignal(opts.signal, opts.timeoutMs);
+    let resp;
+    try {
+        resp = await fetchImpl(url, {
+            method: "POST",
+            headers,
+            body: message,
+            signal,
+        });
+    }
+    finally {
+        cleanup();
+    }
+    if (!resp.ok) {
+        const reason = httpReason(resp.status);
+        throw new Error(`h2: POST ${url} ${reason} (${resp.status})`);
+    }
+    const buf = await resp.arrayBuffer();
+    return {
+        body: new Uint8Array(buf),
+        status: resp.status,
+        sessionId: resp.headers.get(SempSessionIdHeader),
+    };
+}
+function httpReason(status) {
+    switch (status) {
+        case 400:
+            return "malformed SEMP message";
+        case 413:
+            return "payload exceeds max_envelope_size";
+        case 429:
+            return "transport-level rate limit";
+        case 503:
+            return "server temporarily unavailable";
+        default:
+            return `HTTP ${status}`;
+    }
+}
+/**
+ * Open a long-lived POST to the session URL and return a
+ * {@link Transport} whose `receive()` reads SSE events from that
+ * response and `send()` POSTs additional messages to the same URL.
+ *
+ * Per TRANSPORT.md §4.2.4: each `data:` line in the response carries
+ * a complete SEMP JSON message; blank lines delimit events.
+ */
+export async function dialH2Session(opts) {
+    if (opts.sessionUrl === "") {
+        throw new Error("h2: empty sessionUrl");
+    }
+    const fetchImpl = opts.fetchImpl ?? defaultFetch();
+    const sendController = new AbortController();
+    const composed = composeSignal(opts.signal, opts.timeoutMs);
+    const headers = {
+        "Content-Type": "application/json; charset=utf-8",
+        Accept: "text/event-stream",
+    };
+    let resp;
+    try {
+        resp = await fetchImpl(opts.sessionUrl, {
+            method: "POST",
+            headers,
+            body: opts.initialBody,
+            signal: composed.signal,
+        });
+    }
+    catch (err) {
+        composed.cleanup();
+        throw err;
+    }
+    composed.cleanup();
+    if (!resp.ok) {
+        throw new Error(`h2: session POST ${opts.sessionUrl} ${httpReason(resp.status)} (${resp.status})`);
+    }
+    if (resp.body === null || resp.body === undefined) {
+        throw new Error("h2: session response has no body");
+    }
+    const eventReader = createEventReader(resp.body);
+    let closed = false;
+    const url = opts.sessionUrl;
+    const transport = {
+        async send(message) {
+            if (closed) {
+                throw new Error("h2: session transport closed");
+            }
+            const r = await fetchImpl(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json; charset=utf-8",
+                    Accept: "application/json",
+                },
+                body: message,
+                signal: sendController.signal,
+            });
+            if (!r.ok) {
+                throw new Error(`h2: session send ${httpReason(r.status)} (${r.status})`);
+            }
+            // Discard the body; per spec, server-pushed messages arrive on
+            // the SSE stream, not on the per-send response.
+            await r.arrayBuffer();
+        },
+        async receive() {
+            if (closed) {
+                return null;
+            }
+            const event = await eventReader.read();
+            if (event === null) {
+                closed = true;
+                return null;
+            }
+            return new TextEncoder().encode(event);
+        },
+        async close() {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            sendController.abort();
+            eventReader.close();
+        },
+    };
+    return transport;
+}
+// ---------------------------------------------------------------------------
+// SSE encode
+/**
+ * Encode a single SEMP message as an SSE event. Each line in the
+ * message body produces a `data:` line; the event is terminated with
+ * a single blank line.
+ *
+ * The encoder normalizes CR / CRLF line terminators to LF before
+ * emitting each `data:` line. SEMP payloads are JSON documents whose
+ * control bytes are escaped (`\r`, `\n`), so the wire form never
+ * actually carries a literal CR or LF — but be defensive.
+ */
+export function encodeSSE(message) {
+    const lines = splitSSELines(message);
+    let out = "";
+    for (const line of lines) {
+        out += "data: " + line + "\n";
+    }
+    out += "\n";
+    return out;
+}
+function splitSSELines(s) {
+    if (s === "") {
+        return [""];
+    }
+    const out = [];
+    let start = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c !== 0x0d && c !== 0x0a) {
+            continue;
+        }
+        out.push(s.slice(start, i));
+        if (c === 0x0d && i + 1 < s.length && s.charCodeAt(i + 1) === 0x0a) {
+            i++; // skip LF in CRLF
+        }
+        start = i + 1;
+    }
+    out.push(s.slice(start));
+    return out;
+}
+// ---------------------------------------------------------------------------
+// SSE decode
+/**
+ * Decode SSE events from a string buffer. Each call returns the next
+ * complete event's `data` payload (or `null` if no complete event is
+ * buffered yet). Stateful — the buffer accumulates partial input.
+ */
+export class SSEDecoder {
+    buffer = "";
+    dataLines = [];
+    /** Append more bytes to the buffer. */
+    push(chunk) {
+        this.buffer += chunk;
+    }
+    /**
+     * Return the data payload of the next complete event, or `null` if
+     * none is buffered. Repeatedly call until `null` to drain.
+     */
+    next() {
+        while (true) {
+            const lf = this.buffer.indexOf("\n");
+            if (lf < 0) {
+                return null;
+            }
+            let line = this.buffer.slice(0, lf);
+            this.buffer = this.buffer.slice(lf + 1);
+            if (line.endsWith("\r")) {
+                line = line.slice(0, -1);
+            }
+            if (line === "") {
+                if (this.dataLines.length > 0) {
+                    const event = this.dataLines.join("\n");
+                    this.dataLines = [];
+                    return event;
+                }
+                // Empty leading lines (keepalives) — skip.
+                continue;
+            }
+            // Comment lines start with ":" — ignore.
+            if (line.startsWith(":")) {
+                continue;
+            }
+            // Field parse: "<field>:<value>" with optional space after colon.
+            const colon = line.indexOf(":");
+            let field;
+            let value;
+            if (colon < 0) {
+                field = line;
+                value = "";
+            }
+            else {
+                field = line.slice(0, colon);
+                value = line.slice(colon + 1);
+                if (value.startsWith(" ")) {
+                    value = value.slice(1);
+                }
+            }
+            if (field !== "data") {
+                continue;
+            }
+            this.dataLines.push(value);
+        }
+    }
+    /**
+     * Flush any pending data lines as a final event. Called on EOF when
+     * the underlying stream ends without a trailing blank line.
+     */
+    flush() {
+        if (this.dataLines.length === 0) {
+            return null;
+        }
+        const event = this.dataLines.join("\n");
+        this.dataLines = [];
+        return event;
+    }
+}
+/** Decode all events present in a complete (already-buffered) SSE blob. */
+export function decodeSSE(blob) {
+    const dec = new SSEDecoder();
+    dec.push(blob);
+    const out = [];
+    while (true) {
+        const ev = dec.next();
+        if (ev === null) {
+            break;
+        }
+        out.push(ev);
+    }
+    const trailing = dec.flush();
+    if (trailing !== null) {
+        out.push(trailing);
+    }
+    return out;
+}
+function createEventReader(body) {
+    const decoder = new SSEDecoder();
+    const utf8 = new TextDecoder("utf-8");
+    let done = false;
+    let buffered = null;
+    const iter = makeAsyncIterator(body);
+    return {
+        async read() {
+            if (buffered !== null) {
+                const out = buffered;
+                buffered = null;
+                return out;
+            }
+            while (true) {
+                const ev = decoder.next();
+                if (ev !== null) {
+                    return ev;
+                }
+                if (done) {
+                    return decoder.flush();
+                }
+                const result = await iter.next();
+                if (result.done === true) {
+                    done = true;
+                    continue;
+                }
+                if (result.value === undefined) {
+                    continue;
+                }
+                decoder.push(utf8.decode(result.value, { stream: true }));
+            }
+        },
+        close() {
+            done = true;
+            iter.return?.();
+        },
+    };
+}
+function makeAsyncIterator(body) {
+    if (typeof body[Symbol.asyncIterator] === "function") {
+        const it = body[Symbol.asyncIterator]();
+        return it;
+    }
+    const reader = body.getReader();
+    return {
+        async next() {
+            return reader.read();
+        },
+    };
+}
+function composeSignal(externalSignal, timeoutMs) {
+    const controller = new AbortController();
+    const timer = timeoutMs !== undefined && timeoutMs > 0
+        ? setTimeout(() => controller.abort(), timeoutMs)
+        : undefined;
+    const externalListener = () => controller.abort();
+    if (externalSignal !== undefined) {
+        if (externalSignal.aborted) {
+            controller.abort();
+        }
+        else {
+            externalSignal.addEventListener("abort", externalListener, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        cleanup() {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            if (externalSignal !== undefined) {
+                externalSignal.removeEventListener("abort", externalListener);
+            }
+        },
+    };
+}
+function defaultFetch() {
+    const f = globalThis.fetch;
+    if (f === undefined) {
+        throw new Error("h2: globalThis.fetch is undefined. Pass a fetchImpl option, or run on Node 22+ / a browser.");
+    }
+    return f;
+}
+//# sourceMappingURL=h2.js.map

package/dist/transport/h2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h2.js","sourceRoot":"","sources":["../../src/transport/h2.ts"],"names":[],"mappings":"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"}

package/dist/transport/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Transport layer: SEMP runs over WebSocket, HTTP/2, and QUIC per
+ * `TRANSPORT.md` §4. Higher layers (handshake driver, session
+ * machine) consume the abstract `Transport` interface and are
+ * agnostic to the underlying socket.
+ *
+ * v0.x ships WebSocket and HTTP/2. QUIC comes in a later release.
+ *
+ * @module
+ */
+export { type DialOptions, type Transport } from "./transport.js";
+export { type WSDialOptions, SempSubprotocol, dial as dialWS } from "./ws.js";
+export { newPair as newMemoryPair } from "./memory.js";
+export { type DialH2SessionOptions, type H2FetchLike, type H2PostOptions, type H2PostResult, type H2Response, SSEDecoder, SempSessionIdHeader, decodeSSE, dialH2Session, encodeSSE, h2Post, } from "./h2.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,KAAK,aAAa,EAAE,eAAe,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,SAAS,EACT,MAAM,GACP,MAAM,SAAS,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,15 @@
+/**
+ * Transport layer: SEMP runs over WebSocket, HTTP/2, and QUIC per
+ * `TRANSPORT.md` §4. Higher layers (handshake driver, session
+ * machine) consume the abstract `Transport` interface and are
+ * agnostic to the underlying socket.
+ *
+ * v0.x ships WebSocket and HTTP/2. QUIC comes in a later release.
+ *
+ * @module
+ */
+export {} from "./transport.js";
+export { SempSubprotocol, dial as dialWS } from "./ws.js";
+export { newPair as newMemoryPair } from "./memory.js";
+export { SSEDecoder, SempSessionIdHeader, decodeSSE, dialH2Session, encodeSSE, h2Post, } from "./h2.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAoC,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAsB,eAAe,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAML,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,SAAS,EACT,MAAM,GACP,MAAM,SAAS,CAAC"}

package/dist/transport/memory.d.ts

@@ -0,0 +1,21 @@
+/**
+ * In-process loopback transport. Two ends share a pair of FIFO
+ * queues; whatever one peer sends, the other receives. Used by
+ * tests that exercise the handshake driver, session machine, and
+ * client/server orchestration without standing up a real
+ * WebSocket / HTTP/2 server.
+ *
+ * NOT a transport for production traffic. The two peers run in
+ * the same process and share memory; there is no encryption,
+ * no flow control, no message-size enforcement.
+ *
+ * @module
+ */
+import type { Transport } from "./transport.js";
+/**
+ * Construct a connected pair of in-process transports. The two
+ * returned ends communicate symmetrically: bytes sent on one are
+ * receivable on the other.
+ */
+export declare function newPair(): [Transport, Transport];
+//# sourceMappingURL=memory.d.ts.map

package/dist/transport/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/transport/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAoGhD;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAMhD"}

package/dist/transport/memory.js

@@ -0,0 +1,112 @@
+/**
+ * In-process loopback transport. Two ends share a pair of FIFO
+ * queues; whatever one peer sends, the other receives. Used by
+ * tests that exercise the handshake driver, session machine, and
+ * client/server orchestration without standing up a real
+ * WebSocket / HTTP/2 server.
+ *
+ * NOT a transport for production traffic. The two peers run in
+ * the same process and share memory; there is no encryption,
+ * no flow control, no message-size enforcement.
+ *
+ * @module
+ */
+class Endpoint {
+    outbox;
+    inbox;
+    closed = false;
+    constructor(outbox, inbox) {
+        this.outbox = outbox;
+        this.inbox = inbox;
+    }
+    send(message) {
+        if (this.closed) {
+            return Promise.reject(new Error("memory transport: send after close"));
+        }
+        this.outbox.push(message);
+        return Promise.resolve();
+    }
+    receive() {
+        return this.inbox.shift();
+    }
+    close() {
+        if (this.closed) {
+            return Promise.resolve();
+        }
+        this.closed = true;
+        // Closing one end does NOT immediately drain the other side's
+        // outbox — buffered messages from the closed peer are still
+        // delivered before the inbox returns null.
+        this.outbox.closeWriter();
+        this.inbox.closeReader();
+        return Promise.resolve();
+    }
+}
+/**
+ * One-element-at-a-time async queue with closeable writer +
+ * closeable reader. Once the writer closes, queued items still
+ * drain to readers, then `shift` returns null. Once the reader
+ * closes, `shift` rejects on subsequent calls.
+ */
+class Queue {
+    items = [];
+    waiters = [];
+    writerClosed = false;
+    readerClosed = false;
+    push(v) {
+        if (this.writerClosed) {
+            throw new Error("memory transport: push after writer close");
+        }
+        const next = this.waiters.shift();
+        if (next !== undefined) {
+            next.resolve(v);
+        }
+        else {
+            this.items.push(v);
+        }
+    }
+    shift() {
+        if (this.readerClosed) {
+            return Promise.reject(new Error("memory transport: receive after reader close"));
+        }
+        const buffered = this.items.shift();
+        if (buffered !== undefined) {
+            return Promise.resolve(buffered);
+        }
+        if (this.writerClosed) {
+            return Promise.resolve(null);
+        }
+        return new Promise((resolve, reject) => {
+            this.waiters.push({ resolve, reject });
+        });
+    }
+    closeWriter() {
+        this.writerClosed = true;
+        if (this.items.length === 0) {
+            const drained = this.waiters.splice(0);
+            for (const w of drained) {
+                w.resolve(null);
+            }
+        }
+    }
+    closeReader() {
+        this.readerClosed = true;
+        const drained = this.waiters.splice(0);
+        for (const w of drained) {
+            w.reject(new Error("memory transport: receiver closed"));
+        }
+    }
+}
+/**
+ * Construct a connected pair of in-process transports. The two
+ * returned ends communicate symmetrically: bytes sent on one are
+ * receivable on the other.
+ */
+export function newPair() {
+    const aToB = new Queue();
+    const bToA = new Queue();
+    const a = new Endpoint(aToB, bToA);
+    const b = new Endpoint(bToA, aToB);
+    return [a, b];
+}
+//# sourceMappingURL=memory.js.map

package/dist/transport/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/transport/memory.ts"],"names":[],"mappings":"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"}

package/dist/transport/transport.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Transport abstraction per `TRANSPORT.md` §2.
+ *
+ * SEMP messages are exchanged as opaque byte slices over a stream
+ * the higher layers treat as bidirectional, ordered, and
+ * framed. The handshake driver, session machine, and inbox
+ * client all consume this same interface; the choice of
+ * underlying transport (WebSocket, HTTP/2, QUIC) is swapped at
+ * the boundary.
+ *
+ * Each `send` writes one SEMP message per spec §4.1.2 (no
+ * splitting across frames). Each `receive` returns one complete
+ * SEMP message (the underlying transport reassembles fragmented
+ * frames before yielding). When the remote side closes,
+ * `receive` returns `null`; subsequent calls also return `null`.
+ *
+ * @module
+ */
+/**
+ * One direction of a connected SEMP transport. Implementations
+ * MUST guarantee message boundary preservation: one `send` on
+ * one peer corresponds to exactly one `receive` on the other,
+ * with the same byte sequence.
+ */
+export interface Transport {
+    /** Send one SEMP message. Resolves once the bytes are committed to the underlying transport. */
+    send(message: Uint8Array): Promise<void>;
+    /**
+     * Receive the next SEMP message. Resolves with the message bytes
+     * on success; with `null` when the remote side has cleanly closed
+     * AND no buffered messages remain.
+     *
+     * Rejects if the underlying transport surfaces an error (network
+     * failure, framing violation, subprotocol mismatch). The caller
+     * SHOULD treat any rejection as terminal for the connection.
+     */
+    receive(): Promise<Uint8Array | null>;
+    /** Close the underlying connection. Idempotent. */
+    close(code?: number, reason?: string): Promise<void>;
+}
+/** Optional context passed through to dialers. */
+export interface DialOptions {
+    /**
+     * Abort signal observed by dialers. When fired before connect
+     * completes, the returned promise rejects with the abort reason.
+     */
+    signal?: AbortSignal;
+    /**
+     * Timeout in milliseconds for the connect handshake. Default: 30s.
+     * Ignored if `signal` is also supplied.
+     */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,gGAAgG;IAChG,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;;;;OAQG;IACH,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEtC,mDAAmD;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/transport/transport.js

@@ -0,0 +1,20 @@
+/**
+ * Transport abstraction per `TRANSPORT.md` §2.
+ *
+ * SEMP messages are exchanged as opaque byte slices over a stream
+ * the higher layers treat as bidirectional, ordered, and
+ * framed. The handshake driver, session machine, and inbox
+ * client all consume this same interface; the choice of
+ * underlying transport (WebSocket, HTTP/2, QUIC) is swapped at
+ * the boundary.
+ *
+ * Each `send` writes one SEMP message per spec §4.1.2 (no
+ * splitting across frames). Each `receive` returns one complete
+ * SEMP message (the underlying transport reassembles fragmented
+ * frames before yielding). When the remote side closes,
+ * `receive` returns `null`; subsequent calls also return `null`.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=transport.js.map