evo360-types 1.3.478 → 1.3.484

package/dist/apps/evo-med/appointment/zod-schemas.d.ts

@@ -633,6 +633,7 @@ export declare const zAppointmentSchema: z.ZodObject<{
     isDraft: z.ZodDefault<z.ZodBoolean>;
     draftExpirationMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status_external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
@@ -969,6 +970,7 @@ export declare const zAppointmentSchema: z.ZodObject<{
     isDraft: z.ZodDefault<z.ZodBoolean>;
     draftExpirationMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status_external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
@@ -1305,6 +1307,7 @@ export declare const zAppointmentSchema: z.ZodObject<{
     isDraft: z.ZodDefault<z.ZodBoolean>;
     draftExpirationMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status_external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodString>;

package/dist/apps/evo-med/appointment/zod-schemas.js

@@ -202,6 +202,15 @@ exports.zAppointmentSchema = zod_schemas_1.zFireDocSchema
     draftExpirationMinutes: zod_1.z.number().nullable().optional(), // tempo em minutos para expiração do rascunho
     // ID externo da consulta
     external_id: zod_1.z.string().nullable().optional(),
+    // ID do STATUS na agenda externa de origem — algumas agendas identificam o
+    // status por id além do rótulo (`status`), e os workflows n8n usam esse id
+    // pra reescrever o agendamento sem resolver o rótulo de volta.
+    //
+    // `coerce` de propósito: agenda externa que devolve id NUMÉRICO é caso
+    // conhecido nesta base (quebrou o `patient.create` uma vez). Com `z.string()`
+    // puro, um `4` faria o write-through reprovar com `contract_violation`.
+    // Nullable/optional resolvem ANTES da coerção — `null` continua `null`.
+    status_external_id: zod_1.z.coerce.string().nullable().optional(),
     tags: zod_1.z.array(zod_schemas_1.zTagSchema).nullable().optional(),
 })
     .passthrough();

package/dist/apps/evo-med/appointment/zod-schemas.ts

@@ -223,6 +223,16 @@ export const zAppointmentSchema = zFireDocSchema
     // ID externo da consulta
     external_id: z.string().nullable().optional(),
 
+    // ID do STATUS na agenda externa de origem — algumas agendas identificam o
+    // status por id além do rótulo (`status`), e os workflows n8n usam esse id
+    // pra reescrever o agendamento sem resolver o rótulo de volta.
+    //
+    // `coerce` de propósito: agenda externa que devolve id NUMÉRICO é caso
+    // conhecido nesta base (quebrou o `patient.create` uma vez). Com `z.string()`
+    // puro, um `4` faria o write-through reprovar com `contract_violation`.
+    // Nullable/optional resolvem ANTES da coerção — `null` continua `null`.
+    status_external_id: z.coerce.string().nullable().optional(),
+
     tags: z.array(zTagSchema).nullable().optional(),
   })
   .passthrough();

package/dist/types/evo-chat/thread-message/index.d.ts

@@ -69,6 +69,56 @@ export interface IMessagePricing {
     category?: 'service' | 'utility' | 'authentication' | 'marketing';
     billable?: boolean;
 }
+export interface IRenderedTemplateButton {
+    type?: string;
+    text?: string;
+    /** Já resolvida: o sufixo dinâmico do link vem substituído pelo valor enviado. */
+    url?: string;
+    phone_number?: string;
+}
+export interface IRenderedTemplateComponent {
+    type?: string;
+    format?: string;
+    /** Já resolvido — sem `{{placeholders}}`, salvo os que ficaram sem valor. */
+    text?: string;
+    buttons?: IRenderedTemplateButton[];
+}
+/**
+ * A mensagem de template como foi enviada, já compilada.
+ *
+ * Sem isto, a thread é reconstruída na LEITURA a partir da definição corrente do
+ * canal: excluir o template apaga a mensagem da tela e editá-lo reescreve o
+ * histórico. Pior, a reconstrução ficava duplicada em cada cliente (Vue e Flutter),
+ * com algoritmos que divergiam entre si.
+ *
+ * O backend compila uma vez, no envio; o cliente só exibe.
+ */
+export interface IRenderedTemplateSnapshot {
+    schema_version: 1;
+    /**
+     * Transcrição textual canônica — header textual, body, footer e rótulos dos
+     * botões, nesta ordem, um por linha. É o campo para quem só precisa LER o
+     * histórico: busca, exportação, BigQuery, auditoria, IA.
+     */
+    text: string;
+    /** Estrutura resolvida, para quem precisa DESENHAR o balão. */
+    components: IRenderedTemplateComponent[];
+    origin: 'send' | 'backfill';
+    /**
+     * `send_compiled` — compilado DURANTE o pipeline de envio, a partir dos componentes
+     * efetivamente enviados e da definição disponível naquele momento.
+     *
+     * NÃO afirma identidade com o que a Meta exibiu ao paciente: ela renderiza o template
+     * vivo. Em parte dos caminhos (endpoints de operador) o payload chega montado pelo
+     * frontend, então a definição usada aqui valida e compila o envio, mas não foi
+     * necessariamente a que o produziu.
+     *
+     * `historical_reconstruction` — remontado depois do envio, a partir do que sobrou.
+     */
+    fidelity: 'send_compiled' | 'historical_reconstruction';
+    /** Chaves sem valor. O placeholder fica visível no texto. Omitido quando vazio. */
+    unresolved?: string[];
+}
 export interface IThreadMessage extends IFireDoc {
     model_ver: number;
     thread_id: string;
@@ -99,7 +149,10 @@ export interface IThreadMessage extends IFireDoc {
     template?: {
         name: string;
         language: string;
+        /** O que foi ENVIADO à Meta: os parâmetros (`{type:'body', parameters:[...]}`). */
         components?: unknown[];
+        /** feat-114: a mensagem já compilada, como foi enviada. Fonte de verdade do histórico. */
+        rendered?: IRenderedTemplateSnapshot;
     };
     context?: IMessageContext;
     call?: IMessageCall;

package/dist/types/evo-chat/thread-message/index.ts

@@ -99,6 +99,66 @@ export interface IMessagePricing {
   billable?: boolean;
 }
 
+// ── Mensagem de template compilada (feat-114) ──
+
+export interface IRenderedTemplateButton {
+  type?: string;
+  text?: string;
+  /** Já resolvida: o sufixo dinâmico do link vem substituído pelo valor enviado. */
+  url?: string;
+  phone_number?: string;
+}
+
+export interface IRenderedTemplateComponent {
+  type?: string;
+  format?: string;
+  /** Já resolvido — sem `{{placeholders}}`, salvo os que ficaram sem valor. */
+  text?: string;
+  buttons?: IRenderedTemplateButton[];
+}
+
+/**
+ * A mensagem de template como foi enviada, já compilada.
+ *
+ * Sem isto, a thread é reconstruída na LEITURA a partir da definição corrente do
+ * canal: excluir o template apaga a mensagem da tela e editá-lo reescreve o
+ * histórico. Pior, a reconstrução ficava duplicada em cada cliente (Vue e Flutter),
+ * com algoritmos que divergiam entre si.
+ *
+ * O backend compila uma vez, no envio; o cliente só exibe.
+ */
+export interface IRenderedTemplateSnapshot {
+  schema_version: 1;
+
+  /**
+   * Transcrição textual canônica — header textual, body, footer e rótulos dos
+   * botões, nesta ordem, um por linha. É o campo para quem só precisa LER o
+   * histórico: busca, exportação, BigQuery, auditoria, IA.
+   */
+  text: string;
+
+  /** Estrutura resolvida, para quem precisa DESENHAR o balão. */
+  components: IRenderedTemplateComponent[];
+
+  origin: 'send' | 'backfill';
+
+  /**
+   * `send_compiled` — compilado DURANTE o pipeline de envio, a partir dos componentes
+   * efetivamente enviados e da definição disponível naquele momento.
+   *
+   * NÃO afirma identidade com o que a Meta exibiu ao paciente: ela renderiza o template
+   * vivo. Em parte dos caminhos (endpoints de operador) o payload chega montado pelo
+   * frontend, então a definição usada aqui valida e compila o envio, mas não foi
+   * necessariamente a que o produziu.
+   *
+   * `historical_reconstruction` — remontado depois do envio, a partir do que sobrou.
+   */
+  fidelity: 'send_compiled' | 'historical_reconstruction';
+
+  /** Chaves sem valor. O placeholder fica visível no texto. Omitido quando vazio. */
+  unresolved?: string[];
+}
+
 // ── Thread Message (evo-chat v3) ──
 
 export interface IThreadMessage extends IFireDoc {
@@ -126,7 +186,10 @@ export interface IThreadMessage extends IFireDoc {
   template?: {
     name: string;
     language: string;
+    /** O que foi ENVIADO à Meta: os parâmetros (`{type:'body', parameters:[...]}`). */
     components?: unknown[];
+    /** feat-114: a mensagem já compilada, como foi enviada. Fonte de verdade do histórico. */
+    rendered?: IRenderedTemplateSnapshot;
   };
   context?: IMessageContext;
 

package/dist/types/evo-med/appointment/index.d.ts

@@ -159,6 +159,17 @@ export interface IAppointment extends IFireDoc {
     payment?: IAppointmentPayment | null;
     reschedules?: IAppointmentReschedule[] | null;
     external_id?: string | null;
+    /**
+     * ID do STATUS na agenda externa de origem. Algumas agendas identificam o
+     * status por id além do rótulo (`status`), e os workflows n8n precisam desse
+     * id pra reescrever o agendamento no externo sem ter que resolver o rótulo
+     * de volta.
+     *
+     * Opcional por natureza: só algumas agendas têm. Autoridade do externo — não
+     * declarado na base global de política, então resolve como `external`.
+     * Não replicado no embed do paciente (ver `IPatientAppointment`).
+     */
+    status_external_id?: string | null;
     isDraft: boolean;
     draftExpirationMinutes?: number | null;
     tags?: ITag[] | null;

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

@@ -201,6 +201,17 @@ export interface IAppointment extends IFireDoc {
   // Controle de remarcações
   reschedules?: IAppointmentReschedule[] | null;
   external_id?: string | null; // ID externo da consulta
+  /**
+   * ID do STATUS na agenda externa de origem. Algumas agendas identificam o
+   * status por id além do rótulo (`status`), e os workflows n8n precisam desse
+   * id pra reescrever o agendamento no externo sem ter que resolver o rótulo
+   * de volta.
+   *
+   * Opcional por natureza: só algumas agendas têm. Autoridade do externo — não
+   * declarado na base global de política, então resolve como `external`.
+   * Não replicado no embed do paciente (ver `IPatientAppointment`).
+   */
+  status_external_id?: string | null;
   // Propriedades para controle de rascunho
   isDraft: boolean;
   draftExpirationMinutes?: number | null; // tempo em minutos para expiração do rascunho

package/package.json

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