musora-content-services 2.67.1 → 2.67.2

package/docs/module-UserProfile.html

@@ -357,7 +357,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/railcontent.js.html

@@ -822,7 +822,7 @@ export async function fetchHandler(url, method = 'get', dataVersion = null, body
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/sanity.js.html

@@ -2373,7 +2373,7 @@ export async function fetchMethodV2Structure(brand) {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/userActivity.js.html

@@ -1519,7 +1519,7 @@ export async function fetchRecentActivitiesActiveTabs() {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_account.ts.html

@@ -224,7 +224,7 @@ export async function numberOfActiveUsers(): Promise<number> {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_chat.js.html

@@ -85,7 +85,7 @@ export async function fetchChatSettings({ brand = null, liveEventIsGlobal = fals
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_interests.js.html

@@ -137,7 +137,7 @@ export async function removeContentAsNotInterested(contentId) {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_management.js.html

@@ -245,7 +245,7 @@ export async function toggleSignaturePrivate(showSignature = true) {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_memberships.ts.html

@@ -279,7 +279,7 @@ export async function restorePurchases(
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_notifications.js.html

@@ -361,7 +361,7 @@ export async function fetchLiveEventPollingState() {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_onboarding.ts.html

@@ -170,7 +170,7 @@ export async function userOnboardingForBrand(brand: string): Promise<Onboardi
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_payments.ts.html

@@ -84,7 +84,7 @@ export async function fetchCustomerPayments(): Promise<CustomerOrder[]> {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_permissions.js.html

@@ -97,7 +97,7 @@ export async function reset() {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_profile.js.html

@@ -102,7 +102,7 @@ export async function deleteProfilePicture() {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_sessions.js.html

@@ -157,7 +157,7 @@ export async function logout() {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_types.js.html

@@ -209,7 +209,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/user_user-management-system.js.html

@@ -66,7 +66,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Mon Nov 03 2025 17:10:23 GMT-0800 (Pacific Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Tue Nov 04 2025 08:55:34 GMT+0200 (Eastern European Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

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

package/src/contentMetaData.js

@@ -4,6 +4,24 @@
 const PROGRESS_NAMES = ['All', 'In Progress', 'Completed', 'Not Started']
 const DIFFICULTY_STRINGS = ['Introductory', 'Beginner', 'Intermediate', 'Advanced', 'Expert']
 
+const LESSON_TYPE_FILTER = [
+  {
+    title: 'Single Lessons',
+    children: ['Lessons', 'Practice Alongs', 'Live Archives', 'Student Archives']
+  },
+  {
+    title: 'Courses',
+    children: ['Courses', 'Guided Courses', 'Tiered Courses']
+  },
+  {
+    title: 'Skill Packs',
+  },
+  {
+    title: 'Entertainment',
+    children: ['Specials', 'Documentaries', 'Shows']
+  }
+]
+
 class SortingOptions {
   static Popularity = { value: '-popularity', name: 'Most Popular' }
   static PopularityDesc = { value: 'recommended', name: 'Recommended' }
@@ -65,7 +83,7 @@ const commonMetadata = {
     filterOptions: {
       difficulty: DIFFICULTY_STRINGS,
       style: ['Country/Folk', 'Funk/Disco', 'Hard Rock/Metal', 'Hip-Hop/Rap/EDM', 'Holiday/Soundtrack', 'Jazz/Blues', 'Latin/World', 'Pop/Rock', 'R&B/Soul', 'Worship/Gospel'],
-      type: ['Single Lessons', 'Practice Alongs', 'Performances', 'Courses', 'Live Archives', 'Student Archives'],
+      type: LESSON_TYPE_FILTER,
       progress: PROGRESS_NAMES,
     },
     sortingOptions: {
@@ -140,7 +158,7 @@ const contentMetadata = {
       filterOptions: {
         difficulty: DIFFICULTY_STRINGS,
         style: ['Country/Folk', 'Funk/Disco', 'Hard Rock/Metal', 'Hip-Hop/Rap/EDM', 'Holiday/Soundtrack', 'Jazz/Blues', 'Latin/World', 'Pop/Rock', 'R&B/Soul', 'Worship/Gospel'],
-        type: ['Single Lessons', 'Practice Alongs', 'Performances', 'Courses', 'Shows', 'Documentaries', 'Live Archives', 'Student Archives'],
+        type: LESSON_TYPE_FILTER,
         progress: PROGRESS_NAMES,
       },
       sortingOptions: {
@@ -165,7 +183,7 @@ const contentMetadata = {
       filterOptions: {
         difficulty: DIFFICULTY_STRINGS,
         style: ['Classical', 'Country/Folk', 'Funk/Disco', 'Hip-Hop/Rap/EDM', 'Holiday/Soundtrack', 'Jazz/Blues', 'Latin/World', 'Pop/Rock', 'R&B/Soul', 'Worship/Gospel'],
-        type: ['Single Lessons', 'Practice Alongs', 'Performances', 'Courses', 'Live Archives', 'Student Archives'],
+        type: LESSON_TYPE_FILTER,
         progress: PROGRESS_NAMES,
       },
       sortingOptions: {
@@ -246,17 +264,62 @@ const filterTypes = {
 
 /**
  * Transforms filterOptions into the required format
+ * Supports both flat and hierarchical (two-layer) filter structures
+ *
+ * @param {Object} filterOptions - The raw filter options object
+ * @returns {Array} Transformed filter groups with items
+ *
+ * Hierarchical Structure Format:
+ * Input: [{ parent: 'Category', children: ['Sub1', 'Sub2'] }]
+ * Output: Parent items with nested children in 'items' property
+ *
+ * This nested structure provides clear parent-child relationships
+ * and is ideal for collapsible groups and hierarchical rendering
  */
 function transformFilters(filterOptions) {
-  return Object.entries(filterOptions).map(([key, values]) => ({
-    title: capitalizeFirstLetter(key),
-    type: filterTypes[key] || 'checkbox',
-    key,
-    items: values.map(value => ({
-      name: value,
-      value: `${key},${key === 'progress' ? value.toLowerCase() : value}`,
-    })),
-  }))
+  return Object.entries(filterOptions).map(([key, values]) => {
+    // Check if values is hierarchical (array of objects with title property)
+    // We check for 'title' property to distinguish from simple string arrays
+    const isHierarchical = Array.isArray(values) &&
+      values.length > 0 &&
+      typeof values[0] === 'object' &&
+      values[0].title !== undefined;
+
+    if (isHierarchical) {
+      // Handle hierarchical structure - nest children inside parents
+      const items = values.map(group => ({
+        name: group.title,
+        value: `${key},${group.title}`,
+        // Only include isParent and items if children exist
+        ...(group.children && group.children.length > 0 && {
+          isParent: true,
+          items: group.children.map(child => ({
+            name: child,
+            value: `${key},${child}`,
+          }))
+        })
+      }));
+
+      return {
+        title: capitalizeFirstLetter(key),
+        type: filterTypes[key] || 'checkbox',
+        key,
+        items,
+        isHierarchical: true,
+      };
+    } else {
+      // Handle flat structure (existing behavior - no changes)
+      return {
+        title: capitalizeFirstLetter(key),
+        type: filterTypes[key] || 'checkbox',
+        key,
+        items: values.map(value => ({
+          name: value,
+          value: `${key},${key === 'progress' ? value.toLowerCase() : value}`,
+        })),
+      };
+    }
+  });
 }
 
 /**

package/src/contentTypeConfig.js

@@ -197,6 +197,10 @@ export const coursesLessonTypes = [
   'tiered-course', // TODO: new content type
   'guided-course'];
 
+export const skillLessonTypes = [
+  'skill-pack'
+]
+
 export const showsLessonTypes = [
   'boot-camp',
   'diy-drum-experiment',
@@ -216,13 +220,17 @@ export const collectionLessonTypes = [
 ];
 
 export const lessonTypesMapping = {
-  'single lessons': singleLessonTypes,
+  'lessons': singleLessonTypes,
   'practice alongs': practiceAlongsLessonTypes,
   'live archives': liveArchivesLessonTypes,
   'performances': performancesLessonTypes,
   'student archives': studentArchivesLessonTypes,
   'documentaries': documentariesLessonTypes,
-  'courses': coursesLessonTypes,
+  'courses': ['course'],
+  'guided courses': ['guided-course'],
+  'tiered courses': ['tiered-course' ],
+  'skill packs': ['skill-pack'],
+  'specials': ['specials'],
   'shows': showsLessonTypes,
   'collections': collectionLessonTypes,
   'individuals': individualLessonsTypes,
@@ -232,6 +240,8 @@ export const lessonTypesMapping = {
   'sheet music': transcriptionsLessonTypes,
   'play-alongs': playAlongLessonTypes,
   'jam tracks': jamTrackLessonTypes,
+  'entertainment': entertainmentLessonTypes,
+  'single lessons': [...singleLessonTypes, ...liveArchivesLessonTypes, ...studentArchivesLessonTypes, ...practiceAlongsLessonTypes]
 };
 
 export const getNextLessonLessonParentTypes = ['course', 'guided-course', 'pack', 'pack-bundle', 'song-tutorial'];
@@ -259,7 +269,7 @@ export const songs = {
 }
 
 export const filterTypes = {
-  lessons: [...individualLessonsTypes, ...collectionLessonTypes],
+  lessons: [...singleLessonTypes, ...practiceAlongsLessonTypes , ...liveArchivesLessonTypes, ...studentArchivesLessonTypes, ...coursesLessonTypes, ...skillLessonTypes , ...entertainmentLessonTypes],
   songs: [...tutorialsLessonTypes, ...transcriptionsLessonTypes, ...playAlongLessonTypes, ...jamTrackLessonTypes],
 }
 

package/src/services/forums/posts.ts

@@ -132,6 +132,7 @@ export async function fetchCommunityGuidelines(brand: string): Promise<ForumPost
 export interface SearchParams {
   page?: number,
   limit?: number,
+  category_id?: number,
   /** Sort order: "-published_on" (default), "published_on", or "mine". */
   sort?: '-published_on' | string,
   term: string
@@ -147,7 +148,7 @@ export interface SearchParams {
  */
 export async function search(
   brand: string,
-  params: SearchParams = {}
+  params: SearchParams
 ): Promise<PaginatedResponse<ForumPost>> {
   const httpClient = new HttpClient(globalConfig.baseUrl)
   const queryObj: Record<string, string> = { brand, ...Object.fromEntries(