@escapenavigator/types 2.0.34 → 2.0.38

package/dist/loyalty/adjust-bonus.dto.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Ручная правка баланса: подарок за отзыв, компенсация за сорванную
+ * игру, исправление ошибки администратора. Причина обязательна — без неё
+ * через месяц никто не вспомнит, откуда у клиента лишние бонусы.
+ */
+export declare class AdjustBonusDto {
+    /**
+     * Минорные единицы со знаком: положительное начисляет, отрицательное
+     * списывает. В минус баланс не уходит — сервер обрежет списание по
+     * остатку.
+     */
+    amount: number;
+    comment?: string;
+}

package/dist/loyalty/adjust-bonus.dto.js

@@ -0,0 +1,35 @@
+"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.AdjustBonusDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Ручная правка баланса: подарок за отзыв, компенсация за сорванную
+ * игру, исправление ошибки администратора. Причина обязательна — без неё
+ * через месяц никто не вспомнит, откуда у клиента лишние бонусы.
+ */
+class AdjustBonusDto {
+}
+exports.AdjustBonusDto = AdjustBonusDto;
+__decorate([
+    (0, class_transformer_1.Transform)(({ value }) => Math.round(+value) || 0),
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], AdjustBonusDto.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AdjustBonusDto.prototype, "comment", void 0);

package/dist/loyalty/assign-client-tier.dto.d.ts

@@ -0,0 +1,9 @@
+import { LoyaltyTierSourceEnum } from './enum/loyalty-tier-source.enum';
+export declare class AssignClientTierDto {
+    source: LoyaltyTierSourceEnum;
+    /**
+     * Обязателен только для ручного назначения: возврат в `auto` и
+     * исключение из программы статус не выбирают.
+     */
+    tierId?: number | null;
+}

package/dist/loyalty/assign-client-tier.dto.js

@@ -0,0 +1,29 @@
+"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.AssignClientTierDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const loyalty_tier_source_enum_1 = require("./enum/loyalty-tier-source.enum");
+class AssignClientTierDto {
+}
+exports.AssignClientTierDto = AssignClientTierDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(loyalty_tier_source_enum_1.LoyaltyTierSourceEnum),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AssignClientTierDto.prototype, "source", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.source === loyalty_tier_source_enum_1.LoyaltyTierSourceEnum.MANUAL),
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], AssignClientTierDto.prototype, "tierId", void 0);

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

@@ -0,0 +1,30 @@
+import { LoyaltyMetricEnum } from './enum/loyalty-metric.enum';
+import { LoyaltyProgramTypeEnum } from './enum/loyalty-program-type.enum';
+import { LoyaltyTierSourceEnum } from './enum/loyalty-tier-source.enum';
+import { LoyaltyTierRO } from './loyalty-tier.ro';
+/**
+ * Состояние одного клиента в программе: статус, накопленные счётчики и
+ * остаток до следующего статуса. Отдаётся и при выключенной программе —
+ * карточка клиента тогда просто ничего не рисует.
+ */
+export declare class ClientLoyaltyRO {
+    enabled: boolean;
+    programType: LoyaltyProgramTypeEnum;
+    metric: LoyaltyMetricEnum;
+    /** Бонусы в минорных единицах: один бонус равен одной единице валюты. */
+    balance: number;
+    /**
+     * Процент кэшбэка, который клиент получает сейчас, — со статуса, а
+     * если статуса нет, то базовый из настроек.
+     */
+    cashbackPercent: number;
+    source: LoyaltyTierSourceEnum;
+    /** Состоявшиеся игры, попавшие в зачёт программы. */
+    games: number;
+    /** Квесты и допуслуги в минорных единицах, попавшие в зачёт. */
+    revenue: number;
+    tier: LoyaltyTierRO | null;
+    nextTier: LoyaltyTierRO | null;
+    /** Сколько игр или денег не хватает до `nextTier`. */
+    toNextTier: number;
+}

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

@@ -0,0 +1,71 @@
+"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.ClientLoyaltyRO = void 0;
+const class_transformer_1 = require("class-transformer");
+const loyalty_metric_enum_1 = require("./enum/loyalty-metric.enum");
+const loyalty_program_type_enum_1 = require("./enum/loyalty-program-type.enum");
+const loyalty_tier_source_enum_1 = require("./enum/loyalty-tier-source.enum");
+const loyalty_tier_ro_1 = require("./loyalty-tier.ro");
+/**
+ * Состояние одного клиента в программе: статус, накопленные счётчики и
+ * остаток до следующего статуса. Отдаётся и при выключенной программе —
+ * карточка клиента тогда просто ничего не рисует.
+ */
+class ClientLoyaltyRO {
+}
+exports.ClientLoyaltyRO = ClientLoyaltyRO;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], ClientLoyaltyRO.prototype, "enabled", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], ClientLoyaltyRO.prototype, "programType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], ClientLoyaltyRO.prototype, "metric", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ClientLoyaltyRO.prototype, "balance", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ClientLoyaltyRO.prototype, "cashbackPercent", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], ClientLoyaltyRO.prototype, "source", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ClientLoyaltyRO.prototype, "games", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ClientLoyaltyRO.prototype, "revenue", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => loyalty_tier_ro_1.LoyaltyTierRO),
+    __metadata("design:type", loyalty_tier_ro_1.LoyaltyTierRO)
+], ClientLoyaltyRO.prototype, "tier", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => loyalty_tier_ro_1.LoyaltyTierRO),
+    __metadata("design:type", loyalty_tier_ro_1.LoyaltyTierRO)
+], ClientLoyaltyRO.prototype, "nextTier", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ClientLoyaltyRO.prototype, "toNextTier", void 0);

package/dist/loyalty/enum/loyalty-bonus-type.enum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Тип операции в журнале бонусов. Баланс клиента — не колонка, а сумма
+ * этого журнала: без операций нельзя ни объяснить клиенту, откуда взялись
+ * его 350, ни откатить списание при отмене игры.
+ */
+export declare enum LoyaltyBonusTypeEnum {
+    /** Кэшбэк за состоявшуюся игру. Одна операция на игру. */
+    ACCRUAL = "accrual",
+    /** Оплата игры бонусами. Хранится отрицательной суммой. */
+    SPENDING = "spending",
+    /** Правка администратора: подарок, компенсация, исправление ошибки. */
+    MANUAL = "manual"
+}

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyBonusTypeEnum = void 0;
+/**
+ * Тип операции в журнале бонусов. Баланс клиента — не колонка, а сумма
+ * этого журнала: без операций нельзя ни объяснить клиенту, откуда взялись
+ * его 350, ни откатить списание при отмене игры.
+ */
+var LoyaltyBonusTypeEnum;
+(function (LoyaltyBonusTypeEnum) {
+    /** Кэшбэк за состоявшуюся игру. Одна операция на игру. */
+    LoyaltyBonusTypeEnum["ACCRUAL"] = "accrual";
+    /** Оплата игры бонусами. Хранится отрицательной суммой. */
+    LoyaltyBonusTypeEnum["SPENDING"] = "spending";
+    /** Правка администратора: подарок, компенсация, исправление ошибки. */
+    LoyaltyBonusTypeEnum["MANUAL"] = "manual";
+})(LoyaltyBonusTypeEnum || (exports.LoyaltyBonusTypeEnum = LoyaltyBonusTypeEnum = {}));

package/dist/loyalty/enum/loyalty-history-mode.enum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Что делать с историей существующих клиентов в момент включения
+ * программы. Вопрос задаётся один раз при онбординге и превращается в
+ * дату отсечки `countFrom`, после чего накопление всегда идёт вперёд:
+ * статус не сгорает.
+ *
+ * `ALL` — зачесть всю историю: половина базы получит статус сразу.
+ * `LAST_YEAR` — зачесть игры за последние 12 месяцев на момент
+ * включения. Отсечка замораживается датой, а не «ползёт» вместе с
+ * сегодняшним днём, — иначе клиент терял бы статус просто от того, что
+ * год назад он играл, а сейчас нет.
+ * `FROM_ACTIVATION` — начать всех с нуля, считать только новые игры.
+ */
+export declare enum LoyaltyHistoryModeEnum {
+    ALL = "all",
+    LAST_YEAR = "lastYear",
+    FROM_ACTIVATION = "fromActivation"
+}

package/dist/loyalty/enum/loyalty-history-mode.enum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyHistoryModeEnum = void 0;
+/**
+ * Что делать с историей существующих клиентов в момент включения
+ * программы. Вопрос задаётся один раз при онбординге и превращается в
+ * дату отсечки `countFrom`, после чего накопление всегда идёт вперёд:
+ * статус не сгорает.
+ *
+ * `ALL` — зачесть всю историю: половина базы получит статус сразу.
+ * `LAST_YEAR` — зачесть игры за последние 12 месяцев на момент
+ * включения. Отсечка замораживается датой, а не «ползёт» вместе с
+ * сегодняшним днём, — иначе клиент терял бы статус просто от того, что
+ * год назад он играл, а сейчас нет.
+ * `FROM_ACTIVATION` — начать всех с нуля, считать только новые игры.
+ */
+var LoyaltyHistoryModeEnum;
+(function (LoyaltyHistoryModeEnum) {
+    LoyaltyHistoryModeEnum["ALL"] = "all";
+    LoyaltyHistoryModeEnum["LAST_YEAR"] = "lastYear";
+    LoyaltyHistoryModeEnum["FROM_ACTIVATION"] = "fromActivation";
+})(LoyaltyHistoryModeEnum || (exports.LoyaltyHistoryModeEnum = LoyaltyHistoryModeEnum = {}));

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

@@ -0,0 +1,12 @@
+/**
+ * По какому счётчику клиент поднимается по статусам.
+ *
+ * `GAMES` — состоявшиеся игры, `REVENUE` — сумма, которую клиент оставил
+ * за квесты и допуслуги. Одновременно работает только одна метрика:
+ * пороги «5 игр» и «5 000» отбирают разные множества клиентов, и
+ * объяснить администратору смешанное правило почти невозможно.
+ */
+export declare enum LoyaltyMetricEnum {
+    GAMES = "games",
+    REVENUE = "revenue"
+}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyMetricEnum = void 0;
+/**
+ * По какому счётчику клиент поднимается по статусам.
+ *
+ * `GAMES` — состоявшиеся игры, `REVENUE` — сумма, которую клиент оставил
+ * за квесты и допуслуги. Одновременно работает только одна метрика:
+ * пороги «5 игр» и «5 000» отбирают разные множества клиентов, и
+ * объяснить администратору смешанное правило почти невозможно.
+ */
+var LoyaltyMetricEnum;
+(function (LoyaltyMetricEnum) {
+    LoyaltyMetricEnum["GAMES"] = "games";
+    LoyaltyMetricEnum["REVENUE"] = "revenue";
+})(LoyaltyMetricEnum || (exports.LoyaltyMetricEnum = LoyaltyMetricEnum = {}));

package/dist/loyalty/enum/loyalty-program-type.enum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Какую механику компания включила. Программы взаимоисключающие: клиент
+ * не может одновременно получать скидку за статус и кэшбэк с той же
+ * игры — иначе одна и та же лояльность стоила бы венью дважды, а
+ * администратор на стойке не смог бы объяснить итоговую цифру в чеке.
+ */
+export declare enum LoyaltyProgramTypeEnum {
+    /** Статус даёт процент скидки сразу в чеке текущей игры. */
+    DISCOUNT = "discount",
+    /** Игра начисляет бонусы на баланс клиента, ими платят в следующий раз. */
+    CASHBACK = "cashback"
+}

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[];
+}