@aepstore-dev/contracts 1.42.1 → 1.44.0

package/gen/users.ts

@@ -0,0 +1,929 @@
+// 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[];
+  /** primary role for backwards compat */
+  role: string;
+  /** ISO 8601 */
+  createdAt: string;
+  updatedAt: string;
+  isBanned: boolean;
+  /** ISO 8601, empty = permanent/none */
+  bannedUntil: string;
+  banReason: 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;
+  url: string;
+}
+
+export interface CreateSocialMedia {
+  platform: string;
+  url: 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;
+}
+
+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;
+  fullName: string;
+  aboutMe: string;
+  newsletterSubscription: boolean;
+  hideSubscriptions: boolean;
+  avatarUrl: string;
+  bannerUrl: string;
+  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 {
+  userId: string;
+  username: string;
+  email: string;
+  /** confirmation code when changing email/username */
+  code: string;
+}
+
+export interface UserResponse {
+  user: User | undefined;
+}
+
+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;
+  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 {
+  getPublicProfile(request: GetPublicProfileRequest): Observable<PublicProfileResponse>;
+
+  updateProfile(request: UpdateProfileRequest): Observable<PublicProfileResponse>;
+
+  updateUser(request: UpdateUserRequest): Observable<UserResponse>;
+
+  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;
+
+  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",
+      "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";