v2.0.0

[L-Blondy]

New Features & Improvements

• 🔄 Retry System: Built-in retry functionality for handling transient failures gracefully
• 📊 Progress Tracking: Monitor both upload and download progress with onResponseStreaming and onRequestStreaming
• 🎯 Enhanced Lifecycle Hooks: Now available directly on fetcher instances for more granular control
• ⚡ Async Configuration: up now supports asynchronous functions as its second argument
• 🐛 Better Error Handling: Improved ValidationError readability for easier debugging

Changelog

(new) Retry

The retry system is now built-in and handles transient failures gracefully.

const fetcher = up(fetch, () => ({
   retry: {
      when: (ctx) => ctx.response?.ok === false,
      attempts: 3,
      delay: 1000,
   },
}))

(new) Progress & Streaming

Progress tracking is now available for both upload and download operations through the onResponseStreaming and onRequestStreaming options:

upfetch('/download', {
   onResponseStreaming: ({ transferredBytes, totalBytes }) => {
      console.log(`Progress: ${transferredBytes} / ${totalBytes}`)
   },
})

(improved) Lifecycle Hooks

Lifecycle hooks are now available directly on the fetcher instance for more granular control:

upfetch('/download', {
   onError(error, request) {
      console.log(error, request)
   },
})

(improved) Async Configuration

The up function now supports asynchronous functions as its second argument:

const fetcher = up(fetch, async () => {
   const jwt = await AsyncStorage.getItem('JWT')
   return {
      headers: { Authorization: `Bearer ${jwt}` },
   }
})

(breaking) Deprecated Options Removal

• throwResponseError → renamed to reject (available since 1.3.4)
• parseResponseError → renamed to parseRejected (available since 1.3.4)

Before (v1)

const upfetch = up(fetch, () => ({
   throwResponseError: (res) => !res.ok,
   parseResponseError: (res) => new Error('Ooops'),
}))

After (v2)

const upfetch = up(fetch, () => ({
   reject: (res) => !res.ok,
   parseRejected: (res) => new Error('Ooops'),
}))

(breaking) Simplified Callback Options

All callbacks and ResponseError now receive a standard Request object instead of resolved options, aligning with web standards.

Before (v1)

up(fetch, () => ({
   onRequest: (options) => console.log(options.input),
   onSuccess: (data, options) => console.log(options.input),
   parseResponse: (response, options) => console.log(options.input),
   parseRejected: (response, options) => console.log(options.input),
   onError: (error, options) => {
      if (isResponseError(error)) {
         console.log(error.options)
      }
   },
}))

After (v2)

up(fetch, () => ({
   onRequest: (request) => console.log(request.url),
   onSuccess: (data, request) => console.log(request.url),
   parseResponse: (response, request) => console.log(request.url),
   parseRejected: (response, request) => console.log(request.url),
   onError: (error) => {
      if (isResponseError(error)) {
         console.log(error.request)
      }
   },
}))

Most users will not be affected by the Breaking Changes, as they primarily impact advanced use cases and deprecated features. The core functionality of up-fetch remains unchanged.

---

This discussion was created from the release v2.0.0.