name] = clone $this; return true; } } } namespace App\Services { final class Config { public static string $superAdministrators = '1'; public static function get(string $key, mixed $default = null): mixed { return $key === 'super_admin' ? self::$superAdministrators : $default; } } final class TicketTelegramConfig { public const BINDING = 'ticket_telegram_binding'; public static bool $enabled = true; public static bool $failRuntime = false; public static string $token = '123456789:' . 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'; public static function runtime(bool $requireEnabled = true): array { if ($requireEnabled && !self::$enabled) { throw new \RuntimeException('disabled'); } return ['bot_token' => self::$token]; } public static function runtimeForDelivery(): ?array { if (self::$failRuntime) { throw new \RuntimeException('synthetic configuration database failure'); } return self::$enabled ? ['bot_token' => self::$token] : null; } } } namespace { use App\Models\Configurations; use App\Models\User; use App\Services\TicketTelegramConfig; use App\Services\Telegram\AdministratorTelegramChannel; use App\Services\Telegram\AdministratorTelegramLocalUnavailable; use App\Services\Telegram\AdministratorTelegramPreflightException; use App\Services\Telegram\AdministratorTelegramRateLimiter; use App\Services\Telegram\AdministratorTelegramRemoteEffectUnknown; use App\Services\Telegram\AdministratorTelegramTransport; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramDestination.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramDeliveryChannel.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramTransport.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramPreflightException.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramLocalUnavailable.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramRemoteEffectUnknown.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramRateBacklog.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramRateLimiter.php'; require dirname(__DIR__) . '/app/Services/Telegram/DatabaseAdministratorTelegramRateGate.php'; final class AdministratorTelegramChannelFakeRateLimiter implements AdministratorTelegramRateLimiter { public int $calls = 0; public mixed $hook = null; public function acquire( \App\Services\Telegram\AdministratorTelegramDestination $destination ): void { $this->calls++; if (is_callable($this->hook)) { ($this->hook)(); } } } final class AdministratorTelegramChannelConnection { public function transaction(callable $callback): mixed { Configurations::$transactions++; try { return $callback(); } finally { Configurations::$transactions--; } } } final class AdministratorTelegramChannelQuery { public function __construct(private readonly string $name) {} public function lockForUpdate(): self { if (Configurations::$transactions !== 1) { throw new RuntimeException('lock outside transaction'); } Configurations::$locks++; return $this; } public function first(): ?Configurations { if (Configurations::$failReads) { throw new RuntimeException('synthetic binding database failure'); } $row = Configurations::$rows[$this->name] ?? null; return $row === null ? null : clone $row; } } final class AdministratorTelegramChannelFakeTransport implements AdministratorTelegramTransport { public array $calls = []; public bool $fail = false; public function sendMessage( string $botToken, string $chatId, string $text, array $options = [] ): int { $this->calls[] = compact('botToken', 'chatId', 'text', 'options'); if ($this->fail) { throw new AdministratorTelegramRemoteEffectUnknown( 'synthetic transport failure' ); } return 9001; } } require dirname(__DIR__) . '/app/Services/Telegram/TelegramBotApiTransport.php'; require dirname(__DIR__) . '/app/Services/Telegram/AdministratorTelegramChannel.php'; $assert = static function (bool $condition, string $message): void { if (!$condition) { fwrite(STDERR, $message . PHP_EOL); exit(1); } }; $expectFailure = static function (callable $callback, string $message) use ($assert): void { try { $callback(); } catch (Throwable $exception) { return; } $assert(false, $message); }; $setBinding = static function (array $state): void { Configurations::$rows[TicketTelegramConfig::BINDING] = new Configurations( TicketTelegramConfig::BINDING, json_encode($state, JSON_THROW_ON_ERROR) ); }; User::$rows[1] = new User(1); $transport = new AdministratorTelegramChannelFakeTransport(); $rateLimiter = new AdministratorTelegramChannelFakeRateLimiter(); $channel = new AdministratorTelegramChannel($transport, $rateLimiter); $setBinding(['bound_admin_id' => 1, 'chat_id' => '123456']); $destination = $channel->currentDestination(); $assert($destination !== null && $destination->administratorId === 1 && $destination->chatId === '123456' && preg_match('/^[a-f0-9]{32}$/D', $destination->bindingGeneration) === 1 && Configurations::$locks === 1 && Configurations::$transactions === 0, 'Legacy binding was not upgraded atomically with a valid generation.'); $messageId = $channel->send($destination, 'Test alert', [ 'disable_web_page_preview' => 'true', ]); $assert($messageId === 9001 && count($transport->calls) === 1 && $rateLimiter->calls === 1 && $transport->calls[0]['chatId'] === '123456' && $transport->calls[0]['botToken'] === TicketTelegramConfig::$token, 'Authoritative destination was not sent exactly once.'); $rateLimiter->hook = static function () use ($setBinding): void { $setBinding([ 'bound_admin_id' => 1, 'chat_id' => '654321', 'binding_generation' => bin2hex(random_bytes(16)), ]); }; $postWaitFailure = null; try { $channel->send($destination, 'Rebound while waiting'); } catch (Throwable $exception) { $postWaitFailure = $exception; } $assert($postWaitFailure instanceof AdministratorTelegramPreflightException && $postWaitFailure->reason === AdministratorTelegramPreflightException::DESTINATION_CHANGED && count($transport->calls) === 1, 'Post-gate rebind reached the stale Telegram destination.'); $rateLimiter->hook = null; $setBinding([ 'bound_admin_id' => 1, 'chat_id' => '123456', 'binding_generation' => $destination->bindingGeneration, ]); $rateLimiter->hook = static function (): void { TicketTelegramConfig::$enabled = false; }; $postWaitFailure = null; try { $channel->send($destination, 'Disabled while waiting'); } catch (Throwable $exception) { $postWaitFailure = $exception; } $assert($postWaitFailure instanceof AdministratorTelegramPreflightException && $postWaitFailure->reason === AdministratorTelegramPreflightException::CHANNEL_UNAVAILABLE && count($transport->calls) === 1, 'Post-gate disable reached Telegram.'); TicketTelegramConfig::$enabled = true; $rateLimiter->hook = null; $expectFailure( fn () => $channel->send($destination, 'Unsafe', ['parse_mode' => 'HTML']), 'Unknown Telegram option was accepted.' ); $assert(count($transport->calls) === 1, 'Rejected Telegram options reached the network transport.'); $setBinding([ 'bound_admin_id' => 1, 'chat_id' => '654321', 'binding_generation' => bin2hex(random_bytes(16)), ]); $expectFailure( fn () => $channel->send($destination, 'Stale destination'), 'A stale binding generation was sent after rebind.' ); $assert(count($transport->calls) === 1, 'A stale destination reached the Telegram transport.'); $setBinding([ 'bound_admin_id' => 1, 'chat_id' => '123456', 'binding_generation' => $destination->bindingGeneration, ]); TicketTelegramConfig::$enabled = false; $assert($channel->currentDestination() === null, 'Disabled Telegram configuration still exposed a destination.'); $assert($channel->boundDestination()?->equals($destination) === true, 'Disabling outbound Telegram hid the retained administrator binding.'); $expectFailure( fn () => $channel->send($destination, 'Disabled channel'), 'Disabled Telegram configuration still sent a message.' ); TicketTelegramConfig::$enabled = true; $assert(count($transport->calls) === 1, 'Disabled Telegram configuration reached the transport.'); TicketTelegramConfig::$failRuntime = true; $localFailure = null; try { $channel->currentDestination(); } catch (Throwable $exception) { $localFailure = $exception; } $assert($localFailure instanceof AdministratorTelegramLocalUnavailable, 'Configuration infrastructure failure was collapsed into disabled.'); try { $channel->send($destination, 'Local configuration failure'); } catch (Throwable $exception) { $localFailure = $exception; } $assert($localFailure instanceof AdministratorTelegramLocalUnavailable && count($transport->calls) === 1, 'Local configuration failure reached transport or became remote unknown.'); TicketTelegramConfig::$failRuntime = false; Configurations::$failReads = true; try { $channel->send($destination, 'Local binding failure'); } catch (Throwable $exception) { $localFailure = $exception; } $assert($localFailure instanceof AdministratorTelegramLocalUnavailable && count($transport->calls) === 1, 'Binding read failure reached transport or became remote unknown.'); Configurations::$failReads = false; $transport->fail = true; $remoteFailure = null; try { $channel->send($destination, 'Unknown-effect send'); } catch (Throwable $exception) { $remoteFailure = $exception; } $assert($remoteFailure instanceof AdministratorTelegramRemoteEffectUnknown, 'Transport failure was not classified as remote-effect unknown.'); $assert(count($transport->calls) === 2, 'A transport failure was internally retried.'); $transport->fail = false; $setBinding([ 'bound_admin_id' => 1, 'chat_id' => '654321', 'binding_generation' => bin2hex(random_bytes(16)), ]); $preflightFailure = null; try { $channel->send($destination, 'Known preflight failure'); } catch (Throwable $exception) { $preflightFailure = $exception; } $assert($preflightFailure instanceof AdministratorTelegramPreflightException && count($transport->calls) === 2, 'Destination change was not classified before the remote request.'); User::$rows[1]->enable = 0; $assert($channel->currentDestination() === null, 'Disabled administrator remained an eligible destination.'); User::$rows[1]->enable = 1; \App\Services\Config::$superAdministrators = '2'; $assert($channel->currentDestination() === null, 'Removed super administrator remained an eligible destination.'); echo "Administrator Telegram channel tests passed.\n"; }