medusa-store/www/apps/docs/content/references/services/classes/LineItemService.md

Class: LineItemService

Hierarchy

• TransactionBaseService

  ↳ LineItemService

Constructors

constructor

• new LineItemService(«destructured»)

Parameters

Name	Type
«destructured»	InjectedDependencies

Overrides

TransactionBaseService.constructor

Defined in

medusa/src/services/line-item.ts:57

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

---

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/line-item.ts:48

---

featureFlagRouter_

• Protected Readonly featureFlagRouter_: FlagRouter

Defined in

medusa/src/services/line-item.ts:53

---

itemTaxLineRepo_

• Protected Readonly itemTaxLineRepo_: Repository<LineItemTaxLine> & { deleteForCart: (cartId: string) => Promise<void> ; upsertLines: (lines: LineItemTaxLine[]) => Promise<LineItemTaxLine[]> }

Defined in

medusa/src/services/line-item.ts:47

---

lineItemAdjustmentService_

• Protected Readonly lineItemAdjustmentService_: LineItemAdjustmentService

Defined in

medusa/src/services/line-item.ts:54

---

lineItemRepository_

• Protected Readonly lineItemRepository_: Repository<LineItem> & { findByReturn: (returnId: string) => Promise<LineItem & { return_item: ReturnItem }[]> }

Defined in

medusa/src/services/line-item.ts:46

---

manager_

• Protected manager_: EntityManager

Inherited from

TransactionBaseService.manager_

Defined in

medusa/src/interfaces/transaction-base-service.ts:5

---

pricingService_

• Protected Readonly pricingService_: PricingService

Defined in

medusa/src/services/line-item.ts:51

---

productService_

• Protected Readonly productService_: ProductService

Defined in

medusa/src/services/line-item.ts:50

---

productVariantService_

• Protected Readonly productVariantService_: ProductVariantService

Defined in

medusa/src/services/line-item.ts:49

---

regionService_

• Protected Readonly regionService_: RegionService

Defined in

medusa/src/services/line-item.ts:52

---

taxProviderService_

• Protected Readonly taxProviderService_: TaxProviderService

Defined in

medusa/src/services/line-item.ts:55

---

transactionManager_

• Protected transactionManager_: undefined | EntityManager

Inherited from

TransactionBaseService.transactionManager_

Defined in

medusa/src/interfaces/transaction-base-service.ts:6

Accessors

activeManager_

• Protected get activeManager_(): EntityManager

Returns

EntityManager

Inherited from

TransactionBaseService.activeManager_

Defined in

medusa/src/interfaces/transaction-base-service.ts:8

Methods

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

---

cloneTo

▸ cloneTo(ids, data?, options?): Promise<LineItem[]>

Parameters

Name	Type
ids	string | string[]
data	DeepPartial<LineItem>
options	Object
options.setOriginalLineItemId?	boolean

Returns

Promise<LineItem[]>

Defined in

medusa/src/services/line-item.ts:541

---

create

▸ create<T, TResult>(data): Promise<TResult>

Create a line item

Type parameters

Name	Type
T	LineItem | LineItem[]
TResult	T extends LineItem[] ? LineItem[] : LineItem

Parameters

Name	Type	Description
data	T	the line item object to create

Returns

Promise<TResult>

the created line item

Defined in

medusa/src/services/line-item.ts:421

---

createReturnLines

▸ createReturnLines(returnId, cartId): Promise<LineItem[]>

Creates return line items for a given cart based on the return items in a return.

Parameters

Name	Type	Description
returnId	string	the id to generate return items from.
cartId	string	the cart to assign the return line items to.

Returns

Promise<LineItem[]>

the created line items

Defined in

medusa/src/services/line-item.ts:131

---

createTaxLine

▸ createTaxLine(args): LineItemTaxLine

Create a line item tax line.

Parameters

Name	Type	Description
args	DeepPartial<LineItemTaxLine>	tax line partial passed to the repo create method

Returns

LineItemTaxLine

a new line item tax line

Defined in

medusa/src/services/line-item.ts:533

---

delete

▸ delete(id): Promise<undefined | null | LineItem>

Deletes a line item.

Parameters

Name	Type	Description
id	string	the id of the line item to delete

Returns

Promise<undefined | null | LineItem>

the result of the delete operation

Defined in

medusa/src/services/line-item.ts:494

---

deleteWithTaxLines

▸ deleteWithTaxLines(id): Promise<undefined | null | LineItem>

Parameters

Name	Type	Description
id	string	the id of the line item to delete

Returns

Promise<undefined | null | LineItem>

the result of the delete operation

Deprecated

no the cascade on the entity takes care of it Deletes a line item with the tax lines.

Defined in

medusa/src/services/line-item.ts:516

---

generate

▸ generate<T, TResult>(variantIdOrData, regionIdOrContext, quantity?, context?): Promise<TResult>

Generate a single or multiple line item without persisting the data into the db

Type parameters

Name	Type
T	string | GenerateInputData | GenerateInputData[]
TResult	T extends string ? LineItem : T extends LineItem ? LineItem : LineItem[]

Parameters

Name	Type
variantIdOrData	T
regionIdOrContext	T extends string ? string : GenerateLineItemContext
quantity?	number
context	GenerateLineItemContext

Returns

Promise<TResult>

Defined in

medusa/src/services/line-item.ts:192

---

generateLineItem

▸ Protected generateLineItem(variant, quantity, context): Promise<LineItem>

Parameters

Name	Type
variant	Object
variant.id	string
variant.product	Object
variant.product.discountable	boolean
variant.product.is_giftcard	boolean
variant.product.thumbnail	null | string
variant.product.title	string
variant.product_id	string
variant.title	string
quantity	number
context	GenerateLineItemContext & { variantPricing: ProductVariantPricing }

Returns

Promise<LineItem>

Defined in

medusa/src/services/line-item.ts:337

---

list

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

Parameters

Name	Type
selector	Selector<LineItem>
config	FindConfig<LineItem>

Returns

Promise<LineItem[]>

Defined in

medusa/src/services/line-item.ts:84

---

retrieve

▸ retrieve(id, config?): Promise<LineItem>

Retrieves a line item by its id.

Parameters

Name	Type	Description
id	string	the id of the line item to retrieve
config	Object	the config to be used at query building

Returns

Promise<LineItem>

the line item

Defined in

medusa/src/services/line-item.ts:105

---

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

---

update

▸ update(idOrSelector, data): Promise<LineItem[]>

Updates a line item

Parameters

Name	Type	Description
idOrSelector	string | Selector<LineItem>	the id or selector of the line item(s) to update
data	Partial<LineItem>	the properties to update the line item(s)

Returns

Promise<LineItem[]>

the updated line item(s)

Defined in

medusa/src/services/line-item.ts:451

---

validateGenerateArguments

▸ Protected validateGenerateArguments<T, TResult>(variantIdOrData, regionIdOrContext, quantity?): void

Type parameters

Name	Type
T	string | GenerateInputData | GenerateInputData[]
TResult	T extends string ? LineItem : T extends LineItem ? LineItem : LineItem[]

Parameters

Name	Type
variantIdOrData	string | T
regionIdOrContext	T extends string ? string : GenerateLineItemContext
quantity?	number

Returns

void

Defined in

medusa/src/services/line-item.ts:612

---

withTransaction

▸ withTransaction(transactionManager?): LineItemService

Parameters

Name	Type
transactionManager?	EntityManager

Returns

LineItemService

Inherited from

TransactionBaseService.withTransaction

Defined in

medusa/src/interfaces/transaction-base-service.ts:20