Skip to content

CHANGELOG.md

Latest commit

 

History

History
64 lines (50 loc) · 2.53 KB

CHANGELOG.md

File metadata and controls

64 lines (50 loc) · 2.53 KB

Changelog

All notable changes to postio/postio are documented here. Format follows Keep a Changelog, versioning follows SemVer.

Unreleased

0.1.2 — 2026-05-02

Changed

  • PhoneResult::$isReachable typed ?bool (was bool|string|null). postio-api 1.0.3 aligned the spec with the runtime — HLR returns boolean.
  • PhoneResult nullable fields drop their = null defaults. The runtime now always emits explicit nulls for every field; the hand-applied SPEC DRIFT block in the constructor is gone.

0.1.1 — 2026-05-02

Bookkeeping release — version bump + CLAUDE.md cleanup but the PhoneResult constructor changes intended for this release didn't make it into the tagged commit. Use 0.1.2 instead.

0.1.0 — 2026-05-02

Initial release. First Postio PHP SDK on Packagist.

Added

  • Postio\PostioClient with sync API (PHP's async story is too fragmented to ship two surfaces).
  • Address: $client->address->search/postcode/udprn.
  • Email: $client->email->validate.
  • Phone: $client->phone->validate.
  • Health probe: $client->connect().
  • Hand-written readonly value objects for every response shape.
  • Typed exception hierarchy: PostioException base + PostioInvalidKeyException, PostioOutOfCreditException, PostioForbiddenException, PostioNotFoundException, PostioValidationException, PostioRateLimitException, PostioServerException, PostioTimeoutException, PostioConnectionException. Each carries status, errorCode, details, requestId, envelope.
  • Default retry policy (2 retries, exp backoff + full jitter on 408/409/429/5xx + network/timeout). Mirrors @postio/node.
  • Guzzle 7 as the HTTP transport — inject your own ClientInterface via the $http constructor arg for proxies, mocks, custom middleware.
  • POSTIO_API_KEY env var fallback when no apiKey argument is passed.

Notes

  • PhoneResult.isReachable is typed bool|string|null because the live API returns booleans there even though the spec says string-only. Aligned once postio-api ships a spec/runtime fix.
  • Property errorCode (not code) — PHP's Exception::$code is a built-in non-readonly int and can't be shadowed by a readonly string.