musora-content-services 1.0.176 → 1.0.178

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.
 
+### [1.0.178](https://github.com/railroadmedia/musora-content-services/compare/v1.0.177...v1.0.178) (2024-11-19)
+
+### [1.0.177](https://github.com/railroadmedia/musora-content-services/compare/v1.0.176...v1.0.177) (2024-11-18)
+
 ### [1.0.176](https://github.com/railroadmedia/musora-content-services/compare/v1.0.161...v1.0.176) (2024-11-15)
 
 ### [1.0.175](https://github.com/railroadmedia/musora-content-services/compare/v1.0.174...v1.0.175) (2024-11-15)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musora-content-services",
-  "version": "1.0.176",
+  "version": "1.0.178",
   "description": "A package for Musoras content services ",
   "main": "src/index.js",
   "scripts": {

package/src/contentMetaData.js

@@ -37,13 +37,11 @@ const commonMetadata ={
             {
                 name: 'Completed',
                 short_name: 'COMPLETED',
-                is_group_by: true,
                 value: 'completed'
             },
             {
                 name: 'Owned Challenges',
                 short_name: 'OWNED CHALLENGES',
-                is_group_by: true,
                 value: 'owned',
             },
         ],

package/src/index.d.ts

@@ -40,12 +40,14 @@ import {
 	fetchChallengeLessonData,
 	fetchChallengeMetadata,
 	fetchChallengeUserActiveChallenges,
+	fetchCompletedChallenges,
 	fetchCompletedContent,
 	fetchCompletedState,
 	fetchContentInProgress,
 	fetchContentPageUserData,
 	fetchContentProgress,
 	fetchHandler,
+	fetchOwnedChallenges,
 	fetchPinnedPlaylists,
 	fetchPlaylist,
 	fetchPlaylistItem,
@@ -166,6 +168,7 @@ declare module 'musora-content-services' {
 		fetchChildren,
 		fetchCoachLessons,
 		fetchCommentModContentData,
+		fetchCompletedChallenges,
 		fetchCompletedContent,
 		fetchCompletedState,
 		fetchContentInProgress,
@@ -187,6 +190,7 @@ declare module 'musora-content-services' {
 		fetchMethods,
 		fetchNewReleases,
 		fetchNextPreviousLesson,
+		fetchOwnedChallenges,
 		fetchPackAll,
 		fetchPackChildren,
 		fetchPackData,

package/src/index.js

@@ -40,12 +40,14 @@ import {
 	fetchChallengeLessonData,
 	fetchChallengeMetadata,
 	fetchChallengeUserActiveChallenges,
+	fetchCompletedChallenges,
 	fetchCompletedContent,
 	fetchCompletedState,
 	fetchContentInProgress,
 	fetchContentPageUserData,
 	fetchContentProgress,
 	fetchHandler,
+	fetchOwnedChallenges,
 	fetchPinnedPlaylists,
 	fetchPlaylist,
 	fetchPlaylistItem,
@@ -165,6 +167,7 @@ export {
 	fetchChildren,
 	fetchCoachLessons,
 	fetchCommentModContentData,
+	fetchCompletedChallenges,
 	fetchCompletedContent,
 	fetchCompletedState,
 	fetchContentInProgress,
@@ -186,6 +189,7 @@ export {
 	fetchMethods,
 	fetchNewReleases,
 	fetchNextPreviousLesson,
+	fetchOwnedChallenges,
 	fetchPackAll,
 	fetchPackChildren,
 	fetchPackData,

package/src/services/railcontent.js

@@ -1,6 +1,7 @@
 /**
  * @module Railcontent-Services
  */
+import {contentStatusCompleted} from "./contentProgress";
 
 const {globalConfig} = require('./config');
 
@@ -335,6 +336,36 @@ export async function fetchChallengeLessonData(contentId) {
     return await fetchHandler(url, 'get');
 }
 
+
+/**
+ * Fetch all owned brand challenges for user
+ * @param {string|null} brand - brand
+ * @param {int} page - page of data to pull
+ * @param {int} limit - number of elements to pull
+ * @returns {Promise<any|null>}
+ */
+export async function fetchOwnedChallenges(brand = null, page, limit) {
+    let brandParam = brand ? `&brand=${brand}` : '';
+    let pageAndLimit = `?page=${page}&limit=${limit}`;
+    let url = `/challenges/tab_owned/get${pageAndLimit}${brandParam}`;
+    return await fetchHandler(url, 'get');
+}
+
+/**
+ * Fetch all completed brand challenges for user
+ * @param {string|null} brand - brand
+ * @param {int} page - page of data to pull
+ * @param {int} limit - number of elements to pull
+ * @returns {Promise<any|null>}
+ */
+export async function fetchCompletedChallenges(brand = null, page, limit) {
+    let brandParam = brand ? `&brand=${brand}` : '';
+    let pageAndLimit = `?page=${page}&limit=${limit}`;
+    let url = `/challenges/tab_completed/get${pageAndLimit}${brandParam}`;
+    return await fetchHandler(url, 'get');
+}
+
+
 /**
  * Fetch challenge, lesson, and user metadata for a given challenge
  *
@@ -472,6 +503,7 @@ export async function postChallengesCommunityNotification(contentId) {
  */
 export async function postChallengesCompleteLesson(contentId) {
     let url = `/challenges/complete_lesson/${contentId}`;
+    await contentStatusCompleted(contentId);
     return await fetchHandler(url, 'post');
 }
 

package/src/services/sanity.js

@@ -23,7 +23,12 @@ import {
 
 import {globalConfig} from "./config";
 
-import {fetchAllCompletedStates, fetchCurrentSongComplete} from './railcontent.js';
+import {
+    fetchAllCompletedStates,
+    fetchCompletedChallenges,
+    fetchCurrentSongComplete,
+    fetchOwnedChallenges
+} from './railcontent.js';
 import {arrayToStringRepresentation, FilterBuilder} from "../filterBuilder";
 import {fetchUserPermissions} from "./userPermissions";
 import {getAllCompleted, getAllStarted, getAllStartedOrCompleted} from "./contentProgress";
@@ -33,7 +38,7 @@ import {getAllCompleted, getAllStarted, getAllStartedOrCompleted} from "./conten
  *
  * @type {string[]}
  */
-const excludeFromGeneratedIndex = [];
+const excludeFromGeneratedIndex = ['handleCustomFetchAll'];
 
 /**
  * Fetch a song by its document ID from Sanity.
@@ -484,6 +489,21 @@ export async function fetchAll(brand, type, {
     customFields = [],
     progress = "all"
 } = {}) {
+    let customResults = await handleCustomFetchAll(brand, type, {
+        page,
+        limit,
+        searchTerm,
+        sort,
+        includedFields,
+        groupBy,
+        progressIds,
+        useDefaultFields,
+        customFields,
+        progress});
+    if (customResults) {
+        return customResults;
+    }
+
     let config = contentTypeConfig[type] ?? {};
     let additionalFields = config?.fields ?? [];
     let isGroupByOneToOne = (groupBy ? config?.relationships?.[groupBy]?.isOneToOne : false) ?? false;
@@ -566,6 +586,45 @@ export async function fetchAll(brand, type, {
     return fetchSanity(query, true);
 }
 
+/**
+ * Fetch all content that requires custom handling or a distinct external call
+ * @param {string} brand - The brand for which to fetch content.
+ * @param {string} type - The content type to fetch (e.g., 'song', 'artist').
+ * @param {Object} params - Parameters for pagination, filtering, sorting, and grouping.
+ * @param {number} [params.page=1] - The page number for pagination.
+ * @param {number} [params.limit=10] - The number of items per page.
+ * @param {string} [params.searchTerm=""] - The search term to filter content by title or artist.
+ * @param {string} [params.sort="-published_on"] - The field to sort the content by.
+ * @param {Array<string>} [params.includedFields=[]] - The fields to include in the query.
+ * @param {string} [params.groupBy=""] - The field to group the results by (e.g., 'artist', 'genre').
+ * @param {Array<string>} [params.progressIds=undefined] - An array of railcontent IDs to filter the results by. Used for filtering by progress.
+ * @param {boolean} [params.useDefaultFields=true] - use the default sanity fields for content Type
+ * @param {Array<string>} [params.customFields=[]] - An array of sanity fields to include in the request
+ * @param {string} [params.progress="all"] - An string representing which progress filter to use ("all", "in progress", "complete", "not started").
+ * @returns {Promise<Object|null>} - The fetched content data or null if not found.
+ */
+async function handleCustomFetchAll(brand, type, {
+    page = 1,
+    limit = 10,
+    searchTerm = "",
+    sort = "-published_on",
+    includedFields = [],
+    groupBy = "",
+    progressIds = undefined,
+    useDefaultFields = true,
+    customFields = [],
+    progress = "all"
+} = {}) {
+    if (type === 'challenge') {
+        if (groupBy === 'completed') {
+            return fetchCompletedChallenges(brand, page, limit);
+        } else if(groupBy === 'owned') {
+            return fetchOwnedChallenges(brand, page, limit);
+        }
+    }
+    return null;
+}
+
 async function getProgressFilter(progress, progressIds) {
     switch (progress) {
         case "all":