docs: add readme and changelog notes, add comment to dio mixin

CHANGELOG.md

@@ -6,6 +6,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## 0.2.9 - Released on 2023-11-09
+
+- Updated the dio package to version 5.3.3
+- Upgraded the mutex package to version 3.1.0
+- Added a new Dio mixin
+
 ## [0.2.8] - 2023-09-13
 
 - Adds 1.18 to the list of supported FDI versions

README.md

@@ -86,6 +86,17 @@ void setup() {
 }
 ```
 
+Or use instance method instead.
+
+```dart
+import 'package:supertokens_flutter/dio.dart';
+
+void setup() {
+  Dio dio = Dio();  // Create a Dio instance.
+  dio.addSupertokensInterceptor();
+}
+```
+
 #### Making network requests
 
 ```dart

lib/dio.dart

@@ -1 +1,2 @@
 export 'src/dio-interceptor-wrapper.dart' show SuperTokensInterceptorWrapper;
+export "src/supertokens_dio_extension.dart" show SuperTokensDioExtension;

lib/src/supertokens_dio_extension.dart

@@ -1,8 +1,19 @@
 import 'package:dio/dio.dart';
 import 'package:supertokens_flutter/src/dio-interceptor-wrapper.dart';
 
+/// Mixin for easy Dio instance setup.
+///
+/// Usage:
+/// ```dart
+///
+/// final dio = Dio()
+///   ..addSupertokensInterceptor()
+///   ..addSentry()
+///   // ...
+/// ```
 extension SuperTokensDioExtension on Dio {
-    void addSupertokensInterceptor() {
-      this.interceptors.add(SuperTokensInterceptorWrapper(client: this));
-    }
-}
+  /// Adds the SuperTokens interceptor to the Dio instance.
+  void addSupertokensInterceptor() {
+    this.interceptors.add(SuperTokensInterceptorWrapper(client: this));
+  }
+}

lib/supertokens.dart

@@ -5,5 +5,4 @@
 library supertokens;
 
 export "src/supertokens.dart";
-export "src/errors.dart";
-export "src/supertokens_dio_extension.dart";
+export "src/errors.dart";