evo360-types 1.3.409 → 1.3.413

package/dist/types/hub-automation/index.ts

@@ -68,18 +68,47 @@ export interface IAutomationDateWindow {
 export interface IAutomationAppointmentSelection {
   target: "appointment";
   appointment: {
-    // Empty/omitted = all calendars of the tenant.
+    // Empty/omitted = all calendars of the tenant. GUI enforces exactly 1
+    // (Q21-A: single-calendar unlocks rich filter-values); calendar_ids[] kept
+    // for engine/seed compat (multi-calendar = N routines).
     calendar_ids?: string[];
     date_window: IAutomationDateWindow;
-    // Filters applied in memory over the day window (no server-side status query).
+    // Filters applied in memory over the day window (no server-side query).
+    // String filters accept the wildcard `*` (case-insensitive glob); without
+    // `*` they are exact matches (Q21). Sourced from the appointment embeds
+    // (passthrough from the sync, per the Q20-C investigation).
     status_in?: string[];
     status_base_in?: string[];
     appointment_type_not_in?: string[];
+    // professional.display_name
+    professional_names?: string[];
+    // matches if ANY procedures[].name matches
+    procedure_names?: string[];
+    // insurance.name
+    insurance_names?: string[];
+    // address.address_name (note: NOT address.Name of the legacy n8n shape)
+    address_names?: string[];
+    // payment.status — fixed local enum (pending/partial/paid/not_informed)
+    payment_status_in?: string[];
   };
 }
 
 export type IAutomationSelection = IAutomationAppointmentSelection;
 
+// Distinct filter values for a calendar, built from a limited window of local
+// appointments (GET /routines/filter-values?calendar_id=). Feeds the GUI's
+// selection filters and branch conditions with real, per-calendar suggestions
+// (Q20-C: distinct-local, no adapter capability). Sorted pt-BR, capped per field.
+export interface IAutomationFilterValues {
+  professionals: string[];
+  procedures: string[];
+  insurances: string[];
+  addresses: string[];
+  statuses: string[];
+  status_bases: string[];
+  appointment_types: string[];
+}
+
 // ------------------------------------------------------
 // Fact catalog (F1: appointment domain facts only — Q15: no patient.* facts)
 // ------------------------------------------------------
@@ -91,9 +120,16 @@ export const AUTOMATION_APPOINTMENT_FACTS = [
   "appointment.appointment_base_type",
   // 'telemedicine' | 'in_person'
   "appointment.appointment_mode",
-  // Derived from professional.professionalRef.id
+  // Derived from professional.professionalRef.id. On external calendars the
+  // reliable value is the name (Q21) — professional_id kept for internal.
   "appointment.professional_id",
   "appointment.procedure_ids",
+  // Embed-sourced names (Q20-C passthrough); reliable across adapters.
+  "appointment.professional_name",
+  // string[] — matches if ANY procedure name matches.
+  "appointment.procedure_names",
+  "appointment.insurance_name",
+  "appointment.address_name",
   "appointment.payment_status",
   "appointment.calendar_id",
 ] as const;
@@ -151,6 +187,11 @@ export type AutomationOutputType =
 // - immediate: now (Task Runner picks it up on the next tick)
 // - send_at_local: HH:mm resolved in the tenant timezone, anchored to the
 //   target date or the run date.
+// - relative_to_appointment: appointment.startDate + offset_minutes (Q20.7).
+//   Negative = before the appointment (e.g. -120 = 2h before). The routine
+//   runs once (e.g. 6am); each task is scheduled relative to its own target.
+//   If the computed time already passed at run time, the materializer clamps
+//   it to "now" (with a log).
 export type IAutomationExecuteAt =
   | { rule: "immediate" }
   | {
@@ -158,6 +199,11 @@ export type IAutomationExecuteAt =
       // "HH:mm" (24h)
       time: string;
       base: "target_date" | "run_date";
+    }
+  | {
+      rule: "relative_to_appointment";
+      // Signed minutes offset from appointment.startDate (negative = before).
+      offset_minutes: number;
     };
 
 export interface IAutomationAutoTaskOutput {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.409",
+  "version": "1.3.413",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",