@escapenavigator/types 2.0.34 → 2.0.37

package/dist/loyalty/enum/loyalty-program-type.enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyProgramTypeEnum = void 0;
+/**
+ * Какую механику компания включила. Программы взаимоисключающие: клиент
+ * не может одновременно получать скидку за статус и кэшбэк с той же
+ * игры — иначе одна и та же лояльность стоила бы венью дважды, а
+ * администратор на стойке не смог бы объяснить итоговую цифру в чеке.
+ */
+var LoyaltyProgramTypeEnum;
+(function (LoyaltyProgramTypeEnum) {
+    /** Статус даёт процент скидки сразу в чеке текущей игры. */
+    LoyaltyProgramTypeEnum["DISCOUNT"] = "discount";
+    /** Игра начисляет бонусы на баланс клиента, ими платят в следующий раз. */
+    LoyaltyProgramTypeEnum["CASHBACK"] = "cashback";
+})(LoyaltyProgramTypeEnum || (exports.LoyaltyProgramTypeEnum = LoyaltyProgramTypeEnum = {}));

package/dist/loyalty/enum/loyalty-stacking.enum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Что делать, когда на игре уже есть другая скидка — промокод, ручная
+ * скидка администратора или скидка на время слота.
+ *
+ * `EXCLUSIVE` (по умолчанию) — статусная скидка не применяется вовсе:
+ * на игре работает одна скидка. Правило намеренно грубое, зато
+ * администратору его можно объяснить одной фразой, а чек не уходит в
+ * минус от промокода, утреннего слота и золотого статуса разом.
+ * `STACK` — статусная скидка складывается с остальными.
+ */
+export declare enum LoyaltyStackingEnum {
+    EXCLUSIVE = "exclusive",
+    STACK = "stack"
+}

package/dist/loyalty/enum/loyalty-stacking.enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyStackingEnum = void 0;
+/**
+ * Что делать, когда на игре уже есть другая скидка — промокод, ручная
+ * скидка администратора или скидка на время слота.
+ *
+ * `EXCLUSIVE` (по умолчанию) — статусная скидка не применяется вовсе:
+ * на игре работает одна скидка. Правило намеренно грубое, зато
+ * администратору его можно объяснить одной фразой, а чек не уходит в
+ * минус от промокода, утреннего слота и золотого статуса разом.
+ * `STACK` — статусная скидка складывается с остальными.
+ */
+var LoyaltyStackingEnum;
+(function (LoyaltyStackingEnum) {
+    LoyaltyStackingEnum["EXCLUSIVE"] = "exclusive";
+    LoyaltyStackingEnum["STACK"] = "stack";
+})(LoyaltyStackingEnum || (exports.LoyaltyStackingEnum = LoyaltyStackingEnum = {}));

package/dist/loyalty/enum/loyalty-tier-color.enum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Палитра бейджа статуса. Фиксированный набор вместо свободного HEX:
+ * бейдж встречается в списке клиентов, в карточке и в мобильном
+ * приложении, и произвольный цвет от компании слишком легко делает его
+ * нечитаемым на одном из фонов.
+ */
+export declare enum LoyaltyTierColorEnum {
+    BRONZE = "bronze",
+    SILVER = "silver",
+    GOLD = "gold",
+    PLATINUM = "platinum",
+    BLUE = "blue",
+    GREEN = "green",
+    PURPLE = "purple",
+    RED = "red"
+}

package/dist/loyalty/enum/loyalty-tier-color.enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyTierColorEnum = void 0;
+/**
+ * Палитра бейджа статуса. Фиксированный набор вместо свободного HEX:
+ * бейдж встречается в списке клиентов, в карточке и в мобильном
+ * приложении, и произвольный цвет от компании слишком легко делает его
+ * нечитаемым на одном из фонов.
+ */
+var LoyaltyTierColorEnum;
+(function (LoyaltyTierColorEnum) {
+    LoyaltyTierColorEnum["BRONZE"] = "bronze";
+    LoyaltyTierColorEnum["SILVER"] = "silver";
+    LoyaltyTierColorEnum["GOLD"] = "gold";
+    LoyaltyTierColorEnum["PLATINUM"] = "platinum";
+    LoyaltyTierColorEnum["BLUE"] = "blue";
+    LoyaltyTierColorEnum["GREEN"] = "green";
+    LoyaltyTierColorEnum["PURPLE"] = "purple";
+    LoyaltyTierColorEnum["RED"] = "red";
+})(LoyaltyTierColorEnum || (exports.LoyaltyTierColorEnum = LoyaltyTierColorEnum = {}));

package/dist/loyalty/enum/loyalty-tier-source.enum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Откуда у клиента текущий статус.
+ *
+ * `MANUAL` — назначен сотрудником и приоритетнее расчёта: пересчёт
+ * метрик его не трогает, пока статус не вернут в автоматический.
+ * `EXCLUDED` — клиент выведен из программы: скидка не применяется, в
+ * распределении по статусам он не участвует, но история сохраняется.
+ */
+export declare enum LoyaltyTierSourceEnum {
+    AUTO = "auto",
+    MANUAL = "manual",
+    EXCLUDED = "excluded"
+}

package/dist/loyalty/enum/loyalty-tier-source.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyTierSourceEnum = void 0;
+/**
+ * Откуда у клиента текущий статус.
+ *
+ * `MANUAL` — назначен сотрудником и приоритетнее расчёта: пересчёт
+ * метрик его не трогает, пока статус не вернут в автоматический.
+ * `EXCLUDED` — клиент выведен из программы: скидка не применяется, в
+ * распределении по статусам он не участвует, но история сохраняется.
+ */
+var LoyaltyTierSourceEnum;
+(function (LoyaltyTierSourceEnum) {
+    LoyaltyTierSourceEnum["AUTO"] = "auto";
+    LoyaltyTierSourceEnum["MANUAL"] = "manual";
+    LoyaltyTierSourceEnum["EXCLUDED"] = "excluded";
+})(LoyaltyTierSourceEnum || (exports.LoyaltyTierSourceEnum = LoyaltyTierSourceEnum = {}));

package/dist/loyalty/loyalty-bonus.ro.d.ts

@@ -0,0 +1,20 @@
+import { RO } from '../shared/ro-class';
+import { LoyaltyBonusTypeEnum } from './enum/loyalty-bonus-type.enum';
+/**
+ * Одна операция по бонусам клиента. Начисления положительные, списания
+ * отрицательные — как в любом журнале, чтобы баланс был обычной суммой,
+ * а не разностью двух колонок.
+ */
+export declare class LoyaltyBonusRO extends RO {
+    clientId: number;
+    type: LoyaltyBonusTypeEnum;
+    /** Минорные единицы со знаком: `+` начислено, `−` списано. */
+    amount: number;
+    /** Баланс клиента после операции — чтобы историю можно было читать глазами. */
+    balanceAfter: number;
+    orderId: number | null;
+    userId: number | null;
+    comment: string;
+    /** Операция погашена: игру отменили или списание снял администратор. */
+    canceled: boolean;
+}

package/dist/loyalty/loyalty-bonus.ro.js

@@ -0,0 +1,55 @@
+"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.LoyaltyBonusRO = void 0;
+const class_transformer_1 = require("class-transformer");
+const ro_class_1 = require("../shared/ro-class");
+const loyalty_bonus_type_enum_1 = require("./enum/loyalty-bonus-type.enum");
+/**
+ * Одна операция по бонусам клиента. Начисления положительные, списания
+ * отрицательные — как в любом журнале, чтобы баланс был обычной суммой,
+ * а не разностью двух колонок.
+ */
+class LoyaltyBonusRO extends ro_class_1.RO {
+}
+exports.LoyaltyBonusRO = LoyaltyBonusRO;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyBonusRO.prototype, "clientId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], LoyaltyBonusRO.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyBonusRO.prototype, "amount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyBonusRO.prototype, "balanceAfter", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyBonusRO.prototype, "orderId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyBonusRO.prototype, "userId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], LoyaltyBonusRO.prototype, "comment", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], LoyaltyBonusRO.prototype, "canceled", void 0);

package/dist/loyalty/loyalty-presets.d.ts

@@ -0,0 +1,45 @@
+import { LoyaltyTierColorEnum } from './enum/loyalty-tier-color.enum';
+export type LoyaltyTierPreset = {
+    color: LoyaltyTierColorEnum;
+    /** Порог для метрики «игры»: сколько квестов надо пройти. */
+    games: number;
+    /**
+     * Порог для метрики «сумма» — в средних чеках компании, а не в
+     * деньгах. Валюты и цены у квестов разные, поэтому абсолютные суммы
+     * в пресете были бы бессмысленны в половине стран: API умножает это
+     * число на реальный средний чек профиля.
+     */
+    checks: number;
+    /** Процент скидки на статусе — для скидочной программы. */
+    discount: number;
+    /**
+     * Процент кэшбэка на статусе — для накопительной программы. Ниже
+     * скидки не случайно: скидку венью отдаёт один раз, а бонусы клиент
+     * тратит на следующей игре, то есть они возвращаются в кассу
+     * вторым визитом. Поэтому у одного и того же статуса кэшбэк
+     * выгоднее держать скромнее, чем прямую скидку.
+     */
+    cashback: number;
+};
+/**
+ * Стартовый набор «бронза — серебро — золото», который создаётся одной
+ * кнопкой. Разрыв между серебром и золотом сделан заметным (3 игры → 6):
+ * если статусы идут вплотную, клиент не видит смысла доигрывать до
+ * следующего, а компания раздаёт максимальную скидку с четвёртой игры.
+ */
+export declare const LOYALTY_TIER_PRESETS: LoyaltyTierPreset[];
+/** Доля чека, которую по умолчанию разрешено закрыть бонусами. */
+export declare const LOYALTY_DEFAULT_MAX_BONUS_PAY_PERCENT = 50;
+/**
+ * Названия на случай, если клиент API не передал свои. Обычно названия
+ * приходят из CRM уже переведёнными — держать словарь статусов в API
+ * значило бы дублировать локали интерфейса.
+ */
+export declare const LOYALTY_PRESET_FALLBACK_TITLES: string[];
+/**
+ * Средний чек для пресета по сумме, когда истории игр ещё нет и взять
+ * цифру неоткуда. Число заведомо приблизительное — владелец правит
+ * пороги руками сразу после создания, — но пустые нули в конструкторе
+ * были бы хуже.
+ */
+export declare const LOYALTY_FALLBACK_AVERAGE_CHECK = 500000;

package/dist/loyalty/loyalty-presets.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOYALTY_FALLBACK_AVERAGE_CHECK = exports.LOYALTY_PRESET_FALLBACK_TITLES = exports.LOYALTY_DEFAULT_MAX_BONUS_PAY_PERCENT = exports.LOYALTY_TIER_PRESETS = void 0;
+const loyalty_tier_color_enum_1 = require("./enum/loyalty-tier-color.enum");
+/**
+ * Стартовый набор «бронза — серебро — золото», который создаётся одной
+ * кнопкой. Разрыв между серебром и золотом сделан заметным (3 игры → 6):
+ * если статусы идут вплотную, клиент не видит смысла доигрывать до
+ * следующего, а компания раздаёт максимальную скидку с четвёртой игры.
+ */
+exports.LOYALTY_TIER_PRESETS = [
+    { color: loyalty_tier_color_enum_1.LoyaltyTierColorEnum.BRONZE, games: 1, checks: 1, discount: 3, cashback: 3 },
+    { color: loyalty_tier_color_enum_1.LoyaltyTierColorEnum.SILVER, games: 3, checks: 3, discount: 5, cashback: 5 },
+    { color: loyalty_tier_color_enum_1.LoyaltyTierColorEnum.GOLD, games: 6, checks: 6, discount: 10, cashback: 7 },
+];
+/** Доля чека, которую по умолчанию разрешено закрыть бонусами. */
+exports.LOYALTY_DEFAULT_MAX_BONUS_PAY_PERCENT = 50;
+/**
+ * Названия на случай, если клиент API не передал свои. Обычно названия
+ * приходят из CRM уже переведёнными — держать словарь статусов в API
+ * значило бы дублировать локали интерфейса.
+ */
+exports.LOYALTY_PRESET_FALLBACK_TITLES = ['Bronze', 'Silver', 'Gold'];
+/**
+ * Средний чек для пресета по сумме, когда истории игр ещё нет и взять
+ * цифру неоткуда. Число заведомо приблизительное — владелец правит
+ * пороги руками сразу после создания, — но пустые нули в конструкторе
+ * были бы хуже.
+ */
+exports.LOYALTY_FALLBACK_AVERAGE_CHECK = 500000;

package/dist/loyalty/loyalty-preview.dto.d.ts

@@ -0,0 +1,19 @@
+import { LoyaltyHistoryModeEnum } from './enum/loyalty-history-mode.enum';
+import { LoyaltyMetricEnum } from './enum/loyalty-metric.enum';
+export declare class LoyaltyPreviewTierDto {
+    threshold: number;
+    /** Процент, который стоит денег: скидка или кэшбэк — смотря какая программа. */
+    discount: number;
+}
+/**
+ * Прикидка «что будет, если включить» по ещё не сохранённым порогам:
+ * сколько клиентов попадёт на каждый статус и во что это обошлось бы за
+ * последний год. Считается по реальной истории игр и ничего не меняет —
+ * владелец должен видеть цену решения до того, как раздаст скидку
+ * половине базы.
+ */
+export declare class LoyaltyPreviewDto {
+    metric: LoyaltyMetricEnum;
+    historyMode: LoyaltyHistoryModeEnum;
+    tiers: LoyaltyPreviewTierDto[];
+}

package/dist/loyalty/loyalty-preview.dto.js

@@ -0,0 +1,64 @@
+"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.LoyaltyPreviewDto = exports.LoyaltyPreviewTierDto = void 0;
+/* eslint-disable max-classes-per-file */
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const loyalty_history_mode_enum_1 = require("./enum/loyalty-history-mode.enum");
+const loyalty_metric_enum_1 = require("./enum/loyalty-metric.enum");
+const loyalty_tier_dto_1 = require("./loyalty-tier.dto");
+class LoyaltyPreviewTierDto {
+}
+exports.LoyaltyPreviewTierDto = LoyaltyPreviewTierDto;
+__decorate([
+    (0, class_transformer_1.Transform)(({ value }) => (+value > 0 ? Math.round(+value) : 0)),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewTierDto.prototype, "threshold", void 0);
+__decorate([
+    (0, class_transformer_1.Transform)(({ value }) => (+value > 0 ? Math.round(+value) : 0)),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewTierDto.prototype, "discount", void 0);
+/**
+ * Прикидка «что будет, если включить» по ещё не сохранённым порогам:
+ * сколько клиентов попадёт на каждый статус и во что это обошлось бы за
+ * последний год. Считается по реальной истории игр и ничего не меняет —
+ * владелец должен видеть цену решения до того, как раздаст скидку
+ * половине базы.
+ */
+class LoyaltyPreviewDto {
+}
+exports.LoyaltyPreviewDto = LoyaltyPreviewDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_metric_enum_1.LoyaltyMetricEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], LoyaltyPreviewDto.prototype, "metric", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_history_mode_enum_1.LoyaltyHistoryModeEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], LoyaltyPreviewDto.prototype, "historyMode", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(loyalty_tier_dto_1.MAX_LOYALTY_TIERS),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => LoyaltyPreviewTierDto),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], LoyaltyPreviewDto.prototype, "tiers", void 0);

package/dist/loyalty/loyalty-preview.ro.d.ts

@@ -0,0 +1,20 @@
+export declare class LoyaltyPreviewBucketRO {
+    threshold: number;
+    discount: number;
+    clientsCount: number;
+    /**
+     * Во что обошёлся бы этот статус за последние 12 месяцев: скидка,
+     * применённая к уже состоявшимся играм его будущих участников. Оценка
+     * сверху — она не учитывает, что часть этих игр была с промокодом и
+     * статусная скидка на них не встала бы.
+     */
+    estimatedDiscount: number;
+}
+export declare class LoyaltyPreviewRO {
+    /** Клиенты хотя бы с одной состоявшейся игрой в зачётном периоде. */
+    totalClients: number;
+    estimatedDiscount: number;
+    /** Средний чек игры — им же считаются пороги пресета по сумме. */
+    averageCheck: number;
+    buckets: LoyaltyPreviewBucketRO[];
+}

package/dist/loyalty/loyalty-preview.ro.js

@@ -0,0 +1,53 @@
+"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.LoyaltyPreviewRO = exports.LoyaltyPreviewBucketRO = void 0;
+/* eslint-disable max-classes-per-file */
+const class_transformer_1 = require("class-transformer");
+class LoyaltyPreviewBucketRO {
+}
+exports.LoyaltyPreviewBucketRO = LoyaltyPreviewBucketRO;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewBucketRO.prototype, "threshold", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewBucketRO.prototype, "discount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewBucketRO.prototype, "clientsCount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewBucketRO.prototype, "estimatedDiscount", void 0);
+class LoyaltyPreviewRO {
+}
+exports.LoyaltyPreviewRO = LoyaltyPreviewRO;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewRO.prototype, "totalClients", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewRO.prototype, "estimatedDiscount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], LoyaltyPreviewRO.prototype, "averageCheck", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => LoyaltyPreviewBucketRO),
+    __metadata("design:type", Array)
+], LoyaltyPreviewRO.prototype, "buckets", void 0);

package/dist/loyalty/loyalty-settings.dto.d.ts

@@ -0,0 +1,51 @@
+import { LoyaltyHistoryModeEnum } from './enum/loyalty-history-mode.enum';
+import { LoyaltyMetricEnum } from './enum/loyalty-metric.enum';
+import { LoyaltyProgramTypeEnum } from './enum/loyalty-program-type.enum';
+import { LoyaltyStackingEnum } from './enum/loyalty-stacking.enum';
+/**
+ * Онбординг одной кнопкой: создаёт статусы из пресета, фиксирует, что
+ * делать с историей существующих клиентов, и включает программу.
+ */
+export declare class SetupLoyaltyDto {
+    /** Скидка за статус или кэшбэк бонусами — выбирается один раз в онбординге. */
+    programType: LoyaltyProgramTypeEnum;
+    metric: LoyaltyMetricEnum;
+    historyMode: LoyaltyHistoryModeEnum;
+    /** Переведённые названия статусов, по одному на статус пресета. */
+    titles?: string[];
+}
+export declare class UpdateLoyaltySettingsDto {
+    enabled: boolean;
+    /**
+     * Переключение типа не стирает ни балансы, ни статусы: выключенная
+     * механика просто перестаёт работать, и при возврате всё снова
+     * считается с того же места.
+     */
+    programType: LoyaltyProgramTypeEnum;
+    metric: LoyaltyMetricEnum;
+    /**
+     * Кэшбэк для клиентов без статуса, целыми процентами. Ноль означает
+     * «до первого статуса бонусы не капают» — так же, как в скидочной
+     * программе новичок не получает скидку.
+     */
+    cashbackPercent?: number;
+    /**
+     * Какую долю чека разрешено закрыть бонусами. Ограничение защищает
+     * не столько выручку, сколько сам визит: игра, полностью оплаченная
+     * бонусами, не приносит венью живых денег в день, когда занят слот.
+     */
+    maxBonusPayPercent?: number;
+    /**
+     * Ставить ли статусную скидку в игру автоматически. С выключенным
+     * флагом программа остаётся сегментацией: бейдж в карточке виден,
+     * чек не меняется.
+     */
+    autoApplyDiscount: boolean;
+    stacking: LoyaltyStackingEnum;
+    /**
+     * Смена режима заново замораживает дату отсечки `countFrom` по
+     * текущему дню, поэтому менять его после запуска стоит осознанно:
+     * счётчики всех клиентов пересчитаются.
+     */
+    historyMode: LoyaltyHistoryModeEnum;
+}

package/dist/loyalty/loyalty-settings.dto.js

@@ -0,0 +1,103 @@
+"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.UpdateLoyaltySettingsDto = exports.SetupLoyaltyDto = void 0;
+/* eslint-disable max-classes-per-file */
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const loyalty_history_mode_enum_1 = require("./enum/loyalty-history-mode.enum");
+const loyalty_metric_enum_1 = require("./enum/loyalty-metric.enum");
+const loyalty_program_type_enum_1 = require("./enum/loyalty-program-type.enum");
+const loyalty_stacking_enum_1 = require("./enum/loyalty-stacking.enum");
+const loyalty_tier_dto_1 = require("./loyalty-tier.dto");
+/**
+ * Онбординг одной кнопкой: создаёт статусы из пресета, фиксирует, что
+ * делать с историей существующих клиентов, и включает программу.
+ */
+class SetupLoyaltyDto {
+}
+exports.SetupLoyaltyDto = SetupLoyaltyDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_program_type_enum_1.LoyaltyProgramTypeEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], SetupLoyaltyDto.prototype, "programType", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_metric_enum_1.LoyaltyMetricEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], SetupLoyaltyDto.prototype, "metric", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_history_mode_enum_1.LoyaltyHistoryModeEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], SetupLoyaltyDto.prototype, "historyMode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ArrayMaxSize)(loyalty_tier_dto_1.MAX_LOYALTY_TIERS),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.MaxLength)(30, { each: true }),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], SetupLoyaltyDto.prototype, "titles", void 0);
+class UpdateLoyaltySettingsDto {
+}
+exports.UpdateLoyaltySettingsDto = UpdateLoyaltySettingsDto;
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_transformer_1.Transform)(({ value }) => Boolean(value)),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], UpdateLoyaltySettingsDto.prototype, "enabled", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_program_type_enum_1.LoyaltyProgramTypeEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], UpdateLoyaltySettingsDto.prototype, "programType", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_metric_enum_1.LoyaltyMetricEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], UpdateLoyaltySettingsDto.prototype, "metric", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (+value > 0 ? Math.round(+value) : 0)),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], UpdateLoyaltySettingsDto.prototype, "cashbackPercent", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (+value > 0 ? Math.round(+value) : 0)),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], UpdateLoyaltySettingsDto.prototype, "maxBonusPayPercent", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_transformer_1.Transform)(({ value }) => Boolean(value)),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], UpdateLoyaltySettingsDto.prototype, "autoApplyDiscount", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_stacking_enum_1.LoyaltyStackingEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], UpdateLoyaltySettingsDto.prototype, "stacking", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_history_mode_enum_1.LoyaltyHistoryModeEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], UpdateLoyaltySettingsDto.prototype, "historyMode", void 0);

package/dist/loyalty/loyalty-settings.ro.d.ts

@@ -0,0 +1,33 @@
+import { RO } from '../shared/ro-class';
+import { LoyaltyHistoryModeEnum } from './enum/loyalty-history-mode.enum';
+import { LoyaltyMetricEnum } from './enum/loyalty-metric.enum';
+import { LoyaltyProgramTypeEnum } from './enum/loyalty-program-type.enum';
+import { LoyaltyStackingEnum } from './enum/loyalty-stacking.enum';
+import { LoyaltyTierRO } from './loyalty-tier.ro';
+export declare class LoyaltySettingsRO extends RO {
+    enabled: boolean;
+    programType: LoyaltyProgramTypeEnum;
+    metric: LoyaltyMetricEnum;
+    /** Кэшбэк для клиентов без статуса, целые проценты. */
+    cashbackPercent: number;
+    /** Максимальная доля чека, которую можно закрыть бонусами. */
+    maxBonusPayPercent: number;
+    /**
+     * Дата, с которой игры начисляют бонусы. Отдельно от `countFrom`:
+     * статусы можно посчитать по всей прошлой истории, а бонусы за
+     * прошлые игры начислять нельзя — это раздача денег задним числом.
+     */
+    cashbackFrom: string | null;
+    autoApplyDiscount: boolean;
+    stacking: LoyaltyStackingEnum;
+    historyMode: LoyaltyHistoryModeEnum;
+    /**
+     * Дата, с которой игры идут в зачёт. `null` — вся история. Хранится
+     * отдельно от режима, потому что режим отвечает на вопрос «что вы
+     * выбрали», а дата — «что реально считается»: для `LAST_YEAR` она
+     * заморожена днём включения и со временем не сдвигается.
+     */
+    countFrom: string | null;
+    /** Отсортированы по порогу по возрастанию — как рисуются в CRM. */
+    tiers: LoyaltyTierRO[];
+}