evo360-types 1.3.644 → 1.3.647

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-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.647",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",