@opencrvs/toolkit 1.9.6-rc.fe27b9b → 1.9.7-rc.0fa356d

package/dist/conditionals/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conditionals/index.ts"],"names":[],"mappings":"AAaA,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conditionals/index.ts"],"names":[],"mappings":"AAUA,cAAc,gCAAgC,CAAA"}

package/dist/conditionals/index.js

@@ -35,25 +35,22 @@ __export(conditionals_exports, {
   createFieldConditionals: () => createFieldConditionals,
   defineConditional: () => defineConditional,
   defineFormConditional: () => defineFormConditional,
-  flag: () => flag,
   isFieldReference: () => isFieldReference,
   never: () => never,
   not: () => not,
   now: () => now,
   or: () => or,
-  status: () => status,
   user: () => user
 });
 module.exports = __toCommonJS(conditionals_exports);
-var z4 = __toESM(require("zod/v4"));
 
 // ../commons/src/conditionals/conditionals.ts
 var objectHash = __toESM(require("object-hash"));
 
 // ../commons/src/events/serializers/user/serializer.ts
-var z = __toESM(require("zod/v4"));
-var SerializedUserField = z.object({
-  $userField: z.enum([
+var import_zod = require("zod");
+var SerializedUserField = import_zod.z.object({
+  $userField: import_zod.z.enum([
     "id",
     "name",
     "role",
@@ -62,12 +59,11 @@ var SerializedUserField = z.object({
     "firstname",
     "middlename",
     "surname",
-    "signature",
-    "avatar",
-    "primaryOfficeId",
-    "administrativeAreaId"
+    "district",
+    "province",
+    "primaryOfficeId"
   ]),
-  $location: z.string().optional()
+  $location: import_zod.z.string().optional()
 });
 function userSerializer(userField) {
   return {
@@ -87,7 +83,7 @@ function userSerializer(userField) {
 }
 
 // ../commons/src/utils.ts
-var z2 = __toESM(require("zod/v4"));
+var z2 = __toESM(require("zod"));
 var FullNameV1 = z2.array(
   z2.object({
     use: z2.string(),
@@ -112,9 +108,9 @@ function omitKeyDeep(obj, keyToRemove) {
 }
 
 // ../commons/src/events/serializers/date/serializer.ts
-var import_zod = require("zod");
-var SerializedNowDateTime = import_zod.z.object({
-  $$now: import_zod.z.literal(true)
+var import_zod2 = require("zod");
+var SerializedNowDateTime = import_zod2.z.object({
+  $$now: import_zod2.z.literal(true)
 });
 function todayDateTimeValueSerializer() {
   return { $$now: true };
@@ -333,33 +329,6 @@ function defineComparison(field, value, keyword) {
     required: [field.$$field]
   });
 }
-function flag(flagvalue) {
-  return defineConditional({
-    type: "object",
-    properties: {
-      $flags: {
-        type: "array",
-        contains: {
-          type: "string",
-          const: flagvalue
-        }
-      }
-    },
-    required: ["$flags"]
-  });
-}
-function status(statusValue) {
-  return defineConditional({
-    type: "object",
-    properties: {
-      $status: {
-        type: "string",
-        const: statusValue
-      }
-    },
-    required: ["$status"]
-  });
-}
 function createFieldConditionals(fieldId) {
   const getDayRange = (field, days, clause, referenceDate) => ({
     type: "object",
@@ -713,6 +682,3 @@ function createFieldConditionals(fieldId) {
     })
   };
 }
-
-// src/conditionals/index.ts
-z4.globalRegistry.clear();

package/dist/events/deduplication.d.ts

@@ -7,25 +7,62 @@ export declare function field(fieldId: string): {
         fieldId: string;
         type: "fuzzy";
         options: {
-            fuzziness?: string | number | undefined;
             boost?: number | undefined;
+            matchAgainst?: string | undefined;
+            fuzziness?: string | number | undefined;
         } | undefined;
     };
     strictMatches: (options?: StrictMatcherOptions) => {
         fieldId: string;
         type: "strict";
         options: {
-            boost?: number | undefined;
             value?: string | undefined;
+            boost?: number | undefined;
+            matchAgainst?: string | undefined;
         } | undefined;
     };
+    /**
+    * Creates a date range matcher that finds records where date field fall within a specified range.
+    *
+    * By default, matches against the field specified in `field()` (e.g., 'mother.dob').
+    * When `matchAgainst` is provided, it overwrites the default field and searches against that field with OR logic .
+    *
+    * @param options - Configuration for the date range matching
+    * @param options.days - Number of days before and after the target date to search (creates a ±days range)
+    * @param options.pivot - Optional. Distance in days where relevance scoring drops by 50%. Defaults to ⌊(days * 2) / 3⌋
+    * @param options.boost - Optional. Scoring boost multiplier for matching results. Defaults to 1
+    * @param options.matchAgainst - Optional. Additional field to match against. When provided,
+    * the query matches if the field fall within the date range. The default field is always excluded in the search in that case.
+    *
+    * @returns A clause that matches records where at least one of the specified date field is within the range
+    *
+    * @example
+    * // Matches only against mother.dob (±365 days)
+    * field('mother.dob').dateRangeMatches({ days: 365 })
+    *
+    * @example
+    * // Matches against mother.age OR spouse.dob, not mother.dob
+    * field('mother.dob').dateRangeMatches({
+    *   days: 365,
+    *   matchAgainst: $field('mother.age')
+    * })
+    *
+    * @example
+    * // With custom pivot and boost
+    * field('mother.dob').dateRangeMatches({
+    *   days: 730,
+    *   pivot: 365,
+    *   boost: 2
+    * })
+    */
     dateRangeMatches: (options: DateRangeMatcherOptions) => {
         fieldId: string;
         type: "dateRange";
         options: {
             days: number;
-            pivot?: number | undefined;
             boost?: number | undefined;
+            matchAgainst?: string | undefined;
+            pivot?: number | undefined;
         };
     };
 };

package/dist/events/deduplication.js

@@ -58,6 +58,40 @@ function field(fieldId) {
       type: "strict",
       options
     }),
+    /**
+    * Creates a date range matcher that finds records where date field fall within a specified range.
+    *
+    * By default, matches against the field specified in `field()` (e.g., 'mother.dob').
+    * When `matchAgainst` is provided, it overwrites the default field and searches against that field with OR logic .
+    *
+    * @param options - Configuration for the date range matching
+    * @param options.days - Number of days before and after the target date to search (creates a ±days range)
+    * @param options.pivot - Optional. Distance in days where relevance scoring drops by 50%. Defaults to ⌊(days * 2) / 3⌋
+    * @param options.boost - Optional. Scoring boost multiplier for matching results. Defaults to 1
+    * @param options.matchAgainst - Optional. Additional field to match against. When provided,
+    * the query matches if the field fall within the date range. The default field is always excluded in the search in that case.
+    *
+    * @returns A clause that matches records where at least one of the specified date field is within the range
+    *
+    * @example
+    * // Matches only against mother.dob (±365 days)
+    * field('mother.dob').dateRangeMatches({ days: 365 })
+    *
+    * @example
+    * // Matches against mother.age OR spouse.dob, not mother.dob
+    * field('mother.dob').dateRangeMatches({
+    *   days: 365,
+    *   matchAgainst: $field('mother.age')
+    * })
+    *
+    * @example
+    * // With custom pivot and boost
+    * field('mother.dob').dateRangeMatches({
+    *   days: 730,
+    *   pivot: 365,
+    *   boost: 2
+    * })
+    */
     dateRangeMatches: (options) => ({
       fieldId,
       type: "dateRange",