@aepstore-dev/contracts 1.61.0 → 1.63.0

package/gen/payments.d.ts

@@ -13,16 +13,23 @@ export interface Purchase {
     productId: string;
     productName: string;
     userId: string;
+    /** settled RUB amount */
     price: string;
     /** PENDING | COMPLETED | FAILED | REFUNDED */
     status: string;
     paymentId: string;
-    /** BALANCE | YOOKASSA */
+    /** BALANCE | YOOKASSA | CRYPTO */
     paymentMethod: string;
     commissionPercent: string;
     sellerAmount: string;
     createdAt: string;
     completedAt: string;
+    /** FX snapshot at checkout (empty for legacy RUB purchases). */
+    listingCurrency: string;
+    /** Decimal as string, in listing_currency */
+    listingPrice: string;
+    /** listing→RUB rate used (Decimal as string) */
+    fxRate: string;
 }
 export interface TopupRequest {
     userId: string;
@@ -37,7 +44,7 @@ export interface TopupRequest {
 export interface CreateCheckoutRequest {
     userId: string;
     productId: string;
-    /** BALANCE | YOOKASSA | SAVED_CARD (default YOOKASSA) */
+    /** BALANCE | YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA) */
     paymentMethod: string;
     returnUrl: string;
     /**
@@ -277,6 +284,38 @@ export interface ProviderCallbackRequest {
     /** exact raw JSON body as received (signature input) */
     rawBody: string;
 }
+/**
+ * ---------------------------------------------------------------------------
+ * FX rates / payment methods
+ * ---------------------------------------------------------------------------
+ */
+export interface GetRatesRequest {
+}
+export interface FxRate {
+    /** USD | EUR */
+    currency: string;
+    /** RUB per 1 unit, Decimal as string */
+    rate: string;
+}
+export interface GetRatesResponse {
+    /** always RUB */
+    base: string;
+    /** YYYY-MM-DD the rates are for */
+    asOf: string;
+    rates: FxRate[];
+}
+export interface GetPaymentMethodsRequest {
+}
+export interface PaymentMethodInfo {
+    /** YOOKASSA | SAVED_CARD | CRYPTO | BALANCE */
+    method: string;
+    /** yookassa | heleket | '' (BALANCE) */
+    provider: string;
+    currencies: string[];
+}
+export interface GetPaymentMethodsResponse {
+    methods: PaymentMethodInfo[];
+}
 /**
  * ---------------------------------------------------------------------------
  * Admin
@@ -624,6 +663,18 @@ export interface PaymentsServiceClient {
      * completion. Ownership-checked by user_id.
      */
     getPaymentIntent(request: GetPaymentIntentRequest): Observable<PaymentIntentStatus>;
+    /**
+     * ----- FX / available methods (public, cached) -----
+     * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+     * the authoritative charge amount is always computed server-side at checkout.
+     */
+    getRates(request: GetRatesRequest): Observable<GetRatesResponse>;
+    /**
+     * Payment methods derived from live provider capabilities — the client
+     * renders only what is actually available (e.g. CRYPTO appears once the
+     * Heleket merchant is configured).
+     */
+    getPaymentMethods(request: GetPaymentMethodsRequest): Observable<GetPaymentMethodsResponse>;
     /** ----- payout details ----- */
     updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
     getPayoutDetails(request: GetPayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
@@ -694,6 +745,18 @@ export interface PaymentsServiceController {
      * completion. Ownership-checked by user_id.
      */
     getPaymentIntent(request: GetPaymentIntentRequest): Promise<PaymentIntentStatus> | Observable<PaymentIntentStatus> | PaymentIntentStatus;
+    /**
+     * ----- FX / available methods (public, cached) -----
+     * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+     * the authoritative charge amount is always computed server-side at checkout.
+     */
+    getRates(request: GetRatesRequest): Promise<GetRatesResponse> | Observable<GetRatesResponse> | GetRatesResponse;
+    /**
+     * Payment methods derived from live provider capabilities — the client
+     * renders only what is actually available (e.g. CRYPTO appears once the
+     * Heleket merchant is configured).
+     */
+    getPaymentMethods(request: GetPaymentMethodsRequest): Promise<GetPaymentMethodsResponse> | Observable<GetPaymentMethodsResponse> | GetPaymentMethodsResponse;
     /** ----- payout details ----- */
     updatePayoutDetails(request: UpdatePayoutDetailsRequest): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;
     getPayoutDetails(request: GetPayoutDetailsRequest): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;

package/gen/payments.js

@@ -2,7 +2,7 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
 //   protoc-gen-ts_proto  v2.10.1
-//   protoc               v7.35.0
+//   protoc               v7.35.1
 // source: payments.proto
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PAYMENTS_SERVICE_NAME = exports.PAYMENTS_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
@@ -40,6 +40,8 @@ function PaymentsServiceControllerMethods() {
             "updateSavedCard",
             "bindCard",
             "getPaymentIntent",
+            "getRates",
+            "getPaymentMethods",
             "updatePayoutDetails",
             "getPayoutDetails",
             "getAdminOverview",

package/gen/payments.ts

@@ -1,7 +1,7 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
 //   protoc-gen-ts_proto  v2.10.1
-//   protoc               v7.35.0
+//   protoc               v7.35.1
 // source: payments.proto
 
 /* eslint-disable */
@@ -24,16 +24,23 @@ export interface Purchase {
   productId: string;
   productName: string;
   userId: string;
+  /** settled RUB amount */
   price: string;
   /** PENDING | COMPLETED | FAILED | REFUNDED */
   status: string;
   paymentId: string;
-  /** BALANCE | YOOKASSA */
+  /** BALANCE | YOOKASSA | CRYPTO */
   paymentMethod: string;
   commissionPercent: string;
   sellerAmount: string;
   createdAt: string;
   completedAt: string;
+  /** FX snapshot at checkout (empty for legacy RUB purchases). */
+  listingCurrency: string;
+  /** Decimal as string, in listing_currency */
+  listingPrice: string;
+  /** listing→RUB rate used (Decimal as string) */
+  fxRate: string;
 }
 
 export interface TopupRequest {
@@ -50,7 +57,7 @@ export interface TopupRequest {
 export interface CreateCheckoutRequest {
   userId: string;
   productId: string;
-  /** BALANCE | YOOKASSA | SAVED_CARD (default YOOKASSA) */
+  /** BALANCE | YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA) */
   paymentMethod: string;
   returnUrl: string;
   /**
@@ -313,6 +320,44 @@ export interface ProviderCallbackRequest {
   rawBody: string;
 }
 
+/**
+ * ---------------------------------------------------------------------------
+ * FX rates / payment methods
+ * ---------------------------------------------------------------------------
+ */
+export interface GetRatesRequest {
+}
+
+export interface FxRate {
+  /** USD | EUR */
+  currency: string;
+  /** RUB per 1 unit, Decimal as string */
+  rate: string;
+}
+
+export interface GetRatesResponse {
+  /** always RUB */
+  base: string;
+  /** YYYY-MM-DD the rates are for */
+  asOf: string;
+  rates: FxRate[];
+}
+
+export interface GetPaymentMethodsRequest {
+}
+
+export interface PaymentMethodInfo {
+  /** YOOKASSA | SAVED_CARD | CRYPTO | BALANCE */
+  method: string;
+  /** yookassa | heleket | '' (BALANCE) */
+  provider: string;
+  currencies: string[];
+}
+
+export interface GetPaymentMethodsResponse {
+  methods: PaymentMethodInfo[];
+}
+
 /**
  * ---------------------------------------------------------------------------
  * Admin
@@ -739,6 +784,22 @@ export interface PaymentsServiceClient {
 
   getPaymentIntent(request: GetPaymentIntentRequest): Observable<PaymentIntentStatus>;
 
+  /**
+   * ----- FX / available methods (public, cached) -----
+   * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+   * the authoritative charge amount is always computed server-side at checkout.
+   */
+
+  getRates(request: GetRatesRequest): Observable<GetRatesResponse>;
+
+  /**
+   * Payment methods derived from live provider capabilities — the client
+   * renders only what is actually available (e.g. CRYPTO appears once the
+   * Heleket merchant is configured).
+   */
+
+  getPaymentMethods(request: GetPaymentMethodsRequest): Observable<GetPaymentMethodsResponse>;
+
   /** ----- payout details ----- */
 
   updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
@@ -884,6 +945,24 @@ export interface PaymentsServiceController {
     request: GetPaymentIntentRequest,
   ): Promise<PaymentIntentStatus> | Observable<PaymentIntentStatus> | PaymentIntentStatus;
 
+  /**
+   * ----- FX / available methods (public, cached) -----
+   * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+   * the authoritative charge amount is always computed server-side at checkout.
+   */
+
+  getRates(request: GetRatesRequest): Promise<GetRatesResponse> | Observable<GetRatesResponse> | GetRatesResponse;
+
+  /**
+   * Payment methods derived from live provider capabilities — the client
+   * renders only what is actually available (e.g. CRYPTO appears once the
+   * Heleket merchant is configured).
+   */
+
+  getPaymentMethods(
+    request: GetPaymentMethodsRequest,
+  ): Promise<GetPaymentMethodsResponse> | Observable<GetPaymentMethodsResponse> | GetPaymentMethodsResponse;
+
   /** ----- payout details ----- */
 
   updatePayoutDetails(
@@ -944,6 +1023,8 @@ export function PaymentsServiceControllerMethods() {
       "updateSavedCard",
       "bindCard",
       "getPaymentIntent",
+      "getRates",
+      "getPaymentMethods",
       "updatePayoutDetails",
       "getPayoutDetails",
       "getAdminOverview",

package/gen/products.d.ts

@@ -71,15 +71,27 @@ export interface Product {
     id: string;
     name: string;
     description: string;
-    /** Decimal as string (D7) */
+    /** Decimal as string (D7), in `currency` */
     price: string;
     /** Decimal as string */
     discountPercent: string;
-    /** Decimal as string */
+    /** Decimal as string, in `currency` */
     finalPrice: string;
+    /**
+     * Converted final_price display amounts by currency (RUB/USD/EUR).
+     * Not persisted; computed from the cached payments-service FX rates.
+     */
+    prices: {
+        [key: string]: string;
+    };
     /** double as string for consistency */
     averageRating: string;
     status: ProductStatus;
+    /**
+     * Listing currency the seller priced in: RUB | USD | EUR (default RUB).
+     * Settlement/ledger is always RUB — conversion is snapshotted at checkout.
+     */
+    currency: string;
     /** null while DRAFT / not yet submitted */
     moderation: ProductModeration | undefined;
     createdAt: string;
@@ -116,6 +128,10 @@ export interface Product {
      */
     attachments: ProductAttachment[];
 }
+export interface Product_PricesEntry {
+    key: string;
+    value: string;
+}
 export interface ProductAttachment {
     id: string;
     fileName: string;
@@ -134,6 +150,16 @@ export interface RelatedProduct {
     preview: string;
     user: ProductUser | undefined;
     categories: Category[];
+    /** RUB | USD | EUR */
+    currency: string;
+    /** Converted final_price display amounts. */
+    prices: {
+        [key: string]: string;
+    };
+}
+export interface RelatedProduct_PricesEntry {
+    key: string;
+    value: string;
 }
 export interface ProductResponse {
     product: Product | undefined;
@@ -170,6 +196,8 @@ export interface CreateProductRequest {
     video: string;
     description: string;
     status: ProductStatus;
+    /** RUB | USD | EUR; empty → RUB */
+    currency: string;
 }
 export interface UpdateProductRequest {
     userId: string;
@@ -182,6 +210,8 @@ export interface UpdateProductRequest {
     tags: string[];
     categoryIds: string[];
     applicationIds: string[];
+    /** RUB | USD | EUR; empty → no change */
+    currency: string;
 }
 export interface QueryProductsRequest {
     search: string;

package/gen/products.ts

@@ -91,15 +91,25 @@ export interface Product {
   id: string;
   name: string;
   description: string;
-  /** Decimal as string (D7) */
+  /** Decimal as string (D7), in `currency` */
   price: string;
   /** Decimal as string */
   discountPercent: string;
-  /** Decimal as string */
+  /** Decimal as string, in `currency` */
   finalPrice: string;
+  /**
+   * Converted final_price display amounts by currency (RUB/USD/EUR).
+   * Not persisted; computed from the cached payments-service FX rates.
+   */
+  prices: { [key: string]: string };
   /** double as string for consistency */
   averageRating: string;
   status: ProductStatus;
+  /**
+   * Listing currency the seller priced in: RUB | USD | EUR (default RUB).
+   * Settlement/ledger is always RUB — conversion is snapshotted at checkout.
+   */
+  currency: string;
   /** null while DRAFT / not yet submitted */
   moderation: ProductModeration | undefined;
   createdAt: string;
@@ -137,6 +147,11 @@ export interface Product {
   attachments: ProductAttachment[];
 }
 
+export interface Product_PricesEntry {
+  key: string;
+  value: string;
+}
+
 export interface ProductAttachment {
   id: string;
   fileName: string;
@@ -156,6 +171,15 @@ export interface RelatedProduct {
   preview: string;
   user: ProductUser | undefined;
   categories: Category[];
+  /** RUB | USD | EUR */
+  currency: string;
+  /** Converted final_price display amounts. */
+  prices: { [key: string]: string };
+}
+
+export interface RelatedProduct_PricesEntry {
+  key: string;
+  value: string;
 }
 
 export interface ProductResponse {
@@ -200,6 +224,8 @@ export interface CreateProductRequest {
   video: string;
   description: string;
   status: ProductStatus;
+  /** RUB | USD | EUR; empty → RUB */
+  currency: string;
 }
 
 export interface UpdateProductRequest {
@@ -213,6 +239,8 @@ export interface UpdateProductRequest {
   tags: string[];
   categoryIds: string[];
   applicationIds: string[];
+  /** RUB | USD | EUR; empty → no change */
+  currency: string;
 }
 
 export interface QueryProductsRequest {

package/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "@aepstore-dev/contracts",
-  "version": "1.61.0",
-  "description": "Protobuf definitions for aepstore microservices",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "scripts": {
-    "generate": "node scripts/generate.cjs",
-    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.gen.json"
-  },
-  "files": [
-    "dist",
-    "proto",
-    "gen"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "author": {
-    "name": "torroixq",
-    "email": "cato.ixq@gmail.com"
-  },
-  "peerDependencies": {
-    "@nestjs/microservices": "^11.1.11",
-    "rxjs": "^7.8.2"
-  },
-  "devDependencies": {
-    "@nestjs/microservices": "^11.1.11",
-    "@protobuf-ts/protoc": "^2.9.4",
-    "@types/node": "^25.0.3",
-    "rxjs": "^7.8.2",
-    "ts-proto": "^2.10.1",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "@aepstore-dev/contracts",
+  "version": "1.63.0",
+  "description": "Protobuf definitions for aepstore microservices",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "generate": "node scripts/generate.cjs",
+    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.gen.json"
+  },
+  "files": [
+    "dist",
+    "proto",
+    "gen"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": {
+    "name": "torroixq",
+    "email": "cato.ixq@gmail.com"
+  },
+  "peerDependencies": {
+    "@nestjs/microservices": "^11.1.11",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@nestjs/microservices": "^11.1.11",
+    "@protobuf-ts/protoc": "^2.9.4",
+    "@types/node": "^25.0.3",
+    "rxjs": "^7.8.2",
+    "ts-proto": "^2.10.1",
+    "typescript": "^5.9.3"
+  }
+}