Usage & Billing

// ❌ Expensive: Fetching 1000 snippets
// Cost: 1000 requests
const result = await api.get('/snippets', {
  params: { ids: thousandSnippetIds }
});

// ✅ Better: Fetch only what you need
// Cost: 10 requests
const result = await api.get('/snippets', {
  params: { ids: tenMostRecentIds }
});

// ✅ Best: Use pagination to spread costs
// Cost: 1 + 10 = 11 requests
const folder = await api.get('/folder', {
  params: { folderId: 'id', limit: 10, offset: 0 }
});

class SnippetCache {
  constructor(ttl = 5 * 60 * 1000) { // 5 minutes
    this.cache = new Map();
    this.ttl = ttl;
  }
  
  async get(id) {
    const cached = this.cache.get(id);
    if (cached && Date.now() - cached.timestamp < this.ttl) {
      console.log('Cache hit - saved 1 request');
      return cached.data;
    }
    
    // Cache miss - fetch from API
    const data = await fetchSnippet(id);
    this.cache.set(id, {
      data,
      timestamp: Date.now()
    });
    return data;
  }
  
  invalidate(id) {
    this.cache.delete(id);
  }
}

// ❌ Expensive: Fetch all snippets at once
// If folder has 1000 snippets, cost: 1 + 1000 = 1001 requests
const folder = await api.get('/folder', {
  params: { folderId: 'id', limit: 100 }  // max limit
});

// ✅ Efficient: Fetch only what's needed for UI
// Cost: 1 + 20 = 21 requests
const folder = await api.get('/folder', {
  params: { folderId: 'id', limit: 20 }  // show 20 per page
});

// Load more on demand
const nextPage = await api.get('/folder', {
  params: { folderId: 'id', limit: 20, offset: 20 }
});

// ❌ Expensive: Fetch all history
// If variation has 500 versions, cost: 500 requests
const history = await api.get('/snippet/variation/history', {
  params: { variationId: 'id' }  // no limit
});

// ✅ Efficient: Limit history records
// Cost: 10 requests
const history = await api.get('/snippet/variation/history', {
  params: {
    variationId: 'id',
    limit: 10  // Only last 10 versions
  }
});

// ✅ Even better: Use date filtering
// Cost: ~5 requests (only recent changes)
const history = await api.get('/snippet/variation/history', {
  params: {
    variationId: 'id',
    fromDate: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString(),
    limit: 100
  }
});

// ❌ Wasteful: Using batch endpoint for 1-2 items
// Cost: 2 requests
const result = await api.get('/snippets', {
  params: { ids: 'id1,id2' }
});

// ✅ Efficient: Use single endpoint
// Cost: 2 requests (same cost, but simpler)
const snippet1 = await api.get('/snippet', { params: { id: 'id1' }});
const snippet2 = await api.get('/snippet', { params: { id: 'id2' }});

// ✅ When batch makes sense (10+ items)
// Much better than 50 individual calls
const result = await api.get('/snippets', {
  params: { ids: fiftyIds }
});