// Matrix Construct // // Copyright (C) Matrix Construct Developers, Authors & Contributors // Copyright (C) 2016-2018 Jason Volk // // Permission to use, copy, modify, and/or distribute this software for any // purpose with or without fee is hereby granted, provided that the above // copyright notice and this permission notice is present in all copies. The // full license for this software is available in the LICENSE file. #pragma once #define HAVE_IRCD_M_DEVICE_H namespace ircd::m { struct device; struct device_keys; struct device_list_update; } struct ircd::m::device_keys :json::tuple < /// Required. The ID of the user the device belongs to. Must match the /// user ID used when logging in. json::property, /// Required. The ID of the device these keys belong to. Must match the /// device ID used when logging in. json::property, /// Required. The encryption algorithms supported by this device. json::property, /// Required. Public identity keys. The names of the properties should /// be in the format :. The keys themselves should /// be encoded as specified by the key algorithm. json::property, /// Required. Signatures for the device key object. A map from user ID, to /// a map from : to the signature. The signature is /// calculated using the process described at Signing JSON. json::property, /// Additional data added to the device key information by intermediate /// servers, and not covered by the signatures. json::property > { using super_type::tuple; using super_type::operator=; }; struct ircd::m::device_list_update :json::tuple < /// Required. The user ID who owns this device. json::property, /// Required. The ID of the device whose details are changing. json::property, /// The public human-readable name of this device. Will be absent if /// the device has no name. json::property, /// Required. An ID sent by the server for this update, unique /// for a given user_id. Used to identify any gaps in the sequence /// of m.device_list_update EDUs broadcast by a server. json::property, /// The stream_ids of any prior m.device_list_update EDUs sent for this /// user which have not been referred to already in an EDU's prev_id /// field. If the receiving server does not recognise any of the prev_ids, /// it means an EDU has been lost and the server should query a snapshot /// of the device list via /user/keys/query in order to correctly interpret /// future m.device_list_update EDUs. May be missing or empty for the /// first EDU in a sequence. json::property, /// True if the server is announcing that this device has been deleted. json::property, /// The updated identity keys (if any) for this device. May be absent /// if the device has no E2E keys defined. json::property > { using super_type::tuple; using super_type::operator=; }; struct ircd::m::device :json::tuple < /// (c2s / s2s) Required. The device ID. json::property, /// (c2s) Display name set by the user for this device. Absent if no /// name has been set. json::property, /// (c2s) The IP address where this device was last seen. (May be a few /// minutes out of date, for efficiency reasons). json::property, /// (c2s) The timestamp (in milliseconds since the unix epoch) when this /// devices was last seen. (May be a few minutes out of date, for /// efficiency reasons). json::property, /// (s2s) Required. Identity keys for the device. json::property, /// (s2s) Optional display name for the device. json::property > { using id = m::id::device; using closure = std::function; using closure_bool = std::function; static bool access_token_to_id(const string_view &token, const closure &); //nothrow static id::buf access_token_to_id(const string_view &token); static bool for_each(const user &, const closure_bool &); // each device_id static bool for_each(const user &, const string_view &id, const closure_bool &); // each property static bool get(std::nothrow_t, const user &, const string_view &id, const string_view &prop, const closure &); static bool get(const user &, const string_view &id, const string_view &prop, const closure &); static bool has(const user &, const string_view &id, const string_view &prop); static bool has(const user &, const string_view &id); static bool del(const user &, const string_view &id); static bool set(const user &, const string_view &id, const string_view &prop, const string_view &val); static bool set(const user &, const device &); using super_type::tuple; using super_type::operator=; };