evo360-types 1.3.574 → 1.3.581

package/dist/types/evo-med/calendar/index.ts

@@ -61,6 +61,30 @@ export interface IMedCalendarNotificationConfig {
    * `email` legados (que os consumidores atuais ainda leem).
    */
   configs?: { [configKey: string]: IMedCalendarNotificationEntry } | null;
+
+  /**
+   * feat-160 (§10.2) — MESMA forma de `configs`, mas só para agendamento com
+   * `appointmentMode === 'telemedicine'`.
+   *
+   * **Semântica de HERANÇA, resolvida em UM lugar** (`@evo/model`
+   * `calendar-notification-config.ts` → `resolveNotificationConfigEntry(config,
+   * configKey, mode)`); nenhum leitor decide sozinho:
+   *
+   *   - modo `telemedicine` e a chave EXISTE aqui ⇒ vale esta entrada, inclusive
+   *     com `enabled: false` (é exatamente assim que a clínica desliga um aviso
+   *     SÓ na telemedicina sem mexer no presencial);
+   *   - modo `telemedicine` e a chave NÃO existe aqui ⇒ HERDA `configs[configKey]`;
+   *   - modo presencial (ou ausente) ⇒ `configs[configKey]`, este bloco é ignorado.
+   *
+   * Chave ausente ≠ chave com `enabled:false`: a primeira herda, a segunda
+   * desliga. É a única distinção que o editor do FE precisa expressar ("herdar
+   * do presencial" = remover a chave).
+   *
+   * Ausência do bloco inteiro = comportamento pré-feat-160 (toda agenda hoje).
+   */
+  telemedicine_configs?:
+    | { [configKey: string]: IMedCalendarNotificationEntry }
+    | null;
 }
 
 /** Uma config de notificação (feat-092): um evento/momento × seus canais. */
@@ -90,8 +114,10 @@ export interface IMedCalendarNotificationChannelEntry {
   department_id?: string | null;
   /** Template principal da mensagem (HSM name no WA / template_id lógico no email). */
   template_id?: string | null;
-  /** Tipo do template principal: 'hsm' | 'email' | … O leitor pode inferir pelo canal. */
+  /** Tipo do template principal: 'hsm' | 'quick_reply' | 'direct_send' | 'email' | … O leitor pode inferir pelo canal. */
   template_type?: string | null;
+  /** feat-165 — texto (com tokens) enviado quando `template_type === 'direct_send'`. */
+  direct_send_text?: string | null;
   /** Botões/ações da mensagem → artefato de resposta de cada um. */
   ctas?: IMedCalendarNotificationCta[] | null;
 }
@@ -152,6 +178,135 @@ export const MedCalendarNotificationConfigKeys = {
 export type MedCalendarNotificationConfigKey =
   (typeof MedCalendarNotificationConfigKeys)[keyof typeof MedCalendarNotificationConfigKeys];
 
+// ----- Virtual Care (inline no calendar doc) — feat-160 F16
+// Config por-agenda do módulo de telemedicina ("Hub Médica Virtual Care"), lida
+// pelo backend no `join`/`admit`/sweep e editada na seção própria do Calendar V2
+// (visível só com o entitlement `modules.telemedicine`).
+//
+// Bloco e campos são TODOS opcionais: agenda sem o bloco (a maioria) vale
+// exatamente `CALENDAR_VIRTUAL_CARE_DEFAULTS`, sem migração de dado (plan §12).
+// Por isso existem DOIS tipos: `IMedCalendarVirtualCareConfig` é o que está
+// gravado (parcial), e `IMedCalendarVirtualCareSettings` é o resultado de
+// aplicar os defaults sobre ele — o que o backend efetivamente decide com.
+//
+// `| null` em todo campo, como no `notification_config`: o editor do FE grava
+// "não escolhido" como `null` explícito e `.passthrough()` não cobre null em
+// chave declarada — sem `.nullable()` o doc inteiro do calendário reprovaria.
+
+/** `recording.mode` da agenda (feat-160 F15). `off` esconde "Solicitar gravação". */
+export const VirtualCareRecordingModeEnum = {
+  /** Gravação indisponível nesta agenda. */
+  Off: "off",
+  /** Médico solicita em sala e o paciente aceita ali (comportamento do MVP). */
+  Manual: "manual",
+  /** Inicia sozinha, só áudio; o aceite é colhido ANTES de o paciente entrar. */
+  AutoAudio: "auto_audio",
+  /** Idem, com vídeo. */
+  AutoVideo: "auto_video",
+} as const;
+
+export type VirtualCareRecordingMode =
+  (typeof VirtualCareRecordingModeEnum)[keyof typeof VirtualCareRecordingModeEnum];
+
+/** Limites de `recording.retention_days` (D32; D13 mantém 7 como default). */
+export const VIRTUAL_CARE_RETENTION_DAYS_MIN = 7;
+export const VIRTUAL_CARE_RETENTION_DAYS_MAX = 730;
+
+/** Limites de `max_duration_minutes`. */
+export const VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = 15;
+export const VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = 480;
+
+/** O que está GRAVADO no doc da agenda — tudo parcial (ausente = default). */
+export interface IMedCalendarVirtualCareConfig {
+  /**
+   * Admite o paciente sozinho quando o médico já está em sala
+   * (`waiting_policy` default `auto_when_doctor_present`). Exige a capability
+   * `auto_admit` do entitlement e NUNCA vale sem identidade verificada (D9).
+   */
+  auto_admit?: boolean | null;
+  recording?: {
+    mode?: VirtualCareRecordingMode | null;
+    /** Transcrição da gravação. Gate D12 + capability `transcription`. */
+    transcription?: boolean | null;
+    /**
+     * Retenção de gravação/transcrição em dias, 7..730 (D32). O sweep é a
+     * verdade (`artifact.expires_at` = fim + N dias); o lifecycle do bucket é
+     * só defesa de último caso. O prazo escolhido entra no texto de gravação
+     * mostrado ao paciente (`{{retention}}`).
+     */
+    retention_days?: number | null;
+  } | null;
+  identity?: {
+    require_name?: boolean | null;
+    /** Só é exigível quando o cadastro TEM data de nascimento (spec §8.3). */
+    require_birth_date?: boolean | null;
+    /** `true` ⇒ `identity_level: 'weak'`; nunca habilita auto-admit (D9). */
+    skip?: boolean | null;
+  } | null;
+  /** Antecedência de acesso à sala, por papel, em minutos. */
+  allow_early_start_minutes?: {
+    doctor?: number | null;
+    patient?: number | null;
+  } | null;
+  /** `true` = passar do fim previsto não encerra a consulta (comportamento atual). */
+  allow_late_end?: boolean | null;
+  /** Teto absoluto; o sweep encerra ao exceder (`reason: max_duration`). 15..480. */
+  max_duration_minutes?: number | null;
+  /** Aviso ao médico no SPA quando faltar N min para o fim. 0 = sem aviso. */
+  end_warning_minutes?: number | null;
+}
+
+/** Config já RESOLVIDA (doc + defaults) — é com isto que o backend decide. */
+export interface IMedCalendarVirtualCareSettings {
+  auto_admit: boolean;
+  recording: {
+    mode: VirtualCareRecordingMode;
+    transcription: boolean;
+    retention_days: number;
+  };
+  identity: {
+    require_name: boolean;
+    require_birth_date: boolean;
+    skip: boolean;
+  };
+  allow_early_start_minutes: {
+    doctor: number;
+    patient: number;
+  };
+  allow_late_end: boolean;
+  max_duration_minutes: number;
+  end_warning_minutes: number;
+}
+
+/**
+ * Defaults da spec (plan §12 / D13 / D32). Agenda sem `virtual_care` vale
+ * exatamente isto — é o que faz "sem migração de dado" ser verdade.
+ *
+ * Congelado (`as const` + `Readonly`) de propósito: é referência compartilhada,
+ * e um consumidor que mutasse um nível aninhado mudaria o default de todos.
+ * Para resolver, faça merge por nível (`{ ...DEFAULTS.recording, ...cfg.recording }`).
+ */
+export const CALENDAR_VIRTUAL_CARE_DEFAULTS: IMedCalendarVirtualCareSettings = {
+  auto_admit: false,
+  recording: {
+    mode: VirtualCareRecordingModeEnum.Manual,
+    transcription: false,
+    retention_days: VIRTUAL_CARE_RETENTION_DAYS_MIN,
+  },
+  identity: {
+    require_name: true,
+    require_birth_date: true,
+    skip: false,
+  },
+  allow_early_start_minutes: {
+    doctor: 30,
+    patient: 15,
+  },
+  allow_late_end: true,
+  max_duration_minutes: 120,
+  end_warning_minutes: 5,
+} as const;
+
 // ----- MedCalendarTypes
 export interface IMedCalendar extends IFireDoc {
   calendarId: string;
@@ -187,5 +342,16 @@ export interface IMedCalendar extends IFireDoc {
   integration?: IMedCalendarIntegration | null;
   // Config de notificações por-agenda (feat-048). Opcional — agendas sem lembrete não têm o bloco.
   notification_config?: IMedCalendarNotificationConfig | null;
+  /**
+   * Config de telemedicina por-agenda (feat-160 F16). Ausente = defaults de
+   * `CALENDAR_VIRTUAL_CARE_DEFAULTS`; só tem efeito com `modules.telemedicine`.
+   */
+  virtual_care?: IMedCalendarVirtualCareConfig | null;
+  /**
+   * Profissional (médico) padrão da agenda — feat-160 F16, fora do módulo de
+   * telemedicina (pedido do usuário, mesmo editor). Ref para
+   * `tenants/{t}/apps/evo-med/professionals/{id}`; `null` = sem padrão.
+   */
+  default_professional_ref?: FirestoreDocumentReference | null;
   [key: string]: unknown; // index signature
 }

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

@@ -113,6 +113,11 @@ export interface IQuickReplyActionIntent {
     url_secret?: string;
     [key: string]: unknown;
 }
+/** feat-165 — Meta Direct Send. `ttl_seconds`: 30..43200 (utility). */
+export interface INotificationDirectSend {
+    category: 'utility';
+    ttl_seconds?: number;
+}
 export interface INotificationSendPayload {
     kind: "notification.send";
     classification?: string;
@@ -126,6 +131,12 @@ export interface INotificationSendPayload {
      * Mutuamente exclusivo com `template.template_id` para `channel.type === 'whatsapp'`.
      */
     body_text?: string;
+    /**
+     * feat-165 — intencao de envio via Meta Direct Send (utilidade, sem template).
+     * So e honrada se o canal tiver `direct_send.enabled` e nao estiver restrito;
+     * caso contrario o envio segue o comportamento atual.
+     */
+    direct_send?: INotificationDirectSend;
     /**
      * Quick-reply actions (actionable WhatsApp buttons / email links).
      * Channel-agnostic intents; the provider renders them per channel.

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

@@ -196,6 +196,12 @@ export interface IQuickReplyActionIntent {
 // Payload schema for Task Runner (task.auto.kind = "notification.send")
 // ======================================================
 
+/** feat-165 — Meta Direct Send. `ttl_seconds`: 30..43200 (utility). */
+export interface INotificationDirectSend {
+  category: 'utility';
+  ttl_seconds?: number;
+}
+
 export interface INotificationSendPayload {
   kind: "notification.send";
 
@@ -217,6 +223,13 @@ export interface INotificationSendPayload {
    */
   body_text?: string;
 
+  /**
+   * feat-165 — intencao de envio via Meta Direct Send (utilidade, sem template).
+   * So e honrada se o canal tiver `direct_send.enabled` e nao estiver restrito;
+   * caso contrario o envio segue o comportamento atual.
+   */
+  direct_send?: INotificationDirectSend;
+
   /**
    * Quick-reply actions (actionable WhatsApp buttons / email links).
    * Channel-agnostic intents; the provider renders them per channel.

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

@@ -21,6 +21,17 @@ export interface IUsageCapabilities {
      * antes dessa data: ausência de medição não é consumo zero.
      */
     llm_since: string | null;
+    /**
+     * feat-160 F18 — entitlement `modules.telemedicine` ativo OU uso de
+     * teleconsulta medido na janela.
+     */
+    telemedicine: boolean;
+    /**
+     * Data (`YYYY-MM-DD`) a partir da qual existe medição de teleconsulta — o
+     * emissor não tem backfill. `null` antes do deploy dele; a série não é
+     * desenhada antes dessa data, porque ausência de medição não é consumo zero.
+     */
+    telemedicine_since: string | null;
 }
 /**
  * Uma linha da abertura por departamento dentro de um mês.
@@ -84,6 +95,21 @@ export interface IUsageLlm {
     tokens_cache_write: number;
     tokens_cache_read: number;
 }
+/**
+ * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
+ * começou (`started_at`) E o paciente esteve conectado (`connected_at`): médico
+ * entrando em sala vazia não conta.
+ *
+ * Os dois campos são DISJUNTOS — uma consulta cai em exatamente um. O total é a
+ * soma; não há campo de total, para não haver duas verdades.
+ *
+ * `com_gravacao` = teve ao menos um artifact `recording_*` em `ready`. Bloco
+ * inteiro `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTelemedicine {
+    realizadas_sem_gravacao: number;
+    realizadas_com_gravacao: number;
+}
 export interface IMonthlyUsageRow {
     /** Primeiro dia do mês em UTC, `YYYY-MM-DD`. */
     mes: string;
@@ -92,6 +118,7 @@ export interface IMonthlyUsageRow {
     contatos: IUsageContacts;
     notificacoes: IUsageNotifications;
     ia: IUsageLlm | null;
+    telemedicina: IUsageTelemedicine | null;
 }
 export interface IMonthlyUsageResponse {
     ok: true;

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

@@ -37,6 +37,17 @@ export interface IUsageCapabilities {
    * antes dessa data: ausência de medição não é consumo zero.
    */
   llm_since: string | null;
+  /**
+   * feat-160 F18 — entitlement `modules.telemedicine` ativo OU uso de
+   * teleconsulta medido na janela.
+   */
+  telemedicine: boolean;
+  /**
+   * Data (`YYYY-MM-DD`) a partir da qual existe medição de teleconsulta — o
+   * emissor não tem backfill. `null` antes do deploy dele; a série não é
+   * desenhada antes dessa data, porque ausência de medição não é consumo zero.
+   */
+  telemedicine_since: string | null;
 }
 
 /**
@@ -105,6 +116,22 @@ export interface IUsageLlm {
   tokens_cache_read: number;
 }
 
+/**
+ * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
+ * começou (`started_at`) E o paciente esteve conectado (`connected_at`): médico
+ * entrando em sala vazia não conta.
+ *
+ * Os dois campos são DISJUNTOS — uma consulta cai em exatamente um. O total é a
+ * soma; não há campo de total, para não haver duas verdades.
+ *
+ * `com_gravacao` = teve ao menos um artifact `recording_*` em `ready`. Bloco
+ * inteiro `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTelemedicine {
+  realizadas_sem_gravacao: number;
+  realizadas_com_gravacao: number;
+}
+
 export interface IMonthlyUsageRow {
   /** Primeiro dia do mês em UTC, `YYYY-MM-DD`. */
   mes: string;
@@ -113,6 +140,7 @@ export interface IMonthlyUsageRow {
   contatos: IUsageContacts;
   notificacoes: IUsageNotifications;
   ia: IUsageLlm | null;
+  telemedicina: IUsageTelemedicine | null;
 }
 
 export interface IMonthlyUsageResponse {