dasha 4.2.1 → 4.3.0

package/README.md

@@ -131,6 +131,30 @@ async function getEnglishSubtitles() {
 }
 ```
 
+### Overriding track metadata
+
+Some services expose track metadata outside the manifest. You can override the parsed language code on any dasha track, and the updated value will be visible through the regular query/filter APIs.
+
+```ts
+import { DASH_FORMATS, Input, UrlSource } from 'dasha';
+
+async function getFrenchAudioTrack() {
+  const input = new Input({
+    source: new UrlSource('https://example.com/manifest.mpd'),
+    formats: DASH_FORMATS,
+  });
+
+  const audioTracks = await input.getAudioTracks();
+  const apiLanguageCode = 'fr';
+
+  audioTracks[0]?.setLanguageCode(apiLanguageCode);
+
+  return await input.getAudioTracks({
+    filter: async (track) => (await track.getLanguageCode()) === apiLanguageCode,
+  });
+}
+```
+
 ### Mediabunny with DASH support
 
 > Only reading is supported

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as _$mediabunny from "mediabunny";
 import { AudioCodec as AudioCodec$1, DurationMetadataRequestOptions, EncodedPacket, FilePathSource, HLS, HLS_FORMATS, Input as Input$1, InputAudioTrack as InputAudioTrack$1, InputFormat, InputOptions, InputTrack as InputTrack$2, InputTrackQuery, InputTrackQuery as InputTrackQuery$1, InputVideoTrack as InputVideoTrack$1, MP3, MP4, MaybePromise, MediaCodec as MediaCodec$1, MetadataTags, PacketRetrievalOptions, PathedSource, Source, SourceRef, SubtitleCodec as SubtitleCodec$1, TrackDisposition, UrlSource, VideoCodec as VideoCodec$1, asc, desc, prefer } from "mediabunny";
-import { Element } from "@xmldom/xmldom";
+import * as _$_xmldom_xmldom0 from "@xmldom/xmldom";
 
 //#region src/mediabunny.d.ts
 type Segment$1 = {
@@ -104,6 +104,7 @@ declare const ROLE_TYPE: {
 type RoleType = (typeof ROLE_TYPE)[keyof typeof ROLE_TYPE];
 //#endregion
 //#region src/dash/dash-misc.d.ts
+type Element = _$_xmldom_xmldom0.Element;
 type DashTrackType = 'video' | 'audio' | 'subtitle';
 type DashEncryptionData = {
   method: string;
@@ -557,16 +558,19 @@ type SegmentAccessMethods = {
   getSegmentedInput(): HlsSegmentedInput | DashSegmentedInput;
   getSegments(): Promise<(HlsSegment | DashSegment)[]>;
 };
+type TrackMetadataOverrideMethods = {
+  setLanguageCode(value: string): void;
+};
 type VideoDynamicRangeMethods = {
   getDynamicRange(): Promise<VideoDynamicRange>;
 };
 type MediabunnySubtitleTrackLike = InputTrack$2 & {
   type: 'subtitle';
 };
-type InputTrack$1 = InputTrack$2 & SegmentAccessMethods;
-type InputVideoTrack = InputVideoTrack$1 & SegmentAccessMethods & VideoDynamicRangeMethods;
-type InputAudioTrack = InputAudioTrack$1 & SegmentAccessMethods;
-type InputSubtitleTrack = MediabunnySubtitleTrackLike & SegmentAccessMethods;
+type InputTrack$1 = InputTrack$2 & SegmentAccessMethods & TrackMetadataOverrideMethods;
+type InputVideoTrack = InputVideoTrack$1 & SegmentAccessMethods & VideoDynamicRangeMethods & TrackMetadataOverrideMethods;
+type InputAudioTrack = InputAudioTrack$1 & SegmentAccessMethods & TrackMetadataOverrideMethods;
+type InputSubtitleTrack = MediabunnySubtitleTrackLike & SegmentAccessMethods & TrackMetadataOverrideMethods;
 type InputSubtitleSource = PathedSource | SourceRef<PathedSource>;
 type InputSubtitleTrackMetadata = {
   codec?: SubtitleCodec | null;

package/dist/index.mjs

@@ -1240,6 +1240,8 @@ const CUSTOM_SUBTITLE_TRACK_ID_OFFSET = 1e9;
 const CUSTOM_PAIRING_BIT_START = 1024n;
 const EXTRA_PAIRING_MASK = Symbol.for("dasha.extra-pairing-mask");
 const ORIGINAL_GET_PAIRING_MASK = Symbol.for("dasha.original-get-pairing-mask");
+const TRACK_METADATA_OVERRIDES = Symbol.for("dasha.track-metadata-overrides");
+const ORIGINAL_GET_LANGUAGE_CODE = Symbol.for("dasha.original-get-language-code");
 const HLS_VARIANT_INF_LINE = "#EXT-X-STREAM-INF:";
 const HLS_DEMUXER_PATCHED = Symbol.for("dasha.hls-demuxer-patched");
 const HLS_DEMUXER_METADATA_PATCH = Symbol.for("dasha.hls-demuxer-metadata-patch");
@@ -1406,13 +1408,26 @@ const patchBaseMediabunnyInput = () => {
 	prototype[BASE_INPUT_PATCHED] = true;
 };
 const getSegmentedInputForTrack = (track) => {
-	const backing = track._backing;
+	const backing = getTrackBacking(track);
 	if ("getSegmentedInput" in backing && typeof backing.getSegmentedInput === "function") return backing.getSegmentedInput();
 	const internalTrack = backing.internalTrack;
 	return internalTrack.demuxer.getSegmentedInputForPath(internalTrack.fullPath);
 };
+const getTrackBacking = (track) => track._backing;
+const getTrackMetadataOverrides = (backing) => backing[TRACK_METADATA_OVERRIDES] ??= {};
+const ensureLanguageCodeOverridePatch = (backing) => {
+	const patchedBacking = backing;
+	if (patchedBacking[ORIGINAL_GET_LANGUAGE_CODE]) return patchedBacking;
+	patchedBacking[ORIGINAL_GET_LANGUAGE_CODE] = backing.getLanguageCode?.bind(backing) ?? (() => "und");
+	Object.assign(backing, { getLanguageCode: () => getTrackMetadataOverrides(patchedBacking).languageCode ?? patchedBacking[ORIGINAL_GET_LANGUAGE_CODE]?.() ?? "und" });
+	return patchedBacking;
+};
+const setTrackLanguageCode = (track, value) => {
+	getTrackMetadataOverrides(ensureLanguageCodeOverridePatch(getTrackBacking(track))).languageCode = value;
+};
 const addSegmentAccess = (track) => new Proxy(track, { get(target, prop) {
 	if (prop === "getDynamicRange" && target instanceof InputVideoTrack) return () => getDynamicRangeForTrack(target);
+	if (prop === "setLanguageCode") return (value) => setTrackLanguageCode(target, value);
 	if (prop === "getSegmentedInput") return () => getSegmentedInputForTrack(target);
 	if (prop === "getSegments") return async () => {
 		const segmentedInput = getSegmentedInputForTrack(target);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dasha",
-  "version": "4.2.1",
+  "version": "4.3.0",
   "description": "Streaming manifest parser",
   "files": [
     "dist"
@@ -52,15 +52,15 @@
     "temporal-polyfill": "^0.3.2"
   },
   "peerDependencies": {
-    "mediabunny": "^1.44.2"
+    "mediabunny": "^1.45.2"
   },
   "devDependencies": {
-    "@types/node": "^25.6.2",
-    "oxfmt": "^0.48.0",
-    "oxlint": "^1.63.0",
+    "@types/node": "^25.8.0",
+    "oxfmt": "^0.50.0",
+    "oxlint": "^1.65.0",
     "tsdown": "^0.22.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.6"
   },
   "scripts": {
     "test": "vitest",