moqtail 0.8.1 → 0.9.0

package/dist/{model/index.cjs → model.cjs}

@@ -1,5 +1,218 @@
 'use strict';
 
+// src/model/catalog/cmsf.ts
+function isString(v) {
+  return typeof v === "string";
+}
+function isNumber(v) {
+  return typeof v === "number";
+}
+function isStringArray(v) {
+  return Array.isArray(v) && v.every((item) => isString(item));
+}
+function isValidPackaging(v) {
+  return v === "cmaf" || v === "chunk-per-object" || v === "timeline";
+}
+function isValidRole(v) {
+  return v === "video" || v === "audio" || v === "timeline";
+}
+function isValidBase64(str) {
+  try {
+    return btoa(atob(str)) === str;
+  } catch {
+    return false;
+  }
+}
+function validateTrack(track) {
+  if (typeof track !== "object" || track === null) {
+    throw new Error("Track must be an object");
+  }
+  const t = track;
+  if (!isString(t["name"])) {
+    throw new Error("Track.name must be a string");
+  }
+  if (!isValidPackaging(t["packaging"])) {
+    throw new Error("Track.packaging must be 'cmaf', 'chunk-per-object', or 'timeline'");
+  }
+  if (!isValidRole(t["role"])) {
+    throw new Error("Track.role must be 'video', 'audio', or 'timeline'");
+  }
+  const name = t["name"];
+  const packaging = t["packaging"];
+  const role = t["role"];
+  let codec;
+  if (t["codec"] !== void 0) {
+    if (!isString(t["codec"])) {
+      throw new Error("Track.codec must be a string");
+    }
+    codec = t["codec"];
+  }
+  let depends;
+  if (t["depends"] !== void 0) {
+    if (!isStringArray(t["depends"])) {
+      throw new Error("Track.depends must be an array of strings");
+    }
+    depends = t["depends"];
+  }
+  let mimeType;
+  if (t["mimeType"] !== void 0) {
+    if (!isString(t["mimeType"])) {
+      throw new Error("Track.mimeType must be a string");
+    }
+    mimeType = t["mimeType"];
+  }
+  let width;
+  if (t["width"] !== void 0) {
+    if (!isNumber(t["width"])) {
+      throw new Error("Track.width must be a number");
+    }
+    width = t["width"];
+  }
+  let height;
+  if (t["height"] !== void 0) {
+    if (!isNumber(t["height"])) {
+      throw new Error("Track.height must be a number");
+    }
+    height = t["height"];
+  }
+  let timescale;
+  if (t["timescale"] !== void 0) {
+    if (!isNumber(t["timescale"])) {
+      throw new Error("Track.timescale must be a number");
+    }
+    timescale = t["timescale"];
+  }
+  let bitrate;
+  if (t["bitrate"] !== void 0) {
+    if (!isNumber(t["bitrate"])) {
+      throw new Error("Track.bitrate must be a number");
+    }
+    bitrate = t["bitrate"];
+  }
+  let initData;
+  if (t["initData"] !== void 0) {
+    if (!isString(t["initData"])) {
+      throw new Error("Track.initData must be a string");
+    }
+    if (!isValidBase64(t["initData"])) {
+      throw new Error("Track.initData must be a valid base64 string");
+    }
+    initData = t["initData"];
+  }
+  if (packaging === "cmaf" && (!codec || codec.length === 0)) {
+    throw new Error("codec is required when packaging is 'cmaf'");
+  }
+  if (packaging === "timeline" && mimeType !== "text/csv") {
+    throw new Error("mimeType must be 'text/csv' when packaging is 'timeline'");
+  }
+  if (packaging === "timeline" && (!depends || depends.length === 0)) {
+    throw new Error("At least one dependee must be present when packaging is 'timeline'");
+  }
+  const result = {
+    name,
+    packaging,
+    role
+  };
+  if (codec !== void 0) result.codec = codec;
+  if (depends !== void 0) result.depends = depends;
+  if (mimeType !== void 0) result.mimeType = mimeType;
+  if (width !== void 0) result.width = width;
+  if (height !== void 0) result.height = height;
+  if (timescale !== void 0) result.timescale = timescale;
+  if (bitrate !== void 0) result.bitrate = bitrate;
+  if (initData !== void 0) result.initData = initData;
+  return result;
+}
+function validateCMSF(obj) {
+  if (typeof obj !== "object" || obj === null) {
+    throw new Error("CMSF must be an object");
+  }
+  const o = obj;
+  if (!isNumber(o["version"])) {
+    throw new Error("CMSF.version must be a number");
+  }
+  if (!Array.isArray(o["tracks"])) {
+    throw new Error("CMSF.tracks must be an array");
+  }
+  const version = o["version"];
+  const tracksArray = o["tracks"];
+  const tracks = tracksArray.map(validateTrack);
+  return {
+    version,
+    tracks
+  };
+}
+var CMSFCatalog = class _CMSFCatalog {
+  #catalog;
+  constructor(catalog) {
+    this.#catalog = catalog;
+  }
+  static from(payload) {
+    const decoder = new TextDecoder();
+    const json = decoder.decode(payload);
+    const catalog = validateCMSF(JSON.parse(json));
+    return new _CMSFCatalog(catalog);
+  }
+  getByTrackName(trackName) {
+    return this.#catalog.tracks.find((track) => track.name === this.extractTrackName(trackName));
+  }
+  getTracks(role) {
+    if (role) return this.#catalog.tracks.filter((track) => track.role === role);
+    return this.#catalog.tracks;
+  }
+  getVideo(index = 0) {
+    const videos = this.#catalog.tracks.filter((track) => track.role === "video");
+    if (index < 0 || index >= videos.length) return void 0;
+    return videos[index];
+  }
+  getAudio(index = 0) {
+    const audios = this.#catalog.tracks.filter((track) => track.role === "audio");
+    if (index < 0 || index >= audios.length) return void 0;
+    return audios[index];
+  }
+  getTimeline(index = 0) {
+    const timelines = this.#catalog.tracks.filter((track) => track.role === "timeline");
+    if (index < 0 || index >= timelines.length) return void 0;
+    return timelines[index];
+  }
+  getCodecString(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    if (!track.codec) throw new Error(`Track ${trackName} does not have a codec`);
+    return track.codec;
+  }
+  getRole(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    return track.role;
+  }
+  getPackaging(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    return track.packaging;
+  }
+  isCMAF(trackName) {
+    const packaging = this.getPackaging(trackName);
+    return packaging === "cmaf" || packaging === "chunk-per-object";
+  }
+  getTimescale(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    return track?.timescale;
+  }
+  getInitData(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    if (!track.initData) throw new Error(`Track ${trackName} does not have initData`);
+    return new Uint8Array(
+      atob(track.initData).split("").map((c) => c.charCodeAt(0))
+    );
+  }
+  extractTrackName(input) {
+    const parts = input.split("/");
+    return parts[parts.length - 1];
+  }
+};
+
 // src/model/error/error.ts
 var MOQtailError = class extends Error {
   constructor(cause) {
@@ -4711,6 +4924,7 @@ exports.AudioLevel = AudioLevel;
 exports.AuthorizationToken = AuthorizationToken;
 exports.BaseByteBuffer = BaseByteBuffer12;
 exports.ByteBuffer = ByteBuffer;
+exports.CMSFCatalog = CMSFCatalog;
 exports.CaptureTimestamp = CaptureTimestamp;
 exports.CastingError = CastingError;
 exports.ClientSetup = ClientSetup;

package/dist/{model/index.d.ts → model.d.cts}

@@ -1,6 +1,55 @@
-import { m as FullTrackName, K as KeyValuePair, F as FrozenByteBuffer, B as BaseByteBuffer } from '../byte_buffer-BM4uNj4n.js';
-export { a as ByteBuffer, D as DatagramObject, h as DatagramStatus, e as FetchHeaderType, j as FetchObject, L as Location, l as MAX_FULL_TRACK_NAME_LENGTH, k as MAX_NAMESPACE_TUPLE_COUNT, M as MAX_REASON_PHRASE_LEN, n as MoqtObject, O as ObjectDatagramStatusType, d as ObjectDatagramType, f as ObjectForwardingPreference, g as ObjectStatus, R as ReasonPhrase, S as SubgroupHeaderType, o as SubgroupObject, c as Tuple, T as TupleField, b as isBytes, i as isVarInt } from '../byte_buffer-BM4uNj4n.js';
-export { ah as AuthTokenVariant, ai as AuthorizationToken, C as ClientSetup, a9 as CommonType, w as ControlMessage, d as ControlMessageType, D as DRAFT_14, am as DeliveryTimeout, x as Fetch, y as FetchCancel, z as FetchError, l as FetchErrorCode, a0 as FetchHeader, A as FetchOk, h as FetchType, F as FilterType, B as GoAway, G as GroupOrder, a3 as Header, al as MaxAuthTokenCacheSize, an as MaxCacheDuration, M as MaxRequestId, aj as MaxRequestIdParameter, a8 as Parameter, ak as Path, L as Publish, K as PublishDone, q as PublishDoneStatusCode, N as PublishError, u as PublishErrorCode, P as PublishNamespace, c as PublishNamespaceCancel, Z as PublishNamespaceDone, a as PublishNamespaceError, f as PublishNamespaceErrorCode, b as PublishNamespaceOk, O as PublishOk, a2 as RequestIdMap, R as RequestsBlocked, E as ServerSetup, a4 as SetupParameter, ab as SetupParameterType, a5 as SetupParameters, a1 as SubgroupHeader, S as Subscribe, Q as SubscribeError, k as SubscribeErrorCode, H as SubscribeNamespace, I as SubscribeNamespaceError, n as SubscribeNamespaceErrorCode, J as SubscribeNamespaceOk, U as SubscribeOk, V as SubscribeUpdate, af as TokenAliasType, W as TrackStatus, T as TrackStatusCode, X as TrackStatusError, Y as TrackStatusOk, _ as Unsubscribe, $ as UnsubscribeNamespace, a6 as VersionSpecificParameter, ad as VersionSpecificParameterType, a7 as VersionSpecificParameters, aa as commonTypeFromNumber, e as controlMessageTypeFromBigInt, m as fetchErrorCodeFromBigInt, i as fetchTypeFromBigInt, g as filterTypeFromBigInt, j as groupOrderFromNumber, r as publishDoneStatusCodeFromBigInt, v as publishErrorCodeFromBigInt, p as publishNamespaceErrorCodeFromBigInt, ac as setupParameterTypeFromNumber, s as subscribeErrorCodeFromBigInt, o as subscribeNamespaceErrorCodeFromBigInt, ag as tokenAliasTypeFromNumber, t as trackStatusCodeFromBigInt, ae as versionSpecificParameterTypeFromNumber } from '../version_parameter-f75NkWiO.js';
+import { s as FullTrackName, K as KeyValuePair, r as FrozenByteBuffer, B as BaseByteBuffer } from './version_parameter-DXBOBueW.cjs';
+export { A as AuthTokenVariant, a as AuthorizationToken, b as ByteBuffer, C as ClientSetup, c as CommonType, d as ControlMessage, e as ControlMessageType, D as DRAFT_14, f as DatagramObject, g as DatagramStatus, h as DeliveryTimeout, F as Fetch, i as FetchCancel, j as FetchError, k as FetchErrorCode, l as FetchHeader, m as FetchHeaderType, n as FetchObject, o as FetchOk, p as FetchType, q as FilterType, G as GoAway, t as GroupOrder, H as Header, L as Location, M as MAX_FULL_TRACK_NAME_LENGTH, u as MAX_NAMESPACE_TUPLE_COUNT, v as MAX_REASON_PHRASE_LEN, w as MaxAuthTokenCacheSize, x as MaxCacheDuration, y as MaxRequestId, z as MaxRequestIdParameter, E as MoqtObject, O as ObjectDatagramStatusType, I as ObjectDatagramType, J as ObjectForwardingPreference, N as ObjectStatus, P as Parameter, Q as Path, R as Publish, S as PublishDone, T as PublishDoneStatusCode, U as PublishError, V as PublishErrorCode, W as PublishNamespace, X as PublishNamespaceCancel, Y as PublishNamespaceDone, Z as PublishNamespaceError, _ as PublishNamespaceErrorCode, $ as PublishNamespaceOk, a0 as PublishOk, a1 as ReasonPhrase, a2 as RequestIdMap, a3 as RequestsBlocked, a4 as ServerSetup, a5 as SetupParameter, a6 as SetupParameterType, a7 as SetupParameters, a8 as SubgroupHeader, a9 as SubgroupHeaderType, aa as SubgroupObject, ab as Subscribe, ac as SubscribeError, ad as SubscribeErrorCode, ae as SubscribeNamespace, af as SubscribeNamespaceError, ag as SubscribeNamespaceErrorCode, ah as SubscribeNamespaceOk, ai as SubscribeOk, aj as SubscribeUpdate, ak as TokenAliasType, al as TrackStatus, am as TrackStatusCode, an as TrackStatusError, ao as TrackStatusOk, ap as Tuple, aq as TupleField, ar as Unsubscribe, as as UnsubscribeNamespace, at as VersionSpecificParameter, au as VersionSpecificParameterType, av as VersionSpecificParameters, aw as commonTypeFromNumber, ax as controlMessageTypeFromBigInt, ay as fetchErrorCodeFromBigInt, az as fetchTypeFromBigInt, aA as filterTypeFromBigInt, aB as groupOrderFromNumber, aC as isBytes, aD as isVarInt, aE as publishDoneStatusCodeFromBigInt, aF as publishErrorCodeFromBigInt, aG as publishNamespaceErrorCodeFromBigInt, aH as setupParameterTypeFromNumber, aI as subscribeErrorCodeFromBigInt, aJ as subscribeNamespaceErrorCodeFromBigInt, aK as tokenAliasTypeFromNumber, aL as trackStatusCodeFromBigInt, aM as versionSpecificParameterTypeFromNumber } from './version_parameter-DXBOBueW.cjs';
+
+/**
+ * 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.
+ */
+interface CMSFTrack {
+    name: string;
+    packaging: 'cmaf' | 'chunk-per-object' | 'timeline';
+    codec?: string;
+    role: 'video' | 'audio' | 'timeline';
+    depends?: string[];
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    timescale?: number;
+    bitrate?: number;
+    initData?: string;
+}
+interface CMSF {
+    version: number;
+    tracks: CMSFTrack[];
+}
+declare class CMSFCatalog {
+    #private;
+    private constructor();
+    static from(payload: ArrayBufferLike): CMSFCatalog;
+    getByTrackName(trackName: string): CMSFTrack | undefined;
+    getTracks(role?: CMSF['tracks'][number]['role']): CMSFTrack[];
+    getVideo(index?: number): CMSFTrack | undefined;
+    getAudio(index?: number): CMSFTrack | undefined;
+    getTimeline(index?: number): CMSFTrack | undefined;
+    getCodecString(trackName: string): string | undefined;
+    getRole(trackName: string): "timeline" | "video" | "audio" | undefined;
+    getPackaging(trackName: string): "cmaf" | "chunk-per-object" | "timeline" | undefined;
+    isCMAF(trackName: string): boolean;
+    getTimescale(trackName: string): number | undefined;
+    getInitData(trackName: string): Uint8Array<ArrayBuffer> | undefined;
+    private extractTrackName;
+}
 
 /**
  * Copyright 2025 The MOQtail Authors
@@ -359,4 +408,4 @@ declare class ExtensionHeaders {
     static fromKeyValuePairs(kvps: KeyValuePair[]): ExtensionHeader[];
 }
 
-export { AudioLevel, BaseByteBuffer, CaptureTimestamp, CastingError, ExtensionHeader, ExtensionHeaders, FrozenByteBuffer, FullTrackName, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, KeyValuePair, LOCHeaderExtensionId, LengthExceedsMaxError, MOQtailError, NotEnoughBytesError, ProtocolViolationError, RequestIdError, Switch, TerminationCode, TerminationError, TimeoutError, TrackNameError, VarIntOverflowError, VideoConfig, VideoFrameMarking, locHeaderExtensionIdFromNumber };
+export { AudioLevel, BaseByteBuffer, type CMSF, CMSFCatalog, type CMSFTrack, CaptureTimestamp, CastingError, ExtensionHeader, ExtensionHeaders, FrozenByteBuffer, FullTrackName, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, KeyValuePair, LOCHeaderExtensionId, LengthExceedsMaxError, MOQtailError, NotEnoughBytesError, ProtocolViolationError, RequestIdError, Switch, TerminationCode, TerminationError, TimeoutError, TrackNameError, VarIntOverflowError, VideoConfig, VideoFrameMarking, locHeaderExtensionIdFromNumber };

package/dist/{model/index.d.cts → model.d.ts}

@@ -1,6 +1,55 @@
-import { m as FullTrackName, K as KeyValuePair, F as FrozenByteBuffer, B as BaseByteBuffer } from '../byte_buffer-BM4uNj4n.cjs';
-export { a as ByteBuffer, D as DatagramObject, h as DatagramStatus, e as FetchHeaderType, j as FetchObject, L as Location, l as MAX_FULL_TRACK_NAME_LENGTH, k as MAX_NAMESPACE_TUPLE_COUNT, M as MAX_REASON_PHRASE_LEN, n as MoqtObject, O as ObjectDatagramStatusType, d as ObjectDatagramType, f as ObjectForwardingPreference, g as ObjectStatus, R as ReasonPhrase, S as SubgroupHeaderType, o as SubgroupObject, c as Tuple, T as TupleField, b as isBytes, i as isVarInt } from '../byte_buffer-BM4uNj4n.cjs';
-export { ah as AuthTokenVariant, ai as AuthorizationToken, C as ClientSetup, a9 as CommonType, w as ControlMessage, d as ControlMessageType, D as DRAFT_14, am as DeliveryTimeout, x as Fetch, y as FetchCancel, z as FetchError, l as FetchErrorCode, a0 as FetchHeader, A as FetchOk, h as FetchType, F as FilterType, B as GoAway, G as GroupOrder, a3 as Header, al as MaxAuthTokenCacheSize, an as MaxCacheDuration, M as MaxRequestId, aj as MaxRequestIdParameter, a8 as Parameter, ak as Path, L as Publish, K as PublishDone, q as PublishDoneStatusCode, N as PublishError, u as PublishErrorCode, P as PublishNamespace, c as PublishNamespaceCancel, Z as PublishNamespaceDone, a as PublishNamespaceError, f as PublishNamespaceErrorCode, b as PublishNamespaceOk, O as PublishOk, a2 as RequestIdMap, R as RequestsBlocked, E as ServerSetup, a4 as SetupParameter, ab as SetupParameterType, a5 as SetupParameters, a1 as SubgroupHeader, S as Subscribe, Q as SubscribeError, k as SubscribeErrorCode, H as SubscribeNamespace, I as SubscribeNamespaceError, n as SubscribeNamespaceErrorCode, J as SubscribeNamespaceOk, U as SubscribeOk, V as SubscribeUpdate, af as TokenAliasType, W as TrackStatus, T as TrackStatusCode, X as TrackStatusError, Y as TrackStatusOk, _ as Unsubscribe, $ as UnsubscribeNamespace, a6 as VersionSpecificParameter, ad as VersionSpecificParameterType, a7 as VersionSpecificParameters, aa as commonTypeFromNumber, e as controlMessageTypeFromBigInt, m as fetchErrorCodeFromBigInt, i as fetchTypeFromBigInt, g as filterTypeFromBigInt, j as groupOrderFromNumber, r as publishDoneStatusCodeFromBigInt, v as publishErrorCodeFromBigInt, p as publishNamespaceErrorCodeFromBigInt, ac as setupParameterTypeFromNumber, s as subscribeErrorCodeFromBigInt, o as subscribeNamespaceErrorCodeFromBigInt, ag as tokenAliasTypeFromNumber, t as trackStatusCodeFromBigInt, ae as versionSpecificParameterTypeFromNumber } from '../version_parameter-BpmuiMQj.cjs';
+import { s as FullTrackName, K as KeyValuePair, r as FrozenByteBuffer, B as BaseByteBuffer } from './version_parameter-DXBOBueW.js';
+export { A as AuthTokenVariant, a as AuthorizationToken, b as ByteBuffer, C as ClientSetup, c as CommonType, d as ControlMessage, e as ControlMessageType, D as DRAFT_14, f as DatagramObject, g as DatagramStatus, h as DeliveryTimeout, F as Fetch, i as FetchCancel, j as FetchError, k as FetchErrorCode, l as FetchHeader, m as FetchHeaderType, n as FetchObject, o as FetchOk, p as FetchType, q as FilterType, G as GoAway, t as GroupOrder, H as Header, L as Location, M as MAX_FULL_TRACK_NAME_LENGTH, u as MAX_NAMESPACE_TUPLE_COUNT, v as MAX_REASON_PHRASE_LEN, w as MaxAuthTokenCacheSize, x as MaxCacheDuration, y as MaxRequestId, z as MaxRequestIdParameter, E as MoqtObject, O as ObjectDatagramStatusType, I as ObjectDatagramType, J as ObjectForwardingPreference, N as ObjectStatus, P as Parameter, Q as Path, R as Publish, S as PublishDone, T as PublishDoneStatusCode, U as PublishError, V as PublishErrorCode, W as PublishNamespace, X as PublishNamespaceCancel, Y as PublishNamespaceDone, Z as PublishNamespaceError, _ as PublishNamespaceErrorCode, $ as PublishNamespaceOk, a0 as PublishOk, a1 as ReasonPhrase, a2 as RequestIdMap, a3 as RequestsBlocked, a4 as ServerSetup, a5 as SetupParameter, a6 as SetupParameterType, a7 as SetupParameters, a8 as SubgroupHeader, a9 as SubgroupHeaderType, aa as SubgroupObject, ab as Subscribe, ac as SubscribeError, ad as SubscribeErrorCode, ae as SubscribeNamespace, af as SubscribeNamespaceError, ag as SubscribeNamespaceErrorCode, ah as SubscribeNamespaceOk, ai as SubscribeOk, aj as SubscribeUpdate, ak as TokenAliasType, al as TrackStatus, am as TrackStatusCode, an as TrackStatusError, ao as TrackStatusOk, ap as Tuple, aq as TupleField, ar as Unsubscribe, as as UnsubscribeNamespace, at as VersionSpecificParameter, au as VersionSpecificParameterType, av as VersionSpecificParameters, aw as commonTypeFromNumber, ax as controlMessageTypeFromBigInt, ay as fetchErrorCodeFromBigInt, az as fetchTypeFromBigInt, aA as filterTypeFromBigInt, aB as groupOrderFromNumber, aC as isBytes, aD as isVarInt, aE as publishDoneStatusCodeFromBigInt, aF as publishErrorCodeFromBigInt, aG as publishNamespaceErrorCodeFromBigInt, aH as setupParameterTypeFromNumber, aI as subscribeErrorCodeFromBigInt, aJ as subscribeNamespaceErrorCodeFromBigInt, aK as tokenAliasTypeFromNumber, aL as trackStatusCodeFromBigInt, aM as versionSpecificParameterTypeFromNumber } from './version_parameter-DXBOBueW.js';
+
+/**
+ * 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.
+ */
+interface CMSFTrack {
+    name: string;
+    packaging: 'cmaf' | 'chunk-per-object' | 'timeline';
+    codec?: string;
+    role: 'video' | 'audio' | 'timeline';
+    depends?: string[];
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    timescale?: number;
+    bitrate?: number;
+    initData?: string;
+}
+interface CMSF {
+    version: number;
+    tracks: CMSFTrack[];
+}
+declare class CMSFCatalog {
+    #private;
+    private constructor();
+    static from(payload: ArrayBufferLike): CMSFCatalog;
+    getByTrackName(trackName: string): CMSFTrack | undefined;
+    getTracks(role?: CMSF['tracks'][number]['role']): CMSFTrack[];
+    getVideo(index?: number): CMSFTrack | undefined;
+    getAudio(index?: number): CMSFTrack | undefined;
+    getTimeline(index?: number): CMSFTrack | undefined;
+    getCodecString(trackName: string): string | undefined;
+    getRole(trackName: string): "timeline" | "video" | "audio" | undefined;
+    getPackaging(trackName: string): "cmaf" | "chunk-per-object" | "timeline" | undefined;
+    isCMAF(trackName: string): boolean;
+    getTimescale(trackName: string): number | undefined;
+    getInitData(trackName: string): Uint8Array<ArrayBuffer> | undefined;
+    private extractTrackName;
+}
 
 /**
  * Copyright 2025 The MOQtail Authors
@@ -359,4 +408,4 @@ declare class ExtensionHeaders {
     static fromKeyValuePairs(kvps: KeyValuePair[]): ExtensionHeader[];
 }
 
-export { AudioLevel, BaseByteBuffer, CaptureTimestamp, CastingError, ExtensionHeader, ExtensionHeaders, FrozenByteBuffer, FullTrackName, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, KeyValuePair, LOCHeaderExtensionId, LengthExceedsMaxError, MOQtailError, NotEnoughBytesError, ProtocolViolationError, RequestIdError, Switch, TerminationCode, TerminationError, TimeoutError, TrackNameError, VarIntOverflowError, VideoConfig, VideoFrameMarking, locHeaderExtensionIdFromNumber };
+export { AudioLevel, BaseByteBuffer, type CMSF, CMSFCatalog, type CMSFTrack, CaptureTimestamp, CastingError, ExtensionHeader, ExtensionHeaders, FrozenByteBuffer, FullTrackName, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, KeyValuePair, LOCHeaderExtensionId, LengthExceedsMaxError, MOQtailError, NotEnoughBytesError, ProtocolViolationError, RequestIdError, Switch, TerminationCode, TerminationError, TimeoutError, TrackNameError, VarIntOverflowError, VideoConfig, VideoFrameMarking, locHeaderExtensionIdFromNumber };

package/dist/{model/index.js → model.js}

@@ -1,3 +1,216 @@
+// src/model/catalog/cmsf.ts
+function isString(v) {
+  return typeof v === "string";
+}
+function isNumber(v) {
+  return typeof v === "number";
+}
+function isStringArray(v) {
+  return Array.isArray(v) && v.every((item) => isString(item));
+}
+function isValidPackaging(v) {
+  return v === "cmaf" || v === "chunk-per-object" || v === "timeline";
+}
+function isValidRole(v) {
+  return v === "video" || v === "audio" || v === "timeline";
+}
+function isValidBase64(str) {
+  try {
+    return btoa(atob(str)) === str;
+  } catch {
+    return false;
+  }
+}
+function validateTrack(track) {
+  if (typeof track !== "object" || track === null) {
+    throw new Error("Track must be an object");
+  }
+  const t = track;
+  if (!isString(t["name"])) {
+    throw new Error("Track.name must be a string");
+  }
+  if (!isValidPackaging(t["packaging"])) {
+    throw new Error("Track.packaging must be 'cmaf', 'chunk-per-object', or 'timeline'");
+  }
+  if (!isValidRole(t["role"])) {
+    throw new Error("Track.role must be 'video', 'audio', or 'timeline'");
+  }
+  const name = t["name"];
+  const packaging = t["packaging"];
+  const role = t["role"];
+  let codec;
+  if (t["codec"] !== void 0) {
+    if (!isString(t["codec"])) {
+      throw new Error("Track.codec must be a string");
+    }
+    codec = t["codec"];
+  }
+  let depends;
+  if (t["depends"] !== void 0) {
+    if (!isStringArray(t["depends"])) {
+      throw new Error("Track.depends must be an array of strings");
+    }
+    depends = t["depends"];
+  }
+  let mimeType;
+  if (t["mimeType"] !== void 0) {
+    if (!isString(t["mimeType"])) {
+      throw new Error("Track.mimeType must be a string");
+    }
+    mimeType = t["mimeType"];
+  }
+  let width;
+  if (t["width"] !== void 0) {
+    if (!isNumber(t["width"])) {
+      throw new Error("Track.width must be a number");
+    }
+    width = t["width"];
+  }
+  let height;
+  if (t["height"] !== void 0) {
+    if (!isNumber(t["height"])) {
+      throw new Error("Track.height must be a number");
+    }
+    height = t["height"];
+  }
+  let timescale;
+  if (t["timescale"] !== void 0) {
+    if (!isNumber(t["timescale"])) {
+      throw new Error("Track.timescale must be a number");
+    }
+    timescale = t["timescale"];
+  }
+  let bitrate;
+  if (t["bitrate"] !== void 0) {
+    if (!isNumber(t["bitrate"])) {
+      throw new Error("Track.bitrate must be a number");
+    }
+    bitrate = t["bitrate"];
+  }
+  let initData;
+  if (t["initData"] !== void 0) {
+    if (!isString(t["initData"])) {
+      throw new Error("Track.initData must be a string");
+    }
+    if (!isValidBase64(t["initData"])) {
+      throw new Error("Track.initData must be a valid base64 string");
+    }
+    initData = t["initData"];
+  }
+  if (packaging === "cmaf" && (!codec || codec.length === 0)) {
+    throw new Error("codec is required when packaging is 'cmaf'");
+  }
+  if (packaging === "timeline" && mimeType !== "text/csv") {
+    throw new Error("mimeType must be 'text/csv' when packaging is 'timeline'");
+  }
+  if (packaging === "timeline" && (!depends || depends.length === 0)) {
+    throw new Error("At least one dependee must be present when packaging is 'timeline'");
+  }
+  const result = {
+    name,
+    packaging,
+    role
+  };
+  if (codec !== void 0) result.codec = codec;
+  if (depends !== void 0) result.depends = depends;
+  if (mimeType !== void 0) result.mimeType = mimeType;
+  if (width !== void 0) result.width = width;
+  if (height !== void 0) result.height = height;
+  if (timescale !== void 0) result.timescale = timescale;
+  if (bitrate !== void 0) result.bitrate = bitrate;
+  if (initData !== void 0) result.initData = initData;
+  return result;
+}
+function validateCMSF(obj) {
+  if (typeof obj !== "object" || obj === null) {
+    throw new Error("CMSF must be an object");
+  }
+  const o = obj;
+  if (!isNumber(o["version"])) {
+    throw new Error("CMSF.version must be a number");
+  }
+  if (!Array.isArray(o["tracks"])) {
+    throw new Error("CMSF.tracks must be an array");
+  }
+  const version = o["version"];
+  const tracksArray = o["tracks"];
+  const tracks = tracksArray.map(validateTrack);
+  return {
+    version,
+    tracks
+  };
+}
+var CMSFCatalog = class _CMSFCatalog {
+  #catalog;
+  constructor(catalog) {
+    this.#catalog = catalog;
+  }
+  static from(payload) {
+    const decoder = new TextDecoder();
+    const json = decoder.decode(payload);
+    const catalog = validateCMSF(JSON.parse(json));
+    return new _CMSFCatalog(catalog);
+  }
+  getByTrackName(trackName) {
+    return this.#catalog.tracks.find((track) => track.name === this.extractTrackName(trackName));
+  }
+  getTracks(role) {
+    if (role) return this.#catalog.tracks.filter((track) => track.role === role);
+    return this.#catalog.tracks;
+  }
+  getVideo(index = 0) {
+    const videos = this.#catalog.tracks.filter((track) => track.role === "video");
+    if (index < 0 || index >= videos.length) return void 0;
+    return videos[index];
+  }
+  getAudio(index = 0) {
+    const audios = this.#catalog.tracks.filter((track) => track.role === "audio");
+    if (index < 0 || index >= audios.length) return void 0;
+    return audios[index];
+  }
+  getTimeline(index = 0) {
+    const timelines = this.#catalog.tracks.filter((track) => track.role === "timeline");
+    if (index < 0 || index >= timelines.length) return void 0;
+    return timelines[index];
+  }
+  getCodecString(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    if (!track.codec) throw new Error(`Track ${trackName} does not have a codec`);
+    return track.codec;
+  }
+  getRole(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    return track.role;
+  }
+  getPackaging(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    return track.packaging;
+  }
+  isCMAF(trackName) {
+    const packaging = this.getPackaging(trackName);
+    return packaging === "cmaf" || packaging === "chunk-per-object";
+  }
+  getTimescale(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    return track?.timescale;
+  }
+  getInitData(trackName) {
+    const track = this.#catalog.tracks.find((track2) => track2.name === this.extractTrackName(trackName));
+    if (!track) return void 0;
+    if (!track.initData) throw new Error(`Track ${trackName} does not have initData`);
+    return new Uint8Array(
+      atob(track.initData).split("").map((c) => c.charCodeAt(0))
+    );
+  }
+  extractTrackName(input) {
+    const parts = input.split("/");
+    return parts[parts.length - 1];
+  }
+};
+
 // src/model/error/error.ts
 var MOQtailError = class extends Error {
   constructor(cause) {
@@ -4705,4 +4918,4 @@ var VersionSpecificParameters = class {
   }
 };
 
-export { AudioLevel, AuthorizationToken, BaseByteBuffer12 as BaseByteBuffer, ByteBuffer, CaptureTimestamp, CastingError, ClientSetup, CommonType, ControlMessage, ControlMessageType, DRAFT_14, DatagramObject, DatagramStatus, DeliveryTimeout, ExtensionHeader, ExtensionHeaders, Fetch, FetchCancel, FetchError, FetchErrorCode, FetchHeader, FetchHeaderType, FetchObject, FetchOk, FetchType, FilterType, FrozenByteBuffer5 as FrozenByteBuffer, FullTrackName, GoAway, GroupOrder, Header, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, KeyValuePair, LOCHeaderExtensionId, LengthExceedsMaxError, Location, MAX_FULL_TRACK_NAME_LENGTH, MAX_NAMESPACE_TUPLE_COUNT, MAX_REASON_PHRASE_LEN, MOQtailError, MaxAuthTokenCacheSize, MaxCacheDuration, MaxRequestId, MaxRequestId2 as MaxRequestIdParameter, MoqtObject, NotEnoughBytesError, ObjectDatagramStatusType, ObjectDatagramType, ObjectForwardingPreference, ObjectStatus, Path, ProtocolViolationError, Publish, PublishDone, PublishDoneStatusCode, PublishError, PublishErrorCode, PublishNamespace, PublishNamespaceCancel, PublishNamespaceDone, PublishNamespaceError, PublishNamespaceErrorCode, PublishNamespaceOk, PublishOk, ReasonPhrase, RequestIdError, RequestIdMap, RequestsBlocked, ServerSetup, SetupParameter, SetupParameterType, SetupParameters, SubgroupHeader, SubgroupHeaderType, SubgroupObject, Subscribe, SubscribeError, SubscribeErrorCode, SubscribeNamespace, SubscribeNamespaceError, SubscribeNamespaceErrorCode, SubscribeNamespaceOk, SubscribeOk, SubscribeUpdate, Switch, TerminationCode, TerminationError, TimeoutError, TokenAliasType, TrackNameError, TrackStatus, TrackStatusCode, TrackStatusError, TrackStatusOk, Tuple, TupleField, Unsubscribe, UnsubscribeNamespace, VarIntOverflowError, VersionSpecificParameter, VersionSpecificParameterType, VersionSpecificParameters, VideoConfig, VideoFrameMarking, commonTypeFromNumber, controlMessageTypeFromBigInt, fetchErrorCodeFromBigInt, fetchTypeFromBigInt, filterTypeFromBigInt, groupOrderFromNumber, isBytes, isVarInt, locHeaderExtensionIdFromNumber, publishDoneStatusCodeFromBigInt, publishErrorCodeFromBigInt, publishNamespaceErrorCodeFromBigInt, setupParameterTypeFromNumber, subscribeErrorCodeFromBigInt, subscribeNamespaceErrorCodeFromBigInt, tokenAliasTypeFromNumber, trackStatusCodeFromBigInt, versionSpecificParameterTypeFromNumber };
+export { AudioLevel, AuthorizationToken, BaseByteBuffer12 as BaseByteBuffer, ByteBuffer, CMSFCatalog, CaptureTimestamp, CastingError, ClientSetup, CommonType, ControlMessage, ControlMessageType, DRAFT_14, DatagramObject, DatagramStatus, DeliveryTimeout, ExtensionHeader, ExtensionHeaders, Fetch, FetchCancel, FetchError, FetchErrorCode, FetchHeader, FetchHeaderType, FetchObject, FetchOk, FetchType, FilterType, FrozenByteBuffer5 as FrozenByteBuffer, FullTrackName, GoAway, GroupOrder, Header, InternalError, InvalidTypeError, InvalidUTF8Error, KeyValueFormattingError, KeyValuePair, LOCHeaderExtensionId, LengthExceedsMaxError, Location, MAX_FULL_TRACK_NAME_LENGTH, MAX_NAMESPACE_TUPLE_COUNT, MAX_REASON_PHRASE_LEN, MOQtailError, MaxAuthTokenCacheSize, MaxCacheDuration, MaxRequestId, MaxRequestId2 as MaxRequestIdParameter, MoqtObject, NotEnoughBytesError, ObjectDatagramStatusType, ObjectDatagramType, ObjectForwardingPreference, ObjectStatus, Path, ProtocolViolationError, Publish, PublishDone, PublishDoneStatusCode, PublishError, PublishErrorCode, PublishNamespace, PublishNamespaceCancel, PublishNamespaceDone, PublishNamespaceError, PublishNamespaceErrorCode, PublishNamespaceOk, PublishOk, ReasonPhrase, RequestIdError, RequestIdMap, RequestsBlocked, ServerSetup, SetupParameter, SetupParameterType, SetupParameters, SubgroupHeader, SubgroupHeaderType, SubgroupObject, Subscribe, SubscribeError, SubscribeErrorCode, SubscribeNamespace, SubscribeNamespaceError, SubscribeNamespaceErrorCode, SubscribeNamespaceOk, SubscribeOk, SubscribeUpdate, Switch, TerminationCode, TerminationError, TimeoutError, TokenAliasType, TrackNameError, TrackStatus, TrackStatusCode, TrackStatusError, TrackStatusOk, Tuple, TupleField, Unsubscribe, UnsubscribeNamespace, VarIntOverflowError, VersionSpecificParameter, VersionSpecificParameterType, VersionSpecificParameters, VideoConfig, VideoFrameMarking, commonTypeFromNumber, controlMessageTypeFromBigInt, fetchErrorCodeFromBigInt, fetchTypeFromBigInt, filterTypeFromBigInt, groupOrderFromNumber, isBytes, isVarInt, locHeaderExtensionIdFromNumber, publishDoneStatusCodeFromBigInt, publishErrorCodeFromBigInt, publishNamespaceErrorCodeFromBigInt, setupParameterTypeFromNumber, subscribeErrorCodeFromBigInt, subscribeNamespaceErrorCodeFromBigInt, tokenAliasTypeFromNumber, trackStatusCodeFromBigInt, versionSpecificParameterTypeFromNumber };