@aepstore-dev/contracts 1.10.0 → 1.12.0

package/dist/proto/paths.d.ts

@@ -2,6 +2,7 @@ export declare const PROTO_PATHS: {
     readonly ACTIVITY: string;
     readonly AUTH: string;
     readonly MAIL: string;
+    readonly PAYMENTS: string;
     readonly PRODUCTS: string;
     readonly SUPPORT: string;
     readonly TAXONOMY: string;
@@ -12,6 +13,7 @@ export declare const PROTO_PACKAGES: {
     readonly ACTIVITY: "activity.v1";
     readonly AUTH: "auth.v1";
     readonly MAIL: "mail.v1";
+    readonly PAYMENTS: "payments.v1";
     readonly PRODUCTS: "products.v1";
     readonly SUPPORT: "support.v1";
     readonly TAXONOMY: "taxonomy.v1";

package/dist/proto/paths.js

@@ -7,6 +7,7 @@ exports.PROTO_PATHS = {
     ACTIVITY: (0, path_1.join)(PROTO_DIR, "activity.proto"),
     AUTH: (0, path_1.join)(PROTO_DIR, "auth.proto"),
     MAIL: (0, path_1.join)(PROTO_DIR, "mail.proto"),
+    PAYMENTS: (0, path_1.join)(PROTO_DIR, "payments.proto"),
     PRODUCTS: (0, path_1.join)(PROTO_DIR, "products.proto"),
     SUPPORT: (0, path_1.join)(PROTO_DIR, "support.proto"),
     TAXONOMY: (0, path_1.join)(PROTO_DIR, "taxonomy.proto"),
@@ -17,6 +18,7 @@ exports.PROTO_PACKAGES = {
     ACTIVITY: "activity.v1",
     AUTH: "auth.v1",
     MAIL: "mail.v1",
+    PAYMENTS: "payments.v1",
     PRODUCTS: "products.v1",
     SUPPORT: "support.v1",
     TAXONOMY: "taxonomy.v1",

package/gen/payments.ts

@@ -0,0 +1,257 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.10.1
+//   protoc               v7.35.0
+// source: payments.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "payments.v1";
+
+export interface Ok {
+  ok: boolean;
+}
+
+/**
+ * ---------------------------------------------------------------------------
+ * Purchase / checkout
+ * ---------------------------------------------------------------------------
+ */
+export interface Purchase {
+  id: string;
+  productId: string;
+  productName: string;
+  /** buyer */
+  userId: string;
+  /** Decimal as string */
+  price: string;
+  /** PENDING | COMPLETED | FAILED | REFUNDED */
+  status: string;
+  /** YooKassa payment id */
+  paymentId: string;
+  /** snapshot, Decimal as string */
+  commissionPercent: string;
+  /** snapshot, Decimal as string */
+  sellerAmount: string;
+  createdAt: string;
+  completedAt: string;
+}
+
+export interface CreateCheckoutRequest {
+  /** buyer */
+  userId: string;
+  productId: string;
+  /** optional override; where YooKassa returns the buyer */
+  returnUrl: string;
+}
+
+export interface CheckoutResponse {
+  purchaseId: string;
+  paymentId: string;
+  /** redirect the buyer here */
+  confirmationUrl: string;
+  status: string;
+}
+
+export interface PaymentEventRequest {
+  /** payment.succeeded | payment.canceled | refund.succeeded */
+  event: string;
+  /** YooKassa payment object id (re-fetched & verified by the service) */
+  paymentId: string;
+}
+
+export interface GetMyPurchasesRequest {
+  userId: string;
+  page: number;
+  limit: number;
+}
+
+export interface PurchasesListResponse {
+  items: Purchase[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface GetPurchaseRequest {
+  id: string;
+  /** requester (must be buyer or admin) */
+  userId: string;
+}
+
+export interface RefundPurchaseRequest {
+  purchaseId: string;
+  /** buyer (own) or admin */
+  actorUserId: string;
+  isAdmin: boolean;
+  reason: string;
+}
+
+/**
+ * ---------------------------------------------------------------------------
+ * Seller balance & withdrawals
+ * ---------------------------------------------------------------------------
+ */
+export interface GetSellerBalanceRequest {
+  sellerId: string;
+}
+
+export interface SellerBalanceResponse {
+  /** withdrawable now (cleared past the grace window) */
+  available: string;
+  /** still in the hold window */
+  pending: string;
+  /** reserved by non-rejected withdrawals */
+  withdrawn: string;
+  /** RUB */
+  currency: string;
+  /** completed, non-refunded sales count */
+  lifetimeSales: number;
+  /** tier the NEXT sale would use */
+  currentCommissionPercent: string;
+}
+
+export interface Withdrawal {
+  id: string;
+  sellerId: string;
+  /** Decimal as string */
+  amount: string;
+  /** PENDING | PROCESSING | COMPLETED | REJECTED */
+  status: string;
+  method: string;
+  details: string;
+  comment: string;
+  processedBy: string;
+  processedAt: string;
+  createdAt: string;
+}
+
+export interface RequestWithdrawalRequest {
+  sellerId: string;
+  /** Decimal as string */
+  amount: string;
+  method: string;
+  details: string;
+}
+
+export interface ListWithdrawalsRequest {
+  /** empty = all (admin only) */
+  sellerId: string;
+  status: string;
+  page: number;
+  limit: number;
+}
+
+export interface WithdrawalsListResponse {
+  items: Withdrawal[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface ProcessWithdrawalRequest {
+  withdrawalId: string;
+  adminId: string;
+  /** approve (→PROCESSING) | complete (→COMPLETED) | reject (→REJECTED) */
+  action: string;
+  comment: string;
+}
+
+export const PAYMENTS_V1_PACKAGE_NAME = "payments.v1";
+
+/**
+ * Commerce: YooKassa acceptance + our hold/withdrawal model (D9).
+ * Money values are Decimal-as-string (D7). Statuses are strings matching the DB
+ * enum values (PENDING/COMPLETED/FAILED/REFUNDED for purchases;
+ * PENDING/PROCESSING/COMPLETED/REJECTED for withdrawals) — kept as `string`
+ * rather than proto enums to avoid value-name clashes inside one proto package.
+ */
+
+export interface PaymentsServiceClient {
+  createCheckout(request: CreateCheckoutRequest): Observable<CheckoutResponse>;
+
+  /** Gateway forwards a verified YooKassa webhook event here. */
+
+  handlePaymentEvent(request: PaymentEventRequest): Observable<Ok>;
+
+  getMyPurchases(request: GetMyPurchasesRequest): Observable<PurchasesListResponse>;
+
+  getPurchase(request: GetPurchaseRequest): Observable<Purchase>;
+
+  refundPurchase(request: RefundPurchaseRequest): Observable<Purchase>;
+
+  getSellerBalance(request: GetSellerBalanceRequest): Observable<SellerBalanceResponse>;
+
+  requestWithdrawal(request: RequestWithdrawalRequest): Observable<Withdrawal>;
+
+  listWithdrawals(request: ListWithdrawalsRequest): Observable<WithdrawalsListResponse>;
+
+  processWithdrawal(request: ProcessWithdrawalRequest): Observable<Withdrawal>;
+}
+
+/**
+ * Commerce: YooKassa acceptance + our hold/withdrawal model (D9).
+ * Money values are Decimal-as-string (D7). Statuses are strings matching the DB
+ * enum values (PENDING/COMPLETED/FAILED/REFUNDED for purchases;
+ * PENDING/PROCESSING/COMPLETED/REJECTED for withdrawals) — kept as `string`
+ * rather than proto enums to avoid value-name clashes inside one proto package.
+ */
+
+export interface PaymentsServiceController {
+  createCheckout(
+    request: CreateCheckoutRequest,
+  ): Promise<CheckoutResponse> | Observable<CheckoutResponse> | CheckoutResponse;
+
+  /** Gateway forwards a verified YooKassa webhook event here. */
+
+  handlePaymentEvent(request: PaymentEventRequest): Promise<Ok> | Observable<Ok> | Ok;
+
+  getMyPurchases(
+    request: GetMyPurchasesRequest,
+  ): Promise<PurchasesListResponse> | Observable<PurchasesListResponse> | PurchasesListResponse;
+
+  getPurchase(request: GetPurchaseRequest): Promise<Purchase> | Observable<Purchase> | Purchase;
+
+  refundPurchase(request: RefundPurchaseRequest): Promise<Purchase> | Observable<Purchase> | Purchase;
+
+  getSellerBalance(
+    request: GetSellerBalanceRequest,
+  ): Promise<SellerBalanceResponse> | Observable<SellerBalanceResponse> | SellerBalanceResponse;
+
+  requestWithdrawal(request: RequestWithdrawalRequest): Promise<Withdrawal> | Observable<Withdrawal> | Withdrawal;
+
+  listWithdrawals(
+    request: ListWithdrawalsRequest,
+  ): Promise<WithdrawalsListResponse> | Observable<WithdrawalsListResponse> | WithdrawalsListResponse;
+
+  processWithdrawal(request: ProcessWithdrawalRequest): Promise<Withdrawal> | Observable<Withdrawal> | Withdrawal;
+}
+
+export function PaymentsServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "createCheckout",
+      "handlePaymentEvent",
+      "getMyPurchases",
+      "getPurchase",
+      "refundPurchase",
+      "getSellerBalance",
+      "requestWithdrawal",
+      "listWithdrawals",
+      "processWithdrawal",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("PaymentsService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("PaymentsService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const PAYMENTS_SERVICE_NAME = "PaymentsService";

package/gen/users.ts

@@ -148,6 +148,8 @@ export interface UpdateUserRoleRequest {
   adminId: string;
   userId: string;
   role: string;
+  /** "grant" (default) | "revoke" */
+  action: string;
 }
 
 export interface GetUsersRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/payments.proto

@@ -0,0 +1,142 @@
+syntax = "proto3";
+
+package payments.v1;
+
+// Commerce: YooKassa acceptance + our hold/withdrawal model (D9).
+// Money values are Decimal-as-string (D7). Statuses are strings matching the DB
+// enum values (PENDING/COMPLETED/FAILED/REFUNDED for purchases;
+// PENDING/PROCESSING/COMPLETED/REJECTED for withdrawals) — kept as `string`
+// rather than proto enums to avoid value-name clashes inside one proto package.
+service PaymentsService {
+    rpc CreateCheckout(CreateCheckoutRequest) returns (CheckoutResponse);
+    // Gateway forwards a verified YooKassa webhook event here.
+    rpc HandlePaymentEvent(PaymentEventRequest) returns (Ok);
+
+    rpc GetMyPurchases(GetMyPurchasesRequest) returns (PurchasesListResponse);
+    rpc GetPurchase(GetPurchaseRequest) returns (Purchase);
+    rpc RefundPurchase(RefundPurchaseRequest) returns (Purchase);
+
+    rpc GetSellerBalance(GetSellerBalanceRequest) returns (SellerBalanceResponse);
+    rpc RequestWithdrawal(RequestWithdrawalRequest) returns (Withdrawal);
+    rpc ListWithdrawals(ListWithdrawalsRequest) returns (WithdrawalsListResponse);
+    rpc ProcessWithdrawal(ProcessWithdrawalRequest) returns (Withdrawal);
+}
+
+message Ok { bool ok = 1; }
+
+// ---------------------------------------------------------------------------
+// Purchase / checkout
+// ---------------------------------------------------------------------------
+message Purchase {
+    string id = 1;
+    string product_id = 2;
+    string product_name = 3;
+    string user_id = 4;          // buyer
+    string price = 5;            // Decimal as string
+    string status = 6;           // PENDING | COMPLETED | FAILED | REFUNDED
+    string payment_id = 7;       // YooKassa payment id
+    string commission_percent = 8; // snapshot, Decimal as string
+    string seller_amount = 9;    // snapshot, Decimal as string
+    string created_at = 10;
+    string completed_at = 11;
+}
+
+message CreateCheckoutRequest {
+    string user_id = 1;     // buyer
+    string product_id = 2;
+    string return_url = 3;  // optional override; where YooKassa returns the buyer
+}
+
+message CheckoutResponse {
+    string purchase_id = 1;
+    string payment_id = 2;
+    string confirmation_url = 3; // redirect the buyer here
+    string status = 4;
+}
+
+message PaymentEventRequest {
+    string event = 1;       // payment.succeeded | payment.canceled | refund.succeeded
+    string payment_id = 2;  // YooKassa payment object id (re-fetched & verified by the service)
+}
+
+message GetMyPurchasesRequest {
+    string user_id = 1;
+    int32 page = 2;
+    int32 limit = 3;
+}
+
+message PurchasesListResponse {
+    repeated Purchase items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message GetPurchaseRequest {
+    string id = 1;
+    string user_id = 2; // requester (must be buyer or admin)
+}
+
+message RefundPurchaseRequest {
+    string purchase_id = 1;
+    string actor_user_id = 2; // buyer (own) or admin
+    bool is_admin = 3;
+    string reason = 4;
+}
+
+// ---------------------------------------------------------------------------
+// Seller balance & withdrawals
+// ---------------------------------------------------------------------------
+message GetSellerBalanceRequest {
+    string seller_id = 1;
+}
+
+message SellerBalanceResponse {
+    string available = 1;  // withdrawable now (cleared past the grace window)
+    string pending = 2;    // still in the hold window
+    string withdrawn = 3;  // reserved by non-rejected withdrawals
+    string currency = 4;   // RUB
+    int32 lifetime_sales = 5;          // completed, non-refunded sales count
+    string current_commission_percent = 6; // tier the NEXT sale would use
+}
+
+message Withdrawal {
+    string id = 1;
+    string seller_id = 2;
+    string amount = 3;     // Decimal as string
+    string status = 4;     // PENDING | PROCESSING | COMPLETED | REJECTED
+    string method = 5;
+    string details = 6;
+    string comment = 7;
+    string processed_by = 8;
+    string processed_at = 9;
+    string created_at = 10;
+}
+
+message RequestWithdrawalRequest {
+    string seller_id = 1;
+    string amount = 2;   // Decimal as string
+    string method = 3;
+    string details = 4;
+}
+
+message ListWithdrawalsRequest {
+    string seller_id = 1; // empty = all (admin only)
+    string status = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message WithdrawalsListResponse {
+    repeated Withdrawal items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message ProcessWithdrawalRequest {
+    string withdrawal_id = 1;
+    string admin_id = 2;
+    string action = 3;  // approve (→PROCESSING) | complete (→COMPLETED) | reject (→REJECTED)
+    string comment = 4;
+}

package/proto/users.proto

@@ -157,6 +157,7 @@ message UpdateUserRoleRequest {
     string admin_id = 1;
     string user_id = 2;
     string role = 3;
+    string action = 4; // "grant" (default) | "revoke"
 }
 
 // =================================================================