@mamindom/contracts 1.0.144 → 1.0.146

package/dist/gen/search.d.ts

@@ -8,18 +8,14 @@ export declare enum SynonymType {
 }
 export interface SuggestRequest {
     q: string;
-    /** 1..20, default 8 */
     limit: number;
-    /** default true */
     onlyInStock: boolean;
-    /** 'uk' | 'ru', default 'uk' */
     locale: string;
 }
 export interface SuggestProduct {
     id: string;
     sku: string;
     slug: string;
-    /** already локалізована (uk/ru) */
     name: string;
     mainImage: string;
     price: number;
@@ -39,7 +35,6 @@ export interface SuggestResponse {
     products: SuggestProduct[];
     categories: SuggestCategory[];
     popularQueries: string[];
-    /** загальна кількість збігів у продуктах */
     total: number;
 }
 export interface SynonymResponse {
@@ -117,7 +112,6 @@ export interface ReorderPopularQueryItem {
     sortOrder: number;
 }
 export interface ListZeroResultsRequest {
-    /** default 100, max 500 */
     limit?: number | undefined;
 }
 export interface ZeroResultItem {
@@ -131,40 +125,32 @@ export interface ClearZeroResultsRequest {
 }
 export declare const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
 export interface SearchServiceClient {
-    /** ─── Public (autocomplete) ─────────────────────────────────────────────── */
     suggest(request: SuggestRequest): Observable<SuggestResponse>;
-    /** ─── Admin: synonyms ───────────────────────────────────────────────────── */
     listSynonyms(request: ListSynonymsRequest): Observable<ListSynonymsResponse>;
     createSynonym(request: CreateSynonymRequest): Observable<SynonymResponse>;
     updateSynonym(request: UpdateSynonymRequest): Observable<SynonymResponse>;
     deleteSynonym(request: DeleteSynonymRequest): Observable<DeleteResponse>;
     syncSynonymsToTypesense(request: SyncSynonymsRequest): Observable<SuccessResponse>;
-    /** ─── Admin: popular queries ────────────────────────────────────────────── */
     listPopularQueries(request: ListPopularQueriesRequest): Observable<ListPopularQueriesResponse>;
     createPopularQuery(request: CreatePopularQueryRequest): Observable<PopularQueryResponse>;
     updatePopularQuery(request: UpdatePopularQueryRequest): Observable<PopularQueryResponse>;
     deletePopularQuery(request: DeletePopularQueryRequest): Observable<DeleteResponse>;
     reorderPopularQueries(request: ReorderPopularQueriesRequest): Observable<SuccessResponse>;
-    /** ─── Admin: zero-result analytics ──────────────────────────────────────── */
     listZeroResults(request: ListZeroResultsRequest): Observable<ListZeroResultsResponse>;
     clearZeroResults(request: ClearZeroResultsRequest): Observable<SuccessResponse>;
 }
 export interface SearchServiceController {
-    /** ─── Public (autocomplete) ─────────────────────────────────────────────── */
     suggest(request: SuggestRequest): Promise<SuggestResponse> | Observable<SuggestResponse> | SuggestResponse;
-    /** ─── Admin: synonyms ───────────────────────────────────────────────────── */
     listSynonyms(request: ListSynonymsRequest): Promise<ListSynonymsResponse> | Observable<ListSynonymsResponse> | ListSynonymsResponse;
     createSynonym(request: CreateSynonymRequest): Promise<SynonymResponse> | Observable<SynonymResponse> | SynonymResponse;
     updateSynonym(request: UpdateSynonymRequest): Promise<SynonymResponse> | Observable<SynonymResponse> | SynonymResponse;
     deleteSynonym(request: DeleteSynonymRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
     syncSynonymsToTypesense(request: SyncSynonymsRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
-    /** ─── Admin: popular queries ────────────────────────────────────────────── */
     listPopularQueries(request: ListPopularQueriesRequest): Promise<ListPopularQueriesResponse> | Observable<ListPopularQueriesResponse> | ListPopularQueriesResponse;
     createPopularQuery(request: CreatePopularQueryRequest): Promise<PopularQueryResponse> | Observable<PopularQueryResponse> | PopularQueryResponse;
     updatePopularQuery(request: UpdatePopularQueryRequest): Promise<PopularQueryResponse> | Observable<PopularQueryResponse> | PopularQueryResponse;
     deletePopularQuery(request: DeletePopularQueryRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
     reorderPopularQueries(request: ReorderPopularQueriesRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
-    /** ─── Admin: zero-result analytics ──────────────────────────────────────── */
     listZeroResults(request: ListZeroResultsRequest): Promise<ListZeroResultsResponse> | Observable<ListZeroResultsResponse> | ListZeroResultsResponse;
     clearZeroResults(request: ClearZeroResultsRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 }

package/dist/gen/seo_filter.d.ts

@@ -1,20 +1,13 @@
 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;
@@ -36,31 +29,16 @@ export interface SeoFilterResponse {
 }
 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 {
@@ -68,7 +46,6 @@ export interface ListSeoFiltersRequest {
     categoryId?: string | undefined;
     isIndexed?: boolean | undefined;
     isAuto?: boolean | undefined;
-    /** Пошук за uk/ru title (для адмін-фільтра). */
     search?: string | undefined;
 }
 export interface ListSeoFiltersResponse {
@@ -98,24 +75,18 @@ export interface DeleteSeoFilterRequest {
 }
 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 interface ListIndexedForSitemapRequest {
-    /** Опційний фільтр — для cursor-pagination якщо записів стане багато. */
     limit?: number | undefined;
     afterId?: string | undefined;
 }
@@ -130,52 +101,24 @@ export interface ListIndexedForSitemapResponse {
     nextAfterId?: string | undefined;
 }
 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>;
-    /**
-     * Список усіх індексованих SeoFilter URL — для побудови sitemap.xml.
-     * Повертає одночасно uk+ru сегменти (denormalized) + category slug.
-     */
     listIndexedForSitemap(request: ListIndexedForSitemapRequest): Observable<ListIndexedForSitemapResponse>;
 }
-/** ─── 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;
-    /**
-     * Список усіх індексованих SeoFilter URL — для побудови sitemap.xml.
-     * Повертає одночасно uk+ru сегменти (denormalized) + category slug.
-     */
     listIndexedForSitemap(request: ListIndexedForSitemapRequest): Promise<ListIndexedForSitemapResponse> | Observable<ListIndexedForSitemapResponse> | ListIndexedForSitemapResponse;
 }
 export declare function SeoFilterServiceControllerMethods(): (constructor: Function) => void;

package/dist/gen/shop_filters.d.ts

@@ -34,11 +34,6 @@ export interface ShopFilterOption {
     value: string;
     label: string;
     count: number;
-    /**
-     * slug ОПЦІЙНИЙ — потрібен для побудови ЧПУ-URL фільтрами
-     * (brend-<slug>, kolir-<slug>, rozmir-<slug>). Якщо slug ще не
-     * згенеровано через backfill — пусто, frontend fallback на id.
-     */
     slug?: string | undefined;
 }
 export interface ShopFilterColorOption {

package/dist/gen/users.d.ts

@@ -50,7 +50,6 @@ export interface AdminUpdateCustomerRequest {
     id: string;
     firstName?: string | undefined;
     lastName?: string | undefined;
-    /** internal_note редагується тут окремо, бо це CRM-поле — не видиме клієнту. */
     internalNote?: string | undefined;
 }
 export interface AdminUpdateCustomerResponse {
@@ -277,21 +276,17 @@ export interface UsersServiceClient {
     clearViewedHistory(request: ClearViewedHistoryRequest): Observable<ClearViewedHistoryResponse>;
     exportUserData(request: ExportUserDataRequest): Observable<ExportUserDataResponse>;
     deleteAccount(request: DeleteAccountRequest): Observable<DeleteAccountResponse>;
-    /** Family */
     getFamily(request: GetFamilyRequest): Observable<GetFamilyResponse>;
     addChild(request: AddChildRequest): Observable<ChildResponse>;
     updateChild(request: UpdateChildRequest): Observable<ChildResponse>;
     removeChild(request: RemoveChildRequest): Observable<RemoveChildResponse>;
-    /** Pregnancy */
     getPregnancy(request: GetPregnancyRequest): Observable<GetPregnancyResponse>;
     updatePregnancy(request: UpdatePregnancyRequest): Observable<GetPregnancyResponse>;
-    /** Cart */
     getCart(request: GetCartRequest): Observable<GetCartResponse>;
     upsertCartItem(request: UpsertCartItemRequest): Observable<GetCartResponse>;
     removeCartItem(request: RemoveCartItemRequest): Observable<GetCartResponse>;
     clearCart(request: ClearCartRequest): Observable<ClearCartResponse>;
     syncCart(request: SyncCartRequest): Observable<GetCartResponse>;
-    /** Admin CRM — редагування клієнта менеджером (customers.edit на gateway). */
     adminUpdateCustomer(request: AdminUpdateCustomerRequest): Observable<AdminUpdateCustomerResponse>;
 }
 export interface UsersServiceController {
@@ -311,21 +306,17 @@ export interface UsersServiceController {
     clearViewedHistory(request: ClearViewedHistoryRequest): Promise<ClearViewedHistoryResponse> | Observable<ClearViewedHistoryResponse> | ClearViewedHistoryResponse;
     exportUserData(request: ExportUserDataRequest): Promise<ExportUserDataResponse> | Observable<ExportUserDataResponse> | ExportUserDataResponse;
     deleteAccount(request: DeleteAccountRequest): Promise<DeleteAccountResponse> | Observable<DeleteAccountResponse> | DeleteAccountResponse;
-    /** Family */
     getFamily(request: GetFamilyRequest): Promise<GetFamilyResponse> | Observable<GetFamilyResponse> | GetFamilyResponse;
     addChild(request: AddChildRequest): Promise<ChildResponse> | Observable<ChildResponse> | ChildResponse;
     updateChild(request: UpdateChildRequest): Promise<ChildResponse> | Observable<ChildResponse> | ChildResponse;
     removeChild(request: RemoveChildRequest): Promise<RemoveChildResponse> | Observable<RemoveChildResponse> | RemoveChildResponse;
-    /** Pregnancy */
     getPregnancy(request: GetPregnancyRequest): Promise<GetPregnancyResponse> | Observable<GetPregnancyResponse> | GetPregnancyResponse;
     updatePregnancy(request: UpdatePregnancyRequest): Promise<GetPregnancyResponse> | Observable<GetPregnancyResponse> | GetPregnancyResponse;
-    /** Cart */
     getCart(request: GetCartRequest): Promise<GetCartResponse> | Observable<GetCartResponse> | GetCartResponse;
     upsertCartItem(request: UpsertCartItemRequest): Promise<GetCartResponse> | Observable<GetCartResponse> | GetCartResponse;
     removeCartItem(request: RemoveCartItemRequest): Promise<GetCartResponse> | Observable<GetCartResponse> | GetCartResponse;
     clearCart(request: ClearCartRequest): Promise<ClearCartResponse> | Observable<ClearCartResponse> | ClearCartResponse;
     syncCart(request: SyncCartRequest): Promise<GetCartResponse> | Observable<GetCartResponse> | GetCartResponse;
-    /** Admin CRM — редагування клієнта менеджером (customers.edit на gateway). */
     adminUpdateCustomer(request: AdminUpdateCustomerRequest): Promise<AdminUpdateCustomerResponse> | Observable<AdminUpdateCustomerResponse> | AdminUpdateCustomerResponse;
 }
 export declare function UsersServiceControllerMethods(): (constructor: Function) => void;

package/dist/gen/warehouse.d.ts

@@ -0,0 +1,34 @@
+import { Observable } from "rxjs";
+export declare const protobufPackage = "catalog.v1";
+export interface WarehouseSyncItem {
+    warehouseGuid: string;
+    name: string;
+    code1c: string;
+    pfCode?: string | undefined;
+    address?: string | undefined;
+    phone?: string | undefined;
+    isRetail?: boolean | undefined;
+}
+export interface UpsertWarehousesRequest {
+    items: WarehouseSyncItem[];
+    syncId: string;
+    onlineWarehouseCode: string;
+}
+export interface WarehouseUpsertResult {
+    guid: string;
+    status: string;
+    reason?: string | undefined;
+    id?: string | undefined;
+}
+export interface UpsertWarehousesResponse {
+    results: WarehouseUpsertResult[];
+}
+export declare const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
+export interface WarehouseServiceClient {
+    upsertWarehouses(request: UpsertWarehousesRequest): Observable<UpsertWarehousesResponse>;
+}
+export interface WarehouseServiceController {
+    upsertWarehouses(request: UpsertWarehousesRequest): Promise<UpsertWarehousesResponse> | Observable<UpsertWarehousesResponse> | UpsertWarehousesResponse;
+}
+export declare function WarehouseServiceControllerMethods(): (constructor: Function) => void;
+export declare const WAREHOUSE_SERVICE_NAME = "WarehouseService";

package/dist/gen/warehouse.js

@@ -0,0 +1,28 @@
+"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: warehouse.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WAREHOUSE_SERVICE_NAME = exports.CATALOG_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
+exports.WarehouseServiceControllerMethods = WarehouseServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "catalog.v1";
+exports.CATALOG_V1_PACKAGE_NAME = "catalog.v1";
+function WarehouseServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = ["upsertWarehouses"];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("WarehouseService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("WarehouseService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.WAREHOUSE_SERVICE_NAME = "WarehouseService";

package/dist/proto/attribute.proto

@@ -32,6 +32,41 @@ service AttributeService {
   rpc UnbindAttributeFromCategory (BindAttributeRequest) returns (SuccessResponse);
 
   rpc GetAllAttributesWithValues (GetAllAttributesWithValuesRequest) returns (GetAllAttributesWithValuesResponse);
+
+  
+  rpc UpsertAttributes (UpsertAttributesRequest) returns (UpsertAttributesResponse);
+}
+
+
+message AttributeSyncValueItem {
+  string value_guid = 1;            
+  map<string, string> value = 2;    
+}
+
+message AttributeSyncItem {
+  string property_guid = 1;         
+  map<string, string> name = 2;  
+  bool is_color = 3;               
+  repeated AttributeSyncValueItem values = 4;
+}
+
+message UpsertAttributesRequest {
+  repeated AttributeSyncItem items = 1;
+  string sync_id = 2;
+}
+
+message AttributeUpsertResult {
+  string guid = 1;                 
+  string status = 2;              
+  optional string reason = 3;
+  optional string id = 4;
+  int32 values_created = 5;
+  int32 values_updated = 6;
+  int32 values_failed = 7;
+}
+
+message UpsertAttributesResponse {
+  repeated AttributeUpsertResult results = 1;
 }
 
 message GetAllAttributesWithValuesRequest {}

package/dist/proto/brand.proto

@@ -13,6 +13,31 @@ service BrandService {
   rpc CreateBrand (CreateBrandRequest) returns (BrandResponse);
   rpc UpdateBrand (UpdateBrandRequest) returns (BrandResponse);
   rpc DeleteBrand (DeleteBrandRequest) returns (DeleteResponse);
+
+ 
+  rpc UpsertBrands (UpsertBrandsRequest) returns (UpsertBrandsResponse);
+}
+
+
+message BrandSyncItem {
+  string brand_guid = 1;   
+  string name = 2;      
+}
+
+message UpsertBrandsRequest {
+  repeated BrandSyncItem items = 1;
+  string sync_id = 2;
+}
+
+message BrandUpsertResult {
+  string guid = 1;
+  string status = 2;       
+  optional string reason = 3;
+  optional string id = 4;
+}
+
+message UpsertBrandsResponse {
+  repeated BrandUpsertResult results = 1;
 }
 
 

package/dist/proto/bundle.proto

@@ -241,7 +241,7 @@ message CloneBundleRequest {
 message ExportBundlesRequest {
   optional BundleStatus status = 1;
   optional BundleType bundle_type = 2;
-  string format = 3; // "json" | "csv"
+  string format = 3; 
 }
 
 message AddCrossSellLinkRequest {
@@ -275,7 +275,7 @@ message BundleListItemResponse {
   double final_price = 13;
   bool in_stock = 14;
 
-  // NEW
+  
   BundleType bundle_type = 15;
   repeated DisplayPlacement display_placements = 16;
 }

package/dist/proto/cart.proto

@@ -13,8 +13,7 @@ service CartService {
   rpc ApplyPromo(ApplyPromoRequest) returns (CartResponse);
   rpc RemovePromo(RemovePromoRequest) returns (CartResponse);
 
-  // ApplyCertificate — поки stub. Реальна перевірка номіналу/балансу
-  // потребує синхронізації з 1С (фаза інтеграцій).
+  
   rpc ApplyCertificate(ApplyCertificateRequest) returns (CartResponse);
   rpc RemoveCertificate(RemoveCertificateRequest) returns (CartResponse);
 
@@ -25,8 +24,7 @@ service CartService {
   rpc SetDeliveryDraft(SetDeliveryDraftRequest) returns (CartResponse);
   rpc SetPaymentDraft(SetPaymentDraftRequest) returns (CartResponse);
   rpc SetComment(SetCommentRequest) returns (CartResponse);
-  // Batch-set всіх checkout-полів одним викликом + ОДИН Recalculate.
-  // Фронт під час оформлення замовлення викликає це замість 4 окремих set-*.
+ 
   rpc SetCheckoutDraft(SetCheckoutDraftRequest) returns (CartResponse);
 
   rpc Recalculate(RecalculateRequest) returns (CartResponse);
@@ -38,7 +36,6 @@ service CartService {
   rpc GetWishlist(WishlistOwnerRequest) returns (WishlistResponse);
 }
 
-// ─── Cart core ──────────────────────────────────────────────────
 
 message CartItem {
   string product_id    = 1;
@@ -104,8 +101,7 @@ message DeliveryDraft {
   string pickup_point_id = 7;
   double cost          = 8;
   bool   free_shipping = 9;
-  // Область з City.region — клієнт передає при виборі міста, щоб
-  // потім order-service зміг записати в snapshot замовлення.
+  
   string region        = 10;
 }
 
@@ -144,7 +140,6 @@ message Cart {
   int64  expires_at = 17;
 }
 
-// ─── Wishlist ───────────────────────────────────────────────────
 
 message WishlistItem {
   string product_id  = 1;
@@ -162,7 +157,6 @@ message WishlistResponse {
   repeated WishlistItem items = 1;
 }
 
-// ─── Requests ───────────────────────────────────────────────────
 
 message CartOwner {
   string user_id  = 1;
@@ -246,15 +240,13 @@ message SetCommentRequest {
 
 message SetCheckoutDraftRequest {
   CartOwner owner = 1;
-  // Усі поля опціональні — оновлюються лише ті, що передані (proto3 default
-  // означає "не міняти"). Recalculate виконується одноразово в кінці.
+  
   Recipient recipient = 2;
   DeliveryDraft delivery = 3;
   PaymentDraft payment = 4;
   string comment = 5;
   bool   do_not_call = 6;
-  // Прапори "очистити поле" — щоб відрізнити default proto-значення
-  // від явного запиту прибрати, бо у proto3 порожній string === unset.
+
   bool   has_recipient = 7;
   bool   has_delivery = 8;
   bool   has_payment = 9;
@@ -280,7 +272,6 @@ message WishlistItemRequest {
   string variant_id = 3;
 }
 
-// ─── Responses ──────────────────────────────────────────────────
 
 message CartResponse {
   bool ok = 1;

package/dist/proto/category.proto

@@ -23,6 +23,32 @@ service CategoryAdminService {
   rpc UpdateCategoryOrder (UpdateCategoryOrderRequest) returns (SuccessResponse);
 
   rpc GetAllCategories (GetAllCategoriesRequest) returns (GetAllCategoriesResponse);
+
+  
+  rpc UpsertCategories (UpsertCategoriesRequest) returns (UpsertCategoriesResponse);
+}
+
+
+message CategorySyncItem {
+  string category_guid = 1;
+  optional string parent_guid = 2;            
+  map<string, string> name = 3;              
+}
+
+message UpsertCategoriesRequest {
+  repeated CategorySyncItem items = 1;
+  string sync_id = 2;
+}
+
+message CategoryUpsertResult {
+  string guid = 1;
+  string status = 2;                          
+  optional string reason = 3;
+  optional string id = 4;
+}
+
+message UpsertCategoriesResponse {
+  repeated CategoryUpsertResult results = 1;
 }
 
 message GetAllCategoriesRequest {}

package/dist/proto/delivery.proto

@@ -16,10 +16,6 @@ service DeliveryService {
   rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse);
 }
 
-// ─── Domain ────────────────────────────────────────────────────
-
-// carrier: nova_poshta | ukrposhta | pickup | courier
-// method: warehouse | postomat | address | pickup
 
 message City {
   string ref            = 1;
@@ -77,7 +73,6 @@ message ShipmentParcelItem {
   double weight_kg = 5;
 }
 
-// ─── Requests ──────────────────────────────────────────────────
 
 message Area {
   string ref    = 1;
@@ -107,7 +102,7 @@ message ListAreasResponse {
 message ListWarehousesRequest {
   string carrier  = 1;
   string city_ref = 2;
-  string type     = 3; // warehouse | postomat | both
+  string type     = 3; 
   string query    = 4;
   int32  limit    = 5;
 }

package/dist/proto/delivery_settings.proto

@@ -10,13 +10,13 @@ service DeliverySettingsService {
 
 
 message DeliverySettingsResponse {
-  // Дефолтна вага позиції у кг — fallback коли catalog не повертає weight.
+  
   double default_item_weight_kg   = 1;
-  // Поріг безкоштовної доставки в грн (0 = вимкнено).
+
   double free_shipping_threshold  = 2;
-  // Дефолтна оголошена вартість на одиницю товару у грн (для страхування НП).
+  
   double default_declared_value   = 3;
-  // Reference відправника у НП (вибране warehouse адміністратором у settings).
+  
   optional string np_sender_warehouse_ref = 4;
 
   string updated_at = 5;

package/dist/proto/faq.proto

@@ -6,11 +6,11 @@ import "common_post.proto";
 
 
 service FaqService {
-  // Storefront
+  
   rpc GetFaqStorefront (GetFaqStorefrontRequest) returns (GetFaqStorefrontResponse);
   rpc SearchFaq        (SearchFaqRequest)        returns (SearchFaqResponse);
 
-  // Admin — categories
+ 
   rpc GetFaqCategories     (GetFaqCategoriesRequest)     returns (GetFaqCategoriesResponse);
   rpc GetFaqCategory       (FaqCategoryIdRequest)        returns (FaqCategoryResponse);
   rpc CreateFaqCategory    (CreateFaqCategoryRequest)    returns (FaqCategoryResponse);
@@ -18,7 +18,7 @@ service FaqService {
   rpc DeleteFaqCategory    (FaqCategoryIdRequest)        returns (DeleteResponse);
   rpc ReorderFaqCategories (ReorderFaqRequest)           returns (SuccessResponse);
 
-  // Admin — items
+
   rpc GetFaqItems     (GetFaqItemsRequest)        returns (GetFaqItemsResponse);
   rpc GetFaqItem      (FaqItemIdRequest)          returns (FaqItemResponse);
   rpc CreateFaqItem   (CreateFaqItemRequest)      returns (FaqItemResponse);
@@ -77,7 +77,6 @@ message FaqCategoryWithItems {
 }
 
 
-// ── Storefront ──────────────────────────────────────────────────────────────
 
 message GetFaqStorefrontRequest {
   optional int32 popular_limit = 1;
@@ -97,9 +96,6 @@ message SearchFaqResponse {
   repeated FaqItemResponse items = 1;
 }
 
-
-// ── Categories CRUD ─────────────────────────────────────────────────────────
-
 message FaqCategoryIdRequest {
   string id = 1;
 }
@@ -131,8 +127,6 @@ message UpdateFaqCategoryRequest {
 }
 
 
-// ── Items CRUD ──────────────────────────────────────────────────────────────
-
 message FaqItemIdRequest {
   string id = 1;
 }
@@ -169,7 +163,6 @@ message UpdateFaqItemRequest {
 }
 
 
-// ── Reorder / Bulk ──────────────────────────────────────────────────────────
 
 message FaqSortEntry {
   string id = 1;