feat(dart): add Dio HttpClientAdapter to ClientOptions

[techouse]

🧭 What and Why

This PR gives the user the ability to optionally provide a custom Dio HttpClientAdapter, i.e.

final SearchClient client = SearchClient(
  appId: 'foo',
  apiKey: 'bar',
  options: ClientOptions(
    httpClientAdapter: NativeAdapter(), // <-- from https://pub.dev/packages/native_dio_adapter
  ),
);

Via this option users can configure Dio to use native_dio_adapter which uses cupertino_http on iOS and cronet_http on Android to delegate HTTP requests to the native platform instead of the dart:io platforms.

The advantages of using cronet_http are:

• It automatically supports Android platform features such as HTTP proxies.
• It supports configurable caching.
• It supports more HTTP features such as HTTP/3.

The advantages of using cupertino_http are:

• It automatically supports iOS/macOS platform features such VPNs and HTTP proxies.
• It supports many more configuration options such as only allowing access through WiFi and blocking cookies.
• It supports more HTTP features such as HTTP/3 and custom redirect handling.

Changes included:

• add HttpClientAdapter? to ClientOptions

---

Supersedes algolia/algoliasearch-client-dart#13
Addresses algolia/algoliasearch-client-dart#12

[shortcuts]

looks awesome, thanks a lot for the contribution

@aallam wdyt?

[techouse]

Not sure why the codegen job fails 😅

[shortcuts]

Not sure why the codegen job fails 😅

ah we provide a ref to the checkout action which might not work with forks D:

[techouse]

Not sure why the codegen job fails 😅

ah we provide a ref to the checkout action which might not work with forks D:

Ah, makes sense. Bots and their permissions 🙈