platform-types 1.10.688 → 1.10.690

package/dist/cjs/index.js

@@ -103,6 +103,8 @@ __exportStar(require("./storefrontTheme.js"), exports);
 __exportStar(require("./storeNetwork.js"), exports);
 __exportStar(require("./storefrontAssets.js"), exports);
 __exportStar(require("./storefrontEvent.js"), exports);
+__exportStar(require("./storefrontSeo.js"), exports);
+__exportStar(require("./storefrontWebLiteralKeys.js"), exports);
 __exportStar(require("./subscription.js"), exports);
 __exportStar(require("./support.js"), exports);
 __exportStar(require("./terminal.js"), exports);

package/dist/cjs/order.js

@@ -344,10 +344,28 @@ exports.orderFulfilmentProgress = orderFulfilmentProgress;
  *   `data.shiftId`. Logged; reconcile the queued sale by hand.
  * - `ORDER_CURRENCY_NOT_SUBSCRIBED` · 400 — the sale's currency has no
  *   subscription in the store's `currencies`. Logged.
- * - `PAYMENT_METHODS_NOT_CONFIGURED` · 409 — `tenders` sent while the store
- *   has no payment methods at all.
- * - `PAYMENT_METHOD_NOT_FOUND` · 400 — a tender leg's `method` names none of
- *   the store's payment methods.
+ * - `PAYMENT_METHODS_NOT_CONFIGURED` · 409 — `tenders` sent, or storefront/
+ *   WhatsApp checkout attempted, while the store has no payment methods at
+ *   all. Storefront checkout carries `data: {}` and refuses before the cart read.
+ * - `PAYMENT_METHOD_NOT_FOUND` · 400 — a tender leg's `method`, or storefront
+ *   checkout's `paymentMethod`, names none of the store's payment methods.
+ *   Storefront checkout carries `data: {}` and refuses before the cart read.
+ *
+ * Storefront and WhatsApp checkout business refusals. None allocates an order
+ * id, redeems a coupon or writes an order; none is logged as an error:
+ * - `DELIVERY_METHOD_NOT_FOUND` · 400 — `deliveryMethod` is not in the store's
+ *   delivery catalogue, including an absent/empty catalogue. `data: {}`;
+ *   refused before reading the cart.
+ * - `ORDER_INVALID_CART` · 400 — the normalized cart has no finite numeric
+ *   `totals.grandTotal`. `data: {}`; refused before repricing/allocation.
+ * - `ORDER_BELOW_MINIMUM_PURCHASE` · 400 — after repricing has confirmed the
+ *   cart, its grand total is below a finite positive `Number(customer.minBuy)`.
+ *   Equality passes. `data: OrderBelowMinimumPurchaseData` carries minBuy,
+ *   grandTotal and the cart display currency, with no currency conversion.
+ * - `EMAIL_VERIFICATION_REQUIRED` · 403 — the store requires email verification
+ *   and the live customer has not verified. No data payload; before cart read.
+ * - `ACCOUNT_DISABLED` · 403 — the live customer is disabled. No data payload;
+ *   before cart read. This is distinct from the staff `CUSTOMER_DISABLED` code.
  *
  * Commit-time drawer refusals, on a create whose cash tender books into a
  * drawer shift. No order committed, but a coupon redeemed before the commit
@@ -552,6 +570,11 @@ exports.ORDER_ERROR_CODES = [
     'ORDER_CURRENCY_NOT_SUBSCRIBED',
     'PAYMENT_METHODS_NOT_CONFIGURED',
     'PAYMENT_METHOD_NOT_FOUND',
+    'DELIVERY_METHOD_NOT_FOUND',
+    'ORDER_BELOW_MINIMUM_PURCHASE',
+    'ORDER_INVALID_CART',
+    'EMAIL_VERIFICATION_REQUIRED',
+    'ACCOUNT_DISABLED',
     // Commit-time drawer refusals; `CURRENCY_MISMATCH` carries its fields at the body's top level.
     'CURRENCY_MISMATCH',
     'SHIFT_NOT_OPEN',

package/dist/cjs/storefrontDesign.js

@@ -1,10 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STOREFRONT_PREVIEW_PROTOCOL_ERRORS = exports.STOREFRONT_PREVIEW_READ_OPERATIONS = 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.STOREFRONT_PREVIEW_PROTOCOL_ERRORS = exports.STOREFRONT_PREVIEW_READ_OPERATIONS = 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.isStorefrontPageSlug = exports.STOREFRONT_PAGE_SLUG_RE = exports.STOREFRONT_DESIGN_LIMITS = exports.STOREFRONT_SOCIAL_HOSTS = void 0;
 exports.createStorefrontDesignV1 = createStorefrontDesignV1;
 exports.parseStorefrontPreviewDocument = parseStorefrontPreviewDocument;
 exports.parseStorefrontPreviewMessage = parseStorefrontPreviewMessage;
 exports.acceptStorefrontPreviewMessage = acceptStorefrontPreviewMessage;
+/** The social kinds a contact may link, each to its own hosts; a contact links at most one per kind. */
+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'],
+};
 exports.STOREFRONT_DESIGN_LIMITS = {
     customPages: 20,
     pageAliases: 20,
@@ -43,9 +52,18 @@ exports.STOREFRONT_DESIGN_LIMITS = {
     contactAddress: 500,
     contactNote: 200,
     contactHours: 14,
-    contactSocials: 8,
+    /** One link per social kind, so the cap is the number of kinds. */
+    contactSocials: Object.keys(exports.STOREFRONT_SOCIAL_HOSTS).length,
     contactEmail: 254,
 };
+/**
+ * A custom page's slug: lowercase ASCII letters, digits and inner hyphens, 1 to
+ * `STOREFRONT_DESIGN_LIMITS.slug` characters, starting and ending alphanumeric. The one
+ * definition: the api's validators, its page renderer and the edge viewer request read it.
+ */
+exports.STOREFRONT_PAGE_SLUG_RE = /^[a-z0-9](?:[a-z0-9-]{0,78}[a-z0-9])?$/;
+const isStorefrontPageSlug = (value) => typeof value === 'string' && exports.STOREFRONT_PAGE_SLUG_RE.test(value);
+exports.isStorefrontPageSlug = isStorefrontPageSlug;
 exports.STOREFRONT_SECTION_TYPES = [
     'banner',
     'imageText',
@@ -124,14 +142,6 @@ exports.STOREFRONT_RESERVED_SLUGS = [
     'mantenimiento',
 ];
 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,

package/dist/cjs/storefrontSeo.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Information-page paths and the storefront's SEO inheritance chain — one
+ * definition for the server that renders a shared link's head and the editor
+ * that previews it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storefrontDefaultSeoDescription = exports.storefrontPagePath = exports.STOREFRONT_PAGE_PATH_PREFIX = void 0;
+exports.resolveStorefrontSeo = resolveStorefrontSeo;
+/** Path prefix of a published information page: `/pagina/<slug>`. */
+exports.STOREFRONT_PAGE_PATH_PREFIX = '/pagina/';
+/** The path an information page with `slug` is served at. The slug is neither validated nor encoded here. */
+const storefrontPagePath = (slug) => `${exports.STOREFRONT_PAGE_PATH_PREFIX}${slug}`;
+exports.storefrontPagePath = storefrontPagePath;
+/** The description a shop is shared with when neither the page nor the shop sets one. */
+const storefrontDefaultSeoDescription = (storeName) => `Comprá online en ${storeName}: catálogo, precios y stock actualizados.`;
+exports.storefrontDefaultSeoDescription = storefrontDefaultSeoDescription;
+const shopImage = (document) => {
+    if (document.seo.image)
+        return { image: document.seo.image, source: 'shop' };
+    if (document.branding.logo)
+        return { image: document.branding.logo, source: 'logo' };
+    return { image: null, source: 'default' };
+};
+/** Home's SEO — and the default every information page inherits field by field. */
+const shopSeo = (document, storeName) => {
+    const { seo } = document;
+    const image = shopImage(document);
+    return {
+        title: seo.title || storeName,
+        description: seo.description || (0, exports.storefrontDefaultSeoDescription)(storeName),
+        image: image.image,
+        noindex: seo.noindex === true,
+        source: {
+            title: seo.title ? 'shop' : 'default',
+            description: seo.description ? 'shop' : 'default',
+            image: image.source,
+            noindex: typeof seo.noindex === 'boolean' ? 'shop' : 'default',
+        },
+    };
+};
+function resolveStorefrontSeo(document, target, storeName) {
+    const shop = shopSeo(document, storeName);
+    if (target === 'home')
+        return shop;
+    const page = document.pages.find(({ id }) => id === target);
+    if (!page)
+        return undefined;
+    const own = page.seo;
+    const pageTitle = own?.title || page.title;
+    const pageNoindex = own?.noindex;
+    return {
+        title: pageTitle || shop.title,
+        description: own?.description || shop.description,
+        image: own?.image || shop.image,
+        noindex: typeof pageNoindex === 'boolean' ? pageNoindex : shop.noindex,
+        source: {
+            title: pageTitle ? 'page' : shop.source.title,
+            description: own?.description ? 'page' : shop.source.description,
+            image: own?.image ? 'page' : shop.source.image,
+            noindex: typeof pageNoindex === 'boolean' ? 'page' : shop.source.noindex,
+        },
+    };
+}

package/dist/cjs/storefrontTheme.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveStorefrontTheme = exports.storefrontContrastRatio = void 0;
+exports.resolveStorefrontTheme = exports.resolveStorefrontEffectiveSettings = exports.storefrontGlobalSettingsLayer = exports.storefrontContrastRatio = void 0;
 const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
 const channels = (color) => [
     Number.parseInt(color.slice(1, 3), 16),
@@ -66,14 +66,38 @@ const surfaceTokens = (background, settings, mode, surface, warnings) => {
     };
 };
 /**
- * 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.
+ * The GLOBAL design-settings layer of the platform globals row as `getPlatformGlobalsRow`
+ * returns it (`{ [key]: { value, ... } }`): each entry's `value`, kept only when it is a
+ * valid design setting, so a non-design global or a malformed value never reaches a theme.
  */
-const resolveStorefrontTheme = (overrides = {}) => {
-    const settings = (0, storefrontDesignRegistry_ts_1.resolveStorefrontDesignSettings)(overrides);
+const storefrontGlobalSettingsLayer = (globalsRow) => ({
+    layer: 'GLOBAL',
+    values: Object.fromEntries(Object.entries(globalsRow ?? {}).flatMap(([key, entry]) => {
+        const value = entry !== null && typeof entry === 'object' ? entry.value : undefined;
+        return (0, storefrontDesignRegistry_ts_1.validateStorefrontDesignSetting)(key, value) ? [[key, value]] : [];
+    })),
+});
+exports.storefrontGlobalSettingsLayer = storefrontGlobalSettingsLayer;
+/**
+ * The settings a storefront is served with: registry defaults, then the platform GLOBAL
+ * layer, then the design's own overrides. The one resolver behind the public envelope's
+ * `effectiveSettings`, the draft's `effectiveSettings` and the publish contrast report —
+ * a caller passes the globals row it read, never a layer stack of its own. The edge
+ * renderer's `theme-color` is design-only: its role reads no GLOBALS row.
+ */
+const resolveStorefrontEffectiveSettings = (overrides = {}, globalsRow) => (0, storefrontDesignRegistry_ts_1.resolveStorefrontDesignSettings)(overrides, [(0, exports.storefrontGlobalSettingsLayer)(globalsRow)]);
+exports.resolveStorefrontEffectiveSettings = resolveStorefrontEffectiveSettings;
+/**
+ * The storefront theme for a design's settings overrides, resolved through
+ * `resolveStorefrontEffectiveSettings`: the GLOBAL layer of `globalsRow` sits under the
+ * design, exactly as in the public envelope's `effectiveSettings`. Omitting `globalsRow`
+ * resolves defaults plus the design only — correct solely while no GLOBAL design setting
+ * is set, so a caller serving or reporting on a storefront passes the row (the edge
+ * renderer's `theme-color` is the one exception, design-only by its read grant). Passing
+ * already-effective settings as `overrides` rebuilds the same theme.
+ */
+const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
+    const settings = (0, exports.resolveStorefrontEffectiveSettings)(overrides, globalsRow);
     const warnings = [];
     const makeMode = (mode) => {
         const background = (requested) => mode === 'light' ? requested.toUpperCase() : mix(requested, '#000000', 0.9);