@mamindom/contracts 1.0.140 → 1.0.141

package/dist/gen/audit.d.ts

@@ -4,14 +4,10 @@ export interface LogActionRequest {
     actorId?: string | undefined;
     actorName?: string | undefined;
     actorEmail?: string | undefined;
-    /** e.g. "order.cancelled", "product.price_changed" */
     action: string;
-    /** e.g. "order", "product", "role" */
     targetType: string;
     targetId?: string | undefined;
-    /** human-readable summary */
     summary?: string | undefined;
-    /** serialized JSON snapshot (small!) */
     beforeJson?: string | undefined;
     afterJson?: string | undefined;
     ip?: string | undefined;
@@ -27,9 +23,7 @@ export interface ListAuditRequest {
     targetType?: string | undefined;
     targetId?: string | undefined;
     action?: string | undefined;
-    /** "orders" matches order.* etc */
     actionGroup?: string | undefined;
-    /** ISO date */
     from?: string | undefined;
     to?: string | undefined;
 }

package/dist/gen/banner.d.ts

@@ -118,7 +118,6 @@ export interface UpdateBannerRequest {
     name: {
         [key: string]: string;
     };
-    /** empty = не оновлювати; non-empty = заміна повного списку плейсментів. */
     placements: BannerPlacement[];
     status?: boolean | undefined;
     sortOrder?: number | undefined;

package/dist/gen/bonus_settings.d.ts

@@ -1,16 +1,9 @@
 import { Observable } from "rxjs";
 export declare const protobufPackage = "promo.v1";
 export interface BonusSettingsResponse {
-    /** Курс нарахування бонусів від суми замовлення (0.02 = 2%). */
     earnRate: number;
-    /** Курс списання бонусів (1 бонус = N грн, default 1.0). */
     redeemRate: number;
-    /** Мінімальна сума замовлення для нарахування бонусів (0 = без обмеження). */
     minOrderForEarn: number;
-    /**
-     * Максимальний відсоток від суми замовлення, який можна оплатити бонусами
-     * (1.0 = до 100%, 0.5 = до 50%; 0 — без обмеження).
-     */
     maxRedeemShare: number;
     updatedAt: string;
 }

package/dist/gen/brand.d.ts

@@ -17,7 +17,6 @@ export interface BrandResponse {
     };
     guid1c?: string | undefined;
     imageId?: string | undefined;
-    /** Кількість АКТИВНИХ товарів бренду (для shop UI). */
     productCount: number;
 }
 export interface BrandResponse_DescriptionEntry {

package/dist/gen/bundle.d.ts

@@ -85,7 +85,6 @@ export interface CreateBundleRequest {
     };
     items: BundleItemPayload[];
     createdById: string;
-    /** NEW */
     displayPlacements: DisplayPlacement[];
     priceMode: PriceMode;
     requireAllInStock: boolean;
@@ -140,7 +139,6 @@ export interface UpdateBundleRequest {
         [key: string]: string;
     };
     items: BundleItemPayload[];
-    /** NEW */
     displayPlacements: DisplayPlacement[];
     priceMode?: PriceMode | undefined;
     requireAllInStock?: boolean | undefined;
@@ -300,7 +298,6 @@ export interface BundleDetailResponse {
     originalPrice: number;
     finalPrice: number;
     inStock: boolean;
-    /** NEW */
     displayPlacements: DisplayPlacement[];
     priceMode: PriceMode;
     requireAllInStock: boolean;
@@ -374,24 +371,18 @@ export interface BundleItemAvailability {
     inStock: boolean;
 }
 export interface ExportBundlesResponse {
-    /** JSON string or CSV string */
     content: string;
     format: string;
     count: number;
 }
 export interface GenerateBundleCollageRequest {
     bundleId: string;
-    /** Optional: override cell pixel size (default 400) */
     cellSize?: number | undefined;
 }
 export interface GenerateBundleCollageResponse {
-    /** Public CDN/S3 URL of the collage JPEG */
     url: string;
-    /** S3 object key */
     key: string;
-    /** Final image width in pixels */
     width: number;
-    /** Final image height in pixels */
     height: number;
     bundleId: string;
 }

package/dist/gen/search.d.ts

@@ -130,10 +130,6 @@ export interface ListZeroResultsResponse {
 export interface ClearZeroResultsRequest {
 }
 export declare const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
-/**
- * SearchService — окремий сервіс під autocomplete та керування пошуком
- * (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
- */
 export interface SearchServiceClient {
     /** ─── Public (autocomplete) ─────────────────────────────────────────────── */
     suggest(request: SuggestRequest): Observable<SuggestResponse>;
@@ -153,10 +149,6 @@ export interface SearchServiceClient {
     listZeroResults(request: ListZeroResultsRequest): Observable<ListZeroResultsResponse>;
     clearZeroResults(request: ClearZeroResultsRequest): Observable<SuccessResponse>;
 }
-/**
- * SearchService — окремий сервіс під autocomplete та керування пошуком
- * (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
- */
 export interface SearchServiceController {
     /** ─── Public (autocomplete) ─────────────────────────────────────────────── */
     suggest(request: SuggestRequest): Promise<SuggestResponse> | Observable<SuggestResponse> | SuggestResponse;

package/dist/gen/shop_filters.d.ts

@@ -3,10 +3,6 @@ import { PromotionFilter } from "./product";
 export declare const protobufPackage = "catalog.v1";
 export interface GetShopFiltersRequest {
     categoryId: string;
-    /**
-     * Поточно застосовані фільтри. Counts по кожному facet рахуються
-     * з виключенням саме того facet — щоб лічильники реагували на вибір.
-     */
     brandIds: string[];
     colorIds: string[];
     sizeIds: string[];
@@ -14,19 +10,9 @@ export interface GetShopFiltersRequest {
     priceMax?: number | undefined;
     inStock?: boolean | undefined;
     search?: string | undefined;
-    /**
-     * Обмеження множини товарів акцією — фасети рахуються тільки
-     * по товарах, що належать поточній акції.
-     */
     promotionFilter?: PromotionFilter | undefined;
-    /** Динамічні атрибути окрім color/size (матеріал, виробник тощо). */
     attributeValueIds: string[];
-    /**
-     * Явний прапор "ціновий фільтр активний". Без нього неможливо
-     * відрізнити "користувач не вибирав" від "обрав від 0".
-     */
     priceActive?: boolean | undefined;
-    /** 'uk' | 'ru' — для локалізації labels у відповіді (дефолт uk). */
     locale?: string | undefined;
 }
 export interface GetShopFiltersResponse {
@@ -36,7 +22,13 @@ export interface GetShopFiltersResponse {
     attributes: ShopFilterAttribute[];
     priceMin: number;
     priceMax: number;
-    subcategoryIds: string[];
+    subcategories: ShopFilterSubcategory[];
+}
+export interface ShopFilterSubcategory {
+    id: string;
+    slug: string;
+    label: string;
+    count: number;
 }
 export interface ShopFilterOption {
     value: string;
@@ -51,10 +43,6 @@ export interface ShopFilterColorOption {
 }
 export interface ShopFilterAttribute {
     slug: string;
-    /**
-     * Локалізована назва атрибута (на стороні gateway вже згорнута у
-     * одну рядкову label згідно locale запиту).
-     */
     label: string;
     values: ShopFilterOption[];
 }

package/dist/proto/audit.proto

@@ -11,11 +11,11 @@ message LogActionRequest {
   optional string actor_id     = 1;
   optional string actor_name   = 2;
   optional string actor_email  = 3;
-  string action                = 4;  // e.g. "order.cancelled", "product.price_changed"
-  string target_type           = 5;  // e.g. "order", "product", "role"
+  string action                = 4;  
+  string target_type           = 5;  
   optional string target_id    = 6;
-  optional string summary      = 7;  // human-readable summary
-  optional string before_json  = 8;  // serialized JSON snapshot (small!)
+  optional string summary      = 7;  
+  optional string before_json  = 8;  
   optional string after_json   = 9;
   optional string ip           = 10;
   optional string user_agent   = 11;
@@ -32,8 +32,8 @@ message ListAuditRequest {
   optional string target_type  = 4;
   optional string target_id    = 5;
   optional string action       = 6;
-  optional string action_group = 7;  // "orders" matches order.* etc
-  optional string from         = 8;  // ISO date
+  optional string action_group = 7;  
+  optional string from         = 8;  
   optional string to           = 9;
 }
 

package/dist/proto/banner.proto

@@ -118,7 +118,7 @@ message UpdateBannerRequest {
   string id = 1;
   optional string slug = 2;
   map<string, string> name = 3;
-  // empty = не оновлювати; non-empty = заміна повного списку плейсментів.
+  
   repeated BannerPlacement placements = 4;
   optional bool status = 5;
   optional int32 sort_order = 6;

package/dist/proto/bonus_settings.proto

@@ -10,14 +10,13 @@ service BonusSettingsService {
 
 
 message BonusSettingsResponse {
-  // Курс нарахування бонусів від суми замовлення (0.02 = 2%).
+
   double earn_rate         = 1;
-  // Курс списання бонусів (1 бонус = N грн, default 1.0).
+  
   double redeem_rate       = 2;
-  // Мінімальна сума замовлення для нарахування бонусів (0 = без обмеження).
+  
   double min_order_for_earn = 3;
-  // Максимальний відсоток від суми замовлення, який можна оплатити бонусами
-  // (1.0 = до 100%, 0.5 = до 50%; 0 — без обмеження).
+  
   double max_redeem_share  = 4;
 
   string updated_at        = 5;

package/dist/proto/brand.proto

@@ -30,7 +30,7 @@ message BrandResponse {
   optional string guid_1c = 8;
   optional string image_id = 9;
 
-  // Кількість АКТИВНИХ товарів бренду (для shop UI).
+  
   int32 product_count = 10;
 }
 

package/dist/proto/bundle.proto

@@ -42,7 +42,6 @@ service BundleService {
 }
 
 
-// ─── Enums ────────────────────────────────────────────────────────────────────
 
 enum BundleStatus {
   BUNDLE_STATUS_UNSPECIFIED = 0;
@@ -83,7 +82,6 @@ enum RuleOperator {
 }
 
 
-// ─── Requests ─────────────────────────────────────────────────────────────────
 
 message GetBundlesRequest {
   PaginationRequest pagination = 1;
@@ -122,7 +120,7 @@ message CreateBundleRequest {
   repeated BundleItemPayload items = 15;
   string created_by_id = 16;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 17;
   PriceMode price_mode = 18;
   bool require_all_in_stock = 19;
@@ -155,7 +153,7 @@ message UpdateBundleRequest {
 
   repeated BundleItemPayload items = 16;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 17;
   optional PriceMode price_mode = 18;
   optional bool require_all_in_stock = 19;
@@ -252,7 +250,6 @@ message AddCrossSellLinkRequest {
 }
 
 
-// ─── Responses ────────────────────────────────────────────────────────────────
 
 message GetBundlesResponse {
   repeated BundleListItemResponse items = 1;
@@ -312,7 +309,7 @@ message BundleDetailResponse {
   double final_price = 19;
   bool in_stock = 20;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 21;
   PriceMode price_mode = 22;
   bool require_all_in_stock = 23;
@@ -360,26 +357,25 @@ message BundleItemAvailability {
 }
 
 message ExportBundlesResponse {
-  string content = 1; // JSON string or CSV string
+  string content = 1; 
   string format = 2;
   int32 count = 3;
 }
 
 message GenerateBundleCollageRequest {
   string bundle_id = 1;
-  // Optional: override cell pixel size (default 400)
+  
   optional int32 cell_size = 2;
 }
 
 message GenerateBundleCollageResponse {
-  string url = 1;       // Public CDN/S3 URL of the collage JPEG
-  string key = 2;       // S3 object key
-  int32 width = 3;      // Final image width in pixels
-  int32 height = 4;     // Final image height in pixels
+  string url = 1;       
+  string key = 2;     
+  int32 width = 3;      
+  int32 height = 4;     
   string bundle_id = 5;
 }
 
-// ── Bulk Lookup ──────────────────────────────────────────────────────────────
 
 message BulkLookupBundlesRequest {
   repeated string slugs = 1;
@@ -396,7 +392,6 @@ message BulkLookupBundlesResponse {
   repeated BundleLookupResult results = 1;
 }
 
-// ── Bundle Related Products ──────────────────────────────────────────────────
 
 enum BundleRelatedType {
   BUNDLE_RELATED_TYPE_UNSPECIFIED = 0;

package/dist/proto/search.proto

@@ -4,8 +4,7 @@ package catalog.v1;
 
 import "common.proto";
 
-// SearchService — окремий сервіс під autocomplete та керування пошуком
-// (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
+
 service SearchService {
   // ─── Public (autocomplete) ───────────────────────────────────────────────
   rpc Suggest (SuggestRequest) returns (SuggestResponse);

package/dist/proto/shop_filters.proto

@@ -15,8 +15,7 @@ service ShopFilterService {
 message GetShopFiltersRequest {
   string category_id = 1;
 
-  // Поточно застосовані фільтри. Counts по кожному facet рахуються
-  // з виключенням саме того facet — щоб лічильники реагували на вибір.
+
   repeated string brand_ids = 2;
   repeated string color_ids = 3;
   repeated string size_ids = 4;
@@ -25,18 +24,16 @@ message GetShopFiltersRequest {
   optional bool in_stock = 7;
   optional string search = 8;
 
-  // Обмеження множини товарів акцією — фасети рахуються тільки
-  // по товарах, що належать поточній акції.
+  
   optional PromotionFilter promotion_filter = 9;
 
-  // Динамічні атрибути окрім color/size (матеріал, виробник тощо).
+  
   repeated string attribute_value_ids = 10;
 
-  // Явний прапор "ціновий фільтр активний". Без нього неможливо
-  // відрізнити "користувач не вибирав" від "обрав від 0".
+  
   optional bool price_active = 11;
 
-  // 'uk' | 'ru' — для локалізації labels у відповіді (дефолт uk).
+ 
   optional string locale = 12;
 }
 
@@ -48,7 +45,15 @@ message GetShopFiltersResponse {
   repeated ShopFilterAttribute attributes = 4;
   double price_min = 5;
   double price_max = 6;
-  repeated string subcategory_ids = 7;
+  
+  repeated ShopFilterSubcategory subcategories = 7;
+}
+
+message ShopFilterSubcategory {
+  string id = 1;
+  string slug = 2;
+  string label = 3;
+  int32 count = 4;
 }
 
 message ShopFilterOption {
@@ -66,8 +71,7 @@ message ShopFilterColorOption {
 
 message ShopFilterAttribute {
   string slug = 1;
-  // Локалізована назва атрибута (на стороні gateway вже згорнута у
-  // одну рядкову label згідно locale запиту).
+
   string label = 2;
   repeated ShopFilterOption values = 3;
 }

package/gen/audit.ts

@@ -13,21 +13,11 @@ export const protobufPackage = "audit.v1";
 export interface LogActionRequest {
   actorId?: string | undefined;
   actorName?: string | undefined;
-  actorEmail?:
-    | string
-    | undefined;
-  /** e.g. "order.cancelled", "product.price_changed" */
+  actorEmail?: string | undefined;
   action: string;
-  /** e.g. "order", "product", "role" */
   targetType: string;
-  targetId?:
-    | string
-    | undefined;
-  /** human-readable summary */
-  summary?:
-    | string
-    | undefined;
-  /** serialized JSON snapshot (small!) */
+  targetId?: string | undefined;
+  summary?: string | undefined;
   beforeJson?: string | undefined;
   afterJson?: string | undefined;
   ip?: string | undefined;
@@ -44,14 +34,8 @@ export interface ListAuditRequest {
   actorId?: string | undefined;
   targetType?: string | undefined;
   targetId?: string | undefined;
-  action?:
-    | string
-    | undefined;
-  /** "orders" matches order.* etc */
-  actionGroup?:
-    | string
-    | undefined;
-  /** ISO date */
+  action?: string | undefined;
+  actionGroup?: string | undefined;
   from?: string | undefined;
   to?: string | undefined;
 }

package/gen/banner.ts

@@ -129,7 +129,6 @@ export interface UpdateBannerRequest {
   id: string;
   slug?: string | undefined;
   name: { [key: string]: string };
-  /** empty = не оновлювати; non-empty = заміна повного списку плейсментів. */
   placements: BannerPlacement[];
   status?: boolean | undefined;
   sortOrder?: number | undefined;

package/gen/bonus_settings.ts

@@ -11,16 +11,9 @@ import { Observable } from "rxjs";
 export const protobufPackage = "promo.v1";
 
 export interface BonusSettingsResponse {
-  /** Курс нарахування бонусів від суми замовлення (0.02 = 2%). */
   earnRate: number;
-  /** Курс списання бонусів (1 бонус = N грн, default 1.0). */
   redeemRate: number;
-  /** Мінімальна сума замовлення для нарахування бонусів (0 = без обмеження). */
   minOrderForEarn: number;
-  /**
-   * Максимальний відсоток від суми замовлення, який можна оплатити бонусами
-   * (1.0 = до 100%, 0.5 = до 50%; 0 — без обмеження).
-   */
   maxRedeemShare: number;
   updatedAt: string;
 }

package/gen/brand.ts

@@ -20,10 +20,7 @@ export interface BrandResponse {
   metaTitle: { [key: string]: string };
   metaDescription: { [key: string]: string };
   guid1c?: string | undefined;
-  imageId?:
-    | string
-    | undefined;
-  /** Кількість АКТИВНИХ товарів бренду (для shop UI). */
+  imageId?: string | undefined;
   productCount: number;
 }
 

package/gen/bundle.ts

@@ -94,7 +94,6 @@ export interface CreateBundleRequest {
   metaDescription: { [key: string]: string };
   items: BundleItemPayload[];
   createdById: string;
-  /** NEW */
   displayPlacements: DisplayPlacement[];
   priceMode: PriceMode;
   requireAllInStock: boolean;
@@ -145,7 +144,6 @@ export interface UpdateBundleRequest {
   metaTitle: { [key: string]: string };
   metaDescription: { [key: string]: string };
   items: BundleItemPayload[];
-  /** NEW */
   displayPlacements: DisplayPlacement[];
   priceMode?: PriceMode | undefined;
   requireAllInStock?: boolean | undefined;
@@ -320,7 +318,6 @@ export interface BundleDetailResponse {
   originalPrice: number;
   finalPrice: number;
   inStock: boolean;
-  /** NEW */
   displayPlacements: DisplayPlacement[];
   priceMode: PriceMode;
   requireAllInStock: boolean;
@@ -402,7 +399,6 @@ export interface BundleItemAvailability {
 }
 
 export interface ExportBundlesResponse {
-  /** JSON string or CSV string */
   content: string;
   format: string;
   count: number;
@@ -410,18 +406,13 @@ export interface ExportBundlesResponse {
 
 export interface GenerateBundleCollageRequest {
   bundleId: string;
-  /** Optional: override cell pixel size (default 400) */
   cellSize?: number | undefined;
 }
 
 export interface GenerateBundleCollageResponse {
-  /** Public CDN/S3 URL of the collage JPEG */
   url: string;
-  /** S3 object key */
   key: string;
-  /** Final image width in pixels */
   width: number;
-  /** Final image height in pixels */
   height: number;
   bundleId: string;
 }

package/gen/search.ts

@@ -165,11 +165,6 @@ export interface ClearZeroResultsRequest {
 
 export const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
 
-/**
- * SearchService — окремий сервіс під autocomplete та керування пошуком
- * (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
- */
-
 export interface SearchServiceClient {
   /** ─── Public (autocomplete) ─────────────────────────────────────────────── */
 
@@ -206,11 +201,6 @@ export interface SearchServiceClient {
   clearZeroResults(request: ClearZeroResultsRequest): Observable<SuccessResponse>;
 }
 
-/**
- * SearchService — окремий сервіс під autocomplete та керування пошуком
- * (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
- */
-
 export interface SearchServiceController {
   /** ─── Public (autocomplete) ─────────────────────────────────────────────── */
 

package/gen/shop_filters.ts

@@ -13,36 +13,16 @@ export const protobufPackage = "catalog.v1";
 
 export interface GetShopFiltersRequest {
   categoryId: string;
-  /**
-   * Поточно застосовані фільтри. Counts по кожному facet рахуються
-   * з виключенням саме того facet — щоб лічильники реагували на вибір.
-   */
   brandIds: string[];
   colorIds: string[];
   sizeIds: string[];
   priceMin?: number | undefined;
   priceMax?: number | undefined;
   inStock?: boolean | undefined;
-  search?:
-    | string
-    | undefined;
-  /**
-   * Обмеження множини товарів акцією — фасети рахуються тільки
-   * по товарах, що належать поточній акції.
-   */
-  promotionFilter?:
-    | PromotionFilter
-    | undefined;
-  /** Динамічні атрибути окрім color/size (матеріал, виробник тощо). */
+  search?: string | undefined;
+  promotionFilter?: PromotionFilter | undefined;
   attributeValueIds: string[];
-  /**
-   * Явний прапор "ціновий фільтр активний". Без нього неможливо
-   * відрізнити "користувач не вибирав" від "обрав від 0".
-   */
-  priceActive?:
-    | boolean
-    | undefined;
-  /** 'uk' | 'ru' — для локалізації labels у відповіді (дефолт uk). */
+  priceActive?: boolean | undefined;
   locale?: string | undefined;
 }
 
@@ -53,7 +33,14 @@ export interface GetShopFiltersResponse {
   attributes: ShopFilterAttribute[];
   priceMin: number;
   priceMax: number;
-  subcategoryIds: string[];
+  subcategories: ShopFilterSubcategory[];
+}
+
+export interface ShopFilterSubcategory {
+  id: string;
+  slug: string;
+  label: string;
+  count: number;
 }
 
 export interface ShopFilterOption {
@@ -71,10 +58,6 @@ export interface ShopFilterColorOption {
 
 export interface ShopFilterAttribute {
   slug: string;
-  /**
-   * Локалізована назва атрибута (на стороні gateway вже згорнута у
-   * одну рядкову label згідно locale запиту).
-   */
   label: string;
   values: ShopFilterOption[];
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mamindom/contracts",
 	"description": "proto",
-	"version": "1.0.140",
+	"version": "1.0.141",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",
 	"exports": {

package/proto/audit.proto

@@ -11,11 +11,11 @@ message LogActionRequest {
   optional string actor_id     = 1;
   optional string actor_name   = 2;
   optional string actor_email  = 3;
-  string action                = 4;  // e.g. "order.cancelled", "product.price_changed"
-  string target_type           = 5;  // e.g. "order", "product", "role"
+  string action                = 4;  
+  string target_type           = 5;  
   optional string target_id    = 6;
-  optional string summary      = 7;  // human-readable summary
-  optional string before_json  = 8;  // serialized JSON snapshot (small!)
+  optional string summary      = 7;  
+  optional string before_json  = 8;  
   optional string after_json   = 9;
   optional string ip           = 10;
   optional string user_agent   = 11;
@@ -32,8 +32,8 @@ message ListAuditRequest {
   optional string target_type  = 4;
   optional string target_id    = 5;
   optional string action       = 6;
-  optional string action_group = 7;  // "orders" matches order.* etc
-  optional string from         = 8;  // ISO date
+  optional string action_group = 7;  
+  optional string from         = 8;  
   optional string to           = 9;
 }
 

package/proto/banner.proto

@@ -118,7 +118,7 @@ message UpdateBannerRequest {
   string id = 1;
   optional string slug = 2;
   map<string, string> name = 3;
-  // empty = не оновлювати; non-empty = заміна повного списку плейсментів.
+  
   repeated BannerPlacement placements = 4;
   optional bool status = 5;
   optional int32 sort_order = 6;

package/proto/bonus_settings.proto

@@ -10,14 +10,13 @@ service BonusSettingsService {
 
 
 message BonusSettingsResponse {
-  // Курс нарахування бонусів від суми замовлення (0.02 = 2%).
+
   double earn_rate         = 1;
-  // Курс списання бонусів (1 бонус = N грн, default 1.0).
+  
   double redeem_rate       = 2;
-  // Мінімальна сума замовлення для нарахування бонусів (0 = без обмеження).
+  
   double min_order_for_earn = 3;
-  // Максимальний відсоток від суми замовлення, який можна оплатити бонусами
-  // (1.0 = до 100%, 0.5 = до 50%; 0 — без обмеження).
+  
   double max_redeem_share  = 4;
 
   string updated_at        = 5;

package/proto/brand.proto

@@ -30,7 +30,7 @@ message BrandResponse {
   optional string guid_1c = 8;
   optional string image_id = 9;
 
-  // Кількість АКТИВНИХ товарів бренду (для shop UI).
+  
   int32 product_count = 10;
 }
 

package/proto/bundle.proto

@@ -42,7 +42,6 @@ service BundleService {
 }
 
 
-// ─── Enums ────────────────────────────────────────────────────────────────────
 
 enum BundleStatus {
   BUNDLE_STATUS_UNSPECIFIED = 0;
@@ -83,7 +82,6 @@ enum RuleOperator {
 }
 
 
-// ─── Requests ─────────────────────────────────────────────────────────────────
 
 message GetBundlesRequest {
   PaginationRequest pagination = 1;
@@ -122,7 +120,7 @@ message CreateBundleRequest {
   repeated BundleItemPayload items = 15;
   string created_by_id = 16;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 17;
   PriceMode price_mode = 18;
   bool require_all_in_stock = 19;
@@ -155,7 +153,7 @@ message UpdateBundleRequest {
 
   repeated BundleItemPayload items = 16;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 17;
   optional PriceMode price_mode = 18;
   optional bool require_all_in_stock = 19;
@@ -252,7 +250,6 @@ message AddCrossSellLinkRequest {
 }
 
 
-// ─── Responses ────────────────────────────────────────────────────────────────
 
 message GetBundlesResponse {
   repeated BundleListItemResponse items = 1;
@@ -312,7 +309,7 @@ message BundleDetailResponse {
   double final_price = 19;
   bool in_stock = 20;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 21;
   PriceMode price_mode = 22;
   bool require_all_in_stock = 23;
@@ -360,26 +357,25 @@ message BundleItemAvailability {
 }
 
 message ExportBundlesResponse {
-  string content = 1; // JSON string or CSV string
+  string content = 1; 
   string format = 2;
   int32 count = 3;
 }
 
 message GenerateBundleCollageRequest {
   string bundle_id = 1;
-  // Optional: override cell pixel size (default 400)
+  
   optional int32 cell_size = 2;
 }
 
 message GenerateBundleCollageResponse {
-  string url = 1;       // Public CDN/S3 URL of the collage JPEG
-  string key = 2;       // S3 object key
-  int32 width = 3;      // Final image width in pixels
-  int32 height = 4;     // Final image height in pixels
+  string url = 1;       
+  string key = 2;     
+  int32 width = 3;      
+  int32 height = 4;     
   string bundle_id = 5;
 }
 
-// ── Bulk Lookup ──────────────────────────────────────────────────────────────
 
 message BulkLookupBundlesRequest {
   repeated string slugs = 1;
@@ -396,7 +392,6 @@ message BulkLookupBundlesResponse {
   repeated BundleLookupResult results = 1;
 }
 
-// ── Bundle Related Products ──────────────────────────────────────────────────
 
 enum BundleRelatedType {
   BUNDLE_RELATED_TYPE_UNSPECIFIED = 0;

package/proto/search.proto

@@ -4,8 +4,7 @@ package catalog.v1;
 
 import "common.proto";
 
-// SearchService — окремий сервіс під autocomplete та керування пошуком
-// (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
+
 service SearchService {
   // ─── Public (autocomplete) ───────────────────────────────────────────────
   rpc Suggest (SuggestRequest) returns (SuggestResponse);

package/proto/shop_filters.proto

@@ -15,8 +15,7 @@ service ShopFilterService {
 message GetShopFiltersRequest {
   string category_id = 1;
 
-  // Поточно застосовані фільтри. Counts по кожному facet рахуються
-  // з виключенням саме того facet — щоб лічильники реагували на вибір.
+
   repeated string brand_ids = 2;
   repeated string color_ids = 3;
   repeated string size_ids = 4;
@@ -25,18 +24,16 @@ message GetShopFiltersRequest {
   optional bool in_stock = 7;
   optional string search = 8;
 
-  // Обмеження множини товарів акцією — фасети рахуються тільки
-  // по товарах, що належать поточній акції.
+  
   optional PromotionFilter promotion_filter = 9;
 
-  // Динамічні атрибути окрім color/size (матеріал, виробник тощо).
+  
   repeated string attribute_value_ids = 10;
 
-  // Явний прапор "ціновий фільтр активний". Без нього неможливо
-  // відрізнити "користувач не вибирав" від "обрав від 0".
+  
   optional bool price_active = 11;
 
-  // 'uk' | 'ru' — для локалізації labels у відповіді (дефолт uk).
+ 
   optional string locale = 12;
 }
 
@@ -48,7 +45,15 @@ message GetShopFiltersResponse {
   repeated ShopFilterAttribute attributes = 4;
   double price_min = 5;
   double price_max = 6;
-  repeated string subcategory_ids = 7;
+  
+  repeated ShopFilterSubcategory subcategories = 7;
+}
+
+message ShopFilterSubcategory {
+  string id = 1;
+  string slug = 2;
+  string label = 3;
+  int32 count = 4;
 }
 
 message ShopFilterOption {
@@ -66,8 +71,7 @@ message ShopFilterColorOption {
 
 message ShopFilterAttribute {
   string slug = 1;
-  // Локалізована назва атрибута (на стороні gateway вже згорнута у
-  // одну рядкову label згідно locale запиту).
+
   string label = 2;
   repeated ShopFilterOption values = 3;
 }