✨ Adds Initializers for built-in providers and manager

Adds support for built-in OAuth providers like Github and Google.

This change introduces:
- A `BuiltInOAuthProvider` enum to manage supported providers.
- A dynamic initializer for creating `OAuth2Provider` instances based on the selected provider, using environment variables for configuration.
- An `OAuthManagerInitializer` for resolving OAuthManager dependencies.

This approach simplifies OAuth integration by providing pre-configured providers and ensuring that necessary environment variables are set correctly, throwing an exception if something is missing.

Author: gturpin-dev

packages/auth/src/OAuth/BuiltInOAuthProvider.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Auth\OAuth;
+
+use Tempest\Support\IsEnumHelper;
+
+enum BuiltInOAuthProvider: string
+{
+    use IsEnumHelper;
+
+    case GITHUB = 'github';
+    case GOOGLE = 'google';
+}

packages/auth/src/OAuth/Initializers/BuiltInOAuth2ProviderInitializer.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Auth\OAuth\Initializers;
+
+use Tempest\Auth\OAuth\BuiltInOAuthProvider;
+use Tempest\Auth\OAuth\Exceptions\OAuthException;
+use Tempest\Auth\OAuth\OAuth2Provider;
+use Tempest\Auth\OAuth\Providers\GithubOAuthProvider;
+use Tempest\Auth\OAuth\Providers\GoogleOAuthProvider;
+use Tempest\Container\Container;
+use Tempest\Container\DynamicInitializer;
+use Tempest\Reflection\ClassReflector;
+use TypeError;
+use UnitEnum;
+use function \Tempest\env;
+
+final class BuiltInOAuth2ProviderInitializer implements DynamicInitializer
+{
+    public function canInitialize(ClassReflector $class, UnitEnum|string|null $tag): bool
+    {
+        return ($class->implements(OAuth2Provider::class) || $class->is(OAuth2Provider::class)) && BuiltInOAuthProvider::hasValue((string) $tag);
+    }
+
+    public function initialize(ClassReflector $class, UnitEnum|string|null $tag, Container $container): OAuth2Provider
+    {
+        $tag = BuiltInOAuthProvider::from($tag);
+
+        try {
+            return match ($tag) {
+                BuiltInOAuthProvider::GOOGLE => new GoogleOAuthProvider(
+                    clientId: env('GOOGLE_CLIENT_ID'),
+                    clientSecret: env('GOOGLE_CLIENT_SECRET'),
+                    redirectUri: env('GOOGLE_REDIRECT_URI')
+                ),
+                BuiltInOAuthProvider::GITHUB => new GithubOAuthProvider(
+                    clientId: env('GITHUB_CLIENT_ID'),
+                    clientSecret: env('GITHUB_CLIENT_SECRET'),
+                    redirectUri: env('GITHUB_REDIRECT_URI')
+                ),
+                default => throw new OAuthException("Unable to match tag with built-in OAuth2 provider: \"{$tag->value}\""),
+            };
+        } catch (TypeError $exception) {
+            throw new OAuthException(
+                "Failed to initialize OAuth2 provider for tag: \"{$tag->value}\". Ensure that the environment variables are set correctly.",
+                previous: $exception
+            );
+        }
+    }
+}

packages/auth/src/OAuth/Initializers/OAuthManagerInitializer.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Auth\OAuth\Initializers;
+
+use Tempest\Auth\OAuth\OAuth2Provider;
+use Tempest\Auth\OAuth\OAuthManager;
+use Tempest\Container\Container;
+use Tempest\Container\DynamicInitializer;
+use Tempest\Http\Session\Session;
+use Tempest\HttpClient\HttpClient;
+use Tempest\Reflection\ClassReflector;
+use UnitEnum;
+
+final class OAuthManagerInitializer implements DynamicInitializer
+{
+    public function canInitialize(ClassReflector $class, UnitEnum|string|null $tag): bool
+    {
+        // We don't check against built-in providers here, as the OAuthManager should be able to work with non-built-in OAuth2Provider.
+        return $class->is(OAuthManager::class);
+    }
+
+    public function initialize(ClassReflector $class, UnitEnum|string|null $tag, Container $container): OAuthManager
+    {
+        return new OAuthManager(
+            provider: $container->get(OAuth2Provider::class, $tag),
+            httpClient: $container->get(HttpClient::class),
+            session: $container->get(Session::class)
+        );
+    }
+}