test(api): 固化 Rust-Go RPC 契约

internal/api/testdata/contract/README.md

@@ -0,0 +1,15 @@
+# Rust contract fixtures
+
+本目录保存 Go `bat-api` 对 Rust `bat.sock` / snapshot JSON 的跨语言
+contract fixture。JSON 由 Rust 代码路径产出后归一化，只替换本机路径、版本号、
+时间戳和 release URL token，不改字段名、层级、null 语义或数字类型。
+
+覆盖范围：
+
+- `catalog.status` 可用与不可用响应。
+- `resource.manifest` 第一页分页响应。
+- 对应 release 的 `official-sync-snapshot.json`。
+- `launcher_metadata` 与 `game_main_config_bootstrap` 的 Go mirror 解码。
+
+这些 fixture 只用于 schema / mirror 回归，不代表真实资源版本，也不替代 live
+daemon socket 或完整发布切换验证。

internal/api/testdata/contract/catalog-status.available.json

@@ -0,0 +1,41 @@
+{
+  "addressables_catalog_marker_count": 0,
+  "addressables_root": "https://prod-clientpatch.bluearchiveyostar.com/{addressables-root}",
+  "app_version": "${APP_VERSION}",
+  "available": true,
+  "bundle_version": "${BUNDLE_VERSION}",
+  "connection_group_name": "${CONNECTION_GROUP}",
+  "distribution_status": "ready",
+  "distribution_status_code": "distribution.ready",
+  "endpoint_count": 0,
+  "endpoint_marker_count": 0,
+  "game_main_config_bootstrap": {
+    "default_connection_group": "${CONNECTION_GROUP}",
+    "server_info_data_url": "https://yostar-serverinfo.bluearchiveyostar.com/{server-info-path}"
+  },
+  "launcher_metadata": {
+    "game_latest_file_path": "${GAME_PACKAGE_PATH}",
+    "game_latest_version": "${APP_VERSION}",
+    "game_lowest_version": null,
+    "game_start_exe_name": "${GAME_START_EXE_NAME}",
+    "game_start_params": [
+      "${GAME_START_PARAM}"
+    ],
+    "launcher_version": "${LAUNCHER_VERSION}",
+    "manifest_file_count": 2,
+    "manifest_source": "${LAUNCHER_MANIFEST_SOURCE}",
+    "manifest_url": "https://launcher-pkg-ba-jp.yo-star.com/{launcher-manifest-path}"
+  },
+  "official_seed_hash_marker_count": 0,
+  "snapshot_version": 2,
+  "status": "published",
+  "status_code": "official.published",
+  "status_phase": "official_sync",
+  "status_retryable": false,
+  "status_terminal": true,
+  "version": {
+    "completed_unix_seconds": 1000,
+    "id": "${VERSION_ID}",
+    "resource_root": "${RESOURCE_ROOT}"
+  }
+}

internal/api/testdata/contract/catalog-status.unavailable.json

@@ -0,0 +1,10 @@
+{
+  "available": false,
+  "distribution_status": "blocked",
+  "distribution_status_code": "distribution.blocked",
+  "status": "unavailable",
+  "status_code": "official.unavailable",
+  "status_phase": "official_sync",
+  "status_retryable": false,
+  "status_terminal": true
+}

internal/api/testdata/contract/official-sync-snapshot.json

@@ -0,0 +1,26 @@
+{
+  "addressables_root": "https://prod-clientpatch.bluearchiveyostar.com/{addressables-root}",
+  "app_version": "${APP_VERSION}",
+  "bundle_version": "${BUNDLE_VERSION}",
+  "connection_group_name": "${CONNECTION_GROUP}",
+  "endpoint_markers": [],
+  "endpoints": [],
+  "game_main_config_bootstrap": {
+    "default_connection_group": "${CONNECTION_GROUP}",
+    "server_info_data_url": "https://yostar-serverinfo.bluearchiveyostar.com/{server-info-path}"
+  },
+  "launcher_metadata": {
+    "game_latest_file_path": "${GAME_PACKAGE_PATH}",
+    "game_latest_version": "${APP_VERSION}",
+    "game_lowest_version": null,
+    "game_start_exe_name": "${GAME_START_EXE_NAME}",
+    "game_start_params": [
+      "${GAME_START_PARAM}"
+    ],
+    "launcher_version": "${LAUNCHER_VERSION}",
+    "manifest_file_count": 2,
+    "manifest_source": "${LAUNCHER_MANIFEST_SOURCE}",
+    "manifest_url": "https://launcher-pkg-ba-jp.yo-star.com/{launcher-manifest-path}"
+  },
+  "snapshot_version": 2
+}

internal/api/testdata/contract/resource-manifest.page0.json

@@ -0,0 +1,22 @@
+{
+  "available": true,
+  "entries": [
+    {
+      "blake3": "0000000000000000000000000000000000000000000000000000000000000000",
+      "bytes": 21,
+      "destination": "prod-clientpatch.bluearchiveyostar.com/{addressables-root}/TableBundles/TableCatalog.bytes",
+      "url": "https://prod-clientpatch.bluearchiveyostar.com/{addressables-root}/TableBundles/TableCatalog.bytes"
+    },
+    {
+      "blake3": "0000000000000000000000000000000000000000000000000000000000000000",
+      "bytes": 10,
+      "destination": "prod-clientpatch.bluearchiveyostar.com/{addressables-root}/TableBundles/TableCatalog.hash",
+      "url": "https://prod-clientpatch.bluearchiveyostar.com/{addressables-root}/TableBundles/TableCatalog.hash"
+    }
+  ],
+  "limit": 2,
+  "manifest_version": 1,
+  "offset": 0,
+  "resource_root": "${RESOURCE_ROOT}",
+  "total_entries": 2
+}