@opencrvs/toolkit 1.9.6-rc.690a282 → 1.9.6-rc.6ae1b5a

package/dist/commons/conditionals/conditionals.d.ts

@@ -4,6 +4,7 @@ import { ITokenPayload as TokenPayload, Scope } from '../authentication';
 import { PartialSchema as AjvJSONSchemaType } from 'ajv/dist/types/json-schema';
 import { userSerializer } from '../events/serializers/user/serializer';
 import { UUID } from '../uuid';
+import { todayDateTimeValueSerializer } from '../events/serializers/date/serializer';
 /** @knipignore */
 export type JSONSchema = {
     $id: string;
@@ -64,6 +65,10 @@ type FieldReference = {
     $$field: string;
     $$subfield: string[];
 };
+/**
+ * Generate conditional rules for current date
+ */
+export declare const now: typeof todayDateTimeValueSerializer;
 /**
  *
  * Generate conditional rules for user.

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

@@ -119,14 +119,32 @@ declare const DateRangeMatcher: z.ZodObject<z.objectUtil.extendShape<{
         pivot: z.ZodOptional<z.ZodNumber>;
         days: z.ZodNumber;
         boost: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        matchAgainst: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            $$field: z.ZodEffects<z.ZodString, string, string>;
+            $$subfield: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            $$field: string;
+            $$subfield?: string[] | undefined;
+        }, {
+            $$field: string;
+            $$subfield?: string[] | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         boost: number;
         days: number;
         pivot?: number | undefined;
+        matchAgainst?: {
+            $$field: string;
+            $$subfield?: string[] | undefined;
+        }[] | undefined;
     }, {
         days: number;
         boost?: number | undefined;
         pivot?: number | undefined;
+        matchAgainst?: {
+            $$field: string;
+            $$subfield?: string[] | undefined;
+        }[] | undefined;
     }>;
 }>, "strip", z.ZodTypeAny, {
     type: "dateRange";
@@ -134,6 +152,10 @@ declare const DateRangeMatcher: z.ZodObject<z.objectUtil.extendShape<{
         boost: number;
         days: number;
         pivot?: number | undefined;
+        matchAgainst?: {
+            $$field: string;
+            $$subfield?: string[] | undefined;
+        }[] | undefined;
     };
     fieldId: string;
 }, {
@@ -142,6 +164,10 @@ declare const DateRangeMatcher: z.ZodObject<z.objectUtil.extendShape<{
         days: number;
         boost?: number | undefined;
         pivot?: number | undefined;
+        matchAgainst?: {
+            $$field: string;
+            $$subfield?: string[] | undefined;
+        }[] | undefined;
     };
     fieldId: string;
 }>;

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

@@ -1768,7 +1768,13 @@ declare const DateField: z.ZodObject<z.objectUtil.extendShape<{
     analytics: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, {
     type: z.ZodLiteral<"DATE">;
-    defaultValue: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        $$now: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        $$now: true;
+    }, {
+        $$now: true;
+    }>, z.ZodString]>>;
     configuration: z.ZodOptional<z.ZodObject<{
         notice: z.ZodOptional<z.ZodObject<import("./TranslationConfig").MessageDescriptorZod, "strip", z.ZodTypeAny, TranslationConfig, {
             id: string;
@@ -1825,7 +1831,9 @@ declare const DateField: z.ZodObject<z.objectUtil.extendShape<{
     hideLabel?: boolean | undefined;
     uncorrectable?: boolean | undefined;
     analytics?: boolean | undefined;
-    defaultValue?: string | undefined;
+    defaultValue?: string | {
+        $$now: true;
+    } | undefined;
     configuration?: {
         notice?: TranslationConfig | undefined;
     } | undefined;
@@ -1890,7 +1898,9 @@ declare const DateField: z.ZodObject<z.objectUtil.extendShape<{
     hideLabel?: boolean | undefined;
     uncorrectable?: boolean | undefined;
     analytics?: boolean | undefined;
-    defaultValue?: string | undefined;
+    defaultValue?: string | {
+        $$now: true;
+    } | undefined;
     configuration?: {
         notice?: {
             id: string;
@@ -2265,7 +2275,13 @@ declare const TimeField: z.ZodObject<z.objectUtil.extendShape<{
     analytics: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, {
     type: z.ZodLiteral<"TIME">;
-    defaultValue: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        $$now: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        $$now: true;
+    }, {
+        $$now: true;
+    }>, z.ZodString]>>;
     configuration: z.ZodOptional<z.ZodObject<{
         use12HourFormat: z.ZodOptional<z.ZodBoolean>;
         notice: z.ZodOptional<z.ZodObject<import("./TranslationConfig").MessageDescriptorZod, "strip", z.ZodTypeAny, TranslationConfig, {
@@ -2325,7 +2341,9 @@ declare const TimeField: z.ZodObject<z.objectUtil.extendShape<{
     hideLabel?: boolean | undefined;
     uncorrectable?: boolean | undefined;
     analytics?: boolean | undefined;
-    defaultValue?: string | undefined;
+    defaultValue?: string | {
+        $$now: true;
+    } | undefined;
     configuration?: {
         notice?: TranslationConfig | undefined;
         use12HourFormat?: boolean | undefined;
@@ -2391,7 +2409,9 @@ declare const TimeField: z.ZodObject<z.objectUtil.extendShape<{
     hideLabel?: boolean | undefined;
     uncorrectable?: boolean | undefined;
     analytics?: boolean | undefined;
-    defaultValue?: string | undefined;
+    defaultValue?: string | {
+        $$now: true;
+    } | undefined;
     configuration?: {
         notice?: {
             id: string;

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

@@ -230,6 +230,15 @@ export declare function mapFieldTypeToZod(field: FieldConfig, actionType?: Actio
 }, {
     data?: any;
 }>>> | z.ZodObject<{
+    numericValue: z.ZodNumber;
+    unit: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    numericValue: number;
+    unit: string;
+}, {
+    numericValue: number;
+    unit: string;
+}> | z.ZodObject<{
     numericValue: z.ZodOptional<z.ZodNumber>;
     unit: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -239,6 +248,15 @@ export declare function mapFieldTypeToZod(field: FieldConfig, actionType?: Actio
     numericValue?: number | undefined;
     unit?: string | undefined;
 }> | z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    numericValue: z.ZodNumber;
+    unit: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    numericValue: number;
+    unit: string;
+}, {
+    numericValue: number;
+    unit: string;
+}>>> | z.ZodOptional<z.ZodNullable<z.ZodObject<{
     numericValue: z.ZodOptional<z.ZodNumber>;
     unit: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {

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

@@ -38,6 +38,7 @@ export declare const AgeUpdateValue: z.ZodNullable<z.ZodOptional<z.ZodObject<{
     asOfDateRef: string;
 }>>>;
 export declare const TimeValue: z.ZodString;
+export type TimeValue = z.infer<typeof TimeValue>;
 export declare const DatetimeValue: z.ZodString;
 export declare const SelectDateRangeValue: z.ZodEnum<["last7Days", "last30Days", "last90Days", "last365Days"]>;
 export declare const DateRangeFieldValue: z.ZodUnion<[z.ZodObject<{

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

@@ -19,6 +19,47 @@ export declare function field(fieldId: string): {
             boost?: number | undefined;
         } | undefined;
     };
+    /**
+     * Creates a date range matcher that finds records where date fields 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 across multiple fields 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 fields to match against. When provided,
+     * the query matches if any of these fields fall within the date range. The default field is always excluded in the search in that case.
+     * If you want to add the default field, you have to explicitly add that field in `matchAgainst` option
+     *
+     * @returns A clause that matches records where at least one of the specified date fields 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'), $field('spouse.dob')]
+     * })
+     *
+     * If you want to add mother.dob, then
+     * field('mother.dob').dateRangeMatches({
+     *   days: 365,
+     *   matchAgainst: [$field('mother.age'), $field('spouse.dob'), $field('mother.dob')]
+     * })
+     *
+     * @example
+     * // With custom pivot and boost
+     * field('mother.dob').dateRangeMatches({
+     *   days: 730,
+     *   pivot: 365,
+     *   boost: 2
+     * })
+     */
     dateRangeMatches: (options: DateRangeMatcherOptions) => {
         fieldId: string;
         type: "dateRange";
@@ -26,6 +67,10 @@ export declare function field(fieldId: string): {
             days: number;
             boost?: number | undefined;
             pivot?: number | undefined;
+            matchAgainst?: {
+                $$field: string;
+                $$subfield?: string[] | undefined;
+            }[] | undefined;
         };
     };
 };

package/dist/conditionals/index.js

@@ -38,6 +38,7 @@ __export(conditionals_exports, {
   isFieldReference: () => isFieldReference,
   never: () => never,
   not: () => not,
+  now: () => now,
   or: () => or,
   user: () => user
 });
@@ -106,6 +107,15 @@ function omitKeyDeep(obj, keyToRemove) {
   return newObj;
 }
 
+// ../commons/src/events/serializers/date/serializer.ts
+var import_zod2 = require("zod");
+var SerializedNowDateTime = import_zod2.z.object({
+  $$now: import_zod2.z.literal(true)
+});
+function todayDateTimeValueSerializer() {
+  return { $$now: true };
+}
+
 // ../commons/src/conditionals/conditionals.ts
 function defineConditional(schema) {
   const schemaWithooutIDRef = omitKeyDeep(schema, "$id");
@@ -179,6 +189,7 @@ function wrapToPathOptional(condition, path) {
     };
   }, condition);
 }
+var now = Object.assign(todayDateTimeValueSerializer, {});
 var user = Object.assign(userSerializer, {
   hasScope: (scope) => defineConditional({
     type: "object",

package/dist/events/deduplication.d.ts

@@ -19,6 +19,47 @@ export declare function field(fieldId: string): {
             boost?: number | undefined;
         } | undefined;
     };
+    /**
+     * Creates a date range matcher that finds records where date fields 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 across multiple fields 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 fields to match against. When provided,
+     * the query matches if any of these fields fall within the date range. The default field is always excluded in the search in that case.
+     * If you want to add the default field, you have to explicitly add that field in `matchAgainst` option
+     *
+     * @returns A clause that matches records where at least one of the specified date fields 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'), $field('spouse.dob')]
+     * })
+     *
+     * If you want to add mother.dob, then
+     * field('mother.dob').dateRangeMatches({
+     *   days: 365,
+     *   matchAgainst: [$field('mother.age'), $field('spouse.dob'), $field('mother.dob')]
+     * })
+     *
+     * @example
+     * // With custom pivot and boost
+     * field('mother.dob').dateRangeMatches({
+     *   days: 730,
+     *   pivot: 365,
+     *   boost: 2
+     * })
+     */
     dateRangeMatches: (options: DateRangeMatcherOptions) => {
         fieldId: string;
         type: "dateRange";
@@ -26,6 +67,10 @@ export declare function field(fieldId: string): {
             days: number;
             boost?: number | undefined;
             pivot?: number | undefined;
+            matchAgainst?: {
+                $$field: string;
+                $$subfield?: string[] | undefined;
+            }[] | undefined;
         };
     };
 };

package/dist/events/deduplication.js

@@ -58,6 +58,47 @@ function field(fieldId) {
       type: "strict",
       options
     }),
+    /**
+     * Creates a date range matcher that finds records where date fields 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 across multiple fields 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 fields to match against. When provided,
+     * the query matches if any of these fields fall within the date range. The default field is always excluded in the search in that case.
+     * If you want to add the default field, you have to explicitly add that field in `matchAgainst` option
+     *
+     * @returns A clause that matches records where at least one of the specified date fields 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'), $field('spouse.dob')]
+     * })
+     *
+     * If you want to add mother.dob, then
+     * field('mother.dob').dateRangeMatches({
+     *   days: 365,
+     *   matchAgainst: [$field('mother.age'), $field('spouse.dob'), $field('mother.dob')]
+     * })
+     *
+     * @example
+     * // With custom pivot and boost
+     * field('mother.dob').dateRangeMatches({
+     *   days: 730,
+     *   pivot: 365,
+     *   boost: 2
+     * })
+     */
     dateRangeMatches: (options) => ({
       fieldId,
       type: "dateRange",