v10.0.0-beta.3

10.0.0-beta.3 (2026-10-30)

⚠ BREAKING CHANGES

• protocol: the SDK no longer advertises or accepts AdCP 3.3-beta.1. get_supported_adcp_versions() is ('3.0', '3.1', '3.2', '3.3-beta.2', '3.2-rc.7'); an adcp_version pin of "3.3-beta.1" / "3.3.0-beta.1" raises ConfigurationError, and a peer that advertises only 3.3-beta.1 among the 3.3 line is negotiated like any other unserved prerelease (down to 3.2). Re-pin to 3.3-beta.2 or omit the pin. The definition-pin, purchase-rights and installment-selection types and TestControllerStore.definition_pin_probe are removed.
• decisioning: create_property_list / update_property_list fail with INVALID_REQUEST on mixed-case, trailing-dot or URL-shaped domain identifiers, and MCPPropertyListFetcher fails a resolution carrying one. get_products / list_products fail with INTERNAL_ERROR when a product advertises an undeclared measurement_window. get_adcp_capabilities truncates oversized publisher_domains / data_provider_domains. PrincipalService accepts "3.3" async versions by default.
• compat: a 3.3 request the 3.2 contract cannot express (a webhook without authentication, a minute-level daypart) now fails with ADCPVersionConversionError / UNSUPPORTED_FEATURE before sending. Earlier SDK 10 betas sent some of these to the peer invalid, for example when the request carried start_time "asap".

Features

• compat: semantic 3.3 → 3.2 downgrade rules (#1717) (fab1adf), closes #1667
• decisioning: AdCP 3.3 seller-side rules (#1720) (fbf13c9)
• examples: serve the AdCP 3.3 property breakdowns from injected rows in the reference seller (#1715) (a998b82), closes #1669
• protocol: adopt the signed AdCP 3.3.0-beta.2 bundle (#1732) (3e23bec)
• reporting-storage: add PostgreSQL stores for reporting subscriptions (#1724) (46a1e01), closes #1695
• reporting: accept reporting subscriptions on sync_principal and track what they owe (#1698) (04238b2)
• reporting: add buyer client helpers and a tracker for reporting subscriptions (#1699) (8a7f482)
• reporting: apply the AdCP 3.3 reporting rules (#1707) (3e177e6), closes #1669
• reporting: compute owed reporting-subscription periods and their capabilities (#1696) (58e825a)
• reporting: persist reporting-subscription engine state through a CAS store (#1722) (10643c7), closes #1695
• server: seller helper for wholesale feed versions (#1706) (b014066), closes #1676
• signing: accept any well-formed adcp_use purpose in keygen (#1708) (612f97a)

Bug Fixes

• codegen: find generated classes by name, and derive emitted envelope bases from the bundle (#1705) (50fe9e8), closes #1680
• examples: stop zero-filling impressions and flat multi-standard viewability in the reference seller (#1709) (a63836f), closes #1669
• media-buy-actions: project change_term_id for AdCP 3.3 prereleases (#1721) (ac5d410), closes #1668
• types: defer the import-time model rebuilds that cost adcp.client 560 MiB RSS (#1713) (ab39d63)
• webhooks: drop aggregated_totals from media_buy_delivery webhook results (#1716) (875a4fe), closes #1669