@dereekb/firebase 12.3.11 → 12.3.12

package/index.cjs.js

@@ -9529,6 +9529,8 @@ function notificationMessageFunction(fn, extras) {
   if (extras) {
     const fnWithExtras = fn;
     fnWithExtras.globalRecipients = extras.globalRecipients;
+    fnWithExtras.onSendAttempted = extras.onSendAttempted;
+    fnWithExtras.onSendSuccess = extras.onSendSuccess;
     return fnWithExtras;
   } else {
     return fn;

package/index.esm.js

@@ -9527,6 +9527,8 @@ function notificationMessageFunction(fn, extras) {
   if (extras) {
     const fnWithExtras = fn;
     fnWithExtras.globalRecipients = extras.globalRecipients;
+    fnWithExtras.onSendAttempted = extras.onSendAttempted;
+    fnWithExtras.onSendSuccess = extras.onSendSuccess;
     return fnWithExtras;
   } else {
     return fn;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase",
-  "version": "12.3.11",
+  "version": "12.3.12",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/lib/model/notification/notification.api.d.ts

@@ -258,6 +258,16 @@ export declare abstract class AbstractSubscribeOrUnsubscribeToNotificationBoxPar
      */
     unsubscribe?: Maybe<boolean>;
 }
+export interface SendNotificationResultOnSendCompleteResult<T = unknown> {
+    /**
+     * Value, if returned by the onSendSuccess callback.
+     */
+    readonly value?: T;
+    /**
+     * Error value if the onSendSuccess callback throws an error.
+     */
+    readonly error?: Maybe<unknown>;
+}
 export interface SendNotificationResult {
     /**
      * Attempted notification type
@@ -348,6 +358,14 @@ export interface SendNotificationResult {
      * Failed while attempting to build a message
      */
     readonly buildMessageFailure: boolean;
+    /**
+     * Result of the onSendAttempted callback, if called.
+     */
+    readonly onSendAttemptedResult?: Maybe<SendNotificationResultOnSendCompleteResult>;
+    /**
+     * Result of the onSendSuccess callback, if called.
+     */
+    readonly onSendSuccessResult?: Maybe<SendNotificationResultOnSendCompleteResult>;
 }
 /**
  * Used for sending queued notifications in the system.

package/src/lib/model/notification/notification.message.d.ts

@@ -1,8 +1,9 @@
 import { type Maybe, type WebsiteUrl } from '@dereekb/util';
 import { type NotificationRecipient, type NotificationRecipientWithConfig } from './notification.config';
-import { type Notification, type NotificationBox } from './notification';
+import { NotificationSendFlags, type Notification, type NotificationBox } from './notification';
 import { type NotificationItem, type NotificationItemMetadata } from './notification.item';
 import { type DocumentDataWithIdAndKey } from '../../common';
+import { NotificationSendEmailMessagesResult, NotificationSendTextMessagesResult, NotificationSendNotificationSummaryMessagesResult } from './notification.send';
 /**
  * Contextual information when
  */
@@ -130,11 +131,27 @@ export interface NotificationMessageFunctionFactoryConfig<D extends Notification
  * Creates a NotificationMessageFunction from the input config.
  */
 export type NotificationMessageFunctionFactory<D extends NotificationItemMetadata = {}> = (config: NotificationMessageFunctionFactoryConfig<D>) => Promise<NotificationMessageFunction>;
+export interface NotificationMessageFunctionExtrasCallbackDetails {
+    readonly success: boolean;
+    readonly updatedSendFlags: NotificationSendFlags;
+    readonly sendEmailsResult?: Maybe<NotificationSendEmailMessagesResult>;
+    readonly sendTextsResult?: Maybe<NotificationSendTextMessagesResult>;
+    readonly sendNotificationSummaryResult?: Maybe<NotificationSendNotificationSummaryMessagesResult>;
+}
+export type NotificationMessageFunctionExtrasCallbackFunction = (callbackDetails: NotificationMessageFunctionExtrasCallbackDetails) => Promise<unknown>;
 export interface NotificationMessageFunctionExtras {
     /**
      * Any global/additional recipient(s) that should be added to all Notifications associated with this NotificationMessageFunctionExtras.
      */
     readonly globalRecipients?: Maybe<NotificationRecipientWithConfig[]>;
+    /**
+     * Called each time the notification attempts to send something.
+     */
+    readonly onSendAttempted?: NotificationMessageFunctionExtrasCallbackFunction;
+    /**
+     * Called when the notification has is marked as done after sending to all recipients.
+     */
+    readonly onSendSuccess?: NotificationMessageFunctionExtrasCallbackFunction;
 }
 export type NotificationMessageFunctionWithoutExtras = (inputContext: NotificationMessageInputContext) => Promise<NotificationMessage>;
 /**

package/test/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [12.3.12](https://github.com/dereekb/dbx-components/compare/v12.3.11-dev...v12.3.12) (2025-08-20)
+
+
+
 ## [12.3.11](https://github.com/dereekb/dbx-components/compare/v12.3.10-dev...v12.3.11) (2025-08-19)
 
 

package/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase/test",
-  "version": "12.3.11",
+  "version": "12.3.12",
   "type": "commonjs",
   "peerDependencies": {
     "@dereekb/util": "*",