This PR extends the existing auto-retry functionality to handle transient network errors in addition to HTTP 429 responses. Previously, the autoRetry feature only retried on rate limiting errors, but intermittent network failures like ECONNRESET, ETIMEDOUT, and ECONNABORTED would cause requests to fail immediately.

Changes Made

• Added network error detection: New isRetryableError() function identifies transient network errors that should be retried
• Extended retry logic: Added getExponentialBackoffErrorHandler() that reuses the existing exponential backoff algorithm for network errors
• Updated interceptors: Modified the RequestClient constructor to register both response and error interceptors when autoRetry is enabled
• Updated documentation: Enhanced JSDoc comments and README to reflect that network errors are now retried
• Comprehensive test coverage: Added extensive test cases covering error identification, configuration options, interceptor registration, and edge cases

Retryable Network Errors

The implementation conservatively retries only clearly transient network errors:

• ECONNRESET - Connection reset by peer
• ETIMEDOUT - Request timeout
• ECONNABORTED - Request aborted

Configuration

Uses the same configuration options as the existing 429 retry functionality:

• autoRetry: true - Enables retry for both 429 responses and network errors
• maxRetries: 3 - Maximum retry attempts (default 3)
• maxRetryDelay: 3000 - Maximum delay between retries in milliseconds (default 3000)

Example

const client = require('twilio')(accountSid, authToken, {
 autoRetry: true,
 maxRetries: 3,
});
// Now automatically retries on both:
// - HTTP 429 Too Many Requests responses
// - Network errors like ECONNRESET, ETIMEDOUT, ECONNABORTED

Testing

• All existing tests continue to pass
• Added comprehensive unit tests for network error retry scenarios covering:
  • Error code identification and retryable error patterns
  • Configuration options validation
  • Interceptor registration behavior
  • Various error object structures and edge cases
• Manual integration testing confirmed retry behavior with simulated connection failures
• Total test coverage: 26 test suites, 323 tests passing
• TypeScript compilation successful

This change improves the resilience of Twilio API calls without breaking existing functionality or requiring any configuration changes for users who want the enhanced behavior.

Fixes #1023.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.