Class: GiftCardService
Provides layer to manipulate gift cards.
Hierarchy
TransactionBaseService
Copy to Clipboard↳
GiftCardService
Copy to Clipboard
Constructors
constructor
• new GiftCardService(__namedParameters
Copy to Clipboard)
Parameters
Name | Type |
---|---|
__namedParameters Copy to Clipboard | InjectedDependencies Copy to Clipboard |
Overrides
TransactionBaseService.constructor
Defined in
medusa/src/services/gift-card.ts:39
Properties
__configModule__
• Protected
Copy to Clipboard Optional
Copy to Clipboard Readonly
Copy to Clipboard __configModule__: Record
Copy to Clipboard<string
Copy to Clipboard, unknown
Copy to Clipboard>
Inherited from
TransactionBaseService.__configModule__
Defined in
medusa/src/interfaces/transaction-base-service.ts:14
__container__
• Protected
Copy to Clipboard Readonly
Copy to Clipboard __container__: any
Copy to Clipboard
Inherited from
TransactionBaseService.__container__
Defined in
medusa/src/interfaces/transaction-base-service.ts:13
__moduleDeclaration__
• Protected
Copy to Clipboard Optional
Copy to Clipboard Readonly
Copy to Clipboard __moduleDeclaration__: Record
Copy to Clipboard<string
Copy to Clipboard, unknown
Copy to Clipboard>
Inherited from
TransactionBaseService.__moduleDeclaration__
Defined in
medusa/src/interfaces/transaction-base-service.ts:15
eventBus_
• Protected
Copy to Clipboard Readonly
Copy to Clipboard eventBus_: EventBusService
Copy to Clipboard
Defined in
medusa/src/services/gift-card.ts:33
giftCardRepository_
• Protected
Copy to Clipboard Readonly
Copy to Clipboard giftCardRepository_: Repository
Copy to Clipboard<GiftCard
Copy to Clipboard> & { listGiftCardsAndCount
Copy to Clipboard: (query
Copy to Clipboard: ExtendedFindConfig
Copy to Clipboard<GiftCard
Copy to Clipboard>, q?
Copy to Clipboard: string
Copy to Clipboard) => Promise
Copy to Clipboard<[GiftCard
Copy to Clipboard[], number
Copy to Clipboard]> }
Defined in
medusa/src/services/gift-card.ts:29
giftCardTransactionRepo_
• Protected
Copy to Clipboard Readonly
Copy to Clipboard giftCardTransactionRepo_: Repository
Copy to Clipboard<GiftCardTransaction
Copy to Clipboard>
Defined in
medusa/src/services/gift-card.ts:31
manager_
• Protected
Copy to Clipboard manager_: EntityManager
Copy to Clipboard
Inherited from
TransactionBaseService.manager_
Defined in
medusa/src/interfaces/transaction-base-service.ts:5
regionService_
• Protected
Copy to Clipboard Readonly
Copy to Clipboard regionService_: RegionService
Copy to Clipboard
Defined in
medusa/src/services/gift-card.ts:32
transactionManager_
• Protected
Copy to Clipboard transactionManager_: undefined
Copy to Clipboard | EntityManager
Copy to Clipboard
Inherited from
TransactionBaseService.transactionManager_
Defined in
medusa/src/interfaces/transaction-base-service.ts:6
Events
▪ Static
Copy to Clipboard Events: Object
Copy to Clipboard
Type declaration
Name | Type |
---|---|
CREATED Copy to Clipboard | string Copy to Clipboard |
Defined in
medusa/src/services/gift-card.ts:35
Accessors
activeManager_
• Protected
Copy to Clipboard get
Copy to Clipboard activeManager_(): EntityManager
Copy to Clipboard
Returns
EntityManager
Copy to Clipboard
Inherited from
TransactionBaseService.activeManager_
Defined in
medusa/src/interfaces/transaction-base-service.ts:8
Methods
atomicPhase_
▸ Protected
Copy to Clipboard atomicPhase_<TResult
Copy to Clipboard, TError
Copy to Clipboard>(work
Copy to Clipboard, isolationOrErrorHandler?
Copy to Clipboard, maybeErrorHandlerOrDontFail?
Copy to Clipboard): Promise
Copy to Clipboard<TResult
Copy to Clipboard>
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 Copy to Clipboard |
TError Copy to Clipboard |
Parameters
Name | Type | Description |
---|---|---|
work Copy to Clipboard | (transactionManager Copy to Clipboard: EntityManager Copy to Clipboard) => Promise Copy to Clipboard<TResult Copy to Clipboard> | the transactional work to be done |
isolationOrErrorHandler? Copy to Clipboard | IsolationLevel Copy to Clipboard | (error Copy to Clipboard: TError Copy to Clipboard) => Promise Copy to Clipboard<void Copy to Clipboard | TResult Copy to Clipboard> | the isolation level to be used for the work. |
maybeErrorHandlerOrDontFail? Copy to Clipboard | (error Copy to Clipboard: TError Copy to Clipboard) => Promise Copy to Clipboard<void Copy to Clipboard | TResult Copy to Clipboard> | Potential error handler |
Returns
Promise
Copy to Clipboard<TResult
Copy to Clipboard>
the result of the transactional work
Inherited from
TransactionBaseService.atomicPhase_
Defined in
medusa/src/interfaces/transaction-base-service.ts:56
create
▸ create(giftCard
Copy to Clipboard): Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Creates a gift card with provided data given that the data is validated.
Parameters
Name | Type | Description |
---|---|---|
giftCard Copy to Clipboard | CreateGiftCardInput Copy to Clipboard | the gift card data to create |
Returns
Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
the result of the create operation
Defined in
medusa/src/services/gift-card.ts:122
createTransaction
▸ createTransaction(data
Copy to Clipboard): Promise
Copy to Clipboard<string
Copy to Clipboard>
Parameters
Name | Type |
---|---|
data Copy to Clipboard | CreateGiftCardTransactionInput Copy to Clipboard |
Returns
Promise
Copy to Clipboard<string
Copy to Clipboard>
Defined in
medusa/src/services/gift-card.ts:106
delete
▸ delete(giftCardId
Copy to Clipboard): Promise
Copy to Clipboard<void
Copy to Clipboard | GiftCard
Copy to Clipboard>
Deletes a gift card idempotently
Parameters
Name | Type | Description |
---|---|---|
giftCardId Copy to Clipboard | string Copy to Clipboard | id of gift card to delete |
Returns
Promise
Copy to Clipboard<void
Copy to Clipboard | GiftCard
Copy to Clipboard>
the result of the delete operation
Defined in
medusa/src/services/gift-card.ts:295
list
▸ list(selector?
Copy to Clipboard, config?
Copy to Clipboard): Promise
Copy to Clipboard<GiftCard
Copy to Clipboard[]>
Parameters
Name | Type | Description |
---|---|---|
selector Copy to Clipboard | QuerySelector Copy to Clipboard<GiftCard Copy to Clipboard> | the query object for find |
config Copy to Clipboard | FindConfig Copy to Clipboard<GiftCard Copy to Clipboard> | the configuration used to find the objects. contains relations, skip, and take. |
Returns
Promise
Copy to Clipboard<GiftCard
Copy to Clipboard[]>
the result of the find operation
Defined in
medusa/src/services/gift-card.ts:98
listAndCount
▸ listAndCount(selector?
Copy to Clipboard, config?
Copy to Clipboard): Promise
Copy to Clipboard<[GiftCard
Copy to Clipboard[], number
Copy to Clipboard]>
Parameters
Name | Type | Description |
---|---|---|
selector Copy to Clipboard | QuerySelector Copy to Clipboard<GiftCard Copy to Clipboard> | the query object for find |
config Copy to Clipboard | FindConfig Copy to Clipboard<GiftCard Copy to Clipboard> | the configuration used to find the objects. contains relations, skip, and take. |
Returns
Promise
Copy to Clipboard<[GiftCard
Copy to Clipboard[], number
Copy to Clipboard]>
the result of the find operation
Defined in
medusa/src/services/gift-card.ts:74
retrieve
▸ retrieve(giftCardId
Copy to Clipboard, config?
Copy to Clipboard): Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Gets a gift card by id.
Parameters
Name | Type | Description |
---|---|---|
giftCardId Copy to Clipboard | string Copy to Clipboard | id of gift card to retrieve |
config Copy to Clipboard | FindConfig Copy to Clipboard<GiftCard Copy to Clipboard> | optional values to include with gift card query |
Returns
Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
the gift card
Defined in
medusa/src/services/gift-card.ts:215
retrieveByCode
▸ retrieveByCode(code
Copy to Clipboard, config?
Copy to Clipboard): Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Parameters
Name | Type |
---|---|
code Copy to Clipboard | string Copy to Clipboard |
config Copy to Clipboard | FindConfig Copy to Clipboard<GiftCard Copy to Clipboard> |
Returns
Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Defined in
medusa/src/services/gift-card.ts:229
retrieve_
▸ Protected
Copy to Clipboard retrieve_(selector
Copy to Clipboard, config?
Copy to Clipboard): Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Parameters
Name | Type |
---|---|
selector Copy to Clipboard | Selector Copy to Clipboard<GiftCard Copy to Clipboard> |
config Copy to Clipboard | FindConfig Copy to Clipboard<GiftCard Copy to Clipboard> |
Returns
Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Defined in
medusa/src/services/gift-card.ts:182
shouldRetryTransaction_
▸ Protected
Copy to Clipboard shouldRetryTransaction_(err
Copy to Clipboard): boolean
Copy to Clipboard
Parameters
Name | Type |
---|---|
err Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, unknown Copy to Clipboard> | { code Copy to Clipboard: string Copy to Clipboard } |
Returns
boolean
Copy to Clipboard
Inherited from
TransactionBaseService.shouldRetryTransaction_
Defined in
medusa/src/interfaces/transaction-base-service.ts:37
update
▸ update(giftCardId
Copy to Clipboard, update
Copy to Clipboard): Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
Updates a giftCard.
Parameters
Name | Type | Description |
---|---|---|
giftCardId Copy to Clipboard | string Copy to Clipboard | giftCard id of giftCard to update |
update Copy to Clipboard | UpdateGiftCardInput Copy to Clipboard | the data to update the giftCard with |
Returns
Promise
Copy to Clipboard<GiftCard
Copy to Clipboard>
the result of the update operation
Defined in
medusa/src/services/gift-card.ts:249
withTransaction
▸ withTransaction(transactionManager?
Copy to Clipboard): GiftCardService
Copy to Clipboard
Parameters
Name | Type |
---|---|
transactionManager? Copy to Clipboard | EntityManager Copy to Clipboard |
Returns
GiftCardService
Copy to Clipboard
Inherited from
TransactionBaseService.withTransaction
Defined in
medusa/src/interfaces/transaction-base-service.ts:20
generateCode
▸ Static
Copy to Clipboard generateCode(): string
Copy to Clipboard
Generates a 16 character gift card code
Returns
string
Copy to Clipboard
the generated gift card code
Defined in
medusa/src/services/gift-card.ts:58
resolveTaxRate
▸ Static
Copy to Clipboard Protected
Copy to Clipboard resolveTaxRate(giftCardTaxRate
Copy to Clipboard, region
Copy to Clipboard): null
Copy to Clipboard | number
Copy to Clipboard
The tax_rate of the giftcard can depend on whether regions tax gift cards, an input provided by the user or the tax rate. Based on these conditions, tax_rate changes.
Parameters
Name | Type |
---|---|
giftCardTaxRate Copy to Clipboard | null Copy to Clipboard | number Copy to Clipboard |
region Copy to Clipboard | Region Copy to Clipboard |
Returns
null
Copy to Clipboard | number
Copy to Clipboard
the tax rate for the gift card