medusa-store/www/apps/docs/content/references/js-client/classes/internal-8.internal.LineItemService.md

displayed_sidebar

displayed_sidebar
jsClientSidebar

Class: LineItemService

internal.internal.LineItemService

Hierarchy

• TransactionBaseService

  ↳ LineItemService

Properties

__configModule__

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

Inherited from

TransactionBaseService.configModule

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:5

---

__container__

• Protected Readonly __container__: any

Inherited from

TransactionBaseService.container

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:4

---

__moduleDeclaration__

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

Inherited from

TransactionBaseService.moduleDeclaration

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:6

---

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

packages/medusa/dist/services/line-item.d.ts:30

---

featureFlagRouter_

• Protected Readonly featureFlagRouter_: FlagRouter

Defined in

packages/medusa/dist/services/line-item.d.ts:35

---

itemTaxLineRepo_

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

Defined in

packages/medusa/dist/services/line-item.d.ts:29

---

lineItemAdjustmentService_

• Protected Readonly lineItemAdjustmentService_: LineItemAdjustmentService

Defined in

packages/medusa/dist/services/line-item.d.ts:36

---

lineItemRepository_

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

Defined in

packages/medusa/dist/services/line-item.d.ts:28

---

manager_

• Protected manager_: EntityManager

Inherited from

TransactionBaseService.manager_

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:7

---

pricingService_

• Protected Readonly pricingService_: PricingService

Defined in

packages/medusa/dist/services/line-item.d.ts:33

---

productService_

• Protected Readonly productService_: ProductService

Defined in

packages/medusa/dist/services/line-item.d.ts:32

---

productVariantService_

• Protected Readonly productVariantService_: ProductVariantService

Defined in

packages/medusa/dist/services/line-item.d.ts:31

---

regionService_

• Protected Readonly regionService_: RegionService

Defined in

packages/medusa/dist/services/line-item.d.ts:34

---

taxProviderService_

• Protected Readonly taxProviderService_: TaxProviderService

Defined in

packages/medusa/dist/services/line-item.d.ts:37

---

transactionManager_

• Protected transactionManager_: undefined | EntityManager

Inherited from

TransactionBaseService.transactionManager_

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:8

Accessors

activeManager_

• Protected get activeManager_(): EntityManager

Returns

EntityManager

Inherited from

TransactionBaseService.activeManager_

Defined in

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

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

packages/medusa/dist/interfaces/transaction-base-service.d.ts:24

---

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

packages/medusa/dist/services/line-item.d.ts:108

---

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

packages/medusa/dist/services/line-item.d.ts:81

---

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

packages/medusa/dist/services/line-item.d.ts:54

---

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

packages/medusa/dist/services/line-item.d.ts:107

---

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

packages/medusa/dist/services/line-item.d.ts:94

---

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

packages/medusa/dist/services/line-item.d.ts:101

---

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

packages/medusa/dist/services/line-item.d.ts:62

---

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

packages/medusa/dist/services/line-item.d.ts:63

---

list

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

Parameters

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

Returns

Promise<LineItem[]>

Defined in

packages/medusa/dist/services/line-item.d.ts:39

---

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

packages/medusa/dist/services/line-item.d.ts:46

---

shouldRetryTransaction_

▸ Protected shouldRetryTransaction_(err): boolean

Parameters

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

Returns

boolean

Inherited from

TransactionBaseService.shouldRetryTransaction_

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:12

---

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

packages/medusa/dist/services/line-item.d.ts:88

---

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

packages/medusa/dist/services/line-item.d.ts:111

---

withTransaction

▸ withTransaction(transactionManager?): LineItemService

Parameters

Name	Type
transactionManager?	EntityManager

Returns

LineItemService

Inherited from

TransactionBaseService.withTransaction

Defined in

packages/medusa/dist/interfaces/transaction-base-service.d.ts:11