platform-types 1.10.813 → 1.10.815

package/dist/cjs/product.js

@@ -14,8 +14,10 @@ exports.MAX_BASE_QUANTITY = 1_000_000;
 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`
- * (the filter matches no descendants, so a rolled-up parent would select nothing).
+ * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`.
+ * The `categoryId` filter selects a category's enabled descendants too, so a filter on a
+ * parent yields counts for several descendant ids; a product has one primary category,
+ * so a client sums exact counts over a subtree without counting a product twice.
  */
 exports.DISCOVERY_FACETS = ['brand', 'tag', 'category'];
 /** Most products the store's best-seller ranking holds, and web `mode=best-sellers` returns. */

package/dist/cjs/storefrontDesignRegistry.js

@@ -156,12 +156,21 @@ exports.STOREFRONT_DESIGN_REGISTRY = {
          *
          * Responsable Inscripto only (`integrations.afip.condFiscal === 30`). Both
          * writers refuse `true` on any other store with 409 NET_PLUS_IVA_REQUIRES_RI;
-         * `false` and `null` always pass. Storefront exits (web `GET /store`, the
-         * preview's store frame, the customer `stores` frame) send the EFFECTIVE value,
-         * stored flag AND RI; app reads (`GET /store`, the operator `/tenants` read)
-         * send the STORED one beside `integrations.afip.condFiscal`.
+         * `false` and `null` always pass. App reads (`GET /store`, the operator
+         * `/tenants` read) send the STORED value beside `integrations.afip.condFiscal`.
+         *
+         * Wholesale customers only. Storefront exits send the EFFECTIVE value per
+         * viewer: stored flag AND RI AND an approved customer whose effective price
+         * list is `audienceClass: 'wholesale'`. A guest, a pending registrant and a
+         * retail customer read `false`.
+         * - Web `GET /store` judges its resolved caller. A customer's answer is
+         *   `private, no-store`, and every answer varies on `Authorization`.
+         * - The preview's store frame judges the grant fixture's simulated caller.
+         *   A grant without a fixture is judged as a guest.
+         * - The customer `stores` frame reaches every shopper at once, so it always
+         *   sends `false`. The storefront re-reads web `GET /store` on that frame.
          */
-        showNetPlusIva: liveToggle('showNetPlusIva', 'STOREFRONT_SHOW_NET_PLUS_IVA_LABEL', 'STOREFRONT_SHOW_NET_PLUS_IVA_HELP', 'Mostrar precio neto + IVA', 'Mostrar también el precio sin IVA, con la leyenda «+ IVA», junto al precio final. Nunca reemplaza al precio final.', false),
+        showNetPlusIva: liveToggle('showNetPlusIva', 'STOREFRONT_SHOW_NET_PLUS_IVA_LABEL', 'STOREFRONT_SHOW_NET_PLUS_IVA_HELP', 'Mostrar precio neto + IVA', 'Tus clientes mayoristas ven también el precio sin IVA, con la leyenda «+ IVA», junto al precio final. Nunca reemplaza al precio final.', false),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },

package/dist/product.d.ts

@@ -12,8 +12,10 @@ export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_de
 export type DiscoverySort = (typeof DISCOVERY_SORTS)[number];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
- * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`
- * (the filter matches no descendants, so a rolled-up parent would select nothing).
+ * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`.
+ * The `categoryId` filter selects a category's enabled descendants too, so a filter on a
+ * parent yields counts for several descendant ids; a product has one primary category,
+ * so a client sums exact counts over a subtree without counting a product twice.
  */
 export declare const DISCOVERY_FACETS: readonly ["brand", "tag", "category"];
 export type DiscoveryFacet = (typeof DISCOVERY_FACETS)[number];
@@ -272,7 +274,17 @@ declare global {
         mode: 'discover';
         /** Free text, ≤100 chars; every token must appear in the product's search term. */
         search?: string;
-        /** Exact primary category; descendants are not included. */
+        /**
+         * A primary category AND every enabled descendant: a product whose primary
+         * category is this one or any category below it. A disabled descendant
+         * excludes its whole branch. An id the store's enabled tree does not hold —
+         * unknown, or itself disabled — matches its own products only. A cursor is
+         * bound to the subtree it was minted over: once descendants count, or after
+         * the enabled subtree changes, a parent's cursor is 400 `INVALID_CURSOR`
+         * (a category with no enabled descendant keeps its cursors). A subtree too
+         * large for a price or name sort's whole-set read is refused like any such
+         * set (`DISCOVERY_SORT_UNSUPPORTED`).
+         */
         categoryId?: string;
         brandId?: string;
         /**

package/dist/product.js

@@ -11,8 +11,10 @@ export const MAX_BASE_QUANTITY = 1_000_000;
 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`
- * (the filter matches no descendants, so a rolled-up parent would select nothing).
+ * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`.
+ * The `categoryId` filter selects a category's enabled descendants too, so a filter on a
+ * parent yields counts for several descendant ids; a product has one primary category,
+ * so a client sums exact counts over a subtree without counting a product twice.
  */
 export const DISCOVERY_FACETS = ['brand', 'tag', 'category'];
 /** Most products the store's best-seller ranking holds, and web `mode=best-sellers` returns. */

package/dist/storefrontDesignRegistry.js

@@ -148,12 +148,21 @@ export const STOREFRONT_DESIGN_REGISTRY = {
          *
          * Responsable Inscripto only (`integrations.afip.condFiscal === 30`). Both
          * writers refuse `true` on any other store with 409 NET_PLUS_IVA_REQUIRES_RI;
-         * `false` and `null` always pass. Storefront exits (web `GET /store`, the
-         * preview's store frame, the customer `stores` frame) send the EFFECTIVE value,
-         * stored flag AND RI; app reads (`GET /store`, the operator `/tenants` read)
-         * send the STORED one beside `integrations.afip.condFiscal`.
+         * `false` and `null` always pass. App reads (`GET /store`, the operator
+         * `/tenants` read) send the STORED value beside `integrations.afip.condFiscal`.
+         *
+         * Wholesale customers only. Storefront exits send the EFFECTIVE value per
+         * viewer: stored flag AND RI AND an approved customer whose effective price
+         * list is `audienceClass: 'wholesale'`. A guest, a pending registrant and a
+         * retail customer read `false`.
+         * - Web `GET /store` judges its resolved caller. A customer's answer is
+         *   `private, no-store`, and every answer varies on `Authorization`.
+         * - The preview's store frame judges the grant fixture's simulated caller.
+         *   A grant without a fixture is judged as a guest.
+         * - The customer `stores` frame reaches every shopper at once, so it always
+         *   sends `false`. The storefront re-reads web `GET /store` on that frame.
          */
-        showNetPlusIva: liveToggle('showNetPlusIva', 'STOREFRONT_SHOW_NET_PLUS_IVA_LABEL', 'STOREFRONT_SHOW_NET_PLUS_IVA_HELP', 'Mostrar precio neto + IVA', 'Mostrar también el precio sin IVA, con la leyenda «+ IVA», junto al precio final. Nunca reemplaza al precio final.', false),
+        showNetPlusIva: liveToggle('showNetPlusIva', 'STOREFRONT_SHOW_NET_PLUS_IVA_LABEL', 'STOREFRONT_SHOW_NET_PLUS_IVA_HELP', 'Mostrar precio neto + IVA', 'Tus clientes mayoristas ven también el precio sin IVA, con la leyenda «+ IVA», junto al precio final. Nunca reemplaza al precio final.', false),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },

package/package.json

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