npm - @easyflow/javascript-sdk - Versions diffs - 2.1.7 → 2.1.9 - Mend

@easyflow/javascript-sdk 2.1.7 → 2.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (94) hide show

package/README.md +294 -713
package/dist/index.d.ts +421 -0
package/package.json +19 -6
package/.babelrc +0 -5
package/.github/workflows/deploy-sdk-cf.yml +0 -49
package/.github/workflows/release-sdk-cdn.yml +0 -144
package/.github/workflows/release-sdk.yml +0 -112
package/.prettierrc +0 -6
package/CDN-DEPLOYMENT.md +0 -175
package/DEMO.md +0 -258
package/DEPLOYMENT.md +0 -224
package/INTEGRATION-GUIDE.md +0 -521
package/coverage/base.css +0 -224
package/coverage/block-navigation.js +0 -87
package/coverage/easyflow-javascript-sdk/index.html +0 -116
package/coverage/easyflow-javascript-sdk/libs/constants.mjs.html +0 -268
package/coverage/easyflow-javascript-sdk/libs/errors.mjs.html +0 -271
package/coverage/easyflow-javascript-sdk/libs/exception-handler.mjs.html +0 -148
package/coverage/easyflow-javascript-sdk/libs/fingerprint.mjs.html +0 -895
package/coverage/easyflow-javascript-sdk/libs/http.mjs.html +0 -502
package/coverage/easyflow-javascript-sdk/libs/index.html +0 -266
package/coverage/easyflow-javascript-sdk/libs/logger.mjs.html +0 -568
package/coverage/easyflow-javascript-sdk/libs/sanitizer.mjs.html +0 -1099
package/coverage/easyflow-javascript-sdk/libs/security.mjs.html +0 -733
package/coverage/easyflow-javascript-sdk/libs/types.mjs.html +0 -508
package/coverage/easyflow-javascript-sdk/libs/utils.mjs.html +0 -379
package/coverage/easyflow-javascript-sdk/libs/validator.mjs.html +0 -2623
package/coverage/easyflow-javascript-sdk/sdk.mjs.html +0 -2434
package/coverage/favicon.png +0 -0
package/coverage/index.html +0 -131
package/coverage/lcov-report/base.css +0 -224
package/coverage/lcov-report/block-navigation.js +0 -87
package/coverage/lcov-report/easyflow-javascript-sdk/index.html +0 -116
package/coverage/lcov-report/easyflow-javascript-sdk/libs/constants.mjs.html +0 -268
package/coverage/lcov-report/easyflow-javascript-sdk/libs/errors.mjs.html +0 -271
package/coverage/lcov-report/easyflow-javascript-sdk/libs/exception-handler.mjs.html +0 -148
package/coverage/lcov-report/easyflow-javascript-sdk/libs/fingerprint.mjs.html +0 -895
package/coverage/lcov-report/easyflow-javascript-sdk/libs/http.mjs.html +0 -502
package/coverage/lcov-report/easyflow-javascript-sdk/libs/index.html +0 -266
package/coverage/lcov-report/easyflow-javascript-sdk/libs/logger.mjs.html +0 -568
package/coverage/lcov-report/easyflow-javascript-sdk/libs/sanitizer.mjs.html +0 -1099
package/coverage/lcov-report/easyflow-javascript-sdk/libs/security.mjs.html +0 -733
package/coverage/lcov-report/easyflow-javascript-sdk/libs/types.mjs.html +0 -508
package/coverage/lcov-report/easyflow-javascript-sdk/libs/utils.mjs.html +0 -379
package/coverage/lcov-report/easyflow-javascript-sdk/libs/validator.mjs.html +0 -2623
package/coverage/lcov-report/easyflow-javascript-sdk/sdk.mjs.html +0 -2434
package/coverage/lcov-report/favicon.png +0 -0
package/coverage/lcov-report/index.html +0 -131
package/coverage/lcov-report/prettify.css +0 -1
package/coverage/lcov-report/prettify.js +0 -2
package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
package/coverage/lcov-report/sorter.js +0 -196
package/coverage/lcov.info +0 -1429
package/coverage/prettify.css +0 -1
package/coverage/prettify.js +0 -2
package/coverage/sort-arrow-sprite.png +0 -0
package/coverage/sorter.js +0 -196
package/dist/435.easyflow-sdk.min.js +0 -1
package/dist/easyflow-sdk.min.js +0 -1
package/dist/easyflow-sdk.min.js.LICENSE.txt +0 -1
package/dist/index.html +0 -756
package/docs/index.html +0 -775
package/examples/lovable-integration.html +0 -410
package/index.html +0 -981
package/jest.config.js +0 -37
package/jsdoc.json +0 -42
package/libs/auto-integration.mjs +0 -333
package/libs/constants.mjs +0 -61
package/libs/constants.spec.js +0 -198
package/libs/errors.mjs +0 -62
package/libs/errors.spec.js +0 -178
package/libs/exception-handler.mjs +0 -21
package/libs/exception-handler.spec.js +0 -237
package/libs/fingerprint.mjs +0 -270
package/libs/http.mjs +0 -163
package/libs/http.spec.js +0 -427
package/libs/integration-wrapper.mjs +0 -285
package/libs/logger.mjs +0 -161
package/libs/logger.spec.js +0 -389
package/libs/sanitizer.mjs +0 -340
package/libs/sanitizer.spec.js +0 -583
package/libs/security.mjs +0 -217
package/libs/types.mjs +0 -141
package/libs/utils.mjs +0 -368
package/libs/utils.spec.js +0 -231
package/libs/validator.mjs +0 -952
package/libs/validator.spec.js +0 -615
package/mocks/offer.mock.js +0 -77
package/scripts/publish-npm.sh +0 -82
package/sdk.mjs +0 -945
package/sdk.spec.js +0 -796
package/test-setup.cjs +0 -211
package/test.html +0 -154
package/webpack.config.cjs +0 -41

package/.github/workflows/release-sdk.yml DELETED Viewed

@@ -1,112 +0,0 @@
-name: Release Easyflow SDK
-on:
-    push:
-        tags:
-            - 'v*'
-jobs:
-    release:
-        runs-on: ubuntu-latest
-        steps:
-            - name: Checkout do repositório
-              uses: actions/checkout@v4
-            - name: Instalar Node.js
-              uses: actions/setup-node@v4
-              with:
-                  node-version: 20
-                  cache: 'npm'
-            - name: Instalar dependências
-              run: npm install
-            - name: Gerar arquivo de versão
-              run: npm run generate-version
-            - name: Executar testes
-              run: npm test
-            - name: Build do SDK
-              run: npm run build
-            - name: Extrair versão do SDK
-              id: version
-              run: |
-                  VERSION=$(jq -r .version package.json)
-                  echo "VERSION=v$VERSION" >> "$GITHUB_ENV"
-                  echo "version=v$VERSION" >> "$GITHUB_OUTPUT"
-            - name: Copiar arquivo com versão
-              run: |
-                  cp dist/easyflow-sdk.min.js dist/easyflow-sdk.${{ env.VERSION }}.min.js
-            - name: Copiar interface de teste
-              run: |
-                  cp index.html dist/
-                  # Update the script src to use the correct path for production
-                  sed -i 's|./dist/easyflow-sdk.min.js|./easyflow-sdk.min.js|g' dist/index.html
-            - name: Gerar hash de integridade (SRI)
-              id: sri
-              run: |
-                  HASH=$(openssl dgst -sha384 -binary dist/easyflow-sdk.${{ env.VERSION }}.min.js | openssl base64 -A)
-                  echo "SRI=sha384-${HASH}" >> "$GITHUB_ENV"
-                  echo "sha=sha384-${HASH}" >> "$GITHUB_OUTPUT"
-            - name: Criar arquivo de exemplo com SRI
-              run: |
-                  cat > dist/example.html << EOF
-                  <!DOCTYPE html>
-                  <html>
-                  <head>
-                      <title>Easyflow SDK Example</title>
-                  </head>
-                  <body>
-                      <h1>Easyflow SDK v${{ env.VERSION }}</h1>
-                      <script src="easyflow-sdk.${{ env.VERSION }}.min.js"
-                              integrity="${{ env.SRI }}"
-                              crossorigin="anonymous"></script>
-                      <script>
-                          console.log('EasyflowSDK version:', EasyflowSDK.version);
-                      </script>
-                  </body>
-                  </html>
-                  EOF
-            - name: Deploy para Cloudflare Pages
-              uses: cloudflare/pages-action@v1
-              with:
-                  apiToken: ${{ secrets.CF_API_TOKEN }}
-                  accountId: ${{ secrets.CF_ACCOUNT_ID }}
-                  projectName: easyflow-sdk
-                  directory: dist
-            - name: Criar Release no GitHub
-              uses: actions/create-release@v1
-              env:
-                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              with:
-                  tag_name: ${{ github.ref }}
-                  release_name: Easyflow SDK ${{ env.VERSION }}
-                  body: |
-                      ## Easyflow SDK ${{ env.VERSION }}
-                      ### Arquivos
-                      - `easyflow-sdk.${{ env.VERSION }}.min.js` - SDK minificado
-                      - `easyflow-sdk.min.js` - SDK minificado (sem versão)
-                      ### SRI Hash
-                      ```
-                      sha384-${{ env.SRI }}
-                      ```
-                      ### Uso
-                      ```html
-                      <script src="https://easyflow-sdk.pages.dev/easyflow-sdk.${{ env.VERSION }}.min.js"
-                              integrity="sha384-${{ env.SRI }}"
-                              crossorigin="anonymous"></script>
-                      ```
-                  draft: false
-                  prerelease: false

package/.prettierrc DELETED Viewed

@@ -1,6 +0,0 @@
-{
-  "trailingComma": "es5",
-  "tabWidth": 4,
-  "semi": false,
-  "singleQuote": true
-}

package/CDN-DEPLOYMENT.md DELETED Viewed

@@ -1,175 +0,0 @@
-# CDN Deployment Guide
-## Overview
-This guide explains how to deploy the Easyflow JavaScript SDK to CDN and make it available for public consumption.
-## Prerequisites
-- Node.js 18+ installed
-- npm or yarn package manager
-- Git repository access
-- GitHub Pages enabled for the repository
-## Build Process
-### 1. Build the SDK
-```bash
-npm run build
-```
-This command will:
-- Generate version constants
-- Bundle the SDK using Webpack
-- Create minified and obfuscated versions
-- Output files to the `dist/` directory
-### 2. Create Git Tag
-```bash
-git add .
-git commit -m "Release v2.1.6"
-git tag v2.1.6
-git push origin v2.1.6
-```
-### 3. Deploy to GitHub Pages
-The GitHub Actions workflow will automatically:
-- Build the SDK
-- Deploy to GitHub Pages
-- Make it available at `https://easyflow-sdk.pages.dev`
-## CDN URLs
-### GitHub Pages (Primary)
-```html
-<!-- Latest version -->
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
-<!-- Specific version -->
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.6.min.js"></script>
-```
-### NPM CDN (Alternative)
-```html
-<!-- Latest version -->
-<script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk/dist/easyflow-sdk.min.js"></script>
-<!-- Specific version -->
-<script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@2.1.6/dist/easyflow-sdk.min.js"></script>
-```
-## File Structure
-After deployment, the following files will be available:
-```
-https://easyflow-sdk.pages.dev/
-├── easyflow-sdk.min.js          # Latest version
-├── easyflow-sdk.v2.1.6.min.js   # Versioned file
-├── easyflow-sdk.v2.1.5.min.js   # Previous version
-└── ...                          # Other versions
-```
-## Usage Examples
-### Basic Integration
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <title>Easyflow SDK Test</title>
-</head>
-<body>
-    <h1>Easyflow SDK Test</h1>
-    <!-- Load SDK from CDN -->
-    <script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.6.min.js"></script>
-    <script>
-        // SDK is now available as window.easyflowSDK
-        console.log('SDK Version:', window.easyflowSDK.version);
-        // Initialize SDK
-        const sdk = new window.EasyflowSDK({
-            businessId: 'your-business-id'
-        });
-        console.log('SDK initialized:', sdk);
-    </script>
-</body>
-</html>
-```
-### Version-Specific Loading
-```html
-<!-- Load specific version for stability -->
-<script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@2.1.6/dist/easyflow-sdk.min.js"></script>
-```
-## Versioning Strategy
-### Semantic Versioning
-- **Major** (2.x.x): Breaking changes
-- **Minor** (2.1.x): New features, backward compatible
-- **Patch** (2.1.6): Bug fixes, backward compatible
-### Release Process
-1. **Development**: Work on features/fixes
-2. **Testing**: Run full test suite
-3. **Build**: Create production build
-4. **Tag**: Create git tag with version
-5. **Deploy**: Automatic deployment via GitHub Actions
-6. **Document**: Update documentation and examples
-## Troubleshooting
-### Common Issues
-1. **SDK not loading**: Check CDN URL and network connectivity
-2. **Version mismatch**: Ensure using correct version tag
-3. **Build errors**: Check Node.js version and dependencies
-### Debug Mode
-For development, you can use the unminified version:
-```html
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.js"></script>
-```
-## Security Considerations
-- All CDN files are served over HTTPS
-- Files are minified and obfuscated for production
-- Source maps are not included in production builds
-- Regular security audits are performed
-## Monitoring
-- GitHub Pages deployment status
-- CDN performance metrics
-- Error tracking and reporting
-- Usage analytics
-## Support
-For issues with CDN deployment:
-1. Check GitHub Actions workflow status
-2. Verify file availability at CDN URLs
-3. Test with different browsers/devices
-4. Contact development team
----
-**Last Updated**: v2.1.6
-**Next Release**: v2.1.7 (patch) or v2.2.0 (minor)

package/DEMO.md DELETED Viewed

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