@mamindom/contracts 1.0.125 → 1.0.127

package/gen/notification.ts

@@ -0,0 +1,427 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v3.21.12
+// source: notification.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "notification.v1";
+
+export enum NotificationChannel {
+  NOTIFICATION_CHANNEL_UNSPECIFIED = 0,
+  EMAIL = 1,
+  SMS = 2,
+  TELEGRAM = 3,
+  UNRECOGNIZED = -1,
+}
+
+export enum NotificationLocale {
+  NOTIFICATION_LOCALE_UNSPECIFIED = 0,
+  UK = 1,
+  RU = 2,
+  UNRECOGNIZED = -1,
+}
+
+export enum NotificationCategory {
+  NOTIFICATION_CATEGORY_UNSPECIFIED = 0,
+  TRANSACTIONAL = 1,
+  ACCOUNT = 2,
+  MARKETING = 3,
+  ADMIN = 4,
+  OTP = 5,
+  UNRECOGNIZED = -1,
+}
+
+export enum NotificationStatus {
+  NOTIFICATION_STATUS_UNSPECIFIED = 0,
+  PENDING = 1,
+  SENT = 2,
+  FAILED = 3,
+  SIMULATED = 4,
+  SUPPRESSED = 5,
+  UNRECOGNIZED = -1,
+}
+
+export enum TelegramTopic {
+  TELEGRAM_TOPIC_UNSPECIFIED = 0,
+  ORDERS = 1,
+  ORDERS_ALERTS = 2,
+  PAYMENTS = 3,
+  WAREHOUSE = 4,
+  REVIEWS = 5,
+  CALLBACK = 6,
+  REPORTS = 7,
+  ALERTS = 8,
+  GENERAL = 9,
+  UNRECOGNIZED = -1,
+}
+
+export interface NotificationTemplate {
+  id: string;
+  key: string;
+  channel: NotificationChannel;
+  locale: NotificationLocale;
+  category: NotificationCategory;
+  title: string;
+  subject: string;
+  /**
+   * JSON-stringified Tiptap content (передаємо як string щоб не
+   * використовувати proto google.protobuf.Struct).
+   */
+  contentJson: string;
+  bodyHtml: string;
+  bodyText: string;
+  /** JSON array of variable names (для autocomplete). */
+  variablesJson: string;
+  isActive: boolean;
+  version: number;
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface TemplateResponse {
+  ok: boolean;
+  template: NotificationTemplate | undefined;
+  errorMessage: string;
+}
+
+export interface ListTemplatesRequest {
+  channel?: NotificationChannel | undefined;
+  locale?: NotificationLocale | undefined;
+  category?: NotificationCategory | undefined;
+  search?: string | undefined;
+}
+
+export interface ListTemplatesResponse {
+  items: NotificationTemplate[];
+}
+
+export interface GetTemplateRequest {
+  id: string;
+}
+
+export interface UpsertTemplateRequest {
+  key: string;
+  channel: NotificationChannel;
+  locale: NotificationLocale;
+  category: NotificationCategory;
+  title: string;
+  subject: string;
+  contentJson: string;
+  bodyHtml: string;
+  bodyText: string;
+  variablesJson: string;
+  isActive: boolean;
+}
+
+export interface UpdateTemplateRequest {
+  id: string;
+  title?: string | undefined;
+  subject?: string | undefined;
+  contentJson?: string | undefined;
+  bodyHtml: string;
+  bodyText: string;
+  variablesJson?: string | undefined;
+  isActive?:
+    | boolean
+    | undefined;
+  /** Admin id для audit (хто змінив). */
+  actorId?: string | undefined;
+}
+
+export interface ToggleTemplateRequest {
+  id: string;
+  isActive: boolean;
+}
+
+export interface NotificationTemplateVersion {
+  id: string;
+  version: number;
+  title: string;
+  subject: string;
+  contentJson: string;
+  bodyHtml: string;
+  bodyText: string;
+  variablesJson: string;
+  createdById?: string | undefined;
+  createdAt: number;
+}
+
+export interface ListVersionsRequest {
+  templateId: string;
+}
+
+export interface ListVersionsResponse {
+  items: NotificationTemplateVersion[];
+}
+
+export interface RestoreVersionRequest {
+  templateId: string;
+  version: number;
+  actorId?: string | undefined;
+}
+
+export interface RenderPreviewRequest {
+  bodyHtml: string;
+  /** JSON-stringified variables { "order.number": "MD-2026-0001", ... } */
+  variablesJson: string;
+  subject?: string | undefined;
+}
+
+export interface RenderPreviewResponse {
+  html: string;
+  subject: string;
+}
+
+export interface SendTestRequest {
+  templateId: string;
+  /** email або phone (залежно від channel). */
+  recipient: string;
+  /** JSON-stringified test variables. */
+  variablesJson: string;
+}
+
+export interface SendTestResponse {
+  ok: boolean;
+  errorMessage: string;
+}
+
+export interface NotificationLog {
+  id: string;
+  templateKey: string;
+  channel: NotificationChannel;
+  locale: NotificationLocale;
+  recipient: string;
+  orderId?: string | undefined;
+  userId?: string | undefined;
+  status: NotificationStatus;
+  providerMessageId?: string | undefined;
+  providerName?: string | undefined;
+  error?: string | undefined;
+  sentAt?: number | undefined;
+  createdAt: number;
+}
+
+export interface ListLogsRequest {
+  channel?: NotificationChannel | undefined;
+  status?: NotificationStatus | undefined;
+  templateKey?: string | undefined;
+  orderId?: string | undefined;
+  userId?: string | undefined;
+  recipient?: string | undefined;
+  dateFrom?: number | undefined;
+  dateTo?: number | undefined;
+  page: number;
+  limit: number;
+}
+
+export interface ListLogsResponse {
+  items: NotificationLog[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface TelegramChat {
+  id: string;
+  chatId: string;
+  topic: TelegramTopic;
+  label: string;
+  tag?: string | undefined;
+  isActive: boolean;
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface TelegramChatResponse {
+  ok: boolean;
+  chat: TelegramChat | undefined;
+  errorMessage: string;
+}
+
+export interface ListChatsRequest {
+}
+
+export interface ListChatsResponse {
+  items: TelegramChat[];
+}
+
+export interface UpsertChatRequest {
+  chatId: string;
+  topic: TelegramTopic;
+  label: string;
+  tag?: string | undefined;
+  isActive: boolean;
+}
+
+export interface DeleteChatRequest {
+  id: string;
+}
+
+export interface DeleteChatResponse {
+  ok: boolean;
+  errorMessage: string;
+}
+
+export interface TestSendTelegramRequest {
+  chatId: string;
+}
+
+export interface TestSendTelegramResponse {
+  ok: boolean;
+  errorMessage: string;
+}
+
+export const NOTIFICATION_V1_PACKAGE_NAME = "notification.v1";
+
+export interface NotificationTemplateServiceClient {
+  listTemplates(request: ListTemplatesRequest): Observable<ListTemplatesResponse>;
+
+  getTemplate(request: GetTemplateRequest): Observable<TemplateResponse>;
+
+  upsertTemplate(request: UpsertTemplateRequest): Observable<TemplateResponse>;
+
+  updateTemplate(request: UpdateTemplateRequest): Observable<TemplateResponse>;
+
+  toggleTemplate(request: ToggleTemplateRequest): Observable<TemplateResponse>;
+
+  listVersions(request: ListVersionsRequest): Observable<ListVersionsResponse>;
+
+  restoreVersion(request: RestoreVersionRequest): Observable<TemplateResponse>;
+
+  renderPreview(request: RenderPreviewRequest): Observable<RenderPreviewResponse>;
+
+  sendTest(request: SendTestRequest): Observable<SendTestResponse>;
+}
+
+export interface NotificationTemplateServiceController {
+  listTemplates(
+    request: ListTemplatesRequest,
+  ): Promise<ListTemplatesResponse> | Observable<ListTemplatesResponse> | ListTemplatesResponse;
+
+  getTemplate(request: GetTemplateRequest): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+
+  upsertTemplate(
+    request: UpsertTemplateRequest,
+  ): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+
+  updateTemplate(
+    request: UpdateTemplateRequest,
+  ): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+
+  toggleTemplate(
+    request: ToggleTemplateRequest,
+  ): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+
+  listVersions(
+    request: ListVersionsRequest,
+  ): Promise<ListVersionsResponse> | Observable<ListVersionsResponse> | ListVersionsResponse;
+
+  restoreVersion(
+    request: RestoreVersionRequest,
+  ): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+
+  renderPreview(
+    request: RenderPreviewRequest,
+  ): Promise<RenderPreviewResponse> | Observable<RenderPreviewResponse> | RenderPreviewResponse;
+
+  sendTest(request: SendTestRequest): Promise<SendTestResponse> | Observable<SendTestResponse> | SendTestResponse;
+}
+
+export function NotificationTemplateServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "listTemplates",
+      "getTemplate",
+      "upsertTemplate",
+      "updateTemplate",
+      "toggleTemplate",
+      "listVersions",
+      "restoreVersion",
+      "renderPreview",
+      "sendTest",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("NotificationTemplateService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("NotificationTemplateService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const NOTIFICATION_TEMPLATE_SERVICE_NAME = "NotificationTemplateService";
+
+export interface NotificationLogsServiceClient {
+  listLogs(request: ListLogsRequest): Observable<ListLogsResponse>;
+}
+
+export interface NotificationLogsServiceController {
+  listLogs(request: ListLogsRequest): Promise<ListLogsResponse> | Observable<ListLogsResponse> | ListLogsResponse;
+}
+
+export function NotificationLogsServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["listLogs"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("NotificationLogsService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("NotificationLogsService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const NOTIFICATION_LOGS_SERVICE_NAME = "NotificationLogsService";
+
+export interface TelegramChatsServiceClient {
+  listChats(request: ListChatsRequest): Observable<ListChatsResponse>;
+
+  upsertChat(request: UpsertChatRequest): Observable<TelegramChatResponse>;
+
+  deleteChat(request: DeleteChatRequest): Observable<DeleteChatResponse>;
+
+  testSendTelegram(request: TestSendTelegramRequest): Observable<TestSendTelegramResponse>;
+}
+
+export interface TelegramChatsServiceController {
+  listChats(request: ListChatsRequest): Promise<ListChatsResponse> | Observable<ListChatsResponse> | ListChatsResponse;
+
+  upsertChat(
+    request: UpsertChatRequest,
+  ): Promise<TelegramChatResponse> | Observable<TelegramChatResponse> | TelegramChatResponse;
+
+  deleteChat(
+    request: DeleteChatRequest,
+  ): Promise<DeleteChatResponse> | Observable<DeleteChatResponse> | DeleteChatResponse;
+
+  testSendTelegram(
+    request: TestSendTelegramRequest,
+  ): Promise<TestSendTelegramResponse> | Observable<TestSendTelegramResponse> | TestSendTelegramResponse;
+}
+
+export function TelegramChatsServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["listChats", "upsertChat", "deleteChat", "testSendTelegram"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("TelegramChatsService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("TelegramChatsService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";

package/gen/order.ts

@@ -45,6 +45,11 @@ export interface OrderDelivery {
   trackingUrl: string;
   estimatedDate: string;
   shipmentStatus: string;
+  /**
+   * Адмін-облік: область/регіон з City.region від delivery-service.
+   * Старі замовлення можуть мати порожнє значення.
+   */
+  region: string;
 }
 
 export interface OrderPayment {
@@ -58,6 +63,12 @@ export interface OrderPayment {
   capturedAt: number;
   cancelledAt: number;
   refundedAt: number;
+  /**
+   * Денормалізовано з payment-service для відображення в адмінці
+   * без додаткового gRPC дзвінка. Оновлюється з payment-events listener.
+   */
+  capturedAmount: number;
+  refundedAmount: number;
 }
 
 export interface OrderNote {
@@ -125,6 +136,11 @@ export interface Order {
   tags: string[];
   createdAt: number;
   updatedAt: number;
+  /**
+   * Внутрішні нотатки менеджерів (видимі тільки в адмінці).
+   * Сортуються від новіших до старіших — server-side.
+   */
+  notes: OrderNote[];
 }
 
 export interface CreateOrderRequest {

package/gen/payment.ts

@@ -109,6 +109,11 @@ export interface SyncStatusRequest {
   id: string;
 }
 
+export interface RegenerateInvoiceRequest {
+  id: string;
+  actorId: string;
+}
+
 export interface ListProvidersRequest {
   onlyEnabled: boolean;
 }
@@ -163,6 +168,14 @@ export interface PaymentServiceClient {
 
   syncStatus(request: SyncStatusRequest): Observable<PaymentResponse>;
 
+  /**
+   * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+   * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+   * загубив SMS — менеджер ділиться новим лінком через адмін UI.
+   */
+
+  regenerateInvoice(request: RegenerateInvoiceRequest): Observable<PaymentResponse>;
+
   listProviders(request: ListProvidersRequest): Observable<ListProvidersResponse>;
 
   toggleProvider(request: ToggleProviderRequest): Observable<ToggleProviderResponse>;
@@ -201,6 +214,16 @@ export interface PaymentServiceController {
 
   syncStatus(request: SyncStatusRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
+  /**
+   * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+   * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+   * загубив SMS — менеджер ділиться новим лінком через адмін UI.
+   */
+
+  regenerateInvoice(
+    request: RegenerateInvoiceRequest,
+  ): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
+
   listProviders(
     request: ListProvidersRequest,
   ): Promise<ListProvidersResponse> | Observable<ListProvidersResponse> | ListProvidersResponse;
@@ -221,6 +244,7 @@ export function PaymentServiceControllerMethods() {
       "cancel",
       "refund",
       "syncStatus",
+      "regenerateInvoice",
       "listProviders",
       "toggleProvider",
     ];

package/gen/product.ts

@@ -121,7 +121,11 @@ export interface ProductListItemResponse {
   rating: number;
   reviewCount: number;
   stickers: ProductStickerResponse[];
-  activePromo?: ProductPromoInfo | undefined;
+  activePromo?:
+    | ProductPromoInfo
+    | undefined;
+  /** Вага у кг для розрахунку доставки (0 → fallback на defaultItemWeightKg). */
+  weightKg: number;
 }
 
 export interface ProductListItemResponse_NameEntry {
@@ -169,6 +173,8 @@ export interface ProductDetailResponse {
   manualRating?: number | undefined;
   activePromo?: ProductPromoInfo | undefined;
   colors: ProductColorResponse[];
+  /** Вага товару у кг для розрахунку доставки (variant може override'ити). */
+  weightKg: number;
 }
 
 export interface ProductDetailResponse_NameEntry {
@@ -379,6 +385,7 @@ export interface CreateProductRequest {
   groupId?: string | undefined;
   colorLabel: { [key: string]: string };
   colorHex?: string | undefined;
+  weightKg?: number | undefined;
 }
 
 export interface CreateProductRequest_NameEntry {
@@ -437,6 +444,7 @@ export interface UpdateProductRequest {
   colorLabel: { [key: string]: string };
   colorHex?: string | undefined;
   manualRating?: number | undefined;
+  weightKg?: number | undefined;
 }
 
 export interface UpdateProductRequest_NameEntry {
@@ -688,7 +696,11 @@ export interface ProductVariantDetailResponse {
   images: ProductImageResponse[];
   attributes: ProductAttributeResponse[];
   overrides: VariantOverrides | undefined;
-  colorId?: string | undefined;
+  colorId?:
+    | string
+    | undefined;
+  /** Override-вага варіанту у кг; 0 означає "успадкувати від продукту". */
+  weightKg: number;
 }
 
 export interface ProductVariantDetailResponse_OptionsEntry {
@@ -733,6 +745,7 @@ export interface VariantOverrides {
   hasOwnAttributes: boolean;
   hasOwnVideo: boolean;
   hasOwnOldPrice: boolean;
+  hasOwnWeight: boolean;
 }
 
 export interface CreateProductVariantRequest {
@@ -754,7 +767,11 @@ export interface CreateProductVariantRequest {
   videoUrl?: string | undefined;
   images: ProductImagePayload[];
   attributeValueIds: string[];
-  colorId?: string | undefined;
+  colorId?:
+    | string
+    | undefined;
+  /** Override-вага варіанту у кг (null/unset → успадкувати від продукту). */
+  weightKg?: number | undefined;
 }
 
 export interface CreateProductVariantRequest_OptionsEntry {
@@ -806,7 +823,11 @@ export interface UpdateProductVariantRequest {
   videoUrl?: string | undefined;
   images: ProductImagePayload[];
   attributeValueIds: string[];
-  colorId?: string | undefined;
+  colorId?:
+    | string
+    | undefined;
+  /** Override-вага варіанту у кг (null/unset → успадкувати від продукту). */
+  weightKg?: number | undefined;
   clearPrice: boolean;
   clearOldPrice: boolean;
   clearName: boolean;
@@ -819,6 +840,7 @@ export interface UpdateProductVariantRequest {
   clearAttributes: boolean;
   clearVideo: boolean;
   clearColor: boolean;
+  clearWeight: boolean;
 }
 
 export interface UpdateProductVariantRequest_OptionsEntry {
@@ -902,7 +924,11 @@ export interface VariantLookupResult {
   /** Локалізована назва (uk → ru → перше) для зручності клієнта. */
   nameUk: string;
   mainImage: string;
-  colorId?: string | undefined;
+  colorId?:
+    | string
+    | undefined;
+  /** Вага у кг (variant.weight_kg ?? product.weight_kg ?? 0). */
+  weightKg: number;
 }
 
 export interface BulkLookupVariantsRequest {