@francofantomius/jellyfin 0.4.0 → 0.4.2

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.2`**
 
 
 ---

package/dist/index.cjs

@@ -27,7 +27,10 @@ var JellyfinAuthError = class extends JellyfinApiError {
 // src/http.ts
 function cleanUrl(url) {
   if (!url) return "";
-  let cleaned = url.trim().replace(/\/+$/, "");
+  let cleaned = url.trim();
+  while (cleaned.endsWith("/")) {
+    cleaned = cleaned.slice(0, -1);
+  }
   if (!/^https?:\/\//i.test(cleaned)) {
     cleaned = "https://" + cleaned;
   }
@@ -1188,6 +1191,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 +1202,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 +1240,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 +1248,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 +1303,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 +1369,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 +1412,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 +1486,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 +1533,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;
   }
 };
 
@@ -1662,7 +1680,7 @@ var OfflineStorageManager = class {
         request.onerror = () => resolve(null);
       });
     } catch (err) {
-      console.warn(`[Jellyfin Offline] getDownloadedRecord error for ${id}:`, err);
+      console.warn("[Jellyfin Offline] getDownloadedRecord error for %s:", id, err);
       return null;
     }
   }
@@ -2417,7 +2435,7 @@ var WebSocketModule = class {
         try {
           listener(...args);
         } catch (e) {
-          console.error(`[Jellyfin SDK] WebSocket listener error on '${event}':`, e);
+          console.error("[Jellyfin SDK] WebSocket listener error on '%s':", event, e);
         }
       });
     }
@@ -2857,6 +2875,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 +2894,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 +3085,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 +3770,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.2",
       device: options.clientInfo?.device || (typeof window !== "undefined" ? "Web Browser" : "Node.js"),
       deviceId: options.clientInfo?.deviceId || generateDeviceId()
     };
@@ -3871,7 +3892,7 @@ var JellyfinClient = class {
         try {
           fn(...args);
         } catch (e) {
-          console.error(`[Jellyfin SDK] Event handler error on '${event}':`, e);
+          console.error("[Jellyfin SDK] Event handler error on '%s':", event, e);
         }
       });
     }