@veruna/api-contracts 19.1.0 → 20.1.0

package/build-esm/v1/subscription/commands/unreg-custom-quote.command.js

@@ -1,6 +1,7 @@
 import { CustomQuoteRequestSchema, CustomQuoteResponseSchema } from '../schemas';
 import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/** Public (unauthenticated) twin of CustomQuoteCommand — same payload, unreg URL. */
 export var UnregCustomQuoteCommand;
 (function (UnregCustomQuoteCommand) {
     UnregCustomQuoteCommand.Request = CustomQuoteRequestSchema;

package/build-esm/v1/subscription/commands/unreg-custom-quote.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"unreg-custom-quote.command.js","sourceRoot":"","sources":["../../../../v1/subscription/commands/unreg-custom-quote.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAG9D,MAAM,KAAW,uBAAuB,CASvC;AATD,WAAiB,uBAAuB;IACvB,+BAAO,GAAG,wBAAwB,CAAC;IACnC,gCAAQ,GAAG,yBAAyB,CAAC;IAErC,2BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC;IAClD,8BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,uBAAuB,KAAvB,uBAAuB,QASvC"}
+{"version":3,"file":"unreg-custom-quote.command.js","sourceRoot":"","sources":["../../../../v1/subscription/commands/unreg-custom-quote.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,qFAAqF;AACrF,MAAM,KAAW,uBAAuB,CASvC;AATD,WAAiB,uBAAuB;IACvB,+BAAO,GAAG,wBAAwB,CAAC;IACnC,gCAAQ,GAAG,yBAAyB,CAAC;IAErC,2BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC;IAClD,8BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,uBAAuB,KAAvB,uBAAuB,QASvC"}

package/build-esm/v1/subscription/index.js

@@ -3,6 +3,7 @@ export * from './subscription.errors';
 export * from './commands';
 export * from './queries';
 export * from './admin';
+// Re-export from centralized locations
 export { SUBSCRIPTION_CONTROLLER, SUBSCRIPTION_UNREG_CONTROLLER } from '../../controllers';
 export { SUBSCRIPTION_ROUTES } from '../../routes';
 export { SUBSCRIPTION_ADMIN_CONTROLLER, PACKAGE_ADMIN_CONTROLLER, } from '../../controllers';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/subscription/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACH,6BAA6B,EAC7B,wBAAwB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/subscription/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,uCAAuC;AACvC,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACH,6BAA6B,EAC7B,wBAAwB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,cAAc,CAAC"}

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

@@ -1,18 +1,32 @@
 import { z } from 'zod';
 import { UUID_REGEX, BIGINT_STRING_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Subscription transition types for plan change preview.
+ */
 export var SubscriptionTransition;
 (function (SubscriptionTransition) {
     SubscriptionTransition["UPGRADE"] = "UPGRADE";
     SubscriptionTransition["DOWNGRADE"] = "DOWNGRADE";
     SubscriptionTransition["SAME"] = "SAME";
 })(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.
+ */
 export var GetSubscriptionChangePreviewQuery;
 (function (GetSubscriptionChangePreviewQuery) {
     GetSubscriptionChangePreviewQuery.Request = z.object({
         userId: z
             .string({ error: 'GetSubscriptionChangePreviewQuery.userId.required' })
             .regex(UUID_REGEX, { message: 'GetSubscriptionChangePreviewQuery.userId.invalid' }),
+        /** Target plan IDs to compute preview for. */
         targetPlanIds: z.array(z
             .string({ error: 'GetSubscriptionChangePreviewQuery.targetPlanIds.item.invalid' })
             .regex(UUID_REGEX, {
@@ -20,10 +34,13 @@ export var GetSubscriptionChangePreviewQuery;
         })),
     });
     GetSubscriptionChangePreviewQuery.Response = z.object({
+        /** Current plan code, or null if user has no active subscription. */
         currentPlanCode: z.string().nullable(),
+        /** Per-target preview results. */
         perTarget: z.array(z.object({
             planId: z.string().regex(UUID_REGEX),
             transition: z.nativeEnum(SubscriptionTransition),
+            /** Surcharge as integer string (BigInt, ×100 of RUB). "0" for downgrade/same. */
             surcharge: z.string().regex(BIGINT_STRING_REGEX),
         })),
     });

package/build-esm/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,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;AAK9D,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAC9B,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,uCAAa,CAAA;AACjB,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC;AAYD,MAAM,KAAW,iCAAiC,CAiCjD;AAjCD,WAAiB,iCAAiC;IACjC,yCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;aACtE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;QAEvF,aAAa,EAAE,CAAC,CAAC,KAAK,CAClB,CAAC;aACI,MAAM,CAAC,EAAE,KAAK,EAAE,8DAA8D,EAAE,CAAC;aACjF,KAAK,CAAC,UAAU,EAAE;YACf,OAAO,EAAE,8DAA8D;SAC1E,CAAC,CACT;KACJ,CAAC,CAAC;IAEU,0CAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAE7B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAEtC,SAAS,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;YACpC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAEhD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC;SACnD,CAAC,CACL;KACJ,CAAC,CAAC;IAEU,wCAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjCgB,iCAAiC,KAAjC,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,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;;GAEG;AACH,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAC9B,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,uCAAa,CAAA;AACjB,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC;AAED;;;;;;;;;GASG;AACH,MAAM,KAAW,iCAAiC,CAiCjD;AAjCD,WAAiB,iCAAiC;IACjC,yCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;aACtE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;QACvF,8CAA8C;QAC9C,aAAa,EAAE,CAAC,CAAC,KAAK,CAClB,CAAC;aACI,MAAM,CAAC,EAAE,KAAK,EAAE,8DAA8D,EAAE,CAAC;aACjF,KAAK,CAAC,UAAU,EAAE;YACf,OAAO,EAAE,8DAA8D;SAC1E,CAAC,CACT;KACJ,CAAC,CAAC;IAEU,0CAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,qEAAqE;QACrE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACtC,kCAAkC;QAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;YACpC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAChD,iFAAiF;YACjF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC;SACnD,CAAC,CACL;KACJ,CAAC,CAAC;IAEU,wCAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjCgB,iCAAiC,KAAjC,iCAAiC,QAiCjD"}

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

@@ -1,3 +1,36 @@
+// libs/contracts/v1/subscription/schemas/charge-status.enum.ts
+/**
+ * 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 var ChargeStatus;
 (function (ChargeStatus) {
     ChargeStatus["PENDING_WIDGET"] = "PENDING_WIDGET";

package/build-esm/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,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACpB,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;IACnC,mDAAmC,CAAA;IACnC,2DAA2C,CAAA;IAC3C,uDAAuC,CAAA;AAC3C,CAAC,EANW,YAAY,KAAZ,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,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACpB,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;IACnC,mDAAmC,CAAA;IACnC,2DAA2C,CAAA;IAC3C,uDAAuC,CAAA;AAC3C,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAG5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,2FAA2F;AAC3F,wFAAwF;AACxF,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC"}

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

@@ -1,3 +1,23 @@
+// libs/contracts/v1/subscription/schemas/payment-issue-reason.enum.ts
+/**
+ * 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 var PaymentIssueReason;
 (function (PaymentIssueReason) {
     PaymentIssueReason["INSUFFICIENT_FUNDS"] = "insufficientFunds";

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

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

@@ -1,3 +1,18 @@
+// libs/contracts/v1/subscription/schemas/payment-issue-state.enum.ts
+/**
+ * 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 var PaymentIssueState;
 (function (PaymentIssueState) {
     PaymentIssueState["RETRYING"] = "RETRYING";

package/build-esm/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,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,wDAAmC,CAAA;AACvC,CAAC,EAHW,iBAAiB,KAAjB,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,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,wDAAmC,CAAA;AACvC,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B"}

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

@@ -1,3 +1,7 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-action-type.enum.ts
+/**
+ * PAY_NOW     — pay the remaining amount of the term (POST /subscription/pay-now opens the widget).
+ */
 export var PaymentRecoveryActionType;
 (function (PaymentRecoveryActionType) {
     PaymentRecoveryActionType["PAY_NOW"] = "PAY_NOW";

package/build-esm/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,MAAM,CAAN,IAAY,yBAEX;AAFD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;AACvB,CAAC,EAFW,yBAAyB,KAAzB,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,MAAM,CAAN,IAAY,yBAEX;AAFD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;AACvB,CAAC,EAFW,yBAAyB,KAAzB,yBAAyB,QAEpC"}

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

@@ -1,3 +1,8 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-attempt-kind.enum.ts
+/**
+ * Who makes the next automatic attempt.
+ * AUTO_CHARGE    — our own scheduler charges the saved card.
+ */
 export var PaymentRecoveryAttemptKind;
 (function (PaymentRecoveryAttemptKind) {
     PaymentRecoveryAttemptKind["AUTO_CHARGE"] = "AUTO_CHARGE";

package/build-esm/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,MAAM,CAAN,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IAClC,yDAA2B,CAAA;AAC/B,CAAC,EAFW,0BAA0B,KAA1B,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,MAAM,CAAN,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IAClC,yDAA2B,CAAA;AAC/B,CAAC,EAFW,0BAA0B,KAA1B,0BAA0B,QAErC"}

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

@@ -1,3 +1,5 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-attempt-state.enum.ts
+/** State of the most recent charge attempt of the collection. */
 export var PaymentRecoveryAttemptState;
 (function (PaymentRecoveryAttemptState) {
     PaymentRecoveryAttemptState["IN_FLIGHT"] = "IN_FLIGHT";

package/build-esm/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,MAAM,CAAN,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACnC,sDAAuB,CAAA;IACvB,wEAAyC,CAAA;IACzC,oDAAqB,CAAA;IACrB,sDAAuB,CAAA;AAC3B,CAAC,EALW,2BAA2B,KAA3B,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,MAAM,CAAN,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACnC,sDAAuB,CAAA;IACvB,wEAAyC,CAAA;IACzC,oDAAqB,CAAA;IACrB,sDAAuB,CAAA;AAC3B,CAAC,EALW,2BAA2B,KAA3B,2BAA2B,QAKtC"}

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

@@ -1,3 +1,5 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-disabled-reason.enum.ts
+/** Why a recovery action is not available right now. Never shown raw: map to neutral copy. */
 export var PaymentRecoveryDisabledReason;
 (function (PaymentRecoveryDisabledReason) {
     PaymentRecoveryDisabledReason["ATTEMPT_IN_FLIGHT"] = "ATTEMPT_IN_FLIGHT";

package/build-esm/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,MAAM,CAAN,IAAY,6BAGX;AAHD,WAAY,6BAA6B;IACrC,wEAAuC,CAAA;IACvC,4DAA2B,CAAA;AAC/B,CAAC,EAHW,6BAA6B,KAA7B,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,MAAM,CAAN,IAAY,6BAGX;AAHD,WAAY,6BAA6B;IACrC,wEAAuC,CAAA;IACvC,4DAA2B,CAAA;AAC/B,CAAC,EAHW,6BAA6B,KAA7B,6BAA6B,QAGxC"}

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

@@ -1,3 +1,12 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-reason.enum.ts
+/**
+ * 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 var PaymentRecoveryReason;
 (function (PaymentRecoveryReason) {
     PaymentRecoveryReason["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";

package/build-esm/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,MAAM,CAAN,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,KAArB,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,MAAM,CAAN,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,KAArB,qBAAqB,QAahC"}

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

@@ -1,3 +1,7 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-stage.enum.ts
+/**
+ * How much of the term the collection currently asks for. Release 1 only ever sends FULL.
+ */
 export var PaymentRecoveryStage;
 (function (PaymentRecoveryStage) {
     PaymentRecoveryStage["FULL"] = "FULL";

package/build-esm/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,MAAM,CAAN,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,KAApB,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,MAAM,CAAN,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,KAApB,oBAAoB,QAM/B"}

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

@@ -1,3 +1,16 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery-state.enum.ts
+/**
+ * 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 var PaymentRecoveryState;
 (function (PaymentRecoveryState) {
     PaymentRecoveryState["SCHEDULED"] = "SCHEDULED";

package/build-esm/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,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,+CAAuB,CAAA;IACvB,+CAAuB,CAAA;IACvB,iEAAyC,CAAA;IACzC,2DAAmC,CAAA;IACnC,2CAAmB,CAAA;AACvB,CAAC,EANW,oBAAoB,KAApB,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,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,+CAAuB,CAAA;IACvB,+CAAuB,CAAA;IACvB,iEAAyC,CAAA;IACzC,2DAAmC,CAAA;IACnC,2CAAmB,CAAA;AACvB,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B"}

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

@@ -1,3 +1,4 @@
+// libs/contracts/v1/subscription/schemas/payment-recovery.schema.ts
 import { z } from 'zod';
 import { BIGINT_STRING_REGEX } from '../../../shared';
 import { PaymentRecoveryState } from './payment-recovery-state.enum';
@@ -7,6 +8,7 @@ import { PaymentRecoveryAttemptState } from './payment-recovery-attempt-state.en
 import { PaymentRecoveryAttemptKind } from './payment-recovery-attempt-kind.enum';
 import { PaymentRecoveryActionType } from './payment-recovery-action-type.enum';
 import { PaymentRecoveryDisabledReason } from './payment-recovery-disabled-reason.enum';
+/** Integer string, ×100 of RUB — the same unit as paymentIssue.amount. */
 const AmountSchema = z.string().regex(BIGINT_STRING_REGEX);
 const InstantSchema = z.string().datetime({ offset: true });
 export const PaymentRecoveryPeriodSchema = z.object({
@@ -14,15 +16,22 @@ export const PaymentRecoveryPeriodSchema = z.object({
         code: z.string(),
         termMonths: 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: z.boolean(),
 });
 export const PaymentRecoveryAttemptSchema = z.object({
     state: z.nativeEnum(PaymentRecoveryAttemptState),
+    /** Last four digits of the card of the attempt (otherwise of the default card); null when unknown. */
     cardLast4: z.string().regex(/^\d{4}$/).nullable(),
+    /** Always false in release 1: an interrupted 3-D Secure challenge cannot be resumed. */
     resumableChallenge: z.boolean(),
 });
 export const PaymentRecoveryNextAttemptSchema = z.object({
@@ -33,13 +42,25 @@ export const PaymentRecoveryNextAttemptSchema = z.object({
 export const PaymentRecoveryActionSchema = z.object({
     type: z.nativeEnum(PaymentRecoveryActionType),
     enabled: z.boolean(),
+    /** null exactly when enabled. */
     disabledReason: z.nativeEnum(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).
+ */
 export const PaymentRecoverySchema = 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: z.string().uuid(),
+    /** The subscription's version. For ordering only: equal revisions may still differ in state or attempt. */
     revision: z.number().int().nonnegative(),
     state: z.nativeEnum(PaymentRecoveryState),
     stage: z.nativeEnum(PaymentRecoveryStage),
+    /** null: nothing has failed yet, or the cause is unknown. */
     reason: z.nativeEnum(PaymentRecoveryReason).nullable(),
     currency: z.literal('RUB'),
     period: PaymentRecoveryPeriodSchema,

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

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

@@ -1,3 +1,6 @@
+// libs/contracts/v1/subscription/schemas/plan-transition-kind.enum.ts
+// F74: moved from application query types to contracts as the single source of truth.
+/** Describes the direction of a subscription plan change. */
 export var PlanTransitionKind;
 (function (PlanTransitionKind) {
     PlanTransitionKind["NEW"] = "NEW";

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

@@ -1 +1 @@
-{"version":3,"file":"plan-transition-kind.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/plan-transition-kind.enum.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,iCAAW,CAAA;IACX,yCAAmB,CAAA;IACnB,6CAAuB,CAAA;IACvB,mCAAa,CAAA;AACjB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}
+{"version":3,"file":"plan-transition-kind.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/plan-transition-kind.enum.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,sFAAsF;AAEtF,6DAA6D;AAC7D,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,iCAAW,CAAA;IACX,yCAAmB,CAAA;IACnB,6CAAuB,CAAA;IACvB,mCAAa,CAAA;AACjB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/build-esm/v1/subscription/schemas/purchase-kind.enum.js

@@ -1,3 +1,11 @@
+/**
+ * Discriminates the type of purchase a PurchaseIntent represents.
+ *
+ * SUBSCRIPTION_NEW — first subscription purchase for the user.
+ * RENEWAL          — auto-renewal at end of term.
+ * UPGRADE          — mid-term plan change with proration surcharge.
+ * PACKAGE          — one-time package purchase (no subscription required).
+ */
 export var PurchaseKind;
 (function (PurchaseKind) {
     PurchaseKind["SUBSCRIPTION_NEW"] = "SUBSCRIPTION_NEW";

package/build-esm/v1/subscription/schemas/purchase-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"purchase-kind.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/purchase-kind.enum.ts"],"names":[],"mappings":"AAQA,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACpB,qDAAqC,CAAA;IACrC,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;AACvB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}
+{"version":3,"file":"purchase-kind.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/purchase-kind.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACpB,qDAAqC,CAAA;IACrC,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;AACvB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}

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

@@ -1,3 +1,10 @@
+/**
+ * Lifecycle status of a UserSubscription record (docs/features/payments-v2.md §1.1, §2.4).
+ *
+ * ACTIVE    — paid and in effect; the term-end step of the worker closes or renews it.
+ * PAST_DUE  — the term ended unpaid and is being collected; access lasts until accessEndsAt (paid days or the 24 h grace).
+ * CANCELLED — closed for good (the reason is the stop reason); no access.
+ */
 export var SubscriptionStatus;
 (function (SubscriptionStatus) {
     SubscriptionStatus["ACTIVE"] = "ACTIVE";

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

@@ -1 +1 @@
-{"version":3,"file":"subscription-status.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/subscription-status.enum.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,6CAAuB,CAAA;AAC3B,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}
+{"version":3,"file":"subscription-status.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/subscription-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,6CAAuB,CAAA;AAC3B,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}

package/build-esm/v1/subscription/schemas/subscription-stop-reason.enum.js

@@ -1,9 +1,18 @@
+/**
+ * Why a subscription stopped being collected or was closed (docs/features/payments-v2.md §1.1).
+ * On a PAST_DUE subscription the collection is stopped and the access lives out; on a CANCELLED one it is the reason of the closing.
+ */
 export var SubscriptionStopReason;
 (function (SubscriptionStopReason) {
+    /** The auto-renewal was switched off. */
     SubscriptionStopReason["CANCELLED"] = "CANCELLED";
+    /** The 11-month collection deadline passed. */
     SubscriptionStopReason["DEADLINE"] = "DEADLINE";
+    /** The payment that paid the interval was returned in full. */
     SubscriptionStopReason["REFUNDED"] = "REFUNDED";
+    /** An admin closed it. */
     SubscriptionStopReason["ADMIN"] = "ADMIN";
+    /** A newer subscription of the same user took over. */
     SubscriptionStopReason["SUPERSEDED"] = "SUPERSEDED";
 })(SubscriptionStopReason || (SubscriptionStopReason = {}));
 //# sourceMappingURL=subscription-stop-reason.enum.js.map

package/build-esm/v1/subscription/schemas/subscription-stop-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription-stop-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/subscription-stop-reason.enum.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAE9B,iDAAuB,CAAA;IAEvB,+CAAqB,CAAA;IAErB,+CAAqB,CAAA;IAErB,yCAAe,CAAA;IAEf,mDAAyB,CAAA;AAC7B,CAAC,EAXW,sBAAsB,KAAtB,sBAAsB,QAWjC"}
+{"version":3,"file":"subscription-stop-reason.enum.js","sourceRoot":"","sources":["../../../../v1/subscription/schemas/subscription-stop-reason.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAC9B,yCAAyC;IACzC,iDAAuB,CAAA;IACvB,+CAA+C;IAC/C,+CAAqB,CAAA;IACrB,+DAA+D;IAC/D,+CAAqB,CAAA;IACrB,0BAA0B;IAC1B,yCAAe,CAAA;IACf,uDAAuD;IACvD,mDAAyB,CAAA;AAC7B,CAAC,EAXW,sBAAsB,KAAtB,sBAAsB,QAWjC"}