Page MenuHomePhabricator

[keyserver] Add a function to toggle the pin status of a message
ClosedPublic

Authored by rohan on Mar 2 2023, 12:49 PM.
Tags
None
Referenced Files
F3357286: D6929.diff
Sat, Nov 23, 11:23 PM
Unknown Object (File)
Thu, Nov 21, 9:58 AM
Unknown Object (File)
Sat, Nov 9, 9:38 AM
Unknown Object (File)
Fri, Nov 8, 5:38 PM
Unknown Object (File)
Fri, Nov 8, 5:38 PM
Unknown Object (File)
Fri, Nov 8, 5:38 PM
Unknown Object (File)
Fri, Nov 8, 5:38 PM
Unknown Object (File)
Fri, Nov 8, 5:38 PM
Subscribers

Details

Summary

Create a function that toggles the pin status of a message provided the request of the type ToggleMessagePinRequest. We check the permissions for the requester to ensure they have the correct permissions to manage message pins.

Linear: https://linear.app/comm/issue/ENG-3184/add-a-function-to-toggle-the-pin-status-of-a-message

To not block review while I figure out how to alert the client of a message pin, I've created a follow-up task to decide what to replace Promise<void> with: https://linear.app/comm/issue/ENG-3392/alert-the-client-of-a-message-pin-unpin

Depends on D6928

(Note: I put this in thread-updaters since I plan to return some kind of robotext and it seems like convention that it's handled here (i.e. removeMembers, joinThread, etc). Feel free to correct me if I've not scoped the conventions correctly though).

Test Plan

The test plan for this function will be combined into the test plan for the subsequent diff, since the endpoints and responders will be set up there.

Diff Detail

Repository
rCOMM Comm
Branch
pinned_messages
Lint
No Lint Coverage
Unit
No Test Coverage

Event Timeline

rohan requested review of this revision.Mar 2 2023, 1:02 PM
keyserver/src/updaters/thread-updaters.js
848 ↗(On Diff #23365)

How do we plan to inform other clients about message being pinned? Shouldn't we send some kind of update?

lib/types/thread-types.js
477 ↗(On Diff #23365)

This might be a little surprising for a user of this api to send a request with true here which means that the message will be not pinned. Maybe we should rename this to simply pin or even newPinState, or something else, but less confusing?

atul requested changes to this revision.Mar 10 2023, 3:42 PM

Are we still waiting on D6924 before the rest of the stack is ready for review? Back to your queue for now, feel free to re-request review as-is if I should be reviewing it.

lib/types/thread-types.js
477 ↗(On Diff #23365)

I agree, I think we could instead replace isPinned with +action: 'pin' | 'unpin'. Thoughts?

This revision now requires changes to proceed.Mar 10 2023, 3:42 PM
keyserver/src/updaters/thread-updaters.js
848 ↗(On Diff #23365)
lib/types/thread-types.js
477 ↗(On Diff #23365)

Good point, I'll change isPinned

Update ToggleMessagePinRequest

keyserver/src/updaters/thread-updaters.js
848 ↗(On Diff #23365)

A robotext message is only one part of this. But we have to make sure that clients get the info that a message is pinned so that they can display it as pinned. Do we plan to introduce a new update type? Or is the plan different?

keyserver/src/updaters/thread-updaters.js
848 ↗(On Diff #23365)

Between our conversation on D6924 and here, I've created a task to handle this to not block review here.

https://linear.app/comm/issue/ENG-3392/alert-the-client-of-a-message-pin-unpin

tomek added inline comments.
keyserver/src/updaters/thread-updaters.js
849–855 ↗(On Diff #23883)

Is it a good idea to trust a client that that a message if from a thread with threadID? For example, a client could send a threadID of a thread where pinning messages is allowed, and messageID from a thread where it isn't. It should be a lot safer to only receive a messageID and fetch threadID from the db.

861 ↗(On Diff #23883)

Is this comment still relevant? We're not checking in the query what is the pin status - we're only setting the status based on what we received in a request. Also, the whole function might be renamed, as we're not toggling.

863–875 ↗(On Diff #23883)

Maybe it will be a little more maintainable if the query was defined in one place and only the values were computed conditionally?

keyserver/src/updaters/thread-updaters.js
849–855 ↗(On Diff #23883)

From a security perspective, if we're worried about a client who has pin / unpin privileges in one thread making a request with a message from another thread, maybe an easier solution would be to update the query to

UPDATE messages
      SET pinned = 1, pin_time = ${Date.now()}
      WHERE id = ${messageID} AND thread = ${threadID}

would be a solution to prevent another query? From my thinking, this validates 1) permissions between thread and viewer, and 2) ensures that the requested message is part of the thread that the viewer has permission to pin in.

If I'm missing something though, I can also fetch the threadID from the messageID.

861 ↗(On Diff #23883)

Yeah I have the same opinion in my comment here - if we change it there I'll change it here

863–875 ↗(On Diff #23883)

Yeah that's fair I'll update to do this instead

This revision is now accepted and ready to land.Mar 24 2023, 10:54 AM
keyserver/src/updaters/thread-updaters.js
849–855 ↗(On Diff #23883)

It also makes sense. But the downside is that we won't inform a client that setting pin failed. Still, adding a condition on thread is beneficial.

keyserver/src/updaters/thread-updaters.js
849–855 ↗(On Diff #23883)

Arguably we could just fetch the message and use the threadID from that

Fetch the threadID via the messageID, remove threadID from ToggleMessagePinRequest and consolidate the two togglePinQuery queries into one concrete query (all addressing feedback)