evo360-types 1.3.570 → 1.3.578

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

@@ -35,6 +35,7 @@ export * from "./types/evo-hub-ia";
 export * from "./types/evo-csq";
 export * from "./types/evo-mcp";
 export * from "./types/evo-reports";
+export * from "./types/evo-telemedicine";
 export * from "./apps/shared/zod-schemas";
 export * from "./apps/evo-core/zod-schemas";
 export * from "./apps/evo-tenant/zod-schemas";
@@ -76,3 +77,4 @@ export * from "./apps/evo-campaigns/zod-schemas";
 export * from "./apps/evo-task-runner/zod-schemas";
 export * from "./apps/hub-automation/zod-schemas";
 export * from "./apps/evo-integrations/zod-schemas";
+export * from "./apps/evo-telemedicine/zod-schemas";

package/dist/index.js

@@ -52,6 +52,7 @@ __exportStar(require("./types/evo-hub-ia"), exports);
 __exportStar(require("./types/evo-csq"), exports);
 __exportStar(require("./types/evo-mcp"), exports);
 __exportStar(require("./types/evo-reports"), exports);
+__exportStar(require("./types/evo-telemedicine"), exports);
 // zod schemas
 __exportStar(require("./apps/shared/zod-schemas"), exports);
 __exportStar(require("./apps/evo-core/zod-schemas"), exports);
@@ -94,3 +95,4 @@ __exportStar(require("./apps/evo-campaigns/zod-schemas"), exports);
 __exportStar(require("./apps/evo-task-runner/zod-schemas"), exports);
 __exportStar(require("./apps/hub-automation/zod-schemas"), exports);
 __exportStar(require("./apps/evo-integrations/zod-schemas"), exports);
+__exportStar(require("./apps/evo-telemedicine/zod-schemas"), exports);

package/dist/index.ts

@@ -36,6 +36,7 @@ export * from "./types/evo-hub-ia";
 export * from "./types/evo-csq";
 export * from "./types/evo-mcp";
 export * from "./types/evo-reports";
+export * from "./types/evo-telemedicine";
 
 // zod schemas
 export * from "./apps/shared/zod-schemas";
@@ -79,3 +80,4 @@ export * from "./apps/evo-campaigns/zod-schemas";
 export * from "./apps/evo-task-runner/zod-schemas";
 export * from "./apps/hub-automation/zod-schemas";
 export * from "./apps/evo-integrations/zod-schemas";
+export * from "./apps/evo-telemedicine/zod-schemas";

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

@@ -123,8 +123,101 @@ export declare const MedCalendarNotificationConfigKeys: {
     readonly AppointmentPayment: "appointment_payment";
     readonly AppointmentPaymentDone: "appointment_payment_done";
     readonly AppointmentInvoice: "appointment_invoice";
+    /**
+     * feat-160 — CTA de ENTRADA na teleconsulta (link `/qr` com capability), lido
+     * pelo handler `telemedicine_join_reminder`. Só faz sentido em agendas com
+     * `appointmentMode = telemedicine` e tenant com `modules.telemedicine` ativo.
+     */
+    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;
@@ -154,5 +247,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 = {
@@ -59,4 +59,69 @@ exports.MedCalendarNotificationConfigKeys = {
     AppointmentPayment: "appointment_payment",
     AppointmentPaymentDone: "appointment_payment_done",
     AppointmentInvoice: "appointment_invoice",
+    /**
+     * feat-160 — CTA de ENTRADA na teleconsulta (link `/qr` com capability), lido
+     * pelo handler `telemedicine_join_reminder`. Só faz sentido em agendas com
+     * `appointmentMode = telemedicine` e tenant com `modules.telemedicine` ativo.
+     */
+    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,
 };

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

@@ -141,11 +141,146 @@ export const MedCalendarNotificationConfigKeys = {
   AppointmentPayment: "appointment_payment",
   AppointmentPaymentDone: "appointment_payment_done",
   AppointmentInvoice: "appointment_invoice",
+  /**
+   * feat-160 — CTA de ENTRADA na teleconsulta (link `/qr` com capability), lido
+   * pelo handler `telemedicine_join_reminder`. Só faz sentido em agendas com
+   * `appointmentMode = telemedicine` e tenant com `modules.telemedicine` ativo.
+   */
+  TelemedicineJoinReminder: "telemedicine_join_reminder",
 } as const;
 
 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;
@@ -181,5 +316,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

@@ -19,6 +19,12 @@ export declare const EvoNotificationsCollections: {
 export type EvoNotificationsCollectionName = (typeof EvoNotificationsCollections)[keyof typeof EvoNotificationsCollections];
 export declare const NotificationTaskKindEnum: {
     readonly Send: "notification.send";
+    /**
+     * feat-160 — kind da task fina de envio do CTA de entrada na teleconsulta
+     * (handler `telemedicine_join_reminder`). Mesmo payload de `notification.send`;
+     * o kind distinto permite dedup/observabilidade próprias do reenvio manual.
+     */
+    readonly TelemedicineJoinSend: "telemedicine_join.send";
 };
 export type NotificationTaskKind = (typeof NotificationTaskKindEnum)[keyof typeof NotificationTaskKindEnum];
 export declare const NotificationsTopics: {
@@ -98,6 +104,13 @@ export interface IQuickReplyActionIntent {
     button_index: number;
     button_label: string;
     expires_at?: Date;
+    /**
+     * feat-160 — segredo de URL (capability de 128 bits, base64url) anexado como
+     * sufixo do link `/qr/{tenant}/{actionId}/{url_secret}`. NUNCA persistido: só
+     * memória de envio (o provider concatena no botão/link e descarta); no grant
+     * fica apenas o HMAC. Nunca logar.
+     */
+    url_secret?: string;
     [key: string]: unknown;
 }
 export interface INotificationSendPayload {

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

@@ -55,6 +55,12 @@ exports.EvoNotificationsCollections = {
 // ----- Task Runner integration
 exports.NotificationTaskKindEnum = {
     Send: "notification.send",
+    /**
+     * feat-160 — kind da task fina de envio do CTA de entrada na teleconsulta
+     * (handler `telemedicine_join_reminder`). Mesmo payload de `notification.send`;
+     * o kind distinto permite dedup/observabilidade próprias do reenvio manual.
+     */
+    TelemedicineJoinSend: "telemedicine_join.send",
 };
 // Logical Pub/Sub topic names (optional, but useful as shared constants)
 exports.NotificationsTopics = {

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

@@ -50,6 +50,12 @@ export type EvoNotificationsCollectionName =
 // ----- Task Runner integration
 export const NotificationTaskKindEnum = {
   Send: "notification.send",
+  /**
+   * feat-160 — kind da task fina de envio do CTA de entrada na teleconsulta
+   * (handler `telemedicine_join_reminder`). Mesmo payload de `notification.send`;
+   * o kind distinto permite dedup/observabilidade próprias do reenvio manual.
+   */
+  TelemedicineJoinSend: "telemedicine_join.send",
 } as const;
 
 export type NotificationTaskKind =
@@ -176,6 +182,13 @@ export interface IQuickReplyActionIntent {
   button_index: number; // template button position (0, 1, 2...)
   button_label: string; // visible button text ("Confirmar")
   expires_at?: Date; // after this, the action cannot be executed
+  /**
+   * feat-160 — segredo de URL (capability de 128 bits, base64url) anexado como
+   * sufixo do link `/qr/{tenant}/{actionId}/{url_secret}`. NUNCA persistido: só
+   * memória de envio (o provider concatena no botão/link e descarta); no grant
+   * fica apenas o HMAC. Nunca logar.
+   */
+  url_secret?: string;
   [key: string]: unknown;
 }
 

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 {

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

@@ -61,6 +61,7 @@ export declare const TaskAutoHandlerEnum: {
     readonly LeadFormCapture: "lead_form_capture";
     readonly CampaignMaterialize: "campaign.materialize";
     readonly CampaignDispatchBatch: "campaign.dispatch_batch";
+    readonly TelemedicineJoinReminder: "telemedicine_join_reminder";
 };
 export type TaskAutoHandler = (typeof TaskAutoHandlerEnum)[keyof typeof TaskAutoHandlerEnum];
 export declare const TaskRetryStrategyEnum: {