team-chat 0.0.0-stage → 0.3.0

package/host/runner/config.js

@@ -0,0 +1,81 @@
+// Настройки раннера — из окружения процесса, и движки этой машины — из runner.json.
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const BRIDGE_MAIN = fileURLToPath(new URL('../bridge/main.js', import.meta.url));
+const WORKSPACE = path.join(os.homedir(), 'agent-workspace');
+
+export class ConfigError extends Error {}
+
+/**
+ * @param {NodeJS.ProcessEnv} env
+ * @param {object} overrides поля поверх окружения: тесты
+ */
+export function runnerConfig(env = process.env, overrides = {}) {
+  if (!env.CHAT_RUNNER_TOKEN) {
+    throw new ConfigError('нужен CHAT_RUNNER_TOKEN — токен участника host: '
+      + 'php artisan chat:participant host --kind=host --role=host');
+  }
+
+  return Object.freeze({
+    api: env.CHAT_API || 'http://localhost:8600/api',
+    token: env.CHAT_RUNNER_TOKEN,
+    machineFile: env.CHAT_RUNNER_CONFIG || path.join(WORKSPACE, 'runner.json'),
+    logsDir: env.CHAT_RUNNER_LOGS || path.join(WORKSPACE, 'logs'),
+    intervalMs: seconds(env, 'CHAT_RUNNER_INTERVAL', 15) * 1000,
+    // Кнопка «перезапустить мосты»: сервер кладёт файл, раннер его забирает. Под systemd
+    // то же делает qbazar-bridge-restart.path; у пакета systemd нет — следит сам.
+    restartFile: env.CHAT_RESTART_FILE || '',
+    // Записи запусков мостов (тот же каталог, что у моста) и сколько дней хранить их сырьё —
+    // задание и ход работы. Карточка опыта остаётся навсегда. 0 — хранить всё.
+    runsDir: env.CHAT_RUNS_DIR || path.join(WORKSPACE, 'runs'),
+    keepRunsDays: days(env, 'CHAT_KEEP_RUNS_DAYS', 30),
+    // Мост, упавший быстрее flapMs, — не случайность: следующий запуск не раньше backoffMs.
+    flapMs: 30_000,
+    backoffMs: 60_000,
+    bridgeCommand: [process.execPath, BRIDGE_MAIN, '--watch'],
+    // Окружение, от которого мосты наследуют своё: PATH, HOME, CHAT_STATE_DIR…
+    env,
+    ...overrides,
+  });
+}
+
+/**
+ * Движки ЭТОЙ машины. Сервер называет агенту только движок, а команду движка знает
+ * только этот файл — иначе запись в базе чата стала бы удалённым запуском команд
+ * на машине. Перечитывается на каждом проходе: поправил — подхватилось.
+ *
+ *   {"runtimes": {"claude": {"cmd": "…", "cwd": "~/…", "env": {"PATH": "…"}}},
+ *    "trigger_roles": "any"}
+ *
+ * @returns {{runtimes: Record<string, {cmd: string, cwd?: string, env?: Record<string, string>}>, triggerRoles: string}}
+ */
+export function loadMachine(file) {
+  const data = JSON.parse(fs.readFileSync(file, 'utf8'));
+  return { runtimes: data.runtimes ?? {}, triggerRoles: data.trigger_roles ?? 'any' };
+}
+
+/** ~ в начале пути — домашний каталог, как в оболочке. */
+export function expandHome(value) {
+  const text = String(value);
+  return text === '~' || text.startsWith('~/') ? os.homedir() + text.slice(1) : text;
+}
+
+function days(env, name, fallback) {
+  const raw = env[name];
+  if (raw === undefined || raw === '') return fallback;
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value < 0) throw new ConfigError(`${name}=${raw} — нужно целое число дней (0 — хранить всё)`);
+  return value;
+}
+
+function seconds(env, name, fallback) {
+  const raw = env[name];
+  if (raw === undefined || raw === '') return fallback;
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value < 1) throw new ConfigError(`${name}=${raw} — нужно целое число секунд`);
+  return value;
+}

package/host/runner/main.js

@@ -0,0 +1,69 @@
+// Точка входа раннера.
+//
+//   CHAT_RUNNER_TOKEN=… node host/runner/main.js
+//
+// Движки машины — в runner.json (CHAT_RUNNER_CONFIG, по умолчанию ~/agent-workspace/runner.json,
+// образец — deploy/systemd/runner.json.example). Остальное — переменные CHAT_* (см. config.js).
+
+import fs from 'node:fs';
+import { ChatUnavailableError } from '../lib/chat-api.js';
+import { log } from '../lib/log.js';
+import { ConfigError, runnerConfig } from './config.js';
+import { RunRetention } from './retention.js';
+import { createRunner, takeRestartRequest } from './runner.js';
+
+let config;
+try {
+  config = runnerConfig();
+} catch (e) {
+  if (!(e instanceof ConfigError)) throw e;
+  exit(e.message);
+}
+if (!fs.existsSync(config.machineFile)) {
+  exit(`нет ${config.machineFile} — опиши движки этой машины (образец: deploy/systemd/runner.json.example)`);
+}
+
+const runner = createRunner(config, { log });
+const retention = new RunRetention({ dir: config.runsDir, keepDays: config.keepRunsDays, log });
+
+let stopping = false;
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, async () => {
+    if (stopping) return;
+    stopping = true;
+    log('остановка: гашу мосты');
+    await runner.stopAll();
+    process.exit(0);
+  });
+}
+
+log(`раннер: проверка агентов раз в ${config.intervalMs / 1000} с, движки — ${config.machineFile}`);
+while (!stopping) {
+  retention.tick();
+  try {
+    await runner.reconcile();
+  } catch (e) {
+    // Раннер не должен умирать из-за одного плохого прохода.
+    log(e instanceof ChatUnavailableError
+      ? `${e.message} — повтор через ${config.intervalMs / 1000} с`
+      : `ошибка прохода: ${e.stack}`);
+  }
+  await untilNextPass();
+}
+
+/** Ждём следующего прохода, но на кнопку перезапуска отвечаем за секунду. */
+async function untilNextPass() {
+  for (let waited = 0; waited < config.intervalMs && !stopping; waited += 1000) {
+    if (takeRestartRequest(config.restartFile)) {
+      log('перезапуск по запросу из чата: гашу мосты, следующий проход поднимет заново');
+      await runner.stopAll();
+      return;
+    }
+    await new Promise(resolve => setTimeout(resolve, 1000));
+  }
+}
+
+function exit(message) {
+  console.error(message);
+  process.exit(1);
+}

package/host/runner/retention.js

@@ -0,0 +1,40 @@
+// Срок хранения сырья записей запусков (docs/plan-2026-10-24-knowledge.md, K5). Раннер один
+// на машину и живёт постоянно — ему и чистить: раз в сутки, первый раз — сразу при старте.
+
+import { pruneRuns } from '../bridge/run-archive.js';
+
+const DAY_MS = 86_400_000;
+
+export class RunRetention {
+  #dir;
+  #keepDays;
+  #log;
+  #now;
+  #last = -Infinity;
+
+  /**
+   * @param {object} p
+   * @param {string} p.dir корень записей
+   * @param {number} p.keepDays сколько дней хранить сырьё; 0 — хранить всё
+   * @param {(...parts: any[]) => void} p.log
+   * @param {() => number} [p.now] часы, мс
+   */
+  constructor({ dir, keepDays, log, now = Date.now }) {
+    this.#dir = dir;
+    this.#keepDays = keepDays;
+    this.#log = log;
+    this.#now = now;
+  }
+
+  /** Почистить, если с прошлого раза прошли сутки. Сбой чистки раннер не роняет. */
+  tick() {
+    if (this.#keepDays === 0 || this.#now() - this.#last < DAY_MS) return;
+    this.#last = this.#now();
+    try {
+      const pruned = pruneRuns(this.#dir, { keepDays: this.#keepDays, now: new Date(this.#now()) });
+      if (pruned) this.#log(`записи запусков старше ${this.#keepDays} дн.: сырьё удалено у ${pruned}, карточки опыта на месте`);
+    } catch (e) {
+      this.#log(`чистка записей запусков не удалась: ${e.message}`);
+    }
+  }
+}

package/host/runner/runner.js

@@ -0,0 +1,161 @@
+// Раннер: один процесс на машине, который держит мост для КАЖДОГО агента этой машины.
+//
+// Агентов заводит владелец в интерфейсе. Раннер раз в проход спрашивает сервер, кто
+// есть, и приводит мосты в соответствие: новому агенту — мост, отключённому или
+// удалённому — остановка, упавший мост — перезапуск.
+//
+// КАК запускать агента, сервер не говорит: он называет только движок, а команда движка
+// лежит в runner.json этой машины.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { ChatApi } from '../lib/chat-api.js';
+import { BridgeProcess } from './bridge-process.js';
+import { expandHome, loadMachine } from './config.js';
+
+export class Runner {
+  /** @type {Map<string, BridgeProcess>} handle → мост */
+  #bridges = new Map();
+  #config;
+  #api;
+  #log;
+  #now;
+  #tokens = new Map();     // handle → токен агента, выданный раннеру: живёт, пока жив раннер
+  #notBefore = new Map();  // handle → когда можно снова запускать упавший мост
+  #warned = new Set();     // о каких агентах с неизвестным движком уже сказали
+
+  /**
+   * @param {object} deps
+   * @param {ReturnType<import('./config.js').runnerConfig>} deps.config
+   * @param {ChatApi} deps.api
+   * @param {(...parts: any[]) => void} deps.log
+   * @param {() => number} [deps.now] часы, мс
+   */
+  constructor({ config, api, log, now = Date.now }) {
+    this.#config = config;
+    this.#api = api;
+    this.#log = log;
+    this.#now = now;
+  }
+
+  /** Работающие мосты: handle → мост. Копия — менять состав может только сам раннер. */
+  get bridges() {
+    return new Map(this.#bridges);
+  }
+
+  /** Один проход: привести мосты в соответствие с агентами на сервере. */
+  async reconcile() {
+    const machine = loadMachine(this.#config.machineFile);
+    const wanted = await this.#wantedAgents(machine.runtimes);
+
+    for (const [handle, bridge] of this.#bridges) {
+      const agent = wanted.get(handle);
+      if (!agent || agent.runtime !== bridge.runtime) {
+        this.#log(`@${handle}: ${agent ? 'сменился движок' : 'агент отключён или удалён'} — мост останавливается`);
+        await bridge.stop();
+        this.#bridges.delete(handle);
+      } else if (!bridge.alive()) {
+        this.#forgetCrashed(bridge);
+      }
+    }
+
+    for (const [handle, agent] of wanted) {
+      if (this.#bridges.has(handle) || this.#now() < (this.#notBefore.get(handle) ?? 0)) continue;
+      try {
+        await this.#spawn(agent, machine.runtimes[agent.runtime], machine.triggerRoles);
+      } catch (e) {
+        this.#log(`@${handle}: мост не запустился: ${e.message}`);
+        this.#notBefore.set(handle, this.#now() + this.#config.backoffMs);
+      }
+    }
+  }
+
+  async stopAll() {
+    await Promise.all([...this.#bridges.values()].map(bridge => bridge.stop()));
+    this.#bridges.clear();
+  }
+
+  /** Агенты сервера, которых эта машина умеет запускать. О прочих — одно предупреждение. */
+  async #wantedAgents(runtimes) {
+    const agents = await this.#api.runnerAgents(Object.keys(runtimes).sort());
+    const wanted = new Map();
+    for (const agent of agents) {
+      if (agent.runtime in runtimes) {
+        wanted.set(agent.handle, agent);
+      } else if (!this.#warned.has(agent.handle)) {
+        this.#warned.add(agent.handle);
+        this.#log(`@${agent.handle}: движка «${agent.runtime}» на этой машине нет — `
+          + `добавь его в ${this.#config.machineFile} или смени агенту движок`);
+      }
+    }
+    return wanted;
+  }
+
+  /** Упавший мост убираем; упавший сразу после запуска — ещё и не поднимаем по кругу. */
+  #forgetCrashed(bridge) {
+    const { handle, exitCode } = bridge;
+    if (this.#now() - bridge.startedAt < this.#config.flapMs) {
+      this.#notBefore.set(handle, this.#now() + this.#config.backoffMs);
+      this.#log(`@${handle}: мост упал сразу после запуска (код ${exitCode}) — `
+        + `повтор через ${this.#config.backoffMs / 1000} с, см. ${this.#logFile(handle)}`);
+    } else {
+      this.#log(`@${handle}: мост завершился (код ${exitCode}) — перезапуск`);
+    }
+    this.#bridges.delete(handle);
+  }
+
+  async #spawn(agent, runtime, triggerRoles) {
+    const { handle } = agent;
+    if (!this.#tokens.has(handle)) this.#tokens.set(handle, await this.#api.agentToken(handle));
+
+    fs.mkdirSync(this.#config.logsDir, { recursive: true });
+    const bridge = new BridgeProcess({
+      handle,
+      runtime: agent.runtime,
+      command: this.#config.bridgeCommand,
+      env: this.#bridgeEnv(agent, runtime, triggerRoles),
+      logFile: this.#logFile(handle),
+      startedAt: this.#now(),
+    });
+    this.#bridges.set(handle, bridge);
+    this.#log(`@${handle}: мост запущен (движок ${agent.runtime}, pid ${bridge.pid})`);
+  }
+
+  #bridgeEnv(agent, runtime, triggerRoles) {
+    const env = {
+      ...this.#config.env,
+      ...Object.fromEntries(Object.entries(runtime.env ?? {}).map(([k, v]) => [k, expandHome(v)])),
+      CHAT_API: this.#config.api,
+      CHAT_TOKEN: this.#tokens.get(agent.handle),
+      CHAT_HANDLE: agent.handle,
+      CHAT_RUNTIME: agent.runtime,
+      CHAT_AGENT_CMD: runtime.cmd,
+      CHAT_AGENT_CWD: runtime.cwd ? expandHome(runtime.cwd) : '',
+      CHAT_TRIGGER_ROLES: triggerRoles,
+      CHAT_DISTILL_CMD: runtime.distill?.cmd ?? '',
+    };
+    delete env.CHAT_RUNNER_TOKEN; // агенту токен раннера ни к чему
+    return env;
+  }
+
+  #logFile(handle) {
+    return path.join(this.#config.logsDir, `bridge-${handle}.log`);
+  }
+}
+
+/** Раннер в сборе — из настроек. */
+export function createRunner(config, { log }) {
+  return new Runner({ config, api: new ChatApi({ url: config.api, token: config.token, timeoutMs: 15_000 }), log });
+}
+
+/** Забрать запрос на перезапуск: файл удаляется — так страница узнаёт, что он принят. */
+export function takeRestartRequest(file) {
+  if (!file) return false;
+  try {
+    fs.unlinkSync(file);
+    return true;
+  } catch (e) {
+    if (e.code === 'ENOENT') return false;
+    throw e;
+  }
+}

package/package.json

@@ -1,6 +1,68 @@
 {
-  "name": "team-chat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "team-chat",
+    "version": "0.3.0",
+    "description": "Командный чат владельца и ИИ-агентов (claude, codex): тред, журнал решений, документы — по проекту на чат",
+    "license": "MIT",
+    "author": "j4vlon <fedot.pushkin98@gmail.com>",
+    "keywords": [
+        "chat",
+        "ai-agents",
+        "claude",
+        "codex",
+        "mcp",
+        "decision-log",
+        "cli"
+    ],
+    "type": "module",
+    "bin": {
+        "team-chat": "cli/team-chat.js"
+    },
+    "engines": {
+        "node": ">=20.19"
+    },
+    "files": [
+        "cli/",
+        "agents/",
+        "bin/bridge",
+        "bin/runner",
+        "host/lib/",
+        "host/bridge/",
+        "host/runner/",
+        "host/knowledge/",
+        "server/package.json",
+        "server/dist/src/",
+        "server/drizzle/",
+        "server/views/"
+    ],
+    "scripts": {
+        "build": "tsc -p server",
+        "db:generate": "cd server && drizzle-kit generate",
+        "check:pack": "node scripts/check-pack.js",
+        "test": "npm run test:host && npm run test:server",
+        "test:host": "node --test host/test/*.test.js",
+        "test:server": "tsc -p server && node --test --test-concurrency=1 server/dist/test/*.test.js"
+    },
+    "dependencies": {
+        "@electric-sql/pglite": "0.5.8",
+        "@modelcontextprotocol/sdk": "1.32.1",
+        "@nestjs/common": "11.2.7",
+        "@nestjs/core": "11.2.7",
+        "@nestjs/platform-express": "11.2.7",
+        "drizzle-orm": "0.45.4",
+        "express": "5.3.0",
+        "multer": "2.4.0",
+        "pg": "8.23.1",
+        "reflect-metadata": "0.2.2",
+        "rxjs": "7.8.2",
+        "zod": "4.6.5"
+    },
+    "devDependencies": {
+        "@nestjs/testing": "11.2.7",
+        "@types/express": "5.0.6",
+        "@types/multer": "2.3.0",
+        "@types/node": "20.19.43",
+        "@types/pg": "8.23.1",
+        "drizzle-kit": "0.31.11",
+        "typescript": "5.9.3"
+    }
+}

package/server/dist/src/app.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = createApp;
+require("reflect-metadata");
+const core_1 = require("@nestjs/core");
+const express_1 = require("express");
+const app_module_1 = require("./app.module");
+/**
+ * Приложение в сборе — без порта: его слушает main.ts, а тесты — случайный свободный.
+ * База приходит открытой и смигрированной; закрывает её приложение при остановке.
+ */
+async function createApp({ config, database, logger = ['error', 'warn'] }) {
+    const app = await core_1.NestFactory.create(app_module_1.AppModule.forRoot({ config, database }), {
+        logger,
+        // Тело запроса разбираем сами — с пределом под самый большой документ (500 000 знаков).
+        bodyParser: false,
+    });
+    app.disable('x-powered-by');
+    // Дамп при восстановлении — вся история чата; ему предел больше, остальным хватает 2 МБ.
+    app.use('/api/local/restore', (0, express_1.json)({ limit: '256mb' }));
+    app.useBodyParser('json', { limit: '2mb' });
+    app.useBodyParser('urlencoded', { limit: '2mb', extended: true });
+    app.enableShutdownHooks();
+    return app;
+}

package/server/dist/src/app.module.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ConfigModule_1, AppModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("./config/config");
+const database_module_1 = require("./db/database.module");
+const conversation_module_1 = require("./conversation.module");
+const collector_module_1 = require("./collector/collector.module");
+const health_controller_1 = require("./health/health.controller");
+const knowledge_module_1 = require("./knowledge/knowledge.module");
+const local_module_1 = require("./local/local.module");
+const mcp_module_1 = require("./mcp/mcp.module");
+const participants_module_1 = require("./participants/participants.module");
+const sharing_module_1 = require("./sharing/sharing.module");
+const team_module_1 = require("./team/team.module");
+const web_module_1 = require("./web/web.module");
+/** Настройки — всем модулям, как и база. */
+let ConfigModule = ConfigModule_1 = class ConfigModule {
+    static forRoot(config) {
+        return {
+            module: ConfigModule_1,
+            providers: [{ provide: config_1.SERVER_CONFIG, useValue: config }],
+            exports: [config_1.SERVER_CONFIG],
+        };
+    }
+};
+ConfigModule = ConfigModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], ConfigModule);
+let AppModule = AppModule_1 = class AppModule {
+    static forRoot({ config, database }) {
+        return {
+            module: AppModule_1,
+            imports: [ConfigModule.forRoot(config), database_module_1.DatabaseModule.forRoot(database), participants_module_1.ParticipantsModule, conversation_module_1.ConversationModule, knowledge_module_1.KnowledgeModule, sharing_module_1.SharingModule, collector_module_1.CollectorModule, team_module_1.TeamModule, mcp_module_1.McpModule, web_module_1.WebModule, local_module_1.LocalModule],
+            controllers: [health_controller_1.HealthController],
+        };
+    }
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = AppModule_1 = __decorate([
+    (0, common_1.Module)({})
+], AppModule);

package/server/dist/src/attachments/attachment-store.js

@@ -0,0 +1,111 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentStore = exports.isText = exports.isImage = exports.MAX_BYTES = exports.MAX_FILES = void 0;
+const common_1 = require("@nestjs/common");
+const drizzle_orm_1 = require("drizzle-orm");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const config_1 = require("../config/config");
+const database_module_1 = require("../db/database.module");
+const schema_1 = require("../db/schema");
+const mime_1 = require("./mime");
+/** Пределы — как были у PHP-сервера: до 10 файлов по 20 МБ на сообщение. */
+exports.MAX_FILES = 10;
+exports.MAX_BYTES = 20 * 1024 * 1024;
+/** Текст, который агент читает как есть, без скачивания. */
+const TEXT_LIMIT = 200 * 1024;
+const TEXT_TYPES = new Set(['application/json', 'application/xml', 'application/x-yaml']);
+/**
+ * Картинки, которые можно показать прямо в браузере и отдать агенту изображением.
+ * SVG нарочно нет: это документ со скриптами, открытый на нашем домене он получил бы
+ * токен владельца со страницы.
+ */
+const IMAGES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
+const isImage = (a) => IMAGES.has(a.mime);
+exports.isImage = isImage;
+const isText = (a) => a.size <= TEXT_LIMIT && (a.mime.startsWith('text/') || TEXT_TYPES.has(a.mime));
+exports.isText = isText;
+/**
+ * Файлы сообщений — в каталоге данных: <данные>/files/attachments/<сообщение>/<случайное имя>.
+ * Раскладка та же, что у PHP-сервера (storage/app/private/attachments/…): при переносе
+ * файлы просто копируются, пути в базе остаются верными.
+ */
+let AttachmentStore = class AttachmentStore {
+    db;
+    root;
+    constructor(db, config) {
+        this.db = db;
+        this.root = node_path_1.default.join(config.dataDir, 'files');
+    }
+    /** Каталог для приёма файлов: на той же файловой системе, что хранилище, — перенос без копирования. */
+    get incoming() {
+        const dir = node_path_1.default.join(this.root, 'incoming');
+        node_fs_1.default.mkdirSync(dir, { recursive: true, mode: 0o700 });
+        return dir;
+    }
+    /**
+     * Сохранить файлы сообщения — в транзакции его публикации. Возвращает пути сохранённых
+     * файлов: откатится транзакция — их надо убрать (remove), иначе останутся сиротами.
+     */
+    async save(tx, messageId, uploads, stored) {
+        for (const upload of uploads) {
+            const relative = node_path_1.default.join('attachments', String(messageId), node_crypto_1.default.randomBytes(20).toString('hex') + extension(upload.name));
+            const target = this.absolute(relative);
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(target), { recursive: true, mode: 0o700 });
+            const mime = (0, mime_1.sniffMime)(upload.path);
+            node_fs_1.default.renameSync(upload.path, target);
+            stored.push(relative);
+            await tx.insert(schema_1.attachments).values({
+                messageId,
+                name: [...(upload.name || 'file')].slice(0, 255).join(''),
+                mime,
+                size: upload.size,
+                path: relative,
+            });
+        }
+    }
+    remove(relativePaths) {
+        for (const relative of relativePaths)
+            node_fs_1.default.rmSync(this.absolute(relative), { force: true });
+    }
+    async find(id) {
+        const [row] = await this.db.select().from(schema_1.attachments).where((0, drizzle_orm_1.eq)(schema_1.attachments.id, id));
+        return row ?? null;
+    }
+    absolute(a) {
+        const relative = typeof a === 'string' ? a : a.path;
+        const full = node_path_1.default.resolve(this.root, relative);
+        // Путь из базы — не повод выйти за пределы хранилища.
+        if (!full.startsWith(this.root + node_path_1.default.sep))
+            throw new Error(`путь вложения вне хранилища: ${relative}`);
+        return full;
+    }
+};
+exports.AttachmentStore = AttachmentStore;
+exports.AttachmentStore = AttachmentStore = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(database_module_1.DATABASE)),
+    __param(1, (0, common_1.Inject)(config_1.SERVER_CONFIG)),
+    __metadata("design:paramtypes", [Object, Object])
+], AttachmentStore);
+/** Расширение из имени автора — только безопасное: латиница и цифры. */
+function extension(name) {
+    const ext = node_path_1.default.extname(name).toLowerCase();
+    return /^\.[a-z0-9]{1,10}$/.test(ext) ? ext : '';
+}