feat: infra domain and use cases

Author: g-saracca

src/collections/domain/models/CollectionFeaturedItem.ts

@@ -0,0 +1,7 @@
+export interface CollectionFeaturedItem {
+  id: number
+  content: string
+  imageFileName?: string
+  imageFileUrl?: string
+  displayOrder: number
+}

src/collections/domain/repositories/ICollectionsRepository.ts

@@ -1,6 +1,7 @@
 import { CollectionDTO } from '../dtos/CollectionDTO'
 import { Collection } from '../models/Collection'
 import { CollectionFacet } from '../models/CollectionFacet'
+import { CollectionFeaturedItem } from '../models/CollectionFeaturedItem'
 import { CollectionItemSubset } from '../models/CollectionItemSubset'
 import { CollectionSearchCriteria } from '../models/CollectionSearchCriteria'
 import { CollectionUserPermissions } from '../models/CollectionUserPermissions'
@@ -26,4 +27,7 @@ export interface ICollectionsRepository {
     collectionIdOrAlias: number | string,
     updatedCollection: CollectionDTO
   ): Promise<void>
+  getCollectionFeaturedItems(
+    collectionIdOrAlias: number | string
+  ): Promise<CollectionFeaturedItem[]>
 }

src/collections/domain/useCases/GetCollectionFeaturedItems.ts

@@ -0,0 +1,25 @@
+import { UseCase } from '../../../core/domain/useCases/UseCase'
+import { ICollectionsRepository } from '../repositories/ICollectionsRepository'
+import { ROOT_COLLECTION_ID } from '../models/Collection'
+import { CollectionFeaturedItem } from '../models/CollectionFeaturedItem'
+
+export class GetCollectionFeaturedItems implements UseCase<CollectionFeaturedItem[]> {
+  private collectionsRepository: ICollectionsRepository
+
+  constructor(collectionsRepository: ICollectionsRepository) {
+    this.collectionsRepository = collectionsRepository
+  }
+
+  /**
+   * Returns a CollectionFeaturedItem array containing the featured items of the requested collection, given the collection identifier or alias.
+   *
+   * @param {number | string} [collectionIdOrAlias = ':root'] - A generic collection identifier, which can be either a string (for queries by CollectionAlias), or a number (for queries by CollectionId)
+   * If this parameter is not set, the default value is: ':root'
+   * @returns {Promise<CollectionFeaturedItem>}
+   */
+  async execute(
+    collectionIdOrAlias: number | string = ROOT_COLLECTION_ID
+  ): Promise<CollectionFeaturedItem[]> {
+    return await this.collectionsRepository.getCollectionFeaturedItems(collectionIdOrAlias)
+  }
+}

src/collections/infra/repositories/CollectionsRepository.ts

@@ -17,6 +17,8 @@ import {
   SortType
 } from '../../domain/models/CollectionSearchCriteria'
 import { CollectionItemType } from '../../domain/models/CollectionItemType'
+import { CollectionFeaturedItem } from '../../domain/models/CollectionFeaturedItem'
+import { transformCollectionFeaturedItemsPayloadToCollectionFeaturedItems } from './transformers/collectionFeaturedItemsTransformer'
 
 export interface NewCollectionRequestPayload {
   alias: string
@@ -240,4 +242,16 @@ export class CollectionsRepository extends ApiRepository implements ICollections
       })
     }
   }
+
+  public async getCollectionFeaturedItems(
+    collectionIdOrAlias: number | string
+  ): Promise<CollectionFeaturedItem[]> {
+    return this.doGet(`/${this.collectionsResourceName}/${collectionIdOrAlias}/featuredItems`, true)
+      .then((response) =>
+        transformCollectionFeaturedItemsPayloadToCollectionFeaturedItems(response.data.data)
+      )
+      .catch((error) => {
+        throw error
+      })
+  }
 }

src/collections/infra/repositories/transformers/CollectionFeaturedItemPayload.ts

@@ -0,0 +1,7 @@
+export interface CollectionFeaturedItemPayload {
+  id: number
+  content: string
+  imageFileName: string | null
+  imageFileUrl: string | null
+  displayOrder: number
+}

src/collections/infra/repositories/transformers/collectionFeaturedItemsTransformer.ts

@@ -0,0 +1,14 @@
+import { CollectionFeaturedItem } from '../../../domain/models/CollectionFeaturedItem'
+import { CollectionFeaturedItemPayload } from './CollectionFeaturedItemPayload'
+
+export const transformCollectionFeaturedItemsPayloadToCollectionFeaturedItems = (
+  collectionFeaturedItemsPayload: CollectionFeaturedItemPayload[]
+): CollectionFeaturedItem[] => {
+  return collectionFeaturedItemsPayload.map((collectionFeaturedItemPayload) => ({
+    id: collectionFeaturedItemPayload.id,
+    content: collectionFeaturedItemPayload.content,
+    imageFileUrl: collectionFeaturedItemPayload.imageFileUrl,
+    imageFileName: collectionFeaturedItemPayload.imageFileName,
+    displayOrder: collectionFeaturedItemPayload.displayOrder
+  }))
+}