evo360-types 1.3.578 → 1.3.581

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

@@ -1,6 +1,9 @@
 export * from "./fb_collections";
 import type { IFireDoc, IFireGlobalDoc } from "../shared";
 import type { ITenantModuleEntitlement } from "../evo-tenant";
+// feat-160 F15/F16 — a política da sala é projeção do `calendar.virtual_care`:
+// o MODO de gravação é o mesmo tipo dos dois lados, de propósito.
+import type { VirtualCareRecordingMode } from "../evo-med/calendar";
 
 // ======================================================
 // evo-telemedicine (feat-160 — Telemedicina integrada)
@@ -325,8 +328,22 @@ export const TeleconsultationEventTypeEnum = {
   RecordingConsentRequested: "recording.consent_requested",
   RecordingConsentAccepted: "recording.consent_accepted",
   RecordingConsentDeclined: "recording.consent_declined",
+  /**
+   * feat-160 F15 — o paciente RECUSOU a gravação automática ANTES de entrar.
+   * Não é `recording.consent_declined`: aquela é a recusa de uma solicitação
+   * feita em sala (a consulta segue sem gravar); esta IMPEDE a entrada, porque
+   * em `auto_*` o aceite é condição do join (D21).
+   */
+  RecordingConsentDeclinedPreJoin: "recording.consent_declined_pre_join",
   RecordingConsentWithdrawn: "recording.consent_withdrawn",
   RecordingStarted: "recording.started",
+  /**
+   * feat-160 F15 — gravação iniciada pela POLÍTICA da agenda (`auto_audio`/
+   * `auto_video`), não por comando do médico. Trilha própria porque
+   * `recording.started` sem um `recording.consent_requested` antes pareceria
+   * gravação sem solicitação na auditoria.
+   */
+  RecordingAutoStarted: "recording.auto_started",
   RecordingStopped: "recording.stopped",
   RecordingFailed: "recording.failed",
   TranscriptionQueued: "transcription.queued",
@@ -336,6 +353,15 @@ export const TeleconsultationEventTypeEnum = {
   ConsultationStarted: "consultation.started",
   ConsultationReconnecting: "consultation.reconnecting",
   ConsultationEnded: "consultation.ended",
+  /**
+   * feat-160 F18 — consulta encerrada e MEDIDA como "não contada" (paciente
+   * não atendeu, sem gravação elegível, franquia). Existe porque
+   * `usage_metered_at` é carimbado nos DOIS casos: sem este evento a
+   * reconciliação "quantas `ended` carimbadas × quantas linhas no BigQuery"
+   * acusaria diferença em toda consulta não contada, indistinguível de evento
+   * perdido.
+   */
+  UsageSkipped: "teleconsultation.usage_skipped",
   ArtifactAccessed: "artifact.accessed",
   ArtifactDeleted: "artifact.deleted",
   EntitlementDenied: "entitlement.denied",
@@ -965,6 +991,58 @@ export interface IRoomRecordingStateDto {
   terms_version?: string;
   /** Código estável, sem PII, quando `status === 'failed'`. */
   failure_code?: string;
+  /** feat-160 F15 — presente só nos modos `auto_*` (aviso pré-join). */
+  auto?: IRoomRecordingAutoDto;
+}
+
+/**
+ * feat-160 F15 — aviso PRÉ-JOIN da gravação automática (`auto_audio`/
+ * `auto_video`). Presente só nesses modos: é o que o SPA usa para explicar o
+ * que vai ser gravado e por quanto tempo ANTES do aceite.
+ */
+export interface IRoomRecordingAutoDto {
+  /** `auto_audio` ou `auto_video`; os outros modos não têm este bloco. */
+  mode: VirtualCareRecordingMode;
+  /**
+   * `true` em `auto_audio`. Hoje é INTENÇÃO declarada: o `POST /recordings` do
+   * provedor não expõe flag de áudio-only, então o arquivo sai A/V. O SPA usa o
+   * campo para o texto do aviso; quando o provedor ganhar a flag, só o adapter
+   * muda.
+   */
+  audio_only: boolean;
+  /** Retenção que o texto mostrado ao paciente promete (`{{retention}}`, D32). */
+  retention_days: number;
+  /**
+   * Versão vigente do texto `recording` que o `POST /consents` tem de
+   * referenciar. `null` = não há texto publicado ⇒ sem aceite possível (D21) e
+   * a gravação automática NÃO acontece.
+   */
+  terms_version: string | null;
+}
+
+/**
+ * feat-160 F16 — política EFETIVA da agenda nesta sessão (`virtual_care` já
+ * com os defaults aplicados). É projeção de decisão, não de config gravada:
+ * agenda sem o bloco devolve os defaults.
+ */
+export interface IRoomSessionPolicyDto {
+  recording_mode: VirtualCareRecordingMode;
+  auto_admit: boolean;
+  identity: {
+    require_name: boolean;
+    require_birth_date: boolean;
+    skip: boolean;
+  };
+  /**
+   * Prazo duro da consulta. `end_at`/`warning_at` são `null` quando não há
+   * prazo (consulta não iniciada com `allow_late_end`), e `reason` diz qual
+   * limite venceu — o MESMO `reason` com que o sweep encerra.
+   */
+  deadline: {
+    end_at: string | null;
+    warning_at: string | null;
+    reason: "scheduled_end" | "max_duration" | null;
+  };
 }
 
 /**
@@ -988,7 +1066,15 @@ export interface IRoomSessionDto {
    * nascimento só é pedida quando EXISTE no cadastro. Para o médico vem sempre
    * `{ birth_date: false }`.
    */
-  identity_required_fields: { birth_date: boolean };
+  identity_required_fields: {
+    birth_date: boolean;
+    /**
+     * feat-160 F16 — `virtual_care.identity.require_name`: a agenda pode exigir
+     * o nome também. OPCIONAL no contrato porque SPA anterior à F16 não o
+     * conhece e deve seguir pedindo só a data (comportamento de antes).
+     */
+    name?: boolean;
+  };
   /**
    * Contador do lockout, lido do GRANT raiz — e a ÚNICA fonte dele: o erro do
    * `POST /identity/verify` é neutro e não devolve tentativas nem prazo. Por
@@ -997,6 +1083,12 @@ export interface IRoomSessionDto {
   identity_attempts: { remaining: number; blocked_until: string | null };
   recording_status: RecordingStatus;
   recording: IRoomRecordingStateDto;
+  /**
+   * feat-160 F16 — o que a AGENDA decidiu (`calendar.virtual_care` resolvido
+   * com os defaults). OPCIONAL: aditivo, SPA que não o conheça mantém o
+   * comportamento pré-F16.
+   */
+  policy?: IRoomSessionPolicyDto;
   transcription_status: TranscriptionStatus;
   /** Textos vigentes que ainda precisam de aceite antes do join. */
   required_consents: IRoomConsentRefDto[];
@@ -1067,11 +1159,114 @@ export interface ITeleconsultationArtifactDto {
   created_at: string;
 }
 
+/**
+ * Modo da URL assinada de um artefato (feat-160 F21; D34).
+ *
+ * `attachment` é o default histórico (F8): o navegador BAIXA o arquivo.
+ * `inline` existe para o `<video>` do painel fazer streaming por `Range` sem
+ * baixar — e a única diferença técnica é NÃO emitir `Content-Disposition`.
+ */
+export const ArtifactDispositionEnum = {
+  Inline: "inline",
+  Attachment: "attachment",
+} as const;
+export type ArtifactDisposition =
+  (typeof ArtifactDispositionEnum)[keyof typeof ArtifactDispositionEnum];
+
+/**
+ * Teto de validade da URL `inline` (feat-160 F21): 15 min. Playback casa com a
+ * duração de uma consulta; download curto casa com o clique. É TETO, não
+ * default — o use case aplica, e o adapter recusa acima dele.
+ */
+export const ARTIFACT_INLINE_SIGNED_URL_MAX_SECONDS = 900;
+
 /** `POST /v1/teleconsultations/:id/artifacts/:artifactId/signed-url` — URL ≤ 5 min; evento `artifact.accessed`. */
 export interface ISignedUrlResponseDto {
   ok: true;
   url: string;
   expires_at: string;
+  /** Modo efetivamente aplicado (`attachment` quando o comando omite). */
+  disposition?: ArtifactDisposition;
+}
+
+// ----- Transcrição servida ao painel (feat-160 F21 §9.1 b)
+//
+// O texto NUNCA vive em doc do Firestore (threat model): a rota lê o objeto do
+// bucket e devolve ESTE DTO. Tempos em MILISSEGUNDOS porque o player faz
+// `seekTo` e o `mm:ss` da bolha vem de arredondamento — dois consumidores do
+// mesmo número, e um `0.1 + 0.2` no meio é ruído garantido.
+
+export type TranscriptSpeakerRole = "doctor" | "patient" | "unknown";
+
+export interface ITranscriptSpeakerDto {
+  /** `opaque_custom_participant_id` que amarra a fala ao papel. */
+  key: string;
+  display_name: string;
+  role: TranscriptSpeakerRole;
+}
+
+export interface ITranscriptEntryDto {
+  index: number;
+  speaker_key: string;
+  start_ms: number;
+  end_ms: number;
+  text: string;
+  overlapping?: boolean;
+}
+
+/** Corpo da transcrição de UM artefato (`segment`). */
+export interface ITranscriptDto {
+  artifact_id: string;
+  segment: number;
+  language?: string;
+  generated_at?: string;
+  speakers: ITranscriptSpeakerDto[];
+  entries: ITranscriptEntryDto[];
+}
+
+/**
+ * `GET /v1/teleconsultations/:id/artifacts/:artifactId/transcript` — envelope
+ * da rota: `{ ok: true, ...ITranscriptDto }` (o DTO é espalhado, não aninhado).
+ */
+export interface ITranscriptResponseDto extends ITranscriptDto {
+  ok: true;
+}
+
+// ----- Badges da lista de agendamentos (feat-160 F21 §9.1 d)
+
+/**
+ * Um agendamento que TEM teleconsulta, e o que ela produziu. Id ausente do mapa
+ * = "nunca virou teleconsulta" — é essa diferença que impede a tela de
+ * desenhar três ícones apagados em toda linha comum.
+ */
+export interface ITeleconsultationBadgeDto {
+  teleconsultation_id: string;
+  status: TeleconsultationStatus;
+  recording_audio: boolean;
+  recording_video: boolean;
+  transcript: boolean;
+}
+
+/** `GET /v1/appointments/teleconsultation-badges?ids=a,b,c` (máx. 50 ids). */
+export interface ITeleconsultationBadgesResponseDto {
+  ok: true;
+  /** Keyed por `appointment_id`. */
+  items: Record<string, ITeleconsultationBadgeDto>;
+}
+
+/** Teto de ids por chamada; acima disso a rota responde 400. */
+export const TELECONSULTATION_BADGES_MAX_IDS = 50;
+
+/**
+ * Corpo do `POST …/artifacts/:artifactId/signed-url` (feat-160 F21). O zod
+ * espelho é `zArtifactSignedUrlCommandSchema`.
+ */
+export interface IArtifactSignedUrlCommand {
+  disposition?: ArtifactDisposition;
+  /** 30..900; o teto REAL depende do modo e é aplicado pelo backend. */
+  ttl_seconds?: number;
+  /** Renova a URL de um artefato já acessado (evento `artifact.accessed`). */
+  refresh?: boolean;
 }
 
 export interface ITeleconsultationEventDto {

package/package.json

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