musora-content-services 2.95.5 → 2.96.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.96.1](https://github.com/railroadmedia/musora-content-services/compare/v2.96.0...v2.96.1) (2025-12-09)
+
+
+### Bug Fixes
+
+* **agi:** interface return types ([cc0cfae](https://github.com/railroadmedia/musora-content-services/commit/cc0cfae1282266567ac46a6eb072f76ffde7032e))
+
+## [2.96.0](https://github.com/railroadmedia/musora-content-services/compare/v2.95.5...v2.96.0) (2025-12-09)
+
+
+### Features
+
+* handle learning path complete logic ([#628](https://github.com/railroadmedia/musora-content-services/issues/628)) ([e5266d2](https://github.com/railroadmedia/musora-content-services/commit/e5266d2219597fc295dab97cec7b7ce8ac80a705))
+
 ### [2.95.5](https://github.com/railroadmedia/musora-content-services/compare/v2.95.4...v2.95.5) (2025-12-08)
 
 ### [2.95.4](https://github.com/railroadmedia/musora-content-services/compare/v2.95.3...v2.95.4) (2025-12-08)

package/package.json

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

package/src/index.d.ts

@@ -52,6 +52,7 @@ import {
 	getEnrichedLearningPath,
 	getLearningPathLessonsByIds,
 	mapContentToParent,
+	onContentCompletedLearningPathListener,
 	resetAllLearningPaths,
 	startLearningPath,
 	updateDailySession
@@ -193,7 +194,9 @@ import {
 } from './services/liveTesting.ts';
 
 import {
+	emitContentCompleted,
 	emitProgressSaved,
+	onContentCompleted,
 	onProgressSaved
 } from './services/progress-events.js';
 
@@ -423,7 +426,7 @@ import {
 } from './services/userActivity.js';
 
 import {
-	 default as EventsAPI 
+	 default as EventsAPI
 } from './services/eventsAPI';
 
 declare module 'musora-content-services' {
@@ -468,6 +471,7 @@ declare module 'musora-content-services' {
 		deleteUserActivity,
 		duplicatePlaylist,
 		editComment,
+		emitContentCompleted,
 		emitProgressSaved,
 		enrollUserInGuidedCourse,
 		extractSanityUrl,
@@ -651,6 +655,8 @@ declare module 'musora-content-services' {
 		markNotificationAsUnread,
 		markThreadAsRead,
 		numberOfActiveUsers,
+		onContentCompleted,
+		onContentCompletedLearningPathListener,
 		onProgressSaved,
 		openComment,
 		otherStats,

package/src/index.js

@@ -1,7 +1,7 @@
 /*** This file was generated automatically. To recreate, please run `npm run build-index`. ***/
 
 import {
-	 default as EventsAPI 
+	 default as EventsAPI
 } from './services/eventsAPI';
 
 import {
@@ -56,6 +56,7 @@ import {
 	getEnrichedLearningPath,
 	getLearningPathLessonsByIds,
 	mapContentToParent,
+	onContentCompletedLearningPathListener,
 	resetAllLearningPaths,
 	startLearningPath,
 	updateDailySession
@@ -197,7 +198,9 @@ import {
 } from './services/liveTesting.ts';
 
 import {
+	emitContentCompleted,
 	emitProgressSaved,
+	onContentCompleted,
 	onProgressSaved
 } from './services/progress-events.js';
 
@@ -467,6 +470,7 @@ export {
 	deleteUserActivity,
 	duplicatePlaylist,
 	editComment,
+	emitContentCompleted,
 	emitProgressSaved,
 	enrollUserInGuidedCourse,
 	extractSanityUrl,
@@ -650,6 +654,8 @@ export {
 	markNotificationAsUnread,
 	markThreadAsRead,
 	numberOfActiveUsers,
+	onContentCompleted,
+	onContentCompletedLearningPathListener,
 	onProgressSaved,
 	openComment,
 	otherStats,

package/src/services/content/artist.ts

@@ -15,6 +15,11 @@ export interface Artist {
   lessonCount: number
 }
 
+export interface Artists {
+  data: Artist[]
+  total: number
+}
+
 /**
  * Fetch all artists with lessons available for a specific brand.
  *
@@ -29,7 +34,7 @@ export interface Artist {
 export async function fetchArtists(
   brand: Brands | string,
   options: BuildQueryOptions = { sort: 'lower(name) asc' }
-): Promise<Artist[] | null> {
+): Promise<Artists> {
   const lessonFilter = await new FilterBuilder(`brand == "${brand}" && references(^._id)`, {
     bypassPermissions: true,
   }).buildFilter()

package/src/services/content/genre.ts

@@ -15,6 +15,11 @@ export interface Genre {
   thumbnail: string
 }
 
+export interface Genres {
+  data: Genre[]
+  total: number
+}
+
 /**
  * Fetch all genres with lessons available for a specific brand.
  *
@@ -29,7 +34,7 @@ export interface Genre {
 export async function fetchGenres(
   brand: Brands | string,
   options: BuildQueryOptions = { sort: 'lower(name) asc' }
-): Promise<Genre[]> {
+): Promise<Genres> {
   const lessonFilter = await new FilterBuilder(`brand == "${brand}" && references(^._id)`, {
     bypassPermissions: true,
   }).buildFilter()

package/src/services/content/instructor.ts

@@ -35,7 +35,7 @@ export interface Instructors {
 export async function fetchInstructors(
   brand: Brands | string,
   options: BuildQueryOptions
-): Promise<Instructor[]> {
+): Promise<Instructors> {
   const lessonFilter = await new FilterBuilder(`brand == "${brand}" && references(^._id)`, {
     bypassPermissions: true,
   }).buildFilter()

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

@@ -12,31 +12,31 @@ import {
   getAllCompletedByIds,
   getProgressState,
 } from '../contentProgress.js'
-import { COLLECTION_TYPE, STATE } from "../sync/models/ContentProgress";
-import { SyncWriteDTO } from "../sync";
-import { ContentProgress } from "../sync/models";
+import { COLLECTION_TYPE, STATE } from '../sync/models/ContentProgress'
+import { SyncWriteDTO } from '../sync'
+import { ContentProgress } from '../sync/models'
 
 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,
+  user_id: number
+  brand: string
+  active_learning_path_id: number
 }
 
 interface DailySessionResponse {
-  user_id: number,
-  brand: string,
+  user_id: number
+  brand: string
   user_date: string
-  daily_session: DailySession[],
-  active_learning_path_id: number,
-  active_learning_path_created_at: string,
+  daily_session: DailySession[]
+  active_learning_path_id: number
+  active_learning_path_created_at: string
 }
 
 interface DailySession {
-  content_ids: number[],
-  learning_path_id: number,
+  content_ids: number[]
+  learning_path_id: number
 }
 
 /**
@@ -47,7 +47,7 @@ interface DailySession {
 export async function getDailySession(brand: string, userDate: Date) {
   const stringDate = userDate.toISOString().split('T')[0]
   const url: string = `${LEARNING_PATHS_PATH}/daily-session/get?brand=${brand}&userDate=${stringDate}`
-  return await fetchHandler(url, 'GET', null, null) as DailySessionResponse
+  return (await fetchHandler(url, 'GET', null, null)) as DailySessionResponse
 }
 
 /**
@@ -64,7 +64,7 @@ export async function updateDailySession(
   const stringDate = userDate.toISOString().split('T')[0]
   const url: string = `${LEARNING_PATHS_PATH}/daily-session/create`
   const body = { brand: brand, userDate: stringDate, keepFirstLearningPath: keepFirstLearningPath }
-  return await fetchHandler(url, 'POST', null, body) as DailySessionResponse
+  return (await fetchHandler(url, 'POST', null, body)) as DailySessionResponse
 }
 
 /**
@@ -73,7 +73,7 @@ export async function updateDailySession(
  */
 export async function getActivePath(brand: string) {
   const url: string = `${LEARNING_PATHS_PATH}/active-path/get?brand=${brand}`
-  return await fetchHandler(url, 'GET', null, null) as ActiveLearningPathResponse
+  return (await fetchHandler(url, 'GET', null, null)) as ActiveLearningPathResponse
 }
 
 /**
@@ -84,7 +84,7 @@ export async function getActivePath(brand: string) {
 export async function startLearningPath(brand: string, learningPathId: number) {
   const url: string = `${LEARNING_PATHS_PATH}/active-path/set`
   const body = { brand: brand, learning_path_id: learningPathId }
-  return await fetchHandler(url, 'POST', null, body) as ActiveLearningPathResponse
+  return (await fetchHandler(url, 'POST', null, body)) as ActiveLearningPathResponse
 }
 
 /**
@@ -227,8 +227,6 @@ export async function fetchLearningPathLessons(
     }))
   }
 
-
-
   return {
     ...learningPath,
     is_active_learning_path: isActiveLearningPath,
@@ -250,14 +248,16 @@ export async function fetchLearningPathLessons(
  * @param {number[]} contentIds The array of content IDs within the learning path
  * @returns {Promise<number[]>} Array with completed content IDs
  */
-export async function fetchLearningPathProgressCheckLessons(contentIds: number[]): Promise<number[]> {
+export async function fetchLearningPathProgressCheckLessons(
+  contentIds: number[]
+): Promise<number[]> {
   let query = await getAllCompletedByIds(contentIds)
-  let completedProgress = query.data.map(progress => progress.content_id)
-  return contentIds.filter(contentId => completedProgress.includes(contentId))
+  let completedProgress = query.data.map((progress) => progress.content_id)
+  return contentIds.filter((contentId) => completedProgress.includes(contentId))
 }
 
 interface completeMethodIntroVideo {
-  intro_video_response: SyncWriteDTO<ContentProgress, any> | null,
+  intro_video_response: SyncWriteDTO<ContentProgress, any> | null
   active_path_response: ActiveLearningPathResponse
 }
 /**
@@ -268,7 +268,10 @@ interface completeMethodIntroVideo {
  * @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> {
+export async function completeMethodIntroVideo(
+  introVideoId: number,
+  brand: string
+): Promise<completeMethodIntroVideo> {
   let response = {} as completeMethodIntroVideo
 
   response.intro_video_response = await completeIfNotCompleted(introVideoId)
@@ -278,13 +281,12 @@ export async function completeMethodIntroVideo(introVideoId: number, brand: stri
 
   response.active_path_response = await startLearningPath(brand, learningPathId)
 
-
   return response
 }
 
 interface completeLearningPathIntroVideo {
-  intro_video_response: SyncWriteDTO<ContentProgress, any> | null,
-  learning_path_reset_response: SyncWriteDTO<ContentProgress, any> | null,
+  intro_video_response: SyncWriteDTO<ContentProgress, any> | null
+  learning_path_reset_response: SyncWriteDTO<ContentProgress, any> | null
   lesson_import_response: SyncWriteDTO<ContentProgress, any> | null
 }
 /**
@@ -297,7 +299,11 @@ interface completeLearningPathIntroVideo {
  * @returns {Promise<void>} response.learning_path_reset_response - The reset learning path response.
  * @returns {Promise<Object[]>} response.lesson_import_response - The responses for completing each content_id within the learning path.
  */
-export async function completeLearningPathIntroVideo(introVideoId: number, learningPathId: number, lessonsToImport: number[] | null) {
+export async function completeLearningPathIntroVideo(
+  introVideoId: number,
+  learningPathId: number,
+  lessonsToImport: number[] | null
+) {
   let response = {} as completeLearningPathIntroVideo
 
   response.intro_video_response = await completeIfNotCompleted(introVideoId)
@@ -306,7 +312,6 @@ export async function completeLearningPathIntroVideo(introVideoId: number, learn
 
   if (!lessonsToImport) {
     response.learning_path_reset_response = await contentStatusReset(learningPathId, collection)
-
   } else {
     response.lesson_import_response = await contentsStatusCompleted(lessonsToImport, collection)
   }
@@ -314,9 +319,39 @@ export async function completeLearningPathIntroVideo(introVideoId: number, learn
   return response
 }
 
-
-async function completeIfNotCompleted(contentId: number): Promise<SyncWriteDTO<ContentProgress, any> | null> {
+async function completeIfNotCompleted(
+  contentId: number
+): Promise<SyncWriteDTO<ContentProgress, any> | null> {
   const introVideoStatus = await getProgressState(contentId)
 
   return introVideoStatus !== 'completed' ? await contentStatusCompleted(contentId) : null
 }
+
+export async function onContentCompletedLearningPathListener(event) {
+  console.log('if')
+  if (event?.collection?.type !== 'learning-path-v2') return
+  if (event.contentId !== event?.collection?.id) return
+  const learningPathId = event.contentId
+  const learningPath = await getEnrichedLearningPath(learningPathId)
+  console.log('LP', learningPath)
+  const brand = learningPath.brand
+  const activeLearningPath = await getActivePath(brand)
+  console.log('Active LP', activeLearningPath)
+  if (activeLearningPath.active_learning_path_id !== learningPathId) return
+  const method = await fetchMethodV2Structure(brand)
+  console.log('Method', method)
+  const currentIndex = method.learning_paths.findIndex((lp) => lp.id === learningPathId)
+  if (currentIndex === -1) {
+    return
+  }
+  const nextLearningPath = method.learning_paths[currentIndex + 1]
+  console.log('Next LP', nextLearningPath)
+  if (!nextLearningPath) {
+    return
+  }
+
+  await startLearningPath(brand, nextLearningPath.id)
+  const nextLearningPathData = await getEnrichedLearningPath(nextLearningPath.id)
+  console.log('Next LP Data', nextLearningPathData)
+  await contentStatusReset(nextLearningPathData.intro_video.id)
+}