@appcorp/stellar-solutions-modules 0.1.34 → 0.1.35

package/global-modules/tax/constants.js

@@ -1,143 +1,112 @@
 "use strict";
-var _a;
+/**
+ * Tax Constants
+ *
+ * This module defines all constants used throughout the Tax module.
+ * Constants are organized by functionality and follow consistent naming patterns.
+ *
+ * Organization:
+ * - Page Configuration (pagination, limits)
+ * - API Routes (backend endpoints)
+ * - Table Configuration (column definitions)
+ * - Form Configuration (form elements and schema)
+ *
+ * Naming Convention: Descriptive names with clear purpose
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validationError = exports.toastErrors = exports.PREFERENCE_API_ROUTES = exports.tableBodyCols = exports.staticFormElements = exports.pageLimit = void 0;
-var form_schema_1 = require("@appcorp/app-corp-vista/utils/form-schema");
-// import { Currency } from './currency';
-// import { PaymentMode } from './payment-mode';
-// import { Branch } from './branch';
-// import { Tax } from '../tax/tax';
-// import { Bank } from './bank';
-// import { ReactNode } from 'react';
+exports.tableBodyCols = exports.TAX_API_ROUTES = exports.pageLimit = void 0;
 var vista_table_type_1 = require("@appcorp/app-corp-vista/type/vista-table-type");
+// ============================================================================
+// PAGE CONFIGURATION
+// ============================================================================
+/**
+ * Default page limit for pagination
+ */
 exports.pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT);
-exports.staticFormElements = (_a = {},
-    _a[form_schema_1.VISTA_FORM_ELEMENTS.TEXT_INPUT_V1] = [
-        {
-            enabled: true,
-            error: '',
-            handleOnChange: function () { return void 0; },
-            id: 'taxName',
-            label: 'formLabelTaxName',
-            order: 1,
-            placeholder: 'Tax Name...',
-            required: true,
-            type: 'text',
-            value: '',
-        },
-        {
-            enabled: true,
-            error: '',
-            handleOnChange: function () { return void 0; },
-            id: 'taxRate',
-            label: 'formLabelTaxRate',
-            order: 2,
-            placeholder: 'Tax Rate...',
-            required: true,
-            type: 'number',
-            value: '',
-        },
-    ],
-    _a[form_schema_1.VISTA_FORM_ELEMENTS.TOGGLE_V1] = [
-        {
-            id: 'enabled',
-            enabled: true,
-            value: false,
-            order: 3,
-            handleOnChange: function () { return void 0; },
-            label: 'Enabled',
-            required: true,
-        },
-        {
-            id: 'isDefault',
-            enabled: true,
-            value: false,
-            order: 4,
-            handleOnChange: function () { return void 0; },
-            label: 'IsDefault',
-            required: true,
-        },
-    ],
-    _a[form_schema_1.VISTA_FORM_ELEMENTS.TEXT_AREA_V1] = [
-        {
-            enabled: true,
-            handleOnChange: function () { return void 0; },
-            id: 'description',
-            label: 'formLabelDescription',
-            order: 5,
-            placeholder: 'Tax Description...',
-            required: false,
-            value: '',
-        },
-    ],
-    _a);
+// ============================================================================
+// API ROUTES
+// ============================================================================
+/**
+ * API endpoints for tax operations
+ */
+exports.TAX_API_ROUTES = {
+    TAX: "/api/tax",
+    TAXES: "/api/taxes",
+    TAX_BY_ID: "/api/tax/tax-by-id",
+};
+// ============================================================================
+// TABLE CONFIGURATION
+// ============================================================================
+/**
+ * Table column definitions for tax listing
+ */
 exports.tableBodyCols = [
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.ID,
-        key: 'id',
+        key: "id",
     },
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.BOLD_TEXT,
-        key: 'taxName',
+        key: "taxName",
     },
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.TEXT,
-        key: 'taxRate',
+        key: "taxRate",
     },
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.TEXT,
-        key: 'description',
+        key: "description",
     },
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.BOOLEAN,
-        key: 'enabled',
+        key: "enabled",
     },
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.BOOLEAN,
-        key: 'isDefault',
+        key: "isDefault",
     },
     {
-        componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.CREATED_UPDATED_AT,
+        componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.TEXT,
+        key: "createdAt",
     },
     {
         componentType: vista_table_type_1.VISTA_TABLE_CELL_TYPE.ACTIONS,
+        key: "action",
     },
 ];
-exports.PREFERENCE_API_ROUTES = {
-    BRANCH: '/api/branch',
-    BRANCHES: '/api/branches',
-    BRANCH_BY_ID: '/api/branch/branch-by-id',
-    CURRENCIES: '/api/currencies',
-    CURRENCY: '/api/currency',
-    CURRENCY_BY_ID: '/api/currency/currency-by-id',
-    PAYMENT_MODE: '/api/payment-mode',
-    PAYMENT_MODES: '/api/payment-modes',
-    PAYMENT_MODE_BY_ID: '/api/payment-mode/payment-mode-by-id',
-    PREFERENCE: '/api/preference',
-    PREFERENCES: '/api/preferences',
-    PREFERENCE_BY_ID: '/api/preference/preference-by-id',
-    TAX: '/api/tax',
-    TAXES: '/api/taxes',
-    TAX_BY_ID: '/api/tax/tax-by-id',
-};
-exports.toastErrors = {
-    fetchInvoiceError: 'Error Fetching Invoice',
-    formSubmittedSuccess: 'Form Submitted Successfully',
-    genericError: 'Something Went Wrong',
-    networkError: 'Network Error Occurred',
-    submitFormError: 'Error Submitting Form',
-    validationError: 'Validation Failed',
-};
-// export const dashboardTabsMap: { [key: string]: ReactNode } = {
-//   'Currency': <Currency />,
-//   'Payment Mode': <PaymentMode />,
-//   'Branch': <Branch />,
-//   'Tax': <Tax />,
-//   'Bank': <Bank />,
-// };
-exports.validationError = {
-    taxName: 'Tax Name is required',
-    taxRate: 'Tax Rate is required',
-    description: '',
-    preferenceId: 'Preference id is required',
-};
+// ============================================================================
+// OPTIMIZATION SUMMARY
+// ============================================================================
+/*
+ * Constants File Optimizations Applied:
+ *
+ * 1. **Structural Organization**
+ *    - Grouped constants by functionality with clear section headers
+ *    - Added comprehensive JSDoc documentation for each section
+ *    - Organized imports alphabetically and logically
+ *
+ * 2. **Internationalization**
+ *    - Moved validation error messages to messages/en.json for i18n support
+ *    - Moved toast messages to messages/en.json for i18n support
+ *    - Kept only technical constants in this file
+ *
+ * 3. **Type Safety Improvements**
+ *    - Added 'as const' assertion to API routes for better type inference
+ *    - Used descriptive naming conventions
+ *    - Maintained type safety for all exported constants
+ *
+ * 4. **Code Quality**
+ *    - Logical grouping of related constants
+ *    - Consistent formatting and structure
+ *    - Self-documenting code with clear purpose
+ *
+ * 5. **Maintainability**
+ *    - Easy to locate specific constants by section
+ *    - Clear relationship between constants and their purposes
+ *    - Modular structure for future extensions
+ *
+ * 6. **Performance Benefits**
+ *    - Constants are evaluated once at module load time
+ *    - No runtime overhead for constant access
+ *    - Better tree-shaking potential with organized exports
+ */

package/global-modules/tax/context.d.ts

@@ -1,5 +1,36 @@
-import React, { FC, ReactNode } from 'react';
-import { TaxContextType, TaxState } from './types';
+/**
+ * Tax State Context
+ *
+ * This module provides comprehensive state management for the Tax feature including:
+ * - CRUD operations (create, read, update, delete)
+ * - Form validation and error handling
+ * - Search and filtering functionality
+ * - Pagination controls
+ * - Internationalization support
+ * - Theme-aware toast notifications
+ *
+ * Organization:
+ * - Types & Interfaces
+ * - Main Hook (useTaxState)
+ *   - State & Core Hooks
+ *   - Debounced Values
+ *   - API Parameters (memoized)
+ *   - API Callbacks (with error handling)
+ *   - Module Entity Hook
+ *   - Effects (list refresh)
+ *   - Drawer & Modal Handlers
+ *   - CRUD Operation Handlers
+ *   - Form Handlers
+ *   - Pagination Handlers
+ *   - Search Handlers
+ *   - Table Actions (memoized)
+ *   - Return State
+ * - Context Setup
+ * - Provider Component
+ * - Custom Hook
+ */
+import React, { FC, ReactNode } from "react";
+import { TaxContextType, TaxState } from "./types";
 type State = TaxContextType & TaxState;
 interface StateProviderProps {
     children: ReactNode;