platform-types 1.10.790 → 1.10.792

package/dist/cjs/guestAttach.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Attach guest orders to an account — `POST /user { mode: 'attach-guest-orders' }`
+ * on the Web host. A signed-in shopper whose account email is VERIFIED names the
+ * guest orders they placed with that same email; each matched guest row is
+ * folded into their account by the customer merge, so the orders appear in the
+ * account's `GET /orders` and the orders' old guest status links stop working.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GUEST_ATTACH_ERROR_CODES = void 0;
+/**
+ * The refusals the attach answers itself.
+ *
+ * - GUEST_ATTACH_EMAIL_UNVERIFIED (403): the caller's account email is not
+ *   verified (`Customer.emailVerified !== true`). Verify it through
+ *   `POST /auth { mode: 'send-otp' | 'verify-otp' }` and retry. Nothing else is
+ *   read.
+ * - GUEST_ATTACH_NOT_MATCHED (404): at least one named order is missing, is not
+ *   a guest order, was placed with another email, or was already attached to
+ *   another account; or its guest row also holds another customer folded into
+ *   it, or staff cancelled its merge into this account (or the caller's own
+ *   account was merged away or erased). One identical body whatever the
+ *   reason, and this request attaches nothing — not even the orders that did
+ *   match. Found before anything is written, it writes nothing; answered after
+ *   a merge refusal or an operator cancel raced the request, it may follow the
+ *   bump of that order's guest status fence (its old link already answers 401).
+ * - GUEST_ATTACH_ALREADY_DONE (409): every named order is already attached to
+ *   the caller's account. Nothing is written.
+ *
+ * The account refusals, shared with other storefront routes (the same codes and
+ * statuses as `WholesaleRequestErrorCode`), answered off the one caller read
+ * before anything else is read:
+ *
+ * - USER_NOT_ENABLED (403): the shop disabled the account.
+ * - CUSTOMER_ACCESS_PENDING (403): the shop has not approved the account yet.
+ * - CUSTOMER_ACCESS_REJECTED (403): the shop rejected the account.
+ */
+exports.GUEST_ATTACH_ERROR_CODES = [
+    'GUEST_ATTACH_EMAIL_UNVERIFIED',
+    'GUEST_ATTACH_NOT_MATCHED',
+    'GUEST_ATTACH_ALREADY_DONE',
+    'USER_NOT_ENABLED',
+    'CUSTOMER_ACCESS_PENDING',
+    'CUSTOMER_ACCESS_REJECTED',
+];

package/dist/cjs/index.js

@@ -54,6 +54,7 @@ __exportStar(require("./delivery.js"), exports);
 __exportStar(require("./favorite.js"), exports);
 __exportStar(require("./fiscalConditions.js"), exports);
 __exportStar(require("./gating.js"), exports);
+__exportStar(require("./guestAttach.js"), exports);
 __exportStar(require("./guestOrderStatus.js"), exports);
 __exportStar(require("./holdingCost.js"), exports);
 __exportStar(require("./demo.js"), exports);

package/dist/cjs/invoice.js

@@ -113,6 +113,9 @@ exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
  * `POST /invoices` `{mode:'email'}` answers both before anything is enqueued, and
  * `POST /mercadolibre/events` `{mode:'reuploadFiscalDocument'}` answers both for
  * the factura it chose.
+ * The web (storefront) invoice PDF answers `INVOICE_NOT_FOUND` too: one uniform
+ * 404 for an invoice that is absent or not the caller's, where the caller's
+ * own invoices include those owned by an id folded (merged) into their account.
  *
  * - `INVOICE_NOT_FOUND` · 404 — no invoice row has this id in the caller's
  *   store. Answered before any store read, render, print stamp, broadcast,

package/dist/cjs/order.js

@@ -286,9 +286,11 @@ exports.orderFulfilmentProgress = orderFulfilmentProgress;
  *   is refused after it, like every other refusal at commit.
  * - `ORDER_HAS_KIT_LINES` · 409 — `mode: 'edit'` on an order holding a kit line
  *   (`CartLine.kit`). Cancel or return the order instead. Nothing was written.
- * - `ORDER_HAS_FREIGHT_LINE` · 409 — `mode: 'edit'` on an order holding a
- *   freight line (`OrderLine.lineKind: 'freight'`). Cancel or return the order
- *   instead. Nothing was written.
+ * - `ORDER_HAS_FREIGHT_LINE` · 409 — on an order holding a freight line
+ *   (`OrderLine.lineKind: 'freight'`): `mode: 'edit'`, and a `POST /orders`
+ *   update that CHANGES `deliveryMethod` (the freight was charged for the stored
+ *   method, and is never re-priced; re-sending the stored method is not refused).
+ *   Cancel or return the order instead. Nothing was written.
  * - `CART_PROMOTION_UNAVAILABLE` · 409 — the insert leg converting a STORED
  *   ticket whose promotion ended, was paused, deleted, has not started or is
  *   no longer cart-applicable; the `PromotionRefusal` rides `data.reason`. No

package/dist/customerAddress.d.ts

@@ -117,7 +117,10 @@ declare global {
      *   address changed under every bounded retry; retry is safe. ALSO answered
      *   by `POST /customers` and the storefront `POST /user` when an edit of
      *   the address loses to a rival that moved the default or its copy — those
-     *   refuse on the FIRST failure, with no retry of their own.
+     *   refuse on the FIRST failure, with no retry of their own. The storefront
+     *   `POST /user` also answers it for ANY profile edit whose stored `email`
+     *   changed after its read (another session moved it); nothing was written
+     *   and the same edit, re-sent, is safe.
      *
      * Those two legacy writers' other row-state refusals are not in this union:
      * `409 CUSTOMER_ANONYMIZED` (see `Customer.anonymizedAt`) and `409

package/dist/guestAttach.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Attach guest orders to an account — `POST /user { mode: 'attach-guest-orders' }`
+ * on the Web host. A signed-in shopper whose account email is VERIFIED names the
+ * guest orders they placed with that same email; each matched guest row is
+ * folded into their account by the customer merge, so the orders appear in the
+ * account's `GET /orders` and the orders' old guest status links stop working.
+ */
+/**
+ * The refusals the attach answers itself.
+ *
+ * - GUEST_ATTACH_EMAIL_UNVERIFIED (403): the caller's account email is not
+ *   verified (`Customer.emailVerified !== true`). Verify it through
+ *   `POST /auth { mode: 'send-otp' | 'verify-otp' }` and retry. Nothing else is
+ *   read.
+ * - GUEST_ATTACH_NOT_MATCHED (404): at least one named order is missing, is not
+ *   a guest order, was placed with another email, or was already attached to
+ *   another account; or its guest row also holds another customer folded into
+ *   it, or staff cancelled its merge into this account (or the caller's own
+ *   account was merged away or erased). One identical body whatever the
+ *   reason, and this request attaches nothing — not even the orders that did
+ *   match. Found before anything is written, it writes nothing; answered after
+ *   a merge refusal or an operator cancel raced the request, it may follow the
+ *   bump of that order's guest status fence (its old link already answers 401).
+ * - GUEST_ATTACH_ALREADY_DONE (409): every named order is already attached to
+ *   the caller's account. Nothing is written.
+ *
+ * The account refusals, shared with other storefront routes (the same codes and
+ * statuses as `WholesaleRequestErrorCode`), answered off the one caller read
+ * before anything else is read:
+ *
+ * - USER_NOT_ENABLED (403): the shop disabled the account.
+ * - CUSTOMER_ACCESS_PENDING (403): the shop has not approved the account yet.
+ * - CUSTOMER_ACCESS_REJECTED (403): the shop rejected the account.
+ */
+export declare const GUEST_ATTACH_ERROR_CODES: readonly ["GUEST_ATTACH_EMAIL_UNVERIFIED", "GUEST_ATTACH_NOT_MATCHED", "GUEST_ATTACH_ALREADY_DONE", "USER_NOT_ENABLED", "CUSTOMER_ACCESS_PENDING", "CUSTOMER_ACCESS_REJECTED"];
+export type GuestAttachErrorCode = (typeof GUEST_ATTACH_ERROR_CODES)[number];
+declare global {
+    /**
+     * `POST /user` body. `orderIds`: 1–20 distinct ids (`^ORD\d{6,10}$`). Strict:
+     * an undeclared key is a 400. The account is always the token's own.
+     */
+    interface GuestAttachRequest {
+        mode: 'attach-guest-orders';
+        orderIds: string[];
+    }
+    /**
+     * `data` of a `200`. The named orders that are attached to the caller's
+     * account once this request ends — those this request attached and those an
+     * earlier request already had.
+     *
+     * ⚠️ It may be a SUBSET of the request: an attach is resumable, and a run that
+     * runs out of time leaves the rest unattached. Re-issue the SAME request to
+     * finish it; a request whose orders are all attached answers
+     * `409 GUEST_ATTACH_ALREADY_DONE`.
+     */
+    interface GuestAttachResponse {
+        attachedOrderIds: string[];
+    }
+}

package/dist/guestAttach.js

@@ -0,0 +1,42 @@
+/**
+ * Attach guest orders to an account — `POST /user { mode: 'attach-guest-orders' }`
+ * on the Web host. A signed-in shopper whose account email is VERIFIED names the
+ * guest orders they placed with that same email; each matched guest row is
+ * folded into their account by the customer merge, so the orders appear in the
+ * account's `GET /orders` and the orders' old guest status links stop working.
+ */
+/**
+ * The refusals the attach answers itself.
+ *
+ * - GUEST_ATTACH_EMAIL_UNVERIFIED (403): the caller's account email is not
+ *   verified (`Customer.emailVerified !== true`). Verify it through
+ *   `POST /auth { mode: 'send-otp' | 'verify-otp' }` and retry. Nothing else is
+ *   read.
+ * - GUEST_ATTACH_NOT_MATCHED (404): at least one named order is missing, is not
+ *   a guest order, was placed with another email, or was already attached to
+ *   another account; or its guest row also holds another customer folded into
+ *   it, or staff cancelled its merge into this account (or the caller's own
+ *   account was merged away or erased). One identical body whatever the
+ *   reason, and this request attaches nothing — not even the orders that did
+ *   match. Found before anything is written, it writes nothing; answered after
+ *   a merge refusal or an operator cancel raced the request, it may follow the
+ *   bump of that order's guest status fence (its old link already answers 401).
+ * - GUEST_ATTACH_ALREADY_DONE (409): every named order is already attached to
+ *   the caller's account. Nothing is written.
+ *
+ * The account refusals, shared with other storefront routes (the same codes and
+ * statuses as `WholesaleRequestErrorCode`), answered off the one caller read
+ * before anything else is read:
+ *
+ * - USER_NOT_ENABLED (403): the shop disabled the account.
+ * - CUSTOMER_ACCESS_PENDING (403): the shop has not approved the account yet.
+ * - CUSTOMER_ACCESS_REJECTED (403): the shop rejected the account.
+ */
+export const GUEST_ATTACH_ERROR_CODES = [
+    'GUEST_ATTACH_EMAIL_UNVERIFIED',
+    'GUEST_ATTACH_NOT_MATCHED',
+    'GUEST_ATTACH_ALREADY_DONE',
+    'USER_NOT_ENABLED',
+    'CUSTOMER_ACCESS_PENDING',
+    'CUSTOMER_ACCESS_REJECTED',
+];

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export * from './delivery.ts';
 export * from './favorite.ts';
 export * from './fiscalConditions.ts';
 export * from './gating.ts';
+export * from './guestAttach.ts';
 export * from './guestOrderStatus.ts';
 export * from './holdingCost.ts';
 export * from './demo.ts';

package/dist/index.js

@@ -38,6 +38,7 @@ export * from "./delivery.js";
 export * from "./favorite.js";
 export * from "./fiscalConditions.js";
 export * from "./gating.js";
+export * from "./guestAttach.js";
 export * from "./guestOrderStatus.js";
 export * from "./holdingCost.js";
 export * from "./demo.js";

package/dist/invoice.d.ts

@@ -1070,6 +1070,9 @@ export declare const INVOICE_ISSUANCE_REFUSAL_RECOVERY: {
  * `POST /invoices` `{mode:'email'}` answers both before anything is enqueued, and
  * `POST /mercadolibre/events` `{mode:'reuploadFiscalDocument'}` answers both for
  * the factura it chose.
+ * The web (storefront) invoice PDF answers `INVOICE_NOT_FOUND` too: one uniform
+ * 404 for an invoice that is absent or not the caller's, where the caller's
+ * own invoices include those owned by an id folded (merged) into their account.
  *
  * - `INVOICE_NOT_FOUND` · 404 — no invoice row has this id in the caller's
  *   store. Answered before any store read, render, print stamp, broadcast,

package/dist/invoice.js

@@ -110,6 +110,9 @@ export const INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
  * `POST /invoices` `{mode:'email'}` answers both before anything is enqueued, and
  * `POST /mercadolibre/events` `{mode:'reuploadFiscalDocument'}` answers both for
  * the factura it chose.
+ * The web (storefront) invoice PDF answers `INVOICE_NOT_FOUND` too: one uniform
+ * 404 for an invoice that is absent or not the caller's, where the caller's
+ * own invoices include those owned by an id folded (merged) into their account.
  *
  * - `INVOICE_NOT_FOUND` · 404 — no invoice row has this id in the caller's
  *   store. Answered before any store read, render, print stamp, broadcast,

package/dist/order.d.ts

@@ -2773,9 +2773,11 @@ export declare const orderFulfilmentProgress: (order: OrderFulfilmentProgressInp
  *   is refused after it, like every other refusal at commit.
  * - `ORDER_HAS_KIT_LINES` · 409 — `mode: 'edit'` on an order holding a kit line
  *   (`CartLine.kit`). Cancel or return the order instead. Nothing was written.
- * - `ORDER_HAS_FREIGHT_LINE` · 409 — `mode: 'edit'` on an order holding a
- *   freight line (`OrderLine.lineKind: 'freight'`). Cancel or return the order
- *   instead. Nothing was written.
+ * - `ORDER_HAS_FREIGHT_LINE` · 409 — on an order holding a freight line
+ *   (`OrderLine.lineKind: 'freight'`): `mode: 'edit'`, and a `POST /orders`
+ *   update that CHANGES `deliveryMethod` (the freight was charged for the stored
+ *   method, and is never re-priced; re-sending the stored method is not refused).
+ *   Cancel or return the order instead. Nothing was written.
  * - `CART_PROMOTION_UNAVAILABLE` · 409 — the insert leg converting a STORED
  *   ticket whose promotion ended, was paused, deleted, has not started or is
  *   no longer cart-applicable; the `PromotionRefusal` rides `data.reason`. No

package/dist/order.js

@@ -279,9 +279,11 @@ export const orderFulfilmentProgress = (order) => {
  *   is refused after it, like every other refusal at commit.
  * - `ORDER_HAS_KIT_LINES` · 409 — `mode: 'edit'` on an order holding a kit line
  *   (`CartLine.kit`). Cancel or return the order instead. Nothing was written.
- * - `ORDER_HAS_FREIGHT_LINE` · 409 — `mode: 'edit'` on an order holding a
- *   freight line (`OrderLine.lineKind: 'freight'`). Cancel or return the order
- *   instead. Nothing was written.
+ * - `ORDER_HAS_FREIGHT_LINE` · 409 — on an order holding a freight line
+ *   (`OrderLine.lineKind: 'freight'`): `mode: 'edit'`, and a `POST /orders`
+ *   update that CHANGES `deliveryMethod` (the freight was charged for the stored
+ *   method, and is never re-priced; re-sending the stored method is not refused).
+ *   Cancel or return the order instead. Nothing was written.
  * - `CART_PROMOTION_UNAVAILABLE` · 409 — the insert leg converting a STORED
  *   ticket whose promotion ended, was paused, deleted, has not started or is
  *   no longer cart-applicable; the `PromotionRefusal` rides `data.reason`. No

package/package.json

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