Files
medusa-store/packages/medusa/src/services/customer.ts
T

582 lines
17 KiB
TypeScript

import jwt from "jsonwebtoken"
import { isDefined, MedusaError } from "medusa-core-utils"
import Scrypt from "scrypt-kdf"
import {
DeepPartial,
EntityManager,
FindOperator,
FindOptionsWhere,
} from "typeorm"
import { EventBusService } from "."
import { StorePostCustomersCustomerAddressesAddressReq } from "../api"
import { TransactionBaseService } from "../interfaces"
import { Address, Customer, CustomerGroup } from "../models"
import { AddressRepository } from "../repositories/address"
import { CustomerRepository } from "../repositories/customer"
import {
AddressCreatePayload,
ExtendedFindConfig,
FindConfig,
Selector,
} from "../types/common"
import { CreateCustomerInput, UpdateCustomerInput } from "../types/customers"
import { buildQuery, setMetadata } from "../utils"
type InjectedDependencies = {
manager: EntityManager
eventBusService: EventBusService
customerRepository: typeof CustomerRepository
addressRepository: typeof AddressRepository
}
/**
* Provides layer to manipulate customers.
*/
class CustomerService extends TransactionBaseService {
protected readonly customerRepository_: typeof CustomerRepository
protected readonly addressRepository_: typeof AddressRepository
protected readonly eventBusService_: EventBusService
static Events = {
PASSWORD_RESET: "customer.password_reset",
CREATED: "customer.created",
UPDATED: "customer.updated",
}
constructor({
customerRepository,
eventBusService,
addressRepository,
}: InjectedDependencies) {
// eslint-disable-next-line prefer-rest-params
super(arguments[0])
this.customerRepository_ = customerRepository
this.eventBusService_ = eventBusService
this.addressRepository_ = addressRepository
}
/**
* Generate a JSON Web token, that will be sent to a customer, that wishes to
* reset password.
* The token will be signed with the customer's current password hash as a
* secret a long side a payload with userId and the expiry time for the token,
* which is always 15 minutes.
* @param {string} customerId - the customer to reset the password for
* @return {string} the generated JSON web token
*/
async generateResetPasswordToken(customerId: string): Promise<string> {
return await this.atomicPhase_(async (manager) => {
const customer = await this.retrieve(customerId, {
select: [
"id",
"has_account",
"password_hash",
"email",
"first_name",
"last_name",
],
})
if (!customer.has_account) {
throw new MedusaError(
MedusaError.Types.NOT_ALLOWED,
"You must have an account to reset the password. Create an account first"
)
}
const secret = customer.password_hash
const expiry = Math.floor(Date.now() / 1000) + 60 * 15 // 15 minutes ahead
const payload = { customer_id: customer.id, exp: expiry }
const token = jwt.sign(payload, secret)
// Notify subscribers
void this.eventBusService_
.withTransaction(manager)
.emit(CustomerService.Events.PASSWORD_RESET, {
id: customerId,
email: customer.email,
first_name: customer.first_name,
last_name: customer.last_name,
token,
})
return token
})
}
/**
* @param {Object} selector - the query object for find
* @param {Object} config - the config object containing query settings
* @return {Promise} the result of the find operation
*/
async list(
selector: Selector<Customer> & { q?: string; groups?: string[] } = {},
config: FindConfig<Customer> = { relations: [], skip: 0, take: 50 }
): Promise<Customer[]> {
const customerRepo = this.activeManager_.withRepository(
this.customerRepository_
)
let q
if ("q" in selector) {
q = selector.q
delete selector.q
}
const query = buildQuery<Selector<Customer>, Customer>(
selector,
config
) as ExtendedFindConfig<Customer> & {
where: FindOptionsWhere<
Customer | (Customer & { groups?: FindOperator<string[]> })
>
}
const [customers] = await customerRepo.listAndCount(query, q)
return customers
}
/**
* @param {Object} selector - the query object for find
* @param {FindConfig<Customer>} config - the config object containing query settings
* @return {Promise} the result of the find operation
*/
async listAndCount(
selector: Selector<Customer> & { q?: string; groups?: string[] },
config: FindConfig<Customer> = {
relations: [],
skip: 0,
take: 50,
order: { created_at: "DESC" },
}
): Promise<[Customer[], number]> {
const customerRepo = this.activeManager_.withRepository(
this.customerRepository_
)
let q
if ("q" in selector) {
q = selector.q
delete selector.q
}
const query = buildQuery(
selector,
config
) as ExtendedFindConfig<Customer> & {
where: FindOptionsWhere<
Customer | (Customer & { groups?: FindOperator<string[]> })
>
}
return await customerRepo.listAndCount(query, q)
}
/**
* Return the total number of documents in database
* @return {Promise} the result of the count operation
*/
async count(): Promise<number> {
const customerRepo = this.activeManager_.withRepository(
this.customerRepository_
)
return await customerRepo.count({})
}
private async retrieve_(
selector: Selector<Customer>,
config: FindConfig<Customer> = {}
): Promise<Customer | never> {
const customerRepo = this.activeManager_.withRepository(
this.customerRepository_
)
const query = buildQuery(selector, config)
const customer = await customerRepo.findOne(query)
if (!customer) {
const selectorConstraints = Object.entries(selector)
.map((key, value) => `${key}: ${value}`)
.join(", ")
throw new MedusaError(
MedusaError.Types.NOT_FOUND,
`Customer with ${selectorConstraints} was not found`
)
}
return customer
}
/**
* Gets a registered customer by email.
* @param {string} email - the email of the customer to get.
* @param {Object} config - the config object containing query settings
* @return {Promise<Customer>} the customer document.
* @deprecated
*/
async retrieveByEmail(
email: string,
config: FindConfig<Customer> = {}
): Promise<Customer | never> {
if (!isDefined(email)) {
throw new MedusaError(
MedusaError.Types.NOT_FOUND,
`"email" must be defined`
)
}
return await this.retrieve_({ email: email.toLowerCase() }, config)
}
async retrieveUnregisteredByEmail(
email: string,
config: FindConfig<Customer> = {}
): Promise<Customer | never> {
return await this.retrieve_(
{ email: email.toLowerCase(), has_account: false },
config
)
}
async retrieveRegisteredByEmail(
email: string,
config: FindConfig<Customer> = {}
): Promise<Customer | never> {
return await this.retrieve_(
{ email: email.toLowerCase(), has_account: true },
config
)
}
async listByEmail(
email: string,
config: FindConfig<Customer> = { relations: [], skip: 0, take: 2 }
): Promise<Customer[]> {
return await this.list({ email: email.toLowerCase() }, config)
}
/**
* Gets a customer by phone.
* @param {string} phone - the phone of the customer to get.
* @param {Object} config - the config object containing query settings
* @return {Promise<Customer>} the customer document.
*/
async retrieveByPhone(
phone: string,
config: FindConfig<Customer> = {}
): Promise<Customer | never> {
return await this.retrieve_({ phone }, config)
}
/**
* Gets a customer by id.
* @param {string} customerId - the id of the customer to get.
* @param {Object} config - the config object containing query settings
* @return {Promise<Customer>} the customer document.
*/
async retrieve(
customerId: string,
config: FindConfig<Customer> = {}
): Promise<Customer> {
if (!isDefined(customerId)) {
throw new MedusaError(
MedusaError.Types.NOT_FOUND,
`"customerId" must be defined`
)
}
return this.retrieve_({ id: customerId }, config)
}
/**
* Hashes a password
* @param {string} password - the value to hash
* @return {Promise<string>} hashed password
*/
async hashPassword_(password: string): Promise<string> {
const buf = await Scrypt.kdf(password, { logN: 1, r: 1, p: 1 })
return buf.toString("base64")
}
/**
* Creates a customer from an email - customers can have accounts associated,
* e.g. to login and view order history, etc. If a password is provided the
* customer will automatically get an account, otherwise the customer is just
* used to hold details of customers.
* @param {object} customer - the customer to create
* @return {Promise} the result of create
*/
async create(customer: CreateCustomerInput): Promise<Customer> {
return await this.atomicPhase_(async (manager) => {
const customerRepository = manager.withRepository(
this.customerRepository_
)
customer.email = customer.email.toLowerCase()
const { email, password } = customer
// should be a list of customers at this point
const existing = await this.listByEmail(email).catch(() => undefined)
// should validate that "existing.some(acc => acc.has_account) && password"
if (existing) {
if (existing.some((customer) => customer.has_account) && password) {
throw new MedusaError(
MedusaError.Types.DUPLICATE_ERROR,
"A customer with the given email already has an account. Log in instead"
)
} else if (
existing?.some((customer) => !customer.has_account) &&
!password
) {
throw new MedusaError(
MedusaError.Types.DUPLICATE_ERROR,
"Guest customer with email already exists"
)
}
}
if (password) {
const hashedPassword = await this.hashPassword_(password)
customer.password_hash = hashedPassword
customer.has_account = true
delete customer.password
}
const created = customerRepository.create(customer)
const result = await customerRepository.save(created)
await this.eventBusService_
.withTransaction(manager)
.emit(CustomerService.Events.CREATED, result)
return result
})
}
/**
* Updates a customer.
* @param {string} customerId - the id of the variant. Must be a string that
* can be casted to an ObjectId
* @param {object} update - an object with the update values.
* @return {Promise} resolves to the update result.
*/
async update(
customerId: string,
update: UpdateCustomerInput
): Promise<Customer> {
return await this.atomicPhase_(async (manager) => {
const customerRepository = manager.withRepository(
this.customerRepository_
)
const customer = await this.retrieve(customerId)
const {
password,
metadata,
billing_address,
billing_address_id,
groups,
...rest
} = update
if (metadata) {
customer.metadata = setMetadata(customer, metadata)
}
if ("billing_address_id" in update || "billing_address" in update) {
const address = billing_address_id || billing_address
if (isDefined(address)) {
await this.updateBillingAddress_(customer, address)
}
}
for (const [key, value] of Object.entries(rest)) {
customer[key] = value
}
if (password) {
customer.password_hash = await this.hashPassword_(password)
}
if (groups) {
customer.groups = groups as CustomerGroup[]
}
const updated = await customerRepository.save(customer)
await this.eventBusService_
.withTransaction(manager)
.emit(CustomerService.Events.UPDATED, updated)
return updated
})
}
/**
* Updates the customers' billing address.
* @param {Customer} customer - the Customer to update
* @param {Object|string} addressOrId - the value to set the billing address to
* @param {Object} addrRepo - address repository
* @return {Promise} the result of the update operation
*/
async updateBillingAddress_(
customer: Customer,
addressOrId: string | DeepPartial<Address> | undefined
): Promise<void> {
return await this.atomicPhase_(async (manager) => {
const addrRepo: typeof AddressRepository = manager.withRepository(
this.addressRepository_
)
if (addressOrId === null || addressOrId === undefined) {
customer.billing_address_id = null
return
}
let address: DeepPartial<Address>
if (typeof addressOrId === `string`) {
const fetchedAddress = await addrRepo.findOne({
where: { id: addressOrId },
})
if (!fetchedAddress) {
throw new MedusaError(
MedusaError.Types.NOT_FOUND,
`Address with id ${addressOrId} was not found`
)
}
address = fetchedAddress
} else {
address = addressOrId
}
address.country_code = address.country_code?.toLowerCase()
if (isDefined(address?.id)) {
customer.billing_address_id = address.id
} else {
if (customer.billing_address_id) {
const addr = await addrRepo.findOne({
where: { id: customer.billing_address_id },
})
await addrRepo.save({ ...addr, ...address })
} else {
const created = addrRepo.create(address)
const saved: Address = await addrRepo.save(created)
customer.billing_address = saved
}
}
})
}
async updateAddress(
customerId: string,
addressId: string,
address: StorePostCustomersCustomerAddressesAddressReq
): Promise<Address> {
return await this.atomicPhase_(async (manager) => {
const addressRepo = manager.withRepository(this.addressRepository_)
address.country_code = address.country_code?.toLowerCase()
const toUpdate = await addressRepo.findOne({
where: { id: addressId, customer_id: customerId },
})
if (!toUpdate) {
throw new MedusaError(
MedusaError.Types.INVALID_DATA,
"Could not find address for customer"
)
}
for (const [key, value] of Object.entries(address)) {
toUpdate[key] = value
}
return addressRepo.save(toUpdate)
})
}
async removeAddress(customerId: string, addressId: string): Promise<void> {
return await this.atomicPhase_(async (manager) => {
const addressRepo = manager.withRepository(this.addressRepository_)
// Should not fail, if user does not exist, since delete is idempotent
const address = await addressRepo.findOne({
where: { id: addressId, customer_id: customerId },
})
if (!address) {
return
}
await addressRepo.softRemove(address)
})
}
async addAddress(
customerId: string,
address: AddressCreatePayload
): Promise<Customer | Address> {
return await this.atomicPhase_(async (manager) => {
const addressRepository = manager.withRepository(this.addressRepository_)
address.country_code = address.country_code.toLowerCase()
const customer = await this.retrieve(customerId, {
relations: ["shipping_addresses"],
})
const shouldAdd = !customer.shipping_addresses.find(
(a) =>
a.country_code?.toLowerCase() ===
address.country_code.toLowerCase() &&
a.address_1 === address.address_1 &&
a.address_2 === address.address_2 &&
a.city === address.city &&
a.phone === address.phone &&
a.postal_code === address.postal_code &&
a.province === address.province &&
a.first_name === address.first_name &&
a.last_name === address.last_name
)
if (shouldAdd) {
const created = addressRepository.create({
...address,
customer_id: customerId,
})
const result = await addressRepository.save(created)
return result
} else {
return customer
}
})
}
/**
* Deletes a customer from a given customer id.
* @param {string} customerId - the id of the customer to delete. Must be
* castable as an ObjectId
* @return {Promise} the result of the delete operation.
*/
async delete(customerId: string): Promise<Customer | void> {
return await this.atomicPhase_(async (manager) => {
const customerRepo = manager.withRepository(this.customerRepository_)
// Should not fail, if user does not exist, since delete is idempotent
const customer = await customerRepo.findOne({ where: { id: customerId } })
if (!customer) {
return
}
return await customerRepo.softRemove(customer)
})
}
}
export default CustomerService