@escapenavigator/types 1.10.166 → 1.10.168

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-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,52 @@
+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 WidgetFunnelRO = {
+    profileId: number;
+    profileTitle?: string;
+    kind: WidgetFunnelKindEnum;
+    /** '' = агрегат по всем виджетам профиля. */
+    widgetUid: string;
+    steps: WidgetFunnelStepRO[];
+    /** Сессий на первом шаге воронки. */
+    entries: number;
+    /** Сессий на последнем шаге (покупка). */
+    conversions: number;
+    /** conversions / entries (0..1). */
+    overallConversion: number | null;
+};
+/** Строка кросс-компанийной таблицы: одна компания + где она «течёт». */
+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[];
+};

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.166",
+  "version": "1.10.168",
   "publishConfig": {
     "access": "public"
   },
@@ -23,7 +23,7 @@
     "reflect-metadata": "^0.1.13",
     "rxjs": "^7.5.5"
   },
-  "gitHead": "db7397183541de1381b854f014288ca16182a43c",
+  "gitHead": "5302a068ed1d8bbc5508278412432af4c3accf33",
   "devDependencies": {
     "@types/validator": "13.0.0",
     "typescript": "^5.6"