kcommons 18.25.6 → 18.26.0

package/build/enums/upload.enum.d.ts

@@ -20,6 +20,7 @@ export declare enum UPLOAD_PATH_IDS {
     VENDOR_EXCEL_UPLOAD = "VENDOR_EXCEL_UPLOAD",
     ITEM_EXCEL_UPLOAD = "ITEM_EXCEL_UPLOAD",
     SUPPLIER_INVOICE_ATTACHMENT = "SUPPLIER_INVOICE_ATTACHMENT",
-    SUPPLIER_INVOICE_ITEMS_ATTACHMENT = "SUPPLIER_INVOICE_ITEMS_ATTACHMENT"
+    SUPPLIER_INVOICE_ITEMS_ATTACHMENT = "SUPPLIER_INVOICE_ITEMS_ATTACHMENT",
+    REPORTS_SCHEDULED = "REPORTS_SCHEDULED"
 }
 export declare const UPLOAD_PATHS_CONFIG: Record<UPLOAD_PATH_IDS, (fileExtension: string) => string>;

package/build/enums/upload.enum.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UPLOAD_PATHS_CONFIG = exports.UPLOAD_PATH_IDS = void 0;
+const uuid_1 = require("uuid");
 const uploadMedia_typings_1 = require("../typings/common/uploadMedia.typings");
 var UPLOAD_PATH_IDS;
 (function (UPLOAD_PATH_IDS) {
@@ -26,6 +27,7 @@ var UPLOAD_PATH_IDS;
     UPLOAD_PATH_IDS["ITEM_EXCEL_UPLOAD"] = "ITEM_EXCEL_UPLOAD";
     UPLOAD_PATH_IDS["SUPPLIER_INVOICE_ATTACHMENT"] = "SUPPLIER_INVOICE_ATTACHMENT";
     UPLOAD_PATH_IDS["SUPPLIER_INVOICE_ITEMS_ATTACHMENT"] = "SUPPLIER_INVOICE_ITEMS_ATTACHMENT";
+    UPLOAD_PATH_IDS["REPORTS_SCHEDULED"] = "REPORTS_SCHEDULED";
 })(UPLOAD_PATH_IDS || (exports.UPLOAD_PATH_IDS = UPLOAD_PATH_IDS = {}));
 exports.UPLOAD_PATHS_CONFIG = {
     INDENT_ATTACHMENT: (extension) => `v2/company/indents/attachments/indent_attachment_${Date.now()}.${extension}?mediaAccessType=${uploadMedia_typings_1.MEDIA_ACCEESS_TYPE.PRIVATE}`,
@@ -50,4 +52,5 @@ exports.UPLOAD_PATHS_CONFIG = {
     GRN_EXCEL_UPLOAD: (extension) => `v2/company/excel-uploads/grn/grn_excel_${Date.now()}.${extension}?mediaAccessType=${uploadMedia_typings_1.MEDIA_ACCEESS_TYPE.PRIVATE}`,
     VENDOR_EXCEL_UPLOAD: (extension) => `v2/company/excel-uploads/vendor/vendor_excel_${Date.now()}.${extension}?mediaAccessType=${uploadMedia_typings_1.MEDIA_ACCEESS_TYPE.PRIVATE}`,
     ITEM_EXCEL_UPLOAD: (extension) => `v2/company/excel-uploads/item/item_excel_${Date.now()}.${extension}?mediaAccessType=${uploadMedia_typings_1.MEDIA_ACCEESS_TYPE.PRIVATE}`,
+    REPORTS_SCHEDULED: (extension) => `reports/${(0, uuid_1.v4)()}.${extension}?mediaAccessType=${uploadMedia_typings_1.MEDIA_ACCEESS_TYPE.PRIVATE}`,
 };

package/build/index.d.ts

@@ -109,6 +109,8 @@ export * from "./typings/freightOrder.typings";
 export * from "./typings/system/queueJob.typings";
 export * from "./typings/system/erpPluginConfigCompany.typings";
 export * from "./typings/system/erpPluginsMetadata.typings";
+export * from "./typings/system/reportsPluginConfigCompany.typings";
+export * from "./typings/system/reportScheduleRecipient.typings";
 export * from "./typings/common/address.typings";
 export * from "./typings/common/paginationFilters.typings";
 export * from "./typings/common/uploadMedia.typings";
@@ -153,6 +155,7 @@ export * from "./utils/removeQueryParamsFromReqStr.util";
 export * from "./utils/toFixedDecimal.util";
 export * from "./utils/convertToINS.util";
 export * from "./utils/convertDurationToreadableFormat.util";
+export * from "./utils/calculateNextRunAt.util";
 export * from "./utils/businessTime.util";
 export * from "./utils/extra-form/formatValidationSchema.util";
 export * from "./utils/extra-form/getFormProps.util";
@@ -211,11 +214,14 @@ export * from "./typings/vendor/vendorPermission.typings";
 export * from "./typings/vendor/vendorRole.typings";
 export * from "./typings/vendor/vendorUser.typings";
 export * from "./helpers/padNumber.helper";
+export * from "./typings/plugins/reports.plugins";
 export * from "./typings/companyConfig.typings";
+export * from "./typings/reports/hsfpl/hsfpl_haltingVehicles.typings";
 export * from "./utils/validators/gst.validator";
 export * from "./utils/validators/pan.validator";
 export * from "./utils/validators/cin.validator";
 export * from "./utils/validators/udyam.validator";
+export * from "./typings/reports/hsfpl/hsfpl_haltingVehicles.typings";
 export interface ITesting {
     message: string;
     age: number;

package/build/index.js

@@ -130,6 +130,8 @@ __exportStar(require("./typings/freightOrder.typings"), exports);
 __exportStar(require("./typings/system/queueJob.typings"), exports);
 __exportStar(require("./typings/system/erpPluginConfigCompany.typings"), exports);
 __exportStar(require("./typings/system/erpPluginsMetadata.typings"), exports);
+__exportStar(require("./typings/system/reportsPluginConfigCompany.typings"), exports);
+__exportStar(require("./typings/system/reportScheduleRecipient.typings"), exports);
 // Commons
 __exportStar(require("./typings/common/address.typings"), exports);
 __exportStar(require("./typings/common/paginationFilters.typings"), exports);
@@ -179,6 +181,7 @@ __exportStar(require("./utils/removeQueryParamsFromReqStr.util"), exports);
 __exportStar(require("./utils/toFixedDecimal.util"), exports);
 __exportStar(require("./utils/convertToINS.util"), exports);
 __exportStar(require("./utils/convertDurationToreadableFormat.util"), exports);
+__exportStar(require("./utils/calculateNextRunAt.util"), exports);
 __exportStar(require("./utils/businessTime.util"), exports);
 __exportStar(require("./utils/extra-form/formatValidationSchema.util"), exports);
 __exportStar(require("./utils/extra-form/getFormProps.util"), exports);
@@ -254,9 +257,13 @@ __exportStar(require("./typings/vendor/vendorUser.typings"), exports);
 // Helpers
 __exportStar(require("./helpers/padNumber.helper"), exports);
 // Plugins
+__exportStar(require("./typings/plugins/reports.plugins"), exports);
 __exportStar(require("./typings/companyConfig.typings"), exports);
+__exportStar(require("./typings/reports/hsfpl/hsfpl_haltingVehicles.typings"), exports);
 // Validators
 __exportStar(require("./utils/validators/gst.validator"), exports);
 __exportStar(require("./utils/validators/pan.validator"), exports);
 __exportStar(require("./utils/validators/cin.validator"), exports);
 __exportStar(require("./utils/validators/udyam.validator"), exports);
+// For Reports
+__exportStar(require("./typings/reports/hsfpl/hsfpl_haltingVehicles.typings"), exports);

package/build/typings/company.typings.d.ts

@@ -77,6 +77,7 @@ import { INestedTransporterDocumentManualVerificationByCompany } from "./common/
 import { INestedTransporterGroups } from "./transporterGroup.typings";
 import { INestedVehicle } from "./vehicle.typings";
 import { INestedTransporterLogs } from "./transporterLogs.typings";
+import { INestedReportsPluginConfigCompany } from "./system/reportsPluginConfigCompany.typings";
 export declare enum PRICING_PLANS {
     BASIC = "BASIC",
     GROWTH = "GROWTH",
@@ -144,6 +145,7 @@ export declare enum COMPANY_INCLUDE {
     company_terms_and_conditions = "company_terms_and_conditions",
     company_config = "company_config",
     erp_plugins = "erp_plugins",
+    report_plugins = "report_plugins",
     company_temporary_worker_form = "company_temporary_worker_form",
     company_amended_po_items = "company_amended_po_items",
     sub_pos = "sub_pos",
@@ -259,6 +261,7 @@ export interface ICompany extends IAddress {
     company_terms_and_conditions: INestedTermsAndConditions[] | null;
     payment_terms: INestedPaymentTerms[] | null;
     erp_plugins: INestedERPPluginConfigCompany[] | null;
+    report_plugins: INestedReportsPluginConfigCompany[] | null;
     company_temporary_worker_form: INestedTemporaryWorkerForm[] | null;
     sub_pos: INestedSubPO[] | null;
     sub_po_items: INestedSubPOItem[] | null;
@@ -288,7 +291,7 @@ export interface ICompany extends IAddress {
     company_fo_vehicles: INestedFOVehicle[] | null;
     transporter_logs: INestedTransporterLogs[] | null;
 }
-export interface INestedCompany extends Omit<ICompany, "associated_purchase_locations" | "associated_vendors" | "associated_permissions" | "associated_roles" | "approval_configs" | "subdepartments" | "subcategories" | "categories" | "items" | "offices" | "stores" | "employees" | "departments" | "vendor_groups" | "company_indents" | "indent_items" | "company_mis" | "mi_items" | "company_prs" | "pr_items" | "company_rfqs" | "company_quotes" | "entity_approval_chain_entries" | "company_negotiations" | "company_pos" | "company_grns" | "company_grns_items" | "company_mrns" | "company_mrns_items" | "company_boms" | "company_bom_items" | "company_comparatives" | "company_comparative_items" | "company_notifications" | "extra_question_ans" | "extra_core_related_questions" | "company_specific_vendor_items" | "po_asn_items_junction" | "company_contact_people" | "company_item_vendor_versions" | "istds" | "istd_items" | "inventory_logs" | "invoices" | "logs" | "vendor_onboarding_requests" | "vendor_management_bodies" | "item_management_bodies" | "rollback_forms_sent_by_company" | "company_checkpoints" | "company_ves" | "queue_jobs" | "company_terms_and_conditions" | "company_config" | "erp_plugins" | "company_temporary_worker_form" | "extra_questions" | "is_deleted" | "payment_terms" | "po_grn_items_junction" | "vendor_onboarding_request_categories" | "company_amended_po_items" | "sub_pos" | "sub_po_items" | "item_questionnaire" | "rfq_questionnaire" | "rfq_questionnaire_answers" | "company_customer_categories" | "associated_customer" | "customer_management_bodies" | "qa_locations" | "accounts_locations" | "vendor_documents_manual_verification_by_company" | "erp_plugings_metadata" | "invoice" | "quality_clearance_documents" | "audits" | "approval_comments" | "vendor_logs" | "imr_fine_masters" | "transporter_documents_manual_verification_by_company" | "created_transporter_groups" | "vehicles" | "company_freight_quotes" | "company_freight_comparatives" | "company_freight_comparative_vehicles" | "company_fos" | "company_fo_vehicles"> {
+export interface INestedCompany extends Omit<ICompany, "associated_purchase_locations" | "associated_vendors" | "associated_permissions" | "associated_roles" | "approval_configs" | "subdepartments" | "subcategories" | "categories" | "items" | "offices" | "stores" | "employees" | "departments" | "vendor_groups" | "company_indents" | "indent_items" | "company_mis" | "mi_items" | "company_prs" | "pr_items" | "company_rfqs" | "company_quotes" | "entity_approval_chain_entries" | "company_negotiations" | "company_pos" | "company_grns" | "company_grns_items" | "company_mrns" | "company_mrns_items" | "company_boms" | "company_bom_items" | "company_comparatives" | "company_comparative_items" | "company_notifications" | "extra_question_ans" | "extra_core_related_questions" | "company_specific_vendor_items" | "po_asn_items_junction" | "company_contact_people" | "company_item_vendor_versions" | "istds" | "istd_items" | "inventory_logs" | "invoices" | "logs" | "vendor_onboarding_requests" | "vendor_management_bodies" | "item_management_bodies" | "rollback_forms_sent_by_company" | "company_checkpoints" | "company_ves" | "queue_jobs" | "company_terms_and_conditions" | "company_config" | "erp_plugins" | "company_temporary_worker_form" | "extra_questions" | "is_deleted" | "payment_terms" | "po_grn_items_junction" | "vendor_onboarding_request_categories" | "company_amended_po_items" | "sub_pos" | "sub_po_items" | "item_questionnaire" | "rfq_questionnaire" | "rfq_questionnaire_answers" | "company_customer_categories" | "associated_customer" | "customer_management_bodies" | "qa_locations" | "accounts_locations" | "vendor_documents_manual_verification_by_company" | "erp_plugings_metadata" | "invoice" | "quality_clearance_documents" | "audits" | "approval_comments" | "vendor_logs" | "report_plugins" | "imr_fine_masters" | "transporter_documents_manual_verification_by_company" | "created_transporter_groups" | "vehicles" | "company_freight_quotes" | "company_freight_comparatives" | "company_freight_comparative_vehicles" | "company_fos" | "company_fo_vehicles" | "transporter_logs" | "report_plugins"> {
 }
 export interface ICompanyVendorAdditionalInfoMappingConfig {
     additional_info_form_que_id: string;

package/build/typings/company.typings.js

@@ -68,6 +68,7 @@ var COMPANY_INCLUDE;
     COMPANY_INCLUDE["company_terms_and_conditions"] = "company_terms_and_conditions";
     COMPANY_INCLUDE["company_config"] = "company_config";
     COMPANY_INCLUDE["erp_plugins"] = "erp_plugins";
+    COMPANY_INCLUDE["report_plugins"] = "report_plugins";
     COMPANY_INCLUDE["company_temporary_worker_form"] = "company_temporary_worker_form";
     COMPANY_INCLUDE["company_amended_po_items"] = "company_amended_po_items";
     COMPANY_INCLUDE["sub_pos"] = "sub_pos";

package/build/typings/plugins/haltingVehicles.typings.d.ts

@@ -0,0 +1,150 @@
+export declare enum HSFPL_HALTING_VEHICLE_APPROVAL {
+  AWAITING = "AWAITING",
+  APPROVED = "APPROVED",
+}
+export declare enum HSFPL_HALTING_VEHICLE_INVOICE_STATUS {
+  VERIFIED = "VERIFIED",
+  RAISED = "RAISED",
+  INVALID = "INVALID",
+}
+export declare enum HSFPL_HALTING_VEHICLE_ACTION_TYPE {
+  WAITING_FOR_APPROVAL = "WAITING_FOR_APPROVAL",
+  APPROVED_NOT_SENT = "APPROVED_NOT_SENT",
+  NO_PO_ON_INVOICE = "NO_PO_ON_INVOICE",
+}
+export interface IHSFPL_HaltingVehiclesReportOptions {
+  halt_alert_after_days: number;
+}
+export interface IHSFPL_HaltingVehiclesReportMeta {
+  company_name: string;
+  company_code: string;
+  company_logo_url: string | null;
+  location_city: string | null;
+  location_name: string;
+  location_code: string;
+  generated_at: Date;
+  halt_alert_after_days: number;
+}
+export interface IHSFPL_HaltingVehiclesKpis {
+  standing: number;
+  standing_longest_wait_time: string | null;
+  standing_longest_wait_minutes: number | null;
+  waiting_for_approval: number;
+  waiting_for_approval_longest_wait_time: string | null;
+  waiting_for_approval_longest_wait_minutes: number | null;
+  approved_not_sent: number;
+  approved_not_sent_longest_wait_time: string | null;
+  approved_not_sent_longest_wait_minutes: number | null;
+  no_po_on_invoice: number;
+}
+export interface IHSFPL_HaltingVehiclesTodaySummary {
+  window_start: Date;
+  window_end: Date;
+  standing_now: number;
+  standing_yesterday: number;
+  came_in: number;
+  sent: number;
+  sent_after_plant_approval: number;
+  sent_directly: number;
+}
+export interface IHSFPL_HaltingVehiclesNeedsActionPlant {
+  store_name: string;
+  vehicle_count: number;
+  ves_nos: string[];
+}
+export interface IHSFPL_HaltingVehiclesNeedsActionGroup {
+  vehicle_count: number;
+  plants: IHSFPL_HaltingVehiclesNeedsActionPlant[];
+}
+export interface IHaltingVehiclesNeedsAction {
+  awaiting_plant_approval: IHSFPL_HaltingVehiclesNeedsActionGroup | null;
+  approved_not_sent: IHSFPL_HaltingVehiclesNeedsActionGroup | null;
+  gi_blocked_no_po: IHSFPL_HaltingVehiclesNeedsActionGroup | null;
+}
+export interface IHSFPL_HaltingVehiclesPlantRow {
+  plant_name: string;
+  standing: number;
+  waiting_for_approval: number;
+  approved_not_sent: number;
+  no_po: number;
+  longest_wait_time: string | null;
+  longest_wait_minutes: number | null;
+}
+export interface IHSFPL_HaltingVehiclesAgeBucket {
+  min_days: number;
+  max_days: number | null;
+}
+export interface IHSFPL_HaltingVehiclesAgeRow {
+  plant_name: string;
+  counts: number[];
+  total: number;
+}
+export interface IHSFPL_HaltingVehiclesAgewise {
+  buckets: IHSFPL_HaltingVehiclesAgeBucket[];
+  rows: IHSFPL_HaltingVehiclesAgeRow[];
+  totals: IHSFPL_HaltingVehiclesAgeRow;
+}
+export interface IHSFPL_HaltingVehiclesMaterialRow {
+  material: string;
+  vehicles: number;
+  is_others: boolean;
+  others_materials: string[];
+}
+export interface IHSFPL_HaltingVehiclesInvalidInvoiceRow {
+  ves_no: string;
+  plant_name: string;
+  vendor_name: string;
+  invoice_no: string;
+  invoice_status: HSFPL_HALTING_VEHICLE_INVOICE_STATUS;
+  issue: string;
+  in_at_nly: Date;
+  waiting_time: string;
+}
+export interface IHSFPL_HaltingVehiclesInvoiceSection {
+  verified: number;
+  raised: number;
+  invalid: number;
+  invalid_invoices: IHSFPL_HaltingVehiclesInvalidInvoiceRow[];
+}
+export interface IHSFPL_HaltingVehicleRow {
+  ves_no: string;
+  vehicle_no: string;
+  vendor_name: string;
+  plant_name: string;
+  material: string | null;
+  extra_materials_count: number;
+  po_no: string | null;
+  extra_po_count: number;
+  approval: HSFPL_HALTING_VEHICLE_APPROVAL;
+  invoice_no: string;
+  invoice_status: HSFPL_HALTING_VEHICLE_INVOICE_STATUS;
+  in_at_nly: Date;
+  waiting_time: string;
+  waiting_minutes: number;
+}
+export interface IHSFPL_HaltingVehiclesPlantGroup {
+  plant_name: string;
+  vehicle_count: number;
+  oldest_waiting_time: string;
+  oldest_waiting_minutes: number;
+  vehicles: IHSFPL_HaltingVehicleRow[];
+}
+export interface IHSFPL_HaltingVehiclesConsistency {
+  standing_equals_waiting_plus_approved: boolean;
+  invoice_split_equals_standing: boolean;
+  today_equation_holds: boolean;
+}
+export interface IHSFPL_HaltingVehiclesReport {
+  meta: IHSFPL_HaltingVehiclesReportMeta;
+  kpis: IHSFPL_HaltingVehiclesKpis;
+  today: IHSFPL_HaltingVehiclesTodaySummary;
+  needs_action: IHaltingVehiclesNeedsAction;
+  plantwise: IHSFPL_HaltingVehiclesPlantRow[];
+  plantwise_totals: IHSFPL_HaltingVehiclesPlantRow;
+  plants_without_vehicles: string[];
+  agewise: IHSFPL_HaltingVehiclesAgewise;
+  materialwise: IHSFPL_HaltingVehiclesMaterialRow[];
+  invoice_status: IHSFPL_HaltingVehiclesInvoiceSection;
+  vehicles_by_plant: IHSFPL_HaltingVehiclesPlantGroup[];
+  consistency: IHSFPL_HaltingVehiclesConsistency;
+}

package/build/typings/plugins/haltingVehicles.typings.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HSFPL_HALTING_VEHICLE_ACTION_TYPE =
+  exports.HSFPL_HALTING_VEHICLE_INVOICE_STATUS =
+  exports.HSFPL_HALTING_VEHICLE_APPROVAL =
+    void 0;
+var HSFPL_HALTING_VEHICLE_APPROVAL;
+(function (HSFPL_HALTING_VEHICLE_APPROVAL) {
+  HSFPL_HALTING_VEHICLE_APPROVAL["AWAITING"] = "AWAITING";
+  HSFPL_HALTING_VEHICLE_APPROVAL["APPROVED"] = "APPROVED";
+})(
+  HSFPL_HALTING_VEHICLE_APPROVAL ||
+    (exports.HSFPL_HALTING_VEHICLE_APPROVAL = HSFPL_HALTING_VEHICLE_APPROVAL =
+      {}),
+);
+var HSFPL_HALTING_VEHICLE_INVOICE_STATUS;
+(function (HSFPL_HALTING_VEHICLE_INVOICE_STATUS) {
+  HSFPL_HALTING_VEHICLE_INVOICE_STATUS["VERIFIED"] = "VERIFIED";
+  HSFPL_HALTING_VEHICLE_INVOICE_STATUS["RAISED"] = "RAISED";
+  HSFPL_HALTING_VEHICLE_INVOICE_STATUS["INVALID"] = "INVALID";
+})(
+  HSFPL_HALTING_VEHICLE_INVOICE_STATUS ||
+    (exports.HSFPL_HALTING_VEHICLE_INVOICE_STATUS =
+      HSFPL_HALTING_VEHICLE_INVOICE_STATUS =
+        {}),
+);
+var HSFPL_HALTING_VEHICLE_ACTION_TYPE;
+(function (HSFPL_HALTING_VEHICLE_ACTION_TYPE) {
+  HSFPL_HALTING_VEHICLE_ACTION_TYPE["WAITING_FOR_APPROVAL"] =
+    "WAITING_FOR_APPROVAL";
+  HSFPL_HALTING_VEHICLE_ACTION_TYPE["APPROVED_NOT_SENT"] = "APPROVED_NOT_SENT";
+  HSFPL_HALTING_VEHICLE_ACTION_TYPE["NO_PO_ON_INVOICE"] = "NO_PO_ON_INVOICE";
+})(
+  HSFPL_HALTING_VEHICLE_ACTION_TYPE ||
+    (exports.HSFPL_HALTING_VEHICLE_ACTION_TYPE =
+      HSFPL_HALTING_VEHICLE_ACTION_TYPE =
+        {}),
+);

package/build/typings/plugins/reports.plugins.d.ts

@@ -0,0 +1,9 @@
+export declare enum REPORTS_PLUGIN {
+    VENDOR_STATUS_REPORTS = "VENDOR_STATUS_REPORTS",
+    HALTING_VEHICLES_REPORTS = "HALTING_VEHICLES_REPORTS"
+}
+export declare enum REPORT_FREQUENCY {
+    DAILY = "DAILY",
+    WEEKLY = "WEEKLY",
+    MONTHLY = "MONTHLY"
+}

package/build/typings/plugins/reports.plugins.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_FREQUENCY = exports.REPORTS_PLUGIN = void 0;
+var REPORTS_PLUGIN;
+(function (REPORTS_PLUGIN) {
+    REPORTS_PLUGIN["VENDOR_STATUS_REPORTS"] = "VENDOR_STATUS_REPORTS";
+    REPORTS_PLUGIN["HALTING_VEHICLES_REPORTS"] = "HALTING_VEHICLES_REPORTS";
+})(REPORTS_PLUGIN || (exports.REPORTS_PLUGIN = REPORTS_PLUGIN = {}));
+var REPORT_FREQUENCY;
+(function (REPORT_FREQUENCY) {
+    REPORT_FREQUENCY["DAILY"] = "DAILY";
+    REPORT_FREQUENCY["WEEKLY"] = "WEEKLY";
+    REPORT_FREQUENCY["MONTHLY"] = "MONTHLY";
+})(REPORT_FREQUENCY || (exports.REPORT_FREQUENCY = REPORT_FREQUENCY = {}));

package/build/typings/reports/hsfpl/hsfpl_haltingVehicles.typings.d.ts

@@ -0,0 +1,150 @@
+export declare enum HSFPL_HALTING_VEHICLE_APPROVAL {
+    AWAITING = "AWAITING",
+    APPROVED = "APPROVED"
+}
+export declare enum HSFPL_HALTING_VEHICLE_INVOICE_STATUS {
+    VERIFIED = "VERIFIED",
+    RAISED = "RAISED",
+    INVALID = "INVALID"
+}
+export declare enum HSFPL_HALTING_VEHICLE_ACTION_TYPE {
+    WAITING_FOR_APPROVAL = "WAITING_FOR_APPROVAL",
+    APPROVED_NOT_SENT = "APPROVED_NOT_SENT",
+    NO_PO_ON_INVOICE = "NO_PO_ON_INVOICE"
+}
+export interface IHSFPL_HaltingVehiclesReportOptions {
+    halt_alert_after_days: number;
+}
+export interface IHSFPL_HaltingVehiclesReportMeta {
+    company_name: string;
+    company_code: string;
+    company_logo_url: string | null;
+    location_city: string | null;
+    location_name: string;
+    location_code: string;
+    generated_at: Date;
+    halt_alert_after_days: number;
+}
+export interface IHSFPL_HaltingVehiclesKpis {
+    standing: number;
+    standing_longest_wait_time: string | null;
+    standing_longest_wait_minutes: number | null;
+    waiting_for_approval: number;
+    waiting_for_approval_longest_wait_time: string | null;
+    waiting_for_approval_longest_wait_minutes: number | null;
+    approved_not_sent: number;
+    approved_not_sent_longest_wait_time: string | null;
+    approved_not_sent_longest_wait_minutes: number | null;
+    no_po_on_invoice: number;
+}
+export interface IHSFPL_HaltingVehiclesTodaySummary {
+    window_start: Date;
+    window_end: Date;
+    standing_now: number;
+    standing_yesterday: number;
+    came_in: number;
+    sent: number;
+    sent_after_plant_approval: number;
+    sent_directly: number;
+}
+export interface IHSFPL_HaltingVehiclesNeedsActionPlant {
+    store_name: string;
+    vehicle_count: number;
+    ves_nos: string[];
+}
+export interface IHSFPL_HaltingVehiclesNeedsActionGroup {
+    vehicle_count: number;
+    plants: IHSFPL_HaltingVehiclesNeedsActionPlant[];
+}
+export interface IHaltingVehiclesNeedsAction {
+    awaiting_plant_approval: IHSFPL_HaltingVehiclesNeedsActionGroup | null;
+    approved_not_sent: IHSFPL_HaltingVehiclesNeedsActionGroup | null;
+    gi_blocked_no_po: IHSFPL_HaltingVehiclesNeedsActionGroup | null;
+}
+export interface IHSFPL_HaltingVehiclesPlantRow {
+    plant_name: string;
+    standing: number;
+    waiting_for_approval: number;
+    approved_not_sent: number;
+    no_po: number;
+    longest_wait_time: string | null;
+    longest_wait_minutes: number | null;
+}
+export interface IHSFPL_HaltingVehiclesAgeBucket {
+    min_days: number;
+    max_days: number | null;
+}
+export interface IHSFPL_HaltingVehiclesAgeRow {
+    plant_name: string;
+    counts: number[];
+    total: number;
+}
+export interface IHSFPL_HaltingVehiclesAgewise {
+    buckets: IHSFPL_HaltingVehiclesAgeBucket[];
+    rows: IHSFPL_HaltingVehiclesAgeRow[];
+    totals: IHSFPL_HaltingVehiclesAgeRow;
+}
+export interface IHSFPL_HaltingVehiclesMaterialRow {
+    material: string;
+    vehicles: number;
+    is_others: boolean;
+    others_materials: string[];
+}
+export interface IHSFPL_HaltingVehiclesInvalidInvoiceRow {
+    ves_no: string;
+    plant_name: string;
+    vendor_name: string;
+    invoice_no: string;
+    invoice_status: HSFPL_HALTING_VEHICLE_INVOICE_STATUS;
+    issue: string;
+    in_at_nly: Date;
+    waiting_time: string;
+}
+export interface IHSFPL_HaltingVehiclesInvoiceSection {
+    verified: number;
+    raised: number;
+    invalid: number;
+    invalid_invoices: IHSFPL_HaltingVehiclesInvalidInvoiceRow[];
+}
+export interface IHSFPL_HaltingVehicleRow {
+    ves_no: string;
+    vehicle_no: string;
+    vendor_name: string;
+    plant_name: string;
+    material: string | null;
+    extra_materials_count: number;
+    po_no: string | null;
+    extra_po_count: number;
+    approval: HSFPL_HALTING_VEHICLE_APPROVAL;
+    invoice_no: string;
+    invoice_status: HSFPL_HALTING_VEHICLE_INVOICE_STATUS;
+    in_at_nly: Date;
+    waiting_time: string;
+    waiting_minutes: number;
+}
+export interface IHSFPL_HaltingVehiclesPlantGroup {
+    plant_name: string;
+    vehicle_count: number;
+    oldest_waiting_time: string;
+    oldest_waiting_minutes: number;
+    vehicles: IHSFPL_HaltingVehicleRow[];
+}
+export interface IHSFPL_HaltingVehiclesConsistency {
+    standing_equals_waiting_plus_approved: boolean;
+    invoice_split_equals_standing: boolean;
+    today_equation_holds: boolean;
+}
+export interface IHSFPL_HaltingVehiclesReport {
+    meta: IHSFPL_HaltingVehiclesReportMeta;
+    kpis: IHSFPL_HaltingVehiclesKpis;
+    today: IHSFPL_HaltingVehiclesTodaySummary;
+    needs_action: IHaltingVehiclesNeedsAction;
+    plantwise: IHSFPL_HaltingVehiclesPlantRow[];
+    plantwise_totals: IHSFPL_HaltingVehiclesPlantRow;
+    plants_without_vehicles: string[];
+    agewise: IHSFPL_HaltingVehiclesAgewise;
+    materialwise: IHSFPL_HaltingVehiclesMaterialRow[];
+    invoice_status: IHSFPL_HaltingVehiclesInvoiceSection;
+    vehicles_by_plant: IHSFPL_HaltingVehiclesPlantGroup[];
+    consistency: IHSFPL_HaltingVehiclesConsistency;
+}

package/build/typings/reports/hsfpl/hsfpl_haltingVehicles.typings.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HSFPL_HALTING_VEHICLE_ACTION_TYPE = exports.HSFPL_HALTING_VEHICLE_INVOICE_STATUS = exports.HSFPL_HALTING_VEHICLE_APPROVAL = void 0;
+var HSFPL_HALTING_VEHICLE_APPROVAL;
+(function (HSFPL_HALTING_VEHICLE_APPROVAL) {
+    HSFPL_HALTING_VEHICLE_APPROVAL["AWAITING"] = "AWAITING";
+    HSFPL_HALTING_VEHICLE_APPROVAL["APPROVED"] = "APPROVED";
+})(HSFPL_HALTING_VEHICLE_APPROVAL || (exports.HSFPL_HALTING_VEHICLE_APPROVAL = HSFPL_HALTING_VEHICLE_APPROVAL = {}));
+var HSFPL_HALTING_VEHICLE_INVOICE_STATUS;
+(function (HSFPL_HALTING_VEHICLE_INVOICE_STATUS) {
+    HSFPL_HALTING_VEHICLE_INVOICE_STATUS["VERIFIED"] = "VERIFIED";
+    HSFPL_HALTING_VEHICLE_INVOICE_STATUS["RAISED"] = "RAISED";
+    HSFPL_HALTING_VEHICLE_INVOICE_STATUS["INVALID"] = "INVALID";
+})(HSFPL_HALTING_VEHICLE_INVOICE_STATUS || (exports.HSFPL_HALTING_VEHICLE_INVOICE_STATUS = HSFPL_HALTING_VEHICLE_INVOICE_STATUS = {}));
+var HSFPL_HALTING_VEHICLE_ACTION_TYPE;
+(function (HSFPL_HALTING_VEHICLE_ACTION_TYPE) {
+    HSFPL_HALTING_VEHICLE_ACTION_TYPE["WAITING_FOR_APPROVAL"] = "WAITING_FOR_APPROVAL";
+    HSFPL_HALTING_VEHICLE_ACTION_TYPE["APPROVED_NOT_SENT"] = "APPROVED_NOT_SENT";
+    HSFPL_HALTING_VEHICLE_ACTION_TYPE["NO_PO_ON_INVOICE"] = "NO_PO_ON_INVOICE";
+})(HSFPL_HALTING_VEHICLE_ACTION_TYPE || (exports.HSFPL_HALTING_VEHICLE_ACTION_TYPE = HSFPL_HALTING_VEHICLE_ACTION_TYPE = {}));

package/build/typings/system/reportScheduleRecipient.typings.d.ts

@@ -0,0 +1,20 @@
+import { INestedReportsPluginConfigCompany } from "./reportsPluginConfigCompany.typings";
+export declare enum REPORT_SCHEDULE_RECIPIENT_INCLUDE {
+    schedule = "schedule"
+}
+export interface IReportScheduleRecipient {
+    id: string;
+    schedule_id: string;
+    to_emails: string[];
+    cc_emails: string[];
+    bcc_emails: string[];
+    accepted_emails: string[];
+    rejected_emails: string[];
+    error: Record<string, unknown> | null;
+    report_path: string | null;
+    created_at: string;
+    updated_at: string;
+    schedule: INestedReportsPluginConfigCompany;
+}
+export interface INestedReportScheduleRecipient extends Omit<IReportScheduleRecipient, "schedule"> {
+}

package/build/typings/system/reportScheduleRecipient.typings.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_SCHEDULE_RECIPIENT_INCLUDE = void 0;
+var REPORT_SCHEDULE_RECIPIENT_INCLUDE;
+(function (REPORT_SCHEDULE_RECIPIENT_INCLUDE) {
+    REPORT_SCHEDULE_RECIPIENT_INCLUDE["schedule"] = "schedule";
+})(REPORT_SCHEDULE_RECIPIENT_INCLUDE || (exports.REPORT_SCHEDULE_RECIPIENT_INCLUDE = REPORT_SCHEDULE_RECIPIENT_INCLUDE = {}));

package/build/typings/system/reportsPluginConfigCompany.typings.d.ts

@@ -0,0 +1,30 @@
+import { INestedCompany } from "../company.typings";
+import { REPORT_FREQUENCY, REPORTS_PLUGIN } from "../plugins/reports.plugins";
+import { INestedReportScheduleRecipient } from "./reportScheduleRecipient.typings";
+export declare enum REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE {
+    company = "company",
+    recipients = "recipients"
+}
+export interface IReportsPluginConfigCompany {
+    id: string;
+    company_id: string;
+    last_updated_by_superadmin_id: string;
+    plugin_name: REPORTS_PLUGIN;
+    is_enabled: boolean;
+    max_halt_days_for_halting_vehicles_report: number | null;
+    frequency_type: REPORT_FREQUENCY;
+    send_time: string | null;
+    day_of_week: number | null;
+    date_of_month: number | null;
+    to_emails: string[];
+    cc_emails: string[];
+    bcc_emails: string[];
+    last_run_at: string | null;
+    next_run_at: string | null;
+    created_at: string;
+    updated_at: string;
+    company: INestedCompany;
+    recipients: INestedReportScheduleRecipient[];
+}
+export interface INestedReportsPluginConfigCompany extends Omit<IReportsPluginConfigCompany, "company" | "recipients"> {
+}

package/build/typings/system/reportsPluginConfigCompany.typings.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE = void 0;
+var REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE;
+(function (REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE) {
+    REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE["company"] = "company";
+    REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE["recipients"] = "recipients";
+})(REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE || (exports.REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE = REPORTS_PLUGIN_CONFIG_COMPANY_INCLUDE = {}));

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

@@ -0,0 +1,8 @@
+import { IReportsPluginConfigCompany } from "../typings/system/reportsPluginConfigCompany.typings";
+export type IScheduleShape = Pick<IReportsPluginConfigCompany, "frequency_type" | "send_time" | "day_of_week" | "date_of_month">;
+/**
+ * Returns the next run instant (UTC Date) strictly after `after`.
+ * `send_time` ("HH:mm"), `day_of_week` (0-6) and `date_of_month` (1-31) are in IST.
+ * MONTHLY clamps `date_of_month` to the last day of shorter months.
+ */
+export declare const calculateNextRunAt: (scheduleConfig: IScheduleShape, after: Date) => Date | null;

package/build/utils/calculateNextRunAt.util.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateNextRunAt = void 0;
+const reports_plugins_1 = require("../typings/plugins/reports.plugins");
+const IST_OFFSET_MS = 330 * 60 * 1000;
+/**
+ * Returns the next run instant (UTC Date) strictly after `after`.
+ * `send_time` ("HH:mm"), `day_of_week` (0-6) and `date_of_month` (1-31) are in IST.
+ * MONTHLY clamps `date_of_month` to the last day of shorter months.
+ */
+const calculateNextRunAt = (scheduleConfig, after) => {
+    var _a, _b;
+    const [sendHour, sendMinute] = ((_a = scheduleConfig.send_time) !== null && _a !== void 0 ? _a : "00:00")
+        .split(":")
+        .map(Number);
+    const afterInIst = new Date(after.getTime() + IST_OFFSET_MS);
+    const istYear = afterInIst.getUTCFullYear();
+    const istMonth = afterInIst.getUTCMonth();
+    const istDate = afterInIst.getUTCDate();
+    /** Converts the IST back to UTC */
+    const getUtcRunAtForIstDate = (year, month, date) => new Date(Date.UTC(year, month, date, sendHour, sendMinute) - IST_OFFSET_MS);
+    switch (scheduleConfig.frequency_type) {
+        case reports_plugins_1.REPORT_FREQUENCY.DAILY: {
+            const todayRunAt = getUtcRunAtForIstDate(istYear, istMonth, istDate);
+            return todayRunAt > after
+                ? todayRunAt
+                : getUtcRunAtForIstDate(istYear, istMonth, istDate + 1);
+        }
+        case reports_plugins_1.REPORT_FREQUENCY.WEEKLY: {
+            const daysUntilTargetWeekday = (((_b = scheduleConfig.day_of_week) !== null && _b !== void 0 ? _b : 0) - afterInIst.getUTCDay() + 7) % 7;
+            const thisWeekRunAt = getUtcRunAtForIstDate(istYear, istMonth, istDate + daysUntilTargetWeekday);
+            return thisWeekRunAt > after
+                ? thisWeekRunAt
+                : getUtcRunAtForIstDate(istYear, istMonth, istDate + daysUntilTargetWeekday + 7);
+        }
+        case reports_plugins_1.REPORT_FREQUENCY.MONTHLY: {
+            const getMonthlyRunAt = (year, month) => {
+                var _a;
+                const lastDateOfMonth = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+                return getUtcRunAtForIstDate(year, month, Math.min((_a = scheduleConfig.date_of_month) !== null && _a !== void 0 ? _a : 1, lastDateOfMonth));
+            };
+            const thisMonthRunAt = getMonthlyRunAt(istYear, istMonth);
+            return thisMonthRunAt > after
+                ? thisMonthRunAt
+                : getMonthlyRunAt(istYear, istMonth + 1);
+        }
+        default:
+            return null;
+    }
+};
+exports.calculateNextRunAt = calculateNextRunAt;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kcommons",
-  "version": "18.25.6",
+  "version": "18.26.0",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",