@mamindom/contracts 1.0.118 → 1.0.119

package/dist/gen/faq.d.ts

@@ -0,0 +1,213 @@
+import { Observable } from "rxjs";
+import { DeleteResponse, PaginationMeta, PaginationRequest, SuccessResponse } from "./common_post";
+export declare const protobufPackage = "content.v1";
+export declare enum FaqStatus {
+    FAQ_STATUS_UNSPECIFIED = 0,
+    FAQ_STATUS_DRAFT = 1,
+    FAQ_STATUS_PUBLISHED = 2,
+    FAQ_STATUS_ARCHIVED = 3,
+    UNRECOGNIZED = -1
+}
+export interface FaqCategoryResponse {
+    id: string;
+    slug: string;
+    title: {
+        [key: string]: string;
+    };
+    icon?: string | undefined;
+    sortOrder: number;
+    status: FaqStatus;
+    itemsCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface FaqCategoryResponse_TitleEntry {
+    key: string;
+    value: string;
+}
+export interface FaqItemResponse {
+    id: string;
+    categoryId: string;
+    question: {
+        [key: string]: string;
+    };
+    answer: {
+        [key: string]: string;
+    };
+    isPopular: boolean;
+    sortOrder: number;
+    status: FaqStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface FaqItemResponse_QuestionEntry {
+    key: string;
+    value: string;
+}
+export interface FaqItemResponse_AnswerEntry {
+    key: string;
+    value: string;
+}
+export interface FaqCategoryWithItems {
+    category: FaqCategoryResponse | undefined;
+    items: FaqItemResponse[];
+}
+export interface GetFaqStorefrontRequest {
+    popularLimit?: number | undefined;
+}
+export interface GetFaqStorefrontResponse {
+    popular: FaqItemResponse[];
+    categories: FaqCategoryWithItems[];
+}
+export interface SearchFaqRequest {
+    query: string;
+    limit?: number | undefined;
+}
+export interface SearchFaqResponse {
+    items: FaqItemResponse[];
+}
+export interface FaqCategoryIdRequest {
+    id: string;
+}
+export interface GetFaqCategoriesRequest {
+    status?: FaqStatus | undefined;
+}
+export interface GetFaqCategoriesResponse {
+    items: FaqCategoryResponse[];
+}
+export interface CreateFaqCategoryRequest {
+    slug: string;
+    title: {
+        [key: string]: string;
+    };
+    icon?: string | undefined;
+    sortOrder: number;
+    status: FaqStatus;
+}
+export interface CreateFaqCategoryRequest_TitleEntry {
+    key: string;
+    value: string;
+}
+export interface UpdateFaqCategoryRequest {
+    id: string;
+    slug?: string | undefined;
+    title: {
+        [key: string]: string;
+    };
+    icon?: string | undefined;
+    sortOrder?: number | undefined;
+    status?: FaqStatus | undefined;
+    clearIcon: boolean;
+}
+export interface UpdateFaqCategoryRequest_TitleEntry {
+    key: string;
+    value: string;
+}
+export interface FaqItemIdRequest {
+    id: string;
+}
+export interface GetFaqItemsRequest {
+    categoryId?: string | undefined;
+    status?: FaqStatus | undefined;
+    search?: string | undefined;
+    pagination: PaginationRequest | undefined;
+}
+export interface GetFaqItemsResponse {
+    items: FaqItemResponse[];
+    meta: PaginationMeta | undefined;
+}
+export interface CreateFaqItemRequest {
+    categoryId: string;
+    question: {
+        [key: string]: string;
+    };
+    answer: {
+        [key: string]: string;
+    };
+    isPopular: boolean;
+    sortOrder: number;
+    status: FaqStatus;
+}
+export interface CreateFaqItemRequest_QuestionEntry {
+    key: string;
+    value: string;
+}
+export interface CreateFaqItemRequest_AnswerEntry {
+    key: string;
+    value: string;
+}
+export interface UpdateFaqItemRequest {
+    id: string;
+    categoryId?: string | undefined;
+    question: {
+        [key: string]: string;
+    };
+    answer: {
+        [key: string]: string;
+    };
+    isPopular?: boolean | undefined;
+    sortOrder?: number | undefined;
+    status?: FaqStatus | undefined;
+}
+export interface UpdateFaqItemRequest_QuestionEntry {
+    key: string;
+    value: string;
+}
+export interface UpdateFaqItemRequest_AnswerEntry {
+    key: string;
+    value: string;
+}
+export interface FaqSortEntry {
+    id: string;
+    sortOrder: number;
+}
+export interface ReorderFaqRequest {
+    items: FaqSortEntry[];
+}
+export interface BulkSetPopularFaqRequest {
+    ids: string[];
+    popular: boolean;
+}
+export declare const CONTENT_V1_PACKAGE_NAME = "content.v1";
+export interface FaqServiceClient {
+    /** Storefront */
+    getFaqStorefront(request: GetFaqStorefrontRequest): Observable<GetFaqStorefrontResponse>;
+    searchFaq(request: SearchFaqRequest): Observable<SearchFaqResponse>;
+    /** Admin — categories */
+    getFaqCategories(request: GetFaqCategoriesRequest): Observable<GetFaqCategoriesResponse>;
+    getFaqCategory(request: FaqCategoryIdRequest): Observable<FaqCategoryResponse>;
+    createFaqCategory(request: CreateFaqCategoryRequest): Observable<FaqCategoryResponse>;
+    updateFaqCategory(request: UpdateFaqCategoryRequest): Observable<FaqCategoryResponse>;
+    deleteFaqCategory(request: FaqCategoryIdRequest): Observable<DeleteResponse>;
+    reorderFaqCategories(request: ReorderFaqRequest): Observable<SuccessResponse>;
+    /** Admin — items */
+    getFaqItems(request: GetFaqItemsRequest): Observable<GetFaqItemsResponse>;
+    getFaqItem(request: FaqItemIdRequest): Observable<FaqItemResponse>;
+    createFaqItem(request: CreateFaqItemRequest): Observable<FaqItemResponse>;
+    updateFaqItem(request: UpdateFaqItemRequest): Observable<FaqItemResponse>;
+    deleteFaqItem(request: FaqItemIdRequest): Observable<DeleteResponse>;
+    reorderFaqItems(request: ReorderFaqRequest): Observable<SuccessResponse>;
+    bulkSetPopular(request: BulkSetPopularFaqRequest): Observable<SuccessResponse>;
+}
+export interface FaqServiceController {
+    /** Storefront */
+    getFaqStorefront(request: GetFaqStorefrontRequest): Promise<GetFaqStorefrontResponse> | Observable<GetFaqStorefrontResponse> | GetFaqStorefrontResponse;
+    searchFaq(request: SearchFaqRequest): Promise<SearchFaqResponse> | Observable<SearchFaqResponse> | SearchFaqResponse;
+    /** Admin — categories */
+    getFaqCategories(request: GetFaqCategoriesRequest): Promise<GetFaqCategoriesResponse> | Observable<GetFaqCategoriesResponse> | GetFaqCategoriesResponse;
+    getFaqCategory(request: FaqCategoryIdRequest): Promise<FaqCategoryResponse> | Observable<FaqCategoryResponse> | FaqCategoryResponse;
+    createFaqCategory(request: CreateFaqCategoryRequest): Promise<FaqCategoryResponse> | Observable<FaqCategoryResponse> | FaqCategoryResponse;
+    updateFaqCategory(request: UpdateFaqCategoryRequest): Promise<FaqCategoryResponse> | Observable<FaqCategoryResponse> | FaqCategoryResponse;
+    deleteFaqCategory(request: FaqCategoryIdRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+    reorderFaqCategories(request: ReorderFaqRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
+    /** Admin — items */
+    getFaqItems(request: GetFaqItemsRequest): Promise<GetFaqItemsResponse> | Observable<GetFaqItemsResponse> | GetFaqItemsResponse;
+    getFaqItem(request: FaqItemIdRequest): Promise<FaqItemResponse> | Observable<FaqItemResponse> | FaqItemResponse;
+    createFaqItem(request: CreateFaqItemRequest): Promise<FaqItemResponse> | Observable<FaqItemResponse> | FaqItemResponse;
+    updateFaqItem(request: UpdateFaqItemRequest): Promise<FaqItemResponse> | Observable<FaqItemResponse> | FaqItemResponse;
+    deleteFaqItem(request: FaqItemIdRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+    reorderFaqItems(request: ReorderFaqRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
+    bulkSetPopular(request: BulkSetPopularFaqRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
+}
+export declare function FaqServiceControllerMethods(): (constructor: Function) => void;
+export declare const FAQ_SERVICE_NAME = "FaqService";

package/dist/gen/faq.js

@@ -0,0 +1,52 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v3.21.12
+// source: faq.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAQ_SERVICE_NAME = exports.CONTENT_V1_PACKAGE_NAME = exports.FaqStatus = exports.protobufPackage = void 0;
+exports.FaqServiceControllerMethods = FaqServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "content.v1";
+var FaqStatus;
+(function (FaqStatus) {
+    FaqStatus[FaqStatus["FAQ_STATUS_UNSPECIFIED"] = 0] = "FAQ_STATUS_UNSPECIFIED";
+    FaqStatus[FaqStatus["FAQ_STATUS_DRAFT"] = 1] = "FAQ_STATUS_DRAFT";
+    FaqStatus[FaqStatus["FAQ_STATUS_PUBLISHED"] = 2] = "FAQ_STATUS_PUBLISHED";
+    FaqStatus[FaqStatus["FAQ_STATUS_ARCHIVED"] = 3] = "FAQ_STATUS_ARCHIVED";
+    FaqStatus[FaqStatus["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(FaqStatus || (exports.FaqStatus = FaqStatus = {}));
+exports.CONTENT_V1_PACKAGE_NAME = "content.v1";
+function FaqServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "getFaqStorefront",
+            "searchFaq",
+            "getFaqCategories",
+            "getFaqCategory",
+            "createFaqCategory",
+            "updateFaqCategory",
+            "deleteFaqCategory",
+            "reorderFaqCategories",
+            "getFaqItems",
+            "getFaqItem",
+            "createFaqItem",
+            "updateFaqItem",
+            "deleteFaqItem",
+            "reorderFaqItems",
+            "bulkSetPopular",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("FaqService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("FaqService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.FAQ_SERVICE_NAME = "FaqService";

package/dist/gen/page.d.ts

@@ -0,0 +1,191 @@
+import { Observable } from "rxjs";
+import { DeleteResponse, PaginationMeta, PaginationRequest } from "./common_post";
+export declare const protobufPackage = "content.v1";
+export declare enum PageStatus {
+    PAGE_STATUS_UNSPECIFIED = 0,
+    PAGE_STATUS_DRAFT = 1,
+    PAGE_STATUS_PUBLISHED = 2,
+    PAGE_STATUS_ARCHIVED = 3,
+    UNRECOGNIZED = -1
+}
+export interface PageResponse {
+    id: string;
+    slug: string;
+    status: PageStatus;
+    title: {
+        [key: string]: string;
+    };
+    /**
+     * 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.
+     */
+    blocksJson: string;
+    coverImage?: string | undefined;
+    coverImageId?: string | undefined;
+    seoTitle: {
+        [key: string]: string;
+    };
+    seoDescription: {
+        [key: string]: string;
+    };
+    seoKeywords: {
+        [key: string]: string;
+    };
+    seoH1: {
+        [key: string]: string;
+    };
+    publishedAt?: string | undefined;
+    createdById: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PageResponse_TitleEntry {
+    key: string;
+    value: string;
+}
+export interface PageResponse_SeoTitleEntry {
+    key: string;
+    value: string;
+}
+export interface PageResponse_SeoDescriptionEntry {
+    key: string;
+    value: string;
+}
+export interface PageResponse_SeoKeywordsEntry {
+    key: string;
+    value: string;
+}
+export interface PageResponse_SeoH1Entry {
+    key: string;
+    value: string;
+}
+export interface PageIdRequest {
+    id: string;
+}
+export interface GetPageRequest {
+    slug: string;
+}
+export interface GetPagesRequest {
+    status?: PageStatus | undefined;
+    search?: string | undefined;
+    pagination: PaginationRequest | undefined;
+}
+export interface GetPagesResponse {
+    items: PageResponse[];
+    meta: PaginationMeta | undefined;
+}
+export interface CreatePageRequest {
+    slug: string;
+    status: PageStatus;
+    title: {
+        [key: string]: string;
+    };
+    blocksJson: string;
+    coverImage?: string | undefined;
+    coverImageId?: string | undefined;
+    seoTitle: {
+        [key: string]: string;
+    };
+    seoDescription: {
+        [key: string]: string;
+    };
+    seoKeywords: {
+        [key: string]: string;
+    };
+    seoH1: {
+        [key: string]: string;
+    };
+    createdById: string;
+}
+export interface CreatePageRequest_TitleEntry {
+    key: string;
+    value: string;
+}
+export interface CreatePageRequest_SeoTitleEntry {
+    key: string;
+    value: string;
+}
+export interface CreatePageRequest_SeoDescriptionEntry {
+    key: string;
+    value: string;
+}
+export interface CreatePageRequest_SeoKeywordsEntry {
+    key: string;
+    value: string;
+}
+export interface CreatePageRequest_SeoH1Entry {
+    key: string;
+    value: string;
+}
+export interface UpdatePageRequest {
+    id: string;
+    slug?: string | undefined;
+    status?: PageStatus | undefined;
+    title: {
+        [key: string]: string;
+    };
+    blocksJson?: string | undefined;
+    coverImage?: string | undefined;
+    coverImageId?: string | undefined;
+    clearCoverImage: boolean;
+    seoTitle: {
+        [key: string]: string;
+    };
+    seoDescription: {
+        [key: string]: string;
+    };
+    seoKeywords: {
+        [key: string]: string;
+    };
+    seoH1: {
+        [key: string]: string;
+    };
+    updatedById: string;
+}
+export interface UpdatePageRequest_TitleEntry {
+    key: string;
+    value: string;
+}
+export interface UpdatePageRequest_SeoTitleEntry {
+    key: string;
+    value: string;
+}
+export interface UpdatePageRequest_SeoDescriptionEntry {
+    key: string;
+    value: string;
+}
+export interface UpdatePageRequest_SeoKeywordsEntry {
+    key: string;
+    value: string;
+}
+export interface UpdatePageRequest_SeoH1Entry {
+    key: string;
+    value: string;
+}
+export interface PublishPageRequest {
+    id: string;
+    publish: boolean;
+    updatedById: string;
+}
+export declare const CONTENT_V1_PACKAGE_NAME = "content.v1";
+export interface PageServiceClient {
+    getPage(request: GetPageRequest): Observable<PageResponse>;
+    getPageById(request: PageIdRequest): Observable<PageResponse>;
+    getPages(request: GetPagesRequest): Observable<GetPagesResponse>;
+    createPage(request: CreatePageRequest): Observable<PageResponse>;
+    updatePage(request: UpdatePageRequest): Observable<PageResponse>;
+    deletePage(request: PageIdRequest): Observable<DeleteResponse>;
+    publishPage(request: PublishPageRequest): Observable<PageResponse>;
+}
+export interface PageServiceController {
+    getPage(request: GetPageRequest): Promise<PageResponse> | Observable<PageResponse> | PageResponse;
+    getPageById(request: PageIdRequest): Promise<PageResponse> | Observable<PageResponse> | PageResponse;
+    getPages(request: GetPagesRequest): Promise<GetPagesResponse> | Observable<GetPagesResponse> | GetPagesResponse;
+    createPage(request: CreatePageRequest): Promise<PageResponse> | Observable<PageResponse> | PageResponse;
+    updatePage(request: UpdatePageRequest): Promise<PageResponse> | Observable<PageResponse> | PageResponse;
+    deletePage(request: PageIdRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+    publishPage(request: PublishPageRequest): Promise<PageResponse> | Observable<PageResponse> | PageResponse;
+}
+export declare function PageServiceControllerMethods(): (constructor: Function) => void;
+export declare const PAGE_SERVICE_NAME = "PageService";

package/dist/gen/page.js

@@ -0,0 +1,44 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v3.21.12
+// source: page.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_SERVICE_NAME = exports.CONTENT_V1_PACKAGE_NAME = exports.PageStatus = exports.protobufPackage = void 0;
+exports.PageServiceControllerMethods = PageServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "content.v1";
+var PageStatus;
+(function (PageStatus) {
+    PageStatus[PageStatus["PAGE_STATUS_UNSPECIFIED"] = 0] = "PAGE_STATUS_UNSPECIFIED";
+    PageStatus[PageStatus["PAGE_STATUS_DRAFT"] = 1] = "PAGE_STATUS_DRAFT";
+    PageStatus[PageStatus["PAGE_STATUS_PUBLISHED"] = 2] = "PAGE_STATUS_PUBLISHED";
+    PageStatus[PageStatus["PAGE_STATUS_ARCHIVED"] = 3] = "PAGE_STATUS_ARCHIVED";
+    PageStatus[PageStatus["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(PageStatus || (exports.PageStatus = PageStatus = {}));
+exports.CONTENT_V1_PACKAGE_NAME = "content.v1";
+function PageServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "getPage",
+            "getPageById",
+            "getPages",
+            "createPage",
+            "updatePage",
+            "deletePage",
+            "publishPage",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("PageService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("PageService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.PAGE_SERVICE_NAME = "PageService";

package/dist/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;
+}