@aepstore-dev/contracts 1.60.0 → 1.62.0

package/gen/payments.d.ts

@@ -13,23 +13,30 @@ 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;
     /** >= 10.00 */
     amount: string;
     returnUrl: string;
-    /** YOOKASSA | SAVED_CARD (default YOOKASSA) */
+    /** YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA) */
     paymentMethod: string;
     /** required when payment_method=SAVED_CARD */
     savedCardId: 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;
     /**
@@ -271,6 +278,44 @@ export interface PaymentEventRequest {
     event: string;
     paymentId: string;
 }
+export interface ProviderCallbackRequest {
+    /** yookassa | heleket | … */
+    provider: string;
+    /** 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
@@ -580,6 +625,12 @@ export interface PaymentsServiceClient {
     processWithdrawal(request: ProcessWithdrawalRequest): Observable<Withdrawal>;
     /** ----- provider webhook (gateway forwards a verified event) ----- */
     handlePaymentEvent(request: PaymentEventRequest): Observable<Ok>;
+    /**
+     * Generalized per-provider callback (POST /payments/webhook/:provider).
+     * Carries the EXACT raw JSON body: signed providers (Heleket) hash the
+     * byte-exact payload, so re-serializing a parsed body would break the sign.
+     */
+    handleProviderCallback(request: ProviderCallbackRequest): Observable<Ok>;
     /** ----- premium ----- */
     getPremiumPlans(request: GetPremiumPlansRequest): Observable<PremiumPlansResponse>;
     purchasePremium(request: PurchasePremiumRequest): Observable<PurchasePremiumResponse>;
@@ -612,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>;
@@ -644,6 +707,12 @@ export interface PaymentsServiceController {
     processWithdrawal(request: ProcessWithdrawalRequest): Promise<Withdrawal> | Observable<Withdrawal> | Withdrawal;
     /** ----- provider webhook (gateway forwards a verified event) ----- */
     handlePaymentEvent(request: PaymentEventRequest): Promise<Ok> | Observable<Ok> | Ok;
+    /**
+     * Generalized per-provider callback (POST /payments/webhook/:provider).
+     * Carries the EXACT raw JSON body: signed providers (Heleket) hash the
+     * byte-exact payload, so re-serializing a parsed body would break the sign.
+     */
+    handleProviderCallback(request: ProviderCallbackRequest): Promise<Ok> | Observable<Ok> | Ok;
     /** ----- premium ----- */
     getPremiumPlans(request: GetPremiumPlansRequest): Promise<PremiumPlansResponse> | Observable<PremiumPlansResponse> | PremiumPlansResponse;
     purchasePremium(request: PurchasePremiumRequest): Promise<PurchasePremiumResponse> | Observable<PurchasePremiumResponse> | PurchasePremiumResponse;
@@ -676,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.1
+//   protoc               v7.35.0
 // source: payments.proto
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PAYMENTS_SERVICE_NAME = exports.PAYMENTS_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
@@ -26,6 +26,7 @@ function PaymentsServiceControllerMethods() {
             "listWithdrawals",
             "processWithdrawal",
             "handlePaymentEvent",
+            "handleProviderCallback",
             "getPremiumPlans",
             "purchasePremium",
             "setPremiumPaymentMethod",
@@ -39,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.1
+//   protoc               v7.35.0
 // 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 {
@@ -41,7 +48,7 @@ export interface TopupRequest {
   /** >= 10.00 */
   amount: string;
   returnUrl: string;
-  /** YOOKASSA | SAVED_CARD (default YOOKASSA) */
+  /** YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA) */
   paymentMethod: string;
   /** required when payment_method=SAVED_CARD */
   savedCardId: string;
@@ -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;
   /**
@@ -306,6 +313,51 @@ export interface PaymentEventRequest {
   paymentId: string;
 }
 
+export interface ProviderCallbackRequest {
+  /** yookassa | heleket | … */
+  provider: string;
+  /** 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
@@ -673,6 +725,14 @@ export interface PaymentsServiceClient {
 
   handlePaymentEvent(request: PaymentEventRequest): Observable<Ok>;
 
+  /**
+   * Generalized per-provider callback (POST /payments/webhook/:provider).
+   * Carries the EXACT raw JSON body: signed providers (Heleket) hash the
+   * byte-exact payload, so re-serializing a parsed body would break the sign.
+   */
+
+  handleProviderCallback(request: ProviderCallbackRequest): Observable<Ok>;
+
   /** ----- premium ----- */
 
   getPremiumPlans(request: GetPremiumPlansRequest): Observable<PremiumPlansResponse>;
@@ -724,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>;
@@ -792,6 +868,14 @@ export interface PaymentsServiceController {
 
   handlePaymentEvent(request: PaymentEventRequest): Promise<Ok> | Observable<Ok> | Ok;
 
+  /**
+   * Generalized per-provider callback (POST /payments/webhook/:provider).
+   * Carries the EXACT raw JSON body: signed providers (Heleket) hash the
+   * byte-exact payload, so re-serializing a parsed body would break the sign.
+   */
+
+  handleProviderCallback(request: ProviderCallbackRequest): Promise<Ok> | Observable<Ok> | Ok;
+
   /** ----- premium ----- */
 
   getPremiumPlans(
@@ -861,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(
@@ -907,6 +1009,7 @@ export function PaymentsServiceControllerMethods() {
       "listWithdrawals",
       "processWithdrawal",
       "handlePaymentEvent",
+      "handleProviderCallback",
       "getPremiumPlans",
       "purchasePremium",
       "setPremiumPaymentMethod",
@@ -920,6 +1023,8 @@ export function PaymentsServiceControllerMethods() {
       "updateSavedCard",
       "bindCard",
       "getPaymentIntent",
+      "getRates",
+      "getPaymentMethods",
       "updatePayoutDetails",
       "getPayoutDetails",
       "getAdminOverview",

package/gen/products.d.ts

@@ -71,15 +71,20 @@ 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;
     /** 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;
@@ -170,6 +175,8 @@ export interface CreateProductRequest {
     video: string;
     description: string;
     status: ProductStatus;
+    /** RUB | USD | EUR; empty → RUB */
+    currency: string;
 }
 export interface UpdateProductRequest {
     userId: string;
@@ -182,6 +189,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.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.1
+//   protoc               v7.35.0
 // source: products.proto
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PRODUCTS_SERVICE_NAME = exports.PRODUCTS_V1_PACKAGE_NAME = exports.MediaType = exports.ModerationStatus = exports.ProductStatus = exports.protobufPackage = void 0;

package/gen/products.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.1
+//   protoc               v7.35.0
 // source: products.proto
 
 /* eslint-disable */
@@ -91,15 +91,20 @@ 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;
   /** 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;
@@ -200,6 +205,8 @@ export interface CreateProductRequest {
   video: string;
   description: string;
   status: ProductStatus;
+  /** RUB | USD | EUR; empty → RUB */
+  currency: string;
 }
 
 export interface UpdateProductRequest {
@@ -213,6 +220,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.60.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.62.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"
+  }
+}