@mamindom/contracts 1.0.140 → 1.0.142

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/seo_filter.d.ts

@@ -0,0 +1,157 @@
+import { Observable } from "rxjs";
+import { DeleteResponse, PaginationMeta, PaginationRequest } from "./common";
+export declare const protobufPackage = "catalog.v1";
+/**
+ * Частина combo. Однаковий формат і у DB (combo_parts JSON), і у gRPC.
+ * type: 'brand'|'price'|'color'|'size'
+ */
+export interface FilterPart {
+    type: string;
+    /** Для brand/color/size: */
+    valueId?: string | undefined;
+    valueSlug?: string | undefined;
+    /** Для price: */
+    priceMin?: number | undefined;
+    priceMax?: number | undefined;
+}
+/** Локалізовані поля (uk/ru) у форматі { uk: "...", ru: "..." }. */
+export interface LocaleStrings {
+    uk: string;
+    ru: string;
+}
+export interface SeoFilterResponse {
+    id: string;
+    categoryId: string;
+    comboHash: string;
+    comboParts: FilterPart[];
+    urlSegments: LocaleStrings | undefined;
+    title: LocaleStrings | undefined;
+    description: LocaleStrings | undefined;
+    h1: LocaleStrings | undefined;
+    isIndexed: boolean;
+    isAuto: boolean;
+    popularity: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ResolveSeoFilterRequest {
+    categoryId: string;
+    /**
+     * Канонічно відсортовані URL segments як приходять з Next.js, напр.
+     * ["brend-cybex", "cina-1000-5000"]. Caller гарантує що порядок canonical.
+     */
+    urlSegments: string[];
+    /** 'uk' | 'ru' */
+    locale: string;
+}
+export interface ResolveSeoFilterResponse {
+    /** Якщо false → caller рендерить категорію з noindex,follow. */
+    found: boolean;
+    /**
+     * Якщо false → caller додає <meta robots="noindex,follow"> навіть якщо
+     * запис знайдено (наприклад, isIndexed=false manual override).
+     */
+    isIndexed: boolean;
+    title: LocaleStrings | undefined;
+    description: LocaleStrings | undefined;
+    h1: LocaleStrings | undefined;
+    /** Canonical-URL-path без host: "/uk/c/koliaski/brend-cybex" */
+    canonicalPath: string;
+    /**
+     * Денормалізовані combo_parts з resolved valueId — для побудови
+     * запиту до products (categoryId + filter ids).
+     */
+    resolvedParts: FilterPart[];
+}
+export interface ListSeoFiltersRequest {
+    pagination: PaginationRequest | undefined;
+    categoryId?: string | undefined;
+    isIndexed?: boolean | undefined;
+    isAuto?: boolean | undefined;
+    /** Пошук за uk/ru title (для адмін-фільтра). */
+    search?: string | undefined;
+}
+export interface ListSeoFiltersResponse {
+    items: SeoFilterResponse[];
+    meta: PaginationMeta | undefined;
+}
+export interface GetSeoFilterRequest {
+    id: string;
+}
+export interface CreateSeoFilterRequest {
+    categoryId: string;
+    comboParts: FilterPart[];
+    title: LocaleStrings | undefined;
+    description: LocaleStrings | undefined;
+    h1: LocaleStrings | undefined;
+    isIndexed: boolean;
+}
+export interface UpdateSeoFilterRequest {
+    id: string;
+    title?: LocaleStrings | undefined;
+    description?: LocaleStrings | undefined;
+    h1?: LocaleStrings | undefined;
+    isIndexed?: boolean | undefined;
+}
+export interface DeleteSeoFilterRequest {
+    id: string;
+}
+export interface SuggestSeoFiltersRequest {
+    categoryId: string;
+    /** default 20 */
+    limit: number;
+}
+export interface SuggestSeoFilterCandidate {
+    /** Запропоновані combo_parts (валідні, з resolved slug). */
+    comboParts: FilterPart[];
+    /** Оцінка популярності: clicks / impressions / товарообіг (single число). */
+    score: number;
+    /** Чи існує вже SeoFilter з таким комбо (тоді UI ховає кнопку Create). */
+    alreadyExists: boolean;
+    /** Pre-built canonical URL path для preview. */
+    previewSegments: LocaleStrings | undefined;
+}
+export interface SuggestSeoFiltersResponse {
+    items: SuggestSeoFilterCandidate[];
+}
+export declare const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
+/** ─── Public ────────────────────────────────────────────────────────────── */
+export interface SeoFilterServiceClient {
+    /**
+     * Резолв ЧПУ-URL → metadata + canonical. Викликається SSR Next.js для
+     * кожного category/[[...filters]] запиту. Якщо combo не знайдено —
+     * повертає isIndexed=false і автогенерований fallback metadata.
+     */
+    resolveSeoFilter(request: ResolveSeoFilterRequest): Observable<ResolveSeoFilterResponse>;
+    listSeoFilters(request: ListSeoFiltersRequest): Observable<ListSeoFiltersResponse>;
+    getSeoFilter(request: GetSeoFilterRequest): Observable<SeoFilterResponse>;
+    createSeoFilter(request: CreateSeoFilterRequest): Observable<SeoFilterResponse>;
+    updateSeoFilter(request: UpdateSeoFilterRequest): Observable<SeoFilterResponse>;
+    deleteSeoFilter(request: DeleteSeoFilterRequest): Observable<DeleteResponse>;
+    /**
+     * Топ-N непокритих combinations (за impressions/popularity) — для
+     * швидкого створення SeoFilter з адмін-форми "Автопідказки".
+     */
+    suggestSeoFilters(request: SuggestSeoFiltersRequest): Observable<SuggestSeoFiltersResponse>;
+}
+/** ─── Public ────────────────────────────────────────────────────────────── */
+export interface SeoFilterServiceController {
+    /**
+     * Резолв ЧПУ-URL → metadata + canonical. Викликається SSR Next.js для
+     * кожного category/[[...filters]] запиту. Якщо combo не знайдено —
+     * повертає isIndexed=false і автогенерований fallback metadata.
+     */
+    resolveSeoFilter(request: ResolveSeoFilterRequest): Promise<ResolveSeoFilterResponse> | Observable<ResolveSeoFilterResponse> | ResolveSeoFilterResponse;
+    listSeoFilters(request: ListSeoFiltersRequest): Promise<ListSeoFiltersResponse> | Observable<ListSeoFiltersResponse> | ListSeoFiltersResponse;
+    getSeoFilter(request: GetSeoFilterRequest): Promise<SeoFilterResponse> | Observable<SeoFilterResponse> | SeoFilterResponse;
+    createSeoFilter(request: CreateSeoFilterRequest): Promise<SeoFilterResponse> | Observable<SeoFilterResponse> | SeoFilterResponse;
+    updateSeoFilter(request: UpdateSeoFilterRequest): Promise<SeoFilterResponse> | Observable<SeoFilterResponse> | SeoFilterResponse;
+    deleteSeoFilter(request: DeleteSeoFilterRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+    /**
+     * Топ-N непокритих combinations (за impressions/popularity) — для
+     * швидкого створення SeoFilter з адмін-форми "Автопідказки".
+     */
+    suggestSeoFilters(request: SuggestSeoFiltersRequest): Promise<SuggestSeoFiltersResponse> | Observable<SuggestSeoFiltersResponse> | SuggestSeoFiltersResponse;
+}
+export declare function SeoFilterServiceControllerMethods(): (constructor: Function) => void;
+export declare const SEO_FILTER_SERVICE_NAME = "SeoFilterService";

package/dist/gen/seo_filter.js

@@ -0,0 +1,36 @@
+"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: seo_filter.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEO_FILTER_SERVICE_NAME = exports.CATALOG_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
+exports.SeoFilterServiceControllerMethods = SeoFilterServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "catalog.v1";
+exports.CATALOG_V1_PACKAGE_NAME = "catalog.v1";
+function SeoFilterServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "resolveSeoFilter",
+            "listSeoFilters",
+            "getSeoFilter",
+            "createSeoFilter",
+            "updateSeoFilter",
+            "deleteSeoFilter",
+            "suggestSeoFilters",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("SeoFilterService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("SeoFilterService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.SEO_FILTER_SERVICE_NAME = "SeoFilterService";

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);