@opencrvs/toolkit 1.8.0-rc.feef45c → 1.8.0-rc.fef0fdd

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

@@ -1,5 +1,6 @@
 import { EventFieldId } from './AdvancedSearchConfig';
 import { SelectOption } from './FieldConfig';
+import { WorkqueueColumnKeys, WorkqueueColumnValue } from './WorkqueueColumnConfig';
 /**
  * Creates a function that acts like a callable + static method container.
  *
@@ -8,17 +9,45 @@ import { SelectOption } from './FieldConfig';
  * event.hasAction('CLICKED') // → returns conditional
  */
 declare function eventFn(fieldId: EventFieldId, options?: SelectOption[]): {
-    fieldId: "status" | "trackingId";
-    options: {
-        value: string;
-        label: import("./TranslationConfig").TranslationConfig;
-    }[] | undefined;
-    config: {
-        type: "EXACT";
+    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";
+        };
     };
-    fieldType: "event";
 };
 declare const event: typeof eventFn & {
+    field(field: WorkqueueColumnKeys): WorkqueueColumnValue;
     hasAction: (action: import("./ActionType").ActionType) => import("../conditionals/conditionals").JSONSchema;
 };
 export { event };

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

@@ -1,38 +1,57 @@
+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.
  * @returns An object combining conditional methods and configuration builders.
  */
-export declare function field(fieldId: string): {
+export declare function field(fieldId: string, options?: {
+    conditionals?: FieldConditional[];
+    validations?: ValidationConfig[];
+    searchCriteriaLabelPrefix?: TranslationConfig;
+}): {
     range: () => {
-        config: {
-            type: "RANGE";
-        };
+        conditionals?: FieldConditional[];
+        validations?: ValidationConfig[];
+        searchCriteriaLabelPrefix?: TranslationConfig;
         fieldId: string;
         fieldType: "field";
-    };
-    exact: () => {
+    } & {
         config: {
-            type: "EXACT";
+            type: "range";
         };
+    };
+    exact: () => {
+        conditionals?: FieldConditional[];
+        validations?: ValidationConfig[];
+        searchCriteriaLabelPrefix?: TranslationConfig;
         fieldId: string;
         fieldType: "field";
-    };
-    fuzzy: () => {
+    } & {
         config: {
-            type: "FUZZY";
+            type: "exact";
         };
+    };
+    fuzzy: () => {
+        conditionals?: FieldConditional[];
+        validations?: ValidationConfig[];
+        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 | {
-            [key: string]: unknown;
-            _fieldId: string;
+            $$field: string;
         }) => import("../conditionals/conditionals").JSONSchema;
         now: () => import("../conditionals/conditionals").JSONSchema;
     };
@@ -42,14 +61,12 @@ export declare function field(fieldId: string): {
             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;
@@ -60,9 +77,6 @@ export declare function field(fieldId: string): {
     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';
@@ -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,8 @@ export * from './AdvancedSearchConfig';
 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,6 +1,4 @@
 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: {
@@ -22,5 +20,25 @@ export declare const ACTION_ALLOWED_SCOPES: {
     UNASSIGN: null;
     DETECT_DUPLICATE: [];
 };
-export declare function filterUnallowedActions(actions: ActionType[], userScopes: Scope[]): ActionType[];
+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 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;
 //# 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,16 +1,34 @@
-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): Partial<import("./ActionDocument").EventState>;
-export declare function generateActionAnnotationInput(configuration: EventConfig, action: ActionType): {};
-export declare const eventPayloadGenerator: {
+import { FieldConfig } from './FieldConfig';
+import { WorkqueueConfig } from './WorkqueueConfig';
+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;
@@ -21,12 +39,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;
@@ -43,6 +60,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 +86,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;
@@ -93,6 +113,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 +139,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;
@@ -136,6 +160,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 +186,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;
         };
@@ -177,26 +207,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" | "registrationNumber">>) => {
             transactionId: string;
             declaration: Record<string, string | number | boolean | {
                 type: string;
@@ -213,6 +290,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 +316,23 @@ export declare const eventPayloadGenerator: {
                 option: string;
                 filename: string;
                 originalFilename: string;
-            }[] | undefined>;
+            }[] | [string, string] | null | undefined>;
             annotation: {};
+            registrationNumber?: string | undefined;
+            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 +350,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,39 +376,79 @@ 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, user }: {
     configuration: EventConfig;
     action: ActionType;
+    rng?: () => number;
     defaults?: Partial<ActionDocument>;
+    user?: Partial<{
+        signature: string;
+        primaryOfficeId: UUID;
+        role: TestUserRole;
+        id: string;
+    }>;
 }): ActionDocument;
-export declare function generateEventDocument({ configuration, actions }: {
+export declare function generateEventDocument({ configuration, actions, rng, user }: {
     configuration: EventConfig;
     actions: ActionType[];
+    rng?: () => number;
+    user?: Partial<{
+        signature: string;
+        primaryOfficeId: UUID;
+        role: TestUserRole;
+        id: string;
+    }>;
 }): 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 generateUuid(rng?: () => number): UUID;
+export declare function generateRegistrationNumber(rng: () => number): string;
+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