@opencrvs/toolkit 2.0.0-rc.ff04b30 → 2.0.0-rc.ff8df64

package/dist/commons/events/utils.d.ts

@@ -386,6 +386,9 @@ export declare function findLastAssignmentAction(actions: Action[]): {
     createdAtLocation?: (string & import("zod").$brand<"UUID">) | null | undefined;
     annotation?: Record<string, import("./FieldValue").FieldUpdateValue> | null | undefined;
     originalActionId?: (string & import("zod").$brand<"UUID">) | null | undefined;
+    content?: {
+        immediateCorrection?: boolean | undefined;
+    } | undefined;
 } | {
     id: string & import("zod").$brand<"UUID">;
     transactionId: string;
@@ -559,7 +562,15 @@ export declare function timePeriodToDateRange(value: SelectDateRangeValue): {
 };
 export declare function mergeDrafts(currentDraft: Draft, incomingDraft: Draft): Draft;
 export declare function getPendingAction(actions: Action[]): ActionDocument;
-export declare function getCompleteActionAnnotation(annotation: ActionUpdate, event: EventDocument, action: ActionDocument): ActionUpdate;
+export declare function getCompleteActionAnnotation(event: EventDocument, action: ActionDocument): ActionUpdate;
+/**
+ * Resolves the complete content for an action, inheriting from its original
+ * Requested action when the Accepted action carries no content of its own.
+ *
+ * Mirrors the same "originalActionId → merge from Requested" pattern used by
+ * getCompleteActionAnnotation and getCompleteActionDeclaration.
+ */
+export declare function getCompleteActionContent(event: EventDocument, action: ActionDocument): Record<string, unknown> | null | undefined;
 export declare function getCompleteActionDeclaration<T extends EventState | ActionUpdate>(declaration: T, event: EventDocument, action: ActionDocument): T;
 export declare function getAcceptedActions(event: EventDocument): ActionDocument[];
 export declare function aggregateActionDeclarations(event: EventDocument): EventState;

package/dist/conditionals/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/conditionals/index.ts
 var conditionals_exports = {};
 __export(conditionals_exports, {
+  always: () => always,
   alwaysTrue: () => alwaysTrue,
   and: () => and,
   createFieldConditionals: () => createFieldConditionals,
@@ -454,6 +455,9 @@ function not(condition) {
 function never() {
   return not(alwaysTrue());
 }
+function always() {
+  return defineConditional(alwaysTrue());
+}
 function jsonFieldPath(field) {
   return [field.$$field, ...field.$$subfield].join("/");
 }
@@ -1001,7 +1005,54 @@ function createFieldConditionals(fieldId) {
         }
       },
       required: [fieldId]
-    })
+    }),
+    /**
+     * Custom client-side validator. The provided function is serialised and executed
+     * just-in-time on the client only. External references (e.g. lodash) are not
+     * available inside the function body — all logic must be self-contained.
+     *
+     * @example
+     * field('nid').customClientValidator((value) => {
+     *   // LUHN check — all logic must be inline
+     *   const digits = String(value).split('').map(Number)
+     *   // ...
+     *   return isValid
+     * })
+     */
+    customClientValidator(validationFn) {
+      const code = validationFn.toString();
+      return defineFormConditional({
+        type: "object",
+        properties: wrapToPath(
+          { [fieldId]: { customClientValidator: { code } } },
+          this.$$subfield
+        ),
+        required: [fieldId]
+      });
+    },
+    /**
+     * Custom client-side evaluation. Returns a {@link FieldReference} descriptor
+     * that can be used as the `value` property or a DATA component entry.
+     * The function receives the referenced field's value as the first argument and
+     * the full form context as the second; its return value replaces the field reference.
+     * The function is serialised and executed just-in-time on the client only.
+     * External references (e.g. lodash) are not available inside the function body.
+     *
+     * For computing a default value without referencing a specific field, use
+     * `evaluate(fn)` in the `defaultValue` property instead.
+     *
+     * @example
+     * field('a').customClientEvaluation((aValue, ctx) =>
+     *   Number(aValue) + Number(ctx.$form.b)
+     * )
+     */
+    customClientEvaluation(computationFn) {
+      return {
+        $$code: computationFn.toString(),
+        $$field: fieldId,
+        $$subfield: this.$$subfield
+      };
+    }
   };
 }