hvp-shared 6.34.0 → 6.36.0

package/dist/constants/background-job.constants.d.ts

@@ -20,6 +20,7 @@ export declare enum JobType {
     SYNC_PURCHASE_ORDERS = "SYNC_PURCHASE_ORDERS",
     SYNC_STOCK_CONFIG = "SYNC_STOCK_CONFIG",
     SYNC_CATALOG = "SYNC_CATALOG",
+    SYNC_SUPPLIERS = "SYNC_SUPPLIERS",
     SYNC_CLIENTS = "SYNC_CLIENTS",
     SYNC_INVENTORY_SNAPSHOT = "SYNC_INVENTORY_SNAPSHOT",
     SYNC_BATCH = "SYNC_BATCH",
@@ -55,7 +56,9 @@ export declare enum ReportType {
     /** Product catalog - no date params required */
     CATALOG = "CATALOG",
     /** Stock configuration - no date params required */
-    STOCK_CONFIG = "STOCK_CONFIG"
+    STOCK_CONFIG = "STOCK_CONFIG",
+    /** Suppliers catalog - no date params required */
+    SUPPLIERS = "SUPPLIERS"
 }
 /**
  * Sub-task status within a batch job

package/dist/constants/background-job.constants.js

@@ -24,6 +24,7 @@ var JobType;
     JobType["SYNC_PURCHASE_ORDERS"] = "SYNC_PURCHASE_ORDERS";
     JobType["SYNC_STOCK_CONFIG"] = "SYNC_STOCK_CONFIG";
     JobType["SYNC_CATALOG"] = "SYNC_CATALOG";
+    JobType["SYNC_SUPPLIERS"] = "SYNC_SUPPLIERS";
     JobType["SYNC_CLIENTS"] = "SYNC_CLIENTS";
     JobType["SYNC_INVENTORY_SNAPSHOT"] = "SYNC_INVENTORY_SNAPSHOT";
     JobType["SYNC_BATCH"] = "SYNC_BATCH";
@@ -61,6 +62,8 @@ var ReportType;
     ReportType["CATALOG"] = "CATALOG";
     /** Stock configuration - no date params required */
     ReportType["STOCK_CONFIG"] = "STOCK_CONFIG";
+    /** Suppliers catalog - no date params required */
+    ReportType["SUPPLIERS"] = "SUPPLIERS";
 })(ReportType || (exports.ReportType = ReportType = {}));
 /**
  * Sub-task status within a batch job
@@ -90,6 +93,7 @@ exports.REPORT_PARAM_TYPES = {
     [ReportType.CLIENTS]: 'no_params',
     [ReportType.CATALOG]: 'no_params',
     [ReportType.STOCK_CONFIG]: 'no_params',
+    [ReportType.SUPPLIERS]: 'no_params',
 };
 /**
  * Job execution status
@@ -128,6 +132,7 @@ exports.JOB_TYPE_LABELS = {
     [JobType.SYNC_PURCHASE_ORDERS]: 'Sincronizar Pedidos',
     [JobType.SYNC_STOCK_CONFIG]: 'Sincronizar Config. Stock',
     [JobType.SYNC_CATALOG]: 'Sincronizar Catálogo',
+    [JobType.SYNC_SUPPLIERS]: 'Sincronizar Proveedores',
     [JobType.SYNC_CLIENTS]: 'Sincronizar Clientes',
     [JobType.SYNC_INVENTORY_SNAPSHOT]: 'Sincronizar Snapshot Inventario',
     [JobType.SYNC_BATCH]: 'Sincronización por Lotes',
@@ -150,6 +155,7 @@ exports.REPORT_TYPE_LABELS = {
     [ReportType.CLIENTS]: 'Clientes',
     [ReportType.CATALOG]: 'Catálogo',
     [ReportType.STOCK_CONFIG]: 'Config. Stock',
+    [ReportType.SUPPLIERS]: 'Proveedores',
 };
 /**
  * Human-readable labels for sub-task status (Spanish for UI)

package/dist/types/index.d.ts

@@ -10,3 +10,4 @@ export * from './sync-field.types';
 export * from './catalog-item.types';
 export * from './qvet.types';
 export * from './background-job.types';
+export * from './payroll-v2.types';

package/dist/types/index.js

@@ -26,3 +26,4 @@ __exportStar(require("./sync-field.types"), exports);
 __exportStar(require("./catalog-item.types"), exports);
 __exportStar(require("./qvet.types"), exports);
 __exportStar(require("./background-job.types"), exports);
+__exportStar(require("./payroll-v2.types"), exports);

package/dist/types/payroll-v2.types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * PayrollV2 Types — unified PayrollItem-based model.
+ *
+ * Each item is self-describing: carries SAT codes, taxed/exempt split,
+ * source key for internal reference, and an optional formula explaining
+ * how the amount was calculated.
+ *
+ * NOTE: CfdiStatus and PayrollStatus enums are NOT imported here because
+ * they live in repo-specific enum files (used in 19+ files each). Instead,
+ * the `status` and `payrollStatus` fields use `string`, which is compatible
+ * since TypeScript string enum values ARE strings.
+ */
+export declare enum PayrollItemCategory {
+    BASE_SALARY = "BASE_SALARY",
+    ADDITIONAL_FIXED = "ADDITIONAL_FIXED",
+    COMMISSION = "COMMISSION",
+    BONUS = "BONUS",
+    OVERTIME = "OVERTIME",
+    HOLIDAY_PAY = "HOLIDAY_PAY",
+    YEAR_END_BONUS = "YEAR_END_BONUS",
+    VACATION_BONUS = "VACATION_BONUS",
+    PROFIT_SHARING = "PROFIT_SHARING",
+    SUBSIDY = "SUBSIDY",
+    SUPPORT = "SUPPORT",
+    COMPENSATION = "COMPENSATION",
+    TAX = "TAX",
+    SOCIAL_SECURITY = "SOCIAL_SECURITY",
+    ATTENDANCE_DISCOUNT = "ATTENDANCE_DISCOUNT",
+    OTHER_DEDUCTION = "OTHER_DEDUCTION",
+    OTHER_PAYMENT = "OTHER_PAYMENT"
+}
+export interface PayrollFormula {
+    readonly expression: string;
+    readonly inputs: Record<string, number>;
+    readonly result: number;
+}
+export interface PayrollItem {
+    readonly satCode?: string;
+    readonly satType?: string;
+    readonly description: string;
+    readonly amount: number;
+    readonly taxedAmount?: number;
+    readonly exemptAmount?: number;
+    readonly sourceKey: string;
+    readonly category: PayrollItemCategory;
+    readonly formula?: PayrollFormula;
+    readonly isEditable: boolean;
+    readonly notes?: string;
+}
+export interface PayrollV2Totals {
+    readonly totalPerceptions: number;
+    readonly totalDeductions: number;
+    readonly totalOtherPayments: number;
+    readonly totalTaxed: number;
+    readonly totalExempt: number;
+    readonly netPay: number;
+}
+export interface PayrollCalculationContext {
+    readonly attendanceFactor?: number;
+    readonly dailyUma: number;
+    readonly isrBracketUsed?: string;
+    readonly subsidioCausado?: number;
+    readonly isrCausado?: number;
+    readonly employerImssRate?: number;
+    readonly workedHours: number;
+    readonly hourlyRate?: number;
+}
+export interface PayrollEmployeeSnapshot {
+    readonly fullName: string;
+    readonly collaboratorCode: string;
+    readonly imgUrl?: string;
+    readonly curp?: string;
+    readonly rfc?: string;
+    readonly socialSecurityNumber?: string;
+    readonly jobTitle: string;
+    readonly paymentType: string;
+    readonly contributionBaseSalary: number;
+    readonly fiscalRegime?: string;
+    readonly taxZipCode?: string;
+    readonly startDateLaborRelations?: string;
+    readonly contractType?: string;
+    readonly regimeType?: string;
+    readonly federalEntityKey?: string;
+    readonly bank?: string;
+    readonly bankAccount?: string;
+    readonly typeOfJourney?: string;
+    readonly frequencyPayment?: string;
+    readonly positionRisk?: string;
+}
+export interface PayrollV2Cfdi {
+    /** CfdiStatus value — typed as string to avoid coupling to repo-specific enums */
+    readonly status: string;
+    readonly uuid?: string;
+    readonly facturamaId?: string;
+    readonly stampedAt?: Date | string;
+    readonly cancelledAt?: Date | string;
+    readonly errorMessage?: string;
+}
+export interface PayrollV2 {
+    readonly collaboratorId?: string;
+    readonly employmentId?: string;
+    readonly jobId?: string;
+    readonly periodStartDate?: string;
+    readonly periodEndDate?: string;
+    /** PayrollStatus value — typed as string to avoid coupling to repo-specific enums */
+    readonly payrollStatus?: string;
+    readonly daysPaid?: number;
+    readonly perceptions: PayrollItem[];
+    readonly deductions: PayrollItem[];
+    readonly otherPayments: PayrollItem[];
+    readonly totals: PayrollV2Totals;
+    readonly employee: PayrollEmployeeSnapshot;
+    readonly calculationContext: PayrollCalculationContext;
+    readonly cfdi?: PayrollV2Cfdi;
+}

package/dist/types/payroll-v2.types.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * PayrollV2 Types — unified PayrollItem-based model.
+ *
+ * Each item is self-describing: carries SAT codes, taxed/exempt split,
+ * source key for internal reference, and an optional formula explaining
+ * how the amount was calculated.
+ *
+ * NOTE: CfdiStatus and PayrollStatus enums are NOT imported here because
+ * they live in repo-specific enum files (used in 19+ files each). Instead,
+ * the `status` and `payrollStatus` fields use `string`, which is compatible
+ * since TypeScript string enum values ARE strings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayrollItemCategory = void 0;
+// ============================================================
+// Core item types
+// ============================================================
+var PayrollItemCategory;
+(function (PayrollItemCategory) {
+    PayrollItemCategory["BASE_SALARY"] = "BASE_SALARY";
+    PayrollItemCategory["ADDITIONAL_FIXED"] = "ADDITIONAL_FIXED";
+    PayrollItemCategory["COMMISSION"] = "COMMISSION";
+    PayrollItemCategory["BONUS"] = "BONUS";
+    PayrollItemCategory["OVERTIME"] = "OVERTIME";
+    PayrollItemCategory["HOLIDAY_PAY"] = "HOLIDAY_PAY";
+    PayrollItemCategory["YEAR_END_BONUS"] = "YEAR_END_BONUS";
+    PayrollItemCategory["VACATION_BONUS"] = "VACATION_BONUS";
+    PayrollItemCategory["PROFIT_SHARING"] = "PROFIT_SHARING";
+    PayrollItemCategory["SUBSIDY"] = "SUBSIDY";
+    PayrollItemCategory["SUPPORT"] = "SUPPORT";
+    PayrollItemCategory["COMPENSATION"] = "COMPENSATION";
+    PayrollItemCategory["TAX"] = "TAX";
+    PayrollItemCategory["SOCIAL_SECURITY"] = "SOCIAL_SECURITY";
+    PayrollItemCategory["ATTENDANCE_DISCOUNT"] = "ATTENDANCE_DISCOUNT";
+    PayrollItemCategory["OTHER_DEDUCTION"] = "OTHER_DEDUCTION";
+    PayrollItemCategory["OTHER_PAYMENT"] = "OTHER_PAYMENT";
+})(PayrollItemCategory || (exports.PayrollItemCategory = PayrollItemCategory = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "6.34.0",
+  "version": "6.36.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",