Simple Bus Bridge Laravel Package

Product Decisions This Supports

• Event-Driven Architecture (EDA) Adoption: Enables seamless integration of SimpleBus (a PHP event bus library) with User (a user management library), allowing teams to leverage event-driven workflows for user-related operations (e.g., registration, authentication, role updates).
• Decoupling Business Logic: Facilitates build vs. buy by avoiding reinventing event bus infrastructure, reducing technical debt while maintaining flexibility.
• Roadmap for Scalable User Workflows: Supports future-proofing by aligning with SimpleBus’s extensibility (e.g., command/query separation, middleware pipelines) for complex user journeys (e.g., multi-step onboarding, audit trails).
• Use Cases:
  • Real-time notifications (e.g., password resets, role changes).
  • Audit logging via event publishing.
  • Third-party integrations (e.g., syncing user data to external services via events).

When to Consider This Package

• Adopt if:
  • Your Laravel/PHP app already uses SimpleBus or plans to adopt it for event-driven workflows.
  • You need a lightweight bridge to integrate User (or similar libraries) with SimpleBus without heavy customization.
  • Your team prioritizes testability (PHPSpec-backed) and decoupled architecture.
• Look elsewhere if:
  • You require active maintenance (last release: 2017; consider modern alternatives like Laravel Events or Symfony Messenger).
  • Your stack is non-PHP or already uses a different event bus (e.g., RabbitMQ, Kafka).
  • You need advanced features (e.g., event retries, dead-letter queues) beyond SimpleBus’s core capabilities.
  • Dependents/market traction is a concern (0 dependents; evaluate risk).

How to Pitch It (Stakeholders)

For Executives: "This package lets us leverage SimpleBus—a battle-tested PHP event bus—to handle user workflows (e.g., registrations, role updates) in a decoupled, scalable way. It’s like adding a ‘pub/sub’ layer to our user management, enabling real-time features (e.g., notifications) and third-party integrations without heavy custom code. Low risk (MIT license, tested), but we’d need to confirm if SimpleBus aligns with our long-term tech stack."

For Engineers: *"SimpleBusBridge is a minimal adapter to connect the User library with SimpleBus, giving us:

• Event-driven user actions (e.g., UserRegistered, RoleUpdated) with middleware support.
• Decoupled logic: Business rules live in commands/queries, not controllers.
• Testability: PHPSpec ensures reliability. Tradeoff: SimpleBus is outdated (2017), but the bridge itself is lightweight. If we’re committed to SimpleBus, this saves ~2 weeks of dev time. Alternative: Use Laravel’s built-in events (if not using SimpleBus)."*