platform-types 1.10.802 → 1.10.803

package/dist/cjs/socket.js

@@ -734,6 +734,10 @@ exports.isSocketAction = isSocketAction;
  * {@link ProductRemovedFrameData} marker instead of a priced patch.
  * `catalogStatus` is carried for the same reason: a stock movement on a draft or
  * archived product becomes that marker too, never a republished row.
+ *
+ * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
+ * fan-out re-prices the frame, and without the rate a merged frame would leave a
+ * stale net beside a new gross. The customer copy still drops the Id itself.
  */
 exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -745,6 +749,7 @@ exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'catalogStatus',
     'updatedAt',
     'lastMovementAt',
+    'ivaType',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/cjs/storefrontDesignRegistry.js

@@ -114,12 +114,15 @@ const LIVE_METADATA = {
     ownership: 'storefront-operation',
     excludedFromSnapshot: true,
 };
-const liveToggle = (key, labelKey, helpKey, label, help) => ({
+const liveToggle = (key, labelKey, helpKey, label, help, 
+// Per key: a toggle that changes what a shopper sees for every store that has
+// never written it ships `false`. Defaults to `true`, the three original toggles.
+defaultValue = true) => ({
     ...LIVE_METADATA,
     key,
     allowedLayers: ['WEB#store'],
     storage: { source: 'store', override: 'ecommerce.config' },
-    defaultValue: true,
+    defaultValue,
     valueType: 'boolean',
     valueSchema: { type: 'boolean' },
     literal: { kind: 'key', label: labelKey, help: helpKey, defaults: { label, help } },
@@ -145,6 +148,13 @@ exports.STOREFRONT_DESIGN_REGISTRY = {
         showIvaAlert: liveToggle('showIvaAlert', 'STOREFRONT_SHOW_IVA_ALERT_LABEL', 'STOREFRONT_SHOW_IVA_ALERT_HELP', 'Mostrar aviso de IVA', 'Mostrar el aviso de IVA incluido en los precios.'),
         showCurrencySelector: liveToggle('showCurrencySelector', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_LABEL', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_HELP', 'Mostrar selector de moneda', 'Permitir elegir la moneda de visualización en la tienda.'),
         enableSaveForLater: liveToggle('enableSaveForLater', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_LABEL', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_HELP', 'Permitir guardar para después', 'Mostrar los controles para guardar productos de la cesta para después.'),
+        /*
+         * Display only: every public price slot carries `netOfIva` whatever this says
+         * (absent only for a product with no declarable IVA rate), so a flip needs no
+         * catalogue refetch. The storefront shows the «+ IVA» line when this is on AND
+         * the block is present. Default off: a store opts in.
+         */
+        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),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },

package/dist/pricing.d.ts

@@ -109,5 +109,43 @@ declare global {
         promo?: PricePromo;
         visibleOnStorefront?: boolean;
     } & CurrencyStamp);
+    /**
+     * Net-of-IVA display figures for one public price slot, computed server-side
+     * as `calculateItemNeto(figure, 1, ivaPercent, 1, 'decimal').neto` from the
+     * product's `ivaType`, each figure first rounded to the store's `priceDecimals`
+     * as it is charged — for a unit in the voucher's currency, the per-unit `neto`
+     * a new invoice prints for the same undiscounted unit (gross rounded to 2 dp
+     * first, then backed out). Absent, too, when a figure cannot be netted.
+     *
+     * ⚠️ DISPLAY ONLY: nothing charges, quotes, totals or invoices these. The
+     * charged figure is the slot's `amount`, always.
+     *
+     * Each net shares the stamp of the gross it nets, with no FX step: `amount`
+     * and `baseAmount` the slot's, `promo` the promo's, each break its own.
+     *
+     * Sent whatever `ecommerce.config.showNetPlusIva` says; that setting only
+     * decides whether the storefront renders it. ABSENT when the product carries
+     * no declarable IVA rate — never a 0 % fallback.
+     */
+    interface PublicPriceNet {
+        amount: number;
+        /** Present iff the slot carries `baseAmount`. */
+        baseAmount?: number;
+        /** Net of `promo.amount`; present iff the slot carries `promo`. */
+        promo?: number;
+        /** One per `breaks` entry of the slot, same `minQty`, same order. */
+        breaks?: Array<{
+            minQty: number;
+            amount: number;
+        }>;
+    }
+    /**
+     * A price slot as a PUBLIC read emits it (web catalogue reads, customer
+     * `products` frames). A read-time extension of {@link PriceSlot}, never
+     * stored: `Product.prices` stays `PriceSlot[]`, so no writer can persist a net.
+     */
+    type PublicPriceSlot = PriceSlot & {
+        netOfIva?: PublicPriceNet;
+    };
 }
 export {};

package/dist/product.d.ts

@@ -32,8 +32,10 @@ declare global {
     type ProductUnitsInput = Omit<ProductUnits, 'unitRevision'>;
     /** The display declaration plus the purchase-unit factor; `unitRevision` stays server-only. */
     type PublicProductUnits = Pick<ProductUnits, 'baseUnit' | 'purchaseUnit' | 'packLabel' | 'baseUnitsPerPurchaseUnit'>;
-    type PublicProduct = Omit<Partial<Product>, 'units' | 'unitRevisionGeneration'> & {
+    type PublicProduct = Omit<Partial<Product>, 'units' | 'unitRevisionGeneration' | 'prices'> & {
         units?: PublicProductUnits | null;
+        /** The shopper's one applicable slot, with its read-time `netOfIva` when the product is rated. */
+        prices?: PublicPriceSlot[];
     };
     /** Anonymous Web GET /products lookup; the tenant comes from the public store context. */
     interface PublicProductsByIdsInput {

package/dist/socket.d.ts

@@ -172,8 +172,12 @@ export interface SocketMessage<T = unknown> {
  * {@link ProductRemovedFrameData} marker instead of a priced patch.
  * `catalogStatus` is carried for the same reason: a stock movement on a draft or
  * archived product becomes that marker too, never a republished row.
+ *
+ * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
+ * fan-out re-prices the frame, and without the rate a merged frame would leave a
+ * stale net beside a new gross. The customer copy still drops the Id itself.
  */
-export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt"];
+export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt", "ivaType"];
 /**
  * `data` of a **partial** `products` frame — the projection every stock-moving
  * write announces, and the only `products` shape that is not a whole `Product`.

package/dist/socket.js

@@ -730,6 +730,10 @@ export const isSocketAction = (value) => typeof value === 'string' && SOCKET_ACT
  * {@link ProductRemovedFrameData} marker instead of a priced patch.
  * `catalogStatus` is carried for the same reason: a stock movement on a draft or
  * archived product becomes that marker too, never a republished row.
+ *
+ * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
+ * fan-out re-prices the frame, and without the rate a merged frame would leave a
+ * stale net beside a new gross. The customer copy still drops the Id itself.
  */
 export const PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -741,6 +745,7 @@ export const PRODUCT_STOCK_FRAME_FIELDS = [
     'catalogStatus',
     'updatedAt',
     'lastMovementAt',
+    'ivaType',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/storefrontDesignRegistry.d.ts

@@ -1035,7 +1035,7 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
                 readonly source: "store";
                 readonly override: "ecommerce.config";
             };
-            readonly defaultValue: true;
+            readonly defaultValue: boolean;
             readonly valueType: "boolean";
             readonly valueSchema: {
                 readonly type: "boolean";
@@ -1061,7 +1061,7 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
                 readonly source: "store";
                 readonly override: "ecommerce.config";
             };
-            readonly defaultValue: true;
+            readonly defaultValue: boolean;
             readonly valueType: "boolean";
             readonly valueSchema: {
                 readonly type: "boolean";
@@ -1087,7 +1087,7 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
                 readonly source: "store";
                 readonly override: "ecommerce.config";
             };
-            readonly defaultValue: true;
+            readonly defaultValue: boolean;
             readonly valueType: "boolean";
             readonly valueSchema: {
                 readonly type: "boolean";
@@ -1106,6 +1106,32 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
             readonly ownership: "storefront-operation";
             readonly excludedFromSnapshot: true;
         };
+        readonly showNetPlusIva: {
+            readonly key: "showNetPlusIva";
+            readonly allowedLayers: readonly ["WEB#store"];
+            readonly storage: {
+                readonly source: "store";
+                readonly override: "ecommerce.config";
+            };
+            readonly defaultValue: boolean;
+            readonly valueType: "boolean";
+            readonly valueSchema: {
+                readonly type: "boolean";
+            };
+            readonly literal: {
+                readonly kind: "key";
+                readonly label: "STOREFRONT_SHOW_NET_PLUS_IVA_LABEL";
+                readonly help: "STOREFRONT_SHOW_NET_PLUS_IVA_HELP";
+                readonly defaults: {
+                    readonly label: string;
+                    readonly help: string;
+                };
+            };
+            readonly audience: "public";
+            readonly lifecycle: "live";
+            readonly ownership: "storefront-operation";
+            readonly excludedFromSnapshot: true;
+        };
         readonly prices: {
             readonly storage: {
                 readonly source: "catalogue";

package/dist/storefrontDesignRegistry.js

@@ -106,12 +106,15 @@ const LIVE_METADATA = {
     ownership: 'storefront-operation',
     excludedFromSnapshot: true,
 };
-const liveToggle = (key, labelKey, helpKey, label, help) => ({
+const liveToggle = (key, labelKey, helpKey, label, help, 
+// Per key: a toggle that changes what a shopper sees for every store that has
+// never written it ships `false`. Defaults to `true`, the three original toggles.
+defaultValue = true) => ({
     ...LIVE_METADATA,
     key,
     allowedLayers: ['WEB#store'],
     storage: { source: 'store', override: 'ecommerce.config' },
-    defaultValue: true,
+    defaultValue,
     valueType: 'boolean',
     valueSchema: { type: 'boolean' },
     literal: { kind: 'key', label: labelKey, help: helpKey, defaults: { label, help } },
@@ -137,6 +140,13 @@ export const STOREFRONT_DESIGN_REGISTRY = {
         showIvaAlert: liveToggle('showIvaAlert', 'STOREFRONT_SHOW_IVA_ALERT_LABEL', 'STOREFRONT_SHOW_IVA_ALERT_HELP', 'Mostrar aviso de IVA', 'Mostrar el aviso de IVA incluido en los precios.'),
         showCurrencySelector: liveToggle('showCurrencySelector', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_LABEL', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_HELP', 'Mostrar selector de moneda', 'Permitir elegir la moneda de visualización en la tienda.'),
         enableSaveForLater: liveToggle('enableSaveForLater', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_LABEL', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_HELP', 'Permitir guardar para después', 'Mostrar los controles para guardar productos de la cesta para después.'),
+        /*
+         * Display only: every public price slot carries `netOfIva` whatever this says
+         * (absent only for a product with no declarable IVA rate), so a flip needs no
+         * catalogue refetch. The storefront shows the «+ IVA» line when this is on AND
+         * the block is present. Default off: a store opts in.
+         */
+        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),
         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.802",
+	"version": "1.10.803",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",