28 KiB
Class: CartService
Hierarchy
-
TransactionBaseService<CartService>↳
CartService
Constructors
constructor
• new CartService(__namedParameters)
Parameters
| Name | Type |
|---|---|
__namedParameters |
InjectedDependencies |
Overrides
TransactionBaseService<CartService>.constructor
Defined in
Properties
addressRepository_
• Protected Readonly addressRepository_: typeof AddressRepository
Defined in
cartRepository_
• Protected Readonly cartRepository_: typeof CartRepository
Defined in
configModule
• Protected Optional Readonly configModule: Record<string, unknown>
Inherited from
TransactionBaseService.configModule
container
• Protected Readonly container: unknown
Inherited from
TransactionBaseService.container
customShippingOptionService_
• Protected Readonly customShippingOptionService_: CustomShippingOptionService
Defined in
customerService_
• Protected Readonly customerService_: CustomerService
Defined in
discountService_
• Protected Readonly discountService_: DiscountService
Defined in
eventBus_
• Protected Readonly eventBus_: EventBusService
Defined in
giftCardService_
• Protected Readonly giftCardService_: GiftCardService
Defined in
inventoryService_
• Protected Readonly inventoryService_: InventoryService
Defined in
lineItemAdjustmentService_
• Protected Readonly lineItemAdjustmentService_: LineItemAdjustmentService
Defined in
lineItemRepository_
• Protected Readonly lineItemRepository_: typeof LineItemRepository
Defined in
lineItemService_
• Protected Readonly lineItemService_: LineItemService
Defined in
manager_
• Protected manager_: EntityManager
Overrides
TransactionBaseService.manager_
Defined in
paymentProviderService_
• Protected Readonly paymentProviderService_: PaymentProviderService
Defined in
paymentSessionRepository_
• Protected Readonly paymentSessionRepository_: typeof PaymentSessionRepository
Defined in
priceSelectionStrategy_
• Protected Readonly priceSelectionStrategy_: IPriceSelectionStrategy
Defined in
productService_
• Protected Readonly productService_: ProductService
Defined in
productVariantService_
• Protected Readonly productVariantService_: ProductVariantService
Defined in
regionService_
• Protected Readonly regionService_: RegionService
Defined in
shippingMethodRepository_
• Protected Readonly shippingMethodRepository_: typeof ShippingMethodRepository
Defined in
shippingOptionService_
• Protected Readonly shippingOptionService_: ShippingOptionService
Defined in
taxProviderService_
• Protected Readonly taxProviderService_: TaxProviderService
Defined in
totalsService_
• Protected Readonly totalsService_: TotalsService
Defined in
transactionManager_
• Protected transactionManager_: undefined | EntityManager
Overrides
TransactionBaseService.transactionManager_
Defined in
Events
▪ Static Readonly Events: Object
Type declaration
| Name | Type |
|---|---|
CREATED |
string |
CUSTOMER_UPDATED |
string |
UPDATED |
string |
Defined in
Methods
addLineItem
▸ addLineItem(cartId, lineItem): Promise<Cart>
Adds a line item to the cart.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart that we will add to |
lineItem |
LineItem |
the line item to add. |
Returns
Promise<Cart>
the result of the update operation
Defined in
addShippingMethod
▸ addShippingMethod(cartId, optionId, data?): Promise<Cart>
Adds the shipping method to the list of shipping methods associated with the cart. Shipping Methods are the ways that an order is shipped, whereas a Shipping Option is a possible way to ship an order. Shipping Methods may also have additional details in the data field such as an id for a package shop.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to add shipping method to |
optionId |
string |
id of shipping option to add as valid method |
data |
Record<string, unknown> |
the fulmillment data for the method |
Returns
Promise<Cart>
the result of the update operation
Defined in
adjustFreeShipping_
▸ Protected adjustFreeShipping_(cart, shouldAdd): Promise<void>
Ensures shipping total on cart is correct in regards to a potential free shipping discount If a free shipping is present, we set shipping methods price to 0 if a free shipping was present, we set shipping methods to original amount
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
the the cart to adjust free shipping for |
shouldAdd |
boolean |
flag to indicate, if we should add or remove |
Returns
Promise<void>
void
Defined in
applyDiscount
▸ applyDiscount(cart, discountCode): Promise<void>
Updates the cart's discounts. If discount besides free shipping is already applied, this will be overwritten Throws if discount regions does not include the cart region
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
the cart to update |
discountCode |
string |
the discount code |
Returns
Promise<void>
the result of the update operation
Defined in
applyGiftCard_
▸ Protected applyGiftCard_(cart, code): Promise<void>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
code |
string |
Returns
Promise<void>
Defined in
atomicPhase_
▸ Protected atomicPhase_<TResult, TError>(work, isolationOrErrorHandler?, maybeErrorHandlerOrDontFail?): Promise<TResult>
Wraps some work within a transactional block. If the service already has a transaction manager attached this will be reused, otherwise a new transaction manager is created.
Type parameters
| Name |
|---|
TResult |
TError |
Parameters
| Name | Type | Description |
|---|---|---|
work |
(transactionManager: EntityManager) => Promise<TResult> |
the transactional work to be done |
isolationOrErrorHandler? |
IsolationLevel | (error: TError) => Promise<void | TResult> |
the isolation level to be used for the work. |
maybeErrorHandlerOrDontFail? |
(error: TError) => Promise<void | TResult> |
Potential error handler |
Returns
Promise<TResult>
the result of the transactional work
Inherited from
TransactionBaseService.atomicPhase_
Defined in
interfaces/transaction-base-service.ts:53
authorizePayment
▸ authorizePayment(cartId, context?): Promise<Cart>
Authorizes a payment for a cart. Will authorize with chosen payment provider. This will return a payment object, that we will use to update our cart payment with. Additionally, if the payment does not require more or fails, we will set the payment on the cart.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to authorize payment for |
context |
Record<string, unknown> |
object containing whatever is relevant for authorizing the payment with the payment provider. As an example, this could be IP address or similar for fraud handling. |
Returns
Promise<Cart>
the resulting cart
Defined in
create
▸ create(data): Promise<Cart>
Creates a cart.
Parameters
| Name | Type | Description |
|---|---|---|
data |
CartCreateProps |
the data to create the cart with |
Returns
Promise<Cart>
the result of the create operation
Defined in
createOrFetchUserFromEmail_
▸ Protected createOrFetchUserFromEmail_(email): Promise<Customer>
Creates or fetches a user based on an email.
Parameters
| Name | Type | Description |
|---|---|---|
email |
string |
the email to use |
Returns
Promise<Customer>
the resultign customer object
Defined in
createTaxLines
▸ createTaxLines(id): Promise<Cart>
Parameters
| Name | Type |
|---|---|
id |
string |
Returns
Promise<Cart>
Defined in
decorateTotals_
▸ Protected decorateTotals_(cart, totalsToSelect, options?): Promise<Cart>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
totalsToSelect |
TotalField[] |
options |
TotalsConfig |
Returns
Promise<Cart>
Defined in
delete
▸ delete(cartId): Promise<Cart>
Deletes a cart from the database. Completed carts cannot be deleted.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to delete |
Returns
Promise<Cart>
the deleted cart or undefined if the cart was not found.
Defined in
deleteMetadata
▸ deleteMetadata(cartId, key): Promise<Cart>
Dedicated method to delete metadata for a cart.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the cart to delete metadata from. |
key |
string |
key for metadata field |
Returns
Promise<Cart>
resolves to the updated result.
Defined in
deletePaymentSession
▸ deletePaymentSession(cartId, providerId): Promise<Cart>
Removes a payment session from the cart.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to remove from |
providerId |
string |
the id of the provider whoose payment session should be removed. |
Returns
Promise<Cart>
the resulting cart.
Defined in
findCustomShippingOption
▸ findCustomShippingOption(cartCustomShippingOptions, optionId): undefined | CustomShippingOption
Finds the cart's custom shipping options based on the passed option id. throws if custom options is not empty and no shipping option corresponds to optionId
Parameters
| Name | Type | Description |
|---|---|---|
cartCustomShippingOptions |
CustomShippingOption[] |
the cart's custom shipping options |
optionId |
string |
id of the normal or custom shipping option to find in the cartCustomShippingOptions |
Returns
undefined | CustomShippingOption
custom shipping option
Defined in
list
▸ list(selector, config?): Promise<Cart[]>
Parameters
| Name | Type | Description |
|---|---|---|
selector |
FilterableCartProps |
the query object for find |
config |
FindConfig<Cart> |
config object |
Returns
Promise<Cart[]>
the result of the find operation
Defined in
refreshAdjustments_
▸ Protected refreshAdjustments_(cart): Promise<void>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
Returns
Promise<void>
Defined in
refreshPaymentSession
▸ refreshPaymentSession(cartId, providerId): Promise<Cart>
Refreshes a payment session on a cart
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to remove from |
providerId |
string |
the id of the provider whoose payment session should be removed. |
Returns
Promise<Cart>
the resulting cart.
Defined in
removeDiscount
▸ removeDiscount(cartId, discountCode): Promise<Cart>
Removes a discount based on a discount code.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to remove from |
discountCode |
string |
the discount code to remove |
Returns
Promise<Cart>
the resulting cart
Defined in
removeLineItem
▸ removeLineItem(cartId, lineItemId): Promise<Cart>
Removes a line item from the cart.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart that we will remove from |
lineItemId |
string |
the line item to remove. |
Returns
Promise<Cart>
the result of the update operation
Defined in
retrieve
▸ retrieve(cartId, options?, totalsConfig?): Promise<Cart>
Gets a cart by id.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to get. |
options |
FindConfig<Cart> |
the options to get a cart |
totalsConfig |
TotalsConfig |
configuration for retrieval of totals |
Returns
Promise<Cart>
the cart document.
Defined in
setMetadata
▸ setMetadata(cartId, key, value): Promise<Cart>
Dedicated method to set metadata for a cart. To ensure that plugins does not overwrite each others metadata fields, setMetadata is provided.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the cart to apply metadata to. |
key |
string |
key for metadata field |
value |
string | number |
value for metadata field. |
Returns
Promise<Cart>
resolves to the updated result.
Defined in
setPaymentSession
▸ setPaymentSession(cartId, providerId): Promise<Cart>
Sets a payment method for a cart.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to add payment method to |
providerId |
string |
the id of the provider to be set to the cart |
Returns
Promise<Cart>
result of update operation
Defined in
setPaymentSessions
▸ setPaymentSessions(cartOrCartId): Promise<void>
Creates, updates and sets payment sessions associated with the cart. The first time the method is called payment sessions will be created for each provider. Additional calls will ensure that payment sessions have correct amounts, currencies, etc. as well as make sure to filter payment sessions that are not available for the cart's region.
Parameters
| Name | Type | Description |
|---|---|---|
cartOrCartId |
string | Cart |
the id of the cart to set payment session for |
Returns
Promise<void>
the result of the update operation.
Defined in
setRegion_
▸ Protected setRegion_(cart, regionId, countryCode): Promise<void>
Set's the region of a cart.
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
the cart to set region on |
regionId |
string |
the id of the region to set the region to |
countryCode |
null | string |
the country code to set the country to |
Returns
Promise<void>
the result of the update operation
Defined in
shouldRetryTransaction_
▸ Protected shouldRetryTransaction_(err): boolean
Parameters
| Name | Type |
|---|---|
err |
Record<string, unknown> | { code: string } |
Returns
boolean
Inherited from
TransactionBaseService.shouldRetryTransaction_
Defined in
interfaces/transaction-base-service.ts:34
transformQueryForTotals_
▸ Protected transformQueryForTotals_(config): FindConfig<Cart> & { totalsToSelect: TotalField[] }
Parameters
| Name | Type |
|---|---|
config |
FindConfig<Cart> |
Returns
FindConfig<Cart> & { totalsToSelect: TotalField[] }
Defined in
update
▸ update(cartId, data): Promise<Cart>
Parameters
| Name | Type |
|---|---|
cartId |
string |
data |
CartUpdateProps |
Returns
Promise<Cart>
Defined in
updateBillingAddress_
▸ Protected updateBillingAddress_(cart, addressOrId, addrRepo): Promise<void>
Updates the cart's billing address.
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
the cart to update |
addressOrId |
string | AddressPayload | Partial<Address> |
the value to set the billing address to |
addrRepo |
AddressRepository |
the repository to use for address updates |
Returns
Promise<void>
the result of the update operation
Defined in
updateCustomerId_
▸ Protected updateCustomerId_(cart, customerId): Promise<void>
Sets the customer id of a cart
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
the cart to add email to |
customerId |
string |
the customer to add to cart |
Returns
Promise<void>
the result of the update operation
Defined in
updateLineItem
▸ updateLineItem(cartId, lineItemId, lineItemUpdate): Promise<Cart>
Updates a cart's existing line item.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to update |
lineItemId |
string |
the id of the line item to update. |
lineItemUpdate |
LineItemUpdate |
the line item to update. Must include an id field. |
Returns
Promise<Cart>
the result of the update operation
Defined in
updatePaymentSession
▸ updatePaymentSession(cartId, update): Promise<Cart>
Updates the currently selected payment session.
Parameters
| Name | Type | Description |
|---|---|---|
cartId |
string |
the id of the cart to update the payment session for |
update |
object |
the data to update the payment session with |
Returns
Promise<Cart>
the resulting cart
Defined in
updateShippingAddress_
▸ Protected updateShippingAddress_(cart, addressOrId, addrRepo): Promise<void>
Updates the cart's shipping address.
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
the cart to update |
addressOrId |
string | AddressPayload | Partial<Address> |
the value to set the shipping address to |
addrRepo |
AddressRepository |
the repository to use for address updates |
Returns
Promise<void>
the result of the update operation
Defined in
updateUnitPrices_
▸ Protected updateUnitPrices_(cart, regionId?, customer_id?): Promise<void>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
regionId? |
string |
customer_id? |
string |
Returns
Promise<void>
Defined in
validateLineItemShipping_
▸ Protected validateLineItemShipping_(shippingMethods, lineItem): boolean
Checks if a given line item has a shipping method that can fulfill it. Returns true if all products in the cart can be fulfilled with the current shipping methods.
Parameters
| Name | Type | Description |
|---|---|---|
shippingMethods |
ShippingMethod[] |
the set of shipping methods to check from |
lineItem |
LineItem |
the line item |
Returns
boolean
boolean representing wheter shipping method is validated
Defined in
withTransaction
▸ withTransaction(transactionManager?): CartService
Parameters
| Name | Type |
|---|---|
transactionManager? |
EntityManager |
Returns
Inherited from
TransactionBaseService.withTransaction