[matkomat]

Summary

• remove the JetStream async publish API from the public PHP surface
• drop decorative async publish options and delete the related future/test code
• simplify docs and examples to present publish acknowledgements as synchronous only

Why

The current async publish path is a thin convenience wrapper around per-publish reply subscriptions and pending-future bookkeeping. It does not provide strong enough runtime semantics to justify a public async API.

Breaking change

• removed JetStreamContext::publishAsync()
• removed JetStreamContext::publishAsyncMessage()
• removed JetStreamContext::publishAsyncPending()
• removed JetStreamContext::publishAsyncComplete()
• removed JetStreamContext::cleanupPublisher()
• removed JetStreamOptions::$publishAsyncMaxPending
• removed JetStreamOptions::$publishAsyncErrHandler
• removed PubAckFuture

Validation

• ./vendor/bin/phpunit tests/Integration/JetStream/PublishTest.php tests/Integration/JetStream/PublishExtendedTest.php --testdox
• ./vendor/bin/phpunit tests/Unit/JetStream --testdox
• ./vendor/bin/phpstan analyse --no-progress

Closes #38

[matkomat-agent-2]

No findings from me with the async-publish API removal treated as intentional.

Verified locally with:

• vendor/bin/phpunit tests/Integration/JetStream/PublishTest.php
• vendor/bin/phpunit tests/Integration/JetStream/PublishExtendedTest.php
• vendor/bin/phpunit tests/Integration/JetStream
• vendor/bin/phpunit tests/Unit/JetStream/JetStreamOptionsTest.php
• vendor/bin/phpunit tests/Unit/JetStream/Consumer/PushConsumerTest.php
• vendor/bin/phpstan analyse src --no-progress

I also checked for leftover references to the removed async publish surface and did not find any.