evo360-types 1.3.419 → 1.3.423

package/dist/types/evo-campaigns/index.d.ts

@@ -45,8 +45,15 @@ export interface ICampaignCta {
     label: string;
     /** WhatsApp template button position (0,1,2...). */
     button_index?: number;
-    /** Final destination for the /qr redirect. */
+    /** Final destination for the /qr redirect. Optional on WhatsApp QUICK_REPLY
+     *  buttons (the tap itself is tracked); required for email CTAs and URL buttons. */
     target_url?: string;
+    /** Email CTA destination kind (feat-081 F2.5): external URL or a wa.me deep link. */
+    dest_type?: "external_url" | "whatsapp" | null;
+    /** WA channel whose number builds the wa.me link (dest_type='whatsapp'). */
+    wa_channel_id?: string | null;
+    /** Prefilled message for the wa.me link (dest_type='whatsapp'). */
+    wa_message?: string | null;
 }
 export interface ICampaignPacingWindow {
     /** 'HH:mm' local (tenant timezone). */
@@ -71,8 +78,12 @@ export interface ICampaignTicketPolicy {
 export interface ICampaignMedia {
     /** 'image' | 'video' | 'document' — WhatsApp header media type. */
     type: string;
+    /** Full gs:// URI in WABA_MEDIA_BUCKET under tenants/<tenant>/ (feat-082/084 flow). */
     gcs_path?: string;
     url?: string;
+    /** Mime type of the uploaded media (drives the header component). */
+    mime_type?: string | null;
+    filename?: string | null;
 }
 /** Per-channel configuration (whatsapp/email) of a campaign. */
 export interface ICampaignChannelConfig {
@@ -251,7 +262,10 @@ export interface ICampaignBucket extends IFireDoc {
     counts?: ICampaignBucketCounts;
 }
 /** Flat field driving the batch queue (indexed). */
-export type RecipientDispatchState = "pending" | "dispatched" | "done" | "excluded";
+export type RecipientDispatchState = "pending" | "dispatched" | "done" | "excluded"
+/** Campaign canceled with this recipient still pending (feat-081 F3 — formalizes
+ *  what F2 stored as 'excluded'; readers must accept both on old docs). */
+ | "canceled";
 /** Per-channel delivery status of a recipient (monotonic). */
 export type RecipientChannelStatus = "pending" | "scheduled" | "sent" | "delivered" | "read" | "failed" | "clicked" | "replied";
 /** Aggregated, monotonic recipient status (Portuguese labels — FE display). */

package/dist/types/evo-campaigns/index.ts

@@ -95,8 +95,15 @@ export interface ICampaignCta {
   label: string;
   /** WhatsApp template button position (0,1,2...). */
   button_index?: number;
-  /** Final destination for the /qr redirect. */
+  /** Final destination for the /qr redirect. Optional on WhatsApp QUICK_REPLY
+   *  buttons (the tap itself is tracked); required for email CTAs and URL buttons. */
   target_url?: string;
+  /** Email CTA destination kind (feat-081 F2.5): external URL or a wa.me deep link. */
+  dest_type?: "external_url" | "whatsapp" | null;
+  /** WA channel whose number builds the wa.me link (dest_type='whatsapp'). */
+  wa_channel_id?: string | null;
+  /** Prefilled message for the wa.me link (dest_type='whatsapp'). */
+  wa_message?: string | null;
 }
 
 // ----- Pacing + ticket policy -----------------------------------------------
@@ -127,8 +134,12 @@ export interface ICampaignTicketPolicy {
 export interface ICampaignMedia {
   /** 'image' | 'video' | 'document' — WhatsApp header media type. */
   type: string;
+  /** Full gs:// URI in WABA_MEDIA_BUCKET under tenants/<tenant>/ (feat-082/084 flow). */
   gcs_path?: string;
   url?: string;
+  /** Mime type of the uploaded media (drives the header component). */
+  mime_type?: string | null;
+  filename?: string | null;
 }
 
 // ----- Channel config -------------------------------------------------------
@@ -348,7 +359,10 @@ export type RecipientDispatchState =
   | "pending"
   | "dispatched"
   | "done"
-  | "excluded";
+  | "excluded"
+  /** Campaign canceled with this recipient still pending (feat-081 F3 — formalizes
+   *  what F2 stored as 'excluded'; readers must accept both on old docs). */
+  | "canceled";
 
 /** Per-channel delivery status of a recipient (monotonic). */
 export type RecipientChannelStatus =

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

@@ -43,7 +43,24 @@ export interface IAutomationAppointmentSelection {
         payment_status_in?: string[];
     };
 }
-export type IAutomationSelection = IAutomationAppointmentSelection;
+export interface IAutomationLeadSelection {
+    target: "lead";
+    lead: {
+        status_in?: string[];
+        qualification_codes?: string[];
+        dist_channel_codes?: string[];
+        tag_names?: string[];
+    };
+}
+export interface IAutomationPatientSelection {
+    target: "patient";
+    patient: {
+        status_in?: string[];
+        source_codes?: string[];
+        tag_names?: string[];
+    };
+}
+export type IAutomationSelection = IAutomationAppointmentSelection | IAutomationLeadSelection | IAutomationPatientSelection;
 export interface IAutomationFilterValues {
     professionals: string[];
     procedures: string[];
@@ -55,7 +72,11 @@ export interface IAutomationFilterValues {
 }
 export declare const AUTOMATION_APPOINTMENT_FACTS: readonly ["appointment.status", "appointment.status_base", "appointment.appointment_type", "appointment.appointment_base_type", "appointment.appointment_mode", "appointment.professional_id", "appointment.procedure_ids", "appointment.professional_name", "appointment.procedure_names", "appointment.insurance_name", "appointment.address_name", "appointment.payment_status", "appointment.calendar_id"];
 export type AutomationAppointmentFact = (typeof AUTOMATION_APPOINTMENT_FACTS)[number];
-export type AutomationFact = AutomationAppointmentFact;
+export declare const AUTOMATION_LEAD_FACTS: readonly ["lead.status", "lead.qualification_code", "lead.qualification_name", "lead.qualification_funnel_level", "lead.dist_channel_code", "lead.dist_channel_name", "lead.tags"];
+export type AutomationLeadFact = (typeof AUTOMATION_LEAD_FACTS)[number];
+export declare const AUTOMATION_PATIENT_FACTS: readonly ["patient.status", "patient.source_code", "patient.source_name", "patient.tags"];
+export type AutomationPatientFact = (typeof AUTOMATION_PATIENT_FACTS)[number];
+export type AutomationFact = AutomationAppointmentFact | AutomationLeadFact | AutomationPatientFact;
 export declare const AutomationOperatorEnum: {
     readonly Eq: "eq";
     readonly Neq: "neq";
@@ -190,7 +211,9 @@ export interface IAutomationRunBranchCounts {
     already_existed: number;
 }
 export interface IAutomationRunSample {
-    appointment_id: string;
+    appointment_id?: string;
+    target_kind?: "appointment" | "lead" | "patient";
+    target_id?: string;
     branch_id?: string;
     decision: string;
     task_id?: string;

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

@@ -14,7 +14,7 @@ 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 });
-exports.AutomationRunStatusEnum = exports.AutomationOutputTypeEnum = exports.AutomationOperatorEnum = exports.AUTOMATION_APPOINTMENT_FACTS = exports.HubAutomationPermissions = void 0;
+exports.AutomationRunStatusEnum = exports.AutomationOutputTypeEnum = exports.AutomationOperatorEnum = exports.AUTOMATION_PATIENT_FACTS = exports.AUTOMATION_LEAD_FACTS = exports.AUTOMATION_APPOINTMENT_FACTS = exports.HubAutomationPermissions = void 0;
 __exportStar(require("./fb_collections"), exports);
 // ======================================================
 // hub-automation
@@ -60,6 +60,29 @@ exports.AUTOMATION_APPOINTMENT_FACTS = [
     "appointment.payment_status",
     "appointment.calendar_id",
 ];
+// feat-085 (F3): lead domain facts (derived from the fields ILead exposes;
+// resolved from the event-preloaded lead). Mirror of the appointment catalog.
+exports.AUTOMATION_LEAD_FACTS = [
+    // 'active' | 'inactive' | 'draft'
+    "lead.status",
+    // qualification is a {code,name,funnelLevel} ref — surface all three.
+    "lead.qualification_code",
+    "lead.qualification_name",
+    "lead.qualification_funnel_level",
+    // distChannel is a {code,name} ref.
+    "lead.dist_channel_code",
+    "lead.dist_channel_name",
+    // string[] of tag names — matches if ANY tag name matches.
+    "lead.tags",
+];
+// feat-085 (F3): patient domain facts (derived from IPatient).
+exports.AUTOMATION_PATIENT_FACTS = [
+    "patient.status",
+    "patient.source_code",
+    "patient.source_name",
+    // string[] of tag names — matches if ANY tag name matches.
+    "patient.tags",
+];
 // ------------------------------------------------------
 // Conditions (recursive AND/OR groups)
 // ------------------------------------------------------

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

@@ -109,7 +109,36 @@ export interface IAutomationAppointmentSelection {
   };
 }
 
-export type IAutomationSelection = IAutomationAppointmentSelection;
+// feat-085 (F3): lead/patient selections. Cron selection is appointment-only;
+// these targets only arrive via the domain-event trigger, where the consumer
+// PRE-LOADS the single target from the event (the `lead`/`patient` filters below
+// are therefore not enforced at event runtime — they exist so a routine can be
+// authored/validated with a lead/patient target and, later, for a possible
+// lead/patient sweep). Discriminated by `target`.
+export interface IAutomationLeadSelection {
+  target: "lead";
+  lead: {
+    // Reserved narrowing filters (glob-aware like the appointment filters).
+    status_in?: string[];
+    qualification_codes?: string[];
+    dist_channel_codes?: string[];
+    tag_names?: string[];
+  };
+}
+
+export interface IAutomationPatientSelection {
+  target: "patient";
+  patient: {
+    status_in?: string[];
+    source_codes?: string[];
+    tag_names?: string[];
+  };
+}
+
+export type IAutomationSelection =
+  | IAutomationAppointmentSelection
+  | IAutomationLeadSelection
+  | IAutomationPatientSelection;
 
 // Distinct filter values for a calendar, built from a limited window of local
 // appointments (GET /routines/filter-values?calendar_id=). Feeds the GUI's
@@ -153,7 +182,39 @@ export const AUTOMATION_APPOINTMENT_FACTS = [
 export type AutomationAppointmentFact =
   (typeof AUTOMATION_APPOINTMENT_FACTS)[number];
 
-export type AutomationFact = AutomationAppointmentFact;
+// feat-085 (F3): lead domain facts (derived from the fields ILead exposes;
+// resolved from the event-preloaded lead). Mirror of the appointment catalog.
+export const AUTOMATION_LEAD_FACTS = [
+  // 'active' | 'inactive' | 'draft'
+  "lead.status",
+  // qualification is a {code,name,funnelLevel} ref — surface all three.
+  "lead.qualification_code",
+  "lead.qualification_name",
+  "lead.qualification_funnel_level",
+  // distChannel is a {code,name} ref.
+  "lead.dist_channel_code",
+  "lead.dist_channel_name",
+  // string[] of tag names — matches if ANY tag name matches.
+  "lead.tags",
+] as const;
+
+export type AutomationLeadFact = (typeof AUTOMATION_LEAD_FACTS)[number];
+
+// feat-085 (F3): patient domain facts (derived from IPatient).
+export const AUTOMATION_PATIENT_FACTS = [
+  "patient.status",
+  "patient.source_code",
+  "patient.source_name",
+  // string[] of tag names — matches if ANY tag name matches.
+  "patient.tags",
+] as const;
+
+export type AutomationPatientFact = (typeof AUTOMATION_PATIENT_FACTS)[number];
+
+export type AutomationFact =
+  | AutomationAppointmentFact
+  | AutomationLeadFact
+  | AutomationPatientFact;
 
 // ------------------------------------------------------
 // Conditions (recursive AND/OR groups)
@@ -378,7 +439,12 @@ export interface IAutomationRunBranchCounts {
 }
 
 export interface IAutomationRunSample {
-  appointment_id: string;
+  // feat-085 (F3): a run target may now be an appointment, a lead or a patient.
+  // `appointment_id` is kept (still set for appointment targets) for backward
+  // compatibility; `target_kind`/`target_id` are the domain-agnostic identity.
+  appointment_id?: string;
+  target_kind?: "appointment" | "lead" | "patient";
+  target_id?: string;
   branch_id?: string;
   // e.g. 'created' | 'already_existed' | 'not_matched' | 'suppressed_by_limit'
   decision: string;

package/dist/types/shared/external-links.d.ts

@@ -11,6 +11,8 @@ export declare const ExternalObjectTypeEnum: {
      * desfecho do envio (sent/failed + os codes da feat-072).
      */
     readonly EvoTask: "evo_task";
+    /** Campanha do hub-omni (feat-081) — liga mensagens/tickets à campanha que os originou. */
+    readonly Campaign: "campaign";
     /** Nexus FinOps billing document */
     readonly NexBilling: "nex_billing";
     readonly NexContract: "nex_contract";

package/dist/types/shared/external-links.js

@@ -15,6 +15,8 @@ exports.ExternalObjectTypeEnum = {
      * desfecho do envio (sent/failed + os codes da feat-072).
      */
     EvoTask: "evo_task",
+    /** Campanha do hub-omni (feat-081) — liga mensagens/tickets à campanha que os originou. */
+    Campaign: "campaign",
     /** Nexus FinOps billing document */
     NexBilling: "nex_billing",
     NexContract: "nex_contract",

package/dist/types/shared/external-links.ts

@@ -15,6 +15,8 @@ export const ExternalObjectTypeEnum = {
    * desfecho do envio (sent/failed + os codes da feat-072).
    */
   EvoTask: "evo_task",
+  /** Campanha do hub-omni (feat-081) — liga mensagens/tickets à campanha que os originou. */
+  Campaign: "campaign",
   /** Nexus FinOps billing document */
   NexBilling: "nex_billing",
   NexContract: "nex_contract",

package/package.json

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