@erpsquad/common 1.8.42 → 1.8.43

package/dist/constants/route-page-map.d.ts

@@ -0,0 +1,10 @@
+export interface IResources {
+    pageResource: string;
+    fieldResource: string;
+    formResource: string;
+}
+export interface IColumns {
+    defaultColumns: any[];
+}
+export declare const routeToResourceMap: Record<string, IResources>;
+export declare const routeToColumnsMap: Record<string, IColumns>;

package/dist/constants/status.d.ts

@@ -0,0 +1,4 @@
+export declare const enum StatusTypes {
+    ENABLED = "Enabled",
+    DISABLED = "Disabled"
+}

package/dist/contexts/AuthContext.d.ts

@@ -0,0 +1,69 @@
+import { default as React } from 'react';
+
+export interface LoginFormValues {
+    email: string;
+    password: string;
+}
+export interface resetFormValues {
+    email: string;
+}
+export interface resetPasswordValues {
+    token: string;
+}
+export interface changePasswordValues {
+    password: string;
+}
+export interface changeUserPasswordValues {
+    password: string;
+}
+interface ERPApiUser {
+    id: string | number;
+    first_name: string;
+    last_name: string;
+    middle_name: string;
+    country_code: string;
+    email: string;
+    created_by: any;
+    updated_by: any;
+    created_at: string;
+    updated_at: string;
+    role_id: string;
+    department_id: number;
+    is_deleted: number;
+    deleted_at: string | null;
+    deleted_by: any;
+    token: string;
+    profile_image: string;
+    currency_data?: {
+        id: number;
+        symbol: string;
+        currency_name: string;
+        number_format: string;
+        position: string | null;
+        fraction_unit: string | null;
+    };
+    accessCompanies?: any[];
+}
+interface ERPUser extends Omit<ERPApiUser, 'token'> {
+    full_name: string;
+    company_id: string;
+}
+interface DefaultProviderProps {
+    user: ERPUser | null;
+    loading: boolean;
+    authToken: string;
+    setUser: React.Dispatch<React.SetStateAction<ERPUser | null>>;
+    setLoading: React.Dispatch<React.SetStateAction<boolean>>;
+    login: (params: LoginFormValues, callback: (err: string) => void) => Promise<void>;
+    logout: () => Promise<void>;
+    forgotPassword: (params: resetFormValues, callback: (err: string) => void) => Promise<void>;
+    resetPassword: (params: resetPasswordValues, callback: (err: string) => void) => Promise<void>;
+    changePassword: (params: changePasswordValues, callback: (err: string) => void) => Promise<void>;
+    changeUserPassword: (params: changeUserPasswordValues, callback: (err: string) => void) => Promise<void>;
+}
+declare const AuthContext: React.Context<DefaultProviderProps>;
+interface AuthProviderProps {
+    children: React.ReactNode;
+}
+declare const AuthProvider: React.FC<AuthProviderProps>;
+export { AuthContext, AuthProvider };

package/dist/contexts/languageContext.d.ts

@@ -0,0 +1,24 @@
+import { default as React, ReactNode } from 'react';
+
+interface ILanguage {
+    label: string;
+    code: string;
+    direction: string;
+}
+interface LanguageState {
+    languages: ILanguage[];
+    currentLanguage: ILanguage | null;
+    isLoading: boolean;
+    error: string | null;
+    isFallbackActive: boolean;
+}
+interface LanguageContextType extends LanguageState {
+    changeLanguage: (langCode: string) => void;
+    fetchLanguages: () => Promise<void>;
+}
+declare const LanguageContext: React.Context<LanguageContextType>;
+interface LanguageProviderProps {
+    children: ReactNode;
+}
+export declare const LanguageProvider: React.FC<LanguageProviderProps>;
+export default LanguageContext;

package/dist/contexts/page-context.d.ts

@@ -0,0 +1,72 @@
+import { default as React } from 'react';
+import { RuleGroupType } from 'react-querybuilder';
+import { MaterialTableColumnProps } from '../components/material-table/material-table';
+
+export type ViewType = 'Table' | 'Grid' | 'Kanban' | 'Calendar' | 'Gantt' | '';
+interface SchemaFields {
+    select: string;
+    alias: string;
+    type: string;
+    filter_type?: string;
+    filter_name?: string;
+    required?: boolean;
+    isOrderAllowed?: boolean;
+    isDefault?: boolean;
+    isFilterAllowed?: boolean;
+    label?: string;
+    key: string;
+    accessorKey?: string;
+    joinKey?: string;
+    enum?: string | string[];
+}
+export interface SavedViewType {
+    label: ViewType;
+    position: number;
+}
+export interface PageState {
+    _id: string | number;
+    name: string;
+    page_size: number;
+    column_order: string[];
+    visible_columns: MaterialTableColumnProps[];
+    views: SavedViewType[];
+    active_view: ViewType;
+    filters: RuleGroupType;
+    filterQueryString: string;
+    sort: Record<any, any> | null;
+    search: string;
+    enabled_views: ViewType[];
+    isShared: boolean;
+    column_sizes: Record<string, number>;
+}
+export interface GeneratedColumnsState {
+    columns: MaterialTableColumnProps[];
+    orderKeys: string[];
+}
+export declare const initialFilter: RuleGroupType;
+interface PageContextValue {
+    pageTemplateId: string;
+    activePage: PageState;
+    updatePageInfo: (updates: Partial<PageState>) => void;
+    loading: boolean;
+    isSaving: boolean;
+    error: string | null;
+    pages: any[];
+    savePages: () => void;
+    setActivePage: (data: any) => void;
+    setPages: React.Dispatch<any>;
+    schemaFields: SchemaFields[];
+    initializeColumns: (columns: MaterialTableColumnProps[]) => void;
+    generatedColumns: GeneratedColumnsState;
+    sharedPages: any[];
+    updateGeneratedColumns: (updates: Partial<GeneratedColumnsState>) => void;
+    formData: Record<string, any>;
+    setFormData: (data: Record<string, any>) => void;
+}
+export declare const defaultPageState: PageState;
+interface PageProviderProps {
+    children: React.ReactNode;
+}
+export declare const PageContext: React.Context<PageContextValue>;
+export declare const PageProvider: React.FC<PageProviderProps>;
+export {};

package/dist/contexts/permission-context.d.ts

@@ -0,0 +1,14 @@
+import { default as React, ReactNode } from 'react';
+
+type PermissionActions = "canEdit" | "canView" | "canAdd" | "canDelete";
+type SubModulePermissions = Partial<Record<PermissionActions, boolean>>;
+type ModulePermissions = SubModulePermissions & Record<string, SubModulePermissions>;
+interface PermissionsContextType {
+    [module: string]: ModulePermissions;
+}
+interface PermissionsProviderProps {
+    children: ReactNode;
+}
+export declare const PermissionsContext: React.Context<PermissionsContextType>;
+export declare const PermissionsProvider: React.FC<PermissionsProviderProps>;
+export {};

package/dist/hooks/apiHelper.d.ts

@@ -0,0 +1,12 @@
+type ApiResponse = {
+    meta?: {
+        requestStatus?: string;
+    };
+    error?: {
+        message?: string;
+    };
+    payload?: any;
+};
+type Callback = () => void;
+export declare function apiHelper(res: ApiResponse, callBack?: Callback): void;
+export {};

package/dist/hooks/common.d.ts

@@ -0,0 +1,41 @@
+import { getCountries } from 'libphonenumber-js';
+
+export declare const formatNumber: (num: number, defaultCurrencySymbol?: string) => string;
+export declare function formateDate(date: any, format?: string): string;
+export declare function capitalizeWords(str: any): any;
+export declare const defaultUserCurrency: () => string;
+export declare const valueWithCurrency: (value: any) => string;
+export declare const sortData: (data: any[], key: string, direction: string) => any[];
+export declare function recursiveSort(data: any[], nestedKeys: any[], header: string, direction: string): any;
+export declare function formatTime(isoString: string, format?: string): string;
+type Nullable<T> = {
+    [P in keyof T]: T[P] extends object ? Nullable<T[P]> : T[P] | null;
+};
+export declare function convertEmptyToNull<T extends Record<string, any>>(obj: T): Nullable<T>;
+export declare function removeExtraKeys(data: any, extraKeys?: any[]): any;
+export declare const apiType: {
+    company: () => Promise<any[]>;
+    items: () => Promise<any[]>;
+    currency: () => Promise<any[]>;
+    salesperson: () => Promise<any[]>;
+    party: () => Promise<any[]>;
+    department: () => Promise<any[]>;
+    location: () => Promise<any[]>;
+    uom: () => Promise<any[]>;
+    discountedItems: () => Promise<any[]>;
+    taxTemplate: () => Promise<any[]>;
+    paymentTerm: () => Promise<any[]>;
+    incoTerms: () => Promise<any[]>;
+    shippingRules: () => Promise<any[]>;
+    bins: () => Promise<any[]>;
+    agreement: () => Promise<any[]>;
+    accounts: () => Promise<any[]>;
+    invoices: () => Promise<any[]>;
+    purchaseOrderReceipts: () => Promise<any[]>;
+    representatives: () => Promise<any[]>;
+    industry: () => Promise<any[]>;
+    categoryItems: () => Promise<any[]>;
+    customerSegment: () => Promise<any[]>;
+    countries: typeof getCountries;
+};
+export {};

package/dist/hooks/use-deep-memo.d.ts

@@ -0,0 +1,2 @@
+declare function useDeepMemo<T>(value: T): T;
+export default useDeepMemo;

package/dist/hooks/use-material-calculations.d.ts

@@ -0,0 +1,81 @@
+declare const MATERIAL_CONSTANTS: {
+    readonly STEEL_DENSITY: 7.85;
+    readonly LENGTH_CONVERSION_FACTOR: 1000;
+    readonly TUBE_CALCULATION_FACTOR: 0.024662;
+    readonly COIL_WEIGHTS: {
+        readonly GI: 2879.95;
+        readonly HR: 2356.59;
+    };
+};
+type SteelType = keyof typeof MATERIAL_CONSTANTS.COIL_WEIGHTS;
+type TubeType = 'Round' | 'Square' | 'Rectangle';
+interface BaseFormValues {
+    face_width?: string | number;
+    bending?: string | number;
+    height?: string | number;
+    total_width?: string | number;
+    boards_thickness?: string | number;
+    boards_length?: string | number;
+    steel_length?: string | number;
+    steel_width?: string | number;
+    steel_thickness?: string | number;
+    steel_type?: SteelType;
+    tube_type?: TubeType;
+    tube_od?: string | number;
+    shape_width?: string | number;
+    shape_height?: string | number;
+    material_thickness?: string | number;
+    material_length?: string | number;
+}
+interface MaterialCalculations {
+    totalWidth: number;
+    materialUnit: number;
+    boardsWeight: number;
+    steelWeight: number;
+    materialWeight: number;
+}
+interface CalculationResult<T = number> {
+    value: T;
+    isValid: boolean;
+    error?: string;
+}
+/**
+ * Custom hook for optimized material calculations with comprehensive error handling
+ * and performance optimization through memoization
+ */
+export declare const useMaterialCalculations: (formValues?: BaseFormValues) => MaterialCalculations;
+/**
+ * Utility function to validate form values before calculations
+ */
+export declare const validateFormValues: (formValues: BaseFormValues) => {
+    isValid: boolean;
+    errors: string[];
+};
+/**
+ * Get available steel types for form validation
+ */
+export declare const getAvailableSteelTypes: () => SteelType[];
+/**
+ * Get available tube types for form validation
+ */
+export declare const getAvailableTubeTypes: () => TubeType[];
+declare const _default: {
+    useMaterialCalculations: (formValues?: BaseFormValues) => MaterialCalculations;
+    validateFormValues: (formValues: BaseFormValues) => {
+        isValid: boolean;
+        errors: string[];
+    };
+    getAvailableSteelTypes: () => SteelType[];
+    getAvailableTubeTypes: () => TubeType[];
+    MATERIAL_CONSTANTS: {
+        readonly STEEL_DENSITY: 7.85;
+        readonly LENGTH_CONVERSION_FACTOR: 1000;
+        readonly TUBE_CALCULATION_FACTOR: 0.024662;
+        readonly COIL_WEIGHTS: {
+            readonly GI: 2879.95;
+            readonly HR: 2356.59;
+        };
+    };
+};
+export default _default;
+export type { BaseFormValues, MaterialCalculations, SteelType, TubeType, CalculationResult, };

package/dist/hooks/use-translations.d.ts

@@ -0,0 +1,3 @@
+export default function useAppTranslations(): {
+    isLoading: boolean;
+};

package/dist/hooks/useCheckSkuAndName.d.ts

@@ -0,0 +1,7 @@
+export default function useNameSkuUniquenessCheck({ fieldPrefix, formMethods, data }: {
+    fieldPrefix: string;
+    formMethods: any;
+    data?: any;
+}): {
+    checkNameAndSkuUniqueness: () => Promise<boolean>;
+};

package/dist/hooks/useDataFetcher.d.ts

@@ -0,0 +1,25 @@
+interface FilterParams {
+    skip: number;
+    limit: number;
+    search?: string;
+    select?: string;
+    order?: string;
+    filters?: string;
+}
+interface ActivePage {
+    sort?: {
+        id: string;
+        desc: boolean;
+    };
+    filterQueryString?: string;
+    search?: string;
+    visible_columns?: {
+        visible: boolean;
+        accessorKey: string;
+    }[];
+}
+export declare const useDataFetcher: (cols?: ActivePage, pagination: {
+    skip: number;
+    limit: number;
+}, fetchAction: (filters: FilterParams) => void, customeFilter?: any, customDeps?: any[], showCreatedBy?: boolean, customFields?: any) => () => void;
+export default useDataFetcher;

package/dist/hooks/useLanguageFallback.d.ts

@@ -0,0 +1,67 @@
+interface ILanguage {
+    label: string;
+    code: string;
+    direction: string;
+}
+interface FallbackConfig {
+    fallbackOrder?: string[];
+    enableConsoleWarnings?: boolean;
+    retryOnError?: boolean;
+    maxRetries?: number;
+}
+export declare const useLanguageFallback: (config?: FallbackConfig) => {
+    findBestAvailableLanguage: (languages: ILanguage[], preferredCode?: string) => ILanguage | null;
+    createEmergencyFallback: () => ILanguage;
+    createEnglishFallback: () => ILanguage;
+    validateLanguageCode: (languages: ILanguage[], code: string) => boolean;
+    getSavedLanguage: (languages: ILanguage[]) => string | null;
+    ensureEnglishAvailable: (languages: ILanguage[]) => ILanguage[];
+    shouldRetry: () => boolean;
+    incrementRetry: () => void;
+    resetRetry: () => void;
+    retryCount: number;
+    config: {
+        fallbackOrder: string[];
+        enableConsoleWarnings: boolean;
+        retryOnError: boolean;
+        maxRetries: number;
+    };
+};
+export declare const useLanguageState: () => {
+    isInitialized: boolean;
+    hasError: boolean;
+    errorMessage: string;
+    markInitialized: () => void;
+    setError: (error: string) => void;
+    clearError: () => void;
+};
+declare const _default: {
+    useLanguageFallback: (config?: FallbackConfig) => {
+        findBestAvailableLanguage: (languages: ILanguage[], preferredCode?: string) => ILanguage | null;
+        createEmergencyFallback: () => ILanguage;
+        createEnglishFallback: () => ILanguage;
+        validateLanguageCode: (languages: ILanguage[], code: string) => boolean;
+        getSavedLanguage: (languages: ILanguage[]) => string | null;
+        ensureEnglishAvailable: (languages: ILanguage[]) => ILanguage[];
+        shouldRetry: () => boolean;
+        incrementRetry: () => void;
+        resetRetry: () => void;
+        retryCount: number;
+        config: {
+            fallbackOrder: string[];
+            enableConsoleWarnings: boolean;
+            retryOnError: boolean;
+            maxRetries: number;
+        };
+    };
+    useLanguageState: () => {
+        isInitialized: boolean;
+        hasError: boolean;
+        errorMessage: string;
+        markInitialized: () => void;
+        setError: (error: string) => void;
+        clearError: () => void;
+    };
+};
+export default _default;
+export type { ILanguage, FallbackConfig };

package/dist/hooks/useLocationFilter.d.ts

@@ -0,0 +1,43 @@
+export declare const useLocationFilter: ({ selectedCompany, setValue, fieldArrayName, locationFieldName, resetValue, filterKey, isDirty }: {
+    selectedCompany: any;
+    setValue: any;
+    fieldArrayName: any;
+    locationFieldName: any;
+    resetValue?: any;
+    filterKey?: string;
+    isDirty?: boolean;
+}) => {
+    [x: string]: any;
+};
+export declare const useMultipleLocationFilters: ({ selectedCompany, setValue, fieldConfigs, resetValue, filterKey }: {
+    selectedCompany: any;
+    setValue: any;
+    fieldConfigs: any;
+    resetValue?: any;
+    filterKey?: string;
+}) => {
+    [x: string]: any;
+};
+declare const _default: {
+    useLocationFilter: ({ selectedCompany, setValue, fieldArrayName, locationFieldName, resetValue, filterKey, isDirty }: {
+        selectedCompany: any;
+        setValue: any;
+        fieldArrayName: any;
+        locationFieldName: any;
+        resetValue?: any;
+        filterKey?: string;
+        isDirty?: boolean;
+    }) => {
+        [x: string]: any;
+    };
+    useMultipleLocationFilters: ({ selectedCompany, setValue, fieldConfigs, resetValue, filterKey }: {
+        selectedCompany: any;
+        setValue: any;
+        fieldConfigs: any;
+        resetValue?: any;
+        filterKey?: string;
+    }) => {
+        [x: string]: any;
+    };
+};
+export default _default;

package/dist/hooks/useReduxIntegration.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hook to determine Redux integration status and provide conditional Redux usage
+ */
+export declare const useReduxIntegration: () => {
+    useRedux: boolean;
+    apiClient: import('..').ApiClientConfig;
+    useConditionalRedux: <T>(reduxHook: () => T, fallbackValue: T) => T;
+    conditionalDispatch: (action: any) => any;
+};

package/dist/index.d.ts

@@ -1 +1,190 @@
-export * from './src/index'
+/**
+ * @erpforce/common - ERP Common UI Library
+ * 
+ * This is the main entry point for the @erpforce/common library.
+ * It exports only stable functionality that doesn't require peer dependencies.
+ * 
+ * For full functionality, install the required peer dependencies:
+ * @see https://www.npmjs.com/package/@erpforce/common#peer-dependencies
+ */
+
+// ===== CORE EXPORTS (No external dependencies) =====
+
+/**
+ * Library Configuration System
+ * Provides configuration management for application-specific business logic
+ */
+export {
+  configureLibrary,
+  getLibraryConfig,
+  getConfigFunction,
+  type LibraryConfig
+} from './config';
+
+/**
+ * Static Assets
+ * Pre-bundled images and icons that work without external dependencies
+ */
+export { default as images } from './assets/images';
+
+/**
+ * Constants
+ * Basic constants and configuration values
+ */
+export { DEFAULT_LANG, LANGUAGES } from './constants/all-language';
+export { S3_BUCKET_URL } from './constants/common';
+export { modules } from './constants';
+
+// ===== TYPE EXPORTS =====
+
+/**
+ * Core TypeScript type definitions
+ * These types are available for use in consuming applications
+ */
+export type {
+  // Base component interfaces
+  BaseComponentProps,
+  ThemeConfig,
+  ERPUIProviderProps,
+  
+  // Data interfaces
+  SelectOption,
+  TableColumn,
+  PaginationProps,
+  FormField,
+  ApiResponse,
+  Language,
+  
+  // Context interfaces
+  LanguageContextType,
+  AuthContextType,
+  PageContextType,
+  PermissionContextType,
+  
+  // User and permission interfaces
+  User,
+  Permission,
+  
+  // Redux integration interfaces
+  LibraryReduxSlices,
+  ReduxIntegration
+} from './types';
+
+/**
+ * Additional commonly used types from contexts
+ * Exported for convenience when working with page state and views
+ */
+export type {
+  PageState,
+  ViewType,
+  SavedViewType,
+  GeneratedColumnsState
+} from './contexts';
+
+// ===== OPTIONAL EXPORTS (Require peer dependencies) =====
+
+/**
+ * IMPORTANT: The following exports require peer dependencies to be installed.
+ * 
+ * To use components, hooks, contexts, theme, and utilities, install:
+ * 
+ * Required peer dependencies:
+ * - react (>=18.0.0)
+ * - react-dom (>=18.0.0)
+ * - @mui/material (>=5.0.0)
+ * - @mui/icons-material (>=5.0.0)
+ * - @emotion/react (>=11.0.0)
+ * - @emotion/styled (>=11.0.0)
+ * 
+ * Optional peer dependencies (for specific features):
+ * - react-redux (>=8.0.0) - for Redux integration
+ * - @reduxjs/toolkit (>=1.9.0) - for Redux store management
+ * - react-router-dom (>=6.0.0) - for routing utilities
+ * - react-i18next (>=12.0.0) - for internationalization
+ * - dayjs (>=1.11.0) - for date utilities
+ * - lodash (>=4.17.0) - for utility functions
+ * - axios (>=1.0.0) - for API utilities
+ * - notistack (>=3.0.0) - for notifications
+ * - socket.io-client (>=4.0.0) - for real-time features
+ * - moment-timezone (>=0.5.0) - for timezone handling
+ * - libphonenumber-js (>=1.10.0) - for phone validation
+ * - yup (>=1.0.0) - for form validation
+ * - material-react-table (>=1.0.0) - for advanced tables
+ * - react-querybuilder (>=6.0.0) - for query building
+ * 
+ * Installation example:
+ * ```bash
+ * npm install @mui/material @mui/icons-material @emotion/react @emotion/styled
+ * npm install react-redux @reduxjs/toolkit react-router-dom react-i18next
+ * npm install dayjs lodash axios notistack
+ * ```
+ * 
+ * After installing peer dependencies, you can import:
+ * 
+ * Components:
+ * ```typescript
+ * import { Button, TextField, DataGrid } from '@erpforce/common/components';
+ * ```
+ * 
+ * Hooks:
+ * ```typescript
+ * import { useAuth, useLanguage, usePermissions } from '@erpforce/common/hooks';
+ * ```
+ * 
+ * Contexts:
+ * ```typescript
+ * import { AuthProvider, LanguageProvider } from '@erpforce/common/contexts';
+ * ```
+ * 
+ * Theme:
+ * ```typescript
+ * import { createLightTheme, createDarkTheme } from '@erpforce/common/theme';
+ * ```
+ * 
+ * Utilities:
+ * ```typescript
+ * import { formatDate, validateEmail } from '@erpforce/common/utils';
+ * ```
+ * 
+ * Redux:
+ * ```typescript
+ * import { createStore, slices } from '@erpforce/common/redux';
+ * ```
+ * 
+ * API Clients:
+ * ```typescript
+ * import { AccountingAPI, InventoryAPI } from '@erpforce/common/api-client';
+ * ```
+ * 
+ * Note: Direct barrel exports (export * from './components') are intentionally
+ * disabled to prevent dependency resolution errors. Use specific imports instead.
+ */
+
+// Component and feature exports (require peer dependencies)
+export * from './components';
+export * from './hooks';
+export * from './contexts';
+export * from './theme';
+export * from './utils';
+export * from './redux';
+export * from './api-client';
+export * from './layout';
+
+/**
+ * Views
+ * Ready-to-use views and page templates including:
+ * - Template Editor (Email/PDF editor with WYSIWYG capabilities)
+ * 
+ * Usage:
+ * ```typescript
+ * import { 
+ *   Templates, 
+ *   AddTemplate, 
+ *   templateEditorRoutes,
+ *   SectionFlowEditor,
+ *   type ElementType,
+ *   type SectionData 
+ * } from '@erpforce/common/views';
+ * ```
+ */
+export * from './views';