@mamindom/contracts 1.0.211 → 1.0.213

package/dist/gen/calculation.d.ts

@@ -53,16 +53,36 @@ export interface GiftSuggestion {
     productIds: string[];
     minOrderAmount: number;
 }
+/**
+ * Частка знижки, що припадає на КОНКРЕТНУ позицію кошика.
+ *
+ * `item_index` — позиція в масиві `items` запиту, а не productId: у кошику
+ * можуть лежати два рядки одного товару (різні варіанти/кольори), і за
+ * productId їх не розрізнити. Порядок масиву зберігається на всьому шляху,
+ * тож індекс однозначний.
+ */
+export interface ItemDiscount {
+    itemIndex: number;
+    amount: number;
+}
 export interface AppliedPromotion {
     promotionId: string;
     promotionName: string;
     discountAmount: number;
+    /**
+     * Рознесення `discount_amount` по позиціях. Двигун знає, з яких саме
+     * одиниць він зняв гроші (найдешевші в подарунок, найдорожчі в набір,
+     * задані позиції в чеку), і віддає це назовні. Порожній масив = споживач
+     * має право розкласти суму пропорційно сам.
+     */
+    itemDiscounts: ItemDiscount[];
 }
 export interface AppliedCoupon {
     couponId: string;
     code: string;
     promotionId: string;
     discountAmount: number;
+    itemDiscounts: ItemDiscount[];
 }
 export declare const PROMO_V1_PACKAGE_NAME = "promo.v1";
 export interface PromoCalculationServiceClient {

package/dist/gen/crm_calculation.d.ts

@@ -1,5 +1,11 @@
 import { Observable } from "rxjs";
 export declare const protobufPackage = "crm.v1";
+export interface GetCalculationModeRequest {
+}
+export interface GetCalculationModeResponse {
+    /** true — джерело правди щодо акцій це CRM. */
+    crmPromotions: boolean;
+}
 export interface CrmCalculationItem {
     productId: string;
     variantId: string;
@@ -56,6 +62,14 @@ export interface CalculateCartResponse {
     crmCommentId: string;
     rawResult: string;
     durationMs: number;
+    /**
+     * Чому підсумок узяли НЕ з CRM. Порожнє — узяли з CRM.
+     *
+     * Без цього поля «CRM не порахувала» виглядало точно так само, як «у CRM
+     * немає акцій»: кошик показував локальний розрахунок під міткою PLANFIX, і
+     * менеджер не мав жодного способу відрізнити ці випадки.
+     */
+    fallbackReason: string;
 }
 export interface ReserveBonusesRequest {
     userId: string;
@@ -105,6 +119,13 @@ export interface CrmCalculationServiceClient {
     reserveBonuses(request: ReserveBonusesRequest): Observable<ReserveBonusesResponse>;
     releaseBonusReserve(request: ReleaseBonusReserveRequest): Observable<ReleaseBonusReserveResponse>;
     getCustomerProfile(request: GetCustomerProfileRequest): Observable<GetCustomerProfileResponse>;
+    /**
+     * Чи рахує акції CRM. Кошику це потрібно, щоб не показувати ВЛАСНІ
+     * автоакції поверх тих, які потім перерахує CRM: інакше клієнт бачить одну
+     * знижку в кошику й іншу на чекауті, а менеджер — «акція є в CRM, а сайт її
+     * не бачить».
+     */
+    getCalculationMode(request: GetCalculationModeRequest): Observable<GetCalculationModeResponse>;
 }
 export interface CrmCalculationServiceController {
     calculateCart(request: CalculateCartRequest): Promise<CalculateCartResponse> | Observable<CalculateCartResponse> | CalculateCartResponse;
@@ -112,6 +133,13 @@ export interface CrmCalculationServiceController {
     reserveBonuses(request: ReserveBonusesRequest): Promise<ReserveBonusesResponse> | Observable<ReserveBonusesResponse> | ReserveBonusesResponse;
     releaseBonusReserve(request: ReleaseBonusReserveRequest): Promise<ReleaseBonusReserveResponse> | Observable<ReleaseBonusReserveResponse> | ReleaseBonusReserveResponse;
     getCustomerProfile(request: GetCustomerProfileRequest): Promise<GetCustomerProfileResponse> | Observable<GetCustomerProfileResponse> | GetCustomerProfileResponse;
+    /**
+     * Чи рахує акції CRM. Кошику це потрібно, щоб не показувати ВЛАСНІ
+     * автоакції поверх тих, які потім перерахує CRM: інакше клієнт бачить одну
+     * знижку в кошику й іншу на чекауті, а менеджер — «акція є в CRM, а сайт її
+     * не бачить».
+     */
+    getCalculationMode(request: GetCalculationModeRequest): Promise<GetCalculationModeResponse> | Observable<GetCalculationModeResponse> | GetCalculationModeResponse;
 }
 export declare function CrmCalculationServiceControllerMethods(): (constructor: Function) => void;
 export declare const CRM_CALCULATION_SERVICE_NAME = "CrmCalculationService";

package/dist/gen/crm_calculation.js

@@ -19,6 +19,7 @@ function CrmCalculationServiceControllerMethods() {
             "reserveBonuses",
             "releaseBonusReserve",
             "getCustomerProfile",
+            "getCalculationMode",
         ];
         for (const method of grpcMethods) {
             const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/dist/gen/promotion.d.ts

@@ -179,6 +179,18 @@ export interface PromotionListItem {
     source?: string | undefined;
     planfixId?: string | undefined;
     seoSlug?: string | undefined;
+    /**
+     * Параметри механіки — щоб список показував, ЩО саме дає акція.
+     * Без них бандли, каскади й позиційні знижки малювались як «0 %»:
+     * їхня знижка живе не в `discount_value`, і рядок виглядав зламаним.
+     */
+    buyQuantity?: number | undefined;
+    getQuantity?: number | undefined;
+    bundlePrice?: number | undefined;
+    bundleSize?: number | undefined;
+    /** JSON-рядком — так само, як у детальному повідомленні вище. */
+    cascadeSteps?: string | undefined;
+    positionSteps?: string | undefined;
 }
 export interface PromotionListItem_NameEntry {
     key: string;

package/dist/proto/calculation.proto

@@ -90,10 +90,27 @@ message GiftSuggestion {
   double min_order_amount = 5;
 }
 
+// Частка знижки, що припадає на КОНКРЕТНУ позицію кошика.
+//
+// `item_index` — позиція в масиві `items` запиту, а не productId: у кошику
+// можуть лежати два рядки одного товару (різні варіанти/кольори), і за
+// productId їх не розрізнити. Порядок масиву зберігається на всьому шляху,
+// тож індекс однозначний.
+message ItemDiscount {
+  int32 item_index = 1;
+  double amount = 2;
+}
+
 message AppliedPromotion {
   string promotion_id = 1;
   string promotion_name = 2;
   double discount_amount = 3;
+
+  // Рознесення `discount_amount` по позиціях. Двигун знає, з яких саме
+  // одиниць він зняв гроші (найдешевші в подарунок, найдорожчі в набір,
+  // задані позиції в чеку), і віддає це назовні. Порожній масив = споживач
+  // має право розкласти суму пропорційно сам.
+  repeated ItemDiscount item_discounts = 4;
 }
 
 message AppliedCoupon {
@@ -101,5 +118,7 @@ message AppliedCoupon {
   string code = 2;
   string promotion_id = 3;
   double discount_amount = 4;
+
+  repeated ItemDiscount item_discounts = 5;
 }
 

package/dist/proto/crm_calculation.proto

@@ -11,6 +11,19 @@ service CrmCalculationService {
   rpc ReleaseBonusReserve(ReleaseBonusReserveRequest) returns (ReleaseBonusReserveResponse);
 
   rpc GetCustomerProfile(GetCustomerProfileRequest) returns (GetCustomerProfileResponse);
+
+  // Чи рахує акції CRM. Кошику це потрібно, щоб не показувати ВЛАСНІ
+  // автоакції поверх тих, які потім перерахує CRM: інакше клієнт бачить одну
+  // знижку в кошику й іншу на чекауті, а менеджер — «акція є в CRM, а сайт її
+  // не бачить».
+  rpc GetCalculationMode(GetCalculationModeRequest) returns (GetCalculationModeResponse);
+}
+
+message GetCalculationModeRequest {}
+
+message GetCalculationModeResponse {
+  // true — джерело правди щодо акцій це CRM.
+  bool crm_promotions = 1;
 }
 
 message CrmCalculationItem {
@@ -83,6 +96,13 @@ message CalculateCartResponse {
   string raw_result = 15;
 
   int32 duration_ms = 16;
+
+  // Чому підсумок узяли НЕ з CRM. Порожнє — узяли з CRM.
+  //
+  // Без цього поля «CRM не порахувала» виглядало точно так само, як «у CRM
+  // немає акцій»: кошик показував локальний розрахунок під міткою PLANFIX, і
+  // менеджер не мав жодного способу відрізнити ці випадки.
+  string fallback_reason = 17;
 }
 
 message ReserveBonusesRequest {

package/dist/proto/promotion.proto

@@ -216,6 +216,17 @@ message PromotionListItem {
   optional string source       = 16;
   optional string planfix_id   = 17;
   optional string seo_slug     = 18;
+
+  // Параметри механіки — щоб список показував, ЩО саме дає акція.
+  // Без них бандли, каскади й позиційні знижки малювались як «0 %»:
+  // їхня знижка живе не в `discount_value`, і рядок виглядав зламаним.
+  optional int32  buy_quantity  = 19;
+  optional int32  get_quantity  = 20;
+  optional double bundle_price  = 21;
+  optional int32  bundle_size   = 22;
+  // JSON-рядком — так само, як у детальному повідомленні вище.
+  optional string cascade_steps  = 23;
+  optional string position_steps = 24;
 }
 
 

package/gen/calculation.ts

@@ -69,10 +69,30 @@ export interface GiftSuggestion {
   minOrderAmount: number;
 }
 
+/**
+ * Частка знижки, що припадає на КОНКРЕТНУ позицію кошика.
+ *
+ * `item_index` — позиція в масиві `items` запиту, а не productId: у кошику
+ * можуть лежати два рядки одного товару (різні варіанти/кольори), і за
+ * productId їх не розрізнити. Порядок масиву зберігається на всьому шляху,
+ * тож індекс однозначний.
+ */
+export interface ItemDiscount {
+  itemIndex: number;
+  amount: number;
+}
+
 export interface AppliedPromotion {
   promotionId: string;
   promotionName: string;
   discountAmount: number;
+  /**
+   * Рознесення `discount_amount` по позиціях. Двигун знає, з яких саме
+   * одиниць він зняв гроші (найдешевші в подарунок, найдорожчі в набір,
+   * задані позиції в чеку), і віддає це назовні. Порожній масив = споживач
+   * має право розкласти суму пропорційно сам.
+   */
+  itemDiscounts: ItemDiscount[];
 }
 
 export interface AppliedCoupon {
@@ -80,6 +100,7 @@ export interface AppliedCoupon {
   code: string;
   promotionId: string;
   discountAmount: number;
+  itemDiscounts: ItemDiscount[];
 }
 
 export const PROMO_V1_PACKAGE_NAME = "promo.v1";

package/gen/crm_calculation.ts

@@ -10,6 +10,14 @@ import { Observable } from "rxjs";
 
 export const protobufPackage = "crm.v1";
 
+export interface GetCalculationModeRequest {
+}
+
+export interface GetCalculationModeResponse {
+  /** true — джерело правди щодо акцій це CRM. */
+  crmPromotions: boolean;
+}
+
 export interface CrmCalculationItem {
   productId: string;
   variantId: string;
@@ -71,6 +79,14 @@ export interface CalculateCartResponse {
   crmCommentId: string;
   rawResult: string;
   durationMs: number;
+  /**
+   * Чому підсумок узяли НЕ з CRM. Порожнє — узяли з CRM.
+   *
+   * Без цього поля «CRM не порахувала» виглядало точно так само, як «у CRM
+   * немає акцій»: кошик показував локальний розрахунок під міткою PLANFIX, і
+   * менеджер не мав жодного способу відрізнити ці випадки.
+   */
+  fallbackReason: string;
 }
 
 export interface ReserveBonusesRequest {
@@ -134,6 +150,15 @@ export interface CrmCalculationServiceClient {
   releaseBonusReserve(request: ReleaseBonusReserveRequest): Observable<ReleaseBonusReserveResponse>;
 
   getCustomerProfile(request: GetCustomerProfileRequest): Observable<GetCustomerProfileResponse>;
+
+  /**
+   * Чи рахує акції CRM. Кошику це потрібно, щоб не показувати ВЛАСНІ
+   * автоакції поверх тих, які потім перерахує CRM: інакше клієнт бачить одну
+   * знижку в кошику й іншу на чекауті, а менеджер — «акція є в CRM, а сайт її
+   * не бачить».
+   */
+
+  getCalculationMode(request: GetCalculationModeRequest): Observable<GetCalculationModeResponse>;
 }
 
 export interface CrmCalculationServiceController {
@@ -156,6 +181,17 @@ export interface CrmCalculationServiceController {
   getCustomerProfile(
     request: GetCustomerProfileRequest,
   ): Promise<GetCustomerProfileResponse> | Observable<GetCustomerProfileResponse> | GetCustomerProfileResponse;
+
+  /**
+   * Чи рахує акції CRM. Кошику це потрібно, щоб не показувати ВЛАСНІ
+   * автоакції поверх тих, які потім перерахує CRM: інакше клієнт бачить одну
+   * знижку в кошику й іншу на чекауті, а менеджер — «акція є в CRM, а сайт її
+   * не бачить».
+   */
+
+  getCalculationMode(
+    request: GetCalculationModeRequest,
+  ): Promise<GetCalculationModeResponse> | Observable<GetCalculationModeResponse> | GetCalculationModeResponse;
 }
 
 export function CrmCalculationServiceControllerMethods() {
@@ -166,6 +202,7 @@ export function CrmCalculationServiceControllerMethods() {
       "reserveBonuses",
       "releaseBonusReserve",
       "getCustomerProfile",
+      "getCalculationMode",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/promotion.ts

@@ -195,7 +195,23 @@ export interface PromotionListItem {
   discountType: DiscountType;
   source?: string | undefined;
   planfixId?: string | undefined;
-  seoSlug?: string | undefined;
+  seoSlug?:
+    | string
+    | undefined;
+  /**
+   * Параметри механіки — щоб список показував, ЩО саме дає акція.
+   * Без них бандли, каскади й позиційні знижки малювались як «0 %»:
+   * їхня знижка живе не в `discount_value`, і рядок виглядав зламаним.
+   */
+  buyQuantity?: number | undefined;
+  getQuantity?: number | undefined;
+  bundlePrice?: number | undefined;
+  bundleSize?:
+    | number
+    | undefined;
+  /** JSON-рядком — так само, як у детальному повідомленні вище. */
+  cascadeSteps?: string | undefined;
+  positionSteps?: string | undefined;
 }
 
 export interface PromotionListItem_NameEntry {

package/package.json

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

package/proto/calculation.proto

@@ -90,10 +90,27 @@ message GiftSuggestion {
   double min_order_amount = 5;
 }
 
+// Частка знижки, що припадає на КОНКРЕТНУ позицію кошика.
+//
+// `item_index` — позиція в масиві `items` запиту, а не productId: у кошику
+// можуть лежати два рядки одного товару (різні варіанти/кольори), і за
+// productId їх не розрізнити. Порядок масиву зберігається на всьому шляху,
+// тож індекс однозначний.
+message ItemDiscount {
+  int32 item_index = 1;
+  double amount = 2;
+}
+
 message AppliedPromotion {
   string promotion_id = 1;
   string promotion_name = 2;
   double discount_amount = 3;
+
+  // Рознесення `discount_amount` по позиціях. Двигун знає, з яких саме
+  // одиниць він зняв гроші (найдешевші в подарунок, найдорожчі в набір,
+  // задані позиції в чеку), і віддає це назовні. Порожній масив = споживач
+  // має право розкласти суму пропорційно сам.
+  repeated ItemDiscount item_discounts = 4;
 }
 
 message AppliedCoupon {
@@ -101,5 +118,7 @@ message AppliedCoupon {
   string code = 2;
   string promotion_id = 3;
   double discount_amount = 4;
+
+  repeated ItemDiscount item_discounts = 5;
 }
 

package/proto/crm_calculation.proto

@@ -11,6 +11,19 @@ service CrmCalculationService {
   rpc ReleaseBonusReserve(ReleaseBonusReserveRequest) returns (ReleaseBonusReserveResponse);
 
   rpc GetCustomerProfile(GetCustomerProfileRequest) returns (GetCustomerProfileResponse);
+
+  // Чи рахує акції CRM. Кошику це потрібно, щоб не показувати ВЛАСНІ
+  // автоакції поверх тих, які потім перерахує CRM: інакше клієнт бачить одну
+  // знижку в кошику й іншу на чекауті, а менеджер — «акція є в CRM, а сайт її
+  // не бачить».
+  rpc GetCalculationMode(GetCalculationModeRequest) returns (GetCalculationModeResponse);
+}
+
+message GetCalculationModeRequest {}
+
+message GetCalculationModeResponse {
+  // true — джерело правди щодо акцій це CRM.
+  bool crm_promotions = 1;
 }
 
 message CrmCalculationItem {
@@ -83,6 +96,13 @@ message CalculateCartResponse {
   string raw_result = 15;
 
   int32 duration_ms = 16;
+
+  // Чому підсумок узяли НЕ з CRM. Порожнє — узяли з CRM.
+  //
+  // Без цього поля «CRM не порахувала» виглядало точно так само, як «у CRM
+  // немає акцій»: кошик показував локальний розрахунок під міткою PLANFIX, і
+  // менеджер не мав жодного способу відрізнити ці випадки.
+  string fallback_reason = 17;
 }
 
 message ReserveBonusesRequest {

package/proto/promotion.proto

@@ -216,6 +216,17 @@ message PromotionListItem {
   optional string source       = 16;
   optional string planfix_id   = 17;
   optional string seo_slug     = 18;
+
+  // Параметри механіки — щоб список показував, ЩО саме дає акція.
+  // Без них бандли, каскади й позиційні знижки малювались як «0 %»:
+  // їхня знижка живе не в `discount_value`, і рядок виглядав зламаним.
+  optional int32  buy_quantity  = 19;
+  optional int32  get_quantity  = 20;
+  optional double bundle_price  = 21;
+  optional int32  bundle_size   = 22;
+  // JSON-рядком — так само, як у детальному повідомленні вище.
+  optional string cascade_steps  = 23;
+  optional string position_steps = 24;
 }