@francofantomius/jellyfin 0.4.0 → 0.4.1

package/README.md

@@ -6,7 +6,7 @@ A modern, lightweight, modular, and type-safe Jellyfin SDK for Node.js and the B
 [![Documentation](https://img.shields.io/badge/docs-Material%20Design%203-6f42c1.svg)](https://francofantomius.github.io/jellyfin-sdk/)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**Current Version: `v0.4.0`** (THE PROJECT IS BEING ACTIVELY DEVELOPED. WAIT FOR VERSION 0.5.0 TO USE IT)
+**Current Version: `v0.4.1`** (THE PROJECT IS BEING ACTIVELY DEVELOPED. WAIT FOR VERSION 0.5.0 TO USE IT)
 
 
 ---

package/dist/index.cjs

@@ -1188,6 +1188,7 @@ var MediaModule = class {
     const qualityResolved = resolveAudioQuality(options.quality);
     const maxStreamingBitrate = options.maxStreamingBitrate ?? qualityResolved.maxStreamingBitrate;
     const {
+      mediaSourceId,
       static: isStatic = false,
       startTimeTicks = 0,
       container = "opus,mp3|mp3,aac,m4a,m4b,flac,wav,ogg",
@@ -1198,12 +1199,14 @@ var MediaModule = class {
     const endpoint = isStatic ? `/Audio/${itemId}/stream` : `/Audio/${itemId}/universal`;
     const url = new URL(`${serverUrl}${endpoint}`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
     if (userId) url.searchParams.append("UserId", userId);
     const targetDeviceId = options.deviceId !== void 0 ? options.deviceId : clientInfo.deviceId;
     if (targetDeviceId) url.searchParams.append("DeviceId", targetDeviceId);
+    if (mediaSourceId) url.searchParams.append("MediaSourceId", mediaSourceId);
     if (isStatic) {
       url.searchParams.append("static", "true");
     } else {
@@ -1234,6 +1237,7 @@ var MediaModule = class {
     const qualityResolved = resolveAudioQuality(options.quality);
     const maxStreamingBitrate = options.maxStreamingBitrate ?? qualityResolved.maxStreamingBitrate;
     const {
+      mediaSourceId,
       startTimeTicks = 0,
       audioCodec = "aac,mp3",
       segmentLength = 3,
@@ -1241,13 +1245,16 @@ var MediaModule = class {
     } = options;
     const url = new URL(`${serverUrl}/Audio/${itemId}/master.m3u8`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
     if (userId) url.searchParams.append("UserId", userId);
     const targetDeviceId = options.deviceId !== void 0 ? options.deviceId : clientInfo.deviceId;
     if (targetDeviceId) url.searchParams.append("DeviceId", targetDeviceId);
-    url.searchParams.append("MediaSourceId", itemId);
+    if (mediaSourceId) {
+      url.searchParams.append("MediaSourceId", mediaSourceId);
+    }
     url.searchParams.append("AudioCodec", audioCodec);
     url.searchParams.append("TranscodingContainer", "ts");
     url.searchParams.append("TranscodingProtocol", "hls");
@@ -1293,6 +1300,7 @@ var MediaModule = class {
     const endpoint = container && !container.includes(",") ? `/Videos/${itemId}/stream.${container}` : `/Videos/${itemId}/stream`;
     const url = new URL(`${serverUrl}${endpoint}`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
@@ -1358,6 +1366,7 @@ var MediaModule = class {
     } = options;
     const url = new URL(`${serverUrl}/Videos/${itemId}/master.m3u8`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
@@ -1400,6 +1409,7 @@ var MediaModule = class {
     const sourceId = mediaSourceId || itemId;
     const url = new URL(`${serverUrl}/Videos/${itemId}/${sourceId}/Subtitles/${subtitleStreamIndex}/Stream.${format}`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
     }
     if (startTimeTicks > 0) {
@@ -1473,6 +1483,7 @@ var MediaModule = class {
     if (!serverUrl || !itemId) return "";
     const url = new URL(`${serverUrl}/Items/${itemId}/Download`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
     }
     if (filename) {
@@ -1519,13 +1530,17 @@ var MediaModule = class {
   /**
    * Returns authentication headers for media streaming requests (e.g., configuring hls.js xhrSetup).
    * Crucial for Jellyfin 12+ servers where query-based auth (?api_key=) is disabled.
+   * Pass { legacy: false } to only send Authorization and avoid conflicting headers or reverse-proxy CORS rejections.
    */
-  getStreamHeaders() {
+  getStreamHeaders(options = {}) {
     const authHeader = this.http.getAuthHeader();
-    return {
-      Authorization: authHeader,
-      "X-Emby-Authorization": authHeader
+    const headers = {
+      Authorization: authHeader
     };
+    if (options.legacy ?? true) {
+      headers["X-Emby-Authorization"] = authHeader;
+    }
+    return headers;
   }
 };
 
@@ -2857,6 +2872,7 @@ var TrickplayModule = class {
     const { mediaSourceId, useQueryToken = true } = options;
     const url = new URL(`${serverUrl}/Videos/${itemId}/Trickplay/${width}/tiles.m3u8`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
@@ -2875,6 +2891,7 @@ var TrickplayModule = class {
     const { mediaSourceId, useQueryToken = true } = options;
     const url = new URL(`${serverUrl}/Videos/${itemId}/Trickplay/${width}/${index}.jpg`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
@@ -3065,6 +3082,7 @@ var ChaptersModule = class {
     } = options;
     const url = new URL(`${serverUrl}/Items/${itemId}/Images/Chapter/${chapterIndex}`);
     if (token && useQueryToken) {
+      url.searchParams.append("ApiKey", token);
       url.searchParams.append("api_key", token);
       url.searchParams.append("X-Emby-Token", token);
     }
@@ -3749,7 +3767,7 @@ var JellyfinClient = class {
     this.cache = new MemoryCacheAdapter();
     this.clientInfo = {
       name: options.clientInfo?.name || "@francofantomius/jellyfin",
-      version: options.clientInfo?.version || "0.4.0",
+      version: options.clientInfo?.version || "0.4.1",
       device: options.clientInfo?.device || (typeof window !== "undefined" ? "Web Browser" : "Node.js"),
       deviceId: options.clientInfo?.deviceId || generateDeviceId()
     };