@react-pakistan/util-functions 1.24.98 → 1.24.99

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

@@ -0,0 +1,280 @@
+"use strict";
+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.isProductsCacheStale = exports.preloadProducts = exports.invalidateProductsCache = exports.getCachedProductById = exports.getCachedProducts = exports.getCachedProductsSync = 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");
+/**
+ * Synchronous utility function to get products from cache only
+ * Returns cached data immediately if available and fresh, otherwise returns empty array
+ * Does not trigger any API calls
+ *
+ * @returns ProductTypeBE[] - Array of cached products or empty array wrapper ({count, items})
+ *
+ * @example
+ * const products = getCachedProductsSync();
+ * if (products.items.length > 0) {
+ *   console.log(products.items[0].name);
+ * }
+ */
+var getCachedProductsSync = function () {
+    try {
+        var cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.PRODUCTS);
+        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 day old, return it
+        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+            return {
+                count: cachedData.products.length,
+                items: cachedData.products,
+            };
+        }
+        return { count: 0, items: [] };
+    }
+    catch (error) {
+        console.error('Error getting cached products:', error);
+        return { count: 0, items: [] };
+    }
+};
+exports.getCachedProductsSync = getCachedProductsSync;
+/**
+ * Utility function to get products from cache or fetch from API
+ *
+ * This function manages a localStorage cache of products with the following logic:
+ * - If products exist in cache and are less than 1 day old, return cached version
+ * - If products exist but are older than 1 day, fetch fresh data and update cache
+ * - If products don't exist in cache, fetch from API and cache them
+ *
+ * @param searchQuery - Optional search query to filter products
+ * @param filters - Optional filters object to apply additional filtering (bypasses cache)
+ * @param pageLimit - Number of products to fetch (default: 100)
+ * @returns Promise<{count:number, items: ProductTypeBE[]}> - Paged products
+ *
+ * @example
+ * const products = await getCachedProducts();
+ * console.log(products.items[0].name);
+ *
+ * // With search
+ * const filtered = await getCachedProducts('Samsung');
+ *
+ * // With filters
+ * const filteredByCategory = await getCachedProducts(undefined, { productCategoryId: 'cat-123' });
+ */
+var getCachedProducts = function (searchQuery_1, filters_1) {
+    var args_1 = [];
+    for (var _i = 2; _i < arguments.length; _i++) {
+        args_1[_i - 2] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([searchQuery_1, filters_1], args_1, true), void 0, function (searchQuery, filters, 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()) ||
+                        (filters && Object.keys(filters).length > 0))) return [3 /*break*/, 2];
+                    return [4 /*yield*/, (0, fetch_data_1.fetchData)({
+                            url: constants_1.API_ROUTES.PRODUCTS,
+                            body: JSON.stringify(__assign(__assign({ searchQuery: searchQuery }, filters), { 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.PRODUCTS);
+                    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 day old, return it
+                        if (ageInMs < constants_1.ONE_DAY_IN_MS) {
+                            return [2 /*return*/, {
+                                    count: cachedData.products.length,
+                                    items: cachedData.products,
+                                }];
+                        }
+                    }
+                    return [4 /*yield*/, (0, fetch_data_1.fetchData)({
+                            url: constants_1.API_ROUTES.PRODUCTS,
+                            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 = {
+                            products: response.data.items,
+                            cachedAt: new Date().toISOString(),
+                        };
+                        (0, set_storage_value_1.setStorageValue)(type_1.LS_KEYS.PRODUCTS, updatedCache);
+                        return [2 /*return*/, response.data];
+                    }
+                    return [2 /*return*/, { count: 0, items: [] }];
+                case 4:
+                    error_1 = _b.sent();
+                    console.error('Error fetching products:', error_1);
+                    return [2 /*return*/, { count: 0, items: [] }];
+                case 5: return [2 /*return*/];
+            }
+        });
+    });
+};
+exports.getCachedProducts = getCachedProducts;
+/**
+ * Utility function to get a specific product by ID from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param productId - The ID of the product to retrieve
+ * @returns ProductTypeBE | null - The product or null if not found
+ *
+ * @example
+ * const product = getCachedProductById('prod-123');
+ * if (product) {
+ *   console.log(product.name);
+ * }
+ */
+var getCachedProductById = function (categoryId) {
+    if (!categoryId) {
+        return null;
+    }
+    try {
+        var products = (0, exports.getCachedProductsSync)().items;
+        return products.find(function (cat) { return cat.id === categoryId; }) || null;
+    }
+    catch (error) {
+        console.error('Error getting cached product by ID:', error);
+        return null;
+    }
+};
+exports.getCachedProductById = getCachedProductById;
+/**
+ * Utility function to invalidate (remove) products from cache
+ * Useful when products have been updated and you want to force a refresh
+ *
+ * @example
+ * invalidateProductsCache();
+ * const freshProducts = await getCachedProducts();
+ */
+var invalidateProductsCache = function () {
+    try {
+        localStorage.removeItem(type_1.LS_KEYS.PRODUCTS);
+    }
+    catch (error) {
+        console.error('Error invalidating products cache:', error);
+    }
+};
+exports.invalidateProductsCache = invalidateProductsCache;
+/**
+ * Utility function to preload products into cache
+ * Useful to call on app initialization or login
+ *
+ * @returns Promise<{count:number, items: ProductTypeBE[]}> - Array of preloaded products
+ *
+ * @example
+ * // On app initialization
+ * await preloadProducts();
+ */
+var preloadProducts = function () { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        return [2 /*return*/, (0, exports.getCachedProducts)()];
+    });
+}); };
+exports.preloadProducts = preloadProducts;
+/**
+ * Utility function to check if products cache is stale
+ * Returns true if cache is older than 1 day or doesn't exist
+ *
+ * @returns boolean - True if cache is stale or doesn't exist
+ *
+ * @example
+ * if (isProductsCacheStale()) {
+ *   await getCachedProducts(); // This will fetch fresh data
+ * }
+ */
+var isProductsCacheStale = function () {
+    try {
+        var cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.PRODUCTS);
+        if (!cachedData) {
+            return true;
+        }
+        var currentTime = new Date().getTime();
+        var cachedTime = new Date(cachedData.cachedAt).getTime();
+        var ageInMs = currentTime - cachedTime;
+        return ageInMs >= constants_1.ONE_DAY_IN_MS;
+    }
+    catch (error) {
+        console.error('Error checking products cache staleness:', error);
+        return true;
+    }
+};
+exports.isProductsCacheStale = isProductsCacheStale;

package/api/stellar-solutions/product/index.d.ts

@@ -1,8 +1,8 @@
-import { ProductBE } from '../type';
+export * from './cache';
+import { ProductTypeBE } from '../type';
 type PrismaClient = any;
 export interface ListProductArgs {
-    buyPriceMax?: string;
-    buyPriceMin?: string;
+    buyPrice?: number;
     currentPage?: number;
     includeProductCategory?: boolean;
     includeQuotesInvoices?: boolean;
@@ -11,8 +11,7 @@ export interface ListProductArgs {
     pageLimit?: number;
     prisma: PrismaClient;
     productCategoryId?: string;
-    salePriceMax?: string;
-    salePriceMin?: string;
+    salePrice?: number;
     searchQuery?: string;
 }
 export interface UnitProductByIdArgs {
@@ -42,25 +41,24 @@ export interface DeleteProductArgs {
 /**
  * Retrieves a paginated list of products
  * @param {ListProductArgs} args - Object containing prisma client, pagination, filtering, and ordering options
- * @returns {Promise<[number, Array<ProductBE>]>} Tuple containing total count and array of products
+ * @returns {Promise<[number, Array<ProductTypeBE>]>} Tuple containing total count and array of products
  */
-export declare const listProduct: ({ buyPriceMax, buyPriceMin, currentPage, includeProductCategory, includeQuotesInvoices, orderByColumn, orderByDirection, pageLimit, prisma, salePriceMax, salePriceMin, searchQuery, }: ListProductArgs) => Promise<[number, Array<ProductBE>]>;
+export declare const listProduct: ({ buyPrice, currentPage, includeProductCategory, includeQuotesInvoices, orderByColumn, orderByDirection, pageLimit, prisma, productCategoryId, salePrice, searchQuery, }: ListProductArgs) => Promise<[number, Array<ProductTypeBE>]>;
 /**
  * Retrieves a single product by its ID
  * @param {UnitProductByIdArgs} args - Object containing prisma client, product ID, and optional query parameters
- * @returns {Promise<ProductBE | null>} Product or null if not found
+ * @returns {Promise<ProductTypeBE | null>} Product or null if not found
  */
-export declare const unitProductById: ({ id, includeProductCategory, includeQuotesInvoices, prisma, }: UnitProductByIdArgs) => Promise<ProductBE | null>;
+export declare const unitProductById: ({ id, includeProductCategory, includeQuotesInvoices, prisma, }: UnitProductByIdArgs) => Promise<ProductTypeBE | null>;
 /**
  * Creates or updates a product
  * @param {UpdateProductArgs} args - Object containing prisma client, product data, and optional query parameters
- * @returns {Promise<ProductBE>} Created or updated product
+ * @returns {Promise<ProductTypeBE>} Created or updated product
  */
-export declare const updateProduct: ({ buyPrice, currency, description, id, image, name, prisma, productCategoryId, quantity, ref, salePrice, }: UpdateProductArgs) => Promise<ProductBE>;
+export declare const updateProduct: ({ buyPrice, currency, description, id, image, name, prisma, productCategoryId, quantity, ref, salePrice, }: UpdateProductArgs) => Promise<ProductTypeBE>;
 /**
  * Deletes a product by ID
  * @param {DeleteProductArgs} args - Object containing prisma client, product ID, and optional query parameters
- * @returns {Promise<ProductBE>} Deleted product
+ * @returns {Promise<ProductTypeBE>} Deleted product
  */
-export declare const deleteProduct: ({ id, prisma, }: DeleteProductArgs) => Promise<ProductBE>;
-export {};
+export declare const deleteProduct: ({ id, prisma, }: DeleteProductArgs) => Promise<ProductTypeBE>;

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

@@ -10,6 +10,20 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 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) {
@@ -57,18 +71,19 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteProduct = exports.updateProduct = exports.unitProductById = exports.listProduct = void 0;
+__exportStar(require("./cache"), exports);
 var multi_part_search_1 = require("../../../general/multi-part-search");
 /**
  * Retrieves a paginated list of products
  * @param {ListProductArgs} args - Object containing prisma client, pagination, filtering, and ordering options
- * @returns {Promise<[number, Array<ProductBE>]>} Tuple containing total count and array of products
+ * @returns {Promise<[number, Array<ProductTypeBE>]>} Tuple containing total count and array of products
  */
 var listProduct = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, orderBy, idSearchQuery, nameSearchQuery, refSearchQuery, where, _c, count, items;
     var _d;
-    var _e = _b.buyPriceMax, buyPriceMax = _e === void 0 ? '' : _e, _f = _b.buyPriceMin, buyPriceMin = _f === void 0 ? '' : _f, _g = _b.currentPage, currentPage = _g === void 0 ? 1 : _g, _h = _b.includeProductCategory, includeProductCategory = _h === void 0 ? false : _h, _j = _b.includeQuotesInvoices, includeQuotesInvoices = _j === void 0 ? false : _j, _k = _b.orderByColumn, orderByColumn = _k === void 0 ? 'createdAt' : _k, _l = _b.orderByDirection, orderByDirection = _l === void 0 ? 'desc' : _l, _m = _b.pageLimit, pageLimit = _m === void 0 ? 5 : _m, prisma = _b.prisma, _o = _b.salePriceMax, salePriceMax = _o === void 0 ? '' : _o, _p = _b.salePriceMin, salePriceMin = _p === void 0 ? '' : _p, _q = _b.searchQuery, searchQuery = _q === void 0 ? '' : _q;
-    return __generator(this, function (_r) {
-        switch (_r.label) {
+    var _e = _b.buyPrice, buyPrice = _e === void 0 ? 0 : _e, _f = _b.currentPage, currentPage = _f === void 0 ? 1 : _f, _g = _b.includeProductCategory, includeProductCategory = _g === void 0 ? false : _g, _h = _b.includeQuotesInvoices, includeQuotesInvoices = _h === void 0 ? false : _h, _j = _b.orderByColumn, orderByColumn = _j === void 0 ? 'createdAt' : _j, _k = _b.orderByDirection, orderByDirection = _k === void 0 ? 'desc' : _k, _l = _b.pageLimit, pageLimit = _l === void 0 ? 5 : _l, prisma = _b.prisma, _m = _b.productCategoryId, productCategoryId = _m === void 0 ? '' : _m, _o = _b.salePrice, salePrice = _o === void 0 ? 0 : _o, _p = _b.searchQuery, searchQuery = _p === void 0 ? '' : _p;
+    return __generator(this, function (_q) {
+        switch (_q.label) {
             case 0:
                 if (!currentPage || currentPage < 1) {
                     throw new Error('Valid current page is required');
@@ -96,13 +111,14 @@ var listProduct = function (_a) { return __awaiter(void 0, [_a], void 0, functio
                     fullText: searchQuery,
                 });
                 where = {
+                    productCategoryId: productCategoryId || undefined,
                     buyPrice: {
-                        lte: buyPriceMin ? buyPriceMin : undefined,
-                        gte: buyPriceMax ? buyPriceMax : undefined,
+                        lte: buyPrice || undefined,
+                        gte: buyPrice || undefined,
                     },
                     salePrice: {
-                        lte: salePriceMin ? salePriceMin : undefined,
-                        gte: salePriceMax ? salePriceMax : undefined,
+                        lte: salePrice || undefined,
+                        gte: salePrice || undefined,
                     },
                     OR: __spreadArray(__spreadArray(__spreadArray([], idSearchQuery, true), nameSearchQuery, true), refSearchQuery, true),
                 };
@@ -119,7 +135,7 @@ var listProduct = function (_a) { return __awaiter(void 0, [_a], void 0, functio
                         }),
                     ])];
             case 1:
-                _c = _r.sent(), count = _c[0], items = _c[1];
+                _c = _q.sent(), count = _c[0], items = _c[1];
                 return [2 /*return*/, [count, items]];
         }
     });
@@ -128,7 +144,7 @@ exports.listProduct = listProduct;
 /**
  * Retrieves a single product by its ID
  * @param {UnitProductByIdArgs} args - Object containing prisma client, product ID, and optional query parameters
- * @returns {Promise<ProductBE | null>} Product or null if not found
+ * @returns {Promise<ProductTypeBE | null>} Product or null if not found
  */
 var unitProductById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, where, product;
@@ -160,7 +176,7 @@ exports.unitProductById = unitProductById;
 /**
  * Creates or updates a product
  * @param {UpdateProductArgs} args - Object containing prisma client, product data, and optional query parameters
- * @returns {Promise<ProductBE>} Created or updated product
+ * @returns {Promise<ProductTypeBE>} Created or updated product
  */
 var updateProduct = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var productData, where, product;
@@ -208,7 +224,7 @@ exports.updateProduct = updateProduct;
 /**
  * Deletes a product by ID
  * @param {DeleteProductArgs} args - Object containing prisma client, product ID, and optional query parameters
- * @returns {Promise<ProductBE>} Deleted product
+ * @returns {Promise<ProductTypeBE>} Deleted product
  */
 var deleteProduct = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var where, product;

package/api/stellar-solutions/product-category/cache.d.ts

@@ -0,0 +1,94 @@
+import { ProductCategoryTypeBE } from '../type';
+/**
+ * Synchronous utility function to get product categories from cache only
+ * Returns cached data immediately if available and fresh, otherwise returns empty array
+ * Does not trigger any API calls
+ *
+ * @returns ProductCategoryTypeBE[] - Array of cached product categories or empty array
+ *
+ * @example
+ * const categories = getCachedProductCategoriesSync();
+ * if (categories.length > 0) {
+ *   console.log(categories[0].name);
+ * }
+ */
+export declare const getCachedProductCategoriesSync: () => {
+    count: number;
+    items: ProductCategoryTypeBE[];
+};
+/**
+ * Utility function to get product categories from cache or fetch from API
+ *
+ * This function manages a localStorage cache of product categories with the following logic:
+ * - If categories exist in cache and are less than 1 week old, return cached version
+ * - If categories exist but are older than 1 week, fetch fresh data and update cache
+ * - If categories don't exist in cache, fetch from API and cache them
+ *
+ * @param searchQuery - Optional search query to filter categories
+ * @param filters - Optional filters object to apply additional filtering (bypasses cache)
+ * @param pageLimit - Number of categories to fetch (default: 100)
+ * @returns Promise<ProductCategoryTypeBE[]> - Array of product categories
+ *
+ * @example
+ * const categories = await getCachedProductCategories();
+ * console.log(categories[0].name);
+ *
+ * // With search
+ * const filtered = await getCachedProductCategories('Electronics');
+ *
+ * // With filters
+ * const filteredCategories = await getCachedProductCategories(undefined, { enabled: true });
+ */
+export declare const getCachedProductCategories: (searchQuery?: string, filters?: Record<string, unknown>, pageLimit?: number) => Promise<{
+    count: number;
+    items: ProductCategoryTypeBE[];
+}>;
+/**
+ * Utility function to get a specific product category by ID from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param categoryId - The ID of the category to retrieve
+ * @returns ProductCategoryTypeBE | null - The category or null if not found
+ *
+ * @example
+ * const category = getCachedProductCategoryById('cat-123');
+ * if (category) {
+ *   console.log(category.name);
+ * }
+ */
+export declare const getCachedProductCategoryById: (categoryId: string) => ProductCategoryTypeBE | null;
+/**
+ * Utility function to invalidate (remove) product categories from cache
+ * Useful when categories have been updated and you want to force a refresh
+ *
+ * @example
+ * invalidateProductCategoriesCache();
+ * const freshCategories = await getCachedProductCategories();
+ */
+export declare const invalidateProductCategoriesCache: () => void;
+/**
+ * Utility function to preload product categories into cache
+ * Useful to call on app initialization or login
+ *
+ * @returns Promise<ProductCategoryTypeBE[]> - Array of preloaded categories
+ *
+ * @example
+ * // On app initialization
+ * await preloadProductCategories();
+ */
+export declare const preloadProductCategories: () => Promise<{
+    count: number;
+    items: ProductCategoryTypeBE[];
+}>;
+/**
+ * Utility function to check if product categories 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 (isProductCategoriesCacheStale()) {
+ *   await getCachedProductCategories(); // This will fetch fresh data
+ * }
+ */
+export declare const isProductCategoriesCacheStale: () => boolean;