@opencrvs/toolkit 2.0.0-rc.ff04b30 → 2.0.0-rc.ff777d6

package/dist/events/index.js

@@ -75,6 +75,7 @@ __export(events_exports, {
   CheckboxFieldValue: () => CheckboxFieldValue,
   Clause: () => Clause,
   ClientSpecificAction: () => ClientSpecificAction,
+  ComputedDefaultValue: () => ComputedDefaultValue,
   Conditional: () => Conditional,
   ConditionalType: () => ConditionalType,
   ConfirmableActions: () => ConfirmableActions,
@@ -200,6 +201,7 @@ __export(events_exports, {
   SelectDateRangeValue: () => SelectDateRangeValue,
   SelectOption: () => SelectOption,
   ShowConditional: () => ShowConditional,
+  SignatureFieldValue: () => SignatureFieldValue,
   StaticDataEntry: () => StaticDataEntry,
   StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
   SummaryConfig: () => SummaryConfig,
@@ -213,6 +215,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 +240,7 @@ __export(events_exports, {
   ageToDate: () => ageToDate,
   aggregateActionAnnotations: () => aggregateActionAnnotations,
   aggregateActionDeclarations: () => aggregateActionDeclarations,
+  always: () => always,
   alwaysTrue: () => alwaysTrue,
   and: () => and,
   annotationActions: () => annotationActions,
@@ -241,10 +248,12 @@ __export(events_exports, {
   applyDraftToEventIndex: () => applyDraftToEventIndex,
   areCertificateConditionsMet: () => areCertificateConditionsMet,
   areConditionsMet: () => areConditionsMet,
+  buildClientFunctionContext: () => buildClientFunctionContext,
   buildFormState: () => buildFormState,
   canAccessEventWithScope: () => canAccessEventWithScope,
   canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
   canAccessUserWithScope: () => canAccessUserWithScope,
+  compileClientFunction: () => compileClientFunction,
   compositeFieldTypes: () => compositeFieldTypes,
   createEmptyDraft: () => createEmptyDraft,
   createFieldConditionals: () => createFieldConditionals,
@@ -265,6 +274,7 @@ __export(events_exports, {
   defineWorkqueuesColumns: () => defineWorkqueuesColumns,
   deserializeQuery: () => deserializeQuery,
   errorMessages: () => errorMessages,
+  evaluate: () => evaluate,
   event: () => event,
   eventMetadataLabelMap: () => eventMetadataLabelMap,
   eventPayloadGenerator: () => eventPayloadGenerator,
@@ -277,6 +287,7 @@ __export(events_exports, {
   findActiveDraftForEvent: () => findActiveDraftForEvent,
   findAllFields: () => findAllFields,
   findLastAssignmentAction: () => findLastAssignmentAction,
+  findPendingCorrectionAction: () => findPendingCorrectionAction,
   findRecordActionPages: () => findRecordActionPages,
   flag: () => flag,
   flattenFieldReference: () => flattenFieldReference,
@@ -310,6 +321,7 @@ __export(events_exports, {
   getAvailableActionsForEvent: () => getAvailableActionsForEvent,
   getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
   getCompleteActionAnnotation: () => getCompleteActionAnnotation,
+  getCompleteActionContent: () => getCompleteActionContent,
   getCompleteActionDeclaration: () => getCompleteActionDeclaration,
   getCurrentEventState: () => getCurrentEventState,
   getCustomActionFields: () => getCustomActionFields,
@@ -318,6 +330,7 @@ __export(events_exports, {
   getDeclarationFields: () => getDeclarationFields,
   getDeclarationPages: () => getDeclarationPages,
   getEventConfigById: () => getEventConfigById,
+  getEventFlags: () => getEventFlags,
   getFilePathsFromEvent: () => getFilePathsFromEvent,
   getLocationHierarchy: () => getLocationHierarchy,
   getMixedPath: () => getMixedPath,
@@ -340,6 +353,7 @@ __export(events_exports, {
   isBulletListFieldType: () => isBulletListFieldType,
   isButtonFieldType: () => isButtonFieldType,
   isCheckboxFieldType: () => isCheckboxFieldType,
+  isCodeToEvaluate: () => isCodeToEvaluate,
   isConditionMet: () => isConditionMet,
   isCountryFieldType: () => isCountryFieldType,
   isCustomFieldType: () => isCustomFieldType,
@@ -380,6 +394,7 @@ __export(events_exports, {
   isPageVisible: () => isPageVisible,
   isParagraphFieldType: () => isParagraphFieldType,
   isPhoneFieldType: () => isPhoneFieldType,
+  isPotentialDuplicate: () => isPotentialDuplicate,
   isPrintButtonFieldType: () => isPrintButtonFieldType,
   isQrReaderFieldType: () => isQrReaderFieldType,
   isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -413,12 +428,15 @@ __export(events_exports, {
   plainDateToLocalDate: () => plainDateToLocalDate,
   precompileActionSchemas: () => precompileActionSchemas,
   resolveDateOfEvent: () => resolveDateOfEvent,
+  resolveEventCustomFlags: () => resolveEventCustomFlags,
   resolvePlaceOfEvent: () => resolvePlaceOfEvent,
+  runClientFunction: () => runClientFunction,
   runFieldValidations: () => runFieldValidations,
   runStructuralValidations: () => runStructuralValidations,
   safeUnion: () => safeUnion,
   status: () => status,
   timePeriodToDateRange: () => timePeriodToDateRange,
+  todayISO: () => todayISO,
   user: () => user,
   userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
   validate: () => validate,
@@ -693,14 +711,20 @@ var unflattenScope = (input) => {
   return { type, options };
 };
 var EncodedScope = z2.string().brand("EncodedScope");
-var decodeScope = (query) => {
-  const scope = qs.parse(query, {
+var decodedScopeCache = /* @__PURE__ */ new Map();
+var decodeScope = (encodedScope) => {
+  if (decodedScopeCache.has(encodedScope)) {
+    return decodedScopeCache.get(encodedScope);
+  }
+  const scope = qs.parse(encodedScope, {
     ignoreQueryPrefix: true,
     comma: true,
     allowDots: true
   });
   const unflattenedScope = unflattenScope(scope);
-  return Scope.safeParse(unflattenedScope)?.data;
+  const result = Scope.safeParse(unflattenedScope)?.data;
+  decodedScopeCache.set(encodedScope, result);
+  return result;
 };
 var DEFAULT_SCOPE_OPTIONS = {
   placeOfEvent: JurisdictionFilter.enum.all,
@@ -1080,8 +1104,8 @@ var ActionConditional = z7.discriminatedUnion("type", [
   // Action can be shown to the user in the list but as disabled
   EnableConditional
 ]).meta({
-  description: "Action conditional configuration",
-  id: "ActionConditional"
+  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),
@@ -1097,8 +1121,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
@@ -1321,7 +1345,7 @@ function plainDateToLocalDate(date) {
 // ../commons/src/events/FieldValue.ts
 var TextValue = z12.string();
 var HiddenFieldValue = z12.string();
-var NonEmptyTextValue = TextValue.min(1);
+var NonEmptyTextValue = z12.string().trim().min(1);
 var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
 var AgeValue = z12.object({
   age: z12.number(),
@@ -1350,6 +1374,7 @@ var DateRangeFieldValue = z12.object({
 var EmailValue = z12.email();
 var CheckboxFieldValue = z12.boolean();
 var NumberFieldValue = z12.number();
+var SignatureFieldValue = FileFieldValue;
 var ButtonFieldValue = z12.number();
 var VerificationStatusValue = z12.enum([
   "verified",
@@ -1648,8 +1673,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,8 +1768,8 @@ var FlagConfig = z15.object({
   ),
   label: TranslationConfig.describe("Human readable label of the flag.")
 }).meta({
-  description: "Flag configuration",
-  id: "FlagConfig"
+  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,
@@ -1752,8 +1778,8 @@ var ActionFlagConfig = z15.object({
     "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
   )
 }).meta({
-  description: "Action flag configuration",
-  id: "ActionFlagConfig"
+  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
@@ -2180,11 +2206,31 @@ var FieldReference = import_v43.default.object({
   $$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 } }`'
+  ),
+  $$code: import_v43.default.string().optional().describe(
+    "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
   )
-}).describe("Reference to a field by its ID");
+}).describe(
+  "Reference to a field value, with an optional client-side computation applied."
+);
+function isCodeToEvaluate(v) {
+  return !!v && typeof v === "object" && "$$code" in v;
+}
+var ComputedDefaultValue = import_v43.default.object({
+  $$code: import_v43.default.string().describe(
+    "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
+  )
+}).describe("A context-only computation used as a field default value.");
 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(),
@@ -2215,7 +2261,7 @@ var BaseField = import_v43.default.object({
     "Indicates whether the field can be modified during record correction."
   ),
   value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
-    "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used."
+    "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used. A FieldReference with $$code computes the value via a custom client-side function."
   ),
   analytics: import_v43.default.boolean().default(false).optional().describe(
     "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2223,30 +2269,39 @@ 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),
-  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
   configuration: import_v43.default.object({
     maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
     type: import_v43.default.enum(["text", "password"]).optional(),
     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(),
+  defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     min: import_v43.default.number().optional().describe("Minimum value"),
     max: import_v43.default.number().optional().describe("Maximum value"),
     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(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
     rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2254,7 +2309,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",
@@ -2277,58 +2335,76 @@ var SignatureField = BaseField.extend({
   signaturePromptLabel: TranslationConfig.describe(
     "Title of the signature modal"
   ),
-  defaultValue: FieldValue.optional(),
+  defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
     acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
   }).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()
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
+}).meta({
+  description: "An email input field",
+  id: "EmailField"
 });
 var DateField = BaseField.extend({
   type: import_v43.default.literal(FieldType.DATE),
-  defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
+  defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
   configuration: import_v43.default.object({
     notice: TranslationConfig.describe(
       "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(),
+  defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     asOfDate: FieldReference,
     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)"),
+  defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
   configuration: import_v43.default.object({
     use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
     notice: TranslationConfig.describe(
       "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(),
+  defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     notice: TranslationConfig.describe(
       "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",
@@ -2372,21 +2448,33 @@ 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(),
+  defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
     acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2402,7 +2490,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"),
@@ -2410,7 +2501,7 @@ var SelectOption = import_v43.default.object({
 });
 var NumberWithUnitField = BaseField.extend({
   type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
-  defaultValue: NumberWithUnitFieldValue.optional(),
+  defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
   configuration: import_v43.default.object({
     min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2419,17 +2510,23 @@ 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(),
+  defaultValue: TextValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectOption).describe("A list of options"),
   configuration: import_v43.default.object({
     styles: import_v43.default.object({
       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"),
@@ -2438,10 +2535,13 @@ 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(),
+  defaultValue: TextValue.or(ComputedDefaultValue).optional(),
   options: import_v43.default.array(SelectOption).describe("A list of options"),
   noOptionsMessage: TranslationConfig.optional().describe(
     `
@@ -2453,16 +2553,22 @@ 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")
 });
 var SelectDateRangeField = BaseField.extend({
   type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
-  defaultValue: SelectDateRangeValue.optional(),
+  defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).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(),
@@ -2474,7 +2580,7 @@ var NameField = BaseField.extend({
     firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
     middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
     surname: SerializedUserField.or(NonEmptyTextValue).optional()
-  }).optional(),
+  }).or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     name: NameConfig.default({
       firstname: { required: true },
@@ -2493,26 +2599,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(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).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(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).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");
+  defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
+}).meta({
+  description: "A boolean checkbox field",
+  id: "Checkbox"
+});
 var Country = BaseField.extend({
   type: import_v43.default.literal(FieldType.COUNTRY),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).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."
 );
@@ -2521,28 +2642,33 @@ 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");
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
+  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(),
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
   configuration: import_v43.default.object({
     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"),
-  defaultValue: FileFieldWithOptionValue.optional(),
+  defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
     maxImageSize: import_v43.default.object({
@@ -2552,15 +2678,18 @@ 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),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
 }).describe("Input field for a facility");
 var Office = BaseField.extend({
   type: import_v43.default.literal(FieldType.OFFICE),
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
 }).describe("Input field for an office");
 var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2596,8 +2725,11 @@ var Address = BaseField.extend({
     ).optional(),
     allowedLocations: AllowedLocations
   }).optional(),
-  defaultValue: DefaultAddressFieldValue.optional()
-}).describe("Address input field \u2013 a combination of location and text fields");
+  defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
+}).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,
@@ -2612,7 +2744,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",
@@ -2637,13 +2772,19 @@ var ButtonConfiguration = import_v43.default.object({
 });
 var ButtonField = BaseField.extend({
   type: import_v43.default.literal(FieldType.BUTTON),
-  defaultValue: ButtonFieldValue.optional(),
+  defaultValue: ButtonFieldValue.or(ComputedDefaultValue).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),
@@ -2653,10 +2794,13 @@ 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(),
+  defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     trigger: FieldReference.optional().describe(
       "Reference to the field that triggers the HTTP request when its value changes. If not provided, the HTTP request is triggered once on component mount."
@@ -2669,20 +2813,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({
@@ -2715,6 +2869,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),
@@ -2723,28 +2880,35 @@ 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(),
+  defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     status: TranslationConfig.describe("Text to display on the status pill."),
     description: TranslationConfig.describe(
       "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(),
+  defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
   configuration: import_v43.default.object({
     validator: import_v43.default.any().meta({
       description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2752,21 +2916,27 @@ 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({
   type: import_v43.default.literal(FieldType.ID_READER),
-  defaultValue: IdReaderFieldValue.optional(),
+  defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
   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({
@@ -2776,22 +2946,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,
@@ -2891,15 +3064,18 @@ var VerificationPageConfig = FormPageConfig.extend({
   actions: VerificationActionConfig
 });
 var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
-  description: "Page configuration",
-  id: "PageConfig"
+  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)
@@ -2999,6 +3175,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
@@ -3116,17 +3295,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."
+  }),
+  ArchiveConfig.meta({
+    id: "ArchiveActionConfig",
+    description: "Configuration for archiving a record."
   }),
-  RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
-  EditActionConfig.meta({ id: "EditActionConfig" }),
-  ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
-  CustomActionConfig.meta({ id: "CustomActionConfig" })
+  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" });
@@ -3202,7 +3406,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"));
@@ -3273,6 +3480,9 @@ var BaseField3 = z28.object({
   ),
   validations: z28.array(ValidationConfig).optional().describe(
     `Option for overriding the field validations specifically for advanced search form.`
+  ),
+  allowedLocations: JurisdictionReference.optional().describe(
+    `Override the allowedLocations for a location field in advanced search. Use this when the declaration form's allowedLocations references a scope (e.g. record.create) that search-only users don't have \u2014 specify record.search scope instead.`
   )
 });
 var SearchQueryParams = z28.object({
@@ -3326,6 +3536,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
@@ -3344,9 +3557,11 @@ var z30 = __toESM(require("zod/v4"));
 var z29 = __toESM(require("zod/v4"));
 function getDynamicNameValue(field3) {
   const nameConfiguration = field3.configuration?.name;
+  const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
+  const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
   return z29.object({
-    firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
-    surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
+    firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
+    surname: surnameRequired ? NonEmptyTextValue : TextValue,
     middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
   });
 }
@@ -3729,7 +3944,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
   }
   return current;
 }
+function todayISO() {
+  return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
+}
+var compiledFunctionCache = /* @__PURE__ */ new Map();
+function compileClientFunction(code) {
+  let fn = compiledFunctionCache.get(code);
+  if (!fn) {
+    fn = new Function(`return (${code})`)();
+    compiledFunctionCache.set(code, fn);
+  }
+  return fn;
+}
 (0, import_ajv_formats.default)(ajv);
+function buildClientFunctionContext(input) {
+  return {
+    $form: input.form,
+    $now: todayISO(),
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    $online: isOnline(),
+    $user: input.validatorContext?.user,
+    $event: input.validatorContext?.event,
+    $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
+    user: input.systemVariables?.user,
+    $window: input.systemVariables?.$window,
+    locations: input.locations,
+    adminLevelIds: input.adminLevelIds
+  };
+}
+function runClientFunction(code, data, context) {
+  return compileClientFunction(code)(data, context);
+}
 ajv.addKeyword({
   keyword: "daysFromDate",
   type: "string",
@@ -3774,7 +4019,7 @@ ajv.addKeyword({
   $data: true,
   errors: true,
   // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
-  validate(schema, data, _2, dataContext) {
+  validate(_schema, data, _2, dataContext) {
     const locationIdInput = data;
     const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
     return locations.some((location) => location.id === locationIdInput);
@@ -3805,6 +4050,23 @@ function isAgeValue(value) {
 function mergeWithBaseFormState(values, context) {
   return { ...context.baseFormState, ...values };
 }
+ajv.addKeyword({
+  keyword: "customClientValidator",
+  schemaType: "object",
+  errors: true,
+  // @ts-expect-error -- AJV's public types don't expose `rootData`. All
+  // `validate()` callers build root data via `buildClientFunctionContext`,
+  // so the cast holds.
+  validate(schema, data, _2, dataContext) {
+    return Boolean(
+      runClientFunction(
+        schema.code,
+        data,
+        dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
+      )
+    );
+  }
+});
 function validate(schema, data) {
   const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
   if ("$form" in data) {
@@ -3841,17 +4103,14 @@ function isOnline() {
   }
   return true;
 }
-function isConditionMet(conditional, values, context, eventIndex) {
-  return validate(conditional, {
-    $form: mergeWithBaseFormState(values, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    $online: isOnline(),
-    $user: context.user,
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $flags: eventIndex?.flags ?? [],
-    $status: eventIndex?.status,
-    $event: context.event
-  });
+function isConditionMet(conditional, values, context) {
+  return validate(
+    conditional,
+    buildClientFunctionContext({
+      form: mergeWithBaseFormState(values, context),
+      validatorContext: context
+    })
+  );
 }
 function getConditionalActionsForField(field3, values) {
   if (!field3.conditionals) {
@@ -3859,9 +4118,9 @@ function getConditionalActionsForField(field3, values) {
   }
   return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
 }
-function areConditionsMet(conditions, values, context, event2) {
+function areConditionsMet(conditions, values, context, _event) {
   return conditions.every(
-    (condition) => isConditionMet(condition.conditional, values, context, event2)
+    (condition) => isConditionMet(condition.conditional, values, context)
   );
 }
 function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3871,14 +4130,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
   if (!hasRule) {
     return true;
   }
-  const validConditionals = getConditionalActionsForField(field3, {
-    $form: mergeWithBaseFormState(form, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    $online: isOnline(),
-    $user: context.user,
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $event: context.event
-  });
+  const validConditionals = getConditionalActionsForField(
+    field3,
+    buildClientFunctionContext({
+      form: mergeWithBaseFormState(form, context),
+      validatorContext: context
+    })
+  );
   return validConditionals.includes(conditionalType);
 }
 function isFieldVisible(field3, form, context) {
@@ -3904,7 +4162,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
   if (!rule) {
     return true;
   }
-  return isConditionMet(rule.conditional, event2.declaration, context, event2);
+  return validate(rule.conditional, {
+    ...buildClientFunctionContext({
+      form: mergeWithBaseFormState(event2.declaration, context),
+      validatorContext: context
+    }),
+    $flags: event2.flags,
+    $status: event2.status
+  });
 }
 function isActionEnabled(actionConfig, event2, context) {
   return isActionConditionMet(
@@ -4063,19 +4328,10 @@ function runFieldValidations({
   if (!isFieldVisible(field3.config, form, context)) {
     return [];
   }
-  const conditionalParameters = {
-    $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.
-     * Make sure that the context contains only the locations that are needed for validation.
-     * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
-     * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
-     */
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $online: isOnline(),
-    $user: context.user
-  };
+  const conditionalParameters = buildClientFunctionContext({
+    form: mergeWithBaseFormState(form, context),
+    validatorContext: context
+  });
   if (isFieldGroupFieldType(field3)) {
     const subfieldErrors = buildFormState(
       field3.config.fields,
@@ -4559,19 +4815,32 @@ function getPendingAction(actions) {
   }
   return pendingActions[0];
 }
-function getCompleteActionAnnotation(annotation, event2, action) {
+function getCompleteActionAnnotation(event2, action) {
   if (action.originalActionId) {
     const originalAction = event2.actions.find(
       ({ id }) => id === action.originalActionId
     );
     if (originalAction?.status === ActionStatus.Requested) {
-      return deepMerge(
-        deepMerge(annotation, originalAction.annotation ?? {}),
-        action.annotation ?? {}
-      );
+      return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
     }
   }
-  return deepMerge(annotation, action.annotation ?? {});
+  return 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) {
@@ -4591,7 +4860,7 @@ function getAcceptedActions(event2) {
   return event2.actions.filter(isAcceptedAction).map((action) => ({
     ...action,
     declaration: getCompleteActionDeclaration({}, event2, action),
-    annotation: getCompleteActionAnnotation({}, event2, action)
+    annotation: getCompleteActionAnnotation(event2, action)
   }));
 }
 var EXCLUDED_ACTIONS = [
@@ -4679,6 +4948,9 @@ function not(condition) {
 function never2() {
   return not(alwaysTrue());
 }
+function always() {
+  return defineConditional(alwaysTrue());
+}
 function jsonFieldPath(field3) {
   return [field3.$$field, ...field3.$$subfield].join("/");
 }
@@ -5226,7 +5498,54 @@ function createFieldConditionals(fieldId) {
         }
       },
       required: [fieldId]
-    })
+    }),
+    /**
+     * Custom client-side validator. The provided function is serialised and executed
+     * just-in-time on the client only. External references (e.g. lodash) are not
+     * available inside the function body — all logic must be self-contained.
+     *
+     * @example
+     * field('nid').customClientValidator((value) => {
+     *   // LUHN check — all logic must be inline
+     *   const digits = String(value).split('').map(Number)
+     *   // ...
+     *   return isValid
+     * })
+     */
+    customClientValidator(validationFn) {
+      const code = validationFn.toString();
+      return defineFormConditional({
+        type: "object",
+        properties: wrapToPath(
+          { [fieldId]: { customClientValidator: { code } } },
+          this.$$subfield
+        ),
+        required: [fieldId]
+      });
+    },
+    /**
+     * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
+     * that can be used as the `value` property or a DATA component entry.
+     * The function receives the referenced field's value as the first argument and
+     * the full form context as the second; its return value replaces the field reference.
+     * The function is serialised and executed just-in-time on the client only.
+     * External references (e.g. lodash) are not available inside the function body.
+     *
+     * For computing a default value without referencing a specific field, use
+     * `evaluate(fn)` in the `defaultValue` property instead.
+     *
+     * @example
+     * field('a').customClientEvaluation((aValue, ctx) =>
+     *   Number(aValue) + Number(ctx.$form.b)
+     * )
+     */
+    customClientEvaluation(computationFn) {
+      return {
+        $$code: computationFn.toString(),
+        $$field: fieldId,
+        $$subfield: this.$$subfield
+      };
+    }
   };
 }
 
@@ -5399,8 +5718,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 +5943,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(
@@ -5828,8 +6151,8 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
 var WorkqueueConfigInput = WorkqueueConfig.extend({
   query: CountryConfigQueryInputType
 }).meta({
-  description: "Workqueue configuration",
-  id: "WorkqueueConfig"
+  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;
@@ -5892,7 +6215,9 @@ var BaseActionInput = z38.object({
   keepAssignment: z38.boolean().optional(),
   keepAssignmentIfAccepted: z38.boolean().optional(),
   keepAssignmentIfRejected: z38.boolean().optional(),
-  waitFor: 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(
@@ -6010,7 +6335,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(
@@ -6072,7 +6398,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,
@@ -6173,7 +6499,7 @@ function getActionUpdateMetadata(actions) {
     "createdAtLocation",
     "createdByRole"
   ];
-  return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
+  return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
     (_2, action) => {
       if (action.originalActionId) {
         const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6203,26 +6529,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) {
@@ -6285,8 +6628,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,
@@ -6294,26 +6636,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
@@ -6548,7 +6904,7 @@ function getActionAnnotation({
   const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
   const actionWithCompleteAnnotation = action && {
     ...action,
-    annotation: getCompleteActionAnnotation({}, event2, action)
+    annotation: getCompleteActionAnnotation(event2, action)
   };
   const matchingDraft = draft?.action.type === actionType ? draft : void 0;
   const sortedActions = (0, import_lodash4.orderBy)(
@@ -6620,6 +6976,9 @@ function createFieldConfig(fieldId, options) {
 }
 
 // ../commons/src/events/field.ts
+function evaluate(computationFn) {
+  return { $$code: computationFn.toString() };
+}
 function field(fieldId, options = {}) {
   return {
     ...createFieldConditionals(fieldId),
@@ -10312,3 +10671,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])
+);