@aepstore-dev/contracts 1.32.0 → 1.34.0

package/gen/auth.ts

@@ -119,6 +119,20 @@ export interface TwoFactorStatusResponse {
 export interface Empty {
 }
 
+export interface LogoutCurrentRequest {
+  refreshToken: string;
+}
+
+export interface LogoutAllRequest {
+  userId: string;
+}
+
+export interface LogoutResponse {
+  ok: boolean;
+  /** number of refresh-token rows deleted */
+  removed: number;
+}
+
 export const AUTH_V1_PACKAGE_NAME = "auth.v1";
 
 /**
@@ -148,6 +162,15 @@ export interface AuthServiceClient {
   getProfile(request: GetProfileRequest): Observable<AuthUser>;
 
   cleanupExpiredTotpSetups(request: Empty): Observable<Empty>;
+
+  /**
+   * Logout — kill refresh tokens. LogoutCurrent kills only the one whose
+   * HMAC matches; LogoutAll wipes every row for the user.
+   */
+
+  logoutCurrent(request: LogoutCurrentRequest): Observable<LogoutResponse>;
+
+  logoutAll(request: LogoutAllRequest): Observable<LogoutResponse>;
 }
 
 /**
@@ -179,6 +202,15 @@ export interface AuthServiceController {
   getProfile(request: GetProfileRequest): Promise<AuthUser> | Observable<AuthUser> | AuthUser;
 
   cleanupExpiredTotpSetups(request: Empty): Promise<Empty> | Observable<Empty> | Empty;
+
+  /**
+   * Logout — kill refresh tokens. LogoutCurrent kills only the one whose
+   * HMAC matches; LogoutAll wipes every row for the user.
+   */
+
+  logoutCurrent(request: LogoutCurrentRequest): Promise<LogoutResponse> | Observable<LogoutResponse> | LogoutResponse;
+
+  logoutAll(request: LogoutAllRequest): Promise<LogoutResponse> | Observable<LogoutResponse> | LogoutResponse;
 }
 
 export function AuthServiceControllerMethods() {
@@ -193,6 +225,8 @@ export function AuthServiceControllerMethods() {
       "get2FaStatus",
       "getProfile",
       "cleanupExpiredTotpSetups",
+      "logoutCurrent",
+      "logoutAll",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/payments.ts

@@ -313,6 +313,188 @@ export interface SalesAnalyticsResponse {
   refundRate: string;
 }
 
+/**
+ * ---------------------------------------------------------------------------
+ * Premium
+ * ---------------------------------------------------------------------------
+ */
+export interface GetPremiumPlansRequest {
+}
+
+/**
+ * One plan per (period). Prices are computed server-side from BASE_PRICE × months
+ * × (1 − discount); kept here as canonical strings so the gateway has no math.
+ */
+export interface PremiumPlan {
+  /** MONTH_1 | MONTH_3 | MONTH_6 | MONTH_12 */
+  period: string;
+  months: number;
+  /** total to charge, Decimal-as-string */
+  price: string;
+  /** for UI "≈ X ₽/month" */
+  monthlyPrice: string;
+  discountPercent: string;
+  currency: string;
+}
+
+export interface PremiumPlansResponse {
+  plans: PremiumPlan[];
+  baseMonthlyPrice: string;
+}
+
+export interface PurchasePremiumRequest {
+  userId: string;
+  /** MONTH_1 | MONTH_3 | MONTH_6 | MONTH_12 */
+  period: string;
+  /** BALANCE | YOOKASSA */
+  paymentMethod: string;
+  /** YooKassa only */
+  returnUrl: string;
+  /**
+   * Save the YooKassa payment_method for future auto-renewals. Ignored for
+   * BALANCE. Default true — the UI surfaces a checkbox.
+   */
+  savePaymentMethod: boolean;
+}
+
+export interface PurchasePremiumResponse {
+  /** PremiumPayment.id */
+  paymentId: string;
+  /** empty for BALANCE (instant) or YooKassa-issued */
+  confirmationUrl: string;
+  /** PENDING (redirect) | COMPLETED (balance) */
+  status: string;
+}
+
+export interface RunPremiumRenewalsRequest {
+  /** safety cap; default 100 */
+  maxBatch: number;
+}
+
+export interface RunPremiumRenewalsResponse {
+  attempted: number;
+  succeeded: number;
+  failed: number;
+}
+
+export interface PremiumPaymentRow {
+  id: string;
+  userId: string;
+  amount: string;
+  /** MONTH_1 | MONTH_3 | MONTH_6 | MONTH_12 */
+  period: string;
+  /** BALANCE | YOOKASSA */
+  method: string;
+  /** PENDING | COMPLETED | FAILED | REFUNDED */
+  status: string;
+  isRenewal: boolean;
+  createdAt: string;
+  completedAt: string;
+  refundedAt: string;
+  refundedAmount: string;
+  /**
+   * Convenience: true if this payment is currently inside the 7-day refund
+   * window AND status == COMPLETED AND not already refunded.
+   */
+  refundable: boolean;
+}
+
+export interface RefundPremiumRequest {
+  userId: string;
+  paymentId: string;
+  /** optional */
+  reason: string;
+}
+
+export interface RefundPremiumResponse {
+  payment:
+    | PremiumPaymentRow
+    | undefined;
+  /** ISO 8601 after rollback */
+  newExpiresAt: string;
+  /** true when rollback put expiresAt <= now */
+  subscriptionRevoked: boolean;
+}
+
+export interface GetMyPremiumPaymentsRequest {
+  userId: string;
+  page: number;
+  limit: number;
+}
+
+export interface PremiumPaymentsListResponse {
+  items: PremiumPaymentRow[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+/**
+ * ---------------------------------------------------------------------------
+ * Saved cards (YooKassa payment_method tokens; we never see PAN)
+ * ---------------------------------------------------------------------------
+ */
+export interface SavedCard {
+  id: string;
+  /** "MIR" | "VISA" | "MASTERCARD" | "" */
+  brand: string;
+  /** "0000" etc, display-only */
+  last4: string;
+  expMonth: number;
+  expYear: number;
+  isDefault: boolean;
+  /** user-set label */
+  nickname: string;
+  createdAt: string;
+}
+
+export interface ListSavedCardsRequest {
+  userId: string;
+}
+
+export interface ListSavedCardsResponse {
+  items: SavedCard[];
+}
+
+export interface DeleteSavedCardRequest {
+  userId: string;
+  id: string;
+}
+
+export interface SetDefaultSavedCardRequest {
+  userId: string;
+  id: string;
+}
+
+export interface UpdateSavedCardRequest {
+  userId: string;
+  id: string;
+  /** empty = clear */
+  nickname: string;
+}
+
+/**
+ * ---------------------------------------------------------------------------
+ * Payout details (persistent default; per-withdrawal override still allowed)
+ * ---------------------------------------------------------------------------
+ */
+export interface UpdatePayoutDetailsRequest {
+  userId: string;
+  /** "card" | "sbp" | "bank" | "" (clear) */
+  method: string;
+  /** JSON string — payments-service treats opaquely */
+  details: string;
+}
+
+export interface UpdatePayoutDetailsResponse {
+  method: string;
+  details: string;
+}
+
+export interface GetPayoutDetailsRequest {
+  userId: string;
+}
+
 export const PAYMENTS_V1_PACKAGE_NAME = "payments.v1";
 
 /**
@@ -352,6 +534,44 @@ export interface PaymentsServiceClient {
 
   handlePaymentEvent(request: PaymentEventRequest): Observable<Ok>;
 
+  /** ----- premium ----- */
+
+  getPremiumPlans(request: GetPremiumPlansRequest): Observable<PremiumPlansResponse>;
+
+  purchasePremium(request: PurchasePremiumRequest): Observable<PurchasePremiumResponse>;
+
+  /**
+   * 7-day refund window from completedAt. Reverses ledger, calls YooKassa for
+   * card purchases, rolls back the subscription's expiresAt by the period.
+   */
+
+  refundPremium(request: RefundPremiumRequest): Observable<RefundPremiumResponse>;
+
+  getMyPremiumPayments(request: GetMyPremiumPaymentsRequest): Observable<PremiumPaymentsListResponse>;
+
+  /**
+   * Internal — InternalServiceGuard. tasks-service cron triggers due renewals;
+   * payments-service iterates ACTIVE subscriptions with autoRenew+savedCard.
+   */
+
+  runPremiumRenewals(request: RunPremiumRenewalsRequest): Observable<RunPremiumRenewalsResponse>;
+
+  /** ----- saved cards ----- */
+
+  listSavedCards(request: ListSavedCardsRequest): Observable<ListSavedCardsResponse>;
+
+  deleteSavedCard(request: DeleteSavedCardRequest): Observable<Ok>;
+
+  setDefaultSavedCard(request: SetDefaultSavedCardRequest): Observable<SavedCard>;
+
+  updateSavedCard(request: UpdateSavedCardRequest): Observable<SavedCard>;
+
+  /** ----- payout details ----- */
+
+  updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
+
+  getPayoutDetails(request: GetPayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
+
   /** ----- admin ----- */
 
   getAdminOverview(request: AdminOverviewRequest): Observable<AdminOverviewResponse>;
@@ -410,6 +630,60 @@ export interface PaymentsServiceController {
 
   handlePaymentEvent(request: PaymentEventRequest): Promise<Ok> | Observable<Ok> | Ok;
 
+  /** ----- premium ----- */
+
+  getPremiumPlans(
+    request: GetPremiumPlansRequest,
+  ): Promise<PremiumPlansResponse> | Observable<PremiumPlansResponse> | PremiumPlansResponse;
+
+  purchasePremium(
+    request: PurchasePremiumRequest,
+  ): Promise<PurchasePremiumResponse> | Observable<PurchasePremiumResponse> | PurchasePremiumResponse;
+
+  /**
+   * 7-day refund window from completedAt. Reverses ledger, calls YooKassa for
+   * card purchases, rolls back the subscription's expiresAt by the period.
+   */
+
+  refundPremium(
+    request: RefundPremiumRequest,
+  ): Promise<RefundPremiumResponse> | Observable<RefundPremiumResponse> | RefundPremiumResponse;
+
+  getMyPremiumPayments(
+    request: GetMyPremiumPaymentsRequest,
+  ): Promise<PremiumPaymentsListResponse> | Observable<PremiumPaymentsListResponse> | PremiumPaymentsListResponse;
+
+  /**
+   * Internal — InternalServiceGuard. tasks-service cron triggers due renewals;
+   * payments-service iterates ACTIVE subscriptions with autoRenew+savedCard.
+   */
+
+  runPremiumRenewals(
+    request: RunPremiumRenewalsRequest,
+  ): Promise<RunPremiumRenewalsResponse> | Observable<RunPremiumRenewalsResponse> | RunPremiumRenewalsResponse;
+
+  /** ----- saved cards ----- */
+
+  listSavedCards(
+    request: ListSavedCardsRequest,
+  ): Promise<ListSavedCardsResponse> | Observable<ListSavedCardsResponse> | ListSavedCardsResponse;
+
+  deleteSavedCard(request: DeleteSavedCardRequest): Promise<Ok> | Observable<Ok> | Ok;
+
+  setDefaultSavedCard(request: SetDefaultSavedCardRequest): Promise<SavedCard> | Observable<SavedCard> | SavedCard;
+
+  updateSavedCard(request: UpdateSavedCardRequest): Promise<SavedCard> | Observable<SavedCard> | SavedCard;
+
+  /** ----- payout details ----- */
+
+  updatePayoutDetails(
+    request: UpdatePayoutDetailsRequest,
+  ): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;
+
+  getPayoutDetails(
+    request: GetPayoutDetailsRequest,
+  ): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;
+
   /** ----- admin ----- */
 
   getAdminOverview(
@@ -445,6 +719,17 @@ export function PaymentsServiceControllerMethods() {
       "listWithdrawals",
       "processWithdrawal",
       "handlePaymentEvent",
+      "getPremiumPlans",
+      "purchasePremium",
+      "refundPremium",
+      "getMyPremiumPayments",
+      "runPremiumRenewals",
+      "listSavedCards",
+      "deleteSavedCard",
+      "setDefaultSavedCard",
+      "updateSavedCard",
+      "updatePayoutDetails",
+      "getPayoutDetails",
       "getAdminOverview",
       "adminListTransactions",
       "getUserFinance",