platform-types 1.10.826 → 1.10.827

package/dist/purchaseWithdrawal.d.ts

@@ -143,7 +143,8 @@ declare global {
      * `purchase-withdrawal-received` mail is queued after the commit and
      * stamps `emailQueuedAt`, and the mail worker records `emailStatus`:
      * `sent`, or `not-sent` when the order's customer has no address to mail
-     * or the send was refused for good (a suppressed address included).
+     * or the send was refused for good (a suppressed address included), or
+     * when an operator decided the request before the mail went out.
      */
     interface PurchaseWithdrawalAcknowledgement {
         /** Unix ms. */

package/dist/rma.d.ts

@@ -144,6 +144,14 @@ declare global {
         warrantyEndsAt?: StatutoryInstant;
         /** The store's change-of-mind terms as they stood when requested. Set only on a `change-of-mind` request. */
         changeOfMind?: RmaChangeOfMindTerms;
+        /**
+         * Set only on a `shopper` request, in its create transaction (`shownAt`);
+         * the `return-request-received` mail then stamps `emailQueuedAt` and its
+         * worker `emailStatus`. Absent on an operator request, which mails nothing,
+         * and on a shopper request opened before the acknowledgement shipped — a
+         * missing `acknowledgement` is not an unsent one.
+         */
+        acknowledgement?: ReturnRequestAcknowledgement;
         /** Lowercase, rebuilt on every write. A row missing it is invisible to search. */
         search?: string;
         createdAt: number;
@@ -219,6 +227,15 @@ declare global {
     type RmaSource = (typeof RMA_SOURCES)[number];
     /** The flows a shopper's own return request can land in. */
     type ShopperReturnRequestFlow = Extract<ReturnFlow, 'warranty' | 'change-of-mind'>;
+    /**
+     * A shopper return request's acknowledgement — the purchase withdrawal's
+     * shape: `shownAt` (the `201` showed the request number), `emailQueuedAt`
+     * (the `return-request-received` mail was queued) and `emailStatus` (`sent`,
+     * or `not-sent` when the customer has no address, the send was refused for
+     * good, or an operator decided the request before the mail went out). The operator reads an undelivered acknowledgement off it; the
+     * shopper's view never carries it.
+     */
+    type ReturnRequestAcknowledgement = PurchaseWithdrawalAcknowledgement;
     /** The change-of-mind terms snapshotted onto a request, so a later policy edit does not rewrite them. */
     interface RmaChangeOfMindTerms {
         endsAt: StatutoryInstant;

package/package.json

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