summaryrefslogtreecommitdiff
path: root/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto
diff options
context:
space:
mode:
Diffstat (limited to 'includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto')
-rw-r--r--includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/CryptoBackend.ts170
-rw-r--r--includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/README.md4
2 files changed, 0 insertions, 174 deletions
diff --git a/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/CryptoBackend.ts b/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/CryptoBackend.ts
deleted file mode 100644
index a0b4621..0000000
--- a/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/CryptoBackend.ts
+++ /dev/null
@@ -1,170 +0,0 @@
-/*
-Copyright 2022 The Matrix.org Foundation C.I.C.
-
-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.
-*/
-
-import type { IToDeviceEvent } from "../sync-accumulator";
-import { MatrixEvent } from "../models/event";
-import { Room } from "../models/room";
-import { CryptoApi } from "../crypto-api";
-import { DeviceTrustLevel, UserTrustLevel } from "../crypto/CrossSigning";
-import { IEncryptedEventInfo } from "../crypto/api";
-import { IEventDecryptionResult } from "../@types/crypto";
-
-/**
- * Common interface for the crypto implementations
- */
-export interface CryptoBackend extends SyncCryptoCallbacks, CryptoApi {
- /**
- * Whether sendMessage in a room with unknown and unverified devices
- * should throw an error and not send the message. This has 'Global' for
- * symmetry with setGlobalBlacklistUnverifiedDevices but there is currently
- * no room-level equivalent for this setting.
- *
- * @remarks this is here, rather than in `CryptoApi`, because I don't think we're
- * going to support it in the rust crypto implementation.
- */
- globalErrorOnUnknownDevices: boolean;
-
- /**
- * Shut down any background processes related to crypto
- */
- stop(): void;
-
- /**
- * Get the verification level for a given user
- *
- * TODO: define this better
- *
- * @param userId - user to be checked
- */
- checkUserTrust(userId: string): UserTrustLevel;
-
- /**
- * Get the verification level for a given device
- *
- * TODO: define this better
- *
- * @param userId - user to be checked
- * @param deviceId - device to be checked
- */
- checkDeviceTrust(userId: string, deviceId: string): DeviceTrustLevel;
-
- /**
- * Encrypt an event according to the configuration of the room.
- *
- * @param event - event to be sent
- *
- * @param room - destination room.
- *
- * @returns Promise which resolves when the event has been
- * encrypted, or null if nothing was needed
- */
- encryptEvent(event: MatrixEvent, room: Room): Promise<void>;
-
- /**
- * Decrypt a received event
- *
- * @returns a promise which resolves once we have finished decrypting.
- * Rejects with an error if there is a problem decrypting the event.
- */
- decryptEvent(event: MatrixEvent): Promise<IEventDecryptionResult>;
-
- /**
- * Get information about the encryption of an event
- *
- * @param event - event to be checked
- */
- getEventEncryptionInfo(event: MatrixEvent): IEncryptedEventInfo;
-}
-
-/** The methods which crypto implementations should expose to the Sync api */
-export interface SyncCryptoCallbacks {
- /**
- * Called by the /sync loop whenever there are incoming to-device messages.
- *
- * The implementation may preprocess the received messages (eg, decrypt them) and return an
- * updated list of messages for dispatch to the rest of the system.
- *
- * Note that, unlike {@link ClientEvent.ToDeviceEvent} events, this is called on the raw to-device
- * messages, rather than the results of any decryption attempts.
- *
- * @param events - the received to-device messages
- * @returns A list of preprocessed to-device messages.
- */
- preprocessToDeviceMessages(events: IToDeviceEvent[]): Promise<IToDeviceEvent[]>;
-
- /**
- * Called by the /sync loop whenever there are incoming to-device messages.
- *
- * The implementation may preprocess the received messages (eg, decrypt them) and return an
- * updated list of messages for dispatch to the rest of the system.
- *
- * Note that, unlike {@link ClientEvent.ToDeviceEvent} events, this is called on the raw to-device
- * messages, rather than the results of any decryption attempts.
- *
- * @param oneTimeKeysCounts - the received one time key counts
- * @returns A list of preprocessed to-device messages.
- */
- preprocessOneTimeKeyCounts(oneTimeKeysCounts: Map<string, number>): Promise<void>;
-
- /**
- * Called by the /sync loop whenever there are incoming to-device messages.
- *
- * The implementation may preprocess the received messages (eg, decrypt them) and return an
- * updated list of messages for dispatch to the rest of the system.
- *
- * Note that, unlike {@link ClientEvent.ToDeviceEvent} events, this is called on the raw to-device
- * messages, rather than the results of any decryption attempts.
- *
- * @param unusedFallbackKeys - the received unused fallback keys
- * @returns A list of preprocessed to-device messages.
- */
- preprocessUnusedFallbackKeys(unusedFallbackKeys: Set<string>): Promise<void>;
-
- /**
- * Called by the /sync loop whenever an m.room.encryption event is received.
- *
- * This is called before RoomStateEvents are emitted for any of the events in the /sync
- * response (even if the other events technically happened first). This works around a problem
- * if the client uses a RoomStateEvent (typically a membership event) as a trigger to send a message
- * in a new room (or one where encryption has been newly enabled): that would otherwise leave the
- * crypto layer confused because it expects crypto to be set up, but it has not yet been.
- *
- * @param room - in which the event was received
- * @param event - encryption event to be processed
- */
- onCryptoEvent(room: Room, event: MatrixEvent): Promise<void>;
-
- /**
- * Called by the /sync loop after each /sync response is processed.
- *
- * Used to complete batch processing, or to initiate background processes
- *
- * @param syncState - information about the completed sync.
- */
- onSyncCompleted(syncState: OnSyncCompletedData): void;
-}
-
-export interface OnSyncCompletedData {
- /**
- * The 'next_batch' result from /sync, which will become the 'since' token for the next call to /sync.
- */
- nextSyncToken?: string;
-
- /**
- * True if we are working our way through a backlog of events after connecting.
- */
- catchingUp?: boolean;
-}
diff --git a/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/README.md b/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/README.md
deleted file mode 100644
index 7af3298..0000000
--- a/includes/external/matrix/node_modules/matrix-js-sdk/src/common-crypto/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-This directory contains functionality which is common to both the legacy (libolm-based) crypto implementation,
-and the new rust-based implementation.
-
-It is an internal module, and is _not_ directly exposed to applications.