hvp-shared 6.70.0 → 6.72.0

package/dist/constants/index.d.ts

@@ -21,3 +21,4 @@ export * from './time-off.enums';
 export * from './time-off.constants';
 export * from './hris.constants';
 export * from './payroll-features.constants';
+export * from './inventory-session.enums';

package/dist/constants/index.js

@@ -37,3 +37,4 @@ __exportStar(require("./time-off.enums"), exports);
 __exportStar(require("./time-off.constants"), exports);
 __exportStar(require("./hris.constants"), exports);
 __exportStar(require("./payroll-features.constants"), exports);
+__exportStar(require("./inventory-session.enums"), exports);

package/dist/constants/inventory-session.enums.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Inventory Session Enums
+ *
+ * Enums for the persistent multi-pass inventory count workflow.
+ * Sessions track physical inventory counts across multiple uploads
+ * until closure is detected from QVET movements sync.
+ */
+/** Lifecycle status of an inventory session */
+export declare enum InventorySessionStatus {
+    open = "open",
+    closed = "closed"
+}
+export declare const INVENTORY_SESSION_STATUS_LABELS: Record<InventorySessionStatus, string>;
+/** Status of an individual item within a session */
+export declare enum InventoryItemStatus {
+    pending = "pending",
+    counted = "counted",
+    matched = "matched"
+}
+export declare const INVENTORY_ITEM_STATUS_LABELS: Record<InventoryItemStatus, string>;

package/dist/constants/inventory-session.enums.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Inventory Session Enums
+ *
+ * Enums for the persistent multi-pass inventory count workflow.
+ * Sessions track physical inventory counts across multiple uploads
+ * until closure is detected from QVET movements sync.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVENTORY_ITEM_STATUS_LABELS = exports.InventoryItemStatus = exports.INVENTORY_SESSION_STATUS_LABELS = exports.InventorySessionStatus = void 0;
+// --- Session Status ---
+/** Lifecycle status of an inventory session */
+var InventorySessionStatus;
+(function (InventorySessionStatus) {
+    InventorySessionStatus["open"] = "open";
+    InventorySessionStatus["closed"] = "closed";
+})(InventorySessionStatus || (exports.InventorySessionStatus = InventorySessionStatus = {}));
+exports.INVENTORY_SESSION_STATUS_LABELS = {
+    [InventorySessionStatus.open]: "Abierta",
+    [InventorySessionStatus.closed]: "Cerrada",
+};
+// --- Item Status ---
+/** Status of an individual item within a session */
+var InventoryItemStatus;
+(function (InventoryItemStatus) {
+    InventoryItemStatus["pending"] = "pending";
+    InventoryItemStatus["counted"] = "counted";
+    InventoryItemStatus["matched"] = "matched";
+})(InventoryItemStatus || (exports.InventoryItemStatus = InventoryItemStatus = {}));
+exports.INVENTORY_ITEM_STATUS_LABELS = {
+    [InventoryItemStatus.pending]: "Pendiente",
+    [InventoryItemStatus.counted]: "Contado",
+    [InventoryItemStatus.matched]: "Validado",
+};

package/dist/contracts/index.d.ts

@@ -11,3 +11,4 @@ export * from './stock-calculation';
 export * from './cash-reconciliation';
 export * from './time-off-request';
 export * from './job';
+export * from './inventory-session';

package/dist/contracts/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./stock-calculation"), exports);
 __exportStar(require("./cash-reconciliation"), exports);
 __exportStar(require("./time-off-request"), exports);
 __exportStar(require("./job"), exports);
+__exportStar(require("./inventory-session"), exports);

package/dist/contracts/inventory-session/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './requests';
+export * from './responses';

package/dist/contracts/inventory-session/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./types"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/inventory-session/requests.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Inventory Session Request Types
+ *
+ * Request DTOs for inventory session endpoints.
+ *
+ * @example POST /api/qvet/inventory-sessions
+ * @example POST /api/qvet/inventory-sessions/:id/upload
+ * @example POST /api/qvet/inventory-sessions/:id/confirm-matches
+ */
+import { InventorySessionStatus } from '../../constants/inventory-session.enums';
+import { Warehouse } from '../../types/qvet.types';
+/**
+ * Create a new inventory session.
+ *
+ * @example POST /api/qvet/inventory-sessions
+ */
+export interface CreateInventorySessionRequest {
+    /** Warehouse to count */
+    warehouse: Warehouse;
+    /** Sections to include in the count */
+    sections: string[];
+}
+/**
+ * Confirm auto-matched items after an upload.
+ *
+ * @example POST /api/qvet/inventory-sessions/:id/confirm-matches
+ */
+export interface ConfirmMatchesRequest {
+    /** QVET codes of items to mark as matched */
+    qvetCodes: number[];
+}
+/**
+ * Filters for listing inventory sessions.
+ *
+ * @example GET /api/qvet/inventory-sessions?warehouse=HARBOR&status=open
+ */
+export interface ListInventorySessionsFilters {
+    warehouse?: Warehouse;
+    status?: InventorySessionStatus;
+}

package/dist/contracts/inventory-session/requests.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Inventory Session Request Types
+ *
+ * Request DTOs for inventory session endpoints.
+ *
+ * @example POST /api/qvet/inventory-sessions
+ * @example POST /api/qvet/inventory-sessions/:id/upload
+ * @example POST /api/qvet/inventory-sessions/:id/confirm-matches
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/inventory-session/responses.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Inventory Session Response Types
+ *
+ * Response DTOs for inventory session endpoints.
+ */
+import { InventorySessionStatus } from '../../constants/inventory-session.enums';
+import { Warehouse } from '../../types/qvet.types';
+import { InventorySessionItem } from './types';
+/**
+ * Summary of an inventory session for list views.
+ *
+ * @example GET /api/qvet/inventory-sessions
+ */
+export interface InventorySessionSummaryResponse {
+    id: string;
+    warehouse: Warehouse;
+    sections: string[];
+    status: InventorySessionStatus;
+    /** Total items in session */
+    totalItems: number;
+    /** Items with status "pending" */
+    pendingItems: number;
+    /** Items with status "counted" */
+    countedItems: number;
+    /** Items with status "matched" */
+    matchedItems: number;
+    /** Number of times an Excel was uploaded */
+    uploadCount: number;
+    createdByName: string;
+    createdAt: string;
+    updatedAt: string;
+    lastUploadAt?: string;
+    closedAt?: string;
+}
+/**
+ * Full detail of an inventory session including all items.
+ *
+ * @example GET /api/qvet/inventory-sessions/:id
+ */
+export interface InventorySessionDetailResponse extends InventorySessionSummaryResponse {
+    createdById: string;
+    items: InventorySessionItem[];
+}
+/**
+ * Item that matched QVET stock during upload.
+ * Shown in the match preview popup.
+ */
+export interface MatchPreviewItem {
+    qvetCode: number;
+    description: string;
+    section: string;
+    /** The quantity that matched (counted == QVET stock) */
+    quantity: number;
+}
+/**
+ * Response after uploading a count Excel.
+ * Includes upload result + items that can be auto-matched.
+ *
+ * @example POST /api/qvet/inventory-sessions/:id/upload
+ */
+export interface UploadCountsResponse {
+    /** Updated session summary */
+    session: InventorySessionSummaryResponse;
+    /** Statistics from this upload */
+    uploadStats: {
+        /** Items updated in this upload */
+        itemsUpdated: number;
+        /** Items that were not found in the session */
+        itemsNotFound: number;
+        /** Items skipped (already matched) */
+        itemsSkipped: number;
+    };
+    /** Items that can be auto-matched (counted == QVET stock) */
+    matchPreview: {
+        /** Items eligible for matching */
+        items: MatchPreviewItem[];
+        /** Total count of matchable items */
+        count: number;
+    };
+}

package/dist/contracts/inventory-session/responses.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Inventory Session Response Types
+ *
+ * Response DTOs for inventory session endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/inventory-session/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Inventory Session Types
+ *
+ * Shared type definitions for inventory session items.
+ * Used by both requests and responses.
+ */
+import { InventoryItemStatus } from '../../constants/inventory-session.enums';
+/**
+ * Item data within an inventory session.
+ *
+ * Tracks the count state of a single product across uploads.
+ */
+export interface InventorySessionItem {
+    qvetCode: number;
+    description: string;
+    section: string;
+    family: string;
+    /** Stock at session creation (reference only, does not change) */
+    initialQvetStock: number;
+    /** Latest QVET stock (refreshed on each upload) */
+    currentQvetStock: number;
+    /** Quantity counted by collaborator */
+    countedQuantity?: number;
+    /** Expired items counted */
+    countedExpiredQuantity?: number;
+    /** Next expiration date recorded during count */
+    nextExpirationDate?: string;
+    /** Collaborator comment */
+    comment?: string;
+    /** Unit price at time of session creation */
+    unitPrice: number;
+    /** Current item status */
+    status: InventoryItemStatus;
+    /** When the item was matched (ISO 8601) */
+    matchedAt?: string;
+    /** Who confirmed the match */
+    matchedByName?: string;
+}

package/dist/contracts/inventory-session/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Inventory Session Types
+ *
+ * Shared type definitions for inventory session items.
+ * Used by both requests and responses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/catalog-item.types.d.ts

@@ -18,6 +18,8 @@ export interface WarehouseStock {
     minStock: SyncField<number>;
     /** Optimal stock level (sync with QVET) */
     optimalStock: SyncField<number>;
+    /** Next expiration date for items in this warehouse (ISO 8601) */
+    nextExpirationDate?: string;
 }
 /**
  * QVET Sync Data

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

@@ -6,6 +6,7 @@
  * how the amount was calculated.
  */
 import { CfdiStatus, PayrollStatus } from '../constants/hr.enums';
+import { CompensationType, EmploymentType, PayrollStampingMode } from '../constants/employment.enums';
 export declare enum PayrollItemCategory {
     BASE_SALARY = "BASE_SALARY",
     ADDITIONAL_FIXED = "ADDITIONAL_FIXED",
@@ -118,6 +119,29 @@ export interface PayrollEditableOverrides {
     readonly otherFixedDeductions?: PayrollConceptDto[];
     readonly otherVariableDeductions?: PayrollConceptDto[];
 }
+/**
+ * Snapshot of the employment configuration that affects payroll visualization.
+ * Stored on each PayrollV2 so the frontend can render it without external lookups.
+ */
+export interface PayrollV2EmploymentConfig {
+    readonly employmentType: EmploymentType;
+    readonly compensationType: CompensationType;
+    readonly payrollStampingMode: PayrollStampingMode;
+}
+/**
+ * Embedded nominal payroll data for employees that require CFDI stamping
+ * at minimum wage (casual with IMSS, coverage_only).
+ *
+ * Instead of generating a separate PayrollV2 record, the nominal component
+ * is embedded inside the main payroll record.
+ */
+export interface NominalPayrollData {
+    readonly perceptions: PayrollItem[];
+    readonly deductions: PayrollItem[];
+    readonly otherPayments: PayrollItem[];
+    readonly totals: PayrollV2Totals;
+    readonly cfdi?: PayrollV2Cfdi;
+}
 export interface PayrollV2 {
     readonly collaboratorId?: string;
     readonly employmentId?: string;
@@ -126,7 +150,10 @@ export interface PayrollV2 {
     readonly periodEndDate?: string;
     readonly payrollStatus?: PayrollStatus;
     readonly daysPaid?: number;
-    readonly isNominal?: boolean;
+    /** Snapshot of employment config at generation time */
+    readonly employmentConfig?: PayrollV2EmploymentConfig;
+    /** Embedded nominal payroll (casual+IMSS, coverage_only) */
+    readonly nominalPayroll?: NominalPayrollData;
     readonly perceptions: PayrollItem[];
     readonly deductions: PayrollItem[];
     readonly otherPayments: PayrollItem[];

package/package.json

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