@mamindom/contracts 1.0.143 → 1.0.145

package/gen/product.ts

@@ -121,10 +121,7 @@ export interface ProductListItemResponse {
   rating: number;
   reviewCount: number;
   stickers: ProductStickerResponse[];
-  activePromo?:
-    | ProductPromoInfo
-    | undefined;
-  /** Вага у кг для розрахунку доставки (0 → fallback на defaultItemWeightKg). */
+  activePromo?: ProductPromoInfo | undefined;
   weightKg: number;
 }
 
@@ -173,7 +170,6 @@ export interface ProductDetailResponse {
   manualRating?: number | undefined;
   activePromo?: ProductPromoInfo | undefined;
   colors: ProductColorResponse[];
-  /** Вага товару у кг для розрахунку доставки (variant може override'ити). */
   weightKg: number;
 }
 
@@ -696,10 +692,7 @@ export interface ProductVariantDetailResponse {
   images: ProductImageResponse[];
   attributes: ProductAttributeResponse[];
   overrides: VariantOverrides | undefined;
-  colorId?:
-    | string
-    | undefined;
-  /** Override-вага варіанту у кг; 0 означає "успадкувати від продукту". */
+  colorId?: string | undefined;
   weightKg: number;
 }
 
@@ -767,10 +760,7 @@ export interface CreateProductVariantRequest {
   videoUrl?: string | undefined;
   images: ProductImagePayload[];
   attributeValueIds: string[];
-  colorId?:
-    | string
-    | undefined;
-  /** Override-вага варіанту у кг (null/unset → успадкувати від продукту). */
+  colorId?: string | undefined;
   weightKg?: number | undefined;
 }
 
@@ -823,10 +813,7 @@ export interface UpdateProductVariantRequest {
   videoUrl?: string | undefined;
   images: ProductImagePayload[];
   attributeValueIds: string[];
-  colorId?:
-    | string
-    | undefined;
-  /** Override-вага варіанту у кг (null/unset → успадкувати від продукту). */
+  colorId?: string | undefined;
   weightKg?: number | undefined;
   clearPrice: boolean;
   clearOldPrice: boolean;
@@ -916,20 +903,14 @@ export interface VariantLookupResult {
   productId: string;
   sku: string;
   found: boolean;
-  /** Резолвлена з урахуванням variant override. */
   price: number;
   oldPrice?: number | undefined;
   stock: number;
   hasOwnPrice: boolean;
-  /** Локалізована назва (uk → ru → перше) для зручності клієнта. */
   nameUk: string;
   mainImage: string;
-  colorId?:
-    | string
-    | undefined;
-  /** Вага у кг (variant.weight_kg ?? product.weight_kg ?? 0). */
+  colorId?: string | undefined;
   weightKg: number;
-  /** Розмір з variant.options.size — для відображення у замовленнях. */
   size: string;
 }
 
@@ -1053,6 +1034,120 @@ export interface ColorSortOrderItem {
   sortOrder: number;
 }
 
+export interface ProductSyncItem {
+  productGuid: string;
+  sku: string;
+  name: { [key: string]: string };
+  brandValueGuid?: string | undefined;
+  attributeValueGuids: string[];
+  characteristicGuids: string[];
+  categoryGuids: string[];
+}
+
+export interface ProductSyncItem_NameEntry {
+  key: string;
+  value: string;
+}
+
+export interface UpsertProductsRequest {
+  items: ProductSyncItem[];
+  syncId: string;
+  createdBy: string;
+  colorPropertyGuid: string;
+}
+
+export interface ProductUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+  id?: string | undefined;
+  attributesLinked: number;
+  attributesSkipped: number;
+  variantsCreated: number;
+  variantsUpdated: number;
+  variantsSkipped: number;
+}
+
+export interface UpsertProductsResponse {
+  results: ProductUpsertResult[];
+}
+
+export interface PriceSyncItem {
+  productGuid: string;
+  characteristicGuid?: string | undefined;
+  price: number;
+  oldPrice?: number | undefined;
+}
+
+export interface UpsertPricesRequest {
+  items: PriceSyncItem[];
+  syncId: string;
+}
+
+export interface PriceUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+}
+
+export interface UpsertPricesResponse {
+  results: PriceUpsertResult[];
+}
+
+export interface CharacteristicPropertyLink {
+  propertyGuid: string;
+  valueGuid: string;
+}
+
+export interface CharacteristicSyncItem {
+  characteristicGuid: string;
+  name: { [key: string]: string };
+  properties: CharacteristicPropertyLink[];
+}
+
+export interface CharacteristicSyncItem_NameEntry {
+  key: string;
+  value: string;
+}
+
+export interface UpsertCharacteristicsRequest {
+  items: CharacteristicSyncItem[];
+  syncId: string;
+}
+
+export interface CharacteristicUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+  id?: string | undefined;
+}
+
+export interface UpsertCharacteristicsResponse {
+  results: CharacteristicUpsertResult[];
+}
+
+export interface StockSyncItem {
+  productGuid: string;
+  characteristicGuid?: string | undefined;
+  warehouseGuid: string;
+  quantity: number;
+}
+
+export interface UpsertStocksRequest {
+  items: StockSyncItem[];
+  syncId: string;
+}
+
+export interface StockUpsertResult {
+  guid: string;
+  status: string;
+  reason?: string | undefined;
+}
+
+export interface UpsertStocksResponse {
+  results: StockUpsertResult[];
+}
+
 export const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
 
 export interface ProductServiceClient {
@@ -1068,6 +1163,14 @@ export interface ProductServiceClient {
 
   setManualRating(request: SetManualRatingRequest): Observable<SuccessResponse>;
 
+  upsertProducts(request: UpsertProductsRequest): Observable<UpsertProductsResponse>;
+
+  upsertPrices(request: UpsertPricesRequest): Observable<UpsertPricesResponse>;
+
+  upsertCharacteristics(request: UpsertCharacteristicsRequest): Observable<UpsertCharacteristicsResponse>;
+
+  upsertStocks(request: UpsertStocksRequest): Observable<UpsertStocksResponse>;
+
   bulkUpdateStatus(request: BulkUpdateStatusRequest): Observable<SuccessResponse>;
 
   bulkUpdateCategory(request: BulkUpdateCategoryRequest): Observable<SuccessResponse>;
@@ -1134,8 +1237,6 @@ export interface ProductServiceClient {
 
   getVariantSizeCharts(request: GetVariantSizeChartsRequest): Observable<GetProductSizeChartsResponse>;
 
-  /** ─── Product colors (нова ієрархія: Product → Color → Variant) ────────────── */
-
   createProductColor(request: CreateProductColorRequest): Observable<ProductColorResponse>;
 
   updateProductColor(request: UpdateProductColorRequest): Observable<ProductColorResponse>;
@@ -1170,6 +1271,22 @@ export interface ProductServiceController {
     request: SetManualRatingRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
+  upsertProducts(
+    request: UpsertProductsRequest,
+  ): Promise<UpsertProductsResponse> | Observable<UpsertProductsResponse> | UpsertProductsResponse;
+
+  upsertPrices(
+    request: UpsertPricesRequest,
+  ): Promise<UpsertPricesResponse> | Observable<UpsertPricesResponse> | UpsertPricesResponse;
+
+  upsertCharacteristics(
+    request: UpsertCharacteristicsRequest,
+  ): Promise<UpsertCharacteristicsResponse> | Observable<UpsertCharacteristicsResponse> | UpsertCharacteristicsResponse;
+
+  upsertStocks(
+    request: UpsertStocksRequest,
+  ): Promise<UpsertStocksResponse> | Observable<UpsertStocksResponse> | UpsertStocksResponse;
+
   bulkUpdateStatus(
     request: BulkUpdateStatusRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
@@ -1302,8 +1419,6 @@ export interface ProductServiceController {
     request: GetVariantSizeChartsRequest,
   ): Promise<GetProductSizeChartsResponse> | Observable<GetProductSizeChartsResponse> | GetProductSizeChartsResponse;
 
-  /** ─── Product colors (нова ієрархія: Product → Color → Variant) ────────────── */
-
   createProductColor(
     request: CreateProductColorRequest,
   ): Promise<ProductColorResponse> | Observable<ProductColorResponse> | ProductColorResponse;
@@ -1334,6 +1449,10 @@ export function ProductServiceControllerMethods() {
       "updateProduct",
       "deleteProduct",
       "setManualRating",
+      "upsertProducts",
+      "upsertPrices",
+      "upsertCharacteristics",
+      "upsertStocks",
       "bulkUpdateStatus",
       "bulkUpdateCategory",
       "bulkUpdateDiscount",

package/gen/promotion.ts

@@ -163,14 +163,8 @@ export interface GetPromotionsRequest {
   search?: string | undefined;
   categoryId?: string | undefined;
   dateFrom?: string | undefined;
-  dateTo?:
-    | string
-    | undefined;
-  /** startDate | endDate | priority | discountValue */
-  sortBy?:
-    | string
-    | undefined;
-  /** asc | desc */
+  dateTo?: string | undefined;
+  sortBy?: string | undefined;
   sortDir?: string | undefined;
 }
 
@@ -373,10 +367,6 @@ export interface GetPromotionEligibleProductIdsRequest {
   promotionId: string;
 }
 
-/**
- * Returns the full membership of the promotion (NOT resolved to a flat list).
- * Catalog-service joins these (UNION include − exclude) using its own data.
- */
 export interface GetPromotionEligibleProductIdsResponse {
   includeProductIds: string[];
   includeCategoryIds: string[];
@@ -399,17 +389,13 @@ export interface ActivePromotionSnapshotItem {
   priority: number;
   seoSlug?: string | undefined;
   startsAt?: string | undefined;
-  endsAt?:
-    | string
-    | undefined;
-  /** Resolved eligible product IDs (already deduped, exclusions applied). */
+  endsAt?: string | undefined;
   productIds: string[];
   categoryIds: string[];
   brandIds: string[];
   excludedProductIds: string[];
   excludedCategoryIds: string[];
   excludedBrandIds: string[];
-  /** Per-product label/color override (key = productId). */
   productLabels: { [key: string]: string };
   productLabelColors: { [key: string]: string };
 }
@@ -509,8 +495,6 @@ export interface PromotionServiceClient {
     request: GetActivePromotionsSnapshotRequest,
   ): Observable<GetActivePromotionsSnapshotResponse>;
 
-  /** Products */
-
   getPromotionProducts(request: GetPromotionProductsRequest): Observable<GetPromotionProductsResponse>;
 
   getPromotionEligibleProductIds(
@@ -521,20 +505,14 @@ export interface PromotionServiceClient {
 
   removePromotionProducts(request: RemovePromotionProductsRequest): Observable<SuccessResponse>;
 
-  /** Categories */
-
   getPromotionCategories(request: GetPromotionCategoriesRequest): Observable<GetPromotionCategoriesResponse>;
 
   setPromotionCategories(request: SetPromotionCategoriesRequest): Observable<SuccessResponse>;
 
-  /** Brands */
-
   getPromotionBrands(request: GetPromotionBrandsRequest): Observable<GetPromotionBrandsResponse>;
 
   setPromotionBrands(request: SetPromotionBrandsRequest): Observable<SuccessResponse>;
 
-  /** Bundles */
-
   getPromotionBundles(request: GetPromotionBundlesRequest): Observable<GetPromotionBundlesResponse>;
 
   addPromotionBundles(request: AddPromotionBundlesRequest): Observable<SuccessResponse>;
@@ -586,8 +564,6 @@ export interface PromotionServiceController {
     | Observable<GetActivePromotionsSnapshotResponse>
     | GetActivePromotionsSnapshotResponse;
 
-  /** Products */
-
   getPromotionProducts(
     request: GetPromotionProductsRequest,
   ): Promise<GetPromotionProductsResponse> | Observable<GetPromotionProductsResponse> | GetPromotionProductsResponse;
@@ -607,8 +583,6 @@ export interface PromotionServiceController {
     request: RemovePromotionProductsRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
-  /** Categories */
-
   getPromotionCategories(
     request: GetPromotionCategoriesRequest,
   ):
@@ -620,8 +594,6 @@ export interface PromotionServiceController {
     request: SetPromotionCategoriesRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
-  /** Brands */
-
   getPromotionBrands(
     request: GetPromotionBrandsRequest,
   ): Promise<GetPromotionBrandsResponse> | Observable<GetPromotionBrandsResponse> | GetPromotionBrandsResponse;
@@ -630,8 +602,6 @@ export interface PromotionServiceController {
     request: SetPromotionBrandsRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
-  /** Bundles */
-
   getPromotionBundles(
     request: GetPromotionBundlesRequest,
   ): Promise<GetPromotionBundlesResponse> | Observable<GetPromotionBundlesResponse> | GetPromotionBundlesResponse;

package/gen/rbac.ts

@@ -63,10 +63,7 @@ export interface UpdateRoleRequest {
   id: string;
   name?: string | undefined;
   description?: string | undefined;
-  color?:
-    | string
-    | undefined;
-  /** Якщо передано — повна заміна; якщо не передано — без змін. */
+  color?: string | undefined;
   permissionKeys: string[];
   replacePermissions: boolean;
 }
@@ -81,10 +78,6 @@ export interface DeleteRoleResponse {
 
 export interface AssignAccountRoleRequest {
   accountId: string;
-  /**
-   * Якщо custom_role_id порожній — користувач відвʼязується від кастомної ролі,
-   * і дозволи беруться з системної.
-   */
   customRoleId?: string | undefined;
 }
 
@@ -97,12 +90,7 @@ export interface GetAccountPermissionsRequest {
 }
 
 export interface GetAccountPermissionsResponse {
-  /**
-   * Effective permissions з урахуванням system role + custom role override.
-   * Може містити "*" — повний доступ (ADMIN).
-   */
   permissionKeys: string[];
-  /** Слаг ефективної ролі (для UI/labels). */
   roleSlug: string;
   roleName: string;
 }
@@ -110,12 +98,8 @@ export interface GetAccountPermissionsResponse {
 export const RBAC_V1_PACKAGE_NAME = "rbac.v1";
 
 export interface RbacServiceClient {
-  /** Permissions catalog (read-only, seeded). */
-
   listPermissions(request: ListPermissionsRequest): Observable<ListPermissionsResponse>;
 
-  /** Roles CRUD. */
-
   listRoles(request: ListRolesRequest): Observable<ListRolesResponse>;
 
   getRole(request: GetRoleRequest): Observable<RbacRole>;
@@ -126,22 +110,16 @@ export interface RbacServiceClient {
 
   deleteRole(request: DeleteRoleRequest): Observable<DeleteRoleResponse>;
 
-  /** Account ↔ role bindings. */
-
   assignAccountRole(request: AssignAccountRoleRequest): Observable<AssignAccountRoleResponse>;
 
   getAccountPermissions(request: GetAccountPermissionsRequest): Observable<GetAccountPermissionsResponse>;
 }
 
 export interface RbacServiceController {
-  /** Permissions catalog (read-only, seeded). */
-
   listPermissions(
     request: ListPermissionsRequest,
   ): Promise<ListPermissionsResponse> | Observable<ListPermissionsResponse> | ListPermissionsResponse;
 
-  /** Roles CRUD. */
-
   listRoles(request: ListRolesRequest): Promise<ListRolesResponse> | Observable<ListRolesResponse> | ListRolesResponse;
 
   getRole(request: GetRoleRequest): Promise<RbacRole> | Observable<RbacRole> | RbacRole;
@@ -154,8 +132,6 @@ export interface RbacServiceController {
     request: DeleteRoleRequest,
   ): Promise<DeleteRoleResponse> | Observable<DeleteRoleResponse> | DeleteRoleResponse;
 
-  /** Account ↔ role bindings. */
-
   assignAccountRole(
     request: AssignAccountRoleRequest,
   ): Promise<AssignAccountRoleResponse> | Observable<AssignAccountRoleResponse> | AssignAccountRoleResponse;

package/gen/search.ts

@@ -19,11 +19,8 @@ export enum SynonymType {
 
 export interface SuggestRequest {
   q: string;
-  /** 1..20, default 8 */
   limit: number;
-  /** default true */
   onlyInStock: boolean;
-  /** 'uk' | 'ru', default 'uk' */
   locale: string;
 }
 
@@ -31,7 +28,6 @@ export interface SuggestProduct {
   id: string;
   sku: string;
   slug: string;
-  /** already локалізована (uk/ru) */
   name: string;
   mainImage: string;
   price: number;
@@ -53,7 +49,6 @@ export interface SuggestResponse {
   products: SuggestProduct[];
   categories: SuggestCategory[];
   popularQueries: string[];
-  /** загальна кількість збігів у продуктах */
   total: number;
 }
 
@@ -147,7 +142,6 @@ export interface ReorderPopularQueryItem {
 }
 
 export interface ListZeroResultsRequest {
-  /** default 100, max 500 */
   limit?: number | undefined;
 }
 
@@ -166,12 +160,8 @@ export interface ClearZeroResultsRequest {
 export 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>;
@@ -182,8 +172,6 @@ export interface SearchServiceClient {
 
   syncSynonymsToTypesense(request: SyncSynonymsRequest): Observable<SuccessResponse>;
 
-  /** ─── Admin: popular queries ────────────────────────────────────────────── */
-
   listPopularQueries(request: ListPopularQueriesRequest): Observable<ListPopularQueriesResponse>;
 
   createPopularQuery(request: CreatePopularQueryRequest): Observable<PopularQueryResponse>;
@@ -194,20 +182,14 @@ export interface SearchServiceClient {
 
   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;
@@ -226,8 +208,6 @@ export interface SearchServiceController {
     request: SyncSynonymsRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
-  /** ─── Admin: popular queries ────────────────────────────────────────────── */
-
   listPopularQueries(
     request: ListPopularQueriesRequest,
   ): Promise<ListPopularQueriesResponse> | Observable<ListPopularQueriesResponse> | ListPopularQueriesResponse;
@@ -248,8 +228,6 @@ export interface SearchServiceController {
     request: ReorderPopularQueriesRequest,
   ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 
-  /** ─── Admin: zero-result analytics ──────────────────────────────────────── */
-
   listZeroResults(
     request: ListZeroResultsRequest,
   ): Promise<ListZeroResultsResponse> | Observable<ListZeroResultsResponse> | ListZeroResultsResponse;