evo360-types 1.3.600 → 1.3.604

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

@@ -42,12 +42,34 @@ 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. */
+/**
+ * Dados que o vendedor já conhece e a página pública usa para pré-preencher.
+ * Os nomes seguem `INexVendasJourneyCustomerData`/`INexVendasJourneyCompany` da
+ * jornada, exceto `company`, que é a razão social (lá, `legal_name`).
+ *
+ * Com `customer_id` na proposta, o backend grava aqui um SNAPSHOT do cadastro do
+ * cliente a cada create/update (o que o vendedor enviar é sobrescrito); sem
+ * `customer_id`, vale o que o vendedor digitou. `document_number` e
+ * `responsible_cpf` são gravados só com dígitos.
+ */
 export interface INexFinopsProposalPrefill {
   name?: string | null;
   email?: string | null;
   phone?: string | null;
+  /** Razão social. */
   company?: string | null;
+  trade_name?: string | null;
+  document_type?: 'cpf' | 'cnpj' | null;
+  document_number?: string | null;
+  /** CPF de quem assina. No cadastro PF coincide com `document_number`. */
+  responsible_cpf?: string | null;
+  zip?: string | null;
+  street?: string | null;
+  number?: string | null;
+  complement?: string | null;
+  district?: string | null;
+  city?: string | null;
+  state?: string | null;
 }
 
 // ── Documento principal ──
@@ -127,13 +149,19 @@ export interface INexFinopsProposalPublic {
    */
   loyalty_period_label?: string | null;
   /**
-   * Dados de contato que o vendedor cadastrou, por inteiro, para a página
-   * pública pré-preencher o formulário. `null` quando a proposta não tem prefill;
-   * cada campo é `null` quando ausente. Nunca documento (CPF/CNPJ).
+   * Dados que o vendedor cadastrou, por inteiro, para a página pública
+   * pré-preencher o formulário. `null` quando a proposta não tem prefill; cada
+   * campo é `null` quando ausente.
    *
    * Decisão do usuário (2026-09-23): a proposta existe para o cliente não
    * precisar preencher. Quem tem o link vê o contato do lead — risco aceito.
    * Supera, neste ponto, a projeção só-nome da feat-128.
+   *
+   * Documento INCLUÍDO desde a feat-194 (2026-09-24), revogando o "nunca
+   * documento" da fix-150: CNPJ, CPF do titular PF e CPF do responsável saem
+   * para quem tem o link, porque pré-preencher CPF/CNPJ só funciona se o
+   * endpoint público os entregar. Risco LGPD (CPF é dado pessoal) registrado;
+   * restringir a CNPJ depois muda só a projeção, não o contrato.
    */
   prefill: INexFinopsProposalPublicPrefill | null;
   /**
@@ -143,11 +171,26 @@ export interface INexFinopsProposalPublic {
   prefill_masked: { name: string | null };
 }
 
+/** Mesmos campos de `INexFinopsProposalPrefill`, cada um `null` quando ausente. */
 export interface INexFinopsProposalPublicPrefill {
   name: string | null;
   email: string | null;
   phone: string | null;
+  /** Razão social. */
   company: string | null;
+  trade_name: string | null;
+  document_type: 'cpf' | 'cnpj' | null;
+  /** Só dígitos. */
+  document_number: string | null;
+  /** Só dígitos. */
+  responsible_cpf: string | null;
+  zip: string | null;
+  street: string | null;
+  number: string | null;
+  complement: string | null;
+  district: string | null;
+  city: string | null;
+  state: string | null;
 }
 
 // ── Transições de status ──

package/dist/types/evo-med/people/index.d.ts

@@ -1,6 +1,6 @@
 export * from "../fb_collections";
 import { IProfile } from "../../evo-people";
-import type { FirestoreDocumentReference, IAddress, IContact, IExternalLink, ITag } from "../../shared";
+import type { CaptureDataMap, FirestoreDocumentReference, IAddress, IContact, IExternalLink, ITag } from "../../shared";
 import { IMedication, PatientAttachmentBaseCategory } from "../dic";
 export declare const EvoMedProfessionalPermissions: {
     readonly List: "evo_med_people_professional_read";
@@ -184,6 +184,8 @@ export interface IPatient extends IProfile {
     attachments?: IPatientAttachment[] | null;
     attachmentExternalLinkKeys?: string[] | null;
     tags?: ITag[] | null;
+    /** Campos complementares (code → valor), validados contra o dicionário `dics/patients/capture-data` (feat-196). */
+    capture_data?: CaptureDataMap | null;
     userRef?: FirestoreDocumentReference;
     [key: string]: unknown;
 }

package/dist/types/evo-med/people/index.ts

@@ -1,6 +1,7 @@
 export * from "../fb_collections";
 import { IProfile } from "../../evo-people";
 import type {
+  CaptureDataMap,
   FirestoreDocumentReference,
   IAddress,
   IContact,
@@ -249,6 +250,8 @@ export interface IPatient extends IProfile {
   attachments?: IPatientAttachment[] | null;
   attachmentExternalLinkKeys?: string[] | null;
   tags?: ITag[] | null;
+  /** Campos complementares (code → valor), validados contra o dicionário `dics/patients/capture-data` (feat-196). */
+  capture_data?: CaptureDataMap | null;
   userRef?: FirestoreDocumentReference;
   [key: string]: unknown; // index signature
 }

package/dist/types/shared/capture-data.d.ts

@@ -0,0 +1,49 @@
+import type { IFireDoc } from "./index";
+/** Nome da subcoleção do dicionário, sob `dics/{entidade}/`. */
+export declare const CAPTURE_DATA_COLLECTION = "capture-data";
+/** Entidades que têm dicionário de campos complementares (= segmento do path em `dics/`). */
+export type CaptureDataEntity = "leads" | "patients";
+export declare const CAPTURE_DATA_FIELD_TYPES: readonly ["text", "number", "date", "select", "boolean"];
+/** Tipo do campo. Ausente no doc = `text` (campos legados de lead). */
+export type CaptureDataFieldType = (typeof CAPTURE_DATA_FIELD_TYPES)[number];
+/**
+ * Valor gravado no mapa `capture_data`. `date` é string `YYYY-MM-DD`;
+ * `select` grava o `value` da opção.
+ */
+export type CaptureDataValue = string | number | boolean;
+/** Mapa gravado na entidade (`lead.capture_data`, `patient.capture_data`). */
+export type CaptureDataMap = Record<string, CaptureDataValue>;
+/**
+ * Regra de CRIAÇÃO do `code` (aplicada no backend). Codes legados fora desse
+ * padrão (ex.: `Convênio`, `nome-paciente`) continuam válidos para leitura.
+ */
+export declare const CAPTURE_DATA_CODE_PATTERN = "^[a-z][a-z0-9_]{0,63}$";
+/** Limite de caracteres de um valor `text`. */
+export declare const CAPTURE_DATA_TEXT_MAX_LENGTH = 2000;
+export interface ICaptureDataFieldOption {
+    /** O que vai gravado no mapa. */
+    value: string;
+    /** O que a UI mostra. */
+    label: string;
+}
+export interface ICaptureDataField extends IFireDoc {
+    /** Chave no mapa `capture_data`. Imutável depois de criado. */
+    code: string;
+    name: string;
+    /** Ausente = `text` (legado). Imutável depois de definido. */
+    type?: CaptureDataFieldType;
+    /** Só para `select`. */
+    options?: ICaptureDataFieldOption[] | null;
+    required?: boolean;
+    order?: number | null;
+    /** Envia o valor ao índice de busca (Algolia, região US). Default false (D2). */
+    searchable?: boolean;
+    /** Instrução para a IA preencher o campo. */
+    mcp_description?: string | null;
+    /** Default true. */
+    mcp_enabled?: boolean;
+}
+/** Compatibilidade: o dicionário de lead é o genérico. */
+export type ILeadCaptureDataField = ICaptureDataField;
+/** Dicionário de campos complementares de paciente. */
+export type IPatientCaptureDataField = ICaptureDataField;

package/dist/types/shared/capture-data.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAPTURE_DATA_TEXT_MAX_LENGTH = exports.CAPTURE_DATA_CODE_PATTERN = exports.CAPTURE_DATA_FIELD_TYPES = exports.CAPTURE_DATA_COLLECTION = void 0;
+// ----- Campos complementares (capture-data) — feat-196
+//
+// Dicionário genérico por entidade: cada tenant define campos próprios que são
+// gravados em `{entidade}.capture_data` (mapa code → valor).
+//   leads    → tenants/{t}/apps/evo-crm/dics/leads/capture-data/{id}
+//   patients → tenants/{t}/apps/evo-med/dics/patients/capture-data/{id}
+// Herda do `base_tenant` (o tenant atual vence o base, deduplicado por `code`).
+/** Nome da subcoleção do dicionário, sob `dics/{entidade}/`. */
+exports.CAPTURE_DATA_COLLECTION = "capture-data";
+exports.CAPTURE_DATA_FIELD_TYPES = [
+    "text",
+    "number",
+    "date",
+    "select",
+    "boolean",
+];
+/**
+ * Regra de CRIAÇÃO do `code` (aplicada no backend). Codes legados fora desse
+ * padrão (ex.: `Convênio`, `nome-paciente`) continuam válidos para leitura.
+ */
+exports.CAPTURE_DATA_CODE_PATTERN = "^[a-z][a-z0-9_]{0,63}$";
+/** Limite de caracteres de um valor `text`. */
+exports.CAPTURE_DATA_TEXT_MAX_LENGTH = 2000;

package/dist/types/shared/capture-data.ts

@@ -0,0 +1,74 @@
+import type { IFireDoc } from "./index";
+
+// ----- Campos complementares (capture-data) — feat-196
+//
+// Dicionário genérico por entidade: cada tenant define campos próprios que são
+// gravados em `{entidade}.capture_data` (mapa code → valor).
+//   leads    → tenants/{t}/apps/evo-crm/dics/leads/capture-data/{id}
+//   patients → tenants/{t}/apps/evo-med/dics/patients/capture-data/{id}
+// Herda do `base_tenant` (o tenant atual vence o base, deduplicado por `code`).
+
+/** Nome da subcoleção do dicionário, sob `dics/{entidade}/`. */
+export const CAPTURE_DATA_COLLECTION = "capture-data";
+
+/** Entidades que têm dicionário de campos complementares (= segmento do path em `dics/`). */
+export type CaptureDataEntity = "leads" | "patients";
+
+export const CAPTURE_DATA_FIELD_TYPES = [
+  "text",
+  "number",
+  "date",
+  "select",
+  "boolean",
+] as const;
+
+/** Tipo do campo. Ausente no doc = `text` (campos legados de lead). */
+export type CaptureDataFieldType = (typeof CAPTURE_DATA_FIELD_TYPES)[number];
+
+/**
+ * Valor gravado no mapa `capture_data`. `date` é string `YYYY-MM-DD`;
+ * `select` grava o `value` da opção.
+ */
+export type CaptureDataValue = string | number | boolean;
+
+/** Mapa gravado na entidade (`lead.capture_data`, `patient.capture_data`). */
+export type CaptureDataMap = Record<string, CaptureDataValue>;
+
+/**
+ * Regra de CRIAÇÃO do `code` (aplicada no backend). Codes legados fora desse
+ * padrão (ex.: `Convênio`, `nome-paciente`) continuam válidos para leitura.
+ */
+export const CAPTURE_DATA_CODE_PATTERN = "^[a-z][a-z0-9_]{0,63}$";
+
+/** Limite de caracteres de um valor `text`. */
+export const CAPTURE_DATA_TEXT_MAX_LENGTH = 2000;
+
+export interface ICaptureDataFieldOption {
+  /** O que vai gravado no mapa. */
+  value: string;
+  /** O que a UI mostra. */
+  label: string;
+}
+
+export interface ICaptureDataField extends IFireDoc {
+  /** Chave no mapa `capture_data`. Imutável depois de criado. */
+  code: string;
+  name: string;
+  /** Ausente = `text` (legado). Imutável depois de definido. */
+  type?: CaptureDataFieldType;
+  /** Só para `select`. */
+  options?: ICaptureDataFieldOption[] | null;
+  required?: boolean;
+  order?: number | null;
+  /** Envia o valor ao índice de busca (Algolia, região US). Default false (D2). */
+  searchable?: boolean;
+  /** Instrução para a IA preencher o campo. */
+  mcp_description?: string | null;
+  /** Default true. */
+  mcp_enabled?: boolean;
+}
+
+/** Compatibilidade: o dicionário de lead é o genérico. */
+export type ILeadCaptureDataField = ICaptureDataField;
+/** Dicionário de campos complementares de paciente. */
+export type IPatientCaptureDataField = ICaptureDataField;

package/dist/types/shared/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 export * from "./external-links";
+export * from "./capture-data";
 export interface FirestoreDocumentReference {
     id: string;
     path: string;

package/dist/types/shared/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.IEvoApp = void 0;
 __exportStar(require("./fb_collections"), exports);
 __exportStar(require("./external-links"), exports);
+__exportStar(require("./capture-data"), exports);
 var IEvoApp;
 (function (IEvoApp) {
     IEvoApp["EvoActivity"] = "evo-activity";

package/dist/types/shared/index.ts

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 export * from "./external-links";
+export * from "./capture-data";
 
 // ----- FirestoreTypes
 // Definir o tipo unificado para DocumentReference

package/package.json

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