evo360-types 1.3.530 → 1.3.532

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

@@ -484,27 +484,27 @@ export declare const zTemplateHeaderMediaSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "image" | "video" | "document";
     link?: string | undefined;
-    gcs_uri?: string | undefined;
     mime_type?: string | undefined;
     filename?: string | undefined;
+    gcs_uri?: string | undefined;
 }, {
     type: "image" | "video" | "document";
     link?: string | undefined;
-    gcs_uri?: string | undefined;
     mime_type?: string | undefined;
     filename?: string | undefined;
+    gcs_uri?: string | undefined;
 }>, {
     type: "image" | "video" | "document";
     link?: string | undefined;
-    gcs_uri?: string | undefined;
     mime_type?: string | undefined;
     filename?: string | undefined;
+    gcs_uri?: string | undefined;
 }, {
     type: "image" | "video" | "document";
     link?: string | undefined;
-    gcs_uri?: string | undefined;
     mime_type?: string | undefined;
     filename?: string | undefined;
+    gcs_uri?: string | undefined;
 }>;
 /**
  * Schema para requisição de envio de mensagem de texto
@@ -576,27 +576,27 @@ export declare const zSendTemplateMessageRequestSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }>, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }>>;
     button_payloads: z.ZodOptional<z.ZodArray<z.ZodObject<{
         index: z.ZodNumber;
@@ -629,9 +629,9 @@ export declare const zSendTemplateMessageRequestSchema: z.ZodObject<{
     header_media?: {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     } | undefined;
     button_payloads?: {
         index: number;
@@ -658,9 +658,9 @@ export declare const zSendTemplateMessageRequestSchema: z.ZodObject<{
     header_media?: {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     } | undefined;
     button_payloads?: {
         index: number;
@@ -733,27 +733,27 @@ export declare const zSendMessageRequestSchema: z.ZodDiscriminatedUnion<"type",
     }, "strip", z.ZodTypeAny, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }>, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }, {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     }>>;
     button_payloads: z.ZodOptional<z.ZodArray<z.ZodObject<{
         index: z.ZodNumber;
@@ -786,9 +786,9 @@ export declare const zSendMessageRequestSchema: z.ZodDiscriminatedUnion<"type",
     header_media?: {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     } | undefined;
     button_payloads?: {
         index: number;
@@ -815,9 +815,9 @@ export declare const zSendMessageRequestSchema: z.ZodDiscriminatedUnion<"type",
     header_media?: {
         type: "image" | "video" | "document";
         link?: string | undefined;
-        gcs_uri?: string | undefined;
         mime_type?: string | undefined;
         filename?: string | undefined;
+        gcs_uri?: string | undefined;
     } | undefined;
     button_payloads?: {
         index: number;

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

@@ -1,5 +1,6 @@
 import type { IHubIAConfig } from "../../evo-hub-ia/channel";
 import { IFireDoc } from "../../shared";
+import type { IChannelHistoryImport } from "../waba-history-import";
 export type ChannelProvider = 'chatbee' | 'hub-waba' | 'hub-instagram';
 export type ChannelType = 'waba' | 'instagram' | 'telegram' | 'email' | 'sms';
 export type ChannelStatus = 'active' | 'paused' | 'disabled' | 'pending';
@@ -60,5 +61,7 @@ export interface IChannel extends IFireDoc {
     provider_ref: IChannelProviderRef;
     hub_ia?: IHubIAConfig;
     calls?: ICallsChannelConfig;
+    /** feat-142 — rollup da recepção do histórico de coexistência (WABA). */
+    history_import?: IChannelHistoryImport;
     [key: string]: unknown;
 }

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

@@ -1,5 +1,6 @@
 import type { IHubIAConfig } from "../../evo-hub-ia/channel";
 import { IFireDoc } from "../../shared";
+import type { IChannelHistoryImport } from "../waba-history-import";
 
 // ── Channel provider/type enums ──
 
@@ -84,5 +85,7 @@ export interface IChannel extends IFireDoc {
   provider_ref: IChannelProviderRef;
   hub_ia?: IHubIAConfig;
   calls?: ICallsChannelConfig;
+  /** feat-142 — rollup da recepção do histórico de coexistência (WABA). */
+  history_import?: IChannelHistoryImport;
   [key: string]: unknown;
 }

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

@@ -10,6 +10,7 @@ export * from "./ticket";
 export * from "./inbox";
 export * from "./waba-template";
 export * from "./waba-setup";
+export * from "./waba-history-import";
 export * from "./ig-setup";
 export * from "./quick-reply";
 export * from "./search";

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

@@ -27,6 +27,7 @@ __exportStar(require("./ticket"), exports);
 __exportStar(require("./inbox"), exports);
 __exportStar(require("./waba-template"), exports);
 __exportStar(require("./waba-setup"), exports);
+__exportStar(require("./waba-history-import"), exports);
 __exportStar(require("./ig-setup"), exports);
 __exportStar(require("./quick-reply"), exports);
 __exportStar(require("./search"), exports);

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

@@ -10,6 +10,7 @@ export * from "./ticket";
 export * from "./inbox";
 export * from "./waba-template";
 export * from "./waba-setup";
+export * from "./waba-history-import";
 export * from "./ig-setup";
 export * from "./quick-reply";
 export * from "./search";

package/dist/types/evo-chat/waba-history-import.d.ts

@@ -0,0 +1,263 @@
+import { z } from "zod";
+import type { IFireDoc } from "../shared";
+/**
+ * feat-142 — importação sob demanda do histórico de coexistência WABA.
+ *
+ * A recepção (Fase 1) só acumula os chunks no staging e o rollup do canal
+ * (`IChannelHistoryImport`) + o manifest de mídia (`IWabaHistoryMediaManifest`).
+ * A materialização (contatos/threads/mensagens/tickets/leads) acontece depois,
+ * sob demanda, num job (`IWabaHistoryImportJob`) disparado pelo admin.
+ */
+export declare const WABA_HISTORY_IMPORT_PUBSUB_TOPIC: "app_hub-waba_history-import_request";
+/**
+ * Subcoleção dos jobs, sob o canal:
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-import-jobs/{jobId}`
+ */
+export declare const WABA_HISTORY_IMPORT_JOBS_COLLECTION: "history-import-jobs";
+/**
+ * Subcoleção do manifest de mídia, sob o canal, com `{wamid}` como id do doc:
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-media/{wamid}`
+ */
+export declare const WABA_HISTORY_MEDIA_COLLECTION: "history-media";
+/** Janela padrão quando o operador não escolhe nada. */
+export declare const WABA_HISTORY_IMPORT_DEFAULT_WINDOW_MONTHS: 3;
+/** Janela de importação: tudo, últimos N meses, ou a partir de uma data. */
+export type WabaHistoryImportWindowMode = "all" | "months" | "since";
+/** 'dry_run' = conta sem escrever; 'execute' = importa de verdade. */
+export type WabaHistoryImportJobMode = "dry_run" | "execute";
+export type WabaHistoryImportJobStatus = "pending" | "running" | "done" | "failed";
+/**
+ * Rollup do canal: 'receiving' enquanto chegam chunks, 'completed' com
+ * progress 100, 'declined' quando a Meta recusa o compartilhamento (2593109).
+ */
+export type ChannelHistoryImportStatus = "receiving" | "completed" | "declined";
+/** Situação do download de um asset no manifest. */
+export type WabaHistoryMediaStatus = "stored" | "failed" | "unavailable";
+export interface IWabaHistoryImportWindow {
+    mode: WabaHistoryImportWindowMode;
+    /** Obrigatório quando `mode === 'months'`. */
+    months?: number;
+    /** Data ISO (corte inferior). Obrigatório quando `mode === 'since'`. */
+    since?: string;
+}
+export interface IWabaHistoryImportConfig {
+    window: IWabaHistoryImportWindow;
+    /** Departamento de destino dos tickets históricos (fechados). */
+    department_id: string;
+    /**
+     * D10 — opt-in de transcrição. Default false. Só enfileira áudios com
+     * manifest `stored` dentro da janela e sem transcrição prévia.
+     */
+    transcribe_audios: boolean;
+}
+/**
+ * Cursor keyset sobre o staging dos chunks, ordenado por
+ * (received_at, trace_id, fragment_index). A página seguinte retoma
+ * estritamente APÓS esta tupla; `null` = começa do início.
+ */
+export interface IWabaHistoryImportCursor {
+    /** `received_at` do último fragmento processado, em ISO 8601. */
+    received_at: string;
+    trace_id: string;
+    fragment_index: number;
+}
+/**
+ * Totais acumulados por página, para a UI acompanhar o progresso e a
+ * continuação (republish com cursor) retomar contagem consistente.
+ */
+export interface IWabaHistoryImportCounters {
+    /** Fragmentos lidos do staging. */
+    rows_read: number;
+    threads: number;
+    messages_imported: number;
+    messages_skipped_dup: number;
+    /** Mensagens descartadas por estarem fora da janela configurada. */
+    messages_out_of_window: number;
+    contacts_touched: number;
+    leads_published: number;
+    tickets_closed: number;
+    /** Mensagens de mídia casadas com um manifest `stored`. */
+    media_linked: number;
+    /** Mensagens de mídia sem manifest utilizável (viram `unsupported`). */
+    media_unavailable: number;
+    /** Total de placeholders de mídia vistos — denominador da cobertura. */
+    media_placeholders_total: number;
+    /** D10 — áudios elegíveis a transcrição (manifest `stored`, sem transcript). */
+    audios_transcribable: number;
+    /** D10 — eventos de transcrição efetivamente publicados. */
+    audio_transcriptions_queued: number;
+}
+export interface IWabaHistoryImportRequestedBy {
+    user_id: string;
+    login_id: string;
+}
+/**
+ * Doc do job em
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-import-jobs/{jobId}`.
+ */
+export interface IWabaHistoryImportJob extends IFireDoc {
+    channel_id: string;
+    mode: WabaHistoryImportJobMode;
+    status: WabaHistoryImportJobStatus;
+    config: IWabaHistoryImportConfig;
+    /** Cursor da última página commitada; null antes da primeira. */
+    cursor: IWabaHistoryImportCursor | null;
+    counters: IWabaHistoryImportCounters;
+    requested_by: IWabaHistoryImportRequestedBy;
+    error: string | null;
+    created_at: Date | null;
+    updated_at: Date | null;
+    started_at?: Date | null;
+    finished_at?: Date | null;
+}
+/** Ids devolvidos pela Meta ao pedir o compartilhamento (`smb_app_data`). */
+export interface IChannelHistoryImportRequestIds {
+    history_request_id?: string | null;
+    state_sync_request_id?: string | null;
+}
+/** Estado do pedido de sync disparado no onboarding (G1). */
+export interface IChannelHistoryImportSync {
+    requested_at?: Date | null;
+    request_ids?: IChannelHistoryImportRequestIds;
+    last_error?: string | null;
+}
+/**
+ * Rollup da recepção, gravado no doc do canal em `history_import`.
+ * Contadores são incrementais (`FieldValue.increment`) — aproximados sob
+ * redelivery; o número exato vive no BQ.
+ */
+export interface IChannelHistoryImport {
+    status: ChannelHistoryImportStatus;
+    /** false quando a Meta recusou o compartilhamento (erro 2593109). */
+    history_shared?: boolean;
+    /** Pedido de sync (history + smb_app_state_sync) feito no onboarding. */
+    sync?: IChannelHistoryImportSync;
+    chunks_received: number;
+    messages_received: number;
+    threads_seen: number;
+    /** Contatos vistos nos chunks de `smb_app_state_sync`. */
+    contacts_received: number;
+    /** Placeholders de mídia vistos nos chunks (denominador da cobertura). */
+    media_placeholders_seen: number;
+    /** Assets de mídia recebidos na raiz do payload e passados ao harvester. */
+    media_assets_received: number;
+    /** Subconjunto de `media_assets_received` do tipo áudio (D10 — UI pré-dry-run). */
+    audio_assets_received: number;
+    /** Maior `progress` visto (monotônico, 0..100). */
+    max_progress: number;
+    /** `phase` do último chunk recebido. */
+    last_phase?: number | null;
+    last_chunk_at?: Date | null;
+    /** Último chunk de `smb_app_state_sync` processado. */
+    last_state_sync_at?: Date | null;
+    /** Momento da recusa (2593109). */
+    declined_at?: Date | null;
+    /** Preenchido quando o progress chega a 100. */
+    completed_at?: Date | null;
+}
+/** Direção da mensagem que carregava o asset. */
+export type WabaHistoryMediaDirection = "in" | "out";
+/**
+ * Doc do manifest de mídia em
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-media/{wamid}`
+ * (id do doc = `wamid`). Escrito na recepção (G3) e consultado pelo motor
+ * para fundir a mídia na mensagem materializada.
+ */
+export interface IWabaHistoryMediaManifest extends IFireDoc {
+    wamid: string;
+    /** `media.id` usado no download via Graph. */
+    media_id: string;
+    /** Outros `media.id` vistos para o mesmo wamid (reentrega/duplicata). */
+    dup_media_ids: string[];
+    /** Tipo da mensagem de origem: 'image' | 'audio' | 'video' | 'document' | … */
+    msg_type: string;
+    direction: WabaHistoryMediaDirection;
+    /** Timestamp da mensagem em epoch segundos (como o normalizer entrega). */
+    timestamp: number;
+    mime_type?: string | null;
+    filename?: string | null;
+    caption?: string | null;
+    /** sha256 como a Meta entrega (base64). */
+    sha256_b64?: string | null;
+    /** sha256 do objeto baixado, em hex (conferido contra `sha256_b64`). */
+    sha256_hex?: string | null;
+    size_bytes?: number | null;
+    /** `gs://…` do objeto no bucket do hub-waba; null se não armazenado. */
+    gcs_uri?: string | null;
+    status: WabaHistoryMediaStatus;
+    error?: string | null;
+    downloaded_at?: Date | null;
+}
+export declare const WabaHistoryImportWindowSchema: z.ZodEffects<z.ZodObject<{
+    mode: z.ZodEnum<["all", "months", "since"]>;
+    months: z.ZodOptional<z.ZodNumber>;
+    since: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "all" | "months" | "since";
+    months?: number | undefined;
+    since?: string | undefined;
+}, {
+    mode: "all" | "months" | "since";
+    months?: number | undefined;
+    since?: string | undefined;
+}>, {
+    mode: "all" | "months" | "since";
+    months?: number | undefined;
+    since?: string | undefined;
+}, {
+    mode: "all" | "months" | "since";
+    months?: number | undefined;
+    since?: string | undefined;
+}>;
+/** Body de POST …/history-import/dry-run e …/history-import/execute. */
+export declare const WabaHistoryImportRequestSchema: z.ZodObject<{
+    window: z.ZodDefault<z.ZodEffects<z.ZodObject<{
+        mode: z.ZodEnum<["all", "months", "since"]>;
+        months: z.ZodOptional<z.ZodNumber>;
+        since: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "all" | "months" | "since";
+        months?: number | undefined;
+        since?: string | undefined;
+    }, {
+        mode: "all" | "months" | "since";
+        months?: number | undefined;
+        since?: string | undefined;
+    }>, {
+        mode: "all" | "months" | "since";
+        months?: number | undefined;
+        since?: string | undefined;
+    }, {
+        mode: "all" | "months" | "since";
+        months?: number | undefined;
+        since?: string | undefined;
+    }>>;
+    department_id: z.ZodString;
+    /** D10 — opt-in; ausente = false (comportamento de hoje). */
+    transcribe_audios: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    window: {
+        mode: "all" | "months" | "since";
+        months?: number | undefined;
+        since?: string | undefined;
+    };
+    department_id: string;
+    transcribe_audios: boolean;
+}, {
+    department_id: string;
+    window?: {
+        mode: "all" | "months" | "since";
+        months?: number | undefined;
+        since?: string | undefined;
+    } | undefined;
+    transcribe_audios?: boolean | undefined;
+}>;
+export type IWabaHistoryImportRequestPayload = z.infer<typeof WabaHistoryImportRequestSchema>;
+export interface IWabaHistoryImportPubSubEvent {
+    tenant: string;
+    channelId: string;
+    jobId: string;
+    /** Cursor para retomar numa continuação; null/ausente na primeira execução. */
+    cursor?: IWabaHistoryImportCursor | null;
+    trace_id?: string;
+}

package/dist/types/evo-chat/waba-history-import.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WabaHistoryImportRequestSchema = exports.WabaHistoryImportWindowSchema = exports.WABA_HISTORY_IMPORT_DEFAULT_WINDOW_MONTHS = exports.WABA_HISTORY_MEDIA_COLLECTION = exports.WABA_HISTORY_IMPORT_JOBS_COLLECTION = exports.WABA_HISTORY_IMPORT_PUBSUB_TOPIC = void 0;
+const zod_1 = require("zod");
+/**
+ * feat-142 — importação sob demanda do histórico de coexistência WABA.
+ *
+ * A recepção (Fase 1) só acumula os chunks no staging e o rollup do canal
+ * (`IChannelHistoryImport`) + o manifest de mídia (`IWabaHistoryMediaManifest`).
+ * A materialização (contatos/threads/mensagens/tickets/leads) acontece depois,
+ * sob demanda, num job (`IWabaHistoryImportJob`) disparado pelo admin.
+ */
+// ── Constants ──
+exports.WABA_HISTORY_IMPORT_PUBSUB_TOPIC = "app_hub-waba_history-import_request";
+/**
+ * Subcoleção dos jobs, sob o canal:
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-import-jobs/{jobId}`
+ */
+exports.WABA_HISTORY_IMPORT_JOBS_COLLECTION = "history-import-jobs";
+/**
+ * Subcoleção do manifest de mídia, sob o canal, com `{wamid}` como id do doc:
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-media/{wamid}`
+ */
+exports.WABA_HISTORY_MEDIA_COLLECTION = "history-media";
+/** Janela padrão quando o operador não escolhe nada. */
+exports.WABA_HISTORY_IMPORT_DEFAULT_WINDOW_MONTHS = 3;
+// ── Zod Schemas (body dos endpoints admin) ──
+exports.WabaHistoryImportWindowSchema = zod_1.z
+    .object({
+    mode: zod_1.z.enum(["all", "months", "since"]),
+    months: zod_1.z.number().int().positive().optional(),
+    since: zod_1.z.string().min(1).optional(),
+})
+    .superRefine((w, ctx) => {
+    if (w.mode === "months" && w.months === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ["months"],
+            message: "months é obrigatório quando mode = 'months'",
+        });
+    }
+    if (w.mode === "since" && !w.since) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ["since"],
+            message: "since é obrigatório quando mode = 'since'",
+        });
+    }
+});
+/** Body de POST …/history-import/dry-run e …/history-import/execute. */
+exports.WabaHistoryImportRequestSchema = zod_1.z.object({
+    window: exports.WabaHistoryImportWindowSchema.default({
+        mode: "months",
+        months: exports.WABA_HISTORY_IMPORT_DEFAULT_WINDOW_MONTHS,
+    }),
+    department_id: zod_1.z.string().min(1),
+    /** D10 — opt-in; ausente = false (comportamento de hoje). */
+    transcribe_audios: zod_1.z.boolean().default(false),
+});

package/dist/types/evo-chat/waba-history-import.ts

@@ -0,0 +1,285 @@
+import { z } from "zod";
+import type { IFireDoc } from "../shared";
+
+/**
+ * feat-142 — importação sob demanda do histórico de coexistência WABA.
+ *
+ * A recepção (Fase 1) só acumula os chunks no staging e o rollup do canal
+ * (`IChannelHistoryImport`) + o manifest de mídia (`IWabaHistoryMediaManifest`).
+ * A materialização (contatos/threads/mensagens/tickets/leads) acontece depois,
+ * sob demanda, num job (`IWabaHistoryImportJob`) disparado pelo admin.
+ */
+
+// ── Constants ──
+
+export const WABA_HISTORY_IMPORT_PUBSUB_TOPIC =
+  "app_hub-waba_history-import_request" as const;
+
+/**
+ * Subcoleção dos jobs, sob o canal:
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-import-jobs/{jobId}`
+ */
+export const WABA_HISTORY_IMPORT_JOBS_COLLECTION =
+  "history-import-jobs" as const;
+
+/**
+ * Subcoleção do manifest de mídia, sob o canal, com `{wamid}` como id do doc:
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-media/{wamid}`
+ */
+export const WABA_HISTORY_MEDIA_COLLECTION = "history-media" as const;
+
+/** Janela padrão quando o operador não escolhe nada. */
+export const WABA_HISTORY_IMPORT_DEFAULT_WINDOW_MONTHS = 3 as const;
+
+// ── Enums / Literals ──
+
+/** Janela de importação: tudo, últimos N meses, ou a partir de uma data. */
+export type WabaHistoryImportWindowMode = "all" | "months" | "since";
+
+/** 'dry_run' = conta sem escrever; 'execute' = importa de verdade. */
+export type WabaHistoryImportJobMode = "dry_run" | "execute";
+
+export type WabaHistoryImportJobStatus =
+  | "pending"
+  | "running"
+  | "done"
+  | "failed";
+
+/**
+ * Rollup do canal: 'receiving' enquanto chegam chunks, 'completed' com
+ * progress 100, 'declined' quando a Meta recusa o compartilhamento (2593109).
+ */
+export type ChannelHistoryImportStatus =
+  | "receiving"
+  | "completed"
+  | "declined";
+
+/** Situação do download de um asset no manifest. */
+export type WabaHistoryMediaStatus = "stored" | "failed" | "unavailable";
+
+// ── Config / Window ──
+
+export interface IWabaHistoryImportWindow {
+  mode: WabaHistoryImportWindowMode;
+  /** Obrigatório quando `mode === 'months'`. */
+  months?: number;
+  /** Data ISO (corte inferior). Obrigatório quando `mode === 'since'`. */
+  since?: string;
+}
+
+export interface IWabaHistoryImportConfig {
+  window: IWabaHistoryImportWindow;
+  /** Departamento de destino dos tickets históricos (fechados). */
+  department_id: string;
+  /**
+   * D10 — opt-in de transcrição. Default false. Só enfileira áudios com
+   * manifest `stored` dentro da janela e sem transcrição prévia.
+   */
+  transcribe_audios: boolean;
+}
+
+// ── Job sub-interfaces ──
+
+/**
+ * Cursor keyset sobre o staging dos chunks, ordenado por
+ * (received_at, trace_id, fragment_index). A página seguinte retoma
+ * estritamente APÓS esta tupla; `null` = começa do início.
+ */
+export interface IWabaHistoryImportCursor {
+  /** `received_at` do último fragmento processado, em ISO 8601. */
+  received_at: string;
+  trace_id: string;
+  fragment_index: number;
+}
+
+/**
+ * Totais acumulados por página, para a UI acompanhar o progresso e a
+ * continuação (republish com cursor) retomar contagem consistente.
+ */
+export interface IWabaHistoryImportCounters {
+  /** Fragmentos lidos do staging. */
+  rows_read: number;
+  threads: number;
+  messages_imported: number;
+  messages_skipped_dup: number;
+  /** Mensagens descartadas por estarem fora da janela configurada. */
+  messages_out_of_window: number;
+  contacts_touched: number;
+  leads_published: number;
+  tickets_closed: number;
+  /** Mensagens de mídia casadas com um manifest `stored`. */
+  media_linked: number;
+  /** Mensagens de mídia sem manifest utilizável (viram `unsupported`). */
+  media_unavailable: number;
+  /** Total de placeholders de mídia vistos — denominador da cobertura. */
+  media_placeholders_total: number;
+  /** D10 — áudios elegíveis a transcrição (manifest `stored`, sem transcript). */
+  audios_transcribable: number;
+  /** D10 — eventos de transcrição efetivamente publicados. */
+  audio_transcriptions_queued: number;
+}
+
+export interface IWabaHistoryImportRequestedBy {
+  user_id: string;
+  login_id: string;
+}
+
+// ── Job Document ──
+
+/**
+ * Doc do job em
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-import-jobs/{jobId}`.
+ */
+export interface IWabaHistoryImportJob extends IFireDoc {
+  channel_id: string;
+  mode: WabaHistoryImportJobMode;
+  status: WabaHistoryImportJobStatus;
+  config: IWabaHistoryImportConfig;
+  /** Cursor da última página commitada; null antes da primeira. */
+  cursor: IWabaHistoryImportCursor | null;
+  counters: IWabaHistoryImportCounters;
+  requested_by: IWabaHistoryImportRequestedBy;
+  error: string | null;
+  created_at: Date | null;
+  updated_at: Date | null;
+  started_at?: Date | null;
+  finished_at?: Date | null;
+}
+
+// ── Channel rollup ──
+
+/** Ids devolvidos pela Meta ao pedir o compartilhamento (`smb_app_data`). */
+export interface IChannelHistoryImportRequestIds {
+  history_request_id?: string | null;
+  state_sync_request_id?: string | null;
+}
+
+/** Estado do pedido de sync disparado no onboarding (G1). */
+export interface IChannelHistoryImportSync {
+  requested_at?: Date | null;
+  request_ids?: IChannelHistoryImportRequestIds;
+  last_error?: string | null;
+}
+
+/**
+ * Rollup da recepção, gravado no doc do canal em `history_import`.
+ * Contadores são incrementais (`FieldValue.increment`) — aproximados sob
+ * redelivery; o número exato vive no BQ.
+ */
+export interface IChannelHistoryImport {
+  status: ChannelHistoryImportStatus;
+  /** false quando a Meta recusou o compartilhamento (erro 2593109). */
+  history_shared?: boolean;
+  /** Pedido de sync (history + smb_app_state_sync) feito no onboarding. */
+  sync?: IChannelHistoryImportSync;
+  chunks_received: number;
+  messages_received: number;
+  threads_seen: number;
+  /** Contatos vistos nos chunks de `smb_app_state_sync`. */
+  contacts_received: number;
+  /** Placeholders de mídia vistos nos chunks (denominador da cobertura). */
+  media_placeholders_seen: number;
+  /** Assets de mídia recebidos na raiz do payload e passados ao harvester. */
+  media_assets_received: number;
+  /** Subconjunto de `media_assets_received` do tipo áudio (D10 — UI pré-dry-run). */
+  audio_assets_received: number;
+  /** Maior `progress` visto (monotônico, 0..100). */
+  max_progress: number;
+  /** `phase` do último chunk recebido. */
+  last_phase?: number | null;
+  last_chunk_at?: Date | null;
+  /** Último chunk de `smb_app_state_sync` processado. */
+  last_state_sync_at?: Date | null;
+  /** Momento da recusa (2593109). */
+  declined_at?: Date | null;
+  /** Preenchido quando o progress chega a 100. */
+  completed_at?: Date | null;
+}
+
+// ── Media manifest ──
+
+/** Direção da mensagem que carregava o asset. */
+export type WabaHistoryMediaDirection = "in" | "out";
+
+/**
+ * Doc do manifest de mídia em
+ * `tenants/{tenant}/apps/evo-chat/channels/{channelId}/history-media/{wamid}`
+ * (id do doc = `wamid`). Escrito na recepção (G3) e consultado pelo motor
+ * para fundir a mídia na mensagem materializada.
+ */
+export interface IWabaHistoryMediaManifest extends IFireDoc {
+  wamid: string;
+  /** `media.id` usado no download via Graph. */
+  media_id: string;
+  /** Outros `media.id` vistos para o mesmo wamid (reentrega/duplicata). */
+  dup_media_ids: string[];
+  /** Tipo da mensagem de origem: 'image' | 'audio' | 'video' | 'document' | … */
+  msg_type: string;
+  direction: WabaHistoryMediaDirection;
+  /** Timestamp da mensagem em epoch segundos (como o normalizer entrega). */
+  timestamp: number;
+  mime_type?: string | null;
+  filename?: string | null;
+  caption?: string | null;
+  /** sha256 como a Meta entrega (base64). */
+  sha256_b64?: string | null;
+  /** sha256 do objeto baixado, em hex (conferido contra `sha256_b64`). */
+  sha256_hex?: string | null;
+  size_bytes?: number | null;
+  /** `gs://…` do objeto no bucket do hub-waba; null se não armazenado. */
+  gcs_uri?: string | null;
+  status: WabaHistoryMediaStatus;
+  error?: string | null;
+  downloaded_at?: Date | null;
+}
+
+// ── Zod Schemas (body dos endpoints admin) ──
+
+export const WabaHistoryImportWindowSchema = z
+  .object({
+    mode: z.enum(["all", "months", "since"]),
+    months: z.number().int().positive().optional(),
+    since: z.string().min(1).optional(),
+  })
+  .superRefine((w, ctx) => {
+    if (w.mode === "months" && w.months === undefined) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["months"],
+        message: "months é obrigatório quando mode = 'months'",
+      });
+    }
+    if (w.mode === "since" && !w.since) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["since"],
+        message: "since é obrigatório quando mode = 'since'",
+      });
+    }
+  });
+
+/** Body de POST …/history-import/dry-run e …/history-import/execute. */
+export const WabaHistoryImportRequestSchema = z.object({
+  window: WabaHistoryImportWindowSchema.default({
+    mode: "months",
+    months: WABA_HISTORY_IMPORT_DEFAULT_WINDOW_MONTHS,
+  }),
+  department_id: z.string().min(1),
+  /** D10 — opt-in; ausente = false (comportamento de hoje). */
+  transcribe_audios: z.boolean().default(false),
+});
+
+export type IWabaHistoryImportRequestPayload = z.infer<
+  typeof WabaHistoryImportRequestSchema
+>;
+
+// ── PubSub Event ──
+
+export interface IWabaHistoryImportPubSubEvent {
+  tenant: string;
+  channelId: string;
+  jobId: string;
+  /** Cursor para retomar numa continuação; null/ausente na primeira execução. */
+  cursor?: IWabaHistoryImportCursor | null;
+  trace_id?: string;
+}

package/package.json

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