@rytass/bpm-core-nestjs-module 0.9.1 → 0.11.0

package/src/lib/migrations/0000000021000-notification-silenced.d.ts

@@ -0,0 +1,15 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+/**
+ * Records whether a notification was deliberately not announced.
+ *
+ * Before this, a member preference of `in_app_enabled = false` stopped the row
+ * being written at all, so silencing notifications for an afternoon destroyed
+ * every notification raised in it. In-app rows are now always recorded and
+ * this column carries the announce decision instead. Existing rows were, by
+ * definition, announced.
+ */
+export declare class NotificationSilenced0000000021000 implements MigrationInterface {
+    name: string;
+    up(queryRunner: QueryRunner): Promise<void>;
+    down(queryRunner: QueryRunner): Promise<void>;
+}

package/src/lib/migrations/0000000021000-notification-silenced.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationSilenced0000000021000 = void 0;
+/**
+ * Records whether a notification was deliberately not announced.
+ *
+ * Before this, a member preference of `in_app_enabled = false` stopped the row
+ * being written at all, so silencing notifications for an afternoon destroyed
+ * every notification raised in it. In-app rows are now always recorded and
+ * this column carries the announce decision instead. Existing rows were, by
+ * definition, announced.
+ */
+class NotificationSilenced0000000021000 {
+    constructor() {
+        this.name = 'NotificationSilenced0000000021000';
+    }
+    async up(queryRunner) {
+        await queryRunner.query(`
+      ALTER TABLE "notifications"
+      ADD COLUMN IF NOT EXISTS "silenced" boolean NOT NULL DEFAULT false
+    `);
+    }
+    async down(queryRunner) {
+        await queryRunner.query(`
+      ALTER TABLE "notifications"
+      DROP COLUMN IF EXISTS "silenced"
+    `);
+    }
+}
+exports.NotificationSilenced0000000021000 = NotificationSilenced0000000021000;
+//# sourceMappingURL=0000000021000-notification-silenced.js.map

package/src/lib/migrations/0000000021000-notification-silenced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0000000021000-notification-silenced.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/migrations/0000000021000-notification-silenced.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACH,MAAa,iCAAiC;IAA9C;QACE,SAAI,GAAG,mCAAmC,CAAC;IAe7C,CAAC;IAbC,KAAK,CAAC,EAAE,CAAC,WAAwB;QAC/B,MAAM,WAAW,CAAC,KAAK,CAAC;;;KAGvB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAwB;QACjC,MAAM,WAAW,CAAC,KAAK,CAAC;;;KAGvB,CAAC,CAAC;IACL,CAAC;CACF;AAhBD,8EAgBC"}

package/src/lib/migrations/index.d.ts

@@ -21,3 +21,4 @@ export * from './0000000017000-adhoc-directives';
 export * from './0000000018000-notification-archive';
 export * from './0000000019000-approval-template-activation';
 export * from './0000000020000-form-data-option-snapshots';
+export * from './0000000021000-notification-silenced';

package/src/lib/migrations/index.js

@@ -23,6 +23,7 @@ const _0000000017000_adhoc_directives_1 = require("./0000000017000-adhoc-directi
 const _0000000018000_notification_archive_1 = require("./0000000018000-notification-archive");
 const _0000000019000_approval_template_activation_1 = require("./0000000019000-approval-template-activation");
 const _0000000020000_form_data_option_snapshots_1 = require("./0000000020000-form-data-option-snapshots");
+const _0000000021000_notification_silenced_1 = require("./0000000021000-notification-silenced");
 exports.BPM_CORE_MIGRATIONS = [
     _0000000000001_enable_postgres_extensions_1.EnablePostgresExtensions0000000000001,
     _0000000001000_identity_organization_foundation_1.IdentityOrganizationFoundation0000000001000,
@@ -45,6 +46,7 @@ exports.BPM_CORE_MIGRATIONS = [
     _0000000018000_notification_archive_1.NotificationArchive0000000018000,
     _0000000019000_approval_template_activation_1.ApprovalTemplateActivation0000000019000,
     _0000000020000_form_data_option_snapshots_1.FormDataOptionSnapshots0000000020000,
+    _0000000021000_notification_silenced_1.NotificationSilenced0000000021000,
 ];
 tslib_1.__exportStar(require("./0000000000001-enable-postgres-extensions"), exports);
 tslib_1.__exportStar(require("./0000000001000-identity-organization-foundation"), exports);
@@ -67,4 +69,5 @@ tslib_1.__exportStar(require("./0000000017000-adhoc-directives"), exports);
 tslib_1.__exportStar(require("./0000000018000-notification-archive"), exports);
 tslib_1.__exportStar(require("./0000000019000-approval-template-activation"), exports);
 tslib_1.__exportStar(require("./0000000020000-form-data-option-snapshots"), exports);
+tslib_1.__exportStar(require("./0000000021000-notification-silenced"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/migrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/migrations/index.ts"],"names":[],"mappings":";;;;AACA,0GAAmG;AACnG,sHAA+G;AAC/G,oGAA6F;AAC7F,8GAAuG;AACvG,0GAAmG;AACnG,sFAAgF;AAChF,wFAAkF;AAClF,kGAA4F;AAC5F,8GAAuG;AACvG,oFAA8E;AAC9E,4GAAqG;AACrG,sHAA8G;AAC9G,8GAAuG;AACvG,kGAA2F;AAC3F,oGAA8F;AAC9F,kIAA0H;AAC1H,8GAAsG;AACtG,sFAAgF;AAChF,8FAAwF;AACxF,8GAAuG;AACvG,0GAAkG;AAErF,QAAA,mBAAmB,GAA8C;IAC5E,iFAAqC;IACrC,6FAA2C;IAC3C,2EAAkC;IAClC,qFAAuC;IACvC,iFAAqC;IACrC,8DAA4B;IAC5B,gEAA6B;IAC7B,0EAAkC;IAClC,qFAAuC;IACvC,4DAA2B;IAC3B,mFAAsC;IACtC,4FAA0C;IAC1C,qFAAuC;IACvC,yEAAiC;IACjC,4EAAmC;IACnC,wGAAgD;IAChD,oFAAsC;IACtC,8DAA4B;IAC5B,sEAAgC;IAChC,qFAAuC;IACvC,gFAAoC;CACrC,CAAC;AAEF,qFAA2D;AAC3D,2FAAiE;AACjE,kFAAwD;AACxD,uFAA6D;AAC7D,qFAA2D;AAC3D,2EAAiD;AACjD,4EAAkD;AAClD,iFAAuD;AACvD,uFAA6D;AAC7D,0EAAgD;AAChD,sFAA4D;AAC5D,2FAAiE;AACjE,uFAA6D;AAC7D,iFAAuD;AACvD,kFAAwD;AACxD,iGAAuE;AACvE,uFAA6D;AAC7D,2EAAiD;AACjD,+EAAqD;AACrD,uFAA6D;AAC7D,qFAA2D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/migrations/index.ts"],"names":[],"mappings":";;;;AACA,0GAAmG;AACnG,sHAA+G;AAC/G,oGAA6F;AAC7F,8GAAuG;AACvG,0GAAmG;AACnG,sFAAgF;AAChF,wFAAkF;AAClF,kGAA4F;AAC5F,8GAAuG;AACvG,oFAA8E;AAC9E,4GAAqG;AACrG,sHAA8G;AAC9G,8GAAuG;AACvG,kGAA2F;AAC3F,oGAA8F;AAC9F,kIAA0H;AAC1H,8GAAsG;AACtG,sFAAgF;AAChF,8FAAwF;AACxF,8GAAuG;AACvG,0GAAkG;AAClG,gGAA0F;AAE7E,QAAA,mBAAmB,GAA8C;IAC5E,iFAAqC;IACrC,6FAA2C;IAC3C,2EAAkC;IAClC,qFAAuC;IACvC,iFAAqC;IACrC,8DAA4B;IAC5B,gEAA6B;IAC7B,0EAAkC;IAClC,qFAAuC;IACvC,4DAA2B;IAC3B,mFAAsC;IACtC,4FAA0C;IAC1C,qFAAuC;IACvC,yEAAiC;IACjC,4EAAmC;IACnC,wGAAgD;IAChD,oFAAsC;IACtC,8DAA4B;IAC5B,sEAAgC;IAChC,qFAAuC;IACvC,gFAAoC;IACpC,wEAAiC;CAClC,CAAC;AAEF,qFAA2D;AAC3D,2FAAiE;AACjE,kFAAwD;AACxD,uFAA6D;AAC7D,qFAA2D;AAC3D,2EAAiD;AACjD,4EAAkD;AAClD,iFAAuD;AACvD,uFAA6D;AAC7D,0EAAgD;AAChD,sFAA4D;AAC5D,2FAAiE;AACjE,uFAA6D;AAC7D,iFAAuD;AACvD,kFAAwD;AACxD,iGAAuE;AACvE,uFAA6D;AAC7D,2EAAiD;AACjD,+EAAqD;AACrD,uFAA6D;AAC7D,qFAA2D;AAC3D,gFAAsD"}

package/src/lib/notification/index.d.ts

@@ -2,6 +2,7 @@ export * from './notification-delivery.service';
 export * from './notification-dispatcher.token';
 export * from './notification-observer.token';
 export * from './notification-preference.entity';
+export * from './notification-schedule';
 export * from './notification.entity';
 export * from './notification.enums';
 export * from './notification-options';

package/src/lib/notification/index.js

@@ -5,6 +5,7 @@ tslib_1.__exportStar(require("./notification-delivery.service"), exports);
 tslib_1.__exportStar(require("./notification-dispatcher.token"), exports);
 tslib_1.__exportStar(require("./notification-observer.token"), exports);
 tslib_1.__exportStar(require("./notification-preference.entity"), exports);
+tslib_1.__exportStar(require("./notification-schedule"), exports);
 tslib_1.__exportStar(require("./notification.entity"), exports);
 tslib_1.__exportStar(require("./notification.enums"), exports);
 tslib_1.__exportStar(require("./notification-options"), exports);

package/src/lib/notification/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/index.ts"],"names":[],"mappings":";;;AAAA,0EAAgD;AAChD,0EAAgD;AAChD,wEAA8C;AAC9C,2EAAiD;AACjD,gEAAsC;AACtC,+DAAqC;AACrC,iEAAuC;AACvC,wEAA8C;AAC9C,gEAAsC;AACtC,iEAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/index.ts"],"names":[],"mappings":";;;AAAA,0EAAgD;AAChD,0EAAgD;AAChD,wEAA8C;AAC9C,2EAAiD;AACjD,kEAAwC;AACxC,gEAAsC;AACtC,+DAAqC;AACrC,iEAAuC;AACvC,wEAA8C;AAC9C,gEAAsC;AACtC,iEAAuC"}

package/src/lib/notification/notification-delivery.service.d.ts

@@ -1,23 +1,48 @@
 import { ModuleRef } from '@nestjs/core';
 import { Repository } from 'typeorm';
+import { NotificationPreferenceEntity } from './notification-preference.entity';
 import { NotificationEntity } from './notification.entity';
 import { BPMResolvedNotificationOptions } from './notification-options';
 export declare class NotificationDeliveryService {
     private readonly notificationRepository;
+    private readonly notificationPreferenceRepository;
     private readonly moduleRef;
     private readonly logger;
-    constructor(notificationRepository: Repository<NotificationEntity>, moduleRef: ModuleRef);
+    constructor(notificationRepository: Repository<NotificationEntity>, notificationPreferenceRepository: Repository<NotificationPreferenceEntity>, moduleRef: ModuleRef);
     deliverPendingNotifications({ limit, now, options, }: {
         readonly limit?: number;
         readonly now?: Date;
         readonly options: BPMResolvedNotificationOptions;
     }): Promise<number>;
+    /**
+     * Splits a claimed batch into recipients who asked for a daily digest and
+     * everyone else.
+     *
+     * Only email digests, and only when a recipient has more than one row
+     * waiting — a "digest" of a single notification is just that notification
+     * with a worse subject line.
+     */
+    private groupDigestBatches;
+    private readDailyDigestMemberIds;
+    /**
+     * Sends one message covering a recipient's held notifications and marks all
+     * of them delivered, so a member on `DAILY` gets one email rather than one
+     * per approval that happened overnight.
+     *
+     * Returns how many rows were delivered, so the scan's count still reflects
+     * notifications rather than messages.
+     */
+    private deliverDigest;
+    private dispatchDigest;
+    private dispatchDigestEmail;
     deliverNotification(notification: NotificationEntity, options: BPMResolvedNotificationOptions): Promise<boolean>;
     private claimPendingNotifications;
     private dispatch;
     private dispatchBuiltIn;
     private readHostDispatcher;
     private dispatchEmail;
+    private createEmailTransport;
+    private readRecipientEmail;
     private dispatchWebhook;
     private recordDeliveryFailure;
 }

package/src/lib/notification/notification-delivery.service.js

@@ -11,11 +11,13 @@ const nodemailer = require("nodemailer");
 const typeorm_2 = require("typeorm");
 const identity_service_1 = require("../identity/identity.service");
 const notification_dispatcher_token_1 = require("./notification-dispatcher.token");
+const notification_preference_entity_1 = require("./notification-preference.entity");
 const notification_entity_1 = require("./notification.entity");
 const notification_enums_1 = require("./notification.enums");
 let NotificationDeliveryService = NotificationDeliveryService_1 = class NotificationDeliveryService {
-    constructor(notificationRepository, moduleRef) {
+    constructor(notificationRepository, notificationPreferenceRepository, moduleRef) {
         this.notificationRepository = notificationRepository;
+        this.notificationPreferenceRepository = notificationPreferenceRepository;
         this.moduleRef = moduleRef;
         this.logger = new common_1.Logger(NotificationDeliveryService_1.name);
     }
@@ -26,8 +28,117 @@ let NotificationDeliveryService = NotificationDeliveryService_1 = class Notifica
             limit: deliveryLimit,
             now,
         });
-        const results = await Promise.all(pendingNotifications.map((notification) => this.deliverNotification(notification, options)));
-        return results.filter(Boolean).length;
+        const { digests, individual } = await this.groupDigestBatches(pendingNotifications);
+        const results = await Promise.all([
+            ...individual.map((notification) => this.deliverNotification(notification, options)),
+            ...digests.map((batch) => this.deliverDigest(batch, options)),
+        ]);
+        // `deliverNotification` reports a boolean per row and `deliverDigest` a
+        // row count, so both coerce to "notifications delivered".
+        return results.reduce((total, result) => total + Number(result), 0);
+    }
+    /**
+     * Splits a claimed batch into recipients who asked for a daily digest and
+     * everyone else.
+     *
+     * Only email digests, and only when a recipient has more than one row
+     * waiting — a "digest" of a single notification is just that notification
+     * with a worse subject line.
+     */
+    async groupDigestBatches(notifications) {
+        const emailNotifications = notifications.filter((notification) => notification.channel === notification_enums_1.NotificationChannelEnum.EMAIL);
+        if (emailNotifications.length === 0) {
+            return { digests: [], individual: notifications };
+        }
+        const digestMemberIds = await this.readDailyDigestMemberIds(uniqueStrings(emailNotifications.map((notification) => notification.recipientMemberId)));
+        const byRecipient = emailNotifications.reduce((groups, notification) => {
+            if (!digestMemberIds.has(notification.recipientMemberId)) {
+                return groups;
+            }
+            const group = groups.get(notification.recipientMemberId) ?? [];
+            group.push(notification);
+            groups.set(notification.recipientMemberId, group);
+            return groups;
+        }, new Map());
+        const digests = [...byRecipient.values()].filter((group) => group.length > 1);
+        const digestedIds = new Set(digests.flatMap((group) => group.map((notification) => notification.id)));
+        return {
+            digests,
+            individual: notifications.filter((notification) => !digestedIds.has(notification.id)),
+        };
+    }
+    async readDailyDigestMemberIds(memberIds) {
+        if (memberIds.length === 0) {
+            return new Set();
+        }
+        const preferences = await this.notificationPreferenceRepository.find({
+            where: { memberId: (0, typeorm_2.In)([...memberIds]) },
+        });
+        return new Set(preferences
+            .filter((preference) => preference.emailDigestMode === notification_enums_1.NotificationDigestModeEnum.DAILY)
+            .map((preference) => preference.memberId));
+    }
+    /**
+     * Sends one message covering a recipient's held notifications and marks all
+     * of them delivered, so a member on `DAILY` gets one email rather than one
+     * per approval that happened overnight.
+     *
+     * Returns how many rows were delivered, so the scan's count still reflects
+     * notifications rather than messages.
+     */
+    async deliverDigest(notifications, options) {
+        try {
+            const deliveryTarget = await withDispatchTimeout(this.dispatchDigest(notifications, options), options.deliveryDispatchTimeoutMs);
+            const deliveredAt = new Date();
+            await this.notificationRepository.save(notifications.map((notification) => ({
+                ...notification,
+                attemptCount: notification.attemptCount + 1,
+                deliveredAt,
+                deliveryError: null,
+                deliveryTarget,
+                lastAttemptAt: deliveredAt,
+                nextRetryAt: null,
+                sentAt: deliveredAt,
+                status: notification_enums_1.NotificationStatusEnum.SENT,
+            })));
+            return notifications.length;
+        }
+        catch (error) {
+            const errorMessage = readErrorMessage(error);
+            // Recorded per row: a digest that fails must leave each notification
+            // retryable on its own terms, not strand the whole batch.
+            await Promise.all(notifications.map((notification) => this.recordDeliveryFailure(notification, errorMessage, options)));
+            return 0;
+        }
+    }
+    async dispatchDigest(notifications, options) {
+        const hostDispatcher = this.readHostDispatcher();
+        if (hostDispatcher?.dispatchDigest) {
+            return hostDispatcher.dispatchDigest(notifications, options);
+        }
+        if (hostDispatcher) {
+            // The host owns delivery and cannot combine, so honour the hold but not
+            // the merge: every row still goes out now, at the digest hour.
+            const targets = await notifications.reduce(async (previousPromise, notification) => [
+                ...(await previousPromise),
+                await hostDispatcher.dispatch(notification, options),
+            ], Promise.resolve([]));
+            return targets[0] ?? '';
+        }
+        return this.dispatchDigestEmail(notifications, options);
+    }
+    async dispatchDigestEmail(notifications, options) {
+        const transporter = this.createEmailTransport(options);
+        const recipientEmail = await this.readRecipientEmail(notifications[0].recipientMemberId);
+        await transporter.sendMail({
+            from: options.emailFrom ?? '',
+            subject: `BPM 通知摘要（${notifications.length} 則）`,
+            text: notifications
+                .map((notification) => `${notification.title}\n${notification.body}`)
+                .join('\n\n---\n\n'),
+            to: recipientEmail,
+        });
+        return recipientEmail;
     }
     async deliverNotification(notification, options) {
         if (notification.channel === notification_enums_1.NotificationChannelEnum.IN_APP) {
@@ -38,7 +149,7 @@ let NotificationDeliveryService = NotificationDeliveryService_1 = class Notifica
             return false;
         }
         try {
-            const deliveryTarget = await this.dispatch(notification, options);
+            const deliveryTarget = await withDispatchTimeout(this.dispatch(notification, options), options.deliveryDispatchTimeoutMs);
             await this.notificationRepository.save({
                 ...notification,
                 attemptCount: notification.attemptCount + 1,
@@ -109,12 +220,20 @@ let NotificationDeliveryService = NotificationDeliveryService_1 = class Notifica
                 notification_enums_1.NotificationStatusEnum.DELIVERY_IN_PROGRESS,
                 claimStaleBefore,
             ]));
-            const claimedIds = claimedRows.map((row) => row.id);
-            return claimedIds.length
-                ? manager
-                    .getRepository(notification_entity_1.NotificationEntity)
-                    .find({ where: { id: (0, typeorm_2.In)(claimedIds) } })
-                : [];
+            const claimedIds = readClaimedIds(claimedRows);
+            if (claimedIds.length === 0) {
+                return [];
+            }
+            const claimedNotifications = await manager
+                .getRepository(notification_entity_1.NotificationEntity)
+                .find({ where: { id: (0, typeorm_2.In)([...claimedIds]) } });
+            if (claimedNotifications.length !== claimedIds.length) {
+                // A row moved to `DELIVERY_IN_PROGRESS` that this pass then cannot
+                // load would sit claimed with nothing to show for it, so say so
+                // rather than let the next stale window quietly re-claim it.
+                this.logger.warn(`Claimed ${claimedIds.length} notifications but loaded ${claimedNotifications.length}; unloaded rows stay DELIVERY_IN_PROGRESS until the next stale claim`);
+            }
+            return claimedNotifications;
         });
     }
     async dispatch(notification, options) {
@@ -144,6 +263,17 @@ let NotificationDeliveryService = NotificationDeliveryService_1 = class Notifica
         }
     }
     async dispatchEmail(notification, options) {
+        const transporter = this.createEmailTransport(options);
+        const recipientEmail = await this.readRecipientEmail(notification.recipientMemberId);
+        await transporter.sendMail({
+            from: options.emailFrom ?? '',
+            subject: notification.title,
+            text: notification.body,
+            to: recipientEmail,
+        });
+        return recipientEmail;
+    }
+    createEmailTransport(options) {
         if (!options.emailEnabled ||
             !options.emailSmtpHost ||
             !options.emailSmtpPort ||
@@ -152,11 +282,7 @@ let NotificationDeliveryService = NotificationDeliveryService_1 = class Notifica
             !options.emailFrom) {
             throw new Error('EMAIL_DISABLED');
         }
-        const identityService = this.moduleRef.get(identity_service_1.IdentityService, {
-            strict: false,
-        });
-        const recipient = await identityService.resolveMember(notification.recipientMemberId);
-        const transporter = nodemailer.createTransport({
+        return nodemailer.createTransport({
             auth: {
                 pass: options.emailSmtpPassword,
                 user: options.emailSmtpUsername,
@@ -165,12 +291,12 @@ let NotificationDeliveryService = NotificationDeliveryService_1 = class Notifica
             port: options.emailSmtpPort,
             secure: options.emailSmtpSecure,
         });
-        await transporter.sendMail({
-            from: options.emailFrom,
-            subject: notification.title,
-            text: notification.body,
-            to: recipient.email,
+    }
+    async readRecipientEmail(memberId) {
+        const identityService = this.moduleRef.get(identity_service_1.IdentityService, {
+            strict: false,
         });
+        const recipient = await identityService.resolveMember(memberId);
         return recipient.email;
     }
     async dispatchWebhook(notification, options) {
@@ -230,12 +356,71 @@ exports.NotificationDeliveryService = NotificationDeliveryService;
 exports.NotificationDeliveryService = NotificationDeliveryService = NotificationDeliveryService_1 = tslib_1.__decorate([
     (0, common_1.Injectable)(),
     tslib_1.__param(0, (0, typeorm_1.InjectRepository)(notification_entity_1.NotificationEntity)),
+    tslib_1.__param(1, (0, typeorm_1.InjectRepository)(notification_preference_entity_1.NotificationPreferenceEntity)),
     tslib_1.__metadata("design:paramtypes", [typeorm_2.Repository,
+        typeorm_2.Repository,
         core_1.ModuleRef])
 ], NotificationDeliveryService);
+function uniqueStrings(values) {
+    return Array.from(new Set(values));
+}
 function readErrorMessage(error) {
     return error instanceof Error ? error.message : 'Unknown delivery error';
 }
+/**
+ * Reads the ids returned by the claiming `UPDATE ... RETURNING id`.
+ *
+ * TypeORM's Postgres driver returns `[rows, affectedCount]` for `UPDATE` and
+ * `DELETE`, and a bare row array for everything else. Reading the two-element
+ * form as a row array yields `[undefined, undefined]`, which matches no row —
+ * the claim commits, the delivery pass finds nothing, and the row is re-claimed
+ * on every stale window forever with `attempt_count` still at 0. Both shapes
+ * are accepted here so the claim does not depend on driver-specific packaging.
+ */
+function readClaimedIds(rawResult) {
+    const rows = Array.isArray(rawResult) && Array.isArray(rawResult[0])
+        ? rawResult[0]
+        : rawResult;
+    if (!Array.isArray(rows)) {
+        return [];
+    }
+    return rows
+        .map((row) => row && typeof row === 'object' && 'id' in row
+        ? row.id
+        : undefined)
+        .filter((id) => typeof id === 'string' && id.length > 0);
+}
+/**
+ * Fails a dispatch that never settles.
+ *
+ * Delivery marks a row `DELIVERY_IN_PROGRESS` before dispatching, and only the
+ * resolve and reject paths write back. A host dispatcher, member resolver or
+ * SMTP call that hangs would therefore leave a permanently claimed row with an
+ * empty `delivery_error` — nothing for the host to diagnose. A timeout turns
+ * that into an ordinary recorded failure that retries.
+ */
+async function withDispatchTimeout(operation, timeoutMs) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        return operation;
+    }
+    let timer;
+    try {
+        return await Promise.race([
+            operation,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    reject(new Error(`DELIVERY_TIMEOUT_${timeoutMs}MS`));
+                }, timeoutMs);
+                timer.unref();
+            }),
+        ]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
 function normalizePositiveInteger(value, fallback) {
     if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0) {
         return fallback;

package/src/lib/notification/notification-delivery.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-delivery.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-delivery.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"notification-delivery.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-delivery.service.ts"],"names":[],"mappings":"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"}

package/src/lib/notification/notification-dispatcher.token.d.ts

@@ -3,5 +3,18 @@ import { NotificationEntity } from './notification.entity';
 import { BPMResolvedNotificationOptions } from './notification-options';
 export interface BPMNotificationDispatcher {
     dispatch(notification: NotificationEntity, options: BPMResolvedNotificationOptions): Promise<string>;
+    /**
+     * Sends one message covering several notifications, for a recipient whose
+     * `emailDigestMode` is `DAILY`.
+     *
+     * Optional. Without it BPM falls back to {@link dispatch} once per row, so
+     * a `DAILY` recipient still gets their email held until the digest hour but
+     * receives one message per notification rather than one combined message.
+     * BPM's built-in SMTP path always combines.
+     *
+     * Every notification in the batch is for the same recipient and channel.
+     * Return the delivery target recorded against every row in the batch.
+     */
+    dispatchDigest?(notifications: readonly NotificationEntity[], options: BPMResolvedNotificationOptions): Promise<string>;
 }
 export declare const BPM_NOTIFICATION_DISPATCHER: InjectionToken<BPMNotificationDispatcher>;

package/src/lib/notification/notification-dispatcher.token.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-dispatcher.token.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-dispatcher.token.ts"],"names":[],"mappings":";;;AAWa,QAAA,2BAA2B,GACtC,MAAM,CAAC,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"notification-dispatcher.token.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-dispatcher.token.ts"],"names":[],"mappings":";;;AA4Ba,QAAA,2BAA2B,GACtC,MAAM,CAAC,6BAA6B,CAAC,CAAC"}

package/src/lib/notification/notification-observer.token.d.ts

@@ -11,6 +11,12 @@ export interface BPMNotificationsCreatedEvent {
      * Note that a batch is always for **one recipient**: several rows mean
      * several channels, not several people. A node assigned to three approvers
      * produces three separate events.
+     *
+     * A row whose `silenced` flag is set was recorded but must not be
+     * announced: the recipient turned in-app notifications off, or it arrived
+     * inside their quiet hours. Push it into the list without a toast rather
+     * than skipping it — the row exists precisely so the notification centre
+     * stays complete.
      */
     readonly notifications: readonly NotificationEntity[];
     /**

package/src/lib/notification/notification-observer.token.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-observer.token.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-observer.token.ts"],"names":[],"mappings":";;;AAwDa,QAAA,yBAAyB,GACpC,MAAM,CAAC,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"notification-observer.token.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-observer.token.ts"],"names":[],"mappings":";;;AA8Da,QAAA,yBAAyB,GACpC,MAAM,CAAC,2BAA2B,CAAC,CAAC"}

package/src/lib/notification/notification-options.d.ts

@@ -112,6 +112,18 @@ export interface BPMRootNotificationOptions {
      * by the current attempt count.
      */
     readonly notificationDeliveryRetryBaseDelayMs?: number;
+    /**
+     * Maximum time in milliseconds a single delivery dispatch may take before it
+     * is recorded as a failed attempt.
+     *
+     * Covers the whole dispatch, including the host `BPM_NOTIFICATION_DISPATCHER`,
+     * member resolution and the SMTP or webhook call. Delivery claims a row
+     * before dispatching and only writes back on success or failure, so a
+     * dispatch that never settles would otherwise leave that row permanently in
+     * `DELIVERY_IN_PROGRESS` with no recorded error. Defaults to `30000`. Set to
+     * `0` to wait indefinitely.
+     */
+    readonly notificationDeliveryDispatchTimeoutMs?: number;
     /**
      * Enables the background SLA scheduler that scans pending tasks.
      *
@@ -179,6 +191,28 @@ export interface BPMRootNotificationOptions {
      * Default email digest mode for members without a stored preference.
      */
     readonly notificationDefaultEmailDigestMode?: NotificationDigestModeEnum;
+    /**
+     * IANA time zone the members' `quietHoursStart` / `quietHoursEnd`
+     * preferences are read in.
+     *
+     * Those columns store a bare wall-clock time, so a zone is required to turn
+     * "22:00" into an instant. When omitted, BPM reads the zone off the
+     * registered `BPM_BUSINESS_CALENDAR` — the host's own calendar when it
+     * supplied one, otherwise the built-in weekday calendar built from
+     * `notificationSlaBusinessCalendarTimeZone`. A host that already told BPM
+     * where its people work therefore gets sensible quiet hours without a second
+     * setting. Set this only when notification quiet hours and business days
+     * belong to different zones.
+     */
+    readonly notificationQuietHoursTimeZone?: string;
+    /**
+     * Local hour (0–23) at which held email is flushed for members whose
+     * `emailDigestMode` is `DAILY`.
+     *
+     * Read in `notificationQuietHoursTimeZone`. Defaults to `9`. Values outside
+     * 0–23 fall back to the default rather than throwing at wiring time.
+     */
+    readonly notificationEmailDigestHour?: number;
     /**
      * Default in-app notification preference for members without a stored
      * preference.
@@ -204,10 +238,19 @@ export interface BPMResolvedNotificationOptions {
     readonly defaultEmailPreferenceEnabled: boolean;
     readonly defaultInAppPreferenceEnabled: boolean;
     readonly deliveryBatchSize: number;
+    readonly deliveryDispatchTimeoutMs: number;
     readonly deliveryMaxAttempts: number;
     readonly deliveryRetryBaseDelayMs: number;
     readonly deliveryScanIntervalMs: number;
     readonly deliverySchedulerEnabled: boolean;
+    readonly emailDigestHour: number;
+    /**
+     * `null` when the host did not configure one, which means "use the
+     * registered business calendar's zone" — resolved at notification time,
+     * because the calendar is a DI provider and options are flattened before it
+     * exists.
+     */
+    readonly quietHoursTimeZone: string | null;
     readonly slaBusinessCalendarTimeZone: string;
     readonly slaScanIntervalMs: number;
     readonly slaSchedulerEnabled: boolean;