fix(extension): 확장 수명주기 캐시 무효화 순서 회귀 및 실패 사유 전달

route:cache 는 새 앱을 부팅해 라우트를 수집하고, 그 부팅의 확장 라우트 프로바이더는
DB 가 아니라 캐시된 활성 확장 목록을 읽는다. 그래서 rebuild 가
invalidate*StatusCache 보다 앞서면 방금 바뀐 상태가 빠진 채 라우트가 박제되고,
라우트 캐시에는 스캔 폴백이 없어 오류도 로그도 없이 404 가 된다. 무효화를 굽기 직전이
아니라 DB 상태 쓰기 직후로 올려, 같은 목록을 읽는 훅 매핑 캐시까지 함께 바로잡았다.
update 경로는 Updating 전이 직후에 비우면 그 창의 오토로드 갱신이 확장을 비활성으로
판정하므로, 상태 복원 직후에 비운 뒤 훅 캐시를 다시 굽는다.

플러그인 라우트 프로바이더에는 활성 게이트가 없어 비활성 플러그인의 API 가 계속
응답했다. 화면·메뉴만 사라지고 기능은 살아 있는 상태였다. 모듈과 같은 기준을 적용했다.

실패 사유가 하위 계층에서 버려져 관리자 화면에 :error 자리표시자가 그대로 노출되던
문제도 고쳤다. 반환 경로를 깨지 않도록 배열 키 reason 과 뒤에 붙인 선택적 out
파라미터로 사유를 실어 올리고, 확장이 수명주기 훅에서 사유를 남길 수 있는 통로를
추가했다. 설치 경로의 광역 RuntimeException catch 는 도메인 예외로 좁혀 원본 키와
파라미터를 응답에 싣는다 — 상태코드 422 는 유지해 사용자 계약을 함께 바꾸지 않는다.
언어팩 화면은 프로덕션에서 예외 원문을 싣지 않는 것이 확정된 계약이므로, 자리를
일반 문구로 채우는 대신 치환 자리 자체를 제거했다. 원문은 종전대로 errors 통로를
거쳐 디버그 모드에서 도달한다.
This commit is contained in:
HeuJung
2026-08-21 17:09:30 +09:00
parent 565f6c0117
commit 03cbb99196
35 changed files with 1362 additions and 239 deletions
+10 -10
View File
@@ -2,25 +2,25 @@
return [
'fetch_success' => 'Language pack list retrieved.',
'fetch_failed' => 'Failed to load language pack list: :error',
'fetch_failed' => 'Failed to load language pack list.',
'not_found' => 'Language pack not found.',
'install_success' => 'Language pack installed.',
'install_failed' => 'Failed to install language pack: :error',
'install_failed' => 'Failed to install language pack.',
'activate_success' => 'Language pack activated.',
'activate_failed' => 'Failed to activate language pack: :error',
'activate_failed' => 'Failed to activate language pack.',
'deactivate_success' => 'Language pack deactivated.',
'deactivate_failed' => 'Failed to deactivate language pack: :error',
'deactivate_failed' => 'Failed to deactivate language pack.',
'uninstall_success' => 'Language pack removed.',
'uninstall_failed' => 'Failed to remove language pack: :error',
'uninstall_failed' => 'Failed to remove language pack.',
'manifest_invalid' => 'language-pack.json validation failed.',
'check_updates_success' => 'Update check completed.',
'check_updates_failed' => 'Failed to check updates: :error',
'check_updates_failed' => 'Failed to check updates.',
'update_success' => 'Language pack updated.',
'update_failed' => 'Failed to update language pack: :error',
'update_failed' => 'Failed to update language pack.',
'refresh_cache_success' => 'Language pack cache refreshed.',
'refresh_cache_failed' => 'Failed to refresh language pack cache: :error',
'refresh_cache_failed' => 'Failed to refresh language pack cache.',
'preview_success' => 'Manifest preview completed.',
'preview_failed' => 'Failed to preview manifest: :error',
'preview_failed' => 'Failed to preview manifest.',
'errors' => [
'manifest_not_found' => 'language-pack.json file not found in archive.',
@@ -36,7 +36,7 @@ return [
'target_version_too_old' => 'Target :scope (":target") version does not satisfy the required constraint (:constraint).',
'downgrade_blocked' => 'Downgrade blocked (:from → :to).',
'protected_pack' => 'Protected language packs cannot be deactivated or removed.',
'download_failed' => 'Failed to download from URL: :url',
'download_failed' => 'Failed to download the language pack from URL (:url): :error',
'download_url_not_public' => 'Language packs cannot be downloaded from internal network addresses (private IPs, localhost, etc.). Use a publicly reachable https address.',
'checksum_mismatch' => 'Checksum mismatch.',
'update_no_source' => 'No update source available (only GitHub-sourced packs can be updated).',
+9 -9
View File
@@ -2,25 +2,25 @@
return [
'fetch_success' => '언어팩 목록을 조회했습니다.',
'fetch_failed' => '언어팩 목록을 불러오지 못했습니다: :error',
'fetch_failed' => '언어팩 목록을 불러오지 못했습니다.',
'not_found' => '언어팩을 찾을 수 없습니다.',
'install_success' => '언어팩을 설치했습니다.',
'install_failed' => '언어팩 설치에 실패했습니다: :error',
'install_failed' => '언어팩 설치에 실패했습니다.',
'activate_success' => '언어팩을 활성화했습니다.',
'activate_failed' => '언어팩 활성화에 실패했습니다: :error',
'activate_failed' => '언어팩 활성화에 실패했습니다.',
'deactivate_success' => '언어팩을 비활성화했습니다.',
'deactivate_failed' => '언어팩 비활성화에 실패했습니다: :error',
'deactivate_failed' => '언어팩 비활성화에 실패했습니다.',
'uninstall_success' => '언어팩을 제거했습니다.',
'uninstall_failed' => '언어팩 제거에 실패했습니다: :error',
'uninstall_failed' => '언어팩 제거에 실패했습니다.',
'manifest_invalid' => 'language-pack.json 검증에 실패했습니다.',
'check_updates_success' => '업데이트 확인을 완료했습니다.',
'check_updates_failed' => '업데이트 확인에 실패했습니다: :error',
'check_updates_failed' => '업데이트 확인에 실패했습니다.',
'update_success' => '언어팩을 업데이트했습니다.',
'update_failed' => '언어팩 업데이트에 실패했습니다: :error',
'update_failed' => '언어팩 업데이트에 실패했습니다.',
'refresh_cache_success' => '언어팩 캐시를 갱신했습니다.',
'refresh_cache_failed' => '언어팩 캐시 갱신에 실패했습니다: :error',
'refresh_cache_failed' => '언어팩 캐시 갱신에 실패했습니다.',
'preview_success' => 'manifest 미리보기를 완료했습니다.',
'preview_failed' => 'manifest 미리보기에 실패했습니다: :error',
'preview_failed' => 'manifest 미리보기에 실패했습니다.',
'errors' => [
'manifest_not_found' => 'ZIP 안에서 language-pack.json 파일을 찾을 수 없습니다.',