@fastybird/smart-panel-backend 1.0.0-beta.3 → 1.1.0-alpha.0

package/dist/modules/notifications/notifications.openapi.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTIFICATIONS_SWAGGER_EXTRA_MODELS = void 0;
+const update_config_dto_1 = require("./dto/update-config.dto");
+const notifications_entity_1 = require("./entities/notifications.entity");
+const config_model_1 = require("./models/config.model");
+const notification_action_model_1 = require("./models/notification-action.model");
+const notifications_response_model_1 = require("./models/notifications-response.model");
+exports.NOTIFICATIONS_SWAGGER_EXTRA_MODELS = [
+    config_model_1.NotificationsConfigModel,
+    update_config_dto_1.UpdateNotificationsConfigDto,
+    notification_action_model_1.NotificationActionModel,
+    notifications_entity_1.NotificationEntity,
+    notifications_response_model_1.NotificationResponseModel,
+    notifications_response_model_1.NotificationsResponseModel,
+    notifications_response_model_1.BulkResultResponseModel,
+];
+//# sourceMappingURL=notifications.openapi.js.map

package/dist/modules/notifications/notifications.openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.openapi.js","sourceRoot":"","sources":["../../../src/modules/notifications/notifications.openapi.ts"],"names":[],"mappings":";;;AAGA,+DAAuE;AACvE,0EAAqE;AACrE,wDAAiE;AACjE,kFAA6E;AAC7E,wFAI+C;AAElC,QAAA,kCAAkC,GAAG;IAEjD,uCAAwB;IACxB,gDAA4B;IAE5B,mDAAuB;IACvB,yCAAkB;IAElB,wDAAyB;IACzB,yDAA0B;IAC1B,sDAAuB;CACvB,CAAC"}

package/dist/modules/notifications/notifications.utils.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeErrorMessage(message: string): string;

package/dist/modules/notifications/notifications.utils.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeErrorMessage = sanitizeErrorMessage;
+const MAX_MESSAGE_LENGTH = 300;
+const REDACTED = '***';
+const URL_PATTERN = /[a-zA-Z][a-zA-Z0-9+.-]*:\/\/[^\s"'<>]+/g;
+const BEARER_TOKEN_PATTERN = /\b(Bearer)\s+\S+/gi;
+const JSON_SECRET_FIELD_PATTERN = /"(token|key|password|secret)"\s*:\s*(?:"(?:\\.|[^"\\])*"|[^,}\]\s]+)/gi;
+const KEY_VALUE_SECRET_PATTERN = /\b(token|key|password|secret)=[^&\s"'}]+/gi;
+function sanitizeErrorMessage(message) {
+    let sanitized = message.replace(URL_PATTERN, reduceUrl);
+    sanitized = sanitized.replace(BEARER_TOKEN_PATTERN, `$1 ${REDACTED}`);
+    sanitized = sanitized.replace(JSON_SECRET_FIELD_PATTERN, (_match, field) => `"${field}":"${REDACTED}"`);
+    sanitized = sanitized.replace(KEY_VALUE_SECRET_PATTERN, (_match, field) => `${field}=${REDACTED}`);
+    sanitized = sanitized.replace(/\s+/g, ' ').trim();
+    return sanitized.slice(0, MAX_MESSAGE_LENGTH);
+}
+function reduceUrl(match) {
+    try {
+        const url = new URL(match);
+        return `${url.protocol}//${url.hostname}`;
+    }
+    catch {
+        const scheme = match.split(':')[0];
+        return `${scheme}://`;
+    }
+}
+//# sourceMappingURL=notifications.utils.js.map

package/dist/modules/notifications/notifications.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.utils.js","sourceRoot":"","sources":["../../../src/modules/notifications/notifications.utils.ts"],"names":[],"mappings":";;AAiCA,oDAUC;AA3CD,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,QAAQ,GAAG,KAAK,CAAC;AAGvB,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAE9D,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAMlD,MAAM,yBAAyB,GAAG,wEAAwE,CAAC;AAE3G,MAAM,wBAAwB,GAAG,4CAA4C,CAAC;AAkB9E,SAAgB,oBAAoB,CAAC,OAAe;IACnD,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAExD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,QAAQ,EAAE,CAAC,CAAC;IACtE,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,QAAQ,GAAG,CAAC,CAAC;IAChH,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;IAE3G,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAElD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAC/C,CAAC;AAGD,SAAS,SAAS,CAAC,KAAa;IAC/B,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAE3B,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnC,OAAO,GAAG,MAAM,KAAK,CAAC;IACvB,CAAC;AACF,CAAC"}

package/dist/modules/notifications/platforms/notification-channel.platform.d.ts

@@ -0,0 +1,31 @@
+import { PluginConfigModel } from '../../config/models/config.model';
+import { ConfigService } from '../../config/services/config.service';
+import { NotificationEntity } from '../entities/notifications.entity';
+import { NotificationSeverity } from '../notifications.constants';
+export interface INotificationChannel {
+    getType(): string;
+    isConfigured(): Promise<boolean>;
+    getMinSeverity(): Promise<NotificationSeverity>;
+    send(notification: NotificationEntity, signal: AbortSignal): Promise<void>;
+}
+export declare class ChannelDeliveryError extends Error {
+    readonly retryable: boolean;
+    readonly status?: number;
+    constructor(message: string, retryable: boolean, status?: number);
+}
+export declare abstract class BaseNotificationChannel implements INotificationChannel {
+    protected readonly configService: ConfigService;
+    protected readonly type: string;
+    protected constructor(configService: ConfigService, type: string);
+    getType(): string;
+    isConfigured(): Promise<boolean>;
+    getMinSeverity(): Promise<NotificationSeverity>;
+    protected abstract hasRequiredConfig(config: PluginConfigModel): boolean;
+    abstract send(notification: NotificationEntity, signal: AbortSignal): Promise<void>;
+    protected formatText(notification: NotificationEntity): string;
+    protected fetchWithSignal(url: string, init: RequestInit, signal: AbortSignal): Promise<Response>;
+    protected classify(error: unknown, response?: Response): ChannelDeliveryError;
+    private causeCode;
+    private readConfig;
+    private isNotificationSeverity;
+}

package/dist/modules/notifications/platforms/notification-channel.platform.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseNotificationChannel = exports.ChannelDeliveryError = void 0;
+const notifications_constants_1 = require("../notifications.constants");
+const RETRYABLE_CONNECTION_ERROR_CODES = new Set([
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ECONNREFUSED',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+]);
+const RETRYABLE_TLS_ERROR_CODES = new Set([
+    'CERT_HAS_EXPIRED',
+    'DEPTH_ZERO_SELF_SIGNED_CERT',
+    'SELF_SIGNED_CERT_IN_CHAIN',
+    'UNABLE_TO_VERIFY_LEAF_SIGNATURE',
+    'UNABLE_TO_GET_ISSUER_CERT',
+    'UNABLE_TO_GET_ISSUER_CERT_LOCALLY',
+    'CERT_UNTRUSTED',
+    'CERT_CHAIN_TOO_LONG',
+    'HOSTNAME_MISMATCH',
+    'ERR_TLS_CERT_ALTNAME_INVALID',
+    'ERR_TLS_HANDSHAKE_TIMEOUT',
+    'ERR_SSL_WRONG_VERSION_NUMBER',
+    'EPROTO',
+]);
+class ChannelDeliveryError extends Error {
+    constructor(message, retryable, status) {
+        super(message);
+        this.retryable = retryable;
+        this.status = status;
+        this.name = 'ChannelDeliveryError';
+    }
+}
+exports.ChannelDeliveryError = ChannelDeliveryError;
+class BaseNotificationChannel {
+    constructor(configService, type) {
+        this.configService = configService;
+        this.type = type;
+    }
+    getType() {
+        return this.type;
+    }
+    async isConfigured() {
+        const config = this.readConfig();
+        if (config === null || config.enabled === false) {
+            return false;
+        }
+        return this.hasRequiredConfig(config);
+    }
+    async getMinSeverity() {
+        const config = this.readConfig();
+        const value = config?.['min_severity'];
+        return this.isNotificationSeverity(value) ? value : notifications_constants_1.NotificationSeverity.WARNING;
+    }
+    formatText(notification) {
+        const lines = [`[${notification.severity.toUpperCase()}] ${notification.title}`];
+        if (notification.message) {
+            lines.push(notification.message);
+        }
+        const occurrences = notification.occurrences > 1 ? ` · ${notification.occurrences} occurrences` : '';
+        lines.push(`Source: ${notification.source}${occurrences}`);
+        return lines.join('\n');
+    }
+    async fetchWithSignal(url, init, signal) {
+        try {
+            return await fetch(url, { ...init, signal, redirect: 'error' });
+        }
+        catch (error) {
+            throw this.classify(error);
+        }
+    }
+    classify(error, response) {
+        if (response) {
+            const retryable = response.status === 429 || response.status >= 500;
+            return new ChannelDeliveryError(`Channel responded with HTTP ${response.status}`, retryable, response.status);
+        }
+        if (error instanceof ChannelDeliveryError) {
+            return error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        const code = this.causeCode(error);
+        const retryable = code !== undefined && (RETRYABLE_CONNECTION_ERROR_CODES.has(code) || RETRYABLE_TLS_ERROR_CODES.has(code));
+        return new ChannelDeliveryError(message, retryable);
+    }
+    causeCode(error) {
+        const direct = error instanceof Error ? error.code : undefined;
+        if (typeof direct === 'string') {
+            return direct;
+        }
+        const cause = error instanceof Error ? error.cause : undefined;
+        const causeCode = cause instanceof Error ? cause.code : undefined;
+        return typeof causeCode === 'string' ? causeCode : undefined;
+    }
+    readConfig() {
+        try {
+            return this.configService.getPluginConfig(this.type);
+        }
+        catch {
+            return null;
+        }
+    }
+    isNotificationSeverity(value) {
+        return typeof value === 'string' && Object.values(notifications_constants_1.NotificationSeverity).includes(value);
+    }
+}
+exports.BaseNotificationChannel = BaseNotificationChannel;
+//# sourceMappingURL=notification-channel.platform.js.map

package/dist/modules/notifications/platforms/notification-channel.platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-channel.platform.js","sourceRoot":"","sources":["../../../../src/modules/notifications/platforms/notification-channel.platform.ts"],"names":[],"mappings":"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"}

package/dist/modules/notifications/services/notification-channel-registry.service.d.ts

@@ -0,0 +1,8 @@
+import { INotificationChannel } from '../platforms/notification-channel.platform';
+export declare class NotificationChannelRegistryService {
+    private readonly channels;
+    register(channel: INotificationChannel): void;
+    unregister(type: string): void;
+    getChannels(): INotificationChannel[];
+    isChannel(source: string): boolean;
+}

package/dist/modules/notifications/services/notification-channel-registry.service.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationChannelRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+let NotificationChannelRegistryService = class NotificationChannelRegistryService {
+    constructor() {
+        this.channels = new Map();
+    }
+    register(channel) {
+        const type = channel.getType();
+        if (this.channels.has(type)) {
+            throw new Error(`Notification channel "${type}" is already registered.`);
+        }
+        this.channels.set(type, channel);
+    }
+    unregister(type) {
+        this.channels.delete(type);
+    }
+    getChannels() {
+        return Array.from(this.channels.values());
+    }
+    isChannel(source) {
+        return this.channels.has(source);
+    }
+};
+exports.NotificationChannelRegistryService = NotificationChannelRegistryService;
+exports.NotificationChannelRegistryService = NotificationChannelRegistryService = __decorate([
+    (0, common_1.Injectable)()
+], NotificationChannelRegistryService);
+//# sourceMappingURL=notification-channel-registry.service.js.map

package/dist/modules/notifications/services/notification-channel-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-channel-registry.service.js","sourceRoot":"","sources":["../../../../src/modules/notifications/services/notification-channel-registry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAarC,IAAM,kCAAkC,GAAxC,MAAM,kCAAkC;IAAxC;QACW,aAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAwBrE,CAAC;IAtBA,QAAQ,CAAC,OAA6B;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAE/B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,0BAA0B,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,IAAY;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,WAAW;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAGD,SAAS,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACD,CAAA;AAzBY,gFAAkC;6CAAlC,kCAAkC;IAD9C,IAAA,mBAAU,GAAE;GACA,kCAAkC,CAyB9C"}

package/dist/modules/notifications/services/notification-dispatcher.service.d.ts

@@ -0,0 +1,28 @@
+import { ConfigService } from '../../config/services/config.service';
+import { NotificationEntity } from '../entities/notifications.entity';
+import { NotificationChannelRegistryService } from './notification-channel-registry.service';
+import { NotificationEventPayload, NotificationsService } from './notifications.service';
+export declare const NOTIFICATION_DISPATCHER_SLEEP: unique symbol;
+export type NotificationDispatcherSleep = (ms: number) => Promise<void>;
+export declare class NotificationDispatcherService {
+    private readonly registry;
+    private readonly notificationsService;
+    private readonly configService;
+    private readonly sleep;
+    private static readonly DELIVERY_TIMEOUT_MS;
+    private static readonly MAX_ATTEMPTS;
+    private static readonly RETRY_DELAYS_MS;
+    private readonly logger;
+    private readonly deliveryChains;
+    constructor(registry: NotificationChannelRegistryService, notificationsService: NotificationsService, configService: ConfigService, sleep: NotificationDispatcherSleep);
+    handleNotificationCreated(payload: NotificationEventPayload): Promise<void>;
+    dispatch(notification: NotificationEntity): Promise<void>;
+    protected createDeliverySignal(): AbortSignal;
+    private enqueue;
+    private deliverToChannel;
+    private shouldSkip;
+    private deliverWithRetries;
+    private sendOnce;
+    private raceAgainstAbort;
+    private reportFailure;
+}

package/dist/modules/notifications/services/notification-dispatcher.service.js

@@ -0,0 +1,173 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var NotificationDispatcherService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationDispatcherService = exports.NOTIFICATION_DISPATCHER_SLEEP = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const logger_1 = require("../../../common/logger");
+const config_service_1 = require("../../config/services/config.service");
+const notifications_constants_1 = require("../notifications.constants");
+const notifications_utils_1 = require("../notifications.utils");
+const notification_channel_platform_1 = require("../platforms/notification-channel.platform");
+const notification_channel_registry_service_1 = require("./notification-channel-registry.service");
+const notifications_service_1 = require("./notifications.service");
+exports.NOTIFICATION_DISPATCHER_SLEEP = Symbol('NOTIFICATION_DISPATCHER_SLEEP');
+const DELIVERY_FAILED_KEY = 'delivery-failed';
+let NotificationDispatcherService = NotificationDispatcherService_1 = class NotificationDispatcherService {
+    constructor(registry, notificationsService, configService, sleep) {
+        this.registry = registry;
+        this.notificationsService = notificationsService;
+        this.configService = configService;
+        this.sleep = sleep;
+        this.logger = (0, logger_1.createExtensionLogger)(notifications_constants_1.NOTIFICATIONS_MODULE_NAME, 'NotificationDispatcherService');
+        this.deliveryChains = new Map();
+    }
+    async handleNotificationCreated(payload) {
+        try {
+            const notification = await this.notificationsService.findOne(payload.id);
+            if (notification === null) {
+                this.logger.debug(`Notification id=${payload.id} was gone by the time dispatch ran, skipping`);
+                return;
+            }
+            await this.dispatch(notification);
+        }
+        catch (error) {
+            this.logger.warn(`Failed to dispatch notification id=${payload.id}: ${(0, notifications_utils_1.sanitizeErrorMessage)(normaliseErrorMessage(error))}`);
+        }
+    }
+    async dispatch(notification) {
+        if (this.registry.isChannel(notification.source)) {
+            return;
+        }
+        const channels = this.registry.getChannels();
+        await Promise.allSettled(channels.map((channel) => this.enqueue(channel, notification)));
+    }
+    createDeliverySignal() {
+        return AbortSignal.timeout(NotificationDispatcherService_1.DELIVERY_TIMEOUT_MS);
+    }
+    enqueue(channel, notification) {
+        const type = channel.getType();
+        const previous = this.deliveryChains.get(type) ?? Promise.resolve();
+        const next = previous.then(() => this.deliverToChannel(channel, notification));
+        this.deliveryChains.set(type, next);
+        return next;
+    }
+    async deliverToChannel(channel, notification) {
+        try {
+            if (await this.shouldSkip(channel, notification)) {
+                return;
+            }
+            await this.deliverWithRetries(channel, notification);
+        }
+        catch (error) {
+            this.logger.error(`Unexpected error delivering to channel type=${channel.getType()}: ${(0, notifications_utils_1.sanitizeErrorMessage)(normaliseErrorMessage(error))}`);
+        }
+    }
+    async shouldSkip(channel, notification) {
+        const pluginConfig = this.configService.getPluginConfig(channel.getType());
+        if (pluginConfig.enabled === false) {
+            return true;
+        }
+        if (!(await channel.isConfigured())) {
+            return true;
+        }
+        const minSeverity = await channel.getMinSeverity();
+        return notifications_constants_1.SEVERITY_RANK[notification.severity] < notifications_constants_1.SEVERITY_RANK[minSeverity];
+    }
+    async deliverWithRetries(channel, notification) {
+        for (let attempt = 1; attempt <= NotificationDispatcherService_1.MAX_ATTEMPTS; attempt++) {
+            try {
+                await this.sendOnce(channel, notification);
+                await this.notificationsService.resolve(channel.getType(), DELIVERY_FAILED_KEY);
+                return;
+            }
+            catch (error) {
+                const retryable = error instanceof notification_channel_platform_1.ChannelDeliveryError && error.retryable;
+                const hasMoreAttempts = attempt < NotificationDispatcherService_1.MAX_ATTEMPTS;
+                if (retryable && hasMoreAttempts) {
+                    await this.sleep(NotificationDispatcherService_1.RETRY_DELAYS_MS[attempt - 1]);
+                    continue;
+                }
+                await this.reportFailure(channel, error);
+                return;
+            }
+        }
+    }
+    sendOnce(channel, notification) {
+        const signal = this.createDeliverySignal();
+        return this.raceAgainstAbort(channel.send(notification, signal), signal);
+    }
+    raceAgainstAbort(promise, signal) {
+        if (signal.aborted) {
+            return Promise.reject(new Error('Channel did not respond before the delivery timeout'));
+        }
+        return new Promise((resolve, reject) => {
+            const onAbort = () => reject(new Error('Channel did not respond before the delivery timeout'));
+            signal.addEventListener('abort', onAbort, { once: true });
+            promise.then(resolve, reject).finally(() => {
+                signal.removeEventListener('abort', onAbort);
+            });
+        });
+    }
+    async reportFailure(channel, error) {
+        const message = (0, notifications_utils_1.sanitizeErrorMessage)(normaliseErrorMessage(error));
+        const type = channel.getType();
+        this.logger.error(`Failed to deliver a notification via channel type=${type}: ${message}`);
+        await this.notificationsService.notify({
+            source: type,
+            kind: notifications_constants_1.NotificationKind.ISSUE,
+            key: DELIVERY_FAILED_KEY,
+            severity: notifications_constants_1.NotificationSeverity.WARNING,
+            title: 'Notification delivery failed',
+            message,
+            actions: [
+                {
+                    type: notifications_constants_1.NotificationActionType.LINK,
+                    label: 'Open channel settings',
+                    url: `/config/plugins/${type}`,
+                },
+            ],
+        });
+    }
+};
+exports.NotificationDispatcherService = NotificationDispatcherService;
+NotificationDispatcherService.DELIVERY_TIMEOUT_MS = 10_000;
+NotificationDispatcherService.MAX_ATTEMPTS = 3;
+NotificationDispatcherService.RETRY_DELAYS_MS = [1_000, 5_000];
+__decorate([
+    (0, event_emitter_1.OnEvent)(notifications_constants_1.EventType.NOTIFICATION_CREATED),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], NotificationDispatcherService.prototype, "handleNotificationCreated", null);
+exports.NotificationDispatcherService = NotificationDispatcherService = NotificationDispatcherService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(3, (0, common_1.Inject)(exports.NOTIFICATION_DISPATCHER_SLEEP)),
+    __metadata("design:paramtypes", [notification_channel_registry_service_1.NotificationChannelRegistryService,
+        notifications_service_1.NotificationsService,
+        config_service_1.ConfigService, Function])
+], NotificationDispatcherService);
+function normaliseErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    try {
+        return String(error);
+    }
+    catch {
+        return 'unknown error';
+    }
+}
+//# sourceMappingURL=notification-dispatcher.service.js.map

package/dist/modules/notifications/services/notification-dispatcher.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-dispatcher.service.js","sourceRoot":"","sources":["../../../../src/modules/notifications/services/notification-dispatcher.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/notifications/services/notification-input.validator.d.ts

@@ -0,0 +1,29 @@
+import { NotificationData } from '../entities/notifications.entity';
+import { NotificationActionInput } from '../models/notification-action.model';
+import { NotificationKind, NotificationSeverity } from '../notifications.constants';
+import type { CreateNotificationInput } from './notifications.service';
+export interface ValidatedNotificationInput {
+    source: string;
+    kind: NotificationKind;
+    key: string | null;
+    severity: NotificationSeverity;
+    title: string;
+    message: string | null;
+    actions: NotificationActionInput[];
+    data: NotificationData | null;
+    persistent: boolean;
+}
+export type NotificationInputValidationResult = {
+    outcome: 'accepted';
+    value: ValidatedNotificationInput;
+} | {
+    outcome: 'rejected';
+    reason: string;
+};
+export declare class NotificationInputValidator {
+    validate(input: CreateNotificationInput): NotificationInputValidationResult;
+    private validateAction;
+    private validateLinkUrl;
+    private validateActionParams;
+    private validateData;
+}

package/dist/modules/notifications/services/notification-input.validator.js

@@ -0,0 +1,148 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationInputValidator = void 0;
+const common_1 = require("@nestjs/common");
+const notifications_constants_1 = require("../notifications.constants");
+const SERVICE_EXTENSION_KINDS = ['module', 'plugin'];
+const SERVICE_OPERATIONS = ['start', 'stop', 'restart'];
+const reject = (reason) => ({ outcome: 'rejected', reason });
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isNonEmptyString = (value) => typeof value === 'string' && value.trim() !== '';
+const truncate = (value, maxLength) => value.length > maxLength ? value.slice(0, maxLength) : value;
+let NotificationInputValidator = class NotificationInputValidator {
+    validate(input) {
+        if (!isPlainObject(input)) {
+            return reject('input must be an object');
+        }
+        if (!isNonEmptyString(input.source)) {
+            return reject('source is required');
+        }
+        if (!Object.values(notifications_constants_1.NotificationKind).includes(input.kind)) {
+            return reject(`kind '${String(input.kind)}' is not a known notification kind`);
+        }
+        if (!Object.values(notifications_constants_1.NotificationSeverity).includes(input.severity)) {
+            return reject(`severity '${String(input.severity)}' is not a known notification severity`);
+        }
+        const key = isNonEmptyString(input.key) ? input.key.trim() : null;
+        if (input.kind === notifications_constants_1.NotificationKind.ISSUE && key === null) {
+            return reject('an issue needs a key so that its source can resolve it');
+        }
+        if (input.actions !== undefined && input.actions !== null && !Array.isArray(input.actions)) {
+            return reject('actions must be an array');
+        }
+        const actions = (input.actions ?? []).slice(0, notifications_constants_1.NOTIFICATION_ACTIONS_MAX);
+        for (const action of actions) {
+            const actionRejection = this.validateAction(action);
+            if (actionRejection !== null) {
+                return reject(actionRejection);
+            }
+        }
+        const dataRejection = this.validateData(input.data);
+        if (dataRejection !== null) {
+            return reject(dataRejection);
+        }
+        return {
+            outcome: 'accepted',
+            value: {
+                source: input.source.trim(),
+                kind: input.kind,
+                key,
+                severity: input.severity,
+                title: truncate(input.title ?? '', notifications_constants_1.NOTIFICATION_TITLE_MAX_LENGTH),
+                message: isNonEmptyString(input.message) ? truncate(input.message, notifications_constants_1.NOTIFICATION_MESSAGE_MAX_LENGTH) : null,
+                actions,
+                data: input.data ?? null,
+                persistent: input.kind === notifications_constants_1.NotificationKind.ISSUE && input.persistent === true,
+            },
+        };
+    }
+    validateAction(action) {
+        if (!isNonEmptyString(action?.label)) {
+            return 'an action needs a label';
+        }
+        switch (action.type) {
+            case notifications_constants_1.NotificationActionType.LINK:
+                return this.validateLinkUrl(action.url);
+            case notifications_constants_1.NotificationActionType.EXTENSION_ACTION:
+                if (!isNonEmptyString(action.extension_type)) {
+                    return 'an extension action needs an extension_type';
+                }
+                if (!isNonEmptyString(action.action_id)) {
+                    return 'an extension action needs an action_id';
+                }
+                return this.validateActionParams(action.params);
+            case notifications_constants_1.NotificationActionType.SERVICE:
+                if (!SERVICE_EXTENSION_KINDS.includes(action.extension_kind)) {
+                    return `a service action needs an extension_kind of ${SERVICE_EXTENSION_KINDS.join(' or ')}`;
+                }
+                if (!isNonEmptyString(action.extension_type)) {
+                    return 'a service action needs an extension_type';
+                }
+                if (!isNonEmptyString(action.service_id)) {
+                    return 'a service action needs a service_id';
+                }
+                if (!SERVICE_OPERATIONS.includes(action.operation)) {
+                    return `a service action needs an operation of ${SERVICE_OPERATIONS.join(', ')}`;
+                }
+                return null;
+            default: {
+                const { type } = action;
+                return `action type '${type ?? 'undefined'}' is not a known action type`;
+            }
+        }
+    }
+    validateLinkUrl(url) {
+        if (!isNonEmptyString(url)) {
+            return 'a link action needs a url';
+        }
+        if (url.startsWith('//')) {
+            return `link url '${url}' must be an admin path or an absolute http(s) url`;
+        }
+        if (url.startsWith('/') || /^https?:\/\//i.test(url)) {
+            return null;
+        }
+        return `link url '${url}' must be an admin path or an absolute http(s) url`;
+    }
+    validateActionParams(params) {
+        if (params === undefined || params === null) {
+            return null;
+        }
+        if (!isPlainObject(params)) {
+            return 'extension action params must be a flat object';
+        }
+        for (const value of Object.values(params)) {
+            if (typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean') {
+                return 'extension action params must be a flat object of strings, numbers and booleans';
+            }
+        }
+        return null;
+    }
+    validateData(data) {
+        if (data === undefined || data === null) {
+            return null;
+        }
+        if (!isPlainObject(data)) {
+            return 'data must be a flat object';
+        }
+        for (const value of Object.values(data)) {
+            if (value !== null && typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean') {
+                return 'data must be a flat object of strings, numbers, booleans and nulls';
+            }
+        }
+        if (Buffer.byteLength(JSON.stringify(data), 'utf8') > notifications_constants_1.NOTIFICATION_DATA_MAX_BYTES) {
+            return `data exceeds the ${notifications_constants_1.NOTIFICATION_DATA_MAX_BYTES} byte limit`;
+        }
+        return null;
+    }
+};
+exports.NotificationInputValidator = NotificationInputValidator;
+exports.NotificationInputValidator = NotificationInputValidator = __decorate([
+    (0, common_1.Injectable)()
+], NotificationInputValidator);
+//# sourceMappingURL=notification-input.validator.js.map