evo360-types 1.3.377 → 1.3.381

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

@@ -975,12 +975,12 @@ export declare const zQuestionResponseSchema: z.ZodObject<{
     answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
     date: z.ZodOptional<z.ZodDate>;
 }, "strip", z.ZodTypeAny, {
-    questionId: string;
     answer: string | string[];
+    questionId: string;
     date?: Date | undefined;
 }, {
-    questionId: string;
     answer: string | string[];
+    questionId: string;
     date?: Date | undefined;
 }>;
 export declare const zSurveyResponseSchema: z.ZodObject<{
@@ -998,12 +998,12 @@ export declare const zSurveyResponseSchema: z.ZodObject<{
         answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
         date: z.ZodOptional<z.ZodDate>;
     }, "strip", z.ZodTypeAny, {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }, {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -1016,8 +1016,8 @@ export declare const zSurveyResponseSchema: z.ZodObject<{
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
     responses?: {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }[] | undefined;
 }, {
@@ -1030,8 +1030,8 @@ export declare const zSurveyResponseSchema: z.ZodObject<{
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
     responses?: {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }[] | undefined;
 }>;
@@ -1064,12 +1064,12 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
             answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
             date: z.ZodOptional<z.ZodDate>;
         }, "strip", z.ZodTypeAny, {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }, {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
@@ -1082,8 +1082,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }, {
@@ -1096,8 +1096,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }>, "many">>;
@@ -1127,8 +1127,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }[] | undefined;
@@ -1154,8 +1154,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }[] | undefined;
@@ -1427,12 +1427,12 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
                 answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
                 date: z.ZodOptional<z.ZodDate>;
             }, "strip", z.ZodTypeAny, {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }, {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
@@ -1445,8 +1445,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }, {
@@ -1459,8 +1459,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }>, "many">>;
@@ -1490,8 +1490,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -1517,8 +1517,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -1615,8 +1615,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -1712,8 +1712,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;

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

@@ -18,6 +18,8 @@ export interface IMessageCall {
     duration_s?: number;
     end_reason?: string;
 }
+export type CallMediaState = 'idle' | 'offer_ready' | 'answering' | 'answered' | 'connected' | 'ended';
+export type CallTerminatedBy = 'patient' | 'agent' | 'system';
 export interface ICallSession extends IFireDoc {
     model_ver: number;
     provider_call_id: string;
@@ -38,4 +40,22 @@ export interface ICallSession extends IFireDoc {
     duration_s?: number;
     timeline_at: Date;
     last_event_at: Date;
+    claimed_by_user_id?: string;
+    claimed_by_name?: string;
+    claimed_at?: Date;
+    claim_expires_at?: Date;
+    accepted_by_user_id?: string;
+    accepted_at?: Date;
+    media_state?: CallMediaState;
+    browser_session_id?: string;
+    terminated_by?: CallTerminatedBy;
+    failure_code?: number;
+    failure_source?: string;
+}
+export interface ICallSignalRemote {
+    provider_call_id: string;
+    sdp_type: 'offer' | 'answer';
+    sdp: string;
+    source: 'meta';
+    created_at: Date;
 }

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

@@ -7,10 +7,9 @@ import type { MessageDirection } from "../thread-message";
 export type CallProviderDirection = 'USER_INITIATED' | 'BUSINESS_INITIATED';
 
 // Status de negócio normalizado da chamada.
-// Fase 1 (feat-029) produz apenas: ringing | missed | rejected | failed | completed.
-// Os demais (pre_accepted/accepted/connected/terminated) são reservados para a Fase 2
-// (voz via WebRTC) e já existem aqui para a state machine de precedência ser estável
-// sem exigir republish do evo360-types quando a Fase 2 chegar.
+// Fase 1 (feat-029) produz: ringing | missed | rejected | failed | completed.
+// Os demais (pre_accepted/accepted/connected/terminated) são usados na Fase 2
+// (voz via WebRTC, atendimento humano ao vivo).
 export type CallStatus =
   | 'ringing'
   | 'pre_accepted'
@@ -45,11 +44,23 @@ export interface IMessageCall {
   end_reason?: string;
 }
 
+// ── Call media state (Fase 2 — atendimento ao vivo via WebRTC) ──
+
+// Estado da mídia na perspectiva do nosso atendimento (browser do operador).
+// Distinto de CallStatus (status de negócio da chamada). Governa a UI do cliente.
+export type CallMediaState =
+  | 'idle'          // sem mídia
+  | 'offer_ready'   // SDP offer da Meta disponível para o operador (inbound)
+  | 'answering'     // operador gerou answer / aguardando connect da Meta
+  | 'answered'      // accept/connect enviado à Meta
+  | 'connected'     // mídia fluindo
+  | 'ended';        // mídia encerrada
+
+export type CallTerminatedBy = 'patient' | 'agent' | 'system';
+
 // ── Call Session (entidade canônica — fonte de verdade) ──
 
 // Path: tenants/{tenant}/apps/evo-chat/call_sessions/{provider_call_id}
-// Fase 1 = MÍNIMO. Campos operacionais da Fase 2 (claim/sdp refs/agent/presence)
-// NÃO devem ser adicionados aqui agora.
 export interface ICallSession extends IFireDoc {
   model_ver: number;
   provider_call_id: string;        // wacid.* (também é o doc id)
@@ -71,11 +82,44 @@ export interface ICallSession extends IFireDoc {
 
   // Semântica de tempo.
   started_at?: Date;               // chamada iniciada no WhatsApp (connect ts)
-  connected_at?: Date;             // mídia atendida — Fase 2 (não setado na Fase 1)
+  connected_at?: Date;             // mídia atendida (Fase 2)
   ended_at?: Date;                 // terminate
   duration_s?: number;
 
   // Ordenação/observação na timeline.
   timeline_at: Date;               // primeiro timestamp de provider observado
   last_event_at: Date;             // último timestamp de provider observado
+
+  // ── Fase 2 — atendimento ao vivo (WebRTC) ──
+  // Lock/claim: impede duas secretárias atenderem a mesma chamada.
+  claimed_by_user_id?: string;
+  claimed_by_name?: string;
+  claimed_at?: Date;
+  claim_expires_at?: Date;
+  // Operador que de fato atendeu a mídia.
+  accepted_by_user_id?: string;
+  accepted_at?: Date;
+  // Estado da mídia (governa a UI do cliente).
+  media_state?: CallMediaState;
+  // Identificador da sessão de browser que está conduzindo a mídia (1 aba ativa).
+  browser_session_id?: string;
+  // Encerramento.
+  terminated_by?: CallTerminatedBy;
+  failure_code?: number;
+  failure_source?: string;
+}
+
+// ── Sinalização WebRTC (relay de SDP) ──
+// Doc: call_sessions/{provider_call_id}/signaling/remote
+// Carrega APENAS o SDP REMOTO (vindo da Meta) que o browser do operador precisa
+// consumir: offer no inbound, answer no outbound. O SDP gerado pelo browser
+// (answer no inbound / offer no outbound) NUNCA é gravado aqui — vai por endpoint
+// autenticado direto para a Meta. SDP é dado sensível e efêmero.
+export interface ICallSignalRemote {
+  provider_call_id: string;
+  sdp_type: 'offer' | 'answer';
+  sdp: string;
+  // 'meta' = veio da Meta (único caso persistido).
+  source: 'meta';
+  created_at: Date;
 }

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

@@ -13,9 +13,7 @@ export interface IChannelProviderRef {
 export interface ICallDeflectionConfig {
     enabled: boolean;
     mode: 'template' | 'text';
-    template?: {
-        name: string;
-        language: string;
+    template?: ICallHsmTemplateRef & {
         category?: string;
     };
     text?: string;
@@ -23,9 +21,24 @@ export interface ICallDeflectionConfig {
     only_outside_business_hours?: boolean;
     cooldown_minutes?: number;
 }
+/** Referência a HSM aprovado na Meta (nome + idioma + variáveis opcionais). */
+export interface ICallHsmTemplateRef {
+    name: string;
+    language: string;
+    /** Valores do BODY na ordem {{1}}, {{2}}, … Suporta placeholder {{contact_name}}. */
+    body_parameters?: string[];
+    /** Valores do HEADER TEXT na ordem {{1}}, … */
+    header_parameters?: string[];
+}
+export interface ICallOutboundPermissionConfig {
+    enabled: boolean;
+    request_template?: ICallHsmTemplateRef;
+}
 export interface ICallsChannelConfig {
     enabled: boolean;
     deflection?: ICallDeflectionConfig;
+    inbound_voice_enabled?: boolean;
+    outbound_permission?: ICallOutboundPermissionConfig;
 }
 export interface IChannel extends IFireDoc {
     model_ver: number;

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

@@ -25,17 +25,38 @@ export interface IChannelProviderRef {
 export interface ICallDeflectionConfig {
   enabled: boolean;
   mode: 'template' | 'text';
-  template?: { name: string; language: string; category?: string };
+  template?: ICallHsmTemplateRef & { category?: string };
   text?: string;                       // mode 'text' — só aplicado com janela de 24h aberta
   end_call: boolean;                   // default true — terminate/reject via call-control
   only_outside_business_hours?: boolean;
   cooldown_minutes?: number;           // hardening leve (notificação repetida)
 }
 
+/** Referência a HSM aprovado na Meta (nome + idioma + variáveis opcionais). */
+export interface ICallHsmTemplateRef {
+  name: string;
+  language: string;
+  /** Valores do BODY na ordem {{1}}, {{2}}, … Suporta placeholder {{contact_name}}. */
+  body_parameters?: string[];
+  /** Valores do HEADER TEXT na ordem {{1}}, … */
+  header_parameters?: string[];
+}
+
+// Permissão para ligação outbound (business-initiated) — Fase 2.
+// Antes de discar, a clínica precisa de permissão do usuário; quando ausente,
+// envia-se um HSM com componente CALL_PERMISSION_REQUEST (template aprovado).
+export interface ICallOutboundPermissionConfig {
+  enabled: boolean;
+  // Template HSM com botão/ação CALL_PERMISSION_REQUEST.
+  request_template?: ICallHsmTemplateRef;
+}
+
 export interface ICallsChannelConfig {
   enabled: boolean;
   deflection?: ICallDeflectionConfig;
-  // outbound_permission?: ICallOutboundPermissionConfig; // Fase 2 — não definir agora
+  // Fase 2 — voz ao vivo via WebRTC.
+  inbound_voice_enabled?: boolean;     // permite atender chamada inbound no web-app
+  outbound_permission?: ICallOutboundPermissionConfig;
 }
 
 // ── Channel (evo-chat v3) ──

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

@@ -21,5 +21,13 @@ export interface IChatContact extends IFireDoc {
     wa_id?: string | null;
     provider?: 'chatbee' | 'hub-waba' | string;
     channel_ids?: string[];
+    call_permission?: ICallPermissionState;
     [key: string]: unknown;
 }
+export interface ICallPermissionState {
+    status: 'granted' | 'denied' | 'none';
+    source?: 'user_action' | 'automatic';
+    is_permanent?: boolean;
+    expires_at?: string | number;
+    updated_at?: string;
+}

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

@@ -29,5 +29,21 @@ export interface IChatContact extends IFireDoc {
   provider?: 'chatbee' | 'hub-waba' | string;
   channel_ids?: string[];
 
+  // ── call permission (feat-029 Fase 2) ──
+  // Última permissão de ligação conhecida deste contato (espelho local; a fonte
+  // de verdade é a Meta via GET /{phone_number_id}/call_permissions). Atualizado
+  // ao receber a interactive call_permission_reply.
+  call_permission?: ICallPermissionState;
+
   [key: string]: unknown; // index signature
 }
+
+// Estado de permissão de ligação outbound (business-initiated) para um contato.
+export interface ICallPermissionState {
+  status: 'granted' | 'denied' | 'none';
+  source?: 'user_action' | 'automatic';
+  is_permanent?: boolean;
+  // ISO 8601 ou epoch (segundos) — quando a permissão temporária expira.
+  expires_at?: string | number;
+  updated_at?: string;
+}

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

@@ -13,6 +13,8 @@ export declare const THREAD_MESSAGES_COLLECTION = "messages";
 export declare const TICKETS_COLLECTION = "tickets";
 export declare const INBOXES_COLLECTION = "inboxes";
 export declare const CALL_SESSIONS_COLLECTION = "call_sessions";
+export declare const CALL_SIGNALING_COLLECTION = "signaling";
+export declare const CALL_SIGNAL_REMOTE_DOC = "remote";
 export declare const HubWabaCollections: {
     readonly TEMPLATES: "waba-templates";
     readonly QUICK_REPLIES: "quick-replies";

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WABA_CHANNEL_INDEX_PATH = exports.WABA_SETUP_PATH = exports.HubWabaCollections = exports.CALL_SESSIONS_COLLECTION = exports.INBOXES_COLLECTION = exports.TICKETS_COLLECTION = exports.THREAD_MESSAGES_COLLECTION = exports.THREADS_COLLECTION = exports.CHANNELS_COLLECTION = exports.CHATBEE_CHANNELS_COLLECTION = exports.HSM_MESSAGES_COLLECTION = exports.PROTOCOLS_COLLECTION = exports.CONTACTS_COLLECTION = exports.TICKET_CLOSE_TYPES_COLLECTION = exports.TICKET_CLOSES_COLLECTION = exports.TICKET_CLOSES = exports.CHAT_DICS_COLLECTION = exports.EVO_CHAT_APP = void 0;
+exports.WABA_CHANNEL_INDEX_PATH = exports.WABA_SETUP_PATH = exports.HubWabaCollections = exports.CALL_SIGNAL_REMOTE_DOC = exports.CALL_SIGNALING_COLLECTION = exports.CALL_SESSIONS_COLLECTION = exports.INBOXES_COLLECTION = exports.TICKETS_COLLECTION = exports.THREAD_MESSAGES_COLLECTION = exports.THREADS_COLLECTION = exports.CHANNELS_COLLECTION = exports.CHATBEE_CHANNELS_COLLECTION = exports.HSM_MESSAGES_COLLECTION = exports.PROTOCOLS_COLLECTION = exports.CONTACTS_COLLECTION = exports.TICKET_CLOSE_TYPES_COLLECTION = exports.TICKET_CLOSES_COLLECTION = exports.TICKET_CLOSES = exports.CHAT_DICS_COLLECTION = exports.EVO_CHAT_APP = void 0;
 //EVO Chat Application Doc
 exports.EVO_CHAT_APP = "evo-chat";
 //dictionaries
@@ -23,6 +23,8 @@ exports.THREAD_MESSAGES_COLLECTION = "messages"; // subcollection de threads
 exports.TICKETS_COLLECTION = "tickets";
 exports.INBOXES_COLLECTION = "inboxes";
 exports.CALL_SESSIONS_COLLECTION = "call_sessions"; // entidade canônica de chamadas (feat-029)
+exports.CALL_SIGNALING_COLLECTION = "signaling"; // subcoleção de call_sessions p/ relay de SDP (feat-029 Fase 2)
+exports.CALL_SIGNAL_REMOTE_DOC = "remote"; // doc único: SDP remoto (da Meta) que o browser consome
 // hub-waba template subcollection (under channels)
 exports.HubWabaCollections = {
     TEMPLATES: 'waba-templates',

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

@@ -26,6 +26,8 @@ export const THREAD_MESSAGES_COLLECTION = "messages"; // subcollection de thread
 export const TICKETS_COLLECTION = "tickets";
 export const INBOXES_COLLECTION = "inboxes";
 export const CALL_SESSIONS_COLLECTION = "call_sessions"; // entidade canônica de chamadas (feat-029)
+export const CALL_SIGNALING_COLLECTION = "signaling";    // subcoleção de call_sessions p/ relay de SDP (feat-029 Fase 2)
+export const CALL_SIGNAL_REMOTE_DOC = "remote";          // doc único: SDP remoto (da Meta) que o browser consome
 
 // hub-waba template subcollection (under channels)
 export const HubWabaCollections = {

package/package.json

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