@react-pakistan/util-functions 1.24.99 → 1.25.1

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

@@ -76,7 +76,7 @@ var multi_part_search_1 = require("../../../general/multi-part-search");
 /**
  * Retrieves a paginated list of product categories
  * @param {ListProductCategoryArgs} args - Object containing prisma client, pagination, filtering, and ordering options
- * @returns {Promise<[number, Array<ProductCategoryTypeBE>]>} Tuple containing total count and array of product categories
+ * @returns {Promise<[number, Array<ProductCategoryBE>]>} Tuple containing total count and array of product categories
  */
 var listProductCategory = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, orderBy, idSearchQuery, nameSearchQuery, descriptionSearchQuery, where, _c, count, items;
@@ -134,7 +134,7 @@ exports.listProductCategory = listProductCategory;
 /**
  * Retrieves a single product category by its ID
  * @param {UnitProductCategoryByIdArgs} args - Object containing prisma client, product category ID, and optional query parameters
- * @returns {Promise<ProductCategoryTypeBE | null>} Product category or null if not found
+ * @returns {Promise<ProductCategoryBE | null>} Product category or null if not found
  */
 var unitProductCategoryById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, where, productCategory;
@@ -165,7 +165,7 @@ exports.unitProductCategoryById = unitProductCategoryById;
 /**
  * Creates or updates a product category
  * @param {UpdateProductCategoryArgs} args - Object containing prisma client, product category data, and optional query parameters
- * @returns {Promise<ProductCategoryTypeBE>} Created or updated product category
+ * @returns {Promise<ProductCategoryBE>} Created or updated product category
  */
 var updateProductCategory = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var productCategoryData, where, productCategory;
@@ -201,7 +201,7 @@ exports.updateProductCategory = updateProductCategory;
 /**
  * Deletes a product category by ID
  * @param {DeleteProductCategoryArgs} args - Object containing prisma client, product category ID, and optional query parameters
- * @returns {Promise<ProductCategoryTypeBE>} Deleted product category
+ * @returns {Promise<ProductCategoryBE>} Deleted product category
  */
 var deleteProductCategory = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var where, productCategory;

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

@@ -1,4 +1,4 @@
-import { ProfileTypeBE } from '../type';
+import { ProfileBE } from '../type';
 type PrismaClient = any;
 interface GetProfilesArgs {
     orderByColumn?: string;
@@ -42,37 +42,37 @@ interface DeleteProfileArgs {
 /**
  * Retrieves all profiles
  * @param {GetProfilesArgs} args - Object containing prisma client
- * @returns {Promise<Array<ProfileTypeBE>>} Array of profiles ordered by creation date (newest first)
+ * @returns {Promise<Array<ProfileBE>>} Array of profiles ordered by creation date (newest first)
  */
-export declare const getProfiles: ({ orderByColumn, orderByDirection, prisma, }: GetProfilesArgs) => Promise<Array<ProfileTypeBE>>;
+export declare const getProfiles: ({ orderByColumn, orderByDirection, prisma, }: GetProfilesArgs) => Promise<Array<ProfileBE>>;
 /**
  * Retrieves a profile by its ID
  * @param {GetProfileByIdArgs} args - Object containing prisma client and profile ID
- * @returns {Promise<ProfileTypeBE | null>} Profile or null if not found
+ * @returns {Promise<ProfileBE | null>} Profile or null if not found
  */
-export declare const getProfileById: ({ prisma, id, }: GetProfileByIdArgs) => Promise<ProfileTypeBE | null>;
+export declare const getProfileById: ({ prisma, id, }: GetProfileByIdArgs) => Promise<ProfileBE | null>;
 /**
  * Retrieves a profile by user ID
  * @param {GetProfileByUserIdArgs} args - Object containing prisma client and user ID
- * @returns {Promise<ProfileTypeBE | null>} Profile or null if not found
+ * @returns {Promise<ProfileBE | null>} Profile or null if not found
  */
-export declare const getProfileByUserId: ({ prisma, userId, }: GetProfileByUserIdArgs) => Promise<ProfileTypeBE | null>;
+export declare const getProfileByUserId: ({ prisma, userId, }: GetProfileByUserIdArgs) => Promise<ProfileBE | null>;
 /**
  * Retrieves paginated profiles with filtering
  * @param {PostProfilesArgs} args - Object containing prisma client, pagination, and filtering options
- * @returns {Promise<[number, Array<ProfileTypeBE>]>} Tuple of [total count, profiles array]
+ * @returns {Promise<[number, Array<ProfileBE>]>} Tuple of [total count, profiles array]
  */
-export declare const postProfiles: ({ currentPage, orderByColumn, orderByDirection, pageLimit, prisma, }: PostProfilesArgs) => Promise<[number, Array<ProfileTypeBE>]>;
+export declare const postProfiles: ({ currentPage, orderByColumn, orderByDirection, pageLimit, prisma, }: PostProfilesArgs) => Promise<[number, Array<ProfileBE>]>;
 /**
  * Creates a new profile or updates an existing one
  * @param {PostProfileArgs} args - Object containing prisma client and profile data
- * @returns {Promise<ProfileTypeBE>} Created or updated profile
+ * @returns {Promise<ProfileBE>} Created or updated profile
  */
-export declare const postProfile: ({ avatar, dob, email, firstName, gender, id, language, lastName, location, phone, prisma, skill, userId, }: PostProfileArgs) => Promise<ProfileTypeBE>;
+export declare const postProfile: ({ avatar, dob, email, firstName, gender, id, language, lastName, location, phone, prisma, skill, userId, }: PostProfileArgs) => Promise<ProfileBE>;
 /**
  * Deletes a profile by ID
  * @param {DeleteProfileArgs} args - Object containing prisma client and profile ID
- * @returns {Promise<ProfileTypeBE>} Deleted profile
+ * @returns {Promise<ProfileBE>} Deleted profile
  */
-export declare const deleteProfile: ({ prisma, id, }: DeleteProfileArgs) => Promise<ProfileTypeBE>;
+export declare const deleteProfile: ({ prisma, id, }: DeleteProfileArgs) => Promise<ProfileBE>;
 export {};

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

@@ -51,7 +51,7 @@ exports.deleteProfile = exports.postProfile = exports.postProfiles = exports.get
 /**
  * Retrieves all profiles
  * @param {GetProfilesArgs} args - Object containing prisma client
- * @returns {Promise<Array<ProfileTypeBE>>} Array of profiles ordered by creation date (newest first)
+ * @returns {Promise<Array<ProfileBE>>} Array of profiles ordered by creation date (newest first)
  */
 var getProfiles = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var profiles;
@@ -74,7 +74,7 @@ exports.getProfiles = getProfiles;
 /**
  * Retrieves a profile by its ID
  * @param {GetProfileByIdArgs} args - Object containing prisma client and profile ID
- * @returns {Promise<ProfileTypeBE | null>} Profile or null if not found
+ * @returns {Promise<ProfileBE | null>} Profile or null if not found
  */
 var getProfileById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var profile;
@@ -100,7 +100,7 @@ exports.getProfileById = getProfileById;
 /**
  * Retrieves a profile by user ID
  * @param {GetProfileByUserIdArgs} args - Object containing prisma client and user ID
- * @returns {Promise<ProfileTypeBE | null>} Profile or null if not found
+ * @returns {Promise<ProfileBE | null>} Profile or null if not found
  */
 var getProfileByUserId = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var profile;
@@ -126,7 +126,7 @@ exports.getProfileByUserId = getProfileByUserId;
 /**
  * Retrieves paginated profiles with filtering
  * @param {PostProfilesArgs} args - Object containing prisma client, pagination, and filtering options
- * @returns {Promise<[number, Array<ProfileTypeBE>]>} Tuple of [total count, profiles array]
+ * @returns {Promise<[number, Array<ProfileBE>]>} Tuple of [total count, profiles array]
  */
 var postProfiles = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var profiles;
@@ -161,7 +161,7 @@ exports.postProfiles = postProfiles;
 /**
  * Creates a new profile or updates an existing one
  * @param {PostProfileArgs} args - Object containing prisma client and profile data
- * @returns {Promise<ProfileTypeBE>} Created or updated profile
+ * @returns {Promise<ProfileBE>} Created or updated profile
  */
 var postProfile = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var profileData, profile_1, profile;
@@ -209,7 +209,7 @@ exports.postProfile = postProfile;
 /**
  * Deletes a profile by ID
  * @param {DeleteProfileArgs} args - Object containing prisma client and profile ID
- * @returns {Promise<ProfileTypeBE>} Deleted profile
+ * @returns {Promise<ProfileBE>} Deleted profile
  */
 var deleteProfile = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var profile;

package/api/stellar-solutions/quote-invoice/index.d.ts

@@ -1,4 +1,4 @@
-import { QUOTE_INVOICE_CATEGORY, QuoteInvoiceTypeBE } from '../type';
+import { QUOTE_INVOICE_CATEGORY, QuoteInvoiceBE } from '../type';
 type PrismaClient = any;
 export interface ListQuoteInvoiceArgs {
     category: QUOTE_INVOICE_CATEGORY;
@@ -72,26 +72,26 @@ export interface DeleteQuoteInvoiceArgs {
 /**
  * Retrieves a paginated list of quotes/invoices
  * @param {ListQuoteInvoiceArgs} args - Object containing prisma client, pagination, filtering, and ordering options
- * @returns {Promise<[number, Array<QuoteInvoiceTypeBE>]>} Tuple containing total count and array of quotes/invoices
+ * @returns {Promise<[number, Array<QuoteInvoiceBE>]>} Tuple containing total count and array of quotes/invoices
  */
-export declare const listQuoteInvoice: ({ category, currentPage, includeCompany, includeCustomer, includePayments, includeProducts, includeServices, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListQuoteInvoiceArgs) => Promise<[number, Array<QuoteInvoiceTypeBE>]>;
+export declare const listQuoteInvoice: ({ category, currentPage, includeCompany, includeCustomer, includePayments, includeProducts, includeServices, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListQuoteInvoiceArgs) => Promise<[number, Array<QuoteInvoiceBE>]>;
 /**
  * Retrieves a single quote/invoice by its ID
  * @param {UnitQuoteInvoiceByIdArgs} args - Object containing prisma client, quote/invoice ID, and optional query parameters
- * @returns {Promise<QuoteInvoiceTypeBE | null>} Quote/invoice or null if not found
+ * @returns {Promise<QuoteInvoiceBE | null>} Quote/invoice or null if not found
  */
-export declare const unitQuoteInvoiceById: ({ id, includeCompany, includeCustomer, includePayments, includeProducts, includeServices, prisma, }: UnitQuoteInvoiceByIdArgs) => Promise<QuoteInvoiceTypeBE | null>;
+export declare const unitQuoteInvoiceById: ({ id, includeCompany, includeCustomer, includePayments, includeProducts, includeServices, prisma, }: UnitQuoteInvoiceByIdArgs) => Promise<QuoteInvoiceBE | null>;
 /**
  * Creates or updates a quote/invoice
  * Handles complex business logic including customer/company associations and service management
  * @param {UpdateQuoteInvoiceArgs} args - Object containing prisma client, quote/invoice data, and optional query parameters
- * @returns {Promise<QuoteInvoiceTypeBE>} Created or updated quote/invoice
+ * @returns {Promise<QuoteInvoiceBE>} Created or updated quote/invoice
  */
-export declare const updateQuoteInvoice: ({ address, category, city, companyId, country, currency, customerId, date, discount, discountUnit, email, expiryDate, firstName, id, includeCompany, includeCustomer, includePayments, includeProducts, includeServices, invoiceStatus, lastName, mode, note, phone, prisma, products, quoteStatus, ref, services, subTotal, taxRate, total, }: UpdateQuoteInvoiceArgs) => Promise<QuoteInvoiceTypeBE>;
+export declare const updateQuoteInvoice: ({ address, category, city, companyId, country, currency, customerId, date, discount, discountUnit, email, expiryDate, firstName, id, includeCompany, includeCustomer, includePayments, includeProducts, includeServices, invoiceStatus, lastName, mode, note, phone, prisma, products, quoteStatus, ref, services, subTotal, taxRate, total, }: UpdateQuoteInvoiceArgs) => Promise<QuoteInvoiceBE>;
 /**
  * Deletes a quote/invoice by ID
  * @param {DeleteQuoteInvoiceArgs} args - Object containing prisma client, quote/invoice ID, and optional query parameters
- * @returns {Promise<QuoteInvoiceTypeBE>} Deleted quote/invoice
+ * @returns {Promise<QuoteInvoiceBE>} Deleted quote/invoice
  */
-export declare const deleteQuoteInvoice: ({ id, prisma, }: DeleteQuoteInvoiceArgs) => Promise<QuoteInvoiceTypeBE>;
+export declare const deleteQuoteInvoice: ({ id, prisma, }: DeleteQuoteInvoiceArgs) => Promise<QuoteInvoiceBE>;
 export {};

package/api/stellar-solutions/quote-invoice/index.js

@@ -61,7 +61,7 @@ var multi_part_search_1 = require("../../../general/multi-part-search");
 /**
  * Retrieves a paginated list of quotes/invoices
  * @param {ListQuoteInvoiceArgs} args - Object containing prisma client, pagination, filtering, and ordering options
- * @returns {Promise<[number, Array<QuoteInvoiceTypeBE>]>} Tuple containing total count and array of quotes/invoices
+ * @returns {Promise<[number, Array<QuoteInvoiceBE>]>} Tuple containing total count and array of quotes/invoices
  */
 var listQuoteInvoice = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, orderBy, idSearchQuery, noteSearchQuery, refSearchQuery, where, _c, count, items;
@@ -124,7 +124,7 @@ exports.listQuoteInvoice = listQuoteInvoice;
 /**
  * Retrieves a single quote/invoice by its ID
  * @param {UnitQuoteInvoiceByIdArgs} args - Object containing prisma client, quote/invoice ID, and optional query parameters
- * @returns {Promise<QuoteInvoiceTypeBE | null>} Quote/invoice or null if not found
+ * @returns {Promise<QuoteInvoiceBE | null>} Quote/invoice or null if not found
  */
 var unitQuoteInvoiceById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, where, quoteInvoice;
@@ -160,7 +160,7 @@ exports.unitQuoteInvoiceById = unitQuoteInvoiceById;
  * Creates or updates a quote/invoice
  * Handles complex business logic including customer/company associations and service management
  * @param {UpdateQuoteInvoiceArgs} args - Object containing prisma client, quote/invoice data, and optional query parameters
- * @returns {Promise<QuoteInvoiceTypeBE>} Created or updated quote/invoice
+ * @returns {Promise<QuoteInvoiceBE>} Created or updated quote/invoice
  */
 var updateQuoteInvoice = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, quoteInvoice, mappedServices, where, foundQuoteInvoice, filteredEditServices, filteredCreateServices;
@@ -343,7 +343,7 @@ exports.updateQuoteInvoice = updateQuoteInvoice;
 /**
  * Deletes a quote/invoice by ID
  * @param {DeleteQuoteInvoiceArgs} args - Object containing prisma client, quote/invoice ID, and optional query parameters
- * @returns {Promise<QuoteInvoiceTypeBE>} Deleted quote/invoice
+ * @returns {Promise<QuoteInvoiceBE>} Deleted quote/invoice
  */
 var deleteQuoteInvoice = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var where, quoteInvoice;

package/api/stellar-solutions/quote-invoice-report/index.d.ts

@@ -1,4 +1,4 @@
-import { QuoteInvoiceTypeBE } from '../type';
+import { QuoteInvoiceBE } from '../type';
 type PrismaClient = any;
 export interface PostQuotesInvoicesReportArgs {
     orderByColumn?: string;
@@ -9,7 +9,7 @@ export interface PostQuotesInvoicesReportArgs {
  * Generates a report of all quotes/invoices with sorting (no pagination)
  * Returns all records for reporting purposes
  * @param {PostQuotesInvoicesReportArgs} args - Object containing prisma client and sorting options
- * @returns {Promise<[number, Array<QuoteInvoiceTypeBE>]>} Tuple containing total count and array of all quotes/invoices
+ * @returns {Promise<[number, Array<QuoteInvoiceBE>]>} Tuple containing total count and array of all quotes/invoices
  */
-export declare const postQuotesInvoicesReport: ({ orderByColumn, orderByDirection, prisma, }: PostQuotesInvoicesReportArgs) => Promise<[number, Array<QuoteInvoiceTypeBE>]>;
+export declare const postQuotesInvoicesReport: ({ orderByColumn, orderByDirection, prisma, }: PostQuotesInvoicesReportArgs) => Promise<[number, Array<QuoteInvoiceBE>]>;
 export {};

package/api/stellar-solutions/quote-invoice-report/index.js

@@ -41,7 +41,7 @@ exports.postQuotesInvoicesReport = void 0;
  * Generates a report of all quotes/invoices with sorting (no pagination)
  * Returns all records for reporting purposes
  * @param {PostQuotesInvoicesReportArgs} args - Object containing prisma client and sorting options
- * @returns {Promise<[number, Array<QuoteInvoiceTypeBE>]>} Tuple containing total count and array of all quotes/invoices
+ * @returns {Promise<[number, Array<QuoteInvoiceBE>]>} Tuple containing total count and array of all quotes/invoices
  */
 var postQuotesInvoicesReport = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var include, orderBy, where, _c, count, items;

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

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

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

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

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

@@ -1,4 +1,5 @@
-import { TaxTypeBE } from '../type';
+export * from './cache';
+import { TaxBE } from '../type';
 type PrismaClient = any;
 export interface ListTaxArgs {
     currentPage?: number;
@@ -31,25 +32,24 @@ export interface DeleteTaxArgs {
 /**
  * Retrieves a paginated list of taxes
  * @param {ListTaxArgs} args - Object containing prisma client, pagination, filtering, and ordering options
- * @returns {Promise<[number, Array<TaxTypeBE>]>} Tuple containing total count and array of taxes
+ * @returns {Promise<[number, Array<TaxBE>]>} Tuple containing total count and array of taxes
  */
-export declare const listTax: ({ currentPage, includePreference, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListTaxArgs) => Promise<[number, Array<TaxTypeBE>]>;
+export declare const listTax: ({ currentPage, includePreference, orderByColumn, orderByDirection, pageLimit, prisma, searchQuery, }: ListTaxArgs) => Promise<[number, Array<TaxBE>]>;
 /**
  * Retrieves a single tax by its ID
  * @param {UnitTaxByIdArgs} args - Object containing prisma client, tax ID, and optional query parameters
- * @returns {Promise<TaxTypeBE | null>} Tax or null if not found
+ * @returns {Promise<TaxBE | null>} Tax or null if not found
  */
-export declare const unitTaxById: ({ id, includePreference, prisma, }: UnitTaxByIdArgs) => Promise<TaxTypeBE | null>;
+export declare const unitTaxById: ({ id, includePreference, prisma, }: UnitTaxByIdArgs) => Promise<TaxBE | null>;
 /**
  * Creates or updates a tax
  * @param {UpdateTaxArgs} args - Object containing prisma client, tax data, and optional query parameters
- * @returns {Promise<TaxTypeBE>} Created or updated tax
+ * @returns {Promise<TaxBE>} Created or updated tax
  */
-export declare const updateTax: ({ description, enabled, id, isDefault, preferenceId, prisma, taxName, taxRate, }: UpdateTaxArgs) => Promise<TaxTypeBE>;
+export declare const updateTax: ({ description, enabled, id, isDefault, preferenceId, prisma, taxName, taxRate, }: UpdateTaxArgs) => Promise<TaxBE>;
 /**
  * Deletes a tax by ID
  * @param {DeleteTaxArgs} args - Object containing prisma client, tax ID, and optional query parameters
- * @returns {Promise<TaxTypeBE>} Deleted tax
+ * @returns {Promise<TaxBE>} Deleted tax
  */
-export declare const deleteTax: ({ id, prisma, }: DeleteTaxArgs) => Promise<TaxTypeBE>;
-export {};
+export declare const deleteTax: ({ id, prisma, }: DeleteTaxArgs) => Promise<TaxBE>;