@aepstore-dev/contracts 1.14.0 → 1.16.0

package/gen/support.ts

@@ -19,31 +19,192 @@ export interface PingResponse {
   message: string;
 }
 
+export interface Ticket {
+  id: string;
+  authorId: string;
+  subject: string;
+  /** GENERAL|PAYMENT|WITHDRAWAL|PRODUCT|ACCOUNT|ABUSE|OTHER */
+  category: string;
+  /** OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED */
+  status: string;
+  /** LOW|NORMAL|HIGH|URGENT */
+  priority: string;
+  purchaseId: string;
+  withdrawalId: string;
+  assigneeId: string;
+  lastMessageAt: string;
+  createdAt: string;
+  updatedAt: string;
+  messagesCount: number;
+}
+
+export interface TicketMessage {
+  id: string;
+  ticketId: string;
+  authorId: string;
+  body: string;
+  isStaff: boolean;
+  isInternal: boolean;
+  createdAt: string;
+}
+
+export interface TicketWithMessages {
+  ticket: Ticket | undefined;
+  messages: TicketMessage[];
+}
+
+export interface CreateTicketRequest {
+  authorId: string;
+  subject: string;
+  category: string;
+  /** first message */
+  body: string;
+  /** optional */
+  purchaseId: string;
+  /** optional */
+  withdrawalId: string;
+}
+
+export interface GetTicketRequest {
+  id: string;
+  requesterId: string;
+  /** staff see internal notes + any ticket */
+  isStaff: boolean;
+}
+
+export interface ListMyTicketsRequest {
+  authorId: string;
+  status: string;
+  page: number;
+  limit: number;
+}
+
+export interface ReplyTicketRequest {
+  ticketId: string;
+  authorId: string;
+  body: string;
+  isStaff: boolean;
+  /** staff-only note */
+  isInternal: boolean;
+}
+
+export interface CloseTicketRequest {
+  ticketId: string;
+  requesterId: string;
+  isStaff: boolean;
+}
+
+export interface ListTicketsRequest {
+  status: string;
+  category: string;
+  assigneeId: string;
+  page: number;
+  limit: number;
+}
+
+export interface AssignTicketRequest {
+  ticketId: string;
+  /** empty = unassign */
+  assigneeId: string;
+  adminId: string;
+}
+
+export interface SetTicketStatusRequest {
+  ticketId: string;
+  status: string;
+  adminId: string;
+}
+
+export interface TicketsListResponse {
+  items: Ticket[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
 export const SUPPORT_V1_PACKAGE_NAME = "support.v1";
 
 /**
- * Placeholder service. Legacy support-service was an empty stub; this keeps a
- * valid gRPC contract so the service boots and is ready to grow into a tickets
- * API later. Replace Ping with real RPCs when support functionality is built.
+ * Support ticket system (G1). Enums as strings matching the DB
+ * (status OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED; category/priority).
  */
 
 export interface SupportServiceClient {
+  /** health */
+
   ping(request: PingRequest): Observable<PingResponse>;
+
+  /** user */
+
+  createTicket(request: CreateTicketRequest): Observable<Ticket>;
+
+  getTicket(request: GetTicketRequest): Observable<TicketWithMessages>;
+
+  listMyTickets(request: ListMyTicketsRequest): Observable<TicketsListResponse>;
+
+  replyTicket(request: ReplyTicketRequest): Observable<TicketMessage>;
+
+  closeTicket(request: CloseTicketRequest): Observable<Ticket>;
+
+  /** staff/admin */
+
+  listTickets(request: ListTicketsRequest): Observable<TicketsListResponse>;
+
+  assignTicket(request: AssignTicketRequest): Observable<Ticket>;
+
+  setTicketStatus(request: SetTicketStatusRequest): Observable<Ticket>;
 }
 
 /**
- * Placeholder service. Legacy support-service was an empty stub; this keeps a
- * valid gRPC contract so the service boots and is ready to grow into a tickets
- * API later. Replace Ping with real RPCs when support functionality is built.
+ * Support ticket system (G1). Enums as strings matching the DB
+ * (status OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED; category/priority).
  */
 
 export interface SupportServiceController {
+  /** health */
+
   ping(request: PingRequest): Promise<PingResponse> | Observable<PingResponse> | PingResponse;
+
+  /** user */
+
+  createTicket(request: CreateTicketRequest): Promise<Ticket> | Observable<Ticket> | Ticket;
+
+  getTicket(
+    request: GetTicketRequest,
+  ): Promise<TicketWithMessages> | Observable<TicketWithMessages> | TicketWithMessages;
+
+  listMyTickets(
+    request: ListMyTicketsRequest,
+  ): Promise<TicketsListResponse> | Observable<TicketsListResponse> | TicketsListResponse;
+
+  replyTicket(request: ReplyTicketRequest): Promise<TicketMessage> | Observable<TicketMessage> | TicketMessage;
+
+  closeTicket(request: CloseTicketRequest): Promise<Ticket> | Observable<Ticket> | Ticket;
+
+  /** staff/admin */
+
+  listTickets(
+    request: ListTicketsRequest,
+  ): Promise<TicketsListResponse> | Observable<TicketsListResponse> | TicketsListResponse;
+
+  assignTicket(request: AssignTicketRequest): Promise<Ticket> | Observable<Ticket> | Ticket;
+
+  setTicketStatus(request: SetTicketStatusRequest): Promise<Ticket> | Observable<Ticket> | Ticket;
 }
 
 export function SupportServiceControllerMethods() {
   return function (constructor: Function) {
-    const grpcMethods: string[] = ["ping"];
+    const grpcMethods: string[] = [
+      "ping",
+      "createTicket",
+      "getTicket",
+      "listMyTickets",
+      "replyTicket",
+      "closeTicket",
+      "listTickets",
+      "assignTicket",
+      "setTicketStatus",
+    ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
       GrpcMethod("SupportService", method)(constructor.prototype[method], method, descriptor);

package/gen/users.ts

@@ -30,6 +30,23 @@ export interface User {
   /** 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 {
@@ -239,6 +256,10 @@ export interface UsersServiceClient {
   createSubscription(request: SubscriptionRequest): Observable<SubscriptionResponse>;
 
   deleteSubscription(request: SubscriptionRequest): Observable<SubscriptionResponse>;
+
+  banUser(request: BanUserRequest): Observable<UserResponse>;
+
+  unbanUser(request: UnbanUserRequest): Observable<UserResponse>;
 }
 
 export interface UsersServiceController {
@@ -275,6 +296,10 @@ export interface UsersServiceController {
   deleteSubscription(
     request: SubscriptionRequest,
   ): Promise<SubscriptionResponse> | Observable<SubscriptionResponse> | SubscriptionResponse;
+
+  banUser(request: BanUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
+
+  unbanUser(request: UnbanUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
 }
 
 export function UsersServiceControllerMethods() {
@@ -290,6 +315,8 @@ export function UsersServiceControllerMethods() {
       "getUserFields",
       "createSubscription",
       "deleteSubscription",
+      "banUser",
+      "unbanUser",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/support.proto

@@ -2,18 +2,117 @@ syntax = "proto3";
 
 package support.v1;
 
-// Placeholder service. Legacy support-service was an empty stub; this keeps a
-// valid gRPC contract so the service boots and is ready to grow into a tickets
-// API later. Replace Ping with real RPCs when support functionality is built.
+// Support ticket system (G1). Enums as strings matching the DB
+// (status OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED; category/priority).
 service SupportService {
-    rpc Ping(PingRequest) returns (PingResponse);
+    rpc Ping(PingRequest) returns (PingResponse); // health
+
+    // user
+    rpc CreateTicket(CreateTicketRequest) returns (Ticket);
+    rpc GetTicket(GetTicketRequest) returns (TicketWithMessages);
+    rpc ListMyTickets(ListMyTicketsRequest) returns (TicketsListResponse);
+    rpc ReplyTicket(ReplyTicketRequest) returns (TicketMessage);
+    rpc CloseTicket(CloseTicketRequest) returns (Ticket);
+
+    // staff/admin
+    rpc ListTickets(ListTicketsRequest) returns (TicketsListResponse);
+    rpc AssignTicket(AssignTicketRequest) returns (Ticket);
+    rpc SetTicketStatus(SetTicketStatusRequest) returns (Ticket);
+}
+
+message PingRequest { string message = 1; }
+message PingResponse { bool ok = 1; string message = 2; }
+
+message Ticket {
+    string id = 1;
+    string author_id = 2;
+    string subject = 3;
+    string category = 4;     // GENERAL|PAYMENT|WITHDRAWAL|PRODUCT|ACCOUNT|ABUSE|OTHER
+    string status = 5;       // OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED
+    string priority = 6;     // LOW|NORMAL|HIGH|URGENT
+    string purchase_id = 7;
+    string withdrawal_id = 8;
+    string assignee_id = 9;
+    string last_message_at = 10;
+    string created_at = 11;
+    string updated_at = 12;
+    int32 messages_count = 13;
+}
+
+message TicketMessage {
+    string id = 1;
+    string ticket_id = 2;
+    string author_id = 3;
+    string body = 4;
+    bool is_staff = 5;
+    bool is_internal = 6;
+    string created_at = 7;
+}
+
+message TicketWithMessages {
+    Ticket ticket = 1;
+    repeated TicketMessage messages = 2;
+}
+
+message CreateTicketRequest {
+    string author_id = 1;
+    string subject = 2;
+    string category = 3;
+    string body = 4;            // first message
+    string purchase_id = 5;     // optional
+    string withdrawal_id = 6;   // optional
+}
+
+message GetTicketRequest {
+    string id = 1;
+    string requester_id = 2;
+    bool is_staff = 3; // staff see internal notes + any ticket
+}
+
+message ListMyTicketsRequest {
+    string author_id = 1;
+    string status = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message ReplyTicketRequest {
+    string ticket_id = 1;
+    string author_id = 2;
+    string body = 3;
+    bool is_staff = 4;
+    bool is_internal = 5; // staff-only note
+}
+
+message CloseTicketRequest {
+    string ticket_id = 1;
+    string requester_id = 2;
+    bool is_staff = 3;
+}
+
+message ListTicketsRequest {
+    string status = 1;
+    string category = 2;
+    string assignee_id = 3;
+    int32 page = 4;
+    int32 limit = 5;
+}
+
+message AssignTicketRequest {
+    string ticket_id = 1;
+    string assignee_id = 2; // empty = unassign
+    string admin_id = 3;
 }
 
-message PingRequest {
-    string message = 1;
+message SetTicketStatusRequest {
+    string ticket_id = 1;
+    string status = 2;
+    string admin_id = 3;
 }
 
-message PingResponse {
-    bool ok = 1;
-    string message = 2;
+message TicketsListResponse {
+    repeated Ticket items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
 }

package/proto/users.proto

@@ -14,6 +14,9 @@ service UsersService {
 
     rpc CreateSubscription(SubscriptionRequest) returns (SubscriptionResponse);
     rpc DeleteSubscription(SubscriptionRequest) returns (SubscriptionResponse);
+
+    rpc BanUser(BanUserRequest) returns (UserResponse);
+    rpc UnbanUser(UnbanUserRequest) returns (UserResponse);
 }
 
 // =================================================================
@@ -29,6 +32,21 @@ message User {
     string role = 6; // primary role for backwards compat
     string created_at = 7; // ISO 8601
     string updated_at = 8;
+    bool is_banned = 9;
+    string banned_until = 10; // ISO 8601, empty = permanent/none
+    string ban_reason = 11;
+}
+
+message BanUserRequest {
+    string admin_id = 1;
+    string user_id = 2;
+    string reason = 3;
+    string until = 4; // ISO 8601; empty = permanent ban
+}
+
+message UnbanUserRequest {
+    string admin_id = 1;
+    string user_id = 2;
 }
 
 message Country {