@react-pakistan/util-functions 1.25.7 → 1.25.9

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

@@ -52,6 +52,7 @@ 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 banks from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -75,7 +76,7 @@ var getCachedBanksSync = function () {
         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_1.ONE_WEEK_IN_MS) {
+        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
             return {
                 count: cachedData.banks.length,
                 items: cachedData.banks,
@@ -142,7 +143,7 @@ var getCachedBanks = function (searchQuery_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.banks.length,
                                     items: cachedData.banks,
@@ -285,7 +286,7 @@ var isBanksCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_WEEK_IN_MS;
+        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
     }
     catch (error) {
         console.error('Error checking banks cache staleness:', error);

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

@@ -52,6 +52,7 @@ 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 branches from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -75,7 +76,7 @@ var getCachedBranchesSync = function () {
         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_1.ONE_WEEK_IN_MS) {
+        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
             return {
                 count: cachedData.branches.length,
                 items: cachedData.branches,
@@ -142,7 +143,7 @@ var getCachedBranches = function (searchQuery_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.branches.length,
                                     items: cachedData.branches,
@@ -285,7 +286,7 @@ var isBranchesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_WEEK_IN_MS;
+        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
     }
     catch (error) {
         console.error('Error checking branches cache staleness:', error);

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

@@ -63,6 +63,7 @@ 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 companies from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedCompaniesSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.companies.length,
                 items: cachedData.companies,
@@ -154,7 +155,7 @@ var getCachedCompanies = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 day old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.companies.length,
                                     items: cachedData.companies,
@@ -297,7 +298,7 @@ var isCompaniesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking companies cache staleness:', error);

package/api/stellar-solutions/constants.d.ts

@@ -1,5 +1,3 @@
-export declare const ONE_DAY_IN_MS: number;
-export declare const ONE_WEEK_IN_MS: number;
 export declare const API_ROUTES: {
     BANKS: string;
     BRANCHES: string;

package/api/stellar-solutions/constants.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.API_ROUTES = exports.ONE_WEEK_IN_MS = exports.ONE_DAY_IN_MS = void 0;
-exports.ONE_DAY_IN_MS = 1 * 24 * 60 * 60 * 1000; // 1 day in milliseconds
-exports.ONE_WEEK_IN_MS = 7 * 24 * 60 * 60 * 1000; // 1 week in milliseconds
+exports.API_ROUTES = void 0;
 exports.API_ROUTES = {
     BANKS: '/api/banks',
     BRANCHES: '/api/branches',

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

@@ -63,6 +63,7 @@ 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 contacts from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedContactsSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.contacts.length,
                 items: cachedData.contacts,
@@ -154,7 +155,7 @@ var getCachedContacts = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 day old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.contacts.length,
                                     items: cachedData.contacts,
@@ -297,7 +298,7 @@ var isContactsCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking contacts cache staleness:', error);

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

@@ -52,6 +52,7 @@ 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 currencies from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -75,7 +76,7 @@ var getCachedCurrenciesSync = function () {
         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_1.ONE_WEEK_IN_MS) {
+        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
             return {
                 count: cachedData.currencies.length,
                 items: cachedData.currencies,
@@ -142,7 +143,7 @@ var getCachedCurrencies = function (searchQuery_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.currencies.length,
                                     items: cachedData.currencies,
@@ -285,7 +286,7 @@ var isCurrenciesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_WEEK_IN_MS;
+        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
     }
     catch (error) {
         console.error('Error checking currencies cache staleness:', error);

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

@@ -63,6 +63,7 @@ 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 customers from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedCustomersSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.customers.length,
                 items: cachedData.customers,
@@ -154,7 +155,7 @@ var getCachedCustomers = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 day old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.customers.length,
                                     items: cachedData.customers,
@@ -297,7 +298,7 @@ var isCustomersCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking customers cache staleness:', error);

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

@@ -63,6 +63,7 @@ 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 expenses from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedExpensesSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.expenses.length,
                 items: cachedData.expenses,
@@ -154,7 +155,7 @@ var getCachedExpenses = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 day old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.expenses.length,
                                     items: cachedData.expenses,
@@ -297,7 +298,7 @@ var isExpensesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking expenses cache staleness:', error);

package/api/stellar-solutions/expense-category/cache.js

@@ -63,6 +63,7 @@ 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 expense categories from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedExpenseCategoriesSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.expenseCategories.length,
                 items: cachedData.expenseCategories,
@@ -154,7 +155,7 @@ var getCachedExpenseCategories = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 day old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.expenseCategories.length,
                                     items: cachedData.expenseCategories,
@@ -270,7 +271,7 @@ var isExpenseCategoriesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking expense categories cache staleness:', error);

package/api/stellar-solutions/payment-mode/cache.js

@@ -52,6 +52,7 @@ 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 payment modes from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -75,7 +76,7 @@ var getCachedPaymentModesSync = function () {
         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_1.ONE_WEEK_IN_MS) {
+        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
             return {
                 count: cachedData.paymentModes.length,
                 items: cachedData.paymentModes,
@@ -142,7 +143,7 @@ var getCachedPaymentModes = function (searchQuery_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.paymentModes.length,
                                     items: cachedData.paymentModes,
@@ -285,7 +286,7 @@ var isPaymentModesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_WEEK_IN_MS;
+        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
     }
     catch (error) {
         console.error('Error checking payment modes cache staleness:', error);

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

@@ -52,6 +52,7 @@ 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 preferences from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -75,7 +76,7 @@ var getCachedPreferencesSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
             return {
                 count: cachedData.preferences.length,
                 items: cachedData.preferences,
@@ -142,7 +143,7 @@ var getCachedPreferences = function (searchQuery_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.preferences.length,
                                     items: cachedData.preferences,
@@ -258,7 +259,7 @@ var isPreferencesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_WEEK_IN_MS;
+        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
     }
     catch (error) {
         console.error('Error checking preferences cache staleness:', error);

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

@@ -63,6 +63,7 @@ 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 products from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedProductsSync = function () {
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
         // If cached data is less than 1 day old, return it
-        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.products.length,
                 items: cachedData.products,
@@ -154,7 +155,7 @@ var getCachedProducts = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 day old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.products.length,
                                     items: cachedData.products,
@@ -270,7 +271,7 @@ var isProductsCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking products cache staleness:', error);

package/api/stellar-solutions/product-category/cache.js

@@ -63,6 +63,7 @@ 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 product categories from cache only
  * Returns cached data immediately if available and fresh, otherwise returns empty array
@@ -86,7 +87,7 @@ var getCachedProductCategoriesSync = function () {
         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_1.ONE_DAY_IN_MS) {
+        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
             return {
                 count: cachedData.productCategories.length,
                 items: cachedData.productCategories,
@@ -154,7 +155,7 @@ var getCachedProductCategories = function (searchQuery_1, filters_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                        if (ageInMs < constants_2.ONE_DAY_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.productCategories.length,
                                     items: cachedData.productCategories,
@@ -270,7 +271,7 @@ var isProductCategoriesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+        return ageInMs >= constants_2.ONE_DAY_IN_MS;
     }
     catch (error) {
         console.error('Error checking product categories cache staleness:', error);

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

@@ -52,6 +52,7 @@ 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
@@ -75,7 +76,7 @@ var getCachedTaxesSync = function () {
         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_1.ONE_WEEK_IN_MS) {
+        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
             return {
                 count: cachedData.taxes.length,
                 items: cachedData.taxes,
@@ -142,7 +143,7 @@ var getCachedTaxes = function (searchQuery_1) {
                         cachedTime = new Date(cachedData.cachedAt).getTime();
                         ageInMs = currentTime - cachedTime;
                         // If cached data is less than 1 week old, return it
-                        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        if (ageInMs < constants_2.ONE_WEEK_IN_MS) {
                             return [2 /*return*/, {
                                     count: cachedData.taxes.length,
                                     items: cachedData.taxes,
@@ -285,7 +286,7 @@ var isTaxesCacheStale = function () {
         var currentTime = new Date().getTime();
         var cachedTime = new Date(cachedData.cachedAt).getTime();
         var ageInMs = currentTime - cachedTime;
-        return ageInMs >= constants_1.ONE_WEEK_IN_MS;
+        return ageInMs >= constants_2.ONE_WEEK_IN_MS;
     }
     catch (error) {
         console.error('Error checking taxes cache staleness:', error);

package/constants/cache-time.d.ts

@@ -0,0 +1,3 @@
+export declare const ONE_DAY_IN_MS: number;
+export declare const ONE_WEEK_IN_MS: number;
+export declare const ONE_MONTH_IN_MS: number;

package/constants/cache-time.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ONE_MONTH_IN_MS = exports.ONE_WEEK_IN_MS = exports.ONE_DAY_IN_MS = void 0;
+exports.ONE_DAY_IN_MS = 1 * 24 * 60 * 60 * 1000; // 1 day in milliseconds
+exports.ONE_WEEK_IN_MS = 7 * 24 * 60 * 60 * 1000; // 1 week in milliseconds
+exports.ONE_MONTH_IN_MS = 30 * 24 * 60 * 60 * 1000; // 1 month in milliseconds

package/constants/index.d.ts

@@ -1,9 +1,10 @@
 export * from './api-methods';
+export * from './cache-time';
 export * from './countries-timezones';
 export * from './currencies';
 export * from './layout-direction';
-export * from './react-pakistan';
 export * from './react-pakistan-meta';
+export * from './react-pakistan';
 export * from './select-value-delimiter';
 export * from './social-media-colors';
 export * from './social-media-sizes';

package/constants/index.js

@@ -15,11 +15,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./api-methods"), exports);
+__exportStar(require("./cache-time"), exports);
 __exportStar(require("./countries-timezones"), exports);
 __exportStar(require("./currencies"), exports);
 __exportStar(require("./layout-direction"), exports);
-__exportStar(require("./react-pakistan"), exports);
 __exportStar(require("./react-pakistan-meta"), exports);
+__exportStar(require("./react-pakistan"), exports);
 __exportStar(require("./select-value-delimiter"), exports);
 __exportStar(require("./social-media-colors"), exports);
 __exportStar(require("./social-media-sizes"), exports);

package/general/generic-cache.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Generic Cache Utilities
+ *
+ * Provides reusable localStorage-based caching for all modules with:
+ * - 1-day cache expiration
+ * - Automatic cache invalidation
+ * - Search and filter bypass (always fetch fresh)
+ * - Synchronous and asynchronous access patterns
+ * - Support for both list and single item caching
+ *
+ * Organization:
+ * - Types
+ * - List Cache Functions
+ * - Single Item Cache Functions
+ * - Cache Utilities
+ */
+interface CacheConfig {
+    cacheKey: string;
+    apiUrl: string;
+    expirationMs?: number;
+    responseKey?: string;
+}
+interface ListResponse<T> {
+    count: number;
+    items: T[];
+}
+/**
+ * Get synchronous cached data for a module
+ * Returns empty result if cache is missing or stale
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns {count: number, items: T[]} - Cached data or empty array
+ *
+ * @example
+ * const users = getCachedDataSync<UserBE>(LS_KEYS.USERS);
+ * if (users.items.length > 0) {
+ *   console.log(users.items[0].name);
+ * }
+ */
+export declare const getCachedDataSync: <T>(cacheKey: string, expirationMs?: number) => ListResponse<T>;
+/**
+ * Get cached data with API fallback for a module
+ * Automatically handles cache validation and updates
+ *
+ * @param config - Cache configuration (cacheKey, apiUrl, expirationMs, responseKey)
+ * @param searchQuery - Optional search query (bypasses cache)
+ * @param filters - Optional filters object (bypasses cache)
+ * @param pageLimit - Number of items to fetch (default: 100)
+ * @returns Promise<{count: number, items: T[]}> - Cached or fresh data
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
+ * const users = await getCachedData<UserBE>(config);
+ *
+ * // With search (bypasses cache)
+ * const filtered = await getCachedData<UserBE>(config, 'John');
+ *
+ * // With filters (bypasses cache)
+ * const active = await getCachedData<UserBE>(config, undefined, { enabled: true });
+ */
+export declare const getCachedData: <T>(config: CacheConfig, searchQuery?: string, filters?: Record<string, unknown>, pageLimit?: number) => Promise<ListResponse<T>>;
+/**
+ * Get single cached item by ID from a list cache
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param itemId - ID of the item to retrieve
+ * @returns T | null - Cached item or null
+ *
+ * @example
+ * const user = getCachedItemById<UserBE>(LS_KEYS.USERS, 'user-123');
+ * if (user) {
+ *   console.log(user.name);
+ * }
+ */
+export declare const getCachedItemById: <T extends {
+    id: string;
+}>(cacheKey: string, itemId: string) => T | null;
+/**
+ * Get synchronous cached single item
+ * Returns null if cache is missing or stale
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns T | null - Cached item or null
+ *
+ * @example
+ * const workspace = getCachedSingleItemSync<WorkspaceBE>(LS_KEYS.WORKSPACE);
+ * if (workspace) {
+ *   console.log(workspace.name);
+ * }
+ */
+export declare const getCachedSingleItemSync: <T>(cacheKey: string, expirationMs?: number) => T | null;
+/**
+ * Get cached single item with API fallback
+ * Useful for workspace, profile, settings, etc.
+ *
+ * @param config - Cache configuration (cacheKey, apiUrl, expirationMs, responseKey)
+ * @param params - Optional query parameters for API request
+ * @returns Promise<T | null> - Cached or fresh item
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.WORKSPACE, apiUrl: '/api/workspace', responseKey: 'workspace' };
+ * const workspace = await getCachedSingleItem<WorkspaceBE>(config, { subdomain: 'school1' });
+ */
+export declare const getCachedSingleItem: <T>(config: CacheConfig, params?: Record<string, string>) => Promise<T | null>;
+/**
+ * Invalidate (remove) cache for a module
+ * Useful after create/update/delete operations
+ *
+ * @param cacheKey - localStorage key for the cache
+ *
+ * @example
+ * invalidateCache(LS_KEYS.USERS);
+ * const freshUsers = await getCachedData(config);
+ */
+export declare const invalidateCache: (cacheKey: string) => void;
+/**
+ * Preload cache for a module
+ * Useful to call on app initialization or login
+ *
+ * @param config - Cache configuration
+ * @returns Promise<ListResponse<T>> - Preloaded data
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
+ * await preloadCache(config);
+ */
+export declare const preloadCache: <T>(config: CacheConfig) => Promise<ListResponse<T>>;
+/**
+ * Check if cache is stale (older than expiration time)
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns boolean - True if cache is stale or doesn't exist
+ *
+ * @example
+ * if (isCacheStale(LS_KEYS.USERS)) {
+ *   await getCachedData(config); // This will fetch fresh data
+ * }
+ */
+export declare const isCacheStale: (cacheKey: string, expirationMs?: number) => boolean;
+export {};

package/general/generic-cache.js

@@ -0,0 +1,411 @@
+"use strict";
+/**
+ * Generic Cache Utilities
+ *
+ * Provides reusable localStorage-based caching for all modules with:
+ * - 1-day cache expiration
+ * - Automatic cache invalidation
+ * - Search and filter bypass (always fetch fresh)
+ * - Synchronous and asynchronous access patterns
+ * - Support for both list and single item caching
+ *
+ * Organization:
+ * - Types
+ * - List Cache Functions
+ * - Single Item Cache Functions
+ * - Cache Utilities
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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.isCacheStale = exports.preloadCache = exports.invalidateCache = exports.getCachedSingleItem = exports.getCachedSingleItemSync = exports.getCachedItemById = exports.getCachedData = exports.getCachedDataSync = void 0;
+var constants_1 = require("../constants");
+var fetch_data_1 = require("./fetch-data");
+var local_storage_1 = require("../local-storage");
+// ============================================================================
+// LIST CACHE FUNCTIONS
+// ============================================================================
+/**
+ * Get synchronous cached data for a module
+ * Returns empty result if cache is missing or stale
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns {count: number, items: T[]} - Cached data or empty array
+ *
+ * @example
+ * const users = getCachedDataSync<UserBE>(LS_KEYS.USERS);
+ * if (users.items.length > 0) {
+ *   console.log(users.items[0].name);
+ * }
+ */
+var getCachedDataSync = function (cacheKey, expirationMs) {
+    if (expirationMs === void 0) { expirationMs = constants_1.ONE_DAY_IN_MS; }
+    try {
+        var cachedData = (0, local_storage_1.getStorageValue)(cacheKey);
+        if (!cachedData) {
+            return { count: 0, items: [] };
+        }
+        var currentTime = new Date().getTime();
+        var cachedTime = new Date(cachedData.cachedAt).getTime();
+        var ageInMs = currentTime - cachedTime;
+        if (ageInMs < expirationMs) {
+            return {
+                count: cachedData.items.length,
+                items: cachedData.items,
+            };
+        }
+        return { count: 0, items: [] };
+    }
+    catch (error) {
+        console.error("Error getting cached data for ".concat(cacheKey, ":"), error);
+        return { count: 0, items: [] };
+    }
+};
+exports.getCachedDataSync = getCachedDataSync;
+/**
+ * Get cached data with API fallback for a module
+ * Automatically handles cache validation and updates
+ *
+ * @param config - Cache configuration (cacheKey, apiUrl, expirationMs, responseKey)
+ * @param searchQuery - Optional search query (bypasses cache)
+ * @param filters - Optional filters object (bypasses cache)
+ * @param pageLimit - Number of items to fetch (default: 100)
+ * @returns Promise<{count: number, items: T[]}> - Cached or fresh data
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
+ * const users = await getCachedData<UserBE>(config);
+ *
+ * // With search (bypasses cache)
+ * const filtered = await getCachedData<UserBE>(config, 'John');
+ *
+ * // With filters (bypasses cache)
+ * const active = await getCachedData<UserBE>(config, undefined, { enabled: true });
+ */
+var getCachedData = function (config_1, searchQuery_1, filters_1) {
+    var args_1 = [];
+    for (var _i = 3; _i < arguments.length; _i++) {
+        args_1[_i - 3] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([config_1, searchQuery_1, filters_1], args_1, true), void 0, function (config, searchQuery, filters, pageLimit) {
+        var cacheKey, apiUrl, _a, expirationMs, responseKey, params_1, response_1, items_1, cachedData, currentTime, cachedTime, ageInMs, params, response, items, count, updatedCache, error_1;
+        var _b, _c, _d, _e, _f, _g;
+        if (pageLimit === void 0) { pageLimit = 100; }
+        return __generator(this, function (_h) {
+            switch (_h.label) {
+                case 0:
+                    cacheKey = config.cacheKey, apiUrl = config.apiUrl, _a = config.expirationMs, expirationMs = _a === void 0 ? constants_1.ONE_DAY_IN_MS : _a, responseKey = config.responseKey;
+                    _h.label = 1;
+                case 1:
+                    _h.trys.push([1, 5, , 6]);
+                    if (!((searchQuery && searchQuery.trim()) ||
+                        (filters && Object.keys(filters).length > 0))) return [3 /*break*/, 3];
+                    params_1 = new URLSearchParams(__assign(__assign({ pageLimit: pageLimit.toString(), currentPage: '1' }, (searchQuery && { searchQuery: searchQuery })), (filters &&
+                        Object.keys(filters).reduce(function (acc, key) {
+                            acc[key] = String(filters[key]);
+                            return acc;
+                        }, {}))));
+                    return [4 /*yield*/, (0, fetch_data_1.fetchData)({
+                            url: "".concat(apiUrl, "?").concat(params_1.toString()),
+                            method: constants_1.API_METHODS.GET,
+                        })];
+                case 2:
+                    response_1 = _h.sent();
+                    items_1 = responseKey
+                        ? ((_b = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _b === void 0 ? void 0 : _b[responseKey]) || []
+                        : ((_c = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _c === void 0 ? void 0 : _c.items) || (response_1 === null || response_1 === void 0 ? void 0 : response_1.data) || [];
+                    return [2 /*return*/, {
+                            count: ((_d = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _d === void 0 ? void 0 : _d.count) || items_1.length,
+                            items: items_1,
+                        }];
+                case 3:
+                    cachedData = (0, local_storage_1.getStorageValue)(cacheKey);
+                    currentTime = new Date().getTime();
+                    if (cachedData) {
+                        cachedTime = new Date(cachedData.cachedAt).getTime();
+                        ageInMs = currentTime - cachedTime;
+                        if (ageInMs < expirationMs) {
+                            return [2 /*return*/, {
+                                    count: cachedData.items.length,
+                                    items: cachedData.items,
+                                }];
+                        }
+                    }
+                    params = new URLSearchParams({
+                        pageLimit: pageLimit.toString(),
+                        currentPage: '1',
+                    });
+                    return [4 /*yield*/, (0, fetch_data_1.fetchData)({
+                            url: "".concat(apiUrl, "?").concat(params.toString()),
+                            method: constants_1.API_METHODS.GET,
+                        })];
+                case 4:
+                    response = _h.sent();
+                    items = responseKey
+                        ? ((_e = response === null || response === void 0 ? void 0 : response.data) === null || _e === void 0 ? void 0 : _e[responseKey]) || []
+                        : ((_f = response === null || response === void 0 ? void 0 : response.data) === null || _f === void 0 ? void 0 : _f.items) || (response === null || response === void 0 ? void 0 : response.data) || [];
+                    count = ((_g = response === null || response === void 0 ? void 0 : response.data) === null || _g === void 0 ? void 0 : _g.count) || items.length;
+                    if (items.length > 0) {
+                        updatedCache = {
+                            items: items,
+                            cachedAt: new Date().toISOString(),
+                        };
+                        (0, local_storage_1.setStorageValue)(cacheKey, updatedCache);
+                    }
+                    return [2 /*return*/, { count: count, items: items }];
+                case 5:
+                    error_1 = _h.sent();
+                    console.error("Error fetching data for ".concat(cacheKey, ":"), error_1);
+                    return [2 /*return*/, { count: 0, items: [] }];
+                case 6: return [2 /*return*/];
+            }
+        });
+    });
+};
+exports.getCachedData = getCachedData;
+/**
+ * Get single cached item by ID from a list cache
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param itemId - ID of the item to retrieve
+ * @returns T | null - Cached item or null
+ *
+ * @example
+ * const user = getCachedItemById<UserBE>(LS_KEYS.USERS, 'user-123');
+ * if (user) {
+ *   console.log(user.name);
+ * }
+ */
+var getCachedItemById = function (cacheKey, itemId) {
+    if (!itemId) {
+        return null;
+    }
+    try {
+        var items = (0, exports.getCachedDataSync)(cacheKey).items;
+        return items.find(function (item) { return item.id === itemId; }) || null;
+    }
+    catch (error) {
+        console.error("Error getting cached item by ID for ".concat(cacheKey, ":"), error);
+        return null;
+    }
+};
+exports.getCachedItemById = getCachedItemById;
+// ============================================================================
+// SINGLE ITEM CACHE FUNCTIONS
+// ============================================================================
+/**
+ * Get synchronous cached single item
+ * Returns null if cache is missing or stale
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns T | null - Cached item or null
+ *
+ * @example
+ * const workspace = getCachedSingleItemSync<WorkspaceBE>(LS_KEYS.WORKSPACE);
+ * if (workspace) {
+ *   console.log(workspace.name);
+ * }
+ */
+var getCachedSingleItemSync = function (cacheKey, expirationMs) {
+    if (expirationMs === void 0) { expirationMs = constants_1.ONE_DAY_IN_MS; }
+    try {
+        var cachedData = (0, local_storage_1.getStorageValue)(cacheKey);
+        if (!cachedData) {
+            return null;
+        }
+        var currentTime = new Date().getTime();
+        var cachedTime = new Date(cachedData.cachedAt).getTime();
+        var ageInMs = currentTime - cachedTime;
+        if (ageInMs < expirationMs) {
+            return cachedData.item;
+        }
+        return null;
+    }
+    catch (error) {
+        console.error("Error getting cached single item for ".concat(cacheKey, ":"), error);
+        return null;
+    }
+};
+exports.getCachedSingleItemSync = getCachedSingleItemSync;
+/**
+ * Get cached single item with API fallback
+ * Useful for workspace, profile, settings, etc.
+ *
+ * @param config - Cache configuration (cacheKey, apiUrl, expirationMs, responseKey)
+ * @param params - Optional query parameters for API request
+ * @returns Promise<T | null> - Cached or fresh item
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.WORKSPACE, apiUrl: '/api/workspace', responseKey: 'workspace' };
+ * const workspace = await getCachedSingleItem<WorkspaceBE>(config, { subdomain: 'school1' });
+ */
+var getCachedSingleItem = function (config, params) { return __awaiter(void 0, void 0, void 0, function () {
+    var cacheKey, apiUrl, _a, expirationMs, cachedData, currentTime, cachedTime, ageInMs, queryParams, response, item, updatedCache, error_2;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                cacheKey = config.cacheKey, apiUrl = config.apiUrl, _a = config.expirationMs, expirationMs = _a === void 0 ? constants_1.ONE_DAY_IN_MS : _a;
+                _b.label = 1;
+            case 1:
+                _b.trys.push([1, 3, , 4]);
+                cachedData = (0, local_storage_1.getStorageValue)(cacheKey);
+                currentTime = new Date().getTime();
+                if (cachedData) {
+                    cachedTime = new Date(cachedData.cachedAt).getTime();
+                    ageInMs = currentTime - cachedTime;
+                    if (ageInMs < expirationMs) {
+                        return [2 /*return*/, cachedData.item];
+                    }
+                }
+                queryParams = params
+                    ? "?".concat(new URLSearchParams(params).toString())
+                    : '';
+                return [4 /*yield*/, (0, fetch_data_1.fetchData)({
+                        url: "".concat(apiUrl).concat(queryParams),
+                        method: constants_1.API_METHODS.GET,
+                    })];
+            case 2:
+                response = _b.sent();
+                item = (response === null || response === void 0 ? void 0 : response.data) || null;
+                if (item) {
+                    updatedCache = {
+                        item: item,
+                        cachedAt: new Date().toISOString(),
+                    };
+                    (0, local_storage_1.setStorageValue)(cacheKey, updatedCache);
+                }
+                return [2 /*return*/, item];
+            case 3:
+                error_2 = _b.sent();
+                console.error("Error fetching single item for ".concat(cacheKey, ":"), error_2);
+                return [2 /*return*/, null];
+            case 4: return [2 /*return*/];
+        }
+    });
+}); };
+exports.getCachedSingleItem = getCachedSingleItem;
+// ============================================================================
+// CACHE UTILITIES
+// ============================================================================
+/**
+ * Invalidate (remove) cache for a module
+ * Useful after create/update/delete operations
+ *
+ * @param cacheKey - localStorage key for the cache
+ *
+ * @example
+ * invalidateCache(LS_KEYS.USERS);
+ * const freshUsers = await getCachedData(config);
+ */
+var invalidateCache = function (cacheKey) {
+    try {
+        localStorage.removeItem(cacheKey);
+    }
+    catch (error) {
+        console.error("Error invalidating cache for ".concat(cacheKey, ":"), error);
+    }
+};
+exports.invalidateCache = invalidateCache;
+/**
+ * Preload cache for a module
+ * Useful to call on app initialization or login
+ *
+ * @param config - Cache configuration
+ * @returns Promise<ListResponse<T>> - Preloaded data
+ *
+ * @example
+ * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
+ * await preloadCache(config);
+ */
+var preloadCache = function (config) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        return [2 /*return*/, (0, exports.getCachedData)(config)];
+    });
+}); };
+exports.preloadCache = preloadCache;
+/**
+ * Check if cache is stale (older than expiration time)
+ *
+ * @param cacheKey - localStorage key for the cache
+ * @param expirationMs - Cache expiration time in milliseconds (default: 1 day)
+ * @returns boolean - True if cache is stale or doesn't exist
+ *
+ * @example
+ * if (isCacheStale(LS_KEYS.USERS)) {
+ *   await getCachedData(config); // This will fetch fresh data
+ * }
+ */
+var isCacheStale = function (cacheKey, expirationMs) {
+    if (expirationMs === void 0) { expirationMs = constants_1.ONE_DAY_IN_MS; }
+    try {
+        var cachedData = (0, local_storage_1.getStorageValue)(cacheKey);
+        if (!cachedData) {
+            return true;
+        }
+        var currentTime = new Date().getTime();
+        var cachedTime = new Date(cachedData.cachedAt).getTime();
+        var ageInMs = currentTime - cachedTime;
+        return ageInMs >= expirationMs;
+    }
+    catch (error) {
+        console.error("Error checking cache staleness for ".concat(cacheKey, ":"), error);
+        return true;
+    }
+};
+exports.isCacheStale = isCacheStale;

package/general/index.d.ts

@@ -24,6 +24,7 @@ export * from './generate-faq-schema';
 export * from './generate-grid';
 export * from './generate-organization-schema';
 export * from './generate-ref';
+export * from './generic-cache';
 export * from './get-available-page-limit';
 export * from './get-calendar-current-month';
 export * from './get-calendar-dates';

package/general/index.js

@@ -40,6 +40,7 @@ __exportStar(require("./generate-faq-schema"), exports);
 __exportStar(require("./generate-grid"), exports);
 __exportStar(require("./generate-organization-schema"), exports);
 __exportStar(require("./generate-ref"), exports);
+__exportStar(require("./generic-cache"), exports);
 __exportStar(require("./get-available-page-limit"), exports);
 __exportStar(require("./get-calendar-current-month"), exports);
 __exportStar(require("./get-calendar-dates"), exports);

package/hooks/use-fetch.d.ts

@@ -13,6 +13,17 @@ export interface FetchConfig extends Omit<RequestInit, 'credentials'> {
      * (e.g. 'omit' | 'same-origin' | 'include').
      */
     credentials?: boolean | RequestCredentials;
+    /**
+     * Query parameters to append to GET requests.
+     * Supports strings, numbers, booleans, arrays, and objects.
+     * - Primitives (string, number, boolean) are converted to strings
+     * - Arrays are repeated as multiple params with the same key
+     * - Objects are JSON-stringified
+     * - null and undefined values are skipped
+     *
+     * Example: { active: true, page: 1, tags: ['a', 'b'] }
+     * Results in: ?active=true&page=1&tags=a&tags=b
+     */
     params?: Record<string, any>;
 }
 export interface Return {

package/hooks/use-module-entity-v2.d.ts

@@ -19,12 +19,18 @@
  *   using a short timeout (default 300ms) to avoid unnecessary list reloads.
  *
  * Parameters (object)
- * - `byIdCallback(data)`, `byIdDeps`, `byIdParams`
- * - `deleteCallback(data)`, `deleteDeps`, `deleteParams`
- * - `listCallback(data)`, `listDeps`, `listParams`, `listUrl`
+ * - `byIdCallback(data)`, `byIdDeps`, `byIdParams` — params for GET by ID request
+ * - `deleteCallback(data)`, `deleteDeps`, `deleteParams` — body for DELETE request
+ * - `listCallback(data)`, `listDeps`, `listParams`, `listUrl` — params for GET list
  * - `searchQuery` (string) — debounced before influencing the list fetch
  * - `unitByIdUrl`, `unitUrl`
- * - `updateCallback(data)`, `updateDeps`, `updateParams`
+ * - `updateCallback(data)`, `updateDeps`, `updateParams` — body for PUT request
+ *
+ * Parameter types
+ * - `listParams` and `byIdParams` support all primitive types including booleans.
+ *   They are appended as URL query parameters for GET requests.
+ *   Example: { active: true, page: 1 } → ?active=true&page=1
+ * - `updateParams` and `deleteParams` are sent as JSON in request body.
  *
  * Return values
  * - `byIdFetchNow(url?, config?)`, `byIdLoading`, `byIdError`
@@ -44,7 +50,7 @@
  * Example
  * const { listFetchNow, updateFetchNow } = useModuleEntityV2({
  *   listUrl: '/items',
- *   listParams: { page: 1 },
+ *   listParams: { page: 1, active: true },
  *   listCallback: (res) => console.log(res),
  *   unitUrl: '/items',
  *   updateCallback: () => {},

package/hooks/use-module-entity-v2.js

@@ -20,12 +20,18 @@
  *   using a short timeout (default 300ms) to avoid unnecessary list reloads.
  *
  * Parameters (object)
- * - `byIdCallback(data)`, `byIdDeps`, `byIdParams`
- * - `deleteCallback(data)`, `deleteDeps`, `deleteParams`
- * - `listCallback(data)`, `listDeps`, `listParams`, `listUrl`
+ * - `byIdCallback(data)`, `byIdDeps`, `byIdParams` — params for GET by ID request
+ * - `deleteCallback(data)`, `deleteDeps`, `deleteParams` — body for DELETE request
+ * - `listCallback(data)`, `listDeps`, `listParams`, `listUrl` — params for GET list
  * - `searchQuery` (string) — debounced before influencing the list fetch
  * - `unitByIdUrl`, `unitUrl`
- * - `updateCallback(data)`, `updateDeps`, `updateParams`
+ * - `updateCallback(data)`, `updateDeps`, `updateParams` — body for PUT request
+ *
+ * Parameter types
+ * - `listParams` and `byIdParams` support all primitive types including booleans.
+ *   They are appended as URL query parameters for GET requests.
+ *   Example: { active: true, page: 1 } → ?active=true&page=1
+ * - `updateParams` and `deleteParams` are sent as JSON in request body.
  *
  * Return values
  * - `byIdFetchNow(url?, config?)`, `byIdLoading`, `byIdError`
@@ -45,7 +51,7 @@
  * Example
  * const { listFetchNow, updateFetchNow } = useModuleEntityV2({
  *   listUrl: '/items',
- *   listParams: { page: 1 },
+ *   listParams: { page: 1, active: true },
  *   listCallback: (res) => console.log(res),
  *   unitUrl: '/items',
  *   updateCallback: () => {},
@@ -94,7 +100,7 @@ var useModuleEntityV2 = function (_a) {
             try {
                 // pass current list params explicitly so the fetch uses the latest values
                 listFetchNow(undefined, {
-                    method: constants_1.API_METHODS.POST,
+                    method: constants_1.API_METHODS.GET,
                     params: listParams,
                 });
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-pakistan/util-functions",
-  "version": "1.25.7",
+  "version": "1.25.9",
   "description": "A library of all util functions",
   "main": "index.js",
   "scripts": {