Vue Storefront is now Alokai! Learn More
Customer normalizer

Customer normalizer

The normalizeCustomer function is used to map a BigCommerce Customer into the unified SfCustomer data model.

Parameters

NameTypeDefault valueDescription
contextNormalizerContextContext which contains e.g. currency
customerCustomerBigCommerce Customer

Extending

The SfCustomer model is returned from Unified Methods such as RegisterCustomer, LoginCustomer and GetCustomer. If the SfCustomer structure doesn't contain the information you need for your Storefront, you can extend its logic using the addCustomFields API. The following example demonstrates how to extend SfCustomer with a company field.

export const unifiedApiExtension = createUnifiedExtension({
  normalizers: {
    addCustomFields: [
      {
        normalizeCustomer: (context, customer) => ({
          company: customer.company,
        }),
      },
    ],
  },
  config: {
    ...
  },
});

Source

customer.ts
import { defineNormalizer } from "../defineNormalizer";

export const normalizeCustomer = defineNormalizer.normalizeCustomer((context, user) => {
  if (!user.id) {
    throw new Error("User id is required");
  }

  return {
    id: user.id.toString(),
    firstName: user.first_name,
    lastName: user.last_name,
    email: user.email,
  };
});