evo360-types 1.3.614 → 1.3.618

package/dist/types/domain-events/index.d.ts

@@ -27,6 +27,14 @@ export interface IDomainEventResource {
     parent?: {
         calendar_id?: string;
     } | null;
+    /**
+     * feat-205: discriminador de OCORRÊNCIA sobre o MESMO recurso (ex.: a NF
+     * emitida para a consulta — `occurrence_id` = invoiceId). Quando presente,
+     * entra na identidade da rotina (idempotency key da task materializada), de
+     * modo que duas ocorrências distintas sobre o mesmo recurso no mesmo dia não
+     * colapsam. Ausente = identidade legada, byte a byte igual.
+     */
+    occurrence_id?: string | null;
 }
 /**
  * Envelope canonico de um evento de dominio. Publicado em DOMAIN_EVENTS_TOPIC.

package/dist/types/domain-events/index.ts

@@ -46,6 +46,14 @@ export interface IDomainEventResource {
   path?: string | null;
   /** hierarquia (ex.: calendar_id do appointment) para reconstruir o alvo. */
   parent?: { calendar_id?: string } | null;
+  /**
+   * feat-205: discriminador de OCORRÊNCIA sobre o MESMO recurso (ex.: a NF
+   * emitida para a consulta — `occurrence_id` = invoiceId). Quando presente,
+   * entra na identidade da rotina (idempotency key da task materializada), de
+   * modo que duas ocorrências distintas sobre o mesmo recurso no mesmo dia não
+   * colapsam. Ausente = identidade legada, byte a byte igual.
+   */
+  occurrence_id?: string | null;
 }
 
 // ── Envelope ──

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

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

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

@@ -137,6 +137,14 @@ exports.TaskAutoHandlerEnum = {
     // `telemedicine_join_reminder.execute_requests`.
     // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
     TelemedicineJoinReminder: "telemedicine_join_reminder",
+    // feat-205: envio da NFS-e autorizada ao paciente — variant do executor único
+    // do lembrete (functions-integrations), lendo
+    // `notification_config.configs.appointment_invoice`; disparado pelo evento
+    // `agendamento.nf_emitida`. Entrega um link `/qr` (`invoice_link`) para o PDF
+    // no WhatsApp (botão URL) e no e-mail (`linknf`). Tópico:
+    // `appointment_invoice.execute_requests`.
+    // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
+    AppointmentInvoice: "appointment_invoice",
 };
 // ----- Retry policy
 exports.TaskRetryStrategyEnum = {

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

@@ -148,6 +148,14 @@ export const TaskAutoHandlerEnum = {
   // `telemedicine_join_reminder.execute_requests`.
   // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
   TelemedicineJoinReminder: "telemedicine_join_reminder",
+  // feat-205: envio da NFS-e autorizada ao paciente — variant do executor único
+  // do lembrete (functions-integrations), lendo
+  // `notification_config.configs.appointment_invoice`; disparado pelo evento
+  // `agendamento.nf_emitida`. Entrega um link `/qr` (`invoice_link`) para o PDF
+  // no WhatsApp (botão URL) e no e-mail (`linknf`). Tópico:
+  // `appointment_invoice.execute_requests`.
+  // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, criar a task estoura ZodError.
+  AppointmentInvoice: "appointment_invoice",
 } as const;
 
 export type TaskAutoHandler =

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

@@ -82,9 +82,20 @@ export declare const TeleconsultationProviderEnum: {
     readonly RealtimeKit: "realtimekit";
 };
 export type TeleconsultationProvider = (typeof TeleconsultationProviderEnum)[keyof typeof TeleconsultationProviderEnum];
+/**
+ * Papel do participante LÓGICO dentro da sala.
+ *
+ * `guest` (feat-160 R8, 2026-09-25) é o acompanhante: até 3 por sala, cada um
+ * num slot próprio (`guest-1..3`), entrando pelo MESMO link do paciente. Ele
+ * não é papel de GRANT — o grant continua `patient`, porque o link é o do
+ * titular; o que decide `guest` é a alocação de slot no momento da entrada
+ * (`allocateParticipantSlot`). Um acompanhante nunca tem `patient_id` e nunca
+ * herda o consentimento do paciente.
+ */
 export declare const ParticipantRoleEnum: {
     readonly Doctor: "doctor";
     readonly Patient: "patient";
+    readonly Guest: "guest";
 };
 export type ParticipantRole = (typeof ParticipantRoleEnum)[keyof typeof ParticipantRoleEnum];
 /** Presença — separada do estado clínico da teleconsulta. */
@@ -257,6 +268,16 @@ export declare const TeleconsultationEventTypeEnum: {
     readonly PatientDisconnected: "patient.disconnected";
     readonly PatientRejoined: "patient.rejoined";
     readonly PatientLeft: "patient.left";
+    /**
+     * feat-160 R8 — peer EXCEDENTE de um participante que já estava `connected`
+     * (duas abas com o mesmo token). É a segunda perna da trava de ocupação: a
+     * primeira recusa a quinta pessoa na EMISSÃO, esta derruba quem duplicou a
+     * OCUPAÇÃO — sem ela a Cloudflare cobraria as duas abas.
+     *
+     * Não é `patient.disconnected` (aquela é presença de quem estava dentro) nem
+     * `access.blocked` (aquela é lockout de identidade no grant).
+     */
+    readonly ParticipantDuplicatePeer: "participant.duplicate_peer";
     readonly RecordingConsentRequested: "recording.consent_requested";
     readonly RecordingConsentAccepted: "recording.consent_accepted";
     readonly RecordingConsentDeclined: "recording.consent_declined";
@@ -487,6 +508,26 @@ export interface ITeleconsultationParticipant extends IFireDoc {
     /** `custom_participant_id` opaco enviado ao provider — nunca o patientId. */
     opaque_custom_participant_id: string;
     state: ParticipantState;
+    /**
+     * feat-160 R8 — ordinal do acompanhante (1..3). Só para `role = guest`; é o
+     * número da etiqueta ("Acompanhante 2") e o que ordena os blocos na tela.
+     * Ausente para médico e paciente, que têm slot único.
+     */
+    slot_ordinal?: number;
+    /**
+     * feat-160 R8 — id estável do NAVEGADOR que ocupa este slot.
+     *
+     * A sessão pública rotaciona (`browser_session` nova a cada refresh, com
+     * `parent_grant_id = root_grant_id`), então nem o grant da sessão nem o
+     * grant raiz servem de "quem é este navegador": o primeiro muda a cada
+     * rotação e o segundo é o MESMO para todos que usam o link do paciente. Este
+     * campo é esse elo: gerado no `/exchange`, copiado na rotação, e gravado
+     * aqui quando o slot é alocado — é o que faz recarregar a página manter a
+     * etiqueta em vez de reembaralhar.
+     *
+     * Opaco (128 bits em base64url), não é segredo e não identifica pessoa.
+     */
+    session_family_id?: string;
     identity_level?: IdentityLevel;
     admitted_at?: Date | null;
     connected_at?: Date | null;
@@ -610,6 +651,16 @@ export interface ITeleconsultationAccessGrant extends IFireDoc {
     blocked_until?: Date | null;
     /** `launch_code` filho de `qr_capability`; `browser_session` filho do code/capability. */
     parent_grant_id?: string;
+    /**
+     * feat-160 R8 — família de sessões de UM navegador.
+     *
+     * Nasce no `/exchange` e é COPIADA em cada rotação, então a cadeia de
+     * `browser_session` de um mesmo navegador compartilha este id enquanto
+     * `parent_grant_id` (o grant raiz) é compartilhado por TODOS os navegadores
+     * que usaram o link. É por ele que o slot alocado (`participant_id`) volta
+     * para o mesmo dono depois de um reload.
+     */
+    session_family_id?: string;
     /** Canal do envio que originou o grant (`qr_capability`). */
     channel_kind?: AccessSendChannelKind;
     /** Doc `quick-reply-actions/{actionId}` ligado ao grant — cancelado no revoke. */
@@ -772,6 +823,13 @@ export declare const TelemedicineErrorCode: {
     readonly ProviderError: "PROVIDER_ERROR";
     /** 429 — rate limit por IP-hash/grant. */
     readonly RateLimited: "RATE_LIMITED";
+    /**
+     * 409 — sala cheia (feat-160 R8): médico + paciente + 3 acompanhantes, e
+     * nenhum slot livre no instante da entrada. O teto é NOSSO — o provedor não
+     * oferece limite de participantes (página de limites conferida em
+     * 2026-09-25) —, e ele é de EMISSÃO: quem recebe este erro não recebe token.
+     */
+    readonly RoomFull: "ROOM_FULL";
     /** 400 — body/params inválidos. */
     readonly ValidationError: "VALIDATION_ERROR";
 };
@@ -786,6 +844,12 @@ export interface ITeleconsultationParticipantDto {
     participant_id: string;
     role: ParticipantRole;
     state: ParticipantState;
+    /**
+     * feat-160 R8 — ordinal do acompanhante (1..3), quando `role = guest`. É o
+     * número da etiqueta na tela; `session_family_id` NÃO sai no DTO (é estado
+     * interno de alocação, não interessa ao cliente).
+     */
+    slot_ordinal?: number;
     identity_level?: IdentityLevel;
     admitted_at?: string | null;
     connected_at?: string | null;
@@ -1060,7 +1124,7 @@ export interface ISignedUrlResponseDto {
     /** Modo efetivamente aplicado (`attachment` quando o comando omite). */
     disposition?: ArtifactDisposition;
 }
-export type TranscriptSpeakerRole = "doctor" | "patient" | "unknown";
+export type TranscriptSpeakerRole = "doctor" | "patient" | "guest" | "unknown";
 export interface ITranscriptSpeakerDto {
     /** `opaque_custom_participant_id` que amarra a fala ao papel. */
     key: string;

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

@@ -116,9 +116,20 @@ exports.TeleconsultationModeEnum = {
 exports.TeleconsultationProviderEnum = {
     RealtimeKit: "realtimekit",
 };
+/**
+ * Papel do participante LÓGICO dentro da sala.
+ *
+ * `guest` (feat-160 R8, 2026-09-25) é o acompanhante: até 3 por sala, cada um
+ * num slot próprio (`guest-1..3`), entrando pelo MESMO link do paciente. Ele
+ * não é papel de GRANT — o grant continua `patient`, porque o link é o do
+ * titular; o que decide `guest` é a alocação de slot no momento da entrada
+ * (`allocateParticipantSlot`). Um acompanhante nunca tem `patient_id` e nunca
+ * herda o consentimento do paciente.
+ */
 exports.ParticipantRoleEnum = {
     Doctor: "doctor",
     Patient: "patient",
+    Guest: "guest",
 };
 /** Presença — separada do estado clínico da teleconsulta. */
 exports.ParticipantStateEnum = {
@@ -274,6 +285,16 @@ exports.TeleconsultationEventTypeEnum = {
     PatientDisconnected: "patient.disconnected",
     PatientRejoined: "patient.rejoined",
     PatientLeft: "patient.left",
+    /**
+     * feat-160 R8 — peer EXCEDENTE de um participante que já estava `connected`
+     * (duas abas com o mesmo token). É a segunda perna da trava de ocupação: a
+     * primeira recusa a quinta pessoa na EMISSÃO, esta derruba quem duplicou a
+     * OCUPAÇÃO — sem ela a Cloudflare cobraria as duas abas.
+     *
+     * Não é `patient.disconnected` (aquela é presença de quem estava dentro) nem
+     * `access.blocked` (aquela é lockout de identidade no grant).
+     */
+    ParticipantDuplicatePeer: "participant.duplicate_peer",
     RecordingConsentRequested: "recording.consent_requested",
     RecordingConsentAccepted: "recording.consent_accepted",
     RecordingConsentDeclined: "recording.consent_declined",
@@ -411,6 +432,13 @@ exports.TelemedicineErrorCode = {
     ProviderError: "PROVIDER_ERROR",
     /** 429 — rate limit por IP-hash/grant. */
     RateLimited: "RATE_LIMITED",
+    /**
+     * 409 — sala cheia (feat-160 R8): médico + paciente + 3 acompanhantes, e
+     * nenhum slot livre no instante da entrada. O teto é NOSSO — o provedor não
+     * oferece limite de participantes (página de limites conferida em
+     * 2026-09-25) —, e ele é de EMISSÃO: quem recebe este erro não recebe token.
+     */
+    RoomFull: "ROOM_FULL",
     /** 400 — body/params inválidos. */
     ValidationError: "VALIDATION_ERROR",
 };

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

@@ -126,9 +126,20 @@ export const TeleconsultationProviderEnum = {
 export type TeleconsultationProvider =
   (typeof TeleconsultationProviderEnum)[keyof typeof TeleconsultationProviderEnum];
 
+/**
+ * Papel do participante LÓGICO dentro da sala.
+ *
+ * `guest` (feat-160 R8, 2026-09-25) é o acompanhante: até 3 por sala, cada um
+ * num slot próprio (`guest-1..3`), entrando pelo MESMO link do paciente. Ele
+ * não é papel de GRANT — o grant continua `patient`, porque o link é o do
+ * titular; o que decide `guest` é a alocação de slot no momento da entrada
+ * (`allocateParticipantSlot`). Um acompanhante nunca tem `patient_id` e nunca
+ * herda o consentimento do paciente.
+ */
 export const ParticipantRoleEnum = {
   Doctor: "doctor",
   Patient: "patient",
+  Guest: "guest",
 } as const;
 export type ParticipantRole = (typeof ParticipantRoleEnum)[keyof typeof ParticipantRoleEnum];
 
@@ -325,6 +336,16 @@ export const TeleconsultationEventTypeEnum = {
   PatientDisconnected: "patient.disconnected",
   PatientRejoined: "patient.rejoined",
   PatientLeft: "patient.left",
+  /**
+   * feat-160 R8 — peer EXCEDENTE de um participante que já estava `connected`
+   * (duas abas com o mesmo token). É a segunda perna da trava de ocupação: a
+   * primeira recusa a quinta pessoa na EMISSÃO, esta derruba quem duplicou a
+   * OCUPAÇÃO — sem ela a Cloudflare cobraria as duas abas.
+   *
+   * Não é `patient.disconnected` (aquela é presença de quem estava dentro) nem
+   * `access.blocked` (aquela é lockout de identidade no grant).
+   */
+  ParticipantDuplicatePeer: "participant.duplicate_peer",
   RecordingConsentRequested: "recording.consent_requested",
   RecordingConsentAccepted: "recording.consent_accepted",
   RecordingConsentDeclined: "recording.consent_declined",
@@ -578,6 +599,26 @@ export interface ITeleconsultationParticipant extends IFireDoc {
   /** `custom_participant_id` opaco enviado ao provider — nunca o patientId. */
   opaque_custom_participant_id: string;
   state: ParticipantState;
+  /**
+   * feat-160 R8 — ordinal do acompanhante (1..3). Só para `role = guest`; é o
+   * número da etiqueta ("Acompanhante 2") e o que ordena os blocos na tela.
+   * Ausente para médico e paciente, que têm slot único.
+   */
+  slot_ordinal?: number;
+  /**
+   * feat-160 R8 — id estável do NAVEGADOR que ocupa este slot.
+   *
+   * A sessão pública rotaciona (`browser_session` nova a cada refresh, com
+   * `parent_grant_id = root_grant_id`), então nem o grant da sessão nem o
+   * grant raiz servem de "quem é este navegador": o primeiro muda a cada
+   * rotação e o segundo é o MESMO para todos que usam o link do paciente. Este
+   * campo é esse elo: gerado no `/exchange`, copiado na rotação, e gravado
+   * aqui quando o slot é alocado — é o que faz recarregar a página manter a
+   * etiqueta em vez de reembaralhar.
+   *
+   * Opaco (128 bits em base64url), não é segredo e não identifica pessoa.
+   */
+  session_family_id?: string;
   identity_level?: IdentityLevel;
   admitted_at?: Date | null;
   connected_at?: Date | null;
@@ -707,6 +748,16 @@ export interface ITeleconsultationAccessGrant extends IFireDoc {
   blocked_until?: Date | null;
   /** `launch_code` filho de `qr_capability`; `browser_session` filho do code/capability. */
   parent_grant_id?: string;
+  /**
+   * feat-160 R8 — família de sessões de UM navegador.
+   *
+   * Nasce no `/exchange` e é COPIADA em cada rotação, então a cadeia de
+   * `browser_session` de um mesmo navegador compartilha este id enquanto
+   * `parent_grant_id` (o grant raiz) é compartilhado por TODOS os navegadores
+   * que usaram o link. É por ele que o slot alocado (`participant_id`) volta
+   * para o mesmo dono depois de um reload.
+   */
+  session_family_id?: string;
   /** Canal do envio que originou o grant (`qr_capability`). */
   channel_kind?: AccessSendChannelKind;
   /** Doc `quick-reply-actions/{actionId}` ligado ao grant — cancelado no revoke. */
@@ -891,6 +942,13 @@ export const TelemedicineErrorCode = {
   ProviderError: "PROVIDER_ERROR",
   /** 429 — rate limit por IP-hash/grant. */
   RateLimited: "RATE_LIMITED",
+  /**
+   * 409 — sala cheia (feat-160 R8): médico + paciente + 3 acompanhantes, e
+   * nenhum slot livre no instante da entrada. O teto é NOSSO — o provedor não
+   * oferece limite de participantes (página de limites conferida em
+   * 2026-09-25) —, e ele é de EMISSÃO: quem recebe este erro não recebe token.
+   */
+  RoomFull: "ROOM_FULL",
   /** 400 — body/params inválidos. */
   ValidationError: "VALIDATION_ERROR",
 } as const;
@@ -913,6 +971,12 @@ export interface ITeleconsultationParticipantDto {
   participant_id: string;
   role: ParticipantRole;
   state: ParticipantState;
+  /**
+   * feat-160 R8 — ordinal do acompanhante (1..3), quando `role = guest`. É o
+   * número da etiqueta na tela; `session_family_id` NÃO sai no DTO (é estado
+   * interno de alocação, não interessa ao cliente).
+   */
+  slot_ordinal?: number;
   identity_level?: IdentityLevel;
   admitted_at?: string | null;
   connected_at?: string | null;
@@ -1208,7 +1272,7 @@ export interface ISignedUrlResponseDto {
 // `seekTo` e o `mm:ss` da bolha vem de arredondamento — dois consumidores do
 // mesmo número, e um `0.1 + 0.2` no meio é ruído garantido.
 
-export type TranscriptSpeakerRole = "doctor" | "patient" | "unknown";
+export type TranscriptSpeakerRole = "doctor" | "patient" | "guest" | "unknown";
 
 export interface ITranscriptSpeakerDto {
   /** `opaque_custom_participant_id` que amarra a fala ao papel. */

package/package.json

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