Video 11

src/Domain/ADR/Payload.php

@@ -30,8 +30,8 @@
 final class Payload extends PhalconPayload
 {
     /**
-     * @param string             $status
-     * @param TPayloadDataInput  $data
+     * @param string            $status
+     * @param TPayloadDataInput $data
      * @param TPayloadDataInput $errors
      */
     private function __construct(
@@ -121,7 +121,7 @@ public static function unauthorized(array $errors): self
     {
         return new self(
             status: DomainStatus::UNAUTHORIZED,
-            errors:[
+            errors: [
                 'code'    => HttpCodesEnum::Unauthorized->value,
                 'message' => HttpCodesEnum::Unauthorized->text(),
                 'data'    => [],
@@ -140,7 +140,7 @@ public static function updated(array $data): self
         return new self(
             DomainStatus::UPDATED,
             [
-                'data' => $data
+                'data' => $data,
             ]
         );
     }
@@ -152,7 +152,7 @@ public static function updated(array $data): self
      *
      * @param TPayloadDataInput $existing
      * @param TPayloadDataInput $element
-     * @param string $key
+     * @param string            $key
      *
      * @return TPayloadDataInput
      */

src/Domain/Application/Auth/Command/AuthCommandFactory.php

@@ -0,0 +1,88 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Command;
+
+use Phalcon\Api\Domain\ADR\InputTypes;
+use Phalcon\Api\Domain\Infrastructure\DataSource\Auth\DTO\AuthInput;
+use Phalcon\Api\Domain\Infrastructure\DataSource\Interface\SanitizerInterface;
+
+/**
+ * @phpstan-import-type TAuthLoginInput from InputTypes
+ * @phpstan-import-type TAuthLogoutInput from InputTypes
+ * @phpstan-import-type TAuthRefreshInput from InputTypes
+ */
+final readonly class AuthCommandFactory implements AuthCommandFactoryInterface
+{
+    /**
+     * @param SanitizerInterface $sanitizer
+     */
+    public function __construct(
+        private SanitizerInterface $sanitizer,
+    ) {
+    }
+
+    /**
+     * @param TAuthLoginInput $input
+     *
+     * @return AuthLoginPostCommand
+     */
+    public function authenticate(array $input): AuthLoginPostCommand
+    {
+        /**
+         * Sanitize the input
+         */
+        $dto = AuthInput::new($this->sanitizer, $input);
+
+        /**
+         * Return the command back
+         */
+        return new AuthLoginPostCommand($dto->email, $dto->password);
+    }
+
+    /**
+     * @param TAuthLogoutInput $input
+     *
+     * @return AuthLogoutPostCommand
+     */
+    public function logout(array $input): AuthLogoutPostCommand
+    {
+        /**
+         * Sanitize the input
+         */
+        $dto = AuthInput::new($this->sanitizer, $input);
+
+        /**
+         * Return the command back
+         */
+        return new AuthLogoutPostCommand($dto->token);
+    }
+
+    /**
+     * @param TAuthRefreshInput $input
+     *
+     * @return AuthRefreshPostCommand
+     */
+    public function refresh(array $input): AuthRefreshPostCommand
+    {
+        /**
+         * Sanitize the input
+         */
+        $dto = AuthInput::new($this->sanitizer, $input);
+
+        /**
+         * Return the command back
+         */
+        return new AuthRefreshPostCommand($dto->token);
+    }
+}

src/Domain/Application/Auth/Command/AuthCommandFactoryInterface.php

@@ -0,0 +1,45 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Command;
+
+use Phalcon\Api\Domain\ADR\InputTypes;
+
+/**
+ * @phpstan-import-type TAuthLoginInput from InputTypes
+ * @phpstan-import-type TAuthLogoutInput from InputTypes
+ * @phpstan-import-type TAuthRefreshInput from InputTypes
+ */
+interface AuthCommandFactoryInterface
+{
+    /**
+     * @param TAuthLoginInput $input
+     *
+     * @return AuthLoginPostCommand
+     */
+    public function authenticate(array $input): AuthLoginPostCommand;
+
+    /**
+     * @param TAuthLogoutInput $input
+     *
+     * @return AuthLogoutPostCommand
+     */
+    public function logout(array $input): AuthLogoutPostCommand;
+
+    /**
+     * @param TAuthRefreshInput $input
+     *
+     * @return AuthRefreshPostCommand
+     */
+    public function refresh(array $input): AuthRefreshPostCommand;
+}

src/Domain/Application/Auth/Command/AuthLoginPostCommand.php

@@ -0,0 +1,29 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Command;
+
+use Phalcon\Api\Domain\Infrastructure\CommandBus\CommandInterface;
+
+final readonly class AuthLoginPostCommand implements CommandInterface
+{
+    /**
+     * @param string|null $email
+     * @param string|null $password
+     */
+    public function __construct(
+        public ?string $email,
+        public ?string $password,
+    ) {
+    }
+}

src/Domain/Application/Auth/Command/AuthLogoutPostCommand.php

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Command;
+
+use Phalcon\Api\Domain\Infrastructure\CommandBus\CommandInterface;
+
+final readonly class AuthLogoutPostCommand implements CommandInterface
+{
+    /**
+     * @param string|null $token
+     */
+    public function __construct(
+        public ?string $token
+    ) {
+    }
+}

src/Domain/Application/Auth/Command/AuthRefreshPostCommand.php

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Command;
+
+use Phalcon\Api\Domain\Infrastructure\CommandBus\CommandInterface;
+
+final readonly class AuthRefreshPostCommand implements CommandInterface
+{
+    /**
+     * @param string|null $token
+     */
+    public function __construct(
+        public ?string $token
+    ) {
+    }
+}

src/Domain/Application/Auth/Facade/AuthFacade.php

@@ -0,0 +1,72 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Facade;
+
+use Phalcon\Api\Domain\ADR\InputTypes;
+use Phalcon\Api\Domain\ADR\Payload;
+use Phalcon\Api\Domain\Application\Auth\Command\AuthCommandFactoryInterface;
+use Phalcon\Api\Domain\Infrastructure\CommandBus\CommandBusInterface;
+
+/**
+ * @phpstan-import-type TAuthLoginInput from InputTypes
+ * @phpstan-import-type TAuthLogoutInput from InputTypes
+ * @phpstan-import-type TAuthRefreshInput from InputTypes
+ */
+final readonly class AuthFacade
+{
+    /**
+     * @param CommandBusInterface $bus
+     */
+    public function __construct(
+        private CommandBusInterface $bus,
+        private AuthCommandFactoryInterface $factory
+    ) {
+    }
+
+    /**
+     * Authenticates users (login)
+     *
+     * @param TAuthLoginInput $input
+     *
+     * @return Payload
+     */
+    public function authenticate(array $input): Payload
+    {
+        return $this->bus->dispatch($this->factory->authenticate($input));
+    }
+
+    /**
+     * Logout: revoke refresh token after parsing/validation.
+     *
+     * @param TAuthLogoutInput $input
+     *
+     * @return Payload
+     */
+    public function logout(array $input): Payload
+    {
+        return $this->bus->dispatch($this->factory->logout($input));
+    }
+
+    /**
+     * Refresh: validate refresh token, issue new tokens via TokenManager.
+     *
+     * @param TAuthLogoutInput $input
+     *
+     * @return Payload
+     */
+    public function refresh(array $input): Payload
+    {
+        return $this->bus->dispatch($this->factory->refresh($input));
+    }
+}

src/Domain/Application/Auth/Handler/AbstractAuthLogoutRefreshHandler.php

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * This file is part of the Phalcon API.
+ *
+ * (c) Phalcon Team <team@phalcon.io>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Phalcon\Api\Domain\Application\Auth\Handler;
+
+use Phalcon\Api\Domain\ADR\InputTypes;
+use Phalcon\Api\Domain\Infrastructure\CommandBus\HandlerInterface;
+use Phalcon\Api\Domain\Infrastructure\DataSource\Validation\ValidatorInterface;
+use Phalcon\Api\Domain\Infrastructure\Encryption\TokenManagerInterface;
+
+/**
+ * @phpstan-import-type TAuthLogoutInput from InputTypes
+ */
+abstract class AbstractAuthLogoutRefreshHandler implements HandlerInterface
+{
+    /**
+     * @param TokenManagerInterface $tokenManager
+     * @param ValidatorInterface    $validator
+     */
+    public function __construct(
+        protected readonly TokenManagerInterface $tokenManager,
+        protected readonly ValidatorInterface $validator,
+    ) {
+    }
+}