aeat.adapters.outbound.aeat.browser package

Central browser-automation surface for AEAT outbound adapters.

Owns the Playwright-backed browser sessions every outbound AEAT adapter shares, plus the site-health probing that classifies whether the Sede is reachable, rate-limiting, under maintenance, or serving a WAF challenge. The optional browser runtime is materialised only by the session factories; importing this facade exposes types and factories without opening a browser. Non-OK site-health classifications are carried through core.errors.SiteHealthError so diagnostics and live-read application code can inspect one status envelope instead of re-parsing pages.

Major declarations:

• BrowserSession and DefaultBrowserSession, with create_browser_session() and default_browser_session_factory() — the session abstraction and its factories.

• run_health_check() with SiteHealthStatus and SiteHealthState — the reachability probe and its verdict.

• EvasionStrategy and PlaywrightStealthEvasion — the bot-detection evasion seam.

• BrowserError, BrowserValidationError, and BrowserFailureMode — the failure taxonomy.

See also

adapters.outbound.aeat.auth.BrowserContextProvisioner

Auth-provider hook consumed by BrowserSession.create_context().

adapters.outbound.aeat.auth.CertificateContextProvisioner

Certificate-auth provisioner that adds Playwright client-certificate kwargs and the context thumbprint marker.

adapters.outbound.aeat.sede

Read-only Sede readers that consume these browser sessions.

Submodules

• aeat.adapters.outbound.aeat.browser._errors module
  • BrowserError
    • BrowserError.code
  • BrowserValidationError
    • BrowserValidationError.code
  • BrowserEvasionError
    • BrowserEvasionError.code
  • BrowserFailureMode
    • BrowserFailureMode.SESSION_BUSY
    • BrowserFailureMode.BROWSER_LAUNCH_FAILED
    • BrowserFailureMode.CONTEXT_CREATE_FAILED
    • BrowserFailureMode.EVASION_FAILED
    • BrowserFailureMode.CONTEXT_ANNOTATION_FAILED
    • BrowserFailureMode.PAGE_CONTENT_FAILED
    • BrowserFailureMode.NAVIGATION_TIMEOUT
    • BrowserFailureMode.NAVIGATION_TRANSPORT_ERROR
    • BrowserFailureMode.SITE_HEALTH_NON_OK
    • BrowserFailureMode.BROWSER_CLOSE_FAILED
• aeat.adapters.outbound.aeat.browser._factory module
  • DefaultBrowserSession
    • DefaultBrowserSession.profile
    • DefaultBrowserSession.create_context()
    • DefaultBrowserSession.navigate()
    • DefaultBrowserSession.close()
  • default_browser_session_factory()
  • create_browser_session()
  • shared_playwright_runtime()
  • opened_browser_page()
• aeat.adapters.outbound.aeat.browser._site_health module
  • SiteHealthState
    • SiteHealthState.OK
    • SiteHealthState.MANTENIMIENTO
    • SiteHealthState.WAF_CHALLENGE
    • SiteHealthState.RATE_LIMITED
    • SiteHealthState.UNREACHABLE
    • SiteHealthState.UNKNOWN_ERROR
  • SiteHealthEvidence
    • SiteHealthEvidence.url
    • SiteHealthEvidence.http_status
    • SiteHealthEvidence.html_fragment
    • SiteHealthEvidence.detected_markers
  • SiteHealthStatus
    • SiteHealthStatus.state
    • SiteHealthStatus.evidence
    • SiteHealthStatus.observed_at
    • SiteHealthStatus.retry_after_seconds
• aeat.adapters.outbound.aeat.browser._site_health_parsers module
  • parse_mantenimiento_banner()
  • parse_waf_challenge()
  • parse_rate_limit_response()
  • evaluate_response()
• aeat.adapters.outbound.aeat.browser._site_health_probe module
  • probe_response()
• aeat.adapters.outbound.aeat.browser.evasion module
  • EvasionStrategy
    • EvasionStrategy.apply()
  • PlaywrightStealthEvasion
    • PlaywrightStealthEvasion.apply()
• aeat.adapters.outbound.aeat.browser.health module
  • run_health_check()
  • main()
• aeat.adapters.outbound.aeat.browser.profile module
  • Profile
    • Profile.name
    • Profile.storage_state_path
    • Profile.user_agent
    • Profile.locale
    • Profile.timezone_id
    • Profile.ensure_storage_dir()
• aeat.adapters.outbound.aeat.browser.session module
  • BrowserSession
    • BrowserSession.create_context()
    • BrowserSession.close()
    • BrowserSession.navigate()