@veruna/api-contracts 20.0.0 → 20.2.0

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAC5G,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAO5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC;IACvC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC;IAClC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrG,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IAExC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEtD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC;IACjF,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;CAC7D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,6BAA6B,GAAG,6BAA6B,CAAC,oBAAoB,CAAC,CAAC;AAMjG,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,oBAAoB;IAC3B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAMnC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC/B,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAEnD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC"}
+{"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"}

package/build-esm/v1/payment/commands/create-order.command.js

@@ -1,6 +1,15 @@
 import { z } from 'zod';
 import { UUID_REGEX, BIGINT_STRING_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Create a new Order (server-side anti-tamper purchase record).
+ * Called by subscription services before redirecting user to CloudPayments widget.
+ * Amount, grantedBalance, entitlements are server-computed and snapshotted here.
+ *
+ * Internal cross-module command: subscription → payment.
+ * Handler owns 1 repository: OrderRepository.
+ * No HTTP endpoint — invoked only via TypedCommandBus.
+ */
 export var CreateOrderCommand;
 (function (CreateOrderCommand) {
     CreateOrderCommand.Request = z.object({
@@ -8,24 +17,31 @@ export var CreateOrderCommand;
             .string({ error: 'CreateOrderCommand.userId.required' })
             .regex(UUID_REGEX, { message: 'CreateOrderCommand.userId.invalid' }),
         kind: z.string({ error: 'CreateOrderCommand.kind.required' }),
+        /** Order amount as integer string (BigInt, ×100 of RUB). */
         amount: z
             .string({ error: 'CreateOrderCommand.amount.required' })
             .regex(BIGINT_STRING_REGEX, { message: 'CreateOrderCommand.amount.invalid' }),
         currency: z
             .string({ error: 'CreateOrderCommand.currency.required' })
             .length(3, { message: 'CreateOrderCommand.currency.length' }),
+        /** Human-readable description shown to user in payment widget. */
         description: z.string({ error: 'CreateOrderCommand.description.required' }).min(1),
+        /** Granted balance as integer string (BigInt, ×100 of RUB; server-computed). */
         grantedBalance: z
             .string({ error: 'CreateOrderCommand.grantedBalance.required' })
             .regex(BIGINT_STRING_REGEX, { message: 'CreateOrderCommand.grantedBalance.invalid' }),
+        /** Entitlements snapshot (JSON — server-computed from plan at time of order). */
         entitlements: z.record(z.string(), z.unknown()),
+        /** UUIDv5 idempotency key — deterministic from order parameters. */
         idempotencyKey: z
             .string({ error: 'CreateOrderCommand.idempotencyKey.required' })
             .regex(UUID_REGEX, { message: 'CreateOrderCommand.idempotencyKey.invalid' }),
+        /** Order TTL in milliseconds from now. */
         ttlMs: z.number({ error: 'CreateOrderCommand.ttlMs.required' }).int().positive(),
         subscriptionId: z.string().regex(UUID_REGEX).nullable().optional(),
         planId: z.string().regex(UUID_REGEX).nullable().optional(),
         periodMonths: z.number().int().positive().nullable().optional(),
+        /** Custom price as BigInt string (internal units). */
         customPrice: z
             .string()
             .regex(BIGINT_STRING_REGEX)

package/build-esm/v1/payment/commands/create-order.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-order.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/create-order.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;AAW9D,MAAM,KAAW,kBAAkB,CA8ClC;AA9CD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAE7D,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACjF,QAAQ,EAAE,CAAC;aACN,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QAEjE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAElF,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAEzF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAE/C,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAEhF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAE/D,WAAW,EAAE,CAAC;aACT,MAAM,EAAE;aACR,KAAK,CAAC,mBAAmB,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,EAAE;KAClB,CAAC,CAAC;IAEU,2BAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IAEU,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA9CgB,kBAAkB,KAAlB,kBAAkB,QA8ClC"}
+{"version":3,"file":"create-order.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/create-order.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;;;;;;;;GAQG;AACH,MAAM,KAAW,kBAAkB,CA8ClC;AA9CD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAC7D,4DAA4D;QAC5D,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACjF,QAAQ,EAAE,CAAC;aACN,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QACjE,kEAAkE;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClF,gFAAgF;QAChF,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QACzF,iFAAiF;QACjF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/C,oEAAoE;QACpE,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAChF,0CAA0C;QAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC/D,sDAAsD;QACtD,WAAW,EAAE,CAAC;aACT,MAAM,EAAE;aACR,KAAK,CAAC,mBAAmB,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,EAAE;KAClB,CAAC,CAAC;IAEU,2BAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IAEU,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA9CgB,kBAAkB,KAAlB,kBAAkB,QA8ClC"}

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

@@ -1,6 +1,14 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsFailRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `fail` webhook command.
+ * Sent when a payment attempt is declined. Payment→DECLINED; Order stays PENDING for retry.
+ * Controller derives DTOs from this namespace via createZodDto(FailWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleFail().
+ */
 export var FailWebhookCommand;
 (function (FailWebhookCommand) {
     FailWebhookCommand.Request = CloudPaymentsFailRequestSchema;

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

@@ -1 +1 @@
-{"version":3,"file":"fail-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/fail-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,8BAA8B,EAC9B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAUlD,MAAM,KAAW,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,8BAA8B,CAAC;IACzC,2BAAQ,GAAG,2BAA2B,CAAC;IAEvC,sBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,kBAAkB,KAAlB,kBAAkB,QASlC"}
+{"version":3,"file":"fail-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/fail-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,8BAA8B,EAC9B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,KAAW,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,8BAA8B,CAAC;IACzC,2BAAQ,GAAG,2BAA2B,CAAC;IAEvC,sBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,kBAAkB,KAAlB,kBAAkB,QASlC"}

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

@@ -1,6 +1,15 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsPayRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `pay` webhook command.
+ * Sent when payment is confirmed. Server marks Order→PAID, Payment→CONFIRMED,
+ * and if Token is present — upserts SavedPaymentMethod.
+ * Controller derives DTOs from this namespace via createZodDto(PayWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handlePay().
+ */
 export var PayWebhookCommand;
 (function (PayWebhookCommand) {
     PayWebhookCommand.Request = CloudPaymentsPayRequestSchema;

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

@@ -1 +1 @@
-{"version":3,"file":"pay-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/pay-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,6BAA6B,EAC7B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAWlD,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,6BAA6B,CAAC;IACxC,0BAAQ,GAAG,2BAA2B,CAAC;IAEvC,qBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,wBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC"}
+{"version":3,"file":"pay-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/pay-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,6BAA6B,EAC7B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,6BAA6B,CAAC;IACxC,0BAAQ,GAAG,2BAA2B,CAAC;IAEvC,qBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,wBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC"}

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

@@ -1,6 +1,16 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsRefundRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `refund` webhook command.
+ * Sent when a confirmed payment is refunded. Writes a Refund row (matches our REQUESTED one, otherwise SUCCEEDED/PROVIDER).
+ * A full refund of the payment that paid the order → Order→REFUNDED; a partial one leaves the order PAID.
+ * A refund of a payment we do not know yet is answered with code 13: CloudPayments repeats it after Pay.
+ * Controller derives DTOs from this namespace via createZodDto(RefundWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleRefund().
+ */
 export var RefundWebhookCommand;
 (function (RefundWebhookCommand) {
     RefundWebhookCommand.Request = CloudPaymentsRefundRequestSchema;

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

@@ -1 +1 @@
-{"version":3,"file":"refund-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/refund-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,gCAAgC,EAChC,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAYlD,MAAM,KAAW,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,gCAAgC,CAAC;IAC3C,6BAAQ,GAAG,2BAA2B,CAAC;IAEvC,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1C,2BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,oBAAoB,KAApB,oBAAoB,QASpC"}
+{"version":3,"file":"refund-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/refund-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,gCAAgC,EAChC,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,KAAW,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,gCAAgC,CAAC;IAC3C,6BAAQ,GAAG,2BAA2B,CAAC;IAEvC,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1C,2BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,oBAAoB,KAApB,oBAAoB,QASpC"}

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

@@ -2,6 +2,13 @@ import { z } from 'zod';
 import { UUID_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
+/**
+ * Revoke (delete) a saved payment method.
+ * Owner derived from JWT; 404 instead of 403 if not found or not owned.
+ *
+ * User-facing command: DELETE /v1/payment/saved-methods/:id
+ * Handler owns 1 repository: SavedPaymentMethodRepository.
+ */
 export var RevokeSavedMethodCommand;
 (function (RevokeSavedMethodCommand) {
     RevokeSavedMethodCommand.Request = z.object({
@@ -15,6 +22,7 @@ export var RevokeSavedMethodCommand;
     RevokeSavedMethodCommand.Response = z.object({
         revoked: z.boolean(),
     });
+    /** URL factory — call with savedMethodId to get the full URL. */
     RevokeSavedMethodCommand.URL = (id) => REST_API.V1.PAYMENT.REG.REVOKE_SAVED_METHOD(id);
     RevokeSavedMethodCommand.METHOD = HttpMethod.DELETE;
 })(RevokeSavedMethodCommand || (RevokeSavedMethodCommand = {}));

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

@@ -1 +1 @@
-{"version":3,"file":"revoke-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/revoke-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAS7C,MAAM,KAAW,wBAAwB,CAoBxC;AApBD,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,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;aACpE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;KACxF,CAAC,CAAC;IAEU,iCAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,CAAC,CAAC;IAGU,4BAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtE,+BAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EApBgB,wBAAwB,KAAxB,wBAAwB,QAoBxC"}
+{"version":3,"file":"revoke-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/revoke-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,KAAW,wBAAwB,CAoBxC;AApBD,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,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;aACpE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;KACxF,CAAC,CAAC;IAEU,iCAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,CAAC,CAAC;IAEH,iEAAiE;IACpD,4BAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtE,+BAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EApBgB,wBAAwB,KAAxB,wBAAwB,QAoBxC"}

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

@@ -3,6 +3,17 @@ import { UUID_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { SavedPaymentMethodViewSchema } from '../queries/get-saved-methods.query';
+/**
+ * Set a saved payment method as the user's default.
+ * Owner derived from JWT; 404 instead of 403 if not found or not owned.
+ * 409 (SAVED_METHOD_NOT_ACTIVE) if the method is revoked/expired.
+ *
+ * Responds with the now-default method view. By the one-active-default
+ * invariant, every other method of the user is non-default afterwards.
+ *
+ * User-facing command: PATCH /v1/payment/saved-methods/:id/default
+ * Handler owns 1 repository: SavedPaymentMethodRepository.
+ */
 export var SetDefaultSavedMethodCommand;
 (function (SetDefaultSavedMethodCommand) {
     SetDefaultSavedMethodCommand.Request = z.object({
@@ -14,6 +25,7 @@ export var SetDefaultSavedMethodCommand;
             .regex(UUID_REGEX, { message: 'SetDefaultSavedMethodCommand.savedMethodId.invalid' }),
     });
     SetDefaultSavedMethodCommand.Response = SavedPaymentMethodViewSchema;
+    /** URL factory — call with savedMethodId to get the full URL. */
     SetDefaultSavedMethodCommand.URL = (id) => REST_API.V1.PAYMENT.REG.SET_DEFAULT_SAVED_METHOD(id);
     SetDefaultSavedMethodCommand.METHOD = HttpMethod.PATCH;
 })(SetDefaultSavedMethodCommand || (SetDefaultSavedMethodCommand = {}));

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

@@ -1 +1 @@
-{"version":3,"file":"set-default-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/set-default-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAalF,MAAM,KAAW,4BAA4B,CAkB5C;AAlBD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;aACjE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAClF,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;aACxE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEU,qCAAQ,GAAG,4BAA4B,CAAC;IAGxC,gCAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC3E,mCAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAlBgB,4BAA4B,KAA5B,4BAA4B,QAkB5C"}
+{"version":3,"file":"set-default-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/set-default-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF;;;;;;;;;;GAUG;AACH,MAAM,KAAW,4BAA4B,CAkB5C;AAlBD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;aACjE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAClF,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;aACxE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEU,qCAAQ,GAAG,4BAA4B,CAAC;IAErD,iEAAiE;IACpD,gCAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC3E,mCAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAlBgB,4BAA4B,KAA5B,4BAA4B,QAkB5C"}