@opencrvs/toolkit 2.0.0-rc.e1f588f → 2.0.0-rc.e20c746

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 (63) hide show
  1. package/create-countryconfig/index.js +103 -0
  2. package/create-countryconfig/package.json +21 -0
  3. package/dist/application-config/index.js +314 -131
  4. package/dist/cli.js +548 -178
  5. package/dist/commons/api/router.d.ts +3392 -241
  6. package/dist/commons/application-config/index.d.ts +17 -4
  7. package/dist/commons/conditionals/conditionals.d.ts +360 -10
  8. package/dist/commons/conditionals/validate.d.ts +52 -2
  9. package/dist/commons/events/ActionConfig.d.ts +204 -2
  10. package/dist/commons/events/ActionDocument.d.ts +6 -0
  11. package/dist/commons/events/ActionInput.d.ts +114 -0
  12. package/dist/commons/events/AdvancedSearchConfig.d.ts +342 -0
  13. package/dist/commons/events/CountryConfigQueryInput.d.ts +42 -0
  14. package/dist/commons/events/Draft.d.ts +4 -2
  15. package/dist/commons/events/EventDocument.d.ts +3 -0
  16. package/dist/commons/events/EventIndex.d.ts +14 -3
  17. package/dist/commons/events/EventMetadata.d.ts +0 -7
  18. package/dist/commons/events/FieldConfig.d.ts +388 -50
  19. package/dist/commons/events/FieldType.d.ts +1 -0
  20. package/dist/commons/events/FieldTypeMapping.d.ts +1 -1
  21. package/dist/commons/events/FieldValue.d.ts +6 -0
  22. package/dist/commons/events/WorkqueueConfig.d.ts +189 -150
  23. package/dist/commons/events/field.d.ts +53 -1
  24. package/dist/commons/events/index.d.ts +2 -0
  25. package/dist/commons/events/locations.d.ts +38 -1
  26. package/dist/commons/events/mocks.test.utils.d.ts +19 -0
  27. package/dist/commons/events/scopes.d.ts +24 -1
  28. package/dist/commons/events/state/flags.d.ts +16 -0
  29. package/dist/commons/events/state/index.d.ts +0 -4
  30. package/dist/commons/events/state/utils.d.ts +12 -289
  31. package/dist/commons/events/utils.d.ts +13 -2
  32. package/dist/conditionals/index.js +92 -9
  33. package/dist/events/index.js +1298 -298
  34. package/dist/migrations/v2.0/add-birth-certificate-issuance-flag.d.ts.map +1 -1
  35. package/dist/migrations/v2.0/add-birth-certificate-issuance-flag.js +60 -35
  36. package/dist/migrations/v2.0/checkout-upstream-files.d.ts +1 -1
  37. package/dist/migrations/v2.0/checkout-upstream-files.d.ts.map +1 -1
  38. package/dist/migrations/v2.0/checkout-upstream-files.js +1 -2
  39. package/dist/migrations/v2.0/delete-infrastructure-directory.d.ts +9 -1
  40. package/dist/migrations/v2.0/delete-infrastructure-directory.d.ts.map +1 -1
  41. package/dist/migrations/v2.0/delete-infrastructure-directory.js +66 -20
  42. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts +3 -0
  43. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts.map +1 -0
  44. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.js +110 -0
  45. package/dist/migrations/v2.0/index.d.ts +5 -3
  46. package/dist/migrations/v2.0/index.d.ts.map +1 -1
  47. package/dist/migrations/v2.0/index.js +546 -176
  48. package/dist/migrations/v2.0/make-built-in-validate-actions-custom.d.ts.map +1 -1
  49. package/dist/migrations/v2.0/make-built-in-validate-actions-custom.js +90 -1
  50. package/dist/migrations/v2.0/merge-infrastructure-directory.d.ts +11 -1
  51. package/dist/migrations/v2.0/merge-infrastructure-directory.d.ts.map +1 -1
  52. package/dist/migrations/v2.0/merge-infrastructure-directory.js +17 -16
  53. package/dist/migrations/v2.0/migrate-scopes.d.ts.map +1 -1
  54. package/dist/migrations/v2.0/migrate-scopes.js +54 -30
  55. package/dist/migrations/v2.0/migrate-workqueue-configs.d.ts.map +1 -1
  56. package/dist/migrations/v2.0/migrate-workqueue-configs.js +140 -59
  57. package/dist/notification/index.js +1029 -166
  58. package/dist/scopes/index.d.ts +91 -16
  59. package/dist/scopes/index.js +55 -12
  60. package/opencrvs-toolkit-2.0.0-rc.e20c746.tgz +0 -0
  61. package/package.json +6 -2
  62. package/tsconfig.tsbuildinfo +1 -1
  63. package/opencrvs-toolkit-2.0.0-rc.e1f588f.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,8 +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,
255
+ canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
256
+ canAccessUserWithScope: () => canAccessUserWithScope,
257
+ compileClientFunction: () => compileClientFunction,
246
258
  compositeFieldTypes: () => compositeFieldTypes,
247
259
  createEmptyDraft: () => createEmptyDraft,
248
260
  createFieldConditionals: () => createFieldConditionals,
@@ -263,6 +275,7 @@ __export(events_exports, {
263
275
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
264
276
  deserializeQuery: () => deserializeQuery,
265
277
  errorMessages: () => errorMessages,
278
+ evaluate: () => evaluate,
266
279
  event: () => event,
267
280
  eventMetadataLabelMap: () => eventMetadataLabelMap,
268
281
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -275,6 +288,7 @@ __export(events_exports, {
275
288
  findActiveDraftForEvent: () => findActiveDraftForEvent,
276
289
  findAllFields: () => findAllFields,
277
290
  findLastAssignmentAction: () => findLastAssignmentAction,
291
+ findPendingCorrectionAction: () => findPendingCorrectionAction,
278
292
  findRecordActionPages: () => findRecordActionPages,
279
293
  flag: () => flag,
280
294
  flattenFieldReference: () => flattenFieldReference,
@@ -300,13 +314,15 @@ __export(events_exports, {
300
314
  getActionConfig: () => getActionConfig,
301
315
  getActionReview: () => getActionReview,
302
316
  getActionReviewFields: () => getActionReviewFields,
317
+ getAdministrativeAreaHierarchy: () => getAdministrativeAreaHierarchy,
303
318
  getAllUniqueFields: () => getAllUniqueFields,
304
319
  getAnnotationFromDrafts: () => getAnnotationFromDrafts,
305
320
  getAssignedUserFromActions: () => getAssignedUserFromActions,
306
- getAssignedUserSignatureFromActions: () => getAssignedUserSignatureFromActions,
307
321
  getAssignmentStatus: () => getAssignmentStatus,
308
322
  getAvailableActionsForEvent: () => getAvailableActionsForEvent,
323
+ getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
309
324
  getCompleteActionAnnotation: () => getCompleteActionAnnotation,
325
+ getCompleteActionContent: () => getCompleteActionContent,
310
326
  getCompleteActionDeclaration: () => getCompleteActionDeclaration,
311
327
  getCurrentEventState: () => getCurrentEventState,
312
328
  getCustomActionFields: () => getCustomActionFields,
@@ -315,7 +331,9 @@ __export(events_exports, {
315
331
  getDeclarationFields: () => getDeclarationFields,
316
332
  getDeclarationPages: () => getDeclarationPages,
317
333
  getEventConfigById: () => getEventConfigById,
334
+ getEventFlags: () => getEventFlags,
318
335
  getFilePathsFromEvent: () => getFilePathsFromEvent,
336
+ getLocationHierarchy: () => getLocationHierarchy,
319
337
  getMixedPath: () => getMixedPath,
320
338
  getPendingAction: () => getPendingAction,
321
339
  getPrintCertificatePages: () => getPrintCertificatePages,
@@ -336,6 +354,7 @@ __export(events_exports, {
336
354
  isBulletListFieldType: () => isBulletListFieldType,
337
355
  isButtonFieldType: () => isButtonFieldType,
338
356
  isCheckboxFieldType: () => isCheckboxFieldType,
357
+ isCodeToEvaluate: () => isCodeToEvaluate,
339
358
  isConditionMet: () => isConditionMet,
340
359
  isCountryFieldType: () => isCountryFieldType,
341
360
  isCustomFieldType: () => isCustomFieldType,
@@ -376,6 +395,7 @@ __export(events_exports, {
376
395
  isPageVisible: () => isPageVisible,
377
396
  isParagraphFieldType: () => isParagraphFieldType,
378
397
  isPhoneFieldType: () => isPhoneFieldType,
398
+ isPotentialDuplicate: () => isPotentialDuplicate,
379
399
  isPrintButtonFieldType: () => isPrintButtonFieldType,
380
400
  isQrReaderFieldType: () => isQrReaderFieldType,
381
401
  isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -409,12 +429,15 @@ __export(events_exports, {
409
429
  plainDateToLocalDate: () => plainDateToLocalDate,
410
430
  precompileActionSchemas: () => precompileActionSchemas,
411
431
  resolveDateOfEvent: () => resolveDateOfEvent,
432
+ resolveEventCustomFlags: () => resolveEventCustomFlags,
412
433
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
434
+ runClientFunction: () => runClientFunction,
413
435
  runFieldValidations: () => runFieldValidations,
414
436
  runStructuralValidations: () => runStructuralValidations,
415
437
  safeUnion: () => safeUnion,
416
438
  status: () => status,
417
439
  timePeriodToDateRange: () => timePeriodToDateRange,
440
+ todayISO: () => todayISO,
418
441
  user: () => user,
419
442
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
420
443
  validate: () => validate,
@@ -489,6 +512,10 @@ var scopeByEvent = z2.preprocess(
489
512
  (val) => val === void 0 ? void 0 : [val].flat(),
490
513
  z2.array(z2.string()).optional()
491
514
  ).describe("Event type, e.g. birth, death");
515
+ var userRole = z2.preprocess(
516
+ (val) => val === void 0 ? void 0 : [val].flat(),
517
+ z2.array(z2.string()).optional()
518
+ ).describe("User role, e.g. admin, field agent");
492
519
  var scopeOptionsPlaceEvent = z2.object({
493
520
  event: scopeByEvent,
494
521
  placeOfEvent: JurisdictionFilter.optional()
@@ -512,6 +539,9 @@ var CustomActionScopeOptions = AllRecordScopeOptions.extend({
512
539
  var AccessLevelOptions = z2.object({
513
540
  accessLevel: JurisdictionFilter.optional()
514
541
  });
542
+ var AllUserScopeOptions = AccessLevelOptions.extend({
543
+ role: userRole.optional()
544
+ });
515
545
  var WorkqueueOrDashboardOptions = z2.object({
516
546
  ids: z2.preprocess(
517
547
  (val) => val === void 0 ? void 0 : [val].flat(),
@@ -521,6 +551,7 @@ var WorkqueueOrDashboardOptions = z2.object({
521
551
  var AllScopeOptions = z2.object({
522
552
  ...AllRecordScopeOptions.shape,
523
553
  ...AccessLevelOptions.shape,
554
+ ...AllUserScopeOptions.shape,
524
555
  ...WorkqueueOrDashboardOptions.shape
525
556
  });
526
557
  var ScopeOptionKey = AllScopeOptions.keyof();
@@ -593,6 +624,33 @@ var RecordScopeV2 = z2.discriminatedUnion("type", [
593
624
  ]).describe(
594
625
  "Scopes used to check user's permission to perform actions on a record."
595
626
  );
627
+ var SystemScopeType = z2.enum([
628
+ "organisation.read-locations",
629
+ "user.read",
630
+ "user.create",
631
+ "user.edit",
632
+ "user.search"
633
+ ]);
634
+ var UserScopeType = SystemScopeType.extract([
635
+ "user.read",
636
+ "user.create",
637
+ "user.edit",
638
+ "user.search"
639
+ ]);
640
+ var ScopesWithRoleOption = UserScopeType.extract(["user.edit", "user.create"]);
641
+ var UserScopeV2 = z2.discriminatedUnion("type", [
642
+ z2.object({
643
+ type: ScopesWithRoleOption,
644
+ options: AllUserScopeOptions.optional()
645
+ }),
646
+ z2.object({
647
+ type: UserScopeType.extract(["user.read", "user.search"]),
648
+ options: AccessLevelOptions.optional()
649
+ })
650
+ ]);
651
+ function scopeUsesRoleOptions(scope) {
652
+ return ScopesWithRoleOption?.options.some((opt) => opt === scope.type);
653
+ }
596
654
  function scopeUsesDeclaredOptions(scope) {
597
655
  return !ScopesWithPlaceEventOptions.options.some((opt) => opt === scope.type);
598
656
  }
@@ -625,16 +683,14 @@ var ResolvedRecordScopeV2 = z2.discriminatedUnion("type", [
625
683
  }).optional()
626
684
  })
627
685
  ]).describe("Resolved scope with location/user IDs instead of filters.");
628
- var SystemScopeType = z2.enum([
629
- "organisation.read-locations",
630
- "user.read",
631
- "user.create",
632
- "user.edit"
633
- ]);
634
686
  var Scope = z2.discriminatedUnion("type", [
635
687
  z2.object({ type: PlainScopeType }),
636
688
  ...RecordScopeV2.options,
637
- z2.object({ type: SystemScopeType, options: AccessLevelOptions.optional() }),
689
+ ...UserScopeV2.options,
690
+ z2.object({
691
+ type: z2.literal("organisation.read-locations"),
692
+ options: AccessLevelOptions.optional()
693
+ }),
638
694
  z2.object({
639
695
  type: z2.literal("workqueue"),
640
696
  options: WorkqueueOrDashboardOptions
@@ -656,18 +712,26 @@ var unflattenScope = (input) => {
656
712
  return { type, options };
657
713
  };
658
714
  var EncodedScope = z2.string().brand("EncodedScope");
659
- var decodeScope = (query) => {
660
- 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, {
661
721
  ignoreQueryPrefix: true,
662
722
  comma: true,
663
723
  allowDots: true
664
724
  });
665
725
  const unflattenedScope = unflattenScope(scope);
666
- return Scope.safeParse(unflattenedScope)?.data;
726
+ const result = Scope.safeParse(unflattenedScope)?.data;
727
+ decodedScopeCache.set(encodedScope, result);
728
+ return result;
667
729
  };
668
730
  var DEFAULT_SCOPE_OPTIONS = {
669
731
  placeOfEvent: JurisdictionFilter.enum.all,
670
- accessLevel: JurisdictionFilter.enum.all
732
+ accessLevel: JurisdictionFilter.enum.all,
733
+ registeredIn: JurisdictionFilter.enum.all,
734
+ declaredIn: JurisdictionFilter.enum.all
671
735
  };
672
736
  function getAcceptedScopesByType({
673
737
  acceptedScopes,
@@ -1040,7 +1104,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1040
1104
  ShowConditional,
1041
1105
  // Action can be shown to the user in the list but as disabled
1042
1106
  EnableConditional
1043
- ]);
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
+ });
1044
1111
  var DisplayOnReviewConditional = z7.object({
1045
1112
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1046
1113
  conditional: Conditional
@@ -1055,8 +1122,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1055
1122
  // Field output can be shown / hidden on the review page
1056
1123
  DisplayOnReviewConditional
1057
1124
  ]).meta({
1058
- description: "Field conditional configuration",
1059
- 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."
1060
1127
  });
1061
1128
 
1062
1129
  // ../commons/src/events/FieldType.ts
@@ -1153,6 +1220,11 @@ var FieldTypesToHideInReview = [
1153
1220
  FieldType.ALPHA_PRINT_BUTTON,
1154
1221
  FieldType.ALPHA_HIDDEN
1155
1222
  ];
1223
+ var HiddenFieldTypes = [
1224
+ FieldType.HTTP,
1225
+ FieldType.QUERY_PARAM_READER,
1226
+ FieldType.ALPHA_HIDDEN
1227
+ ];
1156
1228
 
1157
1229
  // ../commons/src/events/FieldValue.ts
1158
1230
  var z12 = __toESM(require("zod/v4"));
@@ -1279,7 +1351,7 @@ function plainDateToLocalDate(date) {
1279
1351
  // ../commons/src/events/FieldValue.ts
1280
1352
  var TextValue = z12.string();
1281
1353
  var HiddenFieldValue = z12.string();
1282
- var NonEmptyTextValue = TextValue.min(1);
1354
+ var NonEmptyTextValue = z12.string().trim().min(1);
1283
1355
  var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
1284
1356
  var AgeValue = z12.object({
1285
1357
  age: z12.number(),
@@ -1308,6 +1380,7 @@ var DateRangeFieldValue = z12.object({
1308
1380
  var EmailValue = z12.email();
1309
1381
  var CheckboxFieldValue = z12.boolean();
1310
1382
  var NumberFieldValue = z12.number();
1383
+ var SignatureFieldValue = FileFieldValue;
1311
1384
  var ButtonFieldValue = z12.number();
1312
1385
  var VerificationStatusValue = z12.enum([
1313
1386
  "verified",
@@ -1376,28 +1449,20 @@ function schemaPriority(schema) {
1376
1449
  return idx === -1 ? 9999 : idx;
1377
1450
  }
1378
1451
  function safeUnion(schemas) {
1452
+ const sortedSchemas = [...schemas].sort(
1453
+ (a, b) => schemaPriority(a) - schemaPriority(b)
1454
+ );
1379
1455
  return z12.any().superRefine((val, ctx) => {
1380
- const successful = schemas.filter((s) => s.safeParse(val).success);
1381
- if (successful.length === 1) {
1382
- return;
1383
- }
1384
- if (successful.length === 0) {
1385
- ctx.addIssue({
1386
- code: "invalid_type",
1387
- expected: "custom",
1388
- message: "Value does not match any schema"
1389
- });
1390
- return;
1391
- }
1392
- successful.sort((a, b) => schemaPriority(a) - schemaPriority(b));
1393
- const best = successful[0];
1394
- if (!best.safeParse(val).success) {
1395
- ctx.addIssue({
1396
- expected: "custom",
1397
- code: "invalid_type",
1398
- message: "Value did not match the best schema"
1399
- });
1456
+ for (const schema of sortedSchemas) {
1457
+ if (schema.safeParse(val).success) {
1458
+ return;
1459
+ }
1400
1460
  }
1461
+ ctx.addIssue({
1462
+ code: "invalid_type",
1463
+ expected: "custom",
1464
+ message: "Value does not match any schema"
1465
+ });
1401
1466
  }).meta({
1402
1467
  description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
1403
1468
  });
@@ -1614,8 +1679,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1614
1679
  var ApprovedCorrectionAction = ActionBase.extend(
1615
1680
  z14.object({
1616
1681
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1617
- requestId: z14.string()
1682
+ requestId: z14.string(),
1618
1683
  // TODO move into 'content' property
1684
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1619
1685
  }).shape
1620
1686
  );
1621
1687
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1707,6 +1773,9 @@ var FlagConfig = z15.object({
1707
1773
  "Indicates if this flag expects an action to be performed to be cleared."
1708
1774
  ),
1709
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."
1710
1779
  });
1711
1780
  var ActionFlagConfig = z15.object({
1712
1781
  id: Flag,
@@ -1714,6 +1783,9 @@ var ActionFlagConfig = z15.object({
1714
1783
  conditional: Conditional.optional().describe(
1715
1784
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1716
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."
1717
1789
  });
1718
1790
 
1719
1791
  // ../commons/src/events/EventMetadata.ts
@@ -1735,8 +1807,7 @@ var ActionCreationMetadata = z16.object({
1735
1807
  ),
1736
1808
  createdByUserType: z16.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
1737
1809
  acceptedAt: z16.iso.datetime().describe("Timestamp when the action request was accepted."),
1738
- createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation."),
1739
- createdBySignature: z16.string().nullish().describe("Signature of the user who created the action request.")
1810
+ createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation.")
1740
1811
  });
1741
1812
  var RegistrationCreationMetadata = ActionCreationMetadata.extend({
1742
1813
  registrationNumber: z16.string().describe(
@@ -1764,9 +1835,6 @@ var EventMetadata = z16.object({
1764
1835
  createdAtLocation: UUID.nullish().describe(
1765
1836
  "Location of the user who created the event."
1766
1837
  ),
1767
- createdBySignature: DocumentPath.nullish().describe(
1768
- "Signature of the user who created the event."
1769
- ),
1770
1838
  updatedAtLocation: UUID.nullish().describe(
1771
1839
  "Location of the user who last changed the status."
1772
1840
  ),
@@ -1955,7 +2023,8 @@ var Range = import_v4.z.object({
1955
2023
  });
1956
2024
  var ContainsFlags = import_v4.z.object({
1957
2025
  anyOf: import_v4.z.array(Flag).optional(),
1958
- noneOf: import_v4.z.array(Flag).optional()
2026
+ noneOf: import_v4.z.array(Flag).optional(),
2027
+ allOf: import_v4.z.array(Flag).optional()
1959
2028
  }).meta({
1960
2029
  id: "ContainsFlags"
1961
2030
  });
@@ -2141,14 +2210,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2141
2210
  }
2142
2211
  }).describe("Unique identifier for the field");
2143
2212
  var FieldReference = import_v43.default.object({
2144
- $$field: FieldId,
2213
+ $$field: FieldId.describe("Id of the field to reference"),
2145
2214
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2146
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."
2219
+ )
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."
2147
2229
  )
2148
- }).describe("Reference to a field by its ID");
2230
+ }).describe("A context-only computation used as a field default value.");
2149
2231
  var ValidationConfig = import_v43.default.object({
2150
- validator: Conditional,
2151
- 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."
2152
2241
  });
2153
2242
  var requiredSchema = import_v43.default.union([
2154
2243
  import_v43.default.boolean(),
@@ -2179,7 +2268,7 @@ var BaseField = import_v43.default.object({
2179
2268
  "Indicates whether the field can be modified during record correction."
2180
2269
  ),
2181
2270
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2182
- "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."
2183
2272
  ),
2184
2273
  analytics: import_v43.default.boolean().default(false).optional().describe(
2185
2274
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2187,30 +2276,40 @@ var BaseField = import_v43.default.object({
2187
2276
  }).describe("Common properties shared across all field types.");
2188
2277
  var Divider = BaseField.extend({
2189
2278
  type: import_v43.default.literal(FieldType.DIVIDER)
2279
+ }).meta({
2280
+ description: "A horizontal line divider",
2281
+ id: "Divider"
2190
2282
  });
2191
2283
  var TextField = BaseField.extend({
2192
2284
  type: import_v43.default.literal(FieldType.TEXT),
2193
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2285
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2194
2286
  configuration: import_v43.default.object({
2195
2287
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2196
2288
  type: import_v43.default.enum(["text", "password"]).optional(),
2197
2289
  prefix: TranslationConfig.optional(),
2198
2290
  postfix: TranslationConfig.optional()
2199
2291
  }).default({ type: "text" }).optional()
2200
- }).describe("Text input");
2292
+ }).meta({
2293
+ description: "A text input field",
2294
+ id: "TextField"
2295
+ });
2201
2296
  var NumberField = BaseField.extend({
2202
2297
  type: import_v43.default.literal(FieldType.NUMBER),
2203
- defaultValue: NumberFieldValue.optional(),
2298
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2204
2299
  configuration: import_v43.default.object({
2205
2300
  min: import_v43.default.number().optional().describe("Minimum value"),
2206
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"),
2207
2303
  prefix: TranslationConfig.optional(),
2208
2304
  postfix: TranslationConfig.optional()
2209
2305
  }).optional()
2210
- }).describe("Number input");
2306
+ }).meta({
2307
+ description: "A number input field",
2308
+ id: "NumberField"
2309
+ });
2211
2310
  var TextAreaField = BaseField.extend({
2212
2311
  type: import_v43.default.literal(FieldType.TEXTAREA),
2213
- defaultValue: NonEmptyTextValue.optional(),
2312
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2214
2313
  configuration: import_v43.default.object({
2215
2314
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2216
2315
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2218,7 +2317,10 @@ var TextAreaField = BaseField.extend({
2218
2317
  prefix: TranslationConfig.optional(),
2219
2318
  postfix: TranslationConfig.optional()
2220
2319
  }).default({ rows: 4 }).optional()
2221
- }).describe("Multiline text input");
2320
+ }).meta({
2321
+ description: "A multiline text input",
2322
+ id: "TextAreaField"
2323
+ });
2222
2324
  var ImageMimeType = import_v43.default.enum([
2223
2325
  "image/png",
2224
2326
  "image/jpg",
@@ -2241,58 +2343,76 @@ var SignatureField = BaseField.extend({
2241
2343
  signaturePromptLabel: TranslationConfig.describe(
2242
2344
  "Title of the signature modal"
2243
2345
  ),
2244
- defaultValue: FieldValue.optional(),
2346
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2245
2347
  configuration: import_v43.default.object({
2246
2348
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2247
2349
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2248
2350
  }).default({
2249
2351
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2250
2352
  })
2251
- }).describe("Signature input field");
2353
+ }).meta({
2354
+ description: "A signature input field",
2355
+ id: "SignatureField"
2356
+ });
2252
2357
  var EmailField = BaseField.extend({
2253
2358
  type: import_v43.default.literal(FieldType.EMAIL),
2254
2359
  configuration: import_v43.default.object({
2255
2360
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2256
2361
  }).default({ maxLength: 255 }).optional(),
2257
- defaultValue: NonEmptyTextValue.optional()
2362
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2363
+ }).meta({
2364
+ description: "An email input field",
2365
+ id: "EmailField"
2258
2366
  });
2259
2367
  var DateField = BaseField.extend({
2260
2368
  type: import_v43.default.literal(FieldType.DATE),
2261
- 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)"),
2262
2370
  configuration: import_v43.default.object({
2263
2371
  notice: TranslationConfig.describe(
2264
2372
  "Text to display above the date input"
2265
2373
  ).optional()
2266
2374
  }).optional()
2267
- }).describe("A single date input (yyyy-MM-dd)");
2375
+ }).meta({
2376
+ description: "A date input (yyyy-MM-dd)",
2377
+ id: "DateField"
2378
+ });
2268
2379
  var AgeField = BaseField.extend({
2269
2380
  type: import_v43.default.literal(FieldType.AGE),
2270
- defaultValue: NumberFieldValue.optional(),
2381
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2271
2382
  configuration: import_v43.default.object({
2272
2383
  asOfDate: FieldReference,
2273
2384
  prefix: TranslationConfig.optional(),
2274
2385
  postfix: TranslationConfig.optional()
2275
2386
  })
2276
- }).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
+ });
2277
2391
  var TimeField = BaseField.extend({
2278
2392
  type: import_v43.default.literal(FieldType.TIME),
2279
- 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)"),
2280
2394
  configuration: import_v43.default.object({
2281
2395
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2282
2396
  notice: TranslationConfig.describe(
2283
2397
  "Text to display above the time input"
2284
2398
  ).optional()
2285
2399
  }).optional()
2286
- }).describe("A single date input (HH-mm)");
2400
+ }).meta({
2401
+ description: "A single time input (HH-mm)",
2402
+ id: "TimeField"
2403
+ });
2287
2404
  var DateRangeField = BaseField.extend({
2288
2405
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2289
- defaultValue: DateRangeFieldValue.optional(),
2406
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2290
2407
  configuration: import_v43.default.object({
2291
2408
  notice: TranslationConfig.describe(
2292
2409
  "Text to display above the date input"
2293
2410
  ).optional()
2294
2411
  }).optional()
2295
- }).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
+ });
2296
2416
  var HtmlFontVariant = import_v43.default.enum([
2297
2417
  "reg12",
2298
2418
  "reg14",
@@ -2336,21 +2456,33 @@ var ImageViewField = BaseField.extend({
2336
2456
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2337
2457
  defaultValue: NonEmptyTextValue.optional(),
2338
2458
  configuration: ImageConfiguration
2339
- }).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
+ });
2340
2463
  var Paragraph = BaseField.extend({
2341
2464
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2342
2465
  configuration: ParagraphConfiguration
2343
- }).describe("A read-only HTML <p> paragraph");
2466
+ }).meta({
2467
+ description: "A read-only HTML <p> paragraph",
2468
+ id: "Paragraph"
2469
+ });
2344
2470
  var Heading = BaseField.extend({
2345
2471
  type: import_v43.default.literal(FieldType.HEADING),
2346
2472
  configuration: HeadingConfiguration
2347
- }).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
+ });
2348
2477
  var PageHeader = BaseField.extend({
2349
2478
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2350
- }).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
+ });
2351
2483
  var File = BaseField.extend({
2352
2484
  type: import_v43.default.literal(FieldType.FILE),
2353
- defaultValue: FileFieldValue.optional(),
2485
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2354
2486
  configuration: import_v43.default.object({
2355
2487
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2356
2488
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2366,7 +2498,10 @@ var File = BaseField.extend({
2366
2498
  }).default({
2367
2499
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2368
2500
  })
2369
- }).describe("File upload");
2501
+ }).meta({
2502
+ description: "A file upload field",
2503
+ id: "File"
2504
+ });
2370
2505
  var SelectOption = import_v43.default.object({
2371
2506
  value: import_v43.default.string().describe("The value of the option"),
2372
2507
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2374,7 +2509,7 @@ var SelectOption = import_v43.default.object({
2374
2509
  });
2375
2510
  var NumberWithUnitField = BaseField.extend({
2376
2511
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2377
- defaultValue: NumberWithUnitFieldValue.optional(),
2512
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2378
2513
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2379
2514
  configuration: import_v43.default.object({
2380
2515
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2383,17 +2518,23 @@ var NumberWithUnitField = BaseField.extend({
2383
2518
  "Placeholder for the number field"
2384
2519
  )
2385
2520
  }).optional()
2386
- }).describe("Number with unit input");
2521
+ }).meta({
2522
+ description: "A number with unit input field",
2523
+ id: "NumberWithUnitField"
2524
+ });
2387
2525
  var RadioGroup = BaseField.extend({
2388
2526
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2389
- defaultValue: TextValue.optional(),
2527
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2390
2528
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2391
2529
  configuration: import_v43.default.object({
2392
2530
  styles: import_v43.default.object({
2393
2531
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2394
2532
  }).optional()
2395
2533
  }).optional()
2396
- }).describe("Grouped radio options");
2534
+ }).meta({
2535
+ description: "A grouped radio button field",
2536
+ id: "RadioGroup"
2537
+ });
2397
2538
  var BulletList = BaseField.extend({
2398
2539
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2399
2540
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2402,10 +2543,13 @@ var BulletList = BaseField.extend({
2402
2543
  fontVariant: HtmlFontVariant.optional()
2403
2544
  }).optional()
2404
2545
  }).default({})
2405
- }).describe("A list of bullet points");
2546
+ }).meta({
2547
+ description: "A list of bullet points",
2548
+ id: "BulletList"
2549
+ });
2406
2550
  var Select = BaseField.extend({
2407
2551
  type: import_v43.default.literal(FieldType.SELECT),
2408
- defaultValue: TextValue.optional(),
2552
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2409
2553
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2410
2554
  noOptionsMessage: TranslationConfig.optional().describe(
2411
2555
  `
@@ -2417,16 +2561,22 @@ var Select = BaseField.extend({
2417
2561
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2418
2562
  `
2419
2563
  )
2420
- }).describe("Select input");
2564
+ }).meta({
2565
+ description: "A select input field",
2566
+ id: "Select"
2567
+ });
2421
2568
  var SelectDateRangeOption = import_v43.default.object({
2422
2569
  value: SelectDateRangeValue.describe("The value of the option"),
2423
2570
  label: TranslationConfig.describe("The label of the option")
2424
2571
  });
2425
2572
  var SelectDateRangeField = BaseField.extend({
2426
2573
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2427
- defaultValue: SelectDateRangeValue.optional(),
2574
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2428
2575
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2429
- }).describe("Select input with date range options");
2576
+ }).meta({
2577
+ description: "A date range selection field",
2578
+ id: "SelectDateRangeField"
2579
+ });
2430
2580
  var NameConfig = import_v43.default.object({
2431
2581
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2432
2582
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2438,7 +2588,7 @@ var NameField = BaseField.extend({
2438
2588
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2439
2589
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2440
2590
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2441
- }).optional(),
2591
+ }).or(ComputedDefaultValue).optional(),
2442
2592
  configuration: import_v43.default.object({
2443
2593
  name: NameConfig.default({
2444
2594
  firstname: { required: true },
@@ -2457,26 +2607,41 @@ var NameField = BaseField.extend({
2457
2607
  surname: { required: true }
2458
2608
  }
2459
2609
  }).optional()
2460
- }).describe("Name input field");
2610
+ }).meta({
2611
+ description: "A field for entering a persons name",
2612
+ id: "NameField"
2613
+ });
2461
2614
  var PhoneField = BaseField.extend({
2462
- defaultValue: NonEmptyTextValue.optional(),
2615
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2463
2616
  type: import_v43.default.literal(FieldType.PHONE)
2464
- }).describe("Phone input field");
2617
+ }).meta({
2618
+ description: "A field for entering a phone number",
2619
+ id: "PhoneField"
2620
+ });
2465
2621
  var IdField = BaseField.extend({
2466
- defaultValue: NonEmptyTextValue.optional(),
2622
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2467
2623
  type: import_v43.default.literal(FieldType.ID)
2468
- }).describe("ID input field");
2624
+ }).meta({
2625
+ description: "A field for entering an ID",
2626
+ id: "IdField"
2627
+ });
2469
2628
  var Checkbox = BaseField.extend({
2470
2629
  type: import_v43.default.literal(FieldType.CHECKBOX),
2471
- defaultValue: CheckboxFieldValue.default(false)
2472
- }).describe("Boolean checkbox field");
2630
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2631
+ }).meta({
2632
+ description: "A boolean checkbox field",
2633
+ id: "Checkbox"
2634
+ });
2473
2635
  var Country = BaseField.extend({
2474
2636
  type: import_v43.default.literal(FieldType.COUNTRY),
2475
- defaultValue: NonEmptyTextValue.optional(),
2637
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2476
2638
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2477
2639
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2478
2640
  )
2479
- }).describe("Country select field");
2641
+ }).meta({
2642
+ description: "A field for selecting a country",
2643
+ id: "Country"
2644
+ });
2480
2645
  var AllowedLocations = JurisdictionReference.optional().describe(
2481
2646
  "Limits which location options are selectable depending on user jurisdiction and location."
2482
2647
  );
@@ -2485,28 +2650,33 @@ var AdministrativeAreas = import_v43.default.enum([
2485
2650
  "HEALTH_FACILITY",
2486
2651
  "CRVS_OFFICE"
2487
2652
  ]);
2488
- var AdministrativeAreaConfiguration = import_v43.default.object({
2489
- partOf: FieldReference.optional().describe("Parent location"),
2490
- type: AdministrativeAreas,
2491
- allowedLocations: AllowedLocations
2492
- }).describe("Administrative area options");
2493
2653
  var AdministrativeAreaField = BaseField.extend({
2494
2654
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2495
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2496
- configuration: AdministrativeAreaConfiguration
2497
- }).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
+ });
2498
2665
  var LocationInput = BaseField.extend({
2499
2666
  type: import_v43.default.literal(FieldType.LOCATION),
2500
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2667
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2501
2668
  configuration: import_v43.default.object({
2502
2669
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2503
2670
  allowedLocations: AllowedLocations
2504
2671
  }).optional()
2505
- }).describe("Input field for a location");
2672
+ }).meta({
2673
+ description: "A field for selecting a location",
2674
+ id: "LocationInput"
2675
+ });
2506
2676
  var FileUploadWithOptions = BaseField.extend({
2507
2677
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2508
2678
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2509
- defaultValue: FileFieldWithOptionValue.optional(),
2679
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2510
2680
  configuration: import_v43.default.object({
2511
2681
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2512
2682
  maxImageSize: import_v43.default.object({
@@ -2516,15 +2686,18 @@ var FileUploadWithOptions = BaseField.extend({
2516
2686
  }).default({
2517
2687
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2518
2688
  })
2689
+ }).meta({
2690
+ description: "A field for uploading files with file type options",
2691
+ id: "FileUploadWithOptions"
2519
2692
  });
2520
2693
  var Facility = BaseField.extend({
2521
2694
  type: import_v43.default.literal(FieldType.FACILITY),
2522
- defaultValue: NonEmptyTextValue.optional(),
2695
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2523
2696
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2524
2697
  }).describe("Input field for a facility");
2525
2698
  var Office = BaseField.extend({
2526
2699
  type: import_v43.default.literal(FieldType.OFFICE),
2527
- defaultValue: NonEmptyTextValue.optional(),
2700
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2528
2701
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2529
2702
  }).describe("Input field for an office");
2530
2703
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2560,8 +2733,11 @@ var Address = BaseField.extend({
2560
2733
  ).optional(),
2561
2734
  allowedLocations: AllowedLocations
2562
2735
  }).optional(),
2563
- defaultValue: DefaultAddressFieldValue.optional()
2564
- }).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
+ });
2565
2741
  var StaticDataEntry = import_v43.default.object({
2566
2742
  id: import_v43.default.string().describe("ID for the data entry."),
2567
2743
  label: TranslationConfig,
@@ -2576,7 +2752,10 @@ var DataField = BaseField.extend({
2576
2752
  subtitle: TranslationConfig.optional(),
2577
2753
  data: import_v43.default.array(DataEntry)
2578
2754
  })
2579
- }).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
+ });
2580
2759
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2581
2760
  var ButtonType = import_v43.default.enum([
2582
2761
  "primary",
@@ -2601,13 +2780,19 @@ var ButtonConfiguration = import_v43.default.object({
2601
2780
  });
2602
2781
  var ButtonField = BaseField.extend({
2603
2782
  type: import_v43.default.literal(FieldType.BUTTON),
2604
- defaultValue: ButtonFieldValue.optional(),
2783
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2605
2784
  configuration: ButtonConfiguration
2606
- }).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
+ });
2607
2789
  var FieldGroup = BaseField.extend({
2608
2790
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2609
2791
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2610
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"
2611
2796
  });
2612
2797
  var AlphaPrintButton = BaseField.extend({
2613
2798
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2617,10 +2802,13 @@ var AlphaPrintButton = BaseField.extend({
2617
2802
  "Label for the print button"
2618
2803
  )
2619
2804
  })
2620
- }).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
+ });
2621
2809
  var HttpField = BaseField.extend({
2622
2810
  type: import_v43.default.literal(FieldType.HTTP),
2623
- defaultValue: HttpFieldValue.optional(),
2811
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2624
2812
  configuration: import_v43.default.object({
2625
2813
  trigger: FieldReference.optional().describe(
2626
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."
@@ -2633,20 +2821,30 @@ var HttpField = BaseField.extend({
2633
2821
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2634
2822
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2635
2823
  })
2636
- }).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
+ });
2637
2828
  var AutocompleteField = BaseField.extend({
2638
2829
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2639
2830
  configuration: import_v43.default.object({
2640
- 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(),
2641
2834
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2642
2835
  defaultOptions: import_v43.default.array(
2643
2836
  import_v43.default.object({
2644
2837
  label: import_v43.default.string(),
2645
2838
  value: import_v43.default.string()
2646
2839
  })
2647
- ).optional()
2840
+ ).optional().describe(
2841
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2842
+ )
2648
2843
  })
2649
- }).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
+ });
2650
2848
  var SearchField = HttpField.extend({
2651
2849
  type: import_v43.default.literal(FieldType.SEARCH),
2652
2850
  configuration: SearchQuery.pick({
@@ -2679,6 +2877,9 @@ var SearchField = HttpField.extend({
2679
2877
  ok: TranslationConfig.optional()
2680
2878
  }).optional()
2681
2879
  })
2880
+ }).meta({
2881
+ description: "A search input field",
2882
+ id: "SearchField"
2682
2883
  });
2683
2884
  var LinkButtonField = BaseField.extend({
2684
2885
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2687,28 +2888,35 @@ var LinkButtonField = BaseField.extend({
2687
2888
  text: TranslationConfig.describe("Text to display on the button"),
2688
2889
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2689
2890
  })
2690
- }).describe("Button that opens a link");
2891
+ }).meta({
2892
+ description: "A button that opens a URL link",
2893
+ id: "LinkButtonField"
2894
+ });
2691
2895
  var VerificationStatus = BaseField.extend({
2692
2896
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2693
- defaultValue: VerificationStatusValue.optional(),
2897
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2694
2898
  configuration: import_v43.default.object({
2695
2899
  status: TranslationConfig.describe("Text to display on the status pill."),
2696
2900
  description: TranslationConfig.describe(
2697
2901
  "Explaining text on the banner in form."
2698
2902
  )
2699
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"
2700
2907
  });
2701
2908
  var QueryParamReaderField = BaseField.extend({
2702
2909
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2703
2910
  configuration: import_v43.default.object({
2704
2911
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2705
2912
  })
2706
- }).describe(
2707
- "A field that maps URL query params into form values and clears them afterward"
2708
- );
2913
+ }).meta({
2914
+ description: "A field that maps URL query params into form values and clears them afterward",
2915
+ id: "QueryParamReaderField"
2916
+ });
2709
2917
  var QrReaderField = BaseField.extend({
2710
2918
  type: import_v43.default.literal(FieldType.QR_READER),
2711
- defaultValue: QrReaderFieldValue.optional(),
2919
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2712
2920
  configuration: import_v43.default.object({
2713
2921
  validator: import_v43.default.any().meta({
2714
2922
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2716,21 +2924,27 @@ var QrReaderField = BaseField.extend({
2716
2924
  })
2717
2925
  }).optional()
2718
2926
  }).meta({
2719
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2927
+ description: "QR code reader field, including optional JSON Schema validator.",
2720
2928
  id: "QrReaderField"
2721
2929
  });
2722
2930
  var IdReaderField = BaseField.extend({
2723
2931
  type: import_v43.default.literal(FieldType.ID_READER),
2724
- defaultValue: IdReaderFieldValue.optional(),
2932
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2725
2933
  methods: import_v43.default.array(
2726
2934
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2727
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"
2728
2939
  });
2729
2940
  var CustomField = BaseField.extend({
2730
2941
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2731
2942
  defaultValue: CustomFieldValue.optional(),
2732
2943
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2733
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"
2734
2948
  });
2735
2949
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2736
2950
  var LoaderField = BaseField.extend({
@@ -2740,22 +2954,25 @@ var LoaderField = BaseField.extend({
2740
2954
  configuration: import_v43.default.object({
2741
2955
  text: TranslationConfig.describe("Display text above the loading spinner")
2742
2956
  })
2743
- }).describe(
2744
- "A non-interactive field that indicates an in progress operation in form"
2745
- );
2957
+ }).meta({
2958
+ description: "A non-interactive field that indicates an in progress operation in form",
2959
+ id: "LoaderField"
2960
+ });
2746
2961
  var HiddenField = BaseField.extend({
2747
2962
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2748
2963
  required: import_v43.default.boolean().default(false).optional(),
2749
2964
  defaultValue: TextValue.optional()
2750
- }).describe(
2751
- "A non-interactive, hidden field that only hold a value in the form"
2752
- );
2965
+ }).meta({
2966
+ description: "A non-interactive, hidden field that only hold a value in the form",
2967
+ id: "HiddenField"
2968
+ });
2753
2969
  var UserRoleField = BaseField.extend({
2754
2970
  type: import_v43.default.literal(FieldType.USER_ROLE),
2755
2971
  defaultValue: TextValue.optional()
2756
- }).describe(
2757
- "A select dropdown that is automatically populated with available user roles"
2758
- );
2972
+ }).meta({
2973
+ description: "A select dropdown that is automatically populated with available user roles",
2974
+ id: "UserRoleField"
2975
+ });
2759
2976
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2760
2977
  FieldGroup,
2761
2978
  Address,
@@ -2854,16 +3071,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2854
3071
  type: z21.literal(PageTypes.enum.VERIFICATION),
2855
3072
  actions: VerificationActionConfig
2856
3073
  });
2857
- var PageConfig = z21.discriminatedUnion("type", [
2858
- FormPageConfig,
2859
- VerificationPageConfig
2860
- ]);
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
+ });
2861
3078
 
2862
3079
  // ../commons/src/events/FormConfig.ts
2863
3080
  var DeclarationFormConfig = z22.object({
2864
3081
  label: TranslationConfig.describe("Human readable description of the form"),
2865
3082
  pages: z22.array(FormPageConfig)
2866
- }).describe("Configuration of the declaration form.");
3083
+ }).meta({
3084
+ id: "DeclarationFormConfig",
3085
+ description: "Configuration of the declaration form."
3086
+ });
2867
3087
  var ActionFormConfig = z22.object({
2868
3088
  label: TranslationConfig.describe("Human readable description of the form"),
2869
3089
  pages: z22.array(PageConfig)
@@ -2963,6 +3183,9 @@ var DeduplicationConfig = z23.object({
2963
3183
  id: z23.string(),
2964
3184
  label: TranslationConfig,
2965
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."
2966
3189
  });
2967
3190
 
2968
3191
  // ../commons/src/events/ActionConfig.ts
@@ -3000,6 +3223,57 @@ var ReadActionConfig = ActionConfigBase.extend(
3000
3223
  conditionals: z24.never().optional().describe("Read-action can not be disabled or hidden with conditionals.")
3001
3224
  }).shape
3002
3225
  );
3226
+ var NotifyConfig = ActionConfigBase.extend(
3227
+ z24.object({
3228
+ type: z24.literal(ActionType.NOTIFY)
3229
+ }).shape
3230
+ );
3231
+ var DuplicateDetectedConfig = ActionConfigBase.extend(
3232
+ z24.object({
3233
+ type: z24.literal(ActionType.DUPLICATE_DETECTED),
3234
+ label: z24.never().optional().describe(
3235
+ "DUPLICATE_DETECTED is system-generated and never shown as a button, so it has no label."
3236
+ ),
3237
+ supportingCopy: z24.never().optional(),
3238
+ icon: z24.never().optional().describe(
3239
+ "DUPLICATE_DETECTED is system-generated and never shown as a button, so it has no icon."
3240
+ ),
3241
+ conditionals: z24.never().optional().describe(
3242
+ "DUPLICATE_DETECTED is system-generated and never shown as a button, so it cannot be disabled or hidden with conditionals."
3243
+ )
3244
+ }).shape
3245
+ );
3246
+ var MarkAsDuplicateConfig = ActionConfigBase.extend(
3247
+ z24.object({
3248
+ type: z24.literal(ActionType.MARK_AS_DUPLICATE)
3249
+ }).shape
3250
+ );
3251
+ var MarkAsNotDuplicateConfig = ActionConfigBase.extend(
3252
+ z24.object({
3253
+ type: z24.literal(ActionType.MARK_AS_NOT_DUPLICATE)
3254
+ }).shape
3255
+ );
3256
+ var AssignConfig = ActionConfigBase.extend(
3257
+ z24.object({
3258
+ type: z24.literal(ActionType.ASSIGN),
3259
+ flags: z24.never().optional().describe(
3260
+ "ASSIGN is a meta action excluded from flag resolution, so flags configured here would never apply."
3261
+ )
3262
+ }).shape
3263
+ );
3264
+ var UnassignConfig = ActionConfigBase.extend(
3265
+ z24.object({
3266
+ type: z24.literal(ActionType.UNASSIGN),
3267
+ flags: z24.never().optional().describe(
3268
+ "UNASSIGN is a meta action excluded from flag resolution, so flags configured here would never apply."
3269
+ )
3270
+ }).shape
3271
+ );
3272
+ var DeleteConfig = ActionConfigBase.extend(
3273
+ z24.object({
3274
+ type: z24.literal(ActionType.DELETE)
3275
+ }).shape
3276
+ );
3003
3277
  var DeclareConfig = DeclarationActionBase.extend(
3004
3278
  z24.object({
3005
3279
  type: z24.literal(ActionType.DECLARE),
@@ -3062,7 +3336,17 @@ var RequestCorrectionConfig = ActionConfigBase.extend(
3062
3336
  correctionForm: ActionFormConfig
3063
3337
  }).shape
3064
3338
  );
3065
- var CustomActionConfig = ActionConfigBase.merge(
3339
+ var ApproveCorrectionConfig = ActionConfigBase.extend(
3340
+ z24.object({
3341
+ type: z24.literal(ActionType.APPROVE_CORRECTION)
3342
+ }).shape
3343
+ );
3344
+ var RejectCorrectionConfig = ActionConfigBase.extend(
3345
+ z24.object({
3346
+ type: z24.literal(ActionType.REJECT_CORRECTION)
3347
+ }).shape
3348
+ );
3349
+ var CustomActionConfig = ActionConfigBase.extend(
3066
3350
  z24.object({
3067
3351
  type: z24.literal(ActionType.CUSTOM),
3068
3352
  customActionType: z24.string().describe("Type identifier of the custom action."),
@@ -3073,24 +3357,85 @@ var CustomActionConfig = ActionConfigBase.merge(
3073
3357
  auditHistoryLabel: TranslationConfig.describe(
3074
3358
  'The label to show in audit history for this action. For example "Approved".'
3075
3359
  )
3076
- })
3360
+ }).shape
3077
3361
  );
3078
3362
  var ActionConfig = z24.discriminatedUnion("type", [
3079
3363
  /*
3080
3364
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3081
3365
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3082
3366
  */
3083
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3084
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3085
- RejectConfig.meta({ id: "RejectActionConfig" }),
3086
- RegisterConfig.meta({ id: "RegisterActionConfig" }),
3367
+ ReadActionConfig.meta({
3368
+ id: "ReadActionConfig",
3369
+ description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
3370
+ }),
3371
+ AssignConfig.meta({
3372
+ id: "AssignActionConfig",
3373
+ description: "Configuration for assigning a record to the current user."
3374
+ }),
3375
+ UnassignConfig.meta({
3376
+ id: "UnassignActionConfig",
3377
+ description: "Configuration for unassigning a record from its current assignee."
3378
+ }),
3379
+ DeleteConfig.meta({
3380
+ id: "DeleteActionConfig",
3381
+ description: "Configuration for deleting a draft record."
3382
+ }),
3383
+ NotifyConfig.meta({
3384
+ id: "NotifyActionConfig",
3385
+ description: "Configuration for the notify action. When present, NOTIFY uses this config independently from DECLARE. When absent, NOTIFY falls back to the DeclareActionConfig."
3386
+ }),
3387
+ DeclareConfig.meta({
3388
+ id: "DeclareActionConfig",
3389
+ description: "Configuration for the declare action. Includes review-page fields. NOTIFY falls back to this config when no dedicated NotifyActionConfig is provided."
3390
+ }),
3391
+ DuplicateDetectedConfig.meta({
3392
+ id: "DuplicateDetectedActionConfig",
3393
+ description: "Configuration for the system-generated duplicate-detection action. Never shown as a button, so it only supports flags \u2014 not label, icon, or conditionals."
3394
+ }),
3395
+ MarkAsDuplicateConfig.meta({
3396
+ id: "MarkAsDuplicateActionConfig",
3397
+ description: "Configuration for marking a record as a duplicate."
3398
+ }),
3399
+ MarkAsNotDuplicateConfig.meta({
3400
+ id: "MarkAsNotDuplicateActionConfig",
3401
+ description: "Configuration for marking a record as not a duplicate, after it was previously flagged as one."
3402
+ }),
3403
+ RejectConfig.meta({
3404
+ id: "RejectActionConfig",
3405
+ description: "Configuration for rejecting a record before registration."
3406
+ }),
3407
+ RegisterConfig.meta({
3408
+ id: "RegisterActionConfig",
3409
+ description: "Configuration for registering a record."
3410
+ }),
3087
3411
  PrintCertificateActionConfig.meta({
3088
- id: "PrintCertificateActionConfig"
3412
+ id: "PrintCertificateActionConfig",
3413
+ description: "Configuration for printing a certificate of a registered record."
3414
+ }),
3415
+ RequestCorrectionConfig.meta({
3416
+ id: "RequestCorrectionActionConfig",
3417
+ description: "Configuration for requesting a correction on a registered record."
3418
+ }),
3419
+ ApproveCorrectionConfig.meta({
3420
+ id: "ApproveCorrectionActionConfig",
3421
+ description: "Configuration for approving a requested correction."
3422
+ }),
3423
+ RejectCorrectionConfig.meta({
3424
+ id: "RejectCorrectionActionConfig",
3425
+ description: "Configuration for rejecting a requested correction."
3426
+ }),
3427
+ EditActionConfig.meta({
3428
+ id: "EditActionConfig",
3429
+ description: "Configuration for editing a record before registration."
3089
3430
  }),
3090
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3091
- EditActionConfig.meta({ id: "EditActionConfig" }),
3092
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3093
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3431
+ ArchiveConfig.meta({
3432
+ id: "ArchiveActionConfig",
3433
+ description: "Configuration for archiving a record."
3434
+ }),
3435
+ CustomActionConfig.meta({
3436
+ id: "CustomActionConfig",
3437
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3438
+ })
3094
3439
  ]).describe(
3095
3440
  "Configuration of an action available for an event. Data collected depends on the action type and is accessible through the annotation property in ActionDocument."
3096
3441
  ).meta({ id: "ActionConfig" });
@@ -3166,7 +3511,10 @@ var Field = BaseField2.extend({
3166
3511
  }).describe("Custom field defined for the summary view.");
3167
3512
  var SummaryConfig = z27.object({
3168
3513
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3169
- }).describe("Configuration of the event summary section.");
3514
+ }).meta({
3515
+ id: "SummaryConfig",
3516
+ 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."
3517
+ });
3170
3518
 
3171
3519
  // ../commons/src/events/AdvancedSearchConfig.ts
3172
3520
  var z28 = __toESM(require("zod/v4"));
@@ -3237,6 +3585,9 @@ var BaseField3 = z28.object({
3237
3585
  ),
3238
3586
  validations: z28.array(ValidationConfig).optional().describe(
3239
3587
  `Option for overriding the field validations specifically for advanced search form.`
3588
+ ),
3589
+ allowedLocations: JurisdictionReference.optional().describe(
3590
+ `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.`
3240
3591
  )
3241
3592
  });
3242
3593
  var SearchQueryParams = z28.object({
@@ -3290,6 +3641,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3290
3641
  var AdvancedSearchConfig = z28.object({
3291
3642
  title: TranslationConfig.describe("Advanced search tab title"),
3292
3643
  fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
3644
+ }).meta({
3645
+ id: "AdvancedSearchConfig",
3646
+ 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()`)."
3293
3647
  });
3294
3648
 
3295
3649
  // ../commons/src/events/utils.ts
@@ -3308,9 +3662,11 @@ var z30 = __toESM(require("zod/v4"));
3308
3662
  var z29 = __toESM(require("zod/v4"));
3309
3663
  function getDynamicNameValue(field3) {
3310
3664
  const nameConfiguration = field3.configuration?.name;
3665
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3666
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3311
3667
  return z29.object({
3312
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3313
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3668
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3669
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3314
3670
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3315
3671
  });
3316
3672
  }
@@ -3657,7 +4013,7 @@ var isHiddenFieldType = (field3) => {
3657
4013
  return field3.config.type === FieldType.ALPHA_HIDDEN;
3658
4014
  };
3659
4015
  var isNonInteractiveFieldType = (field3) => {
3660
- 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;
4016
+ 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;
3661
4017
  };
3662
4018
 
3663
4019
  // ../commons/src/conditionals/validate.ts
@@ -3693,7 +4049,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3693
4049
  }
3694
4050
  return current;
3695
4051
  }
4052
+ function todayISO() {
4053
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
4054
+ }
4055
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
4056
+ function compileClientFunction(code) {
4057
+ let fn = compiledFunctionCache.get(code);
4058
+ if (!fn) {
4059
+ fn = new Function(`return (${code})`)();
4060
+ compiledFunctionCache.set(code, fn);
4061
+ }
4062
+ return fn;
4063
+ }
3696
4064
  (0, import_ajv_formats.default)(ajv);
4065
+ function buildClientFunctionContext(input) {
4066
+ return {
4067
+ $form: input.form,
4068
+ $now: todayISO(),
4069
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
4070
+ $online: isOnline(),
4071
+ $user: input.validatorContext?.user,
4072
+ $event: input.validatorContext?.event,
4073
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
4074
+ user: input.systemVariables?.user,
4075
+ $window: input.systemVariables?.$window,
4076
+ locations: input.locations,
4077
+ adminLevelIds: input.adminLevelIds
4078
+ };
4079
+ }
4080
+ function runClientFunction(code, data, context) {
4081
+ return compileClientFunction(code)(data, context);
4082
+ }
3697
4083
  ajv.addKeyword({
3698
4084
  keyword: "daysFromDate",
3699
4085
  type: "string",
@@ -3738,7 +4124,7 @@ ajv.addKeyword({
3738
4124
  $data: true,
3739
4125
  errors: true,
3740
4126
  // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
3741
- validate(schema, data, _2, dataContext) {
4127
+ validate(_schema, data, _2, dataContext) {
3742
4128
  const locationIdInput = data;
3743
4129
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3744
4130
  return locations.some((location) => location.id === locationIdInput);
@@ -3766,6 +4152,26 @@ function precompileActionSchemas(eventConfigurations) {
3766
4152
  function isAgeValue(value) {
3767
4153
  return typeof value === "object" && value !== null && "age" in value && typeof value.age === "number";
3768
4154
  }
4155
+ function mergeWithBaseFormState(values, context) {
4156
+ return { ...context.baseFormState, ...values };
4157
+ }
4158
+ ajv.addKeyword({
4159
+ keyword: "customClientValidator",
4160
+ schemaType: "object",
4161
+ errors: true,
4162
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4163
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4164
+ // so the cast holds.
4165
+ validate(schema, data, _2, dataContext) {
4166
+ return Boolean(
4167
+ runClientFunction(
4168
+ schema.code,
4169
+ data,
4170
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4171
+ )
4172
+ );
4173
+ }
4174
+ });
3769
4175
  function validate(schema, data) {
3770
4176
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3771
4177
  if ("$form" in data) {
@@ -3802,17 +4208,14 @@ function isOnline() {
3802
4208
  }
3803
4209
  return true;
3804
4210
  }
3805
- function isConditionMet(conditional, values, context, eventIndex) {
3806
- return validate(conditional, {
3807
- $form: values,
3808
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3809
- $online: isOnline(),
3810
- $user: context.user,
3811
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3812
- $flags: eventIndex?.flags ?? [],
3813
- $status: eventIndex?.status,
3814
- $event: context.event
3815
- });
4211
+ function isConditionMet(conditional, values, context) {
4212
+ return validate(
4213
+ conditional,
4214
+ buildClientFunctionContext({
4215
+ form: mergeWithBaseFormState(values, context),
4216
+ validatorContext: context
4217
+ })
4218
+ );
3816
4219
  }
3817
4220
  function getConditionalActionsForField(field3, values) {
3818
4221
  if (!field3.conditionals) {
@@ -3820,9 +4223,9 @@ function getConditionalActionsForField(field3, values) {
3820
4223
  }
3821
4224
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3822
4225
  }
3823
- function areConditionsMet(conditions, values, context, event2) {
4226
+ function areConditionsMet(conditions, values, context, _event) {
3824
4227
  return conditions.every(
3825
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4228
+ (condition) => isConditionMet(condition.conditional, values, context)
3826
4229
  );
3827
4230
  }
3828
4231
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3832,14 +4235,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3832
4235
  if (!hasRule) {
3833
4236
  return true;
3834
4237
  }
3835
- const validConditionals = getConditionalActionsForField(field3, {
3836
- $form: form,
3837
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3838
- $online: isOnline(),
3839
- $user: context.user,
3840
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3841
- $event: context.event
3842
- });
4238
+ const validConditionals = getConditionalActionsForField(
4239
+ field3,
4240
+ buildClientFunctionContext({
4241
+ form: mergeWithBaseFormState(form, context),
4242
+ validatorContext: context
4243
+ })
4244
+ );
3843
4245
  return validConditionals.includes(conditionalType);
3844
4246
  }
3845
4247
  function isFieldVisible(field3, form, context) {
@@ -3865,7 +4267,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3865
4267
  if (!rule) {
3866
4268
  return true;
3867
4269
  }
3868
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4270
+ return validate(rule.conditional, {
4271
+ ...buildClientFunctionContext({
4272
+ form: mergeWithBaseFormState(event2.declaration, context),
4273
+ validatorContext: context
4274
+ }),
4275
+ $flags: event2.flags,
4276
+ $status: event2.status
4277
+ });
3869
4278
  }
3870
4279
  function isActionEnabled(actionConfig, event2, context) {
3871
4280
  return isActionConditionMet(
@@ -4024,19 +4433,10 @@ function runFieldValidations({
4024
4433
  if (!isFieldVisible(field3.config, form, context)) {
4025
4434
  return [];
4026
4435
  }
4027
- const conditionalParameters = {
4028
- $form: form,
4029
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4030
- /**
4031
- * In real use cases, there can be hundreds of thousands of locations.
4032
- * Make sure that the context contains only the locations that are needed for validation.
4033
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4034
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4035
- */
4036
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4037
- $online: isOnline(),
4038
- $user: context.user
4039
- };
4436
+ const conditionalParameters = buildClientFunctionContext({
4437
+ form: mergeWithBaseFormState(form, context),
4438
+ validatorContext: context
4439
+ });
4040
4440
  if (isFieldGroupFieldType(field3)) {
4041
4441
  const subfieldErrors = buildFormState(
4042
4442
  field3.config.fields,
@@ -4175,16 +4575,13 @@ function getActionConfig({
4175
4575
  actionType,
4176
4576
  customActionType
4177
4577
  }) {
4578
+ if (actionType === ActionType.NOTIFY) {
4579
+ return eventConfiguration.actions.find((a) => a.type === ActionType.NOTIFY) ?? eventConfiguration.actions.find((a) => a.type === ActionType.DECLARE);
4580
+ }
4178
4581
  return eventConfiguration.actions.find((a) => {
4179
4582
  if (a.type === ActionType.CUSTOM && customActionType) {
4180
4583
  return a.customActionType === customActionType;
4181
4584
  }
4182
- if (actionType === ActionType.NOTIFY) {
4183
- return a.type === ActionType.DECLARE;
4184
- }
4185
- if (actionType === ActionType.APPROVE_CORRECTION || actionType === ActionType.REJECT_CORRECTION) {
4186
- return a.type === ActionType.REQUEST_CORRECTION;
4187
- }
4188
4585
  return a.type === actionType;
4189
4586
  });
4190
4587
  }
@@ -4218,7 +4615,7 @@ var getActionAnnotationFields = (actionConfig) => {
4218
4615
  if (actionConfig.type === ActionType.CUSTOM) {
4219
4616
  return actionConfig.form;
4220
4617
  }
4221
- if ("review" in actionConfig) {
4618
+ if ("review" in actionConfig && actionConfig.review != null) {
4222
4619
  return actionConfig.review.fields;
4223
4620
  }
4224
4621
  return [];
@@ -4269,17 +4666,16 @@ function isPageVisible(page, formValues, context) {
4269
4666
  }
4270
4667
  return isConditionMet(page.conditional, formValues, context);
4271
4668
  }
4272
- function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false, declarationContext) {
4669
+ function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false) {
4273
4670
  const base = (0, import_lodash.cloneDeep)(formValues);
4274
4671
  function fn(prevVisibilityContext) {
4275
- const visibilityForm = declarationContext ? { ...declarationContext, ...prevVisibilityContext } : prevVisibilityContext;
4276
4672
  const cleaned = (0, import_lodash.omitBy)(base, (value, fieldId) => {
4277
4673
  const fieldConfig = fields.filter((f) => f.id === fieldId);
4278
4674
  if (!fieldConfig.length) {
4279
4675
  return false;
4280
4676
  }
4281
4677
  const isHidden = fieldConfig.every(
4282
- (f) => !isFieldVisible(f, visibilityForm, validatorContext)
4678
+ (f) => !isFieldVisible(f, prevVisibilityContext, validatorContext)
4283
4679
  );
4284
4680
  if (!isHidden) {
4285
4681
  return false;
@@ -4297,7 +4693,7 @@ function omitHiddenPaginatedFields(formConfig, values, validatorContext, include
4297
4693
  const visibleFields = formConfig.pages.filter((p) => isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4298
4694
  const hiddenFields = formConfig.pages.filter((p) => !isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4299
4695
  const valuesExceptHiddenPage = (0, import_lodash.omitBy)(values, (_2, fieldId) => {
4300
- return hiddenFields.some((f) => f.id === fieldId);
4696
+ return hiddenFields.some((f) => f.id === fieldId) && !visibleFields.some((f) => f.id === fieldId);
4301
4697
  });
4302
4698
  return omitHiddenFields(
4303
4699
  visibleFields,
@@ -4344,13 +4740,10 @@ function getVisibleVerificationPageIds(pages, annotation, context) {
4344
4740
  }
4345
4741
  function omitHiddenAnnotationFields(actionConfig, declaration, annotation, context) {
4346
4742
  const annotationFields = getActionAnnotationFields(actionConfig);
4347
- return omitHiddenFields(
4348
- annotationFields,
4349
- annotation,
4350
- context,
4351
- false,
4352
- declaration
4353
- );
4743
+ return omitHiddenFields(annotationFields, annotation, {
4744
+ ...context,
4745
+ baseFormState: declaration
4746
+ });
4354
4747
  }
4355
4748
  function deepMerge(currentDocument, actionDocument) {
4356
4749
  const currentDocumentClone = (0, import_lodash.cloneDeep)(currentDocument);
@@ -4524,19 +4917,32 @@ function getPendingAction(actions) {
4524
4917
  }
4525
4918
  return pendingActions[0];
4526
4919
  }
4527
- function getCompleteActionAnnotation(annotation, event2, action) {
4920
+ function getCompleteActionAnnotation(event2, action) {
4528
4921
  if (action.originalActionId) {
4529
4922
  const originalAction = event2.actions.find(
4530
4923
  ({ id }) => id === action.originalActionId
4531
4924
  );
4532
4925
  if (originalAction?.status === ActionStatus.Requested) {
4533
- return deepMerge(
4534
- deepMerge(annotation, originalAction.annotation ?? {}),
4535
- action.annotation ?? {}
4536
- );
4926
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4537
4927
  }
4538
4928
  }
4539
- return deepMerge(annotation, action.annotation ?? {});
4929
+ return action.annotation ?? {};
4930
+ }
4931
+ function getCompleteActionContent(event2, action) {
4932
+ const currentContent = "content" in action ? action.content : void 0;
4933
+ if (!action.originalActionId) {
4934
+ return currentContent;
4935
+ }
4936
+ const originalAction = event2.actions.find(
4937
+ ({ id }) => id === action.originalActionId
4938
+ );
4939
+ if (originalAction && "content" in originalAction && originalAction.content) {
4940
+ return {
4941
+ ...originalAction.content,
4942
+ ...currentContent ?? {}
4943
+ };
4944
+ }
4945
+ return currentContent;
4540
4946
  }
4541
4947
  function getCompleteActionDeclaration(declaration, event2, action) {
4542
4948
  if (action.originalActionId) {
@@ -4556,7 +4962,7 @@ function getAcceptedActions(event2) {
4556
4962
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4557
4963
  ...action,
4558
4964
  declaration: getCompleteActionDeclaration({}, event2, action),
4559
- annotation: getCompleteActionAnnotation({}, event2, action)
4965
+ annotation: getCompleteActionAnnotation(event2, action)
4560
4966
  }));
4561
4967
  }
4562
4968
  var EXCLUDED_ACTIONS = [
@@ -4644,6 +5050,9 @@ function not(condition) {
4644
5050
  function never2() {
4645
5051
  return not(alwaysTrue());
4646
5052
  }
5053
+ function always() {
5054
+ return defineConditional(alwaysTrue());
5055
+ }
4647
5056
  function jsonFieldPath(field3) {
4648
5057
  return [field3.$$field, ...field3.$$subfield].join("/");
4649
5058
  }
@@ -5191,7 +5600,54 @@ function createFieldConditionals(fieldId) {
5191
5600
  }
5192
5601
  },
5193
5602
  required: [fieldId]
5194
- })
5603
+ }),
5604
+ /**
5605
+ * Custom client-side validator. The provided function is serialised and executed
5606
+ * just-in-time on the client only. External references (e.g. lodash) are not
5607
+ * available inside the function body — all logic must be self-contained.
5608
+ *
5609
+ * @example
5610
+ * field('nid').customClientValidator((value) => {
5611
+ * // LUHN check — all logic must be inline
5612
+ * const digits = String(value).split('').map(Number)
5613
+ * // ...
5614
+ * return isValid
5615
+ * })
5616
+ */
5617
+ customClientValidator(validationFn) {
5618
+ const code = validationFn.toString();
5619
+ return defineFormConditional({
5620
+ type: "object",
5621
+ properties: wrapToPath(
5622
+ { [fieldId]: { customClientValidator: { code } } },
5623
+ this.$$subfield
5624
+ ),
5625
+ required: [fieldId]
5626
+ });
5627
+ },
5628
+ /**
5629
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5630
+ * that can be used as the `value` property or a DATA component entry.
5631
+ * The function receives the referenced field's value as the first argument and
5632
+ * the full form context as the second; its return value replaces the field reference.
5633
+ * The function is serialised and executed just-in-time on the client only.
5634
+ * External references (e.g. lodash) are not available inside the function body.
5635
+ *
5636
+ * For computing a default value without referencing a specific field, use
5637
+ * `evaluate(fn)` in the `defaultValue` property instead.
5638
+ *
5639
+ * @example
5640
+ * field('a').customClientEvaluation((aValue, ctx) =>
5641
+ * Number(aValue) + Number(ctx.$form.b)
5642
+ * )
5643
+ */
5644
+ customClientEvaluation(computationFn) {
5645
+ return {
5646
+ $$code: computationFn.toString(),
5647
+ $$field: fieldId,
5648
+ $$subfield: this.$$subfield
5649
+ };
5650
+ }
5195
5651
  };
5196
5652
  }
5197
5653
 
@@ -5279,7 +5735,7 @@ function validateActionFlags(event2, ctx) {
5279
5735
  const isInherentFlag = (value) => Object.values(InherentFlags).includes(value);
5280
5736
  const configuredFlagIds = event2.flags.map((flag2) => flag2.id);
5281
5737
  const actionFlagIds = event2.actions.flatMap(
5282
- (action) => action.flags.map((flag2) => flag2.id)
5738
+ (action) => (action.flags ?? []).map((flag2) => flag2.id)
5283
5739
  );
5284
5740
  for (const actionFlagId of actionFlagIds) {
5285
5741
  const isConfigured = configuredFlagIds.includes(actionFlagId);
@@ -5339,7 +5795,7 @@ var _EventConfigBase = z33.object({
5339
5795
  ),
5340
5796
  label: TranslationConfig.describe("Human-readable label for the event type."),
5341
5797
  actions: z33.array(ActionConfig).describe(
5342
- "Configuration of system-defined actions associated with the event."
5798
+ "Configuration of core and custom actions associated with the event."
5343
5799
  ),
5344
5800
  actionOrder: z33.array(z33.string()).optional().describe(
5345
5801
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5351,7 +5807,7 @@ var _EventConfigBase = z33.object({
5351
5807
  "Configuration of fields available in the advanced search feature."
5352
5808
  ),
5353
5809
  flags: z33.array(FlagConfig).optional().default([]).describe(
5354
- "Configuration of flags associated with the actions of this event type."
5810
+ "Configuration of custom flags associated with the actions of this event type."
5355
5811
  ),
5356
5812
  analytics: z33.boolean().optional().default(true).describe(
5357
5813
  "Indicates whether the records of this event type are included in analytics"
@@ -5364,8 +5820,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5364
5820
  validateActionFlags(event2, ctx);
5365
5821
  validateActionOrder(event2, ctx);
5366
5822
  }).meta({
5367
- id: "EventConfig"
5368
- }).describe("Configuration defining an event type.");
5823
+ id: "EventConfig",
5824
+ description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
5825
+ });
5369
5826
 
5370
5827
  // ../commons/src/events/EventConfigInput.ts
5371
5828
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5588,6 +6045,9 @@ var WorkqueueColumnValue = z34.object({
5588
6045
  var WorkqueueColumn = z34.object({
5589
6046
  label: TranslationConfig,
5590
6047
  value: WorkqueueColumnValue
6048
+ }).meta({
6049
+ id: "WorkqueueColumn",
6050
+ description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
5591
6051
  });
5592
6052
  function defineWorkqueuesColumns(workqueueColumns) {
5593
6053
  return workqueueColumns.map(
@@ -5790,18 +6250,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5790
6250
  query: true,
5791
6251
  columns: true
5792
6252
  });
5793
- var WorkqueueConfigInput = z37.object({
5794
- slug: z37.string().describe("Determines the url of the workqueue."),
5795
- name: TranslationConfig.describe(
5796
- "Title of the workflow (both in navigation and on the page)"
5797
- ),
5798
- query: CountryConfigQueryInputType,
5799
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5800
- "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."
5801
- ),
5802
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5803
- icon: AvailableIcons,
5804
- emptyMessage: TranslationConfig.optional()
6253
+ var WorkqueueConfigInput = WorkqueueConfig.extend({
6254
+ query: CountryConfigQueryInputType
6255
+ }).meta({
6256
+ id: "WorkqueueConfig",
6257
+ 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."
5805
6258
  });
5806
6259
  function defineWorkqueue(workqueueInput) {
5807
6260
  const queryInput = workqueueInput.query;
@@ -5862,6 +6315,11 @@ var BaseActionInput = z38.object({
5862
6315
  originalActionId: UUID.optional(),
5863
6316
  // should not be part of base action.
5864
6317
  keepAssignment: z38.boolean().optional(),
6318
+ keepAssignmentIfAccepted: z38.boolean().optional(),
6319
+ keepAssignmentIfRejected: z38.boolean().optional(),
6320
+ waitFor: z38.boolean().default(true).describe(
6321
+ "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."
6322
+ ),
5865
6323
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5866
6324
  // @TODO: createdAtLocation should be limited to actions that system users can perform. For normal users, it should not be part of the base action.
5867
6325
  createdAtLocation: UUID.nullish().describe(
@@ -5979,7 +6437,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
5979
6437
  var ApproveCorrectionActionInput = BaseActionInput.extend(
5980
6438
  z38.object({
5981
6439
  requestId: z38.string(),
5982
- type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION)
6440
+ type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION),
6441
+ content: z38.object({ immediateCorrection: z38.boolean().optional() }).optional()
5983
6442
  }).shape
5984
6443
  );
5985
6444
  var ReadActionInput = BaseActionInput.extend(
@@ -6041,7 +6500,7 @@ var Draft = z39.object({
6041
6500
  }).describe(
6042
6501
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6043
6502
  );
6044
- var DraftInput = BaseActionInput.extend({
6503
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6045
6504
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6046
6505
  status: z39.enum([
6047
6506
  ActionStatus.Requested,
@@ -6115,7 +6574,6 @@ function getDeclarationActionCreationMetadata(actionType, actions) {
6115
6574
  createdAtLocation: requestAction?.createdAtLocation ?? acceptAction.createdAtLocation,
6116
6575
  acceptedAt: acceptAction.createdAt,
6117
6576
  createdByRole: requestAction?.createdByRole ?? acceptAction.createdByRole,
6118
- createdBySignature: requestAction?.createdBySignature ?? acceptAction.createdBySignature,
6119
6577
  registrationNumber
6120
6578
  };
6121
6579
  }
@@ -6129,6 +6587,8 @@ var updateActions = ActionTypes.extract([
6129
6587
  ActionType.ARCHIVE,
6130
6588
  ActionType.PRINT_CERTIFICATE,
6131
6589
  ActionType.REQUEST_CORRECTION,
6590
+ ActionType.APPROVE_CORRECTION,
6591
+ ActionType.REJECT_CORRECTION,
6132
6592
  ActionType.CUSTOM
6133
6593
  ]);
6134
6594
  function getActionUpdateMetadata(actions) {
@@ -6143,7 +6603,7 @@ function getActionUpdateMetadata(actions) {
6143
6603
  "createdAtLocation",
6144
6604
  "createdByRole"
6145
6605
  ];
6146
- return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
6606
+ return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
6147
6607
  (_2, action) => {
6148
6608
  if (action.originalActionId) {
6149
6609
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6170,28 +6630,19 @@ function getLegalStatuses(actions) {
6170
6630
  // ../commons/src/events/state/flags.ts
6171
6631
  var import_lodash3 = require("lodash");
6172
6632
  var import_date_fns3 = require("date-fns");
6173
- function isEditInProgress(actions) {
6174
- return actions.at(-1)?.type === ActionType.EDIT;
6175
- }
6176
- function isCorrectionRequested(actions) {
6177
- return actions.reduce((prev, { type }) => {
6178
- if (type === ActionType.REQUEST_CORRECTION) {
6179
- return true;
6180
- }
6181
- if (type === ActionType.APPROVE_CORRECTION) {
6182
- return false;
6633
+ function findPendingCorrectionAction(writeActions2) {
6634
+ let correctionRequestAction;
6635
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6636
+ const action = writeActions2[i];
6637
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6638
+ break;
6183
6639
  }
6184
- if (type === ActionType.REJECT_CORRECTION) {
6185
- return false;
6640
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6641
+ correctionRequestAction = action;
6642
+ break;
6186
6643
  }
6187
- return prev;
6188
- }, false);
6189
- }
6190
- function isDeclarationIncomplete(actions) {
6191
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6192
- }
6193
- function isRejected(actions) {
6194
- return actions.at(-1)?.type === ActionType.REJECT;
6644
+ }
6645
+ return correctionRequestAction;
6195
6646
  }
6196
6647
  function isPotentialDuplicate(actions) {
6197
6648
  return actions.reduce((prev, { type }) => {
@@ -6220,6 +6671,88 @@ function isFlagConditionMet(conditional, form, action) {
6220
6671
  }
6221
6672
  });
6222
6673
  }
6674
+ function actionConfigRemovesFlag(action, flagId, actionsUpToAndIncluding, event2, eventConfiguration) {
6675
+ if (!isActionConfigType(action.type)) {
6676
+ return false;
6677
+ }
6678
+ const actionConfig = getActionConfig({
6679
+ eventConfiguration,
6680
+ actionType: action.type,
6681
+ customActionType: "customActionType" in action ? action.customActionType : void 0
6682
+ });
6683
+ const removeOperations = (actionConfig?.flags ?? []).filter(
6684
+ ({ id, operation }) => id === flagId && operation === "remove"
6685
+ );
6686
+ if (removeOperations.length === 0) {
6687
+ return false;
6688
+ }
6689
+ const eventUpToThisAction = { ...event2, actions: actionsUpToAndIncluding };
6690
+ const declaration = aggregateActionDeclarations(eventUpToThisAction);
6691
+ const annotation = aggregateActionAnnotations(eventUpToThisAction);
6692
+ const form = { ...declaration, ...annotation };
6693
+ return removeOperations.some(
6694
+ ({ conditional }) => conditional ? isFlagConditionMet(conditional, form, action) : true
6695
+ );
6696
+ }
6697
+ var INHERENT_FLAG_RULES = [
6698
+ {
6699
+ flag: InherentFlags.CORRECTION_REQUESTED,
6700
+ setOn: [ActionType.REQUEST_CORRECTION],
6701
+ resetOn: [ActionType.APPROVE_CORRECTION, ActionType.REJECT_CORRECTION]
6702
+ },
6703
+ {
6704
+ // INCOMPLETE mirrors the NOTIFIED status: set by NOTIFY, cleared by any
6705
+ // other status-changing action (see getStatusFromActions).
6706
+ flag: InherentFlags.INCOMPLETE,
6707
+ setOn: [ActionType.NOTIFY],
6708
+ resetOn: [
6709
+ ActionType.CREATE,
6710
+ ActionType.DECLARE,
6711
+ ActionType.REGISTER,
6712
+ ActionType.ARCHIVE
6713
+ ]
6714
+ },
6715
+ {
6716
+ flag: InherentFlags.REJECTED,
6717
+ setOn: [ActionType.REJECT],
6718
+ resetOn: [
6719
+ ActionType.NOTIFY,
6720
+ ActionType.DECLARE,
6721
+ ActionType.EDIT,
6722
+ ActionType.REGISTER
6723
+ ]
6724
+ },
6725
+ {
6726
+ flag: InherentFlags.POTENTIAL_DUPLICATE,
6727
+ setOn: [ActionType.DUPLICATE_DETECTED],
6728
+ resetOn: [ActionType.MARK_AS_DUPLICATE, ActionType.MARK_AS_NOT_DUPLICATE]
6729
+ },
6730
+ {
6731
+ flag: InherentFlags.EDIT_IN_PROGRESS,
6732
+ setOn: [ActionType.EDIT],
6733
+ resetOnAnyOtherAction: true
6734
+ }
6735
+ ];
6736
+ function resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration) {
6737
+ return acceptedActions.reduce((present, action, idx) => {
6738
+ if (rule.setOn.includes(action.type)) {
6739
+ return true;
6740
+ }
6741
+ if (rule.resetOnAnyOtherAction || (rule.resetOn ?? []).includes(action.type)) {
6742
+ return false;
6743
+ }
6744
+ if (actionConfigRemovesFlag(
6745
+ action,
6746
+ rule.flag,
6747
+ acceptedActions.slice(0, idx + 1),
6748
+ event2,
6749
+ eventConfiguration
6750
+ )) {
6751
+ return false;
6752
+ }
6753
+ return present;
6754
+ }, false);
6755
+ }
6223
6756
  function resolveEventCustomFlags(event2, eventConfiguration) {
6224
6757
  const actions = getAcceptedActions(event2).filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6225
6758
  return actions.reduce((acc, action, idx) => {
@@ -6241,7 +6774,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6241
6774
  const declaration = aggregateActionDeclarations(eventUpToThisAction);
6242
6775
  const annotation = aggregateActionAnnotations(eventUpToThisAction);
6243
6776
  const form = { ...declaration, ...annotation };
6244
- const flagsWithMetConditions = actionConfig.flags.filter(
6777
+ const flagsWithMetConditions = (actionConfig.flags ?? []).filter(
6245
6778
  ({ conditional }) => (
6246
6779
  // If conditional is not provided, the flag is resolved
6247
6780
  conditional ? isFlagConditionMet(conditional, form, action) : true
@@ -6255,8 +6788,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6255
6788
  return (0, import_lodash3.uniq)(flags);
6256
6789
  }, []);
6257
6790
  }
6258
- function getEventFlags(event2, config) {
6259
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6791
+ function getActionStatusFlags(sortedActions) {
6260
6792
  const actionStatus = sortedActions.reduce(
6261
6793
  (actionStatuses, { type, status: status2 }) => ({
6262
6794
  ...actionStatuses,
@@ -6264,26 +6796,26 @@ function getEventFlags(event2, config) {
6264
6796
  }),
6265
6797
  {}
6266
6798
  );
6267
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6799
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6268
6800
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6269
6801
  return flag2;
6270
6802
  });
6271
- if (isCorrectionRequested(sortedActions)) {
6272
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6273
- }
6274
- if (isDeclarationIncomplete(sortedActions)) {
6275
- flags.push(InherentFlags.INCOMPLETE);
6276
- }
6277
- if (isRejected(sortedActions)) {
6278
- flags.push(InherentFlags.REJECTED);
6279
- }
6280
- if (isPotentialDuplicate(sortedActions)) {
6281
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6282
- }
6283
- if (isEditInProgress(sortedActions)) {
6284
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6285
- }
6286
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6803
+ }
6804
+ function getInherentFlags(sortedActions, event2, eventConfiguration) {
6805
+ const acceptedActions = sortedActions.filter(
6806
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6807
+ );
6808
+ return INHERENT_FLAG_RULES.filter(
6809
+ (rule) => resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration)
6810
+ ).map(({ flag: flag2 }) => flag2);
6811
+ }
6812
+ function getEventFlags(event2, config) {
6813
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6814
+ return [
6815
+ ...getActionStatusFlags(sortedActions),
6816
+ ...getInherentFlags(sortedActions, event2, config),
6817
+ ...resolveEventCustomFlags(event2, config)
6818
+ ];
6287
6819
  }
6288
6820
 
6289
6821
  // ../commons/src/events/state/index.ts
@@ -6329,17 +6861,6 @@ function getAssignedUserFromActions(actions) {
6329
6861
  return user2;
6330
6862
  }, null);
6331
6863
  }
6332
- function getAssignedUserSignatureFromActions(actions) {
6333
- return actions.reduce((signature, action) => {
6334
- if (action.type === ActionType.ASSIGN) {
6335
- return action.createdBySignature || null;
6336
- }
6337
- if (action.type === ActionType.UNASSIGN) {
6338
- return null;
6339
- }
6340
- return signature;
6341
- }, null);
6342
- }
6343
6864
  function deepDropNulls(obj) {
6344
6865
  if (Array.isArray(obj)) {
6345
6866
  return obj.map(deepDropNulls);
@@ -6435,10 +6956,8 @@ function getCurrentEventState(event2, config) {
6435
6956
  createdBy: creationAction.createdBy,
6436
6957
  createdByUserType: creationAction.createdByUserType,
6437
6958
  createdAtLocation: creationAction.createdAtLocation,
6438
- createdBySignature: creationAction.createdBySignature,
6439
6959
  updatedAt: acceptedActionMetadata.createdAt,
6440
6960
  assignedTo: getAssignedUserFromActions(acceptedActions),
6441
- assignedToSignature: getAssignedUserSignatureFromActions(acceptedActions),
6442
6961
  updatedBy: requestActionMetadata.createdBy,
6443
6962
  updatedAtLocation: requestActionMetadata.createdAtLocation,
6444
6963
  declaration,
@@ -6531,7 +7050,7 @@ function getActionAnnotation({
6531
7050
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6532
7051
  const actionWithCompleteAnnotation = action && {
6533
7052
  ...action,
6534
- annotation: getCompleteActionAnnotation({}, event2, action)
7053
+ annotation: getCompleteActionAnnotation(event2, action)
6535
7054
  };
6536
7055
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6537
7056
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6603,6 +7122,9 @@ function createFieldConfig(fieldId, options) {
6603
7122
  }
6604
7123
 
6605
7124
  // ../commons/src/events/field.ts
7125
+ function evaluate(computationFn) {
7126
+ return { $$code: computationFn.toString() };
7127
+ }
6606
7128
  function field(fieldId, options = {}) {
6607
7129
  return {
6608
7130
  ...createFieldConditionals(fieldId),
@@ -7296,6 +7818,11 @@ var TENNIS_CLUB_DECLARATION_REVIEW = {
7296
7818
  id: "signature.upload.modal.title",
7297
7819
  defaultMessage: "Draw signature",
7298
7820
  description: "Title for the modal to draw signature"
7821
+ },
7822
+ // Zod applies the schema default at parse time, but this fixture bypasses
7823
+ // parsing — GeneratedInputField accesses configuration.maxFileSize directly.
7824
+ configuration: {
7825
+ maxFileSize: 5 * 1024 * 1024
7299
7826
  }
7300
7827
  }
7301
7828
  ]
@@ -7852,6 +8379,20 @@ var tennisClubMembershipEvent = defineConfig({
7852
8379
  },
7853
8380
  review: TENNIS_CLUB_DECLARATION_REVIEW
7854
8381
  },
8382
+ {
8383
+ type: ActionType.NOTIFY,
8384
+ label: {
8385
+ defaultMessage: "Notify health worker",
8386
+ description: "This is shown as the action name anywhere the user can trigger the action from",
8387
+ id: "event.tennis-club-membership.action.notify.label"
8388
+ },
8389
+ flags: [
8390
+ {
8391
+ id: "health-worker-notified",
8392
+ operation: "add"
8393
+ }
8394
+ ]
8395
+ },
7855
8396
  {
7856
8397
  type: ActionType.REJECT,
7857
8398
  label: {
@@ -8094,6 +8635,17 @@ var tennisClubMembershipEvent = defineConfig({
8094
8635
  }
8095
8636
  }
8096
8637
  ],
8638
+ flags: [
8639
+ {
8640
+ id: "health-worker-notified",
8641
+ requiresAction: false,
8642
+ label: {
8643
+ id: "event.tennis-club-membership.flag.health-worker-notified.label",
8644
+ defaultMessage: "Health worker notified",
8645
+ description: "Label for the health-worker-notified flag"
8646
+ }
8647
+ }
8648
+ ],
8097
8649
  advancedSearch: [
8098
8650
  {
8099
8651
  title: {
@@ -9697,7 +10249,6 @@ var eventQueryDataGenerator = (overrides = {}, seed = 1) => {
9697
10249
  createdBy: overrides.createdBy ?? generateUuid(rng),
9698
10250
  createdAtLocation: overrides.createdAtLocation ?? generateUuid(rng),
9699
10251
  updatedAtLocation: overrides.updatedAtLocation ?? generateUuid(rng),
9700
- createdBySignature: overrides.createdBySignature ?? generateRandomSignature(rng),
9701
10252
  updatedAt: overrides.updatedAt ?? (0, import_date_fns4.addDays)(new Date(createdAt), 1).toISOString(),
9702
10253
  assignedTo: overrides.assignedTo ?? null,
9703
10254
  updatedBy: overrides.updatedBy ?? generateUuid(rng),
@@ -9853,7 +10404,7 @@ function matchesJurisdictionFilter(locationIds, filter, user2) {
9853
10404
  return locationIds.some((id) => id === user2.primaryOfficeId);
9854
10405
  }
9855
10406
  if (filter === JurisdictionFilter.enum.administrativeArea) {
9856
- return user2.administrativeAreaId === null || locationIds.some((id) => id === user2.administrativeAreaId);
10407
+ return !user2.administrativeAreaId || locationIds.some((id) => id === user2.administrativeAreaId);
9857
10408
  }
9858
10409
  return true;
9859
10410
  }
@@ -9930,11 +10481,77 @@ function canAccessEventWithScope(event2, scope, user2, customActionType) {
9930
10481
  }
9931
10482
  return true;
9932
10483
  }
10484
+ function canAccessUserWithScope({
10485
+ userToAccess,
10486
+ scope,
10487
+ user: user2
10488
+ }) {
10489
+ const opts = scope.options;
10490
+ const hasSameOffice = user2.primaryOfficeId === userToAccess.primaryOfficeId;
10491
+ if (opts?.accessLevel === JurisdictionFilter.enum.location && !hasSameOffice) {
10492
+ return false;
10493
+ }
10494
+ const hasAdministrativeAreaInHierarchy = userToAccess.administrativeHierarchy.some(
10495
+ (id) => user2.administrativeAreaId === id
10496
+ ) || !user2.administrativeAreaId;
10497
+ if (opts?.accessLevel === JurisdictionFilter.enum.administrativeArea && !hasAdministrativeAreaInHierarchy) {
10498
+ return false;
10499
+ }
10500
+ if (scopeUsesRoleOptions(scope)) {
10501
+ const { options } = scope;
10502
+ if (options?.role && !options.role.includes(userToAccess.role)) {
10503
+ return false;
10504
+ }
10505
+ }
10506
+ return true;
10507
+ }
10508
+ function canAccessOtherUserWithScopes({
10509
+ scopes,
10510
+ userToAccess,
10511
+ user: user2
10512
+ }) {
10513
+ return scopes.some(
10514
+ (scope) => canAccessUserWithScope({ userToAccess, scope, user: user2 })
10515
+ );
10516
+ }
9933
10517
  function userCanAccessEventWithScopes(event2, scopes, user2, customActionType) {
9934
10518
  return scopes.some(
9935
10519
  (scope) => canAccessEventWithScope(event2, scope, user2, customActionType)
9936
10520
  );
9937
10521
  }
10522
+ function getAdministrativeAreaHierarchy(administrativeAreaId, administrativeAreas) {
10523
+ const collectedLocations = [];
10524
+ const parsedAdministrativeAreaId = administrativeAreaId && UUID.safeParse(administrativeAreaId).data;
10525
+ let current = parsedAdministrativeAreaId ? administrativeAreas.get(parsedAdministrativeAreaId) : null;
10526
+ while (current) {
10527
+ collectedLocations.push(current);
10528
+ if (!current.parentId) {
10529
+ break;
10530
+ }
10531
+ const parentId = current.parentId;
10532
+ current = administrativeAreas.get(parentId);
10533
+ }
10534
+ return collectedLocations;
10535
+ }
10536
+ function getLocationHierarchy(selectedId, context) {
10537
+ const { administrativeAreas, locations } = context;
10538
+ const loc = locations.get(selectedId);
10539
+ if (loc) {
10540
+ if (loc.administrativeAreaId) {
10541
+ const hierarchy2 = getAdministrativeAreaHierarchy(
10542
+ loc.administrativeAreaId,
10543
+ administrativeAreas
10544
+ );
10545
+ return [...hierarchy2.reverse().map((area) => area.id), loc.id];
10546
+ }
10547
+ return [loc.id];
10548
+ }
10549
+ const hierarchy = getAdministrativeAreaHierarchy(
10550
+ selectedId,
10551
+ administrativeAreas
10552
+ );
10553
+ return hierarchy.reverse().map((area) => area.id);
10554
+ }
9938
10555
 
9939
10556
  // ../commons/src/events/scopes.ts
9940
10557
  var ACTION_SCOPE_MAP = {
@@ -10009,6 +10626,25 @@ function isActionInScope({
10009
10626
  );
10010
10627
  return canAccess;
10011
10628
  }
10629
+ function getAvailableRolesForUserUpdatePayload({
10630
+ allRoles,
10631
+ userLocation,
10632
+ acceptedScopes,
10633
+ userRequesting
10634
+ }) {
10635
+ const availableRoles = allRoles.filter((role) => {
10636
+ const canAccess = canAccessOtherUserWithScopes({
10637
+ userToAccess: {
10638
+ ...userLocation,
10639
+ role
10640
+ },
10641
+ user: userRequesting,
10642
+ scopes: acceptedScopes
10643
+ });
10644
+ return canAccess;
10645
+ });
10646
+ return availableRoles;
10647
+ }
10012
10648
 
10013
10649
  // ../commons/src/events/serializers/user/deserializer.ts
10014
10650
  function userDeserializer(serializedUserField, user2) {
@@ -10163,18 +10799,19 @@ var ACTION_FILTERS = {
10163
10799
  function filterActionsByFlags(actions, flags) {
10164
10800
  return actions.filter((action) => ACTION_FILTERS[action]?.(flags) ?? true);
10165
10801
  }
10802
+ var REJECTED_ACTIONS = [
10803
+ ActionType.READ,
10804
+ ActionType.NOTIFY,
10805
+ ActionType.CUSTOM,
10806
+ ActionType.EDIT,
10807
+ ActionType.ARCHIVE
10808
+ ];
10166
10809
  function getAvailableActionsWithoutFlagFilters(status2, flags) {
10167
10810
  if (flags.includes(InherentFlags.EDIT_IN_PROGRESS)) {
10168
10811
  return [ActionType.NOTIFY, ActionType.DECLARE, ActionType.REGISTER];
10169
10812
  }
10170
- if (flags.includes(InherentFlags.REJECTED)) {
10171
- return [
10172
- ActionType.READ,
10173
- ActionType.NOTIFY,
10174
- ActionType.CUSTOM,
10175
- ActionType.EDIT,
10176
- ActionType.ARCHIVE
10177
- ];
10813
+ if (flags.includes(InherentFlags.REJECTED) && status2 !== EventStatus.enum.ARCHIVED) {
10814
+ return REJECTED_ACTIONS;
10178
10815
  }
10179
10816
  return AVAILABLE_ACTIONS_BY_EVENT_STATUS[status2];
10180
10817
  }
@@ -10211,3 +10848,366 @@ function getFilePathsFromEvent(event2) {
10211
10848
  });
10212
10849
  return (0, import_lodash7.uniq)(filepaths);
10213
10850
  }
10851
+
10852
+ // ../commons/src/events/mocks.test.utils.ts
10853
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10854
+ {
10855
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10856
+ name: "Central",
10857
+ parentId: null,
10858
+ validUntil: null,
10859
+ externalId: "ydyJb1RAy4U1"
10860
+ },
10861
+ {
10862
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10863
+ name: "Sulaka",
10864
+ parentId: null,
10865
+ validUntil: null,
10866
+ externalId: "pQ8nGxWmZ2Q3"
10867
+ },
10868
+ {
10869
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10870
+ name: "Pualula",
10871
+ parentId: null,
10872
+ validUntil: null,
10873
+ externalId: "Aq91DweLmT8k"
10874
+ },
10875
+ {
10876
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10877
+ name: "Chuminga",
10878
+ parentId: null,
10879
+ validUntil: null,
10880
+ externalId: "Rw0fYNh2Xk9a"
10881
+ },
10882
+ {
10883
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10884
+ name: "Ibombo",
10885
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10886
+ validUntil: null,
10887
+ externalId: "k7DsP4vbN1Qe"
10888
+ },
10889
+ {
10890
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10891
+ name: "Isango",
10892
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10893
+ validUntil: null,
10894
+ externalId: "Gm3Z9eQpHw4L"
10895
+ },
10896
+ {
10897
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10898
+ name: "Isamba",
10899
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10900
+ validUntil: null,
10901
+ externalId: "sT0xVu1KqJ7r"
10902
+ },
10903
+ {
10904
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10905
+ name: "Itambo",
10906
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10907
+ validUntil: null,
10908
+ externalId: "Nq6Bv2HpL9Te"
10909
+ },
10910
+ {
10911
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10912
+ name: "Ezhi",
10913
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10914
+ validUntil: null,
10915
+ externalId: "xK8cQ0ZRy5Wd"
10916
+ },
10917
+ {
10918
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10919
+ name: "Ilanga",
10920
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10921
+ validUntil: null,
10922
+ externalId: "Cq4Jm1XvN8Ls"
10923
+ },
10924
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10925
+ {
10926
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10927
+ name: "Klow",
10928
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10929
+ validUntil: null,
10930
+ externalId: "IkYcYBUcyY2"
10931
+ },
10932
+ {
10933
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10934
+ name: "Mbondo",
10935
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10936
+ validUntil: null,
10937
+ externalId: "Qhvv5hvo3mY"
10938
+ },
10939
+ {
10940
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10941
+ name: "Ndara",
10942
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10943
+ validUntil: null,
10944
+ externalId: "crXh068O9TR"
10945
+ },
10946
+ {
10947
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10948
+ name: "Olani",
10949
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10950
+ validUntil: null,
10951
+ externalId: "r00It8Tvvp7"
10952
+ },
10953
+ {
10954
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10955
+ name: "Pemba",
10956
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10957
+ validUntil: null,
10958
+ externalId: "ZnUWsbONIaH"
10959
+ },
10960
+ {
10961
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10962
+ name: "Quanza",
10963
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10964
+ validUntil: null,
10965
+ externalId: "fDZycvQTa7l"
10966
+ },
10967
+ {
10968
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10969
+ name: "Rivka",
10970
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10971
+ validUntil: null,
10972
+ externalId: "KqswxCGTELa"
10973
+ },
10974
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10975
+ {
10976
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10977
+ name: "Mbula",
10978
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10979
+ validUntil: null,
10980
+ externalId: "osEbKjRc9Kg"
10981
+ },
10982
+ {
10983
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10984
+ name: "Ndoki",
10985
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10986
+ validUntil: null,
10987
+ externalId: "aq4daBUAGr3"
10988
+ },
10989
+ {
10990
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10991
+ name: "Tsanga",
10992
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10993
+ validUntil: null,
10994
+ externalId: "cqis6Y8trbJ"
10995
+ },
10996
+ {
10997
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10998
+ name: "Waziri",
10999
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
11000
+ validUntil: null,
11001
+ externalId: "LMijHPyyx6d"
11002
+ },
11003
+ {
11004
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
11005
+ name: "Zimbi",
11006
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
11007
+ validUntil: null,
11008
+ externalId: "pcQYbPuKGZ7"
11009
+ },
11010
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
11011
+ {
11012
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
11013
+ name: "Felani",
11014
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
11015
+ validUntil: null,
11016
+ externalId: "gSqpoCGdMXp"
11017
+ },
11018
+ {
11019
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
11020
+ name: "Goroma",
11021
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
11022
+ validUntil: null,
11023
+ externalId: "KvAAIaNqVrp"
11024
+ },
11025
+ {
11026
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
11027
+ name: "Halifu",
11028
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
11029
+ validUntil: null,
11030
+ externalId: "qe4UnEVt1hv"
11031
+ },
11032
+ {
11033
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
11034
+ name: "Jabari",
11035
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
11036
+ validUntil: null,
11037
+ externalId: "yHH9Nz4rLOt"
11038
+ },
11039
+ {
11040
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
11041
+ name: "Kifani",
11042
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
11043
+ validUntil: null,
11044
+ externalId: "eSWmXIGeu1I"
11045
+ },
11046
+ {
11047
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
11048
+ name: "Lumela",
11049
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
11050
+ validUntil: null,
11051
+ externalId: "bh0b3aI1uP3"
11052
+ }
11053
+ ];
11054
+ var V2_DEFAULT_MOCK_LOCATIONS = [
11055
+ {
11056
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
11057
+ name: "Central Provincial Office",
11058
+ locationType: "CRVS_OFFICE",
11059
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
11060
+ validUntil: null,
11061
+ externalId: "Xr3Df8WpK6Ys"
11062
+ },
11063
+ {
11064
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
11065
+ name: "Central Health Post",
11066
+ locationType: "HEALTH_FACILITY",
11067
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
11068
+ validUntil: null
11069
+ },
11070
+ {
11071
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
11072
+ name: "Ibombo District Office",
11073
+ locationType: "CRVS_OFFICE",
11074
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11075
+ validUntil: null,
11076
+ externalId: "Sm4Nw7GrD2Vy"
11077
+ },
11078
+ {
11079
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
11080
+ name: "Isamba District Office",
11081
+ locationType: "CRVS_OFFICE",
11082
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
11083
+ validUntil: null,
11084
+ externalId: "Vg1Bq5XeH9Lt"
11085
+ },
11086
+ {
11087
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
11088
+ name: "Isango District Office",
11089
+ locationType: "CRVS_OFFICE",
11090
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
11091
+ validUntil: null,
11092
+ externalId: "Je7Lm2XqN9Vz"
11093
+ },
11094
+ {
11095
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
11096
+ name: "Sulaka Provincial Office",
11097
+ locationType: "CRVS_OFFICE",
11098
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
11099
+ validUntil: null,
11100
+ externalId: "Ht2Wp9KcX5Qv"
11101
+ },
11102
+ {
11103
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
11104
+ name: "Ilanga District Office",
11105
+ locationType: "CRVS_OFFICE",
11106
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
11107
+ validUntil: null,
11108
+ externalId: "Yp6Ds1WqN3Xz"
11109
+ },
11110
+ {
11111
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
11112
+ name: "Chamakubi Health Post",
11113
+ locationType: "HEALTH_FACILITY",
11114
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11115
+ validUntil: null,
11116
+ externalId: "M1nFr8LbC2Qy"
11117
+ },
11118
+ {
11119
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
11120
+ name: "Ibombo Rural Health Centre",
11121
+ locationType: "HEALTH_FACILITY",
11122
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11123
+ validUntil: null,
11124
+ externalId: "bT7pV6YrW0Xc"
11125
+ },
11126
+ {
11127
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
11128
+ name: "Chikobo Rural Health Centre",
11129
+ locationType: "HEALTH_FACILITY",
11130
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11131
+ validUntil: null,
11132
+ externalId: "zE4qPn2SgJ5d"
11133
+ },
11134
+ {
11135
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
11136
+ name: "Chilochabalenje Health Post",
11137
+ locationType: "HEALTH_FACILITY",
11138
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11139
+ validUntil: null,
11140
+ externalId: "H8vDs1MqR4Uf"
11141
+ },
11142
+ {
11143
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
11144
+ name: "Chipeso Rural Health Centre",
11145
+ locationType: "HEALTH_FACILITY",
11146
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11147
+ validUntil: null,
11148
+ externalId: "Qw3uZ9KfX6Lm"
11149
+ },
11150
+ {
11151
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
11152
+ name: "Chisamba Rural Health Centre",
11153
+ locationType: "HEALTH_FACILITY",
11154
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11155
+ validUntil: null,
11156
+ externalId: "Yr0pCg8LdM2s"
11157
+ },
11158
+ {
11159
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
11160
+ name: "Chitanda Rural Health Centre",
11161
+ locationType: "HEALTH_FACILITY",
11162
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11163
+ validUntil: null,
11164
+ externalId: "tS9gJ4PwB1Qx"
11165
+ },
11166
+ {
11167
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
11168
+ name: "Golden Valley Rural Health Centre",
11169
+ locationType: "HEALTH_FACILITY",
11170
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11171
+ validUntil: null,
11172
+ externalId: "Ld7Qm3XsA8Vr"
11173
+ },
11174
+ {
11175
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
11176
+ name: "Ipongo Rural Health Centre",
11177
+ locationType: "HEALTH_FACILITY",
11178
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11179
+ validUntil: null,
11180
+ externalId: "kF2sW9DmH0Bt"
11181
+ },
11182
+ {
11183
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
11184
+ name: "Itumbwe Health Post",
11185
+ locationType: "HEALTH_FACILITY",
11186
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11187
+ validUntil: null,
11188
+ externalId: "Ue5Xb3VaC7Pq"
11189
+ },
11190
+ {
11191
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
11192
+ name: "Kabangalala Rural Health Centre",
11193
+ locationType: "HEALTH_FACILITY",
11194
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11195
+ validUntil: null,
11196
+ externalId: "Pz8Kc1TqH6Jn"
11197
+ },
11198
+ // Village offices
11199
+ {
11200
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
11201
+ name: "Klow Village Office",
11202
+ locationType: "CRVS_OFFICE",
11203
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
11204
+ validUntil: null,
11205
+ externalId: "PmAyxAJkxiJ"
11206
+ }
11207
+ ];
11208
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11209
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11210
+ );
11211
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11212
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11213
+ );