@mamindom/contracts 1.0.129 → 1.0.131

package/gen/notification.ts

@@ -10,6 +10,27 @@ import { Observable } from "rxjs";
 
 export const protobufPackage = "notification.v1";
 
+export enum CampaignStatusEnum {
+  CAMPAIGN_STATUS_UNSPECIFIED = 0,
+  DRAFT = 1,
+  SCHEDULED = 2,
+  RUNNING = 3,
+  COMPLETED = 4,
+  CANCELLED = 5,
+  CAMPAIGN_FAILED = 6,
+  UNRECOGNIZED = -1,
+}
+
+export enum CampaignRecipientStatusEnum {
+  CAMPAIGN_RECIPIENT_UNSPECIFIED = 0,
+  RECIPIENT_PENDING = 1,
+  RECIPIENT_SENT = 2,
+  RECIPIENT_FAILED = 3,
+  RECIPIENT_SKIPPED_OPT_OUT = 4,
+  RECIPIENT_SKIPPED_NO_CONTACT = 5,
+  UNRECOGNIZED = -1,
+}
+
 export enum NotificationChannel {
   NOTIFICATION_CHANNEL_UNSPECIFIED = 0,
   EMAIL = 1,
@@ -59,6 +80,210 @@ export enum TelegramTopic {
   UNRECOGNIZED = -1,
 }
 
+/**
+ * SendToCustomer — викликається з gateway після того, як клієнтський контакт
+ * (email/phone) вже резолвнений і опційно згенерований персональний купон.
+ */
+export interface SendToCustomerRequest {
+  /** userId з auth-service — пишемо в NotificationLog.user_id для зведень. */
+  userId: string;
+  channel: NotificationChannel;
+  /** Recipient — email або phone, заздалегідь визначені gateway з акаунта. */
+  recipient: string;
+  /** Шлях 1: templateId — рендеримо існуючий шаблон з variables. */
+  templateId?:
+    | string
+    | undefined;
+  /**
+   * Шлях 2: ad-hoc контент. Якщо template_id порожній — використовуємо ці поля.
+   * body_html — для EMAIL (буде обгорнутий брендингом).
+   * body_text — для SMS (plain text) або текстова версія email.
+   */
+  customSubject?: string | undefined;
+  customBodyHtml?: string | undefined;
+  customBodyText?:
+    | string
+    | undefined;
+  /** JSON з placeholders для Handlebars: { "coupon_code": "...", ... } */
+  variablesJson: string;
+  /** Locale для пошуку версії шаблону + надсилання branding-обгортки. */
+  locale?: NotificationLocale | undefined;
+}
+
+export interface SendToCustomerResponse {
+  ok: boolean;
+  errorMessage: string;
+  /** id запису в NotificationLog (для трекінгу в /notifications/logs). */
+  logId: string;
+}
+
+export interface EnqueueRecipientsRequest {
+  campaignId: string;
+  recipients: CampaignResolvedRecipient[];
+}
+
+export interface CampaignResolvedRecipient {
+  userId: string;
+  /** email або phone */
+  recipient: string;
+  /**
+   * true → у клієнта promotions=false. dispatcher позначить SKIPPED_OPT_OUT
+   * якщо respect_opt_out=true для кампанії.
+   */
+  optOut: boolean;
+  /**
+   * Унікальний код, згенерований gateway через CouponsService.CreateCoupon.
+   * Підставляється у шаблон як {{coupon_code}}.
+   */
+  couponCode?: string | undefined;
+}
+
+export interface EnqueueRecipientsResponse {
+  enqueued: number;
+}
+
+export interface ListCampaignsRequest {
+  status?: CampaignStatusEnum | undefined;
+  page?: number | undefined;
+  limit?: number | undefined;
+}
+
+export interface ListCampaignsResponse {
+  items: Campaign[];
+  total: number;
+}
+
+export interface GetCampaignRequest {
+  id: string;
+}
+
+export interface DeleteCampaignRequest {
+  id: string;
+}
+
+export interface DeleteCampaignResponse {
+  ok: boolean;
+}
+
+export interface StartCampaignRequest {
+  id: string;
+  /** ISO date; якщо порожньо → запустити одразу. */
+  scheduledAt?: string | undefined;
+}
+
+export interface CancelCampaignRequest {
+  id: string;
+}
+
+export interface CreateCampaignRequest {
+  name: string;
+  channel: NotificationChannel;
+  templateId?: string | undefined;
+  customSubject?: string | undefined;
+  customBodyHtml?: string | undefined;
+  customBodyText?:
+    | string
+    | undefined;
+  /** JSON segment spec. */
+  segmentJson: string;
+  /** JSON coupon spec — null/empty для кампаній без купонів. */
+  couponSpecJson?: string | undefined;
+  respectOptOut: boolean;
+  locale?: NotificationLocale | undefined;
+  createdById: string;
+}
+
+export interface UpdateCampaignRequest {
+  id: string;
+  /** Можна оновлювати тільки DRAFT — гілки нижче опційні. */
+  name?: string | undefined;
+  channel?: NotificationChannel | undefined;
+  templateId?: string | undefined;
+  customSubject?: string | undefined;
+  customBodyHtml?: string | undefined;
+  customBodyText?: string | undefined;
+  segmentJson?: string | undefined;
+  couponSpecJson?: string | undefined;
+  respectOptOut?: boolean | undefined;
+  locale?: NotificationLocale | undefined;
+}
+
+export interface CampaignResponse {
+  ok: boolean;
+  errorMessage: string;
+  campaign: Campaign | undefined;
+}
+
+export interface Campaign {
+  id: string;
+  name: string;
+  channel: NotificationChannel;
+  templateId?: string | undefined;
+  customSubject?: string | undefined;
+  customBodyHtml?: string | undefined;
+  customBodyText?: string | undefined;
+  locale: NotificationLocale;
+  segmentJson: string;
+  couponSpecJson?: string | undefined;
+  respectOptOut: boolean;
+  status: CampaignStatusEnum;
+  scheduledAt?: string | undefined;
+  startedAt?: string | undefined;
+  completedAt?: string | undefined;
+  totalRecipients: number;
+  sentCount: number;
+  failedCount: number;
+  skippedOptOutCount: number;
+  createdById: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface PreviewSegmentRequest {
+  segmentJson: string;
+  /** потрібно для перевірки наявності email/phone */
+  channel: NotificationChannel;
+}
+
+export interface PreviewSegmentResponse {
+  totalCount: number;
+  /** Перші 10 для UI; решта — за необхідності окремим запитом. */
+  sample: PreviewSegmentSample[];
+}
+
+export interface PreviewSegmentSample {
+  userId: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone: string;
+}
+
+export interface ListRecipientsRequest {
+  campaignId: string;
+  status?: CampaignRecipientStatusEnum | undefined;
+  page?: number | undefined;
+  limit?: number | undefined;
+}
+
+export interface ListRecipientsResponse {
+  items: CampaignRecipient[];
+  total: number;
+}
+
+export interface CampaignRecipient {
+  id: string;
+  campaignId: string;
+  userId: string;
+  recipient: string;
+  status: CampaignRecipientStatusEnum;
+  couponCode?: string | undefined;
+  notificationLogId?: string | undefined;
+  errorMessage?: string | undefined;
+  sentAt?: string | undefined;
+  createdAt: string;
+}
+
 export interface BrandingEmpty {
 }
 
@@ -82,6 +307,8 @@ export interface BrandingProfile {
   resolvedBrandName: string;
   resolvedBrandUrl: string;
   resolvedSupportEmail: string;
+  /** Кастомний HTML-хедер (замість дефолтного логотип-блоку). Порожньо → default. */
+  headerHtml: string;
 }
 
 export interface UpdateBrandingRequest {
@@ -92,6 +319,7 @@ export interface UpdateBrandingRequest {
   supportEmail?: string | undefined;
   footerHtml?: string | undefined;
   actorId: string;
+  headerHtml?: string | undefined;
 }
 
 export interface NotificationTemplate {
@@ -203,7 +431,14 @@ export interface RenderPreviewRequest {
   bodyHtml: string;
   /** JSON-stringified variables { "order.number": "MD-2026-0001", ... } */
   variablesJson: string;
-  subject?: string | undefined;
+  subject?:
+    | string
+    | undefined;
+  /**
+   * JSON-stringified branding override (header/footer/logo/brand…) для live-
+   * превʼю незбережених змін на сторінці брендингу. Порожньо → беремо з БД.
+   */
+  brandingJson?: string | undefined;
 }
 
 export interface RenderPreviewResponse {
@@ -330,6 +565,10 @@ export interface NotificationTemplateServiceClient {
   renderPreview(request: RenderPreviewRequest): Observable<RenderPreviewResponse>;
 
   sendTest(request: SendTestRequest): Observable<SendTestResponse>;
+
+  /** Реальна відправка клієнту з адмінки — або по шаблону, або ad-hoc body. */
+
+  sendToCustomer(request: SendToCustomerRequest): Observable<SendToCustomerResponse>;
 }
 
 export interface NotificationTemplateServiceController {
@@ -364,6 +603,12 @@ export interface NotificationTemplateServiceController {
   ): Promise<RenderPreviewResponse> | Observable<RenderPreviewResponse> | RenderPreviewResponse;
 
   sendTest(request: SendTestRequest): Promise<SendTestResponse> | Observable<SendTestResponse> | SendTestResponse;
+
+  /** Реальна відправка клієнту з адмінки — або по шаблону, або ad-hoc body. */
+
+  sendToCustomer(
+    request: SendToCustomerRequest,
+  ): Promise<SendToCustomerResponse> | Observable<SendToCustomerResponse> | SendToCustomerResponse;
 }
 
 export function NotificationTemplateServiceControllerMethods() {
@@ -378,6 +623,7 @@ export function NotificationTemplateServiceControllerMethods() {
       "restoreVersion",
       "renderPreview",
       "sendTest",
+      "sendToCustomer",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
@@ -461,6 +707,118 @@ export function TelegramChatsServiceControllerMethods() {
 
 export const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
 
+/** Маркетингові кампанії: створення, запуск, статистика. */
+
+export interface CampaignsServiceClient {
+  listCampaigns(request: ListCampaignsRequest): Observable<ListCampaignsResponse>;
+
+  getCampaign(request: GetCampaignRequest): Observable<CampaignResponse>;
+
+  createCampaign(request: CreateCampaignRequest): Observable<CampaignResponse>;
+
+  updateCampaign(request: UpdateCampaignRequest): Observable<CampaignResponse>;
+
+  deleteCampaign(request: DeleteCampaignRequest): Observable<DeleteCampaignResponse>;
+
+  startCampaign(request: StartCampaignRequest): Observable<CampaignResponse>;
+
+  cancelCampaign(request: CancelCampaignRequest): Observable<CampaignResponse>;
+
+  /** Превью сегменту — повертає кількість + перші N клієнтів, БЕЗ створення кампанії. */
+
+  previewSegment(request: PreviewSegmentRequest): Observable<PreviewSegmentResponse>;
+
+  /** Список отримувачів конкретної кампанії з їхніми статусами. */
+
+  listRecipients(request: ListRecipientsRequest): Observable<ListRecipientsResponse>;
+
+  /**
+   * Викликається з gateway після того, як сегмент резолвнено клієнтами —
+   * передається список {userId, recipient}, нотифікація розкладає у чергу.
+   */
+
+  enqueueRecipients(request: EnqueueRecipientsRequest): Observable<EnqueueRecipientsResponse>;
+}
+
+/** Маркетингові кампанії: створення, запуск, статистика. */
+
+export interface CampaignsServiceController {
+  listCampaigns(
+    request: ListCampaignsRequest,
+  ): Promise<ListCampaignsResponse> | Observable<ListCampaignsResponse> | ListCampaignsResponse;
+
+  getCampaign(request: GetCampaignRequest): Promise<CampaignResponse> | Observable<CampaignResponse> | CampaignResponse;
+
+  createCampaign(
+    request: CreateCampaignRequest,
+  ): Promise<CampaignResponse> | Observable<CampaignResponse> | CampaignResponse;
+
+  updateCampaign(
+    request: UpdateCampaignRequest,
+  ): Promise<CampaignResponse> | Observable<CampaignResponse> | CampaignResponse;
+
+  deleteCampaign(
+    request: DeleteCampaignRequest,
+  ): Promise<DeleteCampaignResponse> | Observable<DeleteCampaignResponse> | DeleteCampaignResponse;
+
+  startCampaign(
+    request: StartCampaignRequest,
+  ): Promise<CampaignResponse> | Observable<CampaignResponse> | CampaignResponse;
+
+  cancelCampaign(
+    request: CancelCampaignRequest,
+  ): Promise<CampaignResponse> | Observable<CampaignResponse> | CampaignResponse;
+
+  /** Превью сегменту — повертає кількість + перші N клієнтів, БЕЗ створення кампанії. */
+
+  previewSegment(
+    request: PreviewSegmentRequest,
+  ): Promise<PreviewSegmentResponse> | Observable<PreviewSegmentResponse> | PreviewSegmentResponse;
+
+  /** Список отримувачів конкретної кампанії з їхніми статусами. */
+
+  listRecipients(
+    request: ListRecipientsRequest,
+  ): Promise<ListRecipientsResponse> | Observable<ListRecipientsResponse> | ListRecipientsResponse;
+
+  /**
+   * Викликається з gateway після того, як сегмент резолвнено клієнтами —
+   * передається список {userId, recipient}, нотифікація розкладає у чергу.
+   */
+
+  enqueueRecipients(
+    request: EnqueueRecipientsRequest,
+  ): Promise<EnqueueRecipientsResponse> | Observable<EnqueueRecipientsResponse> | EnqueueRecipientsResponse;
+}
+
+export function CampaignsServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "listCampaigns",
+      "getCampaign",
+      "createCampaign",
+      "updateCampaign",
+      "deleteCampaign",
+      "startCampaign",
+      "cancelCampaign",
+      "previewSegment",
+      "listRecipients",
+      "enqueueRecipients",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("CampaignsService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("CampaignsService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const CAMPAIGNS_SERVICE_NAME = "CampaignsService";
+
 /** Брендинг email-шаблонів — singleton редагується адміном. */
 
 export interface BrandingServiceClient {

package/gen/order.ts

@@ -10,6 +10,23 @@ import { Observable } from "rxjs";
 
 export const protobufPackage = "order.v1";
 
+export interface AggregateByCustomersRequest {
+  userIds: string[];
+}
+
+export interface CustomerOrderAggregate {
+  userId: string;
+  ordersCount: number;
+  /** Decimal у вигляді рядка ('1234.56') — щоб не втратити точність на gRPC border. */
+  totalSum: string;
+  /** ISO-рядок, відсутній якщо клієнт ще не робив замовлень. */
+  lastOrderAt?: string | undefined;
+}
+
+export interface AggregateByCustomersResponse {
+  items: CustomerOrderAggregate[];
+}
+
 export interface OrderItem {
   id: string;
   productId: string;
@@ -325,6 +342,10 @@ export interface OrderServiceClient {
   reorderOrder(request: ReorderOrderRequest): Observable<ReorderResponse>;
 
   listHistory(request: ListHistoryRequest): Observable<ListHistoryResponse>;
+
+  /** CRM-агрегація для експорту клієнтів — повертає count/sum/last для кожного userId. */
+
+  aggregateByCustomers(request: AggregateByCustomersRequest): Observable<AggregateByCustomersResponse>;
 }
 
 export interface OrderServiceController {
@@ -371,6 +392,12 @@ export interface OrderServiceController {
   listHistory(
     request: ListHistoryRequest,
   ): Promise<ListHistoryResponse> | Observable<ListHistoryResponse> | ListHistoryResponse;
+
+  /** CRM-агрегація для експорту клієнтів — повертає count/sum/last для кожного userId. */
+
+  aggregateByCustomers(
+    request: AggregateByCustomersRequest,
+  ): Promise<AggregateByCustomersResponse> | Observable<AggregateByCustomersResponse> | AggregateByCustomersResponse;
 }
 
 export function OrderServiceControllerMethods() {
@@ -392,6 +419,7 @@ export function OrderServiceControllerMethods() {
       "setTrackingNumber",
       "reorderOrder",
       "listHistory",
+      "aggregateByCustomers",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/users.ts

@@ -62,6 +62,21 @@ export interface User {
   bonuses: number;
   email?: string | undefined;
   phone?: string | undefined;
+  internalNote?: string | undefined;
+}
+
+export interface AdminUpdateCustomerRequest {
+  id: string;
+  firstName?: string | undefined;
+  lastName?:
+    | string
+    | undefined;
+  /** internal_note редагується тут окремо, бо це CRM-поле — не видиме клієнту. */
+  internalNote?: string | undefined;
+}
+
+export interface AdminUpdateCustomerResponse {
+  user: User | undefined;
 }
 
 export interface NotificationSettings {
@@ -378,6 +393,10 @@ export interface UsersServiceClient {
   clearCart(request: ClearCartRequest): Observable<ClearCartResponse>;
 
   syncCart(request: SyncCartRequest): Observable<GetCartResponse>;
+
+  /** Admin CRM — редагування клієнта менеджером (customers.edit на gateway). */
+
+  adminUpdateCustomer(request: AdminUpdateCustomerRequest): Observable<AdminUpdateCustomerResponse>;
 }
 
 export interface UsersServiceController {
@@ -481,6 +500,12 @@ export interface UsersServiceController {
   clearCart(request: ClearCartRequest): Promise<ClearCartResponse> | Observable<ClearCartResponse> | ClearCartResponse;
 
   syncCart(request: SyncCartRequest): Promise<GetCartResponse> | Observable<GetCartResponse> | GetCartResponse;
+
+  /** Admin CRM — редагування клієнта менеджером (customers.edit на gateway). */
+
+  adminUpdateCustomer(
+    request: AdminUpdateCustomerRequest,
+  ): Promise<AdminUpdateCustomerResponse> | Observable<AdminUpdateCustomerResponse> | AdminUpdateCustomerResponse;
 }
 
 export function UsersServiceControllerMethods() {
@@ -513,6 +538,7 @@ export function UsersServiceControllerMethods() {
       "removeCartItem",
       "clearCart",
       "syncCart",
+      "adminUpdateCustomer",
     ];
     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.129",
+	"version": "1.0.131",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",
 	"exports": {