@auth/fauna-adapter

Official Fauna adapter for Auth.js / NextAuth.js.

Installation

npm

npm install @auth/fauna-adapter faunadb

yarn

yarn add @auth/fauna-adapter faunadb

pnpm

pnpm add @auth/fauna-adapter faunadb

FaunaAdapter()

FaunaAdapter(f): Adapter

Setup

This is the Fauna Adapter for next-auth. This package can only be used in conjunction with the primary next-auth package. It is not a standalone package.

You can find the Fauna schema and seed information in the docs at authjs.dev/reference/adapters/fauna.

Configure Auth.js

pages/api/auth/[...nextauth].js

import NextAuth from "next-auth"
import { Client as FaunaClient } from "faunadb"
import { FaunaAdapter } from "@auth/fauna-adapter"

const client = new FaunaClient({
  secret: "secret",
  scheme: "http",
  domain: "localhost",
  port: 8443,
})

// For more information on each option (and a full list of options) go to
// https://authjs.dev/reference/configuration/auth-options
export default NextAuth({
  // https://authjs.dev/reference/providers/
  providers: [],
  adapter: FaunaAdapter(client)
  ...
})

Schema

Run the following commands inside of the Shell tab in the Fauna dashboard to setup the appropriate collections and indexes.

CreateCollection({ name: "accounts" })
CreateCollection({ name: "sessions" })
CreateCollection({ name: "users" })
CreateCollection({ name: "verification_tokens" })

CreateIndex({
  name: "account_by_provider_and_provider_account_id",
  source: Collection("accounts"),
  unique: true,
  terms: [
    { field: ["data", "provider"] },
    { field: ["data", "providerAccountId"] }
  ]
})
CreateIndex({
  name: "session_by_session_token",
  source: Collection("sessions"),
  unique: true,
  terms: [{ field: ["data", "sessionToken"] }]
})
CreateIndex({
  name: "user_by_email",
  source: Collection("users"),
  unique: true,
  terms: [{ field: ["data", "email"] }]
})
CreateIndex({
  name: "verification_token_by_identifier_and_token",
  source: Collection("verification_tokens"),
  unique: true,
  terms: [{ field: ["data", "identifier"] }, { field: ["data", "token"] }]
})

This schema is adapted for use in Fauna and based upon our main schema

Parameters

Parameter	Type
f	default

Returns

Adapter

---

query()

query(f, format): <T>(expr) => Promise< null | T >

Fauna throws an error when something is not found in the db, next-auth expects null to be returned

Parameters

Parameter	Type
f	default
format	(...args) => any

Returns

<T>(expr): Promise< null | T >

Type parameters

Parameter
T

Parameters

Parameter	Type
expr	ExprArg

Returns

Promise< null | T >