@mamindom/contracts 1.0.116 → 1.0.118

package/dist/gen/brand.d.ts

@@ -17,6 +17,8 @@ export interface BrandResponse {
     };
     guid1c?: string | undefined;
     imageId?: string | undefined;
+    /** Кількість АКТИВНИХ товарів бренду (для shop UI). */
+    productCount: number;
 }
 export interface BrandResponse_DescriptionEntry {
     key: string;

package/dist/gen/product.d.ts

@@ -163,6 +163,7 @@ export interface ProductDetailResponse {
     reviewCount: number;
     manualRating?: number | undefined;
     activePromo?: ProductPromoInfo | undefined;
+    colors: ProductColorResponse[];
 }
 export interface ProductDetailResponse_NameEntry {
     key: string;
@@ -671,6 +672,7 @@ export interface ProductVariantDetailResponse {
     images: ProductImageResponse[];
     attributes: ProductAttributeResponse[];
     overrides: VariantOverrides | undefined;
+    colorId?: string | undefined;
 }
 export interface ProductVariantDetailResponse_OptionsEntry {
     key: string;
@@ -740,6 +742,7 @@ export interface CreateProductVariantRequest {
     videoUrl?: string | undefined;
     images: ProductImagePayload[];
     attributeValueIds: string[];
+    colorId?: string | undefined;
 }
 export interface CreateProductVariantRequest_OptionsEntry {
     key: string;
@@ -796,6 +799,7 @@ export interface UpdateProductVariantRequest {
     videoUrl?: string | undefined;
     images: ProductImagePayload[];
     attributeValueIds: string[];
+    colorId?: string | undefined;
     clearPrice: boolean;
     clearOldPrice: boolean;
     clearName: boolean;
@@ -807,6 +811,7 @@ export interface UpdateProductVariantRequest {
     clearImages: boolean;
     clearAttributes: boolean;
     clearVideo: boolean;
+    clearColor: boolean;
 }
 export interface UpdateProductVariantRequest_OptionsEntry {
     key: string;
@@ -863,6 +868,115 @@ export interface BulkLookupProductsRequest {
 export interface BulkLookupProductsResponse {
     results: ProductLookupResult[];
 }
+export interface ProductColorImagePayload {
+    url: string;
+    mediaId: string;
+    sortOrder?: number | undefined;
+}
+export interface ProductColorImageResponse {
+    id: string;
+    url: string;
+    mediaId: string;
+    alt: {
+        [key: string]: string;
+    };
+    sortOrder: number;
+}
+export interface ProductColorImageResponse_AltEntry {
+    key: string;
+    value: string;
+}
+export interface ProductColorResponse {
+    id: string;
+    productId: string;
+    label: {
+        [key: string]: string;
+    };
+    hex?: string | undefined;
+    description: {
+        [key: string]: string;
+    };
+    mainImage?: string | undefined;
+    mainImageId?: string | undefined;
+    sortOrder: number;
+    guid1c?: string | undefined;
+    images: ProductColorImageResponse[];
+}
+export interface ProductColorResponse_LabelEntry {
+    key: string;
+    value: string;
+}
+export interface ProductColorResponse_DescriptionEntry {
+    key: string;
+    value: string;
+}
+export interface CreateProductColorRequest {
+    productId: string;
+    label: {
+        [key: string]: string;
+    };
+    hex?: string | undefined;
+    description: {
+        [key: string]: string;
+    };
+    mainImage?: string | undefined;
+    mainImageId?: string | undefined;
+    sortOrder?: number | undefined;
+    guid1c?: string | undefined;
+    images: ProductColorImagePayload[];
+}
+export interface CreateProductColorRequest_LabelEntry {
+    key: string;
+    value: string;
+}
+export interface CreateProductColorRequest_DescriptionEntry {
+    key: string;
+    value: string;
+}
+export interface UpdateProductColorRequest {
+    id: string;
+    label: {
+        [key: string]: string;
+    };
+    hex?: string | undefined;
+    description: {
+        [key: string]: string;
+    };
+    mainImage?: string | undefined;
+    mainImageId?: string | undefined;
+    sortOrder?: number | undefined;
+    guid1c?: string | undefined;
+    images: ProductColorImagePayload[];
+    clearHex: boolean;
+    clearDescription: boolean;
+    clearMainImage: boolean;
+    clearImages: boolean;
+}
+export interface UpdateProductColorRequest_LabelEntry {
+    key: string;
+    value: string;
+}
+export interface UpdateProductColorRequest_DescriptionEntry {
+    key: string;
+    value: string;
+}
+export interface DeleteProductColorRequest {
+    id: string;
+}
+export interface GetProductColorsRequest {
+    productId: string;
+}
+export interface GetProductColorsResponse {
+    items: ProductColorResponse[];
+}
+export interface ReorderProductColorsRequest {
+    productId: string;
+    items: ColorSortOrderItem[];
+}
+export interface ColorSortOrderItem {
+    colorId: string;
+    sortOrder: number;
+}
 export declare const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
 export interface ProductServiceClient {
     getProducts(request: GetProductsRequest): Observable<GetProductsResponse>;
@@ -903,6 +1017,12 @@ export interface ProductServiceClient {
     assignVariantSizeCharts(request: AssignVariantSizeChartsRequest): Observable<SuccessResponse>;
     removeVariantSizeChart(request: RemoveVariantSizeChartRequest): Observable<SuccessResponse>;
     getVariantSizeCharts(request: GetVariantSizeChartsRequest): Observable<GetProductSizeChartsResponse>;
+    /** ─── Product colors (нова ієрархія: Product → Color → Variant) ────────────── */
+    createProductColor(request: CreateProductColorRequest): Observable<ProductColorResponse>;
+    updateProductColor(request: UpdateProductColorRequest): Observable<ProductColorResponse>;
+    deleteProductColor(request: DeleteProductColorRequest): Observable<DeleteResponse>;
+    getProductColors(request: GetProductColorsRequest): Observable<GetProductColorsResponse>;
+    reorderProductColors(request: ReorderProductColorsRequest): Observable<SuccessResponse>;
 }
 export interface ProductServiceController {
     getProducts(request: GetProductsRequest): Promise<GetProductsResponse> | Observable<GetProductsResponse> | GetProductsResponse;
@@ -943,6 +1063,12 @@ export interface ProductServiceController {
     assignVariantSizeCharts(request: AssignVariantSizeChartsRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
     removeVariantSizeChart(request: RemoveVariantSizeChartRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
     getVariantSizeCharts(request: GetVariantSizeChartsRequest): Promise<GetProductSizeChartsResponse> | Observable<GetProductSizeChartsResponse> | GetProductSizeChartsResponse;
+    /** ─── Product colors (нова ієрархія: Product → Color → Variant) ────────────── */
+    createProductColor(request: CreateProductColorRequest): Promise<ProductColorResponse> | Observable<ProductColorResponse> | ProductColorResponse;
+    updateProductColor(request: UpdateProductColorRequest): Promise<ProductColorResponse> | Observable<ProductColorResponse> | ProductColorResponse;
+    deleteProductColor(request: DeleteProductColorRequest): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+    getProductColors(request: GetProductColorsRequest): Promise<GetProductColorsResponse> | Observable<GetProductColorsResponse> | GetProductColorsResponse;
+    reorderProductColors(request: ReorderProductColorsRequest): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 }
 export declare function ProductServiceControllerMethods(): (constructor: Function) => void;
 export declare const PRODUCT_SERVICE_NAME = "ProductService";

package/dist/gen/product.js

@@ -84,6 +84,11 @@ function ProductServiceControllerMethods() {
             "assignVariantSizeCharts",
             "removeVariantSizeChart",
             "getVariantSizeCharts",
+            "createProductColor",
+            "updateProductColor",
+            "deleteProductColor",
+            "getProductColors",
+            "reorderProductColors",
         ];
         for (const method of grpcMethods) {
             const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/dist/proto/brand.proto

@@ -21,14 +21,17 @@ message BrandResponse {
   string slug = 2;
   string name = 3;
   optional string image = 4;
-  
-  
+
+
   map<string, string> description = 5;
   map<string, string> meta_title = 6;
   map<string, string> meta_description = 7;
-  
+
   optional string guid_1c = 8;
   optional string image_id = 9;
+
+  // Кількість АКТИВНИХ товарів бренду (для shop UI).
+  int32 product_count = 10;
 }
 
 

package/dist/proto/product.proto

@@ -62,16 +62,23 @@ service ProductService {
    rpc AddProductToGroup (AddProductToGroupRequest) returns (SuccessResponse);
    rpc RemoveProductFromGroup (RemoveProductFromGroupRequest) returns (SuccessResponse);
 
-    
+
    rpc CreateProductVariant (CreateProductVariantRequest) returns (ProductVariantDetailResponse);
    rpc UpdateProductVariant (UpdateProductVariantRequest) returns (ProductVariantDetailResponse);
    rpc GetProductVariant (GetProductVariantRequest) returns (ProductVariantDetailResponse);
 
-   
+
 
 rpc AssignVariantSizeCharts (AssignVariantSizeChartsRequest) returns (SuccessResponse);
 rpc RemoveVariantSizeChart (RemoveVariantSizeChartRequest) returns (SuccessResponse);
 rpc GetVariantSizeCharts (GetVariantSizeChartsRequest) returns (GetProductSizeChartsResponse);
+
+  // ─── Product colors (нова ієрархія: Product → Color → Variant) ──────────────
+  rpc CreateProductColor (CreateProductColorRequest) returns (ProductColorResponse);
+  rpc UpdateProductColor (UpdateProductColorRequest) returns (ProductColorResponse);
+  rpc DeleteProductColor (DeleteProductColorRequest) returns (DeleteResponse);
+  rpc GetProductColors (GetProductColorsRequest) returns (GetProductColorsResponse);
+  rpc ReorderProductColors (ReorderProductColorsRequest) returns (SuccessResponse);
 }
 
 
@@ -210,6 +217,7 @@ message ProductDetailResponse {
   int32 review_count = 36;
   optional float manual_rating = 37;
   optional ProductPromoInfo active_promo = 38;
+  repeated ProductColorResponse colors = 39;
 }
 
 
@@ -612,6 +620,8 @@ message ProductVariantDetailResponse {
   repeated ProductAttributeResponse attributes = 19;
 
   VariantOverrides overrides = 20;
+
+  optional string color_id = 21;
 }
 
 message VariantOverrides {
@@ -651,6 +661,7 @@ message CreateProductVariantRequest {
   optional string video_url = 16;
   repeated ProductImagePayload images = 17;
   repeated string attribute_value_ids = 18;
+  optional string color_id = 19;
 }
 
 
@@ -677,6 +688,7 @@ message UpdateProductVariantRequest {
   optional string video_url = 16;
   repeated ProductImagePayload images = 17;
   repeated string attribute_value_ids = 18;
+  optional string color_id = 19;
 
 
   bool clear_price = 30;
@@ -690,6 +702,7 @@ message UpdateProductVariantRequest {
   bool clear_images = 38;
   bool clear_attributes = 39;
   bool clear_video = 40;
+  bool clear_color = 41;
 }
 
 message GetProductVariantRequest {
@@ -737,4 +750,85 @@ message BulkLookupProductsRequest {
 
 message BulkLookupProductsResponse {
   repeated ProductLookupResult results = 1;
+}
+
+
+// ─── Product colors ──────────────────────────────────────────────────────────
+
+message ProductColorImagePayload {
+  string url = 1;
+  string media_id = 2;
+  optional int32 sort_order = 3;
+}
+
+message ProductColorImageResponse {
+  string id = 1;
+  string url = 2;
+  string media_id = 3;
+  map<string, string> alt = 4;
+  int32 sort_order = 5;
+}
+
+message ProductColorResponse {
+  string id = 1;
+  string product_id = 2;
+  map<string, string> label = 3;
+  optional string hex = 4;
+  map<string, string> description = 5;
+  optional string main_image = 6;
+  optional string main_image_id = 7;
+  int32 sort_order = 8;
+  optional string guid_1c = 9;
+  repeated ProductColorImageResponse images = 10;
+}
+
+message CreateProductColorRequest {
+  string product_id = 1;
+  map<string, string> label = 2;
+  optional string hex = 3;
+  map<string, string> description = 4;
+  optional string main_image = 5;
+  optional string main_image_id = 6;
+  optional int32 sort_order = 7;
+  optional string guid_1c = 8;
+  repeated ProductColorImagePayload images = 9;
+}
+
+message UpdateProductColorRequest {
+  string id = 1;
+  map<string, string> label = 2;
+  optional string hex = 3;
+  map<string, string> description = 4;
+  optional string main_image = 5;
+  optional string main_image_id = 6;
+  optional int32 sort_order = 7;
+  optional string guid_1c = 8;
+  repeated ProductColorImagePayload images = 9;
+
+  bool clear_hex = 30;
+  bool clear_description = 31;
+  bool clear_main_image = 32;
+  bool clear_images = 33;
+}
+
+message DeleteProductColorRequest {
+  string id = 1;
+}
+
+message GetProductColorsRequest {
+  string product_id = 1;
+}
+
+message GetProductColorsResponse {
+  repeated ProductColorResponse items = 1;
+}
+
+message ReorderProductColorsRequest {
+  string product_id = 1;
+  repeated ColorSortOrderItem items = 2;
+}
+
+message ColorSortOrderItem {
+  string color_id = 1;
+  int32 sort_order = 2;
 }

package/gen/brand.ts

@@ -20,7 +20,11 @@ export interface BrandResponse {
   metaTitle: { [key: string]: string };
   metaDescription: { [key: string]: string };
   guid1c?: string | undefined;
-  imageId?: string | undefined;
+  imageId?:
+    | string
+    | undefined;
+  /** Кількість АКТИВНИХ товарів бренду (для shop UI). */
+  productCount: number;
 }
 
 export interface BrandResponse_DescriptionEntry {

package/gen/product.ts

@@ -168,6 +168,7 @@ export interface ProductDetailResponse {
   reviewCount: number;
   manualRating?: number | undefined;
   activePromo?: ProductPromoInfo | undefined;
+  colors: ProductColorResponse[];
 }
 
 export interface ProductDetailResponse_NameEntry {
@@ -687,6 +688,7 @@ export interface ProductVariantDetailResponse {
   images: ProductImageResponse[];
   attributes: ProductAttributeResponse[];
   overrides: VariantOverrides | undefined;
+  colorId?: string | undefined;
 }
 
 export interface ProductVariantDetailResponse_OptionsEntry {
@@ -752,6 +754,7 @@ export interface CreateProductVariantRequest {
   videoUrl?: string | undefined;
   images: ProductImagePayload[];
   attributeValueIds: string[];
+  colorId?: string | undefined;
 }
 
 export interface CreateProductVariantRequest_OptionsEntry {
@@ -803,6 +806,7 @@ export interface UpdateProductVariantRequest {
   videoUrl?: string | undefined;
   images: ProductImagePayload[];
   attributeValueIds: string[];
+  colorId?: string | undefined;
   clearPrice: boolean;
   clearOldPrice: boolean;
   clearName: boolean;
@@ -814,6 +818,7 @@ export interface UpdateProductVariantRequest {
   clearImages: boolean;
   clearAttributes: boolean;
   clearVideo: boolean;
+  clearColor: boolean;
 }
 
 export interface UpdateProductVariantRequest_OptionsEntry {
@@ -884,6 +889,118 @@ export interface BulkLookupProductsResponse {
   results: ProductLookupResult[];
 }
 
+export interface ProductColorImagePayload {
+  url: string;
+  mediaId: string;
+  sortOrder?: number | undefined;
+}
+
+export interface ProductColorImageResponse {
+  id: string;
+  url: string;
+  mediaId: string;
+  alt: { [key: string]: string };
+  sortOrder: number;
+}
+
+export interface ProductColorImageResponse_AltEntry {
+  key: string;
+  value: string;
+}
+
+export interface ProductColorResponse {
+  id: string;
+  productId: string;
+  label: { [key: string]: string };
+  hex?: string | undefined;
+  description: { [key: string]: string };
+  mainImage?: string | undefined;
+  mainImageId?: string | undefined;
+  sortOrder: number;
+  guid1c?: string | undefined;
+  images: ProductColorImageResponse[];
+}
+
+export interface ProductColorResponse_LabelEntry {
+  key: string;
+  value: string;
+}
+
+export interface ProductColorResponse_DescriptionEntry {
+  key: string;
+  value: string;
+}
+
+export interface CreateProductColorRequest {
+  productId: string;
+  label: { [key: string]: string };
+  hex?: string | undefined;
+  description: { [key: string]: string };
+  mainImage?: string | undefined;
+  mainImageId?: string | undefined;
+  sortOrder?: number | undefined;
+  guid1c?: string | undefined;
+  images: ProductColorImagePayload[];
+}
+
+export interface CreateProductColorRequest_LabelEntry {
+  key: string;
+  value: string;
+}
+
+export interface CreateProductColorRequest_DescriptionEntry {
+  key: string;
+  value: string;
+}
+
+export interface UpdateProductColorRequest {
+  id: string;
+  label: { [key: string]: string };
+  hex?: string | undefined;
+  description: { [key: string]: string };
+  mainImage?: string | undefined;
+  mainImageId?: string | undefined;
+  sortOrder?: number | undefined;
+  guid1c?: string | undefined;
+  images: ProductColorImagePayload[];
+  clearHex: boolean;
+  clearDescription: boolean;
+  clearMainImage: boolean;
+  clearImages: boolean;
+}
+
+export interface UpdateProductColorRequest_LabelEntry {
+  key: string;
+  value: string;
+}
+
+export interface UpdateProductColorRequest_DescriptionEntry {
+  key: string;
+  value: string;
+}
+
+export interface DeleteProductColorRequest {
+  id: string;
+}
+
+export interface GetProductColorsRequest {
+  productId: string;
+}
+
+export interface GetProductColorsResponse {
+  items: ProductColorResponse[];
+}
+
+export interface ReorderProductColorsRequest {
+  productId: string;
+  items: ColorSortOrderItem[];
+}
+
+export interface ColorSortOrderItem {
+  colorId: string;
+  sortOrder: number;
+}
+
 export const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
 
 export interface ProductServiceClient {
@@ -962,6 +1079,18 @@ export interface ProductServiceClient {
   removeVariantSizeChart(request: RemoveVariantSizeChartRequest): Observable<SuccessResponse>;
 
   getVariantSizeCharts(request: GetVariantSizeChartsRequest): Observable<GetProductSizeChartsResponse>;
+
+  /** ─── Product colors (нова ієрархія: Product → Color → Variant) ────────────── */
+
+  createProductColor(request: CreateProductColorRequest): Observable<ProductColorResponse>;
+
+  updateProductColor(request: UpdateProductColorRequest): Observable<ProductColorResponse>;
+
+  deleteProductColor(request: DeleteProductColorRequest): Observable<DeleteResponse>;
+
+  getProductColors(request: GetProductColorsRequest): Observable<GetProductColorsResponse>;
+
+  reorderProductColors(request: ReorderProductColorsRequest): Observable<SuccessResponse>;
 }
 
 export interface ProductServiceController {
@@ -1114,6 +1243,28 @@ export interface ProductServiceController {
   getVariantSizeCharts(
     request: GetVariantSizeChartsRequest,
   ): Promise<GetProductSizeChartsResponse> | Observable<GetProductSizeChartsResponse> | GetProductSizeChartsResponse;
+
+  /** ─── Product colors (нова ієрархія: Product → Color → Variant) ────────────── */
+
+  createProductColor(
+    request: CreateProductColorRequest,
+  ): Promise<ProductColorResponse> | Observable<ProductColorResponse> | ProductColorResponse;
+
+  updateProductColor(
+    request: UpdateProductColorRequest,
+  ): Promise<ProductColorResponse> | Observable<ProductColorResponse> | ProductColorResponse;
+
+  deleteProductColor(
+    request: DeleteProductColorRequest,
+  ): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
+
+  getProductColors(
+    request: GetProductColorsRequest,
+  ): Promise<GetProductColorsResponse> | Observable<GetProductColorsResponse> | GetProductColorsResponse;
+
+  reorderProductColors(
+    request: ReorderProductColorsRequest,
+  ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
 }
 
 export function ProductServiceControllerMethods() {
@@ -1157,6 +1308,11 @@ export function ProductServiceControllerMethods() {
       "assignVariantSizeCharts",
       "removeVariantSizeChart",
       "getVariantSizeCharts",
+      "createProductColor",
+      "updateProductColor",
+      "deleteProductColor",
+      "getProductColors",
+      "reorderProductColors",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mamindom/contracts",
 	"description": "proto",
-	"version": "1.0.116",
+	"version": "1.0.118",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",
 	"exports": {

package/proto/brand.proto

@@ -21,14 +21,17 @@ message BrandResponse {
   string slug = 2;
   string name = 3;
   optional string image = 4;
-  
-  
+
+
   map<string, string> description = 5;
   map<string, string> meta_title = 6;
   map<string, string> meta_description = 7;
-  
+
   optional string guid_1c = 8;
   optional string image_id = 9;
+
+  // Кількість АКТИВНИХ товарів бренду (для shop UI).
+  int32 product_count = 10;
 }
 
 

package/proto/product.proto

@@ -62,16 +62,23 @@ service ProductService {
    rpc AddProductToGroup (AddProductToGroupRequest) returns (SuccessResponse);
    rpc RemoveProductFromGroup (RemoveProductFromGroupRequest) returns (SuccessResponse);
 
-    
+
    rpc CreateProductVariant (CreateProductVariantRequest) returns (ProductVariantDetailResponse);
    rpc UpdateProductVariant (UpdateProductVariantRequest) returns (ProductVariantDetailResponse);
    rpc GetProductVariant (GetProductVariantRequest) returns (ProductVariantDetailResponse);
 
-   
+
 
 rpc AssignVariantSizeCharts (AssignVariantSizeChartsRequest) returns (SuccessResponse);
 rpc RemoveVariantSizeChart (RemoveVariantSizeChartRequest) returns (SuccessResponse);
 rpc GetVariantSizeCharts (GetVariantSizeChartsRequest) returns (GetProductSizeChartsResponse);
+
+  // ─── Product colors (нова ієрархія: Product → Color → Variant) ──────────────
+  rpc CreateProductColor (CreateProductColorRequest) returns (ProductColorResponse);
+  rpc UpdateProductColor (UpdateProductColorRequest) returns (ProductColorResponse);
+  rpc DeleteProductColor (DeleteProductColorRequest) returns (DeleteResponse);
+  rpc GetProductColors (GetProductColorsRequest) returns (GetProductColorsResponse);
+  rpc ReorderProductColors (ReorderProductColorsRequest) returns (SuccessResponse);
 }
 
 
@@ -210,6 +217,7 @@ message ProductDetailResponse {
   int32 review_count = 36;
   optional float manual_rating = 37;
   optional ProductPromoInfo active_promo = 38;
+  repeated ProductColorResponse colors = 39;
 }
 
 
@@ -612,6 +620,8 @@ message ProductVariantDetailResponse {
   repeated ProductAttributeResponse attributes = 19;
 
   VariantOverrides overrides = 20;
+
+  optional string color_id = 21;
 }
 
 message VariantOverrides {
@@ -651,6 +661,7 @@ message CreateProductVariantRequest {
   optional string video_url = 16;
   repeated ProductImagePayload images = 17;
   repeated string attribute_value_ids = 18;
+  optional string color_id = 19;
 }
 
 
@@ -677,6 +688,7 @@ message UpdateProductVariantRequest {
   optional string video_url = 16;
   repeated ProductImagePayload images = 17;
   repeated string attribute_value_ids = 18;
+  optional string color_id = 19;
 
 
   bool clear_price = 30;
@@ -690,6 +702,7 @@ message UpdateProductVariantRequest {
   bool clear_images = 38;
   bool clear_attributes = 39;
   bool clear_video = 40;
+  bool clear_color = 41;
 }
 
 message GetProductVariantRequest {
@@ -737,4 +750,85 @@ message BulkLookupProductsRequest {
 
 message BulkLookupProductsResponse {
   repeated ProductLookupResult results = 1;
+}
+
+
+// ─── Product colors ──────────────────────────────────────────────────────────
+
+message ProductColorImagePayload {
+  string url = 1;
+  string media_id = 2;
+  optional int32 sort_order = 3;
+}
+
+message ProductColorImageResponse {
+  string id = 1;
+  string url = 2;
+  string media_id = 3;
+  map<string, string> alt = 4;
+  int32 sort_order = 5;
+}
+
+message ProductColorResponse {
+  string id = 1;
+  string product_id = 2;
+  map<string, string> label = 3;
+  optional string hex = 4;
+  map<string, string> description = 5;
+  optional string main_image = 6;
+  optional string main_image_id = 7;
+  int32 sort_order = 8;
+  optional string guid_1c = 9;
+  repeated ProductColorImageResponse images = 10;
+}
+
+message CreateProductColorRequest {
+  string product_id = 1;
+  map<string, string> label = 2;
+  optional string hex = 3;
+  map<string, string> description = 4;
+  optional string main_image = 5;
+  optional string main_image_id = 6;
+  optional int32 sort_order = 7;
+  optional string guid_1c = 8;
+  repeated ProductColorImagePayload images = 9;
+}
+
+message UpdateProductColorRequest {
+  string id = 1;
+  map<string, string> label = 2;
+  optional string hex = 3;
+  map<string, string> description = 4;
+  optional string main_image = 5;
+  optional string main_image_id = 6;
+  optional int32 sort_order = 7;
+  optional string guid_1c = 8;
+  repeated ProductColorImagePayload images = 9;
+
+  bool clear_hex = 30;
+  bool clear_description = 31;
+  bool clear_main_image = 32;
+  bool clear_images = 33;
+}
+
+message DeleteProductColorRequest {
+  string id = 1;
+}
+
+message GetProductColorsRequest {
+  string product_id = 1;
+}
+
+message GetProductColorsResponse {
+  repeated ProductColorResponse items = 1;
+}
+
+message ReorderProductColorsRequest {
+  string product_id = 1;
+  repeated ColorSortOrderItem items = 2;
+}
+
+message ColorSortOrderItem {
+  string color_id = 1;
+  int32 sort_order = 2;
 }