@aepstore-dev/contracts 1.0.5 → 1.1.0

package/gen/users.ts

@@ -0,0 +1,269 @@
+// 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,
+}
+
+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;
+}
+
+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 Product {
+  id: string;
+  name: string;
+  description: string;
+  /** Decimal as string (D7) */
+  price: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+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;
+}
+
+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: User[];
+  subscribers: User[];
+  isOwner: boolean;
+}
+
+export interface UpdateProfileRequest {
+  userId: string;
+  fullName: string;
+  aboutMe: string;
+  newsletterSubscription: boolean;
+  hideSubscriptions: boolean;
+  avatarUrl: string;
+  bannerUrl: string;
+  countryId: string;
+  timezone: string;
+  socialMedia: CreateSocialMedia[];
+}
+
+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;
+}
+
+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: User[];
+  subscribers: User[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+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>;
+}
+
+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;
+}
+
+export function UsersServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "getPublicProfile",
+      "updateProfile",
+      "updateUser",
+      "updateUserRole",
+      "getUsers",
+      "getActiveDevices",
+      "manageDevices",
+      "getUserFields",
+    ];
+    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";

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "generate": "protoc -I ./proto ./proto/*.proto --ts_proto_out=./gen --ts_proto_opt=nestJs=true,package=omit",
+    "generate": "node scripts/generate.cjs",
     "build": "tsc -p tsconfig.build.json"
   },
   "files": [
@@ -20,13 +20,16 @@
     "name": "torroixq",
     "email": "cato.ixq@gmail.com"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@nestjs/microservices": "^11.1.11",
-    "rxjs": "^7.8.2",
-    "ts-proto": "^2.10.1"
+    "rxjs": "^7.8.2"
   },
   "devDependencies": {
+    "@nestjs/microservices": "^11.1.11",
+    "@protobuf-ts/protoc": "^2.9.4",
     "@types/node": "^25.0.3",
+    "rxjs": "^7.8.2",
+    "ts-proto": "^2.10.1",
     "typescript": "^5.9.3"
   }
 }

package/proto/activity.proto

@@ -0,0 +1,201 @@
+syntax = "proto3";
+
+package activity.v1;
+
+service ActivityService {
+    // Reports
+    rpc ReportCreate(CreateReportRequest) returns (ReportResponse);
+    rpc ReportList(ListReportsRequest) returns (ReportsListResponse);
+    rpc ReportGet(ReportIdRequest) returns (ReportResponse);
+    rpc ReportModerate(ModerateReportRequest) returns (ReportResponse);
+
+    // Report categories
+    rpc ReportCategoryCreate(CreateReportCategoryRequest) returns (ReportCategoryResponse);
+    rpc ReportCategoryList(ListReportCategoriesRequest) returns (ReportCategoriesListResponse);
+    rpc ReportCategoryGet(ReportCategoryIdRequest) returns (ReportCategoryResponse);
+    rpc ReportCategoryUpdate(UpdateReportCategoryRequest) returns (ReportCategoryResponse);
+    rpc ReportCategoryDelete(ReportCategoryIdRequest) returns (Ok);
+
+    // Reviews
+    rpc ReviewCreate(CreateReviewRequest) returns (ReviewResponse);
+    rpc GetProductReviews(GetProductReviewsRequest) returns (ReviewsListResponse);
+
+    // Subscriptions
+    rpc ToggleSubscription(ToggleSubscriptionRequest) returns (ToggleSubscriptionResponse);
+}
+
+// =================================================================
+// Enums
+// =================================================================
+
+enum ReportType {
+    REPORT_TYPE_UNSPECIFIED = 0;
+    REPORT_TYPE_PRODUCT = 1;
+    REPORT_TYPE_PROFILE = 2;
+    REPORT_TYPE_REVIEW = 3;
+}
+
+enum ReportStatus {
+    REPORT_STATUS_UNSPECIFIED = 0;
+    REPORT_STATUS_PENDING = 1;
+    REPORT_STATUS_IN_PROGRESS = 2;
+    REPORT_STATUS_RESOLVED = 3;
+    REPORT_STATUS_DISMISSED = 4;
+}
+
+// =================================================================
+// Reports
+// =================================================================
+
+message Report {
+    string id = 1;
+    ReportType type = 2;
+    string object_id = 3;
+    string user_id = 4;
+    string product_id = 5;
+    repeated ReportCategory categories = 6;
+    string message = 7;
+    ReportStatus status = 8;
+    string created_at = 9;
+    string updated_at = 10;
+}
+
+message ReportResponse {
+    Report report = 1;
+}
+
+message CreateReportRequest {
+    string user_id = 1;
+    ReportType type = 2;
+    string object_id = 3;
+    repeated string categories = 4; // names
+    string message = 5;
+}
+
+message ListReportsRequest {
+    ReportType type = 1;
+    ReportStatus status = 2;
+    string user_id = 3;
+    string object_id = 4;
+    int32 page = 5;
+    int32 limit = 6;
+}
+
+message ReportsListResponse {
+    repeated Report items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message ReportIdRequest {
+    string id = 1;
+}
+
+message ModerateReportRequest {
+    string id = 1;
+    string action = 2; // 'accept' | 'reject'
+}
+
+// =================================================================
+// Report categories
+// =================================================================
+
+message ReportCategory {
+    string id = 1;
+    string name = 2;
+    ReportType type = 3;
+    string icon = 4;
+    string description = 5;
+}
+
+message ReportCategoryResponse {
+    ReportCategory category = 1;
+}
+
+message CreateReportCategoryRequest {
+    string name = 1;
+    ReportType type = 2;
+    string icon = 3;
+    string description = 4;
+}
+
+message UpdateReportCategoryRequest {
+    string id = 1;
+    string name = 2;
+    string icon = 3;
+    string description = 4;
+}
+
+message ListReportCategoriesRequest {
+    ReportType type = 1;
+}
+
+message ReportCategoriesListResponse {
+    repeated ReportCategory items = 1;
+}
+
+message ReportCategoryIdRequest {
+    string id = 1;
+}
+
+// =================================================================
+// Reviews
+// =================================================================
+
+message Review {
+    string id = 1;
+    int32 rating = 2;
+    string text = 3;
+    string user_id = 4;
+    string product_id = 5;
+    string created_at = 6;
+    string updated_at = 7;
+    string user_username = 8;
+    string user_avatar_url = 9;
+}
+
+message ReviewResponse {
+    Review review = 1;
+}
+
+message CreateReviewRequest {
+    string user_id = 1;
+    string product_id = 2;
+    int32 rating = 3;
+    string text = 4;
+}
+
+message GetProductReviewsRequest {
+    string product_id = 1;
+    int32 page = 2;
+    int32 limit = 3;
+}
+
+message ReviewsListResponse {
+    repeated Review items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+// =================================================================
+// Subscriptions
+// =================================================================
+
+message ToggleSubscriptionRequest {
+    string user_id = 1;
+    string target_username = 2;
+}
+
+message ToggleSubscriptionResponse {
+    bool subscribed = 1;
+}
+
+// =================================================================
+// Misc
+// =================================================================
+
+message Ok {
+    bool ok = 1;
+}

package/proto/auth.proto

@@ -2,27 +2,120 @@ syntax = "proto3";
 
 package auth.v1;
 
+// Ported from legacy auth-service (@MessagePattern → @GrpcMethod).
+// All tokens are HMAC primitives minted by @aepstore-dev/passport;
+// the access token only carries `userId`. Username / roles / 2FA state
+// must be looked up via Prisma or RbacService on the consumer side.
 service AuthService {
-    rpc SendOtp (SendOtpRequest) returns (SendOtpResponse);
-    rpc VerifyOtp (VerifyOtpRequest) returns (VerifyOtpResponse);
+    rpc Login(LoginRequest) returns (AuthResponse);
+    rpc Register(RegisterRequest) returns (AuthResponse);
+    rpc CreateCode(CreateCodeRequest) returns (CreateCodeResponse);
+    rpc VerifyCode(VerifyCodeRequest) returns (VerifyCodeResponse);
+    rpc CheckToken(CheckTokenRequest) returns (CheckTokenResponse);
+    rpc RefreshToken(RefreshTokenRequest) returns (AuthResponse);
+    rpc Get2faStatus(Get2faStatusRequest) returns (Get2faStatusResponse);
+    rpc GetProfile(GetProfileRequest) returns (UserProfileResponse);
+    rpc CleanupExpiredTotpSetups(Empty) returns (Empty);
 }
 
-message SendOtpRequest {
-    string identifier = 1;
+// Login by username OR email (one of the two must be set).
+message LoginRequest {
+    string password = 1;
+    string username = 2; // optional
+    string email = 3;    // optional
+}
+
+message RegisterRequest {
+    string email = 1;
+    string username = 2;
+    string password = 3;
+    string ip = 4; // optional, attached by gateway from req
+}
+
+// Standard tokens-plus-user payload returned by Login / Register / RefreshToken.
+message AuthResponse {
+    string access_token = 1;
+    string refresh_token = 2;
+    AuthUser user = 3;
+}
+
+message AuthUser {
+    string id = 1;
+    string email = 2;
+    string username = 3;
+    string role = 4; // primary role for backwards compat ("User" / "Administrator" / "Moderator")
+}
+
+// Code types: '2fa', 'reset', 'confirm', 'totp' (legacy strings preserved as-is).
+message CreateCodeRequest {
+    string email = 1;
     string type = 2;
 }
 
-message SendOtpResponse {
+message CreateCodeResponse {
     bool ok = 1;
 }
 
-message VerifyOtpRequest {
-    string identifier = 1;
-    string type = 2;
-    string code = 3;
+// `new_password` is only used by the 'reset' flow.
+message VerifyCodeRequest {
+    string email = 1;
+    string code = 2;
+    string type = 3;
+    string new_password = 4; // optional
 }
 
-message VerifyOtpResponse {
-    string access_token = 1;
-    string refresh_token = 2;
-}
+// Some verification flows (e.g. confirm-on-register) issue tokens immediately;
+// others just return ok=true.
+message VerifyCodeResponse {
+    bool ok = 1;
+    string access_token = 2;  // optional
+    string refresh_token = 3; // optional
+}
+
+message CheckTokenRequest {
+    string token = 1;
+}
+
+message CheckTokenResponse {
+    bool valid = 1;
+    string user_id = 2;
+    string reason = 3; // populated when valid=false
+}
+
+message RefreshTokenRequest {
+    string refresh_token = 1;
+    string user_agent = 2; // optional
+    string ip = 3;         // optional
+}
+
+message Get2faStatusRequest {
+    string username = 1;
+}
+
+message Get2faStatusResponse {
+    bool enabled = 1;
+    TwoFactorType type = 2;
+}
+
+enum TwoFactorType {
+    NONE = 0;
+    APP = 1;
+    EMAIL = 2;
+}
+
+message GetProfileRequest {
+    string user_id = 1;
+}
+
+message UserProfileResponse {
+    string id = 1;
+    string email = 2;
+    string username = 3;
+    string full_name = 4;
+    bool is_verified = 5;
+    bool two_factor_enabled = 6;
+    TwoFactorType two_factor_type = 7;
+    repeated string roles = 8;
+}
+
+message Empty {}

package/proto/mail.proto

@@ -0,0 +1,42 @@
+syntax = "proto3";
+
+package mail.v1;
+
+// Legacy mail-service used @EventPattern (fire-and-forget). In the new gRPC
+// stack each becomes a unary RPC that returns an Ack. Callers ignore the
+// response if they don't care about delivery.
+service MailService {
+    rpc SendReg(SendRegRequest) returns (MailAck);
+    rpc Send2fa(Send2faRequest) returns (MailAck);
+    rpc SendPasswordReset(SendPasswordResetRequest) returns (MailAck);
+    rpc SendRegistrationConfirm(SendRegistrationConfirmRequest) returns (MailAck);
+}
+
+message MailAck {
+    bool queued = 1;
+}
+
+message SendRegRequest {
+    string user_id = 1;
+    string email = 2;
+    string username = 3;
+    string full_name = 4;
+}
+
+message Send2faRequest {
+    string email = 1;
+    string code = 2;
+    string username = 3;
+}
+
+message SendPasswordResetRequest {
+    string email = 1;
+    string code = 2;
+    string username = 3;
+}
+
+message SendRegistrationConfirmRequest {
+    string email = 1;
+    string code = 2;
+    string username = 3;
+}