test_ita_booking_final.py 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
  1. """Offline contracts for the thin Italy final-submit adapter."""
  2. import json
  3. import unittest
  4. from types import SimpleNamespace
  5. from unittest.mock import Mock
  6. from plugins import ita_plugin as final
  7. from plugins.ita_plugin import (
  8. FINAL_ACCEPTED_LABEL,
  9. FINAL_FAILED_LABEL,
  10. FINAL_PATH,
  11. NATIVE_FINAL_SCRIPT,
  12. _final_packet_accepted,
  13. _submit_final_once,
  14. )
  15. from test.ita.test_ita_calendar_book import FakePage, SERVICE, select
  16. from test.ita import test_ita_calendar_book_flow as flow
  17. def target():
  18. """Small synthetic target retained for debug-tool fixtures."""
  19. page = FakePage()
  20. approval = select(page)
  21. return SimpleNamespace(
  22. applicant="applicant@example.test",
  23. tab_id="applicant-tab",
  24. routing_key="slot.fixture.it.tourist",
  25. runtime_service=SERVICE,
  26. approval=approval,
  27. )
  28. def final_packet(booking_target=None, *, error="", destination="/Reservation"):
  29. booking_target = booking_target or target()
  30. slot = booking_target.approval.candidate
  31. return SimpleNamespace(
  32. url="https://prenotami.esteri.it" + FINAL_PATH,
  33. method="POST",
  34. tab_id=booking_target.tab_id,
  35. is_failed=False,
  36. request=SimpleNamespace(postData={
  37. "idCalendarioGiornaliero": slot.daily_calendar_id,
  38. "selectedDay": slot.day.isoformat(),
  39. "selectedHour": f"{slot.time_label}\n({slot.slots_free})",
  40. }),
  41. response=SimpleNamespace(
  42. status=200,
  43. url="https://prenotami.esteri.it" + FINAL_PATH,
  44. raw_body=json.dumps({"errorMessage": error, "url": destination}),
  45. ),
  46. )
  47. class Listener:
  48. def __init__(self, page):
  49. self.page = page
  50. self.packet = None
  51. self.started = self.stopped = 0
  52. def start(self, target_path, method):
  53. self.started += 1
  54. if target_path != FINAL_PATH or method != "POST":
  55. raise AssertionError("unexpected listener contract")
  56. def wait(self, timeout):
  57. return self.packet
  58. def stop(self):
  59. self.stopped += 1
  60. class NativePage(FakePage):
  61. def __init__(self, booking_target=None):
  62. super().__init__()
  63. booking_target = booking_target or target()
  64. self.tab_id = booking_target.tab_id
  65. self.active = True
  66. self.final_clicks = 0
  67. self.final_packet = final_packet(booking_target)
  68. self.listen = Listener(self)
  69. def run_js(self, script, *args):
  70. if script == NATIVE_FINAL_SCRIPT:
  71. self.final_clicks += 1
  72. self.listen.packet = self.final_packet
  73. return {"clicked": True}
  74. return super().run_js(script, *args)
  75. class PacketAcceptanceTests(unittest.TestCase):
  76. def setUp(self):
  77. self.target = target()
  78. self.packet = final_packet(self.target)
  79. def accepted(self):
  80. return _final_packet_accepted(
  81. self.packet, self.target.approval, self.target.tab_id)
  82. def test_exact_native_post_and_explicit_site_success_are_accepted(self):
  83. self.assertTrue(self.accepted())
  84. self.packet.request.postData = (
  85. "idCalendarioGiornaliero=80001001&"
  86. "selectedDay=2026-10-13&selectedHour=10%3A05+-+11%3A05%0A%281%29"
  87. )
  88. self.assertTrue(self.accepted())
  89. def test_site_error_is_an_ordinary_rejection(self):
  90. self.packet.response.raw_body = json.dumps(
  91. {"errorMessage": "slot unavailable", "url": "/BookingCalendar"})
  92. self.assertFalse(self.accepted())
  93. def test_request_identity_must_match_current_selection(self):
  94. mutations = (
  95. ("url", "https://prenotami.esteri.it/Other"),
  96. ("method", "GET"),
  97. ("tab_id", "other-tab"),
  98. ("is_failed", True),
  99. )
  100. for field, value in mutations:
  101. with self.subTest(field=field):
  102. packet = final_packet(self.target)
  103. setattr(packet, field, value)
  104. self.assertFalse(_final_packet_accepted(
  105. packet, self.target.approval, self.target.tab_id))
  106. def test_body_requires_exact_unique_fields_and_current_runtime_id(self):
  107. bodies = (
  108. {},
  109. {"idCalendarioGiornaliero": "80001001", "selectedDay": "2026-10-13"},
  110. {"idCalendarioGiornaliero": "wrong", "selectedDay": "2026-10-13",
  111. "selectedHour": "10:05 - 11:05\n(1)"},
  112. "idCalendarioGiornaliero=80001001&idCalendarioGiornaliero=80001001&"
  113. "selectedDay=2026-10-13&selectedHour=10%3A05+-+11%3A05%0A%281%29",
  114. )
  115. for body in bodies:
  116. with self.subTest(body=body):
  117. packet = final_packet(self.target)
  118. packet.request.postData = body
  119. self.assertFalse(_final_packet_accepted(
  120. packet, self.target.approval, self.target.tab_id))
  121. def test_response_must_be_bounded_same_origin_explicit_json_success(self):
  122. values = (
  123. (500, '{"errorMessage":"","url":"/Reservation"}'),
  124. (200, "not-json"),
  125. (200, '{"url":"/Reservation"}'),
  126. (200, '{"errorMessage":null,"url":"/Reservation"}'),
  127. (200, '{"errorMessage":"","url":"https://attacker.test"}'),
  128. )
  129. for status, raw in values:
  130. with self.subTest(status=status, raw=raw):
  131. packet = final_packet(self.target)
  132. packet.response.status = status
  133. packet.response.raw_body = raw
  134. self.assertFalse(_final_packet_accepted(
  135. packet, self.target.approval, self.target.tab_id))
  136. class SubmitOnceTests(unittest.TestCase):
  137. def setUp(self):
  138. bootstrap = target()
  139. self.page = NativePage(bootstrap)
  140. self.plugin, self.route, _ = flow.prepared_plugin(
  141. self.page, routing_key=bootstrap.routing_key)
  142. self.plugin._log = Mock()
  143. self.approval = bootstrap.approval
  144. def test_success_uses_one_native_click_and_standard_result(self):
  145. result = _submit_final_once(self.plugin, self.route, self.approval)
  146. self.assertTrue(result.success)
  147. self.assertEqual(result.label, FINAL_ACCEPTED_LABEL)
  148. self.assertEqual(result.account, "applicant@example.test")
  149. self.assertEqual(result.book_date, "2026-10-13")
  150. self.assertEqual(result.book_time, "10:05 - 11:05")
  151. self.assertEqual(self.page.final_clicks, 1)
  152. self.assertEqual((self.page.listen.started, self.page.listen.stopped), (1, 1))
  153. self.assertIsNotNone(self.plugin._prepared_calendar)
  154. def test_site_rejection_returns_false_and_discards_attempt_context(self):
  155. self.page.final_packet.response.raw_body = json.dumps(
  156. {"errorMessage": "slot unavailable", "url": "/BookingCalendar"})
  157. result = _submit_final_once(self.plugin, self.route, self.approval)
  158. self.assertFalse(result.success)
  159. self.assertEqual(result.label, FINAL_FAILED_LABEL)
  160. self.assertEqual(self.page.final_clicks, 1)
  161. self.assertIsNone(self.plugin._prepared_calendar)
  162. def test_timeout_or_mismatched_packet_is_false_not_unknown_pause(self):
  163. for mode in ("timeout", "wrong-day"):
  164. with self.subTest(mode=mode):
  165. self.setUp()
  166. if mode == "timeout":
  167. self.page.final_packet = None
  168. else:
  169. self.page.final_packet.request.postData["selectedDay"] = "2026-10-14"
  170. result = _submit_final_once(self.plugin, self.route, self.approval)
  171. self.assertFalse(result.success)
  172. self.assertEqual(self.page.final_clicks, 1)
  173. self.assertIsNone(self.plugin._prepared_calendar)
  174. def test_changed_applicant_or_selection_never_clicks(self):
  175. self.plugin.config.account.username = "other@example.test"
  176. result = _submit_final_once(self.plugin, self.route, self.approval)
  177. self.assertFalse(result.success)
  178. self.assertEqual(self.page.final_clicks, 0)
  179. self.assertIsNone(self.plugin._prepared_calendar)
  180. def test_second_call_without_fresh_preparation_never_clicks_again(self):
  181. self.page.final_packet = None
  182. self.assertFalse(_submit_final_once(self.plugin, self.route, self.approval).success)
  183. self.assertFalse(_submit_final_once(self.plugin, self.route, self.approval).success)
  184. self.assertEqual(self.page.final_clicks, 1)
  185. class SourceContractTests(unittest.TestCase):
  186. def test_old_unknown_and_receipt_state_machine_is_not_in_runtime(self):
  187. for name in (
  188. "FinalOutcomeUnknown", "FinalBookingAttempt", "NativeFinalSubmitter",
  189. "SubmissionSignal", "ReservationSnapshot", "ReservationState",
  190. ):
  191. self.assertFalse(hasattr(final, name), name)
  192. def test_query_and_selection_do_not_call_final_adapter(self):
  193. self.assertNotIn("coordinate:ita-native-final-once", final.CALENDAR_GUARD_SCRIPT)
  194. self.assertIn("coordinate:ita-native-final-once", NATIVE_FINAL_SCRIPT)
  195. if __name__ == "__main__":
  196. unittest.main()