platform-types 1.10.824 → 1.10.825

package/dist/guestOrderStatus.d.ts

@@ -106,9 +106,14 @@ declare global {
         purchaseWithdrawals?: OrderPurchaseWithdrawalView[];
         /** Whether the withdrawal window is open now — as on `StorefrontOrderView`. Always present. */
         purchaseWithdrawalEligibility: OrderPurchaseWithdrawalEligibility;
-        /** Shopper-sourced return requests, newest first. Reserved — not attached yet. */
+        /**
+         * The order's shopper-sourced return requests (`source: 'shopper'`), any
+         * status, newest first. Absent when there are none, and — with
+         * `returnRequestEligibility` — when the store's return requests could not be
+         * read whole.
+         */
         returnRequests?: OrderReturnRequestView[];
-        /** Reserved — not attached yet. */
+        /** Whether a return request can be opened now. Absent only when the return requests could not be read whole. */
         returnRequestEligibility?: OrderReturnRequestEligibility;
         contact: {
             /** The stored address, masked (e.g. `j***@d***.com`). */

package/dist/paymentAttempt.d.ts

@@ -136,9 +136,14 @@ declare global {
         delivery?: OrderDeliveryView;
         purchaseWithdrawals?: OrderPurchaseWithdrawalView[];
         purchaseWithdrawalEligibility?: OrderPurchaseWithdrawalEligibility;
-        /** Shopper-sourced return requests, newest first. Reserved — not attached yet. */
+        /**
+         * The order's shopper-sourced return requests (`source: 'shopper'`), any
+         * status, newest first. Absent when there are none, and — with
+         * `returnRequestEligibility` — when the store's return requests could not be
+         * read whole.
+         */
         returnRequests?: OrderReturnRequestView[];
-        /** Reserved — not attached yet. */
+        /** Whether a return request can be opened now. Absent only when the return requests could not be read whole. */
         returnRequestEligibility?: OrderReturnRequestEligibility;
     };
     /**

package/dist/rma.d.ts

@@ -234,13 +234,20 @@ declare global {
      * A shopper-sourced return request as the shopper sees it, by ALLOW-LIST:
      * never the operator's reasons or actors, carrier, tracking, nor the
      * shopper's own description. Answered by the shopper's warranty request
-     * (`ShopperReturnRequestSubmitResponse`) and its `orderReturnRequest` frame.
+     * (`ShopperReturnRequestSubmitResponse`), its `orderReturnRequest` frame (on
+     * the request and on every later status move), and the order reads
+     * (`StorefrontOrderView.returnRequests`, `GuestOrderStatusView.returnRequests`).
      */
     interface OrderReturnRequestView {
         rmaId: string;
         flow: ShopperReturnRequestFlow;
         status: RmaStatus;
         requestedAt: number;
+        /**
+         * Unix ms of the request's last write (the `Rma` row's `updatedAt`). Of two
+         * frames or reads of one request, the later `updatedAt` is the current one.
+         */
+        updatedAt: number;
         items: OrderReturnRequestItemView[];
         /** Unix ms. */
         warrantyEndsAt?: number;
@@ -250,6 +257,10 @@ declare global {
             returnShippingPaidBy: ChangeOfMindReturnShippingPayer;
             refundAs: ChangeOfMindRefundAs;
         };
+        /**
+         * The refunds owed on this request, as on a withdrawal. No writer links a
+         * refund to a shopper request yet, so it is absent today.
+         */
         refunds?: OrderPurchaseWithdrawalRefundView[];
     }
     /** `data` of an `orderReturnRequest` socket frame, sent to the order's own customer only. */
@@ -257,7 +268,11 @@ declare global {
         orderId: string;
         returnRequest: OrderReturnRequestView;
     }
-    /** Whether the shopper can open a return request on the order now. Reserved — no read serves it yet. */
+    /**
+     * Whether the shopper can open a return request on the order now — display
+     * only; the request path decides. Served on the order reads beside
+     * `returnRequests`.
+     */
     interface OrderReturnRequestEligibility {
         warranty: {
             open: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.824",
+	"version": "1.10.825",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",