platform-types 1.10.677 → 1.10.679

package/dist/cjs/storefrontAssets.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_STOREFRONT_ASSETS = exports.STOREFRONT_ASSET_VARIANTS = void 0;
+const storefrontDesign_ts_1 = require("./storefrontDesign.js");
 exports.STOREFRONT_ASSET_VARIANTS = [
     'original',
     '200x200',
@@ -9,4 +10,5 @@ exports.STOREFRONT_ASSET_VARIANTS = [
     '1200x1200',
     '1600x1600',
 ];
-exports.MAX_STOREFRONT_ASSETS = 200;
+/** The active-asset cap, the same value as `STOREFRONT_DESIGN_LIMITS.activeImages` by construction. */
+exports.MAX_STOREFRONT_ASSETS = storefrontDesign_ts_1.STOREFRONT_DESIGN_LIMITS.activeImages;

package/dist/cjs/storefrontDesign.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STOREFRONT_SOCIAL_HOSTS = exports.STOREFRONT_BENEFIT_ICONS = exports.STOREFRONT_RESERVED_SLUGS = exports.STOREFRONT_CONTACT_FIELDS = exports.STOREFRONT_BUILTIN_DESTINATIONS = exports.STOREFRONT_SECTION_TYPES = exports.STOREFRONT_DESIGN_LIMITS = void 0;
+exports.STOREFRONT_SOCIAL_HOSTS = exports.STOREFRONT_BENEFIT_ICONS = exports.STOREFRONT_RESERVED_SLUGS = exports.STOREFRONT_CONTACT_FIELDS = exports.STOREFRONT_PROTECTED_BUILTIN_DESTINATIONS = exports.STOREFRONT_BUILTIN_DESTINATIONS = exports.STOREFRONT_SECTION_TYPES = exports.STOREFRONT_DESIGN_LIMITS = void 0;
 exports.createStorefrontDesignV1 = createStorefrontDesignV1;
 exports.STOREFRONT_DESIGN_LIMITS = {
     customPages: 20,
@@ -24,6 +24,8 @@ exports.STOREFRONT_DESIGN_LIMITS = {
     seoTitle: 120,
     seoDescription: 320,
     imageAlt: 250,
+    assetFilename: 255,
+    assetSearch: 80,
     activeImages: 200,
     imageDecodedBytes: 4 * 1024 * 1024,
     imagePixels: 32_000_000,
@@ -58,7 +60,21 @@ exports.STOREFRONT_BUILTIN_DESTINATIONS = [
     'cart',
     'account',
     'privacy',
-    'terms',
+];
+/**
+ * The built-in destinations that must stay reachable whatever a design does with
+ * its menus: search, cart, account and the required legal page. Reachability is
+ * owned by the storefront's platform chrome, not by the design: the storefront
+ * always renders these outside merchant menus and footer groups, so no design can
+ * remove or repoint them. A design may still link to them. Editors show them as
+ * fixed, non-editable entries. `parseStorefrontDesign` therefore does not refuse
+ * a document whose menus omit them.
+ */
+exports.STOREFRONT_PROTECTED_BUILTIN_DESTINATIONS = [
+    'search',
+    'cart',
+    'account',
+    'privacy',
 ];
 exports.STOREFRONT_CONTACT_FIELDS = ['email', 'phone', 'whatsapp', 'address', 'hours', 'socials'];
 exports.STOREFRONT_RESERVED_SLUGS = [
@@ -91,6 +107,14 @@ exports.STOREFRONT_RESERVED_SLUGS = [
     'admin',
     'storefront',
     'pagina',
+    'basket',
+    'profile',
+    'favorites',
+    'invoices',
+    'payments',
+    'payment-methods',
+    'user',
+    'mantenimiento',
 ];
 exports.STOREFRONT_BENEFIT_ICONS = ['truck', 'shield', 'credit-card', 'store', 'heart', 'check'];
 exports.STOREFRONT_SOCIAL_HOSTS = {

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/cjs/storefrontTheme.js

@@ -65,6 +65,13 @@ const surfaceTokens = (background, settings, mode, surface, warnings) => {
         disabled: { background: disabledBackground, text: readableText(disabledBackground) },
     };
 };
+/**
+ * The storefront theme for a design's settings overrides.
+ *
+ * Settings resolve from the registry defaults plus the store's own design
+ * overrides ONLY — no GLOBAL or WEB layer takes part — so a consumer uses this
+ * as shipped rather than merging layers of its own first.
+ */
 const resolveStorefrontTheme = (overrides = {}) => {
     const settings = (0, storefrontDesignRegistry_ts_1.resolveStorefrontDesignSettings)(overrides);
     const warnings = [];

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

@@ -1,7 +1,8 @@
 export declare const STOREFRONT_ASSET_VARIANTS: readonly ["original", "200x200", "400x400", "800x800", "1200x1200", "1600x1600"];
-export declare const MAX_STOREFRONT_ASSETS = 200;
+/** The active-asset cap, the same value as `STOREFRONT_DESIGN_LIMITS.activeImages` by construction. */
+export declare const MAX_STOREFRONT_ASSETS: 200;
 declare global {
-    type StorefrontAssetErrorCode = 'ROLE_FORBIDDEN' | 'PLAN_UPGRADE_REQUIRED' | 'SUBSCRIPTION_READONLY' | 'STOREFRONT_ASSET_ENTITLEMENT_UNAVAILABLE' | 'STOREFRONT_ASSET_REQUEST_TOO_LARGE' | 'STOREFRONT_ASSET_TIMEOUT' | 'VALIDATION_FAILED' | 'ASSET_ARCHIVE_UNCERTAIN' | 'ASSET_CAPACITY_EXCEEDED' | 'ASSET_NOT_FOUND' | 'ASSET_REQUEST_CONFLICT' | 'ASSET_STORAGE_CONFLICT' | 'ASSET_TOO_LARGE' | 'ASSET_UPLOAD_FAILED' | 'ASSET_UPLOAD_PENDING' | 'ASSET_UPLOAD_UNCERTAIN' | 'INVALID_ACTOR' | 'INVALID_ASSET_CURSOR' | 'INVALID_ASSET_ID' | 'INVALID_ASSET_IMAGE' | 'INVALID_ASSET_LIMIT' | 'INVALID_ASSET_PLACEMENT' | 'INVALID_ASSET_STAGE' | 'INVALID_ASSET_VARIANT' | 'INVALID_REQUEST_ID' | 'INVALID_STORE_CONTEXT' | 'LEGACY_LOGO_MAPPING_CONFLICT';
+    type StorefrontAssetErrorCode = 'ROLE_FORBIDDEN' | 'PLAN_UPGRADE_REQUIRED' | 'SUBSCRIPTION_READONLY' | 'STOREFRONT_ASSET_ENTITLEMENT_UNAVAILABLE' | 'STOREFRONT_ASSET_REQUEST_TOO_LARGE' | 'STOREFRONT_ASSET_TIMEOUT' | 'VALIDATION_FAILED' | 'ASSET_ARCHIVE_UNCERTAIN' | 'ASSET_ARCHIVED' | 'ASSET_CAPACITY_EXCEEDED' | 'ASSET_NOT_FOUND' | 'ASSET_REQUEST_CONFLICT' | 'ASSET_STORAGE_CONFLICT' | 'ASSET_TOO_LARGE' | 'ASSET_UPDATE_UNCERTAIN' | 'ASSET_UPLOAD_FAILED' | 'ASSET_UPLOAD_PENDING' | 'ASSET_UPLOAD_UNCERTAIN' | 'INVALID_ACTOR' | 'INVALID_ASSET_CURSOR' | 'INVALID_ASSET_ID' | 'INVALID_ASSET_IMAGE' | 'INVALID_ASSET_LIMIT' | 'INVALID_ASSET_PLACEMENT' | 'INVALID_ASSET_SEARCH' | 'INVALID_ASSET_STAGE' | 'INVALID_ASSET_VARIANT' | 'INVALID_REQUEST_ID' | 'INVALID_STORE_CONTEXT' | 'LEGACY_LOGO_MAPPING_CONFLICT';
     interface StorefrontAssetResponse {
         message: string;
         data: StorefrontAsset;
@@ -21,18 +22,51 @@ declare global {
         source?: EntitlementSource;
         requiredPlan?: PlanTier | null;
         currentPlan?: PlanTier | null;
+        currentStatus?: SubscriptionStatus;
     }
     type StorefrontAssetVariant = (typeof STOREFRONT_ASSET_VARIANTS)[number];
+    /**
+     * `filename` is the picked file's name, kept as a basename (any directory
+     * part dropped) for the library's search; `label` and `defaultAlt` seed the
+     * editor's picker and a NEW placement's alt — a placement carries its own
+     * `alt`, so neither is ever read at render time. Each is bounded in code
+     * points, and a blank, ill-formed or control-character value is refused
+     * 400 `VALIDATION_FAILED`, never cleaned up.
+     */
     interface StorefrontAssetUploadRequest {
         requestId: string;
         base64: string;
+        filename?: string;
+        label?: string;
+        defaultAlt?: string;
     }
     interface StorefrontAssetArchiveRequest {
         requestId: string;
     }
+    /**
+     * `PATCH /store/design/assets/{assetId}`. An omitted key is left as stored,
+     * `null` clears it. Idempotent by `requestId` like archive: the same body
+     * replays the first answer, a different body under the same `requestId`
+     * answers 409 `ASSET_REQUEST_CONFLICT`. An archived asset answers 409
+     * `ASSET_ARCHIVED`. Editing metadata never touches a draft, published or
+     * historical placement.
+     */
+    interface StorefrontAssetMetadataUpdateRequest {
+        requestId: string;
+        label?: string | null;
+        defaultAlt?: string | null;
+    }
+    /**
+     * `search` matches `filename` and `label` case- and accent-insensitively, as
+     * a substring. ⚠️ The filter applies AFTER `limit` rows of the active list are
+     * read, so a filtered page can hold fewer than `limit` items — even none —
+     * and still carry a `cursor`; follow the cursor until it is absent. A cursor
+     * is bound to the `search` it was minted under.
+     */
     interface StorefrontAssetListQuery {
         limit?: number;
         cursor?: string;
+        search?: string;
     }
     interface StorefrontAssetFieldError {
         path: string;
@@ -48,15 +82,10 @@ declare global {
         height: number;
         contentType: 'image/jpeg' | 'image/png' | 'image/webp';
         createdAt: number;
+        filename?: string;
+        label?: string;
+        defaultAlt?: string;
     }
-    interface StorefrontAssetPlacement {
-        assetId: string;
-        mobileAssetId?: string;
-        alt?: string;
-        decorative: boolean;
-        focalPoint?: {
-            x: number;
-            y: number;
-        };
-    }
+    /** @deprecated Use `StorefrontDesignImagePlacement`; this is the same shape. */
+    type StorefrontAssetPlacement = StorefrontDesignImagePlacement;
 }

package/dist/storefrontAssets.js

@@ -1,3 +1,4 @@
+import { STOREFRONT_DESIGN_LIMITS } from "./storefrontDesign.js";
 export const STOREFRONT_ASSET_VARIANTS = [
     'original',
     '200x200',
@@ -6,4 +7,5 @@ export const STOREFRONT_ASSET_VARIANTS = [
     '1200x1200',
     '1600x1600',
 ];
-export const MAX_STOREFRONT_ASSETS = 200;
+/** The active-asset cap, the same value as `STOREFRONT_DESIGN_LIMITS.activeImages` by construction. */
+export const MAX_STOREFRONT_ASSETS = STOREFRONT_DESIGN_LIMITS.activeImages;

package/dist/storefrontDesign.d.ts

@@ -20,6 +20,8 @@ export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly seoTitle: 120;
     readonly seoDescription: 320;
     readonly imageAlt: 250;
+    readonly assetFilename: 255;
+    readonly assetSearch: 80;
     readonly activeImages: 200;
     readonly imageDecodedBytes: number;
     readonly imagePixels: 32000000;
@@ -34,9 +36,19 @@ export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly contactEmail: 254;
 };
 export declare const STOREFRONT_SECTION_TYPES: readonly ["banner", "imageText", "products", "categories", "brands", "text", "faq", "benefits", "contact", "paymentDelivery"];
-export declare const STOREFRONT_BUILTIN_DESTINATIONS: readonly ["home", "catalogue", "offers", "new", "search", "cart", "account", "privacy", "terms"];
+export declare const STOREFRONT_BUILTIN_DESTINATIONS: readonly ["home", "catalogue", "offers", "new", "search", "cart", "account", "privacy"];
+/**
+ * The built-in destinations that must stay reachable whatever a design does with
+ * its menus: search, cart, account and the required legal page. Reachability is
+ * owned by the storefront's platform chrome, not by the design: the storefront
+ * always renders these outside merchant menus and footer groups, so no design can
+ * remove or repoint them. A design may still link to them. Editors show them as
+ * fixed, non-editable entries. `parseStorefrontDesign` therefore does not refuse
+ * a document whose menus omit them.
+ */
+export declare const STOREFRONT_PROTECTED_BUILTIN_DESTINATIONS: readonly ["search", "cart", "account", "privacy"];
 export declare const STOREFRONT_CONTACT_FIELDS: readonly ["email", "phone", "whatsapp", "address", "hours", "socials"];
-export declare const STOREFRONT_RESERVED_SLUGS: readonly ["home", "index", "api", "auth", "login", "logout", "account", "cart", "checkout", "orders", "search", "products", "product", "producto", "coleccion", "categories", "brands", "sale", "new", "privacy", "terms", "sitemap", "robots", "manifest", "assets", "preview", "admin", "storefront", "pagina"];
+export declare const STOREFRONT_RESERVED_SLUGS: readonly ["home", "index", "api", "auth", "login", "logout", "account", "cart", "checkout", "orders", "search", "products", "product", "producto", "coleccion", "categories", "brands", "sale", "new", "privacy", "terms", "sitemap", "robots", "manifest", "assets", "preview", "admin", "storefront", "pagina", "basket", "profile", "favorites", "invoices", "payments", "payment-methods", "user", "mantenimiento"];
 export declare const STOREFRONT_BENEFIT_ICONS: readonly ["truck", "shield", "credit-card", "store", "heart", "check"];
 export declare const STOREFRONT_SOCIAL_HOSTS: {
     readonly instagram: readonly ["instagram.com", "www.instagram.com"];
@@ -305,6 +317,17 @@ declare global {
         expiresAt: string;
         protocolVersion: 1;
     }
+    /**
+     * The editor access refusals, answered by the shared editor gate
+     * (`stacks/helpers/storefrontEditorGate.ts`) before any editor route reads or
+     * writes: 403 `ROLE_FORBIDDEN` (anything but an exact single-role tenant
+     * ADMIN), 403 `PLAN_UPGRADE_REQUIRED` (storefront entitlement off), 402
+     * `SUBSCRIPTION_READONLY` (a mutating call on a status other than active,
+     * trialing or past_due) and 503 `STOREFRONT_ASSET_ENTITLEMENT_UNAVAILABLE`
+     * (the entitlement could not be read). The 503 keeps the asset library's name
+     * so one gate answers one code on every editor route.
+     */
+    type StorefrontDesignAccessErrorCode = 'ROLE_FORBIDDEN' | 'PLAN_UPGRADE_REQUIRED' | 'SUBSCRIPTION_READONLY' | 'STOREFRONT_ASSET_ENTITLEMENT_UNAVAILABLE';
     type StorefrontDesignFailure = {
         message: string;
         error: 'STOREFRONT_REVISION_CONFLICT';
@@ -314,6 +337,20 @@ declare global {
         message: string;
         error: Exclude<StorefrontDesignErrorCode, 'STOREFRONT_REVISION_CONFLICT'>;
         fieldErrors?: StorefrontDesignFieldError[];
+    } | {
+        message: string;
+        error: 'PLAN_UPGRADE_REQUIRED';
+        feature: 'storefront';
+        currentPlan: PlanTier | null;
+        source?: EntitlementSource;
+        requiredPlan?: PlanTier | null;
+    } | {
+        message: string;
+        error: 'SUBSCRIPTION_READONLY';
+        currentStatus: SubscriptionStatus;
+    } | {
+        message: string;
+        error: 'ROLE_FORBIDDEN' | 'STOREFRONT_ASSET_ENTITLEMENT_UNAVAILABLE';
     };
     type StorefrontDesignDraftResponse = {
         message: string;

package/dist/storefrontDesign.js

@@ -20,6 +20,8 @@ export const STOREFRONT_DESIGN_LIMITS = {
     seoTitle: 120,
     seoDescription: 320,
     imageAlt: 250,
+    assetFilename: 255,
+    assetSearch: 80,
     activeImages: 200,
     imageDecodedBytes: 4 * 1024 * 1024,
     imagePixels: 32_000_000,
@@ -54,7 +56,21 @@ export const STOREFRONT_BUILTIN_DESTINATIONS = [
     'cart',
     'account',
     'privacy',
-    'terms',
+];
+/**
+ * The built-in destinations that must stay reachable whatever a design does with
+ * its menus: search, cart, account and the required legal page. Reachability is
+ * owned by the storefront's platform chrome, not by the design: the storefront
+ * always renders these outside merchant menus and footer groups, so no design can
+ * remove or repoint them. A design may still link to them. Editors show them as
+ * fixed, non-editable entries. `parseStorefrontDesign` therefore does not refuse
+ * a document whose menus omit them.
+ */
+export const STOREFRONT_PROTECTED_BUILTIN_DESTINATIONS = [
+    'search',
+    'cart',
+    'account',
+    'privacy',
 ];
 export const STOREFRONT_CONTACT_FIELDS = ['email', 'phone', 'whatsapp', 'address', 'hours', 'socials'];
 export const STOREFRONT_RESERVED_SLUGS = [
@@ -87,6 +103,14 @@ export const STOREFRONT_RESERVED_SLUGS = [
     'admin',
     'storefront',
     'pagina',
+    'basket',
+    'profile',
+    'favorites',
+    'invoices',
+    'payments',
+    'payment-methods',
+    'user',
+    'mantenimiento',
 ];
 export const STOREFRONT_BENEFIT_ICONS = ['truck', 'shield', 'credit-card', 'store', 'heart', 'check'];
 export const STOREFRONT_SOCIAL_HOSTS = {

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

@@ -50,5 +50,12 @@ export interface StorefrontResolvedTheme {
     warnings: StorefrontThemeWarning[];
 }
 export declare const storefrontContrastRatio: (foreground: string, background: string) => number;
+/**
+ * The storefront theme for a design's settings overrides.
+ *
+ * Settings resolve from the registry defaults plus the store's own design
+ * overrides ONLY — no GLOBAL or WEB layer takes part — so a consumer uses this
+ * as shipped rather than merging layers of its own first.
+ */
 export declare const resolveStorefrontTheme: (overrides?: Partial<StorefrontDesignSettings>) => StorefrontResolvedTheme;
 export {};

package/dist/storefrontTheme.js

@@ -61,6 +61,13 @@ const surfaceTokens = (background, settings, mode, surface, warnings) => {
         disabled: { background: disabledBackground, text: readableText(disabledBackground) },
     };
 };
+/**
+ * The storefront theme for a design's settings overrides.
+ *
+ * Settings resolve from the registry defaults plus the store's own design
+ * overrides ONLY — no GLOBAL or WEB layer takes part — so a consumer uses this
+ * as shipped rather than merging layers of its own first.
+ */
 export const resolveStorefrontTheme = (overrides = {}) => {
     const settings = resolveStorefrontDesignSettings(overrides);
     const warnings = [];

package/package.json

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