chore(http): add new package

2022-05-23 16:29:44 +02:00
parent 15b9f979a2
commit 8892337b93
27 changed files with 1928 additions and 0 deletions
@@ -0,0 +1,31 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+enum AuthenticationMethods {
+  basic('Basic'),
+  bearer('Bearer'),
+  digest('Digest'),
+  apiKey('ApiKey');
+
+  final String name;
+
+  @override
+  String toString() {
+    return name;
+  }
+
+  const AuthenticationMethods(this.name);
+}
@@ -0,0 +1,39 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+class Convert {
+  static String toHex(List<int> bytes, {bool upperCase = false}) {
+    final buffer = StringBuffer();
+    for (final int part in bytes) {
+      if (part & 0xff != part) {
+        throw FormatException('Non-byte integer detected');
+      }
+      buffer.write('${part < 16 ? '0' : ''}${part.toRadixString(16)}');
+    }
+    if (upperCase) {
+      return buffer.toString().toUpperCase();
+    } else {
+      return buffer.toString();
+    }
+  }
+}
+
+extension UriX on Uri {
+  Uri operator +(String path) {
+    final thisPath = toString();
+    return Uri.parse(thisPath + path);
+  }
+}
@@ -0,0 +1,29 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import 'dart:convert';
+
+import 'package:crypto/crypto.dart';
+
+class Crypto {
+  /// Hash a string using MD5
+  static String md5Hash(String data) {
+    final content = Utf8Encoder().convert(data);
+    final md5Crypto = md5;
+    final digest = md5Crypto.convert(content).toString();
+    return digest;
+  }
+}
@@ -0,0 +1,198 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import 'dart:math';
+
+import 'package:wyatt_http_client/src/utils/convert.dart';
+import 'package:wyatt_http_client/src/utils/crypto.dart';
+
+class DigestAuth {
+  String username;
+  String password;
+
+  // must get from first response
+  String? _algorithm;
+  String? _qop;
+  String? _realm;
+  String? _nonce;
+  String? _opaque;
+
+  int _nc = 0; // request counter
+
+  DigestAuth(this.username, this.password);
+
+  /// Splits WWW-Authenticate header into a map.
+  Map<String, String>? splitWWWAuthenticateHeader(String header) {
+    if (!header.startsWith('Digest ')) {
+      throw ArgumentError.value(
+        header,
+        'header',
+        'Header must start with "Digest "',
+      );
+    }
+    final h = header.substring(7); // remove 'Digest '
+    final ret = <String, String>{};
+
+    final components = h.split(',').map((token) => token.trim());
+    for (final component in components) {
+      final kv = component.split('=');
+      ret[kv[0]] = kv.getRange(1, kv.length).join('=').replaceAll('"', '');
+    }
+    return ret;
+  }
+
+  String _computeNonce() {
+    final rnd = Random.secure();
+    final values = List<int>.generate(16, (i) => rnd.nextInt(256));
+
+    return Convert.toHex(values);
+  }
+
+  String _formatNonceCount(int nc) {
+    return nc.toRadixString(16).padLeft(8, '0');
+  }
+
+  String _computeHA1(
+    String realm,
+    String? algorithm,
+    String username,
+    String password,
+    String? nonce,
+    String? cnonce,
+  ) {
+    if (algorithm == null || algorithm == 'MD5') {
+      final token1 = '$username:$realm:$password';
+      return Crypto.md5Hash(token1);
+    } else if (algorithm == 'MD5-sess') {
+      final token1 = '$username:$realm:$password';
+      final md51 = Crypto.md5Hash(token1);
+      final token2 = '$md51:$nonce:$cnonce';
+      return Crypto.md5Hash(token2);
+    } else {
+      throw ArgumentError.value(
+        algorithm,
+        'algorithm',
+        'Unsupported algorithm',
+      );
+    }
+  }
+
+  Map<String, String?> _computeResponse(
+    String method,
+    String path,
+    String body,
+    String? algorithm,
+    String? qop,
+    String? opaque,
+    String realm,
+    String? cnonce,
+    String? nonce,
+    int nc,
+    String username,
+    String password,
+  ) {
+    final ret = <String, String?>{};
+
+    final ha1 =
+        _computeHA1(realm, algorithm, username, password, nonce, cnonce);
+
+    String ha2;
+
+    if (qop == 'auth-int') {
+      final bodyHash = Crypto.md5Hash(body);
+      final token2 = '$method:$path:$bodyHash';
+      ha2 = Crypto.md5Hash(token2);
+    } else {
+      // qop in [null, auth]
+      final token2 = '$method:$path';
+      ha2 = Crypto.md5Hash(token2);
+    }
+
+    final nonceCount = _formatNonceCount(nc);
+    ret['username'] = username;
+    ret['realm'] = realm;
+    ret['nonce'] = nonce;
+    ret['uri'] = path;
+    if (qop != null) {
+      ret['qop'] = qop;
+    }
+    ret['nc'] = nonceCount;
+    ret['cnonce'] = cnonce;
+    if (opaque != null) {
+      ret['opaque'] = opaque;
+    }
+    ret['algorithm'] = algorithm;
+
+    if (qop == null) {
+      final token3 = '$ha1:$nonce:$ha2';
+      ret['response'] = Crypto.md5Hash(token3);
+    } else if (qop == 'auth' || qop == 'auth-int') {
+      final token3 = '$ha1:$nonce:$nonceCount:$cnonce:$qop:$ha2';
+      ret['response'] = Crypto.md5Hash(token3);
+    }
+
+    return ret;
+  }
+
+  String getAuthString(String method, Uri url) {
+    final _cnonce = _computeNonce();
+    _nc += 1;
+    // if url has query parameters, append query to path
+    final path = url.hasQuery ? '${url.path}?${url.query}' : url.path;
+
+    // after the first request we have the nonce, so we can provide credentials
+    final authValues = _computeResponse(
+      method,
+      path,
+      '',
+      _algorithm,
+      _qop,
+      _opaque,
+      _realm!,
+      _cnonce,
+      _nonce,
+      _nc,
+      username,
+      password,
+    );
+    final authValuesString = authValues.entries
+        .where((e) => e.value != null)
+        .map((e) => [e.key, '="', e.value, '"'].join())
+        .toList()
+        .join(', ');
+    final authString = 'Digest $authValuesString';
+    return authString;
+  }
+
+  void initFromAuthenticateHeader(String? authInfo) {
+    if (authInfo == null) {
+      throw ArgumentError.notNull('authInfo');
+    }
+    final values = splitWWWAuthenticateHeader(authInfo);
+    if (values != null) {
+      _algorithm = values['algorithm'] ?? _algorithm;
+      _qop = values['qop'] ?? _qop;
+      _realm = values['realm'] ?? _realm;
+      _nonce = values['nonce'] ?? _nonce;
+      _opaque = values['opaque'] ?? _opaque;
+      _nc = 0;
+    }
+  }
+
+  bool isReady() {
+    return _nonce != null && (_nc == 0 || _qop != null);
+  }
+}
@@ -0,0 +1,30 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+enum HeaderKeys {
+  authorization('Authorization'),
+  wwwAuthenticate('WWW-Authenticate'),
+  contentType('Content-Type');
+
+  final String name;
+
+  @override
+  String toString() {
+    return name;
+  }
+
+  const HeaderKeys(this.name);
+}
@@ -0,0 +1,23 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+enum Protocols {
+  http,
+  https;
+
+  String get name => toString().split('.').last;
+  String get scheme => '$name://';
+}
@@ -0,0 +1,89 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import 'package:http/http.dart';
+
+abstract class Utils {
+  static Request _copyNormalRequest(Request original) {
+    final request = Request(original.method, original.url)
+      ..followRedirects = original.followRedirects
+      ..headers.addAll(original.headers)
+      ..maxRedirects = original.maxRedirects
+      ..persistentConnection = original.persistentConnection
+      ..body = original.body;
+
+    return request;
+  }
+
+  static Request _copyNormalRequestWith(
+    Request original, {
+    String? method,
+    Uri? url,
+    Map<String, String>? headers,
+    int? maxRedirects,
+    bool? followRedirects,
+    bool? persistentConnection,
+    String? body,
+  }) {
+    final request = Request(method ?? original.method, url ?? original.url)
+      ..followRedirects = followRedirects ?? original.followRedirects
+      ..headers.addAll(headers ?? original.headers)
+      ..maxRedirects = maxRedirects ?? original.maxRedirects
+      ..persistentConnection =
+          persistentConnection ?? original.persistentConnection
+      ..body = body ?? original.body;
+
+    return request;
+  }
+
+  static BaseRequest copyRequest(BaseRequest original) {
+    if (original is Request) {
+      return _copyNormalRequest(original);
+    } else {
+      throw UnimplementedError(
+        'Cannot handle requests of type ${original.runtimeType}',
+      );
+    }
+  }
+
+  static BaseRequest copyRequestWith(
+    BaseRequest original, {
+    String? method,
+    Uri? url,
+    Map<String, String>? headers,
+    int? maxRedirects,
+    bool? followRedirects,
+    bool? persistentConnection,
+    String? body,
+  }) {
+    if (original is Request) {
+      return _copyNormalRequestWith(
+        original,
+        method: method,
+        url: url,
+        headers: headers,
+        maxRedirects: maxRedirects,
+        followRedirects: followRedirects,
+        persistentConnection: persistentConnection,
+        body: body,
+      );
+    } else {
+      throw UnimplementedError(
+        'Cannot handle requests of type ${original.runtimeType}',
+      );
+    }
+  }
+}