@escapenavigator/types 1.10.107 → 1.10.121

package/dist/agb/agb-type.enum.d.ts

@@ -1,9 +1,27 @@
 export declare enum AgbTypeEnum {
-    REGISTRATION_NEW_PROFILE = "registration_new_profile",
+    /** Политика обработки персональных данных. */
+    PRIVACY_POLICY = "privacy_policy",
+    /** Импринт / юр. реквизиты Escape Navigator. */
     IMPRINT = "imprint",
+    /** Cookies-уведомление. */
     COOKIES = "cookies",
-    PRIVACY_POLICY = "privacy_policy",
-    AGREEMENT = "agreement",
+    /** Договор с квестом на участие в агрегаторе. */
     PARTNER_PROGRAMM = "partner_programm",
-    CUSTOMERS_AGREEEMENT = "customers_agreement"
+    /** Договор с квестом на SaaS-подписку Escape Navigator. */
+    AGREEMENT = "agreement",
+    /**
+     * Шаблон клиентского соглашения квеста с плейсхолдерами вида
+     * `{{legalTitle}}`, `{{phoneForCustomers}}` и т.д. Не показывается в
+     * публичной странице `/documents/:type/:country` в orders, используется
+     * в app для генерации terms of services конкретного оператора
+     * (см. `ClientAgreement` → `TemplateGeneratorModal`).
+     */
+    TEMPLATE = "template"
 }
+/**
+ * Список типов документов, которые публикуются на странице `/documents/:type/:country`
+ * в orders. `TEMPLATE` сюда не входит — это внутренний инструмент app для
+ * генерации клиентского соглашения оператора.
+ */
+export declare const PUBLIC_DOCUMENT_TYPES: readonly [AgbTypeEnum.PRIVACY_POLICY, AgbTypeEnum.IMPRINT, AgbTypeEnum.COOKIES, AgbTypeEnum.PARTNER_PROGRAMM, AgbTypeEnum.AGREEMENT];
+export declare const isPublicDocumentType: (type: AgbTypeEnum) => boolean;

package/dist/agb/agb-type.enum.js

@@ -1,13 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgbTypeEnum = void 0;
+exports.isPublicDocumentType = exports.PUBLIC_DOCUMENT_TYPES = exports.AgbTypeEnum = void 0;
 var AgbTypeEnum;
 (function (AgbTypeEnum) {
-    AgbTypeEnum["REGISTRATION_NEW_PROFILE"] = "registration_new_profile";
+    /** Политика обработки персональных данных. */
+    AgbTypeEnum["PRIVACY_POLICY"] = "privacy_policy";
+    /** Импринт / юр. реквизиты Escape Navigator. */
     AgbTypeEnum["IMPRINT"] = "imprint";
+    /** Cookies-уведомление. */
     AgbTypeEnum["COOKIES"] = "cookies";
-    AgbTypeEnum["PRIVACY_POLICY"] = "privacy_policy";
-    AgbTypeEnum["AGREEMENT"] = "agreement";
+    /** Договор с квестом на участие в агрегаторе. */
     AgbTypeEnum["PARTNER_PROGRAMM"] = "partner_programm";
-    AgbTypeEnum["CUSTOMERS_AGREEEMENT"] = "customers_agreement";
+    /** Договор с квестом на SaaS-подписку Escape Navigator. */
+    AgbTypeEnum["AGREEMENT"] = "agreement";
+    /**
+     * Шаблон клиентского соглашения квеста с плейсхолдерами вида
+     * `{{legalTitle}}`, `{{phoneForCustomers}}` и т.д. Не показывается в
+     * публичной странице `/documents/:type/:country` в orders, используется
+     * в app для генерации terms of services конкретного оператора
+     * (см. `ClientAgreement` → `TemplateGeneratorModal`).
+     */
+    AgbTypeEnum["TEMPLATE"] = "template";
 })(AgbTypeEnum || (exports.AgbTypeEnum = AgbTypeEnum = {}));
+/**
+ * Список типов документов, которые публикуются на странице `/documents/:type/:country`
+ * в orders. `TEMPLATE` сюда не входит — это внутренний инструмент app для
+ * генерации клиентского соглашения оператора.
+ */
+exports.PUBLIC_DOCUMENT_TYPES = [
+    AgbTypeEnum.PRIVACY_POLICY,
+    AgbTypeEnum.IMPRINT,
+    AgbTypeEnum.COOKIES,
+    AgbTypeEnum.PARTNER_PROGRAMM,
+    AgbTypeEnum.AGREEMENT,
+];
+const isPublicDocumentType = (type) => exports.PUBLIC_DOCUMENT_TYPES.includes(type);
+exports.isPublicDocumentType = isPublicDocumentType;

package/dist/agb/get-for-order-service.dto.d.ts

@@ -1,4 +1,6 @@
+import { CountriesEnum } from '../shared/enum/countries.enum';
+import { AgbTypeEnum } from './agb-type.enum';
 export declare class GetForOrderServiceDto {
-    type: string;
-    country: string;
+    type: AgbTypeEnum;
+    country: CountriesEnum;
 }

package/dist/agb/get-for-order-service.dto.js

@@ -10,15 +10,17 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetForOrderServiceDto = void 0;
-const is_not_blank_1 = require("../shared/is-not-blank");
+const class_validator_1 = require("class-validator");
+const countries_enum_1 = require("../shared/enum/countries.enum");
+const agb_type_enum_1 = require("./agb-type.enum");
 class GetForOrderServiceDto {
 }
 exports.GetForOrderServiceDto = GetForOrderServiceDto;
 __decorate([
-    (0, is_not_blank_1.IsNotBlank)(),
+    (0, class_validator_1.IsEnum)(agb_type_enum_1.AgbTypeEnum),
     __metadata("design:type", String)
 ], GetForOrderServiceDto.prototype, "type", void 0);
 __decorate([
-    (0, is_not_blank_1.IsNotBlank)(),
+    (0, class_validator_1.IsEnum)(countries_enum_1.CountriesEnum),
     __metadata("design:type", String)
 ], GetForOrderServiceDto.prototype, "country", void 0);

package/dist/openapi/order-groups/openapi-batch-create-preorder.dto.d.ts

@@ -0,0 +1,26 @@
+import { OpenapiCreatePreorderDto } from '../orders/openapi-create-preorder.dto';
+/**
+ * Атомарное создание сразу нескольких preorder-ов одной группой в один
+ * HTTP-запрос. Конкретно адресован app-flow «забронировать N игр за раз»:
+ * виджет умеет делать это циклом из N×POST /preorder + attachToOrderTokens,
+ * но это:
+ *  • N×network round-trip (юзер увидит лоадер на каждый);
+ *  • N×race-window между preorder и group attach;
+ *  • при фейле i-го preorder клиент остаётся с зомбированными первыми i-1.
+ *
+ * Batch endpoint решает всё это: одна валидация, одна точка отказа,
+ * compensation rollback всех успевших создаться ордеров при любой
+ * ошибке. Бэкенд гарантирует, что либо группа собрана целиком, либо
+ * ни одного ордера не осталось.
+ *
+ * Ограничения:
+ *  • `items.length` в [2, 5] — одиночный preorder идёт через
+ *    POST /openapi/orders/preorder (там нет смысла создавать группу);
+ *    верхний лимит — `OrderGroupService.ORDER_GROUP_SIZE_LIMIT`.
+ *  • Все items должны иметь идентичные client-fields (name/phone/email/...).
+ *    Бэкенд это проверяет и бросает 400 при mismatch, чтобы не создать
+ *    несколько разных клиентов.
+ */
+export declare class OpenapiBatchCreatePreorderDto {
+    items: OpenapiCreatePreorderDto[];
+}

package/dist/openapi/order-groups/openapi-batch-create-preorder.dto.js

@@ -0,0 +1,48 @@
+"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.OpenapiBatchCreatePreorderDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const openapi_create_preorder_dto_1 = require("../orders/openapi-create-preorder.dto");
+/**
+ * Атомарное создание сразу нескольких preorder-ов одной группой в один
+ * HTTP-запрос. Конкретно адресован app-flow «забронировать N игр за раз»:
+ * виджет умеет делать это циклом из N×POST /preorder + attachToOrderTokens,
+ * но это:
+ *  • N×network round-trip (юзер увидит лоадер на каждый);
+ *  • N×race-window между preorder и group attach;
+ *  • при фейле i-го preorder клиент остаётся с зомбированными первыми i-1.
+ *
+ * Batch endpoint решает всё это: одна валидация, одна точка отказа,
+ * compensation rollback всех успевших создаться ордеров при любой
+ * ошибке. Бэкенд гарантирует, что либо группа собрана целиком, либо
+ * ни одного ордера не осталось.
+ *
+ * Ограничения:
+ *  • `items.length` в [2, 5] — одиночный preorder идёт через
+ *    POST /openapi/orders/preorder (там нет смысла создавать группу);
+ *    верхний лимит — `OrderGroupService.ORDER_GROUP_SIZE_LIMIT`.
+ *  • Все items должны иметь идентичные client-fields (name/phone/email/...).
+ *    Бэкенд это проверяет и бросает 400 при mismatch, чтобы не создать
+ *    несколько разных клиентов.
+ */
+class OpenapiBatchCreatePreorderDto {
+}
+exports.OpenapiBatchCreatePreorderDto = OpenapiBatchCreatePreorderDto;
+__decorate([
+    (0, class_validator_1.ArrayMinSize)(2),
+    (0, class_validator_1.ArrayMaxSize)(5),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => openapi_create_preorder_dto_1.OpenapiCreatePreorderDto),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], OpenapiBatchCreatePreorderDto.prototype, "items", void 0);

package/dist/openapi/widget/openapi-widget-info.ro.d.ts

@@ -39,10 +39,15 @@ declare class CustomFiled {
 }
 declare class Profile {
     id: number;
+    /**
+     * Уникальный slug компании. Используется виджетом для построения публичных
+     * ссылок на страницу клиентского соглашения оператора
+     * (`{ORDERS_DOMAIN}/company/:slug/terms-of-services`).
+     */
+    slug: string;
     phoneForCustomers: string;
     country: CountriesEnum;
     bookingFields: WidgetBookingFiledEnum[];
-    agreementLink: string;
     title: string;
     availableLanguages: Languages[];
     language: Languages;

package/dist/openapi/widget/openapi-widget-info.ro.js

@@ -115,6 +115,10 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)
 ], Profile.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], Profile.prototype, "slug", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
@@ -127,10 +131,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Array)
 ], Profile.prototype, "bookingFields", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    __metadata("design:type", String)
-], Profile.prototype, "agreementLink", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)

package/dist/profile/agb/admin-profile-agb.ro.d.ts

@@ -0,0 +1,26 @@
+import { CountriesEnum } from '../../shared/enum/countries.enum';
+/**
+ * Срез данных компании, нужный админу на странице "Profile agreements".
+ * Не тянем полный `AdminProfileRO` намеренно — чтобы пагинированный список
+ * не падал в Mb при сотнях профилей.
+ */
+export declare class AdminProfileAgbProfile {
+    id: number;
+    title: string;
+    slug: string;
+    country: CountriesEnum;
+}
+/**
+ * Запись клиентского соглашения профиля для админ-таблицы. `length` —
+ * число символов чистого текста (после strip HTML), считается на бэке,
+ * чтобы фронт не тащил весь HTML только ради подсчёта.
+ */
+export declare class AdminProfileAgbRO {
+    id: number;
+    createdAt: Date;
+    text: string;
+    /** Длина чистого текста (без HTML-тегов) — используется в фильтрах
+     *  и для подсветки «короткого/пустого» соглашения в таблице. */
+    length: number;
+    profile?: AdminProfileAgbProfile;
+}

package/dist/profile/agb/admin-profile-agb.ro.js

@@ -0,0 +1,67 @@
+"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.AdminProfileAgbRO = exports.AdminProfileAgbProfile = void 0;
+const class_transformer_1 = require("class-transformer");
+const countries_enum_1 = require("../../shared/enum/countries.enum");
+/**
+ * Срез данных компании, нужный админу на странице "Profile agreements".
+ * Не тянем полный `AdminProfileRO` намеренно — чтобы пагинированный список
+ * не падал в Mb при сотнях профилей.
+ */
+class AdminProfileAgbProfile {
+}
+exports.AdminProfileAgbProfile = AdminProfileAgbProfile;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], AdminProfileAgbProfile.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AdminProfileAgbProfile.prototype, "title", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AdminProfileAgbProfile.prototype, "slug", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AdminProfileAgbProfile.prototype, "country", void 0);
+/**
+ * Запись клиентского соглашения профиля для админ-таблицы. `length` —
+ * число символов чистого текста (после strip HTML), считается на бэке,
+ * чтобы фронт не тащил весь HTML только ради подсчёта.
+ */
+class AdminProfileAgbRO {
+}
+exports.AdminProfileAgbRO = AdminProfileAgbRO;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], AdminProfileAgbRO.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Date)
+], AdminProfileAgbRO.prototype, "createdAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AdminProfileAgbRO.prototype, "text", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], AdminProfileAgbRO.prototype, "length", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => AdminProfileAgbProfile),
+    __metadata("design:type", AdminProfileAgbProfile)
+], AdminProfileAgbRO.prototype, "profile", void 0);

package/dist/profile/agb/profile-agb.ro.d.ts

@@ -1,6 +1,12 @@
 export type ProfileAgbRO = {
     id: number;
     text: string;
+    /**
+     * Дата последнего редактирования. Показывается на публичной странице
+     * соглашения оператора как «Редакция от …», чтобы клиент видел
+     * актуальность версии договора.
+     */
+    updatedAt?: Date | string;
     profile?: {
         title?: string;
         logo?: string;

package/dist/profile/profile.ro.d.ts

@@ -32,11 +32,13 @@ export declare class ProfileRO {
     legalTitle: string;
     legalAddress?: string;
     legalTaxId?: string;
+    /** ОГРН/ОГРНИП — для RU-юрлиц. Используется как плейсхолдер `{{ogrn}}`
+     * в TEMPLATE-документах при генерации клиентского соглашения. */
+    ogrn?: string;
     phoneForCustomers: string;
     logo: string;
     mainEmail: string;
     site: string;
-    agreementLink: string;
     crm: string;
     slug: string;
     language: Languages;

package/dist/profile/profile.ro.js

@@ -111,6 +111,10 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], ProfileRO.prototype, "legalTaxId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], ProfileRO.prototype, "ogrn", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
@@ -127,10 +131,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], ProfileRO.prototype, "site", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    __metadata("design:type", String)
-], ProfileRO.prototype, "agreementLink", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)

package/dist/profile/update-current-base.dto.d.ts

@@ -4,6 +4,7 @@ export declare class UpdateCurrentBaseDto {
     legalTitle: string;
     legalAddress?: string;
     legalTaxId?: string;
+    ogrn?: string;
     tax?: number;
     taxIncluded?: boolean;
     phoneForCustomers: string;

package/dist/profile/update-current-base.dto.js

@@ -37,6 +37,11 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], UpdateCurrentBaseDto.prototype, "legalTaxId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], UpdateCurrentBaseDto.prototype, "ogrn", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsNumber)(),

package/dist/profile/update-current.dto.d.ts

@@ -1,6 +1,5 @@
 import { UpdateCurrentBaseDto } from './update-current-base.dto';
 export declare class UpdateCurrentDto extends UpdateCurrentBaseDto {
-    agreementLink: string;
     site: string;
     logo: string;
     gaEnabled: boolean;

package/dist/profile/update-current.dto.js

@@ -16,11 +16,6 @@ const update_current_base_dto_1 = require("./update-current-base.dto");
 class UpdateCurrentDto extends update_current_base_dto_1.UpdateCurrentBaseDto {
 }
 exports.UpdateCurrentDto = UpdateCurrentDto;
-__decorate([
-    (0, class_validator_1.IsUrl)(),
-    (0, class_transformer_1.Expose)(),
-    __metadata("design:type", String)
-], UpdateCurrentDto.prototype, "agreementLink", void 0);
 __decorate([
     (0, class_validator_1.IsUrl)(),
     (0, class_transformer_1.Expose)(),

package/dist/statistics/certificates.d.ts

@@ -2,8 +2,12 @@
  * Сводный отчёт по продажам сертификатов за выбранный период.
  *
  * Все денежные суммы — в минимальных единицах валюты (копейки/центы).
- * Базовая фильтрация на бэке: `code != NOT_GENERATED_CODE` (висящие
- * корзины не учитываем) + `paidAt` в окне `periods`.
+ *
+ * Когорта периода = `code != NOT_GENERATED_CODE` + `annul = false` +
+ * `paidAt ∈ [start, end)`. ВСЕ агрегаты overview (включая остаток
+ * номиналов, количество полностью использованных и аннулированных)
+ * считаются по одной и той же когорте — это снимает прежний разнобой,
+ * когда `outstandingBalance` суммировался по всей истории профиля.
  *
  * Семантика финансовых полей:
  *  - gross — стоимость по прайсу (SUM(total)). Не выручка.
@@ -11,13 +15,19 @@
  *  - discount — сумма ручных скидок (SUM(discountTotal)).
  *  - promocode — сумма промокодов (SUM(promocodeTotal)).
  *  - refunded — реально возвращённые клиенту деньги (SUM(refundedAmount)).
+ *  - nominalSold — суммарный номинал когорты (SUM(nominal)).
+ *  - nominalRedeemed — сколько из этого номинала уже потрачено в заказах
+ *    (SUM(usedAmount)).
+ *  - outstandingBalance — остаток номиналов когорты у ещё не закрытых
+ *    сертификатов (SUM(balance) WHERE used = false).
+ *  - redemptionRate — целое число процентов, nominalRedeemed / nominalSold.
  */
 export type CertificatesOverview = {
     /** Сколько сертификатов выписано (paid) за период. */
     soldCount: number;
-    /** Сколько аннулировано в этом же периоде (по annulledAt). */
+    /** Сколько из когорты уже аннулировано (annul = true к моменту запроса). */
     annulledCount: number;
-    /** Сколько использовано полностью (по fullyUsedAt). */
+    /** Сколько из когорты уже полностью погашено (fullyUsedAt IS NOT NULL). */
     fullyUsedCount: number;
     /** Сколько ушло в подарок (isGift = true) среди soldCount. */
     giftCount: number;
@@ -28,8 +38,14 @@ export type CertificatesOverview = {
     refunded: number;
     /** Средний чек по cash: cash / soldCount, 0 если нет продаж. */
     avgCheck: number;
-    /** Не использованный остаток номиналов: SUM(balance) у не-аннулированных. */
+    /** Суммарный номинал по когорте: SUM(nominal). */
+    nominalSold: number;
+    /** Сколько номинала уже потрачено в заказах: SUM(usedAmount). */
+    nominalRedeemed: number;
+    /** Остаток номиналов когорты у не закрытых сертификатов: SUM(balance) WHERE used = false. */
     outstandingBalance: number;
+    /** Доля погашения номинала, целое число процентов (0..100). */
+    redemptionRate: number;
 };
 export type CertificatesDynamicRow = {
     period: string;
@@ -66,6 +82,52 @@ export type CertificatesByUtmRow = {
     soldCount: number;
     cash: number;
 };
+/**
+ * Бакеты «через сколько дней после покупки сертификат…»
+ *  - d0      — в день покупки
+ *  - d1_7    — 1..7 дней
+ *  - d8_30   — 8..30 дней
+ *  - d31_90  — 31..90 дней
+ *  - d91_180 — 91..180 дней
+ *  - d181_365 — 181..365 дней
+ *  - d_over_365 — больше года
+ *  - not_yet — ещё не активирован / не погашен полностью
+ */
+export type CertificatesVelocityBucket = 'd0' | 'd1_7' | 'd8_30' | 'd31_90' | 'd91_180' | 'd181_365' | 'd_over_365' | 'not_yet';
+export type CertificatesVelocityBucketRow = {
+    bucket: CertificatesVelocityBucket;
+    /** Сколько сертификатов когорты попало в бакет. */
+    count: number;
+};
+/**
+ * Скорость использования сертификатов когорты периода.
+ *
+ * Когорта = `code != NOT_GENERATED_CODE` + `annul = false` +
+ * `paidAt ∈ [start, end)`. Источники дат — `firstUsedAt`, `fullyUsedAt`,
+ * `expireDate`. Никаких джоинов — считаем по плоской `certificatesales`.
+ */
+export type CertificatesRedemptionVelocity = {
+    /** Распределение времени до первого применения. */
+    firstUseBuckets: CertificatesVelocityBucketRow[];
+    /** Распределение времени до полного погашения. */
+    fullRedeemBuckets: CertificatesVelocityBucketRow[];
+    /** Медианное число дней от покупки до первого применения. */
+    medianDaysToFirstUse: number | null;
+    /** Медианное число дней от покупки до полного погашения. */
+    medianDaysToFullRedeem: number | null;
+    /** Активировано в течение 7 дней после покупки. */
+    activatedWithin7d: number;
+    /** Активировано в течение 30 дней после покупки. */
+    activatedWithin30d: number;
+    /** Полностью погашено в течение 30 дней после покупки. */
+    fullyRedeemedWithin30d: number;
+    /** Полностью погашено в течение 90 дней после покупки. */
+    fullyRedeemedWithin90d: number;
+    /** «Спящие» — куплены больше 90 дней назад и ни разу не применены. */
+    dormantOver90d: number;
+    /** Сгорели (expireDate < сегодня) и не были полностью использованы. */
+    expiredUnused: number;
+};
 export type CertificatesReportRO = {
     overview: CertificatesOverview;
     dynamic: CertificatesDynamicRow[];
@@ -73,4 +135,5 @@ export type CertificatesReportRO = {
     bySource: CertificatesBySourceRow[];
     byDelivery: CertificatesByDeliveryRow[];
     byUtm: CertificatesByUtmRow[];
+    redemption: CertificatesRedemptionVelocity;
 };