STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO
Fixtures e contratos SDK
A extensão inclui o SDK 2.0.0. Ele mantém o protocolo v1 do host, Client.call, manifestos apiVersion: 1 e o formato FEX existente. A versão do kit e a versão do protocolo são conceitos diferentes.
Fixtures de backend
Um arquivo de fixtures define operações fictícias, suas permissões e seus resultados locais:
{
"grantedPermissions": ["demo.read"],
"actorPermissions": ["demo.read"],
"operations": {
"demo.greeting": {
"permission": "demo.read",
"module": "empresa.demo",
"result": { "message": "Olá do SDK" }
}
}
}
O manifesto precisa declarar empresa.demo em dependencies e demo.read em permissions. A configuração runtime.fixtures aponta para esse JSON.
A chamada a client.call('demo.greeting', {}) só funciona se a dependência estiver declarada e a permissão aparecer nos três conjuntos: manifesto, concessões simuladas do host e permissões simuladas do ator. Sem esses conjuntos, o acesso é negado. Operações desconhecidas falham.
Esses nomes são fixtures de desenvolvimento, não APIs que o Titan operacional necessariamente oferece. Os resultados são estáticos; não substituem um serviço real, uma transação ou uma consulta a ERP.
Módulos nativos
O host local real usa o núcleo, os serviços e a autorização dos próprios módulos carregados. Esse fluxo é diferente do mock de um plugin externo. Não substitua um controlador nativo por uma fixture e declare que ele foi homologado.
Tipos e respostas
O SDK V2 oferece TypedClient em TypeScript. Seu mapa de operações ajuda o compilador a conferir entradas e resultados; um decoder obrigatório valida o resultado em execução. Uma anotação de tipo sozinha não valida dados recebidos.
As bibliotecas PHP e TypeScript preservam o transporte JSON versionado, correlação de identificadores e limites de mensagem. A identidade e as concessões de uma instalação real pertencem ao host autenticado, nunca aos campos enviados pelo plugin.
Atualizar o SDK
Deixe titanStudio.sdkPath vazio para usar a versão embarcada. Se selecionar uma distribuição alternativa, confirme que ela contém CLI, bibliotecas e MockCore compatíveis com os runners. Teste o plugin antes de atualizar um ambiente de homologação.