feat: allow supplying a comment with confirmRegistration

packages/gateway/src/features/registration/root-resolvers.ts

@@ -612,10 +612,7 @@ export const resolvers: GQLResolver = {
       }
 
       try {
-        const taskEntry = await confirmRegistration(id, authHeader, {
-          registrationNumber: details.registrationNumber,
-          identifiers: details.identifiers
-        })
+        const taskEntry = await confirmRegistration(id, authHeader, details)
 
         return taskEntry.resource.id
       } catch (error) {

packages/gateway/src/features/registration/schema.graphql

@@ -571,6 +571,7 @@ input IdentifierInput {
 input ConfirmRegistrationInput {
   registrationNumber: String!
   identifiers: [IdentifierInput!]
+  comment: String # For record audit
 }
 
 input RejectRegistrationInput {

packages/gateway/src/graphql/schema.d.ts

@@ -603,6 +603,7 @@ export interface GQLReinstated {
 export interface GQLConfirmRegistrationInput {
   registrationNumber: string
   identifiers?: Array<GQLIdentifierInput>
+  comment?: string
 }
 
 export interface GQLRejectRegistrationInput {

packages/gateway/src/graphql/schema.graphql

@@ -740,6 +740,7 @@ type Reinstated {
 input ConfirmRegistrationInput {
   registrationNumber: String!
   identifiers: [IdentifierInput!]
+  comment: String
 }
 
 input RejectRegistrationInput {

packages/gateway/src/workflow/index.ts

@@ -246,6 +246,7 @@ export async function confirmRegistration(
   details: {
     registrationNumber: string
     identifiers?: IdentifierInput[]
+    comment?: string
   }
 ) {
   const res: ReadyForReviewRecord = await createRequest(

packages/workflow/src/features/registration/handler.ts

@@ -25,7 +25,8 @@ import { SupportedPatientIdentifierCode } from '@opencrvs/commons/types'
 export interface EventRegistrationPayload {
   trackingId: string
   registrationNumber: string
-  error: string
+  error?: string
+  comment?: string
   identifiers?: {
     type: SupportedPatientIdentifierCode
     value: string
@@ -38,7 +39,7 @@ export async function markEventAsRegisteredCallbackHandler(
 ) {
   const token = getToken(request)
   const compositionId = request.params.id
-  const { registrationNumber, error, identifiers } =
+  const { registrationNumber, error, comment, identifiers } =
     request.payload as EventRegistrationPayload
 
   if (error) {
@@ -60,6 +61,7 @@ export async function markEventAsRegisteredCallbackHandler(
     savedRecord,
     registrationNumber,
     token,
+    comment,
     identifiers
   )
   const event = getEventType(bundle)

packages/workflow/src/records/fhir.ts

@@ -763,7 +763,10 @@ export function createWaitingForValidationTask(
   }
 }
 
-export function createRegisterTask(previousTask: SavedTask): Task {
+export function createRegisterTask(
+  previousTask: SavedTask,
+  comment?: string
+): Task {
   const timeLoggedMSExtension = previousTask.extension.find(
     (e) => e.url === 'http://opencrvs.org/specs/extension/timeLoggedMS'
   )!
@@ -774,7 +777,7 @@ export function createRegisterTask(previousTask: SavedTask): Task {
     'REGISTERED'
   )
 
-  const comments = previousTask?.note?.[0]?.text
+  const comments = comment ?? previousTask?.note?.[0]?.text
 
   return {
     ...registeredTask,

packages/workflow/src/records/state-transitions.ts

@@ -509,11 +509,14 @@ export async function toRegistered(
   record: WaitingForValidationRecord,
   registrationNumber: EventRegistrationPayload['registrationNumber'],
   token: string,
+  comment?: string,
   identifiers?: EventRegistrationPayload['identifiers']
 ): Promise<RegisteredRecord> {
   const previousTask = getTaskFromSavedBundle(record)
-  const registeredTaskWithoutPractitionerExtensions =
-    createRegisterTask(previousTask)
+  const registeredTaskWithoutPractitionerExtensions = createRegisterTask(
+    previousTask,
+    comment
+  )
 
   const [registeredTask, practitionerResourcesBundle] =
     await withPractitionerDetails(