musora-content-services 2.107.2 → 2.107.4

package/.claude/settings.local.json

@@ -1,17 +1,14 @@
 {
   "permissions": {
     "allow": [
+      "Read(//app/musora-platform-backend/**)",
+      "Read(//app/musora-platform-frontend/**)",
       "Bash(find:*)",
-      "Bash(docker exec:*)",
-      "Bash(npm test:*)",
-      "WebSearch",
-      "WebFetch(domain:watermelondb.dev)",
-      "WebFetch(domain:github.com)",
-      "Bash(git checkout:*)",
-      "Bash(npm run doc:*)",
+      "Bash(sed:*)",
+      "Read(//app/**)",
       "Bash(cat:*)",
-      "Bash(tr:*)",
-      "Bash(npm run build-index:*)"
+      "Bash(docker exec:*)",
+      "Bash(npm config:*)"
     ],
     "deny": [],
     "ask": []

package/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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.107.4](https://github.com/railroadmedia/musora-content-services/compare/v2.107.1...v2.107.4) (2025-12-22)
+
+
+### Bug Fixes
+
+* **AGI:** contentType optional ([deae293](https://github.com/railroadmedia/musora-content-services/commit/deae2934c26ea0b9ee4d68c736fbb5753616a5e9))
+* **AGI:** return children on AGI lessons functions ([#671](https://github.com/railroadmedia/musora-content-services/issues/671)) ([92ed791](https://github.com/railroadmedia/musora-content-services/commit/92ed791ce563aa4f1bf16cb41d2b6fe421504064))
+* **onboarding:** call BE for recommendation ([#670](https://github.com/railroadmedia/musora-content-services/issues/670)) ([a876736](https://github.com/railroadmedia/musora-content-services/commit/a8767363ff3428638bde477cd6c30e5bf61179b2))
+
+### [2.107.3](https://github.com/railroadmedia/musora-content-services/compare/v2.107.2...v2.107.3) (2025-12-19)
+
+
+### Bug Fixes
+
+* **AGI:** contentType optional ([deae293](https://github.com/railroadmedia/musora-content-services/commit/deae2934c26ea0b9ee4d68c736fbb5753616a5e9))
+* **AGI:** return children on AGI lessons functions ([#671](https://github.com/railroadmedia/musora-content-services/issues/671)) ([92ed791](https://github.com/railroadmedia/musora-content-services/commit/92ed791ce563aa4f1bf16cb41d2b6fe421504064))
+* **onboarding:** call BE for recommendation ([#670](https://github.com/railroadmedia/musora-content-services/issues/670)) ([a876736](https://github.com/railroadmedia/musora-content-services/commit/a8767363ff3428638bde477cd6c30e5bf61179b2))
+
 ### [2.107.2](https://github.com/railroadmedia/musora-content-services/compare/v2.107.1...v2.107.2) (2025-12-19)
 
 ### [2.107.1](https://github.com/railroadmedia/musora-content-services/compare/v2.107.0...v2.107.1) (2025-12-19)

package/check_content.js

@@ -0,0 +1,30 @@
+const { initializeService } = require('./src/services/config.js');
+const { fetchByRailContentIds } = require('./src/services/sanity.js');
+require('dotenv/config');
+
+async function checkContent() {
+  initializeService({
+    sanityConfig: {
+      token: process.env.SANITY_TOKEN,
+      projectId: process.env.SANITY_PROJECT_ID,
+      dataset: process.env.SANITY_DATASET,
+      version: process.env.SANITY_VERSION || '2021-06-07',
+    },
+    railcontentConfig: {
+      token: process.env.RAILCONTENT_TOKEN,
+      userId: process.env.RAILCONTENT_USER_ID,
+      baseUrl: process.env.RAILCONTENT_BASE_URL,
+      authToken: process.env.RAILCONTENT_AUTH_TOKEN,
+    },
+    baseUrl: process.env.RAILCONTENT_BASE_URL,
+    localStorage: null,
+    isMA: false,
+  });
+
+  console.log('Checking railcontent_id: 421814');
+  const contents = await fetchByRailContentIds([421814]);
+  console.log('Results:', JSON.stringify(contents, null, 2));
+  console.log('Found:', contents.length, 'items');
+}
+
+checkContent().catch(console.error);

package/check_content.mjs

@@ -0,0 +1,32 @@
+import { initializeService } from './src/services/config.js';
+import { fetchByRailContentIds } from './src/services/sanity.js';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+async function checkContent() {
+  initializeService({
+    sanityConfig: {
+      token: process.env.SANITY_TOKEN,
+      projectId: process.env.SANITY_PROJECT_ID,
+      dataset: process.env.SANITY_DATASET,
+      version: process.env.SANITY_VERSION || '2021-06-07',
+    },
+    railcontentConfig: {
+      token: process.env.RAILCONTENT_TOKEN,
+      userId: process.env.RAILCONTENT_USER_ID,
+      baseUrl: process.env.RAILCONTENT_BASE_URL,
+      authToken: process.env.RAILCONTENT_AUTH_TOKEN,
+    },
+    baseUrl: process.env.RAILCONTENT_BASE_URL,
+    localStorage: null,
+    isMA: false,
+  });
+
+  console.log('Checking railcontent_id: 421814');
+  const contents = await fetchByRailContentIds([421814]);
+  console.log('Results:', JSON.stringify(contents, null, 2));
+  console.log('Found:', contents.length, 'items');
+}
+
+checkContent().catch(console.error);

package/package.json

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

package/src/index.d.ts

@@ -155,6 +155,7 @@ import {
 	createPost,
 	deletePost,
 	fetchCommunityGuidelines,
+	fetchPost,
 	fetchPosts,
 	jumpToPost,
 	likePost,
@@ -168,6 +169,7 @@ import {
 	deleteThread,
 	fetchFollowedThreads,
 	fetchLatestThreads,
+	fetchThread,
 	fetchThreads,
 	followThread,
 	lockThread,
@@ -310,6 +312,14 @@ import {
 	jumpToContinueContent
 } from './services/sanity.js';
 
+import {
+	generateCommentUrl,
+	generateContentUrl,
+	generateContentUrlWithDomain,
+	generateForumPostUrl,
+	generatePlaylistUrl
+} from './services/urlBuilder.ts';
+
 import {
 	confirmEmailChange,
 	deleteAccount,
@@ -543,6 +553,7 @@ declare module 'musora-content-services' {
 		fetchPlayAlongsCount,
 		fetchPlaylist,
 		fetchPlaylistItems,
+		fetchPost,
 		fetchPosts,
 		fetchRecent,
 		fetchRecentActivitiesActiveTabs,
@@ -563,6 +574,7 @@ declare module 'musora-content-services' {
 		fetchSongById,
 		fetchSongsInProgress,
 		fetchTabData,
+		fetchThread,
 		fetchThreads,
 		fetchTopComment,
 		fetchTopLevelParentId,
@@ -580,6 +592,11 @@ declare module 'musora-content-services' {
 		findIncompleteLesson,
 		followThread,
 		generateAuthSessionUrl,
+		generateCommentUrl,
+		generateContentUrl,
+		generateContentUrlWithDomain,
+		generateForumPostUrl,
+		generatePlaylistUrl,
 		getActiveDiscussions,
 		getActivePath,
 		getAllCompleted,

package/src/index.js

@@ -159,6 +159,7 @@ import {
 	createPost,
 	deletePost,
 	fetchCommunityGuidelines,
+	fetchPost,
 	fetchPosts,
 	jumpToPost,
 	likePost,
@@ -172,6 +173,7 @@ import {
 	deleteThread,
 	fetchFollowedThreads,
 	fetchLatestThreads,
+	fetchThread,
 	fetchThreads,
 	followThread,
 	lockThread,
@@ -314,6 +316,14 @@ import {
 	jumpToContinueContent
 } from './services/sanity.js';
 
+import {
+	generateCommentUrl,
+	generateContentUrl,
+	generateContentUrlWithDomain,
+	generateForumPostUrl,
+	generatePlaylistUrl
+} from './services/urlBuilder.ts';
+
 import {
 	confirmEmailChange,
 	deleteAccount,
@@ -542,6 +552,7 @@ export {
 	fetchPlayAlongsCount,
 	fetchPlaylist,
 	fetchPlaylistItems,
+	fetchPost,
 	fetchPosts,
 	fetchRecent,
 	fetchRecentActivitiesActiveTabs,
@@ -562,6 +573,7 @@ export {
 	fetchSongById,
 	fetchSongsInProgress,
 	fetchTabData,
+	fetchThread,
 	fetchThreads,
 	fetchTopComment,
 	fetchTopLevelParentId,
@@ -579,6 +591,11 @@ export {
 	findIncompleteLesson,
 	followThread,
 	generateAuthSessionUrl,
+	generateCommentUrl,
+	generateContentUrl,
+	generateContentUrlWithDomain,
+	generateForumPostUrl,
+	generatePlaylistUrl,
 	getActiveDiscussions,
 	getActivePath,
 	getAllCompleted,

package/src/services/content/artist.ts

@@ -1,12 +1,12 @@
 /**
  * @module Artist
  */
-import { getFieldsForContentType } from '../../contentTypeConfig.js'
+import { getFieldsForContentTypeWithFilteredChildren } from '../../contentTypeConfig.js'
+import { Brands } from '../../lib/brands'
+import { Filters as f } from '../../lib/sanity/filter'
 import { BuildQueryOptions, query } from '../../lib/sanity/query'
 import { fetchSanity, getSortOrder } from '../sanity.js'
 import { Lesson } from './content'
-import { Brands } from '../../lib/brands'
-import { Filters as f } from '../../lib/sanity/filter'
 
 export interface Artist {
   slug: string
@@ -123,7 +123,7 @@ export interface ArtistLessons {
 export async function fetchArtistLessons(
   slug: string,
   brand: Brands | string,
-  contentType: string,
+  contentType?: string,
   {
     sort = '-published_on',
     searchTerm = '',
@@ -150,7 +150,7 @@ export async function fetchArtistLessons(
     .and(restrictions)
     .order(sort)
     .slice(offset, limit)
-    .select(getFieldsForContentType(contentType) as string)
+    .select((await getFieldsForContentTypeWithFilteredChildren(contentType, true)) as string)
     .build()
 
   const total = query().and(restrictions).build()

package/src/services/content/genre.ts

@@ -1,12 +1,12 @@
 /**
  * @module Genre
  */
-import { getFieldsForContentType } from '../../contentTypeConfig.js'
-import { fetchSanity, getSortOrder } from '../sanity.js'
-import { Lesson } from './content'
-import { BuildQueryOptions, query } from '../../lib/sanity/query'
+import { getFieldsForContentTypeWithFilteredChildren } from '../../contentTypeConfig.js'
 import { Brands } from '../../lib/brands'
 import { Filters as f } from '../../lib/sanity/filter'
+import { BuildQueryOptions, query } from '../../lib/sanity/query'
+import { fetchSanity, getSortOrder } from '../sanity.js'
+import { Lesson } from './content'
 
 export interface Genre {
   name: string
@@ -149,7 +149,7 @@ export async function fetchGenreLessons(
     .and(restrictions)
     .order(sort)
     .slice(offset, limit)
-    .select(getFieldsForContentType(contentType) as string)
+    .select((await getFieldsForContentTypeWithFilteredChildren(contentType, true)) as string)
     .build()
 
   const total = query().and(restrictions).build()

package/src/services/content/instructor.ts

@@ -1,12 +1,12 @@
 /**
  * @module Instructor
  */
-import { getFieldsForContentType } from '../../contentTypeConfig.js'
-import { fetchSanity, getSortOrder } from '../sanity.js'
-import { Lesson } from './content'
-import { BuildQueryOptions, query } from '../../lib/sanity/query'
+import { getFieldsForContentTypeWithFilteredChildren } from '../../contentTypeConfig.js'
 import { Brands } from '../../lib/brands'
 import { Filters as f } from '../../lib/sanity/filter'
+import { BuildQueryOptions, query } from '../../lib/sanity/query'
+import { fetchSanity, getSortOrder } from '../sanity.js'
+import { Lesson } from './content'
 
 export interface Instructor {
   lesson_count: number
@@ -106,7 +106,7 @@ export interface InstructorLessons {
  * Fetch the data needed for the instructor screen.
  * @param {string} slug - The slug of the instructor
  * @param {Brands|string} brand - The brand for which to fetch instructor lessons
- *
+ * @param {string|null} [contentType] - The content type to filter lessons by (e.g., 'lesson', 'course').
  * @param {FetchInstructorLessonsOptions} options - Parameters for pagination, filtering and sorting.
  * @param {string} [options.sortOrder="-published_on"] - The field to sort the lessons by.
  * @param {string} [options.searchTerm=""] - The search term to filter content by title.
@@ -123,6 +123,7 @@ export interface InstructorLessons {
 export async function fetchInstructorLessons(
   slug: string,
   brand: Brands | string,
+  contentType?: string,
   {
     sort = '-published_on',
     searchTerm = '',
@@ -147,7 +148,7 @@ export async function fetchInstructorLessons(
     .and(restrictions)
     .order(sort)
     .slice(offset, limit)
-    .select(getFieldsForContentType() as string)
+    .select((await getFieldsForContentTypeWithFilteredChildren(contentType, true)) as string)
     .build()
 
   const total = query().and(restrictions).build()

package/src/services/forums/posts.ts

@@ -23,8 +23,26 @@ export interface CreatePostParams {
  * @throws {HttpError} - If the request fails.
  */
 export async function createPost(threadId: number, params: CreatePostParams): Promise<ForumPost> {
+  const { generateForumPostUrl } = await import('../urlBuilder.ts')
+  const { fetchThread } = await import('./threads.ts')
+
+  // Fetch thread to get category_id for URL generation
+  const thread = await fetchThread(threadId, params.brand)
+
+  // Generate forum post URL
+  const contentUrl = generateForumPostUrl({
+    brand: params.brand,
+    thread: {
+      category_id: thread.category_id,
+      id: threadId
+    }
+  }, false)
+
   const httpClient = new HttpClient(globalConfig.baseUrl)
-  return httpClient.post<ForumPost>(`${baseUrl}/v1/threads/${threadId}/posts`, params)
+  return httpClient.post<ForumPost>(`${baseUrl}/v1/threads/${threadId}/posts`, {
+    ...params,
+    content_url: contentUrl
+  })
 }
 
 /**
@@ -40,6 +58,19 @@ export async function updatePost(postId: number, params: CreatePostParams): Prom
   return httpClient.put<ForumPost>(`${baseUrl}/v1/posts/${postId}`, params)
 }
 
+/**
+ * Fetches a single forum post by ID.
+ *
+ * @param {number} postId - The ID of the post to fetch.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @returns {Promise<ForumPost>} - A promise that resolves to the forum post.
+ * @throws {HttpError} - If the HTTP request fails.
+ */
+export async function fetchPost(postId: number, brand: string): Promise<ForumPost> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.get<ForumPost>(`${baseUrl}/v1/posts/${postId}?brand=${brand}`)
+}
+
 export interface FetchPostParams {
   page?: number
   limit?: number
@@ -91,8 +122,25 @@ export async function fetchPosts(
  * @throws {HttpError} - If the request fails.
  */
 export async function likePost(postId: number, brand: string): Promise<void> {
+  const { generateForumPostUrl } = await import('../urlBuilder.ts')
+
+  // Fetch post to get thread info for URL generation
+  const post = await fetchPost(postId, brand)
+
+  // Generate forum post URL
+  const contentUrl = generateForumPostUrl({
+    brand,
+    thread: {
+      category_id: post.thread.category_id,
+      id: post.thread.id
+    }
+  }, false)
+
   const httpClient = new HttpClient(globalConfig.baseUrl)
-  return httpClient.post<void>(`${baseUrl}/v1/posts/${postId}/likes`, { brand })
+  return httpClient.post<void>(`${baseUrl}/v1/posts/${postId}/likes`, {
+    brand,
+    content_url: contentUrl
+  })
 }
 
 /**

package/src/services/forums/threads.ts

@@ -89,6 +89,19 @@ export async function markThreadAsRead(threadId: number, brand: string): Promise
   return httpClient.put<void>(`${baseUrl}/v1/threads/${threadId}/read?brand=${brand}`, {})
 }
 
+/**
+ * Fetches a single forum thread by ID.
+ *
+ * @param {number} threadId - The ID of the thread to fetch.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @returns {Promise<ForumThread>} - A promise that resolves to the forum thread.
+ * @throws {HttpError} - If the HTTP request fails.
+ */
+export async function fetchThread(threadId: number, brand: string): Promise<ForumThread> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.get<ForumThread>(`${baseUrl}/v1/threads/${threadId}?brand=${brand}`)
+}
+
 export interface FetchThreadParams {
   is_followed?: boolean,
   page?: number,

package/src/services/railcontent.js

@@ -249,8 +249,38 @@ export async function restoreComment(commentId) {
  * @returns {Promise<*|null>}
  */
 export async function replyToComment(commentId, comment) {
+  const { generateCommentUrl } = await import('./urlBuilder.ts')
+  const { fetchByRailContentIds } = await import('./sanity.js')
+
+  // Fetch parent comment to get content info
+  const parentComment = await fetchComment(commentId)
+
+  if (!parentComment?.content) {
+    const url = `/api/content/v1/comments/${commentId}/reply`
+    return await POST(url, { comment })
+  }
+
+  // Fetch content from Sanity to get parentId and correct type
+  const contents = await fetchByRailContentIds([parentComment.content.id])
+  const content = contents?.[0]
+
+  // Generate content URL
+  const contentUrl = content ? generateCommentUrl({
+    id: commentId,
+    content: {
+      id: content.id,
+      type: content.type,
+      parentId: content.parentId || content.parent_id,
+      brand: content.brand
+    }
+  }, false) : null
+
+  const data = {
+    comment: comment,
+    ...(contentUrl && { content_url: contentUrl })
+  }
   const url = `/api/content/v1/comments/${commentId}/reply`
-  return await POST(url, { comment })
+  return await POST(url, data)
 }
 
 /**
@@ -259,8 +289,28 @@ export async function replyToComment(commentId, comment) {
  * @returns {Promise<*|null>}
  */
 export async function createComment(railcontentId, comment) {
+  const { generateContentUrl } = await import('./urlBuilder.ts')
+  const { fetchByRailContentIds } = await import('./sanity.js')
+
+  // Fetch content to get type and brand info
+  const contents = await fetchByRailContentIds([railcontentId])
+  const content = contents?.[0]
+
+  // Generate content URL
+  const contentUrl = content ? generateContentUrl({
+    id: content.id,
+    type: content.type,
+    parentId: content.parentId || content.parent_id,
+    brand: content.brand
+  }) : null
+
+  const data = {
+    comment: comment,
+    content_id: railcontentId,
+    ...(contentUrl && { content_url: contentUrl })
+  }
   const url = `/api/content/v1/comments/store`
-  return await POST(url, { comment, content_id: railcontentId })
+  return await POST(url, data)
 }
 
 /**
@@ -286,8 +336,35 @@ export async function unassignModeratorToComment(commentId) {
  * @returns {Promise<*|null>}
  */
 export async function likeComment(commentId) {
+  const { generateCommentUrl } = await import('./urlBuilder.ts')
+  const { fetchByRailContentIds } = await import('./sanity.js')
+
+  // Fetch comment to get content info
+  const comment = await fetchComment(commentId)
+
+  if (!comment?.content) {
+    const url = `/api/content/v1/comments/${commentId}/like`
+    return await POST(url, null)
+  }
+
+  // Fetch content from Sanity to get parentId and correct type
+  const contents = await fetchByRailContentIds([comment.content.id])
+  const content = contents?.[0]
+
+  // Generate content URL
+  const contentUrl = content ? generateCommentUrl({
+    id: commentId,
+    content: {
+      id: content.id,
+      type: content.type,
+      parentId: content.parentId || content.parent_id,
+      brand: content.brand
+    }
+  }, false) : null
+
   const url = `/api/content/v1/comments/${commentId}/like`
-  return await POST(url, null)
+  const data = contentUrl ? { content_url: contentUrl } : {}
+  return await POST(url, data)
 }
 
 /**