@aepstore-dev/contracts 1.0.6 → 1.2.0

package/gen/upload.ts

@@ -0,0 +1,217 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.10.1
+//   protoc               v7.35.0
+// source: upload.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "upload.v1";
+
+/**
+ * Determines the object key prefix (and future ACL/privacy policy).
+ * ATTACHMENT = paid product deliverable (private; presigned GET only after purchase).
+ * MEDIA / AVATAR / BANNER = preview assets.
+ */
+export enum UploadKind {
+  UPLOAD_KIND_UNSPECIFIED = 0,
+  UPLOAD_KIND_ATTACHMENT = 1,
+  UPLOAD_KIND_MEDIA = 2,
+  UPLOAD_KIND_AVATAR = 3,
+  UPLOAD_KIND_BANNER = 4,
+  UNRECOGNIZED = -1,
+}
+
+export interface Ok {
+  ok: boolean;
+}
+
+export interface CreateMultipartUploadRequest {
+  fileName: string;
+  mimeType: string;
+  fileSize: number;
+  kind: UploadKind;
+  /** user initiating, for key namespacing + audit */
+  ownerId: string;
+}
+
+export interface CreateMultipartUploadResponse {
+  /** S3 multipart UploadId */
+  uploadId: string;
+  /** object key this service generated */
+  fileKey: string;
+  /** recommended part size (bytes) the client should slice with */
+  partSize: number;
+  /** number of parts for file_size at part_size */
+  partCount: number;
+}
+
+export interface SignPartRequest {
+  fileKey: string;
+  uploadId: string;
+  /** 1-based */
+  partNumber: number;
+}
+
+export interface SignPartResponse {
+  /** presigned PUT URL for this single part */
+  url: string;
+  expiresIn: number;
+}
+
+export interface CompletedPart {
+  partNumber: number;
+  /** ETag the client received in the S3 PUT response header for this part */
+  etag: string;
+}
+
+export interface CompleteMultipartUploadRequest {
+  fileKey: string;
+  uploadId: string;
+  parts: CompletedPart[];
+}
+
+export interface CompleteMultipartUploadResponse {
+  fileKey: string;
+  /** final object location (internal reference) */
+  location: string;
+  fileSize: number;
+}
+
+export interface AbortMultipartUploadRequest {
+  fileKey: string;
+  uploadId: string;
+}
+
+export interface CreateUploadUrlRequest {
+  fileName: string;
+  mimeType: string;
+  kind: UploadKind;
+  ownerId: string;
+}
+
+export interface CreateUploadUrlResponse {
+  /** presigned PUT URL (client PUTs the whole file) */
+  url: string;
+  fileKey: string;
+  expiresIn: number;
+}
+
+export interface SignedUrlRequest {
+  fileKey: string;
+  /** optional, default 3600 */
+  expiresIn: number;
+  /** optional: forces Content-Disposition attachment filename */
+  downloadFileName: string;
+}
+
+export interface SignedUrlResponse {
+  signedUrl: string;
+  expiresIn: number;
+}
+
+export interface DeleteObjectRequest {
+  fileKey: string;
+}
+
+export const UPLOAD_V1_PACKAGE_NAME = "upload.v1";
+
+/**
+ * Thin signing service. File bytes NEVER pass through this service — clients
+ * upload/download directly to/from S3 (Yandex Object Storage) using presigned
+ * URLs this service mints. Memory/bandwidth flat regardless of file size.
+ *
+ * Large files (product deliverables, up to ~1GB) use the multipart flow:
+ *   CreateMultipartUpload → (SignPart × N, client PUTs each part to S3) →
+ *   CompleteMultipartUpload   (or AbortMultipartUpload on failure)
+ *
+ * Small files (preview images, avatars) use the single-PUT flow: CreateUploadUrl.
+ *
+ * Downloads are gated elsewhere (products-service verifies purchase, then calls
+ * GenerateSignedUrl). This service does not know about purchases.
+ */
+
+export interface UploadServiceClient {
+  createMultipartUpload(request: CreateMultipartUploadRequest): Observable<CreateMultipartUploadResponse>;
+
+  signPart(request: SignPartRequest): Observable<SignPartResponse>;
+
+  completeMultipartUpload(request: CompleteMultipartUploadRequest): Observable<CompleteMultipartUploadResponse>;
+
+  abortMultipartUpload(request: AbortMultipartUploadRequest): Observable<Ok>;
+
+  createUploadUrl(request: CreateUploadUrlRequest): Observable<CreateUploadUrlResponse>;
+
+  generateSignedUrl(request: SignedUrlRequest): Observable<SignedUrlResponse>;
+
+  deleteObject(request: DeleteObjectRequest): Observable<Ok>;
+}
+
+/**
+ * Thin signing service. File bytes NEVER pass through this service — clients
+ * upload/download directly to/from S3 (Yandex Object Storage) using presigned
+ * URLs this service mints. Memory/bandwidth flat regardless of file size.
+ *
+ * Large files (product deliverables, up to ~1GB) use the multipart flow:
+ *   CreateMultipartUpload → (SignPart × N, client PUTs each part to S3) →
+ *   CompleteMultipartUpload   (or AbortMultipartUpload on failure)
+ *
+ * Small files (preview images, avatars) use the single-PUT flow: CreateUploadUrl.
+ *
+ * Downloads are gated elsewhere (products-service verifies purchase, then calls
+ * GenerateSignedUrl). This service does not know about purchases.
+ */
+
+export interface UploadServiceController {
+  createMultipartUpload(
+    request: CreateMultipartUploadRequest,
+  ): Promise<CreateMultipartUploadResponse> | Observable<CreateMultipartUploadResponse> | CreateMultipartUploadResponse;
+
+  signPart(request: SignPartRequest): Promise<SignPartResponse> | Observable<SignPartResponse> | SignPartResponse;
+
+  completeMultipartUpload(
+    request: CompleteMultipartUploadRequest,
+  ):
+    | Promise<CompleteMultipartUploadResponse>
+    | Observable<CompleteMultipartUploadResponse>
+    | CompleteMultipartUploadResponse;
+
+  abortMultipartUpload(request: AbortMultipartUploadRequest): Promise<Ok> | Observable<Ok> | Ok;
+
+  createUploadUrl(
+    request: CreateUploadUrlRequest,
+  ): Promise<CreateUploadUrlResponse> | Observable<CreateUploadUrlResponse> | CreateUploadUrlResponse;
+
+  generateSignedUrl(
+    request: SignedUrlRequest,
+  ): Promise<SignedUrlResponse> | Observable<SignedUrlResponse> | SignedUrlResponse;
+
+  deleteObject(request: DeleteObjectRequest): Promise<Ok> | Observable<Ok> | Ok;
+}
+
+export function UploadServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "createMultipartUpload",
+      "signPart",
+      "completeMultipartUpload",
+      "abortMultipartUpload",
+      "createUploadUrl",
+      "generateSignedUrl",
+      "deleteObject",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("UploadService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("UploadService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const UPLOAD_SERVICE_NAME = "UploadService";

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.6",
+  "version": "1.2.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;
+}