hvp-shared 6.23.0 → 6.25.0

package/dist/contracts/index.d.ts

@@ -4,5 +4,6 @@
  */
 export * from './collaborator';
 export * from './catalog-item';
-export * from './inventory-analysis';
+export * from './order-planning';
 export * from './qvet';
+export * from './stock-calculation';

package/dist/contracts/index.js

@@ -20,5 +20,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./collaborator"), exports);
 __exportStar(require("./catalog-item"), exports);
-__exportStar(require("./inventory-analysis"), exports);
+__exportStar(require("./order-planning"), exports);
 __exportStar(require("./qvet"), exports);
+__exportStar(require("./stock-calculation"), exports);

package/dist/contracts/order-planning/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Order Planning API Contracts
+ *
+ * Request and response types for order planning and inventory optimization.
+ */
+export * from './requests';
+export * from './responses';

package/dist/contracts/{inventory-analysis → order-planning}/index.js

@@ -1,8 +1,8 @@
 "use strict";
 /**
- * Inventory Analysis API Contracts
+ * Order Planning API Contracts
  *
- * Request and response types for inventory analysis and order optimization.
+ * Request and response types for order planning and inventory optimization.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;

package/dist/contracts/{inventory-analysis → order-planning}/requests.d.ts

@@ -1,7 +1,7 @@
 /**
- * Inventory Analysis Request Types
+ * Order Planning Request Types
  *
- * Request DTOs for inventory analysis and order optimization endpoints.
+ * Request DTOs for order planning and inventory optimization endpoints.
  */
 /**
  * Request to refresh inventory data from QVET
@@ -9,22 +9,30 @@
  * Triggers batch sync for Purchase Orders and Transfers reports.
  * If dates not provided, syncs from last sync date to today.
  *
- * @example POST /api/inventory/refresh-data
+ * @example POST /api/inventory/order-planning/refresh-data
  */
-export interface RefreshInventoryDataRequest {
+export interface RefreshOrderPlanningDataRequest {
     /** Start date for sync (ISO 8601). If omitted, uses last sync date */
     fromDate?: string;
     /** End date for sync (ISO 8601). If omitted, defaults to today */
     toDate?: string;
 }
 /**
- * Request to run inventory analysis
+ * Request to run order planning analysis
  *
- * @example POST /api/inventory/analyze
+ * @example POST /api/inventory/order-planning/analyze
  */
-export interface RunInventoryAnalysisRequest {
+export interface RunOrderPlanningRequest {
     /** Filter by specific warehouses. If omitted, analyzes all warehouses */
     warehouses?: string[];
     /** Include items with status OK in the response. Default: false */
     includeOkItems?: boolean;
 }
+/**
+ * @deprecated Use RefreshOrderPlanningDataRequest instead
+ */
+export type RefreshInventoryDataRequest = RefreshOrderPlanningDataRequest;
+/**
+ * @deprecated Use RunOrderPlanningRequest instead
+ */
+export type RunInventoryAnalysisRequest = RunOrderPlanningRequest;

package/dist/contracts/order-planning/requests.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Order Planning Request Types
+ *
+ * Request DTOs for order planning and inventory optimization endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/{inventory-analysis → order-planning}/responses.d.ts

@@ -1,17 +1,17 @@
 /**
- * Inventory Analysis Response Types
+ * Order Planning Response Types
  *
- * Response DTOs for inventory analysis and order optimization endpoints.
+ * Response DTOs for order planning and inventory optimization endpoints.
  */
 /**
- * Response after triggering inventory data refresh
+ * Response after triggering order planning data refresh
  *
  * Returns a job ID that can be polled for progress.
- * Backend wraps with: ApiSingleSuccessResponse<RefreshInventoryDataResponse>
+ * Backend wraps with: ApiSingleSuccessResponse<RefreshOrderPlanningDataResponse>
  *
- * @example POST /api/inventory/refresh-data
+ * @example POST /api/inventory/order-planning/refresh-data
  */
-export interface RefreshInventoryDataResponse {
+export interface RefreshOrderPlanningDataResponse {
     /** Background job ID for polling progress */
     jobId: string;
     /** Human-readable message */
@@ -23,12 +23,12 @@ export interface RefreshInventoryDataResponse {
     };
 }
 /**
- * Last sync status for inventory data
- * Backend wraps with: ApiSingleSuccessResponse<InventorySyncStatusResponse>
+ * Last sync status for order planning data
+ * Backend wraps with: ApiSingleSuccessResponse<OrderPlanningSyncStatusResponse>
  *
- * @example GET /api/inventory/sync-status
+ * @example GET /api/inventory/order-planning/sync-status
  */
-export interface InventorySyncStatusResponse {
+export interface OrderPlanningSyncStatusResponse {
     /** Last sync date for Purchase Orders report */
     purchaseOrdersLastSync?: string;
     /** Last sync date for Transfers report */
@@ -143,14 +143,14 @@ export interface PurchaseInstruction {
     relatedPendingTransfers?: number[];
 }
 /**
- * Complete inventory analysis response
+ * Complete order planning analysis response
  *
  * Contains all analyzed items, suggested transfers, and purchase instructions.
- * Backend wraps with: ApiSingleSuccessResponse<InventoryAnalysisResponse>
+ * Backend wraps with: ApiSingleSuccessResponse<OrderPlanningResponse>
  *
- * @example POST /api/inventory/analyze
+ * @example POST /api/inventory/order-planning/analyze
  */
-export interface InventoryAnalysisResponse {
+export interface OrderPlanningResponse {
     /** Analysis timestamp */
     analyzedAt: string;
     /** Warehouses included in analysis */
@@ -205,7 +205,7 @@ export interface PendingPurchaseOrder {
  * Response for pending orders list
  * Backend wraps with: ApiSingleSuccessResponse<PendingPurchaseOrdersResponse>
  *
- * @example GET /api/qvet/purchase-orders/pending
+ * @example GET /api/inventory/order-planning/pending-orders
  */
 export interface PendingPurchaseOrdersResponse {
     /** List of pending orders */
@@ -218,3 +218,15 @@ export interface PendingPurchaseOrdersResponse {
         staleOrders: number;
     };
 }
+/**
+ * @deprecated Use RefreshOrderPlanningDataResponse instead
+ */
+export type RefreshInventoryDataResponse = RefreshOrderPlanningDataResponse;
+/**
+ * @deprecated Use OrderPlanningSyncStatusResponse instead
+ */
+export type InventorySyncStatusResponse = OrderPlanningSyncStatusResponse;
+/**
+ * @deprecated Use OrderPlanningResponse instead
+ */
+export type InventoryAnalysisResponse = OrderPlanningResponse;

package/dist/contracts/order-planning/responses.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Order Planning Response Types
+ *
+ * Response DTOs for order planning and inventory optimization endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/stock-calculation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stock Calculation API Contracts
+ *
+ * Types, request and response definitions for stock calculation endpoints.
+ */
+export * from './types';
+export * from './requests';
+export * from './responses';

package/dist/{inventory-analysis → contracts/stock-calculation}/index.js

@@ -1,9 +1,8 @@
 "use strict";
 /**
- * Inventory Analysis Module
+ * Stock Calculation API Contracts
  *
- * API contracts for inventory analysis endpoints.
- * Calculation logic lives in hvp-backend domain layer.
+ * Types, request and response definitions for stock calculation endpoints.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -21,3 +20,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/stock-calculation/requests.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Stock Calculation Request Types
+ *
+ * Request DTOs for stock calculation endpoints.
+ */
+/**
+ * Request for stock proposal calculation
+ *
+ * @example POST /api/inventory/stock-calculation/proposal
+ */
+export interface StockProposalRequest {
+    /** Start date for consumption analysis (ISO 8601) */
+    fromDate: string;
+    /** End date for consumption analysis (ISO 8601) */
+    toDate: string;
+    /** Start date for recent period (e.g., Q4 start) - ISO 8601 */
+    recentPeriodStart?: string;
+    /** Filter by branch */
+    branch?: string;
+    /** Filter by section */
+    section?: string;
+    /** Filter by specific product codes */
+    qvetCodes?: number[];
+    /** Output format */
+    format?: 'json' | 'excel';
+}

package/dist/contracts/stock-calculation/requests.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Stock Calculation Request Types
+ *
+ * Request DTOs for stock calculation endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/stock-calculation/responses.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Stock Calculation Response Types
+ *
+ * Response DTOs for stock calculation endpoints.
+ */
+import { UsageType } from '../../constants/catalog-item.constants';
+import { TrendType } from './types';
+/**
+ * Response for stock proposal calculation
+ *
+ * Backend wraps with: ApiSingleSuccessResponse<StockProposalResponse>
+ *
+ * @example POST /api/inventory/stock-calculation/proposal
+ */
+export interface StockProposalResponse {
+    /** Metadata about the calculation */
+    metadata: {
+        /** Analysis date range */
+        dateRange: {
+            from: string;
+            to: string;
+        };
+        /** Recent period date range */
+        recentPeriod: {
+            from: string;
+            to: string;
+        };
+        /** Total products analyzed */
+        totalProducts: number;
+        /** Timestamp of calculation */
+        calculatedAt: string;
+    };
+    /** Product analysis results */
+    products: ProductAnalysisResponse[];
+    /** Summary statistics */
+    summary: {
+        /** Count by trend type */
+        byTrend: Record<TrendType, number>;
+        /** Count by usage type */
+        byUsageType: Record<UsageType, number>;
+    };
+}
+/**
+ * Product analysis for API response (flattened)
+ */
+export interface ProductAnalysisResponse {
+    qvetCode: number;
+    description: string;
+    section: string;
+    usageType: UsageType;
+    dailyConsumption: number;
+    dailyConsumptionRecent: number;
+    monthlyConsumption: number;
+    qyRatio: number;
+    trend: TrendType;
+    referenceConsumption: number;
+    currentStock: {
+        warehouse: string;
+        stock: number;
+    }[];
+    totalStock: number;
+    minStock: number;
+    optimalStock: number;
+    minDays: number;
+    optimalDays: number;
+    roundingIncrement: number;
+    unitCost: number;
+    proposedMinValue: number;
+    proposedOptValue: number;
+}

package/dist/contracts/stock-calculation/responses.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Stock Calculation Response Types
+ *
+ * Response DTOs for stock calculation endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/{inventory-analysis → contracts/stock-calculation}/types.d.ts

@@ -1,10 +1,10 @@
 /**
- * Inventory Analysis Types
+ * Stock Calculation Types
  *
- * Type definitions for inventory analysis calculations.
- * Used by StockProposalService, ConsumptionAnalysisService, etc.
+ * Domain types for stock calculation (min/max/optimal).
+ * Used by StockCalculationService, ConsumptionAnalysisService, etc.
  */
-import { UsageType } from '../constants/catalog-item.constants';
+import { UsageType } from '../../constants/catalog-item.constants';
 /**
  * TrendType - Classification of consumption trend
  *
@@ -88,84 +88,6 @@ export interface ProductAnalysis {
     /** Stock proposal */
     proposal: StockProposal;
 }
-/**
- * Request for stock proposal calculation
- */
-export interface StockProposalRequest {
-    /** Start date for consumption analysis (ISO 8601) */
-    fromDate: string;
-    /** End date for consumption analysis (ISO 8601) */
-    toDate: string;
-    /** Start date for recent period (e.g., Q4 start) - ISO 8601 */
-    recentPeriodStart?: string;
-    /** Filter by branch */
-    branch?: string;
-    /** Filter by section */
-    section?: string;
-    /** Filter by specific product codes */
-    qvetCodes?: number[];
-    /** Output format */
-    format?: 'json' | 'excel';
-}
-/**
- * Response for stock proposal calculation
- */
-export interface StockProposalResponse {
-    /** Metadata about the calculation */
-    metadata: {
-        /** Analysis date range */
-        dateRange: {
-            from: string;
-            to: string;
-        };
-        /** Recent period date range */
-        recentPeriod: {
-            from: string;
-            to: string;
-        };
-        /** Total products analyzed */
-        totalProducts: number;
-        /** Timestamp of calculation */
-        calculatedAt: string;
-    };
-    /** Product analysis results */
-    products: ProductAnalysisResponse[];
-    /** Summary statistics */
-    summary: {
-        /** Count by trend type */
-        byTrend: Record<TrendType, number>;
-        /** Count by usage type */
-        byUsageType: Record<UsageType, number>;
-    };
-}
-/**
- * Product analysis for API response (flattened)
- */
-export interface ProductAnalysisResponse {
-    qvetCode: number;
-    description: string;
-    section: string;
-    usageType: UsageType;
-    dailyConsumption: number;
-    dailyConsumptionRecent: number;
-    monthlyConsumption: number;
-    qyRatio: number;
-    trend: TrendType;
-    referenceConsumption: number;
-    currentStock: {
-        warehouse: string;
-        stock: number;
-    }[];
-    totalStock: number;
-    minStock: number;
-    optimalStock: number;
-    minDays: number;
-    optimalDays: number;
-    roundingIncrement: number;
-    unitCost: number;
-    proposedMinValue: number;
-    proposedOptValue: number;
-}
 /**
  * Stock flow data for a product
  */

package/dist/{inventory-analysis → contracts/stock-calculation}/types.js

@@ -1,9 +1,9 @@
 "use strict";
 /**
- * Inventory Analysis Types
+ * Stock Calculation Types
  *
- * Type definitions for inventory analysis calculations.
- * Used by StockProposalService, ConsumptionAnalysisService, etc.
+ * Domain types for stock calculation (min/max/optimal).
+ * Used by StockCalculationService, ConsumptionAnalysisService, etc.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TrendType = void 0;

package/dist/index.d.ts

@@ -6,7 +6,6 @@ export * from './types';
 export * from './constants';
 export * from './contracts';
 export * from './validation';
-export * from './inventory-analysis';
 export { debugLog } from './utils/debug-logger';
 export * from './utils/sync-field.helpers';
 export * from './utils/qvet-catalog.helpers';

package/dist/index.js

@@ -23,7 +23,6 @@ __exportStar(require("./types"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./contracts"), exports);
 __exportStar(require("./validation"), exports);
-__exportStar(require("./inventory-analysis"), exports);
 var debug_logger_1 = require("./utils/debug-logger");
 Object.defineProperty(exports, "debugLog", { enumerable: true, get: function () { return debug_logger_1.debugLog; } });
 __exportStar(require("./utils/sync-field.helpers"), exports);

package/package.json

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

package/dist/contracts/inventory-analysis/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Inventory Analysis API Contracts
- *
- * Request and response types for inventory analysis and order optimization.
- */
-export * from './requests';
-export * from './responses';

package/dist/contracts/inventory-analysis/requests.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Inventory Analysis Request Types
- *
- * Request DTOs for inventory analysis and order optimization endpoints.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/inventory-analysis/responses.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Inventory Analysis Response Types
- *
- * Response DTOs for inventory analysis and order optimization endpoints.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/inventory-analysis/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Inventory Analysis Module
- *
- * API contracts for inventory analysis endpoints.
- * Calculation logic lives in hvp-backend domain layer.
- */
-export * from './types';