@opencrvs/toolkit 2.0.0-rc.1339e24 → 2.0.0-rc.138a880

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 +254 -99
  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 +1006 -232
  26. package/dist/migrations/v2.0/index.js +12 -4
  27. package/dist/notification/index.js +843 -133
  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.138a880.tgz +0 -0
  31. package/package.json +6 -2
  32. package/opencrvs-toolkit-2.0.0-rc.1339e24.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,
@@ -1078,8 +1105,8 @@ var ActionConditional = z7.discriminatedUnion("type", [
1078
1105
  // Action can be shown to the user in the list but as disabled
1079
1106
  EnableConditional
1080
1107
  ]).meta({
1081
- description: "Action conditional configuration",
1082
- id: "ActionConditional"
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."
1083
1110
  });
1084
1111
  var DisplayOnReviewConditional = z7.object({
1085
1112
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
@@ -1095,8 +1122,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1095
1122
  // Field output can be shown / hidden on the review page
1096
1123
  DisplayOnReviewConditional
1097
1124
  ]).meta({
1098
- description: "Field conditional configuration",
1099
- 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."
1100
1127
  });
1101
1128
 
1102
1129
  // ../commons/src/events/FieldType.ts
@@ -1193,6 +1220,11 @@ var FieldTypesToHideInReview = [
1193
1220
  FieldType.ALPHA_PRINT_BUTTON,
1194
1221
  FieldType.ALPHA_HIDDEN
1195
1222
  ];
1223
+ var HiddenFieldTypes = [
1224
+ FieldType.HTTP,
1225
+ FieldType.QUERY_PARAM_READER,
1226
+ FieldType.ALPHA_HIDDEN
1227
+ ];
1196
1228
 
1197
1229
  // ../commons/src/events/FieldValue.ts
1198
1230
  var z12 = __toESM(require("zod/v4"));
@@ -1319,7 +1351,7 @@ function plainDateToLocalDate(date) {
1319
1351
  // ../commons/src/events/FieldValue.ts
1320
1352
  var TextValue = z12.string();
1321
1353
  var HiddenFieldValue = z12.string();
1322
- var NonEmptyTextValue = TextValue.min(1);
1354
+ var NonEmptyTextValue = z12.string().trim().min(1);
1323
1355
  var DateValue = z12.iso.date().describe("Date in the format YYYY-MM-DD");
1324
1356
  var AgeValue = z12.object({
1325
1357
  age: z12.number(),
@@ -1348,6 +1380,7 @@ var DateRangeFieldValue = z12.object({
1348
1380
  var EmailValue = z12.email();
1349
1381
  var CheckboxFieldValue = z12.boolean();
1350
1382
  var NumberFieldValue = z12.number();
1383
+ var SignatureFieldValue = FileFieldValue;
1351
1384
  var ButtonFieldValue = z12.number();
1352
1385
  var VerificationStatusValue = z12.enum([
1353
1386
  "verified",
@@ -1646,8 +1679,9 @@ var RequestedCorrectionAction = ActionBase.extend(
1646
1679
  var ApprovedCorrectionAction = ActionBase.extend(
1647
1680
  z14.object({
1648
1681
  type: z14.literal(ActionType.APPROVE_CORRECTION),
1649
- requestId: z14.string()
1682
+ requestId: z14.string(),
1650
1683
  // TODO move into 'content' property
1684
+ content: z14.object({ immediateCorrection: z14.boolean().optional() }).optional()
1651
1685
  }).shape
1652
1686
  );
1653
1687
  var RejectedCorrectionAction = ActionBase.extend(
@@ -1740,8 +1774,8 @@ var FlagConfig = z15.object({
1740
1774
  ),
1741
1775
  label: TranslationConfig.describe("Human readable label of the flag.")
1742
1776
  }).meta({
1743
- description: "Flag configuration",
1744
- id: "FlagConfig"
1777
+ id: "FlagConfig",
1778
+ description: "Configuration for a custom flag that can be added to or removed from records by event actions."
1745
1779
  });
1746
1780
  var ActionFlagConfig = z15.object({
1747
1781
  id: Flag,
@@ -1750,8 +1784,8 @@ var ActionFlagConfig = z15.object({
1750
1784
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1751
1785
  )
1752
1786
  }).meta({
1753
- description: "Action flag configuration",
1754
- id: "ActionFlagConfig"
1787
+ id: "ActionFlagConfig",
1788
+ description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
1755
1789
  });
1756
1790
 
1757
1791
  // ../commons/src/events/EventMetadata.ts
@@ -2175,14 +2209,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2175
2209
  }
2176
2210
  }).describe("Unique identifier for the field");
2177
2211
  var FieldReference = import_v43.default.object({
2178
- $$field: FieldId,
2212
+ $$field: FieldId.describe("Id of the field to reference"),
2179
2213
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2180
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."
2181
2228
  )
2182
- }).describe("Reference to a field by its ID");
2229
+ }).describe("A context-only computation used as a field default value.");
2183
2230
  var ValidationConfig = import_v43.default.object({
2184
- validator: Conditional,
2185
- 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."
2186
2240
  });
2187
2241
  var requiredSchema = import_v43.default.union([
2188
2242
  import_v43.default.boolean(),
@@ -2213,7 +2267,7 @@ var BaseField = import_v43.default.object({
2213
2267
  "Indicates whether the field can be modified during record correction."
2214
2268
  ),
2215
2269
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2216
- "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."
2217
2271
  ),
2218
2272
  analytics: import_v43.default.boolean().default(false).optional().describe(
2219
2273
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2221,30 +2275,40 @@ var BaseField = import_v43.default.object({
2221
2275
  }).describe("Common properties shared across all field types.");
2222
2276
  var Divider = BaseField.extend({
2223
2277
  type: import_v43.default.literal(FieldType.DIVIDER)
2278
+ }).meta({
2279
+ description: "A horizontal line divider",
2280
+ id: "Divider"
2224
2281
  });
2225
2282
  var TextField = BaseField.extend({
2226
2283
  type: import_v43.default.literal(FieldType.TEXT),
2227
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2284
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2228
2285
  configuration: import_v43.default.object({
2229
2286
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2230
2287
  type: import_v43.default.enum(["text", "password"]).optional(),
2231
2288
  prefix: TranslationConfig.optional(),
2232
2289
  postfix: TranslationConfig.optional()
2233
2290
  }).default({ type: "text" }).optional()
2234
- }).describe("Text input");
2291
+ }).meta({
2292
+ description: "A text input field",
2293
+ id: "TextField"
2294
+ });
2235
2295
  var NumberField = BaseField.extend({
2236
2296
  type: import_v43.default.literal(FieldType.NUMBER),
2237
- defaultValue: NumberFieldValue.optional(),
2297
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2238
2298
  configuration: import_v43.default.object({
2239
2299
  min: import_v43.default.number().optional().describe("Minimum value"),
2240
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"),
2241
2302
  prefix: TranslationConfig.optional(),
2242
2303
  postfix: TranslationConfig.optional()
2243
2304
  }).optional()
2244
- }).describe("Number input");
2305
+ }).meta({
2306
+ description: "A number input field",
2307
+ id: "NumberField"
2308
+ });
2245
2309
  var TextAreaField = BaseField.extend({
2246
2310
  type: import_v43.default.literal(FieldType.TEXTAREA),
2247
- defaultValue: NonEmptyTextValue.optional(),
2311
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2248
2312
  configuration: import_v43.default.object({
2249
2313
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2250
2314
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2252,7 +2316,10 @@ var TextAreaField = BaseField.extend({
2252
2316
  prefix: TranslationConfig.optional(),
2253
2317
  postfix: TranslationConfig.optional()
2254
2318
  }).default({ rows: 4 }).optional()
2255
- }).describe("Multiline text input");
2319
+ }).meta({
2320
+ description: "A multiline text input",
2321
+ id: "TextAreaField"
2322
+ });
2256
2323
  var ImageMimeType = import_v43.default.enum([
2257
2324
  "image/png",
2258
2325
  "image/jpg",
@@ -2275,58 +2342,76 @@ var SignatureField = BaseField.extend({
2275
2342
  signaturePromptLabel: TranslationConfig.describe(
2276
2343
  "Title of the signature modal"
2277
2344
  ),
2278
- defaultValue: FieldValue.optional(),
2345
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2279
2346
  configuration: import_v43.default.object({
2280
2347
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2281
2348
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2282
2349
  }).default({
2283
2350
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2284
2351
  })
2285
- }).describe("Signature input field");
2352
+ }).meta({
2353
+ description: "A signature input field",
2354
+ id: "SignatureField"
2355
+ });
2286
2356
  var EmailField = BaseField.extend({
2287
2357
  type: import_v43.default.literal(FieldType.EMAIL),
2288
2358
  configuration: import_v43.default.object({
2289
2359
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2290
2360
  }).default({ maxLength: 255 }).optional(),
2291
- defaultValue: NonEmptyTextValue.optional()
2361
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2362
+ }).meta({
2363
+ description: "An email input field",
2364
+ id: "EmailField"
2292
2365
  });
2293
2366
  var DateField = BaseField.extend({
2294
2367
  type: import_v43.default.literal(FieldType.DATE),
2295
- 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)"),
2296
2369
  configuration: import_v43.default.object({
2297
2370
  notice: TranslationConfig.describe(
2298
2371
  "Text to display above the date input"
2299
2372
  ).optional()
2300
2373
  }).optional()
2301
- }).describe("A single date input (yyyy-MM-dd)");
2374
+ }).meta({
2375
+ description: "A date input (yyyy-MM-dd)",
2376
+ id: "DateField"
2377
+ });
2302
2378
  var AgeField = BaseField.extend({
2303
2379
  type: import_v43.default.literal(FieldType.AGE),
2304
- defaultValue: NumberFieldValue.optional(),
2380
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2305
2381
  configuration: import_v43.default.object({
2306
2382
  asOfDate: FieldReference,
2307
2383
  prefix: TranslationConfig.optional(),
2308
2384
  postfix: TranslationConfig.optional()
2309
2385
  })
2310
- }).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
+ });
2311
2390
  var TimeField = BaseField.extend({
2312
2391
  type: import_v43.default.literal(FieldType.TIME),
2313
- 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)"),
2314
2393
  configuration: import_v43.default.object({
2315
2394
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2316
2395
  notice: TranslationConfig.describe(
2317
2396
  "Text to display above the time input"
2318
2397
  ).optional()
2319
2398
  }).optional()
2320
- }).describe("A single date input (HH-mm)");
2399
+ }).meta({
2400
+ description: "A single time input (HH-mm)",
2401
+ id: "TimeField"
2402
+ });
2321
2403
  var DateRangeField = BaseField.extend({
2322
2404
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2323
- defaultValue: DateRangeFieldValue.optional(),
2405
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2324
2406
  configuration: import_v43.default.object({
2325
2407
  notice: TranslationConfig.describe(
2326
2408
  "Text to display above the date input"
2327
2409
  ).optional()
2328
2410
  }).optional()
2329
- }).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
+ });
2330
2415
  var HtmlFontVariant = import_v43.default.enum([
2331
2416
  "reg12",
2332
2417
  "reg14",
@@ -2370,21 +2455,33 @@ var ImageViewField = BaseField.extend({
2370
2455
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2371
2456
  defaultValue: NonEmptyTextValue.optional(),
2372
2457
  configuration: ImageConfiguration
2373
- }).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
+ });
2374
2462
  var Paragraph = BaseField.extend({
2375
2463
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2376
2464
  configuration: ParagraphConfiguration
2377
- }).describe("A read-only HTML <p> paragraph");
2465
+ }).meta({
2466
+ description: "A read-only HTML <p> paragraph",
2467
+ id: "Paragraph"
2468
+ });
2378
2469
  var Heading = BaseField.extend({
2379
2470
  type: import_v43.default.literal(FieldType.HEADING),
2380
2471
  configuration: HeadingConfiguration
2381
- }).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
+ });
2382
2476
  var PageHeader = BaseField.extend({
2383
2477
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2384
- }).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
+ });
2385
2482
  var File = BaseField.extend({
2386
2483
  type: import_v43.default.literal(FieldType.FILE),
2387
- defaultValue: FileFieldValue.optional(),
2484
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2388
2485
  configuration: import_v43.default.object({
2389
2486
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2390
2487
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2400,7 +2497,10 @@ var File = BaseField.extend({
2400
2497
  }).default({
2401
2498
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2402
2499
  })
2403
- }).describe("File upload");
2500
+ }).meta({
2501
+ description: "A file upload field",
2502
+ id: "File"
2503
+ });
2404
2504
  var SelectOption = import_v43.default.object({
2405
2505
  value: import_v43.default.string().describe("The value of the option"),
2406
2506
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2408,7 +2508,7 @@ var SelectOption = import_v43.default.object({
2408
2508
  });
2409
2509
  var NumberWithUnitField = BaseField.extend({
2410
2510
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2411
- defaultValue: NumberWithUnitFieldValue.optional(),
2511
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2412
2512
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2413
2513
  configuration: import_v43.default.object({
2414
2514
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2417,17 +2517,23 @@ var NumberWithUnitField = BaseField.extend({
2417
2517
  "Placeholder for the number field"
2418
2518
  )
2419
2519
  }).optional()
2420
- }).describe("Number with unit input");
2520
+ }).meta({
2521
+ description: "A number with unit input field",
2522
+ id: "NumberWithUnitField"
2523
+ });
2421
2524
  var RadioGroup = BaseField.extend({
2422
2525
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2423
- defaultValue: TextValue.optional(),
2526
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2424
2527
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2425
2528
  configuration: import_v43.default.object({
2426
2529
  styles: import_v43.default.object({
2427
2530
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2428
2531
  }).optional()
2429
2532
  }).optional()
2430
- }).describe("Grouped radio options");
2533
+ }).meta({
2534
+ description: "A grouped radio button field",
2535
+ id: "RadioGroup"
2536
+ });
2431
2537
  var BulletList = BaseField.extend({
2432
2538
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2433
2539
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2436,10 +2542,13 @@ var BulletList = BaseField.extend({
2436
2542
  fontVariant: HtmlFontVariant.optional()
2437
2543
  }).optional()
2438
2544
  }).default({})
2439
- }).describe("A list of bullet points");
2545
+ }).meta({
2546
+ description: "A list of bullet points",
2547
+ id: "BulletList"
2548
+ });
2440
2549
  var Select = BaseField.extend({
2441
2550
  type: import_v43.default.literal(FieldType.SELECT),
2442
- defaultValue: TextValue.optional(),
2551
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2443
2552
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2444
2553
  noOptionsMessage: TranslationConfig.optional().describe(
2445
2554
  `
@@ -2451,16 +2560,22 @@ var Select = BaseField.extend({
2451
2560
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2452
2561
  `
2453
2562
  )
2454
- }).describe("Select input");
2563
+ }).meta({
2564
+ description: "A select input field",
2565
+ id: "Select"
2566
+ });
2455
2567
  var SelectDateRangeOption = import_v43.default.object({
2456
2568
  value: SelectDateRangeValue.describe("The value of the option"),
2457
2569
  label: TranslationConfig.describe("The label of the option")
2458
2570
  });
2459
2571
  var SelectDateRangeField = BaseField.extend({
2460
2572
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2461
- defaultValue: SelectDateRangeValue.optional(),
2573
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2462
2574
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2463
- }).describe("Select input with date range options");
2575
+ }).meta({
2576
+ description: "A date range selection field",
2577
+ id: "SelectDateRangeField"
2578
+ });
2464
2579
  var NameConfig = import_v43.default.object({
2465
2580
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2466
2581
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2472,7 +2587,7 @@ var NameField = BaseField.extend({
2472
2587
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2473
2588
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2474
2589
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2475
- }).optional(),
2590
+ }).or(ComputedDefaultValue).optional(),
2476
2591
  configuration: import_v43.default.object({
2477
2592
  name: NameConfig.default({
2478
2593
  firstname: { required: true },
@@ -2491,26 +2606,41 @@ var NameField = BaseField.extend({
2491
2606
  surname: { required: true }
2492
2607
  }
2493
2608
  }).optional()
2494
- }).describe("Name input field");
2609
+ }).meta({
2610
+ description: "A field for entering a persons name",
2611
+ id: "NameField"
2612
+ });
2495
2613
  var PhoneField = BaseField.extend({
2496
- defaultValue: NonEmptyTextValue.optional(),
2614
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2497
2615
  type: import_v43.default.literal(FieldType.PHONE)
2498
- }).describe("Phone input field");
2616
+ }).meta({
2617
+ description: "A field for entering a phone number",
2618
+ id: "PhoneField"
2619
+ });
2499
2620
  var IdField = BaseField.extend({
2500
- defaultValue: NonEmptyTextValue.optional(),
2621
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2501
2622
  type: import_v43.default.literal(FieldType.ID)
2502
- }).describe("ID input field");
2623
+ }).meta({
2624
+ description: "A field for entering an ID",
2625
+ id: "IdField"
2626
+ });
2503
2627
  var Checkbox = BaseField.extend({
2504
2628
  type: import_v43.default.literal(FieldType.CHECKBOX),
2505
- defaultValue: CheckboxFieldValue.default(false)
2506
- }).describe("Boolean checkbox field");
2629
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2630
+ }).meta({
2631
+ description: "A boolean checkbox field",
2632
+ id: "Checkbox"
2633
+ });
2507
2634
  var Country = BaseField.extend({
2508
2635
  type: import_v43.default.literal(FieldType.COUNTRY),
2509
- defaultValue: NonEmptyTextValue.optional(),
2636
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2510
2637
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2511
2638
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2512
2639
  )
2513
- }).describe("Country select field");
2640
+ }).meta({
2641
+ description: "A field for selecting a country",
2642
+ id: "Country"
2643
+ });
2514
2644
  var AllowedLocations = JurisdictionReference.optional().describe(
2515
2645
  "Limits which location options are selectable depending on user jurisdiction and location."
2516
2646
  );
@@ -2519,28 +2649,33 @@ var AdministrativeAreas = import_v43.default.enum([
2519
2649
  "HEALTH_FACILITY",
2520
2650
  "CRVS_OFFICE"
2521
2651
  ]);
2522
- var AdministrativeAreaConfiguration = import_v43.default.object({
2523
- partOf: FieldReference.optional().describe("Parent location"),
2524
- type: AdministrativeAreas,
2525
- allowedLocations: AllowedLocations
2526
- }).describe("Administrative area options");
2527
2652
  var AdministrativeAreaField = BaseField.extend({
2528
2653
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2529
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2530
- configuration: AdministrativeAreaConfiguration
2531
- }).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
+ });
2532
2664
  var LocationInput = BaseField.extend({
2533
2665
  type: import_v43.default.literal(FieldType.LOCATION),
2534
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2666
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2535
2667
  configuration: import_v43.default.object({
2536
2668
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2537
2669
  allowedLocations: AllowedLocations
2538
2670
  }).optional()
2539
- }).describe("Input field for a location");
2671
+ }).meta({
2672
+ description: "A field for selecting a location",
2673
+ id: "LocationInput"
2674
+ });
2540
2675
  var FileUploadWithOptions = BaseField.extend({
2541
2676
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2542
2677
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2543
- defaultValue: FileFieldWithOptionValue.optional(),
2678
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2544
2679
  configuration: import_v43.default.object({
2545
2680
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2546
2681
  maxImageSize: import_v43.default.object({
@@ -2550,15 +2685,18 @@ var FileUploadWithOptions = BaseField.extend({
2550
2685
  }).default({
2551
2686
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2552
2687
  })
2688
+ }).meta({
2689
+ description: "A field for uploading files with file type options",
2690
+ id: "FileUploadWithOptions"
2553
2691
  });
2554
2692
  var Facility = BaseField.extend({
2555
2693
  type: import_v43.default.literal(FieldType.FACILITY),
2556
- defaultValue: NonEmptyTextValue.optional(),
2694
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2557
2695
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2558
2696
  }).describe("Input field for a facility");
2559
2697
  var Office = BaseField.extend({
2560
2698
  type: import_v43.default.literal(FieldType.OFFICE),
2561
- defaultValue: NonEmptyTextValue.optional(),
2699
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2562
2700
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2563
2701
  }).describe("Input field for an office");
2564
2702
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2594,8 +2732,11 @@ var Address = BaseField.extend({
2594
2732
  ).optional(),
2595
2733
  allowedLocations: AllowedLocations
2596
2734
  }).optional(),
2597
- defaultValue: DefaultAddressFieldValue.optional()
2598
- }).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
+ });
2599
2740
  var StaticDataEntry = import_v43.default.object({
2600
2741
  id: import_v43.default.string().describe("ID for the data entry."),
2601
2742
  label: TranslationConfig,
@@ -2610,7 +2751,10 @@ var DataField = BaseField.extend({
2610
2751
  subtitle: TranslationConfig.optional(),
2611
2752
  data: import_v43.default.array(DataEntry)
2612
2753
  })
2613
- }).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
+ });
2614
2758
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2615
2759
  var ButtonType = import_v43.default.enum([
2616
2760
  "primary",
@@ -2635,13 +2779,19 @@ var ButtonConfiguration = import_v43.default.object({
2635
2779
  });
2636
2780
  var ButtonField = BaseField.extend({
2637
2781
  type: import_v43.default.literal(FieldType.BUTTON),
2638
- defaultValue: ButtonFieldValue.optional(),
2782
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2639
2783
  configuration: ButtonConfiguration
2640
- }).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
+ });
2641
2788
  var FieldGroup = BaseField.extend({
2642
2789
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2643
2790
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2644
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"
2645
2795
  });
2646
2796
  var AlphaPrintButton = BaseField.extend({
2647
2797
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2651,10 +2801,13 @@ var AlphaPrintButton = BaseField.extend({
2651
2801
  "Label for the print button"
2652
2802
  )
2653
2803
  })
2654
- }).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
+ });
2655
2808
  var HttpField = BaseField.extend({
2656
2809
  type: import_v43.default.literal(FieldType.HTTP),
2657
- defaultValue: HttpFieldValue.optional(),
2810
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2658
2811
  configuration: import_v43.default.object({
2659
2812
  trigger: FieldReference.optional().describe(
2660
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."
@@ -2667,20 +2820,30 @@ var HttpField = BaseField.extend({
2667
2820
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2668
2821
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2669
2822
  })
2670
- }).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
+ });
2671
2827
  var AutocompleteField = BaseField.extend({
2672
2828
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2673
2829
  configuration: import_v43.default.object({
2674
- 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(),
2675
2833
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2676
2834
  defaultOptions: import_v43.default.array(
2677
2835
  import_v43.default.object({
2678
2836
  label: import_v43.default.string(),
2679
2837
  value: import_v43.default.string()
2680
2838
  })
2681
- ).optional()
2839
+ ).optional().describe(
2840
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2841
+ )
2682
2842
  })
2683
- }).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
+ });
2684
2847
  var SearchField = HttpField.extend({
2685
2848
  type: import_v43.default.literal(FieldType.SEARCH),
2686
2849
  configuration: SearchQuery.pick({
@@ -2713,6 +2876,9 @@ var SearchField = HttpField.extend({
2713
2876
  ok: TranslationConfig.optional()
2714
2877
  }).optional()
2715
2878
  })
2879
+ }).meta({
2880
+ description: "A search input field",
2881
+ id: "SearchField"
2716
2882
  });
2717
2883
  var LinkButtonField = BaseField.extend({
2718
2884
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2721,28 +2887,35 @@ var LinkButtonField = BaseField.extend({
2721
2887
  text: TranslationConfig.describe("Text to display on the button"),
2722
2888
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2723
2889
  })
2724
- }).describe("Button that opens a link");
2890
+ }).meta({
2891
+ description: "A button that opens a URL link",
2892
+ id: "LinkButtonField"
2893
+ });
2725
2894
  var VerificationStatus = BaseField.extend({
2726
2895
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2727
- defaultValue: VerificationStatusValue.optional(),
2896
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2728
2897
  configuration: import_v43.default.object({
2729
2898
  status: TranslationConfig.describe("Text to display on the status pill."),
2730
2899
  description: TranslationConfig.describe(
2731
2900
  "Explaining text on the banner in form."
2732
2901
  )
2733
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"
2734
2906
  });
2735
2907
  var QueryParamReaderField = BaseField.extend({
2736
2908
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2737
2909
  configuration: import_v43.default.object({
2738
2910
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2739
2911
  })
2740
- }).describe(
2741
- "A field that maps URL query params into form values and clears them afterward"
2742
- );
2912
+ }).meta({
2913
+ description: "A field that maps URL query params into form values and clears them afterward",
2914
+ id: "QueryParamReaderField"
2915
+ });
2743
2916
  var QrReaderField = BaseField.extend({
2744
2917
  type: import_v43.default.literal(FieldType.QR_READER),
2745
- defaultValue: QrReaderFieldValue.optional(),
2918
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2746
2919
  configuration: import_v43.default.object({
2747
2920
  validator: import_v43.default.any().meta({
2748
2921
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2750,21 +2923,27 @@ var QrReaderField = BaseField.extend({
2750
2923
  })
2751
2924
  }).optional()
2752
2925
  }).meta({
2753
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2926
+ description: "QR code reader field, including optional JSON Schema validator.",
2754
2927
  id: "QrReaderField"
2755
2928
  });
2756
2929
  var IdReaderField = BaseField.extend({
2757
2930
  type: import_v43.default.literal(FieldType.ID_READER),
2758
- defaultValue: IdReaderFieldValue.optional(),
2931
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2759
2932
  methods: import_v43.default.array(
2760
2933
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2761
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"
2762
2938
  });
2763
2939
  var CustomField = BaseField.extend({
2764
2940
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2765
2941
  defaultValue: CustomFieldValue.optional(),
2766
2942
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2767
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"
2768
2947
  });
2769
2948
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2770
2949
  var LoaderField = BaseField.extend({
@@ -2774,22 +2953,25 @@ var LoaderField = BaseField.extend({
2774
2953
  configuration: import_v43.default.object({
2775
2954
  text: TranslationConfig.describe("Display text above the loading spinner")
2776
2955
  })
2777
- }).describe(
2778
- "A non-interactive field that indicates an in progress operation in form"
2779
- );
2956
+ }).meta({
2957
+ description: "A non-interactive field that indicates an in progress operation in form",
2958
+ id: "LoaderField"
2959
+ });
2780
2960
  var HiddenField = BaseField.extend({
2781
2961
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2782
2962
  required: import_v43.default.boolean().default(false).optional(),
2783
2963
  defaultValue: TextValue.optional()
2784
- }).describe(
2785
- "A non-interactive, hidden field that only hold a value in the form"
2786
- );
2964
+ }).meta({
2965
+ description: "A non-interactive, hidden field that only hold a value in the form",
2966
+ id: "HiddenField"
2967
+ });
2787
2968
  var UserRoleField = BaseField.extend({
2788
2969
  type: import_v43.default.literal(FieldType.USER_ROLE),
2789
2970
  defaultValue: TextValue.optional()
2790
- }).describe(
2791
- "A select dropdown that is automatically populated with available user roles"
2792
- );
2971
+ }).meta({
2972
+ description: "A select dropdown that is automatically populated with available user roles",
2973
+ id: "UserRoleField"
2974
+ });
2793
2975
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2794
2976
  FieldGroup,
2795
2977
  Address,
@@ -2889,15 +3071,18 @@ var VerificationPageConfig = FormPageConfig.extend({
2889
3071
  actions: VerificationActionConfig
2890
3072
  });
2891
3073
  var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
2892
- description: "Page configuration",
2893
- id: "PageConfig"
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."
2894
3076
  });
2895
3077
 
2896
3078
  // ../commons/src/events/FormConfig.ts
2897
3079
  var DeclarationFormConfig = z22.object({
2898
3080
  label: TranslationConfig.describe("Human readable description of the form"),
2899
3081
  pages: z22.array(FormPageConfig)
2900
- }).describe("Configuration of the declaration form.");
3082
+ }).meta({
3083
+ id: "DeclarationFormConfig",
3084
+ description: "Configuration of the declaration form."
3085
+ });
2901
3086
  var ActionFormConfig = z22.object({
2902
3087
  label: TranslationConfig.describe("Human readable description of the form"),
2903
3088
  pages: z22.array(PageConfig)
@@ -2997,6 +3182,9 @@ var DeduplicationConfig = z23.object({
2997
3182
  id: z23.string(),
2998
3183
  label: TranslationConfig,
2999
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."
3000
3188
  });
3001
3189
 
3002
3190
  // ../commons/src/events/ActionConfig.ts
@@ -3114,17 +3302,42 @@ var ActionConfig = z24.discriminatedUnion("type", [
3114
3302
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3115
3303
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3116
3304
  */
3117
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3118
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3119
- RejectConfig.meta({ id: "RejectActionConfig" }),
3120
- 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
+ }),
3121
3321
  PrintCertificateActionConfig.meta({
3122
- 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."
3123
3332
  }),
3124
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3125
- EditActionConfig.meta({ id: "EditActionConfig" }),
3126
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3127
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3333
+ ArchiveConfig.meta({
3334
+ id: "ArchiveActionConfig",
3335
+ description: "Configuration for archiving a record."
3336
+ }),
3337
+ CustomActionConfig.meta({
3338
+ id: "CustomActionConfig",
3339
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3340
+ })
3128
3341
  ]).describe(
3129
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."
3130
3343
  ).meta({ id: "ActionConfig" });
@@ -3200,7 +3413,10 @@ var Field = BaseField2.extend({
3200
3413
  }).describe("Custom field defined for the summary view.");
3201
3414
  var SummaryConfig = z27.object({
3202
3415
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3203
- }).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
+ });
3204
3420
 
3205
3421
  // ../commons/src/events/AdvancedSearchConfig.ts
3206
3422
  var z28 = __toESM(require("zod/v4"));
@@ -3271,6 +3487,9 @@ var BaseField3 = z28.object({
3271
3487
  ),
3272
3488
  validations: z28.array(ValidationConfig).optional().describe(
3273
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.`
3274
3493
  )
3275
3494
  });
3276
3495
  var SearchQueryParams = z28.object({
@@ -3324,6 +3543,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3324
3543
  var AdvancedSearchConfig = z28.object({
3325
3544
  title: TranslationConfig.describe("Advanced search tab title"),
3326
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()`)."
3327
3549
  });
3328
3550
 
3329
3551
  // ../commons/src/events/utils.ts
@@ -3342,9 +3564,11 @@ var z30 = __toESM(require("zod/v4"));
3342
3564
  var z29 = __toESM(require("zod/v4"));
3343
3565
  function getDynamicNameValue(field3) {
3344
3566
  const nameConfiguration = field3.configuration?.name;
3567
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3568
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3345
3569
  return z29.object({
3346
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3347
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3570
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3571
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3348
3572
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3349
3573
  });
3350
3574
  }
@@ -3691,7 +3915,7 @@ var isHiddenFieldType = (field3) => {
3691
3915
  return field3.config.type === FieldType.ALPHA_HIDDEN;
3692
3916
  };
3693
3917
  var isNonInteractiveFieldType = (field3) => {
3694
- 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;
3695
3919
  };
3696
3920
 
3697
3921
  // ../commons/src/conditionals/validate.ts
@@ -3727,7 +3951,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3727
3951
  }
3728
3952
  return current;
3729
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
+ }
3730
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
+ }
3731
3985
  ajv.addKeyword({
3732
3986
  keyword: "daysFromDate",
3733
3987
  type: "string",
@@ -3772,7 +4026,7 @@ ajv.addKeyword({
3772
4026
  $data: true,
3773
4027
  errors: true,
3774
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.
3775
- validate(schema, data, _2, dataContext) {
4029
+ validate(_schema, data, _2, dataContext) {
3776
4030
  const locationIdInput = data;
3777
4031
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3778
4032
  return locations.some((location) => location.id === locationIdInput);
@@ -3803,6 +4057,23 @@ function isAgeValue(value) {
3803
4057
  function mergeWithBaseFormState(values, context) {
3804
4058
  return { ...context.baseFormState, ...values };
3805
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
+ });
3806
4077
  function validate(schema, data) {
3807
4078
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3808
4079
  if ("$form" in data) {
@@ -3839,17 +4110,14 @@ function isOnline() {
3839
4110
  }
3840
4111
  return true;
3841
4112
  }
3842
- function isConditionMet(conditional, values, context, eventIndex) {
3843
- return validate(conditional, {
3844
- $form: mergeWithBaseFormState(values, context),
3845
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3846
- $online: isOnline(),
3847
- $user: context.user,
3848
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3849
- $flags: eventIndex?.flags ?? [],
3850
- $status: eventIndex?.status,
3851
- $event: context.event
3852
- });
4113
+ function isConditionMet(conditional, values, context) {
4114
+ return validate(
4115
+ conditional,
4116
+ buildClientFunctionContext({
4117
+ form: mergeWithBaseFormState(values, context),
4118
+ validatorContext: context
4119
+ })
4120
+ );
3853
4121
  }
3854
4122
  function getConditionalActionsForField(field3, values) {
3855
4123
  if (!field3.conditionals) {
@@ -3857,9 +4125,9 @@ function getConditionalActionsForField(field3, values) {
3857
4125
  }
3858
4126
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3859
4127
  }
3860
- function areConditionsMet(conditions, values, context, event2) {
4128
+ function areConditionsMet(conditions, values, context, _event) {
3861
4129
  return conditions.every(
3862
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4130
+ (condition) => isConditionMet(condition.conditional, values, context)
3863
4131
  );
3864
4132
  }
3865
4133
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3869,14 +4137,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3869
4137
  if (!hasRule) {
3870
4138
  return true;
3871
4139
  }
3872
- const validConditionals = getConditionalActionsForField(field3, {
3873
- $form: mergeWithBaseFormState(form, context),
3874
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3875
- $online: isOnline(),
3876
- $user: context.user,
3877
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3878
- $event: context.event
3879
- });
4140
+ const validConditionals = getConditionalActionsForField(
4141
+ field3,
4142
+ buildClientFunctionContext({
4143
+ form: mergeWithBaseFormState(form, context),
4144
+ validatorContext: context
4145
+ })
4146
+ );
3880
4147
  return validConditionals.includes(conditionalType);
3881
4148
  }
3882
4149
  function isFieldVisible(field3, form, context) {
@@ -3902,7 +4169,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3902
4169
  if (!rule) {
3903
4170
  return true;
3904
4171
  }
3905
- 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
+ });
3906
4180
  }
3907
4181
  function isActionEnabled(actionConfig, event2, context) {
3908
4182
  return isActionConditionMet(
@@ -4061,19 +4335,10 @@ function runFieldValidations({
4061
4335
  if (!isFieldVisible(field3.config, form, context)) {
4062
4336
  return [];
4063
4337
  }
4064
- const conditionalParameters = {
4065
- $form: mergeWithBaseFormState(form, context),
4066
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4067
- /**
4068
- * In real use cases, there can be hundreds of thousands of locations.
4069
- * Make sure that the context contains only the locations that are needed for validation.
4070
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4071
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4072
- */
4073
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4074
- $online: isOnline(),
4075
- $user: context.user
4076
- };
4338
+ const conditionalParameters = buildClientFunctionContext({
4339
+ form: mergeWithBaseFormState(form, context),
4340
+ validatorContext: context
4341
+ });
4077
4342
  if (isFieldGroupFieldType(field3)) {
4078
4343
  const subfieldErrors = buildFormState(
4079
4344
  field3.config.fields,
@@ -4557,19 +4822,32 @@ function getPendingAction(actions) {
4557
4822
  }
4558
4823
  return pendingActions[0];
4559
4824
  }
4560
- function getCompleteActionAnnotation(annotation, event2, action) {
4825
+ function getCompleteActionAnnotation(event2, action) {
4561
4826
  if (action.originalActionId) {
4562
4827
  const originalAction = event2.actions.find(
4563
4828
  ({ id }) => id === action.originalActionId
4564
4829
  );
4565
4830
  if (originalAction?.status === ActionStatus.Requested) {
4566
- return deepMerge(
4567
- deepMerge(annotation, originalAction.annotation ?? {}),
4568
- action.annotation ?? {}
4569
- );
4831
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4570
4832
  }
4571
4833
  }
4572
- 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;
4573
4851
  }
4574
4852
  function getCompleteActionDeclaration(declaration, event2, action) {
4575
4853
  if (action.originalActionId) {
@@ -4589,7 +4867,7 @@ function getAcceptedActions(event2) {
4589
4867
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4590
4868
  ...action,
4591
4869
  declaration: getCompleteActionDeclaration({}, event2, action),
4592
- annotation: getCompleteActionAnnotation({}, event2, action)
4870
+ annotation: getCompleteActionAnnotation(event2, action)
4593
4871
  }));
4594
4872
  }
4595
4873
  var EXCLUDED_ACTIONS = [
@@ -4677,6 +4955,9 @@ function not(condition) {
4677
4955
  function never2() {
4678
4956
  return not(alwaysTrue());
4679
4957
  }
4958
+ function always() {
4959
+ return defineConditional(alwaysTrue());
4960
+ }
4680
4961
  function jsonFieldPath(field3) {
4681
4962
  return [field3.$$field, ...field3.$$subfield].join("/");
4682
4963
  }
@@ -5224,7 +5505,54 @@ function createFieldConditionals(fieldId) {
5224
5505
  }
5225
5506
  },
5226
5507
  required: [fieldId]
5227
- })
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
+ }
5228
5556
  };
5229
5557
  }
5230
5558
 
@@ -5372,7 +5700,7 @@ var _EventConfigBase = z33.object({
5372
5700
  ),
5373
5701
  label: TranslationConfig.describe("Human-readable label for the event type."),
5374
5702
  actions: z33.array(ActionConfig).describe(
5375
- "Configuration of system-defined actions associated with the event."
5703
+ "Configuration of core and custom actions associated with the event."
5376
5704
  ),
5377
5705
  actionOrder: z33.array(z33.string()).optional().describe(
5378
5706
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5384,7 +5712,7 @@ var _EventConfigBase = z33.object({
5384
5712
  "Configuration of fields available in the advanced search feature."
5385
5713
  ),
5386
5714
  flags: z33.array(FlagConfig).optional().default([]).describe(
5387
- "Configuration of flags associated with the actions of this event type."
5715
+ "Configuration of custom flags associated with the actions of this event type."
5388
5716
  ),
5389
5717
  analytics: z33.boolean().optional().default(true).describe(
5390
5718
  "Indicates whether the records of this event type are included in analytics"
@@ -5397,8 +5725,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5397
5725
  validateActionFlags(event2, ctx);
5398
5726
  validateActionOrder(event2, ctx);
5399
5727
  }).meta({
5400
- id: "EventConfig"
5401
- }).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
+ });
5402
5731
 
5403
5732
  // ../commons/src/events/EventConfigInput.ts
5404
5733
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5621,6 +5950,9 @@ var WorkqueueColumnValue = z34.object({
5621
5950
  var WorkqueueColumn = z34.object({
5622
5951
  label: TranslationConfig,
5623
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`)."
5624
5956
  });
5625
5957
  function defineWorkqueuesColumns(workqueueColumns) {
5626
5958
  return workqueueColumns.map(
@@ -5823,18 +6155,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5823
6155
  query: true,
5824
6156
  columns: true
5825
6157
  });
5826
- var WorkqueueConfigInput = z37.object({
5827
- slug: z37.string().describe("Determines the url of the workqueue."),
5828
- name: TranslationConfig.describe(
5829
- "Title of the workflow (both in navigation and on the page)"
5830
- ),
5831
- query: CountryConfigQueryInputType,
5832
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5833
- "Workqueue call-to-action button configuration. This determines the quick action button shown on each event card and the action taken when the button is clicked."
5834
- ),
5835
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5836
- icon: AvailableIcons,
5837
- emptyMessage: TranslationConfig.optional()
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."
5838
6163
  });
5839
6164
  function defineWorkqueue(workqueueInput) {
5840
6165
  const queryInput = workqueueInput.query;
@@ -5897,7 +6222,9 @@ var BaseActionInput = z38.object({
5897
6222
  keepAssignment: z38.boolean().optional(),
5898
6223
  keepAssignmentIfAccepted: z38.boolean().optional(),
5899
6224
  keepAssignmentIfRejected: z38.boolean().optional(),
5900
- 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
+ ),
5901
6228
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5902
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.
5903
6230
  createdAtLocation: UUID.nullish().describe(
@@ -6015,7 +6342,8 @@ var RejectCorrectionActionInput = BaseActionInput.extend(
6015
6342
  var ApproveCorrectionActionInput = BaseActionInput.extend(
6016
6343
  z38.object({
6017
6344
  requestId: z38.string(),
6018
- 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()
6019
6347
  }).shape
6020
6348
  );
6021
6349
  var ReadActionInput = BaseActionInput.extend(
@@ -6077,7 +6405,7 @@ var Draft = z39.object({
6077
6405
  }).describe(
6078
6406
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6079
6407
  );
6080
- var DraftInput = BaseActionInput.extend({
6408
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6081
6409
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6082
6410
  status: z39.enum([
6083
6411
  ActionStatus.Requested,
@@ -6164,6 +6492,8 @@ var updateActions = ActionTypes.extract([
6164
6492
  ActionType.ARCHIVE,
6165
6493
  ActionType.PRINT_CERTIFICATE,
6166
6494
  ActionType.REQUEST_CORRECTION,
6495
+ ActionType.APPROVE_CORRECTION,
6496
+ ActionType.REJECT_CORRECTION,
6167
6497
  ActionType.CUSTOM
6168
6498
  ]);
6169
6499
  function getActionUpdateMetadata(actions) {
@@ -6178,7 +6508,7 @@ function getActionUpdateMetadata(actions) {
6178
6508
  "createdAtLocation",
6179
6509
  "createdByRole"
6180
6510
  ];
6181
- 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(
6182
6512
  (_2, action) => {
6183
6513
  if (action.originalActionId) {
6184
6514
  const originalAction = actions.find(({ id }) => id === action.originalActionId) ?? action;
@@ -6205,28 +6535,19 @@ function getLegalStatuses(actions) {
6205
6535
  // ../commons/src/events/state/flags.ts
6206
6536
  var import_lodash3 = require("lodash");
6207
6537
  var import_date_fns3 = require("date-fns");
6208
- function isEditInProgress(actions) {
6209
- return actions.at(-1)?.type === ActionType.EDIT;
6210
- }
6211
- function isCorrectionRequested(actions) {
6212
- return actions.reduce((prev, { type }) => {
6213
- if (type === ActionType.REQUEST_CORRECTION) {
6214
- return true;
6215
- }
6216
- if (type === ActionType.APPROVE_CORRECTION) {
6217
- return false;
6538
+ function findPendingCorrectionAction(writeActions2) {
6539
+ let correctionRequestAction;
6540
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6541
+ const action = writeActions2[i];
6542
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6543
+ break;
6218
6544
  }
6219
- if (type === ActionType.REJECT_CORRECTION) {
6220
- return false;
6545
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6546
+ correctionRequestAction = action;
6547
+ break;
6221
6548
  }
6222
- return prev;
6223
- }, false);
6224
- }
6225
- function isDeclarationIncomplete(actions) {
6226
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6227
- }
6228
- function isRejected(actions) {
6229
- return actions.at(-1)?.type === ActionType.REJECT;
6549
+ }
6550
+ return correctionRequestAction;
6230
6551
  }
6231
6552
  function isPotentialDuplicate(actions) {
6232
6553
  return actions.reduce((prev, { type }) => {
@@ -6255,6 +6576,88 @@ function isFlagConditionMet(conditional, form, action) {
6255
6576
  }
6256
6577
  });
6257
6578
  }
6579
+ function actionConfigRemovesFlag(action, flagId, actionsUpToAndIncluding, event2, eventConfiguration) {
6580
+ if (!isActionConfigType(action.type)) {
6581
+ return false;
6582
+ }
6583
+ const actionConfig = getActionConfig({
6584
+ eventConfiguration,
6585
+ actionType: action.type,
6586
+ customActionType: "customActionType" in action ? action.customActionType : void 0
6587
+ });
6588
+ const removeOperations = (actionConfig?.flags ?? []).filter(
6589
+ ({ id, operation }) => id === flagId && operation === "remove"
6590
+ );
6591
+ if (removeOperations.length === 0) {
6592
+ return false;
6593
+ }
6594
+ const eventUpToThisAction = { ...event2, actions: actionsUpToAndIncluding };
6595
+ const declaration = aggregateActionDeclarations(eventUpToThisAction);
6596
+ const annotation = aggregateActionAnnotations(eventUpToThisAction);
6597
+ const form = { ...declaration, ...annotation };
6598
+ return removeOperations.some(
6599
+ ({ conditional }) => conditional ? isFlagConditionMet(conditional, form, action) : true
6600
+ );
6601
+ }
6602
+ var INHERENT_FLAG_RULES = [
6603
+ {
6604
+ flag: InherentFlags.CORRECTION_REQUESTED,
6605
+ setOn: [ActionType.REQUEST_CORRECTION],
6606
+ resetOn: [ActionType.APPROVE_CORRECTION, ActionType.REJECT_CORRECTION]
6607
+ },
6608
+ {
6609
+ // INCOMPLETE mirrors the NOTIFIED status: set by NOTIFY, cleared by any
6610
+ // other status-changing action (see getStatusFromActions).
6611
+ flag: InherentFlags.INCOMPLETE,
6612
+ setOn: [ActionType.NOTIFY],
6613
+ resetOn: [
6614
+ ActionType.CREATE,
6615
+ ActionType.DECLARE,
6616
+ ActionType.REGISTER,
6617
+ ActionType.ARCHIVE
6618
+ ]
6619
+ },
6620
+ {
6621
+ flag: InherentFlags.REJECTED,
6622
+ setOn: [ActionType.REJECT],
6623
+ resetOn: [
6624
+ ActionType.NOTIFY,
6625
+ ActionType.DECLARE,
6626
+ ActionType.EDIT,
6627
+ ActionType.REGISTER
6628
+ ]
6629
+ },
6630
+ {
6631
+ flag: InherentFlags.POTENTIAL_DUPLICATE,
6632
+ setOn: [ActionType.DUPLICATE_DETECTED],
6633
+ resetOn: [ActionType.MARK_AS_DUPLICATE, ActionType.MARK_AS_NOT_DUPLICATE]
6634
+ },
6635
+ {
6636
+ flag: InherentFlags.EDIT_IN_PROGRESS,
6637
+ setOn: [ActionType.EDIT],
6638
+ resetOnAnyOtherAction: true
6639
+ }
6640
+ ];
6641
+ function resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration) {
6642
+ return acceptedActions.reduce((present, action, idx) => {
6643
+ if (rule.setOn.includes(action.type)) {
6644
+ return true;
6645
+ }
6646
+ if (rule.resetOnAnyOtherAction || (rule.resetOn ?? []).includes(action.type)) {
6647
+ return false;
6648
+ }
6649
+ if (actionConfigRemovesFlag(
6650
+ action,
6651
+ rule.flag,
6652
+ acceptedActions.slice(0, idx + 1),
6653
+ event2,
6654
+ eventConfiguration
6655
+ )) {
6656
+ return false;
6657
+ }
6658
+ return present;
6659
+ }, false);
6660
+ }
6258
6661
  function resolveEventCustomFlags(event2, eventConfiguration) {
6259
6662
  const actions = getAcceptedActions(event2).filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6260
6663
  return actions.reduce((acc, action, idx) => {
@@ -6290,8 +6693,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6290
6693
  return (0, import_lodash3.uniq)(flags);
6291
6694
  }, []);
6292
6695
  }
6293
- function getEventFlags(event2, config) {
6294
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6696
+ function getActionStatusFlags(sortedActions) {
6295
6697
  const actionStatus = sortedActions.reduce(
6296
6698
  (actionStatuses, { type, status: status2 }) => ({
6297
6699
  ...actionStatuses,
@@ -6299,26 +6701,26 @@ function getEventFlags(event2, config) {
6299
6701
  }),
6300
6702
  {}
6301
6703
  );
6302
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6704
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6303
6705
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6304
6706
  return flag2;
6305
6707
  });
6306
- if (isCorrectionRequested(sortedActions)) {
6307
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6308
- }
6309
- if (isDeclarationIncomplete(sortedActions)) {
6310
- flags.push(InherentFlags.INCOMPLETE);
6311
- }
6312
- if (isRejected(sortedActions)) {
6313
- flags.push(InherentFlags.REJECTED);
6314
- }
6315
- if (isPotentialDuplicate(sortedActions)) {
6316
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6317
- }
6318
- if (isEditInProgress(sortedActions)) {
6319
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6320
- }
6321
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6708
+ }
6709
+ function getInherentFlags(sortedActions, event2, eventConfiguration) {
6710
+ const acceptedActions = sortedActions.filter(
6711
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6712
+ );
6713
+ return INHERENT_FLAG_RULES.filter(
6714
+ (rule) => resolveInherentFlag(rule, acceptedActions, event2, eventConfiguration)
6715
+ ).map(({ flag: flag2 }) => flag2);
6716
+ }
6717
+ function getEventFlags(event2, config) {
6718
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6719
+ return [
6720
+ ...getActionStatusFlags(sortedActions),
6721
+ ...getInherentFlags(sortedActions, event2, config),
6722
+ ...resolveEventCustomFlags(event2, config)
6723
+ ];
6322
6724
  }
6323
6725
 
6324
6726
  // ../commons/src/events/state/index.ts
@@ -6553,7 +6955,7 @@ function getActionAnnotation({
6553
6955
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6554
6956
  const actionWithCompleteAnnotation = action && {
6555
6957
  ...action,
6556
- annotation: getCompleteActionAnnotation({}, event2, action)
6958
+ annotation: getCompleteActionAnnotation(event2, action)
6557
6959
  };
6558
6960
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6559
6961
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6625,6 +7027,9 @@ function createFieldConfig(fieldId, options) {
6625
7027
  }
6626
7028
 
6627
7029
  // ../commons/src/events/field.ts
7030
+ function evaluate(computationFn) {
7031
+ return { $$code: computationFn.toString() };
7032
+ }
6628
7033
  function field(fieldId, options = {}) {
6629
7034
  return {
6630
7035
  ...createFieldConditionals(fieldId),
@@ -7318,6 +7723,11 @@ var TENNIS_CLUB_DECLARATION_REVIEW = {
7318
7723
  id: "signature.upload.modal.title",
7319
7724
  defaultMessage: "Draw signature",
7320
7725
  description: "Title for the modal to draw signature"
7726
+ },
7727
+ // Zod applies the schema default at parse time, but this fixture bypasses
7728
+ // parsing — GeneratedInputField accesses configuration.maxFileSize directly.
7729
+ configuration: {
7730
+ maxFileSize: 5 * 1024 * 1024
7321
7731
  }
7322
7732
  }
7323
7733
  ]
@@ -9874,7 +10284,7 @@ function matchesJurisdictionFilter(locationIds, filter, user2) {
9874
10284
  return locationIds.some((id) => id === user2.primaryOfficeId);
9875
10285
  }
9876
10286
  if (filter === JurisdictionFilter.enum.administrativeArea) {
9877
- return user2.administrativeAreaId === null || locationIds.some((id) => id === user2.administrativeAreaId);
10287
+ return !user2.administrativeAreaId || locationIds.some((id) => id === user2.administrativeAreaId);
9878
10288
  }
9879
10289
  return true;
9880
10290
  }
@@ -9963,7 +10373,7 @@ function canAccessUserWithScope({
9963
10373
  }
9964
10374
  const hasAdministrativeAreaInHierarchy = userToAccess.administrativeHierarchy.some(
9965
10375
  (id) => user2.administrativeAreaId === id
9966
- ) || user2.administrativeAreaId === null;
10376
+ ) || !user2.administrativeAreaId;
9967
10377
  if (opts?.accessLevel === JurisdictionFilter.enum.administrativeArea && !hasAdministrativeAreaInHierarchy) {
9968
10378
  return false;
9969
10379
  }
@@ -10269,18 +10679,19 @@ var ACTION_FILTERS = {
10269
10679
  function filterActionsByFlags(actions, flags) {
10270
10680
  return actions.filter((action) => ACTION_FILTERS[action]?.(flags) ?? true);
10271
10681
  }
10682
+ var REJECTED_ACTIONS = [
10683
+ ActionType.READ,
10684
+ ActionType.NOTIFY,
10685
+ ActionType.CUSTOM,
10686
+ ActionType.EDIT,
10687
+ ActionType.ARCHIVE
10688
+ ];
10272
10689
  function getAvailableActionsWithoutFlagFilters(status2, flags) {
10273
10690
  if (flags.includes(InherentFlags.EDIT_IN_PROGRESS)) {
10274
10691
  return [ActionType.NOTIFY, ActionType.DECLARE, ActionType.REGISTER];
10275
10692
  }
10276
- if (flags.includes(InherentFlags.REJECTED)) {
10277
- return [
10278
- ActionType.READ,
10279
- ActionType.NOTIFY,
10280
- ActionType.CUSTOM,
10281
- ActionType.EDIT,
10282
- ActionType.ARCHIVE
10283
- ];
10693
+ if (flags.includes(InherentFlags.REJECTED) && status2 !== EventStatus.enum.ARCHIVED) {
10694
+ return REJECTED_ACTIONS;
10284
10695
  }
10285
10696
  return AVAILABLE_ACTIONS_BY_EVENT_STATUS[status2];
10286
10697
  }
@@ -10317,3 +10728,366 @@ function getFilePathsFromEvent(event2) {
10317
10728
  });
10318
10729
  return (0, import_lodash7.uniq)(filepaths);
10319
10730
  }
10731
+
10732
+ // ../commons/src/events/mocks.test.utils.ts
10733
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10734
+ {
10735
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10736
+ name: "Central",
10737
+ parentId: null,
10738
+ validUntil: null,
10739
+ externalId: "ydyJb1RAy4U1"
10740
+ },
10741
+ {
10742
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10743
+ name: "Sulaka",
10744
+ parentId: null,
10745
+ validUntil: null,
10746
+ externalId: "pQ8nGxWmZ2Q3"
10747
+ },
10748
+ {
10749
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10750
+ name: "Pualula",
10751
+ parentId: null,
10752
+ validUntil: null,
10753
+ externalId: "Aq91DweLmT8k"
10754
+ },
10755
+ {
10756
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10757
+ name: "Chuminga",
10758
+ parentId: null,
10759
+ validUntil: null,
10760
+ externalId: "Rw0fYNh2Xk9a"
10761
+ },
10762
+ {
10763
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10764
+ name: "Ibombo",
10765
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10766
+ validUntil: null,
10767
+ externalId: "k7DsP4vbN1Qe"
10768
+ },
10769
+ {
10770
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10771
+ name: "Isango",
10772
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10773
+ validUntil: null,
10774
+ externalId: "Gm3Z9eQpHw4L"
10775
+ },
10776
+ {
10777
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10778
+ name: "Isamba",
10779
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10780
+ validUntil: null,
10781
+ externalId: "sT0xVu1KqJ7r"
10782
+ },
10783
+ {
10784
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10785
+ name: "Itambo",
10786
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10787
+ validUntil: null,
10788
+ externalId: "Nq6Bv2HpL9Te"
10789
+ },
10790
+ {
10791
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10792
+ name: "Ezhi",
10793
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10794
+ validUntil: null,
10795
+ externalId: "xK8cQ0ZRy5Wd"
10796
+ },
10797
+ {
10798
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10799
+ name: "Ilanga",
10800
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10801
+ validUntil: null,
10802
+ externalId: "Cq4Jm1XvN8Ls"
10803
+ },
10804
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10805
+ {
10806
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10807
+ name: "Klow",
10808
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10809
+ validUntil: null,
10810
+ externalId: "IkYcYBUcyY2"
10811
+ },
10812
+ {
10813
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10814
+ name: "Mbondo",
10815
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10816
+ validUntil: null,
10817
+ externalId: "Qhvv5hvo3mY"
10818
+ },
10819
+ {
10820
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10821
+ name: "Ndara",
10822
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10823
+ validUntil: null,
10824
+ externalId: "crXh068O9TR"
10825
+ },
10826
+ {
10827
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10828
+ name: "Olani",
10829
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10830
+ validUntil: null,
10831
+ externalId: "r00It8Tvvp7"
10832
+ },
10833
+ {
10834
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10835
+ name: "Pemba",
10836
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10837
+ validUntil: null,
10838
+ externalId: "ZnUWsbONIaH"
10839
+ },
10840
+ {
10841
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10842
+ name: "Quanza",
10843
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10844
+ validUntil: null,
10845
+ externalId: "fDZycvQTa7l"
10846
+ },
10847
+ {
10848
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10849
+ name: "Rivka",
10850
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10851
+ validUntil: null,
10852
+ externalId: "KqswxCGTELa"
10853
+ },
10854
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10855
+ {
10856
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10857
+ name: "Mbula",
10858
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10859
+ validUntil: null,
10860
+ externalId: "osEbKjRc9Kg"
10861
+ },
10862
+ {
10863
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10864
+ name: "Ndoki",
10865
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10866
+ validUntil: null,
10867
+ externalId: "aq4daBUAGr3"
10868
+ },
10869
+ {
10870
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10871
+ name: "Tsanga",
10872
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10873
+ validUntil: null,
10874
+ externalId: "cqis6Y8trbJ"
10875
+ },
10876
+ {
10877
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10878
+ name: "Waziri",
10879
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10880
+ validUntil: null,
10881
+ externalId: "LMijHPyyx6d"
10882
+ },
10883
+ {
10884
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
10885
+ name: "Zimbi",
10886
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10887
+ validUntil: null,
10888
+ externalId: "pcQYbPuKGZ7"
10889
+ },
10890
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
10891
+ {
10892
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
10893
+ name: "Felani",
10894
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10895
+ validUntil: null,
10896
+ externalId: "gSqpoCGdMXp"
10897
+ },
10898
+ {
10899
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
10900
+ name: "Goroma",
10901
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10902
+ validUntil: null,
10903
+ externalId: "KvAAIaNqVrp"
10904
+ },
10905
+ {
10906
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
10907
+ name: "Halifu",
10908
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10909
+ validUntil: null,
10910
+ externalId: "qe4UnEVt1hv"
10911
+ },
10912
+ {
10913
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
10914
+ name: "Jabari",
10915
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10916
+ validUntil: null,
10917
+ externalId: "yHH9Nz4rLOt"
10918
+ },
10919
+ {
10920
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
10921
+ name: "Kifani",
10922
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10923
+ validUntil: null,
10924
+ externalId: "eSWmXIGeu1I"
10925
+ },
10926
+ {
10927
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
10928
+ name: "Lumela",
10929
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10930
+ validUntil: null,
10931
+ externalId: "bh0b3aI1uP3"
10932
+ }
10933
+ ];
10934
+ var V2_DEFAULT_MOCK_LOCATIONS = [
10935
+ {
10936
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
10937
+ name: "Central Provincial Office",
10938
+ locationType: "CRVS_OFFICE",
10939
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10940
+ validUntil: null,
10941
+ externalId: "Xr3Df8WpK6Ys"
10942
+ },
10943
+ {
10944
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
10945
+ name: "Central Health Post",
10946
+ locationType: "HEALTH_FACILITY",
10947
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10948
+ validUntil: null
10949
+ },
10950
+ {
10951
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
10952
+ name: "Ibombo District Office",
10953
+ locationType: "CRVS_OFFICE",
10954
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10955
+ validUntil: null,
10956
+ externalId: "Sm4Nw7GrD2Vy"
10957
+ },
10958
+ {
10959
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
10960
+ name: "Isamba District Office",
10961
+ locationType: "CRVS_OFFICE",
10962
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10963
+ validUntil: null,
10964
+ externalId: "Vg1Bq5XeH9Lt"
10965
+ },
10966
+ {
10967
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
10968
+ name: "Isango District Office",
10969
+ locationType: "CRVS_OFFICE",
10970
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
10971
+ validUntil: null,
10972
+ externalId: "Je7Lm2XqN9Vz"
10973
+ },
10974
+ {
10975
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
10976
+ name: "Sulaka Provincial Office",
10977
+ locationType: "CRVS_OFFICE",
10978
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10979
+ validUntil: null,
10980
+ externalId: "Ht2Wp9KcX5Qv"
10981
+ },
10982
+ {
10983
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
10984
+ name: "Ilanga District Office",
10985
+ locationType: "CRVS_OFFICE",
10986
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10987
+ validUntil: null,
10988
+ externalId: "Yp6Ds1WqN3Xz"
10989
+ },
10990
+ {
10991
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
10992
+ name: "Chamakubi Health Post",
10993
+ locationType: "HEALTH_FACILITY",
10994
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10995
+ validUntil: null,
10996
+ externalId: "M1nFr8LbC2Qy"
10997
+ },
10998
+ {
10999
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
11000
+ name: "Ibombo Rural Health Centre",
11001
+ locationType: "HEALTH_FACILITY",
11002
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11003
+ validUntil: null,
11004
+ externalId: "bT7pV6YrW0Xc"
11005
+ },
11006
+ {
11007
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
11008
+ name: "Chikobo Rural Health Centre",
11009
+ locationType: "HEALTH_FACILITY",
11010
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11011
+ validUntil: null,
11012
+ externalId: "zE4qPn2SgJ5d"
11013
+ },
11014
+ {
11015
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
11016
+ name: "Chilochabalenje Health Post",
11017
+ locationType: "HEALTH_FACILITY",
11018
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11019
+ validUntil: null,
11020
+ externalId: "H8vDs1MqR4Uf"
11021
+ },
11022
+ {
11023
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
11024
+ name: "Chipeso Rural Health Centre",
11025
+ locationType: "HEALTH_FACILITY",
11026
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11027
+ validUntil: null,
11028
+ externalId: "Qw3uZ9KfX6Lm"
11029
+ },
11030
+ {
11031
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
11032
+ name: "Chisamba Rural Health Centre",
11033
+ locationType: "HEALTH_FACILITY",
11034
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11035
+ validUntil: null,
11036
+ externalId: "Yr0pCg8LdM2s"
11037
+ },
11038
+ {
11039
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
11040
+ name: "Chitanda Rural Health Centre",
11041
+ locationType: "HEALTH_FACILITY",
11042
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11043
+ validUntil: null,
11044
+ externalId: "tS9gJ4PwB1Qx"
11045
+ },
11046
+ {
11047
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
11048
+ name: "Golden Valley Rural Health Centre",
11049
+ locationType: "HEALTH_FACILITY",
11050
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11051
+ validUntil: null,
11052
+ externalId: "Ld7Qm3XsA8Vr"
11053
+ },
11054
+ {
11055
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
11056
+ name: "Ipongo Rural Health Centre",
11057
+ locationType: "HEALTH_FACILITY",
11058
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11059
+ validUntil: null,
11060
+ externalId: "kF2sW9DmH0Bt"
11061
+ },
11062
+ {
11063
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
11064
+ name: "Itumbwe Health Post",
11065
+ locationType: "HEALTH_FACILITY",
11066
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11067
+ validUntil: null,
11068
+ externalId: "Ue5Xb3VaC7Pq"
11069
+ },
11070
+ {
11071
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
11072
+ name: "Kabangalala Rural Health Centre",
11073
+ locationType: "HEALTH_FACILITY",
11074
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
11075
+ validUntil: null,
11076
+ externalId: "Pz8Kc1TqH6Jn"
11077
+ },
11078
+ // Village offices
11079
+ {
11080
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
11081
+ name: "Klow Village Office",
11082
+ locationType: "CRVS_OFFICE",
11083
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
11084
+ validUntil: null,
11085
+ externalId: "PmAyxAJkxiJ"
11086
+ }
11087
+ ];
11088
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11089
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11090
+ );
11091
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11092
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11093
+ );