famous-ly4-ev/app-modules/booking/tests/Unit/CancelBookingActionTest.php

<?php

use Modules\Booking\Actions\CancelBookingAction;
use Modules\Booking\Enums\BookingStatus;
use Modules\Booking\Exceptions\BookingCannotBeCancelledException;
use Modules\Booking\Models\Booking;
use Modules\Payment\Contracts\PaymentGatewayInterface;
use Modules\Payment\Data\PaymentRequestData;
use Modules\Payment\Data\PaymentResultData;
use Modules\Payment\Data\RefundResultData;
use Modules\Payment\Enums\PaymentMethod;
use Modules\Payment\Enums\RefundStatus;
use Modules\Payment\Factories\PaymentGatewayFactory;
use Modules\Payment\Models\Payment;

/**
 * Never calls the real KBZ refund API in tests.
 */
class FakeCancelRefundGateway implements PaymentGatewayInterface
{
    public static ?string $lastAmount = null;

    public function initiate(PaymentRequestData $data): PaymentResultData
    {
        throw new RuntimeException('not needed for this test');
    }

    public function verify(string $gatewayTransactionId): PaymentResultData
    {
        throw new RuntimeException('not needed for this test');
    }

    public function refund(string $gatewayTransactionId, string $amount, string $reason): RefundResultData
    {
        self::$lastAmount = $amount;

        return new RefundResultData(status: RefundStatus::Completed, gatewayRefundId: 'REFUND123', gatewayPayload: []);
    }

    public function handleWebhook(array $payload): PaymentResultData
    {
        throw new RuntimeException('not needed for this test');
    }
}

beforeEach(function () {
    FakeCancelRefundGateway::$lastAmount = null;
    app(PaymentGatewayFactory::class)->register(PaymentMethod::KbzMiniApp, FakeCancelRefundGateway::class);
});

test('it cancels a pending_payment booking directly', function () {
    $booking = Booking::factory()->create(['status' => BookingStatus::PendingPayment]);

    $cancelled = app(CancelBookingAction::class)->handle($booking);

    expect($cancelled->status)->toBe(BookingStatus::Cancelled)
        ->and($booking->refresh()->status)->toBe(BookingStatus::Cancelled);
});

test('it cancels a confirmed booking by refunding it in full', function () {
    $booking = Booking::factory()->create(['status' => BookingStatus::Confirmed, 'price' => 15000]);
    Payment::factory()->completed()->create([
        'booking_id' => $booking->id,
        'gateway' => PaymentMethod::KbzMiniApp,
        'amount' => 15000,
        'gateway_transaction_id' => 'EVB-CANCEL-TEST-1',
    ]);

    $cancelled = app(CancelBookingAction::class)->handle($booking);

    expect($cancelled->status)->toBe(BookingStatus::Cancelled)
        ->and(FakeCancelRefundGateway::$lastAmount)->toBe('15000.00');
});

test('it guards against cancelling an already cancelled booking', function () {
    $booking = Booking::factory()->create(['status' => BookingStatus::Cancelled]);

    expect(fn () => app(CancelBookingAction::class)->handle($booking))
        ->toThrow(BookingCannotBeCancelledException::class);
});

test('it guards against cancelling an expired booking', function () {
    $booking = Booking::factory()->create(['status' => BookingStatus::Expired]);

    expect(fn () => app(CancelBookingAction::class)->handle($booking))
        ->toThrow(BookingCannotBeCancelledException::class);
});