Echo React SDK

React SDK for Echo OAuth2 + PKCE authentication and token management.

Install

pnpm install @zdql/echo-react-sdk

Setup

import { EchoProvider, EchoSignIn, useEcho } from '@zdql/echo-react-sdk';

// 1. Wrap your app
<EchoProvider config={{ appId: 'your-app-id' }}>
  <App />
</EchoProvider>

// 2. Add sign-in
<EchoSignIn onSuccess={(user) => console.log(user)} />

// 3. Use authentication state
const { user, balance, isAuthenticated, signOut } = useEcho();

CSP Requirements

Add to your Content Security Policy:

connect-src https://echo.merit.systems;

Components

// Custom sign-in button
<EchoSignIn>
  <button>Sign In with Echo</button>
</EchoSignIn>

// Token purchase
<EchoTokenPurchase
  amount={100}
  onPurchaseComplete={(balance) => console.log(balance)}
/>

// Authentication state
const {
  user,           // { id, email, name }
  balance,        // { credits, currency }
  isAuthenticated,
  signIn,
  signOut,
  refreshBalance
} = useEcho();

Config

<EchoProvider config={{
  appId: 'your-app-id',                    // required
  apiUrl: 'https://echo.merit.systems',         // optional (default)
  redirectUri: 'http://localhost:3000',         // optional
  scope: 'llm:invoke offline_access'            // optional
}}>