hvp-shared 13.9.0 → 13.10.0

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

@@ -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.9.0",
+  "version": "13.10.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",