Initial commit (WIP)

Author: MeixDev

.gitignore

@@ -0,0 +1,29 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+.packages
+build/

.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: db747aa1331bd95bc9b3874c842261ca2d302cd5
+  channel: stable
+
+project_type: package

CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+* TODO: Describe initial release.

LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.

README.md

@@ -1,2 +1,39 @@
-# discord_api_flutter
-A Flutter client to connect to Discord using OAuth2 authentication 
+<!-- 
+This README describes the package. If you publish this package to pub.dev,
+this README's contents appear on the landing page for your package.
+
+For information about how to write a good package README, see the guide for
+[writing package pages](https://dart.dev/guides/libraries/writing-package-pages). 
+
+For general information about developing packages, see the Dart guide for
+[creating packages](https://dart.dev/guides/libraries/create-library-packages)
+and the Flutter guide for
+[developing packages and plugins](https://flutter.dev/developing-packages). 
+-->
+
+TODO: Put a short description of the package here that helps potential users
+know whether this package might be useful for them.
+
+## Features
+
+TODO: List what your package can do. Maybe include images, gifs, or videos.
+
+## Getting started
+
+TODO: List prerequisites and provide or point to information on how to
+start using the package.
+
+## Usage
+
+TODO: Include short and useful examples for package users. Add longer examples
+to `/example` folder. 
+
+```dart
+const like = 'sample';
+```
+
+## Additional information
+
+TODO: Tell users more about the package: where to find more information, how to 
+contribute to the package, how to file issues, what response they can expect 
+from the package authors, and more.

analysis_options.yaml

@@ -0,0 +1,4 @@
+include: package:flutter_lints/flutter.yaml
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options

lib/discord_api.dart

@@ -0,0 +1 @@
+library discord_api;

lib/src/discord_client.dart

@@ -0,0 +1,82 @@
+import 'dart:async';
+
+import 'models/discord_api_scope.dart';
+import 'models/discord_token.dart';
+import 'providers/discord_http_client.dart';
+
+class DiscordClient {
+  static const apiVersion = "9";
+
+  static const oauth2Path = "oauth2";
+  static const authPath = "authorize";
+  static const tokenPath = "token";
+  static const revokePath = "revoke";
+  static const apiPath = "api";
+  static const versionPath = "v$apiVersion";
+
+  static final baseUrl = Uri(scheme: 'https', host: 'discord.com');
+
+  final String redirectUri;
+  final String clientId;
+  final String clientSecret;
+  final DiscordHttpClient discordHttpClient;
+
+  /// If you need it, you can get the [DiscordDioProvider] from the discord_api_dio_provider package.
+  /// Otherwise, you'll have to implement `discordHttpClient` yourself.
+  DiscordClient({
+    required this.clientId,
+    required this.clientSecret,
+    required this.redirectUri,
+    required this.discordHttpClient,
+    DiscordToken? token,
+  }) {
+    if (token != null) {
+      initializeToken(token);
+    }
+  }
+
+  /// Return the authorization Uri for the Discord API.
+  Uri authorizeUri(List<DiscordApiScope> scopes) {
+    final scopesSet = <String>{}..addAll(scopes.map((e) => e.string).toSet());
+    return baseUrl.replace(pathSegments: <String>[
+      apiPath,
+      versionPath,
+      oauth2Path,
+      authPath
+    ], queryParameters: {
+      'response_type': 'code',
+      'client_id': clientId,
+      'scope': scopesSet.join(' '),
+      'redirect_uri': redirectUri,
+      //'state': generateState() ?
+    });
+  }
+
+  static Uri get tokenUri => baseUrl.replace(
+      pathSegments: <String>[apiPath, versionPath, oauth2Path, tokenPath]);
+  static Uri get revokeUri => baseUrl.replace(
+      pathSegments: <String>[apiPath, versionPath, oauth2Path, revokePath]);
+
+  void initializeToken(DiscordToken discordToken) =>
+      discordHttpClient.initializeToken(discordToken);
+
+  // There is little reason to call either of those methods, as they're related to the authorization flow, and not any API usage.
+
+  Future<void> getAccessToken(String code) async {
+    await discordHttpClient.getAccessToken(code, redirectUri);
+  }
+
+  Future<void> refreshAccessToken() async {
+    await discordHttpClient.refreshAccessToken();
+  }
+
+  Future<void> revokeRefreshToken() async {
+    await discordHttpClient.revokeRefreshToken();
+  }
+
+  Future<DiscordAuthorizationInformation>
+      getCurrentAuthorizationInformation() async {
+    final data = await discordHttpClient
+        .getCall([apiPath, versionPath, oauth2Path, '@me']);
+  }
+}

lib/src/exceptions/discord_api_exceptions.dart

@@ -0,0 +1,8 @@
+class DiscordApiException implements Exception {
+  final String message;
+
+  const DiscordApiException(this.message);
+
+  @override
+  String toString() => 'DiscordException: $message';
+}

lib/src/extensions/string_extensions.dart

@@ -0,0 +1,5 @@
+extension StringExtension on String {
+  String capitalize() {
+    return "${this[0].toUpperCase()}${substring(1).toLowerCase()}";
+  }
+}