@mamindom/contracts 1.0.192 → 1.0.200

package/events/auth/otp-requested.interface.ts

@@ -1,13 +1,12 @@
 export interface OtpRequestedEvent {
-	// Target: email або phone (визначається за наявності '@').
 	target: string
-	// Категорія: 'login' | 'verify' | 'password_reset'.
+
 	purpose: string
 	code: string
-	// TTL (ms epoch).
+
 	expiresAt: number
 	userId?: string
-	// Backward-compat: deprecated alias для target.
+
 	identifier?: string
 	type?: string
 }

package/events/auth/user-authenticated.interface.ts

@@ -2,4 +2,7 @@ export interface UserAuthenticatedEvent {
 	userId: string
 	email?: string
 	phone?: string
+
+	isEmailVerified?: boolean
+	isPhoneVerified?: boolean
 }

package/events/orders/index.ts

@@ -1,4 +1,5 @@
 export * from './order-cancelled.interface'
 export * from './order-created.interface'
+export * from './order-side-effects.interface'
 export * from './order-status-changed.interface'
 export * from './order-crm.interface'

package/events/orders/order-side-effects.interface.ts

@@ -0,0 +1,82 @@
+export interface PaymentCaptureRequestedEvent {
+	orderId: string
+	orderNumber: string
+	providerInvoiceId?: string | null
+
+	amount: string
+}
+
+export interface PaymentCancelRequestedEvent {
+	orderId: string
+	orderNumber: string
+	providerInvoiceId?: string | null
+}
+
+export interface PaymentRefundRequestedEvent {
+	orderId: string
+	orderNumber: string
+	providerInvoiceId?: string | null
+
+	amount?: string
+	reason?: string
+}
+
+export interface DeliveryShipmentRequestedEvent {
+	orderId: string
+	orderNumber: string
+	method: string
+
+	cityRef?: string
+	warehouseRef?: string
+	address?: string
+	recipientName: string
+	recipientPhone: string
+	items: Array<{
+		sku: string
+		name: string
+		quantity: number
+		price: string
+
+		weightKg?: number
+	}>
+}
+
+export interface PromotionApplyRequestedEvent {
+	orderId: string
+	userId: string
+
+	couponCodes?: Array<{
+		code: string
+		discountAmount: string
+	}>
+
+	couponCode?: string
+	couponDiscount?: string
+
+	promotions?: Array<{
+		promotionId: string
+		discountAmount: string
+	}>
+}
+
+export interface OrderTotalsRecalculatedEvent {
+	orderId: string
+	orderNumber: string
+	userId?: string
+	source: string
+	actorId?: string
+
+	itemsSubtotal: string
+	shippingCost: string
+	promoDiscount: string
+	couponDiscount: string
+
+	bonusesBefore: string
+	bonusesAfter: string
+	certificateBefore: string
+	certificateAfter: string
+	grandTotalBefore: string
+	grandTotalAfter: string
+
+	recalculatedAt: number
+}

package/gen/banner.ts

@@ -216,6 +216,8 @@ export interface UpdateBannerSlideRequest {
   linksLayout?: string | undefined;
   styling?: string | undefined;
   sortOrder?: number | undefined;
+  clearButtons: boolean;
+  clearLinks: boolean;
 }
 
 export interface UpdateBannerSlideRequest_TitleEntry {
@@ -245,7 +247,6 @@ export interface UpdateSlideOrderRequest {
 export interface GetBannersByPlacementRequest {
   placement: BannerPlacement;
   categoryId?: string | undefined;
-  lang?: string | undefined;
 }
 
 export interface PublicBannerResponse {
@@ -258,16 +259,26 @@ export interface PublicBannerResponse {
 export interface PublicSlideResponse {
   image: string;
   mobileImage?: string | undefined;
-  title?: string | undefined;
-  subtitle?: string | undefined;
-  buttons: PublicBannerSlideButton[];
+  title: { [key: string]: string };
+  subtitle: { [key: string]: string };
+  buttons: BannerSlideButton[];
   buttonsPosition?: ElementPosition | undefined;
-  links: PublicBannerSlideLink[];
+  links: BannerSlideLink[];
   linksPosition?: ElementPosition | undefined;
   linksLayout?: string | undefined;
   styling: string;
 }
 
+export interface PublicSlideResponse_TitleEntry {
+  key: string;
+  value: string;
+}
+
+export interface PublicSlideResponse_SubtitleEntry {
+  key: string;
+  value: string;
+}
+
 export interface GetBannersByPlacementResponse {
   items: PublicBannerResponse[];
 }
@@ -312,30 +323,6 @@ export interface BannerSlideLink_TextEntry {
   value: string;
 }
 
-export interface PublicBannerSlideButton {
-  text: string;
-  href: string;
-  variant?: string | undefined;
-  backgroundColor?: string | undefined;
-  textColor?: string | undefined;
-  borderColor?: string | undefined;
-  borderRadius?: string | undefined;
-  fontSize?: string | undefined;
-  paddingX?: string | undefined;
-  paddingY?: string | undefined;
-  fontSizeMobile?: string | undefined;
-  paddingXMobile?: string | undefined;
-  paddingYMobile?: string | undefined;
-  textAlign?: string | undefined;
-  textAlignMobile?: string | undefined;
-}
-
-export interface PublicBannerSlideLink {
-  text: string;
-  href: string;
-  categoryId?: string | undefined;
-}
-
 export const CONTENT_V1_PACKAGE_NAME = "content.v1";
 
 export interface BannerServiceClient {

package/gen/calculation.ts

@@ -7,16 +7,34 @@
 /* eslint-disable */
 import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
 import { Observable } from "rxjs";
-import { SuccessResponse } from "./common_promo";
 
 export const protobufPackage = "promo.v1";
 
+export interface ValidateCouponRequest {
+  code: string;
+  userId: string;
+  items: CartItem[];
+  orderTotal: number;
+  isFirstOrder: boolean;
+  orderCount: number;
+  userGroups: string[];
+}
+
+export interface ValidateCouponResponse {
+  usable: boolean;
+  reason: string;
+  permanent: boolean;
+  discountAmount: number;
+  minOrderAmount: number;
+}
+
 export interface CartItem {
   productId: string;
   categoryId: string;
   brandId: string;
   quantity: number;
   price: number;
+  categoryIds: string[];
 }
 
 export interface ValidateAndCalculateRequest {
@@ -38,7 +56,9 @@ export interface ValidateAndCalculateResponse {
   appliedCoupon?: AppliedCoupon | undefined;
   errorMessage?: string | undefined;
   couponError?: string | undefined;
+  couponErrorReason?: string | undefined;
   giftSuggestions: GiftSuggestion[];
+  appliedCoupons: AppliedCoupon[];
 }
 
 export interface GiftSuggestion {
@@ -62,20 +82,12 @@ export interface AppliedCoupon {
   discountAmount: number;
 }
 
-export interface ApplyPromotionRequest {
-  userId: string;
-  orderId: string;
-  discountAmount: number;
-  couponCode?: string | undefined;
-  promotionIds: string[];
-}
-
 export const PROMO_V1_PACKAGE_NAME = "promo.v1";
 
 export interface PromoCalculationServiceClient {
   validateAndCalculate(request: ValidateAndCalculateRequest): Observable<ValidateAndCalculateResponse>;
 
-  applyPromotion(request: ApplyPromotionRequest): Observable<SuccessResponse>;
+  validateCoupon(request: ValidateCouponRequest): Observable<ValidateCouponResponse>;
 }
 
 export interface PromoCalculationServiceController {
@@ -83,14 +95,14 @@ export interface PromoCalculationServiceController {
     request: ValidateAndCalculateRequest,
   ): Promise<ValidateAndCalculateResponse> | Observable<ValidateAndCalculateResponse> | ValidateAndCalculateResponse;
 
-  applyPromotion(
-    request: ApplyPromotionRequest,
-  ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
+  validateCoupon(
+    request: ValidateCouponRequest,
+  ): Promise<ValidateCouponResponse> | Observable<ValidateCouponResponse> | ValidateCouponResponse;
 }
 
 export function PromoCalculationServiceControllerMethods() {
   return function (constructor: Function) {
-    const grpcMethods: string[] = ["validateAndCalculate", "applyPromotion"];
+    const grpcMethods: string[] = ["validateAndCalculate", "validateCoupon"];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
       GrpcMethod("PromoCalculationService", method)(constructor.prototype[method], method, descriptor);

package/gen/cart.ts

@@ -28,6 +28,8 @@ export interface CartItem {
   lineDiscount: number;
   lineTotal: number;
   size: string;
+  unavailable: boolean;
+  availableStock: number;
 }
 
 export interface AppliedPromotion {
@@ -55,6 +57,7 @@ export interface AppliedCertificate {
 export interface AppliedBonuses {
   available: number;
   applied: number;
+  requested: number;
 }
 
 export interface Recipient {
@@ -136,6 +139,8 @@ export interface WishlistItem {
 
 export interface WishlistResponse {
   items: WishlistItem[];
+  ok: boolean;
+  errorMessage: string;
 }
 
 export interface CartOwner {
@@ -163,6 +168,32 @@ export interface AddItemRequest {
   quantity: number;
 }
 
+export interface AddItemInput {
+  productId: string;
+  variantId: string;
+  quantity: number;
+}
+
+export interface AddItemsRequest {
+  owner: CartOwner | undefined;
+  items: AddItemInput[];
+}
+
+export interface AddItemResult {
+  productId: string;
+  variantId: string;
+  ok: boolean;
+  reason: string;
+}
+
+export interface AddItemsResponse {
+  ok: boolean;
+  cart: Cart | undefined;
+  errorMessage: string;
+  results: AddItemResult[];
+  errorCode: string;
+}
+
 export interface UpdateItemQtyRequest {
   owner: CartOwner | undefined;
   variantId: string;
@@ -234,6 +265,7 @@ export interface SetCheckoutDraftRequest {
   hasDelivery: boolean;
   hasPayment: boolean;
   hasComment: boolean;
+  hasDoNotCall: boolean;
 }
 
 export interface RecalculateRequest {
@@ -259,6 +291,7 @@ export interface CartResponse {
   ok: boolean;
   cart: Cart | undefined;
   errorMessage: string;
+  errorCode: string;
 }
 
 export interface SuccessResponse {
@@ -272,6 +305,8 @@ export interface CartServiceClient {
 
   addItem(request: AddItemRequest): Observable<CartResponse>;
 
+  addItems(request: AddItemsRequest): Observable<AddItemsResponse>;
+
   updateItemQty(request: UpdateItemQtyRequest): Observable<CartResponse>;
 
   removeItem(request: RemoveItemRequest): Observable<CartResponse>;
@@ -318,6 +353,8 @@ export interface CartServiceController {
 
   addItem(request: AddItemRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
 
+  addItems(request: AddItemsRequest): Promise<AddItemsResponse> | Observable<AddItemsResponse> | AddItemsResponse;
+
   updateItemQty(request: UpdateItemQtyRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
 
   removeItem(request: RemoveItemRequest): Promise<CartResponse> | Observable<CartResponse> | CartResponse;
@@ -372,6 +409,7 @@ export function CartServiceControllerMethods() {
     const grpcMethods: string[] = [
       "getCart",
       "addItem",
+      "addItems",
       "updateItemQty",
       "removeItem",
       "clearCart",

package/gen/coupon.ts

@@ -68,6 +68,7 @@ export interface GenerateCouponsRequest {
   randomLength?: number | undefined;
   usageLimitPerUser?: number | undefined;
   expiresAt?: string | undefined;
+  usageLimitTotal?: number | undefined;
 }
 
 export interface GenerateCouponsResponse {

package/gen/delivery_settings.ts

@@ -14,7 +14,6 @@ export interface DeliverySettingsResponse {
   defaultItemWeightKg: number;
   freeShippingThreshold: number;
   defaultDeclaredValue: number;
-  npSenderWarehouseRef?: string | undefined;
   updatedAt: string;
 }
 
@@ -25,8 +24,6 @@ export interface UpdateDeliverySettingsRequest {
   defaultItemWeightKg?: number | undefined;
   freeShippingThreshold?: number | undefined;
   defaultDeclaredValue?: number | undefined;
-  npSenderWarehouseRef?: string | undefined;
-  clearNpSenderWarehouseRef: boolean;
 }
 
 export interface ListCarriersRequest {

package/gen/notification.ts

@@ -28,6 +28,7 @@ export enum CampaignRecipientStatusEnum {
   RECIPIENT_FAILED = 3,
   RECIPIENT_SKIPPED_OPT_OUT = 4,
   RECIPIENT_SKIPPED_NO_CONTACT = 5,
+  RECIPIENT_SENDING = 6,
   UNRECOGNIZED = -1,
 }
 
@@ -98,6 +99,29 @@ export interface SendToCustomerResponse {
   logId: string;
 }
 
+export interface VerifyUnsubscribeTokenRequest {
+  token: string;
+}
+
+export interface VerifyUnsubscribeTokenResponse {
+  ok: boolean;
+  errorMessage: string;
+  email?: string | undefined;
+  userId?: string | undefined;
+  unsubscribedFrom: string[];
+}
+
+export interface ApplyUnsubscribeRequest {
+  token: string;
+  categories: string[];
+}
+
+export interface ApplyUnsubscribeResponse {
+  ok: boolean;
+  errorMessage: string;
+  categories: string[];
+}
+
 export interface EnqueueRecipientsRequest {
   campaignId: string;
   recipients: CampaignResolvedRecipient[];
@@ -327,6 +351,7 @@ export interface UpsertTemplateRequest {
   bodyText: string;
   variablesJson: string;
   isActive: boolean;
+  actorId?: string | undefined;
 }
 
 export interface UpdateTemplateRequest {
@@ -334,8 +359,8 @@ export interface UpdateTemplateRequest {
   title?: string | undefined;
   subject?: string | undefined;
   contentJson?: string | undefined;
-  bodyHtml: string;
-  bodyText: string;
+  bodyHtml?: string | undefined;
+  bodyText?: string | undefined;
   variablesJson?: string | undefined;
   isActive?: boolean | undefined;
   actorId?: string | undefined;
@@ -597,6 +622,42 @@ export function NotificationLogsServiceControllerMethods() {
 
 export const NOTIFICATION_LOGS_SERVICE_NAME = "NotificationLogsService";
 
+export interface NotificationConsentServiceClient {
+  verifyUnsubscribeToken(request: VerifyUnsubscribeTokenRequest): Observable<VerifyUnsubscribeTokenResponse>;
+
+  applyUnsubscribe(request: ApplyUnsubscribeRequest): Observable<ApplyUnsubscribeResponse>;
+}
+
+export interface NotificationConsentServiceController {
+  verifyUnsubscribeToken(
+    request: VerifyUnsubscribeTokenRequest,
+  ):
+    | Promise<VerifyUnsubscribeTokenResponse>
+    | Observable<VerifyUnsubscribeTokenResponse>
+    | VerifyUnsubscribeTokenResponse;
+
+  applyUnsubscribe(
+    request: ApplyUnsubscribeRequest,
+  ): Promise<ApplyUnsubscribeResponse> | Observable<ApplyUnsubscribeResponse> | ApplyUnsubscribeResponse;
+}
+
+export function NotificationConsentServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["verifyUnsubscribeToken", "applyUnsubscribe"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("NotificationConsentService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("NotificationConsentService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const NOTIFICATION_CONSENT_SERVICE_NAME = "NotificationConsentService";
+
 export interface TelegramChatsServiceClient {
   listChats(request: ListChatsRequest): Observable<ListChatsResponse>;
 

package/gen/order.ts

@@ -212,7 +212,7 @@ export interface Order {
   delivery: OrderDelivery | undefined;
   payment: OrderPayment | undefined;
   totals: OrderTotals | undefined;
-  promoCode: string;
+  promoCodes: string[];
   certificateCode: string;
   doNotCall: boolean;
   comment: string;
@@ -368,6 +368,28 @@ export interface EditItemsRequest {
   id: string;
   items: OrderItemInput[];
   actorId: string;
+  acceptDiscountChange: boolean;
+}
+
+export interface PreviewRecalculationRequest {
+  id: string;
+  items: OrderItemInput[];
+}
+
+export interface DiscountChange {
+  kind: string;
+  name: string;
+  before: number;
+  after: number;
+}
+
+export interface PreviewRecalculationResponse {
+  ok: boolean;
+  errorMessage: string;
+  before: OrderTotals | undefined;
+  after: OrderTotals | undefined;
+  discountChanges: DiscountChange[];
+  discountsDecreased: boolean;
 }
 
 export interface ApplyRecalculationRequest {
@@ -381,6 +403,7 @@ export interface ApplyRecalculationRequest {
   bonusesUsed: number;
   shippingCost: number;
   grandTotal: number;
+  idempotencyKey: string;
 }
 
 export interface SetTrackingNumberRequest {
@@ -395,12 +418,19 @@ export interface ReorderOrderRequest {
   userId: string;
 }
 
+export interface ReorderSkippedItem {
+  productId: string;
+  variantId: string;
+  reason: string;
+}
+
 export interface ReorderResponse {
   ok: boolean;
   cartId: string;
   added: number;
   skipped: number;
   error: string;
+  skippedItems: ReorderSkippedItem[];
 }
 
 export interface ListHistoryRequest {
@@ -450,6 +480,8 @@ export interface OrderServiceClient {
 
   editItems(request: EditItemsRequest): Observable<OrderResponse>;
 
+  previewRecalculation(request: PreviewRecalculationRequest): Observable<PreviewRecalculationResponse>;
+
   setTrackingNumber(request: SetTrackingNumberRequest): Observable<OrderResponse>;
 
   applyRecalculation(request: ApplyRecalculationRequest): Observable<OrderResponse>;
@@ -506,6 +538,10 @@ export interface OrderServiceController {
 
   editItems(request: EditItemsRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
 
+  previewRecalculation(
+    request: PreviewRecalculationRequest,
+  ): Promise<PreviewRecalculationResponse> | Observable<PreviewRecalculationResponse> | PreviewRecalculationResponse;
+
   setTrackingNumber(
     request: SetTrackingNumberRequest,
   ): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
@@ -549,6 +585,7 @@ export function OrderServiceControllerMethods() {
       "addTag",
       "removeTag",
       "editItems",
+      "previewRecalculation",
       "setTrackingNumber",
       "applyRecalculation",
       "setCrmOrderId",

package/gen/payment.ts

@@ -29,6 +29,8 @@ export interface Payment {
   capturedAt: number;
   cancelledAt: number;
   refundedAt: number;
+  captureSource: string;
+  captureNote: string;
 }
 
 export interface PaymentProviderInfo {
@@ -38,10 +40,6 @@ export interface PaymentProviderInfo {
   supportsInstallment: boolean;
   description: string;
   configured: boolean;
-  /**
-   * Для installment-провайдерів — максимум частин оплати (з конфігу `parts`).
-   * 0 для звичайних провайдерів. Фронт показує «до N платежів» без env-синхронізації.
-   */
   installmentMaxParts: number;
 }
 
@@ -96,6 +94,13 @@ export interface CaptureRequest {
   actorId: string;
 }
 
+export interface MarkPaidOfflineRequest {
+  id: string;
+  amount: number;
+  note: string;
+  actorId: string;
+}
+
 export interface CancelRequest {
   id: string;
   reason: string;
@@ -188,6 +193,8 @@ export interface PaymentServiceClient {
 
   capture(request: CaptureRequest): Observable<PaymentResponse>;
 
+  markPaidOffline(request: MarkPaidOfflineRequest): Observable<PaymentResponse>;
+
   cancel(request: CancelRequest): Observable<PaymentResponse>;
 
   refund(request: RefundRequest): Observable<PaymentResponse>;
@@ -222,6 +229,10 @@ export interface PaymentServiceController {
 
   capture(request: CaptureRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
+  markPaidOffline(
+    request: MarkPaidOfflineRequest,
+  ): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
+
   cancel(request: CancelRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
   refund(request: RefundRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
@@ -257,6 +268,7 @@ export function PaymentServiceControllerMethods() {
       "getPaymentByOrder",
       "listPayments",
       "capture",
+      "markPaidOffline",
       "cancel",
       "refund",
       "syncStatus",

package/gen/pickup.ts

@@ -23,12 +23,15 @@ export interface PickupPointResponse {
   code1c?: string | undefined;
   schedule?: string | undefined;
   showOnContacts: boolean;
+  isPickup: boolean;
+  sortOrder: number;
 }
 
 export interface GetPickupPointsRequest {
   isActive?: boolean | undefined;
   city?: string | undefined;
   showOnContacts?: boolean | undefined;
+  isPickup?: boolean | undefined;
 }
 
 export interface GetPickupPointsResponse {
@@ -50,6 +53,8 @@ export interface CreatePickupPointRequest {
   code1c?: string | undefined;
   schedule?: string | undefined;
   showOnContacts?: boolean | undefined;
+  isPickup?: boolean | undefined;
+  sortOrder?: number | undefined;
 }
 
 export interface UpdatePickupPointRequest {
@@ -64,6 +69,8 @@ export interface UpdatePickupPointRequest {
   code1c?: string | undefined;
   schedule?: string | undefined;
   showOnContacts?: boolean | undefined;
+  isPickup?: boolean | undefined;
+  sortOrder?: number | undefined;
 }
 
 export interface DeletePickupPointRequest {

package/gen/post.ts

@@ -242,6 +242,9 @@ export interface UpdatePostRequest {
   tagIds: string[];
   images: PostImagePayload[];
   updatedById: string;
+  clearCategories: boolean;
+  clearTags: boolean;
+  clearImages: boolean;
 }
 
 export interface UpdatePostRequest_TitleEntry {