@react-pakistan/util-functions 1.24.65 → 1.24.66

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

@@ -1,5 +1,15 @@
 "use strict";
-/* eslint-disable @typescript-eslint/no-explicit-any, no-restricted-globals */
+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) {
@@ -37,86 +47,148 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteTax = exports.postTax = exports.getTaxById = exports.getTaxes = void 0;
-var getTaxes = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var taxes;
-    var prisma = _b.prisma;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.tax.findMany({
-                    orderBy: {
-                        createdAt: 'desc',
-                    },
-                })];
+exports.deleteTax = exports.updateTax = exports.unitTaxById = exports.listTax = void 0;
+/**
+ * Retrieves a paginated list of taxes
+ * @param {ListTaxArgs} args - Object containing prisma client, pagination, and filter options
+ * @returns {Promise<[number, Array<TaxBE>]>} Tuple of [total count, tax array]
+ */
+var listTax = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var skip, _c, count, data;
+    var _d = _b.currentPage, currentPage = _d === void 0 ? 1 : _d, _e = _b.include, include = _e === void 0 ? {} : _e, _f = _b.orderBy, orderBy = _f === void 0 ? { createdAt: 'desc' } : _f, _g = _b.pageLimit, pageLimit = _g === void 0 ? 10 : _g, prisma = _b.prisma, _h = _b.queryWhere, queryWhere = _h === void 0 ? {} : _h;
+    return __generator(this, function (_j) {
+        switch (_j.label) {
+            case 0:
+                if (currentPage < 1) {
+                    throw new Error('Current page must be greater than or equal to 1');
+                }
+                if (pageLimit < 1) {
+                    throw new Error('Page limit must be greater than or equal to 1');
+                }
+                skip = (currentPage - 1) * pageLimit;
+                return [4 /*yield*/, Promise.all([
+                        prisma.tax.count({
+                            where: queryWhere,
+                        }),
+                        prisma.tax.findMany({
+                            include: include,
+                            orderBy: orderBy,
+                            skip: skip,
+                            take: pageLimit,
+                            where: queryWhere,
+                        }),
+                    ])];
             case 1:
-                taxes = _c.sent();
-                return [2 /*return*/, taxes];
+                _c = _j.sent(), count = _c[0], data = _c[1];
+                return [2 /*return*/, [count, data]];
         }
     });
 }); };
-exports.getTaxes = getTaxes;
-var getTaxById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+exports.listTax = listTax;
+/**
+ * Retrieves a single tax by its ID
+ * @param {UnitTaxByIdArgs} args - Object containing prisma client, tax ID, and optional filters
+ * @returns {Promise<TaxBE | null>} Tax or null if not found
+ */
+var unitTaxById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var tax;
-    var prisma = _b.prisma, id = _b.id;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.tax.findUnique({
-                    where: {
-                        id: id,
-                    },
-                })];
+    var id = _b.id, _c = _b.include, include = _c === void 0 ? {} : _c, prisma = _b.prisma, _d = _b.queryWhere, queryWhere = _d === void 0 ? {} : _d;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                if (!id) {
+                    throw new Error('Tax ID is required');
+                }
+                if (queryWhere.id && queryWhere.id !== id) {
+                    throw new Error('ID mismatch between parameter and queryWhere');
+                }
+                return [4 /*yield*/, prisma.tax.findUnique({
+                        include: include,
+                        where: __assign({ id: id }, queryWhere),
+                    })];
             case 1:
-                tax = _c.sent();
+                tax = _e.sent();
                 return [2 /*return*/, tax];
         }
     });
 }); };
-exports.getTaxById = getTaxById;
-var postTax = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var tax;
-    var description = _b.description, enabled = _b.enabled, id = _b.id, isDefault = _b.isDefault, preferenceId = _b.preferenceId, prisma = _b.prisma, taxName = _b.taxName, taxRate = _b.taxRate;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.tax.upsert({
-                    where: {
-                        id: id,
-                    },
-                    update: {
-                        description: description,
-                        enabled: enabled,
-                        isDefault: isDefault,
-                        preferenceId: preferenceId,
-                        taxName: taxName,
-                        taxRate: taxRate,
-                    },
-                    create: {
-                        description: description,
-                        enabled: enabled,
-                        isDefault: isDefault,
-                        preferenceId: preferenceId,
-                        taxName: taxName,
-                        taxRate: taxRate,
-                    },
-                })];
+exports.unitTaxById = unitTaxById;
+/**
+ * Creates or updates a tax
+ * @param {UpdateTaxArgs} args - Object containing prisma client and tax data
+ * @returns {Promise<TaxBE>} Created or updated tax
+ */
+var updateTax = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var taxData, tax;
+    var description = _b.description, enabled = _b.enabled, id = _b.id, _c = _b.include, include = _c === void 0 ? {} : _c, isDefault = _b.isDefault, preferenceId = _b.preferenceId, prisma = _b.prisma, _d = _b.queryWhere, queryWhere = _d === void 0 ? {} : _d, taxName = _b.taxName, taxRate = _b.taxRate;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                if (!id) {
+                    throw new Error('Tax ID is required');
+                }
+                if (!preferenceId) {
+                    throw new Error('Preference ID is required');
+                }
+                if (!taxName) {
+                    throw new Error('Tax name is required');
+                }
+                if (!taxRate) {
+                    throw new Error('Tax rate is required');
+                }
+                if (typeof enabled !== 'boolean') {
+                    throw new Error('Enabled must be a boolean');
+                }
+                if (typeof isDefault !== 'boolean') {
+                    throw new Error('Is default must be a boolean');
+                }
+                if (queryWhere.id && queryWhere.id !== id) {
+                    throw new Error('ID mismatch between parameter and queryWhere');
+                }
+                taxData = {
+                    description: description || null,
+                    enabled: enabled,
+                    isDefault: isDefault,
+                    preferenceId: preferenceId,
+                    taxName: taxName,
+                    taxRate: taxRate,
+                };
+                return [4 /*yield*/, prisma.tax.upsert({
+                        include: include,
+                        where: __assign({ id: id }, queryWhere),
+                        update: taxData,
+                        create: __assign({ id: id }, taxData),
+                    })];
             case 1:
-                tax = _c.sent();
+                tax = _e.sent();
                 return [2 /*return*/, tax];
         }
     });
 }); };
-exports.postTax = postTax;
+exports.updateTax = updateTax;
+/**
+ * Deletes a tax by ID
+ * @param {DeleteTaxArgs} args - Object containing prisma client, tax ID, and optional filters
+ * @returns {Promise<TaxBE>} Deleted tax
+ */
 var deleteTax = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var tax;
-    var prisma = _b.prisma, id = _b.id;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.tax.delete({
-                    where: {
-                        id: id,
-                    },
-                })];
+    var id = _b.id, _c = _b.include, include = _c === void 0 ? {} : _c, prisma = _b.prisma, _d = _b.queryWhere, queryWhere = _d === void 0 ? {} : _d;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                if (!id) {
+                    throw new Error('Tax ID is required');
+                }
+                if (queryWhere.id && queryWhere.id !== id) {
+                    throw new Error('ID mismatch between parameter and queryWhere');
+                }
+                return [4 /*yield*/, prisma.tax.delete({
+                        include: include,
+                        where: __assign({ id: id }, queryWhere),
+                    })];
             case 1:
-                tax = _c.sent();
+                tax = _e.sent();
                 return [2 /*return*/, tax];
         }
     });

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

@@ -1,19 +1,34 @@
+/**
+ * Gender options for user profiles
+ */
 export declare enum GENDER {
     MALE = "MALE",
     FEMALE = "FEMALE"
 }
+/**
+ * Quote and Invoice category types
+ */
 export declare enum QUOTE_INVOICE_CATEGORY {
     QUOTE = "QUOTE",
     INVOICE = "INVOICE"
 }
+/**
+ * Discount unit types (fixed amount or percentage)
+ */
 export declare enum DISCOUNT_UNIT {
     FIXED_VALUE = "FIXED_VALUE",
     PERCENTAGE_VALUE = "PERCENTAGE_VALUE"
 }
+/**
+ * Invoice payment status
+ */
 export declare enum INVOICE_STATUS {
     UNPAID = "UNPAID",
     PAID = "PAID"
 }
+/**
+ * Quote lifecycle status
+ */
 export declare enum QUOTE_STATUS {
     DRAFT = "DRAFT",
     PENDING = "PENDING",
@@ -21,13 +36,79 @@ export declare enum QUOTE_STATUS {
     ACCEPTED = "ACCEPTED",
     DECLINED = "DECLINED"
 }
+/**
+ * Payment type (full or partial)
+ */
 export declare enum PAYMENT_TYPE {
     FULL_AMOUNT = "FULL_AMOUNT",
     PARTIAL_AMOUNT = "PARTIAL_AMOUNT"
 }
-export interface ProfileBE {
-    avatar?: string;
+/**
+ * Lead source options
+ */
+export declare enum LEAD_SOURCE {
+    ADVERTISING = "ADVERTISING",
+    CUSTOMER_REFERRAL = "CUSTOMER_REFERRAL",
+    FRIEND = "FRIEND",
+    LINKEDIN = "LINKEDIN",
+    OTHER = "OTHER",
+    PROFESSIONAL_NETWORK = "PROFESSIONAL_NETWORK",
+    SALES = "SALES",
+    SOCIAL_MEDIA = "SOCIAL_MEDIA",
+    WEBSITE = "WEBSITE"
+}
+/**
+ * Lead status options
+ */
+export declare enum LEAD_STATUS {
+    ASSIGNED = "ASSIGNED",
+    CANCELLED = "CANCELLED",
+    DRAFT = "DRAFT",
+    IN_NEGOTIATION = "IN_NEGOTIATION",
+    LOOSE = "LOOSE",
+    NEW = "NEW",
+    ON_HOLD = "ON_HOLD",
+    WAITING = "WAITING",
+    WON = "WON"
+}
+/**
+ * Lead type (company or contact)
+ */
+export declare enum LEAD_TYPE {
+    COMPANY = "COMPANY",
+    CONTACT = "CONTACT"
+}
+/**
+ * Base timestamp fields present in all entities
+ */
+export interface TimestampFields {
     createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Common fields for preference-related entities
+ */
+export interface PreferenceRelatedFields extends TimestampFields {
+    enabled: boolean;
+    id: string;
+    isDefault: boolean;
+    preferenceId: string;
+    preference?: PreferenceBE;
+}
+/**
+ * Application user entity
+ */
+export interface AppUserBE extends TimestampFields {
+    email: string;
+    firstName: string;
+    id: string;
+    lastName: string;
+}
+/**
+ * User profile entity with extended personal information
+ */
+export interface ProfileBE extends TimestampFields {
+    avatar?: string;
     dob?: string;
     email: string;
     firstName: string;
@@ -38,12 +119,22 @@ export interface ProfileBE {
     location?: string;
     phone: string;
     skill?: string;
-    updatedAt: string;
     userId: string;
 }
-export interface ProductBE {
+/**
+ * Product category entity
+ */
+export interface ProductCategoryBE extends TimestampFields {
+    description?: string;
+    id: string;
+    name: string;
+    products: Array<ProductBE>;
+}
+/**
+ * Product entity
+ */
+export interface ProductBE extends TimestampFields {
     buyPrice: string;
-    createdAt: string;
     currency: string;
     description?: string;
     id: string;
@@ -54,51 +145,61 @@ export interface ProductBE {
     quantity: string;
     ref?: string;
     salePrice: string;
-    updatedAt: string;
 }
-export interface ProductCategoryBE {
-    createdAt: string;
-    description?: string;
-    id: string;
-    name: string;
-    products: Array<ProductBE>;
-    updatedAt: string;
-}
-export interface CompanyBE {
+/**
+ * Company entity
+ */
+export interface CompanyBE extends TimestampFields {
     contacts: Array<ContactBE>;
     country: string;
-    createdAt: string;
     email: string;
     id: string;
     name: string;
     phone: string;
     quotesInvoices: Array<QuoteInvoiceBE>;
-    updatedAt: string;
     website?: string;
 }
-export interface ContactBE {
+/**
+ * Contact entity (associated with a company)
+ */
+export interface ContactBE extends TimestampFields {
     company?: CompanyBE;
     companyId: string;
     country: string;
-    createdAt: string;
     email: string;
     firstName: string;
     id: string;
     lastName: string;
     phone: string;
-    updatedAt: string;
 }
-export interface ExpenseCategoryBE {
+/**
+ * Customer entity
+ */
+export interface CustomerBE extends TimestampFields {
+    address?: string;
+    city: string;
+    country: string;
+    email?: string;
+    firstName: string;
+    id: string;
+    invoices: Array<QuoteInvoiceBE>;
+    lastName: string;
+    phone: string;
+}
+/**
+ * Expense category entity
+ */
+export interface ExpenseCategoryBE extends TimestampFields {
     color: string;
-    createdAt: string;
     description?: string;
     expenses: Array<ExpenseBE>;
     id: string;
     name: string;
-    updatedAt: string;
 }
-export interface ExpenseBE {
-    createdAt: string;
+/**
+ * Expense entity
+ */
+export interface ExpenseBE extends TimestampFields {
     currency: string;
     description: string;
     expenseCategory?: ExpenseCategoryBE;
@@ -107,13 +208,14 @@ export interface ExpenseBE {
     name: string;
     ref?: string;
     total: string;
-    updatedAt: string;
 }
-export interface QuoteInvoiceBE {
+/**
+ * Quote/Invoice entity
+ */
+export interface QuoteInvoiceBE extends TimestampFields {
     category: QUOTE_INVOICE_CATEGORY;
     company?: CompanyBE;
     companyId?: string;
-    createdAt: string;
     currency: string;
     customer?: CustomerBE;
     customerId?: string;
@@ -132,10 +234,11 @@ export interface QuoteInvoiceBE {
     subTotal: string;
     taxRate: string;
     total: string;
-    updatedAt: string;
 }
-export interface ServiceBE {
-    createdAt: string;
+/**
+ * Service entity (for quotes/invoices)
+ */
+export interface ServiceBE extends TimestampFields {
     description?: string;
     id: string;
     name: string;
@@ -143,13 +246,14 @@ export interface ServiceBE {
     quantity: string;
     quoteInvoice?: QuoteInvoiceBE;
     quoteInvoiceId: string;
-    updatedAt: string;
 }
-export interface PaymentBE {
+/**
+ * Payment entity
+ */
+export interface PaymentBE extends TimestampFields {
     amount: string;
     attachment?: string;
     balance: string;
-    createdAt: string;
     currency: string;
     date: string;
     description?: string;
@@ -160,134 +264,96 @@ export interface PaymentBE {
     quoteInvoice?: QuoteInvoiceBE;
     quoteInvoiceId: string;
     ref?: string;
-    updatedAt: string;
 }
-export interface PreferenceBE {
+/**
+ * User preferences and settings entity
+ */
+export interface PreferenceBE extends TimestampFields {
     banks: Array<BankBE>;
     branches: Array<BranchBE>;
-    createdAt: string;
     currencies: Array<CurrencyBE>;
     id: string;
     menuOrder: Array<MenuOrderBE>;
     onboarding: boolean;
     paymentModes: Array<PaymentModeBE>;
     taxes: Array<TaxBE>;
-    updatedAt: string;
-}
-export interface AppUserBE {
-    createdAt: string;
-    email: string;
-    firstName: string;
-    id: string;
-    lastName: string;
-    updatedAt: string;
 }
-export interface MenuOrderBE {
-    createdAt: string;
+/**
+ * Menu order configuration entity
+ */
+export interface MenuOrderBE extends TimestampFields {
     id: string;
     label: string;
     order: number;
     preference?: PreferenceBE;
     preferenceId: string;
-    updatedAt: string;
 }
-export interface PaymentModeBE {
-    createdAt: string;
-    enabled: boolean;
-    id: string;
-    isDefault: boolean;
+/**
+ * Payment mode entity
+ */
+export interface PaymentModeBE extends PreferenceRelatedFields {
     label: string;
     payments: Array<PaymentBE>;
-    preference?: PreferenceBE;
-    preferenceId: string;
-    updatedAt: string;
 }
-export interface BankBE {
+/**
+ * Bank account entity
+ */
+export interface BankBE extends PreferenceRelatedFields {
     accountNumber: string;
     accountTitle: string;
     bankAddress?: string;
     bankName: string;
-    createdAt: string;
-    enabled: boolean;
     iban?: string;
-    id: string;
-    isDefault: boolean;
-    preference?: PreferenceBE;
-    preferenceId: string;
     swiftCode?: string;
-    updatedAt: string;
 }
-export interface TaxBE {
-    createdAt: string;
+/**
+ * Tax configuration entity
+ */
+export interface TaxBE extends PreferenceRelatedFields {
     description?: string;
-    enabled: boolean;
-    id: string;
-    isDefault: boolean;
-    preference?: PreferenceBE;
-    preferenceId: string;
     taxName: string;
     taxRate: string;
-    updatedAt: string;
 }
-export interface BranchBE {
+/**
+ * Branch/Location entity
+ */
+export interface BranchBE extends PreferenceRelatedFields {
     branchAddress: string;
     branchName: string;
-    createdAt: string;
-    enabled: boolean;
-    id: string;
-    isDefault: boolean;
     personEmail: string;
     personName: string;
     personPhone: string;
-    preference?: PreferenceBE;
-    preferenceId: string;
-    updatedAt: string;
 }
-export interface CurrencyBE {
+/**
+ * Currency entity
+ */
+export interface CurrencyBE extends PreferenceRelatedFields {
     code: string;
-    createdAt: string;
-    enabled: boolean;
-    id: string;
-    isDefault: boolean;
     label: string;
-    preference?: PreferenceBE;
-    preferenceId: string;
-    updatedAt: string;
 }
-export interface CustomerBE {
-    address?: string;
-    city: string;
-    country: string;
-    createdAt: string;
-    email?: string;
-    firstName: string;
+/**
+ * Lead entity for CRM
+ */
+export interface LeadBE extends TimestampFields {
     id: string;
-    invoices: Array<QuoteInvoiceBE>;
-    lastName: string;
-    phone: string;
-    updatedAt: string;
+    notes?: string;
+    source: LEAD_SOURCE;
+    status: LEAD_STATUS;
+    type: LEAD_TYPE;
 }
-export interface RequestFormBE {
+/**
+ * Request form submission entity
+ */
+export interface RequestFormBE extends TimestampFields {
     businessType: string;
     companyName: string;
     companySize?: string;
-    createdAt: string;
     designation: string;
     firstName: string;
     headOffice?: string;
     id: string;
     lastName: string;
     phoneNumber: string;
-    updatedAt: string;
     website?: string;
     workEmail: string;
 }
-export interface LeadBE {
-    createdAt: string;
-    id: string;
-    notes?: string;
-    source: 'ADVERTISING' | 'CUSTOMER_REFERRAL' | 'FRIEND' | 'LINKEDIN' | 'OTHER' | 'PROFESSIONAL_NETWORK' | 'SALES' | 'SOCIAL_MEDIA' | 'WEBSITE';
-    status: 'ASSIGNED' | 'CANCELLED' | 'DRAFT' | 'IN_NEGOTIATION' | 'LOOSE' | 'NEW' | 'ON_HOLD' | 'WAITING' | 'WON';
-    type: 'COMPANY' | 'CONTACT';
-    updatedAt: string;
-}