hvp-shared 6.10.0 → 6.12.0

package/dist/contracts/qvet/responses.d.ts

@@ -4,6 +4,32 @@
  * Response interfaces for QVET data endpoints.
  * Used by frontend to consume synced QVET data.
  */
+/**
+ * Standard pagination info for QVET endpoints
+ */
+export interface QvetPagination {
+    total: number;
+    limit: number;
+    skip: number;
+    hasMore: boolean;
+}
+/**
+ * Generic paginated response for QVET list endpoints
+ * Use this for all QVET list endpoints to ensure consistent pagination format.
+ *
+ * @example
+ * // Backend returns this structure:
+ * {
+ *   ok: true,
+ *   data: [...],
+ *   pagination: { total: 100, limit: 25, skip: 0, hasMore: true }
+ * }
+ */
+export interface QvetPaginatedResponse<T> {
+    ok: boolean;
+    data: T[];
+    pagination: QvetPagination;
+}
 /**
  * Single sale record from QVET
  * Represents one line item in a sale transaction
@@ -40,17 +66,9 @@ export interface QvetSaleResponse {
 }
 /**
  * Paginated list of sales
+ * Uses generic QvetPaginatedResponse for consistent pagination format.
  */
-export interface QvetSalesListResponse {
-    ok: boolean;
-    data: QvetSaleResponse[];
-    pagination: {
-        total: number;
-        limit: number;
-        skip: number;
-        hasMore: boolean;
-    };
-}
+export type QvetSalesListResponse = QvetPaginatedResponse<QvetSaleResponse>;
 /**
  * Sales summary statistics for a period
  */
@@ -134,17 +152,9 @@ export interface QvetPurchaseResponse {
 }
 /**
  * Paginated list of purchases
+ * Uses generic QvetPaginatedResponse for consistent pagination format.
  */
-export interface QvetPurchasesListResponse {
-    ok: boolean;
-    data: QvetPurchaseResponse[];
-    pagination: {
-        total: number;
-        limit: number;
-        skip: number;
-        hasMore: boolean;
-    };
-}
+export type QvetPurchasesListResponse = QvetPaginatedResponse<QvetPurchaseResponse>;
 /**
  * Purchases summary statistics for a period
  */
@@ -221,17 +231,9 @@ export interface QvetMovementResponse {
 }
 /**
  * Paginated list of movements
+ * Uses generic QvetPaginatedResponse for consistent pagination format.
  */
-export interface QvetMovementsListResponse {
-    ok: boolean;
-    data: QvetMovementResponse[];
-    pagination: {
-        total: number;
-        limit: number;
-        skip: number;
-        hasMore: boolean;
-    };
-}
+export type QvetMovementsListResponse = QvetPaginatedResponse<QvetMovementResponse>;
 /**
  * Movements summary statistics for a period
  */
@@ -295,17 +297,9 @@ export interface QvetTransferResponse {
 }
 /**
  * Paginated list of transfers
+ * Uses generic QvetPaginatedResponse for consistent pagination format.
  */
-export interface QvetTransfersListResponse {
-    ok: boolean;
-    data: QvetTransferResponse[];
-    pagination: {
-        total: number;
-        limit: number;
-        skip: number;
-        hasMore: boolean;
-    };
-}
+export type QvetTransfersListResponse = QvetPaginatedResponse<QvetTransferResponse>;
 /**
  * Transfers summary statistics for a period
  */
@@ -336,3 +330,77 @@ export interface QvetTransfersQueryParams {
     skip?: number;
     sort?: string;
 }
+/**
+ * Status of a consolidated transfer
+ * - completed: Both exit and entry legs exist
+ * - pending: Only exit leg exists (transfer in transit)
+ */
+export type ConsolidatedTransferStatus = 'completed' | 'pending';
+/**
+ * Single item within a consolidated transfer
+ */
+export interface ConsolidatedTransferItem {
+    productName: string;
+    quantity: number;
+    unitCost: number;
+    totalValue: number;
+    lot: string;
+}
+/**
+ * Consolidated transfer record
+ *
+ * QVET registers inter-warehouse transfers as multiple movements through
+ * intermediate "COLABORADOR-X" warehouses. This consolidated view combines
+ * those movements to show the real source and target warehouses.
+ *
+ * @example
+ * Original in QVET:
+ *   Exit:  ID 3206 @ 14:42 - MONTEJO → COLABORADOR-URBAN
+ *   Entry: ID 3207 @ 15:01 - COLABORADOR-URBAN → URBAN CENTER
+ *
+ * Consolidated:
+ *   exitDate: "2025-01-23T14:42:00.000Z"
+ *   entryDate: "2025-01-23T15:01:00.000Z"
+ *   realSource: "MONTEJO"
+ *   realTarget: "URBAN CENTER"
+ *   status: "completed"
+ *   exitTransferIds: [3206]
+ *   entryTransferIds: [3207]
+ *
+ * If only exit exists (pending):
+ *   entryDate: null
+ *   realTarget: null
+ *   status: "pending"
+ *   entryTransferIds: []
+ */
+export interface ConsolidatedTransfer {
+    /** When items left the source warehouse */
+    exitDate: string;
+    /** When items arrived at destination (null if pending) */
+    entryDate: string | null;
+    /** Real source warehouse (not COLABORADOR) */
+    realSource: string;
+    /** Real target warehouse (null if pending/unknown) */
+    realTarget: string | null;
+    /** Transfer status */
+    status: ConsolidatedTransferStatus;
+    /** Notes/observations from the transfer (combined from all items) */
+    notes: string;
+    /** Items in this transfer */
+    items: ConsolidatedTransferItem[];
+    /** Number of distinct items */
+    totalItems: number;
+    /** Sum of all quantities */
+    totalQuantity: number;
+    /** Sum of all item values */
+    totalValue: number;
+    /** QVET transfer IDs for exit leg */
+    exitTransferIds: number[];
+    /** QVET transfer IDs for entry leg */
+    entryTransferIds: number[];
+}
+/**
+ * Paginated list of consolidated transfers
+ * Uses generic QvetPaginatedResponse for consistent pagination format.
+ */
+export type ConsolidatedTransfersResponse = QvetPaginatedResponse<ConsolidatedTransfer>;

package/package.json

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