law-common 14.1.1 → 14.1.2-beta.1

package/dist/src/api/index.d.ts

@@ -20,8 +20,6 @@ export * from "./interface/reimbursement_expense.update.dto.interface";
 export * from "./interface/billing_reimbursement_expense.create.dto.interface";
 export * from "./interface/billing_reimbursement_expense.filter.dto.interface";
 export * from "./interface/billing_reimbursement_expense.update.dto.interface";
-export * from "./interface/expense_type.create.dto.interface";
-export * from "./interface/expense_type.update.dto.interface";
 export * from "./interface/expense_type.entity.response";
 export * from "./interface/billing.create.dto.interface";
 export * from "./interface/billing_particular_line_item.create.dto.interface";

package/dist/src/api/index.js

@@ -59,8 +59,6 @@ __exportStar(require("./interface/reimbursement_expense.update.dto.interface"),
 __exportStar(require("./interface/billing_reimbursement_expense.create.dto.interface"), exports);
 __exportStar(require("./interface/billing_reimbursement_expense.filter.dto.interface"), exports);
 __exportStar(require("./interface/billing_reimbursement_expense.update.dto.interface"), exports);
-__exportStar(require("./interface/expense_type.create.dto.interface"), exports);
-__exportStar(require("./interface/expense_type.update.dto.interface"), exports);
 __exportStar(require("./interface/expense_type.entity.response"), exports);
 __exportStar(require("./interface/billing.create.dto.interface"), exports);
 __exportStar(require("./interface/billing_particular_line_item.create.dto.interface"), exports);

package/dist/src/api/v1/index.d.ts

@@ -5,5 +5,7 @@
  * generator never writes to this directory (checklist 12.4). An entity appears either in
  * api/interface/ or in v1 + v2 - never both.
  */
+export * from "./interface/expense_type.create.dto.interface";
+export * from "./interface/expense_type.update.dto.interface";
 export * from "./interface/to_do_list.create.dto.interface";
 export * from "./interface/to_do_list.update.dto.interface";

package/dist/src/api/v1/index.js

@@ -21,5 +21,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * generator never writes to this directory (checklist 12.4). An entity appears either in
  * api/interface/ or in v1 + v2 - never both.
  */
+__exportStar(require("./interface/expense_type.create.dto.interface"), exports);
+__exportStar(require("./interface/expense_type.update.dto.interface"), exports);
 __exportStar(require("./interface/to_do_list.create.dto.interface"), exports);
 __exportStar(require("./interface/to_do_list.update.dto.interface"), exports);

package/dist/src/api/{interface → v1/interface}/expense_type.create.dto.interface.d.ts

@@ -1,4 +1,4 @@
-import { ExpenseTypeEnum } from "../../entities";
+import { ExpenseTypeEnum } from "../../../entities";
 export interface IExpenseTypeCreateDto {
     name: string;
     description?: string;

package/dist/src/api/{interface → v1/interface}/expense_type.update.dto.interface.d.ts

@@ -1,4 +1,4 @@
-import { ExpenseTypeEnum, IExpenseTypeEntity } from "../../entities";
+import { ExpenseTypeEnum, IExpenseTypeEntity } from "../../../entities";
 export interface IExpenseTypeUpdateDto {
     name?: string;
     description?: string;

package/dist/src/api/v2/index.d.ts

@@ -9,3 +9,5 @@
  */
 export * from "./interface/to_do_list.create.dto.interface";
 export * from "./interface/to_do_list.update.dto.interface";
+export * from "./interface/expense_type.create.dto.interface";
+export * from "./interface/expense_type.update.dto.interface";

package/dist/src/api/v2/index.js

@@ -27,3 +27,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // };
 __exportStar(require("./interface/to_do_list.create.dto.interface"), exports);
 __exportStar(require("./interface/to_do_list.update.dto.interface"), exports);
+__exportStar(require("./interface/expense_type.create.dto.interface"), exports);
+__exportStar(require("./interface/expense_type.update.dto.interface"), exports);

package/dist/src/api/v2/interface/expense_type.create.dto.interface.d.ts

@@ -0,0 +1,5 @@
+import { IEntityCreateDto } from "../../../entities";
+import { IExpenseTypeEntity } from "../../../entities/interface/expense_type.entity.interface";
+export type IExpenseTypeCreateExclude = "status";
+export interface IExpenseTypeCreateDto extends Omit<IEntityCreateDto<IExpenseTypeEntity>, IExpenseTypeCreateExclude> {
+}

package/dist/src/api/v2/interface/expense_type.create.dto.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/api/v2/interface/expense_type.update.dto.interface.d.ts

@@ -0,0 +1,12 @@
+import { DeepPartialButRequired } from "../../interface/api.utils.interface";
+import { ExpenseTypeActionEnum } from "../../../entities";
+import { IExpenseTypeCreateDto } from "./expense_type.create.dto.interface";
+export type IExpenseTypeUpdateDto = DeepPartialButRequired<IExpenseTypeCreateDto, never> & {
+    actionData: IExpenseTypeActionDataDto;
+} & {
+    id?: number;
+};
+export interface IExpenseTypeActionDataDto {
+    action: ExpenseTypeActionEnum;
+    remark?: string;
+}

package/dist/src/api/v2/interface/expense_type.update.dto.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/entities/flow-configs/expense_type_flow.config.d.ts

@@ -1,6 +1,39 @@
 import { FlowConfig } from "./flow-config.type";
-import { ExpenseTypeActionEnum } from "../enums/expense_type_action_enum";
+import { ExpenseTypeActionEnum } from "../../entities";
 import { ExpenseTypeStatusEnum } from "../enums/expense_type_status_enum";
+import { PermissionGroupEnum } from "../enums/permission_group_enum";
 export interface IExpenseTypeFlowConfigContextData {
 }
+export declare const ACTION_MAP: {
+    CREATE: {
+        reachableStatues: readonly [ExpenseTypeStatusEnum.APPROVED];
+        permissions: string[];
+        group: PermissionGroupEnum.CREATE;
+    };
+    UPDATE: {
+        reachableStatues: readonly [ExpenseTypeStatusEnum.APPROVED];
+        permissions: string[];
+        group: PermissionGroupEnum.UPDATE;
+    };
+    DELETE: {
+        reachableStatues: readonly [ExpenseTypeStatusEnum.DELETED];
+        permissions: string[];
+        group: PermissionGroupEnum.DELETE;
+    };
+    DEACTIVATE: {
+        reachableStatues: readonly [ExpenseTypeStatusEnum.DEACTIVATED];
+        permissions: string[];
+        group: PermissionGroupEnum.UPDATE;
+    };
+    ACTIVATE: {
+        reachableStatues: readonly [ExpenseTypeStatusEnum.APPROVED];
+        permissions: string[];
+        group: PermissionGroupEnum.UPDATE;
+    };
+    RESTORE: {
+        reachableStatues: readonly [ExpenseTypeStatusEnum.APPROVED];
+        permissions: string[];
+        group: PermissionGroupEnum.UPDATE;
+    };
+};
 export declare const expenseTypeFlowConfig: FlowConfig<ExpenseTypeStatusEnum, ExpenseTypeActionEnum, IExpenseTypeFlowConfigContextData>;

package/dist/src/entities/flow-configs/expense_type_flow.config.js

@@ -1,70 +1,85 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expenseTypeFlowConfig = void 0;
+exports.expenseTypeFlowConfig = exports.ACTION_MAP = void 0;
 const base_flow_config_factory_1 = require("./base-flow-config.factory");
-const expense_type_action_enum_1 = require("../enums/expense_type_action_enum");
+const entities_1 = require("../../entities");
 const expense_type_status_enum_1 = require("../enums/expense_type_status_enum");
+const permission_group_enum_1 = require("../enums/permission_group_enum");
 const EXPENSE_TYPE_CREATE_PERMISSION = ["EXPENSE_TYPE_CREATE"];
 const EXPENSE_TYPE_UPDATE_PERMISSION = ["EXPENSE_TYPE_UPDATE"];
 const EXPENSE_TYPE_DELETE_PERMISSION = ["EXPENSE_TYPE_DELETE"];
 const EXPENSE_TYPE_DEACTIVATE_PERMISSION = ["EXPENSE_TYPE_DEACTIVATE"];
 const EXPENSE_TYPE_ACTIVATE_PERMISSION = ["EXPENSE_TYPE_ACTIVATE"];
 const EXPENSE_TYPE_RESTORE_PERMISSION = ["EXPENSE_TYPE_RESTORE"];
-const ACTION_MAP = {
-    [expense_type_action_enum_1.ExpenseTypeActionEnum.CREATE]: {
+// Every action declares its group. expense_type_bulk_update.transaction.ts reads `group` to pick the
+// permission a dto is authorised under and refuses to default an absent one, so all six must be
+// annotated for any transition to keep working.
+//
+// The three lifecycle actions share the UPDATE group because that is where `derivePermissionGroup`
+// classifies them — matching work_from_home_flow.config.ts, where RECALL is likewise UPDATE. They are
+// still distinguished by `permissions` above, which `getNextStatus` consults per action, so grouping
+// them together narrows nothing.
+exports.ACTION_MAP = {
+    [entities_1.ExpenseTypeActionEnum.CREATE]: {
         reachableStatues: [expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED],
         permissions: EXPENSE_TYPE_CREATE_PERMISSION,
+        group: permission_group_enum_1.PermissionGroupEnum.CREATE,
     },
-    [expense_type_action_enum_1.ExpenseTypeActionEnum.UPDATE]: {
+    [entities_1.ExpenseTypeActionEnum.UPDATE]: {
         reachableStatues: [expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED],
         permissions: EXPENSE_TYPE_UPDATE_PERMISSION,
+        group: permission_group_enum_1.PermissionGroupEnum.UPDATE,
     },
-    [expense_type_action_enum_1.ExpenseTypeActionEnum.DELETE]: {
+    [entities_1.ExpenseTypeActionEnum.DELETE]: {
         reachableStatues: [expense_type_status_enum_1.ExpenseTypeStatusEnum.DELETED],
         permissions: EXPENSE_TYPE_DELETE_PERMISSION,
+        group: permission_group_enum_1.PermissionGroupEnum.DELETE,
     },
-    [expense_type_action_enum_1.ExpenseTypeActionEnum.DEACTIVATE]: {
+    [entities_1.ExpenseTypeActionEnum.DEACTIVATE]: {
         reachableStatues: [expense_type_status_enum_1.ExpenseTypeStatusEnum.DEACTIVATED],
         permissions: EXPENSE_TYPE_DEACTIVATE_PERMISSION,
+        group: permission_group_enum_1.PermissionGroupEnum.UPDATE,
     },
-    [expense_type_action_enum_1.ExpenseTypeActionEnum.ACTIVATE]: {
+    [entities_1.ExpenseTypeActionEnum.ACTIVATE]: {
         reachableStatues: [expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED],
         permissions: EXPENSE_TYPE_ACTIVATE_PERMISSION,
+        group: permission_group_enum_1.PermissionGroupEnum.UPDATE,
     },
-    [expense_type_action_enum_1.ExpenseTypeActionEnum.RESTORE]: {
+    [entities_1.ExpenseTypeActionEnum.RESTORE]: {
         reachableStatues: [expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED],
         permissions: EXPENSE_TYPE_RESTORE_PERMISSION,
+        group: permission_group_enum_1.PermissionGroupEnum.UPDATE,
     },
 };
-const { createActionConfig } = (0, base_flow_config_factory_1.createFlowConfigFactory)()(ACTION_MAP);
+const { createActionConfig } = (0, base_flow_config_factory_1.createFlowConfigFactory)()(exports.ACTION_MAP);
 // APPROVED status transitions
-const transitionApprovedStatusUpdateAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.UPDATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
-const transitionApprovedStatusDeleteAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.DELETE, expense_type_status_enum_1.ExpenseTypeStatusEnum.DELETED);
-const transitionApprovedStatusDeactivateAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.DEACTIVATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.DEACTIVATED);
+const transitionApprovedStatusUpdateAction = createActionConfig(entities_1.ExpenseTypeActionEnum.UPDATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
+const transitionApprovedStatusDeleteAction = createActionConfig(entities_1.ExpenseTypeActionEnum.DELETE, expense_type_status_enum_1.ExpenseTypeStatusEnum.DELETED);
+const transitionApprovedStatusDeactivateAction = createActionConfig(entities_1.ExpenseTypeActionEnum.DEACTIVATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.DEACTIVATED);
 // DEACTIVATED status transitions
-const transitionDeactivatedStatusDeleteAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.DELETE, expense_type_status_enum_1.ExpenseTypeStatusEnum.DELETED);
-const transitionDeactivatedStatusActivateAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.ACTIVATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
+const transitionDeactivatedStatusDeleteAction = createActionConfig(entities_1.ExpenseTypeActionEnum.DELETE, expense_type_status_enum_1.ExpenseTypeStatusEnum.DELETED);
+const transitionDeactivatedStatusActivateAction = createActionConfig(entities_1.ExpenseTypeActionEnum.ACTIVATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
 // DELETED status transitions
-const transitionDeletedStatusUpdateAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.UPDATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
-const transitionDeletedStatusRestoreAction = createActionConfig(expense_type_action_enum_1.ExpenseTypeActionEnum.RESTORE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
+const transitionDeletedStatusUpdateAction = createActionConfig(entities_1.ExpenseTypeActionEnum.UPDATE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
+const transitionDeletedStatusRestoreAction = createActionConfig(entities_1.ExpenseTypeActionEnum.RESTORE, expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED);
 exports.expenseTypeFlowConfig = {
     [expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED]: {
         actions: {
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.UPDATE]: transitionApprovedStatusUpdateAction,
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.DELETE]: transitionApprovedStatusDeleteAction,
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.DEACTIVATE]: transitionApprovedStatusDeactivateAction,
+            [entities_1.ExpenseTypeActionEnum.UPDATE]: transitionApprovedStatusUpdateAction,
+            [entities_1.ExpenseTypeActionEnum.DELETE]: transitionApprovedStatusDeleteAction,
+            [entities_1.ExpenseTypeActionEnum.DEACTIVATE]: transitionApprovedStatusDeactivateAction,
         },
     },
     [expense_type_status_enum_1.ExpenseTypeStatusEnum.DEACTIVATED]: {
         actions: {
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.DELETE]: transitionDeactivatedStatusDeleteAction,
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.ACTIVATE]: transitionDeactivatedStatusActivateAction,
+            [entities_1.ExpenseTypeActionEnum.DELETE]: transitionDeactivatedStatusDeleteAction,
+            [entities_1.ExpenseTypeActionEnum.ACTIVATE]: transitionDeactivatedStatusActivateAction,
         },
     },
     [expense_type_status_enum_1.ExpenseTypeStatusEnum.DELETED]: {
         actions: {
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.UPDATE]: transitionDeletedStatusUpdateAction,
-            [expense_type_action_enum_1.ExpenseTypeActionEnum.RESTORE]: transitionDeletedStatusRestoreAction,
+            [entities_1.ExpenseTypeActionEnum.UPDATE]: transitionDeletedStatusUpdateAction,
+            [entities_1.ExpenseTypeActionEnum.RESTORE]: transitionDeletedStatusRestoreAction,
         },
     },
 };

package/dist/src/entities/flow-configs/utils/flow-config.utils.d.ts

@@ -0,0 +1,110 @@
+import { PermissionGroupEnum } from "../../enums/permission_group_enum";
+/**
+ * Registry of per-entity action maps used by {@link FlowConfigUtils}.
+ *
+ * Every entry maps an {@link EntityEnum} member to the `ACTION_MAP` declared by that entity's
+ * flow config file. To register another entity: add `export` to its `ACTION_MAP` (only
+ * expense_type and work_from_home export it today) and add one line here. The typing below
+ * follows automatically:
+ * the entity parameter and the action parameter of `getPermissionGroupByAction` both derive
+ * from this object, so a new entity's actions are accepted only with that entity, and rejected
+ * for every other entity — including actions from a different enum that share the same string
+ * value (string enums are nominal across types).
+ */
+export declare const enumToActionMap: {
+    expense_type: {
+        CREATE: {
+            reachableStatues: readonly [import("../..").ExpenseTypeStatusEnum.APPROVED];
+            permissions: string[];
+            group: PermissionGroupEnum.CREATE;
+        };
+        UPDATE: {
+            reachableStatues: readonly [import("../..").ExpenseTypeStatusEnum.APPROVED];
+            permissions: string[];
+            group: PermissionGroupEnum.UPDATE;
+        };
+        DELETE: {
+            reachableStatues: readonly [import("../..").ExpenseTypeStatusEnum.DELETED];
+            permissions: string[];
+            group: PermissionGroupEnum.DELETE;
+        };
+        DEACTIVATE: {
+            reachableStatues: readonly [import("../..").ExpenseTypeStatusEnum.DEACTIVATED];
+            permissions: string[];
+            group: PermissionGroupEnum.UPDATE;
+        };
+        ACTIVATE: {
+            reachableStatues: readonly [import("../..").ExpenseTypeStatusEnum.APPROVED];
+            permissions: string[];
+            group: PermissionGroupEnum.UPDATE;
+        };
+        RESTORE: {
+            reachableStatues: readonly [import("../..").ExpenseTypeStatusEnum.APPROVED];
+            permissions: string[];
+            group: PermissionGroupEnum.UPDATE;
+        };
+    };
+    work_from_home: {
+        CREATE: {
+            reachableStatues: readonly [import("../..").WorkFromHomeStatusEnum.CREATE_APPROVAL_PENDING];
+            permissions: string[];
+            group: PermissionGroupEnum.CREATE;
+        };
+        UPDATE: {
+            reachableStatues: readonly [import("../..").WorkFromHomeStatusEnum.CREATE_APPROVAL_PENDING, import("../..").WorkFromHomeStatusEnum.UPDATE_APPROVAL_PENDING];
+            permissions: string[];
+            group: PermissionGroupEnum.UPDATE;
+        };
+        DELETE: {
+            reachableStatues: readonly [import("../..").WorkFromHomeStatusEnum.DELETE_APPROVAL_PENDING, import("../..").WorkFromHomeStatusEnum.DELETED];
+            permissions: string[];
+            group: PermissionGroupEnum.DELETE;
+        };
+        APPROVE: {
+            reachableStatues: readonly [import("../..").WorkFromHomeStatusEnum.APPROVED, import("../..").WorkFromHomeStatusEnum.DELETED];
+            permissions: string[];
+            group: PermissionGroupEnum.APPROVAL_FLOW;
+        };
+        REJECT: {
+            reachableStatues: readonly [import("../..").WorkFromHomeStatusEnum.REJECTED, import("../..").WorkFromHomeStatusEnum.RESOLVED_REJECTED];
+            permissions: string[];
+            group: PermissionGroupEnum.APPROVAL_FLOW;
+        };
+        RECALL: {
+            reachableStatues: readonly [import("../..").WorkFromHomeStatusEnum.APPROVED];
+            permissions: string[];
+            group: PermissionGroupEnum.UPDATE;
+        };
+    };
+};
+export type EnumToActionMap = typeof enumToActionMap;
+/**
+ * The action enum registered for entity `E`, derived from {@link enumToActionMap}.
+ *
+ * Written as a mapped-union lookup rather than `EnumToActionMap[E]`'s `keyof`: both forms are
+ * strict at the call site, but only this form also lets the method body index the erased map
+ * below without a cast (TS cannot resolve `EnumToActionMap[E][keyof EnumToActionMap[E]]` —
+ * property access on that deferred generic indexed access is a compile error). Intersected
+ * with `string` because a bare `keyof` constraint includes `symbol`, which forbids template
+ * interpolation of the parameter (TS2731); map keys are always string enum members, so the
+ * intersection loses nothing.
+ */
+export type RegisteredActions<E extends keyof EnumToActionMap> = {
+    [K in keyof EnumToActionMap]: keyof EnumToActionMap[K] & string;
+}[E];
+export declare class FlowConfigUtils {
+    /**
+     * Resolves the permission group an entity's action is authorised under, from the entity's
+     * flat `ACTION_MAP`. Needs only the entity and the action — deliberately no status and no
+     * existing entity — so callers building search filters can use it before any entity data
+     * has been fetched.
+     *
+     * @param entity Registered entity; entities missing from `enumToActionMap` are compile errors.
+     * @param action That entity's action enum member. A member of another entity's action enum
+     *               is a compile error even when its string value coincides.
+     * @throws AppBadRequestException (400) when the registry, the action, or the action's
+     *         `group` annotation is missing. Never falls back to a default group: defaulting
+     *         would authorise the action under another action's permissions.
+     */
+    static getPermissionGroupByAction<E extends keyof EnumToActionMap>(entity: E, action: RegisteredActions<E>): PermissionGroupEnum;
+}

package/dist/src/entities/flow-configs/utils/flow-config.utils.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowConfigUtils = exports.enumToActionMap = void 0;
+const error_key_enum_1 = require("../../../enums/error.key.enum");
+const exceptions_1 = require("../../../exceptions");
+const entity_utils_interface_1 = require("../../interface/entity.utils.interface");
+const expense_type_flow_config_1 = require("../expense_type_flow.config");
+const work_from_home_flow_config_1 = require("../work_from_home_flow.config");
+/**
+ * Registry of per-entity action maps used by {@link FlowConfigUtils}.
+ *
+ * Every entry maps an {@link EntityEnum} member to the `ACTION_MAP` declared by that entity's
+ * flow config file. To register another entity: add `export` to its `ACTION_MAP` (only
+ * expense_type and work_from_home export it today) and add one line here. The typing below
+ * follows automatically:
+ * the entity parameter and the action parameter of `getPermissionGroupByAction` both derive
+ * from this object, so a new entity's actions are accepted only with that entity, and rejected
+ * for every other entity — including actions from a different enum that share the same string
+ * value (string enums are nominal across types).
+ */
+exports.enumToActionMap = {
+    [entity_utils_interface_1.EntityEnum.EXPENSE_TYPE]: expense_type_flow_config_1.ACTION_MAP,
+    [entity_utils_interface_1.EntityEnum.WORK_FROM_HOME]: work_from_home_flow_config_1.ACTION_MAP,
+};
+class FlowConfigUtils {
+    /**
+     * Resolves the permission group an entity's action is authorised under, from the entity's
+     * flat `ACTION_MAP`. Needs only the entity and the action — deliberately no status and no
+     * existing entity — so callers building search filters can use it before any entity data
+     * has been fetched.
+     *
+     * @param entity Registered entity; entities missing from `enumToActionMap` are compile errors.
+     * @param action That entity's action enum member. A member of another entity's action enum
+     *               is a compile error even when its string value coincides.
+     * @throws AppBadRequestException (400) when the registry, the action, or the action's
+     *         `group` annotation is missing. Never falls back to a default group: defaulting
+     *         would authorise the action under another action's permissions.
+     */
+    static getPermissionGroupByAction(entity, action) {
+        const actionMap = exports.enumToActionMap[entity];
+        if (!actionMap) {
+            throw new exceptions_1.AppBadRequestException({
+                key: error_key_enum_1.ErrorKeyEnum.ENTITY,
+                message: [`No action map registered for entity '${entity}'`],
+            });
+        }
+        const actionConfig = actionMap[action];
+        if (!actionConfig) {
+            throw new exceptions_1.AppBadRequestException({
+                key: error_key_enum_1.ErrorKeyEnum.ACTION,
+                message: [`Action '${action}' is not configured for entity '${entity}'`],
+            });
+        }
+        const group = actionConfig.group;
+        if (!group) {
+            throw new exceptions_1.AppBadRequestException({
+                key: error_key_enum_1.ErrorKeyEnum.PERMISSION_GROUP,
+                message: [`Action '${action}' for entity '${entity}' has no permission group configured. Declare it in the entity's flow config.`],
+            });
+        }
+        return group;
+    }
+}
+exports.FlowConfigUtils = FlowConfigUtils;

package/dist/src/entities/flow-configs/work_from_home_flow.config.d.ts

@@ -1,6 +1,39 @@
 import { FlowConfig } from "./flow-config.type";
+import { PermissionGroupEnum } from "../enums/permission_group_enum";
 import { WorkFromHomeActionEnum } from "../enums/work_from_home_action_enum";
 import { WorkFromHomeStatusEnum } from "../enums/work_from_home_status_enum";
 export interface IWorkFromHomeFlowConfigContextData {
 }
+export declare const ACTION_MAP: {
+    CREATE: {
+        reachableStatues: readonly [WorkFromHomeStatusEnum.CREATE_APPROVAL_PENDING];
+        permissions: string[];
+        group: PermissionGroupEnum.CREATE;
+    };
+    UPDATE: {
+        reachableStatues: readonly [WorkFromHomeStatusEnum.CREATE_APPROVAL_PENDING, WorkFromHomeStatusEnum.UPDATE_APPROVAL_PENDING];
+        permissions: string[];
+        group: PermissionGroupEnum.UPDATE;
+    };
+    DELETE: {
+        reachableStatues: readonly [WorkFromHomeStatusEnum.DELETE_APPROVAL_PENDING, WorkFromHomeStatusEnum.DELETED];
+        permissions: string[];
+        group: PermissionGroupEnum.DELETE;
+    };
+    APPROVE: {
+        reachableStatues: readonly [WorkFromHomeStatusEnum.APPROVED, WorkFromHomeStatusEnum.DELETED];
+        permissions: string[];
+        group: PermissionGroupEnum.APPROVAL_FLOW;
+    };
+    REJECT: {
+        reachableStatues: readonly [WorkFromHomeStatusEnum.REJECTED, WorkFromHomeStatusEnum.RESOLVED_REJECTED];
+        permissions: string[];
+        group: PermissionGroupEnum.APPROVAL_FLOW;
+    };
+    RECALL: {
+        reachableStatues: readonly [WorkFromHomeStatusEnum.APPROVED];
+        permissions: string[];
+        group: PermissionGroupEnum.UPDATE;
+    };
+};
 export declare const workFromHomeFlowConfig: FlowConfig<WorkFromHomeStatusEnum, WorkFromHomeActionEnum, IWorkFromHomeFlowConfigContextData>;

package/dist/src/entities/flow-configs/work_from_home_flow.config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.workFromHomeFlowConfig = void 0;
+exports.workFromHomeFlowConfig = exports.ACTION_MAP = void 0;
 const base_flow_config_factory_1 = require("./base-flow-config.factory");
 const permission_group_enum_1 = require("../enums/permission_group_enum");
 const work_from_home_action_enum_1 = require("../enums/work_from_home_action_enum");
@@ -14,7 +14,8 @@ const WORK_FROM_HOME_REJECT_PERMISSION = ["WORK_FROM_HOME_APPROVER_ORG"];
 const WORK_FROM_HOME_RECALL_PERMISSION = ["WORK_FROM_HOME_UPDATE_ORG", "WORK_FROM_HOME_UPDATE_SELF"];
 // Every action declares its group. work_from_home_bulk_update.transaction.ts refuses to
 // default an absent group, so all six must be annotated for any transition to keep working.
-const ACTION_MAP = {
+// Exported for the FlowConfigUtils.getPermissionGroupByAction registry.
+exports.ACTION_MAP = {
     [work_from_home_action_enum_1.WorkFromHomeActionEnum.CREATE]: {
         reachableStatues: [work_from_home_status_enum_1.WorkFromHomeStatusEnum.CREATE_APPROVAL_PENDING],
         permissions: WORK_FROM_HOME_CREATE_PERMISSION,
@@ -50,7 +51,7 @@ const ACTION_MAP = {
         group: permission_group_enum_1.PermissionGroupEnum.UPDATE,
     },
 };
-const { createActionConfig } = (0, base_flow_config_factory_1.createFlowConfigFactory)()(ACTION_MAP);
+const { createActionConfig } = (0, base_flow_config_factory_1.createFlowConfigFactory)()(exports.ACTION_MAP);
 // CREATE_APPROVAL_PENDING status transitions
 const transitionCreateApprovalPendingStatusUpdateAction = createActionConfig(work_from_home_action_enum_1.WorkFromHomeActionEnum.UPDATE, work_from_home_status_enum_1.WorkFromHomeStatusEnum.CREATE_APPROVAL_PENDING);
 const transitionCreateApprovalPendingStatusDeleteAction = createActionConfig(work_from_home_action_enum_1.WorkFromHomeActionEnum.DELETE, work_from_home_status_enum_1.WorkFromHomeStatusEnum.DELETED);

package/dist/src/entities/index.d.ts

@@ -47,7 +47,7 @@ export * from "./flow-configs/reimbursement_flow.config";
 export * from "./flow-configs/reimbursement_expense_flow.config";
 export * from "./interface/reimbursement.entity.interface";
 export * from "./interface/field-constraint/reimbursement_field_constraints.interface";
-export * from "./enums/expense_type_entity_enum";
+export * from "./enums/expense_type_enum";
 export * from "./enums/expense_type_action_enum";
 export * from "./enums/expense_type_status_enum";
 export * from "./flow-configs/expense_type_flow.config";
@@ -403,10 +403,11 @@ export * from "./interface/field-constraint/rate_field_constraints.interface";
 export * from "./model/rate.entity.model";
 export * from "./enums/work_from_home_action_enum";
 export * from "./enums/work_from_home_status_enum";
-export * from "./flow-configs/work_from_home_flow.config";
+export { IWorkFromHomeFlowConfigContextData, ACTION_MAP as WORK_FROM_HOME_ACTION_MAP, workFromHomeFlowConfig } from "./flow-configs/work_from_home_flow.config";
 export * from "./interface/field-constraint/work_from_home_field_constraints.interface";
 export * from "./interface/work_from_home.entity.interface";
 export * from "./model/work_from_home.entity.model";
 export * from "./enums/user_gender_enum";
 export * from "./enums/user_role_enum";
 export * from "./enums/user_status_enum";
+export * from "./flow-configs/utils/flow-config.utils";

package/dist/src/entities/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.workFromHomeFlowConfig = exports.WORK_FROM_HOME_ACTION_MAP = void 0;
 __exportStar(require("./enums/organization_action_enum"), exports);
 __exportStar(require("./enums/organization_status_enum"), exports);
 __exportStar(require("./flow-configs/organization_flow.config"), exports);
@@ -63,7 +64,7 @@ __exportStar(require("./flow-configs/reimbursement_flow.config"), exports);
 __exportStar(require("./flow-configs/reimbursement_expense_flow.config"), exports);
 __exportStar(require("./interface/reimbursement.entity.interface"), exports);
 __exportStar(require("./interface/field-constraint/reimbursement_field_constraints.interface"), exports);
-__exportStar(require("./enums/expense_type_entity_enum"), exports);
+__exportStar(require("./enums/expense_type_enum"), exports);
 __exportStar(require("./enums/expense_type_action_enum"), exports);
 __exportStar(require("./enums/expense_type_status_enum"), exports);
 __exportStar(require("./flow-configs/expense_type_flow.config"), exports);
@@ -420,10 +421,13 @@ __exportStar(require("./interface/field-constraint/rate_field_constraints.interf
 __exportStar(require("./model/rate.entity.model"), exports);
 __exportStar(require("./enums/work_from_home_action_enum"), exports);
 __exportStar(require("./enums/work_from_home_status_enum"), exports);
-__exportStar(require("./flow-configs/work_from_home_flow.config"), exports);
+var work_from_home_flow_config_1 = require("./flow-configs/work_from_home_flow.config");
+Object.defineProperty(exports, "WORK_FROM_HOME_ACTION_MAP", { enumerable: true, get: function () { return work_from_home_flow_config_1.ACTION_MAP; } });
+Object.defineProperty(exports, "workFromHomeFlowConfig", { enumerable: true, get: function () { return work_from_home_flow_config_1.workFromHomeFlowConfig; } });
 __exportStar(require("./interface/field-constraint/work_from_home_field_constraints.interface"), exports);
 __exportStar(require("./interface/work_from_home.entity.interface"), exports);
 __exportStar(require("./model/work_from_home.entity.model"), exports);
 __exportStar(require("./enums/user_gender_enum"), exports);
 __exportStar(require("./enums/user_role_enum"), exports);
 __exportStar(require("./enums/user_status_enum"), exports);
+__exportStar(require("./flow-configs/utils/flow-config.utils"), exports);

package/dist/src/entities/interface/expense_type.entity.interface.d.ts

@@ -1,10 +1,11 @@
-import { ExpenseTypeEnum } from "../enums/expense_type_entity_enum";
+import { ExpenseTypeEnum } from "../enums/expense_type_enum";
 import { ExpenseTypeStatusEnum } from "../enums/expense_type_status_enum";
 import { IEntityAuditColumn } from "./entity-audit-columns.interface";
+import { Nullable } from "./entity.utils.interface";
 export interface IExpenseTypeEntity extends IEntityAuditColumn {
     id: number;
     name: string;
-    description?: string;
+    description?: Nullable<string>;
     type: ExpenseTypeEnum;
     status: ExpenseTypeStatusEnum;
 }

package/dist/src/entities/interface/field-constraint/expense_type_field_constraints.interface.d.ts

@@ -1,14 +1,6 @@
 import { IEntityAuditColumn } from "../entity-audit-columns.interface";
 import { IExpenseTypeEntity } from "../expense_type.entity.interface";
 import { IFieldMinMaxConstraint } from "./utils";
-/**
- * excluded, and why:
- * - "type", "status"                enum columns, enums carry no min/max
- * - "id", keyof IEntityAuditColumn  generated columns
- *
- * this entity has a create DTO only — there is no ExpenseTypeUpdateDto, so no
- * create/update disagreement is possible
- */
 export type IExpenseTypeFieldLengthConstraintsExclude = "status" | "type" | "id" | keyof IEntityAuditColumn;
 /**
  * since some fields are optional, but we still need their

package/dist/src/entities/model/expense_type.entity.model.d.ts

@@ -1,14 +1,14 @@
-import { ExpenseTypeActionEnum } from "../enums/expense_type_action_enum";
-import { IExpenseTypeFlowConfigContextData } from "../flow-configs/expense_type_flow.config";
+import { EntityEnum } from "../interface/entity.utils.interface";
+import { RelationConfigs } from "../interface/relation-config.interface";
 import { IUserEntity } from "../interface/user.entity.interface";
+import { BaseEntityModel } from "./base.entity.model";
 import { IRowActions } from "./interface/row-actions.interface";
 import { UserEntityModel } from "./user.entity.model";
-import { ExpenseTypeEnum } from "../enums/expense_type_entity_enum";
+import { ExpenseTypeActionEnum } from "../../entities";
+import { ExpenseTypeEnum } from "../enums/expense_type_enum";
 import { ExpenseTypeStatusEnum } from "../enums/expense_type_status_enum";
-import { EntityEnum } from "../interface/entity.utils.interface";
+import { IExpenseTypeFlowConfigContextData } from "../flow-configs/expense_type_flow.config";
 import { IExpenseTypeEntity } from "../interface/expense_type.entity.interface";
-import { RelationConfigs } from "../interface/relation-config.interface";
-import { BaseEntityModel } from "./base.entity.model";
 export declare class ExpenseTypeEntityModel extends BaseEntityModel<EntityEnum.EXPENSE_TYPE> implements IExpenseTypeEntity {
     id: number;
     name: string;
@@ -21,7 +21,7 @@ export declare class ExpenseTypeEntityModel extends BaseEntityModel<EntityEnum.E
     updatedBy: number;
     static relationConfigs: RelationConfigs<[], EntityEnum.EXPENSE_TYPE>;
     static fromEntity(entity: IExpenseTypeEntity): ExpenseTypeEntityModel;
-    getRelationConfigs(): [];
+    getRelationConfigs(): any[];
     getNextStatus(currentUser: IUserEntity, action: ExpenseTypeActionEnum, expenseTypeFlowConfigContextData: IExpenseTypeFlowConfigContextData): ExpenseTypeStatusEnum;
     getAvailableActions(currentUser: UserEntityModel, config?: {
         combinedActions?: Record<string, {

package/dist/src/entities/model/expense_type.entity.model.js

@@ -4,17 +4,17 @@ exports.ExpenseTypeEntityModel = void 0;
 const error_key_enum_1 = require("../../enums/error.key.enum");
 const exceptions_1 = require("../../exceptions");
 const utils_1 = require("../../utils");
-const expense_type_flow_config_1 = require("../flow-configs/expense_type_flow.config");
-const expense_type_entity_enum_1 = require("../enums/expense_type_entity_enum");
-const expense_type_status_enum_1 = require("../enums/expense_type_status_enum");
 const entity_utils_interface_1 = require("../interface/entity.utils.interface");
 const base_entity_model_1 = require("./base.entity.model");
+const expense_type_enum_1 = require("../enums/expense_type_enum");
+const expense_type_status_enum_1 = require("../enums/expense_type_status_enum");
+const expense_type_flow_config_1 = require("../flow-configs/expense_type_flow.config");
 class ExpenseTypeEntityModel extends base_entity_model_1.BaseEntityModel {
     constructor() {
         super(...arguments);
         this.id = 0;
         this.name = "";
-        this.type = expense_type_entity_enum_1.ExpenseTypeEnum.BILLABLE;
+        this.type = expense_type_enum_1.ExpenseTypeEnum.BILLABLE;
         this.status = expense_type_status_enum_1.ExpenseTypeStatusEnum.APPROVED;
         this.createdOn = 0;
         this.updatedOn = 0;
@@ -27,7 +27,7 @@ class ExpenseTypeEntityModel extends base_entity_model_1.BaseEntityModel {
         return result;
     }
     getRelationConfigs() {
-        return ExpenseTypeEntityModel.relationConfigs;
+        return this.constructor.prototype.constructor.relationConfigs || [];
     }
     getNextStatus(currentUser, action, expenseTypeFlowConfigContextData) {
         if (!this.status) {
@@ -66,7 +66,7 @@ class ExpenseTypeEntityModel extends base_entity_model_1.BaseEntityModel {
         if (!hasPermission) {
             throw new exceptions_1.AppBadRequestException({
                 key: error_key_enum_1.ErrorKeyEnum.PERMISSION,
-                message: [`Current user does not have permission to ${action} expense type`],
+                message: [`Current user does not have permission to ${action} expenseType`],
             });
         }
         const nextStatus = matchingPermissionConfig.next(expenseTypeFlowConfigContextData);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "law-common",
-  "version": "14.1.1",
+  "version": "14.1.2-beta.1",
   "description": "",
   "main": "dist/index.js",
   "files": [