feat: fire action hook on successful login

Author: julianlam

README.md

@@ -16,4 +16,13 @@ If you'd like to help this plugin play nice with other providers, please
 
 ## Screenshots
 
-![OAuth2 Strategy Editing](./screenshots/configure.png)
+![OAuth2 Strategy Editing](./screenshots/configure.png)
+
+## For Developers
+
+Other plugins can interact with this plugin, as it fires the following hooks:
+
+1. On successful login — `action:oauth2.login` — passes in `(name, user, profile)`
+	* `name` is the strategy name.
+	* `user` is the local NodeBB user (probably just the `uid`).
+	* `profile` is the remote profile as retrieved by this plugin.

library.js

@@ -93,6 +93,8 @@ OAuth.loadStrategies = async (strategies) => {
 		winston.verbose(`[plugin/sso-oauth2-multiple] Successful login to uid ${user.uid} via ${name} (remote id ${id})`);
 		authenticationController.onSuccessfulLogin(req, user.uid);
 		done(null, user);
+
+		plugins.hooks.fire('action:oauth2.login', { name, user, profile });
 	}));
 
 	configs.forEach((strategy, idx) => {