@easyflow/javascript-sdk 2.1.8 → 2.1.9

package/DEPLOYMENT.md

@@ -1,224 +0,0 @@
-# 🚀 Deploy e Releases - Easyflow SDK
-
-Este documento explica como funciona o sistema de deploy e releases do Easyflow SDK.
-
-## 📋 Workflows Disponíveis
-
-### 1. Deploy Automático (`deploy-sdk-cf.yml`)
-
-**Trigger:** Push para branch `main`
-
-**O que faz:**
-
-- Instala dependências
-- Executa testes
-- Gera build do SDK
-- Verifica se o build foi gerado
-- Deploy para Cloudflare Pages
-
-**Arquivos gerados:**
-
-- `dist/easyflow-sdk.min.js` - SDK minificado
-
-**URLs de acesso:**
-
-- **Cloudflare Pages**: `https://easyflow-sdk.pages.dev/easyflow-sdk.min.js`
-- **jsDelivr CDN**: `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js` (após publicação no NPM)
-
-### 2. Release com Versionamento (`release-sdk.yml`)
-
-**Trigger:** Push de tag com padrão `v*` (ex: `v2.1.2`)
-
-**O que faz:**
-
-- Instala dependências
-- Executa testes
-- Gera build do SDK
-- Cria arquivo versionado
-- Gera hash SRI (Subresource Integrity)
-- Cria arquivo de exemplo
-- Deploy para Cloudflare Pages
-- Cria release no GitHub
-
-**Arquivos gerados:**
-
-- `dist/easyflow-sdk.min.js` - SDK minificado (sem versão)
-- `dist/easyflow-sdk.v2.1.2.min.js` - SDK versionado
-- `dist/example.html` - Exemplo de uso com SRI
-
-**URLs de acesso:**
-
-- **Cloudflare Pages**:
-    - `https://easyflow-sdk.pages.dev/easyflow-sdk.min.js` (latest)
-    - `https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.2.min.js` (versionado)
-- **jsDelivr CDN** (após publicação no NPM):
-    - `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js` (latest)
-    - `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@2.1.2/dist/easyflow-sdk.min.js` (versionado)
-
-## 🔧 Como Fazer um Release
-
-### 1. Atualizar Versão
-
-```bash
-# Editar package.json
-npm version patch  # 2.1.2 -> 2.1.3
-npm version minor  # 2.1.2 -> 2.2.0
-npm version major  # 2.1.2 -> 3.0.0
-```
-
-### 2. Criar Tag e Push
-
-```bash
-# Criar tag
-git tag v2.1.2
-
-# Push da tag
-git push origin v2.1.2
-```
-
-### 3. Verificar Deploy
-
-- Acesse: https://easyflow-sdk.pages.dev
-- Verifique se o arquivo versionado está disponível
-- Confirme o release no GitHub
-
-## Segurança (SRI)
-
-O workflow de release gera automaticamente hashes SRI para verificação de integridade:
-
-### Cloudflare Pages
-
-```html
-<script
-    src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.2.min.js"
-    integrity="sha384-ABC123..."
-    crossorigin="anonymous"
-></script>
-```
-
-### jsDelivr CDN
-
-```html
-<script
-    src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@2.1.2/dist/easyflow-sdk.min.js"
-    integrity="sha384-ABC123..."
-    crossorigin="anonymous"
-></script>
-```
-
-## 🌐 CDNs Disponíveis
-
-### 1. Cloudflare Pages
-
-- **URL**: `https://easyflow-sdk.pages.dev`
-- **Vantagens**:
-    - Deploy automático via GitHub Actions
-    - Controle total sobre o deploy
-    - Customização completa
-    - SRI hashes automáticos
-
-### 2. jsDelivr CDN
-
-- **URL**: `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk`
-- **Vantagens**:
-    - CDN global com alta performance
-    - Cache inteligente
-    - Disponibilidade automática via NPM
-    - Redundância geográfica
-
-### Como Funciona o jsDelivr
-
-1. **Publicação no NPM**: Execute `npm publish --access public`
-2. **Sincronização**: jsDelivr sincroniza automaticamente com NPM
-3. **Disponibilidade**: SDK fica disponível em ~5 minutos
-4. **Cache Global**: Distribuição automática em CDNs globais
-
-## Configuração de Secrets
-
-Os workflows precisam dos seguintes secrets configurados no GitHub:
-
-- `CF_API_TOKEN` - Token da API do Cloudflare
-- `CF_ACCOUNT_ID` - ID da conta Cloudflare
-
-### Como configurar:
-
-1. Vá para Settings > Secrets and variables > Actions
-2. Adicione os secrets necessários
-3. Configure as permissões do repositório se necessário
-
-## Monitoramento
-
-### Logs de Deploy
-
-- Acesse: https://github.com/easyflow-cash/easyflow-javascript-sdk/actions
-- Verifique os logs de cada workflow
-
-### Status do Cloudflare Pages
-
-- Acesse: https://dash.cloudflare.com
-- Vá para Pages > easyflow-sdk
-- Verifique o status do deploy
-
-## Troubleshooting
-
-### Erro: npm ci falha
-
-**Solução:** O workflow usa `npm install` em vez de `npm ci` para ser mais robusto.
-
-### Erro: Build não encontrado
-
-**Solução:** Verifique se o webpack está configurado corretamente e se não há erros no build.
-
-### Erro: Cloudflare deploy falha
-
-**Solução:**
-
-1. Verifique se os secrets estão configurados
-2. Confirme se o projeto `easyflow-sdk` existe no Cloudflare Pages
-3. Verifique os logs do Cloudflare
-
-### Erro: Release não criado
-
-**Solução:**
-
-1. Verifique se a tag segue o padrão `v*`
-2. Confirme se o `GITHUB_TOKEN` tem permissões para criar releases
-3. Verifique os logs do workflow
-
-## 📝 Exemplos de Uso
-
-### Uso Básico (Latest)
-
-```html
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
-```
-
-### Uso com Versão Específica
-
-```html
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.2.min.js"></script>
-```
-
-### Uso com SRI (Recomendado para Produção)
-
-```html
-<script
-    src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.2.min.js"
-    integrity="sha384-ABC123..."
-    crossorigin="anonymous"
-></script>
-```
-
-## 🔄 Fluxo de Desenvolvimento
-
-1. **Desenvolvimento:** Push para `main` → Deploy automático
-2. **Release:** Tag `v*` → Release versionado
-3. **Hotfix:** Tag `v*` → Release de correção
-
-## 📞 Suporte
-
-Para problemas com deploy:
-
-1. Verifique os logs do GitHub Actions
-2. Consulte a documentação do Cloudflare Pages
-3. Entre em contato com a equipe de DevOps