@aepstore-dev/contracts 1.103.0 → 1.104.0

package/proto/support.proto

@@ -1,14 +1,14 @@
-syntax = "proto3";
-
-package support.v1;
-
+syntax = "proto3";
+
+package support.v1;
+
 // Support ticket system (G1). Enums as strings matching the DB:
 // status OPEN|IN_PROGRESS|RESOLVED|CLOSED; waitingFor SUPPORT|USER.
-service SupportService {
-    rpc Ping(PingRequest) returns (PingResponse); // health
-
-    // user
-    rpc CreateTicket(CreateTicketRequest) returns (Ticket);
+service SupportService {
+    rpc Ping(PingRequest) returns (PingResponse); // health
+
+    // user
+    rpc CreateTicket(CreateTicketRequest) returns (Ticket);
     rpc GetTicket(GetTicketRequest) returns (Ticket);
     rpc ListTicketMessages(ListTicketMessagesRequest) returns (TicketMessagesListResponse);
     rpc ListMyTickets(ListMyTicketsRequest) returns (TicketsListResponse);
@@ -18,9 +18,9 @@ service SupportService {
     rpc MarkTicketRead(MarkTicketReadRequest) returns (TicketReadState);
     rpc ReportTicket(ReportTicketRequest) returns (SupportTicketComplaint);
     rpc RateTicket(RateTicketRequest) returns (SupportTicketRating);
-
-    // staff/admin
-    rpc ListTickets(ListTicketsRequest) returns (TicketsListResponse);
+
+    // staff/admin
+    rpc ListTickets(ListTicketsRequest) returns (TicketsListResponse);
     rpc AssignTicket(AssignTicketRequest) returns (Ticket);
     rpc SetTicketStatus(SetTicketStatusRequest) returns (Ticket);
     rpc DeleteTicket(DeleteTicketRequest) returns (Ticket);
@@ -30,28 +30,28 @@ service SupportService {
     rpc SetTicketCreationBan(SetTicketCreationBanRequest) returns (SupportTicketBan);
     rpc ClearTicketCreationBan(ClearTicketCreationBanRequest) returns (TicketCreationBanState);
 }
-
-message PingRequest { string message = 1; }
-message PingResponse { bool ok = 1; string message = 2; }
-
+
+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 id = 1;
+    string author_id = 2;
+    string subject = 3;
+    string category = 4;     // GENERAL|PAYMENT|WITHDRAWAL|PRODUCT|ACCOUNT|ABUSE|OTHER
     string status = 5;       // OPEN|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;
-    string department = 14;          // GENERAL|TECHNICAL|SALES
-    string product_category_id = 15; // optional
-    string related_product_id = 16; // optional
-    string related_product_type = 17; // PURCHASED|SELLING
+    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;
+    string department = 14;          // GENERAL|TECHNICAL|SALES
+    string product_category_id = 15; // optional
+    string related_product_id = 16; // optional
+    string related_product_type = 17; // PURCHASED|SELLING
     bool rules_accepted = 18;
     string rules_accepted_at = 19;
     string deleted_at = 20;
@@ -75,66 +75,66 @@ message TicketAssignee {
 }
 
 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;
-    bool is_system = 8;                          // автосообщение платформы
-    repeated TicketAttachment attachments = 9;
-    string edited_at = 10;                       // '' если не редактировалось
-    // Отображаемое имя автора: агент — «Имя Ф.» из fullName (фолбэк username),
-    // клиент — username, системное — ''.
+    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;
+    bool is_system = 8;                          // автосообщение платформы
+    repeated TicketAttachment attachments = 9;
+    string edited_at = 10;                       // '' если не редактировалось
+    // Отображаемое имя автора: агент — «Имя Ф.» из fullName (фолбэк username),
+    // клиент — username, системное — ''.
     string author_name = 11;
     string deleted_at = 12;
     bool is_read_by_staff = 13;  // true for user messages already read by support staff
     string staff_read_at = 14;   // first known staff read timestamp for this message, '' if unread
 }
-
-message TicketAttachment {
-    string file_name = 1;
-    int64 file_size = 2;
-    string url = 3;          // presigned GET, короткоживущая; в запросах пусто
-    string storage_key = 4;  // только внутрь (reply), наружу не отдаётся
+
+message TicketAttachment {
+    string file_name = 1;
+    int64 file_size = 2;
+    string url = 3;          // presigned GET, короткоживущая; в запросах пусто
+    string storage_key = 4;  // только внутрь (reply), наружу не отдаётся
     string mime_type = 5;
 }
 
 message UpdateTicketMessageRequest {
-    string message_id = 1;
-    string requester_id = 2;
-    bool is_staff = 3;
-    string body = 4;
-}
-
-message DeleteTicketMessageRequest {
-    string message_id = 1;
-    string requester_id = 2;
-    bool is_staff = 3;
-}
-
-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
-    string priority = 7;        // LOW|NORMAL|HIGH|URGENT
-    string department = 8;      // GENERAL|TECHNICAL|SALES
-    string product_category_id = 9; // optional
+    string message_id = 1;
+    string requester_id = 2;
+    bool is_staff = 3;
+    string body = 4;
+}
+
+message DeleteTicketMessageRequest {
+    string message_id = 1;
+    string requester_id = 2;
+    bool is_staff = 3;
+}
+
+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
+    string priority = 7;        // LOW|NORMAL|HIGH|URGENT
+    string department = 8;      // GENERAL|TECHNICAL|SALES
+    string product_category_id = 9; // optional
     string related_product_id = 10; // optional
     string related_product_type = 11; // PURCHASED|SELLING
     bool rules_accepted = 12;
     repeated TicketAttachment attachments = 13; // storage_key+file_name+file_size+mime_type
 }
-
+
 message GetTicketRequest {
     string id = 1;
     string requester_id = 2;
@@ -175,26 +175,26 @@ message TicketReadState {
 message ListMyTicketsRequest {
     string author_id = 1;
     string status = 2;          // single value OR comma-separated (e.g. "OPEN,IN_PROGRESS")
-    int32 page = 3;
-    int32 limit = 4;
-    string department = 5;      // GENERAL|TECHNICAL|SALES
-    string category = 6;        // GENERAL|PAYMENT|...
+    int32 page = 3;
+    int32 limit = 4;
+    string department = 5;      // GENERAL|TECHNICAL|SALES
+    string category = 6;        // GENERAL|PAYMENT|...
     string search = 7;          // contains in subject OR in any message body
     string date_from = 8;       // ISO; inclusive lower bound on createdAt
     string date_to = 9;         // ISO; inclusive upper bound on createdAt
     string waiting_for = 10;    // SUPPORT|USER
     string sort = 11;           // desc|asc by ticket createdAt; default desc
-}
-
-message ReplyTicketRequest {
-    string ticket_id = 1;
-    string author_id = 2;
-    string body = 3;
-    bool is_staff = 4;
-    bool is_internal = 5; // staff-only note
-    repeated TicketAttachment attachments = 6; // storage_key+file_name+file_size
-}
-
+}
+
+message ReplyTicketRequest {
+    string ticket_id = 1;
+    string author_id = 2;
+    string body = 3;
+    bool is_staff = 4;
+    bool is_internal = 5; // staff-only note
+    repeated TicketAttachment attachments = 6; // storage_key+file_name+file_size
+}
+
 message CloseTicketRequest {
     string ticket_id = 1;
     string requester_id = 2;
@@ -295,12 +295,12 @@ message ClearTicketCreationBanRequest {
 }
 
 message ListTicketsRequest {
-    string status = 1;          // single value OR comma-separated
-    string category = 2;
-    string assignee_id = 3;
-    int32 page = 4;
-    int32 limit = 5;
-    string department = 6;
+    string status = 1;          // single value OR comma-separated
+    string category = 2;
+    string assignee_id = 3;
+    int32 page = 4;
+    int32 limit = 5;
+    string department = 6;
     string search = 7;          // contains in subject OR in any message body
     string date_from = 8;       // ISO; inclusive lower bound on createdAt
     string date_to = 9;
@@ -309,25 +309,25 @@ message ListTicketsRequest {
     string waiting_for = 12;    // SUPPORT|USER
     string sort = 13;           // desc|asc by ticket createdAt; default desc
 }
-
-message AssignTicketRequest {
-    string ticket_id = 1;
-    string assignee_id = 2; // empty = unassign
-    string admin_id = 3;
-}
-
-message SetTicketStatusRequest {
-    string ticket_id = 1;
-    string status = 2;
-    string admin_id = 3;
-}
-message DeleteTicketRequest {
-    string ticket_id = 1;
-    string admin_id = 2;
-}
-message TicketsListResponse {
-    repeated Ticket items = 1;
-    int32 total = 2;
-    int32 page = 3;
-    int32 limit = 4;
-}
+
+message AssignTicketRequest {
+    string ticket_id = 1;
+    string assignee_id = 2; // empty = unassign
+    string admin_id = 3;
+}
+
+message SetTicketStatusRequest {
+    string ticket_id = 1;
+    string status = 2;
+    string admin_id = 3;
+}
+message DeleteTicketRequest {
+    string ticket_id = 1;
+    string admin_id = 2;
+}
+message TicketsListResponse {
+    repeated Ticket items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}

package/proto/taxonomy.proto

@@ -1,105 +1,105 @@
-syntax = "proto3";
-
-package taxonomy.v1;
-
-service TaxonomyService {
-    rpc FindAllCategories(Empty) returns (CategoriesListResponse);
-    rpc FindAllApplications(Empty) returns (ApplicationsListResponse);
-    rpc FindAllTags(QueryTagsRequest) returns (TagsListResponse);
-
-    rpc CreateCategory(CreateCategoryRequest) returns (CategoryResponse);
-    rpc CreateApplication(CreateApplicationRequest) returns (ApplicationResponse);
-    rpc UpdateApplication(UpdateApplicationRequest) returns (ApplicationResponse);
-
-    // Mint a presigned PUT URL for an application icon SVG (proxies upload-service,
-    // kind=ICON → public/icons/). Client PUTs the bytes to upload_url, then passes
-    // icon_url to Create/UpdateApplication.
-    rpc CreateIconUploadUrl(CreateIconUploadUrlRequest) returns (IconUploadUrlResponse);
-}
-
-message Category {
-    string id = 1;
-    string name = 2;
-    string description = 3;
-    string created_at = 4;
-    string updated_at = 5;
-}
-
-message Application {
-    string id = 1;
-    string name = 2;
-    string description = 3;
-    string created_at = 4;
-    string updated_at = 5;
-    string icon_url = 6; // public S3 URL to brand SVG (admin-set), empty if none
-}
-
-message Tag {
-    string id = 1;
-    string name = 2;
-}
-
-// =================================================================
-// Requests / responses
-// =================================================================
-
-message Empty {}
-
-message CategoriesListResponse {
-    repeated Category items = 1;
-}
-
-message ApplicationsListResponse {
-    repeated Application items = 1;
-}
-
-message QueryTagsRequest {
-    string search = 1;
-    int32 page = 2;
-    int32 limit = 3;
-}
-
-message TagsListResponse {
-    repeated Tag items = 1;
-    int32 total = 2;
-    int32 page = 3;
-    int32 limit = 4;
-}
-
-message CreateCategoryRequest {
-    string name = 1;
-    string description = 2;
-}
-
-message CategoryResponse {
-    Category category = 1;
-}
-
-message CreateApplicationRequest {
-    string name = 1;
-    string description = 2;
-    string icon_url = 3;
-}
-
-message UpdateApplicationRequest {
-    string id = 1;
-    string name = 2;        // optional — empty keeps current
-    string description = 3; // optional
-    string icon_url = 4;    // optional — empty keeps current
-}
-
-message ApplicationResponse {
-    Application application = 1;
-}
-
-message CreateIconUploadUrlRequest {
-    string file_name = 1;
-    string mime_type = 2; // e.g. image/svg+xml
-}
-
-message IconUploadUrlResponse {
-    string upload_url = 1; // presigned PUT URL — client uploads the SVG bytes here
-    string icon_url = 2;   // final public URL to store as Application.iconUrl
-    string file_key = 3;
-    int32 expires_in = 4;
-}
+syntax = "proto3";
+
+package taxonomy.v1;
+
+service TaxonomyService {
+    rpc FindAllCategories(Empty) returns (CategoriesListResponse);
+    rpc FindAllApplications(Empty) returns (ApplicationsListResponse);
+    rpc FindAllTags(QueryTagsRequest) returns (TagsListResponse);
+
+    rpc CreateCategory(CreateCategoryRequest) returns (CategoryResponse);
+    rpc CreateApplication(CreateApplicationRequest) returns (ApplicationResponse);
+    rpc UpdateApplication(UpdateApplicationRequest) returns (ApplicationResponse);
+
+    // Mint a presigned PUT URL for an application icon SVG (proxies upload-service,
+    // kind=ICON → public/icons/). Client PUTs the bytes to upload_url, then passes
+    // icon_url to Create/UpdateApplication.
+    rpc CreateIconUploadUrl(CreateIconUploadUrlRequest) returns (IconUploadUrlResponse);
+}
+
+message Category {
+    string id = 1;
+    string name = 2;
+    string description = 3;
+    string created_at = 4;
+    string updated_at = 5;
+}
+
+message Application {
+    string id = 1;
+    string name = 2;
+    string description = 3;
+    string created_at = 4;
+    string updated_at = 5;
+    string icon_url = 6; // public S3 URL to brand SVG (admin-set), empty if none
+}
+
+message Tag {
+    string id = 1;
+    string name = 2;
+}
+
+// =================================================================
+// Requests / responses
+// =================================================================
+
+message Empty {}
+
+message CategoriesListResponse {
+    repeated Category items = 1;
+}
+
+message ApplicationsListResponse {
+    repeated Application items = 1;
+}
+
+message QueryTagsRequest {
+    string search = 1;
+    int32 page = 2;
+    int32 limit = 3;
+}
+
+message TagsListResponse {
+    repeated Tag items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message CreateCategoryRequest {
+    string name = 1;
+    string description = 2;
+}
+
+message CategoryResponse {
+    Category category = 1;
+}
+
+message CreateApplicationRequest {
+    string name = 1;
+    string description = 2;
+    string icon_url = 3;
+}
+
+message UpdateApplicationRequest {
+    string id = 1;
+    string name = 2;        // optional — empty keeps current
+    string description = 3; // optional
+    string icon_url = 4;    // optional — empty keeps current
+}
+
+message ApplicationResponse {
+    Application application = 1;
+}
+
+message CreateIconUploadUrlRequest {
+    string file_name = 1;
+    string mime_type = 2; // e.g. image/svg+xml
+}
+
+message IconUploadUrlResponse {
+    string upload_url = 1; // presigned PUT URL — client uploads the SVG bytes here
+    string icon_url = 2;   // final public URL to store as Application.iconUrl
+    string file_key = 3;
+    int32 expires_in = 4;
+}