@fc/servicos-internos
Contrato dos serviços internos da Fábrica de Cálculos: catálogo declarativo de operações (caminhos, credenciais transportadas, autenticação exigida pelo hospedeiro, formatos, tipos de fio e campos de erro permitidos), gramática de paginação/ordenação, cliente HTTP com seam de transporte, fachadas tipadas geradas por família, verificação de drift entre o catálogo e as rotas do hospedeiro, e o vocabulário de topologia usado pela resolução server-side de URLs internas.
Package TypeScript puro, sem dependência de framework — importável por servidor, navegador e testes. O consumo nas apps acontece pela camada Nuxt base-servicos (proxies e composable useServicosInternos).
O pacote não tem barrel: cada pasta é publicada por wildcard no exports ("./catalogo/*": "./src/catalogo/*.ts") e os módulos de raiz (constantes, definirOperacaoInterna, montarCaminhoOperacao, notificacoes, tipos) por chave própria. O consumidor importa o arquivo que declara o símbolo — import { operacoesCalculos } from '@fc/servicos-internos/catalogo/calculos', nunca @fc/servicos-internos.
Dados adicionais de erro não atravessam a fronteira por padrão. Cada operação que expõe um código estável de domínio declara explicitamente camposDadosErro; o cliente normaliza o data reempacotado por proxies e copia somente essas chaves.
A gramática page=size:N,page:M oferece leitura tolerante (parsePaginacaoInterna) e estrita (parsePaginacaoEstrita). A variante estrita recebe tamanho padrão e máximo, aplica o padrão apenas na ausência do parâmetro e lança TypeError para formato ou limites inválidos.