feat: Add getInitialSessionAuthContext to compute SessionAuth context

lib/ts/nextjs.ts

@@ -20,7 +20,7 @@ import {
     middleware,
     errorHandler as customErrorHandler,
 } from "./framework/custom";
-import { HTTPMethod } from "./types";
+import { HTTPMethod, SSRSessionContextType } from "./types";
 import Session, { SessionContainer, VerifySessionOptions } from "./recipe/session";
 import SessionRecipe from "./recipe/session/recipe";
 import { getToken } from "./recipe/session/cookieAndHeaders";
@@ -230,6 +230,25 @@ export default class NextJS {
         return result;
     }
 
+    static async getInitialSessionAuthContext(session: SessionContainer | undefined): Promise<SSRSessionContextType> {
+        const initialContext: SSRSessionContextType = {
+            isContextFromSSR: true,
+            loading: false,
+            doesSessionExist: false,
+            accessTokenPayload: {},
+            invalidClaims: [],
+            userId: "",
+        };
+
+        if (session) {
+            initialContext.doesSessionExist = true;
+            initialContext.accessTokenPayload = await session.getAccessTokenPayload();
+            initialContext.userId = await session.getUserId();
+        }
+
+        return initialContext;
+    }
+
     static async withSession<NextRequest extends PartialNextRequest, NextResponse extends Response>(
         req: NextRequest,
         handler: (error: Error | undefined, session: SessionContainer | undefined) => Promise<NextResponse>,
@@ -405,5 +424,6 @@ export default class NextJS {
 export let superTokensNextWrapper = NextJS.superTokensNextWrapper;
 export let getAppDirRequestHandler = NextJS.getAppDirRequestHandler;
 export let getSSRSession = NextJS.getSSRSession;
+export let getInitialSessionAuthContext = NextJS.getInitialSessionAuthContext;
 export let withSession = NextJS.withSession;
 export let withPreParsedRequestResponse = NextJS.withPreParsedRequestResponse;

lib/ts/types.ts

@@ -18,6 +18,7 @@ import NormalisedURLDomain from "./normalisedURLDomain";
 import NormalisedURLPath from "./normalisedURLPath";
 import { TypeFramework } from "./framework/types";
 import { RecipeLevelUser } from "./recipe/accountlinking/types";
+import { ClaimValidationError } from "./recipe/session/types";
 import { BaseRequest } from "./framework";
 
 export type AppInfo = {
@@ -113,3 +114,13 @@ export type User = {
     // the recipeUserId can be converted to string from the RecipeUserId object type.
     toJson: () => any;
 };
+
+export type SSRSessionContextType = {
+    isContextFromSSR: true;
+    loading: false;
+    doesSessionExist: boolean;
+    accessTokenPayload: any;
+    invalidClaims: ClaimValidationError[]; // TODO: Find if it's possible to compute invalidClaims on BE
+    userId?: string;
+    accessDeniedValidatorError?: ClaimValidationError;
+};