evo360-types 1.3.417 → 1.3.419

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

@@ -31,6 +31,31 @@ export declare const zAutomationWebhookTriggerSchema: z.ZodObject<{
 }, {
     type: "webhook";
 }>;
+export declare const zAutomationEventTriggerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"event">;
+    event: z.ZodObject<{
+        types: z.ZodArray<z.ZodString, "many">;
+        actor_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["user", "system", "automation"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    }, {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "event";
+    event: {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    };
+}, {
+    type: "event";
+    event: {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    };
+}>;
 export declare const zAutomationTriggerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"cron">;
     cron: z.ZodObject<{
@@ -61,6 +86,30 @@ export declare const zAutomationTriggerSchema: z.ZodDiscriminatedUnion<"type", [
     type: "webhook";
 }, {
     type: "webhook";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"event">;
+    event: z.ZodObject<{
+        types: z.ZodArray<z.ZodString, "many">;
+        actor_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["user", "system", "automation"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    }, {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "event";
+    event: {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    };
+}, {
+    type: "event";
+    event: {
+        types: string[];
+        actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+    };
 }>]>;
 export declare const zAutomationDateOffsetModeSchema: z.ZodEnum<["calendar", "business"]>;
 export declare const zAutomationDateWindowSchema: z.ZodObject<{
@@ -2256,6 +2305,30 @@ export declare const zAutomationRoutineSchema: z.ZodObject<{
         type: "webhook";
     }, {
         type: "webhook";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"event">;
+        event: z.ZodObject<{
+            types: z.ZodArray<z.ZodString, "many">;
+            actor_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["user", "system", "automation"]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        }, {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
+    }, {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
     }>]>;
     selection: z.ZodObject<{
         target: z.ZodLiteral<"appointment">;
@@ -3212,6 +3285,12 @@ export declare const zAutomationRoutineSchema: z.ZodObject<{
         };
     } | {
         type: "webhook";
+    } | {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
     };
     selection: {
         appointment: {
@@ -3387,6 +3466,12 @@ export declare const zAutomationRoutineSchema: z.ZodObject<{
         };
     } | {
         type: "webhook";
+    } | {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
     };
     selection: {
         appointment: {
@@ -3587,6 +3672,30 @@ export declare const zAutomationRoutineWriteSchema: z.ZodObject<{
         type: "webhook";
     }, {
         type: "webhook";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"event">;
+        event: z.ZodObject<{
+            types: z.ZodArray<z.ZodString, "many">;
+            actor_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["user", "system", "automation"]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        }, {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
+    }, {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
     }>]>;
     selection: z.ZodObject<{
         target: z.ZodLiteral<"appointment">;
@@ -4505,6 +4614,12 @@ export declare const zAutomationRoutineWriteSchema: z.ZodObject<{
         };
     } | {
         type: "webhook";
+    } | {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
     };
     selection: {
         appointment: {
@@ -4665,6 +4780,12 @@ export declare const zAutomationRoutineWriteSchema: z.ZodObject<{
         };
     } | {
         type: "webhook";
+    } | {
+        type: "event";
+        event: {
+            types: string[];
+            actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+        };
     };
     selection: {
         appointment: {
@@ -4852,6 +4973,30 @@ export declare const zAutomationRoutineUpdateRequestSchema: z.ZodObject<{
             type: "webhook";
         }, {
             type: "webhook";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"event">;
+            event: z.ZodObject<{
+                types: z.ZodArray<z.ZodString, "many">;
+                actor_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["user", "system", "automation"]>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            }, {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            type: "event";
+            event: {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            };
+        }, {
+            type: "event";
+            event: {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            };
         }>]>;
         selection: z.ZodObject<{
             target: z.ZodLiteral<"appointment">;
@@ -5770,6 +5915,12 @@ export declare const zAutomationRoutineUpdateRequestSchema: z.ZodObject<{
             };
         } | {
             type: "webhook";
+        } | {
+            type: "event";
+            event: {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            };
         };
         selection: {
             appointment: {
@@ -5930,6 +6081,12 @@ export declare const zAutomationRoutineUpdateRequestSchema: z.ZodObject<{
             };
         } | {
             type: "webhook";
+        } | {
+            type: "event";
+            event: {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            };
         };
         selection: {
             appointment: {
@@ -6095,6 +6252,12 @@ export declare const zAutomationRoutineUpdateRequestSchema: z.ZodObject<{
             };
         } | {
             type: "webhook";
+        } | {
+            type: "event";
+            event: {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            };
         };
         selection: {
             appointment: {
@@ -6258,6 +6421,12 @@ export declare const zAutomationRoutineUpdateRequestSchema: z.ZodObject<{
             };
         } | {
             type: "webhook";
+        } | {
+            type: "event";
+            event: {
+                types: string[];
+                actor_kinds?: ("user" | "system" | "automation")[] | undefined;
+            };
         };
         selection: {
             appointment: {

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.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)

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,
 ]);
 
 // ------------------------------------------------------

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/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;

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)

package/package.json

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