evo360-types 1.3.628 → 1.3.634

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

@@ -116,7 +116,11 @@ export declare const zTeleconsultationSchema: z.ZodObject<{
     unused_expires_at: z.ZodEffects<z.ZodDate, Date, unknown>;
     reconnect_until: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
     started_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
+    /** Instante em que o encerramento começou (fase 1 marcou `ending`). */
+    ending_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
     ended_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
+    /** `true` quando o `ended_at` foi DERIVADO por reparo, não medido. */
+    ended_at_derived: z.ZodOptional<z.ZodBoolean>;
     ended_by: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodEnum<["user", "system"]>;
         id: z.ZodOptional<z.ZodString>;
@@ -188,7 +192,11 @@ export declare const zTeleconsultationSchema: z.ZodObject<{
     unused_expires_at: z.ZodEffects<z.ZodDate, Date, unknown>;
     reconnect_until: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
     started_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
+    /** Instante em que o encerramento começou (fase 1 marcou `ending`). */
+    ending_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
     ended_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
+    /** `true` quando o `ended_at` foi DERIVADO por reparo, não medido. */
+    ended_at_derived: z.ZodOptional<z.ZodBoolean>;
     ended_by: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodEnum<["user", "system"]>;
         id: z.ZodOptional<z.ZodString>;
@@ -260,7 +268,11 @@ export declare const zTeleconsultationSchema: z.ZodObject<{
     unused_expires_at: z.ZodEffects<z.ZodDate, Date, unknown>;
     reconnect_until: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
     started_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
+    /** Instante em que o encerramento começou (fase 1 marcou `ending`). */
+    ending_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
     ended_at: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodDate, Date, unknown>>>;
+    /** `true` quando o `ended_at` foi DERIVADO por reparo, não medido. */
+    ended_at_derived: z.ZodOptional<z.ZodBoolean>;
     ended_by: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodEnum<["user", "system"]>;
         id: z.ZodOptional<z.ZodString>;

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

@@ -287,7 +287,11 @@ exports.zTeleconsultationSchema = zod_schemas_1.zFireDocSchema
     unused_expires_at: zDate,
     reconnect_until: zDateNullable,
     started_at: zDateNullable,
+    /** Instante em que o encerramento começou (fase 1 marcou `ending`). */
+    ending_at: zDateNullable,
     ended_at: zDateNullable,
+    /** `true` quando o `ended_at` foi DERIVADO por reparo, não medido. */
+    ended_at_derived: zod_1.z.boolean().optional(),
     ended_by: exports.zTeleconsultationEndedBySchema.nullable().optional(),
     provider: exports.zTeleconsultationProviderSchema,
     provider_meeting_id: zod_1.z.string().optional(),

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

@@ -330,7 +330,11 @@ export const zTeleconsultationSchema = zFireDocSchema
     unused_expires_at: zDate,
     reconnect_until: zDateNullable,
     started_at: zDateNullable,
+    /** Instante em que o encerramento começou (fase 1 marcou `ending`). */
+    ending_at: zDateNullable,
     ended_at: zDateNullable,
+    /** `true` quando o `ended_at` foi DERIVADO por reparo, não medido. */
+    ended_at_derived: z.boolean().optional(),
     ended_by: zTeleconsultationEndedBySchema.nullable().optional(),
     provider: zTeleconsultationProviderSchema,
     provider_meeting_id: z.string().optional(),

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

@@ -38,6 +38,37 @@ export declare const TELEMEDICINE_WINDOW_DEFAULTS: {
     readonly launch_code_ttl_minutes: 5;
     /** Access da sessão pública do browser (`browser_session`), renovável de forma rotativa. */
     readonly browser_session_ttl_minutes: 15;
+    /**
+     * TTL da sessão de browser enquanto a consulta está VIVA (2026-09-28).
+     *
+     * 15 min bastam antes de a consulta começar — é uma janela de preflight. Já
+     * uma consulta em andamento tem pausa, navegador que trava, notebook que
+     * dorme e aba fechada por engano, e com 15 min qualquer um desses obriga o
+     * médico a pedir um launch code NOVO no painel para voltar. 60 min cobre
+     * todos eles com folga.
+     *
+     * O risco de um cookie mais longevo é limitado pela própria consulta: toda
+     * rota da sala relê o estado clínico, e consulta terminal responde `410` — o
+     * cookie fica inerte no fim do encontro, não no fim do TTL. O teto de duração
+     * da plataforma é 1h30, então esta sessão não sobrevive a uma consulta.
+     */
+    readonly browser_session_live_ttl_minutes: 60;
+    /**
+     * Graça para o `sid` ANTERIOR depois da rotação (2026-09-28).
+     *
+     * A sessão rotaciona trocando o cookie na resposta, então qualquer requisição
+     * em vôo no instante da troca carrega o cookie anterior — o `/session` é
+     * polado a cada 5 s, o que faz dessa corrida um evento recorrente em toda
+     * consulta longa, não uma raridade. Dentro desta janela, reusar o `sid`
+     * rotacionado NÃO é comprometimento: é aba que voltou, navegador que travou ou
+     * resposta de rotação que se perdeu no caminho.
+     *
+     * 10 min é o mesmo número de `reconnect_grace_minutes`, de propósito: é a
+     * janela em que o produto JÁ considera que a pessoa continua na mesma
+     * consulta. Um conceito, não dois. Passados os 10 min, reuso de cookie
+     * rotacionado deixa de parecer tropeço e volta a ser sinal de cópia.
+     */
+    readonly browser_session_rotation_grace_minutes: 10;
     /** Verificação de identidade: N falhas na janela bloqueiam o grant. */
     readonly identity_max_failures: 5;
     readonly identity_failure_window_minutes: 15;
@@ -387,7 +418,31 @@ export interface ITeleconsultation extends IFireDoc {
     unused_expires_at: Date;
     reconnect_until?: Date | null;
     started_at?: Date | null;
+    /**
+     * feat-160 (2026-09-29) — instante em que o encerramento COMEÇOU (fase 1 do
+     * `endForAll` marcou `ending`). Na prática é o clique do médico, ou o instante
+     * em que o sweep decidiu encerrar.
+     *
+     * Existe por causa de um furo de FATURAMENTO: as fases 2 e 3 do `endForAll` são
+     * separadas por até três chamadas HTTP ao provedor, feitas fora de transação. Se
+     * o processo morrer ali, o doc fica em `ending` para sempre — sem `ended_at`, sem
+     * `usage_metering_due_at` (logo **nunca cobrado**), sem carimbo de retenção e
+     * sem `provider_teardown_pending` (logo invisível para a varredura de meeting
+     * órfão). `ending` não está em nenhuma das listas de status do sweep.
+     *
+     * Com este campo a passada de reparo sabe (a) há quanto tempo o doc está parado
+     * e (b) que instante usar como `ended_at` — o fim real é desconhecido, e este é
+     * o limite inferior defensável.
+     */
+    ending_at?: Date | null;
     ended_at?: Date | null;
+    /**
+     * feat-160 (2026-09-29) — `true` quando o `ended_at` foi DERIVADO por reparo, e
+     * não medido. Quem lê a duração da consulta precisa saber disso: o fim real
+     * ficou entre o `ending_at` e o instante do reparo, e o que está gravado é o
+     * começo dessa janela.
+     */
+    ended_at_derived?: boolean;
     ended_by?: ITeleconsultationEndedBy | null;
     provider: TeleconsultationProvider;
     /** Id opaco do meeting no provider — nunca vai em external link nem no SPA. */
@@ -1166,6 +1221,25 @@ export interface ITeleconsultationBadgeDto {
     recording_audio: boolean;
     recording_video: boolean;
     transcript: boolean;
+    /**
+     * Início REAL, ISO 8601 UTC, ou `null`. Desde 2026-09-29 "início" é o
+     * **ENCONTRO** — médico E paciente conectados —, não o clique do médico:
+     * abrir a sala e entrar sozinho pode ser curiosidade, e carimbar ali armava
+     * um prazo de 90 min que encerrava a consulta e revogava o link do paciente.
+     *
+     * `null` é RESPOSTA, não dado faltando: significa que o encontro não houve.
+     */
+    started_at: string | null;
+    /**
+     * Fim REAL, ISO 8601 UTC, ou `null`.
+     *
+     * A assimetria normal é `ended_at` preenchido com `started_at` nulo — o
+     * paciente não apareceu e o médico encerrou, ou a consulta expirou. Nesses
+     * casos a duração é INEXISTENTE, não zero, e a tela não deve escrever
+     * "0 min". O inverso não acontece: consulta que teve encontro não chega a
+     * `expired` nem a `cancelled`.
+     */
+    ended_at: string | null;
 }
 /** `GET /v1/appointments/teleconsultation-badges?ids=a,b,c` (máx. 50 ids). */
 export interface ITeleconsultationBadgesResponseDto {

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

@@ -71,6 +71,37 @@ exports.TELEMEDICINE_WINDOW_DEFAULTS = {
     launch_code_ttl_minutes: 5,
     /** Access da sessão pública do browser (`browser_session`), renovável de forma rotativa. */
     browser_session_ttl_minutes: 15,
+    /**
+     * TTL da sessão de browser enquanto a consulta está VIVA (2026-09-28).
+     *
+     * 15 min bastam antes de a consulta começar — é uma janela de preflight. Já
+     * uma consulta em andamento tem pausa, navegador que trava, notebook que
+     * dorme e aba fechada por engano, e com 15 min qualquer um desses obriga o
+     * médico a pedir um launch code NOVO no painel para voltar. 60 min cobre
+     * todos eles com folga.
+     *
+     * O risco de um cookie mais longevo é limitado pela própria consulta: toda
+     * rota da sala relê o estado clínico, e consulta terminal responde `410` — o
+     * cookie fica inerte no fim do encontro, não no fim do TTL. O teto de duração
+     * da plataforma é 1h30, então esta sessão não sobrevive a uma consulta.
+     */
+    browser_session_live_ttl_minutes: 60,
+    /**
+     * Graça para o `sid` ANTERIOR depois da rotação (2026-09-28).
+     *
+     * A sessão rotaciona trocando o cookie na resposta, então qualquer requisição
+     * em vôo no instante da troca carrega o cookie anterior — o `/session` é
+     * polado a cada 5 s, o que faz dessa corrida um evento recorrente em toda
+     * consulta longa, não uma raridade. Dentro desta janela, reusar o `sid`
+     * rotacionado NÃO é comprometimento: é aba que voltou, navegador que travou ou
+     * resposta de rotação que se perdeu no caminho.
+     *
+     * 10 min é o mesmo número de `reconnect_grace_minutes`, de propósito: é a
+     * janela em que o produto JÁ considera que a pessoa continua na mesma
+     * consulta. Um conceito, não dois. Passados os 10 min, reuso de cookie
+     * rotacionado deixa de parecer tropeço e volta a ser sinal de cópia.
+     */
+    browser_session_rotation_grace_minutes: 10,
     /** Verificação de identidade: N falhas na janela bloqueiam o grant. */
     identity_max_failures: 5,
     identity_failure_window_minutes: 15,

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

@@ -67,6 +67,37 @@ export const TELEMEDICINE_WINDOW_DEFAULTS = {
   launch_code_ttl_minutes: 5,
   /** Access da sessão pública do browser (`browser_session`), renovável de forma rotativa. */
   browser_session_ttl_minutes: 15,
+  /**
+   * TTL da sessão de browser enquanto a consulta está VIVA (2026-09-28).
+   *
+   * 15 min bastam antes de a consulta começar — é uma janela de preflight. Já
+   * uma consulta em andamento tem pausa, navegador que trava, notebook que
+   * dorme e aba fechada por engano, e com 15 min qualquer um desses obriga o
+   * médico a pedir um launch code NOVO no painel para voltar. 60 min cobre
+   * todos eles com folga.
+   *
+   * O risco de um cookie mais longevo é limitado pela própria consulta: toda
+   * rota da sala relê o estado clínico, e consulta terminal responde `410` — o
+   * cookie fica inerte no fim do encontro, não no fim do TTL. O teto de duração
+   * da plataforma é 1h30, então esta sessão não sobrevive a uma consulta.
+   */
+  browser_session_live_ttl_minutes: 60,
+  /**
+   * Graça para o `sid` ANTERIOR depois da rotação (2026-09-28).
+   *
+   * A sessão rotaciona trocando o cookie na resposta, então qualquer requisição
+   * em vôo no instante da troca carrega o cookie anterior — o `/session` é
+   * polado a cada 5 s, o que faz dessa corrida um evento recorrente em toda
+   * consulta longa, não uma raridade. Dentro desta janela, reusar o `sid`
+   * rotacionado NÃO é comprometimento: é aba que voltou, navegador que travou ou
+   * resposta de rotação que se perdeu no caminho.
+   *
+   * 10 min é o mesmo número de `reconnect_grace_minutes`, de propósito: é a
+   * janela em que o produto JÁ considera que a pessoa continua na mesma
+   * consulta. Um conceito, não dois. Passados os 10 min, reuso de cookie
+   * rotacionado deixa de parecer tropeço e volta a ser sinal de cópia.
+   */
+  browser_session_rotation_grace_minutes: 10,
   /** Verificação de identidade: N falhas na janela bloqueiam o grant. */
   identity_max_failures: 5,
   identity_failure_window_minutes: 15,
@@ -472,7 +503,31 @@ export interface ITeleconsultation extends IFireDoc {
   unused_expires_at: Date;
   reconnect_until?: Date | null;
   started_at?: Date | null;
+  /**
+   * feat-160 (2026-09-29) — instante em que o encerramento COMEÇOU (fase 1 do
+   * `endForAll` marcou `ending`). Na prática é o clique do médico, ou o instante
+   * em que o sweep decidiu encerrar.
+   *
+   * Existe por causa de um furo de FATURAMENTO: as fases 2 e 3 do `endForAll` são
+   * separadas por até três chamadas HTTP ao provedor, feitas fora de transação. Se
+   * o processo morrer ali, o doc fica em `ending` para sempre — sem `ended_at`, sem
+   * `usage_metering_due_at` (logo **nunca cobrado**), sem carimbo de retenção e
+   * sem `provider_teardown_pending` (logo invisível para a varredura de meeting
+   * órfão). `ending` não está em nenhuma das listas de status do sweep.
+   *
+   * Com este campo a passada de reparo sabe (a) há quanto tempo o doc está parado
+   * e (b) que instante usar como `ended_at` — o fim real é desconhecido, e este é
+   * o limite inferior defensável.
+   */
+  ending_at?: Date | null;
   ended_at?: Date | null;
+  /**
+   * feat-160 (2026-09-29) — `true` quando o `ended_at` foi DERIVADO por reparo, e
+   * não medido. Quem lê a duração da consulta precisa saber disso: o fim real
+   * ficou entre o `ending_at` e o instante do reparo, e o que está gravado é o
+   * começo dessa janela.
+   */
+  ended_at_derived?: boolean;
   ended_by?: ITeleconsultationEndedBy | null;
   provider: TeleconsultationProvider;
   /** Id opaco do meeting no provider — nunca vai em external link nem no SPA. */
@@ -1321,6 +1376,25 @@ export interface ITeleconsultationBadgeDto {
   recording_audio: boolean;
   recording_video: boolean;
   transcript: boolean;
+  /**
+   * Início REAL, ISO 8601 UTC, ou `null`. Desde 2026-09-29 "início" é o
+   * **ENCONTRO** — médico E paciente conectados —, não o clique do médico:
+   * abrir a sala e entrar sozinho pode ser curiosidade, e carimbar ali armava
+   * um prazo de 90 min que encerrava a consulta e revogava o link do paciente.
+   *
+   * `null` é RESPOSTA, não dado faltando: significa que o encontro não houve.
+   */
+  started_at: string | null;
+  /**
+   * Fim REAL, ISO 8601 UTC, ou `null`.
+   *
+   * A assimetria normal é `ended_at` preenchido com `started_at` nulo — o
+   * paciente não apareceu e o médico encerrou, ou a consulta expirou. Nesses
+   * casos a duração é INEXISTENTE, não zero, e a tela não deve escrever
+   * "0 min". O inverso não acontece: consulta que teve encontro não chega a
+   * `expired` nem a `cancelled`.
+   */
+  ended_at: string | null;
 }
 
 /** `GET /v1/appointments/teleconsultation-badges?ids=a,b,c` (máx. 50 ids). */

package/package.json

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