@escapenavigator/types 2.1.6 → 2.1.8

package/dist/integrations/connect-integration.dto.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateIntegrationRequestDto = exports.ToggleIntegrationDto = exports.MatchIntegrationResourceDto = exports.ConnectIntegrationDto = void 0;
+const class_validator_1 = require("class-validator");
+const provider_code_enum_1 = require("./provider-code.enum");
+/** Самостоятельное подключение своей системы из кабинета квеста. */
+class ConnectIntegrationDto {
+}
+exports.ConnectIntegrationDto = ConnectIntegrationDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(provider_code_enum_1.IntegrationProviderCodeEnum),
+    __metadata("design:type", String)
+], ConnectIntegrationDto.prototype, "providerCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], ConnectIntegrationDto.prototype, "title", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], ConnectIntegrationDto.prototype, "credentials", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ConnectIntegrationDto.prototype, "questroomId", void 0);
+/**
+ * Подтверждение соответствия комнаты. `questroomId: null` означает «такой
+ * комнаты у меня нет» — она перестаёт предлагаться и в каталог не идёт.
+ */
+class MatchIntegrationResourceDto {
+}
+exports.MatchIntegrationResourceDto = MatchIntegrationResourceDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], MatchIntegrationResourceDto.prototype, "questroomId", void 0);
+class ToggleIntegrationDto {
+}
+exports.ToggleIntegrationDto = ToggleIntegrationDto;
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ToggleIntegrationDto.prototype, "enabled", void 0);
+/** Заявка «подключите меня сами» для систем без готового коннектора. */
+class CreateIntegrationRequestDto {
+}
+exports.CreateIntegrationRequestDto = CreateIntegrationRequestDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], CreateIntegrationRequestDto.prototype, "systemName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateIntegrationRequestDto.prototype, "bookingPageUrl", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], CreateIntegrationRequestDto.prototype, "contactName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], CreateIntegrationRequestDto.prototype, "contactEmail", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CreateIntegrationRequestDto.prototype, "contactPhone", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2000),
+    __metadata("design:type", String)
+], CreateIntegrationRequestDto.prototype, "comment", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], CreateIntegrationRequestDto.prototype, "credentials", void 0);

package/dist/integrations/connection-status.enum.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Состояние подключения. Различать «настраивается», «работает» и «сломалось»
+ * обязательно на уровне данных: от статуса зависит, показываем ли мы слоты
+ * игроку и будим ли поддержку.
+ */
+export declare enum IntegrationConnectionStatusEnum {
+    /** Квест начал настройку, но проверка креденшелов ещё не прошла. */
+    DRAFT = "draft",
+    /**
+     * Ждёт нашего действия: одобрения приложения у вендора, статуса канала,
+     * ручной привязки квестов к каталогу. Квесту показываем понятное «мы
+     * работаем над этим», а не ошибку.
+     */
+    PENDING = "pending",
+    /** Работает: расписание отдаётся, брони уезжают. */
+    ACTIVE = "active",
+    /**
+     * Ошибки идут, но подключение ещё не отключено: часть вызовов проходит.
+     * Слоты показываем, режим при этом может деградировать до `request`.
+     */
+    DEGRADED = "degraded",
+    /**
+     * Не работает: креденшелы отозваны, вендор отвечает отказом, контракт
+     * изменился. Слоты не показываем — лучше пустое расписание, чем бронь,
+     * которая не доедет.
+     */
+    FAILED = "failed",
+    /** Выключено владельцем или нами. Связи с каталогом при этом не рвутся. */
+    DISABLED = "disabled"
+}

package/dist/integrations/connection-status.enum.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationConnectionStatusEnum = void 0;
+/**
+ * Состояние подключения. Различать «настраивается», «работает» и «сломалось»
+ * обязательно на уровне данных: от статуса зависит, показываем ли мы слоты
+ * игроку и будим ли поддержку.
+ */
+var IntegrationConnectionStatusEnum;
+(function (IntegrationConnectionStatusEnum) {
+    /** Квест начал настройку, но проверка креденшелов ещё не прошла. */
+    IntegrationConnectionStatusEnum["DRAFT"] = "draft";
+    /**
+     * Ждёт нашего действия: одобрения приложения у вендора, статуса канала,
+     * ручной привязки квестов к каталогу. Квесту показываем понятное «мы
+     * работаем над этим», а не ошибку.
+     */
+    IntegrationConnectionStatusEnum["PENDING"] = "pending";
+    /** Работает: расписание отдаётся, брони уезжают. */
+    IntegrationConnectionStatusEnum["ACTIVE"] = "active";
+    /**
+     * Ошибки идут, но подключение ещё не отключено: часть вызовов проходит.
+     * Слоты показываем, режим при этом может деградировать до `request`.
+     */
+    IntegrationConnectionStatusEnum["DEGRADED"] = "degraded";
+    /**
+     * Не работает: креденшелы отозваны, вендор отвечает отказом, контракт
+     * изменился. Слоты не показываем — лучше пустое расписание, чем бронь,
+     * которая не доедет.
+     */
+    IntegrationConnectionStatusEnum["FAILED"] = "failed";
+    /** Выключено владельцем или нами. Связи с каталогом при этом не рвутся. */
+    IntegrationConnectionStatusEnum["DISABLED"] = "disabled";
+})(IntegrationConnectionStatusEnum || (exports.IntegrationConnectionStatusEnum = IntegrationConnectionStatusEnum = {}));

package/dist/integrations/connector-capabilities.d.ts

@@ -0,0 +1,85 @@
+import { IntegrationBookingModeEnum } from './booking-mode.enum';
+/**
+ * Что коннектор умеет. Читается вызывающим кодом **до** вызова, чтобы
+ * `IntegrationGateway` не выяснял возможности методом «попробовать и поймать
+ * исключение»: у чужих API ошибка «не поддерживается» неотличима от ошибки
+ * «сломалось», и на второй мы обязаны поднимать инцидент, а на первую — нет.
+ */
+export type ConnectorCapabilities = {
+    /**
+     * Режимы, которые провайдер вообще может обеспечить. Конкретный режим
+     * подключения выбирается из этого набора: у квеста без write-доступа
+     * останется только `REQUEST`, даже если провайдер умеет `INSTANT`.
+     */
+    bookingModes: IntegrationBookingModeEnum[];
+    /** Можно перечислить квесты/продукты аккаунта для автопривязки к каталогу. */
+    canListResources: boolean;
+    /**
+     * На что выдаются доступы.
+     *
+     * `account` (по умолчанию) — один ключ открывает весь аккаунт вендора, и у
+     * профиля одно подключение на систему: комнаты приходят списком.
+     *
+     * `resource` — доступ выдаётся на одну комнату (у MyERP-совместимых систем
+     * это персональный URL расписания с токеном в query). Тогда подключений у
+     * профиля столько, сколько комнат, и мастер обязан спросить, к какому нашему
+     * квесту относится введённый адрес: перечислить каталог вендора нельзя, а
+     * молча повесить второй адрес на то же подключение — значит затереть
+     * настроенную комнату.
+     */
+    connectionScope?: 'account' | 'resource';
+    /**
+     * Можно перепроверить один слот перед бронью. Без этого между показом
+     * расписания и нажатием «забронировать» мы работаем на кеше и рискуем
+     * двойной бронью.
+     */
+    canCheckSlot: boolean;
+    /**
+     * Перепроверка одного слота стоит вендору один запрос.
+     *
+     * Различать это обязательно, потому что `canCheckSlot` не говорит о цене
+     * вопроса. У OCTO и Regiondo есть ручка на конкретное время — спросить дёшево,
+     * и на клике по слоту это оправдано. У MyERP-совместимых систем такой ручки
+     * нет вовсе: «проверить слот» разворачивается в чтение всего расписания плюс
+     * тарифы, то есть два запроса в чужую CRM на каждый клик по времени. Живых
+     * MyERP-квестов больше двухсот, и они получили бы эту плату за данные, которые
+     * уже приехали вместе с расписанием.
+     *
+     * Не указано — считаем `false`: лишний запрос в чужую систему хуже, чем
+     * отсутствие уточнения, а провайдер с дешёвой проверкой скажет об этом сам.
+     */
+    singleSlotCheck?: boolean;
+    /** Можно отменить бронь по нашему идемпотентному ключу. */
+    canCancel: boolean;
+    /**
+     * Цену слота видно только внутри hold (так у Bookeo): значит показывать
+     * итоговую сумму до шага удержания нельзя.
+     */
+    priceRequiresHold: boolean;
+    /** Провайдер присылает вебхуки об изменениях на своей стороне. */
+    hasWebhooks: boolean;
+    /**
+     * Насколько вперёд провайдер отдаёт расписание, в днях. Наш горизонт
+     * показа не может быть больше.
+     */
+    scheduleHorizonDays: number;
+    /**
+     * Максимум дней в одном запросе расписания. Больше — разбиваем на
+     * несколько вызовов, а не молча теряем хвост.
+     */
+    maxRangeDaysPerRequest?: number;
+    /**
+     * Сколько у квеста времени на подтверждение заявки в режиме `REQUEST`.
+     * По истечении — инцидент `confirmation_timeout` и извинения игроку.
+     */
+    confirmationTimeoutMinutes?: number;
+    /**
+     * Ограничение частоты, которое декларирует вендор. Нужно gateway, чтобы
+     * не выгрести бан на аккаунт квеста: у Resova и Xola лимиты на ключ.
+     */
+    rateLimit?: {
+        requestsPerMinute: number;
+        /** Лимит общий на аккаунт вендора, а не на наше подключение. */
+        perAccount?: boolean;
+    };
+};

package/dist/integrations/connector-capabilities.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/integrations/credential-field.d.ts

@@ -0,0 +1,80 @@
+import { IntegrationProviderCodeEnum } from './provider-code.enum';
+/**
+ * Описание одного поля, которое квест заполняет при подключении. Мастер в CRM
+ * и форма в админке рисуются из этого списка, а не хардкодят провайдеров:
+ * добавить коннектор должно значить «написать коннектор», а не «дописать
+ * четыре формы».
+ */
+export type CredentialFieldType = 
+/** Обычная строка. */
+'text'
+/** URL: валидируем схему и хост, показываем как ссылку. */
+ | 'url'
+/**
+ * Секрет. В UI — поле с маскированием, в ответах API **никогда не
+ * возвращается целиком** (только последние символы), в логах проходит через
+ * `redactIntegrationPayload`.
+ */
+ | 'secret'
+/** Выбор из фиксированного списка `options`. */
+ | 'select'
+/** Галка: например, согласие квеста на комиссию вендора. */
+ | 'checkbox';
+export type CredentialField = {
+    /** Ключ в объекте креденшелов подключения. */
+    key: string;
+    type: CredentialFieldType;
+    /** Подпись для квеста. Человеческая, без наших внутренних терминов. */
+    label: string;
+    required: boolean;
+    /** Короткая подсказка под полем. */
+    hint?: string;
+    placeholder?: string;
+    /** Для `select`. */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /**
+     * Регулярка для проверки на клиенте — как строка, чтобы контракт
+     * оставался сериализуемым и уезжал в CRM вместе с JSON.
+     */
+    pattern?: string;
+    /**
+     * Где владельцу взять это значение: «Settings → Company Settings → API →
+     * Create API». Без такой инструкции self-service не работает — квест
+     * упирается в поле «API key» и пишет в поддержку.
+     */
+    whereToFind?: string;
+};
+/**
+ * Всё, что нужно UI, чтобы показать провайдера в списке доступных подключений.
+ */
+export type ProviderDescriptor = {
+    code: IntegrationProviderCodeEnum;
+    /** Название так, как его знает владелец квеста. */
+    title: string;
+    /** Логотип для карточки в мастере подключения. */
+    logoUrl?: string;
+    /** Поля формы подключения. */
+    credentials: CredentialField[];
+    /**
+     * Ссылка на нашу инструкцию по этому провайдеру. Обязательна: любое новое
+     * подключение сопровождается инструкцией и для квеста, и для админа.
+     */
+    docsUrl?: string;
+    /**
+     * Может ли квест подключиться сам, без нашего участия. `false` означает,
+     * что нужен ручной шаг с нашей стороны (одобрение приложения у вендора,
+     * статус канала) — и тогда мастер сразу предлагает оставить заявку, а не
+     * ведёт в форму, которая всё равно упрётся.
+     */
+    selfServe: boolean;
+    /**
+     * Предупреждение, которое обязательно показать до подключения. Пример:
+     * FareHarbor тарифицирует партнёрские брони, и владелец включает списание
+     * комиссии сам — про это он должен прочитать в мастере, а не узнать из
+     * счёта.
+     */
+    warning?: string;
+};

package/dist/integrations/credential-field.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/integrations/crm-integration-status.ro.d.ts

@@ -0,0 +1,70 @@
+import { IntegrationBookingModeEnum } from './booking-mode.enum';
+import { IntegrationProviderCodeEnum } from './provider-code.enum';
+/**
+ * Состояние интеграции на языке владельца квеста.
+ *
+ * Отдельный перечень вместо `IntegrationConnectionStatusEnum` нужен потому, что
+ * технический статус отвечает на вопрос «что с подключением», а владельцу квеста
+ * важен другой: «идут ли ко мне игроки и должен ли я что-то сделать».
+ * `degraded` и `failed` для него одинаковы — записи нет; зато `failed` из-за
+ * отозванного ключа и `failed` из-за упавшего вендора требуют разного, хотя
+ * технический статус у них один.
+ */
+export declare enum CrmIntegrationStateEnum {
+    /** Записи идут, делать ничего не нужно. */
+    WORKS = "works",
+    /** Подключение начато, но не доведено до конца — ждёт самого квеста. */
+    SETUP_NEEDED = "setup_needed",
+    /** Мы проверяем данные доступа, ответ будет в течение часа. */
+    CHECKING = "checking",
+    /** Работает, но с перебоями: часть игроков может не увидеть расписание. */
+    ATTENTION = "attention",
+    /** Записи нет. Требуется действие квеста или наша помощь. */
+    BROKEN = "broken",
+    /** Выключено — по просьбе квеста или нами. */
+    OFF = "off"
+}
+/** Что владельцу квеста сделать. `none` — ничего, всё в порядке. */
+export declare enum CrmIntegrationActionEnum {
+    NONE = "none",
+    /** Закончить подключение в мастере. */
+    FINISH_SETUP = "finish_setup",
+    /** Обновить данные доступа: ключ отозван или истёк. */
+    RECONNECT = "reconnect",
+    /** Подтвердить, какие комнаты соответствуют комнатам в его системе. */
+    MATCH_ROOMS = "match_rooms",
+    /** Ничего не делать, проблема на стороне его системы — мы уже занимаемся. */
+    WAIT = "wait",
+    /** Написать нам: без человека не разобраться. */
+    CONTACT_SUPPORT = "contact_support"
+}
+export type CrmIntegrationStatus = {
+    connectionId: number | null;
+    providerCode: IntegrationProviderCodeEnum | null;
+    /** Название системы так, как её называет сам квест. */
+    providerTitle: string;
+    state: CrmIntegrationStateEnum;
+    /** Одна строка, которую видно в списке. Без технических терминов. */
+    headline: string;
+    /** Пояснение на два-три предложения: что происходит и почему. */
+    detail: string;
+    action: CrmIntegrationActionEnum;
+    /** Подпись кнопки под `action`. Пусто, если действий не требуется. */
+    actionLabel: string;
+    bookingMode: IntegrationBookingModeEnum | null;
+    /**
+     * Понятная формулировка режима: «запись подтверждается сразу» против
+     * «заявку подтверждаете вы». Квест должен понимать, чего от него ждут.
+     */
+    bookingModeLabel: string;
+    /** Сколько комнат показывается на агрегаторе. */
+    roomsOnline: number;
+    /** Сколько комнат ждут подтверждения соответствия. */
+    roomsWaitingMatch: number;
+    /** Когда расписание обновлялось в последний раз, человеческой фразой. */
+    scheduleUpdatedText: string;
+    /** Броней получено за последние 30 дней — главный аргумент «оно работает». */
+    bookings30d: number;
+    /** С какого момента проблема, если она есть. */
+    problemSince: string | null;
+};

package/dist/integrations/crm-integration-status.ro.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrmIntegrationActionEnum = exports.CrmIntegrationStateEnum = void 0;
+/**
+ * Состояние интеграции на языке владельца квеста.
+ *
+ * Отдельный перечень вместо `IntegrationConnectionStatusEnum` нужен потому, что
+ * технический статус отвечает на вопрос «что с подключением», а владельцу квеста
+ * важен другой: «идут ли ко мне игроки и должен ли я что-то сделать».
+ * `degraded` и `failed` для него одинаковы — записи нет; зато `failed` из-за
+ * отозванного ключа и `failed` из-за упавшего вендора требуют разного, хотя
+ * технический статус у них один.
+ */
+var CrmIntegrationStateEnum;
+(function (CrmIntegrationStateEnum) {
+    /** Записи идут, делать ничего не нужно. */
+    CrmIntegrationStateEnum["WORKS"] = "works";
+    /** Подключение начато, но не доведено до конца — ждёт самого квеста. */
+    CrmIntegrationStateEnum["SETUP_NEEDED"] = "setup_needed";
+    /** Мы проверяем данные доступа, ответ будет в течение часа. */
+    CrmIntegrationStateEnum["CHECKING"] = "checking";
+    /** Работает, но с перебоями: часть игроков может не увидеть расписание. */
+    CrmIntegrationStateEnum["ATTENTION"] = "attention";
+    /** Записи нет. Требуется действие квеста или наша помощь. */
+    CrmIntegrationStateEnum["BROKEN"] = "broken";
+    /** Выключено — по просьбе квеста или нами. */
+    CrmIntegrationStateEnum["OFF"] = "off";
+})(CrmIntegrationStateEnum || (exports.CrmIntegrationStateEnum = CrmIntegrationStateEnum = {}));
+/** Что владельцу квеста сделать. `none` — ничего, всё в порядке. */
+var CrmIntegrationActionEnum;
+(function (CrmIntegrationActionEnum) {
+    CrmIntegrationActionEnum["NONE"] = "none";
+    /** Закончить подключение в мастере. */
+    CrmIntegrationActionEnum["FINISH_SETUP"] = "finish_setup";
+    /** Обновить данные доступа: ключ отозван или истёк. */
+    CrmIntegrationActionEnum["RECONNECT"] = "reconnect";
+    /** Подтвердить, какие комнаты соответствуют комнатам в его системе. */
+    CrmIntegrationActionEnum["MATCH_ROOMS"] = "match_rooms";
+    /** Ничего не делать, проблема на стороне его системы — мы уже занимаемся. */
+    CrmIntegrationActionEnum["WAIT"] = "wait";
+    /** Написать нам: без человека не разобраться. */
+    CrmIntegrationActionEnum["CONTACT_SUPPORT"] = "contact_support";
+})(CrmIntegrationActionEnum || (exports.CrmIntegrationActionEnum = CrmIntegrationActionEnum = {}));

package/dist/integrations/incident-status.enum.d.ts

@@ -0,0 +1,31 @@
+export declare enum IntegrationIncidentStatusEnum {
+    /** Открыт: проблема продолжается. */
+    OPEN = "open",
+    /**
+     * Взят в работу: поддержка увидела и связывается с квестом. Отдельный
+     * статус нужен, чтобы повторные алерты по одному и тому же инциденту не
+     * шли в чат каждые пять минут.
+     */
+    ACKNOWLEDGED = "acknowledged",
+    /** Починено: вызовы снова проходят. */
+    RESOLVED = "resolved",
+    /**
+     * Закрыт как ожидаемый: квест сам закрыл площадку, вендор объявил
+     * плановые работы. Из статистики здоровья такие исключаются, иначе
+     * подключение выглядит битым без причины.
+     */
+    IGNORED = "ignored"
+}
+/**
+ * Severity отвечает ровно на один вопрос: будить ли человека сейчас. Поэтому
+ * значений три, а не пять — иначе выбор превращается в вкусовщину, и всё
+ * уезжает в середину шкалы.
+ */
+export declare enum IntegrationIncidentSeverityEnum {
+    /** Игрок уже пострадал: бронь не доехала, заявка просрочена. Алерт сразу. */
+    CRITICAL = "critical",
+    /** Подключение сломано, брони пока не терялись. Алерт в рабочее время. */
+    WARNING = "warning",
+    /** Симптом на будущее: растут таймауты, вендор начал ограничивать частоту. */
+    INFO = "info"
+}

package/dist/integrations/incident-status.enum.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationIncidentSeverityEnum = exports.IntegrationIncidentStatusEnum = void 0;
+var IntegrationIncidentStatusEnum;
+(function (IntegrationIncidentStatusEnum) {
+    /** Открыт: проблема продолжается. */
+    IntegrationIncidentStatusEnum["OPEN"] = "open";
+    /**
+     * Взят в работу: поддержка увидела и связывается с квестом. Отдельный
+     * статус нужен, чтобы повторные алерты по одному и тому же инциденту не
+     * шли в чат каждые пять минут.
+     */
+    IntegrationIncidentStatusEnum["ACKNOWLEDGED"] = "acknowledged";
+    /** Починено: вызовы снова проходят. */
+    IntegrationIncidentStatusEnum["RESOLVED"] = "resolved";
+    /**
+     * Закрыт как ожидаемый: квест сам закрыл площадку, вендор объявил
+     * плановые работы. Из статистики здоровья такие исключаются, иначе
+     * подключение выглядит битым без причины.
+     */
+    IntegrationIncidentStatusEnum["IGNORED"] = "ignored";
+})(IntegrationIncidentStatusEnum || (exports.IntegrationIncidentStatusEnum = IntegrationIncidentStatusEnum = {}));
+/**
+ * Severity отвечает ровно на один вопрос: будить ли человека сейчас. Поэтому
+ * значений три, а не пять — иначе выбор превращается в вкусовщину, и всё
+ * уезжает в середину шкалы.
+ */
+var IntegrationIncidentSeverityEnum;
+(function (IntegrationIncidentSeverityEnum) {
+    /** Игрок уже пострадал: бронь не доехала, заявка просрочена. Алерт сразу. */
+    IntegrationIncidentSeverityEnum["CRITICAL"] = "critical";
+    /** Подключение сломано, брони пока не терялись. Алерт в рабочее время. */
+    IntegrationIncidentSeverityEnum["WARNING"] = "warning";
+    /** Симптом на будущее: растут таймауты, вендор начал ограничивать частоту. */
+    IntegrationIncidentSeverityEnum["INFO"] = "info";
+})(IntegrationIncidentSeverityEnum || (exports.IntegrationIncidentSeverityEnum = IntegrationIncidentSeverityEnum = {}));

package/dist/integrations/incident-type.enum.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Тип инцидента. Тип определяет и текст алерта, и раздел в ранбуке
+ * (`docs/integrations-v2/ui-admin.md`): поддержка должна понимать, что делать,
+ * из самого уведомления, а не идти разбираться в логах.
+ */
+export declare enum IntegrationIncidentTypeEnum {
+    /** Креденшелы отозваны или истекли: 401/403 от вендора. */
+    AUTH_FAILED = "auth_failed",
+    /** Вендор недоступен: таймауты, 5xx, обрывы. */
+    PROVIDER_DOWN = "provider_down",
+    /**
+     * Ответ пришёл, но не той формы: пропало поле, поменялся тип, сменился
+     * формат даты. Для storefront-коннекторов — основной риск, потому что у них
+     * нет контракта, есть только вёрстка.
+     */
+    CONTRACT_VIOLATION = "contract_violation",
+    /** Расписание отдаётся, но пустое дольше допустимого. */
+    EMPTY_SCHEDULE = "empty_schedule",
+    /** Бронь не доехала после всех попыток. Самый дорогой инцидент. */
+    BOOKING_FAILED = "booking_failed",
+    /** Заявка в режиме `request` не подтверждена квестом за отведённое время. */
+    CONFIRMATION_TIMEOUT = "confirmation_timeout",
+    /** Вендор ограничил частоту: рискуем баном ключа квеста. */
+    RATE_LIMITED = "rate_limited",
+    /**
+     * Ресурс пропал из выдачи вендора, а к нему привязан наш квест: страница
+     * показывает расписание, которого больше нет.
+     */
+    RESOURCE_GONE = "resource_gone"
+}

package/dist/integrations/incident-type.enum.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationIncidentTypeEnum = void 0;
+/**
+ * Тип инцидента. Тип определяет и текст алерта, и раздел в ранбуке
+ * (`docs/integrations-v2/ui-admin.md`): поддержка должна понимать, что делать,
+ * из самого уведомления, а не идти разбираться в логах.
+ */
+var IntegrationIncidentTypeEnum;
+(function (IntegrationIncidentTypeEnum) {
+    /** Креденшелы отозваны или истекли: 401/403 от вендора. */
+    IntegrationIncidentTypeEnum["AUTH_FAILED"] = "auth_failed";
+    /** Вендор недоступен: таймауты, 5xx, обрывы. */
+    IntegrationIncidentTypeEnum["PROVIDER_DOWN"] = "provider_down";
+    /**
+     * Ответ пришёл, но не той формы: пропало поле, поменялся тип, сменился
+     * формат даты. Для storefront-коннекторов — основной риск, потому что у них
+     * нет контракта, есть только вёрстка.
+     */
+    IntegrationIncidentTypeEnum["CONTRACT_VIOLATION"] = "contract_violation";
+    /** Расписание отдаётся, но пустое дольше допустимого. */
+    IntegrationIncidentTypeEnum["EMPTY_SCHEDULE"] = "empty_schedule";
+    /** Бронь не доехала после всех попыток. Самый дорогой инцидент. */
+    IntegrationIncidentTypeEnum["BOOKING_FAILED"] = "booking_failed";
+    /** Заявка в режиме `request` не подтверждена квестом за отведённое время. */
+    IntegrationIncidentTypeEnum["CONFIRMATION_TIMEOUT"] = "confirmation_timeout";
+    /** Вендор ограничил частоту: рискуем баном ключа квеста. */
+    IntegrationIncidentTypeEnum["RATE_LIMITED"] = "rate_limited";
+    /**
+     * Ресурс пропал из выдачи вендора, а к нему привязан наш квест: страница
+     * показывает расписание, которого больше нет.
+     */
+    IntegrationIncidentTypeEnum["RESOURCE_GONE"] = "resource_gone";
+})(IntegrationIncidentTypeEnum || (exports.IntegrationIncidentTypeEnum = IntegrationIncidentTypeEnum = {}));

package/dist/integrations/integration-request-status.enum.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Состояние заявки «подключите меня сами» — кнопки, через которую квест
+ * передаёт данные нашему разработчику вместо самостоятельной настройки.
+ */
+export declare enum IntegrationRequestStatusEnum {
+    /** Заявка создана, мы её ещё не смотрели. */
+    NEW = "new",
+    /** Данных не хватает: ждём ответа квеста. */
+    NEED_INFO = "need_info",
+    /** Взята в работу. */
+    IN_PROGRESS = "in_progress",
+    /**
+     * Ждём вендора: запросили доступ к API, статус канала, одобрение
+     * приложения. Отдельный статус, потому что ожидание тут измеряется
+     * неделями и это не наша задержка — но квесту всё равно надо отвечать.
+     */
+    WAITING_VENDOR = "waiting_vendor",
+    /** Подключение создано и работает. */
+    DONE = "done",
+    /** Отказ: система не поддаётся интеграции или квест передумал. */
+    REJECTED = "rejected"
+}