@awesome-lang-auth/node 1.10.1

package/dist/services/jwks.service.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JwksService = exports.JwksClient = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const https_1 = __importDefault(require("https"));
+const http_1 = __importDefault(require("http"));
+/**
+ * A simple cached JWKS client for Resource Server use.
+ * Fetches and caches the public keys from a remote JWKS URL.
+ */
+class JwksClient {
+    constructor(jwksUrl, options = {}) {
+        this.jwksUrl = jwksUrl;
+        this.cachedDocument = null;
+        this.cacheExpiry = 0;
+        this.fetchPromise = null;
+        this.cacheTtl = options.cacheTtl ?? 3600000;
+        this.fetchTimeout = options.fetchTimeout ?? 5000;
+    }
+    /**
+     * Get the JWKS document, fetching from remote if the cache is stale.
+     * Uses stale-while-revalidate: returns the cached doc immediately if available,
+     * then refreshes in the background when TTL expires.
+     */
+    async getJwks() {
+        const now = Date.now();
+        if (this.cachedDocument && now < this.cacheExpiry) {
+            return this.cachedDocument;
+        }
+        // If a fetch is already in progress, wait for it
+        if (this.fetchPromise) {
+            return this.fetchPromise;
+        }
+        // Stale-while-revalidate: return cached doc immediately if we have one,
+        // and trigger background refresh
+        if (this.cachedDocument) {
+            this.fetchPromise = this._fetch()
+                .then((doc) => {
+                this.cachedDocument = doc;
+                this.cacheExpiry = Date.now() + this.cacheTtl;
+                this.fetchPromise = null;
+                return doc;
+            })
+                .catch(() => {
+                this.fetchPromise = null;
+                return this.cachedDocument;
+            });
+            // Return stale cache immediately
+            return this.cachedDocument;
+        }
+        // No cache at all — must wait for the initial fetch
+        this.fetchPromise = this._fetch().then((doc) => {
+            this.cachedDocument = doc;
+            this.cacheExpiry = Date.now() + this.cacheTtl;
+            this.fetchPromise = null;
+            return doc;
+        });
+        try {
+            return await this.fetchPromise;
+        }
+        catch (err) {
+            this.fetchPromise = null;
+            throw err;
+        }
+    }
+    /** Find a JWK by its key ID (`kid`). Returns null if not found. */
+    async getKey(kid) {
+        const doc = await this.getJwks();
+        return doc.keys.find((k) => k.kid === kid) ?? null;
+    }
+    /** Force-invalidate the cache so the next call fetches fresh keys. */
+    invalidateCache() {
+        this.cachedDocument = null;
+        this.cacheExpiry = 0;
+        this.fetchPromise = null;
+    }
+    _fetch() {
+        return new Promise((resolve, reject) => {
+            const url = new URL(this.jwksUrl);
+            const transport = url.protocol === 'https:' ? https_1.default : http_1.default;
+            const timeout = setTimeout(() => reject(new Error(`JWKS fetch timed out: ${this.jwksUrl}`)), this.fetchTimeout);
+            const req = transport.get(this.jwksUrl, (res) => {
+                if (res.statusCode !== 200) {
+                    clearTimeout(timeout);
+                    reject(new Error(`JWKS fetch failed with status ${res.statusCode}`));
+                    res.resume();
+                    return;
+                }
+                let data = '';
+                res.on('data', (chunk) => { data += chunk.toString(); });
+                res.on('end', () => {
+                    clearTimeout(timeout);
+                    try {
+                        const doc = JSON.parse(data);
+                        if (!Array.isArray(doc.keys)) {
+                            reject(new Error('Invalid JWKS document: missing "keys" array'));
+                            return;
+                        }
+                        resolve(doc);
+                    }
+                    catch {
+                        reject(new Error('Invalid JWKS document: failed to parse JSON'));
+                    }
+                });
+            });
+            req.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+        });
+    }
+}
+exports.JwksClient = JwksClient;
+class JwksService {
+    /**
+     * Generate an RSA-2048 keypair.
+     * Returns PEM-encoded `privateKey` and `publicKey` strings.
+     */
+    static generateKeypair() {
+        const { privateKey, publicKey } = crypto_1.default.generateKeyPairSync('rsa', {
+            modulusLength: 2048,
+            publicKeyEncoding: { type: 'spki', format: 'pem' },
+            privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
+        });
+        return { privateKey, publicKey };
+    }
+    /**
+     * Derive the public key PEM from a private key PEM.
+     */
+    static derivePublicKey(privateKeyPem) {
+        const keyObj = crypto_1.default.createPrivateKey(privateKeyPem);
+        return crypto_1.default.createPublicKey(keyObj).export({ type: 'spki', format: 'pem' });
+    }
+    /**
+     * Convert a PEM-encoded RSA public key to JWK format.
+     */
+    static publicKeyToJwk(publicKeyPem, kid) {
+        const keyObj = crypto_1.default.createPublicKey(publicKeyPem);
+        const jwk = keyObj.export({ format: 'jwk' });
+        return {
+            kty: jwk.kty,
+            use: 'sig',
+            alg: 'RS256',
+            kid,
+            n: jwk.n,
+            e: jwk.e,
+        };
+    }
+    /**
+     * Build a full JWKS document from a PEM-encoded RSA public key.
+     */
+    static buildJwksDocument(publicKeyPem, kid = 'provisioner-key-1') {
+        return { keys: [JwksService.publicKeyToJwk(publicKeyPem, kid)] };
+    }
+    /**
+     * Create a cached JWKS client for a remote URL (Resource Server use).
+     */
+    static createRemoteClient(jwksUrl, options) {
+        return new JwksClient(jwksUrl, options);
+    }
+    /**
+     * Convert a JWK (`n`, `e` fields) to an RSA public key PEM string
+     * usable by `jwt.verify()`.
+     */
+    static jwkToPublicKey(jwk) {
+        const keyObj = crypto_1.default.createPublicKey({ key: jwk, format: 'jwk' });
+        return keyObj.export({ type: 'spki', format: 'pem' });
+    }
+}
+exports.JwksService = JwksService;
+//# sourceMappingURL=jwks.service.js.map

package/dist/services/jwks.service.js.map

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

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

@@ -0,0 +1,30 @@
+import { MailerConfig } from '../models/auth-config.model';
+import { ITemplateStore } from '../interfaces/template-store.interface';
+export declare class MailerService {
+    private readonly config;
+    private readonly templateStore?;
+    constructor(config: MailerConfig, templateStore?: ITemplateStore | undefined);
+    private render;
+    sendPasswordReset(to: string, _token: string, link: string, lang?: string): Promise<void>;
+    sendMagicLink(to: string, _token: string, link: string, lang?: string): Promise<void>;
+    sendWelcome(to: string, data: Record<string, unknown>, lang?: string): Promise<void>;
+    sendVerificationEmail(to: string, _token: string, link: string, lang?: string): Promise<void>;
+    sendEmailChanged(to: string, newEmail: string, lang?: string): Promise<void>;
+    sendInvitation(to: string, link: string, data: Record<string, unknown>, lang?: string): Promise<void>;
+    /**
+     * Send a custom (free-form) email notification.
+     *
+     * Use this when you need to send an arbitrary business notification (e.g.
+     * "your subscription expires in 3 days") using the same transport that is
+     * already configured for auth emails.
+     *
+     * @param to      Recipient email address.
+     * @param subject Subject line.
+     * @param html    HTML body.
+     * @param text    Plain-text fallback (defaults to stripped HTML).
+     */
+    sendCustom(to: string, subject: string, html: string, text?: string): Promise<void>;
+    private resolveLang;
+    private send;
+}
+//# sourceMappingURL=mailer.service.d.ts.map

package/dist/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":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AA0IxE,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBADd,MAAM,EAAE,YAAY,EACpB,aAAa,CAAC,EAAE,cAAc,YAAA;YAGnC,MAAM;IAoCd,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzF,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrF,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpF,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7F,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3G;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczF,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,IAAI;CA+Bb"}

package/dist/services/mailer.service.js

@@ -0,0 +1,248 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerService = void 0;
+const https_1 = __importDefault(require("https"));
+const http_1 = __importDefault(require("http"));
+const url_1 = require("url");
+function passwordResetTemplate(link, lang) {
+    if (lang === 'it') {
+        return {
+            subject: 'Reimposta la tua password',
+            html: `<p>Hai richiesto di reimpostare la tua password.</p>
+<p>Clicca sul link seguente per procedere (valido 1 ora):</p>
+<p><a href="${link}">${link}</a></p>
+<p>Se non hai richiesto questo, ignora questa email.</p>`,
+            text: `Hai richiesto di reimpostare la tua password.\n\nClicca sul link seguente (valido 1 ora):\n${link}\n\nSe non hai richiesto questo, ignora questa email.`,
+        };
+    }
+    return {
+        subject: 'Reset your password',
+        html: `<p>You requested a password reset.</p>
+<p>Click the link below to proceed (valid for 1 hour):</p>
+<p><a href="${link}">${link}</a></p>
+<p>If you did not request this, please ignore this email.</p>`,
+        text: `You requested a password reset.\n\nClick the link below (valid for 1 hour):\n${link}\n\nIf you did not request this, please ignore this email.`,
+    };
+}
+function magicLinkTemplate(link, lang) {
+    if (lang === 'it') {
+        return {
+            subject: 'Il tuo link di accesso',
+            html: `<p>Hai richiesto un link di accesso.</p>
+<p>Clicca sul link seguente per accedere (valido 15 minuti):</p>
+<p><a href="${link}">${link}</a></p>
+<p>Se non hai richiesto questo, ignora questa email.</p>`,
+            text: `Hai richiesto un link di accesso.\n\nClicca sul link seguente (valido 15 minuti):\n${link}\n\nSe non hai richiesto questo, ignora questa email.`,
+        };
+    }
+    return {
+        subject: 'Your magic sign-in link',
+        html: `<p>You requested a sign-in link.</p>
+<p>Click the link below to sign in (valid for 15 minutes):</p>
+<p><a href="${link}">${link}</a></p>
+<p>If you did not request this, please ignore this email.</p>`,
+        text: `You requested a sign-in link.\n\nClick the link below (valid for 15 minutes):\n${link}\n\nIf you did not request this, please ignore this email.`,
+    };
+}
+function welcomeTemplate(data, lang) {
+    const loginUrl = data['loginUrl'] ?? '';
+    const tempPassword = data['tempPassword'];
+    if (lang === 'it') {
+        const passwordLine = tempPassword
+            ? `<p>Password temporanea: <strong>${tempPassword}</strong></p>`
+            : '';
+        const passwordText = tempPassword ? `Password temporanea: ${tempPassword}\n` : '';
+        return {
+            subject: 'Benvenuto! Il tuo account è stato creato',
+            html: `<p>Il tuo account è stato creato con successo.</p>
+${passwordLine}
+<p>Accedi qui: <a href="${loginUrl}">${loginUrl}</a></p>`,
+            text: `Il tuo account è stato creato con successo.\n${passwordText}Accedi qui: ${loginUrl}`,
+        };
+    }
+    const passwordLine = tempPassword
+        ? `<p>Temporary password: <strong>${tempPassword}</strong></p>`
+        : '';
+    const passwordText = tempPassword ? `Temporary password: ${tempPassword}\n` : '';
+    return {
+        subject: 'Welcome! Your account has been created',
+        html: `<p>Your account has been created successfully.</p>
+${passwordLine}
+<p>Sign in here: <a href="${loginUrl}">${loginUrl}</a></p>`,
+        text: `Your account has been created successfully.\n${passwordText}Sign in here: ${loginUrl}`,
+    };
+}
+function verificationEmailTemplate(link, lang) {
+    if (lang === 'it') {
+        return {
+            subject: 'Verifica il tuo indirizzo email',
+            html: `<p>Grazie per esserti registrato.</p>
+<p>Clicca sul link seguente per verificare il tuo indirizzo email (valido 24 ore):</p>
+<p><a href="${link}">${link}</a></p>
+<p>Se non hai creato un account, ignora questa email.</p>`,
+            text: `Grazie per esserti registrato.\n\nClicca sul link seguente per verificare il tuo indirizzo email (valido 24 ore):\n${link}\n\nSe non hai creato un account, ignora questa email.`,
+        };
+    }
+    return {
+        subject: 'Verify your email address',
+        html: `<p>Thank you for signing up.</p>
+<p>Click the link below to verify your email address (valid for 24 hours):</p>
+<p><a href="${link}">${link}</a></p>
+<p>If you did not create an account, please ignore this email.</p>`,
+        text: `Thank you for signing up.\n\nClick the link below to verify your email address (valid for 24 hours):\n${link}\n\nIf you did not create an account, please ignore this email.`,
+    };
+}
+function emailChangedTemplate(newEmail, lang) {
+    if (lang === 'it') {
+        return {
+            subject: 'Il tuo indirizzo email è stato aggiornato',
+            html: `<p>Questo è un avviso che il tuo indirizzo email è stato aggiornato a <strong>${newEmail}</strong>.</p>
+<p>Se non hai richiesto questa modifica, contatta immediatamente il supporto.</p>`,
+            text: `Il tuo indirizzo email è stato aggiornato a ${newEmail}.\n\nSe non hai richiesto questa modifica, contatta immediatamente il supporto.`,
+        };
+    }
+    return {
+        subject: 'Your email address has been updated',
+        html: `<p>This is a notice that your email address has been updated to <strong>${newEmail}</strong>.</p>
+<p>If you did not request this change, please contact support immediately.</p>`,
+        text: `Your email address has been updated to ${newEmail}.\n\nIf you did not request this change, please contact support immediately.`,
+    };
+}
+class MailerService {
+    constructor(config, templateStore) {
+        this.config = config;
+        this.templateStore = templateStore;
+    }
+    async render(templateId, lang, data, fallback) {
+        const l = this.resolveLang(lang);
+        if (this.templateStore) {
+            const tpl = await this.templateStore.getMailTemplate(templateId);
+            if (tpl && tpl.baseHtml && tpl.baseText) {
+                const translations = tpl.translations[l] || tpl.translations['en'] || {};
+                const interpolate = (str) => {
+                    // 1. Interpolate translations: {{T.key}}
+                    let result = str.replace(/\{\{T\.([^}]+)\}\}/g, (_, key) => translations[key] || `[${key}]`);
+                    // 2. Interpolate data: {{KEY}}
+                    result = result.replace(/\{\{([^}]+)\}\}/g, (_, key) => {
+                        if (key.startsWith('T.'))
+                            return _; // already handled
+                        return String(data[key] ?? `[${key}]`);
+                    });
+                    return result;
+                };
+                const subject = translations['subject'] || fallback(l).subject;
+                return {
+                    subject: interpolate(subject),
+                    html: interpolate(tpl.baseHtml),
+                    text: interpolate(tpl.baseText),
+                };
+            }
+        }
+        return fallback(l);
+    }
+    // ---- Public helpers -------------------------------------------------------
+    async sendPasswordReset(to, _token, link, lang) {
+        const tpl = await this.render('password-reset', lang || '', { link, token: _token }, (l) => passwordResetTemplate(link, l));
+        await this.send({ to, ...tpl, from: this.config.from, fromName: this.config.fromName, provider: this.config.provider });
+    }
+    async sendMagicLink(to, _token, link, lang) {
+        const tpl = await this.render('magic-link', lang || '', { link, token: _token }, (l) => magicLinkTemplate(link, l));
+        await this.send({ to, ...tpl, from: this.config.from, fromName: this.config.fromName, provider: this.config.provider });
+    }
+    async sendWelcome(to, data, lang) {
+        const tpl = await this.render('welcome', lang || '', data, (l) => welcomeTemplate(data, l));
+        await this.send({ to, ...tpl, from: this.config.from, fromName: this.config.fromName, provider: this.config.provider });
+    }
+    async sendVerificationEmail(to, _token, link, lang) {
+        const tpl = await this.render('verify-email', lang || '', { link, token: _token }, (l) => verificationEmailTemplate(link, l));
+        await this.send({ to, ...tpl, from: this.config.from, fromName: this.config.fromName, provider: this.config.provider });
+    }
+    async sendEmailChanged(to, newEmail, lang) {
+        const tpl = await this.render('email-changed', lang || '', { newEmail }, (l) => emailChangedTemplate(newEmail, l));
+        await this.send({ to, ...tpl, from: this.config.from, fromName: this.config.fromName, provider: this.config.provider });
+    }
+    async sendInvitation(to, link, data, lang) {
+        const tpl = await this.render('invitation', lang || '', { ...data, link }, (l) => {
+            // Fallback for invitation if not defined in store
+            if (l === 'it') {
+                return {
+                    subject: 'Invito ad unirsi',
+                    html: `<p>Sei stato invitato.</p><p><a href="${link}">${link}</a></p>`,
+                    text: `Sei stato invitato.\n\n${link}`
+                };
+            }
+            return {
+                subject: 'Invitation to join',
+                html: `<p>You have been invited.</p><p><a href="${link}">${link}</a></p>`,
+                text: `You have been invited.\n\n${link}`
+            };
+        });
+        await this.send({ to, ...tpl, from: this.config.from, fromName: this.config.fromName, provider: this.config.provider });
+    }
+    /**
+     * Send a custom (free-form) email notification.
+     *
+     * Use this when you need to send an arbitrary business notification (e.g.
+     * "your subscription expires in 3 days") using the same transport that is
+     * already configured for auth emails.
+     *
+     * @param to      Recipient email address.
+     * @param subject Subject line.
+     * @param html    HTML body.
+     * @param text    Plain-text fallback (defaults to stripped HTML).
+     */
+    async sendCustom(to, subject, html, text) {
+        await this.send({
+            to,
+            subject,
+            html,
+            text: text ?? html,
+            from: this.config.from,
+            fromName: this.config.fromName,
+            provider: this.config.provider,
+        });
+    }
+    // ---- Transport ------------------------------------------------------------
+    resolveLang(lang) {
+        if (lang === 'it')
+            return 'it';
+        if (lang === 'en')
+            return 'en';
+        return this.config.defaultLang ?? 'en';
+    }
+    send(payload) {
+        return new Promise((resolve, reject) => {
+            const url = new url_1.URL(this.config.endpoint);
+            const body = JSON.stringify(payload);
+            const options = {
+                hostname: url.hostname,
+                port: url.port || (url.protocol === 'https:' ? 443 : 80),
+                path: url.pathname + (url.search || ''),
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(body),
+                    'X-API-Key': this.config.apiKey,
+                },
+            };
+            const transport = url.protocol === 'https:' ? https_1.default : http_1.default;
+            const req = transport.request(options, (res) => {
+                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Mailer request failed with status ${res.statusCode}`));
+                }
+                res.resume();
+            });
+            req.on('error', reject);
+            req.write(body);
+            req.end();
+        });
+    }
+}
+exports.MailerService = MailerService;
+//# sourceMappingURL=mailer.service.js.map

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

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

package/dist/services/notification.service.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Notification service for awesome-node-auth.
+ *
+ * Provides a thin, transport-agnostic wrapper around the built-in
+ * `MailerService` and `SmsService` so that business-level notifications
+ * (e.g. "your subscription will expire in 3 days") can be sent over the same
+ * transports that are already configured for authentication flows — without
+ * passing the entire `AuthConfig` to `AuthTools`.
+ *
+ * @since 1.8.0
+ */
+import { MailerConfig } from '../models/auth-config.model';
+import { SmsConfig } from './sms.service';
+export { SmsConfig };
+/**
+ * Configuration for the email notification transport.
+ *
+ * Uses the same shape as `MailerConfig` so that the same object can be passed
+ * to both `AuthConfig.email.mailer` and `NotificationService`.
+ *
+ * @since 1.8.0
+ */
+export type EmailNotificationConfig = MailerConfig;
+/**
+ * Configuration for the SMS notification transport.
+ *
+ * Uses the same shape as `SmsConfig` so that the same object can be passed to
+ * both `AuthConfig.sms` and `NotificationService`.
+ *
+ * @since 1.8.0
+ */
+export type SmsNotificationConfig = SmsConfig;
+/**
+ * Options for {@link NotificationService.sendEmail}.
+ *
+ * @since 1.8.0
+ */
+export interface SendEmailOptions {
+    /** Recipient email address. */
+    to: string;
+    /** Email subject line. */
+    subject: string;
+    /** HTML body. */
+    html: string;
+    /** Plain-text fallback body. */
+    text?: string;
+}
+/**
+ * Options for {@link NotificationService.sendSms}.
+ *
+ * @since 1.8.0
+ */
+export interface SendSmsOptions {
+    /** Recipient phone number (E.164 format recommended). */
+    to: string;
+    /** SMS message body. */
+    message: string;
+}
+/**
+ * A thin facade that exposes email and SMS sending without requiring the
+ * entire `AuthConfig`.  Intended for use with `AuthTools.notify()` when
+ * email or SMS channels are requested.
+ *
+ * @example
+ * ```ts
+ * import { NotificationService } from '@awesome-lang-auth/node';
+ *
+ * const notifications = new NotificationService({
+ *   email: { endpoint: process.env.MAILER_ENDPOINT!, apiKey: process.env.MAILER_KEY!, from: 'no-reply@example.com' },
+ *   sms:   { endpoint: process.env.SMS_ENDPOINT!,    apiKey: process.env.SMS_KEY!,    username: '...', password: '...' },
+ * });
+ *
+ * await notifications.sendEmail({
+ *   to: 'alice@example.com',
+ *   subject: 'Subscription expiring',
+ *   html: '<p>Your subscription expires in 3 days.</p>',
+ * });
+ * ```
+ *
+ * @since 1.8.0
+ */
+export declare class NotificationService {
+    private readonly mailer?;
+    private readonly sms?;
+    constructor(opts?: {
+        email?: EmailNotificationConfig;
+        sms?: SmsNotificationConfig;
+    });
+    /**
+     * Send a custom email notification.
+     *
+     * Throws if no email transport is configured.
+     *
+     * @since 1.8.0
+     */
+    sendEmail(opts: SendEmailOptions): Promise<void>;
+    /**
+     * Send a custom SMS notification.
+     *
+     * Throws if no SMS transport is configured.
+     *
+     * @since 1.8.0
+     */
+    sendSms(opts: SendSmsOptions): Promise<void>;
+    /** `true` when an email transport is configured. */
+    get hasEmail(): boolean;
+    /** `true` when an SMS transport is configured. */
+    get hasSms(): boolean;
+}
+//# sourceMappingURL=notification.service.d.ts.map

package/dist/services/notification.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.service.d.ts","sourceRoot":"","sources":["../../src/services/notification.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAa;gBAEtB,IAAI,GAAE;QAChB,KAAK,CAAC,EAAE,uBAAuB,CAAC;QAChC,GAAG,CAAC,EAAE,qBAAqB,CAAC;KACxB;IAKN;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,oDAAoD;IACpD,IAAI,QAAQ,IAAI,OAAO,CAA0B;IACjD,kDAAkD;IAClD,IAAI,MAAM,IAAI,OAAO,CAAuB;CAC7C"}