evo360-types 1.3.390 → 1.3.391

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.390",
+  "version": "1.3.391",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",