@react-pakistan/util-functions 1.24.99 → 1.25.0

package/api/stellar-solutions/app-user/index.d.ts

@@ -1,4 +1,4 @@
-import { AppUserTypeBE } from '../type';
+import { AppUserBE } from '../type';
 type PrismaClient = any;
 export interface ListAppUserArgs {
     currentPage?: number;
@@ -26,26 +26,26 @@ export interface DeleteAppUserArgs {
 /**
  * Retrieves all app users from the database with pagination
  * @param {ListAppUserArgs} args - Object containing prisma client, pagination, and query options
- * @returns {Promise<[number, Array<AppUserTypeBE>]>} Tuple of [total count, array of app users]
+ * @returns {Promise<[number, Array<AppUserBE>]>} Tuple of [total count, array of app users]
  */
-export declare const listAppUser: ({ currentPage, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListAppUserArgs) => Promise<[number, Array<AppUserTypeBE>]>;
+export declare const listAppUser: ({ currentPage, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListAppUserArgs) => Promise<[number, Array<AppUserBE>]>;
 /**
  * Retrieves a single app user by ID
  * @param {UnitAppUserByIdArgs} args - Object containing prisma client and user query
- * @returns {Promise<AppUserTypeBE | null>} App user if found, null otherwise
+ * @returns {Promise<AppUserBE | null>} App user if found, null otherwise
  */
-export declare const unitAppUserById: ({ id, prisma, }: UnitAppUserByIdArgs) => Promise<AppUserTypeBE | null>;
+export declare const unitAppUserById: ({ id, prisma, }: UnitAppUserByIdArgs) => Promise<AppUserBE | null>;
 /**
  * Creates a new app user or updates an existing one
  * @param {UpdateAppUserArgs} args - Object containing prisma client and user data
- * @returns {Promise<AppUserTypeBE>} Created or updated app user
+ * @returns {Promise<AppUserBE>} Created or updated app user
  */
-export declare const updateAppUser: ({ email, firstName, id, lastName, prisma, }: UpdateAppUserArgs) => Promise<AppUserTypeBE>;
+export declare const updateAppUser: ({ email, firstName, id, lastName, prisma, }: UpdateAppUserArgs) => Promise<AppUserBE>;
 /**
  * Deletes an app user by ID
  * @param {DeleteAppUserArgs} args - Object containing prisma client and user query
- * @returns {Promise<AppUserTypeBE>} Deleted app user
+ * @returns {Promise<AppUserBE>} Deleted app user
  * @throws {Error} If user ID is not provided or user not found
  */
-export declare const deleteAppUser: ({ id, prisma, }: DeleteAppUserArgs) => Promise<AppUserTypeBE>;
+export declare const deleteAppUser: ({ id, prisma, }: DeleteAppUserArgs) => Promise<AppUserBE>;
 export {};

package/api/stellar-solutions/app-user/index.js

@@ -61,7 +61,7 @@ var general_1 = require("../../../general");
 /**
  * Retrieves all app users from the database with pagination
  * @param {ListAppUserArgs} args - Object containing prisma client, pagination, and query options
- * @returns {Promise<[number, Array<AppUserTypeBE>]>} Tuple of [total count, array of app users]
+ * @returns {Promise<[number, Array<AppUserBE>]>} Tuple of [total count, array of app users]
  */
 var listAppUser = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var orderBy, idSearchQuery, emailSearchQuery, firstNameSearchQuery, lastNameSearchQuery, where, _c, count, items;
@@ -119,7 +119,7 @@ exports.listAppUser = listAppUser;
 /**
  * Retrieves a single app user by ID
  * @param {UnitAppUserByIdArgs} args - Object containing prisma client and user query
- * @returns {Promise<AppUserTypeBE | null>} App user if found, null otherwise
+ * @returns {Promise<AppUserBE | null>} App user if found, null otherwise
  */
 var unitAppUserById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var where, appUser;
@@ -146,7 +146,7 @@ exports.unitAppUserById = unitAppUserById;
 /**
  * Creates a new app user or updates an existing one
  * @param {UpdateAppUserArgs} args - Object containing prisma client and user data
- * @returns {Promise<AppUserTypeBE>} Created or updated app user
+ * @returns {Promise<AppUserBE>} Created or updated app user
  */
 var updateAppUser = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var userData, where, appUser;
@@ -183,7 +183,7 @@ exports.updateAppUser = updateAppUser;
 /**
  * Deletes an app user by ID
  * @param {DeleteAppUserArgs} args - Object containing prisma client and user query
- * @returns {Promise<AppUserTypeBE>} Deleted app user
+ * @returns {Promise<AppUserBE>} Deleted app user
  * @throws {Error} If user ID is not provided or user not found
  */
 var deleteAppUser = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {

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

@@ -0,0 +1,99 @@
+import { BankBE } from '../type';
+/**
+ * Synchronous utility function to get banks from cache only
+ * Returns cached data immediately if available and fresh, otherwise returns empty array
+ * Does not trigger any API calls
+ *
+ * @returns BankBE[] - Array of cached banks or empty array wrapper ({count, items})
+ *
+ * @example
+ * const banks = getCachedBanksSync();
+ * if (banks.items.length > 0) {
+ *   console.log(banks.items[0].bankName);
+ * }
+ */
+export declare const getCachedBanksSync: () => {
+    count: number;
+    items: BankBE[];
+};
+/**
+ * Utility function to get banks from cache or fetch from API
+ *
+ * This function manages a localStorage cache of banks with the following logic:
+ * - If banks exist in cache and are less than 1 week old, return cached version
+ * - If banks exist but are older than 1 week, fetch fresh data and update cache
+ * - If banks don't exist in cache, fetch from API and cache them
+ *
+ * @returns Promise<{count:number, items: BankBE[]}> - Paged banks
+ *
+ * @example
+ * const banks = await getCachedBanks();
+ * console.log(banks.items[0].bankName);
+ */
+export declare const getCachedBanks: () => Promise<{
+    count: number;
+    items: BankBE[];
+}>;
+/**
+ * Utility function to get a specific bank by ID from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param bankId - The ID of the bank to retrieve
+ * @returns BankBE | null - The bank or null if not found
+ *
+ * @example
+ * const bank = getCachedBankById('bank-123');
+ * if (bank) {
+ *   console.log(bank.bankName);
+ * }
+ */
+export declare const getCachedBankById: (bankId: string) => BankBE | null;
+/**
+ * Utility function to get a specific bank by account number from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param accountNumber - The account number of the bank to retrieve
+ * @returns BankBE | null - The bank or null if not found
+ *
+ * @example
+ * const bank = getCachedBankByAccountNumber('1234567890');
+ * if (bank) {
+ *   console.log(bank.bankName);
+ * }
+ */
+export declare const getCachedBankByAccountNumber: (accountNumber: string) => BankBE | null;
+/**
+ * Utility function to invalidate (remove) banks from cache
+ * Useful when banks have been updated and you want to force a refresh
+ *
+ * @example
+ * invalidateBanksCache();
+ * const freshBanks = await getCachedBanks();
+ */
+export declare const invalidateBanksCache: () => void;
+/**
+ * Utility function to preload banks into cache
+ * Useful to call on app initialization or login
+ *
+ * @returns Promise<{count:number, items: BankBE[]}> - Array of preloaded banks
+ *
+ * @example
+ * // On app initialization
+ * await preloadBanks();
+ */
+export declare const preloadBanks: () => Promise<{
+    count: number;
+    items: BankBE[];
+}>;
+/**
+ * Utility function to check if banks 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 (isBanksCacheStale()) {
+ *   await getCachedBanks(); // This will fetch fresh data
+ * }
+ */
+export declare const isBanksCacheStale: () => boolean;

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

@@ -0,0 +1,256 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBanksCacheStale = exports.preloadBanks = exports.invalidateBanksCache = exports.getCachedBankByAccountNumber = exports.getCachedBankById = exports.getCachedBanks = exports.getCachedBanksSync = 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 banks from cache only
+ * Returns cached data immediately if available and fresh, otherwise returns empty array
+ * Does not trigger any API calls
+ *
+ * @returns BankBE[] - Array of cached banks or empty array wrapper ({count, items})
+ *
+ * @example
+ * const banks = getCachedBanksSync();
+ * if (banks.items.length > 0) {
+ *   console.log(banks.items[0].bankName);
+ * }
+ */
+var getCachedBanksSync = function () {
+    try {
+        var cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.BANKS);
+        if (!cachedData) {
+            return { count: 0, items: [] };
+        }
+        var currentTime = new Date().getTime();
+        var cachedTime = new Date(cachedData.cachedAt).getTime();
+        var ageInMs = currentTime - cachedTime;
+        // If cached data is less than 1 week old, return it
+        if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+            return {
+                count: cachedData.banks.length,
+                items: cachedData.banks,
+            };
+        }
+        return { count: 0, items: [] };
+    }
+    catch (error) {
+        console.error('Error getting cached banks:', error);
+        return { count: 0, items: [] };
+    }
+};
+exports.getCachedBanksSync = getCachedBanksSync;
+/**
+ * Utility function to get banks from cache or fetch from API
+ *
+ * This function manages a localStorage cache of banks with the following logic:
+ * - If banks exist in cache and are less than 1 week old, return cached version
+ * - If banks exist but are older than 1 week, fetch fresh data and update cache
+ * - If banks don't exist in cache, fetch from API and cache them
+ *
+ * @returns Promise<{count:number, items: BankBE[]}> - Paged banks
+ *
+ * @example
+ * const banks = await getCachedBanks();
+ * console.log(banks.items[0].bankName);
+ */
+var getCachedBanks = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var cachedData, currentTime, cachedTime, ageInMs, response, updatedCache, error_1;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                _b.trys.push([0, 2, , 3]);
+                cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.BANKS);
+                currentTime = new Date().getTime();
+                // Check if cached data exists and is still fresh
+                if (cachedData) {
+                    cachedTime = new Date(cachedData.cachedAt).getTime();
+                    ageInMs = currentTime - cachedTime;
+                    // If cached data is less than 1 week old, return it
+                    if (ageInMs < constants_1.ONE_WEEK_IN_MS) {
+                        return [2 /*return*/, {
+                                count: cachedData.banks.length,
+                                items: cachedData.banks,
+                            }];
+                    }
+                }
+                return [4 /*yield*/, (0, fetch_data_1.fetchData)({
+                        url: constants_1.API_ROUTES.BANKS,
+                        method: api_methods_1.API_METHODS.GET,
+                    })];
+            case 1:
+                response = _b.sent();
+                if ((_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.items) {
+                    updatedCache = {
+                        banks: response.data.items,
+                        cachedAt: new Date().toISOString(),
+                    };
+                    (0, set_storage_value_1.setStorageValue)(type_1.LS_KEYS.BANKS, updatedCache);
+                    return [2 /*return*/, response.data];
+                }
+                return [2 /*return*/, { count: 0, items: [] }];
+            case 2:
+                error_1 = _b.sent();
+                console.error('Error fetching banks:', error_1);
+                return [2 /*return*/, { count: 0, items: [] }];
+            case 3: return [2 /*return*/];
+        }
+    });
+}); };
+exports.getCachedBanks = getCachedBanks;
+/**
+ * Utility function to get a specific bank by ID from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param bankId - The ID of the bank to retrieve
+ * @returns BankBE | null - The bank or null if not found
+ *
+ * @example
+ * const bank = getCachedBankById('bank-123');
+ * if (bank) {
+ *   console.log(bank.bankName);
+ * }
+ */
+var getCachedBankById = function (bankId) {
+    if (!bankId) {
+        return null;
+    }
+    try {
+        var banks = (0, exports.getCachedBanksSync)().items;
+        return banks.find(function (bank) { return bank.id === bankId; }) || null;
+    }
+    catch (error) {
+        console.error('Error getting cached bank by ID:', error);
+        return null;
+    }
+};
+exports.getCachedBankById = getCachedBankById;
+/**
+ * Utility function to get a specific bank by account number from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param accountNumber - The account number of the bank to retrieve
+ * @returns BankBE | null - The bank or null if not found
+ *
+ * @example
+ * const bank = getCachedBankByAccountNumber('1234567890');
+ * if (bank) {
+ *   console.log(bank.bankName);
+ * }
+ */
+var getCachedBankByAccountNumber = function (accountNumber) {
+    if (!accountNumber) {
+        return null;
+    }
+    try {
+        var banks = (0, exports.getCachedBanksSync)().items;
+        return banks.find(function (bank) { return bank.accountNumber === accountNumber; }) || null;
+    }
+    catch (error) {
+        console.error('Error getting cached bank by account number:', error);
+        return null;
+    }
+};
+exports.getCachedBankByAccountNumber = getCachedBankByAccountNumber;
+/**
+ * Utility function to invalidate (remove) banks from cache
+ * Useful when banks have been updated and you want to force a refresh
+ *
+ * @example
+ * invalidateBanksCache();
+ * const freshBanks = await getCachedBanks();
+ */
+var invalidateBanksCache = function () {
+    try {
+        localStorage.removeItem(type_1.LS_KEYS.BANKS);
+    }
+    catch (error) {
+        console.error('Error invalidating banks cache:', error);
+    }
+};
+exports.invalidateBanksCache = invalidateBanksCache;
+/**
+ * Utility function to preload banks into cache
+ * Useful to call on app initialization or login
+ *
+ * @returns Promise<{count:number, items: BankBE[]}> - Array of preloaded banks
+ *
+ * @example
+ * // On app initialization
+ * await preloadBanks();
+ */
+var preloadBanks = function () { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        return [2 /*return*/, (0, exports.getCachedBanks)()];
+    });
+}); };
+exports.preloadBanks = preloadBanks;
+/**
+ * Utility function to check if banks 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 (isBanksCacheStale()) {
+ *   await getCachedBanks(); // This will fetch fresh data
+ * }
+ */
+var isBanksCacheStale = function () {
+    try {
+        var cachedData = (0, get_storage_value_1.getStorageValue)(type_1.LS_KEYS.BANKS);
+        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_WEEK_IN_MS;
+    }
+    catch (error) {
+        console.error('Error checking banks cache staleness:', error);
+        return true;
+    }
+};
+exports.isBanksCacheStale = isBanksCacheStale;

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

@@ -1,4 +1,5 @@
-import { BankTypeBE } from '../type';
+export * from './cache';
+import { BankBE } from '../type';
 type PrismaClient = any;
 export interface ListBankArgs {
     currentPage?: number;
@@ -34,26 +35,25 @@ export interface DeleteBankArgs {
 /**
  * Retrieves all banks from the database with pagination
  * @param {ListBankArgs} args - Object containing prisma client, pagination, and filter options
- * @returns {Promise<[number, Array<BankTypeBE>]>} Tuple of [total count, array of banks]
+ * @returns {Promise<[number, Array<BankBE>]>} Tuple of [total count, array of banks]
  */
-export declare const listBank: ({ currentPage, includePreference, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListBankArgs) => Promise<[number, Array<BankTypeBE>]>;
+export declare const listBank: ({ currentPage, includePreference, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListBankArgs) => Promise<[number, Array<BankBE>]>;
 /**
  * Retrieves a single bank by ID
  * @param {UnitBankByIdArgs} args - Object containing prisma client and bank id
- * @returns {Promise<BankTypeBE | null>} Bank if found, null otherwise
+ * @returns {Promise<BankBE | null>} Bank if found, null otherwise
  */
-export declare const unitBankById: ({ id, includePreference, prisma, }: UnitBankByIdArgs) => Promise<BankTypeBE | null>;
+export declare const unitBankById: ({ id, includePreference, prisma, }: UnitBankByIdArgs) => Promise<BankBE | null>;
 /**
  * Creates a new bank or updates an existing one
  * @param {UpdateBankArgs} args - Object containing prisma client and bank data
- * @returns {Promise<BankTypeBE>} Created or updated bank
+ * @returns {Promise<BankBE>} Created or updated bank
  */
-export declare const updateBank: ({ accountNumber, accountTitle, bankAddress, bankName, enabled, iban, id, isDefault, preferenceId, prisma, swiftCode, }: UpdateBankArgs) => Promise<BankTypeBE>;
+export declare const updateBank: ({ accountNumber, accountTitle, bankAddress, bankName, enabled, iban, id, isDefault, preferenceId, prisma, swiftCode, }: UpdateBankArgs) => Promise<BankBE>;
 /**
  * Deletes a bank by ID
  * @param {DeleteBankArgs} args - Object containing prisma client and bank id
- * @returns {Promise<BankTypeBE>} Deleted bank
+ * @returns {Promise<BankBE>} Deleted bank
  * @throws {Error} If bank ID is not provided or bank not found
  */
-export declare const deleteBank: ({ prisma, id, }: DeleteBankArgs) => Promise<BankTypeBE>;
-export {};
+export declare const deleteBank: ({ prisma, id, }: DeleteBankArgs) => Promise<BankBE>;

package/api/stellar-solutions/bank/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,11 +71,12 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteBank = exports.updateBank = exports.unitBankById = exports.listBank = void 0;
+__exportStar(require("./cache"), exports);
 var multi_part_search_1 = require("../../../general/multi-part-search");
 /**
  * Retrieves all banks from the database with pagination
  * @param {ListBankArgs} args - Object containing prisma client, pagination, and filter options
- * @returns {Promise<[number, Array<BankTypeBE>]>} Tuple of [total count, array of banks]
+ * @returns {Promise<[number, Array<BankBE>]>} Tuple of [total count, array of banks]
  */
 var listBank = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, orderBy, idSearchQuery, bankNameSearchQuery, where, _c, count, items;
@@ -115,7 +130,7 @@ exports.listBank = listBank;
 /**
  * Retrieves a single bank by ID
  * @param {UnitBankByIdArgs} args - Object containing prisma client and bank id
- * @returns {Promise<BankTypeBE | null>} Bank if found, null otherwise
+ * @returns {Promise<BankBE | null>} Bank if found, null otherwise
  */
 var unitBankById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, where, bank;
@@ -144,7 +159,7 @@ exports.unitBankById = unitBankById;
 /**
  * Creates a new bank or updates an existing one
  * @param {UpdateBankArgs} args - Object containing prisma client and bank data
- * @returns {Promise<BankTypeBE>} Created or updated bank
+ * @returns {Promise<BankBE>} Created or updated bank
  */
 var updateBank = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var bankData, where, bank;
@@ -185,7 +200,7 @@ exports.updateBank = updateBank;
 /**
  * Deletes a bank by ID
  * @param {DeleteBankArgs} args - Object containing prisma client and bank id
- * @returns {Promise<BankTypeBE>} Deleted bank
+ * @returns {Promise<BankBE>} Deleted bank
  * @throws {Error} If bank ID is not provided or bank not found
  */
 var deleteBank = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {

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

@@ -0,0 +1,97 @@
+import { BranchBE } from '../type';
+/**
+ * Synchronous utility function to get branches from cache only
+ * Returns cached data immediately if available and fresh, otherwise returns empty array
+ * Does not trigger any API calls
+ *
+ * @returns BranchBE[] - Array of cached branches or empty array wrapper ({count, items})
+ *
+ * @example
+ * const branches = getCachedBranchesSync();
+ * if (branches.items.length > 0) {
+ *   console.log(branches.items[0].branchName);
+ * }
+ */
+export declare const getCachedBranchesSync: () => {
+    count: number;
+    items: BranchBE[];
+};
+/**
+ * Utility function to get branches from cache or fetch from API
+ *
+ * This function manages a localStorage cache of branches with the following logic:
+ * - If branches exist in cache and are less than 1 week old, return cached version
+ * - If branches exist but are older than 1 week, fetch fresh data and update cache
+ * - If branches don't exist in cache, fetch from API and cache them
+ *
+ * @returns Promise<{count:number, items: BranchBE[]}> - Paged branches
+ *
+ * @example
+ * const branches = await getCachedBranches();
+ * console.log(branches.items[0].branchName);
+ */
+export declare const getCachedBranches: () => Promise<{
+    count: number;
+    items: BranchBE[];
+}>;
+/**
+ * Utility function to get a specific branch by ID from cache
+ * If not found in cache, returns null (does not trigger API call)
+ *
+ * @param branchId - The ID of the branch to retrieve
+ * @returns BranchBE | null - The branch or null if not found
+ *
+ * @example
+ * const branch = getCachedBranchById('branch-123');
+ * if (branch) {
+ *   console.log(branch.branchName);
+ * }
+ */
+export declare const getCachedBranchById: (branchId: string) => BranchBE | null;
+/**
+ * Utility function to get branches by name from cache
+ * If not found in cache, returns empty array (does not trigger API call)
+ *
+ * @param branchName - The name of the branch to search for
+ * @returns BranchBE[] - Array of matching branches or empty array
+ *
+ * @example
+ * const branches = getCachedBranchesByName('Main Branch');
+ * console.log(branches.length);
+ */
+export declare const getCachedBranchesByName: (branchName: string) => BranchBE[];
+/**
+ * Utility function to invalidate (remove) branches from cache
+ * Useful when branches have been updated and you want to force a refresh
+ *
+ * @example
+ * invalidateBranchesCache();
+ * const freshBranches = await getCachedBranches();
+ */
+export declare const invalidateBranchesCache: () => void;
+/**
+ * Utility function to preload branches into cache
+ * Useful to call on app initialization or login
+ *
+ * @returns Promise<{count:number, items: BranchBE[]}> - Array of preloaded branches
+ *
+ * @example
+ * // On app initialization
+ * await preloadBranches();
+ */
+export declare const preloadBranches: () => Promise<{
+    count: number;
+    items: BranchBE[];
+}>;
+/**
+ * Utility function to check if branches 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 (isBranchesCacheStale()) {
+ *   await getCachedBranches(); // This will fetch fresh data
+ * }
+ */
+export declare const isBranchesCacheStale: () => boolean;