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

package/dist/events/index.js

@@ -75,6 +75,7 @@ __export(events_exports, {
   CheckboxFieldValue: () => CheckboxFieldValue,
   Clause: () => Clause,
   ClientSpecificAction: () => ClientSpecificAction,
+  ComputedDefaultValue: () => ComputedDefaultValue,
   Conditional: () => Conditional,
   ConditionalType: () => ConditionalType,
   ConfirmableActions: () => ConfirmableActions,
@@ -150,6 +151,7 @@ __export(events_exports, {
   FormPageConfig: () => FormPageConfig,
   Fuzzy: () => Fuzzy,
   GeographicalArea: () => GeographicalArea,
+  HiddenFieldTypes: () => HiddenFieldTypes,
   HiddenFieldValue: () => HiddenFieldValue,
   HttpFieldUpdateValue: () => HttpFieldUpdateValue,
   HttpFieldValue: () => HttpFieldValue,
@@ -200,6 +202,7 @@ __export(events_exports, {
   SelectDateRangeValue: () => SelectDateRangeValue,
   SelectOption: () => SelectOption,
   ShowConditional: () => ShowConditional,
+  SignatureFieldValue: () => SignatureFieldValue,
   StaticDataEntry: () => StaticDataEntry,
   StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
   SummaryConfig: () => SummaryConfig,
@@ -246,10 +249,12 @@ __export(events_exports, {
   applyDraftToEventIndex: () => applyDraftToEventIndex,
   areCertificateConditionsMet: () => areCertificateConditionsMet,
   areConditionsMet: () => areConditionsMet,
+  buildClientFunctionContext: () => buildClientFunctionContext,
   buildFormState: () => buildFormState,
   canAccessEventWithScope: () => canAccessEventWithScope,
   canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
   canAccessUserWithScope: () => canAccessUserWithScope,
+  compileClientFunction: () => compileClientFunction,
   compositeFieldTypes: () => compositeFieldTypes,
   createEmptyDraft: () => createEmptyDraft,
   createFieldConditionals: () => createFieldConditionals,
@@ -270,6 +275,7 @@ __export(events_exports, {
   defineWorkqueuesColumns: () => defineWorkqueuesColumns,
   deserializeQuery: () => deserializeQuery,
   errorMessages: () => errorMessages,
+  evaluate: () => evaluate,
   event: () => event,
   eventMetadataLabelMap: () => eventMetadataLabelMap,
   eventPayloadGenerator: () => eventPayloadGenerator,
@@ -348,6 +354,7 @@ __export(events_exports, {
   isBulletListFieldType: () => isBulletListFieldType,
   isButtonFieldType: () => isButtonFieldType,
   isCheckboxFieldType: () => isCheckboxFieldType,
+  isCodeToEvaluate: () => isCodeToEvaluate,
   isConditionMet: () => isConditionMet,
   isCountryFieldType: () => isCountryFieldType,
   isCustomFieldType: () => isCustomFieldType,
@@ -424,11 +431,13 @@ __export(events_exports, {
   resolveDateOfEvent: () => resolveDateOfEvent,
   resolveEventCustomFlags: () => resolveEventCustomFlags,
   resolvePlaceOfEvent: () => resolvePlaceOfEvent,
+  runClientFunction: () => runClientFunction,
   runFieldValidations: () => runFieldValidations,
   runStructuralValidations: () => runStructuralValidations,
   safeUnion: () => safeUnion,
   status: () => status,
   timePeriodToDateRange: () => timePeriodToDateRange,
+  todayISO: () => todayISO,
   user: () => user,
   userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
   validate: () => validate,
@@ -703,14 +712,20 @@ var unflattenScope = (input) => {
   return { type, options };
 };
 var EncodedScope = z2.string().brand("EncodedScope");
-var decodeScope = (query) => {
-  const scope = qs.parse(query, {
+var decodedScopeCache = /* @__PURE__ */ new Map();
+var decodeScope = (encodedScope) => {
+  if (decodedScopeCache.has(encodedScope)) {
+    return decodedScopeCache.get(encodedScope);
+  }
+  const scope = qs.parse(encodedScope, {
     ignoreQueryPrefix: true,
     comma: true,
     allowDots: true
   });
   const unflattenedScope = unflattenScope(scope);
-  return Scope.safeParse(unflattenedScope)?.data;
+  const result = Scope.safeParse(unflattenedScope)?.data;
+  decodedScopeCache.set(encodedScope, result);
+  return result;
 };
 var DEFAULT_SCOPE_OPTIONS = {
   placeOfEvent: JurisdictionFilter.enum.all,
@@ -1205,6 +1220,11 @@ var FieldTypesToHideInReview = [
   FieldType.ALPHA_PRINT_BUTTON,
   FieldType.ALPHA_HIDDEN
 ];
+var HiddenFieldTypes = [
+  FieldType.HTTP,
+  FieldType.QUERY_PARAM_READER,
+  FieldType.ALPHA_HIDDEN
+];
 
 // ../commons/src/events/FieldValue.ts
 var z12 = __toESM(require("zod/v4"));
@@ -1331,7 +1351,7 @@ function plainDateToLocalDate(date) {
 // ../commons/src/events/FieldValue.ts
 var TextValue = z12.string();
 var HiddenFieldValue = z12.string();
-var NonEmptyTextValue = TextValue.min(1);
+var NonEmptyTextValue = z12.string().trim().min(1);
 var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
 var AgeValue = z12.object({
   age: z12.number(),
@@ -1360,6 +1380,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",
@@ -2191,8 +2212,21 @@ var FieldReference = import_v43.default.object({
   $$field: FieldId.describe("Id of the field to reference"),
   $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
     'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
+  ),
+  $$code: import_v43.default.string().optional().describe(
+    "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
+  )
+}).describe(
+  "Reference to a field value, with an optional client-side computation applied."
+);
+function isCodeToEvaluate(v) {
+  return !!v && typeof v === "object" && "$$code" in v;
+}
+var ComputedDefaultValue = import_v43.default.object({
+  $$code: import_v43.default.string().describe(
+    "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
   )
-}).describe("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.describe(
     "Conditional expression that must hold for the field value to be considered valid."
@@ -2233,7 +2267,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."
@@ -2247,7 +2281,7 @@ var Divider = BaseField.extend({
 });
 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(),
@@ -2260,10 +2294,11 @@ var TextField = BaseField.extend({
 });
 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"),
+    integer: import_v43.default.boolean().optional().describe("When true, only whole numbers are allowed"),
     prefix: TranslationConfig.optional(),
     postfix: TranslationConfig.optional()
   }).optional()
@@ -2273,7 +2308,7 @@ var NumberField = BaseField.extend({
 });
 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"),
@@ -2307,7 +2342,7 @@ 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")
@@ -2323,14 +2358,14 @@ var EmailField = BaseField.extend({
   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"
@@ -2342,7 +2377,7 @@ var DateField = BaseField.extend({
 });
 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(),
@@ -2354,7 +2389,7 @@ var AgeField = BaseField.extend({
 });
 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(
@@ -2367,7 +2402,7 @@ var TimeField = BaseField.extend({
 });
 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"
@@ -2446,7 +2481,7 @@ var PageHeader = BaseField.extend({
 });
 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"),
@@ -2473,7 +2508,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"),
@@ -2488,7 +2523,7 @@ var NumberWithUnitField = BaseField.extend({
 });
 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({
@@ -2513,7 +2548,7 @@ var BulletList = BaseField.extend({
 });
 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(
     `
@@ -2535,7 +2570,7 @@ var SelectDateRangeOption = import_v43.default.object({
 });
 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")
 }).meta({
   description: "A date range selection field",
@@ -2552,7 +2587,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 },
@@ -2576,14 +2611,14 @@ var NameField = BaseField.extend({
   id: "NameField"
 });
 var PhoneField = BaseField.extend({
-  defaultValue: NonEmptyTextValue.optional(),
+  defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
   type: import_v43.default.literal(FieldType.PHONE)
 }).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)
 }).meta({
   description: "A field for entering an ID",
@@ -2591,14 +2626,14 @@ var IdField = BaseField.extend({
 });
 var Checkbox = BaseField.extend({
   type: import_v43.default.literal(FieldType.CHECKBOX),
-  defaultValue: CheckboxFieldValue.default(false)
+  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."
   )
@@ -2616,7 +2651,7 @@ var AdministrativeAreas = import_v43.default.enum([
 ]);
 var AdministrativeAreaField = BaseField.extend({
   type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
-  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
+  defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
   configuration: import_v43.default.object({
     partOf: FieldReference.optional().describe("Parent location"),
     type: AdministrativeAreas,
@@ -2628,7 +2663,7 @@ var AdministrativeAreaField = BaseField.extend({
 });
 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
@@ -2640,7 +2675,7 @@ var LocationInput = BaseField.extend({
 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({
@@ -2656,12 +2691,12 @@ var FileUploadWithOptions = BaseField.extend({
 });
 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({
@@ -2697,7 +2732,7 @@ var Address = BaseField.extend({
     ).optional(),
     allowedLocations: AllowedLocations
   }).optional(),
-  defaultValue: DefaultAddressFieldValue.optional()
+  defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
 }).meta({
   description: "Address input field \u2013 a combination of location and text fields",
   id: "Address"
@@ -2744,7 +2779,7 @@ 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
 }).meta({
   description: "A generic button that can be used to trigger an action",
@@ -2772,7 +2807,7 @@ var AlphaPrintButton = BaseField.extend({
 });
 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."
@@ -2858,7 +2893,7 @@ var LinkButtonField = BaseField.extend({
 });
 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(
@@ -2880,7 +2915,7 @@ var QueryParamReaderField = BaseField.extend({
 });
 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.",
@@ -2893,7 +2928,7 @@ var QrReaderField = BaseField.extend({
 });
 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")
   )
@@ -3187,6 +3222,14 @@ var ReadActionConfig = ActionConfigBase.extend(
     conditionals: z24.never().optional().describe("Read-action can not be disabled or hidden with conditionals.")
   }).shape
 );
+var NotifyConfig = DeclarationActionBase.extend(
+  z24.object({
+    type: z24.literal(ActionType.NOTIFY),
+    review: DeclarationReviewConfig.describe(
+      "Configuration of the review page fields."
+    ).optional()
+  }).shape
+);
 var DeclareConfig = DeclarationActionBase.extend(
   z24.object({
     type: z24.literal(ActionType.DECLARE),
@@ -3271,9 +3314,13 @@ var ActionConfig = z24.discriminatedUnion("type", [
     id: "ReadActionConfig",
     description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
   }),
+  NotifyConfig.meta({
+    id: "NotifyActionConfig",
+    description: "Configuration for the notify action. When present, NOTIFY uses this config independently from DECLARE. When absent, NOTIFY falls back to the DeclareActionConfig."
+  }),
   DeclareConfig.meta({
     id: "DeclareActionConfig",
-    description: "Configuration for the declare action. Includes review-page fields. Shared with the notify action (ActionType.NOTIFY)."
+    description: "Configuration for the declare action. Includes review-page fields. NOTIFY falls back to this config when no dedicated NotifyActionConfig is provided."
   }),
   RejectConfig.meta({
     id: "RejectActionConfig",
@@ -3452,6 +3499,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({
@@ -3526,9 +3576,11 @@ var z30 = __toESM(require("zod/v4"));
 var z29 = __toESM(require("zod/v4"));
 function getDynamicNameValue(field3) {
   const nameConfiguration = field3.configuration?.name;
+  const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
+  const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
   return z29.object({
-    firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
-    surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
+    firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
+    surname: surnameRequired ? NonEmptyTextValue : TextValue,
     middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
   });
 }
@@ -3875,7 +3927,7 @@ var isHiddenFieldType = (field3) => {
   return field3.config.type === FieldType.ALPHA_HIDDEN;
 };
 var isNonInteractiveFieldType = (field3) => {
-  return field3.type === FieldType.DIVIDER || field3.type === FieldType.PAGE_HEADER || field3.type === FieldType.PARAGRAPH || field3.type === FieldType.HEADING || 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;
+  return field3.type === FieldType.DIVIDER || field3.type === FieldType.PAGE_HEADER || field3.type === FieldType.PARAGRAPH || field3.type === FieldType.HEADING || field3.type === FieldType.BULLET_LIST || field3.type === FieldType.DATA || field3.type === FieldType.ALPHA_PRINT_BUTTON || field3.type === FieldType.LINK_BUTTON || field3.type === FieldType.LOADER;
 };
 
 // ../commons/src/conditionals/validate.ts
@@ -3911,7 +3963,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",
@@ -3956,7 +4038,7 @@ ajv.addKeyword({
   $data: true,
   errors: true,
   // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
-  validate(schema, data, _2, dataContext) {
+  validate(_schema, data, _2, dataContext) {
     const locationIdInput = data;
     const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
     return locations.some((location) => location.id === locationIdInput);
@@ -3987,6 +4069,23 @@ function isAgeValue(value) {
 function mergeWithBaseFormState(values, context) {
   return { ...context.baseFormState, ...values };
 }
+ajv.addKeyword({
+  keyword: "customClientValidator",
+  schemaType: "object",
+  errors: true,
+  // @ts-expect-error -- AJV's public types don't expose `rootData`. All
+  // `validate()` callers build root data via `buildClientFunctionContext`,
+  // so the cast holds.
+  validate(schema, data, _2, dataContext) {
+    return Boolean(
+      runClientFunction(
+        schema.code,
+        data,
+        dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
+      )
+    );
+  }
+});
 function validate(schema, data) {
   const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
   if ("$form" in data) {
@@ -4023,17 +4122,14 @@ function isOnline() {
   }
   return true;
 }
-function isConditionMet(conditional, values, context, eventIndex) {
-  return validate(conditional, {
-    $form: mergeWithBaseFormState(values, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    $online: isOnline(),
-    $user: context.user,
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $flags: eventIndex?.flags ?? [],
-    $status: eventIndex?.status,
-    $event: context.event
-  });
+function isConditionMet(conditional, values, context) {
+  return validate(
+    conditional,
+    buildClientFunctionContext({
+      form: mergeWithBaseFormState(values, context),
+      validatorContext: context
+    })
+  );
 }
 function getConditionalActionsForField(field3, values) {
   if (!field3.conditionals) {
@@ -4041,9 +4137,9 @@ function getConditionalActionsForField(field3, values) {
   }
   return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
 }
-function areConditionsMet(conditions, values, context, event2) {
+function areConditionsMet(conditions, values, context, _event) {
   return conditions.every(
-    (condition) => isConditionMet(condition.conditional, values, context, event2)
+    (condition) => isConditionMet(condition.conditional, values, context)
   );
 }
 function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -4053,14 +4149,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
   if (!hasRule) {
     return true;
   }
-  const validConditionals = getConditionalActionsForField(field3, {
-    $form: mergeWithBaseFormState(form, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    $online: isOnline(),
-    $user: context.user,
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $event: context.event
-  });
+  const validConditionals = getConditionalActionsForField(
+    field3,
+    buildClientFunctionContext({
+      form: mergeWithBaseFormState(form, context),
+      validatorContext: context
+    })
+  );
   return validConditionals.includes(conditionalType);
 }
 function isFieldVisible(field3, form, context) {
@@ -4086,7 +4181,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
   if (!rule) {
     return true;
   }
-  return isConditionMet(rule.conditional, event2.declaration, context, event2);
+  return validate(rule.conditional, {
+    ...buildClientFunctionContext({
+      form: mergeWithBaseFormState(event2.declaration, context),
+      validatorContext: context
+    }),
+    $flags: event2.flags,
+    $status: event2.status
+  });
 }
 function isActionEnabled(actionConfig, event2, context) {
   return isActionConditionMet(
@@ -4245,19 +4347,10 @@ function runFieldValidations({
   if (!isFieldVisible(field3.config, form, context)) {
     return [];
   }
-  const conditionalParameters = {
-    $form: mergeWithBaseFormState(form, context),
-    $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
-    /**
-     * In real use cases, there can be hundreds of thousands of locations.
-     * Make sure that the context contains only the locations that are needed for validation.
-     * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
-     * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
-     */
-    $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
-    $online: isOnline(),
-    $user: context.user
-  };
+  const conditionalParameters = buildClientFunctionContext({
+    form: mergeWithBaseFormState(form, context),
+    validatorContext: context
+  });
   if (isFieldGroupFieldType(field3)) {
     const subfieldErrors = buildFormState(
       field3.config.fields,
@@ -4396,13 +4489,13 @@ function getActionConfig({
   actionType,
   customActionType
 }) {
+  if (actionType === ActionType.NOTIFY) {
+    return eventConfiguration.actions.find((a) => a.type === ActionType.NOTIFY) ?? eventConfiguration.actions.find((a) => a.type === ActionType.DECLARE);
+  }
   return eventConfiguration.actions.find((a) => {
     if (a.type === ActionType.CUSTOM && customActionType) {
       return a.customActionType === customActionType;
     }
-    if (actionType === ActionType.NOTIFY) {
-      return a.type === ActionType.DECLARE;
-    }
     if (actionType === ActionType.APPROVE_CORRECTION || actionType === ActionType.REJECT_CORRECTION) {
       return a.type === ActionType.REQUEST_CORRECTION;
     }
@@ -4439,7 +4532,7 @@ var getActionAnnotationFields = (actionConfig) => {
   if (actionConfig.type === ActionType.CUSTOM) {
     return actionConfig.form;
   }
-  if ("review" in actionConfig) {
+  if ("review" in actionConfig && actionConfig.review != null) {
     return actionConfig.review.fields;
   }
   return [];
@@ -4741,19 +4834,16 @@ function getPendingAction(actions) {
   }
   return pendingActions[0];
 }
-function getCompleteActionAnnotation(annotation, event2, action) {
+function getCompleteActionAnnotation(event2, action) {
   if (action.originalActionId) {
     const originalAction = event2.actions.find(
       ({ id }) => id === action.originalActionId
     );
     if (originalAction?.status === ActionStatus.Requested) {
-      return deepMerge(
-        deepMerge(annotation, originalAction.annotation ?? {}),
-        action.annotation ?? {}
-      );
+      return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
     }
   }
-  return deepMerge(annotation, action.annotation ?? {});
+  return action.annotation ?? {};
 }
 function getCompleteActionContent(event2, action) {
   const currentContent = "content" in action ? action.content : void 0;
@@ -4789,7 +4879,7 @@ function getAcceptedActions(event2) {
   return event2.actions.filter(isAcceptedAction).map((action) => ({
     ...action,
     declaration: getCompleteActionDeclaration({}, event2, action),
-    annotation: getCompleteActionAnnotation({}, event2, action)
+    annotation: getCompleteActionAnnotation(event2, action)
   }));
 }
 var EXCLUDED_ACTIONS = [
@@ -5427,7 +5517,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
+      };
+    }
   };
 }
 
@@ -6367,6 +6504,8 @@ var updateActions = ActionTypes.extract([
   ActionType.ARCHIVE,
   ActionType.PRINT_CERTIFICATE,
   ActionType.REQUEST_CORRECTION,
+  ActionType.APPROVE_CORRECTION,
+  ActionType.REJECT_CORRECTION,
   ActionType.CUSTOM
 ]);
 function getActionUpdateMetadata(actions) {
@@ -6381,7 +6520,7 @@ function getActionUpdateMetadata(actions) {
     "createdAtLocation",
     "createdByRole"
   ];
-  return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
+  return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
     (_2, action) => {
       if (action.originalActionId) {
         const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6408,9 +6547,6 @@ function getLegalStatuses(actions) {
 // ../commons/src/events/state/flags.ts
 var import_lodash3 = require("lodash");
 var import_date_fns3 = require("date-fns");
-function isEditInProgress(actions) {
-  return actions.at(-1)?.type === ActionType.EDIT;
-}
 function findPendingCorrectionAction(writeActions2) {
   let correctionRequestAction;
   for (let i = writeActions2.length - 1; i >= 0; i--) {
@@ -6425,29 +6561,6 @@ function findPendingCorrectionAction(writeActions2) {
   }
   return correctionRequestAction;
 }
-function isCorrectionRequested(actions) {
-  return findPendingCorrectionAction(actions) !== void 0;
-}
-function isDeclarationIncomplete(actions) {
-  return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
-}
-function isRejected(actions) {
-  const resettingActionTypes = [
-    ActionType.NOTIFY,
-    ActionType.DECLARE,
-    ActionType.EDIT,
-    ActionType.REGISTER
-  ];
-  return actions.reduce((prev, { type }) => {
-    if (type === ActionType.REJECT) {
-      return true;
-    }
-    if (resettingActionTypes.includes(type)) {
-      return false;
-    }
-    return prev;
-  }, false);
-}
 function isPotentialDuplicate(actions) {
   return actions.reduce((prev, { type }) => {
     if (type === ActionType.DUPLICATE_DETECTED) {
@@ -6475,6 +6588,88 @@ function isFlagConditionMet(conditional, form, action) {
     }
   });
 }
+function actionConfigRemovesFlag(action, flagId, actionsUpToAndIncluding, event2, eventConfiguration) {
+  if (!isActionConfigType(action.type)) {
+    return false;
+  }
+  const actionConfig = getActionConfig({
+    eventConfiguration,
+    actionType: action.type,
+    customActionType: "customActionType" in action ? action.customActionType : void 0
+  });
+  const removeOperations = (actionConfig?.flags ?? []).filter(
+    ({ id, operation }) => id === flagId && operation === "remove"
+  );
+  if (removeOperations.length === 0) {
+    return false;
+  }
+  const eventUpToThisAction = { ...event2, actions: actionsUpToAndIncluding };
+  const declaration = aggregateActionDeclarations(eventUpToThisAction);
+  const annotation = aggregateActionAnnotations(eventUpToThisAction);
+  const form = { ...declaration, ...annotation };
+  return removeOperations.some(
+    ({ conditional }) => conditional ? isFlagConditionMet(conditional, form, action) : true
+  );
+}
+var INHERENT_FLAG_RULES = [
+  {
+    flag: InherentFlags.CORRECTION_REQUESTED,
+    setOn: [ActionType.REQUEST_CORRECTION],
+    resetOn: [ActionType.APPROVE_CORRECTION, ActionType.REJECT_CORRECTION]
+  },
+  {
+    // INCOMPLETE mirrors the NOTIFIED status: set by NOTIFY, cleared by any
+    // other status-changing action (see getStatusFromActions).
+    flag: InherentFlags.INCOMPLETE,
+    setOn: [ActionType.NOTIFY],
+    resetOn: [
+      ActionType.CREATE,
+      ActionType.DECLARE,
+      ActionType.REGISTER,
+      ActionType.ARCHIVE
+    ]
+  },
+  {
+    flag: InherentFlags.REJECTED,
+    setOn: [ActionType.REJECT],
+    resetOn: [
+      ActionType.NOTIFY,
+      ActionType.DECLARE,
+      ActionType.EDIT,
+      ActionType.REGISTER
+    ]
+  },
+  {
+    flag: InherentFlags.POTENTIAL_DUPLICATE,
+    setOn: [ActionType.DUPLICATE_DETECTED],
+    resetOn: [ActionType.MARK_AS_DUPLICATE, ActionType.MARK_AS_NOT_DUPLICATE]
+  },
+  {
+    flag: InherentFlags.EDIT_IN_PROGRESS,
+    setOn: [ActionType.EDIT],
+    resetOnAnyOtherAction: true
+  }
+];
+function resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration) {
+  return acceptedActions.reduce((present, action, idx) => {
+    if (rule.setOn.includes(action.type)) {
+      return true;
+    }
+    if (rule.resetOnAnyOtherAction || (rule.resetOn ?? []).includes(action.type)) {
+      return false;
+    }
+    if (actionConfigRemovesFlag(
+      action,
+      rule.flag,
+      acceptedActions.slice(0, idx + 1),
+      event2,
+      eventConfiguration
+    )) {
+      return false;
+    }
+    return present;
+  }, false);
+}
 function resolveEventCustomFlags(event2, eventConfiguration) {
   const actions = getAcceptedActions(event2).filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
   return actions.reduce((acc, action, idx) => {
@@ -6523,33 +6718,19 @@ function getActionStatusFlags(sortedActions) {
     return flag2;
   });
 }
-function getInherentFlags(sortedActions) {
+function getInherentFlags(sortedActions, event2, eventConfiguration) {
   const acceptedActions = sortedActions.filter(
     ({ status: status2 }) => status2 === ActionStatus.Accepted
   );
-  const inherentFlags = [];
-  if (isCorrectionRequested(acceptedActions)) {
-    inherentFlags.push(InherentFlags.CORRECTION_REQUESTED);
-  }
-  if (isDeclarationIncomplete(acceptedActions)) {
-    inherentFlags.push(InherentFlags.INCOMPLETE);
-  }
-  if (isRejected(acceptedActions)) {
-    inherentFlags.push(InherentFlags.REJECTED);
-  }
-  if (isPotentialDuplicate(acceptedActions)) {
-    inherentFlags.push(InherentFlags.POTENTIAL_DUPLICATE);
-  }
-  if (isEditInProgress(acceptedActions)) {
-    inherentFlags.push(InherentFlags.EDIT_IN_PROGRESS);
-  }
-  return inherentFlags;
+  return INHERENT_FLAG_RULES.filter(
+    (rule) => resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration)
+  ).map(({ flag: flag2 }) => flag2);
 }
 function getEventFlags(event2, config) {
   const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
   return [
     ...getActionStatusFlags(sortedActions),
-    ...getInherentFlags(sortedActions),
+    ...getInherentFlags(sortedActions, event2, config),
     ...resolveEventCustomFlags(event2, config)
   ];
 }
@@ -6786,7 +6967,7 @@ function getActionAnnotation({
   const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
   const actionWithCompleteAnnotation = action && {
     ...action,
-    annotation: getCompleteActionAnnotation({}, event2, action)
+    annotation: getCompleteActionAnnotation(event2, action)
   };
   const matchingDraft = draft?.action.type === actionType ? draft : void 0;
   const sortedActions = (0, import_lodash4.orderBy)(
@@ -6858,6 +7039,9 @@ function createFieldConfig(fieldId, options) {
 }
 
 // ../commons/src/events/field.ts
+function evaluate(computationFn) {
+  return { $$code: computationFn.toString() };
+}
 function field(fieldId, options = {}) {
   return {
     ...createFieldConditionals(fieldId),
@@ -7551,6 +7735,11 @@ var TENNIS_CLUB_DECLARATION_REVIEW = {
         id: "signature.upload.modal.title",
         defaultMessage: "Draw signature",
         description: "Title for the modal to draw signature"
+      },
+      // Zod applies the schema default at parse time, but this fixture bypasses
+      // parsing — GeneratedInputField accesses configuration.maxFileSize directly.
+      configuration: {
+        maxFileSize: 5 * 1024 * 1024
       }
     }
   ]
@@ -10107,7 +10296,7 @@ function matchesJurisdictionFilter(locationIds, filter, user2) {
     return locationIds.some((id) => id === user2.primaryOfficeId);
   }
   if (filter === JurisdictionFilter.enum.administrativeArea) {
-    return user2.administrativeAreaId === null || locationIds.some((id) => id === user2.administrativeAreaId);
+    return !user2.administrativeAreaId || locationIds.some((id) => id === user2.administrativeAreaId);
   }
   return true;
 }
@@ -10196,7 +10385,7 @@ function canAccessUserWithScope({
   }
   const hasAdministrativeAreaInHierarchy = userToAccess.administrativeHierarchy.some(
     (id) => user2.administrativeAreaId === id
-  ) || user2.administrativeAreaId === null;
+  ) || !user2.administrativeAreaId;
   if (opts?.accessLevel === JurisdictionFilter.enum.administrativeArea && !hasAdministrativeAreaInHierarchy) {
     return false;
   }
@@ -10502,18 +10691,19 @@ var ACTION_FILTERS = {
 function filterActionsByFlags(actions, flags) {
   return actions.filter((action) => ACTION_FILTERS[action]?.(flags) ?? true);
 }
+var REJECTED_ACTIONS = [
+  ActionType.READ,
+  ActionType.NOTIFY,
+  ActionType.CUSTOM,
+  ActionType.EDIT,
+  ActionType.ARCHIVE
+];
 function getAvailableActionsWithoutFlagFilters(status2, flags) {
   if (flags.includes(InherentFlags.EDIT_IN_PROGRESS)) {
     return [ActionType.NOTIFY, ActionType.DECLARE, ActionType.REGISTER];
   }
-  if (flags.includes(InherentFlags.REJECTED)) {
-    return [
-      ActionType.READ,
-      ActionType.NOTIFY,
-      ActionType.CUSTOM,
-      ActionType.EDIT,
-      ActionType.ARCHIVE
-    ];
+  if (flags.includes(InherentFlags.REJECTED) && status2 !== EventStatus.enum.ARCHIVED) {
+    return REJECTED_ACTIONS;
   }
   return AVAILABLE_ACTIONS_BY_EVENT_STATUS[status2];
 }