HEXA Native CLI/SDK

CLI separado para developers criarem, validarem, empacotarem e assinarem extensoes HEXA Native sem clonar o projeto inteiro do HEXA Browser.

Instalar

Quando o pacote estiver publicado:

npx @hexapack/native-cli --help

O pacote oficial usa o escopo npm @hexapack porque o escopo @hexa nao esta disponivel para esta organizacao. O binario instalado continua sendo hexa-native.

Enquanto o pacote ainda estiver dentro deste repositorio:

node packages/hexa-native-cli/bin/hexa-native.mjs --help

Gerar chave do developer

Rode no computador do developer, nunca no servidor aaPanel/Docker:

npx @hexapack/native-cli keygen \
  --out-dir ~/.hexa/native/keys \
  --name hexa-publisher

O comando cria:

• ~/.hexa/native/keys/hexa-publisher-private.pem: fica somente com o developer.
• ~/.hexa/native/keys/hexa-publisher-public.pem: cola no Developer Portal, em Store > Publisher.

Criar starter

npx @hexapack/native-cli init ./minha-primeira-extensao-hexa \
  --name "Minha Primeira Extensao HEXA" \
  --slug minha-primeira-extensao-hexa \
  --publisher-public-key ~/.hexa/native/keys/hexa-publisher-public.pem

Validar antes do upload

npx @hexapack/native-cli validate \
  --source ./minha-primeira-extensao-hexa \
  --private-key ~/.hexa/native/keys/hexa-publisher-private.pem

Empacotar e assinar

npx @hexapack/native-cli package \
  --source ./minha-primeira-extensao-hexa \
  --out ./dist/minha-primeira-extensao-hexa.hexa \
  --private-key ~/.hexa/native/keys/hexa-publisher-private.pem

O upload no Developer Portal recebe:

• o arquivo .hexa;
• o conteudo do arquivo .hexa.sig no campo Assinatura destacada;
• o mesmo Publisher/public key usado no manifest.

API SDK

import { keygen, initExtension, validateExtension, packageExtension } from '@hexapack/native-cli';

Essas funcoes permitem criar uma interface grafica, CI ou futuro Developer SDK sem depender do Browser.

Publicacao no npm

O guia de release do pacote esta em docs/hexa-native-cli-npm-publish.md.

Resumo para maintainers:

cd packages/hexa-native-cli
npm pack --dry-run
npm publish --access public