@coopenomics/factory 2026.2.22-2 → 2026.3.4-2

package/README.md

@@ -1,77 +1,127 @@
-# Кооперативный генератор документов
-
-[![npm version][npm-version-src]][npm-version-href]
-[![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![bundle][bundle-src]][bundle-href]
-[![JSDocs][jsdocs-src]][jsdocs-href]
-[![License][license-src]][license-href]
-
-## Обзор
-Данная библиотека предназначена для кооперативов, которые используют блокчейн EOSIO для хранения шаблонов документов и реализуют систему цифровой подписи на основе EOSIO. Шаблоны документов и соответствующие переводы хранятся в блокчейне, в то время как приватные данные для заполнения шаблонов находятся в закрытом хранилище кооператива. Библиотека позволяет генерировать документы, автоматически заполняя их данными из хранилища и подписывая при помощи приватного ключа.
-
-## Функциональность
-Библиотека предоставляет следующие основные возможности:
-
-- Генерация метаданных для документов на основе предопределенных шаблонов.
-- Конструирование данных для документов, используя JSON Schema, загружаемую из блокчейна.
-- Получение шаблонов документов и переводов из блокчейна.
-- Рендеринг документов для создания цифровой версии в формате doc и gdoc.
-- Подпись сгенерированных документов с использованием приватных ключей EOSIO.
-
-## Процесс генерации документов
-Получение шаблона и схемы из блокчейна: Шаблоны и схемы загружаются из блокчейна. Шаблоны включают в себя как структуру самого документа, так и переводы элементов документа на разные языки.
-
-Конструирование данных: Фабрика шаблонов использует JSON Schema для определения структуры данных, необходимых для каждого шаблона. Приватные данные загружаются из хранилища кооператива и используются для заполнения шаблонов.
-
-Рендеринг шаблона: Используя загруженные данные и шаблон, библиотека рендерит окончательный документ. Этот этап включает подстановку реальных данных пользователя и кооператива в шаблон.
-
-Подпись документа: Сгенерированный документ подписывается с использованием приватного ключа EOSIO.
-
-Верификация документа: При необходимости, сгенерированные и подписанные документы могут быть верифицированы для подтверждения их подлинности.
-
-## Подготовка к использованию
-Для начала работы с библиотекой необходимо ознакомиться с требованиями окружения:
-- Ваше приложение должно взаимодействовать с блокчейном EOSIO для получения шаблонов и схем.
-- У кооператива должно быть настроено приватное хранилище для доступа к личным данным.
-- Необходим модуль для работы с JSON Schema, например, json-schema для Node.js.
-- Вам потребуется EOSJS для подписи документов.
-
-## Пример использования
-Пример реализации фабрики для генерации документа типа joincoop из файла documents/joincoop.ts:
-
-``` javascript
-const joinCoopFactory = new JoinCoopTemplateFactory()
-joinCoopFactory.getComplexTemplate()
-  .then((template) => {
-    const options = {
-      username: 'user1',
-      lang: 'en',
-      action: 'joincoop'
-    }
-
-    const generator = new GeneratorJSImpl()
-    return generator.generate(options)
-  })
-  .then((document) => {
-    // Работа с сгенерированным и подписанным документом
-  })
-  .catch((error) => {
-    console.log(error)
-    // Обработка ошибок
-  })
+# 📄 @coopenomics/factory
+
+Фабрика документов кооператива — библиотека для генерации юридически значимых документов (PDF). Объединяет шаблоны из блокчейна, приватные данные из хранилища и рендерит HTML через Handlebars/Nunjucks с последующей генерацией PDF через WeasyPrint.
+
+## Основные возможности
+
+- Более 60 шаблонов юридических документов (заявления, протоколы, решения, договоры, акты)
+- Рендеринг HTML из шаблонов Handlebars и Nunjucks
+- Генерация PDF через WeasyPrint
+- Валидация данных по JSON Schema
+- Электронная подпись документов через EOSIO-ключи
+- Хранение документов и метаданных в MongoDB
+- Сборка как ES-модуль и CommonJS (unbuild)
+
+## Установка
+
+Компонент является частью монорепозитория. Установка зависимостей из корня проекта:
+
+```bash
+pnpm install
 ```
 
-## Расширение и модификация
-Библиотека построена с учетом возможности расширения и модификации. Для добавления новых типов документов реализуйте свои фабрики, соответствующие интерфейсу IDocumentTemplateFactory, и регистрируйте их в главном классе библиотеки.
+Или только для этого компонента:
 
-## Поддержка и вклад
-Если у вас есть вопросы, предложения или вы хотите внести вклад в проект, пожалуйста, свяжитесь с технической поддержкой или откройте issue в системе управления проектами.
+```bash
+pnpm install --filter @coopenomics/factory
+```
 
-## Таблица документов
-Здесь соберём таблицу имен и шаблонов типизированных документов.
+### Системные зависимости
 
-## Лицензия
+Для генерации PDF необходим [WeasyPrint](https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#installation).
+
+## Скрипты
+
+| Скрипт | Команда | Описание |
+|--------|---------|----------|
+| `build` | `pnpm run build` | Сборка библиотеки (unbuild) |
+| `dev` | `pnpm run dev` | Режим разработки с автопересборкой (nodemon) |
+| `test` | `pnpm run test` | Запуск тестов (Vitest) |
+| `lint` | `pnpm run lint` | Проверка кода (ESLint) |
+| `typecheck` | `pnpm run typecheck` | Проверка типов TypeScript |
+| `setup-indexes` | `pnpm run setup-indexes` | Настройка индексов MongoDB |
+
+Из корня монорепозитория:
+
+```bash
+pnpm run build:lib       # Сборка factory + cooptypes
+pnpm run dev:lib         # Режим разработки factory + cooptypes
+pnpm run test:component  # Компонентные тесты factory
+```
+
+## Конфигурация
+
+Для тестирования и локальной работы необходимо подключение к MongoDB. Переменные окружения:
+
+- `MONGO_URI` — строка подключения к MongoDB
+- `SOURCE` — источник данных (`local` для тестов)
 
-[MIT](./LICENSE) License © 2024-PRESENT [Alex Ant](https://github.com/dacom-dark-sun)
+Подробное описание переменных — в файле `.env-example`.
+
+## Тестирование
+
+```bash
+SOURCE=local NODE_ENV=test pnpm --filter @coopenomics/factory run test
+```
+
+Тестовый набор покрывает генерацию документов различных типов. Тесты требуют запущенный MongoDB и используют таймаут 240 секунд.
+
+Файлы тестов:
+
+| Файл | Описание |
+|------|----------|
+| `test/index.test.ts` | Основные тесты генерации документов |
+| `test/wallet.test.ts` | Тесты документов кошелька |
+| `test/meet.test.ts` | Тесты документов собраний |
+| `test/blagorost.test.ts` | Тесты документов программы «Благорост» |
+| `test/market.test.ts` | Тесты документов маркетплейса |
+| `test/search.test.ts` | Тесты поиска документов |
+| `test/udata.test.ts` | Тесты пользовательских данных |
+| `test/documents-1000-plus.test.ts` | Тесты документов с registry_id > 1000 |
+
+## Архитектура
+
+```
+src/
+├── index.ts               # Точка входа библиотеки
+├── config.ts              # Конфигурация подключений
+├── Actions/               # Генераторы документов (по registry_id)
+│   ├── 1.WalletAgreement.ts
+│   ├── 100.ParticipantApplication.ts
+│   ├── 300.AnnualGeneralMeetingAgenda.ts
+│   ├── 600.FreeDecision.ts
+│   ├── 1001.GenerationContract.ts
+│   └── ...                # Более 60 шаблонов
+├── Factory/               # Ядро фабрики документов
+├── Models/                # Модели данных MongoDB
+│   ├── Cooperative.ts
+│   ├── Individual.ts
+│   ├── Organization.ts
+│   ├── Document.ts
+│   └── ...
+└── templates/             # HTML-шаблоны (Nunjucks/Handlebars)
+test/                      # Тесты (Vitest)
+```
+
+### Процесс генерации документа
+
+1. Загрузка шаблона и JSON Schema из блокчейна
+2. Получение приватных данных из хранилища (MongoDB)
+3. Валидация данных по JSON Schema (Ajv)
+4. Конструирование контекста для шаблона
+5. Рендеринг HTML из Nunjucks/Handlebars-шаблона
+6. Подпись хеша документа EOSIO-ключом
+7. Генерация PDF через WeasyPrint
+
+## Ключевые зависимости
+
+- **nunjucks / handlebars** — шаблонизаторы
+- **ajv** — валидация JSON Schema
+- **mongodb** — хранилище данных
+- **eosjs-ecc** — криптографические операции EOSIO
+- **pdf-lib** — работа с PDF
+- **unbuild** — сборка библиотеки
+
+## Лицензия
 
-Версия документации: 1.0.0
+[BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.ru)

package/dist/index.cjs

@@ -4,8 +4,8 @@ const Ajv = require('ajv');
 const addFormats = require('ajv-formats');
 const localize_ru = require('ajv-i18n/localize/ru');
 const cooptypes = require('cooptypes');
-const dotenv = require('dotenv');
 const mongodb = require('mongodb');
+const dotenv = require('dotenv');
 const moment = require('moment-timezone');
 const fs = require('node:fs');
 const path = require('node:path');
@@ -3347,13 +3347,140 @@ const meetTableMock = {
   match: (_url, _params) => false
 };
 
+let mongoClient$2 = null;
+let deltasCollection$1 = null;
+async function getMongoConnection$2() {
+  if (!mongoClient$2) {
+    const uri = process.env.MONGO_URI || `mongodb://${process.env.MONGO_HOST || "127.0.0.1"}:27017/cooperative-x`;
+    mongoClient$2 = new mongodb.MongoClient(uri);
+    await mongoClient$2.connect();
+    deltasCollection$1 = mongoClient$2.db().collection("deltas");
+  }
+  return deltasCollection$1;
+}
+const draftTableMock = {
+  code: "draft",
+  table: "drafts",
+  data: null,
+  match(url, params) {
+    if (!url.includes("/get-tables") || !params)
+      return false;
+    const filter = params.get("filter");
+    if (!filter)
+      return false;
+    try {
+      const obj = JSON.parse(filter);
+      return obj.code === "draft" && obj.table === "drafts";
+    } catch {
+      return false;
+    }
+  },
+  async resolve(url, params) {
+    const filter = params ? JSON.parse(params.get("filter") || "{}") : {};
+    const deltas = await getMongoConnection$2();
+    const query = { code: "draft", table: "drafts" };
+    if (filter["value.registry_id"])
+      query["value.registry_id"] = filter["value.registry_id"];
+    const results = await deltas.find(query).sort({ block_num: -1 }).toArray();
+    return { results };
+  }
+};
+const draftTranslationsMock = {
+  code: "draft",
+  table: "translations",
+  data: null,
+  match(url, params) {
+    if (!url.includes("/get-tables") || !params)
+      return false;
+    const filter = params.get("filter");
+    if (!filter)
+      return false;
+    try {
+      const obj = JSON.parse(filter);
+      return obj.code === "draft" && obj.table === "translations";
+    } catch {
+      return false;
+    }
+  },
+  async resolve(url, params) {
+    const filter = params ? JSON.parse(params.get("filter") || "{}") : {};
+    const deltas = await getMongoConnection$2();
+    let draftId = filter["value.draft_id"];
+    if (draftId) {
+      const draft = await deltas.findOne({
+        code: "draft",
+        table: "drafts",
+        "value.registry_id": draftId
+      });
+      if (draft?.value?.id) {
+        draftId = String(draft.value.id);
+      }
+    }
+    const query = { code: "draft", table: "translations" };
+    if (draftId)
+      query["value.draft_id"] = draftId;
+    const results = await deltas.find(query).sort({ block_num: -1 }).toArray();
+    return { results };
+  }
+};
+
+let mongoClient$1 = null;
+let deltasCollection = null;
+async function getMongoConnection$1() {
+  if (!mongoClient$1) {
+    const uri = process.env.MONGO_URI || `mongodb://${process.env.MONGO_HOST || "127.0.0.1"}:27017/cooperative-x`;
+    mongoClient$1 = new mongodb.MongoClient(uri);
+    await mongoClient$1.connect();
+    deltasCollection = mongoClient$1.db().collection("deltas");
+  }
+  return deltasCollection;
+}
+const cooperativeTableMock = {
+  match(url, params) {
+    if (!url.includes("/get-tables") || !params)
+      return false;
+    const filter = params.get("filter");
+    if (!filter)
+      return false;
+    try {
+      const obj = JSON.parse(filter);
+      return obj.code === "registrator" && obj.table === "coops" || obj.code === "soviet" && obj.table === "boards" || obj.code === "soviet" && obj.table === "decisions" || obj.code === "soviet" && obj.table === "participants";
+    } catch {
+      return false;
+    }
+  },
+  async resolve(url, params) {
+    const filter = params ? JSON.parse(params.get("filter") || "{}") : {};
+    const deltas = await getMongoConnection$1();
+    const query = {};
+    if (filter.code)
+      query.code = filter.code;
+    if (filter.scope)
+      query.scope = filter.scope;
+    if (filter.table)
+      query.table = filter.table;
+    for (const key of Object.keys(filter)) {
+      if (key.startsWith("value."))
+        query[key] = filter[key];
+    }
+    const results = await deltas.find(query).sort({ block_num: -1 }).toArray();
+    return { results };
+  }
+};
+
 meetTableMock.match = function(url, params) {
   return matchMock(this, url, params);
 };
 meetQuestionsMock.match = function(url, params) {
   return matchMock(this, url, params);
 };
-const tablesMocks = [meetTableMock, meetQuestionsMock];
+const tablesMocks = [
+  draftTableMock,
+  draftTranslationsMock,
+  cooperativeTableMock,
+  meetTableMock,
+  meetQuestionsMock
+];
 
 const voteForAction = {
   _id: "6852b0389bd56240ad71b225",
@@ -3511,6 +3638,50 @@ const voteAgainstDecision9001Mock = {
   match: (_url, _params) => false
 };
 
+let mongoClient = null;
+let actionsCollection = null;
+async function getMongoConnection() {
+  if (!mongoClient) {
+    const uri = process.env.MONGO_URI || `mongodb://${process.env.MONGO_HOST || "127.0.0.1"}:27017/cooperative-x`;
+    mongoClient = new mongodb.MongoClient(uri);
+    await mongoClient.connect();
+    actionsCollection = mongoClient.db().collection("actions");
+  }
+  return actionsCollection;
+}
+const dbActionsMock = {
+  match(url, params) {
+    if (!url.includes("/get-actions") || !params)
+      return false;
+    const filter = params.get("filter");
+    if (!filter)
+      return false;
+    try {
+      JSON.parse(filter);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  async resolve(url, params) {
+    const filter = params ? JSON.parse(params.get("filter") || "{}") : {};
+    const actions = await getMongoConnection();
+    const query = {};
+    if (filter.account)
+      query.account = filter.account;
+    if (filter.name)
+      query.name = filter.name;
+    if (filter.receiver)
+      query.receiver = filter.receiver;
+    for (const key of Object.keys(filter)) {
+      if (key.startsWith("data."))
+        query[key] = filter[key];
+    }
+    const results = await actions.find(query).sort({ block_num: -1 }).toArray();
+    return { results };
+  }
+};
+
 voteforActionMock.match = function(url, params) {
   return matchMock(this, url, params);
 };
@@ -3527,7 +3698,8 @@ const actionsMocks = [
   voteforActionMock,
   returnByMoneyDecisionActionMock,
   voteForDecision9001Mock,
-  voteAgainstDecision9001Mock
+  voteAgainstDecision9001Mock,
+  dbActionsMock
 ];
 
 const testMocks = [
@@ -3538,8 +3710,11 @@ const testMocks = [
 async function getFetch(url, params) {
   if (process.env.NODE_ENV === "test") {
     const mock = testMocks.find((m) => m.match(url, params));
-    if (mock)
+    if (mock) {
+      if (mock.resolve)
+        return await mock.resolve(url, params);
       return mock.data;
+    }
   }
   try {
     const response = await fetch(`${url}?${params?.toString()}`, {
@@ -3981,8 +4156,8 @@ class PDFService {
 
 const name = "@coopenomics/factory";
 const type = "module";
-const version = "2026.2.22-2";
-const description = "";
+const version = "2026.3.4-2";
+const description = "Фабрика юридических документов кооператива";
 const author = "Alex Ant <chairman.voskhod@gmail.com>";
 const license = "MIT";
 const homepage = "https://github.com/copenomics/@coopenomics/factory#readme";
@@ -4018,7 +4193,7 @@ const files = [
 const scripts = {
 	prebuild: "pnpm run typecheck",
 	build: "unbuild",
-	dev: "concurrently -n 'GENERATOR' -c 'bgGreen.black' \"nodemon --watch src --ext ts --exec 'unbuild'\"",
+	dev: "nodemon --watch src --ext ts --exec 'unbuild'",
 	lint: "eslint .",
 	prepublishOnly: "nr build",
 	release: "bumpp && npm publish",
@@ -4030,15 +4205,15 @@ const dependencies = {
 	ajv: "^8.13.0",
 	"ajv-formats": "^3.0.1",
 	"ajv-i18n": "^4.2.0",
-	axios: "^1.7.2",
-	cooptypes: "2026.2.22-2",
+	axios: "^1.13.5",
+	cooptypes: "2026.3.4-2",
 	dotenv: "^16.4.5",
 	"eosjs-ecc": "^4.0.7",
 	handlebars: "^4.7.8",
 	"inline-css": "^4.0.2",
 	"json-schema": "^0.4.0",
 	"moment-timezone": "^0.5.45",
-	mongodb: "^6.6.1",
+	mongodb: "^7.1.0",
 	nunjucks: "^3.2.4",
 	"pdf-lib": "^1.17.1",
 	uuid: "^11.0.0"
@@ -4054,6 +4229,7 @@ const devDependencies = {
 	concurrently: "^8.2.2",
 	eslint: "^8.57.0",
 	esno: "^4.7.0",
+	nodemon: "^3.1.4",
 	pnpm: "^8.15.8",
 	rimraf: "^5.0.7",
 	"simple-git-hooks": "^2.11.1",
@@ -4062,7 +4238,7 @@ const devDependencies = {
 	vite: "^5.2.11",
 	vitest: "^1.6.0"
 };
-const gitHead = "350af86b650d74a2e1f63e1e9f725a63cb89bbcf";
+const gitHead = "dc450899081b4d9c022e5a091b49f8ca7f8a1fbd";
 const packageJson = {
 	name: name,
 	type: type,