@taskless-app/shared 0.1.34 → 0.1.36

package/dist/importPackage.d.ts

@@ -0,0 +1,1059 @@
+import { z } from "zod";
+/**
+ * Версия формата, которую пишет сегодняшний коннектор и понимает сегодняшнее
+ * ядро. Растёт на ЛОМАЮЩЕМ изменении формы; добавление необязательного поля
+ * версию не двигает — старое ядро прочитает такой пакет, не заметив нового поля.
+ *
+ * В примере спеки версии нет, но задача требует её прямо: «схема обязана быть
+ * версионированной, иначе завтрашний коннектор сломает вчерашний пакет».
+ */
+export declare const IMPORT_PACKAGE_FORMAT_VERSION = 1;
+/**
+ * Версии, которые ядро умеет читать. Отдельно от текущей, потому что читать мы
+ * обязаны шире, чем писать: пакет мог быть собран неделю назад и пролежать в
+ * очереди, пока ядро обновилось.
+ */
+export declare const SUPPORTED_IMPORT_PACKAGE_VERSIONS: readonly [1];
+export declare const IMPORT_EXTERNAL_ID_MAX = 400;
+export declare const IMPORT_TITLE_MAX = 1000;
+export declare const IMPORT_HTML_MAX = 5000000;
+export declare const IMPORT_FILE_PATH_MAX = 600;
+export declare const IMPORT_LABEL_MAX = 200;
+export declare const IMPORT_LABELS_MAX = 100;
+export declare const IMPORT_URL_MAX = 2000;
+export declare const IMPORT_SOURCE_MAX = 100;
+export declare const IMPORT_ATTACHMENT_REFS_MAX = 500;
+/**
+ * Машинное имя исходного сервиса. Без `:` и пробелов сознательно: на этом стоит
+ * однозначность ключа идемпотентности (`importEntityKey`).
+ */
+export declare const IMPORT_SOURCE_RE: RegExp;
+/**
+ * НЕВИДИМЫЕ СИМВОЛЫ — всё, чего человек в строке не увидит, а машина учтёт.
+ *
+ * Используется у `ImportExternalId` и `ImportAttachmentName` — оба алфавит не
+ * сужают (в отличие от `ImportFilePath`, который 2026-08-26 перешёл на белый
+ * список `IMPORT_FILE_PATH_RE` и вообще не пропускает ничего вне
+ * `[A-Za-z0-9._-]`, так что для него эта проверка стала бы мёртвым кодом —
+ * невидимые символы и суррогаты закрыты для пути уже тем, что их нет в
+ * алфавите). `externalId` и `name` сознательно не сужают алфавит (см. их
+ * комментарии): оба — либо чужой id, либо человекочитаемое имя файла, где
+ * скобки/пробелы/кириллица законны, поэтому для них нужен именно перечень
+ * запрещённых классов, а не белый список.
+ *
+ * Классами Unicode, а не перечнем кодов, потому что перечень тут всегда неполон:
+ *  • `Cc` — управляющие C0 (включая NUL), DEL и C1. NUL Postgres не хранит
+ *    в `text`;
+ *  • `Cf` — форматирующие: zero-width space, BOM, мягкий перенос,
+ *    bidi-переопределения. Ключ идемпотентности показывается человеку, а
+ *    такой символ делает две разные строки неразличимыми на глаз;
+ *  • `Zl`/`Zp` — разделители строки и абзаца: разрыв строки ломает однострочную
+ *    запись в лог прогона и в отчёт о карантине;
+ *  • `Default_Ignorable_Code_Point` — свойство, а не категория, и без него в
+ *    проверке оставалась дыра: селекторы вариаций (U+FE0F), монгольские FVS
+ *    (U+180B–U+180D) и combining grapheme joiner (U+034F) лежат в категории
+ *    `Mn`, то есть ни под один класс выше не подходят, — а невидимы ровно так
+ *    же. `p42` и `p42\u{FE0F}` давали ДВА РАЗНЫХ ключа идемпотентности,
+ *    неразличимых на экране карантина. Нашли верификаторы TERMES и SCARAB на
+ *    ревью MOVE-7;
+ *  • `U+2800` BRAILLE PATTERN BLANK — единственный код здесь перечнем, а не
+ *    классом, и это не лень. Свойства «рисуется пустым местом» в Unicode нет:
+ *    у него категория `So`, `Default_Ignorable` он не имеет, — а выглядит как
+ *    пустая ячейка в любом шрифте с Брайлем (тем же приёмом делают невидимые
+ *    ники в мессенджерах). Остальные известные пустые глифы — филлеры хангыля
+ *    (U+115F, U+1160, U+3164, U+FFA0), кхмерские U+17B4/U+17B5, монгольский
+ *    U+180E — все `Default_Ignorable` и ловятся строкой выше; проверено
+ *    перебором, U+2800 из них единственный выпадающий. Нашёл верификатор
+ *    MYRMEX третьим кругом на том же ревью.
+ *
+ * Пробелы категории `Zs` (в т.ч. неразрывный) сюда НЕ входят намеренно: они видны
+ * как пробел, а по краям строки их и так снимает отдельная проверка.
+ *
+ * Побочно под запрет попадают ZWJ и теговые символы, то есть составные эмодзи в
+ * качестве `externalId`. Машинного id такой формы у сервисов не бывает;
+ * появится — вырежется один класс, а не вся проверка.
+ */
+export declare const IMPORT_INVISIBLE_CHARS_RE: RegExp;
+/**
+ * ОДИНОЧНЫЙ (НЕПАРНЫЙ) СУРРОГАТ — не «невидимый символ», а вообще не символ, и
+ * поэтому его не ловит НИ ОДНО свойство Unicode: для `\p{...}`-классов такого
+ * кода просто не существует. Проверка отдельная именно по этой причине, а не
+ * ради красоты.
+ *
+ * Чем это хуже всего, что чинили выше. Невидимые символы дают два ключа,
+ * НЕРАЗЛИЧИМЫХ НА ГЛАЗ. Одиночные суррогаты дают два ключа, РАЗНЫХ по схеме и
+ * СОВПАДАЮЩИХ БАЙТ В БАЙТ после кодирования в UTF-8: все 2048 значений
+ * `U+D800`…`U+DFFF` схлопываются в один и тот же `U+FFFD`. То есть на границе
+ * с Postgres (колонка `text`, куда ключ и едет) две разные сущности становятся
+ * одной — прямая коллизия идемпотентности, а не косметика.
+ *
+ * И это не только про злой умысел: `JSON.parse` такую строку принимает молча,
+ * а получается она обычным наивным `slice(0, N)` где-нибудь выше по цепочке —
+ * если срез пришёлся на середину суррогатной пары (эмодзи, редкий CJK,
+ * математические знаки). Классические грабли обрезки, а не атака.
+ *
+ * Регулярка без флага `u` намеренно: она работает с UTF-16 code units, а
+ * искать надо ровно непарную половину пары. Нашёл верификатор HORNET
+ * четвёртым кругом на ревью MOVE-7.
+ *
+ * Используется у `ImportExternalId` и `ImportAttachmentName` — как и
+ * `IMPORT_INVISIBLE_CHARS_RE`, у `ImportFilePath` эта проверка стала
+ * избыточной: белый список `IMPORT_FILE_PATH_RE` не пропускает суррогат по
+ * построению.
+ */
+export declare const IMPORT_LONE_SURROGATE_RE: RegExp;
+/**
+ * Идентификатор сущности В ИСХОДНОМ СЕРВИСЕ — основа идемпотентности: по нему
+ * повторный прогон находит уже перенесённое и обновляет, а не плодит копии.
+ * Обязан быть СТАБИЛЬНЫМ между выгрузками (id страницы — да, её заголовок — нет).
+ *
+ * Строка, а не число: у Confluence это число, у Notion — uuid, у следующего
+ * сервиса что-то третье. Алфавит поэтому НЕ сужаем до латиницы с цифрами: чужой
+ * сервис вправе выдавать что угодно, а коннектор, вынужденный перекодировать id,
+ * потерял бы ровно ту стабильность, на которой всё стоит.
+ *
+ * Но два класса символов запрещены, и оба — про то, что с этой строкой будет
+ * ДАЛЬШЕ:
+ *
+ *  • НЕВИДИМЫЕ (`IMPORT_INVISIBLE_CHARS_RE`). `externalId` уезжает в ключ
+ *    идемпотентности (`importEntityKey`), а тот — в колонку БД, в лог прогона и
+ *    в текст ошибок. Postgres не хранит NUL в `text`, так что пакет с таким id
+ *    падал бы уже на записи — в ядре импорта, далеко от места, где мусор
+ *    приехал. Остальные невидимые не роняют запись, но делают два разных ключа
+ *    неразличимыми для человека, который смотрит на карантин и решает, одна это
+ *    сущность или две. Печатность ключа — заявленный контракт, и держать его
+ *    обязана схема: сам `importEntityKey` чистая склейка и вход проверять не
+ *    может.
+ *
+ *  • КРАЙНИЕ ПРОБЕЛЫ. `"p42"` и `"p42 "` — разные ключи и потому разные
+ *    сущности, хотя различие невидимо глазом; такой пакет молча импортируется
+ *    дважды. Пробелы ВНУТРИ оставлены: они видны, ключ не ломают (свободная
+ *    часть в нём последняя) и у сервисов, где id это путь или заголовок, законны.
+ */
+export declare const ImportExternalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+/**
+ * Момент времени из исходного сервиса — ISO 8601 СО СМЕЩЕНИЕМ. Смещение
+ * обязательно: у экспортов сплошь и рядом локальное время сервера, и без него
+ * даты уезжают на часовой пояс, а «кто раньше» перестаёт работать. Строка, а не
+ * Date, потому что пакет — это JSON на диске.
+ */
+export declare const ImportDate: z.ZodString;
+/**
+ * ПУТЬ К ФАЙЛУ ВЛОЖЕНИЯ ВНУТРИ ПАКЕТА — относительный, от манифеста
+ * (`files/a3-scheme.png`). Спека говорит «манифест JSON плюс папка файлов», и
+ * подкаталог тут не украшение: в выгрузке Confluence вложений много, и два
+ * разных документа спокойно принесут по своему `image.png` — плоские имена их
+ * столкнут, папка нет.
+ *
+ * БЕЛЫЙ СПИСОК, А НЕ ПЕРЕЧЕНЬ ЗАПРЕЩЁННОГО. Четыре круга ревью на этом же
+ * пакете (MOVE-7) чинили контракт «путь печатный» отказом от всё новых и новых
+ * находок — управляющие ASCII, невидимый Unicode классами `Cf`/`Zl`/`Zp`,
+ * категория `Mn` через `Default_Ignorable_Code_Point`, отдельно Брайль
+ * `U+2800`, отдельно `%` из-за percent-декодирования при резолве. Каждый раунд
+ * закрывал настоящую дыру и открывал место для следующей: гонка за
+ * запрещённым принципиально неполна. Путь внутри пакета при этом выбирает
+ * сам коннектор — это не то поле, где живёт человекочитаемое имя (оно в
+ * `name` у `ImportAttachment`), поэтому сузить алфавит для него можно без
+ * потери: скобки, пробелы, кириллица никуда не делись, просто переехали в
+ * `name`.
+ *
+ * `^[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$` закрывает весь класс разом, по
+ * построению, а не перечислением:
+ *  • пробел, скобки, `%`, `\` — вне алфавита, схема их не пропустит;
+ *  • НЕВИДИМЫЙ Unicode и одиночные суррогаты — тоже вне алфавита: строка,
+ *    целиком состоящая из `A-Za-z0-9._-`, ни того, ни другого не содержит
+ *    физически. `IMPORT_INVISIBLE_CHARS_RE`/`IMPORT_LONE_SURROGATE_RE` здесь
+ *    больше не нужны — они остаются только у `ImportExternalId`, чей алфавит
+ *    сознательно не сужен (см. его комментарий);
+ *  • ведущий `/`, пустой сегмент (`files//a.png`), обратный слэш —
+ *    исключены формой регулярки (сегмент — непустая последовательность
+ *    разрешённых символов, разделитель ровно один `/`).
+ *
+ * Регулярка НЕ ловит сегменты `.` и `..` — они состоят из разрешённых
+ * символов и под неё подходят, поэтому запрет на них — отдельная проверка
+ * ниже, как и раньше.
+ */
+export declare const IMPORT_FILE_PATH_RE: RegExp;
+export declare const ImportFilePath: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Человек из исходного сервиса. Здесь он ПРИЗРАК: коннектор знает только то, что
+ * было в экспорте, а сопоставление с нашими пользователями — работа ядра
+ * (MOVE-10). Поэтому обязателен ровно `externalId`, а `name` — то, что показать
+ * человеку, пока сопоставления нет.
+ *
+ * `email` тут ПОДСКАЗКА ДЛЯ СОПОСТАВЛЕНИЯ, а не адрес входа: спека прямо
+ * запрещает класть чужую почту в наше уникальное поле `User.email`, иначе импорт
+ * становится способом занять чужой адрес.
+ */
+export declare const ImportPerson: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    name: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+    /** Логин в исходном сервисе — вторая зацепка, когда почты в экспорте нет. */
+    username: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    name: string;
+    email?: string | undefined;
+    username?: string | undefined;
+    avatarUrl?: string | undefined;
+}, {
+    externalId: string;
+    name: string;
+    email?: string | undefined;
+    username?: string | undefined;
+    avatarUrl?: string | undefined;
+}>;
+export type ImportPerson = z.infer<typeof ImportPerson>;
+/**
+ * Пространство — верхний контейнер исходного сервиса (space в Confluence,
+ * teamspace в Notion). Во что оно превратится у нас, решает ядро.
+ */
+export declare const ImportSpace: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    title: z.ZodString;
+    descriptionHtml: z.ZodOptional<z.ZodString>;
+    /** Ссылка на пространство в исходном сервисе — чтобы после переезда было куда вернуться. */
+    sourceUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    title: string;
+    descriptionHtml?: string | undefined;
+    sourceUrl?: string | undefined;
+}, {
+    externalId: string;
+    title: string;
+    descriptionHtml?: string | undefined;
+    sourceUrl?: string | undefined;
+}>;
+export type ImportSpace = z.infer<typeof ImportSpace>;
+/**
+ * Состояние спринта. ПЕРЕЧИСЛЕНИЕМ, в отличие от `status` у задачи, который
+ * едет строкой исходного сервиса, — и это не непоследовательность. Статусов у
+ * чужого трекера сколько угодно и своих, раскладывать их по нашим умеет только
+ * ядро с картой воркфлоу; состояний же спринта ровно три, и они одни и те же у
+ * Jira, YouTrack и у нас (`Sprint.state` в схеме: `planned | active |
+ * completed`). Перечисление здесь ловит опечатку коннектора на входе, а не
+ * через неделю в отчёте.
+ */
+export declare const IMPORT_SPRINT_STATES: readonly ["planned", "active", "completed"];
+export type ImportSprintState = (typeof IMPORT_SPRINT_STATES)[number];
+/**
+ * MOVE-28: СПРИНТ — итерация исходного трекера (sprint в Jira, sprint/веха в
+ * YouTrack). Первый шаг к переносу спринтов спринтами, а не меткой на задаче
+ * (MOVE-29): здесь только форма, ни выкачки, ни раскладки по нашим таблицам.
+ *
+ * `spaceId` ОБЯЗАТЕЛЕН — спринт принадлежит пространству, как страница (у
+ * задачи `spaceId` необязательный, потому что у плоских экспортов задача
+ * приезжает без проекта и уезжает в запасной; у спринта такого случая нет:
+ * итерация без доски бессмысленна, и коннектор, который не знает её
+ * пространства, обязан споткнуться здесь, а не создать бесхозный спринт).
+ *
+ * Как и везде в пакете, `externalId` — id ИЗ ЧУЖОГО СЕРВИСА, а не наш cuid.
+ * Даты необязательные: у планируемого спринта их сплошь и рядом нет.
+ */
+export declare const ImportSprint: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    spaceId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    name: z.ZodString;
+    /** Цель итерации — короткий текст, который человек писал в трекере. */
+    goal: z.ZodOptional<z.ZodString>;
+    startsAt: z.ZodOptional<z.ZodString>;
+    endsAt: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["planned", "active", "completed"]>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    spaceId: string;
+    name: string;
+    goal?: string | undefined;
+    startsAt?: string | undefined;
+    endsAt?: string | undefined;
+    state: "active" | "completed" | "planned";
+}, {
+    externalId: string;
+    spaceId: string;
+    name: string;
+    goal?: string | undefined;
+    startsAt?: string | undefined;
+    endsAt?: string | undefined;
+    state: "active" | "completed" | "planned";
+}>;
+export type ImportSprint = z.infer<typeof ImportSprint>;
+/**
+ * К чему прицеплен комментарий (`on` из спеки). `id` здесь — `externalId` цели
+ * в исходном сервисе, не наш cuid.
+ */
+export declare const ImportCommentTarget: z.ZodObject<{
+    kind: z.ZodEnum<["page", "task"]>;
+    id: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+}, "strip", z.ZodTypeAny, {
+    kind: "page" | "task";
+    id: string;
+}, {
+    kind: "page" | "task";
+    id: string;
+}>;
+export type ImportCommentTarget = z.infer<typeof ImportCommentTarget>;
+/**
+ * Страница.
+ *
+ * ВНИМАНИЕ К ИМЕНАМ: `spaceId`, `parentId`, `authorId` — это `externalId` ИЗ
+ * ЧУЖОГО СЕРВИСА, а не ссылки на наши таблицы. Имена взяты из спеки, и по имени
+ * они читаются как внешние ключи на нашу базу — по сути это не так, наши id
+ * появятся только в ядре, когда сущность уже создана.
+ *
+ * Дерево едет ССЫЛКАМИ (`parentId`), а не вложенностью: вложенность заставила бы
+ * коннектор собирать дерево целиком в памяти и ломалась бы на циклах, которые в
+ * чужих экспортах встречаются. `null`/отсутствие — корень пространства.
+ */
+export declare const ImportPage: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    spaceId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>>;
+    title: z.ZodString;
+    /** Тело в HTML — см. про ProseMirror в шапке файла. */
+    bodyHtml: z.ZodString;
+    authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    /** Кто правил последним, если сервис это отдаёт, — иначе автор и правщик сливаются. */
+    lastEditorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    /** `externalId` вложений этой страницы — сами файлы в `attachments` манифеста. */
+    attachments: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, "many">>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    spaceId: string;
+    parentId?: string | null | undefined;
+    title: string;
+    bodyHtml: string;
+    authorId?: string | undefined;
+    lastEditorId?: string | undefined;
+    createdAt: string;
+    updatedAt?: string | undefined;
+    attachments?: string[] | undefined;
+    labels?: string[] | undefined;
+    sourceUrl?: string | undefined;
+}, {
+    externalId: string;
+    spaceId: string;
+    parentId?: string | null | undefined;
+    title: string;
+    bodyHtml: string;
+    authorId?: string | undefined;
+    lastEditorId?: string | undefined;
+    createdAt: string;
+    updatedAt?: string | undefined;
+    attachments?: string[] | undefined;
+    labels?: string[] | undefined;
+    sourceUrl?: string | undefined;
+}>;
+export type ImportPage = z.infer<typeof ImportPage>;
+/**
+ * Задача. Статус едет СТРОКОЙ ИСХОДНОГО СЕРВИСА, а не нашим enum'ом: у чужого
+ * трекера свои состояния, и раскладывать их по нашим — работа ядра, где для
+ * этого есть карта воркфлоу. Коннектор, который угадывает наш статус, обманет
+ * ровно один раз и незаметно.
+ *
+ * `spaceId`, `parentId`, `authorId`, `assigneeId` — тоже внешние id, см. `ImportPage`.
+ */
+export declare const ImportTask: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    spaceId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>>;
+    title: z.ZodString;
+    descriptionHtml: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodString>;
+    authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    assigneeId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    /**
+     * MOVE-28: в каком спринте задача — `externalId` из `sprints`. Необязателен
+     * дважды: у источника без спринтов их нет вовсе, и внутри источника со
+     * спринтами задача может лежать в бэклоге.
+     */
+    sprintId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    dueAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, "many">>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    spaceId?: string | undefined;
+    parentId?: string | null | undefined;
+    title: string;
+    descriptionHtml?: string | undefined;
+    status?: string | undefined;
+    priority?: string | undefined;
+    authorId?: string | undefined;
+    assigneeId?: string | undefined;
+    sprintId?: string | undefined;
+    createdAt: string;
+    updatedAt?: string | undefined;
+    dueAt?: string | undefined;
+    completedAt?: string | undefined;
+    attachments?: string[] | undefined;
+    labels?: string[] | undefined;
+    sourceUrl?: string | undefined;
+}, {
+    externalId: string;
+    spaceId?: string | undefined;
+    parentId?: string | null | undefined;
+    title: string;
+    descriptionHtml?: string | undefined;
+    status?: string | undefined;
+    priority?: string | undefined;
+    authorId?: string | undefined;
+    assigneeId?: string | undefined;
+    sprintId?: string | undefined;
+    createdAt: string;
+    updatedAt?: string | undefined;
+    dueAt?: string | undefined;
+    completedAt?: string | undefined;
+    attachments?: string[] | undefined;
+    labels?: string[] | undefined;
+    sourceUrl?: string | undefined;
+}>;
+export type ImportTask = z.infer<typeof ImportTask>;
+/**
+ * Комментарий к странице или задаче. `parentId` — ответ на другой комментарий
+ * (ветка обсуждения), не владелец: владелец всегда в `on`.
+ */
+export declare const ImportComment: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    on: z.ZodObject<{
+        kind: z.ZodEnum<["page", "task"]>;
+        id: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "page" | "task";
+        id: string;
+    }, {
+        kind: "page" | "task";
+        id: string;
+    }>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>>;
+    authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    bodyHtml: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    on: {
+        kind: "page" | "task";
+        id: string;
+    };
+    parentId?: string | null | undefined;
+    authorId?: string | undefined;
+    bodyHtml: string;
+    createdAt: string;
+    updatedAt?: string | undefined;
+}, {
+    externalId: string;
+    on: {
+        kind: "page" | "task";
+        id: string;
+    };
+    parentId?: string | null | undefined;
+    authorId?: string | undefined;
+    bodyHtml: string;
+    createdAt: string;
+    updatedAt?: string | undefined;
+}>;
+export type ImportComment = z.infer<typeof ImportComment>;
+/**
+ * Вложение. Метаданные здесь, БАЙТЫ — файлом внутри пакета (`file`). Владельца у
+ * вложения нет: на него ссылаются страница и задача через свой `attachments`,
+ * как и показано в спеке — один и тот же файл так может принадлежать нескольким
+ * сущностям, не размножаясь.
+ */
+/**
+ * Имя файла, каким его видит ЧЕЛОВЕК (в отличие от `file` — служебного пути,
+ * белый список для которого сузил алфавит до ASCII). `name` алфавит не сужает
+ * — скобки, пробелы, кириллица здесь как раз законны, это и есть то поле,
+ * куда они переехали из `ImportFilePath` (см. её комментарий). Но именно
+ * поэтому `name` — единственное поле в файле, которое ПОКАЗЫВАЕТСЯ человеку
+ * буквально как имя файла, и оставлять его вовсе без защиты от невидимых
+ * символов значило бы закрыть RTL-override-подмену расширения у `file` и
+ * `externalId` и оставить открытой ровно у того поля, где она опаснее всего:
+ * `"invoice‮fdp.exe"` пройдёт схему и отрисуется человеку как
+ * «invoice.pdf» при реальном `.exe`. Найдено ревью SPHINX на MOVE-7.
+ */
+export declare const ImportAttachmentName: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+export declare const ImportAttachment: z.ZodObject<{
+    externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    /** Относительный путь внутри пакета: `files/a3-scheme.png`. */
+    file: z.ZodEffects<z.ZodString, string, string>;
+    /** Как файл назывался у человека — `file` в пакете может быть обеззаражен коннектором. */
+    name: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    mime: z.ZodOptional<z.ZodString>;
+    byteSize: z.ZodOptional<z.ZodNumber>;
+    authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    externalId: string;
+    file: string;
+    name?: string | undefined;
+    mime?: string | undefined;
+    byteSize?: number | undefined;
+    authorId?: string | undefined;
+    createdAt?: string | undefined;
+}, {
+    externalId: string;
+    file: string;
+    name?: string | undefined;
+    mime?: string | undefined;
+    byteSize?: number | undefined;
+    authorId?: string | undefined;
+    createdAt?: string | undefined;
+}>;
+export type ImportAttachment = z.infer<typeof ImportAttachment>;
+/**
+ * МАНИФЕСТ — то, что коннектор кладёт в `manifest.json`, а ядро читает первым и
+ * единственным входом. Все сущности здесь; рядом лежит только папка файлов.
+ */
+export declare const ImportPackageManifest: z.ZodObject<{
+    /**
+     * Версия формата. Стоит ПЕРВЫМ полем и проверяется ДО остальной схемы (см.
+     * `parseImportPackageManifest`): пакет завтрашней версии обязан получить
+     * внятный отказ, а не ворох ошибок валидации, из которых не видно, что дело
+     * в версии.
+     */
+    formatVersion: z.ZodNumber;
+    /**
+     * Машинное имя исходного сервиса (`confluence`). Входит в ключ
+     * идемпотентности: одинаковые `externalId` из разных сервисов — разные
+     * сущности, и без имени сервиса второй импорт «узнал» бы чужое.
+     */
+    source: z.ZodString;
+    /** Адрес инсталляции — на self-hosted сервисах одного имени сервиса мало. */
+    sourceUrl: z.ZodOptional<z.ZodString>;
+    /** Когда снят экспорт (не когда собран пакет) — по нему видно, насколько данные протухли. */
+    exportedAt: z.ZodOptional<z.ZodString>;
+    /** Чем собран пакет — чтобы по кривому импорту было видно, какой коннектор чинить. */
+    generator: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version?: string | undefined;
+    }, {
+        name: string;
+        version?: string | undefined;
+    }>>;
+    people: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        /** Логин в исходном сервисе — вторая зацепка, когда почты в экспорте нет. */
+        username: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        name: string;
+        email?: string | undefined;
+        username?: string | undefined;
+        avatarUrl?: string | undefined;
+    }, {
+        externalId: string;
+        name: string;
+        email?: string | undefined;
+        username?: string | undefined;
+        avatarUrl?: string | undefined;
+    }>, "many">>;
+    spaces: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        title: z.ZodString;
+        descriptionHtml: z.ZodOptional<z.ZodString>;
+        /** Ссылка на пространство в исходном сервисе — чтобы после переезда было куда вернуться. */
+        sourceUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        title: string;
+        descriptionHtml?: string | undefined;
+        sourceUrl?: string | undefined;
+    }, {
+        externalId: string;
+        title: string;
+        descriptionHtml?: string | undefined;
+        sourceUrl?: string | undefined;
+    }>, "many">>;
+    /**
+     * MOVE-28. Секция НЕОБЯЗАТЕЛЬНАЯ, и `.default([])` здесь — вся обратная
+     * совместимость: пакет Confluence и уже выкачанные пакеты Jira/YouTrack
+     * секции не знают, разбираются как раньше и получают пустой список.
+     * `formatVersion` по этой же причине не двигается — см. её комментарий:
+     * версия растёт на ЛОМАЮЩЕМ изменении формы.
+     */
+    sprints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        spaceId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        name: z.ZodString;
+        /** Цель итерации — короткий текст, который человек писал в трекере. */
+        goal: z.ZodOptional<z.ZodString>;
+        startsAt: z.ZodOptional<z.ZodString>;
+        endsAt: z.ZodOptional<z.ZodString>;
+        state: z.ZodEnum<["planned", "active", "completed"]>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        spaceId: string;
+        name: string;
+        goal?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+        state: "active" | "completed" | "planned";
+    }, {
+        externalId: string;
+        spaceId: string;
+        name: string;
+        goal?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+        state: "active" | "completed" | "planned";
+    }>, "many">>;
+    pages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        spaceId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>>;
+        title: z.ZodString;
+        /** Тело в HTML — см. про ProseMirror в шапке файла. */
+        bodyHtml: z.ZodString;
+        authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        /** Кто правил последним, если сервис это отдаёт, — иначе автор и правщик сливаются. */
+        lastEditorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        /** `externalId` вложений этой страницы — сами файлы в `attachments` манифеста. */
+        attachments: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, "many">>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        spaceId: string;
+        parentId?: string | null | undefined;
+        title: string;
+        bodyHtml: string;
+        authorId?: string | undefined;
+        lastEditorId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }, {
+        externalId: string;
+        spaceId: string;
+        parentId?: string | null | undefined;
+        title: string;
+        bodyHtml: string;
+        authorId?: string | undefined;
+        lastEditorId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }>, "many">>;
+    tasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        spaceId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>>;
+        title: z.ZodString;
+        descriptionHtml: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        priority: z.ZodOptional<z.ZodString>;
+        authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        assigneeId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        /**
+         * MOVE-28: в каком спринте задача — `externalId` из `sprints`. Необязателен
+         * дважды: у источника без спринтов их нет вовсе, и внутри источника со
+         * спринтами задача может лежать в бэклоге.
+         */
+        sprintId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        dueAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, "many">>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        spaceId?: string | undefined;
+        parentId?: string | null | undefined;
+        title: string;
+        descriptionHtml?: string | undefined;
+        status?: string | undefined;
+        priority?: string | undefined;
+        authorId?: string | undefined;
+        assigneeId?: string | undefined;
+        sprintId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        dueAt?: string | undefined;
+        completedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }, {
+        externalId: string;
+        spaceId?: string | undefined;
+        parentId?: string | null | undefined;
+        title: string;
+        descriptionHtml?: string | undefined;
+        status?: string | undefined;
+        priority?: string | undefined;
+        authorId?: string | undefined;
+        assigneeId?: string | undefined;
+        sprintId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        dueAt?: string | undefined;
+        completedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }>, "many">>;
+    comments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        on: z.ZodObject<{
+            kind: z.ZodEnum<["page", "task"]>;
+            id: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "page" | "task";
+            id: string;
+        }, {
+            kind: "page" | "task";
+            id: string;
+        }>;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>>;
+        authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        bodyHtml: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        on: {
+            kind: "page" | "task";
+            id: string;
+        };
+        parentId?: string | null | undefined;
+        authorId?: string | undefined;
+        bodyHtml: string;
+        createdAt: string;
+        updatedAt?: string | undefined;
+    }, {
+        externalId: string;
+        on: {
+            kind: "page" | "task";
+            id: string;
+        };
+        parentId?: string | null | undefined;
+        authorId?: string | undefined;
+        bodyHtml: string;
+        createdAt: string;
+        updatedAt?: string | undefined;
+    }>, "many">>;
+    attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        externalId: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        /** Относительный путь внутри пакета: `files/a3-scheme.png`. */
+        file: z.ZodEffects<z.ZodString, string, string>;
+        /** Как файл назывался у человека — `file` в пакете может быть обеззаражен коннектором. */
+        name: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        mime: z.ZodOptional<z.ZodString>;
+        byteSize: z.ZodOptional<z.ZodNumber>;
+        authorId: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        externalId: string;
+        file: string;
+        name?: string | undefined;
+        mime?: string | undefined;
+        byteSize?: number | undefined;
+        authorId?: string | undefined;
+        createdAt?: string | undefined;
+    }, {
+        externalId: string;
+        file: string;
+        name?: string | undefined;
+        mime?: string | undefined;
+        byteSize?: number | undefined;
+        authorId?: string | undefined;
+        createdAt?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    formatVersion: number;
+    source: string;
+    sourceUrl?: string | undefined;
+    exportedAt?: string | undefined;
+    generator?: {
+        name: string;
+        version?: string | undefined;
+    } | undefined;
+    people: {
+        externalId: string;
+        name: string;
+        email?: string | undefined;
+        username?: string | undefined;
+        avatarUrl?: string | undefined;
+    }[];
+    spaces: {
+        externalId: string;
+        title: string;
+        descriptionHtml?: string | undefined;
+        sourceUrl?: string | undefined;
+    }[];
+    sprints: {
+        externalId: string;
+        spaceId: string;
+        name: string;
+        goal?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+        state: "active" | "completed" | "planned";
+    }[];
+    pages: {
+        externalId: string;
+        spaceId: string;
+        parentId?: string | null | undefined;
+        title: string;
+        bodyHtml: string;
+        authorId?: string | undefined;
+        lastEditorId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }[];
+    tasks: {
+        externalId: string;
+        spaceId?: string | undefined;
+        parentId?: string | null | undefined;
+        title: string;
+        descriptionHtml?: string | undefined;
+        status?: string | undefined;
+        priority?: string | undefined;
+        authorId?: string | undefined;
+        assigneeId?: string | undefined;
+        sprintId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        dueAt?: string | undefined;
+        completedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }[];
+    comments: {
+        externalId: string;
+        on: {
+            kind: "page" | "task";
+            id: string;
+        };
+        parentId?: string | null | undefined;
+        authorId?: string | undefined;
+        bodyHtml: string;
+        createdAt: string;
+        updatedAt?: string | undefined;
+    }[];
+    attachments: {
+        externalId: string;
+        file: string;
+        name?: string | undefined;
+        mime?: string | undefined;
+        byteSize?: number | undefined;
+        authorId?: string | undefined;
+        createdAt?: string | undefined;
+    }[];
+}, {
+    formatVersion: number;
+    source: string;
+    sourceUrl?: string | undefined;
+    exportedAt?: string | undefined;
+    generator?: {
+        name: string;
+        version?: string | undefined;
+    } | undefined;
+    people?: {
+        externalId: string;
+        name: string;
+        email?: string | undefined;
+        username?: string | undefined;
+        avatarUrl?: string | undefined;
+    }[] | undefined;
+    spaces?: {
+        externalId: string;
+        title: string;
+        descriptionHtml?: string | undefined;
+        sourceUrl?: string | undefined;
+    }[] | undefined;
+    sprints?: {
+        externalId: string;
+        spaceId: string;
+        name: string;
+        goal?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+        state: "active" | "completed" | "planned";
+    }[] | undefined;
+    pages?: {
+        externalId: string;
+        spaceId: string;
+        parentId?: string | null | undefined;
+        title: string;
+        bodyHtml: string;
+        authorId?: string | undefined;
+        lastEditorId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }[] | undefined;
+    tasks?: {
+        externalId: string;
+        spaceId?: string | undefined;
+        parentId?: string | null | undefined;
+        title: string;
+        descriptionHtml?: string | undefined;
+        status?: string | undefined;
+        priority?: string | undefined;
+        authorId?: string | undefined;
+        assigneeId?: string | undefined;
+        sprintId?: string | undefined;
+        createdAt: string;
+        updatedAt?: string | undefined;
+        dueAt?: string | undefined;
+        completedAt?: string | undefined;
+        attachments?: string[] | undefined;
+        labels?: string[] | undefined;
+        sourceUrl?: string | undefined;
+    }[] | undefined;
+    comments?: {
+        externalId: string;
+        on: {
+            kind: "page" | "task";
+            id: string;
+        };
+        parentId?: string | null | undefined;
+        authorId?: string | undefined;
+        bodyHtml: string;
+        createdAt: string;
+        updatedAt?: string | undefined;
+    }[] | undefined;
+    attachments?: {
+        externalId: string;
+        file: string;
+        name?: string | undefined;
+        mime?: string | undefined;
+        byteSize?: number | undefined;
+        authorId?: string | undefined;
+        createdAt?: string | undefined;
+    }[] | undefined;
+}>;
+export type ImportPackageManifest = z.infer<typeof ImportPackageManifest>;
+/** Виды сущностей пакета — по ним же строится ключ идемпотентности. */
+export declare const IMPORT_ENTITY_KINDS: readonly ["person", "space", "sprint", "page", "task", "comment", "attachment"];
+export type ImportEntityKind = (typeof IMPORT_ENTITY_KINDS)[number];
+/**
+ * Вид сущности → список в манифесте. Таблицей, а не склейкой `kind + "s"`:
+ * у `person` список называется `people`, и правило «плюс s» тут врёт.
+ */
+export declare const IMPORT_ENTITY_FIELDS: Record<ImportEntityKind, keyof ImportPackageManifest>;
+/**
+ * КЛЮЧ ИДЕМПОТЕНТНОСТИ. Собирается ЗДЕСЬ и только здесь: ядро, коннектор и отчёт
+ * о прогоне обязаны считать его одинаково, иначе повторный прогон не узнает уже
+ * перенесённое и создаст второй экземпляр всего. Это тот же тройной ключ, что у
+ * `ImportedEntity` в спеке (`source`, `kind`, `externalId`).
+ *
+ * Разделитель `:` однозначен, потому что свободная часть ровно одна и она
+ * ПОСЛЕДНЯЯ: `source` ограничен `IMPORT_SOURCE_RE`, `kind` — фиксированный
+ * перечень, двоеточий в них не бывает. `externalId` может содержать что угодно
+ * (в Notion как раз двоеточия) — на хвосте это разбор не ломает.
+ *
+ * Ключ ПЕЧАТНЫЙ — это КОНТРАКТ, и держится он не здесь: сама функция всего лишь
+ * склейка и вход не проверяет. Печатность обеспечивают `IMPORT_SOURCE_RE` и
+ * запрет невидимых символов в `ImportExternalId` (`IMPORT_INVISIBLE_CHARS_RE` —
+ * управляющие, zero-width, bidi, разрывы строк); звать ключ на строках, не
+ * прошедших схему, значит остаться без этой гарантии. Нужна она затем, что ключ
+ * поедет в колонку БД, в лог прогона и на экран карантина: Postgres не хранит
+ * NUL в `text`, а два ключа, различающиеся невидимым символом, человек не
+ * различит и в глаза.
+ */
+export declare function importEntityKey(source: string, kind: ImportEntityKind, externalId: string): string;
+/** Почему пакет не принят. */
+export type ImportPackageRejection = 
+/** Версия формата новее, чем понимает это ядро, — читать нельзя, гадать тем более. */
+{
+    reason: "unsupported_version";
+    version: number;
+    supported: readonly number[];
+    message: string;
+}
+/** Версии нет вовсе или она не число — это не пакет импорта. */
+ | {
+    reason: "missing_version";
+    message: string;
+}
+/** Версия наша, но форма не сходится — обычный отказ валидации. */
+ | {
+    reason: "invalid";
+    issues: z.ZodIssue[];
+    message: string;
+};
+export type ImportPackageParseResult = {
+    ok: true;
+    manifest: ImportPackageManifest;
+} | {
+    ok: false;
+    error: ImportPackageRejection;
+};
+export declare function isSupportedImportPackageVersion(version: number): boolean;
+/**
+ * Сырой JSON манифеста → типизированный манифест или ВНЯТНЫЙ ОТКАЗ.
+ *
+ * Версия смотрится ДО схемы намеренно. Если бы `formatVersion` был просто
+ * `z.literal(1)`, пакет завтрашнего коннектора отвалился бы наравне с битым
+ * JSON — и человек, глядя на список ошибок полей, чинил бы не то.
+ *
+ * Не бросает: пакет приходит извне, и ядру нужен отказ, который можно положить в
+ * карантин и показать человеку, а не исключение.
+ */
+export declare function parseImportPackageManifest(raw: unknown): ImportPackageParseResult;
+/** Изъян связности пакета: схема прошла, но ссылки внутри никуда не ведут. */
+export type ImportPackageProblem = {
+    kind: ImportEntityKind;
+    externalId: string;
+    /** `duplicate_external_id` ломает идемпотентность, `dangling_ref` — целостность. */
+    problem: "duplicate_external_id" | "dangling_ref";
+    /** Какое поле указывает в пустоту (для `dangling_ref`). */
+    field?: string;
+    message: string;
+};
+/**
+ * Проверка СВЯЗНОСТИ — то, что Zod не ловит по устройству: он проверяет каждую
+ * сущность отдельно, а пакет ломается на связях между ними.
+ *
+ * Ловит две вещи, и обе про идемпотентность:
+ *  • повторный `externalId` внутри вида — ключ перестаёт быть ключом, и
+ *    повторный прогон будет находить то одну сущность, то другую;
+ *  • ссылку в никуда (родитель, автор, пространство, владелец, вложение) — ядру
+ *    нечего с ней делать, а молча уронить связь значит потерять кусок дерева и
+ *    узнать об этом от человека через неделю.
+ *
+ * Отдаёт СПИСОК, а не бросает: пакет с десятком висячих ссылок должен уехать в
+ * карантин целиком и показаться человеку одним экраном. Что делать с проблемами
+ * — решает ядро (MOVE-11).
+ */
+export declare function checkImportPackageRefs(manifest: ImportPackageManifest): ImportPackageProblem[];
+/**
+ * Пути файлов, которые обязаны лежать в пакете. Ядру нужно ДО раскладки понять,
+ * полон ли пакет: недостающий файл на середине прогона — это половина импорта и
+ * ручная уборка.
+ */
+export declare function importPackageFilePaths(manifest: ImportPackageManifest): string[];