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.