🔐 token – JWT Authentication Engine

The token package offers a secure and minimal interface to create and validate JSON Web Tokens (JWTs) using a HMAC-SHA256 symmetric key. It now supports embedding user role and team membership directly in the token payload.


🔧 Core Types

JWTMaker

type JWTMaker struct {
	secretKey string
}

A signer/verifier that securely generates and validates JWTs using a 32+ character secret key.


NewJWTMaker

func NewJWTMaker(secretKey string) (*JWTMaker, error)

Initializes a new JWTMaker instance with the given secretKey.


✅ Example

maker, err := token.NewJWTMaker("super-secret-32-byte-key")
if err != nil {
	log.Fatal(err)
}


🎟️ Token Operations

CreateToken

func (maker *JWTMaker) CreateToken(
	userID int64,
	role db.UserRole,
	teamID pgtype.Int8,
	duration time.Duration,
) (string, error)