Reference

// YOUR backend - never expose API keys
const session = await vault.createConnectSession({
  allowedProviders: ['google', 'slack'],
  allowedOrigin: 'https://yourapp.com',  // Optional, see below
});
// Pass session.sessionToken to your frontend

const alterConnect = AlterConnect.create({
  debug: true  // Enable console logging (default: false)
});

await alterConnect.open({
  // Required
  token: sessionToken,             // From your backend
  onSuccess: (connections) => {}, // Called with array of Connection objects

  // Optional
  onError: (error) => {},        // Error callback
  onExit: () => {},              // Called when user closes without connecting
  onEvent: (name, meta) => {},   // Analytics events
});

interface Connection {
  grant_id: string;           // Unique ID for this grant
  provider: string;            // Provider ID (e.g., 'google')
  provider_name: string;       // Display name (e.g., 'Google')
  account_identifier: string;  // User's email/username
  timestamp: string;           // ISO 8601 timestamp
  operation: 'creation' | 'reauth';  // How the grant was established
  scopes: string[];           // OAuth scopes granted
  status: 'active' | 'pending' | 'error';
  metadata?: {                // Optional provider-specific data
    account_display_name?: string;
    account_email?: string;
  };
}

await alterConnect.open({
  token: sessionToken,
  onSuccess: (connections) => {
    // User completed OAuth! Save each grant_id to your database, mapped to your user.
    for (const conn of connections) {
      saveConnection(currentUser.id, conn.grant_id, conn.provider);
    }
  },
  onError: (error) => {
    console.error('Connection failed:', error);

    switch(error.code) {
      case 'popup_blocked':
        // Browser blocked the popup
        alert('Please allow popups for this site');
        break;
      case 'oauth_error':
        // OAuth provider issue
        alert('Provider error. Please try again.');
        break;
      case 'network_error':
        // Could not reach Alter API
        alert('Network error. Please check your connection.');
        break;
      case 'timeout':
        // Request timed out
        alert('Request timed out. Please try again.');
        break;
      default:
        alert('Connection failed. Please try again.');
    }
  }
});

import AlterConnect, {
  AlterConnectConfig,
  OpenOptions,
  Connection,
  AlterError
} from '@alter-ai/connect';

const config: AlterConnectConfig = {
  debug: true
};

const alterConnect = AlterConnect.create(config);

// Analytics events via onEvent callback
await alterConnect.open({
  token: sessionToken,
  onSuccess: (connections) => { /* ... */ },
  onEvent: (eventName, metadata) => {
    console.log('Event:', eventName, metadata);
    // Fires: 'connect_opened' when popup opens
  }
});

// Or use the on() method for global listeners
alterConnect.on('success', (connections) => {
  console.log('Connection successful:', connections);
});

alterConnect.on('error', (error) => {
  console.log('Connection error:', error);
});