@mamindom/contracts 1.0.144 → 1.0.146

package/gen/manager.ts

@@ -50,10 +50,7 @@ export interface GetManagerByAccountRequest {
 export interface CreateManagerRequest {
   accountId: string;
   displayName?: string | undefined;
-  email?:
-    | string
-    | undefined;
-  /** URGENT_ONLY | ALL */
+  email?: string | undefined;
   reassignmentStrategy?: string | undefined;
 }
 
@@ -79,7 +76,6 @@ export interface ReorderManagersRequest {
 
 export interface AddVacationRequest {
   managerId: string;
-  /** ISO date */
   startsAt: string;
   endsAt: string;
   reason?: string | undefined;
@@ -112,12 +108,6 @@ export interface ManagerServiceClient {
 
   getManager(request: GetManagerRequest): Observable<ManagerProfileDto>;
 
-  /**
-   * Резолв account_id (з auth-service) → ManagerProfile. Використовується
-   * у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
-   * order.managerId зберігає ManagerProfile.id, а не Account.id.
-   */
-
   getManagerByAccount(request: GetManagerByAccountRequest): Observable<ManagerProfileDto>;
 
   createManager(request: CreateManagerRequest): Observable<ManagerProfileDto>;
@@ -146,12 +136,6 @@ export interface ManagerServiceController {
     request: GetManagerRequest,
   ): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
 
-  /**
-   * Резолв account_id (з auth-service) → ManagerProfile. Використовується
-   * у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
-   * order.managerId зберігає ManagerProfile.id, а не Account.id.
-   */
-
   getManagerByAccount(
     request: GetManagerByAccountRequest,
   ): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;

package/gen/notification.ts

@@ -80,40 +80,21 @@ 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.
-   */
+  templateId?: string | undefined;
   customSubject?: string | undefined;
   customBodyHtml?: string | undefined;
-  customBodyText?:
-    | string
-    | undefined;
-  /** JSON з placeholders для Handlebars: { "coupon_code": "...", ... } */
+  customBodyText?: string | undefined;
   variablesJson: string;
-  /** Locale для пошуку версії шаблону + надсилання branding-обгортки. */
   locale?: NotificationLocale | undefined;
 }
 
 export interface SendToCustomerResponse {
   ok: boolean;
   errorMessage: string;
-  /** id запису в NotificationLog (для трекінгу в /notifications/logs). */
   logId: string;
 }
 
@@ -124,17 +105,8 @@ export interface EnqueueRecipientsRequest {
 
 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;
 }
 
@@ -167,7 +139,6 @@ export interface DeleteCampaignResponse {
 
 export interface StartCampaignRequest {
   id: string;
-  /** ISO date; якщо порожньо → запустити одразу. */
   scheduledAt?: string | undefined;
 }
 
@@ -181,12 +152,8 @@ export interface CreateCampaignRequest {
   templateId?: string | undefined;
   customSubject?: string | undefined;
   customBodyHtml?: string | undefined;
-  customBodyText?:
-    | string
-    | undefined;
-  /** JSON segment spec. */
+  customBodyText?: string | undefined;
   segmentJson: string;
-  /** JSON coupon spec — null/empty для кампаній без купонів. */
   couponSpecJson?: string | undefined;
   respectOptOut: boolean;
   locale?: NotificationLocale | undefined;
@@ -195,7 +162,6 @@ export interface CreateCampaignRequest {
 
 export interface UpdateCampaignRequest {
   id: string;
-  /** Можна оновлювати тільки DRAFT — гілки нижче опційні. */
   name?: string | undefined;
   channel?: NotificationChannel | undefined;
   templateId?: string | undefined;
@@ -241,13 +207,11 @@ export interface Campaign {
 
 export interface PreviewSegmentRequest {
   segmentJson: string;
-  /** потрібно для перевірки наявності email/phone */
   channel: NotificationChannel;
 }
 
 export interface PreviewSegmentResponse {
   totalCount: number;
-  /** Перші 10 для UI; решта — за необхідності окремим запитом. */
   sample: PreviewSegmentSample[];
 }
 
@@ -287,10 +251,6 @@ export interface CampaignRecipient {
 export interface BrandingEmpty {
 }
 
-/**
- * Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
- * "взяти fallback з env" при наступному GET.
- */
 export interface BrandingProfile {
   logoUrl: string;
   brandName: string;
@@ -299,20 +259,14 @@ export interface BrandingProfile {
   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;
@@ -330,14 +284,9 @@ export interface NotificationTemplate {
   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;
@@ -388,10 +337,7 @@ export interface UpdateTemplateRequest {
   bodyHtml: string;
   bodyText: string;
   variablesJson?: string | undefined;
-  isActive?:
-    | boolean
-    | undefined;
-  /** Admin id для audit (хто змінив). */
+  isActive?: boolean | undefined;
   actorId?: string | undefined;
 }
 
@@ -429,15 +375,8 @@ export interface RestoreVersionRequest {
 
 export interface RenderPreviewRequest {
   bodyHtml: string;
-  /** JSON-stringified variables { "order.number": "MD-2026-0001", ... } */
   variablesJson: string;
-  subject?:
-    | string
-    | undefined;
-  /**
-   * JSON-stringified branding override (header/footer/logo/brand…) для live-
-   * превʼю незбережених змін на сторінці брендингу. Порожньо → беремо з БД.
-   */
+  subject?: string | undefined;
   brandingJson?: string | undefined;
 }
 
@@ -448,9 +387,7 @@ export interface RenderPreviewResponse {
 
 export interface SendTestRequest {
   templateId: string;
-  /** email або phone (залежно від channel). */
   recipient: string;
-  /** JSON-stringified test variables. */
   variablesJson: string;
 }
 
@@ -566,8 +503,6 @@ export interface NotificationTemplateServiceClient {
 
   sendTest(request: SendTestRequest): Observable<SendTestResponse>;
 
-  /** Реальна відправка клієнту з адмінки — або по шаблону, або ad-hoc body. */
-
   sendToCustomer(request: SendToCustomerRequest): Observable<SendToCustomerResponse>;
 }
 
@@ -604,8 +539,6 @@ export interface NotificationTemplateServiceController {
 
   sendTest(request: SendTestRequest): Promise<SendTestResponse> | Observable<SendTestResponse> | SendTestResponse;
 
-  /** Реальна відправка клієнту з адмінки — або по шаблону, або ad-hoc body. */
-
   sendToCustomer(
     request: SendToCustomerRequest,
   ): Promise<SendToCustomerResponse> | Observable<SendToCustomerResponse> | SendToCustomerResponse;
@@ -707,8 +640,6 @@ export function TelegramChatsServiceControllerMethods() {
 
 export const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
 
-/** Маркетингові кампанії: створення, запуск, статистика. */
-
 export interface CampaignsServiceClient {
   listCampaigns(request: ListCampaignsRequest): Observable<ListCampaignsResponse>;
 
@@ -724,24 +655,13 @@ export interface CampaignsServiceClient {
 
   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,
@@ -769,23 +689,14 @@ export interface CampaignsServiceController {
     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;
@@ -819,16 +730,12 @@ export function CampaignsServiceControllerMethods() {
 
 export const CAMPAIGNS_SERVICE_NAME = "CampaignsService";
 
-/** Брендинг 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;
 

package/gen/order.ts

@@ -17,9 +17,7 @@ export interface AggregateByCustomersRequest {
 export interface CustomerOrderAggregate {
   userId: string;
   ordersCount: number;
-  /** Decimal у вигляді рядка ('1234.56') — щоб не втратити точність на gRPC border. */
   totalSum: string;
-  /** ISO-рядок, відсутній якщо клієнт ще не робив замовлень. */
   lastOrderAt?: string | undefined;
 }
 
@@ -63,10 +61,6 @@ export interface OrderDelivery {
   trackingUrl: string;
   estimatedDate: string;
   shipmentStatus: string;
-  /**
-   * Адмін-облік: область/регіон з City.region від delivery-service.
-   * Старі замовлення можуть мати порожнє значення.
-   */
   region: string;
 }
 
@@ -81,10 +75,6 @@ export interface OrderPayment {
   capturedAt: number;
   cancelledAt: number;
   refundedAt: number;
-  /**
-   * Денормалізовано з payment-service для відображення в адмінці
-   * без додаткового gRPC дзвінка. Оновлюється з payment-events listener.
-   */
   capturedAmount: number;
   refundedAmount: number;
 }
@@ -154,12 +144,7 @@ export interface Order {
   tags: string[];
   createdAt: number;
   updatedAt: number;
-  /**
-   * Внутрішні нотатки менеджерів (видимі тільки в адмінці).
-   * Сортуються від новіших до старіших — server-side.
-   */
   notes: OrderNote[];
-  /** 0 = не в архіві; інакше timestamp коли архівовано. */
   archivedAt: number;
 }
 
@@ -215,10 +200,6 @@ export interface ListOrdersRequest {
   totalTo: number;
   sortBy: string;
   sortDir: string;
-  /**
-   * 0 = тільки активні (default), 1 = тільки архівні, 2 = всі.
-   * Менеджер бачить тільки свої через manager_id (вище).
-   */
   archivedFilter: number;
 }
 
@@ -347,11 +328,6 @@ export interface OrderServiceClient {
 
   cancelOrder(request: CancelOrderRequest): Observable<OrderResponse>;
 
-  /**
-   * Archive (soft delete) — встановлює archived_at. Замовлення зникає
-   * з дефолтного списку, але доступне через ?archived=true.
-   */
-
   archiveOrder(request: ArchiveOrderRequest): Observable<OrderResponse>;
 
   unarchiveOrder(request: UnarchiveOrderRequest): Observable<OrderResponse>;
@@ -372,8 +348,6 @@ export interface OrderServiceClient {
 
   listHistory(request: ListHistoryRequest): Observable<ListHistoryResponse>;
 
-  /** CRM-агрегація для експорту клієнтів — повертає count/sum/last для кожного userId. */
-
   aggregateByCustomers(request: AggregateByCustomersRequest): Observable<AggregateByCustomersResponse>;
 }
 
@@ -402,11 +376,6 @@ export interface OrderServiceController {
 
   cancelOrder(request: CancelOrderRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
 
-  /**
-   * Archive (soft delete) — встановлює archived_at. Замовлення зникає
-   * з дефолтного списку, але доступне через ?archived=true.
-   */
-
   archiveOrder(request: ArchiveOrderRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
 
   unarchiveOrder(request: UnarchiveOrderRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
@@ -431,8 +400,6 @@ export interface OrderServiceController {
     request: ListHistoryRequest,
   ): Promise<ListHistoryResponse> | Observable<ListHistoryResponse> | ListHistoryResponse;
 
-  /** CRM-агрегація для експорту клієнтів — повертає count/sum/last для кожного userId. */
-
   aggregateByCustomers(
     request: AggregateByCustomersRequest,
   ): Promise<AggregateByCustomersResponse> | Observable<AggregateByCustomersResponse> | AggregateByCustomersResponse;

package/gen/page.ts

@@ -24,11 +24,6 @@ export interface PageResponse {
   slug: string;
   status: PageStatus;
   title: { [key: string]: string };
-  /**
-   * PageBlock[] serialized as JSON-string. ts-proto without oneofs
-   * turns discriminated unions into a soup of optional fields; keep
-   * the typed union on the gateway side via zod instead.
-   */
   blocksJson: string;
   coverImage?: string | undefined;
   coverImageId?: string | undefined;

package/gen/payment.ts

@@ -86,7 +86,6 @@ export interface ListPaymentsResponse {
 
 export interface CaptureRequest {
   id: string;
-  /** 0 → captures full amount */
   amount: number;
   actorId: string;
 }
@@ -99,7 +98,6 @@ export interface CancelRequest {
 
 export interface RefundRequest {
   id: string;
-  /** 0 → full refund of captured */
   amount: number;
   reason: string;
   actorId: string;
@@ -142,8 +140,6 @@ export interface PaymentResponse {
 export const PAYMENT_V1_PACKAGE_NAME = "payment.v1";
 
 export interface PaymentServiceClient {
-  /** CreateInvoice — провайдер створює інвойс у режимі hold (2-stage). */
-
   createInvoice(request: CreateInvoiceRequest): Observable<PaymentResponse>;
 
   getPayment(request: GetPaymentRequest): Observable<PaymentResponse>;
@@ -152,28 +148,14 @@ export interface PaymentServiceClient {
 
   listPayments(request: ListPaymentsRequest): Observable<ListPaymentsResponse>;
 
-  /** Capture — фіксація списання раніше зарезервованих коштів. */
-
   capture(request: CaptureRequest): Observable<PaymentResponse>;
 
-  /** Cancel — повне скасування hold (без списання). */
-
   cancel(request: CancelRequest): Observable<PaymentResponse>;
 
-  /** Refund — повернення вже captured коштів (повне або часткове). */
-
   refund(request: RefundRequest): Observable<PaymentResponse>;
 
-  /** SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation). */
-
   syncStatus(request: SyncStatusRequest): Observable<PaymentResponse>;
 
-  /**
-   * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
-   * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
-   * загубив SMS — менеджер ділиться новим лінком через адмін UI.
-   */
-
   regenerateInvoice(request: RegenerateInvoiceRequest): Observable<PaymentResponse>;
 
   listProviders(request: ListProvidersRequest): Observable<ListProvidersResponse>;
@@ -182,8 +164,6 @@ export interface PaymentServiceClient {
 }
 
 export interface PaymentServiceController {
-  /** CreateInvoice — провайдер створює інвойс у режимі hold (2-stage). */
-
   createInvoice(
     request: CreateInvoiceRequest,
   ): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
@@ -198,28 +178,14 @@ export interface PaymentServiceController {
     request: ListPaymentsRequest,
   ): Promise<ListPaymentsResponse> | Observable<ListPaymentsResponse> | ListPaymentsResponse;
 
-  /** Capture — фіксація списання раніше зарезервованих коштів. */
-
   capture(request: CaptureRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
-  /** Cancel — повне скасування hold (без списання). */
-
   cancel(request: CancelRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
-  /** Refund — повернення вже captured коштів (повне або часткове). */
-
   refund(request: RefundRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
-  /** SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation). */
-
   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;

package/gen/pickup.ts

@@ -20,10 +20,7 @@ export interface PickupPointResponse {
   lat?: number | undefined;
   lng?: number | undefined;
   isActive: boolean;
-  code1c?:
-    | string
-    | undefined;
-  /** JSON-encoded WeekSchedule */
+  code1c?: string | undefined;
   schedule?: string | undefined;
 }
 
@@ -74,7 +71,6 @@ export interface PickupStockItemResponse {
   productId: string;
   variantId?: string | undefined;
   qty: number;
-  /** "MANUAL" | "SYNC_1C" */
   source: string;
   updatedAt: string;
   pickupPointName?: string | undefined;
@@ -95,17 +91,13 @@ export interface SetPickupStockRequest {
   productId: string;
   variantId?: string | undefined;
   qty: number;
-  /** default MANUAL */
   source?: string | undefined;
 }
 
 export interface AdjustPickupStockRequest {
   pickupPointId: string;
   productId: string;
-  variantId?:
-    | string
-    | undefined;
-  /** positive = add, negative = subtract */
+  variantId?: string | undefined;
   delta: number;
 }
 
@@ -113,7 +105,6 @@ export interface BulkSetPickupStockRequest {
   items: SetPickupStockRequest[];
 }
 
-/** Масова синхронізація з 1С: масив рядків вигляду "code1c:productGuid1c:variantGuid1c?:qty" */
 export interface BulkSyncFromOnecRequest {
   entries: OnecStockEntry[];
 }
@@ -128,8 +119,6 @@ export interface OnecStockEntry {
 export const CATALOG_V1_PACKAGE_NAME = "catalog.v1";
 
 export interface PickupPointServiceClient {
-  /** Pickup points CRUD */
-
   getPickupPoints(request: GetPickupPointsRequest): Observable<GetPickupPointsResponse>;
 
   getPickupPoint(request: GetPickupPointRequest): Observable<PickupPointResponse>;
@@ -140,8 +129,6 @@ export interface PickupPointServiceClient {
 
   deletePickupPoint(request: DeletePickupPointRequest): Observable<DeleteResponse>;
 
-  /** Stock per pickup point */
-
   getPickupStock(request: GetPickupStockRequest): Observable<GetPickupStockResponse>;
 
   setPickupStock(request: SetPickupStockRequest): Observable<PickupStockItemResponse>;
@@ -154,8 +141,6 @@ export interface PickupPointServiceClient {
 }
 
 export interface PickupPointServiceController {
-  /** Pickup points CRUD */
-
   getPickupPoints(
     request: GetPickupPointsRequest,
   ): Promise<GetPickupPointsResponse> | Observable<GetPickupPointsResponse> | GetPickupPointsResponse;
@@ -176,8 +161,6 @@ export interface PickupPointServiceController {
     request: DeletePickupPointRequest,
   ): Promise<DeleteResponse> | Observable<DeleteResponse> | DeleteResponse;
 
-  /** Stock per pickup point */
-
   getPickupStock(
     request: GetPickupStockRequest,
   ): Promise<GetPickupStockResponse> | Observable<GetPickupStockResponse> | GetPickupStockResponse;