@appcorp/stellar-solutions-invoice-module 0.1.74 → 0.1.75

package/base-modules/payment/context.js

@@ -1,35 +1,8 @@
 /**
- * Payment State Context
+ * Payment State Context - Using Generic Module Factory
  *
- * This module provides comprehensive state management for the Payment feature including:
- * - CRUD operations (create, read, update, delete)
- * - Form validation and error handling
- * - Search and filtering functionality
- * - Pagination controls
- * - Payment mode and quote invoice integration
- * - Currency management with default selection
- * - Internationalization support
- * - Theme-aware toast notifications
- *
- * Organization:
- * - Types & Interfaces
- * - Main Hook (usePaymentState)
- *   - State & Core Hooks
- *   - Debounced Values
- *   - API Parameters (memoized)
- *   - API Callbacks (with error handling)
- *   - Module Entity Hook
- *   - Effects (list refresh, currency defaults)
- *   - Drawer & Modal Handlers
- *   - CRUD Operation Handlers
- *   - Form Handlers
- *   - Pagination Handlers
- *   - Search Handlers
- *   - Table Actions (memoized)
- *   - Return State
- * - Context Setup
- * - Provider Component
- * - Custom Hook
+ * This module provides comprehensive state management for the Payment feature using
+ * the createGenericModule factory pattern.
  */
 "use client";
 "use strict";
@@ -44,88 +17,165 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+};
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usePaymentStateContext = exports.PaymentStateContextProvider = exports.PaymentStateContext = void 0;
-var react_1 = __importStar(require("react"));
+exports.usePaymentModule = exports.initialPaymentState = exports.PAYMENT_ACTION_TYPES = exports.paymentModuleConfig = exports.usePaymentCoreContext = exports.PaymentCoreProvider = exports.paymentReducer = void 0;
+var react_1 = require("react");
 var next_themes_1 = require("next-themes");
 var next_intl_1 = require("next-intl");
 var util_functions_1 = require("@react-pakistan/util-functions");
+var generic_module_factory_1 = require("@react-pakistan/util-functions/factory/generic-module-factory");
+var generic_component_factory_1 = require("@react-pakistan/util-functions/factory/generic-component-factory");
 var context_1 = require("@appcorp/stellar-solutions-modules/global-modules/preferences/context");
-var actions_1 = require("./actions");
 var constants_1 = require("./constants");
-var reducer_1 = require("./reducer");
 var toast_utils_1 = require("@appcorp/shadcn/lib/toast-utils");
-var types_1 = require("./types");
+// import { PAYMENT_DRAWER, PAYMENT_TYPE, PaymentTypeBE } from "./types";
+// import { PaymentModeTypeBE } from "@appcorp/stellar-solutions-modules/global-modules/payment-mode/types";
+// import { QuoteInvoiceTypeBE } from "../invoice/types";
 var validate_1 = require("./validate");
+var cache_1 = require("./cache");
 var context_2 = require("../invoice/context");
 // ============================================================================
-// MAIN HOOK
+// MODULE CONFIGURATION
+// ============================================================================
+var paymentConfig = {
+    name: "Payment",
+    displayName: "Payment",
+    initialState: {
+        // List data
+        items: [],
+        count: 0,
+        // Search & Pagination
+        currentPage: 1,
+        pageLimit: constants_1.pageLimit,
+        searchQuery: "",
+        // UI state
+        disableSaveButton: true,
+        drawer: null,
+        modal: null,
+        // Errors
+        errors: {},
+        // Form data
+        amount: "",
+        attachment: "",
+        balance: "",
+        currency: "",
+        date: new Date().toISOString(),
+        description: "",
+        id: "",
+        mode: "Create",
+        paymentModeId: "",
+        paymentModeQuery: "",
+        paymentType: util_functions_1.PAYMENT_TYPE.FULL_AMOUNT,
+        quoteInvoiceId: "",
+        quoteInvoiceQuery: "",
+        ref: "",
+        invoice: null,
+        // Related entities
+        paymentModes: [],
+        quoteInvoices: [],
+        paymentMode: undefined,
+        quoteInvoice: undefined,
+    },
+    drawerTypes: __assign({}, generic_component_factory_1.DRAWER_TYPES),
+};
+// ============================================================================
+// CREATE PAYMENT MODULE
+// ============================================================================
+exports.paymentReducer = (_a = (0, generic_module_factory_1.createGenericModule)(paymentConfig), _a.reducer), exports.PaymentCoreProvider = _a.Provider, exports.usePaymentCoreContext = _a.useContext, exports.paymentModuleConfig = _a.config, exports.PAYMENT_ACTION_TYPES = _a.actionTypes, exports.initialPaymentState = _a.initialState;
 // ============================================================================
-var usePaymentState = function () {
+// ENHANCED PAYMENT HOOK WITH API INTEGRATION
+// ============================================================================
+// interface StateProviderProps {
+//   children: ReactNode;
+// }
+var usePaymentModule = function () {
+    var _a;
     // ---------------------------------------------------------------------------
-    // STATE & CORE HOOKS
+    // State via factory context
     // ---------------------------------------------------------------------------
-    var invoices = (0, context_2.useInvoiceStateContext)().invoices;
-    var _a = (0, react_1.useReducer)(reducer_1.paymentReducer, reducer_1.initialPaymentState), state = _a[0], dispatch = _a[1];
+    var context = (0, exports.usePaymentCoreContext)();
+    var state = context.state;
+    var invoiceState = (0, context_2.useInvoiceModule)().state;
+    var invoices = (_a = invoiceState === null || invoiceState === void 0 ? void 0 : invoiceState.items) !== null && _a !== void 0 ? _a : [];
     var theme = (0, next_themes_1.useTheme)().theme;
     var t = (0, next_intl_1.useTranslations)("payment");
     var currencies = (0, context_1.usePreferenceStateContext)().currencies;
-    // const tCommon = useTranslations("common");
     // ---------------------------------------------------------------------------
-    // DEBOUNCED VALUES
+    // Toast Helpers
+    // ---------------------------------------------------------------------------
+    var showErrorToast = (0, react_1.useCallback)(function (description) {
+        (0, toast_utils_1.generateThemeToast)({
+            description: description,
+            theme: theme,
+            variant: toast_utils_1.TOAST_VARIANT.ERROR,
+        });
+    }, [theme]);
+    var showSuccessToast = (0, react_1.useCallback)(function (description) {
+        (0, toast_utils_1.generateThemeToast)({
+            description: description,
+            theme: theme,
+            variant: toast_utils_1.TOAST_VARIANT.SUCCESS,
+        });
+    }, [theme]);
+    // ---------------------------------------------------------------------------
+    // Debounced Values
     // ---------------------------------------------------------------------------
     var debouncedQuery = (0, util_functions_1.useDebounce)(state.searchQuery, 800);
     // ---------------------------------------------------------------------------
-    // API PARAMETERS
+    // API Parameters
     // ---------------------------------------------------------------------------
     var listParams = (0, react_1.useMemo)(function () { return ({
         currentPage: state.currentPage,
+        includePaymentMode: true,
+        includeQuoteInvoice: true,
         pageLimit: state.pageLimit,
         searchQuery: state.searchQuery,
-        includeQuoteInvoice: true,
-        includePaymentMode: true,
     }); }, [state.currentPage, state.pageLimit, state.searchQuery]);
     var updateParams = (0, react_1.useMemo)(function () {
         var _a, _b;
         return ({
-            amount: state.amount,
+            amount: parseFloat(state.amount),
             attachment: state.attachment,
-            balance: state.balance,
+            balance: parseFloat(state.balance),
             currency: state.currency,
-            date: state.date,
+            date: new Date(state.date),
             description: ((_a = state.description) === null || _a === void 0 ? void 0 : _a.trim()) || "",
             id: state.id,
             paymentModeId: state.paymentModeId,
@@ -137,60 +187,52 @@ var usePaymentState = function () {
     var byIdParams = (0, react_1.useMemo)(function () { return ({ id: state.id }); }, [state.id]);
     var deleteParams = (0, react_1.useMemo)(function () { return ({ id: state.id }); }, [state.id]);
     // ---------------------------------------------------------------------------
-    // API CALLBACKS
+    // Currency Default
+    // ---------------------------------------------------------------------------
+    var defaultCurrency = (0, react_1.useMemo)(function () {
+        return currencies.filter(function (_a) {
+            var isDefault = _a.isDefault;
+            return isDefault;
+        })[0];
+    }, [currencies]);
+    // ---------------------------------------------------------------------------
+    // API Callbacks
     // ---------------------------------------------------------------------------
-    var showErrorToast = (0, react_1.useCallback)(function (description) {
-        (0, toast_utils_1.generateThemeToast)({
-            description: description,
-            theme: theme,
-            variant: toast_utils_1.TOAST_VARIANT.ERROR,
-        });
-    }, [theme]);
-    var showSuccessToast = (0, react_1.useCallback)(function (description) {
-        (0, toast_utils_1.generateThemeToast)({
-            description: description,
-            theme: theme,
-            variant: toast_utils_1.TOAST_VARIANT.SUCCESS,
-        });
-    }, [theme]);
     var listCallback = (0, react_1.useCallback)(function (_a) {
+        var _b;
         var data = _a.data, error = _a.error;
         if (error) {
             showErrorToast(t("messagesNetworkError"));
         }
         if (data === null || data === void 0 ? void 0 : data.items) {
-            dispatch({
-                payload: { payments: data.items },
-                type: actions_1.PAYMENT_ACTION_TYPES.SET_PAYMENTS,
-            });
-            dispatch({
-                payload: { count: data === null || data === void 0 ? void 0 : data.count },
-                type: actions_1.PAYMENT_ACTION_TYPES.SET_COUNT,
+            context.dispatch({
+                type: exports.PAYMENT_ACTION_TYPES.SET_ITEMS,
+                payload: { items: data.items, count: (_b = data === null || data === void 0 ? void 0 : data.count) !== null && _b !== void 0 ? _b : 0 },
             });
         }
-    }, [dispatch, showErrorToast, t]);
+    }, [t, showErrorToast]);
     var updateCallback = (0, react_1.useCallback)(function (_a) {
         var data = _a.data, error = _a.error;
         if (error) {
             showErrorToast(t("messagesNetworkError"));
         }
         if (data) {
+            (0, cache_1.invalidatePaymentsCache)();
             showSuccessToast(t("messagesPaymentUpdated"));
-            dispatch({
-                type: actions_1.PAYMENT_ACTION_TYPES.RESET_FORM,
-            });
-            dispatch({
-                type: actions_1.PAYMENT_ACTION_TYPES.RESET_ERRORS,
+            context.dispatch({ type: exports.PAYMENT_ACTION_TYPES.RESET_FORM });
+            context.dispatch({
+                type: exports.PAYMENT_ACTION_TYPES.SET_ERRORS,
+                payload: { errors: {} },
             });
             listFetchNow();
-            dispatch({
+            context.dispatch({
+                type: exports.PAYMENT_ACTION_TYPES.SET_DRAWER,
                 payload: { drawer: null },
-                type: actions_1.PAYMENT_ACTION_TYPES.SET_DRAWER,
             });
         }
     }, 
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [dispatch, showErrorToast, showSuccessToast, t]);
+    [t, showErrorToast, showSuccessToast]);
     var byIdCallback = (0, react_1.useCallback)(function (_a) {
         var data = _a.data, error = _a.error;
         if (error) {
@@ -214,33 +256,32 @@ var usePaymentState = function () {
                 }
             }
             var updatedData = __assign(__assign({}, data), (normalizedCurrency_1 && { currency: normalizedCurrency_1 }));
-            dispatch({
+            context.dispatch({
+                type: exports.PAYMENT_ACTION_TYPES.SET_FORM_DATA,
                 payload: { form: updatedData },
-                type: actions_1.PAYMENT_ACTION_TYPES.SET_FORM,
             });
-            dispatch({
-                payload: { drawer: types_1.PAYMENT_DRAWER.PAYMENT_VIEW_DRAWER },
-                type: actions_1.PAYMENT_ACTION_TYPES.SET_DRAWER,
+            context.dispatch({
+                type: exports.PAYMENT_ACTION_TYPES.SET_DRAWER,
+                payload: { drawer: paymentConfig.drawerTypes.FORM_DRAWER },
             });
         }
-    }, [dispatch, showErrorToast, t, currencies]);
+    }, [t, showErrorToast, currencies]);
     var deleteCallback = (0, react_1.useCallback)(function (_a) {
         var data = _a.data, error = _a.error;
         if (error) {
             showErrorToast(t("messagesNetworkError"));
         }
         if (data) {
+            (0, cache_1.invalidatePaymentsCache)();
             showSuccessToast(t("messagesPaymentDeleted"));
-            dispatch({
-                type: actions_1.PAYMENT_ACTION_TYPES.RESET_FORM,
-            });
+            context.dispatch({ type: exports.PAYMENT_ACTION_TYPES.RESET_FORM });
             listFetchNow();
         }
     }, 
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [dispatch, showErrorToast, showSuccessToast, t]);
+    [t, showErrorToast, showSuccessToast]);
     // ---------------------------------------------------------------------------
-    // MODULE ENTITY HOOK
+    // Module Entity Hook
     // ---------------------------------------------------------------------------
     var _b = (0, util_functions_1.useModuleEntityV2)({
         byIdCallback: byIdCallback,
@@ -248,27 +289,44 @@ var usePaymentState = function () {
         deleteCallback: deleteCallback,
         deleteParams: deleteParams,
         listCallback: listCallback,
-        listDeps: [dispatch],
+        listDeps: [context.dispatch],
         listParams: listParams,
-        listUrl: constants_1.PAYMENT_API_ROUTES.PAYMENTS,
+        listUrl: constants_1.PAYMENT_API_ROUTES.UNIT,
         searchQuery: debouncedQuery,
-        unitByIdUrl: constants_1.PAYMENT_API_ROUTES.PAYMENT_BY_ID,
-        unitUrl: constants_1.PAYMENT_API_ROUTES.PAYMENT,
+        unitByIdUrl: constants_1.PAYMENT_API_ROUTES.UNIT,
+        unitUrl: constants_1.PAYMENT_API_ROUTES.UNIT,
         updateCallback: updateCallback,
-        updateDeps: [state],
         updateParams: updateParams,
-    }), byIdError = _b.byIdError, byIdFetchNow = _b.byIdFetchNow, byIdLoading = _b.byIdLoading, deleteError = _b.deleteError, 
-    // deleteFetchNow,
-    deleteLoading = _b.deleteLoading, listError = _b.listError, listFetchNow = _b.listFetchNow, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
+    }), byIdError = _b.byIdError, byIdFetchNow = _b.byIdFetchNow, byIdLoading = _b.byIdLoading, deleteError = _b.deleteError, deleteLoading = _b.deleteLoading, listError = _b.listError, listFetchNow = _b.listFetchNow, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
     // ---------------------------------------------------------------------------
-    // EFFECTS
+    // Effects
     // ---------------------------------------------------------------------------
-    var defaultCurrency = (0, react_1.useMemo)(function () {
-        return currencies.filter(function (_a) {
-            var isDefault = _a.isDefault;
-            return isDefault;
-        })[0];
-    }, [currencies]);
+    (0, react_1.useEffect)(function () {
+        (function () { return __awaiter(void 0, void 0, void 0, function () {
+            var _a, count, items, _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        _c.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, (0, cache_1.getCachedPayments)({
+                                params: listParams,
+                            })];
+                    case 1:
+                        _a = _c.sent(), count = _a.count, items = _a.items;
+                        context.dispatch({
+                            type: exports.PAYMENT_ACTION_TYPES.SET_ITEMS,
+                            payload: { items: items || [], count: count || 0 },
+                        });
+                        return [3 /*break*/, 3];
+                    case 2:
+                        _b = _c.sent();
+                        showErrorToast(t("messagesNetworkError"));
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        }); })();
+    }, [listParams]); // eslint-disable-line react-hooks/exhaustive-deps
     (0, react_1.useEffect)(function () {
         listFetchNow();
         // eslint-disable-next-line
@@ -281,8 +339,8 @@ var usePaymentState = function () {
                 return id === invoiceId;
             })[0];
             if (invoice) {
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
                     payload: { key: "quoteInvoiceId", value: invoiceId },
                 });
                 // Normalize invoice currency to id (API may return id or code)
@@ -301,78 +359,71 @@ var usePaymentState = function () {
                             invoiceCurrency_1 = foundByCode.id;
                     }
                 }
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
                     payload: {
                         key: "currency",
                         value: invoiceCurrency_1 || (defaultCurrency === null || defaultCurrency === void 0 ? void 0 : defaultCurrency.id),
                     },
                 });
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
                     payload: { key: "amount", value: invoice === null || invoice === void 0 ? void 0 : invoice.total },
                 });
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
                     payload: { key: "balance", value: "0.00" },
                 });
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INVOICE,
-                    payload: { invoice: invoice },
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                    payload: { key: "invoice", value: invoice },
                 });
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_DRAWER,
-                    payload: { drawer: types_1.PAYMENT_DRAWER.PAYMENT_FORM_DRAWER },
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_DRAWER,
+                    payload: { drawer: paymentConfig.drawerTypes.FORM_DRAWER },
                 });
             }
         }
-    }, [invoices, currencies, defaultCurrency === null || defaultCurrency === void 0 ? void 0 : defaultCurrency.id]);
-    // include currencies and defaultCurrency in deps because we read them when initializing form
+    }, [invoices, currencies, defaultCurrency === null || defaultCurrency === void 0 ? void 0 : defaultCurrency.id]); // eslint-disable-line react-hooks/exhaustive-deps
     // ---------------------------------------------------------------------------
-    // DRAWER & MODAL HANDLERS
+    // Drawer & Modal Handlers
     // ---------------------------------------------------------------------------
     var closeDrawer = (0, react_1.useCallback)(function () {
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_DRAWER,
             payload: { drawer: null },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_DRAWER,
-        });
-        dispatch({
-            type: actions_1.PAYMENT_ACTION_TYPES.RESET_FORM,
         });
-        dispatch({
-            type: actions_1.PAYMENT_ACTION_TYPES.RESET_ERRORS,
+        context.dispatch({ type: exports.PAYMENT_ACTION_TYPES.RESET_FORM });
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
         });
-    }, [dispatch]);
+    }, [context]);
     // ---------------------------------------------------------------------------
-    // CRUD OPERATION HANDLERS
+    // CRUD Operation Handlers
     // ---------------------------------------------------------------------------
     var handleView = (0, react_1.useCallback)(function (id) {
         byIdFetchNow(undefined, {
             params: {
                 id: id,
-                includeQuoteInvoice: true,
                 includePaymentMode: true,
+                includeQuoteInvoice: true,
             },
         });
     }, [byIdFetchNow]);
-    // const handleDelete = useCallback(
-    //   (id: string) => {
-    //     deleteFetchNow?.(undefined, {
-    //       body: JSON.stringify({ id }),
-    //     });
-    //   },
-    //   [deleteFetchNow]
-    // );
+    // ---------------------------------------------------------------------------
+    // Form Submission Handler
+    // ---------------------------------------------------------------------------
     var handleSubmit = (0, react_1.useCallback)(function () {
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
             payload: { disableSaveButton: true },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
         });
         (0, util_functions_1.validateForm)({
             errorCallback: function (e) {
-                dispatch({
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_ERRORS,
                     payload: { errors: e },
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_ERRORS,
                 });
             },
             params: __assign(__assign({}, updateParams), { currency: updateParams.currency || (defaultCurrency === null || defaultCurrency === void 0 ? void 0 : defaultCurrency.id) }),
@@ -384,84 +435,85 @@ var usePaymentState = function () {
             },
         });
         (0, util_functions_1.removeStorageValue)("paymentInvoiceId");
-    }, [updateFetchNow, updateParams, dispatch, defaultCurrency === null || defaultCurrency === void 0 ? void 0 : defaultCurrency.id]);
+    }, [context, updateFetchNow, updateParams, defaultCurrency === null || defaultCurrency === void 0 ? void 0 : defaultCurrency.id]);
     // ---------------------------------------------------------------------------
-    // FORM HANDLERS
+    // Form Change Handlers
     // ---------------------------------------------------------------------------
     var handleChange = (0, react_1.useCallback)(function (key, value) {
         var _a, _b, _c;
         if (key === "amount" && typeof value === "string") {
             if (Number((_a = state === null || state === void 0 ? void 0 : state.invoice) === null || _a === void 0 ? void 0 : _a.total) > Number(value)) {
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
-                    payload: { key: "paymentType", value: types_1.PAYMENT_TYPE.PARTIAL_AMOUNT },
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                    payload: { key: "paymentType", value: util_functions_1.PAYMENT_TYPE.PARTIAL_AMOUNT },
                 });
             }
             if (Number((_b = state === null || state === void 0 ? void 0 : state.invoice) === null || _b === void 0 ? void 0 : _b.total) === Number(value)) {
-                dispatch({
-                    type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
-                    payload: { key: "paymentType", value: types_1.PAYMENT_TYPE.FULL_AMOUNT },
+                context.dispatch({
+                    type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+                    payload: { key: "paymentType", value: util_functions_1.PAYMENT_TYPE.FULL_AMOUNT },
                 });
             }
-            dispatch({
-                type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
+            context.dispatch({
+                type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
                 payload: {
                     key: "balance",
                     value: Number(Number((_c = state === null || state === void 0 ? void 0 : state.invoice) === null || _c === void 0 ? void 0 : _c.total) - Number(value)).toFixed(2),
                 },
             });
         }
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
             payload: { key: key, value: String(value) },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD,
         });
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
             payload: { disableSaveButton: false },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
         });
-        dispatch({
-            type: actions_1.PAYMENT_ACTION_TYPES.RESET_ERRORS,
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
         });
-    }, [dispatch, state === null || state === void 0 ? void 0 : state.invoice]);
+    }, [context, state === null || state === void 0 ? void 0 : state.invoice]);
     // ---------------------------------------------------------------------------
-    // PAGINATION HANDLERS
+    // Pagination Handlers
     // ---------------------------------------------------------------------------
     var handleNextClick = (0, react_1.useCallback)(function () {
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_CURRENT_PAGE,
             payload: { currentPage: state.currentPage + 1 },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_CURRENT_PAGE,
         });
-    }, [state.currentPage, dispatch]);
+    }, [context, state.currentPage]);
     var handlePreviousClick = (0, react_1.useCallback)(function () {
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_CURRENT_PAGE,
             payload: { currentPage: state.currentPage - 1 },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_CURRENT_PAGE,
         });
-    }, [state.currentPage, dispatch]);
+    }, [context, state.currentPage]);
     var handlePageLimit = (0, react_1.useCallback)(function (node, value) {
         var val = __assign({}, value);
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_PAGE_LIMIT,
             payload: { pageLimit: Number(val.option) },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_PAGE_LIMIT,
         });
-    }, [dispatch]);
+    }, [context]);
     // ---------------------------------------------------------------------------
-    // SEARCH HANDLERS
+    // Search Handlers
     // ---------------------------------------------------------------------------
     var searchOnChange = (0, react_1.useCallback)(function (k, v) {
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_SEARCH_QUERY,
             payload: { searchQuery: v },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_SEARCH_QUERY,
         });
-    }, [dispatch]);
+    }, [context]);
     var clearSearch = (0, react_1.useCallback)(function () {
-        dispatch({
+        context.dispatch({
+            type: exports.PAYMENT_ACTION_TYPES.SET_SEARCH_QUERY,
             payload: { searchQuery: "" },
-            type: actions_1.PAYMENT_ACTION_TYPES.SET_SEARCH_QUERY,
         });
-    }, [dispatch]);
+    }, [context]);
     // ---------------------------------------------------------------------------
-    // TABLE ACTIONS
+    // Table Actions
     // ---------------------------------------------------------------------------
     var headerActions = (0, react_1.useMemo)(function () { return []; }, []);
     var rowActions = (0, react_1.useMemo)(function () { return [
@@ -473,31 +525,8 @@ var usePaymentState = function () {
         },
     ]; }, [handleView, t]);
     // ---------------------------------------------------------------------------
-    // RETURN STATE
+    // Return State (flat, backward-compatible)
     // ---------------------------------------------------------------------------
-    return __assign(__assign({}, state), { byIdError: byIdError, byIdLoading: byIdLoading, clearSearch: clearSearch, closeDrawer: closeDrawer, deleteError: deleteError, deleteLoading: deleteLoading, dispatch: dispatch, handleChange: handleChange, handleNextClick: handleNextClick, handlePageLimit: handlePageLimit, handlePreviousClick: handlePreviousClick, handleSubmit: handleSubmit, headerActions: headerActions, listError: listError, listFetchNow: listFetchNow, listLoading: listLoading, rowActions: rowActions, searchOnChange: searchOnChange, updateError: updateError, updateLoading: updateLoading });
-};
-// ============================================================================
-// CONTEXT SETUP
-// ============================================================================
-exports.PaymentStateContext = (0, react_1.createContext)(__assign(__assign({}, reducer_1.initialPaymentState), { byIdError: undefined, byIdLoading: false, clearSearch: function () { return void 0; }, closeDrawer: function () { return void 0; }, deleteError: undefined, deleteLoading: false, dispatch: function () { return void 0; }, handleChange: function () { return void 0; }, handleNextClick: function () { return void 0; }, handlePageLimit: function () { return void 0; }, handlePreviousClick: function () { return void 0; }, handleSubmit: function () { return void 0; }, headerActions: [], listError: undefined, listFetchNow: function () { return void 0; }, listLoading: false, rowActions: [], searchOnChange: function () { return void 0; }, updateError: undefined, updateLoading: false }));
-// ============================================================================
-// PROVIDER COMPONENT
-// ============================================================================
-var PaymentStateContextProvider = function (_a) {
-    var children = _a.children;
-    var state = usePaymentState();
-    return (react_1.default.createElement(exports.PaymentStateContext.Provider, { value: state }, children));
-};
-exports.PaymentStateContextProvider = PaymentStateContextProvider;
-// ============================================================================
-// CUSTOM HOOK
-// ============================================================================
-var usePaymentStateContext = function () {
-    var state = (0, react_1.useContext)(exports.PaymentStateContext);
-    if (state === undefined) {
-        throw new Error("usePaymentStateContext must be used within a PaymentContextProvider");
-    }
-    return state;
+    return __assign(__assign({}, state), { payments: state.items, byIdError: byIdError, byIdLoading: byIdLoading, clearSearch: clearSearch, closeDrawer: closeDrawer, deleteError: deleteError, deleteLoading: deleteLoading, dispatch: context.dispatch, handleChange: handleChange, handleNextClick: handleNextClick, handlePageLimit: handlePageLimit, handlePreviousClick: handlePreviousClick, handleSubmit: handleSubmit, headerActions: headerActions, listError: listError, listFetchNow: listFetchNow, listLoading: listLoading, rowActions: rowActions, searchOnChange: searchOnChange, updateError: updateError, updateLoading: updateLoading });
 };
-exports.usePaymentStateContext = usePaymentStateContext;
+exports.usePaymentModule = usePaymentModule;