@opencrvs/toolkit 1.8.0-rc.f8a9481 → 1.8.0-rc.f8be155

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

@@ -0,0 +1,54 @@
+import { EventFieldId } from './AdvancedSearchConfig';
+import { SelectOption } from './FieldConfig';
+import { WorkqueueColumnKeys, WorkqueueColumnValue } from './WorkqueueColumnConfig';
+/**
+ * Creates a function that acts like a callable + static method container.
+ *
+ * @example
+ * event('status') // → returns search config
+ * event.hasAction('CLICKED') // → returns conditional
+ */
+declare function eventFn(fieldId: EventFieldId, options?: SelectOption[]): {
+    range: () => {
+        fieldId: "status" | "updatedAt" | "trackingId" | "legalStatus.REGISTERED.createdAt" | "legalStatus.REGISTERED.createdAtLocation";
+        options: {
+            value: string;
+            label: import("./TranslationConfig").TranslationConfig;
+        }[] | undefined;
+        fieldType: "event";
+    } & {
+        config: {
+            type: "range";
+        };
+    };
+    exact: () => {
+        fieldId: "status" | "updatedAt" | "trackingId" | "legalStatus.REGISTERED.createdAt" | "legalStatus.REGISTERED.createdAtLocation";
+        options: {
+            value: string;
+            label: import("./TranslationConfig").TranslationConfig;
+        }[] | undefined;
+        fieldType: "event";
+    } & {
+        config: {
+            type: "exact";
+        };
+    };
+    fuzzy: () => {
+        fieldId: "status" | "updatedAt" | "trackingId" | "legalStatus.REGISTERED.createdAt" | "legalStatus.REGISTERED.createdAtLocation";
+        options: {
+            value: string;
+            label: import("./TranslationConfig").TranslationConfig;
+        }[] | undefined;
+        fieldType: "event";
+    } & {
+        config: {
+            type: "fuzzy";
+        };
+    };
+};
+declare const event: typeof eventFn & {
+    field(field: WorkqueueColumnKeys): WorkqueueColumnValue;
+    hasAction: (action: import("./ActionType").ActionType) => import("../conditionals/conditionals").JSONSchema;
+};
+export { event };
+//# sourceMappingURL=event.d.ts.map

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

@@ -0,0 +1,77 @@
+import { FieldConditional } from './Conditional';
+import { TranslationConfig } from './TranslationConfig';
+/**
+ * Entry point for defining conditional logic or configuration for a form field.
+ * @param fieldId - The ID of the field to define rules or config for.
+ * @returns An object combining conditional methods and configuration builders.
+ */
+export declare function field(fieldId: string, options?: {
+    conditionals?: FieldConditional[];
+    searchCriteriaLabelPrefix?: TranslationConfig;
+}): {
+    range: () => {
+        conditionals?: FieldConditional[];
+        searchCriteriaLabelPrefix?: TranslationConfig;
+        fieldId: string;
+        fieldType: "field";
+    } & {
+        config: {
+            type: "range";
+        };
+    };
+    exact: () => {
+        conditionals?: FieldConditional[];
+        searchCriteriaLabelPrefix?: TranslationConfig;
+        fieldId: string;
+        fieldType: "field";
+    } & {
+        config: {
+            type: "exact";
+        };
+    };
+    fuzzy: () => {
+        conditionals?: FieldConditional[];
+        searchCriteriaLabelPrefix?: TranslationConfig;
+        fieldId: string;
+        fieldType: "field";
+    } & {
+        config: {
+            type: "fuzzy";
+        };
+    };
+    $$field: string;
+    isAfter: () => {
+        days: (days: number) => {
+            inPast: () => import("../conditionals/conditionals").JSONSchema;
+            inFuture: () => import("../conditionals/conditionals").JSONSchema;
+        };
+        date: (date: string | {
+            $$field: string;
+        }) => import("../conditionals/conditionals").JSONSchema;
+        now: () => import("../conditionals/conditionals").JSONSchema;
+    };
+    isBefore: () => {
+        days: (days: number) => {
+            inPast: () => import("../conditionals/conditionals").JSONSchema;
+            inFuture: () => import("../conditionals/conditionals").JSONSchema;
+        };
+        date: (date: string | {
+            $$field: string;
+        }) => import("../conditionals/conditionals").JSONSchema;
+        now: () => import("../conditionals/conditionals").JSONSchema;
+    };
+    isEqualTo: (value: string | boolean | {
+        $$field: string;
+    }) => import("../conditionals/conditionals").JSONSchema;
+    isFalsy: () => import("../conditionals/conditionals").JSONSchema;
+    isUndefined: () => import("../conditionals/conditionals").JSONSchema;
+    inArray: (values: string[]) => import("../conditionals/conditionals").JSONSchema;
+    isValidEnglishName: () => import("../conditionals/conditionals").JSONSchema;
+    matches: (pattern: string) => import("../conditionals/conditionals").JSONSchema;
+    isBetween: (min: number, max: number) => import("../conditionals/conditionals").JSONSchema;
+    getId: () => {
+        fieldId: string;
+    };
+    object: (options: Record<string, any>) => import("../conditionals/conditionals").JSONSchema;
+};
+//# sourceMappingURL=field.d.ts.map

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

@@ -1,3 +1,4 @@
+export * from './Constants';
 export * from './ActionConfig';
 export * from './offline';
 export * from './EventConfig';
@@ -6,6 +7,8 @@ export * from './FieldConfig';
 export * from './PageConfig';
 export * from './SummaryConfig';
 export * from './WorkqueueConfig';
+export * from './WorkqueueColumnConfig';
+export * from './workqueueDefaultColumns';
 export * from './Draft';
 export * from './EventMetadata';
 export * from './EventInput';
@@ -31,6 +34,9 @@ export * from './AdvancedSearchConfig';
 export * from './test.utils';
 export * from './TemplateConfig';
 export * from './scopes';
+export * from './serializer';
 export * from '../conditionals/conditionals';
 export * from '../conditionals/validate';
+export * from './field';
+export * from './event';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,7 @@
 import { Scope } from '../scopes';
 import { ActionType } from './ActionType';
-export declare function hasAnyOfScopes(a: Scope[], b: Scope[]): boolean;
 export declare const CONFIG_GET_ALLOWED_SCOPES: ["record.declare-birth", "record.read", "record.declaration-submit-incomplete", "record.declaration-submit-for-review", "record.register", "record.export-records", "config", "config.update:all"];
+export declare const CONFIG_SEARCH_ALLOWED_SCOPES: ("search.birth:my-jurisdiction" | "search.birth" | "search.death:my-jurisdiction" | "search.death" | "search.marriage:my-jurisdiction" | "search.marriage")[];
 export declare const ACTION_ALLOWED_SCOPES: {
     READ: ["record.declare-birth", "record.read", "record.declaration-submit-incomplete", "record.declaration-submit-for-review", "record.register", "record.export-records"];
     CREATE: ["record.declare-birth", "record.declaration-submit-incomplete", "record.declaration-submit-for-review"];
@@ -21,5 +21,25 @@ export declare const ACTION_ALLOWED_SCOPES: {
     UNASSIGN: null;
     DETECT_DUPLICATE: [];
 };
+export declare const ACTION_ALLOWED_CONFIGURABLE_SCOPES: {
+    READ: never[];
+    CREATE: "record.notify"[];
+    NOTIFY: "record.notify"[];
+    DECLARE: never[];
+    DELETE: never[];
+    VALIDATE: never[];
+    REGISTER: never[];
+    PRINT_CERTIFICATE: never[];
+    REQUEST_CORRECTION: never[];
+    REJECT_CORRECTION: never[];
+    APPROVE_CORRECTION: never[];
+    MARKED_AS_DUPLICATE: never[];
+    ARCHIVE: never[];
+    REJECT: never[];
+    ASSIGN: never[];
+    UNASSIGN: never[];
+    DETECT_DUPLICATE: never[];
+};
+export declare function hasAnyOfScopes(a: Scope[], b: Scope[]): boolean;
 export declare function filterUnallowedActions(actions: ActionType[], userScopes: Scope[]): ActionType[];
 //# sourceMappingURL=scopes.d.ts.map

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

@@ -0,0 +1,2 @@
+export { deserializeQuery } from './serializers/user/deserializer';
+//# sourceMappingURL=serializer.d.ts.map

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

@@ -1,53 +1,27 @@
-import { ActionDocument, ActionUpdate } from './ActionDocument';
-import { ArchiveActionInput, AssignActionInput, DeclareActionInput, RegisterActionInput, RejectDeclarationActionInput, RequestCorrectionActionInput, UnassignActionInput, ValidateActionInput } from './ActionInput';
+import { UUID } from '../uuid';
+import { ActionDocument, EventState } from './ActionDocument';
+import { ArchiveActionInput, AssignActionInput, DeclareActionInput, NotifyActionInput, RegisterActionInput, RejectDeclarationActionInput, RequestCorrectionActionInput, UnassignActionInput, ValidateActionInput } from './ActionInput';
 import { ActionType } from './ActionType';
 import { Draft } from './Draft';
 import { EventConfig } from './EventConfig';
 import { EventDocument } from './EventDocument';
 import { EventIndex } from './EventIndex';
 import { EventInput } from './EventInput';
-import { FieldValue } from './FieldValue';
 import { TranslationConfig } from './TranslationConfig';
-export declare function generateActionDeclarationInput(configuration: EventConfig, action: ActionType): import("lodash").Dictionary<string | number | boolean | {
-    type: string;
-    filename: string;
-    originalFilename: string;
-} | {
-    country: string;
-    district: string;
-    addressType: "DOMESTIC";
-    province: string;
-    urbanOrRural: "URBAN";
-    number?: string | undefined;
-    town?: string | undefined;
-    residentialArea?: string | undefined;
-    street?: string | undefined;
-    zipCode?: string | undefined;
-} | {
-    country: string;
-    district: string;
-    addressType: "DOMESTIC";
-    province: string;
-    urbanOrRural: "RURAL";
-    village?: string | undefined;
-} | {
-    country: string;
-    state: string;
-    addressType: "INTERNATIONAL";
-    district2: string;
-    cityOrTown?: string | undefined;
-    addressLine1?: string | undefined;
-    addressLine2?: string | undefined;
-    addressLine3?: string | undefined;
-    postcodeOrZip?: string | undefined;
-} | {
-    type: string;
-    option: string;
-    filename: string;
-    originalFilename: string;
-}[] | undefined>;
-export declare function generateActionAnnotationInput(configuration: EventConfig, action: ActionType): {};
-export declare const eventPayloadGenerator: {
+import { FieldConfig } from './FieldConfig';
+import { WorkqueueConfig } from './WorkqueueConfig';
+import { FieldValue } from './FieldValue';
+export declare function generateRandomName(rng: () => number): {
+    firstname: string;
+    surname: string;
+};
+/**
+ * Quick-and-dirty mock data generator for event actions.
+ */
+export declare function mapFieldTypeToMockValue(field: FieldConfig, i: number, rng: () => number): FieldValue;
+export declare function generateActionDeclarationInput(configuration: EventConfig, action: ActionType, rng: () => number): EventState;
+export declare function generateActionAnnotationInput(configuration: EventConfig, action: ActionType, rng: () => number): {};
+export declare function eventPayloadGenerator(rng: () => number): {
     create: (input?: Partial<EventInput>) => {
         transactionId: string;
         type: string;
@@ -58,12 +32,11 @@ export declare const eventPayloadGenerator: {
         id: string;
     };
     draft: ({ eventId, actionType }: {
-        eventId: string;
+        eventId: UUID;
         actionType: ActionType;
     }, input?: Partial<Draft>) => Draft;
     actions: {
-        declare: (eventId: string, input?: Partial<Pick<DeclareActionInput, "transactionId" | "declaration" | "annotation">>) => {
-            type: "DECLARE";
+        declare: (eventId: string, input?: Partial<Pick<DeclareActionInput, "transactionId" | "declaration" | "annotation" | "keepAssignment">>) => {
             transactionId: string;
             declaration: Record<string, string | number | boolean | {
                 type: string;
@@ -80,6 +53,10 @@ export declare const eventPayloadGenerator: {
                 residentialArea?: string | null | undefined;
                 street?: string | null | undefined;
                 zipCode?: string | null | undefined;
+            } | {
+                firstname: string;
+                surname: string;
+                middlename?: string | null | undefined;
             } | {
                 country: string;
                 district: string;
@@ -102,20 +79,19 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | undefined>;
+            }[] | [string, string] | null | undefined>;
             annotation: {};
+            keepAssignment?: boolean | undefined;
+            type: "DECLARE";
             eventId: string;
         };
         /**
          * Notify allows sending incomplete data. Think it as 'partial declare' for now.
          */
-        notify: (eventId: string, input?: {
-            transactionId?: string;
-            declaration?: Partial<ActionUpdate>;
-        }) => {
+        notify: (eventId: string, input?: Partial<Pick<NotifyActionInput, "transactionId" | "declaration" | "keepAssignment">>) => {
             type: "NOTIFY";
             transactionId: string;
-            declaration: Partial<Record<string, string | number | boolean | {
+            declaration: Record<string, string | number | boolean | {
                 type: string;
                 filename: string;
                 originalFilename: string;
@@ -130,6 +106,10 @@ export declare const eventPayloadGenerator: {
                 residentialArea?: string | null | undefined;
                 street?: string | null | undefined;
                 zipCode?: string | null | undefined;
+            } | {
+                firstname: string;
+                surname: string;
+                middlename?: string | null | undefined;
             } | {
                 country: string;
                 district: string;
@@ -152,11 +132,11 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | undefined>>;
+            }[] | [string, string] | null | undefined>;
             eventId: string;
+            keepAssignment: boolean | undefined;
         };
-        validate: (eventId: string, input?: Partial<Pick<ValidateActionInput, "transactionId" | "declaration" | "annotation">>) => {
-            type: "VALIDATE";
+        validate: (eventId: string, input?: Partial<Pick<ValidateActionInput, "transactionId" | "declaration" | "annotation" | "keepAssignment">>) => {
             transactionId: string;
             declaration: Record<string, string | number | boolean | {
                 type: string;
@@ -173,6 +153,10 @@ export declare const eventPayloadGenerator: {
                 residentialArea?: string | null | undefined;
                 street?: string | null | undefined;
                 zipCode?: string | null | undefined;
+            } | {
+                firstname: string;
+                surname: string;
+                middlename?: string | null | undefined;
             } | {
                 country: string;
                 district: string;
@@ -195,8 +179,10 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | undefined>;
+            }[] | [string, string] | null | undefined>;
             annotation: {};
+            keepAssignment?: boolean | undefined;
+            type: "VALIDATE";
             duplicates: never[];
             eventId: string;
         };
@@ -214,26 +200,73 @@ export declare const eventPayloadGenerator: {
             assignedTo: null;
             eventId: string;
         };
-        archive: (eventId: string, input?: Partial<Pick<ArchiveActionInput, "transactionId" | "declaration">>, isDuplicate?: boolean) => {
-            type: "ARCHIVE";
+        archive: (eventId: string, input?: Partial<Pick<ArchiveActionInput, "transactionId" | "declaration" | "keepAssignment">>, isDuplicate?: boolean) => {
             transactionId: string;
-            declaration: {};
-            annotation: {
-                isDuplicate: boolean;
-            };
+            declaration: Record<string, string | number | boolean | {
+                type: string;
+                filename: string;
+                originalFilename: string;
+            } | {
+                country: string;
+                district: string;
+                addressType: "DOMESTIC";
+                province: string;
+                urbanOrRural: "URBAN";
+                number?: string | null | undefined;
+                town?: string | null | undefined;
+                residentialArea?: string | null | undefined;
+                street?: string | null | undefined;
+                zipCode?: string | null | undefined;
+            } | {
+                firstname: string;
+                surname: string;
+                middlename?: string | null | undefined;
+            } | {
+                country: string;
+                district: string;
+                addressType: "DOMESTIC";
+                province: string;
+                urbanOrRural: "RURAL";
+                village?: string | null | undefined;
+            } | {
+                country: string;
+                state: string;
+                addressType: "INTERNATIONAL";
+                district2: string;
+                cityOrTown?: string | null | undefined;
+                addressLine1?: string | null | undefined;
+                addressLine2?: string | null | undefined;
+                addressLine3?: string | null | undefined;
+                postcodeOrZip?: string | null | undefined;
+            } | {
+                type: string;
+                option: string;
+                filename: string;
+                originalFilename: string;
+            }[] | [string, string] | null | undefined>;
+            keepAssignment?: boolean | undefined;
+            type: "ARCHIVE";
+            annotation: {};
             duplicates: never[];
             eventId: string;
+            reason: {
+                message: string;
+                isDuplicate: boolean;
+            };
         };
-        reject: (eventId: string, input?: Partial<Pick<RejectDeclarationActionInput, "transactionId" | "annotation">>) => {
-            type: "REJECT";
+        reject: (eventId: string, input?: Partial<Pick<RejectDeclarationActionInput, "transactionId" | "annotation" | "keepAssignment">>) => {
             transactionId: string;
-            declaration: {};
             annotation: {};
+            keepAssignment?: boolean | undefined;
+            type: "REJECT";
+            declaration: {};
             duplicates: never[];
             eventId: string;
+            reason: {
+                message: string;
+            };
         };
-        register: (eventId: string, input?: Partial<Pick<RegisterActionInput, "transactionId" | "declaration" | "annotation">>) => {
-            type: "REGISTER";
+        register: (eventId: string, input?: Partial<Pick<RegisterActionInput, "transactionId" | "declaration" | "annotation" | "keepAssignment">>) => {
             transactionId: string;
             declaration: Record<string, string | number | boolean | {
                 type: string;
@@ -250,6 +283,10 @@ export declare const eventPayloadGenerator: {
                 residentialArea?: string | null | undefined;
                 street?: string | null | undefined;
                 zipCode?: string | null | undefined;
+            } | {
+                firstname: string;
+                surname: string;
+                middlename?: string | null | undefined;
             } | {
                 country: string;
                 district: string;
@@ -272,19 +309,22 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | undefined>;
+            }[] | [string, string] | null | undefined>;
             annotation: {};
+            keepAssignment?: boolean | undefined;
+            type: "REGISTER";
             eventId: string;
         };
-        printCertificate: (eventId: string, input?: Partial<Pick<RegisterActionInput, "transactionId" | "annotation">>) => {
-            type: "PRINT_CERTIFICATE";
+        printCertificate: (eventId: string, input?: Partial<Pick<RegisterActionInput, "transactionId" | "annotation" | "keepAssignment">>) => {
             transactionId: string;
-            declaration: {};
             annotation: {};
+            keepAssignment?: boolean | undefined;
+            type: "PRINT_CERTIFICATE";
+            declaration: {};
             eventId: string;
         };
         correction: {
-            request: (eventId: string, input?: Partial<Pick<RequestCorrectionActionInput, "transactionId" | "declaration" | "annotation">>) => {
+            request: (eventId: string, input?: Partial<Pick<RequestCorrectionActionInput, "transactionId" | "declaration" | "annotation" | "keepAssignment">>) => {
                 type: "REQUEST_CORRECTION";
                 transactionId: string;
                 declaration: Record<string, string | number | boolean | {
@@ -302,6 +342,10 @@ export declare const eventPayloadGenerator: {
                     residentialArea?: string | null | undefined;
                     street?: string | null | undefined;
                     zipCode?: string | null | undefined;
+                } | {
+                    firstname: string;
+                    surname: string;
+                    middlename?: string | null | undefined;
                 } | {
                     country: string;
                     district: string;
@@ -324,39 +368,65 @@ export declare const eventPayloadGenerator: {
                     option: string;
                     filename: string;
                     originalFilename: string;
-                }[] | undefined>;
+                }[] | [string, string] | null | undefined>;
                 annotation: {};
                 eventId: string;
+                keepAssignment: boolean | undefined;
             };
-            approve: (eventId: string, requestId: string, input?: Partial<Pick<RequestCorrectionActionInput, "transactionId" | "annotation">>) => {
+            approve: (eventId: string, requestId: string, input?: Partial<Pick<RequestCorrectionActionInput, "transactionId" | "annotation" | "keepAssignment">>) => {
                 type: "APPROVE_CORRECTION";
                 transactionId: string;
                 declaration: {};
                 annotation: {};
                 eventId: string;
                 requestId: string;
+                keepAssignment: boolean | undefined;
             };
-            reject: (eventId: string, requestId: string, input?: Partial<Pick<RequestCorrectionActionInput, "transactionId" | "annotation">>) => {
+            reject: (eventId: string, requestId: string, input?: Partial<Pick<RequestCorrectionActionInput, "transactionId" | "annotation" | "keepAssignment">>) => {
                 type: "REJECT_CORRECTION";
                 transactionId: string;
                 declaration: {};
                 annotation: {};
                 eventId: string;
                 requestId: string;
+                keepAssignment: boolean | undefined;
             };
         };
     };
 };
-export declare function generateActionDocument({ configuration, action, defaults }: {
+export declare function generateActionDocument({ configuration, action, rng, defaults }: {
     configuration: EventConfig;
     action: ActionType;
+    rng?: () => number;
     defaults?: Partial<ActionDocument>;
 }): ActionDocument;
-export declare function generateEventDocument({ configuration, actions }: {
+export declare function generateEventDocument({ configuration, actions, rng }: {
     configuration: EventConfig;
     actions: ActionType[];
+    rng?: () => number;
 }): EventDocument;
-export declare function generateEventDraftDocument(eventId: string, actionType?: ActionType, declaration?: Record<string, FieldValue>): Draft;
-export declare const eventQueryDataGenerator: (overrides?: Partial<EventIndex>) => EventIndex;
+export declare function generateEventDraftDocument({ eventId, actionType, rng, declaration }: {
+    eventId: UUID;
+    actionType: ActionType;
+    rng?: () => number;
+    declaration?: EventState;
+}): Draft;
+export declare function getRandomDatetime(rng: () => number, start: Date, end: Date): string;
+export declare function getRandomDate(rng: () => number, start: string, end: string): string;
+/**
+ * Useful for testing when we need deterministic outcome.
+ * @param seed - Seed value for the pseudo-random number generator
+ *
+ * @returns A function that generates pseudo-random numbers between 0 and 1 [0, 1)
+ */
+export declare function createPrng(seed: number): () => number;
+export declare function generateRandomSignature(rng: () => number): string;
+export declare const eventQueryDataGenerator: (overrides?: Partial<EventIndex>, seed?: number) => EventIndex;
 export declare const generateTranslationConfig: (message: string) => TranslationConfig;
+export declare const BearerTokenByUserType: {
+    fieldAgent: string;
+    registrationAgent: string;
+    localRegistrar: string;
+};
+export declare const generateWorkqueues: (slug?: string) => WorkqueueConfig[];
 //# sourceMappingURL=test.utils.d.ts.map

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

@@ -1,2 +1,2 @@
-export declare function generateTransactionId(): import("../uuid").UUID;
+export declare function generateTransactionId(): string & import("zod").BRAND<"UUID">;
 //# sourceMappingURL=transactions.d.ts.map