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

package/base-modules/invoice/context.d.ts

@@ -1,5 +1,5 @@
 /**
- * Invoice State Context
+ * Invoice State Context - Using Generic Module Factory
  *
  * This module provides comprehensive state management for the Invoice feature including:
  * - CRUD operations (create, read, update, delete)
@@ -15,36 +15,572 @@
  * - Theme-aware toast notifications
  *
  * Organization:
- * - Types & Interfaces
- * - Main Hook (useInvoiceState)
- *   - State & Core Hooks
- *   - Theme Support
+ * - Module Configuration & Factory Setup
+ * - Enhanced Invoice Hook (useInvoiceModule)
+ *   - State via factory context
  *   - Toast Helpers
  *   - Debounced Values
  *   - Tax & Currency Defaults
  *   - API Parameters (memoized)
- *   - API Callbacks (with error handling)
+ *   - API Callbacks
  *   - Module Entity Hook
- *   - Effects (list refresh, defaults, calculations)
+ *   - Effects (list refresh, calculations)
+ *   - Item Management Handlers
  *   - Drawer & Modal Handlers
  *   - CRUD Operation Handlers
  *   - Form Handlers (products, services, pricing)
- *   - Calculation Handlers
  *   - Pagination Handlers
  *   - Search Handlers
  *   - Table Actions (memoized)
  *   - Return State
- * - Context Setup
- * - Provider Component
- * - Custom Hook
+ * - Backward-Compatible Exports
  */
-import React, { FC, ReactNode } from "react";
-import { InvoiceContextType, InvoiceState } from "./types";
-type State = InvoiceContextType & InvoiceState;
-interface StateProviderProps {
-    children: ReactNode;
+import { QUOTE_INVOICE_CATEGORY, INVOICE_STATUS, DISCOUNT_UNIT, QUOTE_STATUS } from "@react-pakistan/util-functions";
+export declare const invoiceReducer: (state: {
+    items: never[];
+    count: number;
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    disableSaveButton: boolean;
+    drawer: null;
+    invoiceMode: null;
+    modal: null;
+    loading: boolean;
+    afterDiscount: number;
+    category: QUOTE_INVOICE_CATEGORY;
+    companiesList: never[];
+    companyId: string;
+    companyQuery: string;
+    contactsList: never[];
+    countryQuery: string;
+    currency: string;
+    customerId: string;
+    date: string;
+    discount: number;
+    discountUnit: DISCOUNT_UNIT;
+    errors: Record<string, string>;
+    expiryDate: string;
+    id: string;
+    invoiceStatus: INVOICE_STATUS;
+    mode: "Create" | "Edit";
+    netTotal: string;
+    note: string;
+    payments: never[];
+    productQuery: string;
+    productList: {
+        id: string;
+        mode: "Create" | "Edit" | "";
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    quoteStatus: QUOTE_STATUS;
+    ref: string;
+    serviceList: {
+        description: string;
+        mode: "Create" | "Edit" | "";
+        name: string;
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    subTotal: string;
+    tax: string;
+    taxQuery: string;
+    taxRate: string;
+    taxes: never[];
+    total: string;
+    customer: {
+        address: string;
+        city: string;
+        country: string;
+        createdAt: string;
+        email: string;
+        firstName: string;
+        id: string;
+        lastName: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+    };
+    company: {
+        contacts: never[];
+        country: string;
+        createdAt: string;
+        email: string;
+        id: string;
+        name: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+        website: string;
+    };
+}, action: any) => {
+    items: never[];
+    count: number;
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    disableSaveButton: boolean;
+    drawer: null;
+    invoiceMode: null;
+    modal: null;
+    loading: boolean;
+    afterDiscount: number;
+    category: QUOTE_INVOICE_CATEGORY;
+    companiesList: never[];
+    companyId: string;
+    companyQuery: string;
+    contactsList: never[];
+    countryQuery: string;
+    currency: string;
+    customerId: string;
+    date: string;
+    discount: number;
+    discountUnit: DISCOUNT_UNIT;
+    errors: Record<string, string>;
+    expiryDate: string;
+    id: string;
+    invoiceStatus: INVOICE_STATUS;
+    mode: "Create" | "Edit";
+    netTotal: string;
+    note: string;
+    payments: never[];
+    productQuery: string;
+    productList: {
+        id: string;
+        mode: "Create" | "Edit" | "";
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    quoteStatus: QUOTE_STATUS;
+    ref: string;
+    serviceList: {
+        description: string;
+        mode: "Create" | "Edit" | "";
+        name: string;
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    subTotal: string;
+    tax: string;
+    taxQuery: string;
+    taxRate: string;
+    taxes: never[];
+    total: string;
+    customer: {
+        address: string;
+        city: string;
+        country: string;
+        createdAt: string;
+        email: string;
+        firstName: string;
+        id: string;
+        lastName: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+    };
+    company: {
+        contacts: never[];
+        country: string;
+        createdAt: string;
+        email: string;
+        id: string;
+        name: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+        website: string;
+    };
+}, InvoiceProvider: import("react").FC<{
+    children: React.ReactNode;
+}>, useInvoiceCoreContext: () => import("@react-pakistan/util-functions/factory/generic-module-factory").GenericModuleContext<{
+    items: never[];
+    count: number;
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    disableSaveButton: boolean;
+    drawer: null;
+    invoiceMode: null;
+    modal: null;
+    loading: boolean;
+    afterDiscount: number;
+    category: QUOTE_INVOICE_CATEGORY;
+    companiesList: never[];
+    companyId: string;
+    companyQuery: string;
+    contactsList: never[];
+    countryQuery: string;
+    currency: string;
+    customerId: string;
+    date: string;
+    discount: number;
+    discountUnit: DISCOUNT_UNIT;
+    errors: Record<string, string>;
+    expiryDate: string;
+    id: string;
+    invoiceStatus: INVOICE_STATUS;
+    mode: "Create" | "Edit";
+    netTotal: string;
+    note: string;
+    payments: never[];
+    productQuery: string;
+    productList: {
+        id: string;
+        mode: "Create" | "Edit" | "";
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    quoteStatus: QUOTE_STATUS;
+    ref: string;
+    serviceList: {
+        description: string;
+        mode: "Create" | "Edit" | "";
+        name: string;
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    subTotal: string;
+    tax: string;
+    taxQuery: string;
+    taxRate: string;
+    taxes: never[];
+    total: string;
+    customer: {
+        address: string;
+        city: string;
+        country: string;
+        createdAt: string;
+        email: string;
+        firstName: string;
+        id: string;
+        lastName: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+    };
+    company: {
+        contacts: never[];
+        country: string;
+        createdAt: string;
+        email: string;
+        id: string;
+        name: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+        website: string;
+    };
+}>, invoiceModuleConfig: import("@react-pakistan/util-functions/factory/generic-module-factory").ModuleConfig<{
+    items: never[];
+    count: number;
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    disableSaveButton: boolean;
+    drawer: null;
+    invoiceMode: null;
+    modal: null;
+    loading: boolean;
+    afterDiscount: number;
+    category: QUOTE_INVOICE_CATEGORY;
+    companiesList: never[];
+    companyId: string;
+    companyQuery: string;
+    contactsList: never[];
+    countryQuery: string;
+    currency: string;
+    customerId: string;
+    date: string;
+    discount: number;
+    discountUnit: DISCOUNT_UNIT;
+    errors: Record<string, string>;
+    expiryDate: string;
+    id: string;
+    invoiceStatus: INVOICE_STATUS;
+    mode: "Create" | "Edit";
+    netTotal: string;
+    note: string;
+    payments: never[];
+    productQuery: string;
+    productList: {
+        id: string;
+        mode: "Create" | "Edit" | "";
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    quoteStatus: QUOTE_STATUS;
+    ref: string;
+    serviceList: {
+        description: string;
+        mode: "Create" | "Edit" | "";
+        name: string;
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    subTotal: string;
+    tax: string;
+    taxQuery: string;
+    taxRate: string;
+    taxes: never[];
+    total: string;
+    customer: {
+        address: string;
+        city: string;
+        country: string;
+        createdAt: string;
+        email: string;
+        firstName: string;
+        id: string;
+        lastName: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+    };
+    company: {
+        contacts: never[];
+        country: string;
+        createdAt: string;
+        email: string;
+        id: string;
+        name: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+        website: string;
+    };
+}>, INVOICE_ACTION_TYPES: {
+    readonly RESET_FORM: "RESET_FORM";
+    readonly SET_CURRENT_PAGE: "SET_CURRENT_PAGE";
+    readonly SET_PAGE_LIMIT: "SET_PAGE_LIMIT";
+    readonly SET_SEARCH_QUERY: "SET_SEARCH_QUERY";
+    readonly SET_DRAWER: "SET_DRAWER";
+    readonly SET_ITEMS: "SET_ITEMS";
+    readonly SET_FORM_DATA: "SET_FORM_DATA";
+    readonly SET_DISABLE_SAVE_BUTTON: "SET_DISABLE_SAVE_BUTTON";
+    readonly SET_INPUT_FIELD: "SET_INPUT_FIELD";
+    readonly SET_ERRORS: "SET_ERRORS";
+}, initialInvoiceState: {
+    items: never[];
+    count: number;
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    disableSaveButton: boolean;
+    drawer: null;
+    invoiceMode: null;
+    modal: null;
+    loading: boolean;
+    afterDiscount: number;
+    category: QUOTE_INVOICE_CATEGORY;
+    companiesList: never[];
+    companyId: string;
+    companyQuery: string;
+    contactsList: never[];
+    countryQuery: string;
+    currency: string;
+    customerId: string;
+    date: string;
+    discount: number;
+    discountUnit: DISCOUNT_UNIT;
+    errors: Record<string, string>;
+    expiryDate: string;
+    id: string;
+    invoiceStatus: INVOICE_STATUS;
+    mode: "Create" | "Edit";
+    netTotal: string;
+    note: string;
+    payments: never[];
+    productQuery: string;
+    productList: {
+        id: string;
+        mode: "Create" | "Edit" | "";
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    quoteStatus: QUOTE_STATUS;
+    ref: string;
+    serviceList: {
+        description: string;
+        mode: "Create" | "Edit" | "";
+        name: string;
+        price: string;
+        quantity: string;
+        rowTotal: string;
+    }[];
+    subTotal: string;
+    tax: string;
+    taxQuery: string;
+    taxRate: string;
+    taxes: never[];
+    total: string;
+    customer: {
+        address: string;
+        city: string;
+        country: string;
+        createdAt: string;
+        email: string;
+        firstName: string;
+        id: string;
+        lastName: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+    };
+    company: {
+        contacts: never[];
+        country: string;
+        createdAt: string;
+        email: string;
+        id: string;
+        name: string;
+        phone: string;
+        quotesInvoices: never[];
+        updatedAt: string;
+        website: string;
+    };
+};
+export interface ServiceParams {
+    index: number;
+    key: string;
+    value: string | number;
 }
-export declare const InvoiceStateContext: React.Context<State>;
-export declare const InvoiceStateContextProvider: FC<StateProviderProps>;
-export declare const useInvoiceStateContext: () => State;
-export {};
+export interface ProductParams {
+    index: number;
+    key: string;
+    value: string | number;
+}
+export declare const useInvoiceModule: () => {
+    clearSearch: () => void;
+    closeDrawer: () => void;
+    handleAddItemProduct: () => void;
+    handleAddItemService: () => void;
+    handleChange: (key: string, value: string) => void;
+    handleCloseDrawer: () => void;
+    handleCreate: (text: "customer" | "company") => void;
+    handleDelete: (row: unknown) => void;
+    handleDeleteProductRow: (i: number) => void;
+    handleDeleteServiceRow: (i: number) => void;
+    handleEdit: (row: unknown) => void;
+    handleItemChangeProducts: ({ index, key, value }: ProductParams) => void;
+    handleItemChangeServices: ({ index, key, value }: ServiceParams) => void;
+    handleNextClick: () => void;
+    handlePageChange: (page: number) => void;
+    handlePageLimit: (k: string, value: object) => void;
+    handlePageLimitChange: (limit: number) => void;
+    handlePreviousClick: () => void;
+    handleRecordPayment: (row: unknown) => void;
+    handleSearch: (query: string) => void;
+    handleSubmit: () => void;
+    handleTaxSearch: (searchQuery: string) => void;
+    handleView: (row: unknown) => void;
+    headerActions: {
+        enabled: boolean;
+        handleOnClick: () => void;
+        label: string;
+        order: number;
+    }[];
+    rowActions: {
+        enabled: boolean;
+        handleAction: (row: unknown) => void;
+        label: string;
+        order: number;
+    }[];
+    listError: Error | undefined;
+    listFetchNow: (url?: string, config?: import("@react-pakistan/util-functions").FetchConfig) => void;
+    listLoading: boolean;
+    updateLoading: boolean;
+    searchOnChange: (k: string, v: string) => void;
+    state: {
+        items: never[];
+        count: number;
+        currentPage: number;
+        pageLimit: number;
+        searchQuery: string;
+        disableSaveButton: boolean;
+        drawer: null;
+        invoiceMode: null;
+        modal: null;
+        loading: boolean;
+        afterDiscount: number;
+        category: QUOTE_INVOICE_CATEGORY;
+        companiesList: never[];
+        companyId: string;
+        companyQuery: string;
+        contactsList: never[];
+        countryQuery: string;
+        currency: string;
+        customerId: string;
+        date: string;
+        discount: number;
+        discountUnit: DISCOUNT_UNIT;
+        errors: Record<string, string>;
+        expiryDate: string;
+        id: string;
+        invoiceStatus: INVOICE_STATUS;
+        mode: "Create" | "Edit";
+        netTotal: string;
+        note: string;
+        payments: never[];
+        productQuery: string;
+        productList: {
+            id: string;
+            mode: "Create" | "Edit" | "";
+            price: string;
+            quantity: string;
+            rowTotal: string;
+        }[];
+        quoteStatus: QUOTE_STATUS;
+        ref: string;
+        serviceList: {
+            description: string;
+            mode: "Create" | "Edit" | "";
+            name: string;
+            price: string;
+            quantity: string;
+            rowTotal: string;
+        }[];
+        subTotal: string;
+        tax: string;
+        taxQuery: string;
+        taxRate: string;
+        taxes: never[];
+        total: string;
+        customer: {
+            address: string;
+            city: string;
+            country: string;
+            createdAt: string;
+            email: string;
+            firstName: string;
+            id: string;
+            lastName: string;
+            phone: string;
+            quotesInvoices: never[];
+            updatedAt: string;
+        };
+        company: {
+            contacts: never[];
+            country: string;
+            createdAt: string;
+            email: string;
+            id: string;
+            name: string;
+            phone: string;
+            quotesInvoices: never[];
+            updatedAt: string;
+            website: string;
+        };
+    };
+    dispatch: React.Dispatch<any>;
+};