@veruna/api-contracts 20.0.0 → 20.1.0

package/build-esm/v1/payment/schemas/cp-decline-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"cp-decline-codes.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/cp-decline-codes.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS;IACxD,IAAI;IACJ,IAAI;CACP,CAAC,CAAC;AAiBH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IACrD,GAAG,4BAA4B;IAC/B,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACP,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,0CAA0C,GAAG,IAAI,GAAG,CAAS;IACtE,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACP,CAAC,CAAC;AAQH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS;IACxD,GAAG,0CAA0C;IAC7C,GAAG,yBAAyB;CAC/B,CAAC,CAAC;AAgBH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,GAAG,CAAS;IAC9D,IAAI;CACP,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,GAAG,CAAS;IAC5D,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACP,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,GAAG,CAAS;IAC9D,IAAI;IACJ,IAAI;IACJ,IAAI;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,IAAI,GAAG,CAAS;IAChE,IAAI;CACP,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS;IACxD,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACP,CAAC,CAAC"}
+{"version":3,"file":"cp-decline-codes.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/cp-decline-codes.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS;IACxD,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,0DAA0D;CACnE,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IACrD,GAAG,4BAA4B;IAC/B,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,kDAAkD;IACxD,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,cAAc;CACvB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,IAAI,GAAG,CAAS;IACtE,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,0DAA0D;IAChE,IAAI,EAAE,yEAAyE;IAC/E,IAAI,EAAE,0CAA0C;CACnD,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS;IACxD,GAAG,0CAA0C;IAC7C,GAAG,yBAAyB;CAC/B,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,GAAG,CAAS;IAC9D,IAAI,EAAE,qBAAqB;CAC9B,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,GAAG,CAAS;IAC5D,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,qCAAqC;CAC9C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,GAAG,CAAS;IAC9D,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,qBAAqB;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,IAAI,GAAG,CAAS;IAChE,IAAI,EAAE,kBAAkB;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS;IACxD,IAAI,EAAE,kEAAkE;IACxE,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,qCAAqC;IAC3C,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;CAC5B,CAAC,CAAC"}

package/build-esm/v1/payment/schemas/cp-transaction-status.enum.js

@@ -1,3 +1,7 @@
+/**
+ * CloudPayments transaction status strings returned in charge API responses.
+ * Source: https://developers.cloudpayments.ru/#statusy-tranzaktsiy
+ */
 export var CpTransactionStatus;
 (function (CpTransactionStatus) {
     CpTransactionStatus["COMPLETED"] = "Completed";
@@ -5,11 +9,21 @@ export var CpTransactionStatus;
     CpTransactionStatus["AUTHORIZED"] = "Authorized";
     CpTransactionStatus["CANCELLED"] = "Cancelled";
 })(CpTransactionStatus || (CpTransactionStatus = {}));
+/**
+ * Refund reason strings used when recording payment rows.
+ * Centralised here so OrderRepository and test expectations stay in sync.
+ */
 export var CpRefundReason;
 (function (CpRefundReason) {
     CpRefundReason["FULL"] = "Refund";
     CpRefundReason["PARTIAL"] = "Partial refund \u2014 manual review";
+    /** Refund notification arrived before any Pay was recorded for this order. */
     CpRefundReason["EARLY"] = "Refund before payment \u2014 manual review";
+    /**
+     * Refund's declared PaymentTransactionId does not match the transaction that
+     * actually funded (CONFIRMED) this order — a different/extra charge attempt was
+     * refunded. Recorded for audit; must NOT revoke the order.
+     */
     CpRefundReason["MISMATCHED_TRANSACTION"] = "Refund of non-funding transaction \u2014 manual review";
 })(CpRefundReason || (CpRefundReason = {}));
 //# sourceMappingURL=cp-transaction-status.enum.js.map

package/build-esm/v1/payment/schemas/cp-transaction-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"cp-transaction-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/cp-transaction-status.enum.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,8CAAuB,CAAA;IACvB,4CAAqB,CAAA;IACrB,gDAAyB,CAAA;IACzB,8CAAuB,CAAA;AAC3B,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAMD,MAAM,CAAN,IAAY,cAWX;AAXD,WAAY,cAAc;IACtB,iCAAe,CAAA;IACf,iEAA0C,CAAA;IAE1C,sEAA+C,CAAA;IAM/C,mGAA4E,CAAA;AAChF,CAAC,EAXW,cAAc,KAAd,cAAc,QAWzB"}
+{"version":3,"file":"cp-transaction-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/cp-transaction-status.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,8CAAuB,CAAA;IACvB,4CAAqB,CAAA;IACrB,gDAAyB,CAAA;IACzB,8CAAuB,CAAA;AAC3B,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,cAWX;AAXD,WAAY,cAAc;IACtB,iCAAe,CAAA;IACf,iEAA0C,CAAA;IAC1C,8EAA8E;IAC9E,sEAA+C,CAAA;IAC/C;;;;OAIG;IACH,mGAA4E,CAAA;AAChF,CAAC,EAXW,cAAc,KAAd,cAAc,QAWzB"}

package/build-esm/v1/payment/schemas/currency.enum.js

@@ -1,3 +1,7 @@
+/**
+ * Supported payment currencies.
+ * Internal amounts are stored as integer units (×100 of the base currency unit).
+ */
 export var Currency;
 (function (Currency) {
     Currency["RUB"] = "RUB";

package/build-esm/v1/payment/schemas/currency.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"currency.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/currency.enum.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,QAEX;AAFD,WAAY,QAAQ;IAChB,uBAAW,CAAA;AACf,CAAC,EAFW,QAAQ,KAAR,QAAQ,QAEnB"}
+{"version":3,"file":"currency.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/currency.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,QAEX;AAFD,WAAY,QAAQ;IAChB,uBAAW,CAAA;AACf,CAAC,EAFW,QAAQ,KAAR,QAAQ,QAEnB"}

package/build-esm/v1/payment/schemas/decline-kind.enum.js

@@ -1,3 +1,35 @@
+// libs/contracts/v1/payment/schemas/decline-kind.enum.ts
+/**
+ * Provider-neutral classification of a payment decline.
+ *
+ * The payment module maps provider-specific reason codes to this enum
+ * before returning ChargeSavedMethodResult. All upstream consumers
+ * (subscription dunning, checkout) branch on DeclineKind only — they
+ * never see raw provider codes.
+ *
+ * HARD       — permanent failure; dunning MUST stop. The payment module also revokes the
+ *              physical card and its recurring consent (owner decision 2026-10-20, uniformly
+ *              on every path that records a decline), EXCEPT for code 5003 (invalid merchant):
+ *              it stops dunning but never touches the card — see CARD_EFFECT_EXEMPT_REASON_CODES.
+ * INSUFFICIENT_FUNDS — the card has no money for this amount (CP 5051): transient,
+ *              dunning retries per schedule. The ONLY kind the customer is told
+ *              "insufficient funds" about (smart renewal, phase 1).
+ * SOFT       — any other known transient failure (issuer unavailable, limits, generic
+ *              do-not-honour, processing errors); retried per schedule, neutral wording.
+ * UNRECOGNIZED — a definitive decline whose code is missing or not in any known set:
+ *              retried like SOFT, never described as insufficient funds. Not the same as
+ *              ChargeOutcome.UNKNOWN (no definitive answer at all).
+ * CARD_EXPIRED — card past expiry date; dunning stops + the physical card is REVOKED (5033).
+ * CARD_REVOKED — card lost/stolen/blocked; dunning stops + the physical card is REVOKED.
+ * BANK_FRAUD_SUSPECTED — bank flagged this specific charge as suspected fraud (CP 5059;
+ *              owner decision 2026-10-03). Automatic/recurring collection on this
+ *              subscription MUST stop permanently (no provider retry-grid restart, no
+ *              local dunning continuation) — but, unlike HARD/CARD_EXPIRED/CARD_REVOKED,
+ *              the card itself is NOT revoked: it is a probabilistic bank-side signal
+ *              that can be a false positive, and the cardholder may still use it
+ *              elsewhere (one-off charges, other subscriptions). Excluded from
+ *              CARD_STOPPING_DECLINE_KINDS on purpose.
+ */
 export var DeclineKind;
 (function (DeclineKind) {
     DeclineKind["HARD"] = "HARD";

package/build-esm/v1/payment/schemas/decline-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"decline-kind.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/decline-kind.enum.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACnB,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,wDAAyC,CAAA;IACzC,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,4DAA6C,CAAA;AACjD,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB"}
+{"version":3,"file":"decline-kind.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/decline-kind.enum.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACnB,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,wDAAyC,CAAA;IACzC,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,4DAA6C,CAAA;AACjD,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB"}

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

@@ -1,3 +1,12 @@
+/**
+ * Discriminates the type of purchase an Order represents.
+ * Replaces PurchaseKind (which is now deleted with PurchaseIntent fold → Order).
+ *
+ * SUBSCRIPTION_NEW — first subscription purchase for the user.
+ * RENEWAL          — auto-renewal at end of subscription term.
+ * UPGRADE          — mid-term plan change requiring proration surcharge payment.
+ * PACKAGE          — one-time package purchase (no subscription required).
+ */
 export var OrderKind;
 (function (OrderKind) {
     OrderKind["SUBSCRIPTION_NEW"] = "SUBSCRIPTION_NEW";

package/build-esm/v1/payment/schemas/order-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"order-kind.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/order-kind.enum.ts"],"names":[],"mappings":"AASA,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACjB,kDAAqC,CAAA;IACrC,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;AACvB,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}
+{"version":3,"file":"order-kind.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/order-kind.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACjB,kDAAqC,CAAA;IACrC,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;AACvB,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}

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

@@ -1,3 +1,16 @@
+// libs/contracts/v1/payment/schemas/order-outcome.enum.ts
+/**
+ * What became of a purchase order, for the payer who made it (GET /payment/orders/:orderId/outcome).
+ *
+ * CHECKING         — a charge on the order is with the bank; wait.
+ * APPLIED          — paid and the purchase took effect: the one strict proof of success.
+ * REFUNDED         — the refund completed; the purchase did not take effect.
+ * REFUND_PENDING   — the purchase was deliberately not applied and the money is still owed back
+ *                    (a refund has not completed, or only partly); not payable.
+ * DECLINED         — the last charge was declined; the order may still be payable.
+ * AWAITING_PAYMENT — nothing has been charged; the order is open.
+ * CLOSED           — the order expired or failed.
+ */
 export var OrderOutcome;
 (function (OrderOutcome) {
     OrderOutcome["CHECKING"] = "CHECKING";

package/build-esm/v1/payment/schemas/order-outcome.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"order-outcome.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/order-outcome.enum.ts"],"names":[],"mappings":"AAcA,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACpB,qCAAqB,CAAA;IACrB,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,iDAAiC,CAAA;IACjC,qCAAqB,CAAA;IACrB,qDAAqC,CAAA;IACrC,iCAAiB,CAAA;AACrB,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB"}
+{"version":3,"file":"order-outcome.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/order-outcome.enum.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACpB,qCAAqB,CAAA;IACrB,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,iDAAiC,CAAA;IACjC,qCAAqB,CAAA;IACrB,qDAAqC,CAAA;IACrC,iCAAiB,CAAA;AACrB,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB"}

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

@@ -1,3 +1,14 @@
+/**
+ * Lifecycle status of an Order record.
+ *
+ * PENDING  — order created by server; awaiting payment.
+ * PAID     — payment confirmed by provider webhook and applied.
+ * EXPIRED  — order TTL elapsed without payment (set by OrderReaperWorker), closed by the system, or cancelled by the payer.
+ * REFUNDED — the payment that paid the order was refunded in full.
+ *
+ * Terminal states: EXPIRED, REFUNDED. PAID can transition to REFUNDED only.
+ * Idempotency: duplicate pay-webhook on PAID order → {code:0} without side-effects.
+ */
 export var OrderStatus;
 (function (OrderStatus) {
     OrderStatus["PENDING"] = "PENDING";

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

@@ -1 +1 @@
-{"version":3,"file":"order-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/order-status.enum.ts"],"names":[],"mappings":"AAWA,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACnB,kCAAmB,CAAA;IACnB,4BAAa,CAAA;IACb,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}
+{"version":3,"file":"order-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/order-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACnB,kCAAmB,CAAA;IACnB,4BAAa,CAAA;IACb,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/build-esm/v1/payment/schemas/payment-decline-class.enum.js

@@ -1,3 +1,18 @@
+// libs/contracts/v1/payment/schemas/payment-decline-class.enum.ts
+/**
+ * Payer-facing class of a failed charge. Provider-neutral and stable: the frontend picks its copy
+ * from this value and never from a bank's own text.
+ *
+ * INSUFFICIENT_FUNDS   — not enough money (CP 5051).
+ * BANK_SECURITY_CHECK  — the bank suspects fraud on this charge (CP 5059).
+ * CARD_EXPIRED         — the card is past its expiry date.
+ * CARD_BLOCKED         — the card was lost, stolen or blocked.
+ * CARD_RELINK_REQUIRED — the bank forbids charging this card without a fresh setup.
+ * LIMIT_OR_DETAILS     — a limit was reached or the card details do not match.
+ * BANK_UNAVAILABLE     — the issuer or its switch could not process the charge.
+ * DECLINED_BY_BANK     — any other transient bank decline.
+ * OTHER                — the reason is unknown or not recognised.
+ */
 export var PaymentDeclineClass;
 (function (PaymentDeclineClass) {
     PaymentDeclineClass["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";

package/build-esm/v1/payment/schemas/payment-decline-class.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-decline-class.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/payment-decline-class.enum.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAN,IAAY,mBAUX;AAVD,WAAY,mBAAmB;IAC3B,gEAAyC,CAAA;IACzC,kEAA2C,CAAA;IAC3C,oDAA6B,CAAA;IAC7B,oDAA6B,CAAA;IAC7B,oEAA6C,CAAA;IAC7C,4DAAqC,CAAA;IACrC,4DAAqC,CAAA;IACrC,4DAAqC,CAAA;IACrC,sCAAe,CAAA;AACnB,CAAC,EAVW,mBAAmB,KAAnB,mBAAmB,QAU9B"}
+{"version":3,"file":"payment-decline-class.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/payment-decline-class.enum.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,mBAUX;AAVD,WAAY,mBAAmB;IAC3B,gEAAyC,CAAA;IACzC,kEAA2C,CAAA;IAC3C,oDAA6B,CAAA;IAC7B,oDAA6B,CAAA;IAC7B,oEAA6C,CAAA;IAC7C,4DAAqC,CAAA;IACrC,4DAAqC,CAAA;IACrC,4DAAqC,CAAA;IACrC,sCAAe,CAAA;AACnB,CAAC,EAVW,mBAAmB,KAAnB,mBAAmB,QAU9B"}

package/build-esm/v1/payment/schemas/payment-provider.enum.js

@@ -1,3 +1,7 @@
+/**
+ * Payment gateway providers.
+ * Extends as new gateways are added.
+ */
 export var PaymentProvider;
 (function (PaymentProvider) {
     PaymentProvider["CLOUDPAYMENTS"] = "CLOUDPAYMENTS";

package/build-esm/v1/payment/schemas/payment-provider.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-provider.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/payment-provider.enum.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,eAEX;AAFD,WAAY,eAAe;IACvB,kDAA+B,CAAA;AACnC,CAAC,EAFW,eAAe,KAAf,eAAe,QAE1B"}
+{"version":3,"file":"payment-provider.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/payment-provider.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,eAEX;AAFD,WAAY,eAAe;IACvB,kDAA+B,CAAA;AACnC,CAAC,EAFW,eAAe,KAAf,eAAe,QAE1B"}

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

@@ -1,3 +1,16 @@
+/**
+ * Lifecycle status of a Payment record (docs/features/payments-v2.md §2.2).
+ *
+ * INITIATED   — a token charge in progress: the row written before the HTTP call, 3-D Secure at the payer, "the bank is thinking".
+ *               Only a charge by a saved token writes it; a widget payment appears already CONFIRMED or DECLINED.
+ * CONFIRMED   — money captured. Terminal; refunds live in the refunds table and do not change this status.
+ *               An order can have several (a duplicate capture, or the second leg of a cascade).
+ * DECLINED    — rejected by the bank, or proven not to have been sent. A later capture of the same invoice confirms it.
+ * REFUNDED    — display only: the admin order detail shows a succeeded refund as such a row. Nothing writes it to
+ *   payments; refunds live in the refunds table.
+ *
+ * Idempotency: payments.provider_transaction_id is unique.
+ */
 export var PaymentStatus;
 (function (PaymentStatus) {
     PaymentStatus["INITIATED"] = "INITIATED";

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

@@ -1 +1 @@
-{"version":3,"file":"payment-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/payment-status.enum.ts"],"names":[],"mappings":"AAaA,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;AACzB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}
+{"version":3,"file":"payment-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/payment-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;AACzB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}

package/build-esm/v1/payment/schemas/provider-api-outcome.enum.js

@@ -1,3 +1,11 @@
+// libs/contracts/v1/payment/schemas/provider-api-outcome.enum.ts
+/**
+ * Result of a call to a payment provider's recurring-billing API.
+ * OK       — the provider confirmed the call.
+ * REJECTED — the provider definitely refused (business error or a 4xx): nothing was applied.
+ * UNKNOWN  — transport failure or 5xx: it may or may not have been applied; the caller must
+ *            observe the provider state before acting again.
+ */
 export var ProviderApiOutcome;
 (function (ProviderApiOutcome) {
     ProviderApiOutcome["OK"] = "OK";

package/build-esm/v1/payment/schemas/provider-api-outcome.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-api-outcome.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/provider-api-outcome.enum.ts"],"names":[],"mappings":"AASA,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,+BAAS,CAAA;IACT,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;AACvB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}
+{"version":3,"file":"provider-api-outcome.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/provider-api-outcome.enum.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,+BAAS,CAAA;IACT,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;AACvB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}

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

@@ -1,3 +1,11 @@
+/**
+ * Why money is returned.
+ *
+ * ADMIN       — an admin refunded an order.
+ * NOT_APPLIED — a captured payment the purchase was not applied for (a duplicate of a paid order, or an order that cannot be applied).
+ * OVERPAYMENT — the surplus over the order amount.
+ * PROVIDER    — a return made in the provider's cabinet, and every historical return.
+ */
 export var RefundReason;
 (function (RefundReason) {
     RefundReason["ADMIN"] = "ADMIN";

package/build-esm/v1/payment/schemas/refund-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"refund-reason.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/refund-reason.enum.ts"],"names":[],"mappings":"AAQA,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACpB,+BAAe,CAAA;IACf,2CAA2B,CAAA;IAC3B,2CAA2B,CAAA;IAC3B,qCAAqB,CAAA;AACzB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}
+{"version":3,"file":"refund-reason.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/refund-reason.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACpB,+BAAe,CAAA;IACf,2CAA2B,CAAA;IAC3B,2CAA2B,CAAA;IAC3B,qCAAqB,CAAA;AACzB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}

package/build-esm/v1/payment/schemas/refund-status.enum.js

@@ -1,3 +1,10 @@
+/**
+ * Status of a Refund (a return of a captured payment).
+ *
+ * REQUESTED — recorded before the HTTP call to the provider; may be sent, resent in the idempotency window or reconciled.
+ * SUCCEEDED — the provider returned the money (our request, or a return made in the provider's cabinet).
+ * FAILED    — the provider refused, or proved that no return happened; an automatic refund is not retried on its own.
+ */
 export var RefundStatus;
 (function (RefundStatus) {
     RefundStatus["REQUESTED"] = "REQUESTED";

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

@@ -1 +1 @@
-{"version":3,"file":"refund-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/refund-status.enum.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;AACrB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}
+{"version":3,"file":"refund-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/refund-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;AACrB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/build-esm/v1/payment/schemas/saved-method-status.enum.js

@@ -1,3 +1,14 @@
+/**
+ * Status of a SavedPaymentMethod (stored card token for recurrent charges).
+ *
+ * ACTIVE   — the card can be charged.
+ * UNUSABLE — «Карта непригодна»: the bank answered an unconditional decline. The card is not charged, but stays in the
+ *            user's list with `unusableReason` so the user can pay with another card or delete it. A successful payment
+ *            with this card started after it became unusable makes it ACTIVE again.
+ * REVOKED  — the user (or an admin) deleted the card. Not returned to the user.
+ *
+ * One ACTIVE default per user.
+ */
 export var SavedMethodStatus;
 (function (SavedMethodStatus) {
     SavedMethodStatus["ACTIVE"] = "ACTIVE";

package/build-esm/v1/payment/schemas/saved-method-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"saved-method-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/saved-method-status.enum.ts"],"names":[],"mappings":"AAWA,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,sCAAiB,CAAA;IACjB,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;AACvB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B"}
+{"version":3,"file":"saved-method-status.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/saved-method-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,sCAAiB,CAAA;IACjB,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;AACvB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B"}

package/build-esm/v1/payment/schemas/saved-method-unusable-reason.enum.js

@@ -1,3 +1,10 @@
+/**
+ * Why a saved card is UNUSABLE (from the bank's unconditional decline code).
+ *
+ * CARD_EXPIRED      — 5033: the card has expired («истёк срок действия карты»).
+ * CARD_BLOCKED      — 5004, 5007, 5041, 5043: the bank blocked the card — lost, stolen or to be picked up («банк заблокировал карту»).
+ * CHARGES_FORBIDDEN — 5001, 5012, 5017, 5034, 5057: the bank forbids charges from this card («банк запретил списания с этой карты»).
+ */
 export var SavedMethodUnusableReason;
 (function (SavedMethodUnusableReason) {
     SavedMethodUnusableReason["CARD_EXPIRED"] = "CARD_EXPIRED";

package/build-esm/v1/payment/schemas/saved-method-unusable-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"saved-method-unusable-reason.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/saved-method-unusable-reason.enum.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACjC,0DAA6B,CAAA;IAC7B,0DAA6B,CAAA;IAC7B,oEAAuC,CAAA;AAC3C,CAAC,EAJW,yBAAyB,KAAzB,yBAAyB,QAIpC"}
+{"version":3,"file":"saved-method-unusable-reason.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/saved-method-unusable-reason.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACjC,0DAA6B,CAAA;IAC7B,0DAA6B,CAAA;IAC7B,oEAAuC,CAAA;AAC3C,CAAC,EAJW,yBAAyB,KAAzB,yBAAyB,QAIpC"}

package/build-esm/v1/payment/schemas/three-ds-complete.schema.js

@@ -1,6 +1,15 @@
+// libs/contracts/v1/payment/schemas/three-ds-complete.schema.ts
 import { z } from 'zod';
+/**
+ * Item 10 — 3-D Secure TermUrl request body. The issuing bank's ACS page POSTs this as a
+ * standard HTML form (`application/x-www-form-urlencoded`) — field names `MD` and `PaRes`
+ * are fixed by the 3-D Secure spec, not by CloudPayments or us; they must NOT be
+ * camelCased or renamed.
+ */
 export const ThreeDsCompleteRequestSchema = z.object({
+    /** The original chargeToken transactionId, round-tripped through the ACS challenge. */
     MD: z.string().min(1),
+    /** The 3-D Secure authentication response the ACS page produced. */
     PaRes: z.string().min(1),
 });
 //# sourceMappingURL=three-ds-complete.schema.js.map

package/build-esm/v1/payment/schemas/three-ds-complete.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"three-ds-complete.schema.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/three-ds-complete.schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAEjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAErB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC"}
+{"version":3,"file":"three-ds-complete.schema.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/three-ds-complete.schema.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,uFAAuF;IACvF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,oEAAoE;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC"}

package/build-esm/v1/plans/commands/admin-delete-plan.command.js

@@ -6,6 +6,7 @@ export var AdminDeletePlanCommand;
 (function (AdminDeletePlanCommand) {
     AdminDeletePlanCommand.Request = z.object({});
     AdminDeletePlanCommand.Response = AdminDeletePlanResponseSchema;
+    /** URL factory — call with plan id to get the full URL. */
     AdminDeletePlanCommand.URL = REST_API.V1.PLANS.ADMIN.DELETE;
     AdminDeletePlanCommand.METHOD = HttpMethod.DELETE;
 })(AdminDeletePlanCommand || (AdminDeletePlanCommand = {}));

package/build-esm/v1/plans/commands/admin-delete-plan.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-delete-plan.command.js","sourceRoot":"","sources":["../../../../v1/plans/commands/admin-delete-plan.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF,MAAM,KAAW,sBAAsB,CAUtC;AAVD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,+BAAQ,GAAG,6BAA6B,CAAC;IAGzC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,6BAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EAVgB,sBAAsB,KAAtB,sBAAsB,QAUtC"}
+{"version":3,"file":"admin-delete-plan.command.js","sourceRoot":"","sources":["../../../../v1/plans/commands/admin-delete-plan.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF,MAAM,KAAW,sBAAsB,CAUtC;AAVD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,+BAAQ,GAAG,6BAA6B,CAAC;IAEtD,2DAA2D;IAC9C,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,6BAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EAVgB,sBAAsB,KAAtB,sBAAsB,QAUtC"}

package/build-esm/v1/plans/commands/admin-update-plan.command.js

@@ -5,6 +5,7 @@ export var AdminUpdatePlanCommand;
 (function (AdminUpdatePlanCommand) {
     AdminUpdatePlanCommand.Request = AdminUpdatePlanRequestSchema;
     AdminUpdatePlanCommand.Response = PlanSchema;
+    /** URL factory — call with plan id to get the full URL. */
     AdminUpdatePlanCommand.URL = REST_API.V1.PLANS.ADMIN.UPDATE;
     AdminUpdatePlanCommand.METHOD = HttpMethod.PATCH;
 })(AdminUpdatePlanCommand || (AdminUpdatePlanCommand = {}));

package/build-esm/v1/plans/commands/admin-update-plan.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-update-plan.command.js","sourceRoot":"","sources":["../../../../v1/plans/commands/admin-update-plan.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,sBAAsB,CAUtC;AAVD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,4BAA4B,CAAC;IACvC,+BAAQ,GAAG,UAAU,CAAC;IAGtB,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,6BAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAVgB,sBAAsB,KAAtB,sBAAsB,QAUtC"}
+{"version":3,"file":"admin-update-plan.command.js","sourceRoot":"","sources":["../../../../v1/plans/commands/admin-update-plan.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,sBAAsB,CAUtC;AAVD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,4BAA4B,CAAC;IACvC,+BAAQ,GAAG,UAAU,CAAC;IAEnC,2DAA2D;IAC9C,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,6BAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAVgB,sBAAsB,KAAtB,sBAAsB,QAUtC"}

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

@@ -2,6 +2,7 @@ export * from './schemas';
 export * from './plans.errors';
 export * from './commands';
 export * from './queries';
+// Re-export from centralized locations
 export { PLANS_CONTROLLER, PLANS_ADMIN_CONTROLLER } from '../../controllers';
 export { PLANS_ROUTES, PLANS_ADMIN_ROUTES } from '../../routes';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/plans/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/plans/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/build-esm/v1/plans/plans.errors.js

@@ -3,10 +3,21 @@ export var PlanErrorCode;
     PlanErrorCode["PLAN_NOT_FOUND"] = "PLAN_NOT_FOUND";
     PlanErrorCode["PLAN_NOT_AVAILABLE"] = "PLAN_NOT_AVAILABLE";
     PlanErrorCode["INVALID_PLAN_TYPE"] = "INVALID_PLAN_TYPE";
+    /**
+     * Numeric invariant violation: bonusPercent/rolloverPercent out of [0,100]
+     * or maxCharsPerRequest < 1. Distinct from INVALID_PLAN_TYPE which means
+     * the `type` enum field is illegal.
+     */
     PlanErrorCode["INVALID_PLAN_CONFIG"] = "INVALID_PLAN_CONFIG";
     PlanErrorCode["INVALID_PERIOD"] = "INVALID_PERIOD";
     PlanErrorCode["CUSTOM_PRICE_OUT_OF_RANGE"] = "CUSTOM_PRICE_OUT_OF_RANGE";
+    /**
+     * One or more modelIds provided in an admin create/update request do not
+     * correspond to active AI models. The request is rejected — the client must
+     * supply only valid active model UUIDs.
+     */
     PlanErrorCode["INVALID_MODEL_IDS"] = "INVALID_MODEL_IDS";
+    /** One or more supplied tool UUIDs do not exist. Supply only existing tool UUIDs. */
     PlanErrorCode["INVALID_TOOL_IDS"] = "INVALID_TOOL_IDS";
 })(PlanErrorCode || (PlanErrorCode = {}));
 export const PLAN_ERRORS = {

package/build-esm/v1/plans/plans.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans.errors.js","sourceRoot":"","sources":["../../../v1/plans/plans.errors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,aAoBX;AApBD,WAAY,aAAa;IACrB,kDAAiC,CAAA;IACjC,0DAAyC,CAAA;IACzC,wDAAuC,CAAA;IAMvC,4DAA2C,CAAA;IAC3C,kDAAiC,CAAA;IACjC,wEAAuD,CAAA;IAMvD,wDAAuC,CAAA;IAEvC,sDAAqC,CAAA;AACzC,CAAC,EApBW,aAAa,KAAb,aAAa,QAoBxB;AAED,MAAM,CAAC,MAAM,WAAW,GAAyC;IAC7D,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC5B,IAAI,EAAE,aAAa,CAAC,cAAc;QAClC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE;QAC/B,IAAI,EAAE,aAAa,CAAC,iBAAiB;QACrC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE;QACjC,IAAI,EAAE,aAAa,CAAC,mBAAmB;QACvC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC5B,IAAI,EAAE,aAAa,CAAC,cAAc;QAClC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,yBAAyB,CAAC,EAAE;QACvC,IAAI,EAAE,aAAa,CAAC,yBAAyB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE;QAC/B,IAAI,EAAE,aAAa,CAAC,iBAAiB;QACrC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE;QAC9B,IAAI,EAAE,aAAa,CAAC,gBAAgB;QACpC,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"plans.errors.js","sourceRoot":"","sources":["../../../v1/plans/plans.errors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,aAoBX;AApBD,WAAY,aAAa;IACrB,kDAAiC,CAAA;IACjC,0DAAyC,CAAA;IACzC,wDAAuC,CAAA;IACvC;;;;OAIG;IACH,4DAA2C,CAAA;IAC3C,kDAAiC,CAAA;IACjC,wEAAuD,CAAA;IACvD;;;;OAIG;IACH,wDAAuC,CAAA;IACvC,qFAAqF;IACrF,sDAAqC,CAAA;AACzC,CAAC,EApBW,aAAa,KAAb,aAAa,QAoBxB;AAED,MAAM,CAAC,MAAM,WAAW,GAAyC;IAC7D,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC5B,IAAI,EAAE,aAAa,CAAC,cAAc;QAClC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE;QAC/B,IAAI,EAAE,aAAa,CAAC,iBAAiB;QACrC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE;QACjC,IAAI,EAAE,aAAa,CAAC,mBAAmB;QACvC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC5B,IAAI,EAAE,aAAa,CAAC,cAAc;QAClC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,yBAAyB,CAAC,EAAE;QACvC,IAAI,EAAE,aAAa,CAAC,yBAAyB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE;QAC/B,IAAI,EAAE,aAAa,CAAC,iBAAiB;QACrC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE;QAC9B,IAAI,EAAE,aAAa,CAAC,gBAAgB;QACpC,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build-esm/v1/plans/queries/admin-get-plan-by-id.query.js

@@ -2,10 +2,16 @@ import { z } from 'zod';
 import { PlanSchema } from '../schemas';
 import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Contract for the admin GET /v1/admin/plans/:id endpoint.
+ * No request body — the plan ID comes from the path parameter.
+ */
 export var AdminGetPlanByIdQuery;
 (function (AdminGetPlanByIdQuery) {
+    /** Empty request body (plan ID is a path parameter). */
     AdminGetPlanByIdQuery.Request = z.object({});
     AdminGetPlanByIdQuery.Response = PlanSchema;
+    /** URL factory — call with plan id to get the full URL. */
     AdminGetPlanByIdQuery.URL = REST_API.V1.PLANS.ADMIN.GET_BY_ID;
     AdminGetPlanByIdQuery.METHOD = HttpMethod.GET;
 })(AdminGetPlanByIdQuery || (AdminGetPlanByIdQuery = {}));

package/build-esm/v1/plans/queries/admin-get-plan-by-id.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-get-plan-by-id.query.js","sourceRoot":"","sources":["../../../../v1/plans/queries/admin-get-plan-by-id.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAM9D,MAAM,KAAW,qBAAqB,CAWrC;AAXD,WAAiB,qBAAqB;IAErB,6BAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,8BAAQ,GAAG,UAAU,CAAC;IAGtB,yBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;IACxC,4BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAXgB,qBAAqB,KAArB,qBAAqB,QAWrC"}
+{"version":3,"file":"admin-get-plan-by-id.query.js","sourceRoot":"","sources":["../../../../v1/plans/queries/admin-get-plan-by-id.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;GAGG;AACH,MAAM,KAAW,qBAAqB,CAWrC;AAXD,WAAiB,qBAAqB;IAClC,wDAAwD;IAC3C,6BAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,8BAAQ,GAAG,UAAU,CAAC;IAEnC,2DAA2D;IAC9C,yBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;IACxC,4BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAXgB,qBAAqB,KAArB,qBAAqB,QAWrC"}

package/build-esm/v1/plans/queries/admin-list-plans.query.js

@@ -1,6 +1,14 @@
 import { PlanListResponseSchema, AdminListPlansFiltersSchema } from '../schemas';
 import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Admin plan catalog list — `v1/admin/plans` (GET, admin role).
+ * Request: AdminListPlansFiltersSchema — optional filters + sort.
+ * Response: PlanListResponseSchema — reuses the public catalog shape
+ *   (modelTree + toolTree + items). Unlike the public list, the admin list
+ *   is unfiltered by status (defaults to ACTIVE, override via `status`) and
+ *   includes custom plans.
+ */
 export var AdminListPlansQuery;
 (function (AdminListPlansQuery) {
     AdminListPlansQuery.Request = AdminListPlansFiltersSchema;

package/build-esm/v1/plans/queries/admin-list-plans.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-list-plans.query.js","sourceRoot":"","sources":["../../../../v1/plans/queries/admin-list-plans.query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAU9D,MAAM,KAAW,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,2BAA2B,CAAC;IACtC,4BAAQ,GAAG,sBAAsB,CAAC;IAElC,uBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACnC,0BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,mBAAmB,KAAnB,mBAAmB,QASnC"}
+{"version":3,"file":"admin-list-plans.query.js","sourceRoot":"","sources":["../../../../v1/plans/queries/admin-list-plans.query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,KAAW,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,2BAA2B,CAAC;IACtC,4BAAQ,GAAG,sBAAsB,CAAC;IAElC,uBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACnC,0BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,mBAAmB,KAAnB,mBAAmB,QASnC"}

package/build-esm/v1/plans/queries/list-plans.query.js

@@ -2,6 +2,10 @@ import { z } from 'zod';
 import { PlanListResponseSchema, PlanCatalogResponseSchema } from '../schemas';
 import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Public (unauthenticated) plan catalog — `v1/unreg/plans/list`.
+ * Response: PlanListResponseSchema — no subscription context.
+ */
 export var ListPlansQuery;
 (function (ListPlansQuery) {
     ListPlansQuery.Request = z.object({});
@@ -9,6 +13,11 @@ export var ListPlansQuery;
     ListPlansQuery.URL = REST_API.V1.PLANS.UNREG.LIST;
     ListPlansQuery.METHOD = HttpMethod.GET;
 })(ListPlansQuery || (ListPlansQuery = {}));
+/**
+ * Authenticated (reg) plan catalog — `v1/plans/list` (JWT).
+ * Response: PlanCatalogResponseSchema — each item enriched with
+ * currentPlanCode / transition / surcharge from the user's active subscription.
+ */
 export var ListPlansRegQuery;
 (function (ListPlansRegQuery) {
     ListPlansRegQuery.Request = z.object({});

package/build-esm/v1/plans/queries/list-plans.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-plans.query.js","sourceRoot":"","sources":["../../../../v1/plans/queries/list-plans.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAM9D,MAAM,KAAW,cAAc,CAS9B;AATD,WAAiB,cAAc;IACd,sBAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,uBAAQ,GAAG,sBAAsB,CAAC;IAElC,kBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACnC,qBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,cAAc,KAAd,cAAc,QAS9B;AAOD,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,0BAAQ,GAAG,yBAAyB,CAAC;IAErC,qBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,wBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC"}
+{"version":3,"file":"list-plans.query.js","sourceRoot":"","sources":["../../../../v1/plans/queries/list-plans.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;GAGG;AACH,MAAM,KAAW,cAAc,CAS9B;AATD,WAAiB,cAAc;IACd,sBAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,uBAAQ,GAAG,sBAAsB,CAAC;IAElC,kBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACnC,qBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,cAAc,KAAd,cAAc,QAS9B;AAED;;;;GAIG;AACH,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,0BAAQ,GAAG,yBAAyB,CAAC;IAErC,qBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,wBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC"}

package/build-esm/v1/plans/schemas/admin-list-plans-filters.schema.js

@@ -3,6 +3,13 @@ import { PlanStatus } from './plan-status.enum';
 import { PlanType } from './plan-type.enum';
 import { AdminPlanSortField } from './admin-plan-sort.enum';
 import { SortOrder } from '../../shared/sort-order.enum';
+/**
+ * Admin List Plans Filters Schema — query params for the admin plan list.
+ * Error messages: AdminListPlansFilters.{field}.{rule}
+ *
+ * All filters are optional; sortBy/sortOrder default to the existing list
+ * behaviour (displayOrder ascending). `q` matches plan code / badge.
+ */
 export const AdminListPlansFiltersSchema = z.object({
     q: z.string().max(255).optional(),
     status: z.nativeEnum(PlanStatus).optional(),

package/build-esm/v1/plans/schemas/admin-list-plans-filters.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-list-plans-filters.schema.js","sourceRoot":"","sources":["../../../../v1/plans/schemas/admin-list-plans-filters.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AASzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAC3C,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAClE,QAAQ,EAAE;IACf,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;SAChE,QAAQ,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC;IAClF,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;CAC5D,CAAC,CAAC"}
+{"version":3,"file":"admin-list-plans-filters.schema.js","sourceRoot":"","sources":["../../../../v1/plans/schemas/admin-list-plans-filters.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAC3C,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAClE,QAAQ,EAAE;IACf,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;SAChE,QAAQ,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC;IAClF,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;CAC5D,CAAC,CAAC"}

package/build-esm/v1/plans/schemas/admin-plan-sort.enum.js

@@ -1,3 +1,7 @@
+/**
+ * Admin Plan list sort fields and order.
+ * Values map to sortable Plan columns.
+ */
 export var AdminPlanSortField;
 (function (AdminPlanSortField) {
     AdminPlanSortField["DISPLAY_ORDER"] = "displayOrder";

package/build-esm/v1/plans/schemas/admin-plan-sort.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-plan-sort.enum.js","sourceRoot":"","sources":["../../../../v1/plans/schemas/admin-plan-sort.enum.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,oDAA8B,CAAA;IAC9B,mCAAa,CAAA;IACb,oDAA8B,CAAA;IAC9B,8CAAwB,CAAA;AAC5B,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}
+{"version":3,"file":"admin-plan-sort.enum.js","sourceRoot":"","sources":["../../../../v1/plans/schemas/admin-plan-sort.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,oDAA8B,CAAA;IAC9B,mCAAa,CAAA;IACb,oDAA8B,CAAA;IAC9B,8CAAwB,CAAA;AAC5B,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/build-esm/v1/plans/schemas/plan-feature.enum.js

@@ -1,9 +1,33 @@
+/**
+ * Feature flags advertised on a plan. Some are ENFORCED (FILE_ATTACH gates
+ * attachments in message.service; WEB_SEARCH / REASONING gate the matching
+ * plugins in plugin-validator). Others are DISPLAY-ONLY hints for the tariff UI.
+ *
+ * MEMORY is display-only: actual memory access is gated by plan_tools
+ * (requiresPlanGrant on the memory tools), not by this flag. Keep them in sync
+ * in the seed (memory granted on the same SUBSCRIPTION plans that carry this
+ * feature); the flag just lets the FE show "Память" / hide the page without
+ * probing the REST 403.
+ */
 export var PlanFeature;
 (function (PlanFeature) {
     PlanFeature["WEB_SEARCH"] = "WEB_SEARCH";
     PlanFeature["FILE_ATTACH"] = "FILE_ATTACH";
     PlanFeature["REASONING"] = "REASONING";
     PlanFeature["MEMORY"] = "MEMORY";
+    /**
+     * ENFORCED, and only at CREATION.
+     *
+     * Gates `POST v1/assistants` — building your own assistant. Everything
+     * afterwards is deliberately ungated: reading, editing, deleting and
+     * favouriting an assistant the person already made keep working when the
+     * plan lapses, and nothing deletes those rows. They paid to build it; it
+     * stays theirs.
+     *
+     * Per-plan rather than a bare "has an active subscription" check, so a
+     * cheaper paid plan can be sold without this and an expensive one with it.
+     * To mean "any paid plan", simply enable it on every paid plan.
+     */
     PlanFeature["CUSTOM_ASSISTANTS"] = "CUSTOM_ASSISTANTS";
 })(PlanFeature || (PlanFeature = {}));
 //# sourceMappingURL=plan-feature.enum.js.map

package/build-esm/v1/plans/schemas/plan-feature.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-feature.enum.js","sourceRoot":"","sources":["../../../../v1/plans/schemas/plan-feature.enum.ts"],"names":[],"mappings":"AAWA,MAAM,CAAN,IAAY,WAmBX;AAnBD,WAAY,WAAW;IACnB,wCAAyB,CAAA;IACzB,0CAA2B,CAAA;IAC3B,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;IAcjB,sDAAuC,CAAA;AAC3C,CAAC,EAnBW,WAAW,KAAX,WAAW,QAmBtB"}
+{"version":3,"file":"plan-feature.enum.js","sourceRoot":"","sources":["../../../../v1/plans/schemas/plan-feature.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,WAmBX;AAnBD,WAAY,WAAW;IACnB,wCAAyB,CAAA;IACzB,0CAA2B,CAAA;IAC3B,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;IACjB;;;;;;;;;;;;OAYG;IACH,sDAAuC,CAAA;AAC3C,CAAC,EAnBW,WAAW,KAAX,WAAW,QAmBtB"}

package/build-esm/v1/plans/schemas/plan-status.enum.js

@@ -1,3 +1,10 @@
+/**
+ * Lifecycle status of a Plan catalogue entry.
+ *
+ * ACTIVE   — available for purchase.
+ * INACTIVE — hidden from public; admin can still see it.
+ * DELETED  — soft-deleted; FK ON DELETE RESTRICT keeps historical records intact.
+ */
 export var PlanStatus;
 (function (PlanStatus) {
     PlanStatus["ACTIVE"] = "ACTIVE";