@escapenavigator/types 1.10.168 → 2.0.2

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

@@ -33,6 +33,7 @@ export type WidgetChatConversationRO = {
     reopenCount?: number;
     clientId?: number | null;
     visitorEmail?: string | null;
+    visitorPhone?: string | null;
     bookingInfo?: WidgetChatBookingInfo | null;
     createdAt: Date;
     updatedAt: Date;

package/dist/widget-chat/widget-chat-identify.dto.d.ts

@@ -2,4 +2,5 @@ export declare class WidgetChatIdentifyDto {
     conversationId: number;
     visitorToken: string;
     email: string;
+    phone?: string;
 }

package/dist/widget-chat/widget-chat-identify.dto.js

@@ -31,3 +31,9 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], WidgetChatIdentifyDto.prototype, "email", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], WidgetChatIdentifyDto.prototype, "phone", void 0);

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-step.enum.d.ts

@@ -41,5 +41,17 @@ export declare enum WidgetFunnelStepEnum {
  * воронки сверху вниз). ЕДИНЫЙ источник правды о порядке.
  */
 export declare const WIDGET_FUNNEL_STEP_ORDER: Record<WidgetFunnelKindEnum, WidgetFunnelStepEnum[]>;
+/**
+ * Шаг, с которого считается сквозная конверсия воронки (`overallConversion`).
+ * НЕ обязательно первый шаг: для booking расписание (`SCHEDULE_VIEW`) висит
+ * на сайтах и рендерится при каждом заходе на страницу, поэтому считать
+ * конверсию от показа — значит делить на «весь трафик сайта», а не на тех,
+ * кто реально вошёл в воронку. За точку входа берём первый осознанный шаг —
+ * клик по слоту. Показ при этом остаётся в воронке как awareness-ступень.
+ *
+ * Для certificate каталог открывается по действию пользователя, поэтому
+ * точка входа = первый шаг.
+ */
+export declare const WIDGET_FUNNEL_ENTRY_STEP: Record<WidgetFunnelKindEnum, WidgetFunnelStepEnum>;
 /** Человекочитаемые подписи шагов для админ-UI. */
 export declare const WIDGET_FUNNEL_STEP_LABELS: Record<WidgetFunnelStepEnum, string>;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WIDGET_FUNNEL_STEP_LABELS = exports.WIDGET_FUNNEL_STEP_ORDER = exports.WidgetFunnelStepEnum = void 0;
+exports.WIDGET_FUNNEL_STEP_LABELS = exports.WIDGET_FUNNEL_ENTRY_STEP = exports.WIDGET_FUNNEL_STEP_ORDER = exports.WidgetFunnelStepEnum = void 0;
 const widget_funnel_kind_enum_1 = require("./widget-funnel-kind.enum");
 /**
  * Канонические шаги воронок виджета. Один общий enum на обе воронки —
@@ -65,6 +65,21 @@ exports.WIDGET_FUNNEL_STEP_ORDER = {
         WidgetFunnelStepEnum.CERT_PURCHASE,
     ],
 };
+/**
+ * Шаг, с которого считается сквозная конверсия воронки (`overallConversion`).
+ * НЕ обязательно первый шаг: для booking расписание (`SCHEDULE_VIEW`) висит
+ * на сайтах и рендерится при каждом заходе на страницу, поэтому считать
+ * конверсию от показа — значит делить на «весь трафик сайта», а не на тех,
+ * кто реально вошёл в воронку. За точку входа берём первый осознанный шаг —
+ * клик по слоту. Показ при этом остаётся в воронке как awareness-ступень.
+ *
+ * Для certificate каталог открывается по действию пользователя, поэтому
+ * точка входа = первый шаг.
+ */
+exports.WIDGET_FUNNEL_ENTRY_STEP = {
+    [widget_funnel_kind_enum_1.WidgetFunnelKindEnum.BOOKING]: WidgetFunnelStepEnum.SLOT_CLICK,
+    [widget_funnel_kind_enum_1.WidgetFunnelKindEnum.CERTIFICATE]: WidgetFunnelStepEnum.CERT_CATALOG_VIEW,
+};
 /** Человекочитаемые подписи шагов для админ-UI. */
 exports.WIDGET_FUNNEL_STEP_LABELS = {
     [WidgetFunnelStepEnum.SCHEDULE_VIEW]: 'Показ расписания',

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

@@ -14,6 +14,37 @@ export type WidgetFunnelStepRO = {
     /** 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;
@@ -22,12 +53,18 @@ export type WidgetFunnelRO = {
     /** '' = агрегат по всем виджетам профиля. */
     widgetUid: string;
     steps: WidgetFunnelStepRO[];
-    /** Сессий на первом шаге воронки. */
+    /**
+     * Сессий на шаге-входе воронки (см. `WIDGET_FUNNEL_ENTRY_STEP`). Для
+     * booking это клик по слоту, а не показ расписания — знаменатель сквозной
+     * конверсии, чтобы не делить на весь трафик сайта.
+     */
     entries: number;
     /** Сессий на последнем шаге (покупка). */
     conversions: number;
     /** conversions / entries (0..1). */
     overallConversion: number | null;
+    /** Разрезы шагов по параметрам (если запрошены/доступны). */
+    dimensions?: WidgetFunnelDimensionRO[];
 };
 /** Строка кросс-компанийной таблицы: одна компания + где она «течёт». */
 export type WidgetFunnelCompanyRO = {
@@ -50,3 +87,51 @@ export type WidgetFunnelCrossCompanyRO = {
     /** Список компаний, отсортированный по 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;
+    /** Сессий-входов (шаг-вход воронки, см. `WIDGET_FUNNEL_ENTRY_STEP`). */
+    entries: number;
+    /** Сессий-покупок (последний шаг). */
+    conversions: number;
+    /** conversions / entries (0..1). */
+    overallConversion: number | null;
+};
+/** Недельный тренд конверсии за N недель. */
+export type WidgetFunnelTrendRO = {
+    kind: WidgetFunnelKindEnum;
+    profileId: number;
+    points: WidgetFunnelTrendPointRO[];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/types",
-  "version": "1.10.168",
+  "version": "2.0.2",
   "publishConfig": {
     "access": "public"
   },
@@ -23,7 +23,7 @@
     "reflect-metadata": "^0.1.13",
     "rxjs": "^7.5.5"
   },
-  "gitHead": "5302a068ed1d8bbc5508278412432af4c3accf33",
+  "gitHead": "fd5d63cf01b4dcde8e8938233e741e6113ed7865",
   "devDependencies": {
     "@types/validator": "13.0.0",
     "typescript": "^5.6"