musora-content-services 2.97.0 → 2.99.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 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.99.0](https://github.com/railroadmedia/musora-content-services/compare/v2.98.0...v2.99.0) (2025-12-09)
+
+
+### Features
+
+* **BEH-1421:** Content Migration : child lesson type migrations ([#624](https://github.com/railroadmedia/musora-content-services/issues/624)) ([77300ed](https://github.com/railroadmedia/musora-content-services/commit/77300eddabc4deed46c26f7b1291d9540a3ef486))
+
+## [2.98.0](https://github.com/railroadmedia/musora-content-services/compare/v2.94.7...v2.98.0) (2025-12-09)
+
+
+### Features
+
+* **BEH-1195:** Awards System ([#606](https://github.com/railroadmedia/musora-content-services/issues/606)) ([a6ffd92](https://github.com/railroadmedia/musora-content-services/commit/a6ffd92ae518c8e530d4ef743f2649725fddb285))
+* **BEH-1458:** method addcontexttocontent ([#633](https://github.com/railroadmedia/musora-content-services/issues/633)) ([95a2b0a](https://github.com/railroadmedia/musora-content-services/commit/95a2b0ae3f011e17f92b78ad4fcd1ebe7a2342ca))
+* handle learning path complete logic ([#628](https://github.com/railroadmedia/musora-content-services/issues/628)) ([e5266d2](https://github.com/railroadmedia/musora-content-services/commit/e5266d2219597fc295dab97cec7b7ce8ac80a705))
+* **MU2E2-219:** New method for membership upgrade ([0548f25](https://github.com/railroadmedia/musora-content-services/commit/0548f2531dd67abda63c0768ae0005448a27c163))
+* **MU2E2-219:** New method for membership upgrade ([42f2cd8](https://github.com/railroadmedia/musora-content-services/commit/42f2cd825e70a9afeb9f13bd09a0709c003b3c26))
+
+
+### Bug Fixes
+
+* **agi:** interface return types ([cc0cfae](https://github.com/railroadmedia/musora-content-services/commit/cc0cfae1282266567ac46a6eb072f76ffde7032e))
+* **BR-330:** Wraps artists name in double quotes where its interpolated in the query ([8787399](https://github.com/railroadmedia/musora-content-services/commit/8787399e032d3522e5126ea9506f28cc5cdac22a))
+* collection type check ([#619](https://github.com/railroadmedia/musora-content-services/issues/619)) ([df520a4](https://github.com/railroadmedia/musora-content-services/commit/df520a497c24091b41d207992a8a71daf0fc98e5))
+* duplicate awards from wrong collection type handling ([#627](https://github.com/railroadmedia/musora-content-services/issues/627)) ([f6dfbf7](https://github.com/railroadmedia/musora-content-services/commit/f6dfbf778ad8e7d37d8e0f66ecd1aa5bec323330))
+* make agi responses standard ([#630](https://github.com/railroadmedia/musora-content-services/issues/630)) ([0301133](https://github.com/railroadmedia/musora-content-services/commit/03011331cb835412af80111a97e6ae83fd6e56d5))
+* method progress card cta ([#622](https://github.com/railroadmedia/musora-content-services/issues/622)) ([6788b48](https://github.com/railroadmedia/musora-content-services/commit/6788b48353d4122e1ca674a5fdd32abbfa8bb642))
+* **onboarding:** update hard-coded data ([e33f309](https://github.com/railroadmedia/musora-content-services/commit/e33f309d0b051829e58f631f4b1368501bafc72b))
+* show next learning path lesson logic for fetch learning path lessons ([#626](https://github.com/railroadmedia/musora-content-services/issues/626)) ([2925a5b](https://github.com/railroadmedia/musora-content-services/commit/2925a5be42715af7f77720209ef78f118ae95bf4))
+* watermelon fixes round [#4](https://github.com/railroadmedia/musora-content-services/issues/4) ([#621](https://github.com/railroadmedia/musora-content-services/issues/621)) ([aa1e834](https://github.com/railroadmedia/musora-content-services/commit/aa1e834dbb287e4b581b67690038e086eb7a4d55))
+
 ## [2.97.0](https://github.com/railroadmedia/musora-content-services/compare/v2.96.2...v2.97.0) (2025-12-09)
 
 

package/package.json

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

package/src/contentTypeConfig.js

@@ -6,21 +6,19 @@ export const AWSUrl = 'https://s3.us-east-1.amazonaws.com/musora-web-platform'
 export const CloudFrontURl = 'https://d3fzm1tzeyr5n3.cloudfront.net'
 
 // This is used to pull related content by license, so we only show "consumable" content
-export const SONG_TYPES = ['song', 'play-along', 'jam-track', 'song-tutorial-children']
+export const SONG_TYPES = ['song', 'play-along', 'jam-track', 'song-tutorial-lesson']
 // Oct 2025: It turns out content-meta categories are not really clear
 // THis is used for the page_type field as a post processor so we include parents and children
 // Duplicated in SanityGateway.php if you update this, update that
 export const SONG_TYPES_WITH_CHILDREN = [
   'song',
-  'song-part',
   'play-along',
-  'play-along-part',
   'jam-track',
   'song-tutorial',
-  'song-tutorial-children',
+  'song-tutorial-lesson',
 ]
 // Single hierarchy refers to only one element in the hierarchy has video lessons, not that they have a single parent
-export const SINGLE_PARENT_TYPES = ['course-part', 'pack-bundle-lesson', 'song-tutorial-children']
+export const SINGLE_PARENT_TYPES = ['course-lesson', 'pack-bundle-lesson', 'song-tutorial-lesson']
 
 export const genreField = `genre[]->{
   name,
@@ -175,7 +173,7 @@ export const showsTypes = {
 
 export const coachLessonsTypes = [
   'course',
-  'course-part',
+  'course-lesson',
   'coach-stream',
   'student-focus',
   'quick-tips',
@@ -183,7 +181,7 @@ export const coachLessonsTypes = [
   'semester-pack',
   'question-and-answer',
   'song-tutorial',
-  'song-tutorial-children',
+  'song-tutorial-lesson',
   'workout',
 ]
 
@@ -192,15 +190,8 @@ export const childContentTypeConfig = {
 }
 
 export const singleLessonTypes = ['quick-tips', 'rudiment']
-export const practiceAlongsLessonTypes = ['workout'] // challenges ->workouts
+export const practiceAlongsLessonTypes = ['workout']
 export const performancesLessonTypes = ['performance']
-export const documentariesLessonTypes = [
-  'tama',
-  'sonor',
-  'history-of-electronic-drums',
-  'paiste-cymbals',
-  'backstage-secret',
-]
 export const liveArchivesLessonTypes = [
   'podcast',
   'coach-stream',
@@ -235,16 +226,18 @@ export const skillLessonTypes = ['skill-pack']
 
 export const showsLessonTypes = [
   'boot-camp',
-  'diy-drum-experiment',
-  'exploring-beats',
-  'in-rhythm',
-  'rhythmic-adventures-of-captain-carson',
-  'rhythms-from-another-planet',
   'study-the-greats',
+  // TODO these require clearing the information with Chris, they weren't part of the old system, but are part of the migration document as SHOWS
+  // 'gear-guide',
+  // 'odd-times',
+  // 'podcast',
+  // 'spotlight',
+  // 'study-the-greats',
+  // 'performance',
 ]
 export const entertainmentLessonTypes = [
-  'specials', // TODO: new type
-  ...documentariesLessonTypes,
+  'special',
+  'documentary-lesson',
   ...showsLessonTypes,
 ]
 export const collectionLessonTypes = [...coursesLessonTypes, ...showsLessonTypes]
@@ -255,7 +248,7 @@ export const lessonTypesMapping = {
   'live archives': liveArchivesLessonTypes,
   performances: performancesLessonTypes,
   'student archives': studentArchivesLessonTypes,
-  documentaries: documentariesLessonTypes,
+  documentaries: ['documentary-lesson'],
   courses: ['course'],
   'guided courses': ['guided-course'],
   'tiered courses': ['tiered-course'],
@@ -296,20 +289,20 @@ export const progressTypesMapping = {
     ...liveArchivesLessonTypes,
     ...performancesLessonTypes,
     ...studentArchivesLessonTypes,
-    ...documentariesLessonTypes,
+    'documentary-lesson',
     'live',
     'pack-bundle-lesson',
   ],
   course: ['course'],
   show: showsLessonTypes,
-  'song tutorial': [...tutorialsLessonTypes, 'song-tutorial-children'],
+  'song tutorial': [...tutorialsLessonTypes, 'song-tutorial-lesson'],
   songs: transcriptionsLessonTypes,
   'play along': playAlongLessonTypes,
   'guided course': ['guided-course'],
   pack: ['pack', 'semester-pack'],
   'learning path': ['learning-path-v2'],
   'jam track': jamTrackLessonTypes,
-  'course video': ['course-part'],
+  'course video': ['course-lesson'],
 }
 
 export const songs = {
@@ -341,9 +334,9 @@ export const filterTypes = {
 export const recentTypes = {
   lessons: [
     ...individualLessonsTypes,
-    'course-part',
+    'course-lesson',
     'pack-bundle-lesson',
-    'guided-course-part',
+    'guided-course-lesson',
     'quick-tips',
   ],
   songs: [...SONG_TYPES],
@@ -420,7 +413,7 @@ export let contentTypeConfig = {
       },
     },
   },
-  'song-tutorial-children': {
+  'song-tutorial-lesson': {
     fields: [`"resources": ${resourcesField}`],
   },
   'guided-course': {
@@ -633,7 +626,7 @@ export let contentTypeConfig = {
   live: { ...contentWithInstructorsField, slug: 'live-streams' },
   solo: { ...contentWithInstructorsField, slug: 'solos' },
   'boot-camp': contentWithInstructorsField,
-  'gear-guids': contentWithInstructorsField,
+  'gear-guide': contentWithInstructorsField,
   performance: contentWithInstructorsField,
   challenges: contentWithInstructorsField,
   'on-the-road': contentWithInstructorsField,

package/src/filterBuilder.js

@@ -67,6 +67,7 @@ export class FilterBuilder {
 
     if (this.debug) console.log('baseFilter', this.filter)
     const filter = this._applyContentStatuses()
+      ._removeDeprecatedContent()
       ._applyPermissions()
       ._applyPublishingDateRestrictions()
       ._trimAmpersands().filter // just in case
@@ -83,6 +84,13 @@ export class FilterBuilder {
     return new Date(now.getFullYear(), now.getMonth(), now.getDate(), now.getHours(), 1)
   }
 
+  _removeDeprecatedContent() {
+    this._andWhere(
+      `!defined(${this.prefix}deprecated_railcontent_id)`
+    )
+    return this
+  }
+
   _applyContentStatuses() {
     // This must be run before _applyPublishDateRestrictions()
     if (this.bypassStatuses) return this

package/src/index.d.ts

@@ -352,6 +352,7 @@ import {
 import {
 	fetchMemberships,
 	fetchRechargeTokens,
+	getUpgradePrice,
 	restorePurchases,
 	upgradeSubscription
 } from './services/user/memberships.ts';
@@ -620,6 +621,7 @@ declare module 'musora-content-services' {
 		getTabResults,
 		getTimeRemainingUntilLocal,
 		getToday,
+		getUpgradePrice,
 		getUserData,
 		getUserMonthlyStats,
 		getUserSignature,

package/src/index.js

@@ -356,6 +356,7 @@ import {
 import {
 	fetchMemberships,
 	fetchRechargeTokens,
+	getUpgradePrice,
 	restorePurchases,
 	upgradeSubscription
 } from './services/user/memberships.ts';
@@ -619,6 +620,7 @@ export {
 	getTabResults,
 	getTimeRemainingUntilLocal,
 	getToday,
+	getUpgradePrice,
 	getUserData,
 	getUserMonthlyStats,
 	getUserSignature,

package/src/services/user/memberships.ts

@@ -218,3 +218,35 @@ export async function restorePurchases(
     requestBody
   )
 }
+
+/**
+ * Get the upgrade price from Basic to Plus membership.
+ * Returns the price based on the user's subscription interval.
+ *
+ * For monthly subscribers: Returns the monthly upgrade cost (difference between Plus and Base monthly prices, ~$5/month)
+ * For yearly subscribers: Returns the monthly equivalent upgrade cost ($3.33/month from $40/year)
+ * For lifetime subscribers: Returns the annual upgrade cost for songs add-on ($40/year)
+ * If interval cannot be determined: Defaults to monthly price
+ *
+ * @returns {Promise<{price: number, currency: string, period: string|null}>} - The upgrade price information
+ * @property {number} price - The upgrade cost in USD (monthly for month/year, annual for lifetime)
+ * @property {string} currency - The currency 
+ * @property {string|null} period - The billing period for the price ('month' or 'year'). Note: lifetime subscribers return 'year' period with annual price
+ *
+ * @example
+ * getUpgradePrice()
+ *   .then(info => {
+ *     console.log(`Upgrade price: $${info.price} per ${info.period}`)
+ *     // Example outputs:
+ *     // Monthly: "Upgrade price: $5 per month"
+ *     // Yearly: "Upgrade price: $3.33 per month"
+ *     // Lifetime: "Upgrade price: $40 per year"
+ *   })
+ *   .catch(error => {
+ *     console.error('Failed to fetch upgrade price:', error)
+ *   })
+ */
+export async function getUpgradePrice() {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return  httpClient.get(`${baseUrl}/v1/upgrade-price`)
+}

package/src/services/userActivity.js

@@ -922,7 +922,7 @@ async function extractPinnedItemsAndSortAllItems(
 }
 
 function generateContentsMap(contents, playlistsContents) {
-  const excludedTypes = new Set(['pack-bundle', 'guided-course-part'])
+  const excludedTypes = new Set(['pack-bundle', 'guided-course-lesson'])
   const existingShows = new Set()
   const contentsMap = new Map()
   const childToParentMap = {}
@@ -1097,7 +1097,8 @@ async function processContentItem(content) {
     const progressTimestamp = content.progressTimestamp
     const wasPinned = content.pinned ?? false
     if (content.progressStatus === 'completed') {
-      // this could be handled more gracefully if their was a parent content type for shows
+      // this could be handled more gracefully if there was a parent content type for shows
+      // Update Dec 3rd. We updated almost everything to the DocumentaryType :D, but there's still a few
       const nextByProgress = findIncompleteLesson(progressOnItems, content.id, content.type)
       content = shows.find((lesson) => lesson.id === nextByProgress)
       content.completed_children = completedShows

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(rg:*)",
-      "Bash(npm run lint:*)"
-    ],
-    "deny": []
-  }
-}