@easyflow/javascript-sdk 2.1.7 → 2.1.9

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.7-blue.svg)](https://easyflow-sdk.pages.dev)
+[![Version](https://img.shields.io/badge/version-2.1.9-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,36 @@ 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.7
+## What's New in v2.1.9
+
+### 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
+- **Better UX**: Easy discovery via NPM, secure usage via CDN
+
+### 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
+
+### 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
 
@@ -109,12 +138,6 @@ The **Easyflow JavaScript SDK** is the official tool for developers to integrate
 - **MongoDB ObjectId**: 24-character hexadecimal format `507f1f77bcf86cd799439011`
 - **Strict Validation**: Rejects any other formats for enhanced security
 
-### ID Validation Corrections
-
-- **UUID v4 Validation**: All entity IDs (order, offer, customer, credit card) now use proper UUID v4 validation instead of incorrect format patterns
-- **Consistent Validation**: Standardized validation across all ID types with proper error messages
-- **Improved Security**: More robust ID validation prevents format-based attacks
-
 ### Lovable Integration Fixes
 
 - **Event System Implementation**: Complete event system with `on()` and `off()` methods
@@ -122,196 +145,57 @@ The **Easyflow JavaScript SDK** is the official tool for developers to integrate
 - **Global Instance**: `window.easyflowSDK` instance with all methods and events
 - **Event Emissions**: Automatic events for `customerCreated`, `orderPlaced`, and `paymentProcessed`
 
-### What's New in v2.1.4
-
-### New Customer Management Features
-
-- **Complete Customer CRUD**: Create, read, and update customers
-- **Brazilian Data Validation**: Full validation for CPF/CNPJ, phone, address
-- **Address Management**: Support for delivery and billing addresses
-- **Phone Number Support**: Brazilian DDD format with international support
-
-### Advanced Credit Card Management
-
-- **Credit Card Operations**: Add, remove, and get credit cards
-- **Secure Token Handling**: Encrypted credit card token management
-- **Customer Association**: Link credit cards to specific customers
-- **Card Information Retrieval**: Get detailed credit card information
-
-### Enhanced HTTP Helper
-
-- **Query Parameter Support**: Proper handling of URL parameters
-- **Target-Specific Logic**: Optimized API calls for each endpoint
-- **Parameter Separation**: Clean separation of body and query data
-- **URL Building**: Dynamic URL construction with parameters
-
-### Enhanced Security & Validation
-
-- **Robust Input Validation**: 15+ validation methods for all data types
-- **Brazilian Compliance**: CPF/CNPJ validation with official algorithms
-- **Address Validation**: Complete Brazilian address structure validation
-- **Phone Validation**: International + Brazilian DDD format support
-- **Email Security**: Advanced email validation with security checks
-
-### Advanced Data Protection
-
-- **Recursive Sanitization**: Deep object sanitization with circular reference protection
-- **XSS Prevention**: Enhanced sanitization preserving legitimate quotes
-- **Protocol Filtering**: Protection against dangerous protocols
-- **Input Length Validation**: Comprehensive length and format validation
-
-### Improved Testing & Quality
-
-- **256 Tests Passing**: 100% test success rate
-- **Comprehensive Validation Tests**: All new validation methods tested
-- **Mock System**: Robust mocking for reliable testing
-- **Error Handling**: Enhanced error scenarios coverage
-
-## Key Features
-
-- **Enterprise Security**: Multi-layered security framework
-- **Brazilian Compliance**: CPF, CNPJ, phone, address validation
-- **Multi-Payment**: Credit card, PIX, bank billet support
-- **Customer Management**: Complete CRM functionality with CRUD operations
-- **Credit Card Management**: Secure add, remove, and get operations
-- **Address Management**: Support for delivery and billing addresses
-- **Phone Validation**: Brazilian DDD format with international support
-- **High Performance**: Optimized for production use
-- **PCI DSS Ready**: Payment industry compliance
-- **Comprehensive Docs**: Complete API documentation
-
 ## Quick Start
 
-### 1. Include the SDK
+### Installation
+
+#### Option 1: CDN Script (Recommended)
 
-#### Cloudflare Pages CDN (Recommended)
+Add this script tag to your HTML:
 
 ```html
 <!-- Latest version -->
 <script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
-```
-
-#### jsDelivr CDN
 
-```html
-<!-- Latest version -->
-<script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk"></script>
+<!-- Specific version -->
+<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.9.min.js"></script>
 ```
 
-### 2. NO BRAINER Integration
-
-#### For Low-Code/No-Code Platforms (Lovable, Bubble, Webflow, etc.)
-
-The SDK configures **automatically** and exposes all functionalities:
-
-```javascript
-// Functionalities available automatically
-window.easyflowSDK = {
-    // Customers
-    createCustomer: function (data) {
-        /* ... */
-    },
-    getCustomer: function (id) {
-        /* ... */
-    },
-    updateCustomer: function (id, data) {
-        /* ... */
-    },
-
-    // Payments
-    placeOrder: function (offerId, data) {
-        /* ... */
-    },
-    charge: function (data) {
-        /* ... */
-    },
+#### Option 2: NPM Package (Documentation Only)
 
-    // Validation
-    validate: {
-        email: function (email) {
-            /* ... */
-        },
-    },
+```bash
+npm install @easyflow/javascript-sdk
+```
 
-    // Event callbacks
-    on: function (event, callback) {
-        /* ... */
-    },
-}
+**Note**: The NPM package contains only documentation. For production use, use the CDN script above.
 
-// Configure callbacks for events
-easyflowSDK.on('customerCreated', function (customer) {
-    console.log('Customer created:', customer)
-    // Update platform UI
-})
+#### Option 3: Direct Download
 
-easyflowSDK.on('paymentProcessed', function (result) {
-    console.log('Payment processed:', result)
-    // Redirect or update status
-})
-```
+Download the latest obfuscated build from [GitHub Releases](https://github.com/easyflow-cash/easyflow-javascript-sdk/releases).
 
-#### For Traditional Developers
+### Basic Usage
 
 ```javascript
-// Traditional initialization
-const sdk = new EasyflowSDK('your-business-id')
+import { EasyflowSDK } from '@easyflow/javascript-sdk'
 
-// Or use the integration wrapper
-const wrapper = EasyflowSDK.initializeForPlatform({
+// Initialize SDK
+const sdk = new EasyflowSDK({
     businessId: 'your-business-id',
-    enableDebug: true,
 })
-```
 
-### Public Documentation
-
-**Complete documentation available at:** [https://easyflow-sdk.pages.dev](https://easyflow-sdk.pages.dev)
-
-- **Quick Start** - Integration in 3 steps
-- **API Reference** - All methods and parameters
-- **Practical Examples** - Ready-to-use code
-- **Supported Platforms** - Lovable, Bubble, Webflow, Zapier
-- **Troubleshooting** - Solutions for common problems
-
-### 3. Process Payment with Full Validation
-
-```javascript
-// Create order with comprehensive validation
-const orderId = await sdk.placeOrder('f47ac10b-58cc-4372-a567-0e02b2c3d479', {
-    buyer: {
-        name: 'João Silva',
-        email: 'joao@exemplo.com',
+// Process a payment
+const orderId = await sdk.placeOrder('offer-id', {
+    customer: {
+        name: 'John Doe',
+        email: 'john@example.com',
         document: {
             type: 'CPF',
-            number: '12345678909', // Only digits, no formatting
-        },
-        phone: {
-            areaCode: '+55',
-            ddd: '11',
-            number: '999999999', // Only digits
-            isMobile: true,
-        },
-        address: {
-            zipCode: '01234567', // Only digits, no hyphens
-            street: 'Rua das Flores',
-            number: '123',
-            complement: 'Apto 45',
-            neighborhood: 'Centro',
-            city: 'São Paulo',
-            state: 'SP', // Validated against Brazilian states
+            number: '12345678901',
         },
     },
     payments: [
         {
             method: 'credit-card',
-            creditCard: {
-                number: '4111111111111111',
-                holderName: 'João Silva',
-                month: '12',
-                year: '2025',
-                cvv: '123',
-            },
             numberInstallments: 1,
         },
     ],
@@ -320,694 +204,391 @@ const orderId = await sdk.placeOrder('f47ac10b-58cc-4372-a567-0e02b2c3d479', {
 console.log('Order created:', orderId)
 ```
 
-## Comprehensive Validation Framework
+## Features
 
-The Easyflow SDK now includes **enterprise-level validation** for all data types:
+### Payment Processing
 
-### Email Validation
+- **Credit Card**: Highest approval rate with advanced fraud detection
+- **PIX**: Instant Brazilian payment method
+- **Bank Billet**: Traditional bank payment option
+- **Recurring Payments**: Custom subscription rules
 
-```javascript
-// Advanced email validation with security checks
-Validator.validateEmail('user@example.com') // Valid
-Validator.validateEmail('user..name@example.com') // Invalid (consecutive dots)
-Validator.validateEmail('a'.repeat(250) + '@example.com') // Too long
-```
+### Customer Management
 
-### Document Validation
+- **Complete Validation**: CPF/CNPJ, phone, address validation
+- **Data Sanitization**: XSS protection and input cleaning
+- **Secure Storage**: Encrypted sensitive data handling
 
-```javascript
-// CPF validation with official Brazilian algorithm
-Validator.validateCPF('12345678909') // Valid CPF (only digits)
-Validator.validateCPF('11111111111') // Invalid (all same digits)
-
-// CNPJ validation with official algorithm
-Validator.validateCNPJ('11222333000181') // Valid CNPJ (only digits)
-Validator.validateCNPJ('00000000000000') // Invalid (all zeros)
-
-// Document object format for API
-const document = {
-    type: 'CPF',
-    number: '12345678909', // Only digits, no formatting
-}
-```
+### Security Features
 
-### Phone Validation
+- **PCI Compliance**: Bank-level security standards
+- **Fingerprinting**: Advanced fraud detection
+- **Rate Limiting**: Protection against abuse
+- **Input Validation**: Comprehensive data validation
+- **Obfuscated Builds**: Production builds are obfuscated for enhanced security
+- **Controlled Distribution**: Secure distribution via CDN and GitHub Releases
 
-```javascript
-// Brazilian phone validation
-Validator.validatePhone({
-    areaCode: '+55', // International format
-    ddd: '11', // 2-digit DDD (only digits)
-    number: '999999999', // 8-9 digit number (only digits)
-    isMobile: true, // Boolean flag
-})
-```
+## API Reference
 
-### Address Validation
+### Core Methods
 
-```javascript
-// Complete Brazilian address validation
-Validator.validateAddress({
-    zipCode: '01234567', // Brazilian ZIP format (8 digits only)
-    street: 'Rua das Flores', // 3-100 characters
-    neighborhood: 'Centro', // 2-50 characters
-    city: 'São Paulo', // 2-50 characters
-    state: 'SP', // Valid Brazilian state
-    number: '123', // Valid street number
-})
-```
+#### `placeOrder(offerId, data, headers)`
 
-### Customer Validation
+Creates an order using an existing offer.
 
 ```javascript
-// Complete customer data validation
-Validator.validateCustomer({
-    name: 'João Silva', // 2-100 characters
-    email: 'joao@exemplo.com', // Valid email
-    document: {
-        // Valid CPF/CNPJ (only digits)
-        type: 'CPF',
-        number: '12345678909',
-    },
-    phone: {
-        // Valid phone (only digits)
-        areaCode: '+55',
-        ddd: '11',
-        number: '999999999',
-        isMobile: true,
+const orderId = await sdk.placeOrder('offer-id', {
+    customer: {
+        /* customer data */
     },
+    payments: [
+        /* payment methods */
+    ],
 })
 ```
 
-### ID Validation
-
-```javascript
-// Business ID validation
-Validator.validateBusinessId('my-business-123') // Valid format
-Validator.validateBusinessId('-business') // Starts with hyphen
+#### `charge(data, headers)`
 
-// Multiple ID format validation (UUID v4, UUID v7, MongoDB ObjectId)
-Validator.validateOrderId('f47ac10b-58cc-4372-a567-0e02b2c3d479') // UUID v4
-Validator.validateOrderId('01890b24-2d7f-7c3f-8f1a-123456789abc') // UUID v7
-Validator.validateOrderId('507f1f77bcf86cd799439011') // MongoDB ObjectId
+Processes a direct charge without using an offer.
 
-Validator.validateOfferId('a8098c1a-f86e-4f4c-a9f5-0b8add7c7f3d') // UUID v4
-Validator.validateOfferId('01890b24-2d7f-7c3f-9f1a-123456789abc') // UUID v7
-Validator.validateOfferId('507f1f77bcf86cd799439012') // MongoDB ObjectId
+```javascript
+const orderId = await sdk.charge({
+    items: [{ name: 'Product', price: 1000 }],
+    payments: [{ method: 'pix', numberInstallments: 1 }],
+})
+```
 
-Validator.validateCustomerId('16fd2706-8baf-433b-82eb-8c7fada847da') // UUID v4
-Validator.validateCustomerId('01890b24-2d7f-7c3f-af1a-123456789abc') // UUID v7
-Validator.validateCustomerId('507f1f77bcf86cd799439013') // MongoDB ObjectId
+#### `encrypt(creditCardData, headers)`
 
-Validator.validateCreditCardId('58c8f2e0-3d22-4b5d-98ab-9c0a1f2b3c4d') // UUID v4
-Validator.validateCreditCardId('01890b24-2d7f-7c3f-bf1a-123456789abc') // UUID v7
-Validator.validateCreditCardId('507f1f77bcf86cd799439014') // MongoDB ObjectId
+Encrypts credit card data for secure processing.
 
-// Credit card token validation
-Validator.validateCreditCardToken('a'.repeat(32)) // Valid length
+```javascript
+const token = await sdk.encrypt({
+    number: '4111111111111111',
+    holderName: 'John Doe',
+    expirationMonth: '12',
+    expirationYear: '2025',
+    cvv: '123',
+})
 ```
 
-**ID Format Requirements:**
-
-- **UUID v4**: Must follow pattern `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx` where `y` is 8, 9, A, or B
-- **UUID v7**: Must follow pattern `xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx` where `y` is 8, 9, A, or B
-- **MongoDB ObjectId**: Must be exactly 24 hexadecimal characters
-- **Business ID**: Must be 3-50 characters, alphanumeric with hyphens, no consecutive hyphens
+### Customer Management
 
-## Customer Management
+#### `createCustomer(customerData, headers)`
 
-### Create Customer with Full Validation
+Creates a new customer.
 
 ```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,
-    },
+    name: 'John Doe',
+    email: 'john@example.com',
+    document: { type: 'CPF', number: '12345678901' },
 })
-
-console.log('Customer created:', customer.id)
 ```
 
-### Get Customer Information
-
-```javascript
-const customerInfo = await sdk.getCustomer(
-    '16fd2706-8baf-433b-82eb-8c7fada847da'
-)
-console.log('Name:', customerInfo.name)
-console.log('Email:', customerInfo.email)
-console.log('Document:', customerInfo.document)
-```
+#### `getCustomer(customerId, headers)`
 
-### Update Customer Data
+Retrieves customer information.
 
 ```javascript
-const updateResult = await sdk.updateCustomer(
-    '16fd2706-8baf-433b-82eb-8c7fada847da',
-    {
-        name: 'Diego Moura Updated',
-        email: 'diegomoura637+21@gmail.com',
-        phone: {
-            areaCode: '+55',
-            ddd: '11',
-            number: '998862783',
-            isMobile: true,
-        },
-    }
-)
-
-console.log('Customer updated:', updateResult.success)
+const customer = await sdk.getCustomer('customer-id')
 ```
 
-## Credit Card Management
+#### `updateCustomer(customerId, updateData, headers)`
 
-### Add Credit Card to Customer
+Updates existing customer information.
 
 ```javascript
-const cardResult = await sdk.addCreditCard(
-    '16fd2706-8baf-433b-82eb-8c7fada847da',
-    'encrypted-credit-card-token-here'
-)
-
-console.log('Credit card added:', cardResult.creditCardId)
+const result = await sdk.updateCustomer('customer-id', {
+    name: 'John Updated',
+    email: 'john.updated@example.com',
+})
 ```
 
-### Get Credit Card Information
+### Credit Card Management
 
-```javascript
-const creditCard = await sdk.getCreditCard(
-    '16fd2706-8baf-433b-82eb-8c7fada847da',
-    '58c8f2e0-3d22-4b5d-98ab-9c0a1f2b3c4d'
-)
-
-console.log('Brand:', creditCard.brand)
-console.log('Last 4 digits:', creditCard.last4Numbers)
-console.log(
-    'Expires:',
-    `${creditCard.expiresAtMonth}/${creditCard.expiresAtYear}`
-)
-```
+#### `addCreditCard(customerId, creditCardToken, headers)`
 
-### Remove Credit Card
+Adds a credit card to a customer.
 
 ```javascript
-const removeResult = await sdk.removeCreditCard(
-    '16fd2706-8baf-433b-82eb-8c7fada847da',
-    '58c8f2e0-3d22-4b5d-98ab-9c0a1f2b3c4d'
-)
-
-console.log('Credit card removed:', removeResult.success)
+const result = await sdk.addCreditCard('customer-id', 'encrypted-token')
 ```
 
-## Enhanced Security Features
+#### `getCreditCard(customerId, creditCardId, headers)`
 
-### Input Sanitization Engine
+Retrieves credit card information.
 
 ```javascript
-// Recursive object sanitization
-const sanitizedData = Sanitizer.sanitizeObjectFields({
-    user: {
-        name: '<script>alert("xss")</script>John',
-        profile: {
-            bio: 'Bio with <strong>HTML</strong>',
-            website: 'javascript:alert("xss")',
-        },
-    },
-})
-// Result: All dangerous content removed, structure preserved
+const creditCard = await sdk.getCreditCard('customer-id', 'credit-card-id')
 ```
 
-### XSS Prevention
+#### `removeCreditCard(customerId, creditCardId, headers)`
+
+Removes a credit card from a customer.
 
 ```javascript
-// Enhanced sanitization preserving legitimate quotes
-Sanitizer.sanitizeInput('<script>alert("xss")</script>')
-// Returns: 'scriptalert("xss")/script' (quotes preserved)
+const result = await sdk.removeCreditCard('customer-id', 'credit-card-id')
 ```
 
-### Circular Reference Protection
+## Validation
 
-```javascript
-// Safe handling of circular references
-const obj = { name: 'test' }
-obj.self = obj
-const sanitized = Sanitizer.sanitizeObjectFields(obj)
-// No infinite recursion, safe processing
-```
+### ID Validation
 
-## Payment Processing Examples
+All entity IDs must follow specific formats:
 
-### Direct Charge with Validation
+- **UUID v4**: `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx` (y = 8,9,A,B)
+- **UUID v7**: `xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx` (y = 8,9,A,B)
+- **MongoDB ObjectId**: 24-character hexadecimal format
 
 ```javascript
-const orderId = await sdk.charge({
-    items: [
-        {
-            name: 'Premium Product',
-            price: 1000, // R$ 10.00
-            quantity: 1,
-        },
-    ],
-    payments: [
-        {
-            method: 'pix',
-            numberInstallments: 1,
-        },
-    ],
-    buyer: {
-        name: 'João Silva',
-        email: 'joao@exemplo.com',
-        document: { type: 'CPF', number: '12345678909' }, // Only digits
-    },
-})
+// Valid IDs
+Validator.validateOrderId('f47ac10b-58cc-4372-a567-0e02b2c3d479') // UUID v4
+Validator.validateOrderId('01890b24-2d7f-7c3f-8f1a-123456789abc') // UUID v7
+Validator.validateOrderId('507f1f77bcf86cd799439011') // MongoDB ObjectId
 ```
 
-### Credit Card Encryption
+### Data Validation
+
+Comprehensive validation for all input data:
 
 ```javascript
-const token = await sdk.encrypt({
-    cardNumber: '4111111111111111',
-    holderName: 'João Silva',
-    month: '12',
-    year: '2025',
-    cvv: '123',
+// Customer validation
+Validator.validateCustomer({
+    name: 'John Doe',
+    email: 'john@example.com',
+    document: { type: 'CPF', number: '12345678901' },
 })
-// All data automatically validated before encryption
-```
 
-### PIX Payment Retrieval
-
-```javascript
-const pix = await sdk.getPix(orderId)
-if (pix) {
-    console.log('QR Code:', pix.qrCode)
-    console.log('PIX Code:', pix.copyAndPasteCode)
-    console.log('Expiration:', pix.expirationDate)
-}
+// Payment validation
+Validator.validateOrderData({
+    items: [{ name: 'Product', price: 1000 }],
+    payments: [{ method: 'credit-card', numberInstallments: 1 }],
+})
 ```
 
-## Configuration & Headers
+## Events
 
-### Optional Security Headers
+The SDK provides an event system for monitoring operations:
 
 ```javascript
-const headers = {
-    'x-recaptcha-token': 'your_recaptcha_token',
-    'ef-signature': 'your_hmac_signature',
-    'x-fingerprint': 'device_fingerprint',
-    'x-custom-header': 'custom_value',
-}
+// Listen to events
+sdk.on('customerCreated', (data) => {
+    console.log('Customer created:', data)
+})
+
+sdk.on('orderPlaced', (data) => {
+    console.log('Order placed:', data)
+})
+
+sdk.on('paymentProcessed', (data) => {
+    console.log('Payment processed:', data)
+})
 
-const orderId = await sdk.placeOrder(
-    'f47ac10b-58cc-4372-a567-0e02b2c3d479',
-    data,
-    headers
-)
+// Remove event listeners
+sdk.off('customerCreated', callback)
 ```
 
-### Error Handling
+## Error Handling
+
+The SDK provides comprehensive error handling:
 
 ```javascript
 try {
-    const orderId = await sdk.placeOrder(
-        'f47ac10b-58cc-4372-a567-0e02b2c3d479',
-        data
-    )
-    console.log('Success:', orderId)
+    const result = await sdk.placeOrder('offer-id', orderData)
 } catch (error) {
-    if (error instanceof ValidationError) {
-        console.error('Validation error:', error.message)
-        console.error('Field:', error.field)
-    } else if (error instanceof NetworkError) {
-        console.error('Network error:', error.message)
-    } else if (error instanceof SecurityError) {
-        console.error('Security error:', error.message)
-    } else {
-        console.error('Unexpected error:', error)
+    if (error.name === 'ValidationError') {
+        console.log('Validation failed:', error.message)
+    } else if (error.name === 'NetworkError') {
+        console.log('Network error:', error.message)
+    } else if (error.name === 'SecurityError') {
+        console.log('Security violation:', error.message)
     }
 }
 ```
 
-## Testing & Quality
-
-### Run Tests
-
-```bash
-# All tests
-npm test
-
-# Watch mode
-npm run test:watch
+## Configuration
 
-# Coverage
-npm run test:coverage
+### SDK Options
 
-# Specific test file
-npm test -- --testNamePattern="Validator"
+```javascript
+const sdk = new EasyflowSDK({
+    businessId: 'your-business-id',
+    environment: 'production', // 'production' or 'sandbox'
+    debug: false, // Enable debug logging
+    timeout: 30000, // Request timeout in milliseconds
+})
 ```
 
-### Test Results
+### Environment Variables
 
-- **250 Tests Passing**
-- **100% Success Rate**
-- **0 Tests Failing**
-- **Fast Execution**
-
-### Test Structure
-
-```
-sdk.spec.js              - Main SDK tests
-libs/validator.spec.js   - Validation framework tests
-libs/sanitizer.spec.js   - Sanitization tests
-libs/errors.spec.js      - Error handling tests
-libs/constants.spec.js   - Constants tests
-libs/utils.spec.js       - Utilities tests
-libs/http.spec.js        - HTTP communication tests
-libs/logger.spec.js      - Logging tests
-libs/exception-handler.spec.js - Exception handling tests
+```bash
+EASYFLOW_BUSINESS_ID=your-business-id
+EASYFLOW_ENVIRONMENT=production
+EASYFLOW_DEBUG=false
 ```
 
-## Complete API Reference
-
-### Core Methods
-
-| Method                               | Description             | Validation           |
-| ------------------------------------ | ----------------------- | -------------------- |
-| `placeOrder(offerId, data, headers)` | Create order from offer | Full data validation |
-| `charge(data, headers)`              | Process direct charge   | Full data validation |
-| `encrypt(creditCard, headers)`       | Encrypt card data       | Card validation      |
-| `getOffer(offerId, headers)`         | Get offer details       | ID validation        |
-| `getOrder(orderId)`                  | Get order details       | ID validation        |
-| `getPix(orderId, headers)`           | Get PIX data            | ID validation        |
-| `getBankBillet(orderId, headers)`    | Get billet data         | ID validation        |
-
-### Customer Management
-
-| Method                                  | Description     | Validation               |
-| --------------------------------------- | --------------- | ------------------------ |
-| `createCustomer(customer, headers)`     | Create customer | Full customer validation |
-| `getCustomer(id, headers)`              | Get customer    | ID validation            |
-| `updateCustomer(id, customer, headers)` | Update customer | Full validation          |
-
-### Credit Card Management
+## Examples
 
-| Method                                          | Description | Validation            |
-| ----------------------------------------------- | ----------- | --------------------- |
-| `addCreditCard(customerId, token, headers)`     | Add card    | ID + token validation |
-| `getCreditCard(customerId, cardId, headers)`    | Get card    | ID validation         |
-| `removeCreditCard(customerId, cardId, headers)` | Remove card | ID validation         |
+### Complete Checkout Flow
 
-### Validation Methods
-
-| Method                                      | Description            | Use Case              |
-| ------------------------------------------- | ---------------------- | --------------------- |
-| `Validator.validateEmail(email)`            | Email validation       | User registration     |
-| `Validator.validateCPF(cpf)`                | CPF validation         | Brazilian individuals |
-| `Validator.validateCNPJ(cnpj)`              | CNPJ validation        | Brazilian companies   |
-| `Validator.validatePhone(phone)`            | Phone validation       | Contact information   |
-| `Validator.validateAddress(address)`        | Address validation     | Shipping/billing      |
-| `Validator.validateCustomer(customer)`      | Customer validation    | Complete profile      |
-| `Validator.validateBusinessId(id)`          | Business ID validation | SDK initialization    |
-| `Validator.validateOrderId(id)`             | Order ID validation    | Order operations      |
-| `Validator.validateOfferId(id)`             | Offer ID validation    | Offer operations      |
-| `Validator.validateCreditCardToken(token)`  | Token validation       | Card operations       |
-| `Validator.validatePagination(page, limit)` | Pagination validation  | List operations       |
+```javascript
+// 1. Create customer
+const customer = await sdk.createCustomer({
+    name: 'John Doe',
+    email: 'john@example.com',
+    document: { type: 'CPF', number: '12345678901' },
+})
 
-## Advanced Features
+// 2. Encrypt credit card
+const token = await sdk.encrypt({
+    number: '4111111111111111',
+    holderName: 'John Doe',
+    expirationMonth: '12',
+    expirationYear: '2025',
+    cvv: '123',
+})
 
-### Recursive Data Sanitization
+// 3. Add credit card to customer
+const creditCard = await sdk.addCreditCard(customer.id, token)
 
-```javascript
-// Deep object sanitization with circular reference protection
-const complexData = {
-    user: {
-        name: '<script>alert("xss")</script>João',
-        preferences: {
-            theme: 'dark<script>alert("xss")</script>',
-            settings: {
-                notifications: true,
-                language: 'pt-BR<script>alert("xss")</script>',
-            },
+// 4. Place order
+const orderId = await sdk.placeOrder('offer-id', {
+    customer: customer,
+    payments: [
+        {
+            method: 'credit-card',
+            creditCardId: creditCard.creditCardId,
+            numberInstallments: 1,
         },
-    },
-    metadata: {
-        tags: ['tag1', '<script>alert("xss")</script>tag2'],
-    },
-}
-
-const sanitized = Sanitizer.sanitizeObjectFields(complexData)
-// All dangerous content removed, structure preserved
+    ],
+})
 ```
 
-### Brazilian Compliance
+### PIX Payment
 
 ```javascript
-// Complete Brazilian data validation
-const brazilianData = {
-    document: { type: 'CPF', number: '12345678909' }, // Only digits
-    phone: { areaCode: '+55', ddd: '11', number: '999999999' }, // Only digits
-    address: {
-        zipCode: '01234567', // Only digits, no hyphens
-        state: 'SP', // Validated against 27 Brazilian states
-        city: 'São Paulo',
+const orderId = await sdk.placeOrder('offer-id', {
+    customer: {
+        /* customer data */
     },
-}
+    payments: [
+        {
+            method: 'pix',
+            numberInstallments: 1,
+        },
+    ],
+})
 
-// All data automatically validated
-Validator.validateCustomer(brazilianData)
+// Get PIX data
+const pixData = await sdk.getPix(orderId)
+console.log('PIX QR Code:', pixData.qrCode)
 ```
 
-### Security Headers
+### Bank Billet Payment
 
 ```javascript
-// Enhanced security with custom headers
-const secureHeaders = {
-    'x-recaptcha-token': 'recaptcha_token',
-    'ef-signature': 'hmac_signature',
-    'x-fingerprint': 'device_fingerprint',
-    'x-request-id': 'unique_request_id',
-    'x-timestamp': Date.now().toString(),
-}
+const orderId = await sdk.placeOrder('offer-id', {
+    customer: {
+        /* customer data */
+    },
+    payments: [
+        {
+            method: 'bank-billet',
+            numberInstallments: 1,
+        },
+    ],
+})
+
+// Get bank billet data
+const bankBillet = await sdk.getBankBillet(orderId)
+console.log('Bank Billet Link:', bankBillet.link)
 ```
 
-## Performance & Production
+## Distribution & Security
 
-### Optimized for Production
+### Why CDN Scripts?
 
-- **Minified**: 40% size reduction
-- **Tree Shaking**: Unused code elimination
-- **Lazy Loading**: On-demand feature loading
-- **Memory Efficient**: Optimized data structures
+- **Obfuscated Builds**: Production code is obfuscated for security
+- **Controlled Access**: Secure distribution via Cloudflare Pages
+- **Version Control**: Specific versions available for stability
+- **Performance**: Global CDN for fast loading
 
-### CDN Distribution
+### Available CDN URLs
 
 ```html
 <!-- Latest version -->
 <script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
 
 <!-- Versioned (recommended for production) -->
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.4.min.js"></script>
+<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.8.min.js"></script>
 
 <!-- With SRI (Subresource Integrity) -->
 <script
-    src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.4.min.js"
-    integrity="sha384-ABC123..."
+    src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.9.min.js"
+    integrity="sha384-[hash]"
     crossorigin="anonymous"
 ></script>
 ```
 
-## Development & Contributing
-
-### Local Development
-
-```bash
-# Clone repository
-git clone https://github.com/easyflow-cash/easyflow-javascript-sdk.git
-cd easyflow-javascript-sdk
-
-# Install dependencies
-npm install
-
-# Start development server
-npm run dev
-
-# Run tests
-npm test
-
-# Build for production
-npm run build
-```
-
-### Project Structure
-
-```
-├── libs/                    # Core libraries
-│   ├── validator.mjs       # Validation framework
-│   ├── sanitizer.mjs       # Data sanitization
-│   ├── security.mjs        # Security features
-│   ├── http.mjs           # HTTP communication
-│   ├── errors.mjs         # Error handling
-│   ├── constants.mjs      # Constants
-│   ├── utils.mjs          # Utilities
-│   ├── logger.mjs         # Logging
-│   └── exception-handler.mjs # Exception handling
-├── sdk.mjs                # Main SDK class
-├── tests/                 # Test files
-├── dist/                  # Built files
-└── docs/                  # Documentation
-```
-
-## Quality Metrics
-
-### Code Quality
-
-- **ESLint**: 0 warnings, 0 errors
-- **Prettier**: Consistent formatting
-- **TypeScript**: JSDoc type definitions
-- **Coverage**: 95% test coverage
-
-### Security Score
-
-- **Input Validation**: 95/100
-- **Data Sanitization**: 98/100
-- **Error Handling**: 92/100
-- **Rate Limiting**: 90/100
-- **Overall Security**: 92/100
-
-### Performance Score
-
-- **Bundle Size**: 95/100
-- **Execution Speed**: 92/100
-- **Memory Usage**: 90/100
-- **Network Efficiency**: 88/100
-- **Overall Performance**: 95/100
-
 ## Browser Support
 
-- **Chrome**: 80+
-- **Firefox**: 75+
-- **Safari**: 13+
-- **Edge**: 80+
-- **Node.js**: 16+
-
-## Mobile Support
-
-- **iOS Safari**: 13+
-- **Android Chrome**: 80+
-- **Mobile WebView**: 80+
-
-## Support & Contact
-
-### Need Help?
+## Node.js Support
 
-- **Complete Documentation**: [docs.easyflow.digital](https://docs.easyflow.digital)
-- **Technical Support**: [easyflow.digital/contact](https://easyflow.digital/contact)
-- **Demo**: [Schedule a demo](https://www.easyflow.digital/)
-- **Issues**: [GitHub Issues](https://github.com/easyflow-cash/easyflow-javascript-sdk/issues)
+- **Node.js**: 18+
+- **npm**: 8+
+- **yarn**: 1.22+
 
-### Start Now
+## Contributing
 
-- **Free Account**: [easyflow.digital](https://www.easyflow.digital/)
-- **No Bureaucracy**: Product live in 1 minute
-- **100% Plug & Play**: Works for any type of business
-- **Scales with You**: Grow without limits
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
 
-## Useful Links
+## Support
 
-- **Official Website**: [https://www.easyflow.digital](https://www.easyflow.digital)
-- **Live Demo**: [https://easyflow-sdk.pages.dev](https://easyflow-sdk.pages.dev)
 - **Documentation**: [https://docs.easyflow.digital](https://docs.easyflow.digital)
-- **Support**: [https://easyflow.digital/contact](https://easyflow.digital/contact)
-- **Issues**: [GitHub Issues](https://github.com/easyflow-cash/easyflow-javascript-sdk/issues)
-- **Repository**: [GitHub Repository](https://github.com/easyflow-cash/easyflow-javascript-sdk)
-
-## CDN URLs
-
-### Cloudflare Pages CDN
-
-- **Latest**: [https://easyflow-sdk.pages.dev/easyflow-sdk.min.js](https://easyflow-sdk.pages.dev/easyflow-sdk.min.js)
-- **Versioned**: [https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.4.min.js](https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.4.min.js)
-
-### jsDelivr CDN
-
-- **Latest**: [https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js](https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js)
-- **Versioned**: [https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@2.1.4/dist/easyflow-sdk.min.js](https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@2.1.4/dist/easyflow-sdk.min.js)
-
-## Author & Maintainer
+- **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)
 
-**Diego Moura** - Co-Founder/CTO
+## License
 
-- **GitHub**: [@dmourainatel](https://github.com/dmourainatel)
-- **Email**: [diego@easyflow.digital](mailto:diego@easyflow.digital)
-- **Website**: [diegomoura.pro](https://diegomoura.pro)
-- **LinkedIn**: [diego-moura-8499a664](https://www.linkedin.com/in/diego-moura-8499a664/)
-- **Medium**: [@diego_moura](https://medium.com/@diego_moura)
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-### About Diego
+## Changelog
 
-Diego Moura is a **Solutions Architect**, **Senior Full Stack Developer**, and **CTO** with extensive experience in open source technologies and technical challenges. He is the principal developer and maintainer of the EasyFlow JavaScript SDK, bringing his expertise in security, performance, and enterprise-grade solutions to this project.
+### v2.1.9
 
----
+- **Hybrid Distribution**: NPM for docs, CDN for secure obfuscated code
+- **Enhanced Security**: Code source protected while maintaining accessibility
+- **Better UX**: Easy discovery via NPM, secure usage via CDN
+- **Documentation**: Complete setup and usage instructions
 
-## Contributing
+### v2.1.8
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+- **Security & Privacy**: Anonymized README.md for safe NPM publication
+- **Documentation**: Removed all personal information and sensitive data
+- **Professional**: Clean, business-focused documentation
 
-**Note**: This project is actively maintained by Diego Moura. For major changes or questions, please reach out directly.
+### v2.1.7
 
----
+- Fixed all failing unit tests for complete 250 test coverage
+- Corrected mock structures for customer and credit card management
+- Standardized API response patterns across all endpoints
+- Enhanced test reliability and maintainability
 
-## License
+### v2.1.6
 
-MIT License © [Easyflow](https://easyflow.digital)
+- Enhanced ID validation with UUID v4, UUID v7, and MongoDB ObjectId support
+- Fixed iframe compatibility issues for low-code platforms
+- Implemented complete event system with `on()` and `off()` methods
+- Added global SDK instance for easier integration
 
----
+### v2.1.5
 
-**Current version:** 2.1.4  
-**Last updated:** December 2024  
-**Test status:** 256 tests passing  
-**Security score:** 92/100  
-**Performance score:** 95/100
+- Added browser fingerprinting for enhanced security
+- Implemented automatic `x-fingerprint-id` header generation
+- Enhanced security validation and error handling
+- Improved documentation and examples
 
 ---
 
-<div align="center">
-
-**Find your own flow in digital**
-
-_Easyflow Payment Solutions_  
-_CNPJ 53.833.178/0001-80_
-
----
-
-**Developed and maintained by [Diego Moura](https://github.com/dmourainatel)**  
-_Solutions Architect & CTO_
-
-</div>
+**Built with ❤️ by the Easyflow Team**