evo360-types 1.3.390 → 1.3.392

package/dist/types/evo-crm/dic/index.d.ts

@@ -33,6 +33,16 @@ export interface IDistChannel extends IFireDoc {
     type_name?: string;
     typeRef?: FirestoreDocumentReference;
     tags?: ITag[] | null;
+    rules?: {
+        regex: string;
+        flags?: string;
+        priority?: number;
+        description?: string | null;
+        examples?: string[] | null;
+    } | null;
+    /** Tipo FINO de aquisição (feat-039) — override explícito da derivação por `code`.
+     *  String crua p/ evitar ciclo de import com ../lead; o core estreita p/ LeadReferralType. */
+    acq_type?: string | null;
     [key: string]: unknown;
 }
 export type QualificationFunnelLevel = "invalid" | "new" | "trying_contact" | "contacted" | "qualifying" | "qualified" | "disqualified" | "presented" | "proposal_sent" | "negotiating" | "won" | "lost" | "waiting_reply" | "follow_up_later";

package/dist/types/evo-crm/dic/index.ts

@@ -54,6 +54,18 @@ export interface IDistChannel extends IFireDoc {
   type_name?: string;
   typeRef?: FirestoreDocumentReference;
   tags?: ITag[] | null;
+  // Regras de parsing da 1ª mensagem (feat-039) — regex casada contra o texto
+  // p/ atribuir este canal; `priority` ordena entre múltiplos matches.
+  rules?: {
+    regex: string;
+    flags?: string;
+    priority?: number;
+    description?: string | null;
+    examples?: string[] | null;
+  } | null;
+  /** Tipo FINO de aquisição (feat-039) — override explícito da derivação por `code`.
+   *  String crua p/ evitar ciclo de import com ../lead; o core estreita p/ LeadReferralType. */
+  acq_type?: string | null;
   [key: string]: unknown; // index signature
 }
 

package/dist/types/evo-crm/lead/index.d.ts

@@ -32,13 +32,15 @@ export interface ILeadDistChannel {
 /** Origem de aquisição do lead (feat-038) — base expansível p/ múltiplas
  *  plataformas. v1 implementa só `type:'ctwa'` (Click-to-WhatsApp da Meta);
  *  Google Ads / Instagram Direct / TikTok / site ficam para fast-follow. */
-export type LeadReferralType = "ctwa" | "instagram_direct" | "google_ads" | "tiktok" | "site" | "other";
+export type LeadReferralType = "ctwa" | "instagram_direct" | "google_ads" | "tiktok" | "site" | "meta_organic" | "referral" | "other";
 export interface ILeadReferralBase {
     type: LeadReferralType;
     captured_at?: Date | string | null;
     source_url?: string | null;
     label?: string | null;
     raw?: Record<string, unknown> | null;
+    dist_channel_code?: string | null;
+    matched_rule?: string | null;
 }
 export interface ILeadReferralCTWA extends ILeadReferralBase {
     type: "ctwa";
@@ -49,7 +51,14 @@ export interface ILeadReferralCTWA extends ILeadReferralBase {
     media_type?: string | null;
     ctwa_clid?: string | null;
 }
-export type ILeadReferral = ILeadReferralCTWA;
+/** Origem genérica derivada da 1ª mensagem (feat-039) — Google/TikTok/site/
+ *  FB-IG orgânico/indicação. O `type` FINO vem do `acq_type` do dict ou do mapa
+ *  por `code`; `dist_channel_code`/`matched_rule` ficam na base p/ auditoria. */
+export interface ILeadReferralGeneric extends ILeadReferralBase {
+    type: "google_ads" | "tiktok" | "site" | "instagram_direct" | "meta_organic" | "referral" | "other";
+    headline?: string | null;
+}
+export type ILeadReferral = ILeadReferralCTWA | ILeadReferralGeneric;
 /** Estado da régua de reativação de lead (feat-037).
  *  Mantido pelo subscriber `ticket_closed` (streak) e pela task
  *  `lead_reactivation` (último disparo). Semântica do streak alinhada ao

package/dist/types/evo-crm/lead/index.ts

@@ -53,6 +53,8 @@ export type LeadReferralType =
   | "google_ads" // gclid / token em ?text=                     ← futuro
   | "tiktok"
   | "site"
+  | "meta_organic" // menção/URL orgânica de FB/IG (não-pago, sem referral)  ← feat-039
+  | "referral" // indicação ("me indicaram", "amigo falou")              ← feat-039
   | "other"; // ← futuro
 
 export interface ILeadReferralBase {
@@ -61,6 +63,8 @@ export interface ILeadReferralBase {
   source_url?: string | null; // link clicável
   label?: string | null; // rótulo de exibição (headline || ad_id || domínio)
   raw?: Record<string, unknown> | null; // payload original lossless → re-parse futuro sem backfill
+  dist_channel_code?: string | null; // code do entry do dict que casou (ex.: 'GOOGLE')  ← feat-039
+  matched_rule?: string | null; // regex/priority que casou (debug; opcional)        ← feat-039
 }
 
 export interface ILeadReferralCTWA extends ILeadReferralBase {
@@ -73,7 +77,22 @@ export interface ILeadReferralCTWA extends ILeadReferralBase {
   ctwa_clid?: string | null; // espelho; o de topo (CAPI/feat-034) permanece na raiz
 }
 
-export type ILeadReferral = ILeadReferralCTWA; // | ILeadReferralGoogleAds | ...
+/** Origem genérica derivada da 1ª mensagem (feat-039) — Google/TikTok/site/
+ *  FB-IG orgânico/indicação. O `type` FINO vem do `acq_type` do dict ou do mapa
+ *  por `code`; `dist_channel_code`/`matched_rule` ficam na base p/ auditoria. */
+export interface ILeadReferralGeneric extends ILeadReferralBase {
+  type:
+    | "google_ads"
+    | "tiktok"
+    | "site"
+    | "instagram_direct"
+    | "meta_organic"
+    | "referral"
+    | "other";
+  headline?: string | null; // paridade com CTWA p/ o FE existente
+}
+
+export type ILeadReferral = ILeadReferralCTWA | ILeadReferralGeneric;
 
 /** Estado da régua de reativação de lead (feat-037).
  *  Mantido pelo subscriber `ticket_closed` (streak) e pela task

package/dist/types/nex-tenants/chatbee-import.d.ts

@@ -0,0 +1,193 @@
+import { z } from "zod";
+import type { IFireGlobalDoc } from "../shared";
+export declare const CHATBEE_IMPORT_SCHEMA_VERSION: 1;
+export declare const CHATBEE_IMPORT_FIRESTORE_PATH: "core/nexus/apps/nex-tenants/chatbee_imports";
+export declare const CHATBEE_IMPORT_PUBSUB_TOPIC: "app_nexus_chatbee-import_request";
+/**
+ * Per-(tenant, channel) department mapping doc, keyed `{tenant}__{channelId}`.
+ * Holds the operator's resolution of unresolved Chatbee departments before a
+ * real import is allowed to run.
+ */
+export declare const CHATBEE_IMPORT_DEPT_MAP_PATH: "core/nexus/apps/nex-tenants/chatbee_import_dept_maps";
+/** Mapping sentinel: route this Chatbee department to the channel's default. */
+export declare const CHANNEL_DEFAULT_DEPT_SENTINEL: "__channel_default__";
+export type ChatbeeImportStatus = "pending" | "running" | "done" | "failed";
+/** A job runs either as a read-only analysis pass or the real import. */
+export type ChatbeeImportMode = "analyze" | "import";
+export type ChatbeeImportAuditAction = "import_requested" | "import_started" | "import_page" | "import_completed" | "import_failed" | "analyze_requested" | "analyze_completed" | "dept_map_saved";
+/** Resolution status of one Chatbee department against the platform. */
+export type ChatbeeDeptResolutionStatus = "resolved" | "resolved_no_inbox" | "missing" | "no_external_id" | "mapped";
+/**
+ * Keyset cursor over `chatbee.msgs_raw` ordered by
+ * (contact.id, history.id, timestamp, message.id). A page resumes strictly
+ * AFTER this tuple. `null` (no cursor) means the run starts from the beginning.
+ */
+export interface IChatbeeImportCursor {
+    contact_id: string;
+    history_id: string;
+    /** Message event time as epoch microseconds (BQ TIMESTAMP precision). */
+    timestamp_us: string;
+    message_id: string;
+}
+/**
+ * Running totals committed per page so the UI can render live progress and a
+ * re-publish (self-continuation) resumes from a consistent count. Idempotent
+ * re-imports inflate `messages_skipped_dup`, not `messages_imported`.
+ */
+export interface IChatbeeImportCounters {
+    messages_imported: number;
+    messages_skipped_dup: number;
+    messages_skipped_unsupported: number;
+    threads_touched: number;
+    tickets_open: number;
+    tickets_closed: number;
+    contacts_reconciled: number;
+    reconcile_conflicts: number;
+    pages_processed: number;
+    /** Distinct Chatbee departments seen across the run. */
+    departments_found: number;
+    /** Departments still blocking (not resolved nor mapped). */
+    departments_unresolved: number;
+    /** Lead links dropped because the referenced lead was missing/deleted. */
+    lead_links_missing: number;
+}
+export interface IChatbeeImportError {
+    code: string;
+    message: string;
+}
+export interface IChatbeeImportRequestedBy {
+    uid: string;
+    email: string;
+    loginId: string;
+}
+/** Resolution of one DISTINCT Chatbee department against the platform. */
+export interface IChatbeeDepartmentResolution {
+    /** Chatbee department numeric id (stable) — the mapping key. */
+    chatbee_id: string;
+    /** Chatbee department external_id (may be null → no platform correlation). */
+    external_id: string | null;
+    /** Chatbee department display name. */
+    name: string;
+    /** Distinct attendances seen under this department in the window. */
+    event_count: number;
+    tickets_open: number;
+    tickets_closed: number;
+    status: ChatbeeDeptResolutionStatus;
+    /**
+     * The platform department this resolves to: the validated `external_id` for
+     * `resolved`/`resolved_no_inbox`, or the operator mapping target for `mapped`
+     * (a platform dept id, or CHANNEL_DEFAULT_DEPT_SENTINEL). Null while blocking.
+     */
+    mapped_to?: string | null;
+}
+/** Read-only pre-import analysis report, stored on the job-doc. */
+export interface IChatbeeImportAnalysis {
+    departments: IChatbeeDepartmentResolution[];
+    channel_default: {
+        department_id: string | null;
+        exists: boolean;
+        chat_enabled: boolean;
+        has_inbox: boolean;
+        /** True when the default is usable (exists + chat_enabled + has_inbox). */
+        valid: boolean;
+    };
+    lead_links: {
+        contacts_total: number;
+        /** Contacts whose contact.lead_id points at a missing/deleted lead. */
+        lead_missing_count: number;
+    };
+    contacts: {
+        total: number;
+        /** wa-index already points at a different contact (kept Chatbee canonical). */
+        index_conflicts: number;
+    };
+    /** True if any department is unresolved/unmapped or the channel default is invalid. */
+    blocking: boolean;
+    analyzed_at?: Date | null;
+}
+/**
+ * Operator's department mapping: Chatbee department id → platform department id
+ * (or CHANNEL_DEFAULT_DEPT_SENTINEL). Stored per (tenant, channel) at
+ * CHATBEE_IMPORT_DEPT_MAP_PATH/{tenant}__{channelId}.
+ */
+export type IChatbeeImportDeptMapping = Record<string, string>;
+export interface IChatbeeImportDoc extends IFireGlobalDoc {
+    tenant: string;
+    /** Destination hub-waba channel id — threads/tickets/messages carry this channel_id. */
+    destination_channel_id: string;
+    /** 'analyze' = read-only pre-import pass; 'import' = the real import. */
+    mode?: ChatbeeImportMode;
+    /** Count-only preview: zero Firestore/PubSub/BQ writes, projects counters + totals. */
+    dry_run: boolean;
+    /** Read-only analysis report (set when mode === 'analyze'). */
+    analysis?: IChatbeeImportAnalysis | null;
+    requested_by: IChatbeeImportRequestedBy;
+    requested_at: Date | null;
+    started_at?: Date | null;
+    finished_at?: Date | null;
+    status: ChatbeeImportStatus;
+    /** Keyset cursor of the last fully-committed page; null before the first page. */
+    cursor?: IChatbeeImportCursor | null;
+    counters?: IChatbeeImportCounters | null;
+    /** Total rows matched for this tenant (filled on dry-run / first page for the UI). */
+    total_messages?: number | null;
+    error?: IChatbeeImportError | null;
+    /** Non-fatal warnings (reconcile conflicts, stale-open demotions). Capped at 50. */
+    warnings?: string[] | null;
+    import_schema_version: typeof CHATBEE_IMPORT_SCHEMA_VERSION;
+}
+export declare const ChatbeeImportRequestSchema: z.ZodObject<{
+    tenant: z.ZodString;
+    destination_channel_id: z.ZodString;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    tenant: string;
+    destination_channel_id: string;
+    dry_run?: boolean | undefined;
+}, {
+    tenant: string;
+    destination_channel_id: string;
+    dry_run?: boolean | undefined;
+}>;
+export type IChatbeeImportRequestPayload = z.infer<typeof ChatbeeImportRequestSchema>;
+export declare const ChatbeeImportAnalyzeSchema: z.ZodObject<{
+    tenant: z.ZodString;
+    destination_channel_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tenant: string;
+    destination_channel_id: string;
+}, {
+    tenant: string;
+    destination_channel_id: string;
+}>;
+export type IChatbeeImportAnalyzePayload = z.infer<typeof ChatbeeImportAnalyzeSchema>;
+export declare const ChatbeeImportSaveDeptMapSchema: z.ZodObject<{
+    tenant: z.ZodString;
+    channel_id: z.ZodString;
+    /** chatbee_id → platform dept id (or CHANNEL_DEFAULT_DEPT_SENTINEL). */
+    map: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    map: Record<string, string>;
+    tenant: string;
+    channel_id: string;
+}, {
+    map: Record<string, string>;
+    tenant: string;
+    channel_id: string;
+}>;
+export type IChatbeeImportSaveDeptMapPayload = z.infer<typeof ChatbeeImportSaveDeptMapSchema>;
+export interface IChatbeeImportPubSubEvent {
+    importId: string;
+    tenant: string;
+    destination_channel_id: string;
+    /** 'analyze' = read-only pass; 'import' = real import. */
+    mode: ChatbeeImportMode;
+    dry_run: boolean;
+    /** Cursor to resume from on a self-continuation; null/absent for the first run. */
+    cursor?: IChatbeeImportCursor | null;
+    requested_by: {
+        uid: string;
+        loginId: string;
+    };
+    trace_id: string;
+}

package/dist/types/nex-tenants/chatbee-import.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatbeeImportSaveDeptMapSchema = exports.ChatbeeImportAnalyzeSchema = exports.ChatbeeImportRequestSchema = exports.CHANNEL_DEFAULT_DEPT_SENTINEL = exports.CHATBEE_IMPORT_DEPT_MAP_PATH = exports.CHATBEE_IMPORT_PUBSUB_TOPIC = exports.CHATBEE_IMPORT_FIRESTORE_PATH = exports.CHATBEE_IMPORT_SCHEMA_VERSION = void 0;
+const zod_1 = require("zod");
+// ── Constants ──
+exports.CHATBEE_IMPORT_SCHEMA_VERSION = 1;
+exports.CHATBEE_IMPORT_FIRESTORE_PATH = "core/nexus/apps/nex-tenants/chatbee_imports";
+exports.CHATBEE_IMPORT_PUBSUB_TOPIC = "app_nexus_chatbee-import_request";
+/**
+ * Per-(tenant, channel) department mapping doc, keyed `{tenant}__{channelId}`.
+ * Holds the operator's resolution of unresolved Chatbee departments before a
+ * real import is allowed to run.
+ */
+exports.CHATBEE_IMPORT_DEPT_MAP_PATH = "core/nexus/apps/nex-tenants/chatbee_import_dept_maps";
+/** Mapping sentinel: route this Chatbee department to the channel's default. */
+exports.CHANNEL_DEFAULT_DEPT_SENTINEL = "__channel_default__";
+// ── Zod Schemas (callable payloads) ──
+exports.ChatbeeImportRequestSchema = zod_1.z.object({
+    tenant: zod_1.z.string().min(1),
+    destination_channel_id: zod_1.z.string().min(1),
+    dry_run: zod_1.z.boolean().optional(),
+});
+exports.ChatbeeImportAnalyzeSchema = zod_1.z.object({
+    tenant: zod_1.z.string().min(1),
+    destination_channel_id: zod_1.z.string().min(1),
+});
+exports.ChatbeeImportSaveDeptMapSchema = zod_1.z.object({
+    tenant: zod_1.z.string().min(1),
+    channel_id: zod_1.z.string().min(1),
+    /** chatbee_id → platform dept id (or CHANNEL_DEFAULT_DEPT_SENTINEL). */
+    map: zod_1.z.record(zod_1.z.string(), zod_1.z.string().min(1)),
+});

package/dist/types/nex-tenants/chatbee-import.ts

@@ -0,0 +1,235 @@
+import { z } from "zod";
+import type { IFireGlobalDoc } from "../shared";
+
+// ── Constants ──
+
+export const CHATBEE_IMPORT_SCHEMA_VERSION = 1 as const;
+
+export const CHATBEE_IMPORT_FIRESTORE_PATH =
+  "core/nexus/apps/nex-tenants/chatbee_imports" as const;
+
+export const CHATBEE_IMPORT_PUBSUB_TOPIC =
+  "app_nexus_chatbee-import_request" as const;
+
+/**
+ * Per-(tenant, channel) department mapping doc, keyed `{tenant}__{channelId}`.
+ * Holds the operator's resolution of unresolved Chatbee departments before a
+ * real import is allowed to run.
+ */
+export const CHATBEE_IMPORT_DEPT_MAP_PATH =
+  "core/nexus/apps/nex-tenants/chatbee_import_dept_maps" as const;
+
+/** Mapping sentinel: route this Chatbee department to the channel's default. */
+export const CHANNEL_DEFAULT_DEPT_SENTINEL = "__channel_default__" as const;
+
+// ── Enums / Literals ──
+
+export type ChatbeeImportStatus =
+  | "pending"
+  | "running"
+  | "done"
+  | "failed";
+
+/** A job runs either as a read-only analysis pass or the real import. */
+export type ChatbeeImportMode = "analyze" | "import";
+
+export type ChatbeeImportAuditAction =
+  | "import_requested"
+  | "import_started"
+  | "import_page"
+  | "import_completed"
+  | "import_failed"
+  | "analyze_requested"
+  | "analyze_completed"
+  | "dept_map_saved";
+
+/** Resolution status of one Chatbee department against the platform. */
+export type ChatbeeDeptResolutionStatus =
+  | "resolved"          // external_id → dept exists, chat_enabled, has dept inbox sub
+  | "resolved_no_inbox" // dept exists but no dept inbox subscription (ticket invisible)
+  | "missing"           // external_id set but dept doc does not exist
+  | "no_external_id"    // external_id NULL (no correlation possible)
+  | "mapped";           // operator mapped chatbee_id → platform dept (or channel default)
+
+// ── Sub-interfaces ──
+
+/**
+ * Keyset cursor over `chatbee.msgs_raw` ordered by
+ * (contact.id, history.id, timestamp, message.id). A page resumes strictly
+ * AFTER this tuple. `null` (no cursor) means the run starts from the beginning.
+ */
+export interface IChatbeeImportCursor {
+  contact_id: string;
+  history_id: string;
+  /** Message event time as epoch microseconds (BQ TIMESTAMP precision). */
+  timestamp_us: string;
+  message_id: string;
+}
+
+/**
+ * Running totals committed per page so the UI can render live progress and a
+ * re-publish (self-continuation) resumes from a consistent count. Idempotent
+ * re-imports inflate `messages_skipped_dup`, not `messages_imported`.
+ */
+export interface IChatbeeImportCounters {
+  messages_imported: number;
+  messages_skipped_dup: number;
+  messages_skipped_unsupported: number;
+  threads_touched: number;
+  tickets_open: number;
+  tickets_closed: number;
+  contacts_reconciled: number;
+  reconcile_conflicts: number;
+  pages_processed: number;
+  /** Distinct Chatbee departments seen across the run. */
+  departments_found: number;
+  /** Departments still blocking (not resolved nor mapped). */
+  departments_unresolved: number;
+  /** Lead links dropped because the referenced lead was missing/deleted. */
+  lead_links_missing: number;
+}
+
+export interface IChatbeeImportError {
+  code: string;
+  message: string;
+}
+
+export interface IChatbeeImportRequestedBy {
+  uid: string;
+  email: string;
+  loginId: string;
+}
+
+// ── Analysis sub-interfaces ──
+
+/** Resolution of one DISTINCT Chatbee department against the platform. */
+export interface IChatbeeDepartmentResolution {
+  /** Chatbee department numeric id (stable) — the mapping key. */
+  chatbee_id: string;
+  /** Chatbee department external_id (may be null → no platform correlation). */
+  external_id: string | null;
+  /** Chatbee department display name. */
+  name: string;
+  /** Distinct attendances seen under this department in the window. */
+  event_count: number;
+  tickets_open: number;
+  tickets_closed: number;
+  status: ChatbeeDeptResolutionStatus;
+  /**
+   * The platform department this resolves to: the validated `external_id` for
+   * `resolved`/`resolved_no_inbox`, or the operator mapping target for `mapped`
+   * (a platform dept id, or CHANNEL_DEFAULT_DEPT_SENTINEL). Null while blocking.
+   */
+  mapped_to?: string | null;
+}
+
+/** Read-only pre-import analysis report, stored on the job-doc. */
+export interface IChatbeeImportAnalysis {
+  departments: IChatbeeDepartmentResolution[];
+  channel_default: {
+    department_id: string | null;
+    exists: boolean;
+    chat_enabled: boolean;
+    has_inbox: boolean;
+    /** True when the default is usable (exists + chat_enabled + has_inbox). */
+    valid: boolean;
+  };
+  lead_links: {
+    contacts_total: number;
+    /** Contacts whose contact.lead_id points at a missing/deleted lead. */
+    lead_missing_count: number;
+  };
+  contacts: {
+    total: number;
+    /** wa-index already points at a different contact (kept Chatbee canonical). */
+    index_conflicts: number;
+  };
+  /** True if any department is unresolved/unmapped or the channel default is invalid. */
+  blocking: boolean;
+  analyzed_at?: Date | null;
+}
+
+/**
+ * Operator's department mapping: Chatbee department id → platform department id
+ * (or CHANNEL_DEFAULT_DEPT_SENTINEL). Stored per (tenant, channel) at
+ * CHATBEE_IMPORT_DEPT_MAP_PATH/{tenant}__{channelId}.
+ */
+export type IChatbeeImportDeptMapping = Record<string, string>;
+
+// ── Main Document ──
+
+export interface IChatbeeImportDoc extends IFireGlobalDoc {
+  tenant: string;
+  /** Destination hub-waba channel id — threads/tickets/messages carry this channel_id. */
+  destination_channel_id: string;
+  /** 'analyze' = read-only pre-import pass; 'import' = the real import. */
+  mode?: ChatbeeImportMode;
+  /** Count-only preview: zero Firestore/PubSub/BQ writes, projects counters + totals. */
+  dry_run: boolean;
+  /** Read-only analysis report (set when mode === 'analyze'). */
+  analysis?: IChatbeeImportAnalysis | null;
+  requested_by: IChatbeeImportRequestedBy;
+  requested_at: Date | null;
+  started_at?: Date | null;
+  finished_at?: Date | null;
+  status: ChatbeeImportStatus;
+  /** Keyset cursor of the last fully-committed page; null before the first page. */
+  cursor?: IChatbeeImportCursor | null;
+  counters?: IChatbeeImportCounters | null;
+  /** Total rows matched for this tenant (filled on dry-run / first page for the UI). */
+  total_messages?: number | null;
+  error?: IChatbeeImportError | null;
+  /** Non-fatal warnings (reconcile conflicts, stale-open demotions). Capped at 50. */
+  warnings?: string[] | null;
+  import_schema_version: typeof CHATBEE_IMPORT_SCHEMA_VERSION;
+}
+
+// ── Zod Schemas (callable payloads) ──
+
+export const ChatbeeImportRequestSchema = z.object({
+  tenant: z.string().min(1),
+  destination_channel_id: z.string().min(1),
+  dry_run: z.boolean().optional(),
+});
+
+export type IChatbeeImportRequestPayload = z.infer<
+  typeof ChatbeeImportRequestSchema
+>;
+
+export const ChatbeeImportAnalyzeSchema = z.object({
+  tenant: z.string().min(1),
+  destination_channel_id: z.string().min(1),
+});
+
+export type IChatbeeImportAnalyzePayload = z.infer<
+  typeof ChatbeeImportAnalyzeSchema
+>;
+
+export const ChatbeeImportSaveDeptMapSchema = z.object({
+  tenant: z.string().min(1),
+  channel_id: z.string().min(1),
+  /** chatbee_id → platform dept id (or CHANNEL_DEFAULT_DEPT_SENTINEL). */
+  map: z.record(z.string(), z.string().min(1)),
+});
+
+export type IChatbeeImportSaveDeptMapPayload = z.infer<
+  typeof ChatbeeImportSaveDeptMapSchema
+>;
+
+// ── PubSub Event ──
+
+export interface IChatbeeImportPubSubEvent {
+  importId: string;
+  tenant: string;
+  destination_channel_id: string;
+  /** 'analyze' = read-only pass; 'import' = real import. */
+  mode: ChatbeeImportMode;
+  dry_run: boolean;
+  /** Cursor to resume from on a self-continuation; null/absent for the first run. */
+  cursor?: IChatbeeImportCursor | null;
+  requested_by: {
+    uid: string;
+    loginId: string;
+  };
+  trace_id: string;
+}

package/dist/types/nex-tenants/index.d.ts

@@ -1 +1,2 @@
 export * from "./lgpd-export";
+export * from "./chatbee-import";

package/dist/types/nex-tenants/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lgpd-export"), exports);
+__exportStar(require("./chatbee-import"), exports);

package/dist/types/nex-tenants/index.ts

@@ -1 +1,2 @@
 export * from "./lgpd-export";
+export * from "./chatbee-import";

package/package.json

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