Add support for flexible subscriptions

CHANGELOG.md

@@ -4,6 +4,8 @@
 
 ### Breaking Changes
 * Made all `Configuration` fields final so they can only be initialized in the constructor. This better conveys the immutability of the configuration class. ([#455](https://github.com/realm/realm-dart/pull/455))
+* Removed `inMemory` field from `Configuration`. Use `Configuration.inMemory` factory instead.
+* Due to the introduction of different types of configurations the `Configuration` constructor has been removed. Use the `Configuration.local` factory instead. ([#496](https://github.com/realm/realm-dart/pull/496))
 
 ### Enhancements
 * Added a property `Configuration.disableFormatUpgrade`. When set to `true`, opening a Realm with an older file format will throw an exception to avoid automatically upgrading it. ([#310](https://github.com/realm/realm-dart/pull/310))
@@ -35,6 +37,7 @@
 * Support user deviceId. ([#570](https://github.com/realm/realm-dart/pull/570))
 * Support user authentication provider type. ([#570](https://github.com/realm/realm-dart/pull/570))
 * Support user profile data. ([#570](https://github.com/realm/realm-dart/pull/570))
+* Support flexible synchronization. ([#496](https://github.com/realm/realm-dart/pull/496))
 
 ### Fixed
 * Fixed an issue that would result in the wrong transaction being rolled back if you start a write transaction inside a write transaction. ([#442](https://github.com/realm/realm-dart/issues/442))

CMakeLists.txt

@@ -27,6 +27,15 @@ set(CMAKE_VISIBILITY_INLINES_HIDDEN 1)
 set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
 
+# Needed for Win32 headers we might pull in
+if(CMAKE_SYSTEM_NAME MATCHES "^Windows")
+    add_compile_definitions(
+        WIN32_LEAN_AND_MEAN # include minimal Windows.h for faster builds
+        UNICODE # prefer Unicode variants of Windows APIs over ANSI variants
+        _UNICODE # prefer Unicode variants of C runtime APIs over ANSI variants
+    )
+endif()
+
 set(_SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING=1)
 
 add_subdirectory(src)

dartdoc_options.yaml

@@ -12,7 +12,10 @@ dartdoc:
     "Application":
       markdown: topic.md
       name: Application
-  categoryOrder: ["Realm", "Configuration", "Annotations", "Application"]
+    "Sync":
+      markdown: topic.md
+      name: Sync
+  categoryOrder: ["Realm", "Configuration", "Annotations", "Application", "Sync"]
   examplePathPrefix: 'example'
   # nodoc: ['generator/flutter/ffigen/scripts/src/test/*.g.dart']
   showUndocumentedCategories: true

ffigen/config.yaml

@@ -7,11 +7,13 @@ headers:
     - 'realm_dart.h'
     - 'realm_dart_scheduler.h'
     - 'realm_android_platform.h'
+    - 'subscription_set.h'
   include-directives: #generate only for these headers
     - 'realm.h'
     - 'realm_dart.h'
     - 'realm_dart_scheduler.h'
     - 'realm_android_platform.h'
+    - 'subscription_set.h'
 compiler-opts:  
   - '-DRLM_NO_ANON_UNIONS'
   - '-DFFI_GEN'

ffigen/subscription_set.h

@@ -0,0 +1 @@
+../src/subscription_set.h

flutter/realm_flutter/tests/macos/Runner/DebugProfile.entitlements

@@ -8,5 +8,7 @@
 	<true/>
 	<key>com.apple.security.network.server</key>
 	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
 </dict>
 </plist>

flutter/realm_flutter/tests/test_driver/realm_test.dart

@@ -14,6 +14,7 @@ import '../test/results_test.dart' as results_tests;
 import '../test/credentials_test.dart' as credentials_tests;
 import '../test/app_test.dart' as app_tests;
 import '../test/user_test.dart' as user_tests;
+import '../test/subscription_test.dart' as subscription_test;
 
 Future<String> main(List<String> args) async {
   final Completer<String> completer = Completer<String>();
@@ -27,6 +28,7 @@ Future<String> main(List<String> args) async {
   await credentials_tests.main(args);
   await app_tests.main(args);
   await user_tests.main(args);
+  await subscription_test.main(args);
 
   tearDown(() {
     if (Invoker.current?.liveTest.state.result == test_api.Result.error || Invoker.current?.liveTest.state.result == test_api.Result.failure) {

lib/src/app.dart

@@ -23,23 +23,9 @@ import 'credentials.dart';
 import 'user.dart';
 import 'configuration.dart';
 
-/// Specify if and how to persists user objects.
-/// {@category Application}
-enum MetadataPersistenceMode {
-  /// Persist [User] objects, but do not encrypt them.
-  plaintext,
-
-  /// Persist [User] objects in an encrypted store.
-  encrypted,
-
-  /// Do not persist [User] objects.
-  disabled,
-}
-
-@immutable
-
 /// A class exposing configuration options for an [App]
 /// {@category Application}
+@immutable
 class AppConfiguration {
   /// The [appId] is the unique id that identifies the Realm application.
   final String appId;
@@ -144,7 +130,7 @@ class App {
   Future<void> removeUser(User user) async {
     return await realmCore.removeUser(this, user);
   }
-  
+
   /// Switches the [currentUser] to the one specified in [user].
   void switchUser(User user) {
     realmCore.switchUser(this, user);
@@ -154,6 +140,19 @@ class App {
   EmailPasswordAuthProvider get emailPasswordAuthProvider => EmailPasswordAuthProviderInternal.create(this);
 }
 
+/// Specify if and how to persists user objects.
+/// {@category Application}
+enum MetadataPersistenceMode {
+  /// Persist [User] objects, but do not encrypt them.
+  plaintext,
+
+  /// Persist [User] objects in an encrypted store.
+  encrypted,
+
+  /// Do not persist [User] objects.
+  disabled,
+}
+
 /// @nodoc
 extension AppInternal on App {
   AppHandle get handle => _handle;