Files

Shahed Nasser a8293af8e1 fix: overlapping branch names for generated PRs of references (#2097 )

* fix overlapping branch names of generated references

* regenerate references

2022-08-25 17:47:58 +03:00

24 KiB

Raw Blame History

Class: OrderService

Hierarchy

TransactionBaseService

↳ OrderService

Constructors

constructor

• new OrderService(__namedParameters)

Parameters

Name	Type
`__namedParameters`	`InjectedDependencies`

Overrides

TransactionBaseService.constructor

Defined in

packages/medusa/src/services/order.ts:108

Properties

configModule

• Protected Optional Readonly __configModule__: Record<string, unknown>

Inherited from

TransactionBaseService.__configModule__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:10

container

• Protected Readonly __container__: any

Inherited from

TransactionBaseService.__container__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:9

addressRepository_

• Protected Readonly addressRepository_: typeof AddressRepository

Defined in

packages/medusa/src/services/order.ts:102

cartService_

• Protected Readonly cartService_: CartService

Defined in

packages/medusa/src/services/order.ts:101

customerService_

• Protected Readonly customerService_: CustomerService

Defined in

packages/medusa/src/services/order.ts:91

discountService_

• Protected Readonly discountService_: DiscountService

Defined in

packages/medusa/src/services/order.ts:95

draftOrderService_

• Protected Readonly draftOrderService_: DraftOrderService

Defined in

packages/medusa/src/services/order.ts:104

eventBus_

• Protected Readonly eventBus_: EventBusService

Defined in

packages/medusa/src/services/order.ts:106

fulfillmentProviderService_

• Protected Readonly fulfillmentProviderService_: FulfillmentProviderService

Defined in

packages/medusa/src/services/order.ts:96

fulfillmentService_

• Protected Readonly fulfillmentService_: FulfillmentService

Defined in

packages/medusa/src/services/order.ts:97

giftCardService_

• Protected Readonly giftCardService_: GiftCardService

Defined in

packages/medusa/src/services/order.ts:103

inventoryService_

• Protected Readonly inventoryService_: InventoryService

Defined in

packages/medusa/src/services/order.ts:105

lineItemService_

• Protected Readonly lineItemService_: LineItemService

Defined in

packages/medusa/src/services/order.ts:98

manager_

• Protected manager_: EntityManager

Overrides

TransactionBaseService.manager_

Defined in

packages/medusa/src/services/order.ts:87

orderRepository_

• Protected Readonly orderRepository_: typeof OrderRepository

Defined in

packages/medusa/src/services/order.ts:90

paymentProviderService_

• Protected Readonly paymentProviderService_: PaymentProviderService

Defined in

packages/medusa/src/services/order.ts:92

regionService_

• Protected Readonly regionService_: RegionService

Defined in

packages/medusa/src/services/order.ts:100

shippingOptionService_

• Protected Readonly shippingOptionService_: ShippingOptionService

Defined in

packages/medusa/src/services/order.ts:93

shippingProfileService_

• Protected Readonly shippingProfileService_: ShippingProfileService

Defined in

packages/medusa/src/services/order.ts:94

totalsService_

• Protected Readonly totalsService_: TotalsService

Defined in

packages/medusa/src/services/order.ts:99

transactionManager_

• Protected transactionManager_: EntityManager

Overrides

TransactionBaseService.transactionManager_

Defined in

packages/medusa/src/services/order.ts:88

Events

▪ Static Readonly Events: Object

Type declaration

Name	Type
`CANCELED`	`string`
`COMPLETED`	`string`
`FULFILLMENT_CANCELED`	`string`
`FULFILLMENT_CREATED`	`string`
`GIFT_CARD_CREATED`	`string`
`ITEMS_RETURNED`	`string`
`PAYMENT_CAPTURED`	`string`
`PAYMENT_CAPTURE_FAILED`	`string`
`PLACED`	`string`
`REFUND_CREATED`	`string`
`REFUND_FAILED`	`string`
`RETURN_ACTION_REQUIRED`	`string`
`RETURN_REQUESTED`	`string`
`SHIPMENT_CREATED`	`string`
`SWAP_CREATED`	`string`
`UPDATED`	`string`

Defined in

packages/medusa/src/services/order.ts:68

Methods

addShippingMethod

▸ addShippingMethod(orderId, optionId, data?, config?): Promise<Order>

Parameters

Name	Type
`orderId`	`string`
`optionId`	`string`
`data?`	`Record`<`string`, `unknown`>
`config`	`CreateShippingMethodDto`

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:824

Name	Type	Description
`orderId`	`string`	the order to archive

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

packages/medusa/src/interfaces/transaction-base-service.ts:50

cancel

▸ cancel(orderId): Promise<Order>

Cancels an order. Throws if fulfillment process has been initiated. Throws if payment process has been initiated.

Parameters

Name	Type	Description
`orderId`	`string`	id of order to cancel.

Returns

Promise<Order>

result of the update operation.

Defined in

packages/medusa/src/services/order.ts:977

cancelFulfillment

▸ cancelFulfillment(fulfillmentId): Promise<Order>

Cancels a fulfillment (if related to an order)

Parameters

Name	Type	Description
`fulfillmentId`	`string`	the ID of the fulfillment to cancel

Returns

Promise<Order>

updated order

Defined in

packages/medusa/src/services/order.ts:1287

capturePayment

▸ capturePayment(orderId): Promise<Order>

Captures payment for an order.

Parameters

Name	Type	Description
`orderId`	`string`	id of order to capture payment for.

Returns

Promise<Order>

result of the update operation.

Defined in

packages/medusa/src/services/order.ts:1055

completeOrder

▸ completeOrder(orderId): Promise<Order>

Parameters

Name	Type	Description
`orderId`	`string`	id of the order to complete

Returns

Promise<Order>

the result of the find operation

Defined in

packages/medusa/src/services/order.ts:457

createFromCart

▸ createFromCart(cartId): Promise<Order>

Creates an order from a cart

Parameters

Name	Type	Description
`cartId`	`string`	id of the cart to create an order from

Returns

Promise<Order>

resolves to the creation result.

Defined in

packages/medusa/src/services/order.ts:485

createFulfillment

▸ createFulfillment(orderId, itemsToFulfill, config?): Promise<Order>

Creates fulfillments for an order. In a situation where the order has more than one shipping method, we need to partition the order items, such that they can be sent to their respective fulfillment provider.

Parameters

Name	Type	Description
`orderId`	`string`	id of order to cancel.
`itemsToFulfill`	`FulFillmentItemType`[]	items to fulfil.
`config`	`Object`	the config to cancel.
`config.metadata?`	`Record`<`string`, `unknown`>	-
`config.no_notification?`	`boolean`	-

Returns

Promise<Order>

result of the update operation.

Defined in

packages/medusa/src/services/order.ts:1160

createRefund

▸ createRefund(orderId, refundAmount, reason, note?, config?): Promise<Order>

Refunds a given amount back to the customer.

Parameters

Name	Type	Description
`orderId`	`string`	id of the order to refund.
`refundAmount`	`number`	the amount to refund.
`reason`	`string`	the reason to refund.
`note?`	`string`	note for refund.
`config`	`Object`	the config for refund.
`config.no_notification?`	`boolean`	-

Returns

Promise<Order>

the result of the refund operation.

Defined in

packages/medusa/src/services/order.ts:1376

createShipment

▸ createShipment(orderId, fulfillmentId, trackingLinks?, config?): Promise<Order>

Adds a shipment to the order to indicate that an order has left the warehouse. Will ask the fulfillment provider for any documents that may have been created in regards to the shipment.

Parameters

Name	Type	Description
`orderId`	`string`	the id of the order that has been shipped
`fulfillmentId`	`string`	the fulfillment that has now been shipped
`trackingLinks?`	`TrackingLink`[]	array of tracking numebers associated with the shipment
`config`	`Object`	the config of the order that has been shipped
`config.metadata`	`Record`<`string`, `unknown`>	-
`config.no_notification?`	`boolean`	-

Returns

Promise<Order>

the resulting order following the update.

Defined in

packages/medusa/src/services/order.ts:664

decorateTotals

▸ Protected decorateTotals(order, totalsFields?): Promise<Order>

Parameters

Name	Type	Default value
`order`	`Order`	`undefined`
`totalsFields`	`string`[]	`[]`

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:1425

existsByCartId

▸ existsByCartId(cartId): Promise<boolean>

Checks the existence of an order by cart id.

Parameters

Name	Type	Description
`cartId`	`string`	cart id to find order

Returns

Promise<boolean>

the order document

Defined in

packages/medusa/src/services/order.ts:448

getFulfillmentItems

▸ Protected getFulfillmentItems(order, items, transformer): Promise<LineItem[]>

Retrieves the order line items, given an array of items.

Parameters

Name	Type	Description
`order`	`Order`	the order to get line items from
`items`	`FulFillmentItemType`[]	the items to get
`transformer`	(`item`: `undefined` \| `LineItem`, `quantity`: `number`) => `unknown`	a function to apply to each of the items retrieved from the order, should return a line item. If the transformer returns an undefined value the line item will be filtered from the returned array.

Returns

Promise<LineItem[]>

the line items generated by the transformer.

Defined in

packages/medusa/src/services/order.ts:1329

list

▸ list(selector, config?): Promise<Order[]>

Parameters

Name	Type	Description
`selector`	`Selector`<`Order`>	the query object for find
`config`	`FindConfig`<`Order`>	the config to be used for find

Returns

Promise<Order[]>

the result of the find operation

Defined in

packages/medusa/src/services/order.ts:156

listAndCount

▸ listAndCount(selector, config?): Promise<[Order[], number]>

Parameters

Name	Type	Description
`selector`	`QuerySelector`<`Order`>	the query object for find
`config`	`FindConfig`<`Order`>	the config to be used for find

Returns

Promise<[Order[], number]>

the result of the find operation

Defined in

packages/medusa/src/services/order.ts:190

registerReturnReceived

▸ registerReturnReceived(orderId, receivedReturn, customRefundAmount?): Promise<Order>

Handles receiving a return. This will create a refund to the customer. If the returned items don't match the requested items the return status will be updated to requires_action. This behaviour is useful in sitautions where a custom refund amount is requested, but the retuned items are not matching the requested items. Setting the allowMismatch argument to true, will process the return, ignoring any mismatches.

Parameters

Name	Type	Description
`orderId`	`string`	the order to return.
`receivedReturn`	`Return`	the received return
`customRefundAmount?`	`number`	the custom refund amount return

Returns

Promise<Order>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:1528

retrieve

▸ retrieve(orderId, config?): Promise<Order>

Gets an order by id.

Parameters

Name	Type	Description
`orderId`	`string`	id of order to retrieve
`config`	`FindConfig`<`Order`>	config of order to retrieve

Returns

Promise<Order>

the order document

Defined in

packages/medusa/src/services/order.ts:330

retrieveByCartId

▸ retrieveByCartId(cartId, config?): Promise<Order>

Gets an order by cart id.

Parameters

Name	Type	Description
`cartId`	`string`	cart id to find order
`config`	`FindConfig`<`Order`>	the config to be used to find order

Returns

Promise<Order>

the order document

Defined in

packages/medusa/src/services/order.ts:370

retrieveByExternalId

▸ retrieveByExternalId(externalId, config?): Promise<Order>

Gets an order by id.

Parameters

Name	Type	Description
`externalId`	`string`	id of order to retrieve
`config`	`FindConfig`<`Order`>	query config to get order by

Returns

Promise<Order>

the order document

Defined in

packages/medusa/src/services/order.ts:409

shouldRetryTransaction_

▸ Protected shouldRetryTransaction_(err): boolean

Parameters

Name	Type
`err`	`Record`<`string`, `unknown`> \| { `code`: `string` }

Returns

boolean

Inherited from

TransactionBaseService.shouldRetryTransaction_

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:31

transformQueryForTotals

▸ Protected transformQueryForTotals(config): Object

Parameters

Name	Type
`config`	`FindConfig`<`Order`>

Returns

Object

Name	Type
`relations`	`undefined` \| `string`[]
`select`	`undefined` \| keyof `Order`[]
`totalsToSelect`	`undefined` \| keyof `Order`[]

Defined in

packages/medusa/src/services/order.ts:255

update

▸ update(orderId, update): Promise<Order>

Updates an order. Metadata updates should use dedicated method, e.g. setMetadata etc. The function will throw errors if metadata updates are attempted.

Parameters

Name	Type	Description
`orderId`	`string`	the id of the order. Must be a string that can be casted to an ObjectId
`update`	`UpdateOrderInput`	an object with the update values.

Returns

Promise<Order>

resolves to the update result.

Defined in

packages/medusa/src/services/order.ts:888

updateBillingAddress

▸ Protected updateBillingAddress(order, address): Promise<void>

Updates the order's billing address.

Parameters

Name	Type	Description
`order`	`Order`	the order to update
`address`	`Address`	the value to set the billing address to

Returns

Promise<void>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:752

updateShippingAddress

▸ Protected updateShippingAddress(order, address): Promise<void>

Updates the order's shipping address.

Parameters

Name	Type	Description
`order`	`Order`	the order to update
`address`	`Address`	the value to set the shipping address to

Returns

Promise<void>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:792

validateFulfillmentLineItem

▸ Protected validateFulfillmentLineItem(item, quantity): null | LineItem

Checks that a given quantity of a line item can be fulfilled. Fails if the fulfillable quantity is lower than the requested fulfillment quantity. Fulfillable quantity is calculated by subtracting the already fulfilled quantity from the quantity that was originally purchased.

Parameters

Name	Type	Description
`item`	`LineItem`	the line item to check has sufficient fulfillable quantity.
`quantity`	`number`	the quantity that is requested to be fulfilled.

Returns

null | LineItem

a line item that has the requested fulfillment quantity set.

Defined in

packages/medusa/src/services/order.ts:1127

withTransaction

▸ withTransaction(transactionManager?): OrderService

Parameters

Name	Type
`transactionManager?`	`EntityManager`

Returns

OrderService

Inherited from

TransactionBaseService.withTransaction

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:13

24 KiB Raw Blame History

Class: OrderService

Hierarchy

Constructors

constructor

Parameters

Overrides

Defined in

Properties

__configModule__

Inherited from

Defined in

__container__

Inherited from

Defined in

addressRepository_

Defined in

cartService_

Defined in

customerService_

Defined in

discountService_

Defined in

draftOrderService_

Defined in

eventBus_

Defined in

fulfillmentProviderService_

Defined in

fulfillmentService_

Defined in

giftCardService_

Defined in

inventoryService_

Defined in

lineItemService_

Defined in

manager_

Overrides

Defined in

orderRepository_

Defined in

paymentProviderService_

Defined in

regionService_

Defined in

shippingOptionService_

Defined in

shippingProfileService_

Defined in

totalsService_

Defined in

transactionManager_

Overrides

Defined in

Events

Type declaration

Defined in

Methods

addShippingMethod

Parameters

Returns

Defined in

archive

Parameters

Returns

Defined in

atomicPhase_

Type parameters

Parameters

Returns

Inherited from

Defined in

cancel

Parameters

Returns

Defined in

cancelFulfillment

Parameters

Returns

24 KiB

Raw Blame History

configModule

container