musora-content-services 2.5.1 → 2.6.0

package/src/services/railcontent.js

@@ -848,6 +848,45 @@ export async function fetchLastInteractedChild(content_ids) {
   return await fetchHandler(url, 'GET', null)
 }
 
+/**
+ * @typedef {Object} Activity
+ * @property {string} id - Unique identifier for the activity.
+ * @property {string} type - Type of activity (e.g., "lesson_completed").
+ * @property {string} timestamp - ISO 8601 string of when the activity occurred.
+ * @property {Object} meta - Additional metadata related to the activity.
+ */
+
+/**
+ * @typedef {Object} PaginatedActivities
+ * @property {number} currentPage
+ * @property {number} totalPages
+ * @property {Activity[]} data
+ */
+
+/**
+ * Fetches a paginated list of recent user activities.
+ * @param {Object} [params={}] - Optional parameters.
+ * @param {number} [params.page=1] - The page number for pagination.
+ * @param {number} [params.limit=10] - The number of results per page.
+ * @param {string|null} [params.tabName=null] - Optional filter for activity type/tab.
+ * @returns {Promise<PaginatedActivities>} - A promise that resolves to a paginated object of user activities.
+ *
+ * @example
+ * fetchRecentUserActivities({ page: 2, limit: 5 })
+ *   .then(activities => console.log(activities))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchRecentUserActivities({
+  page = 1,
+  limit = 5,
+  tabName = null
+} = {}) {
+  let pageAndLimit = `?page=${page}&limit=${limit}`
+  let tabParam = tabName ? `&tabName=${tabName}` : ''
+  const url = `/api/user-management-system/v1/activities/all${pageAndLimit}${tabParam}`
+  return await fetchHandler(url, 'GET', null)
+}
+
 
 function fetchAbsolute(url, params) {
   if (globalConfig.sessionConfig.authToken) {

package/src/services/user/profile.js

@@ -0,0 +1,33 @@
+/**
+ * @module UserProfile
+ */
+import { fetchJSONHandler } from '../../lib/httpHelper.js'
+import { globalConfig } from '../config.js'
+import { calculateLongestStreaks } from '../userActivity.js'
+import './types.js'
+
+const baseUrl = `/api/user-management-system`
+
+/**
+ * @param {number|null} userId - The user ID to reset permissions for.
+ * @returns {Promise<OtherStatsDTO>}
+ */
+export async function otherStats(userId = globalConfig.sessionConfig.userId) {
+  const [otherStats, longestStreaks] = await Promise.all([
+    fetchJSONHandler(`${baseUrl}/v1/users/${userId}/permissions`, 'delete'),
+    calculateLongestStreaks(userId),
+  ])
+
+  return {
+    ...otherStats,
+    longest_day_streak: {
+      type: 'day',
+      length: longestStreaks.longestDailyStreak,
+    },
+    longest_week_streak: {
+      type: 'week',
+      length: longestStreaks.longestWeeklyStreak,
+    },
+    total_practice_time: longestStreaks.totalPracticeSeconds,
+  }
+}

package/src/services/user/types.js

@@ -114,3 +114,23 @@
  * @property {boolean} isAdmin
  * @property {boolean} isABasicMember
  */
+
+/**
+ * @typedef {Object} StreakDTO
+ *
+ * @property {string} type - week or day
+ * @property {number} length
+ * @property {Date|null} start_date
+ * @property {Date|null} end_date
+ */
+
+/**
+ * @typedef {Object} OtherStatsDTO
+ *
+ * @property {StreakDTO} longest_day_streak
+ * @property {StreakDTO} longest_week_streak
+ * @property {number} total_practice_time
+ * @property {number} comment_likes
+ * @property {number} forum_post_likes
+ * @property {number} experience_points
+ */