hvp-shared 3.4.0 → 3.5.0

package/dist/constants/catalog-item.constants.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CatalogItem Constants
+ *
+ * Enums and constants for catalog items (products/services from QVET).
+ */
+/**
+ * UsageType - How the item is used in HVP
+ *
+ * This is an HVP-only field (not in QVET).
+ */
+export declare enum UsageType {
+    /** Direct sale to customer */
+    VENTA_DIRECTA = "ventaDirecta",
+    /** Optional sale (may or may not be charged) */
+    VENTA_OPCIONAL = "ventaOpcional",
+    /** Only used in recipes/compositions, never sold directly */
+    SOLO_ESCANDALLOS = "soloEscandallos",
+    /** Internal consumption (cleaning supplies, etc.) */
+    CONSUMO_INTERNO = "consumoInterno",
+    /** Fixed asset (equipment, furniture) */
+    ACTIVO_FIJO = "activoFijo"
+}
+/**
+ * All UsageType values as array (for dropdowns)
+ */
+export declare const USAGE_TYPE_VALUES: UsageType[];
+/**
+ * UsageType labels in Spanish (for UI)
+ */
+export declare const USAGE_TYPE_LABELS: Record<UsageType, string>;
+/**
+ * ArticleType - Type of article in QVET
+ */
+export declare enum ArticleType {
+    MEDICAMENTO = "Medicamento",
+    SERVICIO = "Servicio",
+    NORMAL = "Normal"
+}
+/**
+ * All ArticleType values as array
+ */
+export declare const ARTICLE_TYPE_VALUES: ArticleType[];
+/**
+ * SyncStatus - Status of sync with QVET
+ */
+export declare enum SyncStatus {
+    /** Fully synced with QVET, no pending changes */
+    SYNCED = "synced",
+    /** Has local changes pending upload to QVET */
+    PENDING = "pending",
+    /** Local changes conflict with QVET changes */
+    CONFLICT = "conflict",
+    /** Item exists in HVP but not found in last QVET sync */
+    MISSING_FROM_QVET = "missing_from_qvet"
+}
+/**
+ * All SyncStatus values as array
+ */
+export declare const SYNC_STATUS_VALUES: SyncStatus[];
+/**
+ * SyncStatus labels in Spanish (for UI)
+ */
+export declare const SYNC_STATUS_LABELS: Record<SyncStatus, string>;

package/dist/constants/catalog-item.constants.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * CatalogItem Constants
+ *
+ * Enums and constants for catalog items (products/services from QVET).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_STATUS_LABELS = exports.SYNC_STATUS_VALUES = exports.SyncStatus = exports.ARTICLE_TYPE_VALUES = exports.ArticleType = exports.USAGE_TYPE_LABELS = exports.USAGE_TYPE_VALUES = exports.UsageType = void 0;
+/**
+ * UsageType - How the item is used in HVP
+ *
+ * This is an HVP-only field (not in QVET).
+ */
+var UsageType;
+(function (UsageType) {
+    /** Direct sale to customer */
+    UsageType["VENTA_DIRECTA"] = "ventaDirecta";
+    /** Optional sale (may or may not be charged) */
+    UsageType["VENTA_OPCIONAL"] = "ventaOpcional";
+    /** Only used in recipes/compositions, never sold directly */
+    UsageType["SOLO_ESCANDALLOS"] = "soloEscandallos";
+    /** Internal consumption (cleaning supplies, etc.) */
+    UsageType["CONSUMO_INTERNO"] = "consumoInterno";
+    /** Fixed asset (equipment, furniture) */
+    UsageType["ACTIVO_FIJO"] = "activoFijo";
+})(UsageType || (exports.UsageType = UsageType = {}));
+/**
+ * All UsageType values as array (for dropdowns)
+ */
+exports.USAGE_TYPE_VALUES = Object.values(UsageType);
+/**
+ * UsageType labels in Spanish (for UI)
+ */
+exports.USAGE_TYPE_LABELS = {
+    [UsageType.VENTA_DIRECTA]: 'Venta Directa',
+    [UsageType.VENTA_OPCIONAL]: 'Venta Opcional',
+    [UsageType.SOLO_ESCANDALLOS]: 'Solo Escandallos',
+    [UsageType.CONSUMO_INTERNO]: 'Consumo Interno',
+    [UsageType.ACTIVO_FIJO]: 'Activo Fijo',
+};
+/**
+ * ArticleType - Type of article in QVET
+ */
+var ArticleType;
+(function (ArticleType) {
+    ArticleType["MEDICAMENTO"] = "Medicamento";
+    ArticleType["SERVICIO"] = "Servicio";
+    ArticleType["NORMAL"] = "Normal";
+})(ArticleType || (exports.ArticleType = ArticleType = {}));
+/**
+ * All ArticleType values as array
+ */
+exports.ARTICLE_TYPE_VALUES = Object.values(ArticleType);
+/**
+ * SyncStatus - Status of sync with QVET
+ */
+var SyncStatus;
+(function (SyncStatus) {
+    /** Fully synced with QVET, no pending changes */
+    SyncStatus["SYNCED"] = "synced";
+    /** Has local changes pending upload to QVET */
+    SyncStatus["PENDING"] = "pending";
+    /** Local changes conflict with QVET changes */
+    SyncStatus["CONFLICT"] = "conflict";
+    /** Item exists in HVP but not found in last QVET sync */
+    SyncStatus["MISSING_FROM_QVET"] = "missing_from_qvet";
+})(SyncStatus || (exports.SyncStatus = SyncStatus = {}));
+/**
+ * All SyncStatus values as array
+ */
+exports.SYNC_STATUS_VALUES = Object.values(SyncStatus);
+/**
+ * SyncStatus labels in Spanish (for UI)
+ */
+exports.SYNC_STATUS_LABELS = {
+    [SyncStatus.SYNCED]: 'Sincronizado',
+    [SyncStatus.PENDING]: 'Pendiente',
+    [SyncStatus.CONFLICT]: 'Conflicto',
+    [SyncStatus.MISSING_FROM_QVET]: 'No encontrado en QVET',
+};

package/dist/constants/index.d.ts

@@ -4,3 +4,7 @@
 export * from './mexican-states';
 export * from './sat-catalogs';
 export * from './collaborator.constants';
+export * from './catalog-item.constants';
+export * from './qvet-catalog';
+export * from './qvet-warehouses';
+export * from './qvet-inventory';

package/dist/constants/index.js

@@ -20,3 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./mexican-states"), exports);
 __exportStar(require("./sat-catalogs"), exports);
 __exportStar(require("./collaborator.constants"), exports);
+__exportStar(require("./catalog-item.constants"), exports);
+__exportStar(require("./qvet-catalog"), exports);
+__exportStar(require("./qvet-warehouses"), exports);
+__exportStar(require("./qvet-inventory"), exports);

package/dist/{inventory → constants}/qvet-catalog.d.ts

@@ -1,10 +1,17 @@
 /**
  * QVET Catalog
- * Complete hierarchy of sections, families, and subfamilies from QVET system
+ *
+ * Complete hierarchy of sections, families, and subfamilies from QVET system.
  * Source: QVET system export (Updated 2026-01-10)
  *
  * Structure: SECTION → FAMILY → SUBFAMILY[]
  * Each combination is unique and can change independently in QVET.
+ *
+ * Related files:
+ * - Types: types/qvet.types.ts
+ * - Inventory rules: constants/qvet-inventory.ts
+ * - Warehouses: constants/qvet-warehouses.ts
+ * - Helpers: utils/qvet-catalog.helpers.ts
  */
 export declare const QVET_SECTIONS: {
     readonly EQUIPAMIENTO: "EQUIPAMIENTO";
@@ -17,7 +24,6 @@ export declare const QVET_SECTIONS: {
     readonly SERVICIOS_MEDICOS: "SERVICIOS MEDICOS";
     readonly SUMINISTROS_GENERALES: "SUMINISTROS GENERALES";
 };
-export type QvetSection = typeof QVET_SECTIONS[keyof typeof QVET_SECTIONS];
 export declare const QVET_CATALOG: {
     readonly EQUIPAMIENTO: {
         readonly UNICA: readonly ["UNICA"];
@@ -107,63 +113,7 @@ export declare const QVET_CATALOG: {
         readonly PAPELERIA: readonly ["UNICA"];
     };
 };
-export type QvetCatalog = typeof QVET_CATALOG;
 /**
  * All section values as array
  */
 export declare const QVET_SECTIONS_LIST: ("EQUIPAMIENTO" | "FARMACIA" | "FARMACIA INTERNA" | "INSUMOS MEDICOS" | "OTROS ARTICULOS" | "OTROS SERVICIOS" | "SERVICIOS EXTERNOS" | "SERVICIOS MEDICOS" | "SUMINISTROS GENERALES")[];
-/**
- * Sections that are countable for inventory (physical items, not services)
- * Excludes: OTROS SERVICIOS, SERVICIOS EXTERNOS, SERVICIOS MEDICOS
- */
-export declare const INVENTORY_COUNTABLE_SECTIONS: readonly ["EQUIPAMIENTO", "FARMACIA", "FARMACIA INTERNA", "INSUMOS MEDICOS", "OTROS ARTICULOS", "SUMINISTROS GENERALES"];
-/**
- * Set for quick lookup of countable sections
- */
-export declare const INVENTORY_COUNTABLE_SECTIONS_SET: ReadonlySet<string>;
-/**
- * Priority sections for sorting (appear first in count sheets)
- */
-export declare const SECTION_SORT_PRIORITY: readonly ["FARMACIA", "FARMACIA INTERNA", "INSUMOS MEDICOS"];
-/**
- * Get all families for a section
- */
-export declare function getFamiliesForSection(section: string): string[];
-/**
- * Get all subfamilies for a section + family combination
- */
-export declare function getSubfamiliesForFamily(section: string, family: string): readonly string[];
-/**
- * Check if a section exists in the catalog
- */
-export declare function isValidSection(section: string): boolean;
-/**
- * Check if a section is countable (physical inventory)
- */
-export declare function isCountableSection(section: string): boolean;
-/**
- * Check if a family exists within a section
- */
-export declare function isValidFamily(section: string, family: string): boolean;
-/**
- * Check if a subfamily exists within a section + family
- */
-export declare function isValidSubfamily(section: string, family: string, subfamily: string): boolean;
-/**
- * Get sort order for a section (lower = higher priority)
- */
-export declare function getSectionSortOrder(section: string): number;
-/**
- * Sections that ALWAYS require expiration date tracking
- */
-export declare const SECTIONS_REQUIRE_EXPIRATION: readonly ["FARMACIA", "FARMACIA INTERNA"];
-/**
- * Specific families within sections that require expiration date tracking
- */
-export declare const FAMILIES_REQUIRE_EXPIRATION: Partial<Record<QvetSection, readonly string[]>>;
-/**
- * Check if an item requires expiration date tracking based on section and family
- */
-export declare function requiresExpirationDate(section: string, family: string): boolean;
-export declare const WAREHOUSES: readonly ["HARBOR", "MONTEJO", "URBAN CENTER"];
-export type Warehouse = typeof WAREHOUSES[number];

package/dist/{inventory → constants}/qvet-catalog.js

@@ -1,22 +1,21 @@
 "use strict";
 /**
  * QVET Catalog
- * Complete hierarchy of sections, families, and subfamilies from QVET system
+ *
+ * Complete hierarchy of sections, families, and subfamilies from QVET system.
  * Source: QVET system export (Updated 2026-01-10)
  *
  * Structure: SECTION → FAMILY → SUBFAMILY[]
  * Each combination is unique and can change independently in QVET.
+ *
+ * Related files:
+ * - Types: types/qvet.types.ts
+ * - Inventory rules: constants/qvet-inventory.ts
+ * - Warehouses: constants/qvet-warehouses.ts
+ * - Helpers: utils/qvet-catalog.helpers.ts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WAREHOUSES = exports.FAMILIES_REQUIRE_EXPIRATION = exports.SECTIONS_REQUIRE_EXPIRATION = exports.SECTION_SORT_PRIORITY = exports.INVENTORY_COUNTABLE_SECTIONS_SET = exports.INVENTORY_COUNTABLE_SECTIONS = exports.QVET_SECTIONS_LIST = exports.QVET_CATALOG = exports.QVET_SECTIONS = void 0;
-exports.getFamiliesForSection = getFamiliesForSection;
-exports.getSubfamiliesForFamily = getSubfamiliesForFamily;
-exports.isValidSection = isValidSection;
-exports.isCountableSection = isCountableSection;
-exports.isValidFamily = isValidFamily;
-exports.isValidSubfamily = isValidSubfamily;
-exports.getSectionSortOrder = getSectionSortOrder;
-exports.requiresExpirationDate = requiresExpirationDate;
+exports.QVET_SECTIONS_LIST = exports.QVET_CATALOG = exports.QVET_SECTIONS = void 0;
 // =============================================================================
 // SECTIONS (Single source of truth for section strings)
 // =============================================================================
@@ -136,131 +135,9 @@ exports.QVET_CATALOG = {
     },
 };
 // =============================================================================
-// DERIVED CONSTANTS (No string repetition - use QVET_SECTIONS)
+// DERIVED LISTS
 // =============================================================================
 /**
  * All section values as array
  */
 exports.QVET_SECTIONS_LIST = Object.values(exports.QVET_SECTIONS);
-/**
- * Sections that are countable for inventory (physical items, not services)
- * Excludes: OTROS SERVICIOS, SERVICIOS EXTERNOS, SERVICIOS MEDICOS
- */
-exports.INVENTORY_COUNTABLE_SECTIONS = [
-    exports.QVET_SECTIONS.EQUIPAMIENTO,
-    exports.QVET_SECTIONS.FARMACIA,
-    exports.QVET_SECTIONS.FARMACIA_INTERNA,
-    exports.QVET_SECTIONS.INSUMOS_MEDICOS,
-    exports.QVET_SECTIONS.OTROS_ARTICULOS,
-    exports.QVET_SECTIONS.SUMINISTROS_GENERALES,
-];
-/**
- * Set for quick lookup of countable sections
- */
-exports.INVENTORY_COUNTABLE_SECTIONS_SET = new Set(exports.INVENTORY_COUNTABLE_SECTIONS);
-/**
- * Priority sections for sorting (appear first in count sheets)
- */
-exports.SECTION_SORT_PRIORITY = [
-    exports.QVET_SECTIONS.FARMACIA,
-    exports.QVET_SECTIONS.FARMACIA_INTERNA,
-    exports.QVET_SECTIONS.INSUMOS_MEDICOS,
-];
-// =============================================================================
-// UTILITY FUNCTIONS
-// =============================================================================
-/**
- * Get all families for a section
- */
-function getFamiliesForSection(section) {
-    const sectionData = exports.QVET_CATALOG[section];
-    if (!sectionData)
-        return [];
-    return Object.keys(sectionData);
-}
-/**
- * Get all subfamilies for a section + family combination
- */
-function getSubfamiliesForFamily(section, family) {
-    const sectionData = exports.QVET_CATALOG[section];
-    if (!sectionData)
-        return [];
-    const familyData = sectionData[family];
-    if (!familyData)
-        return [];
-    return familyData;
-}
-/**
- * Check if a section exists in the catalog
- */
-function isValidSection(section) {
-    return section in exports.QVET_CATALOG;
-}
-/**
- * Check if a section is countable (physical inventory)
- */
-function isCountableSection(section) {
-    return exports.INVENTORY_COUNTABLE_SECTIONS_SET.has(section);
-}
-/**
- * Check if a family exists within a section
- */
-function isValidFamily(section, family) {
-    const sectionData = exports.QVET_CATALOG[section];
-    if (!sectionData)
-        return false;
-    return family in sectionData;
-}
-/**
- * Check if a subfamily exists within a section + family
- */
-function isValidSubfamily(section, family, subfamily) {
-    const subfamilies = getSubfamiliesForFamily(section, family);
-    return subfamilies.includes(subfamily);
-}
-/**
- * Get sort order for a section (lower = higher priority)
- */
-function getSectionSortOrder(section) {
-    const index = exports.SECTION_SORT_PRIORITY.indexOf(section);
-    if (index >= 0) {
-        return index;
-    }
-    // Non-priority sections come after, sorted alphabetically
-    return exports.SECTION_SORT_PRIORITY.length + section.charCodeAt(0);
-}
-// =============================================================================
-// EXPIRATION DATE REQUIREMENTS
-// =============================================================================
-/**
- * Sections that ALWAYS require expiration date tracking
- */
-exports.SECTIONS_REQUIRE_EXPIRATION = [
-    exports.QVET_SECTIONS.FARMACIA,
-    exports.QVET_SECTIONS.FARMACIA_INTERNA,
-];
-/**
- * Specific families within sections that require expiration date tracking
- */
-exports.FAMILIES_REQUIRE_EXPIRATION = {
-    [exports.QVET_SECTIONS.INSUMOS_MEDICOS]: ['SUEROS Y SOLUCIONES', 'VACUNAS'],
-};
-/**
- * Check if an item requires expiration date tracking based on section and family
- */
-function requiresExpirationDate(section, family) {
-    // Full section requires expiration
-    if (exports.SECTIONS_REQUIRE_EXPIRATION.includes(section)) {
-        return true;
-    }
-    // Check specific families within sections
-    const familiesForSection = exports.FAMILIES_REQUIRE_EXPIRATION[section];
-    if (familiesForSection) {
-        return familiesForSection.includes(family);
-    }
-    return false;
-}
-// =============================================================================
-// WAREHOUSES
-// =============================================================================
-exports.WAREHOUSES = ['HARBOR', 'MONTEJO', 'URBAN CENTER'];

package/dist/constants/qvet-inventory.d.ts

@@ -0,0 +1,28 @@
+/**
+ * QVET Inventory Constants
+ *
+ * Constants related to inventory management: countable sections,
+ * sort priorities, and expiration date requirements.
+ */
+import { QvetSection } from '../types/qvet.types';
+/**
+ * Sections that are countable for inventory (physical items, not services)
+ * Excludes: OTROS SERVICIOS, SERVICIOS EXTERNOS, SERVICIOS MEDICOS
+ */
+export declare const INVENTORY_COUNTABLE_SECTIONS: readonly ["EQUIPAMIENTO", "FARMACIA", "FARMACIA INTERNA", "INSUMOS MEDICOS", "OTROS ARTICULOS", "SUMINISTROS GENERALES"];
+/**
+ * Set for quick lookup of countable sections
+ */
+export declare const INVENTORY_COUNTABLE_SECTIONS_SET: ReadonlySet<string>;
+/**
+ * Priority sections for sorting (appear first in count sheets)
+ */
+export declare const SECTION_SORT_PRIORITY: readonly ["FARMACIA", "FARMACIA INTERNA", "INSUMOS MEDICOS"];
+/**
+ * Sections that ALWAYS require expiration date tracking
+ */
+export declare const SECTIONS_REQUIRE_EXPIRATION: readonly ["FARMACIA", "FARMACIA INTERNA"];
+/**
+ * Specific families within sections that require expiration date tracking
+ */
+export declare const FAMILIES_REQUIRE_EXPIRATION: Partial<Record<QvetSection, readonly string[]>>;

package/dist/constants/qvet-inventory.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * QVET Inventory Constants
+ *
+ * Constants related to inventory management: countable sections,
+ * sort priorities, and expiration date requirements.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAMILIES_REQUIRE_EXPIRATION = exports.SECTIONS_REQUIRE_EXPIRATION = exports.SECTION_SORT_PRIORITY = exports.INVENTORY_COUNTABLE_SECTIONS_SET = exports.INVENTORY_COUNTABLE_SECTIONS = void 0;
+const qvet_catalog_1 = require("./qvet-catalog");
+// =============================================================================
+// COUNTABLE SECTIONS (Physical items, not services)
+// =============================================================================
+/**
+ * Sections that are countable for inventory (physical items, not services)
+ * Excludes: OTROS SERVICIOS, SERVICIOS EXTERNOS, SERVICIOS MEDICOS
+ */
+exports.INVENTORY_COUNTABLE_SECTIONS = [
+    qvet_catalog_1.QVET_SECTIONS.EQUIPAMIENTO,
+    qvet_catalog_1.QVET_SECTIONS.FARMACIA,
+    qvet_catalog_1.QVET_SECTIONS.FARMACIA_INTERNA,
+    qvet_catalog_1.QVET_SECTIONS.INSUMOS_MEDICOS,
+    qvet_catalog_1.QVET_SECTIONS.OTROS_ARTICULOS,
+    qvet_catalog_1.QVET_SECTIONS.SUMINISTROS_GENERALES,
+];
+/**
+ * Set for quick lookup of countable sections
+ */
+exports.INVENTORY_COUNTABLE_SECTIONS_SET = new Set(exports.INVENTORY_COUNTABLE_SECTIONS);
+// =============================================================================
+// SORT PRIORITY
+// =============================================================================
+/**
+ * Priority sections for sorting (appear first in count sheets)
+ */
+exports.SECTION_SORT_PRIORITY = [
+    qvet_catalog_1.QVET_SECTIONS.FARMACIA,
+    qvet_catalog_1.QVET_SECTIONS.FARMACIA_INTERNA,
+    qvet_catalog_1.QVET_SECTIONS.INSUMOS_MEDICOS,
+];
+// =============================================================================
+// EXPIRATION DATE REQUIREMENTS
+// =============================================================================
+/**
+ * Sections that ALWAYS require expiration date tracking
+ */
+exports.SECTIONS_REQUIRE_EXPIRATION = [
+    qvet_catalog_1.QVET_SECTIONS.FARMACIA,
+    qvet_catalog_1.QVET_SECTIONS.FARMACIA_INTERNA,
+];
+/**
+ * Specific families within sections that require expiration date tracking
+ */
+exports.FAMILIES_REQUIRE_EXPIRATION = {
+    [qvet_catalog_1.QVET_SECTIONS.INSUMOS_MEDICOS]: ['SUEROS Y SOLUCIONES', 'VACUNAS'],
+};

package/dist/constants/qvet-warehouses.d.ts

@@ -0,0 +1,6 @@
+/**
+ * QVET Warehouses
+ *
+ * Physical warehouse locations in QVET system.
+ */
+export declare const WAREHOUSES: readonly ["HARBOR", "MONTEJO", "URBAN CENTER"];

package/dist/constants/qvet-warehouses.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * QVET Warehouses
+ *
+ * Physical warehouse locations in QVET system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WAREHOUSES = void 0;
+exports.WAREHOUSES = ['HARBOR', 'MONTEJO', 'URBAN CENTER'];

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

@@ -0,0 +1,2 @@
+export * from './requests';
+export * from './responses';

package/dist/{inventory → contracts/catalog-item}/index.js

@@ -14,4 +14,5 @@ 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("./qvet-catalog"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

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

@@ -0,0 +1,113 @@
+/**
+ * CatalogItem Request Types
+ *
+ * Request DTOs for catalog item endpoints.
+ */
+import { UsageType, SyncStatus } from '../../constants/catalog-item.constants';
+/**
+ * Query filters for listing catalog items
+ *
+ * @example GET /api/catalog-items?section=FARMACIA&isActive=true&page=1&limit=20
+ */
+export interface CatalogItemQueryFilters {
+    /** Filter by section */
+    section?: string;
+    /** Filter by family */
+    family?: string;
+    /** Filter by usage type */
+    usageType?: UsageType;
+    /** Filter by active status */
+    isActive?: boolean;
+    /** Filter by sync status */
+    syncStatus?: SyncStatus;
+    /** Show only items with pending changes */
+    hasPendingChanges?: boolean;
+    /** Search in description/barcode */
+    search?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Items per page */
+    limit?: number;
+    /** Sort field */
+    sortBy?: 'description' | 'qvetCode' | 'section' | 'salePrice' | 'updatedAt';
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Update QVET sync fields (sets pending values)
+ *
+ * @example PATCH /api/catalog-items/:id
+ */
+export interface UpdateCatalogItemRequest {
+    /** Update description (sets pending) */
+    description?: string;
+    /** Update sale price (sets pending) */
+    salePrice?: number;
+    /** Update purchase price (sets pending) */
+    purchasePrice?: number;
+    /** Update section (sets pending) */
+    section?: string;
+    /** Update family (sets pending) */
+    family?: string;
+    /** Update subfamily (sets pending) */
+    subfamily?: string;
+    /** Update barcode (sets pending) */
+    barcode?: string;
+    /** Update reference (sets pending) */
+    reference?: string;
+    /** Update brand (sets pending) */
+    brand?: string;
+    /** Update active status (sets pending) */
+    isActive?: boolean;
+    /** Update stock control type (sets pending) */
+    stockControlType?: string;
+}
+/**
+ * Update HVP-only fields (direct update, no pending)
+ *
+ * @example PATCH /api/catalog-items/:id/hvp-data
+ */
+export interface UpdateCatalogItemHvpDataRequest {
+    /** Usage type */
+    usageType?: UsageType;
+    /** Internal notes */
+    notes?: string;
+    /** Internal category */
+    internalCategory?: string;
+}
+/**
+ * Update stock levels for a warehouse (sets pending)
+ *
+ * @example PATCH /api/catalog-items/:id/stock/:warehouse
+ */
+export interface UpdateWarehouseStockRequest {
+    /** Minimum stock level */
+    minStock?: number;
+    /** Optimal stock level */
+    optimalStock?: number;
+}
+/**
+ * Bulk update request
+ *
+ * @example PATCH /api/catalog-items/bulk
+ */
+export interface BulkUpdateCatalogItemsRequest {
+    /** Item IDs to update */
+    ids: string[];
+    /** Updates to apply */
+    updates: {
+        /** Update usage type for all selected items */
+        usageType?: UsageType;
+        /** Update active status (sets pending) */
+        isActive?: boolean;
+    };
+}
+/**
+ * Revert a field to QVET value
+ *
+ * @example POST /api/catalog-items/:id/revert/:field
+ */
+export interface RevertFieldRequest {
+    /** Field name to revert */
+    field: string;
+}

package/dist/contracts/catalog-item/requests.js

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