Node.js SDK

The ThunderID Node.js SDK (@thunderid/node) provides authentication and session management for server-side Node.js applications. The SDK implements the OAuth 2.0 Authorization Code flow with PKCE and supports multi-user session management.

Installation

Install the ThunderID Node.js SDK using your preferred package manager:

npm

npm install @thunderid/node

Yarn

yarn add @thunderid/node

pnpm

pnpm add @thunderid/node

Bun

bun add @thunderid/node

Next Steps

To integrate the SDK into your application, start with the Handling Authentication guide, which walks you through client setup, the sign-in flow, and sign-out. Then explore:

• Protecting Routes: Restrict access based on session state
• Accessing Protected APIs: Call downstream APIs with the access token

Features

Clients

The SDK provides authentication clients designed for server-side Node.js applications.

• ThunderIDNodeClient: Abstract base class for building Node.js framework integrations

Configuration

• ThunderIDNodeConfig: Configuration type for the Node.js SDK

Utilities

Helper functions and constants for session and cookie management.

• CookieConfig: Default cookie configuration constants
• CookieOptions: Cookie configuration interface
• generateSessionId(): Generate unique session identifiers
• getSessionCookieOptions(): Build cookie options with defaults applied