/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */ /* * Copyright the Collabora Online contributors. * * SPDX-License-Identifier: MPL-2.0 * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #pragma once #include #include #include #define LOK_USE_UNSTABLE_API #include #include "Common.hpp" #include "Kit.hpp" #include "Session.hpp" #include "Watermark.hpp" class ChildSession; enum class LokEventTargetEnum { Document, Window }; // An abstract interface. class DocumentManagerInterface { public: virtual ~DocumentManagerInterface() {} /// Request loading a document, or a new view, if one exists. virtual bool onLoad(const std::string& sessionId, const std::string& uriAnonym, const std::string& renderOpts) = 0; /// Unload a client session, which unloads the document /// if it is the last and only. virtual void onUnload(const ChildSession& session) = 0; /// Access to the Kit instance. virtual std::shared_ptr getLOKit() = 0; /// Access to the document instance. virtual std::shared_ptr getLOKitDocument() = 0; /// Send msg to all active sessions. virtual bool notifyAll(const std::string& msg) = 0; /// Send updated view info to all active sessions. virtual void notifyViewInfo() = 0; virtual void updateEditorSpeeds(int id, int speed) = 0; virtual int getEditorId() const = 0; /// Get a view ID <-> UserInfo map. virtual std::map getViewInfo() = 0; virtual std::string getObfuscatedFileId() = 0; virtual std::shared_ptr& getTileQueue() = 0; virtual bool sendFrame(const char* buffer, int length, WSOpCode opCode = WSOpCode::Text) = 0; virtual void alertAllUsers(const std::string& cmd, const std::string& kind) = 0; virtual unsigned getMobileAppDocId() const = 0; /// See if we should clear out our memory virtual void trimIfInactive() = 0; virtual bool isDocPasswordProtected() const = 0; virtual bool haveDocPassword() const = 0; virtual std::string getDocPassword() const = 0; virtual DocumentPasswordType getDocPasswordType() const = 0; virtual void updateActivityHeader() const = 0; }; struct RecordedEvent { private: int _type = 0; std::string _payload; public: RecordedEvent() { } RecordedEvent(int type, const std::string& payload) : _type(type), _payload(payload) { } void setType(int type) { _type = type; } int getType() const { return _type; } void setPayload(const std::string& payload) { _payload = payload; } const std::string& getPayload() const { return _payload; } }; /// When the session is inactive, we need to record its state for a replay. class StateRecorder { private: bool _invalidate; std::unordered_map _recordedStates; std::unordered_map> _recordedViewEvents; std::unordered_map _recordedEvents; std::vector _recordedEventsVector; public: StateRecorder() : _invalidate(false) {} // TODO Remember the maximal area we need to invalidate - grow it step by step. void recordInvalidate() { _invalidate = true; } bool isInvalidate() const { return _invalidate; } const std::unordered_map& getRecordedStates() const { return _recordedStates; } const std::unordered_map>& getRecordedViewEvents() const { return _recordedViewEvents; } const std::unordered_map& getRecordedEvents() const { return _recordedEvents; } const std::vector& getRecordedEventsVector() const { return _recordedEventsVector; } void recordEvent(const int type, const std::string& payload) { _recordedEvents[type] = RecordedEvent(type, payload); } void recordViewEvent(const int viewId, const int type, const std::string& payload) { _recordedViewEvents[viewId][type] = {type, payload}; } void recordState(const std::string& name, const std::string& value) { _recordedStates[name] = value; } /// In the case we need to remember all the events that come, not just /// the final state. void recordEventSequence(const int type, const std::string& payload) { _recordedEventsVector.emplace_back(type, payload); } void dumpState(std::ostream&) { // TODO: the rest ... } void clear() { _invalidate = false; _recordedEvents.clear(); _recordedViewEvents.clear(); _recordedStates.clear(); _recordedEventsVector.clear(); } }; /// Represents a session to the WSD process, in a Kit process. Note that this is not a singleton. class ChildSession final : public Session { public: static bool NoCapsForKit; /// Create a new ChildSession /// jailId The JailID of the jail root directory, // used by downloadas to construct jailed path. ChildSession( const std::shared_ptr &protocol, const std::string& id, const std::string& jailId, const std::string& jailRoot, DocumentManagerInterface& docManager); virtual ~ChildSession(); bool getStatus(); int getViewId() const { return _viewId; } void setViewId(const int viewId) { _viewId = viewId; } const std::string& getViewUserId() const { return getUserId(); } const std::string& getViewUserName() const { return getUserName(); } const std::string& getViewUserExtraInfo() const { return getUserExtraInfo(); } const std::string& getViewUserPrivateInfo() const { return getUserPrivateInfo(); } void updateSpeed(); int getSpeed(); void loKitCallback(const int type, const std::string& payload); /// Initializes the watermark support, if enabled and required. /// Returns true if watermark is enabled and initialized. bool initWatermark() { if (hasWatermark()) { _docWatermark = std::make_shared(getLOKitDocument(), getWatermarkText(), getWatermarkOpacity()); } return _docWatermark != nullptr; } const std::shared_ptr& watermark() const { return _docWatermark; }; bool sendTextFrame(const char* buffer, int length) override { if (!_docManager) { LOG_TRC("ERR dropping - client-" + getId() + ' ' + std::string(buffer, length)); return false; } const auto msg = "client-" + getId() + ' ' + std::string(buffer, length); return _docManager->sendFrame(msg.data(), msg.size(), WSOpCode::Text); } bool sendBinaryFrame(const char* buffer, int length) override { if (!_docManager) { LOG_TRC("ERR dropping binary - client-" + getId()); return false; } const auto msg = "client-" + getId() + ' ' + std::string(buffer, length); return _docManager->sendFrame(msg.data(), msg.size(), WSOpCode::Binary); } using Session::sendTextFrame; bool getClipboard(const StringVector& tokens); void resetDocManager() { disconnect(); _docManager = nullptr; } // Only called by kit. void setCanonicalViewId(int viewId) { _canonicalViewId = viewId; } int getCanonicalViewId() { return _canonicalViewId; } void setViewRenderState(const std::string& state) { _viewRenderState = state; } bool getDumpTiles() { return _isDumpingTiles; } void setDumpTiles(bool dumpTiles) { _isDumpingTiles = dumpTiles; } std::string getViewRenderState() { return _viewRenderState; } bool isTileInsideVisibleArea(const TileDesc& tile) const; private: bool loadDocument(const StringVector& tokens); bool sendFontRendering(const StringVector& tokens); bool getCommandValues(const StringVector& tokens); bool clientZoom(const StringVector& tokens); bool clientVisibleArea(const StringVector& tokens); bool outlineState(const StringVector& tokens); bool downloadAs(const StringVector& tokens); bool getChildId(); bool getTextSelection(const StringVector& tokens); bool setClipboard(const char* buffer, int length, const StringVector& tokens); std::string getTextSelectionInternal(const std::string& mimeType); bool paste(const char* buffer, int length, const StringVector& tokens); bool insertFile(const StringVector& tokens); bool keyEvent(const StringVector& tokens, const LokEventTargetEnum target); bool extTextInputEvent(const StringVector& tokens); bool dialogKeyEvent(const char* buffer, int length, const std::vector& tokens); bool mouseEvent(const StringVector& tokens, const LokEventTargetEnum target); bool readOnlyClickEvent(const StringVector& tokens); bool gestureEvent(const StringVector& tokens); bool dialogEvent(const StringVector& tokens); bool completeFunction(const StringVector& tokens); bool unoCommand(const StringVector& tokens); bool selectText(const StringVector& tokens, const LokEventTargetEnum target); bool selectGraphic(const StringVector& tokens); bool renderWindow(const StringVector& tokens); bool resizeWindow(const StringVector& tokens); bool resetSelection(const StringVector& tokens); bool saveAs(const StringVector& tokens); bool exportAs(const StringVector& tokens); bool setClientPart(const StringVector& tokens); bool selectClientPart(const StringVector& tokens); bool moveSelectedClientParts(const StringVector& tokens); bool setPage(const StringVector& tokens); bool sendWindowCommand(const StringVector& tokens); bool askSignatureStatus(const char* buffer, int length, const StringVector& tokens); bool renderShapeSelection(const StringVector& tokens); bool removeTextContext(const StringVector& tokens); #if ENABLE_FEATURE_LOCK || ENABLE_FEATURE_RESTRICTION bool updateBlockingCommandStatus(const StringVector& tokens); std::string getBlockedCommandType(std::string command); #endif bool handleZoteroMessage(const StringVector& tokens); bool formFieldEvent(const char* buffer, int length, const StringVector& tokens); bool contentControlEvent(const StringVector& tokens); bool renderSearchResult(const char* buffer, int length, const StringVector& tokens); bool setAccessibilityState(bool enable); bool getA11yFocusedParagraph(); bool getA11yCaretPosition(); void rememberEventsForInactiveUser(const int type, const std::string& payload); virtual void disconnect() override; virtual bool _handleInput(const char* buffer, int length) override; static void dumpRecordedUnoCommands(); std::shared_ptr getLOKitDocument() const { return _docManager->getLOKitDocument(); } std::shared_ptr getLOKit() const { return _docManager->getLOKit(); } std::string getLOKitLastError() const { char *lastErr = _docManager->getLOKit()->getError(); std::string ret; if (lastErr) { ret = std::string(lastErr, strlen(lastErr)); free (lastErr); } return ret; } public: // simple one line for priming std::string getActivityState() { std::stringstream ss; ss << "view: " << _viewId << ", session " << getId() << (isReadOnly() ? ", ro": ", rw") << ", user: '" << getUserNameAnonym() << "'" << ", load" << (_isDocLoaded ? "ed" : "ing") << ", type: " << _docType << ", lang: " << getLang(); return ss.str(); } void dumpState(std::ostream& oss) override { Session::dumpState(oss); oss << "\n\tviewId: " << _viewId << "\n\tcanonicalViewId: " << _canonicalViewId << "\n\tisDocLoaded: " << _isDocLoaded << "\n\tdocType: " << _docType << "\n\tcopyingToClipboard: " << _copyToClipboard << "\n\tdocType: " << _docType // FIXME: _pixmapCache << "\n\texportAsWopiUrl: " << _exportAsWopiUrl << "\n\tviewRenderedState: " << _viewRenderState << "\n\tisDumpingTiles: " << _isDocLoaded << "\n\tclientVisibleArea: " << _clientVisibleArea.toString() << "\n\thasURP: " << _hasURP << "\n\tURPContext?: " << (_URPContext == nullptr) << '\n'; _stateRecorder.dumpState(oss); } private: const std::string _jailId; const std::string _jailRoot; DocumentManagerInterface* _docManager; std::shared_ptr _docWatermark; std::queue _cursorInvalidatedEvent; const unsigned _eventStorageIntervalMs = 15*1000; /// View ID, returned by createView() or 0 by default. int _viewId; /// Whether document has been opened successfully bool _isDocLoaded; std::string _docType; StateRecorder _stateRecorder; /// If we are copying to clipboard. bool _copyToClipboard; std::vector _pixmapCache; /// How many sessions / clients we have static size_t NumSessions; /// stores wopi url for export as operation std::string _exportAsWopiUrl; /// stores info about the view std::string _viewRenderState; /// the canonical id unique to the set of rendering properties of this session int _canonicalViewId; /// whether we are dumping tiles as they are being drawn bool _isDumpingTiles; Util::Rectangle _clientVisibleArea; void* _URPContext; /// whether there is a URP session created for this ChildSession bool _hasURP; // When state is added - please update dumpState above. }; /* vim:set shiftwidth=4 softtabstop=4 expandtab: */