@easyflow/javascript-sdk 2.1.23 → 2.1.25

package/PLATFORM-INTEGRATION.md

@@ -0,0 +1,235 @@
+# 🚀 Easyflow SDK - Platform Integration Guide
+
+## 📋 Overview
+
+The Easyflow SDK provides a **dual initialization approach** to serve both traditional developers and low-code/no-code platforms. This guide explains the `initializeForPlatform` mechanism and how to use it effectively.
+
+## 🔧 Two Ways to Initialize
+
+### 1. **Traditional Initialization** (For Developers)
+
+```javascript
+// Direct SDK instance - Full control
+const sdk = new EasyflowSDK('your-business-id')
+
+// Use all SDK methods directly
+await sdk.createCustomer(customerData)
+await sdk.placeOrder(offerId, orderData)
+await sdk.charge(paymentData)
+```
+
+### 2. **Platform Integration** (For Low-Code/No-Code)
+
+```javascript
+// Platform wrapper - Simplified API
+const wrapper = EasyflowSDK.initializeForPlatform({
+    businessId: 'your-business-id',
+    enableDebug: true,
+})
+
+// Use simplified methods
+await wrapper.createCustomer(customerData)
+await wrapper.placeOrder(offerId, orderData)
+await wrapper.charge(paymentData)
+```
+
+## 🎯 When to Use Each Approach
+
+| **Use Case**             | **Method**                | **Benefits**                                    |
+| ------------------------ | ------------------------- | ----------------------------------------------- |
+| **Full Control**         | `new EasyflowSDK()`       | Complete API access, custom error handling      |
+| **Platform Integration** | `initializeForPlatform()` | Simplified API, automatic callbacks, validation |
+| **Quick Prototyping**    | `initializeForPlatform()` | Faster setup, less configuration                |
+| **Production Apps**      | `new EasyflowSDK()`       | Better performance, more control                |
+
+## ⚙️ Platform Integration Features
+
+### **Automatic Callbacks**
+
+```javascript
+const wrapper = EasyflowSDK.initializeForPlatform({
+    businessId: 'your-business-id',
+    enableDebug: true,
+})
+
+// Set up event handlers
+wrapper.on('customerCreated', (customer) => {
+    console.log('Customer created:', customer)
+})
+
+wrapper.on('paymentProcessed', (result, method) => {
+    console.log('Payment processed:', result, method)
+})
+
+wrapper.on('error', (error) => {
+    console.error('Error occurred:', error)
+})
+```
+
+### **Simplified Validation**
+
+```javascript
+// Automatic validation with friendly error messages
+const validation = wrapper.validate('email', 'user@example.com')
+if (!validation.valid) {
+    console.error('Validation failed:', validation.error)
+}
+```
+
+### **Configuration Management**
+
+```javascript
+// Update configuration on the fly
+wrapper.configure({
+    enableDebug: false,
+    timeout: 30000,
+})
+
+// Get current status
+const status = wrapper.getStatus()
+console.log('Wrapper status:', status)
+```
+
+## 🔄 How It Works
+
+### **1. Method Call**
+
+```javascript
+static initializeForPlatform(config) {
+    return initializeEasyflow(config)
+}
+```
+
+### **2. Wrapper Creation**
+
+```javascript
+function initializeEasyflow(config) {
+    return new EasyflowIntegrationWrapper(config)
+}
+```
+
+### **3. Simplified Interface**
+
+The wrapper provides:
+
+- ✅ **Simplified method names**
+- ✅ **Automatic error handling**
+- ✅ **Built-in validation**
+- ✅ **Event management**
+- ✅ **Configuration persistence**
+
+## 📱 Platform Examples
+
+### **Bubble Integration**
+
+```javascript
+// In Bubble's JavaScript actions
+const easyflow = EasyflowSDK.initializeForPlatform({
+    businessId: bubble.get('business_id'),
+    enableDebug: true,
+})
+
+// Use in workflows
+const customer = await easyflow.createCustomer({
+    name: bubble.get('customer_name'),
+    email: bubble.get('customer_email'),
+})
+```
+
+### **Webflow Integration**
+
+```javascript
+// In Webflow's custom code
+const easyflow = EasyflowSDK.initializeForPlatform({
+    businessId: 'your-business-id',
+})
+
+// Handle form submissions
+document
+    .getElementById('payment-form')
+    .addEventListener('submit', async (e) => {
+        e.preventDefault()
+        const result = await easyflow.charge(paymentData)
+    })
+```
+
+### **Custom Platform**
+
+```javascript
+// For your own platform
+class MyPlatform {
+    constructor() {
+        this.easyflow = EasyflowSDK.initializeForPlatform({
+            businessId: this.config.businessId,
+            enableDebug: this.config.debug,
+        })
+    }
+
+    async processPayment(data) {
+        return await this.easyflow.charge(data)
+    }
+}
+```
+
+## 🛡️ Security & Validation
+
+### **Automatic Sanitization**
+
+- All input data is automatically sanitized
+- Dangerous characters and protocols are removed
+- Sensitive information is handled securely
+
+### **Built-in Validation**
+
+```javascript
+// Automatic validation for common data types
+wrapper.validate('email', email) // Email format
+wrapper.validate('cpf', cpf) // CPF validation
+wrapper.validate('cnpj', cnpj) // CNPJ validation
+wrapper.validate('phone', phone) // Phone format
+wrapper.validate('address', address) // Address structure
+wrapper.validate('customer', customer) // Customer data
+```
+
+## 📊 Performance Considerations
+
+### **Memory Usage**
+
+- **Traditional SDK**: Lower memory footprint, direct access
+- **Platform Wrapper**: Slightly higher memory due to additional features
+
+### **Execution Speed**
+
+- **Traditional SDK**: Faster execution, no wrapper overhead
+- **Platform Wrapper**: Minimal overhead, optimized for ease of use
+
+## 🔧 Configuration Options
+
+```javascript
+const wrapper = EasyflowSDK.initializeForPlatform({
+    businessId: 'your-business-id', // Required
+    enableDebug: true, // Optional: Enable debug logs
+    timeout: 30000, // Optional: Request timeout (ms)
+    retryAttempts: 3, // Optional: Retry attempts
+    enableValidation: true, // Optional: Enable validation
+    enableCallbacks: true, // Optional: Enable callbacks
+})
+```
+
+## 📚 Related Documentation
+
+- **[README.md](README.md)** - Main SDK documentation
+- **[INDEX.md](INDEX.md)** - Documentation hub
+- **[DATA-STRUCTURES.md](DATA-STRUCTURES.md)** - Data structure reference
+- **[API Reference](docs/index.html)** - Complete API documentation
+
+## 🚀 Getting Started
+
+1. **Choose your approach** based on your needs
+2. **Initialize the SDK** using the appropriate method
+3. **Configure callbacks** if using platform integration
+4. **Start building** your payment solution
+
+---
+
+**Need help?** Check the main [README.md](README.md) or create an issue on GitHub.

package/README.md

@@ -149,13 +149,6 @@ platform. With this SDK, you can:
 - **MongoDB ObjectId**: 24-character hexadecimal format `507f1f77bcf86cd799439011`
 - **Strict Validation**: Rejects any other formats for enhanced security
 
-### Lovable Integration Fixes
-
-- **Event System Implementation**: Complete event system with `on()` and `off()` methods
-- **Iframe Compatibility**: Fixed iframe blocking issues for low-code platforms
-- **Global Instance**: `window.easyflowSDK` instance with all methods and events
-- **Event Emissions**: Automatic events for `customerCreated`, `orderPlaced`, and `paymentProcessed`
-
 ## Quick Start
 
 ### Installation
@@ -169,7 +162,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.12.min.js"></script>
+<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.v2.1.19.min.js"></script>
 ```
 
 #### Option 2: CDN jsDelivr (Alternative)
@@ -192,20 +185,6 @@ npm install @easyflow/javascript-sdk
 
 ### Basic Usage
 
-#### Method 1: CDN Script (Recommended for Production)
-
-```html
-<!-- Load SDK via script tag -->
-<script src="https://easyflow-sdk.pages.dev/easyflow-sdk.min.js"></script>
-```
-
-#### Method 2: CDN jsDelivr (Alternative)
-
-```html
-<!-- Load SDK via jsDelivr -->
-<script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js"></script>
-```
-
 ```javascript
 // Configure the global instance
 easyflowSDK.configure({
@@ -238,43 +217,11 @@ easyflowSDK
     })
 ```
 
-#### Method 3: 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>
-```
-
-```javascript
-// 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!')
-}
+## 📚 Documentation
 
-// Listen to events
-easyflowSDK.on('customerCreated', (data) => {
-    console.log('Evento cliente criado:', data)
-})
-```
+- **[INDEX.md](INDEX.md)** - Central documentation hub
+- **[DATA-STRUCTURES.md](DATA-STRUCTURES.md)** - Complete data structure reference
+- **[PLATFORM-INTEGRATION.md](PLATFORM-INTEGRATION.md)** - Platform integration guide with `initializeForPlatform`
 
 ## Features
 
@@ -300,14 +247,6 @@ easyflowSDK.on('customerCreated', (data) => {
 - **Obfuscated Builds**: Production builds are obfuscated for enhanced security
 - **Controlled Distribution**: Secure distribution via CDN (Cloudflare Pages + jsDelivr)
 
-### 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
@@ -574,7 +513,7 @@ can find this value in your business configuration at [https://app.easyflow.digi
 
 **Important:** Never share your business ID publicly. Keep it secure and use it only in your application code.
 
-### SDK Options (CDN Implementation)
+### SDK Options
 
 ```javascript
 // Configure the global instance
@@ -1193,12 +1132,18 @@ This project is licensed under the ISC License - see the [LICENSE](LICENSE) file
 
 **Diego Moura** - Co-Found & CTO at Easyflow
 
-- **Email**: [diego@easyflow.digital](mailto:diego@easyflow.digital)
-- **Website**: [https://diegomoura.pro](https://diegomoura.pro)
-- **GitHub**: [https://github.com/dmourainatel](https://github.com/dmourainatel)
+- **Email**: [contato@easyflow.digital](mailto:contato@easyflow.digital)
+- **Website**: [https://www.easyflow.digital](https://www.easyflow.digital)
 
 ## Changelog
 
+### v2.1.23
+
+- **SDK Simplification**: Removed all platform-specific integrations for cleaner, focused codebase
+- **Streamlined Documentation**: Focused README on core SDK functionality and usage
+- **Enhanced Security**: Maintained all security features while simplifying the codebase
+- **Better Developer Experience**: Cleaner documentation focused on essential features
+
 ### v2.1.20
 
 - **jsDelivr CDN Fix**: Fixed npm package to include easyflow-sdk.min.js for proper jsDelivr CDN support