@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/offers/schemas/offer-presentation.schema.js

@@ -5,7 +5,13 @@ const zod_1 = require("zod");
 const offer_cta_action_enum_1 = require("./offer-cta-action.enum");
 const offer_countdown_mode_enum_1 = require("./offer-countdown-mode.enum");
 const shared_1 = require("../../../shared");
+/** Protocols this offer's `cta.url` may use — anything else (`javascript:`, `data:`, `vbscript:`, …) is stored XSS. */
 const OFFER_CTA_URL_ALLOWED_PROTOCOLS = new Set(['http:', 'https:']);
+/**
+ * `z.string().url()` alone accepts `javascript:alert(1)` and `data:text/html,...` — both are
+ * valid URLs by WHATWG rules, and both execute if the frontend ever renders `cta.url` as an
+ * anchor `href` or redirect target (P0 spec §6 renders it verbatim). Restrict to http(s) only.
+ */
 function isHttpOrHttpsUrl(value) {
     try {
         return OFFER_CTA_URL_ALLOWED_PROTOCOLS.has(new URL(value).protocol);
@@ -36,7 +42,25 @@ exports.OfferPresentationCtaSchema = zod_1.z
         });
     }
 });
+/**
+ * Максимум догоняющих касаний по одному офферу.
+ *
+ * Четыре плюс само уведомление о выдаче — это пять. Дальше начинается участок, где отклики
+ * падают примерно вдвое, а жалобы на спам растут кратно: платит за это доставляемость всего
+ * домена, а не одна кампания.
+ */
 exports.OFFER_MAX_FOLLOW_UPS = 4;
+/**
+ * Догоняющее касание по невзятому офферу.
+ *
+ * У каждого своя копия, и это не украшение. Человек, не купивший по офферу, чаще всего не
+ * «не заметил», а не совпал с предложением: повтор того же текста громче просто расходует
+ * доверие. Поэтому касание обязано менять угол — другую выгоду, другой сценарий, другой повод, —
+ * а не пересылать первое письмо ещё раз.
+ *
+ * `delayMs` считается от МОМЕНТА АКТИВАЦИИ оффера, а не от выдачи: у кампании с задержкой это
+ * разные даты, и отсчитывать дожим от несуществующего для человека события бессмысленно.
+ */
 exports.OfferFollowUpSchema = zod_1.z.object({
     delayMs: zod_1.z
         .number({ error: 'OfferFollowUp.delayMs.required' })
@@ -53,7 +77,12 @@ exports.OfferFollowUpSchema = zod_1.z.object({
         .optional(),
     cta: exports.OfferPresentationCtaSchema,
 });
+/**
+ * `offer_campaigns.presentation` JSON payload — only Russian text (P0 decision),
+ * flat structure without language keys.
+ */
 exports.OfferPresentationSchema = zod_1.z.object({
+    /** Frontend-known skin identifier; not an enum on purpose (frontend owns the set). */
     variant: zod_1.z
         .string({ error: 'OfferPresentation.variant.required' })
         .min(1, { message: 'OfferPresentation.variant.min' })
@@ -74,6 +103,10 @@ exports.OfferPresentationSchema = zod_1.z.object({
         .optional(),
     cta: exports.OfferPresentationCtaSchema,
     dismissible: zod_1.z.boolean({ error: 'OfferPresentation.dismissible.invalid' }),
+    /**
+     * Картинка баннера. Произвольная http(s)-ссылка — в отличие от письма, где иллюстрации
+     * берутся из каталога.
+     */
     imageUrl: zod_1.z
         .string({ error: 'OfferPresentation.imageUrl.invalid' })
         .url({ message: 'OfferPresentation.imageUrl.invalid' })
@@ -82,26 +115,46 @@ exports.OfferPresentationSchema = zod_1.z.object({
         message: 'OfferPresentation.imageUrl.protocolNotAllowed',
     })
         .optional(),
+    /**
+     * Какую иллюстрацию поставить в письмо догона. Ключ из каталога писем; набор принадлежит
+     * рендереру, не контракту — та же логика, что у `variant`. Неизвестный ключ рендерер
+     * заменит на свой дефолт, а не уронит письмо.
+     */
     emailAsset: zod_1.z
         .string({ error: 'OfferPresentation.emailAsset.invalid' })
         .min(1, { message: 'OfferPresentation.emailAsset.min' })
         .max(64, { message: 'OfferPresentation.emailAsset.max' })
         .optional(),
+    /** Обратный отсчёт в баннере. По умолчанию таймера нет. */
     countdown: zod_1.z
         .enum(offer_countdown_mode_enum_1.OfferCountdownMode, { error: 'OfferPresentation.countdown.invalid' })
         .default(offer_countdown_mode_enum_1.OfferCountdownMode.NONE),
+    /**
+     * Длительность отсчёта для режима `FIRST_VIEW`, мс строкой. У остальных режимов дедлайн
+     * берётся из даты, а не из длительности, поэтому поле обязано быть пустым — иначе в
+     * конфиге осталось бы значение, на которое никто не смотрит.
+     */
     countdownMs: zod_1.z
         .string({ error: 'OfferPresentation.countdownMs.invalid' })
         .regex(shared_1.POSITIVE_BIGINT_STRING_REGEX, { message: 'OfferPresentation.countdownMs.invalid' })
         .nullable()
         .optional()
         .default(null),
+    /**
+     * Догоны по невзятому офферу, строго по возрастанию задержки и без повторов — это
+     * проверяет агрегат кампании, потому что нарушение не падает, а молча не отправляется.
+     * Пустой список — кампания без дожима: выдали и молчим.
+     */
     followUps: zod_1.z
         .array(exports.OfferFollowUpSchema)
         .max(exports.OFFER_MAX_FOLLOW_UPS, { message: 'OfferPresentation.followUps.max' })
         .default([]),
 })
     .superRefine((v, ctx) => {
+    // Пара «режим ↔ длительность» всё-или-ничего, как `promoTemplate`/`promoTtlMs` уровнем
+    // выше. Режим без длительности — полоса, которая обещает отсчёт и не может его
+    // показать; длительность без режима — мёртвое поле, которое следующий человек примет
+    // за настройку.
     if (v.countdown === offer_countdown_mode_enum_1.OfferCountdownMode.FIRST_VIEW && v.countdownMs === null) {
         ctx.addIssue({
             code: zod_1.z.ZodIssueCode.custom,

package/build/v1/offers/schemas/offer-presentation.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"offer-presentation.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-presentation.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"offer-presentation.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-presentation.schema.ts"],"names":[],"mappings":"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"}

package/build/v1/offers/schemas/offer-promo-template.schema.d.ts

@@ -1,10 +1,19 @@
 import { z } from 'zod';
 import { PlanType } from '../../plans/schemas/plan-type.enum';
 export declare const OFFER_PROMO_CODE_PREFIX_REGEX: RegExp;
+/**
+ * PromoTemplate kind discriminator. P0 ships a single member; the union
+ * shape guarantees adding e.g. PERCENT_OFF later needs no data migration.
+ */
 export declare enum OfferPromoTemplateKind {
     PURCHASE_MULTIPLIER = "PURCHASE_MULTIPLIER",
+    /**
+     * Фиксированное начисление бонусных токенов на баланс в момент выдачи — без промокода.
+     * Так офферы выдают и учитывают бонусы, которые раньше начислялись в обход платформы.
+     */
     BALANCE_GRANT = "BALANCE_GRANT"
 }
+/** Срок жизни начисленного бонусного баланса, дни. */
 export declare const OFFER_BALANCE_GRANT_TTL_DAYS_MAX = 365;
 export declare const PurchaseMultiplierTemplateSchema: z.ZodObject<{
     kind: z.ZodLiteral<OfferPromoTemplateKind.PURCHASE_MULTIPLIER>;
@@ -23,6 +32,11 @@ export declare const BalanceGrantTemplateSchema: z.ZodObject<{
     grantTtlDays: z.ZodNumber;
 }, z.core.$strip>;
 export type BalanceGrantTemplate = z.infer<typeof BalanceGrantTemplateSchema>;
+/**
+ * `offer_campaigns.promoTemplate` JSON payload — discriminated by `kind` so
+ * new template variants (P2: PERCENT_OFF, ...) slot in without breaking
+ * existing rows. A single-member union today, on purpose (see P0 spec §5).
+ */
 export declare const OfferPromoTemplateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<OfferPromoTemplateKind.PURCHASE_MULTIPLIER>;
     bonusPercent: z.ZodNumber;
@@ -38,4 +52,5 @@ export declare const OfferPromoTemplateSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     grantTtlDays: z.ZodNumber;
 }, z.core.$strip>], "kind">;
 export type OfferPromoTemplate = z.infer<typeof OfferPromoTemplateSchema>;
+/** Промокод (и его TTL) выпускает только шаблон покупочного множителя; начисление обходится без кода. */
 export declare function offerTemplateMintsPromoCode(template: OfferPromoTemplate | null): boolean;

package/build/v1/offers/schemas/offer-promo-template.schema.js

@@ -6,11 +6,20 @@ const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const plan_type_enum_1 = require("../../plans/schemas/plan-type.enum");
 exports.OFFER_PROMO_CODE_PREFIX_REGEX = /^[A-Z0-9]{2,12}$/;
+/**
+ * PromoTemplate kind discriminator. P0 ships a single member; the union
+ * shape guarantees adding e.g. PERCENT_OFF later needs no data migration.
+ */
 var OfferPromoTemplateKind;
 (function (OfferPromoTemplateKind) {
     OfferPromoTemplateKind["PURCHASE_MULTIPLIER"] = "PURCHASE_MULTIPLIER";
+    /**
+     * Фиксированное начисление бонусных токенов на баланс в момент выдачи — без промокода.
+     * Так офферы выдают и учитывают бонусы, которые раньше начислялись в обход платформы.
+     */
     OfferPromoTemplateKind["BALANCE_GRANT"] = "BALANCE_GRANT";
 })(OfferPromoTemplateKind || (exports.OfferPromoTemplateKind = OfferPromoTemplateKind = {}));
+/** Срок жизни начисленного бонусного баланса, дни. */
 exports.OFFER_BALANCE_GRANT_TTL_DAYS_MAX = 365;
 exports.PurchaseMultiplierTemplateSchema = zod_1.z.object({
     kind: zod_1.z.literal(OfferPromoTemplateKind.PURCHASE_MULTIPLIER),
@@ -19,6 +28,7 @@ exports.PurchaseMultiplierTemplateSchema = zod_1.z.object({
         .int({ message: 'OfferPromoTemplate.bonusPercent.invalid' })
         .min(1, { message: 'OfferPromoTemplate.bonusPercent.min' })
         .max(100, { message: 'OfferPromoTemplate.bonusPercent.max' }),
+    /** BigInt (tokens) serialized as digit-only string. */
     maxBonusAmount: zod_1.z
         .string({ error: 'OfferPromoTemplate.maxBonusAmount.invalid' })
         .regex(shared_1.BIGINT_STRING_REGEX, { message: 'OfferPromoTemplate.maxBonusAmount.invalid' }),
@@ -36,6 +46,7 @@ exports.PurchaseMultiplierTemplateSchema = zod_1.z.object({
     firstPurchaseOnly: zod_1.z
         .boolean({ error: 'OfferPromoTemplate.firstPurchaseOnly.invalid' })
         .optional(),
+    /** BigInt (tokens) serialized as digit-only string. */
     minPurchaseAmount: zod_1.z
         .string({ error: 'OfferPromoTemplate.minPurchaseAmount.invalid' })
         .regex(shared_1.BIGINT_STRING_REGEX, { message: 'OfferPromoTemplate.minPurchaseAmount.invalid' })
@@ -43,6 +54,7 @@ exports.PurchaseMultiplierTemplateSchema = zod_1.z.object({
 });
 exports.BalanceGrantTemplateSchema = zod_1.z.object({
     kind: zod_1.z.literal(OfferPromoTemplateKind.BALANCE_GRANT),
+    /** BigInt (tokens) serialized as digit-only string. */
     amount: zod_1.z
         .string({ error: 'OfferPromoTemplate.amount.required' })
         .regex(shared_1.BIGINT_STRING_REGEX, { message: 'OfferPromoTemplate.amount.invalid' }),
@@ -52,10 +64,16 @@ exports.BalanceGrantTemplateSchema = zod_1.z.object({
         .min(1, { message: 'OfferPromoTemplate.grantTtlDays.min' })
         .max(exports.OFFER_BALANCE_GRANT_TTL_DAYS_MAX, { message: 'OfferPromoTemplate.grantTtlDays.max' }),
 });
+/**
+ * `offer_campaigns.promoTemplate` JSON payload — discriminated by `kind` so
+ * new template variants (P2: PERCENT_OFF, ...) slot in without breaking
+ * existing rows. A single-member union today, on purpose (see P0 spec §5).
+ */
 exports.OfferPromoTemplateSchema = zod_1.z.discriminatedUnion('kind', [
     exports.PurchaseMultiplierTemplateSchema,
     exports.BalanceGrantTemplateSchema,
 ]);
+/** Промокод (и его TTL) выпускает только шаблон покупочного множителя; начисление обходится без кода. */
 function offerTemplateMintsPromoCode(template) {
     return template !== null && template.kind === OfferPromoTemplateKind.PURCHASE_MULTIPLIER;
 }

package/build/v1/offers/schemas/offer-promo-template.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"offer-promo-template.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-promo-template.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"offer-promo-template.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-promo-template.schema.ts"],"names":[],"mappings":"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"}

package/build/v1/offers/schemas/offer-trigger-type.enum.d.ts

@@ -1,8 +1,26 @@
+/**
+ * Event that causes an OfferCampaign to issue a UserOffer.
+ * USER_REGISTERED срабатывает синхронно на регистрации, CHECKOUT_ABANDONED — свипом по
+ * брошенным заказам, MANUAL выдаётся только руками из админки.
+ */
 export declare enum OfferTriggerType {
     USER_REGISTERED = "USER_REGISTERED",
+    /**
+     * Человек начал оформление и не довёл его до оплаты.
+     *
+     * Признак — свип брошенных корзин: заказ создан и не оплачен до истечения своего срока.
+     * До этого на том же признаке висела лестница писем CART_*; её заменил оффер, у которого,
+     * в отличие от неё, есть что предложить, а не только напоминание.
+     */
     CHECKOUT_ABANDONED = "CHECKOUT_ABANDONED",
+    /** Возврат уснувшего пользователя: аудиторию и гарды определяет WINBACK-свип engagement. */
     USER_DORMANT = "USER_DORMANT",
+    /** Стартовый баланс закончился в первый день: момент и письмо — у engagement. */
     BALANCE_EXHAUSTED = "BALANCE_EXHAUSTED",
+    /**
+     * FRAUD-аккаунт привязал уже использованную соцсеть: реабилитировать его может только
+     * покупка, и бонус к ней — единственный бонус, который такому аккаунту положен.
+     */
     FRAUD_REHABILITATION = "FRAUD_REHABILITATION",
     MANUAL = "MANUAL"
 }

package/build/v1/offers/schemas/offer-trigger-type.enum.js

@@ -1,12 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OfferTriggerType = void 0;
+/**
+ * Event that causes an OfferCampaign to issue a UserOffer.
+ * USER_REGISTERED срабатывает синхронно на регистрации, CHECKOUT_ABANDONED — свипом по
+ * брошенным заказам, MANUAL выдаётся только руками из админки.
+ */
 var OfferTriggerType;
 (function (OfferTriggerType) {
     OfferTriggerType["USER_REGISTERED"] = "USER_REGISTERED";
+    /**
+     * Человек начал оформление и не довёл его до оплаты.
+     *
+     * Признак — свип брошенных корзин: заказ создан и не оплачен до истечения своего срока.
+     * До этого на том же признаке висела лестница писем CART_*; её заменил оффер, у которого,
+     * в отличие от неё, есть что предложить, а не только напоминание.
+     */
     OfferTriggerType["CHECKOUT_ABANDONED"] = "CHECKOUT_ABANDONED";
+    /** Возврат уснувшего пользователя: аудиторию и гарды определяет WINBACK-свип engagement. */
     OfferTriggerType["USER_DORMANT"] = "USER_DORMANT";
+    /** Стартовый баланс закончился в первый день: момент и письмо — у engagement. */
     OfferTriggerType["BALANCE_EXHAUSTED"] = "BALANCE_EXHAUSTED";
+    /**
+     * FRAUD-аккаунт привязал уже использованную соцсеть: реабилитировать его может только
+     * покупка, и бонус к ней — единственный бонус, который такому аккаунту положен.
+     */
     OfferTriggerType["FRAUD_REHABILITATION"] = "FRAUD_REHABILITATION";
     OfferTriggerType["MANUAL"] = "MANUAL";
 })(OfferTriggerType || (exports.OfferTriggerType = OfferTriggerType = {}));

package/build/v1/offers/schemas/offer-trigger-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"offer-trigger-type.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-trigger-type.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,gBAoBX;AApBD,WAAY,gBAAgB;IACxB,uDAAmC,CAAA;IAQnC,6DAAyC,CAAA;IAEzC,iDAA6B,CAAA;IAE7B,2DAAuC,CAAA;IAKvC,iEAA6C,CAAA;IAC7C,qCAAiB,CAAA;AACrB,CAAC,EApBW,gBAAgB,gCAAhB,gBAAgB,QAoB3B"}
+{"version":3,"file":"offer-trigger-type.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-trigger-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,gBAoBX;AApBD,WAAY,gBAAgB;IACxB,uDAAmC,CAAA;IACnC;;;;;;OAMG;IACH,6DAAyC,CAAA;IACzC,4FAA4F;IAC5F,iDAA6B,CAAA;IAC7B,iFAAiF;IACjF,2DAAuC,CAAA;IACvC;;;OAGG;IACH,iEAA6C,CAAA;IAC7C,qCAAiB,CAAA;AACrB,CAAC,EApBW,gBAAgB,gCAAhB,gBAAgB,QAoB3B"}

package/build/v1/offers/schemas/unreg-track-header-offer-request.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Показ или клик по гостевой полосе. Ключ кампании приходит от клиента — иначе счётчик нельзя
+ * приписать к конкретной полосе: строки на человека у гостя нет.
+ */
 export declare const UnregTrackHeaderOfferRequestSchema: z.ZodObject<{
     campaignKey: z.ZodString;
 }, z.core.$strip>;

package/build/v1/offers/schemas/unreg-track-header-offer-request.schema.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnregTrackHeaderOfferRequestSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * Показ или клик по гостевой полосе. Ключ кампании приходит от клиента — иначе счётчик нельзя
+ * приписать к конкретной полосе: строки на человека у гостя нет.
+ */
 exports.UnregTrackHeaderOfferRequestSchema = zod_1.z.object({
     campaignKey: zod_1.z
         .string({ error: 'UnregTrackHeaderOffer.campaignKey.required' })

package/build/v1/offers/schemas/unreg-track-header-offer-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"unreg-track-header-offer-request.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/unreg-track-header-offer-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAMX,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC5D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;CACtE,CAAC,CAAC"}
+{"version":3,"file":"unreg-track-header-offer-request.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/unreg-track-header-offer-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;GAGG;AACU,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC5D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;CACtE,CAAC,CAAC"}

package/build/v1/offers/schemas/user-offer-event-type.enum.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Type of tracked interaction event against a UserOffer.
+ * IMPRESSION does not change UserOffer.status — it only bumps impressionCount
+ * and stamps firstShownAt (once).
+ */
 export declare enum UserOfferEventType {
     IMPRESSION = "IMPRESSION",
     CLICK = "CLICK",

package/build/v1/offers/schemas/user-offer-event-type.enum.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserOfferEventType = void 0;
+/**
+ * Type of tracked interaction event against a UserOffer.
+ * IMPRESSION does not change UserOffer.status — it only bumps impressionCount
+ * and stamps firstShownAt (once).
+ */
 var UserOfferEventType;
 (function (UserOfferEventType) {
     UserOfferEventType["IMPRESSION"] = "IMPRESSION";

package/build/v1/offers/schemas/user-offer-event-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-offer-event-type.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/user-offer-event-type.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC1B,+CAAyB,CAAA;IACzB,qCAAe,CAAA;IACf,yCAAmB,CAAA;IACnB,+CAAyB,CAAA;IACzB,iEAA2C,CAAA;AAC/C,CAAC,EANW,kBAAkB,kCAAlB,kBAAkB,QAM7B"}
+{"version":3,"file":"user-offer-event-type.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/user-offer-event-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC1B,+CAAyB,CAAA;IACzB,qCAAe,CAAA;IACf,yCAAmB,CAAA;IACnB,+CAAyB,CAAA;IACzB,iEAA2C,CAAA;AAC/C,CAAC,EANW,kBAAkB,kCAAlB,kBAAkB,QAM7B"}

package/build/v1/offers/schemas/user-offer-status.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Lifecycle status of a single UserOffer instance.
+ * See `user-offer.transitions.ts` (domain layer) for the allowed transition matrix.
+ */
 export declare enum UserOfferStatus {
     PENDING = "PENDING",
     ACTIVE = "ACTIVE",
@@ -6,7 +10,10 @@ export declare enum UserOfferStatus {
     EXPIRED = "EXPIRED",
     DISMISSED = "DISMISSED",
     CANCELLED = "CANCELLED",
+    /** Закрыт, потому что другой оффер человека сконвертировался. Не конверсия. */
     SUPERSEDED = "SUPERSEDED",
+    /** Закрыт покупкой без кода этого оффера. Не конверсия. */
     CLOSED_BY_PURCHASE = "CLOSED_BY_PURCHASE",
+    /** Конверсия отменена полным возвратом заказа; оффер можно выдать снова. */
     CONVERSION_REVERSED = "CONVERSION_REVERSED"
 }

package/build/v1/offers/schemas/user-offer-status.enum.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserOfferStatus = void 0;
+/**
+ * Lifecycle status of a single UserOffer instance.
+ * See `user-offer.transitions.ts` (domain layer) for the allowed transition matrix.
+ */
 var UserOfferStatus;
 (function (UserOfferStatus) {
     UserOfferStatus["PENDING"] = "PENDING";
@@ -10,8 +14,11 @@ var UserOfferStatus;
     UserOfferStatus["EXPIRED"] = "EXPIRED";
     UserOfferStatus["DISMISSED"] = "DISMISSED";
     UserOfferStatus["CANCELLED"] = "CANCELLED";
+    /** Закрыт, потому что другой оффер человека сконвертировался. Не конверсия. */
     UserOfferStatus["SUPERSEDED"] = "SUPERSEDED";
+    /** Закрыт покупкой без кода этого оффера. Не конверсия. */
     UserOfferStatus["CLOSED_BY_PURCHASE"] = "CLOSED_BY_PURCHASE";
+    /** Конверсия отменена полным возвратом заказа; оффер можно выдать снова. */
     UserOfferStatus["CONVERSION_REVERSED"] = "CONVERSION_REVERSED";
 })(UserOfferStatus || (exports.UserOfferStatus = UserOfferStatus = {}));
 //# sourceMappingURL=user-offer-status.enum.js.map

package/build/v1/offers/schemas/user-offer-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-offer-status.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/user-offer-status.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,eAcX;AAdD,WAAY,eAAe;IACvB,sCAAmB,CAAA;IACnB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,0CAAuB,CAAA;IAEvB,4CAAyB,CAAA;IAEzB,4DAAyC,CAAA;IAEzC,8DAA2C,CAAA;AAC/C,CAAC,EAdW,eAAe,+BAAf,eAAe,QAc1B"}
+{"version":3,"file":"user-offer-status.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/user-offer-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,eAcX;AAdD,WAAY,eAAe;IACvB,sCAAmB,CAAA;IACnB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,0CAAuB,CAAA;IACvB,+EAA+E;IAC/E,4CAAyB,CAAA;IACzB,2DAA2D;IAC3D,4DAAyC,CAAA;IACzC,4EAA4E;IAC5E,8DAA2C,CAAA;AAC/C,CAAC,EAdW,eAAe,+BAAf,eAAe,QAc1B"}

package/build/v1/offers/schemas/user-offer.schema.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { UserOfferStatus } from './user-offer-status.enum';
+/** Admin view of a single UserOffer row (`admin/offers/:id/user-offers`). */
 export declare const UserOfferSchema: z.ZodObject<{
     id: z.ZodString;
     campaignId: z.ZodString;

package/build/v1/offers/schemas/user-offer.schema.js

@@ -4,6 +4,7 @@ exports.UserOfferListResponseSchema = exports.UserOfferSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const user_offer_status_enum_1 = require("./user-offer-status.enum");
+/** Admin view of a single UserOffer row (`admin/offers/:id/user-offers`). */
 exports.UserOfferSchema = zod_1.z.object({
     id: zod_1.z.string().regex(shared_1.UUID_REGEX),
     campaignId: zod_1.z.string().regex(shared_1.UUID_REGEX),

package/build/v1/offers/schemas/user-offer.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-offer.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/user-offer.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,qEAA2D;AAG9C,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAChC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IACpC,MAAM,EAAE,OAAC,CAAC,UAAU,CAAC,wCAAe,CAAC;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAIU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,uBAAe,CAAC;IAC/B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC,CAAC"}
+{"version":3,"file":"user-offer.schema.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/user-offer.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,qEAA2D;AAE3D,6EAA6E;AAChE,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAChC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IACpC,MAAM,EAAE,OAAC,CAAC,UAAU,CAAC,wCAAe,CAAC;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAIU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,uBAAe,CAAC;IAC/B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC,CAAC"}

package/build/v1/open-graph/schemas/open-graph-preview-request.schema.d.ts

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+/**
+ * OpenGraph preview query params
+ */
 export declare const OpenGraphPreviewRequestSchema: z.ZodObject<{
     url: z.ZodString;
 }, z.core.$strip>;

package/build/v1/open-graph/schemas/open-graph-preview-request.schema.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenGraphPreviewRequestSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * OpenGraph preview query params
+ */
 exports.OpenGraphPreviewRequestSchema = zod_1.z.object({
     url: zod_1.z.string().url({ message: 'OpenGraphPreviewRequest.url.invalid' }),
 });

package/build/v1/open-graph/schemas/open-graph-preview-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-graph-preview-request.schema.js","sourceRoot":"","sources":["../../../../v1/open-graph/schemas/open-graph-preview-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAKX,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAC1E,CAAC,CAAC"}
+{"version":3,"file":"open-graph-preview-request.schema.js","sourceRoot":"","sources":["../../../../v1/open-graph/schemas/open-graph-preview-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;GAEG;AACU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAC1E,CAAC,CAAC"}

package/build/v1/open-graph/schemas/open-graph-preview-response.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * OpenGraph preview response
+ * Text-only by design (no image URL at this stage).
+ */
 export declare const OpenGraphPreviewResponseSchema: z.ZodObject<{
     url: z.ZodString;
     title: z.ZodNullable<z.ZodString>;

package/build/v1/open-graph/schemas/open-graph-preview-response.schema.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenGraphPreviewResponseSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * OpenGraph preview response
+ * Text-only by design (no image URL at this stage).
+ */
 exports.OpenGraphPreviewResponseSchema = zod_1.z.object({
     url: zod_1.z.string().url(),
     title: zod_1.z.string().nullable(),

package/build/v1/open-graph/schemas/open-graph-preview-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-graph-preview-response.schema.js","sourceRoot":"","sources":["../../../../v1/open-graph/schemas/open-graph-preview-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAMX,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}
+{"version":3,"file":"open-graph-preview-response.schema.js","sourceRoot":"","sources":["../../../../v1/open-graph/schemas/open-graph-preview-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;GAGG;AACU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/build/v1/payment/admin/schemas/admin-order-sort.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Admin orders list sort fields and order.
+ * Values map to sortable Order columns.
+ */
 export declare enum AdminOrderSortField {
     CREATED_AT = "createdAt",
     AMOUNT = "amount",

package/build/v1/payment/admin/schemas/admin-order-sort.enum.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminOrderSortField = void 0;
+/**
+ * Admin orders list sort fields and order.
+ * Values map to sortable Order columns.
+ */
 var AdminOrderSortField;
 (function (AdminOrderSortField) {
     AdminOrderSortField["CREATED_AT"] = "createdAt";

package/build/v1/payment/admin/schemas/admin-order-sort.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-order-sort.enum.js","sourceRoot":"","sources":["../../../../../v1/payment/admin/schemas/admin-order-sort.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,+CAAwB,CAAA;IACxB,wCAAiB,CAAA;IACjB,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;AAChC,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B"}
+{"version":3,"file":"admin-order-sort.enum.js","sourceRoot":"","sources":["../../../../../v1/payment/admin/schemas/admin-order-sort.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,+CAAwB,CAAA;IACxB,wCAAiB,CAAA;IACjB,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;AAChC,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B"}

package/build/v1/payment/admin/schemas/admin-order.schema.d.ts

@@ -7,6 +7,10 @@ import { RefundStatus } from '../../schemas/refund-status.enum';
 import { RefundReason } from '../../schemas/refund-reason.enum';
 import { AdminOrderSortField } from './admin-order-sort.enum';
 import { SortOrder } from '../../../shared/sort-order.enum';
+/**
+ * Admin orders read model — order rows and their payment attempts for the
+ * billing/payments admin panel. Money amounts are integer strings (BigInt, ×100 of RUB).
+ */
 export declare const AdminOrderItemSchema: z.ZodObject<{
     orderId: z.ZodString;
     userId: z.ZodString;
@@ -35,6 +39,7 @@ export declare const AdminPaymentAttemptSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export type AdminPaymentAttempt = z.infer<typeof AdminPaymentAttemptSchema>;
+/** A return of one payment of the order: in flight (REQUESTED), done (SUCCEEDED) or refused (FAILED). */
 export declare const AdminRefundSchema: z.ZodObject<{
     id: z.ZodString;
     paymentId: z.ZodString;

package/build/v1/payment/admin/schemas/admin-order.schema.js

@@ -12,6 +12,10 @@ const refund_status_enum_1 = require("../../schemas/refund-status.enum");
 const refund_reason_enum_1 = require("../../schemas/refund-reason.enum");
 const admin_order_sort_enum_1 = require("./admin-order-sort.enum");
 const sort_order_enum_1 = require("../../../shared/sort-order.enum");
+/**
+ * Admin orders read model — order rows and their payment attempts for the
+ * billing/payments admin panel. Money amounts are integer strings (BigInt, ×100 of RUB).
+ */
 exports.AdminOrderItemSchema = zod_1.z.object({
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX),
     userId: zod_1.z.string().regex(shared_1.UUID_REGEX),
@@ -35,9 +39,11 @@ exports.AdminPaymentAttemptSchema = zod_1.z.object({
     providerTransactionId: zod_1.z.string().nullable(),
     status: zod_1.z.nativeEnum(payment_status_enum_1.PaymentStatus),
     amount: zod_1.z.string(),
+    /** Decline reason (failures) or refund reason (FULL/PARTIAL); null otherwise. */
     reason: zod_1.z.string().nullable(),
     createdAt: zod_1.z.string().datetime({ offset: true }),
 });
+/** A return of one payment of the order: in flight (REQUESTED), done (SUCCEEDED) or refused (FAILED). */
 exports.AdminRefundSchema = zod_1.z.object({
     id: zod_1.z.string().regex(shared_1.UUID_REGEX),
     paymentId: zod_1.z.string().regex(shared_1.UUID_REGEX),
@@ -47,24 +53,35 @@ exports.AdminRefundSchema = zod_1.z.object({
     providerTransactionId: zod_1.z.string().nullable(),
     createdAt: zod_1.z.string().datetime({ offset: true }),
 });
+// ── List (filters + pagination) ───────────────────────────────────────────────
 exports.AdminListOrdersRequestSchema = pagination_schema_1.PaginationQuerySchema.extend({
     userId: zod_1.z.string().regex(shared_1.UUID_REGEX, { message: 'AdminListOrdersRequest.userId.invalid' }).optional(),
     planId: zod_1.z.string().regex(shared_1.UUID_REGEX, { message: 'AdminListOrdersRequest.planId.invalid' }).optional(),
     status: zod_1.z.nativeEnum(order_status_enum_1.OrderStatus).optional(),
     kind: zod_1.z.nativeEnum(order_kind_enum_1.OrderKind).optional(),
+    /** Inclusive lower bound on createdAt (ISO datetime). */
     from: zod_1.z.string().datetime({ offset: true }).optional(),
+    /** Inclusive upper bound on createdAt (ISO datetime). */
     to: zod_1.z.string().datetime({ offset: true }).optional(),
     sortBy: zod_1.z.nativeEnum(admin_order_sort_enum_1.AdminOrderSortField).default(admin_order_sort_enum_1.AdminOrderSortField.CREATED_AT),
     sortOrder: zod_1.z.nativeEnum(sort_order_enum_1.SortOrder).default(sort_order_enum_1.SortOrder.DESC),
 });
 exports.AdminListOrdersResponseSchema = (0, pagination_schema_1.createPaginatedResponseSchema)(exports.AdminOrderItemSchema);
+// ── Detail (order + payment attempts) ─────────────────────────────────────────
 exports.AdminOrderDetailResponseSchema = zod_1.z.object({
     order: exports.AdminOrderItemSchema,
     payments: zod_1.z.array(exports.AdminPaymentAttemptSchema),
     refunds: zod_1.z.array(exports.AdminRefundSchema),
+    /**
+     * Money of the order that can be returned right now, integer string (×100 of RUB): per CONFIRMED payment its amount
+     * minus its non-FAILED refunds, never negative, summed — and a payment with a REQUESTED refund in flight counts as 0
+     * until that refund settles. «Refund» is offered for any order status when this is above 0.
+     */
     refundableAmount: zod_1.z.string(),
 });
+// ── Refund ────────────────────────────────────────────────────────────────────
 exports.AdminRefundOrderResponseSchema = zod_1.z.object({
+    /** true if the refund was accepted by the gateway; order flips to REFUNDED via webhook. */
     initiated: zod_1.z.boolean(),
 });
 //# sourceMappingURL=admin-order.schema.js.map