evo360-types 1.3.634 → 1.3.637

package/dist/apps/shared/zod-schemas.d.ts

@@ -25,8 +25,8 @@ export declare const zFireDocSchema: z.ZodObject<{
     id: string;
     tenant: string;
     ref?: any;
-    model_ver?: number | undefined;
     created_at?: Date | null | undefined;
+    model_ver?: number | undefined;
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
 }>;
@@ -40,14 +40,14 @@ export declare const zTagSchema: z.ZodObject<{
     name: string;
     hidden: boolean;
     base?: boolean | undefined;
-    color?: string | undefined;
     category?: string | null | undefined;
+    color?: string | undefined;
 }, {
     name: string;
     hidden: boolean;
     base?: boolean | undefined;
-    color?: string | undefined;
     category?: string | null | undefined;
+    color?: string | undefined;
 }>;
 export declare const zAddressSchema: z.ZodObject<{
     name: z.ZodDefault<z.ZodOptional<z.ZodString>>;

package/dist/types/evo-crm/dic/index.d.ts

@@ -1,5 +1,5 @@
 export * from "../fb_collections";
-import { FirestoreDocumentReference, IFireDoc, ITag } from "../../shared";
+import { FirestoreDocumentReference, IFireDoc, ITag, LinkRelationPair, LinkRelationRole } from "../../shared";
 export declare const EvoCrmDicPermissions: {
     readonly List: "evo_crm_dic_read";
     readonly Get: "evo_crm_dic_read";
@@ -73,3 +73,18 @@ export interface IQualification extends IFireDoc {
     meta_event_value?: number | null;
     [key: string]: unknown;
 }
+/**
+ * feat-193 — item do dicionário `link-relations` (rótulos e ordem). O doc id é o
+ * `code`. O inverso de cada papel é tabela de código em `@evo/model`, não daqui.
+ */
+export interface ILinkRelation extends IFireDoc {
+    code: LinkRelationPair;
+    name: string;
+    role_a: LinkRelationRole;
+    role_b: LinkRelationRole;
+    label_a: string;
+    label_b: string;
+    symmetric: boolean;
+    order: number;
+    [key: string]: unknown;
+}

package/dist/types/evo-crm/dic/index.ts

@@ -1,6 +1,12 @@
 export * from "../fb_collections";
 
-import { FirestoreDocumentReference, IFireDoc, ITag } from "../../shared";
+import {
+  FirestoreDocumentReference,
+  IFireDoc,
+  ITag,
+  LinkRelationPair,
+  LinkRelationRole,
+} from "../../shared";
 
 // Permissões para o dicionário
 export const EvoCrmDicPermissions = {
@@ -125,3 +131,19 @@ export interface IQualification extends IFireDoc {
   meta_event_value?: number | null;
   [key: string]: unknown; // index signature
 }
+
+/**
+ * feat-193 — item do dicionário `link-relations` (rótulos e ordem). O doc id é o
+ * `code`. O inverso de cada papel é tabela de código em `@evo/model`, não daqui.
+ */
+export interface ILinkRelation extends IFireDoc {
+  code: LinkRelationPair;
+  name: string;
+  role_a: LinkRelationRole;
+  role_b: LinkRelationRole;
+  label_a: string;
+  label_b: string;
+  symmetric: boolean;
+  order: number;
+  [key: string]: unknown; // index signature
+}

package/dist/types/evo-crm/fb_collections.d.ts

@@ -4,4 +4,5 @@ export declare const LEAD_QUALIFICATION_COLLECTION = "qualification";
 export declare const CHANNELS = "channels";
 export declare const DIST_CHANNEL_TYPES_COLLECTION = "dist-channel-types";
 export declare const DIST_CHANNELS_COLLECTION = "dist-channels";
+export declare const LINK_RELATIONS_COLLECTION = "link-relations";
 export declare const LEADS_COLLECTION = "leads";

package/dist/types/evo-crm/fb_collections.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LEADS_COLLECTION = exports.DIST_CHANNELS_COLLECTION = exports.DIST_CHANNEL_TYPES_COLLECTION = exports.CHANNELS = exports.LEAD_QUALIFICATION_COLLECTION = exports.LEADS = exports.EVO_CRM_APP = void 0;
+exports.LEADS_COLLECTION = exports.LINK_RELATIONS_COLLECTION = exports.DIST_CHANNELS_COLLECTION = exports.DIST_CHANNEL_TYPES_COLLECTION = exports.CHANNELS = exports.LEAD_QUALIFICATION_COLLECTION = exports.LEADS = exports.EVO_CRM_APP = void 0;
 //EVO CRM Application Doc
 exports.EVO_CRM_APP = "evo-crm";
 //dictionaries
@@ -9,5 +9,9 @@ exports.LEAD_QUALIFICATION_COLLECTION = "qualification";
 exports.CHANNELS = "channels";
 exports.DIST_CHANNEL_TYPES_COLLECTION = "dist-channel-types";
 exports.DIST_CHANNELS_COLLECTION = "dist-channels";
+// feat-193 — rótulos e ordem dos pares de relação do vínculo lead/paciente.
+// Path: tenants/{t}/apps/evo-crm/dics/leads/link-relations/{pair} (base tenant,
+// global em `_global-ptBR`). O inverso de cada papel NÃO vem daqui: é tabela de código.
+exports.LINK_RELATIONS_COLLECTION = "link-relations";
 // Leads
 exports.LEADS_COLLECTION = "leads";

package/dist/types/evo-crm/fb_collections.ts

@@ -8,6 +8,10 @@ export const LEAD_QUALIFICATION_COLLECTION = "qualification";
 export const CHANNELS = "channels";
 export const DIST_CHANNEL_TYPES_COLLECTION = "dist-channel-types";
 export const DIST_CHANNELS_COLLECTION = "dist-channels";
+// feat-193 — rótulos e ordem dos pares de relação do vínculo lead/paciente.
+// Path: tenants/{t}/apps/evo-crm/dics/leads/link-relations/{pair} (base tenant,
+// global em `_global-ptBR`). O inverso de cada papel NÃO vem daqui: é tabela de código.
+export const LINK_RELATIONS_COLLECTION = "link-relations";
 
 // Leads
 export const LEADS_COLLECTION = "leads";

package/dist/types/evo-crm/lead/index.d.ts

@@ -111,6 +111,12 @@ export interface ILead extends IProfile {
     externalLinks?: IExternalLink[];
     /** Derivado de `externalLinks` (`"type:id"`) pelo model — habilita `array-contains`. */
     externalLinkKeys?: string[];
+    /**
+     * feat-193 — quantos links deste doc estão `suggested` (fila de auditoria).
+     * Derivado de `externalLinks` junto com `externalLinkKeys`. AUSENTE = estoque
+     * não avaliado ("unknown"), nunca 0.
+     */
+    pending_links_count?: number;
     tags?: ITag[] | null;
     /** Campos complementares (code → valor), validados contra o dicionário `dics/leads/capture-data` (feat-196). */
     capture_data?: CaptureDataMap | null;

package/dist/types/evo-crm/lead/index.ts

@@ -154,6 +154,12 @@ export interface ILead extends IProfile {
   externalLinks?: IExternalLink[];
   /** Derivado de `externalLinks` (`"type:id"`) pelo model — habilita `array-contains`. */
   externalLinkKeys?: string[];
+  /**
+   * feat-193 — quantos links deste doc estão `suggested` (fila de auditoria).
+   * Derivado de `externalLinks` junto com `externalLinkKeys`. AUSENTE = estoque
+   * não avaliado ("unknown"), nunca 0.
+   */
+  pending_links_count?: number;
   tags?: ITag[] | null;
   /** Campos complementares (code → valor), validados contra o dicionário `dics/leads/capture-data` (feat-196). */
   capture_data?: CaptureDataMap | null;

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

@@ -232,3 +232,19 @@ export interface IMedCalendarIntegration {
     /** Override por capability — precedência mais alta no resolver de URL. */
     workflow_overrides?: Partial<Record<CapabilityName, string>>;
 }
+/**
+ * Modo do passo de vínculo paciente↔lead dos escritores automáticos (sync,
+ * lembrete, envio). `off` = não calcula; `shadow` = calcula e loga `would_link`
+ * sem escrever (default quando ausente); `write` = grava. Rollback = `off`.
+ */
+export declare const LinkModeEnum: {
+    readonly Off: "off";
+    readonly Shadow: "shadow";
+    readonly Write: "write";
+};
+export type LinkMode = (typeof LinkModeEnum)[keyof typeof LinkModeEnum];
+/** Default quando o tenant não declara `integrations.link_mode`. */
+export declare const DEFAULT_LINK_MODE: LinkMode;
+export interface ITenantIntegrationsConfig {
+    link_mode?: LinkMode | null;
+}

package/dist/types/evo-integrations/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OBLIGATORY_CAPABILITIES = exports.SYNC_RUN_HANDLER = exports.SYNC_RUN_PUBSUB_TOPIC = exports.EvoIntegrationsPermissions = void 0;
+exports.DEFAULT_LINK_MODE = exports.LinkModeEnum = exports.OBLIGATORY_CAPABILITIES = exports.SYNC_RUN_HANDLER = exports.SYNC_RUN_PUBSUB_TOPIC = exports.EvoIntegrationsPermissions = void 0;
 exports.isInternalCapability = isInternalCapability;
 exports.splitCapabilityName = splitCapabilityName;
 __exportStar(require("./fb_collections"), exports);
@@ -70,3 +70,20 @@ function splitCapabilityName(name) {
     const [entity, ...rest] = name.split(".");
     return { entity: entity, action: rest.join(".") };
 }
+// ======================================================
+// feat-193 — config de integração do TENANT (não do calendar/adapter).
+// Vive em `ITenant.integrations` (doc `tenants/{t}`), lida pelo sync junto com a
+// config do adapter. Provisionada por script/admin técnico, nunca pelo FE.
+// ======================================================
+/**
+ * Modo do passo de vínculo paciente↔lead dos escritores automáticos (sync,
+ * lembrete, envio). `off` = não calcula; `shadow` = calcula e loga `would_link`
+ * sem escrever (default quando ausente); `write` = grava. Rollback = `off`.
+ */
+exports.LinkModeEnum = {
+    Off: "off",
+    Shadow: "shadow",
+    Write: "write",
+};
+/** Default quando o tenant não declara `integrations.link_mode`. */
+exports.DEFAULT_LINK_MODE = exports.LinkModeEnum.Shadow;

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

@@ -350,3 +350,29 @@ export interface IMedCalendarIntegration {
   /** Override por capability — precedência mais alta no resolver de URL. */
   workflow_overrides?: Partial<Record<CapabilityName, string>>;
 }
+
+// ======================================================
+// feat-193 — config de integração do TENANT (não do calendar/adapter).
+// Vive em `ITenant.integrations` (doc `tenants/{t}`), lida pelo sync junto com a
+// config do adapter. Provisionada por script/admin técnico, nunca pelo FE.
+// ======================================================
+
+/**
+ * Modo do passo de vínculo paciente↔lead dos escritores automáticos (sync,
+ * lembrete, envio). `off` = não calcula; `shadow` = calcula e loga `would_link`
+ * sem escrever (default quando ausente); `write` = grava. Rollback = `off`.
+ */
+export const LinkModeEnum = {
+  Off: "off",
+  Shadow: "shadow",
+  Write: "write",
+} as const;
+
+export type LinkMode = (typeof LinkModeEnum)[keyof typeof LinkModeEnum];
+
+/** Default quando o tenant não declara `integrations.link_mode`. */
+export const DEFAULT_LINK_MODE: LinkMode = LinkModeEnum.Shadow;
+
+export interface ITenantIntegrationsConfig {
+  link_mode?: LinkMode | null;
+}

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

@@ -165,6 +165,26 @@ export interface IAppointmentSpecialty {
     specialtyRef?: FirestoreDocumentReference;
     [key: string]: unknown;
 }
+/** feat-193 F4 — origem de quem pediu o agendamento. */
+export type AppointmentRequestedBySource = "ui_omni" | "ui_calendar" | "hubia" | "mcp";
+export declare const AppointmentRequestedBySourceEnum: {
+    readonly UiOmni: "ui_omni";
+    readonly UiCalendar: "ui_calendar";
+    readonly HubIA: "hubia";
+    readonly Mcp: "mcp";
+};
+/**
+ * feat-193 F4 — quem pediu o agendamento. Gravado no create quando há contexto
+ * (lead da conversa no omni, HubIA, MCP); fora dele fica `null`. Campo LOCAL:
+ * a agenda externa não o conhece e o sync/write-through o preservam.
+ */
+export interface IAppointmentRequestedBy {
+    lead_id: string | null;
+    chat_contact_id: string | null;
+    ticket_id: string | null;
+    display_name: string | null;
+    source: AppointmentRequestedBySource;
+}
 export interface IAppointment extends IFireDoc {
     startDate: Date;
     endDate: Date;
@@ -203,6 +223,8 @@ export interface IAppointment extends IFireDoc {
     status_external_id?: string | null;
     isDraft: boolean;
     draftExpirationMinutes?: number | null;
+    /** feat-193 F4 — solicitante do agendamento. Ver `IAppointmentRequestedBy`. */
+    requested_by?: IAppointmentRequestedBy | null;
     tags?: ITag[] | null;
     [key: string]: unknown;
 }

package/dist/types/evo-med/appointment/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaymentTypeEnum = exports.TelemedicineProviderEnum = exports.AppointmentModeEnum = exports.AppointmentPaymentStatusEnum = exports.EvoMedAppointmentPermissions = void 0;
+exports.AppointmentRequestedBySourceEnum = exports.PaymentTypeEnum = exports.TelemedicineProviderEnum = exports.AppointmentModeEnum = exports.AppointmentPaymentStatusEnum = exports.EvoMedAppointmentPermissions = void 0;
 // Permissões para o agendamento
 exports.EvoMedAppointmentPermissions = {
     List: "evo_med_appointment_read",
@@ -43,3 +43,9 @@ exports.PaymentTypeEnum = {
     Patient: "patient",
     Insurance: "insurance",
 };
+exports.AppointmentRequestedBySourceEnum = {
+    UiOmni: "ui_omni",
+    UiCalendar: "ui_calendar",
+    HubIA: "hubia",
+    Mcp: "mcp",
+};

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

@@ -222,6 +222,33 @@ export interface IAppointmentSpecialty {
 }
 
 // Interface principal do Appointment
+/** feat-193 F4 — origem de quem pediu o agendamento. */
+export type AppointmentRequestedBySource =
+  | "ui_omni"
+  | "ui_calendar"
+  | "hubia"
+  | "mcp";
+
+export const AppointmentRequestedBySourceEnum = {
+  UiOmni: "ui_omni",
+  UiCalendar: "ui_calendar",
+  HubIA: "hubia",
+  Mcp: "mcp",
+} as const;
+
+/**
+ * feat-193 F4 — quem pediu o agendamento. Gravado no create quando há contexto
+ * (lead da conversa no omni, HubIA, MCP); fora dele fica `null`. Campo LOCAL:
+ * a agenda externa não o conhece e o sync/write-through o preservam.
+ */
+export interface IAppointmentRequestedBy {
+  lead_id: string | null;
+  chat_contact_id: string | null;
+  ticket_id: string | null;
+  display_name: string | null;
+  source: AppointmentRequestedBySource;
+}
+
 export interface IAppointment extends IFireDoc {
   startDate: Date;
   endDate: Date;
@@ -263,6 +290,9 @@ export interface IAppointment extends IFireDoc {
   isDraft: boolean;
   draftExpirationMinutes?: number | null; // tempo em minutos para expiração do rascunho
 
+  /** feat-193 F4 — solicitante do agendamento. Ver `IAppointmentRequestedBy`. */
+  requested_by?: IAppointmentRequestedBy | null;
+
   tags?: ITag[] | null;
   [key: string]: unknown; // index signature
 }

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

@@ -174,6 +174,12 @@ export interface IPatient extends IProfile {
     externalLinks?: IExternalLink[];
     /** Derivado de `externalLinks` (`"type:id"`) pelo model — habilita `array-contains`. */
     externalLinkKeys?: string[];
+    /**
+     * feat-193 — quantos links deste doc estão `suggested` (fila de auditoria).
+     * Derivado de `externalLinks` junto com `externalLinkKeys`. AUSENTE = estoque
+     * não avaliado ("unknown"), nunca 0.
+     */
+    pending_links_count?: number;
     height_cm?: number | null;
     weight_kg?: number | null;
     blood_type?: BloodType | null;

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

@@ -238,6 +238,12 @@ export interface IPatient extends IProfile {
   externalLinks?: IExternalLink[];
   /** Derivado de `externalLinks` (`"type:id"`) pelo model — habilita `array-contains`. */
   externalLinkKeys?: string[];
+  /**
+   * feat-193 — quantos links deste doc estão `suggested` (fila de auditoria).
+   * Derivado de `externalLinks` junto com `externalLinkKeys`. AUSENTE = estoque
+   * não avaliado ("unknown"), nunca 0.
+   */
+  pending_links_count?: number;
   //informações médicas
   height_cm?: number | null; // Altura em centímetros
   weight_kg?: number | null; // Peso em kg

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

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 import type { FirestoreDocumentReference, IFireDoc } from "../shared";
+import type { ITenantIntegrationsConfig } from "../evo-integrations";
 export declare const CoreTenantsPermissions: {
     readonly List: "core_tenants_read";
     readonly Get: "core_tenants_read";
@@ -89,4 +90,10 @@ export interface ITenant extends IFireDoc {
      * técnico auditado; nunca pelo FE.
      */
     modules?: Record<string, ITenantModuleEntitlement>;
+    /**
+     * feat-193 — config de integração do tenant (`link_mode` do passo de vínculo
+     * paciente↔lead). Ausente = defaults (`DEFAULT_LINK_MODE`). Provisionado por
+     * script/admin técnico; nunca pelo FE.
+     */
+    integrations?: ITenantIntegrationsConfig | null;
 }

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

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 import type { FirestoreDocumentReference, IFireDoc } from "../shared";
+import type { ITenantIntegrationsConfig } from "../evo-integrations";
 
 // Permissões para o tenant
 export const CoreTenantsPermissions = {
@@ -122,4 +123,10 @@ export interface ITenant extends IFireDoc {
    * técnico auditado; nunca pelo FE.
    */
   modules?: Record<string, ITenantModuleEntitlement>;
+  /**
+   * feat-193 — config de integração do tenant (`link_mode` do passo de vínculo
+   * paciente↔lead). Ausente = defaults (`DEFAULT_LINK_MODE`). Provisionado por
+   * script/admin técnico; nunca pelo FE.
+   */
+  integrations?: ITenantIntegrationsConfig | null;
 }

package/dist/types/shared/external-links.d.ts

@@ -37,11 +37,109 @@ export declare const ExternalOwnerSystemEnum: {
     readonly Nexus: "nexus";
 };
 export type ExternalOwnerSystem = (typeof ExternalOwnerSystemEnum)[keyof typeof ExternalOwnerSystemEnum];
+/**
+ * feat-193 — natureza do vínculo lead/paciente (`crm_lead` <-> `med_patient`,
+ * `med_patient` <-> `med_patient`, `crm_lead` <-> `crm_lead`).
+ *
+ * `identity` = mesma pessoa; `representation` = "fala/agenda/paga por". Vínculo
+ * inferido nasce `representation`: é a afirmação mais fraca e sempre verdadeira.
+ * Só `identity` CONFIRMADA grava `patient.lead_id`, e há no máximo uma por paciente.
+ */
+export declare const ExternalLinkKindEnum: {
+    readonly Identity: "identity";
+    readonly Representation: "representation";
+};
+export type ExternalLinkKind = (typeof ExternalLinkKindEnum)[keyof typeof ExternalLinkKindEnum];
+/**
+ * feat-193 — ÚNICA fonte de verdade do estado do vínculo (não existe campo
+ * `confirmed`). Automação só cria `suggested` ou re-observa; confirmar, rejeitar,
+ * promover e rebaixar são ações humanas. `rejected` fica em `externalLinks` como
+ * lápide e sai de `externalLinkKeys`.
+ */
+export declare const ExternalLinkStatusEnum: {
+    readonly Suggested: "suggested";
+    readonly Confirmed: "confirmed";
+    readonly Rejected: "rejected";
+};
+export type ExternalLinkStatus = (typeof ExternalLinkStatusEnum)[keyof typeof ExternalLinkStatusEnum];
+/** feat-193 — origem de quem criou/observou/confirmou o vínculo. */
+export declare const ExternalLinkSourceEnum: {
+    readonly UiAppointment: "ui_appointment";
+    readonly UiManual: "ui_manual";
+    readonly UiFamily: "ui_family";
+    readonly SyncInferred: "sync_inferred";
+    readonly ReminderInferred: "reminder_inferred";
+    readonly SendInferred: "send_inferred";
+    readonly LeadAutocreate: "lead_autocreate";
+    readonly Inherited: "inherited";
+    readonly Merge: "merge";
+    /** Aresta sintetizada a partir de um `patient.lead_id` sem `crm_lead:*`. */
+    readonly Legacy: "legacy";
+};
+export type ExternalLinkSource = (typeof ExternalLinkSourceEnum)[keyof typeof ExternalLinkSourceEnum];
+/**
+ * feat-193 — par de relação (chave neutra de gênero). O rótulo exibido vem do
+ * dicionário `link-relations`; o inverso de cada papel é tabela de código.
+ */
+export declare const LinkRelationPairEnum: {
+    readonly ParentChild: "parent_child";
+    readonly Spouse: "spouse";
+    readonly GuardianDependent: "guardian_dependent";
+    readonly Family: "family";
+    readonly CompanyEmployee: "company_employee";
+    readonly ThirdPartyCompany: "third_party_company";
+    readonly Other: "other";
+};
+export type LinkRelationPair = (typeof LinkRelationPairEnum)[keyof typeof LinkRelationPairEnum];
+export declare const LinkRelationRoleEnum: {
+    readonly Parent: "parent";
+    readonly Child: "child";
+    readonly Spouse: "spouse";
+    readonly Guardian: "guardian";
+    readonly Dependent: "dependent";
+    readonly Family: "family";
+    readonly Company: "company";
+    readonly Employee: "employee";
+    readonly ThirdParty: "third_party";
+    readonly Represented: "represented";
+    readonly Other: "other";
+};
+export type LinkRelationRole = (typeof LinkRelationRoleEnum)[keyof typeof LinkRelationRoleEnum];
+/**
+ * feat-193 — relação qualificada. `other_role` é o papel do objeto APONTADO em
+ * relação a quem guarda o link: no paciente B filho do lead A, o link para A
+ * carrega `{ pair: 'parent_child', other_role: 'parent' }`; no lead A, o link
+ * para B carrega `{ pair: 'parent_child', other_role: 'child' }`.
+ */
+export interface IExternalLinkRelation {
+    pair: LinkRelationPair;
+    other_role: LinkRelationRole;
+}
 export interface IExternalLink {
     type: ExternalObjectType;
     id: string;
     label?: string;
     ref?: FirestoreDocumentReference;
+    kind?: ExternalLinkKind;
+    relation?: IExternalLinkRelation | null;
+    status?: ExternalLinkStatus;
+    /**
+     * sha256(evidence_type|e164_completo|a_type:a_id|b_type:b_id|normalizer_version).
+     * Hash, sem PII. Uma rejeição só bloqueia a re-inferência da MESMA evidência.
+     */
+    evidence_fingerprint?: string | null;
+    created_source?: ExternalLinkSource;
+    created_by?: FirestoreDocumentReference | null;
+    created_at?: Date | null;
+    /** Última automação que reviu a evidência (nunca muda `status`/`kind`). */
+    last_observed_source?: ExternalLinkSource | null;
+    last_observed_at?: Date | null;
+    confirmed_source?: ExternalLinkSource | null;
+    confirmed_by?: FirestoreDocumentReference | null;
+    confirmed_at?: Date | null;
+    rejected_by?: FirestoreDocumentReference | null;
+    rejected_at?: Date | null;
+    rejection_reason?: string | null;
     /**
      * feat-125 — sistema dono do objeto quando ele NÃO vive no tenant.
      *

package/dist/types/shared/external-links.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExternalOwnerSystemEnum = exports.ExternalObjectTypeEnum = void 0;
+exports.LinkRelationRoleEnum = exports.LinkRelationPairEnum = exports.ExternalLinkSourceEnum = exports.ExternalLinkStatusEnum = exports.ExternalLinkKindEnum = exports.ExternalOwnerSystemEnum = exports.ExternalObjectTypeEnum = void 0;
 // ----- External object links (for unified UI views across modules)
 // Promoted from evo-task to shared for reuse in invoices, tasks, and other modules
 exports.ExternalObjectTypeEnum = {
@@ -39,3 +39,66 @@ exports.ExternalObjectTypeEnum = {
 exports.ExternalOwnerSystemEnum = {
     Nexus: "nexus",
 };
+/**
+ * feat-193 — natureza do vínculo lead/paciente (`crm_lead` <-> `med_patient`,
+ * `med_patient` <-> `med_patient`, `crm_lead` <-> `crm_lead`).
+ *
+ * `identity` = mesma pessoa; `representation` = "fala/agenda/paga por". Vínculo
+ * inferido nasce `representation`: é a afirmação mais fraca e sempre verdadeira.
+ * Só `identity` CONFIRMADA grava `patient.lead_id`, e há no máximo uma por paciente.
+ */
+exports.ExternalLinkKindEnum = {
+    Identity: "identity",
+    Representation: "representation",
+};
+/**
+ * feat-193 — ÚNICA fonte de verdade do estado do vínculo (não existe campo
+ * `confirmed`). Automação só cria `suggested` ou re-observa; confirmar, rejeitar,
+ * promover e rebaixar são ações humanas. `rejected` fica em `externalLinks` como
+ * lápide e sai de `externalLinkKeys`.
+ */
+exports.ExternalLinkStatusEnum = {
+    Suggested: "suggested",
+    Confirmed: "confirmed",
+    Rejected: "rejected",
+};
+/** feat-193 — origem de quem criou/observou/confirmou o vínculo. */
+exports.ExternalLinkSourceEnum = {
+    UiAppointment: "ui_appointment",
+    UiManual: "ui_manual",
+    UiFamily: "ui_family",
+    SyncInferred: "sync_inferred",
+    ReminderInferred: "reminder_inferred",
+    SendInferred: "send_inferred",
+    LeadAutocreate: "lead_autocreate",
+    Inherited: "inherited",
+    Merge: "merge",
+    /** Aresta sintetizada a partir de um `patient.lead_id` sem `crm_lead:*`. */
+    Legacy: "legacy",
+};
+/**
+ * feat-193 — par de relação (chave neutra de gênero). O rótulo exibido vem do
+ * dicionário `link-relations`; o inverso de cada papel é tabela de código.
+ */
+exports.LinkRelationPairEnum = {
+    ParentChild: "parent_child",
+    Spouse: "spouse",
+    GuardianDependent: "guardian_dependent",
+    Family: "family",
+    CompanyEmployee: "company_employee",
+    ThirdPartyCompany: "third_party_company",
+    Other: "other",
+};
+exports.LinkRelationRoleEnum = {
+    Parent: "parent",
+    Child: "child",
+    Spouse: "spouse",
+    Guardian: "guardian",
+    Dependent: "dependent",
+    Family: "family",
+    Company: "company",
+    Employee: "employee",
+    ThirdParty: "third_party",
+    Represented: "represented",
+    Other: "other",
+};