npm - musora-content-services - Versions diffs - 1.0.7 - Mend

musora-content-services 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

package/CHANGELOG.md +17 -0
package/README.md +39 -0
package/docs/data/search.json +1 -0
package/docs/fonts/Inconsolata-Regular.ttf +0 -0
package/docs/fonts/OpenSans-Bold-webfont.eot +0 -0
package/docs/fonts/OpenSans-Bold-webfont.svg +1830 -0
package/docs/fonts/OpenSans-Bold-webfont.woff +0 -0
package/docs/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
package/docs/fonts/OpenSans-BoldItalic-webfont.svg +1830 -0
package/docs/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
package/docs/fonts/OpenSans-Italic-webfont.eot +0 -0
package/docs/fonts/OpenSans-Italic-webfont.svg +1830 -0
package/docs/fonts/OpenSans-Italic-webfont.woff +0 -0
package/docs/fonts/OpenSans-Light-webfont.eot +0 -0
package/docs/fonts/OpenSans-Light-webfont.svg +1831 -0
package/docs/fonts/OpenSans-Light-webfont.woff +0 -0
package/docs/fonts/OpenSans-LightItalic-webfont.eot +0 -0
package/docs/fonts/OpenSans-LightItalic-webfont.svg +1835 -0
package/docs/fonts/OpenSans-LightItalic-webfont.woff +0 -0
package/docs/fonts/OpenSans-Regular-webfont.eot +0 -0
package/docs/fonts/OpenSans-Regular-webfont.svg +1831 -0
package/docs/fonts/OpenSans-Regular-webfont.woff +0 -0
package/docs/fonts/OpenSans-Regular.ttf +0 -0
package/docs/fonts/OpenSans-Semibold-webfont.eot +0 -0
package/docs/fonts/OpenSans-Semibold-webfont.svg +1830 -0
package/docs/fonts/OpenSans-Semibold-webfont.ttf +0 -0
package/docs/fonts/OpenSans-Semibold-webfont.woff +0 -0
package/docs/fonts/OpenSans-SemiboldItalic-webfont.eot +0 -0
package/docs/fonts/OpenSans-SemiboldItalic-webfont.svg +1830 -0
package/docs/fonts/OpenSans-SemiboldItalic-webfont.ttf +0 -0
package/docs/fonts/OpenSans-SemiboldItalic-webfont.woff +0 -0
package/docs/fonts/WorkSans-Bold.ttf +0 -0
package/docs/global.html +4773 -0
package/docs/index.html +93 -0
package/docs/index.js.html +766 -0
package/docs/scripts/core.js +726 -0
package/docs/scripts/core.min.js +23 -0
package/docs/scripts/linenumber.js +25 -0
package/docs/scripts/prettify/Apache-License-2.0.txt +202 -0
package/docs/scripts/prettify/lang-css.js +2 -0
package/docs/scripts/prettify/prettify.js +28 -0
package/docs/scripts/resize.js +90 -0
package/docs/scripts/search.js +265 -0
package/docs/scripts/search.min.js +6 -0
package/docs/scripts/third-party/Apache-License-2.0.txt +202 -0
package/docs/scripts/third-party/fuse.js +9 -0
package/docs/scripts/third-party/hljs-line-num-original.js +369 -0
package/docs/scripts/third-party/hljs-line-num.js +1 -0
package/docs/scripts/third-party/hljs-original.js +5171 -0
package/docs/scripts/third-party/hljs.js +1 -0
package/docs/scripts/third-party/popper.js +5 -0
package/docs/scripts/third-party/tippy.js +1 -0
package/docs/scripts/third-party/tocbot.js +672 -0
package/docs/scripts/third-party/tocbot.min.js +1 -0
package/docs/styles/clean-jsdoc-theme-base.css +1159 -0
package/docs/styles/clean-jsdoc-theme-dark.css +412 -0
package/docs/styles/clean-jsdoc-theme-light.css +482 -0
package/docs/styles/clean-jsdoc-theme-scrollbar.css +30 -0
package/docs/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
package/docs/styles/clean-jsdoc-theme.min.css +1 -0
package/docs/styles/jsdoc-default.css +692 -0
package/docs/styles/prettify-jsdoc.css +111 -0
package/docs/styles/prettify-tomorrow.css +132 -0
package/jsdoc.json +13 -0
package/package.json +27 -0
package/publish.sh +21 -0
package/src/index.js +758 -0

package/docs/index.js.html ADDED Viewed

@@ -0,0 +1,766 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>index.js - Documentation</title>
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="https://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+<body>
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+<label for="nav-trigger" class="overlay"></label>
+<nav>
+    <li class="nav-link nav-home-link"><a href="index.html">Home</a></li><li class="nav-heading"><a href="global.html">Globals</a></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchAll">fetchAll</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchAllSongs">fetchAllSongs</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchArtists">fetchArtists</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchByRailContentId">fetchByRailContentId</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchByRailContentIds">fetchByRailContentIds</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchChildren">fetchChildren</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchFilterOptions">fetchFilterOptions</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchMethodChildren">fetchMethodChildren</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchMethodNextLesson">fetchMethodNextLesson</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchNewReleases">fetchNewReleases</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchNextPreviousLesson">fetchNextPreviousLesson</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchPackAll">fetchPackAll</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchPackChildren">fetchPackChildren</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchRelatedLessons">fetchRelatedLessons</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchRelatedSongs">fetchRelatedSongs</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchSanity">fetchSanity</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchSongById">fetchSongById</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchSongCount">fetchSongCount</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchUpcomingEvents">fetchUpcomingEvents</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#fetchWorkouts">fetchWorkouts</a></span></li>
+</nav>
+<div id="main">
+    <h1 class="page-title">index.js</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>
+/**
+ * Fetch a song by its document ID from Sanity.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} documentId - The ID of the document to fetch.
+ * @returns {Promise&lt;Object|null>} - The fetched song data or null if not found.
+ */
+export async function fetchSongById(config, documentId) {
+    const fields = [
+        'title',
+        '"thumbnail_url": thumbnail.asset->url',
+        '"style": genre[0]->name',
+        '"artist": artist->name',
+        'album',
+        'instrumentless',
+        'soundslice',
+        '"resources": resource[]{resource_url, resource_name}',
+    ];
+    const query = `
+    *[_type == "song" &amp;&amp; railcontent_id == ${documentId}]{
+      ${fields.join(', ')}
+    }`;
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch all artists with lessons available for a specific brand.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch artists.
+ * @returns {Promise&lt;Object|null>} - The fetched artist data or null if not found.
+ */
+export async function fetchArtists(config, brand) {
+    const query = `
+    *[_type == "artist"]{
+      name,
+      "lessonsCount": count(*[_type == "song" &amp;&amp; brand == "${brand}" &amp;&amp; references(^._id)])
+    }[lessonsCount > 0]`;
+    return fetchSanity(config, query, true);
+}
+/**
+ * Fetch related songs for a specific brand and song ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch related songs.
+ * @param {string} songId - The ID of the song to find related songs for.
+ * @returns {Promise&lt;Object|null>} - The fetched related songs data or null if not found.
+ */
+export async function fetchRelatedSongs(config, brand, songId) {
+    const query = `
+    *[_type == "song" &amp;&amp; railcontent_id == ${songId}]{
+      "data": array::unique([
+          ...(*[_type == "song" &amp;&amp; brand == "${brand}" &amp;&amp; railcontent_id != ${songId} &amp;&amp; references(^.artist->_id)]{
+          "type": _type,
+          "id": railcontent_id,
+          "url": web_url_path,
+          "published_on": published_on,
+          status,
+          "fields": [
+            {
+              "key": "title",
+              "value": title
+            },
+            {
+              "key": "artist",
+              "value": artist->name
+            },
+            {
+              "key": "difficulty",
+              "value": difficulty
+            },
+            {
+              "key": "length_in_seconds",
+              "value": soundslice[0].soundslice_length_in_second
+            }
+          ],
+          "data": [{
+            "key": "thumbnail_url",
+            "value": thumbnail.asset->url
+          }]
+        }[0...10]),
+          ...(*[_type == "song" &amp;&amp; brand == "${brand}" &amp;&amp; railcontent_id != ${songId} &amp;&amp; references(^.genre[]->_id)]{
+          "type": _type,
+          "id": railcontent_id,
+          "url": web_url_path,
+          "published_on": published_on,
+          status,
+          "fields": [
+            {
+              "key": "title",
+              "value": title
+            },
+            {
+              "key": "artist",
+              "value": artist->name
+            },
+            {
+              "key": "difficulty",
+              "value": difficulty
+            },
+            {
+              "key": "length_in_seconds",
+              "value": soundslice[0].soundslice_length_in_second
+            }
+          ],
+          "data": [{
+            "key": "thumbnail_url",
+            "value": thumbnail.asset->url
+          }]
+        }[0...10])
+      ])[0...10]
+    }`;
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch all songs for a specific brand with pagination and search options.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch songs.
+ * @param {Object} params - Parameters for pagination, filtering, and sorting.
+ * @param {number} [params.page=1] - The page number for pagination.
+ * @param {number} [params.limit=10] - The number of songs per page.
+ * @param {string} [params.searchTerm=""] - The search term to filter songs by title or artist.
+ * @param {string} [params.sort="-published_on"] - The field to sort the songs by.
+ * @param {Array&lt;string>} [params.includedFields=[]] - The fields to include in the query.
+ * @param {string} [params.groupBy=""] - The field to group the results by.
+ * @returns {Promise&lt;Object|null>} - The fetched song data or null if not found.
+ */
+export async function fetchAllSongs(config, brand, { page = 1, limit = 10, searchTerm = "", sort = "-published_on", includedFields = [] , groupBy = "" }) {
+    console.log('groupBy', groupBy)
+    const start = (page - 1) * limit;
+    const end = start + limit;
+    // Construct the search filter
+    const searchFilter = searchTerm
+        ? `&amp;&amp; (artist->name match "${searchTerm}*" || title match "${searchTerm}*")`
+        : "";
+    // Construct the included fields filter, replacing 'difficulty' with 'difficulty_string'
+    const includedFieldsFilter = includedFields.length > 0
+        ? includedFields.map(field => {
+            let [key, value] = field.split(',');
+            if (key === 'difficulty') {
+                key = 'difficulty_string';
+            }
+            return `&amp;&amp; ${key} == "${value}"`;
+        }).join(' ')
+        : "";
+    // Determine the sort order
+    let sortOrder;
+    switch (sort) {
+        case "slug":
+            sortOrder = "artist->name asc";
+            break;
+        case "published_on":
+            sortOrder = "published_on desc";
+            break;
+        case "-published_on":
+            sortOrder = "published_on asc";
+            break;
+        case "-slug":
+            sortOrder = "artist->name desc";
+            break;
+        case "-popularity":
+            sortOrder = "popularity desc";
+            break;
+        default:
+            sortOrder = "published_on asc";
+            break;
+    }
+    // Determine the group by clause
+    let query = "";
+    if (groupBy === "artist") {
+        query = `
+      {
+        "total": count(*[_type == 'artist' &amp;&amp; count(*[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == artist._ref ]._id) > 0]),
+        "entity": *[_type == 'artist' &amp;&amp; count(*[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == artist._ref ]._id) > 0]
+          {
+            'id': _id,
+            'type': _type,
+            name,
+            'head_shot_picture_url': thumbnail_url.asset->url,
+            'all_lessons_count': count(*[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == artist._ref ]._id),
+            'lessons': *[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == artist._ref ]{
+              railcontent_id,
+              title,
+              "image": thumbnail.asset->url,
+              "artist_name": artist->name,
+              artist,
+              difficulty,
+              difficulty_string,
+              web_url_path,
+              published_on
+            }[0...10]
+          }
+        |order(${sortOrder})
+        [${start}...${end}]
+      }`;
+    } else if (groupBy === "genre") {
+        query = `
+      {
+        "total": count(*[_type == 'genre'  &amp;&amp; count(*[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id in genre[]._ref ]._id) > 0]),
+        "entity":
+          *[_type == 'genre'  &amp;&amp; count(*[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id in genre[]._ref ]._id)>0]
+          {
+            'id': _id,
+            'type': _type,
+            name,
+            'head_shot_picture_url': thumbnail_url.asset->url,
+            'all_lessons_count': count(*[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id in genre[]._ref ]._id),
+            'lessons': *[_type == 'song' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id in genre[]._ref ]{
+              railcontent_id,
+              title,
+              "image": thumbnail.asset->url,
+              "artist_name": artist->name,
+              artist,
+              difficulty,
+              difficulty_string,
+              web_url_path,
+              published_on
+            }[0...10]
+          }
+        |order(${sortOrder})
+        [${start}...${end}]
+      }`;
+    } else {
+        query = `
+      {
+        "entity": *[_type == 'song' &amp;&amp; brand == "${brand}" ${searchFilter} ${includedFieldsFilter}] | order(${sortOrder}) [${start}...${end}] {
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        },
+        "total": count(*[_type == 'song' &amp;&amp; brand == "${brand}" ${searchFilter} ${includedFieldsFilter}])
+      }
+    `;
+    }
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch filter options for a specific brand.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch filter options.
+ * @returns {Promise&lt;Object|null>} - The fetched filter options or null if not found.
+ */
+export async function fetchFilterOptions(config, brand) {
+    const query = `
+    {
+      "difficulty": [
+        {"type": "Introductory", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; difficulty_string == "Introductory"]._id)},
+        {"type": "Beginner", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; difficulty_string == "Beginner"]._id)},
+        {"type": "Intermediate", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; difficulty_string == "Intermediate"]._id)},
+        {"type": "Advanced", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; difficulty_string == "Advanced"]._id)},
+        {"type": "Expert", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; difficulty_string == "Expert"]._id)}
+      ],
+      "genre": *[_type == 'genre' &amp;&amp; 'song' in filter_types] {
+        "type": name,
+        "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; references(^._id)]._id)
+      },
+      "instrumentless": [
+        {"type": "Full Song Only", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; instrumentless == false]._id)},
+        {"type": "Instrument Removed", "count": count(*[_type == 'song' &amp;&amp; brand == ${brand} &amp;&amp; instrumentless == true]._id)}
+      ]
+    }
+  `;
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch the total count of songs for a specific brand.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch the song count.
+ * @returns {Promise&lt;number|null>} - The total count of songs or null if an error occurs.
+ */
+export async function fetchSongCount(config, brand) {
+    const query = `count(*[_type == 'song' &amp;&amp; brand == "${brand}"])`;
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch the latest workouts for the home page of a specific brand.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch workouts.
+ * @returns {Promise&lt;Object|null>} - The fetched workout data or null if not found.
+ */
+export async function fetchWorkouts(config, brand) {
+    const query = `*[_type == 'workout' &amp;&amp; brand == '${brand}'] [0...5] {
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        } | order(published_on desc)[0...5]`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch the latest new releases for a specific brand.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch new releases.
+ * @returns {Promise&lt;Object|null>} - The fetched new releases data or null if not found.
+ */
+export async function fetchNewReleases(config, brand) {
+    const newTypes = {
+        'drumeo': ["drum-fest-international-2022", "spotlight", "the-history-of-electronic-drums", "backstage-secrets", "quick-tips", "question-and-answer", "student-collaborations", "live-streams", "live", "podcasts", "solos", "boot-camps", "gear-guides", "performances", "in-rhythm", "challenges", "on-the-road", "diy-drum-experiments", "rhythmic-adventures-of-captain-carson", "study-the-greats", "rhythms-from-another-planet", "tama-drums", "paiste-cymbals", "behind-the-scenes", "exploring-beats", "sonor-drums", "course", "play-along", "student-focus", "coach-stream", "learning-path-level", "unit", "quick-tips", "live", "question-and-answer", "student-review", "boot-camps", "song", "chords-and-scales", "pack", "podcasts", "workout", "challenge", "challenge-part"],
+        'pianote': ["student-review", "student-reviews", "question-and-answer", "course", "play-along", "student-focus", "coach-stream", "learning-path-level", "unit", "quick-tips", "live", "question-and-answer", "student-review", "boot-camps", "song", "chords-and-scales", "pack", "podcasts", "workout", "challenge", "challenge-part"],
+        'guitareo': ["student-review", "student-reviews", "question-and-answer", "archives", "recording", "course", "play-along", "student-focus", "coach-stream", "learning-path-level", "unit", "quick-tips", "live", "question-and-answer", "student-review", "boot-camps", "song", "chords-and-scales", "pack", "podcasts", "workout", "challenge", "challenge-part"],
+        'singeo': ["student-review", "student-reviews", "question-and-answer", "course", "play-along", "student-focus", "coach-stream", "learning-path-level", "unit", "quick-tips", "live", "question-and-answer", "student-review", "boot-camps", "song", "chords-and-scales", "pack", "podcasts", "workout", "challenge", "challenge-part"],
+        'default': ["student-review", "student-reviews", "question-and-answer", "course", "play-along", "student-focus", "coach-stream", "learning-path-level", "unit", "quick-tips", "live", "question-and-answer", "student-review", "boot-camps", "song", "chords-and-scales", "pack", "podcasts", "workout", "challenge", "challenge-part"]
+    };
+    const typesString = arrayJoinWithQuotes(newTypes[brand] ?? newTypes['default']);
+    const query = `*[_type in [${typesString}] &amp;&amp; brand == '${brand}'] | order(releaseDate desc) [0...5] {
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        } | order(published_on desc)[0...5]`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch upcoming events for a specific brand.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} brand - The brand for which to fetch upcoming events.
+ * @returns {Promise&lt;Object|null>} - The fetched upcoming events data or null if not found.
+ */
+export async function fetchUpcomingEvents(config, brand) {
+    const liveTypes = {
+        'drumeo': ["drum-fest-international-2022", "spotlight", "the-history-of-electronic-drums", "backstage-secrets", "quick-tips", "question-and-answer", "student-collaborations", "live-streams", "live", "podcasts", "solos", "boot-camps", "gear-guides", "performances", "in-rhythm", "challenges", "on-the-road", "diy-drum-experiments", "rhythmic-adventures-of-captain-carson", "study-the-greats", "rhythms-from-another-planet", "tama-drums", "paiste-cymbals", "behind-the-scenes", "exploring-beats", "sonor-drums", "student-focus", "coach-stream", "live", "question-and-answer", "student-review", "boot-camps", "recording", "pack-bundle-lesson"],
+        'pianote': ["student-review", "student-reviews", "question-and-answer", "student-focus", "coach-stream", "live", "question-and-answer", "student-review", "boot-camps", "recording", "pack-bundle-lesson"],
+        'guitareo': ["student-review", "student-reviews", "question-and-answer", "archives", "recording", "student-focus", "coach-stream", "live", "question-and-answer", "student-review", "boot-camps", "recording", "pack-bundle-lesson"],
+        'singeo': ["student-review", "student-reviews", "question-and-answer", "student-focus", "coach-stream", "live", "question-and-answer", "student-review", "boot-camps", "recording", "pack-bundle-lesson"],
+        'default': ["student-review", "student-reviews", "question-and-answer", "student-focus", "coach-stream", "live", "question-and-answer", "student-review", "boot-camps", "recording", "pack-bundle-lesson"]
+    };
+    const typesString = arrayJoinWithQuotes(liveTypes[brand] ?? liveTypes['default']);
+    const now = getSanityDate(new Date());
+    //TODO: status = 'scheduled'  is this handled in sanity?
+    const query = `*[_type in [${typesString}] &amp;&amp; brand == '${brand}' &amp;&amp; published_on > '${now}']{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        } | order(published_on asc)[0...5]`;
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch content by a specific Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} id - The Railcontent ID of the content to fetch.
+ * @returns {Promise&lt;Object|null>} - The fetched content data or null if not found.
+ */
+export async function fetchByRailContentId(config, id) {
+    const query = `*[railcontent_id = ${id}]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        }`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch content by an array of Railcontent IDs.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {Array&lt;string>} ids - The array of Railcontent IDs of the content to fetch.
+ * @returns {Promise&lt;Array&lt;Object>|null>} - The fetched content data or null if not found.
+ */
+export async function fetchByRailContentIds(config, ids) {
+    const idsString = ids.join(',');
+    const query = `*[railcontent_id in [${idsString}]]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        }`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch all content for a specific brand and type with pagination, search, and grouping options.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @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&lt;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').
+ * @returns {Promise&lt;Object|null>} - The fetched content data or null if not found.
+ */
+export async function fetchAll(config, brand, type, { page = 1, limit = 10, searchTerm = "", sort = "-published_on", includedFields = [], groupBy = "" }) {
+    const start = (page - 1) * limit;
+    const end = start + limit;
+    // Construct the search filter
+    const searchFilter = searchTerm
+        ? `&amp;&amp; (artist->name match "${searchTerm}*" || title match "${searchTerm}*")`
+        : "";
+    // Construct the included fields filter, replacing 'difficulty' with 'difficulty_string'
+    const includedFieldsFilter = includedFields.length > 0
+        ? includedFields.map(field => {
+            let [key, value] = field.split(',');
+            if (key === 'difficulty') {
+                key = 'difficulty_string';
+            }
+            return `&amp;&amp; ${key} == "${value}"`;
+        }).join(' ')
+        : "";
+    // Determine the sort order
+    let sortOrder;
+    switch (sort) {
+        case "slug":
+            sortOrder = "artist->name asc";
+            break;
+        case "published_on":
+            sortOrder = "published_on desc";
+            break;
+        case "-published_on":
+            sortOrder = "published_on asc";
+            break;
+        case "-slug":
+            sortOrder = "artist->name desc";
+            break;
+        case "-popularity":
+            sortOrder = "popularity desc";
+            break;
+        default:
+            sortOrder = "published_on asc";
+            break;
+    }
+    // Determine the group by clause
+    let query = "";
+    if (groupBy !== "") {
+        query = `
+        {
+            "total": count(*[_type == '${groupBy}' &amp;&amp; count(*[_type == '${type}' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == ${groupBy}._ref ]._id) > 0]),
+            "entity": *[_type == '${groupBy}' &amp;&amp; count(*[_type == '${type}' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == ${groupBy}._ref ]._id) > 0]
+            {
+                'id': _id,
+                'type': _type,
+                name,
+                'head_shot_picture_url': thumbnail_url.asset->url,
+                'all_lessons_count': count(*[_type == '${type}' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == ${groupBy}._ref ]._id),
+                'lessons': *[_type == '${type}' &amp;&amp; brand == '${brand}' &amp;&amp; ^._id == ${groupBy}._ref ]{
+                railcontent_id,
+                title,
+                "image": thumbnail.asset->url,
+                difficulty,
+                difficulty_string,
+                web_url_path,
+                published_on,
+                ${groupBy}
+                }[0...10]
+            }
+            |order(${sortOrder})
+            [${start}...${end}]
+        }`;
+    } else {
+        query = `
+        {
+            "entity": *[_type == '${type}' &amp;&amp; brand == "${brand}" ${searchFilter} ${includedFieldsFilter}] | order(${sortOrder}) [${start}...${end}] {
+            railcontent_id,
+            title,
+            "image": thumbnail.asset->url,
+            difficulty,
+            difficulty_string,
+            web_url_path,
+            published_on
+            },
+            "total": count(*[_type == '${type}' &amp;&amp; brand == "${brand}" ${searchFilter} ${includedFieldsFilter}])
+        }
+    `;
+    }
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch children content by Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the parent content.
+ * @returns {Promise&lt;Array&lt;Object>|null>} - The fetched children content data or null if not found.
+ */
+export async function fetchChildren(config, railcontentId) {
+    //TODO: Implement getByParentId include sum XP
+    const query = `*[_railcontent_id == ${railcontentId}]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        } | order(published_on asc)`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch the next lesson for a specific method by Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the current lesson.
+ * @returns {Promise&lt;Object|null>} - The fetched next lesson data or null if not found.
+ */
+export async function fetchMethodNextLesson(config, railcontentId) {
+    //TODO: Implement getNextContentForParentContentForUser
+    const query = `*[_railcontent_id == ${railcontentId}]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        }`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch all children of a specific method by Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the method.
+ * @returns {Promise&lt;Array&lt;Object>|null>} - The fetched children data or null if not found.
+ */
+export async function fetchMethodChildren(config, railcontentId) {
+    //TODO: Implement getByParentId include sum XP
+    return fetchChildren(railcontentId);
+}
+/**
+ * Fetch the next and previous lessons for a specific lesson by Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the current lesson.
+ * @returns {Promise&lt;Object|null>} - The fetched next and previous lesson data or null if found.
+ */
+export async function fetchNextPreviousLesson(config, railcontentId) {
+    //TODO: Implement getTypeNeighbouringSiblings/getNextAndPreviousLessons
+    const query = `*[_railcontent_id == ${railcontentId}]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        }`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch related lessons for a specific lesson by Railcontent ID and type.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the current lesson.
+ * @param {string} type - The type of related lessons to fetch.
+ * @returns {Promise&lt;Array&lt;Object>|null>} - The fetched related lessons data or null if not found.
+ */
+export async function fetchRelatedLessons(config, railcontentId, type) {
+    let sort = 'published_on'
+    if (type == 'rhythmic-adventures-of-captain-carson' ||
+        type == 'diy-drum-experiments' ||
+        type == 'in-rhythm') {
+        sort = 'sort';
+    }
+    //TODO: Implement $this->contentService->getFiltered
+    const query = `*[_railcontent_id == ${railcontentId}]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        } | order(published_on asc)[0...5]`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch all content for a specific pack by Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the pack.
+ * @returns {Promise&lt;Array&lt;Object>|null>} - The fetched pack content data or null if not found.
+ */
+export async function fetchPackAll(config, railcontentId) {
+    //TODO: Implement getPacks
+    const query = `*[_railcontent_id == ${railcontentId}]{
+          railcontent_id,
+          title,
+          "image": thumbnail.asset->url,
+          "artist_name": artist->name,
+          artist,
+          difficulty,
+          difficulty_string,
+          web_url_path,
+          published_on
+        } | order(published_on asc)[0...5]`
+    return fetchSanity(config, query);
+}
+/**
+ * Fetch all children of a specific pack by Railcontent ID.
+ * @param {Object} config - Configuration object containing token, projectId, dataset, version, and debug.
+ * @param {string} railcontentId - The Railcontent ID of the pack.
+ * @returns {Promise&lt;Array&lt;Object>|null>} - The fetched pack children data or null if not found.
+ */
+export async function fetchPackChildren(config, railcontentId) {
+    return fetchChildren(railcontentId, 'pack');
+}
+/**
+ * Fetch data from the Sanity API based on a provided query.
+ * @param {Object} config - Configuration object containing the Sanity API settings.
+ * @param {string} config.token - The API token for authenticating with Sanity.
+ * @param {string} config.projectId - The project ID in Sanity.
+ * @param {string} config.dataset - The dataset name in Sanity.
+ * @param {string} config.version - The API version to use.
+ * @param {boolean} [config.debug=false] - Flag to enable debug mode, which logs the query and results.
+ * @param {string} query - The GROQ query to execute against the Sanity API.
+ * @returns {Promise&lt;Object|null>} - The first result from the query, or null if an error occurs or no results are found.
+ */
+async function fetchSanity({ token, projectId, dataset, version, debug = false }, query, isList = false) {
+    if (debug) {
+        console.log("fetchSanity Query:", query);
+    }
+    const encodedQuery = encodeURIComponent(query);
+    const url = `https://${projectId}.apicdn.sanity.io/v${version}/data/query/${dataset}?query=${encodedQuery}`;
+    const headers = {
+        'Authorization': `Bearer ${token}`,
+        'Content-Type': 'application/json'
+    };
+    try {
+        const response = await fetch(url, {headers});
+        const result = await response.json();
+        if (result.result) {
+            if (debug) {
+                console.log("fetchSanity Results:", result.result);
+            }
+            return isList ? result.result : result.result[0];
+        } else {
+            throw new Error('No results found');
+        }
+    } catch (error) {
+        console.error('sanityQueryService: Fetch error:', error);
+        return null;
+    }
+}
+function arrayJoinWithQuotes(array, delimiter = ',') {
+    const wrapped = array.map(value => `'${value}'`);
+    return wrapped.join(delimiter)
+}
+function getSanityDate(date) {
+    return date.toISOString();
+}
+</code></pre>
+        </article>
+    </section>
+</div>
+<br class="clear">
+<footer>
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.3</a> on Fri Aug 09 2024 20:57:53 GMT+0000 (Coordinated Universal Time) using the Minami theme.
+</footer>
+<script>prettyPrint();</script>
+<script src="scripts/linenumber.js"></script>
+</body>
+</html>