@veruna/api-contracts 19.1.0 → 20.1.0

package/build-esm/v1/offers/schemas/offer-countdown-mode.enum.js

@@ -1,8 +1,31 @@
+/**
+ * Как считать обратный отсчёт в баннере.
+ *
+ * Сервер по этому режиму отдаёт готовую метку времени, до которой тикать, — фронт только рисует
+ * цифры. Считать дедлайн на клиенте нельзя: часы у людей врут, а «осталось 3 минуты» на
+ * сгоревшем оффере хуже, чем отсутствие таймера.
+ */
 export var OfferCountdownMode;
 (function (OfferCountdownMode) {
+    /** Без таймера. */
     OfferCountdownMode["NONE"] = "NONE";
+    /** До конца самого оффера — его личного `expiresAt`. */
     OfferCountdownMode["OFFER_EXPIRES_AT"] = "OFFER_EXPIRES_AT";
+    /**
+     * До ближайшего воскресенья. Окно общее для всех и сбрасывается раз в неделю: так полоса
+     * держит срочность бесконечно, не выдавая каждому свой персональный дедлайн.
+     */
     OfferCountdownMode["WEEKLY_SUNDAY"] = "WEEKLY_SUNDAY";
+    /**
+     * Столько-то времени от ПЕРВОГО ПОКАЗА конкретному человеку; длительность лежит рядом, в
+     * `presentation.countdownMs`.
+     *
+     * Единственный режим, дедлайн которого сервер посчитать не может — и только для гостя.
+     * У гостя нет строки ни в `users`, ни в `web_notifications`, поэтому момент, когда он
+     * впервые увидел полосу, знает один его браузер: наружу уходит длительность, разворачивает
+     * её в метку клиент. У зарегистрированного этой проблемы нет — первый показ совпадает с
+     * выдачей, поэтому там режим отсчитывает до `UserOffer.expiresAt`, как `OFFER_EXPIRES_AT`.
+     */
     OfferCountdownMode["FIRST_VIEW"] = "FIRST_VIEW";
 })(OfferCountdownMode || (OfferCountdownMode = {}));
 //# sourceMappingURL=offer-countdown-mode.enum.js.map

package/build-esm/v1/offers/schemas/offer-countdown-mode.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"offer-countdown-mode.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-countdown-mode.enum.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,kBAqBX;AArBD,WAAY,kBAAkB;IAE1B,mCAAa,CAAA;IAEb,2DAAqC,CAAA;IAKrC,qDAA+B,CAAA;IAW/B,+CAAyB,CAAA;AAC7B,CAAC,EArBW,kBAAkB,KAAlB,kBAAkB,QAqB7B"}
+{"version":3,"file":"offer-countdown-mode.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-countdown-mode.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,kBAqBX;AArBD,WAAY,kBAAkB;IAC1B,mBAAmB;IACnB,mCAAa,CAAA;IACb,wDAAwD;IACxD,2DAAqC,CAAA;IACrC;;;OAGG;IACH,qDAA+B,CAAA;IAC/B;;;;;;;;;OASG;IACH,+CAAyB,CAAA;AAC7B,CAAC,EArBW,kBAAkB,KAAlB,kBAAkB,QAqB7B"}

package/build-esm/v1/offers/schemas/offer-cta-action.enum.js

@@ -1,3 +1,8 @@
+/**
+ * Action triggered by the offer's call-to-action button.
+ * OPEN_PLANS — navigates to the plans/pricing catalog.
+ * OPEN_URL   — navigates to `presentation.cta.url` (required when this action is used).
+ */
 export var OfferCtaAction;
 (function (OfferCtaAction) {
     OfferCtaAction["OPEN_PLANS"] = "OPEN_PLANS";

package/build-esm/v1/offers/schemas/offer-cta-action.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"offer-cta-action.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-cta-action.enum.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,2CAAyB,CAAA;IACzB,uCAAqB,CAAA;AACzB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}
+{"version":3,"file":"offer-cta-action.enum.js","sourceRoot":"","sources":["../../../../v1/offers/schemas/offer-cta-action.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,2CAAyB,CAAA;IACzB,uCAAqB,CAAA;AACzB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

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

@@ -2,7 +2,13 @@ import { z } from 'zod';
 import { OfferCtaAction } from './offer-cta-action.enum';
 import { OfferCountdownMode } from './offer-countdown-mode.enum';
 import { POSITIVE_BIGINT_STRING_REGEX } from '../../../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);
@@ -33,7 +39,25 @@ export const OfferPresentationCtaSchema = z
         });
     }
 });
+/**
+ * Максимум догоняющих касаний по одному офферу.
+ *
+ * Четыре плюс само уведомление о выдаче — это пять. Дальше начинается участок, где отклики
+ * падают примерно вдвое, а жалобы на спам растут кратно: платит за это доставляемость всего
+ * домена, а не одна кампания.
+ */
 export const OFFER_MAX_FOLLOW_UPS = 4;
+/**
+ * Догоняющее касание по невзятому офферу.
+ *
+ * У каждого своя копия, и это не украшение. Человек, не купивший по офферу, чаще всего не
+ * «не заметил», а не совпал с предложением: повтор того же текста громче просто расходует
+ * доверие. Поэтому касание обязано менять угол — другую выгоду, другой сценарий, другой повод, —
+ * а не пересылать первое письмо ещё раз.
+ *
+ * `delayMs` считается от МОМЕНТА АКТИВАЦИИ оффера, а не от выдачи: у кампании с задержкой это
+ * разные даты, и отсчитывать дожим от несуществующего для человека события бессмысленно.
+ */
 export const OfferFollowUpSchema = z.object({
     delayMs: z
         .number({ error: 'OfferFollowUp.delayMs.required' })
@@ -50,7 +74,12 @@ export const OfferFollowUpSchema = z.object({
         .optional(),
     cta: OfferPresentationCtaSchema,
 });
+/**
+ * `offer_campaigns.presentation` JSON payload — only Russian text (P0 decision),
+ * flat structure without language keys.
+ */
 export const OfferPresentationSchema = z.object({
+    /** Frontend-known skin identifier; not an enum on purpose (frontend owns the set). */
     variant: z
         .string({ error: 'OfferPresentation.variant.required' })
         .min(1, { message: 'OfferPresentation.variant.min' })
@@ -71,6 +100,10 @@ export const OfferPresentationSchema = z.object({
         .optional(),
     cta: OfferPresentationCtaSchema,
     dismissible: z.boolean({ error: 'OfferPresentation.dismissible.invalid' }),
+    /**
+     * Картинка баннера. Произвольная http(s)-ссылка — в отличие от письма, где иллюстрации
+     * берутся из каталога.
+     */
     imageUrl: z
         .string({ error: 'OfferPresentation.imageUrl.invalid' })
         .url({ message: 'OfferPresentation.imageUrl.invalid' })
@@ -79,26 +112,46 @@ export const OfferPresentationSchema = z.object({
         message: 'OfferPresentation.imageUrl.protocolNotAllowed',
     })
         .optional(),
+    /**
+     * Какую иллюстрацию поставить в письмо догона. Ключ из каталога писем; набор принадлежит
+     * рендереру, не контракту — та же логика, что у `variant`. Неизвестный ключ рендерер
+     * заменит на свой дефолт, а не уронит письмо.
+     */
     emailAsset: z
         .string({ error: 'OfferPresentation.emailAsset.invalid' })
         .min(1, { message: 'OfferPresentation.emailAsset.min' })
         .max(64, { message: 'OfferPresentation.emailAsset.max' })
         .optional(),
+    /** Обратный отсчёт в баннере. По умолчанию таймера нет. */
     countdown: z
         .enum(OfferCountdownMode, { error: 'OfferPresentation.countdown.invalid' })
         .default(OfferCountdownMode.NONE),
+    /**
+     * Длительность отсчёта для режима `FIRST_VIEW`, мс строкой. У остальных режимов дедлайн
+     * берётся из даты, а не из длительности, поэтому поле обязано быть пустым — иначе в
+     * конфиге осталось бы значение, на которое никто не смотрит.
+     */
     countdownMs: z
         .string({ error: 'OfferPresentation.countdownMs.invalid' })
         .regex(POSITIVE_BIGINT_STRING_REGEX, { message: 'OfferPresentation.countdownMs.invalid' })
         .nullable()
         .optional()
         .default(null),
+    /**
+     * Догоны по невзятому офферу, строго по возрастанию задержки и без повторов — это
+     * проверяет агрегат кампании, потому что нарушение не падает, а молча не отправляется.
+     * Пустой список — кампания без дожима: выдали и молчим.
+     */
     followUps: z
         .array(OfferFollowUpSchema)
         .max(OFFER_MAX_FOLLOW_UPS, { message: 'OfferPresentation.followUps.max' })
         .default([]),
 })
     .superRefine((v, ctx) => {
+    // Пара «режим ↔ длительность» всё-или-ничего, как `promoTemplate`/`promoTtlMs` уровнем
+    // выше. Режим без длительности — полоса, которая обещает отсчёт и не может его
+    // показать; длительность без режима — мёртвое поле, которое следующий человек примет
+    // за настройку.
     if (v.countdown === OfferCountdownMode.FIRST_VIEW && v.countdownMs === null) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,

package/build-esm/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-esm/v1/offers/schemas/offer-promo-template.schema.js

@@ -2,11 +2,20 @@ import { z } from 'zod';
 import { UUID_REGEX, BIGINT_STRING_REGEX } from '../../../shared';
 import { PlanType } from '../../plans/schemas/plan-type.enum';
 export const 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.
+ */
 export var OfferPromoTemplateKind;
 (function (OfferPromoTemplateKind) {
     OfferPromoTemplateKind["PURCHASE_MULTIPLIER"] = "PURCHASE_MULTIPLIER";
+    /**
+     * Фиксированное начисление бонусных токенов на баланс в момент выдачи — без промокода.
+     * Так офферы выдают и учитывают бонусы, которые раньше начислялись в обход платформы.
+     */
     OfferPromoTemplateKind["BALANCE_GRANT"] = "BALANCE_GRANT";
 })(OfferPromoTemplateKind || (OfferPromoTemplateKind = {}));
+/** Срок жизни начисленного бонусного баланса, дни. */
 export const OFFER_BALANCE_GRANT_TTL_DAYS_MAX = 365;
 export const PurchaseMultiplierTemplateSchema = z.object({
     kind: z.literal(OfferPromoTemplateKind.PURCHASE_MULTIPLIER),
@@ -15,6 +24,7 @@ export const PurchaseMultiplierTemplateSchema = 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: z
         .string({ error: 'OfferPromoTemplate.maxBonusAmount.invalid' })
         .regex(BIGINT_STRING_REGEX, { message: 'OfferPromoTemplate.maxBonusAmount.invalid' }),
@@ -32,6 +42,7 @@ export const PurchaseMultiplierTemplateSchema = z.object({
     firstPurchaseOnly: z
         .boolean({ error: 'OfferPromoTemplate.firstPurchaseOnly.invalid' })
         .optional(),
+    /** BigInt (tokens) serialized as digit-only string. */
     minPurchaseAmount: z
         .string({ error: 'OfferPromoTemplate.minPurchaseAmount.invalid' })
         .regex(BIGINT_STRING_REGEX, { message: 'OfferPromoTemplate.minPurchaseAmount.invalid' })
@@ -39,6 +50,7 @@ export const PurchaseMultiplierTemplateSchema = z.object({
 });
 export const BalanceGrantTemplateSchema = z.object({
     kind: z.literal(OfferPromoTemplateKind.BALANCE_GRANT),
+    /** BigInt (tokens) serialized as digit-only string. */
     amount: z
         .string({ error: 'OfferPromoTemplate.amount.required' })
         .regex(BIGINT_STRING_REGEX, { message: 'OfferPromoTemplate.amount.invalid' }),
@@ -48,10 +60,16 @@ export const BalanceGrantTemplateSchema = z.object({
         .min(1, { message: 'OfferPromoTemplate.grantTtlDays.min' })
         .max(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).
+ */
 export const OfferPromoTemplateSchema = z.discriminatedUnion('kind', [
     PurchaseMultiplierTemplateSchema,
     BalanceGrantTemplateSchema,
 ]);
+/** Промокод (и его TTL) выпускает только шаблон покупочного множителя; начисление обходится без кода. */
 export function offerTemplateMintsPromoCode(template) {
     return template !== null && template.kind === OfferPromoTemplateKind.PURCHASE_MULTIPLIER;
 }

package/build-esm/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-esm/v1/offers/schemas/offer-trigger-type.enum.js

@@ -1,9 +1,27 @@
+/**
+ * Event that causes an OfferCampaign to issue a UserOffer.
+ * USER_REGISTERED срабатывает синхронно на регистрации, CHECKOUT_ABANDONED — свипом по
+ * брошенным заказам, MANUAL выдаётся только руками из админки.
+ */
 export 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 || (OfferTriggerType = {}));

package/build-esm/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,MAAM,CAAN,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,KAAhB,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,MAAM,CAAN,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,KAAhB,gBAAgB,QAoB3B"}

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

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Показ или клик по гостевой полосе. Ключ кампании приходит от клиента — иначе счётчик нельзя
+ * приписать к конкретной полосе: строки на человека у гостя нет.
+ */
 export const UnregTrackHeaderOfferRequestSchema = z.object({
     campaignKey: z
         .string({ error: 'UnregTrackHeaderOffer.campaignKey.required' })

package/build-esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,CAAC;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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,CAAC;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-esm/v1/offers/schemas/user-offer-event-type.enum.js

@@ -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 var UserOfferEventType;
 (function (UserOfferEventType) {
     UserOfferEventType["IMPRESSION"] = "IMPRESSION";

package/build-esm/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,MAAM,CAAN,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,KAAlB,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,MAAM,CAAN,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,KAAlB,kBAAkB,QAM7B"}

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

@@ -1,3 +1,7 @@
+/**
+ * Lifecycle status of a single UserOffer instance.
+ * See `user-offer.transitions.ts` (domain layer) for the allowed transition matrix.
+ */
 export var UserOfferStatus;
 (function (UserOfferStatus) {
     UserOfferStatus["PENDING"] = "PENDING";
@@ -7,8 +11,11 @@ export 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 || (UserOfferStatus = {}));
 //# sourceMappingURL=user-offer-status.enum.js.map

package/build-esm/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,MAAM,CAAN,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,KAAf,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,MAAM,CAAN,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,KAAf,eAAe,QAc1B"}

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { UUID_REGEX } from '../../../shared';
 import { UserOfferStatus } from './user-offer-status.enum';
+/** Admin view of a single UserOffer row (`admin/offers/:id/user-offers`). */
 export const UserOfferSchema = z.object({
     id: z.string().regex(UUID_REGEX),
     campaignId: z.string().regex(UUID_REGEX),

package/build-esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,KAAK,EAAE,CAAC,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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC,CAAC"}

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

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+/**
+ * OpenGraph preview query params
+ */
 export const OpenGraphPreviewRequestSchema = z.object({
     url: z.string().url({ message: 'OpenGraphPreviewRequest.url.invalid' }),
 });

package/build-esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,CAAC,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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAC1E,CAAC,CAAC"}

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

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * OpenGraph preview response
+ * Text-only by design (no image URL at this stage).
+ */
 export const OpenGraphPreviewResponseSchema = z.object({
     url: z.string().url(),
     title: z.string().nullable(),

package/build-esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

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

@@ -1,3 +1,7 @@
+/**
+ * Admin orders list sort fields and order.
+ * Values map to sortable Order columns.
+ */
 export var AdminOrderSortField;
 (function (AdminOrderSortField) {
     AdminOrderSortField["CREATED_AT"] = "createdAt";

package/build-esm/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,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,+CAAwB,CAAA;IACxB,wCAAiB,CAAA;IACjB,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;AAChC,CAAC,EALW,mBAAmB,KAAnB,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,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,+CAAwB,CAAA;IACxB,wCAAiB,CAAA;IACjB,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;AAChC,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B"}

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

@@ -9,6 +9,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 const AdminOrderItemSchema = z.object({
     orderId: z.string().regex(UUID_REGEX),
     userId: z.string().regex(UUID_REGEX),
@@ -32,9 +36,11 @@ export const AdminPaymentAttemptSchema = z.object({
     providerTransactionId: z.string().nullable(),
     status: z.nativeEnum(PaymentStatus),
     amount: z.string(),
+    /** Decline reason (failures) or refund reason (FULL/PARTIAL); null otherwise. */
     reason: z.string().nullable(),
     createdAt: z.string().datetime({ offset: true }),
 });
+/** A return of one payment of the order: in flight (REQUESTED), done (SUCCEEDED) or refused (FAILED). */
 export const AdminRefundSchema = z.object({
     id: z.string().regex(UUID_REGEX),
     paymentId: z.string().regex(UUID_REGEX),
@@ -44,24 +50,35 @@ export const AdminRefundSchema = z.object({
     providerTransactionId: z.string().nullable(),
     createdAt: z.string().datetime({ offset: true }),
 });
+// ── List (filters + pagination) ───────────────────────────────────────────────
 export const AdminListOrdersRequestSchema = PaginationQuerySchema.extend({
     userId: z.string().regex(UUID_REGEX, { message: 'AdminListOrdersRequest.userId.invalid' }).optional(),
     planId: z.string().regex(UUID_REGEX, { message: 'AdminListOrdersRequest.planId.invalid' }).optional(),
     status: z.nativeEnum(OrderStatus).optional(),
     kind: z.nativeEnum(OrderKind).optional(),
+    /** Inclusive lower bound on createdAt (ISO datetime). */
     from: z.string().datetime({ offset: true }).optional(),
+    /** Inclusive upper bound on createdAt (ISO datetime). */
     to: z.string().datetime({ offset: true }).optional(),
     sortBy: z.nativeEnum(AdminOrderSortField).default(AdminOrderSortField.CREATED_AT),
     sortOrder: z.nativeEnum(SortOrder).default(SortOrder.DESC),
 });
 export const AdminListOrdersResponseSchema = createPaginatedResponseSchema(AdminOrderItemSchema);
+// ── Detail (order + payment attempts) ─────────────────────────────────────────
 export const AdminOrderDetailResponseSchema = z.object({
     order: AdminOrderItemSchema,
     payments: z.array(AdminPaymentAttemptSchema),
     refunds: z.array(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: z.string(),
 });
+// ── Refund ────────────────────────────────────────────────────────────────────
 export const AdminRefundOrderResponseSchema = z.object({
+    /** true if the refund was accepted by the gateway; order flips to REFUNDED via webhook. */
     initiated: z.boolean(),
 });
 //# sourceMappingURL=admin-order.schema.js.map

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

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

package/build-esm/v1/payment/admin/schemas/admin-saved-method.schema.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { SavedPaymentMethodViewSchema } from '../../queries/get-saved-methods.query';
+/** Admin view of a user's saved cards — reuses the user-facing SavedPaymentMethodView. */
 export const AdminListSavedMethodsResponseSchema = z.object({
     methods: z.array(SavedPaymentMethodViewSchema),
 });

package/build-esm/v1/payment/admin/schemas/admin-saved-method.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-saved-method.schema.js","sourceRoot":"","sources":["../../../../../v1/payment/admin/schemas/admin-saved-method.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAGrF,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC;CACjD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}
+{"version":3,"file":"admin-saved-method.schema.js","sourceRoot":"","sources":["../../../../../v1/payment/admin/schemas/admin-saved-method.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAErF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC;CACjD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}

package/build-esm/v1/payment/commands/charge-saved-method.command.js

@@ -1,6 +1,14 @@
 import { z } from 'zod';
 import { UUID_REGEX, BIGINT_STRING_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Initiate a server-to-server recurrent charge via CloudPayments.
+ * Uses the user's active default SavedPaymentMethod.
+ * The actual credit arrives via the pay-webhook (async).
+ *
+ * Cross-module command: subscription cycle service → payment.
+ * Handler owns: SavedPaymentMethodRepository (reads token) + CloudPaymentsClient (S2S HTTP).
+ */
 export var ChargeSavedMethodCommand;
 (function (ChargeSavedMethodCommand) {
     ChargeSavedMethodCommand.Request = z.object({
@@ -10,11 +18,16 @@ export var ChargeSavedMethodCommand;
         orderId: z
             .string({ error: 'ChargeSavedMethodCommand.orderId.required' })
             .regex(UUID_REGEX, { message: 'ChargeSavedMethodCommand.orderId.invalid' }),
+        /** Amount as integer string (BigInt, ×100 of RUB). */
         amount: z
             .string({ error: 'ChargeSavedMethodCommand.amount.required' })
             .regex(BIGINT_STRING_REGEX, { message: 'ChargeSavedMethodCommand.amount.invalid' }),
     });
     ChargeSavedMethodCommand.Response = z.object({
+        /**
+         * true  — CP accepted the charge request (payment result comes via webhook).
+         * false — CP synchronously declined (no saved method or immediate rejection).
+         */
         accepted: z.boolean(),
     });
     ChargeSavedMethodCommand.METHOD = HttpMethod.POST;

package/build-esm/v1/payment/commands/charge-saved-method.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"charge-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/charge-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAU9D,MAAM,KAAW,wBAAwB,CA0BxC;AA1BD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;aAC9D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAE/E,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;KAC1F,CAAC,CAAC;IAEU,iCAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAK7B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;KACxB,CAAC,CAAC;IAEU,+BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA1BgB,wBAAwB,KAAxB,wBAAwB,QA0BxC"}
+{"version":3,"file":"charge-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/charge-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,KAAW,wBAAwB,CA0BxC;AA1BD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;aAC9D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAC/E,sDAAsD;QACtD,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;KAC1F,CAAC,CAAC;IAEU,iCAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B;;;WAGG;QACH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;KACxB,CAAC,CAAC;IAEU,+BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA1BgB,wBAAwB,KAAxB,wBAAwB,QA0BxC"}

package/build-esm/v1/payment/commands/check-webhook.command.js

@@ -1,6 +1,14 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsCheckRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `check` webhook command.
+ * Provider sends this before charging to validate the order.
+ * Controller derives DTOs from this namespace via createZodDto(CheckWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleCheck().
+ */
 export var CheckWebhookCommand;
 (function (CheckWebhookCommand) {
     CheckWebhookCommand.Request = CloudPaymentsCheckRequestSchema;

package/build-esm/v1/payment/commands/check-webhook.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/check-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,+BAA+B,EAC/B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAUlD,MAAM,KAAW,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,+BAA+B,CAAC;IAC1C,4BAAQ,GAAG,2BAA2B,CAAC;IAEvC,uBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACzC,0BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,mBAAmB,KAAnB,mBAAmB,QASnC"}
+{"version":3,"file":"check-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/check-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,+BAA+B,EAC/B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,KAAW,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,+BAA+B,CAAC;IAC1C,4BAAQ,GAAG,2BAA2B,CAAC;IAEvC,uBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACzC,0BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,mBAAmB,KAAnB,mBAAmB,QASnC"}