evo360-types 1.3.520 → 1.3.524

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

@@ -12533,6 +12533,7 @@ export declare const zServiceInvoiceSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 export declare const zNexFinopsProposalStatusSchema: z.ZodEnum<["draft", "sent", "viewed", "accepted", "expired", "canceled"]>;
 export declare const zNexFinopsProposalPaymentMethodSchema: z.ZodEnum<["boleto", "card_subscription", "payment_link"]>;
+export declare const zNexFinopsProposalLoyaltyPeriodSchema: z.ZodEnum<["none", "3m", "6m", "1y", "2y"]>;
 export declare const zNexFinopsProposalPrefillSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -12581,6 +12582,9 @@ export declare const zNexFinopsProposalWriteSchema: z.ZodObject<{
     base_amount: z.ZodOptional<z.ZodNumber>;
     due_day: z.ZodOptional<z.ZodNumber>;
     accepted_payment_methods: z.ZodOptional<z.ZodArray<z.ZodEnum<["boleto", "card_subscription", "payment_link"]>, "many">>;
+    loyalty_period: z.ZodNullable<z.ZodOptional<z.ZodEnum<["none", "3m", "6m", "1y", "2y"]>>>;
+    /** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
+    contract_template_key: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     terms: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     valid_until: z.ZodOptional<z.ZodString>;
     notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -12601,6 +12605,8 @@ export declare const zNexFinopsProposalWriteSchema: z.ZodObject<{
     html_content?: string | undefined;
     base_amount?: number | undefined;
     terms?: string | null | undefined;
+    loyalty_period?: "none" | "3m" | "6m" | "1y" | "2y" | null | undefined;
+    contract_template_key?: string | null | undefined;
     valid_until?: string | undefined;
 }, {
     name?: string | null | undefined;
@@ -12619,6 +12625,8 @@ export declare const zNexFinopsProposalWriteSchema: z.ZodObject<{
     html_content?: string | undefined;
     base_amount?: number | undefined;
     terms?: string | null | undefined;
+    loyalty_period?: "none" | "3m" | "6m" | "1y" | "2y" | null | undefined;
+    contract_template_key?: string | null | undefined;
     valid_until?: string | undefined;
 }>;
 export declare const zNexFinopsProposalSchema: z.ZodObject<{
@@ -12646,6 +12654,9 @@ export declare const zNexFinopsProposalSchema: z.ZodObject<{
     base_amount: z.ZodOptional<z.ZodNumber>;
     due_day: z.ZodOptional<z.ZodNumber>;
     accepted_payment_methods: z.ZodOptional<z.ZodArray<z.ZodEnum<["boleto", "card_subscription", "payment_link"]>, "many">>;
+    loyalty_period: z.ZodNullable<z.ZodOptional<z.ZodEnum<["none", "3m", "6m", "1y", "2y"]>>>;
+    /** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
+    contract_template_key: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     terms: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     valid_until: z.ZodOptional<z.ZodString>;
     notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -12673,6 +12684,8 @@ export declare const zNexFinopsProposalSchema: z.ZodObject<{
     html_content?: string | undefined;
     base_amount?: number | undefined;
     terms?: string | null | undefined;
+    loyalty_period?: "none" | "3m" | "6m" | "1y" | "2y" | null | undefined;
+    contract_template_key?: string | null | undefined;
     valid_until?: string | undefined;
 }, {
     currency: "BRL";
@@ -12694,6 +12707,8 @@ export declare const zNexFinopsProposalSchema: z.ZodObject<{
     html_content?: string | undefined;
     base_amount?: number | undefined;
     terms?: string | null | undefined;
+    loyalty_period?: "none" | "3m" | "6m" | "1y" | "2y" | null | undefined;
+    contract_template_key?: string | null | undefined;
     valid_until?: string | undefined;
 }>;
 export declare const zNexFinopsPaymentMethodSchema: z.ZodEnum<["pix", "boleto", "payment_link", "card_subscription"]>;

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.zProviderInvoiceLinksSchema = exports.zServiceTaxInfoSchema = exports.zServiceLineItemSchema = exports.zServiceInvoiceStateSchema = exports.zProviderServiceInvoiceStatusSchema = exports.zExternalLinkSchema = exports.zExternalObjectTypeSchema = exports.zInvoiceSourceRefSchema = exports.zInvoiceSourceTypeSchema = exports.zInvoiceTakerRefSchema = exports.zInvoiceTakerSnapshotSchema = exports.zInvoiceTakerSnapshotAddressSchema = exports.zTakerDocumentSchema = exports.zTakerTaxProfileSchema = exports.zTakerProviderRefsSchema = exports.zTakerAddressSchema = exports.zInvoiceTakerTypeSchema = exports.zServiceSchema = exports.zCustomerServiceTaxInfoSchema = exports.zIssuerTaxProfileSchema = exports.zIssuerNfseConfigSchema = exports.zIssuerMunicipalCredentialsRefSchema = exports.zIssuerTaxRegimeSchema = exports.zIssuerCompanyIdentitySchema = exports.zIssuerCompanyAddressSchema = exports.zTaxProfileSyncStateSchema = exports.zAsaasProviderSchema = exports.zAsaasProviderAsaasBlockSchema = exports.zAsaasProviderCapabilitiesSchema = exports.zAsaasPaymentsCapabilitiesSchema = exports.zAsaasNfseCapabilitiesSchema = exports.zAsaasEnvAuthConfigSchema = exports.zAsaasSubaccountInputSchema = exports.zAsaasAccountScopeSchema = exports.zAsaasWebhookConfigSchema = exports.zRetryPolicySchema = exports.zAsaasWebhookEventSchema = exports.zAsaasAccountScopeModeSchema = exports.zProviderRemoteRefsSchema = exports.zProviderFiscalInfoPayloadSchema = exports.zProviderCredentialsInputSchema = exports.zProviderCredentialsSecretRefsSchema = exports.zProviderMunicipalOptionsSnapshotSchema = exports.zProviderOptionItemSchema = exports.zProviderMunicipalAuthTypeSchema = exports.zFinopsProviderBaseSchema = exports.zProviderStatusSchema = exports.zFinopsActionSchema = exports.zFinopsProviderTypeSchema = exports.zProviderEnvSchema = void 0;
-exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = void 0;
+exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalLoyaltyPeriodSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 // ---- Provider enums and base ----
@@ -693,6 +693,13 @@ exports.zNexFinopsProposalPaymentMethodSchema = zod_1.z.enum([
     "card_subscription",
     "payment_link",
 ]);
+exports.zNexFinopsProposalLoyaltyPeriodSchema = zod_1.z.enum([
+    "none",
+    "3m",
+    "6m",
+    "1y",
+    "2y",
+]);
 exports.zNexFinopsProposalPrefillSchema = zod_1.z
     .object({
     name: zod_1.z.string().max(255).nullable().optional(),
@@ -719,6 +726,9 @@ exports.zNexFinopsProposalWriteSchema = zod_1.z
     base_amount: zod_1.z.number().nonnegative().optional(),
     due_day: zod_1.z.number().int().min(1).max(31).optional(),
     accepted_payment_methods: zod_1.z.array(exports.zNexFinopsProposalPaymentMethodSchema).optional(),
+    loyalty_period: exports.zNexFinopsProposalLoyaltyPeriodSchema.optional().nullable(),
+    /** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
+    contract_template_key: zod_1.z.string().max(64).optional().nullable(),
     terms: zod_1.z.string().nullable().optional(),
     valid_until: zod_1.z
         .string()

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

@@ -757,6 +757,14 @@ export const zNexFinopsProposalPaymentMethodSchema = z.enum([
   "payment_link",
 ]);
 
+export const zNexFinopsProposalLoyaltyPeriodSchema = z.enum([
+  "none",
+  "3m",
+  "6m",
+  "1y",
+  "2y",
+]);
+
 export const zNexFinopsProposalPrefillSchema = z
   .object({
     name: z.string().max(255).nullable().optional(),
@@ -784,6 +792,9 @@ export const zNexFinopsProposalWriteSchema = z
     base_amount: z.number().nonnegative().optional(),
     due_day: z.number().int().min(1).max(31).optional(),
     accepted_payment_methods: z.array(zNexFinopsProposalPaymentMethodSchema).optional(),
+    loyalty_period: zNexFinopsProposalLoyaltyPeriodSchema.optional().nullable(),
+    /** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
+    contract_template_key: z.string().max(64).optional().nullable(),
     terms: z.string().nullable().optional(),
     valid_until: z
       .string()

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

@@ -16,6 +16,17 @@ export type NexFinopsProposalOrigem = 'vendas' | 'site-hm' | (string & {});
  * não oferece pix avulso; os dois conjuntos divergem de propósito.
  */
 export type NexFinopsProposalPaymentMethod = 'boleto' | 'card_subscription' | 'payment_link';
+/**
+ * Prazo de fidelidade da proposta (cláusula 6.1 do contrato). União fechada, e
+ * não número de meses, porque o contrato exige o prazo por extenso ("1 (um)
+ * ano", não "12 meses") — o texto é parte da cláusula, então o conjunto de
+ * valores aceitos é o conjunto de textos que existem.
+ *
+ * O rótulo por extenso NÃO mora aqui: quem renderiza é o backend
+ * (`LOYALTY_PERIOD_LABELS`, em `@evo/nex-model`), e a projeção pública já entrega
+ * o texto pronto em `loyalty_period_label`.
+ */
+export type NexFinopsProposalLoyaltyPeriod = 'none' | '3m' | '6m' | '1y' | '2y';
 /** Dados que o vendedor já conhece e a página pública usa para pré-preencher. */
 export interface INexFinopsProposalPrefill {
     name?: string | null;
@@ -40,6 +51,20 @@ export interface INexFinopsProposal extends IFireGlobalDoc {
     accepted_payment_methods: NexFinopsProposalPaymentMethod[];
     terms?: string | null;
     currency: 'BRL';
+    /**
+     * Fidelidade contratada. Ausente é lido como `'none'` — propostas anteriores à
+     * feat-140 não têm o campo e não têm fidelidade.
+     */
+    loyalty_period?: NexFinopsProposalLoyaltyPeriod | null;
+    /**
+     * Modelo de contrato escolhido pelo vendedor, por CHAVE.
+     *
+     * Chave e não identificador do provider de assinatura: o identificador é
+     * configuração de ambiente (muda entre sandbox e produção) e congelá-lo num
+     * documento do Firestore o deixaria apontando para um template que já não
+     * existe. Ausente é o legado anterior à feat-140 — envelope no modelo único.
+     */
+    contract_template_key?: string | null;
     valid_until: string;
     sent_at?: Date | null;
     viewed_at?: Date | null;
@@ -56,6 +81,15 @@ export interface INexFinopsProposalPublic {
     accepted_payment_methods: NexFinopsProposalPaymentMethod[];
     terms: string | null;
     valid_until: string;
+    /**
+     * Fidelidade já por extenso ("3 (três) meses"), ou `null` quando não há.
+     * Vem pronta de propósito: é condição comercial que o lead precisa ler antes
+     * de aceitar, e o mapa de rótulos não deve existir em dois lugares.
+     *
+     * `contract_template_key` NÃO tem par público: qual modelo de contrato o
+     * envelope usa é decisão interna.
+     */
+    loyalty_period_label?: string | null;
     /** Só nome de exibição — nunca e-mail, telefone ou documento completos. */
     prefill_masked: {
         name: string | null;

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

@@ -28,6 +28,18 @@ export type NexFinopsProposalOrigem = 'vendas' | 'site-hm' | (string & {});
  */
 export type NexFinopsProposalPaymentMethod = 'boleto' | 'card_subscription' | 'payment_link';
 
+/**
+ * Prazo de fidelidade da proposta (cláusula 6.1 do contrato). União fechada, e
+ * não número de meses, porque o contrato exige o prazo por extenso ("1 (um)
+ * ano", não "12 meses") — o texto é parte da cláusula, então o conjunto de
+ * valores aceitos é o conjunto de textos que existem.
+ *
+ * O rótulo por extenso NÃO mora aqui: quem renderiza é o backend
+ * (`LOYALTY_PERIOD_LABELS`, em `@evo/nex-model`), e a projeção pública já entrega
+ * o texto pronto em `loyalty_period_label`.
+ */
+export type NexFinopsProposalLoyaltyPeriod = 'none' | '3m' | '6m' | '1y' | '2y';
+
 // ── Prefill do cliente ──
 
 /** Dados que o vendedor já conhece e a página pública usa para pré-preencher. */
@@ -67,6 +79,21 @@ export interface INexFinopsProposal extends IFireGlobalDoc {
   terms?: string | null;
   currency: 'BRL';
 
+  /**
+   * Fidelidade contratada. Ausente é lido como `'none'` — propostas anteriores à
+   * feat-140 não têm o campo e não têm fidelidade.
+   */
+  loyalty_period?: NexFinopsProposalLoyaltyPeriod | null;
+  /**
+   * Modelo de contrato escolhido pelo vendedor, por CHAVE.
+   *
+   * Chave e não identificador do provider de assinatura: o identificador é
+   * configuração de ambiente (muda entre sandbox e produção) e congelá-lo num
+   * documento do Firestore o deixaria apontando para um template que já não
+   * existe. Ausente é o legado anterior à feat-140 — envelope no modelo único.
+   */
+  contract_template_key?: string | null;
+
   // Validade — data ISO `YYYY-MM-DD`, igual a `starts_at`/`ends_at` do contrato
   valid_until: string;
 
@@ -90,6 +117,15 @@ export interface INexFinopsProposalPublic {
   accepted_payment_methods: NexFinopsProposalPaymentMethod[];
   terms: string | null;
   valid_until: string;
+  /**
+   * Fidelidade já por extenso ("3 (três) meses"), ou `null` quando não há.
+   * Vem pronta de propósito: é condição comercial que o lead precisa ler antes
+   * de aceitar, e o mapa de rótulos não deve existir em dois lugares.
+   *
+   * `contract_template_key` NÃO tem par público: qual modelo de contrato o
+   * envelope usa é decisão interna.
+   */
+  loyalty_period_label?: string | null;
   /** Só nome de exibição — nunca e-mail, telefone ou documento completos. */
   prefill_masked: { name: string | null };
 }

package/package.json

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