Massive refactor

- Use contextual namespaces within Flarum\Core
- Clean up and docblock everything
- Refactor Activity/Notification blueprint stuff
- Refactor Formatter stuff
- Refactor Search stuff
- Upgrade to JSON-API 1.0
- Removed “addedPosts” and “removedPosts” relationships from discussion
API. This was used for adding/removing event posts after renaming a
discussion etc. Instead we should make an additional request to get all
new posts

Todo:
- Fix Extenders and extensions
- Get rid of repository interfaces
- Fix other bugs I’ve inevitably introduced

src/Core/Users/Commands/ConfirmEmailHandler.php

@@ -0,0 +1,55 @@
+<?php namespace Flarum\Core\Users\Commands;
+
+use Flarum\Core\Users\UserRepositoryInterface;
+use Flarum\Core\Users\Events\UserWillBeSaved;
+use Flarum\Core\Support\DispatchesEvents;
+use Flarum\Core\Exceptions\InvalidConfirmationTokenException;
+use Flarum\Core\Users\EmailToken;
+
+class ConfirmEmailHandler
+{
+    use DispatchesEvents;
+
+    /**
+     * @var UserRepositoryInterface
+     */
+    protected $users;
+
+    /**
+     * @param UserRepositoryInterface $users
+     */
+    public function __construct(UserRepositoryInterface $users)
+    {
+        $this->users = $users;
+    }
+
+    /**
+     * @param ConfirmEmail $command
+     * @return \Flarum\Core\Users\User
+     * @throws InvalidConfirmationTokenException
+     */
+    public function handle(ConfirmEmail $command)
+    {
+        $token = EmailToken::find($command->token);
+
+        if (! $token) {
+            throw new InvalidConfirmationTokenException;
+        }
+
+        $user = $token->user;
+        $user->changeEmail($token->email);
+
+        if (! $user->is_activated) {
+            $user->activate();
+        }
+
+        event(new UserWillBeSaved($user, $command));
+
+        $user->save();
+        $this->dispatchEventsFor($user);
+
+        $token->delete();
+
+        return $user;
+    }
+}