dasha 4.2.2 → 4.3.1

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

@@ -396,6 +396,7 @@ declare abstract class DashTrackBackingBase {
   getNextKeyPacket(packet: EncodedPacket, options: PacketRetrievalOptions): Promise<EncodedPacket | null>;
   getSegmentedInput(): DashSegmentedInput;
   getSegments(): Promise<DashSegment[]>;
+  refreshSegments(): Promise<DashSegment[]>;
 }
 declare class DashInputVideoTrackBacking extends DashTrackBackingBase {
   internalTrack: InternalVideoTrack;
@@ -557,6 +558,10 @@ declare module 'mediabunny' {
 type SegmentAccessMethods = {
   getSegmentedInput(): HlsSegmentedInput | DashSegmentedInput;
   getSegments(): Promise<(HlsSegment | DashSegment)[]>;
+  refreshSegments(): Promise<(HlsSegment | DashSegment)[]>;
+};
+type TrackMetadataOverrideMethods = {
+  setLanguageCode(value: string): void;
 };
 type VideoDynamicRangeMethods = {
   getDynamicRange(): Promise<VideoDynamicRange>;
@@ -564,10 +569,10 @@ type VideoDynamicRangeMethods = {
 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;
@@ -626,8 +631,6 @@ declare class Input<S extends Source = Source> extends SegmentedMediabunnyInput<
   constructor(options: DashaInputOptions<S>);
 }
 declare const isInput: (value: unknown) => value is Input;
-declare const getSegmentedInput: (track: InputTrack$1) => InputSegmentedInput;
-declare const getSegments: (track: InputTrack$1) => Promise<InputSegment[]>;
 declare const ALL_FORMATS: InputFormat[];
 //#endregion
-export { ALL_FORMATS, type AudioCodec, DASH, DASH_FORMATS, type DashSegment, type DashSegmentedInput, FilePathSource, HLS, HLS_FORMATS, type HlsSegment, type HlsSegmentedInput, Input, type InputAudioTrack, InputSegment, InputSegmentedInput, type InputSubtitleSource, type InputSubtitleTrack, type InputSubtitleTrackMetadata, type InputTrack$1 as InputTrack, type InputTrackQuery, type InputTrackWithBacking, type InputVideoTrack, MP3, MP4, type MaybePromise, type MediaCodec, type SubtitleCodec, UrlSource, type VideoCodec, type VideoDynamicRange, asc, desc, getSegmentedInput, getSegments, isInput, prefer, preserveSubtitleBackingsOnInput };
+export { ALL_FORMATS, type AudioCodec, DASH, DASH_FORMATS, type DashSegment, type DashSegmentedInput, FilePathSource, HLS, HLS_FORMATS, type HlsSegment, type HlsSegmentedInput, Input, type InputAudioTrack, InputSegment, InputSegmentedInput, type InputSubtitleSource, type InputSubtitleTrack, type InputSubtitleTrackMetadata, type InputTrack$1 as InputTrack, type InputTrackQuery, type InputTrackWithBacking, type InputVideoTrack, MP3, MP4, type MaybePromise, type MediaCodec, type SubtitleCodec, UrlSource, type VideoCodec, type VideoDynamicRange, asc, desc, isInput, prefer, preserveSubtitleBackingsOnInput };

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,15 +1408,33 @@ 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);
+		if (segmentedInput.segments.length === 0) await segmentedInput.runUpdateSegments();
+		return segmentedInput.segments;
+	};
+	if (prop === "refreshSegments") return async () => {
 		const segmentedInput = getSegmentedInputForTrack(target);
 		await segmentedInput.runUpdateSegments();
 		return segmentedInput.segments;
@@ -2655,6 +2675,11 @@ var DashTrackBackingBase = class {
 		return this.internalTrack.demuxer.getSegmentedInputForTrack(this.internalTrack);
 	}
 	async getSegments() {
+		const segmentedInput = this.getSegmentedInput();
+		if (segmentedInput.segments.length === 0) await segmentedInput.runUpdateSegments();
+		return segmentedInput.segments;
+	}
+	async refreshSegments() {
 		const segmentedInput = this.getSegmentedInput();
 		await segmentedInput.runUpdateSegments();
 		return segmentedInput.segments;
@@ -2772,8 +2797,6 @@ var Input = class extends SegmentedMediabunnyInput {
 	}
 };
 const isInput = (value) => value instanceof Input;
-const getSegmentedInput = (track) => track.getSegmentedInput();
-const getSegments = async (track) => track.getSegments();
 const ALL_FORMATS = [...ALL_FORMATS$1, DASH];
 //#endregion
-export { ALL_FORMATS, DASH, DASH_FORMATS, FilePathSource, HLS, HLS_FORMATS, Input, MP3, MP4, UrlSource, asc, desc, getSegmentedInput, getSegments, isInput, prefer, preserveSubtitleBackingsOnInput };
+export { ALL_FORMATS, DASH, DASH_FORMATS, FilePathSource, HLS, HLS_FORMATS, Input, MP3, MP4, UrlSource, asc, desc, isInput, prefer, preserveSubtitleBackingsOnInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dasha",
-  "version": "4.2.2",
+  "version": "4.3.1",
   "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",