Unstable support for MSC 3489 live location sharing

[torrybr]

This merge request introduces the live location sharing feature as per MSC3489.

These changes allow users to share their live location, start and stop the sharing, and check if the location sharing is live.

[jplatte]

Hi, and thanks for the PR!

Please note that all of the modules in ruma-events that define event (content) types are named after the event type. That means that the live_location module you added should be split into two modules beacon and beacon_info.

[torrybr]

@jplatte This has been revamped and should be ready for a second look if you have some spare time!

[zecakeh]

Thanks, just a few nits remaining.

[zecakeh]

Could we have tests of full event (BeaconInfoEvent) serialization and deserialization too?

[zecakeh]

Could we have tests of full event (BeaconEvent) serialization and deserialization too?

[torrybr]

something like this? Not a complete example, just making sure this is what you are expecting generally

#[test]
fn message_event_deserialization() {
    let json_data = json!({
        "content": get_beacon_event_content_json(),
        "event_id": "$beacon_event_id:example.com",
        "origin_server_ts": 1_636_829_458,
        "room_id": "!roomid:example.com",
        "type": "org.matrix.msc3672.beacon",
        "sender": "@example:example.com"
    });

    let event = from_json_value::<AnyMessageLikeEvent>(json_data).unwrap();

    assert_matches!(event, AnyMessageLikeEvent::Beacon(MessageLikeEvent::Original(message_event)));
    assert_eq!(
        message_event.content.relates_to.event_id,
        owned_event_id!("$beacon_info_event_id:example.com")
    );
    assert_eq!(message_event.content.location.uri, "geo:51.5008,0.1247;u=35");
    assert_eq!(message_event.content.ts, MilliSecondsSinceUnixEpoch(uint!(1_636_829_458)));
    assert_matches!(message_event.content.relates_to, Reference { event_id, .. });

    assert_eq!(message_event.sender, "@example:example.com");
    assert_eq!(message_event.room_id, "!roomid:example.com");
    assert_eq!(message_event.event_id, owned_event_id!("$beacon_event_id:example.com"));
    assert_eq!(message_event.origin_server_ts, MilliSecondsSinceUnixEpoch(uint!(1_636_829_458)));
    assert!(message_event.unsigned.is_empty());
}