@appcorp/stellar-solutions-invoice-module 0.1.57 → 0.1.59

package/base-modules/payment/reducer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Payment State Reducer
+ *
+ * This module manages the state transitions for the Payment feature using the reducer pattern.
+ * Handles all state updates in a predictable and optimized manner.
+ *
+ * Features:
+ * - Form state management (create/edit payment data)
+ * - UI state management (drawers, modals, loading states)
+ * - Search and pagination state
+ * - Error handling state
+ *
+ * Performance Optimizations:
+ * - Grouped related actions for better readability and maintainability
+ * - Helper functions for common operations (form reset, array updates, error merging)
+ * - Optimized object spreading patterns with shallow copies
+ * - Immutable state updates to prevent reference issues
+ * - Clear action-to-state mapping with logical grouping
+ */
+import { PaymentActions } from "./actions";
+import { PaymentState } from "./types";
+export declare const initialPaymentState: PaymentState;
+/**
+ * Payment Reducer
+ *
+ * Handles all state transitions for the payment module.
+ * Maps actions to state updates in a predictable and optimized manner.
+ */
+export declare function paymentReducer(state: PaymentState, action: PaymentActions): PaymentState;

package/base-modules/payment/reducer.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Payment State Reducer
+ *
+ * This module manages the state transitions for the Payment feature using the reducer pattern.
+ * Handles all state updates in a predictable and optimized manner.
+ *
+ * Features:
+ * - Form state management (create/edit payment data)
+ * - UI state management (drawers, modals, loading states)
+ * - Search and pagination state
+ * - Error handling state
+ *
+ * Performance Optimizations:
+ * - Grouped related actions for better readability and maintainability
+ * - Helper functions for common operations (form reset, array updates, error merging)
+ * - Optimized object spreading patterns with shallow copies
+ * - Immutable state updates to prevent reference issues
+ * - Clear action-to-state mapping with logical grouping
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initialPaymentState = void 0;
+exports.paymentReducer = paymentReducer;
+var actions_1 = require("./actions");
+var types_1 = require("./types");
+var pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT) || 10;
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Helper function to reset form fields to their initial values
+ */
+var getFormResetState = function () { return ({
+    amount: "",
+    attachment: "",
+    balance: "",
+    currency: "",
+    date: new Date().toISOString(),
+    description: "",
+    disableSaveButton: false,
+    errors: {},
+    id: "",
+    mode: "Create",
+    paymentModeId: "",
+    paymentType: types_1.PAYMENT_TYPE.FULL_AMOUNT,
+    quoteInvoiceId: "",
+    ref: "",
+}); };
+/**
+ * Helper function to safely update array state with immutability
+ */
+var updateArrayState = function (array) { return __spreadArray([], array, true); };
+/**
+ * Helper function to safely merge errors with existing state
+ */
+var mergeErrors = function (errors) { return (__assign({}, errors)); };
+// ============================================================================
+// INITIAL STATE
+// ============================================================================
+exports.initialPaymentState = {
+    // Form data
+    amount: "",
+    attachment: "",
+    balance: "",
+    currency: "",
+    date: new Date().toISOString(),
+    description: "",
+    id: "",
+    mode: "Create",
+    paymentModeId: "",
+    paymentType: types_1.PAYMENT_TYPE.FULL_AMOUNT,
+    quoteInvoiceId: "",
+    ref: "",
+    // List data
+    count: 0,
+    paymentModes: [],
+    payments: [],
+    quoteInvoices: [],
+    // Search & Pagination
+    currentPage: 1,
+    pageLimit: pageLimit,
+    paymentModeQuery: "",
+    quoteInvoiceQuery: "",
+    searchQuery: "",
+    // UI state
+    disableSaveButton: true,
+    drawer: types_1.PAYMENT_DRAWER.PAYMENT_FORM_DRAWER,
+    // Errors
+    errors: {},
+};
+// ============================================================================
+// REDUCER FUNCTION
+// ============================================================================
+/**
+ * Payment Reducer
+ *
+ * Handles all state transitions for the payment module.
+ * Maps actions to state updates in a predictable and optimized manner.
+ */
+function paymentReducer(state, action) {
+    var _a;
+    switch (action.type) {
+        // ------------------------------------------------------------------------
+        // FORM RESET ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.RESET_ERRORS:
+            return __assign(__assign({}, state), { errors: {} });
+        case actions_1.PAYMENT_ACTION_TYPES.RESET_FORM:
+            return __assign(__assign(__assign({}, state), getFormResetState()), { 
+                // Preserve lists when resetting form
+                paymentModes: state.paymentModes, payments: state.payments, quoteInvoices: state.quoteInvoices, count: state.count });
+        // ------------------------------------------------------------------------
+        // FORM INPUT ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.SET_INPUT_FIELD:
+            return __assign(__assign({}, state), (_a = {}, _a[action.payload.key] = action.payload.value, _a));
+        case actions_1.PAYMENT_ACTION_TYPES.SET_FORM:
+            return __assign(__assign(__assign({}, state), action.payload.form), { mode: "Edit" });
+        // ------------------------------------------------------------------------
+        // ERROR HANDLING ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.SET_ERRORS:
+            return __assign(__assign({}, state), { disableSaveButton: false, errors: mergeErrors(action.payload.errors) });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON:
+            return __assign(__assign({}, state), { disableSaveButton: action.payload.disableSaveButton });
+        // ------------------------------------------------------------------------
+        // UI STATE ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.SET_DRAWER:
+            return __assign(__assign({}, state), { drawer: action.payload.drawer });
+        // ------------------------------------------------------------------------
+        // LIST DATA ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.SET_PAYMENTS:
+            return __assign(__assign({}, state), { payments: updateArrayState(action.payload.payments) });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_PAYMENT_MODES:
+            return __assign(__assign({}, state), { paymentModes: updateArrayState(action.payload.paymentModes) });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_QUOTE_INVOICES:
+            return __assign(__assign({}, state), { quoteInvoices: updateArrayState(action.payload.quoteInvoices) });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_COUNT:
+            return __assign(__assign({}, state), { count: action.payload.count });
+        // ------------------------------------------------------------------------
+        // SEARCH ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.SET_PAYMENT_MODE_QUERY:
+            return __assign(__assign({}, state), { paymentModeQuery: action.payload.paymentModeQuery });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_QUOTE_INVOICE_QUERY:
+            return __assign(__assign({}, state), { quoteInvoiceQuery: action.payload.quoteInvoiceQuery });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_SEARCH_QUERY:
+            return __assign(__assign({}, state), { searchQuery: action.payload.searchQuery });
+        // ------------------------------------------------------------------------
+        // PAGINATION ACTIONS
+        // ------------------------------------------------------------------------
+        case actions_1.PAYMENT_ACTION_TYPES.SET_CURRENT_PAGE:
+            return __assign(__assign({}, state), { currentPage: action.payload.currentPage });
+        case actions_1.PAYMENT_ACTION_TYPES.SET_PAGE_LIMIT:
+            return __assign(__assign({}, state), { pageLimit: action.payload.pageLimit });
+        // ------------------------------------------------------------------------
+        // DEFAULT CASE
+        // ------------------------------------------------------------------------
+        default:
+            return state;
+    }
+}
+// ============================================================================
+// OPTIMIZATION SUMMARY
+// ============================================================================
+/*
+ * Reducer Optimizations Applied:
+ *
+ * 1. Structural Organization
+ *    - Grouped related actions into logical sections
+ *    - Added comprehensive documentation and comments
+ *    - Organized initial state by functionality
+ *
+ * 2. Performance Improvements
+ *    - Helper functions for common operations (getFormResetState, updateArrayState, mergeErrors)
+ *    - Immutable state updates using spread operator
+ *    - Optimized object creation patterns
+ *    - Consistent shallow copying for arrays
+ *
+ * 3. Code Quality
+ *    - Clear section headers for better navigation
+ *    - Consistent action handling patterns
+ *    - Improved readability with logical grouping
+ *
+ * 4. Maintainability
+ *    - Predictable state update patterns
+ *    - Easy-to-locate action handlers
+ *    - Self-documenting code structure
+ */

package/base-modules/payment/types.d.ts

@@ -0,0 +1,82 @@
+import { Dispatch } from "react";
+import { PaymentModeTypeBE } from "@appcorp/stellar-solutions-modules/global-modules/payment-mode/types";
+import { QuoteInvoiceTypeBE } from "../invoice/types";
+import { PaymentActions } from "./actions";
+import { HeaderAction, RowAction } from "@appcorp/shadcn/components/enhanced-table";
+export declare enum PAYMENT_TYPE {
+    FULL_AMOUNT = "FULL_AMOUNT",
+    PARTIAL_AMOUNT = "PARTIAL_AMOUNT"
+}
+export declare enum PAYMENT_DRAWER {
+    PAYMENT_FORM_DRAWER = "PAYMENT_FORM_DRAWER"
+}
+export declare enum PAYMENT_MODAL {
+    DUMMY = "DUMMY"
+}
+/**
+ * Payment Backend Entity
+ */
+export interface PaymentTypeBE {
+    amount: string;
+    attachment?: string;
+    balance: string;
+    createdAt: string;
+    currency: string;
+    date: string;
+    description?: string;
+    id: string;
+    paymentMode?: PaymentModeTypeBE;
+    paymentModeId: string;
+    paymentType: PAYMENT_TYPE;
+    quoteInvoice?: QuoteInvoiceTypeBE;
+    quoteInvoiceId: string;
+    ref?: string;
+    updatedAt: string;
+}
+export type { PaymentModeTypeBE };
+export interface PaymentContextType {
+    byIdError?: Error;
+    byIdLoading: boolean;
+    clearSearch: () => void;
+    closeDrawer: () => void;
+    deleteError?: Error;
+    deleteLoading: boolean;
+    dispatch: Dispatch<PaymentActions>;
+    handleChange: (field: string, value: string | number | number[]) => void;
+    handleNextClick: () => void;
+    handlePageLimit: (node: string, value: object) => void;
+    handlePreviousClick: () => void;
+    handleSubmit: () => void;
+    headerActions: HeaderAction[];
+    listError?: Error;
+    listFetchNow: () => void;
+    listLoading: boolean;
+    rowActions: RowAction[];
+    searchOnChange: (k: string, v: string) => void;
+    updateError?: Error;
+    updateLoading: boolean;
+}
+export interface PaymentState extends Omit<PaymentTypeBE, "createdAt" | "updatedAt" | "paymentMode" | "quoteInvoice"> {
+    count: number;
+    currentPage: number;
+    disableSaveButton: boolean;
+    drawer: null | PAYMENT_DRAWER;
+    errors: {
+        [key: string]: string;
+    };
+    mode: "Create" | "Edit";
+    pageLimit: number;
+    paymentMode?: PaymentModeTypeBE;
+    paymentModeQuery: string;
+    paymentModes: PaymentModeTypeBE[];
+    payments: PaymentTypeBE[];
+    quoteInvoice?: QuoteInvoiceTypeBE;
+    quoteInvoiceQuery: string;
+    quoteInvoices: QuoteInvoiceTypeBE[];
+    searchQuery: string;
+}
+export interface FetchPaymentsArgs {
+    currentPage: number;
+    pageLimit: number;
+    searchQuery?: string;
+}

package/base-modules/payment/types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_MODAL = exports.PAYMENT_DRAWER = exports.PAYMENT_TYPE = void 0;
+// ============================================================================
+// ENUMS
+// ============================================================================
+var PAYMENT_TYPE;
+(function (PAYMENT_TYPE) {
+    PAYMENT_TYPE["FULL_AMOUNT"] = "FULL_AMOUNT";
+    PAYMENT_TYPE["PARTIAL_AMOUNT"] = "PARTIAL_AMOUNT";
+})(PAYMENT_TYPE || (exports.PAYMENT_TYPE = PAYMENT_TYPE = {}));
+var PAYMENT_DRAWER;
+(function (PAYMENT_DRAWER) {
+    PAYMENT_DRAWER["PAYMENT_FORM_DRAWER"] = "PAYMENT_FORM_DRAWER";
+})(PAYMENT_DRAWER || (exports.PAYMENT_DRAWER = PAYMENT_DRAWER = {}));
+var PAYMENT_MODAL;
+(function (PAYMENT_MODAL) {
+    PAYMENT_MODAL["DUMMY"] = "DUMMY";
+})(PAYMENT_MODAL || (exports.PAYMENT_MODAL = PAYMENT_MODAL = {}));

package/base-modules/payment/validate.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+/**
+ * Validation schema for payment form
+ */
+export declare const formValidation: z.ZodObject<{
+    amount: z.ZodString;
+    attachment: z.ZodOptional<z.ZodString>;
+    balance: z.ZodOptional<z.ZodString>;
+    currency: z.ZodString;
+    date: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    paymentModeId: z.ZodString;
+    paymentType: z.ZodString;
+    quoteInvoiceId: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type definition for payment form validation
+ */
+export type FormValidate = z.infer<typeof formValidation>;

package/base-modules/payment/validate.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formValidation = void 0;
+var zod_1 = require("zod");
+var constants_1 = require("./constants");
+// ============================================================================
+// FORM VALIDATION SCHEMA
+// ============================================================================
+/**
+ * Validation schema for payment form
+ */
+exports.formValidation = zod_1.z.object({
+    amount: zod_1.z.string().nonempty(constants_1.VALIDATION_KEYS.amount),
+    attachment: zod_1.z.string().optional(),
+    balance: zod_1.z.string().optional(),
+    currency: zod_1.z.string().nonempty(constants_1.VALIDATION_KEYS.currency),
+    date: zod_1.z.string().nonempty(constants_1.VALIDATION_KEYS.date),
+    description: zod_1.z.string().optional(),
+    paymentModeId: zod_1.z.string().nonempty(constants_1.VALIDATION_KEYS.paymentMode),
+    paymentType: zod_1.z.string().nonempty(constants_1.VALIDATION_KEYS.paymentType),
+    quoteInvoiceId: zod_1.z.string().nonempty(constants_1.VALIDATION_KEYS.quoteInvoice),
+    ref: zod_1.z.string().optional(),
+});