@escapenavigator/types 1.10.167 → 2.0.0

package/dist/widget-chat/widget-chat-conversation.ro.d.ts

@@ -1,4 +1,5 @@
 import { WidgetChatConversationStatusEnum } from './enum/widget-chat-conversation-status.enum';
+import { WidgetChatMessageAuthorEnum } from './enum/widget-chat-message-author.enum';
 import { WidgetChatOutcomeEnum } from './enum/widget-chat-outcome.enum';
 import { WidgetChatResolutionReasonEnum } from './enum/widget-chat-resolution-reason.enum';
 import { WidgetChatResolvedByEnum } from './enum/widget-chat-resolved-by.enum';
@@ -16,6 +17,7 @@ export type WidgetChatConversationRO = {
     visitorLastSeenAt?: Date;
     lastMessageText?: string;
     lastMessageAt?: Date;
+    lastMessageAuthor?: WidgetChatMessageAuthorEnum | null;
     unreadCount: number;
     aiEnabled: boolean;
     aiPaused: boolean;

package/dist/widget-funnel/widget-funnel-dimension.d.ts

@@ -0,0 +1,44 @@
+import { WidgetFunnelKindEnum } from './widget-funnel-kind.enum';
+import { WidgetFunnelStepEnum } from './widget-funnel-step.enum';
+/**
+ * Реестр «измерений» (dimensions) воронки — параметров шага, по которым
+ * мы режем конверсию (например: сколько доп.услуг предложено на шаге
+ * выбора игроков). ЕДИНЫЙ источник правды:
+ *   • бэк (`rollupDay`) использует `bucketize`, чтобы сгруппировать сырое
+ *     значение `meta[metaKey]` в низко-кардинальный бакет;
+ *   • фронт админки использует `label` / `buckets[].label` для отрисовки.
+ *
+ * Значение измерения кладётся виджетом в `meta` события того шага, где
+ * параметр уже известен (см. funnelTracker.track(kind, step, meta)).
+ * Бакетирование делаем на бэке, чтобы менять границы без передеплоя
+ * embed-виджета.
+ */
+export type WidgetFunnelDimensionBucket = {
+    /** Канонический ключ бакета (хранится в БД, стабилен). */
+    value: string;
+    /** Подпись для админ-UI. */
+    label: string;
+};
+export type WidgetFunnelDimensionDef = {
+    /** Стабильный id измерения (ключ в dim-кэше). */
+    id: string;
+    kind: WidgetFunnelKindEnum;
+    /** Шаг, на котором параметр известен и берётся из meta. */
+    step: WidgetFunnelStepEnum;
+    /** Ключ в объекте meta события этого шага. */
+    metaKey: string;
+    /** Заголовок измерения для UI. */
+    label: string;
+    /** Упорядоченный список бакетов (порядок = порядок отрисовки). */
+    buckets: WidgetFunnelDimensionBucket[];
+    /** Сырое значение meta → ключ бакета (или null = пропустить сессию). */
+    bucketize: (raw: unknown) => string | null;
+};
+/**
+ * Все измерения. Сейчас покрыта booking-воронка (три шага из примеров +
+ * близкие параметры оплаты). Сертификатная воронка добавляется сюда же
+ * по мере появления эмиссии meta на её шагах.
+ */
+export declare const WIDGET_FUNNEL_DIMENSIONS: WidgetFunnelDimensionDef[];
+/** Измерения, привязанные к конкретному виду воронки. */
+export declare const getDimensionsForKind: (kind: WidgetFunnelKindEnum) => WidgetFunnelDimensionDef[];

package/dist/widget-funnel/widget-funnel-dimension.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDimensionsForKind = exports.WIDGET_FUNNEL_DIMENSIONS = void 0;
+const widget_funnel_kind_enum_1 = require("./widget-funnel-kind.enum");
+const widget_funnel_step_enum_1 = require("./widget-funnel-step.enum");
+/** Бакетер чисел по списку правил «первое подходящее». */
+const numberBucketizer = (rules) => (raw) => {
+    var _a, _b;
+    const n = typeof raw === 'number' ? raw : Number(raw);
+    if (!Number.isFinite(n))
+        return null;
+    return (_b = (_a = rules.find((r) => r.test(n))) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : null;
+};
+/** Бакетер булева флага (принимает boolean ИЛИ 'true'/'false'). */
+const boolBucketizer = (raw) => {
+    if (typeof raw === 'boolean')
+        return raw ? 'yes' : 'no';
+    if (raw === 'true' || raw === 'false')
+        return raw === 'true' ? 'yes' : 'no';
+    return null;
+};
+const YES_NO_BUCKETS = [
+    { value: 'yes', label: 'Есть' },
+    { value: 'no', label: 'Нет' },
+];
+/**
+ * Все измерения. Сейчас покрыта booking-воронка (три шага из примеров +
+ * близкие параметры оплаты). Сертификатная воронка добавляется сюда же
+ * по мере появления эмиссии meta на её шагах.
+ */
+exports.WIDGET_FUNNEL_DIMENSIONS = [
+    {
+        id: 'upsellsOffered',
+        kind: widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING,
+        step: widget_funnel_step_enum_1.WidgetFunnelStepEnum.PLAYERS_STEP,
+        metaKey: 'upsellsOffered',
+        label: 'Доп. услуги предложено',
+        buckets: [
+            { value: 'none', label: 'Нет доп. услуг' },
+            { value: '1-3', label: '1–3 услуги' },
+            { value: '3+', label: 'Больше трёх' },
+        ],
+        bucketize: numberBucketizer([
+            { test: (n) => n <= 0, value: 'none' },
+            { test: (n) => n <= 3, value: '1-3' },
+            { test: () => true, value: '3+' },
+        ]),
+    },
+    {
+        id: 'seatsUrgency',
+        kind: widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING,
+        step: widget_funnel_step_enum_1.WidgetFunnelStepEnum.PLAYERS_STEP,
+        metaKey: 'seatsUrgency',
+        label: 'Показана срочность («осталось N мест»)',
+        buckets: YES_NO_BUCKETS,
+        bucketize: boolBucketizer,
+    },
+    {
+        id: 'clientFieldsCount',
+        kind: widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING,
+        step: widget_funnel_step_enum_1.WidgetFunnelStepEnum.CLIENT_STEP,
+        metaKey: 'clientFieldsCount',
+        label: 'Полей в форме контактов',
+        buckets: [
+            { value: '0-3', label: '≤ 3 поля' },
+            { value: '4-6', label: '4–6 полей' },
+            { value: '6+', label: '> 6 полей' },
+        ],
+        bucketize: numberBucketizer([
+            { test: (n) => n <= 3, value: '0-3' },
+            { test: (n) => n <= 6, value: '4-6' },
+            { test: () => true, value: '6+' },
+        ]),
+    },
+    {
+        id: 'payWithoutPayment',
+        kind: widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING,
+        step: widget_funnel_step_enum_1.WidgetFunnelStepEnum.PAYMENT_STEP,
+        metaKey: 'payWithoutPayment',
+        label: 'Доступно «записаться без оплаты»',
+        buckets: YES_NO_BUCKETS,
+        bucketize: boolBucketizer,
+    },
+    {
+        id: 'paymentMethodsCount',
+        kind: widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING,
+        step: widget_funnel_step_enum_1.WidgetFunnelStepEnum.PAYMENT_STEP,
+        metaKey: 'paymentMethodsCount',
+        label: 'Способов оплаты',
+        buckets: [
+            { value: '1', label: '1 способ' },
+            { value: '2', label: '2 способа' },
+            { value: '3+', label: '3 и более' },
+        ],
+        bucketize: numberBucketizer([
+            { test: (n) => n <= 1, value: '1' },
+            { test: (n) => n === 2, value: '2' },
+            { test: () => true, value: '3+' },
+        ]),
+    },
+    {
+        id: 'prepaymentAvailable',
+        kind: widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING,
+        step: widget_funnel_step_enum_1.WidgetFunnelStepEnum.PAYMENT_STEP,
+        metaKey: 'prepaymentAvailable',
+        label: 'Доступна предоплата (half)',
+        buckets: YES_NO_BUCKETS,
+        bucketize: boolBucketizer,
+    },
+];
+/** Измерения, привязанные к конкретному виду воронки. */
+const getDimensionsForKind = (kind) => exports.WIDGET_FUNNEL_DIMENSIONS.filter((d) => d.kind === kind);
+exports.getDimensionsForKind = getDimensionsForKind;

package/dist/widget-funnel/widget-funnel-event.dto.d.ts

@@ -0,0 +1,30 @@
+import { WidgetFunnelKindEnum } from './widget-funnel-kind.enum';
+import { WidgetFunnelStepEnum } from './widget-funnel-step.enum';
+/**
+ * Одно событие воронки. `profileId` НЕ принимаем из тела — он берётся
+ * из widget-токена на бэке (см. WidgetBeaconGuard), чтобы embed не мог
+ * подделать чужую компанию.
+ *
+ * `eventId` генерит фронт (uuid v4) — нужен для идемпотентности: beacon
+ * может ретраиться (sendBeacon + fetch fallback), бэк дедупит по
+ * (sessionId, eventId).
+ */
+export declare class WidgetFunnelEventDto {
+    eventId: string;
+    sessionId: string;
+    widgetUid: string;
+    widgetType?: string;
+    kind: WidgetFunnelKindEnum;
+    step: WidgetFunnelStepEnum;
+    /** ISO-строка момента события на клиенте. */
+    occurredAt: string;
+    /** Произвольный контекст шага: questroomId, slotId, amount, language... */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Батч событий за один flush. Лимит 50 — обычная сессия порождает 5-10
+ * шагов; запас на случай агрегированного flush'а при unload.
+ */
+export declare class WidgetFunnelEventBatchDto {
+    events: WidgetFunnelEventDto[];
+}

package/dist/widget-funnel/widget-funnel-event.dto.js

@@ -0,0 +1,88 @@
+"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.WidgetFunnelEventBatchDto = exports.WidgetFunnelEventDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const widget_funnel_kind_enum_1 = require("./widget-funnel-kind.enum");
+const widget_funnel_step_enum_1 = require("./widget-funnel-step.enum");
+/**
+ * Одно событие воронки. `profileId` НЕ принимаем из тела — он берётся
+ * из widget-токена на бэке (см. WidgetBeaconGuard), чтобы embed не мог
+ * подделать чужую компанию.
+ *
+ * `eventId` генерит фронт (uuid v4) — нужен для идемпотентности: beacon
+ * может ретраиться (sendBeacon + fetch fallback), бэк дедупит по
+ * (sessionId, eventId).
+ */
+class WidgetFunnelEventDto {
+}
+exports.WidgetFunnelEventDto = WidgetFunnelEventDto;
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "eventId", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "widgetUid", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(32),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "widgetType", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(widget_funnel_kind_enum_1.WidgetFunnelKindEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "kind", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(widget_funnel_step_enum_1.WidgetFunnelStepEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "step", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetFunnelEventDto.prototype, "occurredAt", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Object)
+], WidgetFunnelEventDto.prototype, "meta", void 0);
+/**
+ * Батч событий за один flush. Лимит 50 — обычная сессия порождает 5-10
+ * шагов; запас на случай агрегированного flush'а при unload.
+ */
+class WidgetFunnelEventBatchDto {
+}
+exports.WidgetFunnelEventBatchDto = WidgetFunnelEventBatchDto;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(50),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => WidgetFunnelEventDto),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], WidgetFunnelEventBatchDto.prototype, "events", void 0);

package/dist/widget-funnel/widget-funnel-kind.enum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Тип воронки виджета. Один embeddable-виджет может обслуживать обе
+ * воронки (например WIDGET_BUTTON показывает и бронирование, и покупку
+ * сертификата), поэтому `kind` — это про funnel, а не про widget.type.
+ */
+export declare enum WidgetFunnelKindEnum {
+    BOOKING = "booking",
+    CERTIFICATE = "certificate"
+}

package/dist/widget-funnel/widget-funnel-kind.enum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WidgetFunnelKindEnum = void 0;
+/**
+ * Тип воронки виджета. Один embeddable-виджет может обслуживать обе
+ * воронки (например WIDGET_BUTTON показывает и бронирование, и покупку
+ * сертификата), поэтому `kind` — это про funnel, а не про widget.type.
+ */
+var WidgetFunnelKindEnum;
+(function (WidgetFunnelKindEnum) {
+    WidgetFunnelKindEnum["BOOKING"] = "booking";
+    WidgetFunnelKindEnum["CERTIFICATE"] = "certificate";
+})(WidgetFunnelKindEnum || (exports.WidgetFunnelKindEnum = WidgetFunnelKindEnum = {}));

package/dist/widget-funnel/widget-funnel-step.enum.d.ts

@@ -0,0 +1,45 @@
+import { WidgetFunnelKindEnum } from './widget-funnel-kind.enum';
+/**
+ * Канонические шаги воронок виджета. Один общий enum на обе воронки —
+ * проще для PG enum-колонки и для агрегации; `kind` всё равно отделяет
+ * booking от certificate, но значения шагов не пересекаются намеренно
+ * (cert_-префикс), чтобы случайная путаница в коде была невозможна.
+ *
+ * Порядок шагов внутри каждой воронки задаётся `WIDGET_FUNNEL_STEP_ORDER`.
+ */
+export declare enum WidgetFunnelStepEnum {
+    /** Показ расписания (срез date|view|questroom). Дедупится per-session. */
+    SCHEDULE_VIEW = "schedule_view",
+    /** Клик по слоту, hold успешно создан. */
+    SLOT_CLICK = "slot_click",
+    /** Экран выбора игроков / параметров брони. */
+    PLAYERS_STEP = "players_step",
+    /** Экран контактных данных. */
+    CLIENT_STEP = "client_step",
+    /** Preorder создан (зарезервированный слот + client data). */
+    PREORDER_CREATED = "preorder_created",
+    /** Экран выбора способа оплаты. */
+    PAYMENT_STEP = "payment_step",
+    /** Нажата кнопка «Оплатить» / «Записаться». */
+    PAYMENT_SUBMIT = "payment_submit",
+    /** Успех: окно подтверждения / вейвера. */
+    PURCHASE = "purchase",
+    /** Каталог: выбор доставки / номинала / дизайна. */
+    CERT_CATALOG_VIEW = "cert_catalog_view",
+    /** Форма клиента / доставки сертификата. */
+    CERT_CLIENT_STEP = "cert_client_step",
+    /** Черновик продажи создан (получен certificateToken). */
+    CERT_SALE_CREATED = "cert_sale_created",
+    /** Экран выбора способа оплаты сертификата. */
+    CERT_PAYMENT_STEP = "cert_payment_step",
+    /** Сертификат оплачен. */
+    CERT_PURCHASE = "cert_purchase"
+}
+/**
+ * Упорядоченные шаги по воронкам. Используется и на бэке (rollup:
+ * «дошёл ли до следующего шага»), и на фронте админки (отрисовка
+ * воронки сверху вниз). ЕДИНЫЙ источник правды о порядке.
+ */
+export declare const WIDGET_FUNNEL_STEP_ORDER: Record<WidgetFunnelKindEnum, WidgetFunnelStepEnum[]>;
+/** Человекочитаемые подписи шагов для админ-UI. */
+export declare const WIDGET_FUNNEL_STEP_LABELS: Record<WidgetFunnelStepEnum, string>;

package/dist/widget-funnel/widget-funnel-step.enum.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WIDGET_FUNNEL_STEP_LABELS = exports.WIDGET_FUNNEL_STEP_ORDER = exports.WidgetFunnelStepEnum = void 0;
+const widget_funnel_kind_enum_1 = require("./widget-funnel-kind.enum");
+/**
+ * Канонические шаги воронок виджета. Один общий enum на обе воронки —
+ * проще для PG enum-колонки и для агрегации; `kind` всё равно отделяет
+ * booking от certificate, но значения шагов не пересекаются намеренно
+ * (cert_-префикс), чтобы случайная путаница в коде была невозможна.
+ *
+ * Порядок шагов внутри каждой воронки задаётся `WIDGET_FUNNEL_STEP_ORDER`.
+ */
+var WidgetFunnelStepEnum;
+(function (WidgetFunnelStepEnum) {
+    // --- booking ---
+    /** Показ расписания (срез date|view|questroom). Дедупится per-session. */
+    WidgetFunnelStepEnum["SCHEDULE_VIEW"] = "schedule_view";
+    /** Клик по слоту, hold успешно создан. */
+    WidgetFunnelStepEnum["SLOT_CLICK"] = "slot_click";
+    /** Экран выбора игроков / параметров брони. */
+    WidgetFunnelStepEnum["PLAYERS_STEP"] = "players_step";
+    /** Экран контактных данных. */
+    WidgetFunnelStepEnum["CLIENT_STEP"] = "client_step";
+    /** Preorder создан (зарезервированный слот + client data). */
+    WidgetFunnelStepEnum["PREORDER_CREATED"] = "preorder_created";
+    /** Экран выбора способа оплаты. */
+    WidgetFunnelStepEnum["PAYMENT_STEP"] = "payment_step";
+    /** Нажата кнопка «Оплатить» / «Записаться». */
+    WidgetFunnelStepEnum["PAYMENT_SUBMIT"] = "payment_submit";
+    /** Успех: окно подтверждения / вейвера. */
+    WidgetFunnelStepEnum["PURCHASE"] = "purchase";
+    // --- certificate ---
+    /** Каталог: выбор доставки / номинала / дизайна. */
+    WidgetFunnelStepEnum["CERT_CATALOG_VIEW"] = "cert_catalog_view";
+    /** Форма клиента / доставки сертификата. */
+    WidgetFunnelStepEnum["CERT_CLIENT_STEP"] = "cert_client_step";
+    /** Черновик продажи создан (получен certificateToken). */
+    WidgetFunnelStepEnum["CERT_SALE_CREATED"] = "cert_sale_created";
+    /** Экран выбора способа оплаты сертификата. */
+    WidgetFunnelStepEnum["CERT_PAYMENT_STEP"] = "cert_payment_step";
+    /** Сертификат оплачен. */
+    WidgetFunnelStepEnum["CERT_PURCHASE"] = "cert_purchase";
+})(WidgetFunnelStepEnum || (exports.WidgetFunnelStepEnum = WidgetFunnelStepEnum = {}));
+/**
+ * Упорядоченные шаги по воронкам. Используется и на бэке (rollup:
+ * «дошёл ли до следующего шага»), и на фронте админки (отрисовка
+ * воронки сверху вниз). ЕДИНЫЙ источник правды о порядке.
+ */
+exports.WIDGET_FUNNEL_STEP_ORDER = {
+    [widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING]: [
+        WidgetFunnelStepEnum.SCHEDULE_VIEW,
+        WidgetFunnelStepEnum.SLOT_CLICK,
+        WidgetFunnelStepEnum.PLAYERS_STEP,
+        WidgetFunnelStepEnum.CLIENT_STEP,
+        WidgetFunnelStepEnum.PREORDER_CREATED,
+        WidgetFunnelStepEnum.PAYMENT_STEP,
+        WidgetFunnelStepEnum.PAYMENT_SUBMIT,
+        WidgetFunnelStepEnum.PURCHASE,
+    ],
+    [widget_funnel_kind_enum_1.WidgetFunnelKindEnum.CERTIFICATE]: [
+        WidgetFunnelStepEnum.CERT_CATALOG_VIEW,
+        WidgetFunnelStepEnum.CERT_CLIENT_STEP,
+        WidgetFunnelStepEnum.CERT_SALE_CREATED,
+        WidgetFunnelStepEnum.CERT_PAYMENT_STEP,
+        WidgetFunnelStepEnum.CERT_PURCHASE,
+    ],
+};
+/** Человекочитаемые подписи шагов для админ-UI. */
+exports.WIDGET_FUNNEL_STEP_LABELS = {
+    [WidgetFunnelStepEnum.SCHEDULE_VIEW]: 'Показ расписания',
+    [WidgetFunnelStepEnum.SLOT_CLICK]: 'Клик по слоту',
+    [WidgetFunnelStepEnum.PLAYERS_STEP]: 'Экран игроков',
+    [WidgetFunnelStepEnum.CLIENT_STEP]: 'Контактные данные',
+    [WidgetFunnelStepEnum.PREORDER_CREATED]: 'Preorder создан',
+    [WidgetFunnelStepEnum.PAYMENT_STEP]: 'Экран оплаты',
+    [WidgetFunnelStepEnum.PAYMENT_SUBMIT]: 'Нажал «Оплатить»',
+    [WidgetFunnelStepEnum.PURCHASE]: 'Покупка',
+    [WidgetFunnelStepEnum.CERT_CATALOG_VIEW]: 'Каталог сертификатов',
+    [WidgetFunnelStepEnum.CERT_CLIENT_STEP]: 'Данные / доставка',
+    [WidgetFunnelStepEnum.CERT_SALE_CREATED]: 'Черновик продажи',
+    [WidgetFunnelStepEnum.CERT_PAYMENT_STEP]: 'Экран оплаты',
+    [WidgetFunnelStepEnum.CERT_PURCHASE]: 'Покупка сертификата',
+};

package/dist/widget-funnel/widget-funnel.ro.d.ts

@@ -0,0 +1,133 @@
+import { WidgetFunnelKindEnum } from './widget-funnel-kind.enum';
+import { WidgetFunnelStepEnum } from './widget-funnel-step.enum';
+/** Одна ступень воронки с абсолютными числами и конверсией в следующий шаг. */
+export type WidgetFunnelStepRO = {
+    step: WidgetFunnelStepEnum;
+    /** Сколько сессий дошло до этого шага за период. */
+    sessions: number;
+    /** Сколько из них дошло до следующего шага воронки. */
+    nextStepSessions: number;
+    /** nextStepSessions / sessions (0..1). Для последнего шага = null. */
+    stepConversion: number | null;
+    /** Медиана stepConversion по компаниям (P50) — только в cross-company. */
+    benchmarkP50?: number | null;
+    /** P90 stepConversion по компаниям — только в cross-company. */
+    benchmarkP90?: number | null;
+};
+/** Один бакет измерения с локальной и сквозной конверсией. */
+export type WidgetFunnelDimensionBucketRO = {
+    /** Канонический ключ бакета (см. реестр измерений). */
+    value: string;
+    /** Подпись бакета для UI. */
+    label: string;
+    /** Сессий на шаге измерения с этим значением. */
+    sessions: number;
+    /** Из них дошли до следующего шага. */
+    nextStepSessions: number;
+    /** Из них дошли до покупки (последний шаг воронки). */
+    purchasedSessions: number;
+    /** Локальная конверсия: nextStepSessions / sessions (0..1). */
+    stepConversion: number | null;
+    /** Сквозная конверсия: purchasedSessions / sessions (0..1). */
+    overallConversion: number | null;
+};
+/** Разрез одного шага воронки по значениям параметра. */
+export type WidgetFunnelDimensionRO = {
+    /** id измерения из реестра. */
+    id: string;
+    /** Шаг, к которому привязано измерение. */
+    step: WidgetFunnelStepEnum;
+    /** Заголовок измерения. */
+    label: string;
+    /** Базовая (по всем бакетам) локальная конверсия шага — для дельт. */
+    baselineStepConversion: number | null;
+    /** Базовая сквозная конверсия шага → покупка. */
+    baselineOverallConversion: number | null;
+    buckets: WidgetFunnelDimensionBucketRO[];
+};
+/** Воронка одной компании (или платформы) за период. */
+export type WidgetFunnelRO = {
+    profileId: number;
+    profileTitle?: string;
+    kind: WidgetFunnelKindEnum;
+    /** '' = агрегат по всем виджетам профиля. */
+    widgetUid: string;
+    steps: WidgetFunnelStepRO[];
+    /** Сессий на первом шаге воронки. */
+    entries: number;
+    /** Сессий на последнем шаге (покупка). */
+    conversions: number;
+    /** conversions / entries (0..1). */
+    overallConversion: number | null;
+    /** Разрезы шагов по параметрам (если запрошены/доступны). */
+    dimensions?: WidgetFunnelDimensionRO[];
+};
+/** Строка кросс-компанийной таблицы: одна компания + где она «течёт». */
+export type WidgetFunnelCompanyRO = {
+    profileId: number;
+    profileTitle: string;
+    entries: number;
+    conversions: number;
+    overallConversion: number | null;
+    /** Шаг с наибольшим относительным оттоком (drop-off) у этой компании. */
+    worstStep: WidgetFunnelStepEnum | null;
+    worstStepConversion: number | null;
+};
+/** Ответ кросс-компанийного эндпоинта для продуктовой админки. */
+export type WidgetFunnelCrossCompanyRO = {
+    kind: WidgetFunnelKindEnum;
+    from: string;
+    to: string;
+    /** Воронка-агрегат по всей платформе + benchmark percentiles на шагах. */
+    platform: WidgetFunnelRO;
+    /** Список компаний, отсортированный по overallConversion. */
+    companies: WidgetFunnelCompanyRO[];
+};
+/** Период сравнения: границы + воронка за этот период. */
+export type WidgetFunnelComparePeriodRO = {
+    /** YYYY-MM-DD (UTC). */
+    from: string;
+    /** YYYY-MM-DD (UTC). */
+    to: string;
+    funnel: WidgetFunnelRO;
+};
+/** Дельта конверсии одного шага между текущим и базовым периодами. */
+export type WidgetFunnelStepDeltaRO = {
+    step: WidgetFunnelStepEnum;
+    /** Локальная конверсия шага в текущем периоде. */
+    current: number | null;
+    /** Локальная конверсия шага в базовом периоде. */
+    previous: number | null;
+    /** current - previous в долях (умножить на 100 для п.п.). */
+    delta: number | null;
+};
+/**
+ * Сравнение двух периодов (по умолчанию текущая неделя vs прошлая) —
+ * чтобы оценивать эффект апдейтов. Платформа (profileId=0) или компания.
+ */
+export type WidgetFunnelCompareRO = {
+    kind: WidgetFunnelKindEnum;
+    profileId: number;
+    current: WidgetFunnelComparePeriodRO;
+    previous: WidgetFunnelComparePeriodRO;
+    stepDeltas: WidgetFunnelStepDeltaRO[];
+    /** Δ общей конверсии (current - previous) в долях. */
+    overallDelta: number | null;
+};
+/** Точка недельного тренда. */
+export type WidgetFunnelTrendPointRO = {
+    /** Понедельник недели, YYYY-MM-DD (UTC). */
+    weekStart: string;
+    /** Сессий-входов (первый шаг). */
+    entries: number;
+    /** Сессий-покупок (последний шаг). */
+    conversions: number;
+    /** conversions / entries (0..1). */
+    overallConversion: number | null;
+};
+/** Недельный тренд конверсии за N недель. */
+export type WidgetFunnelTrendRO = {
+    kind: WidgetFunnelKindEnum;
+    profileId: number;
+    points: WidgetFunnelTrendPointRO[];
+};

package/dist/widget-funnel/widget-funnel.ro.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/types",
-  "version": "1.10.167",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -23,7 +23,7 @@
     "reflect-metadata": "^0.1.13",
     "rxjs": "^7.5.5"
   },
-  "gitHead": "6c5bb1ea0799fb0f47e65fd9d3ea2d206784bf24",
+  "gitHead": "4bc136046ad634699417e72afff25e7b28dfbe7a",
   "devDependencies": {
     "@types/validator": "13.0.0",
     "typescript": "^5.6"