Disposable Armor API

// Example: Signup validation logic
async function validateSignup(email) {
  const response = await fetch(`/api/v1/check?email=${email}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  const data = await response.json();
  
  // Block disposable emails
  if (data.is_temporary) {
    return { allowed: false, reason: 'Disposable email not allowed' };
  }
  
  // Block invalid emails
  if (data.email_quality?.confidence.invalid >= 80) {
    return { allowed: false, reason: 'Invalid email format' };
  }
  
  // Block likely bots
  if (data.email_quality?.confidence.bot_generated >= 60) {
    return { allowed: false, reason: 'Suspicious email pattern', requireCaptcha: true };
  }
  
  // Flag aliases for duplicate checking
  if (data.email_quality?.confidence.alias >= 40) {
    const normalizedEmail = data.email_quality.alias_detection.normalized_email;
    const existingUser = await checkExistingUser(normalizedEmail);
    if (existingUser) {
      return { allowed: false, reason: 'Account already exists' };
    }
  }
  
  // Optionally require personal emails (block role accounts)
  if (data.email_quality?.confidence.role_account >= 70) {
    return { allowed: false, reason: 'Please use a personal email address' };
  }
  
  return { allowed: true, riskScore: data.email_quality?.risk_score || 0 };
}