fix(xep): Fix issues with enhanced enums

packages/moxxmpp/CHANGELOG.md

@@ -1,6 +1,7 @@
 ## 0.3.2
 
 - **BREAKING**: Remove `lastResource` from `XmppConnection`'s `connect` method. Instead, set the `StreamManagementNegotiator`'s `resource` attribute instead. Since the resource can only really be restored by stream management, this is no issue.
+- **BREAKING**: Changed order of parameters of `CryptographicHashManager.hashFromData`
 
 ## 0.3.1
 

packages/moxxmpp/lib/src/namespaces.dart

@@ -74,12 +74,6 @@ const forwardedXmlns = 'urn:xmpp:forward:0';
 // XEP-0300
 const hashXmlns = 'urn:xmpp:hashes:2';
 const hashFunctionNameBaseXmlns = 'urn:xmpp:hash-function-text-names';
-const hashSha256 = 'sha-256';
-const hashSha512 = 'sha-512';
-const hashSha3256 = 'sha3-256';
-const hashSha3512 = 'sha3-512';
-const hashBlake2b256 = 'blake2b-256';
-const hashBlake2b512 = 'blake2b-512';
 
 // XEP-0308
 const lmcXmlns = 'urn:xmpp:message-correct:0';

packages/moxxmpp/lib/src/xeps/xep_0300.dart

@@ -4,62 +4,84 @@ import 'package:moxxmpp/src/managers/namespaces.dart';
 import 'package:moxxmpp/src/namespaces.dart';
 import 'package:moxxmpp/src/stringxml.dart';
 
-XMLNode constructHashElement(String algo, String base64Hash) {
+/// Hash names
+const _hashSha256 = 'sha-256';
+const _hashSha512 = 'sha-512';
+const _hashSha3256 = 'sha3-256';
+const _hashSha3512 = 'sha3-512';
+const _hashBlake2b256 = 'blake2b-256';
+const _hashBlake2b512 = 'blake2b-512';
+
+/// Helper method for building a <hash /> element according to XEP-0300.
+XMLNode constructHashElement(HashFunction hash, String value) {
   return XMLNode.xmlns(
     tag: 'hash',
     xmlns: hashXmlns,
-    attributes: {'algo': algo},
+    attributes: {'algo': hash.toName()},
-    text: base64Hash,
+    text: value,
   );
 }
 
 enum HashFunction {
+  /// SHA-256
   sha256,
+
+  /// SHA-256
   sha512,
+
+  /// SHA3-256
   sha3_256,
+
+  /// SHA3-512
   sha3_512,
+
+  /// BLAKE2b-256
   blake2b256,
-  blake2b512,
-}
 
-extension HashNameToEnumExtension on HashFunction {
+  /// BLAKE2b-512
-  String toName() {
+  blake2b512;
-    switch (this) {
-      case HashFunction.sha256:
-        return hashSha256;
-      case HashFunction.sha512:
-        return hashSha512;
-      case HashFunction.sha3_256:
-        return hashSha3512;
-      case HashFunction.sha3_512:
-        return hashSha3512;
-      case HashFunction.blake2b256:
-        return hashBlake2b256;
-      case HashFunction.blake2b512:
-        return hashBlake2b512;
-    }
-  }
-}
 
-HashFunction hashFunctionFromName(String name) {
+  /// Get a HashFunction from its name [name] according to either
+  /// - IANA's hash name register (http://www.iana.org/assignments/hash-function-text-names/hash-function-text-names.xhtml)
+  /// - XEP-0300
+  factory HashFunction.fromName(String name) {
     switch (name) {
-    case hashSha256:
+      case _hashSha256:
         return HashFunction.sha256;
-    case hashSha512:
+      case _hashSha512:
         return HashFunction.sha512;
-    case hashSha3256:
+      case _hashSha3256:
         return HashFunction.sha3_256;
-    case hashSha3512:
+      case _hashSha3512:
         return HashFunction.sha3_512;
-    case hashBlake2b256:
+      case _hashBlake2b256:
         return HashFunction.blake2b256;
-    case hashBlake2b512:
+      case _hashBlake2b512:
         return HashFunction.blake2b512;
     }
 
     throw Exception();
   }
 
+  /// Return the hash function's name according to IANA's hash name register or XEP-0300.
+  String toName() {
+    switch (this) {
+      case HashFunction.sha256:
+        return _hashSha256;
+      case HashFunction.sha512:
+        return _hashSha512;
+      case HashFunction.sha3_256:
+        return _hashSha3512;
+      case HashFunction.sha3_512:
+        return _hashSha3512;
+      case HashFunction.blake2b256:
+        return _hashBlake2b256;
+      case HashFunction.blake2b512:
+        return _hashBlake2b512;
+    }
+  }
+}
+
 class CryptographicHashManager extends XmppManagerBase {
   CryptographicHashManager() : super(cryptographicHashManager);
 
@@ -68,17 +90,19 @@ class CryptographicHashManager extends XmppManagerBase {
 
   @override
   List<String> getDiscoFeatures() => [
-        '$hashFunctionNameBaseXmlns:$hashSha256',
+        '$hashFunctionNameBaseXmlns:$_hashSha256',
-        '$hashFunctionNameBaseXmlns:$hashSha512',
+        '$hashFunctionNameBaseXmlns:$_hashSha512',
-        //'$hashFunctionNameBaseXmlns:$hashSha3256',
+        //'$hashFunctionNameBaseXmlns:$_hashSha3256',
-        //'$hashFunctionNameBaseXmlns:$hashSha3512',
+        //'$hashFunctionNameBaseXmlns:$_hashSha3512',
-        //'$hashFunctionNameBaseXmlns:$hashBlake2b256',
+        //'$hashFunctionNameBaseXmlns:$_hashBlake2b256',
-        '$hashFunctionNameBaseXmlns:$hashBlake2b512',
+        '$hashFunctionNameBaseXmlns:$_hashBlake2b512',
       ];
 
+  /// Compute the raw hash value of [data] using the algorithm specified by [function].
+  /// If the function is not supported, an exception will be thrown.
   static Future<List<int>> hashFromData(
-    List<int> data,
     HashFunction function,
+    List<int> data,
   ) async {
     // TODO(PapaTutuWawa): Implement the others as well
     HashAlgorithm algo;

packages/moxxmpp/lib/src/xeps/xep_0446.dart

@@ -13,7 +13,7 @@ class FileMetadataData {
     this.name,
     this.size,
     required this.thumbnails,
-    Map<String, String>? hashes,
+    Map<HashFunction, String>? hashes,
   }) : hashes = hashes ?? const {};
 
   /// Parse [node] as a FileMetadataData element.
@@ -31,9 +31,11 @@ class FileMetadataData {
     final size =
         sizeElement != null ? int.parse(sizeElement.innerText()) : null;
 
-    final hashes = <String, String>{};
+    final hashes = <HashFunction, String>{};
     for (final e in node.findTags('hash')) {
-      hashes[e.attributes['algo']! as String] = e.innerText();
+      final hashFunction =
+          HashFunction.fromName(e.attributes['algo']! as String);
+      hashes[hashFunction] = e.innerText();
     }
 
     // Thumbnails
@@ -75,7 +77,7 @@ class FileMetadataData {
   final int? height;
   final List<Thumbnail> thumbnails;
   final String? desc;
-  final Map<String, String> hashes;
+  final Map<HashFunction, String> hashes;
   final int? length;
   final String? name;
   final int? size;

packages/moxxmpp/lib/src/xeps/xep_0448.dart

@@ -8,23 +8,9 @@ import 'package:moxxmpp/src/xeps/xep_0447.dart';
 enum SFSEncryptionType {
   aes128GcmNoPadding,
   aes256GcmNoPadding,
-  aes256CbcPkcs7,
+  aes256CbcPkcs7;
-}
 
-extension SFSEncryptionTypeNamespaceExtension on SFSEncryptionType {
+  factory SFSEncryptionType.fromNamespace(String xmlns) {
-  String toNamespace() {
-    switch (this) {
-      case SFSEncryptionType.aes128GcmNoPadding:
-        return sfsEncryptionAes128GcmNoPaddingXmlns;
-      case SFSEncryptionType.aes256GcmNoPadding:
-        return sfsEncryptionAes256GcmNoPaddingXmlns;
-      case SFSEncryptionType.aes256CbcPkcs7:
-        return sfsEncryptionAes256CbcPkcs7Xmlns;
-    }
-  }
-}
-
-SFSEncryptionType encryptionTypeFromNamespace(String xmlns) {
     switch (xmlns) {
       case sfsEncryptionAes128GcmNoPaddingXmlns:
         return SFSEncryptionType.aes128GcmNoPadding;
@@ -37,6 +23,18 @@ SFSEncryptionType encryptionTypeFromNamespace(String xmlns) {
     throw Exception();
   }
 
+  String toNamespace() {
+    switch (this) {
+      case SFSEncryptionType.aes128GcmNoPadding:
+        return sfsEncryptionAes128GcmNoPaddingXmlns;
+      case SFSEncryptionType.aes256GcmNoPadding:
+        return sfsEncryptionAes256GcmNoPaddingXmlns;
+      case SFSEncryptionType.aes256CbcPkcs7:
+        return sfsEncryptionAes256CbcPkcs7Xmlns;
+    }
+  }
+}
+
 class StatelessFileSharingEncryptedSource extends StatelessFileSharingSource {
   StatelessFileSharingEncryptedSource(
     this.encryption,
@@ -63,13 +61,15 @@ class StatelessFileSharingEncryptedSource extends StatelessFileSharingSource {
     )!;
 
     // Find hashes
-    final hashes = <String, String>{};
+    final hashes = <HashFunction, String>{};
     for (final hash in element.findTags('hash', xmlns: hashXmlns)) {
-      hashes[hash.attributes['algo']! as String] = hash.text!;
+      final hashFunction =
+          HashFunction.fromName(hash.attributes['algo']! as String);
+      hashes[hashFunction] = hash.text!;
     }
 
     return StatelessFileSharingEncryptedSource(
-      encryptionTypeFromNamespace(element.attributes['cipher']! as String),
+      SFSEncryptionType.fromNamespace(element.attributes['cipher']! as String),
       key,
       iv,
       hashes,
@@ -80,7 +80,7 @@ class StatelessFileSharingEncryptedSource extends StatelessFileSharingSource {
   final List<int> key;
   final List<int> iv;
   final SFSEncryptionType encryption;
-  final Map<String, String> hashes;
+  final Map<HashFunction, String> hashes;
   final StatelessFileSharingUrlSource source;
 
   @override

packages/moxxmpp/lib/src/xeps/xep_0449.dart

@@ -87,7 +87,7 @@ class StickerPack {
     var hashValue = '';
     if (hashAvailable) {
       final hash = node.firstTag('hash', xmlns: hashXmlns)!;
-      hashAlgorithm = hashFunctionFromName(hash.attributes['algo']! as String);
+      hashAlgorithm = HashFunction.fromName(hash.attributes['algo']! as String);
       hashValue = hash.innerText();
     }
 
@@ -144,7 +144,7 @@ class StickerPack {
           text: summary,
         ),
         constructHashElement(
-          hashAlgorithm.toName(),
+          hashAlgorithm,
           hashValue,
         ),
 
@@ -193,7 +193,7 @@ class StickerPack {
       final hashes = List<List<int>>.empty(growable: true);
       for (final hash in sticker.metadata.hashes.keys) {
         hashes.add([
-          ...utf8.encode(hash),
+          ...utf8.encode(hash.toName()),
           0x1f,
           ...utf8.encode(sticker.metadata.hashes[hash]!),
           0x1f,
@@ -217,11 +217,11 @@ class StickerPack {
 
     // Calculate the hash
     final rawHash = await CryptographicHashManager.hashFromData(
+      hashFunction,
       [
         ...metaString,
         ...stickersString,
       ],
-      hashFunction,
     );
     return base64.encode(rawHash).substring(0, 24);
   }