feat: ready for 0.9.0+6 released.

Author: limcheekin

CHANGELOG.md

@@ -11,10 +11,17 @@ Changes to the project are tracked using build numbers behind the version number
 
 ## [Unreleased]
 
+## [0.9.0+6] - 2024-03-13
+
+- Feat: Upgraded to surrealdb.wasm 0.9.0, the official release of wasm module of the surrealdb 1.3.0.
+- Feat: API breaking changes:
+  - `db.select()` and `db.query()` that return single result, no longer requiring casting to `List` and retrieval by `.first`.
+- Fix: Catched the error `Encountered a non-object value in array` within the library, preventing it from being exposed to the user. Reported the bug at [surrealdb.wasm#56](https://github.com/surrealdb/surrealdb.wasm/issues/56).
+
 
 ## [0.8.0+5] - 2024-03-07
 
-- Upgraded to official surrealdb.wasm 0.8.0 released for surrealdb 1.2.0.
+- Upgraded to the official surrealdb.wasm 0.8.0 released for surrealdb 1.2.0.
 - API breaking changes: 
   - Previous: `db.use(ns: 'test', db: 'test');`
   - Current: `db.use(namespace: 'test', database: 'test');` 

RELEASE.md

@@ -1,4 +1,4 @@
-- Upgraded to official surrealdb.wasm 0.8.0 released for surrealdb 1.2.0.
-- API breaking changes: 
-  - Previous: `db.use(ns: 'test', db: 'test');`
-  - Current: `db.use(namespace: 'test', database: 'test');` 
+- Feat: Upgraded to surrealdb.wasm 0.9.0, the official release of wasm module of the surrealdb 1.3.0.
+- Feat: API breaking changes:
+  - `db.select()` and `db.query()` that return single result, no longer requiring casting to `List` and retrieval by `.first`.
+- Fix: Catched the error `Encountered a non-object value in array` within the library, preventing it from being exposed to the user. Reported the bug at [surrealdb.wasm#56](https://github.com/surrealdb/surrealdb.wasm/issues/56).

integration_test/transaction_test.dart

@@ -111,7 +111,7 @@ void main() {
         txn.query('');
       });
 
-      expect(result, isEmpty);
+      expect(result, isNull);
     });
 
     test('Concurrent Transactions: Multiple transactions execute concurrently',

lib/src/surrealdb_wasm.dart

@@ -264,7 +264,7 @@ class Surreal {
         data is Map || data is Iterable ? jsonEncode(data) : data,
       ),
     );
-    return (dartify(result)! as List).first;
+    return _wrap(result);
   }
 
   /// Updates a specific resource(record)
@@ -309,7 +309,7 @@ class Surreal {
         data is Map || data is Iterable ? jsonEncode(data) : data,
       ),
     );
-    return (dartify(result)! as List).first;
+    return _wrap(result);
   }
 
   /// Merges data into an existing resource(record) or resources(records).
@@ -341,7 +341,7 @@ class Surreal {
         data is Map || data is Iterable ? jsonEncode(data) : data,
       ),
     );
-    return (dartify(result)! as List).first;
+    return _wrap(result);
   }
 
   /// Selects and retrieves all resources(records)
@@ -361,16 +361,17 @@ class Surreal {
   /// final person = await db.select('person:h5wxrf2ewk8xjxosxtyc');
   /// ```
   Future<Object?> select(String resource) async {
-    print('** select resource $resource');
-    final result = await promiseToFuture<Object?>(
-      _surreal.select(
-        resource,
-      ),
+    return _handleError(
+      resource,
+      (resource) async {
+        final result = await promiseToFuture<Object?>(
+          _surreal.select(
+            resource,
+          ),
+        );
+        return _wrap(result);
+      },
     );
-    print('** select result $result');
-    final list = dartify(result)! as List;
-    print('** select list $list');
-    return list.isEmpty ? null : (list.length == 1 ? list.first : list);
   }
 
   /// Executes a SurrealQL query on the database.
@@ -398,8 +399,7 @@ class Surreal {
         jsonEncode(bindings),
       ),
     );
-    final list = dartify(result)! as List;
-    return list.isNotEmpty ? list.first : list;
+    return _wrap(result);
   }
 
   /// Deletes a specific resource(record) or all resources(records).
@@ -418,11 +418,46 @@ class Surreal {
   /// final record = await db.delete('person:h5wxrf2ewk8xjxosxtyc');
   /// ```
   Future<Object?> delete(String resource) async {
-    final result = await promiseToFuture<Object?>(
-      _surreal.delete(
-        resource,
-      ),
+    return _handleError(
+      resource,
+      (resource) async {
+        final result = await promiseToFuture<Object?>(
+          _surreal.delete(
+            resource,
+          ),
+        );
+        return _wrap(result);
+      },
     );
+  }
+
+  Future<Object?> _handleError(
+    String resource,
+    Future<Object?> Function(
+      String resource,
+    ) sqlFunction,
+  ) async {
+    try {
+      return await sqlFunction(resource);
+    } catch (e) {
+      // Catch the error.
+      if (e is String &&
+          e.contains('Encountered a non-object value in array')) {
+        // If it's the specific error we're looking for,
+        // not handled due to the reported issue.
+        print('''
+ERROR: "$e" is not handled.
+Please see https://github.com/surrealdb/surrealdb.wasm/issues/56.''');
+        return null;
+      } else {
+        // If it's any other error, rethrow it.
+        rethrow;
+      }
+    }
+  }
+
+  Object? _wrap(Object? result) {
+    if (result == null || dartify(result) == null) return null;
     final list = dartify(result)! as List;
     return list.isEmpty ? null : (list.length == 1 ? list.first : list);
   }

pubspec.yaml

@@ -1,6 +1,6 @@
 name: surrealdb_wasm
 description: Flutter SurrealDB WebAssembly(WASM) package
-version: 0.8.0
+version: 0.9.0
 repository: https://github.com/limcheekin/surrealdb_wasm
 
 environment: