Auth Manager API

Complete API reference for authentication utilities

Auth Manager API Reference

The Auth Manager provides comprehensive authentication and authorization utilities for edge environments.

AuthManager

Main authentication management class.

Constructor

new AuthManager(options)

Parameters:

• options (object): Authentication configuration options

Options:

• jwtSecret (string): JWT secret key
• jwtAlgorithm (string): JWT algorithm
• apiKeys (array): Valid API keys
• sessionTimeout (number): Session timeout
• providers (array): Authentication providers

Methods

authenticate(request)

Authenticate a request.

const user = await auth.authenticate(request);

Parameters:

• request (Request): HTTP request

Returns: Promise resolving to user object or null

generateToken(payload, options)

Generate JWT token.

const token = await auth.generateToken({ userId: '123', role: 'user' });

Parameters:

• payload (object): Token payload
• options (object, optional): Token options

Returns: Promise resolving to JWT token

verifyToken(token)

Verify JWT token.

const payload = await auth.verifyToken(token);

Parameters:

• token (string): JWT token

Returns: Promise resolving to token payload

validateApiKey(key)

Validate API key.

const isValid = await auth.validateApiKey('api-key-123');

Parameters:

• key (string): API key

Returns: Promise resolving to boolean

createSession(user, options)

Create user session.

const session = await auth.createSession(user, { ttl: 3600000 });

Parameters:

• user (object): User object
• options (object, optional): Session options

Returns: Promise resolving to session object

validateSession(sessionId)

Validate user session.

const session = await auth.validateSession('session-123');

Parameters:

• sessionId (string): Session ID

Returns: Promise resolving to session object or null

Type Definitions

AuthOptions

interface AuthOptions {
  jwtSecret?: string;
  jwtAlgorithm?: string;
  apiKeys?: string[];
  sessionTimeout?: number;
  providers?: AuthProvider[];
}

User

interface User {
  id: string;
  email?: string;
  role?: string;
  permissions?: string[];
}

Session

interface Session {
  id: string;
  userId: string;
  expiresAt: number;
  data?: any;
}