@opencrvs/toolkit 2.0.0-rc.e12df15 → 2.0.0-rc.e142328

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 +282 -127
  4. package/dist/cli.js +516 -174
  5. package/dist/commons/api/router.d.ts +3391 -237
  6. package/dist/commons/application-config/index.d.ts +17 -4
  7. package/dist/commons/conditionals/conditionals.d.ts +357 -7
  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 +383 -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 +21 -0
  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 +60 -5
  33. package/dist/events/index.js +1229 -295
  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 +514 -172
  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 +997 -162
  58. package/dist/scopes/index.d.ts +10 -7
  59. package/dist/scopes/index.js +17 -7
  60. package/opencrvs-toolkit-2.0.0-rc.e142328.tgz +0 -0
  61. package/package.json +6 -2
  62. package/tsconfig.tsbuildinfo +1 -1
  63. package/opencrvs-toolkit-2.0.0-rc.e12df15.tgz +0 -0
@@ -75,6 +75,7 @@ __export(events_exports, {
75
75
  CheckboxFieldValue: () => CheckboxFieldValue,
76
76
  Clause: () => Clause,
77
77
  ClientSpecificAction: () => ClientSpecificAction,
78
+ ComputedDefaultValue: () => ComputedDefaultValue,
78
79
  Conditional: () => Conditional,
79
80
  ConditionalType: () => ConditionalType,
80
81
  ConfirmableActions: () => ConfirmableActions,
@@ -150,6 +151,7 @@ __export(events_exports, {
150
151
  FormPageConfig: () => FormPageConfig,
151
152
  Fuzzy: () => Fuzzy,
152
153
  GeographicalArea: () => GeographicalArea,
154
+ HiddenFieldTypes: () => HiddenFieldTypes,
153
155
  HiddenFieldValue: () => HiddenFieldValue,
154
156
  HttpFieldUpdateValue: () => HttpFieldUpdateValue,
155
157
  HttpFieldValue: () => HttpFieldValue,
@@ -200,6 +202,7 @@ __export(events_exports, {
200
202
  SelectDateRangeValue: () => SelectDateRangeValue,
201
203
  SelectOption: () => SelectOption,
202
204
  ShowConditional: () => ShowConditional,
205
+ SignatureFieldValue: () => SignatureFieldValue,
203
206
  StaticDataEntry: () => StaticDataEntry,
204
207
  StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
205
208
  SummaryConfig: () => SummaryConfig,
@@ -213,6 +216,10 @@ __export(events_exports, {
213
216
  UUID: () => UUID,
214
217
  UnassignActionInput: () => UnassignActionInput,
215
218
  UserAuditRecordInput: () => UserAuditRecordInput,
219
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS,
220
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP,
221
+ V2_DEFAULT_MOCK_LOCATIONS: () => V2_DEFAULT_MOCK_LOCATIONS,
222
+ V2_DEFAULT_MOCK_LOCATIONS_MAP: () => V2_DEFAULT_MOCK_LOCATIONS_MAP,
216
223
  ValidationConfig: () => ValidationConfig,
217
224
  VerificationActionConfig: () => VerificationActionConfig,
218
225
  VerificationPageConfig: () => VerificationPageConfig,
@@ -234,6 +241,7 @@ __export(events_exports, {
234
241
  ageToDate: () => ageToDate,
235
242
  aggregateActionAnnotations: () => aggregateActionAnnotations,
236
243
  aggregateActionDeclarations: () => aggregateActionDeclarations,
244
+ always: () => always,
237
245
  alwaysTrue: () => alwaysTrue,
238
246
  and: () => and,
239
247
  annotationActions: () => annotationActions,
@@ -241,10 +249,12 @@ __export(events_exports, {
241
249
  applyDraftToEventIndex: () => applyDraftToEventIndex,
242
250
  areCertificateConditionsMet: () => areCertificateConditionsMet,
243
251
  areConditionsMet: () => areConditionsMet,
252
+ buildClientFunctionContext: () => buildClientFunctionContext,
244
253
  buildFormState: () => buildFormState,
245
254
  canAccessEventWithScope: () => canAccessEventWithScope,
246
255
  canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
247
256
  canAccessUserWithScope: () => canAccessUserWithScope,
257
+ compileClientFunction: () => compileClientFunction,
248
258
  compositeFieldTypes: () => compositeFieldTypes,
249
259
  createEmptyDraft: () => createEmptyDraft,
250
260
  createFieldConditionals: () => createFieldConditionals,
@@ -265,6 +275,7 @@ __export(events_exports, {
265
275
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
266
276
  deserializeQuery: () => deserializeQuery,
267
277
  errorMessages: () => errorMessages,
278
+ evaluate: () => evaluate,
268
279
  event: () => event,
269
280
  eventMetadataLabelMap: () => eventMetadataLabelMap,
270
281
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -277,6 +288,7 @@ __export(events_exports, {
277
288
  findActiveDraftForEvent: () => findActiveDraftForEvent,
278
289
  findAllFields: () => findAllFields,
279
290
  findLastAssignmentAction: () => findLastAssignmentAction,
291
+ findPendingCorrectionAction: () => findPendingCorrectionAction,
280
292
  findRecordActionPages: () => findRecordActionPages,
281
293
  flag: () => flag,
282
294
  flattenFieldReference: () => flattenFieldReference,
@@ -302,13 +314,15 @@ __export(events_exports, {
302
314
  getActionConfig: () => getActionConfig,
303
315
  getActionReview: () => getActionReview,
304
316
  getActionReviewFields: () => getActionReviewFields,
317
+ getAdministrativeAreaHierarchy: () => getAdministrativeAreaHierarchy,
305
318
  getAllUniqueFields: () => getAllUniqueFields,
306
319
  getAnnotationFromDrafts: () => getAnnotationFromDrafts,
307
320
  getAssignedUserFromActions: () => getAssignedUserFromActions,
308
- getAssignedUserSignatureFromActions: () => getAssignedUserSignatureFromActions,
309
321
  getAssignmentStatus: () => getAssignmentStatus,
310
322
  getAvailableActionsForEvent: () => getAvailableActionsForEvent,
323
+ getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
311
324
  getCompleteActionAnnotation: () => getCompleteActionAnnotation,
325
+ getCompleteActionContent: () => getCompleteActionContent,
312
326
  getCompleteActionDeclaration: () => getCompleteActionDeclaration,
313
327
  getCurrentEventState: () => getCurrentEventState,
314
328
  getCustomActionFields: () => getCustomActionFields,
@@ -317,7 +331,9 @@ __export(events_exports, {
317
331
  getDeclarationFields: () => getDeclarationFields,
318
332
  getDeclarationPages: () => getDeclarationPages,
319
333
  getEventConfigById: () => getEventConfigById,
334
+ getEventFlags: () => getEventFlags,
320
335
  getFilePathsFromEvent: () => getFilePathsFromEvent,
336
+ getLocationHierarchy: () => getLocationHierarchy,
321
337
  getMixedPath: () => getMixedPath,
322
338
  getPendingAction: () => getPendingAction,
323
339
  getPrintCertificatePages: () => getPrintCertificatePages,
@@ -338,6 +354,7 @@ __export(events_exports, {
338
354
  isBulletListFieldType: () => isBulletListFieldType,
339
355
  isButtonFieldType: () => isButtonFieldType,
340
356
  isCheckboxFieldType: () => isCheckboxFieldType,
357
+ isCodeToEvaluate: () => isCodeToEvaluate,
341
358
  isConditionMet: () => isConditionMet,
342
359
  isCountryFieldType: () => isCountryFieldType,
343
360
  isCustomFieldType: () => isCustomFieldType,
@@ -378,6 +395,7 @@ __export(events_exports, {
378
395
  isPageVisible: () => isPageVisible,
379
396
  isParagraphFieldType: () => isParagraphFieldType,
380
397
  isPhoneFieldType: () => isPhoneFieldType,
398
+ isPotentialDuplicate: () => isPotentialDuplicate,
381
399
  isPrintButtonFieldType: () => isPrintButtonFieldType,
382
400
  isQrReaderFieldType: () => isQrReaderFieldType,
383
401
  isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -411,12 +429,15 @@ __export(events_exports, {
411
429
  plainDateToLocalDate: () => plainDateToLocalDate,
412
430
  precompileActionSchemas: () => precompileActionSchemas,
413
431
  resolveDateOfEvent: () => resolveDateOfEvent,
432
+ resolveEventCustomFlags: () => resolveEventCustomFlags,
414
433
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
434
+ runClientFunction: () => runClientFunction,
415
435
  runFieldValidations: () => runFieldValidations,
416
436
  runStructuralValidations: () => runStructuralValidations,
417
437
  safeUnion: () => safeUnion,
418
438
  status: () => status,
419
439
  timePeriodToDateRange: () => timePeriodToDateRange,
440
+ todayISO: () => todayISO,
420
441
  user: () => user,
421
442
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
422
443
  validate: () => validate,
@@ -607,12 +628,14 @@ var SystemScopeType = z2.enum([
607
628
  "organisation.read-locations",
608
629
  "user.read",
609
630
  "user.create",
610
- "user.edit"
631
+ "user.edit",
632
+ "user.search"
611
633
  ]);
612
634
  var UserScopeType = SystemScopeType.extract([
613
635
  "user.read",
614
636
  "user.create",
615
- "user.edit"
637
+ "user.edit",
638
+ "user.search"
616
639
  ]);
617
640
  var ScopesWithRoleOption = UserScopeType.extract(["user.edit", "user.create"]);
618
641
  var UserScopeV2 = z2.discriminatedUnion("type", [
@@ -621,7 +644,7 @@ var UserScopeV2 = z2.discriminatedUnion("type", [
621
644
  options: AllUserScopeOptions.optional()
622
645
  }),
623
646
  z2.object({
624
- type: UserScopeType.extract(["user.read"]),
647
+ type: UserScopeType.extract(["user.read", "user.search"]),
625
648
  options: AccessLevelOptions.optional()
626
649
  })
627
650
  ]);
@@ -689,18 +712,26 @@ var unflattenScope = (input) => {
689
712
  return { type, options };
690
713
  };
691
714
  var EncodedScope = z2.string().brand("EncodedScope");
692
- var decodeScope = (query) => {
693
- 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, {
694
721
  ignoreQueryPrefix: true,
695
722
  comma: true,
696
723
  allowDots: true
697
724
  });
698
725
  const unflattenedScope = unflattenScope(scope);
699
- return Scope.safeParse(unflattenedScope)?.data;
726
+ const result = Scope.safeParse(unflattenedScope)?.data;
727
+ decodedScopeCache.set(encodedScope, result);
728
+ return result;
700
729
  };
701
730
  var DEFAULT_SCOPE_OPTIONS = {
702
731
  placeOfEvent: JurisdictionFilter.enum.all,
703
- accessLevel: JurisdictionFilter.enum.all
732
+ accessLevel: JurisdictionFilter.enum.all,
733
+ registeredIn: JurisdictionFilter.enum.all,
734
+ declaredIn: JurisdictionFilter.enum.all
704
735
  };
705
736
  function getAcceptedScopesByType({
706
737
  acceptedScopes,
@@ -1073,7 +1104,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1073
1104
  ShowConditional,
1074
1105
  // Action can be shown to the user in the list but as disabled
1075
1106
  EnableConditional
1076
- ]);
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
+ });
1077
1111
  var DisplayOnReviewConditional = z7.object({
1078
1112
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1079
1113
  conditional: Conditional
@@ -1088,8 +1122,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1088
1122
  // Field output can be shown / hidden on the review page
1089
1123
  DisplayOnReviewConditional
1090
1124
  ]).meta({
1091
- description: "Field conditional configuration",
1092
- 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."
1093
1127
  });
1094
1128
 
1095
1129
  // ../commons/src/events/FieldType.ts
@@ -1186,6 +1220,11 @@ var FieldTypesToHideInReview = [
1186
1220
  FieldType.ALPHA_PRINT_BUTTON,
1187
1221
  FieldType.ALPHA_HIDDEN
1188
1222
  ];
1223
+ var HiddenFieldTypes = [
1224
+ FieldType.HTTP,
1225
+ FieldType.QUERY_PARAM_READER,
1226
+ FieldType.ALPHA_HIDDEN
1227
+ ];
1189
1228
 
1190
1229
  // ../commons/src/events/FieldValue.ts
1191
1230
  var z12 = __toESM(require("zod/v4"));
@@ -1312,7 +1351,7 @@ function plainDateToLocalDate(date) {
1312
1351
  // ../commons/src/events/FieldValue.ts
1313
1352
  var TextValue = z12.string();
1314
1353
  var HiddenFieldValue = z12.string();
1315
- var NonEmptyTextValue = TextValue.min(1);
1354
+ var NonEmptyTextValue = z12.string().trim().min(1);
1316
1355
  var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
1317
1356
  var AgeValue = z12.object({
1318
1357
  age: z12.number(),
@@ -1341,6 +1380,7 @@ var DateRangeFieldValue = z12.object({
1341
1380
  var EmailValue = z12.email();
1342
1381
  var CheckboxFieldValue = z12.boolean();
1343
1382
  var NumberFieldValue = z12.number();
1383
+ var SignatureFieldValue = FileFieldValue;
1344
1384
  var ButtonFieldValue = z12.number();
1345
1385
  var VerificationStatusValue = z12.enum([
1346
1386
  "verified",
@@ -1409,28 +1449,20 @@ function schemaPriority(schema) {
1409
1449
  return idx === -1 ? 9999 : idx;
1410
1450
  }
1411
1451
  function safeUnion(schemas) {
1452
+ const sortedSchemas = [...schemas].sort(
1453
+ (a, b) => schemaPriority(a) - schemaPriority(b)
1454
+ );
1412
1455
  return z12.any().superRefine((val, ctx) => {
1413
- const successful = schemas.filter((s) => s.safeParse(val).success);
1414
- if (successful.length === 1) {
1415
- return;
1416
- }
1417
- if (successful.length === 0) {
1418
- ctx.addIssue({
1419
- code: "invalid_type",
1420
- expected: "custom",
1421
- message: "Value does not match any schema"
1422
- });
1423
- return;
1424
- }
1425
- successful.sort((a, b) => schemaPriority(a) - schemaPriority(b));
1426
- const best = successful[0];
1427
- if (!best.safeParse(val).success) {
1428
- ctx.addIssue({
1429
- expected: "custom",
1430
- code: "invalid_type",
1431
- message: "Value did not match the best schema"
1432
- });
1456
+ for (const schema of sortedSchemas) {
1457
+ if (schema.safeParse(val).success) {
1458
+ return;
1459
+ }
1433
1460
  }
1461
+ ctx.addIssue({
1462
+ code: "invalid_type",
1463
+ expected: "custom",
1464
+ message: "Value does not match any schema"
1465
+ });
1434
1466
  }).meta({
1435
1467
  description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
1436
1468
  });
@@ -1647,8 +1679,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1647
1679
  var ApprovedCorrectionAction = ActionBase.extend(
1648
1680
  z14.object({
1649
1681
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1650
- requestId: z14.string()
1682
+ requestId: z14.string(),
1651
1683
  // TODO move into 'content' property
1684
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1652
1685
  }).shape
1653
1686
  );
1654
1687
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1740,6 +1773,9 @@ var FlagConfig = z15.object({
1740
1773
  "Indicates if this flag expects an action to be performed to be cleared."
1741
1774
  ),
1742
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."
1743
1779
  });
1744
1780
  var ActionFlagConfig = z15.object({
1745
1781
  id: Flag,
@@ -1747,6 +1783,9 @@ var ActionFlagConfig = z15.object({
1747
1783
  conditional: Conditional.optional().describe(
1748
1784
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1749
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."
1750
1789
  });
1751
1790
 
1752
1791
  // ../commons/src/events/EventMetadata.ts
@@ -1768,8 +1807,7 @@ var ActionCreationMetadata = z16.object({
1768
1807
  ),
1769
1808
  createdByUserType: z16.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
1770
1809
  acceptedAt: z16.iso.datetime().describe("Timestamp when the action request was accepted."),
1771
- createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation."),
1772
- 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.")
1773
1811
  });
1774
1812
  var RegistrationCreationMetadata = ActionCreationMetadata.extend({
1775
1813
  registrationNumber: z16.string().describe(
@@ -1797,9 +1835,6 @@ var EventMetadata = z16.object({
1797
1835
  createdAtLocation: UUID.nullish().describe(
1798
1836
  "Location of the user who created the event."
1799
1837
  ),
1800
- createdBySignature: DocumentPath.nullish().describe(
1801
- "Signature of the user who created the event."
1802
- ),
1803
1838
  updatedAtLocation: UUID.nullish().describe(
1804
1839
  "Location of the user who last changed the status."
1805
1840
  ),
@@ -1988,7 +2023,8 @@ var Range = import_v4.z.object({
1988
2023
  });
1989
2024
  var ContainsFlags = import_v4.z.object({
1990
2025
  anyOf: import_v4.z.array(Flag).optional(),
1991
- noneOf: import_v4.z.array(Flag).optional()
2026
+ noneOf: import_v4.z.array(Flag).optional(),
2027
+ allOf: import_v4.z.array(Flag).optional()
1992
2028
  }).meta({
1993
2029
  id: "ContainsFlags"
1994
2030
  });
@@ -2174,14 +2210,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2174
2210
  }
2175
2211
  }).describe("Unique identifier for the field");
2176
2212
  var FieldReference = import_v43.default.object({
2177
- $$field: FieldId,
2213
+ $$field: FieldId.describe("Id of the field to reference"),
2178
2214
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2179
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."
2180
2219
  )
2181
- }).describe("Reference to a field by its ID");
2220
+ }).describe(
2221
+ "Reference to a field value, with an optional client-side computation applied."
2222
+ );
2223
+ function isCodeToEvaluate(v) {
2224
+ return !!v && typeof v === "object" && "$$code" in v;
2225
+ }
2226
+ var ComputedDefaultValue = import_v43.default.object({
2227
+ $$code: import_v43.default.string().describe(
2228
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2229
+ )
2230
+ }).describe("A context-only computation used as a field default value.");
2182
2231
  var ValidationConfig = import_v43.default.object({
2183
- validator: Conditional,
2184
- 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."
2185
2241
  });
2186
2242
  var requiredSchema = import_v43.default.union([
2187
2243
  import_v43.default.boolean(),
@@ -2212,7 +2268,7 @@ var BaseField = import_v43.default.object({
2212
2268
  "Indicates whether the field can be modified during record correction."
2213
2269
  ),
2214
2270
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2215
- "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."
2216
2272
  ),
2217
2273
  analytics: import_v43.default.boolean().default(false).optional().describe(
2218
2274
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2220,30 +2276,40 @@ var BaseField = import_v43.default.object({
2220
2276
  }).describe("Common properties shared across all field types.");
2221
2277
  var Divider = BaseField.extend({
2222
2278
  type: import_v43.default.literal(FieldType.DIVIDER)
2279
+ }).meta({
2280
+ description: "A horizontal line divider",
2281
+ id: "Divider"
2223
2282
  });
2224
2283
  var TextField = BaseField.extend({
2225
2284
  type: import_v43.default.literal(FieldType.TEXT),
2226
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2285
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2227
2286
  configuration: import_v43.default.object({
2228
2287
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2229
2288
  type: import_v43.default.enum(["text", "password"]).optional(),
2230
2289
  prefix: TranslationConfig.optional(),
2231
2290
  postfix: TranslationConfig.optional()
2232
2291
  }).default({ type: "text" }).optional()
2233
- }).describe("Text input");
2292
+ }).meta({
2293
+ description: "A text input field",
2294
+ id: "TextField"
2295
+ });
2234
2296
  var NumberField = BaseField.extend({
2235
2297
  type: import_v43.default.literal(FieldType.NUMBER),
2236
- defaultValue: NumberFieldValue.optional(),
2298
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2237
2299
  configuration: import_v43.default.object({
2238
2300
  min: import_v43.default.number().optional().describe("Minimum value"),
2239
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"),
2240
2303
  prefix: TranslationConfig.optional(),
2241
2304
  postfix: TranslationConfig.optional()
2242
2305
  }).optional()
2243
- }).describe("Number input");
2306
+ }).meta({
2307
+ description: "A number input field",
2308
+ id: "NumberField"
2309
+ });
2244
2310
  var TextAreaField = BaseField.extend({
2245
2311
  type: import_v43.default.literal(FieldType.TEXTAREA),
2246
- defaultValue: NonEmptyTextValue.optional(),
2312
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2247
2313
  configuration: import_v43.default.object({
2248
2314
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2249
2315
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2251,7 +2317,10 @@ var TextAreaField = BaseField.extend({
2251
2317
  prefix: TranslationConfig.optional(),
2252
2318
  postfix: TranslationConfig.optional()
2253
2319
  }).default({ rows: 4 }).optional()
2254
- }).describe("Multiline text input");
2320
+ }).meta({
2321
+ description: "A multiline text input",
2322
+ id: "TextAreaField"
2323
+ });
2255
2324
  var ImageMimeType = import_v43.default.enum([
2256
2325
  "image/png",
2257
2326
  "image/jpg",
@@ -2274,58 +2343,76 @@ var SignatureField = BaseField.extend({
2274
2343
  signaturePromptLabel: TranslationConfig.describe(
2275
2344
  "Title of the signature modal"
2276
2345
  ),
2277
- defaultValue: FieldValue.optional(),
2346
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2278
2347
  configuration: import_v43.default.object({
2279
2348
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2280
2349
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2281
2350
  }).default({
2282
2351
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2283
2352
  })
2284
- }).describe("Signature input field");
2353
+ }).meta({
2354
+ description: "A signature input field",
2355
+ id: "SignatureField"
2356
+ });
2285
2357
  var EmailField = BaseField.extend({
2286
2358
  type: import_v43.default.literal(FieldType.EMAIL),
2287
2359
  configuration: import_v43.default.object({
2288
2360
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2289
2361
  }).default({ maxLength: 255 }).optional(),
2290
- defaultValue: NonEmptyTextValue.optional()
2362
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2363
+ }).meta({
2364
+ description: "An email input field",
2365
+ id: "EmailField"
2291
2366
  });
2292
2367
  var DateField = BaseField.extend({
2293
2368
  type: import_v43.default.literal(FieldType.DATE),
2294
- 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)"),
2295
2370
  configuration: import_v43.default.object({
2296
2371
  notice: TranslationConfig.describe(
2297
2372
  "Text to display above the date input"
2298
2373
  ).optional()
2299
2374
  }).optional()
2300
- }).describe("A single date input (yyyy-MM-dd)");
2375
+ }).meta({
2376
+ description: "A date input (yyyy-MM-dd)",
2377
+ id: "DateField"
2378
+ });
2301
2379
  var AgeField = BaseField.extend({
2302
2380
  type: import_v43.default.literal(FieldType.AGE),
2303
- defaultValue: NumberFieldValue.optional(),
2381
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2304
2382
  configuration: import_v43.default.object({
2305
2383
  asOfDate: FieldReference,
2306
2384
  prefix: TranslationConfig.optional(),
2307
2385
  postfix: TranslationConfig.optional()
2308
2386
  })
2309
- }).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
+ });
2310
2391
  var TimeField = BaseField.extend({
2311
2392
  type: import_v43.default.literal(FieldType.TIME),
2312
- 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)"),
2313
2394
  configuration: import_v43.default.object({
2314
2395
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2315
2396
  notice: TranslationConfig.describe(
2316
2397
  "Text to display above the time input"
2317
2398
  ).optional()
2318
2399
  }).optional()
2319
- }).describe("A single date input (HH-mm)");
2400
+ }).meta({
2401
+ description: "A single time input (HH-mm)",
2402
+ id: "TimeField"
2403
+ });
2320
2404
  var DateRangeField = BaseField.extend({
2321
2405
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2322
- defaultValue: DateRangeFieldValue.optional(),
2406
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2323
2407
  configuration: import_v43.default.object({
2324
2408
  notice: TranslationConfig.describe(
2325
2409
  "Text to display above the date input"
2326
2410
  ).optional()
2327
2411
  }).optional()
2328
- }).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
+ });
2329
2416
  var HtmlFontVariant = import_v43.default.enum([
2330
2417
  "reg12",
2331
2418
  "reg14",
@@ -2369,21 +2456,33 @@ var ImageViewField = BaseField.extend({
2369
2456
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2370
2457
  defaultValue: NonEmptyTextValue.optional(),
2371
2458
  configuration: ImageConfiguration
2372
- }).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
+ });
2373
2463
  var Paragraph = BaseField.extend({
2374
2464
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2375
2465
  configuration: ParagraphConfiguration
2376
- }).describe("A read-only HTML <p> paragraph");
2466
+ }).meta({
2467
+ description: "A read-only HTML <p> paragraph",
2468
+ id: "Paragraph"
2469
+ });
2377
2470
  var Heading = BaseField.extend({
2378
2471
  type: import_v43.default.literal(FieldType.HEADING),
2379
2472
  configuration: HeadingConfiguration
2380
- }).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
+ });
2381
2477
  var PageHeader = BaseField.extend({
2382
2478
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2383
- }).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
+ });
2384
2483
  var File = BaseField.extend({
2385
2484
  type: import_v43.default.literal(FieldType.FILE),
2386
- defaultValue: FileFieldValue.optional(),
2485
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2387
2486
  configuration: import_v43.default.object({
2388
2487
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2389
2488
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2399,7 +2498,10 @@ var File = BaseField.extend({
2399
2498
  }).default({
2400
2499
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2401
2500
  })
2402
- }).describe("File upload");
2501
+ }).meta({
2502
+ description: "A file upload field",
2503
+ id: "File"
2504
+ });
2403
2505
  var SelectOption = import_v43.default.object({
2404
2506
  value: import_v43.default.string().describe("The value of the option"),
2405
2507
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2407,7 +2509,7 @@ var SelectOption = import_v43.default.object({
2407
2509
  });
2408
2510
  var NumberWithUnitField = BaseField.extend({
2409
2511
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2410
- defaultValue: NumberWithUnitFieldValue.optional(),
2512
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2411
2513
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2412
2514
  configuration: import_v43.default.object({
2413
2515
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2416,17 +2518,23 @@ var NumberWithUnitField = BaseField.extend({
2416
2518
  "Placeholder for the number field"
2417
2519
  )
2418
2520
  }).optional()
2419
- }).describe("Number with unit input");
2521
+ }).meta({
2522
+ description: "A number with unit input field",
2523
+ id: "NumberWithUnitField"
2524
+ });
2420
2525
  var RadioGroup = BaseField.extend({
2421
2526
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2422
- defaultValue: TextValue.optional(),
2527
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2423
2528
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2424
2529
  configuration: import_v43.default.object({
2425
2530
  styles: import_v43.default.object({
2426
2531
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2427
2532
  }).optional()
2428
2533
  }).optional()
2429
- }).describe("Grouped radio options");
2534
+ }).meta({
2535
+ description: "A grouped radio button field",
2536
+ id: "RadioGroup"
2537
+ });
2430
2538
  var BulletList = BaseField.extend({
2431
2539
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2432
2540
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2435,10 +2543,13 @@ var BulletList = BaseField.extend({
2435
2543
  fontVariant: HtmlFontVariant.optional()
2436
2544
  }).optional()
2437
2545
  }).default({})
2438
- }).describe("A list of bullet points");
2546
+ }).meta({
2547
+ description: "A list of bullet points",
2548
+ id: "BulletList"
2549
+ });
2439
2550
  var Select = BaseField.extend({
2440
2551
  type: import_v43.default.literal(FieldType.SELECT),
2441
- defaultValue: TextValue.optional(),
2552
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2442
2553
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2443
2554
  noOptionsMessage: TranslationConfig.optional().describe(
2444
2555
  `
@@ -2450,16 +2561,22 @@ var Select = BaseField.extend({
2450
2561
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2451
2562
  `
2452
2563
  )
2453
- }).describe("Select input");
2564
+ }).meta({
2565
+ description: "A select input field",
2566
+ id: "Select"
2567
+ });
2454
2568
  var SelectDateRangeOption = import_v43.default.object({
2455
2569
  value: SelectDateRangeValue.describe("The value of the option"),
2456
2570
  label: TranslationConfig.describe("The label of the option")
2457
2571
  });
2458
2572
  var SelectDateRangeField = BaseField.extend({
2459
2573
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2460
- defaultValue: SelectDateRangeValue.optional(),
2574
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2461
2575
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2462
- }).describe("Select input with date range options");
2576
+ }).meta({
2577
+ description: "A date range selection field",
2578
+ id: "SelectDateRangeField"
2579
+ });
2463
2580
  var NameConfig = import_v43.default.object({
2464
2581
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2465
2582
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2471,7 +2588,7 @@ var NameField = BaseField.extend({
2471
2588
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2472
2589
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2473
2590
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2474
- }).optional(),
2591
+ }).or(ComputedDefaultValue).optional(),
2475
2592
  configuration: import_v43.default.object({
2476
2593
  name: NameConfig.default({
2477
2594
  firstname: { required: true },
@@ -2490,26 +2607,41 @@ var NameField = BaseField.extend({
2490
2607
  surname: { required: true }
2491
2608
  }
2492
2609
  }).optional()
2493
- }).describe("Name input field");
2610
+ }).meta({
2611
+ description: "A field for entering a persons name",
2612
+ id: "NameField"
2613
+ });
2494
2614
  var PhoneField = BaseField.extend({
2495
- defaultValue: NonEmptyTextValue.optional(),
2615
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2496
2616
  type: import_v43.default.literal(FieldType.PHONE)
2497
- }).describe("Phone input field");
2617
+ }).meta({
2618
+ description: "A field for entering a phone number",
2619
+ id: "PhoneField"
2620
+ });
2498
2621
  var IdField = BaseField.extend({
2499
- defaultValue: NonEmptyTextValue.optional(),
2622
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2500
2623
  type: import_v43.default.literal(FieldType.ID)
2501
- }).describe("ID input field");
2624
+ }).meta({
2625
+ description: "A field for entering an ID",
2626
+ id: "IdField"
2627
+ });
2502
2628
  var Checkbox = BaseField.extend({
2503
2629
  type: import_v43.default.literal(FieldType.CHECKBOX),
2504
- defaultValue: CheckboxFieldValue.default(false)
2505
- }).describe("Boolean checkbox field");
2630
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2631
+ }).meta({
2632
+ description: "A boolean checkbox field",
2633
+ id: "Checkbox"
2634
+ });
2506
2635
  var Country = BaseField.extend({
2507
2636
  type: import_v43.default.literal(FieldType.COUNTRY),
2508
- defaultValue: NonEmptyTextValue.optional(),
2637
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2509
2638
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2510
2639
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2511
2640
  )
2512
- }).describe("Country select field");
2641
+ }).meta({
2642
+ description: "A field for selecting a country",
2643
+ id: "Country"
2644
+ });
2513
2645
  var AllowedLocations = JurisdictionReference.optional().describe(
2514
2646
  "Limits which location options are selectable depending on user jurisdiction and location."
2515
2647
  );
@@ -2518,28 +2650,33 @@ var AdministrativeAreas = import_v43.default.enum([
2518
2650
  "HEALTH_FACILITY",
2519
2651
  "CRVS_OFFICE"
2520
2652
  ]);
2521
- var AdministrativeAreaConfiguration = import_v43.default.object({
2522
- partOf: FieldReference.optional().describe("Parent location"),
2523
- type: AdministrativeAreas,
2524
- allowedLocations: AllowedLocations
2525
- }).describe("Administrative area options");
2526
2653
  var AdministrativeAreaField = BaseField.extend({
2527
2654
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2528
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2529
- configuration: AdministrativeAreaConfiguration
2530
- }).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
+ });
2531
2665
  var LocationInput = BaseField.extend({
2532
2666
  type: import_v43.default.literal(FieldType.LOCATION),
2533
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2667
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2534
2668
  configuration: import_v43.default.object({
2535
2669
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2536
2670
  allowedLocations: AllowedLocations
2537
2671
  }).optional()
2538
- }).describe("Input field for a location");
2672
+ }).meta({
2673
+ description: "A field for selecting a location",
2674
+ id: "LocationInput"
2675
+ });
2539
2676
  var FileUploadWithOptions = BaseField.extend({
2540
2677
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2541
2678
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2542
- defaultValue: FileFieldWithOptionValue.optional(),
2679
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2543
2680
  configuration: import_v43.default.object({
2544
2681
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2545
2682
  maxImageSize: import_v43.default.object({
@@ -2549,15 +2686,18 @@ var FileUploadWithOptions = BaseField.extend({
2549
2686
  }).default({
2550
2687
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2551
2688
  })
2689
+ }).meta({
2690
+ description: "A field for uploading files with file type options",
2691
+ id: "FileUploadWithOptions"
2552
2692
  });
2553
2693
  var Facility = BaseField.extend({
2554
2694
  type: import_v43.default.literal(FieldType.FACILITY),
2555
- defaultValue: NonEmptyTextValue.optional(),
2695
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2556
2696
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2557
2697
  }).describe("Input field for a facility");
2558
2698
  var Office = BaseField.extend({
2559
2699
  type: import_v43.default.literal(FieldType.OFFICE),
2560
- defaultValue: NonEmptyTextValue.optional(),
2700
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2561
2701
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2562
2702
  }).describe("Input field for an office");
2563
2703
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2593,8 +2733,11 @@ var Address = BaseField.extend({
2593
2733
  ).optional(),
2594
2734
  allowedLocations: AllowedLocations
2595
2735
  }).optional(),
2596
- defaultValue: DefaultAddressFieldValue.optional()
2597
- }).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
+ });
2598
2741
  var StaticDataEntry = import_v43.default.object({
2599
2742
  id: import_v43.default.string().describe("ID for the data entry."),
2600
2743
  label: TranslationConfig,
@@ -2609,7 +2752,10 @@ var DataField = BaseField.extend({
2609
2752
  subtitle: TranslationConfig.optional(),
2610
2753
  data: import_v43.default.array(DataEntry)
2611
2754
  })
2612
- }).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
+ });
2613
2759
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2614
2760
  var ButtonType = import_v43.default.enum([
2615
2761
  "primary",
@@ -2634,13 +2780,19 @@ var ButtonConfiguration = import_v43.default.object({
2634
2780
  });
2635
2781
  var ButtonField = BaseField.extend({
2636
2782
  type: import_v43.default.literal(FieldType.BUTTON),
2637
- defaultValue: ButtonFieldValue.optional(),
2783
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2638
2784
  configuration: ButtonConfiguration
2639
- }).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
+ });
2640
2789
  var FieldGroup = BaseField.extend({
2641
2790
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2642
2791
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2643
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"
2644
2796
  });
2645
2797
  var AlphaPrintButton = BaseField.extend({
2646
2798
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2650,10 +2802,13 @@ var AlphaPrintButton = BaseField.extend({
2650
2802
  "Label for the print button"
2651
2803
  )
2652
2804
  })
2653
- }).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
+ });
2654
2809
  var HttpField = BaseField.extend({
2655
2810
  type: import_v43.default.literal(FieldType.HTTP),
2656
- defaultValue: HttpFieldValue.optional(),
2811
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2657
2812
  configuration: import_v43.default.object({
2658
2813
  trigger: FieldReference.optional().describe(
2659
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."
@@ -2666,20 +2821,30 @@ var HttpField = BaseField.extend({
2666
2821
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2667
2822
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2668
2823
  })
2669
- }).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
+ });
2670
2828
  var AutocompleteField = BaseField.extend({
2671
2829
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2672
2830
  configuration: import_v43.default.object({
2673
- 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(),
2674
2834
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2675
2835
  defaultOptions: import_v43.default.array(
2676
2836
  import_v43.default.object({
2677
2837
  label: import_v43.default.string(),
2678
2838
  value: import_v43.default.string()
2679
2839
  })
2680
- ).optional()
2840
+ ).optional().describe(
2841
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2842
+ )
2681
2843
  })
2682
- }).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
+ });
2683
2848
  var SearchField = HttpField.extend({
2684
2849
  type: import_v43.default.literal(FieldType.SEARCH),
2685
2850
  configuration: SearchQuery.pick({
@@ -2712,6 +2877,9 @@ var SearchField = HttpField.extend({
2712
2877
  ok: TranslationConfig.optional()
2713
2878
  }).optional()
2714
2879
  })
2880
+ }).meta({
2881
+ description: "A search input field",
2882
+ id: "SearchField"
2715
2883
  });
2716
2884
  var LinkButtonField = BaseField.extend({
2717
2885
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2720,28 +2888,35 @@ var LinkButtonField = BaseField.extend({
2720
2888
  text: TranslationConfig.describe("Text to display on the button"),
2721
2889
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2722
2890
  })
2723
- }).describe("Button that opens a link");
2891
+ }).meta({
2892
+ description: "A button that opens a URL link",
2893
+ id: "LinkButtonField"
2894
+ });
2724
2895
  var VerificationStatus = BaseField.extend({
2725
2896
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2726
- defaultValue: VerificationStatusValue.optional(),
2897
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2727
2898
  configuration: import_v43.default.object({
2728
2899
  status: TranslationConfig.describe("Text to display on the status pill."),
2729
2900
  description: TranslationConfig.describe(
2730
2901
  "Explaining text on the banner in form."
2731
2902
  )
2732
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"
2733
2907
  });
2734
2908
  var QueryParamReaderField = BaseField.extend({
2735
2909
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2736
2910
  configuration: import_v43.default.object({
2737
2911
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2738
2912
  })
2739
- }).describe(
2740
- "A field that maps URL query params into form values and clears them afterward"
2741
- );
2913
+ }).meta({
2914
+ description: "A field that maps URL query params into form values and clears them afterward",
2915
+ id: "QueryParamReaderField"
2916
+ });
2742
2917
  var QrReaderField = BaseField.extend({
2743
2918
  type: import_v43.default.literal(FieldType.QR_READER),
2744
- defaultValue: QrReaderFieldValue.optional(),
2919
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2745
2920
  configuration: import_v43.default.object({
2746
2921
  validator: import_v43.default.any().meta({
2747
2922
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2749,21 +2924,27 @@ var QrReaderField = BaseField.extend({
2749
2924
  })
2750
2925
  }).optional()
2751
2926
  }).meta({
2752
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2927
+ description: "QR code reader field, including optional JSON Schema validator.",
2753
2928
  id: "QrReaderField"
2754
2929
  });
2755
2930
  var IdReaderField = BaseField.extend({
2756
2931
  type: import_v43.default.literal(FieldType.ID_READER),
2757
- defaultValue: IdReaderFieldValue.optional(),
2932
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2758
2933
  methods: import_v43.default.array(
2759
2934
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2760
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"
2761
2939
  });
2762
2940
  var CustomField = BaseField.extend({
2763
2941
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2764
2942
  defaultValue: CustomFieldValue.optional(),
2765
2943
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2766
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"
2767
2948
  });
2768
2949
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2769
2950
  var LoaderField = BaseField.extend({
@@ -2773,22 +2954,25 @@ var LoaderField = BaseField.extend({
2773
2954
  configuration: import_v43.default.object({
2774
2955
  text: TranslationConfig.describe("Display text above the loading spinner")
2775
2956
  })
2776
- }).describe(
2777
- "A non-interactive field that indicates an in progress operation in form"
2778
- );
2957
+ }).meta({
2958
+ description: "A non-interactive field that indicates an in progress operation in form",
2959
+ id: "LoaderField"
2960
+ });
2779
2961
  var HiddenField = BaseField.extend({
2780
2962
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2781
2963
  required: import_v43.default.boolean().default(false).optional(),
2782
2964
  defaultValue: TextValue.optional()
2783
- }).describe(
2784
- "A non-interactive, hidden field that only hold a value in the form"
2785
- );
2965
+ }).meta({
2966
+ description: "A non-interactive, hidden field that only hold a value in the form",
2967
+ id: "HiddenField"
2968
+ });
2786
2969
  var UserRoleField = BaseField.extend({
2787
2970
  type: import_v43.default.literal(FieldType.USER_ROLE),
2788
2971
  defaultValue: TextValue.optional()
2789
- }).describe(
2790
- "A select dropdown that is automatically populated with available user roles"
2791
- );
2972
+ }).meta({
2973
+ description: "A select dropdown that is automatically populated with available user roles",
2974
+ id: "UserRoleField"
2975
+ });
2792
2976
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2793
2977
  FieldGroup,
2794
2978
  Address,
@@ -2887,16 +3071,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2887
3071
  type: z21.literal(PageTypes.enum.VERIFICATION),
2888
3072
  actions: VerificationActionConfig
2889
3073
  });
2890
- var PageConfig = z21.discriminatedUnion("type", [
2891
- FormPageConfig,
2892
- VerificationPageConfig
2893
- ]);
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
+ });
2894
3078
 
2895
3079
  // ../commons/src/events/FormConfig.ts
2896
3080
  var DeclarationFormConfig = z22.object({
2897
3081
  label: TranslationConfig.describe("Human readable description of the form"),
2898
3082
  pages: z22.array(FormPageConfig)
2899
- }).describe("Configuration of the declaration form.");
3083
+ }).meta({
3084
+ id: "DeclarationFormConfig",
3085
+ description: "Configuration of the declaration form."
3086
+ });
2900
3087
  var ActionFormConfig = z22.object({
2901
3088
  label: TranslationConfig.describe("Human readable description of the form"),
2902
3089
  pages: z22.array(PageConfig)
@@ -2996,6 +3183,9 @@ var DeduplicationConfig = z23.object({
2996
3183
  id: z23.string(),
2997
3184
  label: TranslationConfig,
2998
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."
2999
3189
  });
3000
3190
 
3001
3191
  // ../commons/src/events/ActionConfig.ts
@@ -3033,6 +3223,57 @@ var ReadActionConfig = ActionConfigBase.extend(
3033
3223
  conditionals: z24.never().optional().describe("Read-action can not be disabled or hidden with conditionals.")
3034
3224
  }).shape
3035
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
+ );
3036
3277
  var DeclareConfig = DeclarationActionBase.extend(
3037
3278
  z24.object({
3038
3279
  type: z24.literal(ActionType.DECLARE),
@@ -3095,7 +3336,17 @@ var RequestCorrectionConfig = ActionConfigBase.extend(
3095
3336
  correctionForm: ActionFormConfig
3096
3337
  }).shape
3097
3338
  );
3098
- 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(
3099
3350
  z24.object({
3100
3351
  type: z24.literal(ActionType.CUSTOM),
3101
3352
  customActionType: z24.string().describe("Type identifier of the custom action."),
@@ -3106,24 +3357,85 @@ var CustomActionConfig = ActionConfigBase.merge(
3106
3357
  auditHistoryLabel: TranslationConfig.describe(
3107
3358
  'The label to show in audit history for this action. For example "Approved".'
3108
3359
  )
3109
- })
3360
+ }).shape
3110
3361
  );
3111
3362
  var ActionConfig = z24.discriminatedUnion("type", [
3112
3363
  /*
3113
3364
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3114
3365
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3115
3366
  */
3116
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3117
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3118
- RejectConfig.meta({ id: "RejectActionConfig" }),
3119
- 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
+ }),
3120
3411
  PrintCertificateActionConfig.meta({
3121
- 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."
3122
3430
  }),
3123
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3124
- EditActionConfig.meta({ id: "EditActionConfig" }),
3125
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3126
- 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
+ })
3127
3439
  ]).describe(
3128
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."
3129
3441
  ).meta({ id: "ActionConfig" });
@@ -3199,7 +3511,10 @@ var Field = BaseField2.extend({
3199
3511
  }).describe("Custom field defined for the summary view.");
3200
3512
  var SummaryConfig = z27.object({
3201
3513
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3202
- }).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
+ });
3203
3518
 
3204
3519
  // ../commons/src/events/AdvancedSearchConfig.ts
3205
3520
  var z28 = __toESM(require("zod/v4"));
@@ -3270,6 +3585,9 @@ var BaseField3 = z28.object({
3270
3585
  ),
3271
3586
  validations: z28.array(ValidationConfig).optional().describe(
3272
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.`
3273
3591
  )
3274
3592
  });
3275
3593
  var SearchQueryParams = z28.object({
@@ -3323,6 +3641,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3323
3641
  var AdvancedSearchConfig = z28.object({
3324
3642
  title: TranslationConfig.describe("Advanced search tab title"),
3325
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()`)."
3326
3647
  });
3327
3648
 
3328
3649
  // ../commons/src/events/utils.ts
@@ -3341,9 +3662,11 @@ var z30 = __toESM(require("zod/v4"));
3341
3662
  var z29 = __toESM(require("zod/v4"));
3342
3663
  function getDynamicNameValue(field3) {
3343
3664
  const nameConfiguration = field3.configuration?.name;
3665
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3666
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3344
3667
  return z29.object({
3345
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3346
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3668
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3669
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3347
3670
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3348
3671
  });
3349
3672
  }
@@ -3690,7 +4013,7 @@ var isHiddenFieldType = (field3) => {
3690
4013
  return field3.config.type === FieldType.ALPHA_HIDDEN;
3691
4014
  };
3692
4015
  var isNonInteractiveFieldType = (field3) => {
3693
- 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;
3694
4017
  };
3695
4018
 
3696
4019
  // ../commons/src/conditionals/validate.ts
@@ -3726,7 +4049,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3726
4049
  }
3727
4050
  return current;
3728
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
+ }
3729
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
+ }
3730
4083
  ajv.addKeyword({
3731
4084
  keyword: "daysFromDate",
3732
4085
  type: "string",
@@ -3771,7 +4124,7 @@ ajv.addKeyword({
3771
4124
  $data: true,
3772
4125
  errors: true,
3773
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.
3774
- validate(schema, data, _2, dataContext) {
4127
+ validate(_schema, data, _2, dataContext) {
3775
4128
  const locationIdInput = data;
3776
4129
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3777
4130
  return locations.some((location) => location.id === locationIdInput);
@@ -3799,6 +4152,26 @@ function precompileActionSchemas(eventConfigurations) {
3799
4152
  function isAgeValue(value) {
3800
4153
  return typeof value === "object" && value !== null && "age" in value && typeof value.age === "number";
3801
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
+ });
3802
4175
  function validate(schema, data) {
3803
4176
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3804
4177
  if ("$form" in data) {
@@ -3835,17 +4208,14 @@ function isOnline() {
3835
4208
  }
3836
4209
  return true;
3837
4210
  }
3838
- function isConditionMet(conditional, values, context, eventIndex) {
3839
- return validate(conditional, {
3840
- $form: values,
3841
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3842
- $online: isOnline(),
3843
- $user: context.user,
3844
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3845
- $flags: eventIndex?.flags ?? [],
3846
- $status: eventIndex?.status,
3847
- $event: context.event
3848
- });
4211
+ function isConditionMet(conditional, values, context) {
4212
+ return validate(
4213
+ conditional,
4214
+ buildClientFunctionContext({
4215
+ form: mergeWithBaseFormState(values, context),
4216
+ validatorContext: context
4217
+ })
4218
+ );
3849
4219
  }
3850
4220
  function getConditionalActionsForField(field3, values) {
3851
4221
  if (!field3.conditionals) {
@@ -3853,9 +4223,9 @@ function getConditionalActionsForField(field3, values) {
3853
4223
  }
3854
4224
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3855
4225
  }
3856
- function areConditionsMet(conditions, values, context, event2) {
4226
+ function areConditionsMet(conditions, values, context, _event) {
3857
4227
  return conditions.every(
3858
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4228
+ (condition) => isConditionMet(condition.conditional, values, context)
3859
4229
  );
3860
4230
  }
3861
4231
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3865,14 +4235,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3865
4235
  if (!hasRule) {
3866
4236
  return true;
3867
4237
  }
3868
- const validConditionals = getConditionalActionsForField(field3, {
3869
- $form: form,
3870
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3871
- $online: isOnline(),
3872
- $user: context.user,
3873
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3874
- $event: context.event
3875
- });
4238
+ const validConditionals = getConditionalActionsForField(
4239
+ field3,
4240
+ buildClientFunctionContext({
4241
+ form: mergeWithBaseFormState(form, context),
4242
+ validatorContext: context
4243
+ })
4244
+ );
3876
4245
  return validConditionals.includes(conditionalType);
3877
4246
  }
3878
4247
  function isFieldVisible(field3, form, context) {
@@ -3898,7 +4267,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3898
4267
  if (!rule) {
3899
4268
  return true;
3900
4269
  }
3901
- 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
+ });
3902
4278
  }
3903
4279
  function isActionEnabled(actionConfig, event2, context) {
3904
4280
  return isActionConditionMet(
@@ -4057,19 +4433,10 @@ function runFieldValidations({
4057
4433
  if (!isFieldVisible(field3.config, form, context)) {
4058
4434
  return [];
4059
4435
  }
4060
- const conditionalParameters = {
4061
- $form: form,
4062
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4063
- /**
4064
- * In real use cases, there can be hundreds of thousands of locations.
4065
- * Make sure that the context contains only the locations that are needed for validation.
4066
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4067
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4068
- */
4069
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4070
- $online: isOnline(),
4071
- $user: context.user
4072
- };
4436
+ const conditionalParameters = buildClientFunctionContext({
4437
+ form: mergeWithBaseFormState(form, context),
4438
+ validatorContext: context
4439
+ });
4073
4440
  if (isFieldGroupFieldType(field3)) {
4074
4441
  const subfieldErrors = buildFormState(
4075
4442
  field3.config.fields,
@@ -4208,16 +4575,13 @@ function getActionConfig({
4208
4575
  actionType,
4209
4576
  customActionType
4210
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
+ }
4211
4581
  return eventConfiguration.actions.find((a) => {
4212
4582
  if (a.type === ActionType.CUSTOM && customActionType) {
4213
4583
  return a.customActionType === customActionType;
4214
4584
  }
4215
- if (actionType === ActionType.NOTIFY) {
4216
- return a.type === ActionType.DECLARE;
4217
- }
4218
- if (actionType === ActionType.APPROVE_CORRECTION || actionType === ActionType.REJECT_CORRECTION) {
4219
- return a.type === ActionType.REQUEST_CORRECTION;
4220
- }
4221
4585
  return a.type === actionType;
4222
4586
  });
4223
4587
  }
@@ -4251,7 +4615,7 @@ var getActionAnnotationFields = (actionConfig) => {
4251
4615
  if (actionConfig.type === ActionType.CUSTOM) {
4252
4616
  return actionConfig.form;
4253
4617
  }
4254
- if ("review" in actionConfig) {
4618
+ if ("review" in actionConfig && actionConfig.review != null) {
4255
4619
  return actionConfig.review.fields;
4256
4620
  }
4257
4621
  return [];
@@ -4302,17 +4666,16 @@ function isPageVisible(page, formValues, context) {
4302
4666
  }
4303
4667
  return isConditionMet(page.conditional, formValues, context);
4304
4668
  }
4305
- function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false, declarationContext) {
4669
+ function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false) {
4306
4670
  const base = (0, import_lodash.cloneDeep)(formValues);
4307
4671
  function fn(prevVisibilityContext) {
4308
- const visibilityForm = declarationContext ? { ...declarationContext, ...prevVisibilityContext } : prevVisibilityContext;
4309
4672
  const cleaned = (0, import_lodash.omitBy)(base, (value, fieldId) => {
4310
4673
  const fieldConfig = fields.filter((f) => f.id === fieldId);
4311
4674
  if (!fieldConfig.length) {
4312
4675
  return false;
4313
4676
  }
4314
4677
  const isHidden = fieldConfig.every(
4315
- (f) => !isFieldVisible(f, visibilityForm, validatorContext)
4678
+ (f) => !isFieldVisible(f, prevVisibilityContext, validatorContext)
4316
4679
  );
4317
4680
  if (!isHidden) {
4318
4681
  return false;
@@ -4330,7 +4693,7 @@ function omitHiddenPaginatedFields(formConfig, values, validatorContext, include
4330
4693
  const visibleFields = formConfig.pages.filter((p) => isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4331
4694
  const hiddenFields = formConfig.pages.filter((p) => !isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4332
4695
  const valuesExceptHiddenPage = (0, import_lodash.omitBy)(values, (_2, fieldId) => {
4333
- return hiddenFields.some((f) => f.id === fieldId);
4696
+ return hiddenFields.some((f) => f.id === fieldId) && !visibleFields.some((f) => f.id === fieldId);
4334
4697
  });
4335
4698
  return omitHiddenFields(
4336
4699
  visibleFields,
@@ -4377,13 +4740,10 @@ function getVisibleVerificationPageIds(pages, annotation, context) {
4377
4740
  }
4378
4741
  function omitHiddenAnnotationFields(actionConfig, declaration, annotation, context) {
4379
4742
  const annotationFields = getActionAnnotationFields(actionConfig);
4380
- return omitHiddenFields(
4381
- annotationFields,
4382
- annotation,
4383
- context,
4384
- false,
4385
- declaration
4386
- );
4743
+ return omitHiddenFields(annotationFields, annotation, {
4744
+ ...context,
4745
+ baseFormState: declaration
4746
+ });
4387
4747
  }
4388
4748
  function deepMerge(currentDocument, actionDocument) {
4389
4749
  const currentDocumentClone = (0, import_lodash.cloneDeep)(currentDocument);
@@ -4557,19 +4917,32 @@ function getPendingAction(actions) {
4557
4917
  }
4558
4918
  return pendingActions[0];
4559
4919
  }
4560
- function getCompleteActionAnnotation(annotation, event2, action) {
4920
+ function getCompleteActionAnnotation(event2, action) {
4561
4921
  if (action.originalActionId) {
4562
4922
  const originalAction = event2.actions.find(
4563
4923
  ({ id }) => id === action.originalActionId
4564
4924
  );
4565
4925
  if (originalAction?.status === ActionStatus.Requested) {
4566
- return deepMerge(
4567
- deepMerge(annotation, originalAction.annotation ?? {}),
4568
- action.annotation ?? {}
4569
- );
4926
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4570
4927
  }
4571
4928
  }
4572
- 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;
4573
4946
  }
4574
4947
  function getCompleteActionDeclaration(declaration, event2, action) {
4575
4948
  if (action.originalActionId) {
@@ -4589,7 +4962,7 @@ function getAcceptedActions(event2) {
4589
4962
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4590
4963
  ...action,
4591
4964
  declaration: getCompleteActionDeclaration({}, event2, action),
4592
- annotation: getCompleteActionAnnotation({}, event2, action)
4965
+ annotation: getCompleteActionAnnotation(event2, action)
4593
4966
  }));
4594
4967
  }
4595
4968
  var EXCLUDED_ACTIONS = [
@@ -4677,6 +5050,9 @@ function not(condition) {
4677
5050
  function never2() {
4678
5051
  return not(alwaysTrue());
4679
5052
  }
5053
+ function always() {
5054
+ return defineConditional(alwaysTrue());
5055
+ }
4680
5056
  function jsonFieldPath(field3) {
4681
5057
  return [field3.$$field, ...field3.$$subfield].join("/");
4682
5058
  }
@@ -5224,7 +5600,54 @@ function createFieldConditionals(fieldId) {
5224
5600
  }
5225
5601
  },
5226
5602
  required: [fieldId]
5227
- })
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
+ }
5228
5651
  };
5229
5652
  }
5230
5653
 
@@ -5312,7 +5735,7 @@ function validateActionFlags(event2, ctx) {
5312
5735
  const isInherentFlag = (value) => Object.values(InherentFlags).includes(value);
5313
5736
  const configuredFlagIds = event2.flags.map((flag2) => flag2.id);
5314
5737
  const actionFlagIds = event2.actions.flatMap(
5315
- (action) => action.flags.map((flag2) => flag2.id)
5738
+ (action) => (action.flags ?? []).map((flag2) => flag2.id)
5316
5739
  );
5317
5740
  for (const actionFlagId of actionFlagIds) {
5318
5741
  const isConfigured = configuredFlagIds.includes(actionFlagId);
@@ -5372,7 +5795,7 @@ var _EventConfigBase = z33.object({
5372
5795
  ),
5373
5796
  label: TranslationConfig.describe("Human-readable label for the event type."),
5374
5797
  actions: z33.array(ActionConfig).describe(
5375
- "Configuration of system-defined actions associated with the event."
5798
+ "Configuration of core and custom actions associated with the event."
5376
5799
  ),
5377
5800
  actionOrder: z33.array(z33.string()).optional().describe(
5378
5801
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5384,7 +5807,7 @@ var _EventConfigBase = z33.object({
5384
5807
  "Configuration of fields available in the advanced search feature."
5385
5808
  ),
5386
5809
  flags: z33.array(FlagConfig).optional().default([]).describe(
5387
- "Configuration of flags associated with the actions of this event type."
5810
+ "Configuration of custom flags associated with the actions of this event type."
5388
5811
  ),
5389
5812
  analytics: z33.boolean().optional().default(true).describe(
5390
5813
  "Indicates whether the records of this event type are included in analytics"
@@ -5397,8 +5820,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5397
5820
  validateActionFlags(event2, ctx);
5398
5821
  validateActionOrder(event2, ctx);
5399
5822
  }).meta({
5400
- id: "EventConfig"
5401
- }).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
+ });
5402
5826
 
5403
5827
  // ../commons/src/events/EventConfigInput.ts
5404
5828
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5621,6 +6045,9 @@ var WorkqueueColumnValue = z34.object({
5621
6045
  var WorkqueueColumn = z34.object({
5622
6046
  label: TranslationConfig,
5623
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`)."
5624
6051
  });
5625
6052
  function defineWorkqueuesColumns(workqueueColumns) {
5626
6053
  return workqueueColumns.map(
@@ -5823,18 +6250,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5823
6250
  query: true,
5824
6251
  columns: true
5825
6252
  });
5826
- var WorkqueueConfigInput = z37.object({
5827
- slug: z37.string().describe("Determines the url of the workqueue."),
5828
- name: TranslationConfig.describe(
5829
- "Title of the workflow (both in navigation and on the page)"
5830
- ),
5831
- query: CountryConfigQueryInputType,
5832
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5833
- "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."
5834
- ),
5835
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5836
- icon: AvailableIcons,
5837
- 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."
5838
6258
  });
5839
6259
  function defineWorkqueue(workqueueInput) {
5840
6260
  const queryInput = workqueueInput.query;
@@ -5895,6 +6315,11 @@ var BaseActionInput = z38.object({
5895
6315
  originalActionId: UUID.optional(),
5896
6316
  // should not be part of base action.
5897
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
+ ),
5898
6323
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5899
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.
5900
6325
  createdAtLocation: UUID.nullish().describe(
@@ -6012,7 +6437,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
6012
6437
  var ApproveCorrectionActionInput = BaseActionInput.extend(
6013
6438
  z38.object({
6014
6439
  requestId: z38.string(),
6015
- 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()
6016
6442
  }).shape
6017
6443
  );
6018
6444
  var ReadActionInput = BaseActionInput.extend(
@@ -6074,7 +6500,7 @@ var Draft = z39.object({
6074
6500
  }).describe(
6075
6501
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6076
6502
  );
6077
- var DraftInput = BaseActionInput.extend({
6503
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6078
6504
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6079
6505
  status: z39.enum([
6080
6506
  ActionStatus.Requested,
@@ -6148,7 +6574,6 @@ function getDeclarationActionCreationMetadata(actionType, actions) {
6148
6574
  createdAtLocation: requestAction?.createdAtLocation ?? acceptAction.createdAtLocation,
6149
6575
  acceptedAt: acceptAction.createdAt,
6150
6576
  createdByRole: requestAction?.createdByRole ?? acceptAction.createdByRole,
6151
- createdBySignature: requestAction?.createdBySignature ?? acceptAction.createdBySignature,
6152
6577
  registrationNumber
6153
6578
  };
6154
6579
  }
@@ -6162,6 +6587,8 @@ var updateActions = ActionTypes.extract([
6162
6587
  ActionType.ARCHIVE,
6163
6588
  ActionType.PRINT_CERTIFICATE,
6164
6589
  ActionType.REQUEST_CORRECTION,
6590
+ ActionType.APPROVE_CORRECTION,
6591
+ ActionType.REJECT_CORRECTION,
6165
6592
  ActionType.CUSTOM
6166
6593
  ]);
6167
6594
  function getActionUpdateMetadata(actions) {
@@ -6176,7 +6603,7 @@ function getActionUpdateMetadata(actions) {
6176
6603
  "createdAtLocation",
6177
6604
  "createdByRole"
6178
6605
  ];
6179
- 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(
6180
6607
  (_2, action) => {
6181
6608
  if (action.originalActionId) {
6182
6609
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6203,28 +6630,19 @@ function getLegalStatuses(actions) {
6203
6630
  // ../commons/src/events/state/flags.ts
6204
6631
  var import_lodash3 = require("lodash");
6205
6632
  var import_date_fns3 = require("date-fns");
6206
- function isEditInProgress(actions) {
6207
- return actions.at(-1)?.type === ActionType.EDIT;
6208
- }
6209
- function isCorrectionRequested(actions) {
6210
- return actions.reduce((prev, { type }) => {
6211
- if (type === ActionType.REQUEST_CORRECTION) {
6212
- return true;
6213
- }
6214
- if (type === ActionType.APPROVE_CORRECTION) {
6215
- 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;
6216
6639
  }
6217
- if (type === ActionType.REJECT_CORRECTION) {
6218
- return false;
6640
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6641
+ correctionRequestAction = action;
6642
+ break;
6219
6643
  }
6220
- return prev;
6221
- }, false);
6222
- }
6223
- function isDeclarationIncomplete(actions) {
6224
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6225
- }
6226
- function isRejected(actions) {
6227
- return actions.at(-1)?.type === ActionType.REJECT;
6644
+ }
6645
+ return correctionRequestAction;
6228
6646
  }
6229
6647
  function isPotentialDuplicate(actions) {
6230
6648
  return actions.reduce((prev, { type }) => {
@@ -6253,6 +6671,88 @@ function isFlagConditionMet(conditional, form, action) {
6253
6671
  }
6254
6672
  });
6255
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
+ }
6256
6756
  function resolveEventCustomFlags(event2, eventConfiguration) {
6257
6757
  const actions = getAcceptedActions(event2).filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6258
6758
  return actions.reduce((acc, action, idx) => {
@@ -6274,7 +6774,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6274
6774
  const declaration = aggregateActionDeclarations(eventUpToThisAction);
6275
6775
  const annotation = aggregateActionAnnotations(eventUpToThisAction);
6276
6776
  const form = { ...declaration, ...annotation };
6277
- const flagsWithMetConditions = actionConfig.flags.filter(
6777
+ const flagsWithMetConditions = (actionConfig.flags ?? []).filter(
6278
6778
  ({ conditional }) => (
6279
6779
  // If conditional is not provided, the flag is resolved
6280
6780
  conditional ? isFlagConditionMet(conditional, form, action) : true
@@ -6288,8 +6788,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6288
6788
  return (0, import_lodash3.uniq)(flags);
6289
6789
  }, []);
6290
6790
  }
6291
- function getEventFlags(event2, config) {
6292
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6791
+ function getActionStatusFlags(sortedActions) {
6293
6792
  const actionStatus = sortedActions.reduce(
6294
6793
  (actionStatuses, { type, status: status2 }) => ({
6295
6794
  ...actionStatuses,
@@ -6297,26 +6796,26 @@ function getEventFlags(event2, config) {
6297
6796
  }),
6298
6797
  {}
6299
6798
  );
6300
- 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]) => {
6301
6800
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6302
6801
  return flag2;
6303
6802
  });
6304
- if (isCorrectionRequested(sortedActions)) {
6305
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6306
- }
6307
- if (isDeclarationIncomplete(sortedActions)) {
6308
- flags.push(InherentFlags.INCOMPLETE);
6309
- }
6310
- if (isRejected(sortedActions)) {
6311
- flags.push(InherentFlags.REJECTED);
6312
- }
6313
- if (isPotentialDuplicate(sortedActions)) {
6314
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6315
- }
6316
- if (isEditInProgress(sortedActions)) {
6317
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6318
- }
6319
- 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
+ ];
6320
6819
  }
6321
6820
 
6322
6821
  // ../commons/src/events/state/index.ts
@@ -6362,17 +6861,6 @@ function getAssignedUserFromActions(actions) {
6362
6861
  return user2;
6363
6862
  }, null);
6364
6863
  }
6365
- function getAssignedUserSignatureFromActions(actions) {
6366
- return actions.reduce((signature, action) => {
6367
- if (action.type === ActionType.ASSIGN) {
6368
- return action.createdBySignature || null;
6369
- }
6370
- if (action.type === ActionType.UNASSIGN) {
6371
- return null;
6372
- }
6373
- return signature;
6374
- }, null);
6375
- }
6376
6864
  function deepDropNulls(obj) {
6377
6865
  if (Array.isArray(obj)) {
6378
6866
  return obj.map(deepDropNulls);
@@ -6468,10 +6956,8 @@ function getCurrentEventState(event2, config) {
6468
6956
  createdBy: creationAction.createdBy,
6469
6957
  createdByUserType: creationAction.createdByUserType,
6470
6958
  createdAtLocation: creationAction.createdAtLocation,
6471
- createdBySignature: creationAction.createdBySignature,
6472
6959
  updatedAt: acceptedActionMetadata.createdAt,
6473
6960
  assignedTo: getAssignedUserFromActions(acceptedActions),
6474
- assignedToSignature: getAssignedUserSignatureFromActions(acceptedActions),
6475
6961
  updatedBy: requestActionMetadata.createdBy,
6476
6962
  updatedAtLocation: requestActionMetadata.createdAtLocation,
6477
6963
  declaration,
@@ -6564,7 +7050,7 @@ function getActionAnnotation({
6564
7050
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6565
7051
  const actionWithCompleteAnnotation = action && {
6566
7052
  ...action,
6567
- annotation: getCompleteActionAnnotation({}, event2, action)
7053
+ annotation: getCompleteActionAnnotation(event2, action)
6568
7054
  };
6569
7055
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6570
7056
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6636,6 +7122,9 @@ function createFieldConfig(fieldId, options) {
6636
7122
  }
6637
7123
 
6638
7124
  // ../commons/src/events/field.ts
7125
+ function evaluate(computationFn) {
7126
+ return { $$code: computationFn.toString() };
7127
+ }
6639
7128
  function field(fieldId, options = {}) {
6640
7129
  return {
6641
7130
  ...createFieldConditionals(fieldId),
@@ -7329,6 +7818,11 @@ var TENNIS_CLUB_DECLARATION_REVIEW = {
7329
7818
  id: "signature.upload.modal.title",
7330
7819
  defaultMessage: "Draw signature",
7331
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
7332
7826
  }
7333
7827
  }
7334
7828
  ]
@@ -7885,6 +8379,20 @@ var tennisClubMembershipEvent = defineConfig({
7885
8379
  },
7886
8380
  review: TENNIS_CLUB_DECLARATION_REVIEW
7887
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
+ },
7888
8396
  {
7889
8397
  type: ActionType.REJECT,
7890
8398
  label: {
@@ -8127,6 +8635,17 @@ var tennisClubMembershipEvent = defineConfig({
8127
8635
  }
8128
8636
  }
8129
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
+ ],
8130
8649
  advancedSearch: [
8131
8650
  {
8132
8651
  title: {
@@ -9730,7 +10249,6 @@ var eventQueryDataGenerator = (overrides = {}, seed = 1) => {
9730
10249
  createdBy: overrides.createdBy ?? generateUuid(rng),
9731
10250
  createdAtLocation: overrides.createdAtLocation ?? generateUuid(rng),
9732
10251
  updatedAtLocation: overrides.updatedAtLocation ?? generateUuid(rng),
9733
- createdBySignature: overrides.createdBySignature ?? generateRandomSignature(rng),
9734
10252
  updatedAt: overrides.updatedAt ?? (0, import_date_fns4.addDays)(new Date(createdAt), 1).toISOString(),
9735
10253
  assignedTo: overrides.assignedTo ?? null,
9736
10254
  updatedBy: overrides.updatedBy ?? generateUuid(rng),
@@ -9886,7 +10404,7 @@ function matchesJurisdictionFilter(locationIds, filter, user2) {
9886
10404
  return locationIds.some((id) => id === user2.primaryOfficeId);
9887
10405
  }
9888
10406
  if (filter === JurisdictionFilter.enum.administrativeArea) {
9889
- return user2.administrativeAreaId === null || locationIds.some((id) => id === user2.administrativeAreaId);
10407
+ return !user2.administrativeAreaId || locationIds.some((id) => id === user2.administrativeAreaId);
9890
10408
  }
9891
10409
  return true;
9892
10410
  }
@@ -9975,7 +10493,7 @@ function canAccessUserWithScope({
9975
10493
  }
9976
10494
  const hasAdministrativeAreaInHierarchy = userToAccess.administrativeHierarchy.some(
9977
10495
  (id) => user2.administrativeAreaId === id
9978
- ) || user2.administrativeAreaId === null;
10496
+ ) || !user2.administrativeAreaId;
9979
10497
  if (opts?.accessLevel === JurisdictionFilter.enum.administrativeArea && !hasAdministrativeAreaInHierarchy) {
9980
10498
  return false;
9981
10499
  }
@@ -10001,6 +10519,39 @@ function userCanAccessEventWithScopes(event2, scopes, user2, customActionType) {
10001
10519
  (scope) => canAccessEventWithScope(event2, scope, user2, customActionType)
10002
10520
  );
10003
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
+ }
10004
10555
 
10005
10556
  // ../commons/src/events/scopes.ts
10006
10557
  var ACTION_SCOPE_MAP = {
@@ -10075,6 +10626,25 @@ function isActionInScope({
10075
10626
  );
10076
10627
  return canAccess;
10077
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
+ }
10078
10648
 
10079
10649
  // ../commons/src/events/serializers/user/deserializer.ts
10080
10650
  function userDeserializer(serializedUserField, user2) {
@@ -10229,18 +10799,19 @@ var ACTION_FILTERS = {
10229
10799
  function filterActionsByFlags(actions, flags) {
10230
10800
  return actions.filter((action) => ACTION_FILTERS[action]?.(flags) ?? true);
10231
10801
  }
10802
+ var REJECTED_ACTIONS = [
10803
+ ActionType.READ,
10804
+ ActionType.NOTIFY,
10805
+ ActionType.CUSTOM,
10806
+ ActionType.EDIT,
10807
+ ActionType.ARCHIVE
10808
+ ];
10232
10809
  function getAvailableActionsWithoutFlagFilters(status2, flags) {
10233
10810
  if (flags.includes(InherentFlags.EDIT_IN_PROGRESS)) {
10234
10811
  return [ActionType.NOTIFY, ActionType.DECLARE, ActionType.REGISTER];
10235
10812
  }
10236
- if (flags.includes(InherentFlags.REJECTED)) {
10237
- return [
10238
- ActionType.READ,
10239
- ActionType.NOTIFY,
10240
- ActionType.CUSTOM,
10241
- ActionType.EDIT,
10242
- ActionType.ARCHIVE
10243
- ];
10813
+ if (flags.includes(InherentFlags.REJECTED) && status2 !== EventStatus.enum.ARCHIVED) {
10814
+ return REJECTED_ACTIONS;
10244
10815
  }
10245
10816
  return AVAILABLE_ACTIONS_BY_EVENT_STATUS[status2];
10246
10817
  }
@@ -10277,3 +10848,366 @@ function getFilePathsFromEvent(event2) {
10277
10848
  });
10278
10849
  return (0, import_lodash7.uniq)(filepaths);
10279
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
+ );