@react-pakistan/util-functions 1.24.64 → 1.24.66

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

@@ -1,42 +1,78 @@
 import { ExpenseBE } from '../type';
-interface GetExpensesArgs {
-    prisma: any;
-}
-interface GetExpenseByIdArgs {
-    id: string;
-    prisma: any;
-}
-interface PostExpensesArgs {
+type PrismaClient = any;
+interface ListExpenseArgs {
     currentPage: number;
-    include: {
+    include?: {
         [key: string]: any;
     };
-    orderBy: {
+    orderBy?: {
         [key: string]: any;
     };
     pageLimit: number;
-    prisma: any;
-    queryWhere: {
+    prisma: PrismaClient;
+    queryWhere?: {
+        [key: string]: any;
+    };
+}
+interface UnitExpenseByIdArgs {
+    id: string;
+    include?: {
+        [key: string]: any;
+    };
+    prisma: PrismaClient;
+    queryWhere?: {
         [key: string]: any;
     };
 }
-interface PostExpenseArgs {
+interface UpdateExpenseArgs {
     currency: string;
     description: string;
     expenseCategoryId: string;
-    id: string;
+    id?: string;
+    include?: {
+        [key: string]: any;
+    };
     name: string;
-    prisma: any;
-    ref: string;
+    prisma: PrismaClient;
+    queryWhere?: {
+        [key: string]: any;
+    };
+    ref?: string;
     total: string;
 }
 interface DeleteExpenseArgs {
-    prisma: any;
     id: string;
+    include?: {
+        [key: string]: any;
+    };
+    prisma: PrismaClient;
+    queryWhere?: {
+        [key: string]: any;
+    };
 }
-export declare const getExpenses: ({ prisma, }: GetExpensesArgs) => Promise<Array<ExpenseBE>>;
-export declare const getExpenseById: ({ id, prisma, }: GetExpenseByIdArgs) => Promise<ExpenseBE>;
-export declare const postExpenses: ({ currentPage, include, orderBy, pageLimit, prisma, queryWhere, }: PostExpensesArgs) => Promise<Array<ExpenseBE>>;
-export declare const postExpense: ({ currency, description, expenseCategoryId, id, name, prisma, ref, total, }: PostExpenseArgs) => Promise<ExpenseBE>;
-export declare const deleteExpense: ({ prisma, id, }: DeleteExpenseArgs) => Promise<ExpenseBE>;
+/**
+ * Retrieves expenses with pagination and filtering
+ * @param {ListExpenseArgs} args - Object containing prisma client, pagination, and query options
+ * @returns {Promise<[number, Array<ExpenseBE>]>} Tuple containing total count and array of expenses
+ */
+export declare const listExpense: ({ currentPage, include, orderBy, pageLimit, prisma, queryWhere, }: ListExpenseArgs) => Promise<[number, Array<ExpenseBE>]>;
+/**
+ * Retrieves a single expense by ID
+ * @param {UnitExpenseByIdArgs} args - Object containing prisma client, expense id, and optional query parameters
+ * @returns {Promise<ExpenseBE | null>} Expense with optional relations if found, null otherwise
+ */
+export declare const unitExpenseById: ({ id, include, prisma, queryWhere, }: UnitExpenseByIdArgs) => Promise<ExpenseBE | null>;
+/**
+ * Creates or updates an expense using upsert
+ * @param {UpdateExpenseArgs} args - Object containing prisma client and expense data
+ * @returns {Promise<ExpenseBE>} Created or updated expense
+ */
+export declare const updateExpense: ({ currency, description, expenseCategoryId, id, include, name, prisma, queryWhere, ref, total, }: UpdateExpenseArgs) => Promise<ExpenseBE>;
+/**
+ * Deletes an expense by ID
+ * @param {DeleteExpenseArgs} args - Object containing prisma client, expense id, and optional query parameters
+ * @returns {Promise<ExpenseBE>} Deleted expense
+ * @throws {Error} If expense ID is not provided or expense not found
+ */
+export declare const deleteExpense: ({ id, include, prisma, queryWhere, }: DeleteExpenseArgs) => Promise<ExpenseBE>;
 export {};

package/api/stellar-solutions/expense/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,116 +47,142 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteExpense = exports.postExpense = exports.postExpenses = exports.getExpenseById = exports.getExpenses = void 0;
-var getExpenses = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var expenses;
-    var prisma = _b.prisma;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.expense.findMany({
-                    orderBy: {
-                        createdAt: 'desc',
-                    },
-                    include: {
-                        expenseCategory: true,
-                    },
-                })];
+exports.deleteExpense = exports.updateExpense = exports.unitExpenseById = exports.listExpense = void 0;
+/**
+ * Retrieves expenses with pagination and filtering
+ * @param {ListExpenseArgs} args - Object containing prisma client, pagination, and query options
+ * @returns {Promise<[number, Array<ExpenseBE>]>} Tuple containing total count and array of expenses
+ */
+var listExpense = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var _c, count, expenses;
+    var currentPage = _b.currentPage, _d = _b.include, include = _d === void 0 ? { expenseCategory: true } : _d, _e = _b.orderBy, orderBy = _e === void 0 ? { createdAt: 'desc' } : _e, pageLimit = _b.pageLimit, prisma = _b.prisma, _f = _b.queryWhere, queryWhere = _f === void 0 ? {} : _f;
+    return __generator(this, function (_g) {
+        switch (_g.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');
+                }
+                return [4 /*yield*/, prisma.$transaction([
+                        prisma.expense.count({
+                            where: queryWhere,
+                        }),
+                        prisma.expense.findMany({
+                            orderBy: orderBy,
+                            include: include,
+                            where: queryWhere,
+                            take: pageLimit,
+                            skip: (currentPage - 1) * pageLimit,
+                        }),
+                    ])];
             case 1:
-                expenses = _c.sent();
-                return [2 /*return*/, expenses];
+                _c = _g.sent(), count = _c[0], expenses = _c[1];
+                return [2 /*return*/, [count, expenses]];
         }
     });
 }); };
-exports.getExpenses = getExpenses;
-var getExpenseById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+exports.listExpense = listExpense;
+/**
+ * Retrieves a single expense by ID
+ * @param {UnitExpenseByIdArgs} args - Object containing prisma client, expense id, and optional query parameters
+ * @returns {Promise<ExpenseBE | null>} Expense with optional relations if found, null otherwise
+ */
+var unitExpenseById = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var expense;
-    var id = _b.id, prisma = _b.prisma;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.expense.findUnique({
-                    where: {
-                        id: id,
-                    },
-                    include: {
-                        expenseCategory: true,
-                    },
-                })];
+    var id = _b.id, _c = _b.include, include = _c === void 0 ? { expenseCategory: true } : _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('Expense ID is required');
+                }
+                if ((queryWhere === null || queryWhere === void 0 ? void 0 : queryWhere.id) && queryWhere.id !== id) {
+                    throw new Error('ID mismatch between parameter and queryWhere');
+                }
+                return [4 /*yield*/, prisma.expense.findUnique({
+                        where: __assign({ id: id }, queryWhere),
+                        include: include || undefined,
+                    })];
             case 1:
-                expense = _c.sent();
+                expense = _e.sent();
                 return [2 /*return*/, expense];
         }
     });
 }); };
-exports.getExpenseById = getExpenseById;
-var postExpenses = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var expenses;
-    var currentPage = _b.currentPage, include = _b.include, orderBy = _b.orderBy, pageLimit = _b.pageLimit, prisma = _b.prisma, queryWhere = _b.queryWhere;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.$transaction([
-                    prisma.expense.count({
-                        where: queryWhere,
-                    }),
-                    prisma.expense.findMany({
-                        orderBy: orderBy,
-                        include: include,
-                        where: queryWhere,
-                        take: pageLimit,
-                        skip: (currentPage - 1) * pageLimit,
-                    }),
-                ])];
+exports.unitExpenseById = unitExpenseById;
+/**
+ * Creates or updates an expense using upsert
+ * @param {UpdateExpenseArgs} args - Object containing prisma client and expense data
+ * @returns {Promise<ExpenseBE>} Created or updated expense
+ */
+var updateExpense = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var expenseData, expenseId, expense_1, expense;
+    var currency = _b.currency, description = _b.description, expenseCategoryId = _b.expenseCategoryId, id = _b.id, _c = _b.include, include = _c === void 0 ? { expenseCategory: true } : _c, name = _b.name, prisma = _b.prisma, _d = _b.queryWhere, queryWhere = _d === void 0 ? {} : _d, ref = _b.ref, total = _b.total;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                if (!currency || !description || !expenseCategoryId || !name || !total) {
+                    throw new Error('Currency, description, expense category ID, name, and total are required');
+                }
+                if (id && (queryWhere === null || queryWhere === void 0 ? void 0 : queryWhere.id) && queryWhere.id !== id) {
+                    throw new Error('ID mismatch between parameter and queryWhere');
+                }
+                expenseData = {
+                    currency: currency,
+                    description: description,
+                    expenseCategoryId: expenseCategoryId,
+                    name: name,
+                    ref: ref || null,
+                    total: total,
+                };
+                expenseId = id || (queryWhere === null || queryWhere === void 0 ? void 0 : queryWhere.id);
+                if (!!expenseId) return [3 /*break*/, 2];
+                return [4 /*yield*/, prisma.expense.create({
+                        data: expenseData,
+                        include: include || undefined,
+                    })];
             case 1:
-                expenses = _c.sent();
-                return [2 /*return*/, expenses];
-        }
-    });
-}); };
-exports.postExpenses = postExpenses;
-var postExpense = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var expense;
-    var currency = _b.currency, description = _b.description, expenseCategoryId = _b.expenseCategoryId, id = _b.id, name = _b.name, prisma = _b.prisma, ref = _b.ref, total = _b.total;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.expense.upsert({
-                    where: {
-                        id: id,
-                    },
-                    update: {
-                        currency: currency,
-                        description: description,
-                        expenseCategoryId: expenseCategoryId,
-                        name: name,
-                        ref: ref,
-                        total: total,
-                    },
-                    create: {
-                        currency: currency,
-                        description: description,
-                        expenseCategoryId: expenseCategoryId,
-                        name: name,
-                        ref: ref,
-                        total: total,
-                    },
+                expense_1 = _e.sent();
+                return [2 /*return*/, expense_1];
+            case 2: return [4 /*yield*/, prisma.expense.upsert({
+                    where: __assign({ id: expenseId }, queryWhere),
+                    update: expenseData,
+                    create: __assign({ id: expenseId }, expenseData),
+                    include: include || undefined,
                 })];
-            case 1:
-                expense = _c.sent();
+            case 3:
+                expense = _e.sent();
                 return [2 /*return*/, expense];
         }
     });
 }); };
-exports.postExpense = postExpense;
+exports.updateExpense = updateExpense;
+/**
+ * Deletes an expense by ID
+ * @param {DeleteExpenseArgs} args - Object containing prisma client, expense id, and optional query parameters
+ * @returns {Promise<ExpenseBE>} Deleted expense
+ * @throws {Error} If expense ID is not provided or expense not found
+ */
 var deleteExpense = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var expense;
-    var prisma = _b.prisma, id = _b.id;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0: return [4 /*yield*/, prisma.expense.delete({
-                    where: {
-                        id: id,
-                    },
-                })];
+    var id = _b.id, _c = _b.include, include = _c === void 0 ? { expenseCategory: true } : _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('Expense ID is required');
+                }
+                if ((queryWhere === null || queryWhere === void 0 ? void 0 : queryWhere.id) && queryWhere.id !== id) {
+                    throw new Error('ID mismatch between parameter and queryWhere');
+                }
+                return [4 /*yield*/, prisma.expense.delete({
+                        where: __assign({ id: id }, queryWhere),
+                        include: include || undefined,
+                    })];
             case 1:
-                expense = _c.sent();
+                expense = _e.sent();
                 return [2 /*return*/, expense];
         }
     });

package/api/stellar-solutions/expense-category/index.d.ts

@@ -1,39 +1,75 @@
 import { ExpenseCategoryBE } from '../type';
-interface GetExpenseCategoriesArgs {
-    prisma: any;
-}
-interface GetExpenseCategoryByIdArgs {
-    id: string;
-    prisma: any;
-}
-interface PostExpenseCategoriesArgs {
+type PrismaClient = any;
+interface ListExpenseCategoryArgs {
     currentPage: number;
-    include: {
+    include?: {
         [key: string]: any;
     };
-    orderBy: {
+    orderBy?: {
         [key: string]: any;
     };
     pageLimit: number;
-    prisma: any;
-    queryWhere: {
+    prisma: PrismaClient;
+    queryWhere?: {
         [key: string]: any;
     };
 }
-interface PostExpenseCategoryArgs {
-    color: string;
-    description: string;
+interface UnitExpenseCategoryByIdArgs {
     id: string;
+    include?: {
+        [key: string]: any;
+    };
+    prisma: PrismaClient;
+    queryWhere?: {
+        [key: string]: any;
+    };
+}
+interface UpdateExpenseCategoryArgs {
+    color: string;
+    description?: string;
+    id?: string;
+    include?: {
+        [key: string]: any;
+    };
     name: string;
-    prisma: any;
+    prisma: PrismaClient;
+    queryWhere?: {
+        [key: string]: any;
+    };
 }
 interface DeleteExpenseCategoryArgs {
-    prisma: any;
     id: string;
+    include?: {
+        [key: string]: any;
+    };
+    prisma: PrismaClient;
+    queryWhere?: {
+        [key: string]: any;
+    };
 }
-export declare const getExpenseCategories: ({ prisma, }: GetExpenseCategoriesArgs) => Promise<Array<ExpenseCategoryBE>>;
-export declare const getExpenseCategoryById: ({ id, prisma, }: GetExpenseCategoryByIdArgs) => Promise<ExpenseCategoryBE>;
-export declare const postExpenseCategories: ({ currentPage, include, orderBy, pageLimit, prisma, queryWhere, }: PostExpenseCategoriesArgs) => Promise<Array<ExpenseCategoryBE>>;
-export declare const postExpenseCategory: ({ color, description, id, name, prisma, }: PostExpenseCategoryArgs) => Promise<ExpenseCategoryBE>;
-export declare const deleteExpenseCategory: ({ id, prisma, }: DeleteExpenseCategoryArgs) => Promise<ExpenseCategoryBE>;
+/**
+ * Retrieves expense categories with pagination and filtering
+ * @param {ListExpenseCategoryArgs} args - Object containing prisma client, pagination, and query options
+ * @returns {Promise<[number, Array<ExpenseCategoryBE>]>} Tuple containing total count and array of expense categories
+ */
+export declare const listExpenseCategory: ({ currentPage, include, orderBy, pageLimit, prisma, queryWhere, }: ListExpenseCategoryArgs) => Promise<[number, Array<ExpenseCategoryBE>]>;
+/**
+ * Retrieves a single expense category by ID
+ * @param {UnitExpenseCategoryByIdArgs} args - Object containing prisma client, expense category id, and optional query parameters
+ * @returns {Promise<ExpenseCategoryBE | null>} Expense category with optional relations if found, null otherwise
+ */
+export declare const unitExpenseCategoryById: ({ id, include, prisma, queryWhere, }: UnitExpenseCategoryByIdArgs) => Promise<ExpenseCategoryBE | null>;
+/**
+ * Creates or updates an expense category using upsert
+ * @param {UpdateExpenseCategoryArgs} args - Object containing prisma client and expense category data
+ * @returns {Promise<ExpenseCategoryBE>} Created or updated expense category
+ */
+export declare const updateExpenseCategory: ({ color, description, id, include, name, prisma, queryWhere, }: UpdateExpenseCategoryArgs) => Promise<ExpenseCategoryBE>;
+/**
+ * Deletes an expense category by ID
+ * @param {DeleteExpenseCategoryArgs} args - Object containing prisma client, expense category id, and optional query parameters
+ * @returns {Promise<ExpenseCategoryBE>} Deleted expense category
+ * @throws {Error} If expense category ID is not provided or expense category not found
+ */
+export declare const deleteExpenseCategory: ({ id, include, prisma, queryWhere, }: DeleteExpenseCategoryArgs) => Promise<ExpenseCategoryBE>;
 export {};