verifySession

Type: verifySession(content?: string): Promise<APIResult<verifySessionResponse>>

verifySession() verifies the token provided for the user’s session. If it matches the expected redirect destination, the session is considered valid. A secure encrypted token is then returned.

const result = await sauthbase.use().verifySession(token);
 
if (result.success) {
  console.log("Authentication succeeded:", result.data);
} else {
  console.error("Error:", result.message);
}

Parameters

Return Value

• Promise<APIResult<verifySessionResponse>>: An object containing session validity and the resulting secure token.
  • data.token: The encrypted session ID token
  • data.payload: Information about the original session (e.g., username)

Example Usage

const token = "received-session-token";
const response = await sauthbase.use().verifySession(token);
 
if (response.success) {
  const secureToken = response.data.token;
  console.log("Secure Token:", secureToken);
}

Error Response Codes

• ERROR/ARGUMENT_REQUIRED_SESSION: No session token was provided
• ERROR/INTERNAL_VERIFICATION: An unexpected error occurred during verification
• ERROR/INTERNAL_TOKEN_GENERATION: Failed to generate an encrypted token
• ERROR/INTERNAL: Communication with the external authentication API failed
• ERROR/FETCH_FAILED: The session validation result was invalid