@timmeck/brain-core 2.36.12 → 2.36.14

package/dist/notifications/email-provider.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Email Notification Provider — SMTP via nodemailer
+ *
+ * Einrichten:
+ *   1. SMTP Server konfigurieren (Gmail, Outlook, eigener SMTP)
+ *      Gmail: App-Passwort erstellen unter
+ *      https://myaccount.google.com/apppasswords
+ *   2. In .env:
+ *      SMTP_HOST=smtp.gmail.com
+ *      SMTP_PORT=587
+ *      SMTP_USER=deine@email.com
+ *      SMTP_PASS=app-password
+ *      NOTIFICATION_EMAIL_TO=empfaenger@email.com
+ *      NOTIFICATION_EMAIL_FROM=Brain Ecosystem <brain@example.com>   (optional)
+ */
+import type { NotificationProvider, Notification, NotificationResult } from './notification-provider.js';
+export interface EmailProviderConfig {
+    smtpHost?: string;
+    smtpPort?: number;
+    smtpUser?: string;
+    smtpPass?: string;
+    from?: string;
+    to?: string;
+}
+export declare class EmailProvider implements NotificationProvider {
+    readonly name = "email";
+    private readonly smtpHost;
+    private readonly smtpPort;
+    private readonly smtpUser;
+    private readonly smtpPass;
+    private readonly from;
+    private readonly to;
+    private readonly log;
+    private transporter;
+    private sentCount;
+    constructor(config?: EmailProviderConfig);
+    isAvailable(): Promise<boolean>;
+    send(notification: Notification): Promise<NotificationResult>;
+    shutdown(): Promise<void>;
+    private getTransporter;
+}

package/dist/notifications/email-provider.js

@@ -0,0 +1,101 @@
+/**
+ * Email Notification Provider — SMTP via nodemailer
+ *
+ * Einrichten:
+ *   1. SMTP Server konfigurieren (Gmail, Outlook, eigener SMTP)
+ *      Gmail: App-Passwort erstellen unter
+ *      https://myaccount.google.com/apppasswords
+ *   2. In .env:
+ *      SMTP_HOST=smtp.gmail.com
+ *      SMTP_PORT=587
+ *      SMTP_USER=deine@email.com
+ *      SMTP_PASS=app-password
+ *      NOTIFICATION_EMAIL_TO=empfaenger@email.com
+ *      NOTIFICATION_EMAIL_FROM=Brain Ecosystem <brain@example.com>   (optional)
+ */
+import { getLogger } from '../utils/logger.js';
+export class EmailProvider {
+    name = 'email';
+    smtpHost;
+    smtpPort;
+    smtpUser;
+    smtpPass;
+    from;
+    to;
+    log = getLogger();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    transporter = null;
+    sentCount = 0;
+    constructor(config = {}) {
+        this.smtpHost = config.smtpHost ?? process.env.SMTP_HOST ?? null;
+        this.smtpPort = config.smtpPort ?? Number(process.env.SMTP_PORT ?? 587);
+        this.smtpUser = config.smtpUser ?? process.env.SMTP_USER ?? null;
+        this.smtpPass = config.smtpPass ?? process.env.SMTP_PASS ?? null;
+        this.from = config.from ?? process.env.NOTIFICATION_EMAIL_FROM ?? `Brain Ecosystem <${this.smtpUser ?? 'brain@localhost'}>`;
+        this.to = config.to ?? process.env.NOTIFICATION_EMAIL_TO ?? null;
+    }
+    async isAvailable() {
+        if (!this.smtpHost || !this.smtpUser || !this.smtpPass || !this.to)
+            return false;
+        try {
+            const transporter = await this.getTransporter();
+            await transporter.verify();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(notification) {
+        try {
+            const transporter = await this.getTransporter();
+            const priorityLabel = notification.priority === 'critical' ? '[CRITICAL] ' :
+                notification.priority === 'high' ? '[HIGH] ' : '';
+            await transporter.sendMail({
+                from: this.from,
+                to: this.to,
+                subject: `${priorityLabel}Brain: ${notification.title}`,
+                text: `${notification.title}\n\n${notification.message}\n\nEvent: ${notification.event}\nPriority: ${notification.priority}\nTime: ${new Date(notification.timestamp ?? Date.now()).toISOString()}`,
+                html: `
+          <h2>${notification.title}</h2>
+          <p>${notification.message.replace(/\n/g, '<br>')}</p>
+          <hr>
+          <small>Event: ${notification.event} | Priority: ${notification.priority} | ${new Date(notification.timestamp ?? Date.now()).toISOString()}</small>
+        `,
+            });
+            this.sentCount++;
+            return { provider: this.name, success: true };
+        }
+        catch (err) {
+            return { provider: this.name, success: false, error: err.message };
+        }
+    }
+    async shutdown() {
+        if (this.transporter) {
+            try {
+                this.transporter.close();
+            }
+            catch { /* best effort */ }
+            this.transporter = null;
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async getTransporter() {
+        if (this.transporter)
+            return this.transporter;
+        // Dynamic import — nodemailer is optional (variable path avoids TS module resolution)
+        const modulePath = 'nodemailer';
+        const nodemailer = await import(/* webpackIgnore: true */ modulePath);
+        this.transporter = nodemailer.createTransport({
+            host: this.smtpHost,
+            port: this.smtpPort,
+            secure: this.smtpPort === 465,
+            auth: {
+                user: this.smtpUser,
+                pass: this.smtpPass,
+            },
+        });
+        return this.transporter;
+    }
+}
+//# sourceMappingURL=email-provider.js.map

package/dist/notifications/email-provider.js.map

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

package/dist/notifications/index.d.ts

@@ -0,0 +1,8 @@
+export { NotificationService, runNotificationMigration } from './notification-service.js';
+export { DiscordProvider } from './discord-provider.js';
+export { TelegramProvider } from './telegram-provider.js';
+export { EmailProvider } from './email-provider.js';
+export type { NotificationProvider, Notification, NotificationResult, NotificationPriority, NotificationEvent, NotificationProviderStatus, } from './notification-provider.js';
+export type { DiscordProviderConfig } from './discord-provider.js';
+export type { TelegramProviderConfig } from './telegram-provider.js';
+export type { EmailProviderConfig } from './email-provider.js';

package/dist/notifications/index.js

@@ -0,0 +1,5 @@
+export { NotificationService, runNotificationMigration } from './notification-service.js';
+export { DiscordProvider } from './discord-provider.js';
+export { TelegramProvider } from './telegram-provider.js';
+export { EmailProvider } from './email-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/notifications/notification-provider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Notification Provider Interface — Multi-Channel Notifications
+ *
+ * ═══════════════════════════════════════════════════════════════
+ *  PROVIDER EINRICHTEN
+ * ═══════════════════════════════════════════════════════════════
+ *
+ *  InternalProvider (default):
+ *    → Speichert Notifications in SQLite. Keine Config nötig.
+ *
+ *  WebhookProvider (bereits vorhanden):
+ *    → WebhookService für HTTP POST Notifications.
+ *
+ *  Discord (optional):
+ *    1. Discord Bot erstellen: https://discord.com/developers/applications
+ *       → Bot → Add Bot → Token kopieren
+ *       → OAuth2 → URL Generator → Scope: bot → Permissions: Send Messages
+ *       → Bot zum Server einladen
+ *    2. In .env:
+ *       DISCORD_BOT_TOKEN=...
+ *       DISCORD_CHANNEL_ID=...    (Rechtsklick auf Channel → Copy Channel ID)
+ *
+ *  Telegram (optional):
+ *    1. Bot erstellen: https://t.me/BotFather → /newbot
+ *       → Token kopieren
+ *    2. Chat ID finden: Message an Bot senden, dann
+ *       https://api.telegram.org/bot<TOKEN>/getUpdates → chat.id
+ *    3. In .env:
+ *       TELEGRAM_BOT_TOKEN=...
+ *       TELEGRAM_CHAT_ID=...
+ *
+ *  Email (optional):
+ *    1. SMTP Server konfigurieren (Gmail, Outlook, eigener SMTP)
+ *    2. In .env:
+ *       SMTP_HOST=smtp.gmail.com
+ *       SMTP_PORT=587
+ *       SMTP_USER=deine@email.com
+ *       SMTP_PASS=app-password       (Gmail: App-Passwort erstellen!)
+ *       NOTIFICATION_EMAIL_TO=empfaenger@email.com
+ *
+ *  Eigenen Provider bauen:
+ *    Implementiere NotificationProvider, registriere mit
+ *    notificationService.registerProvider(new MyProvider())
+ * ═══════════════════════════════════════════════════════════════
+ */
+export interface Notification {
+    event: NotificationEvent;
+    title: string;
+    message: string;
+    priority: NotificationPriority;
+    data?: Record<string, unknown>;
+    timestamp?: number;
+}
+export type NotificationPriority = 'critical' | 'high' | 'medium' | 'low';
+export type NotificationEvent = 'mission.complete' | 'trade.signal' | 'trade.closed' | 'learning.rule_created' | 'selfmod.proposal' | 'techradar.digest' | 'techradar.opportunity' | 'system.error' | 'system.health' | string;
+export interface NotificationResult {
+    provider: string;
+    success: boolean;
+    error?: string;
+}
+export interface NotificationProvider {
+    /** Unique provider name (e.g. 'discord', 'telegram', 'email') */
+    readonly name: string;
+    /** Check if provider is configured and reachable */
+    isAvailable(): Promise<boolean>;
+    /** Send a notification */
+    send(notification: Notification): Promise<NotificationResult>;
+    /** Graceful shutdown */
+    shutdown?(): Promise<void>;
+}
+export interface NotificationProviderStatus {
+    name: string;
+    available: boolean;
+    sentCount: number;
+}

package/dist/notifications/notification-provider.js

@@ -0,0 +1,47 @@
+/**
+ * Notification Provider Interface — Multi-Channel Notifications
+ *
+ * ═══════════════════════════════════════════════════════════════
+ *  PROVIDER EINRICHTEN
+ * ═══════════════════════════════════════════════════════════════
+ *
+ *  InternalProvider (default):
+ *    → Speichert Notifications in SQLite. Keine Config nötig.
+ *
+ *  WebhookProvider (bereits vorhanden):
+ *    → WebhookService für HTTP POST Notifications.
+ *
+ *  Discord (optional):
+ *    1. Discord Bot erstellen: https://discord.com/developers/applications
+ *       → Bot → Add Bot → Token kopieren
+ *       → OAuth2 → URL Generator → Scope: bot → Permissions: Send Messages
+ *       → Bot zum Server einladen
+ *    2. In .env:
+ *       DISCORD_BOT_TOKEN=...
+ *       DISCORD_CHANNEL_ID=...    (Rechtsklick auf Channel → Copy Channel ID)
+ *
+ *  Telegram (optional):
+ *    1. Bot erstellen: https://t.me/BotFather → /newbot
+ *       → Token kopieren
+ *    2. Chat ID finden: Message an Bot senden, dann
+ *       https://api.telegram.org/bot<TOKEN>/getUpdates → chat.id
+ *    3. In .env:
+ *       TELEGRAM_BOT_TOKEN=...
+ *       TELEGRAM_CHAT_ID=...
+ *
+ *  Email (optional):
+ *    1. SMTP Server konfigurieren (Gmail, Outlook, eigener SMTP)
+ *    2. In .env:
+ *       SMTP_HOST=smtp.gmail.com
+ *       SMTP_PORT=587
+ *       SMTP_USER=deine@email.com
+ *       SMTP_PASS=app-password       (Gmail: App-Passwort erstellen!)
+ *       NOTIFICATION_EMAIL_TO=empfaenger@email.com
+ *
+ *  Eigenen Provider bauen:
+ *    Implementiere NotificationProvider, registriere mit
+ *    notificationService.registerProvider(new MyProvider())
+ * ═══════════════════════════════════════════════════════════════
+ */
+export {};
+//# sourceMappingURL=notification-provider.js.map

package/dist/notifications/notification-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-provider.js","sourceRoot":"","sources":["../../src/notifications/notification-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG"}

package/dist/notifications/notification-service.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Notification Service — Aggregiert alle Notification Provider
+ *
+ * Architektur:
+ *   NotificationService
+ *     ├── InternalProvider (SQLite, default — immer da)
+ *     ├── WebhookProvider (HTTP POST — already exists)
+ *     ├── DiscordProvider (discord.js, optional)
+ *     ├── TelegramProvider (grammy, optional)
+ *     └── EmailProvider (nodemailer SMTP, optional)
+ *
+ * Event-Routing:
+ *   Jeder Event-Typ kann an bestimmte Provider geroutet werden.
+ *   Default: alle Events → alle verfügbaren Provider.
+ *
+ * Einrichten:
+ *   ```typescript
+ *   const service = new NotificationService(db);
+ *   service.registerProvider(new DiscordProvider());
+ *   service.registerProvider(new TelegramProvider());
+ *   service.registerProvider(new EmailProvider());
+ *
+ *   // Optional: Event-Routing konfigurieren
+ *   service.setEventRouting('system.error', ['discord', 'telegram', 'email']);
+ *   service.setEventRouting('techradar.digest', ['telegram', 'email']);
+ *   service.setEventRouting('learning.rule_created', ['internal']);
+ *
+ *   await service.notify({
+ *     event: 'trade.signal',
+ *     title: 'New Trading Signal',
+ *     message: 'BTC breakout detected...',
+ *     priority: 'high',
+ *   });
+ *   ```
+ */
+import Database from 'better-sqlite3';
+import type { NotificationProvider, Notification, NotificationResult, NotificationProviderStatus } from './notification-provider.js';
+export declare function runNotificationMigration(db: Database.Database): void;
+export declare class NotificationService {
+    private providers;
+    private eventRouting;
+    private readonly db;
+    constructor(db: Database.Database);
+    /** Register a notification provider */
+    registerProvider(provider: NotificationProvider): void;
+    /** Remove a provider by name */
+    removeProvider(name: string): void;
+    /** Get all registered providers */
+    getProviders(): NotificationProvider[];
+    /**
+     * Set event routing: which providers handle which events.
+     * If no routing is set, all providers receive all events.
+     */
+    setEventRouting(event: string, providerNames: string[]): void;
+    /** Get current event routing */
+    getEventRouting(): Record<string, string[]>;
+    /**
+     * Send a notification to all relevant providers.
+     * Uses event routing if configured, otherwise sends to all.
+     */
+    notify(notification: Notification): Promise<NotificationResult[]>;
+    /** Get target providers for an event based on routing config */
+    private getTargetProviders;
+    /** Log notification to SQLite */
+    private logNotification;
+    /** Get notification history */
+    getHistory(options?: {
+        event?: string;
+        limit?: number;
+    }): Array<{
+        id: number;
+        event: string;
+        title: string;
+        message: string;
+        priority: string;
+        provider: string;
+        success: boolean;
+        error: string | null;
+        created_at: string;
+    }>;
+    /** Get provider status */
+    getProviderStatus(): Promise<NotificationProviderStatus[]>;
+    /** Graceful shutdown */
+    shutdown(): Promise<void>;
+}

package/dist/notifications/notification-service.js

@@ -0,0 +1,184 @@
+/**
+ * Notification Service — Aggregiert alle Notification Provider
+ *
+ * Architektur:
+ *   NotificationService
+ *     ├── InternalProvider (SQLite, default — immer da)
+ *     ├── WebhookProvider (HTTP POST — already exists)
+ *     ├── DiscordProvider (discord.js, optional)
+ *     ├── TelegramProvider (grammy, optional)
+ *     └── EmailProvider (nodemailer SMTP, optional)
+ *
+ * Event-Routing:
+ *   Jeder Event-Typ kann an bestimmte Provider geroutet werden.
+ *   Default: alle Events → alle verfügbaren Provider.
+ *
+ * Einrichten:
+ *   ```typescript
+ *   const service = new NotificationService(db);
+ *   service.registerProvider(new DiscordProvider());
+ *   service.registerProvider(new TelegramProvider());
+ *   service.registerProvider(new EmailProvider());
+ *
+ *   // Optional: Event-Routing konfigurieren
+ *   service.setEventRouting('system.error', ['discord', 'telegram', 'email']);
+ *   service.setEventRouting('techradar.digest', ['telegram', 'email']);
+ *   service.setEventRouting('learning.rule_created', ['internal']);
+ *
+ *   await service.notify({
+ *     event: 'trade.signal',
+ *     title: 'New Trading Signal',
+ *     message: 'BTC breakout detected...',
+ *     priority: 'high',
+ *   });
+ *   ```
+ */
+import { getLogger } from '../utils/logger.js';
+const log = getLogger();
+// ── Migration ────────────────────────────────────────────
+export function runNotificationMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS notification_log (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      event TEXT NOT NULL,
+      title TEXT NOT NULL,
+      message TEXT NOT NULL,
+      priority TEXT NOT NULL DEFAULT 'medium',
+      provider TEXT NOT NULL,
+      success INTEGER NOT NULL DEFAULT 1,
+      error TEXT,
+      data_json TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_notification_log_event ON notification_log(event);
+    CREATE INDEX IF NOT EXISTS idx_notification_log_created ON notification_log(created_at);
+  `);
+}
+// ── Service ──────────────────────────────────────────────
+export class NotificationService {
+    providers = [];
+    eventRouting = new Map(); // event → provider names
+    db;
+    constructor(db) {
+        this.db = db;
+        runNotificationMigration(db);
+    }
+    /** Register a notification provider */
+    registerProvider(provider) {
+        if (this.providers.some(p => p.name === provider.name))
+            return;
+        this.providers.push(provider);
+        log.debug(`[Notifications] Registered provider: ${provider.name}`);
+    }
+    /** Remove a provider by name */
+    removeProvider(name) {
+        this.providers = this.providers.filter(p => p.name !== name);
+    }
+    /** Get all registered providers */
+    getProviders() {
+        return [...this.providers];
+    }
+    /**
+     * Set event routing: which providers handle which events.
+     * If no routing is set, all providers receive all events.
+     */
+    setEventRouting(event, providerNames) {
+        this.eventRouting.set(event, providerNames);
+    }
+    /** Get current event routing */
+    getEventRouting() {
+        return Object.fromEntries(this.eventRouting);
+    }
+    /**
+     * Send a notification to all relevant providers.
+     * Uses event routing if configured, otherwise sends to all.
+     */
+    async notify(notification) {
+        const results = [];
+        notification.timestamp = notification.timestamp ?? Date.now();
+        // Determine which providers should receive this event
+        const targetProviders = this.getTargetProviders(notification.event);
+        for (const provider of targetProviders) {
+            try {
+                const available = await provider.isAvailable();
+                if (!available) {
+                    const result = { provider: provider.name, success: false, error: 'Provider not available' };
+                    results.push(result);
+                    this.logNotification(notification, result);
+                    continue;
+                }
+                const result = await provider.send(notification);
+                results.push(result);
+                this.logNotification(notification, result);
+            }
+            catch (err) {
+                const result = { provider: provider.name, success: false, error: err.message };
+                results.push(result);
+                this.logNotification(notification, result);
+            }
+        }
+        return results;
+    }
+    /** Get target providers for an event based on routing config */
+    getTargetProviders(event) {
+        const routing = this.eventRouting.get(event);
+        if (!routing)
+            return this.providers; // No routing → all providers
+        return this.providers.filter(p => routing.includes(p.name));
+    }
+    /** Log notification to SQLite */
+    logNotification(notification, result) {
+        try {
+            this.db.prepare(`
+        INSERT INTO notification_log (event, title, message, priority, provider, success, error, data_json)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(notification.event, notification.title, notification.message, notification.priority, result.provider, result.success ? 1 : 0, result.error ?? null, notification.data ? JSON.stringify(notification.data) : null);
+        }
+        catch {
+            // Best effort logging
+        }
+    }
+    /** Get notification history */
+    getHistory(options = {}) {
+        let sql = 'SELECT * FROM notification_log';
+        const params = [];
+        if (options.event) {
+            sql += ' WHERE event = ?';
+            params.push(options.event);
+        }
+        sql += ' ORDER BY created_at DESC LIMIT ?';
+        params.push(options.limit ?? 50);
+        return this.db.prepare(sql).all(...params).map(r => ({
+            ...r,
+            success: r.success === 1,
+        }));
+    }
+    /** Get provider status */
+    async getProviderStatus() {
+        return Promise.all(this.providers.map(async (p) => {
+            let available = false;
+            try {
+                available = await p.isAvailable();
+            }
+            catch { /* not available */ }
+            return {
+                name: p.name,
+                available,
+                sentCount: 0,
+            };
+        }));
+    }
+    /** Graceful shutdown */
+    async shutdown() {
+        for (const provider of this.providers) {
+            if (provider.shutdown) {
+                try {
+                    await provider.shutdown();
+                }
+                catch { /* best effort */ }
+            }
+        }
+    }
+}
+//# sourceMappingURL=notification-service.js.map

package/dist/notifications/notification-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.js","sourceRoot":"","sources":["../../src/notifications/notification-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB,4DAA4D;AAE5D,MAAM,UAAU,wBAAwB,CAAC,EAAqB;IAC5D,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;GAgBP,CAAC,CAAC;AACL,CAAC;AAED,4DAA4D;AAE5D,MAAM,OAAO,mBAAmB;IACtB,SAAS,GAA2B,EAAE,CAAC;IACvC,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC,CAAC,yBAAyB;IAC5D,EAAE,CAAoB;IAEvC,YAAY,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,uCAAuC;IACvC,gBAAgB,CAAC,QAA8B;QAC7C,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO;QAC/D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,wCAAwC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,gCAAgC;IAChC,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,mCAAmC;IACnC,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,KAAa,EAAE,aAAuB;QACpD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,gCAAgC;IAChC,eAAe;QACb,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,YAA0B;QACrC,MAAM,OAAO,GAAyB,EAAE,CAAC;QACzC,YAAY,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAE9D,sDAAsD;QACtD,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpE,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,MAAM,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;oBAC5F,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACrB,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;oBAC3C,SAAS;gBACX,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;gBAC1F,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gEAAgE;IACxD,kBAAkB,CAAC,KAAa;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,6BAA6B;QAElE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,iCAAiC;IACzB,eAAe,CAAC,YAA0B,EAAE,MAA0B;QAC5E,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAGf,CAAC,CAAC,GAAG,CACJ,YAAY,CAAC,KAAK,EAClB,YAAY,CAAC,KAAK,EAClB,YAAY,CAAC,OAAO,EACpB,YAAY,CAAC,QAAQ,EACrB,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,KAAK,IAAI,IAAI,EACpB,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAC7D,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,UAAU,CAAC,UAA8C,EAAE;QAIzD,IAAI,GAAG,GAAG,gCAAgC,CAAC;QAC3C,MAAM,MAAM,GAAc,EAAE,CAAC;QAE7B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,GAAG,IAAI,kBAAkB,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAED,GAAG,IAAI,mCAAmC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAEjC,OAAQ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9D,GAAG,CAAC;YACJ,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,CAAC;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,iBAAiB;QACrB,OAAO,OAAO,CAAC,GAAG,CAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAC,CAAC,EAAC,EAAE;YAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC;gBAAC,SAAS,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;YACxE,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,SAAS;gBACT,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,QAAQ;QACZ,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,IAAI,CAAC;oBAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/notifications/telegram-provider.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Telegram Notification Provider — Bot Messages via grammy
+ *
+ * Einrichten:
+ *   1. Bot erstellen: https://t.me/BotFather → /newbot → Token kopieren
+ *   2. Chat ID finden: Nachricht an Bot senden, dann
+ *      https://api.telegram.org/bot<TOKEN>/getUpdates → chat.id
+ *   3. In .env:
+ *      TELEGRAM_BOT_TOKEN=...
+ *      TELEGRAM_CHAT_ID=...
+ */
+import type { NotificationProvider, Notification, NotificationResult } from './notification-provider.js';
+export interface TelegramProviderConfig {
+    botToken?: string;
+    chatId?: string;
+}
+export declare class TelegramProvider implements NotificationProvider {
+    readonly name = "telegram";
+    private readonly botToken;
+    private readonly chatId;
+    private readonly log;
+    private bot;
+    private sentCount;
+    constructor(config?: TelegramProviderConfig);
+    isAvailable(): Promise<boolean>;
+    send(notification: Notification): Promise<NotificationResult>;
+    shutdown(): Promise<void>;
+    private escapeMarkdown;
+    private getBot;
+}