transport-io 0.0.1

package/dist/hub.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { type Adapter, type BroadcastOptions, type Frame as AdapterFrame, MemoryAdapter, type MemoryBus, memoryBus, type PeerId, type RemoteEnvelope, } from './adapter.ts';
+export { Client, type ClientOptions, type ClientState, type Status } from './client.ts';
+export { type AnyMap, type CallableOf, type Contract, defineContract, type EventDef, type EventShape, type Infer, type Lane, type MapOf, type Schema, type$, } from './contract.ts';
+export { maxDatagramPayload } from './datagram.ts';
+export { TransportError, type TransportErrorCode } from './errors.ts';
+export { encodeFrame, type Frame, FrameDecoder, maxPayloadFor } from './framer.ts';
+export { CloseCode, Codec, DATAGRAM_CONSERVATIVE_PAYLOAD_MAX, DATAGRAM_HEADER_BYTES, EVENT_ID_NOT_APPLICABLE, FrameType, MAX_CALL_PAYLOAD_BYTES, MAX_EMIT_PAYLOAD_BYTES, PROTOCOL_VERSION, ResetCode, STREAM_FRAME_OVERHEAD_BYTES, } from './protocol.ts';
+export { createServer, type RoomTarget, Server, type ServerOptions, type ServerPeer, } from './server.ts';
+export type { SessionStats } from './session.ts';
+/**
+ * Hand-maintained and asserted against `package.json` by `index.test.ts`, because
+ * `isolatedDeclarations` forbids inferring it from an import and a version that drifts from
+ * its manifest is a lie in the one place a user checks first.
+ *
+ * `changeset version` moves the manifest, so this moves in the same commit — which the test
+ * enforces rather than trusting anyone to remember.
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,KAAK,IAAI,YAAY,EAC1B,aAAa,EACb,KAAK,SAAS,EACd,SAAS,EACT,KAAK,MAAM,EAKX,KAAK,cAAc,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,EACL,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,MAAM,EACX,KAAK,GACN,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EACL,SAAS,EACT,KAAK,EACL,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,SAAS,EACT,2BAA2B,GAC5B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EACf,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export { MemoryAdapter, memoryBus, } from './adapter.js';
+export { Client } from './client.js';
+export { defineContract, type$, } from './contract.js';
+export { maxDatagramPayload } from './datagram.js';
+export { TransportError } from './errors.js';
+export { encodeFrame, FrameDecoder, maxPayloadFor } from './framer.js';
+export { CloseCode, Codec, DATAGRAM_CONSERVATIVE_PAYLOAD_MAX, DATAGRAM_HEADER_BYTES, EVENT_ID_NOT_APPLICABLE, FrameType, MAX_CALL_PAYLOAD_BYTES, MAX_EMIT_PAYLOAD_BYTES, PROTOCOL_VERSION, ResetCode, STREAM_FRAME_OVERHEAD_BYTES, } from './protocol.js';
+export { createServer, Server, } from './server.js';
+/**
+ * Hand-maintained and asserted against `package.json` by `index.test.ts`, because
+ * `isolatedDeclarations` forbids inferring it from an import and a version that drifts from
+ * its manifest is a lie in the one place a user checks first.
+ *
+ * `changeset version` moves the manifest, so this moves in the same commit — which the test
+ * enforces rather than trusting anyone to remember.
+ */
+export const VERSION = '0.0.1';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EAEb,SAAS,GAOV,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,MAAM,EAAqD,MAAM,aAAa,CAAA;AACvF,OAAO,EAIL,cAAc,EAOd,KAAK,GACN,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,WAAW,EAAc,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EACL,SAAS,EACT,KAAK,EACL,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,SAAS,EACT,2BAA2B,GAC5B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,YAAY,EAEZ,MAAM,GAGP,MAAM,aAAa,CAAA;AAGpB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAA"}

package/dist/origin.d.ts

@@ -0,0 +1,18 @@
+export declare class OriginAllocator {
+    #private;
+    /**
+     * `counterSpace` exists so the exhaustion branch can be reached in a test. Exhausting the
+     * real space means 4,194,304 allocations, which is why §7.3's "MUST refuse new sessions"
+     * went unproven — and an unreachable branch in an allocator is exactly the kind of code
+     * that is wrong the first time it runs. Production never passes it.
+     */
+    constructor(hostOrdinal?: number, quarantineMs?: number, counterSpace?: number);
+    allocate(now: number): number;
+    /** Held well beyond any window in which a stale datagram or sequence entry can survive. */
+    free(value: number, now: number): void;
+    stats(now: number): {
+        live: number;
+        quarantined: number;
+    };
+}
+//# sourceMappingURL=origin.d.ts.map

package/dist/origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../src/origin.ts"],"names":[],"mappings":"AAiBA,qBAAa,eAAe;;IAS1B;;;;;OAKG;IACH,YACE,WAAW,SAAI,EACf,YAAY,GAAE,MAA6B,EAC3C,YAAY,GAAE,MAAsB,EAYrC;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkB5B;IAED,2FAA2F;IAC3F,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAGrC;IAWD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAGxD;CACF"}

package/dist/origin.js

@@ -0,0 +1,72 @@
+/**
+ * Origin allocation. PROTOCOL.md §7.3.
+ *
+ * Allocated, not derived: hashing a PeerId would carry a birthday problem into a place
+ * where a collision is close to undebuggable, since two peers would share a sequence space
+ * and each would silently discard the other's datagrams as stale.
+ *
+ * Quarantined, not retired: never reusing turns the counter into a clock — 2^22 values at
+ * 100 sessions per second exhausts in under twelve hours — so a busy host would stop
+ * accepting sessions and need a restart.
+ */
+import { TransportError } from './errors.js';
+import { MAX_SESSION_HOSTS, ORIGIN_QUARANTINE_MS } from './protocol.js';
+const COUNTER_BITS = 22;
+const COUNTER_SPACE = 1 << COUNTER_BITS;
+export class OriginAllocator {
+    #ordinal;
+    #quarantineMs;
+    #live = new Set();
+    #quarantined = [];
+    #next = 0;
+    #space;
+    /**
+     * `counterSpace` exists so the exhaustion branch can be reached in a test. Exhausting the
+     * real space means 4,194,304 allocations, which is why §7.3's "MUST refuse new sessions"
+     * went unproven — and an unreachable branch in an allocator is exactly the kind of code
+     * that is wrong the first time it runs. Production never passes it.
+     */
+    constructor(hostOrdinal = 0, quarantineMs = ORIGIN_QUARANTINE_MS, counterSpace = COUNTER_SPACE) {
+        if (!Number.isInteger(hostOrdinal) || hostOrdinal < 0 || hostOrdinal >= MAX_SESSION_HOSTS) {
+            throw new TransportError('WT_PROTOCOL_ERROR', `host ordinal ${hostOrdinal} is outside 0..${MAX_SESSION_HOSTS - 1}`, `This deployment supports at most ${MAX_SESSION_HOSTS} concurrent session hosts.`);
+        }
+        this.#ordinal = hostOrdinal;
+        this.#quarantineMs = quarantineMs;
+        this.#space = counterSpace;
+    }
+    allocate(now) {
+        this.#release(now);
+        for (let i = 0; i < this.#space; i++) {
+            const counter = (this.#next + i) % this.#space;
+            // 0 is reserved so a zero-filled buffer cannot parse as a real peer.
+            if (this.#ordinal === 0 && counter === 0)
+                continue;
+            const value = (this.#ordinal << COUNTER_BITS) | counter;
+            if (this.#live.has(value))
+                continue;
+            if (this.#quarantined.some((q) => q.value === value))
+                continue;
+            this.#next = (counter + 1) % this.#space;
+            this.#live.add(value);
+            return value;
+        }
+        throw new TransportError('WT_TOO_MANY_STREAMS', `this host has no free origin identifiers (${this.#space} live plus quarantined)`, 'This is a concurrency limit, not a clock. Add another session host, or reduce concurrent sessions.');
+    }
+    /** Held well beyond any window in which a stale datagram or sequence entry can survive. */
+    free(value, now) {
+        if (!this.#live.delete(value))
+            return;
+        this.#quarantined.push({ value, until: now + this.#quarantineMs });
+    }
+    #release(now) {
+        while (this.#quarantined.length > 0 &&
+            this.#quarantined[0].until <= now) {
+            this.#quarantined.shift();
+        }
+    }
+    stats(now) {
+        this.#release(now);
+        return { live: this.#live.size, quarantined: this.#quarantined.length };
+    }
+}
+//# sourceMappingURL=origin.js.map

package/dist/origin.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The single source of truth for every normative constant in PROTOCOL.md.
+ *
+ * `scripts/check-docs.ts` parses the tables out of PROTOCOL.md and asserts they match
+ * these values, so a document and an implementation cannot drift. Change one and the
+ * build fails until you change the other.
+ */
+/** PROTOCOL.md §4.2 — Stage 0 requires exact equality and refuses otherwise. */
+export declare const PROTOCOL_VERSION = 0;
+/** PROTOCOL.md §5.2 */
+export declare const FrameType: {
+    readonly HANDSHAKE: 1;
+    readonly EMIT: 2;
+    readonly CALL_REQUEST: 3;
+    readonly CALL_RESPONSE: 4;
+    readonly CALL_ERROR: 5;
+    readonly JOIN: 6;
+    readonly LEAVE: 7;
+};
+export type FrameType = (typeof FrameType)[keyof typeof FrameType];
+export declare function isFrameType(v: number): v is FrameType;
+/** PROTOCOL.md §5.3. `0x00` is permanently reserved so a zero-filled buffer cannot parse. */
+export declare const Codec: {
+    readonly JSON: 1;
+};
+export type Codec = (typeof Codec)[keyof typeof Codec];
+/** PROTOCOL.md §5.4 — used by frames whose meaning comes from the stream, not the table. */
+export declare const EVENT_ID_NOT_APPLICABLE = 0;
+/** PROTOCOL.md §5.1 — stream frame field budget. */
+export declare const LENGTH_PREFIX_BYTES = 4;
+export declare const STREAM_HEADER_BYTES = 8;
+export declare const STREAM_FRAME_OVERHEAD_BYTES: number;
+/** `Length` counts every byte AFTER itself: header plus payload. Never itself. */
+export declare const MIN_LENGTH: number;
+export declare const MAX_EMIT_PAYLOAD_BYTES = 1048576;
+export declare const MAX_CALL_PAYLOAD_BYTES = 16777216;
+/** PROTOCOL.md §7.2 — datagram field budget. */
+export declare const DATAGRAM_HEADER_BYTES = 13;
+/** PROTOCOL.md §7.4 — used only when the transport reports nothing usable. */
+export declare const DATAGRAM_CONSERVATIVE_FLOOR = 1024;
+export declare const DATAGRAM_CONSERVATIVE_PAYLOAD_MAX: number;
+/** PROTOCOL.md §9 — per-peer bounds. Numbers, not adjectives. */
+export declare const DATAGRAM_QUEUE_MAX = 64;
+export declare const EMIT_QUEUE_MAX = 256;
+/** PROTOCOL.md §10.1 code 9 — a rejected open resets that stream, never the session. */
+export declare const MAX_CONCURRENT_CALL_STREAMS = 256;
+/** Checked at dequeue, not enqueue: overflow handles a burst, TTL handles a stall. */
+export declare const DATAGRAM_TTL_MS = 150;
+/** PROTOCOL.md §7.3 — a receiver discards (origin, event) sequence state after this idle. */
+export declare const SEQUENCE_STATE_RETENTION_MS = 60000;
+/** PROTOCOL.md §7.3 — a released Origin waits this long before returning to the pool. */
+export declare const ORIGIN_QUARANTINE_MS = 120000;
+/** PROTOCOL.md §7.3 — a departed host's ordinal waits this long before reallocation. */
+export declare const HOST_ORDINAL_QUARANTINE_MS = 300000;
+/** PROTOCOL.md §7.3 — stated ceiling on concurrent session hosts. */
+export declare const MAX_SESSION_HOSTS = 1024;
+/** PROTOCOL.md §4.1 */
+export declare const HANDSHAKE_DEADLINE_MS = 5000;
+/** PROTOCOL.md §10.2 */
+export declare const CLOSE_REASON_MAX_BYTES = 1024;
+/** PROTOCOL.md §10.1 — one byte, because the browser API clamps stream codes to an octet. */
+export declare const ResetCode: {
+    readonly WT_NO_ERROR: 0;
+    readonly WT_ABORTED: 1;
+    readonly WT_TOO_MANY_STREAMS: 9;
+};
+export type ResetCode = (typeof ResetCode)[keyof typeof ResetCode];
+/** PROTOCOL.md §10.2 */
+export declare const CloseCode: {
+    readonly WT_NO_ERROR: 0;
+    readonly WT_PROTOCOL_VERSION_MISMATCH: 1000;
+    readonly WT_CONTRACT_MISMATCH: 1001;
+    readonly WT_HANDSHAKE_TIMEOUT: 1002;
+    readonly WT_PEER_TOO_SLOW: 1003;
+    readonly WT_PROTOCOL_ERROR: 1004;
+    readonly WT_RELIABILITY_REFUSED: 1006;
+};
+export type CloseCode = (typeof CloseCode)[keyof typeof CloseCode];
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,uBAAuB;AACvB,eAAO,MAAM,SAAS;aACpB,SAAS,EAAE,CAAI;aACf,IAAI,EAAE,CAAI;aACV,YAAY,EAAE,CAAI;aAClB,aAAa,EAAE,CAAI;aACnB,UAAU,EAAE,CAAI;aAChB,IAAI,EAAE,CAAI;aACV,KAAK,EAAE,CAAI;CACH,CAAA;AACV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAGlE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,SAAS,CAErD;AAED,6FAA6F;AAC7F,eAAO,MAAM,KAAK;aAAK,IAAI,EAAE,CAAI;CAAW,CAAA;AAC5C,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAA;AAEtD,4FAA4F;AAC5F,eAAO,MAAM,uBAAuB,IAAa,CAAA;AAEjD,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,2BAA2B,EAAE,MAAkD,CAAA;AAE5F,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,MAAgC,CAAA;AACzD,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAC/C,eAAO,MAAM,sBAAsB,WAAa,CAAA;AAEhD,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,OAAO,CAAA;AAC/C,eAAO,MAAM,iCAAiC,EAAE,MACK,CAAA;AAErD,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,KAAK,CAAA;AACpC,eAAO,MAAM,cAAc,MAAM,CAAA;AACjC,wFAAwF;AACxF,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAC9C,sFAAsF;AACtF,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,QAAS,CAAA;AACjD,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,SAAU,CAAA;AAC3C,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,SAAU,CAAA;AACjD,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC,uBAAuB;AACvB,eAAO,MAAM,qBAAqB,OAAO,CAAA;AACzC,wBAAwB;AACxB,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,6FAA6F;AAC7F,eAAO,MAAM,SAAS;aACpB,WAAW,EAAE,CAAC;aACd,UAAU,EAAE,CAAC;aACb,mBAAmB,EAAE,CAAC;CACd,CAAA;AACV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAElE,wBAAwB;AACxB,eAAO,MAAM,SAAS;aACpB,WAAW,EAAE,CAAC;aACd,4BAA4B,EAAE,IAAI;aAClC,oBAAoB,EAAE,IAAI;aAC1B,oBAAoB,EAAE,IAAI;aAC1B,gBAAgB,EAAE,IAAI;aACtB,iBAAiB,EAAE,IAAI;aACvB,sBAAsB,EAAE,IAAI;CACpB,CAAA;AACV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/protocol.js

@@ -0,0 +1,76 @@
+/**
+ * The single source of truth for every normative constant in PROTOCOL.md.
+ *
+ * `scripts/check-docs.ts` parses the tables out of PROTOCOL.md and asserts they match
+ * these values, so a document and an implementation cannot drift. Change one and the
+ * build fails until you change the other.
+ */
+/** PROTOCOL.md §4.2 — Stage 0 requires exact equality and refuses otherwise. */
+export const PROTOCOL_VERSION = 0;
+/** PROTOCOL.md §5.2 */
+export const FrameType = {
+    HANDSHAKE: 0x01,
+    EMIT: 0x02,
+    CALL_REQUEST: 0x03,
+    CALL_RESPONSE: 0x04,
+    CALL_ERROR: 0x05,
+    JOIN: 0x06,
+    LEAVE: 0x07,
+};
+const FRAME_TYPES = new Set(Object.values(FrameType));
+export function isFrameType(v) {
+    return FRAME_TYPES.has(v);
+}
+/** PROTOCOL.md §5.3. `0x00` is permanently reserved so a zero-filled buffer cannot parse. */
+export const Codec = { JSON: 0x01 };
+/** PROTOCOL.md §5.4 — used by frames whose meaning comes from the stream, not the table. */
+export const EVENT_ID_NOT_APPLICABLE = 0x00000000;
+/** PROTOCOL.md §5.1 — stream frame field budget. */
+export const LENGTH_PREFIX_BYTES = 4;
+export const STREAM_HEADER_BYTES = 8;
+export const STREAM_FRAME_OVERHEAD_BYTES = LENGTH_PREFIX_BYTES + STREAM_HEADER_BYTES;
+/** `Length` counts every byte AFTER itself: header plus payload. Never itself. */
+export const MIN_LENGTH = STREAM_HEADER_BYTES + 1;
+export const MAX_EMIT_PAYLOAD_BYTES = 1_048_576;
+export const MAX_CALL_PAYLOAD_BYTES = 16_777_216;
+/** PROTOCOL.md §7.2 — datagram field budget. */
+export const DATAGRAM_HEADER_BYTES = 13;
+/** PROTOCOL.md §7.4 — used only when the transport reports nothing usable. */
+export const DATAGRAM_CONSERVATIVE_FLOOR = 1024;
+export const DATAGRAM_CONSERVATIVE_PAYLOAD_MAX = DATAGRAM_CONSERVATIVE_FLOOR - DATAGRAM_HEADER_BYTES;
+/** PROTOCOL.md §9 — per-peer bounds. Numbers, not adjectives. */
+export const DATAGRAM_QUEUE_MAX = 64;
+export const EMIT_QUEUE_MAX = 256;
+/** PROTOCOL.md §10.1 code 9 — a rejected open resets that stream, never the session. */
+export const MAX_CONCURRENT_CALL_STREAMS = 256;
+/** Checked at dequeue, not enqueue: overflow handles a burst, TTL handles a stall. */
+export const DATAGRAM_TTL_MS = 150;
+/** PROTOCOL.md §7.3 — a receiver discards (origin, event) sequence state after this idle. */
+export const SEQUENCE_STATE_RETENTION_MS = 60_000;
+/** PROTOCOL.md §7.3 — a released Origin waits this long before returning to the pool. */
+export const ORIGIN_QUARANTINE_MS = 120_000;
+/** PROTOCOL.md §7.3 — a departed host's ordinal waits this long before reallocation. */
+export const HOST_ORDINAL_QUARANTINE_MS = 300_000;
+/** PROTOCOL.md §7.3 — stated ceiling on concurrent session hosts. */
+export const MAX_SESSION_HOSTS = 1024;
+/** PROTOCOL.md §4.1 */
+export const HANDSHAKE_DEADLINE_MS = 5000;
+/** PROTOCOL.md §10.2 */
+export const CLOSE_REASON_MAX_BYTES = 1024;
+/** PROTOCOL.md §10.1 — one byte, because the browser API clamps stream codes to an octet. */
+export const ResetCode = {
+    WT_NO_ERROR: 0,
+    WT_ABORTED: 1,
+    WT_TOO_MANY_STREAMS: 9,
+};
+/** PROTOCOL.md §10.2 */
+export const CloseCode = {
+    WT_NO_ERROR: 0,
+    WT_PROTOCOL_VERSION_MISMATCH: 1000,
+    WT_CONTRACT_MISMATCH: 1001,
+    WT_HANDSHAKE_TIMEOUT: 1002,
+    WT_PEER_TOO_SLOW: 1003,
+    WT_PROTOCOL_ERROR: 1004,
+    WT_RELIABILITY_REFUSED: 1006,
+};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAEjC,uBAAuB;AACvB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,IAAI;IACV,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;CACH,CAAA;AAGV,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;AAC1E,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAC3B,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,EAAW,CAAA;AAG5C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAA;AAEjD,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA;AACpC,MAAM,CAAC,MAAM,2BAA2B,GAAW,mBAAmB,GAAG,mBAAmB,CAAA;AAE5F,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAW,mBAAmB,GAAG,CAAC,CAAA;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAA;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAA;AAEhD,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AACvC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAA;AAC/C,MAAM,CAAC,MAAM,iCAAiC,GAC5C,2BAA2B,GAAG,qBAAqB,CAAA;AAErD,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;AACjC,wFAAwF;AACxF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAA;AAC9C,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAElC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAA;AACjD,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAC3C,wFAAwF;AACxF,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAA;AACjD,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAErC,uBAAuB;AACvB,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AACzC,wBAAwB;AACxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAE1C,6FAA6F;AAC7F,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,mBAAmB,EAAE,CAAC;CACd,CAAA;AAGV,wBAAwB;AACxB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,CAAC;IACd,4BAA4B,EAAE,IAAI;IAClC,oBAAoB,EAAE,IAAI;IAC1B,oBAAoB,EAAE,IAAI;IAC1B,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,sBAAsB,EAAE,IAAI;CACpB,CAAA"}

package/dist/queue.d.ts

@@ -0,0 +1,45 @@
+export interface QueueStats {
+    readonly queueDepth: number;
+    readonly overflowDropped: number;
+    readonly staleDropped: number;
+}
+/**
+ * Datagram lane: bounded ring, drop OLDEST on overflow, TTL checked at DEQUEUE.
+ *
+ * The two axes are different problems. Drop-oldest handles a burst. It does nothing for a
+ * peer that stalls two seconds and resumes — the ring never overflows, so a backlog of
+ * stale positions is delivered and the application renders history, which is worse than
+ * delivering nothing. TTL at dequeue is what fixes that, and the two causes are counted
+ * separately so an operator can tell a slow consumer from a slow network.
+ */
+export declare class DatagramQueue<T> {
+    #private;
+    constructor(max?: number, ttlMs?: number);
+    /** Never throws and never blocks: dropping is this lane's advertised contract. */
+    push(item: T, now: number): void;
+    /** Drains what is still fresh. Anything past its TTL is discarded here, not on entry. */
+    drain(now: number): T[];
+    stats(): QueueStats;
+}
+export declare class PeerTooSlowError extends Error {
+    constructor(depth: number);
+}
+/**
+ * Emit lane: bounded, and NEVER drops. A lane that advertises reliable ordered delivery
+ * and then discards silently is the lie this project exists to avoid, so a peer that falls
+ * this far behind is disconnected instead.
+ */
+export declare class EmitQueue<T> {
+    #private;
+    constructor(max?: number);
+    push(item: T): void;
+    /**
+     * The head, left in place. An item leaves this queue only when its write has actually
+     * completed — `shift()` on hand-off would make depth a measure of nothing, which is
+     * precisely how the bound came to be unreachable.
+     */
+    peek(): T | undefined;
+    shift(): T | undefined;
+    get depth(): number;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAOD;;;;;;;;GAQG;AACH,qBAAa,aAAa,CAAC,CAAC;;IAO1B,YAAY,GAAG,GAAE,MAA2B,EAAE,KAAK,GAAE,MAAwB,EAG5E;IAED,kFAAkF;IAClF,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAM/B;IAED,yFAAyF;IACzF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,CAQtB;IAED,KAAK,IAAI,UAAU,CAMlB;CACF;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,KAAK,EAAE,MAAM,EAGxB;CACF;AAED;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC;;IAItB,YAAY,GAAG,GAAE,MAAuB,EAEvC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAGlB;IAED;;;;OAIG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS,CAEpB;IAED,KAAK,IAAI,CAAC,GAAG,SAAS,CAErB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/queue.js

@@ -0,0 +1,94 @@
+/**
+ * Backpressure. PROTOCOL.md §9 — three lanes, three answers, because they make different
+ * promises.
+ *
+ * The transport swallows its own "blocked" indication along with "too big", so a refused
+ * write reports success. We therefore do not attempt to infer network congestion: we bound
+ * our own queue and report our own drops, labelled as ours.
+ */
+import { DATAGRAM_QUEUE_MAX, DATAGRAM_TTL_MS, EMIT_QUEUE_MAX } from './protocol.js';
+/**
+ * Datagram lane: bounded ring, drop OLDEST on overflow, TTL checked at DEQUEUE.
+ *
+ * The two axes are different problems. Drop-oldest handles a burst. It does nothing for a
+ * peer that stalls two seconds and resumes — the ring never overflows, so a backlog of
+ * stale positions is delivered and the application renders history, which is worse than
+ * delivering nothing. TTL at dequeue is what fixes that, and the two causes are counted
+ * separately so an operator can tell a slow consumer from a slow network.
+ */
+export class DatagramQueue {
+    #items = [];
+    #max;
+    #ttlMs;
+    #overflowDropped = 0;
+    #staleDropped = 0;
+    constructor(max = DATAGRAM_QUEUE_MAX, ttlMs = DATAGRAM_TTL_MS) {
+        this.#max = max;
+        this.#ttlMs = ttlMs;
+    }
+    /** Never throws and never blocks: dropping is this lane's advertised contract. */
+    push(item, now) {
+        if (this.#items.length >= this.#max) {
+            this.#items.shift();
+            this.#overflowDropped++;
+        }
+        this.#items.push({ item, at: now });
+    }
+    /** Drains what is still fresh. Anything past its TTL is discarded here, not on entry. */
+    drain(now) {
+        const out = [];
+        for (const q of this.#items) {
+            if (now - q.at >= this.#ttlMs)
+                this.#staleDropped++;
+            else
+                out.push(q.item);
+        }
+        this.#items.length = 0;
+        return out;
+    }
+    stats() {
+        return {
+            queueDepth: this.#items.length,
+            overflowDropped: this.#overflowDropped,
+            staleDropped: this.#staleDropped,
+        };
+    }
+}
+export class PeerTooSlowError extends Error {
+    constructor(depth) {
+        super(`emit queue reached ${depth} frames`);
+        this.name = 'PeerTooSlowError';
+    }
+}
+/**
+ * Emit lane: bounded, and NEVER drops. A lane that advertises reliable ordered delivery
+ * and then discards silently is the lie this project exists to avoid, so a peer that falls
+ * this far behind is disconnected instead.
+ */
+export class EmitQueue {
+    #items = [];
+    #max;
+    constructor(max = EMIT_QUEUE_MAX) {
+        this.#max = max;
+    }
+    push(item) {
+        if (this.#items.length >= this.#max)
+            throw new PeerTooSlowError(this.#items.length);
+        this.#items.push(item);
+    }
+    /**
+     * The head, left in place. An item leaves this queue only when its write has actually
+     * completed — `shift()` on hand-off would make depth a measure of nothing, which is
+     * precisely how the bound came to be unreachable.
+     */
+    peek() {
+        return this.#items[0];
+    }
+    shift() {
+        return this.#items.shift();
+    }
+    get depth() {
+        return this.#items.length;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAanF;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IACf,MAAM,GAAgB,EAAE,CAAA;IACxB,IAAI,CAAQ;IACZ,MAAM,CAAQ;IACvB,gBAAgB,GAAG,CAAC,CAAA;IACpB,aAAa,GAAG,CAAC,CAAA;IAEjB,YAAY,GAAG,GAAW,kBAAkB,EAAE,KAAK,GAAW,eAAe;QAC3E,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;QACf,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,kFAAkF;IAClF,IAAI,CAAC,IAAO,EAAE,GAAW;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;YACnB,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACzB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,GAAW;QACf,MAAM,GAAG,GAAQ,EAAE,CAAA;QACnB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,aAAa,EAAE,CAAA;;gBAC9C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;QACtB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,KAAK;QACH,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC9B,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,YAAY,EAAE,IAAI,CAAC,aAAa;SACjC,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,KAAa;QACvB,KAAK,CAAC,sBAAsB,KAAK,SAAS,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACX,MAAM,GAAQ,EAAE,CAAA;IAChB,IAAI,CAAQ;IAErB,YAAY,GAAG,GAAW,cAAc;QACtC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAED,IAAI,CAAC,IAAO;QACV,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACnF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACvB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IAC5B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;CACF"}

package/dist/server.d.ts

@@ -0,0 +1,45 @@
+/** Server surface. Transport-agnostic: it accepts a Connection from the seam. */
+import { type Adapter, type PeerId } from './adapter.ts';
+import { type AnyMap, type CallableOf, type Contract } from './contract.ts';
+import { type SessionStats } from './session.ts';
+import type { Connection } from './transport/types.ts';
+export interface ServerPeer<M extends AnyMap = AnyMap> {
+    readonly id: PeerId;
+    readonly origin: number;
+    readonly rooms: readonly string[];
+    join(room: string): Promise<void>;
+    leave(room: string): Promise<void>;
+    on<K extends keyof M & string>(event: K, handler: (payload: M[K]['payload']) => void): () => void;
+    emit<K extends keyof M & string>(event: K, payload: M[K]['payload']): void;
+    stats(): SessionStats;
+    close(code?: number, reason?: string): void;
+}
+export interface CallContext {
+    /** Fires when the initiator resets the stream. Immediate, and free on this transport. */
+    readonly signal: AbortSignal;
+}
+export interface ServerOptions {
+    readonly contract: Contract;
+    readonly adapter?: Adapter;
+    readonly nodeId?: string;
+    readonly hostOrdinal?: number;
+    readonly validateInbound?: boolean;
+}
+export interface RoomTarget<M extends AnyMap = AnyMap> {
+    emit<K extends keyof M & string>(event: K, payload: M[K]['payload']): Promise<void>;
+    except(...peers: PeerId[]): RoomTarget<M>;
+}
+export declare class Server<M extends AnyMap = AnyMap> {
+    #private;
+    constructor(opts: ServerOptions);
+    /** Builds the event table once. Async because event ids are a SHA-256 of the name. */
+    listen(): Promise<void>;
+    /** Register a responder for a callable event. */
+    handle<K extends CallableOf<M> & string>(event: K, handler: (payload: M[K]['payload'], ctx: CallContext) => Promise<M[K]['returns']>): () => void;
+    onSession(cb: (peer: ServerPeer<M>) => void): () => void;
+    memberCount(room: string): number;
+    accept(conn: Connection): Promise<ServerPeer<M>>;
+    to(room: string): RoomTarget<M>;
+}
+export declare function createServer<M extends AnyMap = AnyMap>(opts: ServerOptions): Server<M>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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