musora-content-services 2.154.0 → 2.155.0

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rg:*)",
+      "Bash(npm run lint:*)",
+      "Bash(ls:*)"
+    ],
+    "deny": []
+  }
+}

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 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.155.0](https://github.com/railroadmedia/musora-content-services/compare/v2.154.0...v2.155.0) (2026-04-22)
+
+
+### Features
+
+* **BEHSTP-167:** offline progress tracking support ([#889](https://github.com/railroadmedia/musora-content-services/issues/889)) ([0528597](https://github.com/railroadmedia/musora-content-services/commit/05285977237ccbfa577a5770a1762c31d855e59e))
+* handle late-start active paths, and set up better resetAllLearningPaths ([#928](https://github.com/railroadmedia/musora-content-services/issues/928)) ([5d80430](https://github.com/railroadmedia/musora-content-services/commit/5d80430fbedfb21668882d402c5f6b07c82cfbf9))
+* **MU2-1452:** free tier content sort to front ([#915](https://github.com/railroadmedia/musora-content-services/issues/915)) ([0655e68](https://github.com/railroadmedia/musora-content-services/commit/0655e685f32fe77728d7b8c2505283adbc1a7c97))
+
 ## [2.154.0](https://github.com/railroadmedia/musora-content-services/compare/v2.153.0...v2.154.0) (2026-04-21)
 
 

package/jsdoc.json

@@ -15,6 +15,7 @@
       "src/services/userActivity.js",
       "src/services/railcontent.js",
       "src/services/liveTesting.ts",
+      "src/services/offline",
       "src/services/forums",
       "src/index.js"
     ],

package/package.json

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

package/src/contentTypeConfig.js

@@ -99,13 +99,12 @@ export const DEFAULT_CHILD_FIELDS = [
   `"grandparent_id": ${grandParentReferenceField}->railcontent_id`,
 ]
 
-export const playAlongMp3sField = `{
-      'mp3_no_drums_no_click_url':      mp3_no_drums_no_click_url,
-      'mp3_no_drums_yes_click_url':     mp3_no_drums_yes_click_url,
-      'mp3_yes_drums_no_click_url':     mp3_yes_drums_no_click_url,
-      'mp3_yes_drums_yes_click_url':    mp3_yes_drums_yes_click_url,
-}
-`
+export const playAlongMp3sFields = [
+  'mp3_no_drums_no_click_url',
+  'mp3_no_drums_yes_click_url',
+  'mp3_yes_drums_no_click_url',
+  'mp3_yes_drums_yes_click_url',
+]
 
 export const chapterField = `chapter[]{
                     chapter_description,
@@ -142,25 +141,31 @@ export const assignmentsField = `"assignments":assignment[]{
             }.url,  assignment_sheet_music_image),
         "timecode": assignment_timecode,
         "description": coalesce(assignment_description,'')
-},`
+}`
 
 // todo: refactor live event queries to use this
-export const liveFields = `
-    'slug': slug.current,
-    'id': railcontent_id,
-    title,
-    live_event_start_time,
-    live_event_end_time,
-    live_event_stream_id,
-    "live_event_is_global": live_global_event == true,
-    published_on,
-    "thumbnail": thumbnail.asset->url,
-    ${artistOrInstructorName()},
-    difficulty_string,
-    railcontent_id,
-    "instructors": ${instructorField},
-    'videoId': coalesce(live_event_stream_id, video.external_id)
-  `
+export function getLiveFields(minimum = false) {
+  const minimumFields = [
+    "live_event_start_time",
+    "live_event_end_time",
+    "live_event_stream_id",
+    "'live_event_is_global': live_global_event == true",
+    "'videoId': coalesce(live_event_stream_id, video.external_id)",
+  ]
+  const additionalFields = [
+    "'slug': slug.current",
+    "'id': railcontent_id",
+    "title",
+    "published_on",
+    "'thumbnail': thumbnail.asset->url",
+    `${artistOrInstructorName()}`,
+    "difficulty_string",
+    "railcontent_id",
+    `'instructors': ${instructorField}`,
+  ]
+
+  return minimum ? minimumFields : minimumFields.concat(additionalFields)
+}
 
 const contentWithInstructorsField = {
   fields: ['"instructors": instructor[]->name'],
@@ -175,6 +180,21 @@ const isLiveField = () => {
   return `"isLive": live_event_start_time <= '${now}' && live_event_end_time >= '${now}'`
 }
 
+const pcdForDownloadField = `
+  "parent_content_data": parent_content_reference[]->{
+    "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": *[references(^._id) && _type == 'content-award'][0].badge.asset->url,
+    "badge_rear": *[references(^._id) && _type == 'content-award'][0].badge_rear.asset->url,
+    "badge_logo": *[references(^._id) && _type == 'content-award'][0].logo.asset->url,
+    'parentCount': coalesce(count(parent_content_data), 0)
+  }`
+
 export const showsTypes = {
   drumeo: [
     'odd-times',
@@ -346,7 +366,7 @@ export const filterTypes = {
   ],
 }
 
-const lessonRecentTypes = [
+export const lessonRecentTypes = [
   ...individualLessonsTypes,
   'skill-pack-lesson',
   ...entertainmentLessonTypes,
@@ -415,12 +435,12 @@ export let contentTypeConfig = {
     fields: [
       'railcontent_id',
       '"assignments": assignment[]{railcontent_id}',
-      '"metadata": { brand, "type": _type, "parent_id":  coalesce(parent_content_data[0].id, 0) }',
-    ],
+      `"metadata": { brand, "type": _type, "parent_id":  coalesce(${parentReferenceField}->railcontent_id, 0) }`,
+      ],
     childFields: [
       'railcontent_id',
       '"assignments": assignment[]{railcontent_id}',
-      '"metadata": { brand, "type": _type, "parent_id":  coalesce(parent_content_data[0].id, 0) }',
+      `"metadata": { brand, "type": _type, "parent_id":  coalesce(${parentReferenceField}->railcontent_id, 0) }`,
     ],
   },
   song: {
@@ -479,42 +499,40 @@ export let contentTypeConfig = {
   },
   download: {
     fields: [
-      `"resource": ${resourcesField}`,
+      `"resources": ${resourcesField}`,
       'soundslice',
+      'soundslice_slug',
       'instrumentless',
       `"description": ${descriptionField}`,
+      assignmentsField,
       `"chapters": ${chapterField}`,
       '"instructors":instructor[]->name',
       `"instructor": ${instructorField}`,
       'video',
-      `"play_along_mp3s": ${playAlongMp3sField}`,
+      ...playAlongMp3sFields,
+      pcdForDownloadField,
       `...select(
         defined(live_event_start_time) => {
-          "live_event_start_time": live_event_start_time,
-          "live_event_end_time": live_event_end_time,
-          "live_event_stream_id": live_event_stream_id,
-          "videoId": coalesce(live_event_stream_id, video.external_id),
-          "live_event_is_global": live_global_event == true
+          ${getLiveFields(true).join(',')}
         }
       )`,
     ],
     childFields: [
-      `"resource": ${resourcesField}`,
+      `"resources": ${resourcesField}`,
       'soundslice',
+      'soundslice_slug',
       'instrumentless',
       `"description": ${descriptionField}`,
+      assignmentsField,
       `"chapters": ${chapterField}`,
       '"instructors":instructor[]->name',
       `"instructor": ${instructorField}`,
       'video',
-      `"play_along_mp3s": ${playAlongMp3sField}`,
+      ...playAlongMp3sFields,
+      pcdForDownloadField,
       `...select(
         defined(live_event_start_time) => {
-          "live_event_start_time": live_event_start_time,
-          "live_event_end_time": live_event_end_time,
-          "live_event_stream_id": live_event_stream_id,
-          "videoId": coalesce(live_event_stream_id, video.external_id),
-          "live_event_is_global": live_global_event == true
+          ${getLiveFields(true).join(',')}
         }
       )`,
     ],
@@ -676,7 +694,6 @@ export let contentTypeConfig = {
       'show_in_new_feed',
       isLiveField()
     ],
-    includeChildFields: true,
   },
 }
 

package/src/index.d.ts

@@ -225,6 +225,35 @@ import {
 	updateMultiUserAccount
 } from './services/multi-user-accounts/multi-user-accounts.ts';
 
+import {
+	getRecentActivityOffline
+} from './services/offline/activities.ts';
+
+import {
+	getPracticeSessionsOffline,
+	otherStatsOffline
+} from './services/offline/practices.ts';
+
+import {
+	contentStatusCompletedManyOffline,
+	contentStatusCompletedOffline,
+	contentStatusResetOffline,
+	contentStatusStartedOffline,
+	recordWatchSessionOffline
+} from './services/offline/progress.ts';
+
+import {
+	PermissionsAdapter,
+	PermissionsV1Adapter,
+	PermissionsV2Adapter,
+	doesUserHaveMembership,
+	fetchUserPermissions,
+	getPermissionsAdapter,
+	getPermissionsVersion,
+	isUserFreeTier,
+	reset
+} from './services/permissions/index.ts';
+
 import {
 	emitProgressSaved,
 	onProgressSaved
@@ -252,7 +281,6 @@ import {
 	fetchLiveStreamData,
 	fetchRecentUserActivities,
 	fetchTopComment,
-	fetchUserPermissionsData,
 	fetchUserPracticeMeta,
 	fetchUserPracticeNotes,
 	fetchUserPractices,
@@ -323,6 +351,7 @@ import {
 	fetchTabData,
 	fetchTopLevelParentId,
 	fetchUpcomingEvents,
+	getHierarchies,
 	getHierarchy,
 	getSanityDate,
 	getSongTypesFor,
@@ -422,11 +451,6 @@ import {
 	fetchCustomerPayments
 } from './services/user/payments.ts';
 
-import {
-	fetchUserPermissions,
-	reset
-} from './services/user/permissions.js';
-
 import {
 	deleteProfilePicture,
 	otherStats
@@ -444,7 +468,6 @@ import {
 	deletePracticeSession,
 	deleteUserActivity,
 	fetchRecentActivitiesActiveTabs,
-	findIncompleteLesson,
 	getPracticeNotes,
 	getPracticeSessions,
 	getRecentActivity,
@@ -468,6 +491,9 @@ import {
 
 declare module 'musora-content-services' {
 	export {
+		PermissionsAdapter,
+		PermissionsV1Adapter,
+		PermissionsV2Adapter,
 		acceptInvite,
 		addContextToContent,
 		addContextToLearningPaths,
@@ -488,8 +514,12 @@ declare module 'musora-content-services' {
 		confirmEmailChange,
 		contentStatusCompleted,
 		contentStatusCompletedMany,
+		contentStatusCompletedManyOffline,
+		contentStatusCompletedOffline,
 		contentStatusReset,
+		contentStatusResetOffline,
 		contentStatusStarted,
+		contentStatusStartedOffline,
 		convertToTimeZone,
 		createAccount,
 		createComment,
@@ -513,6 +543,7 @@ declare module 'musora-content-services' {
 		deleteProfilePicture,
 		deleteThread,
 		deleteUserActivity,
+		doesUserHaveMembership,
 		duplicatePlaylist,
 		editComment,
 		emitProgressSaved,
@@ -608,14 +639,12 @@ declare module 'musora-content-services' {
 		fetchUnreadCount,
 		fetchUpcomingEvents,
 		fetchUserPermissions,
-		fetchUserPermissionsData,
 		fetchUserPlaylists,
 		fetchUserPracticeMeta,
 		fetchUserPracticeNotes,
 		fetchUserPractices,
 		fetchUsersMultiAccountDetails,
 		filterCoursesInCourseCollections,
-		findIncompleteLesson,
 		flushWatchSession,
 		followThread,
 		generateAuthSessionUrl,
@@ -640,6 +669,7 @@ declare module 'musora-content-services' {
 		getDailySession,
 		getEnrichedLearningPath,
 		getEnrichedLearningPaths,
+		getHierarchies,
 		getHierarchy,
 		getIdsWhereLastAccessedFromMethod,
 		getInProgressAwards,
@@ -654,8 +684,11 @@ declare module 'musora-content-services' {
 		getNewAndUpcoming,
 		getOnboardingRecommendedContent,
 		getOwnedContent,
+		getPermissionsAdapter,
+		getPermissionsVersion,
 		getPracticeNotes,
 		getPracticeSessions,
+		getPracticeSessionsOffline,
 		getProgressDataByIds,
 		getProgressDataByRecordIds,
 		getProgressRows,
@@ -664,6 +697,7 @@ declare module 'musora-content-services' {
 		getProgressStateByRecordIds,
 		getRecent,
 		getRecentActivity,
+		getRecentActivityOffline,
 		getRecommendedForYou,
 		getReportIssueOptions,
 		getResumeTimeSecondsByIds,
@@ -694,6 +728,7 @@ declare module 'musora-content-services' {
 		isContentLikedByIds,
 		isNextDay,
 		isSameDate,
+		isUserFreeTier,
 		isUsernameAvailable,
 		jumpToContinueContent,
 		jumpToPost,
@@ -718,6 +753,7 @@ declare module 'musora-content-services' {
 		onProgressSaved,
 		openComment,
 		otherStats,
+		otherStatsOffline,
 		pauseLiveEventPolling,
 		pinProgressRow,
 		pinThread,
@@ -728,6 +764,7 @@ declare module 'musora-content-services' {
 		recordUserActivity,
 		recordUserPractice,
 		recordWatchSession,
+		recordWatchSessionOffline,
 		registerAwardCallback,
 		registerProgressCallback,
 		removeContentAsInterested,

package/src/index.js

@@ -229,6 +229,35 @@ import {
 	updateMultiUserAccount
 } from './services/multi-user-accounts/multi-user-accounts.ts';
 
+import {
+	getRecentActivityOffline
+} from './services/offline/activities.ts';
+
+import {
+	getPracticeSessionsOffline,
+	otherStatsOffline
+} from './services/offline/practices.ts';
+
+import {
+	contentStatusCompletedManyOffline,
+	contentStatusCompletedOffline,
+	contentStatusResetOffline,
+	contentStatusStartedOffline,
+	recordWatchSessionOffline
+} from './services/offline/progress.ts';
+
+import {
+	PermissionsAdapter,
+	PermissionsV1Adapter,
+	PermissionsV2Adapter,
+	doesUserHaveMembership,
+	fetchUserPermissions,
+	getPermissionsAdapter,
+	getPermissionsVersion,
+	isUserFreeTier,
+	reset
+} from './services/permissions/index.ts';
+
 import {
 	emitProgressSaved,
 	onProgressSaved
@@ -256,7 +285,6 @@ import {
 	fetchLiveStreamData,
 	fetchRecentUserActivities,
 	fetchTopComment,
-	fetchUserPermissionsData,
 	fetchUserPracticeMeta,
 	fetchUserPracticeNotes,
 	fetchUserPractices,
@@ -327,6 +355,7 @@ import {
 	fetchTabData,
 	fetchTopLevelParentId,
 	fetchUpcomingEvents,
+	getHierarchies,
 	getHierarchy,
 	getSanityDate,
 	getSongTypesFor,
@@ -426,11 +455,6 @@ import {
 	fetchCustomerPayments
 } from './services/user/payments.ts';
 
-import {
-	fetchUserPermissions,
-	reset
-} from './services/user/permissions.js';
-
 import {
 	deleteProfilePicture,
 	otherStats
@@ -448,7 +472,6 @@ import {
 	deletePracticeSession,
 	deleteUserActivity,
 	fetchRecentActivitiesActiveTabs,
-	findIncompleteLesson,
 	getPracticeNotes,
 	getPracticeSessions,
 	getRecentActivity,
@@ -467,6 +490,9 @@ import {
 } from './services/userActivity.js';
 
 export {
+	PermissionsAdapter,
+	PermissionsV1Adapter,
+	PermissionsV2Adapter,
 	acceptInvite,
 	addContextToContent,
 	addContextToLearningPaths,
@@ -487,8 +513,12 @@ export {
 	confirmEmailChange,
 	contentStatusCompleted,
 	contentStatusCompletedMany,
+	contentStatusCompletedManyOffline,
+	contentStatusCompletedOffline,
 	contentStatusReset,
+	contentStatusResetOffline,
 	contentStatusStarted,
+	contentStatusStartedOffline,
 	convertToTimeZone,
 	createAccount,
 	createComment,
@@ -512,6 +542,7 @@ export {
 	deleteProfilePicture,
 	deleteThread,
 	deleteUserActivity,
+	doesUserHaveMembership,
 	duplicatePlaylist,
 	editComment,
 	emitProgressSaved,
@@ -607,14 +638,12 @@ export {
 	fetchUnreadCount,
 	fetchUpcomingEvents,
 	fetchUserPermissions,
-	fetchUserPermissionsData,
 	fetchUserPlaylists,
 	fetchUserPracticeMeta,
 	fetchUserPracticeNotes,
 	fetchUserPractices,
 	fetchUsersMultiAccountDetails,
 	filterCoursesInCourseCollections,
-	findIncompleteLesson,
 	flushWatchSession,
 	followThread,
 	generateAuthSessionUrl,
@@ -639,6 +668,7 @@ export {
 	getDailySession,
 	getEnrichedLearningPath,
 	getEnrichedLearningPaths,
+	getHierarchies,
 	getHierarchy,
 	getIdsWhereLastAccessedFromMethod,
 	getInProgressAwards,
@@ -653,8 +683,11 @@ export {
 	getNewAndUpcoming,
 	getOnboardingRecommendedContent,
 	getOwnedContent,
+	getPermissionsAdapter,
+	getPermissionsVersion,
 	getPracticeNotes,
 	getPracticeSessions,
+	getPracticeSessionsOffline,
 	getProgressDataByIds,
 	getProgressDataByRecordIds,
 	getProgressRows,
@@ -663,6 +696,7 @@ export {
 	getProgressStateByRecordIds,
 	getRecent,
 	getRecentActivity,
+	getRecentActivityOffline,
 	getRecommendedForYou,
 	getReportIssueOptions,
 	getResumeTimeSecondsByIds,
@@ -693,6 +727,7 @@ export {
 	isContentLikedByIds,
 	isNextDay,
 	isSameDate,
+	isUserFreeTier,
 	isUsernameAvailable,
 	jumpToContinueContent,
 	jumpToPost,
@@ -717,6 +752,7 @@ export {
 	onProgressSaved,
 	openComment,
 	otherStats,
+	otherStatsOffline,
 	pauseLiveEventPolling,
 	pinProgressRow,
 	pinThread,
@@ -727,6 +763,7 @@ export {
 	recordUserActivity,
 	recordUserPractice,
 	recordWatchSession,
+	recordWatchSessionOffline,
 	registerAwardCallback,
 	registerProgressCallback,
 	removeContentAsInterested,

package/src/lib/sanity/filter.ts

@@ -1,6 +1,6 @@
 import { filtersToGroq } from '../../contentTypeConfig'
 import { getPermissionsAdapter } from '../../services/permissions/index'
-import type { UserPermissions } from '../../services/permissions/PermissionsAdapter'
+import type { UserPermissions } from '../../services/permissions/types'
 import { Brands } from '../brands'
 import { filterOps } from './query'
 

package/src/services/content-org/learning-paths.ts

@@ -4,10 +4,12 @@
 
 import { GET, POST } from '../../infrastructure/http/HttpClient'
 import {
+  devFetchAllLearningPathsAndIntroVideoIdsForDelete,
   fetchByRailContentId,
   fetchByRailContentIds,
   fetchMethodV2Structure,
-  fetchParentChildRelationshipsFor
+  fetchParentChildRelationshipsFor,
+  hasAnyMethodV2IntroCompleted,
 } from '../sanity.js'
 import { addContextToLearningPaths } from '../contentAggregator.js'
 import {
@@ -18,12 +20,11 @@ import {
   getIdsWhereLastAccessedFromMethod,
   getProgressState,
 } from '../contentProgress.js'
-import { COLLECTION_ID_SELF, COLLECTION_TYPE, STATE } from '../sync/models/ContentProgress'
-import { SyncWriteDTO } from '../sync'
+import { COLLECTION_ID_SELF, COLLECTION_TYPE, CollectionParameter, STATE } from '../sync/models/ContentProgress'
+import { db, SyncWriteDTO } from '../sync'
 import { ContentProgress } from '../sync/models'
-import { CollectionParameter } from '../sync/models/ContentProgress'
 import dayjs from 'dayjs'
-import { LEARNING_PATH_LESSON } from "../../contentTypeConfig";
+import { LEARNING_PATH_LESSON } from '../../contentTypeConfig'
 
 const BASE_PATH: string = `/api/content-org`
 const LEARNING_PATHS_PATH = `${BASE_PATH}/v1/user/learning-paths`
@@ -196,7 +197,18 @@ async function dataPromiseGET(
  */
 export async function resetAllLearningPaths() {
   const url: string = `${LEARNING_PATHS_PATH}/reset`
-  return await POST(url, {})
+
+  return await Promise.all([
+    devFetchAllLearningPathsAndIntroVideoIdsForDelete().then(async (all) => {
+      await Promise.all([
+        db.contentProgress.eraseProgressMany(all.intros, null),
+        ...all.learning_paths.map((id) =>
+          db.contentProgress.eraseProgress(id, {id, type: COLLECTION_TYPE.LEARNING_PATH})
+        )
+      ])
+    }),
+    POST(url, {}),
+  ])
 }
 
 /**
@@ -457,20 +469,20 @@ interface completeMethodIntroVideo {
 }
 /**
  * Handles completion of method intro video and other related actions.
- * @param introVideoId - The method intro video content ID.
+ * @param introVideoId - The method intro video content ID. If not provided, does not `complete` intro video.
  * @param brand
  * @returns {Promise<Array>} response - The response object.
  * @returns {Promise<Object|null>} response.intro_video_response - The intro video completion response or null if already completed.
  * @returns {Promise<Object>} response.active_path_response - The set active learning path response.
  */
 export async function completeMethodIntroVideo(
-  introVideoId: number,
+  introVideoId: number|null,
   brand: string
 ): Promise<completeMethodIntroVideo> {
   let response = {} as completeMethodIntroVideo
 
   const [intro_video_response, methodStructure] = await Promise.all([
-    completeIfNotCompleted(introVideoId),
+    introVideoId ? completeIfNotCompleted(introVideoId) : Promise.resolve(null),
     fetchMethodV2Structure(brand)
   ])
   response.intro_video_response = intro_video_response
@@ -520,13 +532,25 @@ export async function completeLearningPathIntroVideo(
   let response = {} as completeLearningPathIntroVideo
   const collection: CollectionObject = { id: learningPathId, type: COLLECTION_TYPE.LEARNING_PATH }
 
+  const [anyIntroComplete, activePath] = await Promise.all([
+    hasAnyMethodV2IntroCompleted(),
+    getActivePath(brand)
+  ])
+
+  let lateMethodSetup = false
+  // check if the method intro was watched elsewhere; then we have to give user active path for this brand.
+  if (anyIntroComplete && !activePath) {
+    completeMethodIntroVideo(null, brand) // no need to await.
+    lateMethodSetup = true
+  }
+
   if (!lessonsToImport) {
     response.learning_path_reset_response = await resetIfPossible(learningPathId, collection)
   } else {
     response.lesson_import_response = await contentStatusCompletedMany(lessonsToImport, collection)
 
     const activePath = await getActivePath(brand)
-    if (activePath.active_learning_path_id === learningPathId) {
+    if (activePath.active_learning_path_id === learningPathId && !lateMethodSetup) { // don't update dailies if they were just set by completeMethodIntroVideoCompleteActions.
       response.update_dailies_response = await updateDailySession(brand, new Date(), true)
     }
   }