Files
Geoff TaylorandGitHub 146a4430f9 fix: add authenticate flag to registerCustomer mutation (#973)
* fix: add authenticate flag to registerCustomer mutation

Adds an optional `authenticate` boolean input to the registerCustomer
mutation. When true, the mutation sets the current user and reinitializes
the session token for the newly registered customer. Defaults to false
to prevent nonce verification failures in contexts like GraphiQL that
send a nonce with the request.

Resolves #464

* test: add authenticate flag to existing register customer tests

The existing wpunit tests for registerCustomer rely on the user being
authenticated after registration to assert on customer.databaseId and
viewer.userId. Now that authenticate defaults to false, the tests must
explicitly pass authenticate: true.

* test: add authenticate flag to testCustomerMutationsWithMeta

* fix: use explicit billing emails in CustomerQueriesTest assertions

Use wildcard index matching with specific email values instead of
hardcoded node indices with NOT_NULL checks. This prevents failures
when other users in the DB shift the node positions.
2026-03-18 13:13:45 -04:00

667 lines
19 KiB
PHP

<?php
class CustomerQueriesTest extends \Tests\WPGraphQL\WooCommerce\TestCase\WooGraphQLTestCase {
public function expectedCustomerData( $id ) {
$customer = new \WC_Customer( $id );
$customer->read_meta_data( true );
$wp_user = get_user_by( 'ID', $id );
if ( ! $customer->get_id() ) {
throw new \Exception( 'Invalid customer ID provided.' );
}
$billing = $customer->get_billing();
$shipping = $customer->get_shipping();
return [
$this->expectedObject(
'customer',
[
$this->expectedField( 'id', $this->toRelayId( 'user', $id ) ),
$this->expectedField( 'databaseId', $id ),
$this->expectedField( 'isVatExempt', $customer->get_is_vat_exempt() ),
$this->expectedField( 'hasCalculatedShipping', $customer->has_calculated_shipping() ),
$this->expectedField( 'calculatedShipping', $customer->get_calculated_shipping() ),
$this->expectedField( 'orderCount', $customer->get_order_count() ),
$this->expectedField( 'totalSpent', (float) $customer->get_total_spent() ),
$this->expectedField( 'username', $customer->get_username() ),
$this->expectedField( 'email', $customer->get_email() ),
$this->expectedField( 'firstName', $this->maybe( $customer->get_first_name() ) ),
$this->expectedField( 'lastName', $this->maybe( $customer->get_last_name() ) ),
$this->expectedField( 'displayName', $customer->get_display_name() ),
$this->expectedField( 'role', $customer->get_role() ),
$this->expectedField( 'date', (string) $customer->get_date_created() ),
$this->expectedField( 'modified', (string) $customer->get_date_modified() ),
$this->expectedField(
'lastOrder.databaseId',
$customer->get_last_order()
? $customer->get_last_order()->get_id()
: static::IS_NULL
),
$this->expectedObject(
'billing',
[
$this->expectedField( 'firstName', $this->maybe( $billing['first_name'] ) ),
$this->expectedField( 'lastName', $this->maybe( $billing['last_name'] ) ),
$this->expectedField( 'company', $this->maybe( $billing['company'] ) ),
$this->expectedField( 'address1', $this->maybe( $billing['address_1'] ) ),
$this->expectedField( 'address2', $this->maybe( $billing['address_2'] ) ),
$this->expectedField( 'city', $this->maybe( $billing['city'] ) ),
$this->expectedField( 'postcode', $this->maybe( $billing['postcode'] ) ),
$this->expectedField( 'email', $this->maybe( $billing['email'] ) ),
$this->expectedField( 'phone', $this->maybe( $billing['phone'] ) ),
]
),
$this->expectedObject(
'shipping',
[
$this->expectedField( 'firstName', $this->maybe( $shipping['first_name'] ) ),
$this->expectedField( 'lastName', $this->maybe( $shipping['last_name'] ) ),
$this->expectedField( 'company', $this->maybe( $shipping['company'] ) ),
$this->expectedField( 'address1', $this->maybe( $shipping['address_1'] ) ),
$this->expectedField( 'address2', $this->maybe( $shipping['address_2'] ) ),
$this->expectedField( 'city', $this->maybe( $shipping['city'] ) ),
$this->expectedField( 'postcode', $this->maybe( $shipping['postcode'] ) ),
]
),
$this->expectedField( 'isPayingCustomer', $customer->get_is_paying_customer() ),
$this->expectedField(
'jwtAuthToken',
! is_wp_error( \WPGraphQL\JWT_Authentication\Auth::get_token( $wp_user ) )
? \WPGraphQL\JWT_Authentication\Auth::get_token( $wp_user )
: static::IS_NULL
),
$this->expectedField(
'jwtRefreshToken',
! is_wp_error( \WPGraphQL\JWT_Authentication\Auth::get_refresh_token( $wp_user ) )
? \WPGraphQL\JWT_Authentication\Auth::get_refresh_token( $wp_user )
: static::IS_NULL
),
]
),
];
}
// tests
public function testCustomerQueryAndArgs() {
$new_customer_id = $this->factory->customer->create();
$query = '
query ( $id: ID, $customerId: Int ) {
customer( id: $id, customerId: $customerId ) {
id
databaseId
isVatExempt
hasCalculatedShipping
calculatedShipping
orderCount
totalSpent
username
email
firstName
lastName
displayName
role
date
modified
lastOrder {
id
databaseId
}
billing {
firstName
lastName
company
address1
address2
city
postcode
email
phone
}
shipping {
firstName
lastName
company
address1
address2
city
postcode
}
isPayingCustomer
jwtAuthToken
jwtRefreshToken
}
}
';
/**
* Assertion One
*
* Query should return null value due to lack of permissions.
*/
$this->loginAsCustomer();
$variables = [ 'id' => $this->toRelayId( 'user', $new_customer_id ) ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedErrorPath( 'customer' ),
$this->expectedField( 'customer', static::IS_NULL ),
];
$this->assertQueryError( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
/**
* Assertion Two
*
* Query should return requested data because user queried themselves.
*/
$variables = [ 'id' => $this->toRelayId( 'user', $this->customer ) ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = $this->expectedCustomerData( $this->customer );
$this->assertQuerySuccessful( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
/**
* Assertion Three
*
* Query should return requested data because has sufficient permissions,
* but should not have access to JWT fields.
*/
$this->loginAsShopManager();
$variables = [ 'id' => $this->toRelayId( 'user', $new_customer_id ) ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = array_merge(
[
$this->expectedErrorPath( 'customer.jwtAuthToken' ),
$this->expectedField( 'customer.jwtAuthToken', static::IS_NULL ),
$this->expectedErrorPath( 'customer.jwtRefreshToken' ),
$this->expectedField( 'customer.jwtRefreshToken', static::IS_NULL ),
],
$this->expectedCustomerData( $new_customer_id )
);
$this->assertQueryError( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
/**
* Assertion Four
*
* Query should return data corresponding with current user when no ID is provided.
*/
$this->loginAs( $new_customer_id );
$response = $this->graphql( compact( 'query' ) );
$expected = $this->expectedCustomerData( $new_customer_id );
$this->assertQuerySuccessful( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
/**
* Assertion Five
*
* Query should return requested data because user queried themselves.
*/
$this->loginAs( $new_customer_id );
$variables = [ 'customerId' => $new_customer_id ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$this->assertQuerySuccessful( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
/**
* Assertion Six
*
* Query should return null value due to lack of permissions..
*/
$this->loginAsCustomer();
$variables = [ 'customerId' => $new_customer_id ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedErrorPath( 'customer' ),
$this->expectedField( 'customer', static::IS_NULL ),
];
$this->assertQueryError( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
}
public function testCustomersQueryAndWhereArgs() {
$users = [
$this->factory->customer->create(
[
'email' => 'gotcha@example.com',
'username' => 'megaman8080',
]
),
$this->factory->customer->create([ 'email' => 'example1@example.com' ]),
$this->factory->customer->create([ 'email' => 'example2@example.com' ]),
$this->factory->customer->create([ 'email' => 'example3@example.com' ]),
];
$query = '
query (
$search: String,
$include: [Int],
$exclude: [Int],
$email: String,
$orderby: CustomerConnectionOrderbyEnum,
$order: OrderEnum
) {
customers( where: {
search: $search,
include: $include,
exclude: $exclude,
email: $email,
orderby: $orderby,
order: $order
} ) {
nodes{
databaseId
billing { email }
}
}
}
';
/**
* Assertion One
*
* Query should return null value due to lack of capabilities...
*/
$this->loginAs( $users[0] );
$response = $this->graphql( compact( 'query' ) );
$expected = [ $this->expectedField( 'customers.nodes', [] ) ];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assertion Two
*
* Query should return requested data because user has proper capabilities.
*/
$this->loginAsShopManager();
$response = $this->graphql( compact( 'query' ) );
$expected = [
$this->expectedField( 'customers.nodes.#.databaseId', $users[0] ),
$this->expectedField( 'customers.nodes.#.databaseId', $users[1] ),
$this->expectedField( 'customers.nodes.#.databaseId', $users[2] ),
$this->expectedField( 'customers.nodes.#.databaseId', $users[3] ),
$this->expectedField( 'customers.nodes.#.billing.email', 'gotcha@example.com' ),
$this->expectedField( 'customers.nodes.#.billing.email', 'example1@example.com' ),
$this->expectedField( 'customers.nodes.#.billing.email', 'example2@example.com' ),
$this->expectedField( 'customers.nodes.#.billing.email', 'example3@example.com' ),
];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assertion Three
*
* Tests "search" where argument.
*/
$variables = [ 'search' => 'megaman8080' ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedField( 'customers.nodes.0.databaseId', $users[0] ),
$this->expectedField( 'customers.nodes.0.billing.email', 'gotcha@example.com' ),
];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assertion Four
*
* Tests "include" where argument.
*/
$variables = [ 'include' => [ $users[2] ] ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedField( 'customers.nodes.0.databaseId', $users[2] ),
$this->expectedField( 'customers.nodes.0.billing.email', 'example2@example.com' ),
];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assertion Five
*
* Tests "exclude" where argument.
*/
$variables = [ 'exclude' => [ $users[2] ] ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedField( 'customers.nodes.#.databaseId', $users[0] ),
$this->expectedField( 'customers.nodes.#.databaseId', $users[1] ),
$this->expectedField( 'customers.nodes.#.databaseId', $users[3] ),
$this->expectedField( 'customers.nodes.#.billing.email', 'gotcha@example.com' ),
$this->expectedField( 'customers.nodes.#.billing.email', 'example1@example.com' ),
$this->expectedField( 'customers.nodes.#.billing.email', 'example3@example.com' ),
$this->not()->expectedField( 'customers.nodes.#.databaseId', $users[2] ),
$this->not()->expectedField( 'customers.nodes.#.billing.email', 'example2@example.com' ),
];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assertion Six
*
* Tests "email" where argument.
*/
$variables = [ 'email' => 'gotcha@example.com' ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedField( 'customers.nodes.0.databaseId', $users[0] ),
$this->not()->expectedField( 'customers.nodes.#.databaseId', $users[1] ),
$this->not()->expectedField( 'customers.nodes.#.databaseId', $users[2] ),
$this->not()->expectedField( 'customers.nodes.#.databaseId', $users[3] ),
];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assertion Seven
*
* Tests "orderby" and "order" where arguments.
*/
$variables = [
'orderby' => 'USERNAME',
'order' => 'ASC',
];
$response = $this->graphql( compact( 'query', 'variables' ) );
$all_users = get_users(
[
'fields' => 'ID',
'role' => 'customer',
'orderby' => 'username',
'order' => 'ASC',
]
);
$expected = [];
foreach ( $all_users as $index => $user_id ) {
$expected[] = $this->expectedField(
"customers.nodes.{$index}.databaseId",
absint( $user_id )
);
}
$this->assertQuerySuccessful( $response, $expected );
}
public function testCustomerToOrdersConnection() {
$new_customer_id = $this->factory->customer->create();
$order_1 = $this->factory->order->createNew(
[ 'customer_id' => $this->customer ]
);
$order_2 = $this->factory->order->createNew(
[ 'customer_id' => $new_customer_id ]
);
$guest_customer = new \WC_Customer();
$guest_customer->set_billing_email( 'test@test.com' );
$order_3 = $this->factory->order->createNew(
[
'customer_id' => $guest_customer->get_id(),
'billing_email' => $guest_customer->get_billing_email(),
]
);
$query = '
query {
customer {
id
billing { email }
orders {
nodes {
databaseId
}
}
}
}
';
/**
* Assertion One
*
* Query for authenticated customer's orders.
*/
$this->loginAsCustomer();
$response = $this->graphql( compact( 'query' ) );
$expected = [
$this->expectedField( 'customer.orders.nodes.#.databaseId', $order_1 ),
];
$this->assertQuerySuccessful( $response, $expected );
// Clear customer cache.
$this->clearLoaderCache( 'wc_customer' );
/**
* Assertion Two
*
* Query for a guest's orders.
*/
$this->loginAs( 0 );
WC()->customer = $guest_customer;
$response = $this->graphql( compact( 'query' ) );
$expected = [
$this->expectedField( 'customer.orders.nodes.#.databaseId', $order_3 ),
];
$this->assertQuerySuccessful( $response, $expected );
}
public function testCustomerAvailablePaymentMethodsField() {
// Create customer.
$customer_id = $this->factory->customer->create();
// Create tokens.
$expiry_month = gmdate( 's', strtotime( 'now' ) );
$expiry_year = gmdate( 'Y', strtotime( '+1 year' ) );
$token_cc = $this->factory->payment_token->createCCToken(
$customer_id,
[
'last4' => 1234,
'expiry_month' => $expiry_month,
'expiry_year' => $expiry_year,
'card_type' => 'visa',
'token' => time(),
]
);
$token_ec = $this->factory->payment_token->createECheckToken(
$customer_id,
[
'last4' => 4567,
'token' => time(),
]
);
// Create query.
$query = '
query($id: ID) {
customer(id: $id) {
id
availablePaymentMethods {
id
tokenId
... on PaymentTokenCC {
last4
expiryMonth
expiryYear
cardType
}
... on PaymentTokenECheck {
last4
}
}
availablePaymentMethodsCC {
id
tokenId
last4
expiryMonth
expiryYear
cardType
}
availablePaymentMethodsEC {
id
tokenId
last4
}
}
}
';
/**
* Assert tokens are inaccessible as guest or admin
*/
$variables = [ 'id' => $this->toRelayId( 'user', $customer_id ) ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [ $this->expectedField( 'customer', static::IS_NULL ) ];
$this->assertQueryError( $response, $expected );
// Again, as admin.
$this->loginAsShopManager();
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedField( 'customer.id', $this->toRelayId( 'user', $customer_id ) ),
$this->expectedField( 'customer.availablePaymentMethods', static::IS_NULL ),
];
$this->assertQueryError( $response, $expected );
/**
* Assert customer can view their payment methods.
*/
$this->loginAs( $customer_id );
$response = $this->graphql( compact( 'query' ) );
$expected = [
$this->expectedField( 'customer.id', $this->toRelayId( 'user', $customer_id ) ),
$this->expectedNode(
'customer.availablePaymentMethods',
[
$this->expectedField( 'last4', 1234 ),
$this->expectedField( 'expiryMonth', $expiry_month ),
$this->expectedField( 'expiryYear', $expiry_year ),
$this->expectedField( 'cardType', 'visa' ),
]
),
$this->expectedNode(
'customer.availablePaymentMethodsCC',
[
$this->expectedField( 'last4', 1234 ),
$this->expectedField( 'expiryMonth', $expiry_month ),
$this->expectedField( 'expiryYear', $expiry_year ),
$this->expectedField( 'cardType', 'visa' ),
]
),
$this->expectedNode(
'customer.availablePaymentMethodsEC',
[
$this->not()->expectedField( 'last4', 1234 ),
$this->not()->expectedField( 'expiryMonth', $expiry_month ),
$this->not()->expectedField( 'expiryYear', $expiry_year ),
$this->not()->expectedField( 'cardType', 'visa' ),
]
),
$this->expectedNode(
'customer.availablePaymentMethods',
[
$this->expectedField( 'last4', 4567 ),
]
),
$this->expectedNode(
'customer.availablePaymentMethodsCC',
[
$this->not()->expectedField( 'last4', 4567 ),
]
),
$this->expectedNode(
'customer.availablePaymentMethodsEC',
[
$this->expectedField( 'last4', 4567 ),
]
),
];
$this->assertQuerySuccessful( $response, $expected );
}
public function testAuthorizingUrlFields() {
// Reinitialize WC session with QL_Session_Handler set.
add_filter(
'woocommerce_session_handler',
static function ( $session_class ) {
return '\WPGraphQL\WooCommerce\Utils\QL_Session_Handler';
}
);
\WC()->initialize_session();
// Create customer for later use.
$customer_id = $this->factory->customer->create();
// Create auth URLs query.
$query = '
query($id: ID) {
customer(id: $id) {
id
cartUrl
cartNonce
checkoutUrl
checkoutNonce
addPaymentMethodUrl
addPaymentMethodNonce
}
}
';
/**
* Assert NULL values when querying as admin
*/
$this->loginAsShopManager();
$variables = [ 'id' => $this->toRelayId( 'user', $customer_id ) ];
$response = $this->graphql( compact( 'query', 'variables' ) );
$expected = [
$this->expectedField( 'customer.id', $this->toRelayId( 'user', $customer_id ) ),
$this->expectedField( 'customer.cartUrl', static::IS_NULL ),
$this->expectedField( 'customer.cartNonce', static::IS_NULL ),
$this->expectedField( 'customer.checkoutUrl', static::IS_NULL ),
$this->expectedField( 'customer.checkoutNonce', static::IS_NULL ),
$this->expectedField( 'customer.addPaymentMethodUrl', static::IS_NULL ),
$this->expectedField( 'customer.addPaymentMethodNonce', static::IS_NULL ),
];
$this->assertQuerySuccessful( $response, $expected );
/**
* Assert NOT NULL values when querying as admin
*/
$this->loginAs( $customer_id );
$response = $this->graphql( compact( 'query' ) );
$expected = [
$this->expectedField( 'customer.id', $this->toRelayId( 'user', $customer_id ) ),
$this->expectedField( 'customer.cartUrl', static::NOT_NULL ),
$this->expectedField( 'customer.cartNonce', static::NOT_NULL ),
$this->expectedField( 'customer.checkoutUrl', static::NOT_NULL ),
$this->expectedField( 'customer.checkoutNonce', static::NOT_NULL ),
$this->expectedField( 'customer.addPaymentMethodUrl', static::NOT_NULL ),
$this->expectedField( 'customer.addPaymentMethodNonce', static::NOT_NULL ),
];
$this->assertQuerySuccessful( $response, $expected );
}
}