refactor to improve database operability

jwt/doc.go

@@ -39,7 +39,7 @@
 //	accessToken, accessExp, err := gen.NewAccess(userID, true, false)
 //	refreshToken, refreshExp, err := gen.NewRefresh(userID, false)
 //
-// Validate tokens:
+// Validate tokens (using standard library):
 //
 //	tx, _ := db.Begin()
 //	token, err := gen.ValidateAccess(tx, accessToken)
@@ -48,6 +48,13 @@
 //	}
 //	tx.Commit()
 //
+// Validate tokens (using ORM like GORM):
+//
+//	tx := gormDB.Begin()
+//	token, err := gen.ValidateAccess(tx.Statement.ConnPool, accessToken)
+//	// or with Bun: gen.ValidateAccess(bunDB.BeginTx(ctx, nil), accessToken)
+//	tx.Commit()
+//
 // Revoke tokens:
 //
 //	tx, _ := db.Begin()
@@ -84,21 +91,29 @@
 // The package works with popular ORMs by using raw SQL queries. For GORM and Bun,
 // wrap the underlying *sql.DB with NewDBConnection() when creating the generator:
 //
-//	// GORM example
+//	// GORM example - can use GORM transactions directly
 //	gormDB, _ := gorm.Open(postgres.Open(dsn), &gorm.Config{})
 //	sqlDB, _ := gormDB.DB()
 //	gen, _ := jwt.CreateGenerator(jwt.GeneratorConfig{
 //	    // ... config ...
 //	    DB: sqlDB,
 //	})
+//	// Use GORM transaction
+//	tx := gormDB.Begin()
+//	token, _ := gen.ValidateAccess(tx.Statement.ConnPool, tokenString)
+//	tx.Commit()
 //
-//	// Bun example
+//	// Bun example - can use Bun transactions directly
 //	sqlDB, _ := sql.Open("postgres", dsn)
 //	bunDB := bun.NewDB(sqlDB, pgdialect.New())
 //	gen, _ := jwt.CreateGenerator(jwt.GeneratorConfig{
 //	    // ... config ...
 //	    DB: sqlDB,
 //	})
+//	// Use Bun transaction
+//	tx, _ := bunDB.BeginTx(context.Background(), nil)
+//	token, _ := gen.ValidateAccess(tx, tokenString)
+//	tx.Commit()
 //
 // # Token Freshness
 //