QRCode login support & Introduce new authorization factory

[StageGuard]

QRCode Login

• protocol
• api
• test
• document

brief intro of New Authorization

Provide:

public fun newBot(id: Long, authorizer: BotAuthorizer, config: BotConfiguration)

public interface BotAuthorizer {
    public suspend fun authorize(session: AuthSession)
    companion object {
        public suspend fun byPassword(password: String): BotAuthorizer { /* default implementation */ }
        public suspend fun byQRCodeScan(listener: QRCodeLoginListener): BotAuthorizer  { /* default implementation */ }
    }
}

public interface AuthSession {
    public val qq: Long

    public suspend fun loginByPassword(password: String): AuthResult
    public suspend fun loginByPassword(passwordMd5: ByteArray): AuthResult

    public suspend fun loginByQRScan(qrListener: QRCodeLoginListener): AuthResult
//    public suspend fun loginBySms(smsListener: …): AuthResult
}

Users can implement custom authorizer instead of default implementations like:

object : BotAuthorizer {
    override suspend fun authorize(session: AuthSession) {
        runCatching {
            session.authByQRCode()
        }.recover {
            session.authByPassword()
        }.recover { /* .... */ }
    }
}

[StageGuard]

已经可以登录，但是还有其他问题：

• Logger name 依旧显示为 Bot 0。
• wtlogin.trans_emp 协议不稳定，经常无法解析。

[Him188]

提醒一下，
不要 force push

[Karlatemp]

1. 给productor也添加相关测试
2. productor 感觉更像是通用工具类，换个包更好

[Him188]

TODO:

• OnDemandProducer test
• 登录的 test 如果还有需要
• 检查 Latch 实现