from __future__ import annotations import unittest from backend.dto.common import ErrorCode from backend.route_registry import ROUTES from backend.routes.contract_routes import get_api_contract from backend.services.contract_service import ContractService from core.identity import RequestContext class ContractServiceTests(unittest.TestCase): def test_contract_exports_routes_permissions_and_error_codes(self): contract = ContractService().get_contract() self.assertEqual(contract["contract_version"], "3.0") self.assertTrue(contract["api_base"].endswith("astrbot_plugin_imagestudio")) self.assertEqual(len(contract["routes"]), len(ROUTES)) self.assertIn("VALIDATION_FAILED", contract["error_codes"]) self.assertEqual(set(contract["error_codes"]), {code.value for code in ErrorCode}) self.assertTrue(all("auth_required" in route for route in contract["routes"])) self.assertTrue(any(item["permission"] == "config" for item in contract["permissions"])) self.assertEqual(contract["response_shape"]["success"]["ok"], True) self.assertEqual(contract["response_shape"]["error"]["ok"], False) def test_contract_route_requires_authentication(self): ctx = RequestContext.from_astrbot(username="admin", user_id="user_001") response = get_api_contract(ctx, ContractService()) anonymous = get_api_contract(RequestContext(), ContractService()) self.assertTrue(response["ok"]) self.assertEqual(response["data"]["contract_version"], "3.0") self.assertFalse(anonymous["ok"]) self.assertEqual(anonymous["error_code"], "UNAUTHORIZED") if __name__ == "__main__": unittest.main()