@opencrvs/toolkit 2.0.0-rc.fdc585a → 2.0.0-rc.fe94e41

package/dist/events/index.js

@@ -213,6 +213,10 @@ __export(events_exports, {
   UUID: () => UUID,
   UnassignActionInput: () => UnassignActionInput,
   UserAuditRecordInput: () => UserAuditRecordInput,
+  V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS,
+  V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP,
+  V2_DEFAULT_MOCK_LOCATIONS: () => V2_DEFAULT_MOCK_LOCATIONS,
+  V2_DEFAULT_MOCK_LOCATIONS_MAP: () => V2_DEFAULT_MOCK_LOCATIONS_MAP,
   ValidationConfig: () => ValidationConfig,
   VerificationActionConfig: () => VerificationActionConfig,
   VerificationPageConfig: () => VerificationPageConfig,
@@ -234,6 +238,7 @@ __export(events_exports, {
   ageToDate: () => ageToDate,
   aggregateActionAnnotations: () => aggregateActionAnnotations,
   aggregateActionDeclarations: () => aggregateActionDeclarations,
+  always: () => always,
   alwaysTrue: () => alwaysTrue,
   and: () => and,
   annotationActions: () => annotationActions,
@@ -277,6 +282,7 @@ __export(events_exports, {
   findActiveDraftForEvent: () => findActiveDraftForEvent,
   findAllFields: () => findAllFields,
   findLastAssignmentAction: () => findLastAssignmentAction,
+  findPendingCorrectionAction: () => findPendingCorrectionAction,
   findRecordActionPages: () => findRecordActionPages,
   flag: () => flag,
   flattenFieldReference: () => flattenFieldReference,
@@ -302,13 +308,15 @@ __export(events_exports, {
   getActionConfig: () => getActionConfig,
   getActionReview: () => getActionReview,
   getActionReviewFields: () => getActionReviewFields,
+  getAdministrativeAreaHierarchy: () => getAdministrativeAreaHierarchy,
   getAllUniqueFields: () => getAllUniqueFields,
   getAnnotationFromDrafts: () => getAnnotationFromDrafts,
   getAssignedUserFromActions: () => getAssignedUserFromActions,
-  getAssignedUserSignatureFromActions: () => getAssignedUserSignatureFromActions,
   getAssignmentStatus: () => getAssignmentStatus,
   getAvailableActionsForEvent: () => getAvailableActionsForEvent,
+  getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
   getCompleteActionAnnotation: () => getCompleteActionAnnotation,
+  getCompleteActionContent: () => getCompleteActionContent,
   getCompleteActionDeclaration: () => getCompleteActionDeclaration,
   getCurrentEventState: () => getCurrentEventState,
   getCustomActionFields: () => getCustomActionFields,
@@ -317,7 +325,9 @@ __export(events_exports, {
   getDeclarationFields: () => getDeclarationFields,
   getDeclarationPages: () => getDeclarationPages,
   getEventConfigById: () => getEventConfigById,
+  getEventFlags: () => getEventFlags,
   getFilePathsFromEvent: () => getFilePathsFromEvent,
+  getLocationHierarchy: () => getLocationHierarchy,
   getMixedPath: () => getMixedPath,
   getPendingAction: () => getPendingAction,
   getPrintCertificatePages: () => getPrintCertificatePages,
@@ -378,6 +388,7 @@ __export(events_exports, {
   isPageVisible: () => isPageVisible,
   isParagraphFieldType: () => isParagraphFieldType,
   isPhoneFieldType: () => isPhoneFieldType,
+  isPotentialDuplicate: () => isPotentialDuplicate,
   isPrintButtonFieldType: () => isPrintButtonFieldType,
   isQrReaderFieldType: () => isQrReaderFieldType,
   isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -411,6 +422,7 @@ __export(events_exports, {
   plainDateToLocalDate: () => plainDateToLocalDate,
   precompileActionSchemas: () => precompileActionSchemas,
   resolveDateOfEvent: () => resolveDateOfEvent,
+  resolveEventCustomFlags: () => resolveEventCustomFlags,
   resolvePlaceOfEvent: () => resolvePlaceOfEvent,
   runFieldValidations: () => runFieldValidations,
   runStructuralValidations: () => runStructuralValidations,
@@ -702,7 +714,9 @@ var decodeScope = (query) => {
 };
 var DEFAULT_SCOPE_OPTIONS = {
   placeOfEvent: JurisdictionFilter.enum.all,
-  accessLevel: JurisdictionFilter.enum.all
+  accessLevel: JurisdictionFilter.enum.all,
+  registeredIn: JurisdictionFilter.enum.all,
+  declaredIn: JurisdictionFilter.enum.all
 };
 function getAcceptedScopesByType({
   acceptedScopes,
@@ -1075,7 +1089,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
   ShowConditional,
   // Action can be shown to the user in the list but as disabled
   EnableConditional
-]);
+]).meta({
+  id: "ActionConditional",
+  description: "Conditional gating whether an action is shown (SHOW) or enabled (ENABLE). When omitted from an action, the action is shown and enabled for everyone."
+});
 var DisplayOnReviewConditional = z7.object({
   type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
   conditional: Conditional
@@ -1090,8 +1107,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
   // Field output can be shown / hidden on the review page
   DisplayOnReviewConditional
 ]).meta({
-  description: "Field conditional configuration",
-  id: "FieldConditional"
+  id: "FieldConditional",
+  description: "Conditional gating whether a form field is shown (SHOW), enabled (ENABLE), or displayed on the review page (DISPLAY_ON_REVIEW). When omitted, the field is shown and enabled for everyone, and is displayed on review whenever it has a value."
 });
 
 // ../commons/src/events/FieldType.ts
@@ -1411,28 +1428,20 @@ function schemaPriority(schema) {
   return idx === -1 ? 9999 : idx;
 }
 function safeUnion(schemas) {
+  const sortedSchemas = [...schemas].sort(
+    (a, b) => schemaPriority(a) - schemaPriority(b)
+  );
   return z12.any().superRefine((val, ctx) => {
-    const successful = schemas.filter((s) => s.safeParse(val).success);
-    if (successful.length === 1) {
-      return;
-    }
-    if (successful.length === 0) {
-      ctx.addIssue({
-        code: "invalid_type",
-        expected: "custom",
-        message: "Value does not match any schema"
-      });
-      return;
-    }
-    successful.sort((a, b) => schemaPriority(a) - schemaPriority(b));
-    const best = successful[0];
-    if (!best.safeParse(val).success) {
-      ctx.addIssue({
-        expected: "custom",
-        code: "invalid_type",
-        message: "Value did not match the best schema"
-      });
+    for (const schema of sortedSchemas) {
+      if (schema.safeParse(val).success) {
+        return;
+      }
     }
+    ctx.addIssue({
+      code: "invalid_type",
+      expected: "custom",
+      message: "Value does not match any schema"
+    });
   }).meta({
     description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
   });
@@ -1649,8 +1658,9 @@ var RequestedCorrectionAction = ActionBase.extend(
 var ApprovedCorrectionAction = ActionBase.extend(
   z14.object({
     type: z14.literal(ActionType.APPROVE_CORRECTION),
-    requestId: z14.string()
+    requestId: z14.string(),
     // TODO move into 'content' property
+    content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
   }).shape
 );
 var RejectedCorrectionAction = ActionBase.extend(
@@ -1742,6 +1752,9 @@ var FlagConfig = z15.object({
     "Indicates if this flag expects an action to be performed to be cleared."
   ),
   label: TranslationConfig.describe("Human readable label of the flag.")
+}).meta({
+  id: "FlagConfig",
+  description: "Configuration for a custom flag that can be added to or removed from records by event actions."
 });
 var ActionFlagConfig = z15.object({
   id: Flag,
@@ -1749,6 +1762,9 @@ var ActionFlagConfig = z15.object({
   conditional: Conditional.optional().describe(
     "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
   )
+}).meta({
+  id: "ActionFlagConfig",
+  description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
 });
 
 // ../commons/src/events/EventMetadata.ts
@@ -1770,8 +1786,7 @@ var ActionCreationMetadata = z16.object({
   ),
   createdByUserType: z16.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
   acceptedAt: z16.iso.datetime().describe("Timestamp when the action request was accepted."),
-  createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation."),
-  createdBySignature: z16.string().nullish().describe("Signature of the user who created the action request.")
+  createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation.")
 });
 var RegistrationCreationMetadata = ActionCreationMetadata.extend({
   registrationNumber: z16.string().describe(
@@ -1799,9 +1814,6 @@ var EventMetadata = z16.object({
   createdAtLocation: UUID.nullish().describe(
     "Location of the user who created the event."
   ),
-  createdBySignature: DocumentPath.nullish().describe(
-    "Signature of the user who created the event."
-  ),
   updatedAtLocation: UUID.nullish().describe(
     "Location of the user who last changed the status."
   ),
@@ -2176,14 +2188,21 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
   }
 }).describe("Unique identifier for the field");
 var FieldReference = import_v43.default.object({
-  $$field: FieldId,
+  $$field: FieldId.describe("Id of the field to reference"),
   $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
     'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
   )
 }).describe("Reference to a field by its ID");
 var ValidationConfig = import_v43.default.object({
-  validator: Conditional,
-  message: TranslationConfig
+  validator: Conditional.describe(
+    "Conditional expression that must hold for the field value to be considered valid."
+  ),
+  message: TranslationConfig.describe(
+    "Error message displayed when the validator does not hold."
+  )
+}).meta({
+  id: "ValidationConfig",
+  description: "Validation rule applied to a form field. The validator is a conditional expression that must hold for the field value to be considered valid."
 });
 var requiredSchema = import_v43.default.union([
   import_v43.default.boolean(),
@@ -2222,6 +2241,9 @@ var BaseField = import_v43.default.object({
 }).describe("Common properties shared across all field types.");
 var Divider = BaseField.extend({
   type: import_v43.default.literal(FieldType.DIVIDER)
+}).meta({
+  description: "A horizontal line divider",
+  id: "Divider"
 });
 var TextField = BaseField.extend({
   type: import_v43.default.literal(FieldType.TEXT),
@@ -2232,7 +2254,10 @@ var TextField = BaseField.extend({
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).default({ type: "text" }).optional()
-}).describe("Text input");
+}).meta({
+  description: "A text input field",
+  id: "TextField"
+});
 var NumberField = BaseField.extend({
   type: import_v43.default.literal(FieldType.NUMBER),
   defaultValue: NumberFieldValue.optional(),
@@ -2242,7 +2267,10 @@ var NumberField = BaseField.extend({
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).optional()
-}).describe("Number input");
+}).meta({
+  description: "A number input field",
+  id: "NumberField"
+});
 var TextAreaField = BaseField.extend({
   type: import_v43.default.literal(FieldType.TEXTAREA),
   defaultValue: NonEmptyTextValue.optional(),
@@ -2253,7 +2281,10 @@ var TextAreaField = BaseField.extend({
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).default({ rows: 4 }).optional()
-}).describe("Multiline text input");
+}).meta({
+  description: "A multiline text input",
+  id: "TextAreaField"
+});
 var ImageMimeType = import_v43.default.enum([
   "image/png",
   "image/jpg",
@@ -2283,13 +2314,19 @@ var SignatureField = BaseField.extend({
   }).default({
     maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
   })
-}).describe("Signature input field");
+}).meta({
+  description: "A signature input field",
+  id: "SignatureField"
+});
 var EmailField = BaseField.extend({
   type: import_v43.default.literal(FieldType.EMAIL),
   configuration: import_v43.default.object({
     maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
   }).default({ maxLength: 255 }).optional(),
   defaultValue: NonEmptyTextValue.optional()
+}).meta({
+  description: "An email input field",
+  id: "EmailField"
 });
 var DateField = BaseField.extend({
   type: import_v43.default.literal(FieldType.DATE),
@@ -2299,7 +2336,10 @@ var DateField = BaseField.extend({
       "Text to display above the date input"
     ).optional()
   }).optional()
-}).describe("A single date input (yyyy-MM-dd)");
+}).meta({
+  description: "A date input (yyyy-MM-dd)",
+  id: "DateField"
+});
 var AgeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.AGE),
   defaultValue: NumberFieldValue.optional(),
@@ -2308,7 +2348,10 @@ var AgeField = BaseField.extend({
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   })
-}).describe("An age input field which uses the current date as the asOfDate");
+}).meta({
+  description: "An age input field which uses the current date as the asOfDate",
+  id: "AgeField"
+});
 var TimeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.TIME),
   defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
@@ -2318,7 +2361,10 @@ var TimeField = BaseField.extend({
       "Text to display above the time input"
     ).optional()
   }).optional()
-}).describe("A single date input (HH-mm)");
+}).meta({
+  description: "A single time input (HH-mm)",
+  id: "TimeField"
+});
 var DateRangeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.DATE_RANGE),
   defaultValue: DateRangeFieldValue.optional(),
@@ -2327,7 +2373,10 @@ var DateRangeField = BaseField.extend({
       "Text to display above the date input"
     ).optional()
   }).optional()
-}).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
+}).meta({
+  description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
+  id: "DateRangeField"
+});
 var HtmlFontVariant = import_v43.default.enum([
   "reg12",
   "reg14",
@@ -2371,18 +2420,30 @@ var ImageViewField = BaseField.extend({
   type: import_v43.default.literal(FieldType.IMAGE_VIEW),
   defaultValue: NonEmptyTextValue.optional(),
   configuration: ImageConfiguration
-}).describe("A read-only image component for form pages");
+}).meta({
+  description: "A read-only image component for form pages",
+  id: "ImageViewField"
+});
 var Paragraph = BaseField.extend({
   type: import_v43.default.literal(FieldType.PARAGRAPH),
   configuration: ParagraphConfiguration
-}).describe("A read-only HTML <p> paragraph");
+}).meta({
+  description: "A read-only HTML <p> paragraph",
+  id: "Paragraph"
+});
 var Heading = BaseField.extend({
   type: import_v43.default.literal(FieldType.HEADING),
   configuration: HeadingConfiguration
-}).describe("A read-only heading component for form pages");
+}).meta({
+  description: "A read-only heading component for form pages",
+  id: "Heading"
+});
 var PageHeader = BaseField.extend({
   type: import_v43.default.literal(FieldType.PAGE_HEADER)
-}).describe("A read-only header component for form pages");
+}).meta({
+  description: "A read-only header component for form pages",
+  id: "PageHeader"
+});
 var File = BaseField.extend({
   type: import_v43.default.literal(FieldType.FILE),
   defaultValue: FileFieldValue.optional(),
@@ -2401,7 +2462,10 @@ var File = BaseField.extend({
   }).default({
     maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
   })
-}).describe("File upload");
+}).meta({
+  description: "A file upload field",
+  id: "File"
+});
 var SelectOption = import_v43.default.object({
   value: import_v43.default.string().describe("The value of the option"),
   label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2418,7 +2482,10 @@ var NumberWithUnitField = BaseField.extend({
       "Placeholder for the number field"
     )
   }).optional()
-}).describe("Number with unit input");
+}).meta({
+  description: "A number with unit input field",
+  id: "NumberWithUnitField"
+});
 var RadioGroup = BaseField.extend({
   type: import_v43.default.literal(FieldType.RADIO_GROUP),
   defaultValue: TextValue.optional(),
@@ -2428,7 +2495,10 @@ var RadioGroup = BaseField.extend({
       size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
     }).optional()
   }).optional()
-}).describe("Grouped radio options");
+}).meta({
+  description: "A grouped radio button field",
+  id: "RadioGroup"
+});
 var BulletList = BaseField.extend({
   type: import_v43.default.literal(FieldType.BULLET_LIST),
   items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2437,7 +2507,10 @@ var BulletList = BaseField.extend({
       fontVariant: HtmlFontVariant.optional()
     }).optional()
   }).default({})
-}).describe("A list of bullet points");
+}).meta({
+  description: "A list of bullet points",
+  id: "BulletList"
+});
 var Select = BaseField.extend({
   type: import_v43.default.literal(FieldType.SELECT),
   defaultValue: TextValue.optional(),
@@ -2452,7 +2525,10 @@ var Select = BaseField.extend({
     { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
   `
   )
-}).describe("Select input");
+}).meta({
+  description: "A select input field",
+  id: "Select"
+});
 var SelectDateRangeOption = import_v43.default.object({
   value: SelectDateRangeValue.describe("The value of the option"),
   label: TranslationConfig.describe("The label of the option")
@@ -2461,7 +2537,10 @@ var SelectDateRangeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
   defaultValue: SelectDateRangeValue.optional(),
   options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
-}).describe("Select input with date range options");
+}).meta({
+  description: "A date range selection field",
+  id: "SelectDateRangeField"
+});
 var NameConfig = import_v43.default.object({
   firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
   middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2492,26 +2571,41 @@ var NameField = BaseField.extend({
       surname: { required: true }
     }
   }).optional()
-}).describe("Name input field");
+}).meta({
+  description: "A field for entering a persons name",
+  id: "NameField"
+});
 var PhoneField = BaseField.extend({
   defaultValue: NonEmptyTextValue.optional(),
   type: import_v43.default.literal(FieldType.PHONE)
-}).describe("Phone input field");
+}).meta({
+  description: "A field for entering a phone number",
+  id: "PhoneField"
+});
 var IdField = BaseField.extend({
   defaultValue: NonEmptyTextValue.optional(),
   type: import_v43.default.literal(FieldType.ID)
-}).describe("ID input field");
+}).meta({
+  description: "A field for entering an ID",
+  id: "IdField"
+});
 var Checkbox = BaseField.extend({
   type: import_v43.default.literal(FieldType.CHECKBOX),
   defaultValue: CheckboxFieldValue.default(false)
-}).describe("Boolean checkbox field");
+}).meta({
+  description: "A boolean checkbox field",
+  id: "Checkbox"
+});
 var Country = BaseField.extend({
   type: import_v43.default.literal(FieldType.COUNTRY),
   defaultValue: NonEmptyTextValue.optional(),
   optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
     "Conditionals for specific countries. Countries not listed are always shown and enabled."
   )
-}).describe("Country select field");
+}).meta({
+  description: "A field for selecting a country",
+  id: "Country"
+});
 var AllowedLocations = JurisdictionReference.optional().describe(
   "Limits which location options are selectable depending on user jurisdiction and location."
 );
@@ -2520,16 +2614,18 @@ var AdministrativeAreas = import_v43.default.enum([
   "HEALTH_FACILITY",
   "CRVS_OFFICE"
 ]);
-var AdministrativeAreaConfiguration = import_v43.default.object({
-  partOf: FieldReference.optional().describe("Parent location"),
-  type: AdministrativeAreas,
-  allowedLocations: AllowedLocations
-}).describe("Administrative area options");
 var AdministrativeAreaField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
   defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
-  configuration: AdministrativeAreaConfiguration
-}).describe("Administrative area input field e.g. facility, office");
+  configuration: import_v43.default.object({
+    partOf: FieldReference.optional().describe("Parent location"),
+    type: AdministrativeAreas,
+    allowedLocations: AllowedLocations
+  }).describe("Administrative area options")
+}).meta({
+  description: "Administrative area input field",
+  id: "AdministrativeAreaField"
+});
 var LocationInput = BaseField.extend({
   type: import_v43.default.literal(FieldType.LOCATION),
   defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
@@ -2537,7 +2633,10 @@ var LocationInput = BaseField.extend({
     locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
     allowedLocations: AllowedLocations
   }).optional()
-}).describe("Input field for a location");
+}).meta({
+  description: "A field for selecting a location",
+  id: "LocationInput"
+});
 var FileUploadWithOptions = BaseField.extend({
   type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
   options: import_v43.default.array(SelectOption).describe("A list of options"),
@@ -2551,6 +2650,9 @@ var FileUploadWithOptions = BaseField.extend({
   }).default({
     maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
   })
+}).meta({
+  description: "A field for uploading files with file type options",
+  id: "FileUploadWithOptions"
 });
 var Facility = BaseField.extend({
   type: import_v43.default.literal(FieldType.FACILITY),
@@ -2596,7 +2698,10 @@ var Address = BaseField.extend({
     allowedLocations: AllowedLocations
   }).optional(),
   defaultValue: DefaultAddressFieldValue.optional()
-}).describe("Address input field \u2013 a combination of location and text fields");
+}).meta({
+  description: "Address input field \u2013 a combination of location and text fields",
+  id: "Address"
+});
 var StaticDataEntry = import_v43.default.object({
   id: import_v43.default.string().describe("ID for the data entry."),
   label: TranslationConfig,
@@ -2611,7 +2716,10 @@ var DataField = BaseField.extend({
     subtitle: TranslationConfig.optional(),
     data: import_v43.default.array(DataEntry)
   })
-}).describe("Data field for displaying read-only data");
+}).meta({
+  description: "A field for displaying a table of read-only data",
+  id: "DataField"
+});
 var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
 var ButtonType = import_v43.default.enum([
   "primary",
@@ -2638,11 +2746,17 @@ var ButtonField = BaseField.extend({
   type: import_v43.default.literal(FieldType.BUTTON),
   defaultValue: ButtonFieldValue.optional(),
   configuration: ButtonConfiguration
-}).describe("Generic button without any built-in functionality");
+}).meta({
+  description: "A generic button that can be used to trigger an action",
+  id: "ButtonField"
+});
 var FieldGroup = BaseField.extend({
   type: import_v43.default.literal(FieldType.FIELD_GROUP),
   // eslint-disable-next-line @typescript-eslint/no-use-before-define
   fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
+}).meta({
+  description: "A group of fields that are displayed together",
+  id: "FieldGroup"
 });
 var AlphaPrintButton = BaseField.extend({
   type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2652,7 +2766,10 @@ var AlphaPrintButton = BaseField.extend({
       "Label for the print button"
     )
   })
-}).describe("Print button field for printing certificates");
+}).meta({
+  description: "An experimental print button field for printing certificates during the declaration process",
+  id: "AlphaPrintButton"
+});
 var HttpField = BaseField.extend({
   type: import_v43.default.literal(FieldType.HTTP),
   defaultValue: HttpFieldValue.optional(),
@@ -2668,20 +2785,30 @@ var HttpField = BaseField.extend({
     params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
     timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
   })
-}).describe("HTTP request function triggered by a button click or other event");
+}).meta({
+  description: "Makes a background HTTP request to an external service and stores the response so other fields can use it. Has no visible UI \u2014 pair with LOADER to show request status.",
+  id: "HttpField"
+});
 var AutocompleteField = BaseField.extend({
   type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
   configuration: import_v43.default.object({
-    url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
+    url: import_v43.default.string().describe(
+      "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
+    ).optional(),
     method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
     defaultOptions: import_v43.default.array(
       import_v43.default.object({
         label: import_v43.default.string(),
         value: import_v43.default.string()
       })
-    ).optional()
+    ).optional().describe(
+      "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
+    )
   })
-}).describe("Autocomplete input field");
+}).meta({
+  description: "Generic autocomplete component designed for use with large dictionary-based datasets. The component supports dynamic retrieval of options from configurable data sources and is intended for datasets that may contain tens or hundreds of thousands of records.",
+  id: "AutocompleteField"
+});
 var SearchField = HttpField.extend({
   type: import_v43.default.literal(FieldType.SEARCH),
   configuration: SearchQuery.pick({
@@ -2714,6 +2841,9 @@ var SearchField = HttpField.extend({
       ok: TranslationConfig.optional()
     }).optional()
   })
+}).meta({
+  description: "A search input field",
+  id: "SearchField"
 });
 var LinkButtonField = BaseField.extend({
   type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2722,7 +2852,10 @@ var LinkButtonField = BaseField.extend({
     text: TranslationConfig.describe("Text to display on the button"),
     icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
   })
-}).describe("Button that opens a link");
+}).meta({
+  description: "A button that opens a URL link",
+  id: "LinkButtonField"
+});
 var VerificationStatus = BaseField.extend({
   type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
   defaultValue: VerificationStatusValue.optional(),
@@ -2732,15 +2865,19 @@ var VerificationStatus = BaseField.extend({
       "Explaining text on the banner in form."
     )
   })
+}).meta({
+  description: "Displays a verification state (e.g. ID verified / pending). Often paired with ID_READER \u2014 it can read its value off an ID_READER rather than holding its own.",
+  id: "VerificationStatus"
 });
 var QueryParamReaderField = BaseField.extend({
   type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
   configuration: import_v43.default.object({
     pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
   })
-}).describe(
-  "A field that maps URL query params into form values and clears them afterward"
-);
+}).meta({
+  description: "A field that maps URL query params into form values and clears them afterward",
+  id: "QueryParamReaderField"
+});
 var QrReaderField = BaseField.extend({
   type: import_v43.default.literal(FieldType.QR_READER),
   defaultValue: QrReaderFieldValue.optional(),
@@ -2751,7 +2888,7 @@ var QrReaderField = BaseField.extend({
     })
   }).optional()
 }).meta({
-  description: "Configuration for QR code reader field, including optional JSON Schema validator.",
+  description: "QR code reader field, including optional JSON Schema validator.",
   id: "QrReaderField"
 });
 var IdReaderField = BaseField.extend({
@@ -2760,12 +2897,18 @@ var IdReaderField = BaseField.extend({
   methods: import_v43.default.array(
     import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
   )
+}).meta({
+  description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
+  id: "IdReaderField"
 });
 var CustomField = BaseField.extend({
   type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
   defaultValue: CustomFieldValue.optional(),
   src: import_v43.default.string().describe("Module source path for the custom field component"),
   configuration: import_v43.default.unknown().optional()
+}).meta({
+  description: "An expiremental custom field that is defined by a module source path",
+  id: "CustomField"
 });
 var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
 var LoaderField = BaseField.extend({
@@ -2775,22 +2918,25 @@ var LoaderField = BaseField.extend({
   configuration: import_v43.default.object({
     text: TranslationConfig.describe("Display text above the loading spinner")
   })
-}).describe(
-  "A non-interactive field that indicates an in progress operation in form"
-);
+}).meta({
+  description: "A non-interactive field that indicates an in progress operation in form",
+  id: "LoaderField"
+});
 var HiddenField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
   required: import_v43.default.boolean().default(false).optional(),
   defaultValue: TextValue.optional()
-}).describe(
-  "A non-interactive, hidden field that only hold a value in the form"
-);
+}).meta({
+  description: "A non-interactive, hidden field that only hold a value in the form",
+  id: "HiddenField"
+});
 var UserRoleField = BaseField.extend({
   type: import_v43.default.literal(FieldType.USER_ROLE),
   defaultValue: TextValue.optional()
-}).describe(
-  "A select dropdown that is automatically populated with available user roles"
-);
+}).meta({
+  description: "A select dropdown that is automatically populated with available user roles",
+  id: "UserRoleField"
+});
 var FieldConfig = import_v43.default.discriminatedUnion("type", [
   FieldGroup,
   Address,
@@ -2889,16 +3035,19 @@ var VerificationPageConfig = FormPageConfig.extend({
   type: z21.literal(PageTypes.enum.VERIFICATION),
   actions: VerificationActionConfig
 });
-var PageConfig = z21.discriminatedUnion("type", [
-  FormPageConfig,
-  VerificationPageConfig
-]);
+var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
+  id: "PageConfig",
+  description: "Configuration for a single page in a form. Either a form page with fields and a continue button, or a verification page with verify/cancel options."
+});
 
 // ../commons/src/events/FormConfig.ts
 var DeclarationFormConfig = z22.object({
   label: TranslationConfig.describe("Human readable description of the form"),
   pages: z22.array(FormPageConfig)
-}).describe("Configuration of the declaration form.");
+}).meta({
+  id: "DeclarationFormConfig",
+  description: "Configuration of the declaration form."
+});
 var ActionFormConfig = z22.object({
   label: TranslationConfig.describe("Human readable description of the form"),
   pages: z22.array(PageConfig)
@@ -2998,6 +3147,9 @@ var DeduplicationConfig = z23.object({
   id: z23.string(),
   label: TranslationConfig,
   query: Clause
+}).meta({
+  id: "DeduplicationConfig",
+  description: "Configuration for duplicate detection on a declare or register action. The query is built from fuzzy / strict / date-range matchers combined with and/or/not."
 });
 
 // ../commons/src/events/ActionConfig.ts
@@ -3115,17 +3267,42 @@ var ActionConfig = z24.discriminatedUnion("type", [
    * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
    * and treat them as "models" instead of duplicating the data structure in each endpoint.
    */
-  ReadActionConfig.meta({ id: "ReadActionConfig" }),
-  DeclareConfig.meta({ id: "DeclareActionConfig" }),
-  RejectConfig.meta({ id: "RejectActionConfig" }),
-  RegisterConfig.meta({ id: "RegisterActionConfig" }),
+  ReadActionConfig.meta({
+    id: "ReadActionConfig",
+    description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
+  }),
+  DeclareConfig.meta({
+    id: "DeclareActionConfig",
+    description: "Configuration for the declare action. Includes review-page fields. Shared with the notify action (ActionType.NOTIFY)."
+  }),
+  RejectConfig.meta({
+    id: "RejectActionConfig",
+    description: "Configuration for rejecting a record before registration."
+  }),
+  RegisterConfig.meta({
+    id: "RegisterActionConfig",
+    description: "Configuration for registering a record."
+  }),
   PrintCertificateActionConfig.meta({
-    id: "PrintCertificateActionConfig"
+    id: "PrintCertificateActionConfig",
+    description: "Configuration for printing a certificate of a registered record."
+  }),
+  RequestCorrectionConfig.meta({
+    id: "RequestCorrectionActionConfig",
+    description: "Configuration for requesting a correction on a registered record."
+  }),
+  EditActionConfig.meta({
+    id: "EditActionConfig",
+    description: "Configuration for editing a record before registration."
   }),
-  RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
-  EditActionConfig.meta({ id: "EditActionConfig" }),
-  ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
-  CustomActionConfig.meta({ id: "CustomActionConfig" })
+  ArchiveConfig.meta({
+    id: "ArchiveActionConfig",
+    description: "Configuration for archiving a record."
+  }),
+  CustomActionConfig.meta({
+    id: "CustomActionConfig",
+    description: "Configuration for a country-defined custom action. An event may include any number of these."
+  })
 ]).describe(
   "Configuration of an action available for an event. Data collected depends on the action type and is accessible through the annotation property in ActionDocument."
 ).meta({ id: "ActionConfig" });
@@ -3201,7 +3378,10 @@ var Field = BaseField2.extend({
 }).describe("Custom field defined for the summary view.");
 var SummaryConfig = z27.object({
   fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
-}).describe("Configuration of the event summary section.");
+}).meta({
+  id: "SummaryConfig",
+  description: "Configuration of the event overview page. Defines which declaration fields appear in the record summary, optionally with custom labels, empty-value messages, and templated values."
+});
 
 // ../commons/src/events/AdvancedSearchConfig.ts
 var z28 = __toESM(require("zod/v4"));
@@ -3325,6 +3505,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
 var AdvancedSearchConfig = z28.object({
   title: TranslationConfig.describe("Advanced search tab title"),
   fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
+}).meta({
+  id: "AdvancedSearchConfig",
+  description: "Configuration of one advanced search tab. Each tab has a title and a list of searchable fields \u2014 either declaration fields (via `field()`) or event metadata (via `event()`)."
 });
 
 // ../commons/src/events/utils.ts
@@ -3801,6 +3984,9 @@ function precompileActionSchemas(eventConfigurations) {
 function isAgeValue(value) {
   return typeof value === "object" && value !== null && "age" in value && typeof value.age === "number";
 }
+function mergeWithBaseFormState(values, context) {
+  return { ...context.baseFormState, ...values };
+}
 function validate(schema, data) {
   const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
   if ("$form" in data) {
@@ -3839,7 +4025,7 @@ function isOnline() {
 }
 function isConditionMet(conditional, values, context, eventIndex) {
   return validate(conditional, {
-    $form: values,
+    $form: mergeWithBaseFormState(values, context),
     $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
     $online: isOnline(),
     $user: context.user,
@@ -3868,7 +4054,7 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
     return true;
   }
   const validConditionals = getConditionalActionsForField(field3, {
-    $form: form,
+    $form: mergeWithBaseFormState(form, context),
     $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
     $online: isOnline(),
     $user: context.user,
@@ -4060,7 +4246,7 @@ function runFieldValidations({
     return [];
   }
   const conditionalParameters = {
-    $form: form,
+    $form: mergeWithBaseFormState(form, context),
     $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
     /**
      * In real use cases, there can be hundreds of thousands of locations.
@@ -4304,17 +4490,16 @@ function isPageVisible(page, formValues, context) {
   }
   return isConditionMet(page.conditional, formValues, context);
 }
-function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false, declarationContext) {
+function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false) {
   const base = (0, import_lodash.cloneDeep)(formValues);
   function fn(prevVisibilityContext) {
-    const visibilityForm = declarationContext ? { ...declarationContext, ...prevVisibilityContext } : prevVisibilityContext;
     const cleaned = (0, import_lodash.omitBy)(base, (value, fieldId) => {
       const fieldConfig = fields.filter((f) => f.id === fieldId);
       if (!fieldConfig.length) {
         return false;
       }
       const isHidden = fieldConfig.every(
-        (f) => !isFieldVisible(f, visibilityForm, validatorContext)
+        (f) => !isFieldVisible(f, prevVisibilityContext, validatorContext)
       );
       if (!isHidden) {
         return false;
@@ -4332,7 +4517,7 @@ function omitHiddenPaginatedFields(formConfig, values, validatorContext, include
   const visibleFields = formConfig.pages.filter((p) => isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
   const hiddenFields = formConfig.pages.filter((p) => !isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
   const valuesExceptHiddenPage = (0, import_lodash.omitBy)(values, (_2, fieldId) => {
-    return hiddenFields.some((f) => f.id === fieldId);
+    return hiddenFields.some((f) => f.id === fieldId) && !visibleFields.some((f) => f.id === fieldId);
   });
   return omitHiddenFields(
     visibleFields,
@@ -4379,13 +4564,10 @@ function getVisibleVerificationPageIds(pages, annotation, context) {
 }
 function omitHiddenAnnotationFields(actionConfig, declaration, annotation, context) {
   const annotationFields = getActionAnnotationFields(actionConfig);
-  return omitHiddenFields(
-    annotationFields,
-    annotation,
-    context,
-    false,
-    declaration
-  );
+  return omitHiddenFields(annotationFields, annotation, {
+    ...context,
+    baseFormState: declaration
+  });
 }
 function deepMerge(currentDocument, actionDocument) {
   const currentDocumentClone = (0, import_lodash.cloneDeep)(currentDocument);
@@ -4573,6 +4755,22 @@ function getCompleteActionAnnotation(annotation, event2, action) {
   }
   return deepMerge(annotation, action.annotation ?? {});
 }
+function getCompleteActionContent(event2, action) {
+  const currentContent = "content" in action ? action.content : void 0;
+  if (!action.originalActionId) {
+    return currentContent;
+  }
+  const originalAction = event2.actions.find(
+    ({ id }) => id === action.originalActionId
+  );
+  if (originalAction && "content" in originalAction && originalAction.content) {
+    return {
+      ...originalAction.content,
+      ...currentContent ?? {}
+    };
+  }
+  return currentContent;
+}
 function getCompleteActionDeclaration(declaration, event2, action) {
   if (action.originalActionId) {
     const originalAction = event2.actions.find(
@@ -4679,6 +4877,9 @@ function not(condition) {
 function never2() {
   return not(alwaysTrue());
 }
+function always() {
+  return defineConditional(alwaysTrue());
+}
 function jsonFieldPath(field3) {
   return [field3.$$field, ...field3.$$subfield].join("/");
 }
@@ -5374,7 +5575,7 @@ var _EventConfigBase = z33.object({
   ),
   label: TranslationConfig.describe("Human-readable label for the event type."),
   actions: z33.array(ActionConfig).describe(
-    "Configuration of system-defined actions associated with the event."
+    "Configuration of core and custom actions associated with the event."
   ),
   actionOrder: z33.array(z33.string()).optional().describe(
     "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5386,7 +5587,7 @@ var _EventConfigBase = z33.object({
     "Configuration of fields available in the advanced search feature."
   ),
   flags: z33.array(FlagConfig).optional().default([]).describe(
-    "Configuration of flags associated with the actions of this event type."
+    "Configuration of custom flags associated with the actions of this event type."
   ),
   analytics: z33.boolean().optional().default(true).describe(
     "Indicates whether the records of this event type are included in analytics"
@@ -5399,8 +5600,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
   validateActionFlags(event2, ctx);
   validateActionOrder(event2, ctx);
 }).meta({
-  id: "EventConfig"
-}).describe("Configuration defining an event type.");
+  id: "EventConfig",
+  description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
+});
 
 // ../commons/src/events/EventConfigInput.ts
 var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5623,6 +5825,9 @@ var WorkqueueColumnValue = z34.object({
 var WorkqueueColumn = z34.object({
   label: TranslationConfig,
   value: WorkqueueColumnValue
+}).meta({
+  id: "WorkqueueColumn",
+  description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
 });
 function defineWorkqueuesColumns(workqueueColumns) {
   return workqueueColumns.map(
@@ -5825,18 +6030,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
   query: true,
   columns: true
 });
-var WorkqueueConfigInput = z37.object({
-  slug: z37.string().describe("Determines the url of the workqueue."),
-  name: TranslationConfig.describe(
-    "Title of the workflow (both in navigation and on the page)"
-  ),
-  query: CountryConfigQueryInputType,
-  action: z37.object({ type: WorkqueueActionType }).optional().describe(
-    "Workqueue call-to-action button configuration. This determines the quick action button shown on each event card and the action taken when the button is clicked."
-  ),
-  columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
-  icon: AvailableIcons,
-  emptyMessage: TranslationConfig.optional()
+var WorkqueueConfigInput = WorkqueueConfig.extend({
+  query: CountryConfigQueryInputType
+}).meta({
+  id: "WorkqueueConfig",
+  description: "Configuration for a single workqueue. Defines the filter applied to the event index, the quick-action button, the columns shown on each row, and the message rendered when the queue is empty."
 });
 function defineWorkqueue(workqueueInput) {
   const queryInput = workqueueInput.query;
@@ -5897,6 +6095,11 @@ var BaseActionInput = z38.object({
   originalActionId: UUID.optional(),
   // should not be part of base action.
   keepAssignment: z38.boolean().optional(),
+  keepAssignmentIfAccepted: z38.boolean().optional(),
+  keepAssignmentIfRejected: z38.boolean().optional(),
+  waitFor: z38.boolean().default(true).describe(
+    "Whether action waits for the indexing before returning. Defaults to true. Setting this to to false completes faster but might lead to stale data in the client if the client tries to read the event immediately after performing the action. Use with care."
+  ),
   // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
   // @TODO: createdAtLocation should be limited to actions that system users can perform. For normal users, it should not be part of the base action.
   createdAtLocation: UUID.nullish().describe(
@@ -6014,7 +6217,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
 var ApproveCorrectionActionInput = BaseActionInput.extend(
   z38.object({
     requestId: z38.string(),
-    type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION)
+    type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION),
+    content: z38.object({ immediateCorrection: z38.boolean().optional() }).optional()
   }).shape
 );
 var ReadActionInput = BaseActionInput.extend(
@@ -6076,7 +6280,7 @@ var Draft = z39.object({
 }).describe(
   "A temporary storage for an action. Stored with details of the event, creator and creation time."
 );
-var DraftInput = BaseActionInput.extend({
+var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
   type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
   status: z39.enum([
     ActionStatus.Requested,
@@ -6150,7 +6354,6 @@ function getDeclarationActionCreationMetadata(actionType, actions) {
     createdAtLocation: requestAction?.createdAtLocation ?? acceptAction.createdAtLocation,
     acceptedAt: acceptAction.createdAt,
     createdByRole: requestAction?.createdByRole ?? acceptAction.createdByRole,
-    createdBySignature: requestAction?.createdBySignature ?? acceptAction.createdBySignature,
     registrationNumber
   };
 }
@@ -6208,26 +6411,43 @@ var import_date_fns3 = require("date-fns");
 function isEditInProgress(actions) {
   return actions.at(-1)?.type === ActionType.EDIT;
 }
+function findPendingCorrectionAction(writeActions2) {
+  let correctionRequestAction;
+  for (let i = writeActions2.length - 1; i >= 0; i--) {
+    const action = writeActions2[i];
+    if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
+      break;
+    }
+    if (action.type === ActionType.REQUEST_CORRECTION) {
+      correctionRequestAction = action;
+      break;
+    }
+  }
+  return correctionRequestAction;
+}
 function isCorrectionRequested(actions) {
+  return findPendingCorrectionAction(actions) !== void 0;
+}
+function isDeclarationIncomplete(actions) {
+  return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
+}
+function isRejected(actions) {
+  const resettingActionTypes = [
+    ActionType.NOTIFY,
+    ActionType.DECLARE,
+    ActionType.EDIT,
+    ActionType.REGISTER
+  ];
   return actions.reduce((prev, { type }) => {
-    if (type === ActionType.REQUEST_CORRECTION) {
+    if (type === ActionType.REJECT) {
       return true;
     }
-    if (type === ActionType.APPROVE_CORRECTION) {
-      return false;
-    }
-    if (type === ActionType.REJECT_CORRECTION) {
+    if (resettingActionTypes.includes(type)) {
       return false;
     }
     return prev;
   }, false);
 }
-function isDeclarationIncomplete(actions) {
-  return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
-}
-function isRejected(actions) {
-  return actions.at(-1)?.type === ActionType.REJECT;
-}
 function isPotentialDuplicate(actions) {
   return actions.reduce((prev, { type }) => {
     if (type === ActionType.DUPLICATE_DETECTED) {
@@ -6290,8 +6510,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
     return (0, import_lodash3.uniq)(flags);
   }, []);
 }
-function getEventFlags(event2, config) {
-  const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+function getActionStatusFlags(sortedActions) {
   const actionStatus = sortedActions.reduce(
     (actionStatuses, { type, status: status2 }) => ({
       ...actionStatuses,
@@ -6299,26 +6518,40 @@ function getEventFlags(event2, config) {
     }),
     {}
   );
-  const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
+  return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
     const flag2 = joinValues([type, status2], ":").toLowerCase();
     return flag2;
   });
-  if (isCorrectionRequested(sortedActions)) {
-    flags.push(InherentFlags.CORRECTION_REQUESTED);
+}
+function getInherentFlags(sortedActions) {
+  const acceptedActions = sortedActions.filter(
+    ({ status: status2 }) => status2 === ActionStatus.Accepted
+  );
+  const inherentFlags = [];
+  if (isCorrectionRequested(acceptedActions)) {
+    inherentFlags.push(InherentFlags.CORRECTION_REQUESTED);
   }
-  if (isDeclarationIncomplete(sortedActions)) {
-    flags.push(InherentFlags.INCOMPLETE);
+  if (isDeclarationIncomplete(acceptedActions)) {
+    inherentFlags.push(InherentFlags.INCOMPLETE);
   }
-  if (isRejected(sortedActions)) {
-    flags.push(InherentFlags.REJECTED);
+  if (isRejected(acceptedActions)) {
+    inherentFlags.push(InherentFlags.REJECTED);
   }
-  if (isPotentialDuplicate(sortedActions)) {
-    flags.push(InherentFlags.POTENTIAL_DUPLICATE);
+  if (isPotentialDuplicate(acceptedActions)) {
+    inherentFlags.push(InherentFlags.POTENTIAL_DUPLICATE);
   }
-  if (isEditInProgress(sortedActions)) {
-    flags.push(InherentFlags.EDIT_IN_PROGRESS);
+  if (isEditInProgress(acceptedActions)) {
+    inherentFlags.push(InherentFlags.EDIT_IN_PROGRESS);
   }
-  return [...flags, ...resolveEventCustomFlags(event2, config)];
+  return inherentFlags;
+}
+function getEventFlags(event2, config) {
+  const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  return [
+    ...getActionStatusFlags(sortedActions),
+    ...getInherentFlags(sortedActions),
+    ...resolveEventCustomFlags(event2, config)
+  ];
 }
 
 // ../commons/src/events/state/index.ts
@@ -6364,17 +6597,6 @@ function getAssignedUserFromActions(actions) {
     return user2;
   }, null);
 }
-function getAssignedUserSignatureFromActions(actions) {
-  return actions.reduce((signature, action) => {
-    if (action.type === ActionType.ASSIGN) {
-      return action.createdBySignature || null;
-    }
-    if (action.type === ActionType.UNASSIGN) {
-      return null;
-    }
-    return signature;
-  }, null);
-}
 function deepDropNulls(obj) {
   if (Array.isArray(obj)) {
     return obj.map(deepDropNulls);
@@ -6470,10 +6692,8 @@ function getCurrentEventState(event2, config) {
     createdBy: creationAction.createdBy,
     createdByUserType: creationAction.createdByUserType,
     createdAtLocation: creationAction.createdAtLocation,
-    createdBySignature: creationAction.createdBySignature,
     updatedAt: acceptedActionMetadata.createdAt,
     assignedTo: getAssignedUserFromActions(acceptedActions),
-    assignedToSignature: getAssignedUserSignatureFromActions(acceptedActions),
     updatedBy: requestActionMetadata.createdBy,
     updatedAtLocation: requestActionMetadata.createdAtLocation,
     declaration,
@@ -9732,7 +9952,6 @@ var eventQueryDataGenerator = (overrides = {}, seed = 1) => {
     createdBy: overrides.createdBy ?? generateUuid(rng),
     createdAtLocation: overrides.createdAtLocation ?? generateUuid(rng),
     updatedAtLocation: overrides.updatedAtLocation ?? generateUuid(rng),
-    createdBySignature: overrides.createdBySignature ?? generateRandomSignature(rng),
     updatedAt: overrides.updatedAt ?? (0, import_date_fns4.addDays)(new Date(createdAt), 1).toISOString(),
     assignedTo: overrides.assignedTo ?? null,
     updatedBy: overrides.updatedBy ?? generateUuid(rng),
@@ -10003,6 +10222,39 @@ function userCanAccessEventWithScopes(event2, scopes, user2, customActionType) {
     (scope) => canAccessEventWithScope(event2, scope, user2, customActionType)
   );
 }
+function getAdministrativeAreaHierarchy(administrativeAreaId, administrativeAreas) {
+  const collectedLocations = [];
+  const parsedAdministrativeAreaId = administrativeAreaId && UUID.safeParse(administrativeAreaId).data;
+  let current = parsedAdministrativeAreaId ? administrativeAreas.get(parsedAdministrativeAreaId) : null;
+  while (current) {
+    collectedLocations.push(current);
+    if (!current.parentId) {
+      break;
+    }
+    const parentId = current.parentId;
+    current = administrativeAreas.get(parentId);
+  }
+  return collectedLocations;
+}
+function getLocationHierarchy(selectedId, context) {
+  const { administrativeAreas, locations } = context;
+  const loc = locations.get(selectedId);
+  if (loc) {
+    if (loc.administrativeAreaId) {
+      const hierarchy2 = getAdministrativeAreaHierarchy(
+        loc.administrativeAreaId,
+        administrativeAreas
+      );
+      return [...hierarchy2.reverse().map((area) => area.id), loc.id];
+    }
+    return [loc.id];
+  }
+  const hierarchy = getAdministrativeAreaHierarchy(
+    selectedId,
+    administrativeAreas
+  );
+  return hierarchy.reverse().map((area) => area.id);
+}
 
 // ../commons/src/events/scopes.ts
 var ACTION_SCOPE_MAP = {
@@ -10077,6 +10329,25 @@ function isActionInScope({
   );
   return canAccess;
 }
+function getAvailableRolesForUserUpdatePayload({
+  allRoles,
+  userLocation,
+  acceptedScopes,
+  userRequesting
+}) {
+  const availableRoles = allRoles.filter((role) => {
+    const canAccess = canAccessOtherUserWithScopes({
+      userToAccess: {
+        ...userLocation,
+        role
+      },
+      user: userRequesting,
+      scopes: acceptedScopes
+    });
+    return canAccess;
+  });
+  return availableRoles;
+}
 
 // ../commons/src/events/serializers/user/deserializer.ts
 function userDeserializer(serializedUserField, user2) {
@@ -10279,3 +10550,366 @@ function getFilePathsFromEvent(event2) {
   });
   return (0, import_lodash7.uniq)(filepaths);
 }
+
+// ../commons/src/events/mocks.test.utils.ts
+var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
+  {
+    id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    name: "Central",
+    parentId: null,
+    validUntil: null,
+    externalId: "ydyJb1RAy4U1"
+  },
+  {
+    id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
+    name: "Sulaka",
+    parentId: null,
+    validUntil: null,
+    externalId: "pQ8nGxWmZ2Q3"
+  },
+  {
+    id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
+    name: "Pualula",
+    parentId: null,
+    validUntil: null,
+    externalId: "Aq91DweLmT8k"
+  },
+  {
+    id: "6d1a59df-988c-4021-a846-ccbc021931a7",
+    name: "Chuminga",
+    parentId: null,
+    validUntil: null,
+    externalId: "Rw0fYNh2Xk9a"
+  },
+  {
+    id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    name: "Ibombo",
+    parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null,
+    externalId: "k7DsP4vbN1Qe"
+  },
+  {
+    id: "27160bbd-32d1-4625-812f-860226bfb92a",
+    name: "Isango",
+    parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null,
+    externalId: "Gm3Z9eQpHw4L"
+  },
+  {
+    id: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    name: "Isamba",
+    parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null,
+    externalId: "sT0xVu1KqJ7r"
+  },
+  {
+    id: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    name: "Itambo",
+    parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null,
+    externalId: "Nq6Bv2HpL9Te"
+  },
+  {
+    id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
+    name: "Ezhi",
+    parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null,
+    externalId: "xK8cQ0ZRy5Wd"
+  },
+  {
+    id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
+    name: "Ilanga",
+    parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
+    validUntil: null,
+    externalId: "Cq4Jm1XvN8Ls"
+  },
+  // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
+  {
+    id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
+    name: "Klow",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "IkYcYBUcyY2"
+  },
+  {
+    id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
+    name: "Mbondo",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Qhvv5hvo3mY"
+  },
+  {
+    id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
+    name: "Ndara",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "crXh068O9TR"
+  },
+  {
+    id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
+    name: "Olani",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "r00It8Tvvp7"
+  },
+  {
+    id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
+    name: "Pemba",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "ZnUWsbONIaH"
+  },
+  {
+    id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
+    name: "Quanza",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "fDZycvQTa7l"
+  },
+  {
+    id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
+    name: "Rivka",
+    parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "KqswxCGTELa"
+  },
+  // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
+  {
+    id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
+    name: "Mbula",
+    parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    validUntil: null,
+    externalId: "osEbKjRc9Kg"
+  },
+  {
+    id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
+    name: "Ndoki",
+    parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    validUntil: null,
+    externalId: "aq4daBUAGr3"
+  },
+  {
+    id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
+    name: "Tsanga",
+    parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    validUntil: null,
+    externalId: "cqis6Y8trbJ"
+  },
+  {
+    id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
+    name: "Waziri",
+    parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    validUntil: null,
+    externalId: "LMijHPyyx6d"
+  },
+  {
+    id: "2c5d6e7f-8a9b-4423-8def-456789012345",
+    name: "Zimbi",
+    parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    validUntil: null,
+    externalId: "pcQYbPuKGZ7"
+  },
+  // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
+  {
+    id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
+    name: "Felani",
+    parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    validUntil: null,
+    externalId: "gSqpoCGdMXp"
+  },
+  {
+    id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
+    name: "Goroma",
+    parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    validUntil: null,
+    externalId: "KvAAIaNqVrp"
+  },
+  {
+    id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
+    name: "Halifu",
+    parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    validUntil: null,
+    externalId: "qe4UnEVt1hv"
+  },
+  {
+    id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
+    name: "Jabari",
+    parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    validUntil: null,
+    externalId: "yHH9Nz4rLOt"
+  },
+  {
+    id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
+    name: "Kifani",
+    parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    validUntil: null,
+    externalId: "eSWmXIGeu1I"
+  },
+  {
+    id: "8c1d2e3f-4a5b-4089-8def-012345678901",
+    name: "Lumela",
+    parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
+    validUntil: null,
+    externalId: "bh0b3aI1uP3"
+  }
+];
+var V2_DEFAULT_MOCK_LOCATIONS = [
+  {
+    id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
+    name: "Central Provincial Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null,
+    externalId: "Xr3Df8WpK6Ys"
+  },
+  {
+    id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
+    name: "Central Health Post",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
+    validUntil: null
+  },
+  {
+    id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
+    name: "Ibombo District Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Sm4Nw7GrD2Vy"
+  },
+  {
+    id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
+    name: "Isamba District Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
+    validUntil: null,
+    externalId: "Vg1Bq5XeH9Lt"
+  },
+  {
+    id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
+    name: "Isango District Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
+    validUntil: null,
+    externalId: "Je7Lm2XqN9Vz"
+  },
+  {
+    id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
+    name: "Sulaka Provincial Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
+    validUntil: null,
+    externalId: "Ht2Wp9KcX5Qv"
+  },
+  {
+    id: "030358c6-54af-44be-821b-8e4af963a49c",
+    name: "Ilanga District Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
+    validUntil: null,
+    externalId: "Yp6Ds1WqN3Xz"
+  },
+  {
+    id: "423d000f-101b-47c0-8b86-21a908067cee",
+    name: "Chamakubi Health Post",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "M1nFr8LbC2Qy"
+  },
+  {
+    id: "4d3279be-d026-420c-88f7-f0a4ae986973",
+    name: "Ibombo Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "bT7pV6YrW0Xc"
+  },
+  {
+    id: "190902f4-1d77-476a-8947-41145af1db7d",
+    name: "Chikobo Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "zE4qPn2SgJ5d"
+  },
+  {
+    id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
+    name: "Chilochabalenje Health Post",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "H8vDs1MqR4Uf"
+  },
+  {
+    id: "dbfc178f-7295-4b90-b28d-111c95b03127",
+    name: "Chipeso Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Qw3uZ9KfX6Lm"
+  },
+  {
+    id: "09862bfe-c7ac-46cd-987b-668681533c80",
+    name: "Chisamba Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Yr0pCg8LdM2s"
+  },
+  {
+    id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
+    name: "Chitanda Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "tS9gJ4PwB1Qx"
+  },
+  {
+    id: "0431c433-6062-4a4c-aee9-25271aec61ee",
+    name: "Golden Valley Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Ld7Qm3XsA8Vr"
+  },
+  {
+    id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
+    name: "Ipongo Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "kF2sW9DmH0Bt"
+  },
+  {
+    id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
+    name: "Itumbwe Health Post",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Ue5Xb3VaC7Pq"
+  },
+  {
+    id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
+    name: "Kabangalala Rural Health Centre",
+    locationType: "HEALTH_FACILITY",
+    administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
+    validUntil: null,
+    externalId: "Pz8Kc1TqH6Jn"
+  },
+  // Village offices
+  {
+    id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
+    name: "Klow Village Office",
+    locationType: "CRVS_OFFICE",
+    administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
+    validUntil: null,
+    externalId: "PmAyxAJkxiJ"
+  }
+];
+var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
+  V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
+);
+var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
+  V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
+);