2016-01-06 21:26:29 -07:00
|
|
|
# Copyright 2014-2016 OpenMarket Ltd
|
2017-03-13 11:27:51 -06:00
|
|
|
# Copyright 2017 Vector Creations Ltd
|
2019-11-05 03:56:39 -07:00
|
|
|
# Copyright 2018-2019 New Vector Ltd
|
|
|
|
# Copyright 2019 The Matrix.org Foundation C.I.C.
|
2014-08-12 08:10:52 -06:00
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
# See the License for the specific language governing permissions and
|
|
|
|
# limitations under the License.
|
2014-08-12 20:14:34 -06:00
|
|
|
|
2014-08-12 08:10:52 -06:00
|
|
|
"""Contains constants from the specification."""
|
|
|
|
|
2021-04-23 12:20:44 -06:00
|
|
|
# the max size of a (canonical-json-encoded) event
|
|
|
|
MAX_PDU_SIZE = 65536
|
|
|
|
|
2018-05-01 09:19:39 -06:00
|
|
|
# the "depth" field on events is limited to 2**63 - 1
|
|
|
|
MAX_DEPTH = 2 ** 63 - 1
|
|
|
|
|
2019-05-08 10:01:30 -06:00
|
|
|
# the maximum length for a room alias is 255 characters
|
|
|
|
MAX_ALIAS_LENGTH = 255
|
|
|
|
|
2019-05-20 04:20:08 -06:00
|
|
|
# the maximum length for a user id is 255 characters
|
|
|
|
MAX_USERID_LENGTH = 255
|
|
|
|
|
2021-02-17 06:41:47 -07:00
|
|
|
# The maximum length for a group id is 255 characters
|
|
|
|
MAX_GROUPID_LENGTH = 255
|
|
|
|
MAX_GROUP_CATEGORYID_LENGTH = 255
|
|
|
|
MAX_GROUP_ROLEID_LENGTH = 255
|
|
|
|
|
2014-08-12 08:10:52 -06:00
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class Membership:
|
2014-08-12 08:10:52 -06:00
|
|
|
|
|
|
|
"""Represents the membership states of a user in a room."""
|
2019-06-20 03:32:02 -06:00
|
|
|
|
2014-08-12 08:10:52 -06:00
|
|
|
INVITE = "invite"
|
|
|
|
JOIN = "join"
|
2021-06-15 05:45:14 -06:00
|
|
|
KNOCK = "knock"
|
2014-08-12 08:10:52 -06:00
|
|
|
LEAVE = "leave"
|
2014-09-01 09:15:34 -06:00
|
|
|
BAN = "ban"
|
|
|
|
LIST = (INVITE, JOIN, KNOCK, LEAVE, BAN)
|
2014-08-12 08:10:52 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class PresenceState:
|
2014-08-12 08:10:52 -06:00
|
|
|
"""Represents the presence state of a user."""
|
2019-06-20 03:32:02 -06:00
|
|
|
|
2014-08-13 07:31:48 -06:00
|
|
|
OFFLINE = "offline"
|
|
|
|
UNAVAILABLE = "unavailable"
|
|
|
|
ONLINE = "online"
|
2021-03-18 09:34:47 -06:00
|
|
|
BUSY = "org.matrix.msc3026.busy"
|
2014-08-28 03:59:15 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class JoinRules:
|
2014-08-28 03:59:15 -06:00
|
|
|
PUBLIC = "public"
|
2021-06-15 05:45:14 -06:00
|
|
|
KNOCK = "knock"
|
2014-08-28 03:59:15 -06:00
|
|
|
INVITE = "invite"
|
|
|
|
PRIVATE = "private"
|
2021-03-31 14:39:08 -06:00
|
|
|
# As defined for MSC3083.
|
2021-08-09 02:46:39 -06:00
|
|
|
RESTRICTED = "restricted"
|
2014-09-15 03:23:20 -06:00
|
|
|
|
|
|
|
|
2021-06-17 10:53:27 -06:00
|
|
|
class RestrictedJoinRuleTypes:
|
|
|
|
"""Understood types for the allow rules in restricted join rules."""
|
|
|
|
|
|
|
|
ROOM_MEMBERSHIP = "m.room_membership"
|
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class LoginType:
|
2014-09-15 03:23:20 -06:00
|
|
|
PASSWORD = "m.login.password"
|
|
|
|
EMAIL_IDENTITY = "m.login.email.identity"
|
2017-03-13 11:27:51 -06:00
|
|
|
MSISDN = "m.login.msisdn"
|
2014-10-30 05:10:17 -06:00
|
|
|
RECAPTCHA = "m.login.recaptcha"
|
2018-09-27 14:53:58 -06:00
|
|
|
TERMS = "m.login.terms"
|
2020-06-05 08:50:08 -06:00
|
|
|
SSO = "m.login.sso"
|
2015-04-15 10:14:25 -06:00
|
|
|
DUMMY = "m.login.dummy"
|
2021-08-21 15:14:43 -06:00
|
|
|
REGISTRATION_TOKEN = "org.matrix.msc3231.login.registration_token"
|
2015-04-02 10:01:29 -06:00
|
|
|
|
2014-12-03 09:07:21 -07:00
|
|
|
|
2021-04-12 08:13:55 -06:00
|
|
|
# This is used in the `type` parameter for /register when called by
|
|
|
|
# an appservice to register a new user.
|
|
|
|
APP_SERVICE_REGISTRATION_TYPE = "m.login.application_service"
|
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class EventTypes:
|
2014-12-03 09:07:21 -07:00
|
|
|
Member = "m.room.member"
|
|
|
|
Create = "m.room.create"
|
2018-08-22 03:57:54 -06:00
|
|
|
Tombstone = "m.room.tombstone"
|
2014-12-03 09:07:21 -07:00
|
|
|
JoinRules = "m.room.join_rules"
|
|
|
|
PowerLevels = "m.room.power_levels"
|
|
|
|
Aliases = "m.room.aliases"
|
2014-12-09 07:49:11 -07:00
|
|
|
Redaction = "m.room.redaction"
|
2015-10-01 10:49:52 -06:00
|
|
|
ThirdPartyInvite = "m.room.third_party_invite"
|
2019-04-02 10:15:24 -06:00
|
|
|
RelatedGroups = "m.room.related_groups"
|
2014-12-12 03:56:14 -07:00
|
|
|
|
2015-07-02 09:20:10 -06:00
|
|
|
RoomHistoryVisibility = "m.room.history_visibility"
|
2015-08-19 05:03:09 -06:00
|
|
|
CanonicalAlias = "m.room.canonical_alias"
|
2020-02-04 10:25:54 -07:00
|
|
|
Encrypted = "m.room.encrypted"
|
2015-08-20 07:35:40 -06:00
|
|
|
RoomAvatar = "m.room.avatar"
|
2019-01-30 09:26:13 -07:00
|
|
|
RoomEncryption = "m.room.encryption"
|
2015-11-10 09:57:13 -07:00
|
|
|
GuestAccess = "m.room.guest_access"
|
2015-07-02 09:20:10 -06:00
|
|
|
|
2014-12-12 03:56:14 -07:00
|
|
|
# These are used for validation
|
|
|
|
Message = "m.room.message"
|
|
|
|
Topic = "m.room.topic"
|
|
|
|
Name = "m.room.name"
|
2015-01-28 09:16:53 -07:00
|
|
|
|
2018-07-04 08:31:00 -06:00
|
|
|
ServerACL = "m.room.server_acl"
|
2018-08-15 08:04:30 -06:00
|
|
|
Pinned = "m.room.pinned_events"
|
2018-07-04 08:31:00 -06:00
|
|
|
|
2019-11-04 10:09:22 -07:00
|
|
|
Retention = "m.room.retention"
|
|
|
|
|
2020-12-18 02:49:18 -07:00
|
|
|
Dummy = "org.matrix.dummy_event"
|
|
|
|
|
2021-05-05 09:56:51 -06:00
|
|
|
SpaceChild = "m.space.child"
|
|
|
|
SpaceParent = "m.space.parent"
|
2021-03-18 12:24:16 -06:00
|
|
|
|
2021-06-22 03:02:53 -06:00
|
|
|
MSC2716_INSERTION = "org.matrix.msc2716.insertion"
|
2021-07-21 04:29:57 -06:00
|
|
|
MSC2716_CHUNK = "org.matrix.msc2716.chunk"
|
2021-06-22 03:02:53 -06:00
|
|
|
MSC2716_MARKER = "org.matrix.msc2716.marker"
|
|
|
|
|
2015-01-28 09:16:53 -07:00
|
|
|
|
2021-05-11 04:02:56 -06:00
|
|
|
class ToDeviceEventTypes:
|
|
|
|
RoomKeyRequest = "m.room_key_request"
|
|
|
|
|
|
|
|
|
2021-07-27 07:36:38 -06:00
|
|
|
class DeviceKeyAlgorithms:
|
|
|
|
"""Spec'd algorithms for the generation of per-device keys"""
|
|
|
|
|
|
|
|
ED25519 = "ed25519"
|
|
|
|
CURVE25519 = "curve25519"
|
|
|
|
SIGNED_CURVE25519 = "signed_curve25519"
|
|
|
|
|
|
|
|
|
2021-02-19 11:20:34 -07:00
|
|
|
class EduTypes:
|
|
|
|
Presence = "m.presence"
|
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class RejectedReason:
|
2015-01-28 09:16:53 -07:00
|
|
|
AUTH_ERROR = "auth_error"
|
2015-07-13 09:48:06 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class RoomCreationPreset:
|
2015-07-14 03:20:31 -06:00
|
|
|
PRIVATE_CHAT = "private_chat"
|
|
|
|
PUBLIC_CHAT = "public_chat"
|
2015-10-02 04:22:56 -06:00
|
|
|
TRUSTED_PRIVATE_CHAT = "trusted_private_chat"
|
2016-08-25 11:34:47 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class ThirdPartyEntityKind:
|
2016-08-25 11:34:47 -06:00
|
|
|
USER = "user"
|
|
|
|
LOCATION = "location"
|
2018-07-25 15:10:39 -06:00
|
|
|
|
|
|
|
|
2018-08-22 10:00:29 -06:00
|
|
|
ServerNoticeMsgType = "m.server_notice"
|
|
|
|
ServerNoticeLimitReached = "m.server_notice.usage_limit_reached"
|
2018-12-14 11:20:59 -07:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class UserTypes:
|
2018-12-14 11:20:59 -07:00
|
|
|
"""Allows for user type specific behaviour. With the benefit of hindsight
|
|
|
|
'admin' and 'guest' users should also be UserTypes. Normal users are type None
|
|
|
|
"""
|
2019-06-20 03:32:02 -06:00
|
|
|
|
2018-12-14 11:20:59 -07:00
|
|
|
SUPPORT = "support"
|
2019-08-23 02:52:09 -06:00
|
|
|
BOT = "bot"
|
|
|
|
ALL_USER_TYPES = (SUPPORT, BOT)
|
2019-05-14 09:59:21 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class RelationTypes:
|
2019-05-14 09:59:21 -06:00
|
|
|
"""The types of relations known to this server."""
|
2019-06-20 03:32:02 -06:00
|
|
|
|
2019-05-14 09:59:21 -06:00
|
|
|
ANNOTATION = "m.annotation"
|
2019-05-20 07:31:19 -06:00
|
|
|
REPLACE = "m.replace"
|
|
|
|
REFERENCE = "m.reference"
|
2019-10-24 04:48:46 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class LimitBlockingTypes:
|
2019-10-24 04:48:46 -06:00
|
|
|
"""Reasons that a server may be blocked"""
|
|
|
|
|
|
|
|
MONTHLY_ACTIVE_USER = "monthly_active_user"
|
|
|
|
HS_DISABLED = "hs_disabled"
|
2019-10-29 12:35:49 -06:00
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class EventContentFields:
|
2019-11-01 04:30:51 -06:00
|
|
|
"""Fields found in events' content, regardless of type."""
|
2019-11-01 04:39:14 -06:00
|
|
|
|
2019-11-01 04:30:51 -06:00
|
|
|
# Labels for the event, cf https://github.com/matrix-org/matrix-doc/pull/2326
|
2019-11-01 10:22:44 -06:00
|
|
|
LABELS = "org.matrix.labels"
|
2019-12-03 12:19:45 -07:00
|
|
|
|
|
|
|
# Timestamp to delete the event after
|
|
|
|
# cf https://github.com/matrix-org/matrix-doc/pull/2228
|
|
|
|
SELF_DESTRUCT_AFTER = "org.matrix.self_destruct_after"
|
2020-06-10 10:44:34 -06:00
|
|
|
|
2021-03-18 12:24:16 -06:00
|
|
|
# cf https://github.com/matrix-org/matrix-doc/pull/1772
|
2021-05-05 14:31:16 -06:00
|
|
|
ROOM_TYPE = "type"
|
2021-03-18 12:24:16 -06:00
|
|
|
|
2021-06-22 03:02:53 -06:00
|
|
|
# Used on normal messages to indicate they were historically imported after the fact
|
|
|
|
MSC2716_HISTORICAL = "org.matrix.msc2716.historical"
|
2021-07-21 04:29:57 -06:00
|
|
|
# For "insertion" events to indicate what the next chunk ID should be in
|
|
|
|
# order to connect to it
|
2021-06-22 03:02:53 -06:00
|
|
|
MSC2716_NEXT_CHUNK_ID = "org.matrix.msc2716.next_chunk_id"
|
2021-07-21 04:29:57 -06:00
|
|
|
# Used on "chunk" events to indicate which insertion event it connects to
|
2021-06-22 03:02:53 -06:00
|
|
|
MSC2716_CHUNK_ID = "org.matrix.msc2716.chunk_id"
|
|
|
|
# For "marker" events
|
|
|
|
MSC2716_MARKER_INSERTION = "org.matrix.msc2716.marker.insertion"
|
|
|
|
|
2020-06-10 10:44:34 -06:00
|
|
|
|
2021-06-29 10:00:04 -06:00
|
|
|
class RoomTypes:
|
|
|
|
"""Understood values of the room_type field of m.room.create events."""
|
|
|
|
|
|
|
|
SPACE = "m.space"
|
|
|
|
|
|
|
|
|
2020-09-04 04:54:56 -06:00
|
|
|
class RoomEncryptionAlgorithms:
|
2020-06-10 10:44:34 -06:00
|
|
|
MEGOLM_V1_AES_SHA2 = "m.megolm.v1.aes-sha2"
|
|
|
|
DEFAULT = MEGOLM_V1_AES_SHA2
|
2020-10-05 07:28:05 -06:00
|
|
|
|
|
|
|
|
|
|
|
class AccountDataTypes:
|
|
|
|
DIRECT = "m.direct"
|
|
|
|
IGNORED_USER_LIST = "m.ignored_user_list"
|
2020-12-16 06:46:37 -07:00
|
|
|
|
|
|
|
|
|
|
|
class HistoryVisibility:
|
|
|
|
INVITED = "invited"
|
|
|
|
JOINED = "joined"
|
|
|
|
SHARED = "shared"
|
|
|
|
WORLD_READABLE = "world_readable"
|
2021-07-28 02:05:11 -06:00
|
|
|
|
|
|
|
|
|
|
|
class ReadReceiptEventFields:
|
|
|
|
MSC2285_HIDDEN = "org.matrix.msc2285.hidden"
|