createAuthAdapter

createAuthAdapter declares a custom auth adapter, typed against the AuthAdapter contract. Kizlo calls it to resolve the session behind a request, the third-party identity independent of any WordPress user. Provide the result through an integration's adapters.auth.

Reach for this when you bring your own session layer. For common providers, use a prebuilt adapter instead. Those live in the adapter guides, not here.

Parameters

createAuthAdapter(adapter)

getSession returns the resolved session. Its id is the identity provider's own id, never a WordPress user id; email is the one join key Kizlo uses to map the session to a WordPress user:

Returns

The adapter, unchanged. createAuthAdapter only attaches the AuthAdapter type so you get inference and one documented entry point.

Examples

import { createAuthAdapter } from "kizlo"
import { getSession } from "../session"

export const auth = createAuthAdapter({
  async getSession(request) {
    const session = await getSession(request)
    if (!session) return null

    return {
      id: session.userId,
      email: session.email,
      firstName: session.firstName,
      lastName: session.lastName,
    }
  },
})

Register it:

import { createIntegration, createKizlo } from "kizlo"
import { auth } from "../adapters/auth"

const authentication = createIntegration({ id: "authentication", adapters: { auth } })

export const { client, handler } = createKizlo({
  integrations: [authentication],
})