SDK reference

Next.js

Everything exported from @kolaylogin/nextjs and @kolaylogin/react, grouped the way you'll actually reach for them.

Middleware

Edge-runtime safe. Verifies __session on every request, forwards decoded claims as headers, and guards routes you declare with createRouteMatcher.

kolayloginMiddleware()

The single entrypoint you register in middleware.ts.

createRouteMatcher()

Compile a list of route patterns (glob / regex) to a matcher function.

Server-side helpers

Use inside server components, server actions, and route handlers.

auth()

Read the session on the server. Trusts middleware-forwarded headers when present.

verifySessionJwt()

Low-level: verify a raw JWT against the instance JWKS.

React Provider

Keeps the session fresh on the client and powers every hook below.

Wrap your app once near the root.

Client-side hooks

Call from any client component under <KolayLoginProvider>.

useAuth()

Flat AuthObject: isSignedIn, userId, orgId, orgRole, getToken().

useUser()

Current user resource with email / username / metadata.

useKolayLogin()

Escape hatch: raw provider client + session state.

useSession()

Raw session ref: { status, jwt, claims } | { status: "signed_out" }.

useSignIn()

Controller hook for a custom sign-in form.

useSignUp()

Controller hook for a custom sign-up form.

useOrganization()

Active organization resource.

usePlans()

SubscriptionPlan catalog from /v1/billing/plans.

useSubscription()

Current user subscription status.

useCheckout()

{ startCheckout(planId, cycle), isLoading } — opens Stripe Checkout.

Auth components

Prebuilt UI — drop into a route.

One-plan Stripe button.

Control components

Conditional render helpers.

Renders when signed in.

Renders when signed out.

Role-gated render.

Client-side redirect.

Client-side redirect.

Render after provider hydrates.

Render while hydrating.

Install

npm install @kolaylogin/nextjs @kolaylogin/react