platform-types 1.10.778 → 1.10.780

package/dist/cjs/order.js

@@ -109,7 +109,8 @@ const positiveUnits = (value) => (typeof value === 'number' && value > 0 ? value
  * The ONE reader of the per-line fulfilment ledger (`OrderLine.fulfilledQuantity`).
  *
  * - A missing `fulfilledQuantity` counts as 0; lines with no or zero `quantity`
- *   are ignored on both sides of the ratio.
+ *   are ignored on both sides of the ratio, and so is a freight line
+ *   (`lineKind: 'freight'` with no `productId`), which is never shipped.
  * - `deliveredAt > 0` with no `shipments` is `complete` — a whole-order delivery
  *   that never went through the shipment ledger.
  * - A `disabled` or cancelled row is `none`, whatever timestamps it carries: a
@@ -120,6 +121,12 @@ const orderFulfilmentProgress = (order) => {
     let orderedUnits = 0;
     let fulfilledUnits = 0;
     for (const line of order.items ?? []) {
+        // A freight line is a charge, never handed over, so it would hold a
+        // fully shipped order at `partial` forever. The same test as
+        // `isFreightLine` (`stacks/helpers/discountCalculations.ts`), inlined
+        // because contracts import nothing from `stacks/`.
+        if (line?.lineKind === 'freight' && line.productId === undefined)
+            continue;
         const ordered = positiveUnits(line?.quantity);
         if (ordered === 0)
             continue;
@@ -279,6 +286,9 @@ 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.
  * - `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
@@ -611,6 +621,8 @@ exports.ORDER_ERROR_CODES = [
     'CART_PROMOTION_UNAVAILABLE',
     // `mode: 'edit'` on an order holding a kit line; cancel or return it instead.
     'ORDER_HAS_KIT_LINES',
+    // `mode: 'edit'` on an order holding a freight line; cancel or return it instead.
+    'ORDER_HAS_FREIGHT_LINE',
     // Create-leg refusals about the sale's source, already answered on the wire.
     'ORDER_TARGET_REQUIRED',
     'ORDER_SOURCE_CONFLICT',

package/dist/cjs/storefrontWebLiteralKeys.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAdoptableStorefrontLiteral = exports.isAllowedStorefrontLiteralValue = exports.isStorefrontLiteralKey = exports.STOREFRONT_WEB_LITERAL_KEYS = void 0;
+exports.isAdoptableStorefrontLiteral = exports.isStorefrontLiteralKey = exports.STOREFRONT_WEB_LITERAL_KEYS = void 0;
 const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
 /**
  * Every storefront `WEB` literal key a shop may override, in code-unit order.
@@ -17,6 +17,9 @@ const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
  * - keys whose storefront value is not a plain `{name}`-token sentence (it
  *   branches, computes, or is not a string), which a shop string cannot
  *   express.
+ * Route paths (the former `NAVIGATE_*` keys) are not copy at all: they live in
+ * the storefront's own config, and the api refuses and drops a `NAVIGATE_*`
+ * literal on every storefront surface.
  * An editor that lists any of those offers an edit the server refuses.
  *
  * Interpolated values use `{name}` tokens named after the storefront's own
@@ -492,6 +495,8 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'DATA_RIGHTS_COLLECTION_NOTES',
     'DATA_RIGHTS_COLLECTION_ORDERS',
     'DATA_RIGHTS_COLLECTION_PAYMENTS',
+    'DATA_RIGHTS_COLLECTION_RECENT_PURCHASES',
+    'DATA_RIGHTS_COLLECTION_WHOLESALE_REQUESTS',
     'DATA_RIGHTS_DIALOG_ACK',
     'DATA_RIGHTS_DIALOG_CONFIRM',
     'DATA_RIGHTS_DIALOG_FISCAL',
@@ -815,27 +820,6 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MOBILE_BUTTONS_FAVORITES',
     'MOBILE_BUTTONS_INVOICES',
     'MOBILE_BUTTONS_ORDERS',
-    'NAVIGATE_APPOINTMENTS',
-    'NAVIGATE_BASKET',
-    'NAVIGATE_BRANDS',
-    'NAVIGATE_CATEGORIES',
-    'NAVIGATE_CHECKOUT',
-    'NAVIGATE_FAVORITES',
-    'NAVIGATE_HOME',
-    'NAVIGATE_INCOMES',
-    'NAVIGATE_INVOICES',
-    'NAVIGATE_LOGIN',
-    'NAVIGATE_LOGOUT',
-    'NAVIGATE_MAINTENANCE',
-    'NAVIGATE_NEW_ARRIVALS',
-    'NAVIGATE_NOTIFICATIONS',
-    'NAVIGATE_ORDERS',
-    'NAVIGATE_PAYMENTS',
-    'NAVIGATE_PROFILE',
-    'NAVIGATE_RECOVER',
-    'NAVIGATE_REGISTRATION',
-    'NAVIGATE_SALE',
-    'NAVIGATE_SESSIONS',
     'NETWORK_OFFLINE',
     'NETWORK_REQUEST_FAILED',
     'NETWORK_TIMEOUT',
@@ -1078,6 +1062,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PREVIEW_LOADING',
     'PREVIEW_READ_FAILED',
     'PREVIEW_READ_ONLY',
+    'PREVIEW_RECENTLY_BOUGHT',
     'PREVIEW_RESTART',
     'PREVIEW_RETRY',
     'PREVIEW_TITLE',
@@ -1346,6 +1331,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'STOREFRONT_FOOTER_NAV_ARIA',
     'STOREFRONT_MERCHANT_NAV_ARIA',
     'STOREFRONT_NAV_GROUP_FALLBACK',
+    'STOREFRONT_PRODUCTS_REFRESH_FAILED',
     'STOREFRONT_SEARCH',
     'STOREFRONT_SOCIAL_FACEBOOK',
     'STOREFRONT_SOCIAL_INSTAGRAM',
@@ -1374,34 +1360,13 @@ const STOREFRONT_WEB_LITERAL_KEY_SET = new Set(exports.STOREFRONT_WEB_LITERAL_KE
 /** Whether a shop may override `key` — membership in {@link STOREFRONT_WEB_LITERAL_KEYS}. */
 const isStorefrontLiteralKey = (key) => STOREFRONT_WEB_LITERAL_KEY_SET.has(key);
 exports.isStorefrontLiteralKey = isStorefrontLiteralKey;
-/** Keys whose value is a storefront route the storefront renders as a link target. */
-const STOREFRONT_NAVIGATE_LITERAL_PREFIX = 'NAVIGATE_';
-/**
- * A same-origin path: a leading `/`, a second character that is neither `/` nor `\`
- * (`//host` and `/\host` are protocol-relative to a browser), and no whitespace,
- * backslash, control character (`\p{Cc}`) or invisible format character (`\p{Cf}`: every
- * bidi mark including U+061C, zero-width characters, the soft hyphen, tag characters)
- * anywhere. Browsers strip tab and newline before parsing, so `/\t/host` becomes `//host`;
- * invisible and directional characters can also disguise the link target. A scheme
- * cannot start with `/`.
- */
-const STOREFRONT_SAME_ORIGIN_PATH_RE = /^\/(?![/\\])[^\s\\\p{Cc}\p{Cf}]*$/u;
-/**
- * Whether `value` may be stored, published or served for `key`. A `NAVIGATE_*` key is
- * rendered as a link, so it must be a same-origin path — otherwise an override could
- * send a shop's customers to an off-site look-alike login page. Every other key is
- * unconstrained here (key membership, well-formedness and length are checked apart).
- */
-const isAllowedStorefrontLiteralValue = (key, value) => !key.startsWith(STOREFRONT_NAVIGATE_LITERAL_PREFIX) || STOREFRONT_SAME_ORIGIN_PATH_RE.test(value);
-exports.isAllowedStorefrontLiteralValue = isAllowedStorefrontLiteralValue;
 /**
  * Whether a shop's stored `value` for `key` is one a save keeps, a read serves and the editor
- * baseline adopts: a shop-overridable key, a well-formed string within
- * {@link STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS} code points, and an allowed value for it.
+ * baseline adopts: a shop-overridable key and a well-formed string within
+ * {@link STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS} code points.
  */
 const isAdoptableStorefrontLiteral = (key, value) => (0, exports.isStorefrontLiteralKey)(key) &&
     typeof value === 'string' &&
     value.isWellFormed() &&
-    Array.from(value).length <= storefrontDesignRegistry_ts_1.STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS &&
-    (0, exports.isAllowedStorefrontLiteralValue)(key, value);
+    Array.from(value).length <= storefrontDesignRegistry_ts_1.STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS;
 exports.isAdoptableStorefrontLiteral = isAdoptableStorefrontLiteral;

package/dist/cjs/wholesaleRequest.js

@@ -11,7 +11,7 @@
  * `ecommerce.config.wholesaleRequests` is `true` (absent = off).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WHOLESALE_REQUEST_REASON_MAX = exports.WHOLESALE_REQUEST_PHONE_MAX = exports.WHOLESALE_REQUEST_MESSAGE_MAX = exports.WHOLESALE_REQUEST_ACTIVITY_MAX = exports.WHOLESALE_REQUEST_RAZON_SOCIAL_MAX = exports.WHOLESALE_REQUESTS_PAGE_MAX = exports.WHOLESALE_REQUEST_STATES = void 0;
+exports.WHOLESALE_REQUEST_ERROR_CODES = exports.WHOLESALE_REQUEST_REASON_MAX = exports.WHOLESALE_REQUEST_PHONE_MAX = exports.WHOLESALE_REQUEST_MESSAGE_MAX = exports.WHOLESALE_REQUEST_ACTIVITY_MAX = exports.WHOLESALE_REQUEST_RAZON_SOCIAL_MAX = exports.WHOLESALE_REQUESTS_PAGE_MAX = exports.WHOLESALE_REQUEST_STATES = void 0;
 /** The three states a request moves through. */
 exports.WHOLESALE_REQUEST_STATES = ['pending', 'approved', 'declined'];
 /** `GET /customers?mode=wholesale-requests` page ceiling; the default page is 50. */
@@ -23,3 +23,42 @@ exports.WHOLESALE_REQUEST_MESSAGE_MAX = 1000;
 exports.WHOLESALE_REQUEST_PHONE_MAX = 30;
 /** Character ceiling on the operator's decline reason, counted after trimming. */
 exports.WHOLESALE_REQUEST_REASON_MAX = 500;
+/**
+ * Every `error` code the wholesale-request flow answers on its own behalf:
+ * - web `POST /user { mode: 'wholesale-request' }` (`stacks/web/lambdas/user/_wholesaleRequest.ts`):
+ *   `WHOLESALE_REQUESTS_DISABLED`, `CUSTOMER_NOT_FOUND`, `CUSTOMER_ANONYMIZED`, `USER_NOT_ENABLED`,
+ *   `CUSTOMER_ALREADY_WHOLESALE`, `WHOLESALE_REQUEST_CONTENDED`, `WHOLESALE_REQUEST_PENDING`;
+ * - app `GET /customers?mode=wholesale-requests` and `POST /customers { mode: 'wholesale-decision' }`
+ *   (`stacks/lambdas/customers/_wholesaleRequests.ts`): `ROLE_FORBIDDEN`, `ADMIN_REQUIRED`,
+ *   `INVALID_CURSOR`, `WHOLESALE_REQUEST_NOT_PENDING`, `WHOLESALE_DECISION_CONTENDED`,
+ *   `CUSTOMER_NOT_FOUND`, `CUSTOMER_ANONYMIZED`, `CUSTOMER_MERGED`, `PRICE_LIST_NOT_FOUND`,
+ *   `PRICE_LIST_NOT_WHOLESALE`, `WHOLESALE_REQUEST_NOT_FOUND`;
+ * - the opt-in refusal both configuration writers answer when `ecommerce.config.wholesaleRequests`
+ *   turns on with no wholesale-class list: `WHOLESALE_LIST_REQUIRED` (`409`). It is also in
+ *   `STORE_PATCH_ERROR_CODES`, on purpose: a wholesale client handles it without reading that tuple.
+ *
+ * The rule: a code is listed when a wholesale handler writes it as its own literal, and each of
+ * those literals is typed `satisfies WholesaleRequestErrorCode`, so one this list misses fails
+ * typecheck. A code those routes forward from a shared helper is not listed, though a wholesale
+ * route can answer it: the customer-access refusals (`refuseCustomerAccess`), `VALIDATION_FAILED`
+ * (`validateRequest`), the handler wrapper's own codes and the authorizer's.
+ */
+exports.WHOLESALE_REQUEST_ERROR_CODES = [
+    'WHOLESALE_REQUESTS_DISABLED',
+    'CUSTOMER_NOT_FOUND',
+    'CUSTOMER_ANONYMIZED',
+    'USER_NOT_ENABLED',
+    'CUSTOMER_ALREADY_WHOLESALE',
+    'WHOLESALE_REQUEST_CONTENDED',
+    'WHOLESALE_REQUEST_PENDING',
+    'ROLE_FORBIDDEN',
+    'ADMIN_REQUIRED',
+    'INVALID_CURSOR',
+    'WHOLESALE_REQUEST_NOT_PENDING',
+    'WHOLESALE_DECISION_CONTENDED',
+    'CUSTOMER_MERGED',
+    'PRICE_LIST_NOT_FOUND',
+    'PRICE_LIST_NOT_WHOLESALE',
+    'WHOLESALE_REQUEST_NOT_FOUND',
+    'WHOLESALE_LIST_REQUIRED',
+];

package/dist/order.d.ts

@@ -250,6 +250,25 @@ declare global {
         productIds: string[];
     }
     interface OrderLine extends CartLine {
+        /**
+         * What kind of line this is. Absent means a goods (or service) line, which is
+         * every line written before freight existed: forward-only, never backfilled.
+         *
+         * `'freight'`: a server-owned, productless delivery charge. It carries no
+         * `productId` — a line naming one is goods whatever this says
+         * (`isFreightLine`); the order discount never applies to it, it moves no
+         * stock and writes no `SALE#` row, and it is never returnable or shippable.
+         * A return never credits it: the freight stays with the store.
+         *
+         * Fiscally the voucher reads the line's OWN stored `ivaType`, stamped from
+         * the store's `integrations.afip.freight` when the line is written, so a
+         * later config change never re-rates it. Only its Concepto is read live off
+         * that config, on a factura; a credit note restates its factura's.
+         *
+         * ⚠️ **Server-owned.** No order writer accepts it from a client;
+         * `stripServerOwnedLineFields` drops a caller-sent value.
+         */
+        lineKind?: 'freight';
         /** Base unit frozen from the product at sale; absent means unknown, never inferred on historical lines. */
         unit?: ProductUnit;
         /** Server-owned denomination of finite cost; absent means unknown. */
@@ -908,12 +927,17 @@ declare global {
          * deduction skips a service line rather than moving inventory a second
          * time.
          *
-         * `Order.discount` is a percentage and does NOT reach those lines — and
-         * must not, since the two units cannot be added and converting between
-         * them does not round-trip. The service order is the sole owner of its own
-         * total (its own `discount` is already spent in the lines above), so the
-         * figure invoiced is the figure the customer agreed to. The percentage
-         * still applies normally to any goods bought in the same visit.
+         * ⚠️ `Order.discount` DOES reach those lines. The ticket's own absolute
+         * `discount` is already spent in them, and `POST /orders` refuses an
+         * operator percentage on an order carrying this pointer; but a same-visit
+         * handover whose counter basket carries a discount stores
+         * `goodsDiscountPercent` (`_deliverOrder.ts`, `buildDeliveryOrderRow`): the
+         * basket's discount over the FULL gross, basket plus service lines. Every
+         * per-line site (`chargedLineTotal`, `buildInvoiceEconomics`) then cuts
+         * EVERY line by it, service lines included, so the order's total discount
+         * equals the basket's while being spread across the repair too. With no
+         * basket discount it is `0` and the service lines are billed exactly as
+         * minted. Only a freight line (`lineKind`) is ever exempt.
          */
         serviceOrderId?: string;
         /**
@@ -2542,7 +2566,8 @@ type OrderFulfilmentProgressInput = Pick<Partial<Order>, 'items' | 'shipments' |
  * The ONE reader of the per-line fulfilment ledger (`OrderLine.fulfilledQuantity`).
  *
  * - A missing `fulfilledQuantity` counts as 0; lines with no or zero `quantity`
- *   are ignored on both sides of the ratio.
+ *   are ignored on both sides of the ratio, and so is a freight line
+ *   (`lineKind: 'freight'` with no `productId`), which is never shipped.
  * - `deliveredAt > 0` with no `shipments` is `complete` — a whole-order delivery
  *   that never went through the shipment ledger.
  * - A `disabled` or cancelled row is `none`, whatever timestamps it carries: a
@@ -2692,6 +2717,9 @@ 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.
  * - `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
@@ -2942,6 +2970,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_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", "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", "ORDER_ID_COLLISION", "DELIVERY_METHOD_NOT_FOUND", "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

@@ -103,7 +103,8 @@ const positiveUnits = (value) => (typeof value === 'number' && value > 0 ? value
  * The ONE reader of the per-line fulfilment ledger (`OrderLine.fulfilledQuantity`).
  *
  * - A missing `fulfilledQuantity` counts as 0; lines with no or zero `quantity`
- *   are ignored on both sides of the ratio.
+ *   are ignored on both sides of the ratio, and so is a freight line
+ *   (`lineKind: 'freight'` with no `productId`), which is never shipped.
  * - `deliveredAt > 0` with no `shipments` is `complete` — a whole-order delivery
  *   that never went through the shipment ledger.
  * - A `disabled` or cancelled row is `none`, whatever timestamps it carries: a
@@ -114,6 +115,12 @@ export const orderFulfilmentProgress = (order) => {
     let orderedUnits = 0;
     let fulfilledUnits = 0;
     for (const line of order.items ?? []) {
+        // A freight line is a charge, never handed over, so it would hold a
+        // fully shipped order at `partial` forever. The same test as
+        // `isFreightLine` (`stacks/helpers/discountCalculations.ts`), inlined
+        // because contracts import nothing from `stacks/`.
+        if (line?.lineKind === 'freight' && line.productId === undefined)
+            continue;
         const ordered = positiveUnits(line?.quantity);
         if (ordered === 0)
             continue;
@@ -272,6 +279,9 @@ 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.
  * - `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
@@ -604,6 +614,8 @@ export const ORDER_ERROR_CODES = [
     'CART_PROMOTION_UNAVAILABLE',
     // `mode: 'edit'` on an order holding a kit line; cancel or return it instead.
     'ORDER_HAS_KIT_LINES',
+    // `mode: 'edit'` on an order holding a freight line; cancel or return it instead.
+    'ORDER_HAS_FREIGHT_LINE',
     // Create-leg refusals about the sale's source, already answered on the wire.
     'ORDER_TARGET_REQUIRED',
     'ORDER_SOURCE_CONFLICT',

package/dist/store.d.ts

@@ -1599,6 +1599,29 @@ declare global {
         /** ISO date; stops applying on or after. Omitted => open-ended. */
         expiresAt?: string;
     }
+    /**
+     * An AFIP Iva Id — one of `IVA_TYPES` (`services/fiscalCatalogs.ts`): 3 (0 %),
+     * 9 (2,5 %), 8 (5 %), 4 (10,5 %), 5 (21 %), 6 (27 %). `number`, like every
+     * `ivaType` in this contract, so a line's stored rate and a configured one
+     * compare without a cast; the catalog, not this type, is the authority.
+     * ⚠️ Not every write path validates against it: `PATCH /store` does
+     * (`afipPatchSchema`), but `POST /store` and `POST /tenants` take `afip`
+     * unvalidated, so a reader falls back on an out-of-catalog value
+     * (`resolveFreightFiscal`) rather than trusting the row.
+     */
+    type IvaTypeId = number;
+    /**
+     * How the store's freight line (`OrderLine.lineKind: 'freight'`) is declared
+     * to ARCA. Configuration the store's accountant decides, not a fact the code
+     * can derive: whether delivery is a separate service or an accessory of the
+     * sale, and at which rate, depends on how the store sells.
+     */
+    interface AfipFreightFiscal {
+        /** The alícuota stamped on the freight line, and so declared in `Iva[]`. */
+        ivaType: IvaTypeId;
+        /** Whether the freight line counts as goods or as a service for `Concepto`. */
+        concepto: 'goods' | 'services';
+    }
     interface Afip {
         production: boolean;
         address?: string;
@@ -1669,6 +1692,14 @@ declare global {
         fceEnabled?: boolean;
         wscdcEnabled?: boolean;
         fceReceivedCheckpoint?: number;
+        /**
+         * The freight line's IVA rate and Concepto. Absent means the platform
+         * default, `ivaType` 5 (21 %) and `concepto` `'goods'`
+         * (`DEFAULT_FREIGHT_FISCAL`); read it through `resolveFreightFiscal`, never
+         * directly. ADMIN-tier on `PATCH /store` (`PRIVILEGED_AFIP_FIELDS`); `null`
+         * clears it back to the default.
+         */
+        freight?: AfipFreightFiscal;
     }
     /**
      * Write shape for the `afip` key of `PATCH /store`'s body. The wire accepts an
@@ -1683,6 +1714,7 @@ declare global {
         iibbTransparency?: Afip['iibbTransparency'] | null;
         iibbJurisdictions?: IibbJurisdictionConfig[] | null;
         actividades?: number[] | null;
+        freight?: AfipFreightFiscal | null;
     }
     /**
      * Write shape for the `config` key of `PATCH /store`'s body. Two things the

package/dist/storefrontWebLiteralKeys.d.ts

@@ -13,6 +13,9 @@
  * - keys whose storefront value is not a plain `{name}`-token sentence (it
  *   branches, computes, or is not a string), which a shop string cannot
  *   express.
+ * Route paths (the former `NAVIGATE_*` keys) are not copy at all: they live in
+ * the storefront's own config, and the api refuses and drops a `NAVIGATE_*`
+ * literal on every storefront surface.
  * An editor that lists any of those offers an edit the server refuses.
  *
  * Interpolated values use `{name}` tokens named after the storefront's own
@@ -21,16 +24,9 @@
 export declare const STOREFRONT_WEB_LITERAL_KEYS: readonly string[];
 /** Whether a shop may override `key` — membership in {@link STOREFRONT_WEB_LITERAL_KEYS}. */
 export declare const isStorefrontLiteralKey: (key: string) => boolean;
-/**
- * Whether `value` may be stored, published or served for `key`. A `NAVIGATE_*` key is
- * rendered as a link, so it must be a same-origin path — otherwise an override could
- * send a shop's customers to an off-site look-alike login page. Every other key is
- * unconstrained here (key membership, well-formedness and length are checked apart).
- */
-export declare const isAllowedStorefrontLiteralValue: (key: string, value: string) => boolean;
 /**
  * Whether a shop's stored `value` for `key` is one a save keeps, a read serves and the editor
- * baseline adopts: a shop-overridable key, a well-formed string within
- * {@link STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS} code points, and an allowed value for it.
+ * baseline adopts: a shop-overridable key and a well-formed string within
+ * {@link STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS} code points.
  */
 export declare const isAdoptableStorefrontLiteral: (key: string, value: unknown) => value is string;

package/dist/storefrontWebLiteralKeys.js

@@ -14,6 +14,9 @@ import { STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS } from "./storefrontDesignReg
  * - keys whose storefront value is not a plain `{name}`-token sentence (it
  *   branches, computes, or is not a string), which a shop string cannot
  *   express.
+ * Route paths (the former `NAVIGATE_*` keys) are not copy at all: they live in
+ * the storefront's own config, and the api refuses and drops a `NAVIGATE_*`
+ * literal on every storefront surface.
  * An editor that lists any of those offers an edit the server refuses.
  *
  * Interpolated values use `{name}` tokens named after the storefront's own
@@ -489,6 +492,8 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'DATA_RIGHTS_COLLECTION_NOTES',
     'DATA_RIGHTS_COLLECTION_ORDERS',
     'DATA_RIGHTS_COLLECTION_PAYMENTS',
+    'DATA_RIGHTS_COLLECTION_RECENT_PURCHASES',
+    'DATA_RIGHTS_COLLECTION_WHOLESALE_REQUESTS',
     'DATA_RIGHTS_DIALOG_ACK',
     'DATA_RIGHTS_DIALOG_CONFIRM',
     'DATA_RIGHTS_DIALOG_FISCAL',
@@ -812,27 +817,6 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MOBILE_BUTTONS_FAVORITES',
     'MOBILE_BUTTONS_INVOICES',
     'MOBILE_BUTTONS_ORDERS',
-    'NAVIGATE_APPOINTMENTS',
-    'NAVIGATE_BASKET',
-    'NAVIGATE_BRANDS',
-    'NAVIGATE_CATEGORIES',
-    'NAVIGATE_CHECKOUT',
-    'NAVIGATE_FAVORITES',
-    'NAVIGATE_HOME',
-    'NAVIGATE_INCOMES',
-    'NAVIGATE_INVOICES',
-    'NAVIGATE_LOGIN',
-    'NAVIGATE_LOGOUT',
-    'NAVIGATE_MAINTENANCE',
-    'NAVIGATE_NEW_ARRIVALS',
-    'NAVIGATE_NOTIFICATIONS',
-    'NAVIGATE_ORDERS',
-    'NAVIGATE_PAYMENTS',
-    'NAVIGATE_PROFILE',
-    'NAVIGATE_RECOVER',
-    'NAVIGATE_REGISTRATION',
-    'NAVIGATE_SALE',
-    'NAVIGATE_SESSIONS',
     'NETWORK_OFFLINE',
     'NETWORK_REQUEST_FAILED',
     'NETWORK_TIMEOUT',
@@ -1075,6 +1059,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PREVIEW_LOADING',
     'PREVIEW_READ_FAILED',
     'PREVIEW_READ_ONLY',
+    'PREVIEW_RECENTLY_BOUGHT',
     'PREVIEW_RESTART',
     'PREVIEW_RETRY',
     'PREVIEW_TITLE',
@@ -1343,6 +1328,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'STOREFRONT_FOOTER_NAV_ARIA',
     'STOREFRONT_MERCHANT_NAV_ARIA',
     'STOREFRONT_NAV_GROUP_FALLBACK',
+    'STOREFRONT_PRODUCTS_REFRESH_FAILED',
     'STOREFRONT_SEARCH',
     'STOREFRONT_SOCIAL_FACEBOOK',
     'STOREFRONT_SOCIAL_INSTAGRAM',
@@ -1370,32 +1356,12 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
 const STOREFRONT_WEB_LITERAL_KEY_SET = new Set(STOREFRONT_WEB_LITERAL_KEYS);
 /** Whether a shop may override `key` — membership in {@link STOREFRONT_WEB_LITERAL_KEYS}. */
 export const isStorefrontLiteralKey = (key) => STOREFRONT_WEB_LITERAL_KEY_SET.has(key);
-/** Keys whose value is a storefront route the storefront renders as a link target. */
-const STOREFRONT_NAVIGATE_LITERAL_PREFIX = 'NAVIGATE_';
-/**
- * A same-origin path: a leading `/`, a second character that is neither `/` nor `\`
- * (`//host` and `/\host` are protocol-relative to a browser), and no whitespace,
- * backslash, control character (`\p{Cc}`) or invisible format character (`\p{Cf}`: every
- * bidi mark including U+061C, zero-width characters, the soft hyphen, tag characters)
- * anywhere. Browsers strip tab and newline before parsing, so `/\t/host` becomes `//host`;
- * invisible and directional characters can also disguise the link target. A scheme
- * cannot start with `/`.
- */
-const STOREFRONT_SAME_ORIGIN_PATH_RE = /^\/(?![/\\])[^\s\\\p{Cc}\p{Cf}]*$/u;
-/**
- * Whether `value` may be stored, published or served for `key`. A `NAVIGATE_*` key is
- * rendered as a link, so it must be a same-origin path — otherwise an override could
- * send a shop's customers to an off-site look-alike login page. Every other key is
- * unconstrained here (key membership, well-formedness and length are checked apart).
- */
-export const isAllowedStorefrontLiteralValue = (key, value) => !key.startsWith(STOREFRONT_NAVIGATE_LITERAL_PREFIX) || STOREFRONT_SAME_ORIGIN_PATH_RE.test(value);
 /**
  * Whether a shop's stored `value` for `key` is one a save keeps, a read serves and the editor
- * baseline adopts: a shop-overridable key, a well-formed string within
- * {@link STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS} code points, and an allowed value for it.
+ * baseline adopts: a shop-overridable key and a well-formed string within
+ * {@link STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS} code points.
  */
 export const isAdoptableStorefrontLiteral = (key, value) => isStorefrontLiteralKey(key) &&
     typeof value === 'string' &&
     value.isWellFormed() &&
-    Array.from(value).length <= STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS &&
-    isAllowedStorefrontLiteralValue(key, value);
+    Array.from(value).length <= STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS;

package/dist/wholesaleRequest.d.ts

@@ -20,6 +20,28 @@ export declare const WHOLESALE_REQUEST_MESSAGE_MAX = 1000;
 export declare const WHOLESALE_REQUEST_PHONE_MAX = 30;
 /** Character ceiling on the operator's decline reason, counted after trimming. */
 export declare const WHOLESALE_REQUEST_REASON_MAX = 500;
+/**
+ * Every `error` code the wholesale-request flow answers on its own behalf:
+ * - web `POST /user { mode: 'wholesale-request' }` (`stacks/web/lambdas/user/_wholesaleRequest.ts`):
+ *   `WHOLESALE_REQUESTS_DISABLED`, `CUSTOMER_NOT_FOUND`, `CUSTOMER_ANONYMIZED`, `USER_NOT_ENABLED`,
+ *   `CUSTOMER_ALREADY_WHOLESALE`, `WHOLESALE_REQUEST_CONTENDED`, `WHOLESALE_REQUEST_PENDING`;
+ * - app `GET /customers?mode=wholesale-requests` and `POST /customers { mode: 'wholesale-decision' }`
+ *   (`stacks/lambdas/customers/_wholesaleRequests.ts`): `ROLE_FORBIDDEN`, `ADMIN_REQUIRED`,
+ *   `INVALID_CURSOR`, `WHOLESALE_REQUEST_NOT_PENDING`, `WHOLESALE_DECISION_CONTENDED`,
+ *   `CUSTOMER_NOT_FOUND`, `CUSTOMER_ANONYMIZED`, `CUSTOMER_MERGED`, `PRICE_LIST_NOT_FOUND`,
+ *   `PRICE_LIST_NOT_WHOLESALE`, `WHOLESALE_REQUEST_NOT_FOUND`;
+ * - the opt-in refusal both configuration writers answer when `ecommerce.config.wholesaleRequests`
+ *   turns on with no wholesale-class list: `WHOLESALE_LIST_REQUIRED` (`409`). It is also in
+ *   `STORE_PATCH_ERROR_CODES`, on purpose: a wholesale client handles it without reading that tuple.
+ *
+ * The rule: a code is listed when a wholesale handler writes it as its own literal, and each of
+ * those literals is typed `satisfies WholesaleRequestErrorCode`, so one this list misses fails
+ * typecheck. A code those routes forward from a shared helper is not listed, though a wholesale
+ * route can answer it: the customer-access refusals (`refuseCustomerAccess`), `VALIDATION_FAILED`
+ * (`validateRequest`), the handler wrapper's own codes and the authorizer's.
+ */
+export declare const WHOLESALE_REQUEST_ERROR_CODES: readonly ["WHOLESALE_REQUESTS_DISABLED", "CUSTOMER_NOT_FOUND", "CUSTOMER_ANONYMIZED", "USER_NOT_ENABLED", "CUSTOMER_ALREADY_WHOLESALE", "WHOLESALE_REQUEST_CONTENDED", "WHOLESALE_REQUEST_PENDING", "ROLE_FORBIDDEN", "ADMIN_REQUIRED", "INVALID_CURSOR", "WHOLESALE_REQUEST_NOT_PENDING", "WHOLESALE_DECISION_CONTENDED", "CUSTOMER_MERGED", "PRICE_LIST_NOT_FOUND", "PRICE_LIST_NOT_WHOLESALE", "WHOLESALE_REQUEST_NOT_FOUND", "WHOLESALE_LIST_REQUIRED"];
+export type WholesaleRequestErrorCode = (typeof WHOLESALE_REQUEST_ERROR_CODES)[number];
 declare global {
     type WholesaleRequestState = (typeof WHOLESALE_REQUEST_STATES)[number];
     /**

package/dist/wholesaleRequest.js

@@ -20,3 +20,42 @@ export const WHOLESALE_REQUEST_MESSAGE_MAX = 1000;
 export const WHOLESALE_REQUEST_PHONE_MAX = 30;
 /** Character ceiling on the operator's decline reason, counted after trimming. */
 export const WHOLESALE_REQUEST_REASON_MAX = 500;
+/**
+ * Every `error` code the wholesale-request flow answers on its own behalf:
+ * - web `POST /user { mode: 'wholesale-request' }` (`stacks/web/lambdas/user/_wholesaleRequest.ts`):
+ *   `WHOLESALE_REQUESTS_DISABLED`, `CUSTOMER_NOT_FOUND`, `CUSTOMER_ANONYMIZED`, `USER_NOT_ENABLED`,
+ *   `CUSTOMER_ALREADY_WHOLESALE`, `WHOLESALE_REQUEST_CONTENDED`, `WHOLESALE_REQUEST_PENDING`;
+ * - app `GET /customers?mode=wholesale-requests` and `POST /customers { mode: 'wholesale-decision' }`
+ *   (`stacks/lambdas/customers/_wholesaleRequests.ts`): `ROLE_FORBIDDEN`, `ADMIN_REQUIRED`,
+ *   `INVALID_CURSOR`, `WHOLESALE_REQUEST_NOT_PENDING`, `WHOLESALE_DECISION_CONTENDED`,
+ *   `CUSTOMER_NOT_FOUND`, `CUSTOMER_ANONYMIZED`, `CUSTOMER_MERGED`, `PRICE_LIST_NOT_FOUND`,
+ *   `PRICE_LIST_NOT_WHOLESALE`, `WHOLESALE_REQUEST_NOT_FOUND`;
+ * - the opt-in refusal both configuration writers answer when `ecommerce.config.wholesaleRequests`
+ *   turns on with no wholesale-class list: `WHOLESALE_LIST_REQUIRED` (`409`). It is also in
+ *   `STORE_PATCH_ERROR_CODES`, on purpose: a wholesale client handles it without reading that tuple.
+ *
+ * The rule: a code is listed when a wholesale handler writes it as its own literal, and each of
+ * those literals is typed `satisfies WholesaleRequestErrorCode`, so one this list misses fails
+ * typecheck. A code those routes forward from a shared helper is not listed, though a wholesale
+ * route can answer it: the customer-access refusals (`refuseCustomerAccess`), `VALIDATION_FAILED`
+ * (`validateRequest`), the handler wrapper's own codes and the authorizer's.
+ */
+export const WHOLESALE_REQUEST_ERROR_CODES = [
+    'WHOLESALE_REQUESTS_DISABLED',
+    'CUSTOMER_NOT_FOUND',
+    'CUSTOMER_ANONYMIZED',
+    'USER_NOT_ENABLED',
+    'CUSTOMER_ALREADY_WHOLESALE',
+    'WHOLESALE_REQUEST_CONTENDED',
+    'WHOLESALE_REQUEST_PENDING',
+    'ROLE_FORBIDDEN',
+    'ADMIN_REQUIRED',
+    'INVALID_CURSOR',
+    'WHOLESALE_REQUEST_NOT_PENDING',
+    'WHOLESALE_DECISION_CONTENDED',
+    'CUSTOMER_MERGED',
+    'PRICE_LIST_NOT_FOUND',
+    'PRICE_LIST_NOT_WHOLESALE',
+    'WHOLESALE_REQUEST_NOT_FOUND',
+    'WHOLESALE_LIST_REQUIRED',
+];

package/package.json

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