musora-content-services 2.77.1 → 2.78.0

package/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rg:*)"
+    ],
+    "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.78.0](https://github.com/railroadmedia/musora-content-services/compare/v2.77.2...v2.78.0) (2025-11-15)
+
+
+### Features
+
+* **BEH-1409:** complete intro video ([#566](https://github.com/railroadmedia/musora-content-services/issues/566)) ([fb2fa96](https://github.com/railroadmedia/musora-content-services/commit/fb2fa96f408948cf4c3501709dc2ec2c17f23163))
+
+### [2.77.2](https://github.com/railroadmedia/musora-content-services/compare/v2.77.1...v2.77.2) (2025-11-14)
+
 ### [2.77.1](https://github.com/railroadmedia/musora-content-services/compare/v2.77.0...v2.77.1) (2025-11-13)
 
 

package/package.json

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

package/src/contentTypeConfig.js

@@ -299,8 +299,7 @@ export const progressTypesMapping = {
   'play along': playAlongLessonTypes,
   'guided course': ['guided-course'],
   pack: ['pack', 'semester-pack'],
-  method: ['method-card', 'method-intro'],
-  'learning path': ['learning-path'],
+  'learning path': ['learning-path-v2'],
   'jam track': jamTrackLessonTypes,
   'course video': ['course-part'],
 }
@@ -346,7 +345,7 @@ export const recentTypes = {
     ...transcriptionsLessonTypes,
     ...playAlongLessonTypes,
     'guided-course',
-    'learning-path',
+    'learning-path-v2',
     'live',
     'course',
     'pack',
@@ -460,28 +459,9 @@ export let contentTypeConfig = {
       )`,
     ],
   },
-  method: {
-    fields: [
-      `"description": ${descriptionField}`,
-      'hide_from_recsys',
-      '"image": thumbnail.asset->url',
-      '"instructors":instructor[]->name',
-      '"lesson_count": child_count',
-      'length_in_seconds',
-      'permission',
-      'popularity',
-      'published_on',
-      'railcontent_id',
-      '"thumbnail_logo": logo_image_url.asset->url',
-      'title',
-      'total_xp',
-      '"type": _type',
-      'xp',
-    ],
-  },
   'learning-path-v2': {
     fields: [
-      `"intro_video": intro_video->{ ${getIntroVideoFields('learning-path').join(', ')} }`,
+      `"intro_video": intro_video->{ ${getIntroVideoFields('learning-path-v2').join(', ')} }`,
       'total_skills',
       `"resource": ${resourcesField}`,
       `"badge": *[
@@ -491,40 +471,6 @@ export let contentTypeConfig = {
     ],
     includeChildFields: true,
   },
-  'learning-path-course': {
-    fields: [
-      '"lesson_count": child_count',
-      '"instructors": instructor[]->name',
-      `"description": ${descriptionField}`,
-      `"resource": ${resourcesField}`,
-      'xp',
-      'total_xp',
-      `"lessons": child[]->{
-                "id": railcontent_id,
-                title,
-                "image": thumbnail.asset->url,
-                "instructors": instructor[]->name,
-                length_in_seconds,
-            }`,
-    ],
-  },
-  'learning-path-level': {
-    fields: [
-      '"lesson_count": child_count',
-      '"instructors": instructor[]->name',
-      `"description": ${descriptionField}`,
-      `"resource": ${resourcesField}`,
-      'xp',
-      'total_xp',
-      `"lessons": child[]->{
-                "id": railcontent_id,
-                title,
-                "image": thumbnail.asset->url,
-                "instructors": instructor[]->name,
-                length_in_seconds,
-            }`,
-    ],
-  },
   workout: {
     fields: [artistOrInstructorNameAsArray()],
     slug: 'workouts',
@@ -680,7 +626,7 @@ export let contentTypeConfig = {
     `"type":_type`,
     'title',
     'brand',
-    `"intro_video": intro_video->{ ${getIntroVideoFields('method').join(', ')} }`,
+    `"intro_video": intro_video->{ ${getIntroVideoFields('method-v2').join(', ')} }`,
     `child[]->{
       "resource": ${resourcesField},
       total_skills,
@@ -740,7 +686,6 @@ export function getNewReleasesTypes(brand) {
     'podcasts',
     'pack',
     'song',
-    'learning-path-level',
     'play-along',
     'course',
     'unit',

package/src/index.d.ts

@@ -13,10 +13,12 @@ import {
 } from './services/content-org/guided-courses.ts';
 
 import {
+	completeLearningPathIntroVideo,
+	completeMethodIntroVideo,
 	fetchLearningPathLessons,
 	getActivePath,
 	getDailySession,
-	getLearningPath,
+	getEnrichedLearningPath,
 	getLearningPathLessonsByIds,
 	mapContentToParent,
 	resetAllLearningPaths,
@@ -132,6 +134,7 @@ import {
 	fetchThreads,
 	followThread,
 	lockThread,
+	markThreadAsRead,
 	pinThread,
 	unfollowThread,
 	unlockThread,
@@ -406,6 +409,8 @@ declare module 'musora-content-services' {
 		buildImageSRC,
 		calculateLongestStreaks,
 		closeComment,
+		completeLearningPathIntroVideo,
+		completeMethodIntroVideo,
 		confirmEmailChange,
 		contentStatusCompleted,
 		contentStatusReset,
@@ -542,8 +547,8 @@ declare module 'musora-content-services' {
 		getAwardDataForGuidedContent,
 		getContentRows,
 		getDailySession,
+		getEnrichedLearningPath,
 		getLastInteractedOf,
-		getLearningPath,
 		getLearningPathLessonsByIds,
 		getLegacyMethods,
 		getLessonContentRows,
@@ -604,6 +609,7 @@ declare module 'musora-content-services' {
 		markContentAsNotInterested,
 		markNotificationAsRead,
 		markNotificationAsUnread,
+		markThreadAsRead,
 		numberOfActiveUsers,
 		openComment,
 		otherStats,

package/src/index.js

@@ -13,10 +13,12 @@ import {
 } from './services/content-org/guided-courses.ts';
 
 import {
+	completeLearningPathIntroVideo,
+	completeMethodIntroVideo,
 	fetchLearningPathLessons,
 	getActivePath,
 	getDailySession,
-	getLearningPath,
+	getEnrichedLearningPath,
 	getLearningPathLessonsByIds,
 	mapContentToParent,
 	resetAllLearningPaths,
@@ -132,6 +134,7 @@ import {
 	fetchThreads,
 	followThread,
 	lockThread,
+	markThreadAsRead,
 	pinThread,
 	unfollowThread,
 	unlockThread,
@@ -405,6 +408,8 @@ export {
 	buildImageSRC,
 	calculateLongestStreaks,
 	closeComment,
+	completeLearningPathIntroVideo,
+	completeMethodIntroVideo,
 	confirmEmailChange,
 	contentStatusCompleted,
 	contentStatusReset,
@@ -541,8 +546,8 @@ export {
 	getAwardDataForGuidedContent,
 	getContentRows,
 	getDailySession,
+	getEnrichedLearningPath,
 	getLastInteractedOf,
-	getLearningPath,
 	getLearningPathLessonsByIds,
 	getLegacyMethods,
 	getLessonContentRows,
@@ -603,6 +608,7 @@ export {
 	markContentAsNotInterested,
 	markNotificationAsRead,
 	markNotificationAsUnread,
+	markThreadAsRead,
 	numberOfActiveUsers,
 	openComment,
 	otherStats,

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

@@ -5,9 +5,25 @@
 import { fetchHandler } from '../railcontent.js'
 import { fetchByRailContentId, fetchByRailContentIds, fetchMethodV2Structure } from '../sanity.js'
 import { addContextToContent } from '../contentAggregator.js'
-import { getProgressStateByIds } from '../contentProgress.js'
+import {
+  contentStatusCompleted,
+  contentStatusReset,
+  getProgressState,
+  getProgressStateByIds
+} from '../contentProgress.js'
 
 const BASE_PATH: string = `/api/content-org`
+const LEARNING_PATHS_PATH = `${BASE_PATH}/v1/user/learning-paths`
+
+interface ActiveLearningPathResponse {
+  user_id: number,
+  brand: string,
+  active_learning_path_id: number,
+}
+
+
+
+
 
 /**
  * Gets today's daily session for the user.
@@ -16,7 +32,7 @@ const BASE_PATH: string = `/api/content-org`
  */
 export async function getDailySession(brand: string, userDate: Date) {
   const stringDate = userDate.toISOString().split('T')[0]
-  const url: string = `${BASE_PATH}/v1/user/learning-paths/daily-session/get-or-create`
+  const url: string = `${LEARNING_PATHS_PATH}/daily-session/get-or-create`
   const body = { brand: brand, userDate: stringDate }
   return await fetchHandler(url, 'POST', null, body)
 }
@@ -33,7 +49,7 @@ export async function updateDailySession(
   keepFirstLearningPath: boolean
 ) {
   const stringDate = userDate.toISOString().split('T')[0]
-  const url: string = `${BASE_PATH}/v1/user/learning-paths/daily-session/update`
+  const url: string = `${LEARNING_PATHS_PATH}/daily-session/update`
   const body = { brand: brand, userDate: stringDate, keepFirstLearningPath: keepFirstLearningPath }
   return await fetchHandler(url, 'POST', null, body)
 }
@@ -43,17 +59,19 @@ export async function updateDailySession(
  * @param brand
  */
 export async function getActivePath(brand: string) {
-  const url: string = `${BASE_PATH}/v1/user/learning-paths/active-path/get-or-create`
+  const url: string = `${LEARNING_PATHS_PATH}/active-path/get-or-create`
   const body = { brand: brand }
   return await fetchHandler(url, 'POST', null, body)
 }
 
+// todo this should be removed once we handle active path gen only through
+//  finish method intro or complete current active path
 /**
  * Updates user's active learning path.
  * @param brand
  */
 export async function updateActivePath(brand: string) {
-  const url: string = `${BASE_PATH}/v1/user/learning-paths/active-path/update`
+  const url: string = `${LEARNING_PATHS_PATH}/active-path/update`
   const body = { brand: brand }
   return await fetchHandler(url, 'POST', null, body)
 }
@@ -64,7 +82,7 @@ export async function updateActivePath(brand: string) {
  * @param learningPathId
  */
 export async function startLearningPath(brand: string, learningPathId: number) {
-  const url: string = `${BASE_PATH}/v1/user/learning-paths/start`
+  const url: string = `${LEARNING_PATHS_PATH}/start`
   const body = { brand: brand, learning_path_id: learningPathId }
   return await fetchHandler(url, 'POST', null, body)
 }
@@ -73,7 +91,7 @@ export async function startLearningPath(brand: string, learningPathId: number) {
  * Resets the user's learning path.
  */
 export async function resetAllLearningPaths() {
-  const url: string = `${BASE_PATH}/v1/user/learning-paths/reset`
+  const url: string = `${LEARNING_PATHS_PATH}/reset`
   return await fetchHandler(url, 'POST', null, {})
 }
 
@@ -82,8 +100,8 @@ export async function resetAllLearningPaths() {
  * @param {number} learningPathId - The learning path ID
  * @returns {Promise<Object>} Learning path with enriched lesson data
  */
-export async function getLearningPath(learningPathId) {
-  //TODO: must be a cleaner way to do this
+export async function getEnrichedLearningPath(learningPathId) {
+  //TODO BEH-1410: refactor/cleanup
   let learningPath = await fetchByRailContentId(learningPathId, 'learning-path-v2')
   learningPath.children = mapContentToParent(
     learningPath.children,
@@ -109,10 +127,16 @@ export async function getLearningPath(learningPathId) {
 export async function getLearningPathLessonsByIds(contentIds, learningPathId) {
   // It is more efficient to load the entire learning path than individual lessons
   // Also adds reliability check whether content is actually in the learning path
-  const learningPath = await getLearningPath(learningPathId)
+  const learningPath = await getEnrichedLearningPath(learningPathId)
   return learningPath.children.filter((lesson) => contentIds.includes(lesson.id))
 }
 
+/**
+ * Maps content to its parent learning path - fixes multi-parent problems for cta when lessons have a special collection.
+ * @param lessons
+ * @param parentContentType
+ * @param parentContentId
+ */
 export function mapContentToParent(lessons, parentContentType, parentContentId) {
   return lessons.map((lesson: any) => {
     return { ...lesson, type: parentContentType, parent_id: parentContentId }
@@ -142,7 +166,7 @@ export async function fetchLearningPathLessons(
   userDate: Date
 ) {
   const [learningPath, dailySession] = await Promise.all([
-    getLearningPath(learningPathId),
+    getEnrichedLearningPath(learningPathId),
     getDailySession(brand, userDate),
   ])
 
@@ -198,7 +222,69 @@ export async function fetchLearningPathLessons(
     upcoming_lessons: upcomingLessons,
     todays_lessons: todaysLessons,
     next_learning_path_lessons: nextLPLessons,
+    next_learning_path_id: nextLearningPathId,
     completed_lessons: completedLessons,
     previous_learning_path_todays: previousLearningPathTodays,
   }
 }
+
+interface completeMethodIntroVideo {
+  intro_video_response: Object | null,
+  active_path_response: ActiveLearningPathResponse
+}
+/**
+ * Handles completion of method intro video and other related actions.
+ * @param introVideoId - The intro video content ID.
+ * @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, brand: string): Promise<completeMethodIntroVideo> {
+  let response = {} as completeMethodIntroVideo
+
+  response.intro_video_response = await completeIfNotCompleted(introVideoId)
+
+  const url: string = `${LEARNING_PATHS_PATH}/start`
+  const body = { brand: brand }
+  response.active_path_response = await fetchHandler(url, 'POST', null, body)
+
+  return response
+}
+
+interface completeLearningPathIntroVideo {
+  intro_video_response: Object | null,
+  learning_path_reset_response: void | Object[] | Object
+}
+/**
+ * Handles completion of learning path intro video and other related actions.
+ * @param introVideoId
+ * @param learningPathId
+ * @param lessonsToImport
+ */
+export async function completeLearningPathIntroVideo(introVideoId: number, learningPathId: number, lessonsToImport: number[] | null) {
+  let response = {} as completeLearningPathIntroVideo
+
+  response.intro_video_response = await completeIfNotCompleted(introVideoId)
+
+  if (!lessonsToImport) {
+    // reset progress within the learning path
+    response.learning_path_reset_response = await contentStatusReset(learningPathId)
+  } else {
+    response.learning_path_reset_response = null
+
+    // todo: add collection context + optimize with bulk calls with watermelon
+    for (const contentId of lessonsToImport) {
+      response.learning_path_reset_response[contentId] = await contentStatusCompleted(contentId)
+    }
+  }
+
+  return response
+}
+
+
+async function completeIfNotCompleted(contentId: number): Promise<Object | null> {
+  const introVideoStatus = await getProgressState(contentId)
+
+  return introVideoStatus !== 'completed' ? await contentStatusCompleted(contentId) : null
+}

package/src/services/sanity.js

@@ -878,6 +878,7 @@ export async function fetchAllFilterOptions(
   return includeTabs ? { ...results, tabs, catalogName } : results
 }
 
+//Daniel Nov 14 2025 note - keeping this for when we migrate foundations to packs, so we know what fields to use.
 /**
  * Fetch the Foundations 2019.
  * @param {string} slug - The slug of the method.
@@ -903,6 +904,7 @@ export async function fetchFoundation(slug) {
  * @param {string} slug - The slug of the method.
  * @returns {Promise<Object|null>} - The fetched methods data or null if not found.
  */
+//todo BEH-1446 depreciated. remove all old method functions
 export async function fetchMethod(brand, slug) {
   const childrenFilter = await new FilterBuilder(``, { isChildrenFilter: true }).buildFilter()