platform-types 1.10.702 → 1.10.703

package/dist/basket.d.ts

@@ -63,9 +63,9 @@ declare global {
     }
 }
 /**
- * Domain refusals from POST /baskets: legacy replacement, named cart actions,
- * and park/resume. Check GATING_ERROR_CODES separately for middleware and role
- * refusals. GET /baskets and storefront-only refusals are outside this tuple.
+ * Domain refusals from POST /baskets (replacement, named actions and park/resume)
+ * and GET /baskets?mode=review. Check GATING_ERROR_CODES separately for middleware
+ * and role refusals. Other GET modes and storefront-only refusals remain separate.
  *
  * Coupon and promotion reasons are forwarded from evaluateCoupon and
  * evaluatePromotion (stacks/services/coupons.ts and promotions.ts). Checkout's
@@ -74,6 +74,6 @@ declare global {
  * priceHandler.resolveLineStamp. The legacy loose body also reaches the shared
  * foreign-index-key guard; its owned terminalId is validated before that guard.
  */
-export declare const BASKET_ERROR_CODES: readonly ["VALIDATION_FAILED", "FOREIGN_INDEX_KEY_ATTRIBUTE", "CART_TARGET_REQUIRED", "CART_NOT_FOUND", "CART_NOT_PARKED", "CART_ALREADY_PARKED", "TERMINAL_INDEX_UNAVAILABLE", "PRODUCT_NOT_FOUND", "PRODUCT_COST_UNKNOWN", "UNIT_QUANTITY_NOT_WHOLE", "BASKET_VERSION_CONFLICT", "BASKET_LINE_LIMIT", "BASKET_SIZE_LIMIT", "UNKNOWN_LINE", "INVALID_PRICE", "LINE_DISCOUNT_NOT_ALLOWED", "LINE_DISCOUNT_EXCEEDS_MAX", "FX_CONVERSION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_RATE_LIMITED", "COUPON_CURRENCY_MISMATCH", "PROMOTION_NOT_FOUND", "PROMOTION_NOT_ACTIVE", "PROMOTION_NOT_STARTED", "PROMOTION_EXPIRED", "PROMOTION_NOT_CART_APPLICABLE"];
+export declare const BASKET_ERROR_CODES: readonly ["VALIDATION_FAILED", "FOREIGN_INDEX_KEY_ATTRIBUTE", "CART_TARGET_REQUIRED", "CART_NOT_FOUND", "CART_REVIEW_INCOMPLETE", "CART_REVIEW_UNAVAILABLE", "CART_NOT_PARKED", "CART_ALREADY_PARKED", "TERMINAL_INDEX_UNAVAILABLE", "PRODUCT_NOT_FOUND", "PRODUCT_COST_UNKNOWN", "UNIT_QUANTITY_NOT_WHOLE", "BASKET_VERSION_CONFLICT", "BASKET_LINE_LIMIT", "BASKET_SIZE_LIMIT", "UNKNOWN_LINE", "INVALID_PRICE", "LINE_DISCOUNT_NOT_ALLOWED", "LINE_DISCOUNT_EXCEEDS_MAX", "FX_CONVERSION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_RATE_LIMITED", "COUPON_CURRENCY_MISMATCH", "PROMOTION_NOT_FOUND", "PROMOTION_NOT_ACTIVE", "PROMOTION_NOT_STARTED", "PROMOTION_EXPIRED", "PROMOTION_NOT_CART_APPLICABLE"];
 export type BasketErrorCode = (typeof BASKET_ERROR_CODES)[number];
 export {};

package/dist/basket.js

@@ -1,7 +1,7 @@
 /**
- * Domain refusals from POST /baskets: legacy replacement, named cart actions,
- * and park/resume. Check GATING_ERROR_CODES separately for middleware and role
- * refusals. GET /baskets and storefront-only refusals are outside this tuple.
+ * Domain refusals from POST /baskets (replacement, named actions and park/resume)
+ * and GET /baskets?mode=review. Check GATING_ERROR_CODES separately for middleware
+ * and role refusals. Other GET modes and storefront-only refusals remain separate.
  *
  * Coupon and promotion reasons are forwarded from evaluateCoupon and
  * evaluatePromotion (stacks/services/coupons.ts and promotions.ts). Checkout's
@@ -15,6 +15,8 @@ export const BASKET_ERROR_CODES = [
     'FOREIGN_INDEX_KEY_ATTRIBUTE',
     'CART_TARGET_REQUIRED',
     'CART_NOT_FOUND',
+    'CART_REVIEW_INCOMPLETE',
+    'CART_REVIEW_UNAVAILABLE',
     'CART_NOT_PARKED',
     'CART_ALREADY_PARKED',
     'TERMINAL_INDEX_UNAVAILABLE',

package/dist/cart.d.ts

@@ -1,4 +1,24 @@
 declare global {
+    interface OperatorCartReviewRequest {
+        mode: 'review';
+        customerId: string;
+        cartId?: string;
+    }
+    interface OperatorCartReviewCart extends Omit<Cart, 'customer'> {
+        customer?: Partial<Pick<Customer, 'customerId' | 'fullName'>>;
+    }
+    type OperatorCartReviewData = OperatorCartReviewCart | null;
+    /**
+     * Completed discovery returns null; an exact missing cart is a refusal.
+     * Discovery over several customer carts is never ambiguous: it returns the
+     * cart a customer-targeted write resolves (a terminal-less cart before a
+     * till's ticket, newest within each group, a new-partition row before a
+     * legacy one).
+     */
+    interface OperatorCartReviewResponse {
+        message: string;
+        data: OperatorCartReviewData;
+    }
     /**
      * A cart, keyed by its OWN minted id rather than by the customer.
      *

package/dist/cjs/basket.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASKET_ERROR_CODES = void 0;
 /**
- * Domain refusals from POST /baskets: legacy replacement, named cart actions,
- * and park/resume. Check GATING_ERROR_CODES separately for middleware and role
- * refusals. GET /baskets and storefront-only refusals are outside this tuple.
+ * Domain refusals from POST /baskets (replacement, named actions and park/resume)
+ * and GET /baskets?mode=review. Check GATING_ERROR_CODES separately for middleware
+ * and role refusals. Other GET modes and storefront-only refusals remain separate.
  *
  * Coupon and promotion reasons are forwarded from evaluateCoupon and
  * evaluatePromotion (stacks/services/coupons.ts and promotions.ts). Checkout's
@@ -18,6 +18,8 @@ exports.BASKET_ERROR_CODES = [
     'FOREIGN_INDEX_KEY_ATTRIBUTE',
     'CART_TARGET_REQUIRED',
     'CART_NOT_FOUND',
+    'CART_REVIEW_INCOMPLETE',
+    'CART_REVIEW_UNAVAILABLE',
     'CART_NOT_PARKED',
     'CART_ALREADY_PARKED',
     'TERMINAL_INDEX_UNAVAILABLE',

package/package.json

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