@mamindom/contracts 1.0.127 → 1.0.130

package/dist/gen/notification.d.ts

@@ -44,6 +44,41 @@ export declare enum TelegramTopic {
     GENERAL = 9,
     UNRECOGNIZED = -1
 }
+export interface BrandingEmpty {
+}
+/**
+ * Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+ * "взяти fallback з env" при наступному GET.
+ */
+export interface BrandingProfile {
+    logoUrl: string;
+    brandName: string;
+    brandUrl: string;
+    supportEmail: string;
+    footerHtml: string;
+    updatedAt: number;
+    updatedBy: string;
+    /**
+     * resolved: остаточні значення, що використовуються wrapper'ом
+     * (DB override → env fallback). Для UI щоб показати "поточне значення".
+     */
+    resolvedLogoUrl: string;
+    resolvedBrandName: string;
+    resolvedBrandUrl: string;
+    resolvedSupportEmail: string;
+    /** Кастомний HTML-хедер (замість дефолтного логотип-блоку). Порожньо → default. */
+    headerHtml: string;
+}
+export interface UpdateBrandingRequest {
+    /** optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД. */
+    logoUrl?: string | undefined;
+    brandName?: string | undefined;
+    brandUrl?: string | undefined;
+    supportEmail?: string | undefined;
+    footerHtml?: string | undefined;
+    actorId: string;
+    headerHtml?: string | undefined;
+}
 export interface NotificationTemplate {
     id: string;
     key: string;
@@ -140,6 +175,11 @@ export interface RenderPreviewRequest {
     /** JSON-stringified variables { "order.number": "MD-2026-0001", ... } */
     variablesJson: string;
     subject?: string | undefined;
+    /**
+     * JSON-stringified branding override (header/footer/logo/brand…) для live-
+     * превʼю незбережених змін на сторінці брендингу. Порожньо → беремо з БД.
+     */
+    brandingJson?: string | undefined;
 }
 export interface RenderPreviewResponse {
     html: string;
@@ -277,3 +317,15 @@ export interface TelegramChatsServiceController {
 }
 export declare function TelegramChatsServiceControllerMethods(): (constructor: Function) => void;
 export declare const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+export interface BrandingServiceClient {
+    getBranding(request: BrandingEmpty): Observable<BrandingProfile>;
+    updateBranding(request: UpdateBrandingRequest): Observable<BrandingProfile>;
+}
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+export interface BrandingServiceController {
+    getBranding(request: BrandingEmpty): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+    updateBranding(request: UpdateBrandingRequest): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+}
+export declare function BrandingServiceControllerMethods(): (constructor: Function) => void;
+export declare const BRANDING_SERVICE_NAME = "BrandingService";

package/dist/gen/notification.js

@@ -5,10 +5,11 @@
 //   protoc               v3.21.12
 // source: notification.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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.NotificationTemplateServiceControllerMethods = NotificationTemplateServiceControllerMethods;
 exports.NotificationLogsServiceControllerMethods = NotificationLogsServiceControllerMethods;
 exports.TelegramChatsServiceControllerMethods = TelegramChatsServiceControllerMethods;
+exports.BrandingServiceControllerMethods = BrandingServiceControllerMethods;
 /* eslint-disable */
 const microservices_1 = require("@nestjs/microservices");
 exports.protobufPackage = "notification.v1";
@@ -117,3 +118,18 @@ function TelegramChatsServiceControllerMethods() {
     };
 }
 exports.TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+function BrandingServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = ["getBranding", "updateBranding"];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("BrandingService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("BrandingService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.BRANDING_SERVICE_NAME = "BrandingService";

package/dist/proto/notification.proto

@@ -29,6 +29,45 @@ service TelegramChatsService {
   rpc TestSendTelegram (TestSendTelegramRequest) returns (TestSendTelegramResponse);
 }
 
+// Брендинг email-шаблонів — singleton редагується адміном.
+service BrandingService {
+  rpc GetBranding    (BrandingEmpty)         returns (BrandingProfile);
+  rpc UpdateBranding (UpdateBrandingRequest) returns (BrandingProfile);
+}
+
+message BrandingEmpty {}
+
+// Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+// "взяти fallback з env" при наступному GET.
+message BrandingProfile {
+  string logo_url      = 1;
+  string brand_name    = 2;
+  string brand_url     = 3;
+  string support_email = 4;
+  string footer_html   = 5;
+  int64  updated_at    = 6;
+  string updated_by    = 7;
+  // resolved: остаточні значення, що використовуються wrapper'ом
+  // (DB override → env fallback). Для UI щоб показати "поточне значення".
+  string resolved_logo_url      = 8;
+  string resolved_brand_name    = 9;
+  string resolved_brand_url     = 10;
+  string resolved_support_email = 11;
+  // Кастомний HTML-хедер (замість дефолтного логотип-блоку). Порожньо → default.
+  string header_html            = 12;
+}
+
+message UpdateBrandingRequest {
+  // optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД.
+  optional string logo_url      = 1;
+  optional string brand_name    = 2;
+  optional string brand_url     = 3;
+  optional string support_email = 4;
+  optional string footer_html   = 5;
+  string actor_id               = 6;
+  optional string header_html   = 7;
+}
+
 
 enum NotificationChannel {
   NOTIFICATION_CHANNEL_UNSPECIFIED = 0;
@@ -202,6 +241,9 @@ message RenderPreviewRequest {
   // JSON-stringified variables { "order.number": "MD-2026-0001", ... }
   string variables_json = 2;
   optional string subject = 3;
+  // JSON-stringified branding override (header/footer/logo/brand…) для live-
+  // превʼю незбережених змін на сторінці брендингу. Порожньо → беремо з БД.
+  optional string branding_json = 4;
 }
 
 message RenderPreviewResponse {

package/events/orders/order-cancelled.interface.ts

@@ -8,7 +8,6 @@ export interface OrderCancelledEvent {
 	releaseStock: boolean
 	cancelledAt: number
 
-	// Опціональний customer-snapshot для нотифікацій.
 	userId?: string
 	customer?: {
 		firstName: string

package/events/orders/order-status-changed.interface.ts

@@ -8,8 +8,6 @@ export interface OrderStatusChangedEvent {
 	actorName?: string
 	changedAt: number
 
-	// Опціональний customer-snapshot для нотифікацій (щоб
-	// notification-service не робив додатковий lookup в order-service).
 	userId?: string
 	customer?: {
 		firstName: string
@@ -18,7 +16,6 @@ export interface OrderStatusChangedEvent {
 		phone: string
 	}
 
-	// На переходах у shipped — ТТН + tracking URL.
 	trackingNumber?: string
 	trackingUrl?: string
 }

package/events/stock/stock-confirm-requested.interface.ts

@@ -1,5 +1,3 @@
-// Подія від order-service: замовлення переходить у packing → catalog
-// списує резерв у реальний OUTGOING рух (підтверджує продаж).
 export interface StockConfirmRequestedEvent {
 	orderId: string
 	orderNumber: string

package/events/stock/stock-release-requested.interface.ts

@@ -1,5 +1,3 @@
-// Подія від order-service: cancel/відмова → catalog скасовує всі резерви
-// замовлення (по reference_type='order', reference_id=orderId).
 export interface StockReleaseRequestedEvent {
 	orderId: string
 	orderNumber: string

package/events/stock/stock-reserve-failed.interface.ts

@@ -1,5 +1,3 @@
-// Подія від catalog-service: catalog НЕ зміг зарезервувати (insufficient
-// stock, product disappeared). Order-service кенселить замовлення з reason.
 export interface StockReserveFailedEvent {
 	orderId: string
 	orderNumber: string

package/events/stock/stock-reserve-requested.interface.ts

@@ -1,9 +1,3 @@
-// Подія від order-service: catalog має зарезервувати stock для замовлення.
-// Catalog сам обирає warehouse(и) (auto-pick first-available, greedy
-// fill через product_warehouses ORDER BY created_at).
-//
-// TTL у мс — після його закінчення UnpaidOrdersCron у order-service
-// автоматично скасує замовлення → catalog отримає stock.release_requested.
 export interface StockReserveRequestedEvent {
 	orderId: string
 	orderNumber: string

package/events/stock/stock-reserved.interface.ts

@@ -1,5 +1,3 @@
-// Подія від catalog-service: успішний резерв → order-service зберігає
-// reservationId/reservedUntil у OrderItem (для admin UI і traceability).
 export interface StockReservedEvent {
 	orderId: string
 	orderNumber: string

package/gen/notification.ts

@@ -59,6 +59,44 @@ export enum TelegramTopic {
   UNRECOGNIZED = -1,
 }
 
+export interface BrandingEmpty {
+}
+
+/**
+ * Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+ * "взяти fallback з env" при наступному GET.
+ */
+export interface BrandingProfile {
+  logoUrl: string;
+  brandName: string;
+  brandUrl: string;
+  supportEmail: string;
+  footerHtml: string;
+  updatedAt: number;
+  updatedBy: string;
+  /**
+   * resolved: остаточні значення, що використовуються wrapper'ом
+   * (DB override → env fallback). Для UI щоб показати "поточне значення".
+   */
+  resolvedLogoUrl: string;
+  resolvedBrandName: string;
+  resolvedBrandUrl: string;
+  resolvedSupportEmail: string;
+  /** Кастомний HTML-хедер (замість дефолтного логотип-блоку). Порожньо → default. */
+  headerHtml: string;
+}
+
+export interface UpdateBrandingRequest {
+  /** optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД. */
+  logoUrl?: string | undefined;
+  brandName?: string | undefined;
+  brandUrl?: string | undefined;
+  supportEmail?: string | undefined;
+  footerHtml?: string | undefined;
+  actorId: string;
+  headerHtml?: string | undefined;
+}
+
 export interface NotificationTemplate {
   id: string;
   key: string;
@@ -168,7 +206,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 {
@@ -425,3 +470,38 @@ export function TelegramChatsServiceControllerMethods() {
 }
 
 export const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+
+export interface BrandingServiceClient {
+  getBranding(request: BrandingEmpty): Observable<BrandingProfile>;
+
+  updateBranding(request: UpdateBrandingRequest): Observable<BrandingProfile>;
+}
+
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+
+export interface BrandingServiceController {
+  getBranding(request: BrandingEmpty): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+
+  updateBranding(
+    request: UpdateBrandingRequest,
+  ): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+}
+
+export function BrandingServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["getBranding", "updateBranding"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("BrandingService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("BrandingService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const BRANDING_SERVICE_NAME = "BrandingService";

package/package.json

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

package/proto/notification.proto

@@ -29,6 +29,45 @@ service TelegramChatsService {
   rpc TestSendTelegram (TestSendTelegramRequest) returns (TestSendTelegramResponse);
 }
 
+// Брендинг email-шаблонів — singleton редагується адміном.
+service BrandingService {
+  rpc GetBranding    (BrandingEmpty)         returns (BrandingProfile);
+  rpc UpdateBranding (UpdateBrandingRequest) returns (BrandingProfile);
+}
+
+message BrandingEmpty {}
+
+// Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+// "взяти fallback з env" при наступному GET.
+message BrandingProfile {
+  string logo_url      = 1;
+  string brand_name    = 2;
+  string brand_url     = 3;
+  string support_email = 4;
+  string footer_html   = 5;
+  int64  updated_at    = 6;
+  string updated_by    = 7;
+  // resolved: остаточні значення, що використовуються wrapper'ом
+  // (DB override → env fallback). Для UI щоб показати "поточне значення".
+  string resolved_logo_url      = 8;
+  string resolved_brand_name    = 9;
+  string resolved_brand_url     = 10;
+  string resolved_support_email = 11;
+  // Кастомний HTML-хедер (замість дефолтного логотип-блоку). Порожньо → default.
+  string header_html            = 12;
+}
+
+message UpdateBrandingRequest {
+  // optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД.
+  optional string logo_url      = 1;
+  optional string brand_name    = 2;
+  optional string brand_url     = 3;
+  optional string support_email = 4;
+  optional string footer_html   = 5;
+  string actor_id               = 6;
+  optional string header_html   = 7;
+}
+
 
 enum NotificationChannel {
   NOTIFICATION_CHANNEL_UNSPECIFIED = 0;
@@ -202,6 +241,9 @@ message RenderPreviewRequest {
   // JSON-stringified variables { "order.number": "MD-2026-0001", ... }
   string variables_json = 2;
   optional string subject = 3;
+  // JSON-stringified branding override (header/footer/logo/brand…) для live-
+  // превʼю незбережених змін на сторінці брендингу. Порожньо → беремо з БД.
+  optional string branding_json = 4;
 }
 
 message RenderPreviewResponse {