kcommons 9.50.3 → 9.51.1

package/build/index.d.ts

@@ -1,3 +1,4 @@
+export * from "date-fns";
 export * from "./typings/roles.typings";
 export * from "./typings/companyVendors.typings";
 export * from "./typings/department.typings";
@@ -75,6 +76,7 @@ export * from "./utils/getMediaName.util";
 export * from "./utils/removeQueryParamsFromReqStr.util";
 export * from "./utils/toFixedDecimal.util";
 export * from "./utils/convertToINS.util";
+export * from "./utils/convertDurationToreadableFormat.util";
 export * from "./typings/verification_apis/pincode.typings";
 export * from "./typings/verification_apis/gstVerification.typings";
 export * from "./typings/verification_apis/udyamVerification.typings";
@@ -88,6 +90,11 @@ export * from "./typings/kpis/company/item/itemDashboardKPICards.typings";
 export * from "./typings/kpis/company/item/issuanceVsProcurementRatio.typings";
 export * from "./typings/kpis/company/item/itemPurchaseTrend.typings";
 export * from "./typings/kpis/company/item/stockTrend.typings";
+export * from "./typings/kpis/company/vendor/totalBusiness.typings";
+export * from "./typings/kpis/company/vendor/companyVendorPurchaseFlow.typings";
+export * from "./typings/kpis/company/vendor/topCompanyVendorItems.typings";
+export * from "./typings/kpis/company/vendor/topCompanyVendorItemCategories.typings";
+export * from "./typings/kpis/company/vendor/companyVendornegotiationgain.typings";
 export * from "./typings/kpis/company/companyKpisCommons.typings";
 export * from "./typings/kpis/vendor/vendorKpisCommons.typings";
 export * from "./typings/kpis/company/testKpi.typings";

package/build/index.js

@@ -14,6 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// Libraries
+__exportStar(require("date-fns"), exports);
 // Includes
 __exportStar(require("./typings/roles.typings"), exports);
 __exportStar(require("./typings/companyVendors.typings"), exports);
@@ -96,6 +98,7 @@ __exportStar(require("./utils/getMediaName.util"), exports);
 __exportStar(require("./utils/removeQueryParamsFromReqStr.util"), exports);
 __exportStar(require("./utils/toFixedDecimal.util"), exports);
 __exportStar(require("./utils/convertToINS.util"), exports);
+__exportStar(require("./utils/convertDurationToreadableFormat.util"), exports);
 // Templates
 // Verification APIs
 __exportStar(require("./typings/verification_apis/pincode.typings"), exports);
@@ -114,9 +117,16 @@ __exportStar(require("./typings/kpis/company/item/itemDashboardKPICards.typings"
 __exportStar(require("./typings/kpis/company/item/issuanceVsProcurementRatio.typings"), exports);
 __exportStar(require("./typings/kpis/company/item/itemPurchaseTrend.typings"), exports);
 __exportStar(require("./typings/kpis/company/item/stockTrend.typings"), exports);
+// Company Vendor Dashboard KPIs
+__exportStar(require("./typings/kpis/company/vendor/totalBusiness.typings"), exports);
+__exportStar(require("./typings/kpis/company/vendor/companyVendorPurchaseFlow.typings"), exports);
+__exportStar(require("./typings/kpis/company/vendor/topCompanyVendorItems.typings"), exports);
+__exportStar(require("./typings/kpis/company/vendor/topCompanyVendorItemCategories.typings"), exports);
+__exportStar(require("./typings/kpis/company/vendor/companyVendornegotiationgain.typings"), exports);
 // Common KPIs
 __exportStar(require("./typings/kpis/company/companyKpisCommons.typings"), exports);
 __exportStar(require("./typings/kpis/vendor/vendorKpisCommons.typings"), exports);
+``;
 // Company KPIs
 __exportStar(require("./typings/kpis/company/testKpi.typings"), exports);
 __exportStar(require("./typings/kpis/company/purchase/testPuchaseKpi.typings"), exports);

package/build/typings/kpis/basKPIS.typings.d.ts

@@ -1,4 +1,4 @@
-export interface IBaseKPIProps {
+export interface IBaseKPIFilters {
     company_id: string;
     start_date: string;
     end_date: string;

package/build/typings/kpis/company/item/issuanceVsProcurementRatio.typings.d.ts

@@ -1,5 +1,5 @@
-import { IBaseKPIProps } from "../../basKPIS.typings";
-export interface IIssuanceVsProcurementRatioReq extends IBaseKPIProps {
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface IIssuanceVsProcurementRatioReq extends IBaseKPIFilters {
     item_id: string;
 }
 export interface IItemIssuanceVsProcurementRatioData {

package/build/typings/kpis/company/item/itemDashboardKPICards.typings.d.ts

@@ -1,5 +1,5 @@
-import { IBaseKPIProps } from "../../basKPIS.typings";
-export interface IItemDashboardKPICardsReq extends IBaseKPIProps {
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface IItemDashboardKPICardsReq extends IBaseKPIFilters {
     item_id: string;
 }
 export interface IItemDashboardKPICardsData {

package/build/typings/kpis/company/item/itemPurchaseTrend.typings.d.ts

@@ -1,5 +1,5 @@
-import { IBaseKPIProps } from "../../basKPIS.typings";
-export interface IItemPurchaseTrendReqFilters extends IBaseKPIProps {
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface IItemPurchaseTrendReqFilters extends IBaseKPIFilters {
     item_id: string;
 }
 export interface IItemPurchaseTrendData {

package/build/typings/kpis/company/item/itempriceTrend.typings.d.ts

@@ -1,11 +1,11 @@
-import { IBaseKPIProps } from "../../basKPIS.typings";
-export interface IItemPriceTrendReqFilters extends IBaseKPIProps {
-    item_id: string;
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface IItemPriceTrendReqFilters extends IBaseKPIFilters {
+  item_id: string;
 }
 export interface IItemPriceTrendData {
-    data: {
-        values: number[];
-        labels: string[];
-        average: number;
-    };
+  data: {
+    values: number[];
+    labels: string[];
+    average: number;
+  };
 }

package/build/typings/kpis/company/item/stockTrend.typings.d.ts

@@ -1,5 +1,5 @@
-import { IBaseKPIProps } from "../../basKPIS.typings";
-export interface IItemStockTrendKPIReqFilters extends IBaseKPIProps {
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface IItemStockTrendKPIReqFilters extends IBaseKPIFilters {
     item_id: string;
 }
 export interface IItemStockTrendKPIUnit {

package/build/typings/kpis/company/main/purchase/avgVendorResponseRatePerRFQKPI.typings.d.ts

@@ -1,4 +1,4 @@
-import { IBaseKPIProps } from "../../../basKPIS.typings";
+import { IBaseKPIFilters } from "../../../basKPIS.typings";
 export interface IAvgVendorResponseRatePerRFQKPIUnit {
     xlabel: string;
     rfqs: number;
@@ -11,5 +11,5 @@ export interface IAvgVendorResponseRatePerRFQKPIResponse {
     data: IAvgVendorResponseRatePerRFQKPIUnit[];
     meta: IMetaFieldForAvgVendorResponseRAteKPI;
 }
-export interface IAvgVendorResponseRatePerRFQKPIReq extends IBaseKPIProps {
+export interface IAvgVendorResponseRatePerRFQKPIReq extends IBaseKPIFilters {
 }

package/build/typings/kpis/company/main/purchase/purchaseTrend.typings.d.ts

@@ -1,4 +1,4 @@
-import { IBaseKPIProps } from "../../../basKPIS.typings";
+import { IBaseKPIFilters } from "../../../basKPIS.typings";
 export interface IPurchaseTrendKPIDataUnit {
     x: string;
     y: number;
@@ -6,5 +6,5 @@ export interface IPurchaseTrendKPIDataUnit {
 export interface IPurchaseTrendKPIResponse {
     data: IPurchaseTrendKPIDataUnit[];
 }
-export interface IPurchaseTrendKPIReq extends IBaseKPIProps {
+export interface IPurchaseTrendKPIReq extends IBaseKPIFilters {
 }

package/build/typings/kpis/company/main/purchase/topProcurementCategories.typings.d.ts

@@ -1,5 +1,5 @@
-import { IBaseKPIProps } from "../../../basKPIS.typings";
-export interface ITopProcurementCategoriesKPIReq extends IBaseKPIProps {
+import { IBaseKPIFilters } from "../../../basKPIS.typings";
+export interface ITopProcurementCategoriesKPIReq extends IBaseKPIFilters {
 }
 export interface ITopProcurementCategoriesKPIUnit {
     name: string;

package/build/typings/kpis/company/main/purchase/totalSavings.typings.d.ts

@@ -1,4 +1,4 @@
-import { IBaseKPIProps } from "../../../basKPIS.typings";
+import { IBaseKPIFilters } from "../../../basKPIS.typings";
 export interface ITotalSavingsKPIDataUnit {
     x: string;
     y: number;
@@ -6,5 +6,5 @@ export interface ITotalSavingsKPIDataUnit {
 export interface ITotalSavingsKPIResponse {
     data: ITotalSavingsKPIDataUnit[];
 }
-export interface ITotalSavingsKPIReq extends IBaseKPIProps {
+export interface ITotalSavingsKPIReq extends IBaseKPIFilters {
 }

package/build/typings/kpis/company/main/vendors/topCategoryvendorDistribution.typings.d.ts

@@ -1,6 +1,6 @@
-import { IBaseKPIProps } from "../../../basKPIS.typings";
+import { IBaseKPIFilters } from "../../../basKPIS.typings";
 export interface ITopCategoryVendorDistributionKPIReq {
-    company_id: IBaseKPIProps["company_id"];
+    company_id: IBaseKPIFilters["company_id"];
 }
 export interface ITopCategoryVendorDistributionKPIUnit {
     id: string;

package/build/typings/kpis/company/vendor/companyVendorPurchaseFlow.typings.d.ts

@@ -0,0 +1,22 @@
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface ICompanyVendorPurchaseFlowKPIFilters extends Pick<IBaseKPIFilters, "company_id"> {
+    vendor_id: string;
+}
+export interface ICompanyVendorPurchaseFlowKPIResponse {
+    totals: {
+        rfq: number | null;
+        quoted: number | null;
+        po_send: number | null;
+        po_accepted: number | null;
+    };
+    avg_time_taken: {
+        rfq_quote: string | null;
+        quote_po_sent: string | null;
+        po_sent_po_accepted: string | null;
+    };
+    conversion_rate_percentage: {
+        rfq_quote: number | null;
+        quote_po_sent: number | null;
+        po_sent_po_accepted: number | null;
+    };
+}

package/build/typings/kpis/company/vendor/companyVendorPurchaseFlow.typings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/typings/kpis/company/vendor/companyVendornegotiationgain.typings.d.ts

@@ -0,0 +1,13 @@
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface ICompanyVendorNegotiationGainKPIFilters extends Pick<IBaseKPIFilters, "company_id"> {
+    vendor_id: string;
+}
+export interface IRecentNegotiatedRFQData {
+    rfq_no: string;
+    savings: number | null;
+}
+export interface ICompanyVendorNegotiationGainKPIResponse {
+    avg_negotiation_gain_percentage: number | null;
+    total_amount_saved: number | null;
+    recent_negotiated_rfqs: IRecentNegotiatedRFQData[];
+}

package/build/typings/kpis/company/vendor/companyVendornegotiationgain.typings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/typings/kpis/company/vendor/topCompanyVendorItemCategories.typings.d.ts

@@ -0,0 +1,11 @@
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface ITopCompanyVendorItemCategoriesKPIFilters extends IBaseKPIFilters {
+    company_vendor_id: string;
+}
+export interface ITopCompanyVendorItemCategoriesKPIResponseUnit {
+    category_name: string;
+    value: number;
+}
+export interface ITopCompanyVendorItemCategoriesKPIResponse {
+    data: ITopCompanyVendorItemCategoriesKPIResponseUnit[];
+}

package/build/typings/kpis/company/vendor/topCompanyVendorItemCategories.typings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/typings/kpis/company/vendor/topCompanyVendorItems.typings.d.ts

@@ -0,0 +1,14 @@
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface ITopCompanyVendorItemsKPIFilters extends IBaseKPIFilters {
+    company_vendor_id: string;
+}
+export interface ITopCompanyVendorItemsKPIResponseUnit {
+    item_name: string;
+    uom: string;
+    total_supplied_qty: number | null;
+    avg_per_unit_rate: number | null;
+    total_supplied_value: number | null;
+}
+export interface ITopCompanyVendorItemsKPIResponse {
+    data: ITopCompanyVendorItemsKPIResponseUnit[];
+}

package/build/typings/kpis/company/vendor/topCompanyVendorItems.typings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/typings/kpis/company/vendor/topvendorItems.typings.d.ts

@@ -0,0 +1,13 @@
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface ITopVendorItemsKPIFilters extends IBaseKPIFilters {
+    company_vendor_id: string;
+}
+export interface ITopVendorItemsKPIResponseUnit {
+    item_name: string;
+    total_supplied_qty: number | null;
+    avg_per_unit_rate: number | null;
+    total_supplied_value: number | null;
+}
+export interface ITopVendorItemsKPIResponse {
+    data: ITopVendorItemsKPIResponseUnit[];
+}

package/build/typings/kpis/company/vendor/topvendorItems.typings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/typings/kpis/company/vendor/totalBusiness.typings.d.ts

@@ -0,0 +1,14 @@
+import { IBaseKPIFilters } from "../../basKPIS.typings";
+export interface ITotalBusinessWithVendorKPIFilters extends Pick<IBaseKPIFilters, "company_id"> {
+    company_vendor_id: string;
+}
+export interface ITotalBusinessWithVendorKPIResponse {
+    total_business: {
+        value: number;
+        vendor_trade_name: string;
+    };
+    avg_po_value: {
+        avg_value: number;
+        total_po_count: number;
+    };
+}

package/build/typings/kpis/company/vendor/totalBusiness.typings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/typings/quote.typings.d.ts

@@ -48,6 +48,8 @@ export interface IQuote {
     company_id: string;
     quote_no: string;
     is_quoted: boolean;
+    initial_total?: number | null;
+    initial_subtotal?: number | null;
     total?: number | null;
     subtotal?: number | null;
     delivery_by_date: string | null;

package/build/utils/convertDurationToreadableFormat.util.d.ts

@@ -0,0 +1 @@
+export declare function convertDurationToReadableFormat(diffMs: number): string;

package/build/utils/convertDurationToreadableFormat.util.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertDurationToReadableFormat = convertDurationToReadableFormat;
+function convertDurationToReadableFormat(diffMs) {
+    const MS = {
+        second: 1000,
+        minute: 1000 * 60,
+        hour: 1000 * 60 * 60,
+        day: 1000 * 60 * 60 * 24,
+        week: 1000 * 60 * 60 * 24 * 7,
+        month: 1000 * 60 * 60 * 24 * 30, // Approximation
+    };
+    const months = Math.floor(diffMs / MS.month);
+    diffMs %= MS.month;
+    const weeks = Math.floor(diffMs / MS.week);
+    diffMs %= MS.week;
+    const days = Math.floor(diffMs / MS.day);
+    diffMs %= MS.day;
+    const hours = Math.floor(diffMs / MS.hour);
+    diffMs %= MS.hour;
+    const minutes = Math.floor(diffMs / MS.minute);
+    diffMs %= MS.minute;
+    const seconds = Math.floor(diffMs / MS.second);
+    // Apply your rules
+    if (months > 0) {
+        return [
+            months > 0 ? `${months} month${months > 1 ? "s" : ""}` : "",
+            weeks > 0 ? `${weeks} week${weeks > 1 ? "s" : ""}` : "",
+            days > 0 ? `${days} day${days > 1 ? "s" : ""}` : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+    }
+    else if (weeks > 0) {
+        return [
+            weeks > 0 ? `${weeks} week${weeks > 1 ? "s" : ""}` : "",
+            days > 0 ? `${days} day${days > 1 ? "s" : ""}` : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+    }
+    else if (days > 0) {
+        return [
+            days > 0 ? `${days} day${days > 1 ? "s" : ""}` : "",
+            hours > 0 ? `${hours} hr${hours > 1 ? "s" : ""}` : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+    }
+    else if (hours > 0) {
+        return [
+            hours > 0 ? `${hours} hr${hours > 1 ? "s" : ""}` : "",
+            minutes > 0 ? `${minutes} min` : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+    }
+    else {
+        return [
+            minutes > 0 ? `${minutes} min` : "",
+            seconds > 0 ? `${seconds} sec` : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+    }
+}
+// // Example usage
+// const start = new Date('2025-08-01T10:00:00Z');
+// const end = new Date('2025-08-09T16:30:45Z');
+// console.log(formatDurationBetween(start, end)); // "1 week 1 day"
+// console.log(formatDurationBetween(new Date(), new Date(Date.now() + 90 * 60 * 1000))); // "1 hr 30 min"
+// console.log(formatDurationBetween(new Date(), new Date(Date.now() + 50 * 1000))); // "50 sec"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kcommons",
-  "version": "9.50.3",
+  "version": "9.51.1",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -13,6 +13,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
+    "date-fns": "^4.1.0",
     "uuid": "^11.1.0"
   }
 }