@rytass/bpm-core-nestjs-module 0.5.0 → 0.5.1

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

@@ -0,0 +1,245 @@
+"use strict";
+var NotificationDeliveryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationDeliveryService = void 0;
+const tslib_1 = require("tslib");
+const node_crypto_1 = require("node:crypto");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const typeorm_1 = require("@nestjs/typeorm");
+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_entity_1 = require("./notification.entity");
+const notification_enums_1 = require("./notification.enums");
+let NotificationDeliveryService = NotificationDeliveryService_1 = class NotificationDeliveryService {
+    constructor(notificationRepository, moduleRef) {
+        this.notificationRepository = notificationRepository;
+        this.moduleRef = moduleRef;
+        this.logger = new common_1.Logger(NotificationDeliveryService_1.name);
+    }
+    async deliverPendingNotifications({ limit, now = new Date(), options, }) {
+        const deliveryLimit = normalizePositiveInteger(limit, options.deliveryBatchSize);
+        const pendingNotifications = await this.claimPendingNotifications({
+            claimStaleBefore: new Date(now.getTime() - options.deliveryRetryBaseDelayMs),
+            limit: deliveryLimit,
+            now,
+        });
+        const results = await Promise.all(pendingNotifications.map((notification) => this.deliverNotification(notification, options)));
+        return results.filter(Boolean).length;
+    }
+    async deliverNotification(notification, options) {
+        if (notification.channel === notification_enums_1.NotificationChannelEnum.IN_APP) {
+            return false;
+        }
+        if (notification.status !== notification_enums_1.NotificationStatusEnum.PENDING &&
+            notification.status !== notification_enums_1.NotificationStatusEnum.DELIVERY_IN_PROGRESS) {
+            return false;
+        }
+        try {
+            const deliveryTarget = await this.dispatch(notification, options);
+            await this.notificationRepository.save({
+                ...notification,
+                attemptCount: notification.attemptCount + 1,
+                deliveredAt: new Date(),
+                deliveryError: null,
+                deliveryTarget,
+                lastAttemptAt: new Date(),
+                nextRetryAt: null,
+                sentAt: new Date(),
+                status: notification_enums_1.NotificationStatusEnum.SENT,
+            });
+            return true;
+        }
+        catch (error) {
+            await this.recordDeliveryFailure(notification, readErrorMessage(error), options);
+            return false;
+        }
+    }
+    async claimPendingNotifications({ claimStaleBefore, limit, now, }) {
+        if (!this.notificationRepository.manager?.transaction) {
+            return this.notificationRepository.find({
+                order: { createdAt: 'ASC' },
+                take: limit,
+                where: [
+                    {
+                        nextRetryAt: (0, typeorm_2.LessThanOrEqual)(now),
+                        status: notification_enums_1.NotificationStatusEnum.PENDING,
+                    },
+                    {
+                        nextRetryAt: (0, typeorm_2.IsNull)(),
+                        status: notification_enums_1.NotificationStatusEnum.PENDING,
+                    },
+                    {
+                        lastAttemptAt: (0, typeorm_2.LessThanOrEqual)(claimStaleBefore),
+                        status: notification_enums_1.NotificationStatusEnum.DELIVERY_IN_PROGRESS,
+                    },
+                ],
+            });
+        }
+        return this.notificationRepository.manager.transaction(async (manager) => {
+            const claimedRows = (await manager.query(`
+            UPDATE notifications
+               SET status = $1,
+                   last_attempt_at = $2
+             WHERE id IN (
+               SELECT id
+                 FROM notifications
+                WHERE (
+                    (
+                      status = $3
+                      AND (next_retry_at IS NULL OR next_retry_at <= $2)
+                    )
+                    OR (
+                      status = $5
+                      AND last_attempt_at <= $6
+                    )
+                  )
+                ORDER BY created_at ASC
+                FOR UPDATE SKIP LOCKED
+                LIMIT $4
+             )
+             RETURNING id
+          `, [
+                notification_enums_1.NotificationStatusEnum.DELIVERY_IN_PROGRESS,
+                now,
+                notification_enums_1.NotificationStatusEnum.PENDING,
+                limit,
+                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) } })
+                : [];
+        });
+    }
+    async dispatch(notification, options) {
+        const hostDispatcher = this.readHostDispatcher();
+        if (hostDispatcher) {
+            return hostDispatcher.dispatch(notification, options);
+        }
+        return this.dispatchBuiltIn(notification, options);
+    }
+    async dispatchBuiltIn(notification, options) {
+        if (notification.channel === notification_enums_1.NotificationChannelEnum.EMAIL) {
+            return this.dispatchEmail(notification, options);
+        }
+        if (notification.channel === notification_enums_1.NotificationChannelEnum.WEBHOOK) {
+            return this.dispatchWebhook(notification, options);
+        }
+        throw new Error(`Unsupported notification channel ${notification.channel}`);
+    }
+    readHostDispatcher() {
+        try {
+            return this.moduleRef.get(notification_dispatcher_token_1.BPM_NOTIFICATION_DISPATCHER, {
+                strict: false,
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+    async dispatchEmail(notification, options) {
+        if (!options.emailEnabled ||
+            !options.emailSmtpHost ||
+            !options.emailSmtpPort ||
+            !options.emailSmtpUsername ||
+            !options.emailSmtpPassword ||
+            !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({
+            auth: {
+                pass: options.emailSmtpPassword,
+                user: options.emailSmtpUsername,
+            },
+            host: options.emailSmtpHost,
+            port: options.emailSmtpPort,
+            secure: options.emailSmtpSecure,
+        });
+        await transporter.sendMail({
+            from: options.emailFrom,
+            subject: notification.title,
+            text: notification.body,
+            to: recipient.email,
+        });
+        return recipient.email;
+    }
+    async dispatchWebhook(notification, options) {
+        if (!options.webhookEnabled ||
+            !options.webhookEndpointUrl ||
+            !options.webhookSigningSecret) {
+            throw new Error('WEBHOOK_DISABLED');
+        }
+        const payload = JSON.stringify({
+            body: notification.body,
+            channel: notification.channel,
+            createdAt: notification.createdAt.toISOString(),
+            id: notification.id,
+            instanceId: notification.instanceId,
+            payload: notification.payload,
+            recipientMemberId: notification.recipientMemberId,
+            taskId: notification.taskId,
+            title: notification.title,
+            type: notification.type,
+        });
+        const signature = (0, node_crypto_1.createHmac)('sha256', options.webhookSigningSecret)
+            .update(payload)
+            .digest('hex');
+        const response = await fetch(options.webhookEndpointUrl, {
+            body: payload,
+            headers: {
+                'content-type': 'application/json',
+                'x-bpm-signature-sha256': signature,
+            },
+            method: 'POST',
+        });
+        if (!response.ok) {
+            throw new Error(`WEBHOOK_HTTP_${response.status}`);
+        }
+        return options.webhookEndpointUrl;
+    }
+    async recordDeliveryFailure(notification, errorMessage, options) {
+        const attemptCount = notification.attemptCount + 1;
+        const failedPermanently = attemptCount >= options.deliveryMaxAttempts;
+        const now = new Date();
+        await this.notificationRepository.save({
+            ...notification,
+            attemptCount,
+            deliveryError: errorMessage,
+            lastAttemptAt: now,
+            nextRetryAt: failedPermanently
+                ? null
+                : new Date(now.getTime() + options.deliveryRetryBaseDelayMs * attemptCount),
+            status: failedPermanently
+                ? notification_enums_1.NotificationStatusEnum.FAILED
+                : notification_enums_1.NotificationStatusEnum.PENDING,
+        });
+        this.logger.warn(`Notification ${notification.id} delivery failed: ${errorMessage}`);
+    }
+};
+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.__metadata("design:paramtypes", [typeorm_2.Repository,
+        core_1.ModuleRef])
+], NotificationDeliveryService);
+function readErrorMessage(error) {
+    return error instanceof Error ? error.message : 'Unknown delivery error';
+}
+function normalizePositiveInteger(value, fallback) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0) {
+        return fallback;
+    }
+    return value;
+}
+//# sourceMappingURL=notification-delivery.service.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,7 @@
+import { InjectionToken } from '@nestjs/common';
+import { NotificationEntity } from './notification.entity';
+import { BPMResolvedNotificationOptions } from './notification-options';
+export interface BPMNotificationDispatcher {
+    dispatch(notification: NotificationEntity, options: BPMResolvedNotificationOptions): Promise<string>;
+}
+export declare const BPM_NOTIFICATION_DISPATCHER: InjectionToken<BPMNotificationDispatcher>;

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

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPM_NOTIFICATION_DISPATCHER = void 0;
+exports.BPM_NOTIFICATION_DISPATCHER = Symbol('BPM_NOTIFICATION_DISPATCHER');
+//# sourceMappingURL=notification-dispatcher.token.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,215 @@
+import { InjectionToken } from '@nestjs/common';
+import { NotificationChannelEnum, NotificationDigestModeEnum } from './notification.enums';
+export type NotificationFeatureToggle = boolean | 'auto';
+export type NotificationTemplateEngine = 'handlebars' | 'simple';
+export interface BPMRootNotificationOptions {
+    /**
+     * Enables creation and display of in-app notification records.
+     *
+     * Defaults to `true`. Set to `false` only when the host application wants
+     * BPM to run without notification center data.
+     */
+    readonly notificationInAppEnabled?: boolean;
+    /**
+     * Controls whether BPM may create and dispatch email notifications.
+     *
+     * Use `auto` to enable email only when all SMTP connection fields are
+     * present. Use `false` to force email off even when SMTP secrets exist.
+     * Defaults to `auto`.
+     */
+    readonly notificationEmailEnabled?: NotificationFeatureToggle;
+    /**
+     * SMTP server hostname used for BPM email delivery.
+     *
+     * Required when `notificationEmailEnabled` is `true`; required for auto
+     * enablement when `notificationEmailEnabled` is `auto`.
+     */
+    readonly notificationEmailSmtpHost?: string | null;
+    /**
+     * SMTP server port used for BPM email delivery.
+     *
+     * Common values are `587` for STARTTLS and `465` for implicit TLS. Required
+     * when `notificationEmailEnabled` is `true`; required for auto enablement
+     * when `notificationEmailEnabled` is `auto`.
+     */
+    readonly notificationEmailSmtpPort?: number | null;
+    /**
+     * Whether the SMTP connection should use implicit TLS.
+     *
+     * Use `false` for STARTTLS on port `587`; use `true` for implicit TLS on
+     * port `465`. Defaults to `false`.
+     */
+    readonly notificationEmailSmtpSecure?: boolean;
+    /**
+     * SMTP authentication username used by BPM email delivery.
+     *
+     * Required when `notificationEmailEnabled` is `true`; required for auto
+     * enablement when `notificationEmailEnabled` is `auto`.
+     */
+    readonly notificationEmailSmtpUsername?: string | null;
+    /**
+     * SMTP authentication password or app password used by BPM email delivery.
+     *
+     * Required when `notificationEmailEnabled` is `true`; required for auto
+     * enablement when `notificationEmailEnabled` is `auto`.
+     */
+    readonly notificationEmailSmtpPassword?: string | null;
+    /**
+     * Sender address used for BPM email delivery.
+     *
+     * Accepts either an email address or an RFC 5322 display format such as
+     * `BPM <bpm@example.com>`. Required when email delivery is enabled.
+     */
+    readonly notificationEmailFrom?: string | null;
+    /**
+     * Controls whether BPM may create and dispatch webhook notifications.
+     *
+     * Use `auto` to enable webhooks only when
+     * `notificationWebhookSigningSecret` is present. Use `false` to force
+     * webhooks off. Defaults to `auto`.
+     */
+    readonly notificationWebhookEnabled?: NotificationFeatureToggle;
+    /**
+     * Secret used to sign BPM webhook payloads.
+     *
+     * Required when `notificationWebhookEnabled` is `true`; required for auto
+     * enablement when `notificationWebhookEnabled` is `auto`.
+     */
+    readonly notificationWebhookSigningSecret?: string | null;
+    /**
+     * Default endpoint URL used for BPM webhook notification delivery.
+     *
+     * Required when `notificationWebhookEnabled` is `true`; required for auto
+     * enablement when `notificationWebhookEnabled` is `auto`.
+     */
+    readonly notificationWebhookEndpointUrl?: string | null;
+    /**
+     * Enables the background delivery scheduler for pending email and webhook
+     * notifications.
+     *
+     * Defaults to `false`. Set to `true` only in a dedicated worker process or
+     * single-replica host that should run notification delivery itself.
+     */
+    readonly notificationDeliverySchedulerEnabled?: boolean;
+    /**
+     * Interval in milliseconds between pending notification delivery scans.
+     *
+     * Defaults to `30000`. Values below `1000` are normalized to `1000` to avoid
+     * tight loops in long-running API processes.
+     */
+    readonly notificationDeliveryScanIntervalMs?: number;
+    /**
+     * Maximum pending notifications processed by each delivery scan.
+     */
+    readonly notificationDeliveryBatchSize?: number;
+    /**
+     * Maximum delivery attempts before a pending email/webhook notification is
+     * marked failed.
+     */
+    readonly notificationDeliveryMaxAttempts?: number;
+    /**
+     * Base retry delay in milliseconds. Retry scheduling multiplies this value
+     * by the current attempt count.
+     */
+    readonly notificationDeliveryRetryBaseDelayMs?: number;
+    /**
+     * Enables the background SLA scheduler that scans pending tasks.
+     *
+     * Defaults to `false`. Set to `true` only in a dedicated worker process or
+     * single-replica host that should run SLA scans itself.
+     */
+    readonly notificationSlaSchedulerEnabled?: boolean;
+    /**
+     * Interval in milliseconds between automatic SLA scans.
+     *
+     * Defaults to `60000`. Values below `1000` are normalized to `1000` to avoid
+     * tight loops in long-running API processes.
+     */
+    readonly notificationSlaScanIntervalMs?: number;
+    /**
+     * Enables the SLA timeout `REMIND` action.
+     *
+     * Defaults to `true`. When disabled, overdue tasks with `REMIND` timeout
+     * policy still keep their task state, but the timeout action hook is skipped.
+     */
+    readonly notificationSlaTimeoutRemindEnabled?: boolean;
+    /**
+     * Enables the SLA timeout `AUTO_APPROVE` action.
+     *
+     * Defaults to `false` because this action changes workflow state and should
+     * be explicitly enabled by the host application.
+     */
+    readonly notificationSlaTimeoutAutoApproveEnabled?: boolean;
+    /**
+     * Enables the SLA timeout `ESCALATE` action.
+     *
+     * Defaults to `false` because escalation changes task assignment and should
+     * be explicitly enabled by the host application.
+     */
+    readonly notificationSlaTimeoutEscalateEnabled?: boolean;
+    /**
+     * Enables the SLA timeout `TERMINATE_INSTANCE` action.
+     *
+     * Defaults to `false` because termination changes instance state and should
+     * be explicitly enabled by the host application.
+     */
+    readonly notificationSlaTimeoutTerminateInstanceEnabled?: boolean;
+    /**
+     * Template engine used to render notification title and body text.
+     *
+     * `simple` uses BPM's built-in `{{path}}` replacement renderer. `handlebars`
+     * reserves the host configuration for the Handlebars renderer once the email
+     * template implementation is wired. Defaults to `simple`.
+     */
+    readonly notificationTemplateEngine?: NotificationTemplateEngine;
+    /**
+     * Channels used when a workflow node does not specify notification channels.
+     */
+    readonly notificationDefaultChannels?: readonly NotificationChannelEnum[];
+    /**
+     * Default email digest mode for members without a stored preference.
+     */
+    readonly notificationDefaultEmailDigestMode?: NotificationDigestModeEnum;
+    /**
+     * Default in-app notification preference for members without a stored
+     * preference.
+     */
+    readonly notificationDefaultInAppPreferenceEnabled?: boolean;
+    /**
+     * Default email notification preference for members without a stored
+     * preference.
+     */
+    readonly notificationDefaultEmailPreferenceEnabled?: boolean;
+}
+export interface BPMResolvedNotificationOptions {
+    readonly emailEnabled: boolean;
+    readonly emailFrom: string | null;
+    readonly emailSmtpHost: string | null;
+    readonly emailSmtpPassword: string | null;
+    readonly emailSmtpPort: number | null;
+    readonly emailSmtpSecure: boolean;
+    readonly emailSmtpUsername: string | null;
+    readonly inAppEnabled: boolean;
+    readonly defaultChannels: readonly NotificationChannelEnum[];
+    readonly defaultEmailDigestMode: NotificationDigestModeEnum;
+    readonly defaultEmailPreferenceEnabled: boolean;
+    readonly defaultInAppPreferenceEnabled: boolean;
+    readonly deliveryBatchSize: number;
+    readonly deliveryMaxAttempts: number;
+    readonly deliveryRetryBaseDelayMs: number;
+    readonly deliveryScanIntervalMs: number;
+    readonly deliverySchedulerEnabled: boolean;
+    readonly slaScanIntervalMs: number;
+    readonly slaSchedulerEnabled: boolean;
+    readonly slaTimeoutAutoApproveEnabled: boolean;
+    readonly slaTimeoutEscalateEnabled: boolean;
+    readonly slaTimeoutRemindEnabled: boolean;
+    readonly slaTimeoutTerminateInstanceEnabled: boolean;
+    readonly templateEngine: NotificationTemplateEngine;
+    readonly webhookEnabled: boolean;
+    readonly webhookEndpointUrl: string | null;
+    readonly webhookSigningSecret: string | null;
+}
+export declare const BPM_NOTIFICATION_OPTIONS: InjectionToken<BPMResolvedNotificationOptions>;
+export declare const DEFAULT_BPM_NOTIFICATION_OPTIONS: BPMResolvedNotificationOptions;
+export declare function resolveBPMNotificationOptions(options?: BPMRootNotificationOptions): BPMResolvedNotificationOptions;

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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BPM_NOTIFICATION_OPTIONS = exports.BPM_NOTIFICATION_OPTIONS = void 0;
+exports.resolveBPMNotificationOptions = resolveBPMNotificationOptions;
+const notification_enums_1 = require("./notification.enums");
+exports.BPM_NOTIFICATION_OPTIONS = Symbol('BPM_NOTIFICATION_OPTIONS');
+exports.DEFAULT_BPM_NOTIFICATION_OPTIONS = {
+    emailEnabled: false,
+    emailFrom: null,
+    emailSmtpHost: null,
+    emailSmtpPassword: null,
+    emailSmtpPort: null,
+    emailSmtpSecure: false,
+    emailSmtpUsername: null,
+    inAppEnabled: true,
+    defaultChannels: [notification_enums_1.NotificationChannelEnum.IN_APP],
+    defaultEmailDigestMode: notification_enums_1.NotificationDigestModeEnum.INSTANT,
+    defaultEmailPreferenceEnabled: true,
+    defaultInAppPreferenceEnabled: true,
+    deliveryBatchSize: 25,
+    deliveryMaxAttempts: 3,
+    deliveryRetryBaseDelayMs: 60_000,
+    deliveryScanIntervalMs: 30_000,
+    deliverySchedulerEnabled: false,
+    slaScanIntervalMs: 60_000,
+    slaSchedulerEnabled: false,
+    slaTimeoutAutoApproveEnabled: false,
+    slaTimeoutEscalateEnabled: false,
+    slaTimeoutRemindEnabled: true,
+    slaTimeoutTerminateInstanceEnabled: false,
+    templateEngine: 'simple',
+    webhookEndpointUrl: null,
+    webhookEnabled: false,
+    webhookSigningSecret: null,
+};
+function resolveBPMNotificationOptions(options = {}) {
+    const emailSmtpHost = normalizeText(options.notificationEmailSmtpHost);
+    const emailSmtpPort = normalizePort(options.notificationEmailSmtpPort);
+    const emailSmtpUsername = normalizeText(options.notificationEmailSmtpUsername);
+    const emailSmtpPassword = normalizeText(options.notificationEmailSmtpPassword);
+    const emailFrom = normalizeText(options.notificationEmailFrom);
+    const webhookSigningSecret = normalizeText(options.notificationWebhookSigningSecret);
+    const webhookEndpointUrl = normalizeText(options.notificationWebhookEndpointUrl);
+    return {
+        deliveryScanIntervalMs: normalizeInterval(options.notificationDeliveryScanIntervalMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryScanIntervalMs),
+        deliveryBatchSize: normalizePositiveInteger(options.notificationDeliveryBatchSize, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryBatchSize),
+        deliveryMaxAttempts: normalizePositiveInteger(options.notificationDeliveryMaxAttempts, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryMaxAttempts),
+        deliveryRetryBaseDelayMs: normalizeInterval(options.notificationDeliveryRetryBaseDelayMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliveryRetryBaseDelayMs),
+        deliverySchedulerEnabled: options.notificationDeliverySchedulerEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.deliverySchedulerEnabled,
+        emailEnabled: resolveToggle(options.notificationEmailEnabled ?? 'auto', Boolean(emailSmtpHost &&
+            emailSmtpPort &&
+            emailSmtpUsername &&
+            emailSmtpPassword &&
+            emailFrom)),
+        emailFrom,
+        emailSmtpHost,
+        emailSmtpPassword,
+        emailSmtpPort,
+        emailSmtpSecure: options.notificationEmailSmtpSecure ?? false,
+        emailSmtpUsername,
+        inAppEnabled: options.notificationInAppEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.inAppEnabled,
+        defaultChannels: normalizeChannels(options.notificationDefaultChannels),
+        defaultEmailDigestMode: isNotificationDigestMode(options.notificationDefaultEmailDigestMode)
+            ? options.notificationDefaultEmailDigestMode
+            : exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.defaultEmailDigestMode,
+        defaultEmailPreferenceEnabled: options.notificationDefaultEmailPreferenceEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.defaultEmailPreferenceEnabled,
+        defaultInAppPreferenceEnabled: options.notificationDefaultInAppPreferenceEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.defaultInAppPreferenceEnabled,
+        slaScanIntervalMs: normalizeInterval(options.notificationSlaScanIntervalMs, exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaScanIntervalMs),
+        slaSchedulerEnabled: options.notificationSlaSchedulerEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaSchedulerEnabled,
+        slaTimeoutAutoApproveEnabled: options.notificationSlaTimeoutAutoApproveEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaTimeoutAutoApproveEnabled,
+        slaTimeoutEscalateEnabled: options.notificationSlaTimeoutEscalateEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaTimeoutEscalateEnabled,
+        slaTimeoutRemindEnabled: options.notificationSlaTimeoutRemindEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaTimeoutRemindEnabled,
+        slaTimeoutTerminateInstanceEnabled: options.notificationSlaTimeoutTerminateInstanceEnabled ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.slaTimeoutTerminateInstanceEnabled,
+        templateEngine: options.notificationTemplateEngine ??
+            exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.templateEngine,
+        webhookEnabled: resolveToggle(options.notificationWebhookEnabled ?? 'auto', Boolean(webhookEndpointUrl && webhookSigningSecret)),
+        webhookEndpointUrl,
+        webhookSigningSecret,
+    };
+}
+function resolveToggle(toggle, autoValue) {
+    return toggle === 'auto' ? autoValue : toggle;
+}
+function normalizeText(value) {
+    const trimmedValue = value?.trim() ?? '';
+    return trimmedValue || null;
+}
+function normalizePort(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0
+        ? value
+        : null;
+}
+function normalizeInterval(value, fallback) {
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        return fallback;
+    }
+    return Math.max(value, 1000);
+}
+function normalizePositiveInteger(value, fallback) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0) {
+        return fallback;
+    }
+    return value;
+}
+function normalizeChannels(channels) {
+    const normalizedChannels = channels
+        ?.filter(isNotificationChannel)
+        .filter((channel, index, allChannels) => allChannels.indexOf(channel) === index) ?? [];
+    return normalizedChannels.length
+        ? normalizedChannels
+        : exports.DEFAULT_BPM_NOTIFICATION_OPTIONS.defaultChannels;
+}
+function isNotificationChannel(value) {
+    return Object.values(notification_enums_1.NotificationChannelEnum).includes(value);
+}
+function isNotificationDigestMode(value) {
+    return Object.values(notification_enums_1.NotificationDigestModeEnum).includes(value);
+}
+//# sourceMappingURL=notification-options.js.map

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

@@ -0,0 +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-options.module.d.ts

@@ -0,0 +1,23 @@
+import { DynamicModule, InjectionToken } from '@nestjs/common';
+import { ModuleMetadata } from '@nestjs/common/interfaces';
+import { BPMRootNotificationOptions } from './notification-options';
+export interface NotificationOptionsModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /**
+     * Providers injected into `useFactory`.
+     *
+     * Host applications usually use this to pass Vault or config services into
+     * the flattened notification option factory.
+     */
+    readonly inject?: readonly InjectionToken[];
+    /**
+     * Async factory returning flattened notification options.
+     *
+     * The returned object uses root-level keys such as
+     * `notificationEmailSmtpHost` and `notificationWebhookEnabled`.
+     */
+    readonly useFactory: (...args: readonly unknown[]) => BPMRootNotificationOptions | Promise<BPMRootNotificationOptions>;
+}
+export declare class NotificationOptionsModule {
+    static forRoot(options?: BPMRootNotificationOptions): DynamicModule;
+    static forRootAsync(options: NotificationOptionsModuleAsyncOptions): DynamicModule;
+}