musora-content-services 2.177.1 → 2.178.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 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.178.1](https://github.com/railroadmedia/musora-content-services/compare/v2.178.0...v2.178.1) (2026-08-31)
+
+## [2.178.0](https://github.com/railroadmedia/musora-content-services/compare/v2.177.1...v2.178.0) (2026-08-28)
+
+
+### Features
+
+* **BEHLTP-318:** add sendRevenueCatPurchaseMetadata for MA purchase_intent handoff ([#1037](https://github.com/railroadmedia/musora-content-services/issues/1037)) ([1ba4f9d](https://github.com/railroadmedia/musora-content-services/commit/1ba4f9dd6c171423a7b2a5f775571744450ef3be))
+
 ### [2.177.1](https://github.com/railroadmedia/musora-content-services/compare/v2.177.0...v2.177.1) (2026-08-26)
 
 

package/package.json

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

package/src/index.d.ts

@@ -492,6 +492,10 @@ import {
 	updateProfileVisibility
 } from './services/user/profile.ts';
 
+import {
+	sendRevenueCatPurchaseMetadata
+} from './services/user/revenuecat.ts';
+
 import {
 	listOAuthProviders,
 	loginAsUser,
@@ -859,6 +863,7 @@ declare module 'musora-content-services' {
 		searchAlgolia,
 		sendAccountSetupEmail,
 		sendPasswordResetEmail,
+		sendRevenueCatPurchaseMetadata,
 		setStudentViewForUser,
 		setUserPinnedProgressRow,
 		setUserSignature,

package/src/index.js

@@ -496,6 +496,10 @@ import {
 	updateProfileVisibility
 } from './services/user/profile.ts';
 
+import {
+	sendRevenueCatPurchaseMetadata
+} from './services/user/revenuecat.ts';
+
 import {
 	listOAuthProviders,
 	loginAsUser,
@@ -858,6 +862,7 @@ export {
 	searchAlgolia,
 	sendAccountSetupEmail,
 	sendPasswordResetEmail,
+	sendRevenueCatPurchaseMetadata,
 	setStudentViewForUser,
 	setUserPinnedProgressRow,
 	setUserSignature,

package/src/services/user/memberships.ts

@@ -83,6 +83,7 @@ export interface UpgradeOption {
   annual_savings: number
   lowest_monthly_cost: number
   upgrade_type: string
+  is_prorated_charge: boolean
   products: UpgradeProduct[] // annual + monthly products, or solely annual product with the same configuration information
 }
 

package/src/services/user/revenuecat.ts

@@ -0,0 +1,59 @@
+/**
+ * @module RevenueCat
+ */
+import { HttpClient } from '../../infrastructure/http/HttpClient'
+import { globalConfig } from '../config'
+
+const baseUrl = `/api/revenuecat`
+
+export type RevenueCatPurchaseIntent =
+  | 'new'
+  | 'upgrade_higher_cost'
+  | 'upgrade_lower_cost'
+  | 'downgrade'
+  | 'crossgrade'
+  | 'unknown'
+
+/**
+ * Sends purchase_intent/previous_product_id metadata to BE for a given RevenueCat/Google
+ * transaction, immediately after a purchase completes. Keyed by RC's own transaction id, so BE
+ * can resolve it when the corresponding webhook's resulting order is synced later.
+ *
+ * Safe to retry -- idempotent on BE's side by transaction_id, so a duplicate call after a
+ * network failure is harmless.
+ *
+ * @param transactionId - RC's transactionIdentifier for this purchase (from Purchases.getCustomerInfo())
+ * @param purchaseIntent - The classification determined before the purchase was initiated
+ * @param previousProductId - The RC product id being upgraded/downgraded/crossgraded from, if applicable
+ * @returns {Promise<void>}
+ * @throws {Error} - Throws an error if the request fails or if required parameters are missing.
+ *
+ * @example
+ * sendRevenueCatPurchaseMetadata('GPA.3378-5280-5022-02864', 'upgrade_higher_cost', 'musora_subscription:annual-plus')
+ *   .catch(error => console.error(error));
+ */
+export async function sendRevenueCatPurchaseMetadata(
+  transactionId: string,
+  purchaseIntent: RevenueCatPurchaseIntent,
+  previousProductId?: string | null
+): Promise<void> {
+  if (!transactionId) {
+    throw new Error('transactionId is a required parameter')
+  }
+  if (!purchaseIntent) {
+    throw new Error('purchaseIntent is a required parameter')
+  }
+
+  const requestBody: { transaction_id: string; purchase_intent: string; previous_product_id?: string } = {
+    transaction_id: transactionId,
+    purchase_intent: purchaseIntent
+  }
+
+  // Only include previous_product_id if it has a valid value
+  if (previousProductId) {
+    requestBody.previous_product_id = previousProductId
+  }
+
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  await httpClient.post<void>(`${baseUrl}/v1/purchase-metadata`, requestBody)
+}

package/src/version-info.js

@@ -1 +1 @@
-export const MCS_VERSION = '2.177.1'
+export const MCS_VERSION = '2.178.1'