Laravel performance profiling
for AI coding agents.

test('user list has no N+1 queries')
    ->maxQueryCount(10)
    ->noN1Patterns()
    ->maxDuration(500);

use function Mateffy\Laraperf\Testing\{measure};
 
test('dashboard loads fast', function () {
    $result = measure(fn () =>
        User::with('posts')->paginate()
    );
 
    expect($result->queryCount())
        ->toBeLessThan(20);
});
 
test('contact query performance', function () {
    $result = measure(fn () =>
        Contact::with('company')->get()
    );
 
    expect($result->durationMs())
        ->toBeLessThan(100);
});

test('contacts page performance', function () {
    $result = measure(fn () =>
        Contact::with('company')->get()
    );
 
    expect($result)
        ->performance()->duration()
            ->toBeLessThan(100)
        ->performance()->queries()
            ->whereTable('contacts')->count()
            ->toBeLessThan(5)
        ->performance()
            ->toHaveNoN1()
        ->performance()
            ->toHaveNoSlowQueries(50);
});

use function Mateffy\Laraperf\Testing\{capture, timeline_mark};
 
test('import progress tracking', function () {
    $cap = capture();
    timeline_mark('start');
 
    $importer = new ContactImporter();
    $importer->import($csv);
 
    timeline_mark('imported');
 
    $result = $cap->stop();
 
    // Timeline marks let you measure phases
    $importMs = $result->durationBetween('start', 'imported');
    expect($importMs)->toBeLessThan(5000);
});