gitmost/packages/mcp/node_modules/@hocuspocus/provider at f2416dccd7006decdad338549b5bbe98c8b68753 - gitmost - vvzvlad@gitea

vvzvlad/gitmost

Files

T

agent_coder f2416dccd7 refactor(mcp): распил client.ts (5206 строк) на доменные модули за тонким фасадом (#450 )

client.ts был god-object'ом на 5206 строк / ~65 методов / 5 ответственностей —
любая правка рисковала всем write-path, обработка ошибок неоднородна. Разнесли
на доменные модули; DocmostClient остаётся ТОНКИМ ФАСАДОМ с прежним внешним
контрактом. Чистый рефакторинг, поведение не меняется. closes #450

- Фасад client.ts (93 строки) композирует 10 миксинов над общим абстрактным
  базовым классом. Паттерн — МИКСИНЫ (не context-object), т.к. тесты
  субклассируют DocmostClient и переопределяют seam'ы (mutatePage/replacePage/
  resolvePageId/getPageRaw/…); единая цепочка прототипов сохраняет виртуальную
  диспетчеризацию this.<method> сквозь модули.
- client/context.ts (база, ≤700): общее состояние (axios, apiUrl, токены, кэши
  resolvePageId/collab-token, sandbox/metrics-синки), конструктор + оба
  интерсептора, login/ensureAuthenticated/paginateAll/resolvePageId/
  mutateLiveContentUnlocked + write-seam'ы mutatePage/replacePage. private-поля
  расширены до protected (внутреннее, не в публичном контракте) чтобы
  соседние миксины видели общее состояние.
- Модули (каждый ≤730): read, pages, nodes-write, media (images/attachments/
  drawio), comments, transforms (markdown + JS-sandbox transformPage), tables,
  stash, doc-validate. errors.ts — единый REST error-mapping (formatDocmost
  AxiosError, довершение #437; тексты сообщений без изменений).
- Внешний контракт СОХРАНЁН (доказано компиляцией с обеих сторон): 53 публичных
  метода на DocmostClient через `implements IXMixin`-интерфейсы (без ручного
  зеркала, #446); Pick<DocmostClient, DocmostClientMethod> in-app и Pick в
  tool-specs резолвятся; множество async-методов 59==59 идентично. Нагруженные
  seam'ы (replaceImage один-лок #425, self-resolve #449, единый error-путь) —
  байт-идентичны. Ни одного дубля публичного метода; stub+impl всегда
  затеняется реальной реализацией.
- zod v3→v4: investigate-only, РЕКОМЕНДАЦИЯ отложить — SDK 1.29 поддерживает v4
  (peer ^3.25||^4.0), но мажор-бамп трогает всю схема-поверхность и оба хоста,
  смешивать со структурным распилом рискованно. Отдельным follow-up.

Стоит на #449 (#475). Тесты: mcp node --test 800/800 (== база), tsc чисто в
client/ (2 pre-existing ws-типа в нетронутом lib/). Ни одной строки кода не
потеряно (нормализованный дифф), убраны 52 дублированных JSDoc-блока.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-11 01:03:25 +03:00

Symbolic link

1 line

67 B

Plaintext

Raw Blame History

/home/claude/gitmost/packages/mcp/node_modules/@hocuspocus/provider