// SPDX-License-Identifier: LGPL-3.0-or-later
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
*
* Copyright (C) 2013 - 2024, nymea GmbH
* Copyright (C) 2024 - 2025, chargebyte austria GmbH
*
* This file is part of nymea.
*
* nymea is free software: you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation, either version 3
* of the License, or (at your option) any later version.
*
* nymea 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with nymea. If not, see .
*
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
#ifndef INTEGRATIONSHANDLER_H
#define INTEGRATIONSHANDLER_H
#include "jsonrpc/jsonhandler.h"
#include "usermanager/userinfo.h"
#include "integrations/thingmanager.h"
namespace nymeaserver {
class IntegrationsHandler : public JsonHandler
{
Q_OBJECT
public:
explicit IntegrationsHandler(ThingManager *thingManager, QObject *parent = nullptr);
QString name() const override;
QHash cacheHashes() const override;
Q_INVOKABLE JsonReply *GetVendors(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetThingClasses(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *DiscoverThings(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetPlugins(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetPluginConfiguration(const QVariantMap ¶ms) const;
Q_INVOKABLE JsonReply *SetPluginConfiguration(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *AddThing(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *PairThing(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *ConfirmPairing(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *GetThings(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *ReconfigureThing(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *EditThing(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *RemoveThing(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *SetThingSettings(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *SetStateLogging(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *SetEventLogging(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *SetActionLogging(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *SetStateFilter(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *GetEventTypes(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetActionTypes(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetStateTypes(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetStateValue(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetStateValues(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *BrowseThing(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *GetBrowserItem(const QVariantMap ¶ms, const JsonContext &context) const;
Q_INVOKABLE JsonReply *ExecuteAction(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *ExecuteBrowserItem(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *ExecuteBrowserItemAction(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *GetIOConnections(const QVariantMap ¶ms, const JsonContext &context);
Q_INVOKABLE JsonReply *ConnectIO(const QVariantMap ¶ms);
Q_INVOKABLE JsonReply *DisconnectIO(const QVariantMap ¶ms);
static QVariantMap packBrowserItem(const BrowserItem &item);
signals:
void PluginConfigurationChanged(const QVariantMap ¶ms);
// Thing permission relevant notifications
void StateChanged(const QVariantMap ¶ms, const ThingId &thingId);
void ThingRemoved(const QVariantMap ¶ms, const ThingId &thingId);
void ThingAdded(const QVariantMap ¶ms, const ThingId &thingId);
void ThingChanged(const QVariantMap ¶ms, const ThingId &thingId);
void ThingSettingChanged(const QVariantMap ¶ms, const ThingId &thingId);
void EventTriggered(const QVariantMap ¶ms, const ThingId &thingId);
void IOConnectionAdded(const QVariantMap ¶ms);
void IOConnectionRemoved(const QVariantMap ¶ms);
// User specific notifications depending on the thing based permissions
void ThingRemoved(const QVariantMap ¶ms, const nymeaserver::UserInfo &userInfo);
void ThingAdded(const QVariantMap ¶ms, const nymeaserver::UserInfo &userInfo);
private slots:
void pluginConfigChanged(const PluginId &id, const ParamList &config);
void thingStateChanged(Thing *thing, const QUuid &stateTypeId, const QVariant &value, const QVariant &minValue, const QVariant &maxValue, const QVariantList &possibleValues);
void thingRemovedNotification(const ThingId &thingId);
void thingAddedNotification(Thing *thing);
void thingChangedNotification(Thing *thing);
void thingSettingChangedNotification(const ThingId &thingId, const ParamTypeId ¶mTypeId, const QVariant &value);
private:
ThingManager *m_thingManager = nullptr;
QVariantMap statusToReply(Thing::ThingError status) const;
QHash m_cacheHashes;
};
}
#endif // INTEGRATIONSHANDLER_H