@aepstore-dev/contracts 1.32.0 → 1.34.0

package/gen/users.ts

@@ -19,6 +19,20 @@ 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 Ok {
+  ok: boolean;
+}
+
 export interface User {
   id: string;
   email: string;
@@ -160,6 +174,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 +199,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 +294,298 @@ 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 interface UpdatePrivacyRequest {
+  userId: string;
+  hideEmail: boolean;
+  hideBalance: boolean;
+  hideOnline: boolean;
+}
+
+export interface UpdateEmailPrefsRequest {
+  userId: string;
+  emailOnSales: boolean;
+  emailOnReviews: boolean;
+  emailOnNews: boolean;
+}
+
+export interface UpdateEmailPrefsResponse {
+  emailOnSales: boolean;
+  emailOnReviews: boolean;
+  emailOnNews: boolean;
+}
+
+export interface UpdateLocaleRequest {
+  userId: string;
+  /** "ru" | "en" | ... */
+  locale: string;
+}
+
+export interface UpdateLocaleResponse {
+  locale: string;
+}
+
+export interface SoftDeleteAccountRequest {
+  userId: string;
+  /** optional, for support/audit */
+  reason: string;
+  /** 0 → use server default (30) */
+  cooldownDays: number;
+}
+
+export interface SoftDeleteAccountResponse {
+  /** ISO 8601 */
+  deletedAt: string;
+  scheduledForHardDelete: string;
+}
+
+export interface RestoreAccountRequest {
+  userId: string;
+}
+
+export interface HardDeletePendingRequest {
+  /** 0 → default 100 */
+  maxBatch: number;
+}
+
+export interface HardDeletePendingResponse {
+  deleted: number;
+}
+
+export interface ChangePasswordRequest {
+  userId: string;
+  currentPassword: string;
+  newPassword: string;
+  /** Optional: revoke all other sessions on success. */
+  revokeOtherSessions: boolean;
+}
+
+export interface BlockUserRequest {
+  blockerId: string;
+  blockedId: string;
+  /** optional */
+  reason: string;
+}
+
+export interface BlockUserResponse {
+  blocked: boolean;
+}
+
+export interface BlockedUserRow {
+  id: string;
+  username: string;
+  avatarUrl: string;
+  blockedAt: string;
+  reason: string;
+}
+
+export interface ListBlockedUsersRequest {
+  blockerId: string;
+  page: number;
+  limit: number;
+}
+
+export interface ListBlockedUsersResponse {
+  items: BlockedUserRow[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface IsBlockedRequest {
+  blockerId: string;
+  blockedId: string;
+}
+
+export interface IsBlockedResponse {
+  isBlocked: boolean;
+}
+
+export interface DataExportRequestRow {
+  id: string;
+  userId: string;
+  /** PENDING | PROCESSING | READY | FAILED */
+  status: string;
+  fileUrl: string;
+  fileSize: number;
+  error: string;
+  createdAt: string;
+  completedAt: string;
+}
+
+export interface RequestDataExportRequest {
+  userId: string;
+}
+
+export interface ListDataExportsRequest {
+  userId: string;
+  page: number;
+  limit: number;
+}
+
+export interface ListDataExportsResponse {
+  items: DataExportRequestRow[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface PickPendingDataExportRequest {
+  /** tasks-service polls; returns one PENDING row marked PROCESSING, or empty. */
+  Placeholder: boolean;
+}
+
+export interface CompleteDataExportRequest {
+  id: string;
+  fileUrl: string;
+  fileSize: number;
+  /** if set, marks FAILED instead of READY */
+  error: string;
+}
+
+export interface CollectUserExportDataRequest {
+  userId: string;
+}
+
+export interface CollectUserExportDataResponse {
+  /**
+   * Opaque JSON-as-string of user-owned data. tasks-service writes it to
+   * S3 verbatim. Keeps the schema-specific marshaling private to users-service.
+   */
+  payloadJson: string;
+}
+
+export interface GetAccountSettingsRequest {
+  userId: string;
+}
+
+export interface AccountSettingsResponse {
+  /** Identity */
+  id: string;
+  username: string;
+  email: string;
+  fullName: string;
+  aboutMe: string;
+  avatarUrl: string;
+  bannerUrl: string;
+  locale: string;
+  timezone: string;
+  countryId: string;
+  createdAt: string;
+  /** 2FA */
+  twoFactorType: string;
+  twoFactorEnabled: boolean;
+  backupCodesRemaining: number;
+  /** Privacy */
+  hideEmail: boolean;
+  hideBalance: boolean;
+  hideOnline: boolean;
+  hideSubscriptions: boolean;
+  /** Email prefs */
+  emailOnSales: boolean;
+  emailOnReviews: boolean;
+  emailOnNews: boolean;
+  /** Payout defaults */
+  payoutMethod: string;
+  payoutDetails: string;
+  /** Premium snapshot */
+  premiumIsActive: boolean;
+  premiumStatus: string;
+  premiumExpiresAt: string;
+  premiumAutoRenew: boolean;
+  /** Soft-delete state */
+  deletedAt: string;
+  scheduledForHardDelete: string;
+  socialMedia: SocialMedia[];
+}
+
 export const USERS_V1_PACKAGE_NAME = "users.v1";
 
 export interface UsersServiceClient {
@@ -286,6 +612,96 @@ 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>;
+
+  /** Account settings — bundled write surface for the UI. */
+
+  updatePrivacy(request: UpdatePrivacyRequest): Observable<PublicProfileResponse>;
+
+  updateEmailPrefs(request: UpdateEmailPrefsRequest): Observable<UpdateEmailPrefsResponse>;
+
+  updateLocale(request: UpdateLocaleRequest): Observable<UpdateLocaleResponse>;
+
+  /**
+   * Soft-delete + restore. Internal AuthService also queries the soft-delete
+   * state on login (rejects if deletedAt set).
+   */
+
+  softDeleteAccount(request: SoftDeleteAccountRequest): Observable<SoftDeleteAccountResponse>;
+
+  restoreAccount(request: RestoreAccountRequest): Observable<UserResponse>;
+
+  /** tasks-service cron */
+
+  hardDeletePending(request: HardDeletePendingRequest): Observable<HardDeletePendingResponse>;
+
+  /** Blocks */
+
+  blockUser(request: BlockUserRequest): Observable<BlockUserResponse>;
+
+  unblockUser(request: BlockUserRequest): Observable<BlockUserResponse>;
+
+  listBlockedUsers(request: ListBlockedUsersRequest): Observable<ListBlockedUsersResponse>;
+
+  /** internal lookup */
+
+  isBlocked(request: IsBlockedRequest): Observable<IsBlockedResponse>;
+
+  /** Data export */
+
+  requestDataExport(request: RequestDataExportRequest): Observable<DataExportRequestRow>;
+
+  listDataExports(request: ListDataExportsRequest): Observable<ListDataExportsResponse>;
+
+  /** tasks-service */
+
+  pickPendingDataExport(request: PickPendingDataExportRequest): Observable<DataExportRequestRow>;
+
+  /** tasks-service */
+
+  completeDataExport(request: CompleteDataExportRequest): Observable<DataExportRequestRow>;
+
+  /** tasks-service */
+
+  collectUserExportData(request: CollectUserExportDataRequest): Observable<CollectUserExportDataResponse>;
+
+  /** Unified read for the settings page */
+
+  getAccountSettings(request: GetAccountSettingsRequest): Observable<AccountSettingsResponse>;
+
+  /** Password — separate from generic createCode/verifyCode reset flow. */
+
+  changePassword(request: ChangePasswordRequest): Observable<Ok>;
 }
 
 export interface UsersServiceController {
@@ -326,6 +742,136 @@ 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;
+
+  /** Account settings — bundled write surface for the UI. */
+
+  updatePrivacy(
+    request: UpdatePrivacyRequest,
+  ): Promise<PublicProfileResponse> | Observable<PublicProfileResponse> | PublicProfileResponse;
+
+  updateEmailPrefs(
+    request: UpdateEmailPrefsRequest,
+  ): Promise<UpdateEmailPrefsResponse> | Observable<UpdateEmailPrefsResponse> | UpdateEmailPrefsResponse;
+
+  updateLocale(
+    request: UpdateLocaleRequest,
+  ): Promise<UpdateLocaleResponse> | Observable<UpdateLocaleResponse> | UpdateLocaleResponse;
+
+  /**
+   * Soft-delete + restore. Internal AuthService also queries the soft-delete
+   * state on login (rejects if deletedAt set).
+   */
+
+  softDeleteAccount(
+    request: SoftDeleteAccountRequest,
+  ): Promise<SoftDeleteAccountResponse> | Observable<SoftDeleteAccountResponse> | SoftDeleteAccountResponse;
+
+  restoreAccount(request: RestoreAccountRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
+
+  /** tasks-service cron */
+
+  hardDeletePending(
+    request: HardDeletePendingRequest,
+  ): Promise<HardDeletePendingResponse> | Observable<HardDeletePendingResponse> | HardDeletePendingResponse;
+
+  /** Blocks */
+
+  blockUser(request: BlockUserRequest): Promise<BlockUserResponse> | Observable<BlockUserResponse> | BlockUserResponse;
+
+  unblockUser(
+    request: BlockUserRequest,
+  ): Promise<BlockUserResponse> | Observable<BlockUserResponse> | BlockUserResponse;
+
+  listBlockedUsers(
+    request: ListBlockedUsersRequest,
+  ): Promise<ListBlockedUsersResponse> | Observable<ListBlockedUsersResponse> | ListBlockedUsersResponse;
+
+  /** internal lookup */
+
+  isBlocked(request: IsBlockedRequest): Promise<IsBlockedResponse> | Observable<IsBlockedResponse> | IsBlockedResponse;
+
+  /** Data export */
+
+  requestDataExport(
+    request: RequestDataExportRequest,
+  ): Promise<DataExportRequestRow> | Observable<DataExportRequestRow> | DataExportRequestRow;
+
+  listDataExports(
+    request: ListDataExportsRequest,
+  ): Promise<ListDataExportsResponse> | Observable<ListDataExportsResponse> | ListDataExportsResponse;
+
+  /** tasks-service */
+
+  pickPendingDataExport(
+    request: PickPendingDataExportRequest,
+  ): Promise<DataExportRequestRow> | Observable<DataExportRequestRow> | DataExportRequestRow;
+
+  /** tasks-service */
+
+  completeDataExport(
+    request: CompleteDataExportRequest,
+  ): Promise<DataExportRequestRow> | Observable<DataExportRequestRow> | DataExportRequestRow;
+
+  /** tasks-service */
+
+  collectUserExportData(
+    request: CollectUserExportDataRequest,
+  ): Promise<CollectUserExportDataResponse> | Observable<CollectUserExportDataResponse> | CollectUserExportDataResponse;
+
+  /** Unified read for the settings page */
+
+  getAccountSettings(
+    request: GetAccountSettingsRequest,
+  ): Promise<AccountSettingsResponse> | Observable<AccountSettingsResponse> | AccountSettingsResponse;
+
+  /** Password — separate from generic createCode/verifyCode reset flow. */
+
+  changePassword(request: ChangePasswordRequest): Promise<Ok> | Observable<Ok> | Ok;
 }
 
 export function UsersServiceControllerMethods() {
@@ -343,6 +889,30 @@ export function UsersServiceControllerMethods() {
       "deleteSubscription",
       "banUser",
       "unbanUser",
+      "getMyPremium",
+      "setPremiumAutoRenew",
+      "activatePremium",
+      "isPremiumActive",
+      "listAvatarBorders",
+      "upsertAvatarBorder",
+      "deleteAvatarBorder",
+      "updatePrivacy",
+      "updateEmailPrefs",
+      "updateLocale",
+      "softDeleteAccount",
+      "restoreAccount",
+      "hardDeletePending",
+      "blockUser",
+      "unblockUser",
+      "listBlockedUsers",
+      "isBlocked",
+      "requestDataExport",
+      "listDataExports",
+      "pickPendingDataExport",
+      "completeDataExport",
+      "collectUserExportData",
+      "getAccountSettings",
+      "changePassword",
     ];
     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.34.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",