platform-types 1.10.677 → 1.10.678

package/dist/cjs/storefrontDesignRegistry.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STOREFRONT_DESIGN_REGISTRY = exports.resolveStorefrontDesignSettings = exports.resolveStorefrontDesignSettingsLayers = exports.STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS = exports.validateStorefrontDesignSetting = exports.validateStorefrontSettingValue = exports.isStorefrontDesignSettingKey = exports.STOREFRONT_DESIGN_SETTINGS = void 0;
+exports.isStorefrontEditorLiteralKey = exports.STOREFRONT_EDITOR_LITERAL_DEFAULTS = exports.resolveStorefrontLiveSettings = exports.isStorefrontLiveSettingKey = exports.STOREFRONT_LIVE_SETTING_KEYS = exports.STOREFRONT_DESIGN_REGISTRY = exports.resolveStorefrontDesignSettings = exports.resolveStorefrontDesignSettingsLayers = exports.STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS = exports.validateStorefrontDesignSetting = exports.validateStorefrontSettingValue = exports.isStorefrontDesignSettingKey = exports.STOREFRONT_DESIGN_SETTINGS = void 0;
 const DESIGN_METADATA = {
     scope: 'storefront',
     allowedLayers: ['GLOBAL', 'WEB', 'WEB#store'],
@@ -100,6 +100,16 @@ const LIVE_METADATA = {
     ownership: 'storefront-operation',
     excludedFromSnapshot: true,
 };
+const liveToggle = (key, labelKey, helpKey, label, help) => ({
+    ...LIVE_METADATA,
+    key,
+    allowedLayers: ['WEB#store'],
+    storage: { source: 'store', override: 'ecommerce.config' },
+    defaultValue: true,
+    valueType: 'boolean',
+    valueSchema: { type: 'boolean' },
+    literal: { kind: 'key', label: labelKey, help: helpKey, defaults: { label, help } },
+});
 exports.STOREFRONT_DESIGN_REGISTRY = {
     settings: exports.STOREFRONT_DESIGN_SETTINGS,
     content: {
@@ -118,9 +128,9 @@ exports.STOREFRONT_DESIGN_REGISTRY = {
         storage: { source: 'LITERALS', override: 'design.literalOverrides' },
     },
     live: {
-        showIvaAlert: { ...LIVE_METADATA, storage: { source: 'featureFlags' } },
-        showCurrencySelector: { ...LIVE_METADATA, storage: { source: 'featureFlags' } },
-        enableSaveForLater: { ...LIVE_METADATA, storage: { source: 'featureFlags' } },
+        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.'),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },
@@ -128,3 +138,26 @@ exports.STOREFRONT_DESIGN_REGISTRY = {
         availability: { ...LIVE_METADATA, storage: { source: 'store' } },
     },
 };
+exports.STOREFRONT_LIVE_SETTING_KEYS = Object.keys(exports.STOREFRONT_DESIGN_REGISTRY.live).filter((key) => 'valueSchema' in exports.STOREFRONT_DESIGN_REGISTRY.live[key]);
+const isStorefrontLiveSettingKey = (key) => exports.STOREFRONT_LIVE_SETTING_KEYS.some((candidate) => candidate === key);
+exports.isStorefrontLiveSettingKey = isStorefrontLiveSettingKey;
+const liveBoolean = (source, key) => {
+    if (!source || typeof source !== 'object' || Array.isArray(source) || !Object.hasOwn(source, key))
+        return undefined;
+    const value = source[key];
+    return typeof value === 'boolean' ? value : undefined;
+};
+const resolveStorefrontLiveSettings = (canonical, legacy) => Object.fromEntries(exports.STOREFRONT_LIVE_SETTING_KEYS.map((key) => [
+    key,
+    liveBoolean(canonical, key) ?? liveBoolean(legacy, key) ?? exports.STOREFRONT_DESIGN_REGISTRY.live[key].defaultValue,
+]));
+exports.resolveStorefrontLiveSettings = resolveStorefrontLiveSettings;
+exports.STOREFRONT_EDITOR_LITERAL_DEFAULTS = Object.fromEntries(exports.STOREFRONT_LIVE_SETTING_KEYS.flatMap((key) => {
+    const { literal } = exports.STOREFRONT_DESIGN_REGISTRY.live[key];
+    return [
+        [literal.label, literal.defaults.label],
+        [literal.help, literal.defaults.help],
+    ];
+}));
+const isStorefrontEditorLiteralKey = (key) => Object.hasOwn(exports.STOREFRONT_EDITOR_LITERAL_DEFAULTS, key);
+exports.isStorefrontEditorLiteralKey = isStorefrontEditorLiteralKey;

package/dist/literals.d.ts

@@ -22,6 +22,8 @@ declare global {
         /** Absent when no store was requested — the chain is then global-only. */
         storeId?: string;
         layers: LiteralLayer[];
+        /** APP only: live storefront editor copy resolved from registry defaults and this scope chain. */
+        editorLiterals?: ResolvedStorefrontEditorLiterals;
     }
     /**
      * Legacy mode — the response when NO `surface` is sent. A single already-merged

package/dist/store.d.ts

@@ -1,4 +1,5 @@
 import type { ArgentineProvince } from './provinces.ts';
+import type { StorefrontLiveSettingKey } from './storefrontDesignRegistry.ts';
 declare global {
     /**
      * One tenant-authored Cmd-K palette entry (`store.palette.custom[]`).
@@ -112,7 +113,7 @@ declare global {
          * there); never sent to shoppers.
          */
         deactivatesAt?: number | null;
-        config?: {
+        config?: Partial<StorefrontLiveSettings> & {
             showDefaultPriceList?: number;
             showStocks?: boolean;
         };
@@ -151,6 +152,17 @@ declare global {
         appVersion?: number;
         stats?: Record<string, string>;
     }
+    /** Sparse tenant PATCH shape; live null values reset to registry defaults and are never stored. */
+    interface EcommercePatchInput {
+        config?: Pick<NonNullable<Ecommerce['config']>, 'showDefaultPriceList'> & StorefrontLiveSettingsPatch;
+        sidebar?: Ecommerce['sidebar'];
+        home?: Omit<NonNullable<Ecommerce['home']>, 'displayOrders' | 'displayProfile'>;
+        themeColors?: Ecommerce['themeColors'];
+    }
+    /** Platform override retains its wider surface and the same live-setting reset semantics. */
+    type EcommerceAdminOverrideInput = Omit<Ecommerce, 'config' | 'deactivatesAt' | 'stats'> & {
+        config?: Omit<NonNullable<Ecommerce['config']>, StorefrontLiveSettingKey> & StorefrontLiveSettingsPatch;
+    };
     /**
      * Platform globals forwarded to a tenant session on `GET /store`.
      *
@@ -1444,13 +1456,14 @@ declare global {
      * BE; `afip`/`mercadopago` bodies are re-routed to per-leaf integration
      * writes rather than SET wholesale.
      */
-    interface StoreUpdateInput extends Partial<Omit<Store, 'photoData' | 'removePhotoURL' | 'config'>> {
+    interface StoreUpdateInput extends Partial<Omit<Store, 'photoData' | 'removePhotoURL' | 'config' | 'ecommerce'>> {
         /**
          * Partial, and `maxLineDiscountPercent` is nullable to clear it — neither
          * of which `Partial<Store>['config']` can express, which is why `config`
          * is omitted from the extends clause above rather than inherited.
          */
         config?: StoreConfigPatchInput;
+        ecommerce?: EcommercePatchInput;
         /** Transient base64 image upload; the BE stores the derived `photoURL`, never this. */
         photoData?: string;
         /** Request-only: asks the BE to delete the current photo. */
@@ -1510,7 +1523,7 @@ declare global {
             /** @deprecated Same retirement as `Store['config']['defaultAccountCurrency']` — still accepted by `platform/_storeConfigPut.ts`, no new writers. */
             defaultAccountCurrency?: string;
         };
-        ecommerce?: Ecommerce;
+        ecommerce?: EcommerceAdminOverrideInput;
         reason: string;
     }
     /**

package/dist/storefrontDesignRegistry.d.ts

@@ -3,7 +3,7 @@ export type StorefrontRegistryAudience = 'internal' | 'app' | 'public';
 export type StorefrontRegistryLifecycle = 'live' | 'release-owned';
 export type StorefrontRegistryStorage = {
     policy?: 'GLOBALS';
-    override?: 'design.settings' | 'design.literalOverrides';
+    override?: 'design.settings' | 'design.literalOverrides' | 'ecommerce.config';
     document?: 'storefront-design';
     source?: 'LITERALS' | 'store' | 'catalogue' | 'featureFlags';
 };
@@ -25,6 +25,14 @@ export interface StorefrontRegistryMetadata {
         readonly kind: 'text';
         readonly label: string;
         readonly help: string;
+    } | {
+        readonly kind: 'key';
+        readonly label: string;
+        readonly help: string;
+        readonly defaults: {
+            readonly label: string;
+            readonly help: string;
+        };
     };
     valueSchema?: StorefrontSettingValueSchema;
 }
@@ -686,30 +694,78 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
     };
     readonly live: {
         readonly showIvaAlert: {
+            readonly key: "showIvaAlert";
+            readonly allowedLayers: readonly ["WEB#store"];
             readonly storage: {
-                readonly source: "featureFlags";
+                readonly source: "store";
+                readonly override: "ecommerce.config";
+            };
+            readonly defaultValue: true;
+            readonly valueType: "boolean";
+            readonly valueSchema: {
+                readonly type: "boolean";
+            };
+            readonly literal: {
+                readonly kind: "key";
+                readonly label: "STOREFRONT_SHOW_IVA_ALERT_LABEL";
+                readonly help: "STOREFRONT_SHOW_IVA_ALERT_HELP";
+                readonly defaults: {
+                    readonly label: string;
+                    readonly help: string;
+                };
             };
-            readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
             readonly audience: "public";
             readonly lifecycle: "live";
             readonly ownership: "storefront-operation";
             readonly excludedFromSnapshot: true;
         };
         readonly showCurrencySelector: {
+            readonly key: "showCurrencySelector";
+            readonly allowedLayers: readonly ["WEB#store"];
             readonly storage: {
-                readonly source: "featureFlags";
+                readonly source: "store";
+                readonly override: "ecommerce.config";
+            };
+            readonly defaultValue: true;
+            readonly valueType: "boolean";
+            readonly valueSchema: {
+                readonly type: "boolean";
+            };
+            readonly literal: {
+                readonly kind: "key";
+                readonly label: "STOREFRONT_SHOW_CURRENCY_SELECTOR_LABEL";
+                readonly help: "STOREFRONT_SHOW_CURRENCY_SELECTOR_HELP";
+                readonly defaults: {
+                    readonly label: string;
+                    readonly help: string;
+                };
             };
-            readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
             readonly audience: "public";
             readonly lifecycle: "live";
             readonly ownership: "storefront-operation";
             readonly excludedFromSnapshot: true;
         };
         readonly enableSaveForLater: {
+            readonly key: "enableSaveForLater";
+            readonly allowedLayers: readonly ["WEB#store"];
             readonly storage: {
-                readonly source: "featureFlags";
+                readonly source: "store";
+                readonly override: "ecommerce.config";
+            };
+            readonly defaultValue: true;
+            readonly valueType: "boolean";
+            readonly valueSchema: {
+                readonly type: "boolean";
+            };
+            readonly literal: {
+                readonly kind: "key";
+                readonly label: "STOREFRONT_ENABLE_SAVE_FOR_LATER_LABEL";
+                readonly help: "STOREFRONT_ENABLE_SAVE_FOR_LATER_HELP";
+                readonly defaults: {
+                    readonly label: string;
+                    readonly help: string;
+                };
             };
-            readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
             readonly audience: "public";
             readonly lifecycle: "live";
             readonly ownership: "storefront-operation";
@@ -767,3 +823,31 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
         };
     };
 };
+type LiveRegistry = typeof STOREFRONT_DESIGN_REGISTRY.live;
+export type StorefrontLiveSettingKey = {
+    [K in keyof LiveRegistry]: LiveRegistry[K] extends {
+        valueSchema: StorefrontSettingValueSchema;
+    } ? K : never;
+}[keyof LiveRegistry];
+declare global {
+    type StorefrontLiveSettings = Record<StorefrontLiveSettingKey, boolean>;
+    /** Omitted keeps the value; null removes the stored override and restores the default. */
+    type StorefrontLiveSettingsPatch = {
+        [K in StorefrontLiveSettingKey]?: boolean | null;
+    };
+}
+export type { StorefrontLiveSettings, StorefrontLiveSettingsPatch };
+export declare const STOREFRONT_LIVE_SETTING_KEYS: readonly StorefrontLiveSettingKey[];
+export declare const isStorefrontLiveSettingKey: (key: string) => key is StorefrontLiveSettingKey;
+export declare const resolveStorefrontLiveSettings: (canonical?: unknown, legacy?: unknown) => StorefrontLiveSettings;
+type LiveLiteralMetadata = LiveRegistry[StorefrontLiveSettingKey]['literal'];
+export type StorefrontEditorLiteralKey = LiveLiteralMetadata['label' | 'help'];
+export declare const STOREFRONT_EDITOR_LITERAL_DEFAULTS: Readonly<Record<StorefrontEditorLiteralKey, string>>;
+export declare const isStorefrontEditorLiteralKey: (key: string) => key is StorefrontEditorLiteralKey;
+declare global {
+    interface ResolvedStorefrontEditorLiterals {
+        values: Record<StorefrontEditorLiteralKey, string>;
+        provenance: Record<StorefrontEditorLiteralKey, 'default' | 'GLOBAL' | 'APP' | `APP#${string}`>;
+    }
+}
+export type { ResolvedStorefrontEditorLiterals };

package/dist/storefrontDesignRegistry.js

@@ -92,6 +92,16 @@ const LIVE_METADATA = {
     ownership: 'storefront-operation',
     excludedFromSnapshot: true,
 };
+const liveToggle = (key, labelKey, helpKey, label, help) => ({
+    ...LIVE_METADATA,
+    key,
+    allowedLayers: ['WEB#store'],
+    storage: { source: 'store', override: 'ecommerce.config' },
+    defaultValue: true,
+    valueType: 'boolean',
+    valueSchema: { type: 'boolean' },
+    literal: { kind: 'key', label: labelKey, help: helpKey, defaults: { label, help } },
+});
 export const STOREFRONT_DESIGN_REGISTRY = {
     settings: STOREFRONT_DESIGN_SETTINGS,
     content: {
@@ -110,9 +120,9 @@ export const STOREFRONT_DESIGN_REGISTRY = {
         storage: { source: 'LITERALS', override: 'design.literalOverrides' },
     },
     live: {
-        showIvaAlert: { ...LIVE_METADATA, storage: { source: 'featureFlags' } },
-        showCurrencySelector: { ...LIVE_METADATA, storage: { source: 'featureFlags' } },
-        enableSaveForLater: { ...LIVE_METADATA, storage: { source: 'featureFlags' } },
+        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.'),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },
@@ -120,3 +130,23 @@ export const STOREFRONT_DESIGN_REGISTRY = {
         availability: { ...LIVE_METADATA, storage: { source: 'store' } },
     },
 };
+export const STOREFRONT_LIVE_SETTING_KEYS = Object.keys(STOREFRONT_DESIGN_REGISTRY.live).filter((key) => 'valueSchema' in STOREFRONT_DESIGN_REGISTRY.live[key]);
+export const isStorefrontLiveSettingKey = (key) => STOREFRONT_LIVE_SETTING_KEYS.some((candidate) => candidate === key);
+const liveBoolean = (source, key) => {
+    if (!source || typeof source !== 'object' || Array.isArray(source) || !Object.hasOwn(source, key))
+        return undefined;
+    const value = source[key];
+    return typeof value === 'boolean' ? value : undefined;
+};
+export const resolveStorefrontLiveSettings = (canonical, legacy) => Object.fromEntries(STOREFRONT_LIVE_SETTING_KEYS.map((key) => [
+    key,
+    liveBoolean(canonical, key) ?? liveBoolean(legacy, key) ?? STOREFRONT_DESIGN_REGISTRY.live[key].defaultValue,
+]));
+export const STOREFRONT_EDITOR_LITERAL_DEFAULTS = Object.fromEntries(STOREFRONT_LIVE_SETTING_KEYS.flatMap((key) => {
+    const { literal } = STOREFRONT_DESIGN_REGISTRY.live[key];
+    return [
+        [literal.label, literal.defaults.label],
+        [literal.help, literal.defaults.help],
+    ];
+}));
+export const isStorefrontEditorLiteralKey = (key) => Object.hasOwn(STOREFRONT_EDITOR_LITERAL_DEFAULTS, key);

package/package.json

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