🎉 Add Offline Saving & Delete

Author: drexhacker

CHANGELOG.md

@@ -1,3 +1,19 @@
+## [0.0.3] - 2024-12-08
+
+### Improvements
+- Added Offline Handling for `save` and `delete` methods
+- Change `CHANGELOG.md` to Descending ordering.
+### Comments
+- Thanks to all those who take time to like this package.
+- Am actively looking for contributors of this package, as a solo contributor I can't do much.
+- You can contribute either in the documentation, review, test, code and maintenance.
+
+## [0.0.2] - 2024-11-23
+
+### Improvements
+- Fixed Flutter Data Documentation Link
+- Fixed Bug in the Adapter's `sendRequest`
+
 ## [0.0.1] - 2024-11-23
 
 ### Added
@@ -41,9 +57,3 @@
 - This is the initial release and should be considered beta
 - Feedback and contributions are welcome
 - Testing in production environments is recommended before critical usage
-
-## [0.0.2] - 2024-11-23
-
-### Improvements
-- Fixed Flutter Data Documentation Link
-- Fixed Bug in the Adapter's `sendRequest`

README.md

@@ -27,7 +27,7 @@ Add this to your package's pubspec.yaml file:
 
 ```yaml
 dependencies:
-  appwrite_offline: ^0.0.1
+  appwrite_offline: ^0.0.3
 ```
 
 ## Setup

lib/adapters/appwrite.dart

@@ -4,6 +4,7 @@ import 'dart:async';
 import 'dart:convert';
 
 import 'package:appwrite_offline/config.dart';
+import 'package:appwrite_offline/extensions/framework.dart';
 import 'package:appwrite_offline/models.dart';
 import 'package:flutter_data/flutter_data.dart';
 import 'package:appwrite/appwrite.dart';
@@ -297,9 +298,46 @@ mixin AppwriteAdapter<T extends DataModel<T>> on RemoteAdapter<T> {
         statusCode: 200,
       );
       return onSuccess(data, label);
-    } on AppwriteException catch (e) {
+    } on AppwriteException catch (error) {
       // AppwriteException thrown
-      return onError(DataException(e), label);
+      // Check Offline Error
+      if (isOfflineError(error)) {
+        // queue a new operation if:
+        //  - this is a network error and we're offline
+        //  - the request was not a find
+        if (method != DataRequestMethod.GET) {
+          OfflineOperation<T>(
+            httpRequest: '${method.toShortString()} $uri',
+            label: label,
+            timestamp: DateTime.now().millisecondsSinceEpoch,
+            body: body?.toString(),
+            headers: headers,
+            onSuccess: onSuccess as OnSuccessGeneric<T>,
+            onError: onError as OnErrorGeneric<T>,
+            adapter: this as RemoteAdapter<T>,
+          ).add();
+        }
+
+        // wrap error in an OfflineException
+        final offlineException = OfflineException(error: error);
+
+        // call error handler but do not return it
+        // (this gives the user the chance to present
+        // a UI element to retry fetching, for example)
+        onError(offlineException, label);
+
+        // instead return a fallback model from local storage
+        switch (label.kind) {
+          case 'findAll':
+            return findAll(remote: false) as Future<R?>;
+          case 'findOne':
+          case 'save':
+            return label.model as R?;
+          default:
+            return null;
+        }
+      }
+      return onError(DataException(error), label);
     } catch (e) {
       // Other Exception thrown
       return onError(DataException(e), label);

lib/extensions/framework.dart

@@ -0,0 +1,13 @@
+import 'dart:async';
+
+import 'package:flutter_data/flutter_data.dart';
+
+extension ToStringX on DataRequestMethod {
+  String toShortString() => toString().split('.').last;
+}
+
+typedef OnSuccessGeneric<R> = FutureOr<R?> Function(
+    DataResponse response, DataRequestLabel label);
+
+typedef OnErrorGeneric<R> = FutureOr<R?> Function(
+    DataException e, DataRequestLabel label);

pubspec.yaml

@@ -1,6 +1,6 @@
 name: appwrite_offline
 description: "A Flutter Data adapter for Appwrite that provides offline support, real-time updates, and seamless integration with Flutter Data's powerful features."
-version: 0.0.2
+version: 0.0.3
 homepage: https://github.com/cybroidtech/appwrite_offline
 repository: https://github.com/cybroidtech/appwrite_offline
 issue_tracker: https://github.com/cybroidtech/appwrite_offline/issues