musora-content-services 2.3.20 → 2.3.22

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.3.22](https://github.com/railroadmedia/musora-content-services/compare/v2.3.21...v2.3.22) (2025-05-05)
+
+### [2.3.21](https://github.com/railroadmedia/musora-content-services/compare/v2.3.20...v2.3.21) (2025-05-02)
+
 ### [2.3.20](https://github.com/railroadmedia/musora-content-services/compare/v2.3.19...v2.3.20) (2025-04-30)
 
 ### [2.3.19](https://github.com/railroadmedia/musora-content-services/compare/v2.3.18...v2.3.19) (2025-04-30)

package/package.json

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

package/src/index.d.ts

@@ -9,6 +9,8 @@ import {
 	addItemToPlaylist,
 	createPlaylist,
 	duplicatePlaylist,
+	fetchPlaylist,
+	fetchPlaylistItems,
 	fetchUserPlaylists,
 	likePlaylist,
 	reorderPlaylistItems,
@@ -51,6 +53,10 @@ import {
 	recordWatchSession
 } from './services/contentProgress.js';
 
+import {
+  addContextToContent
+} from './contentAggregator.js';
+
 import {
 	verifyLocalDataContext
 } from './services/dataContext.js';
@@ -213,6 +219,7 @@ import {
 } from './services/user/sessions.js';
 
 import {
+	calculateLongestStreaks,
 	createPracticeNotes,
 	deletePracticeSession,
 	getPracticeNotes,
@@ -231,6 +238,7 @@ import {
 declare module 'musora-content-services' {
 	export {
 		addItemToPlaylist,
+    addContextToContent,
 		applyCloudflareWrapper,
 		applySanityTransformations,
 		assignModeratorToComment,
@@ -238,6 +246,7 @@ declare module 'musora-content-services' {
 		assignmentStatusReset,
 		blockUser,
 		buildImageSRC,
+		calculateLongestStreaks,
 		closeComment,
 		contentStatusCompleted,
 		contentStatusReset,
@@ -300,6 +309,8 @@ declare module 'musora-content-services' {
 		fetchPackData,
 		fetchParentForDownload,
 		fetchPlayAlongsCount,
+		fetchPlaylist,
+		fetchPlaylistItems,
 		fetchRecent,
 		fetchRelatedLessons,
 		fetchRelatedRecommendedContent,

package/src/index.js

@@ -9,6 +9,8 @@ import {
 	addItemToPlaylist,
 	createPlaylist,
 	duplicatePlaylist,
+	fetchPlaylist,
+	fetchPlaylistItems,
 	fetchUserPlaylists,
 	likePlaylist,
 	reorderPlaylistItems,
@@ -82,6 +84,9 @@ import {
 	isBucketUrl,
 	verifyImageSRC
 } from './services/imageSRCVerify.js';
+import {
+  addContextToContent
+} from './contentAggregator.js';
 
 import {
 	assignModeratorToComment,
@@ -213,6 +218,7 @@ import {
 } from './services/user/sessions.js';
 
 import {
+	calculateLongestStreaks,
 	createPracticeNotes,
 	deletePracticeSession,
 	getPracticeNotes,
@@ -237,6 +243,7 @@ export {
 	assignmentStatusReset,
 	blockUser,
 	buildImageSRC,
+	calculateLongestStreaks,
 	closeComment,
 	contentStatusCompleted,
 	contentStatusReset,
@@ -299,6 +306,8 @@ export {
 	fetchPackData,
 	fetchParentForDownload,
 	fetchPlayAlongsCount,
+	fetchPlaylist,
+	fetchPlaylistItems,
 	fetchRecent,
 	fetchRelatedLessons,
 	fetchRelatedRecommendedContent,
@@ -403,4 +412,5 @@ export {
 	updateUserPractice,
 	verifyImageSRC,
 	verifyLocalDataContext,
+  addContextToContent
 };

package/src/services/content-org/playlists.js

@@ -254,6 +254,47 @@ export async function duplicatePlaylist(playlistId, playlistData) {
   return await fetchHandler(url, 'POST', null, playlistData)
 }
 
+/**
+ * Retrieves details of a specific playlist by its ID.
+ *
+ * This function sends a GET request to the `/playlists/playlist` endpoint with a specified playlist ID.
+ * The server validates the user's access to the playlist and returns playlist details if the user is authorized.
+ *
+ * @param {string|number} playlistId - The unique identifier of the playlist to retrieve.
+ *
+ * @returns {Promise<Object>} - A promise that resolves to the response from the API, containing:
+ *  - `data` (Object): The playlist details, or an error message if access is denied or the playlist is not found.
+ *
+ * @example
+ * fetchPlaylist(12345)
+ *   .then(response => console.log(response.data))
+ *   .catch(error => console.error('Error fetching playlist:', error));
+ */
+export async function fetchPlaylist(playlistId) {
+  const url = `${BASE_PATH}/v1/user/playlists/${playlistId}`
+  return await fetchHandler(url, 'GET')
+}
+
+/**
+ * Retrieves items within a specified playlist by playlist ID.
+ *
+ * This function sends a GET request to the `/playlists/playlist-lessons` endpoint to fetch items in the given playlist.
+ * The server combines data from the playlist and additional metadata from Sanity to enhance item details.
+ *
+ * @param {string|number} playlistId - The unique identifier of the playlist whose items are to be fetched.
+ *
+ * @returns {Promise<Array<Object>>} - A promise that resolves to an array of playlist items
+ *
+ * @example
+ * fetchPlaylistItems(12345)
+ *   .then(items => console.log(items))
+ *   .catch(error => console.error('Error fetching playlist items:', error));
+ */
+export async function fetchPlaylistItems(playlistId) {
+  const url = `${BASE_PATH}/v1/user/playlists/items/${playlistId}`
+  return await fetchHandler(url, 'GET')
+}
+
 // Unsupported playlist endpoints are here and will need to be implemented one by one
 //
 //
@@ -321,47 +362,6 @@ export async function duplicatePlaylist(playlistId, playlistData) {
 // }
 //
 //
-// /**
-//  * Retrieves details of a specific playlist by its ID.
-//  *
-//  * This function sends a GET request to the `/playlists/playlist` endpoint with a specified playlist ID.
-//  * The server validates the user's access to the playlist and returns playlist details if the user is authorized.
-//  *
-//  * @param {string|number} playlistId - The unique identifier of the playlist to retrieve.
-//  *
-//  * @returns {Promise<Object>} - A promise that resolves to the response from the API, containing:
-//  *  - `data` (Object): The playlist details, or an error message if access is denied or the playlist is not found.
-//  *
-//  * @example
-//  * fetchPlaylist(12345)
-//  *   .then(response => console.log(response.data))
-//  *   .catch(error => console.error('Error fetching playlist:', error));
-//  */
-// export async function fetchPlaylist(playlistId) {
-//   const url = `/playlists/playlist/${playlistId}`
-//   return await fetchHandler(url, 'GET')
-// }
-//
-// /**
-//  * Retrieves items within a specified playlist by playlist ID.
-//  *
-//  * This function sends a GET request to the `/playlists/playlist-lessons` endpoint to fetch items in the given playlist.
-//  * The server combines data from the playlist and additional metadata from Sanity to enhance item details.
-//  *
-//  * @param {string|number} playlistId - The unique identifier of the playlist whose items are to be fetched.
-//  *
-//  * @returns {Promise<Array<Object>>} - A promise that resolves to an array of playlist items
-//  *
-//  * @example
-//  * fetchPlaylistItems(12345)
-//  *   .then(items => console.log(items))
-//  *   .catch(error => console.error('Error fetching playlist items:', error));
-//  */
-// export async function fetchPlaylistItems(playlistId, { sort } = {}) {
-//   const sortString = sort ? `&sort=${sort}` : ''
-//   const url = `/playlists/playlist-lessons?playlist_id=${playlistId}${sortString}`
-//   return await fetchHandler(url, 'GET')
-// }
 //
 // /**
 //  * Updates a playlist item with the provided data.

package/src/services/railcontent.js

@@ -290,6 +290,10 @@ async function patchDataHandler(url, data) {
   return fetchHandler(url, 'patch', null, data)
 }
 
+async function putDataHandler(url, data) {
+  return fetchHandler(url, 'put', null, data)
+}
+
 async function deleteDataHandler(url, data) {
   return fetchHandler(url, 'delete')
 }
@@ -726,7 +730,7 @@ export async function editComment(commentId, comment) {
   const data = {
     comment: comment,
   }
-  return await patchDataHandler(url, data)
+  return await putDataHandler(url, data)
 }
 
 /**

package/src/services/userActivity.js

@@ -688,6 +688,87 @@ function calculateStreaks(practices, includeStreakMessage = false) {
   return { currentDailyStreak, currentWeeklyStreak, streakMessage };
 }
 
+/**
+ * Calculates the longest daily, weekly streaks and totalPracticeSeconds from user practice dates.
+ * @returns {{ longestDailyStreak: number, longestWeeklyStreak: number, totalPracticeSeconds:number }}
+ */
+export async function calculateLongestStreaks() {
+  let data = await userActivityContext.getData()
+  let practices = data?.[DATA_KEY_PRACTICES] ?? {}
+  let totalPracticeSeconds = 0;
+  // Calculate total practice duration
+  for (const date in practices) {
+    for (const entry of practices[date]) {
+      totalPracticeSeconds += entry.duration_seconds;
+    }
+  }
+
+  let practiceDates = Object.keys(practices)
+    .map(dateStr => {
+      const [y, m, d] = dateStr.split('-').map(Number);
+      const newDate = new Date();
+      newDate.setFullYear(y, m - 1, d);
+      return newDate;
+    })
+    .sort((a, b) => a - b);
+
+  if (!practiceDates || practiceDates.length === 0) {
+    return {longestDailyStreak: 0, longestWeeklyStreak: 0, totalPracticeSeconds: 0};
+  }
+
+  // Normalize to Date objects
+  const normalizedDates = [
+    ...new Set(practiceDates.map(d => {
+      const date = new Date(d);
+      date.setHours(0, 0, 0, 0);
+      return date.getTime();
+    }))
+  ].sort((a, b) => a - b);
+
+  // ----- Daily Streak -----
+  let longestDailyStreak = 1;
+  let currentDailyStreak = 1;
+  for (let i = 1; i < normalizedDates.length; i++) {
+    const diffInDays = (normalizedDates[i] - normalizedDates[i - 1]) / (1000 * 60 * 60 * 24);
+    if (diffInDays === 1) {
+      currentDailyStreak++;
+      longestDailyStreak = Math.max(longestDailyStreak, currentDailyStreak);
+    } else {
+      currentDailyStreak = 1;
+    }
+  }
+
+  // ----- Weekly Streak -----
+  const weekStartDates = [
+    ...new Set(normalizedDates.map(ts => {
+      const d = new Date(ts);
+      const day = d.getDay();
+      const diff = d.getDate() - day + (day === 0 ? -6 : 1); // adjust to Monday
+      d.setDate(diff);
+      return d.getTime(); // timestamp for Monday
+    }))
+  ].sort((a, b) => a - b);
+
+  let longestWeeklyStreak = 1;
+  let currentWeeklyStreak = 1;
+
+  for (let i = 1; i < weekStartDates.length; i++) {
+    const diffInWeeks = (weekStartDates[i] - weekStartDates[i - 1]) / (1000 * 60 * 60 * 24 * 7);
+    if (diffInWeeks === 1) {
+      currentWeeklyStreak++;
+      longestWeeklyStreak = Math.max(longestWeeklyStreak, currentWeeklyStreak);
+    } else {
+      currentWeeklyStreak = 1;
+    }
+  }
+
+  return {
+    longestDailyStreak,
+    longestWeeklyStreak,
+    totalPracticeSeconds
+  };
+}
+