musora-content-services 2.164.6 → 2.165.0

package/.claude/settings.local.json

@@ -16,7 +16,9 @@
       "Bash(grep:*)",
       "Bash(gh api repos/railroadmedia/musora-platform-backend/commits/1f9878a5e681bf1e2233c0d59a618d477b118c49 --jq '.commit.message' 2>/dev/null || echo \"no access\")",
       "WebFetch(domain:github.com)",
-      "Read(//app/**)"
+      "Read(//app/**)",
+      "Bash(git -C /app/musora-platform-backend log --oneline main..HEAD)",
+      "Bash(git -C /app/musora-platform-backend diff main..HEAD --name-only)"
     ]
   }
 }

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.165.0](https://github.com/railroadmedia/musora-content-services/compare/v2.164.6...v2.165.0) (2026-06-18)
+
+
+### Features
+
+* **BEHSTP-370:** add need_lifetime_upgrade flag on documents and grant30DaysAccessForLifetime method ([2dd8bed](https://github.com/railroadmedia/musora-content-services/commit/2dd8bedf71a543599a0c421d7eea99cae3bf156c))
+
+
+### Bug Fixes
+
+* add method for progress types mapping ([#998](https://github.com/railroadmedia/musora-content-services/issues/998)) ([9830710](https://github.com/railroadmedia/musora-content-services/commit/9830710893e85f3680286fc5abdc23d1cbf47580))
+
 ### [2.164.6](https://github.com/railroadmedia/musora-content-services/compare/v2.164.5...v2.164.6) (2026-06-10)
 
 ### [2.164.5](https://github.com/railroadmedia/musora-content-services/compare/v2.164.4...v2.164.5) (2026-06-10)

package/package.json

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

package/src/contentTypeConfig.js

@@ -73,6 +73,7 @@ export const DEFAULT_FIELDS = [
   'live_event_end_time',
   'enrollment_start_time',
   'enrollment_end_time',
+  'membership_tier',
 ]
 
 // these are identical... why
@@ -328,6 +329,7 @@ export const progressTypesMapping = {
     'course-lesson',
     'routine',
   ],
+  method: [LEARNING_PATH_LESSON],
   course: ['course'],
   show: showsLessonTypes,
   'song tutorial': [...tutorialsLessonTypes, 'song-tutorial-lesson'],
@@ -695,9 +697,7 @@ export let contentTypeConfig = {
     }`,
   ],
   'new-and-scheduled': {
-    fields: [
-      'show_in_new_feed',
-    ],
+    fields: ['show_in_new_feed'],
     includeChildFields: true,
   },
 }

package/src/index.d.ts

@@ -428,6 +428,7 @@ import {
 	fetchMemberships,
 	fetchRechargeTokens,
 	getUpgradePrice,
+	grant30DaysAccessForLifetime,
 	restorePurchases,
 	upgradeSubscription
 } from './services/user/memberships.ts';
@@ -742,6 +743,7 @@ declare module 'musora-content-services' {
 		getUserWeeklyStats,
 		getWeekNumber,
 		globalConfig,
+		grant30DaysAccessForLifetime,
 		guidedCourses,
 		hasAnyMethodV2IntroCompleted,
 		initializeEnvVar,

package/src/index.js

@@ -432,6 +432,7 @@ import {
 	fetchMemberships,
 	fetchRechargeTokens,
 	getUpgradePrice,
+	grant30DaysAccessForLifetime,
 	restorePurchases,
 	upgradeSubscription
 } from './services/user/memberships.ts';
@@ -741,6 +742,7 @@ export {
 	getUserWeeklyStats,
 	getWeekNumber,
 	globalConfig,
+	grant30DaysAccessForLifetime,
 	guidedCourses,
 	hasAnyMethodV2IntroCompleted,
 	initializeEnvVar,

package/src/lib/sanity/decorators/need-lifetime-upgrade.ts

@@ -0,0 +1,48 @@
+import { decorate, type FieldDecorator } from './base'
+import { type UserPermissions } from '../../../services/permissions'
+import { type AccessDecoratable } from './need-access'
+import { MEMBERSHIP_PERMISSIONS } from '../../../constants/membership-permissions'
+
+export const NEED_LIFETIME_UPGRADE_FIELD = 'need_lifetime_upgrade' as const
+
+type LifetimeUpgradeDecoratable = AccessDecoratable & { need_access?: boolean; membership_tier?: string }
+
+export type WithNeedLifetimeUpgrade<T extends AccessDecoratable> = T & {
+  need_lifetime_upgrade: boolean
+  children?: WithNeedLifetimeUpgrade<NonNullable<T['children']>[number]>[]
+}
+
+export function lifetimeUpgradeDecorator(
+  userPermissions: UserPermissions
+): FieldDecorator<LifetimeUpgradeDecoratable, typeof NEED_LIFETIME_UPGRADE_FIELD, boolean> {
+  const userPermSet = new Set(userPermissions?.permissions ?? [])
+  const hasLifetime = userPermSet.has(MEMBERSHIP_PERMISSIONS.lifetime)
+  const hasPlus = userPermSet.has(MEMBERSHIP_PERMISSIONS.plus)
+
+  return {
+    field: NEED_LIFETIME_UPGRADE_FIELD,
+    compute: (item) => {
+      if (userPermissions?.isAdmin || !hasLifetime || hasPlus) return false
+      if (!item.need_access) return false
+      return item.membership_tier === 'plus'
+      },
+  }
+}
+
+export function decorateLifetimeUpgrade<T extends LifetimeUpgradeDecoratable>(
+  items: T[],
+  userPermissions: UserPermissions
+): WithNeedLifetimeUpgrade<T>[]
+export function decorateLifetimeUpgrade<T extends LifetimeUpgradeDecoratable>(
+  items: T,
+  userPermissions: UserPermissions
+): WithNeedLifetimeUpgrade<T>
+export function decorateLifetimeUpgrade<T extends LifetimeUpgradeDecoratable>(
+  items: T | T[],
+  userPermissions: UserPermissions
+): WithNeedLifetimeUpgrade<T> | WithNeedLifetimeUpgrade<T>[] {
+  const { field, compute } = lifetimeUpgradeDecorator(userPermissions)
+  return decorate(items as T, field, compute) as
+    | WithNeedLifetimeUpgrade<T>
+    | WithNeedLifetimeUpgrade<T>[]
+}

package/src/services/content/content.ts

@@ -40,5 +40,6 @@ export interface Lesson {
   title: string
   type: LessonType
   need_access: boolean
+  need_lifetime_upgrade: boolean
   page_type: LessonPageType
 }

package/src/services/sanity.js

@@ -46,6 +46,7 @@ import { globalConfig } from './config.js'
 
 import { arrayToStringRepresentation, FilterBuilder } from '../filterBuilder.js'
 import { getPermissionsAdapter } from './permissions/index.ts'
+import { lifetimeUpgradeDecorator, NEED_LIFETIME_UPGRADE_FIELD } from '../lib/sanity/decorators/need-lifetime-upgrade.ts'
 import {
   getAllCompleted,
   getAllCompletedByIds,
@@ -1639,6 +1640,7 @@ export async function fetchSanity(
         return null
       }
       results = processNeedAccess ? await needsAccessDecorator(results, userPermissions) : results
+      results = processNeedAccess ? needsLifetimeUpgradeDecorator(results, userPermissions) : results
       results = processPageType ? pageTypeDecorator(results) : results
       return customPostProcess ? customPostProcess(results) : results
     } else {
@@ -1734,6 +1736,12 @@ function needsAccessDecorator(results, userPermissions) {
   })
 }
 
+function needsLifetimeUpgradeDecorator(results, userPermissions) {
+  if (globalConfig.sanityConfig.useDummyRailContentMethods) return results
+  const { compute } = lifetimeUpgradeDecorator(userPermissions)
+  return contentResultsDecorator(results, NEED_LIFETIME_UPGRADE_FIELD, compute)
+}
+
 function doesUserNeedAccessToContent(result, userPermissions) {
   // Legacy function - now delegates to adapter
   // Kept for backwards compatibility if used elsewhere

package/src/services/user/memberships.ts

@@ -50,7 +50,9 @@ export interface UpgradeProduct {
   price: number
   monthly_price: number
   includes_trial: boolean
-  tier: 'plus' | 'basic' | ''
+  tier: 'plus' | 'basic' | '' // deprecated in favour of membership_level
+  membership_level: 'plus' | 'basic' | ''
+  plan_type: 'family' | 'duo' | 'solo'
 }
 
 export interface UpgradeOption {
@@ -289,3 +291,11 @@ export async function fetchHasActivePlatformSubscription(): Promise<boolean> {
   const response = await httpClient.get<SubscriptionPlatform>(`${baseUrl}/v1/subscription-platform`)
   return response.has_active_platform_subscription
 }
+
+/**
+ * @returns {Promise<void>}
+ */
+export async function grant30DaysAccessForLifetime(): Promise<void> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  await httpClient.post<void>(`${baseUrl}/v1/grant-30-days-access-for-lifetime`, {})
+}

package/test/unit/lib/sanity/decorators/need-lifetime-upgrade.test.ts

@@ -0,0 +1,85 @@
+import {
+  NEED_LIFETIME_UPGRADE_FIELD,
+  lifetimeUpgradeDecorator,
+  decorateLifetimeUpgrade,
+} from '../../../../../src/lib/sanity/decorators/need-lifetime-upgrade'
+
+const PLUS = 92
+const LIFETIME = 108
+const BASE = 91
+
+const lifetimeBase = { permissions: [LIFETIME, BASE], isAdmin: false, isModerator: false, isABasicMember: true }
+const lifetimeBasePlus = { permissions: [LIFETIME, BASE, PLUS], isAdmin: false, isModerator: false, isABasicMember: false }
+const baseOnly = { permissions: [BASE], isAdmin: false, isModerator: false, isABasicMember: true }
+
+const plusGatedLocked = { permission_id: [BASE, PLUS], need_access: true, membership_tier: 'plus' }
+const plusGatedUnlocked = { permission_id: [BASE, PLUS], need_access: false, membership_tier: 'plus' }
+
+describe('need-lifetime-upgrade decorator', () => {
+  describe('lifetimeUpgradeDecorator (factory)', () => {
+    test('field is need_lifetime_upgrade', () => {
+      const dec = lifetimeUpgradeDecorator(lifetimeBase)
+      expect(dec.field).toBe('need_lifetime_upgrade')
+      expect(NEED_LIFETIME_UPGRADE_FIELD).toBe('need_lifetime_upgrade')
+    })
+
+    test('true for lifetime member on Plus-gated content they cannot access', () => {
+      const dec = lifetimeUpgradeDecorator(lifetimeBase)
+      expect(dec.compute(plusGatedLocked)).toBe(true)
+    })
+
+    test('false when user already has Plus', () => {
+      const dec = lifetimeUpgradeDecorator(lifetimeBasePlus)
+      expect(dec.compute(plusGatedLocked)).toBe(false)
+    })
+
+    test('false when user does not have lifetime', () => {
+      const dec = lifetimeUpgradeDecorator(baseOnly)
+      expect(dec.compute(plusGatedLocked)).toBe(false)
+    })
+
+    test('false when user already has access to content (need_access false)', () => {
+      const dec = lifetimeUpgradeDecorator(lifetimeBase)
+      expect(dec.compute(plusGatedUnlocked)).toBe(false)
+    })
+  })
+
+  describe('decorateLifetimeUpgrade', () => {
+    test('decorates array of items', () => {
+      const items = [plusGatedLocked, plusGatedUnlocked]
+      const decorated = decorateLifetimeUpgrade(items, lifetimeBase)
+      expect(decorated.map((i) => i.need_lifetime_upgrade)).toEqual([true, false])
+    })
+
+    test('decorates a single item', () => {
+      const decorated = decorateLifetimeUpgrade(plusGatedLocked, lifetimeBase)
+      expect(decorated.need_lifetime_upgrade).toBe(true)
+    })
+
+    test('decorates children recursively', () => {
+      const tree = {
+        permission_id: [BASE, PLUS],
+        need_access: true,
+        membership_tier: 'plus',
+        children: [
+          {
+            permission_id: [BASE, PLUS],
+            need_access: true,
+            membership_tier: 'plus',
+            children: [{ permission_id: [BASE, PLUS], need_access: true, membership_tier: 'plus' }],
+          },
+        ],
+      }
+      const decorated = decorateLifetimeUpgrade(tree, lifetimeBase)
+      expect(decorated.need_lifetime_upgrade).toBe(true)
+      expect(decorated.children![0].need_lifetime_upgrade).toBe(true)
+      expect(decorated.children![0].children![0].need_lifetime_upgrade).toBe(true)
+    })
+
+    test('returns the same reference it was given', () => {
+      const items = [plusGatedLocked]
+      const decorated = decorateLifetimeUpgrade(items, lifetimeBase)
+      expect(decorated).toBe(items)
+    })
+  })
+})