SDKs Overview

​

Available SDKs

​

Frontend SDKs

React SDK

Build interactive analytics interfaces in React applications

• React 18+ support
• Custom hooks
• LangChain integration

Next.js SDK

Server-side rendering and App Router support

• Next.js 13+ support
• Server Components
• API route handlers

Angular SDK

Create powerful analytics components in Angular applications

• Angular 17.3+ support
• Injectable services
• Standalone components

Vue SDK

Integrate analytics seamlessly in Vue 3 applications

• Vue 3.0+ support
• Composition API
• Vite integration

React Native SDK

Add analytics to your iOS and Android applications

• React Native 0.73+ support
• Native components
• Deep linking

Vanilla JavaScript SDK

Use Suada with plain JavaScript or any web framework

• Framework agnostic
• CDN support
• UMD/ESM formats

​

Backend SDKs

​

Quick Comparison

​

Core Features

​

🔒 OAuth Integration

1. Initialize Connection
   • User clicks connect button
   • SDK handles OAuth redirect
   • Secure token exchange
2. Authorization
   • User authenticates with provider
   • Secure callback handling
   • Token management
3. Integration Complete
   • Success confirmation
   • Ready to use

​

🛠️ Common Features

• Type Safety: Built-in TypeScript/type hints support
• Error Handling: Comprehensive error types and handling
• API Consistency: Similar patterns across all SDKs
• LangChain Support: Integration with LangChain (Node.js and Python)
• Passthrough Mode: Support for using with external user identifiers

​

Getting Started

​

Prerequisites

• A Suada API key
• Node.js 16.0.0 or higher (for JavaScript/TypeScript SDKs)
• Python 3.8+ (for Python SDK)
• Your preferred package manager

​

Installation

# React/Next.js/Angular/Vue/React Native/Node.js
npm install @suada/[sdk-name] @suada/core

​

Environment Setup

# React/Vue/Angular
VITE_SUADA_API_KEY=your-api-key
VITE_SUADA_BASE_URL=https://api.suada.ai

# Next.js
NEXT_PUBLIC_SUADA_API_KEY=your-api-key
NEXT_PUBLIC_SUADA_BASE_URL=https://api.suada.ai

# React Native
SUADA_API_KEY=your-api-key
SUADA_BASE_URL=https://api.suada.ai

# Node.js/Python
SUADA_API_KEY=your-api-key
SUADA_BASE_URL=https://api.suada.ai

​

Basic Integration

1. Install SDK
   Copy

   npm install @suada/react @suada/core
   

2. Configure Provider
   Copy

   import { SuadaProvider } from '@suada/react';
   
   function App() {
     return (
       <SuadaProvider config={{
         apiKey: process.env.SUADA_API_KEY
       }}>
         <YourApp />
       </SuadaProvider>
     );
   }
   

3. Add Components
   Copy

   <IntegrationButton provider="notion" />
   

​

Best Practices

​

Security

• Store API keys in environment variables
• Use HTTPS for all API calls
• Implement proper error handling
• Secure OAuth callback endpoints
• Validate user sessions

​

Performance

• Initialize SDK instances once and reuse them
• Implement proper cleanup
• Handle offline scenarios
• Optimize network requests
• Use proper caching

​

Development

• Use TypeScript/type hints when available
• Follow framework best practices
• Write unit tests
• Keep dependencies updated
• Use proper error boundaries

​

FAQ

​

How do I handle OAuth callbacks?

1. Set up your callback URL in the Suada dashboard
2. Configure the redirect URI in your component
3. Handle the callback in your application

// Example callback handler
const handleCallback = async (code: string) => {
  try {
    await suada.handleOAuthCallback(code);
    // Handle success
  } catch (error) {
    // Handle error
  }
};

​

How do I manage user sessions?

1. Use the built-in session management
2. Implement proper cleanup
3. Handle token refresh

// Example session management
const { session, refreshToken } = useSession();

// Refresh token when needed
await refreshToken();

​

How do I debug integration issues?

1. Enable debug mode
2. Check network requests
3. Validate OAuth flow

// Enable debug mode
const suada = new Suada({
  debug: true,
  logger: console.log
});

​

How do I handle offline scenarios?

1. Implement proper error handling
2. Use retry mechanisms
3. Cache responses

// Example offline handling
const handleRequest = async () => {
  try {
    return await suada.request();
  } catch (error) {
    if (error.code === 'OFFLINE') {
      // Handle offline scenario
    }
  }
};

​

Support & Resources

​

Documentation

• API Reference
• Component Library
• Integration Guides
• Framework Best Practices
• Performance Guide

​

Support

• Email Support: hello@suada.ai