axios-token-refresh is a lightweight and powerful utility for handling token refresh logic in Axios. It seamlessly integrates with Axios interceptors to automatically retry failed requests after token expiration. Perfect for managing authentication flows in modern web applications.

• Features
• Installation
• Demo
• Example Usage
• Configuration Options
• Contributing
• License

• Automatically retries requests after refreshing tokens.
• Configurable retry logic and status codes.
• Lightweight and easy to integrate with Axios.

With npm:

npm install axios-token-refresh

With yarn:

yarn add axios-token-refresh

With bun:

bun add axios-token-refresh

You can see quickly demo here.

Here is an example of how to use axios-token-refresh in your project:

import axios from 'axios';
import registerAxiosTokenRefresh from 'axios-token-refresh';

// Create an Axios instance
const apiClient = axios.create({
  baseURL: 'https://api.example.com',
});

// Define the refresh token function
const refreshAuthLogic = (failedRequest) =>
  axios.post('https://api.example.com/refresh-token', {
    token: localStorage.getItem('refreshToken'),
  }).then((tokenRefreshResponse) => {
    localStorage.setItem('accessToken', tokenRefreshResponse.data.accessToken);
    failedRequest.response.config.headers['Authorization'] = 'Bearer ' + tokenRefreshResponse.data.accessToken;
    return Promise.resolve(failedRequest);
  });

// Add the interceptor to the Axios instance
registerAxiosTokenRefresh(apiClient, { refreshRequest: refreshAuthLogic });

// Example API request
apiClient.get('/protected-resource', {
  headers: {
    Authorization: 'Bearer ' + localStorage.getItem('accessToken'),
  },
}).then((response) => {
  console.log('Protected resource data:', response.data);
}).catch((error) => {
  console.error('Error fetching protected resource:', error);
});

Below is a table describing the available options for configuring token refresh behavior:

• Lightweight: Minimal overhead, designed to integrate seamlessly with Axios.
• Customizable: Configure retry logic, status codes, and token refresh behavior.
• Easy to Use: Simple API for quick integration into your project.
• Reliable: Automatically retries failed requests after token expiration.
• Flexible: Works with any authentication flow, including OAuth and JWT.

Contributions are welcome! Please see the CONTRIBUTING.md file for guidelines on how to contribute to this project.

If you encounter any issues or have questions, please open an issue on GitHub or start a discussion in the Discussions section.

axios-token-refresh is a utility for handling token refresh logic in Axios. It is ideal for managing authentication flows, retrying failed requests, and integrating with OAuth or JWT-based systems. Lightweight, customizable, and easy to use.