RestApi

const myRestApi = new RestApi( 'https://api.example.com' );
myRestApi.get( '/books', function( err, result ) { } );

const myRestApi = new RestApi( 'https://api.example.com' );
try
{
    const result = await myRestApi.get( '/books' );
}
catch( e )
{
    // Handle error
}

const myRestApi = new RestApi( 'https://api.example.com', {}, {
    timeout: 10000,      // 10 second timeout
    retryAttempts: 3,    // Retry up to 3 times
    retryDelay: 1000     // Wait 1 second between retries
});

const result = await myRestApi.get('/books', null, {
    timeout: 5000,       // Override to 5 second timeout
    retryAttempts: 1     // Override to 1 retry attempt
});

myRestApi.addHeader('Authorization', 'Bearer token123');
myRestApi.addHeader('Content-Type', 'application/json');
myRestApi.removeHeader('Content-Type');
const headers = myRestApi.getHeaders(); // Get copy of current headers

// Simple query parameters
const books = await myRestApi.get('/books', null, {
    queryParams: { page: 1, limit: 10, search: 'javascript' }
});
// Results in: GET /books?page=1&limit=10&search=javascript

// Array parameters
const filtered = await myRestApi.get('/books', null, {
    queryParams: { tags: ['fiction', 'drama'], author: 'Shakespeare' }
});
// Results in: GET /books?tags=fiction&tags=drama&author=Shakespeare

// Make a request and get the request ID
const { requestId, result } = await myRestApi.get('/large-data');

// Make a request with callback and get request ID immediately
const { requestId } = await myRestApi.get('/books', (err, result) => {
    if (err) console.error('Request failed:', err);
    else console.log('Books:', result);
});

// Cancel the specific request
const cancelled = myRestApi.cancelRequest(requestId);
console.log('Request cancelled:', cancelled);

// Check if request is still pending
if (myRestApi.isRequestPending(requestId)) {
    console.log('Request is still running');
}

// Get all pending requests
const pending = myRestApi.getPendingRequests();
console.log('Pending requests:', pending);

// Cancel all requests
myRestApi.abortAll();

// Upload progress tracking
const formData = new FormData();
formData.append('file', fileInput.files[0]);

const { requestId } = await myRestApi.post('/upload', formData, null, {
    onUploadProgress: (progress) => {
        console.log(`Upload: ${progress.percent}% (${progress.loaded}/${progress.total} bytes)`);
        // Update progress bar: progressBar.value = progress.percent;
    }
});

// Download progress tracking
const { requestId, result } = await myRestApi.get('/large-file', null, {
    onDownloadProgress: (progress) => {
        console.log(`Download: ${progress.percent}% (${progress.loaded}/${progress.total} bytes)`);
        // Update progress bar: downloadBar.value = progress.percent;
    }
});

// Both upload and download progress
const { requestId } = await myRestApi.put('/documents/123', documentData, null, {
    onUploadProgress: (progress) => {
        console.log('Uploading:', progress.percent + '%');
    },
    onDownloadProgress: (progress) => {
        console.log('Downloading response:', progress.percent + '%');
    }
});