evo360-types 1.3.480 → 1.3.484

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/package.json

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