npm - @rytass/bpm-core-nestjs-module - Versions diffs - 0.9.1 → 0.11.0 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

package/src/lib/notification/notification-options.js CHANGED Viewed

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_BPM_NOTIFICATION_OPTIONS = exports.BPM_NOTIFICATION_OPTIONS = void 0;
 exports.resolveBPMNotificationOptions = resolveBPMNotificationOptions;
+const notification_schedule_1 = require("./notification-schedule");
 const notification_enums_1 = require("./notification.enums");
 exports.BPM_NOTIFICATION_OPTIONS = Symbol('BPM_NOTIFICATION_OPTIONS');
 exports.DEFAULT_BPM_NOTIFICATION_OPTIONS = {
@@ -18,10 +19,13 @@ exports.DEFAULT_BPM_NOTIFICATION_OPTIONS = {
     defaultEmailPreferenceEnabled: true,
     defaultInAppPreferenceEnabled: true,
     deliveryBatchSize: 25,
+    deliveryDispatchTimeoutMs: 30_000,
     deliveryMaxAttempts: 3,
     deliveryRetryBaseDelayMs: 60_000,
     deliveryScanIntervalMs: 30_000,
     deliverySchedulerEnabled: false,
+    emailDigestHour: notification_schedule_1.DEFAULT_EMAIL_DIGEST_HOUR,
+    quietHoursTimeZone: null,
     slaBusinessCalendarTimeZone: 'UTC',
     slaScanIntervalMs: 60_000,
     slaSchedulerEnabled: false,
@@ -42,9 +46,11 @@ function resolveBPMNotificationOptions(options = {}) {
     const emailFrom = normalizeText(options.notificationEmailFrom);
     const webhookSigningSecret = normalizeText(options.notificationWebhookSigningSecret);
     const webhookEndpointUrl = normalizeText(options.notificationWebhookEndpointUrl);
+    const slaBusinessCalendarTimeZone = normalizeTimeZone(options.notificationSlaBusinessCalendarTimeZone, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaBusinessCalendarTimeZone);
     return {
         deliveryScanIntervalMs: normalizeInterval(options.notificationDeliveryScanIntervalMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryScanIntervalMs),
         deliveryBatchSize: normalizePositiveInteger(options.notificationDeliveryBatchSize, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryBatchSize),
+        deliveryDispatchTimeoutMs: normalizeTimeout(options.notificationDeliveryDispatchTimeoutMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryDispatchTimeoutMs),
         deliveryMaxAttempts: normalizePositiveInteger(options.notificationDeliveryMaxAttempts, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryMaxAttempts),
         deliveryRetryBaseDelayMs: normalizeInterval(options.notificationDeliveryRetryBaseDelayMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryRetryBaseDelayMs),
         deliverySchedulerEnabled: options.notificationDeliverySchedulerEnabled ??
@@ -70,7 +76,13 @@ function resolveBPMNotificationOptions(options = {}) {
             exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.defaultEmailPreferenceEnabled,
         defaultInAppPreferenceEnabled: options.notificationDefaultInAppPreferenceEnabled ??
             exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.defaultInAppPreferenceEnabled,
-        slaBusinessCalendarTimeZone: normalizeTimeZone(options.notificationSlaBusinessCalendarTimeZone),
+        emailDigestHour: (0, notification_schedule_1.normalizeDigestHour)(options.notificationEmailDigestHour),
+        // Left null when unset so `NotificationService` can read the zone off the
+        // registered business calendar. Resolving it here would silently mean UTC
+        // for every host that supplies its own calendar — the calendar knows the
+        // zone, but it does not exist yet at option-flattening time.
+        quietHoursTimeZone: normalizeOptionalTimeZone(options.notificationQuietHoursTimeZone),
+        slaBusinessCalendarTimeZone,
         slaScanIntervalMs: normalizeInterval(options.notificationSlaScanIntervalMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaScanIntervalMs),
         slaSchedulerEnabled: options.notificationSlaSchedulerEnabled ??
             exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaSchedulerEnabled,
@@ -101,21 +113,39 @@ function normalizePort(value) {
         ? value
         : null;
 }
+/**
+ * As {@link normalizeTimeZone}, but reports "not configured" as `null` instead
+ * of substituting a fallback. An unreadable zone is treated as absent, so the
+ * caller's own fallback applies rather than a silently wrong zone.
+ */
+function normalizeOptionalTimeZone(value) {
+    const trimmedValue = value?.trim() ?? '';
+    if (!trimmedValue) {
+        return null;
+    }
+    try {
+        new Intl.DateTimeFormat('en-CA', { timeZone: trimmedValue });
+        return trimmedValue;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Rejects unknown IANA zones at wiring time rather than letting every SLA
  * calculation throw later inside `Intl.DateTimeFormat`.
  */
-function normalizeTimeZone(value) {
+function normalizeTimeZone(value, fallback) {
     const trimmedValue = value?.trim() ?? '';
     if (!trimmedValue) {
-        return exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaBusinessCalendarTimeZone;
+        return fallback;
     }
     try {
         new Intl.DateTimeFormat('en-CA', { timeZone: trimmedValue });
         return trimmedValue;
     }
     catch {
-        return exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaBusinessCalendarTimeZone;
+        return fallback;
     }
 }
 function normalizeInterval(value, fallback) {
@@ -124,6 +154,17 @@ function normalizeInterval(value, fallback) {
     }
     return Math.max(value, 1000);
 }
+/**
+ * Unlike {@link normalizeInterval} this accepts `0`, which means "wait
+ * indefinitely" for a dispatch, and imposes no 1000ms floor: a host may want a
+ * tight timeout without that being mistaken for a scan loop.
+ */
+function normalizeTimeout(value, fallback) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+        return fallback;
+    }
+    return value;
+}
 function normalizePositiveInteger(value, fallback) {
     if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0) {
         return fallback;

package/src/lib/notification/notification-options.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"notification-options.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-options.ts"],"names":[],"mappings":";;;~~AAoSA~~,~~sEAsGC~~;~~AAzYD~~,6DAG8B;~~AA6PjB~~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~~iBAAiB~~,~~CAC5C~~,OAAO,CAAC,~~uCAAuC~~,~~CAChD~~;QACD,iBAAiB,EAAE,iBAAiB,CAClC,OAAO,CAAC,6BAA6B,EACrC,wCAAgC,CAAC,iBAAiB,CACnD;QACD,mBAAmB,EACjB,OAAO,CAAC,+BAA+B;YACvC,wCAAgC,CAAC,mBAAmB;QACtD,4BAA4B,EAC1B,OAAO,CAAC,wCAAwC;YAChD,wCAAgC,CAAC,4BAA4B;QAC/D,yBAAyB,EACvB,OAAO,CAAC,qCAAqC;YAC7C,wCAAgC,CAAC,yBAAyB;QAC5D,uBAAuB,EACrB,OAAO,CAAC,mCAAmC;YAC3C,wCAAgC,CAAC,uBAAuB;QAC1D,kCAAkC,EAChC,OAAO,CAAC,8CAA8C;YACtD,wCAAgC,CAAC,kCAAkC;QACrE,cAAc,EACZ,OAAO,CAAC,0BAA0B;YAClC,wCAAgC,CAAC,cAAc;QACjD,cAAc,EAAE,aAAa,CAC3B,OAAO,CAAC,0BAA0B,IAAI,MAAM,EAC5C,OAAO,CAAC,kBAAkB,IAAI,oBAAoB,CAAC,CACpD;QACD,kBAAkB;QAClB,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,MAAiC,EACjC,SAAkB;IAElB,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAC,KAAgC;IACrD,MAAM,YAAY,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEzC,OAAO,YAAY,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED,SAAS,aAAa,CAAC,KAAgC;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACtE,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED~~;;;GAGG~~;AACH,SAAS,~~iBAAiB~~,CAAC,KAAyB;~~IAClD~~,MAAM,YAAY,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,~~wCAAgC~~,CAAC~~,2BAA2B,CAAC~~;~~IACtE~~,CAAC;IAED,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAE7D,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,~~wCAAgC~~,CAAC,~~2BAA2B~~,CAAC;~~IACtE~~,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAyB,EACzB,QAAgB;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAyB,EACzB,QAAgB;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACxB,QAAwD;IAExD,MAAM,kBAAkB,GACtB,QAAQ;QACN,EAAE,MAAM,CAAC,qBAAqB,CAAC;SAC9B,MAAM,CACL,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,KAAK,CACxE,IAAI,EAAE,CAAC;IAEZ,OAAO,kBAAkB,CAAC,MAAM;QAC9B,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,wCAAgC,CAAC,eAAe,CAAC;AACvD,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAAC,4CAAuB,CAAC,CAAC,QAAQ,CACpD,KAAgC,CACjC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAAC,+CAA0B,CAAC,CAAC,QAAQ,CACvD,KAAmC,CACpC,CAAC;AACJ,CAAC"}
1	+ {"version":3,"file":"notification-options.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification-options.ts"],"names":[],"mappings":"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"}

package/src/lib/notification/notification-schedule.d.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import { NotificationDigestModeEnum } from './notification.enums';
+export interface NotificationQuietHours {
+    readonly quietHoursEnd: string | null;
+    readonly quietHoursStart: string | null;
+    readonly timeZone: string;
+}
+/**
+ * Whether `at` falls inside the recipient's quiet hours.
+ *
+ * A window whose start equals its end is treated as **no** quiet hours rather
+ * than as all day: the destructive reading of an ambiguous setting is the one
+ * that silently swallows every notification.
+ */
+export declare function isWithinQuietHours(at: Date, { quietHoursEnd, quietHoursStart, timeZone }: NotificationQuietHours): boolean;
+/**
+ * The instant the current quiet period ends, or `null` when `at` is not inside
+ * one.
+ */
+export declare function resolveQuietHoursEnd(at: Date, quietHours: NotificationQuietHours): Date | null;
+export interface EmailReleaseOptions extends NotificationQuietHours {
+    /** Local hour at which a `DAILY` recipient's held email is flushed. */
+    readonly digestHour: number;
+    readonly digestMode: NotificationDigestModeEnum;
+}
+/**
+ * When an email notification created at `at` may actually be sent, or `null`
+ * when it may go out immediately.
+ *
+ * The returned instant is written to the row's `nextRetryAt`, which is exactly
+ * what the delivery scan already treats as "not before": deferring reuses the
+ * retry machinery instead of adding a second scheduler, and means quiet hours
+ * *delay* a notification rather than drop it.
+ */
+export declare function resolveEmailReleaseAt(at: Date, options: EmailReleaseOptions): Date | null;
+export declare const DEFAULT_EMAIL_DIGEST_HOUR = 9;
+/**
+ * Last-resort zone for quiet hours, used only when neither
+ * `notificationQuietHoursTimeZone` nor a registered business calendar answers.
+ */
+export declare const DEFAULT_QUIET_HOURS_TIME_ZONE = "UTC";
+export declare function normalizeDigestHour(value: number | undefined): number;

package/src/lib/notification/notification-schedule.js ADDED Viewed

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_QUIET_HOURS_TIME_ZONE = exports.DEFAULT_EMAIL_DIGEST_HOUR = void 0;
+exports.isWithinQuietHours = isWithinQuietHours;
+exports.resolveQuietHoursEnd = resolveQuietHoursEnd;
+exports.resolveEmailReleaseAt = resolveEmailReleaseAt;
+exports.normalizeDigestHour = normalizeDigestHour;
+const notification_enums_1 = require("./notification.enums");
+const MINUTES_PER_DAY = 24 * 60;
+const MS_PER_MINUTE = 60_000;
+const MS_PER_DAY = 24 * 60 * MS_PER_MINUTE;
+/**
+ * A `time` column value as stored by `notification_preferences`, expressed as
+ * minutes since local midnight. `null` when the preference is unset or holds a
+ * value the DTO pattern would have rejected — a stored value BPM cannot read
+ * must degrade to "no quiet hours" rather than throw during delivery.
+ */
+function parseTimeOfDay(value) {
+    const match = /^([01]\d|2[0-3]):([0-5]\d)(?::[0-5]\d)?$/.exec(value?.trim() ?? '');
+    if (!match) {
+        return null;
+    }
+    return Number(match[1]) * 60 + Number(match[2]);
+}
+function readZonedWallClock(at, timeZone) {
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        day: '2-digit',
+        hour: '2-digit',
+        hour12: false,
+        minute: '2-digit',
+        month: '2-digit',
+        timeZone,
+        year: 'numeric',
+    }).formatToParts(at);
+    const read = (type) => Number(parts.find((part) => part.type === type)?.value ?? '0');
+    // `hourCycle: h23` is what `hour12: false` resolves to in every runtime this
+    // package supports, but Node has historically rendered midnight as `24`.
+    const hour = read('hour');
+    return {
+        day: read('day'),
+        hour: hour === 24 ? 0 : hour,
+        minute: read('minute'),
+        month: read('month'),
+        year: read('year'),
+    };
+}
+/** How far ahead of UTC the zone's local clock runs at `at`, in milliseconds. */
+function readZoneOffsetMs(at, timeZone) {
+    const wallClock = readZonedWallClock(at, timeZone);
+    return (Date.UTC(wallClock.year, wallClock.month - 1, wallClock.day, wallClock.hour, wallClock.minute) -
+        // The formatter drops seconds and milliseconds, so compare against an
+        // instant truncated the same way.
+        Math.floor(at.getTime() / MS_PER_MINUTE) * MS_PER_MINUTE);
+}
+/**
+ * The instant at which the zone's local clock reads the given wall-clock time.
+ *
+ * Resolved in two passes because the offset to apply is itself a function of
+ * the instant: the first pass guesses using the offset in force at the naive
+ * UTC reading, the second re-reads the offset at that guess. That settles
+ * every case except a wall-clock time inside a spring-forward gap, which does
+ * not exist locally and lands on the instant the clock jumps to.
+ */
+function zonedWallClockToInstant(wallClock, timeZone) {
+    const naiveUtc = Date.UTC(wallClock.year, wallClock.month - 1, wallClock.day, wallClock.hour, wallClock.minute);
+    const firstGuess = new Date(naiveUtc - readZoneOffsetMs(new Date(naiveUtc), timeZone));
+    return new Date(naiveUtc - readZoneOffsetMs(firstGuess, timeZone));
+}
+/**
+ * The first instant at or after `at` whose local clock reads
+ * `minuteOfDay`. Returns `at` itself when it already lands exactly there.
+ */
+function nextLocalTimeOfDay(at, timeZone, minuteOfDay) {
+    const wallClock = readZonedWallClock(at, timeZone);
+    const sameDay = zonedWallClockToInstant({
+        ...wallClock,
+        hour: Math.floor(minuteOfDay / 60),
+        minute: minuteOfDay % 60,
+    }, timeZone);
+    if (sameDay.getTime() >= at.getTime()) {
+        return sameDay;
+    }
+    // Step a day forward through the instant rather than the calendar so a
+    // month or year boundary needs no special case, then re-anchor the local
+    // time in case the offset changed overnight.
+    const nextDay = readZonedWallClock(new Date(sameDay.getTime() + MS_PER_DAY), timeZone);
+    return zonedWallClockToInstant({
+        ...nextDay,
+        hour: Math.floor(minuteOfDay / 60),
+        minute: minuteOfDay % 60,
+    }, timeZone);
+}
+/**
+ * Whether `at` falls inside the recipient's quiet hours.
+ *
+ * A window whose start equals its end is treated as **no** quiet hours rather
+ * than as all day: the destructive reading of an ambiguous setting is the one
+ * that silently swallows every notification.
+ */
+function isWithinQuietHours(at, { quietHoursEnd, quietHoursStart, timeZone }) {
+    const start = parseTimeOfDay(quietHoursStart);
+    const end = parseTimeOfDay(quietHoursEnd);
+    if (start === null || end === null || start === end) {
+        return false;
+    }
+    const wallClock = readZonedWallClock(at, timeZone);
+    const minuteOfDay = wallClock.hour * 60 + wallClock.minute;
+    return start < end
+        ? minuteOfDay >= start && minuteOfDay < end
+        : // A window that wraps past midnight (22:00–08:00) is the common case.
+            minuteOfDay >= start || minuteOfDay < end;
+}
+/**
+ * The instant the current quiet period ends, or `null` when `at` is not inside
+ * one.
+ */
+function resolveQuietHoursEnd(at, quietHours) {
+    if (!isWithinQuietHours(at, quietHours)) {
+        return null;
+    }
+    const end = parseTimeOfDay(quietHours.quietHoursEnd);
+    return end === null
+        ? null
+        : nextLocalTimeOfDay(at, quietHours.timeZone, end % MINUTES_PER_DAY);
+}
+/**
+ * When an email notification created at `at` may actually be sent, or `null`
+ * when it may go out immediately.
+ *
+ * The returned instant is written to the row's `nextRetryAt`, which is exactly
+ * what the delivery scan already treats as "not before": deferring reuses the
+ * retry machinery instead of adding a second scheduler, and means quiet hours
+ * *delay* a notification rather than drop it.
+ */
+function resolveEmailReleaseAt(at, options) {
+    const digestAt = options.digestMode === notification_enums_1.NotificationDigestModeEnum.DAILY
+        ? nextLocalTimeOfDay(at, options.timeZone, normalizeDigestHour(options.digestHour) * 60)
+        : at;
+    // Re-checked at the digest boundary, not at `at`: a digest hour that itself
+    // falls inside the quiet window must still wait for the window to close.
+    const releaseAt = resolveQuietHoursEnd(digestAt, options) ?? digestAt;
+    return releaseAt.getTime() > at.getTime() ? releaseAt : null;
+}
+exports.DEFAULT_EMAIL_DIGEST_HOUR = 9;
+/**
+ * Last-resort zone for quiet hours, used only when neither
+ * `notificationQuietHoursTimeZone` nor a registered business calendar answers.
+ */
+exports.DEFAULT_QUIET_HOURS_TIME_ZONE = 'UTC';
+function normalizeDigestHour(value) {
+    return typeof value === 'number' &&
+        Number.isInteger(value) &&
+        value >= 0 &&
+        value <= 23
+        ? value
+        : exports.DEFAULT_EMAIL_DIGEST_HOUR;
+}
+//# sourceMappingURL=notification-schedule.js.map

package/src/lib/notification/notification-schedule.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/src/lib/notification/notification.entity.d.ts CHANGED Viewed

@@ -19,6 +19,18 @@ export declare class NotificationEntity {
      * default list without deleting the record, so statistics and audits keep it.
      */
     archivedAt: Date | null;
+    /**
+     * The row was recorded but deliberately not announced, because the
+     * recipient's preferences asked for quiet — `inAppEnabled: false`, or the
+     * notification arriving inside their quiet hours.
+     *
+     * BPM keeps writing the row either way: "do not interrupt me" and "do not
+     * keep a record" are different requests, and a notification centre that
+     * silently loses an approval task is the worse failure. Hosts driving a
+     * realtime channel should skip the toast or push for a silenced row and
+     * style it as read-later in the list.
+     */
+    silenced: boolean;
     attemptCount: number;
     lastAttemptAt: Date | null;
     nextRetryAt: Date | null;

package/src/lib/notification/notification.entity.js CHANGED Viewed

@@ -105,6 +105,11 @@ tslib_1.__decorate([
     (0, graphql_1.Field)(() => Date, { nullable: true }),
     tslib_1.__metadata("design:type", Object)
 ], NotificationEntity.prototype, "archivedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('boolean', { name: 'silenced', default: false }),
+    (0, graphql_1.Field)(),
+    tslib_1.__metadata("design:type", Boolean)
+], NotificationEntity.prototype, "silenced", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)('integer', { name: 'attempt_count', default: 0 }),
     (0, graphql_1.Field)(() => Number),

package/src/lib/notification/notification.entity.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"notification.entity.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification.entity.ts"],"names":[],"mappings":";;;;AAAA,6CAAwD;AACxD,qCAMiB;AACjB,6DAK8B;AAE9B,MAAM,6BAA6B,GACjC,IAAI,GAAG,CAAC;IACN,yCAAoB,CAAC,aAAa;IAClC,yCAAoB,CAAC,gBAAgB;CACtC,CAAC,CAAC;AASE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAAxB;~~QAiGL~~;;;;WAIG;QAEH,gBAAW,GAAmB,IAAI,CAAC;IAarC,CAAC;IAxBC,IACI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAUD;;;;OAIG;IACH,IACI,UAAU;QACZ,OAAO,CACL,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CACxE,CAAC;IACJ,CAAC;CACF,CAAA;~~AApHY~~,gDAAkB;AAG7B;IAFC,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,CAAC;;8CACJ;AAIZ;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC/C,IAAA,eAAK,GAAE;;6DACmB;AAI3B;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,4CAAuB,CAAC;;mDACH;AAIlC;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,yCAAoB,CAAC;;gDACN;AAI5B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACT;AAI3B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACnD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACb;AAIvB;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,GAAE;;iDACO;AAIf;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,GAAE;;gDACM;AAGd;IADC,IAAA,gBAAM,EAAC,OAAO,CAAC;;mDAC4B;AAI5C;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,2CAAsB,CAAC;;kDACJ;AAIhC;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,+CAA0B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACb;AAI/C;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACb;AAIzB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACjB;AAIrB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACjB;AAQrB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACb;~~AAIzB~~;IAFC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;wDACE;AAItB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAClE,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACV;AAI5B;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChE,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACZ;AAI1B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACV;AAI9B;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACZ;AAI1B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;0DACT;AAI/B;IAFC,IAAA,0BAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC7D,IAAA,eAAK,GAAE;sCACI,IAAI;qDAAC;AAEjB;IAAC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;;qDAGnB;AAQD;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACN;AAOnC;IAAC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;;oDAKpB;~~6BAnHU~~,kBAAkB;IAP9B,IAAA,gBAAM,EAAC,eAAe,CAAC;IACvB,IAAA,eAAK,EAAC,oCAAoC,EAAE;QAC3C,QAAQ;QACR,aAAa;QACb,WAAW;KACZ,CAAC;IACD,IAAA,oBAAU,EAAC,cAAc,CAAC;GACd,kBAAkB,~~CAoH9B~~"}
1	+ {"version":3,"file":"notification.entity.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification.entity.ts"],"names":[],"mappings":";;;;AAAA,6CAAwD;AACxD,qCAMiB;AACjB,6DAK8B;AAE9B,MAAM,6BAA6B,GACjC,IAAI,GAAG,CAAC;IACN,yCAAoB,CAAC,aAAa;IAClC,yCAAoB,CAAC,gBAAgB;CACtC,CAAC,CAAC;AASE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAAxB;QAgHL;;;;WAIG;QAEH,gBAAW,GAAmB,IAAI,CAAC;IAarC,CAAC;IAxBC,IACI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAUD;;;;OAIG;IACH,IACI,UAAU;QACZ,OAAO,CACL,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CACxE,CAAC;IACJ,CAAC;CACF,CAAA;AAnIY,gDAAkB;AAG7B;IAFC,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,CAAC;;8CACJ;AAIZ;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC/C,IAAA,eAAK,GAAE;;6DACmB;AAI3B;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,4CAAuB,CAAC;;mDACH;AAIlC;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,yCAAoB,CAAC;;gDACN;AAI5B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACT;AAI3B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACnD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACb;AAIvB;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,GAAE;;iDACO;AAIf;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,GAAE;;gDACM;AAGd;IADC,IAAA,gBAAM,EAAC,OAAO,CAAC;;mDAC4B;AAI5C;IAFC,IAAA,gBAAM,EAAC,MAAM,CAAC;IACd,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,2CAAsB,CAAC;;kDACJ;AAIhC;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,+CAA0B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACb;AAI/C;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACb;AAIzB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACjB;AAIrB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACjB;AAQrB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACb;AAezB;IAFC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvD,IAAA,eAAK,GAAE;;oDACW;AAInB;IAFC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxD,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;wDACE;AAItB;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAClE,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACV;AAI5B;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChE,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACZ;AAI1B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACV;AAI9B;IAFC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACZ;AAI1B;IAFC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;0DACT;AAI/B;IAFC,IAAA,0BAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC7D,IAAA,eAAK,GAAE;sCACI,IAAI;qDAAC;AAEjB;IAAC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;;qDAGnB;AAQD;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACN;AAOnC;IAAC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;;oDAKpB;6BAlIU,kBAAkB;IAP9B,IAAA,gBAAM,EAAC,eAAe,CAAC;IACvB,IAAA,eAAK,EAAC,oCAAoC,EAAE;QAC3C,QAAQ;QACR,aAAa;QACb,WAAW;KACZ,CAAC;IACD,IAAA,oBAAU,EAAC,cAAc,CAAC;GACd,kBAAkB,CAmI9B"}

package/src/lib/notification/notification.service.d.ts CHANGED Viewed

@@ -138,6 +138,16 @@ export declare class NotificationService {
      * approval.
      */
     private notifyObserver;
+    /**
+     * The zone the recipients' bare `HH:mm` quiet-hours preferences are read in.
+     *
+     * Falls back to the registered business calendar rather than to UTC: the
+     * calendar already states where the host's people are, and a host that
+     * supplied one would otherwise get quiet hours silently offset by its whole
+     * UTC offset. Resolved here rather than in the flattened options because the
+     * calendar is a DI provider that does not exist at wiring time.
+     */
+    private readQuietHoursTimeZone;
     private readHostObserver;
     private recordSlaActivity;
     private runSlaTimeoutHook;

package/src/lib/notification/notification.service.js CHANGED Viewed

@@ -8,6 +8,7 @@ const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const typeorm_1 = require("@nestjs/typeorm");
 const typeorm_2 = require("typeorm");
+const business_calendar_token_1 = require("../calendar/business-calendar.token");
 const iso_duration_1 = require("../common/iso-duration");
 const activity_log_entity_1 = require("../workflow-engine/activity-log.entity");
 const approval_instance_entity_1 = require("../workflow-engine/approval-instance.entity");
@@ -18,6 +19,7 @@ const workflow_engine_tokens_1 = require("../workflow-engine/workflow-engine.tok
 const workflow_engine_enums_1 = require("../workflow-engine/workflow-engine.enums");
 const notification_delivery_service_1 = require("./notification-delivery.service");
 const notification_preference_entity_1 = require("./notification-preference.entity");
+const notification_schedule_1 = require("./notification-schedule");
 const notification_entity_1 = require("./notification.entity");
 const notification_enums_1 = require("./notification.enums");
 const ACTIONABLE_NOTIFICATION_TYPES = [
@@ -507,27 +509,44 @@ let NotificationService = NotificationService_1 = class NotificationService {
         }, Promise.resolve(0));
         return createdNotifications > 0;
     }
-    async createNotifications(input, manager) {
+    async createNotifications(input, manager, now = new Date()) {
         const preference = await this.getPreference(input.recipientMemberId);
         const repository = manager
             ? manager.getRepository(notification_entity_1.NotificationEntity)
             : this.notificationRepository;
-        const notifications = input.channels.flatMap((channel) => isChannelEnabled(channel, preference, this.notificationOptions)
-            ? [
-                createNotificationEntity({
-                    channel,
-                    input,
-                    options: this.notificationOptions,
-                    repository,
-                }),
-            ]
-            : []);
+        const quietHoursTimeZone = this.readQuietHoursTimeZone();
+        const notifications = input.channels.flatMap((channel) => {
+            const delivery = resolveChannelDelivery({
+                at: now,
+                channel,
+                options: this.notificationOptions,
+                preference,
+                quietHoursTimeZone,
+            });
+            return delivery.record
+                ? [
+                    createNotificationEntity({
+                        channel,
+                        input,
+                        now,
+                        options: this.notificationOptions,
+                        releaseAt: delivery.releaseAt,
+                        repository,
+                        silenced: delivery.silenced,
+                    }),
+                ]
+                : [];
+        });
         if (notifications.length === 0) {
             return [];
         }
         const savedNotifications = await repository.save(notifications);
         await Promise.all(savedNotifications
-            .filter((notification) => notification.channel !== notification_enums_1.NotificationChannelEnum.IN_APP)
+            .filter((notification) => notification.channel !== notification_enums_1.NotificationChannelEnum.IN_APP &&
+            // A row held for quiet hours or a daily digest carries its release
+            // instant in `nextRetryAt`; the delivery scan is what picks it up
+            // once that instant passes.
+            notification.nextRetryAt === null)
             .map((notification) => manager
             ? Promise.resolve(false)
             : this.deliveryService.deliverNotification(notification, this.notificationOptions)));
@@ -561,6 +580,28 @@ let NotificationService = NotificationService_1 = class NotificationService {
             this.logger.error(`BPM_NOTIFICATION_OBSERVER failed for ${notifications.length} notification(s)`, error instanceof Error ? error.stack : String(error));
         }
     }
+    /**
+     * The zone the recipients' bare `HH:mm` quiet-hours preferences are read in.
+     *
+     * Falls back to the registered business calendar rather than to UTC: the
+     * calendar already states where the host's people are, and a host that
+     * supplied one would otherwise get quiet hours silently offset by its whole
+     * UTC offset. Resolved here rather than in the flattened options because the
+     * calendar is a DI provider that does not exist at wiring time.
+     */
+    readQuietHoursTimeZone() {
+        if (this.notificationOptions.quietHoursTimeZone) {
+            return this.notificationOptions.quietHoursTimeZone;
+        }
+        try {
+            return this.moduleRef.get(business_calendar_token_1.BPM_BUSINESS_CALENDAR, {
+                strict: false,
+            }).timeZone;
+        }
+        catch {
+            return notification_schedule_1.DEFAULT_QUIET_HOURS_TIME_ZONE;
+        }
+    }
     readHostObserver() {
         try {
             return this.moduleRef.get(notification_observer_token_1.BPM_NOTIFICATION_OBSERVER, { strict: false });
@@ -769,14 +810,49 @@ function isUniqueConstraintViolation(error) {
         'code' in error &&
         error.code === '23505');
 }
-function isChannelEnabled(channel, preference, options) {
+/**
+ * Splits a channel's fate into "is it recorded" and "is it announced", which
+ * `inAppEnabled` used to conflate.
+ *
+ * The member preference decides announcement. Recording is the host's call:
+ * `options.inAppEnabled` is a wiring-level switch for running BPM without
+ * notification-centre data at all, not something a member can trip. Email and
+ * webhook have no BPM-side record to lose, so for them the two answers stay
+ * the same — except in time, where quiet hours and the daily digest push
+ * delivery later rather than dropping it.
+ */
+function resolveChannelDelivery({ at, channel, options, preference, quietHoursTimeZone, }) {
+    const quietHours = {
+        quietHoursEnd: preference.quietHoursEnd,
+        quietHoursStart: preference.quietHoursStart,
+        timeZone: quietHoursTimeZone,
+    };
     if (channel === notification_enums_1.NotificationChannelEnum.IN_APP) {
-        return options.inAppEnabled && preference.inAppEnabled;
+        return {
+            releaseAt: null,
+            record: options.inAppEnabled,
+            silenced: !preference.inAppEnabled || (0, notification_schedule_1.isWithinQuietHours)(at, quietHours),
+        };
     }
     if (channel === notification_enums_1.NotificationChannelEnum.EMAIL) {
-        return options.emailEnabled && preference.emailEnabled;
-    }
-    return options.webhookEnabled;
+        const record = options.emailEnabled && preference.emailEnabled;
+        return {
+            releaseAt: record
+                ? (0, notification_schedule_1.resolveEmailReleaseAt)(at, {
+                    ...quietHours,
+                    digestHour: options.emailDigestHour,
+                    digestMode: preference.emailDigestMode,
+                })
+                : null,
+            record,
+            silenced: false,
+        };
+    }
+    return {
+        releaseAt: null,
+        record: options.webhookEnabled,
+        silenced: false,
+    };
 }
 function hasSlaEscalationStep(task) {
     return task.delegationChain.some((step) => step['reason'] === notification_enums_1.SLA_ESCALATION_DELEGATION_REASON);
@@ -793,7 +869,7 @@ function isSlaTimeoutActionEnabled(action, options) {
     }
     return options.slaTimeoutRemindEnabled;
 }
-function createNotificationEntity({ channel, input, options, repository, }) {
+function createNotificationEntity({ channel, input, now, options, releaseAt, repository, silenced, }) {
     const renderedTemplate = (0, notification_template_1.renderNotificationTemplate)({
         customTemplate: input.customTemplate,
         engine: options.templateEngine,
@@ -808,18 +884,21 @@ function createNotificationEntity({ channel, input, options, repository, }) {
         attemptCount: 0,
         body: renderedTemplate.body,
         channel,
-        deliveredAt: isInApp ? new Date() : null,
+        // An in-app row is "delivered" the moment it exists, silenced or not:
+        // what silencing withholds is the announcement, not the record.
+        deliveredAt: isInApp ? now : null,
         deliveryError: null,
         deliveryTarget: null,
         instanceId: input.instanceId,
         lastAttemptAt: null,
-        nextRetryAt: null,
+        nextRetryAt: releaseAt,
         payload: input.payload,
         readAt: null,
         recipientMemberId: input.recipientMemberId,
         resolution: null,
         resolvedAt: null,
-        sentAt: isInApp ? new Date() : null,
+        sentAt: isInApp ? now : null,
+        silenced,
         status: isInApp
             ? notification_enums_1.NotificationStatusEnum.SENT
             : notification_enums_1.NotificationStatusEnum.PENDING,