evo360-types 1.3.501 → 1.3.505

package/dist/types/evo-finops/common/billing.d.ts

@@ -6,6 +6,27 @@ export interface INexFinopsBillingServiceItem {
     description: string;
     amount: number;
 }
+/**
+ * Termos efetivamente enviados ao emissor do boleto.
+ *
+ * Todos os campos são obrigatórios de propósito: a distinção entre "multa 0, não
+ * cobra" e "não sabemos os termos deste boleto" é a PRESENÇA do objeto, nunca um
+ * campo interno ausente. Snapshot presente é sempre completo; ausente significa
+ * boleto emitido antes do snapshot existir, e o frontend mostra "—", nunca um
+ * valor estimado.
+ */
+export interface INexFinopsBillingBoletoTerms {
+    /** Vencimento enviado ao Inter, data civil YYYY-MM-DD. */
+    due_date: string;
+    /** O numDiasAgenda efetivamente enviado. */
+    num_dias_agenda: number;
+    /** Data limite de pagamento (YYYY-MM-DD) = due_date + num_dias_agenda. */
+    payment_deadline: string;
+    /** Multa efetiva em % sobre o nominal. `0` = campo omitido do payload, não cobra. */
+    multa_taxa: number;
+    /** Mora efetiva em % ao mês. `0` = campo omitido do payload, não cobra. */
+    mora_taxa: number;
+}
 export interface INexFinopsBillingPaymentOption {
     type: 'pix' | 'boleto' | 'payment_link';
     provider_id?: string | null;
@@ -15,6 +36,12 @@ export interface INexFinopsBillingPaymentOption {
     qr_code_payload?: string | null;
     expires_at?: string | null;
     status?: string | null;
+    boleto_terms?: INexFinopsBillingBoletoTerms | null;
+    /**
+     * Liga a option ao seu PDF (`boleto-inter-{nossoNumero}.pdf`). Sem ele, uma
+     * cobrança com dois boletos casa a linha digitável de um com o PDF do outro.
+     */
+    nosso_numero?: string | null;
 }
 export interface INexFinopsBillingCompetency {
     year: number;

package/dist/types/evo-finops/common/billing.ts

@@ -19,6 +19,28 @@ export interface INexFinopsBillingServiceItem {
   amount: number;
 }
 
+/**
+ * Termos efetivamente enviados ao emissor do boleto.
+ *
+ * Todos os campos são obrigatórios de propósito: a distinção entre "multa 0, não
+ * cobra" e "não sabemos os termos deste boleto" é a PRESENÇA do objeto, nunca um
+ * campo interno ausente. Snapshot presente é sempre completo; ausente significa
+ * boleto emitido antes do snapshot existir, e o frontend mostra "—", nunca um
+ * valor estimado.
+ */
+export interface INexFinopsBillingBoletoTerms {
+  /** Vencimento enviado ao Inter, data civil YYYY-MM-DD. */
+  due_date: string;
+  /** O numDiasAgenda efetivamente enviado. */
+  num_dias_agenda: number;
+  /** Data limite de pagamento (YYYY-MM-DD) = due_date + num_dias_agenda. */
+  payment_deadline: string;
+  /** Multa efetiva em % sobre o nominal. `0` = campo omitido do payload, não cobra. */
+  multa_taxa: number;
+  /** Mora efetiva em % ao mês. `0` = campo omitido do payload, não cobra. */
+  mora_taxa: number;
+}
+
 export interface INexFinopsBillingPaymentOption {
   type: 'pix' | 'boleto' | 'payment_link';
   provider_id?: string | null;
@@ -28,6 +50,12 @@ export interface INexFinopsBillingPaymentOption {
   qr_code_payload?: string | null;
   expires_at?: string | null;
   status?: string | null;
+  boleto_terms?: INexFinopsBillingBoletoTerms | null;
+  /**
+   * Liga a option ao seu PDF (`boleto-inter-{nossoNumero}.pdf`). Sem ele, uma
+   * cobrança com dois boletos casa a linha digitável de um com o PDF do outro.
+   */
+  nosso_numero?: string | null;
 }
 
 export interface INexFinopsBillingCompetency {

package/dist/types/evo-finops/providers/inter/inter_provider.d.ts

@@ -5,6 +5,23 @@ export interface IInterWebhookConfig {
     enabled: boolean;
     secret_hash?: string;
 }
+/**
+ * Parâmetros comerciais do boleto. Ficam no Firestore de propósito: são
+ * parâmetro de negócio e mudam sem envolver engenharia nem deploy.
+ *
+ * Campo ausente cai no default do backend.
+ */
+export interface IInterBoletoDefaults {
+    /**
+     * Dias corridos após o vencimento até o cancelamento automático no Inter —
+     * na prática, o prazo limite para pagar. O máximo aceito pela API é 60.
+     */
+    num_dias_agenda?: number;
+    /** Multa por atraso, em % sobre o valor nominal. `0` desliga (campo omitido do payload ao Inter). */
+    multa_taxa?: number;
+    /** Juros de mora, em % ao mês. `0` desliga (campo omitido do payload ao Inter). */
+    mora_taxa?: number;
+}
 export interface IInterEnvAuthConfig {
     enabled: boolean;
     base_url?: string;
@@ -14,6 +31,7 @@ export interface IInterEnvAuthConfig {
     key_pem_secret_ref: GoogleSecretRef;
     conta_corrente?: string;
     timeout_ms?: number;
+    boleto_defaults?: IInterBoletoDefaults;
     webhook?: IInterWebhookConfig;
 }
 export interface IInterBoletoPIXCapabilities {

package/dist/types/evo-finops/providers/inter/inter_provider.ts

@@ -10,6 +10,26 @@ export interface IInterWebhookConfig {
   secret_hash?: string;
 }
 
+// ── Boleto defaults ──
+
+/**
+ * Parâmetros comerciais do boleto. Ficam no Firestore de propósito: são
+ * parâmetro de negócio e mudam sem envolver engenharia nem deploy.
+ *
+ * Campo ausente cai no default do backend.
+ */
+export interface IInterBoletoDefaults {
+  /**
+   * Dias corridos após o vencimento até o cancelamento automático no Inter —
+   * na prática, o prazo limite para pagar. O máximo aceito pela API é 60.
+   */
+  num_dias_agenda?: number;
+  /** Multa por atraso, em % sobre o valor nominal. `0` desliga (campo omitido do payload ao Inter). */
+  multa_taxa?: number;
+  /** Juros de mora, em % ao mês. `0` desliga (campo omitido do payload ao Inter). */
+  mora_taxa?: number;
+}
+
 // ── Auth ──
 
 export interface IInterEnvAuthConfig {
@@ -26,6 +46,8 @@ export interface IInterEnvAuthConfig {
 
   timeout_ms?: number;
 
+  boleto_defaults?: IInterBoletoDefaults;
+
   webhook?: IInterWebhookConfig;
 }
 

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

@@ -58,6 +58,7 @@ export declare const TaskAutoHandlerEnum: {
     readonly AppointmentConfirmation: "appointment_confirmation";
     readonly AppointmentPostConsultation: "appointment_post_consultation";
     readonly IntegrationsSyncRun: "evo-integrations.sync-run";
+    readonly LeadFormCapture: "lead_form_capture";
     readonly CampaignMaterialize: "campaign.materialize";
     readonly CampaignDispatchBatch: "campaign.dispatch_batch";
 };

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

@@ -117,6 +117,12 @@ exports.TaskAutoHandlerEnum = {
     // types/evo-integrations). Permite que o `/force` roteie pelo task-runner e
     // herde retry/backoff/DLQ, em vez de montar a mensagem PubSub na mão.
     IntegrationsSyncRun: "evo-integrations.sync-run",
+    // feat-121: captação de lead por FORMULÁRIO (site/landing). Resolve ou cria o lead
+    // pelo telefone, aplica o pipe que vier no payload (origem/qualificação/tags/campanha)
+    // e inicia a conversa no WhatsApp conforme o `mode` (`contato` | `agenda_demo`).
+    // Tópico do executor: `lead_form_capture.execute_requests` (functions-notifications).
+    // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, o POST /tasks estoura ZodError.
+    LeadFormCapture: "lead_form_capture",
     // feat-081 F2: handlers do modulo de campanhas (padrao pontilhado da feat-078 —
     // `resolveHandlerTopic` monta `campaign.materialize.execute_requests`, topico que
     // a CF `campaign_materialize` ja escuta desde a F1, e

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

@@ -128,6 +128,12 @@ export const TaskAutoHandlerEnum = {
   // types/evo-integrations). Permite que o `/force` roteie pelo task-runner e
   // herde retry/backoff/DLQ, em vez de montar a mensagem PubSub na mão.
   IntegrationsSyncRun: "evo-integrations.sync-run",
+  // feat-121: captação de lead por FORMULÁRIO (site/landing). Resolve ou cria o lead
+  // pelo telefone, aplica o pipe que vier no payload (origem/qualificação/tags/campanha)
+  // e inicia a conversa no WhatsApp conforme o `mode` (`contato` | `agenda_demo`).
+  // Tópico do executor: `lead_form_capture.execute_requests` (functions-notifications).
+  // Espelhado à mão em `zTaskAutoHandlerSchema` — sem lá, o POST /tasks estoura ZodError.
+  LeadFormCapture: "lead_form_capture",
   // feat-081 F2: handlers do modulo de campanhas (padrao pontilhado da feat-078 —
   // `resolveHandlerTopic` monta `campaign.materialize.execute_requests`, topico que
   // a CF `campaign_materialize` ja escuta desde a F1, e

package/package.json

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