hvp-shared 3.3.3 → 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/constants/qvet-catalog.d.ts

@@ -0,0 +1,119 @@
+/**
+ * QVET Catalog
+ *
+ * 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";
+    readonly FARMACIA: "FARMACIA";
+    readonly FARMACIA_INTERNA: "FARMACIA INTERNA";
+    readonly INSUMOS_MEDICOS: "INSUMOS MEDICOS";
+    readonly OTROS_ARTICULOS: "OTROS ARTICULOS";
+    readonly OTROS_SERVICIOS: "OTROS SERVICIOS";
+    readonly SERVICIOS_EXTERNOS: "SERVICIOS EXTERNOS";
+    readonly SERVICIOS_MEDICOS: "SERVICIOS MEDICOS";
+    readonly SUMINISTROS_GENERALES: "SUMINISTROS GENERALES";
+};
+export declare const QVET_CATALOG: {
+    readonly EQUIPAMIENTO: {
+        readonly UNICA: readonly ["UNICA"];
+    };
+    readonly FARMACIA: {
+        readonly 'ANESTESICOS O TRANQUILIZANTES': readonly ["UNICA"];
+        readonly ANTIBIOTICOS: readonly ["UNICA"];
+        readonly 'ANTIINFLAMATORIOS O ANALGESICOS': readonly ["UNICA"];
+        readonly ANTIMICOTICOS: readonly ["UNICA"];
+        readonly ANTIPARASITARIOS: readonly ["UNICA"];
+        readonly CARDIOLOGICOS: readonly ["UNICA"];
+        readonly DERMATOLOGICOS: readonly ["UNICA"];
+        readonly GASTROENTEROLOGICOS: readonly ["UNICA"];
+        readonly OFTALMOLOGICOS: readonly ["UNICA"];
+        readonly OTOLOGICOS: readonly ["UNICA"];
+        readonly OTROS: readonly ["UNICA"];
+        readonly SUPLEMENTOS: readonly ["UNICA"];
+        readonly TIROIDEOS: readonly ["UNICA"];
+    };
+    readonly "FARMACIA INTERNA": {
+        readonly 'ANESTESICOS O TRANQUILIZANTES': readonly ["UNICA"];
+        readonly ANTIBIOTICOS: readonly ["UNICA"];
+        readonly 'ANTIINFLAMATORIOS O ANALGESICOS': readonly ["UNICA"];
+        readonly ANTIPARASITARIOS: readonly ["UNICA"];
+        readonly CARDIOLOGICOS: readonly ["UNICA"];
+        readonly GASTROENTEROLOGICOS: readonly ["UNICA"];
+        readonly OFTALMOLOGICOS: readonly ["UNICA"];
+        readonly OTROS: readonly ["UNICA"];
+    };
+    readonly "INSUMOS MEDICOS": {
+        readonly AGUJAS: readonly ["UNICA"];
+        readonly CATETERES: readonly ["UNICA"];
+        readonly CURACION: readonly ["UNICA"];
+        readonly 'INDUMENTARIA SANITARIA': readonly ["UNICA"];
+        readonly 'INSUMOS PARA PRUEBAS': readonly ["UNICA"];
+        readonly JERINGAS: readonly ["UNICA"];
+        readonly OFTALMOLOGIA: readonly ["UNICA"];
+        readonly OTROS: readonly ["UNICA"];
+        readonly SONDAS: readonly ["UNICA"];
+        readonly 'SUEROS Y SOLUCIONES': readonly ["UNICA"];
+        readonly SUTURAS: readonly ["UNICA"];
+        readonly TESTS: readonly ["UNICA"];
+        readonly VACUNAS: readonly ["UNICA"];
+        readonly VENDAS: readonly ["UNICA"];
+    };
+    readonly "OTROS ARTICULOS": {
+        readonly MICROCHIP: readonly ["UNICA"];
+        readonly OTROS: readonly ["UNICA"];
+    };
+    readonly "OTROS SERVICIOS": {
+        readonly FCM: readonly ["UNICA"];
+        readonly GUARDERIA: readonly ["UNICA"];
+        readonly 'OTROS SERVICIOS': readonly ["UNICA"];
+        readonly PAQUETES: readonly ["UNICA"];
+        readonly PENSION: readonly ["UNICA"];
+        readonly 'RENTA QUIROFANO': readonly ["UNICA"];
+    };
+    readonly "SERVICIOS EXTERNOS": {
+        readonly 'CONSULTAS EXTERNAS': readonly ["UNICA"];
+        readonly INCINERACION: readonly ["INCINERACION", "SERVICIOS ADICIONALES", "URNAS Y RELICARIOS"];
+        readonly LABORATORIO: readonly ["COPROPARASITOSCOPICO", "CULTIVOS", "CUSHING", "HEMOGRAMA", "HEMOPARASITOS", "OTROS", "PATOLOGIA CLINICA", "PERFIL HORMONAL", "PERFIL TIROIDEO", "QUIMICA SANGUINEA", "TOMOGRAFIA"];
+        readonly OTROS: readonly ["UNICA"];
+        readonly 'PRUEBAS DE GABINETE': readonly ["ELECTROCARDIOGRAMA", "OTROS", "RADIOLOGIA", "ULTRASONIDO"];
+    };
+    readonly "SERVICIOS MEDICOS": {
+        readonly 'ASISTENCIA QUIRURGICA': readonly ["UNICA"];
+        readonly 'CERTIFICADOS DE SALUD': readonly ["UNICA"];
+        readonly 'CIRUGIA DE TEJIDOS BLANDOS': readonly ["ABDOMEN", "CABEZA", "NEOPLASIA", "OTROS", "PERINEO", "TORAX"];
+        readonly CONSULTA: readonly ["DOMICILIARIA", "ESPECIALIDAD", "GENERAL", "REVISION"];
+        readonly DESPARASITACION: readonly ["UNICA"];
+        readonly DIAGNOSTICO: readonly ["UNICA"];
+        readonly EMERGENCIA: readonly ["UNICA"];
+        readonly EUTANASIA: readonly ["UNICA"];
+        readonly HOSPITALIZACION: readonly ["UNICA"];
+        readonly OFTALMOLOGIA: readonly ["UNICA"];
+        readonly ORTOPEDIA: readonly ["UNICA"];
+        readonly OTROS: readonly ["UNICA"];
+        readonly TRATAMIENTO: readonly ["UNICA"];
+        readonly VACUNAS: readonly ["UNICA"];
+    };
+    readonly "SUMINISTROS GENERALES": {
+        readonly ALIMENTOS: readonly ["UNICA"];
+        readonly ETIQUETAS: readonly ["UNICA"];
+        readonly IMPRESOS: readonly ["UNICA"];
+        readonly LIMPIEZA: readonly ["UNICA"];
+        readonly OTROS: readonly ["UNICA"];
+        readonly PAPELERIA: readonly ["UNICA"];
+    };
+};
+/**
+ * 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")[];

package/dist/constants/qvet-catalog.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * QVET Catalog
+ *
+ * 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.QVET_SECTIONS_LIST = exports.QVET_CATALOG = exports.QVET_SECTIONS = void 0;
+// =============================================================================
+// SECTIONS (Single source of truth for section strings)
+// =============================================================================
+exports.QVET_SECTIONS = {
+    EQUIPAMIENTO: 'EQUIPAMIENTO',
+    FARMACIA: 'FARMACIA',
+    FARMACIA_INTERNA: 'FARMACIA INTERNA',
+    INSUMOS_MEDICOS: 'INSUMOS MEDICOS',
+    OTROS_ARTICULOS: 'OTROS ARTICULOS',
+    OTROS_SERVICIOS: 'OTROS SERVICIOS',
+    SERVICIOS_EXTERNOS: 'SERVICIOS EXTERNOS',
+    SERVICIOS_MEDICOS: 'SERVICIOS MEDICOS',
+    SUMINISTROS_GENERALES: 'SUMINISTROS GENERALES',
+};
+// =============================================================================
+// COMPLETE CATALOG (Section → Family → Subfamilies)
+// =============================================================================
+exports.QVET_CATALOG = {
+    [exports.QVET_SECTIONS.EQUIPAMIENTO]: {
+        'UNICA': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.FARMACIA]: {
+        'ANESTESICOS O TRANQUILIZANTES': ['UNICA'],
+        'ANTIBIOTICOS': ['UNICA'],
+        'ANTIINFLAMATORIOS O ANALGESICOS': ['UNICA'],
+        'ANTIMICOTICOS': ['UNICA'],
+        'ANTIPARASITARIOS': ['UNICA'],
+        'CARDIOLOGICOS': ['UNICA'],
+        'DERMATOLOGICOS': ['UNICA'],
+        'GASTROENTEROLOGICOS': ['UNICA'],
+        'OFTALMOLOGICOS': ['UNICA'],
+        'OTOLOGICOS': ['UNICA'],
+        'OTROS': ['UNICA'],
+        'SUPLEMENTOS': ['UNICA'],
+        'TIROIDEOS': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.FARMACIA_INTERNA]: {
+        'ANESTESICOS O TRANQUILIZANTES': ['UNICA'],
+        'ANTIBIOTICOS': ['UNICA'],
+        'ANTIINFLAMATORIOS O ANALGESICOS': ['UNICA'],
+        'ANTIPARASITARIOS': ['UNICA'],
+        'CARDIOLOGICOS': ['UNICA'],
+        'GASTROENTEROLOGICOS': ['UNICA'],
+        'OFTALMOLOGICOS': ['UNICA'],
+        'OTROS': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.INSUMOS_MEDICOS]: {
+        'AGUJAS': ['UNICA'],
+        'CATETERES': ['UNICA'],
+        'CURACION': ['UNICA'],
+        'INDUMENTARIA SANITARIA': ['UNICA'],
+        'INSUMOS PARA PRUEBAS': ['UNICA'],
+        'JERINGAS': ['UNICA'],
+        'OFTALMOLOGIA': ['UNICA'],
+        'OTROS': ['UNICA'],
+        'SONDAS': ['UNICA'],
+        'SUEROS Y SOLUCIONES': ['UNICA'],
+        'SUTURAS': ['UNICA'],
+        'TESTS': ['UNICA'],
+        'VACUNAS': ['UNICA'],
+        'VENDAS': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.OTROS_ARTICULOS]: {
+        'MICROCHIP': ['UNICA'],
+        'OTROS': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.OTROS_SERVICIOS]: {
+        'FCM': ['UNICA'],
+        'GUARDERIA': ['UNICA'],
+        'OTROS SERVICIOS': ['UNICA'],
+        'PAQUETES': ['UNICA'],
+        'PENSION': ['UNICA'],
+        'RENTA QUIROFANO': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.SERVICIOS_EXTERNOS]: {
+        'CONSULTAS EXTERNAS': ['UNICA'],
+        'INCINERACION': ['INCINERACION', 'SERVICIOS ADICIONALES', 'URNAS Y RELICARIOS'],
+        'LABORATORIO': [
+            'COPROPARASITOSCOPICO',
+            'CULTIVOS',
+            'CUSHING',
+            'HEMOGRAMA',
+            'HEMOPARASITOS',
+            'OTROS',
+            'PATOLOGIA CLINICA',
+            'PERFIL HORMONAL',
+            'PERFIL TIROIDEO',
+            'QUIMICA SANGUINEA',
+            'TOMOGRAFIA',
+        ],
+        'OTROS': ['UNICA'],
+        'PRUEBAS DE GABINETE': ['ELECTROCARDIOGRAMA', 'OTROS', 'RADIOLOGIA', 'ULTRASONIDO'],
+    },
+    [exports.QVET_SECTIONS.SERVICIOS_MEDICOS]: {
+        'ASISTENCIA QUIRURGICA': ['UNICA'],
+        'CERTIFICADOS DE SALUD': ['UNICA'],
+        'CIRUGIA DE TEJIDOS BLANDOS': ['ABDOMEN', 'CABEZA', 'NEOPLASIA', 'OTROS', 'PERINEO', 'TORAX'],
+        'CONSULTA': ['DOMICILIARIA', 'ESPECIALIDAD', 'GENERAL', 'REVISION'],
+        'DESPARASITACION': ['UNICA'],
+        'DIAGNOSTICO': ['UNICA'],
+        'EMERGENCIA': ['UNICA'],
+        'EUTANASIA': ['UNICA'],
+        'HOSPITALIZACION': ['UNICA'],
+        'OFTALMOLOGIA': ['UNICA'],
+        'ORTOPEDIA': ['UNICA'],
+        'OTROS': ['UNICA'],
+        'TRATAMIENTO': ['UNICA'],
+        'VACUNAS': ['UNICA'],
+    },
+    [exports.QVET_SECTIONS.SUMINISTROS_GENERALES]: {
+        'ALIMENTOS': ['UNICA'],
+        'ETIQUETAS': ['UNICA'],
+        'IMPRESOS': ['UNICA'],
+        'LIMPIEZA': ['UNICA'],
+        'OTROS': ['UNICA'],
+        'PAPELERIA': ['UNICA'],
+    },
+};
+// =============================================================================
+// DERIVED LISTS
+// =============================================================================
+/**
+ * All section values as array
+ */
+exports.QVET_SECTIONS_LIST = Object.values(exports.QVET_SECTIONS);

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/contracts/catalog-item/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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/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 });