Rate Limits

const response = await fetch(url, options);
const remaining = response.headers.get('X-RateLimit-Remaining');

if (remaining < 100) {
  console.warn(`Low on credits: ${remaining} remaining`);
}

// Good: Start with fast check
const quickCheck = await fastCheck(name); // 2 credits, 300-800ms

// Only run deep analysis if potential conflicts found
if (quickCheck.conflicts.length > 0) {
  const deepAnalysis = await clearanceAnalysis(name, business); // 5 credits, 3-5s
}

const cache = new Map();
const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours

async function searchWithCache(query) {
  const cacheKey = `search:${query}`;
  const cached = cache.get(cacheKey);

  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.data;
  }

  const data = await searchTrademark(query);
  cache.set(cacheKey, { data, timestamp: Date.now() });

  return data;
}

// Inefficient: Search all jurisdictions, all classes
const results = await search('tech'); // Returns thousands of results

// Efficient: Filter to relevant scope
const results = await search('tech', {
  jurisdiction: 'US',
  classes: '9,42',
  status: 'live_registered'
}); // Returns focused results, same 1 credit

// Bad: Polling wastes credits
setInterval(async () => {
  const results = await search('competitor'); // 1 credit every 5 minutes
}, 5 * 60 * 1000); // = 288 credits/day

// Good: Set up a monitor with webhooks (monthly subscription, no credits)
await createMonitor({
  watches: [{ type: 'query', value: 'competitor' }],
  webhook_url: 'https://myapp.com/webhooks'
});

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) {
      return response;
    }

    const resetTime = response.headers.get('X-RateLimit-Reset');
    const waitTime = Math.min(
      (2 ** i) * 1000,
      resetTime * 1000 - Date.now()
    );

    console.log(`Rate limited. Waiting ${waitTime}ms...`);
    await new Promise(resolve => setTimeout(resolve, waitTime));
  }

  throw new Error('Max retries exceeded');
}

// Inefficient: Search all offices, all classes
const results = await search('tech'); // Returns thousands of results

// Efficient: Filter to relevant scope
const results = await search('tech', {
  office: 'USPTO',
  classes: '9,42',
  status: 'live_registered'
}); // Returns focused results, same 1 credit