155 lines
3.9 KiB
Python
155 lines
3.9 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Copyright 2014-2016 OpenMarket Ltd
|
|
# Copyright 2017 Vector Creations Ltd
|
|
# Copyright 2018 New Vector Ltd.
|
|
#
|
|
# 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.
|
|
|
|
"""Contains constants from the specification."""
|
|
|
|
# the "depth" field on events is limited to 2**63 - 1
|
|
MAX_DEPTH = 2**63 - 1
|
|
|
|
|
|
class Membership(object):
|
|
|
|
"""Represents the membership states of a user in a room."""
|
|
INVITE = u"invite"
|
|
JOIN = u"join"
|
|
KNOCK = u"knock"
|
|
LEAVE = u"leave"
|
|
BAN = u"ban"
|
|
LIST = (INVITE, JOIN, KNOCK, LEAVE, BAN)
|
|
|
|
|
|
class PresenceState(object):
|
|
"""Represents the presence state of a user."""
|
|
OFFLINE = u"offline"
|
|
UNAVAILABLE = u"unavailable"
|
|
ONLINE = u"online"
|
|
|
|
|
|
class JoinRules(object):
|
|
PUBLIC = u"public"
|
|
KNOCK = u"knock"
|
|
INVITE = u"invite"
|
|
PRIVATE = u"private"
|
|
|
|
|
|
class LoginType(object):
|
|
PASSWORD = u"m.login.password"
|
|
EMAIL_IDENTITY = u"m.login.email.identity"
|
|
MSISDN = u"m.login.msisdn"
|
|
RECAPTCHA = u"m.login.recaptcha"
|
|
TERMS = u"m.login.terms"
|
|
DUMMY = u"m.login.dummy"
|
|
|
|
# Only for C/S API v1
|
|
APPLICATION_SERVICE = u"m.login.application_service"
|
|
SHARED_SECRET = u"org.matrix.login.shared_secret"
|
|
|
|
|
|
class EventTypes(object):
|
|
Member = "m.room.member"
|
|
Create = "m.room.create"
|
|
Tombstone = "m.room.tombstone"
|
|
JoinRules = "m.room.join_rules"
|
|
PowerLevels = "m.room.power_levels"
|
|
Aliases = "m.room.aliases"
|
|
Redaction = "m.room.redaction"
|
|
ThirdPartyInvite = "m.room.third_party_invite"
|
|
Encryption = "m.room.encryption"
|
|
|
|
RoomHistoryVisibility = "m.room.history_visibility"
|
|
CanonicalAlias = "m.room.canonical_alias"
|
|
RoomAvatar = "m.room.avatar"
|
|
RoomEncryption = "m.room.encryption"
|
|
GuestAccess = "m.room.guest_access"
|
|
|
|
# These are used for validation
|
|
Message = "m.room.message"
|
|
Topic = "m.room.topic"
|
|
Name = "m.room.name"
|
|
|
|
ServerACL = "m.room.server_acl"
|
|
Pinned = "m.room.pinned_events"
|
|
|
|
|
|
class RejectedReason(object):
|
|
AUTH_ERROR = "auth_error"
|
|
REPLACED = "replaced"
|
|
NOT_ANCESTOR = "not_ancestor"
|
|
|
|
|
|
class RoomCreationPreset(object):
|
|
PRIVATE_CHAT = "private_chat"
|
|
PUBLIC_CHAT = "public_chat"
|
|
TRUSTED_PRIVATE_CHAT = "trusted_private_chat"
|
|
|
|
|
|
class ThirdPartyEntityKind(object):
|
|
USER = "user"
|
|
LOCATION = "location"
|
|
|
|
|
|
class RoomVersions(object):
|
|
V1 = "1"
|
|
V2 = "2"
|
|
V3 = "3"
|
|
STATE_V2_TEST = "state-v2-test"
|
|
|
|
|
|
class RoomDisposition(object):
|
|
STABLE = "stable"
|
|
UNSTABLE = "unstable"
|
|
|
|
|
|
# the version we will give rooms which are created on this server
|
|
DEFAULT_ROOM_VERSION = RoomVersions.V1
|
|
|
|
# vdh-test-version is a placeholder to get room versioning support working and tested
|
|
# until we have a working v2.
|
|
KNOWN_ROOM_VERSIONS = {
|
|
RoomVersions.V1,
|
|
RoomVersions.V2,
|
|
RoomVersions.V3,
|
|
RoomVersions.STATE_V2_TEST,
|
|
RoomVersions.V3,
|
|
}
|
|
|
|
|
|
class EventFormatVersions(object):
|
|
"""This is an internal enum for tracking the version of the event format,
|
|
independently from the room version.
|
|
"""
|
|
V1 = 1
|
|
V2 = 2
|
|
|
|
|
|
KNOWN_EVENT_FORMAT_VERSIONS = {
|
|
EventFormatVersions.V1,
|
|
EventFormatVersions.V2,
|
|
}
|
|
|
|
|
|
ServerNoticeMsgType = "m.server_notice"
|
|
ServerNoticeLimitReached = "m.server_notice.usage_limit_reached"
|
|
|
|
|
|
class UserTypes(object):
|
|
"""Allows for user type specific behaviour. With the benefit of hindsight
|
|
'admin' and 'guest' users should also be UserTypes. Normal users are type None
|
|
"""
|
|
SUPPORT = "support"
|
|
ALL_USER_TYPES = (SUPPORT,)
|