@mamindom/contracts 1.0.130 → 1.0.131

package/dist/gen/notification.d.ts

@@ -1,5 +1,24 @@
 import { Observable } from "rxjs";
 export declare const protobufPackage = "notification.v1";
+export declare enum CampaignStatusEnum {
+    CAMPAIGN_STATUS_UNSPECIFIED = 0,
+    DRAFT = 1,
+    SCHEDULED = 2,
+    RUNNING = 3,
+    COMPLETED = 4,
+    CANCELLED = 5,
+    CAMPAIGN_FAILED = 6,
+    UNRECOGNIZED = -1
+}
+export declare 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 declare enum NotificationChannel {
     NOTIFICATION_CHANNEL_UNSPECIFIED = 0,
     EMAIL = 1,
@@ -44,6 +63,182 @@ export declare enum TelegramTopic {
     GENERAL = 9,
     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 {
 }
 /**
@@ -281,6 +476,8 @@ export interface NotificationTemplateServiceClient {
     restoreVersion(request: RestoreVersionRequest): Observable<TemplateResponse>;
     renderPreview(request: RenderPreviewRequest): Observable<RenderPreviewResponse>;
     sendTest(request: SendTestRequest): Observable<SendTestResponse>;
+    /** Реальна відправка клієнту з адмінки — або по шаблону, або ad-hoc body. */
+    sendToCustomer(request: SendToCustomerRequest): Observable<SendToCustomerResponse>;
 }
 export interface NotificationTemplateServiceController {
     listTemplates(request: ListTemplatesRequest): Promise<ListTemplatesResponse> | Observable<ListTemplatesResponse> | ListTemplatesResponse;
@@ -292,6 +489,8 @@ export interface NotificationTemplateServiceController {
     restoreVersion(request: RestoreVersionRequest): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
     renderPreview(request: RenderPreviewRequest): 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 declare function NotificationTemplateServiceControllerMethods(): (constructor: Function) => void;
 export declare const NOTIFICATION_TEMPLATE_SERVICE_NAME = "NotificationTemplateService";
@@ -317,6 +516,46 @@ export interface TelegramChatsServiceController {
 }
 export declare function TelegramChatsServiceControllerMethods(): (constructor: Function) => void;
 export declare 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 declare function CampaignsServiceControllerMethods(): (constructor: Function) => void;
+export declare const CAMPAIGNS_SERVICE_NAME = "CampaignsService";
 /** Брендинг email-шаблонів — singleton редагується адміном. */
 export interface BrandingServiceClient {
     getBranding(request: BrandingEmpty): Observable<BrandingProfile>;

package/dist/gen/notification.js

@@ -5,14 +5,36 @@
 //   protoc               v3.21.12
 // source: notification.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BRANDING_SERVICE_NAME = exports.TELEGRAM_CHATS_SERVICE_NAME = exports.NOTIFICATION_LOGS_SERVICE_NAME = exports.NOTIFICATION_TEMPLATE_SERVICE_NAME = exports.NOTIFICATION_V1_PACKAGE_NAME = exports.TelegramTopic = exports.NotificationStatus = exports.NotificationCategory = exports.NotificationLocale = exports.NotificationChannel = exports.protobufPackage = void 0;
+exports.BRANDING_SERVICE_NAME = exports.CAMPAIGNS_SERVICE_NAME = exports.TELEGRAM_CHATS_SERVICE_NAME = exports.NOTIFICATION_LOGS_SERVICE_NAME = exports.NOTIFICATION_TEMPLATE_SERVICE_NAME = exports.NOTIFICATION_V1_PACKAGE_NAME = exports.TelegramTopic = exports.NotificationStatus = exports.NotificationCategory = exports.NotificationLocale = exports.NotificationChannel = exports.CampaignRecipientStatusEnum = exports.CampaignStatusEnum = exports.protobufPackage = void 0;
 exports.NotificationTemplateServiceControllerMethods = NotificationTemplateServiceControllerMethods;
 exports.NotificationLogsServiceControllerMethods = NotificationLogsServiceControllerMethods;
 exports.TelegramChatsServiceControllerMethods = TelegramChatsServiceControllerMethods;
+exports.CampaignsServiceControllerMethods = CampaignsServiceControllerMethods;
 exports.BrandingServiceControllerMethods = BrandingServiceControllerMethods;
 /* eslint-disable */
 const microservices_1 = require("@nestjs/microservices");
 exports.protobufPackage = "notification.v1";
+var CampaignStatusEnum;
+(function (CampaignStatusEnum) {
+    CampaignStatusEnum[CampaignStatusEnum["CAMPAIGN_STATUS_UNSPECIFIED"] = 0] = "CAMPAIGN_STATUS_UNSPECIFIED";
+    CampaignStatusEnum[CampaignStatusEnum["DRAFT"] = 1] = "DRAFT";
+    CampaignStatusEnum[CampaignStatusEnum["SCHEDULED"] = 2] = "SCHEDULED";
+    CampaignStatusEnum[CampaignStatusEnum["RUNNING"] = 3] = "RUNNING";
+    CampaignStatusEnum[CampaignStatusEnum["COMPLETED"] = 4] = "COMPLETED";
+    CampaignStatusEnum[CampaignStatusEnum["CANCELLED"] = 5] = "CANCELLED";
+    CampaignStatusEnum[CampaignStatusEnum["CAMPAIGN_FAILED"] = 6] = "CAMPAIGN_FAILED";
+    CampaignStatusEnum[CampaignStatusEnum["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(CampaignStatusEnum || (exports.CampaignStatusEnum = CampaignStatusEnum = {}));
+var CampaignRecipientStatusEnum;
+(function (CampaignRecipientStatusEnum) {
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["CAMPAIGN_RECIPIENT_UNSPECIFIED"] = 0] = "CAMPAIGN_RECIPIENT_UNSPECIFIED";
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["RECIPIENT_PENDING"] = 1] = "RECIPIENT_PENDING";
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["RECIPIENT_SENT"] = 2] = "RECIPIENT_SENT";
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["RECIPIENT_FAILED"] = 3] = "RECIPIENT_FAILED";
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["RECIPIENT_SKIPPED_OPT_OUT"] = 4] = "RECIPIENT_SKIPPED_OPT_OUT";
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["RECIPIENT_SKIPPED_NO_CONTACT"] = 5] = "RECIPIENT_SKIPPED_NO_CONTACT";
+    CampaignRecipientStatusEnum[CampaignRecipientStatusEnum["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(CampaignRecipientStatusEnum || (exports.CampaignRecipientStatusEnum = CampaignRecipientStatusEnum = {}));
 var NotificationChannel;
 (function (NotificationChannel) {
     NotificationChannel[NotificationChannel["NOTIFICATION_CHANNEL_UNSPECIFIED"] = 0] = "NOTIFICATION_CHANNEL_UNSPECIFIED";
@@ -75,6 +97,7 @@ function NotificationTemplateServiceControllerMethods() {
             "restoreVersion",
             "renderPreview",
             "sendTest",
+            "sendToCustomer",
         ];
         for (const method of grpcMethods) {
             const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
@@ -118,6 +141,32 @@ function TelegramChatsServiceControllerMethods() {
     };
 }
 exports.TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+function CampaignsServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "listCampaigns",
+            "getCampaign",
+            "createCampaign",
+            "updateCampaign",
+            "deleteCampaign",
+            "startCampaign",
+            "cancelCampaign",
+            "previewSegment",
+            "listRecipients",
+            "enqueueRecipients",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("CampaignsService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("CampaignsService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.CAMPAIGNS_SERVICE_NAME = "CampaignsService";
 function BrandingServiceControllerMethods() {
     return function (constructor) {
         const grpcMethods = ["getBranding", "updateBranding"];

package/dist/gen/order.d.ts

@@ -1,5 +1,19 @@
 import { Observable } from "rxjs";
 export declare 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;
@@ -268,6 +282,8 @@ export interface OrderServiceClient {
     setTrackingNumber(request: SetTrackingNumberRequest): Observable<OrderResponse>;
     reorderOrder(request: ReorderOrderRequest): Observable<ReorderResponse>;
     listHistory(request: ListHistoryRequest): Observable<ListHistoryResponse>;
+    /** CRM-агрегація для експорту клієнтів — повертає count/sum/last для кожного userId. */
+    aggregateByCustomers(request: AggregateByCustomersRequest): Observable<AggregateByCustomersResponse>;
 }
 export interface OrderServiceController {
     createOrder(request: CreateOrderRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
@@ -286,6 +302,8 @@ export interface OrderServiceController {
     setTrackingNumber(request: SetTrackingNumberRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
     reorderOrder(request: ReorderOrderRequest): Promise<ReorderResponse> | Observable<ReorderResponse> | ReorderResponse;
     listHistory(request: ListHistoryRequest): Promise<ListHistoryResponse> | Observable<ListHistoryResponse> | ListHistoryResponse;
+    /** CRM-агрегація для експорту клієнтів — повертає count/sum/last для кожного userId. */
+    aggregateByCustomers(request: AggregateByCustomersRequest): Promise<AggregateByCustomersResponse> | Observable<AggregateByCustomersResponse> | AggregateByCustomersResponse;
 }
 export declare function OrderServiceControllerMethods(): (constructor: Function) => void;
 export declare const ORDER_SERVICE_NAME = "OrderService";

package/dist/gen/order.js

@@ -30,6 +30,7 @@ function OrderServiceControllerMethods() {
             "setTrackingNumber",
             "reorderOrder",
             "listHistory",
+            "aggregateByCustomers",
         ];
         for (const method of grpcMethods) {
             const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/dist/gen/users.d.ts

@@ -44,6 +44,17 @@ 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 {
     orderStatuses: boolean;
@@ -280,6 +291,8 @@ export interface UsersServiceClient {
     removeCartItem(request: RemoveCartItemRequest): Observable<GetCartResponse>;
     clearCart(request: ClearCartRequest): Observable<ClearCartResponse>;
     syncCart(request: SyncCartRequest): Observable<GetCartResponse>;
+    /** Admin CRM — редагування клієнта менеджером (customers.edit на gateway). */
+    adminUpdateCustomer(request: AdminUpdateCustomerRequest): Observable<AdminUpdateCustomerResponse>;
 }
 export interface UsersServiceController {
     getMe(request: GetMeRequest): Promise<GetMeResponse> | Observable<GetMeResponse> | GetMeResponse;
@@ -312,6 +325,8 @@ export interface UsersServiceController {
     removeCartItem(request: RemoveCartItemRequest): Promise<GetCartResponse> | Observable<GetCartResponse> | GetCartResponse;
     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 declare function UsersServiceControllerMethods(): (constructor: Function) => void;
 export declare const USERS_SERVICE_NAME = "UsersService";

package/dist/gen/users.js

@@ -55,6 +55,7 @@ function UsersServiceControllerMethods() {
             "removeCartItem",
             "clearCart",
             "syncCart",
+            "adminUpdateCustomer",
         ];
         for (const method of grpcMethods) {
             const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);