@easyflow/javascript-sdk 2.1.7

package/DEMO.md

@@ -0,0 +1,258 @@
+# EasyFlow JavaScript SDK - Demonstração Completa
+
+Este arquivo demonstra como usar todas as funcionalidades implementadas no EasyFlow JavaScript SDK, incluindo as novas funcionalidades de gerenciamento de clientes e cartões de crédito.
+
+## 🚀 Inicialização
+
+```javascript
+// Inicializar o SDK
+const sdk = new EasyflowSDK('your-business-id')
+
+// Ou com configuração completa
+const sdk = new EasyflowSDK({
+    businessId: 'your-business-id',
+    additionalOptions: {},
+})
+```
+
+## 👥 Gerenciamento de Clientes
+
+### 1. Criar Cliente
+
+```javascript
+const customer = await sdk.createCustomer({
+    name: 'Diego Moura',
+    email: 'diegomoura637+20@gmail.com',
+    deliveryAddress: {
+        zipCode: '37540114',
+        street: 'Rua Marechal Deodoro',
+        complement: 'Apt',
+        neighborhood: 'Centro',
+        city: 'Pouso Alegre',
+        state: 'MG',
+        number: '33',
+    },
+    address: {
+        zipCode: '37540114',
+        street: 'Rua Marechal Deodoro',
+        complement: 'Apt',
+        neighborhood: 'Centro',
+        city: 'Pouso Alegre',
+        state: 'MG',
+        number: '33',
+    },
+    document: {
+        type: 'CPF',
+        number: '01234567890',
+    },
+    phone: {
+        areaCode: '+55',
+        ddd: '11',
+        number: '998862782',
+        isMobile: true,
+    },
+})
+
+console.log('Cliente criado:', customer.id)
+```
+
+### 2. Buscar Cliente
+
+```javascript
+const customerInfo = await sdk.getCustomer('customer-1234567890123456')
+console.log('Nome:', customerInfo.name)
+console.log('Email:', customerInfo.email)
+console.log('Documento:', customerInfo.document)
+```
+
+### 3. Atualizar Cliente
+
+```javascript
+const updateResult = await sdk.updateCustomer('customer-1234567890123456', {
+    name: 'Diego Moura Atualizado',
+    email: 'diegomoura637+21@gmail.com',
+    phone: {
+        areaCode: '+55',
+        ddd: '11',
+        number: '998862783',
+        isMobile: true,
+    },
+})
+
+console.log('Cliente atualizado:', updateResult.success)
+```
+
+### 4. Listar Clientes
+
+```javascript
+const customers = await sdk.listCustomers(1, 10)
+console.log(`Página ${customers.currentPage} de ${customers.totalPages}`)
+console.log(`Total: ${customers.totalDocs} clientes`)
+
+customers.docs.forEach((customer) => {
+    console.log(`- ${customer.name} (${customer.email})`)
+})
+```
+
+## 💳 Gerenciamento de Cartões de Crédito
+
+### 1. Adicionar Cartão
+
+```javascript
+const cardResult = await sdk.addCreditCard(
+    'customer-1234567890123456',
+    'gGAVbMqIWZD0ftaHEMYSbU+YHVyUPU67ITGsfeawLtg51e7UE/UF4rYferWVjy6OPkJ+ep1B4hDhospUPsskIsXf4i8I9BvJzgwbwPUH8ScbwwDbUIWq0H9gY/7gHrnnQ1SqgNpcrGVhe3wa3mt2ilNOO5LUuIUpo/WbRuWQQUxjibfvLrTlGqBNdUKU/83xVJTSbT4mLxzatwnFVBM7MaT4zDO2IgcRbyjX38iFslJIPP2nFfIVwuIdRbSMIqEH38SHetovGgHaQ58YA1ATN5ksxBFC4qt3jvmtz/dhol/CQhty/4o40h33eQZrJPCrMAcDcbT2obto7L8='
+)
+
+console.log('Cartão adicionado:', cardResult.creditCardId)
+```
+
+### 2. Buscar Cartão
+
+```javascript
+const creditCard = await sdk.getCreditCard(
+    'customer-1234567890123456',
+    '201abf40-e64e-4743-88b9-b5d47830904a'
+)
+
+console.log('Bandeira:', creditCard.brand)
+console.log('Últimos 4 dígitos:', creditCard.last4Numbers)
+console.log(
+    'Expira:',
+    `${creditCard.expiresAtMonth}/${creditCard.expiresAtYear}`
+)
+```
+
+### 3. Atualizar Cartão
+
+```javascript
+const updateCardResult = await sdk.updateCreditCard(
+    '201abf40-e64e-4743-88b9-b5d47830904a',
+    'new-encrypted-token-789'
+)
+
+console.log('Cartão atualizado:', updateCardResult.success)
+```
+
+### 4. Remover Cartão
+
+```javascript
+const removeResult = await sdk.removeCreditCard(
+    'customer-1234567890123456',
+    '201abf40-e64e-4743-88b9-b5d47830904a'
+)
+
+console.log('Cartão removido:', removeResult.success)
+```
+
+### 5. Listar Cartões
+
+```javascript
+const creditCards = await sdk.listCreditCards('customer-1234567890123456')
+
+creditCards.forEach((card) => {
+    console.log(`${card.brand} terminando em ${card.last4Numbers}`)
+    console.log(`Expira: ${card.expiresAtMonth}/${card.expiresAtYear}`)
+    console.log('---')
+})
+```
+
+## 🔐 Headers de Segurança
+
+```javascript
+const secureHeaders = {
+    'x-fingerprint-id': '12345678',
+    'x-recaptcha-token': 'your_recaptcha_token',
+    'ef-signature': 'your_hmac_signature',
+    'x-custom-header': 'custom_value',
+}
+
+// Usar headers em qualquer operação
+const customer = await sdk.createCustomer(customerData, secureHeaders)
+const creditCard = await sdk.addCreditCard(customerId, token, secureHeaders)
+```
+
+## Tratamento de Erros
+
+```javascript
+try {
+    const customer = await sdk.createCustomer(customerData)
+    console.log('Sucesso:', customer.id)
+} catch (error) {
+    if (error instanceof ValidationError) {
+        console.error('Erro de validação:', error.message)
+        console.error('Campo:', error.field)
+    } else if (error instanceof NetworkError) {
+        console.error('Erro de rede:', error.message)
+    } else if (error instanceof SecurityError) {
+        console.error('Erro de segurança:', error.message)
+    } else {
+        console.error('Erro inesperado:', error)
+    }
+}
+```
+
+## 📋 Validações Automáticas
+
+O SDK valida automaticamente todos os dados:
+
+- **Email**: Formato válido e segurança
+- **CPF/CNPJ**: Algoritmo oficial brasileiro
+- **Telefone**: Formato brasileiro com DDD
+- **Endereço**: Estrutura brasileira completa
+- **IDs**: Formato e unicidade
+- **Tokens**: Comprimento e formato
+
+## 🔄 Rate Limiting
+
+O SDK inclui proteção automática contra abuso:
+
+```javascript
+// Cada método tem seu próprio limite
+await sdk.createCustomer(customerData) // Rate limit: createCustomer
+await sdk.getCustomer(customerId) // Rate limit: getCustomer
+await sdk.addCreditCard(customerId, token) // Rate limit: addCreditCard
+```
+
+## 🧪 Testes
+
+Execute os testes para verificar se tudo está funcionando:
+
+```bash
+# Todos os testes
+npm test
+
+# Testes específicos
+npm test -- --testNamePattern="Customer Management"
+npm test -- --testNamePattern="Credit Card Management"
+
+# Cobertura
+npm run test:coverage
+```
+
+## Status dos Testes
+
+- **Total de Testes**: 263
+- **Taxa de Sucesso**: 100%
+- **Cobertura**: Excelente
+- **Funcionalidades**: Todas implementadas
+
+## Próximos Passos
+
+1. **Integração**: Use o SDK em sua aplicação
+2. **Webhooks**: Configure notificações automáticas
+3. **Monitoramento**: Implemente logs e métricas
+4. **Segurança**: Configure headers de segurança
+5. **Produção**: Deploy em ambiente de produção
+
+## 📞 Suporte
+
+- **Documentação**: [docs.easyflow.digital](https://docs.easyflow.digital)
+- **Suporte**: [easyflow.digital/contact](https://easyflow.digital/contact)
+- **Issues**: [GitHub Issues](https://github.com/easyflow-cash/easyflow-javascript-sdk/issues)
+
+---
+
+**EasyFlow JavaScript SDK** - Versão 2.1.4  
+**Última atualização**: Dezembro 2024  
+**Status**: Pronto para produção

package/DEPLOYMENT.md

@@ -0,0 +1,224 @@
+# 🚀 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