musora-content-services 2.119.3 → 2.121.2

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 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.121.2](https://github.com/railroadmedia/musora-content-services/compare/v2.121.1...v2.121.2) (2026-01-20)
+
+### [2.121.1](https://github.com/railroadmedia/musora-content-services/compare/v2.121.0...v2.121.1) (2026-01-20)
+
+## [2.121.0](https://github.com/railroadmedia/musora-content-services/compare/v2.119.3...v2.121.0) (2026-01-20)
+
+
+### Features
+
+* add fetchLiveStreamData method ([aa9b704](https://github.com/railroadmedia/musora-content-services/commit/aa9b7046c7fc69e8b30c0f035577da62f8c5b5fd))
+* add vimeo_live_event_id to GROQ queries ([d4fff6f](https://github.com/railroadmedia/musora-content-services/commit/d4fff6f09ca62682f6cead7e43f6979a56b86e0a))
+* **TP-1060:** method data caching in mcs ([#701](https://github.com/railroadmedia/musora-content-services/issues/701)) ([25efc43](https://github.com/railroadmedia/musora-content-services/commit/25efc43b6c07172db2f20d51d5b79ac9fc204eef))
+* update brand endpoint ([#719](https://github.com/railroadmedia/musora-content-services/issues/719)) ([4938b61](https://github.com/railroadmedia/musora-content-services/commit/4938b61c8526e31194b284c6daf172764b7900ed))
+
+## [2.120.0](https://github.com/railroadmedia/musora-content-services/compare/v2.119.3...v2.120.0) (2026-01-19)
+
+
+### Features
+
+* add fetchLiveStreamData method ([aa9b704](https://github.com/railroadmedia/musora-content-services/commit/aa9b7046c7fc69e8b30c0f035577da62f8c5b5fd))
+* add vimeo_live_event_id to GROQ queries ([d4fff6f](https://github.com/railroadmedia/musora-content-services/commit/d4fff6f09ca62682f6cead7e43f6979a56b86e0a))
+* **TP-1060:** method data caching in mcs ([#701](https://github.com/railroadmedia/musora-content-services/issues/701)) ([25efc43](https://github.com/railroadmedia/musora-content-services/commit/25efc43b6c07172db2f20d51d5b79ac9fc204eef))
+
 ### [2.119.3](https://github.com/railroadmedia/musora-content-services/compare/v2.119.2...v2.119.3) (2026-01-14)
 
 

package/package.json

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

package/src/index.d.ts

@@ -226,6 +226,7 @@ import {
 	fetchComments,
 	fetchContentPageUserData,
 	fetchLikeCount,
+	fetchLiveStreamData,
 	fetchRecentUserActivities,
 	fetchTopComment,
 	fetchUserPermissionsData,
@@ -350,6 +351,7 @@ import {
 	setUserSignature,
 	toggleSignaturePrivate,
 	unblockUser,
+	updateBrand,
 	updateDisplayName,
 	uploadPicture,
 	uploadPictureFromS3
@@ -415,6 +417,7 @@ import {
 	getPracticeNotes,
 	getPracticeSessions,
 	getRecentActivity,
+	getStreaksAndMessage,
 	getUserMonthlyStats,
 	getUserWeeklyStats,
 	recordUserActivity,
@@ -523,6 +526,7 @@ declare module 'musora-content-services' {
 		fetchLikeCount,
 		fetchLiveEvent,
 		fetchLiveEventPollingState,
+		fetchLiveStreamData,
 		fetchMemberships,
 		fetchMetadata,
 		fetchMethodV2IntroVideo,
@@ -623,6 +627,7 @@ declare module 'musora-content-services' {
 		getSongTypesFor,
 		getSortOrder,
 		getStartedOrCompletedProgressOnly,
+		getStreaksAndMessage,
 		getTabResults,
 		getTimeRemainingUntilLocal,
 		getToday,
@@ -720,6 +725,7 @@ declare module 'musora-content-services' {
 		unlockThread,
 		unpinProgressRow,
 		unpinThread,
+		updateBrand,
 		updateDailySession,
 		updateDisplayName,
 		updateForumCategory,

package/src/index.js

@@ -230,6 +230,7 @@ import {
 	fetchComments,
 	fetchContentPageUserData,
 	fetchLikeCount,
+	fetchLiveStreamData,
 	fetchRecentUserActivities,
 	fetchTopComment,
 	fetchUserPermissionsData,
@@ -354,6 +355,7 @@ import {
 	setUserSignature,
 	toggleSignaturePrivate,
 	unblockUser,
+	updateBrand,
 	updateDisplayName,
 	uploadPicture,
 	uploadPictureFromS3
@@ -419,6 +421,7 @@ import {
 	getPracticeNotes,
 	getPracticeSessions,
 	getRecentActivity,
+	getStreaksAndMessage,
 	getUserMonthlyStats,
 	getUserWeeklyStats,
 	recordUserActivity,
@@ -522,6 +525,7 @@ export {
 	fetchLikeCount,
 	fetchLiveEvent,
 	fetchLiveEventPollingState,
+	fetchLiveStreamData,
 	fetchMemberships,
 	fetchMetadata,
 	fetchMethodV2IntroVideo,
@@ -622,6 +626,7 @@ export {
 	getSongTypesFor,
 	getSortOrder,
 	getStartedOrCompletedProgressOnly,
+	getStreaksAndMessage,
 	getTabResults,
 	getTimeRemainingUntilLocal,
 	getToday,
@@ -719,6 +724,7 @@ export {
 	unlockThread,
 	unpinProgressRow,
 	unpinThread,
+	updateBrand,
 	updateDailySession,
 	updateDisplayName,
 	updateForumCategory,

package/src/infrastructure/http/HttpClient.ts

@@ -7,6 +7,11 @@ import { DefaultHeaderProvider } from './providers/DefaultHeaderProvider'
 import { FetchRequestExecutor } from './executors/FetchRequestExecutor'
 import { globalConfig } from '../../services/config'
 
+type _RequestOptions = {
+  dataVersion?: string | null
+  cache?: RequestCache
+}
+
 export class HttpClient {
   private baseUrl: string
   private token: string | null
@@ -33,38 +38,38 @@ export class HttpClient {
     this.token = null;
   }
 
-  public async get<T>(url: string, dataVersion: string | null = null): Promise<T> {
-    return this.request<T>(url, 'GET', dataVersion)
+  public async get<T>(url: string, options: _RequestOptions = {}): Promise<T> {
+    return this.request<T>(url, 'GET', options)
   }
 
-  public async post<T>(url: string, data: any, dataVersion: string | null = null): Promise<T> {
-    return this.request<T>(url, 'POST', dataVersion, data)
+  public async post<T>(url: string, data: any, options: _RequestOptions = {}): Promise<T> {
+    return this.request<T>(url, 'POST', options, data)
   }
 
-  public async put<T>(url: string, data: any, dataVersion: string | null = null): Promise<T> {
-    return this.request<T>(url, 'PUT', dataVersion, data)
+  public async put<T>(url: string, data: any, options: _RequestOptions = {}): Promise<T> {
+    return this.request<T>(url, 'PUT', options, data)
   }
 
-  public async patch<T>(url: string, data: any, dataVersion: string | null = null): Promise<T> {
-    return this.request<T>(url, 'PATCH', dataVersion, data)
+  public async patch<T>(url: string, data: any, options: _RequestOptions = {}): Promise<T> {
+    return this.request<T>(url, 'PATCH', options, data)
   }
 
-  public async delete<T>(url: string, data: any = null, dataVersion: string | null = null): Promise<T> {
-    return this.request<T>(url, 'DELETE', dataVersion, data)
+  public async delete<T>(url: string, data: any = null, options: _RequestOptions = {}): Promise<T> {
+    return this.request<T>(url, 'DELETE', options, data)
   }
 
   private async request<T>(
     url: string,
     method: string,
-    dataVersion: string | null = null,
+    options: _RequestOptions = {},
     body: any = null
   ): Promise<T> {
     try {
-      const headers = this.buildHeaders(dataVersion)
-      const options = this.buildRequestOptions(method, headers, body)
+      const headers = this.buildHeaders(options.dataVersion)
+      const requestOptions = this.buildRequestOptions(method, headers, body, options.cache)
       const fullUrl = this.resolveUrl(url)
 
-      return await this.requestExecutor.execute<T>(fullUrl, options)
+      return await this.requestExecutor.execute<T>(fullUrl, requestOptions)
     } catch (error: any) {
       return this.handleError(error, url, method)
     }
@@ -90,7 +95,8 @@ export class HttpClient {
   private buildRequestOptions(
     method: string,
     headers: Record<string, string>,
-    body: any
+    body: any,
+    cache?: RequestCache | null
   ): RequestOptions {
     const options: RequestOptions = {
       method,
@@ -98,6 +104,10 @@ export class HttpClient {
       credentials: 'include',
     }
 
+    if (cache) {
+      options.cache = cache
+    }
+
     if (body) {
       const isFormData = typeof FormData !== 'undefined' && body instanceof FormData
       if (isFormData) {

package/src/infrastructure/http/interfaces/RequestOptions.ts

@@ -3,4 +3,5 @@ export interface RequestOptions {
   headers: Record<string, string>
   credentials?:  "omit" | "same-origin" | "include"
   body?: string
+  cache?: RequestCache
 }

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

@@ -16,11 +16,13 @@ import { COLLECTION_TYPE, STATE } from '../sync/models/ContentProgress'
 import { SyncWriteDTO } from '../sync'
 import { ContentProgress } from '../sync/models'
 import { CollectionParameter } from '../sync/repositories/content-progress'
-import { getToday } from "../dateUtils.js";
+import dayjs from 'dayjs'
 
 const BASE_PATH: string = `/api/content-org`
 const LEARNING_PATHS_PATH = `${BASE_PATH}/v1/user/learning-paths`
 const LEARNING_PATH_LESSON = 'learning-path-lesson-v2'
+let dailySessionPromise: Promise<DailySessionResponse> | null = null
+let activePathPromise: Promise<ActiveLearningPathResponse> | null = null
 
 interface ActiveLearningPathResponse {
   user_id: number
@@ -51,17 +53,20 @@ interface CollectionObject {
  * Gets today's daily session for the user.
  * If the daily session doesn't exist, it will be created.
  * @param brand
- * @param userDate
+ * @param userDate - local datetime. must have date and time - format 2025-10-31T13:45:00
+ * @param forceRefresh - force cache refresh
  */
-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}`
+export async function getDailySession(brand: string, userDate: Date, forceRefresh: boolean = false) {
+  const dateWithTimezone = formatLocalDateTime(userDate)
+  const url: string = `${LEARNING_PATHS_PATH}/daily-session/get?brand=${brand}&userDate=${encodeURIComponent(dateWithTimezone)}`
   try {
-    const response = await GET(url)
+    const response = await dataPromiseGET(url, forceRefresh) as DailySessionResponse
     if (!response) {
       return await updateDailySession(brand, userDate, false)
     }
+    dailySessionPromise = null // reset promise after successful fetch
     return response as DailySessionResponse
+
   } catch (error: any) {
     if (error.status === 204) {
       return await updateDailySession(brand, userDate, false)
@@ -81,20 +86,38 @@ export async function updateDailySession(
   userDate: Date,
   keepFirstLearningPath: boolean = false
 ) {
-  const stringDate = userDate.toISOString().split('T')[0]
+  const dateWithTimezone = formatLocalDateTime(userDate)
   const url: string = `${LEARNING_PATHS_PATH}/daily-session/create`
-  const body = { brand: brand, userDate: stringDate, keepFirstLearningPath: keepFirstLearningPath }
-  return (await POST(url, body)) as DailySessionResponse
+  const body = { brand: brand, userDate: dateWithTimezone, keepFirstLearningPath: keepFirstLearningPath }
+
+  const response = await POST(url, body) as DailySessionResponse
+
+  if (response) {
+    const urlGet: string = `${LEARNING_PATHS_PATH}/daily-session/get?brand=${brand}&userDate=${encodeURIComponent(dateWithTimezone)}`
+    dataPromiseGET(urlGet, true) // refresh cache
+  }
+
+  return response
+}
+
+function formatLocalDateTime(date: Date): string {
+  return dayjs(date).format('YYYY-MM-DD Z')
 }
 
 /**
  * Gets user's active learning path.
  * @param brand
+ * @param forceRefresh - force cache refresh
  */
-export async function getActivePath(brand: string) {
+export async function getActivePath(brand: string, forceRefresh: boolean = false) {
   const url: string = `${LEARNING_PATHS_PATH}/active-path/get?brand=${brand}`
-  return (await GET(url)) as ActiveLearningPathResponse
+
+  const response = await dataPromiseGET(url, forceRefresh) as ActiveLearningPathResponse
+  activePathPromise = null // reset promise after successful fetch
+
+  return response
 }
+
 /**
  * Sets a new learning path as the user's active learning path.
  * @param brand
@@ -103,7 +126,31 @@ 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 POST(url, body)) as ActiveLearningPathResponse
+
+  const response = await POST(url, body) as ActiveLearningPathResponse
+
+  // manual BE call to avoid recursive POST<->GET calls
+  if (response) {
+    const urlGet: string = `${LEARNING_PATHS_PATH}/active-path/get?brand=${brand}`
+    dataPromiseGET(urlGet, true) // refresh cache
+  }
+
+  return response
+}
+
+async function dataPromiseGET(url: string, forceRefresh: boolean): Promise<DailySessionResponse|ActiveLearningPathResponse> {
+  if (url.includes('daily-session')) {
+    if (!dailySessionPromise || forceRefresh) {
+      dailySessionPromise = GET(url, {cache: forceRefresh ? 'reload' : 'default'}) as Promise<DailySessionResponse>
+    }
+    return dailySessionPromise
+
+  } else if (url.includes('active-path')) {
+    if (!activePathPromise || forceRefresh) {
+      activePathPromise = GET(url, {cache: forceRefresh ? 'reload' : 'default'}) as Promise<ActiveLearningPathResponse>
+    }
+    return activePathPromise
+  }
 }
 
 /**
@@ -374,7 +421,7 @@ export async function completeMethodIntroVideo(
   const methodStructure = await fetchMethodV2Structure(brand)
 
   const firstLearningPathId = methodStructure.learning_paths[0].id
-  response.active_path_response = await methodIntroVideoCompleteActions(brand, firstLearningPathId, getToday())
+  response.active_path_response = await methodIntroVideoCompleteActions(brand, firstLearningPathId, new Date())
 
   response.intro_video_response = await completeIfNotCompleted(introVideoId)
 
@@ -428,7 +475,7 @@ export async function completeLearningPathIntroVideo(
     if (activePath.active_learning_path_id === learningPathId) {
       response.update_dailies_response = await updateDailySession(
         brand,
-        getToday(),
+        new Date(),
         true
       )
     }

package/src/services/contentProgress.js

@@ -4,7 +4,6 @@ import { COLLECTION_TYPE, STATE } from './sync/models/ContentProgress'
 import { trackUserPractice, findIncompleteLesson } from './userActivity'
 import { getNextLessonLessonParentTypes } from '../contentTypeConfig.js'
 import {getDailySession, onContentCompletedLearningPathActions} from "./content-org/learning-paths.ts";
-import {getToday} from "./dateUtils.js";
 import { fetchBrandsByContentIds } from './sanity.js'
 
 const STATE_STARTED = STATE.STARTED
@@ -37,7 +36,7 @@ export async function getNavigateToForMethod(data) {
   let navigateToData = {}
 
   const brand = data[0].content.brand || null
-  const dailySessionResponse = await getDailySession(brand, getToday())
+  const dailySessionResponse = await getDailySession(brand, new Date())
   const dailySession = dailySessionResponse?.daily_session || null
   const activeLearningPathId = dailySessionResponse?.active_learning_path_id || null
 

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

@@ -3,7 +3,6 @@
  */
 
 import { getActivePath, fetchLearningPathLessons } from '../../content-org/learning-paths'
-import { getToday } from '../../dateUtils.js'
 import { fetchMethodV2IntroVideo } from '../../sanity'
 import { getProgressState } from '../../contentProgress'
 import {COLLECTION_TYPE, STATE} from '../../sync/models/ContentProgress'
@@ -45,7 +44,7 @@ export async function getMethodCard(brand) {
     const learningPath = await fetchLearningPathLessons(
       activeLearningPath.active_learning_path_id,
       brand,
-      getToday()
+      new Date()
     )
 
     if (!learningPath) {

package/src/services/railcontent.js

@@ -37,6 +37,15 @@ export async function fetchLikeCount(contendId) {
   return await GET(url)
 }
 
+/**
+ * @param {number} contentId
+ * @returns {Promise<{hls_url: string|null, status: string, vimeo_event_id: string|null}>}
+ */
+export async function fetchLiveStreamData(contentId) {
+  const url = `/api/content/v1/live-events/${contentId}/stream`
+  return await GET(url)
+}
+
 export async function postPlaylistContentEngaged(playlistItemId) {
   const url = `/railtracker/v1/last-engaged/${playlistItemId}`
   return await POST(url, null)

package/src/services/sanity.js

@@ -964,6 +964,7 @@ export async function fetchLessonContent(railContentId, { addParent = false } =
         "live_event_start_time": live_event_start_time,
         "live_event_end_time": live_event_end_time,
         "live_event_stream_id": live_event_stream_id,
+        "vimeo_live_event_id": vimeo_live_event_id,
         "videoId": coalesce(live_event_stream_id, video.external_id),
         "live_event_is_global": live_global_event == true
       }
@@ -1194,6 +1195,7 @@ export async function fetchLiveEvent(brand, forcedContentId = null) {
       live_event_start_time,
       live_event_end_time,
       live_event_stream_id,
+      vimeo_live_event_id,
       railcontent_id,
       published_on,
       'event_coach_url' : instructor[0]->web_url_path,
@@ -1211,6 +1213,7 @@ export async function fetchLiveEvent(brand, forcedContentId = null) {
       live_event_start_time,
       live_event_end_time,
       live_event_stream_id,
+      vimeo_live_event_id,
       railcontent_id,
       published_on,
       'event_coach_url' : instructor[0]->web_url_path,

package/src/services/user/management.js

@@ -1,7 +1,7 @@
 /**
  * @module UserManagement
  */
-import { GET, POST, PUT, DELETE } from '../../infrastructure/http/HttpClient.ts'
+import { GET, POST, PUT, DELETE, PATCH } from '../../infrastructure/http/HttpClient.ts'
 import { globalConfig } from '../config.js'
 import './types.js'
 
@@ -131,5 +131,13 @@ export async function toggleSignaturePrivate(showSignature = true) {
   return await PUT(apiUrl, { show_signature: showSignature })
 }
 
-
-
+/**
+ * Updates the user's brand.
+ *
+ * @param {string} brand - The brand to assign to the user.
+ * @returns {Promise<{ brand: string }>} - A promise that resolves with the updated brand.
+ */
+export async function updateBrand(brand) {
+  const apiUrl = `/api/user-management-system/v1/user/brand`
+  return await PATCH(apiUrl, { brand })
+}

package/.claude/settings.local.json

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