@escapenavigator/types 2.1.6 → 2.1.8

package/dist/integrations/integration-request-status.enum.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationRequestStatusEnum = void 0;
+/**
+ * Состояние заявки «подключите меня сами» — кнопки, через которую квест
+ * передаёт данные нашему разработчику вместо самостоятельной настройки.
+ */
+var IntegrationRequestStatusEnum;
+(function (IntegrationRequestStatusEnum) {
+    /** Заявка создана, мы её ещё не смотрели. */
+    IntegrationRequestStatusEnum["NEW"] = "new";
+    /** Данных не хватает: ждём ответа квеста. */
+    IntegrationRequestStatusEnum["NEED_INFO"] = "need_info";
+    /** Взята в работу. */
+    IntegrationRequestStatusEnum["IN_PROGRESS"] = "in_progress";
+    /**
+     * Ждём вендора: запросили доступ к API, статус канала, одобрение
+     * приложения. Отдельный статус, потому что ожидание тут измеряется
+     * неделями и это не наша задержка — но квесту всё равно надо отвечать.
+     */
+    IntegrationRequestStatusEnum["WAITING_VENDOR"] = "waiting_vendor";
+    /** Подключение создано и работает. */
+    IntegrationRequestStatusEnum["DONE"] = "done";
+    /** Отказ: система не поддаётся интеграции или квест передумал. */
+    IntegrationRequestStatusEnum["REJECTED"] = "rejected";
+})(IntegrationRequestStatusEnum || (exports.IntegrationRequestStatusEnum = IntegrationRequestStatusEnum = {}));

package/dist/integrations/normalized-slot.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Слот в едином внутреннем виде: то, что коннектор обязан вернуть, независимо
+ * от того, откуда данные — из нашей CRM, из Bookeo, из MyERP или из Partner
+ * API. Из него собирается `OpenapiSlotRO` для виджета и `MortyTimeslotRO` для
+ * исходящих партнёрских API, так что здесь должно быть достаточно полей для
+ * обоих.
+ *
+ * **Деньги — всегда в минорных единицах** (копейки/центы), как везде внутри
+ * проекта. Внешние системы отдают мажорные, и переводить их обязан коннектор
+ * на своей границе через `externalPriceToMinorUnits`. Эта строчка — не
+ * формальность: непереведённая цена уже приводила и к «от 51 руб.» вместо
+ * «от 5100 руб.» в виджете, и к брони на 350 000 ₽ вместо 3 500 ₽ в CRM
+ * квеста (см. `external-price.ts` и ретрай в `aggregator-order.service.ts`).
+ */
+export type NormalizedSlotStatus = 
+/** Свободен, можно бронировать. */
+'free'
+/** Занят, прошёл дедлайн, нет ресурсов — забронировать нельзя. */
+ | 'busy'
+/** Только по телефону: показываем, но онлайн-бронь недоступна. */
+ | 'call'
+/** Слот держится под конкретного игрока (hold). */
+ | 'hold';
+export type NormalizedSlotPrice = {
+    /** Размер группы, для которого действует цена. */
+    players: number;
+    /** Цена за всю группу, минорные единицы. */
+    price: number;
+};
+export type NormalizedSlot = {
+    /**
+     * Идентификатор слота во внешней системе — с ним же уходит бронь. Строка,
+     * потому что у разных систем это и число, и UUID, и составной ключ.
+     * Обязан быть уникальным в пределах подключения, иначе бронь уедет в чужой
+     * слот: у MyERP это `quest_time_id`, у Bookeo `eventId`, у Partner API
+     * `timeslot.id`.
+     */
+    externalSlotId: string;
+    /** Ресурс (квест/продукт) внешней системы, к которому относится слот. */
+    externalResourceId: string;
+    /** Локальная дата игры, `yyyy-MM-dd`. */
+    date: string;
+    /** Локальное время начала и конца, `HH:mm`. */
+    start: string;
+    end?: string;
+    /**
+     * Момент начала в UTC. Нужен отдельно от `date`/`start`: сравнивать слоты
+     * между часовыми поясами по локальному времени нельзя.
+     */
+    startAt?: string;
+    /** IANA-таймзона площадки, например `Europe/London`. */
+    timezone?: string;
+    durationMinutes?: number;
+    status: NormalizedSlotStatus;
+    /** Минимальная цена за группу, минорные единицы. */
+    basePrice?: number;
+    /** Цены по размерам групп, минорные единицы. */
+    prices?: NormalizedSlotPrice[];
+    /** ISO 4217, например `EUR`. */
+    currency?: string;
+    seatsAvailable?: number;
+    playersMin?: number;
+    playersMax?: number;
+    /** Приватная (эксклюзивная) игра. */
+    privateEvent?: boolean;
+    /**
+     * Крайний момент приёма брони, UTC ISO. `null` — отсечки нет. Слот с
+     * прошедшим дедлайном отдаём со статусом `busy`, а не выкидываем: игрок
+     * должен видеть, что игра существует, но записаться уже нельзя.
+     */
+    deadline?: string | null;
+    /**
+     * Сырой ответ внешней системы по этому слоту. Только для диагностики
+     * инцидентов; **бизнес-логика не имеет права его читать**, иначе
+     * абстракция протекает и коннекторы перестают быть взаимозаменяемыми.
+     * Перед записью в журнал проходит через `redactIntegrationPayload`.
+     */
+    raw?: unknown;
+};

package/dist/integrations/normalized-slot.js

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

package/dist/integrations/partner-wire.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Канонический вид Morty-стандарта «на проводе».
+ *
+ * Одна и та же схема работает у нас в двух направлениях:
+ *  - **наружу** — `/morty/*` и любой партнёр, который читает наше расписание;
+ *    сериализуется классами `MortyTimeslotRO`, `MortyAttractionRO`,
+ *    `MortyBookingRO`;
+ *  - **внутрь** — Partner Booking API: мы читаем внешнюю систему клиентом
+ *    `PartnerClientService`.
+ *
+ * Документ для партнёров обещает побайтовое зеркало: *«If you already expose an
+ * API for Morty, you can reuse it as is — just issue us a separate token»*.
+ * Пока схема была объявлена дважды (декорированные RO для исходящего и
+ * локальные типы в `partner-client.service.ts` для входящего), это обещание
+ * держалось на честном слове: правка одной копии не ломала ничего в другой.
+ * Здесь — единственное объявление; RO-классы проверяются на совместимость с
+ * ним на этапе компиляции (см. `morty-timeslot.ro.ts`).
+ *
+ * **Цены на проводе — в мажорных единицах** (`60` = £60), в отличие от всего
+ * внутреннего кода. Перевод делают мапперы на границе.
+ *
+ * Имена полей — snake_case и не приводятся к нашему camelCase: это внешний
+ * контракт, у него своя совместимость.
+ */
+export type PartnerWireLocation = {
+    address?: string;
+    longitude?: number | null;
+    latitude?: number | null;
+    phone?: string;
+    /** IANA, например `Europe/London`. */
+    timeZone?: string;
+};
+export type PartnerWireAttraction = {
+    /** Идентификатор квеста у партнёра. Обязан быть стабильным между синками. */
+    id: number | string;
+    title: string;
+    slug?: string;
+    photo?: string;
+    /** `escape`, `vr`, `performance`, `outdoor` и т.п. */
+    type?: string;
+    description?: string | null;
+    playersMin?: number;
+    playersMax?: number;
+    /** Площадка партнёра: группирует квесты одной локации. */
+    profile_id?: number | string | null;
+    location?: PartnerWireLocation;
+};
+export type PartnerWirePrice = {
+    players: number;
+    /** Цена за всю группу, мажорные единицы. */
+    price: number;
+};
+export type PartnerWireTimeslot = {
+    /** Глобально уникальный id слота — возвращается нам как `timeslot_id`. */
+    id: string;
+    product_id: number | string;
+    /** Локальная дата `YYYY-MM-DD`. */
+    date: string;
+    /** Локальное `HH:MM`. */
+    start_time: string;
+    end_time: string;
+    /** UTC ISO. */
+    start_at: string;
+    timezone: string;
+    duration_minutes: number;
+    is_free: boolean;
+    is_call_to_book: boolean;
+    is_blocked: boolean;
+    is_private: boolean;
+    seats_available: number;
+    players_min: number;
+    players_max: number;
+    /** ISO 4217. */
+    currency: string;
+    /** Мажорные единицы. */
+    price_from: number;
+    prices: PartnerWirePrice[];
+    /** UTC ISO либо `null`, если отсечки нет. */
+    deadline: string | null;
+};
+export type PartnerWireCustomer = {
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+};
+export type PartnerWireCreateBooking = {
+    timeslot_id: string;
+    /**
+     * Наш id брони с префиксом (`en_` для Partner API). **Ключ
+     * идемпотентности**: повтор после таймаута с тем же значением обязан
+     * вернуть уже созданную бронь, а не создать вторую.
+     */
+    external_booking_id: string;
+    players: number;
+    customer: PartnerWireCustomer;
+    comment?: string;
+    /**
+     * Здесь зеркало **не симметрично, и это про деньги**. Morty собирает оплату
+     * сам и присылает нам `paid: true` с объектом `payment`. Мы наружу всегда
+     * отправляем `paid: false`: бронь неоплаченная, игрок платит на месте.
+     * Система, написанная под Morty и автоподтверждающая только предоплаченные
+     * брони, поведёт себя с нами иначе — это отдельный пункт в документе для
+     * партнёров и проверка в sandbox-валидаторе.
+     */
+    paid?: boolean;
+    payment?: {
+        amount: number;
+        currency: string;
+        transaction_id: string;
+    };
+};
+export type PartnerWireBookingResponse = {
+    success: boolean;
+    booking_id: number | string;
+    external_booking_id: string;
+    confirmation_code: string;
+    status: 'confirmed' | 'cancelled' | 'failed';
+    /**
+     * Причина отказа. Бизнес-ошибки в этом стандарте приходят с HTTP 200 и
+     * `success: false`, поэтому сообщение — единственный источник причины.
+     */
+    message?: string;
+};

package/dist/integrations/partner-wire.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Канонический вид Morty-стандарта «на проводе».
+ *
+ * Одна и та же схема работает у нас в двух направлениях:
+ *  - **наружу** — `/morty/*` и любой партнёр, который читает наше расписание;
+ *    сериализуется классами `MortyTimeslotRO`, `MortyAttractionRO`,
+ *    `MortyBookingRO`;
+ *  - **внутрь** — Partner Booking API: мы читаем внешнюю систему клиентом
+ *    `PartnerClientService`.
+ *
+ * Документ для партнёров обещает побайтовое зеркало: *«If you already expose an
+ * API for Morty, you can reuse it as is — just issue us a separate token»*.
+ * Пока схема была объявлена дважды (декорированные RO для исходящего и
+ * локальные типы в `partner-client.service.ts` для входящего), это обещание
+ * держалось на честном слове: правка одной копии не ломала ничего в другой.
+ * Здесь — единственное объявление; RO-классы проверяются на совместимость с
+ * ним на этапе компиляции (см. `morty-timeslot.ro.ts`).
+ *
+ * **Цены на проводе — в мажорных единицах** (`60` = £60), в отличие от всего
+ * внутреннего кода. Перевод делают мапперы на границе.
+ *
+ * Имена полей — snake_case и не приводятся к нашему camelCase: это внешний
+ * контракт, у него своя совместимость.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/integrations/partners-booking-v1-schedule.dto.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Диапазон расписания для `GET /partners/booking/v1/questrooms/:id/schedule`.
+ *
+ * Формат проверяется строго: `parseISO` от мусора возвращает `Invalid Date`, и
+ * дальше это уезжает в чужую CRM запросом за несуществующий период. Партнёру
+ * полезнее 400 с понятной причиной, чем пустое расписание без объяснений.
+ */
+export declare class PartnersBookingV1ScheduleDto {
+    from: string;
+    to: string;
+}

package/dist/integrations/partners-booking-v1-schedule.dto.js

@@ -0,0 +1,43 @@
+"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.PartnersBookingV1ScheduleDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Диапазон расписания для `GET /partners/booking/v1/questrooms/:id/schedule`.
+ *
+ * Формат проверяется строго: `parseISO` от мусора возвращает `Invalid Date`, и
+ * дальше это уезжает в чужую CRM запросом за несуществующий период. Партнёру
+ * полезнее 400 с понятной причиной, чем пустое расписание без объяснений.
+ */
+class PartnersBookingV1ScheduleDto {
+}
+exports.PartnersBookingV1ScheduleDto = PartnersBookingV1ScheduleDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Первый день диапазона (включительно), локальная дата площадки, yyyy-MM-dd.',
+        example: '2026-09-07',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}$/, { message: 'from must be in yyyy-MM-dd format' }),
+    __metadata("design:type", String)
+], PartnersBookingV1ScheduleDto.prototype, "from", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Последний день диапазона (включительно), yyyy-MM-dd. Диапазон длиннее ' +
+            'обслуживаемого укорачивается молча: за горизонтом провайдера слотов всё равно нет.',
+        example: '2026-09-14',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}$/, { message: 'to must be in yyyy-MM-dd format' }),
+    __metadata("design:type", String)
+], PartnersBookingV1ScheduleDto.prototype, "to", void 0);

package/dist/integrations/partners-booking-v1.d.ts

@@ -0,0 +1,124 @@
+import { IntegrationBookingModeEnum } from './booking-mode.enum';
+/**
+ * Опубликованный контракт `/partners/booking/v1/*` — то, что видят внешние
+ * потребители расписания: агрегаторы-партнёры (Morty, NowEscape, RU-каталоги) и
+ * наш собственный облегчённый шелл записи.
+ *
+ * **Почему это отдельные типы, а не `NormalizedSlot` наружу.** `NormalizedSlot`
+ * — внутренний вид, в нём есть `raw` с сырым ответом чужой системы: он идёт в
+ * журнал для разбора инцидентов и наружу попасть не должен ни при каких
+ * обстоятельствах. Кроме того, внутренний тип мы правим свободно, а этот —
+ * только с новой версией в пути. Пересобирать один в другой на границе дешевле,
+ * чем однажды случайно опубликовать поле, которое не собирались.
+ *
+ * **Почему `v1`, когда проект называется «интеграции v2».** Номер в пути
+ * считает версии опубликованного контракта, а не наших внутренних переделок:
+ * снаружи этого контракта раньше не было. Прежние внешние диалекты
+ * (`/morty/*`, `/aggregators/*`, `/nowescape/*`) версии в пути не имеют вовсе,
+ * так что на номер 1 никто не претендует.
+ *
+ * **Деньги — в минорных единицах** (копейки/центы), и поле называется
+ * `priceMinor`, чтобы единицу нельзя было прочитать неправильно. Цена в
+ * мажорных уже дважды приводила к порче данных: «от 51 руб.» вместо «от 5100
+ * руб.» в виджете и бронь на 350 000 ₽ вместо 3 500 ₽ в CRM квеста.
+ */
+export type PartnersBookingV1SlotStatus = 
+/** Свободен, бронировать можно. */
+'free'
+/** Занят или приём броней закрыт. */
+ | 'busy'
+/** Показываем, но записаться можно только по телефону. */
+ | 'call';
+export type PartnersBookingV1Price = {
+    /** Размер группы, для которого действует цена. */
+    players: number;
+    /** Цена за всю группу, минорные единицы. */
+    priceMinor: number;
+};
+export type PartnersBookingV1Slot = {
+    /**
+     * Идентификатор слота. С ним же придёт бронь, когда появится запись по
+     * этому контракту. Строка: у разных систем это число, UUID или составной
+     * ключ.
+     */
+    slotId: string;
+    /** Локальная дата игры, `yyyy-MM-dd`. */
+    date: string;
+    /** Локальное время, `HH:mm`. */
+    start: string;
+    end?: string;
+    /**
+     * Момент начала в UTC, ISO. Отдаётся отдельно от локальных `date`/`start`:
+     * сравнивать слоты разных площадок по локальному времени нельзя.
+     */
+    startAt?: string;
+    durationMinutes?: number;
+    status: PartnersBookingV1SlotStatus;
+    /** Минимальная цена за группу, минорные единицы. */
+    priceMinor?: number;
+    /** Цены по размерам групп, минорные единицы. */
+    prices?: PartnersBookingV1Price[];
+    /** ISO 4217, например `EUR`. */
+    currency?: string;
+    seatsAvailable?: number;
+    playersMin?: number;
+    playersMax?: number;
+    /** Крайний момент приёма брони, UTC ISO. `null` — отсечки нет. */
+    deadline?: string | null;
+};
+/**
+ * Почему расписание недоступно. Строка, а не enum наружу: список будет
+ * пополняться, и потребитель обязан переживать незнакомое значение, а не падать
+ * на нём. Значения стабильны и годятся для показа в поддержке.
+ */
+export type PartnersBookingV1UnavailableReason = 
+/** Квест не на нашей CRM и не интегрирован ни с одной системой. */
+'no_connection'
+/** Подключение есть, но квест не связан с ресурсом внешней системы. */
+ | 'not_matched'
+/** Настройка не доведена до проверки креденшелов. */
+ | 'status_draft'
+/** Ждёт действия вендора или нашего. */
+ | 'status_pending'
+/** Креденшелы перестали приниматься. */
+ | 'status_failed'
+/** Подключение выключено. */
+ | 'status_disabled'
+/** Внешняя система не ответила: сбой, таймаут, разомкнутый предохранитель. */
+ | 'provider_unavailable';
+export type PartnersBookingV1Questroom = {
+    id: number;
+    title: string;
+    /** IANA-таймзона площадки, например `Europe/London`. */
+    timezone: string | null;
+    playersMin: number | null;
+    playersMax: number | null;
+    /** `false` — расписание сейчас отдать не из чего, смотри `unavailableReason`. */
+    scheduleAvailable: boolean;
+    /**
+     * Как оформляется бронь: мгновенно, через удержание или заявкой с
+     * подтверждением квеста. Читать до попытки записи: у части систем нет API
+     * записи вовсе, и там всегда `request`.
+     */
+    bookingMode: IntegrationBookingModeEnum;
+    /** `null`, когда расписание доступно. */
+    unavailableReason: PartnersBookingV1UnavailableReason | null;
+    /** На сколько дней вперёд имеет смысл спрашивать расписание. */
+    scheduleHorizonDays: number | null;
+};
+export type PartnersBookingV1Schedule = {
+    questroomId: number;
+    /** Запрошенный диапазон локальных дат, включительно. */
+    from: string;
+    to: string;
+    /**
+     * `true` — расписание получить **не удалось**. Пустой `slots` при этом не
+     * означает «свободных мест нет», и показывать его как «мест нет» нельзя:
+     * вместо этого предлагайте игроку заявку. Это единственное поле, которое
+     * отличает «квест занят» от «мы не смогли спросить», и ради него оно и
+     * заведено.
+     */
+    unavailable: boolean;
+    unavailableReason: PartnersBookingV1UnavailableReason | null;
+    slots: PartnersBookingV1Slot[];
+};

package/dist/integrations/partners-booking-v1.js

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

package/dist/integrations/pending-booking-request.ro.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Заявка, ждущая ответа квеста (режим `request`).
+ *
+ * Показывается в кабинете рядом с интеграцией. Дублирует то, что уже ушло
+ * письмом и в Telegram, и это не избыточность: письмо теряется в папке «спам» и
+ * читается с чужого телефона, а кабинет — единственное место, где владелец
+ * видит сразу все висящие заявки и понимает масштаб («у меня их четыре»).
+ */
+export type PendingBookingRequest = {
+    /** `aggregator-orders.id` — он же идентификатор заявки. */
+    orderId: number;
+    connectionId: number;
+    questroomId: number | null;
+    questroomTitle: string;
+    /** Дата и время игры так, как их видит игрок. */
+    date: string;
+    time: string;
+    players: number | null;
+    playerName: string;
+    playerPhone: string;
+    playerEmail: string;
+    /** Сумма заказа в минорных единицах — как она хранится в заказе. */
+    price: number;
+    /** До какого момента ждём ответа. `null` — срок не проставлен. */
+    deadlineAt: string | null;
+    /**
+     * Сколько минут осталось. Отрицательное значение означает «срок вышел, но
+     * крон ещё не закрыл заявку»: такую заявку подтверждать уже нельзя, и
+     * интерфейс обязан показать это до нажатия, а не после.
+     */
+    minutesLeft: number | null;
+};

package/dist/integrations/pending-booking-request.ro.js

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

package/dist/integrations/provider-code.enum.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Код системы бронирования, за которой стоит конкретный коннектор.
+ *
+ * Почему это отдельное явное поле, а не вывод из того, какая колонка
+ * заполнена. Сейчас маршрутизация размазана: расписание выбирается по
+ * `profile.integrationType`, а отправка брони — по «есть ли
+ * `questroom.partnerAttractionId`, иначе есть ли `integration.postRequest`»
+ * (`aggregator-order.service.ts`). У квеста, переехавшего с MyERP на Partner
+ * API, старый `postRequest` остаётся в базе, и достаточно потерять связь с
+ * attraction, чтобы бронь ушла в прежнюю CRM. В v2 маршрут задаёт ровно одно
+ * поле подключения — этот код.
+ */
+export declare enum IntegrationProviderCodeEnum {
+    /** Наша собственная CRM: то же расписание через общий интерфейс. */
+    CRM = "crm",
+    /** Partner Booking API — зеркало Morty-стандарта, реализует партнёр. */
+    PARTNER_API = "partner_api",
+    /** Легаси: МойЭРП / КвестАдмин / «Мир квестов» — per-quest URL'ы. */
+    MYERP = "myerp",
+    BOOKEO = "bookeo",
+    OFFTHECOUCH = "offthecouch",
+    RESOVA = "resova",
+    XOLA = "xola",
+    BUZZSHOT = "buzzshot",
+    REGIONDO = "regiondo",
+    FAREHARBOR = "fareharbor",
+    /**
+     * OCTO — открытый стандарт бронирования для активностей, а не один вендор.
+     * Один код на всех, кто его реализует (Ventrata, Zaui, Bókun, Peek Pro, Xola,
+     * TuriTop и ещё сотня), потому что коннектор у них общий: различия сводятся к
+     * адресу и ключу, то есть к креденшелам подключения.
+     *
+     * Отдельные коды у `XOLA` и `FAREHARBOR` остаются: у первого есть и свой
+     * нативный API, у второго OCTO нет вовсе.
+     */
+    OCTO = "octo"
+}

package/dist/integrations/provider-code.enum.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationProviderCodeEnum = void 0;
+/**
+ * Код системы бронирования, за которой стоит конкретный коннектор.
+ *
+ * Почему это отдельное явное поле, а не вывод из того, какая колонка
+ * заполнена. Сейчас маршрутизация размазана: расписание выбирается по
+ * `profile.integrationType`, а отправка брони — по «есть ли
+ * `questroom.partnerAttractionId`, иначе есть ли `integration.postRequest`»
+ * (`aggregator-order.service.ts`). У квеста, переехавшего с MyERP на Partner
+ * API, старый `postRequest` остаётся в базе, и достаточно потерять связь с
+ * attraction, чтобы бронь ушла в прежнюю CRM. В v2 маршрут задаёт ровно одно
+ * поле подключения — этот код.
+ */
+var IntegrationProviderCodeEnum;
+(function (IntegrationProviderCodeEnum) {
+    /** Наша собственная CRM: то же расписание через общий интерфейс. */
+    IntegrationProviderCodeEnum["CRM"] = "crm";
+    /** Partner Booking API — зеркало Morty-стандарта, реализует партнёр. */
+    IntegrationProviderCodeEnum["PARTNER_API"] = "partner_api";
+    /** Легаси: МойЭРП / КвестАдмин / «Мир квестов» — per-quest URL'ы. */
+    IntegrationProviderCodeEnum["MYERP"] = "myerp";
+    IntegrationProviderCodeEnum["BOOKEO"] = "bookeo";
+    IntegrationProviderCodeEnum["OFFTHECOUCH"] = "offthecouch";
+    IntegrationProviderCodeEnum["RESOVA"] = "resova";
+    IntegrationProviderCodeEnum["XOLA"] = "xola";
+    IntegrationProviderCodeEnum["BUZZSHOT"] = "buzzshot";
+    IntegrationProviderCodeEnum["REGIONDO"] = "regiondo";
+    IntegrationProviderCodeEnum["FAREHARBOR"] = "fareharbor";
+    /**
+     * OCTO — открытый стандарт бронирования для активностей, а не один вендор.
+     * Один код на всех, кто его реализует (Ventrata, Zaui, Bókun, Peek Pro, Xola,
+     * TuriTop и ещё сотня), потому что коннектор у них общий: различия сводятся к
+     * адресу и ключу, то есть к креденшелам подключения.
+     *
+     * Отдельные коды у `XOLA` и `FAREHARBOR` остаются: у первого есть и свой
+     * нативный API, у второго OCTO нет вовсе.
+     */
+    IntegrationProviderCodeEnum["OCTO"] = "octo";
+})(IntegrationProviderCodeEnum || (exports.IntegrationProviderCodeEnum = IntegrationProviderCodeEnum = {}));

package/dist/integrations/resource-match-status.enum.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Состояние привязки внешнего ресурса к нашему квесту. Привязка — самое
+ * опасное место интеграции: ошибка здесь означает, что расписание одного
+ * квеста показывается на странице другого, а бронь уезжает не туда, куда
+ * записался игрок. Поэтому автоматическое сопоставление и подтверждённое
+ * различаются на уровне данных.
+ */
+export declare enum IntegrationResourceMatchStatusEnum {
+    /** Ресурс найден у вендора, кандидата в каталоге нет. */
+    UNMATCHED = "unmatched",
+    /**
+     * Автоматика нашла кандидата, но уверенности не хватило. Расписание
+     * **не показываем** до подтверждения человеком.
+     */
+    SUGGESTED = "suggested",
+    /** Привязка подтверждена: расписание можно показывать. */
+    CONFIRMED = "confirmed",
+    /**
+     * Ревьюер отклонил кандидата. Хранится, чтобы автоматика не предлагала его
+     * снова на каждом синке.
+     */
+    REJECTED = "rejected",
+    /** Ресурс исчез из выдачи вендора: расписание снимаем. */
+    GONE = "gone"
+}

package/dist/integrations/resource-match-status.enum.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationResourceMatchStatusEnum = void 0;
+/**
+ * Состояние привязки внешнего ресурса к нашему квесту. Привязка — самое
+ * опасное место интеграции: ошибка здесь означает, что расписание одного
+ * квеста показывается на странице другого, а бронь уезжает не туда, куда
+ * записался игрок. Поэтому автоматическое сопоставление и подтверждённое
+ * различаются на уровне данных.
+ */
+var IntegrationResourceMatchStatusEnum;
+(function (IntegrationResourceMatchStatusEnum) {
+    /** Ресурс найден у вендора, кандидата в каталоге нет. */
+    IntegrationResourceMatchStatusEnum["UNMATCHED"] = "unmatched";
+    /**
+     * Автоматика нашла кандидата, но уверенности не хватило. Расписание
+     * **не показываем** до подтверждения человеком.
+     */
+    IntegrationResourceMatchStatusEnum["SUGGESTED"] = "suggested";
+    /** Привязка подтверждена: расписание можно показывать. */
+    IntegrationResourceMatchStatusEnum["CONFIRMED"] = "confirmed";
+    /**
+     * Ревьюер отклонил кандидата. Хранится, чтобы автоматика не предлагала его
+     * снова на каждом синке.
+     */
+    IntegrationResourceMatchStatusEnum["REJECTED"] = "rejected";
+    /** Ресурс исчез из выдачи вендора: расписание снимаем. */
+    IntegrationResourceMatchStatusEnum["GONE"] = "gone";
+})(IntegrationResourceMatchStatusEnum || (exports.IntegrationResourceMatchStatusEnum = IntegrationResourceMatchStatusEnum = {}));

package/dist/integrations/run-operation.enum.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Операция, которую коннектор выполнял. Журнал разделён по операциям, потому
+ * что здоровье подключения по ним разное и смешивать их нельзя: расписание
+ * может отдаваться исправно, пока брони не проходят вовсе, и наоборот. Именно
+ * это различие сейчас не видно — про недоехавшую бронь мы узнаём от квеста.
+ */
+export declare enum IntegrationRunOperationEnum {
+    /** Проверка креденшелов при подключении и по расписанию. */
+    VERIFY = "verify",
+    /** Синк списка квестов/продуктов аккаунта. */
+    LIST_RESOURCES = "list_resources",
+    /** Запрос расписания за диапазон дат. */
+    SCHEDULE = "schedule",
+    /** Перепроверка одного слота перед бронью. */
+    CHECK_SLOT = "check_slot",
+    /** Удержание слота (режим `hold_then_confirm`). */
+    HOLD = "hold",
+    /** Создание брони. */
+    BOOKING = "booking",
+    /** Отмена брони. */
+    CANCEL = "cancel"
+}