Events & Interceptors

// Auth events
client.on('auth:login', (data) => { /* { email } */ });
client.on('auth:logout', () => { });
client.on('auth:token-refresh', () => { });
client.on('auth:token-refresh-failed', () => { });

// Cart events
client.on('cart:updated', (cart) => { });
client.on('cart:cleared', () => { });

// Order events
client.on('order:created', (order) => { });

// Network events
client.on('request', ({ method, path }) => { });
client.on('response', ({ method, path, status }) => { });
client.on('error', (error) => { });

// Rate limiting
client.on('rate-limit-warning', ({ remaining, reset }) => { });

const unsubscribe = client.on('cart:updated', handler);
// Later:
unsubscribe();

client.addRequestInterceptor(async (config) => {
  // Add custom header
  config.headers['X-Custom'] = 'value';
  
  // Log all requests
  console.log(`${config.method} ${config.url}`);
  
  return config;
});

client.addResponseInterceptor(async ({ status, data, headers }) => {
  // Analytics
  analytics.track('api_call', { status });
});

const { remaining, reset } = client.getRateLimitInfo();
if (remaining !== null && remaining <= 5) {
  console.warn('Rate limit approaching');
}