User auth functions

confirmEmail

The confirmEmail function uses the supplied customerEmail and customerConfirmationKey parameters to complete the customer activation process. Adobe Commerce sends the confirmation key to the customer when they request to create an account. The function calls the confirmEmail mutation.

confirmEmail({
  customerEmail: string,
  customerConfirmationKey: string,
});

Returns

Returns a promise that resolves to a confirmEmailProps object.

Usage

import { confirmEmail } from '@/auth/api/confirmEmail';

confirmEmail({
  customerEmail: 'abc@example.com',
  customerConfirmationKey: '1234567890',
});

createCustomer

The createCustomer function creates a customer account based on the data supplied in the forms parameter. By default, the function uses the createCustomer mutation. If the apiVersion2 parameter is set to true, the function uses the createCustomerV2 mutation.

createCustomer(forms: Customer; apiVersion2: boolean);

Customer contains the following properties:

export interface Customer {
  firstname: string;
  lastname: string;
  email: string;
  is_subscribed: boolean;

  custom_attributes?: Record<string, string>[];
}

Returns

Returns a promise that resolves to a CreateCustomerDataResponse object.

Usage

import { createCustomer } from '@/auth/api/createCustomer';

createCustomer( forms:{
  allow_remote_shopping_assistance: true,
  date_of_birth: "1990-01-01",
  email: "john.doe@example.com",
  firstname: "John",
  is_subscribed: true,
  lastname: "Doe",
  middlename: "",
  password: "Password123",
  prefix: "",
  suffix: "",
  taxvat: "",
}, apiVersion2: true);

createCustomerAddress

The createCustomerAddress function defines a new customer address. The customer can subseqently designate the address for billing or shipping orders. The function calls the createCustomerAddress mutation.

createCustomerAddress (address: AddressFormProps);

AddressFormProps contains the following properties:

export interface AddressFormProps {
  region: Region;
  city: string;
  company: string;
  country_code: string;
  country_id: string;
  custom_attributes: CustomAttributes[];
  custom_attributesV2: CustomAttributesV2[];
  default_billing?: boolean;
  default_shipping?: boolean;
  fax: string;
  firstname: string;
  lastname: string;
  middlename: string;
  postcode: string;
  prefix: string;
  street: string[];
  suffix: string;
  telephone: string;
  vat_id: string;
}

Returns

Returns a promise that resolves to a CreateCustomerAddressResponse object.

Usage

import { createCustomerAddress } from '@/auth/api/createCustomerAddress';

createCustomerAddress(address: {
  "city": "Phoenix",
  "country_code": "US",
  "default_billing": true,
  "default_shipping": false,
  "firstname": "Bob",
  "lastname": "Loblaw",
  "postcode": "77777",
  "region": {
    "region": "Arizona",
    "region_code": "AZ",
  },
  "street": ["123 Main St"],
  "telephone": "555 555-5555",
});

getAttributesForm

The getAttributesForm function uses the attributesForm query to retrieve EAV attributes associated with customer and customer address frontend forms. The function calls the attributesForm query.

getAttributesForm(formCode: string);

Returns

Returns a promise that resolves to an AttributesFormModel object.

Usage

import { getAttributesForm } from '@/auth/api/getAttributesForm';

getAttributesForm(formCode: "customer_account_create");

getCustomerData

The getCustomerData function retrieves data about the customer represented by the value of the auth_dropin_user_token parameter. The function calls the customer query.

getCustomerData(auth_dropin_user_token: string);

Returns

Returns a promise that resolves to a CustomerDataModel object.

Usage

import { getCustomerData } from '@/auth/api/getCustomerData';

getCustomerData(auth_dropin_user_token: "abcdefghi12345");

getCustomerToken

The getCustomerToken function handles the sign-in operation. It requires userName and password parameters and performs the following actions under the hood:

1. Retrieves the customer token.

2. Fetches customer data using the token.

3. Sets the auth_dropin_firstname and auth_dropin_user_token cookies.

4. Publishes an Adobe Client Data Layer (ACDL) event.

5. Emits an “authenticated” event.

You can use the getCustomerToken function to build a custom authentication flow that remains fully integrated with other dropin-in components.

The function calls the generateCustomerToken mutation.

getCustomerToken(
  {
    email: string,
    password: string,
    handleSetInLineAlertProps: (value?: inLineAlertInterface) => void;
    translations: Record<string, string>;
    onErrorCallback?: (value?: unknown) => void;
  },
);

Returns

getCustomerTokenProps

Usage

import { getCustomerToken } from '@/auth/api/getCustomerToken';

getCustomerToken(email: "abc@example.com", password: "MyBadPassword");

getStoreConfig

The getStoreConfig function uses the storeConfig query to retrieve store configuration data.

getStoreConfig();

Returns

Returns a promise that resolves to a StoreConfigModel object.

Usage

import { getStoreConfig } from '@/auth/api/getStoreConfig';

getStoreConfig();

requestPasswordResetEmail

The requestPasswordResetEmail function initiates the process of resetting a customer’s password. The function calls the requestPasswordResetEmail mutation.

requestPasswordResetEmail(email: string);

Returns

Returns a promise that resolves to a PasswordResetEmailModel object.

Usage

import { requestPasswordResetEmail } from '@/auth/api/requestPasswordResetEmail';

requestPasswordResetEmail(email: "abc@example.com");

resendConfirmationEmail

The resendConfirmationEmail function resends the email confirmation to the customer using the supplied customerEmail parameter. The function calls the resendConfirmationEmail mutation, which is included in the Storefront Compatability Package.

resendConfirmationEmail(customerEmail:string);

Returns

Returns a promise that resolves to a resendConfirmationEmailResponse object.

Usage

import { resendConfirmationEmail } from '@/auth/api/resendConfirmationEmail';

resendConfirmationEmail(customerEmail:"abc@example.com");

resetPassword

The resetPassword function resets a customer’s password using the supplied email, resetPasswordToken, and newPassword parameters. The function calls the resetPassword mutation.

resetPassword (email: string, resetPasswordToken: string, newPassword: string);

Returns

Returns a promise that resolves to a ResetPasswordModel object.

Usage

import { resetPassword } from '@/auth/api/resetPassword';

resetPassword(
    email: "abc@example.com",
    resetPasswordToken: "gh80pkjGdsPyiXc0sUUXswX1uGN7crUr",
    newPassword: "ThisNewPasswordIsSomewhatBetter");

revokeCustomerToken

The revokeCustomerToken function revokes the customer’s token and clears cookie. It then publishes an ACDL event and emits an “authenticated” event.

This API can also be used to build a custom sign-out flow that stays fully integrated with other dropin-in components.

The function calls the revokeCustomerToken mutation.

revokeCustomerToken();

Returns

Returns a promise that resolves to a RevokeCustomerTokenModel object.

Usage

import { revokeCustomerToken } from '@/auth/api/revokeCustomerToken';

revokeCustomerToken();