platform-types 1.10.675 → 1.10.676

package/dist/cjs/index.js

@@ -96,6 +96,9 @@ __exportStar(require("./serviceTemplate.js"), exports);
 __exportStar(require("./socket.js"), exports);
 __exportStar(require("./stock.js"), exports);
 __exportStar(require("./store.js"), exports);
+__exportStar(require("./storefrontDesign.js"), exports);
+__exportStar(require("./storefrontDesignRegistry.js"), exports);
+__exportStar(require("./storefrontTheme.js"), exports);
 __exportStar(require("./storeNetwork.js"), exports);
 __exportStar(require("./storefrontEvent.js"), exports);
 __exportStar(require("./subscription.js"), exports);

package/dist/cjs/platform.js

@@ -1,8 +1,4 @@
 "use strict";
-// Platform-wide config/feature-flag contracts. Single fixed
-// GLOBALS/PLATFORM scope, unlike Literals' multi-scope override chain — no
-// per-tenant override use case identified for globals/flags (deliberate
-// divergence from the Literals model).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ML_ORDER_RECONCILE_SUMMARY_KEYS = exports.INTEGRATION_EVENT_OUTCOMES = exports.INTEGRATION_EVENT_TYPES = void 0;
 // ── Integration events log — the rows both read endpoints return ─────────

package/dist/cjs/storefrontDesign.js

@@ -0,0 +1,118 @@
+"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.createStorefrontDesignV1 = createStorefrontDesignV1;
+exports.STOREFRONT_DESIGN_LIMITS = {
+    customPages: 20,
+    sectionsPerPage: 10,
+    productCountMin: 4,
+    productCountMax: 24,
+    productCountDefault: 8,
+    navigationTopLevel: 12,
+    navigationChildren: 8,
+    navigationTotal: 40,
+    footerGroups: 4,
+    footerLinks: 8,
+    faqs: 20,
+    benefits: 8,
+    historyEntries: 20,
+    documentBytes: 256 * 1024,
+    heading: 120,
+    label: 80,
+    body: 4000,
+    slug: 80,
+    seoTitle: 120,
+    seoDescription: 320,
+    imageAlt: 250,
+    activeImages: 200,
+    imageDecodedBytes: 4 * 1024 * 1024,
+    imagePixels: 32_000_000,
+    imageDimension: 8000,
+    previewSeconds: 15 * 60,
+    fieldErrors: 100,
+    fieldErrorPath: 240,
+    contactAddress: 500,
+    contactNote: 200,
+    contactHours: 14,
+    contactSocials: 8,
+    contactEmail: 254,
+};
+exports.STOREFRONT_SECTION_TYPES = [
+    'banner',
+    'imageText',
+    'products',
+    'categories',
+    'brands',
+    'text',
+    'faq',
+    'benefits',
+    'contact',
+    'paymentDelivery',
+];
+exports.STOREFRONT_BUILTIN_DESTINATIONS = [
+    'home',
+    'catalogue',
+    'offers',
+    'new',
+    'search',
+    'cart',
+    'account',
+    'privacy',
+    'terms',
+];
+exports.STOREFRONT_CONTACT_FIELDS = ['email', 'phone', 'whatsapp', 'address', 'hours', 'socials'];
+exports.STOREFRONT_RESERVED_SLUGS = [
+    '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',
+];
+exports.STOREFRONT_BENEFIT_ICONS = ['truck', 'shield', 'credit-card', 'store', 'heart', 'check'];
+exports.STOREFRONT_SOCIAL_HOSTS = {
+    instagram: ['instagram.com', 'www.instagram.com'],
+    facebook: ['facebook.com', 'www.facebook.com'],
+    youtube: ['youtube.com', 'www.youtube.com', 'youtu.be', 'www.youtu.be'],
+    tiktok: ['tiktok.com', 'www.tiktok.com'],
+    linkedin: ['linkedin.com', 'www.linkedin.com'],
+    x: ['x.com', 'www.x.com'],
+};
+function createStorefrontDesignV1() {
+    return {
+        schemaVersion: 1,
+        templateId: 'standard',
+        settings: {},
+        branding: {},
+        home: { id: 'home', title: 'Home', enabled: true, sections: [] },
+        pages: [],
+        navigation: [],
+        footer: [],
+        contact: {},
+        seo: {},
+        literalOverrides: {},
+    };
+}

package/dist/cjs/storefrontDesignRegistry.js

@@ -0,0 +1,130 @@
+"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;
+const DESIGN_METADATA = {
+    scope: 'storefront',
+    allowedLayers: ['GLOBAL', 'WEB', 'WEB#store'],
+    audience: 'public',
+    lifecycle: 'release-owned',
+    storage: { policy: 'GLOBALS', override: 'design.settings' },
+    ownership: 'storefront-design',
+};
+const color = (key, defaultValue, label, help) => ({
+    ...DESIGN_METADATA,
+    key,
+    defaultValue,
+    valueType: 'string',
+    valueSchema: { type: 'string', format: 'hex-color', maxLength: 7 },
+    maxLength: 7,
+    description: help,
+    literal: { kind: 'text', label, help },
+});
+const choice = (key, allowedValues, defaultValue, label, help) => ({
+    ...DESIGN_METADATA,
+    key,
+    defaultValue,
+    valueType: 'string',
+    allowedValues,
+    valueSchema: { type: 'string', enum: allowedValues },
+    description: help,
+    literal: { kind: 'text', label, help },
+});
+const toggle = (key, defaultValue, label, help) => ({
+    ...DESIGN_METADATA,
+    key,
+    defaultValue,
+    valueType: 'boolean',
+    valueSchema: { type: 'boolean' },
+    description: help,
+    literal: { kind: 'text', label, help },
+});
+exports.STOREFRONT_DESIGN_SETTINGS = {
+    primaryColor: color('primaryColor', '#0066CC', 'Color principal', 'Color solicitado para los elementos principales de la tienda.'),
+    accentColor: color('accentColor', '#0066CC', 'Color de acento', 'Color solicitado para los elementos destacados de la tienda.'),
+    backgroundColor: color('backgroundColor', '#FFFFFF', 'Color de fondo', 'Color solicitado para el fondo de la tienda.'),
+    headerColor: color('headerColor', '#0066CC', 'Color del encabezado', 'Color solicitado para el encabezado de la tienda.'),
+    footerColor: color('footerColor', '#212529', 'Color del pie', 'Color solicitado para el pie de la tienda.'),
+    headingFont: choice('headingFont', ['ubuntu', 'noto-sans', 'noto-serif'], 'ubuntu', 'Tipografía de títulos', 'Familia tipográfica de los títulos.'),
+    bodyFont: choice('bodyFont', ['ubuntu', 'noto-sans', 'noto-serif'], 'ubuntu', 'Tipografía de texto', 'Familia tipográfica del cuerpo de texto.'),
+    textSize: choice('textSize', ['compact', 'standard', 'large'], 'standard', 'Tamaño de texto', 'Escala de texto de la tienda.'),
+    cardImageRatio: choice('cardImageRatio', ['square', 'portrait'], 'square', 'Proporción de imágenes', 'Proporción de las imágenes en las tarjetas de productos.'),
+    cardDensity: choice('cardDensity', ['compact', 'spacious'], 'spacious', 'Espaciado de tarjetas', 'Espaciado entre los elementos de las tarjetas.'),
+    showBrand: toggle('showBrand', false, 'Mostrar marca', 'Mostrar la marca en las tarjetas de productos.'),
+    showSku: toggle('showSku', false, 'Mostrar SKU', 'Mostrar el código SKU en las tarjetas de productos.'),
+};
+const isStorefrontDesignSettingKey = (key) => Object.hasOwn(exports.STOREFRONT_DESIGN_SETTINGS, key);
+exports.isStorefrontDesignSettingKey = isStorefrontDesignSettingKey;
+const validateStorefrontSettingValue = (schema, value) => {
+    if (schema.type === 'boolean')
+        return typeof value === 'boolean';
+    if (typeof value !== 'string' || !value.isWellFormed())
+        return false;
+    if (schema.maxLength !== undefined && Array.from(value).length > schema.maxLength)
+        return false;
+    if (schema.format === 'hex-color' && !/^#[0-9a-fA-F]{6}$/.test(value))
+        return false;
+    return schema.enum === undefined || schema.enum.includes(value);
+};
+exports.validateStorefrontSettingValue = validateStorefrontSettingValue;
+const validateStorefrontDesignSetting = (key, value) => (0, exports.isStorefrontDesignSettingKey)(key) &&
+    (0, exports.validateStorefrontSettingValue)(exports.STOREFRONT_DESIGN_SETTINGS[key].valueSchema, value);
+exports.validateStorefrontDesignSetting = validateStorefrontDesignSetting;
+exports.STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS = 4096;
+const resolveStorefrontDesignSettingsLayers = (layers, overrides = {}) => {
+    const values = {};
+    const provenance = {};
+    const ordered = ['GLOBAL', 'WEB', 'WEB#store'].flatMap((name) => layers.filter(({ layer }) => layer === name));
+    for (const key of Object.keys(exports.STOREFRONT_DESIGN_SETTINGS)) {
+        Object.assign(values, { [key]: exports.STOREFRONT_DESIGN_SETTINGS[key].defaultValue });
+        provenance[key] = 'default';
+        for (const { layer, values: inherited } of ordered) {
+            if (!Object.hasOwn(inherited, key) || !(0, exports.validateStorefrontDesignSetting)(key, inherited[key]))
+                continue;
+            Object.assign(values, { [key]: inherited[key] });
+            provenance[key] = layer;
+        }
+        if (Object.hasOwn(overrides, key) && (0, exports.validateStorefrontDesignSetting)(key, overrides[key])) {
+            Object.assign(values, { [key]: overrides[key] });
+            provenance[key] = 'design';
+        }
+    }
+    return { values, provenance };
+};
+exports.resolveStorefrontDesignSettingsLayers = resolveStorefrontDesignSettingsLayers;
+const resolveStorefrontDesignSettings = (overrides = {}, layers = []) => (0, exports.resolveStorefrontDesignSettingsLayers)(layers, overrides).values;
+exports.resolveStorefrontDesignSettings = resolveStorefrontDesignSettings;
+const LIVE_METADATA = {
+    allowedLayers: ['GLOBAL', 'WEB', 'WEB#store'],
+    audience: 'public',
+    lifecycle: 'live',
+    ownership: 'storefront-operation',
+    excludedFromSnapshot: true,
+};
+exports.STOREFRONT_DESIGN_REGISTRY = {
+    settings: exports.STOREFRONT_DESIGN_SETTINGS,
+    content: {
+        schema: 'StorefrontDesignV1',
+        lifecycle: 'release-owned',
+        ownership: 'storefront-design',
+        audience: 'public',
+        storage: { document: 'storefront-design' },
+    },
+    literalOverrides: {
+        catalog: 'WEB_LITERAL_DEFAULTS',
+        allowedLayers: DESIGN_METADATA.allowedLayers,
+        lifecycle: 'release-owned',
+        ownership: 'storefront-design',
+        audience: 'public',
+        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' } },
+        prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
+        stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
+        checkout: { ...LIVE_METADATA, storage: { source: 'store' } },
+        catalogue: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
+        availability: { ...LIVE_METADATA, storage: { source: 'store' } },
+    },
+};

package/dist/cjs/storefrontTheme.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveStorefrontTheme = exports.storefrontContrastRatio = void 0;
+const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
+const channels = (color) => [
+    Number.parseInt(color.slice(1, 3), 16),
+    Number.parseInt(color.slice(3, 5), 16),
+    Number.parseInt(color.slice(5, 7), 16),
+];
+const hex = (rgb) => `#${rgb
+    .map((value) => Math.round(value).toString(16).padStart(2, '0'))
+    .join('')
+    .toUpperCase()}`;
+// MUI's RGB lighten/darken arithmetic; fixed hex output keeps tokens CSS-independent.
+const mix = (color, target, amount) => {
+    const destination = channels(target);
+    return hex(channels(color).map((value, index) => value + (destination[index] - value) * amount));
+};
+const luminance = (color) => {
+    const linear = channels(color).map((channel) => {
+        const value = channel / 255;
+        return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+    });
+    return linear[0] * 0.2126 + linear[1] * 0.7152 + linear[2] * 0.0722;
+};
+const storefrontContrastRatio = (foreground, background) => {
+    const a = luminance(foreground);
+    const b = luminance(background);
+    return (Math.max(a, b) + 0.05) / (Math.min(a, b) + 0.05);
+};
+exports.storefrontContrastRatio = storefrontContrastRatio;
+const readableText = (background) => (0, exports.storefrontContrastRatio)('#000000', background) >= (0, exports.storefrontContrastRatio)('#FFFFFF', background)
+    ? '#000000'
+    : '#FFFFFF';
+const ensureContrast = (color, background, minimum) => {
+    if ((0, exports.storefrontContrastRatio)(color, background) >= minimum)
+        return color.toUpperCase();
+    const target = readableText(background);
+    for (let step = 1; step <= 100; step++) {
+        const candidate = mix(color, target, step / 100);
+        if ((0, exports.storefrontContrastRatio)(candidate, background) >= minimum)
+            return candidate;
+    }
+    return target;
+};
+const surfaceTokens = (background, settings, mode, surface, warnings) => {
+    const adjusted = (role, requested, minimum) => {
+        const effective = ensureContrast(requested, background, minimum);
+        if (effective !== requested.toUpperCase())
+            warnings.push({ mode, surface, role, requested, effective });
+        return effective;
+    };
+    const text = readableText(background);
+    const button = adjusted('button', settings.primaryColor, 3);
+    const hover = ensureContrast(mix(button, readableText(background), 0.2), background, 3);
+    const disabledBackground = mix(background, text, 0.12);
+    return {
+        background,
+        text,
+        secondaryText: ensureContrast(mix(background, text, 0.6), background, 4.5),
+        link: adjusted('link', settings.primaryColor, 4.5),
+        focus: adjusted('focus', settings.accentColor, 3),
+        border: ensureContrast(mix(background, text, 0.3), background, 3),
+        button: { background: button, text: readableText(button), hover, hoverText: readableText(hover) },
+        disabled: { background: disabledBackground, text: readableText(disabledBackground) },
+    };
+};
+const resolveStorefrontTheme = (overrides = {}) => {
+    const settings = (0, storefrontDesignRegistry_ts_1.resolveStorefrontDesignSettings)(overrides);
+    const warnings = [];
+    const makeMode = (mode) => {
+        const background = (requested) => mode === 'light' ? requested.toUpperCase() : mix(requested, '#000000', 0.9);
+        return {
+            page: surfaceTokens(background(settings.backgroundColor), settings, mode, 'page', warnings),
+            header: surfaceTokens(background(settings.headerColor), settings, mode, 'header', warnings),
+            footer: surfaceTokens(background(settings.footerColor), settings, mode, 'footer', warnings),
+        };
+    };
+    const scale = { compact: 0.875, standard: 1, large: 1.125 }[settings.textSize];
+    return {
+        requested: settings,
+        light: makeMode('light'),
+        dark: makeMode('dark'),
+        typography: {
+            headingFont: settings.headingFont,
+            bodyFont: settings.bodyFont,
+            fontSize: 14 * scale,
+            body1: 16 * scale,
+            body2: 14 * scale,
+            h1: 96 * scale,
+            h2: 60 * scale,
+            h3: 48 * scale,
+            h4: 34 * scale,
+            h5: 24 * scale,
+            h6: 20 * scale,
+        },
+        shape: { borderRadius: 4 },
+        spacing: 8,
+        warnings,
+    };
+};
+exports.resolveStorefrontTheme = resolveStorefrontTheme;

package/dist/index.d.ts

@@ -72,6 +72,9 @@ export * from './serviceTemplate.ts';
 export * from './socket.ts';
 export * from './stock.ts';
 export * from './store.ts';
+export * from './storefrontDesign.ts';
+export * from './storefrontDesignRegistry.ts';
+export * from './storefrontTheme.ts';
 export * from './storeNetwork.ts';
 export * from './storefrontEvent.ts';
 export * from './subscription.ts';

package/dist/index.js

@@ -80,6 +80,9 @@ export * from "./serviceTemplate.js";
 export * from "./socket.js";
 export * from "./stock.js";
 export * from "./store.js";
+export * from "./storefrontDesign.js";
+export * from "./storefrontDesignRegistry.js";
+export * from "./storefrontTheme.js";
 export * from "./storeNetwork.js";
 export * from "./storefrontEvent.js";
 export * from "./subscription.js";

package/dist/platform.d.ts

@@ -1,8 +1,9 @@
+import type { StorefrontRegistryMetadata } from './storefrontDesignRegistry.ts';
 type PlatformConfigScope = 'app' | 'landing' | 'storefront';
 type PlatformConfigValueType = 'boolean' | 'string' | 'number';
 type PlatformConfigKind = 'setting' | 'flag';
 type PlatformConfigValue = string | number | boolean;
-export interface PlatformConfigEntry {
+export interface PlatformConfigEntry extends Partial<StorefrontRegistryMetadata> {
     key: string;
     valueType: PlatformConfigValueType;
     kind: PlatformConfigKind;

package/dist/platform.js

@@ -1,7 +1,3 @@
-// Platform-wide config/feature-flag contracts. Single fixed
-// GLOBALS/PLATFORM scope, unlike Literals' multi-scope override chain — no
-// per-tenant override use case identified for globals/flags (deliberate
-// divergence from the Literals model).
 // ── Integration events log — the rows both read endpoints return ─────────
 //
 // `GET /platform/integrations/{provider}/events` (MANAGER, every tenant) and

package/dist/store.d.ts

@@ -880,6 +880,8 @@ declare global {
          *   value refetches `GET /store` to see those.
          */
         publicStorefront?: PublicStorefront | null;
+        /** Read-only legacy editor seed, available only to the entitled tenant ADMIN. */
+        storefrontEditorBaseline?: StorefrontEditorBaseline;
         photoURL: string;
         /** @deprecated Request-only upload control, never persisted or returned — use `StoreUpdateInput.photoData`. */
         photoData?: string;