@mamindom/contracts 1.0.120 → 1.0.123

package/dist/proto/order.proto

@@ -0,0 +1,308 @@
+syntax = "proto3";
+
+package order.v1;
+
+service OrderService {
+  rpc CreateOrder(CreateOrderRequest) returns (OrderResponse);
+  rpc CreateManualOrder(CreateManualOrderRequest) returns (OrderResponse);
+
+  rpc GetOrder(GetOrderRequest) returns (OrderResponse);
+  rpc GetOrderByNumber(GetOrderByNumberRequest) returns (OrderResponse);
+  rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse);
+  rpc ListUserOrders(ListUserOrdersRequest) returns (ListOrdersResponse);
+
+  rpc UpdateStatus(UpdateStatusRequest) returns (OrderResponse);
+  rpc CancelOrder(CancelOrderRequest) returns (OrderResponse);
+
+  rpc AssignManager(AssignManagerRequest) returns (OrderResponse);
+  rpc AddNote(AddNoteRequest) returns (OrderResponse);
+  rpc AddTag(AddTagRequest) returns (OrderResponse);
+  rpc RemoveTag(RemoveTagRequest) returns (OrderResponse);
+
+  rpc EditItems(EditItemsRequest) returns (OrderResponse);
+  rpc SetTrackingNumber(SetTrackingNumberRequest) returns (OrderResponse);
+
+  rpc ReorderOrder(ReorderOrderRequest) returns (ReorderResponse);
+
+  rpc ListHistory(ListHistoryRequest) returns (ListHistoryResponse);
+}
+
+// ─── Enums (string у proto3, для зворотної сумісності) ─────────
+
+// Статуси: new, processing, confirmed, no_answer, packing,
+//          shipped, delivered, completed, cancelled, returned
+
+// ─── Domain types ──────────────────────────────────────────────
+
+message OrderItem {
+  string id            = 1;
+  string product_id    = 2;
+  string variant_id    = 3;
+  string sku           = 4;
+  string name          = 5;
+  string image_url     = 6;
+  int32  quantity      = 7;
+  double price         = 8;
+  double line_discount = 9;
+  double line_total    = 10;
+  bool   in_stock      = 11;
+}
+
+message OrderRecipient {
+  bool   is_different_from_customer = 1;
+  string first_name = 2;
+  string last_name  = 3;
+  string phone      = 4;
+  string email      = 5;
+}
+
+message OrderDelivery {
+  string method          = 1;
+  string city_ref        = 2;
+  string city_name       = 3;
+  string warehouse_ref   = 4;
+  string warehouse_name  = 5;
+  string address         = 6;
+  string pickup_point_id = 7;
+  double shipping_cost   = 8;
+  string ttn             = 9;
+  string tracking_url    = 10;
+  string estimated_date  = 11;
+  string shipment_status = 12;
+}
+
+message OrderPayment {
+  string provider             = 1;
+  string provider_invoice_id  = 2;
+  string status               = 3;
+  double amount               = 4;
+  string idempotency_key      = 5;
+  string payment_url          = 6;
+  int64  hold_at              = 7;
+  int64  captured_at          = 8;
+  int64  cancelled_at         = 9;
+  int64  refunded_at          = 10;
+}
+
+message OrderNote {
+  string id         = 1;
+  string author_id  = 2;
+  string author_name = 3;
+  string text       = 4;
+  int64  created_at = 5;
+}
+
+message OrderHistoryEntry {
+  string id         = 1;
+  string action     = 2;
+  string from_value = 3;
+  string to_value   = 4;
+  string actor_id   = 5;
+  string actor_name = 6;
+  string payload    = 7;
+  int64  created_at = 8;
+}
+
+message OrderTag {
+  string tag = 1;
+}
+
+message OrderCustomerSnapshot {
+  string user_id   = 1;
+  string guest_id  = 2;
+  string first_name = 3;
+  string last_name  = 4;
+  string phone     = 5;
+  string email     = 6;
+}
+
+message OrderTotals {
+  double items_subtotal      = 1;
+  double promo_discount      = 2;
+  double coupon_discount     = 3;
+  double certificate_applied = 4;
+  double bonuses_used        = 5;
+  double bonuses_earned      = 6;
+  double shipping_cost       = 7;
+  double grand_total         = 8;
+}
+
+message Order {
+  string id            = 1;
+  string order_number  = 2;
+  string status        = 3;
+  string source        = 4;
+  int32  version       = 5;
+
+  OrderCustomerSnapshot customer = 6;
+  OrderRecipient recipient = 7;
+  repeated OrderItem items = 8;
+  OrderDelivery delivery = 9;
+  OrderPayment payment = 10;
+  OrderTotals totals = 11;
+
+  string promo_code        = 12;
+  string certificate_code  = 13;
+  bool   do_not_call       = 14;
+  string comment           = 15;
+  string cancel_reason     = 16;
+
+  string manager_id        = 17;
+  string manager_name      = 18;
+  repeated string tags     = 19;
+
+  int64  created_at = 20;
+  int64  updated_at = 21;
+}
+
+// ─── Requests ──────────────────────────────────────────────────
+
+message CreateOrderRequest {
+  string idempotency_key = 1;
+  string user_id         = 2;
+  string guest_id        = 3;
+  string source          = 4;
+  string cart_id         = 5;
+}
+
+message CreateManualOrderRequest {
+  string idempotency_key = 1;
+  string source          = 2;
+  string created_by_id   = 3;
+
+  OrderCustomerSnapshot customer = 4;
+  OrderRecipient        recipient = 5;
+  repeated OrderItemInput items = 6;
+  OrderDelivery delivery = 7;
+  OrderPayment  payment  = 8;
+
+  string promo_code = 9;
+  string comment    = 10;
+}
+
+message OrderItemInput {
+  string product_id = 1;
+  string variant_id = 2;
+  int32  quantity   = 3;
+  double price_override = 4;
+}
+
+message GetOrderRequest {
+  string id = 1;
+}
+
+message GetOrderByNumberRequest {
+  string order_number = 1;
+}
+
+message ListOrdersRequest {
+  int32  page  = 1;
+  int32  limit = 2;
+  string status = 3;
+  string source = 4;
+  string manager_id = 5;
+  string customer_query = 6;
+  string payment_provider = 7;
+  string delivery_method = 8;
+  string sku_query = 9;
+  int64  date_from = 10;
+  int64  date_to   = 11;
+  double total_from = 12;
+  double total_to   = 13;
+  string sort_by = 14;
+  string sort_dir = 15;
+}
+
+message ListUserOrdersRequest {
+  string user_id = 1;
+  int32  page    = 2;
+  int32  limit   = 3;
+  string status  = 4;
+}
+
+message ListOrdersResponse {
+  repeated Order items = 1;
+  int32  total_items   = 2;
+  int32  total_pages   = 3;
+  int32  current_page  = 4;
+  int32  per_page      = 5;
+}
+
+message UpdateStatusRequest {
+  string id        = 1;
+  string status    = 2;
+  string reason    = 3;
+  string actor_id  = 4;
+  string actor_name = 5;
+}
+
+message CancelOrderRequest {
+  string id        = 1;
+  string reason    = 2;
+  string actor_id  = 3;
+  string actor_name = 4;
+}
+
+message AssignManagerRequest {
+  string id          = 1;
+  string manager_id  = 2;
+  string manager_name = 3;
+  string actor_id    = 4;
+}
+
+message AddNoteRequest {
+  string id          = 1;
+  string text        = 2;
+  string author_id   = 3;
+  string author_name = 4;
+}
+
+message AddTagRequest {
+  string id  = 1;
+  string tag = 2;
+}
+
+message RemoveTagRequest {
+  string id  = 1;
+  string tag = 2;
+}
+
+message EditItemsRequest {
+  string id = 1;
+  repeated OrderItemInput items = 2;
+  string actor_id = 3;
+}
+
+message SetTrackingNumberRequest {
+  string id  = 1;
+  string ttn = 2;
+  string tracking_url = 3;
+  string actor_id = 4;
+}
+
+message ReorderOrderRequest {
+  string id      = 1;
+  string user_id = 2;
+}
+
+message ReorderResponse {
+  bool   ok       = 1;
+  string cart_id  = 2;
+  int32  added    = 3;
+  int32  skipped  = 4;
+  string error    = 5;
+}
+
+message ListHistoryRequest {
+  string id = 1;
+}
+
+message ListHistoryResponse {
+  repeated OrderHistoryEntry entries = 1;
+}
+
+message OrderResponse {
+  bool   ok    = 1;
+  Order  order = 2;
+  string error_message = 3;
+}

package/dist/proto/payment.proto

@@ -0,0 +1,153 @@
+syntax = "proto3";
+
+package payment.v1;
+
+service PaymentService {
+  // CreateInvoice — провайдер створює інвойс у режимі hold (2-stage).
+  rpc CreateInvoice(CreateInvoiceRequest) returns (PaymentResponse);
+
+  rpc GetPayment(GetPaymentRequest) returns (PaymentResponse);
+  rpc GetPaymentByOrder(GetPaymentByOrderRequest) returns (PaymentResponse);
+  rpc ListPayments(ListPaymentsRequest) returns (ListPaymentsResponse);
+
+  // Capture — фіксація списання раніше зарезервованих коштів.
+  rpc Capture(CaptureRequest) returns (PaymentResponse);
+  // Cancel — повне скасування hold (без списання).
+  rpc Cancel(CancelRequest) returns (PaymentResponse);
+  // Refund — повернення вже captured коштів (повне або часткове).
+  rpc Refund(RefundRequest) returns (PaymentResponse);
+
+  // SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation).
+  rpc SyncStatus(SyncStatusRequest) returns (PaymentResponse);
+
+  rpc ListProviders(ListProvidersRequest) returns (ListProvidersResponse);
+  rpc ToggleProvider(ToggleProviderRequest) returns (ToggleProviderResponse);
+}
+
+// ─── Domain ────────────────────────────────────────────────────
+
+// status: pending | hold | captured | cancelled | refunded | partially_refunded | failed
+
+message Payment {
+  string id                  = 1;
+  string order_id            = 2;
+  string provider            = 3;
+  string provider_invoice_id = 4;
+  string status              = 5;
+  double amount              = 6;
+  double captured_amount     = 7;
+  double refunded_amount     = 8;
+  string currency            = 9;
+  string idempotency_key     = 10;
+  string payment_url         = 11;
+  string failure_reason      = 12;
+  int64  created_at = 13;
+  int64  updated_at = 14;
+  int64  hold_at = 15;
+  int64  captured_at = 16;
+  int64  cancelled_at = 17;
+  int64  refunded_at = 18;
+}
+
+message PaymentProviderInfo {
+  string key          = 1;
+  string display_name = 2;
+  bool   enabled      = 3;
+  bool   supports_installment = 4;
+  string description  = 5;
+}
+
+// ─── Requests ──────────────────────────────────────────────────
+
+message CreateInvoiceRequest {
+  string order_id        = 1;
+  string order_number    = 2;
+  string provider        = 3;
+  double amount          = 4;
+  string currency        = 5;
+  string idempotency_key = 6;
+  string return_url      = 7;
+  string customer_email  = 8;
+  string customer_phone  = 9;
+  repeated InvoiceItem items = 10;
+}
+
+message InvoiceItem {
+  string name    = 1;
+  string sku     = 2;
+  int32  qty     = 3;
+  double price   = 4;
+}
+
+message GetPaymentRequest {
+  string id = 1;
+}
+
+message GetPaymentByOrderRequest {
+  string order_id = 1;
+}
+
+message ListPaymentsRequest {
+  int32  page = 1;
+  int32  limit = 2;
+  string status = 3;
+  string provider = 4;
+  int64  date_from = 5;
+  int64  date_to = 6;
+}
+
+message ListPaymentsResponse {
+  repeated Payment items = 1;
+  int32 total_items = 2;
+  int32 total_pages = 3;
+  int32 current_page = 4;
+  int32 per_page = 5;
+}
+
+message CaptureRequest {
+  string id      = 1;
+  double amount  = 2; // 0 → captures full amount
+  string actor_id = 3;
+}
+
+message CancelRequest {
+  string id       = 1;
+  string reason   = 2;
+  string actor_id = 3;
+}
+
+message RefundRequest {
+  string id       = 1;
+  double amount   = 2; // 0 → full refund of captured
+  string reason   = 3;
+  string actor_id = 4;
+}
+
+message SyncStatusRequest {
+  string id = 1;
+}
+
+message ListProvidersRequest {
+  bool only_enabled = 1;
+}
+
+message ListProvidersResponse {
+  repeated PaymentProviderInfo providers = 1;
+}
+
+message ToggleProviderRequest {
+  string key     = 1;
+  bool   enabled = 2;
+  string actor_id = 3;
+}
+
+message ToggleProviderResponse {
+  bool ok = 1;
+  PaymentProviderInfo provider = 2;
+}
+
+message PaymentResponse {
+  bool ok = 1;
+  Payment payment = 2;
+  string error_message = 3;
+}

package/dist/src/proto/paths.d.ts

@@ -29,4 +29,8 @@ export declare const PROTO_PATHS: {
     readonly FAQ: string;
     readonly PAGE: string;
     readonly SITE_SETTINGS: string;
+    readonly CART: string;
+    readonly ORDER: string;
+    readonly PAYMENT: string;
+    readonly DELIVERY: string;
 };

package/dist/src/proto/paths.js

@@ -32,5 +32,9 @@ exports.PROTO_PATHS = {
     BANNER: (0, node_path_1.join)(__dirname, '../../proto/banner.proto'),
     FAQ: (0, node_path_1.join)(__dirname, '../../proto/faq.proto'),
     PAGE: (0, node_path_1.join)(__dirname, '../../proto/page.proto'),
-    SITE_SETTINGS: (0, node_path_1.join)(__dirname, '../../proto/site_settings.proto')
+    SITE_SETTINGS: (0, node_path_1.join)(__dirname, '../../proto/site_settings.proto'),
+    CART: (0, node_path_1.join)(__dirname, '../../proto/cart.proto'),
+    ORDER: (0, node_path_1.join)(__dirname, '../../proto/order.proto'),
+    PAYMENT: (0, node_path_1.join)(__dirname, '../../proto/payment.proto'),
+    DELIVERY: (0, node_path_1.join)(__dirname, '../../proto/delivery.proto')
 };

package/events/delivery/index.ts

@@ -0,0 +1,2 @@
+export * from './shipment-created.interface'
+export * from './shipment-tracked.interface'

package/events/delivery/shipment-created.interface.ts

@@ -0,0 +1,10 @@
+export interface ShipmentCreatedEvent {
+	shipmentId: string
+	orderId: string
+	carrier: string
+	method: string
+	ttn: string
+	trackingUrl?: string
+	estimatedDate?: string
+	createdAt: number
+}

package/events/delivery/shipment-tracked.interface.ts

@@ -0,0 +1,11 @@
+export interface ShipmentTrackedEvent {
+	shipmentId: string
+	orderId: string
+	ttn: string
+	carrier: string
+	previousStatus: string
+	currentStatus: string
+	statusLabel: string
+	lastEventAt: number
+	trackedAt: number
+}

package/events/index.ts

@@ -1 +1,4 @@
 export * from './auth'
+export * from './delivery'
+export * from './orders'
+export * from './payments'

package/events/orders/index.ts

@@ -0,0 +1,3 @@
+export * from './order-cancelled.interface'
+export * from './order-created.interface'
+export * from './order-status-changed.interface'

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

@@ -0,0 +1,10 @@
+export interface OrderCancelledEvent {
+	orderId: string
+	orderNumber: string
+	reason: string
+	actorId?: string
+	actorName?: string
+	wasPaid: boolean
+	releaseStock: boolean
+	cancelledAt: number
+}

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

@@ -0,0 +1,37 @@
+export interface OrderCreatedEvent {
+	orderId: string
+	orderNumber: string
+	userId?: string
+	guestId?: string
+	source: string
+	totals: {
+		grandTotal: number
+		shippingCost: number
+		bonusesEarned: number
+	}
+	items: Array<{
+		productId: string
+		variantId?: string
+		sku: string
+		quantity: number
+		price: number
+	}>
+	delivery: {
+		method: string
+		cityRef?: string
+		warehouseRef?: string
+		address?: string
+	}
+	payment: {
+		provider: string
+		amount: number
+		idempotencyKey: string
+	}
+	customer: {
+		firstName: string
+		lastName: string
+		phone: string
+		email: string
+	}
+	createdAt: number
+}

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

@@ -0,0 +1,10 @@
+export interface OrderStatusChangedEvent {
+	orderId: string
+	orderNumber: string
+	fromStatus: string
+	toStatus: string
+	reason?: string
+	actorId?: string
+	actorName?: string
+	changedAt: number
+}

package/events/payments/index.ts

@@ -0,0 +1,5 @@
+export * from './payment-cancelled.interface'
+export * from './payment-captured.interface'
+export * from './payment-failed.interface'
+export * from './payment-held.interface'
+export * from './payment-refunded.interface'

package/events/payments/payment-cancelled.interface.ts

@@ -0,0 +1,9 @@
+export interface PaymentCancelledEvent {
+	paymentId: string
+	orderId: string
+	provider: string
+	providerInvoiceId: string
+	amount: number
+	reason?: string
+	cancelledAt: number
+}

package/events/payments/payment-captured.interface.ts

@@ -0,0 +1,10 @@
+export interface PaymentCapturedEvent {
+	paymentId: string
+	orderId: string
+	provider: string
+	providerInvoiceId: string
+	amount: number
+	capturedAmount: number
+	currency: string
+	capturedAt: number
+}

package/events/payments/payment-failed.interface.ts

@@ -0,0 +1,9 @@
+export interface PaymentFailedEvent {
+	paymentId: string
+	orderId: string
+	provider: string
+	providerInvoiceId?: string
+	amount: number
+	failureReason: string
+	failedAt: number
+}

package/events/payments/payment-held.interface.ts

@@ -0,0 +1,9 @@
+export interface PaymentHeldEvent {
+	paymentId: string
+	orderId: string
+	provider: string
+	providerInvoiceId: string
+	amount: number
+	currency: string
+	heldAt: number
+}

package/events/payments/payment-refunded.interface.ts

@@ -0,0 +1,12 @@
+export interface PaymentRefundedEvent {
+	paymentId: string
+	orderId: string
+	provider: string
+	providerInvoiceId: string
+	refundAmount: number
+	totalRefunded: number
+	originalAmount: number
+	isPartial: boolean
+	reason?: string
+	refundedAt: number
+}