Skip to content

re #15 docs: Courier package guide#28

Merged
tonydspaniard merged 1 commit into
masterfrom
docs/courier
May 26, 2026
Merged

re #15 docs: Courier package guide#28
tonydspaniard merged 1 commit into
masterfrom
docs/courier

Conversation

@tonydspaniard
Copy link
Copy Markdown
Member

@tonydspaniard tonydspaniard commented May 26, 2026

Summary

Courier (command bus) package documentation, per #15. Single new file: docs/packages/courier.md (~493 lines). Follows the #16 template.

Covers Command/Handler/Bus/Locator/Resolver/middleware pipeline. Both ExecCommandBusConfiguration and MiddlewareCommandBusConfiguration are documented with their COURIER_MAP_FILE env var requirement.

Source observations

  • The issue checklist asked about a "CommandResolver" — in Courier this role is split between name resolvers (ClassCommandMessageNameResolver, CommandMessageNameResolver) and locator services (InMemoryCommandLocatorService). There is no single "CommandResolver" class. Both layers documented.
  • CommandLockerMiddleware queues re-entrant dispatches; inner commands run AFTER the outer handler completes. Test suite verifies this ordering. Documented.
  • Async dispatch is not supported. Stated explicitly in Limitations.

Spun out as a separate issue

Test plan

  • Render and skim
  • Pure additive docs

@tonydspaniard tonydspaniard merged commit f2275d4 into master May 26, 2026
0 of 3 checks passed
@tonydspaniard tonydspaniard deleted the docs/courier branch May 26, 2026 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant