evo360-types 1.3.705 → 1.3.711

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

@@ -2,6 +2,7 @@
 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.zAutomationPatientSelectionSchema = exports.zAutomationLeadSelectionSchema = exports.zAutomationAppointmentSelectionSchema = exports.zAutomationAppointmentModeSchema = exports.zAutomationTimeOfDayRangeSchema = exports.zAutomationTimeOfDaySchema = exports.zAutomationDateWindowSchema = exports.zAutomationDateOffsetModeSchema = exports.zAutomationTriggerSchema = exports.zAutomationEventTriggerSchema = exports.zAutomationWebhookTriggerSchema = exports.zAutomationCronTriggerSchema = void 0;
 const zod_1 = require("zod");
+const domain_events_1 = require("../../types/domain-events");
 const zod_schemas_1 = require("../evo-task/zod-schemas");
 // ------------------------------------------------------
 // Trigger (cron sweep | webhook reverse-trigger)
@@ -26,6 +27,8 @@ exports.zAutomationEventTriggerSchema = zod_1.z.object({
         actor_kinds: zod_1.z
             .array(zod_1.z.enum(["user", "system", "automation"]))
             .optional(),
+        // feat-281: origin exclusion filter (see IAutomationEventTrigger).
+        exclude_origins: zod_1.z.array(zod_1.z.enum(domain_events_1.DOMAIN_EVENT_ORIGINS)).optional(),
     }),
 });
 exports.zAutomationTriggerSchema = zod_1.z.discriminatedUnion("type", [

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

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DOMAIN_EVENT_ORIGINS } from "../../types/domain-events";
 import {
   zTaskAutoHandlerSchema,
   zTaskRetryPolicySchema,
@@ -30,6 +31,8 @@ export const zAutomationEventTriggerSchema = z.object({
     actor_kinds: z
       .array(z.enum(["user", "system", "automation"]))
       .optional(),
+    // feat-281: origin exclusion filter (see IAutomationEventTrigger).
+    exclude_origins: z.array(z.enum(DOMAIN_EVENT_ORIGINS)).optional(),
   }),
 });
 

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

@@ -15,6 +15,22 @@ export interface IDomainEventActor {
     /** uid do usuario, nome da automacao (hub-automation/hubia-v1) ou null/system. */
     id: string | null;
 }
+/**
+ * Ponto de emissão de um evento de agendamento, carimbado em `data.origin`.
+ * O ator sozinho não distingue: Calendar V2 e sync gravam ambos como `system`.
+ *
+ * `app`           — endpoints do functions-app (agenda nativa, MCP).
+ * `sync`          — sync de agenda externa (run-sync, sync-upsert, batch upsert).
+ * `write_through` — Calendar V2 / actions-dispatcher (agenda externa).
+ * `hubia`         — evo-actions com ator hubia-v1.
+ * `automation`    — evo-actions com ator hub-automation.
+ * `webhook`       — webhook de provedor (Asaas: pagamento confirmado).
+ * `quick_reply`   — ação de agendamento vinda de CTA do paciente.
+ *
+ * Ausente = ponto não mapeado/evento antigo: nenhum filtro o descarta.
+ */
+export declare const DOMAIN_EVENT_ORIGINS: readonly ["app", "sync", "write_through", "hubia", "automation", "webhook", "quick_reply"];
+export type DomainEventOrigin = (typeof DOMAIN_EVENT_ORIGINS)[number];
 export interface IDomainEventResource {
     /** tenant (clinica) dono do recurso — chave de scoping do consumidor. */
     tenant: string;

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

@@ -10,9 +10,33 @@
 //
 // 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;
+exports.DOMAIN_EVENT_ORIGINS = 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";
+// ── Origin (feat-281) ──
+/**
+ * Ponto de emissão de um evento de agendamento, carimbado em `data.origin`.
+ * O ator sozinho não distingue: Calendar V2 e sync gravam ambos como `system`.
+ *
+ * `app`           — endpoints do functions-app (agenda nativa, MCP).
+ * `sync`          — sync de agenda externa (run-sync, sync-upsert, batch upsert).
+ * `write_through` — Calendar V2 / actions-dispatcher (agenda externa).
+ * `hubia`         — evo-actions com ator hubia-v1.
+ * `automation`    — evo-actions com ator hub-automation.
+ * `webhook`       — webhook de provedor (Asaas: pagamento confirmado).
+ * `quick_reply`   — ação de agendamento vinda de CTA do paciente.
+ *
+ * Ausente = ponto não mapeado/evento antigo: nenhum filtro o descarta.
+ */
+exports.DOMAIN_EVENT_ORIGINS = [
+    "app",
+    "sync",
+    "write_through",
+    "hubia",
+    "automation",
+    "webhook",
+    "quick_reply",
+];

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

@@ -34,6 +34,34 @@ export interface IDomainEventActor {
   id: string | null;
 }
 
+// ── Origin (feat-281) ──
+
+/**
+ * Ponto de emissão de um evento de agendamento, carimbado em `data.origin`.
+ * O ator sozinho não distingue: Calendar V2 e sync gravam ambos como `system`.
+ *
+ * `app`           — endpoints do functions-app (agenda nativa, MCP).
+ * `sync`          — sync de agenda externa (run-sync, sync-upsert, batch upsert).
+ * `write_through` — Calendar V2 / actions-dispatcher (agenda externa).
+ * `hubia`         — evo-actions com ator hubia-v1.
+ * `automation`    — evo-actions com ator hub-automation.
+ * `webhook`       — webhook de provedor (Asaas: pagamento confirmado).
+ * `quick_reply`   — ação de agendamento vinda de CTA do paciente.
+ *
+ * Ausente = ponto não mapeado/evento antigo: nenhum filtro o descarta.
+ */
+export const DOMAIN_EVENT_ORIGINS = [
+  "app",
+  "sync",
+  "write_through",
+  "hubia",
+  "automation",
+  "webhook",
+  "quick_reply",
+] as const;
+
+export type DomainEventOrigin = (typeof DOMAIN_EVENT_ORIGINS)[number];
+
 // ── Resource ──
 
 export interface IDomainEventResource {

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

@@ -137,6 +137,28 @@ export interface INotificationAttachment {
     /** Conteúdo em base64. <= 64 KB já codificado. */
     content_base64: string;
 }
+/**
+ * feat-254 B1 — anexo de e-mail por referência a um objeto já no storage.
+ *
+ * O front sobe o arquivo por `POST /media/upload` (hub-waba, devolve
+ * `gcs_uri`) e manda só a referência. O backend aceita apenas
+ * `gs://<bucket de mídia>/tenants/<tenant do envio>/...`, valida tipo/extensão
+ * contra a allowlist do e-mail (a mesma dos anexos recebidos) e aplica
+ * 10 arquivos, 10 MiB por arquivo e o total do canal. Falha vira envio
+ * `failed_final` com `attachment_invalid` ou `attachment_limit_exceeded`.
+ */
+export interface INotificationAttachmentRef {
+    /** Nome apresentado ao destinatário; a extensão precisa casar com `content_type`. */
+    filename: string;
+    /** MIME da allowlist do e-mail. Ex.: 'application/pdf'. */
+    content_type: string;
+    /** Tamanho informado pelo front (o backend confere o tamanho real do objeto). */
+    size_bytes?: number;
+    /** `gs://<bucket>/tenants/<tenant>/...` devolvido pelo upload de mídia. */
+    gcs_uri: string;
+}
+/** Item de `attachments[]` do envio: inline legado OU referência (discriminado por `gcs_uri`). */
+export type INotificationAttachmentInput = INotificationAttachment | INotificationAttachmentRef;
 /** Campos compartilhados pelo conteúdo de email novo e de resposta. */
 interface INotificationEmailContentBase {
     /** Versões textuais do corpo livre. */
@@ -185,9 +207,11 @@ export interface INotificationSendPayload {
     quick_reply_actions?: IQuickReplyActionIntent[];
     /**
      * Anexos (feat-160 R6 / F31). Honrado SÓ no canal de e-mail; ignorado pelos
-     * demais providers. 1 anexo, <= 64 KB em base64 — ver `INotificationAttachment`.
+     * demais providers. Inline: 1 anexo, <= 64 KB em base64 — ver
+     * `INotificationAttachment`. feat-254 B1: no e-mail, até 10 itens por
+     * referência (`INotificationAttachmentRef`, 10 MiB cada, total do canal).
      */
-    attachments?: INotificationAttachment[];
+    attachments?: INotificationAttachmentInput[];
     routine?: {
         id: string;
         version?: number | string;

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

@@ -222,6 +222,30 @@ export interface INotificationAttachment {
   content_base64: string;
 }
 
+/**
+ * feat-254 B1 — anexo de e-mail por referência a um objeto já no storage.
+ *
+ * O front sobe o arquivo por `POST /media/upload` (hub-waba, devolve
+ * `gcs_uri`) e manda só a referência. O backend aceita apenas
+ * `gs://<bucket de mídia>/tenants/<tenant do envio>/...`, valida tipo/extensão
+ * contra a allowlist do e-mail (a mesma dos anexos recebidos) e aplica
+ * 10 arquivos, 10 MiB por arquivo e o total do canal. Falha vira envio
+ * `failed_final` com `attachment_invalid` ou `attachment_limit_exceeded`.
+ */
+export interface INotificationAttachmentRef {
+  /** Nome apresentado ao destinatário; a extensão precisa casar com `content_type`. */
+  filename: string;
+  /** MIME da allowlist do e-mail. Ex.: 'application/pdf'. */
+  content_type: string;
+  /** Tamanho informado pelo front (o backend confere o tamanho real do objeto). */
+  size_bytes?: number;
+  /** `gs://<bucket>/tenants/<tenant>/...` devolvido pelo upload de mídia. */
+  gcs_uri: string;
+}
+
+/** Item de `attachments[]` do envio: inline legado OU referência (discriminado por `gcs_uri`). */
+export type INotificationAttachmentInput = INotificationAttachment | INotificationAttachmentRef;
+
 /** Campos compartilhados pelo conteúdo de email novo e de resposta. */
 interface INotificationEmailContentBase {
   /** Versões textuais do corpo livre. */
@@ -285,9 +309,11 @@ export interface INotificationSendPayload {
 
   /**
    * Anexos (feat-160 R6 / F31). Honrado SÓ no canal de e-mail; ignorado pelos
-   * demais providers. 1 anexo, <= 64 KB em base64 — ver `INotificationAttachment`.
+   * demais providers. Inline: 1 anexo, <= 64 KB em base64 — ver
+   * `INotificationAttachment`. feat-254 B1: no e-mail, até 10 itens por
+   * referência (`INotificationAttachmentRef`, 10 MiB cada, total do canal).
    */
-  attachments?: INotificationAttachment[];
+  attachments?: INotificationAttachmentInput[];
 
   // Optional business context
   routine?: {

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

@@ -63,6 +63,11 @@ export declare const TaskAutoHandlerEnum: {
     readonly CampaignDispatchBatch: "campaign.dispatch_batch";
     readonly TelemedicineJoinReminder: "telemedicine_join_reminder";
     readonly AppointmentInvoice: "appointment_invoice";
+    readonly AppointmentCreated: "appointment_created";
+    readonly AppointmentRescheduled: "appointment_rescheduled";
+    readonly AppointmentCancelled: "appointment_cancelled";
+    readonly AppointmentPayment: "appointment_payment";
+    readonly AppointmentPaymentDone: "appointment_payment_done";
 };
 export type TaskAutoHandler = (typeof TaskAutoHandlerEnum)[keyof typeof TaskAutoHandlerEnum];
 export declare const TaskRetryStrategyEnum: {

package/dist/types/evo-task/index.js

@@ -145,6 +145,20 @@ exports.TaskAutoHandlerEnum = {
     // `appointment_invoice.execute_requests`.
     // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
     AppointmentInvoice: "appointment_invoice",
+    // feat-281: avisos de ciclo de vida e financeiros da consulta — variants do
+    // executor único do lembrete (functions-integrations), cada um lendo a chave
+    // homônima de `notification_config.configs` (presencial × telemedicina na
+    // hora do envio). Created/rescheduled/cancelled são informativos (sem CTAs
+    // de confirmar/remarcar); cancelled só envia para consulta cancelada ou
+    // lápide. Payment exige link de pagamento ativo vinculado à consulta
+    // (`payment_link_unavailable` sem ele) e entrega o link `/qr`
+    // (`billing_link`). Tópicos: `<valor>.execute_requests`.
+    // Espelhados à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
+    AppointmentCreated: "appointment_created",
+    AppointmentRescheduled: "appointment_rescheduled",
+    AppointmentCancelled: "appointment_cancelled",
+    AppointmentPayment: "appointment_payment",
+    AppointmentPaymentDone: "appointment_payment_done",
 };
 // ----- Retry policy
 exports.TaskRetryStrategyEnum = {

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

@@ -156,6 +156,20 @@ export const TaskAutoHandlerEnum = {
   // `appointment_invoice.execute_requests`.
   // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
   AppointmentInvoice: "appointment_invoice",
+  // feat-281: avisos de ciclo de vida e financeiros da consulta — variants do
+  // executor único do lembrete (functions-integrations), cada um lendo a chave
+  // homônima de `notification_config.configs` (presencial × telemedicina na
+  // hora do envio). Created/rescheduled/cancelled são informativos (sem CTAs
+  // de confirmar/remarcar); cancelled só envia para consulta cancelada ou
+  // lápide. Payment exige link de pagamento ativo vinculado à consulta
+  // (`payment_link_unavailable` sem ele) e entrega o link `/qr`
+  // (`billing_link`). Tópicos: `<valor>.execute_requests`.
+  // Espelhados à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
+  AppointmentCreated: "appointment_created",
+  AppointmentRescheduled: "appointment_rescheduled",
+  AppointmentCancelled: "appointment_cancelled",
+  AppointmentPayment: "appointment_payment",
+  AppointmentPaymentDone: "appointment_payment_done",
 } as const;
 
 export type TaskAutoHandler =

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

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 import type { TaskAutoHandler, ITaskRetryPolicy, ITaskOnFailure } from "../evo-task";
+import type { DomainEventOrigin } from "../domain-events";
 export declare const HubAutomationPermissions: {
     readonly Read: "hub_automation_read";
     readonly Write: "hub_automation_write";
@@ -20,6 +21,7 @@ export interface IAutomationEventTrigger {
     event: {
         types: string[];
         actor_kinds?: Array<"user" | "system" | "automation">;
+        exclude_origins?: DomainEventOrigin[];
     };
 }
 export type IAutomationTrigger = IAutomationCronTrigger | IAutomationWebhookTrigger | IAutomationEventTrigger;

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

@@ -1,6 +1,7 @@
 export * from "./fb_collections";
 
 import type { TaskAutoHandler, ITaskRetryPolicy, ITaskOnFailure } from "../evo-task";
+import type { DomainEventOrigin } from "../domain-events";
 
 // ======================================================
 // hub-automation
@@ -57,6 +58,10 @@ export interface IAutomationEventTrigger {
     types: string[];
     // Allowlist of originating actor kinds. Default (omitted) = ['user'].
     actor_kinds?: Array<"user" | "system" | "automation">;
+    // feat-281: discards events whose `data.origin` is in this list (e.g.
+    // ['sync'] to ignore appointments imported by an external calendar sync).
+    // Omitted/empty = no filter. Events without `data.origin` are never discarded.
+    exclude_origins?: DomainEventOrigin[];
   };
 }
 

package/package.json

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