feat: identity provider functions

Author: Salakar

samples/identity/.firebaserc

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "python-functions-testing"
+  }
+}

samples/identity/.gitignore

@@ -0,0 +1,66 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+firebase-debug.log*
+firebase-debug.*.log*
+
+# Firebase cache
+.firebase/
+
+# Firebase config
+
+# Uncomment this if you'd like others to create their own Firebase project.
+# For a team working on the same Firebase project(s), it is recommended to leave
+# it commented so all members can deploy to the same project(s) in .firebaserc.
+# .firebaserc
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env

samples/identity/__init__.py

@@ -0,0 +1,3 @@
+# Required to avoid a 'duplicate modules' mypy error
+# in monorepos that have multiple main.py files.
+# https://github.com/python/mypy/issues/4008

samples/identity/client/index.html

@@ -0,0 +1,24 @@
+<script type="module">
+  import { initializeApp } from "https://www.gstatic.com/firebasejs/9.19.1/firebase-app.js";
+  import { getAuth, createUserWithEmailAndPassword, signInWithEmailAndPassword } from "https://www.gstatic.com/firebasejs/9.19.1/firebase-auth.js";
+
+  const firebaseConfig = {
+    apiKey: "AIzaSyCZ2C2_0jQIkQItbiJ4IGbL8OLObbK2mY0",
+    authDomain: "python-functions-testing.firebaseapp.com",
+    databaseURL: "https://python-functions-testing-default-rtdb.europe-west1.firebasedatabase.app",
+    projectId: "python-functions-testing",
+    storageBucket: "python-functions-testing.appspot.com",
+    messagingSenderId: "441947996129",
+    appId: "1:441947996129:web:227004b738ba64f04edca0",
+  };
+
+  const app = initializeApp(firebaseConfig);
+  const auth = getAuth(app);
+
+  // createUserWithEmailAndPassword(auth, "[email protected]", "password")
+  signInWithEmailAndPassword(auth, "[email protected]", "password")
+    .then((userCredential) => {
+      console.log("signed in", userCredential);
+    })
+    .catch(console.error);
+</script>

samples/identity/firebase.json

@@ -0,0 +1,11 @@
+{
+  "functions": [
+    {
+      "source": "functions",
+      "codebase": "default",
+      "ignore": [
+        "venv"
+      ]
+    }
+  ]
+}

samples/identity/functions/.gitignore

@@ -0,0 +1,13 @@
+# pyenv
+.python-version
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Environments
+.env
+.venv
+venv/
+venv.bak/
+__pycache__

samples/identity/functions/main.py

@@ -0,0 +1,42 @@
+"""Firebase Cloud Functions for blocking auth functions example."""
+from firebase_functions import identity_fn
+
+
+@identity_fn.before_user_created(
+    id_token=True,
+    access_token=True,
+    refresh_token=True,
+)
+def beforeusercreated(
+    event: identity_fn.AuthBlockingEvent
+) -> identity_fn.BeforeCreateResponse | None:
+    print(event)
+    if not event.data.email:
+        return None
+    if "@cats.com" in event.data.email:
+        return identity_fn.BeforeCreateResponse(display_name="🐈",
+                                                custom_claims={"meow": True})
+    if "@dogs.com" in event.data.email:
+        return identity_fn.BeforeCreateResponse(display_name="🐕",
+                                                custom_claims={"woof": True})
+    return None
+
+
+@identity_fn.before_user_signed_in(
+    id_token=True,
+    access_token=True,
+    refresh_token=True,
+)
+def beforeusersignedin(
+    event: identity_fn.AuthBlockingEvent
+) -> identity_fn.BeforeSignInResponse | None:
+    print(event)
+    if not event.data.email:
+        return None
+    if "@cats.com" in event.data.email:
+        return identity_fn.BeforeSignInResponse(
+            display_name="🐈", session_claims={"temporary_meow": True})
+    if "@dogs.com" in event.data.email:
+        return identity_fn.BeforeSignInResponse(
+            display_name="🐕", session_claims={"temporary_woof": True})
+    return None

samples/identity/functions/requirements.txt

@@ -0,0 +1,8 @@
+# Not published yet,
+# firebase-functions-python >= 0.0.1
+# so we use a relative path during development:
+./../../../
+# Or switch to git ref for deployment testing:
+# git+https://github.com/firebase/firebase-functions-python.git@main#egg=firebase-functions
+
+firebase-admin >= 6.0.1