api_webhook_download.php

<?php

declare(strict_types=1);

use imperazim\http\HttpRequest;
use imperazim\http\RetryPolicy;
use imperazim\http\client\HttpClient;
use imperazim\http\client\JsonHttpClient;
use imperazim\http\download\DownloadResult;
use imperazim\http\download\FileDownloader;
use imperazim\http\exception\JsonHttpException;
use imperazim\http\exception\StatusHttpException;
use imperazim\http\exception\TransportHttpException;
use imperazim\http\webhook\DiscordWebhookClient;
use imperazim\http\webhook\DiscordWebhookMessage;

/**
 * Example: call an external JSON API with retry handling.
 *
 * @return array<string, mixed>
 */
function fetchStatusPayload(string $apiUrl, HttpClient $http = new HttpClient()): array {
    try {
        return (new JsonHttpClient($http))->sendJson(
            HttpRequest::get($apiUrl)
                ->withTimeout(8.0)
                ->withConnectTimeout(3.0),
            RetryPolicy::networkDefaults()
        );
    } catch (TransportHttpException | StatusHttpException | JsonHttpException $error) {
        throw new RuntimeException('Status API request failed: ' . $error->getMessage(), previous: $error);
    }
}

/**
 * Example: send a Discord webhook notification without hand-writing JSON.
 */
function sendDeploymentNotice(string $webhookUrl, string $repository, string $commit): void {
    $message = DiscordWebhookMessage::create()
        ->withUsername('EasyLibrary')
        ->withContent('Deployment completed.')
        ->addEmbed([
            'title' => $repository,
            'description' => 'Commit `' . $commit . '` is now live.',
            'color' => 0x2ecc71,
        ]);

    (new DiscordWebhookClient())->send($webhookUrl, $message);
}

/**
 * Example: download a release asset atomically and verify its SHA-256 hash.
 */
function downloadVerifiedAsset(string $url, string $targetPath, string $sha256): DownloadResult {
    return (new FileDownloader())->download(
        HttpRequest::get($url)->withTimeout(30.0),
        $targetPath,
        maxBytes: 64 * 1024 * 1024,
        expectedSha256: $sha256
    );
}