@aepstore-dev/contracts 1.59.0 → 1.61.0

package/gen/payments.d.ts

@@ -29,7 +29,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;
@@ -271,6 +271,12 @@ export interface PaymentEventRequest {
     event: string;
     paymentId: string;
 }
+export interface ProviderCallbackRequest {
+    /** yookassa | heleket | … */
+    provider: string;
+    /** exact raw JSON body as received (signature input) */
+    rawBody: string;
+}
 /**
  * ---------------------------------------------------------------------------
  * Admin
@@ -490,6 +496,10 @@ export interface GetMyPremiumPaymentsRequest {
     page: number;
     limit: number;
 }
+export interface GetPremiumPaymentRequest {
+    userId: string;
+    paymentId: string;
+}
 export interface PremiumPaymentsListResponse {
     items: PremiumPaymentRow[];
     total: number;
@@ -576,6 +586,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>;
@@ -586,6 +602,7 @@ export interface PaymentsServiceClient {
      */
     refundPremium(request: RefundPremiumRequest): Observable<RefundPremiumResponse>;
     getMyPremiumPayments(request: GetMyPremiumPaymentsRequest): Observable<PremiumPaymentsListResponse>;
+    getPremiumPayment(request: GetPremiumPaymentRequest): Observable<PremiumPaymentRow>;
     /**
      * Internal — InternalServiceGuard. tasks-service cron triggers due renewals;
      * payments-service iterates ACTIVE subscriptions with autoRenew+savedCard.
@@ -639,6 +656,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;
@@ -649,6 +672,7 @@ export interface PaymentsServiceController {
      */
     refundPremium(request: RefundPremiumRequest): Promise<RefundPremiumResponse> | Observable<RefundPremiumResponse> | RefundPremiumResponse;
     getMyPremiumPayments(request: GetMyPremiumPaymentsRequest): Promise<PremiumPaymentsListResponse> | Observable<PremiumPaymentsListResponse> | PremiumPaymentsListResponse;
+    getPremiumPayment(request: GetPremiumPaymentRequest): Promise<PremiumPaymentRow> | Observable<PremiumPaymentRow> | PremiumPaymentRow;
     /**
      * Internal — InternalServiceGuard. tasks-service cron triggers due renewals;
      * payments-service iterates ACTIVE subscriptions with autoRenew+savedCard.

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,11 +26,13 @@ function PaymentsServiceControllerMethods() {
             "listWithdrawals",
             "processWithdrawal",
             "handlePaymentEvent",
+            "handleProviderCallback",
             "getPremiumPlans",
             "purchasePremium",
             "setPremiumPaymentMethod",
             "refundPremium",
             "getMyPremiumPayments",
+            "getPremiumPayment",
             "runPremiumRenewals",
             "listSavedCards",
             "deleteSavedCard",

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 */
@@ -41,7 +41,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;
@@ -306,6 +306,13 @@ export interface PaymentEventRequest {
   paymentId: string;
 }
 
+export interface ProviderCallbackRequest {
+  /** yookassa | heleket | … */
+  provider: string;
+  /** exact raw JSON body as received (signature input) */
+  rawBody: string;
+}
+
 /**
  * ---------------------------------------------------------------------------
  * Admin
@@ -554,6 +561,11 @@ export interface GetMyPremiumPaymentsRequest {
   limit: number;
 }
 
+export interface GetPremiumPaymentRequest {
+  userId: string;
+  paymentId: string;
+}
+
 export interface PremiumPaymentsListResponse {
   items: PremiumPaymentRow[];
   total: number;
@@ -668,6 +680,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>;
@@ -685,6 +705,8 @@ export interface PaymentsServiceClient {
 
   getMyPremiumPayments(request: GetMyPremiumPaymentsRequest): Observable<PremiumPaymentsListResponse>;
 
+  getPremiumPayment(request: GetPremiumPaymentRequest): Observable<PremiumPaymentRow>;
+
   /**
    * Internal — InternalServiceGuard. tasks-service cron triggers due renewals;
    * payments-service iterates ACTIVE subscriptions with autoRenew+savedCard.
@@ -785,6 +807,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(
@@ -812,6 +842,10 @@ export interface PaymentsServiceController {
     request: GetMyPremiumPaymentsRequest,
   ): Promise<PremiumPaymentsListResponse> | Observable<PremiumPaymentsListResponse> | PremiumPaymentsListResponse;
 
+  getPremiumPayment(
+    request: GetPremiumPaymentRequest,
+  ): Promise<PremiumPaymentRow> | Observable<PremiumPaymentRow> | PremiumPaymentRow;
+
   /**
    * Internal — InternalServiceGuard. tasks-service cron triggers due renewals;
    * payments-service iterates ACTIVE subscriptions with autoRenew+savedCard.
@@ -896,11 +930,13 @@ export function PaymentsServiceControllerMethods() {
       "listWithdrawals",
       "processWithdrawal",
       "handlePaymentEvent",
+      "handleProviderCallback",
       "getPremiumPlans",
       "purchasePremium",
       "setPremiumPaymentMethod",
       "refundPremium",
       "getMyPremiumPayments",
+      "getPremiumPayment",
       "runPremiumRenewals",
       "listSavedCards",
       "deleteSavedCard",

package/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "@aepstore-dev/contracts",
-  "version": "1.59.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.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"
+  }
+}

package/proto/activity.proto

@@ -1,200 +1,200 @@
-syntax = "proto3";
-
-package activity.v1;
-
-service ActivityService {
-    // Reports
-    rpc ReportCreate(CreateReportRequest) returns (ReportResponse);
-    rpc ReportList(ListReportsRequest) returns (ReportsListResponse);
-    rpc ReportGet(ReportIdRequest) returns (ReportResponse);
-    rpc ReportModerate(ModerateReportRequest) returns (ReportResponse);
-
-    // Report categories
-    rpc ReportCategoryCreate(CreateReportCategoryRequest) returns (ReportCategoryResponse);
-    rpc ReportCategoryList(ListReportCategoriesRequest) returns (ReportCategoriesListResponse);
-    rpc ReportCategoryGet(ReportCategoryIdRequest) returns (ReportCategoryResponse);
-    rpc ReportCategoryUpdate(UpdateReportCategoryRequest) returns (ReportCategoryResponse);
-    rpc ReportCategoryDelete(ReportCategoryIdRequest) returns (Ok);
-
-    // Reviews
-    rpc ReviewCreate(CreateReviewRequest) returns (ReviewResponse);
-    rpc GetProductReviews(GetProductReviewsRequest) returns (ReviewsListResponse);
-
-    // NOTE: subscriptions live in users-service (CreateSubscription/DeleteSubscription).
-    // The former activity.ToggleSubscription was a duplicate write path — removed.
-}
-
-// =================================================================
-// Enums
-// =================================================================
-
-// Member names match the DB enum string values exactly (enums: String on the
-// wire), so DB values pass straight through with no mapping. UNSPECIFIED=0
-// represents "no value / not provided" (e.g. an optional list filter).
-enum ReportType {
-    REPORT_TYPE_UNSPECIFIED = 0;
-    PRODUCT = 1;
-    PROFILE = 2;
-    REVIEW = 3;
-}
-
-enum ReportStatus {
-    REPORT_STATUS_UNSPECIFIED = 0;
-    PENDING = 1;
-    IN_PROGRESS = 2;
-    RESOLVED = 3;
-    DISMISSED = 4;
-}
-
-// =================================================================
-// Reports
-// =================================================================
-
-message Report {
-    string id = 1;
-    ReportType type = 2;
-    string object_id = 3;
-    string user_id = 4;
-    string product_id = 5;
-    repeated ReportCategory categories = 6;
-    string message = 7;
-    ReportStatus status = 8;
-    string created_at = 9;
-    string updated_at = 10;
-}
-
-message ReportResponse {
-    Report report = 1;
-}
-
-message CreateReportRequest {
-    string user_id = 1;
-    ReportType type = 2;
-    string object_id = 3;
-    repeated string categories = 4; // names
-    string message = 5;
-}
-
-message ListReportsRequest {
-    ReportType type = 1;
-    ReportStatus status = 2;
-    string user_id = 3;
-    string object_id = 4;
-    int32 page = 5;
-    int32 limit = 6;
-}
-
-message ReportsListResponse {
-    repeated Report items = 1;
-    int32 total = 2;
-    int32 page = 3;
-    int32 limit = 4;
-}
-
-message ReportIdRequest {
-    string id = 1;
-}
-
-message ModerateReportRequest {
-    string id = 1;
-    string action = 2; // 'accept' | 'reject'
-}
-
-// =================================================================
-// Report categories
-// =================================================================
-
-message ReportCategory {
-    string id = 1;
-    string name = 2;
-    ReportType type = 3;
-    string icon = 4;
-    string description = 5;
-}
-
-message ReportCategoryResponse {
-    ReportCategory category = 1;
-}
-
-message CreateReportCategoryRequest {
-    string name = 1;
-    ReportType type = 2;
-    string icon = 3;
-    string description = 4;
-}
-
-message UpdateReportCategoryRequest {
-    string id = 1;
-    string name = 2;
-    string icon = 3;
-    string description = 4;
-}
-
-message ListReportCategoriesRequest {
-    ReportType type = 1;
-}
-
-message ReportCategoriesListResponse {
-    repeated ReportCategory items = 1;
-}
-
-message ReportCategoryIdRequest {
-    string id = 1;
-}
-
-// =================================================================
-// Reviews
-// =================================================================
-
-message ReviewUser {
-    string id = 1;
-    string username = 2;
-    string avatar_url = 3;
-}
-
-message Review {
-    reserved 4, 8, 9; // retired flat user_id / user_username / user_avatar_url
-    string id = 1;
-    int32 rating = 2;
-    string text = 3;
-    string product_id = 5;
-    string created_at = 6;
-    string updated_at = 7;
-    ReviewUser user = 10;
-}
-
-message ReviewResponse {
-    Review review = 1;
-}
-
-message CreateReviewRequest {
-    string user_id = 1;
-    string product_id = 2;
-    int32 rating = 3;
-    string text = 4;
-}
-
-message GetProductReviewsRequest {
-    string product_id = 1;
-    int32 page = 2;
-    int32 limit = 3;
-}
-
-message ReviewsListResponse {
-    repeated Review items = 1;
-    int32 total = 2;
-    int32 page = 3;
-    int32 limit = 4;
-}
-
-// =================================================================
-// Subscriptions
-// =================================================================
-
-// =================================================================
-// Misc
-// =================================================================
-
-message Ok {
-    bool ok = 1;
-}
+syntax = "proto3";
+
+package activity.v1;
+
+service ActivityService {
+    // Reports
+    rpc ReportCreate(CreateReportRequest) returns (ReportResponse);
+    rpc ReportList(ListReportsRequest) returns (ReportsListResponse);
+    rpc ReportGet(ReportIdRequest) returns (ReportResponse);
+    rpc ReportModerate(ModerateReportRequest) returns (ReportResponse);
+
+    // Report categories
+    rpc ReportCategoryCreate(CreateReportCategoryRequest) returns (ReportCategoryResponse);
+    rpc ReportCategoryList(ListReportCategoriesRequest) returns (ReportCategoriesListResponse);
+    rpc ReportCategoryGet(ReportCategoryIdRequest) returns (ReportCategoryResponse);
+    rpc ReportCategoryUpdate(UpdateReportCategoryRequest) returns (ReportCategoryResponse);
+    rpc ReportCategoryDelete(ReportCategoryIdRequest) returns (Ok);
+
+    // Reviews
+    rpc ReviewCreate(CreateReviewRequest) returns (ReviewResponse);
+    rpc GetProductReviews(GetProductReviewsRequest) returns (ReviewsListResponse);
+
+    // NOTE: subscriptions live in users-service (CreateSubscription/DeleteSubscription).
+    // The former activity.ToggleSubscription was a duplicate write path — removed.
+}
+
+// =================================================================
+// Enums
+// =================================================================
+
+// Member names match the DB enum string values exactly (enums: String on the
+// wire), so DB values pass straight through with no mapping. UNSPECIFIED=0
+// represents "no value / not provided" (e.g. an optional list filter).
+enum ReportType {
+    REPORT_TYPE_UNSPECIFIED = 0;
+    PRODUCT = 1;
+    PROFILE = 2;
+    REVIEW = 3;
+}
+
+enum ReportStatus {
+    REPORT_STATUS_UNSPECIFIED = 0;
+    PENDING = 1;
+    IN_PROGRESS = 2;
+    RESOLVED = 3;
+    DISMISSED = 4;
+}
+
+// =================================================================
+// Reports
+// =================================================================
+
+message Report {
+    string id = 1;
+    ReportType type = 2;
+    string object_id = 3;
+    string user_id = 4;
+    string product_id = 5;
+    repeated ReportCategory categories = 6;
+    string message = 7;
+    ReportStatus status = 8;
+    string created_at = 9;
+    string updated_at = 10;
+}
+
+message ReportResponse {
+    Report report = 1;
+}
+
+message CreateReportRequest {
+    string user_id = 1;
+    ReportType type = 2;
+    string object_id = 3;
+    repeated string categories = 4; // names
+    string message = 5;
+}
+
+message ListReportsRequest {
+    ReportType type = 1;
+    ReportStatus status = 2;
+    string user_id = 3;
+    string object_id = 4;
+    int32 page = 5;
+    int32 limit = 6;
+}
+
+message ReportsListResponse {
+    repeated Report items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message ReportIdRequest {
+    string id = 1;
+}
+
+message ModerateReportRequest {
+    string id = 1;
+    string action = 2; // 'accept' | 'reject'
+}
+
+// =================================================================
+// Report categories
+// =================================================================
+
+message ReportCategory {
+    string id = 1;
+    string name = 2;
+    ReportType type = 3;
+    string icon = 4;
+    string description = 5;
+}
+
+message ReportCategoryResponse {
+    ReportCategory category = 1;
+}
+
+message CreateReportCategoryRequest {
+    string name = 1;
+    ReportType type = 2;
+    string icon = 3;
+    string description = 4;
+}
+
+message UpdateReportCategoryRequest {
+    string id = 1;
+    string name = 2;
+    string icon = 3;
+    string description = 4;
+}
+
+message ListReportCategoriesRequest {
+    ReportType type = 1;
+}
+
+message ReportCategoriesListResponse {
+    repeated ReportCategory items = 1;
+}
+
+message ReportCategoryIdRequest {
+    string id = 1;
+}
+
+// =================================================================
+// Reviews
+// =================================================================
+
+message ReviewUser {
+    string id = 1;
+    string username = 2;
+    string avatar_url = 3;
+}
+
+message Review {
+    reserved 4, 8, 9; // retired flat user_id / user_username / user_avatar_url
+    string id = 1;
+    int32 rating = 2;
+    string text = 3;
+    string product_id = 5;
+    string created_at = 6;
+    string updated_at = 7;
+    ReviewUser user = 10;
+}
+
+message ReviewResponse {
+    Review review = 1;
+}
+
+message CreateReviewRequest {
+    string user_id = 1;
+    string product_id = 2;
+    int32 rating = 3;
+    string text = 4;
+}
+
+message GetProductReviewsRequest {
+    string product_id = 1;
+    int32 page = 2;
+    int32 limit = 3;
+}
+
+message ReviewsListResponse {
+    repeated Review items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+// =================================================================
+// Subscriptions
+// =================================================================
+
+// =================================================================
+// Misc
+// =================================================================
+
+message Ok {
+    bool ok = 1;
+}