add more reference pages

documentation-v3/src/reference/main/Adapter.md

@@ -0,0 +1,31 @@
+---
+type: "interface"
+---
+
+Represents a database adapter.
+
+## Definition
+
+```ts
+//$ DatabaseSession=ref:main
+//$ DatabaseUser=ref:main
+interface Adapter {
+	deleteSession(sessionId: string): Promise<void>;
+	deleteUserSessions(userId: string): Promise<void>;
+	getSessionAndUser(
+		sessionId: string
+	): Promise<[session: $$DatabaseSession | null, user: $$DatabaseUser | null]>;
+	getUserSessions(userId: string): Promise<$$DatabaseSession[]>;
+	setSession(session: $$DatabaseSession): Promise<void>;
+	updateSessionExpiration(sessionId: string, expiresAt: Date): Promise<void>;
+}
+```
+
+### Methods
+
+- `deleteSession()`: Deletes the session
+- `deleteUserSessions()`: Deletes all sessions linked to the user
+- `getSessionAndUser()`: Returns the session and the user linked to the session
+- `getUserSessions()`: Returns all sessions linked to a user
+- `setSession()`: Inserts the session
+- `updateSessionExpiration()`: Updates the `expires_at` field of the session

documentation-v3/src/reference/main/DatabaseSession.md

@@ -0,0 +1,24 @@
+---
+type: "interface"
+---
+
+Represents a session stored in a database.
+
+## Definition
+
+```ts
+//$ DatabaseSessionAttributes=ref:main
+interface DatabaseSession {
+	id: string;
+	userId: string;
+	expiresAt: Date;
+	attributes: $$DatabaseSessionAttributes;
+}
+```
+
+### Properties
+
+- `id`
+- `userId`
+- `expiresAt`
+- `attributes`

documentation-v3/src/reference/main/DatabaseSessionAttributes.md

@@ -0,0 +1,11 @@
+---
+type: "interface"
+---
+
+Additional data stored in the session table.
+
+## Definition
+
+```ts
+interface DatabaseSessionAttributes {}
+```

documentation-v3/src/reference/main/DatabaseUser.md

@@ -0,0 +1,22 @@
+---
+type: "interface"
+---
+
+Represents a session stored in a database.
+
+## Definition
+
+```ts
+//$ DatabaseUserAttributes=ref:main
+interface DatabaseUser {
+	id: string;
+	attributes: DatabaseUserAttributes;
+}
+```
+
+### Properties
+
+- `id`
+- `userId`
+- `expiresAt`
+- `attributes`

documentation-v3/src/reference/main/DatabaseUserAttributes.md

@@ -0,0 +1,11 @@
+---
+type: "interface"
+---
+
+Additional data stored in the user table.
+
+## Definition
+
+```ts
+interface DatabaseUserAttributes {}
+```

documentation-v3/src/reference/main/LegacyScrypt/hash.md

@@ -0,0 +1,21 @@
+---
+type: "method"
+---
+
+Hashes the provided password with scrypt.
+
+## Definition
+
+```ts
+function hash(password: string): Promise<string>;
+```
+
+### Parameters
+
+- `password`
+
+## Example
+
+```ts
+const hash = await scrypt.hash(password);
+```

documentation-v3/src/reference/main/LegacyScrypt/index.md

@@ -0,0 +1,36 @@
+---
+type: "class"
+---
+
+A pure JS implementation of Scrypt for projects that used Lucia v1/v2. For new projects, use [`Scrypt`]().
+
+The output hash is a combination of the scrypt hash and the 32-bytes salt, in the format of `<salt>:<hash>`.
+
+## Constructor
+
+```ts
+function constructor(options?: { N?: number; r?: number; p?: number; dkLen?: number }): this;
+```
+
+### Parameters
+
+- `options`
+  - `N` (default: `16384`)
+  - `r` (default: `16`)
+  - `p` (default: `1`)
+  - `dkLen` (default: `64`)
+
+## Methods
+
+- [`hash()`](ref:password/Argon2id)
+- [`verify()`](ref:password/Argon2id)
+
+## Example
+
+```ts
+import { LegacyScrypt } from "lucia";
+
+const scrypt = new LegacyScrypt();
+const hash = await scrypt.hash(password);
+const validPassword = await scrypt.verify(hash, password);
+```

documentation-v3/src/reference/main/LegacyScrypt/verify.md

@@ -0,0 +1,22 @@
+---
+type: "method"
+---
+
+Verifies the password with the hash using scrypt.
+
+## Definition
+
+```ts
+function verify(hash: string, password: string): Promise<boolean>;
+```
+
+### Parameters
+
+- `hash`
+- `password`
+
+## Example
+
+```ts
+const validPassword = await scrypt.verify(hash, password);
+```

documentation-v3/src/reference/main/Lucia/index.md

@@ -24,7 +24,16 @@ function constructor<
 		middleware?: _Middleware;
 		csrfProtection?: boolean | $$CSRFProtectionOptions;
 		sessionExpiresIn?: $$TimeSpan;
-		sessionCookie?: $$SessionCookieOptions;
+		sessionCookie?: {
+			name?: string;
+			expires?: boolean;
+			attributes: {
+				sameSite?: "lax" | "strict";
+				domain?: string;
+				path?: string;
+				secure?: boolean;
+			};
+		};
 		getSessionAttributes?: (
 			databaseSessionAttributes: $$DatabaseSessionAttributes
 		) => _SessionAttributes;
@@ -37,12 +46,19 @@ function constructor<
 
 - `adapter`: Database adapter
 - `options`:
-    - `middleware`: Middleware
-    - `csrfProtection`: If CSRF protection is enabled and its options (default: `true`)
-    - `sessionExpiresIn`: How long a session lasts for maximum for inactive users
-    - `sessionCookie`: Session cookie options
-    - `getSessionAttributes()`: Transforms database session attributes and the returned object is added to the [`Session`](ref:main) object
-    - `getUserAttributes()`: Transforms database user attributes and the returned object is added to the [`User`](ref:main) object
+  - `middleware`: Middleware
+  - `csrfProtection`: If CSRF protection is enabled and its options (default: `true`)
+  - `sessionExpiresIn`: How long a session lasts for maximum for inactive users
+  - `sessionCookie`: Session cookie options
+  	- `name`: Cookie name (default: `auth_session`)
+	- `expires`: Set to `false` for cookies to persist indefinitely (default: `true`)
+	- `attributes`: Cookie attributes
+		- `sameSite`
+		- `domain`
+		- `path`
+		- `secure`
+  - `getSessionAttributes()`: Transforms database session attributes and the returned object is added to the [`Session`](ref:main) object
+  - `getUserAttributes()`: Transforms database user attributes and the returned object is added to the [`User`](ref:main) object
 
 ## Method
 

documentation-v3/src/reference/main/Scrypt/hash.md

@@ -0,0 +1,21 @@
+---
+type: "method"
+---
+
+Hashes the provided password with scrypt.
+
+## Definition
+
+```ts
+function hash(password: string): Promise<string>;
+```
+
+### Parameters
+
+- `password`
+
+## Example
+
+```ts
+const hash = await scrypt.hash(password);
+```

documentation-v3/src/reference/main/Scrypt/index.md

@@ -0,0 +1,38 @@
+---
+type: "class"
+---
+
+A pure JS implementation of Scrypt. Provides methods for hashing passwords and verifying hashes with [scrypt](https://datatracker.ietf.org/doc/html/rfc7914). By default, the configuration is set to [the recommended values](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html). 
+
+The output hash is a combination of the scrypt hash and the 32-bytes salt, in the format of `<salt>:<hash>`.
+
+Since it's pure JS, it is anywhere from 2~3 times slower than implementations based on native code. See Oslo's [`Scrypt`]() for a faster API (Node.js-only).
+
+## Constructor
+
+```ts
+function constructor(options?: { N?: number; r?: number; p?: number; dkLen?: number }): this;
+```
+
+### Parameters
+
+- `options`
+  - `N` (default: `16384`)
+  - `r` (default: `16`)
+  - `p` (default: `1`)
+  - `dkLen` (default: `64`)
+
+## Methods
+
+- [`hash()`](ref:password/Argon2id)
+- [`verify()`](ref:password/Argon2id)
+
+## Example
+
+```ts
+import { Scrypt } from "lucia";
+
+const scrypt = new Scrypt();
+const hash = await scrypt.hash(password);
+const validPassword = await scrypt.verify(hash, password);
+```

documentation-v3/src/reference/main/Scrypt/verify.md

@@ -0,0 +1,22 @@
+---
+type: "method"
+---
+
+Verifies the password with the hash using scrypt.
+
+## Definition
+
+```ts
+function verify(hash: string, password: string): Promise<boolean>;
+```
+
+### Parameters
+
+- `hash`
+- `password`
+
+## Example
+
+```ts
+const validPassword = await scrypt.verify(hash, password);
+```

documentation-v3/src/reference/main/Session.md

@@ -0,0 +1,25 @@
+---
+type: "interface"
+---
+
+Represents a session.
+
+## Definition
+
+```ts
+//$ SessionAttributes=ref:main
+interface Session extends SessionAttributes {
+	id: string;
+	expiresAt: Date;
+	fresh: boolean;
+	userId: string;
+}
+```
+
+
+### Properties
+
+- `id`
+- `expiresAt`
+- `fresh`: `true` if session was newly created or its expiration was extended
+- `userId`

documentation-v3/src/reference/main/SessionCookie.md

@@ -0,0 +1,5 @@
+---
+type: "class"
+---
+
+See [`SessionCookie`](https://oslo.js.org/reference/session/SessionCookie/) from `oslo/session`.

documentation-v3/src/reference/main/TimeSpan.md

@@ -0,0 +1,5 @@
+---
+type: "class"
+---
+
+See [`TimeSpan`](https://oslo.js.org/reference/main/TimeSpan/) from `oslo`.

documentation-v3/src/reference/main/User.md

@@ -0,0 +1,19 @@
+---
+type: "interface"
+---
+
+Represents a user.
+
+## Definition
+
+```ts
+//$ UserAttributes=ref:main
+interface Session extends UserAttributes {
+	id: string;
+}
+```
+
+
+### Properties
+
+- `id`