musora-content-services 2.79.1 → 2.80.0

package/src/services/content/artist.ts

@@ -0,0 +1,139 @@
+/**
+ * @module Artist
+ */
+import { DEFAULT_FIELDS, filtersToGroq } from '../../contentTypeConfig.js'
+import { FilterBuilder } from '../../filterBuilder.js'
+import { fetchSanity, getSanityDate, getSortOrder } from '../sanity.js'
+import { Lesson } from './content'
+
+export interface Artist {
+  slug: string
+  name: string
+  lessons?: Lesson[]
+  lessonsCount: number
+}
+
+/**
+ * Fetch all artists with lessons available for a specific brand.
+ *
+ * @param {string} brand - The brand for which to fetch artists.
+ * @returns {Promise<Artist[]|null>} - A promise that resolves to an array of artist objects or null if not found.
+ *
+ * @example
+ * fetchArtists('drumeo')
+ *   .then(artists => console.log(artists))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchArtists(brand: string): Promise<Artist[] | null> {
+  const filter = await new FilterBuilder(
+    `_type == "song" && brand == "${brand}" && references(^._id)`,
+    { bypassPermissions: true }
+  ).buildFilter()
+  const query = `
+  *[_type == "artist"]{
+    name,
+    "slug": slug.current,
+    "lessonsCount": count(*[${filter}])
+  }[lessonsCount > 0] |order(lower(name)) `
+  return fetchSanity(query, true, { processNeedAccess: false, processPageType: false })
+}
+
+/**
+ * Fetch a single artist by their Sanity ID.
+ *
+ * @param {string} slug - The name of the artist to fetch.
+ * @param {string} [brand] - The brand for which to fetch the artist.
+ * @returns {Promise<Artist|null>} - A promise that resolves to an artist objects or null if not found.
+ *
+ * @example
+ * fetchArtists('drumeo')
+ *   .then(artists => console.log(artists))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchArtistBySlug(slug: string, brand?: string): Promise<Artist | null> {
+  const brandFilter = brand ? `brand == "${brand}" && ` : ''
+  const filter = await new FilterBuilder(`${brandFilter} _type == "song" && references(^._id)`, {
+    bypassPermissions: true,
+  }).buildFilter()
+  const query = `
+  *[_type == "artist" && slug.current == '${slug}']{
+    name,
+    "slug": slug.current,
+    "lessonsCount": count(*[${filter}])
+  }[lessonsCount > 0] |order(lower(name)) `
+  return fetchSanity(query, true, { processNeedAccess: false, processPageType: false })
+}
+
+export interface ArtistLessonOptions {
+  sort?: string
+  searchTerm?: string
+  page?: number
+  limit?: number
+  includedFields?: Array<string>
+  progressIds?: Array<number>
+}
+
+export interface LessonsByArtistResponse {
+  entity: Artist[]
+}
+
+/**
+ * Fetch the artist's lessons.
+ * @param {string} brand - The brand for which to fetch lessons.
+ * @param {string} slug - The slug of the artist
+ * @param {string} contentType - The type of the lessons we need to get from the artist. If not defined, groq will get lessons from all content types
+ * @param {Object} params - Parameters for sorting, searching, pagination and filtering.
+ * @param {string} [params.sort="-published_on"] - The field to sort the lessons by.
+ * @param {string} [params.searchTerm=""] - The search term to filter the lessons.
+ * @param {number} [params.page=1] - The page number for pagination.
+ * @param {number} [params.limit=10] - The number of items per page.
+ * @param {Array<string>} [params.includedFields=[]] - Additional filters to apply to the query in the format of a key,value array. eg. ['difficulty,Intermediate', 'genre,rock'].
+ * @param {Array<number>} [params.progressIds] - The ids of the lessons that are in progress or completed
+ * @returns {Promise<LessonsByArtistResponse|null>} - The lessons for the artist and some details about the artist (name and thumbnail).
+ *
+ * @example
+ * fetchArtistLessons('drumeo', '10 Years', 'song', {'-published_on', '', 1, 10, ["difficulty,Intermediate"], [232168, 232824, 303375, 232194, 393125]})
+ *   .then(lessons => console.log(lessons))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchArtistLessons(
+  brand: string,
+  slug: string,
+  contentType: string,
+  {
+    sort = '-published_on',
+    searchTerm = '',
+    page = 1,
+    limit = 10,
+    includedFields = [],
+    progressIds = undefined,
+  }: ArtistLessonOptions = {}
+): Promise<LessonsByArtistResponse | null> {
+  const fieldsString = DEFAULT_FIELDS.join(',')
+  const start = (page - 1) * limit
+  const end = start + limit
+  const searchFilter = searchTerm ? `&& title match "${searchTerm}*"` : ''
+  const sortOrder = getSortOrder(sort, brand)
+  const addType =
+    contentType && Array.isArray(contentType)
+      ? `_type in ['${contentType.join("', '")}'] &&`
+      : contentType
+        ? `_type == '${contentType}' && `
+        : ''
+  const includedFieldsFilter = includedFields.length > 0 ? filtersToGroq(includedFields) : ''
+
+  // limits the results to supplied progressIds for started & completed filters
+  const progressFilter =
+    progressIds !== undefined ? `&& railcontent_id in [${progressIds.join(',')}]` : ''
+  const now = getSanityDate(new Date())
+  const query = `{
+    "entity":
+      *[_type == 'artist' && slug.current == '${slug}']
+        {'type': _type, name, 'thumbnail':thumbnail_url.asset->url,
+        'lessons_count': count(*[${addType} brand == '${brand}' && references(^._id)]),
+        'lessons': *[${addType} brand == '${brand}' && references(^._id) && (status in ['published'] || (status == 'scheduled' && defined(published_on) && published_on >= '${now}')) ${searchFilter} ${includedFieldsFilter} ${progressFilter}]{${fieldsString}}
+      [${start}...${end}]}
+      |order(${sortOrder})
+  }`
+  return fetchSanity(query, true)
+}

package/src/services/content/content.ts

@@ -0,0 +1,38 @@
+/**
+ * @namespace Content
+ * @property {module:Instructor} Instructor
+ * @property {module:Genre} Genre
+ * @property {module:Artist} Artist
+ */
+
+export type LessonType = 'workout' | 'challenge-part' | 'song' | string
+export type LessonPageType = 'lesson' | 'song' | string
+
+export interface ArtistObject {
+  name: string
+  thumbnail: string | null
+}
+
+export interface Lesson {
+  artist: ArtistObject | string | null
+  artist_name: string
+  brand: string
+  child_count: number | null
+  difficulty: number | null
+  difficulty_string: string | null
+  genre: string[] | string | null
+  id: number
+  image: string
+  length_in_seconds: number
+  parent_id: number | null
+  permission_id: number[]
+  published_on: string
+  sanity_id: string
+  slug: string
+  status: string
+  thumbnail: string
+  title: string
+  type: LessonType
+  need_access: boolean
+  page_type: LessonPageType
+}

package/src/services/content/genre.ts

@@ -0,0 +1,139 @@
+/**
+ * @module Genre
+ */
+import { DEFAULT_FIELDS, filtersToGroq } from '../../contentTypeConfig.js'
+import { fetchSanity, getSanityDate, getSortOrder } from '../sanity.js'
+import { FilterBuilder } from '../../filterBuilder.js'
+import { Lesson } from './content'
+
+export interface Genre {
+  lessons?: Lesson[]
+  lessons_count: number
+  name: string
+  slug: string
+  thumbnail: string
+  type: 'genre'
+}
+
+/**
+ * Fetch all genres with lessons available for a specific brand.
+ *
+ * @param {string} [brand] - The brand for which to fetch the genre for. Lesson count will be filtered by this brand if provided.
+ * @returns {Promise<Genre[]>} - A promise that resolves to an genre object or null if not found.
+ *
+ * @example
+ * fetchGenres('drumeo')
+ *   .then(genres => console.log(genres))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchGenres(brand: string): Promise<Genre[]> {
+  const filter = await new FilterBuilder(`brand == "${brand}" && references(^._id)`, {
+    bypassPermissions: true,
+  }).buildFilter()
+
+  const query = `
+  *[_type == 'genre'] {
+    'type': _type,
+    name,
+    "slug": slug.current,
+    'thumbnail': thumbnail_url.asset->url,
+    "lessons_count": count(*[${filter}])
+  } |order(lower(name)) `
+  return fetchSanity(query, true, { processNeedAccess: false, processPageType: false})
+}
+
+/**
+ * Fetch a single genre by their slug and brand
+ *
+ * @param {string} slug - The slug of the genre to fetch.
+ * @param {string} [brand] - The brand for which to fetch the genre. Lesson count will be filtered by this brand if provided.
+ * @returns {Promise<Genre[]|null>} - A promise that resolves to an genre object or null if not found.
+ *
+ * @example
+ * fetchGenreBySlug('drumeo')
+ *   .then(genres => console.log(genres))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchGenreBySlug(slug: string, brand?: string): Promise<Genre | null> {
+  const brandFilter = brand ? `brand == "${brand}" && ` : ''
+  const filter = await new FilterBuilder(`${brandFilter} references(^._id)`, {
+    bypassPermissions: true,
+  }).buildFilter()
+
+  const query = `
+  *[_type == 'genre' && slug.current == '${slug}'] {
+    'type': _type, name,
+    name,
+    "slug": slug.current,
+    'thumbnail':thumbnail_url.asset->url,
+    "lessonsCount": count(*[${filter}])
+  }`
+  return fetchSanity(query, true, { processNeedAccess: false, processPageType: false})
+}
+
+export interface FetchGenreLessonsOptions {
+  sort?: string
+  searchTerm?: string
+  page?: number
+  limit?: number
+  includedFields?: Array<string>
+  progressIds?: Array<number>
+}
+
+export interface LessonsByGenreResponse {
+  entity: Genre[]
+}
+
+/**
+ * Fetch the genre's lessons.
+ * @param {string} brand - The brand for which to fetch lessons.
+ * @param {string} slug - The slug of the genre
+ * @param {Object} params - Parameters for sorting, searching, pagination and filtering.
+ * @param {string} [params.sort="-published_on"] - The field to sort the lessons by.
+ * @param {string} [params.searchTerm=""] - The search term to filter the lessons.
+ * @param {number} [params.page=1] - The page number for pagination.
+ * @param {number} [params.limit=10] - The number of items per page.
+ * @param {Array<string>} [params.includedFields=[]] - Additional filters to apply to the query in the format of a key,value array. eg. ['difficulty,Intermediate', 'genre,rock'].
+ * @param {Array<number>} [params.progressIds=[]] - The ids of the lessons that are in progress or completed
+ * @returns {Promise<LessonsByGenreResponse>} - The lessons for the artist and some details about the artist (name and thumbnail).
+ *
+ * @example
+ * fetchGenreLessons('drumeo', 'Blues', 'song', {'-published_on', '', 1, 10, ["difficulty,Intermediate"], [232168, 232824, 303375, 232194, 393125]})
+ *   .then(lessons => console.log(lessons))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchGenreLessons(
+  brand: string,
+  slug: string,
+  contentType: string,
+  {
+    sort = '-published_on',
+    searchTerm = '',
+    page = 1,
+    limit = 10,
+    includedFields = [],
+    progressIds = [],
+  }: FetchGenreLessonsOptions = {}
+): Promise<LessonsByGenreResponse> {
+  const fieldsString = DEFAULT_FIELDS.join(',')
+  const start = (page - 1) * limit
+  const end = start + limit
+  const searchFilter = searchTerm ? `&& title match "${searchTerm}*"` : ''
+  const sortOrder = getSortOrder(sort, brand)
+  const addType = contentType ? `_type == '${contentType}' && ` : ''
+  const includedFieldsFilter = includedFields.length > 0 ? filtersToGroq(includedFields) : ''
+  // limits the results to supplied progressIds for started & completed filters
+  const progressFilter =
+    progressIds !== undefined ? `&& railcontent_id in [${progressIds.join(',')}]` : ''
+  const now = getSanityDate(new Date())
+  const query = `{
+    "entity":
+      *[_type == 'genre' && slug.current == '${slug}']
+        {'type': _type, name, 'thumbnail':thumbnail_url.asset->url,
+        'lessons_count': count(*[${addType} brand == '${brand}' && references(^._id)]),
+        'lessons': *[${addType} brand == '${brand}' && references(^._id) && (status in ['published'] || (status == 'scheduled' && defined(published_on) && published_on >= '${now}')) ${searchFilter} ${includedFieldsFilter} ${progressFilter}]{${fieldsString}}
+      [${start}...${end}]}
+      |order(${sortOrder})
+  }`
+  return fetchSanity(query, true)
+}

package/src/services/content/instructor.ts

@@ -0,0 +1,131 @@
+/**
+ * @module Instructor
+ */
+import { FilterBuilder } from '../../filterBuilder.js'
+import { filtersToGroq, getFieldsForContentType } from '../../contentTypeConfig.js'
+import { buildEntityAndTotalQuery, fetchSanity, getSortOrder } from '../sanity.js'
+import { Lesson } from './content'
+
+export interface Instructor {
+  lessonCount: number
+  slug: string
+  name: string
+  short_bio: string
+  thumbnail: string
+}
+
+/**
+ * Fetch all instructor with lessons available for a specific brand.
+ *
+ * @param {string} brand - The brand for which to fetch instructors.
+ * @returns {Promise<Instructor[]>} - A promise that resolves to an array of instructor objects.
+ *
+ * @example
+ * fetchInstructors('drumeo')
+ *   .then(instructors => console.log(instructors))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchInstructors(brand: string): Promise<Instructor[]> {
+  const filter = await new FilterBuilder(`brand == "${brand}" && references(^._id)`, {
+    bypassPermissions: true,
+  }).buildFilter()
+
+  const query = `
+  *[_type == "instructor"] {
+    name,
+    "slug": slug.current,
+    "lessonsCount": count(*[${filter}])
+  }[lessonsCount > 0] |order(lower(name)) `
+  return fetchSanity(query, true, { processNeedAccess: false, processPageType: false })
+}
+
+/**
+ * Fetch a single instructor by their name
+ *
+ * @param {string} slug - The slug of the instructor to fetch.
+ * @param {string} [brand] - The brand for which to fetch the instructor. Lesson count will be filtered by this brand if provided.
+ * @returns {Promise<Instructor[]>} - A promise that resolves to an instructor object or null if not found.
+ *
+ * @example
+ * fetchInstructorBySlug('66samus', 'drumeo')
+ *   .then(instructor => console.log(instructor))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchInstructorBySlug(
+  slug: string,
+  brand?: string
+): Promise<Instructor | null> {
+  const brandFilter = brand ? `brand == "${brand}" && ` : ''
+  const filter = await new FilterBuilder(`${brandFilter} references(^._id)`, {
+    bypassPermissions: true,
+  }).buildFilter()
+
+  const query = `
+  *[_type == "instructor" && slug.current == '${slug}'][0] {
+    name,
+    "slug": slug.current,
+    short_bio,
+    'thumbnail': thumbnail_url.asset->url,
+    "lessonsCount": count(*[${filter}])
+  }`
+  return fetchSanity(query, true, { processNeedAccess: false, processPageType: false })
+}
+
+export interface FetchInstructorLessonsOptions {
+  sortOrder?: string
+  searchTerm?: string
+  page?: number
+  limit?: number
+  includedFields?: Array<string>
+}
+
+export interface InstructorLessonsResponse {
+  entity: Lesson[]
+  total: number
+}
+
+/**
+ * Fetch the data needed for the instructor screen.
+ * @param {string} brand - The brand for which to fetch instructor lessons
+ * @param {string} slug - The slug of the instructor
+ *
+ * @param {FetchInstructorLessonsOptions} options - Parameters for pagination, filtering and sorting.
+ * @param {string} [options.sortOrder="-published_on"] - The field to sort the lessons by.
+ * @param {string} [options.searchTerm=""] - The search term to filter content by title.
+ * @param {number} [options.page=1] - The page number for pagination.
+ * @param {number} [options.limit=10] - The number of items per page.
+ * @param {Array<string>} [options.includedFields=[]] - Additional filters to apply to the query in the format of a key,value array. eg. ['difficulty,Intermediate', 'genre,rock'].
+ *
+ * @returns {Promise<InstructorLessonsResponse>} - The lessons for the instructor or null if not found.
+ * @example
+ * fetchInstructorLessons('instructor123')
+ *   .then(lessons => console.log(lessons))
+ *   .catch(error => console.error(error));
+ */
+export async function fetchInstructorLessons(
+  slug: string,
+  brand: string,
+  {
+    sortOrder = '-published_on',
+    searchTerm = '',
+    page = 1,
+    limit = 20,
+    includedFields = [],
+  }: FetchInstructorLessonsOptions = {}
+): Promise<InstructorLessonsResponse> {
+  const fieldsString = getFieldsForContentType() as string
+  const start = (page - 1) * limit
+  const end = start + limit
+  const searchFilter = searchTerm ? `&& title match "${searchTerm}*"` : ''
+  const includedFieldsFilter = includedFields.length > 0 ? filtersToGroq(includedFields) : ''
+  const filter = `brand == '${brand}' ${searchFilter} ${includedFieldsFilter} && references(*[_type=='instructor' && slug.current == '${slug}']._id)`
+  const filterWithRestrictions = await new FilterBuilder(filter).buildFilter()
+
+  sortOrder = getSortOrder(sortOrder, brand)
+  const query = buildEntityAndTotalQuery(filterWithRestrictions, fieldsString, {
+    sortOrder: sortOrder,
+    start: start,
+    end: end,
+  })
+  return fetchSanity(query, true)
+}