hvp-shared 9.3.0 → 9.4.0

package/dist/contracts/index.d.ts

@@ -21,3 +21,4 @@ export * from './supplier-overlay';
 export * from './external-study';
 export * from './pending-dashboard';
 export * from './document';
+export * from './supplier-orders';

package/dist/contracts/index.js

@@ -37,3 +37,4 @@ __exportStar(require("./supplier-overlay"), exports);
 __exportStar(require("./external-study"), exports);
 __exportStar(require("./pending-dashboard"), exports);
 __exportStar(require("./document"), exports);
+__exportStar(require("./supplier-orders"), exports);

package/dist/contracts/supplier-orders/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Supplier Orders API Contracts
+ */
+export * from './requests';
+export * from './responses';

package/dist/contracts/supplier-orders/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Supplier Orders API Contracts
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/supplier-orders/requests.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Supplier Orders API Requests
+ */
+/**
+ * Query filters for fetching supplier order suggestions.
+ *
+ * Used for: GET /api/inventory/supplier-orders
+ *
+ * @example GET /api/inventory/supplier-orders?supplier=DESEGO&months=12
+ */
+export interface SupplierOrderQueryFilters {
+    supplier: string;
+    months?: number;
+}
+/**
+ * Query filters for the supplier list endpoint.
+ *
+ * Used for: GET /api/inventory/supplier-orders/suppliers
+ *
+ * @example GET /api/inventory/supplier-orders/suppliers?months=12
+ */
+export interface SupplierListQueryFilters {
+    months?: number;
+}

package/dist/contracts/supplier-orders/requests.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Supplier Orders API Requests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/supplier-orders/responses.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Supplier Orders API Responses
+ */
+/**
+ * Stock figures (current / min / optimal) for a single warehouse or aggregated globally.
+ */
+export interface SupplierOrderStockFigures {
+    currentStock: number;
+    minStock: number;
+    optimalStock: number;
+}
+/**
+ * Per-warehouse breakdown of stock for a single product.
+ */
+export interface SupplierOrderWarehouseBreakdown extends SupplierOrderStockFigures {
+    warehouse: string;
+}
+/**
+ * Single product line in the supplier order suggestions response.
+ *
+ * `suggested` is computed as `max(optimalStock - currentStock, 0)` against the global
+ * (cross-warehouse) figures. `suggestedSubtotal` is the line cost without IVA.
+ */
+export interface SupplierOrderItemResponse {
+    qvetCode: number;
+    name: string;
+    unitPurchasePrice: number;
+    global: SupplierOrderStockFigures & {
+        suggested: number;
+    };
+    byWarehouse: SupplierOrderWarehouseBreakdown[];
+    suggestedSubtotal: number;
+}
+/**
+ * Aggregate totals for the suggested order across all items.
+ */
+export interface SupplierOrderTotals {
+    subtotalBeforeTax: number;
+    subtotalAfterTax: number;
+}
+/**
+ * Supplier Order Suggestions Response.
+ *
+ * Lists all products purchased from the given supplier within the time window,
+ * with current stock, min/opt thresholds, suggested quantity to order and totals.
+ *
+ * Used for: Supplier Orders dashboard page (manual order planning by supplier).
+ *
+ * @example GET /api/inventory/supplier-orders?supplier=DESEGO&months=12
+ */
+export interface SupplierOrderSuggestionsResponse {
+    supplier: string;
+    months: number;
+    items: SupplierOrderItemResponse[];
+    totals: SupplierOrderTotals;
+}
+/**
+ * Supplier List Response.
+ *
+ * Distinct list of supplier names with at least one purchase within the window.
+ *
+ * Used for: Supplier dropdown on the Supplier Orders dashboard page.
+ *
+ * @example GET /api/inventory/supplier-orders/suppliers?months=12
+ */
+export interface SupplierListResponse {
+    suppliers: string[];
+}

package/dist/contracts/supplier-orders/responses.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Supplier Orders API Responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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