Skip to main content

​
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]);