hvp-shared 9.2.0 → 9.4.0

package/dist/constants/document.enums.d.ts

@@ -89,14 +89,23 @@ export declare enum DocumentStatus {
     outdated = "outdated",
     /**
      * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
-     * Oculto por defecto en listas. ISO 9001 lo llama "obsolete".
+     * Oculto por defecto en listas. Reemplaza a `obsolete` desde 9.3.0
+     * (alineación con ISO/TR 10013 "withdrawn" y con la RAE — "retirado"
+     * captura mejor la decisión activa que "obsoleto").
+     */
+    withdrawn = "withdrawn",
+    /**
+     * @deprecated Renombrado a `withdrawn` desde 9.3.0. Sigue presente en
+     * el enum durante la ventana de migración para compat de lectura;
+     * removable en una mayor futura cuando la BBDD ya no contenga este
+     * valor. La UI lo trata como sinónimo de `withdrawn`.
      */
     obsolete = "obsolete",
     /**
      * Archivado-histórico: preservación de un documento cuya naturaleza es
      * registro (grabaciones de reunión, comunicados pasados, etc.). Oculto por
-     * defecto. Distinto de `obsolete`: archived es preservación pasiva,
-     * obsolete es retiro activo.
+     * defecto. Distinto de `withdrawn`: archived es preservación pasiva,
+     * withdrawn es retiro activo.
      */
     archived = "archived"
 }

package/dist/constants/document.enums.js

@@ -124,14 +124,23 @@ var DocumentStatus;
     DocumentStatus["outdated"] = "outdated";
     /**
      * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
-     * Oculto por defecto en listas. ISO 9001 lo llama "obsolete".
+     * Oculto por defecto en listas. Reemplaza a `obsolete` desde 9.3.0
+     * (alineación con ISO/TR 10013 "withdrawn" y con la RAE — "retirado"
+     * captura mejor la decisión activa que "obsoleto").
+     */
+    DocumentStatus["withdrawn"] = "withdrawn";
+    /**
+     * @deprecated Renombrado a `withdrawn` desde 9.3.0. Sigue presente en
+     * el enum durante la ventana de migración para compat de lectura;
+     * removable en una mayor futura cuando la BBDD ya no contenga este
+     * valor. La UI lo trata como sinónimo de `withdrawn`.
      */
     DocumentStatus["obsolete"] = "obsolete";
     /**
      * Archivado-histórico: preservación de un documento cuya naturaleza es
      * registro (grabaciones de reunión, comunicados pasados, etc.). Oculto por
-     * defecto. Distinto de `obsolete`: archived es preservación pasiva,
-     * obsolete es retiro activo.
+     * defecto. Distinto de `withdrawn`: archived es preservación pasiva,
+     * withdrawn es retiro activo.
      */
     DocumentStatus["archived"] = "archived";
 })(DocumentStatus || (exports.DocumentStatus = DocumentStatus = {}));
@@ -140,7 +149,9 @@ exports.DOCUMENT_STATUS_LABELS = {
     [DocumentStatus.in_review]: "En revisión",
     [DocumentStatus.published]: "Publicado",
     [DocumentStatus.outdated]: "Desactualizado",
-    [DocumentStatus.obsolete]: "Obsoleto",
+    [DocumentStatus.withdrawn]: "Retirado",
+    // Deprecated alias — kept for read compat during 9.3.x migration window
+    [DocumentStatus.obsolete]: "Retirado",
     [DocumentStatus.archived]: "Archivado",
 };
 // ─── Criticality ────────────────────────────────────────────────────────────

package/dist/contracts/document/requests.d.ts

@@ -14,7 +14,9 @@ import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, Ext
  * endpoint for backward compat. The generic endpoint covers the new
  * lifecycle moves added in GH#22 SP2 plus return-to-published.
  */
-export type ChangeableDocumentStatus = DocumentStatus.outdated | DocumentStatus.obsolete | DocumentStatus.published;
+export type ChangeableDocumentStatus = DocumentStatus.outdated | DocumentStatus.withdrawn
+/** @deprecated alias of `withdrawn`; kept for compat during 9.3.x window. */
+ | DocumentStatus.obsolete | DocumentStatus.published;
 import { WebAppRole } from "../../constants/collaborator.constants";
 /**
  * One element of `audience[]`. Either a role or the `"all"` sentinel.

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.2.0",
+  "version": "9.4.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",