hvp-shared 6.9.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
  */
@@ -268,3 +270,105 @@ export interface QvetMovementsQueryParams {
     skip?: number;
     sort?: string;
 }
+/**
+ * Single transfer record from QVET
+ * Represents an inter-warehouse transfer
+ */
+export interface QvetTransferResponse {
+    id: string;
+    transferId: number;
+    date: string;
+    productName: string;
+    sourceWarehouse: string;
+    targetWarehouse: string;
+    quantity: number;
+    conversionFactor: number;
+    initialStockSource: number;
+    initialStockTarget: number;
+    unitCost: number;
+    averageCost: number;
+    lot: string;
+    lotExpiryDate: string | null;
+    userName: string;
+    responsibleSource: string;
+    responsibleTarget: string;
+    notes: string;
+    syncedAt: string;
+}
+/**
+ * Paginated list of transfers
+ * Uses generic QvetPaginatedResponse for consistent pagination format.
+ */
+export type QvetTransfersListResponse = QvetPaginatedResponse<QvetTransferResponse>;
+/**
+ * Transfers summary statistics for a period
+ */
+export interface QvetTransfersSummaryResponse {
+    ok: boolean;
+    data: {
+        totalRecords: number;
+        totalQuantity: number;
+        totalValue: number;
+        uniqueProducts: number;
+        sourceWarehouses: number;
+        targetWarehouses: number;
+    };
+}
+/**
+ * Query parameters for transfers endpoint
+ */
+export interface QvetTransfersQueryParams {
+    startDate?: string;
+    endDate?: string;
+    year?: number;
+    month?: number;
+    halfMonth?: 1 | 2;
+    sourceWarehouse?: string;
+    targetWarehouse?: string;
+    productName?: string;
+    limit?: number;
+    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.9.0",
+  "version": "6.11.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",