Akadenia API

An opinionated wrapper around axios library

License

MIT

Installation

npm install @akadenia/api

Usage

Importing the Axios Client

import { AxiosApiClient } from "@akadenia/api";

Instantiating the Axios Client

const headers = {
  "Content-Type": "application/json",
};
const client = new AxiosApiClient({
  baseUrl: "https://baseurl",
  headers,
});

Making a GET request

type User = {
    id: number
    firstName: string
    lastName: string
}

const response = await client.get<User>("/users/1")
if (response.success) {
    console.log(response.data.firstName)
    console.log(response.data.lastName)
} else {
    console.log(response.error)
}

Making a POST request

type User = {
    id: number
    firstName: string
    lastName: string
}

const payload = {
    firstName: "John",
    lastName: "Doe"
}
const response = await client.post<User>("/users", payload)
if (response.success) {
    console.log(response.data)
} else {
    console.log(response.error)
}

console.log(response.message)

Making a PUT request

const payload = {
  firstName: "Lisa",
  lastName: "Smith",
};
const response = await client.put("/users/1", payload);
if (response.success) {
  console.log(response.data);
} else {
  console.log(response.error);
}

console.log(response.message);

Making a DELETE request

const response = await client.delete("/users/1");

if (response.success) {
  console.log(response.message);
} else {
  console.log(response.error);
}

Default response structure

   {
    success: false
    message: string
    data?: any
    error: any
  }

Configuring Retry Logic

The AxiosApiClient supports configurable retry logic for failed requests based on the axios-retry library. You can customize the retry behavior when instantiating the client:

const client = new AxiosApiClient({
  baseUrl: "https://baseurl",
  retries: 3, // Number of retries
  retryDelay: (retryCount) => retryCount * 1000, // Wait 1 second on first retry, 2 seconds on second retry, etc.
  onRetry: (retryCount, error) => {
    console.log(`Retry attempt ${retryCount} for error: ${error.message}`);
  }, // Callback function to be called on retry
});