platform-types 1.10.808 → 1.10.809

package/dist/cjs/product.js

@@ -7,10 +7,10 @@ exports.BASE_QUANTITY_DECIMAL_PLACES = 6;
 exports.MAX_BASE_QUANTITY = 1_000_000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; name and price sorts are not served (no index can
- * order them inside one bounded request).
+ * descending product id; `price_asc` / `price_desc` are the caller's own price
+ * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
  */
-exports.DISCOVERY_SORTS = ['newest'];
+exports.DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
  * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`

package/dist/product.d.ts

@@ -4,10 +4,10 @@ export declare const BASE_QUANTITY_DECIMAL_PLACES = 6;
 export declare const MAX_BASE_QUANTITY = 1000000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; name and price sorts are not served (no index can
- * order them inside one bounded request).
+ * descending product id; `price_asc` / `price_desc` are the caller's own price
+ * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
  */
-export declare const DISCOVERY_SORTS: readonly ["newest"];
+export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_desc"];
 export type DiscoverySort = (typeof DISCOVERY_SORTS)[number];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
@@ -280,10 +280,22 @@ declare global {
         isNew?: 'true';
         /**
          * A member of `DISCOVERY_SORTS`. `newest` = descending product id (mint
-         * order), on every filter combination. A well-formed value the api does not
-         * serve is 400 `DISCOVERY_SORT_UNSUPPORTED` ({@link DiscoverySortRefusal});
-         * one not matching `^[a-z_]{1,32}$` is 400 `INVALID_DISCOVERY_QUERY`. An
-         * empty value is absent. Bound into the cursor when present.
+         * order), on every filter combination. `price_asc` / `price_desc` = the
+         * caller's own price, as each row is priced for them: in the store's display
+         * currency, an open offer counting as the price, no quantity break. Rows the
+         * caller is shown no price for (a hidden slot, every row for a guest of a
+         * store that hides prices) come LAST in both directions; equal prices and
+         * that unpriced tail are newest first. A price sort reads the whole filtered
+         * set on every page, so a set too large for one read is 400
+         * `DISCOVERY_SORT_UNSUPPORTED` after the reads, with `supportedSorts`
+         * naming what that query can be served in, and a read the time budget cut
+         * short is 503 `PRODUCT_LOOKUP_INCOMPLETE` (retryable). A price cursor is
+         * also bound to the caller's price list: resumed under another (a sign-in,
+         * a list change) it is 400 `INVALID_CURSOR`. A well-formed value the api does
+         * not serve is 400 `DISCOVERY_SORT_UNSUPPORTED` ({@link DiscoverySortRefusal})
+         * before any read; one not matching `^[a-z_]{1,32}$` is 400
+         * `INVALID_DISCOVERY_QUERY`. An empty value is absent. Bound into the cursor
+         * when present.
          */
         sort?: string;
         /** The previous response's `LastEvaluatedKey`, under the SAME filters and sort; else 400 INVALID_CURSOR. */
@@ -380,8 +392,14 @@ declare global {
         truncated?: true;
     }
     /** Refusals of Web `GET /products?mode=discover`. */
-    type DiscoveryErrorCode = 'INVALID_DISCOVERY_QUERY' | 'INVALID_CURSOR' | 'DISCOVERY_SORT_UNSUPPORTED';
-    /** 400 body for a well-formed `sort` the api does not serve; `supportedSorts` lists what it does. */
+    type DiscoveryErrorCode = 'INVALID_DISCOVERY_QUERY' | 'INVALID_CURSOR' | 'DISCOVERY_SORT_UNSUPPORTED'
+    /** 503: a price-sorted walk the time budget cut short; retry. */
+     | 'PRODUCT_LOOKUP_INCOMPLETE';
+    /**
+     * 400 body for a `sort` the api does not serve for this request; `supportedSorts` lists what
+     * it does — every member for an unknown value, the non-price sorts when a price sort's
+     * filtered set was too large to read whole.
+     */
     interface DiscoverySortRefusal {
         message: string;
         error: 'DISCOVERY_SORT_UNSUPPORTED';

package/dist/product.js

@@ -4,10 +4,10 @@ export const BASE_QUANTITY_DECIMAL_PLACES = 6;
 export const MAX_BASE_QUANTITY = 1_000_000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; name and price sorts are not served (no index can
- * order them inside one bounded request).
+ * descending product id; `price_asc` / `price_desc` are the caller's own price
+ * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
  */
-export const DISCOVERY_SORTS = ['newest'];
+export const DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
  * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`

package/package.json

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