"""Offline contracts for the thin Italy final-submit adapter.""" import json import unittest from types import SimpleNamespace from unittest.mock import Mock from plugins import ita_plugin as final from plugins.ita_plugin import ( FINAL_ACCEPTED_LABEL, FINAL_FAILED_LABEL, FINAL_PATH, NATIVE_FINAL_SCRIPT, _final_packet_accepted, _submit_final_once, ) from test.ita.test_ita_calendar_book import FakePage, SERVICE, select from test.ita import test_ita_calendar_book_flow as flow def target(): """Small synthetic target retained for debug-tool fixtures.""" page = FakePage() approval = select(page) return SimpleNamespace( applicant="applicant@example.test", tab_id="applicant-tab", routing_key="slot.fixture.it.tourist", runtime_service=SERVICE, approval=approval, ) def final_packet(booking_target=None, *, error="", destination="/Reservation"): booking_target = booking_target or target() slot = booking_target.approval.candidate return SimpleNamespace( url="https://prenotami.esteri.it" + FINAL_PATH, method="POST", tab_id=booking_target.tab_id, is_failed=False, request=SimpleNamespace(postData={ "idCalendarioGiornaliero": slot.daily_calendar_id, "selectedDay": slot.day.isoformat(), "selectedHour": f"{slot.time_label}\n({slot.slots_free})", }), response=SimpleNamespace( status=200, url="https://prenotami.esteri.it" + FINAL_PATH, raw_body=json.dumps({"errorMessage": error, "url": destination}), ), ) class Listener: def __init__(self, page): self.page = page self.packet = None self.started = self.stopped = 0 def start(self, target_path, method): self.started += 1 if target_path != FINAL_PATH or method != "POST": raise AssertionError("unexpected listener contract") def wait(self, timeout): return self.packet def stop(self): self.stopped += 1 class NativePage(FakePage): def __init__(self, booking_target=None): super().__init__() booking_target = booking_target or target() self.tab_id = booking_target.tab_id self.active = True self.final_clicks = 0 self.final_packet = final_packet(booking_target) self.listen = Listener(self) def run_js(self, script, *args): if script == NATIVE_FINAL_SCRIPT: self.final_clicks += 1 self.listen.packet = self.final_packet return {"clicked": True} return super().run_js(script, *args) class PacketAcceptanceTests(unittest.TestCase): def setUp(self): self.target = target() self.packet = final_packet(self.target) def accepted(self): return _final_packet_accepted( self.packet, self.target.approval, self.target.tab_id) def test_exact_native_post_and_explicit_site_success_are_accepted(self): self.assertTrue(self.accepted()) self.packet.request.postData = ( "idCalendarioGiornaliero=80001001&" "selectedDay=2026-10-13&selectedHour=10%3A05+-+11%3A05%0A%281%29" ) self.assertTrue(self.accepted()) def test_site_error_is_an_ordinary_rejection(self): self.packet.response.raw_body = json.dumps( {"errorMessage": "slot unavailable", "url": "/BookingCalendar"}) self.assertFalse(self.accepted()) def test_request_identity_must_match_current_selection(self): mutations = ( ("url", "https://prenotami.esteri.it/Other"), ("method", "GET"), ("tab_id", "other-tab"), ("is_failed", True), ) for field, value in mutations: with self.subTest(field=field): packet = final_packet(self.target) setattr(packet, field, value) self.assertFalse(_final_packet_accepted( packet, self.target.approval, self.target.tab_id)) def test_body_requires_exact_unique_fields_and_current_runtime_id(self): bodies = ( {}, {"idCalendarioGiornaliero": "80001001", "selectedDay": "2026-10-13"}, {"idCalendarioGiornaliero": "wrong", "selectedDay": "2026-10-13", "selectedHour": "10:05 - 11:05\n(1)"}, "idCalendarioGiornaliero=80001001&idCalendarioGiornaliero=80001001&" "selectedDay=2026-10-13&selectedHour=10%3A05+-+11%3A05%0A%281%29", ) for body in bodies: with self.subTest(body=body): packet = final_packet(self.target) packet.request.postData = body self.assertFalse(_final_packet_accepted( packet, self.target.approval, self.target.tab_id)) def test_response_must_be_bounded_same_origin_explicit_json_success(self): values = ( (500, '{"errorMessage":"","url":"/Reservation"}'), (200, "not-json"), (200, '{"url":"/Reservation"}'), (200, '{"errorMessage":null,"url":"/Reservation"}'), (200, '{"errorMessage":"","url":"https://attacker.test"}'), ) for status, raw in values: with self.subTest(status=status, raw=raw): packet = final_packet(self.target) packet.response.status = status packet.response.raw_body = raw self.assertFalse(_final_packet_accepted( packet, self.target.approval, self.target.tab_id)) class SubmitOnceTests(unittest.TestCase): def setUp(self): bootstrap = target() self.page = NativePage(bootstrap) self.plugin, self.route, _ = flow.prepared_plugin( self.page, routing_key=bootstrap.routing_key) self.plugin._log = Mock() self.approval = bootstrap.approval def test_success_uses_one_native_click_and_standard_result(self): result = _submit_final_once(self.plugin, self.route, self.approval) self.assertTrue(result.success) self.assertEqual(result.label, FINAL_ACCEPTED_LABEL) self.assertEqual(result.account, "applicant@example.test") self.assertEqual(result.book_date, "2026-10-13") self.assertEqual(result.book_time, "10:05 - 11:05") self.assertEqual(self.page.final_clicks, 1) self.assertEqual((self.page.listen.started, self.page.listen.stopped), (1, 1)) self.assertIsNotNone(self.plugin._prepared_calendar) def test_site_rejection_returns_false_and_discards_attempt_context(self): self.page.final_packet.response.raw_body = json.dumps( {"errorMessage": "slot unavailable", "url": "/BookingCalendar"}) result = _submit_final_once(self.plugin, self.route, self.approval) self.assertFalse(result.success) self.assertEqual(result.label, FINAL_FAILED_LABEL) self.assertEqual(self.page.final_clicks, 1) self.assertIsNone(self.plugin._prepared_calendar) def test_timeout_or_mismatched_packet_is_false_not_unknown_pause(self): for mode in ("timeout", "wrong-day"): with self.subTest(mode=mode): self.setUp() if mode == "timeout": self.page.final_packet = None else: self.page.final_packet.request.postData["selectedDay"] = "2026-10-14" result = _submit_final_once(self.plugin, self.route, self.approval) self.assertFalse(result.success) self.assertEqual(self.page.final_clicks, 1) self.assertIsNone(self.plugin._prepared_calendar) def test_changed_applicant_or_selection_never_clicks(self): self.plugin.config.account.username = "other@example.test" result = _submit_final_once(self.plugin, self.route, self.approval) self.assertFalse(result.success) self.assertEqual(self.page.final_clicks, 0) self.assertIsNone(self.plugin._prepared_calendar) def test_second_call_without_fresh_preparation_never_clicks_again(self): self.page.final_packet = None self.assertFalse(_submit_final_once(self.plugin, self.route, self.approval).success) self.assertFalse(_submit_final_once(self.plugin, self.route, self.approval).success) self.assertEqual(self.page.final_clicks, 1) class SourceContractTests(unittest.TestCase): def test_old_unknown_and_receipt_state_machine_is_not_in_runtime(self): for name in ( "FinalOutcomeUnknown", "FinalBookingAttempt", "NativeFinalSubmitter", "SubmissionSignal", "ReservationSnapshot", "ReservationState", ): self.assertFalse(hasattr(final, name), name) def test_query_and_selection_do_not_call_final_adapter(self): self.assertNotIn("coordinate:ita-native-final-once", final.CALENDAR_GUARD_SCRIPT) self.assertIn("coordinate:ita-native-final-once", NATIVE_FINAL_SCRIPT) if __name__ == "__main__": unittest.main()