@opencrvs/toolkit 2.0.0-rc.fdc585a → 2.0.0-rc.fe48e30

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 (55) 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 +265 -119
  4. package/dist/cli.js +401 -131
  5. package/dist/commons/api/router.d.ts +3383 -252
  6. package/dist/commons/application-config/index.d.ts +1 -0
  7. package/dist/commons/conditionals/conditionals.d.ts +354 -4
  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 +377 -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 +55 -2
  29. package/dist/events/index.js +1010 -255
  30. package/dist/migrations/v2.0/checkout-upstream-files.d.ts +1 -1
  31. package/dist/migrations/v2.0/checkout-upstream-files.d.ts.map +1 -1
  32. package/dist/migrations/v2.0/checkout-upstream-files.js +1 -2
  33. package/dist/migrations/v2.0/delete-infrastructure-directory.d.ts +9 -1
  34. package/dist/migrations/v2.0/delete-infrastructure-directory.d.ts.map +1 -1
  35. package/dist/migrations/v2.0/delete-infrastructure-directory.js +66 -20
  36. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts +3 -0
  37. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts.map +1 -0
  38. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.js +110 -0
  39. package/dist/migrations/v2.0/index.d.ts +5 -3
  40. package/dist/migrations/v2.0/index.d.ts.map +1 -1
  41. package/dist/migrations/v2.0/index.js +399 -129
  42. package/dist/migrations/v2.0/merge-infrastructure-directory.d.ts +11 -1
  43. package/dist/migrations/v2.0/merge-infrastructure-directory.d.ts.map +1 -1
  44. package/dist/migrations/v2.0/merge-infrastructure-directory.js +17 -16
  45. package/dist/migrations/v2.0/migrate-scopes.d.ts.map +1 -1
  46. package/dist/migrations/v2.0/migrate-scopes.js +54 -30
  47. package/dist/migrations/v2.0/migrate-workqueue-configs.d.ts.map +1 -1
  48. package/dist/migrations/v2.0/migrate-workqueue-configs.js +140 -59
  49. package/dist/notification/index.js +805 -154
  50. package/dist/scopes/index.d.ts +4 -6
  51. package/dist/scopes/index.js +12 -4
  52. package/opencrvs-toolkit-2.0.0-rc.fe48e30.tgz +0 -0
  53. package/package.json +6 -2
  54. package/tsconfig.tsbuildinfo +1 -1
  55. package/opencrvs-toolkit-2.0.0-rc.fdc585a.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,
@@ -691,18 +711,26 @@ var unflattenScope = (input) => {
691
711
  return { type, options };
692
712
  };
693
713
  var EncodedScope = z2.string().brand("EncodedScope");
694
- var decodeScope = (query) => {
695
- const scope = qs.parse(query, {
714
+ var decodedScopeCache = /* @__PURE__ */ new Map();
715
+ var decodeScope = (encodedScope) => {
716
+ if (decodedScopeCache.has(encodedScope)) {
717
+ return decodedScopeCache.get(encodedScope);
718
+ }
719
+ const scope = qs.parse(encodedScope, {
696
720
  ignoreQueryPrefix: true,
697
721
  comma: true,
698
722
  allowDots: true
699
723
  });
700
724
  const unflattenedScope = unflattenScope(scope);
701
- return Scope.safeParse(unflattenedScope)?.data;
725
+ const result = Scope.safeParse(unflattenedScope)?.data;
726
+ decodedScopeCache.set(encodedScope, result);
727
+ return result;
702
728
  };
703
729
  var DEFAULT_SCOPE_OPTIONS = {
704
730
  placeOfEvent: JurisdictionFilter.enum.all,
705
- accessLevel: JurisdictionFilter.enum.all
731
+ accessLevel: JurisdictionFilter.enum.all,
732
+ registeredIn: JurisdictionFilter.enum.all,
733
+ declaredIn: JurisdictionFilter.enum.all
706
734
  };
707
735
  function getAcceptedScopesByType({
708
736
  acceptedScopes,
@@ -1075,7 +1103,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1075
1103
  ShowConditional,
1076
1104
  // Action can be shown to the user in the list but as disabled
1077
1105
  EnableConditional
1078
- ]);
1106
+ ]).meta({
1107
+ id: "ActionConditional",
1108
+ 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."
1109
+ });
1079
1110
  var DisplayOnReviewConditional = z7.object({
1080
1111
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1081
1112
  conditional: Conditional
@@ -1090,8 +1121,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1090
1121
  // Field output can be shown / hidden on the review page
1091
1122
  DisplayOnReviewConditional
1092
1123
  ]).meta({
1093
- description: "Field conditional configuration",
1094
- id: "FieldConditional"
1124
+ id: "FieldConditional",
1125
+ 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."
1095
1126
  });
1096
1127
 
1097
1128
  // ../commons/src/events/FieldType.ts
@@ -1314,7 +1345,7 @@ function plainDateToLocalDate(date) {
1314
1345
  // ../commons/src/events/FieldValue.ts
1315
1346
  var TextValue = z12.string();
1316
1347
  var HiddenFieldValue = z12.string();
1317
- var NonEmptyTextValue = TextValue.min(1);
1348
+ var NonEmptyTextValue = z12.string().trim().min(1);
1318
1349
  var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
1319
1350
  var AgeValue = z12.object({
1320
1351
  age: z12.number(),
@@ -1343,6 +1374,7 @@ var DateRangeFieldValue = z12.object({
1343
1374
  var EmailValue = z12.email();
1344
1375
  var CheckboxFieldValue = z12.boolean();
1345
1376
  var NumberFieldValue = z12.number();
1377
+ var SignatureFieldValue = FileFieldValue;
1346
1378
  var ButtonFieldValue = z12.number();
1347
1379
  var VerificationStatusValue = z12.enum([
1348
1380
  "verified",
@@ -1411,28 +1443,20 @@ function schemaPriority(schema) {
1411
1443
  return idx === -1 ? 9999 : idx;
1412
1444
  }
1413
1445
  function safeUnion(schemas) {
1446
+ const sortedSchemas = [...schemas].sort(
1447
+ (a, b) => schemaPriority(a) - schemaPriority(b)
1448
+ );
1414
1449
  return z12.any().superRefine((val, ctx) => {
1415
- const successful = schemas.filter((s) => s.safeParse(val).success);
1416
- if (successful.length === 1) {
1417
- return;
1418
- }
1419
- if (successful.length === 0) {
1420
- ctx.addIssue({
1421
- code: "invalid_type",
1422
- expected: "custom",
1423
- message: "Value does not match any schema"
1424
- });
1425
- return;
1426
- }
1427
- successful.sort((a, b) => schemaPriority(a) - schemaPriority(b));
1428
- const best = successful[0];
1429
- if (!best.safeParse(val).success) {
1430
- ctx.addIssue({
1431
- expected: "custom",
1432
- code: "invalid_type",
1433
- message: "Value did not match the best schema"
1434
- });
1450
+ for (const schema of sortedSchemas) {
1451
+ if (schema.safeParse(val).success) {
1452
+ return;
1453
+ }
1435
1454
  }
1455
+ ctx.addIssue({
1456
+ code: "invalid_type",
1457
+ expected: "custom",
1458
+ message: "Value does not match any schema"
1459
+ });
1436
1460
  }).meta({
1437
1461
  description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
1438
1462
  });
@@ -1649,8 +1673,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1649
1673
  var ApprovedCorrectionAction = ActionBase.extend(
1650
1674
  z14.object({
1651
1675
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1652
- requestId: z14.string()
1676
+ requestId: z14.string(),
1653
1677
  // TODO move into 'content' property
1678
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1654
1679
  }).shape
1655
1680
  );
1656
1681
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1742,6 +1767,9 @@ var FlagConfig = z15.object({
1742
1767
  "Indicates if this flag expects an action to be performed to be cleared."
1743
1768
  ),
1744
1769
  label: TranslationConfig.describe("Human readable label of the flag.")
1770
+ }).meta({
1771
+ id: "FlagConfig",
1772
+ description: "Configuration for a custom flag that can be added to or removed from records by event actions."
1745
1773
  });
1746
1774
  var ActionFlagConfig = z15.object({
1747
1775
  id: Flag,
@@ -1749,6 +1777,9 @@ var ActionFlagConfig = z15.object({
1749
1777
  conditional: Conditional.optional().describe(
1750
1778
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1751
1779
  )
1780
+ }).meta({
1781
+ id: "ActionFlagConfig",
1782
+ description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
1752
1783
  });
1753
1784
 
1754
1785
  // ../commons/src/events/EventMetadata.ts
@@ -1770,8 +1801,7 @@ var ActionCreationMetadata = z16.object({
1770
1801
  ),
1771
1802
  createdByUserType: z16.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
1772
1803
  acceptedAt: z16.iso.datetime().describe("Timestamp when the action request was accepted."),
1773
- createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation."),
1774
- createdBySignature: z16.string().nullish().describe("Signature of the user who created the action request.")
1804
+ createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation.")
1775
1805
  });
1776
1806
  var RegistrationCreationMetadata = ActionCreationMetadata.extend({
1777
1807
  registrationNumber: z16.string().describe(
@@ -1799,9 +1829,6 @@ var EventMetadata = z16.object({
1799
1829
  createdAtLocation: UUID.nullish().describe(
1800
1830
  "Location of the user who created the event."
1801
1831
  ),
1802
- createdBySignature: DocumentPath.nullish().describe(
1803
- "Signature of the user who created the event."
1804
- ),
1805
1832
  updatedAtLocation: UUID.nullish().describe(
1806
1833
  "Location of the user who last changed the status."
1807
1834
  ),
@@ -2176,14 +2203,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2176
2203
  }
2177
2204
  }).describe("Unique identifier for the field");
2178
2205
  var FieldReference = import_v43.default.object({
2179
- $$field: FieldId,
2206
+ $$field: FieldId.describe("Id of the field to reference"),
2180
2207
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2181
2208
  'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
2209
+ ),
2210
+ $$code: import_v43.default.string().optional().describe(
2211
+ "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
2212
+ )
2213
+ }).describe(
2214
+ "Reference to a field value, with an optional client-side computation applied."
2215
+ );
2216
+ function isCodeToEvaluate(v) {
2217
+ return !!v && typeof v === "object" && "$$code" in v;
2218
+ }
2219
+ var ComputedDefaultValue = import_v43.default.object({
2220
+ $$code: import_v43.default.string().describe(
2221
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2182
2222
  )
2183
- }).describe("Reference to a field by its ID");
2223
+ }).describe("A context-only computation used as a field default value.");
2184
2224
  var ValidationConfig = import_v43.default.object({
2185
- validator: Conditional,
2186
- message: TranslationConfig
2225
+ validator: Conditional.describe(
2226
+ "Conditional expression that must hold for the field value to be considered valid."
2227
+ ),
2228
+ message: TranslationConfig.describe(
2229
+ "Error message displayed when the validator does not hold."
2230
+ )
2231
+ }).meta({
2232
+ id: "ValidationConfig",
2233
+ 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."
2187
2234
  });
2188
2235
  var requiredSchema = import_v43.default.union([
2189
2236
  import_v43.default.boolean(),
@@ -2214,7 +2261,7 @@ var BaseField = import_v43.default.object({
2214
2261
  "Indicates whether the field can be modified during record correction."
2215
2262
  ),
2216
2263
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2217
- "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."
2264
+ "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."
2218
2265
  ),
2219
2266
  analytics: import_v43.default.boolean().default(false).optional().describe(
2220
2267
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2222,30 +2269,39 @@ var BaseField = import_v43.default.object({
2222
2269
  }).describe("Common properties shared across all field types.");
2223
2270
  var Divider = BaseField.extend({
2224
2271
  type: import_v43.default.literal(FieldType.DIVIDER)
2272
+ }).meta({
2273
+ description: "A horizontal line divider",
2274
+ id: "Divider"
2225
2275
  });
2226
2276
  var TextField = BaseField.extend({
2227
2277
  type: import_v43.default.literal(FieldType.TEXT),
2228
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2278
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2229
2279
  configuration: import_v43.default.object({
2230
2280
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2231
2281
  type: import_v43.default.enum(["text", "password"]).optional(),
2232
2282
  prefix: TranslationConfig.optional(),
2233
2283
  postfix: TranslationConfig.optional()
2234
2284
  }).default({ type: "text" }).optional()
2235
- }).describe("Text input");
2285
+ }).meta({
2286
+ description: "A text input field",
2287
+ id: "TextField"
2288
+ });
2236
2289
  var NumberField = BaseField.extend({
2237
2290
  type: import_v43.default.literal(FieldType.NUMBER),
2238
- defaultValue: NumberFieldValue.optional(),
2291
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2239
2292
  configuration: import_v43.default.object({
2240
2293
  min: import_v43.default.number().optional().describe("Minimum value"),
2241
2294
  max: import_v43.default.number().optional().describe("Maximum value"),
2242
2295
  prefix: TranslationConfig.optional(),
2243
2296
  postfix: TranslationConfig.optional()
2244
2297
  }).optional()
2245
- }).describe("Number input");
2298
+ }).meta({
2299
+ description: "A number input field",
2300
+ id: "NumberField"
2301
+ });
2246
2302
  var TextAreaField = BaseField.extend({
2247
2303
  type: import_v43.default.literal(FieldType.TEXTAREA),
2248
- defaultValue: NonEmptyTextValue.optional(),
2304
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2249
2305
  configuration: import_v43.default.object({
2250
2306
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2251
2307
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2253,7 +2309,10 @@ var TextAreaField = BaseField.extend({
2253
2309
  prefix: TranslationConfig.optional(),
2254
2310
  postfix: TranslationConfig.optional()
2255
2311
  }).default({ rows: 4 }).optional()
2256
- }).describe("Multiline text input");
2312
+ }).meta({
2313
+ description: "A multiline text input",
2314
+ id: "TextAreaField"
2315
+ });
2257
2316
  var ImageMimeType = import_v43.default.enum([
2258
2317
  "image/png",
2259
2318
  "image/jpg",
@@ -2276,58 +2335,76 @@ var SignatureField = BaseField.extend({
2276
2335
  signaturePromptLabel: TranslationConfig.describe(
2277
2336
  "Title of the signature modal"
2278
2337
  ),
2279
- defaultValue: FieldValue.optional(),
2338
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2280
2339
  configuration: import_v43.default.object({
2281
2340
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2282
2341
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2283
2342
  }).default({
2284
2343
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2285
2344
  })
2286
- }).describe("Signature input field");
2345
+ }).meta({
2346
+ description: "A signature input field",
2347
+ id: "SignatureField"
2348
+ });
2287
2349
  var EmailField = BaseField.extend({
2288
2350
  type: import_v43.default.literal(FieldType.EMAIL),
2289
2351
  configuration: import_v43.default.object({
2290
2352
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2291
2353
  }).default({ maxLength: 255 }).optional(),
2292
- defaultValue: NonEmptyTextValue.optional()
2354
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2355
+ }).meta({
2356
+ description: "An email input field",
2357
+ id: "EmailField"
2293
2358
  });
2294
2359
  var DateField = BaseField.extend({
2295
2360
  type: import_v43.default.literal(FieldType.DATE),
2296
- defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
2361
+ defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
2297
2362
  configuration: import_v43.default.object({
2298
2363
  notice: TranslationConfig.describe(
2299
2364
  "Text to display above the date input"
2300
2365
  ).optional()
2301
2366
  }).optional()
2302
- }).describe("A single date input (yyyy-MM-dd)");
2367
+ }).meta({
2368
+ description: "A date input (yyyy-MM-dd)",
2369
+ id: "DateField"
2370
+ });
2303
2371
  var AgeField = BaseField.extend({
2304
2372
  type: import_v43.default.literal(FieldType.AGE),
2305
- defaultValue: NumberFieldValue.optional(),
2373
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2306
2374
  configuration: import_v43.default.object({
2307
2375
  asOfDate: FieldReference,
2308
2376
  prefix: TranslationConfig.optional(),
2309
2377
  postfix: TranslationConfig.optional()
2310
2378
  })
2311
- }).describe("An age input field which uses the current date as the asOfDate");
2379
+ }).meta({
2380
+ description: "An age input field which uses the current date as the asOfDate",
2381
+ id: "AgeField"
2382
+ });
2312
2383
  var TimeField = BaseField.extend({
2313
2384
  type: import_v43.default.literal(FieldType.TIME),
2314
- defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
2385
+ defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
2315
2386
  configuration: import_v43.default.object({
2316
2387
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2317
2388
  notice: TranslationConfig.describe(
2318
2389
  "Text to display above the time input"
2319
2390
  ).optional()
2320
2391
  }).optional()
2321
- }).describe("A single date input (HH-mm)");
2392
+ }).meta({
2393
+ description: "A single time input (HH-mm)",
2394
+ id: "TimeField"
2395
+ });
2322
2396
  var DateRangeField = BaseField.extend({
2323
2397
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2324
- defaultValue: DateRangeFieldValue.optional(),
2398
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2325
2399
  configuration: import_v43.default.object({
2326
2400
  notice: TranslationConfig.describe(
2327
2401
  "Text to display above the date input"
2328
2402
  ).optional()
2329
2403
  }).optional()
2330
- }).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
2404
+ }).meta({
2405
+ description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
2406
+ id: "DateRangeField"
2407
+ });
2331
2408
  var HtmlFontVariant = import_v43.default.enum([
2332
2409
  "reg12",
2333
2410
  "reg14",
@@ -2371,21 +2448,33 @@ var ImageViewField = BaseField.extend({
2371
2448
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2372
2449
  defaultValue: NonEmptyTextValue.optional(),
2373
2450
  configuration: ImageConfiguration
2374
- }).describe("A read-only image component for form pages");
2451
+ }).meta({
2452
+ description: "A read-only image component for form pages",
2453
+ id: "ImageViewField"
2454
+ });
2375
2455
  var Paragraph = BaseField.extend({
2376
2456
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2377
2457
  configuration: ParagraphConfiguration
2378
- }).describe("A read-only HTML <p> paragraph");
2458
+ }).meta({
2459
+ description: "A read-only HTML <p> paragraph",
2460
+ id: "Paragraph"
2461
+ });
2379
2462
  var Heading = BaseField.extend({
2380
2463
  type: import_v43.default.literal(FieldType.HEADING),
2381
2464
  configuration: HeadingConfiguration
2382
- }).describe("A read-only heading component for form pages");
2465
+ }).meta({
2466
+ description: "A read-only heading component for form pages",
2467
+ id: "Heading"
2468
+ });
2383
2469
  var PageHeader = BaseField.extend({
2384
2470
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2385
- }).describe("A read-only header component for form pages");
2471
+ }).meta({
2472
+ description: "A read-only header component for form pages",
2473
+ id: "PageHeader"
2474
+ });
2386
2475
  var File = BaseField.extend({
2387
2476
  type: import_v43.default.literal(FieldType.FILE),
2388
- defaultValue: FileFieldValue.optional(),
2477
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2389
2478
  configuration: import_v43.default.object({
2390
2479
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2391
2480
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2401,7 +2490,10 @@ var File = BaseField.extend({
2401
2490
  }).default({
2402
2491
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2403
2492
  })
2404
- }).describe("File upload");
2493
+ }).meta({
2494
+ description: "A file upload field",
2495
+ id: "File"
2496
+ });
2405
2497
  var SelectOption = import_v43.default.object({
2406
2498
  value: import_v43.default.string().describe("The value of the option"),
2407
2499
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2409,7 +2501,7 @@ var SelectOption = import_v43.default.object({
2409
2501
  });
2410
2502
  var NumberWithUnitField = BaseField.extend({
2411
2503
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2412
- defaultValue: NumberWithUnitFieldValue.optional(),
2504
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2413
2505
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2414
2506
  configuration: import_v43.default.object({
2415
2507
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2418,17 +2510,23 @@ var NumberWithUnitField = BaseField.extend({
2418
2510
  "Placeholder for the number field"
2419
2511
  )
2420
2512
  }).optional()
2421
- }).describe("Number with unit input");
2513
+ }).meta({
2514
+ description: "A number with unit input field",
2515
+ id: "NumberWithUnitField"
2516
+ });
2422
2517
  var RadioGroup = BaseField.extend({
2423
2518
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2424
- defaultValue: TextValue.optional(),
2519
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2425
2520
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2426
2521
  configuration: import_v43.default.object({
2427
2522
  styles: import_v43.default.object({
2428
2523
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2429
2524
  }).optional()
2430
2525
  }).optional()
2431
- }).describe("Grouped radio options");
2526
+ }).meta({
2527
+ description: "A grouped radio button field",
2528
+ id: "RadioGroup"
2529
+ });
2432
2530
  var BulletList = BaseField.extend({
2433
2531
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2434
2532
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2437,10 +2535,13 @@ var BulletList = BaseField.extend({
2437
2535
  fontVariant: HtmlFontVariant.optional()
2438
2536
  }).optional()
2439
2537
  }).default({})
2440
- }).describe("A list of bullet points");
2538
+ }).meta({
2539
+ description: "A list of bullet points",
2540
+ id: "BulletList"
2541
+ });
2441
2542
  var Select = BaseField.extend({
2442
2543
  type: import_v43.default.literal(FieldType.SELECT),
2443
- defaultValue: TextValue.optional(),
2544
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2444
2545
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2445
2546
  noOptionsMessage: TranslationConfig.optional().describe(
2446
2547
  `
@@ -2452,16 +2553,22 @@ var Select = BaseField.extend({
2452
2553
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2453
2554
  `
2454
2555
  )
2455
- }).describe("Select input");
2556
+ }).meta({
2557
+ description: "A select input field",
2558
+ id: "Select"
2559
+ });
2456
2560
  var SelectDateRangeOption = import_v43.default.object({
2457
2561
  value: SelectDateRangeValue.describe("The value of the option"),
2458
2562
  label: TranslationConfig.describe("The label of the option")
2459
2563
  });
2460
2564
  var SelectDateRangeField = BaseField.extend({
2461
2565
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2462
- defaultValue: SelectDateRangeValue.optional(),
2566
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2463
2567
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2464
- }).describe("Select input with date range options");
2568
+ }).meta({
2569
+ description: "A date range selection field",
2570
+ id: "SelectDateRangeField"
2571
+ });
2465
2572
  var NameConfig = import_v43.default.object({
2466
2573
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2467
2574
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2473,7 +2580,7 @@ var NameField = BaseField.extend({
2473
2580
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2474
2581
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2475
2582
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2476
- }).optional(),
2583
+ }).or(ComputedDefaultValue).optional(),
2477
2584
  configuration: import_v43.default.object({
2478
2585
  name: NameConfig.default({
2479
2586
  firstname: { required: true },
@@ -2492,26 +2599,41 @@ var NameField = BaseField.extend({
2492
2599
  surname: { required: true }
2493
2600
  }
2494
2601
  }).optional()
2495
- }).describe("Name input field");
2602
+ }).meta({
2603
+ description: "A field for entering a persons name",
2604
+ id: "NameField"
2605
+ });
2496
2606
  var PhoneField = BaseField.extend({
2497
- defaultValue: NonEmptyTextValue.optional(),
2607
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2498
2608
  type: import_v43.default.literal(FieldType.PHONE)
2499
- }).describe("Phone input field");
2609
+ }).meta({
2610
+ description: "A field for entering a phone number",
2611
+ id: "PhoneField"
2612
+ });
2500
2613
  var IdField = BaseField.extend({
2501
- defaultValue: NonEmptyTextValue.optional(),
2614
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2502
2615
  type: import_v43.default.literal(FieldType.ID)
2503
- }).describe("ID input field");
2616
+ }).meta({
2617
+ description: "A field for entering an ID",
2618
+ id: "IdField"
2619
+ });
2504
2620
  var Checkbox = BaseField.extend({
2505
2621
  type: import_v43.default.literal(FieldType.CHECKBOX),
2506
- defaultValue: CheckboxFieldValue.default(false)
2507
- }).describe("Boolean checkbox field");
2622
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2623
+ }).meta({
2624
+ description: "A boolean checkbox field",
2625
+ id: "Checkbox"
2626
+ });
2508
2627
  var Country = BaseField.extend({
2509
2628
  type: import_v43.default.literal(FieldType.COUNTRY),
2510
- defaultValue: NonEmptyTextValue.optional(),
2629
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2511
2630
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2512
2631
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2513
2632
  )
2514
- }).describe("Country select field");
2633
+ }).meta({
2634
+ description: "A field for selecting a country",
2635
+ id: "Country"
2636
+ });
2515
2637
  var AllowedLocations = JurisdictionReference.optional().describe(
2516
2638
  "Limits which location options are selectable depending on user jurisdiction and location."
2517
2639
  );
@@ -2520,28 +2642,33 @@ var AdministrativeAreas = import_v43.default.enum([
2520
2642
  "HEALTH_FACILITY",
2521
2643
  "CRVS_OFFICE"
2522
2644
  ]);
2523
- var AdministrativeAreaConfiguration = import_v43.default.object({
2524
- partOf: FieldReference.optional().describe("Parent location"),
2525
- type: AdministrativeAreas,
2526
- allowedLocations: AllowedLocations
2527
- }).describe("Administrative area options");
2528
2645
  var AdministrativeAreaField = BaseField.extend({
2529
2646
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2530
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2531
- configuration: AdministrativeAreaConfiguration
2532
- }).describe("Administrative area input field e.g. facility, office");
2647
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2648
+ configuration: import_v43.default.object({
2649
+ partOf: FieldReference.optional().describe("Parent location"),
2650
+ type: AdministrativeAreas,
2651
+ allowedLocations: AllowedLocations
2652
+ }).describe("Administrative area options")
2653
+ }).meta({
2654
+ description: "Administrative area input field",
2655
+ id: "AdministrativeAreaField"
2656
+ });
2533
2657
  var LocationInput = BaseField.extend({
2534
2658
  type: import_v43.default.literal(FieldType.LOCATION),
2535
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2659
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2536
2660
  configuration: import_v43.default.object({
2537
2661
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2538
2662
  allowedLocations: AllowedLocations
2539
2663
  }).optional()
2540
- }).describe("Input field for a location");
2664
+ }).meta({
2665
+ description: "A field for selecting a location",
2666
+ id: "LocationInput"
2667
+ });
2541
2668
  var FileUploadWithOptions = BaseField.extend({
2542
2669
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2543
2670
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2544
- defaultValue: FileFieldWithOptionValue.optional(),
2671
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2545
2672
  configuration: import_v43.default.object({
2546
2673
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2547
2674
  maxImageSize: import_v43.default.object({
@@ -2551,15 +2678,18 @@ var FileUploadWithOptions = BaseField.extend({
2551
2678
  }).default({
2552
2679
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2553
2680
  })
2681
+ }).meta({
2682
+ description: "A field for uploading files with file type options",
2683
+ id: "FileUploadWithOptions"
2554
2684
  });
2555
2685
  var Facility = BaseField.extend({
2556
2686
  type: import_v43.default.literal(FieldType.FACILITY),
2557
- defaultValue: NonEmptyTextValue.optional(),
2687
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2558
2688
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2559
2689
  }).describe("Input field for a facility");
2560
2690
  var Office = BaseField.extend({
2561
2691
  type: import_v43.default.literal(FieldType.OFFICE),
2562
- defaultValue: NonEmptyTextValue.optional(),
2692
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2563
2693
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2564
2694
  }).describe("Input field for an office");
2565
2695
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2595,8 +2725,11 @@ var Address = BaseField.extend({
2595
2725
  ).optional(),
2596
2726
  allowedLocations: AllowedLocations
2597
2727
  }).optional(),
2598
- defaultValue: DefaultAddressFieldValue.optional()
2599
- }).describe("Address input field \u2013 a combination of location and text fields");
2728
+ defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
2729
+ }).meta({
2730
+ description: "Address input field \u2013 a combination of location and text fields",
2731
+ id: "Address"
2732
+ });
2600
2733
  var StaticDataEntry = import_v43.default.object({
2601
2734
  id: import_v43.default.string().describe("ID for the data entry."),
2602
2735
  label: TranslationConfig,
@@ -2611,7 +2744,10 @@ var DataField = BaseField.extend({
2611
2744
  subtitle: TranslationConfig.optional(),
2612
2745
  data: import_v43.default.array(DataEntry)
2613
2746
  })
2614
- }).describe("Data field for displaying read-only data");
2747
+ }).meta({
2748
+ description: "A field for displaying a table of read-only data",
2749
+ id: "DataField"
2750
+ });
2615
2751
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2616
2752
  var ButtonType = import_v43.default.enum([
2617
2753
  "primary",
@@ -2636,13 +2772,19 @@ var ButtonConfiguration = import_v43.default.object({
2636
2772
  });
2637
2773
  var ButtonField = BaseField.extend({
2638
2774
  type: import_v43.default.literal(FieldType.BUTTON),
2639
- defaultValue: ButtonFieldValue.optional(),
2775
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2640
2776
  configuration: ButtonConfiguration
2641
- }).describe("Generic button without any built-in functionality");
2777
+ }).meta({
2778
+ description: "A generic button that can be used to trigger an action",
2779
+ id: "ButtonField"
2780
+ });
2642
2781
  var FieldGroup = BaseField.extend({
2643
2782
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2644
2783
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2645
2784
  fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
2785
+ }).meta({
2786
+ description: "A group of fields that are displayed together",
2787
+ id: "FieldGroup"
2646
2788
  });
2647
2789
  var AlphaPrintButton = BaseField.extend({
2648
2790
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2652,10 +2794,13 @@ var AlphaPrintButton = BaseField.extend({
2652
2794
  "Label for the print button"
2653
2795
  )
2654
2796
  })
2655
- }).describe("Print button field for printing certificates");
2797
+ }).meta({
2798
+ description: "An experimental print button field for printing certificates during the declaration process",
2799
+ id: "AlphaPrintButton"
2800
+ });
2656
2801
  var HttpField = BaseField.extend({
2657
2802
  type: import_v43.default.literal(FieldType.HTTP),
2658
- defaultValue: HttpFieldValue.optional(),
2803
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2659
2804
  configuration: import_v43.default.object({
2660
2805
  trigger: FieldReference.optional().describe(
2661
2806
  "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."
@@ -2668,20 +2813,30 @@ var HttpField = BaseField.extend({
2668
2813
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2669
2814
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2670
2815
  })
2671
- }).describe("HTTP request function triggered by a button click or other event");
2816
+ }).meta({
2817
+ 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.",
2818
+ id: "HttpField"
2819
+ });
2672
2820
  var AutocompleteField = BaseField.extend({
2673
2821
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2674
2822
  configuration: import_v43.default.object({
2675
- url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
2823
+ url: import_v43.default.string().describe(
2824
+ "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
2825
+ ).optional(),
2676
2826
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2677
2827
  defaultOptions: import_v43.default.array(
2678
2828
  import_v43.default.object({
2679
2829
  label: import_v43.default.string(),
2680
2830
  value: import_v43.default.string()
2681
2831
  })
2682
- ).optional()
2832
+ ).optional().describe(
2833
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2834
+ )
2683
2835
  })
2684
- }).describe("Autocomplete input field");
2836
+ }).meta({
2837
+ 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.",
2838
+ id: "AutocompleteField"
2839
+ });
2685
2840
  var SearchField = HttpField.extend({
2686
2841
  type: import_v43.default.literal(FieldType.SEARCH),
2687
2842
  configuration: SearchQuery.pick({
@@ -2714,6 +2869,9 @@ var SearchField = HttpField.extend({
2714
2869
  ok: TranslationConfig.optional()
2715
2870
  }).optional()
2716
2871
  })
2872
+ }).meta({
2873
+ description: "A search input field",
2874
+ id: "SearchField"
2717
2875
  });
2718
2876
  var LinkButtonField = BaseField.extend({
2719
2877
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2722,28 +2880,35 @@ var LinkButtonField = BaseField.extend({
2722
2880
  text: TranslationConfig.describe("Text to display on the button"),
2723
2881
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2724
2882
  })
2725
- }).describe("Button that opens a link");
2883
+ }).meta({
2884
+ description: "A button that opens a URL link",
2885
+ id: "LinkButtonField"
2886
+ });
2726
2887
  var VerificationStatus = BaseField.extend({
2727
2888
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2728
- defaultValue: VerificationStatusValue.optional(),
2889
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2729
2890
  configuration: import_v43.default.object({
2730
2891
  status: TranslationConfig.describe("Text to display on the status pill."),
2731
2892
  description: TranslationConfig.describe(
2732
2893
  "Explaining text on the banner in form."
2733
2894
  )
2734
2895
  })
2896
+ }).meta({
2897
+ 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.",
2898
+ id: "VerificationStatus"
2735
2899
  });
2736
2900
  var QueryParamReaderField = BaseField.extend({
2737
2901
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2738
2902
  configuration: import_v43.default.object({
2739
2903
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2740
2904
  })
2741
- }).describe(
2742
- "A field that maps URL query params into form values and clears them afterward"
2743
- );
2905
+ }).meta({
2906
+ description: "A field that maps URL query params into form values and clears them afterward",
2907
+ id: "QueryParamReaderField"
2908
+ });
2744
2909
  var QrReaderField = BaseField.extend({
2745
2910
  type: import_v43.default.literal(FieldType.QR_READER),
2746
- defaultValue: QrReaderFieldValue.optional(),
2911
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2747
2912
  configuration: import_v43.default.object({
2748
2913
  validator: import_v43.default.any().meta({
2749
2914
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2751,21 +2916,27 @@ var QrReaderField = BaseField.extend({
2751
2916
  })
2752
2917
  }).optional()
2753
2918
  }).meta({
2754
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2919
+ description: "QR code reader field, including optional JSON Schema validator.",
2755
2920
  id: "QrReaderField"
2756
2921
  });
2757
2922
  var IdReaderField = BaseField.extend({
2758
2923
  type: import_v43.default.literal(FieldType.ID_READER),
2759
- defaultValue: IdReaderFieldValue.optional(),
2924
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2760
2925
  methods: import_v43.default.array(
2761
2926
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2762
2927
  )
2928
+ }).meta({
2929
+ description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
2930
+ id: "IdReaderField"
2763
2931
  });
2764
2932
  var CustomField = BaseField.extend({
2765
2933
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2766
2934
  defaultValue: CustomFieldValue.optional(),
2767
2935
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2768
2936
  configuration: import_v43.default.unknown().optional()
2937
+ }).meta({
2938
+ description: "An expiremental custom field that is defined by a module source path",
2939
+ id: "CustomField"
2769
2940
  });
2770
2941
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2771
2942
  var LoaderField = BaseField.extend({
@@ -2775,22 +2946,25 @@ var LoaderField = BaseField.extend({
2775
2946
  configuration: import_v43.default.object({
2776
2947
  text: TranslationConfig.describe("Display text above the loading spinner")
2777
2948
  })
2778
- }).describe(
2779
- "A non-interactive field that indicates an in progress operation in form"
2780
- );
2949
+ }).meta({
2950
+ description: "A non-interactive field that indicates an in progress operation in form",
2951
+ id: "LoaderField"
2952
+ });
2781
2953
  var HiddenField = BaseField.extend({
2782
2954
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2783
2955
  required: import_v43.default.boolean().default(false).optional(),
2784
2956
  defaultValue: TextValue.optional()
2785
- }).describe(
2786
- "A non-interactive, hidden field that only hold a value in the form"
2787
- );
2957
+ }).meta({
2958
+ description: "A non-interactive, hidden field that only hold a value in the form",
2959
+ id: "HiddenField"
2960
+ });
2788
2961
  var UserRoleField = BaseField.extend({
2789
2962
  type: import_v43.default.literal(FieldType.USER_ROLE),
2790
2963
  defaultValue: TextValue.optional()
2791
- }).describe(
2792
- "A select dropdown that is automatically populated with available user roles"
2793
- );
2964
+ }).meta({
2965
+ description: "A select dropdown that is automatically populated with available user roles",
2966
+ id: "UserRoleField"
2967
+ });
2794
2968
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2795
2969
  FieldGroup,
2796
2970
  Address,
@@ -2889,16 +3063,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2889
3063
  type: z21.literal(PageTypes.enum.VERIFICATION),
2890
3064
  actions: VerificationActionConfig
2891
3065
  });
2892
- var PageConfig = z21.discriminatedUnion("type", [
2893
- FormPageConfig,
2894
- VerificationPageConfig
2895
- ]);
3066
+ var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
3067
+ id: "PageConfig",
3068
+ 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."
3069
+ });
2896
3070
 
2897
3071
  // ../commons/src/events/FormConfig.ts
2898
3072
  var DeclarationFormConfig = z22.object({
2899
3073
  label: TranslationConfig.describe("Human readable description of the form"),
2900
3074
  pages: z22.array(FormPageConfig)
2901
- }).describe("Configuration of the declaration form.");
3075
+ }).meta({
3076
+ id: "DeclarationFormConfig",
3077
+ description: "Configuration of the declaration form."
3078
+ });
2902
3079
  var ActionFormConfig = z22.object({
2903
3080
  label: TranslationConfig.describe("Human readable description of the form"),
2904
3081
  pages: z22.array(PageConfig)
@@ -2998,6 +3175,9 @@ var DeduplicationConfig = z23.object({
2998
3175
  id: z23.string(),
2999
3176
  label: TranslationConfig,
3000
3177
  query: Clause
3178
+ }).meta({
3179
+ id: "DeduplicationConfig",
3180
+ 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."
3001
3181
  });
3002
3182
 
3003
3183
  // ../commons/src/events/ActionConfig.ts
@@ -3115,17 +3295,42 @@ var ActionConfig = z24.discriminatedUnion("type", [
3115
3295
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3116
3296
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3117
3297
  */
3118
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3119
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3120
- RejectConfig.meta({ id: "RejectActionConfig" }),
3121
- RegisterConfig.meta({ id: "RegisterActionConfig" }),
3298
+ ReadActionConfig.meta({
3299
+ id: "ReadActionConfig",
3300
+ description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
3301
+ }),
3302
+ DeclareConfig.meta({
3303
+ id: "DeclareActionConfig",
3304
+ description: "Configuration for the declare action. Includes review-page fields. Shared with the notify action (ActionType.NOTIFY)."
3305
+ }),
3306
+ RejectConfig.meta({
3307
+ id: "RejectActionConfig",
3308
+ description: "Configuration for rejecting a record before registration."
3309
+ }),
3310
+ RegisterConfig.meta({
3311
+ id: "RegisterActionConfig",
3312
+ description: "Configuration for registering a record."
3313
+ }),
3122
3314
  PrintCertificateActionConfig.meta({
3123
- id: "PrintCertificateActionConfig"
3315
+ id: "PrintCertificateActionConfig",
3316
+ description: "Configuration for printing a certificate of a registered record."
3317
+ }),
3318
+ RequestCorrectionConfig.meta({
3319
+ id: "RequestCorrectionActionConfig",
3320
+ description: "Configuration for requesting a correction on a registered record."
3124
3321
  }),
3125
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3126
- EditActionConfig.meta({ id: "EditActionConfig" }),
3127
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3128
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3322
+ EditActionConfig.meta({
3323
+ id: "EditActionConfig",
3324
+ description: "Configuration for editing a record before registration."
3325
+ }),
3326
+ ArchiveConfig.meta({
3327
+ id: "ArchiveActionConfig",
3328
+ description: "Configuration for archiving a record."
3329
+ }),
3330
+ CustomActionConfig.meta({
3331
+ id: "CustomActionConfig",
3332
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3333
+ })
3129
3334
  ]).describe(
3130
3335
  "Configuration of an action available for an event. Data collected depends on the action type and is accessible through the annotation property in ActionDocument."
3131
3336
  ).meta({ id: "ActionConfig" });
@@ -3201,7 +3406,10 @@ var Field = BaseField2.extend({
3201
3406
  }).describe("Custom field defined for the summary view.");
3202
3407
  var SummaryConfig = z27.object({
3203
3408
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3204
- }).describe("Configuration of the event summary section.");
3409
+ }).meta({
3410
+ id: "SummaryConfig",
3411
+ 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."
3412
+ });
3205
3413
 
3206
3414
  // ../commons/src/events/AdvancedSearchConfig.ts
3207
3415
  var z28 = __toESM(require("zod/v4"));
@@ -3272,6 +3480,9 @@ var BaseField3 = z28.object({
3272
3480
  ),
3273
3481
  validations: z28.array(ValidationConfig).optional().describe(
3274
3482
  `Option for overriding the field validations specifically for advanced search form.`
3483
+ ),
3484
+ allowedLocations: JurisdictionReference.optional().describe(
3485
+ `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.`
3275
3486
  )
3276
3487
  });
3277
3488
  var SearchQueryParams = z28.object({
@@ -3325,6 +3536,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3325
3536
  var AdvancedSearchConfig = z28.object({
3326
3537
  title: TranslationConfig.describe("Advanced search tab title"),
3327
3538
  fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
3539
+ }).meta({
3540
+ id: "AdvancedSearchConfig",
3541
+ 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()`)."
3328
3542
  });
3329
3543
 
3330
3544
  // ../commons/src/events/utils.ts
@@ -3343,9 +3557,11 @@ var z30 = __toESM(require("zod/v4"));
3343
3557
  var z29 = __toESM(require("zod/v4"));
3344
3558
  function getDynamicNameValue(field3) {
3345
3559
  const nameConfiguration = field3.configuration?.name;
3560
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3561
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3346
3562
  return z29.object({
3347
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3348
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3563
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3564
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3349
3565
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3350
3566
  });
3351
3567
  }
@@ -3728,7 +3944,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3728
3944
  }
3729
3945
  return current;
3730
3946
  }
3947
+ function todayISO() {
3948
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
3949
+ }
3950
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
3951
+ function compileClientFunction(code) {
3952
+ let fn = compiledFunctionCache.get(code);
3953
+ if (!fn) {
3954
+ fn = new Function(`return (${code})`)();
3955
+ compiledFunctionCache.set(code, fn);
3956
+ }
3957
+ return fn;
3958
+ }
3731
3959
  (0, import_ajv_formats.default)(ajv);
3960
+ function buildClientFunctionContext(input) {
3961
+ return {
3962
+ $form: input.form,
3963
+ $now: todayISO(),
3964
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
3965
+ $online: isOnline(),
3966
+ $user: input.validatorContext?.user,
3967
+ $event: input.validatorContext?.event,
3968
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
3969
+ user: input.systemVariables?.user,
3970
+ $window: input.systemVariables?.$window,
3971
+ locations: input.locations,
3972
+ adminLevelIds: input.adminLevelIds
3973
+ };
3974
+ }
3975
+ function runClientFunction(code, data, context) {
3976
+ return compileClientFunction(code)(data, context);
3977
+ }
3732
3978
  ajv.addKeyword({
3733
3979
  keyword: "daysFromDate",
3734
3980
  type: "string",
@@ -3773,7 +4019,7 @@ ajv.addKeyword({
3773
4019
  $data: true,
3774
4020
  errors: true,
3775
4021
  // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
3776
- validate(schema, data, _2, dataContext) {
4022
+ validate(_schema, data, _2, dataContext) {
3777
4023
  const locationIdInput = data;
3778
4024
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3779
4025
  return locations.some((location) => location.id === locationIdInput);
@@ -3801,6 +4047,26 @@ function precompileActionSchemas(eventConfigurations) {
3801
4047
  function isAgeValue(value) {
3802
4048
  return typeof value === "object" && value !== null && "age" in value && typeof value.age === "number";
3803
4049
  }
4050
+ function mergeWithBaseFormState(values, context) {
4051
+ return { ...context.baseFormState, ...values };
4052
+ }
4053
+ ajv.addKeyword({
4054
+ keyword: "customClientValidator",
4055
+ schemaType: "object",
4056
+ errors: true,
4057
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4058
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4059
+ // so the cast holds.
4060
+ validate(schema, data, _2, dataContext) {
4061
+ return Boolean(
4062
+ runClientFunction(
4063
+ schema.code,
4064
+ data,
4065
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4066
+ )
4067
+ );
4068
+ }
4069
+ });
3804
4070
  function validate(schema, data) {
3805
4071
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3806
4072
  if ("$form" in data) {
@@ -3837,17 +4103,14 @@ function isOnline() {
3837
4103
  }
3838
4104
  return true;
3839
4105
  }
3840
- function isConditionMet(conditional, values, context, eventIndex) {
3841
- return validate(conditional, {
3842
- $form: values,
3843
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3844
- $online: isOnline(),
3845
- $user: context.user,
3846
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3847
- $flags: eventIndex?.flags ?? [],
3848
- $status: eventIndex?.status,
3849
- $event: context.event
3850
- });
4106
+ function isConditionMet(conditional, values, context) {
4107
+ return validate(
4108
+ conditional,
4109
+ buildClientFunctionContext({
4110
+ form: mergeWithBaseFormState(values, context),
4111
+ validatorContext: context
4112
+ })
4113
+ );
3851
4114
  }
3852
4115
  function getConditionalActionsForField(field3, values) {
3853
4116
  if (!field3.conditionals) {
@@ -3855,9 +4118,9 @@ function getConditionalActionsForField(field3, values) {
3855
4118
  }
3856
4119
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3857
4120
  }
3858
- function areConditionsMet(conditions, values, context, event2) {
4121
+ function areConditionsMet(conditions, values, context, _event) {
3859
4122
  return conditions.every(
3860
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4123
+ (condition) => isConditionMet(condition.conditional, values, context)
3861
4124
  );
3862
4125
  }
3863
4126
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3867,14 +4130,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3867
4130
  if (!hasRule) {
3868
4131
  return true;
3869
4132
  }
3870
- const validConditionals = getConditionalActionsForField(field3, {
3871
- $form: form,
3872
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3873
- $online: isOnline(),
3874
- $user: context.user,
3875
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3876
- $event: context.event
3877
- });
4133
+ const validConditionals = getConditionalActionsForField(
4134
+ field3,
4135
+ buildClientFunctionContext({
4136
+ form: mergeWithBaseFormState(form, context),
4137
+ validatorContext: context
4138
+ })
4139
+ );
3878
4140
  return validConditionals.includes(conditionalType);
3879
4141
  }
3880
4142
  function isFieldVisible(field3, form, context) {
@@ -3900,7 +4162,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3900
4162
  if (!rule) {
3901
4163
  return true;
3902
4164
  }
3903
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4165
+ return validate(rule.conditional, {
4166
+ ...buildClientFunctionContext({
4167
+ form: mergeWithBaseFormState(event2.declaration, context),
4168
+ validatorContext: context
4169
+ }),
4170
+ $flags: event2.flags,
4171
+ $status: event2.status
4172
+ });
3904
4173
  }
3905
4174
  function isActionEnabled(actionConfig, event2, context) {
3906
4175
  return isActionConditionMet(
@@ -4059,19 +4328,10 @@ function runFieldValidations({
4059
4328
  if (!isFieldVisible(field3.config, form, context)) {
4060
4329
  return [];
4061
4330
  }
4062
- const conditionalParameters = {
4063
- $form: form,
4064
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4065
- /**
4066
- * In real use cases, there can be hundreds of thousands of locations.
4067
- * Make sure that the context contains only the locations that are needed for validation.
4068
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4069
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4070
- */
4071
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4072
- $online: isOnline(),
4073
- $user: context.user
4074
- };
4331
+ const conditionalParameters = buildClientFunctionContext({
4332
+ form: mergeWithBaseFormState(form, context),
4333
+ validatorContext: context
4334
+ });
4075
4335
  if (isFieldGroupFieldType(field3)) {
4076
4336
  const subfieldErrors = buildFormState(
4077
4337
  field3.config.fields,
@@ -4304,17 +4564,16 @@ function isPageVisible(page, formValues, context) {
4304
4564
  }
4305
4565
  return isConditionMet(page.conditional, formValues, context);
4306
4566
  }
4307
- function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false, declarationContext) {
4567
+ function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false) {
4308
4568
  const base = (0, import_lodash.cloneDeep)(formValues);
4309
4569
  function fn(prevVisibilityContext) {
4310
- const visibilityForm = declarationContext ? { ...declarationContext, ...prevVisibilityContext } : prevVisibilityContext;
4311
4570
  const cleaned = (0, import_lodash.omitBy)(base, (value, fieldId) => {
4312
4571
  const fieldConfig = fields.filter((f) => f.id === fieldId);
4313
4572
  if (!fieldConfig.length) {
4314
4573
  return false;
4315
4574
  }
4316
4575
  const isHidden = fieldConfig.every(
4317
- (f) => !isFieldVisible(f, visibilityForm, validatorContext)
4576
+ (f) => !isFieldVisible(f, prevVisibilityContext, validatorContext)
4318
4577
  );
4319
4578
  if (!isHidden) {
4320
4579
  return false;
@@ -4332,7 +4591,7 @@ function omitHiddenPaginatedFields(formConfig, values, validatorContext, include
4332
4591
  const visibleFields = formConfig.pages.filter((p) => isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4333
4592
  const hiddenFields = formConfig.pages.filter((p) => !isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4334
4593
  const valuesExceptHiddenPage = (0, import_lodash.omitBy)(values, (_2, fieldId) => {
4335
- return hiddenFields.some((f) => f.id === fieldId);
4594
+ return hiddenFields.some((f) => f.id === fieldId) && !visibleFields.some((f) => f.id === fieldId);
4336
4595
  });
4337
4596
  return omitHiddenFields(
4338
4597
  visibleFields,
@@ -4379,13 +4638,10 @@ function getVisibleVerificationPageIds(pages, annotation, context) {
4379
4638
  }
4380
4639
  function omitHiddenAnnotationFields(actionConfig, declaration, annotation, context) {
4381
4640
  const annotationFields = getActionAnnotationFields(actionConfig);
4382
- return omitHiddenFields(
4383
- annotationFields,
4384
- annotation,
4385
- context,
4386
- false,
4387
- declaration
4388
- );
4641
+ return omitHiddenFields(annotationFields, annotation, {
4642
+ ...context,
4643
+ baseFormState: declaration
4644
+ });
4389
4645
  }
4390
4646
  function deepMerge(currentDocument, actionDocument) {
4391
4647
  const currentDocumentClone = (0, import_lodash.cloneDeep)(currentDocument);
@@ -4559,19 +4815,32 @@ function getPendingAction(actions) {
4559
4815
  }
4560
4816
  return pendingActions[0];
4561
4817
  }
4562
- function getCompleteActionAnnotation(annotation, event2, action) {
4818
+ function getCompleteActionAnnotation(event2, action) {
4563
4819
  if (action.originalActionId) {
4564
4820
  const originalAction = event2.actions.find(
4565
4821
  ({ id }) => id === action.originalActionId
4566
4822
  );
4567
4823
  if (originalAction?.status === ActionStatus.Requested) {
4568
- return deepMerge(
4569
- deepMerge(annotation, originalAction.annotation ?? {}),
4570
- action.annotation ?? {}
4571
- );
4824
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4572
4825
  }
4573
4826
  }
4574
- return deepMerge(annotation, action.annotation ?? {});
4827
+ return action.annotation ?? {};
4828
+ }
4829
+ function getCompleteActionContent(event2, action) {
4830
+ const currentContent = "content" in action ? action.content : void 0;
4831
+ if (!action.originalActionId) {
4832
+ return currentContent;
4833
+ }
4834
+ const originalAction = event2.actions.find(
4835
+ ({ id }) => id === action.originalActionId
4836
+ );
4837
+ if (originalAction && "content" in originalAction && originalAction.content) {
4838
+ return {
4839
+ ...originalAction.content,
4840
+ ...currentContent ?? {}
4841
+ };
4842
+ }
4843
+ return currentContent;
4575
4844
  }
4576
4845
  function getCompleteActionDeclaration(declaration, event2, action) {
4577
4846
  if (action.originalActionId) {
@@ -4591,7 +4860,7 @@ function getAcceptedActions(event2) {
4591
4860
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4592
4861
  ...action,
4593
4862
  declaration: getCompleteActionDeclaration({}, event2, action),
4594
- annotation: getCompleteActionAnnotation({}, event2, action)
4863
+ annotation: getCompleteActionAnnotation(event2, action)
4595
4864
  }));
4596
4865
  }
4597
4866
  var EXCLUDED_ACTIONS = [
@@ -4679,6 +4948,9 @@ function not(condition) {
4679
4948
  function never2() {
4680
4949
  return not(alwaysTrue());
4681
4950
  }
4951
+ function always() {
4952
+ return defineConditional(alwaysTrue());
4953
+ }
4682
4954
  function jsonFieldPath(field3) {
4683
4955
  return [field3.$$field, ...field3.$$subfield].join("/");
4684
4956
  }
@@ -5226,7 +5498,54 @@ function createFieldConditionals(fieldId) {
5226
5498
  }
5227
5499
  },
5228
5500
  required: [fieldId]
5229
- })
5501
+ }),
5502
+ /**
5503
+ * Custom client-side validator. The provided function is serialised and executed
5504
+ * just-in-time on the client only. External references (e.g. lodash) are not
5505
+ * available inside the function body — all logic must be self-contained.
5506
+ *
5507
+ * @example
5508
+ * field('nid').customClientValidator((value) => {
5509
+ * // LUHN check — all logic must be inline
5510
+ * const digits = String(value).split('').map(Number)
5511
+ * // ...
5512
+ * return isValid
5513
+ * })
5514
+ */
5515
+ customClientValidator(validationFn) {
5516
+ const code = validationFn.toString();
5517
+ return defineFormConditional({
5518
+ type: "object",
5519
+ properties: wrapToPath(
5520
+ { [fieldId]: { customClientValidator: { code } } },
5521
+ this.$$subfield
5522
+ ),
5523
+ required: [fieldId]
5524
+ });
5525
+ },
5526
+ /**
5527
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5528
+ * that can be used as the `value` property or a DATA component entry.
5529
+ * The function receives the referenced field's value as the first argument and
5530
+ * the full form context as the second; its return value replaces the field reference.
5531
+ * The function is serialised and executed just-in-time on the client only.
5532
+ * External references (e.g. lodash) are not available inside the function body.
5533
+ *
5534
+ * For computing a default value without referencing a specific field, use
5535
+ * `evaluate(fn)` in the `defaultValue` property instead.
5536
+ *
5537
+ * @example
5538
+ * field('a').customClientEvaluation((aValue, ctx) =>
5539
+ * Number(aValue) + Number(ctx.$form.b)
5540
+ * )
5541
+ */
5542
+ customClientEvaluation(computationFn) {
5543
+ return {
5544
+ $$code: computationFn.toString(),
5545
+ $$field: fieldId,
5546
+ $$subfield: this.$$subfield
5547
+ };
5548
+ }
5230
5549
  };
5231
5550
  }
5232
5551
 
@@ -5374,7 +5693,7 @@ var _EventConfigBase = z33.object({
5374
5693
  ),
5375
5694
  label: TranslationConfig.describe("Human-readable label for the event type."),
5376
5695
  actions: z33.array(ActionConfig).describe(
5377
- "Configuration of system-defined actions associated with the event."
5696
+ "Configuration of core and custom actions associated with the event."
5378
5697
  ),
5379
5698
  actionOrder: z33.array(z33.string()).optional().describe(
5380
5699
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5386,7 +5705,7 @@ var _EventConfigBase = z33.object({
5386
5705
  "Configuration of fields available in the advanced search feature."
5387
5706
  ),
5388
5707
  flags: z33.array(FlagConfig).optional().default([]).describe(
5389
- "Configuration of flags associated with the actions of this event type."
5708
+ "Configuration of custom flags associated with the actions of this event type."
5390
5709
  ),
5391
5710
  analytics: z33.boolean().optional().default(true).describe(
5392
5711
  "Indicates whether the records of this event type are included in analytics"
@@ -5399,8 +5718,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5399
5718
  validateActionFlags(event2, ctx);
5400
5719
  validateActionOrder(event2, ctx);
5401
5720
  }).meta({
5402
- id: "EventConfig"
5403
- }).describe("Configuration defining an event type.");
5721
+ id: "EventConfig",
5722
+ description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
5723
+ });
5404
5724
 
5405
5725
  // ../commons/src/events/EventConfigInput.ts
5406
5726
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5623,6 +5943,9 @@ var WorkqueueColumnValue = z34.object({
5623
5943
  var WorkqueueColumn = z34.object({
5624
5944
  label: TranslationConfig,
5625
5945
  value: WorkqueueColumnValue
5946
+ }).meta({
5947
+ id: "WorkqueueColumn",
5948
+ description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
5626
5949
  });
5627
5950
  function defineWorkqueuesColumns(workqueueColumns) {
5628
5951
  return workqueueColumns.map(
@@ -5825,18 +6148,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5825
6148
  query: true,
5826
6149
  columns: true
5827
6150
  });
5828
- var WorkqueueConfigInput = z37.object({
5829
- slug: z37.string().describe("Determines the url of the workqueue."),
5830
- name: TranslationConfig.describe(
5831
- "Title of the workflow (both in navigation and on the page)"
5832
- ),
5833
- query: CountryConfigQueryInputType,
5834
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5835
- "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."
5836
- ),
5837
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5838
- icon: AvailableIcons,
5839
- emptyMessage: TranslationConfig.optional()
6151
+ var WorkqueueConfigInput = WorkqueueConfig.extend({
6152
+ query: CountryConfigQueryInputType
6153
+ }).meta({
6154
+ id: "WorkqueueConfig",
6155
+ 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."
5840
6156
  });
5841
6157
  function defineWorkqueue(workqueueInput) {
5842
6158
  const queryInput = workqueueInput.query;
@@ -5897,6 +6213,11 @@ var BaseActionInput = z38.object({
5897
6213
  originalActionId: UUID.optional(),
5898
6214
  // should not be part of base action.
5899
6215
  keepAssignment: z38.boolean().optional(),
6216
+ keepAssignmentIfAccepted: z38.boolean().optional(),
6217
+ keepAssignmentIfRejected: z38.boolean().optional(),
6218
+ waitFor: z38.boolean().default(true).describe(
6219
+ "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."
6220
+ ),
5900
6221
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5901
6222
  // @TODO: createdAtLocation should be limited to actions that system users can perform. For normal users, it should not be part of the base action.
5902
6223
  createdAtLocation: UUID.nullish().describe(
@@ -6014,7 +6335,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
6014
6335
  var ApproveCorrectionActionInput = BaseActionInput.extend(
6015
6336
  z38.object({
6016
6337
  requestId: z38.string(),
6017
- type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION)
6338
+ type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION),
6339
+ content: z38.object({ immediateCorrection: z38.boolean().optional() }).optional()
6018
6340
  }).shape
6019
6341
  );
6020
6342
  var ReadActionInput = BaseActionInput.extend(
@@ -6076,7 +6398,7 @@ var Draft = z39.object({
6076
6398
  }).describe(
6077
6399
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6078
6400
  );
6079
- var DraftInput = BaseActionInput.extend({
6401
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6080
6402
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6081
6403
  status: z39.enum([
6082
6404
  ActionStatus.Requested,
@@ -6150,7 +6472,6 @@ function getDeclarationActionCreationMetadata(actionType, actions) {
6150
6472
  createdAtLocation: requestAction?.createdAtLocation ?? acceptAction.createdAtLocation,
6151
6473
  acceptedAt: acceptAction.createdAt,
6152
6474
  createdByRole: requestAction?.createdByRole ?? acceptAction.createdByRole,
6153
- createdBySignature: requestAction?.createdBySignature ?? acceptAction.createdBySignature,
6154
6475
  registrationNumber
6155
6476
  };
6156
6477
  }
@@ -6178,7 +6499,7 @@ function getActionUpdateMetadata(actions) {
6178
6499
  "createdAtLocation",
6179
6500
  "createdByRole"
6180
6501
  ];
6181
- return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
6502
+ return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
6182
6503
  (_2, action) => {
6183
6504
  if (action.originalActionId) {
6184
6505
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6208,26 +6529,43 @@ var import_date_fns3 = require("date-fns");
6208
6529
  function isEditInProgress(actions) {
6209
6530
  return actions.at(-1)?.type === ActionType.EDIT;
6210
6531
  }
6532
+ function findPendingCorrectionAction(writeActions2) {
6533
+ let correctionRequestAction;
6534
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6535
+ const action = writeActions2[i];
6536
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6537
+ break;
6538
+ }
6539
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6540
+ correctionRequestAction = action;
6541
+ break;
6542
+ }
6543
+ }
6544
+ return correctionRequestAction;
6545
+ }
6211
6546
  function isCorrectionRequested(actions) {
6547
+ return findPendingCorrectionAction(actions) !== void 0;
6548
+ }
6549
+ function isDeclarationIncomplete(actions) {
6550
+ return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6551
+ }
6552
+ function isRejected(actions) {
6553
+ const resettingActionTypes = [
6554
+ ActionType.NOTIFY,
6555
+ ActionType.DECLARE,
6556
+ ActionType.EDIT,
6557
+ ActionType.REGISTER
6558
+ ];
6212
6559
  return actions.reduce((prev, { type }) => {
6213
- if (type === ActionType.REQUEST_CORRECTION) {
6560
+ if (type === ActionType.REJECT) {
6214
6561
  return true;
6215
6562
  }
6216
- if (type === ActionType.APPROVE_CORRECTION) {
6217
- return false;
6218
- }
6219
- if (type === ActionType.REJECT_CORRECTION) {
6563
+ if (resettingActionTypes.includes(type)) {
6220
6564
  return false;
6221
6565
  }
6222
6566
  return prev;
6223
6567
  }, false);
6224
6568
  }
6225
- function isDeclarationIncomplete(actions) {
6226
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6227
- }
6228
- function isRejected(actions) {
6229
- return actions.at(-1)?.type === ActionType.REJECT;
6230
- }
6231
6569
  function isPotentialDuplicate(actions) {
6232
6570
  return actions.reduce((prev, { type }) => {
6233
6571
  if (type === ActionType.DUPLICATE_DETECTED) {
@@ -6290,8 +6628,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6290
6628
  return (0, import_lodash3.uniq)(flags);
6291
6629
  }, []);
6292
6630
  }
6293
- function getEventFlags(event2, config) {
6294
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6631
+ function getActionStatusFlags(sortedActions) {
6295
6632
  const actionStatus = sortedActions.reduce(
6296
6633
  (actionStatuses, { type, status: status2 }) => ({
6297
6634
  ...actionStatuses,
@@ -6299,26 +6636,40 @@ function getEventFlags(event2, config) {
6299
6636
  }),
6300
6637
  {}
6301
6638
  );
6302
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6639
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6303
6640
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6304
6641
  return flag2;
6305
6642
  });
6306
- if (isCorrectionRequested(sortedActions)) {
6307
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6643
+ }
6644
+ function getInherentFlags(sortedActions) {
6645
+ const acceptedActions = sortedActions.filter(
6646
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6647
+ );
6648
+ const inherentFlags = [];
6649
+ if (isCorrectionRequested(acceptedActions)) {
6650
+ inherentFlags.push(InherentFlags.CORRECTION_REQUESTED);
6308
6651
  }
6309
- if (isDeclarationIncomplete(sortedActions)) {
6310
- flags.push(InherentFlags.INCOMPLETE);
6652
+ if (isDeclarationIncomplete(acceptedActions)) {
6653
+ inherentFlags.push(InherentFlags.INCOMPLETE);
6311
6654
  }
6312
- if (isRejected(sortedActions)) {
6313
- flags.push(InherentFlags.REJECTED);
6655
+ if (isRejected(acceptedActions)) {
6656
+ inherentFlags.push(InherentFlags.REJECTED);
6314
6657
  }
6315
- if (isPotentialDuplicate(sortedActions)) {
6316
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6658
+ if (isPotentialDuplicate(acceptedActions)) {
6659
+ inherentFlags.push(InherentFlags.POTENTIAL_DUPLICATE);
6317
6660
  }
6318
- if (isEditInProgress(sortedActions)) {
6319
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6661
+ if (isEditInProgress(acceptedActions)) {
6662
+ inherentFlags.push(InherentFlags.EDIT_IN_PROGRESS);
6320
6663
  }
6321
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6664
+ return inherentFlags;
6665
+ }
6666
+ function getEventFlags(event2, config) {
6667
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6668
+ return [
6669
+ ...getActionStatusFlags(sortedActions),
6670
+ ...getInherentFlags(sortedActions),
6671
+ ...resolveEventCustomFlags(event2, config)
6672
+ ];
6322
6673
  }
6323
6674
 
6324
6675
  // ../commons/src/events/state/index.ts
@@ -6364,17 +6715,6 @@ function getAssignedUserFromActions(actions) {
6364
6715
  return user2;
6365
6716
  }, null);
6366
6717
  }
6367
- function getAssignedUserSignatureFromActions(actions) {
6368
- return actions.reduce((signature, action) => {
6369
- if (action.type === ActionType.ASSIGN) {
6370
- return action.createdBySignature || null;
6371
- }
6372
- if (action.type === ActionType.UNASSIGN) {
6373
- return null;
6374
- }
6375
- return signature;
6376
- }, null);
6377
- }
6378
6718
  function deepDropNulls(obj) {
6379
6719
  if (Array.isArray(obj)) {
6380
6720
  return obj.map(deepDropNulls);
@@ -6470,10 +6810,8 @@ function getCurrentEventState(event2, config) {
6470
6810
  createdBy: creationAction.createdBy,
6471
6811
  createdByUserType: creationAction.createdByUserType,
6472
6812
  createdAtLocation: creationAction.createdAtLocation,
6473
- createdBySignature: creationAction.createdBySignature,
6474
6813
  updatedAt: acceptedActionMetadata.createdAt,
6475
6814
  assignedTo: getAssignedUserFromActions(acceptedActions),
6476
- assignedToSignature: getAssignedUserSignatureFromActions(acceptedActions),
6477
6815
  updatedBy: requestActionMetadata.createdBy,
6478
6816
  updatedAtLocation: requestActionMetadata.createdAtLocation,
6479
6817
  declaration,
@@ -6566,7 +6904,7 @@ function getActionAnnotation({
6566
6904
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6567
6905
  const actionWithCompleteAnnotation = action && {
6568
6906
  ...action,
6569
- annotation: getCompleteActionAnnotation({}, event2, action)
6907
+ annotation: getCompleteActionAnnotation(event2, action)
6570
6908
  };
6571
6909
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6572
6910
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6638,6 +6976,9 @@ function createFieldConfig(fieldId, options) {
6638
6976
  }
6639
6977
 
6640
6978
  // ../commons/src/events/field.ts
6979
+ function evaluate(computationFn) {
6980
+ return { $$code: computationFn.toString() };
6981
+ }
6641
6982
  function field(fieldId, options = {}) {
6642
6983
  return {
6643
6984
  ...createFieldConditionals(fieldId),
@@ -9732,7 +10073,6 @@ var eventQueryDataGenerator = (overrides = {}, seed = 1) => {
9732
10073
  createdBy: overrides.createdBy ?? generateUuid(rng),
9733
10074
  createdAtLocation: overrides.createdAtLocation ?? generateUuid(rng),
9734
10075
  updatedAtLocation: overrides.updatedAtLocation ?? generateUuid(rng),
9735
- createdBySignature: overrides.createdBySignature ?? generateRandomSignature(rng),
9736
10076
  updatedAt: overrides.updatedAt ?? (0, import_date_fns4.addDays)(new Date(createdAt), 1).toISOString(),
9737
10077
  assignedTo: overrides.assignedTo ?? null,
9738
10078
  updatedBy: overrides.updatedBy ?? generateUuid(rng),
@@ -10003,6 +10343,39 @@ function userCanAccessEventWithScopes(event2, scopes, user2, customActionType) {
10003
10343
  (scope) => canAccessEventWithScope(event2, scope, user2, customActionType)
10004
10344
  );
10005
10345
  }
10346
+ function getAdministrativeAreaHierarchy(administrativeAreaId, administrativeAreas) {
10347
+ const collectedLocations = [];
10348
+ const parsedAdministrativeAreaId = administrativeAreaId && UUID.safeParse(administrativeAreaId).data;
10349
+ let current = parsedAdministrativeAreaId ? administrativeAreas.get(parsedAdministrativeAreaId) : null;
10350
+ while (current) {
10351
+ collectedLocations.push(current);
10352
+ if (!current.parentId) {
10353
+ break;
10354
+ }
10355
+ const parentId = current.parentId;
10356
+ current = administrativeAreas.get(parentId);
10357
+ }
10358
+ return collectedLocations;
10359
+ }
10360
+ function getLocationHierarchy(selectedId, context) {
10361
+ const { administrativeAreas, locations } = context;
10362
+ const loc = locations.get(selectedId);
10363
+ if (loc) {
10364
+ if (loc.administrativeAreaId) {
10365
+ const hierarchy2 = getAdministrativeAreaHierarchy(
10366
+ loc.administrativeAreaId,
10367
+ administrativeAreas
10368
+ );
10369
+ return [...hierarchy2.reverse().map((area) => area.id), loc.id];
10370
+ }
10371
+ return [loc.id];
10372
+ }
10373
+ const hierarchy = getAdministrativeAreaHierarchy(
10374
+ selectedId,
10375
+ administrativeAreas
10376
+ );
10377
+ return hierarchy.reverse().map((area) => area.id);
10378
+ }
10006
10379
 
10007
10380
  // ../commons/src/events/scopes.ts
10008
10381
  var ACTION_SCOPE_MAP = {
@@ -10077,6 +10450,25 @@ function isActionInScope({
10077
10450
  );
10078
10451
  return canAccess;
10079
10452
  }
10453
+ function getAvailableRolesForUserUpdatePayload({
10454
+ allRoles,
10455
+ userLocation,
10456
+ acceptedScopes,
10457
+ userRequesting
10458
+ }) {
10459
+ const availableRoles = allRoles.filter((role) => {
10460
+ const canAccess = canAccessOtherUserWithScopes({
10461
+ userToAccess: {
10462
+ ...userLocation,
10463
+ role
10464
+ },
10465
+ user: userRequesting,
10466
+ scopes: acceptedScopes
10467
+ });
10468
+ return canAccess;
10469
+ });
10470
+ return availableRoles;
10471
+ }
10080
10472
 
10081
10473
  // ../commons/src/events/serializers/user/deserializer.ts
10082
10474
  function userDeserializer(serializedUserField, user2) {
@@ -10279,3 +10671,366 @@ function getFilePathsFromEvent(event2) {
10279
10671
  });
10280
10672
  return (0, import_lodash7.uniq)(filepaths);
10281
10673
  }
10674
+
10675
+ // ../commons/src/events/mocks.test.utils.ts
10676
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10677
+ {
10678
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10679
+ name: "Central",
10680
+ parentId: null,
10681
+ validUntil: null,
10682
+ externalId: "ydyJb1RAy4U1"
10683
+ },
10684
+ {
10685
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10686
+ name: "Sulaka",
10687
+ parentId: null,
10688
+ validUntil: null,
10689
+ externalId: "pQ8nGxWmZ2Q3"
10690
+ },
10691
+ {
10692
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10693
+ name: "Pualula",
10694
+ parentId: null,
10695
+ validUntil: null,
10696
+ externalId: "Aq91DweLmT8k"
10697
+ },
10698
+ {
10699
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10700
+ name: "Chuminga",
10701
+ parentId: null,
10702
+ validUntil: null,
10703
+ externalId: "Rw0fYNh2Xk9a"
10704
+ },
10705
+ {
10706
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10707
+ name: "Ibombo",
10708
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10709
+ validUntil: null,
10710
+ externalId: "k7DsP4vbN1Qe"
10711
+ },
10712
+ {
10713
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10714
+ name: "Isango",
10715
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10716
+ validUntil: null,
10717
+ externalId: "Gm3Z9eQpHw4L"
10718
+ },
10719
+ {
10720
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10721
+ name: "Isamba",
10722
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10723
+ validUntil: null,
10724
+ externalId: "sT0xVu1KqJ7r"
10725
+ },
10726
+ {
10727
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10728
+ name: "Itambo",
10729
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10730
+ validUntil: null,
10731
+ externalId: "Nq6Bv2HpL9Te"
10732
+ },
10733
+ {
10734
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10735
+ name: "Ezhi",
10736
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10737
+ validUntil: null,
10738
+ externalId: "xK8cQ0ZRy5Wd"
10739
+ },
10740
+ {
10741
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10742
+ name: "Ilanga",
10743
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10744
+ validUntil: null,
10745
+ externalId: "Cq4Jm1XvN8Ls"
10746
+ },
10747
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10748
+ {
10749
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10750
+ name: "Klow",
10751
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10752
+ validUntil: null,
10753
+ externalId: "IkYcYBUcyY2"
10754
+ },
10755
+ {
10756
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10757
+ name: "Mbondo",
10758
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10759
+ validUntil: null,
10760
+ externalId: "Qhvv5hvo3mY"
10761
+ },
10762
+ {
10763
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10764
+ name: "Ndara",
10765
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10766
+ validUntil: null,
10767
+ externalId: "crXh068O9TR"
10768
+ },
10769
+ {
10770
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10771
+ name: "Olani",
10772
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10773
+ validUntil: null,
10774
+ externalId: "r00It8Tvvp7"
10775
+ },
10776
+ {
10777
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10778
+ name: "Pemba",
10779
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10780
+ validUntil: null,
10781
+ externalId: "ZnUWsbONIaH"
10782
+ },
10783
+ {
10784
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10785
+ name: "Quanza",
10786
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10787
+ validUntil: null,
10788
+ externalId: "fDZycvQTa7l"
10789
+ },
10790
+ {
10791
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10792
+ name: "Rivka",
10793
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10794
+ validUntil: null,
10795
+ externalId: "KqswxCGTELa"
10796
+ },
10797
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10798
+ {
10799
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10800
+ name: "Mbula",
10801
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10802
+ validUntil: null,
10803
+ externalId: "osEbKjRc9Kg"
10804
+ },
10805
+ {
10806
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10807
+ name: "Ndoki",
10808
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10809
+ validUntil: null,
10810
+ externalId: "aq4daBUAGr3"
10811
+ },
10812
+ {
10813
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10814
+ name: "Tsanga",
10815
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10816
+ validUntil: null,
10817
+ externalId: "cqis6Y8trbJ"
10818
+ },
10819
+ {
10820
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10821
+ name: "Waziri",
10822
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10823
+ validUntil: null,
10824
+ externalId: "LMijHPyyx6d"
10825
+ },
10826
+ {
10827
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
10828
+ name: "Zimbi",
10829
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10830
+ validUntil: null,
10831
+ externalId: "pcQYbPuKGZ7"
10832
+ },
10833
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
10834
+ {
10835
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
10836
+ name: "Felani",
10837
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10838
+ validUntil: null,
10839
+ externalId: "gSqpoCGdMXp"
10840
+ },
10841
+ {
10842
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
10843
+ name: "Goroma",
10844
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10845
+ validUntil: null,
10846
+ externalId: "KvAAIaNqVrp"
10847
+ },
10848
+ {
10849
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
10850
+ name: "Halifu",
10851
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10852
+ validUntil: null,
10853
+ externalId: "qe4UnEVt1hv"
10854
+ },
10855
+ {
10856
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
10857
+ name: "Jabari",
10858
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10859
+ validUntil: null,
10860
+ externalId: "yHH9Nz4rLOt"
10861
+ },
10862
+ {
10863
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
10864
+ name: "Kifani",
10865
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10866
+ validUntil: null,
10867
+ externalId: "eSWmXIGeu1I"
10868
+ },
10869
+ {
10870
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
10871
+ name: "Lumela",
10872
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10873
+ validUntil: null,
10874
+ externalId: "bh0b3aI1uP3"
10875
+ }
10876
+ ];
10877
+ var V2_DEFAULT_MOCK_LOCATIONS = [
10878
+ {
10879
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
10880
+ name: "Central Provincial Office",
10881
+ locationType: "CRVS_OFFICE",
10882
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10883
+ validUntil: null,
10884
+ externalId: "Xr3Df8WpK6Ys"
10885
+ },
10886
+ {
10887
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
10888
+ name: "Central Health Post",
10889
+ locationType: "HEALTH_FACILITY",
10890
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10891
+ validUntil: null
10892
+ },
10893
+ {
10894
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
10895
+ name: "Ibombo District Office",
10896
+ locationType: "CRVS_OFFICE",
10897
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10898
+ validUntil: null,
10899
+ externalId: "Sm4Nw7GrD2Vy"
10900
+ },
10901
+ {
10902
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
10903
+ name: "Isamba District Office",
10904
+ locationType: "CRVS_OFFICE",
10905
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10906
+ validUntil: null,
10907
+ externalId: "Vg1Bq5XeH9Lt"
10908
+ },
10909
+ {
10910
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
10911
+ name: "Isango District Office",
10912
+ locationType: "CRVS_OFFICE",
10913
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
10914
+ validUntil: null,
10915
+ externalId: "Je7Lm2XqN9Vz"
10916
+ },
10917
+ {
10918
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
10919
+ name: "Sulaka Provincial Office",
10920
+ locationType: "CRVS_OFFICE",
10921
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10922
+ validUntil: null,
10923
+ externalId: "Ht2Wp9KcX5Qv"
10924
+ },
10925
+ {
10926
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
10927
+ name: "Ilanga District Office",
10928
+ locationType: "CRVS_OFFICE",
10929
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10930
+ validUntil: null,
10931
+ externalId: "Yp6Ds1WqN3Xz"
10932
+ },
10933
+ {
10934
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
10935
+ name: "Chamakubi Health Post",
10936
+ locationType: "HEALTH_FACILITY",
10937
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10938
+ validUntil: null,
10939
+ externalId: "M1nFr8LbC2Qy"
10940
+ },
10941
+ {
10942
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
10943
+ name: "Ibombo Rural Health Centre",
10944
+ locationType: "HEALTH_FACILITY",
10945
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10946
+ validUntil: null,
10947
+ externalId: "bT7pV6YrW0Xc"
10948
+ },
10949
+ {
10950
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
10951
+ name: "Chikobo Rural Health Centre",
10952
+ locationType: "HEALTH_FACILITY",
10953
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10954
+ validUntil: null,
10955
+ externalId: "zE4qPn2SgJ5d"
10956
+ },
10957
+ {
10958
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
10959
+ name: "Chilochabalenje Health Post",
10960
+ locationType: "HEALTH_FACILITY",
10961
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10962
+ validUntil: null,
10963
+ externalId: "H8vDs1MqR4Uf"
10964
+ },
10965
+ {
10966
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
10967
+ name: "Chipeso Rural Health Centre",
10968
+ locationType: "HEALTH_FACILITY",
10969
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10970
+ validUntil: null,
10971
+ externalId: "Qw3uZ9KfX6Lm"
10972
+ },
10973
+ {
10974
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
10975
+ name: "Chisamba Rural Health Centre",
10976
+ locationType: "HEALTH_FACILITY",
10977
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10978
+ validUntil: null,
10979
+ externalId: "Yr0pCg8LdM2s"
10980
+ },
10981
+ {
10982
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
10983
+ name: "Chitanda Rural Health Centre",
10984
+ locationType: "HEALTH_FACILITY",
10985
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10986
+ validUntil: null,
10987
+ externalId: "tS9gJ4PwB1Qx"
10988
+ },
10989
+ {
10990
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
10991
+ name: "Golden Valley Rural Health Centre",
10992
+ locationType: "HEALTH_FACILITY",
10993
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10994
+ validUntil: null,
10995
+ externalId: "Ld7Qm3XsA8Vr"
10996
+ },
10997
+ {
10998
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
10999
+ name: "Ipongo Rural Health Centre",
11000
+ locationType: "HEALTH_FACILITY",
11001
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11002
+ validUntil: null,
11003
+ externalId: "kF2sW9DmH0Bt"
11004
+ },
11005
+ {
11006
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
11007
+ name: "Itumbwe Health Post",
11008
+ locationType: "HEALTH_FACILITY",
11009
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11010
+ validUntil: null,
11011
+ externalId: "Ue5Xb3VaC7Pq"
11012
+ },
11013
+ {
11014
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
11015
+ name: "Kabangalala Rural Health Centre",
11016
+ locationType: "HEALTH_FACILITY",
11017
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11018
+ validUntil: null,
11019
+ externalId: "Pz8Kc1TqH6Jn"
11020
+ },
11021
+ // Village offices
11022
+ {
11023
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
11024
+ name: "Klow Village Office",
11025
+ locationType: "CRVS_OFFICE",
11026
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
11027
+ validUntil: null,
11028
+ externalId: "PmAyxAJkxiJ"
11029
+ }
11030
+ ];
11031
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11032
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11033
+ );
11034
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11035
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11036
+ );