hvp-shared 6.25.0 → 6.28.0

package/dist/contracts/catalog-item/responses.d.ts

@@ -198,3 +198,94 @@ export interface CatalogSyncTriggerResponse {
     /** Estimated items to process */
     estimatedItems?: number;
 }
+/**
+ * Naming validation issue severity
+ */
+export type NamingIssueSeverity = 'error' | 'warning' | 'info';
+/**
+ * Single naming validation issue
+ *
+ * Represents a specific problem found in a catalog item name.
+ *
+ * @example { ruleId: 'NV001', severity: 'error', message: 'Double spaces found' }
+ */
+export interface CatalogNamingIssue {
+    /** Rule identifier (NV001, NV002, etc.) */
+    ruleId: string;
+    /** Issue severity */
+    severity: NamingIssueSeverity;
+    /** Human-readable message (Spanish) */
+    message: string;
+    /** Suggested fix if available */
+    suggestion?: string;
+}
+/**
+ * Validation result for a single catalog item
+ *
+ * Contains all issues found and recommendations for a specific item.
+ *
+ * @example GET /api/catalog-items/validate-names
+ */
+export interface CatalogItemNamingValidationResult {
+    /** QVET code */
+    qvetCode: number;
+    /** Current item name */
+    currentName: string;
+    /** Item section */
+    section: string;
+    /** Item family */
+    family: string;
+    /** Item brand */
+    brand: string;
+    /** Stock control type */
+    stockControlType: string;
+    /** Purchase unit */
+    purchaseUnit: string;
+    /** Sale unit */
+    saleUnit: string;
+    /** Conversion factor */
+    conversionFactor: number;
+    /** List of issues found */
+    issues: CatalogNamingIssue[];
+    /** Suggested corrected name if applicable */
+    suggestedName?: string;
+    /** Validation score (0-100, 100 = no issues) */
+    validationScore: number;
+}
+/**
+ * Summary statistics for naming validation
+ */
+export interface CatalogNamingValidationSummary {
+    /** Total items analyzed */
+    totalItems: number;
+    /** Items with at least one issue */
+    itemsWithIssues: number;
+    /** Total error count */
+    errorCount: number;
+    /** Total warning count */
+    warningCount: number;
+    /** Total info count */
+    infoCount: number;
+    /** Breakdown by section */
+    bySection: Record<string, {
+        total: number;
+        withIssues: number;
+    }>;
+    /** Breakdown by rule ID */
+    byRuleId: Record<string, number>;
+}
+/**
+ * Complete naming analysis response
+ *
+ * Full validation results with summary and individual item details.
+ *
+ * @example GET /api/catalog-items/validate-names
+ */
+export interface CatalogNamingAnalysisResponse {
+    /** Summary statistics */
+    summary: CatalogNamingValidationSummary;
+    /** Individual item results (only items with issues) */
+    items: CatalogItemNamingValidationResult[];
+    /** Timestamp when analysis was generated */
+    generatedAt: string;
+}

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

@@ -94,13 +94,17 @@ export interface ProductAnalysis {
 export interface StockFlow {
     /** Initial stock at period start */
     initialStock: number;
-    /** Purchases during period */
+    /** Purchases adjusted by conversion factor (qty × factor) */
     purchases: number;
+    /** Purchase distortion adjustment (based on price ratio analysis) */
+    purchasesDist: number;
+    /** Total purchases = purchases + purchasesDist (for display) */
+    purchasesTotal: number;
     /** Transfers in (received) */
     transfersIn: number;
     /** Transfers out (sent) */
     transfersOut: number;
-    /** Available = initial + purchases + transfersIn - transfersOut */
+    /** Available = initial + purchasesTotal + transfersIn - transfersOut */
     available: number;
     /** Units sold */
     sold: number;

package/package.json

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