Opensalestax Sylius Laravel Package

Added

• CP-9 partial: OstaxClient::calculateWithShipping(). New facade method on OstaxClient that calls /v1/calculate with both a single line item AND a top-level first-class shipping segment (engine v0.59.0+ via ejosterberg/opensalestax v0.3.0). Returns the engine's full CalculateResponse including the populated $shipping->taxAmount so the strategy can surface shipping tax as a separate adjustment. Not yet wired into OstaxTaxationStrategy — the strategy currently iterates per-OrderItemUnit, and surfacing shipping tax requires adding a separate order-level adjustment path (deferred to a follow-up release). Merchants who need shipping tax today can call OstaxClient::calculateWithShipping() directly from custom code.

Changed

• Bumps ejosterberg/opensalestax constraint from ^0.2.0 to ^0.3.0. Picks up the new third arg on Client::calculate(addr, lines, shipping?) plus the CalculateResponse::$shipping and $coverageWarning response fields. Backward compatible — no behavior change at the strategy level.

Notes

• The engine returns null shipping on this SDK version when older engine builds (pre-v0.59.0) silently ignore the field. Flag-gate via OstaxClient::sdk->capabilities()->features->shippingFirstClass if you need to detect this at setup time.

Changed

• CP-8 Phase 5D: bumped ejosterberg/opensalestax constraint to ^0.2.0. Picks up the new OpenSalesTax\Client::capabilities() / OpenSalesTax\Client::capabilitiesCached() helpers for engine v0.59.0's /v1/capabilities endpoint. No merchant-visible behavior change in this release — the helper is available to connector code but not yet wired into any feature path. Constraint bump only; Test Connection surface enrichment deferred to v-next.

Added

• Initial release of the Sylius tax-calculation bundle.
• OstaxCalculator implementing Sylius\Component\Taxation\Calculator\CalculatorInterface.
• OstaxTaxationStrategy implementing Sylius\Component\Core\Taxation\Strategy\TaxCalculationStrategyInterface.
• OstaxClient wrapper around ejosterberg/opensalestax PHP SDK.
• OstaxConfig validated value-object built from the bundle's opensalestax_sylius: config block.
• OstaxCache PSR-6-backed memoization (60-min default TTL).
• USD-only / US-only gates (constitution §5) — non-USD or non-US ship-to falls back to Sylius's built-in tax handling.
• Fail-soft default (constitution §8) — engine errors return 0.0
  • log a warning. fail_hard: true opts into throwing.
• Per-state nexus filter (nexus_states: ['MN', 'WI']) — mirrors the WooCommerce v0.5.0 / Vendure v1.2 sibling pattern.
• Symfony bundle skeleton (AbstractBundle-style extension + config tree).
• PHPUnit + PHPStan + Psalm + composer audit CI on PHP 8.2 / 8.3 / 8.4.

Compatibility

• Sylius ^1.13
• OpenSalesTax engine v1 API (engine v0.14+)