@norskvideo/moq-net 0.1.3 → 0.1.4

package/connection/reload.js

@@ -1,7 +1,16 @@
 /* @ts-self-types="./reload.d.ts" */
 import { Effect, Signal } from "@norskvideo/moq-signals";
+import * as Announce from "../announced.js";
+import { error } from "../error.js";
 import { empty as emptyPath } from "../path.js";
 import { connect } from "./connect.js";
+/**
+ * How long to keep retrying before giving up, when {@link ReloadDelay.timeout} is unset.
+ *
+ * Short on purpose: a failure that clears within it was transient, and one that doesn't should
+ * surface as an error rather than leave the page silently reconnecting for minutes.
+ */
+const DEFAULT_TIMEOUT = 10000;
 /** Maintains a MoQ connection, reconnecting with exponential backoff when it drops. */
 export class Reload {
     /** Relay URL to connect to; updating it triggers a reconnect. */
@@ -12,130 +21,247 @@ export class Reload {
     status = new Signal("disconnected");
     /** The currently established session, or undefined while disconnected. */
     established = new Signal(undefined);
-    // All actively announced broadcast paths, updated reactively.
-    #announced = new Signal(new Set());
-    /** The set of broadcast paths currently announced by the server, updated reactively. */
-    announced = this.#announced;
+    /**
+     * The current connection's PROBE estimates, spanning reconnects.
+     *
+     * Undefined while disconnected: the estimates belong to a single connection.
+     * See {@link Established.probe}.
+     */
+    probe;
     /** WebTransport options applied to each connection attempt (not reactive). */
     webtransport;
     /** WebSocket fallback options applied to each connection attempt (not reactive). */
     websocket;
+    /**
+     * Whether the relay supports broadcast discovery, applied to each connection attempt (not
+     * reactive). Undefined defers to the default for the URL. See {@link Established.discovery}.
+     */
+    discovery;
     /** Backoff settings for the reconnect loop. */
     delay;
     /** The reactive effect scope driving the connect loop; closed by {@link Reload.close}. */
-    signals = new Effect();
-    /** Resolves when the reconnect loop stops via {@link Reload.close} or the retry timeout. */
+    #signals = new Effect();
+    /**
+     * Resolves when the reconnect loop stops via {@link Reload.close}.
+     *
+     * Rejects when the loop gives up instead, carrying the failure that was in flight when the
+     * retry window expired.
+     */
     closed;
     #closedResolve;
     #closedReject;
+    // The current wait between attempts, doubling per failure, and when the retry window expires.
+    // Both are undefined between sequences, so a later edit to `delay` applies to the next one.
     #delay;
-    // Timestamp when the current retry sequence started (for timeout).
-    #retryStart;
+    #deadline;
     // Increased by 1 each time to trigger a reload.
     #tick = new Signal(0);
+    // True after the browser freezes or hides the page until it visibly resumes.
+    #suspended = new Signal(false);
     // Use the serialized URL as the reactive connection key. URL objects use identity
     // equality, but replacing one with an equivalent instance should not reconnect.
     #url;
     constructor(props) {
         this.url = Signal.from(props?.url);
         this.enabled = Signal.from(props?.enabled ?? false);
-        this.delay = props?.delay ?? { initial: 1000, multiplier: 2, max: 30000 };
+        this.delay = props?.delay ?? { initial: 1000, multiplier: 2, max: 5000 };
         this.webtransport = props?.webtransport;
         this.websocket = props?.websocket;
-        this.#delay = this.delay.initial;
+        this.discovery = props?.discovery;
         this.closed = new Promise((resolve, reject) => {
             this.#closedResolve = resolve;
             this.#closedReject = reject;
         });
-        this.#url = this.signals.computed((effect) => effect.get(this.url)?.href);
+        // A caller is free to never await `closed`, and giving up rejects it unprompted. Marking the
+        // rejection handled here keeps that from surfacing as an `unhandledrejection`; a consumer
+        // awaiting the same promise still receives it.
+        this.closed.catch(() => { });
+        if (typeof window !== "undefined" && typeof document !== "undefined") {
+            this.#signals.event(window, "pagehide", () => this.#suspended.set(true));
+            this.#signals.event(window, "pageshow", () => this.#suspended.set(false));
+            this.#signals.event(window, "unload", () => this.#suspended.set(true));
+            this.#signals.event(document, "visibilitychange", () => {
+                if (!document.hidden)
+                    this.#suspended.set(false);
+            });
+        }
+        this.probe = this.#signals.computed((effect) => {
+            const connection = effect.get(this.established);
+            return connection && effect.get(connection.probe);
+        });
+        this.#url = this.#signals.computed((effect) => effect.get(this.url)?.href);
         // Create a reactive root so cleanup is easier.
-        this.signals.run(this.#connect.bind(this));
-        this.signals.run(this.#runAnnounced.bind(this));
+        this.#signals.run(this.#connect.bind(this));
     }
     #connect(effect) {
         // Will retry when the tick changes.
         effect.get(this.#tick);
+        const suspended = effect.get(this.#suspended);
         const enabled = effect.get(this.enabled);
-        if (!enabled)
+        if (!enabled || suspended)
             return;
         const href = effect.get(this.#url);
         if (!href)
             return;
         const url = new URL(href);
         effect.set(this.status, "connecting", "disconnected");
+        // This run's teardown, handed to connect() so a rerun cancels the attempt in flight.
+        const signal = effect.abort;
         effect.spawn(async () => {
+            // Set once the session is live, so #retry can tell a healthy session that
+            // later dropped from a connect failure or a peer that flaps immediately.
+            let connected;
             try {
-                const pending = connect(url, { websocket: this.websocket, webtransport: this.webtransport });
-                const connection = await Promise.race([effect.cancel, pending]);
-                if (!connection) {
-                    pending.then((conn) => conn.close()).catch(() => { });
+                const connection = await connect(url, {
+                    websocket: this.websocket,
+                    webtransport: this.webtransport,
+                    discovery: this.discovery,
+                    signal,
+                });
+                // Hand the connection to the effect, which closes it now if this run is already over.
+                effect.cleanup(() => connection.close());
+                if (signal.aborted)
                     return;
-                }
                 effect.set(this.established, connection);
-                effect.cleanup(() => connection.close());
                 effect.set(this.status, "connected", "disconnected");
-                // Reset the exponential backoff and timeout on success.
-                this.#delay = this.delay.initial;
-                this.#retryStart = undefined;
-                await Promise.race([effect.cancel, connection.closed]);
+                connected = performance.now();
+                // A cancelled effect resolves undefined, so the sentinel tells the session
+                // closing apart from this run being torn down.
+                const closed = await Promise.race([effect.cancel, connection.closed.then(() => true)]);
+                if (!closed)
+                    return;
+                console.warn("connection closed, reconnecting");
+                this.#retry(effect, connected);
             }
             catch (err) {
+                // Treat teardown as cancellation, not a connection failure.
+                if (signal.aborted)
+                    return;
                 console.warn("connection error:", err);
-                // Track retry start for timeout.
-                this.#retryStart ??= performance.now();
-                const timeout = this.delay.timeout ?? 300000;
-                if (timeout > 0) {
-                    const elapsed = performance.now() - this.#retryStart;
-                    if (elapsed >= timeout) {
-                        console.warn("reconnect timed out");
-                        this.#closedReject(err instanceof Error ? err : new Error(String(err)));
-                        return;
-                    }
-                }
-                const tick = this.#tick.peek() + 1;
-                effect.timer(() => this.#tick.update((prev) => Math.max(prev, tick)), this.#delay);
-                this.#delay = Math.min(this.#delay * this.delay.multiplier, this.delay.max);
+                this.#retry(effect, connected, err);
             }
         });
     }
-    #runAnnounced(effect) {
-        this.#announced.set(new Set());
-        const conn = effect.get(this.established);
-        if (!conn)
-            return;
-        effect.cleanup(() => this.#announced.set(new Set()));
-        // Cloudflare's relay does not yet support SUBSCRIBE_NAMESPACE, so
-        // skip announce subscriptions entirely for those hosts.
-        if (conn.url.hostname.endsWith("mediaoverquic.com")) {
+    /**
+     * Schedule the next connect attempt after the current backoff, or stop once the retry window
+     * has expired. `connected` is when the dead session was established, if it ever was, and
+     * `cause` the error that killed it, if it died with one.
+     */
+    #retry(effect, connected, cause) {
+        // Any session is dead now: report disconnected during the backoff rather than
+        // when the retry reruns the effect.
+        this.established.set(undefined);
+        this.status.set("disconnected");
+        // A session that outlived the initial delay was healthy, so clear the backoff and
+        // start a fresh retry window: a one-off drop should reconnect promptly. Anything
+        // shorter is a peer that accepts and immediately severs, which has to keep
+        // escalating or we hammer it forever at the initial delay.
+        if (connected !== undefined && performance.now() - connected >= this.delay.initial) {
+            this.#delay = undefined;
+            this.#deadline = undefined;
+        }
+        const now = performance.now();
+        const timeout = this.delay.timeout ?? DEFAULT_TIMEOUT;
+        this.#delay ??= this.delay.initial;
+        this.#deadline ??= timeout > 0 ? now + timeout : Number.POSITIVE_INFINITY;
+        if (now >= this.#deadline) {
+            console.warn("reconnect timed out");
+            // A graceful close has no error, so report the timeout itself.
+            this.#closedReject(cause === undefined ? new Error("reconnect timed out") : error(cause));
             return;
         }
-        const announced = conn.announced(emptyPath());
-        effect.cleanup(() => announced.close());
-        effect.spawn(async () => {
-            try {
-                for (;;) {
-                    const entry = await Promise.race([effect.cancel, announced.next()]);
-                    if (!entry)
-                        break;
-                    this.#announced.mutate((active) => {
-                        if (entry.active) {
+        // Equal jitter, so a fleet of tabs knocked offline together doesn't reconnect on the same
+        // tick, and never past the deadline the retry window promised.
+        const wait = Math.min(this.#delay * (0.5 + Math.random() / 2), this.#deadline - now);
+        this.#delay = Math.min(this.#delay * this.delay.multiplier, this.delay.max);
+        const tick = this.#tick.peek() + 1;
+        effect.timer(() => this.#tick.update((prev) => Math.max(prev, tick)), wait);
+    }
+    /**
+     * Subscribe to broadcast announcements under an optional prefix, spanning reconnects.
+     *
+     * The same {@link Announce.Consumer} stream as {@link Established.announced}, but everything active
+     * is retracted (an `active: false` update) whenever the connection drops and re-announced on
+     * reconnect, so a consumer draining `next()` never clings to a dead route across a reconnect.
+     *
+     * Stays empty while the relay lacks {@link Established.discovery}.
+     */
+    announced(prefix = emptyPath()) {
+        const producer = new Announce.Producer(prefix);
+        const consumer = producer.consume();
+        // Closing the consumer closes the shared state, so stop appending after that.
+        let closed = false;
+        void consumer.closed.then(() => {
+            closed = true;
+        });
+        const pump = new Effect();
+        pump.run((effect) => {
+            const conn = effect.get(this.established);
+            if (!conn)
+                return;
+            // Without discovery the upstream announce stream never yields, so leave the
+            // consumer empty rather than opening a subscription that can't be answered.
+            if (!conn.discovery)
+                return;
+            const upstream = conn.announced(prefix);
+            effect.cleanup(() => upstream.close());
+            // Track what this connection announced so we can retract it if the connection drops.
+            const active = new Set();
+            effect.spawn(async () => {
+                try {
+                    for (;;) {
+                        const entry = await Promise.race([effect.cancel, upstream.next()]);
+                        if (!entry)
+                            break;
+                        if (entry.active)
                             active.add(entry.path);
-                        }
-                        else {
+                        else
                             active.delete(entry.path);
+                        producer.append(entry);
+                    }
+                }
+                catch {
+                    // A dropped connection resets the announce stream; the retractions below cover it.
+                }
+                finally {
+                    // Retract everything from the connection that just went away, so a per-broadcast
+                    // watcher tears down instead of clinging to the dead route.
+                    if (!closed) {
+                        for (const path of active) {
+                            producer.append({ path, active: false });
                         }
-                    });
+                    }
                 }
-            }
-            catch (err) {
-                this.#announced.set(new Set());
-                throw err;
-            }
+            });
         });
+        this.#signals.cleanup(() => pump.close());
+        void consumer.closed.then(() => pump.close());
+        return consumer;
+    }
+    /**
+     * A reactive handle to one broadcast, spanning reconnects.
+     *
+     * The same {@link Announce.Broadcast} as {@link Established.announcedBroadcast}, but it
+     * follows the reconnect loop: the broadcast drops to `undefined` when the connection dies
+     * and resolves again once the new connection announces the path. Use it instead of
+     * consuming off {@link Reload.established} whenever the broadcast may come online after you
+     * do, which is exactly the case a blind `consume` loses.
+     *
+     * Close the handle when done; {@link Reload.close} only drops it to `undefined`.
+     */
+    announcedBroadcast(path) {
+        return new Announce.Broadcast({ connection: this.established, path });
+    }
+    /**
+     * Snapshot the live connection's transport counters, or undefined while disconnected.
+     * See {@link Established.stats}.
+     */
+    async stats() {
+        return this.established.peek()?.stats();
     }
     /** Stop reconnecting, close the current connection, and resolve {@link Reload.closed}. */
     close() {
-        this.signals.close();
+        this.#signals.close();
         this.#closedResolve();
     }
 }

package/connection/reload.js.map

@@ -1 +1 @@
-{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../src/connection/reload.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect, type Getter, Signal } from \"@moq/signals\";\nimport type * as Path from \"../path.ts\";\nimport { empty as emptyPath } from \"../path.ts\";\nimport { type ConnectProps, connect, type WebSocketOptions, type WebTransportProps } from \"./connect.ts\";\nimport type { Established } from \"./established.ts\";\n\n/** Exponential backoff settings for {@link Reload}'s reconnect loop. */\nexport type ReloadDelay = {\n\t// The delay in milliseconds before reconnecting.\n\t// default: 1000\n\tinitial: DOMHighResTimeStamp;\n\n\t// The multiplier for the delay.\n\t// default: 2\n\tmultiplier: number;\n\n\t// The maximum delay in milliseconds.\n\t// default: 30000\n\tmax: DOMHighResTimeStamp;\n\n\t// Maximum total time in milliseconds to spend retrying before giving up.\n\t// Resets after each successful connection. Set to 0 for unlimited retries.\n\t// default: 300000 (5 minutes)\n\ttimeout?: DOMHighResTimeStamp;\n};\n\n/** Options for {@link Reload}: connect options plus reactive URL/enabled signals and backoff tuning. */\nexport type ReloadProps = ConnectProps & {\n\t// Whether to reload the connection when it disconnects.\n\t// default: true\n\tenabled?: boolean | Signal<boolean>;\n\n\t// The URL of the relay server.\n\turl?: URL | Signal<URL | undefined>;\n\n\t// The delay for the reload.\n\tdelay?: ReloadDelay;\n};\n\n/** Current state of a {@link Reload} connection. */\nexport type ReloadStatus = \"connecting\" | \"connected\" | \"disconnected\";\n\n/** Maintains a MoQ connection, reconnecting with exponential backoff when it drops. */\nexport class Reload {\n\t/** Relay URL to connect to; updating it triggers a reconnect. */\n\turl: Signal<URL | undefined>;\n\n\t/** Whether reconnecting is active. */\n\tenabled: Signal<boolean>;\n\n\t/** Current connection status. */\n\tstatus = new Signal<ReloadStatus>(\"disconnected\");\n\n\t/** The currently established session, or undefined while disconnected. */\n\testablished = new Signal<Established | undefined>(undefined);\n\n\t// All actively announced broadcast paths, updated reactively.\n\t#announced = new Signal<Set<Path.Valid>>(new Set());\n\n\t/** The set of broadcast paths currently announced by the server, updated reactively. */\n\treadonly announced: Getter<Set<Path.Valid>> = this.#announced;\n\n\t/** WebTransport options applied to each connection attempt (not reactive). */\n\twebtransport?: WebTransportProps;\n\n\t/** WebSocket fallback options applied to each connection attempt (not reactive). */\n\twebsocket: WebSocketOptions | undefined;\n\n\t/** Backoff settings for the reconnect loop. */\n\tdelay: ReloadDelay;\n\n\t/** The reactive effect scope driving the connect loop; closed by {@link Reload.close}. */\n\tsignals = new Effect();\n\n\t/** Resolves when the reconnect loop stops via {@link Reload.close} or the retry timeout. */\n\tclosed: Promise<void>;\n\t#closedResolve!: () => void;\n\t#closedReject!: (err: Error) => void;\n\n\t#delay: DOMHighResTimeStamp;\n\n\t// Timestamp when the current retry sequence started (for timeout).\n\t#retryStart: DOMHighResTimeStamp | undefined;\n\n\t// Increased by 1 each time to trigger a reload.\n\t#tick = new Signal(0);\n\n\t// Use the serialized URL as the reactive connection key. URL objects use identity\n\t// equality, but replacing one with an equivalent instance should not reconnect.\n\t#url: Getter<string | undefined>;\n\n\tconstructor(props?: ReloadProps) {\n\t\tthis.url = Signal.from(props?.url);\n\t\tthis.enabled = Signal.from(props?.enabled ?? false);\n\t\tthis.delay = props?.delay ?? { initial: 1000, multiplier: 2, max: 30000 };\n\t\tthis.webtransport = props?.webtransport;\n\t\tthis.websocket = props?.websocket;\n\n\t\tthis.#delay = this.delay.initial;\n\n\t\tthis.closed = new Promise((resolve, reject) => {\n\t\t\tthis.#closedResolve = resolve;\n\t\t\tthis.#closedReject = reject;\n\t\t});\n\n\t\tthis.#url = this.signals.computed((effect) => effect.get(this.url)?.href);\n\n\t\t// Create a reactive root so cleanup is easier.\n\t\tthis.signals.run(this.#connect.bind(this));\n\t\tthis.signals.run(this.#runAnnounced.bind(this));\n\t}\n\n\t#connect(effect: Effect): void {\n\t\t// Will retry when the tick changes.\n\t\teffect.get(this.#tick);\n\n\t\tconst enabled = effect.get(this.enabled);\n\t\tif (!enabled) return;\n\n\t\tconst href = effect.get(this.#url);\n\t\tif (!href) return;\n\t\tconst url = new URL(href);\n\n\t\teffect.set(this.status, \"connecting\", \"disconnected\");\n\n\t\teffect.spawn(async () => {\n\t\t\ttry {\n\t\t\t\tconst pending = connect(url, { websocket: this.websocket, webtransport: this.webtransport });\n\n\t\t\t\tconst connection = await Promise.race([effect.cancel, pending]);\n\t\t\t\tif (!connection) {\n\t\t\t\t\tpending.then((conn) => conn.close()).catch(() => {});\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\teffect.set(this.established, connection);\n\t\t\t\teffect.cleanup(() => connection.close());\n\n\t\t\t\teffect.set(this.status, \"connected\", \"disconnected\");\n\n\t\t\t\t// Reset the exponential backoff and timeout on success.\n\t\t\t\tthis.#delay = this.delay.initial;\n\t\t\t\tthis.#retryStart = undefined;\n\n\t\t\t\tawait Promise.race([effect.cancel, connection.closed]);\n\t\t\t} catch (err) {\n\t\t\t\tconsole.warn(\"connection error:\", err);\n\n\t\t\t\t// Track retry start for timeout.\n\t\t\t\tthis.#retryStart ??= performance.now();\n\n\t\t\t\tconst timeout = this.delay.timeout ?? 300000;\n\t\t\t\tif (timeout > 0) {\n\t\t\t\t\tconst elapsed = performance.now() - this.#retryStart;\n\t\t\t\t\tif (elapsed >= timeout) {\n\t\t\t\t\t\tconsole.warn(\"reconnect timed out\");\n\t\t\t\t\t\tthis.#closedReject(err instanceof Error ? err : new Error(String(err)));\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst tick = this.#tick.peek() + 1;\n\t\t\t\teffect.timer(() => this.#tick.update((prev) => Math.max(prev, tick)), this.#delay);\n\n\t\t\t\tthis.#delay = Math.min(this.#delay * this.delay.multiplier, this.delay.max);\n\t\t\t}\n\t\t});\n\t}\n\n\t#runAnnounced(effect: Effect): void {\n\t\tthis.#announced.set(new Set());\n\n\t\tconst conn = effect.get(this.established);\n\t\tif (!conn) return;\n\n\t\teffect.cleanup(() => this.#announced.set(new Set()));\n\n\t\t// Cloudflare's relay does not yet support SUBSCRIBE_NAMESPACE, so\n\t\t// skip announce subscriptions entirely for those hosts.\n\t\tif (conn.url.hostname.endsWith(\"mediaoverquic.com\")) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst announced = conn.announced(emptyPath());\n\t\teffect.cleanup(() => announced.close());\n\n\t\teffect.spawn(async () => {\n\t\t\ttry {\n\t\t\t\tfor (;;) {\n\t\t\t\t\tconst entry = await Promise.race([effect.cancel, announced.next()]);\n\t\t\t\t\tif (!entry) break;\n\n\t\t\t\t\tthis.#announced.mutate((active) => {\n\t\t\t\t\t\tif (entry.active) {\n\t\t\t\t\t\t\tactive.add(entry.path);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tactive.delete(entry.path);\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t} catch (err) {\n\t\t\t\tthis.#announced.set(new Set());\n\t\t\t\tthrow err;\n\t\t\t}\n\t\t});\n\t}\n\n\t/** Stop reconnecting, close the current connection, and resolve {@link Reload.closed}. */\n\tclose() {\n\t\tthis.signals.close();\n\t\tthis.#closedResolve();\n\t}\n}\n"]}
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../src/connection/reload.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect, type Getter, Signal } from \"@moq/signals\";\nimport * as Announce from \"../announced.ts\";\nimport { error } from \"../error.ts\";\nimport type * as Path from \"../path.ts\";\nimport { empty as emptyPath } from \"../path.ts\";\nimport { type ConnectProps, connect, type WebSocketOptions, type WebTransportProps } from \"./connect.ts\";\nimport type { Established } from \"./established.ts\";\nimport type { Probe, Stats } from \"./stats.ts\";\n\n/**\n * Exponential backoff settings for {@link Reload}'s reconnect loop.\n *\n * The delays carry jitter, so a fleet of tabs knocked offline together doesn't reconnect in\n * lockstep. Every failure is retried; {@link ReloadDelay.timeout} is what stops the loop.\n */\nexport type ReloadDelay = {\n\t/** The delay in milliseconds before reconnecting (default: 1000). */\n\tinitial: DOMHighResTimeStamp;\n\n\t/** The multiplier for the delay (default: 2). */\n\tmultiplier: number;\n\n\t/** The maximum delay in milliseconds (default: 5000). */\n\tmax: DOMHighResTimeStamp;\n\n\t/**\n\t * Maximum total time in milliseconds to spend retrying before giving up (default:\n\t * 10000). Resets after each successful connection. Set to 0 for unlimited retries.\n\t */\n\ttimeout?: DOMHighResTimeStamp;\n};\n\n/** Connection and retry options for {@link Reload}. */\nexport type ReloadProps = Omit<ConnectProps, \"signal\"> & {\n\t/** Whether to reload the connection when it disconnects (default: true). */\n\tenabled?: boolean | Signal<boolean>;\n\n\t/** The URL of the relay server. */\n\turl?: URL | Signal<URL | undefined>;\n\n\t/** Backoff settings for the reconnect loop. */\n\tdelay?: ReloadDelay;\n};\n\n/**\n * How long to keep retrying before giving up, when {@link ReloadDelay.timeout} is unset.\n *\n * Short on purpose: a failure that clears within it was transient, and one that doesn't should\n * surface as an error rather than leave the page silently reconnecting for minutes.\n */\nconst DEFAULT_TIMEOUT = 10000;\n\n/** Current state of a {@link Reload} connection. */\nexport type ReloadStatus = \"connecting\" | \"connected\" | \"disconnected\";\n\n/** Maintains a MoQ connection, reconnecting with exponential backoff when it drops. */\nexport class Reload {\n\t/** Relay URL to connect to; updating it triggers a reconnect. */\n\turl: Signal<URL | undefined>;\n\n\t/** Whether reconnecting is active. */\n\tenabled: Signal<boolean>;\n\n\t/** Current connection status. */\n\tstatus = new Signal<ReloadStatus>(\"disconnected\");\n\n\t/** The currently established session, or undefined while disconnected. */\n\testablished = new Signal<Established | undefined>(undefined);\n\n\t/**\n\t * The current connection's PROBE estimates, spanning reconnects.\n\t *\n\t * Undefined while disconnected: the estimates belong to a single connection.\n\t * See {@link Established.probe}.\n\t */\n\treadonly probe: Getter<Probe | undefined>;\n\n\t/** WebTransport options applied to each connection attempt (not reactive). */\n\twebtransport?: WebTransportProps;\n\n\t/** WebSocket fallback options applied to each connection attempt (not reactive). */\n\twebsocket: WebSocketOptions | undefined;\n\n\t/**\n\t * Whether the relay supports broadcast discovery, applied to each connection attempt (not\n\t * reactive). Undefined defers to the default for the URL. See {@link Established.discovery}.\n\t */\n\tdiscovery?: boolean;\n\n\t/** Backoff settings for the reconnect loop. */\n\tdelay: ReloadDelay;\n\n\t/** The reactive effect scope driving the connect loop; closed by {@link Reload.close}. */\n\t#signals = new Effect();\n\n\t/**\n\t * Resolves when the reconnect loop stops via {@link Reload.close}.\n\t *\n\t * Rejects when the loop gives up instead, carrying the failure that was in flight when the\n\t * retry window expired.\n\t */\n\tclosed: Promise<void>;\n\t#closedResolve!: () => void;\n\t#closedReject!: (err: Error) => void;\n\n\t// The current wait between attempts, doubling per failure, and when the retry window expires.\n\t// Both are undefined between sequences, so a later edit to `delay` applies to the next one.\n\t#delay: DOMHighResTimeStamp | undefined;\n\t#deadline: DOMHighResTimeStamp | undefined;\n\n\t// Increased by 1 each time to trigger a reload.\n\t#tick = new Signal(0);\n\n\t// True after the browser freezes or hides the page until it visibly resumes.\n\t#suspended = new Signal(false);\n\n\t// Use the serialized URL as the reactive connection key. URL objects use identity\n\t// equality, but replacing one with an equivalent instance should not reconnect.\n\t#url: Getter<string | undefined>;\n\tconstructor(props?: ReloadProps) {\n\t\tthis.url = Signal.from(props?.url);\n\t\tthis.enabled = Signal.from(props?.enabled ?? false);\n\t\tthis.delay = props?.delay ?? { initial: 1000, multiplier: 2, max: 5000 };\n\t\tthis.webtransport = props?.webtransport;\n\t\tthis.websocket = props?.websocket;\n\t\tthis.discovery = props?.discovery;\n\n\t\tthis.closed = new Promise((resolve, reject) => {\n\t\t\tthis.#closedResolve = resolve;\n\t\t\tthis.#closedReject = reject;\n\t\t});\n\n\t\t// A caller is free to never await `closed`, and giving up rejects it unprompted. Marking the\n\t\t// rejection handled here keeps that from surfacing as an `unhandledrejection`; a consumer\n\t\t// awaiting the same promise still receives it.\n\t\tthis.closed.catch(() => {});\n\n\t\tif (typeof window !== \"undefined\" && typeof document !== \"undefined\") {\n\t\t\tthis.#signals.event(window, \"pagehide\", () => this.#suspended.set(true));\n\t\t\tthis.#signals.event(window, \"pageshow\", () => this.#suspended.set(false));\n\t\t\tthis.#signals.event(window, \"unload\", () => this.#suspended.set(true));\n\t\t\tthis.#signals.event(document, \"visibilitychange\", () => {\n\t\t\t\tif (!document.hidden) this.#suspended.set(false);\n\t\t\t});\n\t\t}\n\n\t\tthis.probe = this.#signals.computed((effect) => {\n\t\t\tconst connection = effect.get(this.established);\n\t\t\treturn connection && effect.get(connection.probe);\n\t\t});\n\n\t\tthis.#url = this.#signals.computed((effect) => effect.get(this.url)?.href);\n\t\t// Create a reactive root so cleanup is easier.\n\t\tthis.#signals.run(this.#connect.bind(this));\n\t}\n\n\t#connect(effect: Effect): void {\n\t\t// Will retry when the tick changes.\n\t\teffect.get(this.#tick);\n\n\t\tconst suspended = effect.get(this.#suspended);\n\t\tconst enabled = effect.get(this.enabled);\n\t\tif (!enabled || suspended) return;\n\n\t\tconst href = effect.get(this.#url);\n\t\tif (!href) return;\n\t\tconst url = new URL(href);\n\n\t\teffect.set(this.status, \"connecting\", \"disconnected\");\n\n\t\t// This run's teardown, handed to connect() so a rerun cancels the attempt in flight.\n\t\tconst signal = effect.abort;\n\n\t\teffect.spawn(async () => {\n\t\t\t// Set once the session is live, so #retry can tell a healthy session that\n\t\t\t// later dropped from a connect failure or a peer that flaps immediately.\n\t\t\tlet connected: DOMHighResTimeStamp | undefined;\n\n\t\t\ttry {\n\t\t\t\tconst connection = await connect(url, {\n\t\t\t\t\twebsocket: this.websocket,\n\t\t\t\t\twebtransport: this.webtransport,\n\t\t\t\t\tdiscovery: this.discovery,\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\n\t\t\t\t// Hand the connection to the effect, which closes it now if this run is already over.\n\t\t\t\teffect.cleanup(() => connection.close());\n\t\t\t\tif (signal.aborted) return;\n\n\t\t\t\teffect.set(this.established, connection);\n\t\t\t\teffect.set(this.status, \"connected\", \"disconnected\");\n\n\t\t\t\tconnected = performance.now();\n\n\t\t\t\t// A cancelled effect resolves undefined, so the sentinel tells the session\n\t\t\t\t// closing apart from this run being torn down.\n\t\t\t\tconst closed = await Promise.race([effect.cancel, connection.closed.then(() => true)]);\n\t\t\t\tif (!closed) return;\n\n\t\t\t\tconsole.warn(\"connection closed, reconnecting\");\n\t\t\t\tthis.#retry(effect, connected);\n\t\t\t} catch (err) {\n\t\t\t\t// Treat teardown as cancellation, not a connection failure.\n\t\t\t\tif (signal.aborted) return;\n\n\t\t\t\tconsole.warn(\"connection error:\", err);\n\t\t\t\tthis.#retry(effect, connected, err);\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * Schedule the next connect attempt after the current backoff, or stop once the retry window\n\t * has expired. `connected` is when the dead session was established, if it ever was, and\n\t * `cause` the error that killed it, if it died with one.\n\t */\n\t#retry(effect: Effect, connected: DOMHighResTimeStamp | undefined, cause?: unknown): void {\n\t\t// Any session is dead now: report disconnected during the backoff rather than\n\t\t// when the retry reruns the effect.\n\t\tthis.established.set(undefined);\n\t\tthis.status.set(\"disconnected\");\n\n\t\t// A session that outlived the initial delay was healthy, so clear the backoff and\n\t\t// start a fresh retry window: a one-off drop should reconnect promptly. Anything\n\t\t// shorter is a peer that accepts and immediately severs, which has to keep\n\t\t// escalating or we hammer it forever at the initial delay.\n\t\tif (connected !== undefined && performance.now() - connected >= this.delay.initial) {\n\t\t\tthis.#delay = undefined;\n\t\t\tthis.#deadline = undefined;\n\t\t}\n\n\t\tconst now = performance.now();\n\t\tconst timeout = this.delay.timeout ?? DEFAULT_TIMEOUT;\n\t\tthis.#delay ??= this.delay.initial;\n\t\tthis.#deadline ??= timeout > 0 ? now + timeout : Number.POSITIVE_INFINITY;\n\n\t\tif (now >= this.#deadline) {\n\t\t\tconsole.warn(\"reconnect timed out\");\n\t\t\t// A graceful close has no error, so report the timeout itself.\n\t\t\tthis.#closedReject(cause === undefined ? new Error(\"reconnect timed out\") : error(cause));\n\t\t\treturn;\n\t\t}\n\n\t\t// Equal jitter, so a fleet of tabs knocked offline together doesn't reconnect on the same\n\t\t// tick, and never past the deadline the retry window promised.\n\t\tconst wait = Math.min(this.#delay * (0.5 + Math.random() / 2), this.#deadline - now);\n\t\tthis.#delay = Math.min(this.#delay * this.delay.multiplier, this.delay.max);\n\n\t\tconst tick = this.#tick.peek() + 1;\n\t\teffect.timer(() => this.#tick.update((prev) => Math.max(prev, tick)), wait);\n\t}\n\n\t/**\n\t * Subscribe to broadcast announcements under an optional prefix, spanning reconnects.\n\t *\n\t * The same {@link Announce.Consumer} stream as {@link Established.announced}, but everything active\n\t * is retracted (an `active: false` update) whenever the connection drops and re-announced on\n\t * reconnect, so a consumer draining `next()` never clings to a dead route across a reconnect.\n\t *\n\t * Stays empty while the relay lacks {@link Established.discovery}.\n\t */\n\tannounced(prefix: Path.Valid = emptyPath()): Announce.Consumer {\n\t\tconst producer = new Announce.Producer(prefix);\n\t\tconst consumer = producer.consume();\n\n\t\t// Closing the consumer closes the shared state, so stop appending after that.\n\t\tlet closed = false;\n\t\tvoid consumer.closed.then(() => {\n\t\t\tclosed = true;\n\t\t});\n\n\t\tconst pump = new Effect();\n\t\tpump.run((effect) => {\n\t\t\tconst conn = effect.get(this.established);\n\t\t\tif (!conn) return;\n\n\t\t\t// Without discovery the upstream announce stream never yields, so leave the\n\t\t\t// consumer empty rather than opening a subscription that can't be answered.\n\t\t\tif (!conn.discovery) return;\n\n\t\t\tconst upstream = conn.announced(prefix);\n\t\t\teffect.cleanup(() => upstream.close());\n\n\t\t\t// Track what this connection announced so we can retract it if the connection drops.\n\t\t\tconst active = new Set<Path.Valid>();\n\n\t\t\teffect.spawn(async () => {\n\t\t\t\ttry {\n\t\t\t\t\tfor (;;) {\n\t\t\t\t\t\tconst entry = await Promise.race([effect.cancel, upstream.next()]);\n\t\t\t\t\t\tif (!entry) break;\n\t\t\t\t\t\tif (entry.active) active.add(entry.path);\n\t\t\t\t\t\telse active.delete(entry.path);\n\t\t\t\t\t\tproducer.append(entry);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// A dropped connection resets the announce stream; the retractions below cover it.\n\t\t\t\t} finally {\n\t\t\t\t\t// Retract everything from the connection that just went away, so a per-broadcast\n\t\t\t\t\t// watcher tears down instead of clinging to the dead route.\n\t\t\t\t\tif (!closed) {\n\t\t\t\t\t\tfor (const path of active) {\n\t\t\t\t\t\t\tproducer.append({ path, active: false });\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tthis.#signals.cleanup(() => pump.close());\n\t\tvoid consumer.closed.then(() => pump.close());\n\n\t\treturn consumer;\n\t}\n\n\t/**\n\t * A reactive handle to one broadcast, spanning reconnects.\n\t *\n\t * The same {@link Announce.Broadcast} as {@link Established.announcedBroadcast}, but it\n\t * follows the reconnect loop: the broadcast drops to `undefined` when the connection dies\n\t * and resolves again once the new connection announces the path. Use it instead of\n\t * consuming off {@link Reload.established} whenever the broadcast may come online after you\n\t * do, which is exactly the case a blind `consume` loses.\n\t *\n\t * Close the handle when done; {@link Reload.close} only drops it to `undefined`.\n\t */\n\tannouncedBroadcast(path: Path.Valid): Announce.Broadcast {\n\t\treturn new Announce.Broadcast({ connection: this.established, path });\n\t}\n\n\t/**\n\t * Snapshot the live connection's transport counters, or undefined while disconnected.\n\t * See {@link Established.stats}.\n\t */\n\tasync stats(): Promise<Stats | undefined> {\n\t\treturn this.established.peek()?.stats();\n\t}\n\n\t/** Stop reconnecting, close the current connection, and resolve {@link Reload.closed}. */\n\tclose() {\n\t\tthis.#signals.close();\n\t\tthis.#closedResolve();\n\t}\n}\n"]}

package/connection/stats.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Connection statistics: what the local transport counts, and what the peer reports.
+ *
+ * @module
+ */
+import * as Time from "../time";
+/**
+ * A point-in-time snapshot of the transport's counters, from `WebTransport.getStats()`.
+ *
+ * Pulled on demand rather than pushed: the transport has no event to subscribe to, and
+ * a caller computing a rate wants to choose its own sampling instants. Snapshot twice
+ * and divide by the interval you measured.
+ *
+ * Every field is optional. The qmux/WebSocket fallback implements no `getStats()` at
+ * all and reports nothing; see {@link Probe} for what the peer measures.
+ *
+ * The field names match Rust's `moq_net::ConnectionStats` but the counters keep each
+ * stack's own semantics rather than being normalized. Notably W3C excludes
+ * retransmissions and QUIC overhead from the byte counts where quinn includes them,
+ * and counts packets where quinn counts datagrams.
+ *
+ * @public
+ */
+export interface Stats {
+    /**
+     * Smoothed round-trip time estimate in milliseconds.
+     *
+     * Usually absent: browsers don't report an RTT yet even though the W3C dictionary
+     * has the field. Use {@link Probe.rtt}, which the peer measures.
+     */
+    rtt?: Time.Milli;
+    /** Estimated send bandwidth from the congestion controller, in bits per second. */
+    estimatedSendRate?: number;
+    /** Total bytes sent on streams and datagrams, excluding retransmissions and QUIC overhead. */
+    bytesSent?: number;
+    /** Total bytes received on streams and datagrams, including duplicates, excluding QUIC overhead. */
+    bytesReceived?: number;
+    /** Bytes currently declared lost. The estimate can decrease when a loss proves spurious. */
+    bytesLost?: number;
+    /** Total packets sent, including retransmissions. */
+    packetsSent?: number;
+    /** Total packets received, including duplicates. */
+    packetsReceived?: number;
+    /** Packets currently declared lost. The estimate can decrease when a loss proves spurious. */
+    packetsLost?: number;
+}
+/**
+ * Estimates measured by the peer and delivered over the MoQ PROBE stream.
+ *
+ * Pushed rather than pulled: these arrive when the peer sends them, so they're read
+ * from a signal. Empty until the first PROBE message, on versions without PROBE
+ * (moq-lite-01/02, moq-transport), and again once the stream ends, so a consumer
+ * never holds a stale estimate from a dead stream.
+ *
+ * @public
+ */
+export interface Probe {
+    /**
+     * Round-trip time in milliseconds.
+     *
+     * The only RTT available today, since browsers don't populate the transport's.
+     * Measured through the peer's application layer, so it reads higher than a
+     * transport-level RTT would.
+     */
+    rtt?: Time.Milli;
+    /** The peer's estimate of the bitrate it is receiving from us, in bits per second. */
+    estimatedRecvRate?: number;
+}
+/**
+ * The subset of the W3C `WebTransportConnectionStats` dictionary we consume.
+ * `getStats()` is not in TypeScript's DOM lib yet, so it is declared here.
+ *
+ * @internal
+ */
+export interface TransportStats {
+    smoothedRtt?: number;
+    estimatedSendRate?: number | null;
+    bytesSent?: number;
+    bytesReceived?: number;
+    bytesLost?: number;
+    packetsSent?: number;
+    packetsReceived?: number;
+    packetsLost?: number;
+}
+/**
+ * Snapshot `quic` via `getStats()`, or an empty snapshot when the transport doesn't
+ * implement it (the qmux/WebSocket fallback, older browsers) or the call fails.
+ *
+ * @internal
+ */
+export declare function transportStats(quic: WebTransport): Promise<Stats>;
+//# sourceMappingURL=stats.d.ts.map

package/connection/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/connection/stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,KAAK;IACrB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;IAEjB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oGAAoG;IACpG,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,KAAK;IACrB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;IAEjB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAkBvE"}

package/connection/stats.js

@@ -0,0 +1,35 @@
+/* @ts-self-types="./stats.d.ts" */
+/**
+ * Connection statistics: what the local transport counts, and what the peer reports.
+ *
+ * @module
+ */
+import * as Time from "../time.js";
+/**
+ * Snapshot `quic` via `getStats()`, or an empty snapshot when the transport doesn't
+ * implement it (the qmux/WebSocket fallback, older browsers) or the call fails.
+ *
+ * @internal
+ */
+export async function transportStats(quic) {
+    const getStats = quic.getStats;
+    if (typeof getStats !== "function")
+        return {};
+    try {
+        const stats = await getStats.call(quic);
+        return {
+            rtt: stats.smoothedRtt !== undefined ? Time.Milli(stats.smoothedRtt) : undefined,
+            estimatedSendRate: stats.estimatedSendRate ?? undefined,
+            bytesSent: stats.bytesSent,
+            bytesReceived: stats.bytesReceived,
+            bytesLost: stats.bytesLost,
+            packetsSent: stats.packetsSent,
+            packetsReceived: stats.packetsReceived,
+            packetsLost: stats.packetsLost,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=stats.js.map

package/connection/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/connection/stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AA2FnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAkB;IACtD,MAAM,QAAQ,GAAI,IAAqD,CAAC,QAAQ,CAAC;IACjF,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO,EAAE,CAAC;IAC9C,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO;YACN,GAAG,EAAE,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,SAAS;YACvD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,WAAW,EAAE,KAAK,CAAC,WAAW;SAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC","sourcesContent":["/**\n * Connection statistics: what the local transport counts, and what the peer reports.\n *\n * @module\n */\nimport * as Time from \"../time.ts\";\n\n/**\n * A point-in-time snapshot of the transport's counters, from `WebTransport.getStats()`.\n *\n * Pulled on demand rather than pushed: the transport has no event to subscribe to, and\n * a caller computing a rate wants to choose its own sampling instants. Snapshot twice\n * and divide by the interval you measured.\n *\n * Every field is optional. The qmux/WebSocket fallback implements no `getStats()` at\n * all and reports nothing; see {@link Probe} for what the peer measures.\n *\n * The field names match Rust's `moq_net::ConnectionStats` but the counters keep each\n * stack's own semantics rather than being normalized. Notably W3C excludes\n * retransmissions and QUIC overhead from the byte counts where quinn includes them,\n * and counts packets where quinn counts datagrams.\n *\n * @public\n */\nexport interface Stats {\n\t/**\n\t * Smoothed round-trip time estimate in milliseconds.\n\t *\n\t * Usually absent: browsers don't report an RTT yet even though the W3C dictionary\n\t * has the field. Use {@link Probe.rtt}, which the peer measures.\n\t */\n\trtt?: Time.Milli;\n\n\t/** Estimated send bandwidth from the congestion controller, in bits per second. */\n\testimatedSendRate?: number;\n\n\t/** Total bytes sent on streams and datagrams, excluding retransmissions and QUIC overhead. */\n\tbytesSent?: number;\n\n\t/** Total bytes received on streams and datagrams, including duplicates, excluding QUIC overhead. */\n\tbytesReceived?: number;\n\n\t/** Bytes currently declared lost. The estimate can decrease when a loss proves spurious. */\n\tbytesLost?: number;\n\n\t/** Total packets sent, including retransmissions. */\n\tpacketsSent?: number;\n\n\t/** Total packets received, including duplicates. */\n\tpacketsReceived?: number;\n\n\t/** Packets currently declared lost. The estimate can decrease when a loss proves spurious. */\n\tpacketsLost?: number;\n}\n\n/**\n * Estimates measured by the peer and delivered over the MoQ PROBE stream.\n *\n * Pushed rather than pulled: these arrive when the peer sends them, so they're read\n * from a signal. Empty until the first PROBE message, on versions without PROBE\n * (moq-lite-01/02, moq-transport), and again once the stream ends, so a consumer\n * never holds a stale estimate from a dead stream.\n *\n * @public\n */\nexport interface Probe {\n\t/**\n\t * Round-trip time in milliseconds.\n\t *\n\t * The only RTT available today, since browsers don't populate the transport's.\n\t * Measured through the peer's application layer, so it reads higher than a\n\t * transport-level RTT would.\n\t */\n\trtt?: Time.Milli;\n\n\t/** The peer's estimate of the bitrate it is receiving from us, in bits per second. */\n\testimatedRecvRate?: number;\n}\n\n/**\n * The subset of the W3C `WebTransportConnectionStats` dictionary we consume.\n * `getStats()` is not in TypeScript's DOM lib yet, so it is declared here.\n *\n * @internal\n */\nexport interface TransportStats {\n\tsmoothedRtt?: number;\n\testimatedSendRate?: number | null;\n\tbytesSent?: number;\n\tbytesReceived?: number;\n\tbytesLost?: number;\n\tpacketsSent?: number;\n\tpacketsReceived?: number;\n\tpacketsLost?: number;\n}\n\n/**\n * Snapshot `quic` via `getStats()`, or an empty snapshot when the transport doesn't\n * implement it (the qmux/WebSocket fallback, older browsers) or the call fails.\n *\n * @internal\n */\nexport async function transportStats(quic: WebTransport): Promise<Stats> {\n\tconst getStats = (quic as { getStats?: () => Promise<TransportStats> }).getStats;\n\tif (typeof getStats !== \"function\") return {};\n\ttry {\n\t\tconst stats = await getStats.call(quic);\n\t\treturn {\n\t\t\trtt: stats.smoothedRtt !== undefined ? Time.Milli(stats.smoothedRtt) : undefined,\n\t\t\testimatedSendRate: stats.estimatedSendRate ?? undefined,\n\t\t\tbytesSent: stats.bytesSent,\n\t\t\tbytesReceived: stats.bytesReceived,\n\t\t\tbytesLost: stats.bytesLost,\n\t\t\tpacketsSent: stats.packetsSent,\n\t\t\tpacketsReceived: stats.packetsReceived,\n\t\t\tpacketsLost: stats.packetsLost,\n\t\t};\n\t} catch {\n\t\treturn {};\n\t}\n}\n"]}

package/connection/transport.d.ts

@@ -0,0 +1,10 @@
+/** The wire transport a session runs over. */
+export type Transport = "webtransport" | "websocket";
+/**
+ * The transport a live session is actually running over. qmux implements the `WebTransport`
+ * interface on top of a WebSocket, so the two are indistinguishable by shape.
+ *
+ * @internal Not re-exported from the package entrypoint.
+ */
+export declare function transportOf(quic: WebTransport): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/connection/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/connection/transport.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,WAAW,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAEzD"}

package/connection/transport.js

@@ -0,0 +1,12 @@
+/* @ts-self-types="./transport.d.ts" */
+import Session from "@moq/qmux";
+/**
+ * The transport a live session is actually running over. qmux implements the `WebTransport`
+ * interface on top of a WebSocket, so the two are indistinguishable by shape.
+ *
+ * @internal Not re-exported from the package entrypoint.
+ */
+export function transportOf(quic) {
+    return quic instanceof Session ? "websocket" : "webtransport";
+}
+//# sourceMappingURL=transport.js.map

package/connection/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/connection/transport.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,WAAW,CAAC;AAKhC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC7C,OAAO,IAAI,YAAY,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;AAC/D,CAAC","sourcesContent":["import Session from \"@moq/qmux\";\n\n/** The wire transport a session runs over. */\nexport type Transport = \"webtransport\" | \"websocket\";\n\n/**\n * The transport a live session is actually running over. qmux implements the `WebTransport`\n * interface on top of a WebSocket, so the two are indistinguishable by shape.\n *\n * @internal Not re-exported from the package entrypoint.\n */\nexport function transportOf(quic: WebTransport): Transport {\n\treturn quic instanceof Session ? \"websocket\" : \"webtransport\";\n}\n"]}

package/consume.d.ts

@@ -0,0 +1,44 @@
+import type * as broadcast from "./broadcast";
+import type * as Path from "./path";
+/**
+ * Per-path dedup cache for consumed broadcasts, shared by the moq-lite and moq-ietf
+ * subscribers.
+ *
+ * `Connection.consume(path)` must not mint a fresh subscription per call: repeat requests
+ * for the same path (e.g. several renditions referencing one `broadcast: "./source"`) should
+ * share a single upstream subscription. This mirrors the Rust `origin::Consumer` weak-cache:
+ * a still-live path resolves to a shared {@link broadcast.Consumer.clone}, a closed one is
+ * re-consumed on the next request. Each handle is reference-counted, so the shared broadcast
+ * closes once every caller has closed its handle.
+ *
+ * @internal
+ */
+export declare class BroadcastCache {
+    #private;
+    /** A shared handle to the live broadcast cached for `path`, or `undefined` on a miss. */
+    get(path: Path.Valid): broadcast.Consumer | undefined;
+    /**
+     * Cache `consumer` as the base handle for `path` (evicting it once it closes) and return it.
+     * Call on a {@link get} miss, after wiring up the fresh consumer's subscribe loop.
+     */
+    insert(path: Path.Valid, consumer: broadcast.Consumer): broadcast.Consumer;
+    /**
+     * Stop sharing the broadcast cached for `path`, so the next request subscribes fresh.
+     *
+     * Call when the path's advertisement goes away. A handle only leaves the cache on its own
+     * once *every* holder has closed it, so one holder outliving the publisher (a second
+     * watcher, or a caller consuming the path directly) would otherwise keep the dead
+     * generation's cached tracks alive and hand them to whoever consumes the path next.
+     * Existing handles are left alone: they belong to their holders, and the wire resets
+     * whatever they still have open.
+     *
+     * Eviction is unconditional, which costs a dedup miss when two announcement streams watch
+     * one path: the second stream's retraction can arrive after the first has already seen the
+     * replacement, dropping the fresh entry so the next request subscribes again instead of
+     * sharing. Telling that stale retraction from a live one needs a generation id on the
+     * advertisement (moq-lite's `Epoch`, not yet on the wire), so until then this errs toward a
+     * duplicate subscription rather than risk handing out a dead one.
+     */
+    evict(path: Path.Valid): void;
+}
+//# sourceMappingURL=consume.d.ts.map