moqtail 0.9.0 → 0.10.1

package/dist/client.d.ts

@@ -1,4 +1,5 @@
-import { d as ControlMessage, E as MoqtObject, L as Location, s as FullTrackName, J as ObjectForwardingPreference, ab as Subscribe, T as PublishDoneStatusCode, aj as SubscribeUpdate, F as Fetch, R as Publish, $ as PublishNamespaceOk, Z as PublishNamespaceError, W as PublishNamespace, o as FetchOk, j as FetchError, ai as SubscribeOk, ac as SubscribeError, K as KeyValuePair, ah as SubscribeNamespaceOk, af as SubscribeNamespaceError, ae as SubscribeNamespace, a0 as PublishOk, U as PublishError, t as GroupOrder, p as FetchType, av as VersionSpecificParameters, a7 as SetupParameters, f as DatagramObject, g as DatagramStatus, q as FilterType, ap as Tuple, a2 as RequestIdMap, Y as PublishNamespaceDone, G as GoAway, aa as SubgroupObject, a8 as SubgroupHeader, n as FetchObject, l as FetchHeader, S as PublishDone, a4 as ServerSetup, X as PublishNamespaceCancel, as as UnsubscribeNamespace, H as Header } from './version_parameter-DXBOBueW.js';
+import { c as ControlMessage, U as MoqtObject, y as Location, u as FullTrackName, _ as ObjectForwardingPreference, au as TrackExtension, ao as Subscribe, a4 as PublishDoneStatusCode, ae as RequestUpdate, F as Fetch, a2 as Publish, ad as RequestOk, aa as RequestError, a5 as PublishNamespace, p as FetchOk, aq as SubscribeOk, R as MessageParameter, ap as SubscribeNamespace, a8 as PublishOk, v as GroupOrder, q as FetchType, ak as SetupParameters, D as Datagram, r as FilterType, ay as Tuple, ac as RequestIdMap, a7 as PublishNamespaceDone, G as GoAway, an as SubgroupObject, al as SubgroupHeader, n as FetchObject, l as FetchHeader, a3 as PublishDone, ah as ServerSetup, a6 as PublishNamespaceCancel, X as NamespaceSubscribeOptions, aC as UnsubscribeNamespace, aw as TrackStatus, H as Header } from './setup_parameter-BOeGq6Mv.js';
+import { L as LogLevel } from './logger-C6QS408Z.js';
 
 /**
  * Copyright 2025 The MOQtail Authors
@@ -170,7 +171,7 @@ declare class LiveTrackSource implements LiveObjectSource {
     readonly stream: ReadableStream<MoqtObject>;
     constructor(stream: ReadableStream<MoqtObject>);
     get largestLocation(): Location | undefined;
-    onNewObject(listener: (obj: MoqtObject) => void): () => void;
+    onNewObject(listener: (obj: MoqtObject) => Promise<void> | void): () => void;
     onDone(listener: () => void): () => void;
     stop(): void;
 }
@@ -260,6 +261,12 @@ type Track = {
      * Optional compact numeric alias assigned during protocol negotiation.
      */
     trackAlias?: bigint;
+    /**
+     * Track extensions advertised by the publisher.
+     * Set before calling `publish()` to include extensions in the PUBLISH message.
+     * Populated automatically on the subscriber side when SUBSCRIBE_OK or FETCH_OK is received.
+     */
+    trackExtensions?: TrackExtension[];
 };
 
 /**
@@ -312,10 +319,10 @@ declare class SubscribePublication {
      */
     done(statusCode: PublishDoneStatusCode): Promise<void>;
     /**
-     * Updates the subscription parameters and locations based on a SubscribeUpdate message.
-     * @param msg - The update message containing new subscription details.
+     * Updates the subscription parameters and locations based on a RequestUpdate message.
+     * @param msg - The update message containing new request details.
      */
-    update(msg: SubscribeUpdate): void;
+    update(msg: RequestUpdate): void;
     /**
      * Publishes MOQT objects to the subscriber as they become available.
      * Handles stream creation, object writing, and stream closure based on subscription parameters.
@@ -398,7 +405,7 @@ declare class PublishPublication {
 }
 
 /**
- * Copyright 2025 The MOQtail Authors
+ * Copyright 2026 The MOQtail Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -413,18 +420,18 @@ declare class PublishPublication {
  * limitations under the License.
  */
 
-declare class PublishNamespaceRequest implements PromiseLike<PublishNamespaceOk | PublishNamespaceError> {
+declare class PublishNamespaceRequest implements PromiseLike<RequestOk | RequestError> {
     readonly requestId: bigint;
     readonly message: PublishNamespace;
     private _resolve;
     private _reject;
     private promise;
     constructor(requestId: bigint, message: PublishNamespace);
-    resolve(value: PublishNamespaceOk | PublishNamespaceError | PromiseLike<PublishNamespaceOk | PublishNamespaceError>): void;
+    resolve(value: RequestOk | RequestError | PromiseLike<RequestOk | RequestError>): void;
     reject(reason?: any): void;
-    then<TResult1 = PublishNamespaceOk | PublishNamespaceError, TResult2 = never>(onfulfilled?: ((value: PublishNamespaceOk | PublishNamespaceError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<PublishNamespaceOk | PublishNamespaceError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<PublishNamespaceOk | PublishNamespaceError>;
+    then<TResult1 = RequestOk | RequestError, TResult2 = never>(onfulfilled?: ((value: RequestOk | RequestError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<RequestOk | RequestError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<RequestOk | RequestError>;
 }
 
 /**
@@ -443,7 +450,7 @@ declare class PublishNamespaceRequest implements PromiseLike<PublishNamespaceOk
  * limitations under the License.
  */
 
-declare class FetchRequest implements PromiseLike<FetchOk | FetchError> {
+declare class FetchRequest implements PromiseLike<FetchOk | RequestError> {
     readonly requestId: bigint;
     readonly message: Fetch;
     private _resolve;
@@ -454,11 +461,11 @@ declare class FetchRequest implements PromiseLike<FetchOk | FetchError> {
     isActive: boolean;
     isResolved: boolean;
     constructor(message: Fetch);
-    resolve(value: FetchOk | FetchError | PromiseLike<FetchOk | FetchError>): void;
+    resolve(value: FetchOk | RequestError | PromiseLike<FetchOk | RequestError>): void;
     reject(reason?: any): void;
-    then<TResult1 = FetchOk | FetchError, TResult2 = never>(onfulfilled?: ((value: FetchOk | FetchError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<FetchOk | FetchError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<FetchOk | FetchError>;
+    then<TResult1 = FetchOk | RequestError, TResult2 = never>(onfulfilled?: ((value: FetchOk | RequestError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<FetchOk | RequestError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<FetchOk | RequestError>;
 }
 
 /**
@@ -477,7 +484,7 @@ declare class FetchRequest implements PromiseLike<FetchOk | FetchError> {
  * limitations under the License.
  */
 
-declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeError> {
+declare class SubscribeRequest implements PromiseLike<SubscribeOk | RequestError> {
     #private;
     requestId: bigint;
     fullTrackName: FullTrackName;
@@ -486,25 +493,25 @@ declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeErr
     endGroup: bigint | undefined;
     priority: number;
     forward: boolean;
-    subscribeParameters: KeyValuePair[];
+    subscribeParameters: MessageParameter[];
     largestLocation: Location | undefined;
     streamsAccepted: bigint;
     expectedStreams: bigint | undefined;
     readonly controller: ReadableStreamDefaultController<MoqtObject>;
     readonly stream: ReadableStream<MoqtObject>;
     constructor(msg: Subscribe);
-    update(msg: SubscribeUpdate): void;
-    switch(newTrackName: FullTrackName, newParameters: KeyValuePair[]): void;
+    update(msg: RequestUpdate): void;
+    switch(newTrackName: FullTrackName, newParameters: MessageParameter[]): void;
     unsubscribe(): void;
-    resolve(value: SubscribeOk | SubscribeError | PromiseLike<SubscribeOk | SubscribeError>): void;
+    resolve(value: SubscribeOk | RequestError | PromiseLike<SubscribeOk | RequestError>): void;
     reject(reason?: any): void;
-    then<TResult1 = SubscribeOk | SubscribeError, TResult2 = never>(onfulfilled?: ((value: SubscribeOk | SubscribeError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeOk | SubscribeError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeOk | SubscribeError>;
+    then<TResult1 = SubscribeOk | RequestError, TResult2 = never>(onfulfilled?: ((value: SubscribeOk | RequestError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeOk | RequestError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeOk | RequestError>;
 }
 
 /**
- * Copyright 2025 The MOQtail Authors
+ * Copyright 2026 The MOQtail Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -519,18 +526,18 @@ declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeErr
  * limitations under the License.
  */
 
-declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespaceOk | SubscribeNamespaceError> {
+declare class SubscribeNamespaceRequest implements PromiseLike<RequestOk | RequestError> {
     readonly requestId: bigint;
     readonly message: SubscribeNamespace;
     private _resolve;
     private _reject;
     private promise;
     constructor(msg: SubscribeNamespace);
-    resolve(value: SubscribeNamespaceOk | SubscribeNamespaceError | PromiseLike<SubscribeNamespaceOk | SubscribeNamespaceError>): void;
+    resolve(value: RequestOk | RequestError | PromiseLike<RequestOk | RequestError>): void;
     reject(reason?: any): void;
-    then<TResult1 = SubscribeNamespaceOk | SubscribeNamespaceError, TResult2 = never>(onfulfilled?: ((value: SubscribeNamespaceOk | SubscribeNamespaceError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeNamespaceOk | SubscribeNamespaceError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeNamespaceOk | SubscribeNamespaceError>;
+    then<TResult1 = RequestOk | RequestError, TResult2 = never>(onfulfilled?: ((value: RequestOk | RequestError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<RequestOk | RequestError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<RequestOk | RequestError>;
 }
 
 /**
@@ -549,18 +556,18 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
  * limitations under the License.
  */
 
-declare class PublishRequest implements PromiseLike<PublishOk | PublishError> {
+declare class PublishRequest implements PromiseLike<PublishOk | RequestError> {
     readonly requestId: bigint;
     readonly message: Publish;
     private _resolve;
     private _reject;
     private promise;
     constructor(msg: Publish);
-    resolve(value: PublishOk | PublishError | PromiseLike<PublishOk | PublishError>): void;
+    resolve(value: PublishOk | RequestError | PromiseLike<PublishOk | RequestError>): void;
     reject(reason?: any): void;
-    then<TResult1 = PublishOk | PublishError, TResult2 = never>(onfulfilled?: ((value: PublishOk | PublishError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<PublishOk | PublishError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<PublishOk | PublishError>;
+    then<TResult1 = PublishOk | RequestError, TResult2 = never>(onfulfilled?: ((value: PublishOk | RequestError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<PublishOk | RequestError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<PublishOk | RequestError>;
 }
 
 /**
@@ -640,12 +647,12 @@ type MOQtailRequest = PublishRequest | PublishNamespaceRequest | SubscribeNamesp
 type MOQtailClientOptions = {
     /** Relay / server endpoint for the underlying {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} session (can be absolute {@link https://developer.mozilla.org/en-US/docs/Web/API/URL | URL} or string).*/
     url: string | URL;
-    /** Ordered preference list of MOQT protocol version numbers (e.g. `0xff00000b`).   */
-    supportedVersions: number[];
     /**  {@link SetupParameters} customizations; if omitted a default instance is built.*/
     setupParameters?: SetupParameters;
     /**  Passed directly to the browser's {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} constructor for {@link https://developer.mozilla.org/docs/Web/API/WebTransportOptions | WebTransportOptions}. */
-    transportOptions?: WebTransportOptions;
+    transportOptions?: WebTransportOptions & {
+        protocols?: string[];
+    };
     /** Per *data* uni-stream idle timeout in milliseconds. */
     dataStreamTimeoutMs?: number;
     /** Control stream read timeout in milliseconds. */
@@ -661,9 +668,9 @@ type MOQtailClientOptions = {
         /** Fired once when the session ends (normal or error). Receives the reason passed to {@link MOQtailClient.disconnect | disconnect}. */
         onSessionTerminated?: (reason?: unknown) => void;
         /** Invoked for each decoded datagram object/status arriving. */
-        onDatagramReceived?: (data: DatagramObject | DatagramStatus) => void;
+        onDatagramReceived?: (data: Datagram) => void;
         /** Invoked after enqueuing each outbound datagram object/status. */
-        onDatagramSent?: (data: DatagramObject | DatagramStatus) => void;
+        onDatagramSent?: (data: Datagram) => void;
     };
 };
 /**
@@ -703,8 +710,8 @@ type SubscribeOptions = {
     forward: boolean;
     /** {@link FilterType} variant controlling starting subset (e.g. {@link FilterType.LatestObject}). */
     filterType: FilterType;
-    /** Optional extension {@link VersionSpecificParameters} appended to the SUBSCRIBE control message. */
-    parameters?: VersionSpecificParameters;
+    /** Optional extension parameters appended to the SUBSCRIBE control message. */
+    parameters?: MessageParameter[];
     /** Required for {@link FilterType.AbsoluteStart} / {@link FilterType.AbsoluteRange}; earliest {@link Location} to include. */
     startLocation?: Location;
     /** Required for {@link FilterType.AbsoluteRange}; exclusive upper group boundary (coerced to bigint if number provided). */
@@ -737,8 +744,8 @@ type SubscribeUpdateOptions = {
     priority: number;
     /** Updated direction flag. */
     forward: boolean;
-    /** Optional additional {@link VersionSpecificParameters}; existing parameters persist if omitted. */
-    parameters?: VersionSpecificParameters;
+    /** Optional additional parameters; existing parameters persist if omitted. */
+    parameters?: MessageParameter[];
 };
 /**
  * Parameters for {@link MOQtailClient.switch | switching} an existing SUBSCRIBE to a new track.
@@ -756,8 +763,8 @@ type SwitchOptions = {
     fullTrackName: FullTrackName;
     /** The original SUBSCRIBE request id (bigint) being updated. */
     subscriptionRequestId: bigint;
-    /** Optional additional {@link VersionSpecificParameters}; existing parameters persist if omitted. */
-    parameters?: VersionSpecificParameters;
+    /** Optional additional parameters; existing parameters persist if omitted. */
+    parameters?: MessageParameter[];
 };
 /**
  * Options for {@link MOQtailClient.fetch | performing a FETCH} operation for historical or relative object ranges.
@@ -768,7 +775,7 @@ type SwitchOptions = {
  *   priority: 64,
  *   groupOrder: GroupOrder.Original,
  *   typeAndProps: {
- *     type: FetchType.StandAlone,
+ *     type: FetchType.Standalone,
  *     props: { fullTrackName, startLocation, endLocation }
  *   }
  * })
@@ -792,6 +799,13 @@ type SwitchOptions = {
  * })
  * ```
  */
+/**
+ * Configuration for the early discard policy applied to incoming subgroup streams.
+ */
+type EarlyDiscardPolicyConfig = {
+    /** Cancel a subgroup QUIC stream if it has not fully completed within this many milliseconds. */
+    subgroupReceiveTimeout: number;
+};
 type FetchOptions = {
     /** Request priority (0 = highest, 255 = lowest). Rounded & clamped. */
     priority: number;
@@ -799,12 +813,12 @@ type FetchOptions = {
     groupOrder: GroupOrder;
     /**
      * Discriminated union selecting the {@link FetchType} mode and its specific properties:
-     * - StandAlone: full explicit range on a {@link FullTrackName} with start/end {@link Location}s.
+     * - Standalone: full explicit range on a {@link FullTrackName} with start/end {@link Location}s.
      * - Relative / Absolute: join an existing {@link SubscribeRequest} (identified by `joiningRequestId`) with starting position `joiningStart`.
      */
     typeAndProps: {
         /** Standalone historical/segment fetch for a specific {@link FullTrackName}. */
-        type: FetchType.StandAlone;
+        type: FetchType.Standalone;
         /** Properties for standalone fetch: explicit track and range. */
         props: {
             fullTrackName: FullTrackName;
@@ -828,8 +842,8 @@ type FetchOptions = {
             joiningStart: bigint;
         };
     };
-    /** Optional {@link VersionSpecificParameters} block. */
-    parameters?: VersionSpecificParameters;
+    /** Optional parameters block. */
+    parameters?: MessageParameter[];
 };
 
 /**
@@ -860,8 +874,8 @@ type FetchOptions = {
  */
 declare class SendDatagramStream {
     #private;
-    readonly onDataSent?: (data: DatagramObject | DatagramStatus) => void;
-    constructor(writer: WritableStreamDefaultWriter<Uint8Array>, trackAlias: bigint, onDataSent?: (data: DatagramObject | DatagramStatus) => void);
+    readonly onDataSent?: (data: Datagram) => void;
+    constructor(writer: WritableStreamDefaultWriter<Uint8Array>, trackAlias: bigint, onDataSent?: (data: Datagram) => void);
     /**
      * Create a new datagram sender for a specific track.
      *
@@ -870,7 +884,7 @@ declare class SendDatagramStream {
      * @param onDataSent - Optional callback fired when datagram is sent
      * @returns SendDatagramStream instance
      */
-    static new(writeStream: WritableStream<Uint8Array>, trackAlias: bigint, onDataSent?: (data: DatagramObject | DatagramStatus) => void): Promise<SendDatagramStream>;
+    static new(writeStream: WritableStream<Uint8Array>, trackAlias: bigint, onDataSent?: (data: Datagram) => void): Promise<SendDatagramStream>;
     /**
      * Create a datagram sender using an existing shared writer.
      * Use this when multiple senders need to share a single writer.
@@ -880,13 +894,12 @@ declare class SendDatagramStream {
      * @param onDataSent - Optional callback fired when datagram is sent
      * @returns SendDatagramStream instance
      */
-    static fromWriter(writer: WritableStreamDefaultWriter<Uint8Array>, trackAlias: bigint, onDataSent?: (data: DatagramObject | DatagramStatus) => void): SendDatagramStream;
+    static fromWriter(writer: WritableStreamDefaultWriter<Uint8Array>, trackAlias: bigint, onDataSent?: (data: Datagram) => void): SendDatagramStream;
     /**
      * Write a MoqtObject as a datagram.
-     * Converts to DatagramObject or DatagramStatus automatically.
+     * Converts to Datagram automatically based on object state.
      *
      * @param object - MoqtObject to send (must have Datagram forwarding preference)
-     * @throws ProtocolViolationError if object is not datagram-compatible
      */
     write(object: MoqtObject): Promise<void>;
     /**
@@ -903,8 +916,7 @@ declare class SendDatagramStream {
  * Parallel to RecvStream but for datagram-based delivery.
  *
  * Automatically handles:
- * - DatagramObject parsing (objects with payloads)
- * - DatagramStatus parsing (status-only objects)
+ * - Datagram parsing (both payload and status datagrams)
  * - Track alias to full track name resolution
  *
  * @example
@@ -922,7 +934,7 @@ declare class SendDatagramStream {
 declare class RecvDatagramStream {
     #private;
     readonly stream: ReadableStream<MoqtObject>;
-    readonly onDataReceived?: (data: DatagramObject | DatagramStatus) => void;
+    readonly onDataReceived?: (data: Datagram) => void;
     private constructor();
     /**
      * Create a new datagram receiver.
@@ -932,7 +944,7 @@ declare class RecvDatagramStream {
      * @param onDataReceived - Optional callback fired when datagram is received
      * @returns RecvDatagramStream instance
      */
-    static new(readStream: ReadableStream<Uint8Array>, trackAliasResolver: (trackAlias: bigint) => FullTrackName, onDataReceived?: (data: DatagramObject | DatagramStatus) => void): Promise<RecvDatagramStream>;
+    static new(readStream: ReadableStream<Uint8Array>, trackAliasResolver: (trackAlias: bigint) => FullTrackName, onDataReceived?: (data: Datagram) => void): Promise<RecvDatagramStream>;
     /**
      * Cancel the datagram reader.
      */
@@ -943,6 +955,22 @@ declare class RecvDatagramStream {
     releaseLock(): void;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
 /**
  * @public
  * Represents a Media Over QUIC Transport (MOQT) client session.
@@ -957,7 +985,7 @@ declare class RecvDatagramStream {
  *
  * ### Connect and Subscribe to a Track
  * ```ts
- * const client = await MOQtailClient.new({ url, supportedVersions: [0xff00000b] });
+ * const client = await MOQtailClient.new({ url });
  * const result = await client.subscribe({
  *   fullTrackName,
  *   filterType: FilterType.LatestObject,
@@ -965,7 +993,7 @@ declare class RecvDatagramStream {
  *   groupOrder: GroupOrder.Original,
  *   priority: 0
  * });
- * if (!(result instanceof SubscribeError)) {
+ * if (!(result instanceof RequestError)) {
  *   for await (const object of result.stream) {
  *     // Consume MOQT objects
  *   }
@@ -974,9 +1002,9 @@ declare class RecvDatagramStream {
  *
  * ### Publish a namespace for Publishing
  * ```ts
- * const client = await MOQtailClient.new({ url, supportedVersions: [0xff00000b] });
+ * const client = await MOQtailClient.new({ url });
  * const publishNamespaceResult = await client.publishNamespace(["camera", "main"]);
- * if (!(publishNamespaceResult instanceof PublishNamespaceError)) {
+ * if (!(publishNamespaceResult instanceof RequestError)) {
  *   // Ready to publish objects under this namespace
  * }
  * ```
@@ -1070,7 +1098,7 @@ declare class MOQtailClient {
      */
     onGoaway?: (msg: GoAway) => void;
     /**
-     * Fired if the underlying WebTransport session fails (ready → closed prematurely).
+     * Fired if the underlying WebTransport session fails (ready -\> closed prematurely).
      * Use to log or alert on transport errors.
      * Lifecycle/error handler.
      */
@@ -1112,15 +1140,19 @@ declare class MOQtailClient {
      */
     onError?: (er: unknown) => void;
     /** Invoked for each decoded datagram object/status arriving. */
-    onDatagramReceived?: (data: DatagramObject | DatagramStatus) => void;
+    onDatagramReceived?: (data: Datagram) => void;
     /** Invoked after enqueuing each outbound datagram object/status. */
-    onDatagramSent?: (data: DatagramObject | DatagramStatus) => void;
+    onDatagramSent?: (data: Datagram) => void;
     /** Fired when an inbound PUBLISH control message is received. */
     onPeerPublish?: (msg: Publish, stream: ReadableStream<MoqtObject>) => void;
     /** Fired when an inbound PUBLISH_DONE control message is received. */
     onPeerPublishDone?: (msg: PublishDone) => void;
     /** Fired when an inbound SUBSCRIBE_NAMESPACE control message is received. */
     onPeerSubscribeNamespace?: (msg: SubscribeNamespace) => void;
+    /** Fired when a NAMESPACE message arrives on a SUBSCRIBE_NAMESPACE bi-stream (prefix + suffix). */
+    onPeerNamespace?: (prefix: Tuple, suffix: Tuple) => void;
+    /** Fired when a NAMESPACE_DONE message arrives on a SUBSCRIBE_NAMESPACE bi-stream (prefix + suffix). */
+    onPeerNamespaceDone?: (prefix: Tuple, suffix: Tuple) => void;
     /**
      * Stream of all received MoqtObjects from datagrams across all tracks
      * Consumer should filter by fullTrackName as needed
@@ -1143,6 +1175,16 @@ declare class MOQtailClient {
      * Returns true if datagram support is currently active
      */
     get isDatagramsEnabled(): boolean;
+    /**
+     * Sets the global log level for all moqtail-ts loggers.
+     * @param level - The minimum {@link LogLevel} to output. Use `LogLevel.NONE` to silence all logs.
+     */
+    static setLogLevel(level: LogLevel): void;
+    /**
+     * Restricts log output to the specified module names. Pass `null` to allow all modules.
+     * @param modules - Array of module name strings, or `null` to enable all modules.
+     */
+    static setLogEnabledModules(modules: string[] | null): void;
     private constructor();
     /**
      * Establishes a new {@link MOQtailClient} session over WebTransport and performs the MOQT setup handshake.
@@ -1156,8 +1198,7 @@ declare class MOQtailClient {
      * @example Minimal connection
      * ```ts
      * const client = await MOQtailClient.new({
-     *   url: 'https://relay.example.com/transport',
-     *   supportedVersions: [0xff00000b]
+     *   url: 'https://relay.example.com/transport'
      * });
      * ```
      *
@@ -1165,7 +1206,6 @@ declare class MOQtailClient {
      * ```ts
      * const client = await MOQtailClient.new({
      *   url,
-     *   supportedVersions: [0xff00000b],
      *   setupParameters: new SetupParameters().addMaxRequestId(1000),
      *   transportOptions: { congestionControl: 'default' },
      *   dataStreamTimeoutMs: 5000,
@@ -1244,6 +1284,22 @@ declare class MOQtailClient {
      * ```
      */
     sendDatagram(trackAlias: bigint, object: MoqtObject): Promise<void>;
+    /**
+     * Sets (or replaces) the early discard policy for incoming subgroup streams.
+     *
+     * When set, each incoming subgroup QUIC stream is given a deadline of `subgroupReceiveTimeout` ms to
+     * complete. If the stream has not finished within that window it is cancelled — objects already
+     * delivered to the subscription are kept, but no further objects arrive from that stream.
+     *
+     * The policy takes effect on the next stream accepted after this call. Passing a new config
+     * replaces the previous one. Pass `undefined` to remove the policy.
+     *
+     * @example
+     * ```ts
+     * client.setEarlyDiscardPolicy({ subgroupReceiveTimeout: 2000 })
+     * ```
+     */
+    setEarlyDiscardPolicy(config: EarlyDiscardPolicyConfig | undefined): void;
     /**
      * Gracefully terminates this {@link MOQtailClient} session and releases underlying {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} resources.
      *
@@ -1354,11 +1410,11 @@ declare class MOQtailClient {
      * - `filterType: AbsoluteRange` lets you specify a start and end group, both of should be in the future; the stream waits for those objects. If the start location is \< the latest object
      * observed at the publisher then it behaves as `filterType: LatestObject`.
      *
-     * The method returns either a {@link SubscribeError} (on refusal) or an object with the subscription `requestId` and a `ReadableStream` of {@link MoqtObject}s.
+     * The method returns either a {@link RequestError} (on refusal) or an object with the subscription `requestId` and a `ReadableStream` of {@link MoqtObject}s.
      * Use the `requestId` for {@link MOQtailClient.unsubscribe} or {@link MOQtailClient.subscribeUpdate}. Use the `stream` to decode and display objects.
      *
      * @param args - {@link SubscribeOptions} describing the subscription window and relay forwarding behavior.
-     * @returns Either a {@link SubscribeError} or `{ requestId, stream }` for consuming objects.
+     * @returns Either a {@link RequestError} or `{ requestId, stream }` for consuming objects.
      * @throws : {@link MOQtailError} If the client is destroyed.
      * @throws : {@link ProtocolViolationError} If required fields are missing or inconsistent.
      * @throws : {@link InternalError} On transport/protocol failure (disconnect is triggered before rethrow).
@@ -1372,7 +1428,7 @@ declare class MOQtailClient {
      *   groupOrder: GroupOrder.Original,
      *   priority: 32
      * });
-     * if (!(result instanceof SubscribeError)) {
+     * if (!(result instanceof RequestError)) {
      *   for await (const obj of result.stream) {
      *     // decode and display obj
      *   }
@@ -1392,7 +1448,7 @@ declare class MOQtailClient {
      * });
      * ```
      */
-    subscribe(args: SubscribeOptions): Promise<SubscribeError | {
+    subscribe(args: SubscribeOptions): Promise<RequestError | {
         requestId: bigint;
         stream: ReadableStream<MoqtObject>;
     }>;
@@ -1417,7 +1473,7 @@ declare class MOQtailClient {
      * @example Subscribe and later unsubscribe
      * ```ts
      * const sub = await client.subscribe({ fullTrackName, filterType: FilterType.LatestObject, forward: true, groupOrder: GroupOrder.Original, priority: 0 });
-     * if (!(sub instanceof SubscribeError)) {
+     * if (!(sub instanceof RequestError)) {
      *   // ...consume objects...
      *   await client.unsubscribe(sub.requestId);
      * }
@@ -1489,7 +1545,7 @@ declare class MOQtailClient {
      * await client.switch({ subscriptionRequestId, fullTrackName: newTrackName });
      * ```
      */
-    switch(args: SwitchOptions): Promise<SubscribeError | {
+    switch(args: SwitchOptions): Promise<RequestError | {
         requestId: bigint;
         stream: ReadableStream<MoqtObject>;
     }>;
@@ -1497,7 +1553,7 @@ declare class MOQtailClient {
      * One-shot retrieval of a bounded object span, optionally anchored to an existing subscription, returning a stream of {@link MoqtObject}s.
      *
      * Choose a fetch type via `typeAndProps.type`:
-     * - StandAlone: Historical slice of a specific {@link FullTrackName} independent of active subscriptions.
+     * - Standalone: Historical slice of a specific {@link FullTrackName} independent of active subscriptions.
      * - Relative: Range relative to the JOINING subscription's current (largest) location; use when you want "N groups back" from live.
      * - Absolute: Absolute group/object offsets tied to an existing subscription (stable anchor) even if that subscription keeps forwarding.
      *
@@ -1507,7 +1563,7 @@ declare class MOQtailClient {
      * - typeAndProps: Discriminated union carrying parameters specific to each fetch mode (see examples).
      * - parameters: Optional version-specific extension block.
      *
-     * Returns either a {@link FetchError} (refusal / invalid request at protocol level) or `{ requestId, stream }` whose `stream`
+     * Returns either a {@link RequestError} (refusal / invalid request at protocol level) or `{ requestId, stream }` whose `stream`
      * ends naturally after the bounded range completes (no explicit cancel needed for normal completion).
      *
      * Use cases:
@@ -1530,11 +1586,11 @@ declare class MOQtailClient {
      *   priority: 64,
      *   groupOrder: GroupOrder.Original,
      *   typeAndProps: {
-     *     type: FetchType.StandAlone,
+     *     type: FetchType.Standalone,
      *     props: { fullTrackName, startLocation, endLocation }
      *   }
      * })
-     * if (!(r instanceof FetchError)) {
+     * if (!(r instanceof RequestError)) {
      *   for await (const obj of r.stream as any) {
      *     // consume objects then stream ends automatically
      *   }
@@ -1544,7 +1600,7 @@ declare class MOQtailClient {
      * @example Relative to live subscription (e.g. last 5 groups)
      * ```ts
      * const sub = await client.subscribe({ fullTrackName, filterType: FilterType.LatestObject, forward: true, groupOrder: GroupOrder.Original, priority: 0 })
-     * if (!(sub instanceof SubscribeError)) {
+     * if (!(sub instanceof RequestError)) {
      *   const slice = await client.fetch({
      *     priority: 32,
      *     groupOrder: GroupOrder.Original,
@@ -1553,7 +1609,7 @@ declare class MOQtailClient {
      * }
      * ```
      */
-    fetch(args: FetchOptions): Promise<FetchError | {
+    fetch(args: FetchOptions): Promise<RequestError | {
         requestId: bigint;
         stream: ReadableStream<MoqtObject>;
     }>;
@@ -1579,8 +1635,8 @@ declare class MOQtailClient {
      *
      * @example Cancel shortly after starting
      * ```ts
-     * const r = await client.fetch({ priority: 32, groupOrder: GroupOrder.Original, typeAndProps: { type: FetchType.StandAlone, props: { fullTrackName, startLocation, endLocation } } })
-     * if (!(r instanceof FetchError)) {
+     * const r = await client.fetch({ priority: 32, groupOrder: GroupOrder.Original, typeAndProps: { type: FetchType.Standalone, props: { fullTrackName, startLocation, endLocation } } })
+     * if (!(r instanceof RequestError)) {
      *   // user navigated away
      *   await client.fetchCancel(r.requestId)
      * }
@@ -1596,7 +1652,7 @@ declare class MOQtailClient {
     /**
      * Proactively push a track to the relay/peer.
      */
-    publish(fullTrackName: FullTrackName, forward: boolean, trackAlias: bigint, parameters?: VersionSpecificParameters): Promise<PublishError | {
+    publish(fullTrackName: FullTrackName, forward: boolean, trackAlias: bigint, parameters?: MessageParameter[], trackExtensions?: TrackExtension[]): Promise<RequestError | {
         requestId: bigint;
         trackAlias: bigint;
     }>;
@@ -1623,9 +1679,9 @@ declare class MOQtailClient {
      *
      * Parameter semantics:
      * - trackNamespace: Tuple representing the namespace prefix (e.g. ["camera","main"]). All tracks whose full names start with this tuple are considered within the announce scope.
-     * - parameters: Optional {@link VersionSpecificParameters}; omitted =\> default instance.
+     * - parameters: Optional {@link MessageParameters}; omitted =\> default instance.
      *
-     * Returns: {@link PublishNamespaceOk} on success (namespace added to `announcedNamespaces`) or {@link PublishNamespaceError} explaining refusal.
+     * Returns: {@link RequestOk} on success (namespace added to `announcedNamespaces`) or {@link RequestError} explaining refusal.
      *
      * Use cases:
      * - Make a camera or sensor namespace available before any objects are pushed.
@@ -1643,18 +1699,18 @@ declare class MOQtailClient {
      * @example Minimal announce
      * ```ts
      * const res = await client.publishNamespace(["camera","main"])
-     * if (res instanceof PublishNamespaceOk) {
+     * if (res instanceof RequestOk) {
      *   // ready to publish objects under tracks with this namespace prefix
      * }
      * ```
      *
      * @example PublishNamespace with parameters block
      * ```ts
-     * const params = new VersionSpecificParameters().setSomeExtensionFlag(true)
+     * const params = new MessageParameters().setSomeExtensionFlag(true)
      * const resp = await client.publishNamespace(["room","1234"], params)
      * ```
      */
-    publishNamespace(trackNamespace: Tuple, parameters?: VersionSpecificParameters): Promise<PublishNamespaceError | PublishNamespaceOk>;
+    publishNamespace(trackNamespace: Tuple, parameters?: MessageParameter[]): Promise<RequestOk | RequestError>;
     /**
      * Withdraw a previously announced namespace so new subscribers no longer discover its tracks.
      *
@@ -1716,10 +1772,43 @@ declare class MOQtailClient {
      * ```
      */
     publishNamespaceCancel(msg: PublishNamespaceCancel): Promise<void>;
-    subscribeNamespace(trackNamespacePrefix: Tuple, parameters?: VersionSpecificParameters): Promise<SubscribeNamespaceError | SubscribeNamespaceOk>;
+    subscribeNamespace(trackNamespacePrefix: Tuple, subscribeOptions?: NamespaceSubscribeOptions, parameters?: MessageParameter[]): Promise<{
+        response: RequestOk | RequestError;
+        cancel: () => Promise<void>;
+    }>;
     unsubscribeNamespace(msg: UnsubscribeNamespace): Promise<void>;
 }
 
+/**
+ * Copyright 2026 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class TrackStatusRequest implements PromiseLike<RequestOk | RequestError> {
+    readonly requestId: bigint;
+    readonly message: TrackStatus;
+    private _resolve;
+    private _reject;
+    private promise;
+    constructor(msg: TrackStatus);
+    resolve(value: RequestOk | RequestError | PromiseLike<RequestOk | RequestError>): void;
+    reject(reason?: any): void;
+    then<TResult1 = RequestOk | RequestError, TResult2 = never>(onfulfilled?: ((value: RequestOk | RequestError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<RequestOk | RequestError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<RequestOk | RequestError>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -1754,4 +1843,4 @@ declare class RecvStream {
     static new(readStream: ReadableStream<Uint8Array>, partialDataTimeout?: number, onDataReceived?: (data: SubgroupObject | SubgroupHeader | FetchObject | FetchHeader) => void): Promise<RecvStream>;
 }
 
-export { ControlStream, type FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, type LiveObjectSource, LiveTrackSource, MOQtailClient, type MOQtailClientOptions, type MOQtailRequest, MemoryObjectCache, type ObjectCache, type PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, type SubscribeOptions, SubscribePublication, SubscribeRequest, type SubscribeUpdateOptions, type SwitchOptions, type Track, type TrackSource };
+export { ControlStream, type EarlyDiscardPolicyConfig, type FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, type LiveObjectSource, LiveTrackSource, MOQtailClient, type MOQtailClientOptions, type MOQtailRequest, MemoryObjectCache, type ObjectCache, type PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, type SubscribeOptions, SubscribePublication, SubscribeRequest, type SubscribeUpdateOptions, type SwitchOptions, type Track, type TrackSource, TrackStatusRequest };