Pipeline Bundle Laravel Package

Product Decisions This Supports

• Feature enablement: The #[NextForwarded] attribute and phd_pipeline.forward_chain middleware enable chained message forwarding out of the box, making it trivial to build multi-step workflows (e.g., order processing, notification sequences, data enrichment) where each step can conditionally forward to the next.
• Roadmap acceleration: If your roadmap includes event-driven pipelines, webhook fan-out, or sequential command handling, this package provides a ready-made, attribute-based mechanism instead of custom pipeline code.
• Build vs. buy: Reduces the need to build and maintain bespoke forwarding logic; the declarative attribute approach lowers boilerplate and ties into Laravel’s existing middleware and service container.
• Use cases: Ideal for orchestrating chained HTTP requests, queued jobs, or any "message" that must be passed through a series of handlers with clean separation of concerns.

When to Consider This Package

• Adopt when: You are on Laravel (or a PHP framework with similar attribute/middleware support), need sequential forwarding of messages between discrete steps, and prefer declarative, attribute-driven configuration over manual pipeline wiring.
• Look elsewhere when: You require a full-featured workflow engine (visual modeling, complex branching, retries, compensation), are not using Laravel, or need extensive observability and error handling that this lightweight package may not provide. Also consider Laravel’s built-in Pipeline if you only need simple, non-chained pipelines without attributes.

How to Pitch It (Stakeholders)

• Executives: This package lets us quickly add chained message forwarding to our Laravel applications, reducing custom development time and enabling faster delivery of workflow-oriented features. It’s low-risk, leverages our existing stack, and avoids reinventing pipeline logic.
• Engineering: The #[NextForwarded] attribute and phd_pipeline.forward_chain middleware provide a clean, declarative way to define forwarding chains, cutting boilerplate and improving readability. It integrates naturally with Laravel’s middleware and container, making pipelines easier to test and maintain.