@opencrvs/toolkit 2.0.0-rc.cfdbeba → 2.0.0-rc.d0256c6

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 (59) 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 +269 -121
  4. package/dist/cli.js +507 -171
  5. package/dist/commons/api/router.d.ts +3403 -272
  6. package/dist/commons/application-config/index.d.ts +1 -0
  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/ActionDocument.d.ts +6 -0
  10. package/dist/commons/events/ActionInput.d.ts +114 -0
  11. package/dist/commons/events/AdvancedSearchConfig.d.ts +342 -0
  12. package/dist/commons/events/Draft.d.ts +4 -2
  13. package/dist/commons/events/EventDocument.d.ts +3 -0
  14. package/dist/commons/events/EventIndex.d.ts +0 -3
  15. package/dist/commons/events/EventMetadata.d.ts +0 -7
  16. package/dist/commons/events/FieldConfig.d.ts +382 -50
  17. package/dist/commons/events/FieldValue.d.ts +6 -0
  18. package/dist/commons/events/WorkqueueConfig.d.ts +150 -150
  19. package/dist/commons/events/field.d.ts +53 -1
  20. package/dist/commons/events/index.d.ts +2 -0
  21. package/dist/commons/events/locations.d.ts +21 -0
  22. package/dist/commons/events/mocks.test.utils.d.ts +19 -0
  23. package/dist/commons/events/scopes.d.ts +24 -1
  24. package/dist/commons/events/state/flags.d.ts +16 -0
  25. package/dist/commons/events/state/index.d.ts +0 -4
  26. package/dist/commons/events/state/utils.d.ts +12 -289
  27. package/dist/commons/events/utils.d.ts +13 -2
  28. package/dist/conditionals/index.js +60 -5
  29. package/dist/events/index.js +1005 -254
  30. package/dist/migrations/v2.0/add-birth-certificate-issuance-flag.d.ts.map +1 -1
  31. package/dist/migrations/v2.0/add-birth-certificate-issuance-flag.js +60 -35
  32. package/dist/migrations/v2.0/checkout-upstream-files.d.ts +1 -1
  33. package/dist/migrations/v2.0/checkout-upstream-files.d.ts.map +1 -1
  34. package/dist/migrations/v2.0/checkout-upstream-files.js +1 -2
  35. package/dist/migrations/v2.0/delete-infrastructure-directory.d.ts +9 -1
  36. package/dist/migrations/v2.0/delete-infrastructure-directory.d.ts.map +1 -1
  37. package/dist/migrations/v2.0/delete-infrastructure-directory.js +66 -20
  38. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts +3 -0
  39. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts.map +1 -0
  40. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.js +110 -0
  41. package/dist/migrations/v2.0/index.d.ts +5 -3
  42. package/dist/migrations/v2.0/index.d.ts.map +1 -1
  43. package/dist/migrations/v2.0/index.js +505 -169
  44. package/dist/migrations/v2.0/make-built-in-validate-actions-custom.d.ts.map +1 -1
  45. package/dist/migrations/v2.0/make-built-in-validate-actions-custom.js +90 -1
  46. package/dist/migrations/v2.0/merge-infrastructure-directory.d.ts +11 -1
  47. package/dist/migrations/v2.0/merge-infrastructure-directory.d.ts.map +1 -1
  48. package/dist/migrations/v2.0/merge-infrastructure-directory.js +17 -16
  49. package/dist/migrations/v2.0/migrate-scopes.d.ts.map +1 -1
  50. package/dist/migrations/v2.0/migrate-scopes.js +54 -30
  51. package/dist/migrations/v2.0/migrate-workqueue-configs.d.ts.map +1 -1
  52. package/dist/migrations/v2.0/migrate-workqueue-configs.js +140 -59
  53. package/dist/notification/index.js +809 -156
  54. package/dist/scopes/index.d.ts +6 -1
  55. package/dist/scopes/index.js +8 -4
  56. package/opencrvs-toolkit-2.0.0-rc.d0256c6.tgz +0 -0
  57. package/package.json +6 -2
  58. package/tsconfig.tsbuildinfo +1 -1
  59. package/opencrvs-toolkit-2.0.0-rc.cfdbeba.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,
@@ -200,6 +201,7 @@ __export(events_exports, {
200
201
  SelectDateRangeValue: () => SelectDateRangeValue,
201
202
  SelectOption: () => SelectOption,
202
203
  ShowConditional: () => ShowConditional,
204
+ SignatureFieldValue: () => SignatureFieldValue,
203
205
  StaticDataEntry: () => StaticDataEntry,
204
206
  StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
205
207
  SummaryConfig: () => SummaryConfig,
@@ -213,6 +215,10 @@ __export(events_exports, {
213
215
  UUID: () => UUID,
214
216
  UnassignActionInput: () => UnassignActionInput,
215
217
  UserAuditRecordInput: () => UserAuditRecordInput,
218
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS,
219
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP,
220
+ V2_DEFAULT_MOCK_LOCATIONS: () => V2_DEFAULT_MOCK_LOCATIONS,
221
+ V2_DEFAULT_MOCK_LOCATIONS_MAP: () => V2_DEFAULT_MOCK_LOCATIONS_MAP,
216
222
  ValidationConfig: () => ValidationConfig,
217
223
  VerificationActionConfig: () => VerificationActionConfig,
218
224
  VerificationPageConfig: () => VerificationPageConfig,
@@ -234,6 +240,7 @@ __export(events_exports, {
234
240
  ageToDate: () => ageToDate,
235
241
  aggregateActionAnnotations: () => aggregateActionAnnotations,
236
242
  aggregateActionDeclarations: () => aggregateActionDeclarations,
243
+ always: () => always,
237
244
  alwaysTrue: () => alwaysTrue,
238
245
  and: () => and,
239
246
  annotationActions: () => annotationActions,
@@ -241,10 +248,12 @@ __export(events_exports, {
241
248
  applyDraftToEventIndex: () => applyDraftToEventIndex,
242
249
  areCertificateConditionsMet: () => areCertificateConditionsMet,
243
250
  areConditionsMet: () => areConditionsMet,
251
+ buildClientFunctionContext: () => buildClientFunctionContext,
244
252
  buildFormState: () => buildFormState,
245
253
  canAccessEventWithScope: () => canAccessEventWithScope,
246
254
  canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
247
255
  canAccessUserWithScope: () => canAccessUserWithScope,
256
+ compileClientFunction: () => compileClientFunction,
248
257
  compositeFieldTypes: () => compositeFieldTypes,
249
258
  createEmptyDraft: () => createEmptyDraft,
250
259
  createFieldConditionals: () => createFieldConditionals,
@@ -265,6 +274,7 @@ __export(events_exports, {
265
274
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
266
275
  deserializeQuery: () => deserializeQuery,
267
276
  errorMessages: () => errorMessages,
277
+ evaluate: () => evaluate,
268
278
  event: () => event,
269
279
  eventMetadataLabelMap: () => eventMetadataLabelMap,
270
280
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -277,6 +287,7 @@ __export(events_exports, {
277
287
  findActiveDraftForEvent: () => findActiveDraftForEvent,
278
288
  findAllFields: () => findAllFields,
279
289
  findLastAssignmentAction: () => findLastAssignmentAction,
290
+ findPendingCorrectionAction: () => findPendingCorrectionAction,
280
291
  findRecordActionPages: () => findRecordActionPages,
281
292
  flag: () => flag,
282
293
  flattenFieldReference: () => flattenFieldReference,
@@ -302,13 +313,15 @@ __export(events_exports, {
302
313
  getActionConfig: () => getActionConfig,
303
314
  getActionReview: () => getActionReview,
304
315
  getActionReviewFields: () => getActionReviewFields,
316
+ getAdministrativeAreaHierarchy: () => getAdministrativeAreaHierarchy,
305
317
  getAllUniqueFields: () => getAllUniqueFields,
306
318
  getAnnotationFromDrafts: () => getAnnotationFromDrafts,
307
319
  getAssignedUserFromActions: () => getAssignedUserFromActions,
308
- getAssignedUserSignatureFromActions: () => getAssignedUserSignatureFromActions,
309
320
  getAssignmentStatus: () => getAssignmentStatus,
310
321
  getAvailableActionsForEvent: () => getAvailableActionsForEvent,
322
+ getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
311
323
  getCompleteActionAnnotation: () => getCompleteActionAnnotation,
324
+ getCompleteActionContent: () => getCompleteActionContent,
312
325
  getCompleteActionDeclaration: () => getCompleteActionDeclaration,
313
326
  getCurrentEventState: () => getCurrentEventState,
314
327
  getCustomActionFields: () => getCustomActionFields,
@@ -317,7 +330,9 @@ __export(events_exports, {
317
330
  getDeclarationFields: () => getDeclarationFields,
318
331
  getDeclarationPages: () => getDeclarationPages,
319
332
  getEventConfigById: () => getEventConfigById,
333
+ getEventFlags: () => getEventFlags,
320
334
  getFilePathsFromEvent: () => getFilePathsFromEvent,
335
+ getLocationHierarchy: () => getLocationHierarchy,
321
336
  getMixedPath: () => getMixedPath,
322
337
  getPendingAction: () => getPendingAction,
323
338
  getPrintCertificatePages: () => getPrintCertificatePages,
@@ -338,6 +353,7 @@ __export(events_exports, {
338
353
  isBulletListFieldType: () => isBulletListFieldType,
339
354
  isButtonFieldType: () => isButtonFieldType,
340
355
  isCheckboxFieldType: () => isCheckboxFieldType,
356
+ isCodeToEvaluate: () => isCodeToEvaluate,
341
357
  isConditionMet: () => isConditionMet,
342
358
  isCountryFieldType: () => isCountryFieldType,
343
359
  isCustomFieldType: () => isCustomFieldType,
@@ -378,6 +394,7 @@ __export(events_exports, {
378
394
  isPageVisible: () => isPageVisible,
379
395
  isParagraphFieldType: () => isParagraphFieldType,
380
396
  isPhoneFieldType: () => isPhoneFieldType,
397
+ isPotentialDuplicate: () => isPotentialDuplicate,
381
398
  isPrintButtonFieldType: () => isPrintButtonFieldType,
382
399
  isQrReaderFieldType: () => isQrReaderFieldType,
383
400
  isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -411,12 +428,15 @@ __export(events_exports, {
411
428
  plainDateToLocalDate: () => plainDateToLocalDate,
412
429
  precompileActionSchemas: () => precompileActionSchemas,
413
430
  resolveDateOfEvent: () => resolveDateOfEvent,
431
+ resolveEventCustomFlags: () => resolveEventCustomFlags,
414
432
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
433
+ runClientFunction: () => runClientFunction,
415
434
  runFieldValidations: () => runFieldValidations,
416
435
  runStructuralValidations: () => runStructuralValidations,
417
436
  safeUnion: () => safeUnion,
418
437
  status: () => status,
419
438
  timePeriodToDateRange: () => timePeriodToDateRange,
439
+ todayISO: () => todayISO,
420
440
  user: () => user,
421
441
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
422
442
  validate: () => validate,
@@ -607,12 +627,14 @@ var SystemScopeType = z2.enum([
607
627
  "organisation.read-locations",
608
628
  "user.read",
609
629
  "user.create",
610
- "user.edit"
630
+ "user.edit",
631
+ "user.search"
611
632
  ]);
612
633
  var UserScopeType = SystemScopeType.extract([
613
634
  "user.read",
614
635
  "user.create",
615
- "user.edit"
636
+ "user.edit",
637
+ "user.search"
616
638
  ]);
617
639
  var ScopesWithRoleOption = UserScopeType.extract(["user.edit", "user.create"]);
618
640
  var UserScopeV2 = z2.discriminatedUnion("type", [
@@ -621,7 +643,7 @@ var UserScopeV2 = z2.discriminatedUnion("type", [
621
643
  options: AllUserScopeOptions.optional()
622
644
  }),
623
645
  z2.object({
624
- type: UserScopeType.extract(["user.read"]),
646
+ type: UserScopeType.extract(["user.read", "user.search"]),
625
647
  options: AccessLevelOptions.optional()
626
648
  })
627
649
  ]);
@@ -700,7 +722,9 @@ var decodeScope = (query) => {
700
722
  };
701
723
  var DEFAULT_SCOPE_OPTIONS = {
702
724
  placeOfEvent: JurisdictionFilter.enum.all,
703
- accessLevel: JurisdictionFilter.enum.all
725
+ accessLevel: JurisdictionFilter.enum.all,
726
+ registeredIn: JurisdictionFilter.enum.all,
727
+ declaredIn: JurisdictionFilter.enum.all
704
728
  };
705
729
  function getAcceptedScopesByType({
706
730
  acceptedScopes,
@@ -1073,7 +1097,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1073
1097
  ShowConditional,
1074
1098
  // Action can be shown to the user in the list but as disabled
1075
1099
  EnableConditional
1076
- ]);
1100
+ ]).meta({
1101
+ id: "ActionConditional",
1102
+ 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."
1103
+ });
1077
1104
  var DisplayOnReviewConditional = z7.object({
1078
1105
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1079
1106
  conditional: Conditional
@@ -1088,8 +1115,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1088
1115
  // Field output can be shown / hidden on the review page
1089
1116
  DisplayOnReviewConditional
1090
1117
  ]).meta({
1091
- description: "Field conditional configuration",
1092
- id: "FieldConditional"
1118
+ id: "FieldConditional",
1119
+ 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
1120
  });
1094
1121
 
1095
1122
  // ../commons/src/events/FieldType.ts
@@ -1341,6 +1368,7 @@ var DateRangeFieldValue = z12.object({
1341
1368
  var EmailValue = z12.email();
1342
1369
  var CheckboxFieldValue = z12.boolean();
1343
1370
  var NumberFieldValue = z12.number();
1371
+ var SignatureFieldValue = FileFieldValue;
1344
1372
  var ButtonFieldValue = z12.number();
1345
1373
  var VerificationStatusValue = z12.enum([
1346
1374
  "verified",
@@ -1409,28 +1437,20 @@ function schemaPriority(schema) {
1409
1437
  return idx === -1 ? 9999 : idx;
1410
1438
  }
1411
1439
  function safeUnion(schemas) {
1440
+ const sortedSchemas = [...schemas].sort(
1441
+ (a, b) => schemaPriority(a) - schemaPriority(b)
1442
+ );
1412
1443
  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
- });
1444
+ for (const schema of sortedSchemas) {
1445
+ if (schema.safeParse(val).success) {
1446
+ return;
1447
+ }
1433
1448
  }
1449
+ ctx.addIssue({
1450
+ code: "invalid_type",
1451
+ expected: "custom",
1452
+ message: "Value does not match any schema"
1453
+ });
1434
1454
  }).meta({
1435
1455
  description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
1436
1456
  });
@@ -1647,8 +1667,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1647
1667
  var ApprovedCorrectionAction = ActionBase.extend(
1648
1668
  z14.object({
1649
1669
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1650
- requestId: z14.string()
1670
+ requestId: z14.string(),
1651
1671
  // TODO move into 'content' property
1672
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1652
1673
  }).shape
1653
1674
  );
1654
1675
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1740,6 +1761,9 @@ var FlagConfig = z15.object({
1740
1761
  "Indicates if this flag expects an action to be performed to be cleared."
1741
1762
  ),
1742
1763
  label: TranslationConfig.describe("Human readable label of the flag.")
1764
+ }).meta({
1765
+ id: "FlagConfig",
1766
+ description: "Configuration for a custom flag that can be added to or removed from records by event actions."
1743
1767
  });
1744
1768
  var ActionFlagConfig = z15.object({
1745
1769
  id: Flag,
@@ -1747,6 +1771,9 @@ var ActionFlagConfig = z15.object({
1747
1771
  conditional: Conditional.optional().describe(
1748
1772
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1749
1773
  )
1774
+ }).meta({
1775
+ id: "ActionFlagConfig",
1776
+ description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
1750
1777
  });
1751
1778
 
1752
1779
  // ../commons/src/events/EventMetadata.ts
@@ -1768,8 +1795,7 @@ var ActionCreationMetadata = z16.object({
1768
1795
  ),
1769
1796
  createdByUserType: z16.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
1770
1797
  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.")
1798
+ createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation.")
1773
1799
  });
1774
1800
  var RegistrationCreationMetadata = ActionCreationMetadata.extend({
1775
1801
  registrationNumber: z16.string().describe(
@@ -1797,9 +1823,6 @@ var EventMetadata = z16.object({
1797
1823
  createdAtLocation: UUID.nullish().describe(
1798
1824
  "Location of the user who created the event."
1799
1825
  ),
1800
- createdBySignature: DocumentPath.nullish().describe(
1801
- "Signature of the user who created the event."
1802
- ),
1803
1826
  updatedAtLocation: UUID.nullish().describe(
1804
1827
  "Location of the user who last changed the status."
1805
1828
  ),
@@ -2174,14 +2197,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2174
2197
  }
2175
2198
  }).describe("Unique identifier for the field");
2176
2199
  var FieldReference = import_v43.default.object({
2177
- $$field: FieldId,
2200
+ $$field: FieldId.describe("Id of the field to reference"),
2178
2201
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2179
2202
  'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
2203
+ ),
2204
+ $$code: import_v43.default.string().optional().describe(
2205
+ "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
2206
+ )
2207
+ }).describe(
2208
+ "Reference to a field value, with an optional client-side computation applied."
2209
+ );
2210
+ function isCodeToEvaluate(v) {
2211
+ return !!v && typeof v === "object" && "$$code" in v;
2212
+ }
2213
+ var ComputedDefaultValue = import_v43.default.object({
2214
+ $$code: import_v43.default.string().describe(
2215
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2180
2216
  )
2181
- }).describe("Reference to a field by its ID");
2217
+ }).describe("A context-only computation used as a field default value.");
2182
2218
  var ValidationConfig = import_v43.default.object({
2183
- validator: Conditional,
2184
- message: TranslationConfig
2219
+ validator: Conditional.describe(
2220
+ "Conditional expression that must hold for the field value to be considered valid."
2221
+ ),
2222
+ message: TranslationConfig.describe(
2223
+ "Error message displayed when the validator does not hold."
2224
+ )
2225
+ }).meta({
2226
+ id: "ValidationConfig",
2227
+ 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
2228
  });
2186
2229
  var requiredSchema = import_v43.default.union([
2187
2230
  import_v43.default.boolean(),
@@ -2212,7 +2255,7 @@ var BaseField = import_v43.default.object({
2212
2255
  "Indicates whether the field can be modified during record correction."
2213
2256
  ),
2214
2257
  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."
2258
+ "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
2259
  ),
2217
2260
  analytics: import_v43.default.boolean().default(false).optional().describe(
2218
2261
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2220,30 +2263,39 @@ var BaseField = import_v43.default.object({
2220
2263
  }).describe("Common properties shared across all field types.");
2221
2264
  var Divider = BaseField.extend({
2222
2265
  type: import_v43.default.literal(FieldType.DIVIDER)
2266
+ }).meta({
2267
+ description: "A horizontal line divider",
2268
+ id: "Divider"
2223
2269
  });
2224
2270
  var TextField = BaseField.extend({
2225
2271
  type: import_v43.default.literal(FieldType.TEXT),
2226
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2272
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2227
2273
  configuration: import_v43.default.object({
2228
2274
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2229
2275
  type: import_v43.default.enum(["text", "password"]).optional(),
2230
2276
  prefix: TranslationConfig.optional(),
2231
2277
  postfix: TranslationConfig.optional()
2232
2278
  }).default({ type: "text" }).optional()
2233
- }).describe("Text input");
2279
+ }).meta({
2280
+ description: "A text input field",
2281
+ id: "TextField"
2282
+ });
2234
2283
  var NumberField = BaseField.extend({
2235
2284
  type: import_v43.default.literal(FieldType.NUMBER),
2236
- defaultValue: NumberFieldValue.optional(),
2285
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2237
2286
  configuration: import_v43.default.object({
2238
2287
  min: import_v43.default.number().optional().describe("Minimum value"),
2239
2288
  max: import_v43.default.number().optional().describe("Maximum value"),
2240
2289
  prefix: TranslationConfig.optional(),
2241
2290
  postfix: TranslationConfig.optional()
2242
2291
  }).optional()
2243
- }).describe("Number input");
2292
+ }).meta({
2293
+ description: "A number input field",
2294
+ id: "NumberField"
2295
+ });
2244
2296
  var TextAreaField = BaseField.extend({
2245
2297
  type: import_v43.default.literal(FieldType.TEXTAREA),
2246
- defaultValue: NonEmptyTextValue.optional(),
2298
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2247
2299
  configuration: import_v43.default.object({
2248
2300
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2249
2301
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2251,7 +2303,10 @@ var TextAreaField = BaseField.extend({
2251
2303
  prefix: TranslationConfig.optional(),
2252
2304
  postfix: TranslationConfig.optional()
2253
2305
  }).default({ rows: 4 }).optional()
2254
- }).describe("Multiline text input");
2306
+ }).meta({
2307
+ description: "A multiline text input",
2308
+ id: "TextAreaField"
2309
+ });
2255
2310
  var ImageMimeType = import_v43.default.enum([
2256
2311
  "image/png",
2257
2312
  "image/jpg",
@@ -2274,58 +2329,76 @@ var SignatureField = BaseField.extend({
2274
2329
  signaturePromptLabel: TranslationConfig.describe(
2275
2330
  "Title of the signature modal"
2276
2331
  ),
2277
- defaultValue: FieldValue.optional(),
2332
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2278
2333
  configuration: import_v43.default.object({
2279
2334
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2280
2335
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2281
2336
  }).default({
2282
2337
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2283
2338
  })
2284
- }).describe("Signature input field");
2339
+ }).meta({
2340
+ description: "A signature input field",
2341
+ id: "SignatureField"
2342
+ });
2285
2343
  var EmailField = BaseField.extend({
2286
2344
  type: import_v43.default.literal(FieldType.EMAIL),
2287
2345
  configuration: import_v43.default.object({
2288
2346
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2289
2347
  }).default({ maxLength: 255 }).optional(),
2290
- defaultValue: NonEmptyTextValue.optional()
2348
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2349
+ }).meta({
2350
+ description: "An email input field",
2351
+ id: "EmailField"
2291
2352
  });
2292
2353
  var DateField = BaseField.extend({
2293
2354
  type: import_v43.default.literal(FieldType.DATE),
2294
- defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
2355
+ defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
2295
2356
  configuration: import_v43.default.object({
2296
2357
  notice: TranslationConfig.describe(
2297
2358
  "Text to display above the date input"
2298
2359
  ).optional()
2299
2360
  }).optional()
2300
- }).describe("A single date input (yyyy-MM-dd)");
2361
+ }).meta({
2362
+ description: "A date input (yyyy-MM-dd)",
2363
+ id: "DateField"
2364
+ });
2301
2365
  var AgeField = BaseField.extend({
2302
2366
  type: import_v43.default.literal(FieldType.AGE),
2303
- defaultValue: NumberFieldValue.optional(),
2367
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2304
2368
  configuration: import_v43.default.object({
2305
2369
  asOfDate: FieldReference,
2306
2370
  prefix: TranslationConfig.optional(),
2307
2371
  postfix: TranslationConfig.optional()
2308
2372
  })
2309
- }).describe("An age input field which uses the current date as the asOfDate");
2373
+ }).meta({
2374
+ description: "An age input field which uses the current date as the asOfDate",
2375
+ id: "AgeField"
2376
+ });
2310
2377
  var TimeField = BaseField.extend({
2311
2378
  type: import_v43.default.literal(FieldType.TIME),
2312
- defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
2379
+ defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
2313
2380
  configuration: import_v43.default.object({
2314
2381
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2315
2382
  notice: TranslationConfig.describe(
2316
2383
  "Text to display above the time input"
2317
2384
  ).optional()
2318
2385
  }).optional()
2319
- }).describe("A single date input (HH-mm)");
2386
+ }).meta({
2387
+ description: "A single time input (HH-mm)",
2388
+ id: "TimeField"
2389
+ });
2320
2390
  var DateRangeField = BaseField.extend({
2321
2391
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2322
- defaultValue: DateRangeFieldValue.optional(),
2392
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2323
2393
  configuration: import_v43.default.object({
2324
2394
  notice: TranslationConfig.describe(
2325
2395
  "Text to display above the date input"
2326
2396
  ).optional()
2327
2397
  }).optional()
2328
- }).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
2398
+ }).meta({
2399
+ description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
2400
+ id: "DateRangeField"
2401
+ });
2329
2402
  var HtmlFontVariant = import_v43.default.enum([
2330
2403
  "reg12",
2331
2404
  "reg14",
@@ -2369,21 +2442,33 @@ var ImageViewField = BaseField.extend({
2369
2442
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2370
2443
  defaultValue: NonEmptyTextValue.optional(),
2371
2444
  configuration: ImageConfiguration
2372
- }).describe("A read-only image component for form pages");
2445
+ }).meta({
2446
+ description: "A read-only image component for form pages",
2447
+ id: "ImageViewField"
2448
+ });
2373
2449
  var Paragraph = BaseField.extend({
2374
2450
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2375
2451
  configuration: ParagraphConfiguration
2376
- }).describe("A read-only HTML <p> paragraph");
2452
+ }).meta({
2453
+ description: "A read-only HTML <p> paragraph",
2454
+ id: "Paragraph"
2455
+ });
2377
2456
  var Heading = BaseField.extend({
2378
2457
  type: import_v43.default.literal(FieldType.HEADING),
2379
2458
  configuration: HeadingConfiguration
2380
- }).describe("A read-only heading component for form pages");
2459
+ }).meta({
2460
+ description: "A read-only heading component for form pages",
2461
+ id: "Heading"
2462
+ });
2381
2463
  var PageHeader = BaseField.extend({
2382
2464
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2383
- }).describe("A read-only header component for form pages");
2465
+ }).meta({
2466
+ description: "A read-only header component for form pages",
2467
+ id: "PageHeader"
2468
+ });
2384
2469
  var File = BaseField.extend({
2385
2470
  type: import_v43.default.literal(FieldType.FILE),
2386
- defaultValue: FileFieldValue.optional(),
2471
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2387
2472
  configuration: import_v43.default.object({
2388
2473
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2389
2474
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2399,7 +2484,10 @@ var File = BaseField.extend({
2399
2484
  }).default({
2400
2485
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2401
2486
  })
2402
- }).describe("File upload");
2487
+ }).meta({
2488
+ description: "A file upload field",
2489
+ id: "File"
2490
+ });
2403
2491
  var SelectOption = import_v43.default.object({
2404
2492
  value: import_v43.default.string().describe("The value of the option"),
2405
2493
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2407,7 +2495,7 @@ var SelectOption = import_v43.default.object({
2407
2495
  });
2408
2496
  var NumberWithUnitField = BaseField.extend({
2409
2497
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2410
- defaultValue: NumberWithUnitFieldValue.optional(),
2498
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2411
2499
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2412
2500
  configuration: import_v43.default.object({
2413
2501
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2416,17 +2504,23 @@ var NumberWithUnitField = BaseField.extend({
2416
2504
  "Placeholder for the number field"
2417
2505
  )
2418
2506
  }).optional()
2419
- }).describe("Number with unit input");
2507
+ }).meta({
2508
+ description: "A number with unit input field",
2509
+ id: "NumberWithUnitField"
2510
+ });
2420
2511
  var RadioGroup = BaseField.extend({
2421
2512
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2422
- defaultValue: TextValue.optional(),
2513
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2423
2514
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2424
2515
  configuration: import_v43.default.object({
2425
2516
  styles: import_v43.default.object({
2426
2517
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2427
2518
  }).optional()
2428
2519
  }).optional()
2429
- }).describe("Grouped radio options");
2520
+ }).meta({
2521
+ description: "A grouped radio button field",
2522
+ id: "RadioGroup"
2523
+ });
2430
2524
  var BulletList = BaseField.extend({
2431
2525
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2432
2526
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2435,10 +2529,13 @@ var BulletList = BaseField.extend({
2435
2529
  fontVariant: HtmlFontVariant.optional()
2436
2530
  }).optional()
2437
2531
  }).default({})
2438
- }).describe("A list of bullet points");
2532
+ }).meta({
2533
+ description: "A list of bullet points",
2534
+ id: "BulletList"
2535
+ });
2439
2536
  var Select = BaseField.extend({
2440
2537
  type: import_v43.default.literal(FieldType.SELECT),
2441
- defaultValue: TextValue.optional(),
2538
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2442
2539
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2443
2540
  noOptionsMessage: TranslationConfig.optional().describe(
2444
2541
  `
@@ -2450,16 +2547,22 @@ var Select = BaseField.extend({
2450
2547
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2451
2548
  `
2452
2549
  )
2453
- }).describe("Select input");
2550
+ }).meta({
2551
+ description: "A select input field",
2552
+ id: "Select"
2553
+ });
2454
2554
  var SelectDateRangeOption = import_v43.default.object({
2455
2555
  value: SelectDateRangeValue.describe("The value of the option"),
2456
2556
  label: TranslationConfig.describe("The label of the option")
2457
2557
  });
2458
2558
  var SelectDateRangeField = BaseField.extend({
2459
2559
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2460
- defaultValue: SelectDateRangeValue.optional(),
2560
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2461
2561
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2462
- }).describe("Select input with date range options");
2562
+ }).meta({
2563
+ description: "A date range selection field",
2564
+ id: "SelectDateRangeField"
2565
+ });
2463
2566
  var NameConfig = import_v43.default.object({
2464
2567
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2465
2568
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2471,7 +2574,7 @@ var NameField = BaseField.extend({
2471
2574
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2472
2575
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2473
2576
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2474
- }).optional(),
2577
+ }).or(ComputedDefaultValue).optional(),
2475
2578
  configuration: import_v43.default.object({
2476
2579
  name: NameConfig.default({
2477
2580
  firstname: { required: true },
@@ -2490,26 +2593,41 @@ var NameField = BaseField.extend({
2490
2593
  surname: { required: true }
2491
2594
  }
2492
2595
  }).optional()
2493
- }).describe("Name input field");
2596
+ }).meta({
2597
+ description: "A field for entering a persons name",
2598
+ id: "NameField"
2599
+ });
2494
2600
  var PhoneField = BaseField.extend({
2495
- defaultValue: NonEmptyTextValue.optional(),
2601
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2496
2602
  type: import_v43.default.literal(FieldType.PHONE)
2497
- }).describe("Phone input field");
2603
+ }).meta({
2604
+ description: "A field for entering a phone number",
2605
+ id: "PhoneField"
2606
+ });
2498
2607
  var IdField = BaseField.extend({
2499
- defaultValue: NonEmptyTextValue.optional(),
2608
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2500
2609
  type: import_v43.default.literal(FieldType.ID)
2501
- }).describe("ID input field");
2610
+ }).meta({
2611
+ description: "A field for entering an ID",
2612
+ id: "IdField"
2613
+ });
2502
2614
  var Checkbox = BaseField.extend({
2503
2615
  type: import_v43.default.literal(FieldType.CHECKBOX),
2504
- defaultValue: CheckboxFieldValue.default(false)
2505
- }).describe("Boolean checkbox field");
2616
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2617
+ }).meta({
2618
+ description: "A boolean checkbox field",
2619
+ id: "Checkbox"
2620
+ });
2506
2621
  var Country = BaseField.extend({
2507
2622
  type: import_v43.default.literal(FieldType.COUNTRY),
2508
- defaultValue: NonEmptyTextValue.optional(),
2623
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2509
2624
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2510
2625
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2511
2626
  )
2512
- }).describe("Country select field");
2627
+ }).meta({
2628
+ description: "A field for selecting a country",
2629
+ id: "Country"
2630
+ });
2513
2631
  var AllowedLocations = JurisdictionReference.optional().describe(
2514
2632
  "Limits which location options are selectable depending on user jurisdiction and location."
2515
2633
  );
@@ -2518,28 +2636,33 @@ var AdministrativeAreas = import_v43.default.enum([
2518
2636
  "HEALTH_FACILITY",
2519
2637
  "CRVS_OFFICE"
2520
2638
  ]);
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
2639
  var AdministrativeAreaField = BaseField.extend({
2527
2640
  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");
2641
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2642
+ configuration: import_v43.default.object({
2643
+ partOf: FieldReference.optional().describe("Parent location"),
2644
+ type: AdministrativeAreas,
2645
+ allowedLocations: AllowedLocations
2646
+ }).describe("Administrative area options")
2647
+ }).meta({
2648
+ description: "Administrative area input field",
2649
+ id: "AdministrativeAreaField"
2650
+ });
2531
2651
  var LocationInput = BaseField.extend({
2532
2652
  type: import_v43.default.literal(FieldType.LOCATION),
2533
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2653
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2534
2654
  configuration: import_v43.default.object({
2535
2655
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2536
2656
  allowedLocations: AllowedLocations
2537
2657
  }).optional()
2538
- }).describe("Input field for a location");
2658
+ }).meta({
2659
+ description: "A field for selecting a location",
2660
+ id: "LocationInput"
2661
+ });
2539
2662
  var FileUploadWithOptions = BaseField.extend({
2540
2663
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2541
2664
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2542
- defaultValue: FileFieldWithOptionValue.optional(),
2665
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2543
2666
  configuration: import_v43.default.object({
2544
2667
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2545
2668
  maxImageSize: import_v43.default.object({
@@ -2549,15 +2672,18 @@ var FileUploadWithOptions = BaseField.extend({
2549
2672
  }).default({
2550
2673
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2551
2674
  })
2675
+ }).meta({
2676
+ description: "A field for uploading files with file type options",
2677
+ id: "FileUploadWithOptions"
2552
2678
  });
2553
2679
  var Facility = BaseField.extend({
2554
2680
  type: import_v43.default.literal(FieldType.FACILITY),
2555
- defaultValue: NonEmptyTextValue.optional(),
2681
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2556
2682
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2557
2683
  }).describe("Input field for a facility");
2558
2684
  var Office = BaseField.extend({
2559
2685
  type: import_v43.default.literal(FieldType.OFFICE),
2560
- defaultValue: NonEmptyTextValue.optional(),
2686
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2561
2687
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2562
2688
  }).describe("Input field for an office");
2563
2689
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2593,8 +2719,11 @@ var Address = BaseField.extend({
2593
2719
  ).optional(),
2594
2720
  allowedLocations: AllowedLocations
2595
2721
  }).optional(),
2596
- defaultValue: DefaultAddressFieldValue.optional()
2597
- }).describe("Address input field \u2013 a combination of location and text fields");
2722
+ defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
2723
+ }).meta({
2724
+ description: "Address input field \u2013 a combination of location and text fields",
2725
+ id: "Address"
2726
+ });
2598
2727
  var StaticDataEntry = import_v43.default.object({
2599
2728
  id: import_v43.default.string().describe("ID for the data entry."),
2600
2729
  label: TranslationConfig,
@@ -2609,7 +2738,10 @@ var DataField = BaseField.extend({
2609
2738
  subtitle: TranslationConfig.optional(),
2610
2739
  data: import_v43.default.array(DataEntry)
2611
2740
  })
2612
- }).describe("Data field for displaying read-only data");
2741
+ }).meta({
2742
+ description: "A field for displaying a table of read-only data",
2743
+ id: "DataField"
2744
+ });
2613
2745
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2614
2746
  var ButtonType = import_v43.default.enum([
2615
2747
  "primary",
@@ -2634,13 +2766,19 @@ var ButtonConfiguration = import_v43.default.object({
2634
2766
  });
2635
2767
  var ButtonField = BaseField.extend({
2636
2768
  type: import_v43.default.literal(FieldType.BUTTON),
2637
- defaultValue: ButtonFieldValue.optional(),
2769
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2638
2770
  configuration: ButtonConfiguration
2639
- }).describe("Generic button without any built-in functionality");
2771
+ }).meta({
2772
+ description: "A generic button that can be used to trigger an action",
2773
+ id: "ButtonField"
2774
+ });
2640
2775
  var FieldGroup = BaseField.extend({
2641
2776
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2642
2777
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2643
2778
  fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
2779
+ }).meta({
2780
+ description: "A group of fields that are displayed together",
2781
+ id: "FieldGroup"
2644
2782
  });
2645
2783
  var AlphaPrintButton = BaseField.extend({
2646
2784
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2650,10 +2788,13 @@ var AlphaPrintButton = BaseField.extend({
2650
2788
  "Label for the print button"
2651
2789
  )
2652
2790
  })
2653
- }).describe("Print button field for printing certificates");
2791
+ }).meta({
2792
+ description: "An experimental print button field for printing certificates during the declaration process",
2793
+ id: "AlphaPrintButton"
2794
+ });
2654
2795
  var HttpField = BaseField.extend({
2655
2796
  type: import_v43.default.literal(FieldType.HTTP),
2656
- defaultValue: HttpFieldValue.optional(),
2797
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2657
2798
  configuration: import_v43.default.object({
2658
2799
  trigger: FieldReference.optional().describe(
2659
2800
  "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 +2807,30 @@ var HttpField = BaseField.extend({
2666
2807
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2667
2808
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2668
2809
  })
2669
- }).describe("HTTP request function triggered by a button click or other event");
2810
+ }).meta({
2811
+ 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.",
2812
+ id: "HttpField"
2813
+ });
2670
2814
  var AutocompleteField = BaseField.extend({
2671
2815
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2672
2816
  configuration: import_v43.default.object({
2673
- url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
2817
+ url: import_v43.default.string().describe(
2818
+ "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
2819
+ ).optional(),
2674
2820
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2675
2821
  defaultOptions: import_v43.default.array(
2676
2822
  import_v43.default.object({
2677
2823
  label: import_v43.default.string(),
2678
2824
  value: import_v43.default.string()
2679
2825
  })
2680
- ).optional()
2826
+ ).optional().describe(
2827
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2828
+ )
2681
2829
  })
2682
- }).describe("Autocomplete input field");
2830
+ }).meta({
2831
+ 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.",
2832
+ id: "AutocompleteField"
2833
+ });
2683
2834
  var SearchField = HttpField.extend({
2684
2835
  type: import_v43.default.literal(FieldType.SEARCH),
2685
2836
  configuration: SearchQuery.pick({
@@ -2712,6 +2863,9 @@ var SearchField = HttpField.extend({
2712
2863
  ok: TranslationConfig.optional()
2713
2864
  }).optional()
2714
2865
  })
2866
+ }).meta({
2867
+ description: "A search input field",
2868
+ id: "SearchField"
2715
2869
  });
2716
2870
  var LinkButtonField = BaseField.extend({
2717
2871
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2720,28 +2874,35 @@ var LinkButtonField = BaseField.extend({
2720
2874
  text: TranslationConfig.describe("Text to display on the button"),
2721
2875
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2722
2876
  })
2723
- }).describe("Button that opens a link");
2877
+ }).meta({
2878
+ description: "A button that opens a URL link",
2879
+ id: "LinkButtonField"
2880
+ });
2724
2881
  var VerificationStatus = BaseField.extend({
2725
2882
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2726
- defaultValue: VerificationStatusValue.optional(),
2883
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2727
2884
  configuration: import_v43.default.object({
2728
2885
  status: TranslationConfig.describe("Text to display on the status pill."),
2729
2886
  description: TranslationConfig.describe(
2730
2887
  "Explaining text on the banner in form."
2731
2888
  )
2732
2889
  })
2890
+ }).meta({
2891
+ 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.",
2892
+ id: "VerificationStatus"
2733
2893
  });
2734
2894
  var QueryParamReaderField = BaseField.extend({
2735
2895
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2736
2896
  configuration: import_v43.default.object({
2737
2897
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2738
2898
  })
2739
- }).describe(
2740
- "A field that maps URL query params into form values and clears them afterward"
2741
- );
2899
+ }).meta({
2900
+ description: "A field that maps URL query params into form values and clears them afterward",
2901
+ id: "QueryParamReaderField"
2902
+ });
2742
2903
  var QrReaderField = BaseField.extend({
2743
2904
  type: import_v43.default.literal(FieldType.QR_READER),
2744
- defaultValue: QrReaderFieldValue.optional(),
2905
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2745
2906
  configuration: import_v43.default.object({
2746
2907
  validator: import_v43.default.any().meta({
2747
2908
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2749,21 +2910,27 @@ var QrReaderField = BaseField.extend({
2749
2910
  })
2750
2911
  }).optional()
2751
2912
  }).meta({
2752
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2913
+ description: "QR code reader field, including optional JSON Schema validator.",
2753
2914
  id: "QrReaderField"
2754
2915
  });
2755
2916
  var IdReaderField = BaseField.extend({
2756
2917
  type: import_v43.default.literal(FieldType.ID_READER),
2757
- defaultValue: IdReaderFieldValue.optional(),
2918
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2758
2919
  methods: import_v43.default.array(
2759
2920
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2760
2921
  )
2922
+ }).meta({
2923
+ description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
2924
+ id: "IdReaderField"
2761
2925
  });
2762
2926
  var CustomField = BaseField.extend({
2763
2927
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2764
2928
  defaultValue: CustomFieldValue.optional(),
2765
2929
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2766
2930
  configuration: import_v43.default.unknown().optional()
2931
+ }).meta({
2932
+ description: "An expiremental custom field that is defined by a module source path",
2933
+ id: "CustomField"
2767
2934
  });
2768
2935
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2769
2936
  var LoaderField = BaseField.extend({
@@ -2773,22 +2940,25 @@ var LoaderField = BaseField.extend({
2773
2940
  configuration: import_v43.default.object({
2774
2941
  text: TranslationConfig.describe("Display text above the loading spinner")
2775
2942
  })
2776
- }).describe(
2777
- "A non-interactive field that indicates an in progress operation in form"
2778
- );
2943
+ }).meta({
2944
+ description: "A non-interactive field that indicates an in progress operation in form",
2945
+ id: "LoaderField"
2946
+ });
2779
2947
  var HiddenField = BaseField.extend({
2780
2948
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2781
2949
  required: import_v43.default.boolean().default(false).optional(),
2782
2950
  defaultValue: TextValue.optional()
2783
- }).describe(
2784
- "A non-interactive, hidden field that only hold a value in the form"
2785
- );
2951
+ }).meta({
2952
+ description: "A non-interactive, hidden field that only hold a value in the form",
2953
+ id: "HiddenField"
2954
+ });
2786
2955
  var UserRoleField = BaseField.extend({
2787
2956
  type: import_v43.default.literal(FieldType.USER_ROLE),
2788
2957
  defaultValue: TextValue.optional()
2789
- }).describe(
2790
- "A select dropdown that is automatically populated with available user roles"
2791
- );
2958
+ }).meta({
2959
+ description: "A select dropdown that is automatically populated with available user roles",
2960
+ id: "UserRoleField"
2961
+ });
2792
2962
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2793
2963
  FieldGroup,
2794
2964
  Address,
@@ -2887,16 +3057,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2887
3057
  type: z21.literal(PageTypes.enum.VERIFICATION),
2888
3058
  actions: VerificationActionConfig
2889
3059
  });
2890
- var PageConfig = z21.discriminatedUnion("type", [
2891
- FormPageConfig,
2892
- VerificationPageConfig
2893
- ]);
3060
+ var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
3061
+ id: "PageConfig",
3062
+ 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."
3063
+ });
2894
3064
 
2895
3065
  // ../commons/src/events/FormConfig.ts
2896
3066
  var DeclarationFormConfig = z22.object({
2897
3067
  label: TranslationConfig.describe("Human readable description of the form"),
2898
3068
  pages: z22.array(FormPageConfig)
2899
- }).describe("Configuration of the declaration form.");
3069
+ }).meta({
3070
+ id: "DeclarationFormConfig",
3071
+ description: "Configuration of the declaration form."
3072
+ });
2900
3073
  var ActionFormConfig = z22.object({
2901
3074
  label: TranslationConfig.describe("Human readable description of the form"),
2902
3075
  pages: z22.array(PageConfig)
@@ -2996,6 +3169,9 @@ var DeduplicationConfig = z23.object({
2996
3169
  id: z23.string(),
2997
3170
  label: TranslationConfig,
2998
3171
  query: Clause
3172
+ }).meta({
3173
+ id: "DeduplicationConfig",
3174
+ 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
3175
  });
3000
3176
 
3001
3177
  // ../commons/src/events/ActionConfig.ts
@@ -3113,17 +3289,42 @@ var ActionConfig = z24.discriminatedUnion("type", [
3113
3289
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3114
3290
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3115
3291
  */
3116
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3117
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3118
- RejectConfig.meta({ id: "RejectActionConfig" }),
3119
- RegisterConfig.meta({ id: "RegisterActionConfig" }),
3292
+ ReadActionConfig.meta({
3293
+ id: "ReadActionConfig",
3294
+ description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
3295
+ }),
3296
+ DeclareConfig.meta({
3297
+ id: "DeclareActionConfig",
3298
+ description: "Configuration for the declare action. Includes review-page fields. Shared with the notify action (ActionType.NOTIFY)."
3299
+ }),
3300
+ RejectConfig.meta({
3301
+ id: "RejectActionConfig",
3302
+ description: "Configuration for rejecting a record before registration."
3303
+ }),
3304
+ RegisterConfig.meta({
3305
+ id: "RegisterActionConfig",
3306
+ description: "Configuration for registering a record."
3307
+ }),
3120
3308
  PrintCertificateActionConfig.meta({
3121
- id: "PrintCertificateActionConfig"
3309
+ id: "PrintCertificateActionConfig",
3310
+ description: "Configuration for printing a certificate of a registered record."
3311
+ }),
3312
+ RequestCorrectionConfig.meta({
3313
+ id: "RequestCorrectionActionConfig",
3314
+ description: "Configuration for requesting a correction on a registered record."
3315
+ }),
3316
+ EditActionConfig.meta({
3317
+ id: "EditActionConfig",
3318
+ description: "Configuration for editing a record before registration."
3122
3319
  }),
3123
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3124
- EditActionConfig.meta({ id: "EditActionConfig" }),
3125
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3126
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3320
+ ArchiveConfig.meta({
3321
+ id: "ArchiveActionConfig",
3322
+ description: "Configuration for archiving a record."
3323
+ }),
3324
+ CustomActionConfig.meta({
3325
+ id: "CustomActionConfig",
3326
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3327
+ })
3127
3328
  ]).describe(
3128
3329
  "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
3330
  ).meta({ id: "ActionConfig" });
@@ -3199,7 +3400,10 @@ var Field = BaseField2.extend({
3199
3400
  }).describe("Custom field defined for the summary view.");
3200
3401
  var SummaryConfig = z27.object({
3201
3402
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3202
- }).describe("Configuration of the event summary section.");
3403
+ }).meta({
3404
+ id: "SummaryConfig",
3405
+ 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."
3406
+ });
3203
3407
 
3204
3408
  // ../commons/src/events/AdvancedSearchConfig.ts
3205
3409
  var z28 = __toESM(require("zod/v4"));
@@ -3270,6 +3474,9 @@ var BaseField3 = z28.object({
3270
3474
  ),
3271
3475
  validations: z28.array(ValidationConfig).optional().describe(
3272
3476
  `Option for overriding the field validations specifically for advanced search form.`
3477
+ ),
3478
+ allowedLocations: JurisdictionReference.optional().describe(
3479
+ `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
3480
  )
3274
3481
  });
3275
3482
  var SearchQueryParams = z28.object({
@@ -3323,6 +3530,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3323
3530
  var AdvancedSearchConfig = z28.object({
3324
3531
  title: TranslationConfig.describe("Advanced search tab title"),
3325
3532
  fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
3533
+ }).meta({
3534
+ id: "AdvancedSearchConfig",
3535
+ 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
3536
  });
3327
3537
 
3328
3538
  // ../commons/src/events/utils.ts
@@ -3341,9 +3551,11 @@ var z30 = __toESM(require("zod/v4"));
3341
3551
  var z29 = __toESM(require("zod/v4"));
3342
3552
  function getDynamicNameValue(field3) {
3343
3553
  const nameConfiguration = field3.configuration?.name;
3554
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3555
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3344
3556
  return z29.object({
3345
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3346
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3557
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3558
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3347
3559
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3348
3560
  });
3349
3561
  }
@@ -3726,7 +3938,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3726
3938
  }
3727
3939
  return current;
3728
3940
  }
3941
+ function todayISO() {
3942
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
3943
+ }
3944
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
3945
+ function compileClientFunction(code) {
3946
+ let fn = compiledFunctionCache.get(code);
3947
+ if (!fn) {
3948
+ fn = new Function(`return (${code})`)();
3949
+ compiledFunctionCache.set(code, fn);
3950
+ }
3951
+ return fn;
3952
+ }
3729
3953
  (0, import_ajv_formats.default)(ajv);
3954
+ function buildClientFunctionContext(input) {
3955
+ return {
3956
+ $form: input.form,
3957
+ $now: todayISO(),
3958
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
3959
+ $online: isOnline(),
3960
+ $user: input.validatorContext?.user,
3961
+ $event: input.validatorContext?.event,
3962
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
3963
+ user: input.systemVariables?.user,
3964
+ $window: input.systemVariables?.$window,
3965
+ locations: input.locations,
3966
+ adminLevelIds: input.adminLevelIds
3967
+ };
3968
+ }
3969
+ function runClientFunction(code, data, context) {
3970
+ return compileClientFunction(code)(data, context);
3971
+ }
3730
3972
  ajv.addKeyword({
3731
3973
  keyword: "daysFromDate",
3732
3974
  type: "string",
@@ -3771,7 +4013,7 @@ ajv.addKeyword({
3771
4013
  $data: true,
3772
4014
  errors: true,
3773
4015
  // @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) {
4016
+ validate(_schema, data, _2, dataContext) {
3775
4017
  const locationIdInput = data;
3776
4018
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3777
4019
  return locations.some((location) => location.id === locationIdInput);
@@ -3799,6 +4041,26 @@ function precompileActionSchemas(eventConfigurations) {
3799
4041
  function isAgeValue(value) {
3800
4042
  return typeof value === "object" && value !== null && "age" in value && typeof value.age === "number";
3801
4043
  }
4044
+ function mergeWithBaseFormState(values, context) {
4045
+ return { ...context.baseFormState, ...values };
4046
+ }
4047
+ ajv.addKeyword({
4048
+ keyword: "customClientValidator",
4049
+ schemaType: "object",
4050
+ errors: true,
4051
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4052
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4053
+ // so the cast holds.
4054
+ validate(schema, data, _2, dataContext) {
4055
+ return Boolean(
4056
+ runClientFunction(
4057
+ schema.code,
4058
+ data,
4059
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4060
+ )
4061
+ );
4062
+ }
4063
+ });
3802
4064
  function validate(schema, data) {
3803
4065
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3804
4066
  if ("$form" in data) {
@@ -3835,17 +4097,14 @@ function isOnline() {
3835
4097
  }
3836
4098
  return true;
3837
4099
  }
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
- });
4100
+ function isConditionMet(conditional, values, context) {
4101
+ return validate(
4102
+ conditional,
4103
+ buildClientFunctionContext({
4104
+ form: mergeWithBaseFormState(values, context),
4105
+ validatorContext: context
4106
+ })
4107
+ );
3849
4108
  }
3850
4109
  function getConditionalActionsForField(field3, values) {
3851
4110
  if (!field3.conditionals) {
@@ -3853,9 +4112,9 @@ function getConditionalActionsForField(field3, values) {
3853
4112
  }
3854
4113
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3855
4114
  }
3856
- function areConditionsMet(conditions, values, context, event2) {
4115
+ function areConditionsMet(conditions, values, context, _event) {
3857
4116
  return conditions.every(
3858
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4117
+ (condition) => isConditionMet(condition.conditional, values, context)
3859
4118
  );
3860
4119
  }
3861
4120
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3865,14 +4124,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3865
4124
  if (!hasRule) {
3866
4125
  return true;
3867
4126
  }
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
- });
4127
+ const validConditionals = getConditionalActionsForField(
4128
+ field3,
4129
+ buildClientFunctionContext({
4130
+ form: mergeWithBaseFormState(form, context),
4131
+ validatorContext: context
4132
+ })
4133
+ );
3876
4134
  return validConditionals.includes(conditionalType);
3877
4135
  }
3878
4136
  function isFieldVisible(field3, form, context) {
@@ -3898,7 +4156,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3898
4156
  if (!rule) {
3899
4157
  return true;
3900
4158
  }
3901
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4159
+ return validate(rule.conditional, {
4160
+ ...buildClientFunctionContext({
4161
+ form: mergeWithBaseFormState(event2.declaration, context),
4162
+ validatorContext: context
4163
+ }),
4164
+ $flags: event2.flags,
4165
+ $status: event2.status
4166
+ });
3902
4167
  }
3903
4168
  function isActionEnabled(actionConfig, event2, context) {
3904
4169
  return isActionConditionMet(
@@ -4057,19 +4322,10 @@ function runFieldValidations({
4057
4322
  if (!isFieldVisible(field3.config, form, context)) {
4058
4323
  return [];
4059
4324
  }
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
- };
4325
+ const conditionalParameters = buildClientFunctionContext({
4326
+ form: mergeWithBaseFormState(form, context),
4327
+ validatorContext: context
4328
+ });
4073
4329
  if (isFieldGroupFieldType(field3)) {
4074
4330
  const subfieldErrors = buildFormState(
4075
4331
  field3.config.fields,
@@ -4302,17 +4558,16 @@ function isPageVisible(page, formValues, context) {
4302
4558
  }
4303
4559
  return isConditionMet(page.conditional, formValues, context);
4304
4560
  }
4305
- function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false, declarationContext) {
4561
+ function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false) {
4306
4562
  const base = (0, import_lodash.cloneDeep)(formValues);
4307
4563
  function fn(prevVisibilityContext) {
4308
- const visibilityForm = declarationContext ? { ...declarationContext, ...prevVisibilityContext } : prevVisibilityContext;
4309
4564
  const cleaned = (0, import_lodash.omitBy)(base, (value, fieldId) => {
4310
4565
  const fieldConfig = fields.filter((f) => f.id === fieldId);
4311
4566
  if (!fieldConfig.length) {
4312
4567
  return false;
4313
4568
  }
4314
4569
  const isHidden = fieldConfig.every(
4315
- (f) => !isFieldVisible(f, visibilityForm, validatorContext)
4570
+ (f) => !isFieldVisible(f, prevVisibilityContext, validatorContext)
4316
4571
  );
4317
4572
  if (!isHidden) {
4318
4573
  return false;
@@ -4330,7 +4585,7 @@ function omitHiddenPaginatedFields(formConfig, values, validatorContext, include
4330
4585
  const visibleFields = formConfig.pages.filter((p) => isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4331
4586
  const hiddenFields = formConfig.pages.filter((p) => !isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4332
4587
  const valuesExceptHiddenPage = (0, import_lodash.omitBy)(values, (_2, fieldId) => {
4333
- return hiddenFields.some((f) => f.id === fieldId);
4588
+ return hiddenFields.some((f) => f.id === fieldId) && !visibleFields.some((f) => f.id === fieldId);
4334
4589
  });
4335
4590
  return omitHiddenFields(
4336
4591
  visibleFields,
@@ -4377,13 +4632,10 @@ function getVisibleVerificationPageIds(pages, annotation, context) {
4377
4632
  }
4378
4633
  function omitHiddenAnnotationFields(actionConfig, declaration, annotation, context) {
4379
4634
  const annotationFields = getActionAnnotationFields(actionConfig);
4380
- return omitHiddenFields(
4381
- annotationFields,
4382
- annotation,
4383
- context,
4384
- false,
4385
- declaration
4386
- );
4635
+ return omitHiddenFields(annotationFields, annotation, {
4636
+ ...context,
4637
+ baseFormState: declaration
4638
+ });
4387
4639
  }
4388
4640
  function deepMerge(currentDocument, actionDocument) {
4389
4641
  const currentDocumentClone = (0, import_lodash.cloneDeep)(currentDocument);
@@ -4557,19 +4809,32 @@ function getPendingAction(actions) {
4557
4809
  }
4558
4810
  return pendingActions[0];
4559
4811
  }
4560
- function getCompleteActionAnnotation(annotation, event2, action) {
4812
+ function getCompleteActionAnnotation(event2, action) {
4561
4813
  if (action.originalActionId) {
4562
4814
  const originalAction = event2.actions.find(
4563
4815
  ({ id }) => id === action.originalActionId
4564
4816
  );
4565
4817
  if (originalAction?.status === ActionStatus.Requested) {
4566
- return deepMerge(
4567
- deepMerge(annotation, originalAction.annotation ?? {}),
4568
- action.annotation ?? {}
4569
- );
4818
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4570
4819
  }
4571
4820
  }
4572
- return deepMerge(annotation, action.annotation ?? {});
4821
+ return action.annotation ?? {};
4822
+ }
4823
+ function getCompleteActionContent(event2, action) {
4824
+ const currentContent = "content" in action ? action.content : void 0;
4825
+ if (!action.originalActionId) {
4826
+ return currentContent;
4827
+ }
4828
+ const originalAction = event2.actions.find(
4829
+ ({ id }) => id === action.originalActionId
4830
+ );
4831
+ if (originalAction && "content" in originalAction && originalAction.content) {
4832
+ return {
4833
+ ...originalAction.content,
4834
+ ...currentContent ?? {}
4835
+ };
4836
+ }
4837
+ return currentContent;
4573
4838
  }
4574
4839
  function getCompleteActionDeclaration(declaration, event2, action) {
4575
4840
  if (action.originalActionId) {
@@ -4589,7 +4854,7 @@ function getAcceptedActions(event2) {
4589
4854
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4590
4855
  ...action,
4591
4856
  declaration: getCompleteActionDeclaration({}, event2, action),
4592
- annotation: getCompleteActionAnnotation({}, event2, action)
4857
+ annotation: getCompleteActionAnnotation(event2, action)
4593
4858
  }));
4594
4859
  }
4595
4860
  var EXCLUDED_ACTIONS = [
@@ -4677,6 +4942,9 @@ function not(condition) {
4677
4942
  function never2() {
4678
4943
  return not(alwaysTrue());
4679
4944
  }
4945
+ function always() {
4946
+ return defineConditional(alwaysTrue());
4947
+ }
4680
4948
  function jsonFieldPath(field3) {
4681
4949
  return [field3.$$field, ...field3.$$subfield].join("/");
4682
4950
  }
@@ -5224,7 +5492,54 @@ function createFieldConditionals(fieldId) {
5224
5492
  }
5225
5493
  },
5226
5494
  required: [fieldId]
5227
- })
5495
+ }),
5496
+ /**
5497
+ * Custom client-side validator. The provided function is serialised and executed
5498
+ * just-in-time on the client only. External references (e.g. lodash) are not
5499
+ * available inside the function body — all logic must be self-contained.
5500
+ *
5501
+ * @example
5502
+ * field('nid').customClientValidator((value) => {
5503
+ * // LUHN check — all logic must be inline
5504
+ * const digits = String(value).split('').map(Number)
5505
+ * // ...
5506
+ * return isValid
5507
+ * })
5508
+ */
5509
+ customClientValidator(validationFn) {
5510
+ const code = validationFn.toString();
5511
+ return defineFormConditional({
5512
+ type: "object",
5513
+ properties: wrapToPath(
5514
+ { [fieldId]: { customClientValidator: { code } } },
5515
+ this.$$subfield
5516
+ ),
5517
+ required: [fieldId]
5518
+ });
5519
+ },
5520
+ /**
5521
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5522
+ * that can be used as the `value` property or a DATA component entry.
5523
+ * The function receives the referenced field's value as the first argument and
5524
+ * the full form context as the second; its return value replaces the field reference.
5525
+ * The function is serialised and executed just-in-time on the client only.
5526
+ * External references (e.g. lodash) are not available inside the function body.
5527
+ *
5528
+ * For computing a default value without referencing a specific field, use
5529
+ * `evaluate(fn)` in the `defaultValue` property instead.
5530
+ *
5531
+ * @example
5532
+ * field('a').customClientEvaluation((aValue, ctx) =>
5533
+ * Number(aValue) + Number(ctx.$form.b)
5534
+ * )
5535
+ */
5536
+ customClientEvaluation(computationFn) {
5537
+ return {
5538
+ $$code: computationFn.toString(),
5539
+ $$field: fieldId,
5540
+ $$subfield: this.$$subfield
5541
+ };
5542
+ }
5228
5543
  };
5229
5544
  }
5230
5545
 
@@ -5372,7 +5687,7 @@ var _EventConfigBase = z33.object({
5372
5687
  ),
5373
5688
  label: TranslationConfig.describe("Human-readable label for the event type."),
5374
5689
  actions: z33.array(ActionConfig).describe(
5375
- "Configuration of system-defined actions associated with the event."
5690
+ "Configuration of core and custom actions associated with the event."
5376
5691
  ),
5377
5692
  actionOrder: z33.array(z33.string()).optional().describe(
5378
5693
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5384,7 +5699,7 @@ var _EventConfigBase = z33.object({
5384
5699
  "Configuration of fields available in the advanced search feature."
5385
5700
  ),
5386
5701
  flags: z33.array(FlagConfig).optional().default([]).describe(
5387
- "Configuration of flags associated with the actions of this event type."
5702
+ "Configuration of custom flags associated with the actions of this event type."
5388
5703
  ),
5389
5704
  analytics: z33.boolean().optional().default(true).describe(
5390
5705
  "Indicates whether the records of this event type are included in analytics"
@@ -5397,8 +5712,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5397
5712
  validateActionFlags(event2, ctx);
5398
5713
  validateActionOrder(event2, ctx);
5399
5714
  }).meta({
5400
- id: "EventConfig"
5401
- }).describe("Configuration defining an event type.");
5715
+ id: "EventConfig",
5716
+ description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
5717
+ });
5402
5718
 
5403
5719
  // ../commons/src/events/EventConfigInput.ts
5404
5720
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5621,6 +5937,9 @@ var WorkqueueColumnValue = z34.object({
5621
5937
  var WorkqueueColumn = z34.object({
5622
5938
  label: TranslationConfig,
5623
5939
  value: WorkqueueColumnValue
5940
+ }).meta({
5941
+ id: "WorkqueueColumn",
5942
+ description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
5624
5943
  });
5625
5944
  function defineWorkqueuesColumns(workqueueColumns) {
5626
5945
  return workqueueColumns.map(
@@ -5823,18 +6142,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5823
6142
  query: true,
5824
6143
  columns: true
5825
6144
  });
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()
6145
+ var WorkqueueConfigInput = WorkqueueConfig.extend({
6146
+ query: CountryConfigQueryInputType
6147
+ }).meta({
6148
+ id: "WorkqueueConfig",
6149
+ 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
6150
  });
5839
6151
  function defineWorkqueue(workqueueInput) {
5840
6152
  const queryInput = workqueueInput.query;
@@ -5895,6 +6207,11 @@ var BaseActionInput = z38.object({
5895
6207
  originalActionId: UUID.optional(),
5896
6208
  // should not be part of base action.
5897
6209
  keepAssignment: z38.boolean().optional(),
6210
+ keepAssignmentIfAccepted: z38.boolean().optional(),
6211
+ keepAssignmentIfRejected: z38.boolean().optional(),
6212
+ waitFor: z38.boolean().default(true).describe(
6213
+ "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."
6214
+ ),
5898
6215
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5899
6216
  // @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
6217
  createdAtLocation: UUID.nullish().describe(
@@ -6012,7 +6329,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
6012
6329
  var ApproveCorrectionActionInput = BaseActionInput.extend(
6013
6330
  z38.object({
6014
6331
  requestId: z38.string(),
6015
- type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION)
6332
+ type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION),
6333
+ content: z38.object({ immediateCorrection: z38.boolean().optional() }).optional()
6016
6334
  }).shape
6017
6335
  );
6018
6336
  var ReadActionInput = BaseActionInput.extend(
@@ -6074,7 +6392,7 @@ var Draft = z39.object({
6074
6392
  }).describe(
6075
6393
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6076
6394
  );
6077
- var DraftInput = BaseActionInput.extend({
6395
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6078
6396
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6079
6397
  status: z39.enum([
6080
6398
  ActionStatus.Requested,
@@ -6148,7 +6466,6 @@ function getDeclarationActionCreationMetadata(actionType, actions) {
6148
6466
  createdAtLocation: requestAction?.createdAtLocation ?? acceptAction.createdAtLocation,
6149
6467
  acceptedAt: acceptAction.createdAt,
6150
6468
  createdByRole: requestAction?.createdByRole ?? acceptAction.createdByRole,
6151
- createdBySignature: requestAction?.createdBySignature ?? acceptAction.createdBySignature,
6152
6469
  registrationNumber
6153
6470
  };
6154
6471
  }
@@ -6176,7 +6493,7 @@ function getActionUpdateMetadata(actions) {
6176
6493
  "createdAtLocation",
6177
6494
  "createdByRole"
6178
6495
  ];
6179
- return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
6496
+ return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
6180
6497
  (_2, action) => {
6181
6498
  if (action.originalActionId) {
6182
6499
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6206,26 +6523,43 @@ var import_date_fns3 = require("date-fns");
6206
6523
  function isEditInProgress(actions) {
6207
6524
  return actions.at(-1)?.type === ActionType.EDIT;
6208
6525
  }
6526
+ function findPendingCorrectionAction(writeActions2) {
6527
+ let correctionRequestAction;
6528
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6529
+ const action = writeActions2[i];
6530
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6531
+ break;
6532
+ }
6533
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6534
+ correctionRequestAction = action;
6535
+ break;
6536
+ }
6537
+ }
6538
+ return correctionRequestAction;
6539
+ }
6209
6540
  function isCorrectionRequested(actions) {
6541
+ return findPendingCorrectionAction(actions) !== void 0;
6542
+ }
6543
+ function isDeclarationIncomplete(actions) {
6544
+ return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6545
+ }
6546
+ function isRejected(actions) {
6547
+ const resettingActionTypes = [
6548
+ ActionType.NOTIFY,
6549
+ ActionType.DECLARE,
6550
+ ActionType.EDIT,
6551
+ ActionType.REGISTER
6552
+ ];
6210
6553
  return actions.reduce((prev, { type }) => {
6211
- if (type === ActionType.REQUEST_CORRECTION) {
6554
+ if (type === ActionType.REJECT) {
6212
6555
  return true;
6213
6556
  }
6214
- if (type === ActionType.APPROVE_CORRECTION) {
6215
- return false;
6216
- }
6217
- if (type === ActionType.REJECT_CORRECTION) {
6557
+ if (resettingActionTypes.includes(type)) {
6218
6558
  return false;
6219
6559
  }
6220
6560
  return prev;
6221
6561
  }, false);
6222
6562
  }
6223
- function isDeclarationIncomplete(actions) {
6224
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6225
- }
6226
- function isRejected(actions) {
6227
- return actions.at(-1)?.type === ActionType.REJECT;
6228
- }
6229
6563
  function isPotentialDuplicate(actions) {
6230
6564
  return actions.reduce((prev, { type }) => {
6231
6565
  if (type === ActionType.DUPLICATE_DETECTED) {
@@ -6288,8 +6622,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6288
6622
  return (0, import_lodash3.uniq)(flags);
6289
6623
  }, []);
6290
6624
  }
6291
- function getEventFlags(event2, config) {
6292
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6625
+ function getActionStatusFlags(sortedActions) {
6293
6626
  const actionStatus = sortedActions.reduce(
6294
6627
  (actionStatuses, { type, status: status2 }) => ({
6295
6628
  ...actionStatuses,
@@ -6297,26 +6630,40 @@ function getEventFlags(event2, config) {
6297
6630
  }),
6298
6631
  {}
6299
6632
  );
6300
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6633
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6301
6634
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6302
6635
  return flag2;
6303
6636
  });
6304
- if (isCorrectionRequested(sortedActions)) {
6305
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6637
+ }
6638
+ function getInherentFlags(sortedActions) {
6639
+ const acceptedActions = sortedActions.filter(
6640
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6641
+ );
6642
+ const inherentFlags = [];
6643
+ if (isCorrectionRequested(acceptedActions)) {
6644
+ inherentFlags.push(InherentFlags.CORRECTION_REQUESTED);
6306
6645
  }
6307
- if (isDeclarationIncomplete(sortedActions)) {
6308
- flags.push(InherentFlags.INCOMPLETE);
6646
+ if (isDeclarationIncomplete(acceptedActions)) {
6647
+ inherentFlags.push(InherentFlags.INCOMPLETE);
6309
6648
  }
6310
- if (isRejected(sortedActions)) {
6311
- flags.push(InherentFlags.REJECTED);
6649
+ if (isRejected(acceptedActions)) {
6650
+ inherentFlags.push(InherentFlags.REJECTED);
6312
6651
  }
6313
- if (isPotentialDuplicate(sortedActions)) {
6314
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6652
+ if (isPotentialDuplicate(acceptedActions)) {
6653
+ inherentFlags.push(InherentFlags.POTENTIAL_DUPLICATE);
6315
6654
  }
6316
- if (isEditInProgress(sortedActions)) {
6317
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6655
+ if (isEditInProgress(acceptedActions)) {
6656
+ inherentFlags.push(InherentFlags.EDIT_IN_PROGRESS);
6318
6657
  }
6319
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6658
+ return inherentFlags;
6659
+ }
6660
+ function getEventFlags(event2, config) {
6661
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6662
+ return [
6663
+ ...getActionStatusFlags(sortedActions),
6664
+ ...getInherentFlags(sortedActions),
6665
+ ...resolveEventCustomFlags(event2, config)
6666
+ ];
6320
6667
  }
6321
6668
 
6322
6669
  // ../commons/src/events/state/index.ts
@@ -6362,17 +6709,6 @@ function getAssignedUserFromActions(actions) {
6362
6709
  return user2;
6363
6710
  }, null);
6364
6711
  }
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
6712
  function deepDropNulls(obj) {
6377
6713
  if (Array.isArray(obj)) {
6378
6714
  return obj.map(deepDropNulls);
@@ -6468,10 +6804,8 @@ function getCurrentEventState(event2, config) {
6468
6804
  createdBy: creationAction.createdBy,
6469
6805
  createdByUserType: creationAction.createdByUserType,
6470
6806
  createdAtLocation: creationAction.createdAtLocation,
6471
- createdBySignature: creationAction.createdBySignature,
6472
6807
  updatedAt: acceptedActionMetadata.createdAt,
6473
6808
  assignedTo: getAssignedUserFromActions(acceptedActions),
6474
- assignedToSignature: getAssignedUserSignatureFromActions(acceptedActions),
6475
6809
  updatedBy: requestActionMetadata.createdBy,
6476
6810
  updatedAtLocation: requestActionMetadata.createdAtLocation,
6477
6811
  declaration,
@@ -6564,7 +6898,7 @@ function getActionAnnotation({
6564
6898
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6565
6899
  const actionWithCompleteAnnotation = action && {
6566
6900
  ...action,
6567
- annotation: getCompleteActionAnnotation({}, event2, action)
6901
+ annotation: getCompleteActionAnnotation(event2, action)
6568
6902
  };
6569
6903
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6570
6904
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6636,6 +6970,9 @@ function createFieldConfig(fieldId, options) {
6636
6970
  }
6637
6971
 
6638
6972
  // ../commons/src/events/field.ts
6973
+ function evaluate(computationFn) {
6974
+ return { $$code: computationFn.toString() };
6975
+ }
6639
6976
  function field(fieldId, options = {}) {
6640
6977
  return {
6641
6978
  ...createFieldConditionals(fieldId),
@@ -9730,7 +10067,6 @@ var eventQueryDataGenerator = (overrides = {}, seed = 1) => {
9730
10067
  createdBy: overrides.createdBy ?? generateUuid(rng),
9731
10068
  createdAtLocation: overrides.createdAtLocation ?? generateUuid(rng),
9732
10069
  updatedAtLocation: overrides.updatedAtLocation ?? generateUuid(rng),
9733
- createdBySignature: overrides.createdBySignature ?? generateRandomSignature(rng),
9734
10070
  updatedAt: overrides.updatedAt ?? (0, import_date_fns4.addDays)(new Date(createdAt), 1).toISOString(),
9735
10071
  assignedTo: overrides.assignedTo ?? null,
9736
10072
  updatedBy: overrides.updatedBy ?? generateUuid(rng),
@@ -10001,6 +10337,39 @@ function userCanAccessEventWithScopes(event2, scopes, user2, customActionType) {
10001
10337
  (scope) => canAccessEventWithScope(event2, scope, user2, customActionType)
10002
10338
  );
10003
10339
  }
10340
+ function getAdministrativeAreaHierarchy(administrativeAreaId, administrativeAreas) {
10341
+ const collectedLocations = [];
10342
+ const parsedAdministrativeAreaId = administrativeAreaId && UUID.safeParse(administrativeAreaId).data;
10343
+ let current = parsedAdministrativeAreaId ? administrativeAreas.get(parsedAdministrativeAreaId) : null;
10344
+ while (current) {
10345
+ collectedLocations.push(current);
10346
+ if (!current.parentId) {
10347
+ break;
10348
+ }
10349
+ const parentId = current.parentId;
10350
+ current = administrativeAreas.get(parentId);
10351
+ }
10352
+ return collectedLocations;
10353
+ }
10354
+ function getLocationHierarchy(selectedId, context) {
10355
+ const { administrativeAreas, locations } = context;
10356
+ const loc = locations.get(selectedId);
10357
+ if (loc) {
10358
+ if (loc.administrativeAreaId) {
10359
+ const hierarchy2 = getAdministrativeAreaHierarchy(
10360
+ loc.administrativeAreaId,
10361
+ administrativeAreas
10362
+ );
10363
+ return [...hierarchy2.reverse().map((area) => area.id), loc.id];
10364
+ }
10365
+ return [loc.id];
10366
+ }
10367
+ const hierarchy = getAdministrativeAreaHierarchy(
10368
+ selectedId,
10369
+ administrativeAreas
10370
+ );
10371
+ return hierarchy.reverse().map((area) => area.id);
10372
+ }
10004
10373
 
10005
10374
  // ../commons/src/events/scopes.ts
10006
10375
  var ACTION_SCOPE_MAP = {
@@ -10075,6 +10444,25 @@ function isActionInScope({
10075
10444
  );
10076
10445
  return canAccess;
10077
10446
  }
10447
+ function getAvailableRolesForUserUpdatePayload({
10448
+ allRoles,
10449
+ userLocation,
10450
+ acceptedScopes,
10451
+ userRequesting
10452
+ }) {
10453
+ const availableRoles = allRoles.filter((role) => {
10454
+ const canAccess = canAccessOtherUserWithScopes({
10455
+ userToAccess: {
10456
+ ...userLocation,
10457
+ role
10458
+ },
10459
+ user: userRequesting,
10460
+ scopes: acceptedScopes
10461
+ });
10462
+ return canAccess;
10463
+ });
10464
+ return availableRoles;
10465
+ }
10078
10466
 
10079
10467
  // ../commons/src/events/serializers/user/deserializer.ts
10080
10468
  function userDeserializer(serializedUserField, user2) {
@@ -10277,3 +10665,366 @@ function getFilePathsFromEvent(event2) {
10277
10665
  });
10278
10666
  return (0, import_lodash7.uniq)(filepaths);
10279
10667
  }
10668
+
10669
+ // ../commons/src/events/mocks.test.utils.ts
10670
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10671
+ {
10672
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10673
+ name: "Central",
10674
+ parentId: null,
10675
+ validUntil: null,
10676
+ externalId: "ydyJb1RAy4U1"
10677
+ },
10678
+ {
10679
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10680
+ name: "Sulaka",
10681
+ parentId: null,
10682
+ validUntil: null,
10683
+ externalId: "pQ8nGxWmZ2Q3"
10684
+ },
10685
+ {
10686
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10687
+ name: "Pualula",
10688
+ parentId: null,
10689
+ validUntil: null,
10690
+ externalId: "Aq91DweLmT8k"
10691
+ },
10692
+ {
10693
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10694
+ name: "Chuminga",
10695
+ parentId: null,
10696
+ validUntil: null,
10697
+ externalId: "Rw0fYNh2Xk9a"
10698
+ },
10699
+ {
10700
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10701
+ name: "Ibombo",
10702
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10703
+ validUntil: null,
10704
+ externalId: "k7DsP4vbN1Qe"
10705
+ },
10706
+ {
10707
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10708
+ name: "Isango",
10709
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10710
+ validUntil: null,
10711
+ externalId: "Gm3Z9eQpHw4L"
10712
+ },
10713
+ {
10714
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10715
+ name: "Isamba",
10716
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10717
+ validUntil: null,
10718
+ externalId: "sT0xVu1KqJ7r"
10719
+ },
10720
+ {
10721
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10722
+ name: "Itambo",
10723
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10724
+ validUntil: null,
10725
+ externalId: "Nq6Bv2HpL9Te"
10726
+ },
10727
+ {
10728
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10729
+ name: "Ezhi",
10730
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10731
+ validUntil: null,
10732
+ externalId: "xK8cQ0ZRy5Wd"
10733
+ },
10734
+ {
10735
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10736
+ name: "Ilanga",
10737
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10738
+ validUntil: null,
10739
+ externalId: "Cq4Jm1XvN8Ls"
10740
+ },
10741
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10742
+ {
10743
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10744
+ name: "Klow",
10745
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10746
+ validUntil: null,
10747
+ externalId: "IkYcYBUcyY2"
10748
+ },
10749
+ {
10750
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10751
+ name: "Mbondo",
10752
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10753
+ validUntil: null,
10754
+ externalId: "Qhvv5hvo3mY"
10755
+ },
10756
+ {
10757
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10758
+ name: "Ndara",
10759
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10760
+ validUntil: null,
10761
+ externalId: "crXh068O9TR"
10762
+ },
10763
+ {
10764
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10765
+ name: "Olani",
10766
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10767
+ validUntil: null,
10768
+ externalId: "r00It8Tvvp7"
10769
+ },
10770
+ {
10771
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10772
+ name: "Pemba",
10773
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10774
+ validUntil: null,
10775
+ externalId: "ZnUWsbONIaH"
10776
+ },
10777
+ {
10778
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10779
+ name: "Quanza",
10780
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10781
+ validUntil: null,
10782
+ externalId: "fDZycvQTa7l"
10783
+ },
10784
+ {
10785
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10786
+ name: "Rivka",
10787
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10788
+ validUntil: null,
10789
+ externalId: "KqswxCGTELa"
10790
+ },
10791
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10792
+ {
10793
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10794
+ name: "Mbula",
10795
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10796
+ validUntil: null,
10797
+ externalId: "osEbKjRc9Kg"
10798
+ },
10799
+ {
10800
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10801
+ name: "Ndoki",
10802
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10803
+ validUntil: null,
10804
+ externalId: "aq4daBUAGr3"
10805
+ },
10806
+ {
10807
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10808
+ name: "Tsanga",
10809
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10810
+ validUntil: null,
10811
+ externalId: "cqis6Y8trbJ"
10812
+ },
10813
+ {
10814
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10815
+ name: "Waziri",
10816
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10817
+ validUntil: null,
10818
+ externalId: "LMijHPyyx6d"
10819
+ },
10820
+ {
10821
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
10822
+ name: "Zimbi",
10823
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10824
+ validUntil: null,
10825
+ externalId: "pcQYbPuKGZ7"
10826
+ },
10827
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
10828
+ {
10829
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
10830
+ name: "Felani",
10831
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10832
+ validUntil: null,
10833
+ externalId: "gSqpoCGdMXp"
10834
+ },
10835
+ {
10836
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
10837
+ name: "Goroma",
10838
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10839
+ validUntil: null,
10840
+ externalId: "KvAAIaNqVrp"
10841
+ },
10842
+ {
10843
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
10844
+ name: "Halifu",
10845
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10846
+ validUntil: null,
10847
+ externalId: "qe4UnEVt1hv"
10848
+ },
10849
+ {
10850
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
10851
+ name: "Jabari",
10852
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10853
+ validUntil: null,
10854
+ externalId: "yHH9Nz4rLOt"
10855
+ },
10856
+ {
10857
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
10858
+ name: "Kifani",
10859
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10860
+ validUntil: null,
10861
+ externalId: "eSWmXIGeu1I"
10862
+ },
10863
+ {
10864
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
10865
+ name: "Lumela",
10866
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10867
+ validUntil: null,
10868
+ externalId: "bh0b3aI1uP3"
10869
+ }
10870
+ ];
10871
+ var V2_DEFAULT_MOCK_LOCATIONS = [
10872
+ {
10873
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
10874
+ name: "Central Provincial Office",
10875
+ locationType: "CRVS_OFFICE",
10876
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10877
+ validUntil: null,
10878
+ externalId: "Xr3Df8WpK6Ys"
10879
+ },
10880
+ {
10881
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
10882
+ name: "Central Health Post",
10883
+ locationType: "HEALTH_FACILITY",
10884
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10885
+ validUntil: null
10886
+ },
10887
+ {
10888
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
10889
+ name: "Ibombo District Office",
10890
+ locationType: "CRVS_OFFICE",
10891
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10892
+ validUntil: null,
10893
+ externalId: "Sm4Nw7GrD2Vy"
10894
+ },
10895
+ {
10896
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
10897
+ name: "Isamba District Office",
10898
+ locationType: "CRVS_OFFICE",
10899
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10900
+ validUntil: null,
10901
+ externalId: "Vg1Bq5XeH9Lt"
10902
+ },
10903
+ {
10904
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
10905
+ name: "Isango District Office",
10906
+ locationType: "CRVS_OFFICE",
10907
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
10908
+ validUntil: null,
10909
+ externalId: "Je7Lm2XqN9Vz"
10910
+ },
10911
+ {
10912
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
10913
+ name: "Sulaka Provincial Office",
10914
+ locationType: "CRVS_OFFICE",
10915
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10916
+ validUntil: null,
10917
+ externalId: "Ht2Wp9KcX5Qv"
10918
+ },
10919
+ {
10920
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
10921
+ name: "Ilanga District Office",
10922
+ locationType: "CRVS_OFFICE",
10923
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10924
+ validUntil: null,
10925
+ externalId: "Yp6Ds1WqN3Xz"
10926
+ },
10927
+ {
10928
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
10929
+ name: "Chamakubi Health Post",
10930
+ locationType: "HEALTH_FACILITY",
10931
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10932
+ validUntil: null,
10933
+ externalId: "M1nFr8LbC2Qy"
10934
+ },
10935
+ {
10936
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
10937
+ name: "Ibombo Rural Health Centre",
10938
+ locationType: "HEALTH_FACILITY",
10939
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10940
+ validUntil: null,
10941
+ externalId: "bT7pV6YrW0Xc"
10942
+ },
10943
+ {
10944
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
10945
+ name: "Chikobo Rural Health Centre",
10946
+ locationType: "HEALTH_FACILITY",
10947
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10948
+ validUntil: null,
10949
+ externalId: "zE4qPn2SgJ5d"
10950
+ },
10951
+ {
10952
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
10953
+ name: "Chilochabalenje Health Post",
10954
+ locationType: "HEALTH_FACILITY",
10955
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10956
+ validUntil: null,
10957
+ externalId: "H8vDs1MqR4Uf"
10958
+ },
10959
+ {
10960
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
10961
+ name: "Chipeso Rural Health Centre",
10962
+ locationType: "HEALTH_FACILITY",
10963
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10964
+ validUntil: null,
10965
+ externalId: "Qw3uZ9KfX6Lm"
10966
+ },
10967
+ {
10968
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
10969
+ name: "Chisamba Rural Health Centre",
10970
+ locationType: "HEALTH_FACILITY",
10971
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10972
+ validUntil: null,
10973
+ externalId: "Yr0pCg8LdM2s"
10974
+ },
10975
+ {
10976
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
10977
+ name: "Chitanda Rural Health Centre",
10978
+ locationType: "HEALTH_FACILITY",
10979
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10980
+ validUntil: null,
10981
+ externalId: "tS9gJ4PwB1Qx"
10982
+ },
10983
+ {
10984
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
10985
+ name: "Golden Valley Rural Health Centre",
10986
+ locationType: "HEALTH_FACILITY",
10987
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10988
+ validUntil: null,
10989
+ externalId: "Ld7Qm3XsA8Vr"
10990
+ },
10991
+ {
10992
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
10993
+ name: "Ipongo Rural Health Centre",
10994
+ locationType: "HEALTH_FACILITY",
10995
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10996
+ validUntil: null,
10997
+ externalId: "kF2sW9DmH0Bt"
10998
+ },
10999
+ {
11000
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
11001
+ name: "Itumbwe Health Post",
11002
+ locationType: "HEALTH_FACILITY",
11003
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11004
+ validUntil: null,
11005
+ externalId: "Ue5Xb3VaC7Pq"
11006
+ },
11007
+ {
11008
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
11009
+ name: "Kabangalala Rural Health Centre",
11010
+ locationType: "HEALTH_FACILITY",
11011
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11012
+ validUntil: null,
11013
+ externalId: "Pz8Kc1TqH6Jn"
11014
+ },
11015
+ // Village offices
11016
+ {
11017
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
11018
+ name: "Klow Village Office",
11019
+ locationType: "CRVS_OFFICE",
11020
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
11021
+ validUntil: null,
11022
+ externalId: "PmAyxAJkxiJ"
11023
+ }
11024
+ ];
11025
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11026
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11027
+ );
11028
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11029
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11030
+ );