v0.2.6

🎯 New Feature: Session Token Access API

Added Session Token Access

• ✅ Added sessionToken getter - Preferred name for accessing the current user's session token
• ✅ Added getSessionToken() method - Method-based access for those who prefer method calls
• ✅ Enhanced API clarity - Clear naming for use in API authentication headers
• ✅ Full backward compatibility - Existing authToken getter continues to work unchanged

Use Cases

• ✅ API authentication - Use session token in Authorization: Bearer <token> headers
• ✅ Proxy authentication - Pass token to Cloudflare Workers or other proxies for user validation
• ✅ Cost tracking - Track API usage per user by validating tokens server-side

API Examples

// Getter-based access (preferred)
final token = db.auth.sessionToken;
if (token != null) {
  headers['Authorization'] = 'Bearer $token';
}

// Method-based access
final token = db.auth.getSessionToken();
if (token != null) {
  headers['Authorization'] = 'Bearer $token';
}

// Backward compatible - existing code still works
final token = db.auth.authToken; // Still available

Technical Details

• ✅ Same underlying token - All three methods (sessionToken, getSessionToken(), authToken) return the same JWT token
• ✅ Null when not authenticated - Returns null when user is not signed in
• ✅ Comprehensive test coverage - Added 7 new tests for session token access

📚 Impact

This release addresses a common user request for accessing the session token for use in API authentication. The new API provides clearer naming while maintaining full backward compatibility with the existing authToken getter.

---