musora-content-services 1.3.14 → 1.3.16

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.
 
+### [1.3.16](https://github.com/railroadmedia/musora-content-services/compare/v1.3.15...v1.3.16) (2025-03-14)
+
+### [1.3.15](https://github.com/railroadmedia/musora-content-services/compare/v1.3.14...v1.3.15) (2025-03-10)
+
 ### [1.3.14](https://github.com/railroadmedia/musora-content-services/compare/v1.3.13...v1.3.14) (2025-03-06)
 
 ### [1.3.13](https://github.com/railroadmedia/musora-content-services/compare/v1.3.12...v1.3.13) (2025-03-06)

package/package.json

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

package/src/index.d.ts

@@ -38,18 +38,25 @@ import {
 
 import {
 	addItemToPlaylist,
+	assignModeratorToComment,
+	closeComment,
 	countAssignmentsAndLessons,
+	createComment,
 	createPlaylist,
+	deleteComment,
 	deletePlaylist,
 	deletePlaylistItem,
 	deletePlaylistLike,
 	duplicatePlaylist,
+	editComment,
 	fetchAllCompletedStates,
 	fetchCarouselCardData,
 	fetchChallengeIndexMetadata,
 	fetchChallengeLessonData,
 	fetchChallengeMetadata,
 	fetchChallengeUserActiveChallenges,
+	fetchCommentRelies,
+	fetchComments,
 	fetchCompletedChallenges,
 	fetchCompletedContent,
 	fetchCompletedState,
@@ -64,13 +71,16 @@ import {
 	fetchPlaylistItem,
 	fetchPlaylistItems,
 	fetchSongsInProgress,
+	fetchTopComment,
 	fetchUserAward,
 	fetchUserBadges,
 	fetchUserChallengeProgress,
 	fetchUserLikes,
 	fetchUserPermissionsData,
 	fetchUserPlaylists,
+	likeComment,
 	likePlaylist,
+	openComment,
 	pinPlaylist,
 	playback,
 	postChallengesCommunityNotification,
@@ -87,13 +97,22 @@ import {
 	postContentReset,
 	postContentUnliked,
 	postRecordWatchSession,
+	replyToComment,
 	reportPlaylist,
 	setStudentViewForUser,
+	unassignModeratorToComment,
+	unlikeComment,
 	unpinPlaylist,
 	updatePlaylist,
 	updatePlaylistItem
 } from './services/railcontent.js';
 
+import {
+	rankCategories,
+	rankItems,
+	similarItems
+} from './services/recommendations.js';
+
 import {
 	fetchAll,
 	fetchAllFilterOptions,
@@ -146,16 +165,21 @@ import {
 declare module 'musora-content-services' {
 	export {
 		addItemToPlaylist,
+		assignModeratorToComment,
 		assignmentStatusCompleted,
 		assignmentStatusReset,
+		closeComment,
 		contentStatusCompleted,
 		contentStatusReset,
 		countAssignmentsAndLessons,
+		createComment,
 		createPlaylist,
+		deleteComment,
 		deletePlaylist,
 		deletePlaylistItem,
 		deletePlaylistLike,
 		duplicatePlaylist,
+		editComment,
 		fetchAll,
 		fetchAllCompletedStates,
 		fetchAllFilterOptions,
@@ -174,6 +198,8 @@ declare module 'musora-content-services' {
 		fetchCoachLessons,
 		fetchComingSoon,
 		fetchCommentModContentData,
+		fetchCommentRelies,
+		fetchComments,
 		fetchCompletedChallenges,
 		fetchCompletedContent,
 		fetchCompletedState,
@@ -213,6 +239,7 @@ declare module 'musora-content-services' {
 		fetchSongArtistCount,
 		fetchSongById,
 		fetchSongsInProgress,
+		fetchTopComment,
 		fetchTopLevelParentId,
 		fetchUpcomingEvents,
 		fetchUserAward,
@@ -235,8 +262,10 @@ declare module 'musora-content-services' {
 		initializeService,
 		isContentLiked,
 		jumpToContinueContent,
+		likeComment,
 		likeContent,
 		likePlaylist,
+		openComment,
 		pinPlaylist,
 		playback,
 		postChallengesCommunityNotification,
@@ -253,11 +282,17 @@ declare module 'musora-content-services' {
 		postContentReset,
 		postContentUnliked,
 		postRecordWatchSession,
+		rankCategories,
+		rankItems,
 		recordWatchSession,
+		replyToComment,
 		reportPlaylist,
 		reset,
 		setLastUpdatedTime,
 		setStudentViewForUser,
+		similarItems,
+		unassignModeratorToComment,
+		unlikeComment,
 		unlikeContent,
 		unpinPlaylist,
 		updatePlaylist,

package/src/index.js

@@ -38,18 +38,25 @@ import {
 
 import {
 	addItemToPlaylist,
+	assignModeratorToComment,
+	closeComment,
 	countAssignmentsAndLessons,
+	createComment,
 	createPlaylist,
+	deleteComment,
 	deletePlaylist,
 	deletePlaylistItem,
 	deletePlaylistLike,
 	duplicatePlaylist,
+	editComment,
 	fetchAllCompletedStates,
 	fetchCarouselCardData,
 	fetchChallengeIndexMetadata,
 	fetchChallengeLessonData,
 	fetchChallengeMetadata,
 	fetchChallengeUserActiveChallenges,
+	fetchCommentRelies,
+	fetchComments,
 	fetchCompletedChallenges,
 	fetchCompletedContent,
 	fetchCompletedState,
@@ -64,13 +71,16 @@ import {
 	fetchPlaylistItem,
 	fetchPlaylistItems,
 	fetchSongsInProgress,
+	fetchTopComment,
 	fetchUserAward,
 	fetchUserBadges,
 	fetchUserChallengeProgress,
 	fetchUserLikes,
 	fetchUserPermissionsData,
 	fetchUserPlaylists,
+	likeComment,
 	likePlaylist,
+	openComment,
 	pinPlaylist,
 	playback,
 	postChallengesCommunityNotification,
@@ -87,13 +97,22 @@ import {
 	postContentReset,
 	postContentUnliked,
 	postRecordWatchSession,
+	replyToComment,
 	reportPlaylist,
 	setStudentViewForUser,
+	unassignModeratorToComment,
+	unlikeComment,
 	unpinPlaylist,
 	updatePlaylist,
 	updatePlaylistItem
 } from './services/railcontent.js';
 
+import {
+	rankCategories,
+	rankItems,
+	similarItems
+} from './services/recommendations.js';
+
 import {
 	fetchAll,
 	fetchAllFilterOptions,
@@ -145,16 +164,21 @@ import {
 
 export {
 	addItemToPlaylist,
+	assignModeratorToComment,
 	assignmentStatusCompleted,
 	assignmentStatusReset,
+	closeComment,
 	contentStatusCompleted,
 	contentStatusReset,
 	countAssignmentsAndLessons,
+	createComment,
 	createPlaylist,
+	deleteComment,
 	deletePlaylist,
 	deletePlaylistItem,
 	deletePlaylistLike,
 	duplicatePlaylist,
+	editComment,
 	fetchAll,
 	fetchAllCompletedStates,
 	fetchAllFilterOptions,
@@ -173,6 +197,8 @@ export {
 	fetchCoachLessons,
 	fetchComingSoon,
 	fetchCommentModContentData,
+	fetchCommentRelies,
+	fetchComments,
 	fetchCompletedChallenges,
 	fetchCompletedContent,
 	fetchCompletedState,
@@ -212,6 +238,7 @@ export {
 	fetchSongArtistCount,
 	fetchSongById,
 	fetchSongsInProgress,
+	fetchTopComment,
 	fetchTopLevelParentId,
 	fetchUpcomingEvents,
 	fetchUserAward,
@@ -234,8 +261,10 @@ export {
 	initializeService,
 	isContentLiked,
 	jumpToContinueContent,
+	likeComment,
 	likeContent,
 	likePlaylist,
+	openComment,
 	pinPlaylist,
 	playback,
 	postChallengesCommunityNotification,
@@ -252,11 +281,17 @@ export {
 	postContentReset,
 	postContentUnliked,
 	postRecordWatchSession,
+	rankCategories,
+	rankItems,
 	recordWatchSession,
+	replyToComment,
 	reportPlaylist,
 	reset,
 	setLastUpdatedTime,
 	setStudentViewForUser,
+	similarItems,
+	unassignModeratorToComment,
+	unlikeComment,
 	unlikeContent,
 	unpinPlaylist,
 	updatePlaylist,

package/src/services/config.js

@@ -5,6 +5,7 @@
 export let globalConfig = {
   sanityConfig: {},
   railcontentConfig: {},
+  recommendationsConfig: {},
   localStorage: null,
   isMA: false,
   localTimezoneString: null, // In format: America/Vancouver
@@ -35,6 +36,8 @@ const excludeFromGeneratedIndex = []
  * @param {string} config.railcontentConfig.userId - The user ID for fetching user-specific data.
  * @param {string} config.railcontentConfig.baseUrl - The url for the environment.
  * @param {string} config.railcontentConfig.authToken - The bearer authorization token.
+ * @param {string} config.recommendationsConfig.token - The token for authenticating recommendation requests.
+ * @param {string} config.recommendationsConfig.baseUrl - The url for the recommendation server.
  * @param {Object} config.localStorage - Cache to use for localStorage
  * @param {boolean} config.isMA - Variable that tells if the library is used by MA or FEW
  * @param {string} config.localTimezoneString - The local timezone string in format: America/Vancouver
@@ -49,15 +52,20 @@ const excludeFromGeneratedIndex = []
  *     dataset: 'your-dataset-name',
  *     version: '2021-06-07',
  *     debug: true,
- *     useCachedAPI: false
+ *     useCachedAPI: false,
  *   },
  *   railcontentConfig: {
  *     token: 'your-user-api-token',
  *     userId: 'current-user-id',
- *     baseUrl: 'https://web-staging-one.musora.com'
+ *     baseUrl: 'https://web-staging-one.musora.com',
+ *     authToken 'your-auth-token',
+ *   },
+ *   recommendationsConfig: {
+ *     token: 'your-user-api-token',
+ *     baseUrl: 'https://MusoraProductDepartment-PWGenerator.hf.space',
  *   },
  *   localStorage: localStorage,
- *   isMA: false
+ *   isMA: false,
  * });
  */
 export function initializeService(config) {
@@ -66,4 +74,5 @@ export function initializeService(config) {
   globalConfig.localStorage = config.localStorage
   globalConfig.isMA = config.isMA || false
   globalConfig.localTimezoneString = config.localTimezoneString || null
+  globalConfig.recommendationsConfig = config.recommendationsConfig
 }

package/src/services/railcontent.js

@@ -290,6 +290,10 @@ async function patchDataHandler(url, data) {
   return fetchHandler(url, 'patch', null, data)
 }
 
+async function deleteDataHandler(url, data) {
+  return fetchHandler(url, 'delete')
+}
+
 export async function fetchHandler(url, method = 'get', dataVersion = null, body = null) {
   let headers = {
     'Content-Type': 'application/json',
@@ -1206,28 +1210,28 @@ export async function setStudentViewForUser(userId, enable) {
  * @returns {Promise<Object|null>} - A promise that resolves to an comment object
  */
 export async function fetchTopComment(railcontentId) {
-  const url = `/api/content/v1/comments/${railcontentId}/top`
+  const url = `/api/content/v1/comments/content/${railcontentId}/top`
   return await fetchHandler(url)
 }
 
 
 /**
  *
- * @param railcontentId
- * @param page
- * @param limit
+ * @param {int} railcontentId
+ * @param {int} page
+ * @param {int} limit
  * @returns {Promise<*|null>}
  */
 export async function fetchComments(railcontentId, page = 1, limit = 20) {
-  const url = `/api/content/v1/comments/${railcontentId}/all?page=${page}&limit=${limit}`
+  const url = `/api/content/v1/comments/content/${railcontentId}/all?page=${page}&limit=${limit}`
   return await fetchHandler(url)
 }
 
 /**
  *
- * @param commentId
- * @param page
- * @param limit
+ * @param {int} commentId
+ * @param {int} page
+ * @param {int} limit
  * @returns {Promise<*|null>}
  */
 export async function fetchCommentRelies(commentId, page = 1, limit = 20) {
@@ -1235,6 +1239,115 @@ export async function fetchCommentRelies(commentId, page = 1, limit = 20) {
   return await fetchHandler(url)
 }
 
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function deleteComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}`
+  return await fetchHandler(url, "DELETE")
+}
+
+/**
+ * @param {int} commentId
+ * @param {string} comment
+ * @returns {Promise<*|null>}
+ */
+export async function replyToComment(commentId, comment) {
+  const data = {'comment' : comment}
+  const url = `/api/content/v1/comments/${commentId}/reply`
+  return await postDataHandler(url, data)
+}
+
+/**
+ * @param {int} railcontentId
+ * @param {string} comment
+ * @returns {Promise<*|null>}
+ */
+export async function createComment(railcontentId, comment) {
+  const data = {
+    'comment' : comment,
+    'content_id' : railcontentId
+  }
+  const url = `/api/content/v1/comments/store`
+  return await postDataHandler(url, data)
+}
+
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function assignModeratorToComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}/assign_moderator`
+  return await postDataHandler(url)
+}
+
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function unassignModeratorToComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}/unassign_moderator`
+  return await postDataHandler(url)
+}
+
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function likeComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}/like`
+  return await postDataHandler(url)
+}
+
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function unlikeComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}/like`
+  return await deleteDataHandler(url)
+}
+
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function closeComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}`
+  const data = {
+    'conversation_status' : 'closed'
+  }
+  return await patchDataHandler(url, data)
+}
+
+/**
+ * @param {int} commentId
+ * @returns {Promise<*|null>}
+ */
+export async function openComment(commentId) {
+  const url = `/api/content/v1/comments/${commentId}`
+  const data = {
+    'conversation_status' : 'open'
+  }
+  return await patchDataHandler(url, data)
+}
+
+/**
+ * @param {int} commentId
+ * @param {string} comment
+ * @returns {Promise<*|null>}
+ */
+export async function editComment(commentId, comment) {
+  const url = `/api/content/v1/comments/${commentId}`
+  const data = {
+    'comment' : comment
+  }
+  return await patchDataHandler(url, data)
+}
+
+
+
 function fetchAbsolute(url, params) {
   if (globalConfig.railcontentConfig.authToken) {
     params.headers['Authorization'] = `Bearer ${globalConfig.railcontentConfig.authToken}`

package/src/services/recommendations.js

@@ -0,0 +1,153 @@
+/**
+ * @module Railcontent-Services
+ */
+
+import { globalConfig } from './config.js'
+
+/**
+ * Exported functions that are excluded from index generation.
+ *
+ * @type {string[]}
+ */
+const excludeFromGeneratedIndex = []
+
+/**
+ * Fetches similar content to the provided content id
+ *
+ * @param {brand} brand - brand of the content to filter
+ * @param {integer} content_id - The ID of the content to find similar items for
+ * @param {integer} count - number of items to return
+ * @returns {Promise<Object|null>} - Returns the content_ids sorted by rank (most significant first)
+ * @example
+ * rankItems('drumeo', 1113)
+ *   .then(status => console.log(status))
+ *   .catch(error => console.error(error));
+ */
+export async function similarItems(brand, content_id, count = 10) {
+  if (!content_id) {
+    return []
+  }
+
+  let data = {
+    'brand': brand,
+    'content_ids': content_id,
+    'num_similar': count,
+  }
+  const url = `/similar_items/`
+  try {
+    const response = await fetchHandler(url, 'POST', data)
+    return response['similar_items']
+  } catch (error) {
+    console.error('Fetch error:', error)
+    return null
+  }
+}
+
+/**
+ * Sorts the provided categories based on the user's match
+ *
+ * @param {brand} brand - brand of the content to filter
+ * @param {Object} categories - Keyed arrays of content ids
+ * @returns {Promise<Object|null>} - Returns the content_ids sorted by rank (most significant first), elements in each category are also ranked
+ * @example
+ * rankCategories('drumeo', {
+ *                            1: [111222, 23120, 402199],
+ *                            2: [2222, 33333, 44444]
+ *                          }
+ *                )
+ *   .then(status => console.log(status))
+ *   .catch(error => console.error(error));
+ */
+export async function rankCategories(brand, categories) {
+  if (categories.length === 0) {
+    return []
+  }
+  let data = {
+    'brand': brand,
+    'user_id': globalConfig.railcontentConfig.userId,
+    'playlists': categories,
+  }
+  const url = `/rank_each_list/`
+  try {
+    const response = await fetchHandler(url, 'POST', data)
+    let rankedCategories = {}
+    response['ranked_playlists'].forEach((category) => rankedCategories[category['playlist_id']] = categories[category['playlist_id']])
+    return rankedCategories
+  } catch (error) {
+    console.error('Fetch error:', error)
+    return null
+  }
+}
+
+/**
+ * Fetches the completion status of a specific lesson for the current user.
+ *
+ * @param {brand} brand - brand of the content to filter
+ * @param {Array<string>} content_ids - The IDs of the content to rank
+ * @returns {Promise<Object|null>} - Returns the content_ids sorted by rank (most significant first)
+ * @example
+ * rankItems('drumeo', ([111222, 23120, 402199])
+ *   .then(status => console.log(status))
+ *   .catch(error => console.error(error));
+ */
+export async function rankItems(brand, content_ids) {
+  if (content_ids.length === 0) {
+    return []
+  }
+  let data = {
+    'brand': brand,
+    'user_id': globalConfig.railcontentConfig.userId,
+    'content_ids': content_ids,
+  }
+  const url = `/rank_items/`
+  try {
+    const response = await fetchHandler(url, 'POST', data)
+    return response['ranked_content_ids']
+  } catch (error) {
+    console.error('Fetch error:', error)
+    return null
+  }
+}
+
+async function fetchHandler(url, method = 'get', body = null) {
+
+  let headers = {
+    'Content-Type': 'application/json',
+    Accept: 'application/json',
+    'X-CSRF-TOKEN': globalConfig.recommendationsConfig.token,
+  }
+
+  const options = {
+    method,
+    headers,
+  }
+
+  if (body) {
+    options.body = JSON.stringify(body)
+  }
+  try {
+    const response = await fetchAbsolute(url, options)
+    if (response.ok) {
+      return await response.json()
+    } else {
+      console.error(`Fetch error: ${method} ${url} ${response.status} ${response.statusText}`)
+      console.log(response)
+    }
+  } catch (error) {
+    console.error('Fetch error:', error)
+  }
+  return null
+}
+
+
+function fetchAbsolute(url, params) {
+  if (globalConfig.recommendationsConfig.token) {
+    params.headers['Authorization'] = `Bearer ${globalConfig.recommendationsConfig.token}`
+  }
+  if (globalConfig.recommendationsConfig.baseUrl) {
+    if (url.startsWith('/')) {
+      return fetch(globalConfig.recommendationsConfig.baseUrl + url, params)
+    }
+  }
+  return fetch(url, params)
+}