evo360-types 1.3.782 → 1.3.787

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/dist/apps/evo-chat/forward/zod-schemas.d.ts +4 -4
  2. package/dist/apps/evo-chat/thread-message/zod-schemas.d.ts +36 -0
  3. package/dist/apps/evo-chat/thread-message/zod-schemas.js +3 -0
  4. package/dist/apps/evo-chat/thread-message/zod-schemas.ts +3 -0
  5. package/dist/apps/evo-finops/zod-schemas.d.ts +794 -32
  6. package/dist/apps/evo-finops/zod-schemas.js +187 -2
  7. package/dist/apps/evo-finops/zod-schemas.ts +205 -0
  8. package/dist/types/evo-chat/thread-message/index.d.ts +8 -0
  9. package/dist/types/evo-chat/thread-message/index.ts +8 -0
  10. package/dist/types/evo-finops/common/contract.d.ts +29 -1
  11. package/dist/types/evo-finops/common/contract.js +7 -0
  12. package/dist/types/evo-finops/common/contract.ts +31 -1
  13. package/dist/types/evo-finops/common/price-table.d.ts +89 -0
  14. package/dist/types/evo-finops/common/price-table.js +88 -0
  15. package/dist/types/evo-finops/common/price-table.ts +183 -0
  16. package/dist/types/evo-finops/common/proposal.d.ts +25 -0
  17. package/dist/types/evo-finops/common/proposal.ts +28 -0
  18. package/dist/types/evo-finops/index.d.ts +1 -0
  19. package/dist/types/evo-finops/index.js +1 -0
  20. package/dist/types/evo-finops/index.ts +1 -0
  21. package/dist/types/evo-reports/index.d.ts +9 -0
  22. package/dist/types/evo-reports/index.ts +9 -0
  23. package/dist/types/nex-vendas/adhesion.d.ts +253 -0
  24. package/dist/types/nex-vendas/adhesion.js +15 -0
  25. package/dist/types/nex-vendas/adhesion.ts +280 -0
  26. package/dist/types/nex-vendas/index.d.ts +3 -0
  27. package/dist/types/nex-vendas/index.js +3 -0
  28. package/dist/types/nex-vendas/index.ts +3 -0
  29. package/dist/types/nex-vendas/journey.d.ts +82 -4
  30. package/dist/types/nex-vendas/journey.ts +86 -3
  31. package/dist/types/nex-vendas/notifications.d.ts +14 -0
  32. package/dist/types/nex-vendas/notifications.js +21 -0
  33. package/dist/types/nex-vendas/notifications.ts +21 -0
  34. package/dist/types/nex-vendas/offer.d.ts +129 -0
  35. package/dist/types/nex-vendas/offer.js +10 -0
  36. package/dist/types/nex-vendas/offer.ts +154 -0
  37. package/package.json +1 -1
@@ -1,8 +1,8 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  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.zAsaasEnvFlagSchema = 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;
4
- exports.zNfseFeeReimbursementCompetenciaSchema = exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zNexFinopsBillingCardChargeSweepSchema = exports.zEvoBillingPortalCardCaptureSchema = exports.zNexFinopsBillingCardChargeSchema = exports.zNexFinopsContractPaymentMethodsWriteSchema = exports.zNexFinopsPaymentMethodPatchSchema = exports.zNexFinopsPaymentMethodStatusSchema = exports.zNexFinopsPaymentMethodKindSchema = exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = 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.zServiceInvoiceReplacedBySchema = exports.zServiceInvoiceReissuedFromSchema = exports.zServiceInvoiceReissueSchema = exports.zNfseReissueStageSchema = exports.zNfseReissueFieldSchema = exports.zNfseReissueStatusSchema = exports.zServiceInvoiceCancellationSchema = exports.zNfseCancellationStatusSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
5
- exports.zNfseFeeReimbursementExecuteSchema = void 0;
4
+ exports.zNexFinopsPaymentMethodStatusSchema = exports.zNexFinopsPaymentMethodKindSchema = exports.zNexFinopsPriceTableWriteSchema = exports.zNexFinopsPriceLinesSchema = exports.zNexFinopsPriceLineSchema = exports.zNexFinopsPriceCapSchema = exports.zNexFinopsPriceCapTierSchema = exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = 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.zNexVendasContractTypeSchema = exports.zNexVendasAttributionSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zServiceInvoiceReplacedBySchema = exports.zServiceInvoiceReissuedFromSchema = exports.zServiceInvoiceReissueSchema = exports.zNfseReissueStageSchema = exports.zNfseReissueFieldSchema = exports.zNfseReissueStatusSchema = exports.zServiceInvoiceCancellationSchema = exports.zNfseCancellationStatusSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
5
+ exports.zNexVendasOfferStartRequestSchema = exports.zNexVendasOfferWriteSchema = exports.zNexVendasAdhesionConfigWriteSchema = exports.zNexVendasContractTemplateAdhesionSchema = exports.zNexVendasAcceptanceRequestSchema = exports.zNfseFeeReimbursementExecuteSchema = exports.zNfseFeeReimbursementCompetenciaSchema = exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zNexFinopsBillingCardChargeSweepSchema = exports.zEvoBillingPortalCardCaptureSchema = exports.zNexFinopsBillingCardChargeSchema = exports.zNexFinopsContractPaymentMethodsWriteSchema = exports.zNexFinopsPaymentMethodPatchSchema = void 0;
6
6
  const zod_1 = require("zod");
7
7
  const zod_schemas_1 = require("../shared/zod-schemas");
8
8
  // ---- Provider enums and base ----
@@ -822,6 +822,22 @@ exports.zNexFinopsProposalStatusSchema = zod_1.z.enum([
822
822
  "expired",
823
823
  "canceled",
824
824
  ]);
825
+ /** feat-326 — atribuição de marketing do `start` (`INexVendasAttribution`). */
826
+ exports.zNexVendasAttributionSchema = zod_1.z
827
+ .object({
828
+ utm_source: zod_1.z.string().max(255).optional().nullable(),
829
+ utm_medium: zod_1.z.string().max(255).optional().nullable(),
830
+ utm_campaign: zod_1.z.string().max(255).optional().nullable(),
831
+ utm_term: zod_1.z.string().max(255).optional().nullable(),
832
+ utm_content: zod_1.z.string().max(255).optional().nullable(),
833
+ gclid: zod_1.z.string().max(255).optional().nullable(),
834
+ referrer: zod_1.z.string().max(2048).optional().nullable(),
835
+ site: zod_1.z.string().max(64).optional().nullable(),
836
+ landing_path: zod_1.z.string().max(512).optional().nullable(),
837
+ })
838
+ .strip();
839
+ /** feat-325 — tipo de formalização do contrato (`NexVendasContractType`). */
840
+ exports.zNexVendasContractTypeSchema = zod_1.z.enum(["assinatura_eletronica", "adesao"]);
825
841
  exports.zNexFinopsProposalPaymentMethodSchema = zod_1.z.enum([
826
842
  "boleto",
827
843
  "card_subscription",
@@ -874,6 +890,17 @@ exports.zNexFinopsProposalWriteSchema = zod_1.z
874
890
  loyalty_period: exports.zNexFinopsProposalLoyaltyPeriodSchema.optional().nullable(),
875
891
  /** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
876
892
  contract_template_key: zod_1.z.string().max(64).optional().nullable(),
893
+ /**
894
+ * feat-325 — derivado no backend do modelo escolhido (o valor do cliente HTTP é
895
+ * sobrescrito). Está no schema para o backend não perder o campo no `.strip()`.
896
+ */
897
+ contract_type: exports.zNexVendasContractTypeSchema.optional().nullable(),
898
+ /** feat-326 — preenchidos pelo `start` da oferta; no CRUD do vendedor ficam ausentes. */
899
+ offer_slug: zod_1.z.string().max(64).optional().nullable(),
900
+ attribution: exports.zNexVendasAttributionSchema.optional().nullable(),
901
+ client_request_id: zod_1.z.string().max(64).optional().nullable(),
902
+ /** Resolvido no servidor (uid do token ou `system:offer`); o valor do cliente é sobrescrito. */
903
+ created_by: zod_1.z.string().max(128).optional().nullable(),
877
904
  terms: zod_1.z.string().nullable().optional(),
878
905
  valid_until: zod_1.z
879
906
  .string()
@@ -1047,6 +1074,70 @@ exports.zNexFinopsContractAllowancesWriteSchema = zod_1.z
1047
1074
  alert_thresholds: zod_1.z.array(exports.zNexFinopsAlertThresholdSchema).optional().nullable(),
1048
1075
  /** feat-264 D4 — ausente/null = TRUE (reembolsa). */
1049
1076
  nfse_fee_reimbursement: zod_1.z.boolean().optional().nullable(),
1077
+ /** feat-328 — tabela de preço do contrato. Ausente/null = tabela padrão. */
1078
+ price_table_id: zod_1.z.string().min(1).nullable().optional(),
1079
+ })
1080
+ .strip();
1081
+ // ---- Nexus FinOps — tabelas de preço (feat-328) ----
1082
+ //
1083
+ // A tabela só tem preço (Q1). Herança por linha: chave ausente = herda;
1084
+ // `kind: 'disabled'` anula a herdada. Regras que dependem das OUTRAS tabelas
1085
+ // (exatamente uma padrão, mãe viva, sem ciclo, padrão sem `disabled`) ficam no
1086
+ // use case do backend — aqui só a forma do documento.
1087
+ const zNexFinopsPriceAmountSchema = zod_1.z.number().finite().gte(0);
1088
+ exports.zNexFinopsPriceCapTierSchema = zod_1.z
1089
+ .object({
1090
+ up_to: zod_1.z.number().int().gt(0),
1091
+ total: zNexFinopsPriceAmountSchema,
1092
+ })
1093
+ .strip();
1094
+ exports.zNexFinopsPriceCapSchema = zod_1.z
1095
+ .object({
1096
+ mode: zod_1.z.literal("tiered_total"),
1097
+ tiers: zod_1.z
1098
+ .array(exports.zNexFinopsPriceCapTierSchema)
1099
+ .min(1)
1100
+ .superRefine((tiers, ctx) => {
1101
+ for (let i = 1; i < tiers.length; i++) {
1102
+ if (tiers[i].up_to <= tiers[i - 1].up_to) {
1103
+ ctx.addIssue({
1104
+ code: zod_1.z.ZodIssueCode.custom,
1105
+ path: [i, "up_to"],
1106
+ message: "tiers.up_to must be strictly increasing",
1107
+ });
1108
+ }
1109
+ }
1110
+ }),
1111
+ })
1112
+ .strip();
1113
+ exports.zNexFinopsPriceLineSchema = zod_1.z.discriminatedUnion("kind", [
1114
+ zod_1.z
1115
+ .object({
1116
+ kind: zod_1.z.literal("usage"),
1117
+ unit_price: zNexFinopsPriceAmountSchema,
1118
+ service_category: zod_1.z.string().min(1),
1119
+ cap: exports.zNexFinopsPriceCapSchema.nullable().optional(),
1120
+ })
1121
+ .strip(),
1122
+ zod_1.z
1123
+ .object({
1124
+ kind: zod_1.z.literal("recurring"),
1125
+ amount: zNexFinopsPriceAmountSchema,
1126
+ service_category: zod_1.z.string().min(1),
1127
+ })
1128
+ .strip(),
1129
+ zod_1.z.object({ kind: zod_1.z.literal("disabled") }).strip(),
1130
+ ]);
1131
+ /** Chave = métrica (usage) ou módulo (recurring); mesmo limite das chaves de `allowances`. */
1132
+ exports.zNexFinopsPriceLinesSchema = zod_1.z.record(zod_1.z.string().min(1).max(64), exports.zNexFinopsPriceLineSchema);
1133
+ /** Create/update de tabela de preço. `lines` substitui o mapa inteiro (como `allowances`). */
1134
+ exports.zNexFinopsPriceTableWriteSchema = zod_1.z
1135
+ .object({
1136
+ name: zod_1.z.string().trim().min(1).max(120),
1137
+ is_default: zod_1.z.boolean(),
1138
+ inherits_from: zod_1.z.string().min(1).nullable().optional(),
1139
+ lines: exports.zNexFinopsPriceLinesSchema,
1140
+ notes: zod_1.z.string().nullable().optional(),
1050
1141
  })
1051
1142
  .strip();
1052
1143
  // ---- Nexus FinOps — métodos de pagamento do cliente (feat-253) ----
@@ -1157,3 +1248,97 @@ exports.zNfseFeeReimbursementExecuteSchema = zod_1.z
1157
1248
  }),
1158
1249
  })
1159
1250
  .strict();
1251
+ // ---- Nexus Vendas — contrato por adesão (feat-325) ----
1252
+ const zSha256HexSchema = zod_1.z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64 lowercase hex chars");
1253
+ /**
1254
+ * Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
1255
+ * idioma e trace vêm da requisição, nunca do corpo.
1256
+ */
1257
+ exports.zNexVendasAcceptanceRequestSchema = zod_1.z
1258
+ .object({
1259
+ cg_sha256: zSha256HexSchema,
1260
+ summary_sha256: zSha256HexSchema,
1261
+ declaration_version: zod_1.z.string().min(1).max(64),
1262
+ viewed_to_end: zod_1.z.boolean(),
1263
+ client_request_id: zod_1.z.string().min(8).max(64),
1264
+ })
1265
+ .strip();
1266
+ /** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
1267
+ exports.zNexVendasContractTemplateAdhesionSchema = zod_1.z
1268
+ .object({
1269
+ cg: zod_1.z
1270
+ .object({
1271
+ version: zod_1.z.string().min(1).max(64),
1272
+ sha256: zSha256HexSchema,
1273
+ storage_path: zod_1.z.string().min(1).max(512),
1274
+ effective_from: zod_1.z
1275
+ .string()
1276
+ .regex(/^\d{4}-\d{2}-\d{2}$/, "effective_from must be an ISO date (YYYY-MM-DD)"),
1277
+ filename: zod_1.z.string().min(1).max(255),
1278
+ })
1279
+ .strip(),
1280
+ require_email_otp: zod_1.z.boolean().optional().nullable(),
1281
+ })
1282
+ .strip();
1283
+ /** Doc `core/nexus/apps/nex-vendas/config/adhesion` (escrita pelo Nexus). */
1284
+ exports.zNexVendasAdhesionConfigWriteSchema = zod_1.z
1285
+ .object({
1286
+ declaration: zod_1.z
1287
+ .object({
1288
+ version: zod_1.z.string().min(1).max(64),
1289
+ text: zod_1.z.string().min(1).max(4000),
1290
+ })
1291
+ .strip(),
1292
+ document_access_days: zod_1.z.number().int().min(1).max(3650).optional().nullable(),
1293
+ corrections_per_hour: zod_1.z.number().int().min(1).max(100).optional().nullable(),
1294
+ })
1295
+ .strip();
1296
+ // ---- Nexus Vendas — ofertas self-service (feat-326) ----
1297
+ /**
1298
+ * Escrita da oferta `core/nexus/apps/nex-vendas/offers/{slug}` (Nexus → `nex_finops`).
1299
+ * Cobre TODOS os campos de `INexVendasOffer`: o que fica fora do `.strip()` some em
1300
+ * silêncio. `contract_type`, `created_by` e `start_count` são resolvidos no servidor
1301
+ * (o valor do cliente é sobrescrito) e estão aqui para o backend não perdê-los.
1302
+ * Regras de negócio (v1 só `card_subscription`, modelo ativo) ficam no use case.
1303
+ */
1304
+ exports.zNexVendasOfferWriteSchema = zod_1.z
1305
+ .object({
1306
+ slug: zod_1.z
1307
+ .string()
1308
+ .min(2)
1309
+ .max(64)
1310
+ .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "slug must be kebab-case [a-z0-9-]"),
1311
+ name: zod_1.z.string().min(1).max(255),
1312
+ headline: zod_1.z.string().min(1).max(255),
1313
+ description: zod_1.z.string().max(4000).optional().nullable(),
1314
+ html_content: zod_1.z.string().optional().nullable(),
1315
+ base_amount: zod_1.z.number().nonnegative(),
1316
+ due_day: zod_1.z.number().int().min(1).max(31),
1317
+ accepted_payment_methods: zod_1.z.array(exports.zNexFinopsProposalPaymentMethodSchema).min(1),
1318
+ loyalty_period: exports.zNexFinopsProposalLoyaltyPeriodSchema,
1319
+ contract_template_key: zod_1.z.string().min(1).max(64),
1320
+ contract_type: exports.zNexVendasContractTypeSchema.optional().nullable(),
1321
+ allowances: exports.zNexFinopsContractAllowancesSchema.nullable(),
1322
+ terms: zod_1.z.string().optional().nullable(),
1323
+ proposal_valid_days: zod_1.z.number().int().min(1).max(90),
1324
+ site: zod_1.z.string().min(1).max(64),
1325
+ origem: zod_1.z.string().min(1).max(64).optional().nullable(),
1326
+ active: zod_1.z.boolean(),
1327
+ listed: zod_1.z.boolean(),
1328
+ created_by: zod_1.z.string().max(128).optional(),
1329
+ start_count: zod_1.z.number().int().nonnegative().optional().nullable(),
1330
+ last_start_at: zod_schemas_1.zFirestoreDateSchema.optional().nullable(),
1331
+ })
1332
+ .strip();
1333
+ /** Corpo de `POST /offers/:slug/start` (público). */
1334
+ exports.zNexVendasOfferStartRequestSchema = zod_1.z
1335
+ .object({
1336
+ name: zod_1.z.string().trim().min(2).max(255),
1337
+ email: zod_1.z.string().trim().email().max(255),
1338
+ phone: zod_1.z.string().trim().min(8).max(32),
1339
+ client_request_id: zod_1.z.string().min(8).max(64),
1340
+ turnstile_token: zod_1.z.string().min(1).max(4096),
1341
+ attribution: exports.zNexVendasAttributionSchema.optional().nullable(),
1342
+ privacy_accepted: zod_1.z.literal(true),
1343
+ })
1344
+ .strip();
@@ -898,6 +898,24 @@ export const zNexFinopsProposalStatusSchema = z.enum([
898
898
  "canceled",
899
899
  ]);
900
900
 
901
+ /** feat-326 — atribuição de marketing do `start` (`INexVendasAttribution`). */
902
+ export const zNexVendasAttributionSchema = z
903
+ .object({
904
+ utm_source: z.string().max(255).optional().nullable(),
905
+ utm_medium: z.string().max(255).optional().nullable(),
906
+ utm_campaign: z.string().max(255).optional().nullable(),
907
+ utm_term: z.string().max(255).optional().nullable(),
908
+ utm_content: z.string().max(255).optional().nullable(),
909
+ gclid: z.string().max(255).optional().nullable(),
910
+ referrer: z.string().max(2048).optional().nullable(),
911
+ site: z.string().max(64).optional().nullable(),
912
+ landing_path: z.string().max(512).optional().nullable(),
913
+ })
914
+ .strip();
915
+
916
+ /** feat-325 — tipo de formalização do contrato (`NexVendasContractType`). */
917
+ export const zNexVendasContractTypeSchema = z.enum(["assinatura_eletronica", "adesao"]);
918
+
901
919
  export const zNexFinopsProposalPaymentMethodSchema = z.enum([
902
920
  "boleto",
903
921
  "card_subscription",
@@ -953,6 +971,17 @@ export const zNexFinopsProposalWriteSchema = z
953
971
  loyalty_period: zNexFinopsProposalLoyaltyPeriodSchema.optional().nullable(),
954
972
  /** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
955
973
  contract_template_key: z.string().max(64).optional().nullable(),
974
+ /**
975
+ * feat-325 — derivado no backend do modelo escolhido (o valor do cliente HTTP é
976
+ * sobrescrito). Está no schema para o backend não perder o campo no `.strip()`.
977
+ */
978
+ contract_type: zNexVendasContractTypeSchema.optional().nullable(),
979
+ /** feat-326 — preenchidos pelo `start` da oferta; no CRUD do vendedor ficam ausentes. */
980
+ offer_slug: z.string().max(64).optional().nullable(),
981
+ attribution: zNexVendasAttributionSchema.optional().nullable(),
982
+ client_request_id: z.string().max(64).optional().nullable(),
983
+ /** Resolvido no servidor (uid do token ou `system:offer`); o valor do cliente é sobrescrito. */
984
+ created_by: z.string().max(128).optional().nullable(),
956
985
  terms: z.string().nullable().optional(),
957
986
  valid_until: z
958
987
  .string()
@@ -1148,6 +1177,80 @@ export const zNexFinopsContractAllowancesWriteSchema = z
1148
1177
  alert_thresholds: z.array(zNexFinopsAlertThresholdSchema).optional().nullable(),
1149
1178
  /** feat-264 D4 — ausente/null = TRUE (reembolsa). */
1150
1179
  nfse_fee_reimbursement: z.boolean().optional().nullable(),
1180
+ /** feat-328 — tabela de preço do contrato. Ausente/null = tabela padrão. */
1181
+ price_table_id: z.string().min(1).nullable().optional(),
1182
+ })
1183
+ .strip();
1184
+
1185
+ // ---- Nexus FinOps — tabelas de preço (feat-328) ----
1186
+ //
1187
+ // A tabela só tem preço (Q1). Herança por linha: chave ausente = herda;
1188
+ // `kind: 'disabled'` anula a herdada. Regras que dependem das OUTRAS tabelas
1189
+ // (exatamente uma padrão, mãe viva, sem ciclo, padrão sem `disabled`) ficam no
1190
+ // use case do backend — aqui só a forma do documento.
1191
+
1192
+ const zNexFinopsPriceAmountSchema = z.number().finite().gte(0);
1193
+
1194
+ export const zNexFinopsPriceCapTierSchema = z
1195
+ .object({
1196
+ up_to: z.number().int().gt(0),
1197
+ total: zNexFinopsPriceAmountSchema,
1198
+ })
1199
+ .strip();
1200
+
1201
+ export const zNexFinopsPriceCapSchema = z
1202
+ .object({
1203
+ mode: z.literal("tiered_total"),
1204
+ tiers: z
1205
+ .array(zNexFinopsPriceCapTierSchema)
1206
+ .min(1)
1207
+ .superRefine((tiers, ctx) => {
1208
+ for (let i = 1; i < tiers.length; i++) {
1209
+ if (tiers[i].up_to <= tiers[i - 1].up_to) {
1210
+ ctx.addIssue({
1211
+ code: z.ZodIssueCode.custom,
1212
+ path: [i, "up_to"],
1213
+ message: "tiers.up_to must be strictly increasing",
1214
+ });
1215
+ }
1216
+ }
1217
+ }),
1218
+ })
1219
+ .strip();
1220
+
1221
+ export const zNexFinopsPriceLineSchema = z.discriminatedUnion("kind", [
1222
+ z
1223
+ .object({
1224
+ kind: z.literal("usage"),
1225
+ unit_price: zNexFinopsPriceAmountSchema,
1226
+ service_category: z.string().min(1),
1227
+ cap: zNexFinopsPriceCapSchema.nullable().optional(),
1228
+ })
1229
+ .strip(),
1230
+ z
1231
+ .object({
1232
+ kind: z.literal("recurring"),
1233
+ amount: zNexFinopsPriceAmountSchema,
1234
+ service_category: z.string().min(1),
1235
+ })
1236
+ .strip(),
1237
+ z.object({ kind: z.literal("disabled") }).strip(),
1238
+ ]);
1239
+
1240
+ /** Chave = métrica (usage) ou módulo (recurring); mesmo limite das chaves de `allowances`. */
1241
+ export const zNexFinopsPriceLinesSchema = z.record(
1242
+ z.string().min(1).max(64),
1243
+ zNexFinopsPriceLineSchema,
1244
+ );
1245
+
1246
+ /** Create/update de tabela de preço. `lines` substitui o mapa inteiro (como `allowances`). */
1247
+ export const zNexFinopsPriceTableWriteSchema = z
1248
+ .object({
1249
+ name: z.string().trim().min(1).max(120),
1250
+ is_default: z.boolean(),
1251
+ inherits_from: z.string().min(1).nullable().optional(),
1252
+ lines: zNexFinopsPriceLinesSchema,
1253
+ notes: z.string().nullable().optional(),
1151
1254
  })
1152
1255
  .strip();
1153
1256
 
@@ -1270,3 +1373,105 @@ export const zNfseFeeReimbursementExecuteSchema = z
1270
1373
  }),
1271
1374
  })
1272
1375
  .strict();
1376
+
1377
+ // ---- Nexus Vendas — contrato por adesão (feat-325) ----
1378
+
1379
+ const zSha256HexSchema = z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64 lowercase hex chars");
1380
+
1381
+ /**
1382
+ * Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
1383
+ * idioma e trace vêm da requisição, nunca do corpo.
1384
+ */
1385
+ export const zNexVendasAcceptanceRequestSchema = z
1386
+ .object({
1387
+ cg_sha256: zSha256HexSchema,
1388
+ summary_sha256: zSha256HexSchema,
1389
+ declaration_version: z.string().min(1).max(64),
1390
+ viewed_to_end: z.boolean(),
1391
+ client_request_id: z.string().min(8).max(64),
1392
+ })
1393
+ .strip();
1394
+
1395
+ /** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
1396
+ export const zNexVendasContractTemplateAdhesionSchema = z
1397
+ .object({
1398
+ cg: z
1399
+ .object({
1400
+ version: z.string().min(1).max(64),
1401
+ sha256: zSha256HexSchema,
1402
+ storage_path: z.string().min(1).max(512),
1403
+ effective_from: z
1404
+ .string()
1405
+ .regex(/^\d{4}-\d{2}-\d{2}$/, "effective_from must be an ISO date (YYYY-MM-DD)"),
1406
+ filename: z.string().min(1).max(255),
1407
+ })
1408
+ .strip(),
1409
+ require_email_otp: z.boolean().optional().nullable(),
1410
+ })
1411
+ .strip();
1412
+
1413
+ /** Doc `core/nexus/apps/nex-vendas/config/adhesion` (escrita pelo Nexus). */
1414
+ export const zNexVendasAdhesionConfigWriteSchema = z
1415
+ .object({
1416
+ declaration: z
1417
+ .object({
1418
+ version: z.string().min(1).max(64),
1419
+ text: z.string().min(1).max(4000),
1420
+ })
1421
+ .strip(),
1422
+ document_access_days: z.number().int().min(1).max(3650).optional().nullable(),
1423
+ corrections_per_hour: z.number().int().min(1).max(100).optional().nullable(),
1424
+ })
1425
+ .strip();
1426
+
1427
+ // ---- Nexus Vendas — ofertas self-service (feat-326) ----
1428
+
1429
+ /**
1430
+ * Escrita da oferta `core/nexus/apps/nex-vendas/offers/{slug}` (Nexus → `nex_finops`).
1431
+ * Cobre TODOS os campos de `INexVendasOffer`: o que fica fora do `.strip()` some em
1432
+ * silêncio. `contract_type`, `created_by` e `start_count` são resolvidos no servidor
1433
+ * (o valor do cliente é sobrescrito) e estão aqui para o backend não perdê-los.
1434
+ * Regras de negócio (v1 só `card_subscription`, modelo ativo) ficam no use case.
1435
+ */
1436
+ export const zNexVendasOfferWriteSchema = z
1437
+ .object({
1438
+ slug: z
1439
+ .string()
1440
+ .min(2)
1441
+ .max(64)
1442
+ .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "slug must be kebab-case [a-z0-9-]"),
1443
+ name: z.string().min(1).max(255),
1444
+ headline: z.string().min(1).max(255),
1445
+ description: z.string().max(4000).optional().nullable(),
1446
+ html_content: z.string().optional().nullable(),
1447
+ base_amount: z.number().nonnegative(),
1448
+ due_day: z.number().int().min(1).max(31),
1449
+ accepted_payment_methods: z.array(zNexFinopsProposalPaymentMethodSchema).min(1),
1450
+ loyalty_period: zNexFinopsProposalLoyaltyPeriodSchema,
1451
+ contract_template_key: z.string().min(1).max(64),
1452
+ contract_type: zNexVendasContractTypeSchema.optional().nullable(),
1453
+ allowances: zNexFinopsContractAllowancesSchema.nullable(),
1454
+ terms: z.string().optional().nullable(),
1455
+ proposal_valid_days: z.number().int().min(1).max(90),
1456
+ site: z.string().min(1).max(64),
1457
+ origem: z.string().min(1).max(64).optional().nullable(),
1458
+ active: z.boolean(),
1459
+ listed: z.boolean(),
1460
+ created_by: z.string().max(128).optional(),
1461
+ start_count: z.number().int().nonnegative().optional().nullable(),
1462
+ last_start_at: zFirestoreDateSchema.optional().nullable(),
1463
+ })
1464
+ .strip();
1465
+
1466
+ /** Corpo de `POST /offers/:slug/start` (público). */
1467
+ export const zNexVendasOfferStartRequestSchema = z
1468
+ .object({
1469
+ name: z.string().trim().min(2).max(255),
1470
+ email: z.string().trim().email().max(255),
1471
+ phone: z.string().trim().min(8).max(32),
1472
+ client_request_id: z.string().min(8).max(64),
1473
+ turnstile_token: z.string().min(1).max(4096),
1474
+ attribution: zNexVendasAttributionSchema.optional().nullable(),
1475
+ privacy_accepted: z.literal(true),
1476
+ })
1477
+ .strip();
@@ -67,6 +67,14 @@ export interface IMessageCreatedBy {
67
67
  type: 'human' | 'automation' | 'system';
68
68
  user_id?: string;
69
69
  workflow_id?: string;
70
+ /** Nome exibido do autor. Hoje o hub-waba grava `'WhatsApp Business App'` no eco da coexistência. */
71
+ display_name?: string;
72
+ /**
73
+ * feat-328 — origem especial da mensagem. `'coexistence_app'` marca o eco do
74
+ * WhatsApp Business App na coexistência (resposta humana dada pelo aparelho);
75
+ * conta como saída humana na métrica `attendances_human`.
76
+ */
77
+ source?: 'coexistence_app';
70
78
  }
71
79
  export interface IMessagePricing {
72
80
  category?: 'service' | 'utility' | 'authentication' | 'marketing';
@@ -93,6 +93,14 @@ export interface IMessageCreatedBy {
93
93
  type: 'human' | 'automation' | 'system';
94
94
  user_id?: string;
95
95
  workflow_id?: string;
96
+ /** Nome exibido do autor. Hoje o hub-waba grava `'WhatsApp Business App'` no eco da coexistência. */
97
+ display_name?: string;
98
+ /**
99
+ * feat-328 — origem especial da mensagem. `'coexistence_app'` marca o eco do
100
+ * WhatsApp Business App na coexistência (resposta humana dada pelo aparelho);
101
+ * conta como saída humana na métrica `attendances_human`.
102
+ */
103
+ source?: 'coexistence_app';
96
104
  }
97
105
 
98
106
  // ── Message pricing ──
@@ -1,4 +1,5 @@
1
1
  import type { IFireGlobalDoc } from '../../shared';
2
+ import type { NexVendasContractType } from '../../nex-vendas/adhesion';
2
3
  /**
3
4
  * `cancellation_requested`: o cliente pediu o cancelamento e o contrato está em
4
5
  * processo de encerramento — mas **continua em vigência** e continua faturando
@@ -54,7 +55,11 @@ export interface INexFinopsContractServiceItem {
54
55
  export interface INexFinopsContractAllowance {
55
56
  /** Quantidade incluída no ciclo. 0 = nada incluso; ausente = não contratado. */
56
57
  included: number;
57
- /** Reservado para a feat-150 cheia (preço do excedente). Não usar ainda. */
58
+ /**
59
+ * @deprecated feat-328 (Q4): nunca foi lido por ninguém. O preço do excedente
60
+ * vem da tabela de preço do contrato (`price_table_id` → `INexFinopsPriceTable`).
61
+ * Mantido só para não quebrar docs antigos; não escrever.
62
+ */
58
63
  unit_price_excess?: number | null;
59
64
  }
60
65
  /**
@@ -84,6 +89,14 @@ export declare const NexFinopsMetricCatalog: {
84
89
  readonly label: "Teleconsultas com gravação";
85
90
  readonly unit: "consultas";
86
91
  };
92
+ readonly attendances_human: {
93
+ readonly label: "Atendimentos humanos";
94
+ readonly unit: "contatos";
95
+ };
96
+ readonly attendances_ai: {
97
+ readonly label: "Atendimentos por IA";
98
+ readonly unit: "contatos";
99
+ };
87
100
  };
88
101
  /**
89
102
  * Chaves conhecidas do catálogo — para iterar e para tipar escolha de métrica
@@ -136,6 +149,13 @@ export interface INexFinopsContract extends IFireGlobalDoc {
136
149
  * nasce com direito a estorno; venda assistida, não. Default `false`.
137
150
  */
138
151
  refund_eligible?: boolean | null;
152
+ /**
153
+ * feat-325 D2 — cópia do tipo de formalização da jornada (gravada no draft pelo
154
+ * `ensureContract`). Ausente = `assinatura_eletronica`.
155
+ */
156
+ contract_type?: NexVendasContractType | null;
157
+ /** feat-325 — id do registro em `nex-vendas/acceptances/` (só adesão, após o aceite). */
158
+ acceptance_id?: string | null;
139
159
  /** Método com que o primeiro pagamento foi feito. `accepted_payment_methods` é a oferta; este é o fato. */
140
160
  payment_method?: NexFinopsPaymentMethod | null;
141
161
  asaas?: INexFinopsContractAsaasInfo | null;
@@ -181,6 +201,14 @@ export interface INexFinopsContract extends IFireGlobalDoc {
181
201
  alert_thresholds?: number[] | null;
182
202
  /** feat-264 D4 — reembolsar a taxa de NFS-e ao cliente. ⚠️ Ausente/null = TRUE (reembolsa). */
183
203
  nfse_fee_reimbursement?: boolean | null;
204
+ /**
205
+ * Id da `INexFinopsPriceTable` que precifica este contrato.
206
+ * ⚠️ Ausente/null = tabela **padrão** (`is_default`).
207
+ *
208
+ * Q8: todos os contratos vigentes do mesmo cliente devem apontar para a mesma
209
+ * tabela (efetiva) — validado pelo backend ao ativar o contrato.
210
+ */
211
+ price_table_id?: string | null;
184
212
  }
185
213
  export declare const NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS: Record<NexFinopsContractStatus, NexFinopsContractStatus[]>;
186
214
  /**
@@ -18,6 +18,13 @@ exports.NexFinopsMetricCatalog = {
18
18
  // duas vezes.
19
19
  teleconsultations_unrecorded: { label: 'Teleconsultas sem gravação', unit: 'consultas' },
20
20
  teleconsultations_recorded: { label: 'Teleconsultas com gravação', unit: 'consultas' },
21
+ // feat-328 — DISJUNTAS por pessoa-mês: humano = pessoa com >=1 mensagem de
22
+ // saida humana no mes; IA = o complemento (`attendances = human + ai`). Um
23
+ // contrato usa OU `attendances` (pool unico, legado) OU o par
24
+ // `attendances_human`/`attendances_ai`, NUNCA os tres — cobraria a mesma
25
+ // pessoa duas vezes. Validacao na escrita do contrato (backend, F3).
26
+ attendances_human: { label: 'Atendimentos humanos', unit: 'contatos' },
27
+ attendances_ai: { label: 'Atendimentos por IA', unit: 'contatos' },
21
28
  };
22
29
  /** Doc de config global dos alertas de consumo (convenção `/platform/<app>`). */
23
30
  exports.EVO_BILLING_USAGE_ALERTS_CONFIG_PATH = 'platform/evo-billing/usage-alerts/config';
@@ -1,4 +1,5 @@
1
1
  import type { IFireGlobalDoc } from '../../shared';
2
+ import type { NexVendasContractType } from '../../nex-vendas/adhesion';
2
3
 
3
4
  // ── Status & Recurrence ──
4
5
 
@@ -66,7 +67,11 @@ export interface INexFinopsContractServiceItem {
66
67
  export interface INexFinopsContractAllowance {
67
68
  /** Quantidade incluída no ciclo. 0 = nada incluso; ausente = não contratado. */
68
69
  included: number;
69
- /** Reservado para a feat-150 cheia (preço do excedente). Não usar ainda. */
70
+ /**
71
+ * @deprecated feat-328 (Q4): nunca foi lido por ninguém. O preço do excedente
72
+ * vem da tabela de preço do contrato (`price_table_id` → `INexFinopsPriceTable`).
73
+ * Mantido só para não quebrar docs antigos; não escrever.
74
+ */
70
75
  unit_price_excess?: number | null;
71
76
  }
72
77
 
@@ -87,6 +92,13 @@ export const NexFinopsMetricCatalog = {
87
92
  // duas vezes.
88
93
  teleconsultations_unrecorded: { label: 'Teleconsultas sem gravação', unit: 'consultas' },
89
94
  teleconsultations_recorded: { label: 'Teleconsultas com gravação', unit: 'consultas' },
95
+ // feat-328 — DISJUNTAS por pessoa-mês: humano = pessoa com >=1 mensagem de
96
+ // saida humana no mes; IA = o complemento (`attendances = human + ai`). Um
97
+ // contrato usa OU `attendances` (pool unico, legado) OU o par
98
+ // `attendances_human`/`attendances_ai`, NUNCA os tres — cobraria a mesma
99
+ // pessoa duas vezes. Validacao na escrita do contrato (backend, F3).
100
+ attendances_human: { label: 'Atendimentos humanos', unit: 'contatos' },
101
+ attendances_ai: { label: 'Atendimentos por IA', unit: 'contatos' },
90
102
  } as const;
91
103
 
92
104
  /**
@@ -165,6 +177,13 @@ export interface INexFinopsContract extends IFireGlobalDoc {
165
177
  * nasce com direito a estorno; venda assistida, não. Default `false`.
166
178
  */
167
179
  refund_eligible?: boolean | null;
180
+ /**
181
+ * feat-325 D2 — cópia do tipo de formalização da jornada (gravada no draft pelo
182
+ * `ensureContract`). Ausente = `assinatura_eletronica`.
183
+ */
184
+ contract_type?: NexVendasContractType | null;
185
+ /** feat-325 — id do registro em `nex-vendas/acceptances/` (só adesão, após o aceite). */
186
+ acceptance_id?: string | null;
168
187
 
169
188
  // ── Pagamento efetivo (feat-131) ──
170
189
 
@@ -222,6 +241,17 @@ export interface INexFinopsContract extends IFireGlobalDoc {
222
241
 
223
242
  /** feat-264 D4 — reembolsar a taxa de NFS-e ao cliente. ⚠️ Ausente/null = TRUE (reembolsa). */
224
243
  nfse_fee_reimbursement?: boolean | null;
244
+
245
+ // ── Tabela de preço (feat-328) ──
246
+
247
+ /**
248
+ * Id da `INexFinopsPriceTable` que precifica este contrato.
249
+ * ⚠️ Ausente/null = tabela **padrão** (`is_default`).
250
+ *
251
+ * Q8: todos os contratos vigentes do mesmo cliente devem apontar para a mesma
252
+ * tabela (efetiva) — validado pelo backend ao ativar o contrato.
253
+ */
254
+ price_table_id?: string | null;
225
255
  }
226
256
 
227
257
  // ── Status transitions ──