matrix-appservice-kakaotalk/node/src/client.js

1347 lines
36 KiB
JavaScript
Raw Normal View History

2022-02-25 02:22:50 -05:00
// matrix-appservice-kakaotalk - A Matrix-KakaoTalk puppeting bridge.
// Copyright (C) 2022 Tulir Asokan, Andrew Ferrazzutti
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
import { Long } from "bson"
2022-02-25 02:22:50 -05:00
import {
AuthApiClient,
OAuthApiClient,
ServiceApiClient,
TalkClient,
KnownAuthStatusCode,
util,
} from "node-kakao"
2022-04-28 01:36:15 -04:00
import { ReadStreamUtil } from "node-kakao/stream"
/** @typedef {import("node-kakao").OAuthCredential} OAuthCredential */
/** @typedef {import("node-kakao").ChannelType} ChannelType */
2022-04-05 15:44:02 -04:00
/** @typedef {import("node-kakao").ReplyAttachment} ReplyAttachment */
2022-04-06 12:49:23 -04:00
/** @typedef {import("node-kakao").MentionStruct} MentionStruct */
/** @typedef {import("node-kakao").TalkNormalChannel} TalkNormalChannel */
/** @typedef {import("node-kakao").TalkOpenChannel} TalkOpenChannel */
2022-04-05 15:44:02 -04:00
/** @typedef {import("node-kakao/dist/talk").TalkChannelList} TalkChannelList */
// TODO Remove once/if some helper type hints are upstreamed
/** @typedef {import("node-kakao").OpenChannelUserInfo} OpenChannelUserInfo */
2022-04-23 16:48:23 -04:00
import openlink from "node-kakao/openlink"
const { OpenChannelUserPerm } = openlink
2022-03-09 20:26:39 -05:00
import chat from "node-kakao/chat"
const { KnownChatType } = chat
2022-02-25 02:22:50 -05:00
2022-03-18 03:52:55 -04:00
import { emitLines, promisify } from "./util.js"
2022-04-08 19:01:32 -04:00
/**
* @typedef {Object} ChannelProps
* @property {Long} id
* @property {ChannelType} type
*/
2022-02-25 02:22:50 -05:00
2022-03-23 03:09:30 -04:00
ServiceApiClient.prototype.requestFriendList = async function() {
const res = await this._client.requestData(
"POST",
`${this.getFriendsApiPath("update.json")}`,
{
phone_number_type: 1,
}
2022-04-10 02:19:59 -04:00
)
2022-03-23 03:09:30 -04:00
return {
status: res.status,
success: res.status === 0,
result: res,
2022-04-10 02:19:59 -04:00
}
2022-03-23 03:09:30 -04:00
}
class ProtocolError extends Error {}
class PermError extends ProtocolError {
/** @type {Map<OpenChannelUserPerm, string> */
static #PERM_NAMES = new Map([
[OpenChannelUserPerm.OWNER, "the channel owner"],
[OpenChannelUserPerm.MANAGER, "channel admininstrators"],
[OpenChannelUserPerm.BOT, "bots"],
[OpenChannelUserPerm.NONE, "registered KakaoTalk users"],
])
/**
* @param {?OpenChannelUserPerm[]} permNeeded
* @param {?OpenChannelUserPerm} permActual
*/
constructor(permNeeded, permActual, action) {
const who =
!permActual
? "In this channel, no one"
: "Only " + permNeeded
.map(v => PermError.#PERM_NAMES.get(v))
.reduce((prev, curr) => prev += ` and ${curr}`)
super(`${who} can ${action}`)
this.name = this.constructor.name
}
}
2022-02-25 02:22:50 -05:00
class UserClient {
static #initializing = false
2022-02-25 02:22:50 -05:00
#talkClient = new TalkClient()
get talkClient() { return this.#talkClient }
/** @type {ServiceApiClient} */
2022-03-18 03:52:55 -04:00
#serviceClient
2022-02-25 02:22:50 -05:00
get serviceClient() { return this.#serviceClient }
/** @type {OAuthCredential} */
#credential
get userId() { return this.#credential.userId }
2022-02-25 02:22:50 -05:00
/**
* DO NOT CONSTRUCT DIRECTLY. Callers should use {@link UserClient#create} instead.
* @param {string} mxid
* @param {PeerClient} peerClient TODO Make RPC user-specific instead of needing this
2022-02-25 02:22:50 -05:00
*/
constructor(mxid, peerClient) {
if (!UserClient.#initializing) {
throw new Error("Private constructor")
}
UserClient.#initializing = false
2022-02-25 02:22:50 -05:00
this.mxid = mxid
this.peerClient = peerClient
this.#talkClient.on("chat", (data, channel) => {
this.log(`Chat ${data.chat.logId} received in channel ${channel.channelId}`)
2022-04-13 03:15:28 -04:00
this.write("chat", {
//is_sequential: true, // TODO Make sequential per user & channel (if it isn't already)
chatlog: data.chat,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("chat_deleted", (feedChatlog, channel, feed) => {
this.log(`Chat ${feed.logId} deleted in channel ${channel.channelId} by user ${feedChatlog.sender.userId}`)
2022-04-13 03:15:28 -04:00
this.write("chat_deleted", {
chatId: feed.logId,
senderId: feedChatlog.sender.userId,
timestamp: feedChatlog.sendAt,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("message_hidden", (hideLog, channel, feed) => {
2022-04-10 04:30:26 -04:00
this.log(`Message ${feed.logId} hid from channel ${channel.channelId} by user ${hideLog.sender.userId}`)
2022-04-13 03:15:28 -04:00
this.write("chat_deleted", {
chatId: feed.logId,
senderId: hideLog.sender.userId,
timestamp: hideLog.sendAt,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("chat_read", (chat, channel, reader) => {
this.log(`Chat ${chat.logId} read in channel ${channel.channelId} by ${reader.userId}`)
2022-04-13 03:15:28 -04:00
this.write("chat_read", {
chatId: chat.logId,
senderId: reader.userId,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("chat_event", (channel, author, type, count, chat) => {
// TODO Figure out if this is can ever be for anything other than hearts on Shouts
this.log(`Event ${type} (count = ${count}) on chat ${chat.logId} in channel ${channel.channelId} sent by user ${author.userId}`)
})
2022-04-10 02:23:50 -04:00
this.#talkClient.on("profile_changed", (channel, lastInfo, user) => {
this.log(`Profile of ${user.userId} changed (in channel ${channel ? channel.channelId : "None"})`)
2022-04-13 03:15:28 -04:00
this.write("profile_changed", {
2022-04-10 02:23:50 -04:00
info: user,
/* TODO Is this ever a per-channel profile change?
channelId: channel.channelId,
channelType: channel.info.type,
*/
})
})
this.#talkClient.on("perm_changed",
/**
* TODO Upstream these type hints
* @param {TalkOpenChannel} channel
* @param {OpenChannelUserInfo} lastInfo
* @param {OpenChannelUserInfo} user
*/
(channel, lastInfo, user) => {
this.log(`Perms of user ${user.userId} in channel ${channel.channelId} changed from ${lastInfo.perm} to ${user.perm}`)
2022-04-13 03:15:28 -04:00
this.write("perm_changed", {
is_sequential: true,
userId: user.userId,
perm: user.perm,
senderId: getChannelOwner().userId,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("host_handover", (channel, lastLink, link) => {
// TODO Find how or if this relates to permissions
this.log(`Host of channel ${channel.channelId} changed from ${lastLink.linkOwner.nickname} to ${link.linkOwner.nickname}`)
})
this.#talkClient.on("channel_added", channel => {
this.log(`Added channel ${channel.channelId}`)
this.write("channel_added", {
channelInfo: channel.info,
})
})
2022-04-10 04:30:26 -04:00
this.#talkClient.on("channel_join", channel => {
this.log(`Joined channel ${channel.channelId}`)
2022-04-13 03:15:28 -04:00
this.write("channel_join", {
2022-04-10 04:30:26 -04:00
channelInfo: channel.info,
})
})
this.#talkClient.on("channel_left", channel => {
this.log(`Left channel ${channel.channelId}`)
2022-04-13 03:15:28 -04:00
this.write("channel_left", {
2022-04-10 04:30:26 -04:00
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("channel_kicked", (kickedLog, channel, feed) => {
// TODO Confirm whether this can refer to any user that was kicked, or only to the current user
this.log(`Kicked from channel ${channel.channelId}`)
2022-04-13 03:15:28 -04:00
this.write("channel_kicked", {
2022-04-10 04:30:26 -04:00
userId: feed.member.userId,
senderId: kickedLog.sender.userId,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("channel_link_deleted", (feedChatLog, channel, feed) => {
// TODO Figure out what this means
this.log(`Channel link deleted in channel ${channel.channelId}: feed=${JSON.stringify(feed)}, feedChatLog=${JSON.stringify(feedChatLog)}`)
})
this.#talkClient.on("link_created", link => {
// TODO Figure out what this means
this.log(`Link created: ${JSON.stringify(link)}`)
})
this.#talkClient.on("link_deleted", link => {
// TODO Figure out what this means
this.log(`Link deleted: ${JSON.stringify(link)}`)
})
2022-04-10 04:30:26 -04:00
this.#talkClient.on("user_join", (joinLog, channel, user, feed) => {
this.log(`User ${user.userId} joined channel ${channel.channelId}`)
2022-04-13 03:15:28 -04:00
this.write("user_join", {
2022-04-10 04:30:26 -04:00
userId: user.userId,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
this.#talkClient.on("user_left", (leftLog, channel, user, feed) => {
this.log(`User ${user.userId} left channel ${channel.channelId}`)
2022-04-13 03:15:28 -04:00
this.write("user_left", {
2022-04-10 04:30:26 -04:00
userId: user.userId,
channelId: channel.channelId,
channelType: channel.info.type,
})
})
2022-04-13 13:02:55 -04:00
this.#talkClient.on("meta_change", (channel, type, newMeta) => {
// TODO Handle announcements as pinned messages
2022-04-13 13:02:55 -04:00
this.log(`Channel ${channel.channelId} metadata changed`)
})
this.#talkClient.on("push_packet", (method, data) => {
// TODO Find a better way to do this...but data doesn't have much.
if (method == "SYNCLINKUP") {
if (!data?.ol) return
const linkURL = data.ol?.lu
if (!linkURL) return
for (const channel of this.#talkClient.channelList.open.all()) {
if (channel.info.openLink?.linkURL == linkURL) {
this.write("channel_meta_change", {
info: {
name: data.ol?.ln,
description: data.ol?.desc || null,
photoURL: data.ol?.liu || null,
},
channelId: channel.channelId,
channelType: channel.info.type,
})
break
}
}
}
})
this.#talkClient.on("disconnected", (reason) => {
this.log(`Disconnected (reason=${reason})`)
this.disconnect()
2022-04-13 03:15:28 -04:00
this.write("disconnected", {
reason: reason,
})
})
this.#talkClient.on("switch_server", () => {
this.log(`Server switch requested`)
2022-04-13 03:15:28 -04:00
this.write("switch_server", {
is_sequential: true,
})
})
2022-04-10 02:18:53 -04:00
this.#talkClient.on("error", (err) => {
this.log(`Client error: ${err}`)
2022-04-13 03:15:28 -04:00
this.write("error", {
2022-04-10 02:18:53 -04:00
error: err,
})
})
2022-02-25 02:22:50 -05:00
}
/**
* @param {string} mxid The ID of the associated Matrix user
* @param {OAuthCredential} credential The token to log in with, obtained from prior login
* @param {PeerClient} peerClient What handles RPC
*/
static async create(mxid, credential, peerClient) {
this.#initializing = true
const userClient = new UserClient(mxid, peerClient)
await userClient.setCredential(credential)
2022-02-25 02:22:50 -05:00
return userClient
}
log(...text) {
console.log(`[API/${this.mxid}]`, ...text)
}
error(...text) {
console.error(`[API/${this.mxid}]`, ...text)
}
/**
* @param {OAuthCredential} credential
*/
async setCredential(credential) {
this.#serviceClient = await ServiceApiClient.create(credential)
this.#credential = credential
}
/**
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} channelProps
*/
2022-04-08 19:01:32 -04:00
async getChannel(channelProps) {
let channel = this.#talkClient.channelList.get(channelProps.id)
if (channel) {
return channel
} else {
const channelList = getChannelListForType(
this.#talkClient.channelList,
2022-04-08 19:01:32 -04:00
channelProps.type
)
2022-04-23 16:48:23 -04:00
const res = await channelList.addChannel({ channelId: channelProps.id })
if (!res.success) {
2022-04-08 19:01:32 -04:00
throw new Error(`Unable to add ${channelProps.type} channel ${channelProps.id}`)
}
return res.result
}
}
/**
* @param {?OAuthCredential} credential The token to log in with, obtained from prior login
*/
async connect(credential) {
// TODO Don't re-login if possible. But must still return a LoginResult!
this.disconnect()
if (credential && this.#credential != credential) {
await this.setCredential(credential)
}
return await this.#talkClient.login(this.#credential)
}
disconnect() {
if (this.#talkClient.logon) {
this.#talkClient.close()
}
2022-02-25 02:22:50 -05:00
}
isConnected() {
return this.#talkClient?.logon || false
}
2022-02-25 02:22:50 -05:00
/**
* Send a user-specific command with (optional) data to the socket.
*
* @param {string} command - The data to write.
* @param {?object} data - The data to write.
2022-02-25 02:22:50 -05:00
*/
write(command, data) {
return this.peerClient.write({
id: --this.peerClient.notificationID,
command: `${command}:${this.mxid}`,
...data
})
2022-02-25 02:22:50 -05:00
}
}
export default class PeerClient {
/**
* @param {import("./clientmanager.js").default} manager
2022-02-25 02:22:50 -05:00
* @param {import("net").Socket} socket
* @param {number} connID
*/
constructor(manager, socket, connID) {
this.manager = manager
this.socket = socket
this.connID = connID
2022-02-25 02:22:50 -05:00
this.stopped = false
this.notificationID = 0
this.maxCommandID = 0
this.peerID = null
2022-04-20 23:47:02 -04:00
this.deviceName = "KakaoTalk Bridge"
2022-02-25 02:22:50 -05:00
/** @type {Map<string, UserClient>} */
2022-02-25 02:22:50 -05:00
this.userClients = new Map()
}
log(...text) {
if (this.peerID) {
console.log(`[API/${this.peerID}/${this.connID}]`, ...text)
} else {
console.log(`[API/${this.connID}]`, ...text)
}
}
error(...text) {
if (this.peerID) {
console.error(`[API/${this.peerID}/${this.connID}]`, ...text)
} else {
console.error(`[API/${this.connID}]`, ...text)
}
}
start() {
this.log("Received connection", this.connID)
emitLines(this.socket)
this.socket.on("line", line => this.handleLine(line)
.catch(err => this.log("Error handling line:", err)))
this.socket.on("end", this.handleEnd)
setTimeout(() => {
if (!this.peerID && !this.stopped) {
this.log("Didn't receive register request within 3 seconds, terminating")
this.stop("Register request timeout")
}
}, 3000)
}
async stop(error = null) {
if (this.stopped) {
return
}
this.stopped = true
2022-03-18 03:52:55 -04:00
this.#closeUsers()
2022-02-25 02:22:50 -05:00
try {
await this.write({ id: --this.notificationID, command: "quit", error })
2022-02-25 02:22:50 -05:00
await promisify(cb => this.socket.end(cb))
} catch (err) {
this.error("Failed to end connection:", err)
this.socket.destroy(err)
}
}
2022-03-18 03:52:55 -04:00
handleEnd = () => {
2022-02-25 02:22:50 -05:00
this.stopped = true
2022-03-18 03:52:55 -04:00
this.#closeUsers()
2022-02-25 02:22:50 -05:00
if (this.peerID && this.manager.clients.get(this.peerID) === this) {
this.manager.clients.delete(this.peerID)
}
this.log(`Connection closed (peer: ${this.peerID})`)
}
2022-03-18 03:52:55 -04:00
#closeUsers() {
this.log("Closing all API clients for", this.peerID)
for (const userClient of this.userClients.values()) {
userClient.disconnect()
2022-03-18 03:52:55 -04:00
}
this.userClients.clear()
}
2022-02-25 02:22:50 -05:00
/**
* Write JSON data to the socket.
*
* @param {object} data - The data to write.
* @returns {Promise<void>}
*/
write(data) {
return promisify(cb => this.socket.write(JSON.stringify(data, this.#writeReplacer) + "\n", cb))
2022-02-25 02:22:50 -05:00
}
/**
* @param {Object} req
* @param {string} req.passcode
* @param {string} req.uuid
* @param {Object} req.form
*/
registerDevice = async (req) => {
2022-03-18 03:52:55 -04:00
// TODO Look for a deregister API call
2022-02-25 02:22:50 -05:00
const authClient = await this.#createAuthClient(req.uuid)
return await authClient.registerDevice(req.form, req.passcode, true)
}
/**
* Obtain login tokens. If this fails due to not having a device, also request a device passcode.
2022-02-25 02:22:50 -05:00
* @param {Object} req
* @param {string} req.uuid
* @param {Object} req.form
* @param {boolean} req.forced
2022-02-25 02:22:50 -05:00
* @returns The response of the login attempt, including obtained
* credentials for subsequent token-based login. If a required device passcode
* request failed, its status is stored here.
*/
handleLogin = async (req) => {
2022-03-18 03:52:55 -04:00
// TODO Look for a logout API call
2022-02-25 02:22:50 -05:00
const authClient = await this.#createAuthClient(req.uuid)
const loginRes = await authClient.login(req.form, req.forced)
2022-02-25 02:22:50 -05:00
if (loginRes.status === KnownAuthStatusCode.DEVICE_NOT_REGISTERED) {
const passcodeRes = await authClient.requestPasscode(req.form)
if (!passcodeRes.success) {
loginRes.status = passcodeRes.status
}
}
return loginRes
}
2022-03-09 02:25:28 -05:00
/**
* TODO Consider caching per-user
* @param {string} uuid
*/
async #createAuthClient(uuid) {
2022-04-20 23:47:02 -04:00
return await AuthApiClient.create(this.deviceName, uuid)
2022-03-09 02:25:28 -05:00
}
2022-02-25 02:22:50 -05:00
// TODO Wrapper for per-user commands
/**
* Checked lookup of a UserClient for a given mxid.
* @param {string} mxid
* @returns {UserClient}
2022-02-25 02:22:50 -05:00
*/
#getUser(mxid) {
const userClient = this.userClients.get(mxid)
if (userClient === undefined) {
throw new Error(`Could not find user ${mxid}`)
}
return userClient
}
2022-03-18 03:52:55 -04:00
/**
* Unchecked lookup of a UserClient for a given mxid.
* @param {string} mxid
* @returns {UserClient | undefined}
*/
#tryGetUser(mxid) {
return this.userClients.get(mxid)
}
2022-04-05 00:59:22 -04:00
/**
* @param {string} mxid
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} channelProps
* @param {?OpenChannelUserPerm[]} permNeeded If set, throw if the user's permission level matches none of the values in this list.
* @param {?string} action The action requiring permission, to be used in an error message if throwing..
* @throws {PermError} if the user does not have the specified permission level.
*/
async #getUserChannel(mxid, channelProps, permNeeded, action) {
const userClient = this.#getUser(mxid)
const talkChannel = await userClient.getChannel(channelProps)
if (permNeeded) {
const permActual = talkChannel.getUserInfo({ userId: userClient.userId }).perm
if (permNeeded.indexOf(permActual) == -1) {
throw new PermError(permNeeded, permActual, action)
}
}
return talkChannel
2022-04-05 00:59:22 -04:00
}
2022-02-25 02:22:50 -05:00
/**
* @param {Object} req
* @param {string} req.mxid
2022-02-25 02:22:50 -05:00
* @param {OAuthCredential} req.oauth_credential
*/
handleRenew = async (req) => {
const userClient = this.#tryGetUser(req.mxid)
2022-02-25 02:22:50 -05:00
const oAuthClient = await OAuthApiClient.create()
const res = await oAuthClient.renew(req.oauth_credential)
if (res.success && userClient) {
await userClient.setCredential(res.result.credential)
}
return res
2022-02-25 02:22:50 -05:00
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {OAuthCredential} req.oauth_credential
*/
userStart = async (req) => {
let userClient = this.#tryGetUser(req.mxid)
if (!userClient) {
userClient = await UserClient.create(req.mxid, req.oauth_credential, this)
} else {
await userClient.setCredential(req.oauth_credential)
}
const res = await this.#getSettings(userClient.serviceClient)
if (res.success) {
this.userClients.set(req.mxid, userClient)
}
return res
}
2022-02-25 02:22:50 -05:00
/**
* @param {Object} req
* @param {string} req.mxid
*/
userStop = async (req) => {
this.handleDisconnect(req)
this.userClients.delete(req.mxid)
}
2022-02-25 02:22:50 -05:00
/**
* @param {Object} req
* @param {string} req.mxid
* @param {?OAuthCredential} req.oauth_credential
*/
handleConnect = async (req) => {
return await this.#getUser(req.mxid).connect(req.oauth_credential)
2022-03-18 03:52:55 -04:00
}
/**
* @param {Object} req
* @param {string} req.mxid
*/
handleDisconnect = (req) => {
this.#tryGetUser(req.mxid)?.disconnect()
2022-02-25 02:22:50 -05:00
}
/**
* @param {Object} req
* @param {string} req.mxid
*/
isConnected = (req) => {
return this.#tryGetUser(req.mxid)?.isConnected()
}
2022-02-25 02:22:50 -05:00
/**
* @param {Object} req
* @param {string} req.mxid
*/
getSettings = async (req) => {
return await this.#getSettings(this.#getUser(req.mxid).serviceClient)
}
/**
* @param {ServiceApiClient} serviceClient
*/
#getSettings = async (serviceClient) => {
const moreRes = await serviceClient.requestMoreSettings()
if (!moreRes.success) return moreRes
const lessRes = await serviceClient.requestLessSettings()
if (!lessRes.success) return lessRes
return makeCommandResult({
more: moreRes.result,
less: lessRes.result,
})
}
/**
* @param {Object} req
* @param {string} req.mxid
2022-02-25 02:22:50 -05:00
*/
getOwnProfile = async (req) => {
return await this.#getUser(req.mxid).serviceClient.requestMyProfile()
2022-02-25 02:22:50 -05:00
}
/**
* @param {Object} req
* @param {string} req.mxid
2022-02-25 02:22:50 -05:00
* @param {Long} req.user_id
*/
getProfile = async (req) => {
return await this.#getUser(req.mxid).serviceClient.requestProfile(req.user_id)
2022-02-25 02:22:50 -05:00
}
/**
* @param {Object} req
* @param {string} req.mxid
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} req.channel_props
2022-02-25 02:22:50 -05:00
*/
2022-03-09 02:25:28 -05:00
getPortalChannelInfo = async (req) => {
2022-04-05 00:59:22 -04:00
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
2022-02-25 02:22:50 -05:00
const res = await talkChannel.updateAll()
if (!res.success) return res
return makeCommandResult({
2022-02-25 02:22:50 -05:00
name: talkChannel.getDisplayName(),
2022-04-13 13:02:55 -04:00
description: talkChannel.info.openLink?.description,
// TODO Find out why linkCoverURL is blank, despite having updated the channel!
photoURL: talkChannel.info.openLink?.linkCoverURL || null,
participantInfo: {
// TODO Get members from chatON?
participants: Array.from(talkChannel.getAllUserInfo()),
kickedUserIds: await this.#getKickedUserIds(talkChannel),
},
2022-02-25 02:22:50 -05:00
})
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
*/
getPortalChannelParticipantInfo = async (req) => {
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
// TODO Get members from chatON?
const participantRes = await talkChannel.getAllLatestUserInfo()
if (!participantRes.success) return participantRes
return {
participants: participantRes.result,
kickedUserIds: await this.#getKickedUserIds(talkChannel),
}
}
/**
* @param {TalkNormalChannel | TalkOpenChannel} talkChannel
*/
async #getKickedUserIds(talkChannel) {
if (!isChannelTypeOpen(talkChannel.info.type)) {
return []
} else {
const kickListRes = await talkChannel.getKickList()
if (!kickListRes.success) {
return []
} else {
return kickListRes.result.map(kickUser => kickUser.userId)
}
}
}
/**
* @param {Object} req
* @param {string} req.mxid
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} req.channel_props
*/
getParticipants = async (req) => {
2022-04-05 00:59:22 -04:00
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
return await talkChannel.getAllLatestUserInfo()
}
2022-03-09 02:25:28 -05:00
/**
* @param {Object} req
* @param {string} req.mxid
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} req.channel_props
2022-03-23 03:09:30 -04:00
* @param {?Long} req.sync_from
2022-04-13 01:14:10 -04:00
* @param {?number} req.limit
2022-03-09 02:25:28 -05:00
*/
getChats = async (req) => {
2022-04-05 00:59:22 -04:00
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
2022-03-09 02:25:28 -05:00
const res = await talkChannel.getChatListFrom(req.sync_from)
if (!res.success || !res.length) return res
2022-04-13 01:14:10 -04:00
while (true) {
const nextRes = await talkChannel.getChatListFrom(
res.result[res.result.length - 1].logId
)
if (!nextRes.success) return nextRes
if (!nextRes.result.length) break
res.result.push(...nextRes.result)
}
if (0 < req.limit && req.limit < res.result.length) {
res.result.splice(0, res.result.length - req.limit)
}
return res
2022-03-09 02:25:28 -05:00
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {[Long]} req.unread_chat_ids Must be in DECREASING order
*/
getReadReceipts = async (req) => {
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
// TODO Is any pre-syncing needed?
const userCount = talkChannel.userCount
if (userCount == 1) return makeCommandResult([])
/** @type {Map<Long, Long> */
const latestReceiptByUser = new Map()
let fullyRead = false
for (const chatId of req.unread_chat_ids) {
const chatReaders = talkChannel.getReaders({ logId: chatId })
for (const chatReader of chatReaders) {
if (!latestReceiptByUser.has(chatReader.userId)) {
latestReceiptByUser.set(chatReader.userId, chatId)
if (latestReceiptByUser.size == userCount) {
fullyRead = true
break
}
}
}
if (fullyRead) {
break
}
}
/**
* @typedef {Object} Receipt
* @property {Long} userId
* @property {Long} chatId
*/
/** @type {[Receipt]} */
const receipts = []
latestReceiptByUser.forEach((value, key) => receipts.push({ "userId": key, "chatId": value }))
return makeCommandResult(receipts)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {string} req.uuid
*/
canChangeUUID = async (req) => {
return await this.#getUser(req.mxid).serviceClient.canChangeUUID(req.uuid)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {string} req.uuid
*/
changeUUID = async (req) => {
const serviceClient = this.#getUser(req.mxid).serviceClient
const checkRes = await serviceClient.canChangeUUID(req.uuid)
if (!checkRes.success) return checkRes
return await serviceClient.changeUUID(req.uuid)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {boolean} req.searchable
*/
setUUIDSearchable = async (req) => {
const serviceClient = this.#getUser(req.mxid).serviceClient
const moreRes = await serviceClient.requestMoreSettings()
if (!moreRes.success) {
throw new ProtocolError("Error checking status of KakaoTalk ID")
}
if (!moreRes.result.uuid) {
throw new ProtocolError("You do not yet have a KakaoTalk ID")
}
if (req.searchable == moreRes.result.uuidSearchable) {
throw new ProtocolError(`Your KakaoTalk ID is already ${req.searchable ? "searchable" : "hidden"}`)
}
return await serviceClient.updateSettings({
uuid_searchable: req.searchable,
})
}
2022-03-23 03:09:30 -04:00
/**
* @param {Object} req
* @param {string} req.mxid
2022-03-23 03:09:30 -04:00
*/
listFriends = async (req) => {
return await this.#getUser(req.mxid).serviceClient.requestFriendList()
2022-03-23 03:09:30 -04:00
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {Long} req.user_id
* @param {boolean} req.add
*/
editFriend = async (req) => {
return await this.#editFriend(
this.#getUser(req.mxid).serviceClient,
req.user_id,
req.add
)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {string} req.uuid
* @param {boolean} req.add
*/
editFriendByUUID = async (req) => {
const serviceClient = this.#getUser(req.mxid).serviceClient
const res = await serviceClient.findFriendByUUID(req.uuid)
if (!res.success) return res
return await this.#editFriend(
serviceClient,
res.result.member.userId instanceof Long
? res.result.member.userId
: Long.fromNumber(res.result.member.userId),
req.add
)
}
/**
* @param {ServiceApiClient} serviceClient
* @param {Long} id
* @param {boolean} add
*/
async #editFriend(serviceClient, id, add) {
const listRes = await serviceClient.requestFriendList()
if (listRes.success) {
const isFriend = -1 != listRes.result.friends.findIndex(friend => id.equals(friend.userId))
if (isFriend == add) {
throw new ProtocolError(`User is already ${add ? "in" : "absent from"} friends list`)
}
}
return add ? await serviceClient.addFriend(id) : await serviceClient.removeFriend(id)
}
/**
* @param {Object} req
* @param {string} req.mxid The user whose friend is being looked up.
* @param {string} req.friend_id The friend to search for.
* @param {string} propertyName The property to retrieve from the specified friend.
*/
getFriendProperty = async (req, propertyName) => {
const res = await this.#getUser(req.mxid).serviceClient.findFriendById(req.friend_id)
if (!res.success) return res
return makeCommandResult(res.result.friend[propertyName])
}
/**
* @param {Object} req
* @param {string} req.mxid
*/
getMemoIds = (req) => {
/** @type Long[] */
const channelIds = []
const channelList = this.#getUser(req.mxid).talkClient.channelList
// TODO channelList.all() doesn't really return *all* channels...
for (const channel of channelList.all()) {
if (channel.info.type == "MemoChat") {
channelIds.push(channel.channelId)
}
}
return channelIds
}
2022-04-28 01:36:15 -04:00
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {string} req.key
*/
downloadFile = async (req) => {
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
const res = await talkChannel.downloadMedia({ key: req.key }, KnownChatType.FILE)
if (!res.success) return res
const data = await ReadStreamUtil.all(res.result)
return makeCommandResult(Array.from(data))
}
2022-03-09 20:26:39 -05:00
/**
* @param {Object} req
* @param {string} req.mxid
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} req.channel_props
2022-03-09 20:26:39 -05:00
* @param {string} req.text
2022-04-05 15:44:02 -04:00
* @param {?ReplyAttachment} req.reply_to
2022-04-06 12:49:23 -04:00
* @param {?MentionStruct[]} req.mentions
2022-03-09 20:26:39 -05:00
*/
2022-04-05 00:59:22 -04:00
sendChat = async (req) => {
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
const res = await talkChannel.sendChat({
2022-03-09 20:26:39 -05:00
text: req.text,
2022-04-05 15:44:02 -04:00
type: !!req.reply_to ? KnownChatType.REPLY : KnownChatType.TEXT,
2022-04-06 12:49:23 -04:00
attachment: !req.mentions ? req.reply_to : {...req.reply_to, mentions: req.mentions},
2022-03-09 20:26:39 -05:00
})
if (res.success) res.result = res.result.logId
return res
2022-03-09 20:26:39 -05:00
}
2022-03-26 03:37:53 -04:00
/**
* @param {Object} req
* @param {string} req.mxid
2022-04-08 19:01:32 -04:00
* @param {ChannelProps} req.channel_props
2022-03-26 03:37:53 -04:00
* @param {int} req.type
2022-04-06 12:49:23 -04:00
* @param {number[]} req.data
2022-03-26 03:37:53 -04:00
* @param {string} req.name
* @param {?int} req.width
* @param {?int} req.height
* @param {?string} req.ext
*/
sendMedia = async (req) => {
2022-04-05 00:59:22 -04:00
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
const res = await talkChannel.sendMedia(req.type, {
2022-03-26 03:37:53 -04:00
data: Uint8Array.from(req.data),
name: req.name,
width: req.width,
height: req.height,
ext: req.ext,
})
if (res.success) res.result = res.result.logId
return res
2022-03-26 03:37:53 -04:00
}
2022-04-09 04:02:51 -04:00
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {Long} req.chat_id
*/
deleteChat = async (req) => {
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
return await talkChannel.deleteChat({
logId: req.chat_id,
})
}
2022-04-10 04:26:09 -04:00
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {Long} req.read_until_chat_id
*/
markRead = async (req) => {
const talkChannel = await this.#getUserChannel(req.mxid, req.channel_props)
return await talkChannel.markRead({
logId: req.read_until_chat_id,
})
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {Long} req.user_id
* @param {OpenChannelUserPerm} req.perm
*/
sendPerm = async (req) => {
const talkChannel = await this.#getUserChannel(
req.mxid,
req.channel_props,
[OpenChannelUserPerm.OWNER],
"change user permissions"
)
const user = { userId: req.user_id }
if (!talkChannel.getUserInfo(user)) {
throw new ProtocolError("Cannot set permission level of a user that is not a channel participant")
}
if (req.user_id == talkChannel.clientUser.userId) {
throw new ProtocolError("Cannot change own permission level")
}
return await talkChannel.setUserPerm(user, req.perm)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {string} req.name
*/
setChannelName = async (req) => {
const talkChannel = await this.#getUserChannel(
req.mxid,
req.channel_props,
[OpenChannelUserPerm.OWNER],
"change channel name"
)
return await talkChannel.setTitleMeta(req.name)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {string} req.description
*/
setChannelDescription = async (req) => {
const talkChannel = await this.#getUserChannel(
req.mxid,
req.channel_props,
[OpenChannelUserPerm.OWNER],
"change channel description"
)
return await talkChannel.setNoticeMeta(req.description)
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
* @param {string} req.photo_url
*/
setChannelPhoto = async (req) => {
const talkChannel = await this.#getUserChannel(
req.mxid,
req.channel_props,
[OpenChannelUserPerm.OWNER],
"change channel photo"
)
return await talkChannel.setProfileMeta({
imageUrl: req.photo_url,
fullImageUrl: req.photo_url,
})
}
/**
* @param {Object} req
* @param {string} req.mxid
* @param {Long} req.user_id
*/
createDirectChat = async (req) => {
const channelList = this.#getUser(req.mxid).talkClient.channelList.normal
const res = await channelList.createChannel({
userList: [{ userId: req.user_id }],
})
if (!res.success) return res
return makeCommandResult(res.result.channelId)
}
2022-04-28 03:22:14 -04:00
/**
* @param {Object} req
* @param {string} req.mxid
* @param {ChannelProps} req.channel_props
*/
leaveChannel = async (req) => {
const userClient = this.#getUser(req.mxid)
const channelList = getChannelListForType(
userClient.talkClient.channelList,
req.channel_props.type
)
2022-04-28 22:28:53 -04:00
return await channelList.leaveChannel({ channelId: req.channel_props.id })
2022-04-28 03:22:14 -04:00
}
2022-02-25 02:22:50 -05:00
handleUnknownCommand = () => {
throw new Error("Unknown command")
}
/**
* @param {Object} req
* @param {string} req.peer_id
2022-04-20 23:47:02 -04:00
* @param {Object} req.register_config
* @param {string} req.register_config.device_name
2022-02-25 02:22:50 -05:00
*/
handleRegister = async (req) => {
this.peerID = req.peer_id
2022-04-20 23:47:02 -04:00
this.deviceName = req.register_config.device_name || this.deviceName
2022-02-25 02:22:50 -05:00
this.log(`Registered socket ${this.connID} -> ${this.peerID}`)
if (this.manager.clients.has(this.peerID)) {
const oldClient = this.manager.clients.get(this.peerID)
this.log(`Terminating previous socket ${oldClient.connID} for ${this.peerID}`)
await oldClient.stop("Socket replaced by new connection")
}
this.manager.clients.set(this.peerID, this)
return { client_exists: this.authClient !== null }
}
async handleLine(line) {
if (this.stopped) {
this.log("Ignoring line, client is stopped")
return
}
let req
try {
req = JSON.parse(line, this.#readReviver)
2022-02-25 02:22:50 -05:00
} catch (err) {
this.log("Non-JSON request:", line)
return
}
if (!req.command || !req.id) {
this.log("Invalid request:", line)
return
}
if (req.id <= this.maxCommandID) {
this.log("Ignoring old request", req.id)
return
}
this.log("Received request", req.id, "with command", req.command)
2022-02-25 02:22:50 -05:00
this.maxCommandID = req.id
let handler
if (!this.peerID) {
if (req.command !== "register") {
this.log("First request wasn't a register request, terminating")
await this.stop("Invalid first request")
return
} else if (!req.peer_id) {
this.log("Register request didn't contain ID, terminating")
await this.stop("Invalid register request")
return
}
handler = this.handleRegister
} else {
handler = {
2022-03-18 03:52:55 -04:00
// TODO Wrapper for per-user commands
2022-02-25 02:22:50 -05:00
generate_uuid: util.randomAndroidSubDeviceUUID,
register_device: this.registerDevice,
2022-03-18 03:52:55 -04:00
login: this.handleLogin,
renew: this.handleRenew,
start: this.userStart,
stop: this.userStop,
2022-03-18 03:52:55 -04:00
connect: this.handleConnect,
disconnect: this.handleDisconnect,
is_connected: this.isConnected,
get_settings: this.getSettings,
2022-02-25 02:22:50 -05:00
get_own_profile: this.getOwnProfile,
2022-03-18 03:52:55 -04:00
get_profile: this.getProfile,
2022-02-25 02:22:50 -05:00
get_portal_channel_info: this.getPortalChannelInfo,
get_portal_channel_participant_info: this.getPortalChannelParticipantInfo,
get_participants: this.getParticipants,
2022-03-09 02:25:28 -05:00
get_chats: this.getChats,
get_read_receipts: this.getReadReceipts,
can_change_uuid: this.canChangeUUID,
change_uuid: this.changeUUID,
set_uuid_searchable: this.setUUIDSearchable,
2022-03-23 03:09:30 -04:00
list_friends: this.listFriends,
edit_friend: this.editFriend,
edit_friend_by_uuid: this.editFriendByUUID,
get_friend_dm_id: req => this.getFriendProperty(req, "directChatId"),
get_memo_ids: this.getMemoIds,
2022-04-28 01:36:15 -04:00
download_file: this.downloadFile,
2022-04-05 00:59:22 -04:00
send_chat: this.sendChat,
2022-03-26 03:37:53 -04:00
send_media: this.sendMedia,
2022-04-09 04:02:51 -04:00
delete_chat: this.deleteChat,
mark_read: this.markRead,
send_perm: this.sendPerm,
set_channel_name: this.setChannelName,
set_channel_description: this.setChannelDescription,
set_channel_photo: this.setChannelPhoto,
create_direct_chat: this.createDirectChat,
2022-04-28 03:22:14 -04:00
leave_channel: this.leaveChannel,
2022-02-25 02:22:50 -05:00
}[req.command] || this.handleUnknownCommand
}
const resp = { id: req.id }
delete req.id
delete req.command
resp.command = "response"
try {
resp.response = await handler(req)
} catch (err) {
if (err.isAxiosError) {
resp.response = {
success: false,
status: err.response.status,
}
} else {
resp.command = "error"
if (err instanceof ProtocolError) {
resp.error = err.message
} else {
resp.error = err.toString()
this.log(`Error handling request ${resp.id} ${err.stack}`)
}
2022-02-25 02:22:50 -05:00
}
}
// TODO Check if session is broken. If it is, close the PeerClient
await this.write(resp)
2022-02-25 02:22:50 -05:00
}
#writeReplacer = function(key, value) {
if (value instanceof Long) {
return value.toString()
} else {
return value
}
2022-02-25 02:22:50 -05:00
}
#readReviver = function(key, value) {
if (value instanceof Object) {
// TODO Use a type map if there will be many possible types
if (value.__type__ == "Long") {
return Long.fromString(value.str)
}
}
return value
2022-02-25 02:22:50 -05:00
}
}
/**
* @param {object} result
*/
function makeCommandResult(result) {
return {
success: true,
status: 0,
result: result
}
}
/**
* @param {TalkChannelList} channelList
* @param {ChannelType} channelType
*/
function getChannelListForType(channelList, channelType) {
2022-04-08 19:01:32 -04:00
return isChannelTypeOpen(channelType) ? channelList.open : channelList.normal
}
/**
* @param {ChannelType} channelType
*/
function isChannelTypeOpen(channelType) {
switch (channelType) {
case "OM":
case "OD":
2022-04-08 19:01:32 -04:00
return true
default:
2022-04-08 19:01:32 -04:00
return false
}
}
/**
* @param {TalkOpenChannel} channel
*/
function getChannelOwner(channel) {
for (const userInfo of channel.getAllUserInfo()) {
if (userInfo.perm == OpenChannelUserPerm.OWNER) {
return userInfo
}
}
return null
}