orionplace-svelte 0.7.2 → 0.7.3

package/README.md

@@ -519,6 +519,7 @@ data and actions; `orionplace/COMPONENTS.md` lists their customer paths.
 Page titles, descriptions and link-preview metadata follow the current page
 and selected language, including client navigation. Public events and banner
 images come from Application Load.
+Pages with a canonical address also link the same page in the other storefront languages (`hreflang`) and set `og:type` and `og:locale`; a journal article adds its publication date (`article:published_time`) and schema.org `BlogPosting` data. The store icon (`logos.ico`) is the page's `<link rel="icon">`. An unknown `?locale` opens the default language.
 
 ## Application Load starter
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orionplace-svelte",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "SvelteKit 2 storefront for your Orionplace marketplace: setup CLI, server API gateway, typed store and ready-made catalog, cart, checkout and account components in English and Russian, plus an Android app build.",
   "type": "module",
   "license": "MIT",

package/templates/src/lib/composables/useOrionplacePageSeo.svelte.ts

@@ -3,9 +3,13 @@ import { browser } from '$app/environment';
 import { computed, toValue } from '@/lib/orionplace/reactivity.svelte';
 import type { MaybeRefOrGetter } from '@/lib/orionplace/reactivity.svelte';
 import { useHead, useSeoMeta } from '@/lib/orionplace/navigation.svelte';
+import { useOrionplaceStore } from '@/lib/stores/orionplace.svelte';
 import {
   storefrontAbsoluteUrl,
+  storefrontAlternateLinks,
   storefrontCanonicalUrl,
+  storefrontOpenGraphLocale,
+  storefrontOpenGraphType,
   storefrontPageMetadata,
   storefrontPublicOrigin,
 } from '@/lib/utils/orionplace/pageSeo';
@@ -21,6 +25,9 @@ export function useOrionplacePageSeo(
     keywords?: MaybeRefOrGetter<string | undefined>;
     robots?: MaybeRefOrGetter<string | undefined>;
     image?: MaybeRefOrGetter<string | undefined>;
+    /** A journal article's dates (ISO 8601) for article:published_time. */
+    published?: MaybeRefOrGetter<string | undefined>;
+    modified?: MaybeRefOrGetter<string | undefined>;
     /**
      * The page's schema.org data (a record page, e.g. the product), built
      * from its canonical address and the visitor's origin. A page without a
@@ -29,6 +36,7 @@ export function useOrionplacePageSeo(
     structuredData?: (canonical: string, origin: string) => unknown;
   } = {},
 ) {
+  const store     = useOrionplaceStore();
   // The address the visitor used: the proxy's host during the server render.
   const origin    = browser
     ? window.location.origin
@@ -62,7 +70,18 @@ export function useOrionplacePageSeo(
     ogDescription: () => metadata.value.description,
     ogImage: () => storefrontAbsoluteUrl(toValue(values.image), origin),
     ogUrl: () => canonical.value,
+    ogType: () => storefrontOpenGraphType(toValue(page)),
+    ogLocale: () => storefrontOpenGraphLocale(toValue(locale)),
+    articlePublishedTime: () => toValue(values.published),
+    articleModifiedTime: () => toValue(values.modified),
   };
+  // The page in the storefront's other languages, beside the canonical one.
+  const alternates = computed(() =>
+    storefrontAlternateLinks(
+      canonical.value,
+      Object.keys(store.init?.locale ?? {}),
+    ),
+  );
   const structured = computed(() =>
     canonical.value && values.structuredData
       ? structuredDataJson(values.structuredData(canonical.value, origin))
@@ -70,7 +89,16 @@ export function useOrionplacePageSeo(
   );
   useSeoMeta(seo);
   useHead(() => ({
-    link: canonical.value ? [{ rel: 'canonical', href: canonical.value }] : [],
+    link: canonical.value
+      ? [
+          { rel: 'canonical', href: canonical.value },
+          ...alternates.value.map((alternate) => ({
+            rel: 'alternate',
+            hreflang: alternate.hreflang,
+            href: alternate.href,
+          })),
+        ]
+      : [],
     jsonLd: structured.value || undefined,
   }));
 }

package/templates/src/lib/layouts/StorefrontPageHead.svelte

@@ -1,7 +1,11 @@
 <script lang="ts">
   import type { PageHead } from '@/lib/orionplace/navigation.svelte';
+  import { storefrontIconLinks } from '@/lib/utils/orionplace/pageSeo';
 
-  let { metadata }: { metadata: PageHead } = $props();
+  // `icon`: the store's icon from App Load (logos.ico).
+  let { metadata, icon }: { metadata: PageHead; icon?: string | null } =
+    $props();
+  const iconLinks   = $derived(storefrontIconLinks(icon));
 
   // The JSON is escaped by structuredDataJson, so it cannot close the tag.
   const scriptOpen  = '<script type="application/ld+json">';
@@ -13,7 +17,7 @@
 
   {#each metadata.meta ?? [] as meta}
     {#if meta.content}
-      {#if meta.property || meta.name?.startsWith('og:')}
+      {#if meta.property || /^(?:og|article):/.test(meta.name ?? '')}
         <meta
           property={meta.property ?? meta.name}
           content={meta.content}
@@ -31,12 +35,20 @@
     {@html scriptOpen + metadata.jsonLd + scriptClose}
   {/if}
 
-  {#each metadata.link ?? [] as link (link.rel)}
+  {#each metadata.link ?? [] as link (`${link.rel} ${link.hreflang ?? ''}`)}
     {#if link.href}
       <link
         rel={link.rel}
+        hreflang={link.hreflang}
         href={link.href}
       />
     {/if}
   {/each}
+
+  {#each iconLinks as link (link.key)}
+    <link
+      rel={link.rel}
+      href={link.href}
+    />
+  {/each}
 </svelte:head>

package/templates/src/lib/orionplace/appLoadClient.ts

@@ -1,5 +1,6 @@
 import {
   AppLoadError,
+  appLoadRejectedLocale,
   appLoadResult,
   inspectAppLoad,
 } from '@/lib/orionplace/appLoadResult';
@@ -68,6 +69,10 @@ export async function requestBrowserAppLoad(
     });
   }
   const failure     = inspectAppLoad(body, status);
+  // A language the storefront does not have opens its default language.
+  if (failure && locale && appLoadRejectedLocale(failure)) {
+    return requestBrowserAppLoad(signal);
+  }
   if (failure) {
     throw new AppLoadError('Marketplace initialization failed.', failure);
   }

package/templates/src/lib/orionplace/appLoadResult.ts

@@ -108,3 +108,13 @@ export class AppLoadError extends Error {
     this.data = data;
   }
 }
+
+/**
+ * Whether App Load refused the request's language (`?lang=` of a language the
+ * storefront does not have): the backend answers it with field errors and
+ * HTTP 452. The language is the only client value App Load reads, so the
+ * storefront loads again without it.
+ */
+export function appLoadRejectedLocale(failure: AppLoadFailure): boolean {
+  return failure.kind === 'validation' || failure.httpStatus === 452;
+}

package/templates/src/lib/orionplace/appLoadServer.ts

@@ -1,6 +1,10 @@
 import { env } from '$env/dynamic/private';
 import { forwardMarketplace } from '@orionplace-runtime/marketplace.mjs';
-import { appLoadResult, inspectAppLoad } from '@/lib/orionplace/appLoadResult';
+import {
+  appLoadRejectedLocale,
+  appLoadResult,
+  inspectAppLoad,
+} from '@/lib/orionplace/appLoadResult';
 import type { OrionplaceSnapshot } from '@/lib/orionplace/appLoadData';
 import type { AppLoadRequest } from '@/lib/interfaces/orionplace/transport';
 import type { Cookies, RequestEvent } from '@sveltejs/kit';
@@ -20,9 +24,13 @@ const FORWARDED = [
   'x-tz',
 ];
 
-function buildRequest(event: RequestEvent, signal: AbortSignal): Request {
+function buildRequest(
+  event: RequestEvent,
+  signal: AbortSignal,
+  withLocale = true,
+): Request {
   const url     = new URL('/api/appload', event.url.origin);
-  const locale  = event.url.searchParams.get('locale');
+  const locale  = withLocale ? event.url.searchParams.get('locale') : null;
   if (locale) {
     url.searchParams.set('lang', locale);
   }
@@ -112,13 +120,14 @@ export interface ServerAppLoad extends OrionplaceSnapshot {
 export async function loadOrionplaceAppLoad(
   event: RequestEvent,
   signal?: AbortSignal,
+  withLocale = true,
 ): Promise<ServerAppLoad> {
   const timeout     = AbortSignal.timeout(35_000);
   const combined    = signal ? AbortSignal.any([signal, timeout]) : timeout;
   let response: Response;
   try {
     response = await forwardMarketplace(
-      buildRequest(event, combined),
+      buildRequest(event, combined, withLocale),
       {
         mimicFrontDomain: env.MIMIC_FRONT_DOMAIN ?? '',
       },
@@ -140,6 +149,16 @@ export async function loadOrionplaceAppLoad(
     body = null;
   }
   const failure     = inspectAppLoad(body, response.status);
+  // An address with a language the storefront does not have (`?locale=xx`)
+  // opens in the storefront's default language instead of the 503 page.
+  if (
+    failure &&
+    withLocale &&
+    event.url.searchParams.get('locale') &&
+    appLoadRejectedLocale(failure)
+  ) {
+    return loadOrionplaceAppLoad(event, signal, false);
+  }
   if (failure) {
     return { result: null, failure, cookies };
   }

package/templates/src/lib/orionplace/navigation.svelte.ts

@@ -103,8 +103,9 @@ const headKey = Symbol('orionplace-head');
 export interface PageHead {
   title?: string;
   meta?: Record<string, any>[];
-  // <link> tags, one per `rel` (the canonical address).
-  link?: { rel: string; href: string }[];
+  // <link> tags, one per `rel` and `hreflang` (the canonical address and
+  // the page in other languages).
+  link?: { rel: string; href: string; hreflang?: string }[];
   // The page's schema.org data as JSON (structuredDataJson), if it has any.
   jsonLd?: string;
 }
@@ -114,7 +115,7 @@ function collectHead(readers: HeadReader[]): PageHead {
   let title: string | undefined;
   let jsonLd: string | undefined;
   const meta = new Map<string, Record<string, any>>();
-  const link = new Map<string, { rel: string; href: string }>();
+  const link = new Map<string, { rel: string; href: string; hreflang?: string }>();
   for (const read of readers) {
     const head = read();
     title      = head.title ?? title;
@@ -126,7 +127,7 @@ function collectHead(readers: HeadReader[]): PageHead {
       }
     }
     for (const tag of head.link ?? []) {
-      link.set(tag.rel, tag);
+      link.set(`${tag.rel} ${tag.hreflang ?? ''}`, tag);
     }
   }
   return {
@@ -180,6 +181,13 @@ export function useHead(source: PageHead | (() => PageHead)) {
     return () => untrack(() => registry.remove(read));
   });
 }
+// The other Open Graph names the pages set (useSeoMeta keys, as in Nuxt).
+const seoMetaNames: Record<string, string> = {
+  ogType: 'og:type',
+  ogLocale: 'og:locale',
+  articlePublishedTime: 'article:published_time',
+  articleModifiedTime: 'article:modified_time',
+};
 export function useSeoMeta(source: Record<string, any>) {
   useHead(() => ({
     title: typeof source.title === 'function' ? source.title() : source.title,
@@ -195,7 +203,7 @@ export function useSeoMeta(source: Record<string, any>) {
                 ? 'og:image'
                 : name === 'ogUrl'
                   ? 'og:url'
-                  : name,
+                  : (seoMetaNames[name] ?? name),
         content: typeof value === 'function' ? value() : value,
       })),
   }));

package/templates/src/lib/utils/orionplace/pageSeo.ts

@@ -263,17 +263,157 @@ const pageCopy = {
       'error, store',
     ],
   },
+  es: {
+    tariffs: [
+      'Planes de suscripción',
+      'Precios por periodo, periodos de prueba y opciones de cada plan.',
+      'planes, suscripciones, prueba',
+    ],
+    tariff: [
+      'Plan de suscripción',
+      'Descripción, funciones, periodos y opciones de un plan de suscripción.',
+      'plan, suscripción, periodo',
+    ],
+    subscriptions: [
+      'Mis suscripciones',
+      'Fechas de las suscripciones y renovación automática.',
+      'suscripciones, cuenta',
+    ],
+    sellers: ['Vendedores', 'Vendedores y sus productos.', 'vendedores, productos'],
+    stores: [
+      'Tiendas',
+      'Direcciones, contactos y horarios de las tiendas.',
+      'tiendas, direcciones',
+    ],
+    catalog: ['Catálogo', 'Categorías de productos de la tienda.', 'catálogo, categorías'],
+    activity: [
+      'Mi actividad',
+      'Códigos promocionales, reseñas e historial de accesos del cliente.',
+      'cuenta, códigos promocionales, reseñas, accesos',
+    ],
+    promo: [
+      'Productos del código promocional',
+      'Productos de la tienda a los que se aplica la oferta del código promocional.',
+      'código promocional, oferta, productos',
+    ],
+    wishlist: [
+      'Favoritos',
+      'Productos guardados y avisos de disponibilidad.',
+      'favoritos, productos',
+    ],
+    contact: [
+      'Contacto',
+      'Datos de contacto de la empresa y formulario de mensajes de la tienda.',
+      'contacto, mensaje',
+    ],
+    privacy: [
+      'Política de privacidad',
+      'Qué datos recibe la tienda, para qué, a quién los transmite y qué cookies usa el sitio.',
+      'datos personales, privacidad, cookies',
+    ],
+    unsubscribe: [
+      'Preferencias de correo',
+      'Darse de baja de los correos de la tienda.',
+      'correos, baja',
+    ],
+    tickets: [
+      'Soporte',
+      'Conversaciones del usuario con el soporte.',
+      'soporte, conversaciones',
+    ],
+    orders: [
+      'Mis pedidos',
+      'Historial de pedidos y artículos comprados.',
+      'pedidos, compras',
+    ],
+    cart: ['Carrito', 'Artículos y pago del pedido.', 'carrito, pago'],
+    addresses: [
+      'Mis direcciones',
+      'Direcciones de entrega guardadas.',
+      'direcciones, entrega',
+    ],
+    wallet: [
+      'Monedero y pagos',
+      'Saldo e historial de pagos.',
+      'monedero, pagos',
+    ],
+    home: [
+      'Tienda',
+      'Categorías y productos de la tienda.',
+      'tienda, catálogo, productos',
+    ],
+    browse: [
+      'Resultados de búsqueda',
+      'Productos que coinciden con la búsqueda y los filtros elegidos.',
+      'búsqueda de productos, filtros, catálogo',
+    ],
+    featured: [
+      'Destacados',
+      'Productos de las categorías que el cliente ha buscado en la tienda.',
+      'recomendaciones, productos, filtros',
+    ],
+    category: [
+      'Categoría de productos',
+      'Productos y filtros disponibles de la categoría elegida.',
+      'categoría, productos, filtros',
+    ],
+    journal: [
+      'Revista',
+      'Publicaciones de la tienda con títulos, resúmenes y tiempo de lectura.',
+      'revista, publicaciones, artículos',
+    ],
+    publication: [
+      'Publicación de la revista',
+      'Un artículo de la revista de la tienda.',
+      'revista, publicación, artículo',
+    ],
+    product: [
+      'Ficha de producto',
+      'Descripción, precio, variantes y disponibilidad del producto.',
+      'producto, precio, disponibilidad',
+    ],
+    manufacturers: [
+      'Fabricantes',
+      'Fabricantes de la tienda con logotipos e índice alfabético.',
+      'fabricantes, marcas, índice alfabético',
+    ],
+    profile: [
+      'Perfil personal',
+      'Datos personales, correo, notificaciones y contraseña de la cuenta.',
+      'perfil, cuenta, ajustes',
+    ],
+    logout: [
+      'Cerrar sesión',
+      'Fin de la sesión y vuelta a la página principal.',
+      'cuenta, cerrar sesión, sesión',
+    ],
+    notFound: [
+      'Página no encontrada',
+      'No hay ninguna página de la tienda en esta dirección.',
+      'página no encontrada, 404',
+    ],
+    error: [
+      'Algo salió mal',
+      'No se pudo mostrar la página de la tienda.',
+      'error, tienda',
+    ],
+  },
 } as const;
 
 export type StorefrontSeoPage = keyof typeof pageCopy.en;
 
+/** The page copy for a storefront language; languages without one use English. */
+function storefrontCopyLanguage(locale: string): keyof typeof pageCopy {
+  const language = locale.toLowerCase().split(/[-_]/)[0];
+  return language === 'ru' || language === 'es' ? language : 'en';
+}
+
 export function storefrontPageMetadata(
   page: StorefrontSeoPage,
   locale: string,
   values: { title?: string; description?: string; keywords?: string } = {},
 ) {
-  const copy  =
-    pageCopy[locale.toLowerCase().startsWith('ru') ? 'ru' : 'en'][page];
+  const copy  = pageCopy[storefrontCopyLanguage(locale)][page];
   const title = plainText(values.title ?? '') || copy[0];
 
   return {
@@ -350,3 +490,122 @@ export function storefrontCanonicalUrl(
   }
   return url.toString();
 }
+
+/** og:type of a page: a product and a journal article have their own kinds. */
+export function storefrontOpenGraphType(
+  page: StorefrontSeoPage,
+): 'product' | 'article' | 'website' {
+  if (page === 'product') {
+    return 'product';
+  }
+  return page === 'publication' ? 'article' : 'website';
+}
+
+const openGraphRegions: Record<string, string> = {
+  de: 'de_DE',
+  en: 'en_US',
+  es: 'es_ES',
+  fr: 'fr_FR',
+  it: 'it_IT',
+  kk: 'kk_KZ',
+  pl: 'pl_PL',
+  pt: 'pt_PT',
+  ru: 'ru_RU',
+  tr: 'tr_TR',
+  uk: 'uk_UA',
+  zh: 'zh_CN',
+};
+
+/** og:locale (`language_TERRITORY`) of a storefront language, when it is known. */
+export function storefrontOpenGraphLocale(locale: string): string | undefined {
+  return openGraphRegions[locale.toLowerCase().split(/[-_]/)[0]!];
+}
+
+/**
+ * The same page in every storefront language (hreflang), for a page with a
+ * canonical address: the canonical address with each language's `?locale=`,
+ * as the sitemap lists them. Search engines that ignore the sitemap's
+ * language links (Yandex) read these. A single language gives none.
+ */
+export function storefrontAlternateLinks(
+  canonical: string | undefined,
+  locales: string[],
+): { hreflang: string; href: string }[] {
+  const codes = [
+    ...new Set(
+      locales
+        .map((code) => code.trim())
+        .filter((code) => /^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/i.test(code)),
+    ),
+  ];
+  if (!canonical || codes.length < 2) {
+    return [];
+  }
+  return codes.map((code) => {
+    const url = new URL(canonical);
+    url.searchParams.set('locale', code);
+    return { hreflang: code, href: url.toString() };
+  });
+}
+
+/**
+ * A backend date (`d.m.Y`, e.g. `22.09.2026`) as an ISO 8601 date
+ * (`2026-09-22`); anything else gives `undefined`. A date without a time
+ * cannot disagree with the visible date in another time zone.
+ */
+export function storefrontIsoDate(
+  value: string | null | undefined,
+): string | undefined {
+  const match = /^(\d{2})\.(\d{2})\.(\d{4})$/.exec((value ?? '').trim());
+  return match ? `${match[3]}-${match[2]}-${match[1]}` : undefined;
+}
+
+/**
+ * schema.org BlogPosting of a journal article (Google "Article" structured
+ * data): headline, cover, dates, and the store as author and publisher.
+ */
+export function storefrontArticleData(input: {
+  canonical: string;
+  origin: string;
+  headline: string;
+  description?: string;
+  image?: string;
+  published?: string;
+  modified?: string;
+  locale: string;
+  storeName?: string;
+}): Record<string, unknown> {
+  const store = {
+    '@type': 'Organization',
+    name: input.storeName || new URL(input.origin).hostname,
+    url: `${input.origin}/`,
+  };
+  const modified = input.modified || input.published;
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BlogPosting',
+    '@id': `${input.canonical}#article`,
+    mainEntityOfPage: input.canonical,
+    url: input.canonical,
+    headline: input.headline.slice(0, 110),
+    ...(input.description ? { description: input.description } : {}),
+    ...(input.image ? { image: [input.image] } : {}),
+    ...(input.published ? { datePublished: input.published } : {}),
+    ...(modified ? { dateModified: modified } : {}),
+    inLanguage: input.locale,
+    author: store,
+    publisher: store,
+  };
+}
+
+/**
+ * The store's icon (App Load `logos.ico`) as `<link rel="icon">` tags: search
+ * engines read the icon from the home page. Only a complete http(s) address
+ * is used; the type is left out, so it cannot disagree with the file.
+ */
+export function storefrontIconLinks(
+  icon: string | null | undefined,
+): { key: string; rel: string; href: string }[] {
+  const href = storefrontAbsoluteUrl(icon, '');
+  return href ? [{ key: 'icon', rel: 'icon', href }] : [];
+}

package/templates/src/routes/+layout.svelte

@@ -134,7 +134,10 @@
 </OrionplaceThemeProvider>
 
 <!-- Render after the page registers its metadata during server rendering. -->
-<StorefrontPageHead metadata={metadata.value} />
+<StorefrontPageHead
+  metadata={metadata.value}
+  icon={marketplace.init?.logos?.ico}
+/>
 
 <style>
   .storefront-progress {

package/templates/src/routes/journal/[id]/+page.svelte

@@ -7,6 +7,11 @@
   import { useOrionplaceStorefront } from '@/lib/composables/useOrionplaceStorefront.svelte';
   import { useOrionplaceServerData } from '@/lib/composables/useOrionplaceServerData.svelte';
   import { requestBlogPost } from '@/lib/utils/orionplace/blogLayout';
+  import {
+    storefrontAbsoluteUrl,
+    storefrontArticleData,
+    storefrontIsoDate,
+  } from '@/lib/utils/orionplace/pageSeo';
   import {
     getAvailableNestedValueFromObject,
     plainText,
@@ -77,6 +82,37 @@
         ),
       ).slice(0, 160),
     image: () => cover.value,
+    published: () => storefrontIsoDate(post.value?.date_created?.date),
+    modified: () =>
+      storefrontIsoDate(post.value?.date_updated?.date) ??
+      storefrontIsoDate(post.value?.date_created?.date),
+    // The article as schema.org BlogPosting, with the store as its author.
+    structuredData: (canonical, origin) =>
+      post.value
+        ? storefrontArticleData({
+            canonical,
+            origin,
+            headline:
+              getAvailableNestedValueFromObject(
+                post.value.locale,
+                store.localeCode,
+                'post_title',
+              ) ?? '',
+            description:
+              plainText(
+                getAvailableNestedValueFromObject(
+                  post.value.locale,
+                  store.localeCode,
+                  'post_preview_text',
+                ),
+              ).slice(0, 160) || undefined,
+            image: storefrontAbsoluteUrl(cover.value, origin),
+            published: storefrontIsoDate(post.value.date_created?.date),
+            modified: storefrontIsoDate(post.value.date_updated?.date),
+            locale: store.localeCode,
+            storeName: store.init?.contact?.company_name,
+          })
+        : undefined,
   });
 
   // An invalid ID, or an article that blog_posts_get does not return,