@aepstore-dev/contracts 1.15.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.15.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;
 }