@escapenavigator/types 2.0.37 → 2.0.38

package/dist/profile/marketing-email/create-profile-marketing-email-campaign.dto.js

@@ -9,35 +9,12 @@ 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.CreateProfileMarketingEmailCampaignDto = exports.EmailContentJsonV2Dto = void 0;
+exports.CreateProfileMarketingEmailCampaignDto = exports.EmailContentDto = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const email_builder_1 = require("../../email-builder");
+const email_content_dto_1 = require("../../email-builder/email-content.dto");
+Object.defineProperty(exports, "EmailContentDto", { enumerable: true, get: function () { return email_content_dto_1.EmailContentDto; } });
 const profile_marketing_email_goal_enum_1 = require("./profile-marketing-email-goal.enum");
-/**
- * Body of the campaign content payload — strict v2 schema produced by
- * the maily.to-based editor. Variable substitution / UTM injection /
- * footer are applied at send time on alfa-mailer.
- */
-class EmailContentJsonV2Dto {
-}
-exports.EmailContentJsonV2Dto = EmailContentJsonV2Dto;
-__decorate([
-    (0, class_validator_1.Equals)(email_builder_1.EMAIL_CONTENT_VERSION_V2),
-    (0, class_transformer_1.Expose)(),
-    __metadata("design:type", Object)
-], EmailContentJsonV2Dto.prototype, "version", void 0);
-__decorate([
-    (0, class_validator_1.IsObject)(),
-    (0, class_transformer_1.Expose)(),
-    __metadata("design:type", Object)
-], EmailContentJsonV2Dto.prototype, "doc", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsObject)(),
-    (0, class_transformer_1.Expose)(),
-    __metadata("design:type", Object)
-], EmailContentJsonV2Dto.prototype, "theme", void 0);
 class CreateProfileMarketingEmailCampaignDto {
 }
 exports.CreateProfileMarketingEmailCampaignDto = CreateProfileMarketingEmailCampaignDto;
@@ -91,9 +68,9 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => EmailContentJsonV2Dto),
+    (0, class_transformer_1.Type)(() => email_content_dto_1.EmailContentDto),
     (0, class_transformer_1.Expose)(),
-    __metadata("design:type", EmailContentJsonV2Dto)
+    __metadata("design:type", email_content_dto_1.EmailContentDto)
 ], CreateProfileMarketingEmailCampaignDto.prototype, "contentJson", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
@@ -146,6 +123,20 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)
 ], CreateProfileMarketingEmailCampaignDto.prototype, "attributionWindowDays", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(365),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CreateProfileMarketingEmailCampaignDto.prototype, "frequencyCapDays", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], CreateProfileMarketingEmailCampaignDto.prototype, "respectQuietHours", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),

package/dist/profile/marketing-email/preflight-issue.ro.d.ts

@@ -16,7 +16,37 @@ export declare enum PreflightIssueCodeEnum {
     NonUniqueUtmCampaign = "non_unique_utm_campaign",
     NoUnsubscribe = "no_unsubscribe",
     NoGoals = "no_goals",
-    NoConsentFilter = "no_consent_filter"
+    NoConsentFilter = "no_consent_filter",
+    /**
+     * Письмо тяжелее ~102 КБ: Gmail покажет «просмотреть всё сообщение»,
+     * и в обрезанный хвост уедет футер с отпиской. Предупреждение, не
+     * блокер — тяжёлые письма законны, просто хуже работают.
+     */
+    ContentTooLarge = "content_too_large",
+    /**
+     * В теле нет ни одной ссылки. Для рекламного письма это почти всегда
+     * ошибка вёрстки (потерянная CTA), а не осознанный выбор.
+     */
+    NoLinks = "no_links",
+    /** Картинки без `alt`: часть клиентов блокирует изображения по умолчанию. */
+    ImagesWithoutAlt = "images_without_alt",
+    /**
+     * В теле остались `{{переменные}}`, которых нет в scope письма —
+     * получатель увидит их буквально.
+     */
+    UnresolvedVariables = "unresolved_variables",
+    /**
+     * Запуск попал в тихие часы и будет сдвинут на утро. Предупреждение,
+     * а не блокер: отправка состоится, просто позже — и пользователь
+     * должен узнать об этом до нажатия «Отправить», а не из отчёта.
+     */
+    QuietHours = "quiet_hours",
+    /**
+     * Аудитория больше суточного лимита прогрева домена — отправка
+     * растянется на несколько дней. Предупреждение: письма не теряются,
+     * но пользователь должен понимать, почему «отправлено» растёт медленно.
+     */
+    DomainWarmup = "domain_warmup"
 }
 export declare class PreflightIssueRO {
     severity: PreflightIssueSeverityEnum;

package/dist/profile/marketing-email/preflight-issue.ro.js

@@ -32,6 +32,36 @@ var PreflightIssueCodeEnum;
     PreflightIssueCodeEnum["NoUnsubscribe"] = "no_unsubscribe";
     PreflightIssueCodeEnum["NoGoals"] = "no_goals";
     PreflightIssueCodeEnum["NoConsentFilter"] = "no_consent_filter";
+    /**
+     * Письмо тяжелее ~102 КБ: Gmail покажет «просмотреть всё сообщение»,
+     * и в обрезанный хвост уедет футер с отпиской. Предупреждение, не
+     * блокер — тяжёлые письма законны, просто хуже работают.
+     */
+    PreflightIssueCodeEnum["ContentTooLarge"] = "content_too_large";
+    /**
+     * В теле нет ни одной ссылки. Для рекламного письма это почти всегда
+     * ошибка вёрстки (потерянная CTA), а не осознанный выбор.
+     */
+    PreflightIssueCodeEnum["NoLinks"] = "no_links";
+    /** Картинки без `alt`: часть клиентов блокирует изображения по умолчанию. */
+    PreflightIssueCodeEnum["ImagesWithoutAlt"] = "images_without_alt";
+    /**
+     * В теле остались `{{переменные}}`, которых нет в scope письма —
+     * получатель увидит их буквально.
+     */
+    PreflightIssueCodeEnum["UnresolvedVariables"] = "unresolved_variables";
+    /**
+     * Запуск попал в тихие часы и будет сдвинут на утро. Предупреждение,
+     * а не блокер: отправка состоится, просто позже — и пользователь
+     * должен узнать об этом до нажатия «Отправить», а не из отчёта.
+     */
+    PreflightIssueCodeEnum["QuietHours"] = "quiet_hours";
+    /**
+     * Аудитория больше суточного лимита прогрева домена — отправка
+     * растянется на несколько дней. Предупреждение: письма не теряются,
+     * но пользователь должен понимать, почему «отправлено» растёт медленно.
+     */
+    PreflightIssueCodeEnum["DomainWarmup"] = "domain_warmup";
 })(PreflightIssueCodeEnum || (exports.PreflightIssueCodeEnum = PreflightIssueCodeEnum = {}));
 class PreflightIssueRO {
 }

package/dist/profile/marketing-email/preview-campaign-v2.dto.d.ts

@@ -1,5 +1,5 @@
 import { EmailScope } from '../../email-builder';
-import { EmailContentJsonV2Dto } from './create-profile-marketing-email-campaign.dto';
+import { EmailContentDto } from './create-profile-marketing-email-campaign.dto';
 /**
  * Promocode-payload для preview. Фронт собирает поля из реальных
  * настроек письма (cross-sale/retargeting/birthday-discount form
@@ -27,7 +27,7 @@ export declare class PreviewPromocodeDto {
  * for the current profile) or from the scope's `exampleValue`s.
  */
 export declare class PreviewMarketingEmailCampaignV2Dto {
-    contentJson: EmailContentJsonV2Dto;
+    contentJson: EmailContentDto;
     scope: EmailScope;
     /** Optional: render with a specific client's data for end-to-end QA. */
     previewClientId?: number;

package/dist/profile/marketing-email/preview-campaign-v2.dto.js

@@ -56,9 +56,9 @@ exports.PreviewMarketingEmailCampaignV2Dto = PreviewMarketingEmailCampaignV2Dto;
 __decorate([
     (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => create_profile_marketing_email_campaign_dto_1.EmailContentJsonV2Dto),
+    (0, class_transformer_1.Type)(() => create_profile_marketing_email_campaign_dto_1.EmailContentDto),
     (0, class_transformer_1.Expose)(),
-    __metadata("design:type", create_profile_marketing_email_campaign_dto_1.EmailContentJsonV2Dto)
+    __metadata("design:type", create_profile_marketing_email_campaign_dto_1.EmailContentDto)
 ], PreviewMarketingEmailCampaignV2Dto.prototype, "contentJson", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(email_builder_1.EmailScope),

package/dist/profile/marketing-email/preview-profile-marketing-segment.dto.d.ts

@@ -4,4 +4,10 @@
  */
 export declare class PreviewProfileMarketingSegmentDto {
     clientFilters?: Record<string, unknown>;
+    /**
+     * Frequency cap черновика. Приходит из формы, а не из БД: билдер
+     * пересчитывает аудиторию по несохранённым настройкам, и панель должна
+     * реагировать на ползунок сразу.
+     */
+    frequencyCapDays?: number;
 }

package/dist/profile/marketing-email/preview-profile-marketing-segment.dto.js

@@ -25,3 +25,11 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Object)
 ], PreviewProfileMarketingSegmentDto.prototype, "clientFilters", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(365),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], PreviewProfileMarketingSegmentDto.prototype, "frequencyCapDays", void 0);

package/dist/profile/marketing-email/preview-profile-marketing-segment.ro.d.ts

@@ -10,7 +10,11 @@
  *  - `bounced` — клиенты с ранее отлетевшим email (`hasComplaint === true`).
  *  - `suppressed` — пересечение `withConsent` с `profile-marketing-suppression`
  *    (hard bounces, complaints, manual-list).
- *  - `willBeSent` — итоговое число писем, которое уйдёт: `withConsent − suppressed`.
+ *  - `frequencyCapped` — клиенты, которым письмо уже доставляли за
+ *    последние `frequencyCapDays` дней (см. `frequency-cap.util`). `0`,
+ *    если cap выключен.
+ *  - `willBeSent` — итоговое число писем, которое уйдёт:
+ *    `withConsent − suppressed − frequencyCapped`.
  *
  * `count` сохранён для обратной совместимости со старым UI до переключения.
  */
@@ -22,5 +26,6 @@ export declare class PreviewProfileMarketingSegmentRO {
     unsubscribed: number;
     bounced: number;
     suppressed: number;
+    frequencyCapped: number;
     willBeSent: number;
 }

package/dist/profile/marketing-email/preview-profile-marketing-segment.ro.js

@@ -23,7 +23,11 @@ const class_transformer_1 = require("class-transformer");
  *  - `bounced` — клиенты с ранее отлетевшим email (`hasComplaint === true`).
  *  - `suppressed` — пересечение `withConsent` с `profile-marketing-suppression`
  *    (hard bounces, complaints, manual-list).
- *  - `willBeSent` — итоговое число писем, которое уйдёт: `withConsent − suppressed`.
+ *  - `frequencyCapped` — клиенты, которым письмо уже доставляли за
+ *    последние `frequencyCapDays` дней (см. `frequency-cap.util`). `0`,
+ *    если cap выключен.
+ *  - `willBeSent` — итоговое число писем, которое уйдёт:
+ *    `withConsent − suppressed − frequencyCapped`.
  *
  * `count` сохранён для обратной совместимости со старым UI до переключения.
  */
@@ -58,6 +62,10 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)
 ], PreviewProfileMarketingSegmentRO.prototype, "suppressed", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], PreviewProfileMarketingSegmentRO.prototype, "frequencyCapped", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)

package/dist/profile/marketing-email/profile-marketing-email-campaign.ro.d.ts

@@ -1,4 +1,4 @@
-import { EmailContentJsonV2 } from '../../email-builder';
+import { EmailContent } from '../../email-builder';
 import { RO } from '../../shared/ro-class';
 import { ProfileMarketingEmailCampaignStatusEnum } from './profile-marketing-email-campaign-status.enum';
 import { ProfileMarketingEmailGoalEnum } from './profile-marketing-email-goal.enum';
@@ -12,7 +12,7 @@ export declare class ProfileMarketingEmailCampaignRO extends RO {
     fromName: string | null;
     replyTo: string | null;
     senderId: number | null;
-    contentJson: EmailContentJsonV2;
+    contentJson: EmailContent;
     utmSource: string;
     utmMedium: string;
     utmCampaign: string;
@@ -20,6 +20,15 @@ export declare class ProfileMarketingEmailCampaignRO extends RO {
     utmTerm: string | null;
     goalTypes: ProfileMarketingEmailGoalEnum[];
     attributionWindowDays: number;
+    /** Frequency cap в днях; `0` — выключен. */
+    frequencyCapDays: number;
+    /** Сдвигать старт, если он попал в тихие часы. */
+    respectQuietHours: boolean;
+    /**
+     * Заполнено, когда доотправку сдерживает прогрев домена: кампания
+     * продолжится не раньше этого момента.
+     */
+    throttledUntil: Date | null;
     previewClientId: number | null;
     launchedAt: Date | null;
     scheduledAt: Date | null;

package/dist/profile/marketing-email/profile-marketing-email-campaign.ro.js

@@ -80,6 +80,18 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)
 ], ProfileMarketingEmailCampaignRO.prototype, "attributionWindowDays", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ProfileMarketingEmailCampaignRO.prototype, "frequencyCapDays", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], ProfileMarketingEmailCampaignRO.prototype, "respectQuietHours", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Date)
+], ProfileMarketingEmailCampaignRO.prototype, "throttledUntil", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)

package/dist/profile/marketing-email/profile-marketing-email-recipient-status.enum.d.ts

@@ -13,6 +13,12 @@ export declare enum ProfileMarketingEmailRecipientStatusEnum {
     SkippedInvalidEmail = "skipped_invalid_email",
     /** Дубль внутри той же кампании (одинаковый email у нескольких клиентов). */
     SkippedDuplicate = "skipped_duplicate",
+    /**
+     * Клиенту уже приходило маркетинговое письмо за последние
+     * `campaign.frequencyCapDays` дней. Не ошибка — сознательная защита
+     * списка от переписки, см. `ProfileMarketingEmailCampaignEntity`.
+     */
+    SkippedFrequencyCap = "skipped_frequency_cap",
     /** Кампания отменена до отправки этому получателю. */
     Cancelled = "cancelled"
 }

package/dist/profile/marketing-email/profile-marketing-email-recipient-status.enum.js

@@ -17,6 +17,12 @@ var ProfileMarketingEmailRecipientStatusEnum;
     ProfileMarketingEmailRecipientStatusEnum["SkippedInvalidEmail"] = "skipped_invalid_email";
     /** Дубль внутри той же кампании (одинаковый email у нескольких клиентов). */
     ProfileMarketingEmailRecipientStatusEnum["SkippedDuplicate"] = "skipped_duplicate";
+    /**
+     * Клиенту уже приходило маркетинговое письмо за последние
+     * `campaign.frequencyCapDays` дней. Не ошибка — сознательная защита
+     * списка от переписки, см. `ProfileMarketingEmailCampaignEntity`.
+     */
+    ProfileMarketingEmailRecipientStatusEnum["SkippedFrequencyCap"] = "skipped_frequency_cap";
     /** Кампания отменена до отправки этому получателю. */
     ProfileMarketingEmailRecipientStatusEnum["Cancelled"] = "cancelled";
 })(ProfileMarketingEmailRecipientStatusEnum || (exports.ProfileMarketingEmailRecipientStatusEnum = ProfileMarketingEmailRecipientStatusEnum = {}));

package/dist/profile/marketing-email/test-send-email-v2.dto.d.ts

@@ -1,7 +1,7 @@
 import { EmailScope } from '../../email-builder';
 import { Languages } from '../../shared/enum/languages.enum';
 import { MarketingAutomationTypeEnum } from '../marketing-automation/marketing-automation-type.enum';
-import { EmailContentJsonV2Dto } from './create-profile-marketing-email-campaign.dto';
+import { EmailContentDto } from './create-profile-marketing-email-campaign.dto';
 import { PreviewPromocodeDto } from './preview-campaign-v2.dto';
 /**
  * Request body for `POST /profile-marketing-email-campaigns/test-send-v2`.
@@ -20,7 +20,7 @@ import { PreviewPromocodeDto } from './preview-campaign-v2.dto';
  *    `marketing-campaign`) → нужен `clientId` (номер клиента в профиле).
  */
 export declare class TestSendMarketingEmailV2Dto {
-    contentJson: EmailContentJsonV2Dto;
+    contentJson: EmailContentDto;
     scope: EmailScope;
     /** Куда отправить тестовое письмо (inbox оператора). */
     email: string;

package/dist/profile/marketing-email/test-send-email-v2.dto.js

@@ -39,9 +39,9 @@ exports.TestSendMarketingEmailV2Dto = TestSendMarketingEmailV2Dto;
 __decorate([
     (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => create_profile_marketing_email_campaign_dto_1.EmailContentJsonV2Dto),
+    (0, class_transformer_1.Type)(() => create_profile_marketing_email_campaign_dto_1.EmailContentDto),
     (0, class_transformer_1.Expose)(),
-    __metadata("design:type", create_profile_marketing_email_campaign_dto_1.EmailContentJsonV2Dto)
+    __metadata("design:type", create_profile_marketing_email_campaign_dto_1.EmailContentDto)
 ], TestSendMarketingEmailV2Dto.prototype, "contentJson", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(email_builder_1.EmailScope),

package/dist/questroom-scenario-email/create-questroom-scenario-email.dto.d.ts

@@ -1,4 +1,4 @@
-import { EmailContentJsonV2 } from '../email-builder';
+import { EmailContent } from '../email-builder';
 export declare class CreateQuestroomScenarioEmailDto {
     title: string;
     text: string;
@@ -13,7 +13,7 @@ export declare class CreateQuestroomScenarioEmailDto {
      * fallback'а — v1 `transformText` всё ещё доступен через
      * `feedbackText`/`text` для пользователей, не прошедших backfill.
      */
-    contentJson?: EmailContentJsonV2 | null;
+    contentJson?: EmailContent | null;
     sendImmediately: boolean;
     sendBefore: number;
     questroomId: number;

package/dist/questroom-scenario-email/create-questroom-scenario-email.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateQuestroomScenarioEmailDto = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const email_content_dto_1 = require("../email-builder/email-content.dto");
 const is_not_blank_1 = require("../shared/is-not-blank");
 class CreateQuestroomScenarioEmailDto {
 }
@@ -28,7 +29,8 @@ __decorate([
 ], CreateQuestroomScenarioEmailDto.prototype, "text", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => email_content_dto_1.EmailContentDto),
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Object)
 ], CreateQuestroomScenarioEmailDto.prototype, "contentJson", void 0);

package/dist/questroom-scenario-email/questroom-scenario-email.ro.d.ts

@@ -1,9 +1,9 @@
-import { EmailContentJsonV2 } from '../email-builder';
+import { EmailContent } from '../email-builder';
 import { RO } from '../shared/ro-class';
 export declare class QuestroomScenarioEmailRO extends RO {
     title: string;
     text: string;
-    contentJson?: EmailContentJsonV2 | null;
+    contentJson?: EmailContent | null;
     sendBefore: number;
     sendImmediately: boolean;
     questroomId: number;

package/dist/slot/slot-discount-range.validator.js

@@ -24,7 +24,7 @@ let SlotDiscountRangeConstraint = class SlotDiscountRangeConstraint {
         if (!Number.isFinite(discount) || discount < 0)
             return false;
         const { discountType } = args.object;
-        return discount <= (discountType === slot_discount_type_enum_1.SlotDiscountTypeEnum.FIXED ? MAX_FIXED_DISCOUNT : 10000);
+        return (discount <= (discountType === slot_discount_type_enum_1.SlotDiscountTypeEnum.FIXED ? MAX_FIXED_DISCOUNT : 10000));
     }
     defaultMessage() {
         return 'slotDiscountOutOfRange';