moqtail 0.10.0 → 0.10.1

package/dist/client.cjs

@@ -6456,6 +6456,8 @@ var MOQtailClient = class _MOQtailClient {
   #isDestroyed = false;
   /** Internal monotonically increasing client-assigned request id counter (even/odd parity scheme advances by 2). */
   #dontUseRequestId = 0n;
+  /** Active early discard policy; undefined means no per-stream deadline is applied. */
+  #earlyDiscardPolicy;
   /**
    * TODO: onNamespaceAnnounced may be a better name
    * Fired when an PUBLISH_NAMESPACE control message is processed for a track namespace.
@@ -6907,6 +6909,25 @@ var MOQtailClient = class _MOQtailClient {
       return FullTrackName.tryNew("unknown", `track-${trackAlias}`);
     }
   }
+  /**
+   * 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) {
+    this.#ensureActive();
+    this.#earlyDiscardPolicy = config;
+  }
   /**
    * Gracefully terminates this {@link MOQtailClient} session and releases underlying {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} resources.
    *
@@ -7988,43 +8009,54 @@ var MOQtailClient = class _MOQtailClient {
         if (subscription) {
           subscription.streamsAccepted++;
           let firstObjectId = null;
-          while (true) {
-            const { done, value: nextObject } = await reader.read();
-            if (done) {
-              break;
-            }
-            if (nextObject) {
-              if (nextObject instanceof SubgroupObject) {
-                if (!firstObjectId) {
-                  firstObjectId = nextObject.objectId;
-                }
-                let subgroupId = null;
-                if (SubgroupHeaderType.isSubgroupIdZero(header.type)) {
-                  subgroupId = 0n;
-                } else if (SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
-                  subgroupId = firstObjectId ?? null;
-                } else if (SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
-                  subgroupId = header.subgroupId ?? null;
-                }
-                const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
-                if (!fullTrackName) {
-                  throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+          let subgroupTimeoutId;
+          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+            subgroupTimeoutId = setTimeout(() => {
+              reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
+              });
+            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+          }
+          try {
+            while (true) {
+              const { done, value: nextObject } = await reader.read();
+              if (done) {
+                break;
+              }
+              if (nextObject) {
+                if (nextObject instanceof SubgroupObject) {
+                  if (!firstObjectId) {
+                    firstObjectId = nextObject.objectId;
+                  }
+                  let subgroupId = null;
+                  if (SubgroupHeaderType.isSubgroupIdZero(header.type)) {
+                    subgroupId = 0n;
+                  } else if (SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
+                    subgroupId = firstObjectId ?? null;
+                  } else if (SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
+                    subgroupId = header.subgroupId ?? null;
+                  }
+                  const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
+                  if (!fullTrackName) {
+                    throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+                  }
+                  const moqtObject = MoqtObject.fromSubgroupObject(
+                    nextObject,
+                    header.groupId,
+                    header.publisherPriority,
+                    subgroupId,
+                    fullTrackName
+                  );
+                  if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
+                  if (subscription.largestLocation.compare(moqtObject.location) == -1)
+                    subscription.largestLocation = moqtObject.location;
+                  subscription.controller?.enqueue(moqtObject);
+                  continue;
                 }
-                const moqtObject = MoqtObject.fromSubgroupObject(
-                  nextObject,
-                  header.groupId,
-                  header.publisherPriority,
-                  subgroupId,
-                  fullTrackName
-                );
-                if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
-                if (subscription.largestLocation.compare(moqtObject.location) == -1)
-                  subscription.largestLocation = moqtObject.location;
-                subscription.controller?.enqueue(moqtObject);
-                continue;
+                throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
               }
-              throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
             }
+          } finally {
+            if (subgroupTimeoutId !== void 0) clearTimeout(subgroupTimeoutId);
           }
           if (subscription.expectedStreams && subscription.expectedStreams === subscription.streamsAccepted) {
             subscription.controller?.close();

package/dist/client.d.cts

@@ -799,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;
@@ -1277,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.
      *
@@ -1820,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, TrackStatusRequest };
+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 };

package/dist/client.d.ts

@@ -799,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;
@@ -1277,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.
      *
@@ -1820,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, TrackStatusRequest };
+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 };

package/dist/client.js

@@ -6454,6 +6454,8 @@ var MOQtailClient = class _MOQtailClient {
   #isDestroyed = false;
   /** Internal monotonically increasing client-assigned request id counter (even/odd parity scheme advances by 2). */
   #dontUseRequestId = 0n;
+  /** Active early discard policy; undefined means no per-stream deadline is applied. */
+  #earlyDiscardPolicy;
   /**
    * TODO: onNamespaceAnnounced may be a better name
    * Fired when an PUBLISH_NAMESPACE control message is processed for a track namespace.
@@ -6905,6 +6907,25 @@ var MOQtailClient = class _MOQtailClient {
       return FullTrackName.tryNew("unknown", `track-${trackAlias}`);
     }
   }
+  /**
+   * 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) {
+    this.#ensureActive();
+    this.#earlyDiscardPolicy = config;
+  }
   /**
    * Gracefully terminates this {@link MOQtailClient} session and releases underlying {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} resources.
    *
@@ -7986,43 +8007,54 @@ var MOQtailClient = class _MOQtailClient {
         if (subscription) {
           subscription.streamsAccepted++;
           let firstObjectId = null;
-          while (true) {
-            const { done, value: nextObject } = await reader.read();
-            if (done) {
-              break;
-            }
-            if (nextObject) {
-              if (nextObject instanceof SubgroupObject) {
-                if (!firstObjectId) {
-                  firstObjectId = nextObject.objectId;
-                }
-                let subgroupId = null;
-                if (SubgroupHeaderType.isSubgroupIdZero(header.type)) {
-                  subgroupId = 0n;
-                } else if (SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
-                  subgroupId = firstObjectId ?? null;
-                } else if (SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
-                  subgroupId = header.subgroupId ?? null;
-                }
-                const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
-                if (!fullTrackName) {
-                  throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+          let subgroupTimeoutId;
+          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+            subgroupTimeoutId = setTimeout(() => {
+              reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
+              });
+            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+          }
+          try {
+            while (true) {
+              const { done, value: nextObject } = await reader.read();
+              if (done) {
+                break;
+              }
+              if (nextObject) {
+                if (nextObject instanceof SubgroupObject) {
+                  if (!firstObjectId) {
+                    firstObjectId = nextObject.objectId;
+                  }
+                  let subgroupId = null;
+                  if (SubgroupHeaderType.isSubgroupIdZero(header.type)) {
+                    subgroupId = 0n;
+                  } else if (SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
+                    subgroupId = firstObjectId ?? null;
+                  } else if (SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
+                    subgroupId = header.subgroupId ?? null;
+                  }
+                  const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
+                  if (!fullTrackName) {
+                    throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+                  }
+                  const moqtObject = MoqtObject.fromSubgroupObject(
+                    nextObject,
+                    header.groupId,
+                    header.publisherPriority,
+                    subgroupId,
+                    fullTrackName
+                  );
+                  if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
+                  if (subscription.largestLocation.compare(moqtObject.location) == -1)
+                    subscription.largestLocation = moqtObject.location;
+                  subscription.controller?.enqueue(moqtObject);
+                  continue;
                 }
-                const moqtObject = MoqtObject.fromSubgroupObject(
-                  nextObject,
-                  header.groupId,
-                  header.publisherPriority,
-                  subgroupId,
-                  fullTrackName
-                );
-                if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
-                if (subscription.largestLocation.compare(moqtObject.location) == -1)
-                  subscription.largestLocation = moqtObject.location;
-                subscription.controller?.enqueue(moqtObject);
-                continue;
+                throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
               }
-              throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
             }
+          } finally {
+            if (subgroupTimeoutId !== void 0) clearTimeout(subgroupTimeoutId);
           }
           if (subscription.expectedStreams && subscription.expectedStreams === subscription.streamsAccepted) {
             subscription.controller?.close();

package/dist/index.cjs

@@ -6950,6 +6950,8 @@ var MOQtailClient = class _MOQtailClient {
   #isDestroyed = false;
   /** Internal monotonically increasing client-assigned request id counter (even/odd parity scheme advances by 2). */
   #dontUseRequestId = 0n;
+  /** Active early discard policy; undefined means no per-stream deadline is applied. */
+  #earlyDiscardPolicy;
   /**
    * TODO: onNamespaceAnnounced may be a better name
    * Fired when an PUBLISH_NAMESPACE control message is processed for a track namespace.
@@ -7401,6 +7403,25 @@ var MOQtailClient = class _MOQtailClient {
       return FullTrackName.tryNew("unknown", `track-${trackAlias}`);
     }
   }
+  /**
+   * 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) {
+    this.#ensureActive();
+    this.#earlyDiscardPolicy = config;
+  }
   /**
    * Gracefully terminates this {@link MOQtailClient} session and releases underlying {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} resources.
    *
@@ -8482,43 +8503,54 @@ var MOQtailClient = class _MOQtailClient {
         if (subscription) {
           subscription.streamsAccepted++;
           let firstObjectId = null;
-          while (true) {
-            const { done, value: nextObject } = await reader.read();
-            if (done) {
-              break;
-            }
-            if (nextObject) {
-              if (nextObject instanceof SubgroupObject) {
-                if (!firstObjectId) {
-                  firstObjectId = nextObject.objectId;
-                }
-                let subgroupId = null;
-                if (exports.SubgroupHeaderType.isSubgroupIdZero(header.type)) {
-                  subgroupId = 0n;
-                } else if (exports.SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
-                  subgroupId = firstObjectId ?? null;
-                } else if (exports.SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
-                  subgroupId = header.subgroupId ?? null;
-                }
-                const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
-                if (!fullTrackName) {
-                  throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+          let subgroupTimeoutId;
+          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+            subgroupTimeoutId = setTimeout(() => {
+              reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
+              });
+            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+          }
+          try {
+            while (true) {
+              const { done, value: nextObject } = await reader.read();
+              if (done) {
+                break;
+              }
+              if (nextObject) {
+                if (nextObject instanceof SubgroupObject) {
+                  if (!firstObjectId) {
+                    firstObjectId = nextObject.objectId;
+                  }
+                  let subgroupId = null;
+                  if (exports.SubgroupHeaderType.isSubgroupIdZero(header.type)) {
+                    subgroupId = 0n;
+                  } else if (exports.SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
+                    subgroupId = firstObjectId ?? null;
+                  } else if (exports.SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
+                    subgroupId = header.subgroupId ?? null;
+                  }
+                  const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
+                  if (!fullTrackName) {
+                    throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+                  }
+                  const moqtObject = MoqtObject.fromSubgroupObject(
+                    nextObject,
+                    header.groupId,
+                    header.publisherPriority,
+                    subgroupId,
+                    fullTrackName
+                  );
+                  if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
+                  if (subscription.largestLocation.compare(moqtObject.location) == -1)
+                    subscription.largestLocation = moqtObject.location;
+                  subscription.controller?.enqueue(moqtObject);
+                  continue;
                 }
-                const moqtObject = MoqtObject.fromSubgroupObject(
-                  nextObject,
-                  header.groupId,
-                  header.publisherPriority,
-                  subgroupId,
-                  fullTrackName
-                );
-                if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
-                if (subscription.largestLocation.compare(moqtObject.location) == -1)
-                  subscription.largestLocation = moqtObject.location;
-                subscription.controller?.enqueue(moqtObject);
-                continue;
+                throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
               }
-              throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
             }
+          } finally {
+            if (subgroupTimeoutId !== void 0) clearTimeout(subgroupTimeoutId);
           }
           if (subscription.expectedStreams && subscription.expectedStreams === subscription.streamsAccepted) {
             subscription.controller?.close();

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { ControlStream, FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, LiveObjectSource, LiveTrackSource, MOQtailClient, MOQtailClientOptions, MOQtailRequest, MemoryObjectCache, ObjectCache, PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, SubscribeOptions, SubscribePublication, SubscribeRequest, SubscribeUpdateOptions, SwitchOptions, Track, TrackSource, TrackStatusRequest } from './client.cjs';
+export { ControlStream, EarlyDiscardPolicyConfig, FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, LiveObjectSource, LiveTrackSource, MOQtailClient, MOQtailClientOptions, MOQtailRequest, MemoryObjectCache, ObjectCache, PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, SubscribeOptions, SubscribePublication, SubscribeRequest, SubscribeUpdateOptions, SwitchOptions, Track, TrackSource, TrackStatusRequest } from './client.cjs';
 export { AudioLevel, CMSF, CMSFCatalog, CMSFTrack, CaptureTimestamp, CastingError, ExtensionHeader, ExtensionHeaders, ImmutableExtensionsObjectExtension, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, LengthExceedsMaxError, MOQtailError, NotEnoughBytesError, ObjectExtension, PriorGroupIdGapExtension, PriorObjectIdGapExtension, ProtocolViolationError, RequestIdError, Switch, TerminationCode, TerminationError, TimeoutError, TrackNameError, UnknownObjectExtension, VarIntOverflowError, VideoConfig, VideoFrameMarking } from './model.cjs';
 export { A as AuthTokenVariant, a as AuthorizationToken, B as BaseByteBuffer, b as ByteBuffer, C as ClientSetup, c as ControlMessage, d as ControlMessageType, D as Datagram, e as DefaultPublisherGroupOrderExtension, f as DefaultPublisherPriorityExtension, g as DeliveryTimeout, h as DeliveryTimeoutExtension, i as DynamicGroupsExtension, E as EndOfRangeKind, j as Expires, F as Fetch, k as FetchCancel, l as FetchHeader, m as FetchHeaderType, n as FetchObject, o as FetchObjectContext, p as FetchOk, q as FetchType, r as FilterType, s as Forward, t as FrozenByteBuffer, u as FullTrackName, G as GoAway, v as GroupOrder, w as GroupOrderParam, H as Header, I as ImmutableExtensionsExtension, K as KeyValuePair, L as LOCHeaderExtensionId, x as LargestObject, y as Location, M as MAX_FULL_TRACK_NAME_LENGTH, z as MAX_NAMESPACE_TUPLE_COUNT, J as MAX_REASON_PHRASE_LEN, N as MaxAuthTokenCacheSize, O as MaxCacheDurationExtension, P as MaxRequestId, Q as MaxRequestIdParameter, R as MessageParameter, S as MessageParameterType, T as MessageParameters, U as MoqtObject, V as Namespace, W as NamespaceDone, X as NamespaceSubscribeOptions, Y as NewGroupRequest, Z as ObjectDatagramType, _ as ObjectForwardingPreference, $ as ObjectStatus, a0 as Parameter, a1 as Path, a2 as Publish, a3 as PublishDone, a4 as PublishDoneStatusCode, a5 as PublishNamespace, a6 as PublishNamespaceCancel, a7 as PublishNamespaceDone, a8 as PublishOk, a9 as ReasonPhrase, aa as RequestError, ab as RequestErrorCode, ac as RequestIdMap, ad as RequestOk, ae as RequestUpdate, af as RequestsBlocked, ag as SUPPORTED_VERSIONS, ah as ServerSetup, ai as SetupParameter, aj as SetupParameterType, ak as SetupParameters, al as SubgroupHeader, am as SubgroupHeaderType, an as SubgroupObject, ao as Subscribe, ap as SubscribeNamespace, aq as SubscribeOk, ar as SubscriberPriority, as as SubscriptionFilter, at as TokenAliasType, au as TrackExtension, av as TrackExtensionType, aw as TrackStatus, ax as TrackStatusCode, ay as Tuple, az as TupleField, aA as UnknownTrackExtension, aB as Unsubscribe, aC as UnsubscribeNamespace, aD as applyMessageParameterUpdate, aE as controlMessageTypeFromBigInt, aF as fetchTypeFromBigInt, aG as filterTypeFromBigInt, aH as groupOrderFromNumber, aI as isBytes, aJ as isVarInt, aK as locHeaderExtensionIdFromNumber, aL as messageParameterTypeFromNumber, aM as publishDoneStatusCodeFromBigInt, aN as requestErrorCodeFromBigInt, aO as setupParameterTypeFromNumber, aP as tokenAliasTypeFromNumber, aQ as trackStatusCodeFromBigInt } from './setup_parameter-BOeGq6Mv.cjs';
 export { ClockNormalizer, NetworkTelemetry } from './util.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ControlStream, FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, LiveObjectSource, LiveTrackSource, MOQtailClient, MOQtailClientOptions, MOQtailRequest, MemoryObjectCache, ObjectCache, PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, SubscribeOptions, SubscribePublication, SubscribeRequest, SubscribeUpdateOptions, SwitchOptions, Track, TrackSource, TrackStatusRequest } from './client.js';
+export { ControlStream, EarlyDiscardPolicyConfig, FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, LiveObjectSource, LiveTrackSource, MOQtailClient, MOQtailClientOptions, MOQtailRequest, MemoryObjectCache, ObjectCache, PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, SubscribeOptions, SubscribePublication, SubscribeRequest, SubscribeUpdateOptions, SwitchOptions, Track, TrackSource, TrackStatusRequest } from './client.js';
 export { AudioLevel, CMSF, CMSFCatalog, CMSFTrack, CaptureTimestamp, CastingError, ExtensionHeader, ExtensionHeaders, ImmutableExtensionsObjectExtension, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, LengthExceedsMaxError, MOQtailError, NotEnoughBytesError, ObjectExtension, PriorGroupIdGapExtension, PriorObjectIdGapExtension, ProtocolViolationError, RequestIdError, Switch, TerminationCode, TerminationError, TimeoutError, TrackNameError, UnknownObjectExtension, VarIntOverflowError, VideoConfig, VideoFrameMarking } from './model.js';
 export { A as AuthTokenVariant, a as AuthorizationToken, B as BaseByteBuffer, b as ByteBuffer, C as ClientSetup, c as ControlMessage, d as ControlMessageType, D as Datagram, e as DefaultPublisherGroupOrderExtension, f as DefaultPublisherPriorityExtension, g as DeliveryTimeout, h as DeliveryTimeoutExtension, i as DynamicGroupsExtension, E as EndOfRangeKind, j as Expires, F as Fetch, k as FetchCancel, l as FetchHeader, m as FetchHeaderType, n as FetchObject, o as FetchObjectContext, p as FetchOk, q as FetchType, r as FilterType, s as Forward, t as FrozenByteBuffer, u as FullTrackName, G as GoAway, v as GroupOrder, w as GroupOrderParam, H as Header, I as ImmutableExtensionsExtension, K as KeyValuePair, L as LOCHeaderExtensionId, x as LargestObject, y as Location, M as MAX_FULL_TRACK_NAME_LENGTH, z as MAX_NAMESPACE_TUPLE_COUNT, J as MAX_REASON_PHRASE_LEN, N as MaxAuthTokenCacheSize, O as MaxCacheDurationExtension, P as MaxRequestId, Q as MaxRequestIdParameter, R as MessageParameter, S as MessageParameterType, T as MessageParameters, U as MoqtObject, V as Namespace, W as NamespaceDone, X as NamespaceSubscribeOptions, Y as NewGroupRequest, Z as ObjectDatagramType, _ as ObjectForwardingPreference, $ as ObjectStatus, a0 as Parameter, a1 as Path, a2 as Publish, a3 as PublishDone, a4 as PublishDoneStatusCode, a5 as PublishNamespace, a6 as PublishNamespaceCancel, a7 as PublishNamespaceDone, a8 as PublishOk, a9 as ReasonPhrase, aa as RequestError, ab as RequestErrorCode, ac as RequestIdMap, ad as RequestOk, ae as RequestUpdate, af as RequestsBlocked, ag as SUPPORTED_VERSIONS, ah as ServerSetup, ai as SetupParameter, aj as SetupParameterType, ak as SetupParameters, al as SubgroupHeader, am as SubgroupHeaderType, an as SubgroupObject, ao as Subscribe, ap as SubscribeNamespace, aq as SubscribeOk, ar as SubscriberPriority, as as SubscriptionFilter, at as TokenAliasType, au as TrackExtension, av as TrackExtensionType, aw as TrackStatus, ax as TrackStatusCode, ay as Tuple, az as TupleField, aA as UnknownTrackExtension, aB as Unsubscribe, aC as UnsubscribeNamespace, aD as applyMessageParameterUpdate, aE as controlMessageTypeFromBigInt, aF as fetchTypeFromBigInt, aG as filterTypeFromBigInt, aH as groupOrderFromNumber, aI as isBytes, aJ as isVarInt, aK as locHeaderExtensionIdFromNumber, aL as messageParameterTypeFromNumber, aM as publishDoneStatusCodeFromBigInt, aN as requestErrorCodeFromBigInt, aO as setupParameterTypeFromNumber, aP as tokenAliasTypeFromNumber, aQ as trackStatusCodeFromBigInt } from './setup_parameter-BOeGq6Mv.js';
 export { ClockNormalizer, NetworkTelemetry } from './util.js';

package/dist/index.js

@@ -6948,6 +6948,8 @@ var MOQtailClient = class _MOQtailClient {
   #isDestroyed = false;
   /** Internal monotonically increasing client-assigned request id counter (even/odd parity scheme advances by 2). */
   #dontUseRequestId = 0n;
+  /** Active early discard policy; undefined means no per-stream deadline is applied. */
+  #earlyDiscardPolicy;
   /**
    * TODO: onNamespaceAnnounced may be a better name
    * Fired when an PUBLISH_NAMESPACE control message is processed for a track namespace.
@@ -7399,6 +7401,25 @@ var MOQtailClient = class _MOQtailClient {
       return FullTrackName.tryNew("unknown", `track-${trackAlias}`);
     }
   }
+  /**
+   * 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) {
+    this.#ensureActive();
+    this.#earlyDiscardPolicy = config;
+  }
   /**
    * Gracefully terminates this {@link MOQtailClient} session and releases underlying {@link https://developer.mozilla.org/docs/Web/API/WebTransport | WebTransport} resources.
    *
@@ -8480,43 +8501,54 @@ var MOQtailClient = class _MOQtailClient {
         if (subscription) {
           subscription.streamsAccepted++;
           let firstObjectId = null;
-          while (true) {
-            const { done, value: nextObject } = await reader.read();
-            if (done) {
-              break;
-            }
-            if (nextObject) {
-              if (nextObject instanceof SubgroupObject) {
-                if (!firstObjectId) {
-                  firstObjectId = nextObject.objectId;
-                }
-                let subgroupId = null;
-                if (SubgroupHeaderType.isSubgroupIdZero(header.type)) {
-                  subgroupId = 0n;
-                } else if (SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
-                  subgroupId = firstObjectId ?? null;
-                } else if (SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
-                  subgroupId = header.subgroupId ?? null;
-                }
-                const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
-                if (!fullTrackName) {
-                  throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+          let subgroupTimeoutId;
+          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+            subgroupTimeoutId = setTimeout(() => {
+              reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
+              });
+            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+          }
+          try {
+            while (true) {
+              const { done, value: nextObject } = await reader.read();
+              if (done) {
+                break;
+              }
+              if (nextObject) {
+                if (nextObject instanceof SubgroupObject) {
+                  if (!firstObjectId) {
+                    firstObjectId = nextObject.objectId;
+                  }
+                  let subgroupId = null;
+                  if (SubgroupHeaderType.isSubgroupIdZero(header.type)) {
+                    subgroupId = 0n;
+                  } else if (SubgroupHeaderType.isSubgroupIdFirstObjectId(header.type)) {
+                    subgroupId = firstObjectId ?? null;
+                  } else if (SubgroupHeaderType.hasExplicitSubgroupId(header.type)) {
+                    subgroupId = header.subgroupId ?? null;
+                  }
+                  const fullTrackName = this.aliasFullTrackNameMap.get(header.trackAlias);
+                  if (!fullTrackName) {
+                    throw new ProtocolViolationError("MOQtailClient", "No full track name for received track alias");
+                  }
+                  const moqtObject = MoqtObject.fromSubgroupObject(
+                    nextObject,
+                    header.groupId,
+                    header.publisherPriority,
+                    subgroupId,
+                    fullTrackName
+                  );
+                  if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
+                  if (subscription.largestLocation.compare(moqtObject.location) == -1)
+                    subscription.largestLocation = moqtObject.location;
+                  subscription.controller?.enqueue(moqtObject);
+                  continue;
                 }
-                const moqtObject = MoqtObject.fromSubgroupObject(
-                  nextObject,
-                  header.groupId,
-                  header.publisherPriority,
-                  subgroupId,
-                  fullTrackName
-                );
-                if (!subscription.largestLocation) subscription.largestLocation = moqtObject.location;
-                if (subscription.largestLocation.compare(moqtObject.location) == -1)
-                  subscription.largestLocation = moqtObject.location;
-                subscription.controller?.enqueue(moqtObject);
-                continue;
+                throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
               }
-              throw new ProtocolViolationError("MOQtailClient", "Received fetch object after subgroup header");
             }
+          } finally {
+            if (subgroupTimeoutId !== void 0) clearTimeout(subgroupTimeoutId);
           }
           if (subscription.expectedStreams && subscription.expectedStreams === subscription.streamsAccepted) {
             subscription.controller?.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moqtail",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Media Over QUIC Transport client implementation",
   "type": "module",
   "license": "Apache-2.0",