hvp-shared 6.76.0 → 6.78.0

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

@@ -5,12 +5,29 @@
  * Sessions track physical inventory counts across multiple uploads
  * until closure is detected from QVET movements sync.
  */
-/** Lifecycle status of an inventory session */
+/**
+ * Lifecycle status of an inventory session.
+ *
+ * counting → reviewing → validating → exported → closed
+ *
+ * - counting: Session created, physical counting in progress, no uploads yet
+ * - reviewing: First upload done, collaborator reviewing counts
+ * - validating: Collaborator done, manager validating/deciding
+ * - exported: Final sheet downloaded, data propagated to CatalogItem
+ * - closed: QVET import detected via movement sync
+ */
 export declare enum InventorySessionStatus {
-    open = "open",
+    counting = "counting",
+    reviewing = "reviewing",
+    validating = "validating",
+    exported = "exported",
     closed = "closed"
 }
 export declare const INVENTORY_SESSION_STATUS_LABELS: Record<InventorySessionStatus, string>;
+/** Statuses where editing (upload, count edits, collaborator actions) is allowed */
+export declare const EDITABLE_SESSION_STATUSES: Set<InventorySessionStatus>;
+/** Statuses where the session is still active (downloads, refresh, manager decisions) */
+export declare const ACTIVE_SESSION_STATUSES: Set<InventorySessionStatus>;
 /**
  * Status of an individual item within a session.
  * This is THE field to display. No priority logic needed.

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

@@ -7,18 +7,45 @@
  * 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.TERMINAL_ITEM_STATUSES = 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.ACTIVE_SESSION_STATUSES = exports.EDITABLE_SESSION_STATUSES = exports.INVENTORY_SESSION_STATUS_LABELS = exports.InventorySessionStatus = void 0;
 // --- Session Status ---
-/** Lifecycle status of an inventory session */
+/**
+ * Lifecycle status of an inventory session.
+ *
+ * counting → reviewing → validating → exported → closed
+ *
+ * - counting: Session created, physical counting in progress, no uploads yet
+ * - reviewing: First upload done, collaborator reviewing counts
+ * - validating: Collaborator done, manager validating/deciding
+ * - exported: Final sheet downloaded, data propagated to CatalogItem
+ * - closed: QVET import detected via movement sync
+ */
 var InventorySessionStatus;
 (function (InventorySessionStatus) {
-    InventorySessionStatus["open"] = "open";
+    InventorySessionStatus["counting"] = "counting";
+    InventorySessionStatus["reviewing"] = "reviewing";
+    InventorySessionStatus["validating"] = "validating";
+    InventorySessionStatus["exported"] = "exported";
     InventorySessionStatus["closed"] = "closed";
 })(InventorySessionStatus || (exports.InventorySessionStatus = InventorySessionStatus = {}));
 exports.INVENTORY_SESSION_STATUS_LABELS = {
-    [InventorySessionStatus.open]: "Abierta",
-    [InventorySessionStatus.closed]: "Cerrada",
+    [InventorySessionStatus.counting]: "Contando",
+    [InventorySessionStatus.reviewing]: "En revisión",
+    [InventorySessionStatus.validating]: "Validando",
+    [InventorySessionStatus.exported]: "Exportado",
+    [InventorySessionStatus.closed]: "Cerrado",
 };
+/** Statuses where editing (upload, count edits, collaborator actions) is allowed */
+exports.EDITABLE_SESSION_STATUSES = new Set([
+    InventorySessionStatus.counting,
+    InventorySessionStatus.reviewing,
+]);
+/** Statuses where the session is still active (downloads, refresh, manager decisions) */
+exports.ACTIVE_SESSION_STATUSES = new Set([
+    InventorySessionStatus.counting,
+    InventorySessionStatus.reviewing,
+    InventorySessionStatus.validating,
+]);
 // --- Item Status (unified — single source of truth for display) ---
 /**
  * Status of an individual item within a session.

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

@@ -5,7 +5,7 @@
  */
 import { InventorySessionStatus } from '../../constants/inventory-session.enums';
 import { Warehouse } from '../../types/qvet.types';
-import { InventorySessionItem } from './types';
+import { InventorySessionItem, SessionActivity } from './types';
 /**
  * Summary of an inventory session for list views.
  *
@@ -32,6 +32,7 @@ export interface InventorySessionSummaryResponse {
     createdAt: string;
     updatedAt: string;
     lastUploadAt?: string;
+    exportedAt?: string;
     closedAt?: string;
 }
 /**
@@ -42,6 +43,7 @@ export interface InventorySessionSummaryResponse {
 export interface InventorySessionDetailResponse extends InventorySessionSummaryResponse {
     createdById: string;
     items: InventorySessionItem[];
+    activityLog: SessionActivity[];
 }
 /**
  * Response after uploading a count Excel.

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, ManagerDecision, CollaboratorAction } from '../../constants/inventory-session.enums';
+import { InventoryItemStatus, InventorySessionStatus, ManagerDecision, CollaboratorAction } from '../../constants/inventory-session.enums';
 /**
  * Item data within an inventory session.
  *
@@ -49,3 +49,39 @@ export interface InventorySessionItem {
     /** Name of the reviewer */
     reviewedByName?: string;
 }
+export type SessionActivityAction = 'created' | 'uploaded' | 'reviewed' | 'downloaded' | 'refreshed' | 'exported' | 'bulk_loss';
+export declare const SESSION_ACTIVITY_LABELS: Record<SessionActivityAction, string>;
+/** Snapshot of session counts at a point in time */
+export interface SessionActivitySnapshot {
+    pending: number;
+    resolved: number;
+    needsAttention: number;
+    inProgress: number;
+    sessionStatus: InventorySessionStatus;
+}
+/** Action-specific metrics */
+export interface SessionActivityMetrics {
+    itemsUpdated?: number;
+    itemsNotFound?: number;
+    itemsSkipped?: number;
+    countChanges?: number;
+    confirmations?: number;
+    managerDecisions?: number;
+    autoAdjusted?: number;
+    resetToPending?: number;
+    itemsInSheet?: number;
+    filter?: 'pending' | 'all';
+    expirationsPropagated?: number;
+    totalLossMXN?: number;
+    totalSurplusMXN?: number;
+}
+/** Single entry in the session activity log */
+export interface SessionActivity {
+    action: SessionActivityAction;
+    userName: string;
+    colCode: string;
+    timestamp: string;
+    snapshot: SessionActivitySnapshot;
+    metrics: SessionActivityMetrics;
+    details?: string;
+}

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

@@ -6,3 +6,13 @@
  * Used by both requests and responses.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_ACTIVITY_LABELS = void 0;
+exports.SESSION_ACTIVITY_LABELS = {
+    created: 'Sesión creada',
+    uploaded: 'Conteo subido',
+    reviewed: 'Revisión aplicada',
+    downloaded: 'Hoja descargada',
+    refreshed: 'Stock actualizado',
+    exported: 'Hoja final exportada',
+    bulk_loss: 'Pérdidas aceptadas',
+};

package/package.json

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