feat: Add incrementAll() and decrementAll() methods to BaseBuilder and other driver specific builders

[patel-vansh]

Description
This PR adds two new functions in BaseBuilder.php — incrementAll() and decrementAll(). These two functions enable devs to increment/decrement multiple rows at once atomically.

Also, the increment() and decrement() methods now internally call incrementAll() and decrementAll() respectively to prevent duplicating the logic.

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value (without duplication)
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[paulbalandan]

Have you considered adding a separate incrementAll (or other wording) that will take care of the array, so to minimize the BC break?

PS. The random test failure seems legitimate. I'll deal with that later.

[michalsn]

I also think that incrementMany() or incrementAll() would probably work better.

[patel-vansh]

Yeah, that would avoid BC. I guess incrementAll would be the new method.

Maybe the current increment method calls incrementAll internally? So, there's no duplication of any logic.
@paulbalandan and @michalsn

[michalsn]

Maybe the current increment method calls incrementAll internally? So, there's no duplication of any logic.

I see why not.

[patel-vansh]

Not sure why PHPStan analysis have failed.

[paulbalandan]

You apparently fixed (or renamed) the affected code. Just run composer phpstan:baseline to update the baseline.

[michalsn]

Supporting a more convenient API would be nice:

incrementAll(['one', 'two'], 2)
incrementAll(['one' => 2, 'two' => 3])

What do you think?

Something like:

public function incrementAll(array $columns, int $value = 1): bool
{
    $fields = [];

    if (array_is_list($columns)) {
        foreach ($columns as $column) {
            $column          = $this->db->protectIdentifiers($column);
            $fields[$column] = "{$column} + {$value}";
        }
    } else {
        foreach ($columns as $column => $value) {
            if (! is_int($value)) {
                throw new TypeError(...);
            }

            $column          = $this->db->protectIdentifiers($column);
            $fields[$column] = "{$column} + {$value}";
        }
    }
    
    // ...
}

[michalsn]

Since we no longer have runtime type enforcement for each value, we should add a check manually. Something like:

if (! is_int($val)) {
    throw new TypeError(sprintf(
        'Argument #1 ($columns) must contain only int values, %s given for "%s".',
        get_debug_type($val),
        (string) $col,
    ));
}