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

displayed_sidebar

displayed_sidebar
jsClientSidebar

Class: EventBusService

internal.internal.EventBusService

Can keep track of multiple subscribers to different events and run the subscribers when events happen. Events will run asynchronously.

Hierarchy

• TransactionBaseService

  ↳ EventBusService

Implements

• IEventBusService

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

---

config_

• Protected Readonly config_: ConfigModule

Defined in

packages/medusa/dist/services/event-bus.d.ts:19

---

enqueue_

• Protected enqueue_: Promise<void>

Defined in

packages/medusa/dist/services/event-bus.d.ts:24

---

eventBusModuleService_

• Protected Readonly eventBusModuleService_: IEventBusModuleService

Defined in

packages/medusa/dist/services/event-bus.d.ts:21

---

logger_

• Protected Readonly logger_: Logger

Defined in

packages/medusa/dist/services/event-bus.d.ts:22

---

manager_

• Protected manager_: EntityManager

Inherited from

TransactionBaseService.manager_

Defined in

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

---

shouldEnqueuerRun

• Protected shouldEnqueuerRun: boolean

Defined in

packages/medusa/dist/services/event-bus.d.ts:23

---

stagedJobService_

• Protected Readonly stagedJobService_: StagedJobService

Defined in

packages/medusa/dist/services/event-bus.d.ts:20

---

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

---

emit

▸ emit<T>(data): Promise<void | StagedJob[]>

Calls all subscribers when an event occurs.

Type parameters

Name
T

Parameters

Name	Type	Description
data	EmitData<T>[]	The data to use to process the events

Returns

Promise<void | StagedJob[]>

the jobs from our queue

Implementation of

IEventBusService.emit

Defined in

packages/medusa/dist/services/event-bus.d.ts:49

▸ emit<T>(eventName, data, options?): Promise<void | StagedJob>

Calls all subscribers when an event occurs.

Type parameters

Name
T

Parameters

Name	Type	Description
eventName	string	the name of the event to be process.
data	T	the data to send to the subscriber.
options?	Record<string, unknown>	options to add the job with

Returns

Promise<void | StagedJob>

the job from our queue

Implementation of

EventBusTypes.IEventBusService.emit

Defined in

packages/medusa/dist/services/event-bus.d.ts:57

---

enqueuer_

▸ enqueuer_(): Promise<void>

Returns

Promise<void>

Defined in

packages/medusa/dist/services/event-bus.d.ts:60

---

listJobs

▸ Protected listJobs(listConfig): Promise<never[] | StagedJob[]>

Parameters

Name	Type
listConfig	FindConfig<StagedJob>

Returns

Promise<never[] | StagedJob[]>

Defined in

packages/medusa/dist/services/event-bus.d.ts:61

---

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

---

startEnqueuer

▸ startEnqueuer(): void

Returns

void

Defined in

packages/medusa/dist/services/event-bus.d.ts:58

---

stopEnqueuer

▸ stopEnqueuer(): Promise<void>

Returns

Promise<void>

Defined in

packages/medusa/dist/services/event-bus.d.ts:59

---

subscribe

▸ subscribe(event, subscriber, context?): EventBusService

Adds a function to a list of event subscribers.

Parameters

Name	Type	Description
event	string | symbol	the event that the subscriber will listen for.
subscriber	Subscriber<unknown>	the function to be called when a certain event happens. Subscribers must return a Promise.
context?	SubscriberContext	subscriber context

Returns

EventBusService

this

Implementation of

IEventBusService.subscribe

Defined in

packages/medusa/dist/services/event-bus.d.ts:35

---

unsubscribe

▸ unsubscribe(event, subscriber, context): EventBusService

Removes function from the list of event subscribers.

Parameters

Name	Type	Description
event	string | symbol	the event of the subcriber.
subscriber	Subscriber<unknown>	the function to be removed
context	SubscriberContext	subscriber context

Returns

EventBusService

this

Implementation of

IEventBusService.unsubscribe

Defined in

packages/medusa/dist/services/event-bus.d.ts:43

---

withTransaction

▸ withTransaction(transactionManager?): EventBusService

Parameters

Name	Type
transactionManager?	EntityManager

Returns

EventBusService

Implementation of

IEventBusService.withTransaction

Overrides

TransactionBaseService.withTransaction

Defined in

packages/medusa/dist/services/event-bus.d.ts:26