SDK Integration

import { PrefID } from '@prefid/sdk';

const prefid = new PrefID({
  clientId: process.env.PREFID_CLIENT_ID,
  clientSecret: process.env.PREFID_CLIENT_SECRET,
  redirectUri: 'http://localhost:3000/callback'
});

const authUrl = prefid.getAuthorizationUrl({
  scopes: ['preferences:read', 'music_preferences'],
  state: 'your-csrf-token'
});

// Redirect user to authUrl

// After user is redirected back
const tokens = await prefid.exchangeCode(authCode, codeVerifier);

// Store tokens
const { accessToken, refreshToken, expiresIn } = tokens;

const newTokens = await prefid.refreshToken(refreshToken);

const musicPrefs = await prefid.getPreferences('music_preferences', {
  accessToken: tokens.accessToken
});

console.log(musicPrefs);
// {
//   domain: "music_preferences",
//   preferences: {
//     favorite_artists: ["AR Rahman", "Coldplay"],
//     genres: ["Indian Classical", "Electronic"]
//   },
//   confidence: 0.92
// }

const prefs = await prefid.getPreferences(['music_preferences', 'food_profile'], {
  accessToken: tokens.accessToken
});

// Returns array of preference objects

const allPrefs = await prefid.getAllPreferences({
  accessToken: tokens.accessToken
});

const hints = await prefid.getAgentHints({
  accessToken: tokens.accessToken,
  domains: ['music_preferences', 'food_profile'],
  maxTokens: 100
});

console.log(hints);
// {
//   hints: [
//     "User loves AR Rahman and Indian classical music",
//     "Prefers vegetarian food, allergic to peanuts"
//   ],
//   tokenCount: 45
// }

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';

const hints = await prefid.getAgentHints({
  accessToken: userTokens.accessToken,
  domains: ['music_preferences']
});

const result = await generateText({
  model: openai('gpt-4'),
  system: `You are a music recommendation assistant. ${hints.hints.join('. ')}`,
  prompt: userMessage
});

import { ChatOpenAI } from '@langchain/openai';
import { SystemMessage, HumanMessage } from '@langchain/core/messages';

const hints = await prefid.getAgentHints({
  accessToken: userTokens.accessToken
});

const model = new ChatOpenAI({ modelName: 'gpt-4' });

const response = await model.invoke([
  new SystemMessage(`User context: ${hints.hints.join('. ')}`),
  new HumanMessage(userMessage)
]);

try {
  const prefs = await prefid.getPreferences('music_preferences', {
    accessToken: tokens.accessToken
  });
} catch (error) {
  if (error.code === 'TOKEN_EXPIRED') {
    // Refresh the token
    const newTokens = await prefid.refreshToken(tokens.refreshToken);
  } else if (error.code === 'INSUFFICIENT_SCOPE') {
    // Request additional scopes
  } else {
    console.error('PrefID error:', error.message);
  }
}

import type { 
  Preferences, 
  AgentHints, 
  Token,
  PrefIDError 
} from '@prefid/sdk';

const prefs: Preferences = await prefid.getPreferences('music_preferences');
const hints: AgentHints = await prefid.getAgentHints();

const prefid = new PrefID({
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  redirectUri: 'http://localhost:3000/callback',
  
  // Optional
  baseUrl: 'https://api.prefid.dev',  // Custom API URL
  timeout: 10000,                      // Request timeout in ms
  retries: 3,                          // Number of retries
});