evo360-types 1.3.578 → 1.3.583

package/dist/apps/hub-automation/zod-schemas.ts

@@ -54,6 +54,15 @@ export const zAutomationTimeOfDaySchema = z
   .string()
   .regex(/^([01]\d|2[0-3]):[0-5]\d$/, "expected HH:mm");
 
+// feat-167: value of the between/not_between branch operators. Kept separate
+// from selection.time_range (inline below), which does not change.
+export const zAutomationTimeOfDayRangeSchema = z
+  .object({ start: zAutomationTimeOfDaySchema, end: zAutomationTimeOfDaySchema })
+  .refine((r) => r.start !== r.end, {
+    message: "start and end must differ",
+    path: ["end"],
+  });
+
 // feat-147: appointment modality (IAppointment.appointmentMode). Fixed enum —
 // the selection matches it exactly (no wildcard glob).
 export const zAutomationAppointmentModeSchema = z.enum([
@@ -146,13 +155,30 @@ export const zAutomationOperatorSchema = z.enum([
   "not_exists",
   "is_true",
   "is_false",
+  // feat-167
+  "between",
+  "not_between",
 ]);
 
-export const zAutomationConditionSchema = z.object({
-  fact: z.string().min(1),
-  operator: zAutomationOperatorSchema,
-  value: z.unknown().optional(),
-});
+// feat-167: between/not_between validate `value` as a time-of-day range. The
+// operator is NOT tied to `appointment.start_time` here (`fact` stays a free
+// string for forward compat); the evaluator returns false on any other fact and
+// the builder only offers these operators for the time fact.
+export const zAutomationConditionSchema = z
+  .object({
+    fact: z.string().min(1),
+    operator: zAutomationOperatorSchema,
+    value: z.unknown().optional(),
+  })
+  .superRefine((c, ctx) => {
+    if (c.operator !== "between" && c.operator !== "not_between") return;
+    const r = zAutomationTimeOfDayRangeSchema.safeParse(c.value);
+    if (!r.success) {
+      for (const issue of r.error.issues) {
+        ctx.addIssue({ ...issue, path: ["value", ...issue.path] });
+      }
+    }
+  });
 
 // z.lazy needs an explicit type annotation for the recursive reference.
 type ZAutomationConditionGroup = {

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

@@ -49,6 +49,23 @@ export interface ICallsChannelConfig {
     inbound_voice_enabled?: boolean;
     outbound_permission?: ICallOutboundPermissionConfig;
 }
+export type WabaDirectSendCategory = 'utility' | 'authentication';
+/** Restricao aplicada pela Meta ao Direct Send do WABA (webhook `account_update` / ACCOUNT_RESTRICTION). */
+export interface IChannelDirectSendRestriction {
+    violation_type: string;
+    restriction_type?: string | null;
+    expiration?: Date | null;
+    received_at: Date;
+}
+/** Meta Direct Send (beta): envio iniciado pela empresa sem template previo. Desligado por padrao. */
+export interface IChannelDirectSendConfig {
+    enabled: boolean;
+    categories?: WabaDirectSendCategory[];
+    default_ttl_seconds?: number | null;
+    /** Enquanto no futuro, o Direct Send do canal fica suspenso. */
+    restricted_until?: Date | null;
+    restriction?: IChannelDirectSendRestriction | null;
+}
 export interface IChannel extends IFireDoc {
     model_ver: number;
     provider: ChannelProvider | string;
@@ -61,6 +78,8 @@ export interface IChannel extends IFireDoc {
     provider_ref: IChannelProviderRef;
     hub_ia?: IHubIAConfig;
     calls?: ICallsChannelConfig;
+    /** feat-165 — Meta Direct Send (beta). */
+    direct_send?: IChannelDirectSendConfig;
     /** feat-142 — rollup da recepção do histórico de coexistência (WABA). */
     history_import?: IChannelHistoryImport;
     [key: string]: unknown;

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

@@ -71,6 +71,28 @@ export interface ICallsChannelConfig {
   outbound_permission?: ICallOutboundPermissionConfig;
 }
 
+// ── Direct Send config (feat-165) ──
+
+export type WabaDirectSendCategory = 'utility' | 'authentication';
+
+/** Restricao aplicada pela Meta ao Direct Send do WABA (webhook `account_update` / ACCOUNT_RESTRICTION). */
+export interface IChannelDirectSendRestriction {
+  violation_type: string;
+  restriction_type?: string | null;
+  expiration?: Date | null;
+  received_at: Date;
+}
+
+/** Meta Direct Send (beta): envio iniciado pela empresa sem template previo. Desligado por padrao. */
+export interface IChannelDirectSendConfig {
+  enabled: boolean;
+  categories?: WabaDirectSendCategory[];
+  default_ttl_seconds?: number | null;
+  /** Enquanto no futuro, o Direct Send do canal fica suspenso. */
+  restricted_until?: Date | null;
+  restriction?: IChannelDirectSendRestriction | null;
+}
+
 // ── Channel (evo-chat v3) ──
 
 export interface IChannel extends IFireDoc {
@@ -85,6 +107,8 @@ export interface IChannel extends IFireDoc {
   provider_ref: IChannelProviderRef;
   hub_ia?: IHubIAConfig;
   calls?: ICallsChannelConfig;
+  /** feat-165 — Meta Direct Send (beta). */
+  direct_send?: IChannelDirectSendConfig;
   /** feat-142 — rollup da recepção do histórico de coexistência (WABA). */
   history_import?: IChannelHistoryImport;
   [key: string]: unknown;

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

@@ -13,6 +13,8 @@ export interface IMessageStatus {
     }>;
     error_code?: string;
     error_message?: string;
+    /** feat-165 — id do template (inclusive o auto-gerado do Direct Send) informado no webhook de status. */
+    template_id?: string | null;
 }
 export interface IMessageMedia {
     gcs_uri?: string;
@@ -68,6 +70,8 @@ export interface IMessageCreatedBy {
 export interface IMessagePricing {
     category?: 'service' | 'utility' | 'authentication' | 'marketing';
     billable?: boolean;
+    /** feat-165 — `pricing.pricing_model` do webhook de status (ex.: PMP). */
+    pricing_model?: string | null;
 }
 export interface IRenderedTemplateButton {
     type?: string;

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

@@ -22,6 +22,8 @@ export interface IMessageStatus {
   errors?: Array<{ code: number; title: string }>;
   error_code?: string;
   error_message?: string;
+  /** feat-165 — id do template (inclusive o auto-gerado do Direct Send) informado no webhook de status. */
+  template_id?: string | null;
 }
 
 // ── Message media ──
@@ -97,6 +99,8 @@ export interface IMessageCreatedBy {
 export interface IMessagePricing {
   category?: 'service' | 'utility' | 'authentication' | 'marketing';
   billable?: boolean;
+  /** feat-165 — `pricing.pricing_model` do webhook de status (ex.: PMP). */
+  pricing_model?: string | null;
 }
 
 // ── Mensagem de template compilada (feat-114) ──

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

@@ -40,6 +40,8 @@ export declare const WabaTemplateParameterFormatEnum: {
     readonly Positional: "POSITIONAL";
 };
 export type WabaTemplateParameterFormat = (typeof WabaTemplateParameterFormatEnum)[keyof typeof WabaTemplateParameterFormatEnum];
+/** Valor de `source` dos templates criados pela Meta para mensagens Direct Send (nao editaveis/deletaveis). */
+export declare const WABA_TEMPLATE_SOURCE_AUTO_GENERATED = "AUTO_GENERATED";
 export interface IWabaTemplateButton {
     type: WabaTemplateButtonType;
     text: string;
@@ -83,6 +85,10 @@ export interface IWabaTemplate extends IFireDoc {
     synced_at?: Date | null;
     is_draft: boolean;
     draft_source?: IWabaTemplateDraftSource;
+    /** Origem na Meta; `AUTO_GENERATED` = gerado pelo Direct Send. */
+    source?: string | null;
+    /** Categoria corrigida pela Meta (`template_correct_category_detection`). */
+    correct_category?: string | null;
 }
 export interface IWabaTemplateCreateRequest {
     name: string;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WabaTemplateParameterFormatEnum = exports.WabaTemplateButtonTypeEnum = exports.WabaTemplateHeaderFormatEnum = exports.WabaTemplateComponentTypeEnum = exports.WabaTemplateCategoryEnum = exports.WabaTemplateStatusEnum = void 0;
+exports.WABA_TEMPLATE_SOURCE_AUTO_GENERATED = exports.WabaTemplateParameterFormatEnum = exports.WabaTemplateButtonTypeEnum = exports.WabaTemplateHeaderFormatEnum = exports.WabaTemplateComponentTypeEnum = exports.WabaTemplateCategoryEnum = exports.WabaTemplateStatusEnum = void 0;
 // ── Enums ──
 exports.WabaTemplateStatusEnum = {
     Draft: 'DRAFT',
@@ -37,3 +37,5 @@ exports.WabaTemplateParameterFormatEnum = {
     Named: 'NAMED',
     Positional: 'POSITIONAL',
 };
+/** Valor de `source` dos templates criados pela Meta para mensagens Direct Send (nao editaveis/deletaveis). */
+exports.WABA_TEMPLATE_SOURCE_AUTO_GENERATED = 'AUTO_GENERATED';

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

@@ -49,6 +49,9 @@ export const WabaTemplateParameterFormatEnum = {
 } as const;
 export type WabaTemplateParameterFormat = (typeof WabaTemplateParameterFormatEnum)[keyof typeof WabaTemplateParameterFormatEnum];
 
+/** Valor de `source` dos templates criados pela Meta para mensagens Direct Send (nao editaveis/deletaveis). */
+export const WABA_TEMPLATE_SOURCE_AUTO_GENERATED = 'AUTO_GENERATED';
+
 // ── Component types ──
 
 export interface IWabaTemplateButton {
@@ -95,6 +98,10 @@ export interface IWabaTemplate extends IFireDoc {
   synced_at?: Date | null;
   is_draft: boolean;
   draft_source?: IWabaTemplateDraftSource;
+  /** Origem na Meta; `AUTO_GENERATED` = gerado pelo Direct Send. */
+  source?: string | null;
+  /** Categoria corrigida pela Meta (`template_correct_category_detection`). */
+  correct_category?: string | null;
 }
 
 // ── Request types ──

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

@@ -47,6 +47,29 @@ export interface IMedCalendarNotificationConfig {
     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. */
 export interface IMedCalendarNotificationEntry {
@@ -74,8 +97,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;
 }

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;
 }

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-telemedicine/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./fb_collections";
 import type { IFireDoc, IFireGlobalDoc } from "../shared";
 import type { ITenantModuleEntitlement } from "../evo-tenant";
+import type { VirtualCareRecordingMode } from "../evo-med/calendar";
 export declare const EvoTelemedicinePermissions: {
     /** Ver estado e dados operacionais básicos. */
     readonly Read: "evo_telemedicine_read";
@@ -259,8 +260,22 @@ export declare const TeleconsultationEventTypeEnum: {
     readonly RecordingConsentRequested: "recording.consent_requested";
     readonly RecordingConsentAccepted: "recording.consent_accepted";
     readonly 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).
+     */
+    readonly RecordingConsentDeclinedPreJoin: "recording.consent_declined_pre_join";
     readonly RecordingConsentWithdrawn: "recording.consent_withdrawn";
     readonly 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.
+     */
+    readonly RecordingAutoStarted: "recording.auto_started";
     readonly RecordingStopped: "recording.stopped";
     readonly RecordingFailed: "recording.failed";
     readonly TranscriptionQueued: "transcription.queued";
@@ -270,6 +285,15 @@ export declare const TeleconsultationEventTypeEnum: {
     readonly ConsultationStarted: "consultation.started";
     readonly ConsultationReconnecting: "consultation.reconnecting";
     readonly 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.
+     */
+    readonly UsageSkipped: "teleconsultation.usage_skipped";
     readonly ArtifactAccessed: "artifact.accessed";
     readonly ArtifactDeleted: "artifact.deleted";
     readonly EntitlementDenied: "entitlement.denied";
@@ -834,6 +858,56 @@ 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;
+    };
 }
 /**
  * `GET /api/room/v1/session` — estado SANITIZADO: sem tenant id, sem ids do
@@ -858,6 +932,12 @@ export interface IRoomSessionDto {
      */
     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
@@ -870,6 +950,12 @@ export interface IRoomSessionDto {
     };
     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[];
@@ -936,11 +1022,93 @@ export interface ITeleconsultationArtifactDto {
     error_code?: string;
     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 declare const ArtifactDispositionEnum: {
+    readonly Inline: "inline";
+    readonly Attachment: "attachment";
+};
+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 declare 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;
+}
+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;
+}
+/**
+ * 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 declare 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 {
     id: string;

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

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TelemedicineErrorCode = exports.EntitlementAuditActionEnum = exports.TELECONSULTATION_PROVIDER_ONLY_FIELDS = exports.TranscriptionProviderEnum = exports.LegalTextStatusEnum = exports.WebhookEventStatusEnum = exports.TeleconsultationEventTypeEnum = exports.TeleconsultationEventSourceEnum = exports.TeleconsultationEventActorTypeEnum = exports.EndedByTypeEnum = exports.AccessSendChannelKindEnum = exports.AccessGrantStateEnum = exports.AccessGrantKindEnum = exports.ArtifactStatusEnum = exports.ArtifactTypeEnum = exports.ConsentActorTypeEnum = exports.ConsentDecisionEnum = exports.ConsentSubjectEnum = exports.TranscriptionStatusEnum = exports.RecordingStatusEnum = exports.IdentityLevelEnum = exports.PresenceStateEnum = exports.ParticipantStateEnum = exports.ParticipantRoleEnum = exports.TeleconsultationProviderEnum = exports.TeleconsultationModeEnum = exports.WaitingPolicyEnum = exports.TELECONSULTATION_TERMINAL_STATUSES = exports.TeleconsultationStatusEnum = exports.TELEMEDICINE_WINDOW_DEFAULTS = exports.TELEMEDICINE_JOIN_REMINDER_HANDLER = exports.TELEMEDICINE_JOIN_ACTION_TYPE = exports.EvoTelemedicinePermissions = void 0;
+exports.TELECONSULTATION_BADGES_MAX_IDS = exports.ARTIFACT_INLINE_SIGNED_URL_MAX_SECONDS = exports.ArtifactDispositionEnum = exports.TelemedicineErrorCode = exports.EntitlementAuditActionEnum = exports.TELECONSULTATION_PROVIDER_ONLY_FIELDS = exports.TranscriptionProviderEnum = exports.LegalTextStatusEnum = exports.WebhookEventStatusEnum = exports.TeleconsultationEventTypeEnum = exports.TeleconsultationEventSourceEnum = exports.TeleconsultationEventActorTypeEnum = exports.EndedByTypeEnum = exports.AccessSendChannelKindEnum = exports.AccessGrantStateEnum = exports.AccessGrantKindEnum = exports.ArtifactStatusEnum = exports.ArtifactTypeEnum = exports.ConsentActorTypeEnum = exports.ConsentDecisionEnum = exports.ConsentSubjectEnum = exports.TranscriptionStatusEnum = exports.RecordingStatusEnum = exports.IdentityLevelEnum = exports.PresenceStateEnum = exports.ParticipantStateEnum = exports.ParticipantRoleEnum = exports.TeleconsultationProviderEnum = exports.TeleconsultationModeEnum = exports.WaitingPolicyEnum = exports.TELECONSULTATION_TERMINAL_STATUSES = exports.TeleconsultationStatusEnum = exports.TELEMEDICINE_WINDOW_DEFAULTS = exports.TELEMEDICINE_JOIN_REMINDER_HANDLER = exports.TELEMEDICINE_JOIN_ACTION_TYPE = exports.EvoTelemedicinePermissions = void 0;
 __exportStar(require("./fb_collections"), exports);
 // ======================================================
 // evo-telemedicine (feat-160 — Telemedicina integrada)
@@ -277,8 +277,22 @@ exports.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",
@@ -288,6 +302,15 @@ exports.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",
@@ -385,3 +408,22 @@ exports.TelemedicineErrorCode = {
     /** 400 — body/params inválidos. */
     ValidationError: "VALIDATION_ERROR",
 };
+/**
+ * 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`.
+ */
+exports.ArtifactDispositionEnum = {
+    Inline: "inline",
+    Attachment: "attachment",
+};
+/**
+ * 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.
+ */
+exports.ARTIFACT_INLINE_SIGNED_URL_MAX_SECONDS = 900;
+/** Teto de ids por chamada; acima disso a rota responde 400. */
+exports.TELECONSULTATION_BADGES_MAX_IDS = 50;