hvp-shared 6.41.0 → 6.43.0

package/dist/constants/hr.enums.d.ts

@@ -0,0 +1,25 @@
+/**
+ * HR Enums — shared across backend and frontend.
+ *
+ * These enums were previously duplicated in both repos.
+ * Single source of truth lives here in hvp-shared.
+ */
+export declare enum PayrollStatus {
+    Pending = "pending",
+    Approved = "approved",
+    Paid = "paid",
+    Billed = "billed"
+}
+export declare enum CfdiStatus {
+    Pending = "pending",
+    Ready = "ready",
+    Stamped = "stamped",
+    StampedExternal = "stamped_external",
+    Cancelled = "cancelled",
+    Error = "error"
+}
+export declare enum HRPaymentType {
+    HOURLY = "HOURLY",
+    SALARY = "SALARY",
+    INFORMAL = "INFORMAL"
+}

package/dist/constants/hr.enums.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * HR Enums — shared across backend and frontend.
+ *
+ * These enums were previously duplicated in both repos.
+ * Single source of truth lives here in hvp-shared.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HRPaymentType = exports.CfdiStatus = exports.PayrollStatus = void 0;
+var PayrollStatus;
+(function (PayrollStatus) {
+    PayrollStatus["Pending"] = "pending";
+    PayrollStatus["Approved"] = "approved";
+    PayrollStatus["Paid"] = "paid";
+    PayrollStatus["Billed"] = "billed";
+})(PayrollStatus || (exports.PayrollStatus = PayrollStatus = {}));
+var CfdiStatus;
+(function (CfdiStatus) {
+    CfdiStatus["Pending"] = "pending";
+    CfdiStatus["Ready"] = "ready";
+    CfdiStatus["Stamped"] = "stamped";
+    CfdiStatus["StampedExternal"] = "stamped_external";
+    CfdiStatus["Cancelled"] = "cancelled";
+    CfdiStatus["Error"] = "error";
+})(CfdiStatus || (exports.CfdiStatus = CfdiStatus = {}));
+var HRPaymentType;
+(function (HRPaymentType) {
+    HRPaymentType["HOURLY"] = "HOURLY";
+    HRPaymentType["SALARY"] = "SALARY";
+    HRPaymentType["INFORMAL"] = "INFORMAL";
+})(HRPaymentType || (exports.HRPaymentType = HRPaymentType = {}));

package/dist/constants/index.d.ts

@@ -14,3 +14,4 @@ export * from './background-job.constants';
 export * from './job-category.constants';
 export * from './special-collaborators.constants';
 export * from './commissions.constants';
+export * from './hr.enums';

package/dist/constants/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./background-job.constants"), exports);
 __exportStar(require("./job-category.constants"), exports);
 __exportStar(require("./special-collaborators.constants"), exports);
 __exportStar(require("./commissions.constants"), exports);
+__exportStar(require("./hr.enums"), exports);

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

@@ -4,12 +4,8 @@
  * 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.
  */
+import { CfdiStatus, PayrollStatus } from '../constants/hr.enums';
 export declare enum PayrollItemCategory {
     BASE_SALARY = "BASE_SALARY",
     ADDITIONAL_FIXED = "ADDITIONAL_FIXED",
@@ -88,22 +84,46 @@ export interface PayrollEmployeeSnapshot {
     readonly positionRisk?: string;
 }
 export interface PayrollV2Cfdi {
-    /** CfdiStatus value — typed as string to avoid coupling to repo-specific enums */
-    readonly status: string;
+    readonly status: CfdiStatus;
     readonly uuid?: string;
     readonly facturamaId?: string;
     readonly stampedAt?: Date | string;
     readonly cancelledAt?: Date | string;
     readonly errorMessage?: string;
 }
+/**
+ * A named amount concept (bonus, deduction, etc.).
+ * Mirrors the PayrollConcept shape used in both frontend and backend.
+ */
+export interface PayrollConceptDto {
+    readonly name: string;
+    readonly description?: string;
+    readonly amount: number;
+}
+/**
+ * The subset of payroll fields that users can edit directly.
+ * Everything else is calculated by the V2 engine.
+ *
+ * Used by:
+ * - PATCH /payrolls/:id/v2 (save edits)
+ * - POST /payrolls/recalculate-v2 (preview recalculation)
+ * - Frontend edit form state
+ */
+export interface PayrollEditableOverrides {
+    readonly specialBonuses?: PayrollConceptDto[];
+    readonly endYearBonus?: number;
+    readonly extraVariableCompensations?: PayrollConceptDto[];
+    readonly profitSharing?: number;
+    readonly otherFixedDeductions?: PayrollConceptDto[];
+    readonly otherVariableDeductions?: PayrollConceptDto[];
+}
 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 payrollStatus?: PayrollStatus;
     readonly daysPaid?: number;
     readonly perceptions: PayrollItem[];
     readonly deductions: PayrollItem[];

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

@@ -5,11 +5,6 @@
  * 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;

package/package.json

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