@opencrvs/toolkit 1.9.2-rc.c76ff3e → 1.9.2-rc.f1d7235

package/dist/events/index.js

@@ -77,6 +77,7 @@ __export(events_exports, {
   CustomActionInput: () => CustomActionInput,
   CustomFlag: () => CustomFlag,
   DEFAULT_DATE_OF_EVENT_PROPERTY: () => DEFAULT_DATE_OF_EVENT_PROPERTY,
+  DEFAULT_PLACE_OF_EVENT_PROPERTY: () => DEFAULT_PLACE_OF_EVENT_PROPERTY,
   DataEntry: () => DataEntry,
   DataFieldValue: () => DataFieldValue,
   DateCondition: () => DateCondition,
@@ -137,6 +138,7 @@ __export(events_exports, {
   FormPageConfig: () => FormPageConfig,
   Fuzzy: () => Fuzzy,
   GeographicalArea: () => GeographicalArea,
+  HiddenFieldValue: () => HiddenFieldValue,
   HttpFieldUpdateValue: () => HttpFieldUpdateValue,
   HttpFieldValue: () => HttpFieldValue,
   IdReaderFieldValue: () => IdReaderFieldValue,
@@ -216,6 +218,7 @@ __export(events_exports, {
   ZodDate: () => ZodDate,
   actionConfigTypes: () => actionConfigTypes,
   ageToDate: () => ageToDate,
+  aggregateActionAnnotations: () => aggregateActionAnnotations,
   aggregateActionDeclarations: () => aggregateActionDeclarations,
   alwaysTrue: () => alwaysTrue,
   and: () => and,
@@ -331,6 +334,7 @@ __export(events_exports, {
   isFieldVisible: () => isFieldVisible,
   isFileFieldType: () => isFileFieldType,
   isFileFieldWithOptionType: () => isFileFieldWithOptionType,
+  isHiddenFieldType: () => isHiddenFieldType,
   isHttpFieldType: () => isHttpFieldType,
   isIdFieldType: () => isIdFieldType,
   isIdReaderFieldType: () => isIdReaderFieldType,
@@ -375,6 +379,7 @@ __export(events_exports, {
   or: () => or,
   pickRandom: () => pickRandom,
   resolveDateOfEvent: () => resolveDateOfEvent,
+  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
   runFieldValidations: () => runFieldValidations,
   runStructuralValidations: () => runStructuralValidations,
   safeUnion: () => safeUnion,
@@ -395,7 +400,7 @@ var TENNIS_CLUB_MEMBERSHIP = "tennis-club-membership";
 var CHILD_ONBOARDING_EVENT = "child-onboarding";
 
 // ../commons/src/events/ActionConfig.ts
-var z20 = __toESM(require("zod/v4"));
+var z21 = __toESM(require("zod/v4"));
 
 // ../commons/src/events/TranslationConfig.ts
 var z = __toESM(require("zod/v4"));
@@ -613,7 +618,8 @@ var FieldType = {
   QUERY_PARAM_READER: "QUERY_PARAM_READER",
   QR_READER: "QR_READER",
   ID_READER: "ID_READER",
-  LOADER: "LOADER"
+  LOADER: "LOADER",
+  HIDDEN: "HIDDEN"
 };
 var FileFieldType = z4.enum([
   FieldType.FILE,
@@ -747,6 +753,7 @@ var IdReaderFieldValue = ReadDataValue;
 
 // ../commons/src/events/FieldValue.ts
 var TextValue = z7.string();
+var HiddenFieldValue = z7.string();
 var NonEmptyTextValue = TextValue.min(1);
 var DateValue = z7.iso.date().describe("Date in the format YYYY-MM-DD");
 var AgeValue = z7.object({
@@ -872,7 +879,8 @@ var FieldUpdateValue = safeUnion([
   DataFieldValue.describe("DataFieldValue"),
   NameFieldUpdateValue.describe("NameFieldUpdateValue"),
   HttpFieldUpdateValue.describe("HttpFieldUpdateValue"),
-  QueryParamReaderFieldUpdateValue.describe("QueryParamReaderFieldUpdateValue")
+  QueryParamReaderFieldUpdateValue.describe("QueryParamReaderFieldUpdateValue"),
+  HiddenFieldValue.describe("HiddenFieldValue")
 ]);
 
 // ../commons/src/uuid.ts
@@ -1166,6 +1174,11 @@ var ConfigurableRawScopes = z10.discriminatedUnion("type", [
   RecordScope,
   CustomActionScope
 ]);
+var ConfigurableActionScopes = z10.discriminatedUnion("type", [
+  // @TODO - Record scope holds non-action scopes as well e.g., `record.read`
+  RecordScope,
+  CustomActionScope
+]);
 function flattenAndMergeScopes(scopes2) {
   if (scopes2.length === 0) return null;
   const type = scopes2[0].type;
@@ -1591,7 +1604,7 @@ var FlagConfig = z13.object({
   label: TranslationConfig.describe("Human readable label of the flag.")
 });
 var ActionFlagConfig = z13.object({
-  id: CustomFlag,
+  id: Flag,
   operation: z13.enum(["add", "remove"]).describe("Operation to perform on the flag."),
   conditional: Conditional.optional().describe(
     "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
@@ -1636,6 +1649,7 @@ var EventMetadata = z14.object({
   ),
   createdAt: z14.iso.datetime().describe("The timestamp when the event was first created and saved."),
   dateOfEvent: ZodDate.nullish(),
+  placeOfEvent: CreatedAtLocation,
   createdBy: z14.string().describe("ID of the user who created the event."),
   createdByUserType: z14.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
   updatedByUserRole: z14.string().describe("Role of the user who last changed the status."),
@@ -1665,6 +1679,7 @@ var EventMetadataKeysArray = [
   "status",
   "createdAt",
   "dateOfEvent",
+  "placeOfEvent",
   "createdBy",
   "createdByUserType",
   "updatedByUserRole",
@@ -1699,6 +1714,11 @@ var eventMetadataLabelMap = {
     defaultMessage: "Date of Event",
     description: "Date of Event"
   },
+  "event.placeOfEvent": {
+    id: "event.placeOfEvent.label",
+    defaultMessage: "Place of Event",
+    description: "Place of Event"
+  },
   "event.createdAtLocation": {
     id: "event.createdAtLocation.label",
     defaultMessage: "Location",
@@ -2439,6 +2459,13 @@ var LoaderField = BaseField.extend({
 }).describe(
   "A non-interactive field that indicates an in progress operation in form"
 );
+var HiddenField = BaseField.extend({
+  type: z16.literal(FieldType.HIDDEN),
+  required: z16.literal(false).optional()
+  // Hidden fields cannot be required
+}).describe(
+  "A non-interactive, hidden field that only hold a value in the form"
+);
 var FieldConfig = z16.discriminatedUnion("type", [
   Address,
   TextField,
@@ -2478,7 +2505,8 @@ var FieldConfig = z16.discriminatedUnion("type", [
   IdReaderField,
   QueryParamReaderField,
   LoaderField,
-  SearchField
+  SearchField,
+  HiddenField
 ]).meta({
   description: "Form field configuration",
   id: "FieldConfig"
@@ -2633,82 +2661,188 @@ var DeduplicationConfig = z19.object({
   query: Clause
 });
 
+// ../commons/src/icons.ts
+var z20 = __toESM(require("zod/v4"));
+var AvailableIcons = z20.enum([
+  "Archived",
+  "Assigned",
+  "Certified",
+  "Close",
+  "Collapse",
+  "Draft",
+  "DuplicateYellow",
+  "Expand",
+  "ExternalValidate",
+  "FilledCheck",
+  "InReview",
+  "Offline",
+  "Registered",
+  "RequiresUpdates",
+  "Sent",
+  "Validated",
+  "WaitingApproval",
+  "ChartActivity",
+  "Activity",
+  "Archive",
+  "ArchiveTray",
+  "ArrowLeft",
+  "ArrowRight",
+  "Buildings",
+  "Circle",
+  "CaretDown",
+  "CaretLeft",
+  "CaretRight",
+  "ChartBar",
+  "ChartLine",
+  "ChatCircle",
+  "CheckSquare",
+  "Compass",
+  "Check",
+  "Copy",
+  "Database",
+  "DotsThreeVertical",
+  "ArrowCounterClockwise",
+  "MagnifyingGlassMinus",
+  "MagnifyingGlassPlus",
+  "Export",
+  "Eye",
+  "EyeSlash",
+  "Envelope",
+  "File",
+  "FileSearch",
+  "FileMinus",
+  "FilePlus",
+  "FileText",
+  "FileX",
+  "Handshake",
+  "Gear",
+  "GitBranch",
+  "IdentificationCard",
+  "List",
+  "ListBullets",
+  "Lock",
+  "MagnifyingGlass",
+  "MapPin",
+  "Medal",
+  "NotePencil",
+  "Paperclip",
+  "PaperPlaneTilt",
+  "Pen",
+  "Pencil",
+  "PencilSimpleLine",
+  "Phone",
+  "Plus",
+  "Printer",
+  "SignOut",
+  "Stamp",
+  "Star",
+  "Target",
+  "TextT",
+  "Trash",
+  "UploadSimple",
+  "User",
+  "UserPlus",
+  "Users",
+  "WarningCircle",
+  "X",
+  "CircleWavyCheck",
+  "CircleWavyQuestion",
+  "ArchiveBox",
+  "ArrowCircleDown",
+  "FileArrowUp",
+  "FileDotted",
+  "Files",
+  "PencilLine",
+  "PencilCircle",
+  "UserCircle",
+  "Clock",
+  "QrCode",
+  "Webcam",
+  "Sun",
+  "DeviceTabletCamera",
+  "Globe",
+  "Fingerprint",
+  "PushPin",
+  "Timer"
+]);
+
 // ../commons/src/events/ActionConfig.ts
-var DeclarationReviewConfig = z20.object({
+var DeclarationReviewConfig = z21.object({
   title: TranslationConfig.describe("Title of the review page"),
-  fields: z20.array(FieldConfig).describe("Fields displayed on the review page for annotations.")
+  fields: z21.array(FieldConfig).describe("Fields displayed on the review page for annotations.")
 }).describe(
   "Configuration of the declaration review page for collecting event-related metadata."
 );
-var ActionConfigBase = z20.object({
+var ActionConfigBase = z21.object({
   label: TranslationConfig.describe("Human readable description of the action"),
-  flags: z20.array(ActionFlagConfig).optional().default([]).describe("Flag actions which are executed when the action is performed."),
+  flags: z21.array(ActionFlagConfig).optional().default([]).describe("Flag actions which are executed when the action is performed."),
   auditHistoryLabel: TranslationConfig.describe(
     'The label to show in audit history for this action. For example "Approved".'
   ).optional(),
   supportingCopy: TranslationConfig.optional().describe(
     "Text displayed on the confirmation"
   ),
-  conditionals: z20.array(ActionConditional).optional().describe("Conditionals which can disable or hide actions.")
+  icon: AvailableIcons.describe("Icon representing the action").optional(),
+  conditionals: z21.array(ActionConditional).optional().describe("Conditionals which can disable or hide actions.")
 });
 var DeclarationActionBase = ActionConfigBase.extend({
   deduplication: DeduplicationConfig.optional()
 });
 var ReadActionConfig = ActionConfigBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.READ),
+  z21.object({
+    type: z21.literal(ActionType.READ),
     review: DeclarationReviewConfig.describe(
       "Configuration of the review page for read-only view."
     ),
-    conditionals: z20.never().optional().describe("Read-action can not be disabled or hidden with conditionals.")
+    conditionals: z21.never().optional().describe("Read-action can not be disabled or hidden with conditionals.")
   }).shape
 );
 var DeclareConfig = DeclarationActionBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.DECLARE),
+  z21.object({
+    type: z21.literal(ActionType.DECLARE),
     review: DeclarationReviewConfig.describe(
       "Configuration of the review page fields."
     )
   }).shape
 );
 var RejectConfig = ActionConfigBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.REJECT)
+  z21.object({
+    type: z21.literal(ActionType.REJECT)
   }).shape
 );
 var ValidateConfig = DeclarationActionBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.VALIDATE)
+  z21.object({
+    type: z21.literal(ActionType.VALIDATE)
   }).shape
 );
 var RegisterConfig = DeclarationActionBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.REGISTER)
+  z21.object({
+    type: z21.literal(ActionType.REGISTER)
   }).shape
 );
 var PrintCertificateActionConfig = ActionConfigBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.PRINT_CERTIFICATE),
+  z21.object({
+    type: z21.literal(ActionType.PRINT_CERTIFICATE),
     printForm: ActionFormConfig
   }).shape
 );
 var RequestCorrectionConfig = ActionConfigBase.extend(
-  z20.object({
-    type: z20.literal(ActionType.REQUEST_CORRECTION),
+  z21.object({
+    type: z21.literal(ActionType.REQUEST_CORRECTION),
     correctionForm: ActionFormConfig
   }).shape
 );
 var CustomActionConfig = ActionConfigBase.merge(
-  z20.object({
-    type: z20.literal(ActionType.CUSTOM),
-    customActionType: z20.string().describe("Type identifier of the custom action."),
+  z21.object({
+    type: z21.literal(ActionType.CUSTOM),
+    customActionType: z21.string().describe("Type identifier of the custom action."),
     /** Custom action form configuration supports a simple array of field configs, which should be rendered on the action modal. In the future, we might add support for pages etc. */
-    form: z20.array(FieldConfig).describe(
+    form: z21.array(FieldConfig).describe(
       "Form configuration for the custom action. The form configured here will be used on the custom action confirmation modal."
     )
   })
 );
-var ActionConfig = z20.discriminatedUnion("type", [
+var ActionConfig = z21.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.
@@ -2729,87 +2863,87 @@ var ActionConfig = z20.discriminatedUnion("type", [
 var actionConfigTypes = new Set(
   ActionConfig.options.map((opt) => opt.shape.type.value)
 );
-var DeclarationActionConfig = z20.discriminatedUnion("type", [
+var DeclarationActionConfig = z21.discriminatedUnion("type", [
   DeclareConfig,
   ValidateConfig,
   RegisterConfig
 ]);
 
 // ../commons/src/events/offline/CertificateConfig.ts
-var z21 = __toESM(require("zod/v4"));
-var FontFamily = z21.object({
-  normal: z21.string(),
-  bold: z21.string(),
-  italics: z21.string(),
-  bolditalics: z21.string()
+var z22 = __toESM(require("zod/v4"));
+var FontFamily = z22.object({
+  normal: z22.string(),
+  bold: z22.string(),
+  italics: z22.string(),
+  bolditalics: z22.string()
 });
-var CertificateConfig = z21.object({
-  id: z21.string(),
-  event: z21.string(),
-  isV2Template: z21.boolean().optional(),
+var CertificateConfig = z22.object({
+  id: z22.string(),
+  event: z22.string(),
+  isV2Template: z22.boolean().optional(),
   label: TranslationConfig,
-  isDefault: z21.boolean(),
-  fee: z21.object({
-    onTime: z21.number(),
-    late: z21.number(),
-    delayed: z21.number()
+  isDefault: z22.boolean(),
+  fee: z22.object({
+    onTime: z22.number(),
+    late: z22.number(),
+    delayed: z22.number()
   }),
-  svgUrl: z21.string(),
-  fonts: z21.record(z21.string(), FontFamily).optional(),
-  conditionals: z21.array(ShowConditional).optional()
+  svgUrl: z22.string(),
+  fonts: z22.record(z22.string(), FontFamily).optional(),
+  conditionals: z22.array(ShowConditional).optional()
 });
 var CertificateTemplateConfig = CertificateConfig.extend({
-  hash: z21.string().optional(),
-  svg: z21.string()
+  hash: z22.string().optional(),
+  svg: z22.string()
 });
 
 // ../commons/src/events/offline/LanguageConfig.ts
-var z22 = __toESM(require("zod/v4"));
-var LanguageConfig = z22.object({
-  lang: z22.string(),
+var z23 = __toESM(require("zod/v4"));
+var LanguageConfig = z23.object({
+  lang: z23.string(),
   /**
    * client.csv contents
    */
-  messages: z22.record(z22.string(), z22.string())
+  messages: z23.record(z23.string(), z23.string())
 });
 
 // ../commons/src/events/EventConfig.ts
-var z28 = __toESM(require("zod/v4"));
+var z29 = __toESM(require("zod/v4"));
 
 // ../commons/src/events/SummaryConfig.ts
-var z23 = __toESM(require("zod/v4"));
-var BaseField2 = z23.object({
+var z24 = __toESM(require("zod/v4"));
+var BaseField2 = z24.object({
   emptyValueMessage: TranslationConfig.optional().describe(
     "Default message displayed when the field value is empty."
   ),
-  conditionals: z23.array(ShowConditional).default([]).optional()
+  conditionals: z24.array(ShowConditional).default([]).optional()
 });
 var ReferenceField = BaseField2.extend({
-  fieldId: z23.string(),
+  fieldId: z24.string(),
   label: TranslationConfig.optional().describe(
     "Overrides the default label from the referenced field when provided."
   )
 }).describe("Field referencing existing event data by field ID.");
 var Field = BaseField2.extend({
-  id: z23.string().describe("Identifier of the summary field."),
+  id: z24.string().describe("Identifier of the summary field."),
   value: TranslationConfig.describe(
     'Field value template supporting variables from configuration and EventMetadata (e.g. "{informant.phoneNo} {informant.email}").'
   ),
   label: TranslationConfig
 }).describe("Custom field defined for the summary view.");
-var SummaryConfig = z23.object({
-  fields: z23.array(z23.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
+var SummaryConfig = z24.object({
+  fields: z24.array(z24.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
 }).describe("Configuration of the event summary section.");
 
 // ../commons/src/events/AdvancedSearchConfig.ts
-var z24 = __toESM(require("zod/v4"));
-var MatchType = z24.enum(["fuzzy", "exact", "range", "within"]);
-var BaseField3 = z24.object({
-  config: z24.object({
+var z25 = __toESM(require("zod/v4"));
+var MatchType = z25.enum(["fuzzy", "exact", "range", "within"]);
+var BaseField3 = z25.object({
+  config: z25.object({
     type: MatchType.describe(
       "Determines the search type of field. How to match value."
     ),
-    searchFields: z24.array(z24.string()).optional().describe(
+    searchFields: z25.array(z25.string()).optional().describe(
       `
       Defines multiple form fields that should be searched when this field has a value.
       All specified fields will be combined using OR logic.
@@ -2819,7 +2953,7 @@ var BaseField3 = z24.object({
       `
     )
   }),
-  type: z24.nativeEnum(FieldType).optional().describe(
+  type: z25.nativeEnum(FieldType).optional().describe(
     `
       Explicitly specify the field type for searchFields.
       This is required when searchFields is defined, to show the correct control in the UI.
@@ -2833,7 +2967,7 @@ var BaseField3 = z24.object({
       This is required when searchFields is defined.            
       `
   ),
-  options: z24.array(SelectOption).optional(),
+  options: z25.array(SelectOption).optional(),
   searchCriteriaLabelPrefix: TranslationConfig.optional().describe(
     `
     This property determines whether to add a prefix (such as "Child" or "Applicant") before the field label
@@ -2854,7 +2988,7 @@ var BaseField3 = z24.object({
     in the country-config > event.advancedSearch configuration. For example: field("child.dob", { searchCriteriaLabelPrefix: TranslationConfig }).
     `
   ),
-  conditionals: z24.array(FieldConditional).optional().describe(
+  conditionals: z25.array(FieldConditional).optional().describe(
     `
        In advanced search, we sometimes need to override the default field visibility conditionals.
 
@@ -2868,59 +3002,61 @@ var BaseField3 = z24.object({
        are always rendered in the advanced search form.
       `
   ),
-  validations: z24.array(ValidationConfig).optional().describe(
+  validations: z25.array(ValidationConfig).optional().describe(
     `Option for overriding the field validations specifically for advanced search form.`
   )
 });
-var SearchQueryParams = z24.object({
-  eventType: z24.string().optional().describe(
+var SearchQueryParams = z25.object({
+  eventType: z25.string().optional().describe(
     "Defines type of event so that when redirecting to Advanced Search page, appropriate tab can be selected"
   )
 }).catchall(FieldValue);
 var FieldConfigSchema = BaseField3.extend({
-  fieldId: z24.string(),
-  fieldType: z24.literal("field")
+  fieldId: z25.string(),
+  fieldType: z25.literal("field")
 });
-var EventFieldIdInput = z24.enum([
+var EventFieldIdInput = z25.enum([
   "trackingId",
   "status",
   "legalStatuses.REGISTERED.acceptedAt",
   "legalStatuses.REGISTERED.createdAtLocation",
+  "legalStatuses.REGISTERED.registrationNumber",
   "updatedAt"
 ]);
 var METADATA_FIELD_PREFIX = "event.";
-var EventFieldId = z24.enum([
+var EventFieldId = z25.enum([
   `${METADATA_FIELD_PREFIX}trackingId`,
   `${METADATA_FIELD_PREFIX}status`,
   `${METADATA_FIELD_PREFIX}legalStatuses.REGISTERED.acceptedAt`,
   `${METADATA_FIELD_PREFIX}legalStatuses.REGISTERED.createdAtLocation`,
+  `${METADATA_FIELD_PREFIX}legalStatuses.REGISTERED.registrationNumber`,
   `${METADATA_FIELD_PREFIX}updatedAt`
 ]);
 var EventFieldConfigSchema = BaseField3.extend({
   fieldId: EventFieldId,
-  fieldType: z24.literal("event")
+  fieldType: z25.literal("event")
 });
-var AdvancedSearchField = z24.discriminatedUnion("fieldType", [FieldConfigSchema, EventFieldConfigSchema]).superRefine((data, ctx) => {
+var AdvancedSearchField = z25.discriminatedUnion("fieldType", [FieldConfigSchema, EventFieldConfigSchema]).superRefine((data, ctx) => {
   if (data.config.searchFields && data.config.searchFields.length > 0) {
     if (!data.label) {
       ctx.addIssue({
-        code: z24.ZodIssueCode.custom,
+        code: z25.ZodIssueCode.custom,
         message: "label is required when config.searchFields is defined.",
         path: ["label"]
       });
     }
     if (!data.type) {
       ctx.addIssue({
-        code: z24.ZodIssueCode.custom,
+        code: z25.ZodIssueCode.custom,
         message: "type is required when config.searchFields is defined.",
         path: ["type"]
       });
     }
   }
 });
-var AdvancedSearchConfig = z24.object({
+var AdvancedSearchConfig = z25.object({
   title: TranslationConfig.describe("Advanced search tab title"),
-  fields: z24.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
+  fields: z25.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
 });
 
 // ../commons/src/events/utils.ts
@@ -2929,14 +3065,14 @@ var import_lodash = require("lodash");
 // ../commons/src/conditionals/validate.ts
 var import__ = __toESM(require("ajv/dist/2019"));
 var import_ajv_formats = __toESM(require("ajv-formats"));
-var z26 = __toESM(require("zod/v4"));
+var z27 = __toESM(require("zod/v4"));
 var import_date_fns = require("date-fns");
 
 // ../commons/src/events/DynamicFieldValue.ts
-var z25 = __toESM(require("zod/v4"));
+var z26 = __toESM(require("zod/v4"));
 function getDynamicNameValue(field3) {
   const nameConfiguration = field3.configuration?.name;
-  return z25.object({
+  return z26.object({
     firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
     surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
     middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
@@ -3002,6 +3138,7 @@ function mapFieldTypeToZod(field3, actionType) {
     case FieldType.VERIFICATION_STATUS:
     case FieldType.ID:
     case FieldType.LOADER:
+    case FieldType.HIDDEN:
       schema = field3.required ? NonEmptyTextValue : TextValue;
       break;
     case FieldType.NUMBER:
@@ -3085,6 +3222,7 @@ function mapFieldTypeToEmptyValue(field3) {
     case FieldType.QR_READER:
     case FieldType.ID_READER:
     case FieldType.LOADER:
+    case FieldType.HIDDEN:
       return null;
     case FieldType.ADDRESS:
       return {
@@ -3221,6 +3359,9 @@ var isIdReaderFieldType = (field3) => {
 var isLoaderFieldType = (field3) => {
   return field3.config.type === FieldType.LOADER;
 };
+var isHiddenFieldType = (field3) => {
+  return field3.config.type === FieldType.HIDDEN;
+};
 var isNonInteractiveFieldType = (field3) => {
   return field3.type === FieldType.DIVIDER || field3.type === FieldType.PAGE_HEADER || field3.type === FieldType.PARAGRAPH || field3.type === FieldType.BULLET_LIST || field3.type === FieldType.DATA || field3.type === FieldType.ALPHA_PRINT_BUTTON || field3.type === FieldType.HTTP || field3.type === FieldType.LINK_BUTTON || field3.type === FieldType.QUERY_PARAM_READER || field3.type === FieldType.LOADER;
 };
@@ -3232,9 +3373,9 @@ var ajv = new import__.default({
   strict: false
   // Allow minContains and other newer features
 });
-var DataContext = z26.object({
-  rootData: z26.object({
-    $leafAdminStructureLocationIds: z26.array(z26.object({ id: UUID }))
+var DataContext = z27.object({
+  rootData: z27.object({
+    $leafAdminStructureLocationIds: z27.array(z27.object({ id: UUID }))
   })
 });
 (0, import_ajv_formats.default)(ajv);
@@ -3605,7 +3746,7 @@ function areCertificateConditionsMet(conditions, values) {
 }
 
 // ../commons/src/utils.ts
-var z27 = __toESM(require("zod/v4"));
+var z28 = __toESM(require("zod/v4"));
 function getOrThrow(x, message) {
   if (x === void 0 || x === null) {
     throw new Error(message);
@@ -3615,11 +3756,11 @@ function getOrThrow(x, message) {
 function joinValues(values, separator = " ") {
   return values.filter((value) => !!value).join(separator).trim();
 }
-var FullNameV1 = z27.array(
-  z27.object({
-    use: z27.string(),
-    family: z27.string(),
-    given: z27.array(z27.string())
+var FullNameV1 = z28.array(
+  z28.object({
+    use: z28.string(),
+    family: z28.string(),
+    given: z28.array(z28.string())
   })
 );
 function omitKeyDeep(obj, keyToRemove) {
@@ -3995,15 +4136,23 @@ function aggregateActionDeclarations(event2) {
     return getCompleteActionDeclaration(declaration, event2, action);
   }, {});
 }
+function aggregateActionAnnotations(actions) {
+  return actions.reduce((ann, sortedAction) => {
+    return deepMerge(ann, sortedAction.annotation ?? {});
+  }, {});
+}
 
 // ../commons/src/events/EventConfig.ts
-var EventConfig = z28.object({
-  id: z28.string().describe(
+var EventConfig = z29.object({
+  id: z29.string().describe(
     'Machine-readable identifier of the event (e.g. "birth", "death").'
   ),
   dateOfEvent: FieldReference.optional().describe(
     "Reference to the field capturing the date of the event (e.g. date of birth). Defaults to the event creation date if unspecified."
   ),
+  placeOfEvent: FieldReference.optional().describe(
+    "Reference to the field capturing the place of the event (e.g. place of birth). Defaults to the meta.createdAtLocation if unspecified."
+  ),
   title: TranslationConfig.describe(
     'Title template for the singular event, supporting variables (e.g. "{applicant.name.firstname} {applicant.name.surname}").'
   ),
@@ -4016,16 +4165,16 @@ var EventConfig = z28.object({
   label: TranslationConfig.describe(
     "Human-readable label for the event type."
   ),
-  actions: z28.array(ActionConfig).describe(
+  actions: z29.array(ActionConfig).describe(
     "Configuration of system-defined actions associated with the event."
   ),
   declaration: DeclarationFormConfig.describe(
     "Configuration of the form used to gather event data."
   ),
-  advancedSearch: z28.array(AdvancedSearchConfig).optional().default([]).describe(
+  advancedSearch: z29.array(AdvancedSearchConfig).optional().default([]).describe(
     "Configuration of fields available in the advanced search feature."
   ),
-  flags: z28.array(FlagConfig).optional().default([]).describe(
+  flags: z29.array(FlagConfig).optional().default([]).describe(
     "Configuration of flags associated with the actions of this event type."
   )
 }).superRefine((event2, ctx) => {
@@ -4078,15 +4227,31 @@ var EventConfig = z28.object({
       });
     }
   }
+  if (event2.placeOfEvent) {
+    const eventPlaceFieldId = getDeclarationFields(event2).find(
+      ({ id }) => id === event2.placeOfEvent?.$$field
+    );
+    if (!eventPlaceFieldId) {
+      ctx.addIssue({
+        code: "custom",
+        message: `Place of event field id must match a field id in the event.declaration fields.
+            Invalid place of event field ID for event ${event2.id}: ${event2.placeOfEvent.$$field}`,
+        path: ["placeOfEvent"]
+      });
+    }
+  }
+  const isInherentFlag = (value) => Object.values(InherentFlags).includes(value);
   const configuredFlagIds = event2.flags.map((flag2) => flag2.id);
   const actionFlagIds = event2.actions.flatMap(
     (action) => action.flags.map((flag2) => flag2.id)
   );
   for (const actionFlagId of actionFlagIds) {
-    if (!configuredFlagIds.includes(actionFlagId)) {
+    const isConfigured = configuredFlagIds.includes(actionFlagId);
+    const isInherent = isInherentFlag(actionFlagId);
+    if (!isConfigured && !isInherent) {
       ctx.addIssue({
         code: "custom",
-        message: `Action flag id must match a configured flag in the flags array. Invalid action flag ID for event '${event2.id}': '${actionFlagId}'`,
+        message: `Action flag id must match an inherent flag or a configured flag in the flags array. Invalid action flag ID for event '${event2.id}': '${actionFlagId}'`,
         path: ["actions"]
       });
     }
@@ -4823,17 +4988,17 @@ var event = Object.assign(eventFn, {
 });
 
 // ../commons/src/events/WorkqueueColumnConfig.ts
-var z29 = __toESM(require("zod/v4"));
+var z30 = __toESM(require("zod/v4"));
 var WorkqueueColumnKeysArray = [
   ...EventMetadataKeysArray,
   "title",
   "outbox"
 ];
-var WorkqueueColumnKeys = z29.enum(WorkqueueColumnKeysArray);
-var WorkqueueColumnValue = z29.object({
+var WorkqueueColumnKeys = z30.enum(WorkqueueColumnKeysArray);
+var WorkqueueColumnValue = z30.object({
   $event: WorkqueueColumnKeys
 });
-var WorkqueueColumn = z29.object({
+var WorkqueueColumn = z30.object({
   label: TranslationConfig,
   value: WorkqueueColumnValue
 });
@@ -4844,158 +5009,54 @@ function defineWorkqueuesColumns(workqueueColumns) {
 }
 
 // ../commons/src/events/CountryConfigQueryInput.ts
-var z30 = __toESM(require("zod/v4"));
-var SerializableExact = z30.object({
-  type: z30.literal("exact"),
-  term: z30.union([z30.string(), SerializedUserField])
+var z31 = __toESM(require("zod/v4"));
+var SerializableExact = z31.object({
+  type: z31.literal("exact"),
+  term: z31.union([z31.string(), SerializedUserField])
 });
-var SerializableWithin = z30.object({
-  type: z30.literal("within"),
-  location: z30.union([z30.string(), SerializedUserField])
+var SerializableWithin = z31.object({
+  type: z31.literal("within"),
+  location: z31.union([z31.string(), SerializedUserField])
 });
-var SerializedQueryExpression = z30.object({
-  eventType: z30.string(),
-  status: z30.optional(z30.union([AnyOfStatus, ExactStatus])),
-  createdAt: z30.optional(DateCondition),
-  updatedAt: z30.optional(DateCondition),
-  "legalStatuses.REGISTERED.createdAt": z30.optional(DateCondition),
-  "legalStatuses.REGISTERED.createdAtLocation": z30.optional(
-    z30.union([Within, Exact])
+var SerializedQueryExpression = z31.object({
+  eventType: z31.string(),
+  status: z31.optional(z31.union([AnyOfStatus, ExactStatus])),
+  createdAt: z31.optional(DateCondition),
+  updatedAt: z31.optional(DateCondition),
+  "legalStatuses.REGISTERED.createdAt": z31.optional(DateCondition),
+  "legalStatuses.REGISTERED.createdAtLocation": z31.optional(
+    z31.union([Within, Exact])
   ),
-  "legalStatuses.REGISTERED.registrationNumber": z30.optional(Exact),
-  createdAtLocation: z30.optional(
-    z30.union([SerializableWithin, SerializableExact])
+  "legalStatuses.REGISTERED.registrationNumber": z31.optional(Exact),
+  createdAtLocation: z31.optional(
+    z31.union([SerializableWithin, SerializableExact])
   ),
-  updatedAtLocation: z30.optional(
-    z30.union([SerializableWithin, SerializableExact])
+  updatedAtLocation: z31.optional(
+    z31.union([SerializableWithin, SerializableExact])
   ),
-  assignedTo: z30.optional(SerializableExact),
-  createdBy: z30.optional(SerializableExact),
+  assignedTo: z31.optional(SerializableExact),
+  createdBy: z31.optional(SerializableExact),
   createdByUserType: ExactUserType,
-  updatedBy: z30.optional(SerializableExact),
-  trackingId: z30.optional(Exact),
-  flags: z30.optional(ContainsFlags),
+  updatedBy: z31.optional(SerializableExact),
+  trackingId: z31.optional(Exact),
+  flags: z31.optional(ContainsFlags),
   data: QueryInput
 }).partial();
-var Or2 = z30.object({
-  type: z30.literal("or"),
-  clauses: z30.array(SerializedQueryExpression)
+var Or2 = z31.object({
+  type: z31.literal("or"),
+  clauses: z31.array(SerializedQueryExpression)
 });
-var And2 = z30.object({
-  type: z30.literal("and"),
-  clauses: z30.array(SerializedQueryExpression)
+var And2 = z31.object({
+  type: z31.literal("and"),
+  clauses: z31.array(SerializedQueryExpression)
 });
-var CountryConfigQueryType = z30.discriminatedUnion("type", [And2, Or2]);
-var CountryConfigQueryInputType = z30.union([
+var CountryConfigQueryType = z31.discriminatedUnion("type", [And2, Or2]);
+var CountryConfigQueryInputType = z31.union([
   SerializedQueryExpression,
   And2,
   Or2
 ]);
 
-// ../commons/src/icons.ts
-var z31 = __toESM(require("zod/v4"));
-var AvailableIcons = z31.enum([
-  "Archived",
-  "Assigned",
-  "Certified",
-  "Close",
-  "Collapse",
-  "Draft",
-  "DuplicateYellow",
-  "Expand",
-  "ExternalValidate",
-  "FilledCheck",
-  "InReview",
-  "Offline",
-  "Registered",
-  "RequiresUpdates",
-  "Sent",
-  "Validated",
-  "WaitingApproval",
-  "ChartActivity",
-  "Activity",
-  "Archive",
-  "ArchiveTray",
-  "ArrowLeft",
-  "ArrowRight",
-  "Buildings",
-  "Circle",
-  "CaretDown",
-  "CaretLeft",
-  "CaretRight",
-  "ChartBar",
-  "ChartLine",
-  "ChatCircle",
-  "CheckSquare",
-  "Compass",
-  "Check",
-  "Copy",
-  "Database",
-  "DotsThreeVertical",
-  "ArrowCounterClockwise",
-  "MagnifyingGlassMinus",
-  "MagnifyingGlassPlus",
-  "Export",
-  "Eye",
-  "EyeSlash",
-  "Envelope",
-  "File",
-  "FileSearch",
-  "FileMinus",
-  "FilePlus",
-  "FileText",
-  "FileX",
-  "Handshake",
-  "Gear",
-  "GitBranch",
-  "IdentificationCard",
-  "List",
-  "ListBullets",
-  "Lock",
-  "MagnifyingGlass",
-  "MapPin",
-  "Medal",
-  "NotePencil",
-  "Paperclip",
-  "PaperPlaneTilt",
-  "Pen",
-  "Pencil",
-  "PencilSimpleLine",
-  "Phone",
-  "Plus",
-  "Printer",
-  "SignOut",
-  "Star",
-  "Target",
-  "TextT",
-  "Trash",
-  "UploadSimple",
-  "User",
-  "UserPlus",
-  "Users",
-  "WarningCircle",
-  "X",
-  "CircleWavyCheck",
-  "CircleWavyQuestion",
-  "ArchiveBox",
-  "ArrowCircleDown",
-  "FileArrowUp",
-  "FileDotted",
-  "Files",
-  "PencilLine",
-  "PencilCircle",
-  "UserCircle",
-  "Clock",
-  "QrCode",
-  "Webcam",
-  "Sun",
-  "DeviceTabletCamera",
-  "Globe",
-  "Fingerprint",
-  "PushPin",
-  "Timer"
-]);
-
 // ../commons/src/events/WorkqueueConfig.ts
 var mandatoryColumns = defineWorkqueuesColumns([
   {
@@ -5354,7 +5415,8 @@ var updateActions = ActionTypes.extract([
   ActionType.REJECT,
   ActionType.ARCHIVE,
   ActionType.PRINT_CERTIFICATE,
-  ActionType.REQUEST_CORRECTION
+  ActionType.REQUEST_CORRECTION,
+  ActionType.CUSTOM
 ]);
 function getActionUpdateMetadata(actions) {
   const createAction = getOrThrow(
@@ -5476,7 +5538,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
       actions: actions.slice(0, idx + 1)
     };
     const declaration = aggregateActionDeclarations(eventUpToThisAction);
-    const annotation = aggregateActionDeclarations(eventUpToThisAction);
+    const annotation = aggregateActionAnnotations(eventUpToThisAction.actions);
     const form = { ...declaration, ...annotation };
     const flagsWithMetConditions = actionConfig.flags.filter(
       ({ conditional }) => (
@@ -5605,6 +5667,33 @@ function resolveDateOfEvent(eventMetadata, declaration, config) {
   const parsedDate = ZodDate.safeParse(declaration[config.dateOfEvent.$$field]);
   return parsedDate.success ? parsedDate.data : void 0;
 }
+var DEFAULT_PLACE_OF_EVENT_PROPERTY = "createdAtLocation";
+function getParsedUUID(value, oldValue) {
+  const parsed = UUID.safeParse(value);
+  return parsed.success ? parsed.data : oldValue;
+}
+function resolvePlaceOfEvent(eventMetadata, declaration, config) {
+  let placeOfEvent = getParsedUUID(
+    eventMetadata[DEFAULT_PLACE_OF_EVENT_PROPERTY]
+  );
+  if (config.placeOfEvent) {
+    const addressFieldValue = AddressFieldValue.safeParse(
+      declaration[config.placeOfEvent.$$field]
+    );
+    if (addressFieldValue.success && addressFieldValue.data.addressType === AddressType.DOMESTIC && addressFieldValue.data.administrativeArea) {
+      placeOfEvent = getParsedUUID(
+        addressFieldValue.data.administrativeArea,
+        placeOfEvent
+      );
+    } else {
+      placeOfEvent = getParsedUUID(
+        declaration[config.placeOfEvent.$$field],
+        placeOfEvent
+      );
+    }
+  }
+  return placeOfEvent;
+}
 function extractPotentialDuplicatesFromActions(actions) {
   return actions.reduce((duplicates, action) => {
     if (action.type === ActionType.DUPLICATE_DETECTED) {
@@ -5649,6 +5738,11 @@ function getCurrentEventState(event2, config) {
     trackingId: event2.trackingId,
     updatedByUserRole: requestActionMetadata.createdByRole,
     dateOfEvent: resolveDateOfEvent(event2, declaration, config),
+    placeOfEvent: resolvePlaceOfEvent(
+      { createdAtLocation: creationAction.createdAtLocation },
+      declaration,
+      config
+    ),
     potentialDuplicates: extractPotentialDuplicatesFromActions(sortedActions),
     flags: getEventFlags(event2, config)
   });
@@ -5693,6 +5787,11 @@ function applyDeclarationToEventIndex(eventIndex, declaration, eventConfiguratio
       updatedDeclaration,
       eventConfiguration
     ),
+    placeOfEvent: resolvePlaceOfEvent(
+      eventIndex,
+      updatedDeclaration,
+      eventConfiguration
+    ),
     declaration: updatedDeclaration
   };
 }
@@ -8000,6 +8099,7 @@ function mapFieldTypeToMockValue(field3, i, rng) {
     case FieldType.OFFICE:
     case FieldType.LINK_BUTTON:
     case FieldType.LOADER:
+    case FieldType.HIDDEN:
       return `${field3.id}-${field3.type}-${i}`;
     case FieldType.VERIFICATION_STATUS:
       return "verified";