musora-content-services 2.189.0 → 2.190.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.190.0](https://github.com/railroadmedia/musora-content-services/compare/v2.189.0...v2.190.0) (2026-10-20)
+
+
+### Features
+
+* **MU2-2024:** resolve placement copy in fetchAvailablePromotionalCampaigns ([ac69d37](https://github.com/railroadmedia/musora-content-services/commit/ac69d379a264e031b1f5bd999b6bed8c78fbfb58))
+
 ## [2.189.0](https://github.com/railroadmedia/musora-content-services/compare/v2.188.0...v2.189.0) (2026-10-20)
 
 

package/package.json

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

package/src/index.d.ts

@@ -222,7 +222,7 @@ import {
 	fetchAvailablePromotionalCampaigns,
 	fetchPromotionalCampaigns,
 	fetchUserCampaignStates,
-	resolveCampaignCopy
+	resolveCampaignPlaceholders
 } from './services/marketing/promotions.ts';
 
 import {
@@ -902,7 +902,7 @@ declare module 'musora-content-services' {
 		resetAllAwards,
 		resetAllLearningPaths,
 		resetPassword,
-		resolveCampaignCopy,
+		resolveCampaignPlaceholders,
 		restoreComment,
 		restoreItemFromPlaylist,
 		restoreNotification,

package/src/index.js

@@ -226,7 +226,7 @@ import {
 	fetchAvailablePromotionalCampaigns,
 	fetchPromotionalCampaigns,
 	fetchUserCampaignStates,
-	resolveCampaignCopy
+	resolveCampaignPlaceholders
 } from './services/marketing/promotions.ts';
 
 import {
@@ -901,7 +901,7 @@ export {
 	resetAllAwards,
 	resetAllLearningPaths,
 	resetPassword,
-	resolveCampaignCopy,
+	resolveCampaignPlaceholders,
 	restoreComment,
 	restoreItemFromPlaylist,
 	restoreNotification,

package/src/services/marketing/promotions.ts

@@ -63,6 +63,11 @@ export interface CampaignQueryOptions {
   active?: boolean
 }
 
+export interface AvailableCampaignOptions extends CampaignQueryOptions {
+  /** Values for the `{name}` placeholders in placement copy. See `resolveCampaignPlaceholders`. */
+  placeholderValues?: CampaignPlaceholderValues
+}
+
 const UNTOUCHED: UserCampaignState = { claimed: false, dismissed: false, eligible: true }
 
 // ============================================
@@ -126,12 +131,17 @@ export async function fetchPromotionalCampaigns(
  * Every running campaign the user has not already claimed or dismissed, and is eligible.
  */
 export async function fetchAvailablePromotionalCampaigns(
-  options: CampaignQueryOptions = {}
+  options: AvailableCampaignOptions = {}
 ): Promise<WithUserCampaignState<PromotionalCampaign>[]> {
-  return campaignQuery(options)
+  const { placeholderValues = {}, ...queryOptions } = options
+
+  return campaignQuery(queryOptions)
     .run()
     .flatMap(decorateUserCampaignState)
     .map(filterCampaignsForUser)
+    .map((campaigns) =>
+      campaigns.map((campaign) => resolveCampaignPlaceholders(campaign, placeholderValues))
+    )
     .recover([])
 }
 
@@ -184,23 +194,23 @@ export function decorateUserCampaignState<T extends PromotionalCampaign>(
 }
 
 // ============================================
-// COPY
+// PLACEHOLDERS
 // ============================================
 
-export type CampaignCopyValues = Record<string, string>
+export type CampaignPlaceholderValues = Record<string, string>
 
 const PLACEHOLDER = /\{(\w+)\}/g
 
 const COPY_FIELDS = ['title', 'body', 'disclaimer', 'cta_label'] as const
 
-const fillPlaceholders = (text: string, values: CampaignCopyValues) =>
+const fillPlaceholders = (text: string, values: CampaignPlaceholderValues) =>
   text.replace(PLACEHOLDER, (placeholder, name: string) => values[name] ?? placeholder)
 
 const hasPlaceholder = (text: string | undefined) => !!text && new RegExp(PLACEHOLDER).test(text)
 
-function resolvePlacementCopy(
+function resolvePlacementPlaceholders(
   placement: PromotionalCampaignPlacement,
-  values: CampaignCopyValues
+  values: CampaignPlaceholderValues
 ): PromotionalCampaignPlacement {
   const resolved = { ...placement }
 
@@ -215,14 +225,14 @@ function resolvePlacementCopy(
  * Replaces `{name}` placeholders in each placement's copy with the given values. A placement left
  * with a placeholder that has no value is dropped, so raw `{name}` text never reaches the user.
  */
-export function resolveCampaignCopy<T extends PromotionalCampaign>(
+export function resolveCampaignPlaceholders<T extends PromotionalCampaign>(
   campaign: T,
-  values: CampaignCopyValues
+  values: CampaignPlaceholderValues
 ): T {
   return {
     ...campaign,
-    placements: campaign.placements
-      .map((placement) => resolvePlacementCopy(placement, values))
+    placements: (campaign.placements ?? [])
+      .map((placement) => resolvePlacementPlaceholders(placement, values))
       .filter((placement) => !COPY_FIELDS.some((field) => hasPlaceholder(placement[field]))),
   }
 }

package/src/version-info.js

@@ -1 +1 @@
-export const MCS_VERSION = '2.189.0'
+export const MCS_VERSION = '2.190.0'