@barumetric/contracts 1.1.9 → 1.2.0

package/gen/ts/categories.ts

@@ -49,18 +49,6 @@ export interface GetCategoryBySlugRequest {
   includeAttributes: boolean;
 }
 
-export interface GetChildrenRequest {
-  parentId: string;
-  onlyActive: boolean;
-}
-
-export interface GetPopularRequest {
-  /** Количество категорий */
-  limit: number;
-  /** Популярные в конкретной категории */
-  parentId?: string | undefined;
-}
-
 export interface GetAttributesRequest {
   categoryId: string;
   /** Только для фильтров */
@@ -99,53 +87,73 @@ export interface DeleteCategoryRequest {
 }
 
 export interface CreateAttributeRequest {
+  /** Категория, к которой привязываем атрибут */
   categoryId: string;
+  /** Название атрибута */
   name: string;
+  /** Глобальный ключ (если атрибут с таким key уже существует, он будет переиспользован) */
   key: string;
   type: AttributeType;
-  isRequired: boolean;
-  isFilterable: boolean;
+  /** Override для категории (null = использовать default из Attribute) */
+  isRequired?:
+    | boolean
+    | undefined;
+  /** Override для категории (null = использовать default из Attribute) */
+  isFilterable?:
+    | boolean
+    | undefined;
+  /** Наследуется ли атрибут дочерним категориям */
   inherited: boolean;
-  unit?: string | undefined;
-  minValue?: number | undefined;
-  maxValue?: number | undefined;
+  /** Единица измерения (₽, км и т.д.) */
+  unit?:
+    | string
+    | undefined;
+  /** Минимальное значение */
+  minValue?:
+    | number
+    | undefined;
+  /** Максимальное значение */
+  maxValue?:
+    | number
+    | undefined;
+  /** Порядок сортировки в категории */
   sortOrder: number;
-  /** Для ENUM/MULTI_ENUM типов */
+  /** Для ENUM/MULTI_ENUM типов (создаются только если атрибут новый) */
   enumValues: EnumValueInput[];
 }
 
 export interface UpdateAttributeRequest {
+  /** ID CategoryAttribute (связи) */
   id: string;
-  name?: string | undefined;
-  isRequired?: boolean | undefined;
-  isFilterable?: boolean | undefined;
-  unit?: string | undefined;
-  minValue?: number | undefined;
-  maxValue?: number | undefined;
-  sortOrder?: number | undefined;
+  /** Override для категории (null = использовать default из Attribute) */
+  isRequired?:
+    | boolean
+    | undefined;
+  /** Override для категории (null = использовать default из Attribute) */
+  isFilterable?:
+    | boolean
+    | undefined;
+  /** Порядок сортировки в категории */
+  sortOrder?:
+    | number
+    | undefined;
+  /** Обновить enum values глобального атрибута */
   enumValues: EnumValueInput[];
 }
 
 export interface DeleteAttributeRequest {
+  /** ID CategoryAttribute (связи) - удаляется только связь, глобальный Attribute остается */
   id: string;
 }
 
 export interface GetTreeResponse {
-  nodes: CategoryNode[];
+  categories: Category[];
 }
 
 export interface GetCategoryResponse {
   category: Category | undefined;
 }
 
-export interface GetChildrenResponse {
-  categories: Category[];
-}
-
-export interface GetPopularResponse {
-  categories: Category[];
-}
-
 export interface GetAttributesResponse {
   attributes: CategoryAttribute[];
 }
@@ -194,24 +202,38 @@ export interface Category {
   attributes: CategoryAttribute[];
 }
 
-export interface CategoryNode {
-  category: Category | undefined;
-  children: CategoryNode[];
-}
-
 export interface CategoryAttribute {
+  /** ID CategoryAttribute (связи) */
   id: string;
+  /** ID категории */
   categoryId: string;
+  /** Название из глобального Attribute */
   name: string;
+  /** Ключ из глобального Attribute */
   key: string;
+  /** Тип из глобального Attribute */
   type: AttributeType;
+  /** Финальное значение (override или default из Attribute) */
   isRequired: boolean;
+  /** Финальное значение (override или default из Attribute) */
   isFilterable: boolean;
+  /** Наследуется ли дочерним категориям */
   inherited: boolean;
-  unit?: string | undefined;
-  minValue?: number | undefined;
-  maxValue?: number | undefined;
+  /** Единица измерения из глобального Attribute */
+  unit?:
+    | string
+    | undefined;
+  /** Минимальное значение из глобального Attribute */
+  minValue?:
+    | number
+    | undefined;
+  /** Максимальное значение из глобального Attribute */
+  maxValue?:
+    | number
+    | undefined;
+  /** Порядок сортировки в категории */
   sortOrder: number;
+  /** Значения из глобального Attribute */
   enumValues: EnumValue[];
 }
 
@@ -243,14 +265,6 @@ export interface CategoriesServiceClient {
 
   getCategoryBySlug(request: GetCategoryBySlugRequest): Observable<GetCategoryResponse>;
 
-  /** Получить дочерние категории */
-
-  getChildren(request: GetChildrenRequest): Observable<GetChildrenResponse>;
-
-  /** Получить популярные категории */
-
-  getPopular(request: GetPopularRequest): Observable<GetPopularResponse>;
-
   /** Получить атрибуты категории (для фильтров) */
 
   getAttributes(request: GetAttributesRequest): Observable<GetAttributesResponse>;
@@ -297,18 +311,6 @@ export interface CategoriesServiceController {
     request: GetCategoryBySlugRequest,
   ): Promise<GetCategoryResponse> | Observable<GetCategoryResponse> | GetCategoryResponse;
 
-  /** Получить дочерние категории */
-
-  getChildren(
-    request: GetChildrenRequest,
-  ): Promise<GetChildrenResponse> | Observable<GetChildrenResponse> | GetChildrenResponse;
-
-  /** Получить популярные категории */
-
-  getPopular(
-    request: GetPopularRequest,
-  ): Promise<GetPopularResponse> | Observable<GetPopularResponse> | GetPopularResponse;
-
   /** Получить атрибуты категории (для фильтров) */
 
   getAttributes(
@@ -358,8 +360,6 @@ export function CategoriesServiceControllerMethods() {
       "getTree",
       "getCategory",
       "getCategoryBySlug",
-      "getChildren",
-      "getPopular",
       "getAttributes",
       "createCategory",
       "updateCategory",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@barumetric/contracts",
-	"version": "1.1.9",
+	"version": "1.2.0",
 	"description": "Protobuf definitions and generated TypeScript types",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",

package/proto/categories.proto

@@ -14,12 +14,6 @@ service CategoriesService {
 	// Получить категорию по slug
 	rpc GetCategoryBySlug (GetCategoryBySlugRequest) returns (GetCategoryResponse);
 	
-	// Получить дочерние категории
-	rpc GetChildren (GetChildrenRequest) returns (GetChildrenResponse);
-	
-	// Получить популярные категории
-	rpc GetPopular (GetPopularRequest) returns (GetPopularResponse);
-	
 	// Получить атрибуты категории (для фильтров)
 	rpc GetAttributes (GetAttributesRequest) returns (GetAttributesResponse);
 	
@@ -61,16 +55,6 @@ message GetCategoryBySlugRequest {
 	bool include_attributes = 3;
 }
 
-message GetChildrenRequest {
-	string parent_id = 1;
-	bool only_active = 2;
-}
-
-message GetPopularRequest {
-	int32 limit = 1; // Количество категорий
-	optional string parent_id = 2; // Популярные в конкретной категории
-}
-
 message GetAttributesRequest {
 	string category_id = 1;
 	bool only_filterable = 2; // Только для фильтров
@@ -106,54 +90,42 @@ message DeleteCategoryRequest {
 }
 
 message CreateAttributeRequest {
-	string category_id = 1;
-	string name = 2;
-	string key = 3;
+	string category_id = 1; // Категория, к которой привязываем атрибут
+	string name = 2; // Название атрибута
+	string key = 3; // Глобальный ключ (если атрибут с таким key уже существует, он будет переиспользован)
 	AttributeType type = 4;
-	bool is_required = 5;
-	bool is_filterable = 6;
-	bool inherited = 7;
-	optional string unit = 8;
-	optional float min_value = 9;
-	optional float max_value = 10;
-	int32 sort_order = 11;
-	repeated EnumValueInput enum_values = 12; // Для ENUM/MULTI_ENUM типов
+	optional bool is_required = 5; // Override для категории (null = использовать default из Attribute)
+	optional bool is_filterable = 6; // Override для категории (null = использовать default из Attribute)
+	bool inherited = 7; // Наследуется ли атрибут дочерним категориям
+	optional string unit = 8; // Единица измерения (₽, км и т.д.)
+	optional float min_value = 9; // Минимальное значение
+	optional float max_value = 10; // Максимальное значение
+	int32 sort_order = 11; // Порядок сортировки в категории
+	repeated EnumValueInput enum_values = 12; // Для ENUM/MULTI_ENUM типов (создаются только если атрибут новый)
 }
 
 message UpdateAttributeRequest {
-	string id = 1;
-	optional string name = 2;
-	optional bool is_required = 3;
-	optional bool is_filterable = 4;
-	optional string unit = 5;
-	optional float min_value = 6;
-	optional float max_value = 7;
-	optional int32 sort_order = 8;
-	repeated EnumValueInput enum_values = 9;
+	string id = 1; // ID CategoryAttribute (связи)
+	optional bool is_required = 2; // Override для категории (null = использовать default из Attribute)
+	optional bool is_filterable = 3; // Override для категории (null = использовать default из Attribute)
+	optional int32 sort_order = 4; // Порядок сортировки в категории
+	repeated EnumValueInput enum_values = 5; // Обновить enum values глобального атрибута
 }
 
 message DeleteAttributeRequest {
-	string id = 1;
+	string id = 1; // ID CategoryAttribute (связи) - удаляется только связь, глобальный Attribute остается
 }
 
 // Ответы
 
 message GetTreeResponse {
-	repeated CategoryNode nodes = 1;
+	repeated Category categories = 1;
 }
 
 message GetCategoryResponse {
 	Category category = 1;
 }
 
-message GetChildrenResponse {
-	repeated Category categories = 1;
-}
-
-message GetPopularResponse {
-	repeated Category categories = 1;
-}
-
 message GetAttributesResponse {
 	repeated CategoryAttribute attributes = 1;
 }
@@ -202,25 +174,20 @@ message Category {
 	repeated CategoryAttribute attributes = 15; // Если include_attributes = true
 }
 
-message CategoryNode {
-	Category category = 1;
-	repeated CategoryNode children = 2;
-}
-
 message CategoryAttribute {
-	string id = 1;
-	string category_id = 2;
-	string name = 3;
-	string key = 4;
-	AttributeType type = 5;
-	bool is_required = 6;
-	bool is_filterable = 7;
-	bool inherited = 8;
-	optional string unit = 9;
-	optional float min_value = 10;
-	optional float max_value = 11;
-	int32 sort_order = 12;
-	repeated EnumValue enum_values = 13;
+	string id = 1; // ID CategoryAttribute (связи)
+	string category_id = 2; // ID категории
+	string name = 3; // Название из глобального Attribute
+	string key = 4; // Ключ из глобального Attribute
+	AttributeType type = 5; // Тип из глобального Attribute
+	bool is_required = 6; // Финальное значение (override или default из Attribute)
+	bool is_filterable = 7; // Финальное значение (override или default из Attribute)
+	bool inherited = 8; // Наследуется ли дочерним категориям
+	optional string unit = 9; // Единица измерения из глобального Attribute
+	optional float min_value = 10; // Минимальное значение из глобального Attribute
+	optional float max_value = 11; // Максимальное значение из глобального Attribute
+	int32 sort_order = 12; // Порядок сортировки в категории
+	repeated EnumValue enum_values = 13; // Значения из глобального Attribute
 }
 
 message EnumValue {
@@ -250,3 +217,5 @@ enum AttributeType {
 	ATTRIBUTE_TYPE_DATE = 9;
 }
 
+
+