[ToB] [Frontend] Authentication, unit progress, complete unit, SDK selection

build.gradle.kts

@@ -164,6 +164,7 @@ tasks.rat {
     "learning/tour-of-beam/frontend/**/*.gen.dart",
     "learning/tour-of-beam/frontend/.metadata",
     "learning/tour-of-beam/frontend/pubspec.lock",
+    "learning/tour-of-beam/frontend/lib/firebase_options.dart",
 
     // Ignore .gitkeep file
     "**/.gitkeep",

learning/tour-of-beam/frontend/README.md

@@ -17,47 +17,62 @@
      under the License.
  -->
 
- # Tour of Beam
- These are the main sources of the Tour of Beam website.
+# Tour of Beam
 
- # About
+These are the main sources of the Tour of Beam website.
+
+# About
 
 ## Getting started
+
 Running, debugging, and testing all require this first step that fetches
 dependencies and generates code:
 
 ```bash
 cd ../../../playground/frontend/playground_components
 flutter pub get
-flutter pub run build_runner build
 cd ../../../learning/tour-of-beam/frontend
 flutter pub get
-flutter pub run build_runner build
 ```
 
+### Code Generation
+
+This project relies on generated code for some functionality:
+deserializers, constants for asset files, Firebase configuration, etc.
+
+All generated files are version-controlled, so after checkout the project is immediately runnable.
+However, after changes you may need to re-run code generation:
+`flutter pub run build_runner build`
+
+Manual for re-configuring Firebase:
+https://firebase.google.com/docs/flutter/setup?platform=web
+
 ### Run
 
 The following command is used to build and serve the frontend app locally:
 
 `$ flutter run -d chrome`
 
+# Deployment
+
+# Tests
+
+Install ChromeDriver to run integration tests in a browser: https://docs.flutter.dev/testing/integration-tests#running-in-a-browser
+Run integration tests:
+flutter drive \
+ --driver=test_driver/integration_test.dart \
+ --target=integration_test/counter_test.dart \
+ -d web-server
 
- # Deployment
+# Packages
 
- # Tests
- Install ChromeDriver to run integration tests in a browser: https://docs.flutter.dev/testing/integration-tests#running-in-a-browser
- Run integration tests:
- flutter drive \
-   --driver=test_driver/integration_test.dart \
-   --target=integration_test/counter_test.dart \
-   -d web-server
+`flutter pub get`
 
- # Packages
- `flutter pub get`
+# Contribution guide
 
- # Contribution guide
- For checks: `./gradlew rat`
+For checks: `./gradlew rat`
+Exclusions for file checks can be added in the Tour of Beam section of this file: `beam/build.gradle.kts`
 
- # Additional resources
+# Additional resources
 
- # Troubleshooting
+# Troubleshooting

learning/tour-of-beam/frontend/lib/auth/method.dart

@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you 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 'package:enum_map/enum_map.dart';
+
+part 'method.g.dart';
+
+@unmodifiableEnumMap
+enum AuthMethod {
+  google,
+  github,
+}

learning/tour-of-beam/frontend/lib/auth/notifier.dart

@@ -0,0 +1,50 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you 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:async';
+
+import 'package:firebase_auth/firebase_auth.dart';
+import 'package:flutter/material.dart';
+import 'method.dart';
+
+class AuthNotifier extends ChangeNotifier {
+  final _authProviders = UnmodifiableAuthMethodMap(
+    google: GoogleAuthProvider(),
+    github: GithubAuthProvider(),
+  );
+
+  AuthNotifier() {
+    FirebaseAuth.instance.authStateChanges().listen((user) {
+      notifyListeners();
+    });
+  }
+
+  bool get isAuthenticated => FirebaseAuth.instance.currentUser != null;
+
+  Future<String?> getToken() async {
+    return await FirebaseAuth.instance.currentUser?.getIdToken();
+  }
+
+  Future<void> logIn(AuthMethod authMethod) async {
+    await FirebaseAuth.instance.signInWithPopup(_authProviders.get(authMethod));
+  }
+
+  Future<void> logOut() async {
+    await FirebaseAuth.instance.signOut();
+  }
+}

learning/tour-of-beam/frontend/lib/cache/cache.dart

@@ -0,0 +1,27 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you 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 'package:flutter/material.dart';
+
+import '../repositories/client/client.dart';
+
+abstract class Cache extends ChangeNotifier {
+  final TobClient client;
+
+  Cache({required this.client});
+}

learning/tour-of-beam/frontend/lib/cache/content_tree.dart

@@ -18,21 +18,17 @@
 
 import 'dart:async';
 
-import 'package:flutter/widgets.dart';
-
 import '../models/content_tree.dart';
-import '../repositories/client/client.dart';
+import 'cache.dart';
 
-class ContentTreeCache extends ChangeNotifier {
-  final TobClient client;
+class ContentTreeCache extends Cache {
+  ContentTreeCache({
+    required super.client,
+  });
 
   final _treesBySdkId = <String, ContentTreeModel>{};
   final _futuresBySdkId = <String, Future<ContentTreeModel>>{};
 
-  ContentTreeCache({
-    required this.client,
-  });
-
   ContentTreeModel? getContentTree(String sdkId) {
     final future = _futuresBySdkId[sdkId];
     if (future == null) {