platform-types 1.10.816 → 1.10.818

package/dist/cjs/guestOrderStatus.js

@@ -7,8 +7,13 @@
  * The token (`gs1.…`) is a bearer credential over exactly ONE order, read-only:
  * it authorises no cart write, payment, cancellation, withdrawal or export. It
  * carries no expiry; the read is refused once the order was delivered (or
- * cancelled) more than `guestStatusLinkDaysAfterDelivery` days ago, and every
- * earlier link dies when a recovery or an operator revokes it.
+ * cancelled) more than `guestStatusLinkDaysAfterDelivery` days ago — unless a
+ * purchase withdrawal on it is not final or a refund on it is not closed — and
+ * every earlier link dies when a recovery or an operator revokes it.
+ *
+ * The guest purchase-withdrawal start (`POST /orders/purchase-withdrawal/guest/start`)
+ * accepts the token only to NAME the order: the withdrawal itself needs the
+ * code mailed to the order's address, so the token still authorises none.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GUEST_ORDER_STATUS_LINK_TEMPLATE = exports.GUEST_ORDER_STATUS_ERROR_CODES = void 0;

package/dist/cjs/order.js

@@ -671,6 +671,9 @@ exports.ORDER_ERROR_CODES = [
     // Storefront checkout: the cart re-priced since the shopper saw it (re-read and
     // confirm), and an allocated order id already taken (retry).
     'CART_PRICES_CHANGED',
+    // Storefront checkout: a cart line whose product the shopper's list no longer
+    // prices (or a channel-gated one); `unavailableProducts` names the product ids.
+    'PRODUCT_NOT_AVAILABLE',
     'ORDER_ID_COLLISION',
     'DELIVERY_METHOD_NOT_FOUND',
     // A priced delivery method (`Method.fee`): the freight moved since the shopper

package/dist/cjs/purchaseWithdrawal.js

@@ -20,7 +20,7 @@
  * `status`, `revisedAt` replaces `updatedAt`, and there is no `dated`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PURCHASE_WITHDRAWAL_CODE_DUE_MS = exports.PURCHASE_WITHDRAWAL_CODE_DUE_SOURCE = exports.PURCHASE_WITHDRAWAL_WINDOW_SOURCE = exports.PURCHASE_WITHDRAWAL_WINDOW_DAYS = exports.PURCHASE_WITHDRAWAL_LINES_MAX = exports.PURCHASE_WITHDRAWAL_NOTE_MAX = exports.PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS = exports.PURCHASE_WITHDRAWAL_ACTION_MODES = exports.PURCHASE_WITHDRAWAL_RELAY_CHANNELS = exports.PURCHASE_WITHDRAWAL_DECLINE_REASONS = exports.PURCHASE_WITHDRAWAL_SOURCES = exports.PURCHASE_WITHDRAWAL_LIST_FILTERS = exports.PURCHASE_WITHDRAWAL_STATES = void 0;
+exports.PURCHASE_WITHDRAWAL_VERIFICATION_FAILED = exports.PURCHASE_WITHDRAWAL_GUEST_INTENTS = exports.PURCHASE_WITHDRAWAL_CODE_DUE_MS = exports.PURCHASE_WITHDRAWAL_CODE_DUE_SOURCE = exports.PURCHASE_WITHDRAWAL_WINDOW_SOURCE = exports.PURCHASE_WITHDRAWAL_WINDOW_DAYS = exports.PURCHASE_WITHDRAWAL_LINES_MAX = exports.PURCHASE_WITHDRAWAL_NOTE_MAX = exports.PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS = exports.PURCHASE_WITHDRAWAL_ACTION_MODES = exports.PURCHASE_WITHDRAWAL_RELAY_CHANNELS = exports.PURCHASE_WITHDRAWAL_DECLINE_REASONS = exports.PURCHASE_WITHDRAWAL_SOURCES = exports.PURCHASE_WITHDRAWAL_LIST_FILTERS = exports.PURCHASE_WITHDRAWAL_STATES = void 0;
 /**
  * - `requested` — submitted, the code minted, the order's dispatch locked
  *   (`purchase-withdrawal-pending`) until an operator decides.
@@ -100,3 +100,17 @@ exports.PURCHASE_WITHDRAWAL_WINDOW_SOURCE = 'W2';
 exports.PURCHASE_WITHDRAWAL_CODE_DUE_SOURCE = 'W1';
 /** How long after a relayed request was received its code is due, in ms. */
 exports.PURCHASE_WITHDRAWAL_CODE_DUE_MS = 24 * 60 * 60 * 1000;
+/**
+ * The `intent` a guest's `POST /orders/purchase-withdrawal/guest` names. Only
+ * the purchase withdrawal (*"Me arrepentí"*) today; the warranty intent joins
+ * this tuple with the warranty request.
+ */
+exports.PURCHASE_WITHDRAWAL_GUEST_INTENTS = ['purchase-withdrawal'];
+/**
+ * The one refusal of every guest code failure on `POST
+ * /orders/purchase-withdrawal/guest` (`401`): a wrong, expired, exhausted or
+ * already used code, a challenge that does not exist (another store's
+ * included), and an order that is no longer a guest order — one body, so the
+ * route is never an oracle for which one it was.
+ */
+exports.PURCHASE_WITHDRAWAL_VERIFICATION_FAILED = 'PURCHASE_WITHDRAWAL_VERIFICATION_FAILED';

package/dist/cjs/socket.js

@@ -551,7 +551,8 @@ exports.SOCKET_ACTIONS = [
      *
      * ⚠️ To the order's OWN customer only (`wsPostCustomer`), never a store-wide
      * customer broadcast. The operator frame for the same write is
-     * `purchaseWithdrawalChanged`.
+     * `purchaseWithdrawalChanged`; the order's own `orders` frame (the post-commit
+     * row, carrying or no longer carrying the dispatch lock) follows both.
      */
     'orderPurchaseWithdrawal',
     /**

package/dist/guestOrderStatus.d.ts

@@ -6,8 +6,13 @@
  * The token (`gs1.…`) is a bearer credential over exactly ONE order, read-only:
  * it authorises no cart write, payment, cancellation, withdrawal or export. It
  * carries no expiry; the read is refused once the order was delivered (or
- * cancelled) more than `guestStatusLinkDaysAfterDelivery` days ago, and every
- * earlier link dies when a recovery or an operator revokes it.
+ * cancelled) more than `guestStatusLinkDaysAfterDelivery` days ago — unless a
+ * purchase withdrawal on it is not final or a refund on it is not closed — and
+ * every earlier link dies when a recovery or an operator revokes it.
+ *
+ * The guest purchase-withdrawal start (`POST /orders/purchase-withdrawal/guest/start`)
+ * accepts the token only to NAME the order: the withdrawal itself needs the
+ * code mailed to the order's address, so the token still authorises none.
  */
 /**
  * The refusals the guest status routes answer themselves.
@@ -93,6 +98,14 @@ declare global {
         onlinePayment?: true;
         /** The latest online payment attempt, when the order has one. */
         paymentAttempt?: OrderPaymentAttemptView;
+        /**
+         * The order's purchase withdrawals, newest first, with their refunds —
+         * the same `OrderPurchaseWithdrawalView`s `StorefrontOrderView` carries.
+         * Absent when the order has none.
+         */
+        purchaseWithdrawals?: OrderPurchaseWithdrawalView[];
+        /** Whether the withdrawal window is open now — as on `StorefrontOrderView`. Always present. */
+        purchaseWithdrawalEligibility: OrderPurchaseWithdrawalEligibility;
         contact: {
             /** The stored address, masked (e.g. `j***@d***.com`). */
             emailMasked: string;

package/dist/guestOrderStatus.js

@@ -6,8 +6,13 @@
  * The token (`gs1.…`) is a bearer credential over exactly ONE order, read-only:
  * it authorises no cart write, payment, cancellation, withdrawal or export. It
  * carries no expiry; the read is refused once the order was delivered (or
- * cancelled) more than `guestStatusLinkDaysAfterDelivery` days ago, and every
- * earlier link dies when a recovery or an operator revokes it.
+ * cancelled) more than `guestStatusLinkDaysAfterDelivery` days ago — unless a
+ * purchase withdrawal on it is not final or a refund on it is not closed — and
+ * every earlier link dies when a recovery or an operator revokes it.
+ *
+ * The guest purchase-withdrawal start (`POST /orders/purchase-withdrawal/guest/start`)
+ * accepts the token only to NAME the order: the withdrawal itself needs the
+ * code mailed to the order's address, so the token still authorises none.
  */
 /**
  * The refusals the guest status routes answer themselves.

package/dist/order.d.ts

@@ -1107,7 +1107,9 @@ declare global {
          * checkout and the presupuesto conversion refuse (`PRODUCT_COST_UNKNOWN` —
          * an operator is standing there who can cost the product), while the
          * STOREFRONT checkout and the SERVICE HANDOVER commit and write one deduped
-         * `ORDER_PRODUCT_COST_UNKNOWN` log instead. The handover is deliberate: it
+         * `ORDER_PRODUCT_COST_UNKNOWN` log instead. On the storefront that is only
+         * reachable for a line priced by an ABSOLUTE slot: a cost-less product on a
+         * percent slot has no selling price and is refused `PRODUCT_NOT_AVAILABLE`. The handover is deliberate: it
          * is a customer collecting their own repaired equipment, and that path
          * declines to block on a stock shortfall for the same reason.
          *
@@ -3075,6 +3077,6 @@ export declare const orderFulfilmentProgress: (order: OrderFulfilmentProgressInp
  * `SUBSCRIPTION_READONLY`) sit on the order CREATE leg only: an edit is not a new
  * order, so `bareOrderPostHandler` routes past `requireMetered` entirely.
  */
-export declare const ORDER_ERROR_CODES: readonly ["ORDER_COST_DENOMINATION_UNKNOWN", "SERVICE_ORDER_DELIVERY_MANAGED", "ORDER_NOT_FOUND", "ORDER_LOCKED", "ORDER_NOT_READY", "ORDER_DELIVERED_ANOTHER_DAY", "ORDER_DELIVERY_STATE_UNCHANGED", "ORDER_ILLEGAL_TRANSITION", "ORDER_VERSION_CONFLICT", "CUSTOMER_NOT_FOUND", "CUSTOMER_MERGED", "ORDER_HAS_NO_CUSTOMER", "CUSTOMER_ANONYMIZED", "FX_CONVERSION_UNAVAILABLE", "ROLE_FORBIDDEN", "ORDER_CANCELLED", "PAYMENT_SETTLED_ON_ANOTHER_ORDER", "ORDER_HAS_SHIPMENTS", "ORDER_HAS_RETURNS", "SHIPMENT_QUANTITY_EXCEEDED", "SHIPMENT_LINE_MISMATCH", "SHIPMENT_NOT_FOUND", "SHIPMENT_LIMIT_REACHED", "SHIPMENT_TOO_LARGE", "ORDER_FULFILMENT_EXTERNAL", "SHIPMENT_FAILED", "ADMIN_REQUIRED", "IDEMPOTENCY_KEY_REQUIRED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_LOCK_CONTENTION", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENT_RESPONSE_NOT_CACHED", "ORDER_CANCELLATION_NOT_PROTECTED", "ORDER_CANCELLATION_COMMITTED", "ORDER_CANCELLATION_LOCKED", "ORDER_CANCELLATION_TOO_LARGE", "ORDER_CANCELLATION_FAILED", "SALE_LEDGER_RETRACTION_REFUSED", "SALE_LEDGER_ROW_NOT_OWNED", "PRODUCT_NOT_FOUND", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "DEPOSIT_SOURCE_NOT_ALLOWED", "DEPOSIT_CURRENCY_MISMATCH", "DEPOSIT_EXCEEDS_TOTAL", "DEPOSIT_FREEZE_REQUIRES_INVOICE", "DEPOSIT_FREEZE_INVOICE_PENDING", "DEPOSIT_CHARACTERIZATION_CONFLICT", "DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING", "DEPOSIT_INVOICED_ORDER_MUST_FREEZE", "DEPOSIT_FROZEN_ORDER_MUST_FREEZE", "DEPOSIT_REFERENCE_IS_LINKED_PAYMENT", "DEPOSIT_DUPLICATE_REFERENCE", "TILL_TENDER_REQUIRES_DEPOSIT", "PAYMENT_REFERENCED_BY_DEPOSIT", "ORDER_HAS_UNREFUNDED_DEPOSIT", "ORDER_PRICE_FROZEN", "DEPOSIT_NOT_FOUND", "DEPOSIT_ALREADY_REFUNDED", "UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "UNIT_QUANTITY_UNREPRESENTABLE", "KIT_RECIPE_CHANGED", "CART_PROMOTION_UNAVAILABLE", "ORDER_HAS_KIT_LINES", "ORDER_HAS_FREIGHT_LINE", "ORDER_TARGET_REQUIRED", "ORDER_SOURCE_CONFLICT", "ORDER_CUSTOMER_REQUIRED", "BASKET_EMPTY", "BASKET_CHANGED_DURING_CHECKOUT", "CART_VERSION_CREATE_ONLY", "CART_VERSION_REQUIRES_CART_ID", "CART_REVISION_STALE", "CART_CUSTOMER_MISMATCH", "COUNTER_SALE_CREATE_ONLY", "SOLD_AT_CREATE_ONLY", "SOLD_AT_IN_FUTURE", "ORDER_TENDER_CREATE_ONLY", "CREDIT_OVERRIDE_CREATE_ONLY", "ON_ACCOUNT_CREATE_ONLY", "ON_ACCOUNT_WITH_TENDERS", "TENDERS_REQUIRE_COUNTER_SALE", "LINES_REQUIRE_COUNTER_SALE", "PRODUCT_COST_UNKNOWN", "PRICE_CHANGE_DISABLED", "LINE_DISCOUNT_EXCEEDS_MAX", "CUSTOMER_DISABLED", "SHIFT_NOT_AVAILABLE", "SOLD_AT_OUTSIDE_SHIFT", "ORDER_CURRENCY_NOT_SUBSCRIBED", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "PAYMENT_METHOD_UNAVAILABLE", "CART_PRICES_CHANGED", "ORDER_ID_COLLISION", "DELIVERY_METHOD_NOT_FOUND", "DELIVERY_FEE_CHANGED", "DELIVERY_FEE_CURRENCY_UNSUPPORTED", "GUEST_CONTACT_REQUIRED", "ORDER_BELOW_MINIMUM_PURCHASE", "ORDER_INVALID_CART", "CART_CHANGED_SINCE_CONFIRM", "EMAIL_VERIFICATION_REQUIRED", "ACCOUNT_DISABLED", "CUSTOMER_ACCESS_PENDING", "CUSTOMER_ACCESS_REJECTED", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "ORDER_DISCOUNT_AFTER_INVOICE", "ORDER_DISCOUNT_ON_SERVICE_ORDER", "ORDER_DISCOUNT_ON_MARKETPLACE_ORDER", "ORDER_INVOICE_METHOD_OUTSTANDING_FACTURA", "ORDER_SERVICE_PERIOD_AFTER_INVOICE", "ORDER_ATTEMPT_COMMITTED", "ORDER_ATTEMPT_ABANDONED", "ORDER_ATTEMPT_KEY_EXPIRED", "ORDER_ATTEMPT_KEY_SCOPE_MISMATCH", "ORDER_COMPLETION_ATTEMPT_COMMITTED", "ORDER_COMPLETION_ATTEMPT_ABANDONED"];
+export declare const ORDER_ERROR_CODES: readonly ["ORDER_COST_DENOMINATION_UNKNOWN", "SERVICE_ORDER_DELIVERY_MANAGED", "ORDER_NOT_FOUND", "ORDER_LOCKED", "ORDER_NOT_READY", "ORDER_DELIVERED_ANOTHER_DAY", "ORDER_DELIVERY_STATE_UNCHANGED", "ORDER_ILLEGAL_TRANSITION", "ORDER_VERSION_CONFLICT", "CUSTOMER_NOT_FOUND", "CUSTOMER_MERGED", "ORDER_HAS_NO_CUSTOMER", "CUSTOMER_ANONYMIZED", "FX_CONVERSION_UNAVAILABLE", "ROLE_FORBIDDEN", "ORDER_CANCELLED", "PAYMENT_SETTLED_ON_ANOTHER_ORDER", "ORDER_HAS_SHIPMENTS", "ORDER_HAS_RETURNS", "SHIPMENT_QUANTITY_EXCEEDED", "SHIPMENT_LINE_MISMATCH", "SHIPMENT_NOT_FOUND", "SHIPMENT_LIMIT_REACHED", "SHIPMENT_TOO_LARGE", "ORDER_FULFILMENT_EXTERNAL", "SHIPMENT_FAILED", "ADMIN_REQUIRED", "IDEMPOTENCY_KEY_REQUIRED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_LOCK_CONTENTION", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENT_RESPONSE_NOT_CACHED", "ORDER_CANCELLATION_NOT_PROTECTED", "ORDER_CANCELLATION_COMMITTED", "ORDER_CANCELLATION_LOCKED", "ORDER_CANCELLATION_TOO_LARGE", "ORDER_CANCELLATION_FAILED", "SALE_LEDGER_RETRACTION_REFUSED", "SALE_LEDGER_ROW_NOT_OWNED", "PRODUCT_NOT_FOUND", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "DEPOSIT_SOURCE_NOT_ALLOWED", "DEPOSIT_CURRENCY_MISMATCH", "DEPOSIT_EXCEEDS_TOTAL", "DEPOSIT_FREEZE_REQUIRES_INVOICE", "DEPOSIT_FREEZE_INVOICE_PENDING", "DEPOSIT_CHARACTERIZATION_CONFLICT", "DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING", "DEPOSIT_INVOICED_ORDER_MUST_FREEZE", "DEPOSIT_FROZEN_ORDER_MUST_FREEZE", "DEPOSIT_REFERENCE_IS_LINKED_PAYMENT", "DEPOSIT_DUPLICATE_REFERENCE", "TILL_TENDER_REQUIRES_DEPOSIT", "PAYMENT_REFERENCED_BY_DEPOSIT", "ORDER_HAS_UNREFUNDED_DEPOSIT", "ORDER_PRICE_FROZEN", "DEPOSIT_NOT_FOUND", "DEPOSIT_ALREADY_REFUNDED", "UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "UNIT_QUANTITY_UNREPRESENTABLE", "KIT_RECIPE_CHANGED", "CART_PROMOTION_UNAVAILABLE", "ORDER_HAS_KIT_LINES", "ORDER_HAS_FREIGHT_LINE", "ORDER_TARGET_REQUIRED", "ORDER_SOURCE_CONFLICT", "ORDER_CUSTOMER_REQUIRED", "BASKET_EMPTY", "BASKET_CHANGED_DURING_CHECKOUT", "CART_VERSION_CREATE_ONLY", "CART_VERSION_REQUIRES_CART_ID", "CART_REVISION_STALE", "CART_CUSTOMER_MISMATCH", "COUNTER_SALE_CREATE_ONLY", "SOLD_AT_CREATE_ONLY", "SOLD_AT_IN_FUTURE", "ORDER_TENDER_CREATE_ONLY", "CREDIT_OVERRIDE_CREATE_ONLY", "ON_ACCOUNT_CREATE_ONLY", "ON_ACCOUNT_WITH_TENDERS", "TENDERS_REQUIRE_COUNTER_SALE", "LINES_REQUIRE_COUNTER_SALE", "PRODUCT_COST_UNKNOWN", "PRICE_CHANGE_DISABLED", "LINE_DISCOUNT_EXCEEDS_MAX", "CUSTOMER_DISABLED", "SHIFT_NOT_AVAILABLE", "SOLD_AT_OUTSIDE_SHIFT", "ORDER_CURRENCY_NOT_SUBSCRIBED", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "PAYMENT_METHOD_UNAVAILABLE", "CART_PRICES_CHANGED", "PRODUCT_NOT_AVAILABLE", "ORDER_ID_COLLISION", "DELIVERY_METHOD_NOT_FOUND", "DELIVERY_FEE_CHANGED", "DELIVERY_FEE_CURRENCY_UNSUPPORTED", "GUEST_CONTACT_REQUIRED", "ORDER_BELOW_MINIMUM_PURCHASE", "ORDER_INVALID_CART", "CART_CHANGED_SINCE_CONFIRM", "EMAIL_VERIFICATION_REQUIRED", "ACCOUNT_DISABLED", "CUSTOMER_ACCESS_PENDING", "CUSTOMER_ACCESS_REJECTED", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "ORDER_DISCOUNT_AFTER_INVOICE", "ORDER_DISCOUNT_ON_SERVICE_ORDER", "ORDER_DISCOUNT_ON_MARKETPLACE_ORDER", "ORDER_INVOICE_METHOD_OUTSTANDING_FACTURA", "ORDER_SERVICE_PERIOD_AFTER_INVOICE", "ORDER_ATTEMPT_COMMITTED", "ORDER_ATTEMPT_ABANDONED", "ORDER_ATTEMPT_KEY_EXPIRED", "ORDER_ATTEMPT_KEY_SCOPE_MISMATCH", "ORDER_COMPLETION_ATTEMPT_COMMITTED", "ORDER_COMPLETION_ATTEMPT_ABANDONED"];
 export type OrderErrorCode = (typeof ORDER_ERROR_CODES)[number];
 export {};

package/dist/order.js

@@ -664,6 +664,9 @@ export const ORDER_ERROR_CODES = [
     // Storefront checkout: the cart re-priced since the shopper saw it (re-read and
     // confirm), and an allocated order id already taken (retry).
     'CART_PRICES_CHANGED',
+    // Storefront checkout: a cart line whose product the shopper's list no longer
+    // prices (or a channel-gated one); `unavailableProducts` names the product ids.
+    'PRODUCT_NOT_AVAILABLE',
     'ORDER_ID_COLLISION',
     'DELIVERY_METHOD_NOT_FOUND',
     // A priced delivery method (`Method.fee`): the freight moved since the shopper

package/dist/purchaseWithdrawal.d.ts

@@ -75,6 +75,20 @@ export declare const PURCHASE_WITHDRAWAL_WINDOW_SOURCE = "W2";
 export declare const PURCHASE_WITHDRAWAL_CODE_DUE_SOURCE = "W1";
 /** How long after a relayed request was received its code is due, in ms. */
 export declare const PURCHASE_WITHDRAWAL_CODE_DUE_MS: number;
+/**
+ * The `intent` a guest's `POST /orders/purchase-withdrawal/guest` names. Only
+ * the purchase withdrawal (*"Me arrepentí"*) today; the warranty intent joins
+ * this tuple with the warranty request.
+ */
+export declare const PURCHASE_WITHDRAWAL_GUEST_INTENTS: readonly ["purchase-withdrawal"];
+/**
+ * The one refusal of every guest code failure on `POST
+ * /orders/purchase-withdrawal/guest` (`401`): a wrong, expired, exhausted or
+ * already used code, a challenge that does not exist (another store's
+ * included), and an order that is no longer a guest order — one body, so the
+ * route is never an oracle for which one it was.
+ */
+export declare const PURCHASE_WITHDRAWAL_VERIFICATION_FAILED: "PURCHASE_WITHDRAWAL_VERIFICATION_FAILED";
 declare global {
     type PurchaseWithdrawalState = (typeof PURCHASE_WITHDRAWAL_STATES)[number];
     type PurchaseWithdrawalSource = (typeof PURCHASE_WITHDRAWAL_SOURCES)[number];
@@ -82,6 +96,7 @@ declare global {
     type PurchaseWithdrawalRelayChannel = (typeof PURCHASE_WITHDRAWAL_RELAY_CHANNELS)[number];
     type PurchaseWithdrawalActionMode = (typeof PURCHASE_WITHDRAWAL_ACTION_MODES)[number];
     type PurchaseWithdrawalIneligibleReason = (typeof PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS)[number];
+    type PurchaseWithdrawalGuestIntent = (typeof PURCHASE_WITHDRAWAL_GUEST_INTENTS)[number];
     /** One withdrawn order line, by its index in `Order.items`. */
     interface PurchaseWithdrawalLine {
         orderItemIndex: number;
@@ -239,6 +254,54 @@ declare global {
     interface PurchaseWithdrawalSubmitResponse {
         purchaseWithdrawal: OrderPurchaseWithdrawalView;
     }
+    /**
+     * `POST /orders/purchase-withdrawal/guest/start` (Web host, PUBLIC, bound
+     * origin). Strict body, ONE of two shapes, each naming the order only:
+     *
+     * - `{ token }` — the guest order status token (`gs1.…`). It grants nothing
+     *   by itself: the code still goes to the order's address.
+     * - `{ orderId, email }` — the order number and the address the order was
+     *   placed with.
+     *
+     * Always the same `202` ({@link PurchaseWithdrawalGuestStartResponse})
+     * whether or not anything matches; a match within budget mails a 6-digit
+     * code to the address on the order's LIVE guest customer row (never the one
+     * typed). Only a malformed body answers otherwise (`400`).
+     */
+    type PurchaseWithdrawalGuestStartRequest = {
+        token: string;
+    } | {
+        orderId: string;
+        email: string;
+    };
+    /** `data` of the `202` of the guest start: the handle step 2 names. Random, 128 bits, base64url. */
+    interface PurchaseWithdrawalGuestStartResponse {
+        challengeHandle: string;
+    }
+    /**
+     * `POST /orders/purchase-withdrawal/guest` (Web host, PUBLIC, bound origin).
+     * Strict body. `lines` as on {@link PurchaseWithdrawalSubmitRequest}. Every
+     * code failure is the one `401 PURCHASE_WITHDRAWAL_VERIFICATION_FAILED`;
+     * the fifth wrong code burns the challenge. A correct code is consumed by
+     * the request's own transaction, so it creates at most one record.
+     */
+    interface PurchaseWithdrawalGuestSubmitRequest {
+        /** The start's `challengeHandle`. */
+        challengeHandle: string;
+        /** The 6-digit code mailed to the order's address. */
+        code: string;
+        intent: PurchaseWithdrawalGuestIntent;
+        lines?: PurchaseWithdrawalLine[];
+    }
+    /**
+     * `data` of the `201` of the guest submit: the code on screen, and a guest
+     * order status token minted at the order's CURRENT fence generation (no
+     * earlier link dies) — the storefront opens `/pedido/{statusToken}` to follow
+     * the refund. Absent only when the token could not be minted.
+     */
+    interface PurchaseWithdrawalGuestSubmitResponse extends PurchaseWithdrawalSubmitResponse {
+        statusToken?: string;
+    }
     /** `data` of `409 PURCHASE_WITHDRAWAL_ALREADY_REQUESTED`: the undecided request's code. */
     interface PurchaseWithdrawalAlreadyRequestedData {
         withdrawalId: string;

package/dist/purchaseWithdrawal.js

@@ -97,3 +97,17 @@ export const PURCHASE_WITHDRAWAL_WINDOW_SOURCE = 'W2';
 export const PURCHASE_WITHDRAWAL_CODE_DUE_SOURCE = 'W1';
 /** How long after a relayed request was received its code is due, in ms. */
 export const PURCHASE_WITHDRAWAL_CODE_DUE_MS = 24 * 60 * 60 * 1000;
+/**
+ * The `intent` a guest's `POST /orders/purchase-withdrawal/guest` names. Only
+ * the purchase withdrawal (*"Me arrepentí"*) today; the warranty intent joins
+ * this tuple with the warranty request.
+ */
+export const PURCHASE_WITHDRAWAL_GUEST_INTENTS = ['purchase-withdrawal'];
+/**
+ * The one refusal of every guest code failure on `POST
+ * /orders/purchase-withdrawal/guest` (`401`): a wrong, expired, exhausted or
+ * already used code, a challenge that does not exist (another store's
+ * included), and an order that is no longer a guest order — one body, so the
+ * route is never an oracle for which one it was.
+ */
+export const PURCHASE_WITHDRAWAL_VERIFICATION_FAILED = 'PURCHASE_WITHDRAWAL_VERIFICATION_FAILED';

package/dist/socket.js

@@ -548,7 +548,8 @@ export const SOCKET_ACTIONS = [
      *
      * ⚠️ To the order's OWN customer only (`wsPostCustomer`), never a store-wide
      * customer broadcast. The operator frame for the same write is
-     * `purchaseWithdrawalChanged`.
+     * `purchaseWithdrawalChanged`; the order's own `orders` frame (the post-commit
+     * row, carrying or no longer carrying the dispatch lock) follows both.
      */
     'orderPurchaseWithdrawal',
     /**

package/package.json

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