@mamindom/contracts 1.0.118 → 1.0.119

package/proto/faq.proto

@@ -0,0 +1,186 @@
+syntax = "proto3";
+
+package content.v1;
+
+import "common_post.proto";
+
+
+service FaqService {
+  // Storefront
+  rpc GetFaqStorefront (GetFaqStorefrontRequest) returns (GetFaqStorefrontResponse);
+  rpc SearchFaq        (SearchFaqRequest)        returns (SearchFaqResponse);
+
+  // Admin — categories
+  rpc GetFaqCategories     (GetFaqCategoriesRequest)     returns (GetFaqCategoriesResponse);
+  rpc GetFaqCategory       (FaqCategoryIdRequest)        returns (FaqCategoryResponse);
+  rpc CreateFaqCategory    (CreateFaqCategoryRequest)    returns (FaqCategoryResponse);
+  rpc UpdateFaqCategory    (UpdateFaqCategoryRequest)    returns (FaqCategoryResponse);
+  rpc DeleteFaqCategory    (FaqCategoryIdRequest)        returns (DeleteResponse);
+  rpc ReorderFaqCategories (ReorderFaqRequest)           returns (SuccessResponse);
+
+  // Admin — items
+  rpc GetFaqItems     (GetFaqItemsRequest)        returns (GetFaqItemsResponse);
+  rpc GetFaqItem      (FaqItemIdRequest)          returns (FaqItemResponse);
+  rpc CreateFaqItem   (CreateFaqItemRequest)      returns (FaqItemResponse);
+  rpc UpdateFaqItem   (UpdateFaqItemRequest)      returns (FaqItemResponse);
+  rpc DeleteFaqItem   (FaqItemIdRequest)          returns (DeleteResponse);
+  rpc ReorderFaqItems (ReorderFaqRequest)         returns (SuccessResponse);
+  rpc BulkSetPopular  (BulkSetPopularFaqRequest)  returns (SuccessResponse);
+}
+
+
+enum FaqStatus {
+  FAQ_STATUS_UNSPECIFIED = 0;
+  FAQ_STATUS_DRAFT       = 1;
+  FAQ_STATUS_PUBLISHED   = 2;
+  FAQ_STATUS_ARCHIVED    = 3;
+}
+
+
+message FaqCategoryResponse {
+  string id   = 1;
+  string slug = 2;
+
+  map<string, string> title = 3;
+
+  optional string icon = 4;
+
+  int32     sort_order = 5;
+  FaqStatus status     = 6;
+
+  int32 items_count = 7;
+
+  string created_at = 8;
+  string updated_at = 9;
+}
+
+
+message FaqItemResponse {
+  string id          = 1;
+  string category_id = 2;
+
+  map<string, string> question = 3;
+  map<string, string> answer   = 4;
+
+  bool      is_popular = 5;
+  int32     sort_order = 6;
+  FaqStatus status     = 7;
+
+  string created_at = 8;
+  string updated_at = 9;
+}
+
+
+message FaqCategoryWithItems {
+  FaqCategoryResponse      category = 1;
+  repeated FaqItemResponse items    = 2;
+}
+
+
+// ── Storefront ──────────────────────────────────────────────────────────────
+
+message GetFaqStorefrontRequest {
+  optional int32 popular_limit = 1;
+}
+
+message GetFaqStorefrontResponse {
+  repeated FaqItemResponse       popular    = 1;
+  repeated FaqCategoryWithItems  categories = 2;
+}
+
+message SearchFaqRequest {
+  string query = 1;
+  optional int32 limit = 2;
+}
+
+message SearchFaqResponse {
+  repeated FaqItemResponse items = 1;
+}
+
+
+// ── Categories CRUD ─────────────────────────────────────────────────────────
+
+message FaqCategoryIdRequest {
+  string id = 1;
+}
+
+message GetFaqCategoriesRequest {
+  optional FaqStatus status = 1;
+}
+
+message GetFaqCategoriesResponse {
+  repeated FaqCategoryResponse items = 1;
+}
+
+message CreateFaqCategoryRequest {
+  string slug = 1;
+  map<string, string> title = 2;
+  optional string icon = 3;
+  int32 sort_order = 4;
+  FaqStatus status = 5;
+}
+
+message UpdateFaqCategoryRequest {
+  string id = 1;
+  optional string slug = 2;
+  map<string, string> title = 3;
+  optional string icon = 4;
+  optional int32 sort_order = 5;
+  optional FaqStatus status = 6;
+  bool clear_icon = 7;
+}
+
+
+// ── Items CRUD ──────────────────────────────────────────────────────────────
+
+message FaqItemIdRequest {
+  string id = 1;
+}
+
+message GetFaqItemsRequest {
+  optional string category_id = 1;
+  optional FaqStatus status = 2;
+  optional string search = 3;
+  PaginationRequest pagination = 4;
+}
+
+message GetFaqItemsResponse {
+  repeated FaqItemResponse items = 1;
+  PaginationMeta meta = 2;
+}
+
+message CreateFaqItemRequest {
+  string category_id = 1;
+  map<string, string> question = 2;
+  map<string, string> answer = 3;
+  bool is_popular = 4;
+  int32 sort_order = 5;
+  FaqStatus status = 6;
+}
+
+message UpdateFaqItemRequest {
+  string id = 1;
+  optional string category_id = 2;
+  map<string, string> question = 3;
+  map<string, string> answer = 4;
+  optional bool is_popular = 5;
+  optional int32 sort_order = 6;
+  optional FaqStatus status = 7;
+}
+
+
+// ── Reorder / Bulk ──────────────────────────────────────────────────────────
+
+message FaqSortEntry {
+  string id = 1;
+  int32 sort_order = 2;
+}
+
+message ReorderFaqRequest {
+  repeated FaqSortEntry items = 1;
+}
+
+message BulkSetPopularFaqRequest {
+  repeated string ids = 1;
+  bool popular = 2;
+}

package/proto/page.proto

@@ -0,0 +1,120 @@
+syntax = "proto3";
+
+package content.v1;
+
+import "common_post.proto";
+
+
+service PageService {
+  rpc GetPage      (GetPageRequest)      returns (PageResponse);
+  rpc GetPageById  (PageIdRequest)       returns (PageResponse);
+  rpc GetPages     (GetPagesRequest)     returns (GetPagesResponse);
+  rpc CreatePage   (CreatePageRequest)   returns (PageResponse);
+  rpc UpdatePage   (UpdatePageRequest)   returns (PageResponse);
+  rpc DeletePage   (PageIdRequest)       returns (DeleteResponse);
+  rpc PublishPage  (PublishPageRequest)  returns (PageResponse);
+}
+
+
+enum PageStatus {
+  PAGE_STATUS_UNSPECIFIED = 0;
+  PAGE_STATUS_DRAFT       = 1;
+  PAGE_STATUS_PUBLISHED   = 2;
+  PAGE_STATUS_ARCHIVED    = 3;
+}
+
+
+message PageResponse {
+  string     id     = 1;
+  string     slug   = 2;
+  PageStatus status = 3;
+
+  map<string, string> title = 4;
+
+  // PageBlock[] serialized as JSON-string. ts-proto without oneofs
+  // turns discriminated unions into a soup of optional fields; keep
+  // the typed union on the gateway side via zod instead.
+  string blocks_json = 5;
+
+  optional string cover_image    = 6;
+  optional string cover_image_id = 7;
+
+  map<string, string> seo_title       = 8;
+  map<string, string> seo_description = 9;
+  map<string, string> seo_keywords    = 10;
+  map<string, string> seo_h1          = 11;
+
+  optional string published_at = 12;
+
+  string created_by_id = 13;
+  string created_at    = 14;
+  string updated_at    = 15;
+}
+
+
+message PageIdRequest {
+  string id = 1;
+}
+
+message GetPageRequest {
+  string slug = 1;
+}
+
+message GetPagesRequest {
+  optional PageStatus status = 1;
+  optional string     search = 2;
+  PaginationRequest   pagination = 3;
+}
+
+message GetPagesResponse {
+  repeated PageResponse items = 1;
+  PaginationMeta        meta  = 2;
+}
+
+
+message CreatePageRequest {
+  string     slug   = 1;
+  PageStatus status = 2;
+
+  map<string, string> title = 3;
+  string blocks_json = 4;
+
+  optional string cover_image    = 5;
+  optional string cover_image_id = 6;
+
+  map<string, string> seo_title       = 7;
+  map<string, string> seo_description = 8;
+  map<string, string> seo_keywords    = 9;
+  map<string, string> seo_h1          = 10;
+
+  string created_by_id = 11;
+}
+
+
+message UpdatePageRequest {
+  string id = 1;
+
+  optional string     slug   = 2;
+  optional PageStatus status = 3;
+
+  map<string, string> title = 4;
+  optional string blocks_json = 5;
+
+  optional string cover_image    = 6;
+  optional string cover_image_id = 7;
+  bool clear_cover_image = 8;
+
+  map<string, string> seo_title       = 9;
+  map<string, string> seo_description = 10;
+  map<string, string> seo_keywords    = 11;
+  map<string, string> seo_h1          = 12;
+
+  string updated_by_id = 13;
+}
+
+
+message PublishPageRequest {
+  string id = 1;
+  bool   publish = 2;
+  string updated_by_id = 3;
+}