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

@easyflow/javascript-sdk 2.1.7

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 (93) hide show

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

package/.babelrc ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "presets": [
+    "@babel/preset-env"
+  ]
+}

package/.github/workflows/deploy-sdk-cf.yml ADDED Viewed

@@ -0,0 +1,49 @@
+name: Deploy Easyflow SDK to Cloudflare Pages
+on:
+    push:
+        branches: [main]
+    workflow_dispatch:
+jobs:
+    build-and-deploy:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+            - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: '18'
+                  cache: 'npm'
+            - name: Install dependencies
+              run: npm ci
+            - name: Build SDK
+              run: npm run build
+            - name: Copy Documentation to Build
+              run: |
+                  # Copiar apenas o index.html da documentação
+                  cp docs/index.html dist/
+                  echo "📚 Documentação copiada para build (apenas index.html)"
+            - name: Deploy to Cloudflare Pages
+              uses: cloudflare/pages-action@v1
+              with:
+                  apiToken: ${{ secrets.CF_API_TOKEN }}
+                  accountId: ${{ secrets.CF_ACCOUNT_ID }}
+                  projectName: easyflow-sdk
+                  directory: dist
+            - name: Success Message
+              run: |
+                  echo "🚀 SDK e Documentação Deployados com sucesso!"
+                  echo "📦 SDK + Docs: https://easyflow-sdk.pages.dev"
+                  echo "🌐 jsDelivr: https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js"
+                  echo ""
+                  echo "✅ Documentação agora está disponível em:"
+                  echo "   https://easyflow-sdk.pages.dev"

package/.github/workflows/release-sdk-cdn.yml ADDED Viewed

@@ -0,0 +1,144 @@
+name: Release Easyflow SDK - Multi-CDN
+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: Verificar disponibilidade no jsDelivr
+              run: |
+                  echo "Verificando disponibilidade no jsDelivr..."
+                  echo "URL: https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@${{ env.VERSION }}/dist/easyflow-sdk.min.js"
+                  echo "Note: jsDelivr pode levar alguns minutos para sincronizar com npm"
+            - 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 }}
+                      ### CDNs Disponíveis
+                      #### Cloudflare Pages
+                      - **Latest**: `https://easyflow-sdk.pages.dev/easyflow-sdk.min.js`
+                      - **Versionado**: `https://easyflow-sdk.pages.dev/easyflow-sdk.${{ env.VERSION }}.min.js`
+                      #### jsDelivr CDN
+                      - **Latest**: `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js`
+                      - **Versionado**: `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@${{ env.VERSION }}/dist/easyflow-sdk.min.js`
+                      ### SRI Hash
+                      ```
+                      sha384-${{ env.SRI }}
+                      ```
+                      ### Exemplo de Uso
+                      #### Cloudflare Pages
+                      ```html
+                      <script src="https://easyflow-sdk.pages.dev/easyflow-sdk.${{ env.VERSION }}.min.js"
+                              integrity="sha384-${{ env.SRI }}"
+                              crossorigin="anonymous"></script>
+                      ```
+                      #### jsDelivr CDN
+                      ```html
+                      <script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@${{ env.VERSION }}/dist/easyflow-sdk.min.js"
+                              integrity="sha384-${{ env.SRI }}"
+                              crossorigin="anonymous"></script>
+                      ```
+                      ### Arquivos
+                      - `easyflow-sdk.${{ env.VERSION }}.min.js` - SDK minificado
+                      - `easyflow-sdk.min.js` - SDK minificado (sem versão)
+                      - `example.html` - Exemplo de uso com SRI
+                  draft: false
+                  prerelease: false
+            - name: Publicar no NPM (se necessário)
+              run: |
+                  echo "Para publicar no NPM, execute manualmente:"
+                  echo "npm publish --access public"
+                  echo "Isso tornará o SDK disponível no jsDelivr automaticamente"

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

@@ -0,0 +1,112 @@
+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 ADDED Viewed

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

package/CDN-DEPLOYMENT.md ADDED Viewed

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