@chatman-media/conversation-engine 1.2.0 → 1.3.1

package/dist/notifications.d.ts

@@ -1,3 +1,4 @@
+import type { AdminInformer } from "./admin-informer.ts";
 import type { NotificationRule, NotificationsRepo } from "./dal/notifications.ts";
 export interface NotificationEvent {
     tenantId: number;
@@ -13,8 +14,20 @@ export declare class NotificationService {
     private readonly repo;
     private readonly botToken;
     private readonly appUrl;
+    /**
+     * Если задан — владелец (superadmin) обслуживается информером (уровни +
+     * дайджест + лента) и пропускается в per-operator-рассылке ниже, чтобы не
+     * было дублей. Операторские правила/группы — без изменений.
+     */
+    private readonly informer?;
     private client;
-    constructor(repo: NotificationsRepo, botToken: string, appUrl: string);
+    constructor(repo: NotificationsRepo, botToken: string, appUrl: string, 
+    /**
+     * Если задан — владелец (superadmin) обслуживается информером (уровни +
+     * дайджест + лента) и пропускается в per-operator-рассылке ниже, чтобы не
+     * было дублей. Операторские правила/группы — без изменений.
+     */
+    informer?: AdminInformer | undefined);
     notify(event: NotificationEvent): Promise<void>;
     sendTestMessage(chatId: string): Promise<{
         ok: boolean;

package/dist/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;IAO3B,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC/C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAcjE,WAAW;IAazB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAa3E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAc9D,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAsB/C,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,SAAS;CAUlB"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAX5B,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;IAC/B;;;;OAIG;IACc,QAAQ,CAAC,EAAE,aAAa,YAAA;IAOrC,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD/C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAcjE,WAAW;IAazB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAa3E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAc9D,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAsB/C,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,SAAS;CAUlB"}

package/dist/operator-bot-handler.d.ts

@@ -1,11 +1,27 @@
 import { type TgUpdate } from "@chatman-media/channel-telegram";
 import type { NotificationsRepo } from "./dal/notifications.ts";
+/** "2h" / "30m" / "1d" → секунды; "off"/"0"/"" → 0; мусор → null. */
+export declare function parseMuteSeconds(arg: string): number | null;
 export declare class OperatorBotHandler {
     private readonly repo;
     private readonly botToken;
     private client;
     constructor(repo: NotificationsRepo, botToken: string);
     handleUpdate(update: TgUpdate): Promise<void>;
+    private cmdStatus;
+    private cmdLevel;
+    private cmdTopics;
+    private cmdDigest;
+    private cmdMute;
+    private cmdLast;
+    private handleCallback;
+    private editKeyboard;
+    private levelKeyboard;
+    private digestKeyboard;
+    private topicsKeyboard;
+    /** JSON-карта тоглов → полная карта {topic:bool} с дефолтом true. */
+    private topicMap;
+    private replyNotLinked;
     private handleLinkToken;
     private handleGroupLinkToken;
     private handleSetupGroup;

package/dist/operator-bot-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operator-bot-handler.d.ts","sourceRoot":"","sources":["../src/operator-bot-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM;IAO7B,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAwCrC,eAAe;YAoBf,oBAAoB;YAmCpB,gBAAgB;CAkB/B"}
+{"version":3,"file":"operator-bot-handler.d.ts","sourceRoot":"","sources":["../src/operator-bot-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAsChE,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM;IAO7B,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAmErC,SAAS;YAwBT,QAAQ;YAUR,SAAS;YAUT,SAAS;YAUT,OAAO;YAsBP,OAAO;YAqBP,cAAc;YAoCd,YAAY;IAkB1B,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAQtB,qEAAqE;IACrE,OAAO,CAAC,QAAQ;YAiBF,cAAc;YASd,eAAe;YAoBf,oBAAoB;YAmCpB,gBAAgB;CAkB/B"}

package/dist/ops-alerts.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Operations-алерты владельцу (#145). Доставка операционных алертов обменника
+ * (резкие колебания курса, устаревший фид, зависшие заявки, упавшие каналы,
+ * всплеск оборота) человеку, который НЕ сидит в админке.
+ *
+ * Источники алертов (sink-и): operations-watcher (apps/worker) и рыночный фид
+ * (apps/api). Оба строят OpsAlert и зовут OpsAlertRouter.emit().
+ *
+ * Маршрутизация по severity:
+ *   critical → личный Telegram владельца + email (немедленно; email — гарантия,
+ *              даже если Telegram не настроен/упал);
+ *   warning  → Telegram (email только как fallback, если Telegram не доставлен);
+ *   info     → Telegram (дайджест — возможный follow-up).
+ *
+ * Анти-шторм: in-memory cooldown на (tenant, dedupKey). Не переживает рестарт
+ * процесса (тогда возможен один повторный алерт — это не шторм).
+ *
+ * Зависимости (TelegramClient, email-отправитель) инжектятся — пакет остаётся
+ * без app-зависимостей.
+ */
+import type { AdminInformer } from "./admin-informer.ts";
+import type { Db } from "./dal/types.ts";
+export type OpsAlertKind = "rate_anomaly" | "rate_feed_stale" | "order_stuck" | "channel_down" | "volume_spike";
+export type OpsSeverity = "critical" | "warning" | "info";
+export interface OpsAlert {
+    tenantId: number;
+    kind: OpsAlertKind;
+    severity: OpsSeverity;
+    title: string;
+    detail: string;
+    /** Уникален для конкретного условия — основа cooldown/анти-шторма. */
+    dedupKey: string;
+}
+export interface OpsAlertSink {
+    emit(alert: OpsAlert): Promise<void>;
+}
+/** Минимальный контракт отправителя email (Mailer из apps/api ему соответствует). */
+export interface OpsEmailSender {
+    send(opts: {
+        to: string;
+        subject: string;
+        html: string;
+    }): Promise<void>;
+}
+/** Контракт отправителя Telegram (по умолчанию строится из botToken; инжектится в тестах). */
+export interface OpsTelegramSender {
+    send(chatId: string, htmlText: string): Promise<void>;
+}
+export interface OwnerContacts {
+    email: string | null;
+    slug: string | null;
+    telegramChatIds: string[];
+}
+export interface OpsAlertRouterDeps {
+    db: Db;
+    /** Токен operator-бота (PLATFORM_OPERATOR_BOT_TOKEN). Пусто → Telegram отключён. */
+    botToken: string;
+    appUrl: string;
+    /** Отправитель email. null → email-канал отключён. */
+    email?: OpsEmailSender | null;
+    /** Override отправителя Telegram (для тестов). По умолчанию строится из botToken. */
+    telegram?: OpsTelegramSender | null;
+    /** Анти-шторм: не повторять один (tenant, dedupKey) чаще, мс. Default 30 мин. */
+    cooldownMs?: number;
+    /**
+     * Если задан — emit() делегирует доставку информеру владельца (уровни +
+     * дайджест + лента), а собственный Telegram/email-роутинг НЕ выполняется
+     * (чтобы не было дублей). ops-watch-sweep не трогаем: он по-прежнему зовёт
+     * sink.emit(). Без informer — standalone-поведение (back-compat для тестов).
+     */
+    informer?: AdminInformer;
+    log?: {
+        warn?: (msg: string, ctx?: unknown) => void;
+        info?: (msg: string, ctx?: unknown) => void;
+    };
+}
+/** Резолвит контакты владельца тенанта: email супер-админа + Telegram-чаты операторов. */
+export declare function resolveOwnerContacts(db: Db, tenantId: number): Promise<OwnerContacts>;
+export declare class OpsAlertRouter implements OpsAlertSink {
+    private readonly deps;
+    private readonly telegram;
+    private readonly cooldownMs;
+    private readonly lastAt;
+    constructor(deps: OpsAlertRouterDeps);
+    private suppressed;
+    emit(alert: OpsAlert): Promise<void>;
+}
+/** Самодостаточный HTML операционного алерта (без зависимости от шаблонов apps/api). */
+export declare function renderOpsEmailHtml(alert: OpsAlert, appUrl: string): string;
+/** Тонкий транспорт Resend для apps/worker (apps/api использует свой Mailer). */
+export declare class ResendEmailSender implements OpsEmailSender {
+    private readonly apiKey;
+    private readonly from;
+    constructor(apiKey: string, from: string);
+    send(opts: {
+        to: string;
+        subject: string;
+        html: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=ops-alerts.d.ts.map

package/dist/ops-alerts.d.ts.map

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

package/dist/ops-alerts.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ops-alerts.integration.test.d.ts.map

package/dist/ops-alerts.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-alerts.integration.test.d.ts","sourceRoot":"","sources":["../src/ops-alerts.integration.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatman-media/conversation-engine",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Channel-agnostic pipeline обработки inbound сообщений: contact-resolve → conversation lookup → mode routing → AI-reply / queued / human → outbound. Сердце data plane.",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,20 +34,20 @@
   "author": "Alexander Kireev",
   "license": "MIT",
   "dependencies": {
-    "@chatman-media/channel-core": "1.0.0",
-    "@chatman-media/channel-telegram": "1.0.0",
-    "@chatman-media/llm-router": "1.0.0",
-    "@chatman-media/kb": "1.2.0",
-    "@chatman-media/storage": "1.3.0",
-    "@chatman-media/verticals": "1.1.0"
+    "@chatman-media/channel-core": "1.1.0",
+    "@chatman-media/channel-telegram": "1.1.0",
+    "@chatman-media/llm-router": "1.1.0",
+    "@chatman-media/kb": "1.3.0",
+    "@chatman-media/storage": "1.5.0",
+    "@chatman-media/verticals": "1.2.0"
   },
   "peerDependencies": {
     "drizzle-orm": ">=0.36.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.14",
+    "@biomejs/biome": "^2.4.16",
     "@types/bun": "1.3.14",
-    "drizzle-orm": "^0.36.0",
+    "drizzle-orm": "^0.45.2",
     "postgres": "^3.4.5",
     "typescript": "^6.0.3"
   },