@easyflow/javascript-sdk 2.1.10 → 2.1.11

package/README.md

@@ -1,7 +1,7 @@
 # Easyflow JavaScript SDK
 
 [![Build Status](https://github.com/easyflow-cash/easyflow-javascript-sdk/workflows/Build%20&%20Deploy%20Easyflow%20SDK/badge.svg)](https://github.com/easyflow-cash/easyflow-javascript-sdk/actions)
-[![Version](https://img.shields.io/badge/version-2.1.10-blue.svg)](https://easyflow-sdk.pages.dev)
+[![Version](https://img.shields.io/badge/version-2.1.11-blue.svg)](https://easyflow-sdk.pages.dev)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Tests](https://img.shields.io/badge/tests-250%20passing-brightgreen.svg)](https://github.com/easyflow-cash/easyflow-javascript-sdk)
 [![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen.svg)](https://github.com/easyflow-cash/easyflow-javascript-sdk)
@@ -84,7 +84,17 @@ The **Easyflow JavaScript SDK** is the official tool for developers to integrate
 - **High Performance**: Optimized for production
 - **Complete Documentation**: Practical examples for all use cases
 
-## What's New in v2.1.10
+## What's New in v2.1.11
+
+### Credit Card Token Validation Fix
+
+- **Real Token Support**: Now accepts real encrypted/ciphered credit card tokens
+- **Flexible Format**: Supports Base64, URL-safe, and mixed character tokens
+- **Variable Length**: Accepts tokens from 16 to 2048 characters
+- **Enhanced Security**: Maintains security while accepting real-world tokens
+- **Backward Compatibility**: Works with all existing token formats
+
+### Workflow Corrections
 
 ### Workflow Corrections
 
@@ -167,7 +177,7 @@ Add this script tag to your HTML:
 <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.10.min.js"></script>
+<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.11.min.js"></script>
 ```
 
 #### Option 2: NPM Package (Documentation Only)
@@ -184,33 +194,81 @@ Download the latest obfuscated build from [GitHub Releases](https://github.com/e
 
 ### Basic Usage
 
-```javascript
-import { EasyflowSDK } from '@easyflow/javascript-sdk'
+#### Method 1: CDN Script (Recommended for Production)
 
-// Initialize SDK
-const sdk = new EasyflowSDK({
-    businessId: 'your-business-id',
-})
+```html
+<!-- Load SDK via script tag -->
+<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
 
-// Process a payment
-const orderId = await sdk.placeOrder('offer-id', {
-    customer: {
-        name: 'John Doe',
-        email: 'john@example.com',
-        document: {
-            type: 'CPF',
-            number: '12345678901',
-        },
-    },
-    payments: [
-        {
-            method: 'credit-card',
-            numberInstallments: 1,
-        },
-    ],
-})
+<script>
+    // Configure the global instance
+    easyflowSDK.configure({
+        businessId: 'demo-business-12345',
+    })
+
+    // Process a payment
+    easyflowSDK
+        .placeOrder('demo-offer-67890', {
+            customer: {
+                name: 'João Silva',
+                email: 'joao@exemplo.com',
+                document: {
+                    type: 'CPF',
+                    number: '12345678901',
+                },
+            },
+            payments: [
+                {
+                    method: 'credit-card',
+                    numberInstallments: 1,
+                },
+            ],
+        })
+        .then((orderId) => {
+            console.log('Pedido criado:', orderId)
+        })
+        .catch((error) => {
+            console.error('Erro ao criar pedido:', error.message)
+        })
+</script>
+```
 
-console.log('Order created:', orderId)
+#### Method 2: Global Instance (For Low-Code Platforms & Simple HTML)
+
+```html
+<!-- Load SDK via script tag -->
+<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
+
+<script>
+    // Configure the global instance
+    easyflowSDK.configure({
+        businessId: 'demo-business-12345',
+    })
+
+    // Now you can use all methods directly
+    easyflowSDK
+        .createCustomer({
+            name: 'Maria Silva',
+            email: 'maria@exemplo.com',
+            document: { type: 'CPF', number: '12345678901' },
+        })
+        .then((customer) => {
+            console.log('Cliente criado:', customer)
+        })
+        .catch((error) => {
+            console.error('Erro ao criar cliente:', error.message)
+        })
+
+    // Validation methods are always available
+    if (easyflowSDK.validate.email('teste@exemplo.com')) {
+        console.log('Email válido!')
+    }
+
+    // Listen to events
+    easyflowSDK.on('customerCreated', (data) => {
+        console.log('Evento cliente criado:', data)
+    })
+</script>
 ```
 
 ## Features
@@ -237,6 +295,14 @@ console.log('Order created:', orderId)
 - **Obfuscated Builds**: Production builds are obfuscated for enhanced security
 - **Controlled Distribution**: Secure distribution via CDN and GitHub Releases
 
+### Low-Code Platform Support
+
+- **Lovable Integration**: Full compatibility with Lovable platform
+- **Global Instance**: `window.easyflowSDK` for easy integration
+- **Event System**: Built-in event handling for `on()` and `off()`
+- **Validation Methods**: Always available validation functions
+- **Configuration**: Simple setup with `easyflowSDK.configure()`
+
 ## API Reference
 
 ### Core Methods
@@ -246,13 +312,13 @@ console.log('Order created:', orderId)
 Creates an order using an existing offer.
 
 ```javascript
-const orderId = await sdk.placeOrder('offer-id', {
+const orderId = await easyflowSDK.placeOrder('demo-offer-67890', {
     customer: {
-        /* customer data */
+        name: 'João Silva',
+        email: 'joao@exemplo.com',
+        document: { type: 'CPF', number: '12345678901' },
     },
-    payments: [
-        /* payment methods */
-    ],
+    payments: [{ method: 'credit-card', numberInstallments: 1 }],
 })
 ```
 
@@ -261,8 +327,8 @@ const orderId = await sdk.placeOrder('offer-id', {
 Processes a direct charge without using an offer.
 
 ```javascript
-const orderId = await sdk.charge({
-    items: [{ name: 'Product', price: 1000 }],
+const orderId = await easyflowSDK.charge({
+    items: [{ name: 'Produto Demo', price: 1000 }],
     payments: [{ method: 'pix', numberInstallments: 1 }],
 })
 ```
@@ -272,9 +338,9 @@ const orderId = await sdk.charge({
 Encrypts credit card data for secure processing.
 
 ```javascript
-const token = await sdk.encrypt({
+const token = await easyflowSDK.encrypt({
     number: '4111111111111111',
-    holderName: 'John Doe',
+    holderName: 'João Silva',
     expirationMonth: '12',
     expirationYear: '2025',
     cvv: '123',
@@ -288,9 +354,9 @@ const token = await sdk.encrypt({
 Creates a new customer.
 
 ```javascript
-const customer = await sdk.createCustomer({
-    name: 'John Doe',
-    email: 'john@example.com',
+const customer = await easyflowSDK.createCustomer({
+    name: 'João Silva',
+    email: 'joao@exemplo.com',
     document: { type: 'CPF', number: '12345678901' },
 })
 ```
@@ -300,7 +366,7 @@ const customer = await sdk.createCustomer({
 Retrieves customer information.
 
 ```javascript
-const customer = await sdk.getCustomer('customer-id')
+const customer = await easyflowSDK.getCustomer('demo-customer-12345')
 ```
 
 #### `updateCustomer(customerId, updateData, headers)`
@@ -308,9 +374,9 @@ const customer = await sdk.getCustomer('customer-id')
 Updates existing customer information.
 
 ```javascript
-const result = await sdk.updateCustomer('customer-id', {
-    name: 'John Updated',
-    email: 'john.updated@example.com',
+const result = await easyflowSDK.updateCustomer('demo-customer-12345', {
+    name: 'João Atualizado',
+    email: 'joao.atualizado@exemplo.com',
 })
 ```
 
@@ -321,7 +387,10 @@ const result = await sdk.updateCustomer('customer-id', {
 Adds a credit card to a customer.
 
 ```javascript
-const result = await sdk.addCreditCard('customer-id', 'encrypted-token')
+const result = await easyflowSDK.addCreditCard(
+    'demo-customer-12345',
+    'encrypted-token-demo'
+)
 ```
 
 #### `getCreditCard(customerId, creditCardId, headers)`
@@ -329,7 +398,10 @@ const result = await sdk.addCreditCard('customer-id', 'encrypted-token')
 Retrieves credit card information.
 
 ```javascript
-const creditCard = await sdk.getCreditCard('customer-id', 'credit-card-id')
+const creditCard = await easyflowSDK.getCreditCard(
+    'demo-customer-12345',
+    'demo-card-67890'
+)
 ```
 
 #### `removeCreditCard(customerId, creditCardId, headers)`
@@ -337,7 +409,10 @@ const creditCard = await sdk.getCreditCard('customer-id', 'credit-card-id')
 Removes a credit card from a customer.
 
 ```javascript
-const result = await sdk.removeCreditCard('customer-id', 'credit-card-id')
+const result = await easyflowSDK.removeCreditCard(
+    'demo-customer-12345',
+    'demo-card-67890'
+)
 ```
 
 ## Validation
@@ -382,20 +457,20 @@ The SDK provides an event system for monitoring operations:
 
 ```javascript
 // Listen to events
-sdk.on('customerCreated', (data) => {
-    console.log('Customer created:', data)
+easyflowSDK.on('customerCreated', (data) => {
+    console.log('Cliente criado:', data)
 })
 
-sdk.on('orderPlaced', (data) => {
-    console.log('Order placed:', data)
+easyflowSDK.on('orderPlaced', (data) => {
+    console.log('Pedido criado:', data)
 })
 
-sdk.on('paymentProcessed', (data) => {
-    console.log('Payment processed:', data)
+easyflowSDK.on('paymentProcessed', (data) => {
+    console.log('Pagamento processado:', data)
 })
 
 // Remove event listeners
-sdk.off('customerCreated', callback)
+easyflowSDK.off('customerCreated', callback)
 ```
 
 ## Error Handling
@@ -404,25 +479,26 @@ The SDK provides comprehensive error handling:
 
 ```javascript
 try {
-    const result = await sdk.placeOrder('offer-id', orderData)
+    const result = await easyflowSDK.placeOrder('demo-offer-67890', orderData)
 } catch (error) {
     if (error.name === 'ValidationError') {
-        console.log('Validation failed:', error.message)
+        console.log('Falha na validação:', error.message)
     } else if (error.name === 'NetworkError') {
-        console.log('Network error:', error.message)
+        console.log('Erro de rede:', error.message)
     } else if (error.name === 'SecurityError') {
-        console.log('Security violation:', error.message)
+        console.log('Violação de segurança:', error.message)
     }
 }
 ```
 
 ## Configuration
 
-### SDK Options
+### SDK Options (CDN Implementation)
 
 ```javascript
-const sdk = new EasyflowSDK({
-    businessId: 'your-business-id',
+// Configure the global instance
+easyflowSDK.configure({
+    businessId: 'demo-business-12345',
     environment: 'production', // 'production' or 'sandbox'
     debug: false, // Enable debug logging
     timeout: 30000, // Request timeout in milliseconds
@@ -432,7 +508,7 @@ const sdk = new EasyflowSDK({
 ### Environment Variables
 
 ```bash
-EASYFLOW_BUSINESS_ID=your-business-id
+EASYFLOW_BUSINESS_ID=demo-business-12345
 EASYFLOW_ENVIRONMENT=production
 EASYFLOW_DEBUG=false
 ```
@@ -443,26 +519,26 @@ EASYFLOW_DEBUG=false
 
 ```javascript
 // 1. Create customer
-const customer = await sdk.createCustomer({
-    name: 'John Doe',
-    email: 'john@example.com',
+const customer = await easyflowSDK.createCustomer({
+    name: 'João Silva',
+    email: 'joao@exemplo.com',
     document: { type: 'CPF', number: '12345678901' },
 })
 
 // 2. Encrypt credit card
-const token = await sdk.encrypt({
+const token = await easyflowSDK.encrypt({
     number: '4111111111111111',
-    holderName: 'John Doe',
+    holderName: 'João Silva',
     expirationMonth: '12',
     expirationYear: '2025',
     cvv: '123',
 })
 
 // 3. Add credit card to customer
-const creditCard = await sdk.addCreditCard(customer.id, token)
+const creditCard = await easyflowSDK.addCreditCard(customer.id, token)
 
 // 4. Place order
-const orderId = await sdk.placeOrder('offer-id', {
+const orderId = await easyflowSDK.placeOrder('demo-offer-67890', {
     customer: customer,
     payments: [
         {
@@ -477,9 +553,11 @@ const orderId = await sdk.placeOrder('offer-id', {
 ### PIX Payment
 
 ```javascript
-const orderId = await sdk.placeOrder('offer-id', {
+const orderId = await easyflowSDK.placeOrder('demo-offer-67890', {
     customer: {
-        /* customer data */
+        name: 'Maria Santos',
+        email: 'maria@exemplo.com',
+        document: { type: 'CPF', number: '98765432100' },
     },
     payments: [
         {
@@ -490,16 +568,18 @@ const orderId = await sdk.placeOrder('offer-id', {
 })
 
 // Get PIX data
-const pixData = await sdk.getPix(orderId)
+const pixData = await easyflowSDK.getPix(orderId)
 console.log('PIX QR Code:', pixData.qrCode)
 ```
 
 ### Bank Billet Payment
 
 ```javascript
-const orderId = await sdk.placeOrder('offer-id', {
+const orderId = await easyflowSDK.placeOrder('demo-offer-67890', {
     customer: {
-        /* customer data */
+        name: 'Pedro Costa',
+        email: 'pedro@exemplo.com',
+        document: { type: 'CPF', number: '11122233344' },
     },
     payments: [
         {
@@ -510,7 +590,7 @@ const orderId = await sdk.placeOrder('offer-id', {
 })
 
 // Get bank billet data
-const bankBillet = await sdk.getBankBillet(orderId)
+const bankBillet = await easyflowSDK.getBankBillet(orderId)
 console.log('Bank Billet Link:', bankBillet.link)
 ```
 
@@ -534,7 +614,7 @@ console.log('Bank Billet Link:', bankBillet.link)
 
 <!-- With SRI (Subresource Integrity) -->
 <script
-    src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.10.min.js"
+    src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.11.min.js"
     integrity="sha384-[hash]"
     crossorigin="anonymous"
 ></script>
@@ -564,6 +644,14 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Changelog
 
+### v2.1.11
+
+- **Credit Card Token Fix**: Accepts real encrypted/ciphered tokens from vault services
+- **Flexible Validation**: Supports Base64, URL-safe, and mixed character formats
+- **Variable Length**: Accepts tokens from 16 to 2048 characters
+- **Enhanced Security**: Maintains security while accepting real-world tokens
+- **Backward Compatibility**: Works with all existing token formats
+
 ### v2.1.10
 
 - **Workflow Fixed**: Resolved GitHub Actions permissions and SRI hash generation

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@easyflow/javascript-sdk",
-    "version": "2.1.10",
+    "version": "2.1.11",
     "description": "Easyflow JavaScript SDK - Documentation and TypeScript definitions. For production use, use the CDN script: https://easyflow-sdk.pages.dev/easyflow-sdk.min.js",
     "main": "README.md",
     "module": "README.md",