@opencrvs/toolkit 2.0.0-rc.b5aa830 → 2.0.0-rc.b600229

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.
@@ -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,
@@ -246,10 +248,12 @@ __export(events_exports, {
246
248
  applyDraftToEventIndex: () => applyDraftToEventIndex,
247
249
  areCertificateConditionsMet: () => areCertificateConditionsMet,
248
250
  areConditionsMet: () => areConditionsMet,
251
+ buildClientFunctionContext: () => buildClientFunctionContext,
249
252
  buildFormState: () => buildFormState,
250
253
  canAccessEventWithScope: () => canAccessEventWithScope,
251
254
  canAccessOtherUserWithScopes: () => canAccessOtherUserWithScopes,
252
255
  canAccessUserWithScope: () => canAccessUserWithScope,
256
+ compileClientFunction: () => compileClientFunction,
253
257
  compositeFieldTypes: () => compositeFieldTypes,
254
258
  createEmptyDraft: () => createEmptyDraft,
255
259
  createFieldConditionals: () => createFieldConditionals,
@@ -270,6 +274,7 @@ __export(events_exports, {
270
274
  defineWorkqueuesColumns: () => defineWorkqueuesColumns,
271
275
  deserializeQuery: () => deserializeQuery,
272
276
  errorMessages: () => errorMessages,
277
+ evaluate: () => evaluate,
273
278
  event: () => event,
274
279
  eventMetadataLabelMap: () => eventMetadataLabelMap,
275
280
  eventPayloadGenerator: () => eventPayloadGenerator,
@@ -348,6 +353,7 @@ __export(events_exports, {
348
353
  isBulletListFieldType: () => isBulletListFieldType,
349
354
  isButtonFieldType: () => isButtonFieldType,
350
355
  isCheckboxFieldType: () => isCheckboxFieldType,
356
+ isCodeToEvaluate: () => isCodeToEvaluate,
351
357
  isConditionMet: () => isConditionMet,
352
358
  isCountryFieldType: () => isCountryFieldType,
353
359
  isCustomFieldType: () => isCustomFieldType,
@@ -424,11 +430,13 @@ __export(events_exports, {
424
430
  resolveDateOfEvent: () => resolveDateOfEvent,
425
431
  resolveEventCustomFlags: () => resolveEventCustomFlags,
426
432
  resolvePlaceOfEvent: () => resolvePlaceOfEvent,
433
+ runClientFunction: () => runClientFunction,
427
434
  runFieldValidations: () => runFieldValidations,
428
435
  runStructuralValidations: () => runStructuralValidations,
429
436
  safeUnion: () => safeUnion,
430
437
  status: () => status,
431
438
  timePeriodToDateRange: () => timePeriodToDateRange,
439
+ todayISO: () => todayISO,
432
440
  user: () => user,
433
441
  userCanAccessEventWithScopes: () => userCanAccessEventWithScopes,
434
442
  validate: () => validate,
@@ -1360,6 +1368,7 @@ var DateRangeFieldValue = z12.object({
1360
1368
  var EmailValue = z12.email();
1361
1369
  var CheckboxFieldValue = z12.boolean();
1362
1370
  var NumberFieldValue = z12.number();
1371
+ var SignatureFieldValue = FileFieldValue;
1363
1372
  var ButtonFieldValue = z12.number();
1364
1373
  var VerificationStatusValue = z12.enum([
1365
1374
  "verified",
@@ -2191,8 +2200,21 @@ var FieldReference = import_v43.default.object({
2191
2200
  $$field: FieldId.describe("Id of the field to reference"),
2192
2201
  $$subfield: import_v43.default.array(import_v43.default.string()).optional().default([]).describe(
2193
2202
  'If the FieldValue is an object, subfield can be used to refer to e.g. `["foo", "bar"]` in `{ foo: { bar: 3 } }`'
2203
+ ),
2204
+ $$code: import_v43.default.string().optional().describe(
2205
+ "Serialised client-side function body. When present the expression is evaluated rather than dereferenced."
2206
+ )
2207
+ }).describe(
2208
+ "Reference to a field value, with an optional client-side computation applied."
2209
+ );
2210
+ function isCodeToEvaluate(v) {
2211
+ return !!v && typeof v === "object" && "$$code" in v;
2212
+ }
2213
+ var ComputedDefaultValue = import_v43.default.object({
2214
+ $$code: import_v43.default.string().describe(
2215
+ "Serialised client-side function body. Receives (undefined, context) where context includes $now, $online, and system variables."
2194
2216
  )
2195
- }).describe("Reference to a field by its ID");
2217
+ }).describe("A context-only computation used as a field default value.");
2196
2218
  var ValidationConfig = import_v43.default.object({
2197
2219
  validator: Conditional.describe(
2198
2220
  "Conditional expression that must hold for the field value to be considered valid."
@@ -2233,7 +2255,7 @@ var BaseField = import_v43.default.object({
2233
2255
  "Indicates whether the field can be modified during record correction."
2234
2256
  ),
2235
2257
  value: FieldReference.or(import_v43.default.array(FieldReference)).optional().describe(
2236
- "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used."
2258
+ "Reference to the source field or fields. When a value is defined, it is copied from the parent field when changed. If multiple references are provided, the first truthy value is used. A FieldReference with $$code computes the value via a custom client-side function."
2237
2259
  ),
2238
2260
  analytics: import_v43.default.boolean().default(false).optional().describe(
2239
2261
  "Indicates whether the field is included in analytics. When enabled, its value becomes available in the analytics dashboard."
@@ -2247,7 +2269,7 @@ var Divider = BaseField.extend({
2247
2269
  });
2248
2270
  var TextField = BaseField.extend({
2249
2271
  type: import_v43.default.literal(FieldType.TEXT),
2250
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2272
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2251
2273
  configuration: import_v43.default.object({
2252
2274
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2253
2275
  type: import_v43.default.enum(["text", "password"]).optional(),
@@ -2260,7 +2282,7 @@ var TextField = BaseField.extend({
2260
2282
  });
2261
2283
  var NumberField = BaseField.extend({
2262
2284
  type: import_v43.default.literal(FieldType.NUMBER),
2263
- defaultValue: NumberFieldValue.optional(),
2285
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2264
2286
  configuration: import_v43.default.object({
2265
2287
  min: import_v43.default.number().optional().describe("Minimum value"),
2266
2288
  max: import_v43.default.number().optional().describe("Maximum value"),
@@ -2273,7 +2295,7 @@ var NumberField = BaseField.extend({
2273
2295
  });
2274
2296
  var TextAreaField = BaseField.extend({
2275
2297
  type: import_v43.default.literal(FieldType.TEXTAREA),
2276
- defaultValue: NonEmptyTextValue.optional(),
2298
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2277
2299
  configuration: import_v43.default.object({
2278
2300
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text"),
2279
2301
  rows: import_v43.default.number().optional().describe("Number of visible text lines"),
@@ -2307,7 +2329,7 @@ var SignatureField = BaseField.extend({
2307
2329
  signaturePromptLabel: TranslationConfig.describe(
2308
2330
  "Title of the signature modal"
2309
2331
  ),
2310
- defaultValue: FieldValue.optional(),
2332
+ defaultValue: SignatureFieldValue.or(ComputedDefaultValue).optional(),
2311
2333
  configuration: import_v43.default.object({
2312
2334
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2313
2335
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature")
@@ -2323,14 +2345,14 @@ var EmailField = BaseField.extend({
2323
2345
  configuration: import_v43.default.object({
2324
2346
  maxLength: import_v43.default.number().optional().describe("Maximum length of the text")
2325
2347
  }).default({ maxLength: 255 }).optional(),
2326
- defaultValue: NonEmptyTextValue.optional()
2348
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional()
2327
2349
  }).meta({
2328
2350
  description: "An email input field",
2329
2351
  id: "EmailField"
2330
2352
  });
2331
2353
  var DateField = BaseField.extend({
2332
2354
  type: import_v43.default.literal(FieldType.DATE),
2333
- defaultValue: SerializedNowDateTime.or(PlainDate).optional().describe("Default date value(yyyy-MM-dd)"),
2355
+ defaultValue: SerializedNowDateTime.or(PlainDate).or(ComputedDefaultValue).optional().describe("Default date value(yyyy-MM-dd)"),
2334
2356
  configuration: import_v43.default.object({
2335
2357
  notice: TranslationConfig.describe(
2336
2358
  "Text to display above the date input"
@@ -2342,7 +2364,7 @@ var DateField = BaseField.extend({
2342
2364
  });
2343
2365
  var AgeField = BaseField.extend({
2344
2366
  type: import_v43.default.literal(FieldType.AGE),
2345
- defaultValue: NumberFieldValue.optional(),
2367
+ defaultValue: NumberFieldValue.or(ComputedDefaultValue).optional(),
2346
2368
  configuration: import_v43.default.object({
2347
2369
  asOfDate: FieldReference,
2348
2370
  prefix: TranslationConfig.optional(),
@@ -2354,7 +2376,7 @@ var AgeField = BaseField.extend({
2354
2376
  });
2355
2377
  var TimeField = BaseField.extend({
2356
2378
  type: import_v43.default.literal(FieldType.TIME),
2357
- defaultValue: SerializedNowDateTime.or(TimeValue).optional().describe("Default time value (HH-mm)"),
2379
+ defaultValue: SerializedNowDateTime.or(TimeValue).or(ComputedDefaultValue).optional().describe("Default time value (HH-mm)"),
2358
2380
  configuration: import_v43.default.object({
2359
2381
  use12HourFormat: import_v43.default.boolean().optional().describe("Whether to use 12-hour format"),
2360
2382
  notice: TranslationConfig.describe(
@@ -2367,7 +2389,7 @@ var TimeField = BaseField.extend({
2367
2389
  });
2368
2390
  var DateRangeField = BaseField.extend({
2369
2391
  type: import_v43.default.literal(FieldType.DATE_RANGE),
2370
- defaultValue: DateRangeFieldValue.optional(),
2392
+ defaultValue: DateRangeFieldValue.or(ComputedDefaultValue).optional(),
2371
2393
  configuration: import_v43.default.object({
2372
2394
  notice: TranslationConfig.describe(
2373
2395
  "Text to display above the date input"
@@ -2446,7 +2468,7 @@ var PageHeader = BaseField.extend({
2446
2468
  });
2447
2469
  var File = BaseField.extend({
2448
2470
  type: import_v43.default.literal(FieldType.FILE),
2449
- defaultValue: FileFieldValue.optional(),
2471
+ defaultValue: FileFieldValue.or(ComputedDefaultValue).optional(),
2450
2472
  configuration: import_v43.default.object({
2451
2473
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2452
2474
  acceptedFileTypes: MimeType.array().optional().describe("List of allowed file formats for the signature"),
@@ -2473,7 +2495,7 @@ var SelectOption = import_v43.default.object({
2473
2495
  });
2474
2496
  var NumberWithUnitField = BaseField.extend({
2475
2497
  type: import_v43.default.literal(FieldType.NUMBER_WITH_UNIT),
2476
- defaultValue: NumberWithUnitFieldValue.optional(),
2498
+ defaultValue: NumberWithUnitFieldValue.or(ComputedDefaultValue).optional(),
2477
2499
  options: import_v43.default.array(SelectOption).describe("A list of options for the unit select"),
2478
2500
  configuration: import_v43.default.object({
2479
2501
  min: import_v43.default.number().optional().describe("Minimum value of the number field"),
@@ -2488,7 +2510,7 @@ var NumberWithUnitField = BaseField.extend({
2488
2510
  });
2489
2511
  var RadioGroup = BaseField.extend({
2490
2512
  type: import_v43.default.literal(FieldType.RADIO_GROUP),
2491
- defaultValue: TextValue.optional(),
2513
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2492
2514
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2493
2515
  configuration: import_v43.default.object({
2494
2516
  styles: import_v43.default.object({
@@ -2513,7 +2535,7 @@ var BulletList = BaseField.extend({
2513
2535
  });
2514
2536
  var Select = BaseField.extend({
2515
2537
  type: import_v43.default.literal(FieldType.SELECT),
2516
- defaultValue: TextValue.optional(),
2538
+ defaultValue: TextValue.or(ComputedDefaultValue).optional(),
2517
2539
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2518
2540
  noOptionsMessage: TranslationConfig.optional().describe(
2519
2541
  `
@@ -2535,7 +2557,7 @@ var SelectDateRangeOption = import_v43.default.object({
2535
2557
  });
2536
2558
  var SelectDateRangeField = BaseField.extend({
2537
2559
  type: import_v43.default.literal(FieldType.SELECT_DATE_RANGE),
2538
- defaultValue: SelectDateRangeValue.optional(),
2560
+ defaultValue: SelectDateRangeValue.or(ComputedDefaultValue).optional(),
2539
2561
  options: import_v43.default.array(SelectDateRangeOption).describe("A list of options")
2540
2562
  }).meta({
2541
2563
  description: "A date range selection field",
@@ -2552,7 +2574,7 @@ var NameField = BaseField.extend({
2552
2574
  firstname: SerializedUserField.or(NonEmptyTextValue).optional(),
2553
2575
  middlename: SerializedUserField.or(NonEmptyTextValue).optional(),
2554
2576
  surname: SerializedUserField.or(NonEmptyTextValue).optional()
2555
- }).optional(),
2577
+ }).or(ComputedDefaultValue).optional(),
2556
2578
  configuration: import_v43.default.object({
2557
2579
  name: NameConfig.default({
2558
2580
  firstname: { required: true },
@@ -2576,14 +2598,14 @@ var NameField = BaseField.extend({
2576
2598
  id: "NameField"
2577
2599
  });
2578
2600
  var PhoneField = BaseField.extend({
2579
- defaultValue: NonEmptyTextValue.optional(),
2601
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2580
2602
  type: import_v43.default.literal(FieldType.PHONE)
2581
2603
  }).meta({
2582
2604
  description: "A field for entering a phone number",
2583
2605
  id: "PhoneField"
2584
2606
  });
2585
2607
  var IdField = BaseField.extend({
2586
- defaultValue: NonEmptyTextValue.optional(),
2608
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2587
2609
  type: import_v43.default.literal(FieldType.ID)
2588
2610
  }).meta({
2589
2611
  description: "A field for entering an ID",
@@ -2591,14 +2613,14 @@ var IdField = BaseField.extend({
2591
2613
  });
2592
2614
  var Checkbox = BaseField.extend({
2593
2615
  type: import_v43.default.literal(FieldType.CHECKBOX),
2594
- defaultValue: CheckboxFieldValue.default(false)
2616
+ defaultValue: CheckboxFieldValue.or(ComputedDefaultValue).default(false)
2595
2617
  }).meta({
2596
2618
  description: "A boolean checkbox field",
2597
2619
  id: "Checkbox"
2598
2620
  });
2599
2621
  var Country = BaseField.extend({
2600
2622
  type: import_v43.default.literal(FieldType.COUNTRY),
2601
- defaultValue: NonEmptyTextValue.optional(),
2623
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2602
2624
  optionOverrides: import_v43.default.array(SelectOption.omit({ label: true })).optional().describe(
2603
2625
  "Conditionals for specific countries. Countries not listed are always shown and enabled."
2604
2626
  )
@@ -2616,7 +2638,7 @@ var AdministrativeAreas = import_v43.default.enum([
2616
2638
  ]);
2617
2639
  var AdministrativeAreaField = BaseField.extend({
2618
2640
  type: import_v43.default.literal(FieldType.ADMINISTRATIVE_AREA),
2619
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2641
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2620
2642
  configuration: import_v43.default.object({
2621
2643
  partOf: FieldReference.optional().describe("Parent location"),
2622
2644
  type: AdministrativeAreas,
@@ -2628,7 +2650,7 @@ var AdministrativeAreaField = BaseField.extend({
2628
2650
  });
2629
2651
  var LocationInput = BaseField.extend({
2630
2652
  type: import_v43.default.literal(FieldType.LOCATION),
2631
- defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField]).optional(),
2653
+ defaultValue: import_v43.default.union([NonEmptyTextValue, SerializedUserField, ComputedDefaultValue]).optional(),
2632
2654
  configuration: import_v43.default.object({
2633
2655
  locationTypes: import_v43.default.array(import_v43.default.string()).optional().describe("Types of the locations that are available for selection."),
2634
2656
  allowedLocations: AllowedLocations
@@ -2640,7 +2662,7 @@ var LocationInput = BaseField.extend({
2640
2662
  var FileUploadWithOptions = BaseField.extend({
2641
2663
  type: import_v43.default.literal(FieldType.FILE_WITH_OPTIONS),
2642
2664
  options: import_v43.default.array(SelectOption).describe("A list of options"),
2643
- defaultValue: FileFieldWithOptionValue.optional(),
2665
+ defaultValue: FileFieldWithOptionValue.or(ComputedDefaultValue).optional(),
2644
2666
  configuration: import_v43.default.object({
2645
2667
  maxFileSize: import_v43.default.number().describe("Maximum file size in bytes").default(DEFAULT_MAX_FILE_SIZE_BYTES),
2646
2668
  maxImageSize: import_v43.default.object({
@@ -2656,12 +2678,12 @@ var FileUploadWithOptions = BaseField.extend({
2656
2678
  });
2657
2679
  var Facility = BaseField.extend({
2658
2680
  type: import_v43.default.literal(FieldType.FACILITY),
2659
- defaultValue: NonEmptyTextValue.optional(),
2681
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2660
2682
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2661
2683
  }).describe("Input field for a facility");
2662
2684
  var Office = BaseField.extend({
2663
2685
  type: import_v43.default.literal(FieldType.OFFICE),
2664
- defaultValue: NonEmptyTextValue.optional(),
2686
+ defaultValue: NonEmptyTextValue.or(ComputedDefaultValue).optional(),
2665
2687
  configuration: import_v43.default.object({ allowedLocations: AllowedLocations }).optional()
2666
2688
  }).describe("Input field for an office");
2667
2689
  var DefaultAddressFieldValue = DomesticAddressFieldValue.extend({
@@ -2697,7 +2719,7 @@ var Address = BaseField.extend({
2697
2719
  ).optional(),
2698
2720
  allowedLocations: AllowedLocations
2699
2721
  }).optional(),
2700
- defaultValue: DefaultAddressFieldValue.optional()
2722
+ defaultValue: DefaultAddressFieldValue.or(ComputedDefaultValue).optional()
2701
2723
  }).meta({
2702
2724
  description: "Address input field \u2013 a combination of location and text fields",
2703
2725
  id: "Address"
@@ -2744,7 +2766,7 @@ var ButtonConfiguration = import_v43.default.object({
2744
2766
  });
2745
2767
  var ButtonField = BaseField.extend({
2746
2768
  type: import_v43.default.literal(FieldType.BUTTON),
2747
- defaultValue: ButtonFieldValue.optional(),
2769
+ defaultValue: ButtonFieldValue.or(ComputedDefaultValue).optional(),
2748
2770
  configuration: ButtonConfiguration
2749
2771
  }).meta({
2750
2772
  description: "A generic button that can be used to trigger an action",
@@ -2772,7 +2794,7 @@ var AlphaPrintButton = BaseField.extend({
2772
2794
  });
2773
2795
  var HttpField = BaseField.extend({
2774
2796
  type: import_v43.default.literal(FieldType.HTTP),
2775
- defaultValue: HttpFieldValue.optional(),
2797
+ defaultValue: HttpFieldValue.or(ComputedDefaultValue).optional(),
2776
2798
  configuration: import_v43.default.object({
2777
2799
  trigger: FieldReference.optional().describe(
2778
2800
  "Reference to the field that triggers the HTTP request when its value changes. If not provided, the HTTP request is triggered once on component mount."
@@ -2858,7 +2880,7 @@ var LinkButtonField = BaseField.extend({
2858
2880
  });
2859
2881
  var VerificationStatus = BaseField.extend({
2860
2882
  type: import_v43.default.literal(FieldType.VERIFICATION_STATUS),
2861
- defaultValue: VerificationStatusValue.optional(),
2883
+ defaultValue: VerificationStatusValue.or(ComputedDefaultValue).optional(),
2862
2884
  configuration: import_v43.default.object({
2863
2885
  status: TranslationConfig.describe("Text to display on the status pill."),
2864
2886
  description: TranslationConfig.describe(
@@ -2880,7 +2902,7 @@ var QueryParamReaderField = BaseField.extend({
2880
2902
  });
2881
2903
  var QrReaderField = BaseField.extend({
2882
2904
  type: import_v43.default.literal(FieldType.QR_READER),
2883
- defaultValue: QrReaderFieldValue.optional(),
2905
+ defaultValue: QrReaderFieldValue.or(ComputedDefaultValue).optional(),
2884
2906
  configuration: import_v43.default.object({
2885
2907
  validator: import_v43.default.any().meta({
2886
2908
  description: "JSON Schema to validate the scanned QR code data against before populating the form fields.",
@@ -2893,7 +2915,7 @@ var QrReaderField = BaseField.extend({
2893
2915
  });
2894
2916
  var IdReaderField = BaseField.extend({
2895
2917
  type: import_v43.default.literal(FieldType.ID_READER),
2896
- defaultValue: IdReaderFieldValue.optional(),
2918
+ defaultValue: IdReaderFieldValue.or(ComputedDefaultValue).optional(),
2897
2919
  methods: import_v43.default.array(
2898
2920
  import_v43.default.union([QrReaderField, LinkButtonField]).describe("Methods for reading an ID")
2899
2921
  )
@@ -3526,9 +3548,11 @@ var z30 = __toESM(require("zod/v4"));
3526
3548
  var z29 = __toESM(require("zod/v4"));
3527
3549
  function getDynamicNameValue(field3) {
3528
3550
  const nameConfiguration = field3.configuration?.name;
3551
+ const firstnameRequired = nameConfiguration?.firstname?.required ?? field3.required;
3552
+ const surnameRequired = nameConfiguration?.surname?.required ?? field3.required;
3529
3553
  return z29.object({
3530
- firstname: nameConfiguration?.firstname?.required ? NonEmptyTextValue : TextValue,
3531
- surname: nameConfiguration?.surname?.required ? NonEmptyTextValue : TextValue,
3554
+ firstname: firstnameRequired ? NonEmptyTextValue : TextValue,
3555
+ surname: surnameRequired ? NonEmptyTextValue : TextValue,
3532
3556
  middlename: nameConfiguration?.middlename?.required ? NonEmptyTextValue : TextValue.optional()
3533
3557
  });
3534
3558
  }
@@ -3911,7 +3935,37 @@ function resolveDataPath(rootData, dataPath, instancePath) {
3911
3935
  }
3912
3936
  return current;
3913
3937
  }
3938
+ function todayISO() {
3939
+ return (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" });
3940
+ }
3941
+ var compiledFunctionCache = /* @__PURE__ */ new Map();
3942
+ function compileClientFunction(code) {
3943
+ let fn = compiledFunctionCache.get(code);
3944
+ if (!fn) {
3945
+ fn = new Function(`return (${code})`)();
3946
+ compiledFunctionCache.set(code, fn);
3947
+ }
3948
+ return fn;
3949
+ }
3914
3950
  (0, import_ajv_formats.default)(ajv);
3951
+ function buildClientFunctionContext(input) {
3952
+ return {
3953
+ $form: input.form,
3954
+ $now: todayISO(),
3955
+ // eslint-disable-next-line @typescript-eslint/no-use-before-define
3956
+ $online: isOnline(),
3957
+ $user: input.validatorContext?.user,
3958
+ $event: input.validatorContext?.event,
3959
+ $leafAdminStructureLocationIds: input.validatorContext?.leafAdminStructureLocationIds ?? [],
3960
+ user: input.systemVariables?.user,
3961
+ $window: input.systemVariables?.$window,
3962
+ locations: input.locations,
3963
+ adminLevelIds: input.adminLevelIds
3964
+ };
3965
+ }
3966
+ function runClientFunction(code, data, context) {
3967
+ return compileClientFunction(code)(data, context);
3968
+ }
3915
3969
  ajv.addKeyword({
3916
3970
  keyword: "daysFromDate",
3917
3971
  type: "string",
@@ -3956,7 +4010,7 @@ ajv.addKeyword({
3956
4010
  $data: true,
3957
4011
  errors: true,
3958
4012
  // @ts-ignore -- Force type. We will move this away from AJV next. Parsing the array will take seconds and is only called by core.
3959
- validate(schema, data, _2, dataContext) {
4013
+ validate(_schema, data, _2, dataContext) {
3960
4014
  const locationIdInput = data;
3961
4015
  const locations = dataContext?.rootData.$leafAdminStructureLocationIds ?? [];
3962
4016
  return locations.some((location) => location.id === locationIdInput);
@@ -3987,6 +4041,23 @@ function isAgeValue(value) {
3987
4041
  function mergeWithBaseFormState(values, context) {
3988
4042
  return { ...context.baseFormState, ...values };
3989
4043
  }
4044
+ ajv.addKeyword({
4045
+ keyword: "customClientValidator",
4046
+ schemaType: "object",
4047
+ errors: true,
4048
+ // @ts-expect-error -- AJV's public types don't expose `rootData`. All
4049
+ // `validate()` callers build root data via `buildClientFunctionContext`,
4050
+ // so the cast holds.
4051
+ validate(schema, data, _2, dataContext) {
4052
+ return Boolean(
4053
+ runClientFunction(
4054
+ schema.code,
4055
+ data,
4056
+ dataContext?.rootData ?? buildClientFunctionContext({ form: {} })
4057
+ )
4058
+ );
4059
+ }
4060
+ });
3990
4061
  function validate(schema, data) {
3991
4062
  const validator = ajv.getSchema(schema.$id) || ajv.compile(schema);
3992
4063
  if ("$form" in data) {
@@ -4023,17 +4094,14 @@ function isOnline() {
4023
4094
  }
4024
4095
  return true;
4025
4096
  }
4026
- function isConditionMet(conditional, values, context, eventIndex) {
4027
- return validate(conditional, {
4028
- $form: mergeWithBaseFormState(values, context),
4029
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4030
- $online: isOnline(),
4031
- $user: context.user,
4032
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4033
- $flags: eventIndex?.flags ?? [],
4034
- $status: eventIndex?.status,
4035
- $event: context.event
4036
- });
4097
+ function isConditionMet(conditional, values, context) {
4098
+ return validate(
4099
+ conditional,
4100
+ buildClientFunctionContext({
4101
+ form: mergeWithBaseFormState(values, context),
4102
+ validatorContext: context
4103
+ })
4104
+ );
4037
4105
  }
4038
4106
  function getConditionalActionsForField(field3, values) {
4039
4107
  if (!field3.conditionals) {
@@ -4041,9 +4109,9 @@ function getConditionalActionsForField(field3, values) {
4041
4109
  }
4042
4110
  return field3.conditionals.filter((conditional) => validate(conditional.conditional, values)).map((conditional) => conditional.type);
4043
4111
  }
4044
- function areConditionsMet(conditions, values, context, event2) {
4112
+ function areConditionsMet(conditions, values, context, _event) {
4045
4113
  return conditions.every(
4046
- (condition) => isConditionMet(condition.conditional, values, context, event2)
4114
+ (condition) => isConditionMet(condition.conditional, values, context)
4047
4115
  );
4048
4116
  }
4049
4117
  function isFieldConditionMet(field3, form, conditionalType, context) {
@@ -4053,14 +4121,13 @@ function isFieldConditionMet(field3, form, conditionalType, context) {
4053
4121
  if (!hasRule) {
4054
4122
  return true;
4055
4123
  }
4056
- const validConditionals = getConditionalActionsForField(field3, {
4057
- $form: mergeWithBaseFormState(form, context),
4058
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4059
- $online: isOnline(),
4060
- $user: context.user,
4061
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4062
- $event: context.event
4063
- });
4124
+ const validConditionals = getConditionalActionsForField(
4125
+ field3,
4126
+ buildClientFunctionContext({
4127
+ form: mergeWithBaseFormState(form, context),
4128
+ validatorContext: context
4129
+ })
4130
+ );
4064
4131
  return validConditionals.includes(conditionalType);
4065
4132
  }
4066
4133
  function isFieldVisible(field3, form, context) {
@@ -4086,7 +4153,14 @@ function isActionConditionMet(actionConfig, event2, context, conditionalType) {
4086
4153
  if (!rule) {
4087
4154
  return true;
4088
4155
  }
4089
- return isConditionMet(rule.conditional, event2.declaration, context, event2);
4156
+ return validate(rule.conditional, {
4157
+ ...buildClientFunctionContext({
4158
+ form: mergeWithBaseFormState(event2.declaration, context),
4159
+ validatorContext: context
4160
+ }),
4161
+ $flags: event2.flags,
4162
+ $status: event2.status
4163
+ });
4090
4164
  }
4091
4165
  function isActionEnabled(actionConfig, event2, context) {
4092
4166
  return isActionConditionMet(
@@ -4245,19 +4319,10 @@ function runFieldValidations({
4245
4319
  if (!isFieldVisible(field3.config, form, context)) {
4246
4320
  return [];
4247
4321
  }
4248
- const conditionalParameters = {
4249
- $form: mergeWithBaseFormState(form, context),
4250
- $now: (0, import_date_fns.formatISO)(/* @__PURE__ */ new Date(), { representation: "date" }),
4251
- /**
4252
- * In real use cases, there can be hundreds of thousands of locations.
4253
- * Make sure that the context contains only the locations that are needed for validation.
4254
- * E.g. if the user is a leaf admin, only the leaf locations under their admin structure are needed.
4255
- * Loading few megabytes of locations to memory just for validation is not efficient and will choke the application.
4256
- */
4257
- $leafAdminStructureLocationIds: context.leafAdminStructureLocationIds ?? [],
4258
- $online: isOnline(),
4259
- $user: context.user
4260
- };
4322
+ const conditionalParameters = buildClientFunctionContext({
4323
+ form: mergeWithBaseFormState(form, context),
4324
+ validatorContext: context
4325
+ });
4261
4326
  if (isFieldGroupFieldType(field3)) {
4262
4327
  const subfieldErrors = buildFormState(
4263
4328
  field3.config.fields,
@@ -4741,19 +4806,16 @@ function getPendingAction(actions) {
4741
4806
  }
4742
4807
  return pendingActions[0];
4743
4808
  }
4744
- function getCompleteActionAnnotation(annotation, event2, action) {
4809
+ function getCompleteActionAnnotation(event2, action) {
4745
4810
  if (action.originalActionId) {
4746
4811
  const originalAction = event2.actions.find(
4747
4812
  ({ id }) => id === action.originalActionId
4748
4813
  );
4749
4814
  if (originalAction?.status === ActionStatus.Requested) {
4750
- return deepMerge(
4751
- deepMerge(annotation, originalAction.annotation ?? {}),
4752
- action.annotation ?? {}
4753
- );
4815
+ return deepMerge(originalAction.annotation ?? {}, action.annotation ?? {});
4754
4816
  }
4755
4817
  }
4756
- return deepMerge(annotation, action.annotation ?? {});
4818
+ return action.annotation ?? {};
4757
4819
  }
4758
4820
  function getCompleteActionContent(event2, action) {
4759
4821
  const currentContent = "content" in action ? action.content : void 0;
@@ -4789,7 +4851,7 @@ function getAcceptedActions(event2) {
4789
4851
  return event2.actions.filter(isAcceptedAction).map((action) => ({
4790
4852
  ...action,
4791
4853
  declaration: getCompleteActionDeclaration({}, event2, action),
4792
- annotation: getCompleteActionAnnotation({}, event2, action)
4854
+ annotation: getCompleteActionAnnotation(event2, action)
4793
4855
  }));
4794
4856
  }
4795
4857
  var EXCLUDED_ACTIONS = [
@@ -5427,7 +5489,54 @@ function createFieldConditionals(fieldId) {
5427
5489
  }
5428
5490
  },
5429
5491
  required: [fieldId]
5430
- })
5492
+ }),
5493
+ /**
5494
+ * Custom client-side validator. The provided function is serialised and executed
5495
+ * just-in-time on the client only. External references (e.g. lodash) are not
5496
+ * available inside the function body — all logic must be self-contained.
5497
+ *
5498
+ * @example
5499
+ * field('nid').customClientValidator((value) => {
5500
+ * // LUHN check — all logic must be inline
5501
+ * const digits = String(value).split('').map(Number)
5502
+ * // ...
5503
+ * return isValid
5504
+ * })
5505
+ */
5506
+ customClientValidator(validationFn) {
5507
+ const code = validationFn.toString();
5508
+ return defineFormConditional({
5509
+ type: "object",
5510
+ properties: wrapToPath(
5511
+ { [fieldId]: { customClientValidator: { code } } },
5512
+ this.$$subfield
5513
+ ),
5514
+ required: [fieldId]
5515
+ });
5516
+ },
5517
+ /**
5518
+ * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
5519
+ * that can be used as the `value` property or a DATA component entry.
5520
+ * The function receives the referenced field's value as the first argument and
5521
+ * the full form context as the second; its return value replaces the field reference.
5522
+ * The function is serialised and executed just-in-time on the client only.
5523
+ * External references (e.g. lodash) are not available inside the function body.
5524
+ *
5525
+ * For computing a default value without referencing a specific field, use
5526
+ * `evaluate(fn)` in the `defaultValue` property instead.
5527
+ *
5528
+ * @example
5529
+ * field('a').customClientEvaluation((aValue, ctx) =>
5530
+ * Number(aValue) + Number(ctx.$form.b)
5531
+ * )
5532
+ */
5533
+ customClientEvaluation(computationFn) {
5534
+ return {
5535
+ $$code: computationFn.toString(),
5536
+ $$field: fieldId,
5537
+ $$subfield: this.$$subfield
5538
+ };
5539
+ }
5431
5540
  };
5432
5541
  }
5433
5542
 
@@ -6786,7 +6895,7 @@ function getActionAnnotation({
6786
6895
  const action = (0, import_lodash4.findLast)(activeActions, (a) => a.type === actionType);
6787
6896
  const actionWithCompleteAnnotation = action && {
6788
6897
  ...action,
6789
- annotation: getCompleteActionAnnotation({}, event2, action)
6898
+ annotation: getCompleteActionAnnotation(event2, action)
6790
6899
  };
6791
6900
  const matchingDraft = draft?.action.type === actionType ? draft : void 0;
6792
6901
  const sortedActions = (0, import_lodash4.orderBy)(
@@ -6858,6 +6967,9 @@ function createFieldConfig(fieldId, options) {
6858
6967
  }
6859
6968
 
6860
6969
  // ../commons/src/events/field.ts
6970
+ function evaluate(computationFn) {
6971
+ return { $$code: computationFn.toString() };
6972
+ }
6861
6973
  function field(fieldId, options = {}) {
6862
6974
  return {
6863
6975
  ...createFieldConditionals(fieldId),