evo360-types 1.3.612 → 1.3.614

package/dist/types/nex-vendas/journey.d.ts

@@ -38,6 +38,37 @@ export interface INexVendasJourneySignature {
     requested_at?: Date | null;
     signed_at?: Date | null;
     last_error?: string | null;
+    /**
+     * Consultas ao provider feitas pelo `POST /journeys/:code/signature/check`
+     * (feat-203), podadas a 1 h. É o contador do throttle por jornada (mínimo 90 s
+     * entre consultas, no máximo 5 por hora): a cota da D4Sign é 10 req/h na
+     * conta inteira. A re-checagem do webhook não entra aqui.
+     */
+    checks_at?: Date[] | null;
+}
+/**
+ * Por onde a assinatura foi confirmada no provider (feat-203). Vai em
+ * `data.via` do evento `contract_signed`: `webhook` é o POSTback da D4Sign,
+ * `check` é o "Verificar agora" do shop (caminho de destrave quando o webhook
+ * se perde).
+ */
+export type NexVendasJourneySignatureConfirmVia = 'webhook' | 'check';
+/**
+ * Resultado do `POST /journeys/:code/signature/check` (feat-203 D4):
+ *  - `signed`: o provider confirmou e ESTA chamada avançou a jornada;
+ *  - `already_signed`: já estava assinada (ou o webhook venceu a corrida);
+ *  - `pending`: o provider ainda não tem a assinatura;
+ *  - `not_confirmed`: o provider respondeu outro status (recusado, cancelado…);
+ *  - `not_applicable`: a jornada não está esperando assinatura — nada consultado;
+ *  - `provider_unavailable`: sem provider configurado ou a consulta falhou.
+ *
+ * O throttle NÃO é um outcome: sai como 429 `too_many_checks` com `retry_after_s`.
+ */
+export type NexVendasJourneySignatureCheckOutcome = 'signed' | 'already_signed' | 'pending' | 'not_confirmed' | 'not_applicable' | 'provider_unavailable';
+export interface INexVendasJourneySignatureCheckResult {
+    outcome: NexVendasJourneySignatureCheckOutcome;
+    /** Segundos até a próxima consulta ao provider ser aceita; ausente quando não se aplica. */
+    retry_after_s?: number | null;
 }
 /**
  * Envelope substituído por correção de dados antes da assinatura (feat-200).
@@ -225,6 +256,29 @@ export interface INexVendasJourneyNotification {
     sent_at: Date;
     error?: string | null;
 }
+/**
+ * Como o lead foi achado. `contact_index` = índice de contatos do chat pelo
+ * telefone (com e sem o 9º dígito); `phone` = telefone exato no lead;
+ * `algolia` = busca por dígitos no índice de leads; `email` = e-mail exato;
+ * `created` = nada casou e a jornada criou o lead.
+ */
+export type NexVendasJourneyLeadResolvedBy = 'contact_index' | 'phone' | 'algolia' | 'email' | 'created';
+/**
+ * Lead do CRM do tenant das notificações da jornada. É a âncora que as
+ * notificações levam em `externalLinks` (`crm_lead`): sem ela o hub-omni
+ * descarta o e-mail, que não cria contato sozinho.
+ *
+ * Re-resolução por correção de telefone/e-mail que devolve OUTRO lead
+ * sobrescreve este bloco e registra o evento `lead_relinked`; falha do
+ * resolvedor registra `lead_resolve_failed` e não bloqueia a jornada.
+ */
+export interface INexVendasJourneyLeadRef {
+    /** Tenant dono do lead — o do canal resolvido para as notificações. */
+    tenant: string;
+    lead_id: string;
+    resolved_by: NexVendasJourneyLeadResolvedBy;
+    resolved_at: Date;
+}
 /**
  * Slots que disparam efeito externo NÃO-idempotente e por isso precisam de
  * reserva transacional: criar o contrato, criar o envelope de assinatura,
@@ -269,6 +323,8 @@ export interface INexVendasJourney extends IFireGlobalDoc {
     contract_ref?: string | null;
     tenant_ref?: string | null;
     customer_id?: string | null;
+    /** Lead do CRM no tenant das notificações (feat-202). Ausente = ainda não resolvido. */
+    lead_ref?: INexVendasJourneyLeadRef | null;
     customer_data?: INexVendasJourneyCustomerData | null;
     signature?: INexVendasJourneySignature | null;
     /** Envelopes substituídos por correção de dados (feat-200). */

package/dist/types/nex-vendas/journey.ts

@@ -91,6 +91,46 @@ export interface INexVendasJourneySignature {
   requested_at?: Date | null;
   signed_at?: Date | null;
   last_error?: string | null;
+  /**
+   * Consultas ao provider feitas pelo `POST /journeys/:code/signature/check`
+   * (feat-203), podadas a 1 h. É o contador do throttle por jornada (mínimo 90 s
+   * entre consultas, no máximo 5 por hora): a cota da D4Sign é 10 req/h na
+   * conta inteira. A re-checagem do webhook não entra aqui.
+   */
+  checks_at?: Date[] | null;
+}
+
+/**
+ * Por onde a assinatura foi confirmada no provider (feat-203). Vai em
+ * `data.via` do evento `contract_signed`: `webhook` é o POSTback da D4Sign,
+ * `check` é o "Verificar agora" do shop (caminho de destrave quando o webhook
+ * se perde).
+ */
+export type NexVendasJourneySignatureConfirmVia = 'webhook' | 'check';
+
+/**
+ * Resultado do `POST /journeys/:code/signature/check` (feat-203 D4):
+ *  - `signed`: o provider confirmou e ESTA chamada avançou a jornada;
+ *  - `already_signed`: já estava assinada (ou o webhook venceu a corrida);
+ *  - `pending`: o provider ainda não tem a assinatura;
+ *  - `not_confirmed`: o provider respondeu outro status (recusado, cancelado…);
+ *  - `not_applicable`: a jornada não está esperando assinatura — nada consultado;
+ *  - `provider_unavailable`: sem provider configurado ou a consulta falhou.
+ *
+ * O throttle NÃO é um outcome: sai como 429 `too_many_checks` com `retry_after_s`.
+ */
+export type NexVendasJourneySignatureCheckOutcome =
+  | 'signed'
+  | 'already_signed'
+  | 'pending'
+  | 'not_confirmed'
+  | 'not_applicable'
+  | 'provider_unavailable';
+
+export interface INexVendasJourneySignatureCheckResult {
+  outcome: NexVendasJourneySignatureCheckOutcome;
+  /** Segundos até a próxima consulta ao provider ser aceita; ausente quando não se aplica. */
+  retry_after_s?: number | null;
 }
 
 /**
@@ -316,6 +356,38 @@ export interface INexVendasJourneyNotification {
   error?: string | null;
 }
 
+// ── Lead do CRM (feat-202) ──
+
+/**
+ * Como o lead foi achado. `contact_index` = índice de contatos do chat pelo
+ * telefone (com e sem o 9º dígito); `phone` = telefone exato no lead;
+ * `algolia` = busca por dígitos no índice de leads; `email` = e-mail exato;
+ * `created` = nada casou e a jornada criou o lead.
+ */
+export type NexVendasJourneyLeadResolvedBy =
+  | 'contact_index'
+  | 'phone'
+  | 'algolia'
+  | 'email'
+  | 'created';
+
+/**
+ * Lead do CRM do tenant das notificações da jornada. É a âncora que as
+ * notificações levam em `externalLinks` (`crm_lead`): sem ela o hub-omni
+ * descarta o e-mail, que não cria contato sozinho.
+ *
+ * Re-resolução por correção de telefone/e-mail que devolve OUTRO lead
+ * sobrescreve este bloco e registra o evento `lead_relinked`; falha do
+ * resolvedor registra `lead_resolve_failed` e não bloqueia a jornada.
+ */
+export interface INexVendasJourneyLeadRef {
+  /** Tenant dono do lead — o do canal resolvido para as notificações. */
+  tenant: string;
+  lead_id: string;
+  resolved_by: NexVendasJourneyLeadResolvedBy;
+  resolved_at: Date;
+}
+
 // ── Reserva de efeito externo ──
 
 /**
@@ -368,6 +440,8 @@ export interface INexVendasJourney extends IFireGlobalDoc {
   contract_ref?: string | null;
   tenant_ref?: string | null;
   customer_id?: string | null;
+  /** Lead do CRM no tenant das notificações (feat-202). Ausente = ainda não resolvido. */
+  lead_ref?: INexVendasJourneyLeadRef | null;
 
   customer_data?: INexVendasJourneyCustomerData | null;
   signature?: INexVendasJourneySignature | null;

package/package.json

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