<?php

namespace Tests\Unit\Extension;

use PHPUnit\Framework\Attributes\Test;
use Tests\TestCase;

/**
 * 템플릿 업데이트 성공 cleanup 의 config 캐시 무효화 구조 테스트 (#588, 공개 #119)
 *
 * `template.config.{identifier}` 는 버전 접미사 없는 고정 키라 캐시 버전 bump 로
 * 무효화되지 않는다. updateTemplate() 성공 cleanup 이 clearTemplateCache() 를
 * 직접 호출하지 않으면, 비활성 업데이트·레이아웃 무변경 업데이트 경로에서 공개
 * config.json 이 TTL(1시간) 동안 이전 manifest 를 계속 서빙한다.
 *
 * 실제 updateTemplate() 통합 실행은 업데이트 소스(_pending/신버전) 픽스처가 필요해
 * 비용이 크므로, clearTemplateCache() 의 키 삭제는 TemplateCacheManagementTest 가
 * 동작으로 검증하고 본 테스트는 호출 존재를 소스 구조로 고정한다
 * (선례: ExtensionUpdateStatusCacheSymmetryTest).
 */
class TemplateUpdateConfigCacheInvalidationTest extends TestCase
{
    /**
     * @scenario cache_state=warm_current,lifecycle_trigger=template_update,template_type=user
     *
     * @effects template_update_invalidates_public_config_cache
     */
    #[Test]
    public function update_template_cleanup_calls_clear_template_cache(): void
    {
        $body = $this->methodSource(
            base_path('app/Extension/TemplateManager.php'),
            'updateTemplate'
        );

        $this->assertStringContainsString(
            '$this->clearTemplateCache(',
            $body,
            'updateTemplate() 성공 cleanup 이 clearTemplateCache() 를 호출해야 합니다 — '
            .'누락 시 공개 config.json 이 캐시 TTL 동안 이전 manifest 로 응답됩니다.'
        );
    }

    /**
     * 대상 메서드 본문을 주석 제거 후 반환합니다.
     *
     * 주석을 남겨 두면 설명 문장에 들어 있는 호출 표기가 검사를 통과시킨다.
     *
     * @param  string  $path  대상 파일 절대 경로
     * @param  string  $method  대상 메서드명
     * @return string 주석이 제거된 메서드 본문
     */
    private function methodSource(string $path, string $method): string
    {
        $this->assertFileExists($path);

        $stripped = '';
        foreach (token_get_all(file_get_contents($path)) as $token) {
            if (is_array($token) && in_array($token[0], [T_COMMENT, T_DOC_COMMENT], true)) {
                continue;
            }
            $stripped .= is_array($token) ? $token[1] : $token;
        }

        $start = strpos($stripped, "public function {$method}(");
        $this->assertNotFalse($start, "{$path} 에서 {$method}() 메서드를 찾지 못했습니다.");

        // 중괄호 균형으로 메서드 본문 끝을 찾는다
        $open = strpos($stripped, '{', $start);
        $depth = 0;
        $length = strlen($stripped);

        for ($i = $open; $i < $length; $i++) {
            if ($stripped[$i] === '{') {
                $depth++;
            } elseif ($stripped[$i] === '}') {
                $depth--;
                if ($depth === 0) {
                    return substr($stripped, $open, $i - $open + 1);
                }
            }
        }

        $this->fail("{$path} 의 {$method}() 본문 끝을 찾지 못했습니다.");
    }
}