law-common 13.0.1-beta.9 → 13.0.2

package/dist/src/api/interface/bank.entity.response.d.ts

@@ -1,14 +1,11 @@
-import { BankActionEnum, BankStatusEnum, IBankEntity, IIntermediaryBankEntity } from "../../entities";
-export type IBankFlowConfig = {
-    [key in BankStatusEnum]?: {
-        actions: {
-            [key in BankActionEnum]?: {
-                permissions: string[];
-                next: () => BankStatusEnum;
-            };
-        };
-    };
-};
+import { BankActionEnum, BankStatusEnum, FlowConfig, IBankEntity, IIntermediaryBankEntity } from "../../entities";
+/**
+ * LW-828: this used to re-declare the flow-config shape by hand. It is now an alias of the shared
+ * `FlowConfig`, instantiated with `void` as the context type because `next` here is called with no
+ * arguments (`BankService.getBankNextStatus`). Kept as a named type so every consumer — including
+ * law-admin-web, which receives this config over `GET /bank/flow-config` — keeps compiling unchanged.
+ */
+export type IBankFlowConfig = FlowConfig<BankStatusEnum, BankActionEnum, void>;
 export interface IBankEntityGet extends IBankEntity {
     intermediaryBankDetails?: IIntermediaryBankEntity[];
 }

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

@@ -1,7 +1,8 @@
 import { IEntityCreateDto, Nullable } from "../../entities";
 import { IAppFileConfig, IFilePayload, MulterFileWithUrl } from "../../misc";
 import { IDocumentUploadEntity } from "../../entities/interface/document_upload.entity.interface";
-export type IDocumentUploadCreateExclude = "gstDocument" | "additionalDocuments";
+/** status is set by the entity flow, never by the client */
+export type IDocumentUploadCreateExclude = "gstDocument" | "additionalDocuments" | "status";
 export interface IDocumentUploadCreateDto extends Omit<IEntityCreateDto<IDocumentUploadEntity>, IDocumentUploadCreateExclude> {
     gstDocument?: Nullable<MulterFileWithUrl>;
     additionalDocuments?: Nullable<MulterFileWithUrl[]>;

package/dist/src/api/interface/reimbursement.entity.response.d.ts

@@ -1,4 +1,4 @@
-import { IReimbursementEntity, IReimbursementExpenseEntity, IUserEntity, ReimbursementActionEnum, ReimbursementExpenseActionEnum, ReimbursementExpenseState, ReimbursementStatusEnum } from "../../entities";
+import { IReimbursementEntity, IReimbursementExpenseEntity, IUserEntity, ParentChildFlowConfig, ReimbursementActionEnum, ReimbursementExpenseActionEnum, ReimbursementExpenseState, ReimbursementStatusEnum } from "../../entities";
 import { IProjectEntityGet } from "./project.entity.response";
 export type IReimbursementEntityGet = {
     reimbursements: IReimbursementResponse[];
@@ -7,28 +7,14 @@ export type IReimbursementEntityGet = {
     };
     projects: IProjectEntityGet;
 };
-export type IReimbursementFlowConfig = {
-    parent: {
-        [key in ReimbursementStatusEnum]?: {
-            actions: {
-                [key in ReimbursementActionEnum]?: {
-                    permissions: string[];
-                    next?: (data: IReimbursementFlowContextData) => ReimbursementStatusEnum;
-                };
-            };
-        };
-    };
-    child: {
-        [key in ReimbursementExpenseState]?: {
-            actions: {
-                [key in ReimbursementExpenseActionEnum]?: {
-                    permissions: string[];
-                    next?: () => ReimbursementExpenseState;
-                };
-            };
-        };
-    };
-};
+/**
+ * LW-828: this used to re-declare the parent/child flow-config shape by hand. It is now an alias of the
+ * shared `ParentChildFlowConfig`, instantiated with `IReimbursementFlowContextData` for the parent and
+ * `void` for the child — the child's `next` is called with no argument in
+ * `ReimbursementExpenseService.getReimbursementNextStatusForChild`. Kept as a named type so every
+ * existing consumer keeps compiling unchanged.
+ */
+export type IReimbursementFlowConfig = ParentChildFlowConfig<ReimbursementStatusEnum, ReimbursementActionEnum, ReimbursementExpenseState, ReimbursementExpenseActionEnum, IReimbursementFlowContextData, void>;
 export type IReimbursementFlowContextData = {
     expenseDetails: IReimbursementExpenseEntity[];
 };

package/dist/src/api/interface/timesheet.entity.response.interface.d.ts

@@ -1,4 +1,4 @@
-import { IProjectUserMappingEntity, ITimesheetEntity, IUserEntity, TimesheetActionEnum, TimesheetEntityModel, TimesheetStatusEnum } from "../../entities";
+import { FlowConfig, IProjectUserMappingEntity, ITimesheetEntity, IUserEntity, TimesheetActionEnum, TimesheetEntityModel, TimesheetStatusEnum } from "../../entities";
 import { IClientApiEntityDependent } from "./client.entity.response";
 import { IProjectApiEntityDependent } from "./project.entity.response";
 import { ITimesheetEntityUpdateDto } from "./timesheet.update.dto.interface";
@@ -15,18 +15,12 @@ export type ITimesheetEntityGet = {
     };
     tasks: string[];
 };
-export type ITimesheetFlowConfig = {
-    [key in TimesheetStatusEnum]?: {
-        actions: {
-            [key in TimesheetActionEnum]?: {
-                permissions: string[];
-                isApplicable?: (data: ITimesheetFlowContextData) => boolean;
-                next: (data: ITimesheetFlowContextData) => TimesheetStatusEnum;
-                validActionPastThreshold?: boolean;
-            };
-        };
-    };
-};
+/**
+ * LW-828: this used to re-declare the flow-config shape by hand. It is now an alias of the shared
+ * `FlowConfig`, whose action config carries the optional `isApplicable` and `validActionPastThreshold`
+ * this entity relies on. Kept as a named type so every existing consumer keeps compiling unchanged.
+ */
+export type ITimesheetFlowConfig = FlowConfig<TimesheetStatusEnum, TimesheetActionEnum, ITimesheetFlowContextData>;
 export type ITimesheetFlowContextData = {
     currentTimesheet?: TimesheetEntityModel;
     projectUserMapping?: IProjectUserMappingEntity;

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

@@ -0,0 +1,5 @@
+export declare enum DocumentUploadStatusEnum {
+    APPROVED = "APPROVED",
+    DEACTIVATED = "DEACTIVATED",
+    DELETED = "DELETED"
+}

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentUploadStatusEnum = void 0;
+var DocumentUploadStatusEnum;
+(function (DocumentUploadStatusEnum) {
+    DocumentUploadStatusEnum["APPROVED"] = "APPROVED";
+    DocumentUploadStatusEnum["DEACTIVATED"] = "DEACTIVATED";
+    DocumentUploadStatusEnum["DELETED"] = "DELETED";
+})(DocumentUploadStatusEnum || (exports.DocumentUploadStatusEnum = DocumentUploadStatusEnum = {}));

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

@@ -0,0 +1,9 @@
+import { BankActionEnum } from "../enums/bank_action_enum";
+import { BankStatusEnum } from "../enums/bank_status_enum";
+import { FlowConfig } from "./flow-config.type";
+/**
+ * Typed with `FlowConfig` directly rather than importing `IBankFlowConfig` from `src/api`, so that
+ * `entities` does not reach into `api` for a type it can express itself. `IBankFlowConfig` is now an
+ * alias of this same instantiation, so the two cannot drift.
+ */
+export declare const bankFlowConfig: FlowConfig<BankStatusEnum, BankActionEnum, void>;

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

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bankFlowConfig = void 0;
+const bank_action_enum_1 = require("../enums/bank_action_enum");
+const bank_status_enum_1 = require("../enums/bank_status_enum");
+const base_flow_config_factory_1 = require("./base-flow-config.factory");
+const BANK_APPROVER_PERMISSION = ["BANK_APPROVER_ORG"];
+const BANK_UPDATE_PERMISSION = ["BANK_UPDATE_ORG"];
+const ACTION_MAP = {
+    // VIEW and CREATE are declared on BankActionEnum but carry no transition in this flow. They are
+    // listed so the map covers every enum member; the empty reachable set makes createActionConfig
+    // uncallable for them.
+    [bank_action_enum_1.BankActionEnum.VIEW]: {
+        reachableStatues: [],
+        permissions: [],
+    },
+    [bank_action_enum_1.BankActionEnum.CREATE]: {
+        reachableStatues: [],
+        permissions: [],
+    },
+    [bank_action_enum_1.BankActionEnum.UPDATE]: {
+        reachableStatues: [bank_status_enum_1.BankStatusEnum.CREATE_APPROVAL_PENDING, bank_status_enum_1.BankStatusEnum.UPDATE_APPROVAL_PENDING],
+        permissions: BANK_UPDATE_PERMISSION,
+    },
+    [bank_action_enum_1.BankActionEnum.DELETE]: {
+        reachableStatues: [bank_status_enum_1.BankStatusEnum.DELETE_APPROVAL_PENDING, bank_status_enum_1.BankStatusEnum.DELETED],
+        permissions: BANK_UPDATE_PERMISSION,
+    },
+    [bank_action_enum_1.BankActionEnum.APPROVE]: {
+        reachableStatues: [bank_status_enum_1.BankStatusEnum.APPROVED, bank_status_enum_1.BankStatusEnum.DELETED],
+        permissions: BANK_APPROVER_PERMISSION,
+    },
+    [bank_action_enum_1.BankActionEnum.REJECT]: {
+        reachableStatues: [bank_status_enum_1.BankStatusEnum.REJECTED, bank_status_enum_1.BankStatusEnum.RESOLVED_REJECTED],
+        permissions: BANK_APPROVER_PERMISSION,
+    },
+    [bank_action_enum_1.BankActionEnum.RECALL]: {
+        reachableStatues: [bank_status_enum_1.BankStatusEnum.DELETED],
+        permissions: BANK_UPDATE_PERMISSION,
+    },
+};
+/**
+ * The context type is `void` rather than `never` or an empty interface, because `IBankFlowConfig`
+ * declares `next: () => BankStatusEnum` and `BankService.getBankNextStatus` calls
+ * `matchingPermissionConfig.next()` with no arguments. A `void` parameter may be omitted at the call
+ * site, so that call keeps compiling; `never` would have required an argument nobody can produce.
+ */
+const { createActionConfig } = (0, base_flow_config_factory_1.createFlowConfigFactory)()(ACTION_MAP);
+// CREATE_APPROVAL_PENDING status transitions
+const transitionCreateApprovalPendingStatusApproveAction = createActionConfig(bank_action_enum_1.BankActionEnum.APPROVE, bank_status_enum_1.BankStatusEnum.APPROVED);
+const transitionCreateApprovalPendingStatusUpdateAction = createActionConfig(bank_action_enum_1.BankActionEnum.UPDATE, bank_status_enum_1.BankStatusEnum.CREATE_APPROVAL_PENDING);
+const transitionCreateApprovalPendingStatusRejectAction = createActionConfig(bank_action_enum_1.BankActionEnum.REJECT, bank_status_enum_1.BankStatusEnum.REJECTED);
+const transitionCreateApprovalPendingStatusDeleteAction = createActionConfig(bank_action_enum_1.BankActionEnum.DELETE, bank_status_enum_1.BankStatusEnum.DELETED);
+// UPDATE_APPROVAL_PENDING status transitions
+const transitionUpdateApprovalPendingStatusApproveAction = createActionConfig(bank_action_enum_1.BankActionEnum.APPROVE, bank_status_enum_1.BankStatusEnum.APPROVED);
+const transitionUpdateApprovalPendingStatusUpdateAction = createActionConfig(bank_action_enum_1.BankActionEnum.UPDATE, bank_status_enum_1.BankStatusEnum.UPDATE_APPROVAL_PENDING);
+const transitionUpdateApprovalPendingStatusRejectAction = createActionConfig(bank_action_enum_1.BankActionEnum.REJECT, bank_status_enum_1.BankStatusEnum.RESOLVED_REJECTED);
+const transitionUpdateApprovalPendingStatusRecallAction = createActionConfig(bank_action_enum_1.BankActionEnum.RECALL, bank_status_enum_1.BankStatusEnum.DELETED);
+// DELETE_APPROVAL_PENDING status transitions
+const transitionDeleteApprovalPendingStatusApproveAction = createActionConfig(bank_action_enum_1.BankActionEnum.APPROVE, bank_status_enum_1.BankStatusEnum.DELETED);
+const transitionDeleteApprovalPendingStatusRejectAction = createActionConfig(bank_action_enum_1.BankActionEnum.REJECT, bank_status_enum_1.BankStatusEnum.RESOLVED_REJECTED);
+const transitionDeleteApprovalPendingStatusRecallAction = createActionConfig(bank_action_enum_1.BankActionEnum.RECALL, bank_status_enum_1.BankStatusEnum.DELETED);
+// APPROVED status transitions
+const transitionApprovedStatusUpdateAction = createActionConfig(bank_action_enum_1.BankActionEnum.UPDATE, bank_status_enum_1.BankStatusEnum.UPDATE_APPROVAL_PENDING);
+const transitionApprovedStatusDeleteAction = createActionConfig(bank_action_enum_1.BankActionEnum.DELETE, bank_status_enum_1.BankStatusEnum.DELETE_APPROVAL_PENDING);
+// RESOLVED_REJECTED status transitions
+const transitionResolvedRejectedStatusUpdateAction = createActionConfig(bank_action_enum_1.BankActionEnum.UPDATE, bank_status_enum_1.BankStatusEnum.UPDATE_APPROVAL_PENDING);
+const transitionResolvedRejectedStatusDeleteAction = createActionConfig(bank_action_enum_1.BankActionEnum.DELETE, bank_status_enum_1.BankStatusEnum.DELETE_APPROVAL_PENDING);
+/**
+ * Typed with `FlowConfig` directly rather than importing `IBankFlowConfig` from `src/api`, so that
+ * `entities` does not reach into `api` for a type it can express itself. `IBankFlowConfig` is now an
+ * alias of this same instantiation, so the two cannot drift.
+ */
+exports.bankFlowConfig = {
+    [bank_status_enum_1.BankStatusEnum.CREATE_APPROVAL_PENDING]: {
+        actions: {
+            [bank_action_enum_1.BankActionEnum.APPROVE]: transitionCreateApprovalPendingStatusApproveAction,
+            [bank_action_enum_1.BankActionEnum.UPDATE]: transitionCreateApprovalPendingStatusUpdateAction,
+            [bank_action_enum_1.BankActionEnum.REJECT]: transitionCreateApprovalPendingStatusRejectAction,
+            [bank_action_enum_1.BankActionEnum.DELETE]: transitionCreateApprovalPendingStatusDeleteAction,
+        },
+    },
+    [bank_status_enum_1.BankStatusEnum.UPDATE_APPROVAL_PENDING]: {
+        actions: {
+            [bank_action_enum_1.BankActionEnum.APPROVE]: transitionUpdateApprovalPendingStatusApproveAction,
+            [bank_action_enum_1.BankActionEnum.UPDATE]: transitionUpdateApprovalPendingStatusUpdateAction,
+            [bank_action_enum_1.BankActionEnum.REJECT]: transitionUpdateApprovalPendingStatusRejectAction,
+            [bank_action_enum_1.BankActionEnum.RECALL]: transitionUpdateApprovalPendingStatusRecallAction,
+        },
+    },
+    [bank_status_enum_1.BankStatusEnum.DELETE_APPROVAL_PENDING]: {
+        actions: {
+            [bank_action_enum_1.BankActionEnum.APPROVE]: transitionDeleteApprovalPendingStatusApproveAction,
+            [bank_action_enum_1.BankActionEnum.REJECT]: transitionDeleteApprovalPendingStatusRejectAction,
+            [bank_action_enum_1.BankActionEnum.RECALL]: transitionDeleteApprovalPendingStatusRecallAction,
+        },
+    },
+    [bank_status_enum_1.BankStatusEnum.APPROVED]: {
+        actions: {
+            [bank_action_enum_1.BankActionEnum.UPDATE]: transitionApprovedStatusUpdateAction,
+            [bank_action_enum_1.BankActionEnum.DELETE]: transitionApprovedStatusDeleteAction,
+        },
+    },
+    [bank_status_enum_1.BankStatusEnum.RESOLVED_REJECTED]: {
+        actions: {
+            [bank_action_enum_1.BankActionEnum.UPDATE]: transitionResolvedRejectedStatusUpdateAction,
+            [bank_action_enum_1.BankActionEnum.DELETE]: transitionResolvedRejectedStatusDeleteAction,
+        },
+    },
+};

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

@@ -107,8 +107,27 @@ export type ActionMap<A extends string, S extends string> = {
  *
  * @returns A function that accepts an `ActionMap` and returns `createActionConfig`.
  */
+/**
+ * Optional per-transition extras. Both are spread onto the action config only when supplied, so a
+ * call site that does not pass them produces exactly the object it produced before this argument
+ * existed — the sixteen already-converted flow configs are byte-identical.
+ *
+ * @property isApplicable            runtime guard evaluated against the same context as `next()`
+ * @property validActionPastThreshold whether the action survives a consumer's data-entry threshold
+ * @property description             human-readable copy for this transition. Already part of
+ *                                   `IFlowConfigActionConfig` and rendered by the entity-flow
+ *                                   component, so a converted config must be able to emit it.
+ */
+export type ActionConfigOptions<CTX> = {
+    isApplicable?: (context: CTX) => boolean;
+    validActionPastThreshold?: boolean;
+    description?: string;
+};
 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[]) => {
+    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[], options?: ActionConfigOptions<CTX>) => {
+        description?: string | undefined;
+        validActionPastThreshold?: boolean | undefined;
+        isApplicable?: ((context: CTX) => boolean) | undefined;
         permissions: string[];
         next: (context: CTX) => Subset;
     };

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

@@ -75,18 +75,6 @@
  */
 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) => {
@@ -111,10 +99,7 @@ function createFlowConfigFactory() {
          *                   (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),
-        });
+        const createActionConfig = (action, nextStatus, overridePermissions, options) => (Object.assign(Object.assign(Object.assign({ permissions: overridePermissions !== null && overridePermissions !== void 0 ? overridePermissions : actionMap[action].permissions, next: createTransition(nextStatus) }, ((options === null || options === void 0 ? void 0 : options.isApplicable) !== undefined ? { isApplicable: options.isApplicable } : {})), ((options === null || options === void 0 ? void 0 : options.validActionPastThreshold) !== undefined ? { validActionPastThreshold: options.validActionPastThreshold } : {})), ((options === null || options === void 0 ? void 0 : options.description) !== undefined ? { description: options.description } : {})));
         return { createActionConfig, createTransition };
     };
 }

package/dist/src/entities/flow-configs/{billing.flow.config.d.ts → billing_flow.config.d.ts}

@@ -2,5 +2,5 @@ import { IBillingFlowContextData } from "../../api";
 import { BillingActionsEnum } from "../enums/billing_action_enum";
 import { BillingStatusEnum } from "../enums/billing_status_enum";
 import { FlowConfig } from "./flow-config.type";
-export declare let billingFlowConfig: FlowConfig<BillingStatusEnum, BillingActionsEnum, IBillingFlowContextData>;
+export declare const billingFlowConfig: FlowConfig<BillingStatusEnum, BillingActionsEnum, IBillingFlowContextData>;
 export declare function getNextStatusTotalAmount(data: IBillingFlowContextData): BillingStatusEnum;

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

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.billingFlowConfig = void 0;
+exports.getNextStatusTotalAmount = getNextStatusTotalAmount;
+const error_key_enum_1 = require("../../enums/error.key.enum");
+const exceptions_1 = require("../../exceptions");
+const billing_action_enum_1 = require("../enums/billing_action_enum");
+const billing_status_enum_1 = require("../enums/billing_status_enum");
+const base_flow_config_factory_1 = require("./base-flow-config.factory");
+const BILLING_APPROVER_PERMISSION = ["BILLING_APPROVER_ORG", "BILLING_APPROVER_PROJECT"];
+const BILLING_AMENDMENT_PERMISSION = ["BILLING_AMENDMENT_ORG"];
+const BILLING_REGENERATE_PERMISSION = ["BILLING_UPDATE"];
+const BILLING_PDF_VIEW_PERMISSION = ["BILLING_VIEW_PDF"];
+/**
+ * Every status this flow declares a block for. PDF_VIEW is an identity transition available from each
+ * of them, so this is exactly its reachable set.
+ *
+ * CANCELLED is a target (REJECT, REGENERATE) but has no block of its own — it is terminal.
+ */
+const BILLING_FLOW_STATUSES = [
+    billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL,
+    billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES,
+    billing_status_enum_1.BillingStatusEnum.INTERNAL_APPROVED,
+    billing_status_enum_1.BillingStatusEnum.PENDING_CLIENT_REVIEW,
+    billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL,
+    billing_status_enum_1.BillingStatusEnum.REJECT_CLIENT_REVISION,
+    billing_status_enum_1.BillingStatusEnum.INVOICE_SENT,
+    billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT,
+    billing_status_enum_1.BillingStatusEnum.SETTLED,
+];
+const ACTION_MAP = {
+    [billing_action_enum_1.BillingActionsEnum.APPROVE]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.INTERNAL_APPROVED],
+        permissions: BILLING_APPROVER_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.REJECT]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.CANCELLED, billing_status_enum_1.BillingStatusEnum.REJECT_CLIENT_REVISION],
+        permissions: BILLING_APPROVER_PERMISSION,
+    },
+    /**
+     * UPDATE is the one action whose permission is not constant across its transitions: four of the five
+     * use the approver list, but REQUEST_CHANGES uses the amendment list. The approver list is the default
+     * here and REQUEST_CHANGES passes the amendment list as an override.
+     */
+    [billing_action_enum_1.BillingActionsEnum.UPDATE]: {
+        reachableStatues: [
+            billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL,
+            billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES,
+            billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL,
+            billing_status_enum_1.BillingStatusEnum.INVOICE_SENT,
+        ],
+        permissions: BILLING_APPROVER_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.REQUEST_FOR_CHANGES]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES],
+        permissions: BILLING_APPROVER_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.SENT_FOR_APPROVAL]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL],
+        permissions: BILLING_AMENDMENT_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.SEND_FOR_CLIENT_REVIEW]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.PENDING_CLIENT_REVIEW],
+        permissions: BILLING_AMENDMENT_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.CLIENT_REVISION]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL],
+        permissions: BILLING_AMENDMENT_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.SEND_INVOICE]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT, billing_status_enum_1.BillingStatusEnum.INVOICE_SENT],
+        permissions: BILLING_AMENDMENT_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.APPROVAL]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES],
+        permissions: BILLING_APPROVER_PERMISSION,
+    },
+    /**
+     * UPDATE_PAYMENT is context-driven: `getNextStatusTotalAmount` returns SETTLED once the outstanding
+     * amount reaches zero and PENDING_PAYMENT otherwise. The from-status is also reachable, because both
+     * transitions fall back to it when called without context — which the entity-flow component does.
+     */
+    [billing_action_enum_1.BillingActionsEnum.UPDATE_PAYMENT]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.SETTLED, billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT, billing_status_enum_1.BillingStatusEnum.INVOICE_SENT],
+        permissions: BILLING_AMENDMENT_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.REGENERATE]: {
+        reachableStatues: [billing_status_enum_1.BillingStatusEnum.CANCELLED],
+        permissions: BILLING_REGENERATE_PERMISSION,
+    },
+    [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: {
+        reachableStatues: BILLING_FLOW_STATUSES,
+        permissions: BILLING_PDF_VIEW_PERMISSION,
+    },
+    // CREDIT_NOTE, WRITE_OFF and TDS are declared on BillingActionsEnum but carry no transition in this
+    // flow. They are listed so the map covers every enum member; the empty reachable set makes
+    // createActionConfig uncallable for them.
+    [billing_action_enum_1.BillingActionsEnum.CREDIT_NOTE]: {
+        reachableStatues: [],
+        permissions: [],
+    },
+    [billing_action_enum_1.BillingActionsEnum.WRITE_OFF]: {
+        reachableStatues: [],
+        permissions: [],
+    },
+    [billing_action_enum_1.BillingActionsEnum.TDS]: {
+        reachableStatues: [],
+        permissions: [],
+    },
+};
+const { createActionConfig } = (0, base_flow_config_factory_1.createFlowConfigFactory)()(ACTION_MAP);
+// PENDING_APPROVAL status transitions
+const transitionPendingApprovalStatusApproveAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.APPROVE, billing_status_enum_1.BillingStatusEnum.INTERNAL_APPROVED, undefined, {
+    description: "Internal Approved state signifies that the Proforma Invoice has been reviewed and verified by internal stakeholders.",
+});
+const transitionPendingApprovalStatusRejectAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REJECT, billing_status_enum_1.BillingStatusEnum.CANCELLED, undefined, {
+    description: "Rejected state indicates that the Proforma Invoice was not approved and has been cancelled.",
+});
+const transitionPendingApprovalStatusUpdateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE, billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL, undefined, {
+    description: "Allows stakeholders to edit the Proforma Invoice while keeping it in Pending Approval status.",
+});
+const transitionPendingApprovalStatusRequestForChangesAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REQUEST_FOR_CHANGES, billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES, undefined, { description: "Stakeholders have requested changes before approving the Proforma Invoice." });
+// REQUEST_CHANGES status transitions
+const transitionRequestChangesStatusUpdateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE, billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES, BILLING_AMENDMENT_PERMISSION, // differs from the action default — amendment, not approver
+{ description: "Allows modification of the Proforma Invoice based on stakeholder feedback." });
+const transitionRequestChangesStatusSentForApprovalAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.SENT_FOR_APPROVAL, billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL, undefined, { description: "Resubmits the updated Proforma Invoice for stakeholder approval." });
+// INTERNAL_APPROVED status transitions
+const transitionInternalApprovedStatusSendForClientReviewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.SEND_FOR_CLIENT_REVIEW, billing_status_enum_1.BillingStatusEnum.PENDING_CLIENT_REVIEW, undefined, { description: "Invoice has been internally approved and is sent to the client for review." });
+// PENDING_CLIENT_REVIEW status transitions
+const transitionPendingClientReviewStatusClientRevisionAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.CLIENT_REVISION, billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL, undefined, { description: "Client has requested revisions to the Proforma Invoice." });
+const transitionPendingClientReviewStatusSendInvoiceAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.SEND_INVOICE, billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT, undefined, {
+    description: "Final invoice has been shared with the client and payment is awaited.",
+});
+// CLIENT_REVISION_APPROVAL status transitions
+const transitionClientRevisionApprovalStatusApprovalAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.APPROVAL, billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES, undefined, {
+    description: "Client revision has been reviewed and approved for further amendments.",
+});
+const transitionClientRevisionApprovalStatusRejectAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REJECT, billing_status_enum_1.BillingStatusEnum.REJECT_CLIENT_REVISION, undefined, {
+    description: "Client revision request has been rejected by stakeholders.",
+});
+const transitionClientRevisionApprovalStatusUpdateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE, billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL, undefined, { description: "Allows editing while client revision approval is in progress." });
+const transitionClientRevisionApprovalStatusRequestForChangesAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REQUEST_FOR_CHANGES, billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES, undefined, { description: "Requests additional changes before approving the client revision." });
+// REJECT_CLIENT_REVISION status transitions
+const transitionRejectClientRevisionStatusSendInvoiceAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.SEND_INVOICE, billing_status_enum_1.BillingStatusEnum.INVOICE_SENT, undefined, {
+    description: "Invoice has been sent despite client revision rejection.",
+});
+// INVOICE_SENT status transitions
+const transitionInvoiceSentStatusUpdatePaymentAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE_PAYMENT, (data) => {
+    return data ? getNextStatusTotalAmount(data) : billing_status_enum_1.BillingStatusEnum.INVOICE_SENT;
+}, undefined, { description: "Updates received payment details and recalculates outstanding amount." });
+const transitionInvoiceSentStatusRejectAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REJECT, billing_status_enum_1.BillingStatusEnum.CANCELLED, undefined, {
+    description: "Rejected state indicates that the Proforma Invoice was not approved and has been cancelled.",
+});
+const transitionInvoiceSentStatusUpdateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE, billing_status_enum_1.BillingStatusEnum.INVOICE_SENT, undefined, {
+    description: "Allows stakeholders to edit the invoice while keeping it in Invoice Sent status.",
+});
+const transitionInvoiceSentStatusRegenerateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REGENERATE, billing_status_enum_1.BillingStatusEnum.CANCELLED, undefined, {
+    description: "Regenerates the billing by cancelling the current one and creating a replacement",
+});
+// PENDING_PAYMENT status transitions
+const transitionPendingPaymentStatusUpdatePaymentAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE_PAYMENT, (data) => {
+    return data ? getNextStatusTotalAmount(data) : billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT;
+}, undefined, { description: "Tracks partial or full payments until the invoice is completely settled." });
+const transitionPendingPaymentStatusRejectAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REJECT, billing_status_enum_1.BillingStatusEnum.CANCELLED, undefined, {
+    description: "Rejected state indicates that the Proforma Invoice was not approved and has been cancelled.",
+});
+const transitionPendingPaymentStatusUpdateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.UPDATE, billing_status_enum_1.BillingStatusEnum.INVOICE_SENT, undefined, {
+    description: "Allows stakeholders to edit the invoice while keeping it in Invoice Sent status.",
+});
+const transitionPendingPaymentStatusRegenerateAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.REGENERATE, billing_status_enum_1.BillingStatusEnum.CANCELLED, undefined, {
+    description: "Regenerates the billing by cancelling the current one and creating a replacement",
+});
+/**
+ * PDF_VIEW status transitions — one per status block, each keeping the row where it is. These were
+ * previously attached by mutating the config through `addPdfViewToAllStatuses` after definition; they
+ * are written out explicitly so the exported object is complete and immutable.
+ */
+const transitionPendingApprovalStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL, undefined, {
+    description: "",
+});
+const transitionRequestChangesStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES, undefined, {
+    description: "",
+});
+const transitionInternalApprovedStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.INTERNAL_APPROVED, undefined, {
+    description: "",
+});
+const transitionPendingClientReviewStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.PENDING_CLIENT_REVIEW, undefined, {
+    description: "",
+});
+const transitionClientRevisionApprovalStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL, undefined, { description: "" });
+const transitionRejectClientRevisionStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.REJECT_CLIENT_REVISION, undefined, {
+    description: "",
+});
+const transitionInvoiceSentStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.INVOICE_SENT, undefined, {
+    description: "",
+});
+const transitionPendingPaymentStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT, undefined, {
+    description: "",
+});
+const transitionSettledStatusPdfViewAction = createActionConfig(billing_action_enum_1.BillingActionsEnum.PDF_VIEW, billing_status_enum_1.BillingStatusEnum.SETTLED, undefined, { description: "" });
+exports.billingFlowConfig = {
+    [billing_status_enum_1.BillingStatusEnum.PENDING_APPROVAL]: {
+        description: "The Proforma Invoice has been created and is awaiting review and approval by internal stakeholders (org or project approvers).",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.APPROVE]: transitionPendingApprovalStatusApproveAction,
+            [billing_action_enum_1.BillingActionsEnum.REJECT]: transitionPendingApprovalStatusRejectAction,
+            [billing_action_enum_1.BillingActionsEnum.UPDATE]: transitionPendingApprovalStatusUpdateAction,
+            [billing_action_enum_1.BillingActionsEnum.REQUEST_FOR_CHANGES]: transitionPendingApprovalStatusRequestForChangesAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionPendingApprovalStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.REQUEST_CHANGES]: {
+        description: "Stakeholders have reviewed the Proforma Invoice and requested modifications before it can be approved. The invoice is pending amendments by the billing team.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.UPDATE]: transitionRequestChangesStatusUpdateAction,
+            [billing_action_enum_1.BillingActionsEnum.SENT_FOR_APPROVAL]: transitionRequestChangesStatusSentForApprovalAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionRequestChangesStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.INTERNAL_APPROVED]: {
+        description: "The Proforma Invoice has been reviewed and approved by internal stakeholders. It is now ready to be forwarded to the client for review.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.SEND_FOR_CLIENT_REVIEW]: transitionInternalApprovedStatusSendForClientReviewAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionInternalApprovedStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.PENDING_CLIENT_REVIEW]: {
+        description: "The Proforma Invoice has been shared with the client and is awaiting their response. The client may either accept the invoice or request revisions.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.CLIENT_REVISION]: transitionPendingClientReviewStatusClientRevisionAction,
+            [billing_action_enum_1.BillingActionsEnum.SEND_INVOICE]: transitionPendingClientReviewStatusSendInvoiceAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionPendingClientReviewStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.CLIENT_REVISION_APPROVAL]: {
+        description: "The client has requested revisions to the invoice. Internal stakeholders are reviewing whether to approve the revision request, reject it, or ask for further changes.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.APPROVAL]: transitionClientRevisionApprovalStatusApprovalAction,
+            [billing_action_enum_1.BillingActionsEnum.REJECT]: transitionClientRevisionApprovalStatusRejectAction,
+            [billing_action_enum_1.BillingActionsEnum.UPDATE]: transitionClientRevisionApprovalStatusUpdateAction,
+            [billing_action_enum_1.BillingActionsEnum.REQUEST_FOR_CHANGES]: transitionClientRevisionApprovalStatusRequestForChangesAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionClientRevisionApprovalStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.REJECT_CLIENT_REVISION]: {
+        description: "The client's revision request has been rejected by internal stakeholders. The billing team can proceed to send the original invoice to the client.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.SEND_INVOICE]: transitionRejectClientRevisionStatusSendInvoiceAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionRejectClientRevisionStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.INVOICE_SENT]: {
+        description: "The final invoice has been issued to the client following a rejected revision request. Payment is being tracked; partial payments may be recorded until the invoice is fully settled.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.UPDATE_PAYMENT]: transitionInvoiceSentStatusUpdatePaymentAction,
+            [billing_action_enum_1.BillingActionsEnum.REJECT]: transitionInvoiceSentStatusRejectAction,
+            [billing_action_enum_1.BillingActionsEnum.UPDATE]: transitionInvoiceSentStatusUpdateAction,
+            [billing_action_enum_1.BillingActionsEnum.REGENERATE]: transitionInvoiceSentStatusRegenerateAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionInvoiceSentStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT]: {
+        description: "The final invoice has been sent to the client and payment is awaited. Partial or full payments can be recorded; the invoice remains in this state until the total amount is fully settled.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.UPDATE_PAYMENT]: transitionPendingPaymentStatusUpdatePaymentAction,
+            [billing_action_enum_1.BillingActionsEnum.REJECT]: transitionPendingPaymentStatusRejectAction,
+            [billing_action_enum_1.BillingActionsEnum.UPDATE]: transitionPendingPaymentStatusUpdateAction,
+            [billing_action_enum_1.BillingActionsEnum.REGENERATE]: transitionPendingPaymentStatusRegenerateAction,
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionPendingPaymentStatusPdfViewAction,
+        },
+    },
+    [billing_status_enum_1.BillingStatusEnum.SETTLED]: {
+        description: "The invoice has been fully settled. The total amount due has been accounted for through a combination of payments, credit notes, write-offs, TDS, and refunds. No further actions are required.",
+        actions: {
+            [billing_action_enum_1.BillingActionsEnum.PDF_VIEW]: transitionSettledStatusPdfViewAction,
+        },
+    },
+};
+function getNextStatusTotalAmount(data) {
+    var _a, _b, _c, _d, _e;
+    const { currentBilling, dto } = data;
+    if (!currentBilling) {
+        throw new exceptions_1.AppBadRequestException({
+            key: error_key_enum_1.ErrorKeyEnum.BILLING,
+            message: ["Current billing entity is required"],
+        });
+    }
+    if (!dto) {
+        throw new exceptions_1.AppBadRequestException({
+            key: error_key_enum_1.ErrorKeyEnum.BILLING,
+            message: ["Current billing entity is required"],
+        });
+    }
+    if (Number(currentBilling.totalAmount) ===
+        Number((_a = dto.totalAmountPaid) !== null && _a !== void 0 ? _a : currentBilling.totalAmountPaid) +
+            Number((_b = dto.creditNoteAmount) !== null && _b !== void 0 ? _b : currentBilling.creditNoteAmount) +
+            Number((_c = dto.writeoffAmount) !== null && _c !== void 0 ? _c : currentBilling.writeoffAmount) +
+            Number((_d = dto.tdsAmount) !== null && _d !== void 0 ? _d : currentBilling.tdsAmount) -
+            Number((_e = dto.refundAmount) !== null && _e !== void 0 ? _e : currentBilling.refundAmount)) {
+        return billing_status_enum_1.BillingStatusEnum.SETTLED;
+    }
+    else {
+        return billing_status_enum_1.BillingStatusEnum.PENDING_PAYMENT;
+    }
+}