evo360-types 1.3.630 → 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

@@ -418,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. */
@@ -1197,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.ts

@@ -503,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. */
@@ -1352,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.630",
+  "version": "1.3.634",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",