<?php

declare(strict_types=1);

namespace App\Services\Social\Concerns;

use App\Models\PostPlatform;
use App\Services\Social\ContentSanitizer;
use App\Services\Social\TokenRedactor;
use Exception;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Support\Facades\Http;

trait HasSocialHttpClient
{
    /**
     * Measures the sanitized content — the exact string the publisher sends —
     * rather than the stored draft. The two differ by more than markup: X
     * defusing rewrites URLs, Telegram escapes entities, and every platform
     * strips HTML the editor stored. Checking the raw draft both rejected
     * posts that would have fit and let through posts the network rejects.
     */
    protected function validateContentLength(PostPlatform $postPlatform): void
    {
        $raw = $postPlatform->post->content ?? '';
        $content = app(ContentSanitizer::class)->displayText($raw, $postPlatform->platform);

        if ($postPlatform->platform->contentOverflow($content) === 0) {
            return;
        }

        $maxLength = $postPlatform->platform->maxContentLength();
        $contentLength = mb_strlen($content);

        throw new Exception(
            "Content exceeds {$postPlatform->platform->label()} limit of {$maxLength} characters ({$contentLength} provided)."
        );
    }

    protected function socialHttp(): PendingRequest
    {
        return Http::retry(
            times: 3,
            sleepMilliseconds: 5000,
            when: fn ($exception, $request) => ($exception->response ?? null)?->status() === 429,
            throw: false,
        )->timeout(120);
    }

    protected function redactResponseBody(string $body): string
    {
        return TokenRedactor::redact($body);
    }

    /**
     * Reclaim memory between chunks of a streaming upload. Each request's body
     * and the HTTP client's request/response objects are held alive by reference
     * cycles the PHP runtime only frees when the cycle collector runs, so a
     * long chunked upload accumulates the whole file in memory without this.
     * Callers must `unset()` the chunk and response first.
     */
    protected function freeChunkMemory(): void
    {
        gc_collect_cycles();
    }
}