evo360-types 1.3.512 → 1.3.514

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

@@ -7,12 +7,35 @@ export interface SearchThreadsParams {
     department_ids?: string[];
     attendant_type?: SearchAttendantType;
     assigned_user_id?: string;
+    /** Atendente que ENCERROU algum ticket da conversa na janela. */
+    closed_by_user_id?: string;
+    close_codes?: string[];
     tag_ids?: string[];
     /** Free-text contains-match against contact_name (case-insensitive) OR contact_address (digits/email/etc). */
     search?: string;
     cursor?: string;
     limit?: number;
 }
+/**
+ * Janela de datas efetivamente usada na consulta.
+ *
+ * Existe porque o backend aplica um default quando o cliente nao manda datas —
+ * e ate a feat-127 nao contava isso a ninguem. O usuario procurava uma conversa
+ * fora da janela, recebia lista vazia e concluia que ela tinha sumido.
+ *
+ * `default_window_days` vem junto para o cliente rotular ("ultimos 30 dias") sem
+ * duplicar a constante: a regra tem UM dono, que e' o backend.
+ */
+export interface AppliedWindow {
+    /** ISO. Inicio da janela consultada. */
+    date_from: string;
+    /** ISO. Fim da janela consultada. */
+    date_to: string;
+    /** true = o cliente nao mandou datas e o backend aplicou o default. */
+    defaulted: boolean;
+    /** Tamanho do default, em dias. */
+    default_window_days: number;
+}
 export interface SearchThreadCursor {
     last_activity_ms: number;
     contact_id: string;
@@ -66,8 +89,58 @@ export interface SearchThreadsResponse {
     ok: true;
     threads: ThreadAggregate[];
     nextCursor?: string;
+    /** Janela realmente aplicada — mandada pelo cliente ou default do backend. */
+    applied_window: AppliedWindow;
+    /**
+     * Total de CONVERSAS (contatos distintos) que casam com os filtros na janela.
+     *
+     * Independente de paginacao: e' o mesmo valor em todas as paginas. Sai da
+     * propria query da lista (`COUNT(*) OVER ()`), sem query extra e sem bytes
+     * adicionais — o agregado por contato ja e' materializado inteiro antes do
+     * LIMIT.
+     */
+    total: number;
     stats: SearchThreadsStats;
 }
+/**
+ * Dimensoes com contagem na busca avancada.
+ *
+ * `tag_ids` NAO esta aqui de proposito: tags nao existem no BigQuery — o filtro
+ * por tag resolve os contatos no Firestore ANTES da query. Facetar exigiria
+ * varrer leads por tag a cada mudanca de filtro, no caminho quente da tela.
+ */
+export type SearchFacetDimension = 'status' | 'department_id' | 'attendant_type' | 'assigned_user_id' | 'closed_by_user_id' | 'close_code';
+export interface SearchFacetBucket {
+    value: string;
+    /** Contagem em CONVERSAS distintas (contatos), NAO em tickets. */
+    count: number;
+    /**
+     * So' preenchido em `closed_by_user_id`. Hub-omni e' cross-tenant: quem
+     * encerra um ticket do tenant X nem sempre consta em `tenants/X/users`, entao
+     * o cliente nao tem como resolver esse rotulo sozinho. Nas demais dimensoes o
+     * cliente ja carrega o dicionario correspondente.
+     */
+    label?: string;
+}
+export interface SearchFacetsStats {
+    bq_query_id?: string;
+    bq_bytes_processed?: number;
+    duration_ms: number;
+}
+export interface SearchFacetsResponse {
+    ok: true;
+    /**
+     * Contagem por dimensao. Cada dimensao aplica TODOS os filtros ativos MENOS o
+     * dela propria (faceting classico) — senao marcar uma opcao zeraria todas as
+     * outras da mesma lista.
+     *
+     * Valor ausente = zero. O cliente que renderiza a lista de opcoes a partir de
+     * um dicionario deve tratar ausencia como `(0)`.
+     */
+    facets: Record<SearchFacetDimension, SearchFacetBucket[]>;
+    applied_window: AppliedWindow;
+    stats: SearchFacetsStats;
+}
 export type SearchThreadsErrorCode = 'invalid_filter' | 'tag_filter_too_broad' | 'forbidden' | 'bq_error' | 'fs_error';
 export interface SearchThreadsErrorResponse {
     ok: false;
@@ -135,5 +208,7 @@ export interface TimelineResponse {
     ok: true;
     timeline: TimelineEntry[];
     nextCursor?: string;
+    /** Mesma janela default silenciosa da lista — ver `AppliedWindow`. */
+    applied_window: AppliedWindow;
     stats: TimelineStats;
 }

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

@@ -14,6 +14,9 @@ export interface SearchThreadsParams {
   department_ids?: string[];
   attendant_type?: SearchAttendantType;
   assigned_user_id?: string;
+  /** Atendente que ENCERROU algum ticket da conversa na janela. */
+  closed_by_user_id?: string;
+  close_codes?: string[];
   tag_ids?: string[];
   /** Free-text contains-match against contact_name (case-insensitive) OR contact_address (digits/email/etc). */
   search?: string;
@@ -21,6 +24,27 @@ export interface SearchThreadsParams {
   limit?: number;
 }
 
+/**
+ * Janela de datas efetivamente usada na consulta.
+ *
+ * Existe porque o backend aplica um default quando o cliente nao manda datas —
+ * e ate a feat-127 nao contava isso a ninguem. O usuario procurava uma conversa
+ * fora da janela, recebia lista vazia e concluia que ela tinha sumido.
+ *
+ * `default_window_days` vem junto para o cliente rotular ("ultimos 30 dias") sem
+ * duplicar a constante: a regra tem UM dono, que e' o backend.
+ */
+export interface AppliedWindow {
+  /** ISO. Inicio da janela consultada. */
+  date_from: string;
+  /** ISO. Fim da janela consultada. */
+  date_to: string;
+  /** true = o cliente nao mandou datas e o backend aplicou o default. */
+  defaulted: boolean;
+  /** Tamanho do default, em dias. */
+  default_window_days: number;
+}
+
 export interface SearchThreadCursor {
   last_activity_ms: number;
   contact_id: string;
@@ -80,9 +104,71 @@ export interface SearchThreadsResponse {
   ok: true;
   threads: ThreadAggregate[];
   nextCursor?: string;
+  /** Janela realmente aplicada — mandada pelo cliente ou default do backend. */
+  applied_window: AppliedWindow;
+  /**
+   * Total de CONVERSAS (contatos distintos) que casam com os filtros na janela.
+   *
+   * Independente de paginacao: e' o mesmo valor em todas as paginas. Sai da
+   * propria query da lista (`COUNT(*) OVER ()`), sem query extra e sem bytes
+   * adicionais — o agregado por contato ja e' materializado inteiro antes do
+   * LIMIT.
+   */
+  total: number;
   stats: SearchThreadsStats;
 }
 
+// ── Facets ──
+
+/**
+ * Dimensoes com contagem na busca avancada.
+ *
+ * `tag_ids` NAO esta aqui de proposito: tags nao existem no BigQuery — o filtro
+ * por tag resolve os contatos no Firestore ANTES da query. Facetar exigiria
+ * varrer leads por tag a cada mudanca de filtro, no caminho quente da tela.
+ */
+export type SearchFacetDimension =
+  | 'status'
+  | 'department_id'
+  | 'attendant_type'
+  | 'assigned_user_id'
+  | 'closed_by_user_id'
+  | 'close_code';
+
+export interface SearchFacetBucket {
+  value: string;
+  /** Contagem em CONVERSAS distintas (contatos), NAO em tickets. */
+  count: number;
+  /**
+   * So' preenchido em `closed_by_user_id`. Hub-omni e' cross-tenant: quem
+   * encerra um ticket do tenant X nem sempre consta em `tenants/X/users`, entao
+   * o cliente nao tem como resolver esse rotulo sozinho. Nas demais dimensoes o
+   * cliente ja carrega o dicionario correspondente.
+   */
+  label?: string;
+}
+
+export interface SearchFacetsStats {
+  bq_query_id?: string;
+  bq_bytes_processed?: number;
+  duration_ms: number;
+}
+
+export interface SearchFacetsResponse {
+  ok: true;
+  /**
+   * Contagem por dimensao. Cada dimensao aplica TODOS os filtros ativos MENOS o
+   * dela propria (faceting classico) — senao marcar uma opcao zeraria todas as
+   * outras da mesma lista.
+   *
+   * Valor ausente = zero. O cliente que renderiza a lista de opcoes a partir de
+   * um dicionario deve tratar ausencia como `(0)`.
+   */
+  facets: Record<SearchFacetDimension, SearchFacetBucket[]>;
+  applied_window: AppliedWindow;
+  stats: SearchFacetsStats;
+}
+
 export type SearchThreadsErrorCode =
   | 'invalid_filter'
   | 'tag_filter_too_broad'
@@ -178,5 +264,7 @@ export interface TimelineResponse {
   ok: true;
   timeline: TimelineEntry[];
   nextCursor?: string;
+  /** Mesma janela default silenciosa da lista — ver `AppliedWindow`. */
+  applied_window: AppliedWindow;
   stats: TimelineStats;
 }

package/package.json

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