evo360-types 1.3.417 → 1.3.423

package/dist/apps/hub-automation/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zAutomationTriggerRequestSchema = exports.zAutomationDryRunRequestSchema = exports.zHubAutomationConfigSchema = exports.zAutomationRoutineUpdateRequestSchema = exports.zAutomationRoutineWriteSchema = exports.zAutomationRoutineSchema = exports.zAutomationBranchModeSchema = exports.zAutomationBranchSchema = exports.zAutomationOutputSchema = exports.zAutomationActionOutputSchema = exports.zAutomationHumanTaskOutputSchema = exports.zAutomationAutoTaskOutputSchema = exports.zAutomationExecuteAtSchema = exports.zAutomationConditionGroupSchema = exports.zAutomationConditionSchema = exports.zAutomationOperatorSchema = exports.zAutomationSelectionSchema = exports.zAutomationAppointmentSelectionSchema = exports.zAutomationDateWindowSchema = exports.zAutomationDateOffsetModeSchema = exports.zAutomationTriggerSchema = exports.zAutomationWebhookTriggerSchema = exports.zAutomationCronTriggerSchema = void 0;
+exports.zAutomationTriggerRequestSchema = exports.zAutomationDryRunRequestSchema = exports.zHubAutomationConfigSchema = exports.zAutomationRoutineUpdateRequestSchema = exports.zAutomationRoutineWriteSchema = exports.zAutomationRoutineSchema = exports.zAutomationBranchModeSchema = exports.zAutomationBranchSchema = exports.zAutomationOutputSchema = exports.zAutomationActionOutputSchema = exports.zAutomationHumanTaskOutputSchema = exports.zAutomationAutoTaskOutputSchema = exports.zAutomationExecuteAtSchema = exports.zAutomationConditionGroupSchema = exports.zAutomationConditionSchema = exports.zAutomationOperatorSchema = exports.zAutomationSelectionSchema = exports.zAutomationPatientSelectionSchema = exports.zAutomationLeadSelectionSchema = exports.zAutomationAppointmentSelectionSchema = exports.zAutomationDateWindowSchema = exports.zAutomationDateOffsetModeSchema = exports.zAutomationTriggerSchema = exports.zAutomationEventTriggerSchema = exports.zAutomationWebhookTriggerSchema = exports.zAutomationCronTriggerSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../evo-task/zod-schemas");
 // ------------------------------------------------------
@@ -17,9 +17,21 @@ exports.zAutomationCronTriggerSchema = zod_1.z.object({
 exports.zAutomationWebhookTriggerSchema = zod_1.z.object({
     type: zod_1.z.literal("webhook"),
 });
+// feat-085 (F1): domain-event trigger. `actor_kinds` default is applied by the
+// consumer (Camada 1), not here — omitted means ['user'].
+exports.zAutomationEventTriggerSchema = zod_1.z.object({
+    type: zod_1.z.literal("event"),
+    event: zod_1.z.object({
+        types: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+        actor_kinds: zod_1.z
+            .array(zod_1.z.enum(["user", "system", "automation"]))
+            .optional(),
+    }),
+});
 exports.zAutomationTriggerSchema = zod_1.z.discriminatedUnion("type", [
     exports.zAutomationCronTriggerSchema,
     exports.zAutomationWebhookTriggerSchema,
+    exports.zAutomationEventTriggerSchema,
 ]);
 // ------------------------------------------------------
 // Selection (F1: appointment target only)
@@ -46,7 +58,32 @@ exports.zAutomationAppointmentSelectionSchema = zod_1.z.object({
         payment_status_in: zod_1.z.array(zod_1.z.string()).optional(),
     }),
 });
-exports.zAutomationSelectionSchema = exports.zAutomationAppointmentSelectionSchema;
+// feat-085 (F3): lead/patient selections (domain-event targets). The `target`
+// discriminant selects the branch. Filters are reserved (see the TS contract);
+// the event consumer pre-loads the single target, so they are not enforced at
+// runtime today but are validated to allow authoring lead/patient routines.
+exports.zAutomationLeadSelectionSchema = zod_1.z.object({
+    target: zod_1.z.literal("lead"),
+    lead: zod_1.z.object({
+        status_in: zod_1.z.array(zod_1.z.string()).optional(),
+        qualification_codes: zod_1.z.array(zod_1.z.string()).optional(),
+        dist_channel_codes: zod_1.z.array(zod_1.z.string()).optional(),
+        tag_names: zod_1.z.array(zod_1.z.string()).optional(),
+    }),
+});
+exports.zAutomationPatientSelectionSchema = zod_1.z.object({
+    target: zod_1.z.literal("patient"),
+    patient: zod_1.z.object({
+        status_in: zod_1.z.array(zod_1.z.string()).optional(),
+        source_codes: zod_1.z.array(zod_1.z.string()).optional(),
+        tag_names: zod_1.z.array(zod_1.z.string()).optional(),
+    }),
+});
+exports.zAutomationSelectionSchema = zod_1.z.discriminatedUnion("target", [
+    exports.zAutomationAppointmentSelectionSchema,
+    exports.zAutomationLeadSelectionSchema,
+    exports.zAutomationPatientSelectionSchema,
+]);
 // ------------------------------------------------------
 // Conditions (recursive AND/OR groups via z.lazy)
 // ------------------------------------------------------

package/dist/apps/hub-automation/zod-schemas.ts

@@ -21,9 +21,22 @@ export const zAutomationWebhookTriggerSchema = z.object({
   type: z.literal("webhook"),
 });
 
+// feat-085 (F1): domain-event trigger. `actor_kinds` default is applied by the
+// consumer (Camada 1), not here — omitted means ['user'].
+export const zAutomationEventTriggerSchema = z.object({
+  type: z.literal("event"),
+  event: z.object({
+    types: z.array(z.string().min(1)).min(1),
+    actor_kinds: z
+      .array(z.enum(["user", "system", "automation"]))
+      .optional(),
+  }),
+});
+
 export const zAutomationTriggerSchema = z.discriminatedUnion("type", [
   zAutomationCronTriggerSchema,
   zAutomationWebhookTriggerSchema,
+  zAutomationEventTriggerSchema,
 ]);
 
 // ------------------------------------------------------
@@ -54,7 +67,34 @@ export const zAutomationAppointmentSelectionSchema = z.object({
   }),
 });
 
-export const zAutomationSelectionSchema = zAutomationAppointmentSelectionSchema;
+// feat-085 (F3): lead/patient selections (domain-event targets). The `target`
+// discriminant selects the branch. Filters are reserved (see the TS contract);
+// the event consumer pre-loads the single target, so they are not enforced at
+// runtime today but are validated to allow authoring lead/patient routines.
+export const zAutomationLeadSelectionSchema = z.object({
+  target: z.literal("lead"),
+  lead: z.object({
+    status_in: z.array(z.string()).optional(),
+    qualification_codes: z.array(z.string()).optional(),
+    dist_channel_codes: z.array(z.string()).optional(),
+    tag_names: z.array(z.string()).optional(),
+  }),
+});
+
+export const zAutomationPatientSelectionSchema = z.object({
+  target: z.literal("patient"),
+  patient: z.object({
+    status_in: z.array(z.string()).optional(),
+    source_codes: z.array(z.string()).optional(),
+    tag_names: z.array(z.string()).optional(),
+  }),
+});
+
+export const zAutomationSelectionSchema = z.discriminatedUnion("target", [
+  zAutomationAppointmentSelectionSchema,
+  zAutomationLeadSelectionSchema,
+  zAutomationPatientSelectionSchema,
+]);
 
 // ------------------------------------------------------
 // Conditions (recursive AND/OR groups via z.lazy)

package/dist/index.d.ts

@@ -25,6 +25,7 @@ export * from "./types/evo-notifications";
 export * from "./types/evo-campaigns";
 export * from "./types/evo-task-runner";
 export * from "./types/hub-automation";
+export * from "./types/domain-events";
 export * from "./types/evo-integrations";
 export * from "./types/nex-customers";
 export * from "./types/nex-tenants";

package/dist/index.js

@@ -42,6 +42,7 @@ __exportStar(require("./types/evo-notifications"), exports);
 __exportStar(require("./types/evo-campaigns"), exports);
 __exportStar(require("./types/evo-task-runner"), exports);
 __exportStar(require("./types/hub-automation"), exports);
+__exportStar(require("./types/domain-events"), exports);
 __exportStar(require("./types/evo-integrations"), exports);
 __exportStar(require("./types/nex-customers"), exports);
 __exportStar(require("./types/nex-tenants"), exports);

package/dist/index.ts

@@ -26,6 +26,7 @@ export * from "./types/evo-notifications";
 export * from "./types/evo-campaigns";
 export * from "./types/evo-task-runner";
 export * from "./types/hub-automation";
+export * from "./types/domain-events";
 export * from "./types/evo-integrations";
 export * from "./types/nex-customers";
 export * from "./types/nex-tenants";

package/dist/types/domain-events/index.d.ts

@@ -0,0 +1,45 @@
+/** Topico central: todo emitDomainEvent() publica aqui (envelope canonico). */
+export declare const DOMAIN_EVENTS_TOPIC: "evo-domain-events";
+/** Versao do contrato do envelope, carimbada em `api_version`. */
+export declare const DOMAIN_EVENT_API_VERSION: "2026-07-20";
+/**
+ * `user`       — escrita organica de um humano (userRef = users/<uid>).
+ * `system`     — sync/integracao (userRef ausente ou users/system).
+ * `automation` — escrita feita pela plataforma (users/hub-automation,
+ *                users/hubia-v1). E o sinal que corta o self-loop no consumidor
+ *                (Camada 1: allowlist actor_kinds, default ['user']).
+ */
+export type DomainEventActorKind = "user" | "system" | "automation";
+export interface IDomainEventActor {
+    kind: DomainEventActorKind;
+    /** uid do usuario, nome da automacao (hub-automation/hubia-v1) ou null/system. */
+    id: string | null;
+}
+export interface IDomainEventResource {
+    /** tenant (clinica) dono do recurso — chave de scoping do consumidor. */
+    tenant: string;
+    /** ex.: 'appointment', 'lead', 'patient'. */
+    kind: "appointment" | "lead" | "patient" | string;
+    id: string;
+    /** caminho Firestore do recurso, quando aplicavel. */
+    path?: string | null;
+    /** hierarquia (ex.: calendar_id do appointment) para reconstruir o alvo. */
+    parent?: {
+        calendar_id?: string;
+    } | null;
+}
+/**
+ * Envelope canonico de um evento de dominio. Publicado em DOMAIN_EVENTS_TOPIC.
+ * `id` (evt_<uuid>) e a chave de idempotencia/dedup usada pelo consumidor.
+ * `data` carrega a transicao SEMANTICA (before/after/changed_fields), nao um
+ * diff cru de CRUD.
+ */
+export interface IDomainEvent {
+    id: string;
+    type: string;
+    api_version: string;
+    occurred_at: string;
+    actor: IDomainEventActor;
+    resource: IDomainEventResource;
+    data: Record<string, unknown>;
+}

package/dist/types/domain-events/index.js

@@ -0,0 +1,18 @@
+"use strict";
+// Domain events (feat-085 evo-events) — canonical BUSINESS event envelope.
+//
+// Substrato transversal: eventos de negocio emitidos nos models (choke points de
+// escrita) e consumidos por N subscribers — o primeiro sendo o hub-automation
+// (trigger.type:'event'); o segundo (futuro) webhooks publicos. Molde do envelope
+// = nexus-webhooks (feat-059), estendido com `actor.kind:'automation'` (derivado
+// do userRef da automacao) e `resource.tenant`/`resource.parent` (multi-tenant +
+// hierarquia calendar/appointment).
+//
+// Regra do repo: `types/` = interfaces TS escritas a mao (sem zod, sem z.infer).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOMAIN_EVENT_API_VERSION = exports.DOMAIN_EVENTS_TOPIC = void 0;
+// ── Constants ──
+/** Topico central: todo emitDomainEvent() publica aqui (envelope canonico). */
+exports.DOMAIN_EVENTS_TOPIC = "evo-domain-events";
+/** Versao do contrato do envelope, carimbada em `api_version`. */
+exports.DOMAIN_EVENT_API_VERSION = "2026-07-20";

package/dist/types/domain-events/index.ts

@@ -0,0 +1,67 @@
+// Domain events (feat-085 evo-events) — canonical BUSINESS event envelope.
+//
+// Substrato transversal: eventos de negocio emitidos nos models (choke points de
+// escrita) e consumidos por N subscribers — o primeiro sendo o hub-automation
+// (trigger.type:'event'); o segundo (futuro) webhooks publicos. Molde do envelope
+// = nexus-webhooks (feat-059), estendido com `actor.kind:'automation'` (derivado
+// do userRef da automacao) e `resource.tenant`/`resource.parent` (multi-tenant +
+// hierarquia calendar/appointment).
+//
+// Regra do repo: `types/` = interfaces TS escritas a mao (sem zod, sem z.infer).
+
+// ── Constants ──
+
+/** Topico central: todo emitDomainEvent() publica aqui (envelope canonico). */
+export const DOMAIN_EVENTS_TOPIC = "evo-domain-events" as const;
+
+/** Versao do contrato do envelope, carimbada em `api_version`. */
+export const DOMAIN_EVENT_API_VERSION = "2026-07-20" as const;
+
+// ── Actor ──
+
+/**
+ * `user`       — escrita organica de um humano (userRef = users/<uid>).
+ * `system`     — sync/integracao (userRef ausente ou users/system).
+ * `automation` — escrita feita pela plataforma (users/hub-automation,
+ *                users/hubia-v1). E o sinal que corta o self-loop no consumidor
+ *                (Camada 1: allowlist actor_kinds, default ['user']).
+ */
+export type DomainEventActorKind = "user" | "system" | "automation";
+
+export interface IDomainEventActor {
+  kind: DomainEventActorKind;
+  /** uid do usuario, nome da automacao (hub-automation/hubia-v1) ou null/system. */
+  id: string | null;
+}
+
+// ── Resource ──
+
+export interface IDomainEventResource {
+  /** tenant (clinica) dono do recurso — chave de scoping do consumidor. */
+  tenant: string;
+  /** ex.: 'appointment', 'lead', 'patient'. */
+  kind: "appointment" | "lead" | "patient" | string;
+  id: string;
+  /** caminho Firestore do recurso, quando aplicavel. */
+  path?: string | null;
+  /** hierarquia (ex.: calendar_id do appointment) para reconstruir o alvo. */
+  parent?: { calendar_id?: string } | null;
+}
+
+// ── Envelope ──
+
+/**
+ * Envelope canonico de um evento de dominio. Publicado em DOMAIN_EVENTS_TOPIC.
+ * `id` (evt_<uuid>) e a chave de idempotencia/dedup usada pelo consumidor.
+ * `data` carrega a transicao SEMANTICA (before/after/changed_fields), nao um
+ * diff cru de CRUD.
+ */
+export interface IDomainEvent {
+  id: string; // evt_<uuid>
+  type: string; // 'agendamento.reagendado', 'agendamento.status_alterado', ...
+  api_version: string;
+  occurred_at: string; // ISO 8601
+  actor: IDomainEventActor;
+  resource: IDomainEventResource;
+  data: Record<string, unknown>;
+}

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

@@ -15,7 +15,14 @@ export interface IAutomationCronTrigger {
 export interface IAutomationWebhookTrigger {
     type: "webhook";
 }
-export type IAutomationTrigger = IAutomationCronTrigger | IAutomationWebhookTrigger;
+export interface IAutomationEventTrigger {
+    type: "event";
+    event: {
+        types: string[];
+        actor_kinds?: Array<"user" | "system" | "automation">;
+    };
+}
+export type IAutomationTrigger = IAutomationCronTrigger | IAutomationWebhookTrigger | IAutomationEventTrigger;
 export type AutomationDateOffsetMode = "calendar" | "business";
 export interface IAutomationDateWindow {
     offset_days: number;
@@ -36,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[];
@@ -48,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";
@@ -183,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

@@ -45,9 +45,25 @@ export interface IAutomationWebhookTrigger {
   type: "webhook";
 }
 
+// feat-085 (F1): fired by a domain event (evo-events). The subscriber
+// (hub_automation_events) glob-matches `event.types` against IDomainEvent.type
+// and discards events whose actor.kind is not in `actor_kinds` (default
+// ['user'] — cuts the automation self-loop; opt-in 'system'/'automation').
+export interface IAutomationEventTrigger {
+  type: "event";
+  event: {
+    // Glob patterns matched against IDomainEvent.type (matcher: 'agendamento.*',
+    // 'agendamento.reagendado', '*').
+    types: string[];
+    // Allowlist of originating actor kinds. Default (omitted) = ['user'].
+    actor_kinds?: Array<"user" | "system" | "automation">;
+  };
+}
+
 export type IAutomationTrigger =
   | IAutomationCronTrigger
-  | IAutomationWebhookTrigger;
+  | IAutomationWebhookTrigger
+  | IAutomationEventTrigger;
 
 // ------------------------------------------------------
 // Selection (F1: appointment target only)
@@ -93,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
@@ -137,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)
@@ -362,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.417",
+  "version": "1.3.423",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",