@norskvideo/moq-net 0.1.7 → 0.2.0

package/error.js

@@ -1,41 +1,209 @@
 /* @ts-self-types="./error.d.ts" */
 /**
- * Errors, including the code a peer reports when it resets a stream.
+ * Errors, including the code a peer reports when it resets a stream or closes the session.
  *
  * @module
  */
+import { sharedStreamCode } from "./ietf/error.js";
+import { TimeoutError } from "./util/timeout.js";
 /**
- * An error the peer reported by resetting a stream, carrying the raw code it sent.
+ * Codes a peer sends when terminating the session, mirroring the Rust `Session`.
  *
- * The codes are not standardized, so this deliberately does not translate one into a local
- * error: the number means whatever the peer's implementation says it means. A read or write
- * rejects with this on every transport, so branch on {@link code} rather than feature-detecting
+ * Specified by moq-lite, which reuses moq-transport's codes unchanged. Call `SessionCode(code)`
+ * to construct an application code in the 64+ range. {@link StreamCode} is the other registry,
+ * and the two are disjoint, so the same integer means different things in each.
+ *
+ * Codes 32-47 are reserved: nothing is sent there, and the draft gives a received one no
+ * meaning, so treat anything not listed below as an unspecified error rather than guessing.
+ *
+ * @public
+ */
+export const SessionCode = Object.freeze(Object.assign((code) => applicationCode(code), {
+    /** Ending the session normally, with no error. */
+    Cancel: 0x0,
+    /** Something went wrong that isn't worth a dedicated code. */
+    Internal: 0x1,
+    /** The credentials don't grant the requested path or operation. Retrying will fail again. */
+    Unauthorized: 0x2,
+    /** A protocol rule was broken; the session is unusable. */
+    ProtocolViolation: 0x3,
+    /** A key-value pair was malformed or repeated more than allowed. */
+    KeyValueFormatting: 0x6,
+    /** The peer did not close within the GOAWAY drain deadline. */
+    GoawayTimeout: 0x10,
+    /** A control message took too long. */
+    Timeout: 0x11,
+    /** No version could be negotiated. */
+    Version: 0x15,
+}));
+/**
+ * Codes a peer sends when resetting a stream, mirroring the Rust `Stream`.
+ *
+ * The counterpart to {@link SessionCode}, and a disjoint space: a stream reset of 0 is
+ * {@link StreamCode.Internal}, not a cancellation ({@link StreamCode.Cancel} is 1). Call
+ * `StreamCode(code)` to construct an application code in the 64+ range.
+ *
+ * Conditions the shared codes don't cover are assigned in moq-lite's own 48-63 range, so a
+ * received one is the named code. 32 through 47 is reserved: nothing is sent there and a
+ * received one is an unspecified error.
+ *
+ * @public
+ */
+export const StreamCode = Object.freeze(Object.assign((code) => applicationCode(code), {
+    /** Something went wrong that isn't worth a dedicated code. */
+    Internal: 0x0,
+    /** The sender is done with this stream, not failing. A routine unsubscribe. */
+    Cancel: 0x1,
+    /** The content missed its delivery deadline. */
+    DeliveryTimeout: 0x2,
+    /** The session ended, taking this stream with it. */
+    SessionClosed: 0x3,
+    /** The session is going away (a GOAWAY was received). */
+    GoingAway: 0x4,
+    /** The reader fell too far behind and content was dropped to catch up. */
+    TooFarBehind: 0x5,
+    /** The track's content could not be parsed. */
+    MalformedTrack: 0x12,
+    /** The peer took too long to answer a control request. */
+    ControlTimeout: 0x31,
+    /** The requested broadcast or track does not exist at the peer. */
+    NotFound: 0x33,
+    /** The group was superseded by a newer one and dropped. */
+    Old: 0x34,
+    /** The group was dropped under memory pressure, so it can be re-fetched. */
+    Evicted: 0x35,
+    /** A frame declared a payload larger than the receiver accepts. */
+    FrameTooLarge: 0x38,
+    /** The publisher could serve this request but has no capacity for it now. */
+    NoCapacity: 0x30,
+    /** A group grew past its cache budget and was aborted. */
+    GroupTooLarge: 0x32,
+}));
+function applicationCode(code) {
+    if (!Number.isInteger(code) || code < 64 || code > 0xffffffff) {
+        throw new RangeError(`invalid application error code: ${code}`);
+    }
+    return code;
+}
+/**
+ * An error the peer reported by closing the session, carrying its {@link SessionCode}.
+ *
+ * This surfaces on every transport, so catch this type rather than feature-detecting
  * `WebTransportError`, which a non-browser runtime never defines and the WebSocket fallback
  * never throws.
  *
- * Code 0 is what a transport sends when a stream is dropped or aborted with no code of its own.
+ * ```ts
+ * connection.error.subscribe((err) => {
+ *   if (err instanceof Session && err.code === SessionCode.Unauthorized) {
+ *     console.warn("server rejected the session");
+ *   }
+ * });
+ * ```
+ *
+ * @public
+ */
+export class Session extends Error {
+    /** The session code the peer sent, verbatim. */
+    code;
+    constructor(code, options) {
+        super(options?.reason ? `remote error: ${code} (${options.reason})` : `remote error: ${code}`, options);
+        this.name = "Session";
+        this.code = code;
+    }
+}
+/**
+ * An error carrying a {@link StreamCode}: the code a peer sent when it reset a stream, or the
+ * one this side sends when it resets one.
+ *
+ * This surfaces on every transport, so catch this type rather than feature-detecting
+ * `WebTransportError`, which a non-browser runtime never defines and the WebSocket fallback
+ * never throws. Local conditions with a code of their own subclass it ({@link TooFarBehind},
+ * {@link FrameTooLarge}, {@link GroupTooLarge}, {@link NotFound}), so the same `code` check catches a condition
+ * whether it was raised here or reported by the peer.
  *
  * ```ts
  * try {
  *   frame = await group.readFrame();
  * } catch (err) {
- *   // Whatever this peer's code 2 means to it.
- *   if (err instanceof RemoteError && err.code === 2) return;
+ *   if (err instanceof Stream && err.code === StreamCode.Cancel) return;
  *   throw err;
  * }
  * ```
  *
  * @public
  */
-export class RemoteError extends Error {
-    /** The code the peer sent, verbatim. */
+export class Stream extends Error {
+    /** The stream code; moq-lite resets forward it verbatim. */
     code;
     constructor(code, options) {
-        super(`remote error: ${code}`, options);
-        this.name = "RemoteError";
+        super(options?.message ??
+            (options?.reason ? `remote error: ${code} (${options.reason})` : `remote error: ${code}`), options);
+        this.name = "Stream";
         this.code = code;
     }
 }
+/**
+ * The reader asked for a frame the group never held, so the stream has a gap.
+ *
+ * Raised locally by a frame read, and decoded from a moq-lite peer's `TOO_FAR_BEHIND` reset, since a gap
+ * reads the same either way.
+ *
+ * @public
+ */
+export class TooFarBehind extends Stream {
+    constructor(options) {
+        super(StreamCode.TooFarBehind, {
+            ...options,
+            message: "lagged: frames were evicted before being read",
+        });
+        this.name = "TooFarBehind";
+    }
+}
+/**
+ * A frame is larger than a group can cache, so appending it would exceed the budget by itself.
+ *
+ * Raised locally by a frame write, and decoded from a moq-lite peer's `FRAME_TOO_LARGE` reset.
+ * Mirrors the Rust `Error::FrameTooLarge`, which rejects the same frame before touching any state.
+ *
+ * @public
+ */
+export class FrameTooLarge extends Stream {
+    constructor(options) {
+        super(StreamCode.FrameTooLarge, {
+            ...options,
+            message: "frame too large: larger than a group can cache",
+        });
+        this.name = "FrameTooLarge";
+    }
+}
+/**
+ * A write grew the group past its cache budget, so the group is aborted.
+ *
+ * Raised locally by a frame write, and decoded from a moq-lite peer's `GROUP_TOO_LARGE`
+ * reset. Mirrors the Rust `Error::GroupTooLarge`.
+ *
+ * @public
+ */
+export class GroupTooLarge extends Stream {
+    constructor(options) {
+        super(StreamCode.GroupTooLarge, {
+            ...options,
+            message: "group too large: exceeded the cache budget",
+        });
+        this.name = "GroupTooLarge";
+    }
+}
+/**
+ * The requested broadcast or track is not served here.
+ *
+ * @public
+ */
+export class NotFound extends Stream {
+    constructor(what, options) {
+        super(StreamCode.NotFound, { ...options, message: `not found: ${what}` });
+        this.name = "NotFound";
+    }
+}
 /**
  * A peer broke the protocol in a way the spec says must end the session.
  *
@@ -43,7 +211,7 @@ export class RemoteError extends Error {
  * to close. The dispatch that owns the session watches for it and closes, so a nonconforming
  * peer cannot repeat the violation on the next stream.
  *
- * @internal
+ * @public
  */
 export class ProtocolViolation extends Error {
     constructor(message, options) {
@@ -51,6 +219,8 @@ export class ProtocolViolation extends Error {
         this.name = "ProtocolViolation";
     }
 }
+/** Package-internal compatibility names used by the wire implementation. */
+export { Session as SessionError, Stream as StreamError, TooFarBehind as Lagged };
 function streamCode(err) {
     if (typeof err !== "object" || err === null)
         return undefined;
@@ -60,20 +230,165 @@ function streamCode(err) {
     return streamErrorCode;
 }
 /**
- * Decode a transport failure into a {@link RemoteError} error when it carries a stream reset code,
+ * Which {@link StreamCode} to send when resetting a stream because of `err`.
+ *
+ * The counterpart to {@link fromTransport}, and the pair has to agree: a code we send for a
+ * condition is the code we read that condition back from, or two peers disagree about what it
+ * means. Mirrors the Rust `From<&Error> for Stream`.
+ *
+ * Lossy on purpose. An error describes what went wrong here, while the registry is what the peer
+ * can act on, so anything without a code of its own degrades to {@link StreamCode.Internal}
+ * rather than inventing one. A {@link Session} lands there too: the two registries are
+ * disjoint, so forwarding its code onto a stream would mistranslate it.
+ *
+ * On an IETF stream the code has to be one the negotiated draft assigns the same meaning to,
+ * so a condition it does not register degrades to INTERNAL_ERROR as well. See
+ * {@link sharedStreamCode}.
+ *
+ * @internal
+ */
+export function toStreamCode(err, options) {
+    const code = localStreamCode(err);
+    if (options?.version === undefined)
+        return code;
+    return sharedStreamCode(code, options.version) ? code : StreamCode.Internal;
+}
+/** The moq-lite code for a local failure, before any draft has a say. */
+function localStreamCode(err) {
+    if (err instanceof Stream)
+        return err.code;
+    if (err instanceof TimeoutError)
+        return StreamCode.DeliveryTimeout;
+    // Session-scoped: the peer learns which rule it broke from the session close, not from here.
+    if (err instanceof ProtocolViolation)
+        return StreamCode.SessionClosed;
+    return StreamCode.Internal;
+}
+/**
+ * The {@link StreamCode.ControlTimeout} error for a control request the peer never answered.
+ *
+ * A control request that outlives its deadline is not late content, so it does not go out as
+ * {@link StreamCode.DeliveryTimeout} the way a bare {@link TimeoutError} would. Callers that
+ * bound a request's response build this instead.
+ *
+ * @internal
+ */
+export function controlTimeout(cause) {
+    const message = cause instanceof Error && cause.message ? cause.message : "control request timed out";
+    return new Stream(StreamCode.ControlTimeout, { cause, message });
+}
+/**
+ * Decode a transport failure into a {@link Stream} when it carries a stream reset code,
  * otherwise pass it through.
  *
  * Native WebTransport rejects with a `WebTransportError`; the WebSocket fallback mints an error
  * with the same `source`/`streamErrorCode` fields. Reading the fields rather than the class
  * covers both, and works in a runtime with no `WebTransportError` at all.
  *
+ * On moq-lite, a code with a local class decodes back into it, so a peer's condition is caught by
+ * the same `instanceof` as one raised here.
+ *
+ * On an IETF stream a code keeps its value unless moq-lite claims that number for something
+ * the draft does not: `0x4` is GOING_AWAY here but UNKNOWN_OBJECT_STATUS on draft-16 and 17,
+ * and reading one back as the other would retire a session that is not going anywhere. Those
+ * read as {@link StreamCode.Internal} with the wire value kept in the message, since
+ * {@link StreamCode} is one numeric space and cannot hold a foreign code without lying about
+ * it. A code moq-lite names nothing for survives intact: nothing can misread it.
+ *
  * @internal Called at the transport boundary so the raw error never reaches an application.
  */
-export function fromTransport(err) {
+export function fromTransport(err, options) {
     const code = streamCode(err);
     if (code === undefined)
         return error(err);
-    return new RemoteError(code, { cause: err });
+    if (options?.version !== undefined && !sharedStreamCode(code, options.version) && claimedLocally(code)) {
+        return new Stream(StreamCode.Internal, { cause: err, message: `remote error: ${code}` });
+    }
+    if (code === StreamCode.TooFarBehind)
+        return new TooFarBehind({ cause: err });
+    if (code === StreamCode.FrameTooLarge)
+        return new FrameTooLarge({ cause: err });
+    if (code === StreamCode.GroupTooLarge)
+        return new GroupTooLarge({ cause: err });
+    return new Stream(code, { cause: err });
+}
+/** The codes moq-lite names, which a foreign one must not borrow. */
+const NAMED_CODES = new Set(Object.values(StreamCode));
+/**
+ * Whether moq-lite could give `code` a meaning of its own: one of its named codes, or
+ * anywhere in the 64+ range, where `StreamCode(code)` mints an application code and an
+ * application compares against its own. moq-transport registers nothing above 0x12 and has
+ * no application range at all, so a foreign code landing there is never what it looks like.
+ */
+function claimedLocally(code) {
+    return code >= 64 || NAMED_CODES.has(code);
+}
+const legacyWebTransportErrors = new WeakSet();
+/**
+ * Build the `reason` to hand `abort()` / `cancel()` so the transport puts `code` on the wire.
+ *
+ * Both the WebTransport spec and the WebSocket fallback take the reset code from a
+ * `WebTransportError`'s `streamErrorCode` and send 0 for anything else, a plain `Error`
+ * included. Since 0 is {@link StreamCode.Internal}, cancelling with a bare `Error` tells the
+ * peer we failed rather than that we are done.
+ *
+ * The native constructor exists exactly where native WebTransport does, which is where the
+ * fallback isn't used, so mint a matching shape elsewhere rather than feature-detect a global
+ * that will not be there.
+ *
+ * @internal
+ */
+export function toTransport(code, message) {
+    const Native = globalThis.WebTransportError;
+    if (Native) {
+        const Legacy = Native;
+        if (legacyWebTransportErrors.has(Native))
+            return new Legacy({ message, streamErrorCode: code });
+        try {
+            return new Native(message, { source: "stream", streamErrorCode: code });
+        }
+        catch (err) {
+            // Chromium still implements the previous single-dictionary constructor.
+            if (!(err instanceof TypeError))
+                throw err;
+            legacyWebTransportErrors.add(Native);
+            return new Legacy({ message, streamErrorCode: code });
+        }
+    }
+    return Object.assign(new Error(message), { source: "stream", streamErrorCode: code });
+}
+/**
+ * Decode a session close into its terminal error: `null` for a clean close
+ * ({@link SessionCode.Cancel}), otherwise a {@link Session} carrying the peer's code.
+ *
+ * @internal Applied to the transport's `closed` info so the code survives to the application.
+ */
+export function fromClose(info) {
+    const code = (info.closeCode ?? SessionCode.Cancel);
+    if (code === SessionCode.Cancel)
+        return null;
+    return new Session(code, { reason: info.reason });
+}
+/**
+ * The session's close as the error it ends everything with, carrying the peer's code. A clean
+ * close code is still an error here: whatever the close cut off did not end.
+ *
+ * @internal
+ */
+export function closeError(quic) {
+    return quic.closed.then((info) => fromClose(info) ?? new Session(SessionCode.Cancel, { reason: info.reason }), (err) => error(err));
+}
+/**
+ * Report a failure the session's close caused as the session's own error, which carries the
+ * peer's close code; any other failure passes through.
+ *
+ * @internal
+ */
+export async function sessionCause(quic, err) {
+    const source = typeof err === "object" && err !== null ? err.source : undefined;
+    if (quic && source === "session")
+        return closeError(quic);
+    return error(err);
 }
 /**
  * Coerce an unknown thrown value into an `Error`.

package/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACrC,wCAAwC;IAC/B,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAA6B;QACtD,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC3C,YAAY,OAAe,EAAE,OAA6B;QACzD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAKD,SAAS,UAAU,CAAC,GAAY;IAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAE9D,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,GAAsB,CAAC;IAC3D,IAAI,MAAM,KAAK,QAAQ,IAAI,OAAO,eAAe,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEjF,OAAO,eAAe,CAAC;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY;IACjC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,GAAY;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAErB,sFAAsF;IACtF,yEAAyE;IACzE,IAAI,OAAO,iBAAiB,KAAK,WAAW,IAAI,CAAC,YAAY,iBAAiB,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,sBAAsB,MAAM,EAAE,CAAC;IAChF,CAAC;IAED,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,eAAe,CAAC;AAC/C,CAAC","sourcesContent":["/**\n * Errors, including the code a peer reports when it resets a stream.\n *\n * @module\n */\n\n/**\n * An error the peer reported by resetting a stream, carrying the raw code it sent.\n *\n * The codes are not standardized, so this deliberately does not translate one into a local\n * error: the number means whatever the peer's implementation says it means. A read or write\n * rejects with this on every transport, so branch on {@link code} rather than feature-detecting\n * `WebTransportError`, which a non-browser runtime never defines and the WebSocket fallback\n * never throws.\n *\n * Code 0 is what a transport sends when a stream is dropped or aborted with no code of its own.\n *\n * ```ts\n * try {\n *   frame = await group.readFrame();\n * } catch (err) {\n *   // Whatever this peer's code 2 means to it.\n *   if (err instanceof RemoteError && err.code === 2) return;\n *   throw err;\n * }\n * ```\n *\n * @public\n */\nexport class RemoteError extends Error {\n\t/** The code the peer sent, verbatim. */\n\treadonly code: number;\n\n\tconstructor(code: number, options?: { cause?: unknown }) {\n\t\tsuper(`remote error: ${code}`, options);\n\t\tthis.name = \"RemoteError\";\n\t\tthis.code = code;\n\t}\n}\n\n/**\n * A peer broke the protocol in a way the spec says must end the session.\n *\n * Thrown where the violation is detected, rather than handled there: a decoder has no session\n * to close. The dispatch that owns the session watches for it and closes, so a nonconforming\n * peer cannot repeat the violation on the next stream.\n *\n * @internal\n */\nexport class ProtocolViolation extends Error {\n\tconstructor(message: string, options?: { cause?: unknown }) {\n\t\tsuper(message, options);\n\t\tthis.name = \"ProtocolViolation\";\n\t}\n}\n\n/** The WebTransport-shaped fields a stream reset code arrives in. */\ntype StreamErrorLike = { source?: unknown; streamErrorCode?: unknown };\n\nfunction streamCode(err: unknown): number | undefined {\n\tif (typeof err !== \"object\" || err === null) return undefined;\n\n\tconst { source, streamErrorCode } = err as StreamErrorLike;\n\tif (source !== \"stream\" || typeof streamErrorCode !== \"number\") return undefined;\n\n\treturn streamErrorCode;\n}\n\n/**\n * Decode a transport failure into a {@link RemoteError} error when it carries a stream reset code,\n * otherwise pass it through.\n *\n * Native WebTransport rejects with a `WebTransportError`; the WebSocket fallback mints an error\n * with the same `source`/`streamErrorCode` fields. Reading the fields rather than the class\n * covers both, and works in a runtime with no `WebTransportError` at all.\n *\n * @internal Called at the transport boundary so the raw error never reaches an application.\n */\nexport function fromTransport(err: unknown): Error {\n\tconst code = streamCode(err);\n\tif (code === undefined) return error(err);\n\treturn new RemoteError(code, { cause: err });\n}\n\n/**\n * Coerce an unknown thrown value into an `Error`.\n *\n * @internal\n */\nexport function error(err: unknown): Error {\n\treturn err instanceof Error ? err : new Error(String(err));\n}\n\n/**\n * Format an error into a non-empty, human-readable string for logging.\n *\n * Safari always leaves `WebTransportError.message` blank, so a bare `err.message` degrades to\n * an empty string and the reason is lost. This falls back to the error type name and appends\n * the WebTransport `source` and application `streamErrorCode`, so the log line always says\n * something.\n */\nexport function reason(err: unknown): string {\n\tconst e = error(err);\n\n\t// WebTransportError carries the failure origin and the peer's application error code,\n\t// often the only identifying detail since WebKit leaves `message` empty.\n\tif (typeof WebTransportError !== \"undefined\" && e instanceof WebTransportError) {\n\t\tconst parts = [`source=${e.source}`];\n\t\tif (e.streamErrorCode !== null) parts.push(`code=${e.streamErrorCode}`);\n\t\tconst detail = parts.join(\" \");\n\t\treturn e.message ? `${e.message} (${detail})` : `WebTransportError: ${detail}`;\n\t}\n\n\treturn e.message || e.name || \"unknown error\";\n}\n"]}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Errors, including the code a peer reports when it resets a stream or closes the session.\n *\n * @module\n */\n\nimport { sharedStreamCode } from \"./ietf/error.ts\";\nimport type { IetfVersion } from \"./ietf/version.ts\";\nimport { TimeoutError } from \"./util/timeout.ts\";\n\n/** The nominal brand for session termination codes. */\ndeclare const SESSION_CODE: unique symbol;\n\n/** A code from the session termination registry. */\nexport type SessionCode = number & { readonly [SESSION_CODE]: true };\n\n/**\n * Codes a peer sends when terminating the session, mirroring the Rust `Session`.\n *\n * Specified by moq-lite, which reuses moq-transport's codes unchanged. Call `SessionCode(code)`\n * to construct an application code in the 64+ range. {@link StreamCode} is the other registry,\n * and the two are disjoint, so the same integer means different things in each.\n *\n * Codes 32-47 are reserved: nothing is sent there, and the draft gives a received one no\n * meaning, so treat anything not listed below as an unspecified error rather than guessing.\n *\n * @public\n */\nexport const SessionCode = Object.freeze(\n\tObject.assign((code: number): SessionCode => applicationCode(code) as SessionCode, {\n\t\t/** Ending the session normally, with no error. */\n\t\tCancel: 0x0 as SessionCode,\n\t\t/** Something went wrong that isn't worth a dedicated code. */\n\t\tInternal: 0x1 as SessionCode,\n\t\t/** The credentials don't grant the requested path or operation. Retrying will fail again. */\n\t\tUnauthorized: 0x2 as SessionCode,\n\t\t/** A protocol rule was broken; the session is unusable. */\n\t\tProtocolViolation: 0x3 as SessionCode,\n\t\t/** A key-value pair was malformed or repeated more than allowed. */\n\t\tKeyValueFormatting: 0x6 as SessionCode,\n\t\t/** The peer did not close within the GOAWAY drain deadline. */\n\t\tGoawayTimeout: 0x10 as SessionCode,\n\t\t/** A control message took too long. */\n\t\tTimeout: 0x11 as SessionCode,\n\t\t/** No version could be negotiated. */\n\t\tVersion: 0x15 as SessionCode,\n\t} as const),\n);\n\n/** The nominal brand for stream reset codes. */\ndeclare const STREAM_CODE: unique symbol;\n\n/** A code from the stream reset registry. */\nexport type StreamCode = number & { readonly [STREAM_CODE]: true };\n\n/**\n * Codes a peer sends when resetting a stream, mirroring the Rust `Stream`.\n *\n * The counterpart to {@link SessionCode}, and a disjoint space: a stream reset of 0 is\n * {@link StreamCode.Internal}, not a cancellation ({@link StreamCode.Cancel} is 1). Call\n * `StreamCode(code)` to construct an application code in the 64+ range.\n *\n * Conditions the shared codes don't cover are assigned in moq-lite's own 48-63 range, so a\n * received one is the named code. 32 through 47 is reserved: nothing is sent there and a\n * received one is an unspecified error.\n *\n * @public\n */\nexport const StreamCode = Object.freeze(\n\tObject.assign((code: number): StreamCode => applicationCode(code) as StreamCode, {\n\t\t/** Something went wrong that isn't worth a dedicated code. */\n\t\tInternal: 0x0 as StreamCode,\n\t\t/** The sender is done with this stream, not failing. A routine unsubscribe. */\n\t\tCancel: 0x1 as StreamCode,\n\t\t/** The content missed its delivery deadline. */\n\t\tDeliveryTimeout: 0x2 as StreamCode,\n\t\t/** The session ended, taking this stream with it. */\n\t\tSessionClosed: 0x3 as StreamCode,\n\t\t/** The session is going away (a GOAWAY was received). */\n\t\tGoingAway: 0x4 as StreamCode,\n\t\t/** The reader fell too far behind and content was dropped to catch up. */\n\t\tTooFarBehind: 0x5 as StreamCode,\n\t\t/** The track's content could not be parsed. */\n\t\tMalformedTrack: 0x12 as StreamCode,\n\t\t/** The peer took too long to answer a control request. */\n\t\tControlTimeout: 0x31 as StreamCode,\n\t\t/** The requested broadcast or track does not exist at the peer. */\n\t\tNotFound: 0x33 as StreamCode,\n\t\t/** The group was superseded by a newer one and dropped. */\n\t\tOld: 0x34 as StreamCode,\n\t\t/** The group was dropped under memory pressure, so it can be re-fetched. */\n\t\tEvicted: 0x35 as StreamCode,\n\t\t/** A frame declared a payload larger than the receiver accepts. */\n\t\tFrameTooLarge: 0x38 as StreamCode,\n\t\t/** The publisher could serve this request but has no capacity for it now. */\n\t\tNoCapacity: 0x30 as StreamCode,\n\t\t/** A group grew past its cache budget and was aborted. */\n\t\tGroupTooLarge: 0x32 as StreamCode,\n\t} as const),\n);\n\nfunction applicationCode(code: number): number {\n\tif (!Number.isInteger(code) || code < 64 || code > 0xffffffff) {\n\t\tthrow new RangeError(`invalid application error code: ${code}`);\n\t}\n\treturn code;\n}\n\n/**\n * An error the peer reported by closing the session, carrying its {@link SessionCode}.\n *\n * This surfaces on every transport, so catch this type rather than feature-detecting\n * `WebTransportError`, which a non-browser runtime never defines and the WebSocket fallback\n * never throws.\n *\n * ```ts\n * connection.error.subscribe((err) => {\n *   if (err instanceof Session && err.code === SessionCode.Unauthorized) {\n *     console.warn(\"server rejected the session\");\n *   }\n * });\n * ```\n *\n * @public\n */\nexport class Session extends Error {\n\t/** The session code the peer sent, verbatim. */\n\treadonly code: SessionCode;\n\n\tconstructor(code: SessionCode, options?: { cause?: unknown; reason?: string }) {\n\t\tsuper(options?.reason ? `remote error: ${code} (${options.reason})` : `remote error: ${code}`, options);\n\t\tthis.name = \"Session\";\n\t\tthis.code = code;\n\t}\n}\n\n/** Options for a {@link Stream}. */\nexport interface StreamOptions {\n\t/** The failure this one wraps. */\n\tcause?: unknown;\n\t/** The peer's human-readable reason, appended to the default message. */\n\treason?: string;\n\t/** Replaces the default `remote error: <code>` text, for a condition raised locally. */\n\tmessage?: string;\n}\n\n/**\n * An error carrying a {@link StreamCode}: the code a peer sent when it reset a stream, or the\n * one this side sends when it resets one.\n *\n * This surfaces on every transport, so catch this type rather than feature-detecting\n * `WebTransportError`, which a non-browser runtime never defines and the WebSocket fallback\n * never throws. Local conditions with a code of their own subclass it ({@link TooFarBehind},\n * {@link FrameTooLarge}, {@link GroupTooLarge}, {@link NotFound}), so the same `code` check catches a condition\n * whether it was raised here or reported by the peer.\n *\n * ```ts\n * try {\n *   frame = await group.readFrame();\n * } catch (err) {\n *   if (err instanceof Stream && err.code === StreamCode.Cancel) return;\n *   throw err;\n * }\n * ```\n *\n * @public\n */\nexport class Stream extends Error {\n\t/** The stream code; moq-lite resets forward it verbatim. */\n\treadonly code: StreamCode;\n\n\tconstructor(code: StreamCode, options?: StreamOptions) {\n\t\tsuper(\n\t\t\toptions?.message ??\n\t\t\t\t(options?.reason ? `remote error: ${code} (${options.reason})` : `remote error: ${code}`),\n\t\t\toptions,\n\t\t);\n\t\tthis.name = \"Stream\";\n\t\tthis.code = code;\n\t}\n}\n\n/**\n * The reader asked for a frame the group never held, so the stream has a gap.\n *\n * Raised locally by a frame read, and decoded from a moq-lite peer's `TOO_FAR_BEHIND` reset, since a gap\n * reads the same either way.\n *\n * @public\n */\nexport class TooFarBehind extends Stream {\n\tconstructor(options?: { cause?: unknown }) {\n\t\tsuper(StreamCode.TooFarBehind, {\n\t\t\t...options,\n\t\t\tmessage: \"lagged: frames were evicted before being read\",\n\t\t});\n\t\tthis.name = \"TooFarBehind\";\n\t}\n}\n\n/**\n * A frame is larger than a group can cache, so appending it would exceed the budget by itself.\n *\n * Raised locally by a frame write, and decoded from a moq-lite peer's `FRAME_TOO_LARGE` reset.\n * Mirrors the Rust `Error::FrameTooLarge`, which rejects the same frame before touching any state.\n *\n * @public\n */\nexport class FrameTooLarge extends Stream {\n\tconstructor(options?: { cause?: unknown }) {\n\t\tsuper(StreamCode.FrameTooLarge, {\n\t\t\t...options,\n\t\t\tmessage: \"frame too large: larger than a group can cache\",\n\t\t});\n\t\tthis.name = \"FrameTooLarge\";\n\t}\n}\n\n/**\n * A write grew the group past its cache budget, so the group is aborted.\n *\n * Raised locally by a frame write, and decoded from a moq-lite peer's `GROUP_TOO_LARGE`\n * reset. Mirrors the Rust `Error::GroupTooLarge`.\n *\n * @public\n */\nexport class GroupTooLarge extends Stream {\n\tconstructor(options?: { cause?: unknown }) {\n\t\tsuper(StreamCode.GroupTooLarge, {\n\t\t\t...options,\n\t\t\tmessage: \"group too large: exceeded the cache budget\",\n\t\t});\n\t\tthis.name = \"GroupTooLarge\";\n\t}\n}\n\n/**\n * The requested broadcast or track is not served here.\n *\n * @public\n */\nexport class NotFound extends Stream {\n\tconstructor(what: string, options?: { cause?: unknown }) {\n\t\tsuper(StreamCode.NotFound, { ...options, message: `not found: ${what}` });\n\t\tthis.name = \"NotFound\";\n\t}\n}\n\n/**\n * A peer broke the protocol in a way the spec says must end the session.\n *\n * Thrown where the violation is detected, rather than handled there: a decoder has no session\n * to close. The dispatch that owns the session watches for it and closes, so a nonconforming\n * peer cannot repeat the violation on the next stream.\n *\n * @public\n */\nexport class ProtocolViolation extends Error {\n\tconstructor(message: string, options?: { cause?: unknown }) {\n\t\tsuper(message, options);\n\t\tthis.name = \"ProtocolViolation\";\n\t}\n}\n\n/** Package-internal compatibility names used by the wire implementation. */\nexport { Session as SessionError, Stream as StreamError, TooFarBehind as Lagged };\n/** Package-internal compatibility name used by the wire implementation. */\nexport type StreamErrorOptions = StreamOptions;\n\n/** The WebTransport-shaped fields a stream reset code arrives in. */\ntype StreamErrorLike = { source?: unknown; streamErrorCode?: unknown };\n\nfunction streamCode(err: unknown): StreamCode | undefined {\n\tif (typeof err !== \"object\" || err === null) return undefined;\n\n\tconst { source, streamErrorCode } = err as StreamErrorLike;\n\tif (source !== \"stream\" || typeof streamErrorCode !== \"number\") return undefined;\n\n\treturn streamErrorCode as StreamCode;\n}\n\n/** Transport context for encoding and decoding errors. @internal */\ninterface TransportErrorOptions {\n\t/** The negotiated IETF draft, or absent for moq-lite. */\n\tversion?: IetfVersion;\n}\n\n/**\n * Which {@link StreamCode} to send when resetting a stream because of `err`.\n *\n * The counterpart to {@link fromTransport}, and the pair has to agree: a code we send for a\n * condition is the code we read that condition back from, or two peers disagree about what it\n * means. Mirrors the Rust `From<&Error> for Stream`.\n *\n * Lossy on purpose. An error describes what went wrong here, while the registry is what the peer\n * can act on, so anything without a code of its own degrades to {@link StreamCode.Internal}\n * rather than inventing one. A {@link Session} lands there too: the two registries are\n * disjoint, so forwarding its code onto a stream would mistranslate it.\n *\n * On an IETF stream the code has to be one the negotiated draft assigns the same meaning to,\n * so a condition it does not register degrades to INTERNAL_ERROR as well. See\n * {@link sharedStreamCode}.\n *\n * @internal\n */\nexport function toStreamCode(err: unknown, options?: TransportErrorOptions): StreamCode {\n\tconst code = localStreamCode(err);\n\tif (options?.version === undefined) return code;\n\treturn sharedStreamCode(code, options.version) ? code : StreamCode.Internal;\n}\n\n/** The moq-lite code for a local failure, before any draft has a say. */\nfunction localStreamCode(err: unknown): StreamCode {\n\tif (err instanceof Stream) return err.code;\n\tif (err instanceof TimeoutError) return StreamCode.DeliveryTimeout;\n\t// Session-scoped: the peer learns which rule it broke from the session close, not from here.\n\tif (err instanceof ProtocolViolation) return StreamCode.SessionClosed;\n\treturn StreamCode.Internal;\n}\n\n/**\n * The {@link StreamCode.ControlTimeout} error for a control request the peer never answered.\n *\n * A control request that outlives its deadline is not late content, so it does not go out as\n * {@link StreamCode.DeliveryTimeout} the way a bare {@link TimeoutError} would. Callers that\n * bound a request's response build this instead.\n *\n * @internal\n */\nexport function controlTimeout(cause: unknown): Stream {\n\tconst message = cause instanceof Error && cause.message ? cause.message : \"control request timed out\";\n\treturn new Stream(StreamCode.ControlTimeout, { cause, message });\n}\n\n/**\n * Decode a transport failure into a {@link Stream} when it carries a stream reset code,\n * otherwise pass it through.\n *\n * Native WebTransport rejects with a `WebTransportError`; the WebSocket fallback mints an error\n * with the same `source`/`streamErrorCode` fields. Reading the fields rather than the class\n * covers both, and works in a runtime with no `WebTransportError` at all.\n *\n * On moq-lite, a code with a local class decodes back into it, so a peer's condition is caught by\n * the same `instanceof` as one raised here.\n *\n * On an IETF stream a code keeps its value unless moq-lite claims that number for something\n * the draft does not: `0x4` is GOING_AWAY here but UNKNOWN_OBJECT_STATUS on draft-16 and 17,\n * and reading one back as the other would retire a session that is not going anywhere. Those\n * read as {@link StreamCode.Internal} with the wire value kept in the message, since\n * {@link StreamCode} is one numeric space and cannot hold a foreign code without lying about\n * it. A code moq-lite names nothing for survives intact: nothing can misread it.\n *\n * @internal Called at the transport boundary so the raw error never reaches an application.\n */\nexport function fromTransport(err: unknown, options?: TransportErrorOptions): Error {\n\tconst code = streamCode(err);\n\tif (code === undefined) return error(err);\n\tif (options?.version !== undefined && !sharedStreamCode(code, options.version) && claimedLocally(code)) {\n\t\treturn new Stream(StreamCode.Internal, { cause: err, message: `remote error: ${code}` });\n\t}\n\tif (code === StreamCode.TooFarBehind) return new TooFarBehind({ cause: err });\n\tif (code === StreamCode.FrameTooLarge) return new FrameTooLarge({ cause: err });\n\tif (code === StreamCode.GroupTooLarge) return new GroupTooLarge({ cause: err });\n\treturn new Stream(code, { cause: err });\n}\n\n/** The codes moq-lite names, which a foreign one must not borrow. */\nconst NAMED_CODES: ReadonlySet<number> = new Set(Object.values(StreamCode));\n\n/**\n * Whether moq-lite could give `code` a meaning of its own: one of its named codes, or\n * anywhere in the 64+ range, where `StreamCode(code)` mints an application code and an\n * application compares against its own. moq-transport registers nothing above 0x12 and has\n * no application range at all, so a foreign code landing there is never what it looks like.\n */\nfunction claimedLocally(code: number): boolean {\n\treturn code >= 64 || NAMED_CODES.has(code);\n}\n\nconst legacyWebTransportErrors = new WeakSet<object>();\n\n/**\n * Build the `reason` to hand `abort()` / `cancel()` so the transport puts `code` on the wire.\n *\n * Both the WebTransport spec and the WebSocket fallback take the reset code from a\n * `WebTransportError`'s `streamErrorCode` and send 0 for anything else, a plain `Error`\n * included. Since 0 is {@link StreamCode.Internal}, cancelling with a bare `Error` tells the\n * peer we failed rather than that we are done.\n *\n * The native constructor exists exactly where native WebTransport does, which is where the\n * fallback isn't used, so mint a matching shape elsewhere rather than feature-detect a global\n * that will not be there.\n *\n * @internal\n */\nexport function toTransport(code: StreamCode, message: string): Error {\n\tconst Native = (globalThis as { WebTransportError?: typeof WebTransportError }).WebTransportError;\n\tif (Native) {\n\t\tconst Legacy = Native as unknown as new (init: { message: string; streamErrorCode: number }) => Error;\n\t\tif (legacyWebTransportErrors.has(Native)) return new Legacy({ message, streamErrorCode: code });\n\n\t\ttry {\n\t\t\treturn new Native(message, { source: \"stream\", streamErrorCode: code });\n\t\t} catch (err) {\n\t\t\t// Chromium still implements the previous single-dictionary constructor.\n\t\t\tif (!(err instanceof TypeError)) throw err;\n\t\t\tlegacyWebTransportErrors.add(Native);\n\t\t\treturn new Legacy({ message, streamErrorCode: code });\n\t\t}\n\t}\n\n\treturn Object.assign(new Error(message), { source: \"stream\" as const, streamErrorCode: code });\n}\n\n/**\n * Decode a session close into its terminal error: `null` for a clean close\n * ({@link SessionCode.Cancel}), otherwise a {@link Session} carrying the peer's code.\n *\n * @internal Applied to the transport's `closed` info so the code survives to the application.\n */\nexport function fromClose(info: WebTransportCloseInfo): Session | null {\n\tconst code = (info.closeCode ?? SessionCode.Cancel) as SessionCode;\n\tif (code === SessionCode.Cancel) return null;\n\treturn new Session(code, { reason: info.reason });\n}\n\n/**\n * The session's close as the error it ends everything with, carrying the peer's code. A clean\n * close code is still an error here: whatever the close cut off did not end.\n *\n * @internal\n */\nexport function closeError(quic: WebTransport): Promise<Error> {\n\treturn quic.closed.then(\n\t\t(info) => fromClose(info) ?? new Session(SessionCode.Cancel, { reason: info.reason }),\n\t\t(err: unknown) => error(err),\n\t);\n}\n\n/**\n * Report a failure the session's close caused as the session's own error, which carries the\n * peer's close code; any other failure passes through.\n *\n * @internal\n */\nexport async function sessionCause(quic: WebTransport | undefined, err: unknown): Promise<Error> {\n\tconst source = typeof err === \"object\" && err !== null ? (err as { source?: unknown }).source : undefined;\n\tif (quic && source === \"session\") return closeError(quic);\n\treturn error(err);\n}\n\n/**\n * Coerce an unknown thrown value into an `Error`.\n *\n * @internal\n */\nexport function error(err: unknown): Error {\n\treturn err instanceof Error ? err : new Error(String(err));\n}\n\n/**\n * Format an error into a non-empty, human-readable string for logging.\n *\n * Safari always leaves `WebTransportError.message` blank, so a bare `err.message` degrades to\n * an empty string and the reason is lost. This falls back to the error type name and appends\n * the WebTransport `source` and application `streamErrorCode`, so the log line always says\n * something.\n */\nexport function reason(err: unknown): string {\n\tconst e = error(err);\n\n\t// WebTransportError carries the failure origin and the peer's application error code,\n\t// often the only identifying detail since WebKit leaves `message` empty.\n\tif (typeof WebTransportError !== \"undefined\" && e instanceof WebTransportError) {\n\t\tconst parts = [`source=${e.source}`];\n\t\tif (e.streamErrorCode !== null) parts.push(`code=${e.streamErrorCode}`);\n\t\tconst detail = parts.join(\" \");\n\t\treturn e.message ? `${e.message} (${detail})` : `WebTransportError: ${detail}`;\n\t}\n\n\treturn e.message || e.name || \"unknown error\";\n}\n"]}

package/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Session and stream error types.
+ *
+ * @module
+ */
+export { FrameTooLarge, GroupTooLarge, NotFound, ProtocolViolation, Session, Stream, type StreamOptions, TooFarBehind, } from "./error";
+//# sourceMappingURL=errors.d.ts.map

package/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,aAAa,EACb,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,OAAO,EACP,MAAM,EACN,KAAK,aAAa,EAClB,YAAY,GACZ,MAAM,YAAY,CAAC"}

package/errors.js

@@ -0,0 +1,8 @@
+/* @ts-self-types="./errors.d.ts" */
+/**
+ * Session and stream error types.
+ *
+ * @module
+ */
+export { FrameTooLarge, GroupTooLarge, NotFound, ProtocolViolation, Session, Stream, TooFarBehind, } from "./error.js";
+//# sourceMappingURL=errors.js.map

package/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,aAAa,EACb,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,OAAO,EACP,MAAM,EAEN,YAAY,GACZ,MAAM,YAAY,CAAC","sourcesContent":["/**\n * Session and stream error types.\n *\n * @module\n */\nexport {\n\tFrameTooLarge,\n\tGroupTooLarge,\n\tNotFound,\n\tProtocolViolation,\n\tSession,\n\tStream,\n\ttype StreamOptions,\n\tTooFarBehind,\n} from \"./error.ts\";\n"]}

package/group.d.ts

@@ -3,12 +3,12 @@
  *
  * @module
  */
-import { type GetPromise, type Getter } from "@norskvideo/moq-signals";
+import { type GetPromise } from "@norskvideo/moq-signals";
 import { Timestamp } from "./time";
-/** Maximum bytes of frames cached in a group before old frames are evicted from the front. */
+/** Maximum bytes of frames in a group. A write that would exceed this aborts with {@link GroupTooLarge}. */
 export declare const MAX_GROUP_CACHE_BYTES: number;
-/** Maximum number of frames cached in a group before old frames are evicted from the front. */
-export declare const MAX_GROUP_FRAMES = 1024;
+/** Maximum number of frames in a group. 8192 is the largest legal group; the 8193rd write is {@link GroupTooLarge}. */
+export declare const MAX_GROUP_FRAMES = 8192;
 /**
  * A frame buffered in a group: its presentation {@link Timestamp} and payload bytes.
  *
@@ -29,9 +29,8 @@ export interface ReadOptions {
     /**
      * The lowest sequence number the caller wants; defaults to the whole group.
      *
-     * Frames below it are discarded instead of returned, and frames evicted below it are not
-     * a gap: the read resumes at the next retained frame rather than throwing {@link Lagged}.
-     * An eviction at or above it still throws, because the caller asked for that frame.
+     * Frames below it are discarded instead of returned. The group still starts at frame 0,
+     * so this is a reader filter, not a missing prefix.
      */
     from?: number;
 }
@@ -40,13 +39,6 @@ export interface Info {
     /** Sequence number of this group within its track. */
     sequence: number;
 }
-/**
- * Thrown by a frame read when the reader fell behind the group's eviction window: frames
- * it had not yet read were dropped to stay under the cache cap, so the stream has a gap.
- */
-export declare class Lagged extends Error {
-    constructor();
-}
 /**
  * The write side of an ordered stream of frames within a track.
  *
@@ -64,31 +56,6 @@ export declare class Producer {
     get closed(): GetPromise<Error | null>;
     /** A read handle for this group. */
     consume(): Consumer;
-    /**
-     * Create an independent read handle that receives every frame written here.
-     *
-     * Frames written so far are replayed synchronously; later writes and close are teed
-     * in as they happen.
-     *
-     * @internal Track fan-out and fetch coalescing only. Use {@link consume} instead.
-     */
-    mirror(): Consumer;
-    /**
-     * Whether any mirror reader is currently attached.
-     *
-     * Pairs with {@link unused}. Fetch coalescing watches it to cancel a download once every reader
-     * has gone: a group can stay open indefinitely (a catalog track, a JSON stream), so it can't
-     * rely on the stream ending on its own.
-     *
-     * @internal Track fan-out and fetch coalescing only.
-     */
-    get used(): Getter<boolean>;
-    /**
-     * Resolves once no mirror reader remains (or the group closes).
-     *
-     * @internal Track fan-out and fetch coalescing only.
-     */
-    unused(): Promise<void>;
     /** Writes a frame to the group. */
     writeFrame(frame: Frame): void;
     /** Write a string as a single UTF-8 encoded frame, stamped with {@link Timestamp.now}. */
@@ -116,7 +83,8 @@ export declare class Consumer {
     readonly sequence: number;
     private constructor();
     /**
-     * Settles once the group closes: `null` on a clean close, or the abort {@link Error}.
+     * Settles when this consumer reaches a terminal state: `null` after a clean close has no
+     * unread or in-flight frames, or the terminal {@link Error}.
      * Peek it synchronously (`undefined` while open), observe it reactively, or `await` it.
      */
     get closed(): GetPromise<Error | null>;
@@ -124,10 +92,8 @@ export declare class Consumer {
     get done(): boolean;
     /** True once the group has been closed, regardless of whether buffered frames remain unread. Synchronous complement to the {@link closed} promise. */
     get isClosed(): boolean;
-    /** True if frames were evicted from the front of this group before being read. */
-    get skipped(): boolean;
     /**
-     * How many frames the group has held, including any already read or evicted.
+     * How many frames the group has held, including any already read.
      *
      * It is also the next frame's sequence number, so `frameCount - 1` names the newest
      * frame written so far. A publisher snapshots it to resolve the track's live edge.

package/group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAgB,KAAK,UAAU,EAA6B,MAAM,cAAc,CAAC;AAGxF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,4GAA4G;AAC5G,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAEtD,uHAAuH;AACvH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACrB,yBAAyB;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,gCAAgC;AAChC,MAAM,WAAW,IAAI;IACpB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAqCD;;;;GAIG;AACH,qBAAa,QAAQ;;IACpB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAc1B,YAAY,QAAQ,EAAE,MAAM,EAG3B;IAWD;;;OAGG;IACH,IAAI,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,CAErC;IAED,oCAAoC;IACpC,OAAO,IAAI,QAAQ,CAElB;IAmED,mCAAmC;IACnC,UAAU,CAAC,KAAK,EAAE,KAAK,QAkCtB;IAED,0FAA0F;IAC1F,WAAW,CAAC,GAAG,EAAE,MAAM,QAEtB;IAED,wFAAwF;IACxF,SAAS,CAAC,IAAI,EAAE,OAAO,QAEtB;IAED,sFAAsF;IACtF,SAAS,CAAC,IAAI,EAAE,OAAO,QAEtB;IAED,2CAA2C;IAC3C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,mEAAmE;IACnE,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,QAUlB;CACD;AA2ED;;;;;;;GAOG;AACH,qBAAa,QAAQ;;IACpB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAc1B,OAAO,eAGN;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,CAOrC;IAuHD,sGAAsG;IACtG,IAAI,IAAI,IAAI,OAAO,CAMlB;IAED,sJAAsJ;IACtJ,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;OAMG;IACH,YAAY,IAAI,KAAK,GAAG,SAAS,CAKhC;IAED,+FAA+F;IAC/F,oBAAoB,IAAI,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC,GAAG,SAAS,CAMjE;IAED,uDAAuD;IACjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAW9B;IAED;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAE5C;IA+BD;;;OAGG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC,CAIlG;IAED,sEAAsE;IAChE,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG9C;IAED,2DAA2D;IACrD,QAAQ,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAG7C;IAED,0EAA0E;IACpE,QAAQ,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAG7C;IAED,+EAA+E;IAC/E,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,QAGlB;CACD"}