@gj-kit/nest-notifications
NestJS composition for transactional notification relay, dispatch, presentation, and Expo push boundaries.
Current npm latest:
0.1.1
Use it when
Section titled “Use it when”Use it when product events must become durable, deduplicated notification work without making delivery policy part of the product domain.
Do not use it when
Section titled “Do not use it when”Do not move product copy, recipient policy, or user-preference decisions into the generic relay.
Golden path
Section titled “Golden path”Outcome: Durable relay and dispatch runners wired to your stores and push gateway.
1. Install
Section titled “1. Install”pnpm add @gj-kit/nest-notifications2. Keep the app-owned boundary explicit
Section titled “2. Keep the app-owned boundary explicit”Keep product policy in app-owned stores, presenter, and scheduling policy before registering the Nest module.
3. Start with the smallest integration
Section titled “3. Start with the smallest integration”Copy this first, then replace only the app-owned values named above.
import { NestNotificationsModule, type NestNotificationsOptions } from '@gj-kit/nest-notifications';
declare const options: NestNotificationsOptions; // App stores, presenter, policy, and push gateway.
export const notifications = NestNotificationsModule.forRoot(options);Runtime and peers
Section titled “Runtime and peers”Engines: node >=20
| Peer | Supported range | Required for |
|---|---|---|
@nestjs/common |
`^10 | |
reflect-metadata |
`^0.1.13 | |
rxjs |
^7 |
the package integration |
Public subpaths
Section titled “Public subpaths”| Entry | Exported symbols |
|---|---|
Root entry |
77 |
./core |
78 |
./expo |
11 |
./testing |
14 |
Safety boundary
Section titled “Safety boundary”Keep credentials, endpoint ownership, and user-visible product wording in the application. Use the typed error and delivery outcomes instead of raw provider failures.
API reference
Section titled “API reference”complete API reference contains every public function, class, type, constant, and error contract generated from release declarations. Each item shows its import path, release signature, and package version.