@appcorp/stellar-solutions-invoice-module 0.1.74 → 0.1.75

package/base-modules/invoice/validate.d.ts

@@ -19,13 +19,13 @@
  * - Type Exports
  */
 import { z } from "zod";
-import { INVOICE_DRAWER } from "./types";
+import { QUOTE_INVOICE_MODE } from "@react-pakistan/util-functions";
 export declare const formValid: z.ZodDiscriminatedUnion<[z.ZodObject<{
     address: z.ZodString;
     city: z.ZodString;
     country: z.ZodString;
     currency: z.ZodString;
-    drawer: z.ZodLiteral<INVOICE_DRAWER.INVOICE_CUSTOMER_FORM_DRAWER>;
+    invoiceMode: z.ZodLiteral<QUOTE_INVOICE_MODE.CUSTOMER>;
     email: z.ZodString;
     firstName: z.ZodString;
     lastName: z.ZodString;
@@ -47,7 +47,7 @@ export declare const formValid: z.ZodDiscriminatedUnion<[z.ZodObject<{
     companyId: z.ZodString;
     currency: z.ZodString;
     date: z.ZodString;
-    drawer: z.ZodLiteral<INVOICE_DRAWER.INVOICE_COMPANY_FORM_DRAWER>;
+    invoiceMode: z.ZodLiteral<QUOTE_INVOICE_MODE.COMPANY>;
     expiryDate: z.ZodString;
     note: z.ZodOptional<z.ZodString>;
     ref: z.ZodString;
@@ -64,8 +64,15 @@ export declare const formValid: z.ZodDiscriminatedUnion<[z.ZodObject<{
         price: z.ZodString;
         rowTotal: z.ZodString;
     }, z.core.$strip>>>;
-}, z.core.$strip>], "drawer">;
+}, z.core.$strip>], "invoiceMode">;
 export declare const formValidation: z.ZodObject<{
+    "~standard": z.ZodStandardSchemaWithJSON<z.ZodObject<{
+        discountUnit: z.ZodString;
+        discount: z.ZodString;
+        total: z.ZodString;
+        subTotal: z.ZodString;
+        taxRate: z.ZodString;
+    }, z.core.$strip>>;
     shape: {
         discountUnit: z.ZodString;
         discount: z.ZodString;
@@ -74,11 +81,11 @@ export declare const formValidation: z.ZodObject<{
         taxRate: z.ZodString;
     };
     keyof: () => z.ZodEnum<{
-        discount: "discount";
-        discountUnit: "discountUnit";
         subTotal: "subTotal";
         taxRate: "taxRate";
+        discount: "discount";
         total: "total";
+        discountUnit: "discountUnit";
     }>;
     catchall: <T extends z.core.SomeType>(schema: T) => z.ZodObject<{
         discountUnit: z.ZodString;
@@ -115,7 +122,7 @@ export declare const formValidation: z.ZodObject<{
         subTotal: z.ZodString;
         taxRate: z.ZodString;
     }, z.core.$strip>;
-    extend: <U extends z.core.$ZodLooseShape>(shape: U) => z.ZodObject<(("discount" | "discountUnit" | "subTotal" | "taxRate" | "total") & keyof U extends never ? {
+    extend: <U extends z.core.$ZodLooseShape>(shape: U) => z.ZodObject<(("subTotal" | "taxRate" | "discount" | "total" | "discountUnit") & keyof U extends never ? {
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
@@ -134,7 +141,7 @@ export declare const formValidation: z.ZodObject<{
         total: z.ZodString;
         subTotal: z.ZodString;
         taxRate: z.ZodString;
-    }, U> & Partial<Record<"discount" | "discountUnit" | "subTotal" | "taxRate" | "total", z.core.SomeType>>) => z.ZodObject<(("discount" | "discountUnit" | "subTotal" | "taxRate" | "total") & keyof U extends never ? {
+    }, U> & Partial<Record<"subTotal" | "taxRate" | "discount" | "total" | "discountUnit", z.core.SomeType>>) => z.ZodObject<(("subTotal" | "taxRate" | "discount" | "total" | "discountUnit") & keyof U extends never ? {
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
@@ -147,7 +154,7 @@ export declare const formValidation: z.ZodObject<{
         subTotal: z.ZodString;
         taxRate: z.ZodString;
     } extends infer T_1 extends z.core.util.SomeObject ? { [K in keyof T_1 as K extends keyof U ? never : K]: T_1[K]; } : never) & { [K_1 in keyof U]: U[K_1]; }) extends infer T ? { [k in keyof T]: T[k]; } : never, z.core.$strip>;
-    merge: <U extends z.ZodObject>(other: U) => z.ZodObject<(("discount" | "discountUnit" | "subTotal" | "taxRate" | "total") & keyof U["shape"] extends never ? {
+    merge: <U extends z.ZodObject>(other: U) => z.ZodObject<(("subTotal" | "taxRate" | "discount" | "total" | "discountUnit") & keyof U["shape"] extends never ? {
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
@@ -160,20 +167,20 @@ export declare const formValidation: z.ZodObject<{
         subTotal: z.ZodString;
         taxRate: z.ZodString;
     } extends infer T_1 extends z.core.util.SomeObject ? { [K in keyof T_1 as K extends keyof U["shape"] ? never : K]: T_1[K]; } : never) & (U["shape"] extends infer T_2 extends z.core.util.SomeObject ? { [K_1 in keyof T_2]: T_2[K_1]; } : never)) extends infer T ? { [k in keyof T]: T[k]; } : never, U["_zod"]["config"]>;
-    pick: <M extends z.core.util.Mask<"discount" | "discountUnit" | "subTotal" | "taxRate" | "total">>(mask: M) => z.ZodObject<Pick<{
+    pick: <M extends z.core.util.Mask<"subTotal" | "taxRate" | "discount" | "total" | "discountUnit">>(mask: M & Record<Exclude<keyof M, "subTotal" | "taxRate" | "discount" | "total" | "discountUnit">, never>) => z.ZodObject<Pick<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
         subTotal: z.ZodString;
         taxRate: z.ZodString;
-    }, Extract<"discount", keyof M> | Extract<"discountUnit", keyof M> | Extract<"subTotal", keyof M> | Extract<"taxRate", keyof M> | Extract<"total", keyof M>> extends infer T ? { [k in keyof T]: T[k]; } : never, z.core.$strip>;
-    omit: <M extends z.core.util.Mask<"discount" | "discountUnit" | "subTotal" | "taxRate" | "total">>(mask: M) => z.ZodObject<Omit<{
+    }, Extract<"subTotal", keyof M> | Extract<"taxRate", keyof M> | Extract<"discount", keyof M> | Extract<"total", keyof M> | Extract<"discountUnit", keyof M>> extends infer T ? { [k in keyof T]: T[k]; } : never, z.core.$strip>;
+    omit: <M extends z.core.util.Mask<"subTotal" | "taxRate" | "discount" | "total" | "discountUnit">>(mask: M & Record<Exclude<keyof M, "subTotal" | "taxRate" | "discount" | "total" | "discountUnit">, never>) => z.ZodObject<Omit<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
         subTotal: z.ZodString;
         taxRate: z.ZodString;
-    }, Extract<"discount", keyof M> | Extract<"discountUnit", keyof M> | Extract<"subTotal", keyof M> | Extract<"taxRate", keyof M> | Extract<"total", keyof M>> extends infer T ? { [k in keyof T]: T[k]; } : never, z.core.$strip>;
+    }, Extract<"subTotal", keyof M> | Extract<"taxRate", keyof M> | Extract<"discount", keyof M> | Extract<"total", keyof M> | Extract<"discountUnit", keyof M>> extends infer T ? { [k in keyof T]: T[k]; } : never, z.core.$strip>;
     partial: {
         (): z.ZodObject<{
             discountUnit: z.ZodOptional<z.ZodString>;
@@ -182,7 +189,7 @@ export declare const formValidation: z.ZodObject<{
             subTotal: z.ZodOptional<z.ZodString>;
             taxRate: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
-        <M extends z.core.util.Mask<"discount" | "discountUnit" | "subTotal" | "taxRate" | "total">>(mask: M): z.ZodObject<{
+        <M extends z.core.util.Mask<"subTotal" | "taxRate" | "discount" | "total" | "discountUnit">>(mask: M & Record<Exclude<keyof M, "subTotal" | "taxRate" | "discount" | "total" | "discountUnit">, never>): z.ZodObject<{
             discountUnit: "discountUnit" extends infer T ? T extends "discountUnit" ? T extends keyof M ? z.ZodOptional<{
                 discountUnit: z.ZodString;
                 discount: z.ZodString;
@@ -258,7 +265,7 @@ export declare const formValidation: z.ZodObject<{
             subTotal: z.ZodNonOptional<z.ZodString>;
             taxRate: z.ZodNonOptional<z.ZodString>;
         }, z.core.$strip>;
-        <M extends z.core.util.Mask<"discount" | "discountUnit" | "subTotal" | "taxRate" | "total">>(mask: M): z.ZodObject<{
+        <M extends z.core.util.Mask<"subTotal" | "taxRate" | "discount" | "total" | "discountUnit">>(mask: M & Record<Exclude<keyof M, "subTotal" | "taxRate" | "discount" | "total" | "discountUnit">, never>): z.ZodObject<{
             discountUnit: "discountUnit" extends infer T ? T extends "discountUnit" ? T extends keyof M ? z.ZodNonOptional<{
                 discountUnit: z.ZodString;
                 discount: z.ZodString;
@@ -355,6 +362,13 @@ export declare const formValidation: z.ZodObject<{
         subTotal: string;
         taxRate: string;
     };
+    toJSONSchema: (params?: z.core.ToJSONSchemaParams) => z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        discountUnit: z.ZodString;
+        discount: z.ZodString;
+        total: z.ZodString;
+        subTotal: z.ZodString;
+        taxRate: z.ZodString;
+    }, z.core.$strip>>;
     check: (...checks: (z.core.CheckFn<{
         discountUnit: string;
         discount: string;
@@ -374,6 +388,25 @@ export declare const formValidation: z.ZodObject<{
         subTotal: z.ZodString;
         taxRate: z.ZodString;
     }, z.core.$strip>;
+    with: (...checks: (z.core.CheckFn<{
+        discountUnit: string;
+        discount: string;
+        total: string;
+        subTotal: string;
+        taxRate: string;
+    }> | z.core.$ZodCheck<{
+        discountUnit: string;
+        discount: string;
+        total: string;
+        subTotal: string;
+        taxRate: string;
+    }>)[]) => z.ZodObject<{
+        discountUnit: z.ZodString;
+        discount: z.ZodString;
+        total: z.ZodString;
+        subTotal: z.ZodString;
+        taxRate: z.ZodString;
+    }, z.core.$strip>;
     clone: (def?: z.core.$ZodObjectDef<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
@@ -420,7 +453,7 @@ export declare const formValidation: z.ZodObject<{
         subTotal: z.ZodString;
         taxRate: z.ZodString;
     }, z.core.$strip>;
-    brand: <T extends PropertyKey = PropertyKey>(value?: T | undefined) => PropertyKey extends T ? z.ZodObject<{
+    brand: <T extends PropertyKey = PropertyKey, Dir extends "in" | "out" | "inout" = "out">(value?: T | undefined) => PropertyKey extends T ? z.ZodObject<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
@@ -432,7 +465,7 @@ export declare const formValidation: z.ZodObject<{
         total: z.ZodString;
         subTotal: z.ZodString;
         taxRate: z.ZodString;
-    }, z.core.$strip>, T>;
+    }, z.core.$strip>, T, Dir>;
     parse: (data: unknown, params?: z.core.ParseContext<z.core.$ZodIssue>) => {
         discountUnit: string;
         discount: string;
@@ -572,20 +605,38 @@ export declare const formValidation: z.ZodObject<{
         subTotal: string;
         taxRate: string;
     }>>;
-    refine: (check: (arg: {
+    refine: <Ch extends (arg: {
         discountUnit: string;
         discount: string;
         total: string;
         subTotal: string;
         taxRate: string;
-    }) => unknown | Promise<unknown>, params?: string | {
+    }) => unknown | Promise<unknown>>(check: Ch, params?: string | {
+        params?: Record<string, any> | undefined;
         abort?: boolean | undefined | undefined;
         when?: ((payload: z.core.ParsePayload) => boolean) | undefined | undefined;
         path?: PropertyKey[] | undefined | undefined;
-        params?: Record<string, any> | undefined;
         error?: string | z.core.$ZodErrorMap<NonNullable<z.core.$ZodIssue>> | undefined;
         message?: string | undefined | undefined;
-    } | undefined) => z.ZodObject<{
+    } | undefined) => Ch extends (arg: any) => arg is infer R ? z.ZodObject<{
+        discountUnit: z.ZodString;
+        discount: z.ZodString;
+        total: z.ZodString;
+        subTotal: z.ZodString;
+        taxRate: z.ZodString;
+    }, z.core.$strip> & z.ZodType<R, {
+        discountUnit: string;
+        discount: string;
+        total: string;
+        subTotal: string;
+        taxRate: string;
+    }, z.core.$ZodTypeInternals<R, {
+        discountUnit: string;
+        discount: string;
+        total: string;
+        subTotal: string;
+        taxRate: string;
+    }>> : z.ZodObject<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
@@ -637,6 +688,13 @@ export declare const formValidation: z.ZodObject<{
         subTotal: z.ZodString;
         taxRate: z.ZodString;
     }, z.core.$strip>>;
+    exactOptional: () => z.ZodExactOptional<z.ZodObject<{
+        discountUnit: z.ZodString;
+        discount: z.ZodString;
+        total: z.ZodString;
+        subTotal: z.ZodString;
+        taxRate: z.ZodString;
+    }, z.core.$strip>>;
     nonoptional: (params?: string | z.core.$ZodNonOptionalParams) => z.ZodNonOptional<z.ZodObject<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
@@ -858,19 +916,19 @@ export declare const formValidation: z.ZodObject<{
     };
     isOptional: () => boolean;
     isNullable: () => boolean;
-    _zod: z.core.$ZodObjectInternals<{
+    apply: <T>(fn: (schema: z.ZodObject<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
         subTotal: z.ZodString;
         taxRate: z.ZodString;
-    }, z.core.$strip>;
-    "~standard": z.core.$ZodStandardSchema<z.ZodObject<{
+    }, z.core.$strip>) => T) => T;
+    _zod: z.core.$ZodObjectInternals<{
         discountUnit: z.ZodString;
         discount: z.ZodString;
         total: z.ZodString;
         subTotal: z.ZodString;
         taxRate: z.ZodString;
-    }, z.core.$strip>>;
+    }, z.core.$strip>;
 }, z.core.$strip>;
 export type FormValidate = z.infer<typeof formValidation>;

package/base-modules/invoice/validate.js

@@ -23,7 +23,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formValidation = exports.formValid = void 0;
 var zod_1 = require("zod");
 var constants_1 = require("./constants");
-var types_1 = require("./types");
+var util_functions_1 = require("@react-pakistan/util-functions");
 // ============================================================================
 // SERVICE ITEM SCHEMA
 // ============================================================================
@@ -73,7 +73,7 @@ var customerSchema = zod_1.z.object({
     city: zod_1.z.string().nonempty(constants_1.validationErrors.customerCity),
     country: zod_1.z.string().nonempty(constants_1.validationErrors.customerCountry),
     currency: zod_1.z.string(),
-    drawer: zod_1.z.literal(types_1.INVOICE_DRAWER.INVOICE_CUSTOMER_FORM_DRAWER),
+    invoiceMode: zod_1.z.literal(util_functions_1.QUOTE_INVOICE_MODE.CUSTOMER),
     email: zod_1.z.string().nonempty(constants_1.validationErrors.customerEmail),
     firstName: zod_1.z.string().nonempty(constants_1.validationErrors.customerFirstName),
     lastName: zod_1.z.string().nonempty(constants_1.validationErrors.customerLastName),
@@ -88,7 +88,7 @@ var companySchema = zod_1.z.object({
     companyId: zod_1.z.string().nonempty(constants_1.validationErrors.companyId),
     currency: zod_1.z.string().nonempty(constants_1.validationErrors.currency),
     date: zod_1.z.string().nonempty(constants_1.validationErrors.date),
-    drawer: zod_1.z.literal(types_1.INVOICE_DRAWER.INVOICE_COMPANY_FORM_DRAWER),
+    invoiceMode: zod_1.z.literal(util_functions_1.QUOTE_INVOICE_MODE.COMPANY),
     expiryDate: zod_1.z.string().nonempty(constants_1.validationErrors.expiryDate),
     note: zod_1.z.string().optional(),
     ref: zod_1.z.string().nonempty(constants_1.validationErrors.ref),
@@ -98,7 +98,7 @@ var companySchema = zod_1.z.object({
 // ============================================================================
 // MAIN FORM VALIDATION (DISCRIMINATED UNION)
 // ============================================================================
-exports.formValid = zod_1.z.discriminatedUnion("drawer", [
+exports.formValid = zod_1.z.discriminatedUnion("invoiceMode", [
     customerSchema,
     companySchema,
 ]);

package/base-modules/payment/cache.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Payment Cache
+ *
+ * Client-side caching utilities for payment data.
+ * Uses localStorage-backed cache to reduce redundant API calls.
+ */
+import { PaymentBE, type ListResponse } from "@react-pakistan/util-functions";
+export declare const getCachedPaymentsSync: () => ListResponse<PaymentBE> | null;
+export declare const getCachedPayments: ({ params, }?: {
+    params?: Record<string, unknown>;
+}) => Promise<ListResponse<PaymentBE>>;
+export declare const getCachedPaymentById: (paymentId: string) => PaymentBE | null;
+export declare const invalidatePaymentsCache: () => void;
+export declare const preloadPayments: () => Promise<ListResponse<PaymentBE>>;
+export declare const isPaymentsCacheStale: () => boolean;

package/base-modules/payment/cache.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Payment Cache
+ *
+ * Client-side caching utilities for payment data.
+ * Uses localStorage-backed cache to reduce redundant API calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPaymentsCacheStale = exports.preloadPayments = exports.invalidatePaymentsCache = exports.getCachedPaymentById = exports.getCachedPayments = exports.getCachedPaymentsSync = void 0;
+var util_functions_1 = require("@react-pakistan/util-functions");
+var constants_1 = require("./constants");
+// ============================================================================
+// CACHE CONFIG
+// ============================================================================
+var PAYMENTS_CACHE_KEY = "stellar_payments_cache";
+var PAYMENT_CACHE_CONFIG = {
+    apiUrl: constants_1.PAYMENT_API_ROUTES.UNIT,
+    cacheKey: PAYMENTS_CACHE_KEY,
+};
+// ============================================================================
+// CACHE UTILITIES
+// ============================================================================
+var getCachedPaymentsSync = function () {
+    return (0, util_functions_1.getCachedDataSync)(PAYMENTS_CACHE_KEY);
+};
+exports.getCachedPaymentsSync = getCachedPaymentsSync;
+var getCachedPayments = function (_a) {
+    var _b = _a === void 0 ? {} : _a, params = _b.params;
+    return (0, util_functions_1.getCachedData)({
+        config: PAYMENT_CACHE_CONFIG,
+        params: params,
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
+        },
+    });
+};
+exports.getCachedPayments = getCachedPayments;
+var getCachedPaymentById = function (paymentId) {
+    return (0, util_functions_1.getCachedItemById)(PAYMENTS_CACHE_KEY, paymentId);
+};
+exports.getCachedPaymentById = getCachedPaymentById;
+var invalidatePaymentsCache = function () {
+    return (0, util_functions_1.invalidateCache)(PAYMENTS_CACHE_KEY);
+};
+exports.invalidatePaymentsCache = invalidatePaymentsCache;
+var preloadPayments = function () {
+    return (0, util_functions_1.preloadCache)(PAYMENT_CACHE_CONFIG);
+};
+exports.preloadPayments = preloadPayments;
+var isPaymentsCacheStale = function () { return (0, util_functions_1.isCacheStale)(PAYMENTS_CACHE_KEY); };
+exports.isPaymentsCacheStale = isPaymentsCacheStale;

package/base-modules/payment/constants.d.ts

@@ -20,24 +20,11 @@ export declare const pageLimit: number;
 /**
  * Validation error keys for i18n translation
  */
-export declare const VALIDATION_KEYS: {
-    amount: string;
-    attachment: string;
-    balance: string;
-    currency: string;
-    date: string;
-    description: string;
-    paymentMode: string;
-    paymentType: string;
-    quoteInvoice: string;
-    ref: string;
-};
 /**
  * API routes for payment-related operations
  */
 export declare const PAYMENT_API_ROUTES: {
-    readonly PAYMENT: "/api/payment";
-    readonly PAYMENT_BY_ID: "/api/payment/payment-by-id";
+    readonly UNIT: "/api/payment";
     readonly PAYMENT_MODES: "/api/payment-modes";
     readonly PAYMENTS: "/api/payments";
     readonly QUOTE_INVOICES: "/api/quotes-invoices";

package/base-modules/payment/constants.js

@@ -15,7 +15,7 @@
 "use client";
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uiMessages = exports.validationError = exports.formInfo = exports.tableBodyCols = exports.PAYMENT_API_ROUTES = exports.VALIDATION_KEYS = exports.pageLimit = void 0;
+exports.uiMessages = exports.validationError = exports.formInfo = exports.tableBodyCols = exports.PAYMENT_API_ROUTES = exports.pageLimit = void 0;
 var enhanced_table_1 = require("@appcorp/shadcn/components/enhanced-table");
 var util_functions_1 = require("@react-pakistan/util-functions");
 // ============================================================================
@@ -31,18 +31,6 @@ exports.pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT);
 /**
  * Validation error keys for i18n translation
  */
-exports.VALIDATION_KEYS = {
-    amount: "validationAmountRequired",
-    attachment: "validationAttachmentInvalid",
-    balance: "validationBalanceInvalid",
-    currency: "validationCurrencyRequired",
-    date: "validationDateRequired",
-    description: "validationDescriptionInvalid",
-    paymentMode: "validationPaymentModeRequired",
-    paymentType: "validationPaymentTypeRequired",
-    quoteInvoice: "validationQuoteInvoiceRequired",
-    ref: "validationRefInvalid",
-};
 // ============================================================================
 // API ROUTES
 // ============================================================================
@@ -50,8 +38,7 @@ exports.VALIDATION_KEYS = {
  * API routes for payment-related operations
  */
 exports.PAYMENT_API_ROUTES = {
-    PAYMENT: "/api/payment",
-    PAYMENT_BY_ID: "/api/payment/payment-by-id",
+    UNIT: "/api/payment",
     PAYMENT_MODES: "/api/payment-modes",
     PAYMENTS: "/api/payments",
     QUOTE_INVOICES: "/api/quotes-invoices",