musora-content-services 2.167.0 → 2.167.2

package/.agent/decisions/2026-07-17-onboarding-statuses.md

@@ -0,0 +1,21 @@
+---
+date: 2026-07-17
+branch: chore/onboarding-statuses
+pr: https://github.com/railroadmedia/musora-content-services/pull/1011
+status: open
+tags: [[feature]]
+---
+
+# Add cross-brand onboarding status endpoint
+
+## Context
+`userOnboardingForBrand(brand)` only returns onboarding state for one brand at a time. Callers that need to know onboarding completion across all brands (e.g. Drumeo, Pianote, Guitareo, Singeo) for a user had no single call to get that.
+
+## Decision
+Added `getOnboardingStatus()` in `src/services/user/onboarding.ts`, hitting `GET /api/user-management-system/v1/users/{userId}/onboardings/status`. Returns `OnboardingStatus`: `has_completed_onboarding` plus a `brands: OnboardingBrandStatus[]` array (`brand`, `is_completed`, `completed_flow`, `completed_at`). Ran `npm run build-index` to regenerate `index.js`/`index.d.ts` so the new function is exported from the package.
+
+## Alternatives Considered
+No alternatives considered — this is additive to the existing per-brand `userOnboardingForBrand` function, not a replacement.
+
+## Consequences
+Consumers (musora-platform-frontend, MusoraApp) can now fetch all-brand onboarding status in a single request instead of looping `userOnboardingForBrand` per brand.

package/.claude/settings.local.json

@@ -1,24 +1,53 @@
 {
   "permissions": {
     "allow": [
-      "Bash(tree:*)",
-      "Bash(find:*)",
-      "Bash(docker exec:*)",
-      "Bash(node:*)",
-      "Bash(npm run build-index:*)",
-      "Bash(npm run link_mcs:*)",
-      "Bash(./link_mcs.sh:*)",
-      "Bash(curl:*)",
-      "Bash(php artisan:*)",
-      "Bash(git checkout:*)",
-      "Bash(source .env)",
-      "Bash(echo:*)",
-      "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/**)",
-      "Bash(git -C /app/musora-platform-backend log --oneline main..HEAD)",
-      "Bash(git -C /app/musora-platform-backend diff main..HEAD --name-only)"
+      "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)",
+      "mcp__github__pull_request_read",
+      "mcp__github__push_files",
+      "Bash(git push *)",
+      "mcp__github__create_pull_request",
+      "mcp__github__search_pull_requests",
+      "Bash(git commit *)",
+      "Bash(git add *)",
+      "mcp__github__list_pull_requests"
     ]
-  }
+  },
+  "model": "sonnet",
+  "enabledMcpjsonServers": [
+    "atlassian",
+    "figma",
+    "google-workspace",
+    "snowflake",
+    "aws",
+    "hex",
+    "sanity",
+    "mysql",
+    "slack",
+    "langfuse",
+    "chrome-devtools",
+    "railway",
+    "github",
+    "asana"
+  ],
+  "disabledMcpjsonServers": [
+    "nightwatch",
+    "1password"
+  ],
+  "effortLevel": "medium"
 }

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.167.2](https://github.com/railroadmedia/musora-content-services/compare/v2.167.1...v2.167.2) (2026-07-17)
+
+
+### Bug Fixes
+
+* **BEHLTP-210:** add non-destructive notification polling pause ([#1009](https://github.com/railroadmedia/musora-content-services/issues/1009)) ([3c0d783](https://github.com/railroadmedia/musora-content-services/commit/3c0d783ee7ae4f54c77f9d37299ba182eaa3ebb5))
+
+### [2.167.1](https://github.com/railroadmedia/musora-content-services/compare/v2.167.0...v2.167.1) (2026-07-13)
+
+
+### Bug Fixes
+
+* **accounts:** allow confirmation email for extra options ([5437d11](https://github.com/railroadmedia/musora-content-services/commit/5437d114437dbe5b4e316ebc440ce957cd9a496c))
+
 ## [2.167.0](https://github.com/railroadmedia/musora-content-services/compare/v2.165.5...v2.167.0) (2026-07-13)
 
 

package/package.json

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

package/src/contentTypeConfig.js

@@ -315,6 +315,7 @@ export const getNextLessonLessonParentTypes = [
   'song-tutorial',
   'learning-path-v2',
   'skill-pack',
+  'documentary',
 ]
 
 export const progressTypesMapping = {

package/src/index.d.ts

@@ -451,6 +451,7 @@ import {
 
 import {
 	getOnboardingRecommendedContent,
+	getOnboardingStatus,
 	initializeOnboardingFlow,
 	startOnboarding,
 	updateOnboarding,
@@ -707,6 +708,7 @@ declare module 'musora-content-services' {
 		getNavigateToForPlaylists,
 		getNewAndUpcoming,
 		getOnboardingRecommendedContent,
+		getOnboardingStatus,
 		getOwnedContent,
 		getPermissionsAdapter,
 		getPermissionsVersion,

package/src/index.js

@@ -455,6 +455,7 @@ import {
 
 import {
 	getOnboardingRecommendedContent,
+	getOnboardingStatus,
 	initializeOnboardingFlow,
 	startOnboarding,
 	updateOnboarding,
@@ -706,6 +707,7 @@ export {
 	getNavigateToForPlaylists,
 	getNewAndUpcoming,
 	getOnboardingRecommendedContent,
+	getOnboardingStatus,
 	getOwnedContent,
 	getPermissionsAdapter,
 	getPermissionsVersion,

package/src/services/contentProgress.js

@@ -173,7 +173,7 @@ export async function getNavigateTo(data) {
         const lastInteracted = await getLastInteractedOf(childrenIds)
         const lastInteractedStatus = childrenStates.get(lastInteracted)
 
-        if (['course', 'skill-pack', 'song-tutorial'].includes(content.type)) {
+        if (['course', 'skill-pack', 'song-tutorial', 'documentary'].includes(content.type)) {
           // todo(BEHSTP-325): remove if/else and make findIncompleteLesson able to return current lesson if `started`
           if (lastInteractedStatus === STATE_STARTED) {
             // send to last interacted

package/src/services/eventsAPI.js

@@ -3,6 +3,7 @@ import {fetchLiveEvent} from "./sanity"
 import { DataContext, PollingStateVersionKey } from './dataContext'
 
 const pollingStateContext = new DataContext(PollingStateVersionKey, fetchLiveEventPollingState)
+const NOTIFICATION_POLLING_INTERVAL_MS = 60_000
 
 /**
  * API for managing notifications and live event polling.
@@ -12,6 +13,7 @@ class EventsAPI {
     this.brand = 'drumeo'
     this.onNotificationStateUpdated = []
     this.pollingInterval = null
+    this.isNotificationPollingPaused = false
     this.isLiveEventPollingActive = true
     this.resumeLiveEventTimeout = null
   }
@@ -27,6 +29,7 @@ class EventsAPI {
    */
   async initialize({ brand = 'drumeo' } = {}) {
     this.brand = brand;
+    this.isNotificationPollingPaused = false;
     await this.setupAutoEvents();
     await this.checkNotifications();
   }
@@ -80,15 +83,56 @@ class EventsAPI {
         const ttlMs = pauseUntil - now;
         await this.pauseLiveEventCheck(ttlMs);
       }
-      this.pollingInterval = setInterval(() => {
-        this.checkNotifications();
-      }, 60000);
+      this.startNotificationInterval();
     } catch (error) {
       console.error('EventsApi: Failed to setup auto events:', error);
       this.checkNotifications();
     }
   }
 
+  /**
+   * Starts notification polling unless it is already active or explicitly paused.
+   */
+  startNotificationInterval() {
+    if (this.pollingInterval || this.isNotificationPollingPaused) {
+      return;
+    }
+
+    this.pollingInterval = setInterval(() => {
+      this.checkNotifications();
+    }, NOTIFICATION_POLLING_INTERVAL_MS);
+  }
+
+  /**
+   * Stops notification polling without removing notification subscribers.
+   */
+  stopNotificationInterval() {
+    if (!this.pollingInterval) {
+      return;
+    }
+
+    clearInterval(this.pollingInterval);
+    this.pollingInterval = null;
+  }
+
+  /**
+   * Pauses notification polling without resetting initialized state or subscribers.
+   */
+  pauseNotificationPolling() {
+    this.isNotificationPollingPaused = true;
+    this.stopNotificationInterval();
+  }
+
+  /**
+   * Resumes notification polling and immediately refreshes notification state.
+   * @returns {Promise<void>}
+   */
+  resumeNotificationPolling() {
+    this.isNotificationPollingPaused = false;
+    this.startNotificationInterval();
+    return this.checkNotifications();
+  }
+
 
   /**
    * Checks for unread notifications and triggers callbacks.
@@ -149,10 +193,8 @@ class EventsAPI {
   }
 
   destroy() {
-    if (this.pollingInterval) {
-      clearInterval(this.pollingInterval);
-      this.pollingInterval = null;
-    }
+    this.isNotificationPollingPaused = true;
+    this.stopNotificationInterval();
 
     if (this.resumeLiveEventTimeout) {
       clearTimeout(this.resumeLiveEventTimeout);