@webda/core 4.0.0-beta.2 → 4.0.0-beta.4

package/lib/services/mailer.service.d.ts

@@ -0,0 +1,220 @@
+import * as nodemailer from "nodemailer";
+import { NotificationService } from "./notificationservice.service.js";
+import { Service } from "./service.js";
+import { Counter } from "../metrics/metrics.js";
+import type { User } from "../models/user.model.js";
+import type { Ident } from "../models/ident.model.js";
+import { ServiceParameters } from "../services/serviceparameters.js";
+import { ServicePartialParameters } from "./iservice.js";
+/**
+ * Interface for an email template that can render subject, html and text
+ */
+interface IEmailTemplate {
+    /**
+     * Render all template variants (subject, html, text) for the given file
+     *
+     * @param file - Template file name to render
+     * @param options - Template variables for rendering
+     * @returns Rendered result with subject, html and text properties
+     */
+    renderAll(file: string, options: any): any;
+}
+/**
+ * Map of template names to their email template instances
+ */
+interface TemplatesMap {
+    [key: string]: IEmailTemplate;
+}
+/**
+ * Represent a mailer service
+ */
+export interface MailerService extends NotificationService {
+    /**
+     * Send an email
+     *
+     * @param options - Options to pass to the sendMail option of the nodemailer module
+     * @param callback - Callback to pass to sendMail
+     * @returns Promise resolving when the email is sent
+     */
+    send(options: MailerSendOptions, callback: () => void): Promise<any>;
+}
+/**
+ * Options for sending an email, extending nodemailer's SendMailOptions
+ * with template support
+ */
+interface MailerSendOptions extends nodemailer.SendMailOptions {
+    /**
+     * Sender of the email
+     *
+     * @default parameters.sender
+     */
+    from?: nodemailer.SendMailOptions["from"];
+    /**
+     * Template to use
+     */
+    template?: string;
+    /**
+     * Replacements for the template
+     */
+    replacements?: Record<string, any>;
+}
+/**
+ * Parameters for the Mailer service configuration
+ *
+ * Configures the email transport, templates directory and template engine
+ */
+export declare class MailerParameters extends ServiceParameters {
+    /**
+     * Specify which folder contains templates
+     *
+     * @default "templates"
+     */
+    templates?: string;
+    /**
+     * Template engine to use
+     *
+     * @default "mustache"
+     */
+    templatesEngine?: string;
+    /**
+     * Define the default sender
+     */
+    sender: string;
+    /**
+     * @see https://www.npmjs.com/package/email-templates
+     */
+    emailTemplateOptions?: any;
+    /**
+     * Define the type of transport to use
+     */
+    transport?: string;
+    /**
+     * SES AWS Bean if transport === "ses"
+     */
+    SES?: any;
+    /**
+     * Load and apply defaults to the mailer parameters
+     *
+     * Sets default templates directory to "./templates/", engine to "mustache",
+     * and configures juice resource options for CSS inlining
+     *
+     * @param params - Raw parameters to load
+     * @returns this instance with defaults applied
+     */
+    load(params?: any): this;
+}
+/**
+ * Abstract base class for mailer implementations
+ *
+ * Provides metrics tracking (sent/errors counters) and notification handling.
+ * Subclasses must implement {@link send} and {@link hasNotification}.
+ *
+ * @typeParam T - Service parameters type
+ */
+export declare abstract class AbstractMailer<T extends ServiceParameters = ServiceParameters> extends Service<T> implements MailerService {
+    /**
+     * Mailer metrics for tracking sent emails and errors
+     */
+    metrics: {
+        sent: Counter;
+        errors: Counter;
+    };
+    /**
+     * @override
+     */
+    initMetrics(): void;
+    /**
+     * @inheritdoc
+     */
+    abstract send(options: MailerSendOptions, callback?: () => void): Promise<any>;
+    /**
+     * @inheritdoc
+     */
+    abstract hasNotification(notification: string): any;
+    /**
+     * Check if notifications can be delivered to a user via email
+     *
+     * @param user - User or Ident to check for email availability
+     * @returns true if the user has an email address
+     */
+    handleNotificationFor(user: User | Ident): Promise<boolean>;
+    /**
+     * Send a notification email to a user
+     *
+     * Resolves the user's email, increments the sent metric, and delegates
+     * to {@link send}. Increments the error metric on failure.
+     *
+     * @param user - User or Ident to send the notification to
+     * @param notification - Template name for the notification
+     * @param replacements - Template variables for rendering
+     * @throws Error if the user has no valid email address
+     * @override
+     */
+    sendNotification(user: User | Ident, notification: string, replacements: any): Promise<void>;
+}
+/**
+ * A basic Mailer based on the nodemailer module
+ *
+ * Inside config it is the nodemailer module option for the method createTransport ( https://nodemailer.com/ )
+ *
+ * Only ses transport module is installed by default
+ *
+ * Parameters
+ * config: { ... }
+ * @category CoreServices
+ * @WebdaModda
+ */
+declare class Mailer<T extends MailerParameters = MailerParameters> extends AbstractMailer<T> {
+    /** Nodemailer transport instance used to send emails */
+    _transporter: any;
+    /** Cache of loaded email template instances by name */
+    _templates: TemplatesMap;
+    /**
+     * Load and instantiate mailer parameters with defaults
+     *
+     * @param params - Raw service parameters
+     * @returns Loaded MailerParameters instance
+     * @ignore
+     */
+    loadParameters(params: ServicePartialParameters<T>): T;
+    /**
+     * Initialize the nodemailer transport from the service parameters
+     *
+     * @returns this instance after transport creation
+     * @override
+     */
+    init(): Promise<this>;
+    /**
+     * Get or create a cached email template instance by name
+     *
+     * Lazily creates and caches an Email template using the configured
+     * templates directory and engine. Logs a warning if the template does not exist.
+     *
+     * @param name - Template name (must correspond to a directory in the templates folder)
+     * @returns The email template instance, or undefined if the template does not exist
+     */
+    _getTemplate(name: string): IEmailTemplate;
+    /**
+     * Check if an email template exists on the filesystem
+     *
+     * @param name - Template name to check
+     * @returns true if the template directory exists
+     */
+    hasNotification(name: string): boolean;
+    /**
+     * Send an email using the configured nodemailer transport
+     *
+     * If a template is specified in options, it will be rendered with the
+     * provided replacements before sending. A `now` Date variable is
+     * automatically added to replacements. Falls back to `parameters.sender`
+     * if no `from` is provided.
+     *
+     * @param options - Mail options including optional template and replacements
+     * @param callback - Optional callback passed to nodemailer's sendMail
+     * @returns Promise resolving with the nodemailer send result
+     * @throws Error if no transporter is configured or the template is unknown
+     */
+    send(options: MailerSendOptions, callback?: any): Promise<any>;
+}
+export { Mailer, type TemplatesMap, type IEmailTemplate };
+//# sourceMappingURL=mailer.service.d.ts.map

package/lib/services/mailer.service.d.ts.map

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

package/lib/services/mailer.service.js

@@ -0,0 +1,251 @@
+import Email from "email-templates";
+import * as fs from "fs";
+import * as nodemailer from "nodemailer";
+import * as path from "path";
+import { Service } from "./service.js";
+import { Counter } from "../metrics/metrics.js";
+import { ServiceParameters } from "../services/serviceparameters.js";
+/**
+ * Parameters for the Mailer service configuration
+ *
+ * Configures the email transport, templates directory and template engine
+ */
+export class MailerParameters extends ServiceParameters {
+    /**
+     * Specify which folder contains templates
+     *
+     * @default "templates"
+     */
+    templates;
+    /**
+     * Template engine to use
+     *
+     * @default "mustache"
+     */
+    templatesEngine;
+    /**
+     * Define the default sender
+     */
+    sender;
+    /**
+     * @see https://www.npmjs.com/package/email-templates
+     */
+    emailTemplateOptions;
+    /**
+     * Define the type of transport to use
+     */
+    transport;
+    /**
+     * SES AWS Bean if transport === "ses"
+     */
+    SES;
+    /**
+     * Load and apply defaults to the mailer parameters
+     *
+     * Sets default templates directory to "./templates/", engine to "mustache",
+     * and configures juice resource options for CSS inlining
+     *
+     * @param params - Raw parameters to load
+     * @returns this instance with defaults applied
+     */
+    load(params = {}) {
+        super.load(params);
+        this.templates ??= "./templates";
+        if (!this.templates.endsWith("/")) {
+            this.templates += "/";
+        }
+        this.templatesEngine ??= "mustache";
+        this.emailTemplateOptions ??= {};
+        this.emailTemplateOptions.juiceResources ??= {};
+        this.emailTemplateOptions.juiceResources.webResources ??= {};
+        this.emailTemplateOptions.juiceResources.webResources.relativeTo ??= path.resolve(this.templates);
+        return this;
+    }
+}
+/**
+ * Abstract base class for mailer implementations
+ *
+ * Provides metrics tracking (sent/errors counters) and notification handling.
+ * Subclasses must implement {@link send} and {@link hasNotification}.
+ *
+ * @typeParam T - Service parameters type
+ */
+export class AbstractMailer extends Service {
+    /**
+     * @override
+     */
+    initMetrics() {
+        super.initMetrics();
+        this.metrics.sent = this.getMetric(Counter, {
+            name: "mailer_sent",
+            help: "Number of emails sent"
+        });
+        this.metrics.errors ??= this.getMetric(Counter, {
+            name: "mailer_errors",
+            help: "Number of emails in error"
+        });
+    }
+    /**
+     * Check if notifications can be delivered to a user via email
+     *
+     * @param user - User or Ident to check for email availability
+     * @returns true if the user has an email address
+     */
+    async handleNotificationFor(user) {
+        return user.getEmail() !== undefined;
+    }
+    /**
+     * Send a notification email to a user
+     *
+     * Resolves the user's email, increments the sent metric, and delegates
+     * to {@link send}. Increments the error metric on failure.
+     *
+     * @param user - User or Ident to send the notification to
+     * @param notification - Template name for the notification
+     * @param replacements - Template variables for rendering
+     * @throws Error if the user has no valid email address
+     * @override
+     */
+    async sendNotification(user, notification, replacements) {
+        const email = user.getEmail();
+        if (!email) {
+            throw new Error(`Cannot find a valid email for ${user}`);
+        }
+        this.metrics.sent.inc();
+        try {
+            await this.send({
+                template: notification,
+                replacements: {
+                    ...replacements
+                },
+                to: email
+            });
+        }
+        catch (err) {
+            this.metrics.errors.inc();
+            throw err;
+        }
+    }
+}
+/**
+ * A basic Mailer based on the nodemailer module
+ *
+ * Inside config it is the nodemailer module option for the method createTransport ( https://nodemailer.com/ )
+ *
+ * Only ses transport module is installed by default
+ *
+ * Parameters
+ * config: { ... }
+ * @category CoreServices
+ * @WebdaModda
+ */
+class Mailer extends AbstractMailer {
+    /** Nodemailer transport instance used to send emails */
+    _transporter;
+    /** Cache of loaded email template instances by name */
+    _templates = {};
+    /**
+     * Load and instantiate mailer parameters with defaults
+     *
+     * @param params - Raw service parameters
+     * @returns Loaded MailerParameters instance
+     * @ignore
+     */
+    loadParameters(params) {
+        return new MailerParameters().load(params);
+    }
+    /**
+     * Initialize the nodemailer transport from the service parameters
+     *
+     * @returns this instance after transport creation
+     * @override
+     */
+    async init() {
+        this._transporter = nodemailer.createTransport(this.parameters);
+        return this;
+    }
+    /**
+     * Get or create a cached email template instance by name
+     *
+     * Lazily creates and caches an Email template using the configured
+     * templates directory and engine. Logs a warning if the template does not exist.
+     *
+     * @param name - Template name (must correspond to a directory in the templates folder)
+     * @returns The email template instance, or undefined if the template does not exist
+     */
+    _getTemplate(name) {
+        if (!this._templates[name]) {
+            if (!this.hasNotification(name)) {
+                this.log("WARN", "No template found for", name);
+                return;
+            }
+            this._templates[name] = new Email({
+                ...this.parameters.emailTemplateOptions,
+                views: {
+                    root: this.parameters.templates,
+                    options: {
+                        extension: this.parameters.templatesEngine
+                    }
+                }
+            });
+        }
+        return this._templates[name];
+    }
+    /**
+     * Check if an email template exists on the filesystem
+     *
+     * @param name - Template name to check
+     * @returns true if the template directory exists
+     */
+    hasNotification(name) {
+        // Load template
+        return fs.existsSync(this.parameters.templates + name);
+    }
+    /**
+     * Send an email using the configured nodemailer transport
+     *
+     * If a template is specified in options, it will be rendered with the
+     * provided replacements before sending. A `now` Date variable is
+     * automatically added to replacements. Falls back to `parameters.sender`
+     * if no `from` is provided.
+     *
+     * @param options - Mail options including optional template and replacements
+     * @param callback - Optional callback passed to nodemailer's sendMail
+     * @returns Promise resolving with the nodemailer send result
+     * @throws Error if no transporter is configured or the template is unknown
+     */
+    async send(options, callback = undefined) {
+        if (this._transporter === undefined) {
+            this.log("ERROR", "Cannot send email as no transporter is defined");
+            return Promise.reject("Cannot send email as no transporter is defined");
+        }
+        if (!options.from) {
+            options.from = this.parameters.sender;
+        }
+        if (options.template) {
+            if (!options.replacements) {
+                options.replacements = {};
+            }
+            options.replacements.now = new Date();
+            const template = this._getTemplate(options.template);
+            if (template) {
+                const result = await template.renderAll(options.template, options.replacements);
+                if (result.subject) {
+                    options.subject = result.subject;
+                }
+                if (result.html) {
+                    options.html = result.html;
+                }
+                if (result.text) {
+                    options.text = result.text;
+                }
+            }
+            else {
+                throw Error("Unknown mail template");
+            }
+        }
+        return this._transporter.sendMail(options, callback);
+    }
+}
+export { Mailer };
+//# sourceMappingURL=mailer.service.js.map

package/lib/services/mailer.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailer.service.js","sourceRoot":"","sources":["../../src/services/mailer.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,iBAAiB,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA2DrE;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACrD;;;;OAIG;IACH,SAAS,CAAU;IACnB;;;;OAIG;IACH,eAAe,CAAU;IACzB;;OAEG;IACH,MAAM,CAAS;IACf;;OAEG;IACH,oBAAoB,CAAO;IAC3B;;OAEG;IACH,SAAS,CAAU;IACnB;;OAEG;IACH,GAAG,CAAO;IAEV;;;;;;;;OAQG;IACH,IAAI,CAAC,MAAM,GAAQ,EAAE;QACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,KAAK,aAAa,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,eAAe,KAAK,UAAU,CAAC;QACpC,IAAI,CAAC,oBAAoB,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,oBAAoB,CAAC,cAAc,KAAK,EAAE,CAAC;QAChD,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,YAAY,KAAK,EAAE,CAAC;QAC7D,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,YAAY,CAAC,UAAU,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAgB,cACpB,SAAQ,OAAU;IAWlB;;OAEG;IACH,WAAW;QACT,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;YAC1C,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,uBAAuB;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;YAC9C,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,2BAA2B;SAClC,CAAC,CAAC;IACL,CAAC;IAWD;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB,CAAC,IAAkB;QAC5C,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAkB,EAAE,YAAoB,EAAE,YAAiB;QAChF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC;gBACd,QAAQ,EAAE,YAAY;gBACtB,YAAY,EAAE;oBACZ,GAAG,YAAY;iBAChB;gBACD,EAAE,EAAE,KAAK;aACV,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAsD,SAAQ,cAAiB;IACnF,wDAAwD;IACxD,YAAY,CAAM;IAClB,uDAAuD;IACvD,UAAU,GAAiB,EAAE,CAAC;IAE9B;;;;;;OAMG;IACH,cAAc,CAAC,MAAmC;QAChD,OAAU,IAAI,gBAAgB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,EAAE,IAAI,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;gBAChC,GAAG,IAAI,CAAC,UAAU,CAAC,oBAAoB;gBACvC,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS;oBAC/B,OAAO,EAAE;wBACP,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,eAAe;qBAC3C;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,IAAY;QAC1B,gBAAgB;QAChB,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CAAC,OAA0B,EAAE,QAAQ,GAAG,SAAS;QACzD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gDAAgD,CAAC,CAAC;YACpE,OAAO,OAAO,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QACxC,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC1B,OAAO,CAAC,YAAY,GAAG,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,CAAC,YAAY,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACrD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;gBAChF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBACnC,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC7B,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;CACF;AAED,OAAO,EAAE,MAAM,EAA0C,CAAC"}

package/lib/services/{notificationservice.d.ts → notificationservice.service.d.ts}

@@ -1,11 +1,14 @@
-import { Ident } from "../models/ident.js";
-import { User } from "../models/user.js";
-import { Service, ServiceParameters } from "./service.js";
+import { ServiceName } from "../core/hooks.js";
+import { AbstractService } from "../core/icore.js";
+import type { Ident } from "../models/ident.model.js";
+import type { User } from "../models/user.model.js";
+import { ServiceParameters } from "../services/serviceparameters.js";
+import { Service } from "./service.js";
 /**
  * Define a service that can notify a user based on his info
  * It can use email or SMS or any other media
  */
-export interface NotificationService {
+export interface NotificationService extends AbstractService {
     /**
      * Check if this type of notification is available
      */
@@ -33,7 +36,7 @@ export declare class MultiNotificationParameters extends ServiceParameters {
      * When multiple is `false` the first available NotificationService will
      * be used, otherwise every available NotificationService will be used
      */
-    senders: string[];
+    senders: ServiceName[];
     /**
      * Define if it sends one or several notification per user
      * @default false
@@ -42,7 +45,7 @@ export declare class MultiNotificationParameters extends ServiceParameters {
     /**
      * @override
      */
-    constructor(params: any);
+    load(params?: any): this;
 }
 /**
  * Allow an aggregation of Notification to send via multiple media
@@ -52,10 +55,6 @@ export declare class MultiNotificationParameters extends ServiceParameters {
  */
 export default class MultiNotificationService<T extends MultiNotificationParameters = MultiNotificationParameters> extends Service<T> implements NotificationService {
     senders: NotificationService[];
-    /**
-     * @override
-     */
-    loadParameters(params: any): MultiNotificationParameters;
     /**
      * @override
      */
@@ -74,4 +73,4 @@ export default class MultiNotificationService<T extends MultiNotificationParamet
     hasNotification(notification: string): Promise<boolean>;
 }
 export { MultiNotificationService };
-//# sourceMappingURL=notificationservice.d.ts.map
+//# sourceMappingURL=notificationservice.service.d.ts.map

package/lib/services/notificationservice.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationservice.service.d.ts","sourceRoot":"","sources":["../../src/services/notificationservice.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiC,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD;;;OAGG;IACH,qBAAqB,CAAC,WAAW,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9F;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,iBAAiB;IAChE;;;;;OAKG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,MAAM,GAAE,GAAQ,GAAG,IAAI,CAK3B;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,wBAAwB,CAAC,CAAC,SAAS,2BAA2B,GAAG,2BAA2B,CAC/G,SAAQ,OAAO,CAAC,CAAC,CACjB,YAAW,mBAAmB;IAE9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAE/B;;OAEG;IACH,OAAO,IAAI,IAAI,CAWd;IAED;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjG;IAED;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhE;IAED;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5D;CACF;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/lib/services/{notificationservice.js → notificationservice.service.js}

@@ -1,14 +1,30 @@
-import { Service, ServiceParameters } from "./service.js";
+import { useDynamicService } from "../core/hooks.js";
+import { ServiceParameters } from "../services/serviceparameters.js";
+import { Service } from "./service.js";
 /**
  * Parameters for multi notification service
  */
 export class MultiNotificationParameters extends ServiceParameters {
+    /**
+     * Notification service that will send
+     * The order of the array is important if multiple is false
+     * When multiple is `false` the first available NotificationService will
+     * be used, otherwise every available NotificationService will be used
+     */
+    senders;
+    /**
+     * Define if it sends one or several notification per user
+     * @default false
+     */
+    multiple;
     /**
      * @override
      */
-    constructor(params) {
-        super(params);
-        this.senders ?? (this.senders = []);
+    load(params = {}) {
+        super.load(params);
+        this.senders ??= [];
+        this.multiple ??= false;
+        return this;
     }
 }
 /**
@@ -18,19 +34,15 @@ export class MultiNotificationParameters extends ServiceParameters {
  * @WebdaModda
  */
 export default class MultiNotificationService extends Service {
-    /**
-     * @override
-     */
-    loadParameters(params) {
-        return new MultiNotificationParameters(params);
-    }
+    senders;
     /**
      * @override
      */
     resolve() {
         super.resolve();
+        console.log("resolve", this.parameters.senders);
         this.senders = this.parameters.senders.map(s => {
-            const service = this.getService(s);
+            const service = useDynamicService(s);
             if (!service) {
                 throw new Error(`Unknown service '${s}'`);
             }
@@ -69,4 +81,4 @@ export default class MultiNotificationService extends Service {
     }
 }
 export { MultiNotificationService };
-//# sourceMappingURL=notificationservice.js.map
+//# sourceMappingURL=notificationservice.service.js.map

package/lib/services/notificationservice.service.js.map

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

package/lib/services/operationstransport.d.ts

@@ -0,0 +1,65 @@
+import { Service } from "./service.js";
+import { ServiceParameters } from "./serviceparameters.js";
+import { OperationDefinition } from "../core/icore.js";
+/**
+ * Parameters for transports that selectively expose operations based on include/exclude patterns
+ */
+export declare class OperationsTransportParameters extends ServiceParameters {
+    /**
+     * List of operations to include/exclude
+     * Supports wildcards and negation: ["*", "!User.Delete"]
+     * @default ["*"]
+     */
+    operations?: string[];
+    /**
+     * Parsed exclude list
+     * @SchemaIgnore
+     */
+    private excludedOperations;
+    /**
+     * Load parameters and parse the include/exclude lists
+     * @param params - the service parameters
+     * @returns this for chaining
+     */
+    load(params?: any): this;
+    /**
+     * Check if an operation matches a pattern (supports trailing wildcard)
+     * @param operationId - the operation identifier
+     * @param pattern - the pattern to match against
+     * @returns true if the operation matches the pattern
+     */
+    private matchesPattern;
+    /**
+     * Check if an operation is included by this transport
+     * @param operationId - the operation identifier
+     * @returns true if the operation is included
+     */
+    isIncluded(operationId: string): boolean;
+}
+/**
+ * Abstract base class for transports that expose operations via a specific protocol (REST, GraphQL, gRPC, etc.).
+ * Reads from the operation registry during init() and calls exposeOperation() for each visible operation.
+ */
+export declare abstract class OperationsTransport<T extends OperationsTransportParameters = OperationsTransportParameters> extends Service<T> {
+    /**
+     * Get all registered operations, filtered by this transport's include/exclude config
+     * @returns filtered map of operation id to definition
+     */
+    getOperations(): Record<string, OperationDefinition>;
+    /**
+     * Initialize the transport by exposing all non-hidden operations
+     * @returns this for chaining
+     */
+    init(): Promise<this>;
+    /**
+     * Walk the filtered operations and call exposeOperation for each non-hidden one
+     */
+    protected initTransport(): void;
+    /**
+     * Expose a single operation via the transport's protocol
+     * @param operationId - the operation identifier
+     * @param definition - the operation definition
+     */
+    abstract exposeOperation(operationId: string, definition: OperationDefinition): void;
+}
+//# sourceMappingURL=operationstransport.d.ts.map