@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/subscription/schemas/subscription.schema.js

@@ -12,19 +12,47 @@ const payment_issue_state_enum_1 = require("./payment-issue-state.enum");
 const payment_issue_reason_enum_1 = require("./payment-issue-reason.enum");
 const payment_recovery_schema_1 = require("./payment-recovery.schema");
 const payment_decline_class_enum_1 = require("../../payment/schemas/payment-decline-class.enum");
+/**
+ * Promo outcome surfaced on checkout responses. A promo never blocks payment: when it doesn't
+ * apply (invalid/expired/ineligible/cap), `promoApplied=false` + `promoReason`, order still created.
+ */
 const PromoCheckoutResultSchema = {
     promoApplied: zod_1.z.boolean(),
+    /** Boost added to the grant (decimal string of internal units); null when not applied. */
     promoBoost: zod_1.z.string().nullable(),
+    /** Business reason the promo did not apply, or null. */
     promoReason: zod_1.z.nativeEnum(promo_errors_1.PromoErrorCode).nullable(),
 };
+// ─────────────────────────────────────────────────────────────────────────────
+// Effective entitlements resolved from active subscription + packages
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * The resolved entitlement set for the current user.
+ * Consumed by hot-path (model validation, tool gating, char-limit checks).
+ * Derived from snapshot stored on UserSubscription/UserPackage, NOT live Plan.
+ *
+ * allModels=true means the user's subscription/package unlocks every active AI model.
+ * allModels=false means access is restricted to an explicit set; allowedModelCount
+ * gives the size of that set (the full ID list is not exposed in the user-facing
+ * response to keep payload small; enforcement is server-side).
+ */
 exports.EffectiveEntitlementsSchema = zod_1.z.object({
     maxCharsPerRequest: zod_1.z.number().int().positive(),
+    /** Maximum file size in MB, matching the plan setting. */
     maxFileSizeMb: zod_1.z.number().int().positive(),
+    /** true = user can use all active AI models; false = restricted to explicit set. */
     allModels: zod_1.z.boolean(),
+    /**
+     * Number of models in the user's allowed set.
+     * Meaningful only when allModels=false; when allModels=true this equals totalActiveModels.
+     */
     allowedModelCount: zod_1.z.number().int().nonnegative(),
     features: zod_1.z.array(zod_1.z.nativeEnum(plan_feature_enum_1.PlanFeature)),
     hasActiveSubscription: zod_1.z.boolean(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Active subscription view (may be null for users without subscription)
+// ─────────────────────────────────────────────────────────────────────────────
 exports.ActiveSubscriptionSchema = zod_1.z.object({
     id: zod_1.z.string().regex(shared_1.UUID_REGEX),
     planCode: zod_1.z.string(),
@@ -35,48 +63,145 @@ exports.ActiveSubscriptionSchema = zod_1.z.object({
     cycleStart: zod_1.z.string().datetime({ offset: true }),
     cycleEnd: zod_1.z.string().datetime({ offset: true }),
     cancelAtPeriodEnd: zod_1.z.boolean(),
+    /** Pending plan code to apply at next term renewal (downgrade path). */
     pendingPlanCode: zod_1.z.string().nullable(),
+    /**
+     * Pending billing period (months) to apply at next renewal together with
+     * pendingPlanCode. null = the period is unchanged (only the plan, or nothing, is pending).
+     */
     pendingTermMonths: zod_1.z.number().int().positive().nullable(),
+    /** End of access while status=PAST_DUE (the 24 h grace or the paid days). */
     graceEndsAt: zod_1.z.string().datetime({ offset: true }).nullable(),
+    /**
+     * Monthly token grant this subscription actually gives, as purchased.
+     * Decimal string of internal units.
+     *
+     * Comes from what was bought, not from the plan row as it reads today: the
+     * term is paid for, so editing the tariff mid-term changes neither the
+     * money already taken nor the tokens already promised.
+     */
     monthlyGrant: zod_1.z.string(),
+    /**
+     * The grant that takes effect at the next renewal — present ONLY when it
+     * differs from `monthlyGrant`, null otherwise.
+     *
+     * Exists because the two CAN differ and the difference is otherwise
+     * invisible: the catalog shows the plan's current number while the account
+     * still runs on the purchased one, and the user has no way to tell which
+     * is wrong. Show it inline next to the grant, not as a banner — the
+     * question is asked while reading the limit, so the answer belongs there:
+     *
+     *     100 000 токенов в месяц
+     *     └ с 15 сентября — 200 000
+     *
+     * Null is the common case; when it is null render nothing at all. Works in
+     * both directions — a lowered grant is stated the same plain way. Follows
+     * a scheduled downgrade too: with `pendingPlanCode` set, this is the
+     * pending plan's grant, so the figure matches the plan named beside it.
+     */
     upcomingMonthlyGrant: zod_1.z.string().nullable(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Active package view (a user may hold multiple simultaneously)
+// ─────────────────────────────────────────────────────────────────────────────
 exports.ActivePackageSchema = zod_1.z.object({
     planCode: zod_1.z.string(),
     expiresAt: zod_1.z.string().datetime({ offset: true }),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Pending (unfinished) subscription payment the user can resume
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * An unfinished subscription checkout or plan change (UPGRADE): the order is still PENDING and not expired.
+ * Frontend shows a "continue your payment" banner and reopens the CloudPayments widget
+ * on this orderId (amount is the server-computed source of truth — do not recompute).
+ */
 exports.PendingSubscriptionPaymentSchema = zod_1.z.object({
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    /** Server-computed amount as integer string (BigInt, ×100 of RUB). */
     amount: zod_1.z.string(),
     planCode: zod_1.z.string(),
     periodMonths: zod_1.z.number().int().positive().nullable(),
+    /** Order expiry timestamp — after this the payment can no longer be resumed. */
     expiresAt: zod_1.z.string().datetime({ offset: true }),
 });
+/**
+ * An unfinished package purchase the user can resume. Packages have no billing period
+ * (no periodMonths) and a user may hold several pending at once — hence an array below.
+ */
 exports.PendingPackagePaymentSchema = zod_1.z.object({
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    /** Server-computed amount as integer string (BigInt, ×100 of RUB). */
     amount: zod_1.z.string(),
     planCode: zod_1.z.string(),
+    /** Order expiry timestamp — after this the payment can no longer be resumed. */
     expiresAt: zod_1.z.string().datetime({ offset: true }),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Auto-renewal collection problem (local dunning or CloudPayments path)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Surfaces an auto-renewal collection problem on GET /subscription/me so the frontend can
+ * show a "we couldn't charge your card" banner with a manual-pay CTA instead of letting the
+ * subscription silently slide toward expiry.
+ *
+ * null on the parent response = no payment problem right now.
+ */
 exports.PaymentIssueSchema = zod_1.z.object({
     state: zod_1.z.nativeEnum(payment_issue_state_enum_1.PaymentIssueState),
     reason: zod_1.z.nativeEnum(payment_issue_reason_enum_1.PaymentIssueReason),
+    /** Amount of the renewal that failed/is pending, integer string (×100 of RUB). */
     amount: zod_1.z.string(),
     currency: zod_1.z.literal('RUB'),
+    /**
+     * When the next automatic attempt is expected. null when state=ACTION_REQUIRED (no
+     * further automatic attempt is coming), or when it genuinely is not known yet.
+     */
     nextAttemptAt: zod_1.z.string().datetime({ offset: true }).nullable(),
+    /**
+     * Whether POST /subscription/pay-now can be called right now. false when the
+     * subscriber has withdrawn consent (cancelAtPeriodEnd — 376-ФЗ), the subscription was
+     * refunded, it has been more than 11 months since the last successful payment, or the
+     * subscription is a comp (unpaid) grant.
+     */
     canPayNow: zod_1.z.boolean(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// GET /v1/subscription/me response
+// ─────────────────────────────────────────────────────────────────────────────
 exports.GetMySubscriptionResponseSchema = zod_1.z.object({
+    /** null when user has no active/recent subscription */
     subscription: exports.ActiveSubscriptionSchema.nullable(),
     packages: zod_1.z.array(exports.ActivePackageSchema),
     effectiveEntitlements: exports.EffectiveEntitlementsSchema,
+    /** null when the user has no unfinished, still-valid subscription payment to resume. */
     pendingSubscriptionPayment: exports.PendingSubscriptionPaymentSchema.nullable(),
+    /** Unfinished, still-valid package payments to resume. Empty array when none. */
     pendingPackagePayments: zod_1.z.array(exports.PendingPackagePaymentSchema),
+    /** null when there is no auto-renewal collection problem right now. */
     paymentIssue: exports.PaymentIssueSchema.nullable(),
+    /**
+     * The same collection problem as paymentIssue, richer and derived only from the real billing
+     * engine. Non-null exactly when paymentIssue is, unless the extra facts could not be read (then null).
+     */
     paymentRecovery: payment_recovery_schema_1.PaymentRecoverySchema.nullable(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Checkout request / response
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Allowed subscription billing periods (months).
+ * Discounts: 1=0%, 3=15%, 6=20%, 12=45%.
+ */
 exports.VALID_PERIOD_MONTHS = [1, 3, 6, 12];
+/**
+ * Custom plan price bounds in internal units (1 000 RUB – 100 000 RUB per month).
+ * Blueprint §0.9/§1/§2.9: custom range is 1000–100000 RUB = 100 000–10 000 000 units (×100).
+ * These constants are the single source of truth shared with server-side pricing logic.
+ */
+/** Custom SUBSCRIPTION min = monthly grant base floor (internal units, ×100 RUB). */
 exports.CUSTOM_PRICE_MIN_SUBSCRIPTION = 250000n;
+/** Custom PACKAGE min = one-time price floor (internal units, ×100 RUB). */
 exports.CUSTOM_PRICE_MIN_PACKAGE = 150000n;
 exports.CUSTOM_PRICE_MAX = 10000000n;
 exports.CheckoutRequestSchema = zod_1.z
@@ -91,11 +216,19 @@ exports.CheckoutRequestSchema = zod_1.z
         message: 'CheckoutRequest.periodMonths.invalid',
     })
         .optional(),
+    /** Required when purchasing a custom-price plan. Decimal string (internal units). */
     customPrice: zod_1.z
         .string()
         .regex(/^\d+$/, { message: 'CheckoutRequest.customPrice.invalid' })
         .optional(),
+    /**
+     * When true the server will attempt a one-click charge via the user's
+     * active default saved payment method (cardholder-initiated stored credential).
+     * Requires the user to have an active SavedPaymentMethod. If absent or false,
+     * the widget flow is used (PENDING_WIDGET).
+     */
     useSavedMethod: zod_1.z.boolean().optional(),
+    /** Optional PURCHASE_MULTIPLIER promo code applied to this purchase. */
     promoCode: zod_1.z.string().trim().min(1).max(64).optional(),
 })
     .refine((v) => {
@@ -104,56 +237,119 @@ exports.CheckoutRequestSchema = zod_1.z
     const n = BigInt(v.customPrice);
     return n >= exports.CUSTOM_PRICE_MIN_SUBSCRIPTION && n <= exports.CUSTOM_PRICE_MAX;
 }, { message: 'CheckoutRequest.customPrice.range', path: ['customPrice'] });
+/**
+ * Checkout response — returns the Order ID created server-side.
+ * Frontend uses this orderId to call GET /v1/payment/checkout-config?orderId=
+ * to obtain CloudPayments widget initialization parameters.
+ *
+ * chargeStatus indicates what the server did with the payment:
+ *   PENDING_WIDGET      — open the CP widget (default when useSavedMethod is absent/false, or no saved method).
+ *   CHARGE_ACCEPTED     — one-click charge accepted; poll GET /subscription/me for fulfillment.
+ *   CHARGE_DECLINED     — one-click declined; show the text for declineClass and optionally open the widget with orderId.
+ *   CHARGE_REQUIRES_3DS — one-click needs 3-D Secure; send the cardholder through acsUrl/paReq
+ *                         (see ChargeStatus doc). The order pays via the normal webhook afterwards.
+ *   CHARGE_PROCESSING   — a charge for this order is in flight or got no definitive answer;
+ *                         do not retry or open the widget, poll GET /subscription/me.
+ */
 exports.CheckoutResponseSchema = zod_1.z.object({
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    /** Computed server-side amount as integer string (BigInt, ×100 of RUB). */
     amount: zod_1.z.string(),
+    /** Indicates how the payment was (or will be) handled. */
     chargeStatus: zod_1.z.nativeEnum(charge_status_enum_1.ChargeStatus),
+    /**
+     * @deprecated Always null: raw bank text is never exposed. Read declineClass.
+     */
     declineReason: zod_1.z.string().nullable(),
+    /**
+     * Payer-facing class of the decline. Non-null exactly when chargeStatus=CHARGE_DECLINED.
+     */
     declineClass: zod_1.z.nativeEnum(payment_decline_class_enum_1.PaymentDeclineClass).nullable(),
+    /** 3-D Secure authentication form target. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     acsUrl: zod_1.z.string().nullable(),
+    /** 3-D Secure PaReq form field. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     paReq: zod_1.z.string().nullable(),
+    /** Gateway transaction id — submitted back to acsUrl as the MD field. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     transactionId: zod_1.z.string().nullable(),
+    /**
+     * Item 10: TermUrl form field — the 3DS form must submit this to acsUrl alongside
+     * MD (transactionId) and PaReq. The bank's ACS page posts MD/PaRes back to it; it is
+     * PAYMENT_3DS_CONTROLLER's completion route (no JWT — see its contract doc comment).
+     * Present only when chargeStatus=CHARGE_REQUIRES_3DS.
+     */
     termUrl: zod_1.z.string().nullable().optional(),
     ...PromoCheckoutResultSchema,
 });
+/**
+ * Custom-tariff calculator (read-only). The user picks how many tokens they want on a slider;
+ * the server derives the bounded customPrice, the per-period prices (subscription) or the
+ * one-time price (package), and the tokens actually granted. Nothing is persisted — the returned
+ * `customPrice` is then passed back verbatim to /checkout or /package.
+ *
+ * Subscription is structurally cheaper than a package for the same tokens (1:1 grant vs 90%).
+ */
 exports.CustomQuoteRequestSchema = zod_1.z.object({
     planId: zod_1.z
         .string({ error: 'CustomQuoteRequest.planId.required' })
         .regex(shared_1.UUID_REGEX, { message: 'CustomQuoteRequest.planId.invalid' }),
+    /** Tokens the user wants to receive (monthly for subscription, total for package). Decimal string, internal token units. */
     desiredTokens: zod_1.z
         .string({ error: 'CustomQuoteRequest.desiredTokens.required' })
         .regex(/^\d+$/, { message: 'CustomQuoteRequest.desiredTokens.invalid' }),
 });
 exports.CustomQuotePeriodSchema = zod_1.z.object({
     periodMonths: zod_1.z.number().int(),
+    /** Multi-month discount applied to this period (0/15/20/45). */
     discountPercent: zod_1.z.number().int(),
+    /** Total charge for the whole term, integer string (×100 of RUB). */
     totalPrice: zod_1.z.string(),
+    /** Per-month price for display, integer string. */
     pricePerMonth: zod_1.z.string(),
 });
 exports.CustomQuoteResponseSchema = zod_1.z.object({
     planId: zod_1.z.string().regex(shared_1.UUID_REGEX),
     type: zod_1.z.nativeEnum(plan_type_enum_1.PlanType),
+    /** customPrice to pass to /checkout (monthly) or /package (one-time), integer string. */
     customPrice: zod_1.z.string(),
+    /** Echo of the requested tokens (normalised), integer string. */
     desiredTokens: zod_1.z.string(),
+    /** Tokens actually granted: per month (subscription) or one-time total (package), integer string. */
     grantedTokens: zod_1.z.string(),
+    /** Valid slider bounds in tokens for this plan/type, integer strings. */
     tokenRange: zod_1.z.object({
         min: zod_1.z.string(),
         max: zod_1.z.string(),
     }),
+    /** Subscription: one entry per valid period. Package: a single one-time entry (periodMonths=1, discount=0). */
     periods: zod_1.z.array(exports.CustomQuotePeriodSchema),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Cancel an unfinished (PENDING) payment by orderId — subscription or package
+// ─────────────────────────────────────────────────────────────────────────────
 exports.CancelCheckoutRequestSchema = zod_1.z.object({
     orderId: zod_1.z
         .string({ error: 'CancelCheckoutRequest.orderId.required' })
         .regex(shared_1.UUID_REGEX, { message: 'CancelCheckoutRequest.orderId.invalid' }),
 });
 exports.CancelCheckoutResponseSchema = zod_1.z.object({
+    /** true once the pending order is voided (idempotent if it was already cancelled). */
     cancelled: zod_1.z.boolean(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Change subscription (upgrade / schedule downgrade)
+// ─────────────────────────────────────────────────────────────────────────────
 exports.ChangeSubscriptionRequestSchema = zod_1.z.object({
     newPlanId: zod_1.z
         .string({ error: 'ChangeSubscriptionRequest.newPlanId.required' })
         .regex(shared_1.UUID_REGEX, { message: 'ChangeSubscriptionRequest.newPlanId.invalid' }),
+    /**
+     * Desired billing period for the new plan (months). When omitted the current
+     * subscription's period is kept (in-place upgrade / same-period downgrade).
+     * When it differs from the current period:
+     *   - Upgrade: a fresh term of this length starts immediately; the unused part
+     *     of the current term is credited (discounted by the new period's discount).
+     *   - Downgrade: the new plan AND this period take effect at the next renewal.
+     */
     newPeriodMonths: zod_1.z
         .number({ error: 'ChangeSubscriptionRequest.newPeriodMonths.invalid' })
         .int({ message: 'ChangeSubscriptionRequest.newPeriodMonths.invalid' })
@@ -161,11 +357,26 @@ exports.ChangeSubscriptionRequestSchema = zod_1.z.object({
         message: 'ChangeSubscriptionRequest.newPeriodMonths.invalid',
     })
         .optional(),
+    /**
+     * When true the server will attempt a one-click charge via the user's
+     * active default saved payment method (cardholder-initiated stored credential).
+     * Only relevant when surcharge > 0 (upgrade path). Ignored on downgrade/zero-surcharge.
+     */
     useSavedMethod: zod_1.z.boolean().optional(),
+    /**
+     * Required when the target plan is custom-price (mirrors CheckoutRequest).
+     * Decimal string (internal units) = the custom monthly grant. Ignored for
+     * non-custom targets (the catalog price is always used).
+     */
     customPrice: zod_1.z
         .string()
         .regex(/^\d+$/, { message: 'ChangeSubscriptionRequest.customPrice.invalid' })
         .optional(),
+    /**
+     * Optional PURCHASE_MULTIPLIER promo code applied to an UPGRADE (a plan change is a normal
+     * purchase). The boost is a percentage of ONE month of the new plan's tokens. Ignored on
+     * a downgrade (nothing is bought).
+     */
     promoCode: zod_1.z.string().trim().min(1).max(64).optional(),
 }).refine((v) => {
     if (v.customPrice === undefined)
@@ -174,17 +385,50 @@ exports.ChangeSubscriptionRequestSchema = zod_1.z.object({
     return n >= exports.CUSTOM_PRICE_MIN_SUBSCRIPTION && n <= exports.CUSTOM_PRICE_MAX;
 }, { message: 'ChangeSubscriptionRequest.customPrice.range', path: ['customPrice'] });
 exports.ChangeSubscriptionResponseSchema = zod_1.z.object({
+    /**
+     * Present when upgrade requires payment (surcharge > 0).
+     * Frontend uses orderId to call GET /v1/payment/checkout-config?orderId=.
+     */
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX).nullable(),
+    /** Surcharge amount as integer string (BigInt, ×100 of RUB). Null for free downgrade. */
     amount: zod_1.z.string().nullable(),
+    /**
+     * Indicates how the payment was (or will be) handled.
+     * PENDING_WIDGET  — open the CP widget.
+     * CHARGE_ACCEPTED — one-click charge accepted; poll GET /subscription/me.
+     *                   Also used for zero-surcharge upgrade (no payment needed).
+     * CHARGE_DECLINED — one-click declined; show the text for declineClass.
+     * CHARGE_REQUIRES_3DS — one-click needs 3-D Secure; send the cardholder through acsUrl/paReq.
+     * CHARGE_PROCESSING — a charge is in flight or got no definitive answer; poll, never retry.
+     * Null for downgrade path (no payment involved).
+     */
     chargeStatus: zod_1.z.nativeEnum(charge_status_enum_1.ChargeStatus).nullable(),
+    /**
+     * @deprecated Always null: raw bank text is never exposed. Read declineClass.
+     */
     declineReason: zod_1.z.string().nullable(),
+    /**
+     * Payer-facing class of the decline. Non-null exactly when chargeStatus=CHARGE_DECLINED.
+     */
     declineClass: zod_1.z.nativeEnum(payment_decline_class_enum_1.PaymentDeclineClass).nullable(),
+    /** 3-D Secure authentication form target. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     acsUrl: zod_1.z.string().nullable(),
+    /** 3-D Secure PaReq form field. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     paReq: zod_1.z.string().nullable(),
+    /** Gateway transaction id — submitted back to acsUrl as the MD field. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     transactionId: zod_1.z.string().nullable(),
+    /**
+     * Item 10: TermUrl form field — the 3DS form must submit this to acsUrl alongside
+     * MD (transactionId) and PaReq. The bank's ACS page posts MD/PaRes back to it; it is
+     * PAYMENT_3DS_CONTROLLER's completion route (no JWT — see its contract doc comment).
+     * Present only when chargeStatus=CHARGE_REQUIRES_3DS.
+     */
     termUrl: zod_1.z.string().nullable().optional(),
     ...PromoCheckoutResultSchema,
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Cancel / Uncancel — no request body needed; owner from JWT
+// ─────────────────────────────────────────────────────────────────────────────
 exports.CancelSubscriptionResponseSchema = zod_1.z.object({
     cancelAtPeriodEnd: zod_1.z.boolean(),
     termEnd: zod_1.z.string().datetime({ offset: true }),
@@ -192,16 +436,25 @@ exports.CancelSubscriptionResponseSchema = zod_1.z.object({
 exports.UncancelSubscriptionResponseSchema = zod_1.z.object({
     cancelAtPeriodEnd: zod_1.z.boolean(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Buy package
+// ─────────────────────────────────────────────────────────────────────────────
 exports.BuyPackageRequestSchema = zod_1.z
     .object({
     planId: zod_1.z
         .string({ error: 'BuyPackageRequest.planId.required' })
         .regex(shared_1.UUID_REGEX, { message: 'BuyPackageRequest.planId.invalid' }),
+    /** Required when purchasing a custom-price package. Decimal string (internal units). */
     customPrice: zod_1.z
         .string()
         .regex(/^\d+$/, { message: 'BuyPackageRequest.customPrice.invalid' })
         .optional(),
+    /**
+     * When true the server will attempt a one-click charge via the user's
+     * active default saved payment method (cardholder-initiated stored credential).
+     */
     useSavedMethod: zod_1.z.boolean().optional(),
+    /** Optional PURCHASE_MULTIPLIER promo code applied to this package purchase. */
     promoCode: zod_1.z.string().trim().min(1).max(64).optional(),
 })
     .refine((v) => {
@@ -210,18 +463,48 @@ exports.BuyPackageRequestSchema = zod_1.z
     const n = BigInt(v.customPrice);
     return n >= exports.CUSTOM_PRICE_MIN_PACKAGE && n <= exports.CUSTOM_PRICE_MAX;
 }, { message: 'BuyPackageRequest.customPrice.range', path: ['customPrice'] });
+/**
+ * Buy package response — returns the Order ID created server-side.
+ * Frontend uses orderId to call GET /v1/payment/checkout-config?orderId=.
+ *
+ * chargeStatus indicates what the server did with the payment:
+ *   PENDING_WIDGET      — open the CP widget.
+ *   CHARGE_ACCEPTED     — one-click charge accepted; poll GET /subscription/me.
+ *   CHARGE_DECLINED     — one-click declined; show the text for declineClass and optionally open widget.
+ *   CHARGE_REQUIRES_3DS — one-click needs 3-D Secure; send the cardholder through acsUrl/paReq.
+ */
 exports.BuyPackageResponseSchema = zod_1.z.object({
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    /** Computed server-side amount as integer string (BigInt, ×100 of RUB). */
     amount: zod_1.z.string(),
+    /** Indicates how the payment was (or will be) handled. */
     chargeStatus: zod_1.z.nativeEnum(charge_status_enum_1.ChargeStatus),
+    /**
+     * @deprecated Always null: raw bank text is never exposed. Read declineClass.
+     */
     declineReason: zod_1.z.string().nullable(),
+    /**
+     * Payer-facing class of the decline. Non-null exactly when chargeStatus=CHARGE_DECLINED.
+     */
     declineClass: zod_1.z.nativeEnum(payment_decline_class_enum_1.PaymentDeclineClass).nullable(),
+    /** 3-D Secure authentication form target. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     acsUrl: zod_1.z.string().nullable(),
+    /** 3-D Secure PaReq form field. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     paReq: zod_1.z.string().nullable(),
+    /** Gateway transaction id — submitted back to acsUrl as the MD field. Present only when chargeStatus=CHARGE_REQUIRES_3DS. */
     transactionId: zod_1.z.string().nullable(),
+    /**
+     * Item 10: TermUrl form field — the 3DS form must submit this to acsUrl alongside
+     * MD (transactionId) and PaReq. The bank's ACS page posts MD/PaRes back to it; it is
+     * PAYMENT_3DS_CONTROLLER's completion route (no JWT — see its contract doc comment).
+     * Present only when chargeStatus=CHARGE_REQUIRES_3DS.
+     */
     termUrl: zod_1.z.string().nullable().optional(),
     ...PromoCheckoutResultSchema,
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Promo quote — preview the PURCHASE_MULTIPLIER boost for a purchase WITHOUT ordering
+// ─────────────────────────────────────────────────────────────────────────────
 exports.PromoQuoteRequestSchema = zod_1.z.object({
     promoCode: zod_1.z
         .string({ error: 'PromoQuoteRequest.promoCode.required' })
@@ -231,24 +514,55 @@ exports.PromoQuoteRequestSchema = zod_1.z.object({
     planId: zod_1.z
         .string({ error: 'PromoQuoteRequest.planId.required' })
         .regex(shared_1.UUID_REGEX, { message: 'PromoQuoteRequest.planId.invalid' }),
+    /** Required for SUBSCRIPTION plans. */
     periodMonths: zod_1.z
         .number({ error: 'PromoQuoteRequest.periodMonths.invalid' })
         .int({ message: 'PromoQuoteRequest.periodMonths.invalid' })
         .positive({ message: 'PromoQuoteRequest.periodMonths.invalid' })
         .optional(),
+    /** Required for custom-price plans. Decimal string (internal units). */
     customPrice: zod_1.z
         .string()
         .regex(/^\d+$/, { message: 'PromoQuoteRequest.customPrice.invalid' })
         .optional(),
 });
+/**
+ * Promo quote — preview only, never reserves. `applied=true` → `boost` is the token add-on; when
+ * the code is invalid/ineligible `applied=false` + `reason` (and `boost=null`). A 4xx is returned
+ * only for a bad plan/period (not for promo reasons).
+ */
 exports.PromoQuoteResponseSchema = zod_1.z.object({
     applied: zod_1.z.boolean(),
     reason: zod_1.z.nativeEnum(promo_errors_1.PromoErrorCode).nullable(),
+    /** Boost added to the grant (decimal string of internal units); null when not applied. */
     boost: zod_1.z.string().nullable(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Pay now — manual renewal payment, no request body (owner + target term from JWT)
+// ─────────────────────────────────────────────────────────────────────────────
 exports.PayNowRequestSchema = zod_1.z.object({});
+/**
+ * Pay-now response — same shape the frontend already knows from /checkout: open the CP
+ * widget (tokenize=true in checkout-config, never recurrent) on orderId.
+ *
+ * chargeStatus:
+ *   PENDING_WIDGET    — open the CP widget. The default outcome — pay-now never attempts a
+ *                       one-click/token charge by design (the whole point is to collect a NEW
+ *                       card, not retry the failing one).
+ *   CHARGE_PROCESSING — this subscription already has a renewal payment in flight (an
+ *                       admitted CloudPayments Check, a server charge with the bank, or an
+ *                       attempt whose result is unknown). Do not open another widget; poll
+ *                       GET /subscription/me instead.
+ *   CHARGE_ACCEPTED   — money for this term was already received and is being applied (a
+ *                       widget capture settled, or an automatic / provider payment is paid and
+ *                       fulfilment is still draining). Nothing to pay: poll GET /subscription/me.
+ *
+ * Only these two states refuse a manual payment. A compensation owed back, a release that does
+ * not prove «no charge» or a lost pending payment never do.
+ */
 exports.PayNowResponseSchema = zod_1.z.object({
     orderId: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    /** Computed server-side amount as integer string (BigInt, ×100 of RUB). */
     amount: zod_1.z.string(),
     chargeStatus: zod_1.z.nativeEnum(charge_status_enum_1.ChargeStatus),
 });

package/build/v1/subscription/schemas/subscription.schema.js.map

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

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

@@ -1,3 +1,4 @@
+/** Package lifecycle states — mirrors the DB VarChar column values. A package row is created when its order is paid. */
 export declare enum UserPackageStatus {
     ACTIVE = "ACTIVE",
     EXPIRED = "EXPIRED"

package/build/v1/subscription/schemas/user-package-status.enum.js

@@ -1,6 +1,9 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/user-package-status.enum.ts
+// F74: moved from domain/aggregates/user-package.types.ts to contracts as the single source of truth.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserPackageStatus = void 0;
+/** Package lifecycle states — mirrors the DB VarChar column values. A package row is created when its order is paid. */
 var UserPackageStatus;
 (function (UserPackageStatus) {
     UserPackageStatus["ACTIVE"] = "ACTIVE";

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

@@ -1 +1 @@
-{"version":3,"file":"user-package-status.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/user-package-status.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;AACvB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B"}
+{"version":3,"file":"user-package-status.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/user-package-status.enum.ts"],"names":[],"mappings":";AAAA,qEAAqE;AACrE,sGAAsG;;;AAEtG,wHAAwH;AACxH,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;AACvB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B"}

package/build/v1/subscription/subscription.errors.d.ts

@@ -13,8 +13,17 @@ export declare enum SubscriptionErrorCode {
     PAYMENT_ALREADY_FINALIZED = "PAYMENT_ALREADY_FINALIZED",
     INVALID_ENTITLEMENT_SNAPSHOT = "INVALID_ENTITLEMENT_SNAPSHOT",
     ILLEGAL_STATUS_TRANSITION = "ILLEGAL_STATUS_TRANSITION",
+    /** A plan change is already in progress (an upgrade order is pending/unfulfilled). */
     CHANGE_ALREADY_IN_PROGRESS = "CHANGE_ALREADY_IN_PROGRESS",
+    /** Another billing operation for this user is currently being processed (concurrency lock). */
     BILLING_OPERATION_IN_PROGRESS = "BILLING_OPERATION_IN_PROGRESS",
+    /**
+     * POST /subscription/pay-now was called but canPayNow would be false: the subscriber
+     * withdrew consent (cancelAtPeriodEnd — 376-ФЗ), the subscription was refunded, superseded
+     * or force-expired by an admin, it is a comp (unpaid) grant, or more than 11 months have
+     * passed since the term became unpaid (reactivation window closed — see
+     * LOCAL_DUNNING_DEADLINE_MONTHS).
+     */
     PAY_NOW_NOT_ALLOWED = "PAY_NOW_NOT_ALLOWED"
 }
 export declare const SUBSCRIPTION_ERRORS: Record<SubscriptionErrorCode, ErrorMetadata>;