@mamindom/contracts 1.0.144 → 1.0.146

package/dist/proto/seo_filter.proto

@@ -6,14 +6,9 @@ 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);
@@ -21,30 +16,24 @@ service SeoFilterService {
   rpc UpdateSeoFilter (UpdateSeoFilterRequest) returns (SeoFilterResponse);
   rpc DeleteSeoFilter (DeleteSeoFilterRequest) returns (DeleteResponse);
 
-  // Топ-N непокритих combinations (за impressions/popularity) — для
-  // швидкого створення SeoFilter з адмін-форми "Автопідказки".
+  
   rpc SuggestSeoFilters (SuggestSeoFiltersRequest) returns (SuggestSeoFiltersResponse);
 
-  // Список усіх індексованих SeoFilter URL — для побудови sitemap.xml.
-  // Повертає одночасно uk+ru сегменти (denormalized) + category slug.
   rpc ListIndexedForSitemap (ListIndexedForSitemapRequest) returns (ListIndexedForSitemapResponse);
 }
 
-// ─────────────────────────── 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;
@@ -66,40 +55,35 @@ message SeoFilterResponse {
   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'
+  string locale = 3;
 }
 
 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;
 }
 
@@ -112,7 +96,6 @@ message GetSeoFilterRequest {
   string id = 1;
 }
 
-// ─────────────────────────── Create / Update ─────────────────────────────
 
 message CreateSeoFilterRequest {
   string category_id = 1;
@@ -135,21 +118,20 @@ message DeleteSeoFilterRequest {
   string id = 1;
 }
 
-// ─────────────────────────── Suggestions (admin) ─────────────────────────
 
 message SuggestSeoFiltersRequest {
   string category_id = 1;
-  int32 limit = 2; // default 20
+  int32 limit = 2;
 }
 
 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;
 }
 
@@ -157,10 +139,9 @@ message SuggestSeoFiltersResponse {
   repeated SuggestSeoFilterCandidate items = 1;
 }
 
-// ─────────────────────────── Sitemap (public) ────────────────────────────
 
 message ListIndexedForSitemapRequest {
-  // Опційний фільтр — для cursor-pagination якщо записів стане багато.
+  
   optional int32 limit = 1;
   optional string after_id = 2;
 }

package/dist/proto/shop_filters.proto

@@ -60,9 +60,7 @@ message ShopFilterOption {
   string value = 1;
   string label = 2;
   int32 count = 3;
-  // slug ОПЦІЙНИЙ — потрібен для побудови ЧПУ-URL фільтрами
-  // (brend-<slug>, kolir-<slug>, rozmir-<slug>). Якщо slug ще не
-  // згенеровано через backfill — пусто, frontend fallback на id.
+  
   optional string slug = 4;
 }
 

package/dist/proto/users.proto

@@ -31,24 +31,24 @@ service UsersService {
   rpc ExportUserData(ExportUserDataRequest) returns (ExportUserDataResponse);
   rpc DeleteAccount(DeleteAccountRequest) returns (DeleteAccountResponse);
 
-  // Family
+  
   rpc GetFamily(GetFamilyRequest) returns (GetFamilyResponse);
   rpc AddChild(AddChildRequest) returns (ChildResponse);
   rpc UpdateChild(UpdateChildRequest) returns (ChildResponse);
   rpc RemoveChild(RemoveChildRequest) returns (RemoveChildResponse);
 
-  // Pregnancy
+  
   rpc GetPregnancy(GetPregnancyRequest) returns (GetPregnancyResponse);
   rpc UpdatePregnancy(UpdatePregnancyRequest) returns (GetPregnancyResponse);
 
-  // Cart
+ 
   rpc GetCart(GetCartRequest) returns (GetCartResponse);
   rpc UpsertCartItem(UpsertCartItemRequest) returns (GetCartResponse);
   rpc RemoveCartItem(RemoveCartItemRequest) returns (GetCartResponse);
   rpc ClearCart(ClearCartRequest) returns (ClearCartResponse);
   rpc SyncCart(SyncCartRequest) returns (GetCartResponse);
 
-  // Admin CRM — редагування клієнта менеджером (customers.edit на gateway).
+  
   rpc AdminUpdateCustomer(AdminUpdateCustomerRequest) returns (AdminUpdateCustomerResponse);
 }
 
@@ -97,7 +97,7 @@ message AdminUpdateCustomerRequest {
   string id = 1;
   optional string first_name = 2;
   optional string last_name = 3;
-  // internal_note редагується тут окремо, бо це CRM-поле — не видиме клієнту.
+  
   optional string internal_note = 4;
 }
 
@@ -249,7 +249,6 @@ message DeleteAccountResponse {
   bool ok = 1;
 }
 
-// ── Family ───────────────────────────────────────────────────────────────────
 
 enum Gender {
   BOY = 0;
@@ -300,7 +299,6 @@ message RemoveChildResponse {
   bool ok = 1;
 }
 
-// ── Pregnancy ────────────────────────────────────────────────────────────────
 
 message GetPregnancyRequest {
   string user_id = 1;
@@ -315,7 +313,6 @@ message UpdatePregnancyRequest {
   int32 week = 2;
 }
 
-// ── Cart ─────────────────────────────────────────────────────────────────────
 
 message CartItemVariant {
   string key = 1;

package/dist/proto/warehouse.proto

@@ -0,0 +1,38 @@
+syntax = "proto3";
+
+package catalog.v1;
+
+
+service WarehouseService {
+  rpc UpsertWarehouses (UpsertWarehousesRequest) returns (UpsertWarehousesResponse);
+}
+
+message WarehouseSyncItem {
+  string warehouse_guid = 1;
+  string name = 2;
+  
+  string code1c = 3;
+  optional string pf_code = 4;
+  optional string address = 5;
+  optional string phone = 6;
+
+  optional bool is_retail = 7;
+}
+
+message UpsertWarehousesRequest {
+  repeated WarehouseSyncItem items = 1;
+  string sync_id = 2;
+
+  string online_warehouse_code = 3;
+}
+
+message WarehouseUpsertResult {
+  string guid = 1;
+  string status = 2;           
+  optional string reason = 3;
+  optional string id = 4;      
+}
+
+message UpsertWarehousesResponse {
+  repeated WarehouseUpsertResult results = 1;
+}

package/dist/src/proto/paths.d.ts

@@ -19,6 +19,7 @@ export declare const PROTO_PATHS: {
     readonly SEO_FILTER: string;
     readonly PICKUP: string;
     readonly PRODUCT_REVIEW: string;
+    readonly WAREHOUSE: string;
     readonly COMMON_PROMO: string;
     readonly CALCULATION: string;
     readonly COUPON: string;

package/dist/src/proto/paths.js

@@ -23,6 +23,7 @@ exports.PROTO_PATHS = {
     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'),
+    WAREHOUSE: (0, node_path_1.join)(__dirname, '../../proto/warehouse.proto'),
     COMMON_PROMO: (0, node_path_1.join)(__dirname, '../../proto/common_promo.proto'),
     CALCULATION: (0, node_path_1.join)(__dirname, '../../proto/calculation.proto'),
     COUPON: (0, node_path_1.join)(__dirname, '../../proto/coupon.proto'),

package/gen/attribute.ts

@@ -11,6 +11,47 @@ import { DeleteResponse, PaginationMeta, PaginationRequest, SuccessResponse } fr
 
 export const protobufPackage = "catalog.v1";
 
+export interface AttributeSyncValueItem {
+  valueGuid: string;
+  value: { [key: string]: string };
+}
+
+export interface AttributeSyncValueItem_ValueEntry {
+  key: string;
+  value: string;
+}
+
+export interface AttributeSyncItem {
+  propertyGuid: string;
+  name: { [key: string]: string };
+  isColor: boolean;
+  values: AttributeSyncValueItem[];
+}
+
+export interface AttributeSyncItem_NameEntry {
+  key: string;
+  value: string;
+}
+
+export interface UpsertAttributesRequest {
+  items: AttributeSyncItem[];
+  syncId: string;
+}
+
+export interface AttributeUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+  id?: string | undefined;
+  valuesCreated: number;
+  valuesUpdated: number;
+  valuesFailed: number;
+}
+
+export interface UpsertAttributesResponse {
+  results: AttributeUpsertResult[];
+}
+
 export interface GetAllAttributesWithValuesRequest {
 }
 
@@ -240,6 +281,8 @@ export interface AttributeServiceClient {
   getAllAttributesWithValues(
     request: GetAllAttributesWithValuesRequest,
   ): Observable<GetAllAttributesWithValuesResponse>;
+
+  upsertAttributes(request: UpsertAttributesRequest): Observable<UpsertAttributesResponse>;
 }
 
 export interface AttributeServiceController {
@@ -313,6 +356,10 @@ export interface AttributeServiceController {
     | Promise<GetAllAttributesWithValuesResponse>
     | Observable<GetAllAttributesWithValuesResponse>
     | GetAllAttributesWithValuesResponse;
+
+  upsertAttributes(
+    request: UpsertAttributesRequest,
+  ): Promise<UpsertAttributesResponse> | Observable<UpsertAttributesResponse> | UpsertAttributesResponse;
 }
 
 export function AttributeServiceControllerMethods() {
@@ -335,6 +382,7 @@ export function AttributeServiceControllerMethods() {
       "bindAttributeToCategory",
       "unbindAttributeFromCategory",
       "getAllAttributesWithValues",
+      "upsertAttributes",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/brand.ts

@@ -11,6 +11,27 @@ import { DeleteResponse, PaginationMeta, PaginationRequest } from "./common";
 
 export const protobufPackage = "catalog.v1";
 
+export interface BrandSyncItem {
+  brandGuid: string;
+  name: string;
+}
+
+export interface UpsertBrandsRequest {
+  items: BrandSyncItem[];
+  syncId: string;
+}
+
+export interface BrandUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+  id?: string | undefined;
+}
+
+export interface UpsertBrandsResponse {
+  results: BrandUpsertResult[];
+}
+
 export interface BrandResponse {
   id: string;
   slug: string;
@@ -123,6 +144,8 @@ export interface BrandServiceClient {
   updateBrand(request: UpdateBrandRequest): Observable<BrandResponse>;
 
   deleteBrand(request: DeleteBrandRequest): Observable<DeleteResponse>;
+
+  upsertBrands(request: UpsertBrandsRequest): Observable<UpsertBrandsResponse>;
 }
 
 export interface BrandServiceController {
@@ -135,11 +158,22 @@ export interface BrandServiceController {
   updateBrand(request: UpdateBrandRequest): Promise<BrandResponse> | Observable<BrandResponse> | BrandResponse;
 
   deleteBrand(request: DeleteBrandRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+
+  upsertBrands(
+    request: UpsertBrandsRequest,
+  ): Promise<UpsertBrandsResponse> | Observable<UpsertBrandsResponse> | UpsertBrandsResponse;
 }
 
 export function BrandServiceControllerMethods() {
   return function (constructor: Function) {
-    const grpcMethods: string[] = ["getBrands", "getBrand", "createBrand", "updateBrand", "deleteBrand"];
+    const grpcMethods: string[] = [
+      "getBrands",
+      "getBrand",
+      "createBrand",
+      "updateBrand",
+      "deleteBrand",
+      "upsertBrands",
+    ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
       GrpcMethod("BrandService", method)(constructor.prototype[method], method, descriptor);

package/gen/bundle.ts

@@ -255,10 +255,7 @@ export interface CloneBundleRequest {
 
 export interface ExportBundlesRequest {
   status?: BundleStatus | undefined;
-  bundleType?:
-    | BundleType
-    | undefined;
-  /** "json" | "csv" */
+  bundleType?: BundleType | undefined;
   format: string;
 }
 
@@ -287,7 +284,6 @@ export interface BundleListItemResponse {
   originalPrice: number;
   finalPrice: number;
   inStock: boolean;
-  /** NEW */
   bundleType: BundleType;
   displayPlacements: DisplayPlacement[];
 }

package/gen/cart.ts

@@ -74,10 +74,6 @@ export interface DeliveryDraft {
   pickupPointId: string;
   cost: number;
   freeShipping: boolean;
-  /**
-   * Область з City.region — клієнт передає при виборі міста, щоб
-   * потім order-service зміг записати в snapshot замовлення.
-   */
   region: string;
 }
 
@@ -213,22 +209,12 @@ export interface SetCommentRequest {
 }
 
 export interface SetCheckoutDraftRequest {
-  owner:
-    | CartOwner
-    | undefined;
-  /**
-   * Усі поля опціональні — оновлюються лише ті, що передані (proto3 default
-   * означає "не міняти"). Recalculate виконується одноразово в кінці.
-   */
+  owner: CartOwner | undefined;
   recipient: Recipient | undefined;
   delivery: DeliveryDraft | undefined;
   payment: PaymentDraft | undefined;
   comment: string;
   doNotCall: boolean;
-  /**
-   * Прапори "очистити поле" — щоб відрізнити default proto-значення
-   * від явного запиту прибрати, бо у proto3 порожній string === unset.
-   */
   hasRecipient: boolean;
   hasDelivery: boolean;
   hasPayment: boolean;
@@ -281,11 +267,6 @@ export interface CartServiceClient {
 
   removePromo(request: RemovePromoRequest): Observable<CartResponse>;
 
-  /**
-   * ApplyCertificate — поки stub. Реальна перевірка номіналу/балансу
-   * потребує синхронізації з 1С (фаза інтеграцій).
-   */
-
   applyCertificate(request: ApplyCertificateRequest): Observable<CartResponse>;
 
   removeCertificate(request: RemoveCertificateRequest): Observable<CartResponse>;
@@ -302,11 +283,6 @@ export interface CartServiceClient {
 
   setComment(request: SetCommentRequest): Observable<CartResponse>;
 
-  /**
-   * Batch-set всіх checkout-полів одним викликом + ОДИН Recalculate.
-   * Фронт під час оформлення замовлення викликає це замість 4 окремих set-*.
-   */
-
   setCheckoutDraft(request: SetCheckoutDraftRequest): Observable<CartResponse>;
 
   recalculate(request: RecalculateRequest): Observable<CartResponse>;
@@ -335,11 +311,6 @@ export interface CartServiceController {
 
   removePromo(request: RemovePromoRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
 
-  /**
-   * ApplyCertificate — поки stub. Реальна перевірка номіналу/балансу
-   * потребує синхронізації з 1С (фаза інтеграцій).
-   */
-
   applyCertificate(request: ApplyCertificateRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
 
   removeCertificate(request: RemoveCertificateRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
@@ -356,11 +327,6 @@ export interface CartServiceController {
 
   setComment(request: SetCommentRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
 
-  /**
-   * Batch-set всіх checkout-полів одним викликом + ОДИН Recalculate.
-   * Фронт під час оформлення замовлення викликає це замість 4 окремих set-*.
-   */
-
   setCheckoutDraft(request: SetCheckoutDraftRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
 
   recalculate(request: RecalculateRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;

package/gen/category.ts

@@ -11,6 +11,33 @@ import { DeleteResponse, SuccessResponse } from "./common";
 
 export const protobufPackage = "catalog.v1";
 
+export interface CategorySyncItem {
+  categoryGuid: string;
+  parentGuid?: string | undefined;
+  name: { [key: string]: string };
+}
+
+export interface CategorySyncItem_NameEntry {
+  key: string;
+  value: string;
+}
+
+export interface UpsertCategoriesRequest {
+  items: CategorySyncItem[];
+  syncId: string;
+}
+
+export interface CategoryUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+  id?: string | undefined;
+}
+
+export interface UpsertCategoriesResponse {
+  results: CategoryUpsertResult[];
+}
+
 export interface GetAllCategoriesRequest {
 }
 
@@ -209,6 +236,8 @@ export interface CategoryAdminServiceClient {
   updateCategoryOrder(request: UpdateCategoryOrderRequest): Observable<SuccessResponse>;
 
   getAllCategories(request: GetAllCategoriesRequest): Observable<GetAllCategoriesResponse>;
+
+  upsertCategories(request: UpsertCategoriesRequest): Observable<UpsertCategoriesResponse>;
 }
 
 export interface CategoryAdminServiceController {
@@ -235,6 +264,10 @@ export interface CategoryAdminServiceController {
   getAllCategories(
     request: GetAllCategoriesRequest,
   ): Promise<GetAllCategoriesResponse> | Observable<GetAllCategoriesResponse> | GetAllCategoriesResponse;
+
+  upsertCategories(
+    request: UpsertCategoriesRequest,
+  ): Promise<UpsertCategoriesResponse> | Observable<UpsertCategoriesResponse> | UpsertCategoriesResponse;
 }
 
 export function CategoryAdminServiceControllerMethods() {
@@ -247,6 +280,7 @@ export function CategoryAdminServiceControllerMethods() {
       "deleteCategory",
       "updateCategoryOrder",
       "getAllCategories",
+      "upsertCategories",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/delivery.ts

@@ -94,7 +94,6 @@ export interface ListAreasResponse {
 export interface ListWarehousesRequest {
   carrier: string;
   cityRef: string;
-  /** warehouse | postomat | both */
   type: string;
   query: string;
   limit: number;

package/gen/delivery_settings.ts

@@ -11,13 +11,9 @@ import { Observable } from "rxjs";
 export const protobufPackage = "delivery.v1";
 
 export interface DeliverySettingsResponse {
-  /** Дефолтна вага позиції у кг — fallback коли catalog не повертає weight. */
   defaultItemWeightKg: number;
-  /** Поріг безкоштовної доставки в грн (0 = вимкнено). */
   freeShippingThreshold: number;
-  /** Дефолтна оголошена вартість на одиницю товару у грн (для страхування НП). */
   defaultDeclaredValue: number;
-  /** Reference відправника у НП (вибране warehouse адміністратором у settings). */
   npSenderWarehouseRef?: string | undefined;
   updatedAt: string;
 }

package/gen/faq.ts

@@ -193,14 +193,10 @@ export interface BulkSetPopularFaqRequest {
 export const CONTENT_V1_PACKAGE_NAME = "content.v1";
 
 export interface FaqServiceClient {
-  /** Storefront */
-
   getFaqStorefront(request: GetFaqStorefrontRequest): Observable<GetFaqStorefrontResponse>;
 
   searchFaq(request: SearchFaqRequest): Observable<SearchFaqResponse>;
 
-  /** Admin — categories */
-
   getFaqCategories(request: GetFaqCategoriesRequest): Observable<GetFaqCategoriesResponse>;
 
   getFaqCategory(request: FaqCategoryIdRequest): Observable<FaqCategoryResponse>;
@@ -213,8 +209,6 @@ export interface FaqServiceClient {
 
   reorderFaqCategories(request: ReorderFaqRequest): Observable<SuccessResponse>;
 
-  /** Admin — items */
-
   getFaqItems(request: GetFaqItemsRequest): Observable<GetFaqItemsResponse>;
 
   getFaqItem(request: FaqItemIdRequest): Observable<FaqItemResponse>;
@@ -231,16 +225,12 @@ export interface FaqServiceClient {
 }
 
 export interface FaqServiceController {
-  /** Storefront */
-
   getFaqStorefront(
     request: GetFaqStorefrontRequest,
   ): Promise<GetFaqStorefrontResponse> | Observable<GetFaqStorefrontResponse> | GetFaqStorefrontResponse;
 
   searchFaq(request: SearchFaqRequest): Promise<SearchFaqResponse> | Observable<SearchFaqResponse> | SearchFaqResponse;
 
-  /** Admin — categories */
-
   getFaqCategories(
     request: GetFaqCategoriesRequest,
   ): Promise<GetFaqCategoriesResponse> | Observable<GetFaqCategoriesResponse> | GetFaqCategoriesResponse;
@@ -265,8 +255,6 @@ export interface FaqServiceController {
     request: ReorderFaqRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
-  /** Admin — items */
-
   getFaqItems(
     request: GetFaqItemsRequest,
   ): Promise<GetFaqItemsResponse> | Observable<GetFaqItemsResponse> | GetFaqItemsResponse;