@stellartechnologies/contracts

Contratos compartilhados do agilizaclinica — fonte única de verdade entre api, agent-ms e scheduler. Criado para matar as cópias gêmeas que divergiam à mão (auditoria estrutural R3 / incidentes ID-01, ID-02).

O que exporta

• Mensageria outbound v2: OutboundDispatchV2Schema + OutboundResponseSchema + OutboundMessageSchema e os tipos inferidos (OutboundDispatchV2, OutboundResponse, OutboundMessage). Antes duplicado em agent-ms/.../agents/contracts/outbound-response.ts e api/.../whatsapp/domain/outbound-response.schema.ts.
• Identidade BR: brPhoneVariants (variantes ±9 com/sem +), buildPhoneCandidates, chatIdOf (whatsapp:<digits> sem +, fix ID-01). Antes duplicado em api/person.helpers.ts, agent-ms/phone.util.ts e agent-ms/orchestrator-helpers.ts.
• Tópicos Kafka (Padrão B): OUTBOUND_V2_TOPIC, OPERATOR_NOTIFICATION_TOPIC, INCOMING_MESSAGE_TOPIC, etc.

zod é peerDependency (^3.25.0 || ^4.0.0) — usa o zod do consumidor.

Publicação

npmjs.org, público. Publish automático via Actions ao empurrar uma tag v* (workflow publish.yml, usa o secret NPM_TOKEN). Bump a versão e crie a tag:

npm version patch         # ou minor/major
git push --follow-tags

Consumo (api / agent-ms)

Pacote público no registry padrão → sem token, sem .npmrc, sem secret em lugar nenhum (CI, Docker, dev local):

npm install @stellartechnologies/contracts

import { OutboundDispatchV2Schema, chatIdOf, OUTBOUND_V2_TOPIC } from '@stellartechnologies/contracts';

O scheduler não consome (não duplica esses contratos — só espelha o schema Prisma).