@aepstore-dev/contracts 1.66.0 → 1.67.0

package/gen/users.ts

@@ -1,1026 +1,1026 @@
-// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
-// versions:
-//   protoc-gen-ts_proto  v2.10.1
-//   protoc               v7.35.0
-// source: users.proto
-
-/* eslint-disable */
-import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
-import { Observable } from "rxjs";
-
-export const protobufPackage = "users.v1";
-
-export enum UserFieldsType {
-  USER_FIELDS_TYPE_UNSPECIFIED = 0,
-  USER_FIELDS_TYPE_VIDEOS = 1,
-  USER_FIELDS_TYPE_PRODUCTS = 2,
-  USER_FIELDS_TYPE_SUBSCRIPTIONS = 3,
-  USER_FIELDS_TYPE_SUBSCRIBERS = 4,
-  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;
-  username: string;
-  avatarUrl: string;
-  roles: string[];
-  /** ISO 8601 */
-  createdAt: string;
-  updatedAt: string;
-  isBanned: boolean;
-  /** ISO 8601, empty = permanent/none */
-  bannedUntil: string;
-  banReason: string;
-  fullName: string;
-  avatarBorderImageUrl: string;
-}
-
-export interface BanUserRequest {
-  adminId: string;
-  userId: string;
-  reason: string;
-  /** ISO 8601; empty = permanent ban */
-  until: string;
-}
-
-export interface UnbanUserRequest {
-  adminId: string;
-  userId: string;
-}
-
-export interface Country {
-  id: string;
-  code: string;
-  name: string;
-}
-
-export interface SocialMedia {
-  id: string;
-  platform: string;
-  /** full link (built from username on read; empty for discord) */
-  url: string;
-  /** handle for handle-based platforms; empty for website */
-  username: string;
-}
-
-export interface CreateSocialMedia {
-  platform: string;
-  /** only for platform="website" */
-  url: string;
-  /** handle for all other platforms */
-  username: string;
-}
-
-export interface ProductUser {
-  id: string;
-  username: string;
-  avatarUrl: string;
-}
-
-export interface Category {
-  id: string;
-  name: string;
-}
-
-export interface Product {
-  id: string;
-  name: string;
-  description: string;
-  /** Decimal as string (D7) */
-  price: string;
-  createdAt: string;
-  updatedAt: string;
-  /** profile-card preview fields */
-  preview: string;
-  /** Decimal as string */
-  finalPrice: string;
-  /** number as string */
-  averageRating: string;
-  status: string;
-  /**
-   * Author of the product (same person as the profile owner, but echoed per
-   * product so cards can render the author independently).
-   */
-  user: ProductUser | undefined;
-  categories: Category[];
-}
-
-export interface Video {
-  id: string;
-  title: string;
-  description: string;
-  url: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface ActiveDevice {
-  id: string;
-  userAgent: string;
-  ip: string;
-  createdAt: string;
-  lastUsedAt: string;
-}
-
-export interface ProfileStats {
-  subscribersCount: number;
-  subscriptionsCount: number;
-  productsCount: number;
-  videosCount: number;
-}
-
-/** Compact public user card for subscriber/subscription lists — no email/ban data. */
-export interface ProfileUser {
-  id: string;
-  username: string;
-  avatarUrl: string;
-  fullName: string;
-  avatarBorderImageUrl: string;
-}
-
-export interface GetPublicProfileRequest {
-  username: string;
-  /** optional — present when caller is authenticated */
-  viewerUserId: string;
-}
-
-export interface PublicProfileResponse {
-  id: string;
-  username: string;
-  fullName: string;
-  /** Decimal as string */
-  rating: string;
-  aboutMe: string;
-  socialMedia: SocialMedia[];
-  stats: ProfileStats | undefined;
-  videos: Video[];
-  products: Product[];
-  country: Country | undefined;
-  avatarUrl: string;
-  bannerUrl: string;
-  role: string;
-  createdAt: string;
-  hideSubscriptions: boolean;
-  /** Either populated lists or empty depending on hide_subscriptions */
-  subscriptions: ProfileUser[];
-  subscribers: ProfileUser[];
-  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 {
-  userId: string;
-  /**
-   * Every editable field is `optional` so the wire format preserves the
-   * "not set" state. A partial patch from the client (e.g. only avatarUrl)
-   * no longer accidentally wipes the other columns to proto3 defaults.
-   */
-  fullName?: string | undefined;
-  aboutMe?: string | undefined;
-  newsletterSubscription?: boolean | undefined;
-  hideSubscriptions?: boolean | undefined;
-  avatarUrl?: string | undefined;
-  bannerUrl?: string | undefined;
-  countryId?: string | undefined;
-  timezone?:
-    | string
-    | undefined;
-  /**
-   * social_media remains repeated (an empty list is still a meaningful
-   * "replace with empty"); the gateway omits the field entirely when the
-   * client didn't send it so partial patches don't clear social links.
-   */
-  socialMedia: CreateSocialMedia[];
-  /**
-   * Premium-only fields — rejected with FAILED_PRECONDITION when the caller
-   * has no active premium. `''` = no change, `__clear__` = explicit reset.
-   */
-  profileColor?: string | undefined;
-  avatarBorderId?: string | undefined;
-  animatedAvatarUrl?: string | undefined;
-  animatedBannerUrl?: string | undefined;
-}
-
-export interface UpdateUserRequest {
-  userId: string;
-  username: string;
-  email: string;
-  /** confirmation code when changing email/username */
-  code: string;
-}
-
-export interface UserResponse {
-  user: User | undefined;
-}
-
-/**
- * Lightweight uniqueness probe for signup / account-settings forms. Called
- * often (per keystroke/blur) — backed by a single indexed query, no writes.
- * Mirrors the exact-match uniqueness check in UpdateUser so availability never
- * disagrees with the real collision at submit time.
- */
-export interface CheckAvailabilityRequest {
-  /** empty = skip this field */
-  username: string;
-  /** empty = skip this field */
-  email: string;
-  /** empty = none; set to current user so editing */
-  excludeUserId: string;
-}
-
-export interface CheckAvailabilityResponse {
-  /** false = username wasn't part of the query */
-  usernameChecked: boolean;
-  usernameAvailable: boolean;
-  /** false = email wasn't part of the query */
-  emailChecked: boolean;
-  emailAvailable: boolean;
-}
-
-export interface UpdateUserRoleRequest {
-  adminId: string;
-  userId: string;
-  role: string;
-  /** "grant" (default) | "revoke" */
-  action: string;
-}
-
-export interface GetUsersRequest {
-  page: string;
-  limit: string;
-  search: string;
-  roleName: string;
-}
-
-export interface GetUsersResponse {
-  items: User[];
-  total: number;
-  page: number;
-  limit: number;
-}
-
-export interface GetActiveDevicesRequest {
-  userId: string;
-}
-
-export interface GetActiveDevicesResponse {
-  devices: ActiveDevice[];
-}
-
-export interface ManageDevicesRequest {
-  userId: string;
-  deviceIdsToRemove: string[];
-}
-
-export interface ManageDevicesResponse {
-  ok: boolean;
-  removedCount: number;
-}
-
-export interface GetUserFieldsRequest {
-  username: string;
-  type: UserFieldsType;
-  page: number;
-  limit: number;
-  /** optional */
-  viewerUserId: string;
-}
-
-export interface GetUserFieldsResponse {
-  videos: Video[];
-  products: Product[];
-  subscriptions: ProfileUser[];
-  subscribers: ProfileUser[];
-  total: number;
-  page: number;
-  limit: number;
-}
-
-export interface SubscriptionRequest {
-  /** the authenticated user performing the action */
-  subscriberId: string;
-  /** the user being (un)subscribed to/from */
-  targetId: string;
-}
-
-export interface SubscriptionResponse {
-  /** state after the call */
-  subscribed: boolean;
-  /** target's subscriber count after the call */
-  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;
-  /** null when not active */
-  plan:
-    | PremiumPlanInfo
-    | undefined;
-  /** null when no premium payment method preference */
-  savedPaymentMethod: PremiumSavedPaymentMethod | undefined;
-}
-
-export interface PremiumSavedPaymentMethod {
-  /** BALANCE | YOOKASSA | SAVED_CARD */
-  method: string;
-  /** null unless method=SAVED_CARD */
-  card: PremiumSavedPaymentCard | undefined;
-}
-
-export interface PremiumSavedPaymentCard {
-  id: string;
-  brand: string;
-  last4: string;
-  expMonth: number;
-  expYear: number;
-  isDefault: boolean;
-  nickname: string;
-  createdAt: string;
-}
-
-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;
-  /** set by the purchase flow; renewals keep true */
-  autoRenew: 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;
-}
-
-/**
- * Current premium plan the user holds. Mirrors a PremiumPlan catalog entry.
- * Absent (null) when the user has no active subscription.
- */
-export interface PremiumPlanInfo {
-  /** MONTH_1 | MONTH_3 | MONTH_6 | MONTH_12 */
-  period: string;
-  months: number;
-  /** total for the period, Decimal-as-string */
-  price: string;
-  /** ≈ X ₽/month */
-  monthlyPrice: string;
-  discountPercent: string;
-  currency: 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;
-  premiumIsActive: boolean;
-  /** Soft-delete state */
-  deletedAt: string;
-  scheduledForHardDelete: string;
-  socialMedia: SocialMedia[];
-  /**
-   * Premium customization snapshot — denormalised border image URL so the
-   * client can render the current overlay without a second roundtrip.
-   */
-  avatarBorderId: string;
-  avatarBorderImageUrl: string;
-  animatedAvatarUrl: string;
-  animatedBannerUrl: string;
-  profileColor: string;
-}
-
-export const USERS_V1_PACKAGE_NAME = "users.v1";
-
-export interface UsersServiceClient {
-  getPublicProfile(request: GetPublicProfileRequest): Observable<PublicProfileResponse>;
-
-  updateProfile(request: UpdateProfileRequest): Observable<PublicProfileResponse>;
-
-  updateUser(request: UpdateUserRequest): Observable<UserResponse>;
-
-  checkAvailability(request: CheckAvailabilityRequest): Observable<CheckAvailabilityResponse>;
-
-  updateUserRole(request: UpdateUserRoleRequest): Observable<UserResponse>;
-
-  getUsers(request: GetUsersRequest): Observable<GetUsersResponse>;
-
-  getActiveDevices(request: GetActiveDevicesRequest): Observable<GetActiveDevicesResponse>;
-
-  manageDevices(request: ManageDevicesRequest): Observable<ManageDevicesResponse>;
-
-  getUserFields(request: GetUserFieldsRequest): Observable<GetUserFieldsResponse>;
-
-  createSubscription(request: SubscriptionRequest): Observable<SubscriptionResponse>;
-
-  deleteSubscription(request: SubscriptionRequest): Observable<SubscriptionResponse>;
-
-  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 {
-  getPublicProfile(
-    request: GetPublicProfileRequest,
-  ): Promise<PublicProfileResponse> | Observable<PublicProfileResponse> | PublicProfileResponse;
-
-  updateProfile(
-    request: UpdateProfileRequest,
-  ): Promise<PublicProfileResponse> | Observable<PublicProfileResponse> | PublicProfileResponse;
-
-  updateUser(request: UpdateUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
-
-  checkAvailability(
-    request: CheckAvailabilityRequest,
-  ): Promise<CheckAvailabilityResponse> | Observable<CheckAvailabilityResponse> | CheckAvailabilityResponse;
-
-  updateUserRole(request: UpdateUserRoleRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
-
-  getUsers(request: GetUsersRequest): Promise<GetUsersResponse> | Observable<GetUsersResponse> | GetUsersResponse;
-
-  getActiveDevices(
-    request: GetActiveDevicesRequest,
-  ): Promise<GetActiveDevicesResponse> | Observable<GetActiveDevicesResponse> | GetActiveDevicesResponse;
-
-  manageDevices(
-    request: ManageDevicesRequest,
-  ): Promise<ManageDevicesResponse> | Observable<ManageDevicesResponse> | ManageDevicesResponse;
-
-  getUserFields(
-    request: GetUserFieldsRequest,
-  ): Promise<GetUserFieldsResponse> | Observable<GetUserFieldsResponse> | GetUserFieldsResponse;
-
-  createSubscription(
-    request: SubscriptionRequest,
-  ): Promise<SubscriptionResponse> | Observable<SubscriptionResponse> | SubscriptionResponse;
-
-  deleteSubscription(
-    request: SubscriptionRequest,
-  ): Promise<SubscriptionResponse> | Observable<SubscriptionResponse> | SubscriptionResponse;
-
-  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() {
-  return function (constructor: Function) {
-    const grpcMethods: string[] = [
-      "getPublicProfile",
-      "updateProfile",
-      "updateUser",
-      "checkAvailability",
-      "updateUserRole",
-      "getUsers",
-      "getActiveDevices",
-      "manageDevices",
-      "getUserFields",
-      "createSubscription",
-      "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);
-      GrpcMethod("UsersService", method)(constructor.prototype[method], method, descriptor);
-    }
-    const grpcStreamMethods: string[] = [];
-    for (const method of grpcStreamMethods) {
-      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
-      GrpcStreamMethod("UsersService", method)(constructor.prototype[method], method, descriptor);
-    }
-  };
-}
-
-export const USERS_SERVICE_NAME = "UsersService";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.10.1
+//   protoc               v7.35.1
+// source: users.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "users.v1";
+
+export enum UserFieldsType {
+  USER_FIELDS_TYPE_UNSPECIFIED = 0,
+  USER_FIELDS_TYPE_VIDEOS = 1,
+  USER_FIELDS_TYPE_PRODUCTS = 2,
+  USER_FIELDS_TYPE_SUBSCRIPTIONS = 3,
+  USER_FIELDS_TYPE_SUBSCRIBERS = 4,
+  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;
+  username: string;
+  avatarUrl: string;
+  roles: string[];
+  /** ISO 8601 */
+  createdAt: string;
+  updatedAt: string;
+  isBanned: boolean;
+  /** ISO 8601, empty = permanent/none */
+  bannedUntil: string;
+  banReason: string;
+  fullName: string;
+  avatarBorderImageUrl: string;
+}
+
+export interface BanUserRequest {
+  adminId: string;
+  userId: string;
+  reason: string;
+  /** ISO 8601; empty = permanent ban */
+  until: string;
+}
+
+export interface UnbanUserRequest {
+  adminId: string;
+  userId: string;
+}
+
+export interface Country {
+  id: string;
+  code: string;
+  name: string;
+}
+
+export interface SocialMedia {
+  id: string;
+  platform: string;
+  /** full link (built from username on read; empty for discord) */
+  url: string;
+  /** handle for handle-based platforms; empty for website */
+  username: string;
+}
+
+export interface CreateSocialMedia {
+  platform: string;
+  /** only for platform="website" */
+  url: string;
+  /** handle for all other platforms */
+  username: string;
+}
+
+export interface ProductUser {
+  id: string;
+  username: string;
+  avatarUrl: string;
+}
+
+export interface Category {
+  id: string;
+  name: string;
+}
+
+export interface Product {
+  id: string;
+  name: string;
+  description: string;
+  /** Decimal as string (D7) */
+  price: string;
+  createdAt: string;
+  updatedAt: string;
+  /** profile-card preview fields */
+  preview: string;
+  /** Decimal as string */
+  finalPrice: string;
+  /** number as string */
+  averageRating: string;
+  status: string;
+  /**
+   * Author of the product (same person as the profile owner, but echoed per
+   * product so cards can render the author independently).
+   */
+  user: ProductUser | undefined;
+  categories: Category[];
+}
+
+export interface Video {
+  id: string;
+  title: string;
+  description: string;
+  url: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ActiveDevice {
+  id: string;
+  userAgent: string;
+  ip: string;
+  createdAt: string;
+  lastUsedAt: string;
+}
+
+export interface ProfileStats {
+  subscribersCount: number;
+  subscriptionsCount: number;
+  productsCount: number;
+  videosCount: number;
+}
+
+/** Compact public user card for subscriber/subscription lists — no email/ban data. */
+export interface ProfileUser {
+  id: string;
+  username: string;
+  avatarUrl: string;
+  fullName: string;
+  avatarBorderImageUrl: string;
+}
+
+export interface GetPublicProfileRequest {
+  username: string;
+  /** optional — present when caller is authenticated */
+  viewerUserId: string;
+}
+
+export interface PublicProfileResponse {
+  id: string;
+  username: string;
+  fullName: string;
+  /** Decimal as string */
+  rating: string;
+  aboutMe: string;
+  socialMedia: SocialMedia[];
+  stats: ProfileStats | undefined;
+  videos: Video[];
+  products: Product[];
+  country: Country | undefined;
+  avatarUrl: string;
+  bannerUrl: string;
+  role: string;
+  createdAt: string;
+  hideSubscriptions: boolean;
+  /** Either populated lists or empty depending on hide_subscriptions */
+  subscriptions: ProfileUser[];
+  subscribers: ProfileUser[];
+  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 {
+  userId: string;
+  /**
+   * Every editable field is `optional` so the wire format preserves the
+   * "not set" state. A partial patch from the client (e.g. only avatarUrl)
+   * no longer accidentally wipes the other columns to proto3 defaults.
+   */
+  fullName?: string | undefined;
+  aboutMe?: string | undefined;
+  newsletterSubscription?: boolean | undefined;
+  hideSubscriptions?: boolean | undefined;
+  avatarUrl?: string | undefined;
+  bannerUrl?: string | undefined;
+  countryId?: string | undefined;
+  timezone?:
+    | string
+    | undefined;
+  /**
+   * social_media remains repeated (an empty list is still a meaningful
+   * "replace with empty"); the gateway omits the field entirely when the
+   * client didn't send it so partial patches don't clear social links.
+   */
+  socialMedia: CreateSocialMedia[];
+  /**
+   * Premium-only fields — rejected with FAILED_PRECONDITION when the caller
+   * has no active premium. `''` = no change, `__clear__` = explicit reset.
+   */
+  profileColor?: string | undefined;
+  avatarBorderId?: string | undefined;
+  animatedAvatarUrl?: string | undefined;
+  animatedBannerUrl?: string | undefined;
+}
+
+export interface UpdateUserRequest {
+  userId: string;
+  username: string;
+  email: string;
+  /** confirmation code when changing email/username */
+  code: string;
+}
+
+export interface UserResponse {
+  user: User | undefined;
+}
+
+/**
+ * Lightweight uniqueness probe for signup / account-settings forms. Called
+ * often (per keystroke/blur) — backed by a single indexed query, no writes.
+ * Mirrors the exact-match uniqueness check in UpdateUser so availability never
+ * disagrees with the real collision at submit time.
+ */
+export interface CheckAvailabilityRequest {
+  /** empty = skip this field */
+  username: string;
+  /** empty = skip this field */
+  email: string;
+  /** empty = none; set to current user so editing */
+  excludeUserId: string;
+}
+
+export interface CheckAvailabilityResponse {
+  /** false = username wasn't part of the query */
+  usernameChecked: boolean;
+  usernameAvailable: boolean;
+  /** false = email wasn't part of the query */
+  emailChecked: boolean;
+  emailAvailable: boolean;
+}
+
+export interface UpdateUserRoleRequest {
+  adminId: string;
+  userId: string;
+  role: string;
+  /** "grant" (default) | "revoke" */
+  action: string;
+}
+
+export interface GetUsersRequest {
+  page: string;
+  limit: string;
+  search: string;
+  roleName: string;
+}
+
+export interface GetUsersResponse {
+  items: User[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface GetActiveDevicesRequest {
+  userId: string;
+}
+
+export interface GetActiveDevicesResponse {
+  devices: ActiveDevice[];
+}
+
+export interface ManageDevicesRequest {
+  userId: string;
+  deviceIdsToRemove: string[];
+}
+
+export interface ManageDevicesResponse {
+  ok: boolean;
+  removedCount: number;
+}
+
+export interface GetUserFieldsRequest {
+  username: string;
+  type: UserFieldsType;
+  page: number;
+  limit: number;
+  /** optional */
+  viewerUserId: string;
+}
+
+export interface GetUserFieldsResponse {
+  videos: Video[];
+  products: Product[];
+  subscriptions: ProfileUser[];
+  subscribers: ProfileUser[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface SubscriptionRequest {
+  /** the authenticated user performing the action */
+  subscriberId: string;
+  /** the user being (un)subscribed to/from */
+  targetId: string;
+}
+
+export interface SubscriptionResponse {
+  /** state after the call */
+  subscribed: boolean;
+  /** target's subscriber count after the call */
+  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;
+  /** null when not active */
+  plan:
+    | PremiumPlanInfo
+    | undefined;
+  /** null when no premium payment method preference */
+  savedPaymentMethod: PremiumSavedPaymentMethod | undefined;
+}
+
+export interface PremiumSavedPaymentMethod {
+  /** BALANCE | YOOKASSA | SAVED_CARD */
+  method: string;
+  /** null unless method=SAVED_CARD */
+  card: PremiumSavedPaymentCard | undefined;
+}
+
+export interface PremiumSavedPaymentCard {
+  id: string;
+  brand: string;
+  last4: string;
+  expMonth: number;
+  expYear: number;
+  isDefault: boolean;
+  nickname: string;
+  createdAt: string;
+}
+
+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;
+  /** set by the purchase flow; renewals keep true */
+  autoRenew: 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;
+}
+
+/**
+ * Current premium plan the user holds. Mirrors a PremiumPlan catalog entry.
+ * Absent (null) when the user has no active subscription.
+ */
+export interface PremiumPlanInfo {
+  /** MONTH_1 | MONTH_3 | MONTH_6 | MONTH_12 */
+  period: string;
+  months: number;
+  /** total for the period, Decimal-as-string */
+  price: string;
+  /** ≈ X ₽/month */
+  monthlyPrice: string;
+  discountPercent: string;
+  currency: 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;
+  premiumIsActive: boolean;
+  /** Soft-delete state */
+  deletedAt: string;
+  scheduledForHardDelete: string;
+  socialMedia: SocialMedia[];
+  /**
+   * Premium customization snapshot — denormalised border image URL so the
+   * client can render the current overlay without a second roundtrip.
+   */
+  avatarBorderId: string;
+  avatarBorderImageUrl: string;
+  animatedAvatarUrl: string;
+  animatedBannerUrl: string;
+  profileColor: string;
+}
+
+export const USERS_V1_PACKAGE_NAME = "users.v1";
+
+export interface UsersServiceClient {
+  getPublicProfile(request: GetPublicProfileRequest): Observable<PublicProfileResponse>;
+
+  updateProfile(request: UpdateProfileRequest): Observable<PublicProfileResponse>;
+
+  updateUser(request: UpdateUserRequest): Observable<UserResponse>;
+
+  checkAvailability(request: CheckAvailabilityRequest): Observable<CheckAvailabilityResponse>;
+
+  updateUserRole(request: UpdateUserRoleRequest): Observable<UserResponse>;
+
+  getUsers(request: GetUsersRequest): Observable<GetUsersResponse>;
+
+  getActiveDevices(request: GetActiveDevicesRequest): Observable<GetActiveDevicesResponse>;
+
+  manageDevices(request: ManageDevicesRequest): Observable<ManageDevicesResponse>;
+
+  getUserFields(request: GetUserFieldsRequest): Observable<GetUserFieldsResponse>;
+
+  createSubscription(request: SubscriptionRequest): Observable<SubscriptionResponse>;
+
+  deleteSubscription(request: SubscriptionRequest): Observable<SubscriptionResponse>;
+
+  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 {
+  getPublicProfile(
+    request: GetPublicProfileRequest,
+  ): Promise<PublicProfileResponse> | Observable<PublicProfileResponse> | PublicProfileResponse;
+
+  updateProfile(
+    request: UpdateProfileRequest,
+  ): Promise<PublicProfileResponse> | Observable<PublicProfileResponse> | PublicProfileResponse;
+
+  updateUser(request: UpdateUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
+
+  checkAvailability(
+    request: CheckAvailabilityRequest,
+  ): Promise<CheckAvailabilityResponse> | Observable<CheckAvailabilityResponse> | CheckAvailabilityResponse;
+
+  updateUserRole(request: UpdateUserRoleRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
+
+  getUsers(request: GetUsersRequest): Promise<GetUsersResponse> | Observable<GetUsersResponse> | GetUsersResponse;
+
+  getActiveDevices(
+    request: GetActiveDevicesRequest,
+  ): Promise<GetActiveDevicesResponse> | Observable<GetActiveDevicesResponse> | GetActiveDevicesResponse;
+
+  manageDevices(
+    request: ManageDevicesRequest,
+  ): Promise<ManageDevicesResponse> | Observable<ManageDevicesResponse> | ManageDevicesResponse;
+
+  getUserFields(
+    request: GetUserFieldsRequest,
+  ): Promise<GetUserFieldsResponse> | Observable<GetUserFieldsResponse> | GetUserFieldsResponse;
+
+  createSubscription(
+    request: SubscriptionRequest,
+  ): Promise<SubscriptionResponse> | Observable<SubscriptionResponse> | SubscriptionResponse;
+
+  deleteSubscription(
+    request: SubscriptionRequest,
+  ): Promise<SubscriptionResponse> | Observable<SubscriptionResponse> | SubscriptionResponse;
+
+  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() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "getPublicProfile",
+      "updateProfile",
+      "updateUser",
+      "checkAvailability",
+      "updateUserRole",
+      "getUsers",
+      "getActiveDevices",
+      "manageDevices",
+      "getUserFields",
+      "createSubscription",
+      "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);
+      GrpcMethod("UsersService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("UsersService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const USERS_SERVICE_NAME = "UsersService";