Laravel Pipe Laravel Package

Getting Started

1. Installation: Require the package via Composer:

   composer require vendor/package-name
   

2. Publish Config: Run the package publisher (if available) to generate config files:

   php artisan vendor:publish --provider="Vendor\PackageName\PackageServiceProvider"
   

3. First Use Case: Listen for the updated video_converted webhook instead of the deprecated video_transcoded:

   use Vendor\PackageName\Events\VideoConverted;
   
   VideoConverted::listen(function ($payload) {
       // Handle video conversion logic
   });
   

Implementation Patterns

• Webhook Handling: Replace any existing video_transcoded listeners with video_converted in your event listeners or route definitions.
• Service Integration: Use the package’s service container bindings (e.g., app('video-processor')) to interact with core functionality.
• Middleware: Leverage the package’s middleware (if provided) for filtering or transforming payloads before processing:

  $payload = app('video-payload-transformer')->process($rawPayload);
  

Gotchas and Tips

• Breaking Change: The video_transcoded webhook is deprecated in v2.0.0. Update all listeners or routes immediately to avoid failures.
• Debugging: Use dd($payload) in your listener to inspect the new video_converted payload structure if behavior differs from video_transcoded.
• Config Quirks: Check config/package-name.php for updated default values or renamed keys (e.g., webhook_events.video_transcoded → webhook_events.video_converted).
• Extension Points: Override the VideoConverted event class or its listeners in your EventServiceProvider for custom logic:

  protected $listen = [
      'Vendor\PackageName\Events\VideoConverted' => [
          'App\Listeners\CustomVideoHandler',
      ],
  ];