@barumetric/contracts 1.1.8 → 1.2.0

package/dist/proto/paths.d.ts

@@ -3,4 +3,5 @@ export declare const PROTO_PATHS: {
     readonly ACCOUNT: string;
     readonly USERS: string;
     readonly MEDIA: string;
+    readonly CATEGORIES: string;
 };

package/dist/proto/paths.js

@@ -7,4 +7,5 @@ exports.PROTO_PATHS = {
     ACCOUNT: (0, path_1.join)(__dirname, "../../proto/account.proto"),
     USERS: (0, path_1.join)(__dirname, "../../proto/users.proto"),
     MEDIA: (0, path_1.join)(__dirname, "../../proto/media.proto"),
+    CATEGORIES: (0, path_1.join)(__dirname, "../../proto/categories.proto"),
 };

package/gen/ts/categories.ts

@@ -0,0 +1,383 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.10.1
+//   protoc               v3.21.12
+// source: categories.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "categories.v1";
+
+/** Типы атрибутов */
+export enum AttributeType {
+  ATTRIBUTE_TYPE_UNSPECIFIED = 0,
+  ATTRIBUTE_TYPE_STRING = 1,
+  ATTRIBUTE_TYPE_TEXT = 2,
+  ATTRIBUTE_TYPE_INTEGER = 3,
+  ATTRIBUTE_TYPE_FLOAT = 4,
+  ATTRIBUTE_TYPE_BOOLEAN = 5,
+  ATTRIBUTE_TYPE_ENUM = 6,
+  ATTRIBUTE_TYPE_MULTI_ENUM = 7,
+  ATTRIBUTE_TYPE_RANGE = 8,
+  ATTRIBUTE_TYPE_DATE = 9,
+  UNRECOGNIZED = -1,
+}
+
+export interface GetTreeRequest {
+  /** Если не указан, возвращает корневые категории */
+  parentId?:
+    | string
+    | undefined;
+  /** Максимальная глубина (0 = без ограничений) */
+  maxDepth: number;
+  /** Только активные категории */
+  onlyActive: boolean;
+}
+
+export interface GetCategoryRequest {
+  id: string;
+  /** Включить атрибуты */
+  includeAttributes: boolean;
+}
+
+export interface GetCategoryBySlugRequest {
+  slug: string;
+  /** Для уникальности */
+  parentId?: string | undefined;
+  includeAttributes: boolean;
+}
+
+export interface GetAttributesRequest {
+  categoryId: string;
+  /** Только для фильтров */
+  onlyFilterable: boolean;
+  /** Включить наследуемые от родителей */
+  includeInherited: boolean;
+}
+
+export interface CreateCategoryRequest {
+  name: string;
+  slug: string;
+  description?: string | undefined;
+  iconUrl?: string | undefined;
+  bannerUrl?: string | undefined;
+  parentId?: string | undefined;
+  isLeaf: boolean;
+  sortOrder: number;
+}
+
+export interface UpdateCategoryRequest {
+  id: string;
+  name?: string | undefined;
+  slug?: string | undefined;
+  description?: string | undefined;
+  iconUrl?: string | undefined;
+  bannerUrl?: string | undefined;
+  isLeaf?: boolean | undefined;
+  isActive?: boolean | undefined;
+  sortOrder?: number | undefined;
+}
+
+export interface DeleteCategoryRequest {
+  id: string;
+  /** Удалить дочерние категории */
+  cascade: boolean;
+}
+
+export interface CreateAttributeRequest {
+  /** Категория, к которой привязываем атрибут */
+  categoryId: string;
+  /** Название атрибута */
+  name: string;
+  /** Глобальный ключ (если атрибут с таким key уже существует, он будет переиспользован) */
+  key: string;
+  type: AttributeType;
+  /** 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;
+  /** Порядок сортировки в категории */
+  sortOrder: number;
+  /** Для ENUM/MULTI_ENUM типов (создаются только если атрибут новый) */
+  enumValues: EnumValueInput[];
+}
+
+export interface UpdateAttributeRequest {
+  /** ID CategoryAttribute (связи) */
+  id: string;
+  /** 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 {
+  categories: Category[];
+}
+
+export interface GetCategoryResponse {
+  category: Category | undefined;
+}
+
+export interface GetAttributesResponse {
+  attributes: CategoryAttribute[];
+}
+
+export interface CreateCategoryResponse {
+  category: Category | undefined;
+}
+
+export interface UpdateCategoryResponse {
+  category: Category | undefined;
+}
+
+export interface DeleteCategoryResponse {
+  ok: boolean;
+}
+
+export interface CreateAttributeResponse {
+  attribute: CategoryAttribute | undefined;
+}
+
+export interface UpdateAttributeResponse {
+  attribute: CategoryAttribute | undefined;
+}
+
+export interface DeleteAttributeResponse {
+  ok: boolean;
+}
+
+export interface Category {
+  id: string;
+  name: string;
+  slug: string;
+  description?: string | undefined;
+  iconUrl?: string | undefined;
+  bannerUrl?: string | undefined;
+  isLeaf: boolean;
+  isActive: boolean;
+  sortOrder: number;
+  parentId?: string | undefined;
+  path: string;
+  depth: number;
+  adsCount: number;
+  /** Для дерева */
+  children: Category[];
+  /** Если include_attributes = true */
+  attributes: CategoryAttribute[];
+}
+
+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;
+  /** Единица измерения из глобального Attribute */
+  unit?:
+    | string
+    | undefined;
+  /** Минимальное значение из глобального Attribute */
+  minValue?:
+    | number
+    | undefined;
+  /** Максимальное значение из глобального Attribute */
+  maxValue?:
+    | number
+    | undefined;
+  /** Порядок сортировки в категории */
+  sortOrder: number;
+  /** Значения из глобального Attribute */
+  enumValues: EnumValue[];
+}
+
+export interface EnumValue {
+  id: string;
+  value: string;
+  label: string;
+  sortOrder: number;
+}
+
+export interface EnumValueInput {
+  value: string;
+  label: string;
+  sortOrder: number;
+}
+
+export const CATEGORIES_V1_PACKAGE_NAME = "categories.v1";
+
+export interface CategoriesServiceClient {
+  /** Получить дерево категорий */
+
+  getTree(request: GetTreeRequest): Observable<GetTreeResponse>;
+
+  /** Получить категорию по ID */
+
+  getCategory(request: GetCategoryRequest): Observable<GetCategoryResponse>;
+
+  /** Получить категорию по slug */
+
+  getCategoryBySlug(request: GetCategoryBySlugRequest): Observable<GetCategoryResponse>;
+
+  /** Получить атрибуты категории (для фильтров) */
+
+  getAttributes(request: GetAttributesRequest): Observable<GetAttributesResponse>;
+
+  /** Создать категорию (админ) */
+
+  createCategory(request: CreateCategoryRequest): Observable<CreateCategoryResponse>;
+
+  /** Обновить категорию (админ) */
+
+  updateCategory(request: UpdateCategoryRequest): Observable<UpdateCategoryResponse>;
+
+  /** Удалить категорию (админ) */
+
+  deleteCategory(request: DeleteCategoryRequest): Observable<DeleteCategoryResponse>;
+
+  /** Создать атрибут (админ) */
+
+  createAttribute(request: CreateAttributeRequest): Observable<CreateAttributeResponse>;
+
+  /** Обновить атрибут (админ) */
+
+  updateAttribute(request: UpdateAttributeRequest): Observable<UpdateAttributeResponse>;
+
+  /** Удалить атрибут (админ) */
+
+  deleteAttribute(request: DeleteAttributeRequest): Observable<DeleteAttributeResponse>;
+}
+
+export interface CategoriesServiceController {
+  /** Получить дерево категорий */
+
+  getTree(request: GetTreeRequest): Promise<GetTreeResponse> | Observable<GetTreeResponse> | GetTreeResponse;
+
+  /** Получить категорию по ID */
+
+  getCategory(
+    request: GetCategoryRequest,
+  ): Promise<GetCategoryResponse> | Observable<GetCategoryResponse> | GetCategoryResponse;
+
+  /** Получить категорию по slug */
+
+  getCategoryBySlug(
+    request: GetCategoryBySlugRequest,
+  ): Promise<GetCategoryResponse> | Observable<GetCategoryResponse> | GetCategoryResponse;
+
+  /** Получить атрибуты категории (для фильтров) */
+
+  getAttributes(
+    request: GetAttributesRequest,
+  ): Promise<GetAttributesResponse> | Observable<GetAttributesResponse> | GetAttributesResponse;
+
+  /** Создать категорию (админ) */
+
+  createCategory(
+    request: CreateCategoryRequest,
+  ): Promise<CreateCategoryResponse> | Observable<CreateCategoryResponse> | CreateCategoryResponse;
+
+  /** Обновить категорию (админ) */
+
+  updateCategory(
+    request: UpdateCategoryRequest,
+  ): Promise<UpdateCategoryResponse> | Observable<UpdateCategoryResponse> | UpdateCategoryResponse;
+
+  /** Удалить категорию (админ) */
+
+  deleteCategory(
+    request: DeleteCategoryRequest,
+  ): Promise<DeleteCategoryResponse> | Observable<DeleteCategoryResponse> | DeleteCategoryResponse;
+
+  /** Создать атрибут (админ) */
+
+  createAttribute(
+    request: CreateAttributeRequest,
+  ): Promise<CreateAttributeResponse> | Observable<CreateAttributeResponse> | CreateAttributeResponse;
+
+  /** Обновить атрибут (админ) */
+
+  updateAttribute(
+    request: UpdateAttributeRequest,
+  ): Promise<UpdateAttributeResponse> | Observable<UpdateAttributeResponse> | UpdateAttributeResponse;
+
+  /** Удалить атрибут (админ) */
+
+  deleteAttribute(
+    request: DeleteAttributeRequest,
+  ): Promise<DeleteAttributeResponse> | Observable<DeleteAttributeResponse> | DeleteAttributeResponse;
+}
+
+export function CategoriesServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "getTree",
+      "getCategory",
+      "getCategoryBySlug",
+      "getAttributes",
+      "createCategory",
+      "updateCategory",
+      "deleteCategory",
+      "createAttribute",
+      "updateAttribute",
+      "deleteAttribute",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("CategoriesService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("CategoriesService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const CATEGORIES_SERVICE_NAME = "CategoriesService";

package/package.json

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

package/proto/categories.proto

@@ -0,0 +1,221 @@
+syntax = "proto3";
+
+package categories.v1;
+
+import "google/protobuf/empty.proto";
+
+service CategoriesService {
+	// Получить дерево категорий
+	rpc GetTree (GetTreeRequest) returns (GetTreeResponse);
+	
+	// Получить категорию по ID
+	rpc GetCategory (GetCategoryRequest) returns (GetCategoryResponse);
+	
+	// Получить категорию по slug
+	rpc GetCategoryBySlug (GetCategoryBySlugRequest) returns (GetCategoryResponse);
+	
+	// Получить атрибуты категории (для фильтров)
+	rpc GetAttributes (GetAttributesRequest) returns (GetAttributesResponse);
+	
+	// Создать категорию (админ)
+	rpc CreateCategory (CreateCategoryRequest) returns (CreateCategoryResponse);
+	
+	// Обновить категорию (админ)
+	rpc UpdateCategory (UpdateCategoryRequest) returns (UpdateCategoryResponse);
+	
+	// Удалить категорию (админ)
+	rpc DeleteCategory (DeleteCategoryRequest) returns (DeleteCategoryResponse);
+	
+	// Создать атрибут (админ)
+	rpc CreateAttribute (CreateAttributeRequest) returns (CreateAttributeResponse);
+	
+	// Обновить атрибут (админ)
+	rpc UpdateAttribute (UpdateAttributeRequest) returns (UpdateAttributeResponse);
+	
+	// Удалить атрибут (админ)
+	rpc DeleteAttribute (DeleteAttributeRequest) returns (DeleteAttributeResponse);
+}
+
+// Запросы
+
+message GetTreeRequest {
+	optional string parent_id = 1; // Если не указан, возвращает корневые категории
+	int32 max_depth = 2; // Максимальная глубина (0 = без ограничений)
+	bool only_active = 3; // Только активные категории
+}
+
+message GetCategoryRequest {
+	string id = 1;
+	bool include_attributes = 2; // Включить атрибуты
+}
+
+message GetCategoryBySlugRequest {
+	string slug = 1;
+	optional string parent_id = 2; // Для уникальности
+	bool include_attributes = 3;
+}
+
+message GetAttributesRequest {
+	string category_id = 1;
+	bool only_filterable = 2; // Только для фильтров
+	bool include_inherited = 3; // Включить наследуемые от родителей
+}
+
+message CreateCategoryRequest {
+	string name = 1;
+	string slug = 2;
+	optional string description = 3;
+	optional string icon_url = 4;
+	optional string banner_url = 5;
+	optional string parent_id = 6;
+	bool is_leaf = 7;
+	int32 sort_order = 8;
+}
+
+message UpdateCategoryRequest {
+	string id = 1;
+	optional string name = 2;
+	optional string slug = 3;
+	optional string description = 4;
+	optional string icon_url = 5;
+	optional string banner_url = 6;
+	optional bool is_leaf = 7;
+	optional bool is_active = 8;
+	optional int32 sort_order = 9;
+}
+
+message DeleteCategoryRequest {
+	string id = 1;
+	bool cascade = 2; // Удалить дочерние категории
+}
+
+message CreateAttributeRequest {
+	string category_id = 1; // Категория, к которой привязываем атрибут
+	string name = 2; // Название атрибута
+	string key = 3; // Глобальный ключ (если атрибут с таким key уже существует, он будет переиспользован)
+	AttributeType type = 4;
+	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; // 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; // ID CategoryAttribute (связи) - удаляется только связь, глобальный Attribute остается
+}
+
+// Ответы
+
+message GetTreeResponse {
+	repeated Category categories = 1;
+}
+
+message GetCategoryResponse {
+	Category category = 1;
+}
+
+message GetAttributesResponse {
+	repeated CategoryAttribute attributes = 1;
+}
+
+message CreateCategoryResponse {
+	Category category = 1;
+}
+
+message UpdateCategoryResponse {
+	Category category = 1;
+}
+
+message DeleteCategoryResponse {
+	bool ok = 1;
+}
+
+message CreateAttributeResponse {
+	CategoryAttribute attribute = 1;
+}
+
+message UpdateAttributeResponse {
+	CategoryAttribute attribute = 1;
+}
+
+message DeleteAttributeResponse {
+	bool ok = 1;
+}
+
+// Модели
+
+message Category {
+	string id = 1;
+	string name = 2;
+	string slug = 3;
+	optional string description = 4;
+	optional string icon_url = 5;
+	optional string banner_url = 6;
+	bool is_leaf = 7;
+	bool is_active = 8;
+	int32 sort_order = 9;
+	optional string parent_id = 10;
+	string path = 11;
+	int32 depth = 12;
+	int64 ads_count = 13;
+	repeated Category children = 14; // Для дерева
+	repeated CategoryAttribute attributes = 15; // Если include_attributes = true
+}
+
+message CategoryAttribute {
+	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 {
+	string id = 1;
+	string value = 2;
+	string label = 3;
+	int32 sort_order = 4;
+}
+
+message EnumValueInput {
+	string value = 1;
+	string label = 2;
+	int32 sort_order = 3;
+}
+
+// Типы атрибутов
+enum AttributeType {
+	ATTRIBUTE_TYPE_UNSPECIFIED = 0;
+	ATTRIBUTE_TYPE_STRING = 1;
+	ATTRIBUTE_TYPE_TEXT = 2;
+	ATTRIBUTE_TYPE_INTEGER = 3;
+	ATTRIBUTE_TYPE_FLOAT = 4;
+	ATTRIBUTE_TYPE_BOOLEAN = 5;
+	ATTRIBUTE_TYPE_ENUM = 6;
+	ATTRIBUTE_TYPE_MULTI_ENUM = 7;
+	ATTRIBUTE_TYPE_RANGE = 8;
+	ATTRIBUTE_TYPE_DATE = 9;
+}
+
+
+