musora-content-services 2.39.4 → 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')
+}
+
 
 
 

package/src/services/user/sessions.js

@@ -12,28 +12,20 @@ import './types.js'
 const excludeFromGeneratedIndex = []
 
 /**
- * Sends a login request to the User Management System.
+ * Authenticates the User.
  *
- * The request always includes the `X-Client-Platform` header set to `"mobile"`.
- * This header is used by the backend to identify the source client type.
+ * @param {string} email - User's email
+ * @param {string} password - User's password
+ * @param {string|null} deviceName -  Device name for the user
+ * @param {string|null} deviceToken - Firebase token for the device
+ * @param {string|null} platform - Device platform
  *
- * @param {string} email - The user's email address.
- * @param {string} password - The user's account password.
- * @param {string|null} [deviceName] - A human-readable identifier for the device (e.g. "iPhone 15").
- * @param {string|null} [deviceToken] - Optional Firebase Cloud Messaging token for push notifications.
- * @param {string|null} [platform] - The device platform (e.g. "ios", "android", "web").
- *
- * @returns {Promise<Response>} - The raw `fetch` Response object.
- *   Call `response.json()` to access the API payload, which typically includes:
- *   - `token` (string): Access token.
- *   - `refresh_token` (string): Refresh token.
- *   - `user` (object): Authenticated user data.
+ * @returns {Promise<AuthResponse>} - User data and authentication token
  *
  * @example
- * login('john@doe.com', 'music123', 'Pixel 8', 'abc123', 'android')
- *   .then(res => res.json())
- *   .then(data => console.log(data))
- *   .catch(err => console.error(err));
+ * login('john@doe.com', 'music123')
+ *   .then(content => console.log(content))
+ *   .catch(error => console.error(error));
  */
 export async function login(email, password, deviceName, deviceToken, platform) {
   const baseUrl = `${globalConfig.baseUrl}/api/user-management-system`
@@ -59,7 +51,7 @@ export async function loginWithProvider(provider, providerIdToken, deviceToken,
 
   try {
     const response = await fetch(`${baseUrl}/v1/auth/${provider}/mobile`, {
-      method: 'GET',
+      method: 'POST',
       headers: {
         'Content-Type': 'application/json',
         'X-Client-Platform': 'mobile',