@easyflow/javascript-sdk 2.1.10 → 2.1.12

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.12-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)
@@ -12,7 +12,8 @@
 
 **Freedom to sell more, better and longer**
 
-> **Enterprise-grade JavaScript SDK** for integration with the Easyflow payment processing platform with robust validation, comprehensive security and Brazilian compliance
+> **Enterprise-grade JavaScript SDK** for integration with the Easyflow payment processing platform with robust
+> validation, comprehensive security and Brazilian compliance
 
 [![Website](https://img.shields.io/badge/Website-Easyflow.digital-667eea?style=for-the-badge)](https://www.easyflow.digital/)
 [![Start Free](https://img.shields.io/badge/Start_Free-22c55e?style=for-the-badge&logo=rocket&logoColor=white)](https://www.easyflow.digital/)
@@ -22,7 +23,9 @@
 
 ## About Easyflow
 
-[Easyflow](https://www.easyflow.digital/) is a payment platform that **facilitates the sales process** of digital products and services in a simple and intuitive way. Our mission is to transform Digital Commerce by offering a complete sales structure to maximize your LTV.
+[Easyflow](https://www.easyflow.digital/) is a payment platform that **facilitates the sales process** of digital
+products and services in a simple and intuitive way. Our mission is to transform Digital Commerce by offering a complete
+sales structure to maximize your LTV.
 
 ### Why Choose Easyflow?
 
@@ -68,7 +71,8 @@
 
 ## What is the Easyflow JavaScript SDK?
 
-The **Easyflow JavaScript SDK** is the official tool for developers to integrate their applications with the Easyflow platform. With this SDK, you can:
+The **Easyflow JavaScript SDK** is the official tool for developers to integrate their applications with the Easyflow
+platform. With this SDK, you can:
 
 - **Process payments** securely and reliably
 - **Manage customers** with complete Brazilian data validation
@@ -84,7 +88,23 @@ 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.12
+
+### Complete Implementation Examples
+
+- **Full Data Models**: Comprehensive examples for placeOrder, charge, createCustomer, and addCreditCard
+- **Real-World Scenarios**: Complete workflows with all available data fields
+- **Brazilian Data**: Realistic Brazilian addresses, phone numbers, and document formats
+- **End-to-End Workflows**: Complete customer → credit card → order examples
+- **Code Quality**: Improved formatting and consistency across all examples
+
+### 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
 
@@ -95,8 +115,6 @@ The **Easyflow JavaScript SDK** is the official tool for developers to integrate
 
 ### Hybrid Distribution Strategy
 
-### Hybrid Distribution Strategy
-
 - **NPM Package**: Contains only documentation and TypeScript definitions
 - **CDN Scripts**: Production-ready obfuscated builds via Cloudflare Pages
 - **Enhanced Security**: Code source protected while maintaining accessibility
@@ -109,21 +127,6 @@ The **Easyflow JavaScript SDK** is the official tool for developers to integrate
 - **Professional Documentation**: Clean, business-focused documentation
 - **NPM Safety**: Safe for public NPM publication
 
-### Security & Privacy Improvements
-
-- **README Anonymization**: Removed all personal information and sensitive data
-- **Privacy Protection**: No personal emails, URLs, or contact information exposed
-- **Professional Documentation**: Clean, business-focused documentation
-- **NPM Safety**: Safe for public NPM publication
-
-### Test Suite Improvements
-
-- **Test Coverage Optimization**: Fixed all failing unit tests for complete 250 test coverage
-- **Mock Structure Corrections**: Updated test mocks to align with actual API response patterns
-- **Customer Management Tests**: Corrected mock structures for `createCustomer` and `getCustomer` methods
-- **Credit Card Tests**: Fixed mock data structures for `addCreditCard` and `getCreditCard` methods
-- **Consistent Test Patterns**: Standardized mock response structures across all endpoints
-
 ### Test Suite Improvements
 
 - **Test Coverage Optimization**: Fixed all failing unit tests for complete 250 test coverage
@@ -167,7 +170,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.12.min.js"></script>
 ```
 
 #### Option 2: NPM Package (Documentation Only)
@@ -180,37 +183,86 @@ npm install @easyflow/javascript-sdk
 
 #### Option 3: Direct Download
 
-Download the latest obfuscated build from [GitHub Releases](https://github.com/easyflow-cash/easyflow-javascript-sdk/releases).
+Download the latest obfuscated build
+from [GitHub Releases](https://github.com/easyflow-cash/easyflow-javascript-sdk/releases).
 
 ### 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 +289,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 +306,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 +321,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 +332,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 +348,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 +360,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 +368,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 +381,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 +392,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 +403,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 +451,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 +473,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 +502,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 +513,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 +547,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 +562,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,10 +584,370 @@ 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)
 ```
 
+## Complete Implementation Examples
+
+### 1. placeOrder - Complete Data Model
+
+```javascript
+// Configure SDK
+easyflowSDK.configure({
+    businessId: 'demo-business-12345',
+})
+
+// Complete placeOrder example with all available fields
+const orderId = await easyflowSDK.placeOrder('demo-offer-67890', {
+    buyer: {
+        name: 'João Silva Santos',
+        email: 'joao.silva@exemplo.com',
+        document: {
+            number: '12345678901',
+            type: 'CPF',
+        },
+        phone: {
+            areaCode: '+55',
+            ddd: '11',
+            number: '9988776655',
+            isMobile: true,
+        },
+        address: {
+            zipCode: '01234567',
+            street: 'Rua das Flores',
+            complement: 'Apto 101',
+            neighborhood: 'Centro',
+            city: 'São Paulo',
+            state: 'SP',
+            number: '123',
+        },
+        deliveryAddress: {
+            zipCode: '01234567',
+            street: 'Rua das Flores',
+            complement: 'Apto 101',
+            neighborhood: 'Centro',
+            city: 'São Paulo',
+            state: 'SP',
+            number: '123',
+        },
+    },
+    payments: [
+        {
+            method: 'credit-card',
+            numberInstallments: 3,
+            valueInCents: 15000,
+            creditCard: {
+                cardId: 'demo-card-67890',
+            },
+        },
+    ],
+    items: [
+        {
+            name: 'Produto Premium',
+            description: 'Descrição detalhada do produto premium',
+            quantity: 2,
+            priceInCents: 7500,
+            weightInGrams: 500,
+            dimensions: {
+                length: 20,
+                width: 15,
+                height: 10,
+            },
+        },
+    ],
+    metadata: {
+        source: 'website',
+        campaign: 'black-friday-2024',
+        affiliate: 'partner-123',
+    },
+})
+
+console.log('Order created with complete data:', orderId)
+```
+
+### 2. charge - Complete Data Model
+
+```javascript
+// Complete charge example with all available fields
+const orderId = await easyflowSDK.charge({
+    buyer: {
+        name: 'Maria Santos Costa',
+        email: 'maria.costa@exemplo.com',
+        document: {
+            number: '98765432100',
+            type: 'CPF',
+        },
+        phone: {
+            areaCode: '+55',
+            ddd: '21',
+            number: '987654321',
+            isMobile: true,
+        },
+        address: {
+            zipCode: '20000000',
+            street: 'Avenida Rio Branco',
+            complement: 'Sala 1001',
+            neighborhood: 'Centro',
+            city: 'Rio de Janeiro',
+            state: 'RJ',
+            number: '456',
+        },
+        deliveryAddress: {
+            zipCode: '20000000',
+            street: 'Avenida Rio Branco',
+            complement: 'Sala 1001',
+            neighborhood: 'Centro',
+            city: 'Rio de Janeiro',
+            state: 'RJ',
+            number: '456',
+        },
+    },
+    payments: [
+        {
+            method: 'pix',
+            numberInstallments: 1,
+            valueInCents: 25000,
+        },
+        {
+            method: 'bank-billet',
+            numberInstallments: 1,
+            valueInCents: 15000,
+        },
+    ],
+    items: [
+        {
+            name: 'Curso Online',
+            description: 'Curso completo de desenvolvimento web',
+            quantity: 1,
+            priceInCents: 25000,
+            weightInGrams: 0,
+            dimensions: {
+                length: 0,
+                width: 0,
+                height: 0,
+            },
+        },
+        {
+            name: 'E-book Premium',
+            description: 'E-book com estratégias avançadas',
+            quantity: 1,
+            priceInCents: 15000,
+            weightInGrams: 0,
+            dimensions: {
+                length: 0,
+                width: 0,
+                height: 0,
+            },
+        },
+    ],
+    metadata: {
+        source: 'landing-page',
+        campaign: 'curso-web-2024',
+        utm_source: 'google',
+        utm_medium: 'cpc',
+    },
+})
+
+console.log('Charge processed with complete data:', orderId)
+```
+
+### 3. createCustomer - Complete Data Model
+
+```javascript
+// Complete createCustomer example with all available fields
+const customer = await easyflowSDK.createCustomer({
+    businessId: 'demo-business-12345',
+    name: 'Pedro Oliveira Lima',
+    email: 'pedro.oliveira@exemplo.com',
+    document: {
+        type: 'CPF',
+        number: '11122233344',
+    },
+    phone: {
+        areaCode: '+55',
+        ddd: '31',
+        number: '876543210',
+        isMobile: true,
+    },
+    address: {
+        zipCode: '30000000',
+        street: 'Rua da Liberdade',
+        complement: 'Casa',
+        neighborhood: 'Savassi',
+        city: 'Belo Horizonte',
+        state: 'MG',
+        number: '789',
+    },
+    deliveryAddress: {
+        zipCode: '30000000',
+        street: 'Rua da Liberdade',
+        complement: 'Casa',
+        neighborhood: 'Savassi',
+        city: 'Belo Horizonte',
+        state: 'MG',
+        number: '789',
+    },
+    birthDate: '1990-05-15',
+    gender: 'M',
+    maritalStatus: 'single',
+    occupation: 'Desenvolvedor',
+    company: 'Tech Solutions Ltda',
+    website: 'https://pedrooliveira.com',
+    notes: 'Cliente preferencial com histórico de compras',
+    tags: ['premium', 'tech-savvy', 'early-adopter'],
+    preferences: {
+        newsletter: true,
+        marketing: false,
+        language: 'pt-BR',
+        currency: 'BRL',
+    },
+})
+
+console.log('Customer created with complete data:', customer)
+```
+
+### 4. addCreditCard - Complete Data Model
+
+```javascript
+// First, encrypt the credit card data
+const encryptedToken = await easyflowSDK.encrypt({
+    cardNumber: '4111111111111111',
+    cvv: '123',
+    month: '12',
+    year: '2025',
+    holderName: 'PEDRO OLIVEIRA LIMA',
+})
+
+console.log('Credit card encrypted:', encryptedToken)
+
+// Then add the encrypted token to the customer
+const creditCard = await easyflowSDK.addCreditCard(
+    customer.id, // customer ID from createCustomer
+    encryptedToken
+)
+
+console.log('Credit card added successfully:', creditCard)
+
+// Now you can use the credit card for payments
+const orderWithSavedCard = await easyflowSDK.placeOrder('demo-offer-67890', {
+    buyer: {
+        customerId: customer.id, // Use existing customer
+        name: 'Pedro Oliveira Lima',
+        email: 'pedro.oliveira@exemplo.com',
+        document: {
+            number: '11122233344',
+            type: 'CPF',
+        },
+    },
+    payments: [
+        {
+            method: 'credit-card',
+            numberInstallments: 6,
+            valueInCents: 50000,
+            creditCard: {
+                cardId: creditCard.id, // Use saved credit card
+            },
+        },
+    ],
+    items: [
+        {
+            name: 'Produto com Cartão Salvo',
+            description: 'Compra usando cartão salvo anteriormente',
+            quantity: 1,
+            priceInCents: 50000,
+        },
+    ],
+})
+
+console.log('Order with saved credit card:', orderWithSavedCard)
+```
+
+### 5. Complete Workflow Example
+
+```javascript
+// Complete workflow: Customer → Credit Card → Order
+async function completeWorkflow() {
+    try {
+        // 1. Configure SDK
+        easyflowSDK.configure({
+            businessId: 'demo-business-12345',
+        })
+
+        // 2. Create customer with complete data
+        const customer = await easyflowSDK.createCustomer({
+            businessId: 'demo-business-12345',
+            name: 'Ana Silva Costa',
+            email: 'ana.silva@exemplo.com',
+            document: { type: 'CPF', number: '55566677788' },
+            phone: {
+                areaCode: '+55',
+                ddd: '41',
+                number: '765432109',
+                isMobile: true,
+            },
+            address: {
+                zipCode: '80000000',
+                street: 'Rua das Palmeiras',
+                complement: 'Apto 202',
+                neighborhood: 'Batel',
+                city: 'Curitiba',
+                state: 'PR',
+                number: '321',
+            },
+        })
+
+        // 3. Encrypt and add credit card
+        const token = await easyflowSDK.encrypt({
+            cardNumber: '5555555555554444',
+            cvv: '321',
+            month: '10',
+            year: '2026',
+            holderName: 'ANA SILVA COSTA',
+        })
+
+        const creditCard = await easyflowSDK.addCreditCard(customer.id, token)
+
+        // 4. Create order using saved customer and credit card
+        const orderId = await easyflowSDK.placeOrder('demo-offer-67890', {
+            buyer: {
+                customerId: customer.id,
+                name: customer.name,
+                email: customer.email,
+                document: customer.document,
+            },
+            payments: [
+                {
+                    method: 'credit-card',
+                    numberInstallments: 12,
+                    valueInCents: 120000,
+                    creditCard: { cardId: creditCard.id },
+                },
+            ],
+            items: [
+                {
+                    name: 'Pacote Premium Anual',
+                    description: 'Acesso completo por 12 meses',
+                    quantity: 1,
+                    priceInCents: 120000,
+                },
+            ],
+        })
+
+        console.log('Complete workflow successful:', {
+            customer: customer.id,
+            creditCard: creditCard.id,
+            order: orderId,
+        })
+    } catch (error) {
+        console.error('Workflow failed:', error.message)
+    }
+}
+
+// Execute the complete workflow
+completeWorkflow()
+```
+
 ## Distribution & Security
 
 ### Why CDN Scripts?
@@ -534,7 +968,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.12.min.js"
     integrity="sha384-[hash]"
     crossorigin="anonymous"
 ></script>
@@ -555,7 +989,8 @@ We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) f
 ## Support
 
 - **Documentation**: [https://docs.easyflow.digital](https://docs.easyflow.digital)
-- **GitHub Issues**: [https://github.com/easyflow-cash/easyflow-javascript-sdk/issues](https://github.com/easyflow-cash/easyflow-javascript-sdk/issues)
+- **GitHub Issues
+  **: [https://github.com/easyflow-cash/easyflow-javascript-sdk/issues](https://github.com/easyflow-cash/easyflow-javascript-sdk/issues)
 - **Website**: [https://www.easyflow.digital](https://www.easyflow.digital)
 
 ## License
@@ -564,6 +999,23 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Changelog
 
+### v2.1.12
+
+- **Complete Implementation Examples**: Added comprehensive examples for all major methods
+- **Full Data Models**: Examples showing all available fields for placeOrder, charge, createCustomer, addCreditCard
+- **Brazilian Data Examples**: Realistic Brazilian addresses, phone numbers, and document formats
+- **End-to-End Workflows**: Complete customer → credit card → order workflow examples
+- **Code Quality**: Improved formatting, consistency, and readability across all examples
+- **Documentation**: Fixed duplicate sections and improved overall structure
+
+### 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.12",
     "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",