evo360-types 1.3.336 → 1.3.338

package/dist/apps/evo-finops/zod-schemas.d.ts

@@ -10083,7 +10083,7 @@ export declare const zTakerTaxProfileSchema: z.ZodObject<{
     observations: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    type: "PJ" | "PF" | "unknown";
+    type: "unknown" | "PJ" | "PF";
     email?: string | undefined;
     address?: z.objectOutputType<{
         postalCode: z.ZodOptional<z.ZodString>;
@@ -10103,7 +10103,7 @@ export declare const zTakerTaxProfileSchema: z.ZodObject<{
     observations?: string | undefined;
 }, {
     name: string;
-    type: "PJ" | "PF" | "unknown";
+    type: "unknown" | "PJ" | "PF";
     email?: string | undefined;
     address?: z.objectInputType<{
         postalCode: z.ZodOptional<z.ZodString>;
@@ -10392,7 +10392,7 @@ export declare const zInvoiceTakerSnapshotSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    taker_type: "PJ" | "PF" | "unknown";
+    taker_type: "unknown" | "PJ" | "PF";
     email?: string | undefined;
     address?: z.objectOutputType<{
         street: z.ZodOptional<z.ZodString>;
@@ -10409,7 +10409,7 @@ export declare const zInvoiceTakerSnapshotSchema: z.ZodObject<{
     cpf_cnpj?: string | undefined;
 }, {
     name: string;
-    taker_type: "PJ" | "PF" | "unknown";
+    taker_type: "unknown" | "PJ" | "PF";
     email?: string | undefined;
     address?: z.objectInputType<{
         street: z.ZodOptional<z.ZodString>;
@@ -10466,7 +10466,7 @@ export declare const zInvoiceTakerRefSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough">>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        taker_type: "PJ" | "PF" | "unknown";
+        taker_type: "unknown" | "PJ" | "PF";
         email?: string | undefined;
         address?: z.objectOutputType<{
             street: z.ZodOptional<z.ZodString>;
@@ -10483,7 +10483,7 @@ export declare const zInvoiceTakerRefSchema: z.ZodObject<{
         cpf_cnpj?: string | undefined;
     }, {
         name: string;
-        taker_type: "PJ" | "PF" | "unknown";
+        taker_type: "unknown" | "PJ" | "PF";
         email?: string | undefined;
         address?: z.objectInputType<{
             street: z.ZodOptional<z.ZodString>;
@@ -10502,7 +10502,7 @@ export declare const zInvoiceTakerRefSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     snapshot: {
         name: string;
-        taker_type: "PJ" | "PF" | "unknown";
+        taker_type: "unknown" | "PJ" | "PF";
         email?: string | undefined;
         address?: z.objectOutputType<{
             street: z.ZodOptional<z.ZodString>;
@@ -10524,7 +10524,7 @@ export declare const zInvoiceTakerRefSchema: z.ZodObject<{
 }, {
     snapshot: {
         name: string;
-        taker_type: "PJ" | "PF" | "unknown";
+        taker_type: "unknown" | "PJ" | "PF";
         email?: string | undefined;
         address?: z.objectInputType<{
             street: z.ZodOptional<z.ZodString>;
@@ -10754,7 +10754,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10771,7 +10771,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
             cpf_cnpj?: string | undefined;
         }, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10790,7 +10790,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10812,7 +10812,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
     }, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10939,7 +10939,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10956,7 +10956,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
             cpf_cnpj?: string | undefined;
         }, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10975,7 +10975,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -10997,7 +10997,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
     }, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11124,7 +11124,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11141,7 +11141,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
             cpf_cnpj?: string | undefined;
         }, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11160,7 +11160,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11182,7 +11182,7 @@ export declare const zPaymentLinkSchema: z.ZodObject<{
     }, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11329,7 +11329,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11346,7 +11346,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
             cpf_cnpj?: string | undefined;
         }, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11365,7 +11365,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11387,7 +11387,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
     }, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11748,7 +11748,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11765,7 +11765,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
             cpf_cnpj?: string | undefined;
         }, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11784,7 +11784,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -11806,7 +11806,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
     }, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -12167,7 +12167,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
             }, z.ZodTypeAny, "passthrough">>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -12184,7 +12184,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
             cpf_cnpj?: string | undefined;
         }, {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -12203,7 +12203,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectOutputType<{
                 street: z.ZodOptional<z.ZodString>;
@@ -12225,7 +12225,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
     }, {
         snapshot: {
             name: string;
-            taker_type: "PJ" | "PF" | "unknown";
+            taker_type: "unknown" | "PJ" | "PF";
             email?: string | undefined;
             address?: z.objectInputType<{
                 street: z.ZodOptional<z.ZodString>;

package/dist/apps/evo-notif-user/zod-schemas.d.ts

@@ -18,14 +18,14 @@ export declare const zNotifUserSourceSchema: z.ZodObject<{
     actorId: z.ZodOptional<z.ZodString>;
     actorName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    module: string;
     event: string;
+    module: string;
     actorType?: "user" | "system" | "automation" | "ai" | undefined;
     actorId?: string | undefined;
     actorName?: string | undefined;
 }, {
-    module: string;
     event: string;
+    module: string;
     actorType?: "user" | "system" | "automation" | "ai" | undefined;
     actorId?: string | undefined;
     actorName?: string | undefined;
@@ -87,14 +87,14 @@ export declare const zNotifUserSchema: z.ZodObject<{
         actorId: z.ZodOptional<z.ZodString>;
         actorName: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
     }, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
@@ -166,14 +166,14 @@ export declare const zNotifUserSchema: z.ZodObject<{
         actorId: z.ZodOptional<z.ZodString>;
         actorName: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
     }, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
@@ -245,14 +245,14 @@ export declare const zNotifUserSchema: z.ZodObject<{
         actorId: z.ZodOptional<z.ZodString>;
         actorName: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
     }, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
@@ -323,14 +323,14 @@ export declare const zCreateNotifUserInputSchema: z.ZodObject<{
         actorId: z.ZodOptional<z.ZodString>;
         actorName: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
     }, {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
@@ -381,8 +381,8 @@ export declare const zCreateNotifUserInputSchema: z.ZodObject<{
     category: string;
     userId: string;
     source?: {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;
@@ -414,8 +414,8 @@ export declare const zCreateNotifUserInputSchema: z.ZodObject<{
     category: string;
     userId: string;
     source?: {
-        module: string;
         event: string;
+        module: string;
         actorType?: "user" | "system" | "automation" | "ai" | undefined;
         actorId?: string | undefined;
         actorName?: string | undefined;

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

@@ -9,6 +9,7 @@ export * from "./ticket";
 export * from "./inbox";
 export * from "./waba-template";
 export * from "./quick-reply";
+export * from "./search";
 export declare const EvoChatPermissions: {
     readonly Read: "evo_chat_read";
     readonly Write: "evo_chat_write";

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

@@ -26,6 +26,7 @@ __exportStar(require("./ticket"), exports);
 __exportStar(require("./inbox"), exports);
 __exportStar(require("./waba-template"), exports);
 __exportStar(require("./quick-reply"), exports);
+__exportStar(require("./search"), exports);
 // Permissões para o evo-chat
 exports.EvoChatPermissions = {
     Read: "evo_chat_read",

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

@@ -9,6 +9,7 @@ export * from "./ticket";
 export * from "./inbox";
 export * from "./waba-template";
 export * from "./quick-reply";
+export * from "./search";
 
 // Permissões para o evo-chat
 export const EvoChatPermissions = {

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

@@ -0,0 +1,135 @@
+export type SearchTicketStatus = 'open' | 'closed';
+export type SearchAttendantType = 'ai' | 'human' | 'hybrid' | 'unknown';
+export interface SearchThreadsParams {
+    date_from?: string;
+    date_to?: string;
+    status?: SearchTicketStatus;
+    department_ids?: string[];
+    attendant_type?: SearchAttendantType;
+    assigned_user_id?: string;
+    tag_ids?: string[];
+    cursor?: string;
+    limit?: number;
+}
+export interface SearchThreadCursor {
+    last_activity_ms: number;
+    contact_id: string;
+}
+export interface ThreadAggregateContact {
+    name: string;
+    subtitle?: string;
+    lead_id?: string | null;
+}
+export interface ThreadAggregateTag {
+    id: string;
+    name: string;
+    color?: string;
+}
+export interface ThreadAggregateCurrentOpenTicket {
+    id: string;
+    department_id?: string;
+    department_name?: string;
+    assigned_user_id?: string | null;
+    assigned_user_name?: string | null;
+    attendant_type?: SearchAttendantType | null;
+    last_message_at?: string;
+    waiting_since?: string;
+    unread_count?: number;
+    open_count_match: boolean;
+}
+export interface ThreadAggregate {
+    tenant: string;
+    contact_id: string;
+    thread_id: string;
+    last_activity_at: string;
+    total_tickets: number;
+    open_count_bq: number;
+    closed_count_bq: number;
+    departments_seen: string[];
+    attendant_types_seen: SearchAttendantType[];
+    latest_ticket_id?: string | null;
+    contact?: ThreadAggregateContact;
+    tags?: ThreadAggregateTag[];
+    current_open_ticket?: ThreadAggregateCurrentOpenTicket | null;
+}
+export interface SearchThreadsStats {
+    bq_query_id?: string;
+    bq_bytes_processed?: number;
+    fs_reads: number;
+    duration_ms: number;
+}
+export interface SearchThreadsResponse {
+    ok: true;
+    threads: ThreadAggregate[];
+    nextCursor?: string;
+    stats: SearchThreadsStats;
+}
+export type SearchThreadsErrorCode = 'invalid_filter' | 'tag_filter_too_broad' | 'forbidden' | 'bq_error' | 'fs_error';
+export interface SearchThreadsErrorResponse {
+    ok: false;
+    error: string;
+    code: SearchThreadsErrorCode;
+    error_id?: string;
+}
+export type TimelineEntryType = 'event' | 'message_in' | 'message_out' | 'internal_note' | 'status' | 'reaction';
+export interface TimelineParams {
+    date_from?: string;
+    date_to?: string;
+    types?: TimelineEntryType[];
+    cursor?: string;
+    limit?: number;
+}
+export interface TimelineEventEntry {
+    type: 'event';
+    occurred_at: string;
+    event_id: string;
+    event_type: string;
+    ticket_id?: string;
+    actor_display_name?: string;
+    department_name?: string;
+    extras?: Record<string, unknown>;
+}
+export interface TimelineMessageEntry {
+    type: 'message_in' | 'message_out' | 'internal_note';
+    occurred_at: string;
+    firestore_message_id: string;
+    direction: 'in' | 'out' | 'internal';
+    message_type: string;
+    body_preview?: string;
+    channel_type?: string;
+    ticket_id?: string;
+}
+export interface TimelineStatusEntry {
+    type: 'status';
+    occurred_at: string;
+    firestore_message_id: string;
+    status_type: string;
+    channel_type?: string;
+    error_code?: string;
+}
+export interface TimelineReactionEntry {
+    type: 'reaction';
+    occurred_at: string;
+    action: 'added' | 'removed';
+    emoji?: string | null;
+    reactor_wa_id?: string;
+    reactor_display_name?: string;
+    target_firestore_message_id: string;
+    direction: 'in' | 'out';
+}
+export type TimelineEntry = TimelineEventEntry | TimelineMessageEntry | TimelineStatusEntry | TimelineReactionEntry;
+export interface TimelineCursor {
+    occurred_at_ms: number;
+    tiebreak: string;
+}
+export interface TimelineStats {
+    bq_query_id?: string;
+    bq_bytes_processed?: number;
+    duration_ms: number;
+}
+export interface TimelineResponse {
+    ok: true;
+    timeline: TimelineEntry[];
+    nextCursor?: string;
+    stats: TimelineStats;
+}

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

@@ -0,0 +1,6 @@
+"use strict";
+// feat-008-omni-tickets-search — types for hubomni_search Cloud Function.
+// List endpoint reads only `evo_chat.events` (BigQuery) + Firestore enrichment
+// for top-N. Timeline endpoint UNION-ALLs events + messages_raw +
+// message_statuses + message_reactions for a single contact (archive use case).
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,178 @@
+// feat-008-omni-tickets-search — types for hubomni_search Cloud Function.
+// List endpoint reads only `evo_chat.events` (BigQuery) + Firestore enrichment
+// for top-N. Timeline endpoint UNION-ALLs events + messages_raw +
+// message_statuses + message_reactions for a single contact (archive use case).
+
+export type SearchTicketStatus = 'open' | 'closed';
+
+export type SearchAttendantType = 'ai' | 'human' | 'hybrid' | 'unknown';
+
+export interface SearchThreadsParams {
+  date_from?: string;
+  date_to?: string;
+  status?: SearchTicketStatus;
+  department_ids?: string[];
+  attendant_type?: SearchAttendantType;
+  assigned_user_id?: string;
+  tag_ids?: string[];
+  cursor?: string;
+  limit?: number;
+}
+
+export interface SearchThreadCursor {
+  last_activity_ms: number;
+  contact_id: string;
+}
+
+export interface ThreadAggregateContact {
+  name: string;
+  subtitle?: string;
+  lead_id?: string | null;
+}
+
+export interface ThreadAggregateTag {
+  id: string;
+  name: string;
+  color?: string;
+}
+
+export interface ThreadAggregateCurrentOpenTicket {
+  id: string;
+  department_id?: string;
+  department_name?: string;
+  assigned_user_id?: string | null;
+  assigned_user_name?: string | null;
+  attendant_type?: SearchAttendantType | null;
+  last_message_at?: string;
+  waiting_since?: string;
+  unread_count?: number;
+  open_count_match: boolean;
+}
+
+export interface ThreadAggregate {
+  tenant: string;
+  contact_id: string;
+  thread_id: string;
+  last_activity_at: string;
+  total_tickets: number;
+  open_count_bq: number;
+  closed_count_bq: number;
+  departments_seen: string[];
+  attendant_types_seen: SearchAttendantType[];
+  latest_ticket_id?: string | null;
+  contact?: ThreadAggregateContact;
+  tags?: ThreadAggregateTag[];
+  current_open_ticket?: ThreadAggregateCurrentOpenTicket | null;
+}
+
+export interface SearchThreadsStats {
+  bq_query_id?: string;
+  bq_bytes_processed?: number;
+  fs_reads: number;
+  duration_ms: number;
+}
+
+export interface SearchThreadsResponse {
+  ok: true;
+  threads: ThreadAggregate[];
+  nextCursor?: string;
+  stats: SearchThreadsStats;
+}
+
+export type SearchThreadsErrorCode =
+  | 'invalid_filter'
+  | 'tag_filter_too_broad'
+  | 'forbidden'
+  | 'bq_error'
+  | 'fs_error';
+
+export interface SearchThreadsErrorResponse {
+  ok: false;
+  error: string;
+  code: SearchThreadsErrorCode;
+  error_id?: string;
+}
+
+// ── Timeline ──
+
+export type TimelineEntryType =
+  | 'event'
+  | 'message_in'
+  | 'message_out'
+  | 'internal_note'
+  | 'status'
+  | 'reaction';
+
+export interface TimelineParams {
+  date_from?: string;
+  date_to?: string;
+  types?: TimelineEntryType[];
+  cursor?: string;
+  limit?: number;
+}
+
+export interface TimelineEventEntry {
+  type: 'event';
+  occurred_at: string;
+  event_id: string;
+  event_type: string;
+  ticket_id?: string;
+  actor_display_name?: string;
+  department_name?: string;
+  extras?: Record<string, unknown>;
+}
+
+export interface TimelineMessageEntry {
+  type: 'message_in' | 'message_out' | 'internal_note';
+  occurred_at: string;
+  firestore_message_id: string;
+  direction: 'in' | 'out' | 'internal';
+  message_type: string;
+  body_preview?: string;
+  channel_type?: string;
+  ticket_id?: string;
+}
+
+export interface TimelineStatusEntry {
+  type: 'status';
+  occurred_at: string;
+  firestore_message_id: string;
+  status_type: string;
+  channel_type?: string;
+  error_code?: string;
+}
+
+export interface TimelineReactionEntry {
+  type: 'reaction';
+  occurred_at: string;
+  action: 'added' | 'removed';
+  emoji?: string | null;
+  reactor_wa_id?: string;
+  reactor_display_name?: string;
+  target_firestore_message_id: string;
+  direction: 'in' | 'out';
+}
+
+export type TimelineEntry =
+  | TimelineEventEntry
+  | TimelineMessageEntry
+  | TimelineStatusEntry
+  | TimelineReactionEntry;
+
+export interface TimelineCursor {
+  occurred_at_ms: number;
+  tiebreak: string;
+}
+
+export interface TimelineStats {
+  bq_query_id?: string;
+  bq_bytes_processed?: number;
+  duration_ms: number;
+}
+
+export interface TimelineResponse {
+  ok: true;
+  timeline: TimelineEntry[];
+  nextCursor?: string;
+  stats: TimelineStats;
+}

package/package.json

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