evo360-types 1.3.715 → 1.3.719

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/apps/evo-finops/zod-schemas.d.ts

@@ -14303,7 +14303,7 @@ export declare const zNexFinopsProposalSchema: z.ZodObject<{
     currency: z.ZodLiteral<"BRL">;
 }, "strip", z.ZodTypeAny, {
     currency: "BRL";
-    status: "draft" | "expired" | "accepted" | "canceled" | "sent" | "viewed";
+    status: "draft" | "expired" | "accepted" | "sent" | "canceled" | "viewed";
     short_code: string;
     name?: string | null | undefined;
     notes?: string | null | undefined;
@@ -14337,7 +14337,7 @@ export declare const zNexFinopsProposalSchema: z.ZodObject<{
     valid_until?: string | undefined;
 }, {
     currency: "BRL";
-    status: "draft" | "expired" | "accepted" | "canceled" | "sent" | "viewed";
+    status: "draft" | "expired" | "accepted" | "sent" | "canceled" | "viewed";
     short_code: string;
     name?: string | null | undefined;
     notes?: string | null | undefined;

package/dist/apps/evo-med/appointment/zod-schemas.d.ts

@@ -278,12 +278,12 @@ export declare const zAppointmentRescheduleSchema: z.ZodObject<{
     userRef?: any;
     external_id?: string | null | undefined;
     user_name?: string | undefined;
+    reason?: string | undefined;
     appointmentSource?: {
         code: string;
         name: string;
         external_id?: string | null | undefined;
     } | undefined;
-    reason?: string | undefined;
     oldStartDate?: Date | undefined;
     oldEndDate?: Date | undefined;
     newStartDate?: Date | undefined;
@@ -293,12 +293,12 @@ export declare const zAppointmentRescheduleSchema: z.ZodObject<{
     userRef?: any;
     external_id?: string | null | undefined;
     user_name?: string | undefined;
+    reason?: string | undefined;
     appointmentSource?: {
         code: string;
         name: string;
         external_id?: string | null | undefined;
     } | undefined;
-    reason?: string | undefined;
     oldStartDate?: unknown;
     oldEndDate?: unknown;
     newStartDate?: unknown;
@@ -650,12 +650,12 @@ export declare const zAppointmentSchema: z.ZodObject<{
         userRef?: any;
         external_id?: string | null | undefined;
         user_name?: string | undefined;
+        reason?: string | undefined;
         appointmentSource?: {
             code: string;
             name: string;
             external_id?: string | null | undefined;
         } | undefined;
-        reason?: string | undefined;
         oldStartDate?: Date | undefined;
         oldEndDate?: Date | undefined;
         newStartDate?: Date | undefined;
@@ -665,12 +665,12 @@ export declare const zAppointmentSchema: z.ZodObject<{
         userRef?: any;
         external_id?: string | null | undefined;
         user_name?: string | undefined;
+        reason?: string | undefined;
         appointmentSource?: {
             code: string;
             name: string;
             external_id?: string | null | undefined;
         } | undefined;
-        reason?: string | undefined;
         oldStartDate?: unknown;
         oldEndDate?: unknown;
         newStartDate?: unknown;
@@ -1017,12 +1017,12 @@ export declare const zAppointmentSchema: z.ZodObject<{
         userRef?: any;
         external_id?: string | null | undefined;
         user_name?: string | undefined;
+        reason?: string | undefined;
         appointmentSource?: {
             code: string;
             name: string;
             external_id?: string | null | undefined;
         } | undefined;
-        reason?: string | undefined;
         oldStartDate?: Date | undefined;
         oldEndDate?: Date | undefined;
         newStartDate?: Date | undefined;
@@ -1032,12 +1032,12 @@ export declare const zAppointmentSchema: z.ZodObject<{
         userRef?: any;
         external_id?: string | null | undefined;
         user_name?: string | undefined;
+        reason?: string | undefined;
         appointmentSource?: {
             code: string;
             name: string;
             external_id?: string | null | undefined;
         } | undefined;
-        reason?: string | undefined;
         oldStartDate?: unknown;
         oldEndDate?: unknown;
         newStartDate?: unknown;
@@ -1384,12 +1384,12 @@ export declare const zAppointmentSchema: z.ZodObject<{
         userRef?: any;
         external_id?: string | null | undefined;
         user_name?: string | undefined;
+        reason?: string | undefined;
         appointmentSource?: {
             code: string;
             name: string;
             external_id?: string | null | undefined;
         } | undefined;
-        reason?: string | undefined;
         oldStartDate?: Date | undefined;
         oldEndDate?: Date | undefined;
         newStartDate?: Date | undefined;
@@ -1399,12 +1399,12 @@ export declare const zAppointmentSchema: z.ZodObject<{
         userRef?: any;
         external_id?: string | null | undefined;
         user_name?: string | undefined;
+        reason?: string | undefined;
         appointmentSource?: {
             code: string;
             name: string;
             external_id?: string | null | undefined;
         } | undefined;
-        reason?: string | undefined;
         oldStartDate?: unknown;
         oldEndDate?: unknown;
         newStartDate?: unknown;

package/dist/index.d.ts

@@ -58,6 +58,7 @@ export * from "./apps/evo-chat/waba-template/zod-schemas";
 export * from "./apps/evo-chat/waba-setup/zod-schemas";
 export * from "./apps/evo-chat/ig-setup/zod-schemas";
 export * from "./apps/evo-chat/quick-reply/zod-schemas";
+export * from "./apps/evo-chat/forward/zod-schemas";
 export * from "./apps/evo-hub-ia/channel/zod-schemas";
 export * from "./apps/evo-hub-ia/v1/zod-schemas";
 export * from "./apps/evo-hub-ia/v1/adapter-tool-registry";

package/dist/index.js

@@ -76,6 +76,7 @@ __exportStar(require("./apps/evo-chat/waba-template/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/waba-setup/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/ig-setup/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/quick-reply/zod-schemas"), exports);
+__exportStar(require("./apps/evo-chat/forward/zod-schemas"), exports);
 __exportStar(require("./apps/evo-hub-ia/channel/zod-schemas"), exports);
 __exportStar(require("./apps/evo-hub-ia/v1/zod-schemas"), exports);
 __exportStar(require("./apps/evo-hub-ia/v1/adapter-tool-registry"), exports);

package/dist/index.ts

@@ -61,6 +61,7 @@ export * from "./apps/evo-chat/waba-template/zod-schemas";
 export * from "./apps/evo-chat/waba-setup/zod-schemas";
 export * from "./apps/evo-chat/ig-setup/zod-schemas";
 export * from "./apps/evo-chat/quick-reply/zod-schemas";
+export * from "./apps/evo-chat/forward/zod-schemas";
 export * from "./apps/evo-hub-ia/channel/zod-schemas";
 export * from "./apps/evo-hub-ia/v1/zod-schemas";
 export * from "./apps/evo-hub-ia/v1/adapter-tool-registry";

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

@@ -0,0 +1,213 @@
+import type { IFireDoc } from "../../shared";
+import type { IThreadMessage } from "../thread-message";
+/**
+ * feat-282 — encaminhamento de mensagens no Hub Omni.
+ *
+ * A Cloud API da Meta não tem forward: o encaminhamento é nosso. Cada ação do
+ * operador vira um LOTE (`IForwardBatch`) em
+ * `tenants/{t}/apps/evo-chat/forwards/{forwardId}`, com um item por
+ * (destinatário × mensagem) na subcoleção `items/` e, por destinatário, um item
+ * `intro` opcional (texto de apresentação). Cada entrega é uma mensagem NORMAL de
+ * saída na thread de destino, com o bloco `forward` (`IMessageForward`) apontando
+ * para a origem. A mensagem de origem só ganha `forward_count`.
+ */
+export declare const FORWARDS_COLLECTION: "forwards";
+export declare const FORWARD_ITEMS_COLLECTION: "items";
+/** Tetos do lote (plan.md D6). Constantes de plataforma, sem config por tenant. */
+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. */
+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" | "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. 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;
+    display_name: string;
+}
+export interface IForwardSource {
+    thread_id: string;
+    ticket_id: string;
+    /** Departamento do ticket de origem: é onde o ticket novo do destino abre (Q4-A). */
+    department_id: string | null;
+    contact_id: string;
+    contact_name: string;
+    channel_id: string | null;
+    channel_type: string | null;
+}
+export interface IForwardRecipient {
+    thread_id: string;
+    contact_id: string;
+    contact_name: string;
+    channel_id: string;
+    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;
+    finished_at?: Date | null;
+}
+export interface IForwardCounts {
+    total: number;
+    sent: number;
+    failed: number;
+    skipped: number;
+}
+export interface IForwardBatch extends IFireDoc {
+    forward_id: string;
+    tenant: string;
+    created_by: IForwardActor;
+    source: IForwardSource;
+    /** Ordem cronológica da origem (o backend ordena por `created_at`, não pelo payload). */
+    message_ids: string[];
+    intro_text: string | null;
+    recipients: IForwardRecipient[];
+    status: ForwardBatchStatus;
+    counts: IForwardCounts;
+    /** Destinatários com pelo menos um item `pending` (os que recebem mensagem PubSub). */
+    recipients_to_dispatch: number;
+    recipients_done: number;
+    /** 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`. */
+    item_id: string;
+    forward_id: string;
+    recipient_thread_id: string;
+    recipient_index: number;
+    /** 0 = intro; 1..N = mensagens na ordem da origem. */
+    seq: number;
+    kind: "intro" | "message";
+    message_id: string | null;
+    content_kind: ForwardContentKind;
+    status: ForwardItemStatus;
+    reason?: ForwardItemReason | null;
+    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;
+}
+export type ForwardWindowState = "open" | "human_agent" | "closed";
+export interface IForwardPlanItem {
+    item_id: string;
+    kind: "intro" | "message";
+    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;
+    channel_id: string;
+    channel_type: string;
+    contact_name: string;
+    window: ForwardWindowState;
+    needs_ticket: boolean;
+    items: IForwardPlanItem[];
+    email?: IForwardPlanEmail | null;
+}
+export interface IForwardPlan {
+    recipients: IForwardPlanRecipient[];
+    counts: {
+        total: number;
+        pending: number;
+        skipped: number;
+    };
+}
+export interface IMessageForward {
+    forward_id: string;
+    /** Ponte para o item do lote (o status-processor reflete falha assíncrona por aqui). */
+    item_id: string;
+    /** Vazio no item `intro`: o front não mostra selo quando está vazio. */
+    source_message_id: string;
+    source_thread_id: string;
+    source_ticket_id: string;
+    source_contact_id: string;
+    source_contact_name: string;
+    source_channel_type: string | null;
+    source_direction: "in" | "out";
+    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;
+    deleted_at?: unknown;
+};
+export type ForwardContentResolution = {
+    ok: true;
+    kind: ForwardContentKind;
+    text?: string;
+} | {
+    ok: false;
+    reason: ForwardSkipReason;
+};
+/**
+ * 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). 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. */
+export declare function buildForwardItemId(recipientThreadId: string, messageId: string | null): string;