@easyflow/javascript-sdk 2.1.7 → 2.1.9

package/dist/index.d.ts

@@ -0,0 +1,421 @@
+declare module '@easyflow/javascript-sdk' {
+    export interface EasyflowSDKConfig {
+        businessId: string
+        environment?: 'production' | 'sandbox'
+        debug?: boolean
+        timeout?: number
+    }
+
+    export interface CustomerData {
+        name: string
+        email: string
+        document: {
+            type: 'CPF' | 'CNPJ'
+            number: string
+        }
+        phone?: {
+            areaCode: string
+            ddd: string
+            number: string
+            isMobile: boolean
+        }
+        address?: {
+            zipCode: string
+            street: string
+            number: string
+            complement?: string
+            neighborhood: string
+            city: string
+            state: string
+        }
+        deliveryAddress?: {
+            zipCode: string
+            street: string
+            number: string
+            complement?: string
+            neighborhood: string
+            city: string
+            state: string
+        }
+    }
+
+    export interface PaymentMethod {
+        method: 'credit-card' | 'pix' | 'bank-billet'
+        numberInstallments: number
+        creditCard?: {
+            number: string
+            holderName: string
+            month: string
+            year: string
+            cvv: string
+        }
+        creditCardId?: string
+    }
+
+    export interface OrderData {
+        customer: CustomerData
+        payments: PaymentMethod[]
+        items?: Array<{
+            name: string
+            price: number
+            quantity?: number
+        }>
+        metadata?: Record<string, any>
+    }
+
+    export interface CreditCardData {
+        number: string
+        holderName: string
+        month: string
+        year: string
+        cvv: string
+    }
+
+    export interface Customer {
+        id: string
+        name: string
+        email: string
+        document: {
+            type: 'CPF' | 'CNPJ'
+            number: string
+        }
+        phone?: {
+            areaCode: string
+            ddd: string
+            number: string
+            isMobile: boolean
+        }
+        address?: {
+            zipCode: string
+            street: string
+            number: string
+            complement?: string
+            neighborhood: string
+            city: string
+            state: string
+        }
+        deliveryAddress?: {
+            zipCode: string
+            street: string
+            number: string
+            complement?: string
+            neighborhood: string
+            city: string
+            state: string
+        }
+        createdAt?: string
+        updatedAt?: string
+    }
+
+    export interface CreditCard {
+        creditCardId: string
+        brand?: string
+        last4Numbers?: string
+        expiresAtMonth?: string
+        expiresAtYear?: string
+        holderName?: string
+    }
+
+    export interface Order {
+        id: string
+        status: string
+        total: number
+        customer: Customer
+        payments: PaymentMethod[]
+        items?: Array<{
+            name: string
+            price: number
+            quantity: number
+        }>
+        createdAt?: string
+        updatedAt?: string
+    }
+
+    export interface Offer {
+        id: string
+        name: string
+        price: number
+        description?: string
+        items: Array<{
+            name: string
+            price: number
+            quantity: number
+        }>
+    }
+
+    export interface PixData {
+        qrCode: string
+        copyAndPasteCode: string
+        expirationDate: string
+    }
+
+    export interface BankBilletData {
+        link: string
+        line: string
+        barCode: string
+        expirationDate: string
+    }
+
+    export interface ValidationResult {
+        isValid: boolean
+        errors?: string[]
+    }
+
+    export class EasyflowSDK {
+        static readonly version: string
+
+        constructor(config: EasyflowSDKConfig | string)
+
+        // Core Methods
+        placeOrder(
+            offerId: string,
+            data: OrderData,
+            headers?: Record<string, string>
+        ): Promise<string>
+        charge(
+            data: OrderData,
+            headers?: Record<string, string>
+        ): Promise<string>
+        encrypt(
+            creditCardData: CreditCardData,
+            headers?: Record<string, string>
+        ): Promise<string>
+
+        // Offer & Order Management
+        getOffer(
+            offerId: string,
+            headers?: Record<string, string>
+        ): Promise<Offer>
+        getOrder(
+            orderId: string,
+            headers?: Record<string, string>
+        ): Promise<Order>
+
+        // Payment Methods
+        getPix(
+            orderId: string,
+            headers?: Record<string, string>
+        ): Promise<PixData | null>
+        getBankBillet(
+            orderId: string,
+            headers?: Record<string, string>
+        ): Promise<BankBilletData | null>
+
+        // Customer Management
+        createCustomer(
+            customerData: CustomerData,
+            headers?: Record<string, string>
+        ): Promise<Customer>
+        getCustomer(
+            customerId: string,
+            headers?: Record<string, string>
+        ): Promise<Customer>
+        updateCustomer(
+            customerId: string,
+            updateData: Partial<CustomerData>,
+            headers?: Record<string, string>
+        ): Promise<ValidationResult>
+
+        // Credit Card Management
+        addCreditCard(
+            customerId: string,
+            creditCardToken: string,
+            headers?: Record<string, string>
+        ): Promise<CreditCard>
+        getCreditCard(
+            customerId: string,
+            creditCardId: string,
+            headers?: Record<string, string>
+        ): Promise<CreditCard>
+        removeCreditCard(
+            customerId: string,
+            creditCardId: string,
+            headers?: Record<string, string>
+        ): Promise<ValidationResult>
+
+        // Event System
+        on(
+            event: 'customerCreated' | 'orderPlaced' | 'paymentProcessed',
+            callback: (data: any) => void
+        ): void
+        off(
+            event: 'customerCreated' | 'orderPlaced' | 'paymentProcessed',
+            callback: (data: any) => void
+        ): void
+    }
+
+    // Validator Class
+    export class Validator {
+        static validateEmail(email: string): boolean
+        static validateCPF(cpf: string): boolean
+        static validateCNPJ(cnpj: string): boolean
+        static validateLegalDocument(document: {
+            type: 'CPF' | 'CNPJ'
+            number: string
+        }): boolean
+        static validatePhone(phone: {
+            areaCode: string
+            ddd: string
+            number: string
+            isMobile: boolean
+        }): boolean
+        static validateAddress(address: {
+            zipCode: string
+            street: string
+            number: string
+            complement?: string
+            neighborhood: string
+            city: string
+            state: string
+        }): boolean
+        static validateCustomer(customer: CustomerData): boolean
+        static validatePagination(page: number, limit: number): boolean
+        static validateBusinessId(businessId: string): boolean
+        static validateCreditCardToken(token: string): boolean
+        static validateOrderId(orderId: string): boolean
+        static validateOfferId(offerId: string): boolean
+        static validateCustomerId(customerId: string): boolean
+        static validateCreditCardId(creditCardId: string): boolean
+        static validateOrderData(orderData: OrderData): boolean
+    }
+
+    // Constants
+    export const PAYMENT_METHODS: {
+        readonly CREDIT_CARD: 'credit-card'
+        readonly PIX: 'pix'
+        readonly BANK_BILLET: 'bank-billet'
+    }
+
+    export const TARGETS: {
+        readonly CHARGE: 'charge'
+        readonly PLACE_ORDER: 'place-order'
+        readonly ENCRYPT: 'encrypt'
+        readonly GET_OFFER: 'get-offer'
+        readonly GET_ORDER: 'get-order'
+    }
+
+    export const HTTP_STATUS_CODES: {
+        readonly OK: 200
+        readonly CREATED: 201
+        readonly BAD_REQUEST: 400
+        readonly UNAUTHORIZED: 401
+        readonly FORBIDDEN: 403
+        readonly NOT_FOUND: 404
+        readonly INTERNAL_SERVER_ERROR: 500
+    }
+
+    export const HTTP_REQUEST_METHODS: {
+        readonly GET: 'GET'
+        readonly POST: 'POST'
+        readonly PUT: 'PUT'
+        readonly DELETE: 'DELETE'
+    }
+
+    // Error Classes
+    export class EasyflowError extends Error {
+        constructor(message: string, status?: number, code?: string)
+        status: number
+        code: string
+    }
+
+    export class SecurityError extends EasyflowError {
+        constructor(message: string)
+    }
+
+    export class ValidationError extends EasyflowError {
+        constructor(message: string)
+    }
+
+    export class NetworkError extends EasyflowError {
+        constructor(message: string)
+    }
+
+    export const ERROR_CODES: {
+        readonly VALIDATION_ERROR: 'VALIDATION_ERROR'
+        readonly SECURITY_ERROR: 'SECURITY_ERROR'
+        readonly NETWORK_ERROR: 'NETWORK_ERROR'
+        readonly UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+    }
+
+    // Default export
+    export default EasyflowSDK
+}
+
+// Global instance for browser environments
+declare global {
+    interface Window {
+        easyflowSDK: {
+            on(event: string, callback: (data: any) => void): void
+            off(event: string, callback: (data: any) => void): void
+            placeOrder(
+                offerId: string,
+                data: any,
+                headers?: Record<string, string>
+            ): Promise<string>
+            charge(data: any, headers?: Record<string, string>): Promise<string>
+            encrypt(
+                creditCardData: any,
+                headers?: Record<string, string>
+            ): Promise<string>
+            getOffer(
+                offerId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            getOrder(
+                orderId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            getPix(
+                orderId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            getBankBillet(
+                orderId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            createCustomer(
+                customerData: any,
+                headers?: Record<string, string>
+            ): Promise<any>
+            getCustomer(
+                customerId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            updateCustomer(
+                customerId: string,
+                updateData: any,
+                headers?: Record<string, string>
+            ): Promise<any>
+            addCreditCard(
+                customerId: string,
+                creditCardToken: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            getCreditCard(
+                customerId: string,
+                creditCardId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            removeCreditCard(
+                customerId: string,
+                creditCardId: string,
+                headers?: Record<string, string>
+            ): Promise<any>
+            validate: {
+                email(email: string): boolean
+                cpf(cpf: string): boolean
+                cnpj(cnpj: string): boolean
+                phone(phone: any): boolean
+                address(address: any): boolean
+                customer(customer: any): boolean
+                orderId(orderId: string): boolean
+                offerId(offerId: string): boolean
+                customerId(customerId: string): boolean
+                creditCardId(creditCardId: string): boolean
+            }
+            version: string
+            PAYMENT_METHODS: any
+        }
+        EasyflowSDK: typeof import('@easyflow/javascript-sdk').EasyflowSDK
+    }
+}

package/package.json

@@ -1,16 +1,27 @@
 {
     "name": "@easyflow/javascript-sdk",
-    "version": "2.1.7",
-    "description": "Easyflow javascript SDK to be used on client side applications",
-    "main": "dist/easyflow-sdk.min.js",
+    "version": "2.1.9",
+    "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",
     "type": "module",
     "types": "./dist/index.d.ts",
+    "files": [
+        "README.md",
+        "LICENSE",
+        "dist/index.d.ts"
+    ],
     "exports": {
-        "import": "./dist/index.mjs",
-        "require": "./dist/index.cjs"
+        ".": {
+            "import": "./dist/easyflow-sdk.min.js",
+            "require": "./dist/easyflow-sdk.min.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./package.json": "./package.json"
     },
     "scripts": {
-        "build": "npm run generate-version && npx webpack --config webpack.config.cjs",
+        "build": "npm run generate-version && npm run build:types && npx webpack --config webpack.config.cjs",
+        "build:types": "npx tsc --project tsconfig.json",
         "generate-version": "node -e \"const pkg=require('./package.json'); const fs=require('fs'); const content='export const SDK_VERSION = \\'' + pkg.version + '\\';'; fs.writeFileSync('./version.mjs', content);\"",
         "server:up": "rm -rf ./dist && npm run build && npx http-server . -p 8080 -o",
         "dev": "npm run build && npx http-server . -p 8080 -o --cors",
@@ -38,12 +49,14 @@
         "@babel/cli": "^7.26.4",
         "@babel/core": "^7.26.8",
         "@babel/preset-env": "^7.26.8",
+        "@types/node": "^20.19.11",
         "babel-loader": "^9.2.1",
         "http-server": "^14.1.1",
         "javascript-obfuscator": "^4.1.1",
         "jest": "^29.7.0",
         "prettier": "^3.4.2",
         "terser-webpack-plugin": "^5.3.11",
+        "typescript": "^5.9.2",
         "webpack": "^5.97.1",
         "webpack-cli": "^6.0.1",
         "webpack-obfuscator": "^3.5.1"

package/.babelrc

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

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

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

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

@@ -1,144 +0,0 @@
-name: Release Easyflow SDK - Multi-CDN
-
-on:
-    push:
-        tags:
-            - 'v*'
-
-jobs:
-    release:
-        runs-on: ubuntu-latest
-
-        steps:
-            - name: Checkout do repositório
-              uses: actions/checkout@v4
-
-            - name: Instalar Node.js
-              uses: actions/setup-node@v4
-              with:
-                  node-version: 20
-                  cache: 'npm'
-
-            - name: Instalar dependências
-              run: npm install
-
-            - name: Gerar arquivo de versão
-              run: npm run generate-version
-
-            - name: Executar testes
-              run: npm test
-
-            - name: Build do SDK
-              run: npm run build
-
-            - name: Extrair versão do SDK
-              id: version
-              run: |
-                  VERSION=$(jq -r .version package.json)
-                  echo "VERSION=v$VERSION" >> "$GITHUB_ENV"
-                  echo "version=v$VERSION" >> "$GITHUB_OUTPUT"
-
-            - name: Copiar arquivo com versão
-              run: |
-                  cp dist/easyflow-sdk.min.js dist/easyflow-sdk.${{ env.VERSION }}.min.js
-
-            - name: Copiar interface de teste
-              run: |
-                  cp index.html dist/
-                  # Update the script src to use the correct path for production
-                  sed -i 's|./dist/easyflow-sdk.min.js|./easyflow-sdk.min.js|g' dist/index.html
-
-            - name: Gerar hash de integridade (SRI)
-              id: sri
-              run: |
-                  HASH=$(openssl dgst -sha384 -binary dist/easyflow-sdk.${{ env.VERSION }}.min.js | openssl base64 -A)
-                  echo "SRI=sha384-${HASH}" >> "$GITHUB_ENV"
-                  echo "sha=sha384-${HASH}" >> "$GITHUB_OUTPUT"
-
-            - name: Criar arquivo de exemplo com SRI
-              run: |
-                  cat > dist/example.html << EOF
-                  <!DOCTYPE html>
-                  <html>
-                  <head>
-                      <title>Easyflow SDK Example</title>
-                  </head>
-                  <body>
-                      <h1>Easyflow SDK v${{ env.VERSION }}</h1>
-                      <script src="easyflow-sdk.${{ env.VERSION }}.min.js" 
-                              integrity="${{ env.SRI }}" 
-                              crossorigin="anonymous"></script>
-                      <script>
-                          console.log('EasyflowSDK version:', EasyflowSDK.version);
-                      </script>
-                  </body>
-                  </html>
-                  EOF
-
-            - name: Deploy para Cloudflare Pages
-              uses: cloudflare/pages-action@v1
-              with:
-                  apiToken: ${{ secrets.CF_API_TOKEN }}
-                  accountId: ${{ secrets.CF_ACCOUNT_ID }}
-                  projectName: easyflow-sdk
-                  directory: dist
-
-            - name: Verificar disponibilidade no jsDelivr
-              run: |
-                  echo "Verificando disponibilidade no jsDelivr..."
-                  echo "URL: https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@${{ env.VERSION }}/dist/easyflow-sdk.min.js"
-                  echo "Note: jsDelivr pode levar alguns minutos para sincronizar com npm"
-
-            - name: Criar Release no GitHub
-              uses: actions/create-release@v1
-              env:
-                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              with:
-                  tag_name: ${{ github.ref }}
-                  release_name: Easyflow SDK ${{ env.VERSION }}
-                  body: |
-                      ## Easyflow SDK ${{ env.VERSION }}
-
-                      ### CDNs Disponíveis
-
-                      #### Cloudflare Pages
-                      - **Latest**: `https://easyflow-sdk.pages.dev/easyflow-sdk.min.js`
-                      - **Versionado**: `https://easyflow-sdk.pages.dev/easyflow-sdk.${{ env.VERSION }}.min.js`
-
-                      #### jsDelivr CDN
-                      - **Latest**: `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@latest/dist/easyflow-sdk.min.js`
-                      - **Versionado**: `https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@${{ env.VERSION }}/dist/easyflow-sdk.min.js`
-
-                      ### SRI Hash
-                      ```
-                      sha384-${{ env.SRI }}
-                      ```
-
-                      ### Exemplo de Uso
-
-                      #### Cloudflare Pages
-                      ```html
-                      <script src="https://easyflow-sdk.pages.dev/easyflow-sdk.${{ env.VERSION }}.min.js" 
-                              integrity="sha384-${{ env.SRI }}" 
-                              crossorigin="anonymous"></script>
-                      ```
-
-                      #### jsDelivr CDN
-                      ```html
-                      <script src="https://cdn.jsdelivr.net/npm/@easyflow/javascript-sdk@${{ env.VERSION }}/dist/easyflow-sdk.min.js" 
-                              integrity="sha384-${{ env.SRI }}" 
-                              crossorigin="anonymous"></script>
-                      ```
-
-                      ### Arquivos
-                      - `easyflow-sdk.${{ env.VERSION }}.min.js` - SDK minificado
-                      - `easyflow-sdk.min.js` - SDK minificado (sem versão)
-                      - `example.html` - Exemplo de uso com SRI
-                  draft: false
-                  prerelease: false
-
-            - name: Publicar no NPM (se necessário)
-              run: |
-                  echo "Para publicar no NPM, execute manualmente:"
-                  echo "npm publish --access public"
-                  echo "Isso tornará o SDK disponível no jsDelivr automaticamente"