@norskvideo/moq-net 0.1.8 → 0.2.1

package/connection/pool.d.ts

@@ -0,0 +1,186 @@
+/**
+ * A reconnecting, shareable connection: one origin and one reconnect loop per relay URL.
+ *
+ * @module
+ */
+import { type GetPromise, type Getter, Signal } from "@norskvideo/moq-signals";
+import * as Announce from "../announced";
+import type { Handle } from "../bandwidth";
+import * as Origin from "../origin";
+import * as Path from "../path";
+import * as Time from "../time";
+import { type AcceptProps as AcceptPropsType, accept } from "./accept";
+import { isWebTransportSupported } from "./browser";
+import { type CertificateHash as CertificateHashType, type ConnectProps as ConnectPropsType, certificateHash, connect, type WebSocketProps as WebSocketPropsType, type WebTransportProps as WebTransportPropsType } from "./connect";
+import type { Established as EstablishedType } from "./established";
+import { type ReloadDelay, type ReloadStatus } from "./reload";
+import type { Probe as ProbeType, Stats as StatsType } from "./stats";
+import type { Transport as TransportType } from "./transport";
+/** Options for {@link Connection}. */
+export interface ConnectionProps {
+    /** The relay to connect to; pass a `Signal` to switch relays live. */
+    url?: URL | Signal<URL | undefined>;
+    /** Whether to connect at all (default: true); pass a `Signal` to toggle live. */
+    enabled?: boolean | Signal<boolean>;
+    /**
+     * How long the underlying connection outlives its last handle (default: 2000ms).
+     *
+     * The window is what makes moving an element around the DOM free: the connection and
+     * everything it discovered are still warm when the new owner asks for them. The longest
+     * linger requested by any handle sharing the connection wins.
+     */
+    linger?: Time.Milli;
+    /**
+     * Share a pooled transport keyed on the URL. By default, options specific to this
+     * handle use a private reconnect loop; otherwise connections share by URL.
+     * Explicit `true` refuses options a pool cannot honor.
+     */
+    share?: boolean;
+    /** WebTransport options applied to each connection attempt (not reactive). */
+    webtransport?: WebTransportPropsType;
+    /** WebSocket fallback options applied to each connection attempt (not reactive). */
+    websocket?: WebSocketPropsType;
+    /** Whether the relay supports broadcast discovery. */
+    discovery?: boolean;
+    /** The origin whose broadcasts are served, spanning reconnects. Implies a private loop. */
+    publish?: Origin.Consumer;
+    /** The origin fed with the peer's announced broadcasts, spanning reconnects. Implies a private loop. */
+    consume?: Origin.Producer;
+    /** Backoff settings for the reconnect loop; an unset field uses its default. */
+    delay?: ReloadDelay;
+    /** A Connection owns the abort signal for each connection attempt. */
+    signal?: never;
+    /** A one-shot transport cannot be reused by the reconnect loop; call {@link Connection.connect} instead. */
+    transport?: never;
+}
+/**
+ * A cloneable handle on a MoQ connection: `new Connection({ url })` reconnects and, by
+ * default, shares one origin and one reconnect loop with every other handle on that URL.
+ *
+ * The shared {@link origin} is wired to both directions. Everything the relay announces
+ * lands in it, a publish into it is announced to the relay, and a page that publishes and
+ * watches the same path resolves it locally with no round trip.
+ *
+ * {@link close} releases this handle; the connection survives its last handle by a short
+ * linger window (see {@link ConnectionProps.linger}), so a component torn down and rebuilt
+ * reuses the warm connection instead of redialing.
+ *
+ * The loop reconnects for as long as a handle holds it, so an outage of any length recovers
+ * on its own. An auth rejection stops retrying those credentials and retires the shared
+ * connection so the next handle dials fresh; a new URL on this handle starts another
+ * sequence. {@link closed} settles only when this handle is released.
+ *
+ * Options the pool cannot honor (transport options, discovery, delay, a pinned
+ * certificate, caller-owned origins) use a private loop. An explicit `share: true`
+ * refuses them. A supplied transport cannot reconnect at all; pass it to {@link Connection.connect}
+ * instead.
+ *
+ * @public
+ */
+export declare class Connection {
+    #private;
+    /** Establish a one-shot session; a supplied transport belongs here, not in the reconnect loop. */
+    static readonly connect: typeof connect;
+    /** Accept a one-shot session on an already-open transport. */
+    static readonly accept: typeof accept;
+    /** SHA-256 of a certificate, for pinning via `webtransport.serverCertificateHashes`. */
+    static readonly certificateHash: typeof certificateHash;
+    /** Whether this runtime can connect with WebTransport. */
+    static readonly isWebTransportSupported: typeof isWebTransportSupported;
+    /** Relay URL to connect to; updating it reconnects to that URL. */
+    url: Signal<URL | undefined>;
+    /** Whether to hold a connection at all; clearing it releases this handle's share. */
+    enabled: Signal<boolean>;
+    /** Current status of the connection. */
+    readonly status: Getter<ReloadStatus>;
+    /**
+     * The failure that stopped retrying the current URL, or undefined while the loop is live.
+     *
+     * Set on an auth rejection or when a private retry window expires. Cleared when a new URL
+     * or a disable/re-enable starts another sequence, not on a page hide/show.
+     */
+    readonly error: Getter<Error | undefined>;
+    /**
+     * The wire transport the current session runs over, or undefined while disconnected.
+     *
+     * The session itself is deliberately not exposed: it is shared, so no handle may close
+     * or reconfigure it, and everything else it offers is reachable through {@link origin}.
+     */
+    readonly transport: Getter<TransportType | undefined>;
+    /** The current connection's PROBE estimates, or undefined while disconnected. */
+    readonly probe: Getter<ProbeType | undefined>;
+    /**
+     * The send-side bandwidth allocator for the current URL, or undefined
+     * while disabled or URL-less.
+     *
+     * Every handle on this URL shares the same instance, so publishers reserve
+     * against one registry. Borrowed, not owned: the type has no close, since
+     * closing it would starve every other handle.
+     */
+    readonly bandwidth: Getter<Handle | undefined>;
+    /**
+     * The origin for the current URL, or undefined while disabled or URL-less.
+     *
+     * Publish into it or consume from it; a shared handle's origin is the same one every
+     * other handle on this URL uses, and it spans the connection's reconnects. Borrowed,
+     * not owned: the type has no close, since closing it would tear the origin down under
+     * every other handle.
+     */
+    readonly origin: Getter<Origin.Table | undefined>;
+    /**
+     * Settles once this handle is released via {@link close}: `null` on a clean close, or
+     * the abort {@link Error}. Peek it synchronously (`undefined` while open), observe it
+     * reactively, or `await` it. Attempt failures live on {@link error} instead.
+     */
+    get closed(): GetPromise<Error | null>;
+    /**
+     * Take a handle on the connection for {@link ConnectionProps.url}.
+     *
+     * Dials immediately when a URL is given and `enabled` is not false; otherwise waits for
+     * the signals to say go. The handle owns nothing but its own share: {@link close}
+     * releases it, and the underlying connection and origin live for as long as any handle
+     * (plus the linger window) wants them.
+     */
+    constructor(props?: ConnectionProps);
+    /**
+     * Subscribe to broadcast announcements matching `scope`, spanning reconnects
+     * and URL switches: a switch retracts everything from
+     * the old relay's origin, then the new one's arrivals stream in.
+     */
+    announced(scope?: Path.Pattern, options?: Announce.Options): Announce.Consumer;
+    /** Snapshot the live connection's transport counters, or undefined while disconnected. */
+    stats(): Promise<StatsType | undefined>;
+    /**
+     * Release this handle. The shared connection closes once its last handle is gone and
+     * the linger window passes; other handles on the URL are unaffected. Idempotent.
+     */
+    close(abort?: Error): void;
+}
+/** Types on {@link Connection}: the handle is the class, these are its associated types. */
+export declare namespace Connection {
+    /** Options for {@link Connection}. */
+    type Props = ConnectionProps;
+    /** Options for {@link Connection.connect}. */
+    type ConnectProps = ConnectPropsType;
+    /** Options for {@link Connection.accept}. */
+    type AcceptProps = AcceptPropsType;
+    /** Backoff settings for a private reconnect loop. */
+    type Backoff = ReloadDelay;
+    /** Current state of a {@link Connection}. */
+    type Status = ReloadStatus;
+    /** The current connection's PROBE estimates. */
+    type Probe = ProbeType;
+    /** A point-in-time snapshot of the transport's counters. */
+    type Stats = StatsType;
+    /** The wire transport a session runs over. */
+    type Transport = TransportType;
+    /** Tuning for the WebSocket fallback. */
+    type WebSocketProps = WebSocketPropsType;
+    /** WebTransport options, including friendlier certificate pinning. */
+    type WebTransportProps = WebTransportPropsType;
+    /** A server certificate hash used to pin a self-signed server. */
+    type CertificateHash = CertificateHashType;
+    /** An established one-shot session. */
+    type Established = EstablishedType;
+}
+//# sourceMappingURL=pool.d.ts.map

package/connection/pool.d.ts.map

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

package/connection/pool.js

@@ -0,0 +1,361 @@
+/* @ts-self-types="./pool.d.ts" */
+/**
+ * A reconnecting, shareable connection: one origin and one reconnect loop per relay URL.
+ *
+ * @module
+ */
+import { Effect, Once, Signal } from "@norskvideo/moq-signals";
+import * as Announce from "../announced.js";
+import * as Origin from "../origin.js";
+import * as Path from "../path.js";
+import * as Time from "../time.js";
+import { accept } from "./accept.js";
+import { isWebTransportSupported } from "./browser.js";
+import { certificateHash, connect, } from "./connect.js";
+import { Reload } from "./reload.js";
+/** How long an unreferenced shared connection lingers before it actually closes. */
+const LINGER_MS = Time.Milli(2000);
+/**
+ * A cloneable handle on a MoQ connection: `new Connection({ url })` reconnects and, by
+ * default, shares one origin and one reconnect loop with every other handle on that URL.
+ *
+ * The shared {@link origin} is wired to both directions. Everything the relay announces
+ * lands in it, a publish into it is announced to the relay, and a page that publishes and
+ * watches the same path resolves it locally with no round trip.
+ *
+ * {@link close} releases this handle; the connection survives its last handle by a short
+ * linger window (see {@link ConnectionProps.linger}), so a component torn down and rebuilt
+ * reuses the warm connection instead of redialing.
+ *
+ * The loop reconnects for as long as a handle holds it, so an outage of any length recovers
+ * on its own. An auth rejection stops retrying those credentials and retires the shared
+ * connection so the next handle dials fresh; a new URL on this handle starts another
+ * sequence. {@link closed} settles only when this handle is released.
+ *
+ * Options the pool cannot honor (transport options, discovery, delay, a pinned
+ * certificate, caller-owned origins) use a private loop. An explicit `share: true`
+ * refuses them. A supplied transport cannot reconnect at all; pass it to {@link Connection.connect}
+ * instead.
+ *
+ * @public
+ */
+export class Connection {
+    /** Establish a one-shot session; a supplied transport belongs here, not in the reconnect loop. */
+    static connect = connect;
+    /** Accept a one-shot session on an already-open transport. */
+    static accept = accept;
+    /** SHA-256 of a certificate, for pinning via `webtransport.serverCertificateHashes`. */
+    static certificateHash = certificateHash;
+    /** Whether this runtime can connect with WebTransport. */
+    static isWebTransportSupported = isWebTransportSupported;
+    /** Relay URL to connect to; updating it reconnects to that URL. */
+    url;
+    /** Whether to hold a connection at all; clearing it releases this handle's share. */
+    enabled;
+    /** Current status of the connection. */
+    status;
+    /**
+     * The failure that stopped retrying the current URL, or undefined while the loop is live.
+     *
+     * Set on an auth rejection or when a private retry window expires. Cleared when a new URL
+     * or a disable/re-enable starts another sequence, not on a page hide/show.
+     */
+    error;
+    /**
+     * The wire transport the current session runs over, or undefined while disconnected.
+     *
+     * The session itself is deliberately not exposed: it is shared, so no handle may close
+     * or reconfigure it, and everything else it offers is reachable through {@link origin}.
+     */
+    transport;
+    /** The current connection's PROBE estimates, or undefined while disconnected. */
+    probe;
+    /**
+     * The send-side bandwidth allocator for the current URL, or undefined
+     * while disabled or URL-less.
+     *
+     * Every handle on this URL shares the same instance, so publishers reserve
+     * against one registry. Borrowed, not owned: the type has no close, since
+     * closing it would starve every other handle.
+     */
+    bandwidth;
+    /**
+     * The origin for the current URL, or undefined while disabled or URL-less.
+     *
+     * Publish into it or consume from it; a shared handle's origin is the same one every
+     * other handle on this URL uses, and it spans the connection's reconnects. Borrowed,
+     * not owned: the type has no close, since closing it would tear the origin down under
+     * every other handle.
+     */
+    origin;
+    /**
+     * Settles once this handle is released via {@link close}: `null` on a clean close, or
+     * the abort {@link Error}. Peek it synchronously (`undefined` while open), observe it
+     * reactively, or `await` it. Attempt failures live on {@link error} instead.
+     */
+    get closed() {
+        return this.#closed;
+    }
+    #closed = new Once();
+    #status = new Signal("disconnected");
+    #established = new Signal(undefined);
+    #probe = new Signal(undefined);
+    #origin = new Signal(undefined);
+    #bandwidth = new Signal(undefined);
+    #error = new Signal(undefined);
+    #signals;
+    /**
+     * Take a handle on the connection for {@link ConnectionProps.url}.
+     *
+     * Dials immediately when a URL is given and `enabled` is not false; otherwise waits for
+     * the signals to say go. The handle owns nothing but its own share: {@link close}
+     * releases it, and the underlying connection and origin live for as long as any handle
+     * (plus the linger window) wants them.
+     */
+    constructor(props) {
+        refuse(props);
+        this.#signals = new Effect();
+        this.url = Signal.from(props?.url);
+        this.enabled = Signal.from(props?.enabled ?? true);
+        this.status = this.#status;
+        this.error = this.#error;
+        this.probe = this.#probe;
+        this.origin = this.#origin;
+        this.bandwidth = this.#bandwidth;
+        this.transport = this.#signals.computed((effect) => effect.get(this.#established)?.transport);
+        const linger = props?.linger;
+        // Key on the serialized URL: URL objects use identity equality, and an equivalent
+        // instance must not release and redial.
+        const href = this.#signals.computed((effect) => effect.get(this.url)?.href);
+        if (props && (props.share === false || requiresPrivate(props))) {
+            this.#runPrivate(props, href);
+            return;
+        }
+        this.#signals.run((effect) => {
+            if (!effect.get(this.enabled))
+                return;
+            const key = effect.get(href);
+            if (!key)
+                return;
+            const lease = acquire(key, linger);
+            effect.cleanup(lease.release);
+            effect.set(this.#origin, lease.origin, undefined);
+            effect.set(this.#bandwidth, lease.connection.bandwidth, undefined);
+            // Proxy the shared loop's outputs, so this handle reads like its own connection.
+            effect.run((nested) => nested.set(this.#status, nested.get(lease.connection.status), "disconnected"));
+            effect.run((nested) => nested.set(this.#established, nested.get(lease.connection.established), undefined));
+            effect.run((nested) => nested.set(this.#probe, nested.get(lease.connection.probe), undefined));
+            effect.run((nested) => nested.set(this.#error, nested.get(lease.connection.error), undefined));
+        });
+    }
+    #runPrivate(props, href) {
+        const owned = props.consume === undefined;
+        const origin = props.consume ?? new Origin.Producer();
+        if (owned)
+            this.#signals.cleanup(() => origin.close());
+        const loop = new Reload({
+            url: this.url,
+            enabled: this.enabled,
+            publish: props.publish ?? (owned ? origin.consume() : undefined),
+            consume: origin,
+            webtransport: props.webtransport,
+            websocket: props.websocket,
+            discovery: props.discovery,
+            // A handle nobody watches wants unlimited retries; an auth rejection still
+            // stops this URL, and a new one starts another sequence.
+            delay: { timeout: Time.Milli(0), ...props.delay },
+        });
+        this.#signals.cleanup(() => loop.close());
+        this.#signals.run((effect) => {
+            if (!effect.get(this.enabled) || !effect.get(href))
+                return;
+            effect.set(this.#origin, origin, undefined);
+            effect.set(this.#bandwidth, loop.bandwidth, undefined);
+        });
+        this.#signals.run((effect) => effect.set(this.#status, effect.get(loop.status), "disconnected"));
+        this.#signals.run((effect) => effect.set(this.#established, effect.get(loop.established), undefined));
+        this.#signals.run((effect) => effect.set(this.#probe, effect.get(loop.probe), undefined));
+        this.#signals.run((effect) => effect.set(this.#error, effect.get(loop.error), undefined));
+    }
+    /**
+     * Subscribe to broadcast announcements matching `scope`, spanning reconnects
+     * and URL switches: a switch retracts everything from
+     * the old relay's origin, then the new one's arrivals stream in.
+     */
+    announced(scope = Path.Pattern.all(), options) {
+        const producer = new Announce.Producer();
+        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;
+        });
+        // A child of this handle's scope rather than a standalone Effect it merely cleans up
+        // after: the disposer run() hands back also drops itself from the parent, so opening
+        // and closing announcement streams repeatedly does not pile up dead pumps that live
+        // until the whole handle closes.
+        const stop = this.#signals.run((effect) => {
+            const origin = effect.get(this.#origin);
+            if (!origin)
+                return;
+            const upstream = origin.announced(scope, options);
+            effect.cleanup(() => upstream.close());
+            // Track what this origin announced so a URL switch retracts it; the last
+            // event rides along for the retraction.
+            const active = new Map();
+            effect.spawn(async () => {
+                try {
+                    for (;;) {
+                        const entry = await effect.race(upstream.next());
+                        if (!entry)
+                            break;
+                        if (Announce.isActive(entry.kind))
+                            active.set(entry.prefix, entry);
+                        else
+                            active.delete(entry.prefix);
+                        producer.append(entry);
+                    }
+                }
+                finally {
+                    if (!closed) {
+                        for (const entry of active.values()) {
+                            producer.append({ ...entry, kind: "retracted" });
+                        }
+                    }
+                }
+            });
+        });
+        void consumer.closed.then(stop);
+        return consumer;
+    }
+    /** Snapshot the live connection's transport counters, or undefined while disconnected. */
+    async stats() {
+        return this.#established.peek()?.stats();
+    }
+    /**
+     * Release this handle. The shared connection closes once its last handle is gone and
+     * the linger window passes; other handles on the URL are unaffected. Idempotent.
+     */
+    close(abort) {
+        this.#signals.close();
+        if (this.#closed.peek() === undefined)
+            this.#closed.set(abort ?? null);
+    }
+}
+/** Throw if `props` cannot be honored, rather than silently dropping them. */
+function refuse(props) {
+    if (!props)
+        return;
+    const extra = props;
+    if (extra.transport) {
+        throw new Error("a supplied transport cannot reconnect; call Connection.connect() instead");
+    }
+    if (extra.signal) {
+        throw new Error("a Connection owns its abort signal; do not pass one");
+    }
+    if (props.share !== true || !requiresPrivate(props))
+        return;
+    if (props.publish || props.consume) {
+        throw new Error("caller-owned origins cannot be shared; pass share: false");
+    }
+    const hashes = props.webtransport?.serverCertificateHashes?.length ?? 0;
+    if (props.webtransport?.serverCertificate !== undefined || hashes > 0) {
+        throw new Error("a pinned certificate cannot be shared; pass share: false");
+    }
+    if (props.webtransport !== undefined) {
+        throw new Error("webtransport options cannot be shared; pass share: false");
+    }
+    if (props.websocket !== undefined) {
+        throw new Error("websocket options cannot be shared; pass share: false");
+    }
+    if (props.discovery !== undefined) {
+        throw new Error("discovery cannot be shared; pass share: false");
+    }
+    if (props.delay !== undefined) {
+        throw new Error("delay cannot be shared; pass share: false");
+    }
+}
+/** Options tied to one handle cannot be represented by a URL-keyed shared entry. */
+function requiresPrivate(props) {
+    return (props.webtransport !== undefined ||
+        props.websocket !== undefined ||
+        props.discovery !== undefined ||
+        props.delay !== undefined ||
+        props.publish !== undefined ||
+        props.consume !== undefined);
+}
+/** The process-wide pool backing {@link Connection}. */
+const pool = new Map();
+/** Take a reference on the shared entry for `key`, creating it on first use. */
+function acquire(key, linger) {
+    let entry = pool.get(key);
+    if (!entry) {
+        const origin = new Origin.Producer();
+        const connection = new Reload({
+            url: new URL(key),
+            enabled: true,
+            publish: origin.consume(),
+            consume: origin,
+            // Nobody observes a shared loop's `closed`, so giving up would strand every handle
+            // on this URL offline until the page reloads. Retry for as long as the entry lives
+            // instead; an auth rejection still stops this URL, and evicts below.
+            delay: { timeout: Time.Milli(0) },
+        });
+        const created = { origin, connection, refs: 0, linger: linger ?? LINGER_MS };
+        // The loop only stops on a peer saying these credentials will never work. Drop the
+        // entry so a later handle dials fresh rather than joining a loop that has stopped;
+        // handles already on it keep it until they release, since a redial would be refused
+        // the same way.
+        connection.error.subscribe((err) => {
+            if (err !== undefined && pool.get(key) === created)
+                pool.delete(key);
+        });
+        entry = created;
+        pool.set(key, created);
+    }
+    const taken = entry;
+    taken.linger = Time.Milli(Math.max(taken.linger, linger ?? LINGER_MS));
+    taken.refs += 1;
+    if (taken.timer !== undefined) {
+        clearTimeout(taken.timer);
+        taken.timer = undefined;
+    }
+    let released = false;
+    return {
+        ...taken,
+        release: () => {
+            if (released)
+                return;
+            released = true;
+            taken.refs -= 1;
+            if (taken.refs > 0)
+                return;
+            taken.timer = setTimeout(() => {
+                if (pool.get(key) === taken)
+                    pool.delete(key);
+                taken.connection.close();
+                taken.origin.close();
+            }, taken.linger);
+            // Don't hold a Node process open for a connection nobody is using.
+            taken.timer.unref?.();
+        },
+    };
+}
+/**
+ * Close every shared connection immediately, so the next handle dials fresh.
+ *
+ * Exists for tests, which otherwise share connections across cases.
+ *
+ * @internal
+ */
+export function resetShared() {
+    const entries = [...pool.values()];
+    pool.clear();
+    for (const entry of entries) {
+        if (entry.timer !== undefined)
+            clearTimeout(entry.timer);
+        entry.connection.close();
+        entry.origin.close();
+    }
+}
+//# sourceMappingURL=pool.js.map

package/connection/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/connection/pool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A reconnecting, shareable connection: one origin and one reconnect loop per relay URL.\n *\n * @module\n */\nimport { Effect, type GetPromise, type Getter, Once, Signal } from \"@moq/signals\";\nimport * as Announce from \"../announced.ts\";\nimport type { Handle } from \"../bandwidth.ts\";\nimport * as Origin from \"../origin.ts\";\nimport * as Path from \"../path.ts\";\nimport * as Time from \"../time.ts\";\nimport { type AcceptProps as AcceptPropsType, accept } from \"./accept.ts\";\nimport { isWebTransportSupported } from \"./browser.ts\";\nimport {\n\ttype CertificateHash as CertificateHashType,\n\ttype ConnectProps as ConnectPropsType,\n\tcertificateHash,\n\tconnect,\n\ttype WebSocketProps as WebSocketPropsType,\n\ttype WebTransportProps as WebTransportPropsType,\n} from \"./connect.ts\";\nimport type { Established as EstablishedType } from \"./established.ts\";\nimport { Reload, type ReloadDelay, type ReloadStatus } from \"./reload.ts\";\nimport type { Probe as ProbeType, Stats as StatsType } from \"./stats.ts\";\nimport type { Transport as TransportType } from \"./transport.ts\";\n\n/** How long an unreferenced shared connection lingers before it actually closes. */\nconst LINGER_MS = Time.Milli(2000);\n\n/** Options for {@link Connection}. */\nexport interface ConnectionProps {\n\t/** The relay to connect to; pass a `Signal` to switch relays live. */\n\turl?: URL | Signal<URL | undefined>;\n\n\t/** Whether to connect at all (default: true); pass a `Signal` to toggle live. */\n\tenabled?: boolean | Signal<boolean>;\n\n\t/**\n\t * How long the underlying connection outlives its last handle (default: 2000ms).\n\t *\n\t * The window is what makes moving an element around the DOM free: the connection and\n\t * everything it discovered are still warm when the new owner asks for them. The longest\n\t * linger requested by any handle sharing the connection wins.\n\t */\n\tlinger?: Time.Milli;\n\n\t/**\n\t * Share a pooled transport keyed on the URL. By default, options specific to this\n\t * handle use a private reconnect loop; otherwise connections share by URL.\n\t * Explicit `true` refuses options a pool cannot honor.\n\t */\n\tshare?: boolean;\n\n\t/** WebTransport options applied to each connection attempt (not reactive). */\n\twebtransport?: WebTransportPropsType;\n\n\t/** WebSocket fallback options applied to each connection attempt (not reactive). */\n\twebsocket?: WebSocketPropsType;\n\n\t/** Whether the relay supports broadcast discovery. */\n\tdiscovery?: boolean;\n\n\t/** The origin whose broadcasts are served, spanning reconnects. Implies a private loop. */\n\tpublish?: Origin.Consumer;\n\n\t/** The origin fed with the peer's announced broadcasts, spanning reconnects. Implies a private loop. */\n\tconsume?: Origin.Producer;\n\n\t/** Backoff settings for the reconnect loop; an unset field uses its default. */\n\tdelay?: ReloadDelay;\n\n\t/** A Connection owns the abort signal for each connection attempt. */\n\tsignal?: never;\n\n\t/** A one-shot transport cannot be reused by the reconnect loop; call {@link Connection.connect} instead. */\n\ttransport?: never;\n}\n\n/**\n * A cloneable handle on a MoQ connection: `new Connection({ url })` reconnects and, by\n * default, shares one origin and one reconnect loop with every other handle on that URL.\n *\n * The shared {@link origin} is wired to both directions. Everything the relay announces\n * lands in it, a publish into it is announced to the relay, and a page that publishes and\n * watches the same path resolves it locally with no round trip.\n *\n * {@link close} releases this handle; the connection survives its last handle by a short\n * linger window (see {@link ConnectionProps.linger}), so a component torn down and rebuilt\n * reuses the warm connection instead of redialing.\n *\n * The loop reconnects for as long as a handle holds it, so an outage of any length recovers\n * on its own. An auth rejection stops retrying those credentials and retires the shared\n * connection so the next handle dials fresh; a new URL on this handle starts another\n * sequence. {@link closed} settles only when this handle is released.\n *\n * Options the pool cannot honor (transport options, discovery, delay, a pinned\n * certificate, caller-owned origins) use a private loop. An explicit `share: true`\n * refuses them. A supplied transport cannot reconnect at all; pass it to {@link Connection.connect}\n * instead.\n *\n * @public\n */\nexport class Connection {\n\t/** Establish a one-shot session; a supplied transport belongs here, not in the reconnect loop. */\n\tstatic readonly connect = connect;\n\n\t/** Accept a one-shot session on an already-open transport. */\n\tstatic readonly accept = accept;\n\n\t/** SHA-256 of a certificate, for pinning via `webtransport.serverCertificateHashes`. */\n\tstatic readonly certificateHash = certificateHash;\n\n\t/** Whether this runtime can connect with WebTransport. */\n\tstatic readonly isWebTransportSupported = isWebTransportSupported;\n\n\t/** Relay URL to connect to; updating it reconnects to that URL. */\n\turl: Signal<URL | undefined>;\n\n\t/** Whether to hold a connection at all; clearing it releases this handle's share. */\n\tenabled: Signal<boolean>;\n\n\t/** Current status of the connection. */\n\treadonly status: Getter<ReloadStatus>;\n\n\t/**\n\t * The failure that stopped retrying the current URL, or undefined while the loop is live.\n\t *\n\t * Set on an auth rejection or when a private retry window expires. Cleared when a new URL\n\t * or a disable/re-enable starts another sequence, not on a page hide/show.\n\t */\n\treadonly error: Getter<Error | undefined>;\n\n\t/**\n\t * The wire transport the current session runs over, or undefined while disconnected.\n\t *\n\t * The session itself is deliberately not exposed: it is shared, so no handle may close\n\t * or reconfigure it, and everything else it offers is reachable through {@link origin}.\n\t */\n\treadonly transport: Getter<TransportType | undefined>;\n\n\t/** The current connection's PROBE estimates, or undefined while disconnected. */\n\treadonly probe: Getter<ProbeType | undefined>;\n\n\t/**\n\t * The send-side bandwidth allocator for the current URL, or undefined\n\t * while disabled or URL-less.\n\t *\n\t * Every handle on this URL shares the same instance, so publishers reserve\n\t * against one registry. Borrowed, not owned: the type has no close, since\n\t * closing it would starve every other handle.\n\t */\n\treadonly bandwidth: Getter<Handle | undefined>;\n\n\t/**\n\t * The origin for the current URL, or undefined while disabled or URL-less.\n\t *\n\t * Publish into it or consume from it; a shared handle's origin is the same one every\n\t * other handle on this URL uses, and it spans the connection's reconnects. Borrowed,\n\t * not owned: the type has no close, since closing it would tear the origin down under\n\t * every other handle.\n\t */\n\treadonly origin: Getter<Origin.Table | undefined>;\n\n\t/**\n\t * Settles once this handle is released via {@link close}: `null` on a clean close, or\n\t * the abort {@link Error}. Peek it synchronously (`undefined` while open), observe it\n\t * reactively, or `await` it. Attempt failures live on {@link error} instead.\n\t */\n\tget closed(): GetPromise<Error | null> {\n\t\treturn this.#closed;\n\t}\n\n\t#closed = new Once<Error | null>();\n\treadonly #status = new Signal<ReloadStatus>(\"disconnected\");\n\treadonly #established = new Signal<EstablishedType | undefined>(undefined);\n\treadonly #probe = new Signal<ProbeType | undefined>(undefined);\n\treadonly #origin = new Signal<Origin.Producer | undefined>(undefined);\n\treadonly #bandwidth = new Signal<Handle | undefined>(undefined);\n\treadonly #error = new Signal<Error | undefined>(undefined);\n\t#signals: Effect;\n\n\t/**\n\t * Take a handle on the connection for {@link ConnectionProps.url}.\n\t *\n\t * Dials immediately when a URL is given and `enabled` is not false; otherwise waits for\n\t * the signals to say go. The handle owns nothing but its own share: {@link close}\n\t * releases it, and the underlying connection and origin live for as long as any handle\n\t * (plus the linger window) wants them.\n\t */\n\tconstructor(props?: ConnectionProps) {\n\t\trefuse(props);\n\t\tthis.#signals = new Effect();\n\n\t\tthis.url = Signal.from(props?.url);\n\t\tthis.enabled = Signal.from(props?.enabled ?? true);\n\t\tthis.status = this.#status;\n\t\tthis.error = this.#error;\n\t\tthis.probe = this.#probe;\n\t\tthis.origin = this.#origin;\n\t\tthis.bandwidth = this.#bandwidth;\n\t\tthis.transport = this.#signals.computed((effect) => effect.get(this.#established)?.transport);\n\n\t\tconst linger = props?.linger;\n\n\t\t// Key on the serialized URL: URL objects use identity equality, and an equivalent\n\t\t// instance must not release and redial.\n\t\tconst href = this.#signals.computed((effect) => effect.get(this.url)?.href);\n\n\t\tif (props && (props.share === false || requiresPrivate(props))) {\n\t\t\tthis.#runPrivate(props, href);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.#signals.run((effect) => {\n\t\t\tif (!effect.get(this.enabled)) return;\n\t\t\tconst key = effect.get(href);\n\t\t\tif (!key) return;\n\n\t\t\tconst lease = acquire(key, linger);\n\t\t\teffect.cleanup(lease.release);\n\n\t\t\teffect.set(this.#origin, lease.origin, undefined);\n\t\t\teffect.set(this.#bandwidth, lease.connection.bandwidth, undefined);\n\n\t\t\t// Proxy the shared loop's outputs, so this handle reads like its own connection.\n\t\t\teffect.run((nested) => nested.set(this.#status, nested.get(lease.connection.status), \"disconnected\"));\n\t\t\teffect.run((nested) => nested.set(this.#established, nested.get(lease.connection.established), undefined));\n\t\t\teffect.run((nested) => nested.set(this.#probe, nested.get(lease.connection.probe), undefined));\n\t\t\teffect.run((nested) => nested.set(this.#error, nested.get(lease.connection.error), undefined));\n\t\t});\n\t}\n\n\t#runPrivate(props: ConnectionProps, href: Getter<string | undefined>): void {\n\t\tconst owned = props.consume === undefined;\n\t\tconst origin = props.consume ?? new Origin.Producer();\n\t\tif (owned) this.#signals.cleanup(() => origin.close());\n\n\t\tconst loop = new Reload({\n\t\t\turl: this.url,\n\t\t\tenabled: this.enabled,\n\t\t\tpublish: props.publish ?? (owned ? origin.consume() : undefined),\n\t\t\tconsume: origin,\n\t\t\twebtransport: props.webtransport,\n\t\t\twebsocket: props.websocket,\n\t\t\tdiscovery: props.discovery,\n\t\t\t// A handle nobody watches wants unlimited retries; an auth rejection still\n\t\t\t// stops this URL, and a new one starts another sequence.\n\t\t\tdelay: { timeout: Time.Milli(0), ...props.delay },\n\t\t});\n\t\tthis.#signals.cleanup(() => loop.close());\n\n\t\tthis.#signals.run((effect) => {\n\t\t\tif (!effect.get(this.enabled) || !effect.get(href)) return;\n\t\t\teffect.set(this.#origin, origin, undefined);\n\t\t\teffect.set(this.#bandwidth, loop.bandwidth, undefined);\n\t\t});\n\t\tthis.#signals.run((effect) => effect.set(this.#status, effect.get(loop.status), \"disconnected\"));\n\t\tthis.#signals.run((effect) => effect.set(this.#established, effect.get(loop.established), undefined));\n\t\tthis.#signals.run((effect) => effect.set(this.#probe, effect.get(loop.probe), undefined));\n\t\tthis.#signals.run((effect) => effect.set(this.#error, effect.get(loop.error), undefined));\n\t}\n\n\t/**\n\t * Subscribe to broadcast announcements matching `scope`, spanning reconnects\n\t * and URL switches: a switch retracts everything from\n\t * the old relay's origin, then the new one's arrivals stream in.\n\t */\n\tannounced(scope: Path.Pattern = Path.Pattern.all(), options?: Announce.Options): Announce.Consumer {\n\t\tconst producer = new Announce.Producer();\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\t// A child of this handle's scope rather than a standalone Effect it merely cleans up\n\t\t// after: the disposer run() hands back also drops itself from the parent, so opening\n\t\t// and closing announcement streams repeatedly does not pile up dead pumps that live\n\t\t// until the whole handle closes.\n\t\tconst stop = this.#signals.run((effect) => {\n\t\t\tconst origin = effect.get(this.#origin);\n\t\t\tif (!origin) return;\n\n\t\t\tconst upstream = origin.announced(scope, options);\n\t\t\teffect.cleanup(() => upstream.close());\n\n\t\t\t// Track what this origin announced so a URL switch retracts it; the last\n\t\t\t// event rides along for the retraction.\n\t\t\tconst active = new Map<Path.Valid, Announce.Update>();\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 effect.race(upstream.next());\n\t\t\t\t\t\tif (!entry) break;\n\t\t\t\t\t\tif (Announce.isActive(entry.kind)) active.set(entry.prefix, entry);\n\t\t\t\t\t\telse active.delete(entry.prefix);\n\t\t\t\t\t\tproducer.append(entry);\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tif (!closed) {\n\t\t\t\t\t\tfor (const entry of active.values()) {\n\t\t\t\t\t\t\tproducer.append({ ...entry, kind: \"retracted\" });\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\tvoid consumer.closed.then(stop);\n\n\t\treturn consumer;\n\t}\n\n\t/** Snapshot the live connection's transport counters, or undefined while disconnected. */\n\tasync stats(): Promise<StatsType | undefined> {\n\t\treturn this.#established.peek()?.stats();\n\t}\n\n\t/**\n\t * Release this handle. The shared connection closes once its last handle is gone and\n\t * the linger window passes; other handles on the URL are unaffected. Idempotent.\n\t */\n\tclose(abort?: Error): void {\n\t\tthis.#signals.close();\n\t\tif (this.#closed.peek() === undefined) this.#closed.set(abort ?? null);\n\t}\n}\n\n/** Types on {@link Connection}: the handle is the class, these are its associated types. */\nexport namespace Connection {\n\t/** Options for {@link Connection}. */\n\texport type Props = ConnectionProps;\n\t/** Options for {@link Connection.connect}. */\n\texport type ConnectProps = ConnectPropsType;\n\t/** Options for {@link Connection.accept}. */\n\texport type AcceptProps = AcceptPropsType;\n\t/** Backoff settings for a private reconnect loop. */\n\texport type Backoff = ReloadDelay;\n\t/** Current state of a {@link Connection}. */\n\texport type Status = ReloadStatus;\n\t/** The current connection's PROBE estimates. */\n\texport type Probe = ProbeType;\n\t/** A point-in-time snapshot of the transport's counters. */\n\texport type Stats = StatsType;\n\t/** The wire transport a session runs over. */\n\texport type Transport = TransportType;\n\t/** Tuning for the WebSocket fallback. */\n\texport type WebSocketProps = WebSocketPropsType;\n\t/** WebTransport options, including friendlier certificate pinning. */\n\texport type WebTransportProps = WebTransportPropsType;\n\t/** A server certificate hash used to pin a self-signed server. */\n\texport type CertificateHash = CertificateHashType;\n\t/** An established one-shot session. */\n\texport type Established = EstablishedType;\n}\n\n/** Throw if `props` cannot be honored, rather than silently dropping them. */\nfunction refuse(props?: ConnectionProps): void {\n\tif (!props) return;\n\n\tconst extra = props as ConnectionProps & { transport?: unknown; signal?: unknown };\n\tif (extra.transport) {\n\t\tthrow new Error(\"a supplied transport cannot reconnect; call Connection.connect() instead\");\n\t}\n\tif (extra.signal) {\n\t\tthrow new Error(\"a Connection owns its abort signal; do not pass one\");\n\t}\n\tif (props.share !== true || !requiresPrivate(props)) return;\n\n\tif (props.publish || props.consume) {\n\t\tthrow new Error(\"caller-owned origins cannot be shared; pass share: false\");\n\t}\n\tconst hashes = props.webtransport?.serverCertificateHashes?.length ?? 0;\n\tif (props.webtransport?.serverCertificate !== undefined || hashes > 0) {\n\t\tthrow new Error(\"a pinned certificate cannot be shared; pass share: false\");\n\t}\n\tif (props.webtransport !== undefined) {\n\t\tthrow new Error(\"webtransport options cannot be shared; pass share: false\");\n\t}\n\tif (props.websocket !== undefined) {\n\t\tthrow new Error(\"websocket options cannot be shared; pass share: false\");\n\t}\n\tif (props.discovery !== undefined) {\n\t\tthrow new Error(\"discovery cannot be shared; pass share: false\");\n\t}\n\tif (props.delay !== undefined) {\n\t\tthrow new Error(\"delay cannot be shared; pass share: false\");\n\t}\n}\n\n/** Options tied to one handle cannot be represented by a URL-keyed shared entry. */\nfunction requiresPrivate(props: ConnectionProps): boolean {\n\treturn (\n\t\tprops.webtransport !== undefined ||\n\t\tprops.websocket !== undefined ||\n\t\tprops.discovery !== undefined ||\n\t\tprops.delay !== undefined ||\n\t\tprops.publish !== undefined ||\n\t\tprops.consume !== undefined\n\t);\n}\n\n/** One shared connection and the handles keeping it alive. */\ninterface Entry {\n\torigin: Origin.Producer;\n\tconnection: Reload;\n\trefs: number;\n\tlinger: Time.Milli;\n\ttimer?: ReturnType<typeof setTimeout>;\n}\n\n/** The process-wide pool backing {@link Connection}. */\nconst pool = new Map<string, Entry>();\n\n/** Take a reference on the shared entry for `key`, creating it on first use. */\nfunction acquire(key: string, linger?: Time.Milli): Entry & { release: () => void } {\n\tlet entry = pool.get(key);\n\tif (!entry) {\n\t\tconst origin = new Origin.Producer();\n\t\tconst connection = new Reload({\n\t\t\turl: new URL(key),\n\t\t\tenabled: true,\n\t\t\tpublish: origin.consume(),\n\t\t\tconsume: origin,\n\t\t\t// Nobody observes a shared loop's `closed`, so giving up would strand every handle\n\t\t\t// on this URL offline until the page reloads. Retry for as long as the entry lives\n\t\t\t// instead; an auth rejection still stops this URL, and evicts below.\n\t\t\tdelay: { timeout: Time.Milli(0) },\n\t\t});\n\n\t\tconst created: Entry = { origin, connection, refs: 0, linger: linger ?? LINGER_MS };\n\n\t\t// The loop only stops on a peer saying these credentials will never work. Drop the\n\t\t// entry so a later handle dials fresh rather than joining a loop that has stopped;\n\t\t// handles already on it keep it until they release, since a redial would be refused\n\t\t// the same way.\n\t\tconnection.error.subscribe((err) => {\n\t\t\tif (err !== undefined && pool.get(key) === created) pool.delete(key);\n\t\t});\n\n\t\tentry = created;\n\t\tpool.set(key, created);\n\t}\n\n\tconst taken = entry;\n\ttaken.linger = Time.Milli(Math.max(taken.linger, linger ?? LINGER_MS));\n\ttaken.refs += 1;\n\tif (taken.timer !== undefined) {\n\t\tclearTimeout(taken.timer);\n\t\ttaken.timer = undefined;\n\t}\n\n\tlet released = false;\n\treturn {\n\t\t...taken,\n\t\trelease: () => {\n\t\t\tif (released) return;\n\t\t\treleased = true;\n\n\t\t\ttaken.refs -= 1;\n\t\t\tif (taken.refs > 0) return;\n\n\t\t\ttaken.timer = setTimeout(() => {\n\t\t\t\tif (pool.get(key) === taken) pool.delete(key);\n\t\t\t\ttaken.connection.close();\n\t\t\t\ttaken.origin.close();\n\t\t\t}, taken.linger);\n\n\t\t\t// Don't hold a Node process open for a connection nobody is using.\n\t\t\t(taken.timer as { unref?: () => void }).unref?.();\n\t\t},\n\t};\n}\n\n/**\n * Close every shared connection immediately, so the next handle dials fresh.\n *\n * Exists for tests, which otherwise share connections across cases.\n *\n * @internal\n */\nexport function resetShared(): void {\n\tconst entries = [...pool.values()];\n\tpool.clear();\n\tfor (const entry of entries) {\n\t\tif (entry.timer !== undefined) clearTimeout(entry.timer);\n\t\tentry.connection.close();\n\t\tentry.origin.close();\n\t}\n}\n"]}