API Documentation

// Using fetch in browser or Node.js with node-fetch
async function formatCode(code, language = null, options = {}) {
  try {
    const response = await fetch('https://web-formatter.com/api/v2/format', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        code,
        language,
        options: {
          indentSize: 2,
          useTabs: false,
          minify: false,
          ...options
        }
      })
    });
    
    // Check rate limit headers
    const rateLimit = {
      limit: parseInt(response.headers.get('X-RateLimit-Limit') || '100'),
      remaining: parseInt(response.headers.get('X-RateLimit-Remaining') || '0'),
      resetSeconds: parseInt(response.headers.get('X-RateLimit-Reset') || '0')
    };
    
    console.log(`Rate limit: ${rateLimit.remaining}/${rateLimit.limit} requests remaining`);
    
    // Handle rate limiting
    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      throw new Error(`Rate limit exceeded. Try again in ${retryAfter} seconds.`);
    }
    
    // Handle other errors
    if (!response.ok) {
      if (response.status === 413) {
        throw new Error('Payload too large. Code exceeds the maximum size limit.');
      } else if (response.status === 422) {
        throw new Error('Code could not be formatted due to syntax errors.');
      } else if (response.status === 500) {
        throw new Error('Server error occurred. Please try again later.');
      }
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    
    if (!data.success) {
      throw new Error(data.error || 'Unknown error occurred');
    }
    
    return data;
  } catch (error) {
    console.error('Error formatting code:', error);
    throw error;
  }
}

// Example with advanced retry logic for rate limits
async function formatWithRetry(code, language = null, options = {}, maxRetries = 3) {
  let retries = 0;
  
  while (retries < maxRetries) {
    try {
      return await formatCode(code, language, options);
    } catch (error) {
      if (error.message.includes('Rate limit exceeded') && retries < maxRetries - 1) {
        retries++;
        const retrySeconds = parseInt(error.message.match(/in (\d+) seconds/)[1]) || 60;
        console.log(`Rate limited. Waiting ${retrySeconds} seconds before retry ${retries}...`);
        await new Promise(resolve => setTimeout(resolve, retrySeconds * 1000));
      } else {
        throw error;
      }
    }
  }
}

// Example usage
(async () => {
  try {
    const code = `function hello() {
  console.log("Hello");
}`;

    const result = await formatWithRetry(code, 'javascript');
    
    console.log('Formatted code:', result.formattedCode);
    console.log('Language detected:', result.language);
    console.log('Validation:', result.validation);
    console.log('Stats:', result.stats);
  } catch (error) {
    console.error('Failed to format code:', error.message);
  }
})();