NotificationPublisher — @gj-kit/nest-notifications

A public interface from @gj-kit/nest-notifications/core. The signature below is taken directly from the 0.1.1 release declaration.

Verified import example

import { NotificationPublisher } from '@gj-kit/nest-notifications/core';

Signature, parameters, and return type

/**
 * The only port source-domain code needs. `Transaction` stays generic because
 * staging happens inside the host's own source transaction — this is the one
 * port in this package that takes a host transaction object (design 3.4.1).
 *
 * Implementations owe obligations I1-I3 (design 3.3.6): conflict-safe insert,
 * a liveness gate acquired before the insert, and a staging timestamp written
 * exactly once.
 */
interface NotificationPublisher<Transaction = unknown> {
    stage(transaction: Transaction, command: NotificationCommand): Promise<NotificationStageResult>;
}

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

Release context

• Package: @gj-kit/nest-notifications
• Version: 0.1.1
• Public entry: ./core
• Source: GitHub