@stencitecnologia/app-kit

Core utilities para aplicações Vue da Stenci (HTTP client, storage, errors, context, validation e utils).

📦 Instalação (consumidor)

npm install @stencitecnologia/app-kit

🚀 Fluxo de Release (gerar versão, compilar e publicar)

Este pacote segue o fluxo padrão NPM com versionamento semântico.

1️⃣ Entrar na pasta do projeto

cd stenci-app-kit

Confirme que você está na pasta correta:

ls

Deve existir:

src/
package.json
vite.config.js

2️⃣ Instalar dependências

npm install

3️⃣ Gerar nova versão

Sempre que fizer alterações no código:

Correções pequenas (mais comum)

npm version patch

Exemplo:

0.1.0 → 0.1.1

Novas funcionalidades

npm version minor

Mudanças que quebram compatibilidade

npm version major

O comando npm version:

• Atualiza o package.json
• Cria commit Git automático
• Cria tag Git automática

⚠️ Se aparecer erro Git working directory not clean, faça:

git add -A
git commit -m "chore: release"

4️⃣ Compilar o pacote

npm run build

Resultado esperado:

dist/
  index.es.js
  index.cjs

5️⃣ Validar antes de publicar (recomendado)

npm pack

Isso gera um arquivo .tgz local com o conteúdo que será publicado.

Verifique se contém:

dist/
package.json

6️⃣ Login no NPM

Se não estiver logado ou o token expirou:

npm logout
npm login

Validar login:

npm whoami

7️⃣ Publicar no NPM

Primeira publicação (pacote com scope):

npm publish --access public

Publicações futuras:

npm publish

O script prepack executa automaticamente o build antes do publish.

🔄 Atualizar no projeto consumidor

Depois de publicar nova versão:

npm update @stencitecnologia/app-kit

ou:

npm install @stencitecnologia/app-kit@latest

🧪 Desenvolvimento local (opcional)

Para testar sem publicar:

npm link

No consumidor:

npm link @stencitecnologia/app-kit

⚠️ Problemas comuns

Pacote não encontrado (404)

O pacote ainda não foi publicado ou o nome está incorreto.

Verificar:

npm view @stencitecnologia/app-kit version

Token expirado

npm logout
npm login

Versão já existe

Você esqueceu de atualizar a versão:

npm version patch
npm publish

📁 Estrutura do projeto

src/
  constants/
  core/
  errors/
  http/
  storage/
  utils/
  validation/
    validators/
  index.js

dist/
vite.config.js
package.json

🏁 Resultado esperado

Após publicar, o pacote estará disponível em:

https://www.npmjs.com/package/@stencitecnologia/app-kit

📄 Licença

MIT — Stenci Tecnologia