hvp-shared 13.26.0 → 13.35.0

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

@@ -24,6 +24,7 @@ export * from './force-majeure.enums';
 export * from './hris.constants';
 export * from './payroll-features.constants';
 export * from './inventory-session.enums';
+export * from './shift-checklist.enums';
 export * from './documentation.enums';
 export * from './document.enums';
 export * from './settlement.enums';

package/dist/constants/index.js

@@ -40,6 +40,7 @@ __exportStar(require("./force-majeure.enums"), exports);
 __exportStar(require("./hris.constants"), exports);
 __exportStar(require("./payroll-features.constants"), exports);
 __exportStar(require("./inventory-session.enums"), exports);
+__exportStar(require("./shift-checklist.enums"), exports);
 __exportStar(require("./documentation.enums"), exports);
 __exportStar(require("./document.enums"), exports);
 __exportStar(require("./settlement.enums"), exports);

package/dist/constants/shift-checklist.enums.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shift Checklist Enums
+ *
+ * Enums for the shift checklist module: a per-occasion ("run") list of recurring
+ * tasks a collaborator reviews at check-in and before checkout. A master
+ * `ChecklistActivity` defines the recurring task; a `ChecklistRun` is one
+ * occasion (collaborator + moment + day); a `ChecklistCompletion` records a task
+ * done/not-done within a run.
+ */
+/**
+ * When an activity applies (shown as a tag in the day checklist).
+ *
+ * - `check_in`  (Entrada): start-of-shift tasks
+ * - `check_out` (Salida): end-of-shift tasks
+ * - `both`      (Ambos): relevant at both entrada and salida
+ * - `any`       (Indistinto): do it once, doesn't matter entrada or salida
+ *
+ * `both` / `any` are valid ONLY on an activity definition. A run/completion
+ * occasion is always `check_in` OR `check_out`.
+ */
+export declare enum ChecklistMoment {
+    check_in = "check_in",
+    check_out = "check_out",
+    both = "both",
+    any = "any"
+}
+export declare const CHECKLIST_MOMENT_LABELS: Record<ChecklistMoment, string>;
+/** Moments valid for a run/completion occasion (never `both` / `any`). */
+export declare const RUN_MOMENTS: Set<ChecklistMoment>;
+/**
+ * Status of a task within a run (three conscious actions; "unmarked" = no action).
+ *
+ * - `done`     (Hecho): the task was performed.
+ * - `skipped`  (No hacía falta): evaluated and deemed unnecessary (e.g. the
+ *              sanitary dispensers were already full). Carries a reason.
+ * - `not_done` (No se pudo): consciously not done because it couldn't be (e.g.
+ *              missing material, no time). Carries a reason.
+ */
+export declare enum ChecklistCompletionStatus {
+    done = "done",
+    not_done = "not_done",
+    skipped = "skipped"
+}
+export declare const CHECKLIST_COMPLETION_STATUS_LABELS: Record<ChecklistCompletionStatus, string>;
+/** Tooltip help text per status (for the UI controls). */
+export declare const CHECKLIST_COMPLETION_STATUS_HELP: Record<ChecklistCompletionStatus, string>;
+/** Statuses that reset the overdue clock (i.e. count as "the task was done"). */
+export declare const SATISFYING_COMPLETION_STATUSES: Set<ChecklistCompletionStatus>;
+/**
+ * How an activity's doneness is scoped across branches.
+ *
+ * - `specific` (Sucursales específicas): applies to the listed `branchIds`;
+ *   done/overdue tracked PER branch.
+ * - `each`     (Todas — cada una): applies to every branch; each branch does
+ *   its own; done/overdue tracked PER branch (e.g. "Barrer recepción").
+ * - `any`      (Cualquier sucursal): done ONCE for the whole org regardless of
+ *   branch; done/overdue tracked GLOBALLY (e.g. "Enviar recordatorios de vacuna").
+ */
+export declare enum ChecklistBranchMode {
+    specific = "specific",
+    each = "each",
+    any = "any"
+}
+export declare const CHECKLIST_BRANCH_MODE_LABELS: Record<ChecklistBranchMode, string>;
+/** Branch modes whose doneness is tracked per-branch (not global). */
+export declare const PER_BRANCH_MODES: Set<ChecklistBranchMode>;
+export declare enum ChecklistPriority {
+    high = "high",
+    medium = "medium",
+    low = "low"
+}
+export declare const CHECKLIST_PRIORITY_LABELS: Record<ChecklistPriority, string>;
+/**
+ * Lifecycle of a per-occasion checklist run.
+ *
+ * - `open`: created, collaborator filling it
+ * - `submitted`: collaborator confirmed/submitted the run
+ */
+export declare enum ChecklistRunStatus {
+    open = "open",
+    submitted = "submitted"
+}
+export declare const CHECKLIST_RUN_STATUS_LABELS: Record<ChecklistRunStatus, string>;

package/dist/constants/shift-checklist.enums.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Shift Checklist Enums
+ *
+ * Enums for the shift checklist module: a per-occasion ("run") list of recurring
+ * tasks a collaborator reviews at check-in and before checkout. A master
+ * `ChecklistActivity` defines the recurring task; a `ChecklistRun` is one
+ * occasion (collaborator + moment + day); a `ChecklistCompletion` records a task
+ * done/not-done within a run.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHECKLIST_RUN_STATUS_LABELS = exports.ChecklistRunStatus = exports.CHECKLIST_PRIORITY_LABELS = exports.ChecklistPriority = exports.PER_BRANCH_MODES = exports.CHECKLIST_BRANCH_MODE_LABELS = exports.ChecklistBranchMode = exports.SATISFYING_COMPLETION_STATUSES = exports.CHECKLIST_COMPLETION_STATUS_HELP = exports.CHECKLIST_COMPLETION_STATUS_LABELS = exports.ChecklistCompletionStatus = exports.RUN_MOMENTS = exports.CHECKLIST_MOMENT_LABELS = exports.ChecklistMoment = void 0;
+// --- Moment of shift ---
+/**
+ * When an activity applies (shown as a tag in the day checklist).
+ *
+ * - `check_in`  (Entrada): start-of-shift tasks
+ * - `check_out` (Salida): end-of-shift tasks
+ * - `both`      (Ambos): relevant at both entrada and salida
+ * - `any`       (Indistinto): do it once, doesn't matter entrada or salida
+ *
+ * `both` / `any` are valid ONLY on an activity definition. A run/completion
+ * occasion is always `check_in` OR `check_out`.
+ */
+var ChecklistMoment;
+(function (ChecklistMoment) {
+    ChecklistMoment["check_in"] = "check_in";
+    ChecklistMoment["check_out"] = "check_out";
+    ChecklistMoment["both"] = "both";
+    ChecklistMoment["any"] = "any";
+})(ChecklistMoment || (exports.ChecklistMoment = ChecklistMoment = {}));
+exports.CHECKLIST_MOMENT_LABELS = {
+    [ChecklistMoment.check_in]: "Entrada",
+    [ChecklistMoment.check_out]: "Salida",
+    [ChecklistMoment.both]: "Ambos",
+    [ChecklistMoment.any]: "Indistinto",
+};
+/** Moments valid for a run/completion occasion (never `both` / `any`). */
+exports.RUN_MOMENTS = new Set([
+    ChecklistMoment.check_in,
+    ChecklistMoment.check_out,
+]);
+// --- Completion status ---
+/**
+ * Status of a task within a run (three conscious actions; "unmarked" = no action).
+ *
+ * - `done`     (Hecho): the task was performed.
+ * - `skipped`  (No hacía falta): evaluated and deemed unnecessary (e.g. the
+ *              sanitary dispensers were already full). Carries a reason.
+ * - `not_done` (No se pudo): consciously not done because it couldn't be (e.g.
+ *              missing material, no time). Carries a reason.
+ */
+var ChecklistCompletionStatus;
+(function (ChecklistCompletionStatus) {
+    ChecklistCompletionStatus["done"] = "done";
+    ChecklistCompletionStatus["not_done"] = "not_done";
+    ChecklistCompletionStatus["skipped"] = "skipped";
+})(ChecklistCompletionStatus || (exports.ChecklistCompletionStatus = ChecklistCompletionStatus = {}));
+exports.CHECKLIST_COMPLETION_STATUS_LABELS = {
+    [ChecklistCompletionStatus.done]: "Hecho",
+    [ChecklistCompletionStatus.skipped]: "No hacía falta",
+    [ChecklistCompletionStatus.not_done]: "No se pudo",
+};
+/** Tooltip help text per status (for the UI controls). */
+exports.CHECKLIST_COMPLETION_STATUS_HELP = {
+    [ChecklistCompletionStatus.done]: "Se realizó.",
+    [ChecklistCompletionStatus.skipped]: "Se evaluó y no era necesario hacerla (ej. las sanitas ya estaban llenas).",
+    [ChecklistCompletionStatus.not_done]: "Conscientemente no se hizo porque no se pudo (ej. faltó material, no dio tiempo).",
+};
+/** Statuses that reset the overdue clock (i.e. count as "the task was done"). */
+exports.SATISFYING_COMPLETION_STATUSES = new Set([
+    ChecklistCompletionStatus.done,
+]);
+// --- Branch mode (how an activity relates to branches) ---
+/**
+ * How an activity's doneness is scoped across branches.
+ *
+ * - `specific` (Sucursales específicas): applies to the listed `branchIds`;
+ *   done/overdue tracked PER branch.
+ * - `each`     (Todas — cada una): applies to every branch; each branch does
+ *   its own; done/overdue tracked PER branch (e.g. "Barrer recepción").
+ * - `any`      (Cualquier sucursal): done ONCE for the whole org regardless of
+ *   branch; done/overdue tracked GLOBALLY (e.g. "Enviar recordatorios de vacuna").
+ */
+var ChecklistBranchMode;
+(function (ChecklistBranchMode) {
+    ChecklistBranchMode["specific"] = "specific";
+    ChecklistBranchMode["each"] = "each";
+    ChecklistBranchMode["any"] = "any";
+})(ChecklistBranchMode || (exports.ChecklistBranchMode = ChecklistBranchMode = {}));
+exports.CHECKLIST_BRANCH_MODE_LABELS = {
+    [ChecklistBranchMode.specific]: "Sucursales específicas",
+    [ChecklistBranchMode.each]: "Todas (cada una)",
+    [ChecklistBranchMode.any]: "Cualquier sucursal",
+};
+/** Branch modes whose doneness is tracked per-branch (not global). */
+exports.PER_BRANCH_MODES = new Set([
+    ChecklistBranchMode.specific,
+    ChecklistBranchMode.each,
+]);
+// --- Priority ---
+var ChecklistPriority;
+(function (ChecklistPriority) {
+    ChecklistPriority["high"] = "high";
+    ChecklistPriority["medium"] = "medium";
+    ChecklistPriority["low"] = "low";
+})(ChecklistPriority || (exports.ChecklistPriority = ChecklistPriority = {}));
+exports.CHECKLIST_PRIORITY_LABELS = {
+    [ChecklistPriority.high]: "Alta",
+    [ChecklistPriority.medium]: "Media",
+    [ChecklistPriority.low]: "Baja",
+};
+// --- Run status ---
+/**
+ * Lifecycle of a per-occasion checklist run.
+ *
+ * - `open`: created, collaborator filling it
+ * - `submitted`: collaborator confirmed/submitted the run
+ */
+var ChecklistRunStatus;
+(function (ChecklistRunStatus) {
+    ChecklistRunStatus["open"] = "open";
+    ChecklistRunStatus["submitted"] = "submitted";
+})(ChecklistRunStatus || (exports.ChecklistRunStatus = ChecklistRunStatus = {}));
+exports.CHECKLIST_RUN_STATUS_LABELS = {
+    [ChecklistRunStatus.open]: "Abierto",
+    [ChecklistRunStatus.submitted]: "Enviado",
+};

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

@@ -13,6 +13,7 @@ export * from './time-off-request';
 export * from './force-majeure';
 export * from './job';
 export * from './inventory-session';
+export * from './shift-checklist';
 export * from './client-billing';
 export * from './global-invoice';
 export * from './inventory-report';

package/dist/contracts/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./time-off-request"), exports);
 __exportStar(require("./force-majeure"), exports);
 __exportStar(require("./job"), exports);
 __exportStar(require("./inventory-session"), exports);
+__exportStar(require("./shift-checklist"), exports);
 __exportStar(require("./client-billing"), exports);
 __exportStar(require("./global-invoice"), exports);
 __exportStar(require("./inventory-report"), exports);

package/dist/contracts/shift-checklist/index.d.ts

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

package/dist/contracts/shift-checklist/index.js

@@ -0,0 +1,19 @@
+"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("./types"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/shift-checklist/requests.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Shift Checklist Request Types
+ *
+ * Request DTOs for the shift checklist endpoints.
+ *
+ * @example POST   /api/shift-checklist/activities
+ * @example GET    /api/shift-checklist/runs/view
+ * @example POST   /api/shift-checklist/runs/:id/completions/batch
+ */
+import { ChecklistBranchMode, ChecklistCompletionStatus, ChecklistMoment, ChecklistPriority } from '../../constants/shift-checklist.enums';
+/**
+ * Create a master checklist activity.
+ *
+ * @example POST /api/shift-checklist/activities
+ */
+export interface CreateChecklistActivityRequest {
+    /** Concrete, verb-first action (location lives in the name when it matters) */
+    name: string;
+    /** Branch scope: specific (these branchIds) / each (all, per-branch) / any (global) */
+    branchMode: ChecklistBranchMode;
+    /** Branch ids the activity applies to (required when branchMode is `specific`) */
+    branchIds?: string[];
+    momentOfShift: ChecklistMoment;
+    /** When false, the activity is a visible reminder only (default true). */
+    isTracked?: boolean;
+    /** Days between occurrences; null = no fixed cadence (never overdue) */
+    frequencyDays?: number | null;
+    priority?: ChecklistPriority | null;
+    estimatedMinutes?: number | null;
+    /** How/when to do it: merged procedure + conditional notes (free text, may be multiline). */
+    instructions?: string;
+    requiresEvidence?: boolean;
+}
+/**
+ * Update a master checklist activity (partial).
+ *
+ * @example PATCH /api/shift-checklist/activities/:id
+ */
+export interface UpdateChecklistActivityRequest {
+    name?: string;
+    branchMode?: ChecklistBranchMode;
+    branchIds?: string[];
+    momentOfShift?: ChecklistMoment;
+    isTracked?: boolean;
+    frequencyDays?: number | null;
+    priority?: ChecklistPriority | null;
+    estimatedMinutes?: number | null;
+    /** How/when to do it: merged procedure + conditional notes (free text, may be multiline). */
+    instructions?: string;
+    requiresEvidence?: boolean;
+    isActive?: boolean;
+}
+/**
+ * Filters for listing master activities.
+ *
+ * @example GET /api/shift-checklist/activities?branchId=...&momentOfShift=check_out&isActive=true
+ */
+export interface ListChecklistActivitiesFilters {
+    branchId?: string;
+    momentOfShift?: ChecklistMoment;
+    isActive?: boolean;
+}
+/**
+ * Query for the checkout view (find-or-create a run + its assembled view).
+ *
+ * @example GET /api/shift-checklist/runs/view?momentOfShift=check_out&branchId=...
+ */
+export interface GetChecklistViewQuery {
+    /** check_in or check_out (never both) */
+    momentOfShift: ChecklistMoment;
+    branchId: string;
+    /** YYYY-MM-DD; defaults to today (America/Mexico_City) server-side */
+    shiftDate?: string;
+    /** link to the realized attendance occasion (TimeShift) when opened from checkout */
+    attendanceRecordId?: string;
+}
+/**
+ * Update a run (e.g. correct the branch for the whole run, or add notes).
+ *
+ * @example PATCH /api/shift-checklist/runs/:id
+ */
+export interface UpdateChecklistRunRequest {
+    branchId?: string;
+    notes?: string;
+}
+/**
+ * A single completion to record/update within a run.
+ * Either `activityId` (master task) or `adHocTitle` (ad-hoc task) must be set.
+ */
+export interface RecordCompletionItemRequest {
+    /** null/omitted = ad-hoc task (requires adHocTitle) */
+    activityId?: string | null;
+    adHocTitle?: string;
+    status: ChecklistCompletionStatus;
+    /** who did it; defaults to [current user]. Multiple for shared tasks. */
+    performedByIds?: string[];
+    /** required when status is "skipped" */
+    skipReason?: string;
+    notes?: string;
+    evidenceUrl?: string | null;
+}
+/**
+ * Batch upsert completions in a run (idempotent per activity).
+ *
+ * @example POST /api/shift-checklist/runs/:id/completions/batch
+ */
+export interface RecordCompletionsBatchRequest {
+    items: RecordCompletionItemRequest[];
+}
+/**
+ * Query filters for checklist statistics.
+ *
+ * @example GET /api/shift-checklist/stats?branchId=...&from=2026-06-01&to=2026-06-20
+ */
+export interface ChecklistStatsQuery {
+    branchId?: string;
+    from?: string;
+    to?: string;
+}
+/**
+ * Create a one-off pendiente (just a title; stays open until resolved).
+ *
+ * @example POST /api/shift-checklist/pending-tasks
+ */
+export interface CreateChecklistPendingTaskRequest {
+    title: string;
+    branchId: string;
+}
+/**
+ * Mark a pendiente done, recording who did it.
+ *
+ * @example PATCH /api/shift-checklist/pending-tasks/:id/resolve
+ */
+export interface ResolveChecklistPendingTaskRequest {
+    performedByIds: string[];
+}
+/**
+ * Filters for listing pendientes.
+ *
+ * @example GET /api/shift-checklist/pending-tasks?branchId=...&includeResolved=false
+ */
+export interface ListChecklistPendingTasksFilters {
+    branchId: string;
+    includeResolved?: boolean;
+}

package/dist/contracts/shift-checklist/requests.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Shift Checklist Request Types
+ *
+ * Request DTOs for the shift checklist endpoints.
+ *
+ * @example POST   /api/shift-checklist/activities
+ * @example GET    /api/shift-checklist/runs/view
+ * @example POST   /api/shift-checklist/runs/:id/completions/batch
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/shift-checklist/responses.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Shift Checklist Response Types
+ *
+ * Response DTOs for the shift checklist endpoints. Dates are ISO 8601 strings.
+ */
+import { ChecklistBranchMode, ChecklistMoment, ChecklistPriority, ChecklistRunStatus } from '../../constants/shift-checklist.enums';
+import { ChecklistAdHocItem, ChecklistCheckoutItem } from './types';
+/**
+ * A master checklist activity.
+ *
+ * @example GET /api/shift-checklist/activities
+ */
+export interface ChecklistActivityResponse {
+    id: string;
+    name: string;
+    branchMode: ChecklistBranchMode;
+    branchIds: string[];
+    momentOfShift: ChecklistMoment;
+    isTracked: boolean;
+    frequencyDays: number | null;
+    priority: ChecklistPriority | null;
+    estimatedMinutes: number | null;
+    /** How/when to do it: merged procedure + conditional notes (free text, may be multiline). */
+    instructions: string;
+    requiresEvidence: boolean;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+/**
+ * A per-occasion checklist run.
+ *
+ * @example GET /api/shift-checklist/runs/view
+ */
+export interface ChecklistRunResponse {
+    id: string;
+    collaboratorId: string;
+    branchId: string;
+    branchName: string;
+    momentOfShift: ChecklistMoment;
+    shiftDate: string;
+    attendanceRecordId: string | null;
+    status: ChecklistRunStatus;
+    submittedAt: string | null;
+    notes: string;
+}
+/**
+ * The assembled checkout view: the run, its activity rows (with last-done +
+ * overdue), and any ad-hoc items. Powers the checkout modal.
+ *
+ * @example GET /api/shift-checklist/runs/view
+ * @example POST /api/shift-checklist/runs/:id/completions/batch (refreshed view)
+ */
+export interface ChecklistCheckoutViewResponse {
+    run: ChecklistRunResponse;
+    items: ChecklistCheckoutItem[];
+    adHocItems: ChecklistAdHocItem[];
+}
+export interface ChecklistBranchStats {
+    branchId: string;
+    branchName: string;
+    totalCompletions: number;
+    doneCount: number;
+    notDoneCount: number;
+    skippedCount: number;
+    /** master activities currently overdue at this branch */
+    overdueActivityCount: number;
+}
+/**
+ * Checklist statistics over a period.
+ *
+ * @example GET /api/shift-checklist/stats
+ */
+export interface ChecklistStatsResponse {
+    from: string | null;
+    to: string | null;
+    byBranch: ChecklistBranchStats[];
+    totalRuns: number;
+    /** done completions / total completions, 0..1 */
+    completionRate: number;
+}
+/**
+ * A one-off "pendiente" — created on the fly, stays open per branch across shifts
+ * until someone marks it done (and only then records who did it).
+ *
+ * @example GET /api/shift-checklist/pending-tasks?branchId=...
+ */
+export interface ChecklistPendingTaskResponse {
+    id: string;
+    title: string;
+    branchId: string;
+    isResolved: boolean;
+    doneByIds: string[];
+    doneByNames: string[];
+    doneAt: string | null;
+    createdBy: string;
+    createdAt: string;
+}

package/dist/contracts/shift-checklist/responses.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Shift Checklist Response Types
+ *
+ * Response DTOs for the shift checklist endpoints. Dates are ISO 8601 strings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/shift-checklist/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Shift Checklist — shared building-block types
+ *
+ * Reusable shapes referenced by the endpoint responses (checkout view items,
+ * completion shape). Dates are ISO 8601 strings on the wire.
+ */
+import { ChecklistBranchMode, ChecklistCompletionStatus, ChecklistMoment, ChecklistPriority } from '../../constants/shift-checklist.enums';
+/**
+ * A recorded completion of a task within a run (or an ad-hoc task).
+ *
+ * @example POST /api/shift-checklist/runs/:id/completions/batch
+ */
+export interface ChecklistCompletionResponse {
+    id: string;
+    runId: string;
+    /** null = ad-hoc task (not on the master list) */
+    activityId: string | null;
+    /** present when activityId is null */
+    adHocTitle: string | null;
+    status: ChecklistCompletionStatus;
+    /** present when status is "skipped" */
+    skipReason: string | null;
+    /** who performed the task (one or more, for shared tasks) */
+    performedByIds: string[];
+    performedByNames: string[];
+    /** who logged the completion */
+    reportedById: string;
+    evidenceUrl: string | null;
+    notes: string;
+    completedAt: string | null;
+    /** denormalized from the run */
+    branchId: string;
+    shiftDate: string;
+    momentOfShift: ChecklistMoment;
+}
+/**
+ * One row in the checkout view: a master activity plus its last-done history and
+ * this run's completion (if any).
+ */
+export interface ChecklistCheckoutItem {
+    activityId: string;
+    name: string;
+    /** When the activity is meant to be done (shown as a tag in the day list). */
+    momentOfShift: ChecklistMoment;
+    /** Branch scope — `any` items count globally and are grouped apart. */
+    branchMode: ChecklistBranchMode;
+    /** When false, the activity is a visible reminder only — not marked/tracked. */
+    isTracked: boolean;
+    priority: ChecklistPriority | null;
+    estimatedMinutes: number | null;
+    instructions: string;
+    requiresEvidence: boolean;
+    frequencyDays: number | null;
+    /** last time this activity was DONE at this branch (drives overdue) */
+    lastDoneAt: string | null;
+    /** who did it last (may be several for a shared task) */
+    lastDoneByIds: string[];
+    lastDoneByNames: string[];
+    /**
+     * Most recent action on this activity at this branch, ANY status — for
+     * context when the last thing that happened was an omission (e.g. last done
+     * Jan 1 but last action was "omitida" yesterday). Null if never acted on.
+     */
+    lastAction: {
+        status: ChecklistCompletionStatus;
+        at: string;
+        byIds: string[];
+        byNames: string[];
+        skipReason: string | null;
+        notes: string;
+    } | null;
+    /** lastDoneAt + frequencyDays < now (false when no cadence or never done) */
+    isOverdue: boolean;
+    /** this run's completion for the activity, if recorded */
+    completion: ChecklistCompletionResponse | null;
+}
+/** An ad-hoc task added during a run (not tied to a master activity). */
+export interface ChecklistAdHocItem {
+    id: string;
+    adHocTitle: string;
+    status: ChecklistCompletionStatus;
+    performedByIds: string[];
+    performedByNames: string[];
+    completedAt: string | null;
+    notes: string;
+}

package/dist/contracts/shift-checklist/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Shift Checklist — shared building-block types
+ *
+ * Reusable shapes referenced by the endpoint responses (checkout view items,
+ * completion shape). Dates are ISO 8601 strings on the wire.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/validation/index.d.ts

@@ -9,3 +9,4 @@ export * from './email.validation';
 export * from './phone.validation';
 export * from './address.validation';
 export * from './document.validation';
+export * from './shift-checklist.validation';

package/dist/validation/index.js

@@ -25,3 +25,4 @@ __exportStar(require("./email.validation"), exports);
 __exportStar(require("./phone.validation"), exports);
 __exportStar(require("./address.validation"), exports);
 __exportStar(require("./document.validation"), exports);
+__exportStar(require("./shift-checklist.validation"), exports);

package/dist/validation/shift-checklist.validation.d.ts

@@ -0,0 +1,12 @@
+import { ValidationResult } from './rfc.validation';
+/**
+ * Validates a checklist activity frequency (in days).
+ *
+ * The frequency is the number of days between occurrences of a recurring task.
+ * - `null`/`undefined` → no fixed cadence (valid; the task is never "overdue").
+ * - otherwise → must be an integer ≥ 1.
+ *
+ * @param value - frequency in days, or null/undefined for "no cadence"
+ * @returns ValidationResult with isValid flag and optional error message
+ */
+export declare function validateChecklistFrequency(value: number | null | undefined): ValidationResult;

package/dist/validation/shift-checklist.validation.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateChecklistFrequency = validateChecklistFrequency;
+/**
+ * Validates a checklist activity frequency (in days).
+ *
+ * The frequency is the number of days between occurrences of a recurring task.
+ * - `null`/`undefined` → no fixed cadence (valid; the task is never "overdue").
+ * - otherwise → must be an integer ≥ 1.
+ *
+ * @param value - frequency in days, or null/undefined for "no cadence"
+ * @returns ValidationResult with isValid flag and optional error message
+ */
+function validateChecklistFrequency(value) {
+    if (value === null || value === undefined) {
+        return { isValid: true };
+    }
+    if (typeof value !== 'number' || Number.isNaN(value) || !Number.isInteger(value)) {
+        return {
+            isValid: false,
+            error: 'La frecuencia debe ser un número entero de días',
+        };
+    }
+    if (value < 1) {
+        return { isValid: false, error: 'La frecuencia debe ser al menos 1 día' };
+    }
+    return { isValid: true };
+}

package/dist/validation/shift-checklist.validation.test.d.ts

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

package/dist/validation/shift-checklist.validation.test.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const shift_checklist_validation_1 = require("./shift-checklist.validation");
+describe('validateChecklistFrequency', () => {
+    describe('valid frequencies', () => {
+        it('accepts null (no fixed cadence)', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(null).isValid).toBe(true);
+        });
+        it('accepts undefined (no fixed cadence)', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(undefined).isValid).toBe(true);
+        });
+        it('accepts 1 (daily)', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(1).isValid).toBe(true);
+        });
+        it('accepts arbitrary positive integers', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(7).isValid).toBe(true);
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(30).isValid).toBe(true);
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(45).isValid).toBe(true);
+        });
+    });
+    describe('invalid frequencies', () => {
+        it('rejects 0', () => {
+            const result = (0, shift_checklist_validation_1.validateChecklistFrequency)(0);
+            expect(result.isValid).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+        it('rejects negative numbers', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(-1).isValid).toBe(false);
+        });
+        it('rejects non-integers', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(1.5).isValid).toBe(false);
+        });
+        it('rejects NaN', () => {
+            expect((0, shift_checklist_validation_1.validateChecklistFrequency)(Number.NaN).isValid).toBe(false);
+        });
+    });
+});

package/package.json

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