musora-content-services 2.160.5 → 2.161.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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.161.2](https://github.com/railroadmedia/musora-content-services/compare/v2.161.1...v2.161.2) (2026-05-27)
+
+### [2.161.1](https://github.com/railroadmedia/musora-content-services/compare/v2.161.0...v2.161.1) (2026-05-27)
+
+## [2.161.0](https://github.com/railroadmedia/musora-content-services/compare/v2.160.5...v2.161.0) (2026-05-27)
+
+
+### Features
+
+* **BEHLTP-106:** membership data upgrade ([#973](https://github.com/railroadmedia/musora-content-services/issues/973)) ([e1e0611](https://github.com/railroadmedia/musora-content-services/commit/e1e0611c13bdf4be920eb28cca1f15f912930d24))
+
 ### [2.160.5](https://github.com/railroadmedia/musora-content-services/compare/v2.160.4...v2.160.5) (2026-05-22)
 
 

package/package.json

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

package/src/services/multi-user-accounts/multi-user-accounts.ts

@@ -28,7 +28,7 @@ export interface InviteResponse {
   email?: string
 }
 
-export interface UsersMultiAccountResponse {
+export interface UsersDataForMultiUserAccount {
   user_id: number
   active_multi_user_account: MultiUserAccountResponse
   last_cancelled_multi_user_account: MultiUserAccountResponse
@@ -42,13 +42,15 @@ export interface MultiUserAccountResponse {
   product_name: string
   is_active: boolean
   primary_user: User
-  total_seats: number
   end_time: string
   is_primary_account_holder: boolean
+  membership_level: 'plus' | 'basic'
+  is_lifetime_addon: boolean
   // The following fields are not included for public or subaccount users
-  active_invited_emails?: InviteResponse[]
+  active_invites?: InviteResponse[]
   available_seats?: number
-  available_invites?: InviteResponse[]
+  available_invites?: number
+  total_seats?: number
   active_subs?: User[]
   show_welcome?: boolean
 }
@@ -83,12 +85,12 @@ export async function createAccount(params: CreateAccountParams): Promise<MultiU
  * Fetches multi-user account details for a specific user.
  *
  * @param {number} userId - The ID of the user to fetch account details for.
- * @returns {Promise<UsersMultiAccountResponse>} - A promise that resolves to the account details.
+ * @returns {Promise<UsersDataForMultiUserAccount>} - A promise that resolves to the account details.
  * @throws {HttpError} - If the HTTP request fails.
  */
-export async function fetchUsersMultiAccountDetails(userId: number): Promise<UsersMultiAccountResponse> {
+export async function fetchUsersMultiAccountDetails(userId: number): Promise<UsersDataForMultiUserAccount> {
   const httpClient = new HttpClient(globalConfig.baseUrl)
-  return httpClient.get<UsersMultiAccountResponse>(`${baseUrl}/${userId}/details`)
+  return httpClient.get<UsersDataForMultiUserAccount>(`${baseUrl}/${userId}/details`)
 }
 
 

package/src/services/user/memberships.ts

@@ -4,22 +4,27 @@
 import './types.js'
 import { HttpClient } from '../../infrastructure/http/HttpClient'
 import { globalConfig } from '../config'
+import { MultiUserAccountResponse } from "../multi-user-accounts/multi-user-accounts";
 
 const baseUrl = `/api/user-memberships`
+// Magic stringed to MembershipController.php
+const multiUserAccountFeatureFlag = 'multi_user_account_feature_flag'
 
-/**
- * Represents a user membership object
- */
-export interface Membership {
-  id: number
-  user_id: number
-  membership_type: string
-  start_date: string
-  expiration_date: string | null
-  status: string
-  created_at: string
-  updated_at: string
-  [key: string]: any
+// Active Purchased Subscription Data
+export interface MembershipData {
+  type: string
+  name: string
+  expiration_date: string
+  is_in_trial: boolean
+  trial_duration: string
+  never_expires: boolean
+}
+
+export interface UserMembershipResponse {
+  user_membership_data: MembershipData[]
+  can_upgrade_membership: boolean // pre multiUserAccount data
+  sub_account_data: MultiUserAccountResponse // post multiUserAccount data
+  upgrade_options: UpgradeOption[] // post multiuser account data
 }
 
 /**
@@ -32,15 +37,28 @@ export interface RechargeTokens {
   storefront_access_token: string
 }
 
-/**
- * Represents the response from subscription upgrade
- */
 export interface UpgradeSubscriptionResponse {
   action: 'instant_upgrade' | 'shopify'
   message?: string
   url?: string
 }
 
+export interface UpgradeProduct {
+  id: number
+  name: string
+  sku: string
+  price: number
+  monthly_price: number
+  includes_trial: boolean
+}
+
+export interface UpgradeOption {
+  annual_savings: number
+  lowest_monthly_cost: number
+  products: UpgradeProduct[] // annual + monthly products, or solely annual product with the same configuration information
+}
+
+
 /**
  * Represents the response when user should create an account (no entitlements or user not found)
  */
@@ -93,21 +111,9 @@ export type RestorePurchasesResponse =
   | RestorePurchasesSuccessResponse
   | RestorePurchasesSetupAccountResponse
 
-/**
- * Fetches the authenticated user's memberships from the API.
- *
- * @returns {Promise<Array<Membership>>} - A promise that resolves to an array of membership objects.
- *
- * @throws {Error} - Throws an error if the request fails.
- *
- * @example
- * fetchMemberships()
- *   .then(memberships => console.log(memberships))
- *   .catch(error => console.error(error));
- */
-export async function fetchMemberships(): Promise<Membership[]> {
+export async function fetchMemberships(): Promise<UserMembershipResponse> {
   const httpClient = new HttpClient(globalConfig.baseUrl)
-  return httpClient.get<Membership[]>(`${baseUrl}/v1`)
+  return httpClient.get<UserMembershipResponse>(`${baseUrl}/v1`)
 }
 
 /**
@@ -134,6 +140,8 @@ export async function fetchRechargeTokens(): Promise<RechargeTokens> {
 /**
  * Upgrades the user's subscription or provides a prefilled add-to-cart URL.
  *
+ * @param {boolean} featureFlag - MultiUserAccount feature Flag - default false
+ *
  * @returns {Promise<UpgradeSubscriptionResponse>} A promise that resolves to an object containing either:
  *  - {string} action - The action performed (e.g., 'instant_upgrade').
  *  - {string} message - Success message if the subscription was upgraded immediately.
@@ -148,9 +156,10 @@ export async function fetchRechargeTokens(): Promise<RechargeTokens> {
  *   .then(response => console.log(response))
  *   .catch(error => console.error(error));
  */
-export async function upgradeSubscription(): Promise<UpgradeSubscriptionResponse> {
+export async function upgradeSubscription(featureFlag = false): Promise<UpgradeSubscriptionResponse> {
+  let featureFlagValue = featureFlag ? 1 : 0
   const httpClient = new HttpClient(globalConfig.baseUrl)
-  return httpClient.get<UpgradeSubscriptionResponse>(`${baseUrl}/v1/update-subscription`)
+  return httpClient.get<UpgradeSubscriptionResponse>(`${baseUrl}/v1/update-subscription?${multiUserAccountFeatureFlag}=${featureFlagValue}`)
 }
 
 /**
@@ -231,6 +240,8 @@ export async function restorePurchases(
  * Get the upgrade price from Basic to Plus membership.
  * Returns the price based on the user's subscription interval.
  *
+ * @param {boolean} featureFlag - MultiUserAccount feature Flag - default false
+ *
  * 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)
@@ -254,9 +265,10 @@ export async function restorePurchases(
  *     console.error('Failed to fetch upgrade price:', error)
  *   })
  */
-export async function getUpgradePrice() {
+export async function getUpgradePrice(featureFlag = false) {
+  let featureFlagValue = featureFlag ? 1 : 0
   const httpClient = new HttpClient(globalConfig.baseUrl)
-  return  httpClient.get(`${baseUrl}/v1/upgrade-price`)
+  return  httpClient.get(`${baseUrl}/v1/upgrade-price?${multiUserAccountFeatureFlag}=${featureFlagValue}`)
 }
 
 /**

package/.claude/settings.local.json

@@ -1,23 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx jest *)",
-      "Bash(npx tsc *)",
-      "Skill(counselors)",
-      "Bash(counselors ls *)",
-      "Bash(counselors groups *)",
-      "Bash(counselors run *)",
-      "Bash(npm test *)",
-      "Bash(gh pr *)",
-      "Bash(gh api *)",
-      "Bash(mkdir -p /tmp/pr-review-v2)",
-      "Read(//tmp/pr-review-v2/**)",
-      "Bash(cat /home/alesevero/railenvironment/applications/musora-content-services/AGENTS.md)",
-      "Bash(echo \"no AGENTS.md\")",
-      "Bash(echo \"exit=$?\")",
-      "Bash(git checkout *)",
-      "Skill(pr)",
-      "Skill(create-decision)"
-    ]
-  }
-}