@aepstore-dev/contracts 1.32.0 → 1.33.0

package/gen/payments.ts

@@ -313,6 +313,122 @@ 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;
+}
+
 export const PAYMENTS_V1_PACKAGE_NAME = "payments.v1";
 
 /**
@@ -352,6 +468,28 @@ 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>;
+
   /** ----- admin ----- */
 
   getAdminOverview(request: AdminOverviewRequest): Observable<AdminOverviewResponse>;
@@ -410,6 +548,38 @@ 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;
+
   /** ----- admin ----- */
 
   getAdminOverview(
@@ -445,6 +615,11 @@ export function PaymentsServiceControllerMethods() {
       "listWithdrawals",
       "processWithdrawal",
       "handlePaymentEvent",
+      "getPremiumPlans",
+      "purchasePremium",
+      "refundPremium",
+      "getMyPremiumPayments",
+      "runPremiumRenewals",
       "getAdminOverview",
       "adminListTransactions",
       "getUserFinance",

package/gen/users.ts

@@ -19,6 +19,16 @@ export enum UserFieldsType {
   UNRECOGNIZED = -1,
 }
 
+/** Periods mirror PremiumPeriod enum in schema.prisma. */
+export enum PremiumPeriod {
+  PREMIUM_PERIOD_UNSPECIFIED = 0,
+  PREMIUM_PERIOD_MONTH_1 = 1,
+  PREMIUM_PERIOD_MONTH_3 = 2,
+  PREMIUM_PERIOD_MONTH_6 = 3,
+  PREMIUM_PERIOD_MONTH_12 = 4,
+  UNRECOGNIZED = -1,
+}
+
 export interface User {
   id: string;
   email: string;
@@ -160,6 +170,18 @@ export interface PublicProfileResponse {
   isOwner: boolean;
   /** viewer is subscribed to this profile (false when anonymous / self) */
   isSubscribed: boolean;
+  /**
+   * Premium fields — populated only when the profile owner has an active
+   * PremiumSubscription. Non-premium viewers and non-premium profiles see
+   * empty strings / false.
+   */
+  isPremium: boolean;
+  profileColor: string;
+  avatarBorder: AvatarBorder | undefined;
+  animatedAvatarUrl: string;
+  animatedBannerUrl: string;
+  /** ISO 8601, empty when not premium */
+  premiumExpiresAt: string;
 }
 
 export interface UpdateProfileRequest {
@@ -173,6 +195,14 @@ export interface UpdateProfileRequest {
   countryId: string;
   timezone: string;
   socialMedia: CreateSocialMedia[];
+  /**
+   * Premium-only fields — rejected with FAILED_PRECONDITION when the caller
+   * has no active premium. Empty string clears the value.
+   */
+  profileColor: string;
+  avatarBorderId: string;
+  animatedAvatarUrl: string;
+  animatedBannerUrl: string;
 }
 
 export interface UpdateUserRequest {
@@ -260,6 +290,94 @@ export interface SubscriptionResponse {
   subscribersCount: number;
 }
 
+export interface GetMyPremiumRequest {
+  userId: string;
+}
+
+export interface PremiumStateResponse {
+  isActive: boolean;
+  /** ACTIVE | EXPIRED | CANCELED | empty (never purchased) */
+  status: string;
+  currentPeriod: PremiumPeriod;
+  /** ISO 8601, empty when never purchased */
+  startedAt: string;
+  /** ISO 8601 */
+  expiresAt: string;
+  autoRenew: boolean;
+  hasSavedPaymentMethod: boolean;
+}
+
+export interface SetPremiumAutoRenewRequest {
+  userId: string;
+  enabled: boolean;
+}
+
+/**
+ * Internal — payments-service hands us the period that was just paid for, plus
+ * the YooKassa payment_method id (empty for balance/non-recurring purchases).
+ */
+export interface ActivatePremiumRequest {
+  userId: string;
+  period: PremiumPeriod;
+  /** empty for BALANCE / one-shot */
+  paymentMethodId: string;
+  /** false = first purchase; true = cron-driven renewal */
+  isRenewal: boolean;
+}
+
+export interface IsPremiumActiveRequest {
+  userId: string;
+}
+
+export interface IsPremiumActiveResponse {
+  isActive: boolean;
+}
+
+export interface AvatarBorder {
+  id: string;
+  code: string;
+  name: string;
+  description: string;
+  imageUrl: string;
+  isAnimated: boolean;
+  source: string;
+  sortOrder: number;
+  isActive: boolean;
+}
+
+export interface ListAvatarBordersRequest {
+  /** admin-only — gateway gates by role */
+  includeInactive: boolean;
+  /** optional filter */
+  source: string;
+}
+
+export interface ListAvatarBordersResponse {
+  items: AvatarBorder[];
+}
+
+export interface UpsertAvatarBorderRequest {
+  /** empty = create */
+  id: string;
+  /** required when creating */
+  code: string;
+  name: string;
+  description: string;
+  imageUrl: string;
+  isAnimated: boolean;
+  source: string;
+  sortOrder: number;
+  isActive: boolean;
+}
+
+export interface DeleteAvatarBorderRequest {
+  id: string;
+}
+
+export interface DeleteAvatarBorderResponse {
+  ok: boolean;
+}
+
 export const USERS_V1_PACKAGE_NAME = "users.v1";
 
 export interface UsersServiceClient {
@@ -286,6 +404,37 @@ export interface UsersServiceClient {
   banUser(request: BanUserRequest): Observable<UserResponse>;
 
   unbanUser(request: UnbanUserRequest): Observable<UserResponse>;
+
+  /**
+   * Premium (paid). State lives in users-service; payments-service handles
+   * money and calls ActivatePremium (internal) on completion.
+   */
+
+  getMyPremium(request: GetMyPremiumRequest): Observable<PremiumStateResponse>;
+
+  setPremiumAutoRenew(request: SetPremiumAutoRenewRequest): Observable<PremiumStateResponse>;
+
+  /**
+   * Internal — InternalServiceGuard. Called by payments-service after a
+   * successful premium payment (balance or YooKassa webhook).
+   */
+
+  activatePremium(request: ActivatePremiumRequest): Observable<PremiumStateResponse>;
+
+  /** Internal — fast lookup for the commission engine in payments-service. */
+
+  isPremiumActive(request: IsPremiumActiveRequest): Observable<IsPremiumActiveResponse>;
+
+  /**
+   * Avatar borders (catalog + admin CRUD). Catalog read is public; mutations
+   * are admin only (gateway enforces with RolesGuard).
+   */
+
+  listAvatarBorders(request: ListAvatarBordersRequest): Observable<ListAvatarBordersResponse>;
+
+  upsertAvatarBorder(request: UpsertAvatarBorderRequest): Observable<AvatarBorder>;
+
+  deleteAvatarBorder(request: DeleteAvatarBorderRequest): Observable<DeleteAvatarBorderResponse>;
 }
 
 export interface UsersServiceController {
@@ -326,6 +475,51 @@ export interface UsersServiceController {
   banUser(request: BanUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
 
   unbanUser(request: UnbanUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
+
+  /**
+   * Premium (paid). State lives in users-service; payments-service handles
+   * money and calls ActivatePremium (internal) on completion.
+   */
+
+  getMyPremium(
+    request: GetMyPremiumRequest,
+  ): Promise<PremiumStateResponse> | Observable<PremiumStateResponse> | PremiumStateResponse;
+
+  setPremiumAutoRenew(
+    request: SetPremiumAutoRenewRequest,
+  ): Promise<PremiumStateResponse> | Observable<PremiumStateResponse> | PremiumStateResponse;
+
+  /**
+   * Internal — InternalServiceGuard. Called by payments-service after a
+   * successful premium payment (balance or YooKassa webhook).
+   */
+
+  activatePremium(
+    request: ActivatePremiumRequest,
+  ): Promise<PremiumStateResponse> | Observable<PremiumStateResponse> | PremiumStateResponse;
+
+  /** Internal — fast lookup for the commission engine in payments-service. */
+
+  isPremiumActive(
+    request: IsPremiumActiveRequest,
+  ): Promise<IsPremiumActiveResponse> | Observable<IsPremiumActiveResponse> | IsPremiumActiveResponse;
+
+  /**
+   * Avatar borders (catalog + admin CRUD). Catalog read is public; mutations
+   * are admin only (gateway enforces with RolesGuard).
+   */
+
+  listAvatarBorders(
+    request: ListAvatarBordersRequest,
+  ): Promise<ListAvatarBordersResponse> | Observable<ListAvatarBordersResponse> | ListAvatarBordersResponse;
+
+  upsertAvatarBorder(
+    request: UpsertAvatarBorderRequest,
+  ): Promise<AvatarBorder> | Observable<AvatarBorder> | AvatarBorder;
+
+  deleteAvatarBorder(
+    request: DeleteAvatarBorderRequest,
+  ): Promise<DeleteAvatarBorderResponse> | Observable<DeleteAvatarBorderResponse> | DeleteAvatarBorderResponse;
 }
 
 export function UsersServiceControllerMethods() {
@@ -343,6 +537,13 @@ export function UsersServiceControllerMethods() {
       "deleteSubscription",
       "banUser",
       "unbanUser",
+      "getMyPremium",
+      "setPremiumAutoRenew",
+      "activatePremium",
+      "isPremiumActive",
+      "listAvatarBorders",
+      "upsertAvatarBorder",
+      "deleteAvatarBorder",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",