feat: added context arg to authenticate method (#97)

Co-authored-by: Tomek Piela <[email protected]>

Author: VeryVicious

src/authentication/login.handler.ts

@@ -1,6 +1,7 @@
 import AdminJS from "adminjs";
 import { Router } from "express";
 import {
+  AuthContext,
   AuthenticationMaxRetriesOptions,
   AuthenticationOptions,
 } from "../types";
@@ -89,7 +90,8 @@ export const withLogin = (
       email: string;
       password: string;
     };
-    const adminUser = await auth.authenticate(email, password);
+    const context: AuthContext = { req, res };
+    const adminUser = await auth.authenticate(email, password, context);
     if (adminUser) {
       req.session.adminUser = adminUser;
       req.session.save((err) => {

src/types.ts

@@ -1,3 +1,4 @@
+import { Request, Response } from "express";
 export type FormidableOptions = {
   encoding?: string;
   uploadDir?: string;
@@ -10,6 +11,17 @@ export type FormidableOptions = {
   multiples?: boolean;
 };
 
+export type AuthenticationContext = {
+  /**
+   * @description Authentication request object
+   */
+  req: Request;
+  /**
+   * @description Authentication response object
+   */
+  res: Response;
+};
+
 export type AuthenticationMaxRetriesOptions = {
   /**
    * @description Count of retries
@@ -24,7 +36,11 @@ export type AuthenticationMaxRetriesOptions = {
 export type AuthenticationOptions = {
   cookiePassword: string;
   cookieName?: string;
-  authenticate: (email: string, password: string) => unknown | null;
+  authenticate: (
+    email: string,
+    password: string,
+    context?: AuthenticationContext
+  ) => unknown | null;
   /**
    * @description Maximum number of authorization attempts (if number - per minute)
    */