evo360-types 1.3.717 → 1.3.721

package/dist/apps/evo-chat/forward/zod-schemas.d.ts

@@ -1,11 +1,11 @@
 import { z } from "zod";
 export declare const zForwardBatchStatusSchema: z.ZodEnum<["running", "done", "done_with_failures"]>;
 export declare const zForwardItemStatusSchema: z.ZodEnum<["pending", "sending", "sent", "failed", "skipped"]>;
-export declare const zForwardSkipReasonSchema: z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported"]>;
+export declare const zForwardSkipReasonSchema: z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported", "attachments_over_limit", "recipient_address_missing", "email_identity_conflict"]>;
 export declare const zForwardFailReasonSchema: z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>;
-export declare const zForwardItemReasonSchema: z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>;
+export declare const zForwardItemReasonSchema: z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported", "attachments_over_limit", "recipient_address_missing", "email_identity_conflict"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>;
 export declare const zForwardContentKindSchema: z.ZodEnum<["text", "image", "video", "audio", "document"]>;
-export declare const zForwardRecipientProviderSchema: z.ZodEnum<["hub-waba", "hub-instagram"]>;
+export declare const zForwardRecipientProviderSchema: z.ZodString;
 export declare const zForwardSpecialKindSchema: z.ZodEnum<["doctor", "secretary", "employee"]>;
 export declare const zForwardActorSchema: z.ZodObject<{
     user_id: z.ZodString;
@@ -48,24 +48,27 @@ export declare const zForwardRecipientSchema: z.ZodObject<{
     contact_name: z.ZodString;
     channel_id: z.ZodString;
     channel_type: z.ZodString;
-    provider: z.ZodEnum<["hub-waba", "hub-instagram"]>;
+    provider: z.ZodString;
     special_kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<["doctor", "secretary", "employee"]>>>;
+    email_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    provider: "hub-waba" | "hub-instagram";
+    provider: string;
     channel_id: string;
     contact_id: string;
     thread_id: string;
     channel_type: string;
     contact_name: string;
     special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+    email_address?: string | null | undefined;
 }, {
-    provider: "hub-waba" | "hub-instagram";
+    provider: string;
     channel_id: string;
     contact_id: string;
     thread_id: string;
     channel_type: string;
     contact_name: string;
     special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+    email_address?: string | null | undefined;
 }>;
 export declare const zForwardCountsSchema: z.ZodObject<{
     total: z.ZodNumber;
@@ -136,24 +139,27 @@ export declare const zForwardBatchSchema: z.ZodObject<{
         contact_name: z.ZodString;
         channel_id: z.ZodString;
         channel_type: z.ZodString;
-        provider: z.ZodEnum<["hub-waba", "hub-instagram"]>;
+        provider: z.ZodString;
         special_kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<["doctor", "secretary", "employee"]>>>;
+        email_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        provider: "hub-waba" | "hub-instagram";
+        provider: string;
         channel_id: string;
         contact_id: string;
         thread_id: string;
         channel_type: string;
         contact_name: string;
         special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+        email_address?: string | null | undefined;
     }, {
-        provider: "hub-waba" | "hub-instagram";
+        provider: string;
         channel_id: string;
         contact_id: string;
         thread_id: string;
         channel_type: string;
         contact_name: string;
         special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+        email_address?: string | null | undefined;
     }>, "many">;
     status: z.ZodEnum<["running", "done", "done_with_failures"]>;
     counts: z.ZodObject<{
@@ -185,6 +191,7 @@ export declare const zForwardBatchSchema: z.ZodObject<{
         finished_at?: Date | null | undefined;
     }>>>;
     finished_at: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    email_subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -238,24 +245,27 @@ export declare const zForwardBatchSchema: z.ZodObject<{
         contact_name: z.ZodString;
         channel_id: z.ZodString;
         channel_type: z.ZodString;
-        provider: z.ZodEnum<["hub-waba", "hub-instagram"]>;
+        provider: z.ZodString;
         special_kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<["doctor", "secretary", "employee"]>>>;
+        email_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        provider: "hub-waba" | "hub-instagram";
+        provider: string;
         channel_id: string;
         contact_id: string;
         thread_id: string;
         channel_type: string;
         contact_name: string;
         special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+        email_address?: string | null | undefined;
     }, {
-        provider: "hub-waba" | "hub-instagram";
+        provider: string;
         channel_id: string;
         contact_id: string;
         thread_id: string;
         channel_type: string;
         contact_name: string;
         special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+        email_address?: string | null | undefined;
     }>, "many">;
     status: z.ZodEnum<["running", "done", "done_with_failures"]>;
     counts: z.ZodObject<{
@@ -287,6 +297,7 @@ export declare const zForwardBatchSchema: z.ZodObject<{
         finished_at?: Date | null | undefined;
     }>>>;
     finished_at: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    email_subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -340,24 +351,27 @@ export declare const zForwardBatchSchema: z.ZodObject<{
         contact_name: z.ZodString;
         channel_id: z.ZodString;
         channel_type: z.ZodString;
-        provider: z.ZodEnum<["hub-waba", "hub-instagram"]>;
+        provider: z.ZodString;
         special_kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<["doctor", "secretary", "employee"]>>>;
+        email_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        provider: "hub-waba" | "hub-instagram";
+        provider: string;
         channel_id: string;
         contact_id: string;
         thread_id: string;
         channel_type: string;
         contact_name: string;
         special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+        email_address?: string | null | undefined;
     }, {
-        provider: "hub-waba" | "hub-instagram";
+        provider: string;
         channel_id: string;
         contact_id: string;
         thread_id: string;
         channel_type: string;
         contact_name: string;
         special_kind?: "employee" | "doctor" | "secretary" | null | undefined;
+        email_address?: string | null | undefined;
     }>, "many">;
     status: z.ZodEnum<["running", "done", "done_with_failures"]>;
     counts: z.ZodObject<{
@@ -389,6 +403,7 @@ export declare const zForwardBatchSchema: z.ZodObject<{
         finished_at?: Date | null | undefined;
     }>>>;
     finished_at: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    email_subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;
 export declare const zForwardItemSchema: z.ZodObject<{
     item_id: z.ZodString;
@@ -400,10 +415,12 @@ export declare const zForwardItemSchema: z.ZodObject<{
     message_id: z.ZodNullable<z.ZodString>;
     content_kind: z.ZodEnum<["text", "image", "video", "audio", "document"]>;
     status: z.ZodEnum<["pending", "sending", "sent", "failed", "skipped"]>;
-    reason: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>>>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported", "attachments_over_limit", "recipient_address_missing", "email_identity_conflict"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     error_code: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     dest_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attachment_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    dest_notification_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sent_at: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
     updated_at: z.ZodOptional<z.ZodDate>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -416,10 +433,12 @@ export declare const zForwardItemSchema: z.ZodObject<{
     message_id: z.ZodNullable<z.ZodString>;
     content_kind: z.ZodEnum<["text", "image", "video", "audio", "document"]>;
     status: z.ZodEnum<["pending", "sending", "sent", "failed", "skipped"]>;
-    reason: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>>>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported", "attachments_over_limit", "recipient_address_missing", "email_identity_conflict"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     error_code: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     dest_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attachment_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    dest_notification_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sent_at: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
     updated_at: z.ZodOptional<z.ZodDate>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -432,10 +451,12 @@ export declare const zForwardItemSchema: z.ZodObject<{
     message_id: z.ZodNullable<z.ZodString>;
     content_kind: z.ZodEnum<["text", "image", "video", "audio", "document"]>;
     status: z.ZodEnum<["pending", "sending", "sent", "failed", "skipped"]>;
-    reason: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>>>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<["window_closed", "type_not_supported", "media_too_large", "media_unavailable", "channel_not_supported", "attachments_over_limit", "recipient_address_missing", "email_identity_conflict"]>, z.ZodEnum<["provider_error", "window_closed", "send_budget_exceeded", "interrupted"]>]>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     error_code: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     dest_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attachment_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    dest_notification_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sent_at: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
     updated_at: z.ZodOptional<z.ZodDate>;
 }, z.ZodTypeAny, "passthrough">>;
@@ -462,6 +483,8 @@ export declare const zMessageForwardSchema: z.ZodObject<{
         user_id: string;
     }>;
     forwarded_at: z.ZodDate;
+    source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     forward_id: z.ZodString;
     item_id: z.ZodString;
@@ -484,6 +507,8 @@ export declare const zMessageForwardSchema: z.ZodObject<{
         user_id: string;
     }>;
     forwarded_at: z.ZodDate;
+    source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     forward_id: z.ZodString;
     item_id: z.ZodString;
@@ -506,6 +531,8 @@ export declare const zMessageForwardSchema: z.ZodObject<{
         user_id: string;
     }>;
     forwarded_at: z.ZodDate;
+    source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, z.ZodTypeAny, "passthrough">>;
 /**
  * `.strict()` de propósito: o payload nunca carrega `gcs_uri` nem conteúdo. A
@@ -520,18 +547,23 @@ export declare const zForwardCreateRequestSchema: z.ZodEffects<z.ZodObject<{
     recipients: z.ZodArray<z.ZodObject<{
         thread_id: z.ZodString;
         channel_id: z.ZodString;
+        email_address: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         channel_id: string;
         thread_id: string;
+        email_address?: string | undefined;
     }, {
         channel_id: string;
         thread_id: string;
+        email_address?: string | undefined;
     }>, "many">;
+    email_subject: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     dry_run: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     recipients: {
         channel_id: string;
         thread_id: string;
+        email_address?: string | undefined;
     }[];
     message_ids: string[];
     source_thread_id: string;
@@ -539,10 +571,12 @@ export declare const zForwardCreateRequestSchema: z.ZodEffects<z.ZodObject<{
     client_request_id: string;
     dry_run?: boolean | undefined;
     intro_text?: string | null | undefined;
+    email_subject?: string | undefined;
 }, {
     recipients: {
         channel_id: string;
         thread_id: string;
+        email_address?: string | undefined;
     }[];
     message_ids: string[];
     source_thread_id: string;
@@ -550,10 +584,12 @@ export declare const zForwardCreateRequestSchema: z.ZodEffects<z.ZodObject<{
     client_request_id: string;
     dry_run?: boolean | undefined;
     intro_text?: string | null | undefined;
+    email_subject?: string | undefined;
 }>, {
     recipients: {
         channel_id: string;
         thread_id: string;
+        email_address?: string | undefined;
     }[];
     message_ids: string[];
     source_thread_id: string;
@@ -561,10 +597,12 @@ export declare const zForwardCreateRequestSchema: z.ZodEffects<z.ZodObject<{
     client_request_id: string;
     dry_run?: boolean | undefined;
     intro_text?: string | null | undefined;
+    email_subject?: string | undefined;
 }, {
     recipients: {
         channel_id: string;
         thread_id: string;
+        email_address?: string | undefined;
     }[];
     message_ids: string[];
     source_thread_id: string;
@@ -572,5 +610,6 @@ export declare const zForwardCreateRequestSchema: z.ZodEffects<z.ZodObject<{
     client_request_id: string;
     dry_run?: boolean | undefined;
     intro_text?: string | null | undefined;
+    email_subject?: string | undefined;
 }>;
 export type ForwardCreateRequest = z.infer<typeof zForwardCreateRequestSchema>;

package/dist/apps/evo-chat/forward/zod-schemas.js

@@ -13,6 +13,9 @@ exports.zForwardSkipReasonSchema = zod_1.z.enum([
     "media_too_large",
     "media_unavailable",
     "channel_not_supported",
+    "attachments_over_limit",
+    "recipient_address_missing",
+    "email_identity_conflict",
 ]);
 exports.zForwardFailReasonSchema = zod_1.z.enum([
     "provider_error",
@@ -22,7 +25,7 @@ exports.zForwardFailReasonSchema = zod_1.z.enum([
 ]);
 exports.zForwardItemReasonSchema = zod_1.z.union([exports.zForwardSkipReasonSchema, exports.zForwardFailReasonSchema]);
 exports.zForwardContentKindSchema = zod_1.z.enum(["text", "image", "video", "audio", "document"]);
-exports.zForwardRecipientProviderSchema = zod_1.z.enum(["hub-waba", "hub-instagram"]);
+exports.zForwardRecipientProviderSchema = zod_1.z.string().min(1);
 exports.zForwardSpecialKindSchema = zod_1.z.enum(["doctor", "secretary", "employee"]);
 // ── Partes ──
 exports.zForwardActorSchema = zod_1.z.object({
@@ -46,6 +49,7 @@ exports.zForwardRecipientSchema = zod_1.z.object({
     channel_type: zod_1.z.string(),
     provider: exports.zForwardRecipientProviderSchema,
     special_kind: exports.zForwardSpecialKindSchema.nullable().optional(),
+    email_address: zod_1.z.string().nullable().optional(),
 });
 exports.zForwardCountsSchema = zod_1.z.object({
     total: zod_1.z.number().int().nonnegative(),
@@ -74,6 +78,7 @@ exports.zForwardBatchSchema = zod_schemas_1.zFireDocSchema
     }))
         .optional(),
     finished_at: zod_1.z.coerce.date().nullable().optional(),
+    email_subject: zod_1.z.string().nullable().optional(),
 })
     .passthrough();
 exports.zForwardItemSchema = zod_1.z
@@ -91,6 +96,8 @@ exports.zForwardItemSchema = zod_1.z
     error: zod_1.z.string().nullable().optional(),
     error_code: zod_1.z.number().nullable().optional(),
     dest_message_id: zod_1.z.string().nullable().optional(),
+    attachment_index: zod_1.z.number().int().positive().nullable().optional(),
+    dest_notification_message_id: zod_1.z.string().nullable().optional(),
     sent_at: zod_1.z.coerce.date().nullable().optional(),
     updated_at: zod_1.z.coerce.date().optional(),
 })
@@ -110,6 +117,8 @@ exports.zMessageForwardSchema = zod_1.z
     source_created_at: zod_1.z.coerce.date(),
     forwarded_by: exports.zForwardActorSchema,
     forwarded_at: zod_1.z.coerce.date(),
+    source_message_ids: zod_1.z.array(zod_1.z.string()).max(forward_1.FORWARD_MAX_MESSAGES).optional(),
+    item_ids: zod_1.z.array(zod_1.z.string()).max(forward_1.FORWARD_MAX_MESSAGES).optional(),
 })
     .passthrough();
 // ── Request do `POST /forwards` ──
@@ -129,10 +138,18 @@ exports.zForwardCreateRequestSchema = zod_1.z
         .object({
         thread_id: zod_1.z.string().min(1),
         channel_id: zod_1.z.string().min(1),
+        email_address: zod_1.z.string().trim().toLowerCase().email().max(254).optional(),
     })
         .strict())
         .min(1)
         .max(forward_1.FORWARD_MAX_RECIPIENTS),
+    email_subject: zod_1.z
+        .string()
+        .trim()
+        .min(1)
+        .max(forward_1.FORWARD_EMAIL_SUBJECT_MAX_CHARS)
+        .refine((s) => !/[\r\n]/.test(s), { message: "email_subject must be a single line" })
+        .optional(),
     dry_run: zod_1.z.boolean().optional(),
 })
     .strict()

package/dist/apps/evo-chat/forward/zod-schemas.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { zFireDocSchema } from "../../shared/zod-schemas";
 import {
+  FORWARD_EMAIL_SUBJECT_MAX_CHARS,
   FORWARD_INTRO_MAX_CHARS,
   FORWARD_MAX_MESSAGES,
   FORWARD_MAX_RECIPIENTS,
@@ -16,6 +17,9 @@ export const zForwardSkipReasonSchema = z.enum([
   "media_too_large",
   "media_unavailable",
   "channel_not_supported",
+  "attachments_over_limit",
+  "recipient_address_missing",
+  "email_identity_conflict",
 ]);
 export const zForwardFailReasonSchema = z.enum([
   "provider_error",
@@ -25,7 +29,7 @@ export const zForwardFailReasonSchema = z.enum([
 ]);
 export const zForwardItemReasonSchema = z.union([zForwardSkipReasonSchema, zForwardFailReasonSchema]);
 export const zForwardContentKindSchema = z.enum(["text", "image", "video", "audio", "document"]);
-export const zForwardRecipientProviderSchema = z.enum(["hub-waba", "hub-instagram"]);
+export const zForwardRecipientProviderSchema = z.string().min(1);
 export const zForwardSpecialKindSchema = z.enum(["doctor", "secretary", "employee"]);
 
 // ── Partes ──
@@ -53,6 +57,7 @@ export const zForwardRecipientSchema = z.object({
   channel_type: z.string(),
   provider: zForwardRecipientProviderSchema,
   special_kind: zForwardSpecialKindSchema.nullable().optional(),
+  email_address: z.string().nullable().optional(),
 });
 
 export const zForwardCountsSchema = z.object({
@@ -87,6 +92,7 @@ export const zForwardBatchSchema = zFireDocSchema
       )
       .optional(),
     finished_at: z.coerce.date().nullable().optional(),
+    email_subject: z.string().nullable().optional(),
   })
   .passthrough();
 
@@ -105,6 +111,8 @@ export const zForwardItemSchema = z
     error: z.string().nullable().optional(),
     error_code: z.number().nullable().optional(),
     dest_message_id: z.string().nullable().optional(),
+    attachment_index: z.number().int().positive().nullable().optional(),
+    dest_notification_message_id: z.string().nullable().optional(),
     sent_at: z.coerce.date().nullable().optional(),
     updated_at: z.coerce.date().optional(),
   })
@@ -125,6 +133,8 @@ export const zMessageForwardSchema = z
     source_created_at: z.coerce.date(),
     forwarded_by: zForwardActorSchema,
     forwarded_at: z.coerce.date(),
+    source_message_ids: z.array(z.string()).max(FORWARD_MAX_MESSAGES).optional(),
+    item_ids: z.array(z.string()).max(FORWARD_MAX_MESSAGES).optional(),
   })
   .passthrough();
 
@@ -147,11 +157,19 @@ export const zForwardCreateRequestSchema = z
           .object({
             thread_id: z.string().min(1),
             channel_id: z.string().min(1),
+            email_address: z.string().trim().toLowerCase().email().max(254).optional(),
           })
           .strict(),
       )
       .min(1)
       .max(FORWARD_MAX_RECIPIENTS),
+    email_subject: z
+      .string()
+      .trim()
+      .min(1)
+      .max(FORWARD_EMAIL_SUBJECT_MAX_CHARS)
+      .refine((s) => !/[\r\n]/.test(s), { message: "email_subject must be a single line" })
+      .optional(),
     dry_run: z.boolean().optional(),
   })
   .strict()

package/dist/apps/evo-chat/thread-message/zod-schemas.d.ts

@@ -232,6 +232,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         forward_id: z.ZodString;
         item_id: z.ZodString;
@@ -254,6 +256,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         forward_id: z.ZodString;
         item_id: z.ZodString;
@@ -276,6 +280,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, z.ZodTypeAny, "passthrough">>>;
     forward_count: z.ZodOptional<z.ZodNumber>;
     provider_message_id: z.ZodOptional<z.ZodString>;
@@ -485,6 +491,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         forward_id: z.ZodString;
         item_id: z.ZodString;
@@ -507,6 +515,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         forward_id: z.ZodString;
         item_id: z.ZodString;
@@ -529,6 +539,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, z.ZodTypeAny, "passthrough">>>;
     forward_count: z.ZodOptional<z.ZodNumber>;
     provider_message_id: z.ZodOptional<z.ZodString>;
@@ -738,6 +750,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         forward_id: z.ZodString;
         item_id: z.ZodString;
@@ -760,6 +774,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         forward_id: z.ZodString;
         item_id: z.ZodString;
@@ -782,6 +798,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
             user_id: string;
         }>;
         forwarded_at: z.ZodDate;
+        source_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        item_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, z.ZodTypeAny, "passthrough">>>;
     forward_count: z.ZodOptional<z.ZodNumber>;
     provider_message_id: z.ZodOptional<z.ZodString>;

package/dist/apps/evo-csq/zod-schemas.d.ts

@@ -2355,7 +2355,7 @@ export declare const zCsqAppointmentEventSchema: z.ZodObject<{
     supersedes: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-    actor: "automation" | "lead" | "hubia" | "attendant";
+    actor: "lead" | "automation" | "hubia" | "attendant";
     evidence: {
         message_id: string;
         ticket_id: string;
@@ -2370,7 +2370,7 @@ export declare const zCsqAppointmentEventSchema: z.ZodObject<{
     supersedes?: string | undefined;
 }, {
     kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-    actor: "automation" | "lead" | "hubia" | "attendant";
+    actor: "lead" | "automation" | "hubia" | "attendant";
     evidence: {
         message_id: string;
         ticket_id: string;
@@ -2528,7 +2528,7 @@ export declare const zCsqDetectorReportSchema: z.ZodObject<{
         supersedes: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-        actor: "automation" | "lead" | "hubia" | "attendant";
+        actor: "lead" | "automation" | "hubia" | "attendant";
         evidence: {
             message_id: string;
             ticket_id: string;
@@ -2543,7 +2543,7 @@ export declare const zCsqDetectorReportSchema: z.ZodObject<{
         supersedes?: string | undefined;
     }, {
         kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-        actor: "automation" | "lead" | "hubia" | "attendant";
+        actor: "lead" | "automation" | "hubia" | "attendant";
         evidence: {
             message_id: string;
             ticket_id: string;
@@ -2619,7 +2619,7 @@ export declare const zCsqDetectorReportSchema: z.ZodObject<{
     time_mismatch?: number | undefined;
     event_list?: {
         kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-        actor: "automation" | "lead" | "hubia" | "attendant";
+        actor: "lead" | "automation" | "hubia" | "attendant";
         evidence: {
             message_id: string;
             ticket_id: string;
@@ -2660,7 +2660,7 @@ export declare const zCsqDetectorReportSchema: z.ZodObject<{
     time_mismatch?: number | undefined;
     event_list?: {
         kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-        actor: "automation" | "lead" | "hubia" | "attendant";
+        actor: "lead" | "automation" | "hubia" | "attendant";
         evidence: {
             message_id: string;
             ticket_id: string;
@@ -2760,7 +2760,7 @@ export declare const zCsqTranscriptMessageSchema: z.ZodObject<{
     message_id: string;
     ticket_id: string;
     ts: Date;
-    author_kind: "human" | "automation" | "lead" | "hubia" | "event" | "note";
+    author_kind: "human" | "lead" | "automation" | "hubia" | "event" | "note";
     author_label: string;
     unattributed?: boolean | undefined;
 }, {
@@ -2768,7 +2768,7 @@ export declare const zCsqTranscriptMessageSchema: z.ZodObject<{
     text: string;
     message_id: string;
     ticket_id: string;
-    author_kind: "human" | "automation" | "lead" | "hubia" | "event" | "note";
+    author_kind: "human" | "lead" | "automation" | "hubia" | "event" | "note";
     author_label: string;
     ts?: unknown;
     unattributed?: boolean | undefined;
@@ -7683,7 +7683,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -7698,7 +7698,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -7774,7 +7774,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
         time_mismatch?: number | undefined;
         event_list?: {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -7815,7 +7815,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
         time_mismatch?: number | undefined;
         event_list?: {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -10148,7 +10148,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -10163,7 +10163,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -10239,7 +10239,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
         time_mismatch?: number | undefined;
         event_list?: {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -10280,7 +10280,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
         time_mismatch?: number | undefined;
         event_list?: {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12613,7 +12613,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12628,7 +12628,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12704,7 +12704,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
         time_mismatch?: number | undefined;
         event_list?: {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12745,7 +12745,7 @@ export declare const zCsqLeadReportSchema: z.ZodObject<{
         time_mismatch?: number | undefined;
         event_list?: {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12847,7 +12847,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12862,7 +12862,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12950,7 +12950,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -12965,7 +12965,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -13053,7 +13053,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -13068,7 +13068,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -13169,7 +13169,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -13184,7 +13184,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -13287,7 +13287,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;
@@ -13302,7 +13302,7 @@ export declare const zCsqDryRunResultSchema: z.ZodObject<{
             supersedes?: string | undefined;
         }, {
             kind: "appointment_cancelled" | "slot_offered" | "slot_accepted" | "appointment_confirmed" | "reschedule_requested";
-            actor: "automation" | "lead" | "hubia" | "attendant";
+            actor: "lead" | "automation" | "hubia" | "attendant";
             evidence: {
                 message_id: string;
                 ticket_id: string;

package/dist/types/evo-chat/forward/index.d.ts

@@ -17,6 +17,8 @@ export declare const FORWARD_ITEMS_COLLECTION: "items";
 export declare const FORWARD_MAX_MESSAGES = 20;
 export declare const FORWARD_MAX_RECIPIENTS = 10;
 export declare const FORWARD_INTRO_MAX_CHARS = 1000;
+/** Teto do assunto (RFC 5322), igual ao do composer de e-mail do Omni. */
+export declare const FORWARD_EMAIL_SUBJECT_MAX_CHARS = 998;
 /** Lote `running` sem atualização há mais que isto é mostrado como interrompido. */
 export declare const FORWARD_STALE_AFTER_MS: number;
 /** Evento de timeline gravado na thread de ORIGEM ao criar o lote. */
@@ -24,14 +26,15 @@ export declare const FORWARD_TIMELINE_EVENT_TYPE: "messages_forwarded";
 export type ForwardBatchStatus = "running" | "done" | "done_with_failures";
 export type ForwardItemStatus = "pending" | "sending" | "sent" | "failed" | "skipped";
 /** Motivos decididos na pré-validação (item nasce `skipped`, nenhuma chamada ao provedor). */
-export type ForwardSkipReason = "window_closed" | "type_not_supported" | "media_too_large" | "media_unavailable" | "channel_not_supported";
+export type ForwardSkipReason = "window_closed" | "type_not_supported" | "media_too_large" | "media_unavailable" | "channel_not_supported" | "attachments_over_limit" | "recipient_address_missing" | "email_identity_conflict";
 /** Motivos de falha no envio (item passou por `sending`). */
 export type ForwardFailReason = "provider_error" | "window_closed" | "send_budget_exceeded" | "interrupted";
 export type ForwardItemReason = ForwardSkipReason | ForwardFailReason;
 export type ForwardContentKind = "text" | "image" | "video" | "audio" | "document";
-/** Canais aceitos como DESTINO na F1. E-mail e SMS ficam para a F2. */
-export type ForwardDestinationKind = "whatsapp" | "instagram";
-export type ForwardRecipientProvider = "hub-waba" | "hub-instagram";
+/** Canais aceitos como DESTINO. E-mail é agregado: um e-mail por destinatário. SMS fica fora. */
+export type ForwardDestinationKind = "whatsapp" | "instagram" | "email";
+/** `hub-waba`, `hub-instagram` ou o provider do canal de e-mail (`smtp`, `amazon-ses`, ...). */
+export type ForwardRecipientProvider = string;
 export type ForwardSpecialKind = "doctor" | "secretary" | "employee";
 export interface IForwardActor {
     user_id: string;
@@ -55,6 +58,8 @@ export interface IForwardRecipient {
     channel_type: string;
     provider: ForwardRecipientProvider;
     special_kind?: ForwardSpecialKind | null;
+    /** Destino e-mail: endereço resolvido na prévia. O worker usa este, não resolve de novo. */
+    email_address?: string | null;
 }
 export interface IForwardDispatchState {
     claimed_at: Date;
@@ -83,6 +88,8 @@ export interface IForwardBatch extends IFireDoc {
     /** Chave = `thread_id` do destinatário. Claim do worker contra entrega duplicada. */
     dispatch?: Record<string, IForwardDispatchState>;
     finished_at?: Date | null;
+    /** Um assunto por lote; gravado só quando há destinatário e-mail. */
+    email_subject?: string | null;
 }
 export interface IForwardItem {
     /** `${recipient_thread_id}__${message_id}` ou `${recipient_thread_id}__intro`. */
@@ -100,6 +107,9 @@ export interface IForwardItem {
     error?: string | null;
     error_code?: number | null;
     dest_message_id?: string | null;
+    /** Destino e-mail: o N de `[Anexo N]` no corpo. */
+    attachment_index?: number | null;
+    dest_notification_message_id?: string | null;
     sent_at?: Date | null;
     updated_at?: Date;
 }
@@ -110,6 +120,33 @@ export interface IForwardPlanItem {
     message_id: string | null;
     status: "pending" | "skipped";
     reason?: ForwardSkipReason;
+    attachment?: {
+        index: number | null;
+        filename: string;
+        size_bytes: number | null;
+    } | null;
+}
+export interface IForwardPlanEmailAttachments {
+    count: number;
+    bytes: number;
+    max_count: number;
+    max_file_bytes: number;
+    max_total_bytes: number;
+}
+export interface IForwardPlanEmail {
+    channel_id: string;
+    provider: string;
+    from_address: string | null;
+    address: string | null;
+    address_source: "typed" | "contact" | "lead" | null;
+    identity: "own" | "attach" | "conflict" | null;
+    identity_owner_name?: string | null;
+    /** `fill`: lead sem e-mail, que o worker preenche antes do envio. */
+    lead_identity: "match" | "fill" | "conflict" | null;
+    /** Só no conflito do lead, para o aviso. */
+    lead_email?: string | null;
+    subject: string;
+    attachments: IForwardPlanEmailAttachments;
 }
 export interface IForwardPlanRecipient {
     thread_id: string;
@@ -119,6 +156,7 @@ export interface IForwardPlanRecipient {
     window: ForwardWindowState;
     needs_ticket: boolean;
     items: IForwardPlanItem[];
+    email?: IForwardPlanEmail | null;
 }
 export interface IForwardPlan {
     recipients: IForwardPlanRecipient[];
@@ -143,6 +181,12 @@ export interface IMessageForward {
     source_created_at: Date;
     forwarded_by: IForwardActor;
     forwarded_at: Date;
+    /**
+     * Destino e-mail: um e-mail agrega N mensagens. `source_message_id`/`item_id`
+     * apontam para a 1ª em ordem cronológica; estes trazem todas, na mesma ordem.
+     */
+    source_message_ids?: string[];
+    item_ids?: string[];
 }
 export type ForwardableMessage = Pick<IThreadMessage, "type" | "direction" | "channel_type" | "body" | "media" | "template"> & {
     revoked?: unknown;
@@ -160,8 +204,9 @@ export type ForwardContentResolution = {
  * Decide se uma mensagem pode ser encaminhada e como vira conteúdo no destino.
  *
  * `dest = null` é a checagem agnóstica do modo de seleção no front (sem canal
- * escolhido). A regra que depende do destino é só uma: documento não vai para
- * Instagram. O teto de tamanho NÃO fica aqui: depende do objeto no Storage.
+ * escolhido). Regras que dependem do destino: documento não vai para Instagram;
+ * áudio e vídeo não vão para e-mail. O teto de tamanho e o MIME aceito como
+ * anexo NÃO ficam aqui: dependem do objeto no Storage e da allowlist do provider.
  */
 export declare function resolveForwardContent(m: ForwardableMessage, dest: ForwardDestinationKind | null): ForwardContentResolution;
 /** Id determinístico do item: um destinatário aparece uma vez no lote, então é único. */

package/dist/types/evo-chat/forward/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FORWARD_TIMELINE_EVENT_TYPE = exports.FORWARD_STALE_AFTER_MS = exports.FORWARD_INTRO_MAX_CHARS = exports.FORWARD_MAX_RECIPIENTS = exports.FORWARD_MAX_MESSAGES = exports.FORWARD_ITEMS_COLLECTION = exports.FORWARDS_COLLECTION = void 0;
+exports.FORWARD_TIMELINE_EVENT_TYPE = exports.FORWARD_STALE_AFTER_MS = exports.FORWARD_EMAIL_SUBJECT_MAX_CHARS = exports.FORWARD_INTRO_MAX_CHARS = exports.FORWARD_MAX_RECIPIENTS = exports.FORWARD_MAX_MESSAGES = exports.FORWARD_ITEMS_COLLECTION = exports.FORWARDS_COLLECTION = void 0;
 exports.resolveForwardContent = resolveForwardContent;
 exports.buildForwardItemId = buildForwardItemId;
 /**
@@ -21,19 +21,22 @@ exports.FORWARD_ITEMS_COLLECTION = "items";
 exports.FORWARD_MAX_MESSAGES = 20;
 exports.FORWARD_MAX_RECIPIENTS = 10;
 exports.FORWARD_INTRO_MAX_CHARS = 1000;
+/** Teto do assunto (RFC 5322), igual ao do composer de e-mail do Omni. */
+exports.FORWARD_EMAIL_SUBJECT_MAX_CHARS = 998;
 /** Lote `running` sem atualização há mais que isto é mostrado como interrompido. */
 exports.FORWARD_STALE_AFTER_MS = 10 * 60 * 1000;
 /** Evento de timeline gravado na thread de ORIGEM ao criar o lote. */
 exports.FORWARD_TIMELINE_EVENT_TYPE = "messages_forwarded";
 const MEDIA_KINDS = new Set(["image", "video", "audio", "document"]);
-/** Canais que não entram na F1 nem como origem (e-mail, SMS). */
+/** Canais que não entram como origem (e-mail, SMS). */
 const UNSUPPORTED_SOURCE_CHANNELS = new Set(["email", "sms"]);
 /**
  * Decide se uma mensagem pode ser encaminhada e como vira conteúdo no destino.
  *
  * `dest = null` é a checagem agnóstica do modo de seleção no front (sem canal
- * escolhido). A regra que depende do destino é só uma: documento não vai para
- * Instagram. O teto de tamanho NÃO fica aqui: depende do objeto no Storage.
+ * escolhido). Regras que dependem do destino: documento não vai para Instagram;
+ * áudio e vídeo não vão para e-mail. O teto de tamanho e o MIME aceito como
+ * anexo NÃO ficam aqui: dependem do objeto no Storage e da allowlist do provider.
  */
 function resolveForwardContent(m, dest) {
     const direction = String(m.direction ?? "").toLowerCase();
@@ -60,6 +63,8 @@ function resolveForwardContent(m, dest) {
         return { ok: true, kind: "text", text };
     }
     if (MEDIA_KINDS.has(type)) {
+        if (dest === "email" && (type === "audio" || type === "video"))
+            return { ok: false, reason: "type_not_supported" };
         const uri = (m.media?.gcs_uri ?? "").trim();
         if (!uri)
             return { ok: false, reason: "media_unavailable" };

package/dist/types/evo-chat/forward/index.ts

@@ -22,6 +22,8 @@ export const FORWARD_ITEMS_COLLECTION = "items" as const;
 export const FORWARD_MAX_MESSAGES = 20;
 export const FORWARD_MAX_RECIPIENTS = 10;
 export const FORWARD_INTRO_MAX_CHARS = 1000;
+/** Teto do assunto (RFC 5322), igual ao do composer de e-mail do Omni. */
+export const FORWARD_EMAIL_SUBJECT_MAX_CHARS = 998;
 
 /** Lote `running` sem atualização há mais que isto é mostrado como interrompido. */
 export const FORWARD_STALE_AFTER_MS = 10 * 60 * 1000;
@@ -41,7 +43,10 @@ export type ForwardSkipReason =
   | "type_not_supported"
   | "media_too_large"
   | "media_unavailable"
-  | "channel_not_supported";
+  | "channel_not_supported"
+  | "attachments_over_limit"
+  | "recipient_address_missing"
+  | "email_identity_conflict";
 
 /** Motivos de falha no envio (item passou por `sending`). */
 export type ForwardFailReason =
@@ -54,10 +59,11 @@ export type ForwardItemReason = ForwardSkipReason | ForwardFailReason;
 
 export type ForwardContentKind = "text" | "image" | "video" | "audio" | "document";
 
-/** Canais aceitos como DESTINO na F1. E-mail e SMS ficam para a F2. */
-export type ForwardDestinationKind = "whatsapp" | "instagram";
+/** Canais aceitos como DESTINO. E-mail é agregado: um e-mail por destinatário. SMS fica fora. */
+export type ForwardDestinationKind = "whatsapp" | "instagram" | "email";
 
-export type ForwardRecipientProvider = "hub-waba" | "hub-instagram";
+/** `hub-waba`, `hub-instagram` ou o provider do canal de e-mail (`smtp`, `amazon-ses`, ...). */
+export type ForwardRecipientProvider = string;
 
 export type ForwardSpecialKind = "doctor" | "secretary" | "employee";
 
@@ -87,6 +93,8 @@ export interface IForwardRecipient {
   channel_type: string;
   provider: ForwardRecipientProvider;
   special_kind?: ForwardSpecialKind | null;
+  /** Destino e-mail: endereço resolvido na prévia. O worker usa este, não resolve de novo. */
+  email_address?: string | null;
 }
 
 export interface IForwardDispatchState {
@@ -118,6 +126,8 @@ export interface IForwardBatch extends IFireDoc {
   /** Chave = `thread_id` do destinatário. Claim do worker contra entrega duplicada. */
   dispatch?: Record<string, IForwardDispatchState>;
   finished_at?: Date | null;
+  /** Um assunto por lote; gravado só quando há destinatário e-mail. */
+  email_subject?: string | null;
 }
 
 // ── Item ──
@@ -138,6 +148,9 @@ export interface IForwardItem {
   error?: string | null;
   error_code?: number | null;
   dest_message_id?: string | null;
+  /** Destino e-mail: o N de `[Anexo N]` no corpo. */
+  attachment_index?: number | null;
+  dest_notification_message_id?: string | null;
   sent_at?: Date | null;
   updated_at?: Date;
 }
@@ -152,6 +165,31 @@ export interface IForwardPlanItem {
   message_id: string | null;
   status: "pending" | "skipped";
   reason?: ForwardSkipReason;
+  attachment?: { index: number | null; filename: string; size_bytes: number | null } | null;
+}
+
+export interface IForwardPlanEmailAttachments {
+  count: number;
+  bytes: number;
+  max_count: number;
+  max_file_bytes: number;
+  max_total_bytes: number;
+}
+
+export interface IForwardPlanEmail {
+  channel_id: string;
+  provider: string;
+  from_address: string | null;
+  address: string | null;
+  address_source: "typed" | "contact" | "lead" | null;
+  identity: "own" | "attach" | "conflict" | null;
+  identity_owner_name?: string | null;
+  /** `fill`: lead sem e-mail, que o worker preenche antes do envio. */
+  lead_identity: "match" | "fill" | "conflict" | null;
+  /** Só no conflito do lead, para o aviso. */
+  lead_email?: string | null;
+  subject: string;
+  attachments: IForwardPlanEmailAttachments;
 }
 
 export interface IForwardPlanRecipient {
@@ -162,6 +200,7 @@ export interface IForwardPlanRecipient {
   window: ForwardWindowState;
   needs_ticket: boolean;
   items: IForwardPlanItem[];
+  email?: IForwardPlanEmail | null;
 }
 
 export interface IForwardPlan {
@@ -186,6 +225,12 @@ export interface IMessageForward {
   source_created_at: Date;
   forwarded_by: IForwardActor;
   forwarded_at: Date;
+  /**
+   * Destino e-mail: um e-mail agrega N mensagens. `source_message_id`/`item_id`
+   * apontam para a 1ª em ordem cronológica; estes trazem todas, na mesma ordem.
+   */
+  source_message_ids?: string[];
+  item_ids?: string[];
 }
 
 // ── Matriz tipo × canal (pura; usada pelo backend na pré-validação e pelo front na seleção) ──
@@ -204,15 +249,16 @@ export type ForwardContentResolution =
 
 const MEDIA_KINDS: ReadonlySet<string> = new Set(["image", "video", "audio", "document"]);
 
-/** Canais que não entram na F1 nem como origem (e-mail, SMS). */
+/** Canais que não entram como origem (e-mail, SMS). */
 const UNSUPPORTED_SOURCE_CHANNELS: ReadonlySet<string> = new Set(["email", "sms"]);
 
 /**
  * Decide se uma mensagem pode ser encaminhada e como vira conteúdo no destino.
  *
  * `dest = null` é a checagem agnóstica do modo de seleção no front (sem canal
- * escolhido). A regra que depende do destino é só uma: documento não vai para
- * Instagram. O teto de tamanho NÃO fica aqui: depende do objeto no Storage.
+ * escolhido). Regras que dependem do destino: documento não vai para Instagram;
+ * áudio e vídeo não vão para e-mail. O teto de tamanho e o MIME aceito como
+ * anexo NÃO ficam aqui: dependem do objeto no Storage e da allowlist do provider.
  */
 export function resolveForwardContent(
   m: ForwardableMessage,
@@ -241,6 +287,7 @@ export function resolveForwardContent(
   }
 
   if (MEDIA_KINDS.has(type)) {
+    if (dest === "email" && (type === "audio" || type === "video")) return { ok: false, reason: "type_not_supported" };
     const uri = (m.media?.gcs_uri ?? "").trim();
     if (!uri) return { ok: false, reason: "media_unavailable" };
     if (type === "document" && dest === "instagram") return { ok: false, reason: "type_not_supported" };

package/package.json

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