application credentials anonymous

CHANGELOG.md

@@ -1,6 +1,14 @@
 x.x.x Release notes (yyyy-MM-dd)
 ==============================================================
 
+**This project is in the Beta stage. All API's might change without warning and no guarantees are given about stability. Do not use it in production.**
+
+### Enhancements
+* Support anonymouse application credentials ([#443](https://github.com/realm/realm-dart/pull/443/))
+
+x.x.x Release notes (yyyy-MM-dd)
+==============================================================
+
 **This project is in the Alpha stage. All API's might change without warning and no guarantees are given about stability. Do not use it in production.**
 
 ### Enhancements

flutter/realm_flutter/ios/Classes/RealmPlugin.m

@@ -44,6 +44,7 @@ void dummy(void) {
   realm_list_size(NULL, 0);
   realm_dart_results_add_notification_callback(NULL, NULL, NULL, NULL);
   realm_results_snapshot(NULL);
+  realm_app_credentials_new_anonymous();
 }
 
 @end

flutter/realm_flutter/tests/test_driver/realm_test.dart

@@ -11,6 +11,7 @@ import '../test/realm_test.dart' as realm_tests;
 import '../test/realm_object_test.dart' as realm_object_tests;
 import '../test/list_test.dart' as list_tests;
 import '../test/results_test.dart' as results_tests;
+import '../test/app_credentials_test.dart' as app_credentials;
 
 Future<String> main(List<String> args) async {
   final Completer<String> completer = Completer<String>();
@@ -21,6 +22,7 @@ Future<String> main(List<String> args) async {
   await realm_object_tests.main(args);
   await list_tests.main(args);
   await results_tests.main(args);
+  await app_credentials.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_credentials.dart

@@ -0,0 +1,55 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Copyright 2022 Realm Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+import 'native/realm_core.dart';
+
+/// An enum containing the possible authentication providers. These have to manually be enabled for
+/// your app before they can be used.
+/// [Authentication Providers Docs](https://docs.mongodb.com/realm/authentication/providers/)
+/// {@category Application}
+enum AuthProvider {
+  /// Mechanism for authenticating without credentials.
+  anonymous,
+
+  /// Mechanism for authenticating with an email and a password.
+  emailPassword,
+
+  /// Allow users to log in with JWT-based credentials generated by a service external to Realm.
+  jwt,
+
+  /// Mechanism for logging in with API keys generated by the client SDK.
+  apiKey,
+}
+
+/// A class, representing the credentials used for authenticating a [User]
+class Credentials {
+  late final RealmAppCredentialsHandle _handle;
+
+  final AuthProvider provider;
+
+  /// Returns a Credentials object that can be used to authenticate an anonymous user.
+  /// [Anonymous Authentication Docs]("https://docs.mongodb.com/realm/authentication/anonymous/")
+  Credentials.anonymous()
+      : _handle = realmCore.createAppCredentialsAnonymous(),
+        provider = AuthProvider.anonymous;
+}
+
+/// @nodoc
+extension CredentialsInternal on Credentials {
+  ///@nodoc
+  RealmAppCredentialsHandle get handle => _handle;
+}

lib/src/native/realm_core.dart

@@ -633,6 +633,10 @@ class _RealmCore {
       return out_modified.asTypedList(count).toList();
     });
   }
+
+  RealmAppCredentialsHandle createAppCredentialsAnonymous() {
+    return RealmAppCredentialsHandle._(_realmLib.realm_app_credentials_new_anonymous());
+  }
 }
 
 class LastError {
@@ -725,6 +729,10 @@ class RealmObjectChangesHandle extends Handle<realm_object_changes> {
   RealmObjectChangesHandle._(Pointer<realm_object_changes> pointer) : super(pointer, 256);
 }
 
+class RealmAppCredentialsHandle extends Handle<realm_app_credentials> {
+  RealmAppCredentialsHandle._(Pointer<realm_app_credentials> pointer) : super(pointer, 256); // TODO: What should hint be?
+}
+
 extension _StringEx on String {
   Pointer<Int8> toUtf8Ptr(Allocator allocator) {
     final units = utf8.encode(this);

lib/src/realm_class.dart

@@ -37,6 +37,7 @@ export 'list.dart' show RealmList, RealmListOfObject, RealmListChanges;
 export 'realm_object.dart' show RealmEntity, RealmException, RealmObject, RealmObjectChanges;
 export 'realm_property.dart';
 export 'results.dart' show RealmResults, RealmResultsChanges;
+export 'app_credentials.dart' show Credentials, AuthProvider;
 
 /// A [Realm] instance represents a `Realm` database.
 ///
@@ -70,7 +71,7 @@ class Realm {
       _scheduler.stop();
       rethrow;
     }
-    _config.isInUse = true;    
+    _config.isInUse = true;
   }
 
   /// Deletes all files associated with a `Realm` located at given [path]

src/CMakeLists.txt

@@ -42,7 +42,7 @@ endif()
 option(REALM_BUILD_CORE_FROM_SOURCE "Build Realm Core from source" ON)
 if(REALM_BUILD_CORE_FROM_SOURCE)
     set(REALM_BUILD_LIB_ONLY ON)
-    set(REALM_ENABLE_SYNC OFF)
+    set(REALM_ENABLE_SYNC ON)
 
     if(ANDROID)
         message ("Realm Flutter Android build enabled")

src/realm_dart.cpp

@@ -69,6 +69,7 @@ void dummy(void) {
   realm_list_size(nullptr, 0);
   realm_results_add_notification_callback(nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr);
   realm_results_snapshot(nullptr);
+  realm_app_credentials_new_anonymous();
 #if (ANDROID)
   realm_android_dummy();
 #endif

test/app_credentials_test.dart

@@ -0,0 +1,34 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Copyright 2022 Realm Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+import 'dart:io';
+
+import 'package:test/test.dart' hide test, throws;
+import '../lib/realm.dart';
+import 'test.dart';
+
+Future<void> main([List<String>? args]) async {
+  print("Current PID $pid");
+
+  setupTests(args);
+
+  test('ApplicationCredentials anonymous', () {
+    final credentials = Credentials.anonymous();
+    expect(credentials, isNotNull);
+  });
+}