evo360-types 1.3.389 → 1.3.391

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

@@ -29,6 +29,27 @@ export interface ILeadDistChannel {
     ref?: FirestoreDocumentReference;
     updated_at?: Date | null;
 }
+/** 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 interface ILeadReferralBase {
+    type: LeadReferralType;
+    captured_at?: Date | string | null;
+    source_url?: string | null;
+    label?: string | null;
+    raw?: Record<string, unknown> | null;
+}
+export interface ILeadReferralCTWA extends ILeadReferralBase {
+    type: "ctwa";
+    ad_id?: string | null;
+    source_type?: string | null;
+    headline?: string | null;
+    body?: string | null;
+    media_type?: string | null;
+    ctwa_clid?: string | null;
+}
+export type ILeadReferral = ILeadReferralCTWA;
 /** 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
@@ -57,6 +78,10 @@ export interface ILead extends IProfile {
     tags?: ITag[] | null;
     userRef?: FirestoreDocumentReference;
     ctwa_clid?: string | null;
+    /**
+     * @deprecated A ESCRITA foi substituída por `acquisition_sources[]` (feat-038).
+     * Tipo mantido para leitura de leads antigos; sem backfill.
+     */
     ctwa_referral?: {
         source_type?: string;
         source_id?: string;
@@ -66,6 +91,7 @@ export interface ILead extends IProfile {
         media_type?: string;
         captured_at?: Date | string | null;
     } | null;
+    acquisition_sources?: ILeadReferral[] | null;
     reactivation?: ILeadReactivation | null;
     [key: string]: unknown;
 }

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

@@ -44,6 +44,37 @@ export interface ILeadDistChannel {
   updated_at?: Date | null;
 }
 
+/** 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" // Click-to-WhatsApp (Meta FB/IG → WhatsApp)  ← v1
+  | "instagram_direct" // ig.me ?ref=                                 ← futuro
+  | "google_ads" // gclid / token em ?text=                     ← futuro
+  | "tiktok"
+  | "site"
+  | "other"; // ← futuro
+
+export interface ILeadReferralBase {
+  type: LeadReferralType; // discriminador p/ o parser
+  captured_at?: Date | string | null; // 1º toque desta origem (idioma do repo)
+  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
+}
+
+export interface ILeadReferralCTWA extends ILeadReferralBase {
+  type: "ctwa";
+  ad_id?: string | null; // referral.source_id
+  source_type?: string | null; // 'ad' | 'post'
+  headline?: string | null;
+  body?: string | null;
+  media_type?: string | null;
+  ctwa_clid?: string | null; // espelho; o de topo (CAPI/feat-034) permanece na raiz
+}
+
+export type ILeadReferral = ILeadReferralCTWA; // | ILeadReferralGoogleAds | ...
+
 /** 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
@@ -74,6 +105,10 @@ export interface ILead extends IProfile {
   userRef?: FirestoreDocumentReference;
   // CTWA attribution (feat-034) — capturado do referral do 1º inbound vindo de anúncio Click-to-WhatsApp.
   ctwa_clid?: string | null;
+  /**
+   * @deprecated A ESCRITA foi substituída por `acquisition_sources[]` (feat-038).
+   * Tipo mantido para leitura de leads antigos; sem backfill.
+   */
   ctwa_referral?: {
     source_type?: string;
     source_id?: string;
@@ -83,6 +118,9 @@ export interface ILead extends IProfile {
     media_type?: string;
     captured_at?: Date | string | null;
   } | null;
+  // Origens de aquisição multi-touch (feat-038) — união discriminada por `type`.
+  // Substitui a escrita de `ctwa_referral`; `ctwa_clid` de topo permanece (CAPI).
+  acquisition_sources?: ILeadReferral[] | null;
   // Régua de reativação (feat-037) — mantida pelo subscriber ticket_closed + task lead_reactivation.
   reactivation?: ILeadReactivation | null;
   [key: string]: unknown; // index signature

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

@@ -0,0 +1,92 @@
+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";
+export type ChatbeeImportStatus = "pending" | "running" | "done" | "failed";
+export type ChatbeeImportAuditAction = "import_requested" | "import_started" | "import_page" | "import_completed" | "import_failed";
+/**
+ * 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;
+}
+export interface IChatbeeImportError {
+    code: string;
+    message: string;
+}
+export interface IChatbeeImportRequestedBy {
+    uid: string;
+    email: string;
+    loginId: string;
+}
+export interface IChatbeeImportDoc extends IFireGlobalDoc {
+    tenant: string;
+    /** Destination hub-waba channel id — threads/tickets/messages carry this channel_id. */
+    destination_channel_id: string;
+    /** Count-only preview: zero Firestore/PubSub/BQ writes, projects counters + totals. */
+    dry_run: boolean;
+    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 interface IChatbeeImportPubSubEvent {
+    importId: string;
+    tenant: string;
+    destination_channel_id: string;
+    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,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatbeeImportRequestSchema = 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";
+// ── 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(),
+});

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

@@ -0,0 +1,122 @@
+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;
+
+// ── Enums / Literals ──
+
+export type ChatbeeImportStatus =
+  | "pending"
+  | "running"
+  | "done"
+  | "failed";
+
+export type ChatbeeImportAuditAction =
+  | "import_requested"
+  | "import_started"
+  | "import_page"
+  | "import_completed"
+  | "import_failed";
+
+// ── 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;
+}
+
+export interface IChatbeeImportError {
+  code: string;
+  message: string;
+}
+
+export interface IChatbeeImportRequestedBy {
+  uid: string;
+  email: string;
+  loginId: 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;
+  /** Count-only preview: zero Firestore/PubSub/BQ writes, projects counters + totals. */
+  dry_run: boolean;
+  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
+>;
+
+// ── PubSub Event ──
+
+export interface IChatbeeImportPubSubEvent {
+  importId: string;
+  tenant: string;
+  destination_channel_id: string;
+  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.389",
+  "version": "1.3.391",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",