evo360-types 1.3.644 → 1.3.651

package/dist/apps/evo-finops/zod-schemas.js

@@ -225,6 +225,13 @@ exports.zAsaasEnvAuthConfigSchema = zod_1.z
         rate_limit_max_per_minute: zod_1.z.number().optional(),
     })
         .optional(),
+    /** feat-253 — IP enviado na cobrança com token quando a credencial não tem o do pagador. */
+    card_token: zod_1.z
+        .object({
+        remote_ip: zod_1.z.string().max(64).optional().nullable(),
+    })
+        .strip()
+        .optional(),
 })
     .passthrough();
 exports.zAsaasNfseCapabilitiesSchema = zod_1.z.object({
@@ -241,10 +248,14 @@ exports.zAsaasEnvFlagSchema = zod_1.z
     .strip();
 exports.zAsaasPaymentsCapabilitiesSchema = zod_1.z.object({
     enabled: zod_1.z.boolean(),
-    /** feat-253 — kill-switch do caminho A. */
+    /** feat-253 — kill-switch do caminho A. @deprecated (caminho A saiu do modelo). */
     card_subscription_adjust: exports.zAsaasEnvFlagSchema.optional(),
-    /** feat-253 — flag do caminho B (token). */
+    /** feat-253 — flag do caminho B (captura + cobrança com token). */
     card_token: exports.zAsaasEnvFlagSchema.optional(),
+    /** feat-253 — fatura hospedada (contingência C + entrada da captura). */
+    hosted_invoice: exports.zAsaasEnvFlagSchema.optional(),
+    /** feat-253 — job de cobrança automática no vencimento (fatia 8). */
+    card_token_auto: exports.zAsaasEnvFlagSchema.optional(),
 });
 exports.zAsaasProviderCapabilitiesSchema = zod_1.z.object({
     nfse: exports.zAsaasNfseCapabilitiesSchema,
@@ -951,13 +962,26 @@ exports.zNexFinopsContractPaymentMethodsWriteSchema = zod_1.z
     default_payment_method_id: zod_1.z.string().min(1).max(128).optional().nullable(),
 })
     .strip();
-/** `POST /billings/:id/card-charge` (F2/F3). */
+/**
+ * `POST /billings/:id/card-charge` (feat-253 F2b).
+ * - `preview`: prévia da cobrança no cartão salvo (não escreve).
+ * - `charge_now`: cobra no cartão salvo (`confirm` + `expected_value`).
+ * - `send_invoice`: fatura hospedada do Asaas (`billing_type` CREDIT_CARD captura o cartão; UNDEFINED = cliente escolhe).
+ * - `cancel_invoice`: cancela a fatura aberta (`asaas_payment_id`).
+ * `.strip()`: dados de cartão/token nunca entram por aqui.
+ */
 exports.zNexFinopsBillingCardChargeSchema = zod_1.z
     .object({
-    action: zod_1.z.enum(["preview", "adjust", "revert", "charge_now"]),
-    expected_value: zod_1.z.number(),
+    action: zod_1.z.enum(["preview", "charge_now", "send_invoice", "cancel_invoice"]),
+    expected_value: zod_1.z.number().optional(),
     asaas_payment_id: zod_1.z.string().min(1).max(128).optional(),
     confirm: zod_1.z.boolean().optional(),
+    capture_card: zod_1.z.boolean().optional(),
+    billing_type: zod_1.z.enum(["CREDIT_CARD", "UNDEFINED"]).optional(),
+    provider_id: zod_1.z.string().min(1).max(128).optional(),
+    env: zod_1.z.enum(["sandbox", "production"]).optional(),
+    taker_id: zod_1.z.string().min(1).max(128).optional(),
+    allow_early: zod_1.z.boolean().optional(),
 })
     .strip();
 /** `POST /payment-methods/discover` — sem `confirm` é dry-run. */

package/dist/apps/evo-finops/zod-schemas.ts

@@ -237,6 +237,13 @@ export const zAsaasEnvAuthConfigSchema = z
         rate_limit_max_per_minute: z.number().optional(),
       })
       .optional(),
+    /** feat-253 — IP enviado na cobrança com token quando a credencial não tem o do pagador. */
+    card_token: z
+      .object({
+        remote_ip: z.string().max(64).optional().nullable(),
+      })
+      .strip()
+      .optional(),
   })
   .passthrough();
 
@@ -256,10 +263,14 @@ export const zAsaasEnvFlagSchema = z
 
 export const zAsaasPaymentsCapabilitiesSchema = z.object({
   enabled: z.boolean(),
-  /** feat-253 — kill-switch do caminho A. */
+  /** feat-253 — kill-switch do caminho A. @deprecated (caminho A saiu do modelo). */
   card_subscription_adjust: zAsaasEnvFlagSchema.optional(),
-  /** feat-253 — flag do caminho B (token). */
+  /** feat-253 — flag do caminho B (captura + cobrança com token). */
   card_token: zAsaasEnvFlagSchema.optional(),
+  /** feat-253 — fatura hospedada (contingência C + entrada da captura). */
+  hosted_invoice: zAsaasEnvFlagSchema.optional(),
+  /** feat-253 — job de cobrança automática no vencimento (fatia 8). */
+  card_token_auto: zAsaasEnvFlagSchema.optional(),
 });
 
 export const zAsaasProviderCapabilitiesSchema = z.object({
@@ -1046,13 +1057,26 @@ export const zNexFinopsContractPaymentMethodsWriteSchema = z
   })
   .strip();
 
-/** `POST /billings/:id/card-charge` (F2/F3). */
+/**
+ * `POST /billings/:id/card-charge` (feat-253 F2b).
+ * - `preview`: prévia da cobrança no cartão salvo (não escreve).
+ * - `charge_now`: cobra no cartão salvo (`confirm` + `expected_value`).
+ * - `send_invoice`: fatura hospedada do Asaas (`billing_type` CREDIT_CARD captura o cartão; UNDEFINED = cliente escolhe).
+ * - `cancel_invoice`: cancela a fatura aberta (`asaas_payment_id`).
+ * `.strip()`: dados de cartão/token nunca entram por aqui.
+ */
 export const zNexFinopsBillingCardChargeSchema = z
   .object({
-    action: z.enum(["preview", "adjust", "revert", "charge_now"]),
-    expected_value: z.number(),
+    action: z.enum(["preview", "charge_now", "send_invoice", "cancel_invoice"]),
+    expected_value: z.number().optional(),
     asaas_payment_id: z.string().min(1).max(128).optional(),
     confirm: z.boolean().optional(),
+    capture_card: z.boolean().optional(),
+    billing_type: z.enum(["CREDIT_CARD", "UNDEFINED"]).optional(),
+    provider_id: z.string().min(1).max(128).optional(),
+    env: z.enum(["sandbox", "production"]).optional(),
+    taker_id: z.string().min(1).max(128).optional(),
+    allow_early: z.boolean().optional(),
   })
   .strip();
 

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

@@ -165,10 +165,28 @@ export interface ICsqAlert {
      *  Nexus linkar `/{tenant}/evo-med/calendar/{calendar_id}/appointment/{appointment_id}`. */
     appointment_id?: string;
     calendar_id?: string;
+    /** So em alertas de agenda (feat-206 F6a): o claim que gerou o alerta, gravado
+     *  quando ele nasce. As rechecagens tardias (passos 3 e 4, `closed_at + 4 h` e
+     *  `+ 24 h`) reconferem a agenda a partir DELE, porque o claim so existe em
+     *  `report.claims` da avaliacao que o extraiu e um laudo mais novo do mesmo
+     *  lead pode ter herdado o alerta. Ausente em alertas antigos: passo tardio
+     *  nao se aplica (sem backfill). */
+    appointment_claim?: ICsqAlertAppointmentClaim;
     /** Ticket em que o alerta apareceu pela primeira vez (herdado x novo). */
     first_seen_ticket_id: string;
     created_at: Date;
 }
+/** O que foi informado ao lead, copiado do claim `appointment_informed`
+ *  (feat-206 F6a). Sem `evidence`: a evidencia ja esta em `ICsqAlert.evidence`. */
+export interface ICsqAlertAppointmentClaim {
+    /** YYYY-MM-DD, TZ do tenant. */
+    date: string;
+    /** HH:mm. */
+    time?: string;
+    professional?: string;
+    patient_name?: string;
+    modality?: string;
+}
 /** Indicadores quantitativos calculados por codigo, por lente
  *  ("neste atendimento" e "na jornada"). `null` = nao aplicavel a lente ou
  *  indisponivel (ex.: metricas liquidas sem horario comercial configurado). */
@@ -266,6 +284,10 @@ export interface ICsqClaimAppointmentInformed {
     modality?: string;
     /** Nome do paciente informado na conversa (mae/filho: pode diferir do lead). */
     patient_name?: string;
+    /** feat-206 F6: o agendamento informado deixou de valer DEPOIS, na mesma
+     *  jornada (o lead cancelou/desistiu, ou foi trocado por outro horario). O
+     *  codigo nao exige registro na agenda de um claim assim. */
+    superseded?: boolean;
     evidence: ICsqEvidence[];
 }
 /** "Prometi X ate quando". */
@@ -328,11 +350,19 @@ export interface ICsqClaimPriceInformed {
 /** Uniao discriminada por `type` — o juiz extrai, o codigo verifica (§5). */
 export type ICsqClaim = ICsqClaimAppointmentInformed | ICsqClaimPromise | ICsqClaimDataCollected | ICsqClaimRequiredData | ICsqClaimOutcome | ICsqClaimQuestionRequiresAnswer | ICsqClaimFirstConcreteOffer | ICsqClaimPatientStatus | ICsqClaimPriceInformed;
 export type CsqClaimType = ICsqClaim["type"];
+/** Como o agendamento da agenda foi identificado como sendo do paciente da
+ *  conversa, na ordem de forca da prova (feat-154 B1; `name_fuzzy` na feat-206
+ *  F6a: nome com grafia diferente, so no mesmo dia e hora do claim). */
+export type CsqAppointmentMatch = "linked" | "phone" | "name" | "name_fuzzy";
+/** Resultado do cruzamento por codigo.
+ *  - `cancelled_after` (feat-206 F6a): o agendamento EXISTIU e foi cancelado ou
+ *    excluido DEPOIS da mensagem que o informou ao lead — nao e "nao registrado". */
+export type CsqCrossCheckResult = "match" | "mismatch" | "missing" | "inconclusive" | "cancelled_after";
 /** Linha da tabela "o que foi dito x o que consta" (report-spec §2.5). */
 export interface ICsqCrossCheck {
     claim_type: CsqClaimType;
     /** Resultado da verificacao por codigo. */
-    result: "match" | "mismatch" | "missing" | "inconclusive";
+    result: CsqCrossCheckResult;
     /** O que foi dito (resumo do claim). */
     expected: string;
     /** O que consta no sistema. */
@@ -343,6 +373,8 @@ export interface ICsqCrossCheck {
     /** So em cruzamentos de agenda: agendamento encontrado (link no Nexus). */
     appointment_id?: string;
     calendar_id?: string;
+    /** So em cruzamentos de agenda: como o agendamento foi identificado. */
+    matched_by?: CsqAppointmentMatch;
 }
 /** Nota de um criterio. Todo criterio < 100 exige evidencia valida; sem ela o
  *  codigo zera para `null` e tira do denominador. */
@@ -453,7 +485,13 @@ export type CsqTriageMode = "skip_llm" | "full_review";
 /** Motivo da triagem. `skip_llm` sempre tem motivo; `full_review` normalmente
  *  nao tem (lista vazia), salvo `forced` (replay do dry-run com
  *  `--force-review`; producao nunca usa). */
-export type CsqTriageReason = "document_only" | "spam_close" | "reopen_without_new_messages" | "automation_only" | "ack_only" | "forced";
+export type CsqTriageReason = "document_only" | "spam_close" | "reopen_without_new_messages" | "automation_only" | "ack_only"
+/** feat-206 F6b: nenhum texto livre de atendente humano nem nota; a HubIA
+ *  falou no maximo uma vez (saudacao/fora do expediente). */
+ | "no_attendant_message"
+/** feat-206 F6b: o lead nao escreveu texto livre e todo texto da atendente
+ *  e confirmacao curta (sem data/hora, valor ou pergunta). */
+ | "attendant_ack_only" | "forced";
 export interface ICsqTriageDecision {
     mode: CsqTriageMode;
     reasons: CsqTriageReason[];
@@ -558,6 +596,13 @@ export interface ICsqAppointmentFact {
     professional_name?: string;
     modality?: string;
     created_at?: Date;
+    /** feat-206 F6a: agendamento que saiu da agenda — excluido (`deleted_at`) ou
+     *  cancelado (`status_base` cancelado). So vem marcado na leitura de
+     *  candidatos da agenda; o verificador nunca o trata como agendamento vivo. */
+    removed?: "deleted" | "cancelled";
+    /** Quando saiu: `deleted_at`; cancelado sem `deleted_at` usa `updated_at`.
+     *  Ausente = nao comparavel com a mensagem que informou o agendamento. */
+    removed_at?: Date;
 }
 /** Agendamento envolvido numa sobreposicao (lote 9). */
 export interface ICsqOverlapAppointmentFact {

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

@@ -365,11 +365,30 @@ export interface ICsqAlert {
    *  Nexus linkar `/{tenant}/evo-med/calendar/{calendar_id}/appointment/{appointment_id}`. */
   appointment_id?: string;
   calendar_id?: string;
+  /** So em alertas de agenda (feat-206 F6a): o claim que gerou o alerta, gravado
+   *  quando ele nasce. As rechecagens tardias (passos 3 e 4, `closed_at + 4 h` e
+   *  `+ 24 h`) reconferem a agenda a partir DELE, porque o claim so existe em
+   *  `report.claims` da avaliacao que o extraiu e um laudo mais novo do mesmo
+   *  lead pode ter herdado o alerta. Ausente em alertas antigos: passo tardio
+   *  nao se aplica (sem backfill). */
+  appointment_claim?: ICsqAlertAppointmentClaim;
   /** Ticket em que o alerta apareceu pela primeira vez (herdado x novo). */
   first_seen_ticket_id: string;
   created_at: Date;
 }
 
+/** O que foi informado ao lead, copiado do claim `appointment_informed`
+ *  (feat-206 F6a). Sem `evidence`: a evidencia ja esta em `ICsqAlert.evidence`. */
+export interface ICsqAlertAppointmentClaim {
+  /** YYYY-MM-DD, TZ do tenant. */
+  date: string;
+  /** HH:mm. */
+  time?: string;
+  professional?: string;
+  patient_name?: string;
+  modality?: string;
+}
+
 // ───────── Indicadores (report-spec §3) ─────────
 
 /** Indicadores quantitativos calculados por codigo, por lente
@@ -478,6 +497,10 @@ export interface ICsqClaimAppointmentInformed {
   modality?: string;
   /** Nome do paciente informado na conversa (mae/filho: pode diferir do lead). */
   patient_name?: string;
+  /** feat-206 F6: o agendamento informado deixou de valer DEPOIS, na mesma
+   *  jornada (o lead cancelou/desistiu, ou foi trocado por outro horario). O
+   *  codigo nao exige registro na agenda de um claim assim. */
+  superseded?: boolean;
   evidence: ICsqEvidence[];
 }
 
@@ -560,11 +583,26 @@ export type ICsqClaim =
 
 export type CsqClaimType = ICsqClaim["type"];
 
+/** Como o agendamento da agenda foi identificado como sendo do paciente da
+ *  conversa, na ordem de forca da prova (feat-154 B1; `name_fuzzy` na feat-206
+ *  F6a: nome com grafia diferente, so no mesmo dia e hora do claim). */
+export type CsqAppointmentMatch = "linked" | "phone" | "name" | "name_fuzzy";
+
+/** Resultado do cruzamento por codigo.
+ *  - `cancelled_after` (feat-206 F6a): o agendamento EXISTIU e foi cancelado ou
+ *    excluido DEPOIS da mensagem que o informou ao lead — nao e "nao registrado". */
+export type CsqCrossCheckResult =
+  | "match"
+  | "mismatch"
+  | "missing"
+  | "inconclusive"
+  | "cancelled_after";
+
 /** Linha da tabela "o que foi dito x o que consta" (report-spec §2.5). */
 export interface ICsqCrossCheck {
   claim_type: CsqClaimType;
   /** Resultado da verificacao por codigo. */
-  result: "match" | "mismatch" | "missing" | "inconclusive";
+  result: CsqCrossCheckResult;
   /** O que foi dito (resumo do claim). */
   expected: string;
   /** O que consta no sistema. */
@@ -575,6 +613,8 @@ export interface ICsqCrossCheck {
   /** So em cruzamentos de agenda: agendamento encontrado (link no Nexus). */
   appointment_id?: string;
   calendar_id?: string;
+  /** So em cruzamentos de agenda: como o agendamento foi identificado. */
+  matched_by?: CsqAppointmentMatch;
 }
 
 // ───────── Avaliacao (report-spec §4) ─────────
@@ -714,6 +754,12 @@ export type CsqTriageReason =
   | "reopen_without_new_messages"
   | "automation_only"
   | "ack_only"
+  /** feat-206 F6b: nenhum texto livre de atendente humano nem nota; a HubIA
+   *  falou no maximo uma vez (saudacao/fora do expediente). */
+  | "no_attendant_message"
+  /** feat-206 F6b: o lead nao escreveu texto livre e todo texto da atendente
+   *  e confirmacao curta (sem data/hora, valor ou pergunta). */
+  | "attendant_ack_only"
   | "forced";
 
 export interface ICsqTriageDecision {
@@ -835,6 +881,13 @@ export interface ICsqAppointmentFact {
   professional_name?: string;
   modality?: string;
   created_at?: Date;
+  /** feat-206 F6a: agendamento que saiu da agenda — excluido (`deleted_at`) ou
+   *  cancelado (`status_base` cancelado). So vem marcado na leitura de
+   *  candidatos da agenda; o verificador nunca o trata como agendamento vivo. */
+  removed?: "deleted" | "cancelled";
+  /** Quando saiu: `deleted_at`; cancelado sem `deleted_at` usa `updated_at`.
+   *  Ausente = nao comparavel com a mensagem que informou o agendamento. */
+  removed_at?: Date;
 }
 
 /** Agendamento envolvido numa sobreposicao (lote 9). */

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

@@ -84,12 +84,16 @@ export interface INexFinopsBillingPaymentMethodSnapshot {
 }
 export type NexFinopsBillingCardChargeMode = 'subscription_adjust'
 /** Contingência A′. */
- | 'subscription_value_update' | 'token_charge';
-export type NexFinopsBillingCardChargeStatus = 'scheduled' | 'stale' | 'confirmed' | 'refused' | 'refunded' | 'chargeback' | 'canceled' | 'reverted';
+ | 'subscription_value_update' | 'token_charge'
+/** feat-253 F2b: fatura avulsa hospedada no Asaas (cartão com captura, ou cliente escolhe). */
+ | 'hosted_invoice';
+export type NexFinopsBillingCardChargeStatus = 'scheduled'
+/** Fatura enviada aguardando pagamento, ou cobrança com token em análise. */
+ | 'pending' | 'stale' | 'confirmed' | 'refused' | 'refunded' | 'chargeback' | 'canceled' | 'reverted';
 export interface INexFinopsBillingCardChargeHistoryEntry {
     at: string;
     by: string | null;
-    action: 'adjust' | 'readjust' | 'revert' | 'charge' | 'event';
+    action: 'adjust' | 'readjust' | 'revert' | 'charge' | 'event' | 'send_invoice' | 'cancel_invoice' | 'capture';
     value?: number | null;
     event?: string | null;
 }
@@ -106,6 +110,7 @@ export interface INexFinopsBillingCardCharge {
     value_after: number;
     status: NexFinopsBillingCardChargeStatus;
     raw_status?: string | null;
+    /** Mantido por compatibilidade: na F2b é o momento/autor da criação do `pay_`. */
     adjusted_at: string;
     adjusted_by: {
         kind: 'user' | 'system';
@@ -119,7 +124,21 @@ export interface INexFinopsBillingCardCharge {
     } | null;
     /** Capado em 30 entradas. */
     history: INexFinopsBillingCardChargeHistoryEntry[];
+    /** Fatura hospedada que, paga no cartão, captura o token (`billing_type: 'CREDIT_CARD'`). */
+    capture_card?: boolean | null;
+    /** `invoiceUrl` da fatura hospedada (pagável pelo cliente). */
+    invoice_url?: string | null;
+    /** `billingType` pedido ao Asaas. */
+    billing_type?: 'CREDIT_CARD' | 'UNDEFINED' | null;
+    /** Resultado da captura do token após o pagamento. */
+    capture_status?: NexFinopsBillingCardCaptureStatus | null;
+    /** Método `atok_` capturado por esta cobrança (a tela oferece usar como padrão). Interno (fora do portal). */
+    captured_payment_method_id?: string | null;
+    /** Provider/ambiente onde o `pay_` foi criado. */
+    provider_id?: string | null;
+    env?: 'sandbox' | 'production' | null;
 }
+export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';
 export interface INexFinopsBilling extends IFireGlobalDoc {
     customer_id: string;
     customer_ref?: string | null;
@@ -151,6 +170,11 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
     /** Todos os `pay_` do Asaas já associados (A e B) — chave do roteamento do webhook. Interno. */
     card_payment_ids?: string[];
     card_charge?: INexFinopsBillingCardCharge | null;
+    /** Trava curta da cobrança no cartão (`charge_now`). Interno (fora das projeções). */
+    card_charge_lock?: {
+        by: string | null;
+        until: string;
+    } | null;
 }
 /**
  * Transições permitidas de status de cobrança.

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

@@ -107,10 +107,14 @@ export type NexFinopsBillingCardChargeMode =
   | 'subscription_adjust'
   /** Contingência A′. */
   | 'subscription_value_update'
-  | 'token_charge';
+  | 'token_charge'
+  /** feat-253 F2b: fatura avulsa hospedada no Asaas (cartão com captura, ou cliente escolhe). */
+  | 'hosted_invoice';
 
 export type NexFinopsBillingCardChargeStatus =
   | 'scheduled'
+  /** Fatura enviada aguardando pagamento, ou cobrança com token em análise. */
+  | 'pending'
   | 'stale'
   | 'confirmed'
   | 'refused'
@@ -122,7 +126,7 @@ export type NexFinopsBillingCardChargeStatus =
 export interface INexFinopsBillingCardChargeHistoryEntry {
   at: string;
   by: string | null;
-  action: 'adjust' | 'readjust' | 'revert' | 'charge' | 'event';
+  action: 'adjust' | 'readjust' | 'revert' | 'charge' | 'event' | 'send_invoice' | 'cancel_invoice' | 'capture';
   value?: number | null;
   event?: string | null;
 }
@@ -140,6 +144,7 @@ export interface INexFinopsBillingCardCharge {
   value_after: number;
   status: NexFinopsBillingCardChargeStatus;
   raw_status?: string | null;
+  /** Mantido por compatibilidade: na F2b é o momento/autor da criação do `pay_`. */
   adjusted_at: string;
   adjusted_by: { kind: 'user' | 'system'; id: string | null };
   last_event?: string | null;
@@ -147,8 +152,26 @@ export interface INexFinopsBillingCardCharge {
   failure?: { event: string; description?: string | null } | null;
   /** Capado em 30 entradas. */
   history: INexFinopsBillingCardChargeHistoryEntry[];
+
+  // ── F2b (fatura hospedada / token) ──
+
+  /** Fatura hospedada que, paga no cartão, captura o token (`billing_type: 'CREDIT_CARD'`). */
+  capture_card?: boolean | null;
+  /** `invoiceUrl` da fatura hospedada (pagável pelo cliente). */
+  invoice_url?: string | null;
+  /** `billingType` pedido ao Asaas. */
+  billing_type?: 'CREDIT_CARD' | 'UNDEFINED' | null;
+  /** Resultado da captura do token após o pagamento. */
+  capture_status?: NexFinopsBillingCardCaptureStatus | null;
+  /** Método `atok_` capturado por esta cobrança (a tela oferece usar como padrão). Interno (fora do portal). */
+  captured_payment_method_id?: string | null;
+  /** Provider/ambiente onde o `pay_` foi criado. */
+  provider_id?: string | null;
+  env?: 'sandbox' | 'production' | null;
 }
 
+export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';
+
 // ── Main Document ──
 
 export interface INexFinopsBilling extends IFireGlobalDoc {
@@ -214,6 +237,8 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
   /** Todos os `pay_` do Asaas já associados (A e B) — chave do roteamento do webhook. Interno. */
   card_payment_ids?: string[];
   card_charge?: INexFinopsBillingCardCharge | null;
+  /** Trava curta da cobrança no cartão (`charge_now`). Interno (fora das projeções). */
+  card_charge_lock?: { by: string | null; until: string } | null;
 }
 
 // ── Status transitions ──

package/dist/types/evo-finops/common/payment-method.d.ts

@@ -70,6 +70,8 @@ export interface INexFinopsCustomerPaymentMethod extends IFireGlobalDoc {
     last_synced_at?: string | null;
     last_used_at?: string | null;
     last_charge?: INexFinopsPaymentMethodLastCharge | null;
+    /** feat-253 F2b: `asub_` migrado aponta para o `atok_` que o substituiu. */
+    replaced_by_payment_method_id?: string | null;
 }
 /** Prefixos determinísticos dos ids (idempotência da descoberta). */
 export declare const NEX_FINOPS_PAYMENT_METHOD_ID_PREFIX: Record<NexFinopsPaymentMethodKind, string>;

package/dist/types/evo-finops/common/payment-method.ts

@@ -94,6 +94,8 @@ export interface INexFinopsCustomerPaymentMethod extends IFireGlobalDoc {
   last_synced_at?: string | null;
   last_used_at?: string | null;
   last_charge?: INexFinopsPaymentMethodLastCharge | null;
+  /** feat-253 F2b: `asub_` migrado aponta para o `atok_` que o substituiu. */
+  replaced_by_payment_method_id?: string | null;
 }
 
 /** Prefixos determinísticos dos ids (idempotência da descoberta). */

package/dist/types/evo-finops/providers/asaas/asaas_provider.d.ts

@@ -156,6 +156,13 @@ export interface IAsaasEnvAuthConfig {
     operational?: {
         rate_limit_max_per_minute?: number;
     };
+    /**
+     * feat-253 (caminho B) — cobrança com `creditCardToken`. `remote_ip` é o IP enviado ao Asaas
+     * quando a credencial não guardou o IP do pagador. Ausente nos dois → a cobrança falha fechada.
+     */
+    card_token?: {
+        remote_ip?: string | null;
+    };
 }
 export interface IAsaasNfseCapabilities {
     enabled: boolean;
@@ -170,10 +177,17 @@ export interface IAsaasEnvFlag {
 }
 export interface IAsaasPaymentsCapabilities {
     enabled: boolean;
-    /** feat-253 — kill-switch do caminho A (ajuste do valor da cobrança pendente da assinatura). */
+    /**
+     * feat-253 — kill-switch do caminho A (ajuste do valor da cobrança pendente da assinatura).
+     * @deprecated O caminho A saiu do modelo (o Asaas trava valor/vencimento após a 1ª fatura paga). Não usar.
+     */
     card_subscription_adjust?: IAsaasEnvFlag;
-    /** feat-253 — flag do caminho B (cobrança com `creditCardToken`). Desligado até o Asaas habilitar. */
+    /** feat-253 — flag do caminho B (captura do token + cobrança com `creditCardToken`). Desligado até o Asaas habilitar. */
     card_token?: IAsaasEnvFlag;
+    /** feat-253 — fatura hospedada do Asaas gerada pelo Nexus para a cobrança (contingência C e entrada da captura). */
+    hosted_invoice?: IAsaasEnvFlag;
+    /** feat-253 — job diário que cobra no cartão salvo no vencimento (fatia 8). */
+    card_token_auto?: IAsaasEnvFlag;
 }
 export interface IAsaasProviderCapabilities {
     nfse: IAsaasNfseCapabilities;

package/dist/types/evo-finops/providers/asaas/asaas_provider.ts

@@ -225,6 +225,14 @@ export interface IAsaasEnvAuthConfig {
   operational?: {
     rate_limit_max_per_minute?: number;
   };
+
+  /**
+   * feat-253 (caminho B) — cobrança com `creditCardToken`. `remote_ip` é o IP enviado ao Asaas
+   * quando a credencial não guardou o IP do pagador. Ausente nos dois → a cobrança falha fechada.
+   */
+  card_token?: {
+    remote_ip?: string | null;
+  };
 }
 
 export interface IAsaasNfseCapabilities {
@@ -245,10 +253,17 @@ export interface IAsaasEnvFlag {
 
 export interface IAsaasPaymentsCapabilities {
   enabled: boolean; // false for now, future for payment links/subscriptions
-  /** feat-253 — kill-switch do caminho A (ajuste do valor da cobrança pendente da assinatura). */
+  /**
+   * feat-253 — kill-switch do caminho A (ajuste do valor da cobrança pendente da assinatura).
+   * @deprecated O caminho A saiu do modelo (o Asaas trava valor/vencimento após a 1ª fatura paga). Não usar.
+   */
   card_subscription_adjust?: IAsaasEnvFlag;
-  /** feat-253 — flag do caminho B (cobrança com `creditCardToken`). Desligado até o Asaas habilitar. */
+  /** feat-253 — flag do caminho B (captura do token + cobrança com `creditCardToken`). Desligado até o Asaas habilitar. */
   card_token?: IAsaasEnvFlag;
+  /** feat-253 — fatura hospedada do Asaas gerada pelo Nexus para a cobrança (contingência C e entrada da captura). */
+  hosted_invoice?: IAsaasEnvFlag;
+  /** feat-253 — job diário que cobra no cartão salvo no vencimento (fatia 8). */
+  card_token_auto?: IAsaasEnvFlag;
 }
 
 export interface IAsaasProviderCapabilities {

package/package.json

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