Add ability to store user active room, with skeleton accounts.

- Adds a user_state table, currently only with active_room.
 - A user must have an account to take advantage of state.
 - Now, all users will get an 'account' even if they don't explicitly register.

To support these automatically created "accounts," the accounts table
now also has an account_status column, indicating if the user is
registered or not (or pending activation--future use).

The User model has been updated with extra properties from the state,
and the user is now carrried in the Context during command execution.
A user is ensured to be created before executing the command.

src/bin/dicebot-cmd.rs

@@ -4,6 +4,7 @@ use tenebrous_dicebot::commands::ResponseExtractor;
 use tenebrous_dicebot::context::{Context, RoomContext};
 use tenebrous_dicebot::db::sqlite::Database;
 use tenebrous_dicebot::error::BotError;
+use tenebrous_dicebot::models::User;
 use url::Url;
 
 #[tokio::main]
@@ -26,6 +27,7 @@ async fn main() -> Result<(), BotError> {
 
     let context = Context {
         db: db,
+        user: User::default(),
         matrix_client: &matrix_sdk::Client::new(homeserver)
             .expect("Could not create matrix client"),
         room: RoomContext {

src/bot/command_execution.rs

@@ -1,6 +1,7 @@
 use crate::commands::{execute_command, ExecutionError, ExecutionResult, ResponseExtractor};
 use crate::context::{Context, RoomContext};
 use crate::db::sqlite::Database;
+use crate::db::Users;
 use crate::error::BotError;
 use crate::matrix;
 use futures::stream::{self, StreamExt};
@@ -77,6 +78,7 @@ async fn create_context<'a>(
         matrix_client: client,
         room: room_ctx,
         username: &sender,
+        user: db.get_or_create_user(&sender).await?,
         message_body: &command,
     })
 }

src/cofd/dice.rs

@@ -483,6 +483,7 @@ mod tests {
             .unwrap();
 
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),
@@ -523,6 +524,7 @@ mod tests {
 
         let homeserver = Url::parse("http://example.com").unwrap();
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),
@@ -560,6 +562,7 @@ mod tests {
 
         let homeserver = Url::parse("http://example.com").unwrap();
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db.clone(),
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),

src/commands/mod.rs

@@ -201,6 +201,7 @@ mod tests {
         let homeserver = Url::parse("http://example.com").unwrap();
 
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: secure_room!(),
@@ -222,6 +223,7 @@ mod tests {
         let homeserver = Url::parse("http://example.com").unwrap();
 
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: secure_room!(),
@@ -243,6 +245,7 @@ mod tests {
         let homeserver = Url::parse("http://example.com").unwrap();
 
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),
@@ -264,6 +267,7 @@ mod tests {
         let homeserver = Url::parse("http://example.com").unwrap();
 
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),
@@ -294,6 +298,7 @@ mod tests {
         let homeserver = Url::parse("http://example.com").unwrap();
 
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),

src/context.rs

@@ -1,5 +1,6 @@
 use crate::db::sqlite::Database;
 use crate::error::BotError;
+use crate::models::User;
 use matrix_sdk::identifiers::{RoomId, UserId};
 use matrix_sdk::room::Joined;
 use matrix_sdk::Client;
@@ -14,6 +15,7 @@ pub struct Context<'a> {
     pub room: RoomContext<'a>,
     pub username: &'a str,
     pub message_body: &'a str,
+    pub user: User,
 }
 
 impl Context<'_> {

src/cthulhu/dice.rs

@@ -504,6 +504,7 @@ mod tests {
 
         let homeserver = Url::parse("http://example.com").unwrap();
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),
@@ -540,6 +541,7 @@ mod tests {
 
         let homeserver = Url::parse("http://example.com").unwrap();
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),
@@ -576,6 +578,7 @@ mod tests {
 
         let homeserver = Url::parse("http://example.com").unwrap();
         let ctx = Context {
+            user: crate::models::User::default(),
             db: db,
             matrix_client: &matrix_sdk::Client::new(homeserver).unwrap(),
             room: dummy_room!(),

src/db/mod.rs

@@ -16,6 +16,8 @@ pub(crate) trait DbState {
 
 #[async_trait]
 pub(crate) trait Users {
+    async fn get_or_create_user(&self, username: &str) -> Result<User, DataError>;
+
     async fn upsert_user(&self, user: &User) -> Result<(), DataError>;
 
     async fn get_user(&self, username: &str) -> Result<Option<User>, DataError>;

src/db/sqlite/migrator/migrations/V8__user_state.rs

@@ -6,15 +6,12 @@ fn primary_uuid() -> Type {
 }
 
 pub fn migration() -> String {
-    let status_enum =
-        r#"CHECK(account_status IN ('not_registered', 'registered', 'awaiting_activation'))"#;
     let mut m = Migration::new();
 
     // Keep track of contextual user state.
     m.create_table("user_state", move |t| {
         t.add_column("user_id", primary_uuid());
         t.add_column("active_room", types::text().nullable(true));
-        t.add_column("account_status", types::custom(status_enum).nullable(false));
     });
 
     m.make::<Sqlite>()

src/db/sqlite/migrator/migrations/V9__nullable_password_and_account_status.rs

@@ -1,19 +1,15 @@
-use barrel::backend::Sqlite;
-use barrel::{types, types::Type, Migration};
-
-fn primary_uuid() -> Type {
-    types::text().unique(true).primary(true).nullable(false)
-}
-
 pub fn migration() -> String {
     // sqlite does really support alter column, and barrel does not
     // implement the required workaround, so we do it ourselves!
     r#"
       CREATE TABLE IF NOT EXISTS "accounts2" (
          "user_id" TEXT PRIMARY KEY NOT NULL UNIQUE,
-         "password" TEXT NULL
+         "password" TEXT NULL,
+         "account_status" TEXT NOT NULL CHECK(
+             account_status IN ('not_registered', 'registered', 'awaiting_activation'
+         ))
       );
-      INSERT INTO accounts2 select * from accounts;
+      INSERT INTO accounts2 select *, 'registered' FROM accounts;
       DROP TABLE accounts;
       ALTER TABLE accounts2 RENAME TO accounts;
     "#

src/db/sqlite/users.rs

@@ -1,63 +1,72 @@
 use super::Database;
 use crate::db::{errors::DataError, Users};
 use crate::error::BotError;
-use crate::models::{AccountStatus, User};
+use crate::models::User;
 use async_trait::async_trait;
-use std::convert::From;
-
-#[derive(Eq, PartialEq, Debug, Default, sqlx::FromRow)]
-struct UserRow {
-    pub username: String,
-    pub password: Option<String>,
-    pub active_room: Option<String>,
-    pub account_status: Option<AccountStatus>,
-}
-
-impl From<UserRow> for User {
-    fn from(row: UserRow) -> Self {
-        User {
-            username: row.username,
-            password: row.password,
-            active_room: row.active_room,
-            account_status: row.account_status.unwrap_or_default(),
-        }
-    }
-}
+use log::info;
 
 #[async_trait]
 impl Users for Database {
     async fn upsert_user(&self, user: &User) -> Result<(), DataError> {
+        let mut tx = self.conn.begin().await?;
+
         sqlx::query(
-            r#"INSERT INTO accounts (user_id, password) VALUES (?, ?)
-               ON CONFLICT(user_id) DO UPDATE SET password = ?"#,
+            r#"INSERT INTO accounts (user_id, password, account_status)
+               VALUES (?, ?, ?)
+               ON CONFLICT(user_id) DO
+               UPDATE SET password = ?, account_status = ?"#,
         )
         .bind(&user.username)
         .bind(&user.password)
+        .bind(&user.account_status)
         .bind(&user.password)
-        .execute(&self.conn)
+        .bind(&user.account_status)
+        .execute(&mut tx)
         .await?;
 
+        sqlx::query(
+            r#"INSERT INTO user_state (user_id, active_room)
+               VALUES (?, ?)
+               ON CONFLICT(user_id) DO
+               UPDATE SET active_room = ?"#,
+        )
+        .bind(&user.username)
+        .bind(&user.active_room)
+        .bind(&user.active_room)
+        .execute(&mut tx)
+        .await?;
+
+        tx.commit().await?;
         Ok(())
     }
 
     async fn delete_user(&self, username: &str) -> Result<(), DataError> {
+        let mut tx = self.conn.begin().await?;
+
         sqlx::query(r#"DELETE FROM accounts WHERE user_id = ?"#)
             .bind(&username)
-            .execute(&self.conn)
+            .execute(&mut tx)
             .await?;
 
+        sqlx::query(r#"DELETE FROM user_state WHERE user_id = ?"#)
+            .bind(&username)
+            .execute(&mut tx)
+            .await?;
+
+        tx.commit().await?;
+
         Ok(())
     }
 
     async fn get_user(&self, username: &str) -> Result<Option<User>, DataError> {
         // Should be query_as! macro, but the left join breaks it with a
         // non existing error message.
-        let user_row: Option<UserRow> = sqlx::query_as(
+        let user_row: Option<User> = sqlx::query_as(
             r#"SELECT
                a.user_id as "username",
                a.password,
                s.active_room,
-               s.account_status
+               COALESCE(a.account_status, 'not_registered') as "account_status"
                FROM accounts a
                LEFT JOIN user_state s on a.user_id = s.user_id
                WHERE a.user_id = ?"#,
@@ -66,7 +75,22 @@ impl Users for Database {
         .fetch_optional(&self.conn)
         .await?;
 
-        Ok(user_row.map(|r| r.into()))
+        Ok(user_row)
+    }
+
+    //TODO should this logic be moved further up into logic.rs maybe?
+    async fn get_or_create_user(&self, username: &str) -> Result<User, DataError> {
+        let maybe_user = self.get_user(username).await?;
+
+        match maybe_user {
+            Some(user) => Ok(user),
+            None => {
+                info!("Creating unregistered account for {}", username);
+                let user = User::unregistered(&username);
+                self.upsert_user(&user).await?;
+                Ok(user)
+            }
+        }
     }
 
     async fn authenticate_user(
@@ -75,10 +99,6 @@ impl Users for Database {
         raw_password: &str,
     ) -> Result<Option<User>, BotError> {
         let user = self.get_user(username).await?;
-        println!(
-            "user pw is {:?}",
-            user.as_ref().map(|u| u.password.as_ref())
-        );
         Ok(user.filter(|u| u.verify_password(raw_password)))
     }
 }
@@ -88,8 +108,8 @@ mod tests {
     use super::*;
     use crate::db::sqlite::Database;
     use crate::db::Users;
+    use crate::models::AccountStatus;
 
-    //TODO test selecting user when state doesn't exist.
     async fn create_db() -> Database {
         let db_path = tempfile::NamedTempFile::new_in(".").unwrap();
         crate::db::sqlite::migrator::migrate(db_path.path().to_str().unwrap())
@@ -102,13 +122,57 @@ mod tests {
     }
 
     #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
-    async fn create_and_get_user_test() {
+    async fn get_or_create_user_no_user_exists() {
+        let db = create_db().await;
+
+        let user = db
+            .get_or_create_user("@test:example.com")
+            .await
+            .expect("User creation didn't work.");
+
+        assert_eq!(user.username, "@test:example.com");
+
+        let user_again = db
+            .get_user("@test:example.com")
+            .await
+            .expect("User retrieval didn't work.")
+            .expect("No user returned from option.");
+
+        assert_eq!(user, user_again);
+    }
+
+    #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
+    async fn get_or_create_user_when_user_exists() {
+        let db = create_db().await;
+
+        let user = User {
+            username: "myuser".to_string(),
+            password: Some("abc".to_string()),
+            account_status: AccountStatus::Registered,
+            active_room: Some("myroom".to_string()),
+        };
+
+        let insert_result = db.upsert_user(&user).await;
+        assert!(insert_result.is_ok());
+
+        let user_again = db
+            .get_or_create_user("myuser")
+            .await
+            .expect("User retrieval didn't work.");
+
+        assert_eq!(user, user_again);
+    }
+
+    #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
+    async fn create_and_get_full_user_test() {
         let db = create_db().await;
 
         let insert_result = db
             .upsert_user(&User {
                 username: "myuser".to_string(),
-                password: "abc".to_string(),
+                password: Some("abc".to_string()),
+                account_status: AccountStatus::Registered,
+                active_room: Some("myroom".to_string()),
             })
             .await;
 
@@ -122,7 +186,94 @@ mod tests {
         assert!(user.is_some());
         let user = user.unwrap();
         assert_eq!(user.username, "myuser");
-        assert_eq!(user.password, "abc");
+        assert_eq!(user.password, Some("abc".to_string()));
+        assert_eq!(user.account_status, AccountStatus::Registered);
+        assert_eq!(user.active_room, Some("myroom".to_string()));
+    }
+
+    #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
+    async fn can_get_user_with_no_state_record() {
+        let db = create_db().await;
+
+        let insert_result = db
+            .upsert_user(&User {
+                username: "myuser".to_string(),
+                password: Some("abc".to_string()),
+                account_status: AccountStatus::Registered,
+                active_room: Some("myroom".to_string()),
+            })
+            .await;
+
+        assert!(insert_result.is_ok());
+
+        sqlx::query("DELETE FROM user_state")
+            .execute(&db.conn)
+            .await
+            .expect("Could not delete from user_state table.");
+
+        let user = db
+            .get_user("myuser")
+            .await
+            .expect("User retrieval query failed");
+
+        assert!(user.is_some());
+        let user = user.unwrap();
+        assert_eq!(user.username, "myuser");
+        assert_eq!(user.password, Some("abc".to_string()));
+
+        //These should be default values because the state record is missing.
+        assert_eq!(user.account_status, AccountStatus::NotRegistered);
+        assert_eq!(user.active_room, None);
+    }
+
+    #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
+    async fn can_insert_without_password() {
+        let db = create_db().await;
+
+        let insert_result = db
+            .upsert_user(&User {
+                username: "myuser".to_string(),
+                password: None,
+                ..Default::default()
+            })
+            .await;
+
+        assert!(insert_result.is_ok());
+
+        let user = db
+            .get_user("myuser")
+            .await
+            .expect("User retrieval query failed");
+
+        assert!(user.is_some());
+        let user = user.unwrap();
+        assert_eq!(user.username, "myuser");
+        assert_eq!(user.password, None);
+    }
+
+    #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
+    async fn can_insert_without_active_room() {
+        let db = create_db().await;
+
+        let insert_result = db
+            .upsert_user(&User {
+                username: "myuser".to_string(),
+                active_room: None,
+                ..Default::default()
+            })
+            .await;
+
+        assert!(insert_result.is_ok());
+
+        let user = db
+            .get_user("myuser")
+            .await
+            .expect("User retrieval query failed");
+
+        assert!(user.is_some());
+        let user = user.unwrap();
+        assert_eq!(user.username, "myuser");
+        assert_eq!(user.active_room, None);
     }
 
     #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
@@ -132,7 +283,8 @@ mod tests {
         let insert_result1 = db
             .upsert_user(&User {
                 username: "myuser".to_string(),
-                password: "abc".to_string(),
+                password: Some("abc".to_string()),
+                ..Default::default()
             })
             .await;
 
@@ -141,7 +293,9 @@ mod tests {
         let insert_result2 = db
             .upsert_user(&User {
                 username: "myuser".to_string(),
-                password: "123".to_string(),
+                password: Some("123".to_string()),
+                active_room: Some("room".to_string()),
+                account_status: AccountStatus::AwaitingActivation,
             })
             .await;
 
@@ -155,7 +309,11 @@ mod tests {
         assert!(user.is_some());
         let user = user.unwrap();
         assert_eq!(user.username, "myuser");
-        assert_eq!(user.password, "123"); //From second upsert
+
+        //From second upsert
+        assert_eq!(user.password, Some("123".to_string()));
+        assert_eq!(user.active_room, Some("room".to_string()));
+        assert_eq!(user.account_status, AccountStatus::AwaitingActivation);
     }
 
     #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
@@ -165,7 +323,8 @@ mod tests {
         let insert_result = db
             .upsert_user(&User {
                 username: "myuser".to_string(),
-                password: "abc".to_string(),
+                password: Some("abc".to_string()),
+                ..Default::default()
             })
             .await;
 
@@ -201,7 +360,8 @@ mod tests {
         let insert_result = db
             .upsert_user(&User {
                 username: "myuser".to_string(),
-                password: crate::logic::hash_password("abc").expect("password hash error!"),
+                password: Some(crate::logic::hash_password("abc").expect("password hash error!")),
+                ..Default::default()
             })
             .await;
 
@@ -224,7 +384,8 @@ mod tests {
         let insert_result = db
             .upsert_user(&User {
                 username: "myuser".to_string(),
-                password: crate::logic::hash_password("abc").expect("password hash error!"),
+                password: Some(crate::logic::hash_password("abc").expect("password hash error!")),
+                ..Default::default()
             })
             .await;
 

src/models.rs

@@ -7,7 +7,7 @@ pub struct RoomInfo {
     pub room_name: String,
 }
 
-#[derive(Eq, PartialEq, Debug, sqlx::Type)]
+#[derive(Eq, PartialEq, Clone, Copy, Debug, sqlx::Type)]
 #[sqlx(rename_all = "snake_case")]
 pub enum AccountStatus {
     /// User is not registered, which means the "account" only exists
@@ -30,7 +30,7 @@ impl Default for AccountStatus {
     }
 }
 
-#[derive(Eq, PartialEq, Debug, Default)]
+#[derive(Eq, PartialEq, Clone, Debug, Default, sqlx::FromRow)]
 pub struct User {
     pub username: String,
     pub password: Option<String>,
@@ -39,6 +39,15 @@ pub struct User {
 }
 
 impl User {
+    /// Create a new unregistered skeleton marker account for a
+    /// username.
+    pub fn unregistered(username: &str) -> User {
+        User {
+            username: username.to_owned(),
+            ..Default::default()
+        }
+    }
+
     pub fn verify_password(&self, raw_password: &str) -> bool {
         self.password
             .as_ref()