@opencrvs/toolkit 2.0.0-rc.dd09a6d → 2.0.0-rc.dd15edc

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 (32) hide show
  1. package/create-countryconfig/index.js +50 -20
  2. package/create-countryconfig/package.json +12 -2
  3. package/dist/application-config/index.js +258 -94
  4. package/dist/cli.js +12 -4
  5. package/dist/commons/api/router.d.ts +107 -21
  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 +51 -2
  9. package/dist/commons/events/ActionDocument.d.ts +6 -0
  10. package/dist/commons/events/ActionInput.d.ts +42 -36
  11. package/dist/commons/events/AdvancedSearchConfig.d.ts +342 -0
  12. package/dist/commons/events/Draft.d.ts +2 -3
  13. package/dist/commons/events/EventDocument.d.ts +3 -0
  14. package/dist/commons/events/FieldConfig.d.ts +378 -50
  15. package/dist/commons/events/FieldType.d.ts +1 -0
  16. package/dist/commons/events/FieldTypeMapping.d.ts +1 -1
  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/state/flags.d.ts +16 -0
  22. package/dist/commons/events/state/utils.d.ts +12 -287
  23. package/dist/commons/events/utils.d.ts +12 -1
  24. package/dist/conditionals/index.js +55 -2
  25. package/dist/events/index.js +950 -214
  26. package/dist/migrations/v2.0/index.js +12 -4
  27. package/dist/notification/index.js +805 -130
  28. package/dist/scopes/index.d.ts +4 -6
  29. package/dist/scopes/index.js +12 -4
  30. package/opencrvs-toolkit-2.0.0-rc.dd15edc.tgz +0 -0
  31. package/package.json +6 -2
  32. package/opencrvs-toolkit-2.0.0-rc.dd09a6d.tgz +0 -0
@@ -75,6 +75,7 @@ __export(events_exports, {
75
75
  CheckboxFieldValue: () => CheckboxFieldValue,
76
76
  Clause: () => Clause,
77
77
  ClientSpecificAction: () => ClientSpecificAction,
78
+ ComputedDefaultValue: () => ComputedDefaultValue,
78
79
  Conditional: () => Conditional,
79
80
  ConditionalType: () => ConditionalType,
80
81
  ConfirmableActions: () => ConfirmableActions,
@@ -150,6 +151,7 @@ __export(events_exports, {
150
151
  FormPageConfig: () => FormPageConfig,
151
152
  Fuzzy: () => Fuzzy,
152
153
  GeographicalArea: () => GeographicalArea,
154
+ HiddenFieldTypes: () => HiddenFieldTypes,
153
155
  HiddenFieldValue: () => HiddenFieldValue,
154
156
  HttpFieldUpdateValue: () => HttpFieldUpdateValue,
155
157
  HttpFieldValue: () => HttpFieldValue,
@@ -200,6 +202,7 @@ __export(events_exports, {
200
202
  SelectDateRangeValue: () => SelectDateRangeValue,
201
203
  SelectOption: () => SelectOption,
202
204
  ShowConditional: () => ShowConditional,
205
+ SignatureFieldValue: () => SignatureFieldValue,
203
206
  StaticDataEntry: () => StaticDataEntry,
204
207
  StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
205
208
  SummaryConfig: () => SummaryConfig,
@@ -213,6 +216,10 @@ __export(events_exports, {
213
216
  UUID: () => UUID,
214
217
  UnassignActionInput: () => UnassignActionInput,
215
218
  UserAuditRecordInput: () => UserAuditRecordInput,
219
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS,
220
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP,
221
+ V2_DEFAULT_MOCK_LOCATIONS: () => V2_DEFAULT_MOCK_LOCATIONS,
222
+ V2_DEFAULT_MOCK_LOCATIONS_MAP: () => V2_DEFAULT_MOCK_LOCATIONS_MAP,
216
223
  ValidationConfig: () => ValidationConfig,
217
224
  VerificationActionConfig: () => VerificationActionConfig,
218
225
  VerificationPageConfig: () => VerificationPageConfig,
@@ -234,6 +241,7 @@ __export(events_exports, {
234
241
  ageToDate: () => ageToDate,
235
242
  aggregateActionAnnotations: () => aggregateActionAnnotations,
236
243
  aggregateActionDeclarations: () => aggregateActionDeclarations,
244
+ always: () => always,
237
245
  alwaysTrue: () => alwaysTrue,
238
246
  and: () => and,
239
247
  annotationActions: () => annotationActions,
@@ -241,10 +249,12 @@ __export(events_exports, {
241
249
  applyDraftToEventIndex: () => applyDraftToEventIndex,
242
250
  areCertificateConditionsMet: () => areCertificateConditionsMet,
243
251
  areConditionsMet: () => areConditionsMet,
252
+ buildClientFunctionContext: () => buildClientFunctionContext,
244
253
  buildFormState: () => buildFormState,
245
254
  canAccessEventWithScope: () => canAccessEventWithScope,
246
255
  canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
247
256
  canAccessUserWithScope: () => canAccessUserWithScope,
257
+ compileClientFunction: () => compileClientFunction,
248
258
  compositeFieldTypes: () => compositeFieldTypes,
249
259
  createEmptyDraft: () => createEmptyDraft,
250
260
  createFieldConditionals: () => createFieldConditionals,
@@ -265,6 +275,7 @@ __export(events_exports, {
265
275
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
266
276
  deserializeQuery: () => deserializeQuery,
267
277
  errorMessages: () => errorMessages,
278
+ evaluate: () => evaluate,
268
279
  event: () => event,
269
280
  eventMetadataLabelMap: () => eventMetadataLabelMap,
270
281
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -277,6 +288,7 @@ __export(events_exports, {
277
288
  findActiveDraftForEvent: () => findActiveDraftForEvent,
278
289
  findAllFields: () => findAllFields,
279
290
  findLastAssignmentAction: () => findLastAssignmentAction,
291
+ findPendingCorrectionAction: () => findPendingCorrectionAction,
280
292
  findRecordActionPages: () => findRecordActionPages,
281
293
  flag: () => flag,
282
294
  flattenFieldReference: () => flattenFieldReference,
@@ -310,6 +322,7 @@ __export(events_exports, {
310
322
  getAvailableActionsForEvent: () => getAvailableActionsForEvent,
311
323
  getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
312
324
  getCompleteActionAnnotation: () => getCompleteActionAnnotation,
325
+ getCompleteActionContent: () => getCompleteActionContent,
313
326
  getCompleteActionDeclaration: () => getCompleteActionDeclaration,
314
327
  getCurrentEventState: () => getCurrentEventState,
315
328
  getCustomActionFields: () => getCustomActionFields,
@@ -318,6 +331,7 @@ __export(events_exports, {
318
331
  getDeclarationFields: () => getDeclarationFields,
319
332
  getDeclarationPages: () => getDeclarationPages,
320
333
  getEventConfigById: () => getEventConfigById,
334
+ getEventFlags: () => getEventFlags,
321
335
  getFilePathsFromEvent: () => getFilePathsFromEvent,
322
336
  getLocationHierarchy: () => getLocationHierarchy,
323
337
  getMixedPath: () => getMixedPath,
@@ -340,6 +354,7 @@ __export(events_exports, {
340
354
  isBulletListFieldType: () => isBulletListFieldType,
341
355
  isButtonFieldType: () => isButtonFieldType,
342
356
  isCheckboxFieldType: () => isCheckboxFieldType,
357
+ isCodeToEvaluate: () => isCodeToEvaluate,
343
358
  isConditionMet: () => isConditionMet,
344
359
  isCountryFieldType: () => isCountryFieldType,
345
360
  isCustomFieldType: () => isCustomFieldType,
@@ -380,6 +395,7 @@ __export(events_exports, {
380
395
  isPageVisible: () => isPageVisible,
381
396
  isParagraphFieldType: () => isParagraphFieldType,
382
397
  isPhoneFieldType: () => isPhoneFieldType,
398
+ isPotentialDuplicate: () => isPotentialDuplicate,
383
399
  isPrintButtonFieldType: () => isPrintButtonFieldType,
384
400
  isQrReaderFieldType: () => isQrReaderFieldType,
385
401
  isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -413,12 +429,15 @@ __export(events_exports, {
413
429
  plainDateToLocalDate: () => plainDateToLocalDate,
414
430
  precompileActionSchemas: () => precompileActionSchemas,
415
431
  resolveDateOfEvent: () => resolveDateOfEvent,
432
+ resolveEventCustomFlags: () => resolveEventCustomFlags,
416
433
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
434
+ runClientFunction: () => runClientFunction,
417
435
  runFieldValidations: () => runFieldValidations,
418
436
  runStructuralValidations: () => runStructuralValidations,
419
437
  safeUnion: () => safeUnion,
420
438
  status: () => status,
421
439
  timePeriodToDateRange: () => timePeriodToDateRange,
440
+ todayISO: () => todayISO,
422
441
  user: () => user,
423
442
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
424
443
  validate: () => validate,
@@ -693,18 +712,26 @@ var unflattenScope = (input) => {
693
712
  return { type, options };
694
713
  };
695
714
  var EncodedScope = z2.string().brand("EncodedScope");
696
- var decodeScope = (query) => {
697
- const scope = qs.parse(query, {
715
+ var decodedScopeCache = /* @__PURE__ */ new Map();
716
+ var decodeScope = (encodedScope) => {
717
+ if (decodedScopeCache.has(encodedScope)) {
718
+ return decodedScopeCache.get(encodedScope);
719
+ }
720
+ const scope = qs.parse(encodedScope, {
698
721
  ignoreQueryPrefix: true,
699
722
  comma: true,
700
723
  allowDots: true
701
724
  });
702
725
  const unflattenedScope = unflattenScope(scope);
703
- return Scope.safeParse(unflattenedScope)?.data;
726
+ const result = Scope.safeParse(unflattenedScope)?.data;
727
+ decodedScopeCache.set(encodedScope, result);
728
+ return result;
704
729
  };
705
730
  var DEFAULT_SCOPE_OPTIONS = {
706
731
  placeOfEvent: JurisdictionFilter.enum.all,
707
- accessLevel: JurisdictionFilter.enum.all
732
+ accessLevel: JurisdictionFilter.enum.all,
733
+ registeredIn: JurisdictionFilter.enum.all,
734
+ declaredIn: JurisdictionFilter.enum.all
708
735
  };
709
736
  function getAcceptedScopesByType({
710
737
  acceptedScopes,
@@ -1077,7 +1104,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1077
1104
  ShowConditional,
1078
1105
  // Action can be shown to the user in the list but as disabled
1079
1106
  EnableConditional
1080
- ]);
1107
+ ]).meta({
1108
+ id: "ActionConditional",
1109
+ description: "Conditional gating whether an action is shown (SHOW) or enabled (ENABLE). When omitted from an action, the action is shown and enabled for everyone."
1110
+ });
1081
1111
  var DisplayOnReviewConditional = z7.object({
1082
1112
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1083
1113
  conditional: Conditional
@@ -1092,8 +1122,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1092
1122
  // Field output can be shown / hidden on the review page
1093
1123
  DisplayOnReviewConditional
1094
1124
  ]).meta({
1095
- description: "Field conditional configuration",
1096
- id: "FieldConditional"
1125
+ id: "FieldConditional",
1126
+ description: "Conditional gating whether a form field is shown (SHOW), enabled (ENABLE), or displayed on the review page (DISPLAY_ON_REVIEW). When omitted, the field is shown and enabled for everyone, and is displayed on review whenever it has a value."
1097
1127
  });
1098
1128
 
1099
1129
  // ../commons/src/events/FieldType.ts
@@ -1190,6 +1220,11 @@ var FieldTypesToHideInReview = [
1190
1220
  FieldType.ALPHA_PRINT_BUTTON,
1191
1221
  FieldType.ALPHA_HIDDEN
1192
1222
  ];
1223
+ var HiddenFieldTypes = [
1224
+ FieldType.HTTP,
1225
+ FieldType.QUERY_PARAM_READER,
1226
+ FieldType.ALPHA_HIDDEN
1227
+ ];
1193
1228
 
1194
1229
  // ../commons/src/events/FieldValue.ts
1195
1230
  var z12 = __toESM(require("zod/v4"));
@@ -1316,7 +1351,7 @@ function plainDateToLocalDate(date) {
1316
1351
  // ../commons/src/events/FieldValue.ts
1317
1352
  var TextValue = z12.string();
1318
1353
  var HiddenFieldValue = z12.string();
1319
- var NonEmptyTextValue = TextValue.min(1);
1354
+ var NonEmptyTextValue = z12.string().trim().min(1);
1320
1355
  var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
1321
1356
  var AgeValue = z12.object({
1322
1357
  age: z12.number(),
@@ -1345,6 +1380,7 @@ var DateRangeFieldValue = z12.object({
1345
1380
  var EmailValue = z12.email();
1346
1381
  var CheckboxFieldValue = z12.boolean();
1347
1382
  var NumberFieldValue = z12.number();
1383
+ var SignatureFieldValue = FileFieldValue;
1348
1384
  var ButtonFieldValue = z12.number();
1349
1385
  var VerificationStatusValue = z12.enum([
1350
1386
  "verified",
@@ -1643,8 +1679,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1643
1679
  var ApprovedCorrectionAction = ActionBase.extend(
1644
1680
  z14.object({
1645
1681
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1646
- requestId: z14.string()
1682
+ requestId: z14.string(),
1647
1683
  // TODO move into 'content' property
1684
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1648
1685
  }).shape
1649
1686
  );
1650
1687
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1736,6 +1773,9 @@ var FlagConfig = z15.object({
1736
1773
  "Indicates if this flag expects an action to be performed to be cleared."
1737
1774
  ),
1738
1775
  label: TranslationConfig.describe("Human readable label of the flag.")
1776
+ }).meta({
1777
+ id: "FlagConfig",
1778
+ description: "Configuration for a custom flag that can be added to or removed from records by event actions."
1739
1779
  });
1740
1780
  var ActionFlagConfig = z15.object({
1741
1781
  id: Flag,
@@ -1743,6 +1783,9 @@ var ActionFlagConfig = z15.object({
1743
1783
  conditional: Conditional.optional().describe(
1744
1784
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1745
1785
  )
1786
+ }).meta({
1787
+ id: "ActionFlagConfig",
1788
+ description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
1746
1789
  });
1747
1790
 
1748
1791
  // ../commons/src/events/EventMetadata.ts
@@ -2166,14 +2209,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2166
2209
  }
2167
2210
  }).describe("Unique identifier for the field");
2168
2211
  var FieldReference = import_v43.default.object({
2169
- $$field: FieldId,
2212
+ $$field: FieldId.describe("Id of the field to reference"),
2170
2213
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2171
2214
  'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
2215
+ ),
2216
+ $$code: import_v43.default.string().optional().describe(
2217
+ "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
2218
+ )
2219
+ }).describe(
2220
+ "Reference to a field value, with an optional client-side computation applied."
2221
+ );
2222
+ function isCodeToEvaluate(v) {
2223
+ return !!v && typeof v === "object" && "$$code" in v;
2224
+ }
2225
+ var ComputedDefaultValue = import_v43.default.object({
2226
+ $$code: import_v43.default.string().describe(
2227
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2172
2228
  )
2173
- }).describe("Reference to a field by its ID");
2229
+ }).describe("A context-only computation used as a field default value.");
2174
2230
  var ValidationConfig = import_v43.default.object({
2175
- validator: Conditional,
2176
- message: TranslationConfig
2231
+ validator: Conditional.describe(
2232
+ "Conditional expression that must hold for the field value to be considered valid."
2233
+ ),
2234
+ message: TranslationConfig.describe(
2235
+ "Error message displayed when the validator does not hold."
2236
+ )
2237
+ }).meta({
2238
+ id: "ValidationConfig",
2239
+ description: "Validation rule applied to a form field. The validator is a conditional expression that must hold for the field value to be considered valid."
2177
2240
  });
2178
2241
  var requiredSchema = import_v43.default.union([
2179
2242
  import_v43.default.boolean(),
@@ -2204,7 +2267,7 @@ var BaseField = import_v43.default.object({
2204
2267
  "Indicates whether the field can be modified during record correction."
2205
2268
  ),
2206
2269
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2207
- "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used."
2270
+ "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used. A FieldReference with $$code computes the value via a custom client-side function."
2208
2271
  ),
2209
2272
  analytics: import_v43.default.boolean().default(false).optional().describe(
2210
2273
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2212,30 +2275,40 @@ var BaseField = import_v43.default.object({
2212
2275
  }).describe("Common properties shared across all field types.");
2213
2276
  var Divider = BaseField.extend({
2214
2277
  type: import_v43.default.literal(FieldType.DIVIDER)
2278
+ }).meta({
2279
+ description: "A horizontal line divider",
2280
+ id: "Divider"
2215
2281
  });
2216
2282
  var TextField = BaseField.extend({
2217
2283
  type: import_v43.default.literal(FieldType.TEXT),
2218
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2284
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2219
2285
  configuration: import_v43.default.object({
2220
2286
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2221
2287
  type: import_v43.default.enum(["text", "password"]).optional(),
2222
2288
  prefix: TranslationConfig.optional(),
2223
2289
  postfix: TranslationConfig.optional()
2224
2290
  }).default({ type: "text" }).optional()
2225
- }).describe("Text input");
2291
+ }).meta({
2292
+ description: "A text input field",
2293
+ id: "TextField"
2294
+ });
2226
2295
  var NumberField = BaseField.extend({
2227
2296
  type: import_v43.default.literal(FieldType.NUMBER),
2228
- defaultValue: NumberFieldValue.optional(),
2297
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2229
2298
  configuration: import_v43.default.object({
2230
2299
  min: import_v43.default.number().optional().describe("Minimum value"),
2231
2300
  max: import_v43.default.number().optional().describe("Maximum value"),
2301
+ integer: import_v43.default.boolean().optional().describe("When true, only whole numbers are allowed"),
2232
2302
  prefix: TranslationConfig.optional(),
2233
2303
  postfix: TranslationConfig.optional()
2234
2304
  }).optional()
2235
- }).describe("Number input");
2305
+ }).meta({
2306
+ description: "A number input field",
2307
+ id: "NumberField"
2308
+ });
2236
2309
  var TextAreaField = BaseField.extend({
2237
2310
  type: import_v43.default.literal(FieldType.TEXTAREA),
2238
- defaultValue: NonEmptyTextValue.optional(),
2311
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2239
2312
  configuration: import_v43.default.object({
2240
2313
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2241
2314
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2243,7 +2316,10 @@ var TextAreaField = BaseField.extend({
2243
2316
  prefix: TranslationConfig.optional(),
2244
2317
  postfix: TranslationConfig.optional()
2245
2318
  }).default({ rows: 4 }).optional()
2246
- }).describe("Multiline text input");
2319
+ }).meta({
2320
+ description: "A multiline text input",
2321
+ id: "TextAreaField"
2322
+ });
2247
2323
  var ImageMimeType = import_v43.default.enum([
2248
2324
  "image/png",
2249
2325
  "image/jpg",
@@ -2266,58 +2342,76 @@ var SignatureField = BaseField.extend({
2266
2342
  signaturePromptLabel: TranslationConfig.describe(
2267
2343
  "Title of the signature modal"
2268
2344
  ),
2269
- defaultValue: FieldValue.optional(),
2345
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2270
2346
  configuration: import_v43.default.object({
2271
2347
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2272
2348
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2273
2349
  }).default({
2274
2350
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2275
2351
  })
2276
- }).describe("Signature input field");
2352
+ }).meta({
2353
+ description: "A signature input field",
2354
+ id: "SignatureField"
2355
+ });
2277
2356
  var EmailField = BaseField.extend({
2278
2357
  type: import_v43.default.literal(FieldType.EMAIL),
2279
2358
  configuration: import_v43.default.object({
2280
2359
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2281
2360
  }).default({ maxLength: 255 }).optional(),
2282
- defaultValue: NonEmptyTextValue.optional()
2361
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2362
+ }).meta({
2363
+ description: "An email input field",
2364
+ id: "EmailField"
2283
2365
  });
2284
2366
  var DateField = BaseField.extend({
2285
2367
  type: import_v43.default.literal(FieldType.DATE),
2286
- defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
2368
+ defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
2287
2369
  configuration: import_v43.default.object({
2288
2370
  notice: TranslationConfig.describe(
2289
2371
  "Text to display above the date input"
2290
2372
  ).optional()
2291
2373
  }).optional()
2292
- }).describe("A single date input (yyyy-MM-dd)");
2374
+ }).meta({
2375
+ description: "A date input (yyyy-MM-dd)",
2376
+ id: "DateField"
2377
+ });
2293
2378
  var AgeField = BaseField.extend({
2294
2379
  type: import_v43.default.literal(FieldType.AGE),
2295
- defaultValue: NumberFieldValue.optional(),
2380
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2296
2381
  configuration: import_v43.default.object({
2297
2382
  asOfDate: FieldReference,
2298
2383
  prefix: TranslationConfig.optional(),
2299
2384
  postfix: TranslationConfig.optional()
2300
2385
  })
2301
- }).describe("An age input field which uses the current date as the asOfDate");
2386
+ }).meta({
2387
+ description: "An age input field which uses the current date as the asOfDate",
2388
+ id: "AgeField"
2389
+ });
2302
2390
  var TimeField = BaseField.extend({
2303
2391
  type: import_v43.default.literal(FieldType.TIME),
2304
- defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
2392
+ defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
2305
2393
  configuration: import_v43.default.object({
2306
2394
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2307
2395
  notice: TranslationConfig.describe(
2308
2396
  "Text to display above the time input"
2309
2397
  ).optional()
2310
2398
  }).optional()
2311
- }).describe("A single date input (HH-mm)");
2399
+ }).meta({
2400
+ description: "A single time input (HH-mm)",
2401
+ id: "TimeField"
2402
+ });
2312
2403
  var DateRangeField = BaseField.extend({
2313
2404
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2314
- defaultValue: DateRangeFieldValue.optional(),
2405
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2315
2406
  configuration: import_v43.default.object({
2316
2407
  notice: TranslationConfig.describe(
2317
2408
  "Text to display above the date input"
2318
2409
  ).optional()
2319
2410
  }).optional()
2320
- }).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
2411
+ }).meta({
2412
+ description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
2413
+ id: "DateRangeField"
2414
+ });
2321
2415
  var HtmlFontVariant = import_v43.default.enum([
2322
2416
  "reg12",
2323
2417
  "reg14",
@@ -2361,21 +2455,33 @@ var ImageViewField = BaseField.extend({
2361
2455
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2362
2456
  defaultValue: NonEmptyTextValue.optional(),
2363
2457
  configuration: ImageConfiguration
2364
- }).describe("A read-only image component for form pages");
2458
+ }).meta({
2459
+ description: "A read-only image component for form pages",
2460
+ id: "ImageViewField"
2461
+ });
2365
2462
  var Paragraph = BaseField.extend({
2366
2463
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2367
2464
  configuration: ParagraphConfiguration
2368
- }).describe("A read-only HTML <p> paragraph");
2465
+ }).meta({
2466
+ description: "A read-only HTML <p> paragraph",
2467
+ id: "Paragraph"
2468
+ });
2369
2469
  var Heading = BaseField.extend({
2370
2470
  type: import_v43.default.literal(FieldType.HEADING),
2371
2471
  configuration: HeadingConfiguration
2372
- }).describe("A read-only heading component for form pages");
2472
+ }).meta({
2473
+ description: "A read-only heading component for form pages",
2474
+ id: "Heading"
2475
+ });
2373
2476
  var PageHeader = BaseField.extend({
2374
2477
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2375
- }).describe("A read-only header component for form pages");
2478
+ }).meta({
2479
+ description: "A read-only header component for form pages",
2480
+ id: "PageHeader"
2481
+ });
2376
2482
  var File = BaseField.extend({
2377
2483
  type: import_v43.default.literal(FieldType.FILE),
2378
- defaultValue: FileFieldValue.optional(),
2484
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2379
2485
  configuration: import_v43.default.object({
2380
2486
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2381
2487
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2391,7 +2497,10 @@ var File = BaseField.extend({
2391
2497
  }).default({
2392
2498
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2393
2499
  })
2394
- }).describe("File upload");
2500
+ }).meta({
2501
+ description: "A file upload field",
2502
+ id: "File"
2503
+ });
2395
2504
  var SelectOption = import_v43.default.object({
2396
2505
  value: import_v43.default.string().describe("The value of the option"),
2397
2506
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2399,7 +2508,7 @@ var SelectOption = import_v43.default.object({
2399
2508
  });
2400
2509
  var NumberWithUnitField = BaseField.extend({
2401
2510
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2402
- defaultValue: NumberWithUnitFieldValue.optional(),
2511
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2403
2512
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2404
2513
  configuration: import_v43.default.object({
2405
2514
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2408,17 +2517,23 @@ var NumberWithUnitField = BaseField.extend({
2408
2517
  "Placeholder for the number field"
2409
2518
  )
2410
2519
  }).optional()
2411
- }).describe("Number with unit input");
2520
+ }).meta({
2521
+ description: "A number with unit input field",
2522
+ id: "NumberWithUnitField"
2523
+ });
2412
2524
  var RadioGroup = BaseField.extend({
2413
2525
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2414
- defaultValue: TextValue.optional(),
2526
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2415
2527
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2416
2528
  configuration: import_v43.default.object({
2417
2529
  styles: import_v43.default.object({
2418
2530
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2419
2531
  }).optional()
2420
2532
  }).optional()
2421
- }).describe("Grouped radio options");
2533
+ }).meta({
2534
+ description: "A grouped radio button field",
2535
+ id: "RadioGroup"
2536
+ });
2422
2537
  var BulletList = BaseField.extend({
2423
2538
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2424
2539
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2427,10 +2542,13 @@ var BulletList = BaseField.extend({
2427
2542
  fontVariant: HtmlFontVariant.optional()
2428
2543
  }).optional()
2429
2544
  }).default({})
2430
- }).describe("A list of bullet points");
2545
+ }).meta({
2546
+ description: "A list of bullet points",
2547
+ id: "BulletList"
2548
+ });
2431
2549
  var Select = BaseField.extend({
2432
2550
  type: import_v43.default.literal(FieldType.SELECT),
2433
- defaultValue: TextValue.optional(),
2551
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2434
2552
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2435
2553
  noOptionsMessage: TranslationConfig.optional().describe(
2436
2554
  `
@@ -2442,16 +2560,22 @@ var Select = BaseField.extend({
2442
2560
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2443
2561
  `
2444
2562
  )
2445
- }).describe("Select input");
2563
+ }).meta({
2564
+ description: "A select input field",
2565
+ id: "Select"
2566
+ });
2446
2567
  var SelectDateRangeOption = import_v43.default.object({
2447
2568
  value: SelectDateRangeValue.describe("The value of the option"),
2448
2569
  label: TranslationConfig.describe("The label of the option")
2449
2570
  });
2450
2571
  var SelectDateRangeField = BaseField.extend({
2451
2572
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2452
- defaultValue: SelectDateRangeValue.optional(),
2573
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2453
2574
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2454
- }).describe("Select input with date range options");
2575
+ }).meta({
2576
+ description: "A date range selection field",
2577
+ id: "SelectDateRangeField"
2578
+ });
2455
2579
  var NameConfig = import_v43.default.object({
2456
2580
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2457
2581
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2463,7 +2587,7 @@ var NameField = BaseField.extend({
2463
2587
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2464
2588
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2465
2589
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2466
- }).optional(),
2590
+ }).or(ComputedDefaultValue).optional(),
2467
2591
  configuration: import_v43.default.object({
2468
2592
  name: NameConfig.default({
2469
2593
  firstname: { required: true },
@@ -2482,26 +2606,41 @@ var NameField = BaseField.extend({
2482
2606
  surname: { required: true }
2483
2607
  }
2484
2608
  }).optional()
2485
- }).describe("Name input field");
2609
+ }).meta({
2610
+ description: "A field for entering a persons name",
2611
+ id: "NameField"
2612
+ });
2486
2613
  var PhoneField = BaseField.extend({
2487
- defaultValue: NonEmptyTextValue.optional(),
2614
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2488
2615
  type: import_v43.default.literal(FieldType.PHONE)
2489
- }).describe("Phone input field");
2616
+ }).meta({
2617
+ description: "A field for entering a phone number",
2618
+ id: "PhoneField"
2619
+ });
2490
2620
  var IdField = BaseField.extend({
2491
- defaultValue: NonEmptyTextValue.optional(),
2621
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2492
2622
  type: import_v43.default.literal(FieldType.ID)
2493
- }).describe("ID input field");
2623
+ }).meta({
2624
+ description: "A field for entering an ID",
2625
+ id: "IdField"
2626
+ });
2494
2627
  var Checkbox = BaseField.extend({
2495
2628
  type: import_v43.default.literal(FieldType.CHECKBOX),
2496
- defaultValue: CheckboxFieldValue.default(false)
2497
- }).describe("Boolean checkbox field");
2629
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2630
+ }).meta({
2631
+ description: "A boolean checkbox field",
2632
+ id: "Checkbox"
2633
+ });
2498
2634
  var Country = BaseField.extend({
2499
2635
  type: import_v43.default.literal(FieldType.COUNTRY),
2500
- defaultValue: NonEmptyTextValue.optional(),
2636
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2501
2637
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2502
2638
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2503
2639
  )
2504
- }).describe("Country select field");
2640
+ }).meta({
2641
+ description: "A field for selecting a country",
2642
+ id: "Country"
2643
+ });
2505
2644
  var AllowedLocations = JurisdictionReference.optional().describe(
2506
2645
  "Limits which location options are selectable depending on user jurisdiction and location."
2507
2646
  );
@@ -2510,28 +2649,33 @@ var AdministrativeAreas = import_v43.default.enum([
2510
2649
  "HEALTH_FACILITY",
2511
2650
  "CRVS_OFFICE"
2512
2651
  ]);
2513
- var AdministrativeAreaConfiguration = import_v43.default.object({
2514
- partOf: FieldReference.optional().describe("Parent location"),
2515
- type: AdministrativeAreas,
2516
- allowedLocations: AllowedLocations
2517
- }).describe("Administrative area options");
2518
2652
  var AdministrativeAreaField = BaseField.extend({
2519
2653
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2520
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2521
- configuration: AdministrativeAreaConfiguration
2522
- }).describe("Administrative area input field e.g. facility, office");
2654
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2655
+ configuration: import_v43.default.object({
2656
+ partOf: FieldReference.optional().describe("Parent location"),
2657
+ type: AdministrativeAreas,
2658
+ allowedLocations: AllowedLocations
2659
+ }).describe("Administrative area options")
2660
+ }).meta({
2661
+ description: "Administrative area input field",
2662
+ id: "AdministrativeAreaField"
2663
+ });
2523
2664
  var LocationInput = BaseField.extend({
2524
2665
  type: import_v43.default.literal(FieldType.LOCATION),
2525
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2666
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2526
2667
  configuration: import_v43.default.object({
2527
2668
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2528
2669
  allowedLocations: AllowedLocations
2529
2670
  }).optional()
2530
- }).describe("Input field for a location");
2671
+ }).meta({
2672
+ description: "A field for selecting a location",
2673
+ id: "LocationInput"
2674
+ });
2531
2675
  var FileUploadWithOptions = BaseField.extend({
2532
2676
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2533
2677
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2534
- defaultValue: FileFieldWithOptionValue.optional(),
2678
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2535
2679
  configuration: import_v43.default.object({
2536
2680
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2537
2681
  maxImageSize: import_v43.default.object({
@@ -2541,15 +2685,18 @@ var FileUploadWithOptions = BaseField.extend({
2541
2685
  }).default({
2542
2686
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2543
2687
  })
2688
+ }).meta({
2689
+ description: "A field for uploading files with file type options",
2690
+ id: "FileUploadWithOptions"
2544
2691
  });
2545
2692
  var Facility = BaseField.extend({
2546
2693
  type: import_v43.default.literal(FieldType.FACILITY),
2547
- defaultValue: NonEmptyTextValue.optional(),
2694
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2548
2695
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2549
2696
  }).describe("Input field for a facility");
2550
2697
  var Office = BaseField.extend({
2551
2698
  type: import_v43.default.literal(FieldType.OFFICE),
2552
- defaultValue: NonEmptyTextValue.optional(),
2699
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2553
2700
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2554
2701
  }).describe("Input field for an office");
2555
2702
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2585,8 +2732,11 @@ var Address = BaseField.extend({
2585
2732
  ).optional(),
2586
2733
  allowedLocations: AllowedLocations
2587
2734
  }).optional(),
2588
- defaultValue: DefaultAddressFieldValue.optional()
2589
- }).describe("Address input field \u2013 a combination of location and text fields");
2735
+ defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
2736
+ }).meta({
2737
+ description: "Address input field \u2013 a combination of location and text fields",
2738
+ id: "Address"
2739
+ });
2590
2740
  var StaticDataEntry = import_v43.default.object({
2591
2741
  id: import_v43.default.string().describe("ID for the data entry."),
2592
2742
  label: TranslationConfig,
@@ -2601,7 +2751,10 @@ var DataField = BaseField.extend({
2601
2751
  subtitle: TranslationConfig.optional(),
2602
2752
  data: import_v43.default.array(DataEntry)
2603
2753
  })
2604
- }).describe("Data field for displaying read-only data");
2754
+ }).meta({
2755
+ description: "A field for displaying a table of read-only data",
2756
+ id: "DataField"
2757
+ });
2605
2758
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2606
2759
  var ButtonType = import_v43.default.enum([
2607
2760
  "primary",
@@ -2626,13 +2779,19 @@ var ButtonConfiguration = import_v43.default.object({
2626
2779
  });
2627
2780
  var ButtonField = BaseField.extend({
2628
2781
  type: import_v43.default.literal(FieldType.BUTTON),
2629
- defaultValue: ButtonFieldValue.optional(),
2782
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2630
2783
  configuration: ButtonConfiguration
2631
- }).describe("Generic button without any built-in functionality");
2784
+ }).meta({
2785
+ description: "A generic button that can be used to trigger an action",
2786
+ id: "ButtonField"
2787
+ });
2632
2788
  var FieldGroup = BaseField.extend({
2633
2789
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2634
2790
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2635
2791
  fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
2792
+ }).meta({
2793
+ description: "A group of fields that are displayed together",
2794
+ id: "FieldGroup"
2636
2795
  });
2637
2796
  var AlphaPrintButton = BaseField.extend({
2638
2797
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2642,10 +2801,13 @@ var AlphaPrintButton = BaseField.extend({
2642
2801
  "Label for the print button"
2643
2802
  )
2644
2803
  })
2645
- }).describe("Print button field for printing certificates");
2804
+ }).meta({
2805
+ description: "An experimental print button field for printing certificates during the declaration process",
2806
+ id: "AlphaPrintButton"
2807
+ });
2646
2808
  var HttpField = BaseField.extend({
2647
2809
  type: import_v43.default.literal(FieldType.HTTP),
2648
- defaultValue: HttpFieldValue.optional(),
2810
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2649
2811
  configuration: import_v43.default.object({
2650
2812
  trigger: FieldReference.optional().describe(
2651
2813
  "Reference to the field that triggers the HTTP request when its value changes. If not provided, the HTTP request is triggered once on component mount."
@@ -2658,20 +2820,30 @@ var HttpField = BaseField.extend({
2658
2820
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2659
2821
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2660
2822
  })
2661
- }).describe("HTTP request function triggered by a button click or other event");
2823
+ }).meta({
2824
+ 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.",
2825
+ id: "HttpField"
2826
+ });
2662
2827
  var AutocompleteField = BaseField.extend({
2663
2828
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2664
2829
  configuration: import_v43.default.object({
2665
- url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
2830
+ url: import_v43.default.string().describe(
2831
+ "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
2832
+ ).optional(),
2666
2833
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2667
2834
  defaultOptions: import_v43.default.array(
2668
2835
  import_v43.default.object({
2669
2836
  label: import_v43.default.string(),
2670
2837
  value: import_v43.default.string()
2671
2838
  })
2672
- ).optional()
2839
+ ).optional().describe(
2840
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2841
+ )
2673
2842
  })
2674
- }).describe("Autocomplete input field");
2843
+ }).meta({
2844
+ 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.",
2845
+ id: "AutocompleteField"
2846
+ });
2675
2847
  var SearchField = HttpField.extend({
2676
2848
  type: import_v43.default.literal(FieldType.SEARCH),
2677
2849
  configuration: SearchQuery.pick({
@@ -2704,6 +2876,9 @@ var SearchField = HttpField.extend({
2704
2876
  ok: TranslationConfig.optional()
2705
2877
  }).optional()
2706
2878
  })
2879
+ }).meta({
2880
+ description: "A search input field",
2881
+ id: "SearchField"
2707
2882
  });
2708
2883
  var LinkButtonField = BaseField.extend({
2709
2884
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2712,28 +2887,35 @@ var LinkButtonField = BaseField.extend({
2712
2887
  text: TranslationConfig.describe("Text to display on the button"),
2713
2888
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2714
2889
  })
2715
- }).describe("Button that opens a link");
2890
+ }).meta({
2891
+ description: "A button that opens a URL link",
2892
+ id: "LinkButtonField"
2893
+ });
2716
2894
  var VerificationStatus = BaseField.extend({
2717
2895
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2718
- defaultValue: VerificationStatusValue.optional(),
2896
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2719
2897
  configuration: import_v43.default.object({
2720
2898
  status: TranslationConfig.describe("Text to display on the status pill."),
2721
2899
  description: TranslationConfig.describe(
2722
2900
  "Explaining text on the banner in form."
2723
2901
  )
2724
2902
  })
2903
+ }).meta({
2904
+ 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.",
2905
+ id: "VerificationStatus"
2725
2906
  });
2726
2907
  var QueryParamReaderField = BaseField.extend({
2727
2908
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2728
2909
  configuration: import_v43.default.object({
2729
2910
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2730
2911
  })
2731
- }).describe(
2732
- "A field that maps URL query params into form values and clears them afterward"
2733
- );
2912
+ }).meta({
2913
+ description: "A field that maps URL query params into form values and clears them afterward",
2914
+ id: "QueryParamReaderField"
2915
+ });
2734
2916
  var QrReaderField = BaseField.extend({
2735
2917
  type: import_v43.default.literal(FieldType.QR_READER),
2736
- defaultValue: QrReaderFieldValue.optional(),
2918
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2737
2919
  configuration: import_v43.default.object({
2738
2920
  validator: import_v43.default.any().meta({
2739
2921
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2741,21 +2923,27 @@ var QrReaderField = BaseField.extend({
2741
2923
  })
2742
2924
  }).optional()
2743
2925
  }).meta({
2744
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2926
+ description: "QR code reader field, including optional JSON Schema validator.",
2745
2927
  id: "QrReaderField"
2746
2928
  });
2747
2929
  var IdReaderField = BaseField.extend({
2748
2930
  type: import_v43.default.literal(FieldType.ID_READER),
2749
- defaultValue: IdReaderFieldValue.optional(),
2931
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2750
2932
  methods: import_v43.default.array(
2751
2933
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2752
2934
  )
2935
+ }).meta({
2936
+ description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
2937
+ id: "IdReaderField"
2753
2938
  });
2754
2939
  var CustomField = BaseField.extend({
2755
2940
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2756
2941
  defaultValue: CustomFieldValue.optional(),
2757
2942
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2758
2943
  configuration: import_v43.default.unknown().optional()
2944
+ }).meta({
2945
+ description: "An expiremental custom field that is defined by a module source path",
2946
+ id: "CustomField"
2759
2947
  });
2760
2948
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2761
2949
  var LoaderField = BaseField.extend({
@@ -2765,22 +2953,25 @@ var LoaderField = BaseField.extend({
2765
2953
  configuration: import_v43.default.object({
2766
2954
  text: TranslationConfig.describe("Display text above the loading spinner")
2767
2955
  })
2768
- }).describe(
2769
- "A non-interactive field that indicates an in progress operation in form"
2770
- );
2956
+ }).meta({
2957
+ description: "A non-interactive field that indicates an in progress operation in form",
2958
+ id: "LoaderField"
2959
+ });
2771
2960
  var HiddenField = BaseField.extend({
2772
2961
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2773
2962
  required: import_v43.default.boolean().default(false).optional(),
2774
2963
  defaultValue: TextValue.optional()
2775
- }).describe(
2776
- "A non-interactive, hidden field that only hold a value in the form"
2777
- );
2964
+ }).meta({
2965
+ description: "A non-interactive, hidden field that only hold a value in the form",
2966
+ id: "HiddenField"
2967
+ });
2778
2968
  var UserRoleField = BaseField.extend({
2779
2969
  type: import_v43.default.literal(FieldType.USER_ROLE),
2780
2970
  defaultValue: TextValue.optional()
2781
- }).describe(
2782
- "A select dropdown that is automatically populated with available user roles"
2783
- );
2971
+ }).meta({
2972
+ description: "A select dropdown that is automatically populated with available user roles",
2973
+ id: "UserRoleField"
2974
+ });
2784
2975
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2785
2976
  FieldGroup,
2786
2977
  Address,
@@ -2879,16 +3070,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2879
3070
  type: z21.literal(PageTypes.enum.VERIFICATION),
2880
3071
  actions: VerificationActionConfig
2881
3072
  });
2882
- var PageConfig = z21.discriminatedUnion("type", [
2883
- FormPageConfig,
2884
- VerificationPageConfig
2885
- ]);
3073
+ var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
3074
+ id: "PageConfig",
3075
+ 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."
3076
+ });
2886
3077
 
2887
3078
  // ../commons/src/events/FormConfig.ts
2888
3079
  var DeclarationFormConfig = z22.object({
2889
3080
  label: TranslationConfig.describe("Human readable description of the form"),
2890
3081
  pages: z22.array(FormPageConfig)
2891
- }).describe("Configuration of the declaration form.");
3082
+ }).meta({
3083
+ id: "DeclarationFormConfig",
3084
+ description: "Configuration of the declaration form."
3085
+ });
2892
3086
  var ActionFormConfig = z22.object({
2893
3087
  label: TranslationConfig.describe("Human readable description of the form"),
2894
3088
  pages: z22.array(PageConfig)
@@ -2988,6 +3182,9 @@ var DeduplicationConfig = z23.object({
2988
3182
  id: z23.string(),
2989
3183
  label: TranslationConfig,
2990
3184
  query: Clause
3185
+ }).meta({
3186
+ id: "DeduplicationConfig",
3187
+ description: "Configuration for duplicate detection on a declare or register action. The query is built from fuzzy / strict / date-range matchers combined with and/or/not."
2991
3188
  });
2992
3189
 
2993
3190
  // ../commons/src/events/ActionConfig.ts
@@ -3105,17 +3302,42 @@ var ActionConfig = z24.discriminatedUnion("type", [
3105
3302
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3106
3303
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3107
3304
  */
3108
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3109
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3110
- RejectConfig.meta({ id: "RejectActionConfig" }),
3111
- RegisterConfig.meta({ id: "RegisterActionConfig" }),
3305
+ ReadActionConfig.meta({
3306
+ id: "ReadActionConfig",
3307
+ description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
3308
+ }),
3309
+ DeclareConfig.meta({
3310
+ id: "DeclareActionConfig",
3311
+ description: "Configuration for the declare action. Includes review-page fields. Shared with the notify action (ActionType.NOTIFY)."
3312
+ }),
3313
+ RejectConfig.meta({
3314
+ id: "RejectActionConfig",
3315
+ description: "Configuration for rejecting a record before registration."
3316
+ }),
3317
+ RegisterConfig.meta({
3318
+ id: "RegisterActionConfig",
3319
+ description: "Configuration for registering a record."
3320
+ }),
3112
3321
  PrintCertificateActionConfig.meta({
3113
- id: "PrintCertificateActionConfig"
3322
+ id: "PrintCertificateActionConfig",
3323
+ description: "Configuration for printing a certificate of a registered record."
3324
+ }),
3325
+ RequestCorrectionConfig.meta({
3326
+ id: "RequestCorrectionActionConfig",
3327
+ description: "Configuration for requesting a correction on a registered record."
3328
+ }),
3329
+ EditActionConfig.meta({
3330
+ id: "EditActionConfig",
3331
+ description: "Configuration for editing a record before registration."
3332
+ }),
3333
+ ArchiveConfig.meta({
3334
+ id: "ArchiveActionConfig",
3335
+ description: "Configuration for archiving a record."
3114
3336
  }),
3115
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3116
- EditActionConfig.meta({ id: "EditActionConfig" }),
3117
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3118
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3337
+ CustomActionConfig.meta({
3338
+ id: "CustomActionConfig",
3339
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3340
+ })
3119
3341
  ]).describe(
3120
3342
  "Configuration of an action available for an event. Data collected depends on the action type and is accessible through the annotation property in ActionDocument."
3121
3343
  ).meta({ id: "ActionConfig" });
@@ -3191,7 +3413,10 @@ var Field = BaseField2.extend({
3191
3413
  }).describe("Custom field defined for the summary view.");
3192
3414
  var SummaryConfig = z27.object({
3193
3415
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3194
- }).describe("Configuration of the event summary section.");
3416
+ }).meta({
3417
+ id: "SummaryConfig",
3418
+ 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."
3419
+ });
3195
3420
 
3196
3421
  // ../commons/src/events/AdvancedSearchConfig.ts
3197
3422
  var z28 = __toESM(require("zod/v4"));
@@ -3262,6 +3487,9 @@ var BaseField3 = z28.object({
3262
3487
  ),
3263
3488
  validations: z28.array(ValidationConfig).optional().describe(
3264
3489
  `Option for overriding the field validations specifically for advanced search form.`
3490
+ ),
3491
+ allowedLocations: JurisdictionReference.optional().describe(
3492
+ `Override the allowedLocations for a location field in advanced search. Use this when the declaration form's allowedLocations references a scope (e.g. record.create) that search-only users don't have \u2014 specify record.search scope instead.`
3265
3493
  )
3266
3494
  });
3267
3495
  var SearchQueryParams = z28.object({
@@ -3315,6 +3543,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3315
3543
  var AdvancedSearchConfig = z28.object({
3316
3544
  title: TranslationConfig.describe("Advanced search tab title"),
3317
3545
  fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
3546
+ }).meta({
3547
+ id: "AdvancedSearchConfig",
3548
+ description: "Configuration of one advanced search tab. Each tab has a title and a list of searchable fields \u2014 either declaration fields (via `field()`) or event metadata (via `event()`)."
3318
3549
  });
3319
3550
 
3320
3551
  // ../commons/src/events/utils.ts
@@ -3333,9 +3564,11 @@ var z30 = __toESM(require("zod/v4"));
3333
3564
  var z29 = __toESM(require("zod/v4"));
3334
3565
  function getDynamicNameValue(field3) {
3335
3566
  const nameConfiguration = field3.configuration?.name;
3567
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3568
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3336
3569
  return z29.object({
3337
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3338
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3570
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3571
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3339
3572
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3340
3573
  });
3341
3574
  }
@@ -3682,7 +3915,7 @@ var isHiddenFieldType = (field3) => {
3682
3915
  return field3.config.type === FieldType.ALPHA_HIDDEN;
3683
3916
  };
3684
3917
  var isNonInteractiveFieldType = (field3) => {
3685
- return field3.type === FieldType.DIVIDER || field3.type === FieldType.PAGE_HEADER || field3.type === FieldType.PARAGRAPH || field3.type === FieldType.HEADING || field3.type === FieldType.BULLET_LIST || field3.type === FieldType.DATA || field3.type === FieldType.ALPHA_PRINT_BUTTON || field3.type === FieldType.HTTP || field3.type === FieldType.LINK_BUTTON || field3.type === FieldType.QUERY_PARAM_READER || field3.type === FieldType.LOADER;
3918
+ return field3.type === FieldType.DIVIDER || field3.type === FieldType.PAGE_HEADER || field3.type === FieldType.PARAGRAPH || field3.type === FieldType.HEADING || field3.type === FieldType.BULLET_LIST || field3.type === FieldType.DATA || field3.type === FieldType.ALPHA_PRINT_BUTTON || field3.type === FieldType.LINK_BUTTON || field3.type === FieldType.LOADER;
3686
3919
  };
3687
3920
 
3688
3921
  // ../commons/src/conditionals/validate.ts
@@ -3718,7 +3951,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3718
3951
  }
3719
3952
  return current;
3720
3953
  }
3954
+ function todayISO() {
3955
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
3956
+ }
3957
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
3958
+ function compileClientFunction(code) {
3959
+ let fn = compiledFunctionCache.get(code);
3960
+ if (!fn) {
3961
+ fn = new Function(`return (${code})`)();
3962
+ compiledFunctionCache.set(code, fn);
3963
+ }
3964
+ return fn;
3965
+ }
3721
3966
  (0, import_ajv_formats.default)(ajv);
3967
+ function buildClientFunctionContext(input) {
3968
+ return {
3969
+ $form: input.form,
3970
+ $now: todayISO(),
3971
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
3972
+ $online: isOnline(),
3973
+ $user: input.validatorContext?.user,
3974
+ $event: input.validatorContext?.event,
3975
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
3976
+ user: input.systemVariables?.user,
3977
+ $window: input.systemVariables?.$window,
3978
+ locations: input.locations,
3979
+ adminLevelIds: input.adminLevelIds
3980
+ };
3981
+ }
3982
+ function runClientFunction(code, data, context) {
3983
+ return compileClientFunction(code)(data, context);
3984
+ }
3722
3985
  ajv.addKeyword({
3723
3986
  keyword: "daysFromDate",
3724
3987
  type: "string",
@@ -3763,7 +4026,7 @@ ajv.addKeyword({
3763
4026
  $data: true,
3764
4027
  errors: true,
3765
4028
  // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
3766
- validate(schema, data, _2, dataContext) {
4029
+ validate(_schema, data, _2, dataContext) {
3767
4030
  const locationIdInput = data;
3768
4031
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3769
4032
  return locations.some((location) => location.id === locationIdInput);
@@ -3794,6 +4057,23 @@ function isAgeValue(value) {
3794
4057
  function mergeWithBaseFormState(values, context) {
3795
4058
  return { ...context.baseFormState, ...values };
3796
4059
  }
4060
+ ajv.addKeyword({
4061
+ keyword: "customClientValidator",
4062
+ schemaType: "object",
4063
+ errors: true,
4064
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4065
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4066
+ // so the cast holds.
4067
+ validate(schema, data, _2, dataContext) {
4068
+ return Boolean(
4069
+ runClientFunction(
4070
+ schema.code,
4071
+ data,
4072
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4073
+ )
4074
+ );
4075
+ }
4076
+ });
3797
4077
  function validate(schema, data) {
3798
4078
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3799
4079
  if ("$form" in data) {
@@ -3830,17 +4110,14 @@ function isOnline() {
3830
4110
  }
3831
4111
  return true;
3832
4112
  }
3833
- function isConditionMet(conditional, values, context, eventIndex) {
3834
- return validate(conditional, {
3835
- $form: mergeWithBaseFormState(values, context),
3836
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3837
- $online: isOnline(),
3838
- $user: context.user,
3839
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3840
- $flags: eventIndex?.flags ?? [],
3841
- $status: eventIndex?.status,
3842
- $event: context.event
3843
- });
4113
+ function isConditionMet(conditional, values, context) {
4114
+ return validate(
4115
+ conditional,
4116
+ buildClientFunctionContext({
4117
+ form: mergeWithBaseFormState(values, context),
4118
+ validatorContext: context
4119
+ })
4120
+ );
3844
4121
  }
3845
4122
  function getConditionalActionsForField(field3, values) {
3846
4123
  if (!field3.conditionals) {
@@ -3848,9 +4125,9 @@ function getConditionalActionsForField(field3, values) {
3848
4125
  }
3849
4126
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3850
4127
  }
3851
- function areConditionsMet(conditions, values, context, event2) {
4128
+ function areConditionsMet(conditions, values, context, _event) {
3852
4129
  return conditions.every(
3853
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4130
+ (condition) => isConditionMet(condition.conditional, values, context)
3854
4131
  );
3855
4132
  }
3856
4133
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3860,14 +4137,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3860
4137
  if (!hasRule) {
3861
4138
  return true;
3862
4139
  }
3863
- const validConditionals = getConditionalActionsForField(field3, {
3864
- $form: mergeWithBaseFormState(form, context),
3865
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3866
- $online: isOnline(),
3867
- $user: context.user,
3868
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3869
- $event: context.event
3870
- });
4140
+ const validConditionals = getConditionalActionsForField(
4141
+ field3,
4142
+ buildClientFunctionContext({
4143
+ form: mergeWithBaseFormState(form, context),
4144
+ validatorContext: context
4145
+ })
4146
+ );
3871
4147
  return validConditionals.includes(conditionalType);
3872
4148
  }
3873
4149
  function isFieldVisible(field3, form, context) {
@@ -3893,7 +4169,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3893
4169
  if (!rule) {
3894
4170
  return true;
3895
4171
  }
3896
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4172
+ return validate(rule.conditional, {
4173
+ ...buildClientFunctionContext({
4174
+ form: mergeWithBaseFormState(event2.declaration, context),
4175
+ validatorContext: context
4176
+ }),
4177
+ $flags: event2.flags,
4178
+ $status: event2.status
4179
+ });
3897
4180
  }
3898
4181
  function isActionEnabled(actionConfig, event2, context) {
3899
4182
  return isActionConditionMet(
@@ -4052,19 +4335,10 @@ function runFieldValidations({
4052
4335
  if (!isFieldVisible(field3.config, form, context)) {
4053
4336
  return [];
4054
4337
  }
4055
- const conditionalParameters = {
4056
- $form: mergeWithBaseFormState(form, context),
4057
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4058
- /**
4059
- * In real use cases, there can be hundreds of thousands of locations.
4060
- * Make sure that the context contains only the locations that are needed for validation.
4061
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4062
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4063
- */
4064
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4065
- $online: isOnline(),
4066
- $user: context.user
4067
- };
4338
+ const conditionalParameters = buildClientFunctionContext({
4339
+ form: mergeWithBaseFormState(form, context),
4340
+ validatorContext: context
4341
+ });
4068
4342
  if (isFieldGroupFieldType(field3)) {
4069
4343
  const subfieldErrors = buildFormState(
4070
4344
  field3.config.fields,
@@ -4548,19 +4822,32 @@ function getPendingAction(actions) {
4548
4822
  }
4549
4823
  return pendingActions[0];
4550
4824
  }
4551
- function getCompleteActionAnnotation(annotation, event2, action) {
4825
+ function getCompleteActionAnnotation(event2, action) {
4552
4826
  if (action.originalActionId) {
4553
4827
  const originalAction = event2.actions.find(
4554
4828
  ({ id }) => id === action.originalActionId
4555
4829
  );
4556
4830
  if (originalAction?.status === ActionStatus.Requested) {
4557
- return deepMerge(
4558
- deepMerge(annotation, originalAction.annotation ?? {}),
4559
- action.annotation ?? {}
4560
- );
4831
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4561
4832
  }
4562
4833
  }
4563
- return deepMerge(annotation, action.annotation ?? {});
4834
+ return action.annotation ?? {};
4835
+ }
4836
+ function getCompleteActionContent(event2, action) {
4837
+ const currentContent = "content" in action ? action.content : void 0;
4838
+ if (!action.originalActionId) {
4839
+ return currentContent;
4840
+ }
4841
+ const originalAction = event2.actions.find(
4842
+ ({ id }) => id === action.originalActionId
4843
+ );
4844
+ if (originalAction && "content" in originalAction && originalAction.content) {
4845
+ return {
4846
+ ...originalAction.content,
4847
+ ...currentContent ?? {}
4848
+ };
4849
+ }
4850
+ return currentContent;
4564
4851
  }
4565
4852
  function getCompleteActionDeclaration(declaration, event2, action) {
4566
4853
  if (action.originalActionId) {
@@ -4580,7 +4867,7 @@ function getAcceptedActions(event2) {
4580
4867
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4581
4868
  ...action,
4582
4869
  declaration: getCompleteActionDeclaration({}, event2, action),
4583
- annotation: getCompleteActionAnnotation({}, event2, action)
4870
+ annotation: getCompleteActionAnnotation(event2, action)
4584
4871
  }));
4585
4872
  }
4586
4873
  var EXCLUDED_ACTIONS = [
@@ -4668,6 +4955,9 @@ function not(condition) {
4668
4955
  function never2() {
4669
4956
  return not(alwaysTrue());
4670
4957
  }
4958
+ function always() {
4959
+ return defineConditional(alwaysTrue());
4960
+ }
4671
4961
  function jsonFieldPath(field3) {
4672
4962
  return [field3.$$field, ...field3.$$subfield].join("/");
4673
4963
  }
@@ -5215,7 +5505,54 @@ function createFieldConditionals(fieldId) {
5215
5505
  }
5216
5506
  },
5217
5507
  required: [fieldId]
5218
- })
5508
+ }),
5509
+ /**
5510
+ * Custom client-side validator. The provided function is serialised and executed
5511
+ * just-in-time on the client only. External references (e.g. lodash) are not
5512
+ * available inside the function body — all logic must be self-contained.
5513
+ *
5514
+ * @example
5515
+ * field('nid').customClientValidator((value) => {
5516
+ * // LUHN check — all logic must be inline
5517
+ * const digits = String(value).split('').map(Number)
5518
+ * // ...
5519
+ * return isValid
5520
+ * })
5521
+ */
5522
+ customClientValidator(validationFn) {
5523
+ const code = validationFn.toString();
5524
+ return defineFormConditional({
5525
+ type: "object",
5526
+ properties: wrapToPath(
5527
+ { [fieldId]: { customClientValidator: { code } } },
5528
+ this.$$subfield
5529
+ ),
5530
+ required: [fieldId]
5531
+ });
5532
+ },
5533
+ /**
5534
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5535
+ * that can be used as the `value` property or a DATA component entry.
5536
+ * The function receives the referenced field's value as the first argument and
5537
+ * the full form context as the second; its return value replaces the field reference.
5538
+ * The function is serialised and executed just-in-time on the client only.
5539
+ * External references (e.g. lodash) are not available inside the function body.
5540
+ *
5541
+ * For computing a default value without referencing a specific field, use
5542
+ * `evaluate(fn)` in the `defaultValue` property instead.
5543
+ *
5544
+ * @example
5545
+ * field('a').customClientEvaluation((aValue, ctx) =>
5546
+ * Number(aValue) + Number(ctx.$form.b)
5547
+ * )
5548
+ */
5549
+ customClientEvaluation(computationFn) {
5550
+ return {
5551
+ $$code: computationFn.toString(),
5552
+ $$field: fieldId,
5553
+ $$subfield: this.$$subfield
5554
+ };
5555
+ }
5219
5556
  };
5220
5557
  }
5221
5558
 
@@ -5363,7 +5700,7 @@ var _EventConfigBase = z33.object({
5363
5700
  ),
5364
5701
  label: TranslationConfig.describe("Human-readable label for the event type."),
5365
5702
  actions: z33.array(ActionConfig).describe(
5366
- "Configuration of system-defined actions associated with the event."
5703
+ "Configuration of core and custom actions associated with the event."
5367
5704
  ),
5368
5705
  actionOrder: z33.array(z33.string()).optional().describe(
5369
5706
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5375,7 +5712,7 @@ var _EventConfigBase = z33.object({
5375
5712
  "Configuration of fields available in the advanced search feature."
5376
5713
  ),
5377
5714
  flags: z33.array(FlagConfig).optional().default([]).describe(
5378
- "Configuration of flags associated with the actions of this event type."
5715
+ "Configuration of custom flags associated with the actions of this event type."
5379
5716
  ),
5380
5717
  analytics: z33.boolean().optional().default(true).describe(
5381
5718
  "Indicates whether the records of this event type are included in analytics"
@@ -5388,8 +5725,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5388
5725
  validateActionFlags(event2, ctx);
5389
5726
  validateActionOrder(event2, ctx);
5390
5727
  }).meta({
5391
- id: "EventConfig"
5392
- }).describe("Configuration defining an event type.");
5728
+ id: "EventConfig",
5729
+ description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
5730
+ });
5393
5731
 
5394
5732
  // ../commons/src/events/EventConfigInput.ts
5395
5733
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5612,6 +5950,9 @@ var WorkqueueColumnValue = z34.object({
5612
5950
  var WorkqueueColumn = z34.object({
5613
5951
  label: TranslationConfig,
5614
5952
  value: WorkqueueColumnValue
5953
+ }).meta({
5954
+ id: "WorkqueueColumn",
5955
+ description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
5615
5956
  });
5616
5957
  function defineWorkqueuesColumns(workqueueColumns) {
5617
5958
  return workqueueColumns.map(
@@ -5814,18 +6155,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5814
6155
  query: true,
5815
6156
  columns: true
5816
6157
  });
5817
- var WorkqueueConfigInput = z37.object({
5818
- slug: z37.string().describe("Determines the url of the workqueue."),
5819
- name: TranslationConfig.describe(
5820
- "Title of the workflow (both in navigation and on the page)"
5821
- ),
5822
- query: CountryConfigQueryInputType,
5823
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5824
- "Workqueue call-to-action button configuration. This determines the quick action button shown on each event card and the action taken when the button is clicked."
5825
- ),
5826
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5827
- icon: AvailableIcons,
5828
- emptyMessage: TranslationConfig.optional()
6158
+ var WorkqueueConfigInput = WorkqueueConfig.extend({
6159
+ query: CountryConfigQueryInputType
6160
+ }).meta({
6161
+ id: "WorkqueueConfig",
6162
+ description: "Configuration for a single workqueue. Defines the filter applied to the event index, the quick-action button, the columns shown on each row, and the message rendered when the queue is empty."
5829
6163
  });
5830
6164
  function defineWorkqueue(workqueueInput) {
5831
6165
  const queryInput = workqueueInput.query;
@@ -5888,7 +6222,9 @@ var BaseActionInput = z38.object({
5888
6222
  keepAssignment: z38.boolean().optional(),
5889
6223
  keepAssignmentIfAccepted: z38.boolean().optional(),
5890
6224
  keepAssignmentIfRejected: z38.boolean().optional(),
5891
- waitFor: z38.boolean().optional(),
6225
+ waitFor: z38.boolean().default(true).describe(
6226
+ "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."
6227
+ ),
5892
6228
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5893
6229
  // @TODO: createdAtLocation should be limited to actions that system users can perform. For normal users, it should not be part of the base action.
5894
6230
  createdAtLocation: UUID.nullish().describe(
@@ -6006,7 +6342,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
6006
6342
  var ApproveCorrectionActionInput = BaseActionInput.extend(
6007
6343
  z38.object({
6008
6344
  requestId: z38.string(),
6009
- type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION)
6345
+ type: z38.literal(ActionType.APPROVE_CORRECTION).default(ActionType.APPROVE_CORRECTION),
6346
+ content: z38.object({ immediateCorrection: z38.boolean().optional() }).optional()
6010
6347
  }).shape
6011
6348
  );
6012
6349
  var ReadActionInput = BaseActionInput.extend(
@@ -6068,7 +6405,7 @@ var Draft = z39.object({
6068
6405
  }).describe(
6069
6406
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6070
6407
  );
6071
- var DraftInput = BaseActionInput.extend({
6408
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6072
6409
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6073
6410
  status: z39.enum([
6074
6411
  ActionStatus.Requested,
@@ -6155,6 +6492,8 @@ var updateActions = ActionTypes.extract([
6155
6492
  ActionType.ARCHIVE,
6156
6493
  ActionType.PRINT_CERTIFICATE,
6157
6494
  ActionType.REQUEST_CORRECTION,
6495
+ ActionType.APPROVE_CORRECTION,
6496
+ ActionType.REJECT_CORRECTION,
6158
6497
  ActionType.CUSTOM
6159
6498
  ]);
6160
6499
  function getActionUpdateMetadata(actions) {
@@ -6169,7 +6508,7 @@ function getActionUpdateMetadata(actions) {
6169
6508
  "createdAtLocation",
6170
6509
  "createdByRole"
6171
6510
  ];
6172
- return actions.filter(({ type }) => updateActions.safeParse(type).success).filter(({ status: status2 }) => status2 === ActionStatus.Accepted).reduce(
6511
+ return actions.filter(({ type }) => updateActions.safeParse(type).success).reduce(
6173
6512
  (_2, action) => {
6174
6513
  if (action.originalActionId) {
6175
6514
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6199,26 +6538,43 @@ var import_date_fns3 = require("date-fns");
6199
6538
  function isEditInProgress(actions) {
6200
6539
  return actions.at(-1)?.type === ActionType.EDIT;
6201
6540
  }
6541
+ function findPendingCorrectionAction(writeActions2) {
6542
+ let correctionRequestAction;
6543
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6544
+ const action = writeActions2[i];
6545
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6546
+ break;
6547
+ }
6548
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6549
+ correctionRequestAction = action;
6550
+ break;
6551
+ }
6552
+ }
6553
+ return correctionRequestAction;
6554
+ }
6202
6555
  function isCorrectionRequested(actions) {
6556
+ return findPendingCorrectionAction(actions) !== void 0;
6557
+ }
6558
+ function isDeclarationIncomplete(actions) {
6559
+ return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6560
+ }
6561
+ function isRejected(actions) {
6562
+ const resettingActionTypes = [
6563
+ ActionType.NOTIFY,
6564
+ ActionType.DECLARE,
6565
+ ActionType.EDIT,
6566
+ ActionType.REGISTER
6567
+ ];
6203
6568
  return actions.reduce((prev, { type }) => {
6204
- if (type === ActionType.REQUEST_CORRECTION) {
6569
+ if (type === ActionType.REJECT) {
6205
6570
  return true;
6206
6571
  }
6207
- if (type === ActionType.APPROVE_CORRECTION) {
6208
- return false;
6209
- }
6210
- if (type === ActionType.REJECT_CORRECTION) {
6572
+ if (resettingActionTypes.includes(type)) {
6211
6573
  return false;
6212
6574
  }
6213
6575
  return prev;
6214
6576
  }, false);
6215
6577
  }
6216
- function isDeclarationIncomplete(actions) {
6217
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6218
- }
6219
- function isRejected(actions) {
6220
- return actions.at(-1)?.type === ActionType.REJECT;
6221
- }
6222
6578
  function isPotentialDuplicate(actions) {
6223
6579
  return actions.reduce((prev, { type }) => {
6224
6580
  if (type === ActionType.DUPLICATE_DETECTED) {
@@ -6281,8 +6637,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6281
6637
  return (0, import_lodash3.uniq)(flags);
6282
6638
  }, []);
6283
6639
  }
6284
- function getEventFlags(event2, config) {
6285
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6640
+ function getActionStatusFlags(sortedActions) {
6286
6641
  const actionStatus = sortedActions.reduce(
6287
6642
  (actionStatuses, { type, status: status2 }) => ({
6288
6643
  ...actionStatuses,
@@ -6290,26 +6645,40 @@ function getEventFlags(event2, config) {
6290
6645
  }),
6291
6646
  {}
6292
6647
  );
6293
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6648
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6294
6649
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6295
6650
  return flag2;
6296
6651
  });
6297
- if (isCorrectionRequested(sortedActions)) {
6298
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6652
+ }
6653
+ function getInherentFlags(sortedActions) {
6654
+ const acceptedActions = sortedActions.filter(
6655
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6656
+ );
6657
+ const inherentFlags = [];
6658
+ if (isCorrectionRequested(acceptedActions)) {
6659
+ inherentFlags.push(InherentFlags.CORRECTION_REQUESTED);
6299
6660
  }
6300
- if (isDeclarationIncomplete(sortedActions)) {
6301
- flags.push(InherentFlags.INCOMPLETE);
6661
+ if (isDeclarationIncomplete(acceptedActions)) {
6662
+ inherentFlags.push(InherentFlags.INCOMPLETE);
6302
6663
  }
6303
- if (isRejected(sortedActions)) {
6304
- flags.push(InherentFlags.REJECTED);
6664
+ if (isRejected(acceptedActions)) {
6665
+ inherentFlags.push(InherentFlags.REJECTED);
6305
6666
  }
6306
- if (isPotentialDuplicate(sortedActions)) {
6307
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6667
+ if (isPotentialDuplicate(acceptedActions)) {
6668
+ inherentFlags.push(InherentFlags.POTENTIAL_DUPLICATE);
6308
6669
  }
6309
- if (isEditInProgress(sortedActions)) {
6310
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6670
+ if (isEditInProgress(acceptedActions)) {
6671
+ inherentFlags.push(InherentFlags.EDIT_IN_PROGRESS);
6311
6672
  }
6312
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6673
+ return inherentFlags;
6674
+ }
6675
+ function getEventFlags(event2, config) {
6676
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6677
+ return [
6678
+ ...getActionStatusFlags(sortedActions),
6679
+ ...getInherentFlags(sortedActions),
6680
+ ...resolveEventCustomFlags(event2, config)
6681
+ ];
6313
6682
  }
6314
6683
 
6315
6684
  // ../commons/src/events/state/index.ts
@@ -6544,7 +6913,7 @@ function getActionAnnotation({
6544
6913
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6545
6914
  const actionWithCompleteAnnotation = action && {
6546
6915
  ...action,
6547
- annotation: getCompleteActionAnnotation({}, event2, action)
6916
+ annotation: getCompleteActionAnnotation(event2, action)
6548
6917
  };
6549
6918
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6550
6919
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6616,6 +6985,9 @@ function createFieldConfig(fieldId, options) {
6616
6985
  }
6617
6986
 
6618
6987
  // ../commons/src/events/field.ts
6988
+ function evaluate(computationFn) {
6989
+ return { $$code: computationFn.toString() };
6990
+ }
6619
6991
  function field(fieldId, options = {}) {
6620
6992
  return {
6621
6993
  ...createFieldConditionals(fieldId),
@@ -9865,7 +10237,7 @@ function matchesJurisdictionFilter(locationIds, filter, user2) {
9865
10237
  return locationIds.some((id) => id === user2.primaryOfficeId);
9866
10238
  }
9867
10239
  if (filter === JurisdictionFilter.enum.administrativeArea) {
9868
- return user2.administrativeAreaId === null || locationIds.some((id) => id === user2.administrativeAreaId);
10240
+ return !user2.administrativeAreaId || locationIds.some((id) => id === user2.administrativeAreaId);
9869
10241
  }
9870
10242
  return true;
9871
10243
  }
@@ -10260,18 +10632,19 @@ var ACTION_FILTERS = {
10260
10632
  function filterActionsByFlags(actions, flags) {
10261
10633
  return actions.filter((action) => ACTION_FILTERS[action]?.(flags) ?? true);
10262
10634
  }
10635
+ var REJECTED_ACTIONS = [
10636
+ ActionType.READ,
10637
+ ActionType.NOTIFY,
10638
+ ActionType.CUSTOM,
10639
+ ActionType.EDIT,
10640
+ ActionType.ARCHIVE
10641
+ ];
10263
10642
  function getAvailableActionsWithoutFlagFilters(status2, flags) {
10264
10643
  if (flags.includes(InherentFlags.EDIT_IN_PROGRESS)) {
10265
10644
  return [ActionType.NOTIFY, ActionType.DECLARE, ActionType.REGISTER];
10266
10645
  }
10267
- if (flags.includes(InherentFlags.REJECTED)) {
10268
- return [
10269
- ActionType.READ,
10270
- ActionType.NOTIFY,
10271
- ActionType.CUSTOM,
10272
- ActionType.EDIT,
10273
- ActionType.ARCHIVE
10274
- ];
10646
+ if (flags.includes(InherentFlags.REJECTED) && status2 !== EventStatus.enum.ARCHIVED) {
10647
+ return REJECTED_ACTIONS;
10275
10648
  }
10276
10649
  return AVAILABLE_ACTIONS_BY_EVENT_STATUS[status2];
10277
10650
  }
@@ -10308,3 +10681,366 @@ function getFilePathsFromEvent(event2) {
10308
10681
  });
10309
10682
  return (0, import_lodash7.uniq)(filepaths);
10310
10683
  }
10684
+
10685
+ // ../commons/src/events/mocks.test.utils.ts
10686
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10687
+ {
10688
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10689
+ name: "Central",
10690
+ parentId: null,
10691
+ validUntil: null,
10692
+ externalId: "ydyJb1RAy4U1"
10693
+ },
10694
+ {
10695
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10696
+ name: "Sulaka",
10697
+ parentId: null,
10698
+ validUntil: null,
10699
+ externalId: "pQ8nGxWmZ2Q3"
10700
+ },
10701
+ {
10702
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10703
+ name: "Pualula",
10704
+ parentId: null,
10705
+ validUntil: null,
10706
+ externalId: "Aq91DweLmT8k"
10707
+ },
10708
+ {
10709
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10710
+ name: "Chuminga",
10711
+ parentId: null,
10712
+ validUntil: null,
10713
+ externalId: "Rw0fYNh2Xk9a"
10714
+ },
10715
+ {
10716
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10717
+ name: "Ibombo",
10718
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10719
+ validUntil: null,
10720
+ externalId: "k7DsP4vbN1Qe"
10721
+ },
10722
+ {
10723
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10724
+ name: "Isango",
10725
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10726
+ validUntil: null,
10727
+ externalId: "Gm3Z9eQpHw4L"
10728
+ },
10729
+ {
10730
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10731
+ name: "Isamba",
10732
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10733
+ validUntil: null,
10734
+ externalId: "sT0xVu1KqJ7r"
10735
+ },
10736
+ {
10737
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10738
+ name: "Itambo",
10739
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10740
+ validUntil: null,
10741
+ externalId: "Nq6Bv2HpL9Te"
10742
+ },
10743
+ {
10744
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10745
+ name: "Ezhi",
10746
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10747
+ validUntil: null,
10748
+ externalId: "xK8cQ0ZRy5Wd"
10749
+ },
10750
+ {
10751
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10752
+ name: "Ilanga",
10753
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10754
+ validUntil: null,
10755
+ externalId: "Cq4Jm1XvN8Ls"
10756
+ },
10757
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10758
+ {
10759
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10760
+ name: "Klow",
10761
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10762
+ validUntil: null,
10763
+ externalId: "IkYcYBUcyY2"
10764
+ },
10765
+ {
10766
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10767
+ name: "Mbondo",
10768
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10769
+ validUntil: null,
10770
+ externalId: "Qhvv5hvo3mY"
10771
+ },
10772
+ {
10773
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10774
+ name: "Ndara",
10775
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10776
+ validUntil: null,
10777
+ externalId: "crXh068O9TR"
10778
+ },
10779
+ {
10780
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10781
+ name: "Olani",
10782
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10783
+ validUntil: null,
10784
+ externalId: "r00It8Tvvp7"
10785
+ },
10786
+ {
10787
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10788
+ name: "Pemba",
10789
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10790
+ validUntil: null,
10791
+ externalId: "ZnUWsbONIaH"
10792
+ },
10793
+ {
10794
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10795
+ name: "Quanza",
10796
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10797
+ validUntil: null,
10798
+ externalId: "fDZycvQTa7l"
10799
+ },
10800
+ {
10801
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10802
+ name: "Rivka",
10803
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10804
+ validUntil: null,
10805
+ externalId: "KqswxCGTELa"
10806
+ },
10807
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10808
+ {
10809
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10810
+ name: "Mbula",
10811
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10812
+ validUntil: null,
10813
+ externalId: "osEbKjRc9Kg"
10814
+ },
10815
+ {
10816
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10817
+ name: "Ndoki",
10818
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10819
+ validUntil: null,
10820
+ externalId: "aq4daBUAGr3"
10821
+ },
10822
+ {
10823
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10824
+ name: "Tsanga",
10825
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10826
+ validUntil: null,
10827
+ externalId: "cqis6Y8trbJ"
10828
+ },
10829
+ {
10830
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10831
+ name: "Waziri",
10832
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10833
+ validUntil: null,
10834
+ externalId: "LMijHPyyx6d"
10835
+ },
10836
+ {
10837
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
10838
+ name: "Zimbi",
10839
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10840
+ validUntil: null,
10841
+ externalId: "pcQYbPuKGZ7"
10842
+ },
10843
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
10844
+ {
10845
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
10846
+ name: "Felani",
10847
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10848
+ validUntil: null,
10849
+ externalId: "gSqpoCGdMXp"
10850
+ },
10851
+ {
10852
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
10853
+ name: "Goroma",
10854
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10855
+ validUntil: null,
10856
+ externalId: "KvAAIaNqVrp"
10857
+ },
10858
+ {
10859
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
10860
+ name: "Halifu",
10861
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10862
+ validUntil: null,
10863
+ externalId: "qe4UnEVt1hv"
10864
+ },
10865
+ {
10866
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
10867
+ name: "Jabari",
10868
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10869
+ validUntil: null,
10870
+ externalId: "yHH9Nz4rLOt"
10871
+ },
10872
+ {
10873
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
10874
+ name: "Kifani",
10875
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10876
+ validUntil: null,
10877
+ externalId: "eSWmXIGeu1I"
10878
+ },
10879
+ {
10880
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
10881
+ name: "Lumela",
10882
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10883
+ validUntil: null,
10884
+ externalId: "bh0b3aI1uP3"
10885
+ }
10886
+ ];
10887
+ var V2_DEFAULT_MOCK_LOCATIONS = [
10888
+ {
10889
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
10890
+ name: "Central Provincial Office",
10891
+ locationType: "CRVS_OFFICE",
10892
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10893
+ validUntil: null,
10894
+ externalId: "Xr3Df8WpK6Ys"
10895
+ },
10896
+ {
10897
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
10898
+ name: "Central Health Post",
10899
+ locationType: "HEALTH_FACILITY",
10900
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10901
+ validUntil: null
10902
+ },
10903
+ {
10904
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
10905
+ name: "Ibombo District Office",
10906
+ locationType: "CRVS_OFFICE",
10907
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10908
+ validUntil: null,
10909
+ externalId: "Sm4Nw7GrD2Vy"
10910
+ },
10911
+ {
10912
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
10913
+ name: "Isamba District Office",
10914
+ locationType: "CRVS_OFFICE",
10915
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10916
+ validUntil: null,
10917
+ externalId: "Vg1Bq5XeH9Lt"
10918
+ },
10919
+ {
10920
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
10921
+ name: "Isango District Office",
10922
+ locationType: "CRVS_OFFICE",
10923
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
10924
+ validUntil: null,
10925
+ externalId: "Je7Lm2XqN9Vz"
10926
+ },
10927
+ {
10928
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
10929
+ name: "Sulaka Provincial Office",
10930
+ locationType: "CRVS_OFFICE",
10931
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10932
+ validUntil: null,
10933
+ externalId: "Ht2Wp9KcX5Qv"
10934
+ },
10935
+ {
10936
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
10937
+ name: "Ilanga District Office",
10938
+ locationType: "CRVS_OFFICE",
10939
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10940
+ validUntil: null,
10941
+ externalId: "Yp6Ds1WqN3Xz"
10942
+ },
10943
+ {
10944
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
10945
+ name: "Chamakubi Health Post",
10946
+ locationType: "HEALTH_FACILITY",
10947
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10948
+ validUntil: null,
10949
+ externalId: "M1nFr8LbC2Qy"
10950
+ },
10951
+ {
10952
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
10953
+ name: "Ibombo Rural Health Centre",
10954
+ locationType: "HEALTH_FACILITY",
10955
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10956
+ validUntil: null,
10957
+ externalId: "bT7pV6YrW0Xc"
10958
+ },
10959
+ {
10960
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
10961
+ name: "Chikobo Rural Health Centre",
10962
+ locationType: "HEALTH_FACILITY",
10963
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10964
+ validUntil: null,
10965
+ externalId: "zE4qPn2SgJ5d"
10966
+ },
10967
+ {
10968
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
10969
+ name: "Chilochabalenje Health Post",
10970
+ locationType: "HEALTH_FACILITY",
10971
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10972
+ validUntil: null,
10973
+ externalId: "H8vDs1MqR4Uf"
10974
+ },
10975
+ {
10976
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
10977
+ name: "Chipeso Rural Health Centre",
10978
+ locationType: "HEALTH_FACILITY",
10979
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10980
+ validUntil: null,
10981
+ externalId: "Qw3uZ9KfX6Lm"
10982
+ },
10983
+ {
10984
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
10985
+ name: "Chisamba Rural Health Centre",
10986
+ locationType: "HEALTH_FACILITY",
10987
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10988
+ validUntil: null,
10989
+ externalId: "Yr0pCg8LdM2s"
10990
+ },
10991
+ {
10992
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
10993
+ name: "Chitanda Rural Health Centre",
10994
+ locationType: "HEALTH_FACILITY",
10995
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10996
+ validUntil: null,
10997
+ externalId: "tS9gJ4PwB1Qx"
10998
+ },
10999
+ {
11000
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
11001
+ name: "Golden Valley Rural Health Centre",
11002
+ locationType: "HEALTH_FACILITY",
11003
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11004
+ validUntil: null,
11005
+ externalId: "Ld7Qm3XsA8Vr"
11006
+ },
11007
+ {
11008
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
11009
+ name: "Ipongo Rural Health Centre",
11010
+ locationType: "HEALTH_FACILITY",
11011
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11012
+ validUntil: null,
11013
+ externalId: "kF2sW9DmH0Bt"
11014
+ },
11015
+ {
11016
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
11017
+ name: "Itumbwe Health Post",
11018
+ locationType: "HEALTH_FACILITY",
11019
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11020
+ validUntil: null,
11021
+ externalId: "Ue5Xb3VaC7Pq"
11022
+ },
11023
+ {
11024
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
11025
+ name: "Kabangalala Rural Health Centre",
11026
+ locationType: "HEALTH_FACILITY",
11027
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11028
+ validUntil: null,
11029
+ externalId: "Pz8Kc1TqH6Jn"
11030
+ },
11031
+ // Village offices
11032
+ {
11033
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
11034
+ name: "Klow Village Office",
11035
+ locationType: "CRVS_OFFICE",
11036
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
11037
+ validUntil: null,
11038
+ externalId: "PmAyxAJkxiJ"
11039
+ }
11040
+ ];
11041
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11042
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11043
+ );
11044
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11045
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11046
+ );