# Class: NotificationService

## Hierarchy

- `TransactionBaseService`

  ↳ **`NotificationService`**

## Constructors

### constructor

• **new NotificationService**(`container`)

#### Parameters

| Name | Type |
| :------ | :------ |
| `container` | `InjectedDependencies` |

#### Overrides

TransactionBaseService.constructor

#### Defined in

[medusa/src/services/notification.ts:33](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L33)

## Properties

### \_\_configModule\_\_

• `Protected` `Optional` `Readonly` **\_\_configModule\_\_**: `Record`<`string`, `unknown`\>

#### Inherited from

TransactionBaseService.\_\_configModule\_\_

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:14](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L14)

___

### \_\_container\_\_

• `Protected` `Readonly` **\_\_container\_\_**: `any`

#### Inherited from

TransactionBaseService.\_\_container\_\_

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:13](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L13)

___

### \_\_moduleDeclaration\_\_

• `Protected` `Optional` `Readonly` **\_\_moduleDeclaration\_\_**: `Record`<`string`, `unknown`\>

#### Inherited from

TransactionBaseService.\_\_moduleDeclaration\_\_

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:15](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L15)

___

### attachmentGenerator\_

• `Protected` **attachmentGenerator\_**: `unknown` = `null`

#### Defined in

[medusa/src/services/notification.ts:24](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L24)

___

### container\_

• `Protected` `Readonly` **container\_**: `InjectedDependencies` & {}

#### Defined in

[medusa/src/services/notification.ts:25](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L25)

___

### logger\_

• `Protected` `Readonly` **logger\_**: `Logger`

#### Defined in

[medusa/src/services/notification.ts:28](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L28)

___

### manager\_

• `Protected` **manager\_**: `EntityManager`

#### Inherited from

TransactionBaseService.manager\_

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:5](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L5)

___

### notificationProviderRepository\_

• `Protected` `Readonly` **notificationProviderRepository\_**: `Repository`<`NotificationProvider`\>

#### Defined in

[medusa/src/services/notification.ts:31](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L31)

___

### notificationRepository\_

• `Protected` `Readonly` **notificationRepository\_**: `Repository`<`Notification`\>

#### Defined in

[medusa/src/services/notification.ts:29](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L29)

___

### subscribers\_

• `Protected` **subscribers\_**: `Object` = `{}`

#### Defined in

[medusa/src/services/notification.ts:23](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L23)

___

### transactionManager\_

• `Protected` **transactionManager\_**: `undefined` \| `EntityManager`

#### Inherited from

TransactionBaseService.transactionManager\_

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:6](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L6)

## Accessors

### activeManager\_

• `Protected` `get` **activeManager_**(): `EntityManager`

#### Returns

`EntityManager`

#### Inherited from

TransactionBaseService.activeManager\_

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:8](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L8)

## 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](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L56)

___

### handleEvent

▸ **handleEvent**(`eventName`, `data`): `Promise`<`undefined` \| `void` \| `Notification`[]\>

Handles an event by relaying the event data to the subscribing providers.
The result of the notification send will be persisted in the database in
order to allow for resends. Will log any errors that are encountered.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `eventName` | `string` | the event to handle |
| `data` | `Record`<`string`, `unknown`\> | the data the event was sent with |

#### Returns

`Promise`<`undefined` \| `void` \| `Notification`[]\>

the result of notification subscribed

#### Defined in

[medusa/src/services/notification.ts:165](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L165)

___

### list

▸ **list**(`selector`, `config?`): `Promise`<`Notification`[]\>

Retrieves a list of notifications.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `selector` | `Selector`<`Notification`\> | the params to select the notifications by. |
| `config` | `FindConfig`<`Notification`\> | the configuration to apply to the query |

#### Returns

`Promise`<`Notification`[]\>

the notifications that satisfy the query.

#### Defined in

[medusa/src/services/notification.ts:77](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L77)

___

### registerAttachmentGenerator

▸ **registerAttachmentGenerator**(`service`): `void`

Registers an attachment generator to the service. The generator can be
used to generate on demand invoices or other documents.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `service` | `unknown` | the service to assign to the attachmentGenerator |

#### Returns

`void`

#### Defined in

[medusa/src/services/notification.ts:51](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L51)

___

### registerInstalledProviders

▸ **registerInstalledProviders**(`providerIds`): `Promise`<`void`\>

Takes a list of notification provider ids and persists them in the database.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `providerIds` | `string`[] | a list of provider ids |

#### Returns

`Promise`<`void`\>

#### Defined in

[medusa/src/services/notification.ts:59](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L59)

___

### resend

▸ **resend**(`id`, `config?`): `Promise`<`Notification`\>

Resends a notification by retrieving a prior notification and calling the
underlying provider's resendNotification method.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `id` | `string` | the id of the notification |
| `config` | `FindConfig`<`Notification`\> | any configuration that might override the previous  send |

#### Returns

`Promise`<`Notification`\>

the newly created notification

#### Defined in

[medusa/src/services/notification.ts:245](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L245)

___

### retrieve

▸ **retrieve**(`id`, `config?`): `Promise`<`Notification`\>

Retrieves a notification with a given id

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `id` | `string` | the id of the notification |
| `config` | `FindConfig`<`Notification`\> | the configuration to apply to the query |

#### Returns

`Promise`<`Notification`\>

the notification

#### Defined in

[medusa/src/services/notification.ts:98](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L98)

___

### retrieveProvider\_

▸ `Protected` **retrieveProvider_**(`id`): `AbstractNotificationService`

Finds a provider with a given id. Will throw a NOT_FOUND error if the
resolution fails.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `id` | `string` | the id of the provider |

#### Returns

`AbstractNotificationService`

the notification provider

#### Defined in

[medusa/src/services/notification.ts:146](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L146)

___

### send

▸ **send**(`event`, `eventData`, `providerId`): `Promise`<`undefined` \| `Notification`\>

Sends a notification, by calling the given provider's sendNotification
method. Persists the Notification in the database.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `event` | `string` | the name of the event |
| `eventData` | `Record`<`string`, `unknown`\> | the data the event was sent with |
| `providerId` | `string` | the provider that should hande the event. |

#### Returns

`Promise`<`undefined` \| `Notification`\>

the created notification

#### Defined in

[medusa/src/services/notification.ts:197](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L197)

___

### 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](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L37)

___

### subscribe

▸ **subscribe**(`eventName`, `providerId`): `void`

Subscribes a given provider to an event.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `eventName` | `string` | the event to subscribe to |
| `providerId` | `string` | the provider that the event will be sent to |

#### Returns

`void`

#### Defined in

[medusa/src/services/notification.ts:125](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/services/notification.ts#L125)

___

### withTransaction

▸ **withTransaction**(`transactionManager?`): [`NotificationService`](NotificationService.md)

#### Parameters

| Name | Type |
| :------ | :------ |
| `transactionManager?` | `EntityManager` |

#### Returns

[`NotificationService`](NotificationService.md)

#### Inherited from

TransactionBaseService.withTransaction

#### Defined in

[medusa/src/interfaces/transaction-base-service.ts:20](https://github.com/medusajs/medusa/blob/d61d0d4cb/packages/medusa/src/interfaces/transaction-base-service.ts#L20)
