@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/subscription/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./subscription.errors"), exports);
 __exportStar(require("./commands"), exports);
 __exportStar(require("./queries"), exports);
 __exportStar(require("./admin"), exports);
+// Re-export from centralized locations
 var controllers_1 = require("../../controllers");
 Object.defineProperty(exports, "SUBSCRIPTION_CONTROLLER", { enumerable: true, get: function () { return controllers_1.SUBSCRIPTION_CONTROLLER; } });
 Object.defineProperty(exports, "SUBSCRIPTION_UNREG_CONTROLLER", { enumerable: true, get: function () { return controllers_1.SUBSCRIPTION_UNREG_CONTROLLER; } });

package/build/v1/subscription/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/subscription/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,wDAAsC;AACtC,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AAExB,iDAA2F;AAAlF,sHAAA,uBAAuB,OAAA;AAAE,4HAAA,6BAA6B,OAAA;AAC/D,uCAAmD;AAA1C,6GAAA,mBAAmB,OAAA;AAC5B,iDAG2B;AAFvB,4HAAA,6BAA6B,OAAA;AAC7B,uHAAA,wBAAwB,OAAA;AAE5B,uCAGsB;AAFlB,mHAAA,yBAAyB,OAAA;AACzB,8GAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/subscription/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,wDAAsC;AACtC,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,uCAAuC;AACvC,iDAA2F;AAAlF,sHAAA,uBAAuB,OAAA;AAAE,4HAAA,6BAA6B,OAAA;AAC/D,uCAAmD;AAA1C,6GAAA,mBAAmB,OAAA;AAC5B,iDAG2B;AAFvB,4HAAA,6BAA6B,OAAA;AAC7B,uHAAA,wBAAwB,OAAA;AAE5B,uCAGsB;AAFlB,mHAAA,yBAAyB,OAAA;AACzB,8GAAA,oBAAoB,OAAA"}

package/build/v1/subscription/queries/get-subscription-change-preview.query.d.ts

@@ -1,10 +1,23 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Subscription transition types for plan change preview.
+ */
 export declare enum SubscriptionTransition {
     UPGRADE = "UPGRADE",
     DOWNGRADE = "DOWNGRADE",
     SAME = "SAME"
 }
+/**
+ * Get preview of plan change for multiple target plans.
+ * Used by PlansService.listForUser() to enrich the reg plan catalog with
+ * surcharge preview for upgrade paths.
+ *
+ * Cross-module query: plans service → subscription.
+ * Handler owns 1 repository: UserSubscriptionRepository.
+ * Pricing formula: SubscriptionPricingService (domain service, not a repo/bus).
+ * No HTTP endpoint — invoked only via TypedQueryBus.
+ */
 export declare namespace GetSubscriptionChangePreviewQuery {
     const Request: z.ZodObject<{
         userId: z.ZodString;

package/build/v1/subscription/queries/get-subscription-change-preview.query.js

@@ -4,18 +4,32 @@ exports.GetSubscriptionChangePreviewQuery = exports.SubscriptionTransition = voi
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * Subscription transition types for plan change preview.
+ */
 var SubscriptionTransition;
 (function (SubscriptionTransition) {
     SubscriptionTransition["UPGRADE"] = "UPGRADE";
     SubscriptionTransition["DOWNGRADE"] = "DOWNGRADE";
     SubscriptionTransition["SAME"] = "SAME";
 })(SubscriptionTransition || (exports.SubscriptionTransition = SubscriptionTransition = {}));
+/**
+ * Get preview of plan change for multiple target plans.
+ * Used by PlansService.listForUser() to enrich the reg plan catalog with
+ * surcharge preview for upgrade paths.
+ *
+ * Cross-module query: plans service → subscription.
+ * Handler owns 1 repository: UserSubscriptionRepository.
+ * Pricing formula: SubscriptionPricingService (domain service, not a repo/bus).
+ * No HTTP endpoint — invoked only via TypedQueryBus.
+ */
 var GetSubscriptionChangePreviewQuery;
 (function (GetSubscriptionChangePreviewQuery) {
     GetSubscriptionChangePreviewQuery.Request = zod_1.z.object({
         userId: zod_1.z
             .string({ error: 'GetSubscriptionChangePreviewQuery.userId.required' })
             .regex(shared_1.UUID_REGEX, { message: 'GetSubscriptionChangePreviewQuery.userId.invalid' }),
+        /** Target plan IDs to compute preview for. */
         targetPlanIds: zod_1.z.array(zod_1.z
             .string({ error: 'GetSubscriptionChangePreviewQuery.targetPlanIds.item.invalid' })
             .regex(shared_1.UUID_REGEX, {
@@ -23,10 +37,13 @@ var GetSubscriptionChangePreviewQuery;
         })),
     });
     GetSubscriptionChangePreviewQuery.Response = zod_1.z.object({
+        /** Current plan code, or null if user has no active subscription. */
         currentPlanCode: zod_1.z.string().nullable(),
+        /** Per-target preview results. */
         perTarget: zod_1.z.array(zod_1.z.object({
             planId: zod_1.z.string().regex(shared_1.UUID_REGEX),
             transition: zod_1.z.nativeEnum(SubscriptionTransition),
+            /** Surcharge as integer string (BigInt, ×100 of RUB). "0" for downgrade/same. */
             surcharge: zod_1.z.string().regex(shared_1.BIGINT_STRING_REGEX),
         })),
     });

package/build/v1/subscription/queries/get-subscription-change-preview.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-subscription-change-preview.query.js","sourceRoot":"","sources":["../../../../v1/subscription/queries/get-subscription-change-preview.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkE;AAClE,uEAA8D;AAK9D,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAC9B,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,uCAAa,CAAA;AACjB,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC;AAYD,IAAiB,iCAAiC,CAiCjD;AAjCD,WAAiB,iCAAiC;IACjC,yCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;aACtE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;QAEvF,aAAa,EAAE,OAAC,CAAC,KAAK,CAClB,OAAC;aACI,MAAM,CAAC,EAAE,KAAK,EAAE,8DAA8D,EAAE,CAAC;aACjF,KAAK,CAAC,mBAAU,EAAE;YACf,OAAO,EAAE,8DAA8D;SAC1E,CAAC,CACT;KACJ,CAAC,CAAC;IAEU,0CAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAE7B,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAEtC,SAAS,EAAE,OAAC,CAAC,KAAK,CACd,OAAC,CAAC,MAAM,CAAC;YACL,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;YACpC,UAAU,EAAE,OAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAEhD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,4BAAmB,CAAC;SACnD,CAAC,CACL;KACJ,CAAC,CAAC;IAEU,wCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjCgB,iCAAiC,iDAAjC,iCAAiC,QAiCjD"}
+{"version":3,"file":"get-subscription-change-preview.query.js","sourceRoot":"","sources":["../../../../v1/subscription/queries/get-subscription-change-preview.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkE;AAClE,uEAA8D;AAE9D;;GAEG;AACH,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAC9B,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,uCAAa,CAAA;AACjB,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC;AAED;;;;;;;;;GASG;AACH,IAAiB,iCAAiC,CAiCjD;AAjCD,WAAiB,iCAAiC;IACjC,yCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;aACtE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;QACvF,8CAA8C;QAC9C,aAAa,EAAE,OAAC,CAAC,KAAK,CAClB,OAAC;aACI,MAAM,CAAC,EAAE,KAAK,EAAE,8DAA8D,EAAE,CAAC;aACjF,KAAK,CAAC,mBAAU,EAAE;YACf,OAAO,EAAE,8DAA8D;SAC1E,CAAC,CACT;KACJ,CAAC,CAAC;IAEU,0CAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,qEAAqE;QACrE,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACtC,kCAAkC;QAClC,SAAS,EAAE,OAAC,CAAC,KAAK,CACd,OAAC,CAAC,MAAM,CAAC;YACL,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;YACpC,UAAU,EAAE,OAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAChD,iFAAiF;YACjF,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,4BAAmB,CAAC;SACnD,CAAC,CACL;KACJ,CAAC,CAAC;IAEU,wCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjCgB,iCAAiC,iDAAjC,iCAAiC,QAiCjD"}

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

@@ -1,3 +1,35 @@
+/**
+ * Charge status returned by checkout / package / change-subscription endpoints
+ * when a payment is expected.
+ *
+ * PENDING_WIDGET      — no one-click attempt was made; frontend must open the CP widget.
+ *                       Default behavior (useSavedMethod absent/false, or no saved method).
+ * CHARGE_ACCEPTED     — one-click charge was accepted by CloudPayments; fulfillment arrives
+ *                       via webhook within ~30 s. Frontend should poll GET /subscription/me.
+ *                       Also used for zero-surcharge upgrade path (no payment needed —
+ *                       semantically honest: the "charge" is the 0-amount op that immediately
+ *                       fulfills without a widget).
+ * CHARGE_DECLINED     — one-click charge was synchronously declined; declineReason is set.
+ *                       The order remains PENDING — frontend may open the CP widget with the
+ *                       same orderId via GET /payment/checkout-config?orderId=.
+ * CHARGE_REQUIRES_3DS — the gateway did not decline the charge; it needs 3-D Secure cardholder
+ *                       authentication. Not a decline — the order stays PAID-able. acsUrl/paReq/
+ *                       termUrl are set; the frontend must submit a form (POST acsUrl, fields:
+ *                       MD=transactionId, PaReq=paReq, TermUrl=termUrl) to complete the
+ *                       challenge, e.g. by opening the CloudPayments widget's 3DS iframe with
+ *                       these four values. The bank's ACS page then posts MD+PaRes back to
+ *                       termUrl itself (PAYMENT_3DS_CONTROLLER — item 10), which forwards the
+ *                       completion to the gateway and redirects the browser onward; the order
+ *                       still pays via the normal Pay webhook (idempotent).
+ * CHARGE_PROCESSING   — codex M4: this order already has an unresolved charge attempt in
+ *                       flight — a previous one-click charge/widget payment/plan-change is still awaiting its
+ *                       Pay/Fail webhook. No new charge was attempted and the widget must
+ *                       NOT be opened for this order: doing either risks a double charge.
+ *                       The frontend should poll GET /subscription/me instead of retrying.
+ *                       Also returned when THIS one-click charge got no definitive gateway
+ *                       answer (network error/timeout): the card may or may not have been
+ *                       charged — same handling, never shown as a success.
+ */
 export declare enum ChargeStatus {
     PENDING_WIDGET = "PENDING_WIDGET",
     CHARGE_ACCEPTED = "CHARGE_ACCEPTED",

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

@@ -1,6 +1,39 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/charge-status.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChargeStatus = void 0;
+/**
+ * Charge status returned by checkout / package / change-subscription endpoints
+ * when a payment is expected.
+ *
+ * PENDING_WIDGET      — no one-click attempt was made; frontend must open the CP widget.
+ *                       Default behavior (useSavedMethod absent/false, or no saved method).
+ * CHARGE_ACCEPTED     — one-click charge was accepted by CloudPayments; fulfillment arrives
+ *                       via webhook within ~30 s. Frontend should poll GET /subscription/me.
+ *                       Also used for zero-surcharge upgrade path (no payment needed —
+ *                       semantically honest: the "charge" is the 0-amount op that immediately
+ *                       fulfills without a widget).
+ * CHARGE_DECLINED     — one-click charge was synchronously declined; declineReason is set.
+ *                       The order remains PENDING — frontend may open the CP widget with the
+ *                       same orderId via GET /payment/checkout-config?orderId=.
+ * CHARGE_REQUIRES_3DS — the gateway did not decline the charge; it needs 3-D Secure cardholder
+ *                       authentication. Not a decline — the order stays PAID-able. acsUrl/paReq/
+ *                       termUrl are set; the frontend must submit a form (POST acsUrl, fields:
+ *                       MD=transactionId, PaReq=paReq, TermUrl=termUrl) to complete the
+ *                       challenge, e.g. by opening the CloudPayments widget's 3DS iframe with
+ *                       these four values. The bank's ACS page then posts MD+PaRes back to
+ *                       termUrl itself (PAYMENT_3DS_CONTROLLER — item 10), which forwards the
+ *                       completion to the gateway and redirects the browser onward; the order
+ *                       still pays via the normal Pay webhook (idempotent).
+ * CHARGE_PROCESSING   — codex M4: this order already has an unresolved charge attempt in
+ *                       flight — a previous one-click charge/widget payment/plan-change is still awaiting its
+ *                       Pay/Fail webhook. No new charge was attempted and the widget must
+ *                       NOT be opened for this order: doing either risks a double charge.
+ *                       The frontend should poll GET /subscription/me instead of retrying.
+ *                       Also returned when THIS one-click charge got no definitive gateway
+ *                       answer (network error/timeout): the card may or may not have been
+ *                       charged — same handling, never shown as a success.
+ */
 var ChargeStatus;
 (function (ChargeStatus) {
     ChargeStatus["PENDING_WIDGET"] = "PENDING_WIDGET";

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

@@ -1 +1 @@
-{"version":3,"file":"charge-status.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/charge-status.enum.ts"],"names":[],"mappings":";;;AAkCA,IAAY,YAMX;AAND,WAAY,YAAY;IACpB,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;IACnC,mDAAmC,CAAA;IACnC,2DAA2C,CAAA;IAC3C,uDAAuC,CAAA;AAC3C,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB"}
+{"version":3,"file":"charge-status.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/charge-status.enum.ts"],"names":[],"mappings":";AAAA,+DAA+D;;;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,IAAY,YAMX;AAND,WAAY,YAAY;IACpB,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;IACnC,mDAAmC,CAAA;IACnC,2DAA2C,CAAA;IAC3C,uDAAuC,CAAA;AAC3C,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB"}

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

@@ -18,6 +18,8 @@ __exportStar(require("./subscription-status.enum"), exports);
 __exportStar(require("./subscription-stop-reason.enum"), exports);
 __exportStar(require("./user-package-status.enum"), exports);
 __exportStar(require("./plan-transition-kind.enum"), exports);
+// purchase-intent-status.enum removed — PurchaseIntent folded into Order (payment module).
+// Use OrderStatus from @veruna/api-contracts (v1/payment/schemas/order-status.enum.ts).
 __exportStar(require("./purchase-kind.enum"), exports);
 __exportStar(require("./charge-status.enum"), exports);
 __exportStar(require("./payment-issue-state.enum"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,kEAAgD;AAChD,6DAA2C;AAC3C,8DAA4C;AAG5C,uDAAqC;AACrC,uDAAqC;AACrC,6DAA2C;AAC3C,8DAA4C;AAC5C,gEAA8C;AAC9C,gEAA8C;AAC9C,iEAA+C;AAC/C,wEAAsD;AACtD,uEAAqD;AACrD,sEAAoD;AACpD,0EAAwD;AACxD,4DAA0C;AAC1C,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,kEAAgD;AAChD,6DAA2C;AAC3C,8DAA4C;AAC5C,2FAA2F;AAC3F,wFAAwF;AACxF,uDAAqC;AACrC,uDAAqC;AACrC,6DAA2C;AAC3C,8DAA4C;AAC5C,gEAA8C;AAC9C,gEAA8C;AAC9C,iEAA+C;AAC/C,wEAAsD;AACtD,uEAAqD;AACrD,sEAAoD;AACpD,0EAAwD;AACxD,4DAA0C;AAC1C,wDAAsC"}

package/build/v1/subscription/schemas/payment-issue-reason.enum.d.ts

@@ -1,3 +1,22 @@
+/**
+ * Caller-facing cause of a renewal payment problem — drives which paragraph of copy the
+ * frontend/notification shows. Provider-neutral: never a raw CloudPayments reason code.
+ *
+ * Mirrors the subscription module's internal `PaymentFailedReason` union (notifications
+ * `payment-failed.types.ts` and `subscription-billing-notification.service.types.ts`) —
+ * kept as an independently-defined, structurally-identical contract enum rather than a
+ * shared import, per the project's layering rule. Keep all three in sync.
+ *
+ * insufficientFunds    — a transient/soft decline (funds, issuer timeout, etc.).
+ * bankFraudSuspected   — the bank flagged the charge as suspected fraud (CP 5059); the
+ *                        card itself is not blocked, only this subscription's auto-charges.
+ * cardExpired          — the saved card's expiry date has passed.
+ * cardRevoked          — the saved card was reported lost/stolen/blocked.
+ * requires3ds          — the gateway needs 3-D Secure cardholder authentication, which an
+ *                        unattended merchant-initiated charge cannot complete.
+ * noCard               — there is no ACTIVE saved payment method to charge at all.
+ * other                — any other/unclassified cause.
+ */
 export declare enum PaymentIssueReason {
     INSUFFICIENT_FUNDS = "insufficientFunds",
     BANK_FRAUD_SUSPECTED = "bankFraudSuspected",

package/build/v1/subscription/schemas/payment-issue-reason.enum.js

@@ -1,6 +1,26 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-issue-reason.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentIssueReason = void 0;
+/**
+ * Caller-facing cause of a renewal payment problem — drives which paragraph of copy the
+ * frontend/notification shows. Provider-neutral: never a raw CloudPayments reason code.
+ *
+ * Mirrors the subscription module's internal `PaymentFailedReason` union (notifications
+ * `payment-failed.types.ts` and `subscription-billing-notification.service.types.ts`) —
+ * kept as an independently-defined, structurally-identical contract enum rather than a
+ * shared import, per the project's layering rule. Keep all three in sync.
+ *
+ * insufficientFunds    — a transient/soft decline (funds, issuer timeout, etc.).
+ * bankFraudSuspected   — the bank flagged the charge as suspected fraud (CP 5059); the
+ *                        card itself is not blocked, only this subscription's auto-charges.
+ * cardExpired          — the saved card's expiry date has passed.
+ * cardRevoked          — the saved card was reported lost/stolen/blocked.
+ * requires3ds          — the gateway needs 3-D Secure cardholder authentication, which an
+ *                        unattended merchant-initiated charge cannot complete.
+ * noCard               — there is no ACTIVE saved payment method to charge at all.
+ * other                — any other/unclassified cause.
+ */
 var PaymentIssueReason;
 (function (PaymentIssueReason) {
     PaymentIssueReason["INSUFFICIENT_FUNDS"] = "insufficientFunds";

package/build/v1/subscription/schemas/payment-issue-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-issue-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-issue-reason.enum.ts"],"names":[],"mappings":";;;AAqBA,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC1B,8DAAwC,CAAA;IACxC,iEAA2C,CAAA;IAC3C,kDAA4B,CAAA;IAC5B,kDAA4B,CAAA;IAC5B,kDAA4B,CAAA;IAC5B,wCAAkB,CAAA;IAClB,qCAAe,CAAA;AACnB,CAAC,EARW,kBAAkB,kCAAlB,kBAAkB,QAQ7B"}
+{"version":3,"file":"payment-issue-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-issue-reason.enum.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC1B,8DAAwC,CAAA;IACxC,iEAA2C,CAAA;IAC3C,kDAA4B,CAAA;IAC5B,kDAA4B,CAAA;IAC5B,kDAA4B,CAAA;IAC5B,wCAAkB,CAAA;IAClB,qCAAe,CAAA;AACnB,CAAC,EARW,kBAAkB,kCAAlB,kBAAkB,QAQ7B"}

package/build/v1/subscription/schemas/payment-issue-state.enum.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Whether an auto-renewal collection problem will keep retrying on its own, or has
+ * permanently stopped and now needs the subscriber to pay manually.
+ *
+ * RETRYING        — a charge attempt failed, but either our own dunning schedule or the
+ *                    payment provider's own retry series will try again on its own. The
+ *                    subscriber does not have to act, but `canPayNow` lets them skip the
+ *                    wait.
+ * ACTION_REQUIRED — no further automatic attempt will ever happen for this term (hard
+ *                    decline, exhausted schedule, revoked/expired card, no card on file,
+ *                    requires 3-D Secure, or the provider series is EXHAUSTED/CANCELLING
+ *                    toward termination). The subscriber must pay manually or the
+ *                    subscription expires at grace end.
+ */
 export declare enum PaymentIssueState {
     RETRYING = "RETRYING",
     ACTION_REQUIRED = "ACTION_REQUIRED"

package/build/v1/subscription/schemas/payment-issue-state.enum.js

@@ -1,6 +1,21 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-issue-state.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentIssueState = void 0;
+/**
+ * Whether an auto-renewal collection problem will keep retrying on its own, or has
+ * permanently stopped and now needs the subscriber to pay manually.
+ *
+ * RETRYING        — a charge attempt failed, but either our own dunning schedule or the
+ *                    payment provider's own retry series will try again on its own. The
+ *                    subscriber does not have to act, but `canPayNow` lets them skip the
+ *                    wait.
+ * ACTION_REQUIRED — no further automatic attempt will ever happen for this term (hard
+ *                    decline, exhausted schedule, revoked/expired card, no card on file,
+ *                    requires 3-D Secure, or the provider series is EXHAUSTED/CANCELLING
+ *                    toward termination). The subscriber must pay manually or the
+ *                    subscription expires at grace end.
+ */
 var PaymentIssueState;
 (function (PaymentIssueState) {
     PaymentIssueState["RETRYING"] = "RETRYING";

package/build/v1/subscription/schemas/payment-issue-state.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-issue-state.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-issue-state.enum.ts"],"names":[],"mappings":";;;AAgBA,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,wDAAmC,CAAA;AACvC,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B"}
+{"version":3,"file":"payment-issue-state.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-issue-state.enum.ts"],"names":[],"mappings":";AAAA,qEAAqE;;;AAErE;;;;;;;;;;;;;GAaG;AACH,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,wDAAmC,CAAA;AACvC,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B"}

package/build/v1/subscription/schemas/payment-recovery-action-type.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * PAY_NOW     — pay the remaining amount of the term (POST /subscription/pay-now opens the widget).
+ */
 export declare enum PaymentRecoveryActionType {
     PAY_NOW = "PAY_NOW"
 }

package/build/v1/subscription/schemas/payment-recovery-action-type.enum.js

@@ -1,6 +1,10 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-action-type.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryActionType = void 0;
+/**
+ * PAY_NOW     — pay the remaining amount of the term (POST /subscription/pay-now opens the widget).
+ */
 var PaymentRecoveryActionType;
 (function (PaymentRecoveryActionType) {
     PaymentRecoveryActionType["PAY_NOW"] = "PAY_NOW";

package/build/v1/subscription/schemas/payment-recovery-action-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-action-type.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-action-type.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,yBAEX;AAFD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;AACvB,CAAC,EAFW,yBAAyB,yCAAzB,yBAAyB,QAEpC"}
+{"version":3,"file":"payment-recovery-action-type.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-action-type.enum.ts"],"names":[],"mappings":";AAAA,8EAA8E;;;AAE9E;;GAEG;AACH,IAAY,yBAEX;AAFD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;AACvB,CAAC,EAFW,yBAAyB,yCAAzB,yBAAyB,QAEpC"}

package/build/v1/subscription/schemas/payment-recovery-attempt-kind.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Who makes the next automatic attempt.
+ * AUTO_CHARGE    — our own scheduler charges the saved card.
+ */
 export declare enum PaymentRecoveryAttemptKind {
     AUTO_CHARGE = "AUTO_CHARGE"
 }

package/build/v1/subscription/schemas/payment-recovery-attempt-kind.enum.js

@@ -1,6 +1,11 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-attempt-kind.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryAttemptKind = void 0;
+/**
+ * Who makes the next automatic attempt.
+ * AUTO_CHARGE    — our own scheduler charges the saved card.
+ */
 var PaymentRecoveryAttemptKind;
 (function (PaymentRecoveryAttemptKind) {
     PaymentRecoveryAttemptKind["AUTO_CHARGE"] = "AUTO_CHARGE";

package/build/v1/subscription/schemas/payment-recovery-attempt-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-attempt-kind.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-attempt-kind.enum.ts"],"names":[],"mappings":";;;AAMA,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IAClC,yDAA2B,CAAA;AAC/B,CAAC,EAFW,0BAA0B,0CAA1B,0BAA0B,QAErC"}
+{"version":3,"file":"payment-recovery-attempt-kind.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-attempt-kind.enum.ts"],"names":[],"mappings":";AAAA,+EAA+E;;;AAE/E;;;GAGG;AACH,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IAClC,yDAA2B,CAAA;AAC/B,CAAC,EAFW,0BAA0B,0CAA1B,0BAA0B,QAErC"}

package/build/v1/subscription/schemas/payment-recovery-attempt-state.enum.d.ts

@@ -1,3 +1,4 @@
+/** State of the most recent charge attempt of the collection. */
 export declare enum PaymentRecoveryAttemptState {
     IN_FLIGHT = "IN_FLIGHT",
     AWAITING_RECONCILE = "AWAITING_RECONCILE",

package/build/v1/subscription/schemas/payment-recovery-attempt-state.enum.js

@@ -1,6 +1,8 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-attempt-state.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryAttemptState = void 0;
+/** State of the most recent charge attempt of the collection. */
 var PaymentRecoveryAttemptState;
 (function (PaymentRecoveryAttemptState) {
     PaymentRecoveryAttemptState["IN_FLIGHT"] = "IN_FLIGHT";

package/build/v1/subscription/schemas/payment-recovery-attempt-state.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-attempt-state.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-attempt-state.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACnC,sDAAuB,CAAA;IACvB,wEAAyC,CAAA;IACzC,oDAAqB,CAAA;IACrB,sDAAuB,CAAA;AAC3B,CAAC,EALW,2BAA2B,2CAA3B,2BAA2B,QAKtC"}
+{"version":3,"file":"payment-recovery-attempt-state.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-attempt-state.enum.ts"],"names":[],"mappings":";AAAA,gFAAgF;;;AAEhF,iEAAiE;AACjE,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACnC,sDAAuB,CAAA;IACvB,wEAAyC,CAAA;IACzC,oDAAqB,CAAA;IACrB,sDAAuB,CAAA;AAC3B,CAAC,EALW,2BAA2B,2CAA3B,2BAA2B,QAKtC"}

package/build/v1/subscription/schemas/payment-recovery-disabled-reason.enum.d.ts

@@ -1,3 +1,4 @@
+/** Why a recovery action is not available right now. Never shown raw: map to neutral copy. */
 export declare enum PaymentRecoveryDisabledReason {
     ATTEMPT_IN_FLIGHT = "ATTEMPT_IN_FLIGHT",
     NOT_PAYABLE = "NOT_PAYABLE"

package/build/v1/subscription/schemas/payment-recovery-disabled-reason.enum.js

@@ -1,6 +1,8 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-disabled-reason.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryDisabledReason = void 0;
+/** Why a recovery action is not available right now. Never shown raw: map to neutral copy. */
 var PaymentRecoveryDisabledReason;
 (function (PaymentRecoveryDisabledReason) {
     PaymentRecoveryDisabledReason["ATTEMPT_IN_FLIGHT"] = "ATTEMPT_IN_FLIGHT";

package/build/v1/subscription/schemas/payment-recovery-disabled-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-disabled-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-disabled-reason.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,6BAGX;AAHD,WAAY,6BAA6B;IACrC,wEAAuC,CAAA;IACvC,4DAA2B,CAAA;AAC/B,CAAC,EAHW,6BAA6B,6CAA7B,6BAA6B,QAGxC"}
+{"version":3,"file":"payment-recovery-disabled-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-disabled-reason.enum.ts"],"names":[],"mappings":";AAAA,kFAAkF;;;AAElF,8FAA8F;AAC9F,IAAY,6BAGX;AAHD,WAAY,6BAA6B;IACrC,wEAAuC,CAAA;IACvC,4DAA2B,CAAA;AAC/B,CAAC,EAHW,6BAA6B,6CAA7B,6BAA6B,QAGxC"}

package/build/v1/subscription/schemas/payment-recovery-reason.enum.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Why the collection is not going through. Provider-neutral: never a raw bank text or code.
+ * The first nine values are the PaymentDeclineClass of the last bank decline.
+ *
+ * AUTHENTICATION_REQUIRED — the bank asks for 3-D Secure, which an unattended charge cannot complete.
+ * RESULT_UNKNOWN          — the outcome of an attempt is not known yet.
+ * NO_USABLE_CARD          — there is no active saved card to charge.
+ */
 export declare enum PaymentRecoveryReason {
     INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
     BANK_SECURITY_CHECK = "BANK_SECURITY_CHECK",

package/build/v1/subscription/schemas/payment-recovery-reason.enum.js

@@ -1,6 +1,15 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-reason.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryReason = void 0;
+/**
+ * Why the collection is not going through. Provider-neutral: never a raw bank text or code.
+ * The first nine values are the PaymentDeclineClass of the last bank decline.
+ *
+ * AUTHENTICATION_REQUIRED — the bank asks for 3-D Secure, which an unattended charge cannot complete.
+ * RESULT_UNKNOWN          — the outcome of an attempt is not known yet.
+ * NO_USABLE_CARD          — there is no active saved card to charge.
+ */
 var PaymentRecoveryReason;
 (function (PaymentRecoveryReason) {
     PaymentRecoveryReason["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";

package/build/v1/subscription/schemas/payment-recovery-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-reason.enum.ts"],"names":[],"mappings":";;;AAUA,IAAY,qBAaX;AAbD,WAAY,qBAAqB;IAC7B,kEAAyC,CAAA;IACzC,oEAA2C,CAAA;IAC3C,sDAA6B,CAAA;IAC7B,sDAA6B,CAAA;IAC7B,sEAA6C,CAAA;IAC7C,8DAAqC,CAAA;IACrC,8DAAqC,CAAA;IACrC,8DAAqC,CAAA;IACrC,wCAAe,CAAA;IACf,4EAAmD,CAAA;IACnD,0DAAiC,CAAA;IACjC,0DAAiC,CAAA;AACrC,CAAC,EAbW,qBAAqB,qCAArB,qBAAqB,QAahC"}
+{"version":3,"file":"payment-recovery-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-reason.enum.ts"],"names":[],"mappings":";AAAA,yEAAyE;;;AAEzE;;;;;;;GAOG;AACH,IAAY,qBAaX;AAbD,WAAY,qBAAqB;IAC7B,kEAAyC,CAAA;IACzC,oEAA2C,CAAA;IAC3C,sDAA6B,CAAA;IAC7B,sDAA6B,CAAA;IAC7B,sEAA6C,CAAA;IAC7C,8DAAqC,CAAA;IACrC,8DAAqC,CAAA;IACrC,8DAAqC,CAAA;IACrC,wCAAe,CAAA;IACf,4EAAmD,CAAA;IACnD,0DAAiC,CAAA;IACjC,0DAAiC,CAAA;AACrC,CAAC,EAbW,qBAAqB,qCAArB,qBAAqB,QAahC"}

package/build/v1/subscription/schemas/payment-recovery-stage.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * How much of the term the collection currently asks for. Release 1 only ever sends FULL.
+ */
 export declare enum PaymentRecoveryStage {
     FULL = "FULL",
     PREVIOUS_PLAN = "PREVIOUS_PLAN",

package/build/v1/subscription/schemas/payment-recovery-stage.enum.js

@@ -1,6 +1,10 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-stage.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryStage = void 0;
+/**
+ * How much of the term the collection currently asks for. Release 1 only ever sends FULL.
+ */
 var PaymentRecoveryStage;
 (function (PaymentRecoveryStage) {
     PaymentRecoveryStage["FULL"] = "FULL";

package/build/v1/subscription/schemas/payment-recovery-stage.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-stage.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-stage.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,qCAAa,CAAA;IACb,uDAA+B,CAAA;IAC/B,+CAAuB,CAAA;IACvB,qDAA6B,CAAA;IAC7B,mDAA2B,CAAA;AAC/B,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B"}
+{"version":3,"file":"payment-recovery-stage.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-stage.enum.ts"],"names":[],"mappings":";AAAA,wEAAwE;;;AAExE;;GAEG;AACH,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,qCAAa,CAAA;IACb,uDAA+B,CAAA;IAC/B,+CAAuB,CAAA;IACvB,qDAA6B,CAAA;IAC7B,mDAA2B,CAAA;AAC/B,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B"}

package/build/v1/subscription/schemas/payment-recovery-state.enum.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Where the collection of one unpaid renewal term stands, as the subscriber should see it.
+ *
+ * SCHEDULED          — nothing is with the bank; an automatic attempt is (or will be) scheduled.
+ * IN_FLIGHT          — an attempt is with the bank right now; wait for its verdict.
+ * AWAITING_RECONCILE — the result of an attempt is unknown (or needs the issuer) and is being
+ *                      clarified; nothing can be paid meanwhile.
+ * ACTION_REQUIRED    — no automatic attempt will happen; the subscriber must pay or choose a plan.
+ * STOPPED            — no automatic attempt will happen (cancelled, deadline) but the access still lasts.
+ *
+ * IN_FLIGHT and AWAITING_RECONCILE are the "checking" states: no payment is offered.
+ */
 export declare enum PaymentRecoveryState {
     SCHEDULED = "SCHEDULED",
     IN_FLIGHT = "IN_FLIGHT",

package/build/v1/subscription/schemas/payment-recovery-state.enum.js

@@ -1,6 +1,19 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/payment-recovery-state.enum.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoveryState = void 0;
+/**
+ * Where the collection of one unpaid renewal term stands, as the subscriber should see it.
+ *
+ * SCHEDULED          — nothing is with the bank; an automatic attempt is (or will be) scheduled.
+ * IN_FLIGHT          — an attempt is with the bank right now; wait for its verdict.
+ * AWAITING_RECONCILE — the result of an attempt is unknown (or needs the issuer) and is being
+ *                      clarified; nothing can be paid meanwhile.
+ * ACTION_REQUIRED    — no automatic attempt will happen; the subscriber must pay or choose a plan.
+ * STOPPED            — no automatic attempt will happen (cancelled, deadline) but the access still lasts.
+ *
+ * IN_FLIGHT and AWAITING_RECONCILE are the "checking" states: no payment is offered.
+ */
 var PaymentRecoveryState;
 (function (PaymentRecoveryState) {
     PaymentRecoveryState["SCHEDULED"] = "SCHEDULED";

package/build/v1/subscription/schemas/payment-recovery-state.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery-state.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-state.enum.ts"],"names":[],"mappings":";;;AAcA,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,+CAAuB,CAAA;IACvB,+CAAuB,CAAA;IACvB,iEAAyC,CAAA;IACzC,2DAAmC,CAAA;IACnC,2CAAmB,CAAA;AACvB,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B"}
+{"version":3,"file":"payment-recovery-state.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery-state.enum.ts"],"names":[],"mappings":";AAAA,wEAAwE;;;AAExE;;;;;;;;;;;GAWG;AACH,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,+CAAuB,CAAA;IACvB,+CAAuB,CAAA;IACvB,iEAAyC,CAAA;IACzC,2DAAmC,CAAA;IACnC,2CAAmB,CAAA;AACvB,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B"}

package/build/v1/subscription/schemas/payment-recovery.schema.d.ts

@@ -32,6 +32,11 @@ export declare const PaymentRecoveryActionSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     disabledReason: z.ZodNullable<z.ZodEnum<typeof PaymentRecoveryDisabledReason>>;
 }, z.core.$strip>;
+/**
+ * Collection of one unpaid renewal term on GET /subscription/me, derived only from the real
+ * billing engine. null on the parent response = nothing to show (exactly when paymentIssue is null,
+ * or when the facts could not be read).
+ */
 export declare const PaymentRecoverySchema: z.ZodObject<{
     collectionId: z.ZodString;
     revision: z.ZodNumber;

package/build/v1/subscription/schemas/payment-recovery.schema.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRecoverySchema = exports.PaymentRecoveryActionSchema = exports.PaymentRecoveryNextAttemptSchema = exports.PaymentRecoveryAttemptSchema = exports.PaymentRecoveryPeriodSchema = void 0;
+// libs/contracts/v1/subscription/schemas/payment-recovery.schema.ts
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const payment_recovery_state_enum_1 = require("./payment-recovery-state.enum");
@@ -10,6 +11,7 @@ const payment_recovery_attempt_state_enum_1 = require("./payment-recovery-attemp
 const payment_recovery_attempt_kind_enum_1 = require("./payment-recovery-attempt-kind.enum");
 const payment_recovery_action_type_enum_1 = require("./payment-recovery-action-type.enum");
 const payment_recovery_disabled_reason_enum_1 = require("./payment-recovery-disabled-reason.enum");
+/** Integer string, ×100 of RUB — the same unit as paymentIssue.amount. */
 const AmountSchema = zod_1.z.string().regex(shared_1.BIGINT_STRING_REGEX);
 const InstantSchema = zod_1.z.string().datetime({ offset: true });
 exports.PaymentRecoveryPeriodSchema = zod_1.z.object({
@@ -17,15 +19,22 @@ exports.PaymentRecoveryPeriodSchema = zod_1.z.object({
         code: zod_1.z.string(),
         termMonths: zod_1.z.number().int().positive(),
     }),
+    /** Price of the unpaid term. */
     price: AmountSchema,
+    /** Already paid towards the term. Always '0' in release 1. */
     paid: AmountSchema,
+    /** What PAY_NOW collects: price - paid. */
     remaining: AmountSchema,
+    /** When access ends: graceEndsAt while PAST_DUE; null once the subscription is EXPIRED. */
     accessUntil: InstantSchema.nullable(),
+    /** true when the renewal quote is for another plan than the subscription's (a scheduled downgrade). */
     changesPlan: zod_1.z.boolean(),
 });
 exports.PaymentRecoveryAttemptSchema = zod_1.z.object({
     state: zod_1.z.nativeEnum(payment_recovery_attempt_state_enum_1.PaymentRecoveryAttemptState),
+    /** Last four digits of the card of the attempt (otherwise of the default card); null when unknown. */
     cardLast4: zod_1.z.string().regex(/^\d{4}$/).nullable(),
+    /** Always false in release 1: an interrupted 3-D Secure challenge cannot be resumed. */
     resumableChallenge: zod_1.z.boolean(),
 });
 exports.PaymentRecoveryNextAttemptSchema = zod_1.z.object({
@@ -36,13 +45,25 @@ exports.PaymentRecoveryNextAttemptSchema = zod_1.z.object({
 exports.PaymentRecoveryActionSchema = zod_1.z.object({
     type: zod_1.z.nativeEnum(payment_recovery_action_type_enum_1.PaymentRecoveryActionType),
     enabled: zod_1.z.boolean(),
+    /** null exactly when enabled. */
     disabledReason: zod_1.z.nativeEnum(payment_recovery_disabled_reason_enum_1.PaymentRecoveryDisabledReason).nullable(),
 });
+/**
+ * Collection of one unpaid renewal term on GET /subscription/me, derived only from the real
+ * billing engine. null on the parent response = nothing to show (exactly when paymentIssue is null,
+ * or when the facts could not be read).
+ */
 exports.PaymentRecoverySchema = zod_1.z.object({
+    /**
+     * Stable per subscription and unpaid term (a name-based UUID v5, hence z.string().uuid() and not the
+     * v4-only UUID_REGEX). Changes only when the term end moves.
+     */
     collectionId: zod_1.z.string().uuid(),
+    /** The subscription's version. For ordering only: equal revisions may still differ in state or attempt. */
     revision: zod_1.z.number().int().nonnegative(),
     state: zod_1.z.nativeEnum(payment_recovery_state_enum_1.PaymentRecoveryState),
     stage: zod_1.z.nativeEnum(payment_recovery_stage_enum_1.PaymentRecoveryStage),
+    /** null: nothing has failed yet, or the cause is unknown. */
     reason: zod_1.z.nativeEnum(payment_recovery_reason_enum_1.PaymentRecoveryReason).nullable(),
     currency: zod_1.z.literal('RUB'),
     period: exports.PaymentRecoveryPeriodSchema,

package/build/v1/subscription/schemas/payment-recovery.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-recovery.schema.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery.schema.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AACxB,4CAAsD;AACtD,+EAAqE;AACrE,+EAAqE;AACrE,iFAAuE;AACvE,+FAAoF;AACpF,6FAAkF;AAClF,2FAAgF;AAChF,mGAAwF;AAGxF,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,4BAAmB,CAAC,CAAC;AAE3D,MAAM,aAAa,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/C,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC;QACX,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC1C,CAAC;IAEF,KAAK,EAAE,YAAY;IAEnB,IAAI,EAAE,YAAY;IAElB,SAAS,EAAE,YAAY;IAEvB,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE;IAErC,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAEU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,iEAA2B,CAAC;IAEhD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IAEjD,kBAAkB,EAAE,OAAC,CAAC,OAAO,EAAE;CAClC,CAAC,CAAC;AAEU,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,EAAE,EAAE,aAAa;IACjB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,OAAC,CAAC,UAAU,CAAC,+DAA0B,CAAC;CACjD,CAAC,CAAC;AAEU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,OAAC,CAAC,UAAU,CAAC,6DAAyB,CAAC;IAC7C,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IAEpB,cAAc,EAAE,OAAC,CAAC,UAAU,CAAC,qEAA6B,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC,CAAC;AAOU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAK1C,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAE/B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,kDAAoB,CAAC;IACzC,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,kDAAoB,CAAC;IAEzC,MAAM,EAAE,OAAC,CAAC,UAAU,CAAC,oDAAqB,CAAC,CAAC,QAAQ,EAAE;IACtD,QAAQ,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1B,MAAM,EAAE,mCAA2B;IACnC,OAAO,EAAE,oCAA4B,CAAC,QAAQ,EAAE;IAChD,WAAW,EAAE,wCAAgC,CAAC,QAAQ,EAAE;IACxD,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,mCAA2B,CAAC;CAChD,CAAC,CAAC"}
+{"version":3,"file":"payment-recovery.schema.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/payment-recovery.schema.ts"],"names":[],"mappings":";;;AAAA,oEAAoE;AACpE,6BAAwB;AACxB,4CAAsD;AACtD,+EAAqE;AACrE,+EAAqE;AACrE,iFAAuE;AACvE,+FAAoF;AACpF,6FAAkF;AAClF,2FAAgF;AAChF,mGAAwF;AAExF,0EAA0E;AAC1E,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,4BAAmB,CAAC,CAAC;AAE3D,MAAM,aAAa,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/C,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC;QACX,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC1C,CAAC;IACF,gCAAgC;IAChC,KAAK,EAAE,YAAY;IACnB,8DAA8D;IAC9D,IAAI,EAAE,YAAY;IAClB,2CAA2C;IAC3C,SAAS,EAAE,YAAY;IACvB,2FAA2F;IAC3F,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE;IACrC,uGAAuG;IACvG,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAEU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,iEAA2B,CAAC;IAChD,sGAAsG;IACtG,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IACjD,wFAAwF;IACxF,kBAAkB,EAAE,OAAC,CAAC,OAAO,EAAE;CAClC,CAAC,CAAC;AAEU,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,EAAE,EAAE,aAAa;IACjB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,OAAC,CAAC,UAAU,CAAC,+DAA0B,CAAC;CACjD,CAAC,CAAC;AAEU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,OAAC,CAAC,UAAU,CAAC,6DAAyB,CAAC;IAC7C,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,iCAAiC;IACjC,cAAc,EAAE,OAAC,CAAC,UAAU,CAAC,qEAA6B,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C;;;OAGG;IACH,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,2GAA2G;IAC3G,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,kDAAoB,CAAC;IACzC,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,kDAAoB,CAAC;IACzC,6DAA6D;IAC7D,MAAM,EAAE,OAAC,CAAC,UAAU,CAAC,oDAAqB,CAAC,CAAC,QAAQ,EAAE;IACtD,QAAQ,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1B,MAAM,EAAE,mCAA2B;IACnC,OAAO,EAAE,oCAA4B,CAAC,QAAQ,EAAE;IAChD,WAAW,EAAE,wCAAgC,CAAC,QAAQ,EAAE;IACxD,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,mCAA2B,CAAC;CAChD,CAAC,CAAC"}

package/build/v1/subscription/schemas/plan-transition-kind.enum.d.ts

@@ -1,3 +1,4 @@
+/** Describes the direction of a subscription plan change. */
 export declare enum PlanTransitionKind {
     NEW = "NEW",
     UPGRADE = "UPGRADE",

package/build/v1/subscription/schemas/plan-transition-kind.enum.js

@@ -1,6 +1,9 @@
 "use strict";
+// libs/contracts/v1/subscription/schemas/plan-transition-kind.enum.ts
+// F74: moved from application query types to contracts as the single source of truth.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlanTransitionKind = void 0;
+/** Describes the direction of a subscription plan change. */
 var PlanTransitionKind;
 (function (PlanTransitionKind) {
     PlanTransitionKind["NEW"] = "NEW";