DI a akcie

Fasáda je odporúčaná voľba, nie jediná cesta. Rovnaký kód spúšťajú tri vstupy: fasáda Authentication (najkratší zápis), manažér RoundlyConsulting\Auth\AuthenticationManager — koreň fasády, singleton v kontajneri — injektovaný cez konštruktor (rovnaké API, explicitná závislosť, žiadne statické volania) a akcie v RoundlyConsulting\Auth\Actions\* (jednoúčelové triedy s execute(), ktoré skladáte do vlastných akcií, jobov a príkazov).

Injektovanie manažéra

use RoundlyConsulting\Auth\AuthenticationManager;
use RoundlyConsulting\Auth\Enums\InvalidationReason;

final class ResetSupportPassword
{
    public function __construct(private AuthenticationManager $authentication) {}

    public function __invoke(User $user, string $password): void
    {
        $this->authentication->guard('users')->passwords()->set($user, $password, InvalidationReason::Security);
    }
}

Volanie akcie

Akcie určené pre hostiteľa prijímajú ako prvý argument názov guardu a účet, pozvánku či passkey iného guardu odmietnu skôr, než čokoľvek zapíšu:

use RoundlyConsulting\Auth\Actions\Account\LockAccount;
use RoundlyConsulting\Auth\Actions\Invitations\ResendInvitation;
use RoundlyConsulting\Auth\Actions\Passwords\SetPassword;
use RoundlyConsulting\Auth\Enums\InvalidationReason;

// The raw actions — the same code path; the guard name comes first.
app(SetPassword::class)->execute('users', $user, $temporaryPassword, InvalidationReason::Security);
app(LockAccount::class)->execute('users', $user, 3600);
app(ResendInvitation::class)->execute('users', $invitation);   // another guard's invitation → InvitationNotFound

Metóda fasády → akcia

• Fasáda, manažér aj controllery balíka si akcie berú z kontajnera, takže všetky tri spúšťajú rovnaký kód.
• Akcie označené @internal sú stavebné bloky týchto tokov, nie API: prihlasovací reťazec (CompleteFirstFactor, CompleteLogin, EnsureAccountCanLogin, ResolveRequiredSteps, StartLoginChallenge, AssessLoginRisk, DetectNewDevice, RecordLoginActivity), engine výziev (AdvanceChallenge, FinalizeChallenge, FindActiveChallenge, InvalidateChallenge, RecordChallengeFailure), štyri akcie OneTimeTokens, VerifyPassword, CreateAccount (nahradíte ho cez registration.creator), EnforceSessionLimit, BuildAccessTokenRequest a IssueTokenPair (tokeny vydávajte cez issueTokens(), ktoré spustí aj TokensIssued).
• Akcie prijímajú tie isté DTO ako fasáda, z RoundlyConsulting\Auth\DataTransferObjects — PasswordCredentials, SessionContext, CurrentToken, RegistrationData, InvitationData, AcceptInvitationData, ChallengeFactorData, ReauthenticationData, ChangePasswordData, PasswordResetData, EmailChangeData a LocaleData.