As described in #103450: - users can create document editing sessions (DES) - when DES is created its creator becomes a "DES owner" - DES owner can invite other users to the session, - uninvited users can't join the session without invitation, - any user can create a separate session on a document, even if it's already edited by someone else (other DESs exist). - only DES owner can terminate/destroy/close the DES. Having above in mind I need a postMessage API messages that will: 1. "Close_Session" message (host -> editor), to allow the DES owner to terminate the session. When such a message is received, Office Online should inform all session members (views) that the session has been closed. In such a case host page would inform the user with a message and close the editor window. This can be done with 2. "Session_Closed" message (editor -> host).
Pranav Kant committed a patch related to this issue. It has been pushed to "master": http://cgit.freedesktop.org/libreoffice/online/commit/?id=b0933b063e8b0e8e0de7eeeb9706fb291af72b5c tdf#103640: Implement OwnerTermination; send application-level close frame
To enable this kind of owner termination you need to specify 'EnableOwnerTermination' as 'true' in CheckFileInfo response. The owner of the document (based on 'OwnerId' field in CheckFileInfo response) will then be able to terminate all sessions when WOPI host sends 'Close_Session' via post message API. No other session will be able to terminate other sessions if its UserId does not match the OwnerId in CheckFileInfo response - LOOL will quietly ignore you if you send 'Close_Session' from such sessions. Note that EnableOwnerTermination needs to be string 'true'. I will address this with Bug 103671
Dumping some more notes: I have noticed that in chrome the WebSocket's onclose is triggered not when server sends the CLOSE frame, but when the TCP connection is closed. This leads to chrome triggering onclose event with statusCode = 1006 and reason = '' which signifies a browser side websocket close. This is not the case in Firefox.