@react-pakistan/util-functions 1.25.9 → 1.25.10

package/api/stellar-solutions/tax/cache.d.ts

@@ -1,102 +0,0 @@
-import { TaxBE } from '../type';
-/**
- * Synchronous utility function to get taxes from cache only
- * Returns cached data immediately if available and fresh, otherwise returns empty array
- * Does not trigger any API calls
- *
- * @returns TaxBE[] - Array of cached taxes or empty array wrapper ({count, items})
- *
- * @example
- * const taxes = getCachedTaxesSync();
- * if (taxes.items.length > 0) {
- *   console.log(taxes.items[0].taxName);
- * }
- */
-export declare const getCachedTaxesSync: () => {
-    count: number;
-    items: TaxBE[];
-};
-/**
- * Utility function to get taxes from cache or fetch from API
- *
- * This function manages a localStorage cache of taxes with the following logic:
- * - If taxes exist in cache and are less than 1 week old, return cached version
- * - If taxes exist but are older than 1 week, fetch fresh data and update cache
- * - If taxes don't exist in cache, fetch from API and cache them
- *
- * @param searchQuery - Optional search query to filter taxes
- * @param pageLimit - Number of taxes to fetch (default: 100)
- * @returns Promise<{count:number, items: TaxBE[]}> - Paged taxes
- *
- * @example
- * const taxes = await getCachedTaxes();
- * console.log(taxes.items[0].taxName);
- *
- * // With search
- * const filtered = await getCachedTaxes('VAT');
- */
-export declare const getCachedTaxes: (searchQuery?: string, pageLimit?: number) => Promise<{
-    count: number;
-    items: TaxBE[];
-}>;
-/**
- * Utility function to get a specific tax by ID from cache
- * If not found in cache, returns null (does not trigger API call)
- *
- * @param taxId - The ID of the tax to retrieve
- * @returns TaxBE | null - The tax or null if not found
- *
- * @example
- * const tax = getCachedTaxById('tax-123');
- * if (tax) {
- *   console.log(tax.taxName);
- * }
- */
-export declare const getCachedTaxById: (taxId: string) => TaxBE | null;
-/**
- * Utility function to get taxes by name from cache
- * If not found in cache, returns empty array (does not trigger API call)
- *
- * @param taxName - The name of the tax to search for
- * @returns TaxBE[] - Array of matching taxes or empty array
- *
- * @example
- * const taxes = getCachedTaxesByName('VAT');
- * console.log(taxes.length);
- */
-export declare const getCachedTaxesByName: (taxName: string) => TaxBE[];
-/**
- * Utility function to invalidate (remove) taxes from cache
- * Useful when taxes have been updated and you want to force a refresh
- *
- * @example
- * invalidateTaxesCache();
- * const freshTaxes = await getCachedTaxes();
- */
-export declare const invalidateTaxesCache: () => void;
-/**
- * Utility function to preload taxes into cache
- * Useful to call on app initialization or login
- *
- * @returns Promise<{count:number, items: TaxBE[]}> - Array of preloaded taxes
- *
- * @example
- * // On app initialization
- * await preloadTaxes();
- */
-export declare const preloadTaxes: () => Promise<{
-    count: number;
-    items: TaxBE[];
-}>;
-/**
- * Utility function to check if taxes cache is stale
- * Returns true if cache is older than 1 week or doesn't exist
- *
- * @returns boolean - True if cache is stale or doesn't exist
- *
- * @example
- * if (isTaxesCacheStale()) {
- *   await getCachedTaxes(); // This will fetch fresh data
- * }
- */
-export declare const isTaxesCacheStale: () => boolean;

package/api/stellar-solutions/tax/cache.js

@@ -1,296 +1,235 @@
-"use strict";
-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 };
-    }
-};
-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.isTaxesCacheStale = exports.preloadTaxes = exports.invalidateTaxesCache = exports.getCachedTaxesByName = exports.getCachedTaxById = exports.getCachedTaxes = exports.getCachedTaxesSync = void 0;
-var constants_1 = require("../constants");
-var type_1 = require("../type");
-var api_methods_1 = require("../../../constants/api-methods");
-var fetch_data_1 = require("../../../general/fetch-data");
-var get_storage_value_1 = require("../../../local-storage/get-storage-value");
-var set_storage_value_1 = require("../../../local-storage/set-storage-value");
-var constants_2 = require("../../../constants");
-/**
- * Synchronous utility function to get taxes from cache only
- * Returns cached data immediately if available and fresh, otherwise returns empty array
- * Does not trigger any API calls
- *
- * @returns TaxBE[] - Array of cached taxes or empty array wrapper ({count, items})
- *
- * @example
- * const taxes = getCachedTaxesSync();
- * if (taxes.items.length > 0) {
- *   console.log(taxes.items[0].taxName);
- * }
- */
-var getCachedTaxesSync = function () {
-    try {
-        var cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.TAXES);
-        if (!cachedData) {
-            return { count: 0, items: [] };
-        }
-        var currentTime = new Date().getTime();
-        var cachedTime = new Date(cachedData.cachedAt).getTime();
-        var ageInMs = currentTime - cachedTime;
-        // If cached data is less than 1 week old, return it
-        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
-            return {
-                count: cachedData.taxes.length,
-                items: cachedData.taxes,
-            };
-        }
-        return { count: 0, items: [] };
-    }
-    catch (error) {
-        console.error('Error getting cached taxes:', error);
-        return { count: 0, items: [] };
-    }
-};
-exports.getCachedTaxesSync = getCachedTaxesSync;
-/**
- * Utility function to get taxes from cache or fetch from API
- *
- * This function manages a localStorage cache of taxes with the following logic:
- * - If taxes exist in cache and are less than 1 week old, return cached version
- * - If taxes exist but are older than 1 week, fetch fresh data and update cache
- * - If taxes don't exist in cache, fetch from API and cache them
- *
- * @param searchQuery - Optional search query to filter taxes
- * @param pageLimit - Number of taxes to fetch (default: 100)
- * @returns Promise<{count:number, items: TaxBE[]}> - Paged taxes
- *
- * @example
- * const taxes = await getCachedTaxes();
- * console.log(taxes.items[0].taxName);
- *
- * // With search
- * const filtered = await getCachedTaxes('VAT');
- */
-var getCachedTaxes = function (searchQuery_1) {
-    var args_1 = [];
-    for (var _i = 1; _i < arguments.length; _i++) {
-        args_1[_i - 1] = arguments[_i];
-    }
-    return __awaiter(void 0, __spreadArray([searchQuery_1], args_1, true), void 0, function (searchQuery, pageLimit) {
-        var response_1, cachedData, currentTime, cachedTime, ageInMs, response, updatedCache, error_1;
-        var _a;
-        if (pageLimit === void 0) { pageLimit = 100; }
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0:
-                    _b.trys.push([0, 4, , 5]);
-                    if (!(searchQuery && searchQuery.trim())) return [3 /*break*/, 2];
-                    return [4 /*yield*/, (0, fetch_data_1.fetchData)({
-                            url: constants_1.API_ROUTES.TAXES,
-                            body: JSON.stringify({
-                                searchQuery: searchQuery,
-                                pageLimit: pageLimit,
-                                currentPage: 1,
-                            }),
-                            method: api_methods_1.API_METHODS.POST,
-                        })];
-                case 1:
-                    response_1 = _b.sent();
-                    return [2 /*return*/, (response_1 === null || response_1 === void 0 ? void 0 : response_1.data) || { count: 0, items: [] }];
-                case 2:
-                    cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.TAXES);
-                    currentTime = new Date().getTime();
-                    // Check if cached data exists and is still fresh
-                    if (cachedData) {
-                        cachedTime = new Date(cachedData.cachedAt).getTime();
-                        ageInMs = currentTime - cachedTime;
-                        // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
-                            return [2 /*return*/, {
-                                    count: cachedData.taxes.length,
-                                    items: cachedData.taxes,
-                                }];
-                        }
-                    }
-                    return [4 /*yield*/, (0, fetch_data_1.fetchData)({
-                            url: constants_1.API_ROUTES.TAXES,
-                            body: JSON.stringify({
-                                pageLimit: pageLimit,
-                                currentPage: 1,
-                            }),
-                            method: api_methods_1.API_METHODS.POST,
-                        })];
-                case 3:
-                    response = _b.sent();
-                    if ((_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.items) {
-                        updatedCache = {
-                            taxes: response.data.items,
-                            cachedAt: new Date().toISOString(),
-                        };
-                        (0, set_storage_value_1.setStorageValue)(type_1.LS_KEYS.TAXES, updatedCache);
-                        return [2 /*return*/, response.data];
-                    }
-                    return [2 /*return*/, { count: 0, items: [] }];
-                case 4:
-                    error_1 = _b.sent();
-                    console.error('Error fetching taxes:', error_1);
-                    return [2 /*return*/, { count: 0, items: [] }];
-                case 5: return [2 /*return*/];
-            }
-        });
-    });
-};
-exports.getCachedTaxes = getCachedTaxes;
-/**
- * Utility function to get a specific tax by ID from cache
- * If not found in cache, returns null (does not trigger API call)
- *
- * @param taxId - The ID of the tax to retrieve
- * @returns TaxBE | null - The tax or null if not found
- *
- * @example
- * const tax = getCachedTaxById('tax-123');
- * if (tax) {
- *   console.log(tax.taxName);
- * }
- */
-var getCachedTaxById = function (taxId) {
-    if (!taxId) {
-        return null;
-    }
-    try {
-        var taxes = (0, exports.getCachedTaxesSync)().items;
-        return taxes.find(function (tax) { return tax.id === taxId; }) || null;
-    }
-    catch (error) {
-        console.error('Error getting cached tax by ID:', error);
-        return null;
-    }
-};
-exports.getCachedTaxById = getCachedTaxById;
-/**
- * Utility function to get taxes by name from cache
- * If not found in cache, returns empty array (does not trigger API call)
- *
- * @param taxName - The name of the tax to search for
- * @returns TaxBE[] - Array of matching taxes or empty array
- *
- * @example
- * const taxes = getCachedTaxesByName('VAT');
- * console.log(taxes.length);
- */
-var getCachedTaxesByName = function (taxName) {
-    if (!taxName) {
-        return [];
-    }
-    try {
-        var taxes = (0, exports.getCachedTaxesSync)().items;
-        return taxes.filter(function (tax) {
-            return tax.taxName.toLowerCase().includes(taxName.toLowerCase());
-        });
-    }
-    catch (error) {
-        console.error('Error getting cached taxes by name:', error);
-        return [];
-    }
-};
-exports.getCachedTaxesByName = getCachedTaxesByName;
-/**
- * Utility function to invalidate (remove) taxes from cache
- * Useful when taxes have been updated and you want to force a refresh
- *
- * @example
- * invalidateTaxesCache();
- * const freshTaxes = await getCachedTaxes();
- */
-var invalidateTaxesCache = function () {
-    try {
-        localStorage.removeItem(type_1.LS_KEYS.TAXES);
-    }
-    catch (error) {
-        console.error('Error invalidating taxes cache:', error);
-    }
-};
-exports.invalidateTaxesCache = invalidateTaxesCache;
-/**
- * Utility function to preload taxes into cache
- * Useful to call on app initialization or login
- *
- * @returns Promise<{count:number, items: TaxBE[]}> - Array of preloaded taxes
- *
- * @example
- * // On app initialization
- * await preloadTaxes();
- */
-var preloadTaxes = function () { return __awaiter(void 0, void 0, void 0, function () {
-    return __generator(this, function (_a) {
-        return [2 /*return*/, (0, exports.getCachedTaxes)()];
-    });
-}); };
-exports.preloadTaxes = preloadTaxes;
-/**
- * Utility function to check if taxes cache is stale
- * Returns true if cache is older than 1 week or doesn't exist
- *
- * @returns boolean - True if cache is stale or doesn't exist
- *
- * @example
- * if (isTaxesCacheStale()) {
- *   await getCachedTaxes(); // This will fetch fresh data
- * }
- */
-var isTaxesCacheStale = function () {
-    try {
-        var cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.TAXES);
-        if (!cachedData) {
-            return true;
-        }
-        var currentTime = new Date().getTime();
-        var cachedTime = new Date(cachedData.cachedAt).getTime();
-        var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
-    }
-    catch (error) {
-        console.error('Error checking taxes cache staleness:', error);
-        return true;
-    }
-};
-exports.isTaxesCacheStale = isTaxesCacheStale;
+// import { API_ROUTES } from '../constants';
+// import { TaxBE, LS_KEYS } from '../type';
+// import { API_METHODS } from '../../../constants/api-methods';
+// import { fetchData } from '../../../general/fetch-data';
+// import { getStorageValue } from '../../../local-storage/get-storage-value';
+// import { setStorageValue } from '../../../local-storage/set-storage-value';
+// import { ONE_WEEK_IN_MS } from '../../../constants';
+// interface CachedTaxes {
+//   taxes: TaxBE[];
+//   cachedAt: string;
+// }
+// /**
+//  * Synchronous utility function to get taxes from cache only
+//  * Returns cached data immediately if available and fresh, otherwise returns empty array
+//  * Does not trigger any API calls
+//  *
+//  * @returns TaxBE[] - Array of cached taxes or empty array wrapper ({count, items})
+//  *
+//  * @example
+//  * const taxes = getCachedTaxesSync();
+//  * if (taxes.items.length > 0) {
+//  *   console.log(taxes.items[0].taxName);
+//  * }
+//  */
+// export const getCachedTaxesSync = (): {
+//   count: number;
+//   items: TaxBE[];
+// } => {
+//   try {
+//     const cachedData = getStorageValue(LS_KEYS.TAXES) as CachedTaxes | null;
+//     if (!cachedData) {
+//       return { count: 0, items: [] };
+//     }
+//     const currentTime = new Date().getTime();
+//     const cachedTime = new Date(cachedData.cachedAt).getTime();
+//     const ageInMs = currentTime - cachedTime;
+//     // If cached data is less than 1 week old, return it
+//     if (ageInMs < ONE_WEEK_IN_MS) {
+//       return {
+//         count: cachedData.taxes.length,
+//         items: cachedData.taxes,
+//       };
+//     }
+//     return { count: 0, items: [] };
+//   } catch (error) {
+//     console.error('Error getting cached taxes:', error);
+//     return { count: 0, items: [] };
+//   }
+// };
+// /**
+//  * Utility function to get taxes from cache or fetch from API
+//  *
+//  * This function manages a localStorage cache of taxes with the following logic:
+//  * - If taxes exist in cache and are less than 1 week old, return cached version
+//  * - If taxes exist but are older than 1 week, fetch fresh data and update cache
+//  * - If taxes don't exist in cache, fetch from API and cache them
+//  *
+//  * @param searchQuery - Optional search query to filter taxes
+//  * @param pageLimit - Number of taxes to fetch (default: 100)
+//  * @returns Promise<{count:number, items: TaxBE[]}> - Paged taxes
+//  *
+//  * @example
+//  * const taxes = await getCachedTaxes();
+//  * console.log(taxes.items[0].taxName);
+//  *
+//  * // With search
+//  * const filtered = await getCachedTaxes('VAT');
+//  */
+// export const getCachedTaxes = async (
+//   searchQuery?: string,
+//   pageLimit: number = 100
+// ): Promise<{
+//   count: number;
+//   items: TaxBE[];
+// }> => {
+//   try {
+//     // If there's a search query, always fetch fresh data (don't use cache)
+//     if (searchQuery && searchQuery.trim()) {
+//       const response = await fetchData({
+//         url: API_ROUTES.TAXES,
+//         body: JSON.stringify({
+//           searchQuery,
+//           pageLimit,
+//           currentPage: 1,
+//         }),
+//         method: API_METHODS.POST,
+//       });
+//       return response?.data || { count: 0, items: [] };
+//     }
+//     // Get the cached data from localStorage
+//     const cachedData = getStorageValue(LS_KEYS.TAXES) as CachedTaxes | null;
+//     const currentTime = new Date().getTime();
+//     // Check if cached data exists and is still fresh
+//     if (cachedData) {
+//       const cachedTime = new Date(cachedData.cachedAt).getTime();
+//       const ageInMs = currentTime - cachedTime;
+//       // If cached data is less than 1 week old, return it
+//       if (ageInMs < ONE_WEEK_IN_MS) {
+//         return {
+//           count: cachedData.taxes.length,
+//           items: cachedData.taxes,
+//         };
+//       }
+//     }
+//     // If no cached data or data is older than 1 week, fetch fresh data
+//     const response = await fetchData({
+//       url: API_ROUTES.TAXES,
+//       body: JSON.stringify({
+//         pageLimit,
+//         currentPage: 1,
+//       }),
+//       method: API_METHODS.POST,
+//     });
+//     if (response?.data?.items) {
+//       // Update the cache with fresh data
+//       const updatedCache: CachedTaxes = {
+//         taxes: response.data.items,
+//         cachedAt: new Date().toISOString(),
+//       };
+//       setStorageValue(LS_KEYS.TAXES, updatedCache);
+//       return response.data;
+//     }
+//     return { count: 0, items: [] };
+//   } catch (error) {
+//     console.error('Error fetching taxes:', error);
+//     return { count: 0, items: [] };
+//   }
+// };
+// /**
+//  * Utility function to get a specific tax by ID from cache
+//  * If not found in cache, returns null (does not trigger API call)
+//  *
+//  * @param taxId - The ID of the tax to retrieve
+//  * @returns TaxBE | null - The tax or null if not found
+//  *
+//  * @example
+//  * const tax = getCachedTaxById('tax-123');
+//  * if (tax) {
+//  *   console.log(tax.taxName);
+//  * }
+//  */
+// export const getCachedTaxById = (taxId: string): TaxBE | null => {
+//   if (!taxId) {
+//     return null;
+//   }
+//   try {
+//     const taxes = getCachedTaxesSync().items;
+//     return taxes.find((tax) => tax.id === taxId) || null;
+//   } catch (error) {
+//     console.error('Error getting cached tax by ID:', error);
+//     return null;
+//   }
+// };
+// /**
+//  * Utility function to get taxes by name from cache
+//  * If not found in cache, returns empty array (does not trigger API call)
+//  *
+//  * @param taxName - The name of the tax to search for
+//  * @returns TaxBE[] - Array of matching taxes or empty array
+//  *
+//  * @example
+//  * const taxes = getCachedTaxesByName('VAT');
+//  * console.log(taxes.length);
+//  */
+// export const getCachedTaxesByName = (taxName: string): TaxBE[] => {
+//   if (!taxName) {
+//     return [];
+//   }
+//   try {
+//     const taxes = getCachedTaxesSync().items;
+//     return taxes.filter((tax) =>
+//       tax.taxName.toLowerCase().includes(taxName.toLowerCase())
+//     );
+//   } catch (error) {
+//     console.error('Error getting cached taxes by name:', error);
+//     return [];
+//   }
+// };
+// /**
+//  * Utility function to invalidate (remove) taxes from cache
+//  * Useful when taxes have been updated and you want to force a refresh
+//  *
+//  * @example
+//  * invalidateTaxesCache();
+//  * const freshTaxes = await getCachedTaxes();
+//  */
+// export const invalidateTaxesCache = (): void => {
+//   try {
+//     localStorage.removeItem(LS_KEYS.TAXES);
+//   } catch (error) {
+//     console.error('Error invalidating taxes cache:', error);
+//   }
+// };
+// /**
+//  * Utility function to preload taxes into cache
+//  * Useful to call on app initialization or login
+//  *
+//  * @returns Promise<{count:number, items: TaxBE[]}> - Array of preloaded taxes
+//  *
+//  * @example
+//  * // On app initialization
+//  * await preloadTaxes();
+//  */
+// export const preloadTaxes = async (): Promise<{
+//   count: number;
+//   items: TaxBE[];
+// }> => {
+//   return getCachedTaxes();
+// };
+// /**
+//  * Utility function to check if taxes cache is stale
+//  * Returns true if cache is older than 1 week or doesn't exist
+//  *
+//  * @returns boolean - True if cache is stale or doesn't exist
+//  *
+//  * @example
+//  * if (isTaxesCacheStale()) {
+//  *   await getCachedTaxes(); // This will fetch fresh data
+//  * }
+//  */
+// export const isTaxesCacheStale = (): boolean => {
+//   try {
+//     const cachedData = getStorageValue(LS_KEYS.TAXES) as CachedTaxes | null;
+//     if (!cachedData) {
+//       return true;
+//     }
+//     const currentTime = new Date().getTime();
+//     const cachedTime = new Date(cachedData.cachedAt).getTime();
+//     const ageInMs = currentTime - cachedTime;
+//     return ageInMs >= ONE_WEEK_IN_MS;
+//   } catch (error) {
+//     console.error('Error checking taxes cache staleness:', error);
+//     return true;
+//   }
+// };