@francofantomius/jellyfin 0.1.0 → 0.2.0

package/dist/index.js

@@ -700,22 +700,41 @@ var LibraryModule = class {
     if (!query || !query.trim()) {
       return { Items: [], TotalRecordCount: 0 };
     }
-    const userId = this.requireUserId();
+    const userId = options.userId || this.requireUserId();
     const {
       limit = 30,
       startIndex = 0,
-      includeItemTypes = "Audio,MusicAlbum,MusicArtist,Playlist,Movie,Series,Episode"
+      parentId,
+      includeItemTypes = "Audio,MusicAlbum,MusicArtist,Playlist,Movie,Series,Episode",
+      mediaTypes,
+      genres,
+      years,
+      isFavorite,
+      sortBy,
+      sortOrder,
+      fields = COMMON_ITEM_FIELDS,
+      recursive = true
     } = options;
-    return await this.http.request(`/Users/${userId}/Items`, {
-      params: {
-        SearchTerm: query.trim(),
-        IncludeItemTypes: includeItemTypes,
-        Limit: limit,
-        StartIndex: startIndex,
-        Recursive: true,
-        Fields: COMMON_ITEM_FIELDS
-      }
-    });
+    const params = {
+      SearchTerm: query.trim(),
+      Limit: limit,
+      StartIndex: startIndex,
+      Recursive: recursive,
+      Fields: fields
+    };
+    if (parentId) params.ParentId = parentId;
+    if (includeItemTypes) {
+      params.IncludeItemTypes = Array.isArray(includeItemTypes) ? includeItemTypes.join(",") : includeItemTypes;
+    }
+    if (mediaTypes) {
+      params.MediaTypes = Array.isArray(mediaTypes) ? mediaTypes.join(",") : mediaTypes;
+    }
+    if (genres && genres.length > 0) params.Genres = genres.join("|");
+    if (years && years.length > 0) params.Years = years.join(",");
+    if (isFavorite) params.Filters = "IsFavorite";
+    if (sortBy) params.SortBy = sortBy;
+    if (sortOrder) params.SortOrder = sortOrder;
+    return await this.http.request(`/Users/${userId}/Items`, { params });
   }
 };
 
@@ -958,8 +977,9 @@ var PlaybackModule = class {
   }
   /**
    * Report that playback has stopped for an item.
+   * Optionally teardown active transcoding session if playSessionId is provided.
    */
-  async reportStopped(itemId, positionTicks = 0) {
+  async reportStopped(itemId, positionTicks = 0, options) {
     if (!itemId || !this.http.getToken()) return;
     try {
       await this.http.request("/Sessions/Playing/Stopped", {
@@ -969,6 +989,20 @@ var PlaybackModule = class {
           PositionTicks: positionTicks
         }
       });
+      if (options?.playSessionId) {
+        const deviceId = this.http.getClientInfo()?.deviceId;
+        if (deviceId) {
+          await this.http.request("/Videos/ActiveEncodings", {
+            method: "DELETE",
+            params: {
+              DeviceId: deviceId,
+              PlaySessionId: options.playSessionId
+            }
+          }).catch((err) => {
+            console.warn("[Jellyfin SDK] Teardown active encoding error:", err);
+          });
+        }
+      }
     } catch (e) {
       console.warn("[Jellyfin SDK] Stop playback report error:", e);
     }
@@ -1856,6 +1890,333 @@ var OfflineStorageManager = class {
   }
 };
 
+// src/resume.ts
+var RESUME_ITEM_FIELDS = "PrimaryImageAspectRatio,PrimaryImageTag,ImageTags,BackdropImageTags,AlbumPrimaryImageTag,AlbumId,AudioInfo,MediaSources,Chapters,HasLyrics,Overview,Genres,Studios,ProductionYear,OfficialRating,CommunityRating,CriticRating,PremiereDate,RunTimeTicks,IndexNumber,ParentIndexNumber,SeriesName,SeriesId,SeasonId,SeasonName,UserData";
+var ResumeModule = class {
+  http;
+  getUserId;
+  constructor(http, getUserId) {
+    this.http = http;
+    this.getUserId = getUserId;
+  }
+  resolveUserId(explicitUserId) {
+    const userId = explicitUserId || this.getUserId();
+    if (!userId) {
+      throw new JellyfinError("User ID is required for resume requests. Please authenticate or provide a userId.");
+    }
+    return userId;
+  }
+  /**
+   * Fetch items currently in-progress for the user via /UserItems/Resume.
+   */
+  async getResumeItems(options = {}) {
+    const userId = this.resolveUserId(options.userId);
+    const {
+      limit = 20,
+      startIndex = 0,
+      parentId,
+      mediaTypes,
+      enableImages,
+      enableUserData,
+      imageTypeLimit,
+      enableImageTypes,
+      fields = RESUME_ITEM_FIELDS
+    } = options;
+    const params = {
+      UserId: userId,
+      Limit: limit,
+      StartIndex: startIndex,
+      Recursive: true,
+      Fields: fields
+    };
+    if (parentId) params.ParentId = parentId;
+    if (mediaTypes && mediaTypes.length > 0) params.MediaTypes = mediaTypes.join(",");
+    if (enableImages !== void 0) params.EnableImages = enableImages;
+    if (enableUserData !== void 0) params.EnableUserData = enableUserData;
+    if (imageTypeLimit !== void 0) params.ImageTypeLimit = imageTypeLimit;
+    if (enableImageTypes && enableImageTypes.length > 0) params.EnableImageTypes = enableImageTypes.join(",");
+    return await this.http.request("/UserItems/Resume", { params });
+  }
+  /**
+   * Convenience alias for getResumeItems.
+   */
+  async getItems(options = {}) {
+    return await this.getResumeItems(options);
+  }
+};
+
+// src/next-up.ts
+var NEXT_UP_FIELDS = "PrimaryImageAspectRatio,PrimaryImageTag,ImageTags,BackdropImageTags,AlbumPrimaryImageTag,AudioInfo,MediaSources,Chapters,Overview,Genres,ProductionYear,PremiereDate,RunTimeTicks,IndexNumber,ParentIndexNumber,SeriesName,SeriesId,SeasonId,SeasonName,UserData";
+var NextUpModule = class {
+  http;
+  getUserId;
+  constructor(http, getUserId) {
+    this.http = http;
+    this.getUserId = getUserId;
+  }
+  resolveUserId(explicitUserId) {
+    const userId = explicitUserId || this.getUserId();
+    if (!userId) {
+      throw new JellyfinError("User ID is required for next up requests. Please authenticate or provide a userId.");
+    }
+    return userId;
+  }
+  /**
+   * Fetch the next unplayed episodes for followed series via /Shows/NextUp.
+   */
+  async getNextUp(options = {}) {
+    const userId = this.resolveUserId(options.userId);
+    const {
+      limit = 24,
+      startIndex = 0,
+      parentId,
+      seriesId,
+      fields = NEXT_UP_FIELDS,
+      enableImages,
+      enableUserData,
+      enableTotalRecordCount,
+      imageTypeLimit,
+      enableImageTypes,
+      disableFirstEpisode,
+      nextUpDateCutoff
+    } = options;
+    const params = {
+      UserId: userId,
+      Limit: limit,
+      StartIndex: startIndex,
+      Fields: fields
+    };
+    if (parentId) params.ParentId = parentId;
+    if (seriesId) params.SeriesId = seriesId;
+    if (enableImages !== void 0) params.EnableImages = enableImages;
+    if (enableUserData !== void 0) params.EnableUserData = enableUserData;
+    if (enableTotalRecordCount !== void 0) params.EnableTotalRecordCount = enableTotalRecordCount;
+    if (imageTypeLimit !== void 0) params.ImageTypeLimit = imageTypeLimit;
+    if (enableImageTypes && enableImageTypes.length > 0) params.EnableImageTypes = enableImageTypes.join(",");
+    if (disableFirstEpisode !== void 0) params.DisableFirstEpisode = disableFirstEpisode;
+    if (nextUpDateCutoff) params.NextUpDateCutoff = nextUpDateCutoff;
+    return await this.http.request("/Shows/NextUp", { params });
+  }
+  /**
+   * Convenience alias for getNextUp.
+   */
+  async getEpisodes(options = {}) {
+    return await this.getNextUp(options);
+  }
+};
+
+// src/latest.ts
+var LATEST_ITEM_FIELDS = "PrimaryImageAspectRatio,PrimaryImageTag,ImageTags,BackdropImageTags,AlbumPrimaryImageTag,AlbumId,AudioInfo,MediaSources,Chapters,Overview,Genres,Studios,ProductionYear,PremiereDate,RunTimeTicks,IndexNumber,ParentIndexNumber,SeriesName,SeriesId,SeasonId,SeasonName,UserData";
+var LatestModule = class {
+  http;
+  getUserId;
+  constructor(http, getUserId) {
+    this.http = http;
+    this.getUserId = getUserId;
+  }
+  resolveUserId(explicitUserId) {
+    const userId = explicitUserId || this.getUserId();
+    if (!userId) {
+      throw new JellyfinError("User ID is required for latest media requests. Please authenticate or provide a userId.");
+    }
+    return userId;
+  }
+  /**
+   * Fetch recently added media items for the user via /Users/{userId}/Items/Latest.
+   */
+  async getLatest(options = {}) {
+    const userId = this.resolveUserId(options.userId);
+    const {
+      parentId,
+      limit = 20,
+      fields = LATEST_ITEM_FIELDS,
+      includeItemTypes,
+      isPlayed,
+      enableImages,
+      imageTypeLimit,
+      enableImageTypes,
+      groupItems
+    } = options;
+    const params = {
+      Limit: limit,
+      Fields: fields
+    };
+    if (parentId) params.ParentId = parentId;
+    if (includeItemTypes && includeItemTypes.length > 0) {
+      params.IncludeItemTypes = includeItemTypes.join(",");
+    }
+    if (isPlayed !== void 0) params.IsPlayed = isPlayed;
+    if (enableImages !== void 0) params.EnableImages = enableImages;
+    if (imageTypeLimit !== void 0) params.ImageTypeLimit = imageTypeLimit;
+    if (enableImageTypes && enableImageTypes.length > 0) {
+      params.EnableImageTypes = enableImageTypes.join(",");
+    }
+    if (groupItems !== void 0) params.GroupItems = groupItems;
+    const result = await this.http.request(`/Users/${userId}/Items/Latest`, { params });
+    return Array.isArray(result) ? result : [];
+  }
+  /**
+   * Convenience helper to fetch recently added movies.
+   */
+  async getLatestMovies(options = {}) {
+    return await this.getLatest({ ...options, includeItemTypes: ["Movie"] });
+  }
+  /**
+   * Convenience helper to fetch recently added TV episodes.
+   */
+  async getLatestEpisodes(options = {}) {
+    return await this.getLatest({ ...options, includeItemTypes: ["Episode"] });
+  }
+  /**
+   * Convenience helper to fetch recently added music albums.
+   */
+  async getLatestAlbums(options = {}) {
+    return await this.getLatest({ ...options, includeItemTypes: ["MusicAlbum"] });
+  }
+};
+
+// src/transcode.ts
+var TranscodeModule = class {
+  http;
+  getDeviceId;
+  constructor(http, getDeviceId) {
+    this.http = http;
+    this.getDeviceId = getDeviceId;
+  }
+  /**
+   * Explicitly stop an active server transcoding session via DELETE /Videos/ActiveEncodings.
+   * This terminates lingering FFmpeg processes on the Jellyfin server.
+   *
+   * @param playSessionId The unique playback session ID.
+   * @param deviceId The client device ID (defaults to configured client device ID).
+   */
+  async stopActiveEncoding(playSessionId, deviceId) {
+    if (!playSessionId) {
+      throw new JellyfinError("playSessionId is required to stop an active encoding session.");
+    }
+    const resolvedDeviceId = deviceId || this.getDeviceId();
+    if (!resolvedDeviceId) {
+      throw new JellyfinError("deviceId is required to stop an active encoding session.");
+    }
+    await this.http.request("/Videos/ActiveEncodings", {
+      method: "DELETE",
+      params: {
+        DeviceId: resolvedDeviceId,
+        PlaySessionId: playSessionId
+      }
+    });
+  }
+  /**
+   * Convenience alias for stopActiveEncoding.
+   */
+  async stop(playSessionId, deviceId) {
+    return await this.stopActiveEncoding(playSessionId, deviceId);
+  }
+};
+
+// src/search.ts
+var COMMON_SEARCH_FIELDS = "PrimaryImageAspectRatio,PrimaryImageTag,ImageTags,BackdropImageTags,AlbumPrimaryImageTag,AlbumId,AudioInfo,MediaSources,Chapters,HasLyrics,Overview,Genres,Studios,ProductionYear,OfficialRating,CommunityRating,CriticRating,PremiereDate,RunTimeTicks,IndexNumber,ParentIndexNumber,SeriesName,SeriesId,SeasonId,SeasonName,UserData";
+var SearchModule = class {
+  http;
+  getUserId;
+  constructor(http, getUserId) {
+    this.http = http;
+    this.getUserId = getUserId;
+  }
+  resolveUserId(explicitUserId) {
+    const userId = explicitUserId || this.getUserId();
+    if (!userId) {
+      throw new JellyfinError("User ID is required for search requests. Please authenticate or provide a userId.");
+    }
+    return userId;
+  }
+  /**
+   * Universal search across Jellyfin items with comprehensive filters.
+   */
+  async search(query, options = {}) {
+    if (!query || !query.trim()) {
+      return { Items: [], TotalRecordCount: 0 };
+    }
+    const userId = this.resolveUserId(options.userId);
+    const {
+      limit = 30,
+      startIndex = 0,
+      parentId,
+      includeItemTypes = "Audio,MusicAlbum,MusicArtist,Playlist,Movie,Series,Episode",
+      mediaTypes,
+      genres,
+      years,
+      isFavorite,
+      sortBy,
+      sortOrder,
+      fields = COMMON_SEARCH_FIELDS,
+      recursive = true
+    } = options;
+    const params = {
+      SearchTerm: query.trim(),
+      Limit: limit,
+      StartIndex: startIndex,
+      Recursive: recursive,
+      Fields: fields
+    };
+    if (parentId) params.ParentId = parentId;
+    if (includeItemTypes) {
+      params.IncludeItemTypes = Array.isArray(includeItemTypes) ? includeItemTypes.join(",") : includeItemTypes;
+    }
+    if (mediaTypes) {
+      params.MediaTypes = Array.isArray(mediaTypes) ? mediaTypes.join(",") : mediaTypes;
+    }
+    if (genres && genres.length > 0) params.Genres = genres.join("|");
+    if (years && years.length > 0) params.Years = years.join(",");
+    if (isFavorite) params.Filters = "IsFavorite";
+    if (sortBy) params.SortBy = sortBy;
+    if (sortOrder) params.SortOrder = sortOrder;
+    return await this.http.request(`/Users/${userId}/Items`, { params });
+  }
+  /**
+   * Search specifically within a specific library or parent folder.
+   */
+  async searchInLibrary(parentId, query, options = {}) {
+    return await this.search(query, { ...options, parentId });
+  }
+  /**
+   * Convenience helper to search audio tracks / songs.
+   */
+  async searchSongs(query, options = {}) {
+    return await this.search(query, { ...options, includeItemTypes: "Audio" });
+  }
+  /**
+   * Convenience helper to search music albums.
+   */
+  async searchAlbums(query, options = {}) {
+    return await this.search(query, { ...options, includeItemTypes: "MusicAlbum" });
+  }
+  /**
+   * Convenience helper to search music artists.
+   */
+  async searchArtists(query, options = {}) {
+    return await this.search(query, { ...options, includeItemTypes: "MusicArtist" });
+  }
+  /**
+   * Convenience helper to search movies.
+   */
+  async searchMovies(query, options = {}) {
+    return await this.search(query, { ...options, includeItemTypes: "Movie" });
+  }
+  /**
+   * Convenience helper to search TV series.
+   */
+  async searchSeries(query, options = {}) {
+    return await this.search(query, { ...options, includeItemTypes: "Series" });
+  }
+  /**
+   * Convenience helper to search TV episodes.
+   */
+  async searchEpisodes(query, options = {}) {
+    return await this.search(query, { ...options, includeItemTypes: "Episode" });
+  }
+};
+
 // src/cache.ts
 var MemoryCacheAdapter = class {
   cache = /* @__PURE__ */ new Map();
@@ -2047,12 +2408,17 @@ var JellyfinClient = class {
   auth;
   system;
   library;
+  search;
   playlists;
   playback;
   media;
   lyrics;
   favorites;
   offline;
+  resume;
+  nextUp;
+  latest;
+  transcode;
   http;
   storage;
   cache;
@@ -2063,7 +2429,7 @@ var JellyfinClient = class {
     this.cache = new MemoryCacheAdapter();
     this.clientInfo = {
       name: options.clientInfo?.name || "@francofantomius/jellyfin",
-      version: options.clientInfo?.version || "0.1.0",
+      version: options.clientInfo?.version || "0.2.0",
       device: options.clientInfo?.device || (typeof window !== "undefined" ? "Web Browser" : "Node.js"),
       deviceId: options.clientInfo?.deviceId || generateDeviceId()
     };
@@ -2080,18 +2446,24 @@ var JellyfinClient = class {
       }
     });
     const getUserId = () => this.auth.getUserId();
+    const getDeviceId = () => this.clientInfo.deviceId;
     this.system = new SystemModule(this.http, {
       serverVersion: options.serverVersion,
       targetVersion: options.targetVersion
     });
     this.auth = new AuthModule(this.http, options.userId || "");
     this.library = new LibraryModule(this.http, getUserId);
+    this.search = new SearchModule(this.http, getUserId);
     this.playlists = new PlaylistsModule(this.http, getUserId);
     this.playback = new PlaybackModule(this.http);
     this.media = new MediaModule(this.http, getUserId);
     this.lyrics = new LyricsModule(this.http);
     this.favorites = new FavoritesModule(this.http, getUserId);
     this.offline = new OfflineStorageManager(this.media);
+    this.resume = new ResumeModule(this.http, getUserId);
+    this.nextUp = new NextUpModule(this.http, getUserId);
+    this.latest = new LatestModule(this.http, getUserId);
+    this.transcode = new TranscodeModule(this.http, getDeviceId);
   }
   // --- Configuration Getters & Setters ---
   get serverUrl() {
@@ -2208,6 +2580,6 @@ var JellyfinClient = class {
   }
 };
 
-export { AUDIO_QUALITY_PRESETS, AuthModule, FavoritesModule, HttpTransport, IndexedDBCacheAdapter, JellyfinApiError, JellyfinAuthError, JellyfinClient, JellyfinError, LibraryModule, LocalStorageAdapter, LyricsModule, MediaModule, MemoryCacheAdapter, MemoryStorage, OfflineStorageManager, PlaybackModule, PlaylistsModule, SystemModule, VIDEO_QUALITY_PRESETS, buildAuthHeader, cleanUrl, fetchWithCache, formatBitrate, generateDeviceId, getAudioQualityList, getDefaultStorage, getVideoQualityList, isV12OrHigher, isVersionAtLeast, parseSemVer, resolveAudioQuality, resolveVideoQuality };
+export { AUDIO_QUALITY_PRESETS, AuthModule, COMMON_SEARCH_FIELDS, FavoritesModule, HttpTransport, IndexedDBCacheAdapter, JellyfinApiError, JellyfinAuthError, JellyfinClient, JellyfinError, LatestModule, LibraryModule, LocalStorageAdapter, LyricsModule, MediaModule, MemoryCacheAdapter, MemoryStorage, NextUpModule, OfflineStorageManager, PlaybackModule, PlaylistsModule, ResumeModule, SearchModule, SystemModule, TranscodeModule, VIDEO_QUALITY_PRESETS, buildAuthHeader, cleanUrl, fetchWithCache, formatBitrate, generateDeviceId, getAudioQualityList, getDefaultStorage, getVideoQualityList, isV12OrHigher, isVersionAtLeast, parseSemVer, resolveAudioQuality, resolveVideoQuality };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map