iazaran/trace-replay

Error logger and execution tracer that captures every step of your complex workflows, reconstructs them with a waterfall timeline, and offers one-click AI debugging.

Wrap any complex logic in TraceReplay::step() — each callback's return value is passed through transparently.

use TraceReplay\Facades\TraceReplay;
 
class BookingService
{
    public function handleBooking(array $payload): void
    {
        TraceReplay::start('Flight Booking', ['channel' => 'web']);
 
        try {
            $inventory = TraceReplay::step('Validate Inventory', function () use ($payload) {
                return Inventory::check($payload['flight_id']);
            });
 
            TraceReplay::checkpoint('Inventory validated', ['seats_left' => $inventory->seats]);
 
            TraceReplay::context(['user_tier' => auth()->user()->tier]);
 
            TraceReplay::step('Charge Credit Card', function () use ($payload) {
                return PaymentGateway::charge($payload['amount']);
            });
 
            TraceReplay::end('success');
 
        } catch (\Exception $e) {
            TraceReplay::end('error');
            throw $e;
        }
    }
}