@moqtap/codec 0.7.0 → 0.8.0

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
 var _chunkKTVN4P6Jcjs = require('./chunk-KTVN4P6J.cjs');
 
@@ -6,7 +6,7 @@ var _chunkKTVN4P6Jcjs = require('./chunk-KTVN4P6J.cjs');
 var _chunkMH7537FBcjs = require('./chunk-MH7537FB.cjs');
 
 
-var _chunkY4FRXYX6cjs = require('./chunk-Y4FRXYX6.cjs');
+var _chunkBQHLUT37cjs = require('./chunk-BQHLUT37.cjs');
 
 
 var _chunkJ3ASFPCXcjs = require('./chunk-J3ASFPCX.cjs');
@@ -41,6 +41,54 @@ var _chunkCZNW3R5Ecjs = require('./chunk-CZNW3R5E.cjs');
 
 var _chunk4XLYCT5Qcjs = require('./chunk-4XLYCT5Q.cjs');
 
+// src/core/accessors.ts
+function pick(msg, names) {
+  for (const name of names) {
+    const value = msg[name];
+    if (value != null) return value;
+  }
+  return void 0;
+}
+function bigintOf(value) {
+  if (value == null) return void 0;
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number" || typeof value === "string") {
+    try {
+      return BigInt(value);
+    } catch (e) {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function requestIdOf(msg) {
+  return bigintOf(pick(msg, ["request_id", "requestId", "subscribe_id", "subscribeId"]));
+}
+function trackAliasOf(msg) {
+  return bigintOf(pick(msg, ["track_alias", "trackAlias"]));
+}
+function trackOf(msg) {
+  const source = _nullishCoalesce(pick(msg, ["standalone"]), () => ( msg));
+  const name = pick(source, ["track_name", "trackName"]);
+  if (typeof name !== "string") return void 0;
+  const namespace = pick(source, ["track_namespace", "trackNamespace"]);
+  return {
+    namespace: Array.isArray(namespace) ? namespace.map(String) : [],
+    name
+  };
+}
+function joiningRequestIdOf(msg) {
+  const source = _nullishCoalesce(pick(msg, ["joining"]), () => ( msg));
+  return bigintOf(
+    pick(source, [
+      "joining_request_id",
+      "joiningRequestId",
+      "joining_subscribe_id",
+      "joiningSubscribeId"
+    ])
+  );
+}
+
 // src/index.ts
 var DRAFT_VERSIONS = {
   "07": 0xff000007n,
@@ -81,7 +129,7 @@ Supported draft values: ${Object.keys(DRAFT_VERSIONS).join(", ")}`
     case "13":
       return _chunkKCH4BQXKcjs.createDraft13Codec.call(void 0, );
     case "14":
-      return _chunkY4FRXYX6cjs.createDraft14Codec.call(void 0, );
+      return _chunkBQHLUT37cjs.createDraft14Codec.call(void 0, );
     case "15":
       return _chunkJ3ASFPCXcjs.createDraft15Codec.call(void 0, );
     case "16":
@@ -100,4 +148,8 @@ Supported draft values: ${Object.keys(DRAFT_VERSIONS).join(", ")}`
 
 
 
-exports.DRAFT_VERSIONS = DRAFT_VERSIONS; exports.DecodeError = _chunk4XLYCT5Qcjs.DecodeError; exports.createCodec = createCodec;
+
+
+
+
+exports.DRAFT_VERSIONS = DRAFT_VERSIONS; exports.DecodeError = _chunk4XLYCT5Qcjs.DecodeError; exports.createCodec = createCodec; exports.joiningRequestIdOf = joiningRequestIdOf; exports.requestIdOf = requestIdOf; exports.trackAliasOf = trackAliasOf; exports.trackOf = trackOf;

package/dist/index.d.cts

@@ -7,7 +7,7 @@ import { D as Draft10Codec } from './codec-BOyrk_C9.cjs';
 import { D as Draft11Codec } from './codec-cou9XBMF.cjs';
 import { D as Draft12Codec } from './codec-BOtv3R5j.cjs';
 import { D as Draft13Codec } from './codec-hvkJfCF5.cjs';
-import { D as Draft14Codec } from './codec-B1snaM9L.cjs';
+import { D as Draft14Codec } from './codec-BnamSx7L.cjs';
 import { D as Draft15Codec } from './codec-BqqoYdh_.cjs';
 import { D as Draft16Codec } from './codec-CyApDKwf.cjs';
 import { D as Draft17Codec } from './codec-NMsTK0GX.cjs';
@@ -20,13 +20,83 @@ import './types-0IWbU9Z_.cjs';
 import './types-Ck45Ex5S.cjs';
 import './types-Bio-91Rt.cjs';
 import './types-CXlSn0I9.cjs';
-import './types-DjmrHp_s.cjs';
+import './types-CVeKIk7A.cjs';
 import './types-CPaYBsMG.cjs';
 import './types-Cm9fjeYC.cjs';
 import './types-D9eiB_9A.cjs';
 import './types-Cqp10JtB.cjs';
 import './types-zHgCS6o5.cjs';
 
+/**
+ * Draft-agnostic readers for decoded control messages.
+ *
+ * The codec keeps one message model per draft, because the drafts genuinely
+ * disagree: a track alias travels in SUBSCRIBE through draft-11 and in
+ * SUBSCRIBE_OK from draft-12; a request was a `subscribe_id` through draft-10
+ * and a `request_id` after it; a joining FETCH points at a
+ * `joining_subscribe_id` through draft-13 and a `joining_request_id` after it.
+ * Faithfulness to each draft is the point of the codec.
+ *
+ * What consumers usually want is the answer, not the archaeology — and every
+ * one of them that has asked has written the same field-spelling ladder by
+ * hand. These accessors are that ladder, written once.
+ *
+ * Each returns `undefined` when the message does not carry the field, which
+ * includes the cases where the draft has not assigned it yet: `trackAliasOf`
+ * on a draft-14 SUBSCRIBE is `undefined` because the publisher has not chosen
+ * the alias until SUBSCRIBE_OK.
+ *
+ * Both snake_case (what this codec emits) and camelCase spellings are read, so
+ * these also work on messages recovered from qlog-style traces written by
+ * other tools.
+ */
+/** Any decoded control message, from any draft. */
+type AnyMessage = Readonly<Record<string, unknown>>;
+/** A track's full identity: the namespace tuple plus the name within it. */
+interface TrackIdentity {
+    readonly namespace: string[];
+    readonly name: string;
+}
+/**
+ * The request this message belongs to.
+ *
+ * Named `subscribe_id` through draft-10 and `request_id` from draft-11, when
+ * the id space widened to cover every request type rather than subscriptions
+ * alone.
+ *
+ * Returns `undefined` for draft-17+ responses, which carry no id at all: each
+ * request there has its own bidirectional stream, and that stream — not a
+ * field — is what ties a response to its request.
+ */
+declare function requestIdOf(msg: AnyMessage): bigint | undefined;
+/**
+ * The track alias this message assigns or refers to, if any.
+ *
+ * Which message carries it moved: SUBSCRIBE through draft-11, then SUBSCRIBE_OK
+ * from draft-12, when assigning the alias became the publisher's job. PUBLISH
+ * carries it alongside the track name in every draft that has PUBLISH.
+ */
+declare function trackAliasOf(msg: AnyMessage): bigint | undefined;
+/**
+ * The track this message names, or `undefined` if it names none.
+ *
+ * Covers SUBSCRIBE, PUBLISH, TRACK_STATUS and a standalone FETCH — whose track
+ * sits under `standalone` in most drafts and flat in draft-07, which predates
+ * joining fetch. A joining FETCH names no track of its own; use
+ * {@link joiningRequestIdOf} to find the request whose track it continues.
+ *
+ * PUBLISH_NAMESPACE and its relatives are namespace-only and yield
+ * `undefined`: a namespace is not a track.
+ */
+declare function trackOf(msg: AnyMessage): TrackIdentity | undefined;
+/**
+ * For a joining FETCH, the request whose track it continues.
+ *
+ * Spelled `joining_subscribe_id` through draft-13 and `joining_request_id`
+ * after it, nested under `joining` in every draft that has one.
+ */
+declare function joiningRequestIdOf(msg: AnyMessage): bigint | undefined;
+
 /**
  * @moqtap/codec — MoQT wire-format codec
  *
@@ -91,4 +161,4 @@ declare function createCodec(options: CodecOptions & {
  */
 declare function createCodec(options: CodecOptions): Draft07Codec | Draft08Codec | Draft09Codec | Draft10Codec | Draft11Codec | Draft12Codec | Draft13Codec | Draft14Codec | Draft15Codec | Draft16Codec | Draft17Codec | Draft18Codec | Draft19Codec;
 
-export { CodecOptions, DRAFT_VERSIONS, createCodec };
+export { type AnyMessage, CodecOptions, DRAFT_VERSIONS, type TrackIdentity, createCodec, joiningRequestIdOf, requestIdOf, trackAliasOf, trackOf };

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import { D as Draft10Codec } from './codec-BLYAy2OP.js';
 import { D as Draft11Codec } from './codec-DL0njGkL.js';
 import { D as Draft12Codec } from './codec-D47r_-Rl.js';
 import { D as Draft13Codec } from './codec-CWj5iTxA.js';
-import { D as Draft14Codec } from './codec-D49OofBr.js';
+import { D as Draft14Codec } from './codec-CFhUGTu2.js';
 import { D as Draft15Codec } from './codec-BNS3gS77.js';
 import { D as Draft16Codec } from './codec-D2JbI2tp.js';
 import { D as Draft17Codec } from './codec-DJmV04i0.js';
@@ -20,13 +20,83 @@ import './types-0IWbU9Z_.js';
 import './types-Ck45Ex5S.js';
 import './types-Bio-91Rt.js';
 import './types-CXlSn0I9.js';
-import './types-DjmrHp_s.js';
+import './types-CVeKIk7A.js';
 import './types-CPaYBsMG.js';
 import './types-Cm9fjeYC.js';
 import './types-D9eiB_9A.js';
 import './types-Cqp10JtB.js';
 import './types-zHgCS6o5.js';
 
+/**
+ * Draft-agnostic readers for decoded control messages.
+ *
+ * The codec keeps one message model per draft, because the drafts genuinely
+ * disagree: a track alias travels in SUBSCRIBE through draft-11 and in
+ * SUBSCRIBE_OK from draft-12; a request was a `subscribe_id` through draft-10
+ * and a `request_id` after it; a joining FETCH points at a
+ * `joining_subscribe_id` through draft-13 and a `joining_request_id` after it.
+ * Faithfulness to each draft is the point of the codec.
+ *
+ * What consumers usually want is the answer, not the archaeology — and every
+ * one of them that has asked has written the same field-spelling ladder by
+ * hand. These accessors are that ladder, written once.
+ *
+ * Each returns `undefined` when the message does not carry the field, which
+ * includes the cases where the draft has not assigned it yet: `trackAliasOf`
+ * on a draft-14 SUBSCRIBE is `undefined` because the publisher has not chosen
+ * the alias until SUBSCRIBE_OK.
+ *
+ * Both snake_case (what this codec emits) and camelCase spellings are read, so
+ * these also work on messages recovered from qlog-style traces written by
+ * other tools.
+ */
+/** Any decoded control message, from any draft. */
+type AnyMessage = Readonly<Record<string, unknown>>;
+/** A track's full identity: the namespace tuple plus the name within it. */
+interface TrackIdentity {
+    readonly namespace: string[];
+    readonly name: string;
+}
+/**
+ * The request this message belongs to.
+ *
+ * Named `subscribe_id` through draft-10 and `request_id` from draft-11, when
+ * the id space widened to cover every request type rather than subscriptions
+ * alone.
+ *
+ * Returns `undefined` for draft-17+ responses, which carry no id at all: each
+ * request there has its own bidirectional stream, and that stream — not a
+ * field — is what ties a response to its request.
+ */
+declare function requestIdOf(msg: AnyMessage): bigint | undefined;
+/**
+ * The track alias this message assigns or refers to, if any.
+ *
+ * Which message carries it moved: SUBSCRIBE through draft-11, then SUBSCRIBE_OK
+ * from draft-12, when assigning the alias became the publisher's job. PUBLISH
+ * carries it alongside the track name in every draft that has PUBLISH.
+ */
+declare function trackAliasOf(msg: AnyMessage): bigint | undefined;
+/**
+ * The track this message names, or `undefined` if it names none.
+ *
+ * Covers SUBSCRIBE, PUBLISH, TRACK_STATUS and a standalone FETCH — whose track
+ * sits under `standalone` in most drafts and flat in draft-07, which predates
+ * joining fetch. A joining FETCH names no track of its own; use
+ * {@link joiningRequestIdOf} to find the request whose track it continues.
+ *
+ * PUBLISH_NAMESPACE and its relatives are namespace-only and yield
+ * `undefined`: a namespace is not a track.
+ */
+declare function trackOf(msg: AnyMessage): TrackIdentity | undefined;
+/**
+ * For a joining FETCH, the request whose track it continues.
+ *
+ * Spelled `joining_subscribe_id` through draft-13 and `joining_request_id`
+ * after it, nested under `joining` in every draft that has one.
+ */
+declare function joiningRequestIdOf(msg: AnyMessage): bigint | undefined;
+
 /**
  * @moqtap/codec — MoQT wire-format codec
  *
@@ -91,4 +161,4 @@ declare function createCodec(options: CodecOptions & {
  */
 declare function createCodec(options: CodecOptions): Draft07Codec | Draft08Codec | Draft09Codec | Draft10Codec | Draft11Codec | Draft12Codec | Draft13Codec | Draft14Codec | Draft15Codec | Draft16Codec | Draft17Codec | Draft18Codec | Draft19Codec;
 
-export { CodecOptions, DRAFT_VERSIONS, createCodec };
+export { type AnyMessage, CodecOptions, DRAFT_VERSIONS, type TrackIdentity, createCodec, joiningRequestIdOf, requestIdOf, trackAliasOf, trackOf };

package/dist/index.js

@@ -6,7 +6,7 @@ import {
 } from "./chunk-APTV6F72.js";
 import {
   createDraft14Codec
-} from "./chunk-DORX55MO.js";
+} from "./chunk-JJEN2VG5.js";
 import {
   createDraft15Codec
 } from "./chunk-MD2OA7SE.js";
@@ -41,6 +41,54 @@ import {
   DecodeError
 } from "./chunk-KLPWJU6W.js";
 
+// src/core/accessors.ts
+function pick(msg, names) {
+  for (const name of names) {
+    const value = msg[name];
+    if (value != null) return value;
+  }
+  return void 0;
+}
+function bigintOf(value) {
+  if (value == null) return void 0;
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number" || typeof value === "string") {
+    try {
+      return BigInt(value);
+    } catch {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function requestIdOf(msg) {
+  return bigintOf(pick(msg, ["request_id", "requestId", "subscribe_id", "subscribeId"]));
+}
+function trackAliasOf(msg) {
+  return bigintOf(pick(msg, ["track_alias", "trackAlias"]));
+}
+function trackOf(msg) {
+  const source = pick(msg, ["standalone"]) ?? msg;
+  const name = pick(source, ["track_name", "trackName"]);
+  if (typeof name !== "string") return void 0;
+  const namespace = pick(source, ["track_namespace", "trackNamespace"]);
+  return {
+    namespace: Array.isArray(namespace) ? namespace.map(String) : [],
+    name
+  };
+}
+function joiningRequestIdOf(msg) {
+  const source = pick(msg, ["joining"]) ?? msg;
+  return bigintOf(
+    pick(source, [
+      "joining_request_id",
+      "joiningRequestId",
+      "joining_subscribe_id",
+      "joiningSubscribeId"
+    ])
+  );
+}
+
 // src/index.ts
 var DRAFT_VERSIONS = {
   "07": 0xff000007n,
@@ -99,5 +147,9 @@ Supported draft values: ${Object.keys(DRAFT_VERSIONS).join(", ")}`
 export {
   DRAFT_VERSIONS,
   DecodeError,
-  createCodec
+  createCodec,
+  joiningRequestIdOf,
+  requestIdOf,
+  trackAliasOf,
+  trackOf
 };

package/dist/session.d.cts

@@ -8,7 +8,7 @@ import { D as Draft10Message, a as Draft10MessageType } from './types-0IWbU9Z_.c
 import { D as Draft11Message, a as Draft11MessageType } from './types-Ck45Ex5S.cjs';
 import { D as Draft12Message, a as Draft12MessageType } from './types-Bio-91Rt.cjs';
 import { D as Draft13Message, a as Draft13MessageType } from './types-CXlSn0I9.cjs';
-import { D as Draft14Message, a as Draft14MessageType } from './types-DjmrHp_s.cjs';
+import { D as Draft14Message, a as Draft14MessageType } from './types-CVeKIk7A.cjs';
 import { D as Draft15Message, a as Draft15MessageType } from './types-CPaYBsMG.cjs';
 import { D as Draft16Message, a as Draft16MessageType } from './types-Cm9fjeYC.cjs';
 import { D as Draft17Message, a as Draft17MessageType } from './types-D9eiB_9A.cjs';

package/dist/session.d.ts

@@ -8,7 +8,7 @@ import { D as Draft10Message, a as Draft10MessageType } from './types-0IWbU9Z_.j
 import { D as Draft11Message, a as Draft11MessageType } from './types-Ck45Ex5S.js';
 import { D as Draft12Message, a as Draft12MessageType } from './types-Bio-91Rt.js';
 import { D as Draft13Message, a as Draft13MessageType } from './types-CXlSn0I9.js';
-import { D as Draft14Message, a as Draft14MessageType } from './types-DjmrHp_s.js';
+import { D as Draft14Message, a as Draft14MessageType } from './types-CVeKIk7A.js';
 import { D as Draft15Message, a as Draft15MessageType } from './types-CPaYBsMG.js';
 import { D as Draft16Message, a as Draft16MessageType } from './types-Cm9fjeYC.js';
 import { D as Draft17Message, a as Draft17MessageType } from './types-D9eiB_9A.js';

package/dist/{types-DjmrHp_s.d.cts → types-CVeKIk7A.d.cts}

@@ -63,8 +63,8 @@ interface Draft14Subscribe extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_namespace: string[];
     readonly track_name: string;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly forward: bigint;
     readonly filter_type: bigint;
     readonly start_group?: bigint;
@@ -77,7 +77,7 @@ interface Draft14SubscribeOk extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_alias: bigint;
     readonly expires: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly content_exists: bigint;
     readonly largest_location?: Location;
     readonly parameters: Draft14Params;
@@ -89,7 +89,7 @@ interface Draft14SubscribeUpdate extends Draft14BaseMessage {
     readonly start_group: bigint;
     readonly start_object: bigint;
     readonly end_group: bigint;
-    readonly subscriber_priority: bigint;
+    readonly subscriber_priority: number;
     readonly forward: bigint;
     readonly parameters: Draft14Params;
 }
@@ -109,7 +109,7 @@ interface Draft14Publish extends Draft14BaseMessage {
     readonly track_namespace: string[];
     readonly track_name: string;
     readonly track_alias: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly content_exists: bigint;
     readonly largest_location?: Location;
     readonly forward: bigint;
@@ -119,8 +119,8 @@ interface Draft14PublishOk extends Draft14BaseMessage {
     readonly type: 'publish_ok';
     readonly request_id: bigint;
     readonly forward: bigint;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly filter_type: bigint;
     readonly start_group?: bigint;
     readonly start_object?: bigint;
@@ -188,26 +188,34 @@ interface Draft14UnsubscribeNamespace extends Draft14BaseMessage {
     readonly type: 'unsubscribe_namespace';
     readonly track_namespace_prefix: string[];
 }
+interface StandaloneFetch {
+    readonly track_namespace: string[];
+    readonly track_name: string;
+    readonly start_group: bigint;
+    readonly start_object: bigint;
+    readonly end_group: bigint;
+    readonly end_object: bigint;
+}
+interface JoiningFetch {
+    readonly joining_request_id: bigint;
+    readonly joining_start: bigint;
+}
 interface Draft14Fetch extends Draft14BaseMessage {
     readonly type: 'fetch';
     readonly request_id: bigint;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly fetch_type: bigint;
-    readonly track_namespace?: string[];
-    readonly track_name?: string;
-    readonly start_group?: bigint;
-    readonly start_object?: bigint;
-    readonly end_group?: bigint;
-    readonly end_object?: bigint;
-    readonly joining_request_id?: bigint;
-    readonly joining_start?: bigint;
+    /** Present when fetch_type = 1 */
+    readonly standalone?: StandaloneFetch;
+    /** Present when fetch_type = 2 or 3 */
+    readonly joining?: JoiningFetch;
     readonly parameters: Draft14Params;
 }
 interface Draft14FetchOk extends Draft14BaseMessage {
     readonly type: 'fetch_ok';
     readonly request_id: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly end_of_track: bigint;
     readonly end_location: Location;
     readonly parameters: Draft14Params;
@@ -227,8 +235,8 @@ interface Draft14TrackStatus extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_namespace: string[];
     readonly track_name: string;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly forward: bigint;
     readonly filter_type: bigint;
     readonly start_group?: bigint;
@@ -240,7 +248,7 @@ interface Draft14TrackStatusOk extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_alias: bigint;
     readonly expires: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly content_exists: bigint;
     readonly largest_location?: Location;
     readonly parameters: Draft14Params;

package/dist/{types-DjmrHp_s.d.ts → types-CVeKIk7A.d.ts}

@@ -63,8 +63,8 @@ interface Draft14Subscribe extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_namespace: string[];
     readonly track_name: string;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly forward: bigint;
     readonly filter_type: bigint;
     readonly start_group?: bigint;
@@ -77,7 +77,7 @@ interface Draft14SubscribeOk extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_alias: bigint;
     readonly expires: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly content_exists: bigint;
     readonly largest_location?: Location;
     readonly parameters: Draft14Params;
@@ -89,7 +89,7 @@ interface Draft14SubscribeUpdate extends Draft14BaseMessage {
     readonly start_group: bigint;
     readonly start_object: bigint;
     readonly end_group: bigint;
-    readonly subscriber_priority: bigint;
+    readonly subscriber_priority: number;
     readonly forward: bigint;
     readonly parameters: Draft14Params;
 }
@@ -109,7 +109,7 @@ interface Draft14Publish extends Draft14BaseMessage {
     readonly track_namespace: string[];
     readonly track_name: string;
     readonly track_alias: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly content_exists: bigint;
     readonly largest_location?: Location;
     readonly forward: bigint;
@@ -119,8 +119,8 @@ interface Draft14PublishOk extends Draft14BaseMessage {
     readonly type: 'publish_ok';
     readonly request_id: bigint;
     readonly forward: bigint;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly filter_type: bigint;
     readonly start_group?: bigint;
     readonly start_object?: bigint;
@@ -188,26 +188,34 @@ interface Draft14UnsubscribeNamespace extends Draft14BaseMessage {
     readonly type: 'unsubscribe_namespace';
     readonly track_namespace_prefix: string[];
 }
+interface StandaloneFetch {
+    readonly track_namespace: string[];
+    readonly track_name: string;
+    readonly start_group: bigint;
+    readonly start_object: bigint;
+    readonly end_group: bigint;
+    readonly end_object: bigint;
+}
+interface JoiningFetch {
+    readonly joining_request_id: bigint;
+    readonly joining_start: bigint;
+}
 interface Draft14Fetch extends Draft14BaseMessage {
     readonly type: 'fetch';
     readonly request_id: bigint;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly fetch_type: bigint;
-    readonly track_namespace?: string[];
-    readonly track_name?: string;
-    readonly start_group?: bigint;
-    readonly start_object?: bigint;
-    readonly end_group?: bigint;
-    readonly end_object?: bigint;
-    readonly joining_request_id?: bigint;
-    readonly joining_start?: bigint;
+    /** Present when fetch_type = 1 */
+    readonly standalone?: StandaloneFetch;
+    /** Present when fetch_type = 2 or 3 */
+    readonly joining?: JoiningFetch;
     readonly parameters: Draft14Params;
 }
 interface Draft14FetchOk extends Draft14BaseMessage {
     readonly type: 'fetch_ok';
     readonly request_id: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly end_of_track: bigint;
     readonly end_location: Location;
     readonly parameters: Draft14Params;
@@ -227,8 +235,8 @@ interface Draft14TrackStatus extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_namespace: string[];
     readonly track_name: string;
-    readonly subscriber_priority: bigint;
-    readonly group_order: bigint;
+    readonly subscriber_priority: number;
+    readonly group_order: number;
     readonly forward: bigint;
     readonly filter_type: bigint;
     readonly start_group?: bigint;
@@ -240,7 +248,7 @@ interface Draft14TrackStatusOk extends Draft14BaseMessage {
     readonly request_id: bigint;
     readonly track_alias: bigint;
     readonly expires: bigint;
-    readonly group_order: bigint;
+    readonly group_order: number;
     readonly content_exists: bigint;
     readonly largest_location?: Location;
     readonly parameters: Draft14Params;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moqtap/codec",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MoQT wire-format codec and session state machine — multi-draft, zero dependencies",
   "type": "module",
   "license": "MIT",