hvp-shared 6.73.0 → 6.74.0

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

@@ -11,25 +11,35 @@ export declare enum InventorySessionStatus {
     closed = "closed"
 }
 export declare const INVENTORY_SESSION_STATUS_LABELS: Record<InventorySessionStatus, string>;
-/** Status of an individual item within a session */
+/**
+ * Status of an individual item within a session.
+ * This is THE field to display. No priority logic needed.
+ *
+ * Terminal states (session closeable): ok, tolerated, loss, justified
+ * Non-terminal: pending, needs_review, verify_qvet, confirmed, recount
+ */
 export declare enum InventoryItemStatus {
-    pending = "pending",
-    counted = "counted",
-    matched = "matched"
-}
-export declare const INVENTORY_ITEM_STATUS_LABELS: Record<InventoryItemStatus, string>;
-/** Auto-calculated review status based on count data vs stock */
-export declare enum InventoryReviewStatus {
     pending = "pending",
     ok = "ok",
     tolerated = "tolerated",
     needs_review = "needs_review",
-    verify_qvet = "verify_qvet"
+    verify_qvet = "verify_qvet",
+    confirmed = "confirmed",
+    recount = "recount",
+    loss = "loss",
+    justified = "justified"
 }
-export declare const INVENTORY_REVIEW_STATUS_LABELS: Record<InventoryReviewStatus, string>;
-/** Decision made by the manager/reviewer on a counted item */
+export declare const INVENTORY_ITEM_STATUS_LABELS: Record<InventoryItemStatus, string>;
+/** Terminal statuses — session can close when all items are in one of these */
+export declare const TERMINAL_ITEM_STATUSES: Set<InventoryItemStatus>;
+/**
+ * Decision made by the manager/reviewer on a counted item.
+ * Stored in managerDecision for audit. The status field reflects the current state.
+ *
+ * No "validated" — manager must choose loss or justified for differences.
+ * Items that match (ok/tolerated) don't need manager action.
+ */
 export declare enum ManagerDecision {
-    validated = "validated",
     loss = "loss",
     justified = "justified",
     recount = "recount"
@@ -37,6 +47,7 @@ export declare enum ManagerDecision {
 export declare const MANAGER_DECISION_LABELS: Record<ManagerDecision, string>;
 /** Action taken by the collaborator on their own count */
 export declare enum CollaboratorAction {
-    confirmed = "confirmed"
+    confirmed = "confirmed",
+    corrected = "corrected"
 }
 export declare const COLLABORATOR_ACTION_LABELS: Record<CollaboratorAction, string>;

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

@@ -7,7 +7,7 @@
  * until closure is detected from QVET movements sync.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COLLABORATOR_ACTION_LABELS = exports.CollaboratorAction = exports.MANAGER_DECISION_LABELS = exports.ManagerDecision = exports.INVENTORY_REVIEW_STATUS_LABELS = exports.InventoryReviewStatus = exports.INVENTORY_ITEM_STATUS_LABELS = exports.InventoryItemStatus = exports.INVENTORY_SESSION_STATUS_LABELS = exports.InventorySessionStatus = void 0;
+exports.COLLABORATOR_ACTION_LABELS = exports.CollaboratorAction = exports.MANAGER_DECISION_LABELS = exports.ManagerDecision = exports.TERMINAL_ITEM_STATUSES = 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;
@@ -19,57 +19,74 @@ exports.INVENTORY_SESSION_STATUS_LABELS = {
     [InventorySessionStatus.open]: "Abierta",
     [InventorySessionStatus.closed]: "Cerrada",
 };
-// --- Item Status ---
-/** Status of an individual item within a session */
+// --- Item Status (unified — single source of truth for display) ---
+/**
+ * Status of an individual item within a session.
+ * This is THE field to display. No priority logic needed.
+ *
+ * Terminal states (session closeable): ok, tolerated, loss, justified
+ * Non-terminal: pending, needs_review, verify_qvet, confirmed, recount
+ */
 var InventoryItemStatus;
 (function (InventoryItemStatus) {
+    // Auto-calculated from count data
     InventoryItemStatus["pending"] = "pending";
-    InventoryItemStatus["counted"] = "counted";
-    InventoryItemStatus["matched"] = "matched";
+    InventoryItemStatus["ok"] = "ok";
+    InventoryItemStatus["tolerated"] = "tolerated";
+    InventoryItemStatus["needs_review"] = "needs_review";
+    InventoryItemStatus["verify_qvet"] = "verify_qvet";
+    // Set by collaborator
+    InventoryItemStatus["confirmed"] = "confirmed";
+    // Set by manager
+    InventoryItemStatus["recount"] = "recount";
+    InventoryItemStatus["loss"] = "loss";
+    InventoryItemStatus["justified"] = "justified";
 })(InventoryItemStatus || (exports.InventoryItemStatus = InventoryItemStatus = {}));
 exports.INVENTORY_ITEM_STATUS_LABELS = {
     [InventoryItemStatus.pending]: "Pendiente",
-    [InventoryItemStatus.counted]: "Contado",
-    [InventoryItemStatus.matched]: "Validado",
-};
-// --- Review Status (auto-calculated) ---
-/** Auto-calculated review status based on count data vs stock */
-var InventoryReviewStatus;
-(function (InventoryReviewStatus) {
-    InventoryReviewStatus["pending"] = "pending";
-    InventoryReviewStatus["ok"] = "ok";
-    InventoryReviewStatus["tolerated"] = "tolerated";
-    InventoryReviewStatus["needs_review"] = "needs_review";
-    InventoryReviewStatus["verify_qvet"] = "verify_qvet";
-})(InventoryReviewStatus || (exports.InventoryReviewStatus = InventoryReviewStatus = {}));
-exports.INVENTORY_REVIEW_STATUS_LABELS = {
-    [InventoryReviewStatus.pending]: "Pendiente",
-    [InventoryReviewStatus.ok]: "OK",
-    [InventoryReviewStatus.tolerated]: "Tolerado",
-    [InventoryReviewStatus.needs_review]: "Revisar",
-    [InventoryReviewStatus.verify_qvet]: "Verificar QVET",
+    [InventoryItemStatus.ok]: "OK",
+    [InventoryItemStatus.tolerated]: "Tolerado",
+    [InventoryItemStatus.needs_review]: "Revisar",
+    [InventoryItemStatus.verify_qvet]: "Verificar QVET",
+    [InventoryItemStatus.confirmed]: "Confirmado",
+    [InventoryItemStatus.recount]: "Recontar",
+    [InventoryItemStatus.loss]: "Pérdida",
+    [InventoryItemStatus.justified]: "Justificado",
 };
-// --- Manager Decision ---
-/** Decision made by the manager/reviewer on a counted item */
+/** Terminal statuses — session can close when all items are in one of these */
+exports.TERMINAL_ITEM_STATUSES = new Set([
+    InventoryItemStatus.ok,
+    InventoryItemStatus.tolerated,
+    InventoryItemStatus.loss,
+    InventoryItemStatus.justified,
+]);
+// --- Manager Decision (audit field) ---
+/**
+ * Decision made by the manager/reviewer on a counted item.
+ * Stored in managerDecision for audit. The status field reflects the current state.
+ *
+ * No "validated" — manager must choose loss or justified for differences.
+ * Items that match (ok/tolerated) don't need manager action.
+ */
 var ManagerDecision;
 (function (ManagerDecision) {
-    ManagerDecision["validated"] = "validated";
     ManagerDecision["loss"] = "loss";
     ManagerDecision["justified"] = "justified";
     ManagerDecision["recount"] = "recount";
 })(ManagerDecision || (exports.ManagerDecision = ManagerDecision = {}));
 exports.MANAGER_DECISION_LABELS = {
-    [ManagerDecision.validated]: "Validado",
     [ManagerDecision.loss]: "Pérdida",
     [ManagerDecision.justified]: "Justificado",
     [ManagerDecision.recount]: "Recontar",
 };
-// --- Collaborator Action ---
+// --- Collaborator Action (audit field) ---
 /** Action taken by the collaborator on their own count */
 var CollaboratorAction;
 (function (CollaboratorAction) {
     CollaboratorAction["confirmed"] = "confirmed";
+    CollaboratorAction["corrected"] = "corrected";
 })(CollaboratorAction || (exports.CollaboratorAction = CollaboratorAction = {}));
 exports.COLLABORATOR_ACTION_LABELS = {
     [CollaboratorAction.confirmed]: "Confirmado",
+    [CollaboratorAction.corrected]: "Corregido",
 };

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

@@ -5,7 +5,7 @@
  *
  * @example POST /api/qvet/inventory-sessions
  * @example POST /api/qvet/inventory-sessions/:id/upload
- * @example POST /api/qvet/inventory-sessions/:id/confirm-matches
+ * @example POST /api/qvet/inventory-sessions/:id/apply-review
  */
 import { InventorySessionStatus, CollaboratorAction, ManagerDecision } from '../../constants/inventory-session.enums';
 import { Warehouse } from '../../types/qvet.types';
@@ -20,15 +20,6 @@ export interface CreateInventorySessionRequest {
     /** 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.
  *

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

@@ -6,6 +6,6 @@
  *
  * @example POST /api/qvet/inventory-sessions
  * @example POST /api/qvet/inventory-sessions/:id/upload
- * @example POST /api/qvet/inventory-sessions/:id/confirm-matches
+ * @example POST /api/qvet/inventory-sessions/:id/apply-review
  */
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -18,16 +18,14 @@ export interface InventorySessionSummaryResponse {
     status: InventorySessionStatus;
     /** Total items in session */
     totalItems: number;
-    /** Items with status "pending" */
+    /** Items with status "pending" (no count data) */
     pendingItems: number;
-    /** Items with status "counted" */
-    countedItems: number;
-    /** Items with status "matched" */
-    matchedItems: number;
-    /** Items needing review (reviewStatus = needs_review) */
-    needsReviewItems: number;
-    /** Items confirmed by collaborator but pending manager decision */
-    confirmedItems: number;
+    /** Items in terminal state (ok, tolerated, loss, justified) */
+    resolvedItems: number;
+    /** Items needing attention (needs_review, verify_qvet, recount) */
+    needsAttentionItems: number;
+    /** Items in progress (confirmed — waiting for manager) */
+    inProgressItems: number;
     /** Number of times an Excel was uploaded */
     uploadCount: number;
     createdByName: string;
@@ -45,20 +43,8 @@ export interface InventorySessionDetailResponse extends InventorySessionSummaryR
     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
  */
@@ -71,16 +57,9 @@ export interface UploadCountsResponse {
         itemsUpdated: number;
         /** Items that were not found in the session */
         itemsNotFound: number;
-        /** Items skipped (already matched) */
+        /** Items skipped (already in terminal state) */
         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;
-    };
 }
 /**
  * Warning about stock changes detected during review apply.

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

@@ -4,11 +4,12 @@
  * Shared type definitions for inventory session items.
  * Used by both requests and responses.
  */
-import { InventoryItemStatus, InventoryReviewStatus, ManagerDecision, CollaboratorAction } from '../../constants/inventory-session.enums';
+import { InventoryItemStatus, ManagerDecision, CollaboratorAction } from '../../constants/inventory-session.enums';
 /**
  * Item data within an inventory session.
  *
- * Tracks the count state of a single product across uploads.
+ * status is THE single source of truth for display — no priority logic needed.
+ * collaboratorAction and managerDecision are audit fields.
  */
 export interface InventorySessionItem {
     qvetCode: number;
@@ -37,17 +38,11 @@ export interface InventorySessionItem {
     conversionFactor?: number;
     stockControlType?: string;
     usageType?: string;
-    /** Current item status */
+    /** Current item status — THE field to display */
     status: InventoryItemStatus;
-    /** When the item was matched (ISO 8601) */
-    matchedAt?: string;
-    /** Who confirmed the match */
-    matchedByName?: string;
-    /** Auto-calculated review status based on count vs stock */
-    reviewStatus?: InventoryReviewStatus;
-    /** Collaborator's confirmation of their count */
+    /** Collaborator's action on their count (audit) */
     collaboratorAction?: CollaboratorAction;
-    /** Manager/reviewer decision */
+    /** Manager/reviewer decision (audit) */
     managerDecision?: ManagerDecision;
     /** Notes from the reviewer */
     reviewerNotes?: string;

package/package.json

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