Add Carbonite for time manipulation in tests

composer.json

@@ -23,6 +23,7 @@
         "barryvdh/laravel-debugbar": "^3.14",
         "fakerphp/faker": "^1.23",
         "filament/upgrade": "^4.0",
+        "kylekatarnls/carbonite": "^2.0",
         "laravel/boost": "^1.0",
         "laravel/pail": "^1.1",
         "laravel/pint": "^1.13",

tests/Pest.php

@@ -1,5 +1,8 @@
 <?php
 
+use Carbon\BespinTimeMocking;
+use Carbon\Carbonite;
+
 /*
 |--------------------------------------------------------------------------
 | Test Case
@@ -11,6 +14,8 @@
 |
 */
 
+uses(BespinTimeMocking::class)->in('Feature', 'Unit');
+
 pest()->extend(Tests\TestCase::class)
  // ->use(Illuminate\Foundation\Testing\RefreshDatabase::class)
     ->in('Feature');
@@ -45,3 +50,25 @@ function something()
 {
     // ..
 }
+
+/**
+ * Run a callback with time frozen, then restore the real timeline.
+ */
+function fakeAsync(callable $callback): mixed
+{
+    Carbonite::freeze();
+
+    try {
+        return $callback();
+    } finally {
+        Carbonite::release();
+    }
+}
+
+/**
+ * Advance the fake timeline by the given number of milliseconds.
+ */
+function tick(int $milliseconds): void
+{
+    Carbonite::elapse("{$milliseconds} milliseconds");
+}

tests/Unit/CarboniteTest.php

@@ -0,0 +1,49 @@
+<?php
+
+use Carbon\Carbon;
+use Carbon\Carbonite;
+
+it('freezes time at a given moment', function () {
+    Carbonite::freeze('2024-01-15 10:00:00');
+
+    expect(Carbon::now()->toDateTimeString())->toBe('2024-01-15 10:00:00')
+        ->and(Carbonite::speed())->toBe(0.0);
+});
+
+it('accelerates the fake timeline', function () {
+    Carbonite::freeze('2024-01-01 00:00:00');
+    Carbonite::speed(2);
+
+    expect(Carbonite::accelerate(3))->toBe(6.0);
+});
+
+it('decelerates the fake timeline', function () {
+    Carbonite::freeze('2024-01-01 00:00:00');
+    Carbonite::speed(5);
+
+    expect(Carbonite::decelerate(2))->toBe(2.5);
+});
+
+it('elapses time on the fake timeline', function () {
+    Carbonite::freeze('2024-01-01');
+    Carbonite::elapse('1 month');
+
+    expect(Carbon::now()->format('Y-m-d'))->toBe('2024-02-01');
+});
+
+it('advances time with tick inside fakeAsync', function () {
+    fakeAsync(function () {
+        $now = Carbon::now();
+
+        tick(2000);
+
+        expect($now->diffForHumans())->toBe('2 seconds ago');
+    });
+});
+
+it('sets timeline speed with speed()', function () {
+    Carbonite::freeze('2024-06-01 12:00:00');
+    Carbonite::speed(3);
+
+    expect(Carbonite::speed())->toBe(3.0);
+});