Providers

Elur Auth supports multiple authentication providers. Register them by name and switch between them at runtime.

# Multi-provider auth

Register multiple providers and switch between them:

import { createAuth } from "@elurjs/auth";
import { credentialsProvider } from "@elurjs/auth/providers/credentialsProvider";
import { oidcProvider } from "@elurjs/auth/providers/oidcProvider";

const auth = createAuth({
  providers: {
    credentials: credentialsProvider({
      login: async (creds) => { /* ... */ },
    }),
    github: oidcProvider({
      clientId: import.meta.env.VITE_GITHUB_CLIENT_ID,
      redirectUri: "/auth/callback",
      scopes: ["user:email"],
    }),
  },
  defaultProvider: "credentials",
});

// Login with credentials
await auth.login({ email: "a@b.com", password: "secret" });

// Login with GitHub
await auth.login("github", { /* OAuth params */ });

# Built-in providers

# Session cookie driver

For server-rendered apps (Elur Kit), use sessionCookieDriver to keep tokens in httpOnly cookies:

import { sessionCookieDriver } from "@elurjs/auth/drivers/sessionCookieDriver";

const auth = createAuth({
  driver: sessionCookieDriver({
    login: async (credentials) => {
      const res = await fetch("/api/login", {
        method: "POST",
        headers: { "content-type": "application/json" },
        body: JSON.stringify(credentials),
      });
      return res.json();
    },
    logout: async () => {
      await fetch("/api/logout", { method: "POST" });
    },
  }),
  storage: cookieAdapter({ key: "session" }),
});

# Storage adapters

# Token refresh

Enable automatic token refresh:

const auth = createAuth({
  driver: jwtDriver({
    login: async (creds) => { /* ... */ },
    refresh: async (session) => {
      const res = await fetch("/api/refresh", {
        method: "POST",
        headers: { Authorization: `Bearer ${session.token}` },
      });
      return res.json();
    },
  }),
  autoRefresh: true,
});

# Multi-tab sync

Sessions are synced across browser tabs. When you log in on one tab, all other tabs detect the change via storage events.