@mamindom/contracts 1.0.140 → 1.0.142

package/dist/proto/seo_filter.proto

@@ -0,0 +1,154 @@
+syntax = "proto3";
+
+package catalog.v1;
+
+import "common.proto";
+
+
+service SeoFilterService {
+  // ─── Public ──────────────────────────────────────────────────────────────
+
+  // Резолв ЧПУ-URL → metadata + canonical. Викликається SSR Next.js для
+  // кожного category/[[...filters]] запиту. Якщо combo не знайдено —
+  // повертає isIndexed=false і автогенерований fallback metadata.
+  rpc ResolveSeoFilter (ResolveSeoFilterRequest) returns (ResolveSeoFilterResponse);
+
+  // ─── Admin ───────────────────────────────────────────────────────────────
+
+  rpc ListSeoFilters (ListSeoFiltersRequest) returns (ListSeoFiltersResponse);
+  rpc GetSeoFilter (GetSeoFilterRequest) returns (SeoFilterResponse);
+  rpc CreateSeoFilter (CreateSeoFilterRequest) returns (SeoFilterResponse);
+  rpc UpdateSeoFilter (UpdateSeoFilterRequest) returns (SeoFilterResponse);
+  rpc DeleteSeoFilter (DeleteSeoFilterRequest) returns (DeleteResponse);
+
+  // Топ-N непокритих combinations (за impressions/popularity) — для
+  // швидкого створення SeoFilter з адмін-форми "Автопідказки".
+  rpc SuggestSeoFilters (SuggestSeoFiltersRequest) returns (SuggestSeoFiltersResponse);
+}
+
+// ─────────────────────────── Domain types ────────────────────────────────
+
+// Частина combo. Однаковий формат і у DB (combo_parts JSON), і у gRPC.
+// type: 'brand'|'price'|'color'|'size'
+message FilterPart {
+  string type = 1;
+  // Для brand/color/size:
+  optional string value_id = 2;
+  optional string value_slug = 3;
+  // Для price:
+  optional int32 price_min = 4;
+  optional int32 price_max = 5;
+}
+
+// Локалізовані поля (uk/ru) у форматі { uk: "...", ru: "..." }.
+message LocaleStrings {
+  string uk = 1;
+  string ru = 2;
+}
+
+message SeoFilterResponse {
+  string id = 1;
+  string category_id = 2;
+  string combo_hash = 3;
+  repeated FilterPart combo_parts = 4;
+  LocaleStrings url_segments = 5;
+  LocaleStrings title = 6;
+  LocaleStrings description = 7;
+  LocaleStrings h1 = 8;
+  bool is_indexed = 9;
+  bool is_auto = 10;
+  int32 popularity = 11;
+  int64 created_at = 12;
+  int64 updated_at = 13;
+}
+
+// ─────────────────────────── Resolve (public) ────────────────────────────
+
+message ResolveSeoFilterRequest {
+  string category_id = 1;
+  // Канонічно відсортовані URL segments як приходять з Next.js, напр.
+  // ["brend-cybex", "cina-1000-5000"]. Caller гарантує що порядок canonical.
+  repeated string url_segments = 2;
+  string locale = 3; // 'uk' | 'ru'
+}
+
+message ResolveSeoFilterResponse {
+  // Якщо false → caller рендерить категорію з noindex,follow.
+  bool found = 1;
+  // Якщо false → caller додає <meta robots="noindex,follow"> навіть якщо
+  // запис знайдено (наприклад, isIndexed=false manual override).
+  bool is_indexed = 2;
+  LocaleStrings title = 3;
+  LocaleStrings description = 4;
+  LocaleStrings h1 = 5;
+  // Canonical-URL-path без host: "/uk/c/koliaski/brend-cybex"
+  string canonical_path = 6;
+  // Денормалізовані combo_parts з resolved valueId — для побудови
+  // запиту до products (categoryId + filter ids).
+  repeated FilterPart resolved_parts = 7;
+}
+
+// ─────────────────────────── List (admin) ────────────────────────────────
+
+message ListSeoFiltersRequest {
+  PaginationRequest pagination = 1;
+  optional string category_id = 2;
+  optional bool is_indexed = 3;
+  optional bool is_auto = 4;
+  // Пошук за uk/ru title (для адмін-фільтра).
+  optional string search = 5;
+}
+
+message ListSeoFiltersResponse {
+  repeated SeoFilterResponse items = 1;
+  PaginationMeta meta = 2;
+}
+
+message GetSeoFilterRequest {
+  string id = 1;
+}
+
+// ─────────────────────────── Create / Update ─────────────────────────────
+
+message CreateSeoFilterRequest {
+  string category_id = 1;
+  repeated FilterPart combo_parts = 2;
+  LocaleStrings title = 3;
+  LocaleStrings description = 4;
+  LocaleStrings h1 = 5;
+  bool is_indexed = 6;
+}
+
+message UpdateSeoFilterRequest {
+  string id = 1;
+  optional LocaleStrings title = 2;
+  optional LocaleStrings description = 3;
+  optional LocaleStrings h1 = 4;
+  optional bool is_indexed = 5;
+}
+
+message DeleteSeoFilterRequest {
+  string id = 1;
+}
+
+// ─────────────────────────── Suggestions (admin) ─────────────────────────
+
+message SuggestSeoFiltersRequest {
+  string category_id = 1;
+  int32 limit = 2; // default 20
+}
+
+message SuggestSeoFilterCandidate {
+  // Запропоновані combo_parts (валідні, з resolved slug).
+  repeated FilterPart combo_parts = 1;
+  // Оцінка популярності: clicks / impressions / товарообіг (single число).
+  int32 score = 2;
+  // Чи існує вже SeoFilter з таким комбо (тоді UI ховає кнопку Create).
+  bool already_exists = 3;
+  // Pre-built canonical URL path для preview.
+  LocaleStrings preview_segments = 4;
+}
+
+message SuggestSeoFiltersResponse {
+  repeated SuggestSeoFilterCandidate items = 1;
+}

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/dist/src/proto/paths.d.ts

@@ -16,6 +16,7 @@ export declare const PROTO_PATHS: {
     readonly BUNDLE: string;
     readonly FILTER: string;
     readonly SEARCH: string;
+    readonly SEO_FILTER: string;
     readonly PICKUP: string;
     readonly PRODUCT_REVIEW: string;
     readonly COMMON_PROMO: string;

package/dist/src/proto/paths.js

@@ -20,6 +20,7 @@ exports.PROTO_PATHS = {
     BUNDLE: (0, node_path_1.join)(__dirname, '../../proto/bundle.proto'),
     FILTER: (0, node_path_1.join)(__dirname, '../../proto/shop_filters.proto'),
     SEARCH: (0, node_path_1.join)(__dirname, '../../proto/search.proto'),
+    SEO_FILTER: (0, node_path_1.join)(__dirname, '../../proto/seo_filter.proto'),
     PICKUP: (0, node_path_1.join)(__dirname, '../../proto/pickup.proto'),
     PRODUCT_REVIEW: (0, node_path_1.join)(__dirname, '../../proto/product_review.proto'),
     COMMON_PROMO: (0, node_path_1.join)(__dirname, '../../proto/common_promo.proto'),

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

@@ -0,0 +1,244 @@
+// 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
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+import { DeleteResponse, PaginationMeta, PaginationRequest } from "./common";
+
+export 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 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 function SeoFilterServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "resolveSeoFilter",
+      "listSeoFilters",
+      "getSeoFilter",
+      "createSeoFilter",
+      "updateSeoFilter",
+      "deleteSeoFilter",
+      "suggestSeoFilters",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("SeoFilterService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("SeoFilterService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const SEO_FILTER_SERVICE_NAME = "SeoFilterService";