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 🙈

[aallam]

Nice! we already have interceptors, and I see no issue of adding HttpClientAdapter too.

[shortcuts]

All CTS should fail because of e2e, I'll open a PR with your commits and merge them into main

[shortcuts]

ah nvm there's no e2e for dart, all good then

[shortcuts]

superseded by #3326 thanks a lot @techouse for the contribution!!

[shortcuts]

(i'll co author you obviously)

[techouse]

Roger that 🫡