hvp-shared 6.72.2 → 6.73.1

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

@@ -18,3 +18,26 @@ export declare enum InventoryItemStatus {
     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"
+}
+export declare const INVENTORY_REVIEW_STATUS_LABELS: Record<InventoryReviewStatus, string>;
+/** Decision made by the manager/reviewer on a counted item */
+export declare enum ManagerDecision {
+    validated = "validated",
+    loss = "loss",
+    justified = "justified",
+    recount = "recount"
+}
+export declare const MANAGER_DECISION_LABELS: Record<ManagerDecision, string>;
+/** Action taken by the collaborator on their own count */
+export declare enum CollaboratorAction {
+    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.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.INVENTORY_REVIEW_STATUS_LABELS = exports.InventoryReviewStatus = 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;
@@ -32,3 +32,46 @@ exports.INVENTORY_ITEM_STATUS_LABELS = {
     [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",
+};
+// --- Manager Decision ---
+/** Decision made by the manager/reviewer on a counted item */
+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 ---
+/** 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

@@ -7,7 +7,7 @@
  * @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 { InventorySessionStatus, CollaboratorAction, ManagerDecision } from '../../constants/inventory-session.enums';
 import { Warehouse } from '../../types/qvet.types';
 /**
  * Create a new inventory session.
@@ -38,3 +38,29 @@ export interface ListInventorySessionsFilters {
     warehouse?: Warehouse;
     status?: InventorySessionStatus;
 }
+/**
+ * Item within an apply-review batch request.
+ *
+ * Can contain count data (collaborator), confirmation, or manager decision.
+ * All fields are optional — only send what changed.
+ */
+export interface ApplyReviewItemRequest {
+    qvetCode: number;
+    countedQuantity?: number;
+    countedExpiredQuantity?: number;
+    nextExpirationDate?: string;
+    comment?: string;
+    collaboratorAction?: CollaboratorAction;
+    managerDecision?: ManagerDecision;
+    reviewerNotes?: string;
+}
+/**
+ * Batch apply review changes to multiple items.
+ *
+ * Replaces per-item PATCH calls. All changes are applied atomically.
+ *
+ * @example POST /api/qvet/inventory-sessions/:id/apply-review
+ */
+export interface ApplyReviewRequest {
+    items: ApplyReviewItemRequest[];
+}

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

@@ -24,6 +24,10 @@ export interface InventorySessionSummaryResponse {
     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;
     /** Number of times an Excel was uploaded */
     uploadCount: number;
     createdByName: string;
@@ -78,3 +82,25 @@ export interface UploadCountsResponse {
         count: number;
     };
 }
+/**
+ * Warning about stock changes detected during review apply.
+ */
+export interface ApplyReviewWarning {
+    qvetCode: number;
+    description: string;
+    stockAtCount: number;
+    currentStock: number;
+}
+/**
+ * Response after applying review changes to a session.
+ *
+ * @example POST /api/qvet/inventory-sessions/:id/apply-review
+ */
+export interface ApplyReviewResponse {
+    /** Updated session detail */
+    session: InventorySessionDetailResponse;
+    /** Number of items processed */
+    applied: number;
+    /** Items where QVET stock changed since counting */
+    warnings?: ApplyReviewWarning[];
+}

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

@@ -4,7 +4,7 @@
  * Shared type definitions for inventory session items.
  * Used by both requests and responses.
  */
-import { InventoryItemStatus } from '../../constants/inventory-session.enums';
+import { InventoryItemStatus, InventoryReviewStatus, ManagerDecision, CollaboratorAction } from '../../constants/inventory-session.enums';
 /**
  * Item data within an inventory session.
  *
@@ -43,4 +43,16 @@ export interface InventorySessionItem {
     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 */
+    collaboratorAction?: CollaboratorAction;
+    /** Manager/reviewer decision */
+    managerDecision?: ManagerDecision;
+    /** Notes from the reviewer */
+    reviewerNotes?: string;
+    /** When the review was done (ISO 8601) */
+    reviewedAt?: string;
+    /** Name of the reviewer */
+    reviewedByName?: string;
 }

package/package.json

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