moqtail 0.10.1 → 0.11.0

package/dist/client.cjs

@@ -5123,6 +5123,7 @@ var SubscribeRequest = class {
   priority;
   forward;
   subscribeParameters;
+  earlyDiscardPolicy;
   largestLocation;
   // Updated on each received object
   streamsAccepted = 0n;
@@ -5958,6 +5959,11 @@ var handlerRequestsBlocked = async (_client, msg) => {
   logger.debug("handler/requests_blocked", "not implemented", msg);
 };
 
+// src/client/util/validators.ts
+function isValidTrackAlias(trackAlias) {
+  return trackAlias !== void 0 && trackAlias >= 0n;
+}
+
 // src/client/handler/subscribe.ts
 var handlerSubscribe = async (client, msg) => {
   logger.debug("handler/subscribe", `received requestId=${msg.requestId} ftn="${msg.fullTrackName}"`);
@@ -5990,7 +5996,7 @@ var handlerSubscribe = async (client, msg) => {
     await client.controlStream.send(response);
     return;
   }
-  if (!track.trackAlias) throw new Error("Expected track alias to be set");
+  if (!isValidTrackAlias(track.trackAlias)) throw new Error("Expected track alias to be set");
   const largestLocation = track.trackSource.live.largestLocation;
   const parameters = [...msg.parameters];
   if (largestLocation) {
@@ -6910,14 +6916,17 @@ var MOQtailClient = class _MOQtailClient {
     }
   }
   /**
-   * Sets (or replaces) the early discard policy for incoming subgroup streams.
+   * Sets (or replaces) the client-level default 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.
    *
+   * This is a client-wide default. Individual subscriptions can override it via the `earlyDiscardPolicy`
+   * field in {@link SubscribeOptions}, which takes precedence over this setting.
+   *
    * 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.
+   * replaces the previous one. Pass `undefined` to remove the default.
    *
    * @example
    * ```ts
@@ -7012,7 +7021,7 @@ var MOQtailClient = class _MOQtailClient {
    */
   addOrUpdateTrack(track) {
     this.#ensureActive();
-    if (!track.trackAlias) {
+    if (!isValidTrackAlias(track.trackAlias)) {
       track.trackAlias = random60bitId();
     }
     this.trackSources.set(track.fullTrackName.toString(), track);
@@ -7144,6 +7153,7 @@ var MOQtailClient = class _MOQtailClient {
           break;
       }
       const request = new SubscribeRequest(msg);
+      request.earlyDiscardPolicy = args.earlyDiscardPolicy;
       this.requests.set(request.requestId, request);
       this.requestIdMap.addMapping(request.requestId, request.fullTrackName);
       logger.debug("MOQtailClient", `subscribe: sending SUBSCRIBE requestId=${msg.requestId} ftn="${fullTrackName}"`);
@@ -7292,7 +7302,7 @@ var MOQtailClient = class _MOQtailClient {
         const request = this.requests.get(subscriptionRequestId);
         if (request instanceof SubscribeRequest) {
           const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-          if (!trackAlias)
+          if (!isValidTrackAlias(trackAlias))
             throw new InternalError("MOQtailClient.subscribeUpdate", "Request exists but track alias mapping does not");
           const subscription = this.subscriptions.get(trackAlias);
           if (!subscription)
@@ -7345,7 +7355,7 @@ var MOQtailClient = class _MOQtailClient {
       if (!(request instanceof SubscribeRequest))
         throw new ProtocolViolationError("MOQtailClient.switch", "Request id is not a subscription");
       const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-      if (!trackAlias)
+      if (!isValidTrackAlias(trackAlias))
         throw new InternalError("MOQtailClient.switch", "Request exists but track alias mapping does not");
       const subscription = this.subscriptions.get(trackAlias);
       if (!subscription) throw new InternalError("MOQtailClient.switch", "Request exists but subscription does not");
@@ -8010,11 +8020,12 @@ var MOQtailClient = class _MOQtailClient {
           subscription.streamsAccepted++;
           let firstObjectId = null;
           let subgroupTimeoutId;
-          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+          const effectiveDiscardPolicy = subscription.earlyDiscardPolicy ?? this.#earlyDiscardPolicy;
+          if (effectiveDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
             subgroupTimeoutId = setTimeout(() => {
               reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
               });
-            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+            }, effectiveDiscardPolicy.subgroupReceiveTimeout);
           }
           try {
             while (true) {

package/dist/client.d.cts

@@ -494,6 +494,7 @@ declare class SubscribeRequest implements PromiseLike<SubscribeOk | RequestError
     priority: number;
     forward: boolean;
     subscribeParameters: MessageParameter[];
+    earlyDiscardPolicy: EarlyDiscardPolicyConfig | undefined;
     largestLocation: Location | undefined;
     streamsAccepted: bigint;
     expectedStreams: bigint | undefined;
@@ -716,6 +717,8 @@ type SubscribeOptions = {
     startLocation?: Location;
     /** Required for {@link FilterType.AbsoluteRange}; exclusive upper group boundary (coerced to bigint if number provided). */
     endGroup?: bigint | number;
+    /** Per-subscription early discard policy. Overrides the client-level default set via {@link MOQtailClient.setEarlyDiscardPolicy}. */
+    earlyDiscardPolicy?: EarlyDiscardPolicyConfig;
 };
 /**
  * Narrowing update constraints applied to an existing SUBSCRIBE via {@link MOQtailClient.subscribeUpdate}.
@@ -1285,14 +1288,17 @@ declare class MOQtailClient {
      */
     sendDatagram(trackAlias: bigint, object: MoqtObject): Promise<void>;
     /**
-     * Sets (or replaces) the early discard policy for incoming subgroup streams.
+     * Sets (or replaces) the client-level default 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.
      *
+     * This is a client-wide default. Individual subscriptions can override it via the `earlyDiscardPolicy`
+     * field in {@link SubscribeOptions}, which takes precedence over this setting.
+     *
      * 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.
+     * replaces the previous one. Pass `undefined` to remove the default.
      *
      * @example
      * ```ts

package/dist/client.d.ts

@@ -494,6 +494,7 @@ declare class SubscribeRequest implements PromiseLike<SubscribeOk | RequestError
     priority: number;
     forward: boolean;
     subscribeParameters: MessageParameter[];
+    earlyDiscardPolicy: EarlyDiscardPolicyConfig | undefined;
     largestLocation: Location | undefined;
     streamsAccepted: bigint;
     expectedStreams: bigint | undefined;
@@ -716,6 +717,8 @@ type SubscribeOptions = {
     startLocation?: Location;
     /** Required for {@link FilterType.AbsoluteRange}; exclusive upper group boundary (coerced to bigint if number provided). */
     endGroup?: bigint | number;
+    /** Per-subscription early discard policy. Overrides the client-level default set via {@link MOQtailClient.setEarlyDiscardPolicy}. */
+    earlyDiscardPolicy?: EarlyDiscardPolicyConfig;
 };
 /**
  * Narrowing update constraints applied to an existing SUBSCRIBE via {@link MOQtailClient.subscribeUpdate}.
@@ -1285,14 +1288,17 @@ declare class MOQtailClient {
      */
     sendDatagram(trackAlias: bigint, object: MoqtObject): Promise<void>;
     /**
-     * Sets (or replaces) the early discard policy for incoming subgroup streams.
+     * Sets (or replaces) the client-level default 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.
      *
+     * This is a client-wide default. Individual subscriptions can override it via the `earlyDiscardPolicy`
+     * field in {@link SubscribeOptions}, which takes precedence over this setting.
+     *
      * 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.
+     * replaces the previous one. Pass `undefined` to remove the default.
      *
      * @example
      * ```ts

package/dist/client.js

@@ -5121,6 +5121,7 @@ var SubscribeRequest = class {
   priority;
   forward;
   subscribeParameters;
+  earlyDiscardPolicy;
   largestLocation;
   // Updated on each received object
   streamsAccepted = 0n;
@@ -5956,6 +5957,11 @@ var handlerRequestsBlocked = async (_client, msg) => {
   logger.debug("handler/requests_blocked", "not implemented", msg);
 };
 
+// src/client/util/validators.ts
+function isValidTrackAlias(trackAlias) {
+  return trackAlias !== void 0 && trackAlias >= 0n;
+}
+
 // src/client/handler/subscribe.ts
 var handlerSubscribe = async (client, msg) => {
   logger.debug("handler/subscribe", `received requestId=${msg.requestId} ftn="${msg.fullTrackName}"`);
@@ -5988,7 +5994,7 @@ var handlerSubscribe = async (client, msg) => {
     await client.controlStream.send(response);
     return;
   }
-  if (!track.trackAlias) throw new Error("Expected track alias to be set");
+  if (!isValidTrackAlias(track.trackAlias)) throw new Error("Expected track alias to be set");
   const largestLocation = track.trackSource.live.largestLocation;
   const parameters = [...msg.parameters];
   if (largestLocation) {
@@ -6908,14 +6914,17 @@ var MOQtailClient = class _MOQtailClient {
     }
   }
   /**
-   * Sets (or replaces) the early discard policy for incoming subgroup streams.
+   * Sets (or replaces) the client-level default 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.
    *
+   * This is a client-wide default. Individual subscriptions can override it via the `earlyDiscardPolicy`
+   * field in {@link SubscribeOptions}, which takes precedence over this setting.
+   *
    * 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.
+   * replaces the previous one. Pass `undefined` to remove the default.
    *
    * @example
    * ```ts
@@ -7010,7 +7019,7 @@ var MOQtailClient = class _MOQtailClient {
    */
   addOrUpdateTrack(track) {
     this.#ensureActive();
-    if (!track.trackAlias) {
+    if (!isValidTrackAlias(track.trackAlias)) {
       track.trackAlias = random60bitId();
     }
     this.trackSources.set(track.fullTrackName.toString(), track);
@@ -7142,6 +7151,7 @@ var MOQtailClient = class _MOQtailClient {
           break;
       }
       const request = new SubscribeRequest(msg);
+      request.earlyDiscardPolicy = args.earlyDiscardPolicy;
       this.requests.set(request.requestId, request);
       this.requestIdMap.addMapping(request.requestId, request.fullTrackName);
       logger.debug("MOQtailClient", `subscribe: sending SUBSCRIBE requestId=${msg.requestId} ftn="${fullTrackName}"`);
@@ -7290,7 +7300,7 @@ var MOQtailClient = class _MOQtailClient {
         const request = this.requests.get(subscriptionRequestId);
         if (request instanceof SubscribeRequest) {
           const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-          if (!trackAlias)
+          if (!isValidTrackAlias(trackAlias))
             throw new InternalError("MOQtailClient.subscribeUpdate", "Request exists but track alias mapping does not");
           const subscription = this.subscriptions.get(trackAlias);
           if (!subscription)
@@ -7343,7 +7353,7 @@ var MOQtailClient = class _MOQtailClient {
       if (!(request instanceof SubscribeRequest))
         throw new ProtocolViolationError("MOQtailClient.switch", "Request id is not a subscription");
       const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-      if (!trackAlias)
+      if (!isValidTrackAlias(trackAlias))
         throw new InternalError("MOQtailClient.switch", "Request exists but track alias mapping does not");
       const subscription = this.subscriptions.get(trackAlias);
       if (!subscription) throw new InternalError("MOQtailClient.switch", "Request exists but subscription does not");
@@ -8008,11 +8018,12 @@ var MOQtailClient = class _MOQtailClient {
           subscription.streamsAccepted++;
           let firstObjectId = null;
           let subgroupTimeoutId;
-          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+          const effectiveDiscardPolicy = subscription.earlyDiscardPolicy ?? this.#earlyDiscardPolicy;
+          if (effectiveDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
             subgroupTimeoutId = setTimeout(() => {
               reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
               });
-            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+            }, effectiveDiscardPolicy.subgroupReceiveTimeout);
           }
           try {
             while (true) {

package/dist/index.cjs

@@ -5617,6 +5617,7 @@ var SubscribeRequest = class {
   priority;
   forward;
   subscribeParameters;
+  earlyDiscardPolicy;
   largestLocation;
   // Updated on each received object
   streamsAccepted = 0n;
@@ -6452,6 +6453,11 @@ var handlerRequestsBlocked = async (_client, msg) => {
   logger.debug("handler/requests_blocked", "not implemented", msg);
 };
 
+// src/client/util/validators.ts
+function isValidTrackAlias(trackAlias) {
+  return trackAlias !== void 0 && trackAlias >= 0n;
+}
+
 // src/client/handler/subscribe.ts
 var handlerSubscribe = async (client, msg) => {
   logger.debug("handler/subscribe", `received requestId=${msg.requestId} ftn="${msg.fullTrackName}"`);
@@ -6484,7 +6490,7 @@ var handlerSubscribe = async (client, msg) => {
     await client.controlStream.send(response);
     return;
   }
-  if (!track.trackAlias) throw new Error("Expected track alias to be set");
+  if (!isValidTrackAlias(track.trackAlias)) throw new Error("Expected track alias to be set");
   const largestLocation = track.trackSource.live.largestLocation;
   const parameters = [...msg.parameters];
   if (largestLocation) {
@@ -7404,14 +7410,17 @@ var MOQtailClient = class _MOQtailClient {
     }
   }
   /**
-   * Sets (or replaces) the early discard policy for incoming subgroup streams.
+   * Sets (or replaces) the client-level default 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.
    *
+   * This is a client-wide default. Individual subscriptions can override it via the `earlyDiscardPolicy`
+   * field in {@link SubscribeOptions}, which takes precedence over this setting.
+   *
    * 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.
+   * replaces the previous one. Pass `undefined` to remove the default.
    *
    * @example
    * ```ts
@@ -7506,7 +7515,7 @@ var MOQtailClient = class _MOQtailClient {
    */
   addOrUpdateTrack(track) {
     this.#ensureActive();
-    if (!track.trackAlias) {
+    if (!isValidTrackAlias(track.trackAlias)) {
       track.trackAlias = random60bitId();
     }
     this.trackSources.set(track.fullTrackName.toString(), track);
@@ -7638,6 +7647,7 @@ var MOQtailClient = class _MOQtailClient {
           break;
       }
       const request = new SubscribeRequest(msg);
+      request.earlyDiscardPolicy = args.earlyDiscardPolicy;
       this.requests.set(request.requestId, request);
       this.requestIdMap.addMapping(request.requestId, request.fullTrackName);
       logger.debug("MOQtailClient", `subscribe: sending SUBSCRIBE requestId=${msg.requestId} ftn="${fullTrackName}"`);
@@ -7786,7 +7796,7 @@ var MOQtailClient = class _MOQtailClient {
         const request = this.requests.get(subscriptionRequestId);
         if (request instanceof SubscribeRequest) {
           const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-          if (!trackAlias)
+          if (!isValidTrackAlias(trackAlias))
             throw new InternalError("MOQtailClient.subscribeUpdate", "Request exists but track alias mapping does not");
           const subscription = this.subscriptions.get(trackAlias);
           if (!subscription)
@@ -7839,7 +7849,7 @@ var MOQtailClient = class _MOQtailClient {
       if (!(request instanceof SubscribeRequest))
         throw new ProtocolViolationError("MOQtailClient.switch", "Request id is not a subscription");
       const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-      if (!trackAlias)
+      if (!isValidTrackAlias(trackAlias))
         throw new InternalError("MOQtailClient.switch", "Request exists but track alias mapping does not");
       const subscription = this.subscriptions.get(trackAlias);
       if (!subscription) throw new InternalError("MOQtailClient.switch", "Request exists but subscription does not");
@@ -8504,11 +8514,12 @@ var MOQtailClient = class _MOQtailClient {
           subscription.streamsAccepted++;
           let firstObjectId = null;
           let subgroupTimeoutId;
-          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+          const effectiveDiscardPolicy = subscription.earlyDiscardPolicy ?? this.#earlyDiscardPolicy;
+          if (effectiveDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
             subgroupTimeoutId = setTimeout(() => {
               reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
               });
-            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+            }, effectiveDiscardPolicy.subgroupReceiveTimeout);
           }
           try {
             while (true) {

package/dist/index.js

@@ -5615,6 +5615,7 @@ var SubscribeRequest = class {
   priority;
   forward;
   subscribeParameters;
+  earlyDiscardPolicy;
   largestLocation;
   // Updated on each received object
   streamsAccepted = 0n;
@@ -6450,6 +6451,11 @@ var handlerRequestsBlocked = async (_client, msg) => {
   logger.debug("handler/requests_blocked", "not implemented", msg);
 };
 
+// src/client/util/validators.ts
+function isValidTrackAlias(trackAlias) {
+  return trackAlias !== void 0 && trackAlias >= 0n;
+}
+
 // src/client/handler/subscribe.ts
 var handlerSubscribe = async (client, msg) => {
   logger.debug("handler/subscribe", `received requestId=${msg.requestId} ftn="${msg.fullTrackName}"`);
@@ -6482,7 +6488,7 @@ var handlerSubscribe = async (client, msg) => {
     await client.controlStream.send(response);
     return;
   }
-  if (!track.trackAlias) throw new Error("Expected track alias to be set");
+  if (!isValidTrackAlias(track.trackAlias)) throw new Error("Expected track alias to be set");
   const largestLocation = track.trackSource.live.largestLocation;
   const parameters = [...msg.parameters];
   if (largestLocation) {
@@ -7402,14 +7408,17 @@ var MOQtailClient = class _MOQtailClient {
     }
   }
   /**
-   * Sets (or replaces) the early discard policy for incoming subgroup streams.
+   * Sets (or replaces) the client-level default 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.
    *
+   * This is a client-wide default. Individual subscriptions can override it via the `earlyDiscardPolicy`
+   * field in {@link SubscribeOptions}, which takes precedence over this setting.
+   *
    * 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.
+   * replaces the previous one. Pass `undefined` to remove the default.
    *
    * @example
    * ```ts
@@ -7504,7 +7513,7 @@ var MOQtailClient = class _MOQtailClient {
    */
   addOrUpdateTrack(track) {
     this.#ensureActive();
-    if (!track.trackAlias) {
+    if (!isValidTrackAlias(track.trackAlias)) {
       track.trackAlias = random60bitId();
     }
     this.trackSources.set(track.fullTrackName.toString(), track);
@@ -7636,6 +7645,7 @@ var MOQtailClient = class _MOQtailClient {
           break;
       }
       const request = new SubscribeRequest(msg);
+      request.earlyDiscardPolicy = args.earlyDiscardPolicy;
       this.requests.set(request.requestId, request);
       this.requestIdMap.addMapping(request.requestId, request.fullTrackName);
       logger.debug("MOQtailClient", `subscribe: sending SUBSCRIBE requestId=${msg.requestId} ftn="${fullTrackName}"`);
@@ -7784,7 +7794,7 @@ var MOQtailClient = class _MOQtailClient {
         const request = this.requests.get(subscriptionRequestId);
         if (request instanceof SubscribeRequest) {
           const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-          if (!trackAlias)
+          if (!isValidTrackAlias(trackAlias))
             throw new InternalError("MOQtailClient.subscribeUpdate", "Request exists but track alias mapping does not");
           const subscription = this.subscriptions.get(trackAlias);
           if (!subscription)
@@ -7837,7 +7847,7 @@ var MOQtailClient = class _MOQtailClient {
       if (!(request instanceof SubscribeRequest))
         throw new ProtocolViolationError("MOQtailClient.switch", "Request id is not a subscription");
       const trackAlias = this.subscriptionAliasMap.get(subscriptionRequestId);
-      if (!trackAlias)
+      if (!isValidTrackAlias(trackAlias))
         throw new InternalError("MOQtailClient.switch", "Request exists but track alias mapping does not");
       const subscription = this.subscriptions.get(trackAlias);
       if (!subscription) throw new InternalError("MOQtailClient.switch", "Request exists but subscription does not");
@@ -8502,11 +8512,12 @@ var MOQtailClient = class _MOQtailClient {
           subscription.streamsAccepted++;
           let firstObjectId = null;
           let subgroupTimeoutId;
-          if (this.#earlyDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
+          const effectiveDiscardPolicy = subscription.earlyDiscardPolicy ?? this.#earlyDiscardPolicy;
+          if (effectiveDiscardPolicy?.subgroupReceiveTimeout !== void 0) {
             subgroupTimeoutId = setTimeout(() => {
               reader.cancel("early discard: subgroupReceiveTimeout exceeded").catch(() => {
               });
-            }, this.#earlyDiscardPolicy.subgroupReceiveTimeout);
+            }, effectiveDiscardPolicy.subgroupReceiveTimeout);
           }
           try {
             while (true) {

package/package.json

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