musora-content-services 2.43.0 → 2.45.0

package/src/index.js

@@ -98,11 +98,21 @@ import {
 	updateForumCategory
 } from './services/forums/categories.ts';
 
+import {
+	createPost,
+	fetchPosts
+} from './services/forums/posts.ts';
+
 import {
 	createThread,
 	fetchThreads,
 	followThread,
-	unfollowThread
+	lockThread,
+	pinThread,
+	unfollowThread,
+	unlockThread,
+	unpinThread,
+	updateThread
 } from './services/forums/threads.ts';
 
 import {
@@ -356,6 +366,7 @@ export {
 	createComment,
 	createForumCategory,
 	createPlaylist,
+	createPost,
 	createPracticeNotes,
 	createThread,
 	deleteComment,
@@ -428,6 +439,7 @@ export {
 	fetchPlayAlongsCount,
 	fetchPlaylist,
 	fetchPlaylistItems,
+	fetchPosts,
 	fetchRecent,
 	fetchRecentActivitiesActiveTabs,
 	fetchRecentUserActivities,
@@ -514,6 +526,7 @@ export {
 	likeComment,
 	likeContent,
 	likePlaylist,
+	lockThread,
 	logUserPractice,
 	login,
 	loginWithProvider,
@@ -527,6 +540,7 @@ export {
 	otherStats,
 	pauseLiveEventPolling,
 	pinProgressRow,
+	pinThread,
 	postContentComplete,
 	postContentLiked,
 	postContentReset,
@@ -572,12 +586,15 @@ export {
 	unlikeComment,
 	unlikeContent,
 	unlikePlaylist,
+	unlockThread,
 	unpinProgressRow,
+	unpinThread,
 	updateDisplayName,
 	updateForumCategory,
 	updateNotificationSetting,
 	updatePlaylist,
 	updatePracticeNotes,
+	updateThread,
 	updateUserPractice,
 	upgradeSubscription,
 	uploadPicture,

package/src/services/forums/posts.ts

@@ -0,0 +1,60 @@
+/**
+ * @module Forums
+ */
+import { HttpClient } from '../../infrastructure/http/HttpClient'
+import { globalConfig } from '../config.js'
+import {ForumPost} from './types'
+import { PaginatedResponse } from '../api/types'
+
+const baseUrl = `/api/forums`
+
+export interface CreatePostParams {
+  content: string
+  brand: string
+}
+
+/**
+ * Creates a new post under a forum thread.
+ *
+ * @param {CreatePostParams} params - The parameters for creating the post.
+ * @returns {Promise<ForumPost>} - A promise that resolves to the created post.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function createPost(
+  threadId: number,
+  params: CreatePostParams
+): Promise<ForumPost> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.post<ForumPost>(`${baseUrl}/v1/threads/${threadId}/posts`, params)
+}
+
+export interface FetchPostParams {
+  page?: number,
+  limit?: number,
+  /** Sort order: "-published_on" (default), "published_on", or "mine". */
+  sort?: '-published_on' | string
+}
+/**
+ * Fetches posts for the given thread.
+ *
+ * @param {number} threadId - The ID of the forum thread.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @param {FetchPostParams} [params] - Optional parameters such as `page`, `limit`, and `sort`.
+ * @returns {Promise<PaginatedResponse<ForumPost>>} - Resolves to a paginated list of forum posts.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function fetchPosts(
+  threadId: number,
+  brand: string,
+  params: FetchPostParams = {}
+): Promise<PaginatedResponse<ForumPost>> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  const queryObj: Record<string, string> = { brand, ...Object.fromEntries(
+      Object.entries(params).filter(([_, v]) => v !== undefined && v !== null).map(([k, v]) => [k, String(v)])
+    )}
+  const query = new URLSearchParams(queryObj).toString()
+
+  const url = `${baseUrl}/v1/threads/${threadId}/posts?${query}`
+  return httpClient.get<PaginatedResponse<ForumPost>>(url)
+}
+

package/src/services/forums/threads.ts

@@ -9,9 +9,8 @@ import { PaginatedResponse } from '../api/types'
 const baseUrl = `/api/forums`
 
 export interface CreateThreadParams {
-  name: string
-  description: string
-  weight: number
+  title: string
+  first_post_content: string
   brand: string
 }
 
@@ -30,6 +29,26 @@ export async function createThread(
   return httpClient.post<ForumThread>(`${baseUrl}/v1/categories/${categoryId}/threads`, params)
 }
 
+export interface UpdateThreadParams {
+  title: string
+  brand: string
+}
+/**
+ * Updates an existing thread under a forum category.
+ *
+ * @param {number} threadId - The ID of the thread to update.
+ * @param {UpdateThreadParams} params - The parameters for updating the thread.
+ * @returns {Promise<ForumThread>} - A promise that resolves to the updated thread.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function updateThread(
+  threadId: number,
+  params: UpdateThreadParams
+): Promise<ForumThread> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.put<ForumThread>(`${baseUrl}/v1/threads/${threadId}`, params)
+}
+
 /**
  * Follow a thread.
  *
@@ -86,3 +105,55 @@ export async function fetchThreads(
   return httpClient.get<PaginatedResponse<ForumThread>>(url)
 }
 
+/**
+ * Pins a thread to the top of its category.
+ *
+ * @param {number} threadId - The ID of the thread to pin.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @return {Promise<void>} - A promise that resolves when the thread is pinned.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function pinThread(threadId: number, brand: string): Promise<void> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.post<void>(`${baseUrl}/v1/threads/${threadId}/pin`, { brand })
+}
+
+/**
+ * Unpins a thread from the top of its category.
+ *
+ * @param {number} threadId - The ID of the thread to unpin.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @return {Promise<void>} - A promise that resolves when the thread is unpinned.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function unpinThread(threadId: number, brand: string): Promise<void> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.delete<void>(`${baseUrl}/v1/threads/${threadId}/pin?brand=${brand}`)
+}
+
+/**
+ * Locks a thread to prevent further posts.
+ *
+ * @param {number} threadId - The ID of the thread to lock.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @return {Promise<void>} - A promise that resolves when the thread is locked.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function lockThread(threadId: number, brand: string): Promise<void> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.post<void>(`${baseUrl}/v1/threads/${threadId}/unlock`, { brand })
+}
+
+/**
+ * Unlock a thread to allow further posts.
+ *
+ * @param {number} threadId - The ID of the thread to unlock.
+ * @param {string} brand - The brand context (e.g., "drumeo", "singeo").
+ * @return {Promise<void>} - A promise that resolves when the thread is unlocked.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function unlockThread(threadId: number, brand: string): Promise<void> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.delete<void>(`${baseUrl}/v1/threads/${threadId}/lock?brand=${brand}`)
+}
+

package/src/services/forums/types.ts

@@ -10,6 +10,8 @@ export interface ForumPost {
   created_at: string
   created_at_human: string
   author: ForumUser | null
+  like_count: number
+  is_liked: boolean
 }
 
 export interface ForumThread {

package/src/services/user/sessions.js

@@ -45,8 +45,8 @@ export async function login(email, password, deviceName, deviceToken, platform)
     }),
   })
 }
-
-export async function loginWithProvider(provider, providerIdToken, deviceToken, deviceName, platform) {
+//Removing 3rdParty OAuth2 for now => https://musora.atlassian.net/browse/BEH-624?focusedCommentId=21492
+/*export async function loginWithProvider(provider, providerIdToken, deviceToken, deviceName, platform) {
   const baseUrl = `${globalConfig.baseUrl}/api/user-management-system`
 
   try {
@@ -74,7 +74,7 @@ export async function loginWithProvider(provider, providerIdToken, deviceToken,
     console.error('loginWithProvider failed', err)
     throw err
   }
-}
+}*/
 
 /**
  * Logs the user out of the current session.

package/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(rg:*)"
-    ],
-    "deny": []
-  }
-}