feat: update identifier

Author: ChengShi-1

docs/useCases.md

@@ -1427,6 +1427,7 @@ The above example would submit feedback to all contacts of a object where the ob
 In ContactDTO, it takes the following information:
 
 - **targetId**: the numeric identifier of the collection, dataset, or datafile. Persistent ids and collection aliases are not supported. (Optional)
+- **identifier**: the alias of a collection or the persistence id of a dataset or datafile. (Optional)
 - **subject**: the email subject line
 - **body**: the email body to send
 - **fromEmail**: the email to list in the reply-to field.

src/contactInfo/domain/dtos/ContactDTO.ts

@@ -1,5 +1,6 @@
 export interface ContactDTO {
   targetId?: number
+  identifier?: string
   subject: string
   body: string
   fromEmail: string

test/functional/contact/SubmitContactInfo.test.ts

@@ -52,6 +52,21 @@ describe('submitContactInfo', () => {
     }
   })
 
+  test('should return Contact when contact info is successfully submitted', async () => {
+    const test2ContactDTO: ContactDTO = {
+      identifier: 'root',
+      subject: 'Data Question',
+      body: 'Please help me understand your data. Thank you!',
+      fromEmail: '[email protected]'
+    }
+    const contactInfo = await submitContactInfo.execute(test2ContactDTO)
+
+    expect(contactInfo).toBeDefined()
+    expect(contactInfo[0].fromEmail).toEqual(test2ContactDTO.fromEmail)
+    expect(contactInfo[0].subject).toEqual(expect.any(String))
+    expect(contactInfo[0].body).toEqual(expect.any(String))
+  })
+
   test('should return error if the target id is unexisted', async () => {
     const contactDTO: ContactDTO = {
       targetId: 0,

test/integration/contact/ContactRepository.test.ts

@@ -19,17 +19,33 @@ describe('submitContactInfo', () => {
     fromEmail: '[email protected]'
   }
 
+  const test2ContactDTO: ContactDTO = {
+    identifier: 'root',
+    subject: 'Data Question',
+    body: 'Please help me understand your data. Thank you!',
+    fromEmail: '[email protected]'
+  }
+
   const sut: ContactRepository = new ContactRepository()
 
   test('should return Contact when contact info is successfully submitted', async () => {
-    const contactInfo = await sut.submitContactInfo(testContactDTO)
+    const contactInfo = await sut.submitContactInfo(test2ContactDTO)
 
     expect(contactInfo).toBeDefined()
     expect(contactInfo[0].fromEmail).toEqual(testContactDTO.fromEmail)
     expect(contactInfo[0].subject).toEqual(expect.any(String))
     expect(contactInfo[0].body).toEqual(expect.any(String))
   })
 
+  test('should return Contact when contact info is successfully submitted if accessed by identifier', async () => {
+    const contactInfo = await sut.submitContactInfo(testContactDTO)
+
+    expect(contactInfo).toBeDefined()
+    expect(contactInfo[0].fromEmail).toEqual(test2ContactDTO.fromEmail)
+    expect(contactInfo[0].subject).toEqual(expect.any(String))
+    expect(contactInfo[0].body).toEqual(expect.any(String))
+  })
+
   test('should return a Contact when targetId is not provided', async () => {
     const contactDTOWithoutTargetId: Partial<ContactDTO> = {
       subject: 'General Inquiry',