musora-content-services 2.28.6 → 2.30.3

package/CHANGELOG.md

@@ -2,6 +2,55 @@
 
 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.30.3](https://github.com/railroadmedia/musora-content-services/compare/v2.30.2...v2.30.3) (2025-08-04)
+
+### [2.30.2](https://github.com/railroadmedia/musora-content-services/compare/v2.30.1...v2.30.2) (2025-08-04)
+
+### [2.30.1](https://github.com/railroadmedia/musora-content-services/compare/v2.30.0...v2.30.1) (2025-08-04)
+
+
+### Bug Fixes
+
+* null check on buildNavigateTo ([#397](https://github.com/railroadmedia/musora-content-services/issues/397)) ([2387877](https://github.com/railroadmedia/musora-content-services/commit/238787786fa322872f733d769547a49796fc0bf1))
+
+## [2.30.0](https://github.com/railroadmedia/musora-content-services/compare/v2.28.6...v2.30.0) (2025-08-01)
+
+
+### Features
+
+* **navigateTo:** Add navigateTo context and update homepageprogress rows to pull the same data as other locations ([#389](https://github.com/railroadmedia/musora-content-services/issues/389)) ([b731957](https://github.com/railroadmedia/musora-content-services/commit/b73195790ba0aefd98e1584ef0f57839979613b3))
+
+
+### Bug Fixes
+
+* Change recommendation config to use recommender.musora.com ([#395](https://github.com/railroadmedia/musora-content-services/issues/395)) ([170d48a](https://github.com/railroadmedia/musora-content-services/commit/170d48a4b10bb11371889e14a74b3dd663d5c0e7))
+* **MU2-907:** scheduled content appearing in new releases ([#391](https://github.com/railroadmedia/musora-content-services/issues/391)) ([c4f3c48](https://github.com/railroadmedia/musora-content-services/commit/c4f3c482c62513ddc4b2465bb7a6e155a92a52da))
+* **T3PS-120:** allow falsey values for description and category ([#392](https://github.com/railroadmedia/musora-content-services/issues/392)) ([5645488](https://github.com/railroadmedia/musora-content-services/commit/56454880df8c92fa3c9c0a57f8b8ae7115d49391))
+* **T3PS-139:** fix lesson count on content cards ([#383](https://github.com/railroadmedia/musora-content-services/issues/383)) ([818c4d0](https://github.com/railroadmedia/musora-content-services/commit/818c4d0e5f8903d9f7b2a7667460a4beb144d7ab))
+* **T3PS-594:** wrong active date mobile ([#387](https://github.com/railroadmedia/musora-content-services/issues/387)) ([f9e2dfd](https://github.com/railroadmedia/musora-content-services/commit/f9e2dfd008660d55865e526317ef79e5d95e3f06))
+* **T3PS-602:** fixes thumbnail data missing from getNewAndUpcoming MCS method ([#386](https://github.com/railroadmedia/musora-content-services/issues/386)) ([f8da5fc](https://github.com/railroadmedia/musora-content-services/commit/f8da5fc674380ffdebcf636ddbb7b0a5f14ba7ae))
+* **T3PS-630:** show song-tutorial children in recent songs instead of parent ([#390](https://github.com/railroadmedia/musora-content-services/issues/390)) ([312bdf8](https://github.com/railroadmedia/musora-content-services/commit/312bdf891a6ffb6eb3113ebfea1692d586e0d2ea))
+* **T3PS-644:** practice day incorrectly assigned ([#393](https://github.com/railroadmedia/musora-content-services/issues/393)) ([8b8a424](https://github.com/railroadmedia/musora-content-services/commit/8b8a4245cdaa389c7916eb398da47bf30f6fc056))
+
+## [2.29.0](https://github.com/railroadmedia/musora-content-services/compare/v2.28.6...v2.29.0) (2025-08-01)
+
+
+### Features
+
+* **navigateTo:** Add navigateTo context and update homepageprogress rows to pull the same data as other locations ([#389](https://github.com/railroadmedia/musora-content-services/issues/389)) ([b731957](https://github.com/railroadmedia/musora-content-services/commit/b73195790ba0aefd98e1584ef0f57839979613b3))
+
+
+### Bug Fixes
+
+* Change recommendation config to use recommender.musora.com ([#395](https://github.com/railroadmedia/musora-content-services/issues/395)) ([170d48a](https://github.com/railroadmedia/musora-content-services/commit/170d48a4b10bb11371889e14a74b3dd663d5c0e7))
+* **MU2-907:** scheduled content appearing in new releases ([#391](https://github.com/railroadmedia/musora-content-services/issues/391)) ([c4f3c48](https://github.com/railroadmedia/musora-content-services/commit/c4f3c482c62513ddc4b2465bb7a6e155a92a52da))
+* **T3PS-120:** allow falsey values for description and category ([#392](https://github.com/railroadmedia/musora-content-services/issues/392)) ([5645488](https://github.com/railroadmedia/musora-content-services/commit/56454880df8c92fa3c9c0a57f8b8ae7115d49391))
+* **T3PS-139:** fix lesson count on content cards ([#383](https://github.com/railroadmedia/musora-content-services/issues/383)) ([818c4d0](https://github.com/railroadmedia/musora-content-services/commit/818c4d0e5f8903d9f7b2a7667460a4beb144d7ab))
+* **T3PS-594:** wrong active date mobile ([#387](https://github.com/railroadmedia/musora-content-services/issues/387)) ([f9e2dfd](https://github.com/railroadmedia/musora-content-services/commit/f9e2dfd008660d55865e526317ef79e5d95e3f06))
+* **T3PS-602:** fixes thumbnail data missing from getNewAndUpcoming MCS method ([#386](https://github.com/railroadmedia/musora-content-services/issues/386)) ([f8da5fc](https://github.com/railroadmedia/musora-content-services/commit/f8da5fc674380ffdebcf636ddbb7b0a5f14ba7ae))
+* **T3PS-630:** show song-tutorial children in recent songs instead of parent ([#390](https://github.com/railroadmedia/musora-content-services/issues/390)) ([312bdf8](https://github.com/railroadmedia/musora-content-services/commit/312bdf891a6ffb6eb3113ebfea1692d586e0d2ea))
+* **T3PS-644:** practice day incorrectly assigned ([#393](https://github.com/railroadmedia/musora-content-services/issues/393)) ([8b8a424](https://github.com/railroadmedia/musora-content-services/commit/8b8a4245cdaa389c7916eb398da47bf30f6fc056))
+
 ### [2.28.6](https://github.com/railroadmedia/musora-content-services/compare/v2.28.5...v2.28.6) (2025-07-28)
 
 

package/package.json

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

package/src/contentTypeConfig.js

@@ -1,5 +1,6 @@
 //import {AWSUrl, CloudFrontURl} from "./services/config";
 import {Tabs} from "./contentMetaData.js";
+import {FilterBuilder} from "./filterBuilder.js";
 
 export const AWSUrl = 'https://s3.us-east-1.amazonaws.com/musora-web-platform'
 export const CloudFrontURl = 'https://d3fzm1tzeyr5n3.cloudfront.net'
@@ -34,12 +35,27 @@ export const DEFAULT_FIELDS = [
   '"lesson_count": coalesce(count(child[]->.child[]->), child_count)',
   '"parent_id": parent_content_data[0].id',
 ]
+
 export const DEFAULT_CHILD_FIELDS = [
-  `"id": railcontent_id`,
-  `title`,
-  `"image": thumbnail.asset->url`,
-  `"instructors": instructor[]->name`,
-  `length_in_seconds`,
+  "'id': railcontent_id",
+  'railcontent_id',
+  artistOrInstructorName(),
+  "'artist': artist->{ 'name': name, 'thumbnail': thumbnail_url.asset->url}",
+  'title',
+  "'image': thumbnail.asset->url",
+  "'thumbnail': thumbnail.asset->url",
+  'difficulty',
+  'difficulty_string',
+  'published_on',
+  "'type': _type",
+  "'length_in_seconds' : coalesce(length_in_seconds, soundslice[0].soundslice_length_in_second)",
+  'brand',
+  "'genre': genre[]->name",
+  'status',
+  "'slug' : slug.current",
+  "'permission_id': permission[]->railcontent_id",
+  'child_count',
+  '"parent_id": parent_content_data[0].id',
 ]
 
 export const instructorField = `instructor[]->{
@@ -202,7 +218,7 @@ export const progressTypesMapping = {
   'show': showsLessonTypes,
   'song tutorial': [...tutorialsLessonTypes, 'song-tutorial-children'],
   'songs': transcriptionsLessonTypes,
-  'play-along': playAlongLessonTypes,
+  'play along': playAlongLessonTypes,
   'guided course': ['guided-course'],
   'pack': ['pack', 'semester-pack'],
   'method': ['learning-path'],
@@ -224,7 +240,7 @@ export const filterTypes = {
 
 export const recentTypes = {
   lessons: [...individualLessonsTypes, 'course-part', 'pack-bundle-lesson', 'guided-course-part', 'quick-tips'],
-  songs: [...tutorialsLessonTypes, ...transcriptionsLessonTypes, ...playAlongLessonTypes],
+  songs: [...SONG_TYPES],
   home: [...individualLessonsTypes, ...tutorialsLessonTypes, ...transcriptionsLessonTypes, ...playAlongLessonTypes,
   'guided-course', 'learning-path', 'live', 'course', 'pack']
 }
@@ -235,30 +251,14 @@ export let contentTypeConfig = {
       'enrollment_start_time',
       'enrollment_end_time',
     ],
+    includeChildFields: true,
   },
   'progress-tracker': {
     fields: [
       '"parent_content_data": parent_content_data[].id',
       '"badge" : badge.asset->url',
-      '"lessons": child[]->{' +
-        '"id": railcontent_id,' +
-        '"slug":slug.current,' +
-        '"brand":brand,' +
-        '"type": _type,' +
-        '"thumbnail": thumbnail.asset->url,' +
-        'published_on,' +
-        '"lessons": child[]->{' +
-          '"id":railcontent_id,' +
-          '"slug":slug.current,' +
-          '"type": _type,' +
-          '"brand":brand},' +
-          '"thumbnail": thumbnail.asset->url,' +
-          'published_on,' +
-        '}',
     ],
-
-
-
+    includeChildFields: true,
   },
   song: {
     fields: ['album', 'soundslice', 'instrumentless', `"resources": ${resourcesField}`],
@@ -282,6 +282,7 @@ export let contentTypeConfig = {
             }`,
       '"instructors": instructor[]->name',
     ],
+    includeChildFields: true,
     relationships: {
       artist: {
         isOneToOne: true,
@@ -291,6 +292,9 @@ export let contentTypeConfig = {
   'song-tutorial-children': {
     fields: [`"resources": ${resourcesField}`],
   },
+  'guided-course': {
+    includeChildFields: true,
+  },
   course: {
     fields: [
       '"lesson_count": child_count',
@@ -424,26 +428,20 @@ export let contentTypeConfig = {
       '"instructors": instructor[]->{ "id": railcontent_id, name, "thumbnail_url": thumbnail_url.asset->url }',
       '"logo_image_url": logo_image_url.asset->url',
       'total_xp',
-      `"children": child[]->{
-        "description": ${descriptionField},
-        "lesson_count": child_count,
-        "instructors": select(
-          instructor != null => instructor[]->name,
-          ^.instructor[]->name
-        ),
-        "children": child[]->{
-          "description": ${descriptionField},
-          "children": child[]->{"id": railcontent_id},
-          ${getFieldsForContentType()}
-        },
-        ${getFieldsForContentType()}
-      }`,
       `"resources": ${resourcesField}`,
       '"thumbnail": thumbnail.asset->url',
       '"light_mode_logo": light_mode_logo_url.asset->url',
       '"dark_mode_logo": dark_mode_logo_url.asset->url',
       `"description": ${descriptionField}`,
     ],
+    childFields: [
+      `'description': ${descriptionField}`,
+      "'lesson_count': child_count",
+      `'instructors': select(
+        instructor != null => instructor[]->name,
+        ^.instructor[]->name
+      )`,
+    ],
   },
   rudiment: {
     fields: ['sheet_music_thumbnail_url'],
@@ -456,10 +454,6 @@ export let contentTypeConfig = {
   'pack-children': {
     fields: [
       'child_count',
-      `"children": child[]->{
-                "description": ${descriptionField},
-                ${getFieldsForContentType()}
-            }`,
       `"resources": ${resourcesField}`,
       '"image": logo_image_url.asset->url',
       '"thumbnail": thumbnail.asset->url',
@@ -468,6 +462,9 @@ export let contentTypeConfig = {
       `"description": ${descriptionField}`,
       'total_xp',
     ],
+    childFields: [
+      `"description": ${descriptionField}`,
+    ]
   },
   'pack-bundle-lesson': {
     fields: [`"resources": ${resourcesField}`],
@@ -681,6 +678,35 @@ export function artistOrInstructorNameAsArray(key = 'artists') {
   return `'${key}': select(artist->name != null => [artist->name], instructor[]->name)`
 }
 
+export async function getFieldsForContentTypeWithFilteredChildren(contentType, asQueryString = true) {
+  const childFields = getChildFieldsForContentType(contentType, true)
+  const parentFields = getFieldsForContentType(contentType, false)
+  if (childFields) {
+    const childFilter = await new FilterBuilder('', {isChildrenFilter: true}).buildFilter()
+    parentFields.push(
+      `"children": child[${childFilter}]->{
+        ${childFields}
+        "children": child[${childFilter}]->{
+          ${childFields}
+        },
+      }`
+    )
+  }
+  return asQueryString ? parentFields.toString() + ',' : parentFields
+}
+
+export function getChildFieldsForContentType(contentType, asQueryString = true)
+{
+  if (contentTypeConfig[contentType]?.childFields || contentTypeConfig[contentType]?.includeChildFields) {
+    const childFields = contentType
+      ? DEFAULT_CHILD_FIELDS.concat(contentTypeConfig?.[contentType]?.childFields ?? [])
+      : DEFAULT_CHILD_FIELDS
+    return asQueryString ? childFields.toString() + ',' : childFields
+  } else {
+    return asQueryString ? '' : []
+  }
+}
+
 export function getFieldsForContentType(contentType, asQueryString = true) {
   const fields = contentType
     ? DEFAULT_FIELDS.concat(contentTypeConfig?.[contentType]?.fields ?? [])
@@ -688,13 +714,6 @@ export function getFieldsForContentType(contentType, asQueryString = true) {
   return asQueryString ? fields.toString() + ',' : fields
 }
 
-export function getChildFieldsForContentType(contentType, asQueryString = true) {
-  const fields = contentType
-    ? DEFAULT_CHILD_FIELDS.concat(childContentTypeConfig?.[contentType] ?? [])
-    : DEFAULT_CHILD_FIELDS
-  return asQueryString ? fields.toString() + ',' : fields
-}
-
 /**
  * Takes the included fields array and returns a string that can be used in a groq query.
  * @param {Array<string>} filters - An array of strings that represent applied filters. This should be in the format of a key,value array. eg. ['difficulty,Intermediate',

package/src/services/config.js

@@ -8,7 +8,6 @@ import './types.js'
 export let globalConfig = {
   sanityConfig: {},
   railcontentConfig: {},
-  recommendationsConfig: {},
   sessionConfig: {},
   localStorage: null,
   isMA: false,
@@ -50,10 +49,6 @@ const excludeFromGeneratedIndex = []
  *     userId: 'current-user-id',
  *     authToken 'your-auth-token',
  *   },
- *   recommendationsConfig: {
- *     token: 'your-user-api-token',
- *     baseUrl: 'https://MusoraProductDepartment-PWGenerator.hf.space',
- *   },
  *   baseUrl: 'https://web-staging-one.musora.com',
  *   localStorage: localStorage,
  *   isMA: false,
@@ -67,5 +62,4 @@ 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/content-org/playlists-types.js

@@ -8,6 +8,16 @@
  * @property {string} brand - Brand identifier for the playlist.
  */
 
+/**
+ * @typedef UpdatePlaylistDTO
+ * @property {string} name - The name of the new playlist. (required, max 255 characters)
+ * @property {string} description - A description of the playlist. (optional, max 1000 characters)
+ * @property {string} category - The category of the playlist. (optional, max 255 characters)
+ * @property {boolean} is_private - Whether the playlist is private. (optional, defaults to false)
+ * @property {Array<number>} deleted_items - List of playlist items to be deleted. (optional)
+ * @property {Array<number>} item_order - List of all remaining playlist item ids (not content_ids) provided in the new order. (optional)
+ */
+
 /**
  * @typedef DuplicatePlaylistDTO
  * @property {string} name - The name of the new playlist. (required, max 255 characters)