NotificationRelayTransaction — @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 { NotificationRelayTransaction } from '@gj-kit/nest-notifications/core';

Signature, parameters, and return type

interface NotificationRelayTransaction {
    /** Re-read the locked source row. `null` means it is gone (recipient purge). */
    readCommand(): Promise<ClaimedNotificationCommand | null>;
    /** Category preference gate. Absent rows mean enabled. */
    isCategoryEnabled(input: {
        readonly recipientRef: string;
        readonly category: string;
    }): Promise<boolean>;
    /** Idempotency probe for this source row (G2). */
    findDeliveryBySource(): Promise<{
        readonly deliveryId: string;
    } | null>;
    findOpenBatch(key: BatchIdentity): Promise<OpenBatchDelivery | null>;
    /** Conditional merge. `false` means the batch closed between read and write (R6). */
    mergeIntoBatch(input: MergeBatchInput): Promise<boolean>;
    /** Conflict-safe. Never throws on the batch-identity unique constraint (R11). */
    createDelivery(input: CreateDeliveryInput): Promise<CreateDeliveryResult>;
    /** `false` means an item for this source row already existed (R4). */
    appendItem(input: AppendItemInput): Promise<boolean>;
}

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