Update code docs

Author: jellyrock-bot

docs/data/search.json

@@ -117,7 +117,7 @@
       "parentId": itemNode.id,
       "imageTypeLimit": 1,
       "sortBy": "SortName",
-      "limit": 2000,
+      "limit": 500,
       "enableUserData": false,
       "EnableTotalRecordCount": false
     })
@@ -138,7 +138,7 @@
       "artistIds": itemNode.id,
       "includeItemTypes": "Audio",
       "sortBy": "Album",
-      "limit": 2000,
+      "limit": 500,
       "imageTypeLimit": 1,
       "Recursive": true,
       "enableUserData": false,
@@ -161,7 +161,7 @@
     data = api.items.GetByQuery({
       "userid": m.global.user.id,
       "parentid": itemNode.id,
-      "limit": 2000,
+      "limit": 500,
       "EnableTotalRecordCount": false
     })
     if isValid(data) and isValidAndNotEmpty(data.Items)
@@ -172,60 +172,60 @@
   end sub
 
   ' A TV Show Series.
-  ' Play the first unwatched episode.
-  ' If none, shuffle play the whole series.
+  ' Prefer an in-progress (resumable) episode — consistent with the Continue Watching row.
+  ' Falls back to the next unstarted/unwatched episode (ep 1 for a fresh series).
+  ' If all episodes are fully watched and rewatching is disabled, shuffle the whole series.
   sub series(itemNode as object)
     if not isValid(itemNode) or not isValid(itemNode.id) then return
 
     ' ONE rendezvous to get user
     localUser = m.global.user
 
-    data = api.shows.GetNextUp({
-      "seriesId": itemNode.id,
-      "recursive": true,
+    ' Check for a resumable (in-progress) episode first
+    resumeData = api.users.GetResumeItemsByQuery(localUser.id, {
+      "parentId": itemNode.id,
+      "userid": localUser.id,
+      "Filters": "IsResumable",
       "SortBy": "DatePlayed",
       "SortOrder": "Descending",
+      "Limit": 1,
+      "recursive": true,
       "ImageTypeLimit": 1,
-      "UserId": localUser.id,
-      "EnableRewatching": localUser.settings.uiDetailsEnableRewatchingNextUp,
-      "DisableFirstEpisode": false,
       "EnableTotalRecordCount": false
     })
 
-    if isValid(data) and isValidAndNotEmpty(data.Items)
-      ' there are unwatched episodes
-      m.global.queueManager.callFunc("push", nodeHelpers.createQueueItem(data.Items[0]))
+    if isValid(resumeData) and isValidAndNotEmpty(resumeData.Items)
+      ' play the resumable episode
+      queueItem = nodeHelpers.createQueueItem(resumeData.Items[0])
+      if isValid(resumeData.Items[0].UserData) and isValid(resumeData.Items[0].UserData.PlaybackPositionTicks)
+        queueItem.startingPoint = resumeData.Items[0].UserData.PlaybackPositionTicks
+      end if
+      m.global.queueManager.callFunc("push", queueItem)
     else
-      ' next up check was empty
-      ' check for a resumable episode
-      data = api.users.GetResumeItemsByQuery(localUser.id, {
-        "parentId": itemNode.id,
-        "userid": localUser.id,
-        "SortBy": "DatePlayed",
-        "recursive": true,
-        "SortOrder": "Descending",
-        "Filters": "IsResumable",
+      ' Fall back to next unstarted episode.
+      ' DisableFirstEpisode: false so a completely unwatched series starts at episode 1.
+      data = api.shows.GetNextUp({
+        "seriesId": itemNode.id,
+        "UserId": localUser.id,
+        "Limit": 1,
+        "DisableFirstEpisode": false,
+        "ImageTypeLimit": 1,
+        "EnableRewatching": localUser.settings.uiDetailsEnableRewatchingNextUp,
         "EnableTotalRecordCount": false
       })
-      print "resumeitems data=", data
+
       if isValid(data) and isValidAndNotEmpty(data.Items)
-        ' play the resumable episode
-        queueItem = nodeHelpers.createQueueItem(data.Items[0])
-        if isValid(data.Items[0].UserData) and isValid(data.Items[0].UserData.PlaybackPositionTicks)
-          queueItem.startingPoint = data.Items[0].UserData.PlaybackPositionTicks
-        end if
-        m.global.queueManager.callFunc("push", queueItem)
+        m.global.queueManager.callFunc("push", nodeHelpers.createQueueItem(data.Items[0]))
       else
-        ' shuffle all episodes
+        ' All episodes fully watched and rewatching disabled — shuffle the whole series
         data = api.shows.GetEpisodes(itemNode.id, {
           "userid": localUser.id,
           "SortBy": "Random",
-          "limit": 2000,
+          "limit": 500,
           "EnableTotalRecordCount": false
         })
 
         if isValid(data) and isValidAndNotEmpty(data.Items)
-          ' add all episodes found to a playlist
           quickplay.pushToQueue(data.Items)
         else
           stopLoadingSpinner()
@@ -242,7 +242,7 @@
       userId = m.global.user.id
 
       numTotal = 0
-      numLimit = 2000
+      numLimit = 500
       for each tvshow in itemNodes
         ' grab all watched episodes for each series
         showData = api.shows.GetEpisodes(tvshow.id, {
@@ -292,7 +292,7 @@
         "sortBy": "Random",
         "recursive": true,
         "includeItemTypes": "Movie,Video",
-        "limit": 2000
+        "limit": 500
       })
       print "data=", data
       if isValid(data) and isValidAndNotEmpty(data.items)
@@ -357,7 +357,7 @@
     unwatchedData = api.shows.GetEpisodes(seriesId, {
       "seasonId": itemNode.id,
       "userid": globalUser.id,
-      "limit": 2000,
+      "limit": 500,
       "EnableTotalRecordCount": false
     })
 
@@ -429,7 +429,7 @@
       "includeItemTypes": "Movie,Video",
       "excludeItemTypes": "Season,Series",
       "recursive": true,
-      "limit": 2000
+      "limit": 500
     })
     print "personMovies=", personMovies
 
@@ -445,7 +445,7 @@
       "isPlayed": true,
       "excludeItemTypes": "Season,Series",
       "recursive": true,
-      "limit": 2000
+      "limit": 500
     })
     print "personEpisodes=", personEpisodes
 
@@ -498,7 +498,7 @@
     ' get playlist items
     myPlaylist = api.playlists.GetItems(itemNode.id, {
       "userId": m.global.user.id,
-      "limit": 2000
+      "limit": 500
     })
 
     if isValid(myPlaylist) and isValidAndNotEmpty(myPlaylist.Items)
@@ -521,7 +521,7 @@
       "includeItemTypes": ["Episode", "Recording", "Movie", "Video"],
       "videoTypes": "VideoFile",
       "sortBy": "Random",
-      "limit": 2000,
+      "limit": 500,
       "imageTypeLimit": 1,
       "Recursive": true,
       "enableUserData": false,
@@ -605,7 +605,7 @@
         "includeItemTypes": "Audio",
         "sortBy": "Album",
         "Recursive": true,
-        "limit": 2000,
+        "limit": 500,
         "imageTypeLimit": 1,
         "enableUserData": false,
         "EnableTotalRecordCount": false
@@ -620,7 +620,7 @@
       ' get list of all boxsets inside
       boxsetData = api.users.GetItemsByQuery(globalUser.id, {
         "parentId": itemNode.id,
-        "limit": 2000,
+        "limit": 500,
         "imageTypeLimit": 0,
         "enableUserData": false,
         "EnableTotalRecordCount": false,
@@ -656,7 +656,7 @@
         "includeItemTypes": "MusicVideo",
         "sortBy": "Random",
         "Recursive": true,
-        "limit": 2000,
+        "limit": 500,
         "imageTypeLimit": 1,
         "enableUserData": false,
         "EnableTotalRecordCount": false
@@ -724,7 +724,7 @@
         playlistItems = api.playlists.GetItems(myPlaylist.id, {
           "userId": globalUser.id,
           "EnableTotalRecordCount": false,
-          "limit": 2000
+          "limit": 500
         })
         ' validate api results
         if isValid(playlistItems) and isValidAndNotEmpty(playlistItems.items)