hvp-shared 6.10.0 → 6.11.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,45 @@ export interface QvetTransfersQueryParams {
     skip?: number;
     sort?: string;
 }
+/**
+ * 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:
+ *   ID 3206: MONTEJO → COLABORADOR-URBAN (exit)
+ *   ID 3207: COLABORADOR-URBAN → URBAN CENTER (entry)
+ *
+ * Consolidated:
+ *   realSource: "MONTEJO"
+ *   realTarget: "URBAN CENTER"
+ *   transferIds: [3206, 3207]
+ */
+export interface ConsolidatedTransfer {
+    date: string;
+    realSource: string;
+    realTarget: string;
+    items: ConsolidatedTransferItem[];
+    totalItems: number;
+    totalQuantity: number;
+    totalValue: number;
+    transferIds: 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.11.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",