@aepstore-dev/contracts 1.36.0 → 1.37.0

package/gen/payments.ts

@@ -119,7 +119,9 @@ export interface ListTransactionsRequest {
   /**
    * ↓ added for the wallet statement page (Round 3)
    * UI-semantic filter mapped onto displayKind:
-   *   ALL | INCOME | OUTCOME | REFUND | WITHDRAWAL | PREMIUM
+   *   ALL | SALES | INCOME | OUTCOME | REFUND | WITHDRAWAL | PREMIUM
+   * SALES = the seller's earnings on this account (USER_PENDING credits from
+   * PURCHASE transactions); these stay separate from INCOME (TOPUP).
    */
   flow: string;
   /**
@@ -155,12 +157,16 @@ export interface StatementEntry {
   /**
    * ↓ added for the wallet statement page (Round 3)
    * UI-friendly classification computed server-side:
-   *   TOPUP | PURCHASE | REFUND | PREMIUM | WITHDRAWAL | SALE_CLEAR | ADJUSTMENT
+   *   TOPUP | PURCHASE | SALE | REFUND | PREMIUM | WITHDRAWAL | ADJUSTMENT
+   * SALE is the seller's view of someone else's PURCHASE (CREDIT to their
+   * USER_PENDING) — distinct from PURCHASE which is the buyer's DEBIT.
    * PREMIUM is split out of PURCHASE/REFUND so the UI can show
    * "Продление Premium" / refund-of-premium in their own filter bucket.
+   * SALE_CLEAR transactions are excluded from the wallet view — the maturity
+   * event is surfaced via sale_status on the original SALE row instead.
    */
   displayKind: string;
-  /** running USER_SPENDING-style balance, Decimal-as-string */
+  /** affected-account running balance, Decimal-as-string */
   balanceAfter: string;
   /** empty for non-product entries */
   productId: string;
@@ -169,6 +175,17 @@ export interface StatementEntry {
   productCategory: string;
   /** optional thumbnail URL for richer rows */
   productPreview: string;
+  /**
+   * Sale lifecycle. Populated only when display_kind=SALE.
+   *   PENDING — held in USER_PENDING, not yet withdrawable.
+   *   MATURED — SALE_CLEAR has fired; money is in USER_PAYOUT.
+   */
+  saleStatus: string;
+  /**
+   * ISO 8601 when the sale becomes withdrawable (sale_completed_at +
+   * GRACE_DAYS). Empty for non-sale rows.
+   */
+  maturesAt: string;
 }
 
 export interface TransactionsListResponse {

package/package.json

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

package/proto/payments.proto

@@ -124,7 +124,9 @@ message ListTransactionsRequest {
     int32 limit = 4;
     // ↓ added for the wallet statement page (Round 3)
     // UI-semantic filter mapped onto displayKind:
-    //   ALL | INCOME | OUTCOME | REFUND | WITHDRAWAL | PREMIUM
+    //   ALL | SALES | INCOME | OUTCOME | REFUND | WITHDRAWAL | PREMIUM
+    // SALES = the seller's earnings on this account (USER_PENDING credits from
+    // PURCHASE transactions); these stay separate from INCOME (TOPUP).
     string flow = 5;
     // Period selection. `month` is the convenience form (YYYY-MM) used by the
     // month dropdown; from/to override it for an arbitrary range.
@@ -151,15 +153,26 @@ message StatementEntry {
     string created_at = 8;
     // ↓ added for the wallet statement page (Round 3)
     // UI-friendly classification computed server-side:
-    //   TOPUP | PURCHASE | REFUND | PREMIUM | WITHDRAWAL | SALE_CLEAR | ADJUSTMENT
+    //   TOPUP | PURCHASE | SALE | REFUND | PREMIUM | WITHDRAWAL | ADJUSTMENT
+    // SALE is the seller's view of someone else's PURCHASE (CREDIT to their
+    // USER_PENDING) — distinct from PURCHASE which is the buyer's DEBIT.
     // PREMIUM is split out of PURCHASE/REFUND so the UI can show
     // "Продление Premium" / refund-of-premium in their own filter bucket.
+    // SALE_CLEAR transactions are excluded from the wallet view — the maturity
+    // event is surfaced via sale_status on the original SALE row instead.
     string display_kind = 9;
-    string balance_after = 10;       // running USER_SPENDING-style balance, Decimal-as-string
+    string balance_after = 10;       // affected-account running balance, Decimal-as-string
     string product_id = 11;          // empty for non-product entries
     string product_name = 12;
     string product_category = 13;    // "Assets" | "Project File" | "Templates"
     string product_preview = 14;     // optional thumbnail URL for richer rows
+    // Sale lifecycle. Populated only when display_kind=SALE.
+    //   PENDING — held in USER_PENDING, not yet withdrawable.
+    //   MATURED — SALE_CLEAR has fired; money is in USER_PAYOUT.
+    string sale_status = 15;
+    // ISO 8601 when the sale becomes withdrawable (sale_completed_at +
+    // GRACE_DAYS). Empty for non-sale rows.
+    string matures_at = 16;
 }
 message TransactionsListResponse { repeated StatementEntry items = 1; int32 total = 2; int32 page = 3; int32 limit = 4; }