Testing

Overview

Unleash Commerce Core ships with factories for all models, making it easy to write tests for your custom implementations and extensions.

Model Factories

All core models include Laravel factories that you can use in your tests. Create test data quickly:

use Esign\UnleashCommerce\Core\Models\Product;
use Esign\UnleashCommerce\Core\Models\Order;
use Esign\UnleashCommerce\Core\Models\Customer;

$product = Product::factory()->create();
$customer = Customer::factory()->create();
$order = Order::factory()->for($customer)->create();

Using Factories with Relationships

Use the for method to associate models:

$order = Order::factory()
    ->for($customer)
    ->create();

$cartLine = CartLine::factory()
    ->for($product)
    ->for($cart)
    ->create();

Attaching Customers to Users

The User factory includes a hasCustomer method to easily attach customers with proper pivot attributes.

By default, hasCustomer marks the customer as active (is_active = true, invitation_accepted_at = now). The active customer is used throughout the application for authorization and scoping data in B2B contexts.

// Automatically creates a customer and attaches it as active
$user = User::factory()
    ->hasCustomer()
    ->create();

// With a specific customer (also marked as active)
$customer = Customer::factory()->create();
$user = User::factory()
    ->hasCustomer($customer)
    ->create();

// Override pivot attributes to make customer inactive
$user = User::factory()
    ->hasCustomer($customer, ['is_active' => false])
    ->create();

Assigning Roles to Users

The User factory includes a role method to assign roles to users in the context of their active customer.

Roles in Unleash Commerce are scoped to customers (B2B multi-tenancy). The role method automatically uses the user’s active customer as the authorization context. If no customer is explicitly provided, the role is assigned using $user->activeCustomer.

// Assigns role in the context of the user's active customer
$user = User::factory()
    ->hasCustomer()
    ->role('admin')
    ->create();

// Explicitly specify a customer context
$user = User::factory()
    ->hasCustomer($customerA)
    ->role('manager', $customerB) // Role is scoped to $customerB
    ->create();

// With a Role instance
$role = Role::factory()->create(['name' => 'editor']);
$user = User::factory()
    ->hasCustomer()
    ->role($role) // Role is scoped to the active customer
    ->create();

Database Assertions

Use model classes instead of table names:

$this->assertDatabaseHas(Product::class, ['name' => 'Test']);
$this->assertDatabaseMissing(Product::class, ['deleted' => true]);

Getting started

Extending

API Reference

Overview

Model Factories

Using Factories with Relationships

Attaching Customers to Users

Assigning Roles to Users

Database Assertions

​Overview

​Model Factories

​Using Factories with Relationships

​Attaching Customers to Users

​Assigning Roles to Users

​Database Assertions

Overview

Model Factories

Using Factories with Relationships

Attaching Customers to Users

Assigning Roles to Users

Database Assertions