@opencrvs/toolkit 1.8.0-rc.f7a451a → 1.8.0-rc.f7aaf07

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

@@ -1,6 +1,6 @@
 import { EventFieldId } from './AdvancedSearchConfig';
-import { EventMetadataKeys, EventMetadataParameter } from './EventMetadata';
 import { SelectOption } from './FieldConfig';
+import { WorkqueueColumnKeys, WorkqueueColumnValue } from './WorkqueueColumnConfig';
 /**
  * Creates a function that acts like a callable + static method container.
  *
@@ -47,7 +47,7 @@ declare function eventFn(fieldId: EventFieldId, options?: SelectOption[]): {
     };
 };
 declare const event: typeof eventFn & {
-    field(field: EventMetadataKeys): EventMetadataParameter;
+    field(field: WorkqueueColumnKeys): WorkqueueColumnValue;
     hasAction: (action: import("./ActionType").ActionType) => import("../conditionals/conditionals").JSONSchema;
 };
 export { event };

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

@@ -1,5 +1,6 @@
 import { FieldConditional } from './Conditional';
 import { TranslationConfig } from './TranslationConfig';
+import { ValidationConfig } from './FieldConfig';
 /**
  * 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.
@@ -7,10 +8,12 @@ import { TranslationConfig } from './TranslationConfig';
  */
 export declare function field(fieldId: string, options?: {
     conditionals?: FieldConditional[];
+    validations?: ValidationConfig[];
     searchCriteriaLabelPrefix?: TranslationConfig;
 }): {
     range: () => {
         conditionals?: FieldConditional[];
+        validations?: ValidationConfig[];
         searchCriteriaLabelPrefix?: TranslationConfig;
         fieldId: string;
         fieldType: "field";
@@ -21,6 +24,7 @@ export declare function field(fieldId: string, options?: {
     };
     exact: () => {
         conditionals?: FieldConditional[];
+        validations?: ValidationConfig[];
         searchCriteriaLabelPrefix?: TranslationConfig;
         fieldId: string;
         fieldType: "field";
@@ -31,6 +35,7 @@ export declare function field(fieldId: string, options?: {
     };
     fuzzy: () => {
         conditionals?: FieldConditional[];
+        validations?: ValidationConfig[];
         searchCriteriaLabelPrefix?: TranslationConfig;
         fieldId: string;
         fieldType: "field";
@@ -39,14 +44,14 @@ export declare function field(fieldId: string, options?: {
             type: "fuzzy";
         };
     };
+    $$field: string;
     isAfter: () => {
         days: (days: number) => {
             inPast: () => import("../conditionals/conditionals").JSONSchema;
             inFuture: () => import("../conditionals/conditionals").JSONSchema;
         };
         date: (date: string | {
-            [key: string]: unknown;
-            _fieldId: string;
+            $$field: string;
         }) => import("../conditionals/conditionals").JSONSchema;
         now: () => import("../conditionals/conditionals").JSONSchema;
     };
@@ -56,14 +61,12 @@ export declare function field(fieldId: string, options?: {
             inFuture: () => import("../conditionals/conditionals").JSONSchema;
         };
         date: (date: string | {
-            [key: string]: unknown;
-            _fieldId: string;
+            $$field: string;
         }) => import("../conditionals/conditionals").JSONSchema;
         now: () => import("../conditionals/conditionals").JSONSchema;
     };
     isEqualTo: (value: string | boolean | {
-        [key: string]: unknown;
-        _fieldId: string;
+        $$field: string;
     }) => import("../conditionals/conditionals").JSONSchema;
     isFalsy: () => import("../conditionals/conditionals").JSONSchema;
     isUndefined: () => import("../conditionals/conditionals").JSONSchema;
@@ -74,9 +77,6 @@ export declare function field(fieldId: string, options?: {
     getId: () => {
         fieldId: string;
     };
-    /**
-     * @private Internal property used for field reference tracking.
-     */
-    _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';
@@ -34,6 +35,7 @@ export * from './test.utils';
 export * from './TemplateConfig';
 export * from './scopes';
 export * from './serializer';
+export * from './state/availableActions';
 export * from '../conditionals/conditionals';
 export * from '../conditionals/validate';
 export * from './field';

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

@@ -1,5 +1,4 @@
 import { Scope } from '../scopes';
-import { ActionType } from './ActionType';
 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: {
@@ -40,6 +39,6 @@ export declare const ACTION_ALLOWED_CONFIGURABLE_SCOPES: {
     UNASSIGN: never[];
     DETECT_DUPLICATE: never[];
 };
+export declare const WRITE_ACTION_SCOPES: ("record.declare-birth" | "record.declaration-submit-for-approval" | "record.register" | "record.registration-print&issue-certified-copies")[];
 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/test.utils.d.ts

@@ -1,5 +1,5 @@
-import { ActionDocument, ActionUpdate, EventState } from './ActionDocument';
-import { ArchiveActionInput, AssignActionInput, DeclareActionInput, RegisterActionInput, RejectDeclarationActionInput, RequestCorrectionActionInput, UnassignActionInput, ValidateActionInput } from './ActionInput';
+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';
@@ -7,10 +7,27 @@ import { EventDocument } from './EventDocument';
 import { EventIndex } from './EventIndex';
 import { EventInput } from './EventInput';
 import { TranslationConfig } from './TranslationConfig';
+import { FieldConfig } from './FieldConfig';
 import { WorkqueueConfig } from './WorkqueueConfig';
-export declare function generateActionDeclarationInput(configuration: EventConfig, action: ActionType): EventState;
-export declare function generateActionAnnotationInput(configuration: EventConfig, action: ActionType): {};
-export declare const eventPayloadGenerator: {
+import { FieldValue } from './FieldValue';
+import { z } from 'zod';
+/**
+ * In real application, the roles are defined in the countryconfig.
+ * These are just for testing purposes to generate realistic mock data.
+ */
+export declare const TestUserRole: z.ZodEnum<["FIELD_AGENT", "LOCAL_REGISTRAR", "LOCAL_SYSTEM_ADMIN", "NATIONAL_REGISTRAR", "REGISTRATION_AGENT"]>;
+export type TestUserRole = z.infer<typeof TestUserRole>;
+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;
@@ -25,8 +42,7 @@ export declare const eventPayloadGenerator: {
         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;
@@ -43,6 +59,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;
@@ -65,20 +85,19 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | [string, 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;
@@ -93,6 +112,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;
@@ -115,11 +138,11 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | [string, 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;
@@ -136,6 +159,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;
@@ -158,8 +185,10 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | [string, string] | undefined>;
+            }[] | [string, string] | null | undefined>;
             annotation: {};
+            keepAssignment?: boolean | undefined;
+            type: "VALIDATE";
             duplicates: never[];
             eventId: string;
         };
@@ -177,26 +206,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;
@@ -213,6 +289,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;
@@ -235,19 +315,22 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | [string, 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 | {
@@ -265,6 +348,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;
@@ -287,40 +374,71 @@ export declare const eventPayloadGenerator: {
                     option: string;
                     filename: string;
                     originalFilename: string;
-                }[] | [string, 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>;
+    user?: Partial<{
+        signature: string;
+        primaryOfficeId: string;
+        role: TestUserRole;
+        id: string;
+    }>;
 }): 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?: EventState): Draft;
-export declare const eventQueryDataGenerator: (overrides?: Partial<EventIndex>) => EventIndex;
+export declare function generateEventDraftDocument({ eventId, actionType, rng, declaration }: {
+    eventId: string;
+    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