hvp-shared 13.18.0 → 13.27.0

package/dist/constants/commission-reconciliation.constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Commission Reconciliation — categories & classification data (hvp-backend#434)
+ *
+ * Cross-references what QVET SOLD against what was COMMISSIONED, for 4 categories.
+ * Detection is by the SALE LINE's section/family (catalog_items is incomplete).
+ *
+ * @see resources/research/20260609-qvet-section-to-commission-mapping.md
+ */
+/** The 4 commissionable categories the reconciliation tracks. */
+export declare enum ReconciliationCategory {
+    consulta = "consulta",
+    vacuna = "vacuna",
+    cirugia = "cirugia",
+    emergencia = "emergencia"
+}
+export declare const RECONCILIATION_CATEGORY_LABELS: Record<ReconciliationCategory, string>;
+/** QVET section that holds clinical services. */
+export declare const SERVICIOS_MEDICOS_SECTION = "SERVICIOS MEDICOS";
+/** Surgical families within SERVICIOS MEDICOS (any of these → Cirugía). */
+export declare const SURGERY_FAMILIES: readonly string[];
+/**
+ * Maps a stored `commissionAllocations.services[].serviceName` to its category.
+ * Service names not listed here are outside the reconciliation scope.
+ */
+export declare const COMMISSION_SERVICE_TO_CATEGORY: Record<string, ReconciliationCategory>;

package/dist/constants/commission-reconciliation.constants.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Commission Reconciliation — categories & classification data (hvp-backend#434)
+ *
+ * Cross-references what QVET SOLD against what was COMMISSIONED, for 4 categories.
+ * Detection is by the SALE LINE's section/family (catalog_items is incomplete).
+ *
+ * @see resources/research/20260609-qvet-section-to-commission-mapping.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMISSION_SERVICE_TO_CATEGORY = exports.SURGERY_FAMILIES = exports.SERVICIOS_MEDICOS_SECTION = exports.RECONCILIATION_CATEGORY_LABELS = exports.ReconciliationCategory = void 0;
+// ─── Category ──────────────────────────────────────────────────────────────
+/** The 4 commissionable categories the reconciliation tracks. */
+var ReconciliationCategory;
+(function (ReconciliationCategory) {
+    ReconciliationCategory["consulta"] = "consulta";
+    ReconciliationCategory["vacuna"] = "vacuna";
+    ReconciliationCategory["cirugia"] = "cirugia";
+    ReconciliationCategory["emergencia"] = "emergencia";
+})(ReconciliationCategory || (exports.ReconciliationCategory = ReconciliationCategory = {}));
+exports.RECONCILIATION_CATEGORY_LABELS = {
+    [ReconciliationCategory.consulta]: "Consulta",
+    [ReconciliationCategory.vacuna]: "Vacuna",
+    [ReconciliationCategory.cirugia]: "Cirugía",
+    [ReconciliationCategory.emergencia]: "Emergencia",
+};
+// ─── QVET sale classification (by section/family of the sale line) ───────────
+/** QVET section that holds clinical services. */
+exports.SERVICIOS_MEDICOS_SECTION = "SERVICIOS MEDICOS";
+/** Surgical families within SERVICIOS MEDICOS (any of these → Cirugía). */
+exports.SURGERY_FAMILIES = [
+    "CIRUGIA DE TEJIDOS BLANDOS",
+    "ASISTENCIA QUIRURGICA",
+    "OFTALMOLOGIA",
+    "ORTOPEDIA",
+];
+// ─── Commission service → category ───────────────────────────────────────────
+/**
+ * Maps a stored `commissionAllocations.services[].serviceName` to its category.
+ * Service names not listed here are outside the reconciliation scope.
+ */
+exports.COMMISSION_SERVICE_TO_CATEGORY = {
+    // Consulta (cualquier tipo)
+    Consulta: ReconciliationCategory.consulta,
+    Revisión: ReconciliationCategory.consulta,
+    Especialista: ReconciliationCategory.consulta,
+    "Revisión especialista": ReconciliationCategory.consulta,
+    "Consulta no convencionales": ReconciliationCategory.consulta,
+    // Vacuna
+    Vacuna: ReconciliationCategory.vacuna,
+    // Cirugía (cualquier tipo, incluye roles quirúrgicos)
+    Cirugía: ReconciliationCategory.cirugia,
+    Anestesista: ReconciliationCategory.cirugia,
+    "Primer ayudante": ReconciliationCategory.cirugia,
+    // Emergencia
+    Emergencia: ReconciliationCategory.emergencia,
+};

package/dist/constants/google-calendar.constants.d.ts

@@ -166,6 +166,79 @@ export declare const SCHEDULER_WITH_DATE_REGEX: RegExp;
  * date.
  */
 export declare const SCHEDULER_DATE_FALLBACK_REGEX: RegExp;
+/**
+ * Version tag stored in `extendedProperties.private.descriptionFormat` on
+ * events created with the labeled format. Lets analytics / future migration
+ * scripts distinguish labeled from positional events.
+ */
+export declare const LABELED_DESCRIPTION_FORMAT_VERSION = "labeled-v1";
+/**
+ * Per-field spec for the labeled description format.
+ *
+ * Each field has:
+ * - `label`: canonical label written when building (e.g., "Tutor").
+ * - `regex`: extraction regex with capturing groups. Group 1 = value.
+ *   For `tutor`, group 2 captures the optional QVET id digits.
+ *
+ * Order-independent: labels anchor each field, so the format tolerates
+ * reordering or manual edits as long as the labels are present.
+ *
+ * Tolerates: `Tutor:`, `tutor :`, `TUTOR: `, trailing whitespace.
+ */
+export declare const LABELED_DESCRIPTION_FIELDS: {
+    readonly tutor: {
+        readonly label: "Tutor";
+        readonly regex: RegExp;
+    };
+    readonly phones: {
+        readonly label: "Teléfonos";
+        readonly regex: RegExp;
+    };
+    readonly pet: {
+        readonly label: "Mascota";
+        readonly regex: RegExp;
+    };
+    readonly breed: {
+        readonly label: "Raza";
+        readonly regex: RegExp;
+    };
+    readonly age: {
+        readonly label: "Edad";
+        readonly regex: RegExp;
+    };
+    readonly motivo: {
+        readonly label: "Motivo";
+        readonly regex: RegExp;
+    };
+    readonly discount: {
+        readonly label: "Descuento";
+        readonly regex: RegExp;
+    };
+};
+export type LabeledDescriptionField = keyof typeof LABELED_DESCRIPTION_FIELDS;
+/**
+ * Returns "labeled" if any known field label is present at the start of a line
+ * in the description; otherwise "positional" (legacy format).
+ */
+export declare function detectDescriptionFormat(description: string): "labeled" | "positional";
+/**
+ * Extract a single-line labeled field. Returns trimmed value or null.
+ *
+ * For `motivo` (which may span multiple lines), use {@link extractMotivoLabeled}.
+ * For the tutor's QVET id, use {@link extractTutorQvetIdLabeled}.
+ */
+export declare function extractLabeledField(description: string, field: Exclude<LabeledDescriptionField, "motivo">): string | null;
+/**
+ * Extract the QVET client id from the `Tutor: NAME (Q12345)` line. Returns the
+ * numeric portion as a string (e.g., "12345") or null.
+ */
+export declare function extractTutorQvetIdLabeled(description: string): string | null;
+/**
+ * Extract the motivo block which may span multiple lines. Starts at the
+ * `Motivo:` line and collects subsequent lines until another labeled field,
+ * an AGENDÓ/REAGENDÓ line, the HVP marker, or end of description.
+ */
+export declare function extractMotivoLabeled(description: string): string | null;
 /**
  * Captures pet age expressions in Spanish from descriptions.
  *
@@ -197,4 +270,11 @@ export declare const HVP_EVENT_PROP_KEYS: {
     readonly isPreferredVet: "isPreferredVet";
     readonly source: "source";
     readonly standardVersion: "standardVersion";
+    /**
+     * Marks the description-builder format version used at create/update time
+     * (e.g., "labeled-v1"). Informational only — the parser detects format from
+     * content, not from this prop. Useful for analytics ("% of events on labeled
+     * format") and future migration scripts.
+     */
+    readonly descriptionFormat: "descriptionFormat";
 };

package/dist/constants/google-calendar.constants.js

@@ -13,7 +13,11 @@
  * runs remain reproducible.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HVP_EVENT_PROP_KEYS = exports.KNOWN_BREEDS = exports.PET_AGE_REGEX = exports.SCHEDULER_DATE_FALLBACK_REGEX = exports.SCHEDULER_WITH_DATE_REGEX = exports.SCHEDULER_REGEX = exports.PHONE_REGEX = exports.QVET_ID_REGEX = exports.CANCELLED_TITLE_REGEX = exports.REMINDER_TITLE_REGEX = exports.PREFERRED_VET_REGEX = exports.EXCLUDED_TITLE_PREFIXES = exports.SERVICE_CODE_SYNONYMS = exports.CANONICAL_SERVICE_CODES = exports.EXCLUDED_COLOR_IDS = exports.NO_SHOW_COLOR_ID = exports.CANCELLED_COLOR_ID = exports.COLOR_ID_TO_BRANCH = exports.BRANCH_COLOR_IDS = exports.STANDARD_V1 = exports.STANDARD_V3 = exports.STANDARD_V2 = void 0;
+exports.HVP_EVENT_PROP_KEYS = exports.KNOWN_BREEDS = exports.PET_AGE_REGEX = exports.LABELED_DESCRIPTION_FIELDS = exports.LABELED_DESCRIPTION_FORMAT_VERSION = exports.SCHEDULER_DATE_FALLBACK_REGEX = exports.SCHEDULER_WITH_DATE_REGEX = exports.SCHEDULER_REGEX = exports.PHONE_REGEX = exports.QVET_ID_REGEX = exports.CANCELLED_TITLE_REGEX = exports.REMINDER_TITLE_REGEX = exports.PREFERRED_VET_REGEX = exports.EXCLUDED_TITLE_PREFIXES = exports.SERVICE_CODE_SYNONYMS = exports.CANONICAL_SERVICE_CODES = exports.EXCLUDED_COLOR_IDS = exports.NO_SHOW_COLOR_ID = exports.CANCELLED_COLOR_ID = exports.COLOR_ID_TO_BRANCH = exports.BRANCH_COLOR_IDS = exports.STANDARD_V1 = exports.STANDARD_V3 = exports.STANDARD_V2 = void 0;
+exports.detectDescriptionFormat = detectDescriptionFormat;
+exports.extractLabeledField = extractLabeledField;
+exports.extractTutorQvetIdLabeled = extractTutorQvetIdLabeled;
+exports.extractMotivoLabeled = extractMotivoLabeled;
 // ─── Standard v1 ─────────────────────────────────────────────────────────────
 /**
  * Multi-factor appointment standard v2.
@@ -147,31 +151,31 @@ exports.STANDARD_V3 = {
             id: "context",
             weight: 8,
             label: "Motivo / contexto",
-            description: 'La descripción tiene contexto clínico relevante (motivo de la visita, síntomas, antecedentes) más allá del nombre y teléfono. Mínimo 20 caracteres tras descontar nombre, teléfono y Q{id}.',
+            description: 'Eventos en formato labeled: cuenta el bloque "Motivo:" (>20 caracteres). Eventos legacy posicionales: la descripción tiene contexto clínico relevante más allá del nombre y teléfono — mínimo 20 caracteres tras descontar nombre, teléfono y Q{id}.',
         },
         {
             id: "owner_name",
             weight: 8,
             label: "Nombre del tutor",
-            description: 'Nombre del cliente/tutor. Auto-pasa si hay Q{id} en la descripción (cliente linkeado a QVET) o si el teléfono matchea un cliente QVET existente. Si no, busca nombre completo del tutor en la descripción (mínimo 2 palabras, mayúsculas/minúsculas con letras).',
+            description: 'Nombre del cliente/tutor. Auto-pasa si hay Q{id} en la descripción (cliente linkeado a QVET) o si el teléfono matchea un cliente QVET existente. Eventos labeled: lo lee de la línea "Tutor:". Eventos legacy: lo busca en la primera línea con 2+ palabras de letras (o el patrón "NAME | PETS | Q{id}").',
         },
         {
             id: "owner_phone",
             weight: 8,
             label: "Teléfono del tutor",
-            description: 'Teléfono del tutor en cualquier formato común (con o sin +52, con o sin separadores). Auto-pasa si hay Q{id} (sabemos el teléfono del registro QVET). Necesario para confirmar la cita y avisar de cambios.',
+            description: 'Teléfono del tutor en cualquier formato común (con o sin +52, con o sin separadores). Eventos labeled: lo lee de la línea "Teléfonos:". Eventos legacy: lo busca en cualquier línea de la descripción. Auto-pasa si hay Q{id} (sabemos el teléfono del registro QVET).',
         },
         {
             id: "pet_age",
             weight: 4,
             label: "Edad de la mascota",
-            description: 'Edad anotada en la descripción: "4 meses", "1 año y 4 meses", "8 semanas", "2 años". Importante para vacunación, dosis y diagnóstico.',
+            description: 'Edad anotada en la descripción. Eventos labeled: línea "Edad:". Eventos legacy: detección por patrón ("4 meses", "1 año y 4 meses", "8 semanas", "2 años"). Importante para vacunación, dosis y diagnóstico.',
         },
         {
             id: "pet_breed",
             weight: 4,
             label: "Raza de la mascota",
-            description: 'Raza detectada en la descripción contra un diccionario de razas comunes: Yorkie, Shih Tzu, Cocker Spaniel, French Bulldog, Chihuahua, Schnauzer, Golden Retriever, Labrador, Persa, Siamés, mestizo, etc. Útil para protocolos clínicos y dosificación.',
+            description: 'Raza detectada en la descripción. Eventos labeled: línea "Raza:". Eventos legacy: match contra un diccionario de razas comunes (Yorkie, Shih Tzu, Cocker Spaniel, French Bulldog, Chihuahua, Schnauzer, Golden Retriever, Labrador, Persa, Siamés, mestizo, etc.).',
         },
         {
             id: "discount_format",
@@ -433,6 +437,122 @@ exports.SCHEDULER_WITH_DATE_REGEX = /\b(?:AG[.:]?|AGE[.:]|AGEND[OÓ][.:]?|AGENG[
  * date.
  */
 exports.SCHEDULER_DATE_FALLBACK_REGEX = /\b(\d{1,2}[./\-]\d{1,2}(?:[./\-]\d{2,4})?|\d{1,2}[./\-](?:ENE|FEB|MAR|ABR|MAY|JUN|JUL|AGO|SEP|OCT|NOV|DIC|ENERO|FEBRERO|MARZO|ABRIL|MAYO|JUNIO|JULIO|AGOSTO|SEPTIEMBRE|OCTUBRE|NOVIEMBRE|DICIEMBRE)(?:[./\-]\d{2,4})?)\s+([A-Z]{2,4})\b/i;
+// ─── Labeled description format (06/2026) ───────────────────────────────────
+/**
+ * Version tag stored in `extendedProperties.private.descriptionFormat` on
+ * events created with the labeled format. Lets analytics / future migration
+ * scripts distinguish labeled from positional events.
+ */
+exports.LABELED_DESCRIPTION_FORMAT_VERSION = "labeled-v1";
+/**
+ * Per-field spec for the labeled description format.
+ *
+ * Each field has:
+ * - `label`: canonical label written when building (e.g., "Tutor").
+ * - `regex`: extraction regex with capturing groups. Group 1 = value.
+ *   For `tutor`, group 2 captures the optional QVET id digits.
+ *
+ * Order-independent: labels anchor each field, so the format tolerates
+ * reordering or manual edits as long as the labels are present.
+ *
+ * Tolerates: `Tutor:`, `tutor :`, `TUTOR: `, trailing whitespace.
+ */
+exports.LABELED_DESCRIPTION_FIELDS = {
+    tutor: {
+        label: "Tutor",
+        regex: /^\s*tutor\s*:\s*(.+?)(?:\s*\(\s*Q(\d{4,7})\s*\))?\s*$/im,
+    },
+    phones: {
+        label: "Teléfonos",
+        regex: /^\s*tel[eé]fonos?\s*:\s*(.+?)\s*$/im,
+    },
+    pet: {
+        label: "Mascota",
+        regex: /^\s*mascota\s*:\s*(.+?)\s*$/im,
+    },
+    breed: {
+        label: "Raza",
+        regex: /^\s*raza\s*:\s*(.+?)\s*$/im,
+    },
+    age: {
+        label: "Edad",
+        regex: /^\s*edad\s*:\s*(.+?)\s*$/im,
+    },
+    motivo: {
+        label: "Motivo",
+        // Motivo is multi-line; extraction handled by extractMotivoLabeled().
+        // Regex below only detects presence of the label.
+        regex: /^\s*motivo\s*:/im,
+    },
+    discount: {
+        label: "Descuento",
+        regex: /^\s*descuento\s*:\s*(.+?)\s*$/im,
+    },
+};
+/**
+ * Matches a line that starts a new labeled field or the AGENDÓ/REAGENDÓ block
+ * or the HVP marker. Used to bound multi-line `Motivo:` capture.
+ */
+const LABELED_BOUNDARY_REGEX = /^\s*(?:tutor|tel[eé]fonos?|mascota|raza|edad|descuento|motivo|agend|reagend|—)/i;
+/**
+ * Returns "labeled" if any known field label is present at the start of a line
+ * in the description; otherwise "positional" (legacy format).
+ */
+function detectDescriptionFormat(description) {
+    if (!description)
+        return "positional";
+    for (const field of Object.values(exports.LABELED_DESCRIPTION_FIELDS)) {
+        if (field.regex.test(description))
+            return "labeled";
+    }
+    return "positional";
+}
+/**
+ * Extract a single-line labeled field. Returns trimmed value or null.
+ *
+ * For `motivo` (which may span multiple lines), use {@link extractMotivoLabeled}.
+ * For the tutor's QVET id, use {@link extractTutorQvetIdLabeled}.
+ */
+function extractLabeledField(description, field) {
+    if (!description)
+        return null;
+    const match = description.match(exports.LABELED_DESCRIPTION_FIELDS[field].regex);
+    const value = match?.[1]?.trim();
+    return value && value.length > 0 ? value : null;
+}
+/**
+ * Extract the QVET client id from the `Tutor: NAME (Q12345)` line. Returns the
+ * numeric portion as a string (e.g., "12345") or null.
+ */
+function extractTutorQvetIdLabeled(description) {
+    if (!description)
+        return null;
+    const match = description.match(exports.LABELED_DESCRIPTION_FIELDS.tutor.regex);
+    const id = match?.[2]?.trim();
+    return id && id.length > 0 ? id : null;
+}
+/**
+ * Extract the motivo block which may span multiple lines. Starts at the
+ * `Motivo:` line and collects subsequent lines until another labeled field,
+ * an AGENDÓ/REAGENDÓ line, the HVP marker, or end of description.
+ */
+function extractMotivoLabeled(description) {
+    if (!description)
+        return null;
+    const lines = description.split("\n");
+    const startIdx = lines.findIndex((l) => /^\s*motivo\s*:/i.test(l));
+    if (startIdx === -1)
+        return null;
+    const firstLine = lines[startIdx].replace(/^\s*motivo\s*:\s*/i, "");
+    const collected = [firstLine];
+    for (let i = startIdx + 1; i < lines.length; i++) {
+        if (LABELED_BOUNDARY_REGEX.test(lines[i]))
+            break;
+        collected.push(lines[i]);
+    }
+    const value = collected.join("\n").trim();
+    return value.length > 0 ? value : null;
+}
 // ─── Pet age detection ───────────────────────────────────────────────────────
 /**
  * Captures pet age expressions in Spanish from descriptions.
@@ -541,4 +661,11 @@ exports.HVP_EVENT_PROP_KEYS = {
     isPreferredVet: "isPreferredVet",
     source: "source", // "hvp"
     standardVersion: "standardVersion",
+    /**
+     * Marks the description-builder format version used at create/update time
+     * (e.g., "labeled-v1"). Informational only — the parser detects format from
+     * content, not from this prop. Useful for analytics ("% of events on labeled
+     * format") and future migration scripts.
+     */
+    descriptionFormat: "descriptionFormat",
 };

package/dist/constants/google-calendar.constants.test.js

@@ -207,6 +207,157 @@ describe("PET_AGE_REGEX", () => {
         expect("Cytopoint 30MG".match(google_calendar_constants_1.PET_AGE_REGEX)).toBeNull();
     });
 });
+describe("Labeled description format (06/2026)", () => {
+    const labeledSample = [
+        "Tutor: OMAR GOMEZ (Q123456)",
+        "Teléfonos: 9992920692 / 9991234567",
+        "Mascota: MILO",
+        "Raza: Shih Tzu",
+        "Edad: 1 año",
+        "Motivo: Consulta de seguimiento por dermatitis",
+        "Descuento: 15% recordatorio",
+        "AGENDÓ JG 14/06/2026",
+        "— creada desde HVP app · [HVP]",
+    ].join("\n");
+    const positionalSample = [
+        "OMAR GOMEZ | MILO | Q123456",
+        "9992920692",
+        "Consulta de seguimiento por dermatitis",
+        "Shih Tzu, 1 año",
+        "15% recordatorio",
+        "AGENDÓ JG 14/06/2026",
+        "— creada desde HVP app · [HVP]",
+    ].join("\n");
+    describe("LABELED_DESCRIPTION_FORMAT_VERSION", () => {
+        it("is a stable string", () => {
+            expect(google_calendar_constants_1.LABELED_DESCRIPTION_FORMAT_VERSION).toBe("labeled-v1");
+        });
+    });
+    describe("LABELED_DESCRIPTION_FIELDS", () => {
+        it("has all expected fields with labels", () => {
+            const labels = Object.fromEntries(Object.entries(google_calendar_constants_1.LABELED_DESCRIPTION_FIELDS).map(([k, v]) => [k, v.label]));
+            expect(labels).toEqual({
+                tutor: "Tutor",
+                phones: "Teléfonos",
+                pet: "Mascota",
+                breed: "Raza",
+                age: "Edad",
+                motivo: "Motivo",
+                discount: "Descuento",
+            });
+        });
+    });
+    describe("detectDescriptionFormat", () => {
+        it("identifies a labeled description", () => {
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)(labeledSample)).toBe("labeled");
+        });
+        it("identifies a positional (legacy) description", () => {
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)(positionalSample)).toBe("positional");
+        });
+        it("treats empty / undefined as positional", () => {
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)("")).toBe("positional");
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)(undefined)).toBe("positional");
+        });
+        it("detects when only one label is present", () => {
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)("Tutor: NORA\n9999999999")).toBe("labeled");
+        });
+        it("is case-insensitive on the label", () => {
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)("tutor: NORA\n9999999999")).toBe("labeled");
+            expect((0, google_calendar_constants_1.detectDescriptionFormat)("TUTOR: NORA\n9999999999")).toBe("labeled");
+        });
+    });
+    describe("extractLabeledField", () => {
+        it("extracts the tutor name (without QVET id)", () => {
+            expect((0, google_calendar_constants_1.extractLabeledField)(labeledSample, "tutor")).toBe("OMAR GOMEZ");
+        });
+        it("extracts the tutor name when no QVET id is present", () => {
+            const desc = "Tutor: NORA DIRCIO\nMascota: KIRI";
+            expect((0, google_calendar_constants_1.extractLabeledField)(desc, "tutor")).toBe("NORA DIRCIO");
+        });
+        it("extracts phones, pet, breed, age, discount", () => {
+            expect((0, google_calendar_constants_1.extractLabeledField)(labeledSample, "phones")).toBe("9992920692 / 9991234567");
+            expect((0, google_calendar_constants_1.extractLabeledField)(labeledSample, "pet")).toBe("MILO");
+            expect((0, google_calendar_constants_1.extractLabeledField)(labeledSample, "breed")).toBe("Shih Tzu");
+            expect((0, google_calendar_constants_1.extractLabeledField)(labeledSample, "age")).toBe("1 año");
+            expect((0, google_calendar_constants_1.extractLabeledField)(labeledSample, "discount")).toBe("15% recordatorio");
+        });
+        it("returns null when the label is missing", () => {
+            const desc = "Tutor: OMAR\nMascota: MILO";
+            expect((0, google_calendar_constants_1.extractLabeledField)(desc, "discount")).toBeNull();
+            expect((0, google_calendar_constants_1.extractLabeledField)(desc, "breed")).toBeNull();
+        });
+        it("tolerates trailing whitespace and extra spaces around the colon", () => {
+            const desc = "Tutor :  OMAR GOMEZ   \nMascota:MILO";
+            expect((0, google_calendar_constants_1.extractLabeledField)(desc, "tutor")).toBe("OMAR GOMEZ");
+            expect((0, google_calendar_constants_1.extractLabeledField)(desc, "pet")).toBe("MILO");
+        });
+        it("is order-independent", () => {
+            const reordered = [
+                "Mascota: MILO",
+                "Tutor: OMAR GOMEZ (Q123456)",
+                "Edad: 1 año",
+            ].join("\n");
+            expect((0, google_calendar_constants_1.extractLabeledField)(reordered, "tutor")).toBe("OMAR GOMEZ");
+            expect((0, google_calendar_constants_1.extractLabeledField)(reordered, "pet")).toBe("MILO");
+            expect((0, google_calendar_constants_1.extractLabeledField)(reordered, "age")).toBe("1 año");
+        });
+        it("returns null for empty description", () => {
+            expect((0, google_calendar_constants_1.extractLabeledField)("", "tutor")).toBeNull();
+        });
+    });
+    describe("extractTutorQvetIdLabeled", () => {
+        it("extracts the QVET id from the tutor line", () => {
+            expect((0, google_calendar_constants_1.extractTutorQvetIdLabeled)(labeledSample)).toBe("123456");
+        });
+        it("returns null when no QVET id is present", () => {
+            const desc = "Tutor: NORA DIRCIO\nMascota: KIRI";
+            expect((0, google_calendar_constants_1.extractTutorQvetIdLabeled)(desc)).toBeNull();
+        });
+        it("tolerates extra whitespace inside the parens", () => {
+            const desc = "Tutor: NORA DIRCIO ( Q987654 )";
+            expect((0, google_calendar_constants_1.extractTutorQvetIdLabeled)(desc)).toBe("987654");
+        });
+        it("returns null when the tutor line is missing entirely", () => {
+            expect((0, google_calendar_constants_1.extractTutorQvetIdLabeled)("Mascota: KIRI")).toBeNull();
+        });
+    });
+    describe("extractMotivoLabeled", () => {
+        it("extracts a single-line motivo", () => {
+            expect((0, google_calendar_constants_1.extractMotivoLabeled)(labeledSample)).toBe("Consulta de seguimiento por dermatitis");
+        });
+        it("extracts a multi-line motivo", () => {
+            const desc = [
+                "Tutor: OMAR",
+                "Mascota: MILO",
+                "Motivo: Consulta inicial",
+                "Antecedentes de alergia",
+                "Sospecha de sarna",
+                "AGENDÓ JG 14/06/2026",
+            ].join("\n");
+            expect((0, google_calendar_constants_1.extractMotivoLabeled)(desc)).toBe("Consulta inicial\nAntecedentes de alergia\nSospecha de sarna");
+        });
+        it("stops at the next labeled field even when AGENDÓ is far below", () => {
+            const desc = [
+                "Tutor: OMAR",
+                "Motivo: Solo este motivo",
+                "Mascota: MILO",
+                "Raza: Shih Tzu",
+                "AGENDÓ JG 14/06/2026",
+            ].join("\n");
+            expect((0, google_calendar_constants_1.extractMotivoLabeled)(desc)).toBe("Solo este motivo");
+        });
+        it("stops at the HVP marker", () => {
+            const desc = [
+                "Motivo: Consulta",
+                "— creada desde HVP app · [HVP]",
+            ].join("\n");
+            expect((0, google_calendar_constants_1.extractMotivoLabeled)(desc)).toBe("Consulta");
+        });
+        it("returns null when no motivo label is present", () => {
+            expect((0, google_calendar_constants_1.extractMotivoLabeled)("Tutor: OMAR\nMascota: MILO")).toBeNull();
+        });
+    });
+});
 describe("KNOWN_BREEDS", () => {
     it("includes common breeds observed in the discovery data", () => {
         const lower = google_calendar_constants_1.KNOWN_BREEDS.map((b) => b.toLowerCase());

package/dist/constants/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './mexican-states';
 export * from './sat-catalogs';
+export * from './commission-reconciliation.constants';
 export * from './collaborator.constants';
 export * from './catalog-item.constants';
 export * from './pricing.constants';

package/dist/constants/index.js

@@ -19,6 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 __exportStar(require("./mexican-states"), exports);
 __exportStar(require("./sat-catalogs"), exports);
+__exportStar(require("./commission-reconciliation.constants"), exports);
 __exportStar(require("./collaborator.constants"), exports);
 __exportStar(require("./catalog-item.constants"), exports);
 __exportStar(require("./pricing.constants"), exports);

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

@@ -119,4 +119,4 @@ export declare const QVET_CATALOG: {
 /**
  * All section values as array
  */
-export declare const QVET_SECTIONS_LIST: ("CONSUMO INTERNO" | "EQUIPAMIENTO" | "FARMACIA" | "FARMACIA INTERNA" | "INSUMOS ESCANDALLO" | "INSUMOS MEDICOS" | "OTROS ARTICULOS" | "OTROS SERVICIOS" | "SERVICIOS EXTERNOS" | "SERVICIOS MEDICOS")[];
+export declare const QVET_SECTIONS_LIST: ("SERVICIOS MEDICOS" | "CONSUMO INTERNO" | "EQUIPAMIENTO" | "FARMACIA" | "FARMACIA INTERNA" | "INSUMOS ESCANDALLO" | "INSUMOS MEDICOS" | "OTROS ARTICULOS" | "OTROS SERVICIOS" | "SERVICIOS EXTERNOS")[];

package/dist/contracts/commission-reconciliation/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commission Reconciliation API Contracts (hvp-backend#434)
+ */
+export * from './responses';

package/dist/contracts/commission-reconciliation/index.js

@@ -0,0 +1,20 @@
+"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 });
+/**
+ * Commission Reconciliation API Contracts (hvp-backend#434)
+ */
+__exportStar(require("./responses"), exports);

package/dist/contracts/commission-reconciliation/responses.d.ts

@@ -0,0 +1,148 @@
+import { ReconciliationCategory } from '../../constants/commission-reconciliation.constants';
+/**
+ * Commission Reconciliation API Contracts (hvp-backend#434)
+ *
+ * GET /api/commission-reconciliation/summary?startDate=&endDate=&branchId=
+ * Cross-references commissioned vs sold (QVET) by invoice folio, jul-2025+.
+ */
+/**
+ * High-level match quality of a commission (3 states, for review):
+ * - `perfecto`: has ticket + category sold + seller IS the commissioner
+ * - `parcial`: has ticket + category sold, but seller ≠ commissioner (someone else rang up the sale)
+ * - `sin_match`: no corresponding sale (no factura, or the commissioned category wasn't sold)
+ */
+export type ReconciliationMatchLevel = 'perfecto' | 'parcial' | 'sin_match';
+/**
+ * Per-commission-service validation within a ticket. Each commissioned service is matched
+ * to its EXACT sale line by qvetCode (2026+, where qvetCode is populated), falling back to
+ * the section/family category when the code isn't available. Then the service's principal
+ * commissioner is compared to the seller of that line.
+ */
+export interface ReconciliationServiceCheck {
+    /** The CommissionableService name (e.g. "Consulta", "Cirugía"). */
+    serviceName: string;
+    /** Principal commissioner of this service (its SIMPLE / highest-amount earner). */
+    principalCode: string | null;
+    /** How the sale line was matched: exact product (qvetCode), coarse (category), or not found. */
+    matchType: 'qvetCode' | 'category' | 'none';
+    /** Exact product matched on the factura (qvetCode match only). */
+    productName: string | null;
+    qvetCode: number | null;
+    /** Seller of the matched sale line. Null when not found. */
+    sellerCode: string | null;
+    /** principal == line seller (the per-commission verdict). */
+    ok: boolean;
+}
+/** Status of a commissioned ticket against QVET sales. */
+export type ReconciliationTicketStatus = 'ok' | 'folio_corregido' | 'sin_venta' | 'categoria_no_vendida';
+/** One commissioned ticket (factura) with its reconciliation against sales. */
+export interface ReconciliationTicketRow {
+    /** Raw folio as entered in the commission (commissionAllocations.ticketNumber). */
+    ticketNumber: string;
+    /** Normalized folio used for the cross-reference. */
+    normalizedFolio: string;
+    /** Commission date (ISO). */
+    date: string;
+    /** Branch name (Urban/Harbor/Montejo) or id when unresolved. */
+    branch: string;
+    /** Raw commission service names on the ticket (e.g. "Consulta", "Hemograma"). */
+    commissionedServices: string[];
+    /** Tracked categories present in the commission (subset of the 4; may be empty). */
+    commissionedCategories: ReconciliationCategory[];
+    /** Categories sold on the matched factura (empty when no sale matched). */
+    soldCategories: ReconciliationCategory[];
+    /** Whether the folio matched a QVET sale (exact or auto-corrected). */
+    saleFound: boolean;
+    /**
+     * Nearest factura folio when the raw folio didn't match exactly.
+     * For `folio_corregido` it's the auto-linked folio; for `sin_venta` it's a suggestion to review.
+     */
+    suggestedFolio: string | null;
+    /** Commissioned categories that were NOT sold (the discrepancy). */
+    missingCategories: ReconciliationCategory[];
+    status: ReconciliationTicketStatus;
+    /** Commissioner codes (col_code) on the commission. */
+    collaboratorCodes: string[];
+    /** Principal commissioner (highest commission amount — the SIMPLE/main vet). Should equal the seller. */
+    principalCode: string | null;
+    /** 3-state quality of the match (see ReconciliationMatchLevel). */
+    matchLevel: ReconciliationMatchLevel;
+    /** Per-commission-service checks (exact product/qvetCode validation). */
+    serviceChecks: ReconciliationServiceCheck[];
+    /** Who created the commission (col_code), or null if unknown. */
+    createdByCode: string | null;
+    /** Resolved seller of the matched factura (null when no sale / unresolved). */
+    sellerCode: string | null;
+    /** Resolved collector (cobrador) of the matched factura's payment (null when none). */
+    collectorCode: string | null;
+    /** Whether the resolved seller equals the PRINCIPAL commissioner (null when unknown). */
+    sellerMatchesCommission: boolean | null;
+    /** Total commission amount on the ticket (rounded). */
+    commissionAmount: number;
+    /** Heuristic flag: folio looks mistyped (not `[UHM]\d{4,6}`). */
+    suspectFolio: boolean;
+}
+/** A factura that sold a category but has no commission for it (reverse/secondary gap). */
+export interface ReconciliationGapRow {
+    invoiceNumber: string;
+    date: string;
+    branch: string;
+    /** Sold categories that were not commissioned. */
+    missingCategories: ReconciliationCategory[];
+    /** Resolved seller of the factura (null when unresolved). */
+    sellerCode: string | null;
+}
+/** Per-collaborator aggregate of sold (as seller) vs commissioned, by category. */
+export interface ReconciliationPersonCategoryStat {
+    category: ReconciliationCategory;
+    soldAsSeller: number;
+    commissioned: number;
+}
+export interface ReconciliationPersonRow {
+    collaboratorCode: string;
+    stats: ReconciliationPersonCategoryStat[];
+}
+/**
+ * Per-person registration quality (matched tickets only). Used from two perspectives:
+ * - seller: tickets where this person is the recorded VENDEDOR.
+ * - collector: tickets where this person is the COBRADOR.
+ * `perfecto` = ticket where vendedor == comisionista principal; `parcial` = it doesn't.
+ * High `parcial` from the collector view = "quién está registrando mal el vendedor al cobrar".
+ */
+export interface ReconciliationStaffQualityRow {
+    code: string;
+    total: number;
+    perfecto: number;
+    parcial: number;
+}
+export interface ReconciliationTotals {
+    /** Commissions in scope (with at least one tracked category). */
+    commissions: number;
+    /** Commissioned but not sold (sin_venta + categoria_no_vendida). */
+    commissionedNotSold: number;
+    /** Auto-linked via folio correction (unambiguous near match). */
+    folioCorrected: number;
+    /** Of commissionedNotSold, how many have a suspect/mistyped folio. */
+    suspectFolios: number;
+    /** Facturas that sold a category without a matching commission (secondary gap). */
+    soldNotCommissioned: number;
+}
+export interface ReconciliationSummaryResponse {
+    period: {
+        startDate: string;
+        endDate: string;
+    };
+    totals: ReconciliationTotals;
+    /** PRIMARY view: commissioned tickets with a problem (status !== 'ok'). */
+    commissionedNotSold: ReconciliationTicketRow[];
+    /** Full list of commissioned tickets in the period with their status. */
+    tickets: ReconciliationTicketRow[];
+    /** SECONDARY view: sold-but-not-commissioned facturas. */
+    soldNotCommissioned: ReconciliationGapRow[];
+    /** Per-person sold-vs-commissioned aggregates. */
+    byPerson: ReconciliationPersonRow[];
+    /** Quality from the VENDEDOR perspective (to whom the sale was wrongly assigned). */
+    sellerQuality: ReconciliationStaffQualityRow[];
+    /** Quality from the COBRADOR perspective (who assigned it wrongly when collecting). */
+    collectorQuality: ReconciliationStaffQualityRow[];
+}

package/dist/contracts/commission-reconciliation/responses.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/google-calendar/requests.d.ts

@@ -85,4 +85,16 @@ export interface CreateAppointmentRequest {
      * collaborators list. If omitted, the auth user's col_code is used.
      */
     schedulerColCode?: string;
+    /**
+     * Optional manual override for the description body. When present, the
+     * backend uses this verbatim instead of building the description from the
+     * structured fields above. The backend still appends the AGENDÓ/REAGENDÓ
+     * scheduler line and the HVP marker so attribution and provenance are not
+     * lost.
+     *
+     * Used when the receptionist enables "Editar texto" in the form to fine-tune
+     * wording before saving. On PATCH, supplying this also short-circuits the
+     * labeled rebuild — useful for surgical edits.
+     */
+    descriptionOverride?: string;
 }

package/dist/contracts/index.d.ts

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

package/dist/contracts/index.js

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

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * from './utils/sync-field.helpers';
 export * from './utils/qvet-catalog.helpers';
 export * from './utils/qvet-staff.helpers';
 export * from './utils/enum.helpers';
+export * from './utils/commission-reconciliation.helpers';

package/dist/index.js

@@ -29,3 +29,4 @@ __exportStar(require("./utils/sync-field.helpers"), exports);
 __exportStar(require("./utils/qvet-catalog.helpers"), exports);
 __exportStar(require("./utils/qvet-staff.helpers"), exports);
 __exportStar(require("./utils/enum.helpers"), exports);
+__exportStar(require("./utils/commission-reconciliation.helpers"), exports);

package/dist/utils/commission-reconciliation.helpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Commission Reconciliation — pure classification & key helpers (hvp-backend#434)
+ */
+import { ReconciliationCategory } from "../constants/commission-reconciliation.constants";
+/**
+ * Normalize an invoice/folio for cross-referencing commission ↔ sale.
+ * Strips spaces, slashes and any non-alphanumeric, uppercases.
+ *
+ * @example
+ * normalizeInvoiceNumber(" H/05355") // "H05355"
+ * normalizeInvoiceNumber("H05346")   // "H05346"
+ */
+export declare function normalizeInvoiceNumber(value: string | null | undefined): string;
+/**
+ * Classify a QVET sale line into a reconciliation category by its section/family.
+ * Returns null when the line is outside the 4 tracked categories.
+ *
+ * @example
+ * classifySaleLine("SERVICIOS MEDICOS", "CONSULTA") // ReconciliationCategory.consulta
+ * classifySaleLine("INSUMOS ESCANDALLO", "VACUNAS") // ReconciliationCategory.vacuna
+ */
+export declare function classifySaleLine(section: string | null | undefined, family: string | null | undefined): ReconciliationCategory | null;
+/**
+ * Classify a commission service name into a reconciliation category.
+ * Returns null when the service is outside the 4 tracked categories.
+ */
+export declare function classifyCommissionService(serviceName: string | null | undefined): ReconciliationCategory | null;

package/dist/utils/commission-reconciliation.helpers.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeInvoiceNumber = normalizeInvoiceNumber;
+exports.classifySaleLine = classifySaleLine;
+exports.classifyCommissionService = classifyCommissionService;
+/**
+ * Commission Reconciliation — pure classification & key helpers (hvp-backend#434)
+ */
+const commission_reconciliation_constants_1 = require("../constants/commission-reconciliation.constants");
+/**
+ * Normalize an invoice/folio for cross-referencing commission ↔ sale.
+ * Strips spaces, slashes and any non-alphanumeric, uppercases.
+ *
+ * @example
+ * normalizeInvoiceNumber(" H/05355") // "H05355"
+ * normalizeInvoiceNumber("H05346")   // "H05346"
+ */
+function normalizeInvoiceNumber(value) {
+    return String(value ?? "")
+        .replace(/[^A-Za-z0-9]/g, "")
+        .toUpperCase();
+}
+/**
+ * Classify a QVET sale line into a reconciliation category by its section/family.
+ * Returns null when the line is outside the 4 tracked categories.
+ *
+ * @example
+ * classifySaleLine("SERVICIOS MEDICOS", "CONSULTA") // ReconciliationCategory.consulta
+ * classifySaleLine("INSUMOS ESCANDALLO", "VACUNAS") // ReconciliationCategory.vacuna
+ */
+function classifySaleLine(section, family) {
+    const s = String(section ?? "").toUpperCase();
+    const f = String(family ?? "").toUpperCase();
+    if (f === "VACUNAS")
+        return commission_reconciliation_constants_1.ReconciliationCategory.vacuna;
+    if (s === commission_reconciliation_constants_1.SERVICIOS_MEDICOS_SECTION) {
+        if (f === "CONSULTA")
+            return commission_reconciliation_constants_1.ReconciliationCategory.consulta;
+        if (f === "EMERGENCIA")
+            return commission_reconciliation_constants_1.ReconciliationCategory.emergencia;
+        if (commission_reconciliation_constants_1.SURGERY_FAMILIES.includes(f))
+            return commission_reconciliation_constants_1.ReconciliationCategory.cirugia;
+    }
+    return null;
+}
+/**
+ * Classify a commission service name into a reconciliation category.
+ * Returns null when the service is outside the 4 tracked categories.
+ */
+function classifyCommissionService(serviceName) {
+    if (!serviceName)
+        return null;
+    return commission_reconciliation_constants_1.COMMISSION_SERVICE_TO_CATEGORY[serviceName] ?? null;
+}

package/dist/utils/commission-reconciliation.helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/commission-reconciliation.helpers.test.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commission_reconciliation_helpers_1 = require("./commission-reconciliation.helpers");
+const commission_reconciliation_constants_1 = require("../constants/commission-reconciliation.constants");
+describe('normalizeInvoiceNumber', () => {
+    it('strips spaces and slashes, uppercases', () => {
+        expect((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)(' H/05355')).toBe('H05355');
+        expect((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)('H05346')).toBe('H05346');
+        expect((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)(' h05355')).toBe('H05355');
+    });
+    it('matches the sale-factura form to the commission-folio form', () => {
+        expect((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)(' H/05355')).toBe((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)('H05355'));
+    });
+    it('handles null/undefined', () => {
+        expect((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)(null)).toBe('');
+        expect((0, commission_reconciliation_helpers_1.normalizeInvoiceNumber)(undefined)).toBe('');
+    });
+});
+describe('classifySaleLine', () => {
+    it('classifies consulta / emergencia by SERVICIOS MEDICOS section', () => {
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('SERVICIOS MEDICOS', 'CONSULTA')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.consulta);
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('SERVICIOS MEDICOS', 'EMERGENCIA')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.emergencia);
+    });
+    it('classifies vacuna by VACUNAS family in any section', () => {
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('SERVICIOS MEDICOS', 'VACUNAS')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.vacuna);
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('INSUMOS ESCANDALLO', 'VACUNAS')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.vacuna);
+    });
+    it('classifies all surgical families as cirugia (within SERVICIOS MEDICOS)', () => {
+        for (const fam of ['CIRUGIA DE TEJIDOS BLANDOS', 'ASISTENCIA QUIRURGICA', 'OFTALMOLOGIA', 'ORTOPEDIA']) {
+            expect((0, commission_reconciliation_helpers_1.classifySaleLine)('SERVICIOS MEDICOS', fam)).toBe(commission_reconciliation_constants_1.ReconciliationCategory.cirugia);
+        }
+    });
+    it('does NOT classify surgical-named families outside SERVICIOS MEDICOS (e.g. insumos oftalmología)', () => {
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('INSUMOS MEDICOS', 'OFTALMOLOGIA')).toBeNull();
+    });
+    it('returns null for out-of-scope sections (farmacia, insumos, lab)', () => {
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('FARMACIA', 'ANTIPARASITARIOS')).toBeNull();
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('SERVICIOS EXTERNOS', 'LABORATORIO')).toBeNull();
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)(null, null)).toBeNull();
+    });
+    it('is case-insensitive', () => {
+        expect((0, commission_reconciliation_helpers_1.classifySaleLine)('servicios medicos', 'consulta')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.consulta);
+    });
+});
+describe('classifyCommissionService', () => {
+    it('maps consulta-type services to consulta', () => {
+        for (const s of ['Consulta', 'Revisión', 'Especialista', 'Revisión especialista', 'Consulta no convencionales']) {
+            expect((0, commission_reconciliation_helpers_1.classifyCommissionService)(s)).toBe(commission_reconciliation_constants_1.ReconciliationCategory.consulta);
+        }
+    });
+    it('maps surgical roles to cirugia', () => {
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Cirugía')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.cirugia);
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Anestesista')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.cirugia);
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Primer ayudante')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.cirugia);
+    });
+    it('maps Vacuna and Emergencia', () => {
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Vacuna')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.vacuna);
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Emergencia')).toBe(commission_reconciliation_constants_1.ReconciliationCategory.emergencia);
+    });
+    it('returns null for out-of-scope services', () => {
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Hemograma')).toBeNull();
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)('Corte de uñas')).toBeNull();
+        expect((0, commission_reconciliation_helpers_1.classifyCommissionService)(null)).toBeNull();
+    });
+});

package/package.json

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