API support for SPA Featured Items

[g-saracca]

Overview of the Feature Request
As a first iteration of this feature I think we should focus on creating custom featured items and then we could move on to creating featured collections, datasets and files.

We need two API endpoints:

• To create/modify the featured items.

• To get the featured items of a specific collection.

This could be the model of the objects returned by the endpoint 👇

type FeaturedItem = CustomFeaturedItem | DvObjectFeaturedItem

type CustomFeaturedItem = {
  type: 'custom'
  title: string
  content: string
  image?: {
    url: string
    altText: string
  }
}

type DvObjectFeaturedItem = {
  type: DvObjectType // 'collection' | 'dataset' | 'file'
  linkUrl: string
  title: string
  description?: string
}

What kind of user is the feature intended for?
API Users, SPA Users

What inspired the request?
Q4 Roadmap

What existing behavior do you want changed?
None

Any brand new behavior do you want to add to Dataverse?
Add the possibility to create featured items within a collection.

Any open or closed issues related to this feature request?
IQSS/dataverse-frontend#514