musora-content-services 2.30.5 → 2.30.9

package/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [2.30.9](https://github.com/railroadmedia/musora-content-services/compare/v2.30.5...v2.30.9) (2025-08-13)
+
+
+### Bug Fixes
+
+* **BEH-845:** enable soft deletes for user activities ([#384](https://github.com/railroadmedia/musora-content-services/issues/384)) ([9c146c4](https://github.com/railroadmedia/musora-content-services/commit/9c146c43536e517ca69d3f264b117850fec748ec))
+* **MU-921:** add context to content empty arrays ([#410](https://github.com/railroadmedia/musora-content-services/issues/410)) ([0ca84ae](https://github.com/railroadmedia/musora-content-services/commit/0ca84aea741e605d17c0f45bbfb6cc8ea018e676))
+* **recsys:** support navigateTo and permissions filtering for recomme… ([#403](https://github.com/railroadmedia/musora-content-services/issues/403)) ([864ec0f](https://github.com/railroadmedia/musora-content-services/commit/864ec0fc05704d9641a965bc4de63a97422668c4))
+* **T3PS-454:** rank lessons by recommended ([#380](https://github.com/railroadmedia/musora-content-services/issues/380)) ([cc55bfd](https://github.com/railroadmedia/musora-content-services/commit/cc55bfd0fb19f1b42c42eb2ea6573817a8d2cc69))
+
+### [2.30.8](https://github.com/railroadmedia/musora-content-services/compare/v2.30.5...v2.30.8) (2025-08-13)
+
+
+### Bug Fixes
+
+* **BEH-845:** enable soft deletes for user activities ([#384](https://github.com/railroadmedia/musora-content-services/issues/384)) ([9c146c4](https://github.com/railroadmedia/musora-content-services/commit/9c146c43536e517ca69d3f264b117850fec748ec))
+* **MU-921:** add context to content empty arrays ([#410](https://github.com/railroadmedia/musora-content-services/issues/410)) ([0ca84ae](https://github.com/railroadmedia/musora-content-services/commit/0ca84aea741e605d17c0f45bbfb6cc8ea018e676))
+* **recsys:** support navigateTo and permissions filtering for recomme… ([#403](https://github.com/railroadmedia/musora-content-services/issues/403)) ([864ec0f](https://github.com/railroadmedia/musora-content-services/commit/864ec0fc05704d9641a965bc4de63a97422668c4))
+* **T3PS-454:** rank lessons by recommended ([#380](https://github.com/railroadmedia/musora-content-services/issues/380)) ([cc55bfd](https://github.com/railroadmedia/musora-content-services/commit/cc55bfd0fb19f1b42c42eb2ea6573817a8d2cc69))
+
+### [2.30.7](https://github.com/railroadmedia/musora-content-services/compare/v2.30.5...v2.30.7) (2025-08-13)
+
+
+### Bug Fixes
+
+* **BEH-845:** enable soft deletes for user activities ([#384](https://github.com/railroadmedia/musora-content-services/issues/384)) ([9c146c4](https://github.com/railroadmedia/musora-content-services/commit/9c146c43536e517ca69d3f264b117850fec748ec))
+* **MU-921:** add context to content empty arrays ([#410](https://github.com/railroadmedia/musora-content-services/issues/410)) ([0ca84ae](https://github.com/railroadmedia/musora-content-services/commit/0ca84aea741e605d17c0f45bbfb6cc8ea018e676))
+* **recsys:** support navigateTo and permissions filtering for recomme… ([#403](https://github.com/railroadmedia/musora-content-services/issues/403)) ([864ec0f](https://github.com/railroadmedia/musora-content-services/commit/864ec0fc05704d9641a965bc4de63a97422668c4))
+* **T3PS-454:** rank lessons by recommended ([#380](https://github.com/railroadmedia/musora-content-services/issues/380)) ([cc55bfd](https://github.com/railroadmedia/musora-content-services/commit/cc55bfd0fb19f1b42c42eb2ea6573817a8d2cc69))
+
+### [2.30.6](https://github.com/railroadmedia/musora-content-services/compare/v2.30.5...v2.30.6) (2025-08-13)
+
+
+### Bug Fixes
+
+* **BEH-845:** enable soft deletes for user activities ([#384](https://github.com/railroadmedia/musora-content-services/issues/384)) ([9c146c4](https://github.com/railroadmedia/musora-content-services/commit/9c146c43536e517ca69d3f264b117850fec748ec))
+* **MU-921:** add context to content empty arrays ([#410](https://github.com/railroadmedia/musora-content-services/issues/410)) ([0ca84ae](https://github.com/railroadmedia/musora-content-services/commit/0ca84aea741e605d17c0f45bbfb6cc8ea018e676))
+* **recsys:** support navigateTo and permissions filtering for recomme… ([#403](https://github.com/railroadmedia/musora-content-services/issues/403)) ([864ec0f](https://github.com/railroadmedia/musora-content-services/commit/864ec0fc05704d9641a965bc4de63a97422668c4))
+* **T3PS-454:** rank lessons by recommended ([#380](https://github.com/railroadmedia/musora-content-services/issues/380)) ([cc55bfd](https://github.com/railroadmedia/musora-content-services/commit/cc55bfd0fb19f1b42c42eb2ea6573817a8d2cc69))
+
 ### [2.30.5](https://github.com/railroadmedia/musora-content-services/compare/v2.30.4...v2.30.5) (2025-08-06)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musora-content-services",
-  "version": "2.30.5",
+  "version": "2.30.9",
   "description": "A package for Musoras content services ",
   "main": "src/index.js",
   "type": "module",

package/src/filterBuilder.js

@@ -21,6 +21,7 @@ export class FilterBuilder {
       isSingle = false,
       allowsPullSongsContent = true,
       isChildrenFilter = false,
+      isParentFilter = false,
     } = {}
   ) {
     this.availableContentStatuses = availableContentStatuses
@@ -35,7 +36,17 @@ export class FilterBuilder {
     this.filter = filter
     // this.debug = process.env.DEBUG === 'true' || false;
     this.debug = false
-    this.prefix = isChildrenFilter ? '@->' : ''
+    this.prefix = this.getPrefix(isParentFilter, isChildrenFilter)
+  }
+
+  getPrefix(isParentFilter, isChildrenFilter) {
+    if (isParentFilter) {
+      return '^.'
+    } else if (isChildrenFilter) {
+      return '@->'
+    } else {
+      return ''
+    }
   }
 
   static withOnlyFilterAvailableStatuses(filter, availableContentStatuses, bypassPermissions) {

package/src/index.d.ts

@@ -44,7 +44,8 @@ import {
 } from './services/content.js';
 
 import {
-	addContextToContent
+	addContextToContent,
+	getNavigateToForPlaylists
 } from './services/contentAggregator.js';
 
 import {
@@ -61,6 +62,7 @@ import {
 	getAllStarted,
 	getAllStartedOrCompleted,
 	getLastInteractedOf,
+	getNavigateTo,
 	getNextLesson,
 	getProgressDateByIds,
 	getProgressPercentage,
@@ -143,6 +145,7 @@ import {
 	postContentComplete,
 	postContentLiked,
 	postContentReset,
+	postContentRestore,
 	postContentUnliked,
 	postPlaylistContentEngaged,
 	postRecordWatchSession,
@@ -254,6 +257,7 @@ import {
 	markNotificationAsRead,
 	markNotificationAsUnread,
 	pauseLiveEventPolling,
+	restoreNotification,
 	startLiveEventPolling,
 	updateNotificationSetting
 } from './services/user/notifications.js';
@@ -292,6 +296,7 @@ import {
 	recordUserPractice,
 	removeUserPractice,
 	restorePracticeSession,
+	restoreUserActivity,
 	restoreUserPractice,
 	unpinProgressRow,
 	updatePracticeNotes,
@@ -423,6 +428,8 @@ declare module 'musora-content-services' {
 		getLastInteractedOf,
 		getLessonContentRows,
 		getMonday,
+		getNavigateTo,
+		getNavigateToForPlaylists,
 		getNewAndUpcoming,
 		getNextLesson,
 		getPracticeNotes,
@@ -477,6 +484,7 @@ declare module 'musora-content-services' {
 		postContentComplete,
 		postContentLiked,
 		postContentReset,
+		postContentRestore,
 		postContentUnliked,
 		postPlaylistContentEngaged,
 		postRecordWatchSession,
@@ -496,7 +504,9 @@ declare module 'musora-content-services' {
 		resetPassword,
 		restoreComment,
 		restoreItemFromPlaylist,
+		restoreNotification,
 		restorePracticeSession,
+		restoreUserActivity,
 		restoreUserPractice,
 		sendAccountSetupEmail,
 		sendPasswordResetEmail,

package/src/index.js

@@ -44,7 +44,8 @@ import {
 } from './services/content.js';
 
 import {
-	addContextToContent
+	addContextToContent,
+	getNavigateToForPlaylists
 } from './services/contentAggregator.js';
 
 import {
@@ -61,6 +62,7 @@ import {
 	getAllStarted,
 	getAllStartedOrCompleted,
 	getLastInteractedOf,
+	getNavigateTo,
 	getNextLesson,
 	getProgressDateByIds,
 	getProgressPercentage,
@@ -129,9 +131,9 @@ import {
 	fetchNextContentDataForParent,
 	fetchRecentUserActivities,
 	fetchSongsInProgress,
+	fetchTopComment,
 	fetchUserAward,
 	fetchUserBadges,
-	fetchTopComment,
 	fetchUserLikes,
 	fetchUserPermissionsData,
 	fetchUserPracticeMeta,
@@ -143,6 +145,7 @@ import {
 	postContentComplete,
 	postContentLiked,
 	postContentReset,
+	postContentRestore,
 	postContentUnliked,
 	postPlaylistContentEngaged,
 	postRecordWatchSession,
@@ -254,6 +257,7 @@ import {
 	markNotificationAsRead,
 	markNotificationAsUnread,
 	pauseLiveEventPolling,
+	restoreNotification,
 	startLiveEventPolling,
 	updateNotificationSetting
 } from './services/user/notifications.js';
@@ -292,6 +296,7 @@ import {
 	recordUserPractice,
 	removeUserPractice,
 	restorePracticeSession,
+	restoreUserActivity,
 	restoreUserPractice,
 	unpinProgressRow,
 	updatePracticeNotes,
@@ -422,6 +427,8 @@ export {
 	getLastInteractedOf,
 	getLessonContentRows,
 	getMonday,
+	getNavigateTo,
+	getNavigateToForPlaylists,
 	getNewAndUpcoming,
 	getNextLesson,
 	getPracticeNotes,
@@ -476,6 +483,7 @@ export {
 	postContentComplete,
 	postContentLiked,
 	postContentReset,
+	postContentRestore,
 	postContentUnliked,
 	postPlaylistContentEngaged,
 	postRecordWatchSession,
@@ -495,7 +503,9 @@ export {
 	resetPassword,
 	restoreComment,
 	restoreItemFromPlaylist,
+	restoreNotification,
 	restorePracticeSession,
+	restoreUserActivity,
 	restoreUserPractice,
 	sendAccountSetupEmail,
 	sendPasswordResetEmail,

package/src/services/content.js

@@ -15,7 +15,7 @@ import {
 } from './sanity.js'
 import {TabResponseType, Tabs, capitalizeFirstLetter} from '../contentMetaData.js'
 import {fetchHandler} from "./railcontent";
-import {recommendations, rankCategories} from "./recommendations";
+import {recommendations, rankCategories, rankItems} from "./recommendations";
 import {addContextToContent} from "./contentAggregator.js";
 
 
@@ -85,12 +85,22 @@ export async function getTabResults(brand, pageName, tabName, {
       addProgressStatus: true
     })
   } else {
-    let temp =  await fetchTabData(brand, pageName, { page, limit, sort, includedFields: mergedIncludedFields, progress: progressValue });
-    results = await addContextToContent(() => temp.entity, {
-      addNextLesson: true,
-      addNavigateTo: true,
-      addProgressPercentage: true,
-      addProgressStatus: true
+    let temp = await fetchTabData(brand, pageName, { page, limit, sort, includedFields: mergedIncludedFields, progress: progressValue });
+
+    const [ranking, contextResults] = await Promise.all([
+      sort === 'recommended' ? rankItems(brand, temp.entity.map(e => e.railcontent_id)) : [],
+      addContextToContent(() => temp.entity, {
+        addNextLesson: true,
+        addNavigateTo: true,
+        addProgressPercentage: true,
+        addProgressStatus: true
+      })
+    ]);
+
+    results = ranking.length === 0 ? contextResults : contextResults.sort((a, b) => {
+      const indexA = ranking.indexOf(a.railcontent_id);
+      const indexB = ranking.indexOf(b.railcontent_id);
+      return (indexA === -1 ? Infinity : indexA) - (indexB === -1 ? Infinity : indexB);
     })
   }
 
@@ -392,7 +402,7 @@ export async function getRecommendedForYou(brand, rowId = null, {
   // Apply pagination before calling fetchByRailContentIds
   const startIndex = (page - 1) * limit;
   const paginatedData = data.slice(startIndex, startIndex + limit);
-  const contents = await addContextToContent(fetchByRailContentIds, paginatedData, 'tab-data',
+  const contents = await addContextToContent(fetchByRailContentIds, paginatedData, 'tab-data', brand, true,
     {
       addNextLesson: true,
       addNavigateTo: true,

package/src/services/contentAggregator.js

@@ -77,12 +77,13 @@ export async function addContextToContent(dataPromise, ...dataArgs)
   const dataParam = lastArg === options ? dataArgs.slice(0, -1) : dataArgs
 
   let data = await dataPromise(...dataParam)
-  if(!data) return false
   const isDataAnArray = Array.isArray(data)
-  const items = extractItemsFromData(data, dataField, isDataAnArray, dataField_includeParent)
-  const ids = items.map(item => item?.id).filter(Boolean)
+  if(isDataAnArray && data.length === 0) return data
+  if(!data) return false
 
-  if(ids.length === 0) return false
+  const items = extractItemsFromData(data, dataField, isDataAnArray, dataField_includeParent) ?? []
+  const ids = items.map(item => item?.id).filter(Boolean)
+  if(ids.length === 0) return data
 
   const [progressData, isLikedData, resumeTimeData, lastInteractedChildData, nextLessonData, navigateToData] = await Promise.all([
     addProgressPercentage || addProgressStatus || addProgressTimestamp ? getProgressDateByIds(ids) : Promise.resolve(null),

package/src/services/railcontent.js

@@ -378,16 +378,36 @@ export async function fetchUserBadges(brand = null) {
   return await fetchHandler(url, 'get')
 }
 
+/**
+ * complete a content's progress for a given user
+ * @param contentId
+ * @returns {Promise<any|string|null>}
+ */
 export async function postContentComplete(contentId) {
   let url = `/api/content/v1/user/progress/complete/${contentId}`
   return postDataHandler(url)
 }
 
+/**
+ * resets the user's progress on a content
+ * @param contentId
+ * @returns {Promise<any|string|null>}
+ */
 export async function postContentReset(contentId) {
   let url = `/api/content/v1/user/progress/reset/${contentId}`
   return postDataHandler(url)
 }
 
+/**
+ * restores the user's progress on a content
+ * @param contentId
+ * @returns {Promise<any|string|null>}
+ */
+export async function postContentRestore(contentId) {
+  let url = `/api/content/v1/user/progress/restore/${contentId}`
+  return postDataHandler(url)
+}
+
 /**
  * Set a user's StudentView Flag
  *

package/src/services/sanity.js

@@ -476,7 +476,7 @@ export async function fetchByRailContentId(id, contentType) {
  *   .then(contents => console.log(contents))
  *   .catch(error => console.error(error));
  */
-export async function fetchByRailContentIds(ids, contentType = undefined, brand = undefined) {
+export async function fetchByRailContentIds(ids, contentType = undefined, brand = undefined, includePermissionsAndStatusFilter = false) {
   if (!ids?.length) {
     return []
   }
@@ -485,8 +485,10 @@ export async function fetchByRailContentIds(ids, contentType = undefined, brand
   const brandFilter = brand ? ` && brand == "${brand}"` : ''
   const lessonCountFilter = await new FilterBuilder(`_id in ^.child[]._ref`, {pullFutureContent: true}).buildFilter()
   const fields = await getFieldsForContentTypeWithFilteredChildren(contentType, true)
+  const baseFilter = `railcontent_id in [${idsString}]${brandFilter}`
+  const finalFilter = includePermissionsAndStatusFilter ? await new FilterBuilder(baseFilter).buildFilter() : baseFilter
   const query = `*[
-    railcontent_id in [${idsString}]${brandFilter}
+    ${finalFilter}
   ]{
     ${fields}
     'lesson_count': coalesce(count(*[${lessonCountFilter}]), 0),
@@ -535,7 +537,9 @@ export async function fetchContentRows(brand, pageName, contentRowSlug)
     name,
     'slug': slug.current,
     'content': content[${childFilter}]->{
-        'children': child[${childFilter}]->{ 'id': railcontent_id, 'children': child[${childFilter}]->{'id': railcontent_id}, },
+        'children': child[${childFilter}]->{ 'id': railcontent_id,
+          'type': _type, brand, 'thumbnail': thumbnail.asset->url,
+          'children': child[${childFilter}]->{'id': railcontent_id}, },
         ${getFieldsForContentType('tab-data')}
         'lesson_count': coalesce(count(*[${lessonCountFilter}]), 0),
     },
@@ -1089,6 +1093,7 @@ export async function jumpToContinueContent(railcontentId) {
 /**
  * Fetch the page data for a specific lesson by Railcontent ID.
  * @param {string} railContentId - The Railcontent ID of the current lesson.
+ * @parent {boolean} addParent - Whether to include parent content data in the response.
  * @returns {Promise<Object|null>} - The fetched page data or null if found.
  *
  * @example
@@ -1096,44 +1101,51 @@ export async function jumpToContinueContent(railcontentId) {
  *   .then(data => console.log(data))
  *   .catch(error => console.error(error));
  */
-export async function fetchLessonContent(railContentId) {
+export async function fetchLessonContent(railContentId, { addParent = false } = {}) {
   const filterParams = { isSingle: true, pullFutureContent: true }
 
+  const parentQuery = addParent
+    ? `"parent_content_data": *[railcontent_id in [...(^.parent_content_data[].id)]]{
+      "id": railcontent_id,
+      title,
+      slug,
+      "type": _type,
+      "logo" : logo_image_url.asset->url,
+      "dark_mode_logo": dark_mode_logo_url.asset->url,
+      "light_mode_logo": light_mode_logo_url.asset->url,
+      "badge": badge[0]->badge.asset->url,
+    },`
+    : ''
+
   const fields = `${getFieldsForContentType()}
-          "resources": ${resourcesField},
-          soundslice,
-          instrumentless,
-          soundslice_slug,
-          "description": ${descriptionField},
-          "chapters": ${chapterField},
-          "instructors":instructor[]->name,
-          "instructor": ${instructorField},
-          ${assignmentsField}
-          video,
-          length_in_seconds,
-          mp3_no_drums_no_click_url,
-          mp3_no_drums_yes_click_url,
-          mp3_yes_drums_no_click_url,
-          mp3_yes_drums_yes_click_url,
-          "permission_id": permission[]->railcontent_id,
-          "parent_content_data": parent_content_data[]{
-            "id": id,
-            "title": *[railcontent_id == ^.id][0].title,
-            "slug":*[railcontent_id == ^.id][0].slug,
-            "type": *[railcontent_id == ^.id][0]._type,
-            "logo" : *[railcontent_id == ^.id][0].logo_image_url.asset->url,
-            "dark_mode_logo": *[railcontent_id == ^.id][0].dark_mode_logo_url.asset->url,
-            "light_mode_logo": *[railcontent_id == ^.id][0].light_mode_logo_url.asset->url,
-          },
-          ...select(
-                defined(live_event_start_time) => {
-                  "live_event_start_time": live_event_start_time,
-                  "live_event_end_time": live_event_end_time,
-                  "live_event_youtube_id": live_event_youtube_id,
-                  "videoId": coalesce(live_event_youtube_id, video.external_id),
-                  "live_event_is_global": live_global_event == true
-                }
-              )`
+    "resources": ${resourcesField},
+    soundslice,
+    instrumentless,
+    soundslice_slug,
+    "description": ${descriptionField},
+    "chapters": ${chapterField},
+    "instructors":instructor[]->name,
+    "instructor": ${instructorField},
+    ${assignmentsField}
+    video,
+    length_in_seconds,
+    mp3_no_drums_no_click_url,
+    mp3_no_drums_yes_click_url,
+    mp3_yes_drums_no_click_url,
+    mp3_yes_drums_yes_click_url,
+    "permission_id": permission[]->railcontent_id,
+    ${parentQuery}
+    ...select(
+      defined(live_event_start_time) => {
+        "live_event_start_time": live_event_start_time,
+        "live_event_end_time": live_event_end_time,
+        "live_event_youtube_id": live_event_youtube_id,
+        "videoId": coalesce(live_event_youtube_id, video.external_id),
+        "live_event_is_global": live_global_event == true
+      }
+    )
+  `
+
   const query = await buildQuery(`railcontent_id == ${railContentId}`, filterParams, fields, {
     isSingle: true,
   })
@@ -1166,7 +1178,7 @@ export async function fetchLessonContent(railContentId) {
 export async function fetchRelatedRecommendedContent(railContentId, brand, count = 10) {
   const recommendedItems = await fetchSimilarItems(railContentId, brand, count)
   if (recommendedItems && recommendedItems.length > 0) {
-    return fetchByRailContentIds(recommendedItems)
+    return fetchByRailContentIds(recommendedItems, 'tab-data', brand, true)
   }
 
   return await fetchRelatedLessons(railContentId, brand).then((result) =>
@@ -1239,20 +1251,26 @@ async function fetchRelatedByLicense(railcontentId, brand, onlyUseSongTypes, cou
  * @param {string} brand - The current brand.
  * @returns {Promise<Array<Object>|null>} - The fetched related lessons data or null if not found.
  */
-export async function fetchSiblingContent(railContentId, brand)
+export async function fetchSiblingContent(railContentId, brand= null)
 {
   const filterGetParent = await new FilterBuilder(`references(^._id) && _type == ^.parent_type`, {
+    pullFutureContent: true
+  }).buildFilter()
+  const filterForParentList = await new FilterBuilder(`references(^._id) && _type == ^.parent_type`, {
     pullFutureContent: true,
+    isParentFilter: true,
   }).buildFilter()
+
   const childrenFilter = await new FilterBuilder(``, { isChildrenFilter: true }).buildFilter()
 
+  const brandString = brand ? ` && brand == "${brand}"` : ''
   const queryFields = `_id, "id":railcontent_id, published_on, "instructor": instructor[0]->name, title, "thumbnail":thumbnail.asset->url, length_in_seconds, status, "type": _type, difficulty, difficulty_string, artist->, "permission_id": permission[]->railcontent_id, "genre": genre[]->name, "parent_id": parent_content_data[0].id`
 
-  const query = `*[railcontent_id == ${railContentId} && brand == "${brand}"]{
+  const query = `*[railcontent_id == ${railContentId}${brandString}]{
    _type, parent_type, 'parent_id': parent_content_data[0].id, railcontent_id,
    'for-calculations': *[${filterGetParent}][0]{
     'siblings-list': child[]->railcontent_id,
-    'parents-list': *[${filterGetParent}][0].child[]->railcontent_id
+    'parents-list': *[${filterForParentList}][0].child[]->railcontent_id
     },
     "related_lessons" : *[${filterGetParent}][0].child[${childrenFilter}]->{${queryFields}}
   }`
@@ -2157,7 +2175,6 @@ export async function fetchTabData(
 ) {
   const start = (page - 1) * limit
   const end = start + limit
-  let withoutPagination = false
   // Construct the included fields filter, replacing 'difficulty' with 'difficulty_string'
   const includedFieldsFilter =
     includedFields.length > 0 ? filtersToGroq(includedFields, [], pageName) : ''
@@ -2168,27 +2185,19 @@ export async function fetchTabData(
     case 'recent':
       progressIds = await getAllStartedOrCompleted({ brand, onlyIds: true });
       sortOrder = null;
-      withoutPagination = true;
       break;
     case 'incomplete':
       progressIds = await getAllStarted();
       sortOrder = null;
-      withoutPagination = true;
       break;
     case 'completed':
       progressIds = await getAllCompleted();
       sortOrder = null;
-      withoutPagination = true;
       break;
   }
 
   // limits the results to supplied progressIds for started & completed filters
   const progressFilter = await getProgressFilter(progress, progressIds)
-  if (sort === "recommended"){
-    progressIds = await recommendations(brand);
-    withoutPagination = true;
-  }
-
   const fieldsString = getFieldsForContentType('tab-data');
   const now = getSanityDate(new Date())
 
@@ -2202,7 +2211,7 @@ export async function fetchTabData(
   const lessonCountFilter = await new FilterBuilder(`_id in ^.child[]._ref`).buildFilter()
   entityFieldsString =
     ` ${fieldsString}
-    'children': child[${childrenFilter}]->{'id': railcontent_id},
+    'children': child[${childrenFilter}]->{'id': railcontent_id, 'type': _type, brand, 'thumbnail': thumbnail.asset->url},
     'isLive': live_event_start_time <= "${now}" && live_event_end_time >= "${now}",
     'lesson_count': coalesce(count(*[${lessonCountFilter}]), 0),
     'length_in_seconds': coalesce(
@@ -2217,13 +2226,12 @@ export async function fetchTabData(
   query = buildEntityAndTotalQuery(filterWithRestrictions, entityFieldsString, {
     sortOrder: sortOrder,
     start: start,
-    end: end,
-    withoutPagination: withoutPagination,
+    end: end
   })
 
   let results = await fetchSanity(query, true);
 
-  if ((['recent', 'incomplete', 'completed'].includes(progress) || sort == "recommended" )&& results.entity.length > 1) {
+  if (['recent', 'incomplete', 'completed'].includes(progress) && results.entity.length > 1) {
     const orderMap = new Map(progressIds.map((id, index) => [id, index]))
     results.entity = results.entity
       .sort((a, b) => {

package/src/services/user/notifications.js

@@ -114,11 +114,33 @@ export async function deleteNotification(notificationId) {
   if (!notificationId) {
     throw new Error('notificationId is required')
   }
-
   const url = `${baseUrl}/v1/${notificationId}`
   return fetchHandler(url, 'delete')
 }
 
+/**
+ * Restores a specific notification.
+ *
+ * @param {number} notificationId - The ID of the notification to restore.
+ *
+ * @returns {Promise<any>} - A promise that resolves when the notification is successfully restored.
+ *
+ * @throws {Error} - Throws an error if notificationId is not provided.
+ *
+ * @example
+ * restoreNotification(123)
+ *   .then(response => console.log(response))
+ *   .catch(error => console.error(error));
+ */
+export async function restoreNotification(notificationId) {
+  if (!notificationId) {
+    throw new Error('notificationId is required')
+  }
+
+  const url = `${baseUrl}/v1/${notificationId}`
+  return fetchHandler(url, 'put')
+}
+
 /**
  * Fetches the count of unread notifications for the current user in a given brand context.
  *

package/src/services/userActivity.js

@@ -11,7 +11,7 @@ import {
   fetchRecentUserActivities,
 } from './railcontent'
 import { DataContext, UserActivityVersionKey } from './dataContext.js'
-import { fetchByRailContentIds, fetchShows } from './sanity'
+import { fetchByRailContentId, fetchByRailContentIds, fetchShows } from './sanity'
 import { fetchPlaylist, fetchUserPlaylists } from './content-org/playlists'
 import { pinnedGuidedCourses } from './content-org/guided-courses'
 import {
@@ -930,6 +930,22 @@ export async function deleteUserActivity(id) {
   return await fetchHandler(url, 'DELETE')
 }
 
+/**
+ * Restores a specific user activity by its ID.
+ *
+ * @param {number|string} id - The ID of the user activity to restore.
+ * @returns {Promise<Object>} - A promise that resolves to the API response after restoration.
+ *
+ * @example
+ * restoreUserActivity(789)
+ *   .then(response => console.log('Restored:', response))
+ *   .catch(error => console.error(error));
+ */
+export async function restoreUserActivity(id) {
+  const url = `/api/user-management-system/v1/activities/${id}`
+  return await fetchHandler(url, 'POST')
+}
+
 async function extractPinnedItemsAndSortAllItems(
   userPinnedItem,
   contentsMap,
@@ -1149,24 +1165,21 @@ async function processContentItem(content) {
   }
 
   return {
-    id: content.id,
-    progressType: 'content',
-    header: contentType,
-    pinned: content.pinned ?? false,
-    content: content,
-    body: {
+    id:                content.id,
+    progressType:      'content',
+    header:            contentType,
+    pinned:            content.pinned ?? false,
+    content:           content,
+    body:              {
       progressPercent: isLive ? undefined : content.progressPercentage,
-      thumbnail: content.thumbnail,
-      title: content.title,
-      isLive: isLive,
-      badge: content.badge ?? null,
-      isLocked: content.is_locked ?? false,
-      subtitle:
-        !content.child_count || content.lesson_count === 1
-          ? contentType === 'lesson' && isLive === false
-            ? `${content.progressPercentage}% Complete`
-            : `${content.difficulty_string} • ${content.artist_name}`
-          : `${content.completed_children} of ${content.lesson_count ?? content.child_count} Lessons Complete`,
+      thumbnail:       content.thumbnail,
+      title:           content.title,
+      isLive:          isLive,
+      badge:           content.badge ?? null,
+      isLocked:        content.is_locked ?? false,
+      subtitle:        collectionLessonTypes.includes(content.type) || content.lesson_count > 1
+        ? `${content.completed_children} of ${content.lesson_count ?? content.child_count} Lessons Complete`
+        : (contentType === 'lesson' && isLive === false) ? `${content.progressPercentage}% Complete`: `${content.difficulty_string} • ${content.artist_name}`
     },
     cta: {
       text: ctaText,