evo360-types 1.3.574 → 1.3.581

package/dist/apps/evo-telemedicine/zod-schemas.ts

@@ -112,6 +112,9 @@ export const zArtifactTypeSchema = z.enum([
   "transcript",
 ]);
 
+/** Espelha `ArtifactDispositionEnum` (feat-160 F21). */
+export const zArtifactDispositionSchema = z.enum(["inline", "attachment"]);
+
 /** Espelha `ArtifactStatusEnum`. */
 export const zArtifactStatusSchema = z.enum([
   "pending",
@@ -127,6 +130,8 @@ export const zAccessGrantKindSchema = z.enum([
   "qr_capability",
   "launch_code",
   "browser_session",
+  // feat-160 F7: `kind` de uma ENTRADA do `grant-index`, nunca de um grant.
+  "ics_capability",
 ]);
 
 /** Espelha `AccessGrantStateEnum`. */
@@ -173,6 +178,7 @@ export const zTeleconsultationEventTypeSchema = z.enum([
   "teleconsultation.expired",
   "teleconsultation.diverged",
   "access.created",
+  "access.link_revealed",
   "access.revoked",
   "access.exchanged",
   "access.verification_failed",
@@ -196,8 +202,10 @@ export const zTeleconsultationEventTypeSchema = z.enum([
   "recording.consent_requested",
   "recording.consent_accepted",
   "recording.consent_declined",
+  "recording.consent_declined_pre_join",
   "recording.consent_withdrawn",
   "recording.started",
+  "recording.auto_started",
   "recording.stopped",
   "recording.failed",
   "transcription.queued",
@@ -207,6 +215,7 @@ export const zTeleconsultationEventTypeSchema = z.enum([
   "consultation.started",
   "consultation.reconnecting",
   "consultation.ended",
+  "teleconsultation.usage_skipped",
   "artifact.accessed",
   "artifact.deleted",
   "entitlement.denied",
@@ -325,7 +334,17 @@ export const zTeleconsultationSchema = zFireDocSchema
     provider_meeting_id: z.string().optional(),
     active_provider_session_id: z.string().optional(),
     recording_status: zRecordingStatusSchema,
+    recording_request_id: z.string().optional(),
+    recording_terms_version: z.string().optional(),
+    recording_requested_at: zDateNullable,
+    recording_requested_by: z.string().optional(),
+    recording_started_at: zDateNullable,
+    recording_stopped_at: zDateNullable,
+    recording_failure_code: z.string().nullable().optional(),
+    recording_segment: z.number().int().min(0).optional(),
     transcription_status: zTranscriptionStatusSchema,
+    provider_teardown_pending: z.boolean().optional(),
+    metadata_retention_until: zDateNullable,
     entitlement_snapshot: zTeleconsultationEntitlementSnapshotSchema,
     generation: z.number().int().min(0),
     reschedule_count: z.number().int().min(0).optional(),
@@ -334,10 +353,34 @@ export const zTeleconsultationSchema = zFireDocSchema
       .nullable()
       .optional(),
     last_reconciled_at: zDateNullable,
+    usage_metering_due_at: zDateNullable,
+    usage_metered_at: zDateNullable,
     version: z.number().int().min(0),
   })
   .passthrough();
 
+/**
+ * Espelha `ITeleconsultationPrivateProvider` (subdoc `private/provider`).
+ *
+ * NÃO estende `zFireDocSchema`: o subdoc não é um IFireDoc (não tem `version`
+ * de concorrência nem `ref`), e é lido sempre pelo backend com `id` do snap.
+ */
+export const zTeleconsultationPrivateProviderSchema = z
+  .object({
+    id: z.string(),
+    tenant: z.string().min(1),
+    teleconsultation_id: z.string().min(1),
+    provider: zTeleconsultationProviderSchema,
+    provider_meeting_id: z.string().optional(),
+    active_provider_session_id: z.string().optional(),
+    provider_session_ids: z.array(z.string().min(1)).optional(),
+    provider_participant_ids: z.record(z.string(), z.string()).optional(),
+    active_provider_recording_id: z.string().nullable().optional(),
+    created_at: zDateNullable,
+    updated_at: zDateNullable,
+  })
+  .passthrough();
+
 /** Espelha `ITeleconsultationParticipant`. */
 export const zTeleconsultationParticipantSchema = zFireDocSchema
   .extend({
@@ -399,6 +442,7 @@ export const zTeleconsultationArtifactSchema = zFireDocSchema
     started_at: zDateNullable,
     ended_at: zDateNullable,
     expires_at: zDateNullable,
+    deleted_at: zDateNullable,
     error_code: z.string().optional(),
   })
   .passthrough();
@@ -486,6 +530,8 @@ export const zTelemedicineAppointmentIndexSchema = zFireDocSchema
       .union([z.number(), z.string()])
       .nullable()
       .optional(),
+    last_reconciled_at: zDateNullable,
+    last_teleconsultation_id: z.string().nullable().optional(),
   })
   .passthrough();
 
@@ -569,6 +615,7 @@ export const zTelemedicineGrantIndexSchema = zGlobalDocSchema
     tenant: z.string().min(1),
     teleconsultation_id: z.string().min(1),
     grant_id: z.string().min(1),
+    kind: zAccessGrantKindSchema.optional(),
     expires_at: zDate,
   })
   .passthrough();
@@ -654,6 +701,36 @@ export const zConsentCommandSchema = z
   })
   .strict();
 
+/**
+ * `POST /api/room/v1/join` — espelha `IJoinCommand`.
+ *
+ * `.passthrough()`, não `.strict()`, ao contrário dos outros comandos: o
+ * backend hoje LÊ os dois booleanos à mão e ignora o resto, e o corpo é a
+ * intenção de mídia do preflight. Trocar por `.strict()` faria um campo novo do
+ * SPA derrubar o join inteiro em `400` — alto preço para um corpo que o
+ * servidor pode ignorar por completo.
+ */
+export const zJoinCommandSchema = z
+  .object({
+    audio: z.boolean().optional(),
+    video: z.boolean().optional(),
+  })
+  .passthrough();
+
+/**
+ * `POST /api/room/v1/leave` — espelha `ILeaveCommand`.
+ *
+ * `.passthrough()` pelo mesmo motivo, agravado: este corpo chega pelo
+ * `pagehide` com `fetch(keepalive)` e é a ÚLTIMA chance de registrar a saída.
+ * Um 400 aqui é uma saída perdida, e o backend já trata corpo ausente
+ * (`reason` default `'temporary'`).
+ */
+export const zLeaveCommandSchema = z
+  .object({
+    reason: z.string().trim().min(1).max(60).optional(),
+  })
+  .passthrough();
+
 /** `POST /api/room/v1/presence` — espelha `IPresenceCommand`. */
 export const zPresenceCommandSchema = z
   .object({
@@ -721,3 +798,22 @@ export const zTelemetryCommandSchema = z
       .max(50),
   })
   .strict();
+
+/**
+ * `POST /v1/teleconsultations/:id/artifacts/:artifactId/signed-url` (feat-160
+ * F21) — espelha `IArtifactSignedUrlCommand`.
+ *
+ * `.strict()` de propósito: chave desconhecida aqui é erro de contrato —
+ * `ttlSeconds` em camelCase passaria em silêncio como "sem TTL pedido" e o bug
+ * apareceria como "o teto não respeita o que eu mandei". 30 s é o piso do use
+ * case e 900 s (`ARTIFACT_INLINE_SIGNED_URL_MAX_SECONDS`) o teto do modo mais
+ * generoso; o teto REAL por modo é aplicado pelo use case e de novo pelo
+ * adapter — este schema só recusa forma.
+ */
+export const zArtifactSignedUrlCommandSchema = z
+  .object({
+    disposition: zArtifactDispositionSchema.optional(),
+    ttl_seconds: z.number().int().min(30).max(900).optional(),
+    refresh: z.boolean().optional(),
+  })
+  .strict();

package/dist/apps/shared/zod-schemas.d.ts

@@ -90,6 +90,7 @@ export declare const zContactSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram_username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bsuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     email: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     phone: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -97,6 +98,7 @@ export declare const zContactSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram_username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bsuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     email: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     phone: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -104,4 +106,5 @@ export declare const zContactSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram_username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bsuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;

package/dist/apps/shared/zod-schemas.js

@@ -89,4 +89,6 @@ exports.zContactSchema = zod_1.z.object({
     type: zod_1.z.string().nullable().optional(),
     instagram: zod_1.z.string().nullable().optional(),
     instagram_username: zod_1.z.string().nullable().optional(),
+    // WhatsApp BSUID (Business-Scoped User ID) — contato que a Meta entrega sem telefone
+    bsuid: zod_1.z.string().nullable().optional(),
 }).passthrough();

package/dist/apps/shared/zod-schemas.ts

@@ -104,4 +104,6 @@ export const zContactSchema = z.object({
   type: z.string().nullable().optional(),
   instagram: z.string().nullable().optional(),
   instagram_username: z.string().nullable().optional(),
+  // WhatsApp BSUID (Business-Scoped User ID) — contato que a Meta entrega sem telefone
+  bsuid: z.string().nullable().optional(),
 }).passthrough();

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-finops/common/contract.d.ts

@@ -76,6 +76,14 @@ export declare const NexFinopsMetricCatalog: {
         readonly label: "E-mails enviados";
         readonly unit: "mensagens";
     };
+    readonly teleconsultations_unrecorded: {
+        readonly label: "Teleconsultas sem gravação";
+        readonly unit: "consultas";
+    };
+    readonly teleconsultations_recorded: {
+        readonly label: "Teleconsultas com gravação";
+        readonly unit: "consultas";
+    };
 };
 /**
  * Chaves conhecidas do catálogo — para iterar e para tipar escolha de métrica

package/dist/types/evo-finops/common/contract.js

@@ -11,6 +11,13 @@ exports.NexFinopsMetricCatalog = {
     attendances: { label: 'Atendimentos', unit: 'contatos' },
     sms: { label: 'SMS enviados', unit: 'mensagens' },
     email: { label: 'E-mails enviados', unit: 'mensagens' },
+    // feat-160 F18 (D33) — DISJUNTAS: uma teleconsulta realizada consome
+    // exatamente UMA das duas. `_recorded` NAO e subconjunto de um total; o total
+    // e derivado na tela. A transcricao esta dentro de `_recorded`, nao tem
+    // franquia propria. Ler uma como subconjunto da outra cobra o mesmo encontro
+    // duas vezes.
+    teleconsultations_unrecorded: { label: 'Teleconsultas sem gravação', unit: 'consultas' },
+    teleconsultations_recorded: { label: 'Teleconsultas com gravação', unit: 'consultas' },
 };
 /** Doc de config global dos alertas de consumo (convenção `/platform/<app>`). */
 exports.EVO_BILLING_USAGE_ALERTS_CONFIG_PATH = 'platform/evo-billing/usage-alerts/config';

package/dist/types/evo-finops/common/contract.ts

@@ -80,6 +80,13 @@ export const NexFinopsMetricCatalog = {
   attendances: { label: 'Atendimentos', unit: 'contatos' },
   sms: { label: 'SMS enviados', unit: 'mensagens' },
   email: { label: 'E-mails enviados', unit: 'mensagens' },
+  // feat-160 F18 (D33) — DISJUNTAS: uma teleconsulta realizada consome
+  // exatamente UMA das duas. `_recorded` NAO e subconjunto de um total; o total
+  // e derivado na tela. A transcricao esta dentro de `_recorded`, nao tem
+  // franquia propria. Ler uma como subconjunto da outra cobra o mesmo encontro
+  // duas vezes.
+  teleconsultations_unrecorded: { label: 'Teleconsultas sem gravação', unit: 'consultas' },
+  teleconsultations_recorded: { label: 'Teleconsultas com gravação', unit: 'consultas' },
 } as const;
 
 /**

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;
 }
@@ -131,6 +156,93 @@ export declare const MedCalendarNotificationConfigKeys: {
     readonly TelemedicineJoinReminder: "telemedicine_join_reminder";
 };
 export type MedCalendarNotificationConfigKey = (typeof MedCalendarNotificationConfigKeys)[keyof typeof MedCalendarNotificationConfigKeys];
+/** `recording.mode` da agenda (feat-160 F15). `off` esconde "Solicitar gravação". */
+export declare const VirtualCareRecordingModeEnum: {
+    /** Gravação indisponível nesta agenda. */
+    readonly Off: "off";
+    /** Médico solicita em sala e o paciente aceita ali (comportamento do MVP). */
+    readonly Manual: "manual";
+    /** Inicia sozinha, só áudio; o aceite é colhido ANTES de o paciente entrar. */
+    readonly AutoAudio: "auto_audio";
+    /** Idem, com vídeo. */
+    readonly AutoVideo: "auto_video";
+};
+export type VirtualCareRecordingMode = (typeof VirtualCareRecordingModeEnum)[keyof typeof VirtualCareRecordingModeEnum];
+/** Limites de `recording.retention_days` (D32; D13 mantém 7 como default). */
+export declare const VIRTUAL_CARE_RETENTION_DAYS_MIN = 7;
+export declare const VIRTUAL_CARE_RETENTION_DAYS_MAX = 730;
+/** Limites de `max_duration_minutes`. */
+export declare const VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = 15;
+export declare 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 declare const CALENDAR_VIRTUAL_CARE_DEFAULTS: IMedCalendarVirtualCareSettings;
 export interface IMedCalendar extends IFireDoc {
     calendarId: string;
     color?: string;
@@ -160,5 +272,16 @@ export interface IMedCalendar extends IFireDoc {
     available_for_hubia?: boolean | null;
     integration?: IMedCalendarIntegration | null;
     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;
 }

package/dist/types/evo-med/calendar/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.MedCalendarNotificationConfigKeys = exports.EvoMedCalendarPermissions = void 0;
+exports.CALENDAR_VIRTUAL_CARE_DEFAULTS = exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = exports.VIRTUAL_CARE_RETENTION_DAYS_MAX = exports.VIRTUAL_CARE_RETENTION_DAYS_MIN = exports.VirtualCareRecordingModeEnum = exports.MedCalendarNotificationConfigKeys = exports.EvoMedCalendarPermissions = void 0;
 __exportStar(require("../../evo-people/fb_collections"), exports);
 // Permissões para o calendário
 exports.EvoMedCalendarPermissions = {
@@ -66,3 +66,62 @@ exports.MedCalendarNotificationConfigKeys = {
      */
     TelemedicineJoinReminder: "telemedicine_join_reminder",
 };
+// ----- 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". */
+exports.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",
+};
+/** Limites de `recording.retention_days` (D32; D13 mantém 7 como default). */
+exports.VIRTUAL_CARE_RETENTION_DAYS_MIN = 7;
+exports.VIRTUAL_CARE_RETENTION_DAYS_MAX = 730;
+/** Limites de `max_duration_minutes`. */
+exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = 15;
+exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = 480;
+/**
+ * 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 }`).
+ */
+exports.CALENDAR_VIRTUAL_CARE_DEFAULTS = {
+    auto_admit: false,
+    recording: {
+        mode: exports.VirtualCareRecordingModeEnum.Manual,
+        transcription: false,
+        retention_days: exports.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,
+};