Added: docs and minor tweaks

Author: GPortas

docs/useCases.md

@@ -11,6 +11,7 @@ The different use cases currently available in the package are classified below,
 - [Collections](#Collections)
   - [Collections read use cases](#collections-read-use-cases)
     - [Get a Collection](#get-a-collection)
+    - [Get Collection Facets](#get-collection-facets)
   - [Collections write use cases](#collections-write-use-cases)
     - [Create a Collection](#create-a-collection)
 - [Datasets](#Datasets)
@@ -100,6 +101,33 @@ The `collectionIdOrAlias` is a generic collection identifier, which can be eithe
 
 If no collection identifier is specified, the default collection identifier; `root` will be used. If you want to search for a different collection, you must add the collection identifier as a parameter in the use case call.
 
+#### Get Collection Facets
+
+Returns the names of the configured collection facets, given a collection identifier or alias.
+
+##### Example call:
+
+```typescript
+import { getCollectionFacets } from '@iqss/dataverse-client-javascript'
+
+const collectionIdOrAlias = 12345
+
+getCollectionFacets
+  .execute(collectionId)
+  .then((facets: string[]) => {
+    /* ... */
+  })
+  .catch((error: Error) => {
+    /* ... */
+  })
+```
+
+_See [use case](../src/collections/domain/useCases/GetCollectionFacets.ts)_ definition.
+
+The `collectionIdOrAlias` is a generic collection identifier, which can be either a string (for queries by CollectionAlias), or a number (for queries by CollectionId).
+
+If no collection identifier is specified, the default collection identifier; `root` will be used. If you want to search for a different collection, you must add the collection identifier as a parameter in the use case call.
+
 ### Collections Write Use Cases
 
 #### Create a Collection

src/collections/domain/dtos/CollectionDTO.ts

@@ -5,7 +5,7 @@ export interface CollectionDTO {
   type: CollectionType
   affiliation?: string
   description?: string
-  metadataBlockNames: string[]
+  metadataBlockNames?: string[]
   facetIds?: string[]
   inputLevels?: CollectionInputLevelDTO[]
 }

src/collections/domain/useCases/GetCollectionFacets.ts

@@ -14,7 +14,7 @@ export class GetCollectionFacets implements UseCase<string[]> {
    *
    * @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<Collection>}
+   * @returns {Promise<string[]>}
    */
   async execute(collectionIdOrAlias: number | string = ROOT_COLLECTION_ALIAS): Promise<string[]> {
     return await this.collectionsRepository.getCollectionFacets(collectionIdOrAlias)