law-common 10.77.0 → 11.0.0

package/README.md

@@ -1 +1 @@
-# law-common
+# law-common

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

@@ -101,3 +101,5 @@ export * from "./interface/client_quote_rate.update.dto.interface";
 export * from "./interface/project-revenue-split.create.dto";
 export * from "./interface/entity_history.create.dto.interface";
 export * from "./interface/entity_history.update.dto.interface";
+export * from "./interface/leave_approval.create.dto.interface";
+export * from "./interface/leave_approval.update.dto.interface";

package/dist/src/api/index.js

@@ -121,3 +121,5 @@ __exportStar(require("./interface/client_quote_rate.update.dto.interface"), expo
 __exportStar(require("./interface/project-revenue-split.create.dto"), exports);
 __exportStar(require("./interface/entity_history.create.dto.interface"), exports);
 __exportStar(require("./interface/entity_history.update.dto.interface"), exports);
+__exportStar(require("./interface/leave_approval.create.dto.interface"), exports);
+__exportStar(require("./interface/leave_approval.update.dto.interface"), exports);

package/dist/src/api/interface/leave_approval.create.dto.interface.d.ts

@@ -0,0 +1,5 @@
+import { IEntityCreateDto } from "../../entities";
+import { ILeaveApprovalEntity } from "../../entities/interface/leave_approval.entity.interface";
+export type ILeaveApprovalCreateExclude = "status";
+export interface ILeaveApprovalCreateDto extends Omit<IEntityCreateDto<ILeaveApprovalEntity>, ILeaveApprovalCreateExclude> {
+}

package/dist/src/api/interface/leave_approval.create.dto.interface.js

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

package/dist/src/api/interface/leave_approval.update.dto.interface.d.ts

@@ -0,0 +1,18 @@
+import { DeepPartialButRequired } from "./api.utils.interface";
+import { ILeaveApprovalCreateDto } from "./leave_approval.create.dto.interface";
+export type ILeaveApprovalUpdateDto = DeepPartialButRequired<ILeaveApprovalCreateDto, never> & {
+    actionData: ILeaveApprovalActionDataDto;
+};
+export interface ILeaveApprovalActionDataDto {
+    action: LeaveApprovalActionEnum;
+    remark?: string;
+}
+export declare enum LeaveApprovalActionEnum {
+    DELETE = "delete",
+    APPROVE = "approve",
+    REJECT = "reject",
+    RECALL = "recall",
+    ESCALATION_APPROVE = "escalationApprove",
+    ESCALATION_REJECT = "escalationReject",
+    ESCALATE = "escalate"
+}

package/dist/src/api/interface/leave_approval.update.dto.interface.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeaveApprovalActionEnum = void 0;
+var LeaveApprovalActionEnum;
+(function (LeaveApprovalActionEnum) {
+    // UPDATE = "update",
+    LeaveApprovalActionEnum["DELETE"] = "delete";
+    // CREATE = "create",
+    LeaveApprovalActionEnum["APPROVE"] = "approve";
+    LeaveApprovalActionEnum["REJECT"] = "reject";
+    LeaveApprovalActionEnum["RECALL"] = "recall";
+    // DEACTIVATE = "deactivate",
+    LeaveApprovalActionEnum["ESCALATION_APPROVE"] = "escalationApprove";
+    LeaveApprovalActionEnum["ESCALATION_REJECT"] = "escalationReject";
+    LeaveApprovalActionEnum["ESCALATE"] = "escalate";
+})(LeaveApprovalActionEnum || (exports.LeaveApprovalActionEnum = LeaveApprovalActionEnum = {}));

package/dist/src/entities/enums/configuration-key.enum.d.ts

@@ -6,7 +6,8 @@ export declare enum ConfigurationKeyEnum {
     TIMESHEET_THRESHOLD = "timesheetThreshold",
     TIMESHEET_ENTER_THRESHOLD = "timesheetEnterThreshold",
     ORGANIZATION_BILLING_OVERDUE_THRESHOLD = "organization_billing_overdue_threshold",
-    PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET = "projectEntityUsageNotificationSentPercentageReset"
+    PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET = "projectEntityUsageNotificationSentPercentageReset",
+    LEAVE_ESCALATION = "leaveEscalation"
 }
 export declare namespace ConfigurationKeyEnum {
     function getNames(): string[];

package/dist/src/entities/enums/configuration-key.enum.js

@@ -13,6 +13,7 @@ var ConfigurationKeyEnum;
     ConfigurationKeyEnum["TIMESHEET_ENTER_THRESHOLD"] = "timesheetEnterThreshold";
     ConfigurationKeyEnum["ORGANIZATION_BILLING_OVERDUE_THRESHOLD"] = "organization_billing_overdue_threshold";
     ConfigurationKeyEnum["PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET"] = "projectEntityUsageNotificationSentPercentageReset";
+    ConfigurationKeyEnum["LEAVE_ESCALATION"] = "leaveEscalation";
 })(ConfigurationKeyEnum || (exports.ConfigurationKeyEnum = ConfigurationKeyEnum = {}));
 (function (ConfigurationKeyEnum) {
     function getNames() {
@@ -39,6 +40,7 @@ var ConfigurationKeyEnum;
         const cronJobConfigurationKeyMapping = {
             [ConfigurationKeyEnum.PENDING_APPROVAL_TIMESHEET_REMINDER]: cron_jobs_name_enum_1.CronJobNames.PENDING_APPROVAL_TIMESHEET_REMINDER,
             [ConfigurationKeyEnum.PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET]: cron_jobs_name_enum_1.CronJobNames.PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET,
+            [ConfigurationKeyEnum.LEAVE_ESCALATION]: cron_jobs_name_enum_1.CronJobNames.LEAVE_ESCALATION,
         };
         return cronJobConfigurationKeyMapping[configurationKey];
     }

package/dist/src/entities/enums/cron-jobs-name.enum.d.ts

@@ -1,4 +1,5 @@
 export declare enum CronJobNames {
     PENDING_APPROVAL_TIMESHEET_REMINDER = "pending_approval_timesheet_reminder",
-    PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET = "project_entity_usage_notification_sent_percentage_reset"
+    PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET = "project_entity_usage_notification_sent_percentage_reset",
+    LEAVE_ESCALATION = "leave_escalation"
 }

package/dist/src/entities/enums/cron-jobs-name.enum.js

@@ -5,4 +5,5 @@ var CronJobNames;
 (function (CronJobNames) {
     CronJobNames["PENDING_APPROVAL_TIMESHEET_REMINDER"] = "pending_approval_timesheet_reminder";
     CronJobNames["PROJECT_ENTITY_USAGE_NOTIFICATION_SENT_PERCENTAGE_RESET"] = "project_entity_usage_notification_sent_percentage_reset";
+    CronJobNames["LEAVE_ESCALATION"] = "leave_escalation";
 })(CronJobNames || (exports.CronJobNames = CronJobNames = {}));

package/dist/src/entities/enums/leave.action.enum.d.ts

@@ -1,10 +1,11 @@
 export declare enum LeaveActionEnum {
     READ = "read",
-    EDIT = "edit",
     APPROVE = "approve",
     REJECT = "reject",
     DELETE = "delete",
-    RECALL = "recall"
+    RECALL = "recall",
+    LEAVE_APPROVAL_APPROVE = "leaveApprovalApprove",
+    LEAVE_APPROVAL_REJECT = "leaveApprovalReject"
 }
 export declare namespace LeaveActionEnum {
     function getLabel(action: LeaveActionEnum): string;

package/dist/src/entities/enums/leave.action.enum.js

@@ -6,20 +6,24 @@ const exceptions_1 = require("../../exceptions");
 var LeaveActionEnum;
 (function (LeaveActionEnum) {
     LeaveActionEnum["READ"] = "read";
-    LeaveActionEnum["EDIT"] = "edit";
+    // EDIT = "edit",
     LeaveActionEnum["APPROVE"] = "approve";
     LeaveActionEnum["REJECT"] = "reject";
     LeaveActionEnum["DELETE"] = "delete";
     LeaveActionEnum["RECALL"] = "recall";
+    LeaveActionEnum["LEAVE_APPROVAL_APPROVE"] = "leaveApprovalApprove";
+    LeaveActionEnum["LEAVE_APPROVAL_REJECT"] = "leaveApprovalReject";
 })(LeaveActionEnum || (exports.LeaveActionEnum = LeaveActionEnum = {}));
 (function (LeaveActionEnum) {
     const actionLabelMap = {
         [LeaveActionEnum.READ]: "Read",
-        [LeaveActionEnum.EDIT]: "Edit",
+        // [LeaveActionEnum.EDIT]: "Edit",
         [LeaveActionEnum.APPROVE]: "Approve",
         [LeaveActionEnum.REJECT]: "Reject",
         [LeaveActionEnum.DELETE]: "Delete",
         [LeaveActionEnum.RECALL]: "Recall",
+        [LeaveActionEnum.LEAVE_APPROVAL_APPROVE]: "Approve",
+        [LeaveActionEnum.LEAVE_APPROVAL_REJECT]: "Reject",
     };
     function getLabel(action) {
         if (!Object.values(LeaveActionEnum).includes(action)) {

package/dist/src/entities/enums/leave_approval_status_enum.d.ts

@@ -0,0 +1,13 @@
+export declare enum LeaveApprovalStatusEnum {
+    DEACTIVATED = "DEACTIVATED",
+    CREATED = "CREATED",
+    UPDATED = "UPDATED",
+    DELETED = "DELETED",
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    CREATE_APPROVAL_PENDING = "CREATE_APPROVAL_PENDING",
+    UPDATE_APPROVAL_PENDING = "UPDATE_APPROVAL_PENDING",
+    DELETE_APPROVAL_PENDING = "DELETE_APPROVAL_PENDING",
+    RESOLVED_REJECTED = "RESOLVED_REJECTED",
+    ESCALATED = "ESCALATED"
+}

package/dist/src/entities/enums/leave_approval_status_enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeaveApprovalStatusEnum = void 0;
+var LeaveApprovalStatusEnum;
+(function (LeaveApprovalStatusEnum) {
+    LeaveApprovalStatusEnum["DEACTIVATED"] = "DEACTIVATED";
+    LeaveApprovalStatusEnum["CREATED"] = "CREATED";
+    LeaveApprovalStatusEnum["UPDATED"] = "UPDATED";
+    LeaveApprovalStatusEnum["DELETED"] = "DELETED";
+    LeaveApprovalStatusEnum["APPROVED"] = "APPROVED";
+    LeaveApprovalStatusEnum["REJECTED"] = "REJECTED";
+    LeaveApprovalStatusEnum["CREATE_APPROVAL_PENDING"] = "CREATE_APPROVAL_PENDING";
+    LeaveApprovalStatusEnum["UPDATE_APPROVAL_PENDING"] = "UPDATE_APPROVAL_PENDING";
+    LeaveApprovalStatusEnum["DELETE_APPROVAL_PENDING"] = "DELETE_APPROVAL_PENDING";
+    LeaveApprovalStatusEnum["RESOLVED_REJECTED"] = "RESOLVED_REJECTED";
+    LeaveApprovalStatusEnum["ESCALATED"] = "ESCALATED";
+})(LeaveApprovalStatusEnum || (exports.LeaveApprovalStatusEnum = LeaveApprovalStatusEnum = {}));

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

@@ -0,0 +1,74 @@
+/**
+ * Base action enum shared across all entity flow configs.
+ *
+ * Entity-specific action enums should re-use these values for common actions
+ * and declare additional values for entity-specific actions.
+ *
+ * @example
+ * // Extending with entity-specific actions
+ * export enum VendorActionEnum {
+ *   // — base actions (re-declare to keep enum self-contained) —
+ *   VIEW     = BaseFlowActionEnum.VIEW,
+ *   CREATE   = BaseFlowActionEnum.CREATE,
+ *   UPDATE   = BaseFlowActionEnum.UPDATE,
+ *   DELETE   = BaseFlowActionEnum.DELETE,
+ *   APPROVE  = BaseFlowActionEnum.APPROVE,
+ *   REJECT   = BaseFlowActionEnum.REJECT,
+ *   RECALL   = BaseFlowActionEnum.RECALL,
+ *   DEACTIVATE = BaseFlowActionEnum.DEACTIVATE,
+ *   // — entity-specific additions —
+ *   SUBMIT   = "submit",
+ *   ESCALATE = "escalate",
+ * }
+ */
+export declare enum BaseFlowActionEnum {
+    VIEW = "view",
+    CREATE = "create",
+    UPDATE = "update",
+    DELETE = "delete",
+    APPROVE = "approve",
+    REJECT = "reject",
+    RECALL = "recall",
+    DEACTIVATE = "deactivate"
+}
+/**
+ * Base status enum shared across all entity flow configs.
+ *
+ * Entity-specific status enums should re-use these values for common statuses
+ * and declare additional values for entity-specific statuses.
+ *
+ * @example
+ * // Extending with entity-specific statuses
+ * export enum VendorStatusEnum {
+ *   // — base statuses —
+ *   ACTIVE                  = BaseFlowStatusEnum.ACTIVE,
+ *   INACTIVE                = BaseFlowStatusEnum.INACTIVE,
+ *   DEACTIVATED             = BaseFlowStatusEnum.DEACTIVATED,
+ *   CREATED                 = BaseFlowStatusEnum.CREATED,
+ *   UPDATED                 = BaseFlowStatusEnum.UPDATED,
+ *   DELETED                 = BaseFlowStatusEnum.DELETED,
+ *   APPROVED                = BaseFlowStatusEnum.APPROVED,
+ *   REJECTED                = BaseFlowStatusEnum.REJECTED,
+ *   RESOLVED_REJECTED       = BaseFlowStatusEnum.RESOLVED_REJECTED,
+ *   CREATE_APPROVAL_PENDING = BaseFlowStatusEnum.CREATE_APPROVAL_PENDING,
+ *   UPDATE_APPROVAL_PENDING = BaseFlowStatusEnum.UPDATE_APPROVAL_PENDING,
+ *   DELETE_APPROVAL_PENDING = BaseFlowStatusEnum.DELETE_APPROVAL_PENDING,
+ *   // — entity-specific additions —
+ *   UNDER_REVIEW            = "UNDER_REVIEW",
+ *   SUBMITTED               = "SUBMITTED",
+ * }
+ */
+export declare enum BaseFlowStatusEnum {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    DEACTIVATED = "DEACTIVATED",
+    CREATED = "CREATED",
+    UPDATED = "UPDATED",
+    DELETED = "DELETED",
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    RESOLVED_REJECTED = "RESOLVED_REJECTED",
+    CREATE_APPROVAL_PENDING = "CREATE_APPROVAL_PENDING",
+    UPDATE_APPROVAL_PENDING = "UPDATE_APPROVAL_PENDING",
+    DELETE_APPROVAL_PENDING = "DELETE_APPROVAL_PENDING"
+}

package/dist/src/entities/flow-configs/base-flow-config.enums.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseFlowStatusEnum = exports.BaseFlowActionEnum = void 0;
+/**
+ * Base action enum shared across all entity flow configs.
+ *
+ * Entity-specific action enums should re-use these values for common actions
+ * and declare additional values for entity-specific actions.
+ *
+ * @example
+ * // Extending with entity-specific actions
+ * export enum VendorActionEnum {
+ *   // — base actions (re-declare to keep enum self-contained) —
+ *   VIEW     = BaseFlowActionEnum.VIEW,
+ *   CREATE   = BaseFlowActionEnum.CREATE,
+ *   UPDATE   = BaseFlowActionEnum.UPDATE,
+ *   DELETE   = BaseFlowActionEnum.DELETE,
+ *   APPROVE  = BaseFlowActionEnum.APPROVE,
+ *   REJECT   = BaseFlowActionEnum.REJECT,
+ *   RECALL   = BaseFlowActionEnum.RECALL,
+ *   DEACTIVATE = BaseFlowActionEnum.DEACTIVATE,
+ *   // — entity-specific additions —
+ *   SUBMIT   = "submit",
+ *   ESCALATE = "escalate",
+ * }
+ */
+var BaseFlowActionEnum;
+(function (BaseFlowActionEnum) {
+    BaseFlowActionEnum["VIEW"] = "view";
+    BaseFlowActionEnum["CREATE"] = "create";
+    BaseFlowActionEnum["UPDATE"] = "update";
+    BaseFlowActionEnum["DELETE"] = "delete";
+    BaseFlowActionEnum["APPROVE"] = "approve";
+    BaseFlowActionEnum["REJECT"] = "reject";
+    BaseFlowActionEnum["RECALL"] = "recall";
+    BaseFlowActionEnum["DEACTIVATE"] = "deactivate";
+})(BaseFlowActionEnum || (exports.BaseFlowActionEnum = BaseFlowActionEnum = {}));
+/**
+ * Base status enum shared across all entity flow configs.
+ *
+ * Entity-specific status enums should re-use these values for common statuses
+ * and declare additional values for entity-specific statuses.
+ *
+ * @example
+ * // Extending with entity-specific statuses
+ * export enum VendorStatusEnum {
+ *   // — base statuses —
+ *   ACTIVE                  = BaseFlowStatusEnum.ACTIVE,
+ *   INACTIVE                = BaseFlowStatusEnum.INACTIVE,
+ *   DEACTIVATED             = BaseFlowStatusEnum.DEACTIVATED,
+ *   CREATED                 = BaseFlowStatusEnum.CREATED,
+ *   UPDATED                 = BaseFlowStatusEnum.UPDATED,
+ *   DELETED                 = BaseFlowStatusEnum.DELETED,
+ *   APPROVED                = BaseFlowStatusEnum.APPROVED,
+ *   REJECTED                = BaseFlowStatusEnum.REJECTED,
+ *   RESOLVED_REJECTED       = BaseFlowStatusEnum.RESOLVED_REJECTED,
+ *   CREATE_APPROVAL_PENDING = BaseFlowStatusEnum.CREATE_APPROVAL_PENDING,
+ *   UPDATE_APPROVAL_PENDING = BaseFlowStatusEnum.UPDATE_APPROVAL_PENDING,
+ *   DELETE_APPROVAL_PENDING = BaseFlowStatusEnum.DELETE_APPROVAL_PENDING,
+ *   // — entity-specific additions —
+ *   UNDER_REVIEW            = "UNDER_REVIEW",
+ *   SUBMITTED               = "SUBMITTED",
+ * }
+ */
+var BaseFlowStatusEnum;
+(function (BaseFlowStatusEnum) {
+    BaseFlowStatusEnum["ACTIVE"] = "ACTIVE";
+    BaseFlowStatusEnum["INACTIVE"] = "INACTIVE";
+    BaseFlowStatusEnum["DEACTIVATED"] = "DEACTIVATED";
+    BaseFlowStatusEnum["CREATED"] = "CREATED";
+    BaseFlowStatusEnum["UPDATED"] = "UPDATED";
+    BaseFlowStatusEnum["DELETED"] = "DELETED";
+    BaseFlowStatusEnum["APPROVED"] = "APPROVED";
+    BaseFlowStatusEnum["REJECTED"] = "REJECTED";
+    BaseFlowStatusEnum["RESOLVED_REJECTED"] = "RESOLVED_REJECTED";
+    BaseFlowStatusEnum["CREATE_APPROVAL_PENDING"] = "CREATE_APPROVAL_PENDING";
+    BaseFlowStatusEnum["UPDATE_APPROVAL_PENDING"] = "UPDATE_APPROVAL_PENDING";
+    BaseFlowStatusEnum["DELETE_APPROVAL_PENDING"] = "DELETE_APPROVAL_PENDING";
+})(BaseFlowStatusEnum || (exports.BaseFlowStatusEnum = BaseFlowStatusEnum = {}));

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

@@ -0,0 +1,116 @@
+/**
+ * Generic flow-config factory.
+ *
+ * Provides a reusable, type-safe `createActionConfig` helper for any entity
+ * flow configuration. Eliminates boilerplate type plumbing (ActionStatusMap,
+ * StateStatusForAction, createTransition) that would otherwise be duplicated
+ * in every flow config file.
+ *
+ * ---
+ * **Usage — basic**
+ * ```typescript
+ * import { createFlowConfigFactory } from "./base-flow-config.factory";
+ *
+ * const ACTION_MAP = {
+ *   [MyActionEnum.APPROVE]: { statuses: [MyStatusEnum.APPROVED] as const, permissions: ["MY_APPROVE"] },
+ *   [MyActionEnum.REJECT]:  { statuses: [MyStatusEnum.REJECTED]  as const, permissions: ["MY_REJECT"]  },
+ * } satisfies ActionMap<MyActionEnum, MyStatusEnum>;
+ *
+ * const { createActionConfig } = createFlowConfigFactory<IMyContextData>()(ACTION_MAP);
+ *
+ * const transition = createActionConfig(MyStatusEnum.APPROVED, MyActionEnum.APPROVE);
+ * ```
+ *
+ * ---
+ * **Usage — overriding a transition permission**
+ * ```typescript
+ * createActionConfig(MyStatusEnum.APPROVED, MyActionEnum.APPROVE, ["CUSTOM_APPROVE_PERM"]);
+ * ```
+ *
+ * ---
+ * **Usage — context-driven (multi-outcome) transition**
+ * ```typescript
+ * createActionConfig(
+ *   (ctx: IMyContextData) => ctx.fast ? MyStatusEnum.APPROVED : MyStatusEnum.PENDING,
+ *   MyActionEnum.APPROVE,
+ * );
+ * ```
+ *
+ * ---
+ * **Usage — subset narrowing**
+ * Restrict the compiler to a subset of the action's possible target statuses:
+ * ```typescript
+ * createActionConfig<MyActionEnum.APPROVE, MyStatusEnum.APPROVED>(
+ *   MyStatusEnum.APPROVED,
+ *   MyActionEnum.APPROVE,
+ * );
+ * ```
+ *
+ * ---
+ * **Extending base enums**
+ * TypeScript enums cannot be inherited, but entity-specific enums can
+ * re-declare base values and add new ones:
+ * ```typescript
+ * import { BaseFlowActionEnum, BaseFlowStatusEnum } from "./base-flow-config.enums";
+ *
+ * export enum VendorActionEnum {
+ *   VIEW       = BaseFlowActionEnum.VIEW,
+ *   CREATE     = BaseFlowActionEnum.CREATE,
+ *   UPDATE     = BaseFlowActionEnum.UPDATE,
+ *   DELETE     = BaseFlowActionEnum.DELETE,
+ *   APPROVE    = BaseFlowActionEnum.APPROVE,
+ *   REJECT     = BaseFlowActionEnum.REJECT,
+ *   RECALL     = BaseFlowActionEnum.RECALL,
+ *   DEACTIVATE = BaseFlowActionEnum.DEACTIVATE,
+ *   SUBMIT     = "submit",   // ← extension
+ * }
+ *
+ * export enum VendorStatusEnum {
+ *   ACTIVE                  = BaseFlowStatusEnum.ACTIVE,
+ *   // ... all base statuses ...
+ *   SUBMITTED               = "SUBMITTED",   // ← extension
+ * }
+ * ```
+ */
+/**
+ * Shape of a single entry in the action map.
+ * `statuses` must be a `const` tuple so TypeScript preserves the exact union
+ * of reachable statuses for subset-narrowing in `createActionConfig`.
+ */
+export type ActionMapEntry<S extends string> = {
+    readonly reachableStatues: readonly S[];
+    readonly permissions: string[];
+};
+/**
+ * Full action map: one entry per action value.
+ * Use `satisfies ActionMap<MyActionEnum, MyStatusEnum>` on your map literal
+ * so that the compiler catches missing/misspelled keys while still preserving
+ * the precise `as const` tuple types for subset-narrowing.
+ *
+ * @example
+ * const ACTION_MAP = {
+ *   [MyActionEnum.APPROVE]: { statuses: [MyStatusEnum.APPROVED] as const, permissions: ["MY_APPROVE"] },
+ * } satisfies ActionMap<MyActionEnum, MyStatusEnum>;
+ */
+export type ActionMap<A extends string, S extends string> = {
+    readonly [key in A]: ActionMapEntry<S>;
+};
+/**
+ * Curried factory — call with the context-data type first, then pass the
+ * action map. This two-step pattern lets TypeScript infer the precise action
+ * map type (preserving `as const` tuple narrowing) while still allowing the
+ * caller to set the context-data type explicitly.
+ *
+ * @template CTX - Shape of the context object passed to function-based
+ *                 transition resolvers. Use `never` for flows where `next()`
+ *                 needs no runtime data (equivalent to `() => status`).
+ *
+ * @returns A function that accepts an `ActionMap` and returns `createActionConfig`.
+ */
+export declare function createFlowConfigFactory<CTX = never>(): <A extends string, S extends string, AM extends ActionMap<A, S>>(actionMap: AM) => {
+    createActionConfig: <Act extends A, Subset extends { [key in A]: AM[key]["reachableStatues"]; }[Act][number] = { [key in A]: AM[key]["reachableStatues"]; }[Act][number]>(action: Act, nextStatus: Subset | ((context: CTX) => Subset), overridePermissions?: string[]) => {
+        permissions: string[];
+        next: (context: CTX) => Subset;
+    };
+    createTransition: <Act extends A, Subset_1 extends { [key in A]: AM[key]["reachableStatues"]; }[Act][number] = { [key in A]: AM[key]["reachableStatues"]; }[Act][number]>(transition: Subset_1 | ((context: CTX) => Subset_1)) => (context: CTX) => Subset_1;
+};

package/dist/src/entities/flow-configs/base-flow-config.factory.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Generic flow-config factory.
+ *
+ * Provides a reusable, type-safe `createActionConfig` helper for any entity
+ * flow configuration. Eliminates boilerplate type plumbing (ActionStatusMap,
+ * StateStatusForAction, createTransition) that would otherwise be duplicated
+ * in every flow config file.
+ *
+ * ---
+ * **Usage — basic**
+ * ```typescript
+ * import { createFlowConfigFactory } from "./base-flow-config.factory";
+ *
+ * const ACTION_MAP = {
+ *   [MyActionEnum.APPROVE]: { statuses: [MyStatusEnum.APPROVED] as const, permissions: ["MY_APPROVE"] },
+ *   [MyActionEnum.REJECT]:  { statuses: [MyStatusEnum.REJECTED]  as const, permissions: ["MY_REJECT"]  },
+ * } satisfies ActionMap<MyActionEnum, MyStatusEnum>;
+ *
+ * const { createActionConfig } = createFlowConfigFactory<IMyContextData>()(ACTION_MAP);
+ *
+ * const transition = createActionConfig(MyStatusEnum.APPROVED, MyActionEnum.APPROVE);
+ * ```
+ *
+ * ---
+ * **Usage — overriding a transition permission**
+ * ```typescript
+ * createActionConfig(MyStatusEnum.APPROVED, MyActionEnum.APPROVE, ["CUSTOM_APPROVE_PERM"]);
+ * ```
+ *
+ * ---
+ * **Usage — context-driven (multi-outcome) transition**
+ * ```typescript
+ * createActionConfig(
+ *   (ctx: IMyContextData) => ctx.fast ? MyStatusEnum.APPROVED : MyStatusEnum.PENDING,
+ *   MyActionEnum.APPROVE,
+ * );
+ * ```
+ *
+ * ---
+ * **Usage — subset narrowing**
+ * Restrict the compiler to a subset of the action's possible target statuses:
+ * ```typescript
+ * createActionConfig<MyActionEnum.APPROVE, MyStatusEnum.APPROVED>(
+ *   MyStatusEnum.APPROVED,
+ *   MyActionEnum.APPROVE,
+ * );
+ * ```
+ *
+ * ---
+ * **Extending base enums**
+ * TypeScript enums cannot be inherited, but entity-specific enums can
+ * re-declare base values and add new ones:
+ * ```typescript
+ * import { BaseFlowActionEnum, BaseFlowStatusEnum } from "./base-flow-config.enums";
+ *
+ * export enum VendorActionEnum {
+ *   VIEW       = BaseFlowActionEnum.VIEW,
+ *   CREATE     = BaseFlowActionEnum.CREATE,
+ *   UPDATE     = BaseFlowActionEnum.UPDATE,
+ *   DELETE     = BaseFlowActionEnum.DELETE,
+ *   APPROVE    = BaseFlowActionEnum.APPROVE,
+ *   REJECT     = BaseFlowActionEnum.REJECT,
+ *   RECALL     = BaseFlowActionEnum.RECALL,
+ *   DEACTIVATE = BaseFlowActionEnum.DEACTIVATE,
+ *   SUBMIT     = "submit",   // ← extension
+ * }
+ *
+ * export enum VendorStatusEnum {
+ *   ACTIVE                  = BaseFlowStatusEnum.ACTIVE,
+ *   // ... all base statuses ...
+ *   SUBMITTED               = "SUBMITTED",   // ← extension
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFlowConfigFactory = createFlowConfigFactory;
+/**
+ * Curried factory — call with the context-data type first, then pass the
+ * action map. This two-step pattern lets TypeScript infer the precise action
+ * map type (preserving `as const` tuple narrowing) while still allowing the
+ * caller to set the context-data type explicitly.
+ *
+ * @template CTX - Shape of the context object passed to function-based
+ *                 transition resolvers. Use `never` for flows where `next()`
+ *                 needs no runtime data (equivalent to `() => status`).
+ *
+ * @returns A function that accepts an `ActionMap` and returns `createActionConfig`.
+ */
+function createFlowConfigFactory() {
+    return function (actionMap) {
+        const createTransition = (transition) => (context) => {
+            if (typeof transition === "function") {
+                return transition(context);
+            }
+            return transition;
+        };
+        /**
+         * Builds a single typed action-config entry for use inside a
+         * `FlowConfig` status block.
+         *
+         * @param action       The action this config is for (used to look up
+         *                     default permissions from `actionMap`).
+         * @param nextStatus   Fixed target status, or a function `(ctx) => status`
+         *                     for context-driven transitions.
+         * @param overridePermissions  Optional permission list that replaces the
+         *                     default from `actionMap[action].permissions`.
+         *
+         * @typeParam Act    Specific action enum member (narrows `StatusForAction`).
+         * @typeParam Subset Subset of reachable statuses to enforce at this
+         *                   (currentStatus, action) pair. Must be a subtype of
+         *                   `StatusForAction<Act>`.
+         */
+        const createActionConfig = (action, nextStatus, overridePermissions) => ({
+            permissions: overridePermissions !== null && overridePermissions !== void 0 ? overridePermissions : actionMap[action].permissions,
+            next: createTransition(nextStatus),
+        });
+        return { createActionConfig, createTransition };
+    };
+}

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

@@ -1,4 +1,8 @@
 import { LeaveActionEnum } from "../enums/leave.action.enum";
 import { LeaveStatusEnum } from "../enums/leave.status.enum";
+import { LeaveEntityModel } from "../model/leave.entity.model";
 import { FlowConfig } from "./flow-config.type";
-export declare const leaveFlowConfig: FlowConfig<LeaveStatusEnum, LeaveActionEnum, never>;
+export interface ILeaveFlowConfigContextData {
+    leaveEntity?: LeaveEntityModel;
+}
+export declare const leaveFlowConfig: FlowConfig<LeaveStatusEnum, LeaveActionEnum, ILeaveFlowConfigContextData>;