Configuration

Configuration

This page shows all the options for Authora to configure Lucia.

interface Options {
	sessionExpiresIn?: TimeSpan;
	sessionCookie?: SessionCookieOptions;
	useJWT?: boolean;
	jwtSecret?: string;
	jwtOptions?: JWTOptions;
	getSessionAttributes?: (
	   databaseSessionAttributes: RegisteredDatabaseSessionAttributes
	) => _SessionAttributes;
	getUserAttributes?: (
	   databaseUserAttributes: RegisteredDatabaseUserAttributes
	) => _UserAttributes;
}

sessionExpiresIn

Configures how long a session stays valid for inactive users. Session expirations are automatically extended for active users. Also see TimeSpan.

import { Authora, TimeSpan } from "authora";

const authora = new Authora(adapter, {
	sessionExpiresIn: new TimeSpan(2, "w")
});

sessionCookie

Configures the session cookie.

import { Authora } from "authora";

const authora = new Authora(adapter, {
	sessionCookie: {
		name: "session",
		expires: false, // session cookies have very long lifespan (2 years)
		attributes: {
			secure: true,
			sameSite: "strict",
			domain: "example.com"
		}
	}
});

useJWT

Configures Authora to use jwt.

import { Authora } from "authora";

const authora = new Authora({
   useJWT: true
});

jwtSecret

import { Authora } from "authora";

const authora = new Authora({
   jwtSecret: process.env.JWT_SECRET
});

jwtOptions

import { Authora } from "authora";

const authora = new Authora({
   jwtOptions: {
    signOptions: {
      expiresIn: '1h'
    }
});

getSessionAttributes()

Transforms database session attributes, which is typed as DatabaseSessionAttributes. The returned object is added to the Session object.

import { Authora } from "authora";

const authora = new Authora(adapter, {
	getSessionAttributes: (attributes) => {
		return {
			country: attributes.country
		};
	}
});

declare module "authora" {
	interface Register {
		Authora: typeof authora;
		DatabaseSessionAttributes: DatabaseSessionAttributes;
	}
}

interface DatabaseSessionAttributes {
	country: string;
}

getUserAttributes()

Transforms database user attributes, which is typed as DatabaseUserAttributes. The returned object is added to the User object.

import { Authora } from "authora";

const authora = new Authora(adapter, {
	getUserAttributes: (attributes) => {
		return {
			username: attributes.username
		};
	}
});

declare module "lucia" {
	interface Register {
		Authora: typeof authora;
		DatabaseUserAttributes: DatabaseUserAttributes;
	}
}

interface DatabaseUserAttributes {
	username: string;
}