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

package/dist/notification/index.js

@@ -110,6 +110,10 @@ var scopeByEvent = z2.preprocess(
   (val) => val === void 0 ? void 0 : [val].flat(),
   z2.array(z2.string()).optional()
 ).describe("Event type, e.g. birth, death");
+var userRole = z2.preprocess(
+  (val) => val === void 0 ? void 0 : [val].flat(),
+  z2.array(z2.string()).optional()
+).describe("User role, e.g. admin, field agent");
 var scopeOptionsPlaceEvent = z2.object({
   event: scopeByEvent,
   placeOfEvent: JurisdictionFilter.optional()
@@ -133,6 +137,9 @@ var CustomActionScopeOptions = AllRecordScopeOptions.extend({
 var AccessLevelOptions = z2.object({
   accessLevel: JurisdictionFilter.optional()
 });
+var AllUserScopeOptions = AccessLevelOptions.extend({
+  role: userRole.optional()
+});
 var WorkqueueOrDashboardOptions = z2.object({
   ids: z2.preprocess(
     (val) => val === void 0 ? void 0 : [val].flat(),
@@ -142,6 +149,7 @@ var WorkqueueOrDashboardOptions = z2.object({
 var AllScopeOptions = z2.object({
   ...AllRecordScopeOptions.shape,
   ...AccessLevelOptions.shape,
+  ...AllUserScopeOptions.shape,
   ...WorkqueueOrDashboardOptions.shape
 });
 var ScopeOptionKey = AllScopeOptions.keyof();
@@ -214,6 +222,30 @@ var RecordScopeV2 = z2.discriminatedUnion("type", [
 ]).describe(
   "Scopes used to check user's permission to perform actions on a record."
 );
+var SystemScopeType = z2.enum([
+  "organisation.read-locations",
+  "user.read",
+  "user.create",
+  "user.edit",
+  "user.search"
+]);
+var UserScopeType = SystemScopeType.extract([
+  "user.read",
+  "user.create",
+  "user.edit",
+  "user.search"
+]);
+var ScopesWithRoleOption = UserScopeType.extract(["user.edit", "user.create"]);
+var UserScopeV2 = z2.discriminatedUnion("type", [
+  z2.object({
+    type: ScopesWithRoleOption,
+    options: AllUserScopeOptions.optional()
+  }),
+  z2.object({
+    type: UserScopeType.extract(["user.read", "user.search"]),
+    options: AccessLevelOptions.optional()
+  })
+]);
 var ResolvedRecordScopeV2 = z2.discriminatedUnion("type", [
   z2.object({
     type: ScopesWithPlaceEventOptions,
@@ -234,16 +266,14 @@ var ResolvedRecordScopeV2 = z2.discriminatedUnion("type", [
     }).optional()
   })
 ]).describe("Resolved scope with location/user IDs instead of filters.");
-var SystemScopeType = z2.enum([
-  "organisation.read-locations",
-  "user.read",
-  "user.create",
-  "user.edit"
-]);
 var Scope = z2.discriminatedUnion("type", [
   z2.object({ type: PlainScopeType }),
   ...RecordScopeV2.options,
-  z2.object({ type: SystemScopeType, options: AccessLevelOptions.optional() }),
+  ...UserScopeV2.options,
+  z2.object({
+    type: z2.literal("organisation.read-locations"),
+    options: AccessLevelOptions.optional()
+  }),
   z2.object({
     type: z2.literal("workqueue"),
     options: WorkqueueOrDashboardOptions
@@ -263,7 +293,9 @@ var ScopeType = z2.enum([
 var EncodedScope = z2.string().brand("EncodedScope");
 var DEFAULT_SCOPE_OPTIONS = {
   placeOfEvent: JurisdictionFilter.enum.all,
-  accessLevel: JurisdictionFilter.enum.all
+  accessLevel: JurisdictionFilter.enum.all,
+  registeredIn: JurisdictionFilter.enum.all,
+  declaredIn: JurisdictionFilter.enum.all
 };
 
 // ../commons/src/authentication.ts
@@ -622,7 +654,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
@@ -637,8 +672,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
@@ -853,7 +888,7 @@ var PlainDate = import_zod.z.string().date().brand("PlainDate").describe("Date i
 // ../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(),
@@ -882,6 +917,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",
@@ -950,28 +986,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."
   });
@@ -1188,8 +1216,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(
@@ -1281,6 +1310,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,
@@ -1288,6 +1320,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
@@ -1309,8 +1344,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(
@@ -1338,9 +1372,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."
   ),
@@ -1633,14 +1664,31 @@ 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 } }`'
+  ),
+  $$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 value, with an optional client-side computation applied."
+);
+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("Reference to a field by its ID");
+}).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(),
@@ -1671,7 +1719,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."
@@ -1679,30 +1727,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"),
@@ -1710,7 +1767,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",
@@ -1733,58 +1793,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",
@@ -1828,21 +1906,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"),
@@ -1858,7 +1948,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"),
@@ -1866,7 +1959,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"),
@@ -1875,17 +1968,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"),
@@ -1894,10 +1993,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(
     `
@@ -1909,16 +2011,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(),
@@ -1930,7 +2038,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 },
@@ -1949,26 +2057,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."
 );
@@ -1977,28 +2100,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({
@@ -2008,15 +2136,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({
@@ -2052,8 +2183,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,
@@ -2068,7 +2202,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",
@@ -2093,13 +2230,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),
@@ -2109,10 +2252,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."
@@ -2125,20 +2271,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({
@@ -2171,6 +2327,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),
@@ -2179,28 +2338,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.",
@@ -2208,21 +2374,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({
@@ -2232,22 +2404,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,
@@ -2346,16 +2521,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)
@@ -2455,6 +2633,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
@@ -2572,17 +2753,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" });
@@ -2658,7 +2864,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"));
@@ -2729,6 +2938,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({
@@ -2782,6 +2994,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
@@ -2832,7 +3047,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",
@@ -2877,12 +3122,35 @@ 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);
   }
 });
+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 isOnline() {
+  if (typeof window !== "undefined" && typeof navigator !== "undefined") {
+    return navigator.onLine;
+  }
+  return true;
+}
 
 // ../commons/src/utils.ts
 var z32 = __toESM(require("zod/v4"));
@@ -3501,7 +3769,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
+      };
+    }
   };
 }
 
@@ -3649,7 +3964,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."
@@ -3661,7 +3976,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"
@@ -3674,8 +3989,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);
@@ -3897,6 +4213,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(
@@ -4099,18 +4418,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."
 });
 var WorkqueueCountInput = z37.array(
   z37.object({ slug: z37.string(), query: QueryType })
@@ -4150,6 +4462,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(
@@ -4267,7 +4584,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(
@@ -4329,7 +4647,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,
@@ -6927,6 +7245,369 @@ var ACTION_FILTERS = {
 // ../commons/src/events/FileUtils.ts
 var import_lodash7 = require("lodash");
 
+// ../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])
+);
+
 // ../commons/src/notification/UserNotifications.ts
 var z44 = __toESM(require("zod/v4"));
 var TriggerEvent = {