@react-pakistan/util-functions 1.25.89 → 2.0.0

package/general/generic-cache.js

@@ -1,659 +1 @@
-"use strict";
-/**
- * Generic Cache Utilities
- *
- * A lightweight localStorage-backed cache used by module-level cache wrappers.
- * Key behaviors:
- * - Default expiration: 1 day (configurable per cache)
- * - Search and filter requests bypass the cache and always fetch fresh data
- * - Lists are stored as a normalized map (id -> item) for fast lookups
- * - Provides both synchronous reads (`getCachedDataSync`) and async reads
- *   with API fallback (`getCachedData`)
- * - Single-item helpers available (`getCachedSingleItem`, `getCachedSingleItemSync`)
- *
- * The main async helper `getCachedData` now accepts a single options object
- * (`GetCachedDataOptions`) which includes `config`, optional `searchQuery`,
- * `filters`, `pageLimit` and extra `params` for the list API. Module cache
- * wrappers should call `getCachedData({ config, searchQuery, filters, pageLimit, params, headers })`.
- * Both `getCachedData` and `getCachedSingleItem` accept an optional `headers`
- * object which will be forwarded to the underlying `fetchData` calls.
- *
- * 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 };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCacheStale = exports.preloadCache = exports.invalidateCache = exports.getCachedItemByIdAsync = exports.getCachedDataWithFallback = 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");
-// Type guards for cached shapes
-function isCachedArrayShape(v) {
-    if (!v || typeof v !== 'object')
-        return false;
-    var o = v;
-    return (Array.isArray(o.items) &&
-        typeof o.cachedAt === 'string' &&
-        typeof o.count === 'number');
-}
-function isCachedMapShape(v) {
-    if (!v || typeof v !== 'object')
-        return false;
-    var o = v;
-    return (o.items !== undefined &&
-        typeof o.items === 'object' &&
-        !Array.isArray(o.items) &&
-        typeof o.cachedAt === 'string');
-}
-// ============================================================================
-// 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) {
-    var _a, _b, _c;
-    if (expirationMs === void 0) { expirationMs = constants_1.ONE_DAY_IN_MS; }
-    try {
-        var raw = (0, local_storage_1.getStorageValue)(cacheKey);
-        if (raw == null)
-            return { count: 0, items: [] };
-        var currentTime = new Date().getTime();
-        if (isCachedArrayShape(raw)) {
-            var cachedTime = new Date(raw.cachedAt).getTime();
-            var ageInMs = currentTime - cachedTime;
-            if (ageInMs < expirationMs) {
-                return {
-                    count: (_a = raw.count) !== null && _a !== void 0 ? _a : raw.items.length,
-                    items: raw.items,
-                    currentPage: (_b = raw.currentPage) !== null && _b !== void 0 ? _b : undefined,
-                };
-            }
-            return { count: 0, items: [] };
-        }
-        if (isCachedMapShape(raw)) {
-            var cachedTime = new Date(raw.cachedAt).getTime();
-            var ageInMs = currentTime - cachedTime;
-            if (ageInMs < expirationMs) {
-                var itemsArray = Object.values(raw.items || {});
-                var storedCount = raw.count;
-                return {
-                    count: storedCount !== null && storedCount !== void 0 ? storedCount : itemsArray.length,
-                    items: itemsArray,
-                    currentPage: (_c = raw.currentPage) !== null && _c !== void 0 ? _c : undefined,
-                };
-            }
-            return { count: 0, 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
- *
- * Accepts a single `GetCachedDataOptions` object. The function will return
- * cached results when fresh, or fetch from the API when the cache is stale
- * or when `searchQuery`/`filters` are present (those always bypass cache).
- *
- * @param opts - `GetCachedDataOptions` containing `config`, optional
- *               `searchQuery`, `filters`, `pageLimit`, and extra `params`
- * @returns Promise<{count: number, items: T[]}> - Cached or fresh data
- *
- * @example
- * const config = { cacheKey: LS_KEYS.USERS, apiUrl: USER_API_ROUTES.LIST, responseKey: 'users' };
- * // Basic usage (reads cache if fresh)
- * const users = await getCachedData<UserBE>({ config });
- *
- * // With search (bypasses cache)
- * const filtered = await getCachedData<UserBE>({ config, searchQuery: 'John' });
- *
- * // With filters and custom page limit
- * const active = await getCachedData<UserBE>({ config, filters: { enabled: true }, pageLimit: 200 });
- */
-var getCachedData = function (opts) { return __awaiter(void 0, void 0, void 0, function () {
-    var config, params, headers, cacheKey, apiUrl, responseKey, expirationMs, fallBackPageLimit, fallBackCurrentPage, filters, searchQuery, paramsWithoutFilters_1, otherParams_1, queryObj_1, searchParams_1, response_1, itemsRaw_1, items_1, respCurrentPageRaw_1, respCurrentPage_1, requestCurrentPage_1, raw, currentTime, cachedTime, ageInMs, cachedTime, ageInMs, itemsArray, storedCount, cachedCurrentPage, requestedCurrentPage, paramsWithoutFilters_2, otherParams_2, queryObj_2, searchParams_2, response_2, itemsRaw_2, fetchedItems, respCount, respCurrentPageRaw_2, respCurrentPage_2, newItemsMap, mergedItemsMap, mergedItemsArray, newCount, newCurrentPage, shouldCache_1, updatedCache, paramsWithoutFilters_3, otherParams, queryObj, searchParams, response, itemsRaw, items, count, respCurrentPageRaw, respCurrentPage, requestCurrentPage, shouldCache, itemsMap, updatedCache, error_1;
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
-    return __generator(this, function (_v) {
-        switch (_v.label) {
-            case 0:
-                config = opts.config, params = opts.params, headers = opts.headers;
-                cacheKey = config.cacheKey, apiUrl = config.apiUrl, responseKey = config.responseKey;
-                expirationMs = (_a = config.expirationMs) !== null && _a !== void 0 ? _a : constants_1.ONE_DAY_IN_MS;
-                fallBackPageLimit = (_c = (_b = params === null || params === void 0 ? void 0 : params.pageLimit) === null || _b === void 0 ? void 0 : _b.toString()) !== null && _c !== void 0 ? _c : '100';
-                fallBackCurrentPage = (_e = (_d = params === null || params === void 0 ? void 0 : params.currentPage) === null || _d === void 0 ? void 0 : _d.toString()) !== null && _e !== void 0 ? _e : '1';
-                filters = params === null || params === void 0 ? void 0 : params.filters;
-                searchQuery = params === null || params === void 0 ? void 0 : params.searchQuery;
-                _v.label = 1;
-            case 1:
-                _v.trys.push([1, 8, , 9]);
-                if (!((searchQuery && searchQuery.trim()) || (params === null || params === void 0 ? void 0 : params.filters))) return [3 /*break*/, 3];
-                paramsWithoutFilters_1 = __assign({}, (params || {}));
-                if (paramsWithoutFilters_1.filters !== undefined) {
-                    delete paramsWithoutFilters_1.filters;
-                }
-                otherParams_1 = Object.keys(paramsWithoutFilters_1).reduce(function (acc, key) {
-                    acc[key] = String(paramsWithoutFilters_1[key]);
-                    return acc;
-                }, {});
-                queryObj_1 = __assign(__assign(__assign({ pageLimit: fallBackPageLimit, currentPage: fallBackCurrentPage }, (searchQuery && { searchQuery: searchQuery })), (filters
-                    ? Object.keys(filters).reduce(function (acc, key) {
-                        acc[key] = String(filters[key]);
-                        return acc;
-                    }, {})
-                    : {})), otherParams_1);
-                searchParams_1 = new URLSearchParams(queryObj_1);
-                return [4 /*yield*/, (0, fetch_data_1.fetchData)({
-                        url: "".concat(apiUrl, "?").concat(searchParams_1.toString()),
-                        method: constants_1.API_METHODS.GET,
-                        headers: headers,
-                    })];
-            case 2:
-                response_1 = _v.sent();
-                itemsRaw_1 = responseKey
-                    ? (_f = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _f === void 0 ? void 0 : _f[responseKey]
-                    : ((_g = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _g === void 0 ? void 0 : _g.items) || (response_1 === null || response_1 === void 0 ? void 0 : response_1.data);
-                items_1 = Array.isArray(itemsRaw_1) ? itemsRaw_1 : [];
-                respCurrentPageRaw_1 = (_h = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _h === void 0 ? void 0 : _h.currentPage;
-                respCurrentPage_1 = respCurrentPageRaw_1 == null ? undefined : Number(respCurrentPageRaw_1);
-                requestCurrentPage_1 = (params === null || params === void 0 ? void 0 : params.currentPage)
-                    ? Number(params.currentPage)
-                    : undefined;
-                return [2 /*return*/, {
-                        count: ((_j = response_1 === null || response_1 === void 0 ? void 0 : response_1.data) === null || _j === void 0 ? void 0 : _j.count) || items_1.length,
-                        items: items_1,
-                        currentPage: respCurrentPage_1 !== null && respCurrentPage_1 !== void 0 ? respCurrentPage_1 : requestCurrentPage_1,
-                    }];
-            case 3:
-                raw = (0, local_storage_1.getStorageValue)(cacheKey);
-                currentTime = new Date().getTime();
-                if (isCachedArrayShape(raw)) {
-                    cachedTime = new Date(raw.cachedAt).getTime();
-                    ageInMs = currentTime - cachedTime;
-                    if (ageInMs < expirationMs) {
-                        return [2 /*return*/, {
-                                count: raw.count,
-                                items: raw.items,
-                                currentPage: (_k = raw.currentPage) !== null && _k !== void 0 ? _k : undefined,
-                            }];
-                    }
-                }
-                if (!isCachedMapShape(raw)) return [3 /*break*/, 6];
-                cachedTime = new Date(raw.cachedAt).getTime();
-                ageInMs = currentTime - cachedTime;
-                if (!(ageInMs < expirationMs)) return [3 /*break*/, 6];
-                itemsArray = Object.values(raw.items || {});
-                storedCount = raw.count;
-                cachedCurrentPage = raw.currentPage;
-                requestedCurrentPage = (params === null || params === void 0 ? void 0 : params.currentPage)
-                    ? Number(params.currentPage)
-                    : undefined;
-                if (!(requestedCurrentPage !== undefined &&
-                    requestedCurrentPage !== cachedCurrentPage)) return [3 /*break*/, 5];
-                paramsWithoutFilters_2 = __assign({}, (params || {}));
-                if (paramsWithoutFilters_2.filters !== undefined) {
-                    delete paramsWithoutFilters_2.filters;
-                }
-                otherParams_2 = Object.keys(paramsWithoutFilters_2).reduce(function (acc, key) {
-                    acc[key] = String(paramsWithoutFilters_2[key]);
-                    return acc;
-                }, {});
-                queryObj_2 = __assign({ pageLimit: fallBackPageLimit, currentPage: String(requestedCurrentPage) }, otherParams_2);
-                searchParams_2 = new URLSearchParams(queryObj_2);
-                return [4 /*yield*/, (0, fetch_data_1.fetchData)({
-                        url: "".concat(apiUrl, "?").concat(searchParams_2.toString()),
-                        method: constants_1.API_METHODS.GET,
-                        headers: headers,
-                    })];
-            case 4:
-                response_2 = _v.sent();
-                itemsRaw_2 = (responseKey
-                    ? (_l = response_2 === null || response_2 === void 0 ? void 0 : response_2.data) === null || _l === void 0 ? void 0 : _l[responseKey]
-                    : (_m = response_2 === null || response_2 === void 0 ? void 0 : response_2.data) === null || _m === void 0 ? void 0 : _m.items) || (response_2 === null || response_2 === void 0 ? void 0 : response_2.data);
-                fetchedItems = Array.isArray(itemsRaw_2)
-                    ? itemsRaw_2
-                    : [];
-                respCount = (_o = response_2 === null || response_2 === void 0 ? void 0 : response_2.data) === null || _o === void 0 ? void 0 : _o.count;
-                respCurrentPageRaw_2 = (_p = response_2 === null || response_2 === void 0 ? void 0 : response_2.data) === null || _p === void 0 ? void 0 : _p.currentPage;
-                respCurrentPage_2 = respCurrentPageRaw_2 == null ? undefined : Number(respCurrentPageRaw_2);
-                newItemsMap = fetchedItems.reduce(function (acc, item, idx) {
-                    var _a, _b;
-                    var obj = item;
-                    var keyCandidate = (_b = (_a = obj === null || obj === void 0 ? void 0 : obj.id) !== null && _a !== void 0 ? _a : obj === null || obj === void 0 ? void 0 : obj.uid) !== null && _b !== void 0 ? _b : idx;
-                    var key = String(keyCandidate);
-                    acc[key] = item;
-                    return acc;
-                }, {});
-                mergedItemsMap = Object.assign({}, raw.items || {}, newItemsMap);
-                mergedItemsArray = Object.values(mergedItemsMap);
-                newCount = respCount !== null && respCount !== void 0 ? respCount : mergedItemsArray.length;
-                newCurrentPage = respCurrentPage_2 !== null && respCurrentPage_2 !== void 0 ? respCurrentPage_2 : requestedCurrentPage;
-                shouldCache_1 = Array.isArray(itemsRaw_2) && typeof respCount === 'number';
-                if (shouldCache_1) {
-                    updatedCache = {
-                        items: mergedItemsMap,
-                        cachedAt: new Date().toISOString(),
-                        count: newCount,
-                        currentPage: newCurrentPage,
-                    };
-                    (0, local_storage_1.setStorageValue)(cacheKey, updatedCache);
-                }
-                return [2 /*return*/, {
-                        count: newCount,
-                        items: mergedItemsArray,
-                        currentPage: newCurrentPage,
-                    }];
-            case 5: return [2 /*return*/, {
-                    count: storedCount !== null && storedCount !== void 0 ? storedCount : itemsArray.length,
-                    items: itemsArray,
-                    currentPage: (_q = raw.currentPage) !== null && _q !== void 0 ? _q : undefined,
-                }];
-            case 6:
-                paramsWithoutFilters_3 = __assign({}, (params || {}));
-                if (paramsWithoutFilters_3.filters !== undefined) {
-                    delete paramsWithoutFilters_3.filters;
-                }
-                otherParams = Object.keys(paramsWithoutFilters_3).reduce(function (acc, key) {
-                    acc[key] = String(paramsWithoutFilters_3[key]);
-                    return acc;
-                }, {});
-                queryObj = __assign({ pageLimit: fallBackPageLimit, currentPage: fallBackCurrentPage }, otherParams);
-                searchParams = new URLSearchParams(queryObj);
-                return [4 /*yield*/, (0, fetch_data_1.fetchData)({
-                        url: "".concat(apiUrl, "?").concat(searchParams.toString()),
-                        method: constants_1.API_METHODS.GET,
-                        headers: headers,
-                    })];
-            case 7:
-                response = _v.sent();
-                itemsRaw = (responseKey ? (_r = response === null || response === void 0 ? void 0 : response.data) === null || _r === void 0 ? void 0 : _r[responseKey] : (_s = response === null || response === void 0 ? void 0 : response.data) === null || _s === void 0 ? void 0 : _s.items) ||
-                    (response === null || response === void 0 ? void 0 : response.data);
-                items = Array.isArray(itemsRaw) ? itemsRaw : [];
-                count = (_t = response === null || response === void 0 ? void 0 : response.data) === null || _t === void 0 ? void 0 : _t.count;
-                respCurrentPageRaw = (_u = response === null || response === void 0 ? void 0 : response.data) === null || _u === void 0 ? void 0 : _u.currentPage;
-                respCurrentPage = respCurrentPageRaw == null ? undefined : Number(respCurrentPageRaw);
-                requestCurrentPage = (params === null || params === void 0 ? void 0 : params.currentPage)
-                    ? Number(params.currentPage)
-                    : undefined;
-                shouldCache = Array.isArray(itemsRaw) && typeof count === 'number';
-                if (shouldCache) {
-                    itemsMap = items.reduce(function (acc, item, idx) {
-                        var _a, _b;
-                        var obj = item;
-                        var keyCandidate = (_b = (_a = obj === null || obj === void 0 ? void 0 : obj.id) !== null && _a !== void 0 ? _a : obj === null || obj === void 0 ? void 0 : obj.uid) !== null && _b !== void 0 ? _b : idx;
-                        var key = String(keyCandidate);
-                        acc[key] = item;
-                        return acc;
-                    }, {});
-                    updatedCache = {
-                        items: itemsMap,
-                        cachedAt: new Date().toISOString(),
-                        count: count,
-                        currentPage: respCurrentPage !== null && respCurrentPage !== void 0 ? respCurrentPage : requestCurrentPage,
-                    };
-                    (0, local_storage_1.setStorageValue)(cacheKey, updatedCache);
-                }
-                // Return count as number when present, otherwise fallback to items.length
-                return [2 /*return*/, {
-                        count: count,
-                        items: items,
-                        currentPage: respCurrentPage !== null && respCurrentPage !== void 0 ? respCurrentPage : requestCurrentPage,
-                    }];
-            case 8:
-                error_1 = _v.sent();
-                console.error("Error fetching data for ".concat(cacheKey, ":"), error_1);
-                return [2 /*return*/, { count: 0, items: [] }];
-            case 9: 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 {
-        // Try to read normalized cache first for O(1) lookup
-        var raw = (0, local_storage_1.getStorageValue)(cacheKey);
-        if (isCachedArrayShape(raw)) {
-            return raw.items.find(function (i) { return i.id === itemId; }) || null;
-        }
-        if (isCachedMapShape(raw)) {
-            return (raw.items && raw.items[itemId]) || null;
-        }
-        // Fallback to sync reader
-        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, headers) { return __awaiter(void 0, void 0, void 0, function () {
-    var cacheKey, apiUrl, expirationMs, cachedData, currentTime, cachedTime, ageInMs, queryParams, response, item, updatedCache, error_2;
-    var _a;
-    return __generator(this, function (_b) {
-        switch (_b.label) {
-            case 0:
-                cacheKey = config.cacheKey, apiUrl = config.apiUrl;
-                expirationMs = (_a = config.expirationMs) !== null && _a !== void 0 ? _a : constants_1.ONE_DAY_IN_MS;
-                _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,
-                        headers: headers,
-                    })];
-            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;
-/**
- * Get cached data but fall back to the API when sync cache is empty.
- *
- * This helper first performs a quick synchronous cache check via
- * `getCachedDataSync`. If that returns an empty result it will call
- * the async `getCachedData` to fetch fresh data from the API and return
- * the result. Use this when callers want a fast-path cache read but also
- * need the ability to recall the API transparently when cache is missing.
- */
-var getCachedDataWithFallback = function (config, params, headers) { return __awaiter(void 0, void 0, void 0, function () {
-    var expirationMs, sync, error_3;
-    var _a;
-    return __generator(this, function (_b) {
-        switch (_b.label) {
-            case 0:
-                expirationMs = (_a = config.expirationMs) !== null && _a !== void 0 ? _a : constants_1.ONE_DAY_IN_MS;
-                _b.label = 1;
-            case 1:
-                _b.trys.push([1, 3, , 4]);
-                sync = (0, exports.getCachedDataSync)(config.cacheKey, expirationMs);
-                if (sync &&
-                    sync.count > 0 &&
-                    Array.isArray(sync.items) &&
-                    sync.items.length > 0) {
-                    return [2 /*return*/, sync];
-                }
-                return [4 /*yield*/, (0, exports.getCachedData)({ config: config, params: params, headers: headers })];
-            case 2: 
-            // Sync cache empty — fetch from API and return result
-            return [2 /*return*/, _b.sent()];
-            case 3:
-                error_3 = _b.sent();
-                console.error("Error in getCachedDataWithFallback for ".concat(config.cacheKey, ":"), error_3);
-                return [2 /*return*/, { count: 0, items: [] }];
-            case 4: return [2 /*return*/];
-        }
-    });
-}); };
-exports.getCachedDataWithFallback = getCachedDataWithFallback;
-/**
- * Async variant to get a single item by ID with API fallback.
- *
- * Unlike `getCachedItemById` (sync), this function will call the API
- * (via `getCachedDataWithFallback`) when the item is not available in
- * the local cache. Requires a full `CacheConfig` so the API URL is
- * available for fetching.
- */
-var getCachedItemByIdAsync = function (config, itemId, params, headers) { return __awaiter(void 0, void 0, void 0, function () {
-    var raw, found, list, error_4;
-    return __generator(this, function (_a) {
-        switch (_a.label) {
-            case 0:
-                if (!itemId)
-                    return [2 /*return*/, null];
-                _a.label = 1;
-            case 1:
-                _a.trys.push([1, 3, , 4]);
-                raw = (0, local_storage_1.getStorageValue)(config.cacheKey);
-                if (isCachedArrayShape(raw)) {
-                    found = raw.items.find(function (i) { return i.id === itemId; });
-                    if (found)
-                        return [2 /*return*/, found];
-                }
-                if (isCachedMapShape(raw)) {
-                    if (raw.items && raw.items[itemId])
-                        return [2 /*return*/, raw.items[itemId]];
-                }
-                return [4 /*yield*/, (0, exports.getCachedDataWithFallback)(config, params, headers)];
-            case 2:
-                list = _a.sent();
-                return [2 /*return*/, list.items.find(function (i) { return i.id === itemId; }) || null];
-            case 3:
-                error_4 = _a.sent();
-                console.error("Error in getCachedItemByIdAsync for ".concat(config.cacheKey, ":"), error_4);
-                return [2 /*return*/, null];
-            case 4: return [2 /*return*/];
-        }
-    });
-}); };
-exports.getCachedItemByIdAsync = getCachedItemByIdAsync;
-// ============================================================================
-// 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: 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 raw = (0, local_storage_1.getStorageValue)(cacheKey);
-        if (raw == null)
-            return true;
-        if (isCachedArrayShape(raw) || isCachedMapShape(raw)) {
-            var cachedTime = new Date(raw.cachedAt).getTime();
-            var currentTime = new Date().getTime();
-            var ageInMs = currentTime - cachedTime;
-            return ageInMs >= expirationMs;
-        }
-        return true;
-    }
-    catch (error) {
-        console.error("Error checking cache staleness for ".concat(cacheKey, ":"), error);
-        return true;
-    }
-};
-exports.isCacheStale = isCacheStale;
+var U=Object.defineProperty;var ue=Object.getOwnPropertyDescriptor;var ge=Object.getOwnPropertyNames;var de=Object.prototype.hasOwnProperty;var me=(t,n)=>{for(var e in n)U(t,e,{get:n[e],enumerable:!0})},he=(t,n,e,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of ge(n))!de.call(t,r)&&r!==e&&U(t,r,{get:()=>n[r],enumerable:!(s=ue(n,r))||s.enumerable});return t};var le=t=>he(U({},"__esModule",{value:!0}),t);var Re={};me(Re,{getCachedData:()=>v,getCachedDataSync:()=>G,getCachedDataWithFallback:()=>Z,getCachedItemById:()=>fe,getCachedItemByIdAsync:()=>ye,getCachedSingleItem:()=>pe,getCachedSingleItemSync:()=>Te,invalidateCache:()=>Ce,isCacheStale:()=>Pe,preloadCache:()=>we});module.exports=le(Re);var I=require("../constants/api-methods"),P=require("../constants/cache-time"),x=require("./fetch-data"),T=require("../local-storage/get-storage-value"),$=require("../local-storage/set-storage-value");function k(t){if(!t||typeof t!="object")return!1;const n=t;return Array.isArray(n.items)&&typeof n.cachedAt=="string"&&typeof n.count=="number"}function M(t){if(!t||typeof t!="object")return!1;const n=t;return n.items!==void 0&&typeof n.items=="object"&&!Array.isArray(n.items)&&typeof n.cachedAt=="string"}const G=(t,n=P.ONE_DAY_IN_MS)=>{try{const e=(0,T.getStorageValue)(t);if(e==null)return{count:0,items:[]};const s=new Date().getTime();if(k(e)){const r=new Date(e.cachedAt).getTime();return s-r<n?{count:e.count??e.items.length,items:e.items,currentPage:e.currentPage??void 0}:{count:0,items:[]}}if(M(e)){const r=new Date(e.cachedAt).getTime();if(s-r<n){const a=Object.values(e.items||{});return{count:e.count??a.length,items:a,currentPage:e.currentPage??void 0}}return{count:0,items:[]}}return{count:0,items:[]}}catch(e){return console.error(`Error getting cached data for ${t}:`,e),{count:0,items:[]}}},v=async t=>{const{config:n,params:e,headers:s}=t,{cacheKey:r,apiUrl:u,responseKey:a}=n,p=n.expirationMs??P.ONE_DAY_IN_MS,D=e?.pageLimit?.toString()??"100",j=e?.currentPage?.toString()??"1",y=e?.filters,l=e?.searchQuery;try{if(l&&l.trim()||e?.filters){const o={...e||{}};o.filters!==void 0&&delete o.filters;const f=Object.keys(o).reduce((i,h)=>(i[h]=String(o[h]),i),{}),C={pageLimit:D,currentPage:j,...l&&{searchQuery:l},...y?Object.keys(y).reduce((i,h)=>(i[h]=String(y[h]),i),{}):{},...f},R=new URLSearchParams(C),d=await(0,x.fetchData)({url:`${u}?${R.toString()}`,method:I.API_METHODS.GET,headers:s}),g=a?d?.data?.[a]:d?.data?.items||d?.data,m=Array.isArray(g)?g:[],A=d?.data?.currentPage,N=A==null?void 0:Number(A),q=e?.currentPage?Number(e.currentPage):void 0;return{count:d?.data?.count||m.length,items:m,currentPage:N??q}}const c=(0,T.getStorageValue)(r),B=new Date().getTime();if(k(c)){const o=new Date(c.cachedAt).getTime();if(B-o<p)return{count:c.count,items:c.items,currentPage:c.currentPage??void 0}}if(M(c)){const o=new Date(c.cachedAt).getTime();if(B-o<p){const C=Object.values(c.items||{}),R=c.count,d=c.currentPage,g=e?.currentPage?Number(e.currentPage):void 0;if(g!==void 0&&g!==d){const m={...e||{}};m.filters!==void 0&&delete m.filters;const A=Object.keys(m).reduce((w,S)=>(w[S]=String(m[S]),w),{}),N={pageLimit:D,currentPage:String(g),...A},q=new URLSearchParams(N),i=await(0,x.fetchData)({url:`${u}?${q.toString()}`,method:I.API_METHODS.GET,headers:s}),h=(a?i?.data?.[a]:i?.data?.items)||i?.data,re=Array.isArray(h)?h:[],Q=i?.data?.count,V=i?.data?.currentPage,se=V==null?void 0:Number(V),ae=re.reduce((w,S,ce)=>{const X=S,oe=X?.id??X?.uid??ce,ie=String(oe);return w[ie]=S,w},{}),H=Object.assign({},c.items||{},ae),Y=Object.values(H),z=Q??Y.length,J=se??g;if(Array.isArray(h)&&typeof Q=="number"){const w={items:H,cachedAt:new Date().toISOString(),count:z,currentPage:J};(0,$.setStorageValue)(r,w)}return{count:z,items:Y,currentPage:J}}return{count:R??C.length,items:C,currentPage:c.currentPage??void 0}}}const O={...e||{}};O.filters!==void 0&&delete O.filters;const ee=Object.keys(O).reduce((o,f)=>(o[f]=String(O[f]),o),{}),te={pageLimit:D,currentPage:j,...ee},ne=new URLSearchParams(te),b=await(0,x.fetchData)({url:`${u}?${ne.toString()}`,method:I.API_METHODS.GET,headers:s}),E=(a?b?.data?.[a]:b?.data?.items)||b?.data,F=Array.isArray(E)?E:[],L=b?.data?.count,W=b?.data?.currentPage,_=W==null?void 0:Number(W),K=e?.currentPage?Number(e.currentPage):void 0;if(Array.isArray(E)&&typeof L=="number"){const f={items:F.reduce((C,R,d)=>{const g=R,m=g?.id??g?.uid??d,A=String(m);return C[A]=R,C},{}),cachedAt:new Date().toISOString(),count:L,currentPage:_??K};(0,$.setStorageValue)(r,f)}return{count:L,items:F,currentPage:_??K}}catch(c){return console.error(`Error fetching data for ${r}:`,c),{count:0,items:[]}}},fe=(t,n)=>{if(!n)return null;try{const e=(0,T.getStorageValue)(t);if(k(e))return e.items.find(r=>r.id===n)||null;if(M(e))return e.items&&e.items[n]||null;const{items:s}=G(t);return s.find(r=>r.id===n)||null}catch(e){return console.error(`Error getting cached item by ID for ${t}:`,e),null}},Te=(t,n=P.ONE_DAY_IN_MS)=>{try{const e=(0,T.getStorageValue)(t);if(!e)return null;const s=new Date().getTime(),r=new Date(e.cachedAt).getTime();return s-r<n?e.item:null}catch(e){return console.error(`Error getting cached single item for ${t}:`,e),null}},pe=async(t,n,e)=>{const{cacheKey:s,apiUrl:r}=t,u=t.expirationMs??P.ONE_DAY_IN_MS;try{const a=(0,T.getStorageValue)(s),p=new Date().getTime();if(a){const l=new Date(a.cachedAt).getTime();if(p-l<u)return a.item}const D=n?`?${new URLSearchParams(n).toString()}`:"",y=(await(0,x.fetchData)({url:`${r}${D}`,method:I.API_METHODS.GET,headers:e}))?.data||null;if(y){const l={item:y,cachedAt:new Date().toISOString()};(0,$.setStorageValue)(s,l)}return y}catch(a){return console.error(`Error fetching single item for ${s}:`,a),null}},Z=async(t,n,e)=>{const s=t.expirationMs??P.ONE_DAY_IN_MS;try{const r=G(t.cacheKey,s);return r&&r.count>0&&Array.isArray(r.items)&&r.items.length>0?r:await v({config:t,params:n,headers:e})}catch(r){return console.error(`Error in getCachedDataWithFallback for ${t.cacheKey}:`,r),{count:0,items:[]}}},ye=async(t,n,e,s)=>{if(!n)return null;try{const r=(0,T.getStorageValue)(t.cacheKey);if(k(r)){const a=r.items.find(p=>p.id===n);if(a)return a}return M(r)&&r.items&&r.items[n]?r.items[n]:(await Z(t,e,s)).items.find(a=>a.id===n)||null}catch(r){return console.error(`Error in getCachedItemByIdAsync for ${t.cacheKey}:`,r),null}},Ce=t=>{try{localStorage.removeItem(t)}catch(n){console.error(`Error invalidating cache for ${t}:`,n)}},we=async t=>v({config:t}),Pe=(t,n=P.ONE_DAY_IN_MS)=>{try{const e=(0,T.getStorageValue)(t);if(e==null)return!0;if(k(e)||M(e)){const s=new Date(e.cachedAt).getTime();return new Date().getTime()-s>=n}return!0}catch(e){return console.error(`Error checking cache staleness for ${t}:`,e),!0}};0&&(module.exports={getCachedData,getCachedDataSync,getCachedDataWithFallback,getCachedItemById,getCachedItemByIdAsync,getCachedSingleItem,getCachedSingleItemSync,invalidateCache,isCacheStale,preloadCache});