@haiiro/docuflow 0.0.18 → 0.0.19

package/manifest.json

@@ -49,7 +49,7 @@
     "defaultRoleUniversalIdentifier": "26b1dde8-4ed9-4f39-8516-e0dcb734ea5a",
     "aboutDescription": "# Документооборот (`@crm-nordiv/docuflow`)\n\nЗадания, процессы и документы компании в одном разделе. Ставится в CRM как приложение, без правок\nсервера.\n\n- universalIdentifier: `0b7d5d2e-8c4f-4a59-9a43-2f6f1c3e9d21`\n\n## Что получается после установки\n\n| Где | Что |\n|---|---|\n| Сайдбар | папка «Документооборот» с пунктами «Задания», «Процессы», «Документы» — у каждого своя страница |\n| «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные / Архив» (архив — удалённые, со штатным «Восстановить»), поиск, создание задания с инструкцией и полями для заполнения |\n| Панель задания | вкладки «Задание» (поля и ход) и «Чат», если стоит `@haiiro/chats`: переписка задачи с меню сообщения, как в «Чатах» |\n| Карточка задачи | вкладка «Задание»: инструкция, поля задания (собрать конструктором, заполнить), «Выполнить» |\n| Карточка процесса | кнопка «Параметры запуска» вверху (боковая панель): параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |\n| Редактор процесса | первый блок «Запуск с параметрами» (ставится сам): параметры, заполненные перед запуском, и запись, на которой запустили, — его переменные |\n| Командное меню | «Запустить процесс» (Cmd+K и меню выбранных записей любого объекта): выбор процесса, форма параметров в боковой панели, «Запустить»; запуск открывается в боковой панели, как штатный ручной |\n| «Процессы» | процессы раздела «Документооборот»; форма параметров до запуска, «Запустить», «Создать», «Добавить из Twenty» (процесс, настроенный в «Рабочих процессах»), «Убрать из документооборота», «Открыть редактор» |\n| «Документы» | папки, фильтры, поиск по названию и номеру, документ с реквизитами (тип, номер, дата, срок действия, контрагент, описание), файл в поле «Файл» карточки, карточка с источником |\n| Автоматически | шаг «Человеческий ввод» процесса становится задачей; её выполнение продолжает процесс; файл, приложенный к любой записи, копируется в документы с отметкой, кто, когда и куда его добавил |\n| Отдельная страница | `https://<адрес CRM>/s/docflow/app`: «Задания», «Процессы», «Документы» без остальной CRM, вход — тот же, что в CRM |\n| Битрикс24 | та же страница внутри приложения портала, вход через CRM в отдельном окне; уведомление исполнителю нового задания |\n\n## Данные\n\n| Объект | Поля |\n|---|---|\n| `smbDocument` (новый) | название, файл, тип, номер, дата, действует до, контрагент (компания), описание, статус, автор, ответственный, папка; источник: `origin`, `sourceObjectName`, `sourceRecordId`, `sourceRecordName`, `sourceFileId`, `workflowRunId` |\n| `smbDocumentFolder` (новый) | название, цвет, родительская папка |\n| `workflow` | `smbSection` «Раздел»: CRM / Документооборот; `smbLaunchFields` «Параметры запуска» — поля, которые заполняют перед запуском |\n| `task` | `smbSection`, `smbInstruction` «Инструкция»; `smbFormSchema`, `smbFormValues` — поля задания; `smbWorkflowRunId`, `smbWorkflowStepId`, `smbWorkflowThreadId` — связь с шагом процесса |\n| `company` | `smbDocuments` — документы контрагента |\n| роли | «Документооборот: функции приложения» (права функций), «Документооборот: участник процессов» (для людей, см. ниже) |\n\n## Установка\n\nС любого компьютера с Node.js 20+, нужен только адрес CRM и ключ API администратора\n(«Настройки → API и вебхуки → Создать ключ»). Повторный запуск ставит новую версию:\n\n```bash\nnpx -y @haiiro/docuflow install --url https://crm.example.ru --api-key <ключ>\n```\n\nУстановщик загружает в CRM опубликованный архив этой версии пакета и устанавливает приложение\n(как `twenty app:install`), доступ к серверу и его настройки не нужны. Конкретная версия:\n`--version 0.0.8`. Пакет собран под Twenty 2.45: на другой минорной версии установщик\nпредупреждает, на другой мажорной останавливается (`--force` — ставить всё равно). После установки\nон сверяет версию в CRM: CRM не ставит версию ниже уже загруженной и говорит об этом прямо.\n\nИз исходников (для разработки): `node scripts/reinstall.mjs docuflow --local` в корне репозитория\n(нужны `CRM_URL` и `CRM_API_KEY` в `.env`).\n\nЗатем в «Настройки → Приложения → Документооборот» заполнить переменные:\n\n| Переменная | Что указать |\n|---|---|\n| `DOCFLOW_ENGINE` | `APP` |\n| `CRM_PUBLIC_URL` | адрес CRM компании, например `https://acme.example.ru`; по нему строятся ссылки в CRM с отдельной страницы и из Битрикс24 |\n| `BITRIX_CLIENT_ID`, `BITRIX_CLIENT_SECRET` | из карточки локального приложения портала; без них Битрикс24 не подключается, остальное работает |\n\n**Права людей.** Отвечать на шаг запущенного процесса может только тот, у кого есть право\n«Рабочие процессы». Кто выполняет задания процессов или запускает процессы с параметрами,\nполучает роль «Документооборот: участник процессов» или это право в своей роли. Право также\nпозволяет менять процессы: давайте его тем, кому это допустимо. Обычные задания и документы\nправа «Рабочие процессы» не требуют.\n\n## Как пользоваться\n\n- **Процесс.** «Процессы → Создать» создаёт процесс с ручным запуском в разделе «Документооборот» и\n  открывает редактор. Процесс, уже настроенный в «Рабочих процессах» Twenty, добавляется кнопкой\n  «Добавить из Twenty».\n- **Twenty 2.50.** Приложение может запускать процессы с триггером «Webhook» (в том числе свой\n  «Запуск с параметрами»): их параметры — поля, которые ждёт webhook. Процесс с ручным триггером\n  запускается из самой Twenty. Создание, публикация и правка шагов на 2.50 делаются в редакторе\n  Twenty, затем процесс добавляется кнопкой «Добавить из Twenty». Задания шагов «Человеческий ввод»\n  выдаются и выполняются, как и на 2.45.\n- **Параметры запуска.** Кнопка процесса «Параметры запуска» → «Добавить поле»: название, тип\n  (текст, число, дата, сотрудник, компания, контакт, сделка), обязательность. «Сохранить\n  параметры» делает первым блоком черновика «Запуск с параметрами»: в следующих шагах параметры\n  выбираются как его переменные `{{trigger.<поле>}}` — например «Запуск с параметрами →\n  Сотрудник → Id» в поле «Исполнитель» задачи. «Где запускать» — «Откуда угодно, без записи» или\n  «На записи: <объект>»: тогда процесс запускают на выбранных записях этого объекта, по запуску\n  на каждую, а запись — переменная `{{trigger.record}}` с полями объекта (как у штатного запуска\n  вручную на записи). Без параметров и записи процесс начинается с обычного «Запуск вручную».\n  Опубликуйте процесс. Запускают его командой «Запустить процесс»: из Cmd+K — процессы без\n  записи, на выбранных записях — процессы их объекта и процессы без записи. Процессы без записи\n  запускаются и со страницы «Процессы». Обязательные параметры проверяются и в форме, и на сервере.\n\n  Устройство: своих типов триггеров у приложений Twenty нет, а у «Запуск вручную» редактор\n  показывает только свои переменные. Штатный пункт меню ручного запуска запускает процесс сразу,\n  без формы, и встроиться в него приложение не может. Поэтому «Запуск с параметрами» — штатный триггер Webhook\n  (POST, только с ключом API), поля параметров — его тело. Документооборот запускает такую версию\n  сам; внешняя система (например, мост в Битрикс24) может запустить процесс POST-запросом на адрес\n  вебхука с ключом API и телом из этих полей — тогда проверку обязательных полей делает она.\n  Шаг «Параметры запуска» процессов из 0.0.6 и раньше при первом сохранении параметров убирается,\n  его переменные в следующих шагах переводятся на `trigger`.\n- **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя\n  из «Параметров запуска», без него — у запустившего. Поля задания — поля шага из редактора.\n  «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются\n  переменными шага `{{<шаг>.<поле>}}`.\n- **Списки.** Фильтры — в окне под полем поиска (значок фильтра горит, когда фильтр включён),\n  сортировка — кликом по заголовку колонки. Действия со строкой — в «⋯» в её конце: открыть,\n  переименовать, переместить в папку, удалить и т. п. «Процессы» показывают все процессы раздела,\n  опубликованные и черновики.\n- **Папки документов.** «+ Новая папка», у папки «⋯ → Переименовать и оформить»: название, цвет и\n  значок; удаление папки оставляет документы в «Все документы».\n- **Удаление.** «⋯ → Удалить» спрашивает ещё раз и удаляет. Запись уходит в корзину Twenty и\n  восстанавливается: задания — в фильтре «Архив», документы — в фильтре «Удалённые», процессы — в\n  штатном списке «Рабочие процессы → Удалённые»; в карточке удалённой записи есть «Восстановить».\n  Для этого роль приложения может мягко удалять только документы, задачи и процессы.\n- **Параметры в редакторе.** После «Сохранить параметры» редактор процесса открывается заново:\n  он держит загруженную версию и иначе показал бы новые переменные только после перезагрузки.\n- **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для\n  заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).\n- **Документы.** «Документы → Создать» создаёт черновик в открытой папке и открывает его штатную\n  карточку: там реквизиты и поле «Файл»; строка списка открывает ту же карточку. Так сделано потому, что\n  страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.\n  Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в\n  документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ\n  хранит копию файла.\n\n## Ограничения\n\n- Рамки вокруг страницы раздела рисует платформа: карточку виджета и рамку вокруг компонента\n  приложения. Компоненты приложений работают в изолированном worker'е и убрать их не могут.\n- Блок «Запуск с параметрами» в редакторе открывает штатные настройки вебхука (адрес, тело,\n  авторизация): поля там те же, что в «Параметрах запуска», менять их удобнее кнопкой. Если\n  переименовать блок, Документооборот перестанет узнавать его как свой запуск.\n- Параметры запуска относятся к процессу, а не к версии: после правки полей опубликованная версия\n  до публикации нового черновика получает новые поля, а переменные убранных полей в ней пусты.\n- Документ без файла создаётся раньше файла: если закрыть карточку, не прикрепив файл, документ\n  останется с пустым полем «Файл».\n- На отдельной странице и в Битрикс24 карточка записи (задачи, документа, процесса) открывается в\n  CRM в новой вкладке: боковой панели CRM там нет. Файл документа прикрепляется там же.\n- Отдельная страница выглядит как штатный Twenty (светлая или тёмная тема по настройке системы):\n  скин `@haiiro/interface` на неё не действует.\n\n## Отдельная страница\n\n`https://<адрес CRM>/s/docflow/app` — документооборот без остальной CRM: шапка с разделами «Задания»,\n«Процессы», «Документы», кнопки «На весь экран» и «Открыть CRM». Раздел при открытии —\n`?section=processes` или `?section=documents`. Это те же страницы, что в папке «Документооборот»\nсайдбара, с теми же правами: страница работает от имени сотрудника, вошедшего в CRM в этом\nбраузере. Если вход не выполнен, она предлагает войти в CRM в соседней вкладке и открывается сама.\n\n## Битрикс24\n\nПодключается локальным приложением портала (одна компания — один портал).\n\n1. В портале: «Разработчикам → Другое → Локальное приложение», тип «Серверное».\n2. Адреса — HTTP-маршруты приложения на адресе компании (точный адрес виден в «Настройки →\n   Приложения → Документооборот → функции»):\n   - путь обработчика: `https://<адрес компании>/s/bitrix/app`\n   - путь первоначальной установки: `https://<адрес компании>/s/bitrix/install`\n3. Права приложения: `user`, `im`.\n4. Сохранить, скопировать «Код приложения» и «Ключ приложения» в `BITRIX_CLIENT_ID` и\n   `BITRIX_CLIENT_SECRET`, затем открыть приложение в портале — установка завершится сама.\n\nКаждый запрос портала проверяется обменом refresh-токена на `oauth.bitrix.info` с ключом\nприложения; адрес портала берётся из ответа Битрикс24. Привязывается первый подтверждённый портал,\nдругой портал к той же компании не подключится. Токены портала хранятся в хранилище приложения, не\nв записях. Сотрудник находится по почте профиля Битрикс24: если такого ещё нет в CRM, он\nсоздаётся сам (нужна включённая публичная ссылка-приглашение в «Настройки → Участники») с той же\nпочтой и ФИО из Битрикс24.\n\n**Вход.** В портале открывается отдельная страница документооборота. Сессия CRM во фрейме портала\nне работает (браузер не отдаёт cookie CRM чужому сайту), поэтому при первом открытии страница\nпросит «Войти через CRM»: открывается окно на адресе CRM, оно берёт вход сотрудника в CRM (если его\nнет — ждёт, пока сотрудник войдёт в CRM в соседней вкладке), передаёт его во фрейм и закрывается.\nДальше страница работает с токеном этого сотрудника (его права в CRM, 30 минут) и сама продлевает\nего, пока открыта; токен хранится в хранилище браузера только для этого портала. Если приложение не\nоткрывали дольше получаса, «Войти через CRM» нажимают снова — при живом входе в CRM окно закроется\nсамо. Если в CRM в этом браузере вошёл не тот сотрудник, что в Битрикс24, страница предупреждает.\nСтраница работает только во фрейме привязанного портала.\n\n## Разработка\n\n```bash\nyarn app dev        # следит за src/ и синхронизирует с сервером\nyarn app dev:function:logs\nyarn build:app      # отдельная страница: public/app (yarn build делает это сам)\nyarn test && yarn typecheck && yarn lint\n```\n\nУстройство `src/`: `shared/` — общий код (формы, процессы, фильтры REST, Битрикс24); `server/` —\nобращения к записям и движку процессов из функций; `logic-functions/`; `front/` и\n`front-components/` — интерфейс; `standalone/` — отдельная страница (те же страницы вне CRM); `objects/`, `fields/`, `views/`, `roles/`, `page-layouts/`,\n`navigation-menu-items/` — данные и раскладка. Записи читаются и пишутся только через REST API\n(`server/records.ts`, `front/api.ts`), движок процессов — через две мутации GraphQL\n(`server/workflow-engine.ts`, `server/launch-step.ts`): при смене версии платформы сверять эти\nфайлы. Стили интерфейса только inline: теги `<style>` в странице приложения платформа отбрасывает.\n\nПравила правки пакета (песочница страниц, процессы, единый вид вкладок, проверка на чистой CRM) —\nв [EDITING.md](EDITING.md).\n",
     "yarnLockChecksum": "d4d3dd414c49b677cf14b279b38ecd54",
-    "packageJsonChecksum": "2ec57a6ef3e597e2142ce9182cfcd00a",
+    "packageJsonChecksum": "fc2563b0f2f54182c864043aa5b1e38a",
     "requiredServerVersionRange": null,
     "healthCheckLogicFunction": {
       "universalIdentifier": "84360081-db5a-4f1c-9644-d975ccad9b2c"
@@ -815,7 +815,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/bitrix-app.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/bitrix-app.logic-function.mjs",
-      "builtHandlerChecksum": "2ac97b0df08fa2b764e9c755015544ff"
+      "builtHandlerChecksum": "41fdc49dbaa25acdc6f82a62ee5579c5"
     },
     {
       "universalIdentifier": "13952f55-e84f-4d3a-a5a2-f3d68d78ba5e",
@@ -840,7 +840,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/hand-out-form-step.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/hand-out-form-step.logic-function.mjs",
-      "builtHandlerChecksum": "808c8f19e6c16dca3c4b7950f26ae755"
+      "builtHandlerChecksum": "fe6566af1419c90fed78a561f9bf52d8"
     },
     {
       "universalIdentifier": "836f40fe-d127-48fe-a30f-9f5c563a5b50",
@@ -926,7 +926,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/on-task-updated.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/on-task-updated.logic-function.mjs",
-      "builtHandlerChecksum": "39cf29faed1a188e5679888d20b8e2a9"
+      "builtHandlerChecksum": "920c24b237989379144504801ec2ab57"
     },
     {
       "universalIdentifier": "b0da29b0-3229-4250-8919-b4f1b4370c44",
@@ -941,7 +941,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/docflow-app.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/docflow-app.logic-function.mjs",
-      "builtHandlerChecksum": "3321e6f034dd92ef202a915bca0edff3"
+      "builtHandlerChecksum": "56cb7844fc2617d5163ac445b505f5ac"
     },
     {
       "universalIdentifier": "c164c184-3b24-4d26-832b-219f3f02102a",
@@ -973,7 +973,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/on-workflow-run-updated.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/on-workflow-run-updated.logic-function.mjs",
-      "builtHandlerChecksum": "e08578c37ebf3e630c5d76d29ade5312"
+      "builtHandlerChecksum": "f489d63fb8d5b6edfa52aefbd707ce49"
     },
     {
       "universalIdentifier": "d2cc28ec-193b-4abb-9649-d119967361e7",
@@ -987,7 +987,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/on-attachment-created.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/on-attachment-created.logic-function.mjs",
-      "builtHandlerChecksum": "a99b1a4999d24325fa0ebd330caace2e"
+      "builtHandlerChecksum": "ab7aa45575186f7c764720cf50f9dfe6"
     },
     {
       "universalIdentifier": "d2cce9f2-6ba4-415c-aa3d-5d9aba6ae89c",
@@ -1075,7 +1075,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/capture-file.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/capture-file.logic-function.mjs",
-      "builtHandlerChecksum": "71beee25fd95a138f1138c48fcf92cfb"
+      "builtHandlerChecksum": "eedc59ac3f793e1b464b1b12b13752c6"
     },
     {
       "universalIdentifier": "f7559a62-213e-4b1f-a142-603b463a585a",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haiiro/docuflow",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "description": "NorDiv Документооборот: задания с полями, процессы с запуском по параметрам, документы со всех записей, приложение Битрикс24",
   "license": "AGPL-3.0-only",
   "publishConfig": {

package/src/logic-functions/bitrix-app.logic-function.mjs

@@ -119749,7 +119749,7 @@ var getCrmUrl = () => {
 // package.json
 var package_default = {
   name: "@haiiro/docuflow",
-  version: "0.0.18",
+  version: "0.0.19",
   description: "NorDiv \u0414\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u043E\u043E\u0431\u043E\u0440\u043E\u0442: \u0437\u0430\u0434\u0430\u043D\u0438\u044F \u0441 \u043F\u043E\u043B\u044F\u043C\u0438, \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u044B \u0441 \u0437\u0430\u043F\u0443\u0441\u043A\u043E\u043C \u043F\u043E \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u0430\u043C, \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u044B \u0441\u043E \u0432\u0441\u0435\u0445 \u0437\u0430\u043F\u0438\u0441\u0435\u0439, \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0411\u0438\u0442\u0440\u0438\u043A\u044124",
   license: "AGPL-3.0-only",
   publishConfig: {

package/src/logic-functions/capture-file.logic-function.mjs

@@ -59496,7 +59496,15 @@ var getTask = async (runAs, taskId) => readRestRecord(
 
 // src/shared/log.util.ts
 var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
 var logDocflow = (event, details) => console.info(PREFIX, event, details ?? "");
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
 
 // src/universal-identifiers.ts
 var DOCUMENT_FILE_UNIVERSAL_IDENTIFIER = "cadc1706-80e7-41dd-91dd-9c7324961abb";
@@ -59569,6 +59577,16 @@ var captureFile = async (capture) => {
   return "CREATED";
 };
 
+// src/server/event-errors.ts
+var withEventErrors = (name, handler2) => async (...args) => {
+  try {
+    return await handler2(...args);
+  } catch (error) {
+    logDocflowError(`${name}: failed`, error);
+    throw error;
+  }
+};
+
 // src/logic-functions/capture-file.logic-function.ts
 var isFileCapture = (payload) => typeof payload.attachmentId === "string" && typeof payload.fileId === "string" && typeof payload.label === "string" && typeof payload.sourceObjectName === "string" && typeof payload.sourceRecordId === "string";
 var handler = async (payload) => {
@@ -59587,7 +59605,7 @@ var capture_file_logic_function_default = defineLogicFunction({
   name: "docflow-capture-file",
   description: "\u041A\u043E\u043F\u0438\u0440\u0443\u0435\u0442 \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u044B\u0439 \u0444\u0430\u0439\u043B \u0432 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u044B \u0441 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u043E\u043C",
   timeoutSeconds: 120,
-  handler
+  handler: withEventErrors("capture-file", handler)
 });
 export {
   capture_file_logic_function_default as default

package/src/logic-functions/capture-file.logic-function.ts

@@ -1,6 +1,7 @@
 import { defineLogicFunction } from 'twenty-sdk/define';
 
 import { captureFile, type FileCapture } from 'src/server/document-capture';
+import { withEventErrors } from 'src/server/event-errors';
 import { CAPTURE_FILE_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
 const isFileCapture = (payload: Partial<FileCapture>): payload is FileCapture =>
@@ -28,5 +29,5 @@ export default defineLogicFunction({
   name: 'docflow-capture-file',
   description: 'Копирует вложенный файл в документы с источником',
   timeoutSeconds: 120,
-  handler,
+  handler: withEventErrors('capture-file', handler),
 });

package/src/logic-functions/docflow-app.logic-function.mjs

@@ -59961,7 +59961,7 @@ var AL = class {
 // package.json
 var package_default = {
   name: "@haiiro/docuflow",
-  version: "0.0.18",
+  version: "0.0.19",
   description: "NorDiv \u0414\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u043E\u043E\u0431\u043E\u0440\u043E\u0442: \u0437\u0430\u0434\u0430\u043D\u0438\u044F \u0441 \u043F\u043E\u043B\u044F\u043C\u0438, \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u044B \u0441 \u0437\u0430\u043F\u0443\u0441\u043A\u043E\u043C \u043F\u043E \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u0430\u043C, \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u044B \u0441\u043E \u0432\u0441\u0435\u0445 \u0437\u0430\u043F\u0438\u0441\u0435\u0439, \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0411\u0438\u0442\u0440\u0438\u043A\u044124",
   license: "AGPL-3.0-only",
   publishConfig: {

package/src/logic-functions/hand-out-form-step.logic-function.mjs

@@ -119664,7 +119664,25 @@ var handOutFormStep = async ({
 
 // src/shared/log.util.ts
 var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
 var logDocflow = (event, details) => console.info(PREFIX, event, details ?? "");
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
+
+// src/server/event-errors.ts
+var withEventErrors = (name, handler2) => async (...args) => {
+  try {
+    return await handler2(...args);
+  } catch (error) {
+    logDocflowError(`${name}: failed`, error);
+    throw error;
+  }
+};
 
 // src/universal-identifiers.ts
 var HAND_OUT_FORM_STEP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "70021464-1ce0-4c94-81c7-ee6b4490034c";
@@ -119684,7 +119702,7 @@ var hand_out_form_step_logic_function_default = defineLogicFunction({
   name: "docflow-hand-out-form-step",
   description: "\u0421\u043E\u0437\u0434\u0430\u0451\u0442 \u0437\u0430\u0434\u0430\u0447\u0443 CRM \u043F\u043E \u0448\u0430\u0433\u0443 \xAB\u0427\u0435\u043B\u043E\u0432\u0435\u0447\u0435\u0441\u043A\u0438\u0439 \u0432\u0432\u043E\u0434\xBB",
   timeoutSeconds: 30,
-  handler
+  handler: withEventErrors("hand-out-form-step", handler)
 });
 export {
   hand_out_form_step_logic_function_default as default

package/src/logic-functions/hand-out-form-step.logic-function.ts

@@ -2,6 +2,7 @@ import { defineLogicFunction } from 'twenty-sdk/define';
 
 import { handOutFormStep } from 'src/server/process-tasks';
 import { logDocflow } from 'src/shared/log.util';
+import { withEventErrors } from 'src/server/event-errors';
 import { HAND_OUT_FORM_STEP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
 const handler = async (payload: {
@@ -31,5 +32,5 @@ export default defineLogicFunction({
   name: 'docflow-hand-out-form-step',
   description: 'Создаёт задачу CRM по шагу «Человеческий ввод»',
   timeoutSeconds: 30,
-  handler,
+  handler: withEventErrors('hand-out-form-step', handler),
 });

package/src/logic-functions/on-attachment-created.logic-function.mjs

@@ -59978,6 +59978,27 @@ var readFileItems = (value) => Array.isArray(value) ? value.flatMap((item) => {
 var getDocflowEngine = (value = process.env.DOCFLOW_ENGINE) => value === "FORK" ? "FORK" : "APP";
 var isAppEngine = (value) => getDocflowEngine(value) === "APP";
 
+// src/shared/log.util.ts
+var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
+
+// src/server/event-errors.ts
+var withEventErrors = (name, handler2) => async (...args) => {
+  try {
+    return await handler2(...args);
+  } catch (error) {
+    logDocflowError(`${name}: failed`, error);
+    throw error;
+  }
+};
+
 // src/universal-identifiers.ts
 var ON_ATTACHMENT_CREATED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "d2cc28ec-193b-4abb-9649-d119967361e7";
 var CAPTURE_FILE_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "f735d9e9-d46a-4527-98c8-c84c2b6dbb7b";
@@ -60019,7 +60040,7 @@ var on_attachment_created_logic_function_default = defineLogicFunction({
   name: "docflow-on-attachment-created",
   description: "\u0421\u0442\u0430\u0432\u0438\u0442 \u0432 \u043E\u0447\u0435\u0440\u0435\u0434\u044C \u0441\u0431\u043E\u0440 \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u044B\u0445 \u0444\u0430\u0439\u043B\u043E\u0432 \u0432 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u044B",
   timeoutSeconds: 15,
-  handler,
+  handler: withEventErrors("on-attachment-created", handler),
   databaseEventTriggerSettings: {
     eventName: "attachment.created",
     batchMode: true

package/src/logic-functions/on-attachment-created.logic-function.ts

@@ -7,6 +7,7 @@ import {
 
 import { getAttachmentTarget, readFileItems } from 'src/shared/documents/attachment-target.util';
 import { isAppEngine } from 'src/shared/engine';
+import { withEventErrors } from 'src/server/event-errors';
 import {
   CAPTURE_FILE_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
   ON_ATTACHMENT_CREATED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
@@ -59,7 +60,7 @@ export default defineLogicFunction({
   name: 'docflow-on-attachment-created',
   description: 'Ставит в очередь сбор вложенных файлов в документы',
   timeoutSeconds: 15,
-  handler,
+  handler: withEventErrors('on-attachment-created', handler),
   databaseEventTriggerSettings: {
     eventName: 'attachment.created',
     batchMode: true,

package/src/logic-functions/on-task-updated.logic-function.mjs

@@ -59673,6 +59673,27 @@ var answerStepOfTask = async (task, values) => {
   }
 };
 
+// src/shared/log.util.ts
+var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
+
+// src/server/event-errors.ts
+var withEventErrors = (name, handler2) => async (...args) => {
+  try {
+    return await handler2(...args);
+  } catch (error) {
+    logDocflowError(`${name}: failed`, error);
+    throw error;
+  }
+};
+
 // src/universal-identifiers.ts
 var ON_TASK_UPDATED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "a7dd8969-189b-4fb7-b025-c7bf433832c3";
 
@@ -59708,7 +59729,7 @@ var on_task_updated_logic_function_default = defineLogicFunction({
   name: "docflow-on-task-updated",
   description: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0435\u0442 \u0437\u0430\u043A\u0440\u044B\u0442\u0438\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 \u0438 \u043F\u0440\u043E\u0434\u043E\u043B\u0436\u0430\u0435\u0442 \u043F\u0440\u043E\u0446\u0435\u0441\u0441",
   timeoutSeconds: 30,
-  handler,
+  handler: withEventErrors("on-task-updated", handler),
   databaseEventTriggerSettings: {
     eventName: "task.updated",
     updatedFields: ["status"]

package/src/logic-functions/on-task-updated.logic-function.ts

@@ -13,6 +13,7 @@ import {
 } from 'src/shared/form/form-fields.util';
 import { type DocflowTaskRecord, updateTask } from 'src/server/records';
 import { answerStepOfTask } from 'src/server/task-completion';
+import { withEventErrors } from 'src/server/event-errors';
 import { ON_TASK_UPDATED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
 // A task closed outside the docflow page (the board, the list, the API).
@@ -63,7 +64,7 @@ export default defineLogicFunction({
   name: 'docflow-on-task-updated',
   description: 'Проверяет закрытие задачи и продолжает процесс',
   timeoutSeconds: 30,
-  handler,
+  handler: withEventErrors('on-task-updated', handler),
   databaseEventTriggerSettings: {
     eventName: 'task.updated',
     updatedFields: ['status'],

package/src/logic-functions/on-workflow-run-updated.logic-function.mjs

@@ -119323,7 +119323,15 @@ var isAppEngine = (value) => getDocflowEngine(value) === "APP";
 
 // src/shared/log.util.ts
 var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
 var logDocflow = (event, details) => console.info(PREFIX, event, details ?? "");
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
 
 // src/shared/docflow.constants.ts
 var DOCFLOW_LAUNCH_PARAMETERS_KEY = "smbDocflowParameters";
@@ -119540,6 +119548,16 @@ var closeTasksOfAnsweredSteps = async (run) => {
   return closedCount;
 };
 
+// src/server/event-errors.ts
+var withEventErrors = (name, handler2) => async (...args) => {
+  try {
+    return await handler2(...args);
+  } catch (error) {
+    logDocflowError(`${name}: failed`, error);
+    throw error;
+  }
+};
+
 // src/universal-identifiers.ts
 var ON_WORKFLOW_RUN_UPDATED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "c90778dd-4b0f-4a8c-a769-aca0c09f0b5f";
 var HAND_OUT_FORM_STEP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "70021464-1ce0-4c94-81c7-ee6b4490034c";
@@ -119550,6 +119568,11 @@ var handler = async (event) => {
     return { skipped: "FORK_ENGINE" };
   }
   const run = { ...event.properties.after, id: event.recordId };
+  logDocflow("run updated: received", {
+    workflowRunId: run.id,
+    status: run.status,
+    updatedFields: event.properties.updatedFields
+  });
   if (run.status !== "RUNNING" || run.state === void 0 || run.state === null) {
     logDocflow("run updated: skipped", { workflowRunId: run.id, status: run.status, hasState: run.state != null });
     return { skipped: "NOT_RUNNING" };
@@ -119592,7 +119615,7 @@ var on_workflow_run_updated_logic_function_default = defineLogicFunction({
   name: "docflow-on-workflow-run-updated",
   description: "\u0412\u044B\u0434\u0430\u0451\u0442 \u0437\u0430\u0434\u0430\u0447\u0438 \u043F\u043E \u0448\u0430\u0433\u0430\u043C \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u043E\u0432 \u0438 \u0437\u0430\u043A\u0440\u044B\u0432\u0430\u0435\u0442 \u043E\u0442\u0432\u0435\u0447\u0435\u043D\u043D\u044B\u0435",
   timeoutSeconds: 30,
-  handler,
+  handler: withEventErrors("on-workflow-run-updated", handler),
   databaseEventTriggerSettings: {
     eventName: "workflowRun.updated",
     updatedFields: ["state", "status"]

package/src/logic-functions/on-workflow-run-updated.logic-function.ts

@@ -10,6 +10,7 @@ import { logDocflow } from 'src/shared/log.util';
 import { getFormStepTaskRequests } from 'src/shared/workflow/workflow-run.util';
 import { closeTasksOfAnsweredSteps } from 'src/server/process-tasks';
 import { type WorkflowRunRecord } from 'src/server/records';
+import { withEventErrors } from 'src/server/event-errors';
 import {
   HAND_OUT_FORM_STEP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
   ON_WORKFLOW_RUN_UPDATED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
@@ -27,6 +28,12 @@ const handler = async (
 
   const run = { ...event.properties.after, id: event.recordId };
 
+  logDocflow('run updated: received', {
+    workflowRunId: run.id,
+    status: run.status,
+    updatedFields: (event.properties as { updatedFields?: unknown }).updatedFields,
+  });
+
   if (run.status !== 'RUNNING' || run.state === undefined || run.state === null) {
     logDocflow('run updated: skipped', { workflowRunId: run.id, status: run.status, hasState: run.state != null });
 
@@ -77,7 +84,7 @@ export default defineLogicFunction({
   name: 'docflow-on-workflow-run-updated',
   description: 'Выдаёт задачи по шагам процессов и закрывает отвеченные',
   timeoutSeconds: 30,
-  handler,
+  handler: withEventErrors('on-workflow-run-updated', handler),
   databaseEventTriggerSettings: {
     eventName: 'workflowRun.updated',
     updatedFields: ['state', 'status'],