musora-content-services 2.39.5 → 2.40.0

package/src/services/forums/categories.ts

@@ -1,5 +1,5 @@
 /**
- * @module ForumCategories
+ * @module Categories
  */
 import { HttpClient } from '../../infrastructure/http/HttpClient'
 import { globalConfig } from '../config.js'
@@ -40,3 +40,26 @@ export async function createForumCategory(
   const httpClient = new HttpClient(globalConfig.baseUrl)
   return httpClient.post<ForumCategory>(`${baseUrl}/v1/categories`, params)
 }
+
+export interface UpdateForumCategoryParams {
+  id: number
+  brand: number
+  name: string
+  weight: number
+  description?: string
+  icon?: string
+}
+
+/**
+ * Creates a new forum category.
+ *
+ * @param {UpdateForumCategoryParams} params - The parameters for creating the forum category.
+ * @returns {Promise<ForumCategory>} - A promise that resolves to the created forum category.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function updateForumCategory(
+  params: UpdateForumCategoryParams
+): Promise<ForumCategory> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.put<ForumCategory>(`${baseUrl}/v1/categories/${params.id}`, params)
+}

package/src/services/forums/forums.ts

@@ -1,4 +1,5 @@
 /**
  * @namespace Forums
- * @property {module:ForumCategories} ForumCategories
+ * @property {module:Categories} Categories
+ * @property {module:Threads} Threads
  */

package/src/services/forums/threads.ts

@@ -0,0 +1,30 @@
+/**
+ * @module Threads
+ */
+import { HttpClient } from '../../infrastructure/http/HttpClient'
+import { globalConfig } from '../config.js'
+import { ForumThread } from './types'
+
+const baseUrl = `/api/forums`
+
+export interface CreateThreadParams {
+  name: string
+  description: string
+  weight: number
+  brand: string
+}
+
+/**
+ * Creates a new thread under a forum category.
+ *
+ * @param {CreateThreadParams} params - The parameters for creating the thread.
+ * @returns {Promise<ForumThread>} - A promise that resolves to the created thread.
+ * @throws {HttpError} - If the request fails.
+ */
+export async function createThread(
+  categoryId: number,
+  params: CreateThreadParams
+): Promise<ForumThread> {
+  const httpClient = new HttpClient(globalConfig.baseUrl)
+  return httpClient.post<ForumThread>(`${baseUrl}/v1/categories/${categoryId}/threads`, params)
+}

package/src/services/forums/types.ts

@@ -12,6 +12,19 @@ export interface ForumPost {
   author: ForumUser | null
 }
 
+export interface ForumThread {
+  id: number
+  slug: string
+  title: string
+  locked: boolean
+  pinned: boolean
+  state: string
+  author: ForumUser | null
+  category_id: number
+  post_count: number
+  last_post: ForumPost | null
+}
+
 export interface ForumCategory {
   id: number
   brand: string

package/src/services/user/memberships.js

@@ -44,6 +44,28 @@ export async function fetchRechargeTokens() {
   return fetchHandler(url, 'get')
 }
 
+/**
+ * Upgrades the user's subscription or provides a prefilled add-to-cart URL.
+ *
+ * @returns {Promise<Object>} A promise that resolves to an object containing either:
+ *  - {string} action - The action performed (e.g., 'instant_upgrade').
+ *  - {string} message - Success message if the subscription was upgraded immediately.
+ *  OR
+ *  - {string} action - The action performed (e.g., 'shopify').
+ *  - {string} url - URL to the ecommerce store with prefilled add-to-cart parameters.
+ *
+ * @throws {Error} Throws an error if the request fails.
+ *
+ * @example
+ * upgradeSubscription()
+ *   .then(response => console.log(response))
+ *   .catch(error => console.error(error));
+ */
+export async function upgradeSubscription() {
+  const url = `${baseUrl}/v1/update-subscription`
+  return fetchHandler(url, 'get')
+}
+