074055acbb
Co-authored-by: shahednasser <shahednasser@users.noreply.github.com> Co-authored-by: Shahed Nasser <shahednasser@gmail.com>
37 KiB
Class: CartService
Hierarchy
-
TransactionBaseService↳
CartService
Constructors
constructor
• new CartService(«destructured»)
Parameters
| Name | Type |
|---|---|
«destructured» |
InjectedDependencies |
Overrides
TransactionBaseService.constructor
Defined in
medusa/src/services/cart.ts:143
Properties
__configModule__
• Protected Optional Readonly __configModule__: Record<string, unknown>
Inherited from
TransactionBaseService.__configModule__
Defined in
medusa/src/interfaces/transaction-base-service.ts:14
__container__
• Protected Readonly __container__: any
Inherited from
TransactionBaseService.__container__
Defined in
medusa/src/interfaces/transaction-base-service.ts:13
__moduleDeclaration__
• Protected Optional Readonly __moduleDeclaration__: Record<string, unknown>
Inherited from
TransactionBaseService.__moduleDeclaration__
Defined in
medusa/src/interfaces/transaction-base-service.ts:15
addressRepository_
• Protected Readonly addressRepository_: Repository<Address>
Defined in
medusa/src/services/cart.ts:116
cartRepository_
• Protected Readonly cartRepository_: Repository<Cart> & { findOneWithRelations: (relations: FindOptionsRelations<Cart>, optionsWithoutRelations: Omit<FindManyOptions<Cart>, "relations">) => Promise<Cart> ; findWithRelations: (relations: FindOptionsRelations<Cart>, optionsWithoutRelations: Omit<FindManyOptions<Cart>, "relations">) => Promise<Cart[]> }
Defined in
medusa/src/services/cart.ts:115
customShippingOptionService_
• Protected Readonly customShippingOptionService_: CustomShippingOptionService
Defined in
medusa/src/services/cart.ts:135
customerService_
• Protected Readonly customerService_: CustomerService
Defined in
medusa/src/services/cart.ts:127
discountService_
• Protected Readonly discountService_: DiscountService
Defined in
medusa/src/services/cart.ts:130
eventBus_
• Protected Readonly eventBus_: EventBusService
Defined in
medusa/src/services/cart.ts:119
featureFlagRouter_
• Protected Readonly featureFlagRouter_: FlagRouter
Defined in
medusa/src/services/cart.ts:138
giftCardService_
• Protected Readonly giftCardService_: GiftCardService
Defined in
medusa/src/services/cart.ts:131
lineItemAdjustmentService_
• Protected Readonly lineItemAdjustmentService_: LineItemAdjustmentService
Defined in
medusa/src/services/cart.ts:137
lineItemRepository_
• Protected Readonly lineItemRepository_: Repository<LineItem> & { findByReturn: (returnId: string) => Promise<LineItem & { return_item: ReturnItem }[]> }
Defined in
medusa/src/services/cart.ts:118
lineItemService_
• Protected Readonly lineItemService_: LineItemService
Defined in
medusa/src/services/cart.ts:125
manager_
• Protected manager_: EntityManager
Inherited from
TransactionBaseService.manager_
Defined in
medusa/src/interfaces/transaction-base-service.ts:5
newTotalsService_
• Protected Readonly newTotalsService_: NewTotalsService
Defined in
medusa/src/services/cart.ts:134
paymentProviderService_
• Protected Readonly paymentProviderService_: PaymentProviderService
Defined in
medusa/src/services/cart.ts:126
paymentSessionRepository_
• Protected Readonly paymentSessionRepository_: Repository<PaymentSession>
Defined in
medusa/src/services/cart.ts:117
priceSelectionStrategy_
• Protected Readonly priceSelectionStrategy_: IPriceSelectionStrategy
Defined in
medusa/src/services/cart.ts:136
pricingService_
• Protected Readonly pricingService_: PricingService
Defined in
medusa/src/services/cart.ts:141
productService_
• Protected Readonly productService_: ProductService
Defined in
medusa/src/services/cart.ts:121
productVariantInventoryService_
• Protected Readonly productVariantInventoryService_: ProductVariantInventoryService
Defined in
medusa/src/services/cart.ts:140
productVariantService_
• Protected Readonly productVariantService_: ProductVariantService
Defined in
medusa/src/services/cart.ts:120
regionService_
• Protected Readonly regionService_: RegionService
Defined in
medusa/src/services/cart.ts:124
salesChannelService_
• Protected Readonly salesChannelService_: SalesChannelService
Defined in
medusa/src/services/cart.ts:123
shippingMethodRepository_
• Protected Readonly shippingMethodRepository_: Repository<ShippingMethod>
Defined in
medusa/src/services/cart.ts:114
shippingOptionService_
• Protected Readonly shippingOptionService_: ShippingOptionService
Defined in
medusa/src/services/cart.ts:128
shippingProfileService_
• Protected Readonly shippingProfileService_: ShippingProfileService
Defined in
medusa/src/services/cart.ts:129
storeService_
• Protected Readonly storeService_: StoreService
Defined in
medusa/src/services/cart.ts:122
taxProviderService_
• Protected Readonly taxProviderService_: TaxProviderService
Defined in
medusa/src/services/cart.ts:132
totalsService_
• Protected Readonly totalsService_: TotalsService
Defined in
medusa/src/services/cart.ts:133
transactionManager_
• Protected transactionManager_: undefined | EntityManager
Inherited from
TransactionBaseService.transactionManager_
Defined in
medusa/src/interfaces/transaction-base-service.ts:6
Events
▪ Static Readonly Events: Object
Type declaration
| Name | Type |
|---|---|
CREATED |
string |
CUSTOMER_UPDATED |
string |
UPDATED |
string |
Defined in
medusa/src/services/cart.ts:108
Accessors
activeManager_
• Protected get activeManager_(): EntityManager
Returns
EntityManager
Inherited from
TransactionBaseService.activeManager_
Defined in
medusa/src/interfaces/transaction-base-service.ts:8
Methods
addLineItem
▸ addLineItem(cartId, lineItem, config?): Promise<void>
Adds a line item to the cart.
Parameters
| Name | Type | Default value | Description |
|---|---|---|---|
cartId |
string |
undefined |
the id of the cart that we will add to |
lineItem |
LineItem |
undefined |
the line item to add. |
config |
Object |
undefined |
validateSalesChannels - should check if product belongs to the same sales channel as cart (if cart has associated sales channel) |
config.validateSalesChannels |
boolean |
true |
- |
Returns
Promise<void>
the result of the update operation
Deprecated
Use addOrUpdateLineItems instead.
Defined in
medusa/src/services/cart.ts:654
addOrUpdateLineItems
▸ addOrUpdateLineItems(cartId, lineItems, config?): Promise<void>
Adds or update one or multiple line items to the cart. It also update all existing items in the cart to have has_shipping to false. Finally, the adjustments will be updated.
Parameters
| Name | Type | Default value | Description |
|---|---|---|---|
cartId |
string |
undefined |
the id of the cart that we will add to |
lineItems |
LineItem | LineItem[] |
undefined |
the line items to add. |
config |
Object |
undefined |
validateSalesChannels - should check if product belongs to the same sales channel as cart (if cart has associated sales channel) |
config.validateSalesChannels |
boolean |
true |
- |
Returns
Promise<void>
the result of the update operation
Defined in
medusa/src/services/cart.ts:794
addShippingMethod
▸ addShippingMethod(cartOrId, 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 |
|---|---|---|
cartOrId |
string | Cart |
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
medusa/src/services/cart.ts:2179
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 cart to adjust free shipping for |
shouldAdd |
boolean |
flag to indicate, if we should add or remove |
Returns
Promise<void>
void
Defined in
medusa/src/services/cart.ts:1113
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>
Defined in
medusa/src/services/cart.ts:1524
applyDiscounts
▸ applyDiscounts(cart, discountCodes): 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 |
discountCodes |
string[] |
the discount code(s) to apply |
Returns
Promise<void>
Defined in
medusa/src/services/cart.ts:1536
applyGiftCard_
▸ Protected applyGiftCard_(cart, code): Promise<void>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
code |
string |
Returns
Promise<void>
Defined in
medusa/src/services/cart.ts:1489
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
medusa/src/interfaces/transaction-base-service.ts:56
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> & { cart_id: string } |
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
medusa/src/services/cart.ts:1703
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
medusa/src/services/cart.ts:352
createOrFetchGuestCustomerFromEmail_
▸ Protected createOrFetchGuestCustomerFromEmail_(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
medusa/src/services/cart.ts:1375
createTaxLines
▸ createTaxLines(cartOrId): Promise<void>
Parameters
| Name | Type |
|---|---|
cartOrId |
string | Cart |
Returns
Promise<void>
Defined in
medusa/src/services/cart.ts:2630
decorateTotals
▸ decorateTotals(cart, totalsConfig?): Promise<WithRequiredProperty<Cart, "total">>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
totalsConfig |
TotalsConfig |
Returns
Promise<WithRequiredProperty<Cart, "total">>
Defined in
medusa/src/services/cart.ts:2682
decorateTotals_
▸ Protected decorateTotals_(cart, totalsToSelect, options?): Promise<Cart>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
totalsToSelect |
TotalField[] |
options |
TotalsConfig |
Returns
Promise<Cart>
Deprecated
Use decorateTotals instead
Defined in
medusa/src/services/cart.ts:2857
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
medusa/src/services/cart.ts:2549
deletePaymentSession
▸ deletePaymentSession(cartId, providerId): Promise<void>
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 whose payment session should be removed. |
Returns
Promise<void>
the resulting cart.
Defined in
medusa/src/services/cart.ts:2072
deleteTaxLines
▸ deleteTaxLines(id): Promise<void>
Parameters
| Name | Type |
|---|---|
id |
string |
Returns
Promise<void>
Defined in
medusa/src/services/cart.ts:2662
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
medusa/src/services/cart.ts:2312
getTotalsRelations
▸ Private getTotalsRelations(config): string[]
Parameters
| Name | Type |
|---|---|
config |
FindConfig<Cart> |
Returns
string[]
Defined in
medusa/src/services/cart.ts:2908
getValidatedSalesChannel
▸ Protected getValidatedSalesChannel(salesChannelId?): Promise<SalesChannel>
Parameters
| Name | Type |
|---|---|
salesChannelId? |
string |
Returns
Promise<SalesChannel>
Defined in
medusa/src/services/cart.ts:490
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
medusa/src/services/cart.ts:209
onSalesChannelChange
▸ Protected onSalesChannelChange(cart, newSalesChannelId): Promise<void>
Remove the cart line item that does not belongs to the newly assigned sales channel
Parameters
| Name | Type | Description |
|---|---|---|
cart |
Cart |
The cart being updated |
newSalesChannelId |
string |
The new sales channel being assigned to the cart |
Returns
Promise<void>
void
Defined in
medusa/src/services/cart.ts:1321
refreshAdjustments_
▸ Protected refreshAdjustments_(cart): Promise<void>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
Returns
Promise<void>
Defined in
medusa/src/services/cart.ts:2781
refreshPaymentSession
▸ refreshPaymentSession(cartId, providerId): Promise<void>
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 whose payment session should be removed. |
Returns
Promise<void>
the resulting cart.
Defined in
medusa/src/services/cart.ts:2124
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
medusa/src/services/cart.ts:1614
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
medusa/src/services/cart.ts:522
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 |
Returns
Promise<Cart>
the cart document.
Defined in
medusa/src/services/cart.ts:226
retrieveLegacy
▸ Protected retrieveLegacy(cartId, options?, totalsConfig?): Promise<Cart>
Parameters
| Name | Type |
|---|---|
cartId |
string |
options |
FindConfig<Cart> |
totalsConfig |
TotalsConfig |
Returns
Promise<Cart>
Deprecated
Defined in
medusa/src/services/cart.ts:289
retrieveWithTotals
▸ retrieveWithTotals(cartId, options?, totalsConfig?): Promise<WithRequiredProperty<Cart, "total">>
Parameters
| Name | Type |
|---|---|
cartId |
string |
options |
FindConfig<Cart> |
totalsConfig |
TotalsConfig |
Returns
Promise<WithRequiredProperty<Cart, "total">>
Defined in
medusa/src/services/cart.ts:317
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
medusa/src/services/cart.ts:2590
setPaymentSession
▸ setPaymentSession(cartId, providerId): Promise<void>
Selects a payment session for a cart and creates a payment object in the external provider system
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<void>
Defined in
medusa/src/services/cart.ts:1777
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
medusa/src/services/cart.ts:1893
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
medusa/src/services/cart.ts:2410
shouldRetryTransaction_
▸ Protected shouldRetryTransaction_(err): boolean
Parameters
| Name | Type |
|---|---|
err |
Record<string, unknown> | { code: string } |
Returns
boolean
Inherited from
TransactionBaseService.shouldRetryTransaction_
Defined in
medusa/src/interfaces/transaction-base-service.ts:37
transformQueryForTotals_
▸ Protected transformQueryForTotals_(config): FindConfig<Cart> & { totalsToSelect: TotalField[] }
Parameters
| Name | Type |
|---|---|
config |
FindConfig<Cart> |
Returns
FindConfig<Cart> & { totalsToSelect: TotalField[] }
Defined in
medusa/src/services/cart.ts:2799
update
▸ update(cartOrId, data): Promise<Cart>
Parameters
| Name | Type |
|---|---|
cartOrId |
string | Cart |
data |
CartUpdateProps |
Returns
Promise<Cart>
Defined in
medusa/src/services/cart.ts:1154
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 |
Repository<Address> |
the repository to use for address updates |
Returns
Promise<void>
the result of the update operation
Defined in
medusa/src/services/cart.ts:1402
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
medusa/src/services/cart.ts:1357
updateLineItem
▸ updateLineItem(cartId, lineItemId, update): 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. |
update |
LineItemUpdate |
- |
Returns
Promise<Cart>
the result of the update operation
Defined in
medusa/src/services/cart.ts:1001
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 |
Record<string, unknown> |
the data to update the payment session with |
Returns
Promise<Cart>
the resulting cart
Defined in
medusa/src/services/cart.ts:1665
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 |
Repository<Address> |
the repository to use for address updates |
Returns
Promise<void>
the result of the update operation
Defined in
medusa/src/services/cart.ts:1440
updateUnitPrices_
▸ Protected updateUnitPrices_(cart, regionId?, customer_id?): Promise<void>
Parameters
| Name | Type |
|---|---|
cart |
Cart |
regionId? |
string |
customer_id? |
string |
Returns
Promise<void>
Defined in
medusa/src/services/cart.ts:2331
validateLineItem
▸ Protected validateLineItem(sales_channel_id, lineItem): Promise<boolean>
Check if line item's variant belongs to the cart's sales channel.
Parameters
| Name | Type | Description |
|---|---|---|
sales_channel_id |
Object |
the cart for the line item |
sales_channel_id.sales_channel_id |
null | string |
- |
lineItem |
LineItemValidateData |
the line item being added |
Returns
Promise<boolean>
a boolean indicating validation result
Defined in
medusa/src/services/cart.ts:620
validateLineItemShipping_
▸ Protected validateLineItemShipping_(shippingMethods, lineItemShippingProfiledId): 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 |
lineItemShippingProfiledId |
string |
- |
Returns
boolean
boolean representing whether shipping method is validated
Defined in
medusa/src/services/cart.ts:591
withTransaction
▸ withTransaction(transactionManager?): CartService
Parameters
| Name | Type |
|---|---|
transactionManager? |
EntityManager |
Returns
Inherited from
TransactionBaseService.withTransaction