platform-types 1.10.822 → 1.10.823

package/dist/cjs/purchaseWithdrawal.js

@@ -83,6 +83,11 @@ exports.PURCHASE_WITHDRAWAL_ACTION_MODES = ['accept', 'decline', 'relay'];
  *   already returned (`data.orderItemIndex`).
  * - `nothing-to-withdraw` — every line is already withdrawn or returned.
  * - `not-delivered` — a warranty request on an order not yet delivered.
+ * - `return-request-open` — a warranty request on an order that already has an
+ *   open shopper return request (`requested`, `authorized` or `received`);
+ *   `data.rmaId` names it. One open shopper request per order.
+ * - `too-many-lines` — a warranty request naming, or resolving to, more lines
+ *   than one return request may hold; `data.max` is the bound.
  */
 exports.PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS = [
     'order-cancelled',
@@ -92,6 +97,8 @@ exports.PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS = [
     'line-unavailable',
     'nothing-to-withdraw',
     'not-delivered',
+    'return-request-open',
+    'too-many-lines',
 ];
 /**
  * Why accepting a withdrawal before fulfilment is refused
@@ -123,7 +130,8 @@ exports.PURCHASE_WITHDRAWAL_CODE_DUE_MS = 24 * 60 * 60 * 1000;
  * The `intent` a guest's withdrawal body names: the purchase withdrawal
  * (*"Me arrepentí"*) only. A warranty request is a separate body variant
  * ({@link SHOPPER_REQUEST_INTENTS}), never a widening of this tuple — the
- * withdrawal handler does not branch on `intent`.
+ * routes dispatch on `intent` to the warranty request before the withdrawal
+ * path, which itself never reads it.
  */
 exports.PURCHASE_WITHDRAWAL_GUEST_INTENTS = ['purchase-withdrawal'];
 /**

package/dist/cjs/socket.js

@@ -555,6 +555,16 @@ exports.SOCKET_ACTIONS = [
      * row, carrying or no longer carrying the dispatch lock) follows both.
      */
     'orderPurchaseWithdrawal',
+    /**
+     * A shopper's own return request (a warranty request) was opened. `data` is
+     * `OrderReturnRequestFrameData` (`rma.ts`) — the order id and the shopper's
+     * `OrderReturnRequestView`, an allow-list: never the description, the
+     * operator's reasons or actors, carrier or tracking.
+     *
+     * ⚠️ To the order's OWN customer only (`wsPostCustomer`), never a store-wide
+     * customer broadcast. The operator frame for the same write is `rma`.
+     */
+    'orderReturnRequest',
     /**
      * A purchase withdrawal was requested, relayed or decided. `data` is the
      * `PurchaseWithdrawal` record as `GET /purchase-withdrawals` answers it.

package/dist/order.d.ts

@@ -1290,6 +1290,15 @@ declare global {
          * never commit off the same read.
          */
         purchaseWithdrawalCount?: number;
+        /**
+         * How many RMAs were ever created on the order — every RMA, by an operator
+         * (`POST /rma { mode: 'create' }`) or the shopper (a warranty request).
+         * Server-owned: every RMA create pins it and bumps it, and a purchase
+         * withdrawal pins it, each together with `purchaseWithdrawalCount` as
+         * read, so no two of them commit off the same read of the order's free
+         * lines.
+         */
+        returnRequestCount?: number;
         /** Bounded free text supplied by the canceller. */
         cancellationReason?: string;
         mercadolibreCreditNote?: {

package/dist/purchaseWithdrawal.d.ts

@@ -65,8 +65,13 @@ export declare const PURCHASE_WITHDRAWAL_ACTION_MODES: readonly ["accept", "decl
  *   already returned (`data.orderItemIndex`).
  * - `nothing-to-withdraw` — every line is already withdrawn or returned.
  * - `not-delivered` — a warranty request on an order not yet delivered.
+ * - `return-request-open` — a warranty request on an order that already has an
+ *   open shopper return request (`requested`, `authorized` or `received`);
+ *   `data.rmaId` names it. One open shopper request per order.
+ * - `too-many-lines` — a warranty request naming, or resolving to, more lines
+ *   than one return request may hold; `data.max` is the bound.
  */
-export declare const PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS: readonly ["order-cancelled", "no-customer", "partial-before-fulfilment", "line-not-on-order", "line-unavailable", "nothing-to-withdraw", "not-delivered"];
+export declare const PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS: readonly ["order-cancelled", "no-customer", "partial-before-fulfilment", "line-not-on-order", "line-unavailable", "nothing-to-withdraw", "not-delivered", "return-request-open", "too-many-lines"];
 /**
  * Why accepting a withdrawal before fulfilment is refused
  * `409 PURCHASE_WITHDRAWAL_FISCAL_IN_FLIGHT` (`data.cause`) — a factura is in
@@ -97,7 +102,8 @@ export declare const PURCHASE_WITHDRAWAL_CODE_DUE_MS: number;
  * The `intent` a guest's withdrawal body names: the purchase withdrawal
  * (*"Me arrepentí"*) only. A warranty request is a separate body variant
  * ({@link SHOPPER_REQUEST_INTENTS}), never a widening of this tuple — the
- * withdrawal handler does not branch on `intent`.
+ * routes dispatch on `intent` to the warranty request before the withdrawal
+ * path, which itself never reads it.
  */
 export declare const PURCHASE_WITHDRAWAL_GUEST_INTENTS: readonly ["purchase-withdrawal"];
 /**
@@ -339,11 +345,21 @@ declare global {
         source: 'W2';
         /** Unix ms. Present only when the store's change-of-mind policy is on but its window has passed too. */
         changeOfMindEndsAt?: number;
+        /**
+         * Unix ms — the end of the legal warranty window (`W3`), present only
+         * when the order was delivered and that window is still open, so the
+         * form can offer to resend the same request with `intent: 'warranty'`
+         * (a guest may resend the same code).
+         */
+        warrantyEndsAt?: number;
     }
     type ShopperRequestIntent = (typeof SHOPPER_REQUEST_INTENTS)[number];
     /**
-     * The warranty variant of `POST /orders/purchase-withdrawal`. Reserved — the
-     * live strict body refuses it `400` until the warranty request ships.
+     * The warranty variant of `POST /orders/purchase-withdrawal` (*"El producto
+     * tiene un problema"*): opens a shopper `Rma` (`flow: 'warranty'`) on a
+     * delivered order inside the warranty window. Never refused
+     * `PURCHASE_WITHDRAWAL_ALREADY_REQUESTED`; an undecided withdrawal holds
+     * only its own lines. `lines` absent means every line still available.
      */
     interface ShopperWarrantySubmitRequest {
         intent: 'warranty';
@@ -357,7 +373,12 @@ declare global {
         description: string;
     }
     type ShopperOrderRequest = PurchaseWithdrawalSubmitRequest | ShopperWarrantySubmitRequest;
-    /** The warranty variant of the guest submit. Reserved, as {@link ShopperWarrantySubmitRequest}. */
+    /**
+     * The warranty variant of the guest submit, as {@link ShopperWarrantySubmitRequest}.
+     * The code is not bound to an intent: a guest refused
+     * `PURCHASE_WITHDRAWAL_WINDOW_CLOSED` may resend the same unspent code with
+     * `intent: 'warranty'`.
+     */
     interface ShopperWarrantyGuestSubmitRequest {
         challengeHandle: string;
         code: string;
@@ -387,6 +408,10 @@ declare global {
         reason: PurchaseWithdrawalIneligibleReason;
         /** The line refused, for `line-not-on-order` and `line-unavailable`. */
         orderItemIndex?: number;
+        /** The open shopper return request, for `return-request-open`. */
+        rmaId?: string;
+        /** The most lines one return request may hold, for `too-many-lines`. */
+        max?: number;
     }
     /** One of {@link PURCHASE_WITHDRAWAL_LIST_FILTERS}. */
     type PurchaseWithdrawalListFilter = (typeof PURCHASE_WITHDRAWAL_LIST_FILTERS)[number];

package/dist/purchaseWithdrawal.js

@@ -80,6 +80,11 @@ export const PURCHASE_WITHDRAWAL_ACTION_MODES = ['accept', 'decline', 'relay'];
  *   already returned (`data.orderItemIndex`).
  * - `nothing-to-withdraw` — every line is already withdrawn or returned.
  * - `not-delivered` — a warranty request on an order not yet delivered.
+ * - `return-request-open` — a warranty request on an order that already has an
+ *   open shopper return request (`requested`, `authorized` or `received`);
+ *   `data.rmaId` names it. One open shopper request per order.
+ * - `too-many-lines` — a warranty request naming, or resolving to, more lines
+ *   than one return request may hold; `data.max` is the bound.
  */
 export const PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS = [
     'order-cancelled',
@@ -89,6 +94,8 @@ export const PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS = [
     'line-unavailable',
     'nothing-to-withdraw',
     'not-delivered',
+    'return-request-open',
+    'too-many-lines',
 ];
 /**
  * Why accepting a withdrawal before fulfilment is refused
@@ -120,7 +127,8 @@ export const PURCHASE_WITHDRAWAL_CODE_DUE_MS = 24 * 60 * 60 * 1000;
  * The `intent` a guest's withdrawal body names: the purchase withdrawal
  * (*"Me arrepentí"*) only. A warranty request is a separate body variant
  * ({@link SHOPPER_REQUEST_INTENTS}), never a widening of this tuple — the
- * withdrawal handler does not branch on `intent`.
+ * routes dispatch on `intent` to the warranty request before the withdrawal
+ * path, which itself never reads it.
  */
 export const PURCHASE_WITHDRAWAL_GUEST_INTENTS = ['purchase-withdrawal'];
 /**

package/dist/rma.d.ts

@@ -83,13 +83,18 @@ declare global {
         customerId?: string;
         status: RmaStatus;
         items: RmaItem[];
-        /** Operator who entered the request — typically off a phone call. */
+        /**
+         * Who entered the request: the operator (typically off a phone call), or
+         * — on a `shopper` request — the order's customer id (a guest row's id
+         * for a guest order).
+         */
         requestedBy: string;
         requestedAt: number;
         /**
-         * Free text from the customer, relayed by the operator. Bounded. Not
-         * written for a customer whose data was erased, and REMOVEd from the row
-         * by an erasure (Ley 25.326 art. 16).
+         * Free text from the customer — relayed by the operator, or typed by the
+         * shopper on a `shopper` request (its `description`). Bounded. Not
+         * written for a customer whose data was erased, REMOVEd from the row by an
+         * erasure (Ley 25.326 art. 16), and never in an audit row.
          */
         requestReason?: string;
         authorizedBy?: string;
@@ -125,7 +130,12 @@ declare global {
          * field's meaning does not change.
          */
         expiresAt?: number;
-        /** Who opened the request. Absent means `operator`. No writer sets another value yet. */
+        /**
+         * Who opened the request. Absent means `operator`. `shopper` is the
+         * storefront warranty request (`POST /orders/purchase-withdrawal` and its
+         * guest twin with `intent: 'warranty'`); `purchase-withdrawal` has no
+         * writer yet.
+         */
         source?: RmaSource;
         /** Server-derived legal track. Absent on an operator request. */
         flow?: ReturnFlow;
@@ -223,7 +233,8 @@ 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. Reserved — no read serves it yet.
+     * shopper's own description. Answered by the shopper's warranty request
+     * (`ShopperReturnRequestSubmitResponse`) and its `orderReturnRequest` frame.
      */
     interface OrderReturnRequestView {
         rmaId: string;
@@ -241,6 +252,11 @@ declare global {
         };
         refunds?: OrderPurchaseWithdrawalRefundView[];
     }
+    /** `data` of an `orderReturnRequest` socket frame, sent to the order's own customer only. */
+    interface OrderReturnRequestFrameData {
+        orderId: string;
+        returnRequest: OrderReturnRequestView;
+    }
     /** Whether the shopper can open a return request on the order now. Reserved — no read serves it yet. */
     interface OrderReturnRequestEligibility {
         warranty: {

package/dist/socket.d.ts

@@ -26,7 +26,7 @@
  * A client must ignore actions it does not own rather than assume it
  * receives all of them.
  */
-export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems", "wholesaleRequests"];
+export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems", "wholesaleRequests"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**

package/dist/socket.js

@@ -552,6 +552,16 @@ export const SOCKET_ACTIONS = [
      * row, carrying or no longer carrying the dispatch lock) follows both.
      */
     'orderPurchaseWithdrawal',
+    /**
+     * A shopper's own return request (a warranty request) was opened. `data` is
+     * `OrderReturnRequestFrameData` (`rma.ts`) — the order id and the shopper's
+     * `OrderReturnRequestView`, an allow-list: never the description, the
+     * operator's reasons or actors, carrier or tracking.
+     *
+     * ⚠️ To the order's OWN customer only (`wsPostCustomer`), never a store-wide
+     * customer broadcast. The operator frame for the same write is `rma`.
+     */
+    'orderReturnRequest',
     /**
      * A purchase withdrawal was requested, relayed or decided. `data` is the
      * `PurchaseWithdrawal` record as `GET /purchase-withdrawals` answers it.

package/package.json

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