Fix premium domain pricing for aftermarket listings

[ChiragAgg5k]

What does this PR do?

Fixes premium (aftermarket) domains being quoted at the base TLD price. Name.com's :getPricing endpoint only covers standard registry registrations, so a premium listing like appwrite.xyz (~$2,242 one-time acquisition fee) was priced at the base .xyz promo price of $1.99.

Changes

• NameCom::getPrice() now also consults :checkAvailability. When the domain is a purchasable premium listing (premium flag set, or a non-registration purchaseType such as aftermarket), its purchasePrice/renewalPrice override the registry pricing and the result is marked premium.
• NameCom::suggest() treats non-registration purchase types as premium and now exposes renewalPrice and purchaseType per suggestion.
• purchase() accepts an optional purchasePrice param (backward-compatible), which registrars require for premium registrations — mirroring the existing transfer() support. Wired through Registrar, Adapter, NameCom (request payload), OpenSRS (existing register() param) and Mock.
• Cache fix: getPrice() no longer caches null renewal/transfer prices as 0.0; a cached null now raises PriceNotFoundException as the live path does.

Test plan

• composer lint, composer check (PHPStan level 4) pass
• Mock suite and NameCom integration tests (availability/suggest/price) pass against api.dev.name.com
• Live check on dev: registry premium nb.xyz → $3,807.69 premium: true; standard domains unchanged. The aftermarket merge path can't be reproduced in name.com's dev sandbox (no aftermarket listings there); verified the data shape against production search results for appwrite.xyz (premium: true, ~$2,242) via the cloud suggestions endpoint.

Related

• Consumer-side change in the cloud repo (passing purchasePrice at purchase confirmation and re-validating the quoted price) depends on this being released and bumped.

[greptile-apps]

Greptile Summary

This PR fixes a real pricing bug where premium/aftermarket domains were quoted at the standard registry TLD price because :getPricing only covers vanilla registry registrations. It also adds backward-compatible purchasePrice threading through the full call chain.

• NameCom::getPrice() now issues a secondary :checkAvailability call on every cache miss to merge the correct purchasePrice/renewalPrice; the cache fix also corrects the previous behaviour of storing 0.0 for null prices.
• NameCom::suggest() now includes renewalPrice and purchaseType per suggestion using the same aftermarket-premium detection logic.
• purchase() accepts an optional ?float $purchasePrice across Registrar, Adapter, NameCom, OpenSRS, and Mock, mirroring the existing transfer() support.

Confidence Score: 4/5

Safe to merge for standard domains; the happy-path premium fix is correct, but the mandatory second API call on every cache miss is a reliability concern worth addressing before high-traffic use.

The getPrice() change unconditionally issues a second network call to checkAvailability on every cache miss, meaning a rate-limit or transient error on that endpoint now degrades pricing for all domains, not just premium ones.

src/Domains/Registrar/Adapter/NameCom.php — specifically the getPrice() double-call strategy and its error handling interaction with caching.

Important Files Changed

Filename	Overview
src/Domains/Registrar/Adapter/NameCom.php	Core pricing logic updated to merge availability data for premium aftermarket domains; adds a mandatory second API call on every cache miss
src/Domains/Registrar.php	Backward-compatible addition of optional purchasePrice parameter to purchase(); cleanly threaded to the adapter layer
src/Domains/Registrar/Adapter.php	Abstract purchase() signature updated to accept optional purchasePrice; no logic changes
src/Domains/Registrar/Adapter/Mock.php	purchase() updated to accept purchasePrice to satisfy interface; parameter unused as expected for a mock
src/Domains/Registrar/Adapter/OpenSRS.php	purchase() properly wires new purchasePrice through to the existing register() call; straightforward change

_{Reviews (2): Last reviewed commit: "(fix): soft-fail availability lookup in ..." | Re-trigger Greptile}