platform-types 1.10.801 → 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/literals.d.ts

@@ -10,6 +10,13 @@ declare global {
     interface ResolvedStorefrontLiterals {
         values: Record<string, string>;
         provenance: Record<string, 'default' | 'GLOBAL' | 'WEB' | `WEB#${string}`>;
+        /**
+         * The compiled storefront default of each key, before any layer is applied: what a
+         * revert restores, and the text whose `{tokens}` an override must keep. No stored
+         * layer changes it. A key the catalog generator excludes has no entry, so a missing
+         * entry means "default unknown"; the six blanked payment keys are `''`.
+         */
+        defaults: Record<string, string>;
     }
     /**
      * One scope's literals, unmerged.

package/dist/platform.d.ts

@@ -227,9 +227,72 @@ export interface PlatformLiteralsBody extends PlatformOperatorReason {
     literals: Record<string, string | null>;
     /**
      * Must equal the store id inside a per-tenant scope; absent or wrong there is
-     * `400 CONFIRMATION_MISMATCH`. Ignored on a global scope, which names no tenant.
+     * `400 CONFIRMATION_MISMATCH`. Ignored on a global scope, which names no tenant,
+     * and ignored on a dry run.
      */
     confirm?: string;
+    /**
+     * `true` judges each key on its own and writes nothing: no row, no activity
+     * row, no audit row. The answer is `PlatformLiteralsDryRunResult`. A bad
+     * scope, an empty map or a bad reason is still a request-level 400. The
+     * legacy `WEB#` write conflicts happen only at commit and are not predicted.
+     */
+    dryRun?: boolean;
+}
+/** Why a dry run says one key would be refused. */
+export type PlatformLiteralDryRunError = 'RESERVED_KEY' | 'INVALID_KEY' | 'VALUE_TOO_LONG' | 'LITERAL_KEY_NOT_ALLOWED';
+/**
+ * One key of a dry run: what the write would do (`set` a new value, `remove` a
+ * stored one, or leave it `unchanged`), or the code that would refuse it.
+ */
+export type PlatformLiteralDryRunKeyResult = {
+    key: string;
+    verdict: 'set' | 'remove' | 'unchanged';
+} | {
+    key: string;
+    error: PlatformLiteralDryRunError;
+};
+/** `POST /platform/literals { dryRun: true }` → `200 { message, data }`, one result per body key. */
+export interface PlatformLiteralsDryRunResult {
+    results: PlatformLiteralDryRunKeyResult[];
+}
+/**
+ * One change on `GET /platform/literals/{scope}/{key}/history`. `before` and
+ * `after` are the stored values on each side of the change, `''` for a key the
+ * scope does not hold. `actorStoreId` is the acting manager's own store, since
+ * `actorId` is numbered per store. `actorName` is absent when the actor's
+ * activity row can no longer be read; `reason` is absent when none was sent.
+ */
+export interface PlatformLiteralHistoryEntry {
+    at: string;
+    actorId: string;
+    actorStoreId?: string;
+    actorName?: string;
+    before: string;
+    after: string;
+    reason?: string;
+}
+/** `GET /platform/literals/{scope}/{key}/history`: newest first; send `cursor` back as `?cursor=`. */
+export interface PlatformLiteralHistoryResponse {
+    data: PlatformLiteralHistoryEntry[];
+    cursor?: string;
+}
+/** One store's own value for a key, on its `APP#{storeId}` or `WEB#{storeId}` row. */
+export interface PlatformLiteralOverride {
+    storeId: string;
+    /** Absent when the store row has no name, or can no longer be read. */
+    storeName?: string;
+    scope: `APP#${string}` | `WEB#${string}`;
+    value: string;
+}
+/**
+ * `GET /platform/literals/overrides?key=K`. `truncated` is `true` when the read
+ * stopped at its bound before reaching every tenant row, so the list may be
+ * incomplete.
+ */
+export interface PlatformLiteralOverridesResponse {
+    data: PlatformLiteralOverride[];
+    truncated?: true;
 }
 /** `POST /platform/operations { mode: 'mp-recover-payment' }`. */
 /** Tracked non-money refresh returned inside the standard response data envelope. */

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/dist/userActivity.d.ts

@@ -1027,6 +1027,7 @@ declare global {
         key: string;
         before: string;
         after: string;
+        reason?: string;
     }
     interface SupportTicketCreatedEvent extends UserActivityEventBase {
         event: 'Support Ticket Created';

package/package.json

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