- Add single-line class docblocks to all 59 repository classes and interfaces describing scope and responsibility - Add multi-line docblocks to key services documenting business rules: AuthService (6-step login cascade), ImportService (3-phase CSV workflow), TenantScopeService (strict/permissive modes), PermissionService (RBAC resolution + two-tier caching), UserAccountService (atomicity + audit) - Add transaction(callable) wrapper to DatabaseSessionRepository to DRY up begin/commit/rollback boilerplate Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
57 lines
2.0 KiB
PHP
57 lines
2.0 KiB
PHP
<?php
|
|
|
|
namespace MintyPHP\Repository\User;
|
|
|
|
use MintyPHP\DB;
|
|
|
|
/** Links and looks up external identity provider accounts (Entra ID / OIDC) for users. */
|
|
class UserExternalIdentityRepository implements UserExternalIdentityRepositoryInterface
|
|
{
|
|
private function unwrap($row): ?array
|
|
{
|
|
if (!$row || !is_array($row)) {
|
|
return null;
|
|
}
|
|
if (isset($row['user_external_identities']) && is_array($row['user_external_identities'])) {
|
|
return $row['user_external_identities'];
|
|
}
|
|
return $row;
|
|
}
|
|
|
|
public function findByProviderTidOid(string $provider, string $tid, string $oid): ?array
|
|
{
|
|
$row = DB::selectOne(
|
|
'select id, user_id, provider, oid, tid, issuer, subject, email_at_link_time, created from user_external_identities where provider = ? and tid = ? and oid = ? limit 1',
|
|
$provider,
|
|
$tid,
|
|
$oid
|
|
);
|
|
return $this->unwrap($row);
|
|
}
|
|
|
|
public function findByProviderIssuerSubject(string $provider, string $issuer, string $subject): ?array
|
|
{
|
|
$row = DB::selectOne(
|
|
'select id, user_id, provider, oid, tid, issuer, subject, email_at_link_time, created from user_external_identities where provider = ? and issuer = ? and subject = ? limit 1',
|
|
$provider,
|
|
$issuer,
|
|
$subject
|
|
);
|
|
return $this->unwrap($row);
|
|
}
|
|
|
|
public function createLink(array $data): mixed
|
|
{
|
|
return DB::insert(
|
|
'insert into user_external_identities (user_id, provider, oid, tid, issuer, subject, email_at_link_time, created) values (?,?,?,?,?,?,?,NOW())',
|
|
(string) ((int) ($data['user_id'] ?? 0)),
|
|
(string) ($data['provider'] ?? ''),
|
|
(string) ($data['oid'] ?? ''),
|
|
(string) ($data['tid'] ?? ''),
|
|
(string) ($data['issuer'] ?? ''),
|
|
(string) ($data['subject'] ?? ''),
|
|
$data['email_at_link_time'] ?? null
|
|
);
|
|
}
|
|
}
|