@opencrvs/toolkit 2.0.0-rc.9fb7bf7 → 2.0.0-rc.a0fc425

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 (36) 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 +262 -117
  4. package/dist/cli.js +206 -36
  5. package/dist/commons/api/router.d.ts +3311 -246
  6. package/dist/commons/application-config/index.d.ts +1 -0
  7. package/dist/commons/conditionals/conditionals.d.ts +354 -4
  8. package/dist/commons/conditionals/validate.d.ts +52 -2
  9. package/dist/commons/events/ActionInput.d.ts +108 -0
  10. package/dist/commons/events/Draft.d.ts +4 -2
  11. package/dist/commons/events/EventIndex.d.ts +0 -3
  12. package/dist/commons/events/EventMetadata.d.ts +0 -7
  13. package/dist/commons/events/FieldConfig.d.ts +377 -50
  14. package/dist/commons/events/FieldValue.d.ts +6 -0
  15. package/dist/commons/events/WorkqueueConfig.d.ts +150 -150
  16. package/dist/commons/events/field.d.ts +47 -1
  17. package/dist/commons/events/index.d.ts +2 -0
  18. package/dist/commons/events/state/flags.d.ts +16 -0
  19. package/dist/commons/events/state/index.d.ts +0 -4
  20. package/dist/commons/events/state/utils.d.ts +0 -2
  21. package/dist/commons/events/utils.d.ts +2 -2
  22. package/dist/conditionals/index.js +55 -2
  23. package/dist/events/index.js +916 -246
  24. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts +3 -0
  25. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.d.ts.map +1 -0
  26. package/dist/migrations/v2.0/fix-accept-requested-registration-function-type.js +110 -0
  27. package/dist/migrations/v2.0/index.d.ts.map +1 -1
  28. package/dist/migrations/v2.0/index.js +204 -34
  29. package/dist/migrations/v2.0/migrate-scopes.d.ts.map +1 -1
  30. package/dist/migrations/v2.0/migrate-scopes.js +54 -30
  31. package/dist/notification/index.js +797 -151
  32. package/dist/scopes/index.js +3 -1
  33. package/opencrvs-toolkit-2.0.0-rc.a0fc425.tgz +0 -0
  34. package/package.json +6 -2
  35. package/tsconfig.tsbuildinfo +1 -1
  36. package/opencrvs-toolkit-2.0.0-rc.9fb7bf7.tgz +0 -0
@@ -75,6 +75,7 @@ __export(events_exports, {
75
75
  CheckboxFieldValue: () => CheckboxFieldValue,
76
76
  Clause: () => Clause,
77
77
  ClientSpecificAction: () => ClientSpecificAction,
78
+ ComputedDefaultValue: () => ComputedDefaultValue,
78
79
  Conditional: () => Conditional,
79
80
  ConditionalType: () => ConditionalType,
80
81
  ConfirmableActions: () => ConfirmableActions,
@@ -200,6 +201,7 @@ __export(events_exports, {
200
201
  SelectDateRangeValue: () => SelectDateRangeValue,
201
202
  SelectOption: () => SelectOption,
202
203
  ShowConditional: () => ShowConditional,
204
+ SignatureFieldValue: () => SignatureFieldValue,
203
205
  StaticDataEntry: () => StaticDataEntry,
204
206
  StreetLevelDetailsUpdateValue: () => StreetLevelDetailsUpdateValue,
205
207
  SummaryConfig: () => SummaryConfig,
@@ -213,6 +215,10 @@ __export(events_exports, {
213
215
  UUID: () => UUID,
214
216
  UnassignActionInput: () => UnassignActionInput,
215
217
  UserAuditRecordInput: () => UserAuditRecordInput,
218
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS,
219
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP: () => V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP,
220
+ V2_DEFAULT_MOCK_LOCATIONS: () => V2_DEFAULT_MOCK_LOCATIONS,
221
+ V2_DEFAULT_MOCK_LOCATIONS_MAP: () => V2_DEFAULT_MOCK_LOCATIONS_MAP,
216
222
  ValidationConfig: () => ValidationConfig,
217
223
  VerificationActionConfig: () => VerificationActionConfig,
218
224
  VerificationPageConfig: () => VerificationPageConfig,
@@ -234,6 +240,7 @@ __export(events_exports, {
234
240
  ageToDate: () => ageToDate,
235
241
  aggregateActionAnnotations: () => aggregateActionAnnotations,
236
242
  aggregateActionDeclarations: () => aggregateActionDeclarations,
243
+ always: () => always,
237
244
  alwaysTrue: () => alwaysTrue,
238
245
  and: () => and,
239
246
  annotationActions: () => annotationActions,
@@ -241,10 +248,12 @@ __export(events_exports, {
241
248
  applyDraftToEventIndex: () => applyDraftToEventIndex,
242
249
  areCertificateConditionsMet: () => areCertificateConditionsMet,
243
250
  areConditionsMet: () => areConditionsMet,
251
+ buildClientFunctionContext: () => buildClientFunctionContext,
244
252
  buildFormState: () => buildFormState,
245
253
  canAccessEventWithScope: () => canAccessEventWithScope,
246
254
  canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
247
255
  canAccessUserWithScope: () => canAccessUserWithScope,
256
+ compileClientFunction: () => compileClientFunction,
248
257
  compositeFieldTypes: () => compositeFieldTypes,
249
258
  createEmptyDraft: () => createEmptyDraft,
250
259
  createFieldConditionals: () => createFieldConditionals,
@@ -265,6 +274,7 @@ __export(events_exports, {
265
274
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
266
275
  deserializeQuery: () => deserializeQuery,
267
276
  errorMessages: () => errorMessages,
277
+ evaluate: () => evaluate,
268
278
  event: () => event,
269
279
  eventMetadataLabelMap: () => eventMetadataLabelMap,
270
280
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -277,6 +287,7 @@ __export(events_exports, {
277
287
  findActiveDraftForEvent: () => findActiveDraftForEvent,
278
288
  findAllFields: () => findAllFields,
279
289
  findLastAssignmentAction: () => findLastAssignmentAction,
290
+ findPendingCorrectionAction: () => findPendingCorrectionAction,
280
291
  findRecordActionPages: () => findRecordActionPages,
281
292
  flag: () => flag,
282
293
  flattenFieldReference: () => flattenFieldReference,
@@ -306,7 +317,6 @@ __export(events_exports, {
306
317
  getAllUniqueFields: () => getAllUniqueFields,
307
318
  getAnnotationFromDrafts: () => getAnnotationFromDrafts,
308
319
  getAssignedUserFromActions: () => getAssignedUserFromActions,
309
- getAssignedUserSignatureFromActions: () => getAssignedUserSignatureFromActions,
310
320
  getAssignmentStatus: () => getAssignmentStatus,
311
321
  getAvailableActionsForEvent: () => getAvailableActionsForEvent,
312
322
  getAvailableRolesForUserUpdatePayload: () => getAvailableRolesForUserUpdatePayload,
@@ -319,6 +329,7 @@ __export(events_exports, {
319
329
  getDeclarationFields: () => getDeclarationFields,
320
330
  getDeclarationPages: () => getDeclarationPages,
321
331
  getEventConfigById: () => getEventConfigById,
332
+ getEventFlags: () => getEventFlags,
322
333
  getFilePathsFromEvent: () => getFilePathsFromEvent,
323
334
  getLocationHierarchy: () => getLocationHierarchy,
324
335
  getMixedPath: () => getMixedPath,
@@ -341,6 +352,7 @@ __export(events_exports, {
341
352
  isBulletListFieldType: () => isBulletListFieldType,
342
353
  isButtonFieldType: () => isButtonFieldType,
343
354
  isCheckboxFieldType: () => isCheckboxFieldType,
355
+ isCodeToEvaluate: () => isCodeToEvaluate,
344
356
  isConditionMet: () => isConditionMet,
345
357
  isCountryFieldType: () => isCountryFieldType,
346
358
  isCustomFieldType: () => isCustomFieldType,
@@ -381,6 +393,7 @@ __export(events_exports, {
381
393
  isPageVisible: () => isPageVisible,
382
394
  isParagraphFieldType: () => isParagraphFieldType,
383
395
  isPhoneFieldType: () => isPhoneFieldType,
396
+ isPotentialDuplicate: () => isPotentialDuplicate,
384
397
  isPrintButtonFieldType: () => isPrintButtonFieldType,
385
398
  isQrReaderFieldType: () => isQrReaderFieldType,
386
399
  isQueryParamReaderFieldType: () => isQueryParamReaderFieldType,
@@ -414,12 +427,15 @@ __export(events_exports, {
414
427
  plainDateToLocalDate: () => plainDateToLocalDate,
415
428
  precompileActionSchemas: () => precompileActionSchemas,
416
429
  resolveDateOfEvent: () => resolveDateOfEvent,
430
+ resolveEventCustomFlags: () => resolveEventCustomFlags,
417
431
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
432
+ runClientFunction: () => runClientFunction,
418
433
  runFieldValidations: () => runFieldValidations,
419
434
  runStructuralValidations: () => runStructuralValidations,
420
435
  safeUnion: () => safeUnion,
421
436
  status: () => status,
422
437
  timePeriodToDateRange: () => timePeriodToDateRange,
438
+ todayISO: () => todayISO,
423
439
  user: () => user,
424
440
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
425
441
  validate: () => validate,
@@ -705,7 +721,9 @@ var decodeScope = (query) => {
705
721
  };
706
722
  var DEFAULT_SCOPE_OPTIONS = {
707
723
  placeOfEvent: JurisdictionFilter.enum.all,
708
- accessLevel: JurisdictionFilter.enum.all
724
+ accessLevel: JurisdictionFilter.enum.all,
725
+ registeredIn: JurisdictionFilter.enum.all,
726
+ declaredIn: JurisdictionFilter.enum.all
709
727
  };
710
728
  function getAcceptedScopesByType({
711
729
  acceptedScopes,
@@ -1078,7 +1096,10 @@ var ActionConditional = z7.discriminatedUnion("type", [
1078
1096
  ShowConditional,
1079
1097
  // Action can be shown to the user in the list but as disabled
1080
1098
  EnableConditional
1081
- ]);
1099
+ ]).meta({
1100
+ id: "ActionConditional",
1101
+ 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."
1102
+ });
1082
1103
  var DisplayOnReviewConditional = z7.object({
1083
1104
  type: z7.literal(ConditionalType.DISPLAY_ON_REVIEW),
1084
1105
  conditional: Conditional
@@ -1093,8 +1114,8 @@ var FieldConditional = z7.discriminatedUnion("type", [
1093
1114
  // Field output can be shown / hidden on the review page
1094
1115
  DisplayOnReviewConditional
1095
1116
  ]).meta({
1096
- description: "Field conditional configuration",
1097
- id: "FieldConditional"
1117
+ id: "FieldConditional",
1118
+ 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."
1098
1119
  });
1099
1120
 
1100
1121
  // ../commons/src/events/FieldType.ts
@@ -1346,6 +1367,7 @@ var DateRangeFieldValue = z12.object({
1346
1367
  var EmailValue = z12.email();
1347
1368
  var CheckboxFieldValue = z12.boolean();
1348
1369
  var NumberFieldValue = z12.number();
1370
+ var SignatureFieldValue = FileFieldValue;
1349
1371
  var ButtonFieldValue = z12.number();
1350
1372
  var VerificationStatusValue = z12.enum([
1351
1373
  "verified",
@@ -1414,28 +1436,20 @@ function schemaPriority(schema) {
1414
1436
  return idx === -1 ? 9999 : idx;
1415
1437
  }
1416
1438
  function safeUnion(schemas) {
1439
+ const sortedSchemas = [...schemas].sort(
1440
+ (a, b) => schemaPriority(a) - schemaPriority(b)
1441
+ );
1417
1442
  return z12.any().superRefine((val, ctx) => {
1418
- const successful = schemas.filter((s) => s.safeParse(val).success);
1419
- if (successful.length === 1) {
1420
- return;
1421
- }
1422
- if (successful.length === 0) {
1423
- ctx.addIssue({
1424
- code: "invalid_type",
1425
- expected: "custom",
1426
- message: "Value does not match any schema"
1427
- });
1428
- return;
1429
- }
1430
- successful.sort((a, b) => schemaPriority(a) - schemaPriority(b));
1431
- const best = successful[0];
1432
- if (!best.safeParse(val).success) {
1433
- ctx.addIssue({
1434
- expected: "custom",
1435
- code: "invalid_type",
1436
- message: "Value did not match the best schema"
1437
- });
1443
+ for (const schema of sortedSchemas) {
1444
+ if (schema.safeParse(val).success) {
1445
+ return;
1446
+ }
1438
1447
  }
1448
+ ctx.addIssue({
1449
+ code: "invalid_type",
1450
+ expected: "custom",
1451
+ message: "Value does not match any schema"
1452
+ });
1439
1453
  }).meta({
1440
1454
  description: "Value that matches exactly one of the possible schema types (TextValue, DateValue, DateRangeFieldValue). The best matching schema is chosen by priority."
1441
1455
  });
@@ -1745,6 +1759,9 @@ var FlagConfig = z15.object({
1745
1759
  "Indicates if this flag expects an action to be performed to be cleared."
1746
1760
  ),
1747
1761
  label: TranslationConfig.describe("Human readable label of the flag.")
1762
+ }).meta({
1763
+ id: "FlagConfig",
1764
+ description: "Configuration for a custom flag that can be added to or removed from records by event actions."
1748
1765
  });
1749
1766
  var ActionFlagConfig = z15.object({
1750
1767
  id: Flag,
@@ -1752,6 +1769,9 @@ var ActionFlagConfig = z15.object({
1752
1769
  conditional: Conditional.optional().describe(
1753
1770
  "When conditional is met, the operation is performed on the flag. If not provided, the operation is performed unconditionally."
1754
1771
  )
1772
+ }).meta({
1773
+ id: "ActionFlagConfig",
1774
+ description: "Add or remove operation applied to a flag when the parent action is accepted. Optionally gated by a conditional."
1755
1775
  });
1756
1776
 
1757
1777
  // ../commons/src/events/EventMetadata.ts
@@ -1773,8 +1793,7 @@ var ActionCreationMetadata = z16.object({
1773
1793
  ),
1774
1794
  createdByUserType: z16.enum(["user", "system"]).nullish().describe("Whether the user is a normal user or a system."),
1775
1795
  acceptedAt: z16.iso.datetime().describe("Timestamp when the action request was accepted."),
1776
- createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation."),
1777
- createdBySignature: z16.string().nullish().describe("Signature of the user who created the action request.")
1796
+ createdByRole: z16.string().optional().describe("Role of the user at the time of action request creation.")
1778
1797
  });
1779
1798
  var RegistrationCreationMetadata = ActionCreationMetadata.extend({
1780
1799
  registrationNumber: z16.string().describe(
@@ -1802,9 +1821,6 @@ var EventMetadata = z16.object({
1802
1821
  createdAtLocation: UUID.nullish().describe(
1803
1822
  "Location of the user who created the event."
1804
1823
  ),
1805
- createdBySignature: DocumentPath.nullish().describe(
1806
- "Signature of the user who created the event."
1807
- ),
1808
1824
  updatedAtLocation: UUID.nullish().describe(
1809
1825
  "Location of the user who last changed the status."
1810
1826
  ),
@@ -2179,14 +2195,34 @@ var FieldId = import_v43.default.string().superRefine((val, ctx) => {
2179
2195
  }
2180
2196
  }).describe("Unique identifier for the field");
2181
2197
  var FieldReference = import_v43.default.object({
2182
- $$field: FieldId,
2198
+ $$field: FieldId.describe("Id of the field to reference"),
2183
2199
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2184
2200
  'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
2201
+ ),
2202
+ $$code: import_v43.default.string().optional().describe(
2203
+ "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
2185
2204
  )
2186
- }).describe("Reference to a field by its ID");
2205
+ }).describe(
2206
+ "Reference to a field value, with an optional client-side computation applied."
2207
+ );
2208
+ function isCodeToEvaluate(v) {
2209
+ return !!v && typeof v === "object" && "$$code" in v;
2210
+ }
2211
+ var ComputedDefaultValue = import_v43.default.object({
2212
+ $$code: import_v43.default.string().describe(
2213
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2214
+ )
2215
+ }).describe("A context-only computation used as a field default value.");
2187
2216
  var ValidationConfig = import_v43.default.object({
2188
- validator: Conditional,
2189
- message: TranslationConfig
2217
+ validator: Conditional.describe(
2218
+ "Conditional expression that must hold for the field value to be considered valid."
2219
+ ),
2220
+ message: TranslationConfig.describe(
2221
+ "Error message displayed when the validator does not hold."
2222
+ )
2223
+ }).meta({
2224
+ id: "ValidationConfig",
2225
+ 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."
2190
2226
  });
2191
2227
  var requiredSchema = import_v43.default.union([
2192
2228
  import_v43.default.boolean(),
@@ -2217,7 +2253,7 @@ var BaseField = import_v43.default.object({
2217
2253
  "Indicates whether the field can be modified during record correction."
2218
2254
  ),
2219
2255
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2220
- "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."
2256
+ "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."
2221
2257
  ),
2222
2258
  analytics: import_v43.default.boolean().default(false).optional().describe(
2223
2259
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2225,30 +2261,39 @@ var BaseField = import_v43.default.object({
2225
2261
  }).describe("Common properties shared across all field types.");
2226
2262
  var Divider = BaseField.extend({
2227
2263
  type: import_v43.default.literal(FieldType.DIVIDER)
2264
+ }).meta({
2265
+ description: "A horizontal line divider",
2266
+ id: "Divider"
2228
2267
  });
2229
2268
  var TextField = BaseField.extend({
2230
2269
  type: import_v43.default.literal(FieldType.TEXT),
2231
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2270
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2232
2271
  configuration: import_v43.default.object({
2233
2272
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2234
2273
  type: import_v43.default.enum(["text", "password"]).optional(),
2235
2274
  prefix: TranslationConfig.optional(),
2236
2275
  postfix: TranslationConfig.optional()
2237
2276
  }).default({ type: "text" }).optional()
2238
- }).describe("Text input");
2277
+ }).meta({
2278
+ description: "A text input field",
2279
+ id: "TextField"
2280
+ });
2239
2281
  var NumberField = BaseField.extend({
2240
2282
  type: import_v43.default.literal(FieldType.NUMBER),
2241
- defaultValue: NumberFieldValue.optional(),
2283
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2242
2284
  configuration: import_v43.default.object({
2243
2285
  min: import_v43.default.number().optional().describe("Minimum value"),
2244
2286
  max: import_v43.default.number().optional().describe("Maximum value"),
2245
2287
  prefix: TranslationConfig.optional(),
2246
2288
  postfix: TranslationConfig.optional()
2247
2289
  }).optional()
2248
- }).describe("Number input");
2290
+ }).meta({
2291
+ description: "A number input field",
2292
+ id: "NumberField"
2293
+ });
2249
2294
  var TextAreaField = BaseField.extend({
2250
2295
  type: import_v43.default.literal(FieldType.TEXTAREA),
2251
- defaultValue: NonEmptyTextValue.optional(),
2296
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2252
2297
  configuration: import_v43.default.object({
2253
2298
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2254
2299
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2256,7 +2301,10 @@ var TextAreaField = BaseField.extend({
2256
2301
  prefix: TranslationConfig.optional(),
2257
2302
  postfix: TranslationConfig.optional()
2258
2303
  }).default({ rows: 4 }).optional()
2259
- }).describe("Multiline text input");
2304
+ }).meta({
2305
+ description: "A multiline text input",
2306
+ id: "TextAreaField"
2307
+ });
2260
2308
  var ImageMimeType = import_v43.default.enum([
2261
2309
  "image/png",
2262
2310
  "image/jpg",
@@ -2279,58 +2327,76 @@ var SignatureField = BaseField.extend({
2279
2327
  signaturePromptLabel: TranslationConfig.describe(
2280
2328
  "Title of the signature modal"
2281
2329
  ),
2282
- defaultValue: FieldValue.optional(),
2330
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2283
2331
  configuration: import_v43.default.object({
2284
2332
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2285
2333
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
2286
2334
  }).default({
2287
2335
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2288
2336
  })
2289
- }).describe("Signature input field");
2337
+ }).meta({
2338
+ description: "A signature input field",
2339
+ id: "SignatureField"
2340
+ });
2290
2341
  var EmailField = BaseField.extend({
2291
2342
  type: import_v43.default.literal(FieldType.EMAIL),
2292
2343
  configuration: import_v43.default.object({
2293
2344
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2294
2345
  }).default({ maxLength: 255 }).optional(),
2295
- defaultValue: NonEmptyTextValue.optional()
2346
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2347
+ }).meta({
2348
+ description: "An email input field",
2349
+ id: "EmailField"
2296
2350
  });
2297
2351
  var DateField = BaseField.extend({
2298
2352
  type: import_v43.default.literal(FieldType.DATE),
2299
- defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
2353
+ defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
2300
2354
  configuration: import_v43.default.object({
2301
2355
  notice: TranslationConfig.describe(
2302
2356
  "Text to display above the date input"
2303
2357
  ).optional()
2304
2358
  }).optional()
2305
- }).describe("A single date input (yyyy-MM-dd)");
2359
+ }).meta({
2360
+ description: "A date input (yyyy-MM-dd)",
2361
+ id: "DateField"
2362
+ });
2306
2363
  var AgeField = BaseField.extend({
2307
2364
  type: import_v43.default.literal(FieldType.AGE),
2308
- defaultValue: NumberFieldValue.optional(),
2365
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2309
2366
  configuration: import_v43.default.object({
2310
2367
  asOfDate: FieldReference,
2311
2368
  prefix: TranslationConfig.optional(),
2312
2369
  postfix: TranslationConfig.optional()
2313
2370
  })
2314
- }).describe("An age input field which uses the current date as the asOfDate");
2371
+ }).meta({
2372
+ description: "An age input field which uses the current date as the asOfDate",
2373
+ id: "AgeField"
2374
+ });
2315
2375
  var TimeField = BaseField.extend({
2316
2376
  type: import_v43.default.literal(FieldType.TIME),
2317
- defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
2377
+ defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
2318
2378
  configuration: import_v43.default.object({
2319
2379
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2320
2380
  notice: TranslationConfig.describe(
2321
2381
  "Text to display above the time input"
2322
2382
  ).optional()
2323
2383
  }).optional()
2324
- }).describe("A single date input (HH-mm)");
2384
+ }).meta({
2385
+ description: "A single time input (HH-mm)",
2386
+ id: "TimeField"
2387
+ });
2325
2388
  var DateRangeField = BaseField.extend({
2326
2389
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2327
- defaultValue: DateRangeFieldValue.optional(),
2390
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2328
2391
  configuration: import_v43.default.object({
2329
2392
  notice: TranslationConfig.describe(
2330
2393
  "Text to display above the date input"
2331
2394
  ).optional()
2332
2395
  }).optional()
2333
- }).describe("A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })");
2396
+ }).meta({
2397
+ description: "A date range input ({ start: yyyy-MM-dd, end: yyyy-MM-dd })",
2398
+ id: "DateRangeField"
2399
+ });
2334
2400
  var HtmlFontVariant = import_v43.default.enum([
2335
2401
  "reg12",
2336
2402
  "reg14",
@@ -2374,21 +2440,33 @@ var ImageViewField = BaseField.extend({
2374
2440
  type: import_v43.default.literal(FieldType.IMAGE_VIEW),
2375
2441
  defaultValue: NonEmptyTextValue.optional(),
2376
2442
  configuration: ImageConfiguration
2377
- }).describe("A read-only image component for form pages");
2443
+ }).meta({
2444
+ description: "A read-only image component for form pages",
2445
+ id: "ImageViewField"
2446
+ });
2378
2447
  var Paragraph = BaseField.extend({
2379
2448
  type: import_v43.default.literal(FieldType.PARAGRAPH),
2380
2449
  configuration: ParagraphConfiguration
2381
- }).describe("A read-only HTML <p> paragraph");
2450
+ }).meta({
2451
+ description: "A read-only HTML <p> paragraph",
2452
+ id: "Paragraph"
2453
+ });
2382
2454
  var Heading = BaseField.extend({
2383
2455
  type: import_v43.default.literal(FieldType.HEADING),
2384
2456
  configuration: HeadingConfiguration
2385
- }).describe("A read-only heading component for form pages");
2457
+ }).meta({
2458
+ description: "A read-only heading component for form pages",
2459
+ id: "Heading"
2460
+ });
2386
2461
  var PageHeader = BaseField.extend({
2387
2462
  type: import_v43.default.literal(FieldType.PAGE_HEADER)
2388
- }).describe("A read-only header component for form pages");
2463
+ }).meta({
2464
+ description: "A read-only header component for form pages",
2465
+ id: "PageHeader"
2466
+ });
2389
2467
  var File = BaseField.extend({
2390
2468
  type: import_v43.default.literal(FieldType.FILE),
2391
- defaultValue: FileFieldValue.optional(),
2469
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2392
2470
  configuration: import_v43.default.object({
2393
2471
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2394
2472
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2404,7 +2482,10 @@ var File = BaseField.extend({
2404
2482
  }).default({
2405
2483
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2406
2484
  })
2407
- }).describe("File upload");
2485
+ }).meta({
2486
+ description: "A file upload field",
2487
+ id: "File"
2488
+ });
2408
2489
  var SelectOption = import_v43.default.object({
2409
2490
  value: import_v43.default.string().describe("The value of the option"),
2410
2491
  label: import_v43.default.union([import_v43.default.string(), TranslationConfig]).describe("The label of the option"),
@@ -2412,7 +2493,7 @@ var SelectOption = import_v43.default.object({
2412
2493
  });
2413
2494
  var NumberWithUnitField = BaseField.extend({
2414
2495
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2415
- defaultValue: NumberWithUnitFieldValue.optional(),
2496
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2416
2497
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2417
2498
  configuration: import_v43.default.object({
2418
2499
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2421,17 +2502,23 @@ var NumberWithUnitField = BaseField.extend({
2421
2502
  "Placeholder for the number field"
2422
2503
  )
2423
2504
  }).optional()
2424
- }).describe("Number with unit input");
2505
+ }).meta({
2506
+ description: "A number with unit input field",
2507
+ id: "NumberWithUnitField"
2508
+ });
2425
2509
  var RadioGroup = BaseField.extend({
2426
2510
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2427
- defaultValue: TextValue.optional(),
2511
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2428
2512
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2429
2513
  configuration: import_v43.default.object({
2430
2514
  styles: import_v43.default.object({
2431
2515
  size: import_v43.default.enum(["NORMAL", "LARGE"]).optional()
2432
2516
  }).optional()
2433
2517
  }).optional()
2434
- }).describe("Grouped radio options");
2518
+ }).meta({
2519
+ description: "A grouped radio button field",
2520
+ id: "RadioGroup"
2521
+ });
2435
2522
  var BulletList = BaseField.extend({
2436
2523
  type: import_v43.default.literal(FieldType.BULLET_LIST),
2437
2524
  items: import_v43.default.array(TranslationConfig).describe("A list of items"),
@@ -2440,10 +2527,13 @@ var BulletList = BaseField.extend({
2440
2527
  fontVariant: HtmlFontVariant.optional()
2441
2528
  }).optional()
2442
2529
  }).default({})
2443
- }).describe("A list of bullet points");
2530
+ }).meta({
2531
+ description: "A list of bullet points",
2532
+ id: "BulletList"
2533
+ });
2444
2534
  var Select = BaseField.extend({
2445
2535
  type: import_v43.default.literal(FieldType.SELECT),
2446
- defaultValue: TextValue.optional(),
2536
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2447
2537
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2448
2538
  noOptionsMessage: TranslationConfig.optional().describe(
2449
2539
  `
@@ -2455,16 +2545,22 @@ var Select = BaseField.extend({
2455
2545
  { ..., defaultMessage: "'{input}' is not listed among the health facilities." }
2456
2546
  `
2457
2547
  )
2458
- }).describe("Select input");
2548
+ }).meta({
2549
+ description: "A select input field",
2550
+ id: "Select"
2551
+ });
2459
2552
  var SelectDateRangeOption = import_v43.default.object({
2460
2553
  value: SelectDateRangeValue.describe("The value of the option"),
2461
2554
  label: TranslationConfig.describe("The label of the option")
2462
2555
  });
2463
2556
  var SelectDateRangeField = BaseField.extend({
2464
2557
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2465
- defaultValue: SelectDateRangeValue.optional(),
2558
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2466
2559
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2467
- }).describe("Select input with date range options");
2560
+ }).meta({
2561
+ description: "A date range selection field",
2562
+ id: "SelectDateRangeField"
2563
+ });
2468
2564
  var NameConfig = import_v43.default.object({
2469
2565
  firstname: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
2470
2566
  middlename: import_v43.default.object({ required: requiredSchema, label: TranslationConfig.optional() }).optional(),
@@ -2476,7 +2572,7 @@ var NameField = BaseField.extend({
2476
2572
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2477
2573
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2478
2574
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2479
- }).optional(),
2575
+ }).or(ComputedDefaultValue).optional(),
2480
2576
  configuration: import_v43.default.object({
2481
2577
  name: NameConfig.default({
2482
2578
  firstname: { required: true },
@@ -2495,26 +2591,41 @@ var NameField = BaseField.extend({
2495
2591
  surname: { required: true }
2496
2592
  }
2497
2593
  }).optional()
2498
- }).describe("Name input field");
2594
+ }).meta({
2595
+ description: "A field for entering a persons name",
2596
+ id: "NameField"
2597
+ });
2499
2598
  var PhoneField = BaseField.extend({
2500
- defaultValue: NonEmptyTextValue.optional(),
2599
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2501
2600
  type: import_v43.default.literal(FieldType.PHONE)
2502
- }).describe("Phone input field");
2601
+ }).meta({
2602
+ description: "A field for entering a phone number",
2603
+ id: "PhoneField"
2604
+ });
2503
2605
  var IdField = BaseField.extend({
2504
- defaultValue: NonEmptyTextValue.optional(),
2606
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2505
2607
  type: import_v43.default.literal(FieldType.ID)
2506
- }).describe("ID input field");
2608
+ }).meta({
2609
+ description: "A field for entering an ID",
2610
+ id: "IdField"
2611
+ });
2507
2612
  var Checkbox = BaseField.extend({
2508
2613
  type: import_v43.default.literal(FieldType.CHECKBOX),
2509
- defaultValue: CheckboxFieldValue.default(false)
2510
- }).describe("Boolean checkbox field");
2614
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2615
+ }).meta({
2616
+ description: "A boolean checkbox field",
2617
+ id: "Checkbox"
2618
+ });
2511
2619
  var Country = BaseField.extend({
2512
2620
  type: import_v43.default.literal(FieldType.COUNTRY),
2513
- defaultValue: NonEmptyTextValue.optional(),
2621
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2514
2622
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2515
2623
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2516
2624
  )
2517
- }).describe("Country select field");
2625
+ }).meta({
2626
+ description: "A field for selecting a country",
2627
+ id: "Country"
2628
+ });
2518
2629
  var AllowedLocations = JurisdictionReference.optional().describe(
2519
2630
  "Limits which location options are selectable depending on user jurisdiction and location."
2520
2631
  );
@@ -2523,28 +2634,33 @@ var AdministrativeAreas = import_v43.default.enum([
2523
2634
  "HEALTH_FACILITY",
2524
2635
  "CRVS_OFFICE"
2525
2636
  ]);
2526
- var AdministrativeAreaConfiguration = import_v43.default.object({
2527
- partOf: FieldReference.optional().describe("Parent location"),
2528
- type: AdministrativeAreas,
2529
- allowedLocations: AllowedLocations
2530
- }).describe("Administrative area options");
2531
2637
  var AdministrativeAreaField = BaseField.extend({
2532
2638
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2533
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2534
- configuration: AdministrativeAreaConfiguration
2535
- }).describe("Administrative area input field e.g. facility, office");
2639
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2640
+ configuration: import_v43.default.object({
2641
+ partOf: FieldReference.optional().describe("Parent location"),
2642
+ type: AdministrativeAreas,
2643
+ allowedLocations: AllowedLocations
2644
+ }).describe("Administrative area options")
2645
+ }).meta({
2646
+ description: "Administrative area input field",
2647
+ id: "AdministrativeAreaField"
2648
+ });
2536
2649
  var LocationInput = BaseField.extend({
2537
2650
  type: import_v43.default.literal(FieldType.LOCATION),
2538
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2651
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2539
2652
  configuration: import_v43.default.object({
2540
2653
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2541
2654
  allowedLocations: AllowedLocations
2542
2655
  }).optional()
2543
- }).describe("Input field for a location");
2656
+ }).meta({
2657
+ description: "A field for selecting a location",
2658
+ id: "LocationInput"
2659
+ });
2544
2660
  var FileUploadWithOptions = BaseField.extend({
2545
2661
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2546
2662
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2547
- defaultValue: FileFieldWithOptionValue.optional(),
2663
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2548
2664
  configuration: import_v43.default.object({
2549
2665
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2550
2666
  maxImageSize: import_v43.default.object({
@@ -2554,15 +2670,18 @@ var FileUploadWithOptions = BaseField.extend({
2554
2670
  }).default({
2555
2671
  maxFileSize: DEFAULT_MAX_FILE_SIZE_BYTES
2556
2672
  })
2673
+ }).meta({
2674
+ description: "A field for uploading files with file type options",
2675
+ id: "FileUploadWithOptions"
2557
2676
  });
2558
2677
  var Facility = BaseField.extend({
2559
2678
  type: import_v43.default.literal(FieldType.FACILITY),
2560
- defaultValue: NonEmptyTextValue.optional(),
2679
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2561
2680
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2562
2681
  }).describe("Input field for a facility");
2563
2682
  var Office = BaseField.extend({
2564
2683
  type: import_v43.default.literal(FieldType.OFFICE),
2565
- defaultValue: NonEmptyTextValue.optional(),
2684
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2566
2685
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2567
2686
  }).describe("Input field for an office");
2568
2687
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2598,8 +2717,11 @@ var Address = BaseField.extend({
2598
2717
  ).optional(),
2599
2718
  allowedLocations: AllowedLocations
2600
2719
  }).optional(),
2601
- defaultValue: DefaultAddressFieldValue.optional()
2602
- }).describe("Address input field \u2013 a combination of location and text fields");
2720
+ defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
2721
+ }).meta({
2722
+ description: "Address input field \u2013 a combination of location and text fields",
2723
+ id: "Address"
2724
+ });
2603
2725
  var StaticDataEntry = import_v43.default.object({
2604
2726
  id: import_v43.default.string().describe("ID for the data entry."),
2605
2727
  label: TranslationConfig,
@@ -2614,7 +2736,10 @@ var DataField = BaseField.extend({
2614
2736
  subtitle: TranslationConfig.optional(),
2615
2737
  data: import_v43.default.array(DataEntry)
2616
2738
  })
2617
- }).describe("Data field for displaying read-only data");
2739
+ }).meta({
2740
+ description: "A field for displaying a table of read-only data",
2741
+ id: "DataField"
2742
+ });
2618
2743
  var ButtonSize = import_v43.default.enum(["small", "medium", "large"]);
2619
2744
  var ButtonType = import_v43.default.enum([
2620
2745
  "primary",
@@ -2639,13 +2764,19 @@ var ButtonConfiguration = import_v43.default.object({
2639
2764
  });
2640
2765
  var ButtonField = BaseField.extend({
2641
2766
  type: import_v43.default.literal(FieldType.BUTTON),
2642
- defaultValue: ButtonFieldValue.optional(),
2767
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2643
2768
  configuration: ButtonConfiguration
2644
- }).describe("Generic button without any built-in functionality");
2769
+ }).meta({
2770
+ description: "A generic button that can be used to trigger an action",
2771
+ id: "ButtonField"
2772
+ });
2645
2773
  var FieldGroup = BaseField.extend({
2646
2774
  type: import_v43.default.literal(FieldType.FIELD_GROUP),
2647
2775
  // eslint-disable-next-line @typescript-eslint/no-use-before-define
2648
2776
  fields: import_v43.default.lazy(() => import_v43.default.array(FieldConfig))
2777
+ }).meta({
2778
+ description: "A group of fields that are displayed together",
2779
+ id: "FieldGroup"
2649
2780
  });
2650
2781
  var AlphaPrintButton = BaseField.extend({
2651
2782
  type: import_v43.default.literal(FieldType.ALPHA_PRINT_BUTTON),
@@ -2655,10 +2786,13 @@ var AlphaPrintButton = BaseField.extend({
2655
2786
  "Label for the print button"
2656
2787
  )
2657
2788
  })
2658
- }).describe("Print button field for printing certificates");
2789
+ }).meta({
2790
+ description: "An experimental print button field for printing certificates during the declaration process",
2791
+ id: "AlphaPrintButton"
2792
+ });
2659
2793
  var HttpField = BaseField.extend({
2660
2794
  type: import_v43.default.literal(FieldType.HTTP),
2661
- defaultValue: HttpFieldValue.optional(),
2795
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2662
2796
  configuration: import_v43.default.object({
2663
2797
  trigger: FieldReference.optional().describe(
2664
2798
  "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."
@@ -2671,20 +2805,30 @@ var HttpField = BaseField.extend({
2671
2805
  params: import_v43.default.record(import_v43.default.string(), import_v43.default.union([import_v43.default.string(), FieldReference])).optional(),
2672
2806
  timeout: import_v43.default.number().default(15e3).describe("Request timeout in milliseconds")
2673
2807
  })
2674
- }).describe("HTTP request function triggered by a button click or other event");
2808
+ }).meta({
2809
+ 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.",
2810
+ id: "HttpField"
2811
+ });
2675
2812
  var AutocompleteField = BaseField.extend({
2676
2813
  type: import_v43.default.literal(FieldType.AUTOCOMPLETE),
2677
2814
  configuration: import_v43.default.object({
2678
- url: import_v43.default.string().describe("URL to fetch autocomplete suggestions from").optional(),
2815
+ url: import_v43.default.string().describe(
2816
+ "URL to fetch autocomplete suggestions from. This should be a country config server endpoint."
2817
+ ).optional(),
2679
2818
  method: import_v43.default.enum(["GET", "POST"]).default("GET").optional(),
2680
2819
  defaultOptions: import_v43.default.array(
2681
2820
  import_v43.default.object({
2682
2821
  label: import_v43.default.string(),
2683
2822
  value: import_v43.default.string()
2684
2823
  })
2685
- ).optional()
2824
+ ).optional().describe(
2825
+ "Manual entry is supported through configuration, allowing users to provide values not currently represented in the dataset."
2826
+ )
2686
2827
  })
2687
- }).describe("Autocomplete input field");
2828
+ }).meta({
2829
+ 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.",
2830
+ id: "AutocompleteField"
2831
+ });
2688
2832
  var SearchField = HttpField.extend({
2689
2833
  type: import_v43.default.literal(FieldType.SEARCH),
2690
2834
  configuration: SearchQuery.pick({
@@ -2717,6 +2861,9 @@ var SearchField = HttpField.extend({
2717
2861
  ok: TranslationConfig.optional()
2718
2862
  }).optional()
2719
2863
  })
2864
+ }).meta({
2865
+ description: "A search input field",
2866
+ id: "SearchField"
2720
2867
  });
2721
2868
  var LinkButtonField = BaseField.extend({
2722
2869
  type: import_v43.default.literal(FieldType.LINK_BUTTON),
@@ -2725,28 +2872,35 @@ var LinkButtonField = BaseField.extend({
2725
2872
  text: TranslationConfig.describe("Text to display on the button"),
2726
2873
  icon: import_v43.default.string().optional().describe("Icon for the button. You can find icons from OpenCRVS UI-Kit.")
2727
2874
  })
2728
- }).describe("Button that opens a link");
2875
+ }).meta({
2876
+ description: "A button that opens a URL link",
2877
+ id: "LinkButtonField"
2878
+ });
2729
2879
  var VerificationStatus = BaseField.extend({
2730
2880
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2731
- defaultValue: VerificationStatusValue.optional(),
2881
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2732
2882
  configuration: import_v43.default.object({
2733
2883
  status: TranslationConfig.describe("Text to display on the status pill."),
2734
2884
  description: TranslationConfig.describe(
2735
2885
  "Explaining text on the banner in form."
2736
2886
  )
2737
2887
  })
2888
+ }).meta({
2889
+ 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.",
2890
+ id: "VerificationStatus"
2738
2891
  });
2739
2892
  var QueryParamReaderField = BaseField.extend({
2740
2893
  type: import_v43.default.literal(FieldType.QUERY_PARAM_READER),
2741
2894
  configuration: import_v43.default.object({
2742
2895
  pickParams: import_v43.default.array(import_v43.default.string()).describe("List of query parameters to read from the URL")
2743
2896
  })
2744
- }).describe(
2745
- "A field that maps URL query params into form values and clears them afterward"
2746
- );
2897
+ }).meta({
2898
+ description: "A field that maps URL query params into form values and clears them afterward",
2899
+ id: "QueryParamReaderField"
2900
+ });
2747
2901
  var QrReaderField = BaseField.extend({
2748
2902
  type: import_v43.default.literal(FieldType.QR_READER),
2749
- defaultValue: QrReaderFieldValue.optional(),
2903
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2750
2904
  configuration: import_v43.default.object({
2751
2905
  validator: import_v43.default.any().meta({
2752
2906
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2754,21 +2908,27 @@ var QrReaderField = BaseField.extend({
2754
2908
  })
2755
2909
  }).optional()
2756
2910
  }).meta({
2757
- description: "Configuration for QR code reader field, including optional JSON Schema validator.",
2911
+ description: "QR code reader field, including optional JSON Schema validator.",
2758
2912
  id: "QrReaderField"
2759
2913
  });
2760
2914
  var IdReaderField = BaseField.extend({
2761
2915
  type: import_v43.default.literal(FieldType.ID_READER),
2762
- defaultValue: IdReaderFieldValue.optional(),
2916
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2763
2917
  methods: import_v43.default.array(
2764
2918
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2765
2919
  )
2920
+ }).meta({
2921
+ description: "A wrapper around nested form fields, specifically QR_READER and LINK_BUTTON. It can hold the QR_READERs value.",
2922
+ id: "IdReaderField"
2766
2923
  });
2767
2924
  var CustomField = BaseField.extend({
2768
2925
  type: import_v43.default.literal(FieldType._EXPERIMENTAL_CUSTOM),
2769
2926
  defaultValue: CustomFieldValue.optional(),
2770
2927
  src: import_v43.default.string().describe("Module source path for the custom field component"),
2771
2928
  configuration: import_v43.default.unknown().optional()
2929
+ }).meta({
2930
+ description: "An expiremental custom field that is defined by a module source path",
2931
+ id: "CustomField"
2772
2932
  });
2773
2933
  var FieldStyleVariant = import_v43.default.enum(["default", "highlighted"]);
2774
2934
  var LoaderField = BaseField.extend({
@@ -2778,22 +2938,25 @@ var LoaderField = BaseField.extend({
2778
2938
  configuration: import_v43.default.object({
2779
2939
  text: TranslationConfig.describe("Display text above the loading spinner")
2780
2940
  })
2781
- }).describe(
2782
- "A non-interactive field that indicates an in progress operation in form"
2783
- );
2941
+ }).meta({
2942
+ description: "A non-interactive field that indicates an in progress operation in form",
2943
+ id: "LoaderField"
2944
+ });
2784
2945
  var HiddenField = BaseField.extend({
2785
2946
  type: import_v43.default.literal(FieldType.ALPHA_HIDDEN),
2786
2947
  required: import_v43.default.boolean().default(false).optional(),
2787
2948
  defaultValue: TextValue.optional()
2788
- }).describe(
2789
- "A non-interactive, hidden field that only hold a value in the form"
2790
- );
2949
+ }).meta({
2950
+ description: "A non-interactive, hidden field that only hold a value in the form",
2951
+ id: "HiddenField"
2952
+ });
2791
2953
  var UserRoleField = BaseField.extend({
2792
2954
  type: import_v43.default.literal(FieldType.USER_ROLE),
2793
2955
  defaultValue: TextValue.optional()
2794
- }).describe(
2795
- "A select dropdown that is automatically populated with available user roles"
2796
- );
2956
+ }).meta({
2957
+ description: "A select dropdown that is automatically populated with available user roles",
2958
+ id: "UserRoleField"
2959
+ });
2797
2960
  var FieldConfig = import_v43.default.discriminatedUnion("type", [
2798
2961
  FieldGroup,
2799
2962
  Address,
@@ -2892,16 +3055,19 @@ var VerificationPageConfig = FormPageConfig.extend({
2892
3055
  type: z21.literal(PageTypes.enum.VERIFICATION),
2893
3056
  actions: VerificationActionConfig
2894
3057
  });
2895
- var PageConfig = z21.discriminatedUnion("type", [
2896
- FormPageConfig,
2897
- VerificationPageConfig
2898
- ]);
3058
+ var PageConfig = z21.discriminatedUnion("type", [FormPageConfig, VerificationPageConfig]).meta({
3059
+ id: "PageConfig",
3060
+ 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."
3061
+ });
2899
3062
 
2900
3063
  // ../commons/src/events/FormConfig.ts
2901
3064
  var DeclarationFormConfig = z22.object({
2902
3065
  label: TranslationConfig.describe("Human readable description of the form"),
2903
3066
  pages: z22.array(FormPageConfig)
2904
- }).describe("Configuration of the declaration form.");
3067
+ }).meta({
3068
+ id: "DeclarationFormConfig",
3069
+ description: "Configuration of the declaration form."
3070
+ });
2905
3071
  var ActionFormConfig = z22.object({
2906
3072
  label: TranslationConfig.describe("Human readable description of the form"),
2907
3073
  pages: z22.array(PageConfig)
@@ -3001,6 +3167,9 @@ var DeduplicationConfig = z23.object({
3001
3167
  id: z23.string(),
3002
3168
  label: TranslationConfig,
3003
3169
  query: Clause
3170
+ }).meta({
3171
+ id: "DeduplicationConfig",
3172
+ 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."
3004
3173
  });
3005
3174
 
3006
3175
  // ../commons/src/events/ActionConfig.ts
@@ -3118,17 +3287,42 @@ var ActionConfig = z24.discriminatedUnion("type", [
3118
3287
  * OpenAPI references are defined here so our generated OpenAPI spec knows to reuse the models
3119
3288
  * and treat them as "models" instead of duplicating the data structure in each endpoint.
3120
3289
  */
3121
- ReadActionConfig.meta({ id: "ReadActionConfig" }),
3122
- DeclareConfig.meta({ id: "DeclareActionConfig" }),
3123
- RejectConfig.meta({ id: "RejectActionConfig" }),
3124
- RegisterConfig.meta({ id: "RegisterActionConfig" }),
3290
+ ReadActionConfig.meta({
3291
+ id: "ReadActionConfig",
3292
+ description: "Configuration for the read action \u2014 defines the record-tab content displayed on the event overview page."
3293
+ }),
3294
+ DeclareConfig.meta({
3295
+ id: "DeclareActionConfig",
3296
+ description: "Configuration for the declare action. Includes review-page fields. Shared with the notify action (ActionType.NOTIFY)."
3297
+ }),
3298
+ RejectConfig.meta({
3299
+ id: "RejectActionConfig",
3300
+ description: "Configuration for rejecting a record before registration."
3301
+ }),
3302
+ RegisterConfig.meta({
3303
+ id: "RegisterActionConfig",
3304
+ description: "Configuration for registering a record."
3305
+ }),
3125
3306
  PrintCertificateActionConfig.meta({
3126
- id: "PrintCertificateActionConfig"
3307
+ id: "PrintCertificateActionConfig",
3308
+ description: "Configuration for printing a certificate of a registered record."
3309
+ }),
3310
+ RequestCorrectionConfig.meta({
3311
+ id: "RequestCorrectionActionConfig",
3312
+ description: "Configuration for requesting a correction on a registered record."
3127
3313
  }),
3128
- RequestCorrectionConfig.meta({ id: "RequestCorrectionActionConfig" }),
3129
- EditActionConfig.meta({ id: "EditActionConfig" }),
3130
- ArchiveConfig.meta({ id: "ArchiveActionConfig" }),
3131
- CustomActionConfig.meta({ id: "CustomActionConfig" })
3314
+ EditActionConfig.meta({
3315
+ id: "EditActionConfig",
3316
+ description: "Configuration for editing a record before registration."
3317
+ }),
3318
+ ArchiveConfig.meta({
3319
+ id: "ArchiveActionConfig",
3320
+ description: "Configuration for archiving a record."
3321
+ }),
3322
+ CustomActionConfig.meta({
3323
+ id: "CustomActionConfig",
3324
+ description: "Configuration for a country-defined custom action. An event may include any number of these."
3325
+ })
3132
3326
  ]).describe(
3133
3327
  "Configuration of an action available for an event. Data collected depends on the action type and is accessible through the annotation property in ActionDocument."
3134
3328
  ).meta({ id: "ActionConfig" });
@@ -3204,7 +3398,10 @@ var Field = BaseField2.extend({
3204
3398
  }).describe("Custom field defined for the summary view.");
3205
3399
  var SummaryConfig = z27.object({
3206
3400
  fields: z27.array(z27.union([Field, ReferenceField])).describe("Fields displayed in the event summary view.")
3207
- }).describe("Configuration of the event summary section.");
3401
+ }).meta({
3402
+ id: "SummaryConfig",
3403
+ 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."
3404
+ });
3208
3405
 
3209
3406
  // ../commons/src/events/AdvancedSearchConfig.ts
3210
3407
  var z28 = __toESM(require("zod/v4"));
@@ -3328,6 +3525,9 @@ var AdvancedSearchField = z28.discriminatedUnion("fieldType", [FieldConfigSchema
3328
3525
  var AdvancedSearchConfig = z28.object({
3329
3526
  title: TranslationConfig.describe("Advanced search tab title"),
3330
3527
  fields: z28.array(AdvancedSearchField).describe("Advanced search fields within the tab.")
3528
+ }).meta({
3529
+ id: "AdvancedSearchConfig",
3530
+ 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()`)."
3331
3531
  });
3332
3532
 
3333
3533
  // ../commons/src/events/utils.ts
@@ -3731,7 +3931,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3731
3931
  }
3732
3932
  return current;
3733
3933
  }
3934
+ function todayISO() {
3935
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
3936
+ }
3937
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
3938
+ function compileClientFunction(code) {
3939
+ let fn = compiledFunctionCache.get(code);
3940
+ if (!fn) {
3941
+ fn = new Function(`return (${code})`)();
3942
+ compiledFunctionCache.set(code, fn);
3943
+ }
3944
+ return fn;
3945
+ }
3734
3946
  (0, import_ajv_formats.default)(ajv);
3947
+ function buildClientFunctionContext(input) {
3948
+ return {
3949
+ $form: input.form,
3950
+ $now: todayISO(),
3951
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
3952
+ $online: isOnline(),
3953
+ $user: input.validatorContext?.user,
3954
+ $event: input.validatorContext?.event,
3955
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
3956
+ user: input.systemVariables?.user,
3957
+ $window: input.systemVariables?.$window,
3958
+ locations: input.locations,
3959
+ adminLevelIds: input.adminLevelIds
3960
+ };
3961
+ }
3962
+ function runClientFunction(code, data, context) {
3963
+ return compileClientFunction(code)(data, context);
3964
+ }
3735
3965
  ajv.addKeyword({
3736
3966
  keyword: "daysFromDate",
3737
3967
  type: "string",
@@ -3776,7 +4006,7 @@ ajv.addKeyword({
3776
4006
  $data: true,
3777
4007
  errors: true,
3778
4008
  // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
3779
- validate(schema, data, _2, dataContext) {
4009
+ validate(_schema, data, _2, dataContext) {
3780
4010
  const locationIdInput = data;
3781
4011
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3782
4012
  return locations.some((location) => location.id === locationIdInput);
@@ -3804,6 +4034,26 @@ function precompileActionSchemas(eventConfigurations) {
3804
4034
  function isAgeValue(value) {
3805
4035
  return typeof value === "object" && value !== null && "age" in value && typeof value.age === "number";
3806
4036
  }
4037
+ function mergeWithBaseFormState(values, context) {
4038
+ return { ...context.baseFormState, ...values };
4039
+ }
4040
+ ajv.addKeyword({
4041
+ keyword: "customClientValidator",
4042
+ schemaType: "object",
4043
+ errors: true,
4044
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4045
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4046
+ // so the cast holds.
4047
+ validate(schema, data, _2, dataContext) {
4048
+ return Boolean(
4049
+ runClientFunction(
4050
+ schema.code,
4051
+ data,
4052
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4053
+ )
4054
+ );
4055
+ }
4056
+ });
3807
4057
  function validate(schema, data) {
3808
4058
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3809
4059
  if ("$form" in data) {
@@ -3840,17 +4090,14 @@ function isOnline() {
3840
4090
  }
3841
4091
  return true;
3842
4092
  }
3843
- function isConditionMet(conditional, values, context, eventIndex) {
3844
- return validate(conditional, {
3845
- $form: values,
3846
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3847
- $online: isOnline(),
3848
- $user: context.user,
3849
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3850
- $flags: eventIndex?.flags ?? [],
3851
- $status: eventIndex?.status,
3852
- $event: context.event
3853
- });
4093
+ function isConditionMet(conditional, values, context) {
4094
+ return validate(
4095
+ conditional,
4096
+ buildClientFunctionContext({
4097
+ form: mergeWithBaseFormState(values, context),
4098
+ validatorContext: context
4099
+ })
4100
+ );
3854
4101
  }
3855
4102
  function getConditionalActionsForField(field3, values) {
3856
4103
  if (!field3.conditionals) {
@@ -3858,9 +4105,9 @@ function getConditionalActionsForField(field3, values) {
3858
4105
  }
3859
4106
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
3860
4107
  }
3861
- function areConditionsMet(conditions, values, context, event2) {
4108
+ function areConditionsMet(conditions, values, context, _event) {
3862
4109
  return conditions.every(
3863
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4110
+ (condition) => isConditionMet(condition.conditional, values, context)
3864
4111
  );
3865
4112
  }
3866
4113
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -3870,14 +4117,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
3870
4117
  if (!hasRule) {
3871
4118
  return true;
3872
4119
  }
3873
- const validConditionals = getConditionalActionsForField(field3, {
3874
- $form: form,
3875
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
3876
- $online: isOnline(),
3877
- $user: context.user,
3878
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
3879
- $event: context.event
3880
- });
4120
+ const validConditionals = getConditionalActionsForField(
4121
+ field3,
4122
+ buildClientFunctionContext({
4123
+ form: mergeWithBaseFormState(form, context),
4124
+ validatorContext: context
4125
+ })
4126
+ );
3881
4127
  return validConditionals.includes(conditionalType);
3882
4128
  }
3883
4129
  function isFieldVisible(field3, form, context) {
@@ -3903,7 +4149,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
3903
4149
  if (!rule) {
3904
4150
  return true;
3905
4151
  }
3906
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4152
+ return validate(rule.conditional, {
4153
+ ...buildClientFunctionContext({
4154
+ form: mergeWithBaseFormState(event2.declaration, context),
4155
+ validatorContext: context
4156
+ }),
4157
+ $flags: event2.flags,
4158
+ $status: event2.status
4159
+ });
3907
4160
  }
3908
4161
  function isActionEnabled(actionConfig, event2, context) {
3909
4162
  return isActionConditionMet(
@@ -4062,19 +4315,10 @@ function runFieldValidations({
4062
4315
  if (!isFieldVisible(field3.config, form, context)) {
4063
4316
  return [];
4064
4317
  }
4065
- const conditionalParameters = {
4066
- $form: form,
4067
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4068
- /**
4069
- * In real use cases, there can be hundreds of thousands of locations.
4070
- * Make sure that the context contains only the locations that are needed for validation.
4071
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4072
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4073
- */
4074
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4075
- $online: isOnline(),
4076
- $user: context.user
4077
- };
4318
+ const conditionalParameters = buildClientFunctionContext({
4319
+ form: mergeWithBaseFormState(form, context),
4320
+ validatorContext: context
4321
+ });
4078
4322
  if (isFieldGroupFieldType(field3)) {
4079
4323
  const subfieldErrors = buildFormState(
4080
4324
  field3.config.fields,
@@ -4307,17 +4551,16 @@ function isPageVisible(page, formValues, context) {
4307
4551
  }
4308
4552
  return isConditionMet(page.conditional, formValues, context);
4309
4553
  }
4310
- function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false, declarationContext) {
4554
+ function omitHiddenFields(fields, formValues, validatorContext, includeHiddenFieldsWithNullValues = false) {
4311
4555
  const base = (0, import_lodash.cloneDeep)(formValues);
4312
4556
  function fn(prevVisibilityContext) {
4313
- const visibilityForm = declarationContext ? { ...declarationContext, ...prevVisibilityContext } : prevVisibilityContext;
4314
4557
  const cleaned = (0, import_lodash.omitBy)(base, (value, fieldId) => {
4315
4558
  const fieldConfig = fields.filter((f) => f.id === fieldId);
4316
4559
  if (!fieldConfig.length) {
4317
4560
  return false;
4318
4561
  }
4319
4562
  const isHidden = fieldConfig.every(
4320
- (f) => !isFieldVisible(f, visibilityForm, validatorContext)
4563
+ (f) => !isFieldVisible(f, prevVisibilityContext, validatorContext)
4321
4564
  );
4322
4565
  if (!isHidden) {
4323
4566
  return false;
@@ -4335,7 +4578,7 @@ function omitHiddenPaginatedFields(formConfig, values, validatorContext, include
4335
4578
  const visibleFields = formConfig.pages.filter((p) => isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4336
4579
  const hiddenFields = formConfig.pages.filter((p) => !isPageVisible(p, values, validatorContext)).flatMap((p) => p.fields);
4337
4580
  const valuesExceptHiddenPage = (0, import_lodash.omitBy)(values, (_2, fieldId) => {
4338
- return hiddenFields.some((f) => f.id === fieldId);
4581
+ return hiddenFields.some((f) => f.id === fieldId) && !visibleFields.some((f) => f.id === fieldId);
4339
4582
  });
4340
4583
  return omitHiddenFields(
4341
4584
  visibleFields,
@@ -4382,13 +4625,10 @@ function getVisibleVerificationPageIds(pages, annotation, context) {
4382
4625
  }
4383
4626
  function omitHiddenAnnotationFields(actionConfig, declaration, annotation, context) {
4384
4627
  const annotationFields = getActionAnnotationFields(actionConfig);
4385
- return omitHiddenFields(
4386
- annotationFields,
4387
- annotation,
4388
- context,
4389
- false,
4390
- declaration
4391
- );
4628
+ return omitHiddenFields(annotationFields, annotation, {
4629
+ ...context,
4630
+ baseFormState: declaration
4631
+ });
4392
4632
  }
4393
4633
  function deepMerge(currentDocument, actionDocument) {
4394
4634
  const currentDocumentClone = (0, import_lodash.cloneDeep)(currentDocument);
@@ -4562,19 +4802,16 @@ function getPendingAction(actions) {
4562
4802
  }
4563
4803
  return pendingActions[0];
4564
4804
  }
4565
- function getCompleteActionAnnotation(annotation, event2, action) {
4805
+ function getCompleteActionAnnotation(event2, action) {
4566
4806
  if (action.originalActionId) {
4567
4807
  const originalAction = event2.actions.find(
4568
4808
  ({ id }) => id === action.originalActionId
4569
4809
  );
4570
4810
  if (originalAction?.status === ActionStatus.Requested) {
4571
- return deepMerge(
4572
- deepMerge(annotation, originalAction.annotation ?? {}),
4573
- action.annotation ?? {}
4574
- );
4811
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4575
4812
  }
4576
4813
  }
4577
- return deepMerge(annotation, action.annotation ?? {});
4814
+ return action.annotation ?? {};
4578
4815
  }
4579
4816
  function getCompleteActionDeclaration(declaration, event2, action) {
4580
4817
  if (action.originalActionId) {
@@ -4594,7 +4831,7 @@ function getAcceptedActions(event2) {
4594
4831
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4595
4832
  ...action,
4596
4833
  declaration: getCompleteActionDeclaration({}, event2, action),
4597
- annotation: getCompleteActionAnnotation({}, event2, action)
4834
+ annotation: getCompleteActionAnnotation(event2, action)
4598
4835
  }));
4599
4836
  }
4600
4837
  var EXCLUDED_ACTIONS = [
@@ -4682,6 +4919,9 @@ function not(condition) {
4682
4919
  function never2() {
4683
4920
  return not(alwaysTrue());
4684
4921
  }
4922
+ function always() {
4923
+ return defineConditional(alwaysTrue());
4924
+ }
4685
4925
  function jsonFieldPath(field3) {
4686
4926
  return [field3.$$field, ...field3.$$subfield].join("/");
4687
4927
  }
@@ -5229,7 +5469,54 @@ function createFieldConditionals(fieldId) {
5229
5469
  }
5230
5470
  },
5231
5471
  required: [fieldId]
5232
- })
5472
+ }),
5473
+ /**
5474
+ * Custom client-side validator. The provided function is serialised and executed
5475
+ * just-in-time on the client only. External references (e.g. lodash) are not
5476
+ * available inside the function body — all logic must be self-contained.
5477
+ *
5478
+ * @example
5479
+ * field('nid').customClientValidator((value) => {
5480
+ * // LUHN check — all logic must be inline
5481
+ * const digits = String(value).split('').map(Number)
5482
+ * // ...
5483
+ * return isValid
5484
+ * })
5485
+ */
5486
+ customClientValidator(validationFn) {
5487
+ const code = validationFn.toString();
5488
+ return defineFormConditional({
5489
+ type: "object",
5490
+ properties: wrapToPath(
5491
+ { [fieldId]: { customClientValidator: { code } } },
5492
+ this.$$subfield
5493
+ ),
5494
+ required: [fieldId]
5495
+ });
5496
+ },
5497
+ /**
5498
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5499
+ * that can be used as the `value` property or a DATA component entry.
5500
+ * The function receives the referenced field's value as the first argument and
5501
+ * the full form context as the second; its return value replaces the field reference.
5502
+ * The function is serialised and executed just-in-time on the client only.
5503
+ * External references (e.g. lodash) are not available inside the function body.
5504
+ *
5505
+ * For computing a default value without referencing a specific field, use
5506
+ * `evaluate(fn)` in the `defaultValue` property instead.
5507
+ *
5508
+ * @example
5509
+ * field('a').customClientEvaluation((aValue, ctx) =>
5510
+ * Number(aValue) + Number(ctx.$form.b)
5511
+ * )
5512
+ */
5513
+ customClientEvaluation(computationFn) {
5514
+ return {
5515
+ $$code: computationFn.toString(),
5516
+ $$field: fieldId,
5517
+ $$subfield: this.$$subfield
5518
+ };
5519
+ }
5233
5520
  };
5234
5521
  }
5235
5522
 
@@ -5377,7 +5664,7 @@ var _EventConfigBase = z33.object({
5377
5664
  ),
5378
5665
  label: TranslationConfig.describe("Human-readable label for the event type."),
5379
5666
  actions: z33.array(ActionConfig).describe(
5380
- "Configuration of system-defined actions associated with the event."
5667
+ "Configuration of core and custom actions associated with the event."
5381
5668
  ),
5382
5669
  actionOrder: z33.array(z33.string()).optional().describe(
5383
5670
  "Order of actions in the action menu. Use either the action type for core actions or the customActionType for custom actions."
@@ -5389,7 +5676,7 @@ var _EventConfigBase = z33.object({
5389
5676
  "Configuration of fields available in the advanced search feature."
5390
5677
  ),
5391
5678
  flags: z33.array(FlagConfig).optional().default([]).describe(
5392
- "Configuration of flags associated with the actions of this event type."
5679
+ "Configuration of custom flags associated with the actions of this event type."
5393
5680
  ),
5394
5681
  analytics: z33.boolean().optional().default(true).describe(
5395
5682
  "Indicates whether the records of this event type are included in analytics"
@@ -5402,8 +5689,9 @@ var EventConfig = _EventConfigBase.superRefine((event2, ctx) => {
5402
5689
  validateActionFlags(event2, ctx);
5403
5690
  validateActionOrder(event2, ctx);
5404
5691
  }).meta({
5405
- id: "EventConfig"
5406
- }).describe("Configuration defining an event type.");
5692
+ id: "EventConfig",
5693
+ description: "Configuration defining an event type registered in OpenCRVS (for example birth or death)."
5694
+ });
5407
5695
 
5408
5696
  // ../commons/src/events/EventConfigInput.ts
5409
5697
  var defineDeclarationForm = (form) => DeclarationFormConfig.parse(form);
@@ -5626,6 +5914,9 @@ var WorkqueueColumnValue = z34.object({
5626
5914
  var WorkqueueColumn = z34.object({
5627
5915
  label: TranslationConfig,
5628
5916
  value: WorkqueueColumnValue
5917
+ }).meta({
5918
+ id: "WorkqueueColumn",
5919
+ description: "Configuration for a single workqueue column. The value references an event metadata key (e.g. `dateOfEvent`, `status`, `trackingId`)."
5629
5920
  });
5630
5921
  function defineWorkqueuesColumns(workqueueColumns) {
5631
5922
  return workqueueColumns.map(
@@ -5828,18 +6119,11 @@ var WorkqueueConfigWithoutQuery = WorkqueueConfig.omit({
5828
6119
  query: true,
5829
6120
  columns: true
5830
6121
  });
5831
- var WorkqueueConfigInput = z37.object({
5832
- slug: z37.string().describe("Determines the url of the workqueue."),
5833
- name: TranslationConfig.describe(
5834
- "Title of the workflow (both in navigation and on the page)"
5835
- ),
5836
- query: CountryConfigQueryInputType,
5837
- action: z37.object({ type: WorkqueueActionType }).optional().describe(
5838
- "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."
5839
- ),
5840
- columns: z37.array(WorkqueueColumn).default(mandatoryColumns),
5841
- icon: AvailableIcons,
5842
- emptyMessage: TranslationConfig.optional()
6122
+ var WorkqueueConfigInput = WorkqueueConfig.extend({
6123
+ query: CountryConfigQueryInputType
6124
+ }).meta({
6125
+ id: "WorkqueueConfig",
6126
+ 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."
5843
6127
  });
5844
6128
  function defineWorkqueue(workqueueInput) {
5845
6129
  const queryInput = workqueueInput.query;
@@ -5900,6 +6184,11 @@ var BaseActionInput = z38.object({
5900
6184
  originalActionId: UUID.optional(),
5901
6185
  // should not be part of base action.
5902
6186
  keepAssignment: z38.boolean().optional(),
6187
+ keepAssignmentIfAccepted: z38.boolean().optional(),
6188
+ keepAssignmentIfRejected: z38.boolean().optional(),
6189
+ waitFor: z38.boolean().default(true).describe(
6190
+ "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."
6191
+ ),
5903
6192
  // For normal users, the createdAtLocation is resolved on the backend from the user's primaryOfficeId.
5904
6193
  // @TODO: createdAtLocation should be limited to actions that system users can perform. For normal users, it should not be part of the base action.
5905
6194
  createdAtLocation: UUID.nullish().describe(
@@ -6079,7 +6368,7 @@ var Draft = z39.object({
6079
6368
  }).describe(
6080
6369
  "A temporary storage for an action. Stored with details of the event, creator and creation time."
6081
6370
  );
6082
- var DraftInput = BaseActionInput.extend({
6371
+ var DraftInput = BaseActionInput.omit({ waitFor: true }).extend({
6083
6372
  type: ActionTypes.exclude([ActionTypes.enum.DELETE]),
6084
6373
  status: z39.enum([
6085
6374
  ActionStatus.Requested,
@@ -6153,7 +6442,6 @@ function getDeclarationActionCreationMetadata(actionType, actions) {
6153
6442
  createdAtLocation: requestAction?.createdAtLocation ?? acceptAction.createdAtLocation,
6154
6443
  acceptedAt: acceptAction.createdAt,
6155
6444
  createdByRole: requestAction?.createdByRole ?? acceptAction.createdByRole,
6156
- createdBySignature: requestAction?.createdBySignature ?? acceptAction.createdBySignature,
6157
6445
  registrationNumber
6158
6446
  };
6159
6447
  }
@@ -6211,26 +6499,43 @@ var import_date_fns3 = require("date-fns");
6211
6499
  function isEditInProgress(actions) {
6212
6500
  return actions.at(-1)?.type === ActionType.EDIT;
6213
6501
  }
6502
+ function findPendingCorrectionAction(writeActions2) {
6503
+ let correctionRequestAction;
6504
+ for (let i = writeActions2.length - 1; i >= 0; i--) {
6505
+ const action = writeActions2[i];
6506
+ if (action.type === ActionType.APPROVE_CORRECTION || action.type === ActionType.REJECT_CORRECTION) {
6507
+ break;
6508
+ }
6509
+ if (action.type === ActionType.REQUEST_CORRECTION) {
6510
+ correctionRequestAction = action;
6511
+ break;
6512
+ }
6513
+ }
6514
+ return correctionRequestAction;
6515
+ }
6214
6516
  function isCorrectionRequested(actions) {
6517
+ return findPendingCorrectionAction(actions) !== void 0;
6518
+ }
6519
+ function isDeclarationIncomplete(actions) {
6520
+ return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6521
+ }
6522
+ function isRejected(actions) {
6523
+ const resettingActionTypes = [
6524
+ ActionType.NOTIFY,
6525
+ ActionType.DECLARE,
6526
+ ActionType.EDIT,
6527
+ ActionType.REGISTER
6528
+ ];
6215
6529
  return actions.reduce((prev, { type }) => {
6216
- if (type === ActionType.REQUEST_CORRECTION) {
6530
+ if (type === ActionType.REJECT) {
6217
6531
  return true;
6218
6532
  }
6219
- if (type === ActionType.APPROVE_CORRECTION) {
6220
- return false;
6221
- }
6222
- if (type === ActionType.REJECT_CORRECTION) {
6533
+ if (resettingActionTypes.includes(type)) {
6223
6534
  return false;
6224
6535
  }
6225
6536
  return prev;
6226
6537
  }, false);
6227
6538
  }
6228
- function isDeclarationIncomplete(actions) {
6229
- return getStatusFromActions(actions) === EventStatus.enum.NOTIFIED;
6230
- }
6231
- function isRejected(actions) {
6232
- return actions.at(-1)?.type === ActionType.REJECT;
6233
- }
6234
6539
  function isPotentialDuplicate(actions) {
6235
6540
  return actions.reduce((prev, { type }) => {
6236
6541
  if (type === ActionType.DUPLICATE_DETECTED) {
@@ -6293,8 +6598,7 @@ function resolveEventCustomFlags(event2, eventConfiguration) {
6293
6598
  return (0, import_lodash3.uniq)(flags);
6294
6599
  }, []);
6295
6600
  }
6296
- function getEventFlags(event2, config) {
6297
- const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6601
+ function getActionStatusFlags(sortedActions) {
6298
6602
  const actionStatus = sortedActions.reduce(
6299
6603
  (actionStatuses, { type, status: status2 }) => ({
6300
6604
  ...actionStatuses,
@@ -6302,26 +6606,40 @@ function getEventFlags(event2, config) {
6302
6606
  }),
6303
6607
  {}
6304
6608
  );
6305
- const flags = Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6609
+ return Object.entries(actionStatus).filter(([, status2]) => status2 !== ActionStatus.Accepted).map(([type, status2]) => {
6306
6610
  const flag2 = joinValues([type, status2], ":").toLowerCase();
6307
6611
  return flag2;
6308
6612
  });
6309
- if (isCorrectionRequested(sortedActions)) {
6310
- flags.push(InherentFlags.CORRECTION_REQUESTED);
6613
+ }
6614
+ function getInherentFlags(sortedActions) {
6615
+ const acceptedActions = sortedActions.filter(
6616
+ ({ status: status2 }) => status2 === ActionStatus.Accepted
6617
+ );
6618
+ const inherentFlags = [];
6619
+ if (isCorrectionRequested(acceptedActions)) {
6620
+ inherentFlags.push(InherentFlags.CORRECTION_REQUESTED);
6311
6621
  }
6312
- if (isDeclarationIncomplete(sortedActions)) {
6313
- flags.push(InherentFlags.INCOMPLETE);
6622
+ if (isDeclarationIncomplete(acceptedActions)) {
6623
+ inherentFlags.push(InherentFlags.INCOMPLETE);
6314
6624
  }
6315
- if (isRejected(sortedActions)) {
6316
- flags.push(InherentFlags.REJECTED);
6625
+ if (isRejected(acceptedActions)) {
6626
+ inherentFlags.push(InherentFlags.REJECTED);
6317
6627
  }
6318
- if (isPotentialDuplicate(sortedActions)) {
6319
- flags.push(InherentFlags.POTENTIAL_DUPLICATE);
6628
+ if (isPotentialDuplicate(acceptedActions)) {
6629
+ inherentFlags.push(InherentFlags.POTENTIAL_DUPLICATE);
6320
6630
  }
6321
- if (isEditInProgress(sortedActions)) {
6322
- flags.push(InherentFlags.EDIT_IN_PROGRESS);
6631
+ if (isEditInProgress(acceptedActions)) {
6632
+ inherentFlags.push(InherentFlags.EDIT_IN_PROGRESS);
6323
6633
  }
6324
- return [...flags, ...resolveEventCustomFlags(event2, config)];
6634
+ return inherentFlags;
6635
+ }
6636
+ function getEventFlags(event2, config) {
6637
+ const sortedActions = event2.actions.filter(({ type }) => !isMetaAction(type)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
6638
+ return [
6639
+ ...getActionStatusFlags(sortedActions),
6640
+ ...getInherentFlags(sortedActions),
6641
+ ...resolveEventCustomFlags(event2, config)
6642
+ ];
6325
6643
  }
6326
6644
 
6327
6645
  // ../commons/src/events/state/index.ts
@@ -6367,17 +6685,6 @@ function getAssignedUserFromActions(actions) {
6367
6685
  return user2;
6368
6686
  }, null);
6369
6687
  }
6370
- function getAssignedUserSignatureFromActions(actions) {
6371
- return actions.reduce((signature, action) => {
6372
- if (action.type === ActionType.ASSIGN) {
6373
- return action.createdBySignature || null;
6374
- }
6375
- if (action.type === ActionType.UNASSIGN) {
6376
- return null;
6377
- }
6378
- return signature;
6379
- }, null);
6380
- }
6381
6688
  function deepDropNulls(obj) {
6382
6689
  if (Array.isArray(obj)) {
6383
6690
  return obj.map(deepDropNulls);
@@ -6473,10 +6780,8 @@ function getCurrentEventState(event2, config) {
6473
6780
  createdBy: creationAction.createdBy,
6474
6781
  createdByUserType: creationAction.createdByUserType,
6475
6782
  createdAtLocation: creationAction.createdAtLocation,
6476
- createdBySignature: creationAction.createdBySignature,
6477
6783
  updatedAt: acceptedActionMetadata.createdAt,
6478
6784
  assignedTo: getAssignedUserFromActions(acceptedActions),
6479
- assignedToSignature: getAssignedUserSignatureFromActions(acceptedActions),
6480
6785
  updatedBy: requestActionMetadata.createdBy,
6481
6786
  updatedAtLocation: requestActionMetadata.createdAtLocation,
6482
6787
  declaration,
@@ -6569,7 +6874,7 @@ function getActionAnnotation({
6569
6874
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6570
6875
  const actionWithCompleteAnnotation = action && {
6571
6876
  ...action,
6572
- annotation: getCompleteActionAnnotation({}, event2, action)
6877
+ annotation: getCompleteActionAnnotation(event2, action)
6573
6878
  };
6574
6879
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6575
6880
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6641,6 +6946,9 @@ function createFieldConfig(fieldId, options) {
6641
6946
  }
6642
6947
 
6643
6948
  // ../commons/src/events/field.ts
6949
+ function evaluate(computationFn) {
6950
+ return { $$code: computationFn.toString() };
6951
+ }
6644
6952
  function field(fieldId, options = {}) {
6645
6953
  return {
6646
6954
  ...createFieldConditionals(fieldId),
@@ -9735,7 +10043,6 @@ var eventQueryDataGenerator = (overrides = {}, seed = 1) => {
9735
10043
  createdBy: overrides.createdBy ?? generateUuid(rng),
9736
10044
  createdAtLocation: overrides.createdAtLocation ?? generateUuid(rng),
9737
10045
  updatedAtLocation: overrides.updatedAtLocation ?? generateUuid(rng),
9738
- createdBySignature: overrides.createdBySignature ?? generateRandomSignature(rng),
9739
10046
  updatedAt: overrides.updatedAt ?? (0, import_date_fns4.addDays)(new Date(createdAt), 1).toISOString(),
9740
10047
  assignedTo: overrides.assignedTo ?? null,
9741
10048
  updatedBy: overrides.updatedBy ?? generateUuid(rng),
@@ -10334,3 +10641,366 @@ function getFilePathsFromEvent(event2) {
10334
10641
  });
10335
10642
  return (0, import_lodash7.uniq)(filepaths);
10336
10643
  }
10644
+
10645
+ // ../commons/src/events/mocks.test.utils.ts
10646
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS = [
10647
+ {
10648
+ id: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10649
+ name: "Central",
10650
+ parentId: null,
10651
+ validUntil: null,
10652
+ externalId: "ydyJb1RAy4U1"
10653
+ },
10654
+ {
10655
+ id: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10656
+ name: "Sulaka",
10657
+ parentId: null,
10658
+ validUntil: null,
10659
+ externalId: "pQ8nGxWmZ2Q3"
10660
+ },
10661
+ {
10662
+ id: "7ef2b9c7-5e6d-49f6-ae05-656207d0fc64",
10663
+ name: "Pualula",
10664
+ parentId: null,
10665
+ validUntil: null,
10666
+ externalId: "Aq91DweLmT8k"
10667
+ },
10668
+ {
10669
+ id: "6d1a59df-988c-4021-a846-ccbc021931a7",
10670
+ name: "Chuminga",
10671
+ parentId: null,
10672
+ validUntil: null,
10673
+ externalId: "Rw0fYNh2Xk9a"
10674
+ },
10675
+ {
10676
+ id: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10677
+ name: "Ibombo",
10678
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10679
+ validUntil: null,
10680
+ externalId: "k7DsP4vbN1Qe"
10681
+ },
10682
+ {
10683
+ id: "27160bbd-32d1-4625-812f-860226bfb92a",
10684
+ name: "Isango",
10685
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10686
+ validUntil: null,
10687
+ externalId: "Gm3Z9eQpHw4L"
10688
+ },
10689
+ {
10690
+ id: "967032fd-3f81-478a-826c-30cb8fe121bd",
10691
+ name: "Isamba",
10692
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10693
+ validUntil: null,
10694
+ externalId: "sT0xVu1KqJ7r"
10695
+ },
10696
+ {
10697
+ id: "89a33893-b17d-481d-a26d-6461e7ac1651",
10698
+ name: "Itambo",
10699
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10700
+ validUntil: null,
10701
+ externalId: "Nq6Bv2HpL9Te"
10702
+ },
10703
+ {
10704
+ id: "d42ab2fe-e7ed-470e-8b31-4fb27f9b8250",
10705
+ name: "Ezhi",
10706
+ parentId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10707
+ validUntil: null,
10708
+ externalId: "xK8cQ0ZRy5Wd"
10709
+ },
10710
+ {
10711
+ id: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10712
+ name: "Ilanga",
10713
+ parentId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10714
+ validUntil: null,
10715
+ externalId: "Cq4Jm1XvN8Ls"
10716
+ },
10717
+ // Villages under Ibombo (62a0ccb4-880d-4f30-8882-f256007dfff9)
10718
+ {
10719
+ id: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10720
+ name: "Klow",
10721
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10722
+ validUntil: null,
10723
+ externalId: "IkYcYBUcyY2"
10724
+ },
10725
+ {
10726
+ id: "2e5f6a7b-8c9d-4a23-8fab-456789012345",
10727
+ name: "Mbondo",
10728
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10729
+ validUntil: null,
10730
+ externalId: "Qhvv5hvo3mY"
10731
+ },
10732
+ {
10733
+ id: "3f6a7b8c-9d0e-4b34-8abc-567890123456",
10734
+ name: "Ndara",
10735
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10736
+ validUntil: null,
10737
+ externalId: "crXh068O9TR"
10738
+ },
10739
+ {
10740
+ id: "4a7b8c9d-0e1f-4c45-abcd-678901234567",
10741
+ name: "Olani",
10742
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10743
+ validUntil: null,
10744
+ externalId: "r00It8Tvvp7"
10745
+ },
10746
+ {
10747
+ id: "5b8c9d0e-1f2a-4d56-bcde-789012345678",
10748
+ name: "Pemba",
10749
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10750
+ validUntil: null,
10751
+ externalId: "ZnUWsbONIaH"
10752
+ },
10753
+ {
10754
+ id: "6c9d0e1f-2a3b-4e67-8def-890123456789",
10755
+ name: "Quanza",
10756
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10757
+ validUntil: null,
10758
+ externalId: "fDZycvQTa7l"
10759
+ },
10760
+ {
10761
+ id: "7d0e1f2a-3b4c-4f78-8efa-901234567890",
10762
+ name: "Rivka",
10763
+ parentId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10764
+ validUntil: null,
10765
+ externalId: "KqswxCGTELa"
10766
+ },
10767
+ // Villages under Isamba (967032fd-3f81-478a-826c-30cb8fe121bd)
10768
+ {
10769
+ id: "8e1f2a3b-4c5d-4089-8fab-012345678901",
10770
+ name: "Mbula",
10771
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10772
+ validUntil: null,
10773
+ externalId: "osEbKjRc9Kg"
10774
+ },
10775
+ {
10776
+ id: "9f2a3b4c-5d6e-4190-8abf-123456789012",
10777
+ name: "Ndoki",
10778
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10779
+ validUntil: null,
10780
+ externalId: "aq4daBUAGr3"
10781
+ },
10782
+ {
10783
+ id: "0a3b4c5d-6e7f-4201-abcd-234567890123",
10784
+ name: "Tsanga",
10785
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10786
+ validUntil: null,
10787
+ externalId: "cqis6Y8trbJ"
10788
+ },
10789
+ {
10790
+ id: "1b4c5d6e-7f8a-4312-bcde-345678901234",
10791
+ name: "Waziri",
10792
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10793
+ validUntil: null,
10794
+ externalId: "LMijHPyyx6d"
10795
+ },
10796
+ {
10797
+ id: "2c5d6e7f-8a9b-4423-8def-456789012345",
10798
+ name: "Zimbi",
10799
+ parentId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10800
+ validUntil: null,
10801
+ externalId: "pcQYbPuKGZ7"
10802
+ },
10803
+ // Villages under Itambo (89a33893-b17d-481d-a26d-6461e7ac1651)
10804
+ {
10805
+ id: "3d6e7f8a-9b0c-4534-8efa-567890123456",
10806
+ name: "Felani",
10807
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10808
+ validUntil: null,
10809
+ externalId: "gSqpoCGdMXp"
10810
+ },
10811
+ {
10812
+ id: "4e7f8a9b-0c1d-4645-8fab-678901234567",
10813
+ name: "Goroma",
10814
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10815
+ validUntil: null,
10816
+ externalId: "KvAAIaNqVrp"
10817
+ },
10818
+ {
10819
+ id: "5f8a9b0c-1d2e-4756-8abc-789012345678",
10820
+ name: "Halifu",
10821
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10822
+ validUntil: null,
10823
+ externalId: "qe4UnEVt1hv"
10824
+ },
10825
+ {
10826
+ id: "6a9b0c1d-2e3f-4867-abcd-890123456789",
10827
+ name: "Jabari",
10828
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10829
+ validUntil: null,
10830
+ externalId: "yHH9Nz4rLOt"
10831
+ },
10832
+ {
10833
+ id: "7b0c1d2e-3f4a-4978-bcde-901234567890",
10834
+ name: "Kifani",
10835
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10836
+ validUntil: null,
10837
+ externalId: "eSWmXIGeu1I"
10838
+ },
10839
+ {
10840
+ id: "8c1d2e3f-4a5b-4089-8def-012345678901",
10841
+ name: "Lumela",
10842
+ parentId: "89a33893-b17d-481d-a26d-6461e7ac1651",
10843
+ validUntil: null,
10844
+ externalId: "bh0b3aI1uP3"
10845
+ }
10846
+ ];
10847
+ var V2_DEFAULT_MOCK_LOCATIONS = [
10848
+ {
10849
+ id: "6f6186ce-cd5f-4a5f-810a-2d99e7c4ba12",
10850
+ name: "Central Provincial Office",
10851
+ locationType: "CRVS_OFFICE",
10852
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10853
+ validUntil: null,
10854
+ externalId: "Xr3Df8WpK6Ys"
10855
+ },
10856
+ {
10857
+ id: "b1c2d3e4-f5a6-7890-bcde-f12345678901",
10858
+ name: "Central Health Post",
10859
+ locationType: "HEALTH_FACILITY",
10860
+ administrativeAreaId: "a45b982a-5c7b-4bd9-8fd8-a42d0994054c",
10861
+ validUntil: null
10862
+ },
10863
+ {
10864
+ id: "028d2c85-ca31-426d-b5d1-2cef545a4902",
10865
+ name: "Ibombo District Office",
10866
+ locationType: "CRVS_OFFICE",
10867
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10868
+ validUntil: null,
10869
+ externalId: "Sm4Nw7GrD2Vy"
10870
+ },
10871
+ {
10872
+ id: "62a0ccb4-4f30-4f30-8882-f256007dff9f",
10873
+ name: "Isamba District Office",
10874
+ locationType: "CRVS_OFFICE",
10875
+ administrativeAreaId: "967032fd-3f81-478a-826c-30cb8fe121bd",
10876
+ validUntil: null,
10877
+ externalId: "Vg1Bq5XeH9Lt"
10878
+ },
10879
+ {
10880
+ id: "954c93e1-13f7-4435-bb82-35e0e215e07d",
10881
+ name: "Isango District Office",
10882
+ locationType: "CRVS_OFFICE",
10883
+ administrativeAreaId: "27160bbd-32d1-4625-812f-860226bfb92a",
10884
+ validUntil: null,
10885
+ externalId: "Je7Lm2XqN9Vz"
10886
+ },
10887
+ {
10888
+ id: "2884f5b9-17b4-49ce-bf4d-f538228935df",
10889
+ name: "Sulaka Provincial Office",
10890
+ locationType: "CRVS_OFFICE",
10891
+ administrativeAreaId: "c599b691-fd2d-45e1-abf4-d185de727fb5",
10892
+ validUntil: null,
10893
+ externalId: "Ht2Wp9KcX5Qv"
10894
+ },
10895
+ {
10896
+ id: "030358c6-54af-44be-821b-8e4af963a49c",
10897
+ name: "Ilanga District Office",
10898
+ locationType: "CRVS_OFFICE",
10899
+ administrativeAreaId: "8fbd09d2-212b-47f4-beb3-5e1694931d9f",
10900
+ validUntil: null,
10901
+ externalId: "Yp6Ds1WqN3Xz"
10902
+ },
10903
+ {
10904
+ id: "423d000f-101b-47c0-8b86-21a908067cee",
10905
+ name: "Chamakubi Health Post",
10906
+ locationType: "HEALTH_FACILITY",
10907
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10908
+ validUntil: null,
10909
+ externalId: "M1nFr8LbC2Qy"
10910
+ },
10911
+ {
10912
+ id: "4d3279be-d026-420c-88f7-f0a4ae986973",
10913
+ name: "Ibombo Rural Health Centre",
10914
+ locationType: "HEALTH_FACILITY",
10915
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10916
+ validUntil: null,
10917
+ externalId: "bT7pV6YrW0Xc"
10918
+ },
10919
+ {
10920
+ id: "190902f4-1d77-476a-8947-41145af1db7d",
10921
+ name: "Chikobo Rural Health Centre",
10922
+ locationType: "HEALTH_FACILITY",
10923
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10924
+ validUntil: null,
10925
+ externalId: "zE4qPn2SgJ5d"
10926
+ },
10927
+ {
10928
+ id: "f5ecbd9b-a01e-4a65-910e-70e86ab41b71",
10929
+ name: "Chilochabalenje Health Post",
10930
+ locationType: "HEALTH_FACILITY",
10931
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10932
+ validUntil: null,
10933
+ externalId: "H8vDs1MqR4Uf"
10934
+ },
10935
+ {
10936
+ id: "dbfc178f-7295-4b90-b28d-111c95b03127",
10937
+ name: "Chipeso Rural Health Centre",
10938
+ locationType: "HEALTH_FACILITY",
10939
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10940
+ validUntil: null,
10941
+ externalId: "Qw3uZ9KfX6Lm"
10942
+ },
10943
+ {
10944
+ id: "09862bfe-c7ac-46cd-987b-668681533c80",
10945
+ name: "Chisamba Rural Health Centre",
10946
+ locationType: "HEALTH_FACILITY",
10947
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10948
+ validUntil: null,
10949
+ externalId: "Yr0pCg8LdM2s"
10950
+ },
10951
+ {
10952
+ id: "834ce389-e95b-4fb0-96a0-33e9ab323059",
10953
+ name: "Chitanda Rural Health Centre",
10954
+ locationType: "HEALTH_FACILITY",
10955
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10956
+ validUntil: null,
10957
+ externalId: "tS9gJ4PwB1Qx"
10958
+ },
10959
+ {
10960
+ id: "0431c433-6062-4a4c-aee9-25271aec61ee",
10961
+ name: "Golden Valley Rural Health Centre",
10962
+ locationType: "HEALTH_FACILITY",
10963
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10964
+ validUntil: null,
10965
+ externalId: "Ld7Qm3XsA8Vr"
10966
+ },
10967
+ {
10968
+ id: "bc84d0b6-7ba7-480d-a339-5d9920d90eb2",
10969
+ name: "Ipongo Rural Health Centre",
10970
+ locationType: "HEALTH_FACILITY",
10971
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10972
+ validUntil: null,
10973
+ externalId: "kF2sW9DmH0Bt"
10974
+ },
10975
+ {
10976
+ id: "4cf1f53b-b730-41d2-8649-dff7eeed970d",
10977
+ name: "Itumbwe Health Post",
10978
+ locationType: "HEALTH_FACILITY",
10979
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10980
+ validUntil: null,
10981
+ externalId: "Ue5Xb3VaC7Pq"
10982
+ },
10983
+ {
10984
+ id: "4b3676cb-9355-4942-9eb9-2ce46acaf0e0",
10985
+ name: "Kabangalala Rural Health Centre",
10986
+ locationType: "HEALTH_FACILITY",
10987
+ administrativeAreaId: "62a0ccb4-880d-4f30-8882-f256007dfff9",
10988
+ validUntil: null,
10989
+ externalId: "Pz8Kc1TqH6Jn"
10990
+ },
10991
+ // Village offices
10992
+ {
10993
+ id: "1f4a5b6c-7d8e-4312-8abc-345678901234",
10994
+ name: "Klow Village Office",
10995
+ locationType: "CRVS_OFFICE",
10996
+ administrativeAreaId: "1d4e5f6a-7b8c-4912-8efa-345678901234",
10997
+ validUntil: null,
10998
+ externalId: "PmAyxAJkxiJ"
10999
+ }
11000
+ ];
11001
+ var V2_DEFAULT_MOCK_LOCATIONS_MAP = new Map(
11002
+ V2_DEFAULT_MOCK_LOCATIONS.map((l) => [l.id, l])
11003
+ );
11004
+ var V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS_MAP = new Map(
11005
+ V2_DEFAULT_MOCK_ADMINISTRATIVE_AREAS.map((a) => [a.id, a])
11006
+ );