Publicar no marketplace
Carregar um plugin, instalá-lo num projeto e depois publicá-lo, três passos separados por trás de três métodos diferentes e uma barreira de revisão.
Pôr o código de um plugin em disco, instalá-lo num projeto e apresentá-lo a outras pessoas são três ações separadas, cada uma por trás do seu próprio método. Nenhuma delas é executada automaticamente pelas outras.
Carregar
upload_plugin guarda o documento de catálogo do plugin: o seu manifesto (calculado ao analisar o
pacote como descreve a página do manifesto), o seu plugin_type, etiqueta,
descrição, tags e version. É aqui que cria o registo de um plugin ou envia uma nova versão de um
existente. No painel, é a Sheet do editor do separador Plugins (Tab_plugins.vue), acessível a partir
da secção Plugins de um projeto.
Instalar
install_plugin coloca o pacote do plugin num projeto: instala-o por npm no próprio node_modules
desse projeto e regista-o no mapa app_plugins_purchased do projeto. Um plugin pode ser instalado num
projeto sem nunca ser público, é assim que desenvolve com o seu próprio carregamento antes de mais
alguém o poder ver.
Publicar
publish_plugin é o interruptor explícito e separado que torna um plugin já carregado visível no
catálogo do marketplace (visibility: 'public') ou o devolve apenas ao proprietário
(visibility: 'private'). No painel, é o interruptor Visibilidade no marketplace num plugin que
possui. Carregar ou atualizar o código de um plugin nunca o publica por si só.
A barreira de revisão
Tornar público faz passar publish_plugin por uma verificação de aprovação
(marketplace_module.review_and_notify_external), a menos que a conta que carrega seja um publicador
de confiança (a conta de sistema Xuda legada, ou um supervisor de plataforma configurado). O resultado
coloca o documento do plugin num de três estados, refletidos tanto em publish_stat como no campo
stat legado: 3 aprovado e ativo, 6 rejeitado (com publish_reason definido e uma ligação de
recurso construída a partir de approval.appeal_token), ou 1 ainda em revisão. Um plugin rejeitado
ou em revisão é forçado a voltar a visibility: 'private'.
publish_plugin recusa-se a tornar público (code: -403) a menos que a conta tenha uma conta de
vendedor Stripe Connect ativa, a mesma barreira que as listagens de projetos do marketplace usam. Um
publicador de confiança (os próprios plugins da plataforma) também a dispensa.
Consentimento, do lado de quem instala
Antes de install_plugin escrever o que quer que seja, chama install_consent.build_plugin_consent()
e exige no pedido um consent aceite correspondente (com um content_hash que o servidor volta a
calcular e verifica). Esse ecrã é construído diretamente a partir do manifesto do plugin, veja
a página do manifesto para saber exatamente o que cada ficheiro presente lhe
acrescenta, além do id do pacote npm e da versão a instalar, e se o plugin depende de outro.
O acordo de carregamento de plugins
dist/xuda_plugin_upload_user_agreement.html é um documento jurídico permanente: carregar um plugin
concede à Xuda uma licença mundial e isenta de royalties para o usar, reproduzir, distribuir e
apresentar, e quem o carrega declara que o plugin é obra sua, livre de malware, e garante que
indemnizará a Xuda a esse respeito. Está ao lado de dois acordos relacionados na mesma pasta dist/,
um acordo de carregamento de aplicações e partilha de receitas e um modelo de acordo de licença
proprietária, todos servidos como ficheiros estáticos a partir do caminho dist/ da plataforma, tal
como xuda-runtime-slim.js e outros recursos de runtime.
A superfície da API
Dos métodos de plugins, apenas get_plugins e get_plugins_categories têm clearance public,
navegar no catálogo não precisa de conta. upload_plugin, install_plugin, uninstall_plugin e
get_app_plugins têm clearance admin, com âmbito de projeto. publish_plugin e archive_plugin
são ações exclusivas do painel e não fazem parte da API pública.
Get Install Consent
Returns the install consent screen for one marketplace AI agent or plugin: what it does, who wrote it, the liability text, and the content hash the install has to echo back.