platform-types 1.10.811 → 1.10.812

package/dist/cjs/product.js

@@ -7,10 +7,11 @@ 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; `price_asc` / `price_desc` are the caller's own price
- * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
+ * descending product id; `price_asc` / `price_desc` are the caller's own price;
+ * `name_asc` / `name_desc` are the product name under a Spanish collation (see
+ * `PublicProductDiscoverInput.sort`).
  */
-exports.DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
+exports.DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc', 'name_asc', 'name_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,11 @@ 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; `price_asc` / `price_desc` are the caller's own price
- * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
+ * descending product id; `price_asc` / `price_desc` are the caller's own price;
+ * `name_asc` / `name_desc` are the product name under a Spanish collation (see
+ * `PublicProductDiscoverInput.sort`).
  */
-export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_desc"];
+export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_desc", "name_asc", "name_desc"];
 export type DiscoverySort = (typeof DISCOVERY_SORTS)[number];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
@@ -298,8 +299,12 @@ declare global {
          * 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
+         * that unpriced tail are newest first. `name_asc` / `name_desc` = the
+         * shown product name, Spanish collation, case- and accent-insensitive,
+         * digits compared as numbers («HP 96» before «HP 904»); names that compare
+         * equal are newest first, and a row with no name comes LAST in both
+         * directions. A price or name 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
@@ -406,12 +411,12 @@ declare global {
     }
     /** Refusals of Web `GET /products?mode=discover`. */
     type DiscoveryErrorCode = 'INVALID_DISCOVERY_QUERY' | 'INVALID_CURSOR' | 'DISCOVERY_SORT_UNSUPPORTED'
-    /** 503: a price-sorted walk the time budget cut short; retry. */
+    /** 503: a price- or name-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.
+     * it does — every member for an unknown value, the sorts that need no whole-set read when a
+     * price or name sort's filtered set was too large to read whole.
      */
     interface DiscoverySortRefusal {
         message: string;

package/dist/product.js

@@ -4,10 +4,11 @@ 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; `price_asc` / `price_desc` are the caller's own price
- * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
+ * descending product id; `price_asc` / `price_desc` are the caller's own price;
+ * `name_asc` / `name_desc` are the product name under a Spanish collation (see
+ * `PublicProductDiscoverInput.sort`).
  */
-export const DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
+export const DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc', 'name_asc', 'name_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.811",
+	"version": "1.10.812",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",