@opencrvs/toolkit 2.0.0-rc.0c28426 → 2.0.0-rc.0c52604

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/README.md +15 -0
  2. package/build.sh +3 -2
  3. package/create-countryconfig/index.js +50 -20
  4. package/create-countryconfig/package.json +12 -2
  5. package/dist/application-config/index.js +260 -95
  6. package/dist/cli.js +3254 -46
  7. package/dist/commons/api/router.d.ts +109 -21
  8. package/dist/commons/application-config/index.d.ts +1 -0
  9. package/dist/commons/conditionals/conditionals.d.ts +354 -4
  10. package/dist/commons/conditionals/validate.d.ts +51 -2
  11. package/dist/commons/events/ActionConfig.d.ts +28 -2
  12. package/dist/commons/events/ActionDocument.d.ts +6 -0
  13. package/dist/commons/events/ActionInput.d.ts +42 -36
  14. package/dist/commons/events/AdvancedSearchConfig.d.ts +342 -0
  15. package/dist/commons/events/CountryConfigQueryInput.d.ts +42 -0
  16. package/dist/commons/events/Draft.d.ts +2 -3
  17. package/dist/commons/events/EventDocument.d.ts +3 -0
  18. package/dist/commons/events/EventIndex.d.ts +14 -0
  19. package/dist/commons/events/FieldConfig.d.ts +378 -50
  20. package/dist/commons/events/FieldType.d.ts +1 -0
  21. package/dist/commons/events/FieldTypeMapping.d.ts +1 -1
  22. package/dist/commons/events/FieldValue.d.ts +6 -0
  23. package/dist/commons/events/WorkqueueConfig.d.ts +189 -150
  24. package/dist/commons/events/field.d.ts +53 -1
  25. package/dist/commons/events/index.d.ts +2 -0
  26. package/dist/commons/events/state/flags.d.ts +16 -0
  27. package/dist/commons/events/state/utils.d.ts +12 -287
  28. package/dist/commons/events/utils.d.ts +12 -1
  29. package/dist/conditionals/index.js +55 -2
  30. package/dist/environment/custom-types.d.ts +33 -0
  31. package/dist/environment/custom-types.d.ts.map +1 -0
  32. package/dist/environment/custom-types.js +12 -0
  33. package/dist/environment/derived-variables.d.ts +134 -0
  34. package/dist/environment/derived-variables.d.ts.map +1 -0
  35. package/dist/environment/derived-variables.js +169 -0
  36. package/dist/environment/editor-questions.d.ts +4 -0
  37. package/dist/environment/editor-questions.d.ts.map +1 -0
  38. package/dist/environment/editor-questions.js +67 -0
  39. package/dist/environment/git.d.ts +5 -0
  40. package/dist/environment/git.d.ts.map +1 -0
  41. package/dist/environment/git.js +38 -0
  42. package/dist/environment/github.d.ts +26 -0
  43. package/dist/environment/github.d.ts.map +1 -0
  44. package/dist/environment/github.js +247 -0
  45. package/dist/environment/index.d.ts +5 -0
  46. package/dist/environment/index.d.ts.map +1 -0
  47. package/dist/environment/index.js +71 -0
  48. package/dist/environment/logger.d.ts +15 -0
  49. package/dist/environment/logger.d.ts.map +1 -0
  50. package/dist/environment/logger.js +25 -0
  51. package/dist/environment/manage-users.d.ts +11 -0
  52. package/dist/environment/manage-users.d.ts.map +1 -0
  53. package/dist/environment/manage-users.js +497 -0
  54. package/dist/environment/questions-helper.d.ts +15 -0
  55. package/dist/environment/questions-helper.d.ts.map +1 -0
  56. package/dist/environment/questions-helper.js +70 -0
  57. package/dist/environment/questions.d.ts +199 -0
  58. package/dist/environment/questions.d.ts.map +1 -0
  59. package/dist/environment/questions.js +412 -0
  60. package/dist/environment/setup-environment.d.ts +2 -0
  61. package/dist/environment/setup-environment.d.ts.map +1 -0
  62. package/dist/environment/setup-environment.js +794 -0
  63. package/dist/environment/ssh-keygen.d.ts +5 -0
  64. package/dist/environment/ssh-keygen.d.ts.map +1 -0
  65. package/dist/environment/ssh-keygen.js +21 -0
  66. package/dist/environment/swarm-to-k8s.d.ts +2 -0
  67. package/dist/environment/swarm-to-k8s.d.ts.map +1 -0
  68. package/dist/environment/swarm-to-k8s.js +173 -0
  69. package/dist/environment/templates.d.ts +27 -0
  70. package/dist/environment/templates.d.ts.map +1 -0
  71. package/dist/environment/templates.js +162 -0
  72. package/dist/environment/update-workflows.d.ts +2 -0
  73. package/dist/environment/update-workflows.d.ts.map +1 -0
  74. package/dist/environment/update-workflows.js +169 -0
  75. package/dist/environment/users.d.ts +2 -0
  76. package/dist/environment/users.d.ts.map +1 -0
  77. package/dist/environment/users.js +112 -0
  78. package/dist/environment/utils.d.ts +18 -0
  79. package/dist/environment/utils.d.ts.map +1 -0
  80. package/dist/environment/utils.js +100 -0
  81. package/dist/events/index.js +1052 -234
  82. package/dist/migrations/v2.0/checkout-upstream-files.d.ts +1 -1
  83. package/dist/migrations/v2.0/checkout-upstream-files.d.ts.map +1 -1
  84. package/dist/migrations/v2.0/checkout-upstream-files.js +1 -1
  85. package/dist/migrations/v2.0/index.js +13 -5
  86. package/dist/notification/index.js +886 -132
  87. package/dist/scopes/index.d.ts +4 -6
  88. package/dist/scopes/index.js +12 -4
  89. package/dist/templates/charts-values/dependencies/values.override.yaml +4 -0
  90. package/dist/templates/charts-values/dependencies/values.yaml +83 -0
  91. package/dist/templates/charts-values/opencrvs-services/values.override.yaml +4 -0
  92. package/dist/templates/charts-values/opencrvs-services/values.yaml +80 -0
  93. package/dist/templates/charts-values/traefik/values.override.yaml +4 -0
  94. package/dist/templates/charts-values/traefik/values.yaml +115 -0
  95. package/dist/templates/inventory/inventory.template.yml +100 -0
  96. package/dist/templates/inventory/production.example.yml +77 -0
  97. package/dist/templates/inventory/qa.example.yml +48 -0
  98. package/opencrvs-toolkit-2.0.0-rc.0c52604.tgz +0 -0
  99. package/package.json +20 -2
  100. package/tsconfig.tsbuildinfo +1 -1
  101. package/opencrvs-toolkit-2.0.0-rc.0c28426.tgz +0 -0
@@ -75,6 +75,7 @@ __export(events_exports, {
75
75
  CheckboxFieldValue: () => CheckboxFieldValue,
76
76
  Clause: () => Clause,
77
77
  ClientSpecificAction: () => ClientSpecificAction,
78
+ ComputedDefaultValue: () => ComputedDefaultValue,
78
79
  Conditional: () => Conditional,
79
80
  ConditionalType: () => ConditionalType,
80
81
  ConfirmableActions: () => ConfirmableActions,
@@ -150,6 +151,7 @@ __export(events_exports, {
150
151
  FormPageConfig: () => FormPageConfig,
151
152
  Fuzzy: () => Fuzzy,
152
153
  GeographicalArea: () => GeographicalArea,
154
+ HiddenFieldTypes: () => HiddenFieldTypes,
153
155
  HiddenFieldValue: () => HiddenFieldValue,
154
156
  HttpFieldUpdateValue: () => HttpFieldUpdateValue,
155
157
  HttpFieldValue: () => HttpFieldValue,
@@ -200,6 +202,7 @@ __export(events_exports, {
200
202
  SelectDateRangeValue: () => SelectDateRangeValue,
201
203
  SelectOption: () => SelectOption,
202
204
  ShowConditional: () => ShowConditional,
205
+ SignatureFieldValue: () => SignatureFieldValue,
203
206
  StaticDataEntry: () => StaticDataEntry,
204
207
  StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
205
208
  SummaryConfig: () => SummaryConfig,
@@ -213,6 +216,10 @@ __export(events_exports, {
213
216
  UUID: () => UUID,
214
217
  UnassignActionInput: () => UnassignActionInput,
215
218
  UserAuditRecordInput: () => UserAuditRecordInput,
219
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS,
220
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP,
221
+ V2_DEFAULT_MOCK_LOCATIONS: () => V2_DEFAULT_MOCK_LOCATIONS,
222
+ V2_DEFAULT_MOCK_LOCATIONS_MAP: () => V2_DEFAULT_MOCK_LOCATIONS_MAP,
216
223
  ValidationConfig: () => ValidationConfig,
217
224
  VerificationActionConfig: () => VerificationActionConfig,
218
225
  VerificationPageConfig: () => VerificationPageConfig,
@@ -234,6 +241,7 @@ __export(events_exports, {
234
241
  ageToDate: () => ageToDate,
235
242
  aggregateActionAnnotations: () => aggregateActionAnnotations,
236
243
  aggregateActionDeclarations: () => aggregateActionDeclarations,
244
+ always: () => always,
237
245
  alwaysTrue: () => alwaysTrue,
238
246
  and: () => and,
239
247
  annotationActions: () => annotationActions,
@@ -241,10 +249,12 @@ __export(events_exports, {
241
249
  applyDraftToEventIndex: () => applyDraftToEventIndex,
242
250
  areCertificateConditionsMet: () => areCertificateConditionsMet,
243
251
  areConditionsMet: () => areConditionsMet,
252
+ buildClientFunctionContext: () => buildClientFunctionContext,
244
253
  buildFormState: () => buildFormState,
245
254
  canAccessEventWithScope: () => canAccessEventWithScope,
246
255
  canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
247
256
  canAccessUserWithScope: () => canAccessUserWithScope,
257
+ compileClientFunction: () => compileClientFunction,
248
258
  compositeFieldTypes: () => compositeFieldTypes,
249
259
  createEmptyDraft: () => createEmptyDraft,
250
260
  createFieldConditionals: () => createFieldConditionals,
@@ -265,6 +275,7 @@ __export(events_exports, {
265
275
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
266
276
  deserializeQuery: () => deserializeQuery,
267
277
  errorMessages: () => errorMessages,
278
+ evaluate: () => evaluate,
268
279
  event: () => event,
269
280
  eventMetadataLabelMap: () => eventMetadataLabelMap,
270
281
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -277,6 +288,7 @@ __export(events_exports, {
277
288
  findActiveDraftForEvent: () => findActiveDraftForEvent,
278
289
  findAllFields: () => findAllFields,
279
290
  findLastAssignmentAction: () => findLastAssignmentAction,
291
+ findPendingCorrectionAction: () => findPendingCorrectionAction,
280
292
  findRecordActionPages: () => findRecordActionPages,
281
293
  flag: () => flag,
282
294
  flattenFieldReference: () => flattenFieldReference,
@@ -310,6 +322,7 @@ __export(events_exports, {
310
322
  getAvailableActionsForEvent: () => getAvailableActionsForEvent,
311
323
  getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
312
324
  getCompleteActionAnnotation: () => getCompleteActionAnnotation,
325
+ getCompleteActionContent: () => getCompleteActionContent,
313
326
  getCompleteActionDeclaration: () => getCompleteActionDeclaration,
314
327
  getCurrentEventState: () => getCurrentEventState,
315
328
  getCustomActionFields: () => getCustomActionFields,
@@ -318,6 +331,7 @@ __export(events_exports, {
318
331
  getDeclarationFields: () => getDeclarationFields,
319
332
  getDeclarationPages: () => getDeclarationPages,
320
333
  getEventConfigById: () => getEventConfigById,
334
+ getEventFlags: () => getEventFlags,
321
335
  getFilePathsFromEvent: () => getFilePathsFromEvent,
322
336
  getLocationHierarchy: () => getLocationHierarchy,
323
337
  getMixedPath: () => getMixedPath,
@@ -340,6 +354,7 @@ __export(events_exports, {
340
354
  isBulletListFieldType: () => isBulletListFieldType,
341
355
  isButtonFieldType: () => isButtonFieldType,
342
356
  isCheckboxFieldType: () => isCheckboxFieldType,
357
+ isCodeToEvaluate: () => isCodeToEvaluate,
343
358
  isConditionMet: () => isConditionMet,
344
359
  isCountryFieldType: () => isCountryFieldType,
345
360
  isCustomFieldType: () => isCustomFieldType,
@@ -380,6 +395,7 @@ __export(events_exports, {
380
395
  isPageVisible: () => isPageVisible,
381
396
  isParagraphFieldType: () => isParagraphFieldType,
382
397
  isPhoneFieldType: () => isPhoneFieldType,
398
+ isPotentialDuplicate: () => isPotentialDuplicate,
383
399
  isPrintButtonFieldType: () => isPrintButtonFieldType,
384
400
  isQrReaderFieldType: () => isQrReaderFieldType,
385
401
  isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -413,12 +429,15 @@ __export(events_exports, {
413
429
  plainDateToLocalDate: () => plainDateToLocalDate,
414
430
  precompileActionSchemas: () => precompileActionSchemas,
415
431
  resolveDateOfEvent: () => resolveDateOfEvent,
432
+ resolveEventCustomFlags: () => resolveEventCustomFlags,
416
433
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
434
+ runClientFunction: () => runClientFunction,
417
435
  runFieldValidations: () => runFieldValidations,
418
436
  runStructuralValidations: () => runStructuralValidations,
419
437
  safeUnion: () => safeUnion,
420
438
  status: () => status,
421
439
  timePeriodToDateRange: () => timePeriodToDateRange,
440
+ todayISO: () => todayISO,
422
441
  user: () => user,
423
442
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
424
443
  validate: () => validate,
@@ -693,18 +712,26 @@ var unflattenScope = (input) => {
693
712
  return { type, options };
694
713
  };
695
714
  var EncodedScope = z2.string().brand("EncodedScope");
696
- var decodeScope = (query) => {
697
- const scope = qs.parse(query, {
715
+ var decodedScopeCache = /* @__PURE__ */ new Map();
716
+ var decodeScope = (encodedScope) => {
717
+ if (decodedScopeCache.has(encodedScope)) {
718
+ return decodedScopeCache.get(encodedScope);
719
+ }
720
+ const scope = qs.parse(encodedScope, {
698
721
  ignoreQueryPrefix: true,
699
722
  comma: true,
700
723
  allowDots: true
701
724
  });
702
725
  const unflattenedScope = unflattenScope(scope);
703
- return Scope.safeParse(unflattenedScope)?.data;
726
+ const result = Scope.safeParse(unflattenedScope)?.data;
727
+ decodedScopeCache.set(encodedScope, result);
728
+ return result;
704
729
  };
705
730
  var DEFAULT_SCOPE_OPTIONS = {
706
731
  placeOfEvent: JurisdictionFilter.enum.all,
707
- accessLevel: JurisdictionFilter.enum.all
732
+ accessLevel: JurisdictionFilter.enum.all,
733
+ registeredIn: JurisdictionFilter.enum.all,
734
+ declaredIn: JurisdictionFilter.enum.all
708
735
  };
709
736
  function getAcceptedScopesByType({
710
737
  acceptedScopes,
@@ -1077,7 +1104,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1077
1104
  ShowConditional,
1078
1105
  // Action can be shown to the user in the list but as disabled
1079
1106
  EnableConditional
1080
- ]);
1107
+ ]).meta({
1108
+ id: "ActionConditional",
1109
+ 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."
1110
+ });
1081
1111
  var DisplayOnReviewConditional = z7.object({
1082
1112
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1083
1113
  conditional: Conditional
@@ -1092,8 +1122,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1092
1122
  // Field output can be shown / hidden on the review page
1093
1123
  DisplayOnReviewConditional
1094
1124
  ]).meta({
1095
- description: "Field conditional configuration",
1096
- id: "FieldConditional"
1125
+ id: "FieldConditional",
1126
+ 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."
1097
1127
  });
1098
1128
 
1099
1129
  // ../commons/src/events/FieldType.ts
@@ -1190,6 +1220,11 @@ var FieldTypesToHideInReview = [
1190
1220
  FieldType.ALPHA_PRINT_BUTTON,
1191
1221
  FieldType.ALPHA_HIDDEN
1192
1222
  ];
1223
+ var HiddenFieldTypes = [
1224
+ FieldType.HTTP,
1225
+ FieldType.QUERY_PARAM_READER,
1226
+ FieldType.ALPHA_HIDDEN
1227
+ ];
1193
1228
 
1194
1229
  // ../commons/src/events/FieldValue.ts
1195
1230
  var z12 = __toESM(require("zod/v4"));
@@ -1316,7 +1351,7 @@ function plainDateToLocalDate(date) {
1316
1351
  // ../commons/src/events/FieldValue.ts
1317
1352
  var TextValue = z12.string();
1318
1353
  var HiddenFieldValue = z12.string();
1319
- var NonEmptyTextValue = TextValue.min(1);
1354
+ var NonEmptyTextValue = z12.string().trim().min(1);
1320
1355
  var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
1321
1356
  var AgeValue = z12.object({
1322
1357
  age: z12.number(),
@@ -1345,6 +1380,7 @@ var DateRangeFieldValue = z12.object({
1345
1380
  var EmailValue = z12.email();
1346
1381
  var CheckboxFieldValue = z12.boolean();
1347
1382
  var NumberFieldValue = z12.number();
1383
+ var SignatureFieldValue = FileFieldValue;
1348
1384
  var ButtonFieldValue = z12.number();
1349
1385
  var VerificationStatusValue = z12.enum([
1350
1386
  "verified",
@@ -1643,8 +1679,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1643
1679
  var ApprovedCorrectionAction = ActionBase.extend(
1644
1680
  z14.object({
1645
1681
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1646
- requestId: z14.string()
1682
+ requestId: z14.string(),
1647
1683
  // TODO move into 'content' property
1684
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1648
1685
  }).shape
1649
1686
  );
1650
1687
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1736,6 +1773,9 @@ var FlagConfig = z15.object({
1736
1773
  "Indicates if this flag expects an action to be performed to be cleared."
1737
1774
  ),
1738
1775
  label: TranslationConfig.describe("Human readable label of the flag.")
1776
+ }).meta({
1777
+ id: "FlagConfig",
1778
+ description: "Configuration for a custom flag that can be added to or removed from records by event actions."
1739
1779
  });
1740
1780
  var ActionFlagConfig = z15.object({
1741
1781
  id: Flag,
@@ -1743,6 +1783,9 @@ var ActionFlagConfig = z15.object({
1743
1783
  conditional: Conditional.optional().describe(
1744
1784
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1745
1785
  )
1786
+ }).meta({
1787
+ id: "ActionFlagConfig",
1788
+ description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
1746
1789
  });
1747
1790
 
1748
1791
  // ../commons/src/events/EventMetadata.ts
@@ -1980,7 +2023,8 @@ var Range = import_v4.z.object({
1980
2023
  });
1981
2024
  var ContainsFlags = import_v4.z.object({
1982
2025
  anyOf: import_v4.z.array(Flag).optional(),
1983
- noneOf: import_v4.z.array(Flag).optional()
2026
+ noneOf: import_v4.z.array(Flag).optional(),
2027
+ allOf: import_v4.z.array(Flag).optional()
1984
2028
  }).meta({
1985
2029
  id: "ContainsFlags"
1986
2030
  });
@@ -2166,14 +2210,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2166
2210
  }
2167
2211
  }).describe("Unique identifier for the field");
2168
2212
  var FieldReference = import_v43.default.object({
2169
- $$field: FieldId,
2213
+ $$field: FieldId.describe("Id of the field to reference"),
2170
2214
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2171
2215
  'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
2216
+ ),
2217
+ $$code: import_v43.default.string().optional().describe(
2218
+ "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
2172
2219
  )
2173
- }).describe("Reference to a field by its ID");
2220
+ }).describe(
2221
+ "Reference to a field value, with an optional client-side computation applied."
2222
+ );
2223
+ function isCodeToEvaluate(v) {
2224
+ return !!v && typeof v === "object" && "$$code" in v;
2225
+ }
2226
+ var ComputedDefaultValue = import_v43.default.object({
2227
+ $$code: import_v43.default.string().describe(
2228
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2229
+ )
2230
+ }).describe("A context-only computation used as a field default value.");
2174
2231
  var ValidationConfig = import_v43.default.object({
2175
- validator: Conditional,
2176
- message: TranslationConfig
2232
+ validator: Conditional.describe(
2233
+ "Conditional expression that must hold for the field value to be considered valid."
2234
+ ),
2235
+ message: TranslationConfig.describe(
2236
+ "Error message displayed when the validator does not hold."
2237
+ )
2238
+ }).meta({
2239
+ id: "ValidationConfig",
2240
+ 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."
2177
2241
  });
2178
2242
  var requiredSchema = import_v43.default.union([
2179
2243
  import_v43.default.boolean(),
@@ -2204,7 +2268,7 @@ var BaseField = import_v43.default.object({
2204
2268
  "Indicates whether the field can be modified during record correction."
2205
2269
  ),
2206
2270
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2207
- "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."
2271
+ "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."
2208
2272
  ),
2209
2273
  analytics: import_v43.default.boolean().default(false).optional().describe(
2210
2274
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2212,30 +2276,40 @@ var BaseField = import_v43.default.object({
2212
2276
  }).describe("Common properties shared across all field types.");
2213
2277
  var Divider = BaseField.extend({
2214
2278
  type: import_v43.default.literal(FieldType.DIVIDER)
2279
+ }).meta({
2280
+ description: "A horizontal line divider",
2281
+ id: "Divider"
2215
2282
  });
2216
2283
  var TextField = BaseField.extend({
2217
2284
  type: import_v43.default.literal(FieldType.TEXT),
2218
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2285
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2219
2286
  configuration: import_v43.default.object({
2220
2287
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2221
2288
  type: import_v43.default.enum(["text", "password"]).optional(),
2222
2289
  prefix: TranslationConfig.optional(),
2223
2290
  postfix: TranslationConfig.optional()
2224
2291
  }).default({ type: "text" }).optional()
2225
- }).describe("Text input");
2292
+ }).meta({
2293
+ description: "A text input field",
2294
+ id: "TextField"
2295
+ });
2226
2296
  var NumberField = BaseField.extend({
2227
2297
  type: import_v43.default.literal(FieldType.NUMBER),
2228
- defaultValue: NumberFieldValue.optional(),
2298
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2229
2299
  configuration: import_v43.default.object({
2230
2300
  min: import_v43.default.number().optional().describe("Minimum value"),
2231
2301
  max: import_v43.default.number().optional().describe("Maximum value"),
2302
+ integer: import_v43.default.boolean().optional().describe("When true, only whole numbers are allowed"),
2232
2303
  prefix: TranslationConfig.optional(),
2233
2304
  postfix: TranslationConfig.optional()
2234
2305
  }).optional()
2235
- }).describe("Number input");
2306
+ }).meta({
2307
+ description: "A number input field",
2308
+ id: "NumberField"
2309
+ });
2236
2310
  var TextAreaField = BaseField.extend({
2237
2311
  type: import_v43.default.literal(FieldType.TEXTAREA),
2238
- defaultValue: NonEmptyTextValue.optional(),
2312
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2239
2313
  configuration: import_v43.default.object({
2240
2314
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2241
2315
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2243,7 +2317,10 @@ var TextAreaField = BaseField.extend({
2243
2317
  prefix: TranslationConfig.optional(),
2244
2318
  postfix: TranslationConfig.optional()
2245
2319
  }).default({ rows: 4 }).optional()
2246
- }).describe("Multiline text input");
2320
+ }).meta({
2321
+ description: "A multiline text input",
2322
+ id: "TextAreaField"
2323
+ });
2247
2324
  var ImageMimeType = import_v43.default.enum([
2248
2325
  "image/png",
2249
2326
  "image/jpg",
@@ -2266,58 +2343,76 @@ var SignatureField = BaseField.extend({
2266
2343
  signaturePromptLabel: TranslationConfig.describe(
2267
2344
  "Title of the signature modal"
2268
2345
  ),
2269
- defaultValue: FieldValue.optional(),
2346
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2270
2347
  configuration: import_v43.default.object({
2271
2348
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2272
2349
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2273
2350
  }).default({
2274
2351
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2275
2352
  })
2276
- }).describe("Signature input field");
2353
+ }).meta({
2354
+ description: "A signature input field",
2355
+ id: "SignatureField"
2356
+ });
2277
2357
  var EmailField = BaseField.extend({
2278
2358
  type: import_v43.default.literal(FieldType.EMAIL),
2279
2359
  configuration: import_v43.default.object({
2280
2360
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2281
2361
  }).default({ maxLength: 255 }).optional(),
2282
- defaultValue: NonEmptyTextValue.optional()
2362
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2363
+ }).meta({
2364
+ description: "An email input field",
2365
+ id: "EmailField"
2283
2366
  });
2284
2367
  var DateField = BaseField.extend({
2285
2368
  type: import_v43.default.literal(FieldType.DATE),
2286
- defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
2369
+ defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
2287
2370
  configuration: import_v43.default.object({
2288
2371
  notice: TranslationConfig.describe(
2289
2372
  "Text to display above the date input"
2290
2373
  ).optional()
2291
2374
  }).optional()
2292
- }).describe("A single date input (yyyy-MM-dd)");
2375
+ }).meta({
2376
+ description: "A date input (yyyy-MM-dd)",
2377
+ id: "DateField"
2378
+ });
2293
2379
  var AgeField = BaseField.extend({
2294
2380
  type: import_v43.default.literal(FieldType.AGE),
2295
- defaultValue: NumberFieldValue.optional(),
2381
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2296
2382
  configuration: import_v43.default.object({
2297
2383
  asOfDate: FieldReference,
2298
2384
  prefix: TranslationConfig.optional(),
2299
2385
  postfix: TranslationConfig.optional()
2300
2386
  })
2301
- }).describe("An age input field which uses the current date as the asOfDate");
2387
+ }).meta({
2388
+ description: "An age input field which uses the current date as the asOfDate",
2389
+ id: "AgeField"
2390
+ });
2302
2391
  var TimeField = BaseField.extend({
2303
2392
  type: import_v43.default.literal(FieldType.TIME),
2304
- defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
2393
+ defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
2305
2394
  configuration: import_v43.default.object({
2306
2395
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2307
2396
  notice: TranslationConfig.describe(
2308
2397
  "Text to display above the time input"
2309
2398
  ).optional()
2310
2399
  }).optional()
2311
- }).describe("A single date input (HH-mm)");
2400
+ }).meta({
2401
+ description: "A single time input (HH-mm)",
2402
+ id: "TimeField"
2403
+ });
2312
2404
  var DateRangeField = BaseField.extend({
2313
2405
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2314
- defaultValue: DateRangeFieldValue.optional(),
2406
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2315
2407
  configuration: import_v43.default.object({
2316
2408
  notice: TranslationConfig.describe(
2317
2409
  "Text to display above the date input"
2318
2410
  ).optional()
2319
2411
  }).optional()
2320
- }).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
2412
+ }).meta({
2413
+ description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
2414
+ id: "DateRangeField"
2415
+ });
2321
2416
  var HtmlFontVariant = import_v43.default.enum([
2322
2417
  "reg12",
2323
2418
  "reg14",
@@ -2361,21 +2456,33 @@ var ImageViewField = BaseField.extend({
2361
2456
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2362
2457
  defaultValue: NonEmptyTextValue.optional(),
2363
2458
  configuration: ImageConfiguration
2364
- }).describe("A read-only image component for form pages");
2459
+ }).meta({
2460
+ description: "A read-only image component for form pages",
2461
+ id: "ImageViewField"
2462
+ });
2365
2463
  var Paragraph = BaseField.extend({
2366
2464
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2367
2465
  configuration: ParagraphConfiguration
2368
- }).describe("A read-only HTML <p> paragraph");
2466
+ }).meta({
2467
+ description: "A read-only HTML <p> paragraph",
2468
+ id: "Paragraph"
2469
+ });
2369
2470
  var Heading = BaseField.extend({
2370
2471
  type: import_v43.default.literal(FieldType.HEADING),
2371
2472
  configuration: HeadingConfiguration
2372
- }).describe("A read-only heading component for form pages");
2473
+ }).meta({
2474
+ description: "A read-only heading component for form pages",
2475
+ id: "Heading"
2476
+ });
2373
2477
  var PageHeader = BaseField.extend({
2374
2478
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2375
- }).describe("A read-only header component for form pages");
2479
+ }).meta({
2480
+ description: "A read-only header component for form pages",
2481
+ id: "PageHeader"
2482
+ });
2376
2483
  var File = BaseField.extend({
2377
2484
  type: import_v43.default.literal(FieldType.FILE),
2378
- defaultValue: FileFieldValue.optional(),
2485
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2379
2486
  configuration: import_v43.default.object({
2380
2487
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2381
2488
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2391,7 +2498,10 @@ var File = BaseField.extend({
2391
2498
  }).default({
2392
2499
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2393
2500
  })
2394
- }).describe("File upload");
2501
+ }).meta({
2502
+ description: "A file upload field",
2503
+ id: "File"
2504
+ });
2395
2505
  var SelectOption = import_v43.default.object({
2396
2506
  value: import_v43.default.string().describe("The value of the option"),
2397
2507
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2399,7 +2509,7 @@ var SelectOption = import_v43.default.object({
2399
2509
  });
2400
2510
  var NumberWithUnitField = BaseField.extend({
2401
2511
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2402
- defaultValue: NumberWithUnitFieldValue.optional(),
2512
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2403
2513
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2404
2514
  configuration: import_v43.default.object({
2405
2515
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2408,17 +2518,23 @@ var NumberWithUnitField = BaseField.extend({
2408
2518
  "Placeholder for the number field"
2409
2519
  )
2410
2520
  }).optional()
2411
- }).describe("Number with unit input");
2521
+ }).meta({
2522
+ description: "A number with unit input field",
2523
+ id: "NumberWithUnitField"
2524
+ });
2412
2525
  var RadioGroup = BaseField.extend({
2413
2526
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2414
- defaultValue: TextValue.optional(),
2527
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2415
2528
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2416
2529
  configuration: import_v43.default.object({
2417
2530
  styles: import_v43.default.object({
2418
2531
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2419
2532
  }).optional()
2420
2533
  }).optional()
2421
- }).describe("Grouped radio options");
2534
+ }).meta({
2535
+ description: "A grouped radio button field",
2536
+ id: "RadioGroup"
2537
+ });
2422
2538
  var BulletList = BaseField.extend({
2423
2539
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2424
2540
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2427,10 +2543,13 @@ var BulletList = BaseField.extend({
2427
2543
  fontVariant: HtmlFontVariant.optional()
2428
2544
  }).optional()
2429
2545
  }).default({})
2430
- }).describe("A list of bullet points");
2546
+ }).meta({
2547
+ description: "A list of bullet points",
2548
+ id: "BulletList"
2549
+ });
2431
2550
  var Select = BaseField.extend({
2432
2551
  type: import_v43.default.literal(FieldType.SELECT),
2433
- defaultValue: TextValue.optional(),
2552
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2434
2553
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2435
2554
  noOptionsMessage: TranslationConfig.optional().describe(
2436
2555
  `
@@ -2442,16 +2561,22 @@ var Select = BaseField.extend({
2442
2561
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2443
2562
  `
2444
2563
  )
2445
- }).describe("Select input");
2564
+ }).meta({
2565
+ description: "A select input field",
2566
+ id: "Select"
2567
+ });
2446
2568
  var SelectDateRangeOption = import_v43.default.object({
2447
2569
  value: SelectDateRangeValue.describe("The value of the option"),
2448
2570
  label: TranslationConfig.describe("The label of the option")
2449
2571
  });
2450
2572
  var SelectDateRangeField = BaseField.extend({
2451
2573
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2452
- defaultValue: SelectDateRangeValue.optional(),
2574
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2453
2575
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2454
- }).describe("Select input with date range options");
2576
+ }).meta({
2577
+ description: "A date range selection field",
2578
+ id: "SelectDateRangeField"
2579
+ });
2455
2580
  var NameConfig = import_v43.default.object({
2456
2581
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2457
2582
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2463,7 +2588,7 @@ var NameField = BaseField.extend({
2463
2588
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2464
2589
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2465
2590
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2466
- }).optional(),
2591
+ }).or(ComputedDefaultValue).optional(),
2467
2592
  configuration: import_v43.default.object({
2468
2593
  name: NameConfig.default({
2469
2594
  firstname: { required: true },
@@ -2482,26 +2607,41 @@ var NameField = BaseField.extend({
2482
2607
  surname: { required: true }
2483
2608
  }
2484
2609
  }).optional()
2485
- }).describe("Name input field");
2610
+ }).meta({
2611
+ description: "A field for entering a persons name",
2612
+ id: "NameField"
2613
+ });
2486
2614
  var PhoneField = BaseField.extend({
2487
- defaultValue: NonEmptyTextValue.optional(),
2615
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2488
2616
  type: import_v43.default.literal(FieldType.PHONE)
2489
- }).describe("Phone input field");
2617
+ }).meta({
2618
+ description: "A field for entering a phone number",
2619
+ id: "PhoneField"
2620
+ });
2490
2621
  var IdField = BaseField.extend({
2491
- defaultValue: NonEmptyTextValue.optional(),
2622
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2492
2623
  type: import_v43.default.literal(FieldType.ID)
2493
- }).describe("ID input field");
2624
+ }).meta({
2625
+ description: "A field for entering an ID",
2626
+ id: "IdField"
2627
+ });
2494
2628
  var Checkbox = BaseField.extend({
2495
2629
  type: import_v43.default.literal(FieldType.CHECKBOX),
2496
- defaultValue: CheckboxFieldValue.default(false)
2497
- }).describe("Boolean checkbox field");
2630
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2631
+ }).meta({
2632
+ description: "A boolean checkbox field",
2633
+ id: "Checkbox"
2634
+ });
2498
2635
  var Country = BaseField.extend({
2499
2636
  type: import_v43.default.literal(FieldType.COUNTRY),
2500
- defaultValue: NonEmptyTextValue.optional(),
2637
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2501
2638
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2502
2639
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2503
2640
  )
2504
- }).describe("Country select field");
2641
+ }).meta({
2642
+ description: "A field for selecting a country",
2643
+ id: "Country"
2644
+ });
2505
2645
  var AllowedLocations = JurisdictionReference.optional().describe(
2506
2646
  "Limits which location options are selectable depending on user jurisdiction and location."
2507
2647
  );
@@ -2510,28 +2650,33 @@ var AdministrativeAreas = import_v43.default.enum([
2510
2650
  "HEALTH_FACILITY",
2511
2651
  "CRVS_OFFICE"
2512
2652
  ]);
2513
- var AdministrativeAreaConfiguration = import_v43.default.object({
2514
- partOf: FieldReference.optional().describe("Parent location"),
2515
- type: AdministrativeAreas,
2516
- allowedLocations: AllowedLocations
2517
- }).describe("Administrative area options");
2518
2653
  var AdministrativeAreaField = BaseField.extend({
2519
2654
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2520
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2521
- configuration: AdministrativeAreaConfiguration
2522
- }).describe("Administrative area input field e.g. facility, office");
2655
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2656
+ configuration: import_v43.default.object({
2657
+ partOf: FieldReference.optional().describe("Parent location"),
2658
+ type: AdministrativeAreas,
2659
+ allowedLocations: AllowedLocations
2660
+ }).describe("Administrative area options")
2661
+ }).meta({
2662
+ description: "Administrative area input field",
2663
+ id: "AdministrativeAreaField"
2664
+ });
2523
2665
  var LocationInput = BaseField.extend({
2524
2666
  type: import_v43.default.literal(FieldType.LOCATION),
2525
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2667
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2526
2668
  configuration: import_v43.default.object({
2527
2669
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2528
2670
  allowedLocations: AllowedLocations
2529
2671
  }).optional()
2530
- }).describe("Input field for a location");
2672
+ }).meta({
2673
+ description: "A field for selecting a location",
2674
+ id: "LocationInput"
2675
+ });
2531
2676
  var FileUploadWithOptions = BaseField.extend({
2532
2677
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2533
2678
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2534
- defaultValue: FileFieldWithOptionValue.optional(),
2679
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2535
2680
  configuration: import_v43.default.object({
2536
2681
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2537
2682
  maxImageSize: import_v43.default.object({
@@ -2541,15 +2686,18 @@ var FileUploadWithOptions = BaseField.extend({
2541
2686
  }).default({
2542
2687
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2543
2688
  })
2689
+ }).meta({
2690
+ description: "A field for uploading files with file type options",
2691
+ id: "FileUploadWithOptions"
2544
2692
  });
2545
2693
  var Facility = BaseField.extend({
2546
2694
  type: import_v43.default.literal(FieldType.FACILITY),
2547
- defaultValue: NonEmptyTextValue.optional(),
2695
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2548
2696
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2549
2697
  }).describe("Input field for a facility");
2550
2698
  var Office = BaseField.extend({
2551
2699
  type: import_v43.default.literal(FieldType.OFFICE),
2552
- defaultValue: NonEmptyTextValue.optional(),
2700
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2553
2701
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2554
2702
  }).describe("Input field for an office");
2555
2703
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2585,8 +2733,11 @@ var Address = BaseField.extend({
2585
2733
  ).optional(),
2586
2734
  allowedLocations: AllowedLocations
2587
2735
  }).optional(),
2588
- defaultValue: DefaultAddressFieldValue.optional()
2589
- }).describe("Address input field \u2013 a combination of location and text fields");
2736
+ defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
2737
+ }).meta({
2738
+ description: "Address input field \u2013 a combination of location and text fields",
2739
+ id: "Address"
2740
+ });
2590
2741
  var StaticDataEntry = import_v43.default.object({
2591
2742
  id: import_v43.default.string().describe("ID for the data entry."),
2592
2743
  label: TranslationConfig,
@@ -2601,7 +2752,10 @@ var DataField = BaseField.extend({
2601
2752
  subtitle: TranslationConfig.optional(),
2602
2753
  data: import_v43.default.array(DataEntry)
2603
2754
  })
2604
- }).describe("Data field for displaying read-only data");
2755
+ }).meta({
2756
+ description: "A field for displaying a table of read-only data",
2757
+ id: "DataField"
2758
+ });
2605
2759
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2606
2760
  var ButtonType = import_v43.default.enum([
2607
2761
  "primary",
@@ -2626,13 +2780,19 @@ var ButtonConfiguration = import_v43.default.object({
2626
2780
  });
2627
2781
  var ButtonField = BaseField.extend({
2628
2782
  type: import_v43.default.literal(FieldType.BUTTON),
2629
- defaultValue: ButtonFieldValue.optional(),
2783
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2630
2784
  configuration: ButtonConfiguration
2631
- }).describe("Generic button without any built-in functionality");
2785
+ }).meta({
2786
+ description: "A generic button that can be used to trigger an action",
2787
+ id: "ButtonField"
2788
+ });
2632
2789
  var FieldGroup = BaseField.extend({
2633
2790
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2634
2791
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2635
2792
  fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
2793
+ }).meta({
2794
+ description: "A group of fields that are displayed together",
2795
+ id: "FieldGroup"
2636
2796
  });
2637
2797
  var AlphaPrintButton = BaseField.extend({
2638
2798
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2642,10 +2802,13 @@ var AlphaPrintButton = BaseField.extend({
2642
2802
  "Label for the print button"
2643
2803
  )
2644
2804
  })
2645
- }).describe("Print button field for printing certificates");
2805
+ }).meta({
2806
+ description: "An experimental print button field for printing certificates during the declaration process",
2807
+ id: "AlphaPrintButton"
2808
+ });
2646
2809
  var HttpField = BaseField.extend({
2647
2810
  type: import_v43.default.literal(FieldType.HTTP),
2648
- defaultValue: HttpFieldValue.optional(),
2811
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2649
2812
  configuration: import_v43.default.object({
2650
2813
  trigger: FieldReference.optional().describe(
2651
2814
  "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."
@@ -2658,20 +2821,30 @@ var HttpField = BaseField.extend({
2658
2821
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2659
2822
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2660
2823
  })
2661
- }).describe("HTTP request function triggered by a button click or other event");
2824
+ }).meta({
2825
+ 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.",
2826
+ id: "HttpField"
2827
+ });
2662
2828
  var AutocompleteField = BaseField.extend({
2663
2829
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2664
2830
  configuration: import_v43.default.object({
2665
- url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
2831
+ url: import_v43.default.string().describe(
2832
+ "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
2833
+ ).optional(),
2666
2834
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2667
2835
  defaultOptions: import_v43.default.array(
2668
2836
  import_v43.default.object({
2669
2837
  label: import_v43.default.string(),
2670
2838
  value: import_v43.default.string()
2671
2839
  })
2672
- ).optional()
2840
+ ).optional().describe(
2841
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2842
+ )
2673
2843
  })
2674
- }).describe("Autocomplete input field");
2844
+ }).meta({
2845
+ 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.",
2846
+ id: "AutocompleteField"
2847
+ });
2675
2848
  var SearchField = HttpField.extend({
2676
2849
  type: import_v43.default.literal(FieldType.SEARCH),
2677
2850
  configuration: SearchQuery.pick({
@@ -2704,6 +2877,9 @@ var SearchField = HttpField.extend({
2704
2877
  ok: TranslationConfig.optional()
2705
2878
  }).optional()
2706
2879
  })
2880
+ }).meta({
2881
+ description: "A search input field",
2882
+ id: "SearchField"
2707
2883
  });
2708
2884
  var LinkButtonField = BaseField.extend({
2709
2885
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2712,28 +2888,35 @@ var LinkButtonField = BaseField.extend({
2712
2888
  text: TranslationConfig.describe("Text to display on the button"),
2713
2889
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2714
2890
  })
2715
- }).describe("Button that opens a link");
2891
+ }).meta({
2892
+ description: "A button that opens a URL link",
2893
+ id: "LinkButtonField"
2894
+ });
2716
2895
  var VerificationStatus = BaseField.extend({
2717
2896
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2718
- defaultValue: VerificationStatusValue.optional(),
2897
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2719
2898
  configuration: import_v43.default.object({
2720
2899
  status: TranslationConfig.describe("Text to display on the status pill."),
2721
2900
  description: TranslationConfig.describe(
2722
2901
  "Explaining text on the banner in form."
2723
2902
  )
2724
2903
  })
2904
+ }).meta({
2905
+ 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.",
2906
+ id: "VerificationStatus"
2725
2907
  });
2726
2908
  var QueryParamReaderField = BaseField.extend({
2727
2909
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2728
2910
  configuration: import_v43.default.object({
2729
2911
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2730
2912
  })
2731
- }).describe(
2732
- "A field that maps URL query params into form values and clears them afterward"
2733
- );
2913
+ }).meta({
2914
+ description: "A field that maps URL query params into form values and clears them afterward",
2915
+ id: "QueryParamReaderField"
2916
+ });
2734
2917
  var QrReaderField = BaseField.extend({
2735
2918
  type: import_v43.default.literal(FieldType.QR_READER),
2736
- defaultValue: QrReaderFieldValue.optional(),
2919
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2737
2920
  configuration: import_v43.default.object({
2738
2921
  validator: import_v43.default.any().meta({
2739
2922
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2741,21 +2924,27 @@ var QrReaderField = BaseField.extend({
2741
2924
  })
2742
2925
  }).optional()
2743
2926
  }).meta({
2744
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2927
+ description: "QR code reader field, including optional JSON Schema validator.",
2745
2928
  id: "QrReaderField"
2746
2929
  });
2747
2930
  var IdReaderField = BaseField.extend({
2748
2931
  type: import_v43.default.literal(FieldType.ID_READER),
2749
- defaultValue: IdReaderFieldValue.optional(),
2932
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2750
2933
  methods: import_v43.default.array(
2751
2934
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2752
2935
  )
2936
+ }).meta({
2937
+ description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
2938
+ id: "IdReaderField"
2753
2939
  });
2754
2940
  var CustomField = BaseField.extend({
2755
2941
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2756
2942
  defaultValue: CustomFieldValue.optional(),
2757
2943
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2758
2944
  configuration: import_v43.default.unknown().optional()
2945
+ }).meta({
2946
+ description: "An expiremental custom field that is defined by a module source path",
2947
+ id: "CustomField"
2759
2948
  });
2760
2949
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2761
2950
  var LoaderField = BaseField.extend({
@@ -2765,22 +2954,25 @@ var LoaderField = BaseField.extend({
2765
2954
  configuration: import_v43.default.object({
2766
2955
  text: TranslationConfig.describe("Display text above the loading spinner")
2767
2956
  })
2768
- }).describe(
2769
- "A non-interactive field that indicates an in progress operation in form"
2770
- );
2957
+ }).meta({
2958
+ description: "A non-interactive field that indicates an in progress operation in form",
2959
+ id: "LoaderField"
2960
+ });
2771
2961
  var HiddenField = BaseField.extend({
2772
2962
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2773
2963
  required: import_v43.default.boolean().default(false).optional(),
2774
2964
  defaultValue: TextValue.optional()
2775
- }).describe(
2776
- "A non-interactive, hidden field that only hold a value in the form"
2777
- );
2965
+ }).meta({
2966
+ description: "A non-interactive, hidden field that only hold a value in the form",
2967
+ id: "HiddenField"
2968
+ });
2778
2969
  var UserRoleField = BaseField.extend({
2779
2970
  type: import_v43.default.literal(FieldType.USER_ROLE),
2780
2971
  defaultValue: TextValue.optional()
2781
- }).describe(
2782
- "A select dropdown that is automatically populated with available user roles"
2783
- );
2972
+ }).meta({
2973
+ description: "A select dropdown that is automatically populated with available user roles",
2974
+ id: "UserRoleField"
2975
+ });
2784
2976
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2785
2977
  FieldGroup,
2786
2978
  Address,
@@ -2879,16 +3071,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2879
3071
  type: z21.literal(PageTypes.enum.VERIFICATION),
2880
3072
  actions: VerificationActionConfig
2881
3073
  });
2882
- var PageConfig = z21.discriminatedUnion("type", [
2883
- FormPageConfig,
2884
- VerificationPageConfig
2885
- ]);
3074
+ var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
3075
+ id: "PageConfig",
3076
+ 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."
3077
+ });
2886
3078
 
2887
3079
  // ../commons/src/events/FormConfig.ts
2888
3080
  var DeclarationFormConfig = z22.object({
2889
3081
  label: TranslationConfig.describe("Human readable description of the form"),
2890
3082
  pages: z22.array(FormPageConfig)
2891
- }).describe("Configuration of the declaration form.");
3083
+ }).meta({
3084
+ id: "DeclarationFormConfig",
3085
+ description: "Configuration of the declaration form."
3086
+ });
2892
3087
  var ActionFormConfig = z22.object({
2893
3088
  label: TranslationConfig.describe("Human readable description of the form"),
2894
3089
  pages: z22.array(PageConfig)
@@ -2988,6 +3183,9 @@ var DeduplicationConfig = z23.object({
2988
3183
  id: z23.string(),
2989
3184
  label: TranslationConfig,
2990
3185
  query: Clause
3186
+ }).meta({
3187
+ id: "DeduplicationConfig",
3188
+ 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."
2991
3189
  });
2992
3190
 
2993
3191
  // ../commons/src/events/ActionConfig.ts
@@ -3025,6 +3223,11 @@ var ReadActionConfig = ActionConfigBase.extend(
3025
3223
  conditionals: z24.never().optional().describe("Read-action can not be disabled or hidden with conditionals.")
3026
3224
  }).shape
3027
3225
  );
3226
+ var NotifyConfig = ActionConfigBase.extend(
3227
+ z24.object({
3228
+ type: z24.literal(ActionType.NOTIFY)
3229
+ }).shape
3230
+ );
3028
3231
  var DeclareConfig = DeclarationActionBase.extend(
3029
3232
  z24.object({
3030
3233
  type: z24.literal(ActionType.DECLARE),
@@ -3105,17 +3308,46 @@ var ActionConfig = z24.discriminatedUnion("type", [
3105
3308
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3106
3309
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3107
3310
  */
3108
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3109
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3110
- RejectConfig.meta({ id: "RejectActionConfig" }),
3111
- RegisterConfig.meta({ id: "RegisterActionConfig" }),
3311
+ ReadActionConfig.meta({
3312
+ id: "ReadActionConfig",
3313
+ description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
3314
+ }),
3315
+ NotifyConfig.meta({
3316
+ id: "NotifyActionConfig",
3317
+ description: "Configuration for the notify action. When present, NOTIFY uses this config independently from DECLARE. When absent, NOTIFY falls back to the DeclareActionConfig."
3318
+ }),
3319
+ DeclareConfig.meta({
3320
+ id: "DeclareActionConfig",
3321
+ description: "Configuration for the declare action. Includes review-page fields. NOTIFY falls back to this config when no dedicated NotifyActionConfig is provided."
3322
+ }),
3323
+ RejectConfig.meta({
3324
+ id: "RejectActionConfig",
3325
+ description: "Configuration for rejecting a record before registration."
3326
+ }),
3327
+ RegisterConfig.meta({
3328
+ id: "RegisterActionConfig",
3329
+ description: "Configuration for registering a record."
3330
+ }),
3112
3331
  PrintCertificateActionConfig.meta({
3113
- id: "PrintCertificateActionConfig"
3332
+ id: "PrintCertificateActionConfig",
3333
+ description: "Configuration for printing a certificate of a registered record."
3334
+ }),
3335
+ RequestCorrectionConfig.meta({
3336
+ id: "RequestCorrectionActionConfig",
3337
+ description: "Configuration for requesting a correction on a registered record."
3338
+ }),
3339
+ EditActionConfig.meta({
3340
+ id: "EditActionConfig",
3341
+ description: "Configuration for editing a record before registration."
3342
+ }),
3343
+ ArchiveConfig.meta({
3344
+ id: "ArchiveActionConfig",
3345
+ description: "Configuration for archiving a record."
3114
3346
  }),
3115
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3116
- EditActionConfig.meta({ id: "EditActionConfig" }),
3117
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3118
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3347
+ CustomActionConfig.meta({
3348
+ id: "CustomActionConfig",
3349
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3350
+ })
3119
3351
  ]).describe(
3120
3352
  "Configuration of an action available for an event. Data collected depends on the action type and is accessible through the annotation property in ActionDocument."
3121
3353
  ).meta({ id: "ActionConfig" });
@@ -3191,7 +3423,10 @@ var Field = BaseField2.extend({
3191
3423
  }).describe("Custom field defined for the summary view.");
3192
3424
  var SummaryConfig = z27.object({
3193
3425
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3194
- }).describe("Configuration of the event summary section.");
3426
+ }).meta({
3427
+ id: "SummaryConfig",
3428
+ 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."
3429
+ });
3195
3430
 
3196
3431
  // ../commons/src/events/AdvancedSearchConfig.ts
3197
3432
  var z28 = __toESM(require("zod/v4"));
@@ -3262,6 +3497,9 @@ var BaseField3 = z28.object({
3262
3497
  ),
3263
3498
  validations: z28.array(ValidationConfig).optional().describe(
3264
3499
  `Option for overriding the field validations specifically for advanced search form.`
3500
+ ),
3501
+ allowedLocations: JurisdictionReference.optional().describe(
3502
+ `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.`
3265
3503
  )
3266
3504
  });
3267
3505
  var SearchQueryParams = z28.object({
@@ -3315,6 +3553,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3315
3553
  var AdvancedSearchConfig = z28.object({
3316
3554
  title: TranslationConfig.describe("Advanced search tab title"),
3317
3555
  fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
3556
+ }).meta({
3557
+ id: "AdvancedSearchConfig",
3558
+ 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()`)."
3318
3559
  });
3319
3560
 
3320
3561
  // ../commons/src/events/utils.ts
@@ -3333,9 +3574,11 @@ var z30 = __toESM(require("zod/v4"));
3333
3574
  var z29 = __toESM(require("zod/v4"));
3334
3575
  function getDynamicNameValue(field3) {
3335
3576
  const nameConfiguration = field3.configuration?.name;
3577
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3578
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3336
3579
  return z29.object({
3337
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3338
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3580
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3581
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3339
3582
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3340
3583
  });
3341
3584
  }
@@ -3682,7 +3925,7 @@ var isHiddenFieldType = (field3) => {
3682
3925
  return field3.config.type === FieldType.ALPHA_HIDDEN;
3683
3926
  };
3684
3927
  var isNonInteractiveFieldType = (field3) => {
3685
- 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;
3928
+ 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;
3686
3929
  };
3687
3930
 
3688
3931
  // ../commons/src/conditionals/validate.ts
@@ -3718,7 +3961,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3718
3961
  }
3719
3962
  return current;
3720
3963
  }
3964
+ function todayISO() {
3965
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
3966
+ }
3967
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
3968
+ function compileClientFunction(code) {
3969
+ let fn = compiledFunctionCache.get(code);
3970
+ if (!fn) {
3971
+ fn = new Function(`return (${code})`)();
3972
+ compiledFunctionCache.set(code, fn);
3973
+ }
3974
+ return fn;
3975
+ }
3721
3976
  (0, import_ajv_formats.default)(ajv);
3977
+ function buildClientFunctionContext(input) {
3978
+ return {
3979
+ $form: input.form,
3980
+ $now: todayISO(),
3981
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
3982
+ $online: isOnline(),
3983
+ $user: input.validatorContext?.user,
3984
+ $event: input.validatorContext?.event,
3985
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
3986
+ user: input.systemVariables?.user,
3987
+ $window: input.systemVariables?.$window,
3988
+ locations: input.locations,
3989
+ adminLevelIds: input.adminLevelIds
3990
+ };
3991
+ }
3992
+ function runClientFunction(code, data, context) {
3993
+ return compileClientFunction(code)(data, context);
3994
+ }
3722
3995
  ajv.addKeyword({
3723
3996
  keyword: "daysFromDate",
3724
3997
  type: "string",
@@ -3763,7 +4036,7 @@ ajv.addKeyword({
3763
4036
  $data: true,
3764
4037
  errors: true,
3765
4038
  // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
3766
- validate(schema, data, _2, dataContext) {
4039
+ validate(_schema, data, _2, dataContext) {
3767
4040
  const locationIdInput = data;
3768
4041
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3769
4042
  return locations.some((location) => location.id === locationIdInput);
@@ -3794,6 +4067,23 @@ function isAgeValue(value) {
3794
4067
  function mergeWithBaseFormState(values, context) {
3795
4068
  return { ...context.baseFormState, ...values };
3796
4069
  }
4070
+ ajv.addKeyword({
4071
+ keyword: "customClientValidator",
4072
+ schemaType: "object",
4073
+ errors: true,
4074
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4075
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4076
+ // so the cast holds.
4077
+ validate(schema, data, _2, dataContext) {
4078
+ return Boolean(
4079
+ runClientFunction(
4080
+ schema.code,
4081
+ data,
4082
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4083
+ )
4084
+ );
4085
+ }
4086
+ });
3797
4087
  function validate(schema, data) {
3798
4088
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3799
4089
  if ("$form" in data) {
@@ -3830,17 +4120,14 @@ function isOnline() {
3830
4120
  }
3831
4121
  return true;
3832
4122
  }
3833
- function isConditionMet(conditional, values, context, eventIndex) {
3834
- return validate(conditional, {
3835
- $form: mergeWithBaseFormState(values, context),
3836
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3837
- $online: isOnline(),
3838
- $user: context.user,
3839
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3840
- $flags: eventIndex?.flags ?? [],
3841
- $status: eventIndex?.status,
3842
- $event: context.event
3843
- });
4123
+ function isConditionMet(conditional, values, context) {
4124
+ return validate(
4125
+ conditional,
4126
+ buildClientFunctionContext({
4127
+ form: mergeWithBaseFormState(values, context),
4128
+ validatorContext: context
4129
+ })
4130
+ );
3844
4131
  }
3845
4132
  function getConditionalActionsForField(field3, values) {
3846
4133
  if (!field3.conditionals) {
@@ -3848,9 +4135,9 @@ function getConditionalActionsForField(field3, values) {
3848
4135
  }
3849
4136
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3850
4137
  }
3851
- function areConditionsMet(conditions, values, context, event2) {
4138
+ function areConditionsMet(conditions, values, context, _event) {
3852
4139
  return conditions.every(
3853
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4140
+ (condition) => isConditionMet(condition.conditional, values, context)
3854
4141
  );
3855
4142
  }
3856
4143
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3860,14 +4147,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3860
4147
  if (!hasRule) {
3861
4148
  return true;
3862
4149
  }
3863
- const validConditionals = getConditionalActionsForField(field3, {
3864
- $form: mergeWithBaseFormState(form, context),
3865
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3866
- $online: isOnline(),
3867
- $user: context.user,
3868
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3869
- $event: context.event
3870
- });
4150
+ const validConditionals = getConditionalActionsForField(
4151
+ field3,
4152
+ buildClientFunctionContext({
4153
+ form: mergeWithBaseFormState(form, context),
4154
+ validatorContext: context
4155
+ })
4156
+ );
3871
4157
  return validConditionals.includes(conditionalType);
3872
4158
  }
3873
4159
  function isFieldVisible(field3, form, context) {
@@ -3893,7 +4179,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3893
4179
  if (!rule) {
3894
4180
  return true;
3895
4181
  }
3896
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4182
+ return validate(rule.conditional, {
4183
+ ...buildClientFunctionContext({
4184
+ form: mergeWithBaseFormState(event2.declaration, context),
4185
+ validatorContext: context
4186
+ }),
4187
+ $flags: event2.flags,
4188
+ $status: event2.status
4189
+ });
3897
4190
  }
3898
4191
  function isActionEnabled(actionConfig, event2, context) {
3899
4192
  return isActionConditionMet(
@@ -4052,19 +4345,10 @@ function runFieldValidations({
4052
4345
  if (!isFieldVisible(field3.config, form, context)) {
4053
4346
  return [];
4054
4347
  }
4055
- const conditionalParameters = {
4056
- $form: mergeWithBaseFormState(form, context),
4057
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4058
- /**
4059
- * In real use cases, there can be hundreds of thousands of locations.
4060
- * Make sure that the context contains only the locations that are needed for validation.
4061
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4062
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4063
- */
4064
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4065
- $online: isOnline(),
4066
- $user: context.user
4067
- };
4348
+ const conditionalParameters = buildClientFunctionContext({
4349
+ form: mergeWithBaseFormState(form, context),
4350
+ validatorContext: context
4351
+ });
4068
4352
  if (isFieldGroupFieldType(field3)) {
4069
4353
  const subfieldErrors = buildFormState(
4070
4354
  field3.config.fields,
@@ -4203,13 +4487,13 @@ function getActionConfig({
4203
4487
  actionType,
4204
4488
  customActionType
4205
4489
  }) {
4490
+ if (actionType === ActionType.NOTIFY) {
4491
+ return eventConfiguration.actions.find((a) => a.type === ActionType.NOTIFY) ?? eventConfiguration.actions.find((a) => a.type === ActionType.DECLARE);
4492
+ }
4206
4493
  return eventConfiguration.actions.find((a) => {
4207
4494
  if (a.type === ActionType.CUSTOM && customActionType) {
4208
4495
  return a.customActionType === customActionType;
4209
4496
  }
4210
- if (actionType === ActionType.NOTIFY) {
4211
- return a.type === ActionType.DECLARE;
4212
- }
4213
4497
  if (actionType === ActionType.APPROVE_CORRECTION || actionType === ActionType.REJECT_CORRECTION) {
4214
4498
  return a.type === ActionType.REQUEST_CORRECTION;
4215
4499
  }
@@ -4246,7 +4530,7 @@ var getActionAnnotationFields = (actionConfig) => {
4246
4530
  if (actionConfig.type === ActionType.CUSTOM) {
4247
4531
  return actionConfig.form;
4248
4532
  }
4249
- if ("review" in actionConfig) {
4533
+ if ("review" in actionConfig && actionConfig.review != null) {
4250
4534
  return actionConfig.review.fields;
4251
4535
  }
4252
4536
  return [];
@@ -4548,19 +4832,32 @@ function getPendingAction(actions) {
4548
4832
  }
4549
4833
  return pendingActions[0];
4550
4834
  }
4551
- function getCompleteActionAnnotation(annotation, event2, action) {
4835
+ function getCompleteActionAnnotation(event2, action) {
4552
4836
  if (action.originalActionId) {
4553
4837
  const originalAction = event2.actions.find(
4554
4838
  ({ id }) => id === action.originalActionId
4555
4839
  );
4556
4840
  if (originalAction?.status === ActionStatus.Requested) {
4557
- return deepMerge(
4558
- deepMerge(annotation, originalAction.annotation ?? {}),
4559
- action.annotation ?? {}
4560
- );
4841
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4561
4842
  }
4562
4843
  }
4563
- return deepMerge(annotation, action.annotation ?? {});
4844
+ return action.annotation ?? {};
4845
+ }
4846
+ function getCompleteActionContent(event2, action) {
4847
+ const currentContent = "content" in action ? action.content : void 0;
4848
+ if (!action.originalActionId) {
4849
+ return currentContent;
4850
+ }
4851
+ const originalAction = event2.actions.find(
4852
+ ({ id }) => id === action.originalActionId
4853
+ );
4854
+ if (originalAction && "content" in originalAction && originalAction.content) {
4855
+ return {
4856
+ ...originalAction.content,
4857
+ ...currentContent ?? {}
4858
+ };
4859
+ }
4860
+ return currentContent;
4564
4861
  }
4565
4862
  function getCompleteActionDeclaration(declaration, event2, action) {
4566
4863
  if (action.originalActionId) {
@@ -4580,7 +4877,7 @@ function getAcceptedActions(event2) {
4580
4877
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4581
4878
  ...action,
4582
4879
  declaration: getCompleteActionDeclaration({}, event2, action),
4583
- annotation: getCompleteActionAnnotation({}, event2, action)
4880
+ annotation: getCompleteActionAnnotation(event2, action)
4584
4881
  }));
4585
4882
  }
4586
4883
  var EXCLUDED_ACTIONS = [
@@ -4668,6 +4965,9 @@ function not(condition) {
4668
4965
  function never2() {
4669
4966
  return not(alwaysTrue());
4670
4967
  }
4968
+ function always() {
4969
+ return defineConditional(alwaysTrue());
4970
+ }
4671
4971
  function jsonFieldPath(field3) {
4672
4972
  return [field3.$$field, ...field3.$$subfield].join("/");
4673
4973
  }
@@ -5215,7 +5515,54 @@ function createFieldConditionals(fieldId) {
5215
5515
  }
5216
5516
  },
5217
5517
  required: [fieldId]
5218
- })
5518
+ }),
5519
+ /**
5520
+ * Custom client-side validator. The provided function is serialised and executed
5521
+ * just-in-time on the client only. External references (e.g. lodash) are not
5522
+ * available inside the function body — all logic must be self-contained.
5523
+ *
5524
+ * @example
5525
+ * field('nid').customClientValidator((value) => {
5526
+ * // LUHN check — all logic must be inline
5527
+ * const digits = String(value).split('').map(Number)
5528
+ * // ...
5529
+ * return isValid
5530
+ * })
5531
+ */
5532
+ customClientValidator(validationFn) {
5533
+ const code = validationFn.toString();
5534
+ return defineFormConditional({
5535
+ type: "object",
5536
+ properties: wrapToPath(
5537
+ { [fieldId]: { customClientValidator: { code } } },
5538
+ this.$$subfield
5539
+ ),
5540
+ required: [fieldId]
5541
+ });
5542
+ },
5543
+ /**
5544
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5545
+ * that can be used as the `value` property or a DATA component entry.
5546
+ * The function receives the referenced field's value as the first argument and
5547
+ * the full form context as the second; its return value replaces the field reference.
5548
+ * The function is serialised and executed just-in-time on the client only.
5549
+ * External references (e.g. lodash) are not available inside the function body.
5550
+ *
5551
+ * For computing a default value without referencing a specific field, use
5552
+ * `evaluate(fn)` in the `defaultValue` property instead.
5553
+ *
5554
+ * @example
5555
+ * field('a').customClientEvaluation((aValue, ctx) =>
5556
+ * Number(aValue) + Number(ctx.$form.b)
5557
+ * )
5558
+ */
5559
+ customClientEvaluation(computationFn) {
5560
+ return {
5561
+ $$code: computationFn.toString(),
5562
+ $$field: fieldId,
5563
+ $$subfield: this.$$subfield
5564
+ };
5565
+ }
5219
5566
  };
5220
5567
  }
5221
5568
 
@@ -5363,7 +5710,7 @@ var _EventConfigBase = z33.object({
5363
5710
  ),
5364
5711
  label: TranslationConfig.describe("Human-readable label for the event type."),
5365
5712
  actions: z33.array(ActionConfig).describe(
5366
- "Configuration of system-defined actions associated with the event."
5713
+ "Configuration of core and custom actions associated with the event."
5367
5714
  ),
5368
5715
  actionOrder: z33.array(z33.string()).optional().describe(
5369
5716
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5375,7 +5722,7 @@ var _EventConfigBase = z33.object({
5375
5722
  "Configuration of fields available in the advanced search feature."
5376
5723
  ),
5377
5724
  flags: z33.array(FlagConfig).optional().default([]).describe(
5378
- "Configuration of flags associated with the actions of this event type."
5725
+ "Configuration of custom flags associated with the actions of this event type."
5379
5726
  ),
5380
5727
  analytics: z33.boolean().optional().default(true).describe(
5381
5728
  "Indicates whether the records of this event type are included in analytics"
@@ -5388,8 +5735,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5388
5735
  validateActionFlags(event2, ctx);
5389
5736
  validateActionOrder(event2, ctx);
5390
5737
  }).meta({
5391
- id: "EventConfig"
5392
- }).describe("Configuration defining an event type.");
5738
+ id: "EventConfig",
5739
+ description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
5740
+ });
5393
5741
 
5394
5742
  // ../commons/src/events/EventConfigInput.ts
5395
5743
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5612,6 +5960,9 @@ var WorkqueueColumnValue = z34.object({
5612
5960
  var WorkqueueColumn = z34.object({
5613
5961
  label: TranslationConfig,
5614
5962
  value: WorkqueueColumnValue
5963
+ }).meta({
5964
+ id: "WorkqueueColumn",
5965
+ description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
5615
5966
  });
5616
5967
  function defineWorkqueuesColumns(workqueueColumns) {
5617
5968
  return workqueueColumns.map(
@@ -5814,18 +6165,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5814
6165
  query: true,
5815
6166
  columns: true
5816
6167
  });
5817
- var WorkqueueConfigInput = z37.object({
5818
- slug: z37.string().describe("Determines the url of the workqueue."),
5819
- name: TranslationConfig.describe(
5820
- "Title of the workflow (both in navigation and on the page)"
5821
- ),
5822
- query: CountryConfigQueryInputType,
5823
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5824
- "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."
5825
- ),
5826
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5827
- icon: AvailableIcons,
5828
- emptyMessage: TranslationConfig.optional()
6168
+ var WorkqueueConfigInput = WorkqueueConfig.extend({
6169
+ query: CountryConfigQueryInputType
6170
+ }).meta({
6171
+ id: "WorkqueueConfig",
6172
+ 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."
5829
6173
  });
5830
6174
  function defineWorkqueue(workqueueInput) {
5831
6175
  const queryInput = workqueueInput.query;
@@ -5888,7 +6232,9 @@ var BaseActionInput = z38.object({
5888
6232
  keepAssignment: z38.boolean().optional(),
5889
6233
  keepAssignmentIfAccepted: z38.boolean().optional(),
5890
6234
  keepAssignmentIfRejected: z38.boolean().optional(),
5891
- waitFor: z38.boolean().optional(),
6235
+ waitFor: z38.boolean().default(true).describe(
6236
+ "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."
6237
+ ),
5892
6238
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5893
6239
  // @TODO: createdAtLocation should be limited to actions that system users can perform. For normal users, it should not be part of the base action.
5894
6240
  createdAtLocation: UUID.nullish().describe(
@@ -6006,7 +6352,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
6006
6352
  var ApproveCorrectionActionInput = BaseActionInput.extend(
6007
6353
  z38.object({
6008
6354
  requestId: z38.string(),
6009
- type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION)
6355
+ type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION),
6356
+ content: z38.object({ immediateCorrection: z38.boolean().optional() }).optional()
6010
6357
  }).shape
6011
6358
  );
6012
6359
  var ReadActionInput = BaseActionInput.extend(
@@ -6068,7 +6415,7 @@ var Draft = z39.object({
6068
6415
  }).describe(
6069
6416
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6070
6417
  );
6071
- var DraftInput = BaseActionInput.extend({
6418
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6072
6419
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6073
6420
  status: z39.enum([
6074
6421
  ActionStatus.Requested,
@@ -6155,6 +6502,8 @@ var updateActions = ActionTypes.extract([
6155
6502
  ActionType.ARCHIVE,
6156
6503
  ActionType.PRINT_CERTIFICATE,
6157
6504
  ActionType.REQUEST_CORRECTION,
6505
+ ActionType.APPROVE_CORRECTION,
6506
+ ActionType.REJECT_CORRECTION,
6158
6507
  ActionType.CUSTOM
6159
6508
  ]);
6160
6509
  function getActionUpdateMetadata(actions) {
@@ -6169,7 +6518,7 @@ function getActionUpdateMetadata(actions) {
6169
6518
  "createdAtLocation",
6170
6519
  "createdByRole"
6171
6520
  ];
6172
- return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
6521
+ return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
6173
6522
  (_2, action) => {
6174
6523
  if (action.originalActionId) {
6175
6524
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6196,28 +6545,19 @@ function getLegalStatuses(actions) {
6196
6545
  // ../commons/src/events/state/flags.ts
6197
6546
  var import_lodash3 = require("lodash");
6198
6547
  var import_date_fns3 = require("date-fns");
6199
- function isEditInProgress(actions) {
6200
- return actions.at(-1)?.type === ActionType.EDIT;
6201
- }
6202
- function isCorrectionRequested(actions) {
6203
- return actions.reduce((prev, { type }) => {
6204
- if (type === ActionType.REQUEST_CORRECTION) {
6205
- return true;
6206
- }
6207
- if (type === ActionType.APPROVE_CORRECTION) {
6208
- return false;
6548
+ function findPendingCorrectionAction(writeActions2) {
6549
+ let correctionRequestAction;
6550
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6551
+ const action = writeActions2[i];
6552
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6553
+ break;
6209
6554
  }
6210
- if (type === ActionType.REJECT_CORRECTION) {
6211
- return false;
6555
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6556
+ correctionRequestAction = action;
6557
+ break;
6212
6558
  }
6213
- return prev;
6214
- }, false);
6215
- }
6216
- function isDeclarationIncomplete(actions) {
6217
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6218
- }
6219
- function isRejected(actions) {
6220
- return actions.at(-1)?.type === ActionType.REJECT;
6559
+ }
6560
+ return correctionRequestAction;
6221
6561
  }
6222
6562
  function isPotentialDuplicate(actions) {
6223
6563
  return actions.reduce((prev, { type }) => {
@@ -6246,6 +6586,88 @@ function isFlagConditionMet(conditional, form, action) {
6246
6586
  }
6247
6587
  });
6248
6588
  }
6589
+ function actionConfigRemovesFlag(action, flagId, actionsUpToAndIncluding, event2, eventConfiguration) {
6590
+ if (!isActionConfigType(action.type)) {
6591
+ return false;
6592
+ }
6593
+ const actionConfig = getActionConfig({
6594
+ eventConfiguration,
6595
+ actionType: action.type,
6596
+ customActionType: "customActionType" in action ? action.customActionType : void 0
6597
+ });
6598
+ const removeOperations = (actionConfig?.flags ?? []).filter(
6599
+ ({ id, operation }) => id === flagId && operation === "remove"
6600
+ );
6601
+ if (removeOperations.length === 0) {
6602
+ return false;
6603
+ }
6604
+ const eventUpToThisAction = { ...event2, actions: actionsUpToAndIncluding };
6605
+ const declaration = aggregateActionDeclarations(eventUpToThisAction);
6606
+ const annotation = aggregateActionAnnotations(eventUpToThisAction);
6607
+ const form = { ...declaration, ...annotation };
6608
+ return removeOperations.some(
6609
+ ({ conditional }) => conditional ? isFlagConditionMet(conditional, form, action) : true
6610
+ );
6611
+ }
6612
+ var INHERENT_FLAG_RULES = [
6613
+ {
6614
+ flag: InherentFlags.CORRECTION_REQUESTED,
6615
+ setOn: [ActionType.REQUEST_CORRECTION],
6616
+ resetOn: [ActionType.APPROVE_CORRECTION, ActionType.REJECT_CORRECTION]
6617
+ },
6618
+ {
6619
+ // INCOMPLETE mirrors the NOTIFIED status: set by NOTIFY, cleared by any
6620
+ // other status-changing action (see getStatusFromActions).
6621
+ flag: InherentFlags.INCOMPLETE,
6622
+ setOn: [ActionType.NOTIFY],
6623
+ resetOn: [
6624
+ ActionType.CREATE,
6625
+ ActionType.DECLARE,
6626
+ ActionType.REGISTER,
6627
+ ActionType.ARCHIVE
6628
+ ]
6629
+ },
6630
+ {
6631
+ flag: InherentFlags.REJECTED,
6632
+ setOn: [ActionType.REJECT],
6633
+ resetOn: [
6634
+ ActionType.NOTIFY,
6635
+ ActionType.DECLARE,
6636
+ ActionType.EDIT,
6637
+ ActionType.REGISTER
6638
+ ]
6639
+ },
6640
+ {
6641
+ flag: InherentFlags.POTENTIAL_DUPLICATE,
6642
+ setOn: [ActionType.DUPLICATE_DETECTED],
6643
+ resetOn: [ActionType.MARK_AS_DUPLICATE, ActionType.MARK_AS_NOT_DUPLICATE]
6644
+ },
6645
+ {
6646
+ flag: InherentFlags.EDIT_IN_PROGRESS,
6647
+ setOn: [ActionType.EDIT],
6648
+ resetOnAnyOtherAction: true
6649
+ }
6650
+ ];
6651
+ function resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration) {
6652
+ return acceptedActions.reduce((present, action, idx) => {
6653
+ if (rule.setOn.includes(action.type)) {
6654
+ return true;
6655
+ }
6656
+ if (rule.resetOnAnyOtherAction || (rule.resetOn ?? []).includes(action.type)) {
6657
+ return false;
6658
+ }
6659
+ if (actionConfigRemovesFlag(
6660
+ action,
6661
+ rule.flag,
6662
+ acceptedActions.slice(0, idx + 1),
6663
+ event2,
6664
+ eventConfiguration
6665
+ )) {
6666
+ return false;
6667
+ }
6668
+ return present;
6669
+ }, false);
6670
+ }
6249
6671
  function resolveEventCustomFlags(event2, eventConfiguration) {
6250
6672
  const actions = getAcceptedActions(event2).filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6251
6673
  return actions.reduce((acc, action, idx) => {
@@ -6281,8 +6703,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6281
6703
  return (0, import_lodash3.uniq)(flags);
6282
6704
  }, []);
6283
6705
  }
6284
- function getEventFlags(event2, config) {
6285
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6706
+ function getActionStatusFlags(sortedActions) {
6286
6707
  const actionStatus = sortedActions.reduce(
6287
6708
  (actionStatuses, { type, status: status2 }) => ({
6288
6709
  ...actionStatuses,
@@ -6290,26 +6711,26 @@ function getEventFlags(event2, config) {
6290
6711
  }),
6291
6712
  {}
6292
6713
  );
6293
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6714
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6294
6715
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6295
6716
  return flag2;
6296
6717
  });
6297
- if (isCorrectionRequested(sortedActions)) {
6298
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6299
- }
6300
- if (isDeclarationIncomplete(sortedActions)) {
6301
- flags.push(InherentFlags.INCOMPLETE);
6302
- }
6303
- if (isRejected(sortedActions)) {
6304
- flags.push(InherentFlags.REJECTED);
6305
- }
6306
- if (isPotentialDuplicate(sortedActions)) {
6307
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6308
- }
6309
- if (isEditInProgress(sortedActions)) {
6310
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6311
- }
6312
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6718
+ }
6719
+ function getInherentFlags(sortedActions, event2, eventConfiguration) {
6720
+ const acceptedActions = sortedActions.filter(
6721
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6722
+ );
6723
+ return INHERENT_FLAG_RULES.filter(
6724
+ (rule) => resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration)
6725
+ ).map(({ flag: flag2 }) => flag2);
6726
+ }
6727
+ function getEventFlags(event2, config) {
6728
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6729
+ return [
6730
+ ...getActionStatusFlags(sortedActions),
6731
+ ...getInherentFlags(sortedActions, event2, config),
6732
+ ...resolveEventCustomFlags(event2, config)
6733
+ ];
6313
6734
  }
6314
6735
 
6315
6736
  // ../commons/src/events/state/index.ts
@@ -6544,7 +6965,7 @@ function getActionAnnotation({
6544
6965
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6545
6966
  const actionWithCompleteAnnotation = action && {
6546
6967
  ...action,
6547
- annotation: getCompleteActionAnnotation({}, event2, action)
6968
+ annotation: getCompleteActionAnnotation(event2, action)
6548
6969
  };
6549
6970
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6550
6971
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6616,6 +7037,9 @@ function createFieldConfig(fieldId, options) {
6616
7037
  }
6617
7038
 
6618
7039
  // ../commons/src/events/field.ts
7040
+ function evaluate(computationFn) {
7041
+ return { $$code: computationFn.toString() };
7042
+ }
6619
7043
  function field(fieldId, options = {}) {
6620
7044
  return {
6621
7045
  ...createFieldConditionals(fieldId),
@@ -7309,6 +7733,11 @@ var TENNIS_CLUB_DECLARATION_REVIEW = {
7309
7733
  id: "signature.upload.modal.title",
7310
7734
  defaultMessage: "Draw signature",
7311
7735
  description: "Title for the modal to draw signature"
7736
+ },
7737
+ // Zod applies the schema default at parse time, but this fixture bypasses
7738
+ // parsing — GeneratedInputField accesses configuration.maxFileSize directly.
7739
+ configuration: {
7740
+ maxFileSize: 5 * 1024 * 1024
7312
7741
  }
7313
7742
  }
7314
7743
  ]
@@ -7865,6 +8294,20 @@ var tennisClubMembershipEvent = defineConfig({
7865
8294
  },
7866
8295
  review: TENNIS_CLUB_DECLARATION_REVIEW
7867
8296
  },
8297
+ {
8298
+ type: ActionType.NOTIFY,
8299
+ label: {
8300
+ defaultMessage: "Notify health worker",
8301
+ description: "This is shown as the action name anywhere the user can trigger the action from",
8302
+ id: "event.tennis-club-membership.action.notify.label"
8303
+ },
8304
+ flags: [
8305
+ {
8306
+ id: "health-worker-notified",
8307
+ operation: "add"
8308
+ }
8309
+ ]
8310
+ },
7868
8311
  {
7869
8312
  type: ActionType.REJECT,
7870
8313
  label: {
@@ -8107,6 +8550,17 @@ var tennisClubMembershipEvent = defineConfig({
8107
8550
  }
8108
8551
  }
8109
8552
  ],
8553
+ flags: [
8554
+ {
8555
+ id: "health-worker-notified",
8556
+ requiresAction: false,
8557
+ label: {
8558
+ id: "event.tennis-club-membership.flag.health-worker-notified.label",
8559
+ defaultMessage: "Health worker notified",
8560
+ description: "Label for the health-worker-notified flag"
8561
+ }
8562
+ }
8563
+ ],
8110
8564
  advancedSearch: [
8111
8565
  {
8112
8566
  title: {
@@ -9865,7 +10319,7 @@ function matchesJurisdictionFilter(locationIds, filter, user2) {
9865
10319
  return locationIds.some((id) => id === user2.primaryOfficeId);
9866
10320
  }
9867
10321
  if (filter === JurisdictionFilter.enum.administrativeArea) {
9868
- return user2.administrativeAreaId === null || locationIds.some((id) => id === user2.administrativeAreaId);
10322
+ return !user2.administrativeAreaId || locationIds.some((id) => id === user2.administrativeAreaId);
9869
10323
  }
9870
10324
  return true;
9871
10325
  }
@@ -9954,7 +10408,7 @@ function canAccessUserWithScope({
9954
10408
  }
9955
10409
  const hasAdministrativeAreaInHierarchy = userToAccess.administrativeHierarchy.some(
9956
10410
  (id) => user2.administrativeAreaId === id
9957
- ) || user2.administrativeAreaId === null;
10411
+ ) || !user2.administrativeAreaId;
9958
10412
  if (opts?.accessLevel === JurisdictionFilter.enum.administrativeArea && !hasAdministrativeAreaInHierarchy) {
9959
10413
  return false;
9960
10414
  }
@@ -10260,18 +10714,19 @@ var ACTION_FILTERS = {
10260
10714
  function filterActionsByFlags(actions, flags) {
10261
10715
  return actions.filter((action) => ACTION_FILTERS[action]?.(flags) ?? true);
10262
10716
  }
10717
+ var REJECTED_ACTIONS = [
10718
+ ActionType.READ,
10719
+ ActionType.NOTIFY,
10720
+ ActionType.CUSTOM,
10721
+ ActionType.EDIT,
10722
+ ActionType.ARCHIVE
10723
+ ];
10263
10724
  function getAvailableActionsWithoutFlagFilters(status2, flags) {
10264
10725
  if (flags.includes(InherentFlags.EDIT_IN_PROGRESS)) {
10265
10726
  return [ActionType.NOTIFY, ActionType.DECLARE, ActionType.REGISTER];
10266
10727
  }
10267
- if (flags.includes(InherentFlags.REJECTED)) {
10268
- return [
10269
- ActionType.READ,
10270
- ActionType.NOTIFY,
10271
- ActionType.CUSTOM,
10272
- ActionType.EDIT,
10273
- ActionType.ARCHIVE
10274
- ];
10728
+ if (flags.includes(InherentFlags.REJECTED) && status2 !== EventStatus.enum.ARCHIVED) {
10729
+ return REJECTED_ACTIONS;
10275
10730
  }
10276
10731
  return AVAILABLE_ACTIONS_BY_EVENT_STATUS[status2];
10277
10732
  }
@@ -10308,3 +10763,366 @@ function getFilePathsFromEvent(event2) {
10308
10763
  });
10309
10764
  return (0, import_lodash7.uniq)(filepaths);
10310
10765
  }
10766
+
10767
+ // ../commons/src/events/mocks.test.utils.ts
10768
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10769
+ {
10770
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10771
+ name: "Central",
10772
+ parentId: null,
10773
+ validUntil: null,
10774
+ externalId: "ydyJb1RAy4U1"
10775
+ },
10776
+ {
10777
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10778
+ name: "Sulaka",
10779
+ parentId: null,
10780
+ validUntil: null,
10781
+ externalId: "pQ8nGxWmZ2Q3"
10782
+ },
10783
+ {
10784
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10785
+ name: "Pualula",
10786
+ parentId: null,
10787
+ validUntil: null,
10788
+ externalId: "Aq91DweLmT8k"
10789
+ },
10790
+ {
10791
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10792
+ name: "Chuminga",
10793
+ parentId: null,
10794
+ validUntil: null,
10795
+ externalId: "Rw0fYNh2Xk9a"
10796
+ },
10797
+ {
10798
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10799
+ name: "Ibombo",
10800
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10801
+ validUntil: null,
10802
+ externalId: "k7DsP4vbN1Qe"
10803
+ },
10804
+ {
10805
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10806
+ name: "Isango",
10807
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10808
+ validUntil: null,
10809
+ externalId: "Gm3Z9eQpHw4L"
10810
+ },
10811
+ {
10812
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10813
+ name: "Isamba",
10814
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10815
+ validUntil: null,
10816
+ externalId: "sT0xVu1KqJ7r"
10817
+ },
10818
+ {
10819
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10820
+ name: "Itambo",
10821
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10822
+ validUntil: null,
10823
+ externalId: "Nq6Bv2HpL9Te"
10824
+ },
10825
+ {
10826
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10827
+ name: "Ezhi",
10828
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10829
+ validUntil: null,
10830
+ externalId: "xK8cQ0ZRy5Wd"
10831
+ },
10832
+ {
10833
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10834
+ name: "Ilanga",
10835
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10836
+ validUntil: null,
10837
+ externalId: "Cq4Jm1XvN8Ls"
10838
+ },
10839
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10840
+ {
10841
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10842
+ name: "Klow",
10843
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10844
+ validUntil: null,
10845
+ externalId: "IkYcYBUcyY2"
10846
+ },
10847
+ {
10848
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10849
+ name: "Mbondo",
10850
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10851
+ validUntil: null,
10852
+ externalId: "Qhvv5hvo3mY"
10853
+ },
10854
+ {
10855
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10856
+ name: "Ndara",
10857
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10858
+ validUntil: null,
10859
+ externalId: "crXh068O9TR"
10860
+ },
10861
+ {
10862
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10863
+ name: "Olani",
10864
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10865
+ validUntil: null,
10866
+ externalId: "r00It8Tvvp7"
10867
+ },
10868
+ {
10869
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10870
+ name: "Pemba",
10871
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10872
+ validUntil: null,
10873
+ externalId: "ZnUWsbONIaH"
10874
+ },
10875
+ {
10876
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10877
+ name: "Quanza",
10878
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10879
+ validUntil: null,
10880
+ externalId: "fDZycvQTa7l"
10881
+ },
10882
+ {
10883
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10884
+ name: "Rivka",
10885
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10886
+ validUntil: null,
10887
+ externalId: "KqswxCGTELa"
10888
+ },
10889
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10890
+ {
10891
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10892
+ name: "Mbula",
10893
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10894
+ validUntil: null,
10895
+ externalId: "osEbKjRc9Kg"
10896
+ },
10897
+ {
10898
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10899
+ name: "Ndoki",
10900
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10901
+ validUntil: null,
10902
+ externalId: "aq4daBUAGr3"
10903
+ },
10904
+ {
10905
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10906
+ name: "Tsanga",
10907
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10908
+ validUntil: null,
10909
+ externalId: "cqis6Y8trbJ"
10910
+ },
10911
+ {
10912
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10913
+ name: "Waziri",
10914
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10915
+ validUntil: null,
10916
+ externalId: "LMijHPyyx6d"
10917
+ },
10918
+ {
10919
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
10920
+ name: "Zimbi",
10921
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10922
+ validUntil: null,
10923
+ externalId: "pcQYbPuKGZ7"
10924
+ },
10925
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
10926
+ {
10927
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
10928
+ name: "Felani",
10929
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10930
+ validUntil: null,
10931
+ externalId: "gSqpoCGdMXp"
10932
+ },
10933
+ {
10934
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
10935
+ name: "Goroma",
10936
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10937
+ validUntil: null,
10938
+ externalId: "KvAAIaNqVrp"
10939
+ },
10940
+ {
10941
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
10942
+ name: "Halifu",
10943
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10944
+ validUntil: null,
10945
+ externalId: "qe4UnEVt1hv"
10946
+ },
10947
+ {
10948
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
10949
+ name: "Jabari",
10950
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10951
+ validUntil: null,
10952
+ externalId: "yHH9Nz4rLOt"
10953
+ },
10954
+ {
10955
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
10956
+ name: "Kifani",
10957
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10958
+ validUntil: null,
10959
+ externalId: "eSWmXIGeu1I"
10960
+ },
10961
+ {
10962
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
10963
+ name: "Lumela",
10964
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10965
+ validUntil: null,
10966
+ externalId: "bh0b3aI1uP3"
10967
+ }
10968
+ ];
10969
+ var V2_DEFAULT_MOCK_LOCATIONS = [
10970
+ {
10971
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
10972
+ name: "Central Provincial Office",
10973
+ locationType: "CRVS_OFFICE",
10974
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10975
+ validUntil: null,
10976
+ externalId: "Xr3Df8WpK6Ys"
10977
+ },
10978
+ {
10979
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
10980
+ name: "Central Health Post",
10981
+ locationType: "HEALTH_FACILITY",
10982
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10983
+ validUntil: null
10984
+ },
10985
+ {
10986
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
10987
+ name: "Ibombo District Office",
10988
+ locationType: "CRVS_OFFICE",
10989
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10990
+ validUntil: null,
10991
+ externalId: "Sm4Nw7GrD2Vy"
10992
+ },
10993
+ {
10994
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
10995
+ name: "Isamba District Office",
10996
+ locationType: "CRVS_OFFICE",
10997
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10998
+ validUntil: null,
10999
+ externalId: "Vg1Bq5XeH9Lt"
11000
+ },
11001
+ {
11002
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
11003
+ name: "Isango District Office",
11004
+ locationType: "CRVS_OFFICE",
11005
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
11006
+ validUntil: null,
11007
+ externalId: "Je7Lm2XqN9Vz"
11008
+ },
11009
+ {
11010
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
11011
+ name: "Sulaka Provincial Office",
11012
+ locationType: "CRVS_OFFICE",
11013
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
11014
+ validUntil: null,
11015
+ externalId: "Ht2Wp9KcX5Qv"
11016
+ },
11017
+ {
11018
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
11019
+ name: "Ilanga District Office",
11020
+ locationType: "CRVS_OFFICE",
11021
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
11022
+ validUntil: null,
11023
+ externalId: "Yp6Ds1WqN3Xz"
11024
+ },
11025
+ {
11026
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
11027
+ name: "Chamakubi Health Post",
11028
+ locationType: "HEALTH_FACILITY",
11029
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11030
+ validUntil: null,
11031
+ externalId: "M1nFr8LbC2Qy"
11032
+ },
11033
+ {
11034
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
11035
+ name: "Ibombo Rural Health Centre",
11036
+ locationType: "HEALTH_FACILITY",
11037
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11038
+ validUntil: null,
11039
+ externalId: "bT7pV6YrW0Xc"
11040
+ },
11041
+ {
11042
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
11043
+ name: "Chikobo Rural Health Centre",
11044
+ locationType: "HEALTH_FACILITY",
11045
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11046
+ validUntil: null,
11047
+ externalId: "zE4qPn2SgJ5d"
11048
+ },
11049
+ {
11050
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
11051
+ name: "Chilochabalenje Health Post",
11052
+ locationType: "HEALTH_FACILITY",
11053
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11054
+ validUntil: null,
11055
+ externalId: "H8vDs1MqR4Uf"
11056
+ },
11057
+ {
11058
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
11059
+ name: "Chipeso Rural Health Centre",
11060
+ locationType: "HEALTH_FACILITY",
11061
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11062
+ validUntil: null,
11063
+ externalId: "Qw3uZ9KfX6Lm"
11064
+ },
11065
+ {
11066
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
11067
+ name: "Chisamba Rural Health Centre",
11068
+ locationType: "HEALTH_FACILITY",
11069
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11070
+ validUntil: null,
11071
+ externalId: "Yr0pCg8LdM2s"
11072
+ },
11073
+ {
11074
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
11075
+ name: "Chitanda Rural Health Centre",
11076
+ locationType: "HEALTH_FACILITY",
11077
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11078
+ validUntil: null,
11079
+ externalId: "tS9gJ4PwB1Qx"
11080
+ },
11081
+ {
11082
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
11083
+ name: "Golden Valley Rural Health Centre",
11084
+ locationType: "HEALTH_FACILITY",
11085
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11086
+ validUntil: null,
11087
+ externalId: "Ld7Qm3XsA8Vr"
11088
+ },
11089
+ {
11090
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
11091
+ name: "Ipongo Rural Health Centre",
11092
+ locationType: "HEALTH_FACILITY",
11093
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11094
+ validUntil: null,
11095
+ externalId: "kF2sW9DmH0Bt"
11096
+ },
11097
+ {
11098
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
11099
+ name: "Itumbwe Health Post",
11100
+ locationType: "HEALTH_FACILITY",
11101
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11102
+ validUntil: null,
11103
+ externalId: "Ue5Xb3VaC7Pq"
11104
+ },
11105
+ {
11106
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
11107
+ name: "Kabangalala Rural Health Centre",
11108
+ locationType: "HEALTH_FACILITY",
11109
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11110
+ validUntil: null,
11111
+ externalId: "Pz8Kc1TqH6Jn"
11112
+ },
11113
+ // Village offices
11114
+ {
11115
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
11116
+ name: "Klow Village Office",
11117
+ locationType: "CRVS_OFFICE",
11118
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
11119
+ validUntil: null,
11120
+ externalId: "PmAyxAJkxiJ"
11121
+ }
11122
+ ];
11123
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11124
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11125
+ );
11126
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11127
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11128
+ );