feat(FEC-13540): allow passing entry id to start playing the playlist from

src/common/playlist/playlist-manager.ts

@@ -84,7 +84,18 @@ class PlaylistManager {
           new FakeEvent(PlaylistEventType.PLAYLIST_LOADED, { playlist: this })
         );
         this._addBindings();
-        this.playNext();
+        const startPlaylistAtEntryId = config.options?.startAtEntryId;
+        let wasEntryIdSet = false;
+        if (startPlaylistAtEntryId && typeof startPlaylistAtEntryId === 'string') {
+          const entryToPlay: PlaylistItem | undefined = this._playlist.items.find((item: PlaylistItem) => item.sources.id === startPlaylistAtEntryId);
+          if (entryToPlay) {
+            wasEntryIdSet = true;
+            this.playItem(entryToPlay.index);
+          }
+        }
+        if (!wasEntryIdSet) {
+          this.playNext();
+        }
       }
     }
   }

src/types/playlist/playlist-options.ts

@@ -1,10 +1,12 @@
 /**
- * @typedef {Object} KPPlaylistOptions
+ * @typedef {Object} PlaylistOptions
  * @property {boolean} [autoContinue=true] - Determines whether to continue to the next item automatically.
  * @property {boolean} [loop=false] - Determines whether to play the playlist in a loop. When selected, the playlist will play automatically even if autoContinue is set to false.
+ * @property {string} [startAtEntryId] - Determines which entry id to start to the play the playlist from.
  */
 export interface PlaylistOptions {
   autoContinue: boolean;
   loop: boolean;
   imageDuration: number;
+  startAtEntryId?: string
 }