@appcorp/stellar-solutions-modules 0.1.68 → 0.1.70

package/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const LS_KEYS: {
+    BANKS: string;
+    CURRENCIES: string;
+    PAYMENT_MODES: string;
+    PREFERENCES: string;
+    BRANCHES: string;
+    TAXES: string;
+};

package/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LS_KEYS = void 0;
+exports.LS_KEYS = {
+    BANKS: "banks_cache",
+    CURRENCIES: "currencies_cache",
+    PAYMENT_MODES: "payment_modes_cache",
+    PREFERENCES: "preferences_cache",
+    BRANCHES: "branches_cache",
+    TAXES: "taxes_cache",
+};

package/global-modules/bank/cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bank Module Cache Utilities
+ *
+ * Provides localStorage-based caching for banks using generic cache system.
+ */
+import { BankTypeBE } from "./types";
+export declare const getCachedBanksSync: () => {
+    count: number;
+    items: BankTypeBE[];
+};
+export declare const getCachedBanks: ({ params, }?: {
+    params?: Record<string, unknown>;
+}) => Promise<{
+    count: number;
+    items: BankTypeBE[];
+}>;
+export declare const getCachedBankById: (bankId: string) => BankTypeBE | null;
+export declare const invalidateBanksCache: () => void;
+export declare const preloadBanks: () => Promise<{
+    count: number;
+    items: BankTypeBE[];
+}>;
+export declare const isBanksCacheStale: () => boolean;

package/global-modules/bank/cache.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Bank Module Cache Utilities
+ *
+ * Provides localStorage-based caching for banks using generic cache system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBanksCacheStale = exports.preloadBanks = exports.invalidateBanksCache = exports.getCachedBankById = exports.getCachedBanks = exports.getCachedBanksSync = void 0;
+var constants_1 = require("@/constants");
+var util_functions_1 = require("@react-pakistan/util-functions");
+var constants_2 = require("./constants");
+// ============================================================================
+// CACHE CONFIGURATION
+// ============================================================================
+var BANK_CACHE_CONFIG = {
+    apiUrl: constants_2.BANK_API_ROUTES.BANKS,
+    cacheKey: constants_1.LS_KEYS.BANKS,
+};
+// ============================================================================
+// BANK-SPECIFIC CACHE FUNCTIONS
+// ============================================================================
+var getCachedBanksSync = function () {
+    return (0, util_functions_1.getCachedDataSync)(constants_1.LS_KEYS.BANKS);
+};
+exports.getCachedBanksSync = getCachedBanksSync;
+var getCachedBanks = function (_a) {
+    var _b = _a === void 0 ? {} : _a, params = _b.params;
+    return (0, util_functions_1.getCachedData)({
+        config: BANK_CACHE_CONFIG,
+        params: params,
+    });
+};
+exports.getCachedBanks = getCachedBanks;
+var getCachedBankById = function (bankId) {
+    return (0, util_functions_1.getCachedItemById)(constants_1.LS_KEYS.BANKS, bankId);
+};
+exports.getCachedBankById = getCachedBankById;
+var invalidateBanksCache = function () { return (0, util_functions_1.invalidateCache)(constants_1.LS_KEYS.BANKS); };
+exports.invalidateBanksCache = invalidateBanksCache;
+var preloadBanks = function () {
+    return (0, util_functions_1.preloadCache)(BANK_CACHE_CONFIG);
+};
+exports.preloadBanks = preloadBanks;
+var isBanksCacheStale = function () { return (0, util_functions_1.isCacheStale)(constants_1.LS_KEYS.BANKS); };
+exports.isBanksCacheStale = isBanksCacheStale;

package/global-modules/bank/context.js

@@ -75,6 +75,42 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+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(exports, "__esModule", { value: true });
 exports.useBankStateContext = exports.BankStateContextProvider = exports.BankStateContext = void 0;
 var react_1 = __importStar(require("react"));
@@ -87,6 +123,7 @@ var reducer_1 = require("./reducer");
 var toast_utils_1 = require("@appcorp/shadcn/lib/toast-utils");
 var types_1 = require("./types");
 var validate_1 = require("./validate");
+var cache_1 = require("./cache");
 // ============================================================================
 // MAIN HOOK
 // ============================================================================
@@ -179,6 +216,8 @@ var useBankState = function () {
         }
         if (data) {
             showSuccessToast(t("messagesBankUpdated"));
+            // Invalidate cache to force fresh data on next fetch
+            (0, cache_1.invalidateBanksCache)();
             dispatch({
                 type: actions_1.BANK_ACTION_TYPES.RESET_FORM,
             });
@@ -194,11 +233,13 @@ var useBankState = function () {
     var deleteCallback = (0, react_1.useCallback)(function (_a) {
         var data = _a.data, error = _a.error;
         if (error) {
-            showErrorToast(typeof "messagesNetworkError");
+            showErrorToast(t("messagesNetworkError"));
             return;
         }
         if (data) {
             showSuccessToast(t("messagesBankDeleted"));
+            // Invalidate cache to force fresh data on next fetch
+            (0, cache_1.invalidateBanksCache)();
             dispatch({
                 type: actions_1.BANK_ACTION_TYPES.RESET_FORM,
             });
@@ -234,14 +275,56 @@ var useBankState = function () {
         updateCallback: updateCallback,
         updateDeps: [state],
         updateParams: updateParams,
-    }), deleteError = _b.deleteError, deleteFetchNow = _b.deleteFetchNow, deleteLoading = _b.deleteLoading, listError = _b.listError, listFetchNow = _b.listFetchNow, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
+    }), deleteError = _b.deleteError, deleteFetchNow = _b.deleteFetchNow, deleteLoading = _b.deleteLoading, listError = _b.listError, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
     // ---------------------------------------------------------------------------
-    // EFFECTS (list refresh)
+    // EFFECTS
     // ---------------------------------------------------------------------------
+    /**
+     * Cache loading effect
+     *
+     * Loads banks from cache for instant UI feedback.
+     * Falls back to API if cache miss occurs.
+     *
+     * Triggers on:
+     * - debouncedQuery change (search)
+     * - currentPage change (pagination)
+     * - pageLimit change (items per page)
+     *
+     * Implementation:
+     * - Fetches from cache asynchronously
+     * - Slices data for client-side pagination
+     * - Updates count for pagination controls
+     * - Handles errors with toast notifications
+     */
     (0, react_1.useEffect)(function () {
-        listFetchNow();
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [debouncedQuery, state.currentPage, state.pageLimit]);
+        (function () { return __awaiter(void 0, void 0, void 0, function () {
+            var _a, count, items, error_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, (0, cache_1.getCachedBanks)({
+                                params: listParams,
+                            })];
+                    case 1:
+                        _a = _b.sent(), count = _a.count, items = _a.items;
+                        dispatch({
+                            type: actions_1.BANK_ACTION_TYPES.SET_BANKS,
+                            payload: { banks: items },
+                        });
+                        dispatch({
+                            type: actions_1.BANK_ACTION_TYPES.SET_COUNT,
+                            payload: { count: count },
+                        });
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_1 = _b.sent();
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        }); })();
+    }, [listParams]);
     // ---------------------------------------------------------------------------
     // DRAWER & MODAL HANDLERS
     // ---------------------------------------------------------------------------

package/global-modules/branch/cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Branch Module Cache Utilities
+ *
+ * Provides localStorage-based caching for branches using generic cache system.
+ */
+import { BranchTypeBE } from "./types";
+export declare const getCachedBranchesSync: () => {
+    count: number;
+    items: BranchTypeBE[];
+};
+export declare const getCachedBranches: ({ params, }?: {
+    params?: Record<string, unknown>;
+}) => Promise<{
+    count: number;
+    items: BranchTypeBE[];
+}>;
+export declare const getCachedBranchById: (branchId: string) => BranchTypeBE | null;
+export declare const invalidateBranchesCache: () => void;
+export declare const preloadBranches: () => Promise<{
+    count: number;
+    items: BranchTypeBE[];
+}>;
+export declare const isBranchesCacheStale: () => boolean;

package/global-modules/branch/cache.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Branch Module Cache Utilities
+ *
+ * Provides localStorage-based caching for branches using generic cache system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBranchesCacheStale = exports.preloadBranches = exports.invalidateBranchesCache = exports.getCachedBranchById = exports.getCachedBranches = exports.getCachedBranchesSync = void 0;
+var constants_1 = require("@/constants");
+var util_functions_1 = require("@react-pakistan/util-functions");
+var constants_2 = require("./constants");
+// ============================================================================
+// CACHE CONFIGURATION
+// ============================================================================
+var BRANCH_CACHE_CONFIG = {
+    apiUrl: constants_2.BRANCH_API_ROUTES.BRANCHES,
+    cacheKey: constants_1.LS_KEYS.BRANCHES,
+};
+// ============================================================================
+// BRANCH-SPECIFIC CACHE FUNCTIONS
+// ============================================================================
+var getCachedBranchesSync = function () {
+    return (0, util_functions_1.getCachedDataSync)(constants_1.LS_KEYS.BRANCHES);
+};
+exports.getCachedBranchesSync = getCachedBranchesSync;
+var getCachedBranches = function (_a) {
+    var _b = _a === void 0 ? {} : _a, params = _b.params;
+    return (0, util_functions_1.getCachedData)({
+        config: BRANCH_CACHE_CONFIG,
+        params: params,
+    });
+};
+exports.getCachedBranches = getCachedBranches;
+var getCachedBranchById = function (branchId) {
+    return (0, util_functions_1.getCachedItemById)(constants_1.LS_KEYS.BRANCHES, branchId);
+};
+exports.getCachedBranchById = getCachedBranchById;
+var invalidateBranchesCache = function () { return (0, util_functions_1.invalidateCache)(constants_1.LS_KEYS.BRANCHES); };
+exports.invalidateBranchesCache = invalidateBranchesCache;
+var preloadBranches = function () {
+    return (0, util_functions_1.preloadCache)(BRANCH_CACHE_CONFIG);
+};
+exports.preloadBranches = preloadBranches;
+var isBranchesCacheStale = function () { return (0, util_functions_1.isCacheStale)(constants_1.LS_KEYS.BRANCHES); };
+exports.isBranchesCacheStale = isBranchesCacheStale;

package/global-modules/branch/context.js

@@ -75,6 +75,42 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+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(exports, "__esModule", { value: true });
 exports.useBranchStateContext = exports.BranchStateContextProvider = exports.BranchStateContext = void 0;
 var react_1 = __importStar(require("react"));
@@ -88,6 +124,7 @@ var toast_utils_1 = require("@appcorp/shadcn/lib/toast-utils");
 var types_1 = require("./types");
 var validate_1 = require("./validate");
 var context_1 = require("../preferences/context");
+var cache_1 = require("./cache");
 // ============================================================================
 // MAIN HOOK
 // ============================================================================
@@ -182,6 +219,8 @@ var useBranchState = function () {
         }
         if (data) {
             showSuccessToast(t("messagesBranchUpdated"));
+            // Invalidate cache to force fresh data on next fetch
+            (0, cache_1.invalidateBranchesCache)();
             dispatch({
                 type: actions_1.BRANCH_ACTION_TYPES.RESET_FORM,
             });
@@ -217,6 +256,8 @@ var useBranchState = function () {
         }
         if (data) {
             showSuccessToast(t("messagesBranchDeleted"));
+            // Invalidate cache to force fresh data on next fetch
+            (0, cache_1.invalidateBranchesCache)();
             dispatch({
                 type: actions_1.BRANCH_ACTION_TYPES.RESET_FORM,
             });
@@ -239,14 +280,57 @@ var useBranchState = function () {
         updateCallback: updateCallback,
         updateDeps: [state],
         updateParams: updateParams,
-    }), byIdError = _b.byIdError, byIdFetchNow = _b.byIdFetchNow, byIdLoading = _b.byIdLoading, deleteError = _b.deleteError, deleteFetchNow = _b.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, deleteFetchNow = _b.deleteFetchNow, deleteLoading = _b.deleteLoading, listError = _b.listError, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
     // ---------------------------------------------------------------------------
-    // EFFECTS (list refresh)
+    // EFFECTS
     // ---------------------------------------------------------------------------
+    /**
+     * Cache loading effect
+     *
+     * Loads branches from cache for instant UI feedback.
+     * Falls back to API if cache miss occurs.
+     *
+     * Triggers on:
+     * - debouncedQuery change (search)
+     * - currentPage change (pagination)
+     * - pageLimit change (items per page)
+     *
+     * Implementation:
+     * - Fetches from cache asynchronously
+     * - Applies client-side search filtering
+     * - Slices data for client-side pagination
+     * - Updates count for pagination controls
+     * - Handles errors with toast notifications
+     */
     (0, react_1.useEffect)(function () {
-        listFetchNow();
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [debouncedQuery, state.currentPage, state.pageLimit]);
+        (function () { return __awaiter(void 0, void 0, void 0, function () {
+            var _a, count, items, error_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, (0, cache_1.getCachedBranches)({
+                                params: listParams,
+                            })];
+                    case 1:
+                        _a = _b.sent(), count = _a.count, items = _a.items;
+                        dispatch({
+                            type: actions_1.BRANCH_ACTION_TYPES.SET_BRANCHES,
+                            payload: { branches: items },
+                        });
+                        dispatch({
+                            type: actions_1.BRANCH_ACTION_TYPES.SET_COUNT,
+                            payload: { count: count },
+                        });
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_1 = _b.sent();
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        }); })();
+    }, [listParams]);
     // ---------------------------------------------------------------------------
     // DRAWER & MODAL HANDLERS
     // ---------------------------------------------------------------------------

package/global-modules/currency/cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Currency Module Cache Utilities
+ *
+ * Provides localStorage-based caching for currencies using generic cache system.
+ */
+import { CurrencyTypeBE } from "./types";
+export declare const getCachedCurrenciesSync: () => {
+    count: number;
+    items: CurrencyTypeBE[];
+};
+export declare const getCachedCurrencies: ({ params, }?: {
+    params?: Record<string, unknown>;
+}) => Promise<{
+    count: number;
+    items: CurrencyTypeBE[];
+}>;
+export declare const getCachedCurrencyById: (currencyId: string) => CurrencyTypeBE | null;
+export declare const invalidateCurrenciesCache: () => void;
+export declare const preloadCurrencies: () => Promise<{
+    count: number;
+    items: CurrencyTypeBE[];
+}>;
+export declare const isCurrenciesCacheStale: () => boolean;

package/global-modules/currency/cache.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Currency Module Cache Utilities
+ *
+ * Provides localStorage-based caching for currencies using generic cache system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCurrenciesCacheStale = exports.preloadCurrencies = exports.invalidateCurrenciesCache = exports.getCachedCurrencyById = exports.getCachedCurrencies = exports.getCachedCurrenciesSync = void 0;
+var constants_1 = require("@/constants");
+var util_functions_1 = require("@react-pakistan/util-functions");
+var constants_2 = require("./constants");
+// ============================================================================
+// CACHE CONFIGURATION
+// ============================================================================
+var CURRENCY_CACHE_CONFIG = {
+    apiUrl: constants_2.CURRENCY_API_ROUTES.CURRENCIES,
+    cacheKey: constants_1.LS_KEYS.CURRENCIES,
+};
+// ============================================================================
+// CURRENCY-SPECIFIC CACHE FUNCTIONS
+// ============================================================================
+var getCachedCurrenciesSync = function () {
+    return (0, util_functions_1.getCachedDataSync)(constants_1.LS_KEYS.CURRENCIES);
+};
+exports.getCachedCurrenciesSync = getCachedCurrenciesSync;
+var getCachedCurrencies = function (_a) {
+    var _b = _a === void 0 ? {} : _a, params = _b.params;
+    return (0, util_functions_1.getCachedData)({
+        config: CURRENCY_CACHE_CONFIG,
+        params: params,
+    });
+};
+exports.getCachedCurrencies = getCachedCurrencies;
+var getCachedCurrencyById = function (currencyId) {
+    return (0, util_functions_1.getCachedItemById)(constants_1.LS_KEYS.CURRENCIES, currencyId);
+};
+exports.getCachedCurrencyById = getCachedCurrencyById;
+var invalidateCurrenciesCache = function () {
+    return (0, util_functions_1.invalidateCache)(constants_1.LS_KEYS.CURRENCIES);
+};
+exports.invalidateCurrenciesCache = invalidateCurrenciesCache;
+var preloadCurrencies = function () {
+    return (0, util_functions_1.preloadCache)(CURRENCY_CACHE_CONFIG);
+};
+exports.preloadCurrencies = preloadCurrencies;
+var isCurrenciesCacheStale = function () { return (0, util_functions_1.isCacheStale)(constants_1.LS_KEYS.CURRENCIES); };
+exports.isCurrenciesCacheStale = isCurrenciesCacheStale;

package/global-modules/currency/context.js

@@ -75,6 +75,42 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+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(exports, "__esModule", { value: true });
 exports.useCurrencyStateContext = exports.CurrencyStateContextProvider = exports.CurrencyStateContext = void 0;
 var react_1 = __importStar(require("react"));
@@ -87,6 +123,7 @@ var reducer_1 = require("./reducer");
 var toast_utils_1 = require("@appcorp/shadcn/lib/toast-utils");
 var types_1 = require("./types");
 var validate_1 = require("./validate");
+var cache_1 = require("./cache");
 // ============================================================================
 // MAIN HOOK
 // ============================================================================
@@ -168,6 +205,8 @@ var useCurrencyState = function () {
         }
         if (data) {
             showSuccessToast(t("messagesCurrencyUpdated"));
+            // Invalidate cache to force fresh data on next fetch
+            (0, cache_1.invalidateCurrenciesCache)();
             dispatch({
                 type: actions_1.CURRENCY_ACTION_TYPES.RESET_FORM,
             });
@@ -188,6 +227,8 @@ var useCurrencyState = function () {
         }
         if (data) {
             showSuccessToast(t("messagesCurrencyDeleted"));
+            // Invalidate cache to force fresh data on next fetch
+            (0, cache_1.invalidateCurrenciesCache)();
             dispatch({
                 type: actions_1.CURRENCY_ACTION_TYPES.RESET_FORM,
             });
@@ -223,14 +264,57 @@ var useCurrencyState = function () {
         updateCallback: updateCallback,
         updateDeps: [state],
         updateParams: updateParams,
-    }), deleteError = _b.deleteError, deleteFetchNow = _b.deleteFetchNow, deleteLoading = _b.deleteLoading, listError = _b.listError, listFetchNow = _b.listFetchNow, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
+    }), deleteError = _b.deleteError, deleteFetchNow = _b.deleteFetchNow, deleteLoading = _b.deleteLoading, listError = _b.listError, listLoading = _b.listLoading, updateError = _b.updateError, updateFetchNow = _b.updateFetchNow, updateLoading = _b.updateLoading;
     // ---------------------------------------------------------------------------
-    // EFFECTS (list refresh)
+    // EFFECTS
     // ---------------------------------------------------------------------------
+    /**
+     * Cache loading effect
+     *
+     * Loads currencies from cache for instant UI feedback.
+     * Falls back to API if cache miss occurs.
+     *
+     * Triggers on:
+     * - debouncedQuery change (search)
+     * - currentPage change (pagination)
+     * - pageLimit change (items per page)
+     *
+     * Implementation:
+     * - Fetches from cache asynchronously
+     * - Applies client-side search filtering
+     * - Slices data for client-side pagination
+     * - Updates count for pagination controls
+     * - Handles errors with toast notifications
+     */
     (0, react_1.useEffect)(function () {
-        listFetchNow();
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [debouncedQuery, state.currentPage, state.pageLimit]);
+        (function () { return __awaiter(void 0, void 0, void 0, function () {
+            var _a, count, items, error_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, (0, cache_1.getCachedCurrencies)({
+                                params: listParams,
+                            })];
+                    case 1:
+                        _a = _b.sent(), count = _a.count, items = _a.items;
+                        dispatch({
+                            type: actions_1.CURRENCY_ACTION_TYPES.SET_CURRENCIES,
+                            payload: { currencies: items },
+                        });
+                        dispatch({
+                            type: actions_1.CURRENCY_ACTION_TYPES.SET_COUNT,
+                            payload: { count: count },
+                        });
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_1 = _b.sent();
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        }); })();
+    }, [listParams]);
     // ---------------------------------------------------------------------------
     // DRAWER & MODAL HANDLERS
     // ---------------------------------------------------------------------------

package/global-modules/payment-mode/cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Payment Mode Module Cache Utilities
+ *
+ * Provides localStorage-based caching for payment modes using generic cache system.
+ */
+import { PaymentModeTypeBE } from "./types";
+export declare const getCachedPaymentModesSync: () => {
+    count: number;
+    items: PaymentModeTypeBE[];
+};
+export declare const getCachedPaymentModes: ({ params, }?: {
+    params?: Record<string, unknown>;
+}) => Promise<{
+    count: number;
+    items: PaymentModeTypeBE[];
+}>;
+export declare const getCachedPaymentModeById: (paymentModeId: string) => PaymentModeTypeBE | null;
+export declare const invalidatePaymentModesCache: () => void;
+export declare const preloadPaymentModes: () => Promise<{
+    count: number;
+    items: PaymentModeTypeBE[];
+}>;
+export declare const isPaymentModesCacheStale: () => boolean;