hvp-shared 13.8.1 → 13.10.0

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

@@ -58,6 +58,15 @@ export declare const BRANCH_COLOR_IDS: Readonly<Record<AppointmentBranch, string
 export declare const COLOR_ID_TO_BRANCH: Readonly<Record<string, AppointmentBranch>>;
 /** colorId 8 (Graphite) = cancelled. Tracked as a separate metric. */
 export declare const CANCELLED_COLOR_ID = "8";
+/**
+ * colorId 7 (Peacock cyan) = cliente no llegó (no-show).
+ *
+ * Convention: when a client doesn't show up to their appointment, recepción
+ * repinta el evento con este color para señalar pendiente-de-seguimiento.
+ * Tracked separately from cancellations (which are client-initiated) and
+ * excluded from compliance scoring.
+ */
+export declare const NO_SHOW_COLOR_ID = "7";
 /**
  * colorIds reserved for special events (NOT patient appointments).
  *

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

@@ -13,7 +13,7 @@
  * 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.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.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;
 // ─── Standard v1 ─────────────────────────────────────────────────────────────
 /**
  * Multi-factor appointment standard v2.
@@ -213,6 +213,15 @@ exports.COLOR_ID_TO_BRANCH = {
 // ─── Excluded colorIds ───────────────────────────────────────────────────────
 /** colorId 8 (Graphite) = cancelled. Tracked as a separate metric. */
 exports.CANCELLED_COLOR_ID = "8";
+/**
+ * colorId 7 (Peacock cyan) = cliente no llegó (no-show).
+ *
+ * Convention: when a client doesn't show up to their appointment, recepción
+ * repinta el evento con este color para señalar pendiente-de-seguimiento.
+ * Tracked separately from cancellations (which are client-initiated) and
+ * excluded from compliance scoring.
+ */
+exports.NO_SHOW_COLOR_ID = "7";
 /**
  * colorIds reserved for special events (NOT patient appointments).
  *

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

@@ -27,3 +27,55 @@ export interface DiagnoseAppointmentsRequest {
 export interface DiagnoseEventRequest {
     eventId: string;
 }
+/**
+ * Create appointment request — recepción creates a new GCal event directly
+ * from HVP. The backend formats title + description per `STANDARD_V3`,
+ * picks the right colorId from `branch`, and sets `extendedProperties.private`
+ * with the metadata the scorer reads — so the resulting event auto-passes
+ * the dimensions the user can't get wrong (branch, service, scheduler).
+ *
+ * `schedulerColCode` is NOT in the body; it's derived from the authenticated
+ * user on the backend.
+ *
+ * @example POST /api/google-calendar/appointments
+ */
+export interface CreateAppointmentRequest {
+    /** Branch — drives the GCal colorId. */
+    branch: 'urban' | 'harbor' | 'montejo';
+    /**
+     * Short service code (e.g. `"C"`, `"SC"`, `"V"`, `"CX"`). Goes first in
+     * the title. The scorer canonicalizes via `SERVICE_CODE_SYNONYMS`, so any
+     * accepted variant works.
+     */
+    serviceCode: string;
+    /** Optional specialty modifier after the service code (e.g. `"OFT"`, `"NEURO"`). */
+    specialty?: string;
+    /** Pet name (uppercased into the title). Required. */
+    petName: string;
+    /** Attending vet col_code (e.g. `"RGL"`). Optional. */
+    vetColCode?: string;
+    /** True → asterisk after `vetColCode` in title (= preferred vet, comissionable). */
+    isPreferredVet?: boolean;
+    /**
+     * QVET client id in `Q{id}` format. When present, the description gets the
+     * Google-Contacts paste line `NAME | PETS | Q{id}` so the scorer auto-passes
+     * `owner_name` and `owner_phone` dimensions.
+     */
+    qvetClientId?: string;
+    /** Tutor name. Required if no `qvetClientId`. */
+    ownerName?: string;
+    /** Tutor phone (any common Mexican format). Required if no `qvetClientId`. */
+    ownerPhone?: string;
+    /** Free-text motivo / contexto clínico. */
+    motivo?: string;
+    /** Breed (e.g. `"Yorkie"`). Detected against `KNOWN_BREEDS`. */
+    breed?: string;
+    /** Age (e.g. `"4 meses"`, `"1 año y 4 meses"`). */
+    age?: string;
+    /** Discount annotation `<n>% <razón>` (e.g. `"15% recordatorio"`). */
+    discount?: string;
+    /** ISO datetime with timezone (e.g. `"2026-05-20T10:00:00-06:00"`). */
+    startDateTime: string;
+    /** Duration in minutes (e.g. 30, 60, 90). */
+    durationMinutes: number;
+}

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

@@ -53,7 +53,7 @@ export interface DiagnosticDimensionResult {
 /**
  * Reason an event was excluded from scoring.
  */
-export type DiagnosticExclusionReason = 'cancelled' | 'blocker' | 'special' | 'operational' | 'interview' | 'reminder';
+export type DiagnosticExclusionReason = 'cancelled' | 'blocker' | 'special' | 'operational' | 'interview' | 'reminder' | 'no_show';
 /**
  * Full diagnostic result for one event.
  */
@@ -180,3 +180,24 @@ export interface DiagnoseAppointmentsResponse {
     /** Detailed excluded events (capped at 100). */
     excluded: DiagnosticExcludedEvent[];
 }
+/**
+ * Result of creating a new GCal appointment from HVP. Returns the created
+ * event id + link, the title that was generated, and an immediate diagnostic
+ * preview so the UI can show "this appointment scored 100/100" confirmation.
+ *
+ * @example POST /api/google-calendar/appointments → 201
+ */
+export interface CreateAppointmentResponse {
+    /** GCal event id. */
+    eventId: string;
+    /** Link to the event in Google Calendar. */
+    htmlLink: string;
+    /** Title that was generated from the request fields. */
+    title: string;
+    /** ISO datetime echoed back (Mexico_City). */
+    startDateTime: string;
+    /** Score the event got under the current standard (typically 100 — HVP-created events auto-pass most dims). */
+    score: number;
+    /** True iff `score >= minimumCompliantScore`. */
+    isCompliant: boolean;
+}

package/package.json

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