musora-content-services 2.181.0 → 2.182.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 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.182.0](https://github.com/railroadmedia/musora-content-services/compare/v2.181.0...v2.182.0) (2026-09-21)
+
+
+### Features
+
+* **BEHLTP-368:** placement quiz endpoints ([#1051](https://github.com/railroadmedia/musora-content-services/issues/1051)) ([248b4c9](https://github.com/railroadmedia/musora-content-services/commit/248b4c9e48b056a651d44c129d5d0cb3ce80777d))
+* **BEHLTP-395:** add resetActiveLearningPath() ([#1055](https://github.com/railroadmedia/musora-content-services/issues/1055)) ([02df2df](https://github.com/railroadmedia/musora-content-services/commit/02df2dffd59844ff0c11a43f357efa6ed346a07f))
+
+
+### Bug Fixes
+
+* move learning-paths.ts to my-path/ module ([#1054](https://github.com/railroadmedia/musora-content-services/issues/1054)) ([49fb9a9](https://github.com/railroadmedia/musora-content-services/commit/49fb9a983512e1d657285ddd13555d5ae9cb8e7b))
+
 ## [2.181.0](https://github.com/railroadmedia/musora-content-services/compare/v2.180.0...v2.181.0) (2026-09-17)
 
 

package/jsdoc.json

@@ -6,6 +6,7 @@
       "src/services/content",
       "src/services/gamification",
       "src/services/multi-user-accounts",
+      "src/services/my-path",
       "src/services/awards",
       "src/services/api",
       "src/services/progress-row",

package/package.json

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

package/src/index.d.ts

@@ -21,6 +21,7 @@ import {
 	globalConfig,
 	initializeEnvVar,
 	initializeService,
+	setSessionUserData,
 	updateSessionConfig
 } from './services/config.js';
 
@@ -54,23 +55,6 @@ import {
 	unEnrollUserInGuidedCourse
 } from './services/content-org/guided-courses.ts';
 
-import {
-	completeLearningPathIntroVideo,
-	completeMethodIntroVideo,
-	fetchLearningPathLessons,
-	fetchLearningPathProgressCheckLessons,
-	getActivePath,
-	getDailySession,
-	getEnrichedLearningPath,
-	getEnrichedLearningPaths,
-	getLearningPathLessonsByIds,
-	isNextLessonLocked,
-	mapContentToParent,
-	resetAllLearningPaths,
-	startLearningPath,
-	updateDailySession
-} from './services/content-org/learning-paths.ts';
-
 import {
 	addItemToPlaylist,
 	createPlaylist,
@@ -244,6 +228,29 @@ import {
 	updateMultiUserAccount
 } from './services/multi-user-accounts/multi-user-accounts.ts';
 
+import {
+	completeLearningPathIntroVideo,
+	completeMethodIntroVideo,
+	fetchLearningPathLessons,
+	fetchLearningPathProgressCheckLessons,
+	getActivePath,
+	getDailySession,
+	getEnrichedLearningPath,
+	getEnrichedLearningPaths,
+	getLearningPathLessonsByIds,
+	isNextLessonLocked,
+	mapContentToParent,
+	resetActiveLearningPath,
+	resetAllLearningPaths,
+	startLearningPath,
+	updateDailySession
+} from './services/my-path/learning-paths.ts';
+
+import {
+	fetchQuizAnswers,
+	storeQuizAnswers
+} from './services/my-path/placement-quiz.ts';
+
 import {
 	deleteAllNotifications,
 	deleteNotification,
@@ -688,6 +695,7 @@ declare module 'musora-content-services' {
 		fetchPosts,
 		fetchPracticeGoals,
 		fetchPublicAnnouncement,
+		fetchQuizAnswers,
 		fetchRecent,
 		fetchRecentActivitiesActiveTabs,
 		fetchRecentUserActivities,
@@ -863,6 +871,7 @@ declare module 'musora-content-services' {
 		requestEmailChange,
 		rescindInvite,
 		reset,
+		resetActiveLearningPath,
 		resetAllAwards,
 		resetAllLearningPaths,
 		resetPassword,
@@ -878,6 +887,7 @@ declare module 'musora-content-services' {
 		sendAccountSetupEmail,
 		sendPasswordResetEmail,
 		sendRevenueCatPurchaseMetadata,
+		setSessionUserData,
 		setStudentViewForUser,
 		setUserPinnedProgressRow,
 		setUserSignature,
@@ -886,6 +896,7 @@ declare module 'musora-content-services' {
 		startLiveEventPolling,
 		startOnboarding,
 		status,
+		storeQuizAnswers,
 		toDayjs,
 		toLocalDay,
 		togglePlaylistPrivate,

package/src/index.js

@@ -25,6 +25,7 @@ import {
 	globalConfig,
 	initializeEnvVar,
 	initializeService,
+	setSessionUserData,
 	updateSessionConfig
 } from './services/config.js';
 
@@ -58,23 +59,6 @@ import {
 	unEnrollUserInGuidedCourse
 } from './services/content-org/guided-courses.ts';
 
-import {
-	completeLearningPathIntroVideo,
-	completeMethodIntroVideo,
-	fetchLearningPathLessons,
-	fetchLearningPathProgressCheckLessons,
-	getActivePath,
-	getDailySession,
-	getEnrichedLearningPath,
-	getEnrichedLearningPaths,
-	getLearningPathLessonsByIds,
-	isNextLessonLocked,
-	mapContentToParent,
-	resetAllLearningPaths,
-	startLearningPath,
-	updateDailySession
-} from './services/content-org/learning-paths.ts';
-
 import {
 	addItemToPlaylist,
 	createPlaylist,
@@ -248,6 +232,29 @@ import {
 	updateMultiUserAccount
 } from './services/multi-user-accounts/multi-user-accounts.ts';
 
+import {
+	completeLearningPathIntroVideo,
+	completeMethodIntroVideo,
+	fetchLearningPathLessons,
+	fetchLearningPathProgressCheckLessons,
+	getActivePath,
+	getDailySession,
+	getEnrichedLearningPath,
+	getEnrichedLearningPaths,
+	getLearningPathLessonsByIds,
+	isNextLessonLocked,
+	mapContentToParent,
+	resetActiveLearningPath,
+	resetAllLearningPaths,
+	startLearningPath,
+	updateDailySession
+} from './services/my-path/learning-paths.ts';
+
+import {
+	fetchQuizAnswers,
+	storeQuizAnswers
+} from './services/my-path/placement-quiz.ts';
+
 import {
 	deleteAllNotifications,
 	deleteNotification,
@@ -687,6 +694,7 @@ export {
 	fetchPosts,
 	fetchPracticeGoals,
 	fetchPublicAnnouncement,
+	fetchQuizAnswers,
 	fetchRecent,
 	fetchRecentActivitiesActiveTabs,
 	fetchRecentUserActivities,
@@ -862,6 +870,7 @@ export {
 	requestEmailChange,
 	rescindInvite,
 	reset,
+	resetActiveLearningPath,
 	resetAllAwards,
 	resetAllLearningPaths,
 	resetPassword,
@@ -877,6 +886,7 @@ export {
 	sendAccountSetupEmail,
 	sendPasswordResetEmail,
 	sendRevenueCatPurchaseMetadata,
+	setSessionUserData,
 	setStudentViewForUser,
 	setUserPinnedProgressRow,
 	setUserSignature,
@@ -885,6 +895,7 @@ export {
 	startLiveEventPolling,
 	startOnboarding,
 	status,
+	storeQuizAnswers,
 	toDayjs,
 	toLocalDay,
 	togglePlaylistPrivate,

package/src/services/contentProgress.js

@@ -3,7 +3,7 @@ import { db } from './sync'
 import { COLLECTION_ID_SELF, COLLECTION_TYPE, STATE } from './sync/models/ContentProgress'
 import { trackUserPractice } from './userActivity'
 import { getNextLessonLessonParentTypes } from '../contentTypeConfig.js'
-import { getDailySession, onLearningPathCompletedActions } from './content-org/learning-paths.ts'
+import { getDailySession, onLearningPathCompletedActions } from './my-path/learning-paths.ts'
 import { duplicateProgressToALaCarteOffline } from './offline/progress.ts'
 
 /**

package/src/services/my-path/dev/map-types.ts

@@ -0,0 +1,123 @@
+
+
+type ContentId = number
+type Branch = "essentials" | "classical" | "blues"
+
+interface LearningPath {
+  id: ContentId
+  thumbnail?: string
+  title: string
+  difficulty?: number
+  branch: Branch
+  intro_video_id?: number // only if we have intro videos
+  published_on?: string
+  // ... any other content-related fields we need
+}
+
+interface Connection {
+  id: string // `${source}:${target}`, stable key
+  source: ContentId // prerequisite LP
+  target: ContentId // up_next LP
+  branch: Branch // which branch this connection belongs to
+}
+
+interface BranchIndex {
+  node_ids: ContentId[]
+  edge_ids: string[]
+}
+
+interface CanonicalMapData {
+  nodes: Record<ContentId, LearningPath>
+  edges: Connection[]
+  branches: Record<Branch, BranchIndex>
+}
+
+// example CanonicalMapData:
+const exampleCurriculumMap: CanonicalMapData = {
+   "nodes": {
+     "1": { "id": 1, "title": "Essentials 1", "branch": "essentials" },
+     "2": { "id": 2, "title": "Essentials 2", "branch": "essentials" },
+     "3": { "id": 3, "title": "Essentials 3", "branch": "essentials" },
+     "4": { "id": 4, "title": "Classical 1", "branch": "classical" },
+     "5": { "id": 5, "title": "Classical 2", "branch": "classical" },
+     "6": { "id": 6, "title": "Classical 3", "branch": "classical" },
+     "7": { "id": 7, "title": "Blues 1", "branch": "blues" },
+     "8": { "id": 8, "title": "Blues 2", "branch": "blues" },
+     "9": { "id": 9, "title": "Blues 3", "branch": "blues" },
+   },
+   "edges": [
+     { "id": "1-2", "source": 1, "target": 2, "branch": "essentials" },
+     { "id": "2-3", "source": 2, "target": 3, "branch": "essentials" },
+     { "id": "3-4", "source": 3, "target": 4, "branch": "classical" },
+     { "id": "4-5", "source": 4, "target": 5, "branch": "classical" },
+     { "id": "5-6", "source": 5, "target": 6, "branch": "classical" },
+     { "id": "3-7", "source": 3, "target": 7, "branch": "blues" },
+     { "id": "7-8", "source": 7, "target": 8, "branch": "blues" },
+     { "id": "8-9", "source": 8, "target": 9, "branch": "blues" },
+   ],
+   "branches": {
+     "essentials": {
+       "node_ids": [1, 2, 3],
+       "edge_ids": ["1-2", "2-3"],
+     },
+     "classical": {
+       "node_ids": [4, 5, 6],
+       "edge_ids": ["3-4", "4-5", "5-6"],
+     },
+     "blues": {
+       "node_ids": [7, 8, 9],
+       "edge_ids": ["3-7", "7-8", "8-9"],
+     },
+   }
+ }
+
+
+const exampleSongSelectionDTO =
+  [
+    {
+      learning_path_id: 8,
+      song_id: 101,
+      song_title: "Fur Elise",
+      song_artist: "Beethoven",
+      song_difficulty: 3,
+      song_thumbnail: "https://example.com/fur_elise_thumbnail.jpg",
+      song_preview: "https://example.com/fur_elise_preview.mp3"
+    },
+  //   ... more song selections
+  ]
+
+const myPathMap = [
+  "path-node-1",
+  "path-node-2",
+  // ... more path nodes
+]
+
+const pathNode = {
+  "_id": "path-node-1",
+  "name": "Learning Path 1",
+  "pathStreamArray": [
+    {
+      "lpReferences": [
+        "LP1" // learning path 1
+      ],
+      "isInABTest": true,
+      "specificInstrument": "all"
+    },
+    {
+      "lpReferences": [
+        "LP1.1", // LP1 split into 2 smaller LPs
+        "LP1.2"
+      ],
+      "isInABTest": true,
+      "specificInstrument": "all"
+    },
+    {
+      "lpReferences": [
+        "LP1_pad-only" // a pad-only version of LP1
+      ],
+      "isInABTest": false,
+      "specificInstrument": "pad" // matches Placement Quiz instrument options
+    }
+  ]
+}
+

package/src/services/{content-org → my-path}/learning-paths.ts

@@ -18,7 +18,8 @@ import {
   contentStatusReset,
   getAllCompletedByIds,
   getIdsWhereLastAccessedFromMethod,
-  getProgressState,
+  getProgressState, 
+  resetStatus,
 } from '../contentProgress.js'
 import { COLLECTION_ID_SELF, COLLECTION_TYPE, CollectionParameter, STATE } from '../sync/models/ContentProgress'
 import { db, SyncWriteDTO } from '../sync'
@@ -94,7 +95,7 @@ interface CollectionObject {
  * @param brand
  * @param userDate - local datetime. must have date and time - format 2025-10-31T13:45:00
  */
-export async function getDailySession(brand: string, userDate: Date) {
+export async function getDailySession(brand: string, userDate: Date): Promise<DailySessionResponse | '' | null> {
   const dateWithTimezone = formatLocalDateTime(userDate)
   const key = dailySessionKey(brand, dateWithTimezone)
 
@@ -102,13 +103,13 @@ export async function getDailySession(brand: string, userDate: Date) {
     return await dataPromiseGET(dailySessionPromises, key, async () => {
       const url = `${LEARNING_PATHS_PATH}/daily-session/get?brand=${brand}&userDate=${encodeURIComponent(dateWithTimezone)}`
 
-      const response = await GET(url) as DailySessionResponse | ''
+      const response = await GET(url)
 
       if (!response) {
         return await updateDailySession(brand, userDate, false)
       }
-      return response as DailySessionResponse
-    })
+      return response
+    }) as DailySessionResponse | ''
   } catch (error) {
     console.error('Error fetching daily session:', (error as any).message)
     return null
@@ -125,7 +126,7 @@ export async function updateDailySession(
   brand: string,
   userDate: Date,
   keepFirstLearningPath: boolean = false,
-) {
+): Promise<DailySessionResponse | null> {
   const dateWithTimezone = formatLocalDateTime(userDate)
   const key = dailySessionKey(brand, dateWithTimezone)
   const url: string = `${LEARNING_PATHS_PATH}/daily-session/create`
@@ -155,7 +156,7 @@ function formatLocalDateTime(date: Date): string {
  * Gets user's active learning path.
  * @param brand
  */
-export async function getActivePath(brand: string) {
+export async function getActivePath(brand: string): Promise<ActiveLearningPathResponse | null> {
   const url: string = `${LEARNING_PATHS_PATH}/active-path/get?brand=${brand}`
 
   return (await dataPromiseGET(activePathPromises, activePathKey(brand), () =>
@@ -168,7 +169,7 @@ export async function getActivePath(brand: string) {
  * @param brand
  * @param learningPathId
  */
-export async function startLearningPath(brand: string, learningPathId: number) {
+export async function startLearningPath(brand: string, learningPathId: number): Promise<ActiveLearningPathResponse | null> {
   const url: string = `${LEARNING_PATHS_PATH}/active-path/set`
   const body = { brand: brand, learning_path_id: learningPathId }
 
@@ -185,6 +186,19 @@ export async function startLearningPath(brand: string, learningPathId: number) {
   return response
 }
 
+/*
+  * Resets the user's active learning path and updates the daily session.
+  * @param {string} brand
+  * @param {number} learningPathId - The ID of the active learning path to reset.
+  * @param {Date} userDate - The user's local date.
+  * @returns {Promise<DailySessionResponse | '' | null>} - The updated daily session response or null if an error occurs.
+ */
+export async function resetActiveLearningPath(brand: string, learningPathId: number, userDate: Date): Promise<DailySessionResponse | '' | null> {
+  const collection: CollectionObject = { id: learningPathId, type: COLLECTION_TYPE.LEARNING_PATH }
+  await resetStatus(learningPathId, collection)
+  return await updateDailySession(brand, userDate)
+}
+
 function dataPromiseGET<T>(
   cache: Map<string, Promise<T>>,
   key: string,

package/src/services/my-path/placement-quiz.ts

@@ -0,0 +1,57 @@
+/**
+ * @module MyPathPlacementQuiz
+ */
+import { HttpClient } from '../../infrastructure/http/HttpClient'
+import { globalConfig } from '../config.js'
+import { OnboardingRecommendedContent } from '@/services/user/onboarding'
+
+
+const baseUrl = `/api/my-path/v1/placement-quiz`
+
+interface PlacementQuizAnswers {
+  skill_level: 'new' | 'beginner' | 'intermediate' | 'advanced' | 'expert'
+  genres: string[]
+  gear: string[]
+}
+
+interface PlacementQuizResponse {
+  user_id: string
+  brand: string
+  answers: PlacementQuizAnswers
+}
+
+interface StorePlacementQuizResponse {
+  placement_quiz: PlacementQuizResponse
+  recommended_content: OnboardingRecommendedContent
+  error?: any
+}
+
+/**
+ * Fetches the placement quiz answers from the API.
+ *
+ * @param brand
+ * @returns {Promise<PlacementQuizResponse>} - A promise that resolves to the placement quiz answers.
+ * @throws {HttpError} - If the HTTP request fails.
+ */
+export async function fetchQuizAnswers(brand: string): Promise<PlacementQuizResponse> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.get<PlacementQuizResponse>(`${baseUrl}?brand=${brand}`)
+}
+
+/**
+ * Stores the placement quiz answers to the API.
+ *
+ * @param brand
+ * @param answers
+ * @returns {Promise<PlacementQuizResponse>} - A promise that resolves to the stored placement quiz answers.
+ * @throws {HttpError} - If the HTTP request fails.
+ */
+export async function storeQuizAnswers(brand: string, answers: PlacementQuizAnswers): Promise<StorePlacementQuizResponse> {
+  const body = {
+    brand,
+    answers,
+  }
+
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.post<StorePlacementQuizResponse>(baseUrl, body)
+}

package/src/services/progress/mutations.ts

@@ -5,7 +5,7 @@ import {
   CollectionParameter,
 } from '../sync/models/ContentProgress'
 import { getHierarchies, getHierarchy } from '../sanity.js'
-import { onLearningPathCompletedActions } from '../content-org/learning-paths'
+import { onLearningPathCompletedActions } from '../my-path/learning-paths'
 import { duplicateProgressToALaCarteOffline } from '../offline/progress'
 import {
   bubbleAndTrickleProgressesSafely,

package/src/services/progress-row/rows/method-card.js

@@ -2,7 +2,7 @@
  * @module ProgressRow
  */
 
-import { getActivePath, fetchLearningPathLessons } from '../../content-org/learning-paths'
+import { getActivePath, fetchLearningPathLessons } from '../../my-path/learning-paths.ts'
 import { fetchMethodV2IntroVideo } from '../../sanity'
 import { getProgressState } from '../../contentProgress'
 import { COLLECTION_TYPE, STATE } from '../../sync/models/ContentProgress'

package/src/services/userActivity.js

@@ -13,7 +13,7 @@ import dayjs from 'dayjs'
 import { addContextToContent } from './contentAggregator.js'
 import { db, Q } from './sync'
 import { streakCalculator } from './user/streakCalculator'
-import { mapContentsThatWereLastProgressedFromMethod } from "./content-org/learning-paths.ts";
+import { mapContentsThatWereLastProgressedFromMethod } from "./my-path/learning-paths.ts";
 
 const DAYS = ['M', 'T', 'W', 'T', 'F', 'S', 'S']
 

package/src/version-info.js

@@ -1 +1 @@
-export const MCS_VERSION = '2.181.0'
+export const MCS_VERSION = '2.182.0'