@commercelayer/agent-cli 0.3.0 → 0.5.0

package/dist/api/stub/theme.js

@@ -4,34 +4,134 @@
 // at /products/<sku>. Prices come from what is applied; "Buy" opens the cart permalink.
 // A product without an image shows its tile, and an unset hero the generated one, both
 // drawn at /tiles/ (renderTile) as the store host does.
-const esc = (t) => String(t ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[c]);
+import { baseLanguage, cookieLocale, COOKIE, localeOfCountry, localesOf, texts } from './locale.js';
+export const esc = (t) => String(t ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[c]);
 /** Black or white, whichever reads better on the accent. */
 function onAccent(hex) {
     const h = hex.length === 4 ? hex.slice(1).replace(/./g, (c) => c + c) : hex.slice(1);
     const [r, g, b] = [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16) / 255).map((c) => (c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4));
     return 0.2126 * r + 0.7152 * g + 0.0722 * b > 0.179 ? '#000000' : '#ffffff';
 }
-export function renderTheme(r, path, search) {
-    const products = Object.values(r.applied?.products ?? {});
+/** The selector's strings, in the store's base language; other languages fall back to en, like the store. */
+const UI = {
+    en: { choose: 'Choose your country', shipping: (c) => `Shipping to ${c}?` },
+    it: { choose: 'Scegli il tuo paese', shipping: (c) => `Spedisci in ${c}?` },
+    fr: { choose: 'Choisissez votre pays', shipping: (c) => `Livraison en ${c} ?` },
+    de: { choose: 'Wählen Sie Ihr Land', shipping: (c) => `Versand nach ${c}?` },
+    es: { choose: 'Elige tu país', shipping: (c) => `¿Envío a ${c}?` },
+};
+const countryName = (cc, ll) => {
+    try {
+        return new Intl.DisplayNames([ll], { type: 'region' }).of(cc) ?? cc;
+    }
+    catch {
+        return cc;
+    }
+};
+const tag = (l) => `${l.language}-${l.country}`;
+const alternates = (locales, rest) => [...locales.map((l) => `<link rel="alternate" hreflang="${tag(l)}" href="/${l.path}${rest === '/' ? '/' : rest}">`), '<link rel="alternate" hreflang="x-default" href="/">'].join('\n');
+/**
+ * The hosted theme's routes. With locales (two or more countries, or one): the selector at /,
+ * the pages under /<cc>-<ll>/, a cookie that remembers the choice, unprefixed product and
+ * category paths sent to the remembered or first locale. Without (not applied since locales
+ * exist): the site as it was. null when the path is not the theme's.
+ */
+export function renderTheme(r, path, search, headers = {}) {
+    const locales = localesOf(r);
+    if (!locales.length)
+        return renderPage(r, path, search, null);
+    const redirect = (to, extra = {}) => ({ status: 302, headers: { location: to, 'cache-control': 'no-store', ...extra }, body: '' });
+    if (path === '/') {
+        if (locales.length === 1)
+            return redirect(`/${locales[0].path}/`);
+        const chosen = cookieLocale(r, headers.cookie);
+        if (chosen && !search.has('change'))
+            return redirect(`/${chosen.path}/`, { vary: 'Cookie' });
+        const page = selector(r, locales, headers['cf-ipcountry']);
+        page.headers.vary = 'Cookie';
+        return page;
+    }
+    const m = path.match(/^\/([a-z]{2})-([a-z]{2})(\/.*)?$/);
+    if (m) {
+        const l = localeOfCountry(r, m[1]);
+        if (!l)
+            return null;
+        const rest = m[3] ?? '/';
+        if (l.language !== m[2])
+            return redirect(`/${l.path}${rest === '/' ? '/' : rest}`);
+        const page = renderPage(r, rest, search, l);
+        if (page)
+            page.headers['set-cookie'] = `${COOKIE}=${l.path}; Path=/; Max-Age=31536000; SameSite=Lax; Secure`;
+        return page;
+    }
+    if (/^\/(products|categories)\//.test(path))
+        return redirect(`/${(cookieLocale(r, headers.cookie) ?? locales[0]).path}${path}`, { vary: 'Cookie' });
+    return null;
+}
+function selector(r, locales, ipCountry) {
+    const base = baseLanguage(r);
+    const ui = UI[base] ?? UI.en;
     const markets = Object.values(r.applied?.markets ?? {});
+    const near = ipCountry ? localeOfCountry(r, ipCountry) : undefined;
+    const link = (l) => `<a href="/${l.path}/" hreflang="${tag(l)}" lang="${l.language}">${esc(countryName(l.country, base))}</a>`;
+    const body = `<main class="selector"><h1>${esc(ui.choose)}</h1>${near ? `<p class="suggestion"><a href="/${near.path}/">${esc(ui.shipping(countryName(near.country, base)))}</a></p>` : ''}${markets
+        .map((mk) => {
+        const ls = locales.filter((l) => l.market === mk.code);
+        return ls.length ? `<section><h2>${esc(mk.name)} (${esc(mk.currency)})</h2><ul>${ls.map((l) => `<li>${link(l)}</li>`).join('')}</ul></section>` : '';
+    })
+        .join('')}</main>`;
+    return page(r, { lang: base, title: r.name ?? r.org, head: alternates(locales, '/'), header: '', body, description: ui.choose });
+}
+function page(r, o) {
     const theme = r.theme ?? {};
     const color = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(theme.color ?? '') ? theme.color : '#2f5d50';
     const name = r.name ?? r.org;
-    const market = markets.find((m) => m.code === search.get('market')) ?? markets[0];
-    const keep = market && market !== markets[0] ? `?market=${encodeURIComponent(market.code)}` : '';
-    const price = (p) => (market && p.prices[market.currency] !== undefined ? `${market.currency} ${p.prices[market.currency].toFixed(2)}` : '');
+    const badge = theme.badge ? ` <span class="badge">${esc(theme.badge)}</span>` : '';
+    const logo = (theme.logo ? `<img class="logo" src="/${esc(theme.logo.replace(/^\//, ''))}" alt="${esc(name)}">` : `<span class="wordmark">${esc(name)}</span>`) + badge;
+    const html = `<!doctype html>
+<html lang="${esc(o.lang)}">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${esc(o.title)}</title>
+<meta name="description" content="${esc(o.description)}">
+${o.head ? `${o.head}\n` : ''}<!-- c11r stub: a stand-in for the hosted theme. -->
+<style>:root{--accent:${color};--on-accent:${onAccent(color)}}body{margin:0;font-family:system-ui,sans-serif;color:#16181d}header{display:flex;justify-content:space-between;padding:16px 24px}.logo{max-height:40px}.badge{margin-left:8px;padding:2px 8px;border-radius:999px;background:var(--accent);color:var(--on-accent);font-size:12px;vertical-align:middle}.hero{padding:64px 24px;background-size:cover}.band{background:var(--accent);color:var(--on-accent)}.grid{display:grid;gap:24px;grid-template-columns:repeat(auto-fill,minmax(220px,1fr))}.buy{background:var(--accent);color:var(--on-accent);padding:8px 14px}main{padding:24px}</style>
+</head>
+<body>
+<header><a href="${o.home ?? '/'}">${logo}</a>${o.header}</header>
+${o.body}
+</body>
+</html>
+`;
+    return { status: 200, headers: { 'content-type': 'text/html; charset=utf-8' }, body: html };
+}
+/** The home page and the product pages, for a locale (prefixed paths, its market, its language) or for none (the site as it was). */
+function renderPage(r, path, search, locale) {
+    const products = Object.values(r.applied?.products ?? {});
+    const markets = Object.values(r.applied?.markets ?? {});
+    const theme = r.theme ?? {};
+    const name = r.name ?? r.org;
+    const base = baseLanguage(r);
+    const ll = locale?.language ?? base;
+    const market = locale ? r.applied?.markets[locale.market] : (markets.find((m) => m.code === search.get('market')) ?? markets[0]);
+    const prefix = locale ? `/${locale.path}` : '';
+    const keep = !locale && market && market !== markets[0] ? `?market=${encodeURIComponent(market.code)}` : '';
+    // Under a locale, prices as that country writes them (14,50 € on /it-it/); the site as it was keeps EUR 14.50.
+    const money = (amount, currency) => (locale ? new Intl.NumberFormat(tag(locale), { style: 'currency', currency }).format(amount) : `${currency} ${amount.toFixed(2)}`);
+    const price = (p) => (market && p.prices[market.currency] !== undefined ? money(p.prices[market.currency], market.currency) : '');
     const tagline = theme.tagline ?? `Ships to ${markets.flatMap((m) => m.countries).join(', ')}`;
-    const logo = theme.logo ? `<img class="logo" src="/${esc(theme.logo.replace(/^\//, ''))}" alt="${esc(name)}">` : `<span class="wordmark">${esc(name)}</span>`;
     const img = (url) => (/^https?:/.test(url) ? url : `/${url}`);
-    const image = (p) => p.image_url ? `<img src="${esc(img(p.image_url))}" alt="${esc(p.name)}">` : `<span class="placeholder"><img src="/tiles/${esc(encodeURIComponent(p.sku))}.svg" alt="${esc(p.name)}" loading="lazy"></span>`;
-    const card = (p) => `<article class="product"><a href="/products/${encodeURIComponent(p.sku)}${keep}">${image(p)}<h3>${esc(p.name)}</h3></a><p class="price">${esc(price(p))}</p><a class="buy" href="/buy/${encodeURIComponent(p.sku)}:1">Buy</a></article>`;
+    const lang = ll === base ? '' : `?lang=${ll}`;
+    const image = (p) => p.image_url ? `<img src="${esc(img(p.image_url))}" alt="${esc(texts(p, ll).name)}">` : `<span class="placeholder"><img src="/tiles/${esc(encodeURIComponent(p.sku))}.svg${lang}" alt="${esc(texts(p, ll).name)}" loading="lazy"></span>`;
+    const card = (p) => `<article class="product"><a href="${prefix}/products/${encodeURIComponent(p.sku)}${keep}">${image(p)}<h3>${esc(texts(p, ll).name)}</h3></a><p class="price">${esc(price(p))}</p><a class="buy" href="/buy/${encodeURIComponent(p.sku)}:1">Buy</a></article>`;
     let title = name;
     let body;
     const m = path.match(/^\/products\/([^/]+)$/);
     if (path === '/') {
         const groups = new Map();
         for (const p of products) {
-            const top = p.category?.split(' > ')[0] ?? 'Other';
+            const top = texts(p, ll).category?.split(' > ')[0] ?? 'Other';
             groups.set(top, [...(groups.get(top) ?? []), p]);
         }
         const hero = `<section class="hero" style="background-image:url('${esc(theme.hero ? img(theme.hero) : '/tiles/hero.svg')}')">`;
@@ -41,32 +141,22 @@ export function renderTheme(r, path, search) {
         const p = r.applied?.products[decodeURIComponent(m[1])];
         if (!p)
             return null;
-        title = `${p.name} · ${name}`;
-        body = `<main class="product-page">${image(p)}<div>${p.category ? `<p class="category">${esc(p.category)}</p>` : ''}<h1>${esc(p.name)}</h1>${p.description ? `<p>${esc(p.description)}</p>` : ''}<p class="price">${esc(price(p))}</p><a class="buy" href="/buy/${encodeURIComponent(p.sku)}:1">Buy</a></div></main>`;
+        const t = texts(p, ll);
+        title = `${t.name} · ${name}`;
+        body = `<main class="product-page">${image(p)}<div>${t.category ? `<p class="category">${esc(t.category)}</p>` : ''}<h1>${esc(t.name)}</h1>${t.description ? `<p>${esc(t.description)}</p>` : ''}<p class="price">${esc(price(p))}</p><a class="buy" href="/buy/${encodeURIComponent(p.sku)}:1">Buy</a></div></main>`;
     }
     else
         return null;
-    const html = `<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>${esc(title)}</title>
-<meta name="description" content="${esc(tagline)}">
-<!-- c11r stub: a stand-in for the hosted theme. -->
-<style>:root{--accent:${color};--on-accent:${onAccent(color)}}body{margin:0;font-family:system-ui,sans-serif;color:#16181d}header{display:flex;justify-content:space-between;padding:16px 24px}.logo{max-height:40px}.hero{padding:64px 24px;background-size:cover}.band{background:var(--accent);color:var(--on-accent)}.grid{display:grid;gap:24px;grid-template-columns:repeat(auto-fill,minmax(220px,1fr))}.buy{background:var(--accent);color:var(--on-accent);padding:8px 14px}main{padding:24px}</style>
-</head>
-<body>
-<header><a href="/${keep}">${logo}</a><nav>${markets.map((x) => `<a href="?market=${encodeURIComponent(x.code)}">${esc(x.name)}</a>`).join(' ')}</nav></header>
-${body}
-</body>
-</html>
-`;
-    return { status: 200, headers: { 'content-type': 'text/html; charset=utf-8' }, body: html };
+    const header = locale
+        ? localesOf(r).length > 1
+            ? `<nav><a class="country" href="/?change">${esc(countryName(locale.country, ll))} · ${esc(market?.currency ?? '')}</a></nav>`
+            : ''
+        : `<nav>${markets.map((x) => `<a href="?market=${encodeURIComponent(x.code)}">${esc(x.name)}</a>`).join(' ')}</nav>`;
+    return page(r, { lang: locale ? tag(locale) : 'en', title, head: locale ? alternates(localesOf(r), path) : '', header, body, description: tagline, home: `${prefix}/${keep}` });
 }
 const xml = (t) => String(t ?? '').replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&apos;' })[c]);
 /** /tiles/<sku>.svg and /tiles/hero.svg: a plain stand-in for the store host's generated tiles. */
-export function renderTile(r, path) {
+export function renderTile(r, path, search) {
     const m = path.match(/^\/tiles\/([^/]+)\.svg$/);
     if (!m)
         return null;
@@ -86,7 +176,7 @@ export function renderTile(r, path) {
         const p = r.applied?.products[sku];
         if (!p)
             return null;
-        svg = `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1200" viewBox="0 0 1200 1200"><rect width="1200" height="1200" fill="${color}" fill-opacity="0.08"/><text x="600" y="600" text-anchor="middle" font-family="system-ui, sans-serif" font-size="72" fill="${color}">${xml(p.name.slice(0, 60))}</text></svg>`;
+        svg = `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1200" viewBox="0 0 1200 1200"><rect width="1200" height="1200" fill="${color}" fill-opacity="0.08"/><text x="600" y="600" text-anchor="middle" font-family="system-ui, sans-serif" font-size="72" fill="${color}">${xml(texts(p, search?.get('lang') ?? '').name.slice(0, 60))}</text></svg>`;
     }
     return { status: 200, headers, body: svg };
 }

package/dist/api/stub/ucp.js

@@ -8,7 +8,8 @@ import { contentDigest, signHeaders } from '../../ucp/signing.js';
 import { strip } from './db.js';
 import { json } from './http.js';
 import * as shop from './shopping.js';
-import { renderTheme, renderTile } from './theme.js';
+import { esc, renderTheme, renderTile } from './theme.js';
+import { ucpLanguage } from './locale.js';
 const SCOPES = ['dev.ucp.shopping.order:read', 'dev.ucp.shopping.order:manage'];
 const OUR_CAPABILITIES = [...SHOPPING_CAPABILITIES, 'dev.ucp.common.ask', ...Object.keys(EXTENSIONS), 'dev.ucp.common.identity_linking', 'dev.ucp.shopping.permalink'];
 // ---------- profile
@@ -107,8 +108,11 @@ function handleService(req, r, origin, path) {
             return { status: seen.status, headers: { ...seen.headers, 'idempotent-replayed': 'true' }, body: seen.body };
         }
     }
-    // 3. The operation.
+    // 3. The operation, in the language the platform asked for (or the buyer's country's, or the base).
+    ctx.language = ucpLanguage(r, parsed?.context, req.headers['accept-language']);
+    ctx.country = typeof parsed?.context?.address_country === 'string' ? parsed.context.address_country : undefined;
     const res = dispatch(ctx, req.method, path, parsed);
+    res.headers['content-language'] = ctx.language;
     if (mutating && key)
         r.ucp.idempotency[`${req.method} ${path} ${key}`] = { digest, status: res.status, headers: res.headers, body: res.body };
     return res;
@@ -303,14 +307,21 @@ function handlePermalink(req, r, origin, path) {
     return { status: 303, headers: { location: target, ...safe }, body: '' };
 }
 const MIME = { html: 'text/html; charset=utf-8', css: 'text/css', js: 'text/javascript', mjs: 'text/javascript', json: 'application/json', svg: 'image/svg+xml', png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif', avif: 'image/avif', ico: 'image/x-icon', txt: 'text/plain' };
-function serveStorefront(r, path, search) {
+function serveStorefront(r, path, search, headers) {
     const files = r.ucp.files;
     // /tiles/ is the store host's own, in front of a custom storefront too: unknown tiles are a 404.
     if (path.startsWith('/tiles/'))
-        return renderTile(r, path) ?? html(404, 'Not found', `<p>No ${path} on this store.</p>`);
+        return renderTile(r, path, search) ?? html(404, 'Not found', `<p>No ${path} on this store.</p>`);
+    // Agent-only: no pages for humans beyond what UCP needs; the images stay, UCP's media point at them.
+    const agentOnly = r.storefront_mode === 'agent-only';
+    // Links shared while the store was hosted land on the agent page.
+    if (agentOnly && /^(\/[a-z]{2}-[a-z]{2})?\/(products|categories)\/./.test(path))
+        return { status: 302, headers: { location: '/' }, body: '' };
+    if (agentOnly && path === '/')
+        return html(200, r.name ?? r.org, `<p>${esc(r.name ?? r.org)} sells to shopping agents over UCP: <a href="/.well-known/ucp">/.well-known/ucp</a>.</p>`);
     // A custom storefront (an uploaded index.html) serves every path; otherwise the theme renders its routes.
-    if (files['index.html'] === undefined) {
-        const page = renderTheme(r, path, search);
+    if (!agentOnly && files['index.html'] === undefined) {
+        const page = renderTheme(r, path, search, headers);
         if (page)
             return page;
     }
@@ -320,6 +331,8 @@ function serveStorefront(r, path, search) {
         const ext = path.split('.').pop() ?? '';
         return { status: 200, headers: { 'content-type': MIME[ext] ?? 'application/octet-stream' }, body: Buffer.from(asset, 'base64').toString('binary') };
     }
+    if (agentOnly)
+        return html(404, 'Not found', `<p>This store has no pages for ${esc(path)}: it sells over UCP.</p>`);
     const candidates = [path.replace(/^\//, ''), `${path.replace(/^\/|\/$/g, '')}/index.html`.replace(/^\//, ''), ...(path === '/' ? ['index.html'] : [])];
     for (const c of candidates) {
         if (files[c] !== undefined) {
@@ -356,7 +369,7 @@ export function handleUcp(req, r) {
             return html(404, 'Not found', `<p>No ${kind} ${m[2]}.</p>`);
         return html(200, `${kind === 'order' ? `Order ${found.label}` : `Your ${kind}`}`, `<p>${kind === 'order' ? 'Thank you. ' : ''}${found.line_items.length} line item(s), ${found.currency} ${(found.totals.at(-1).amount / 100).toFixed(2)}.</p>`);
     }
-    return serveStorefront(r, path, req.url.searchParams);
+    return serveStorefront(r, path, req.url.searchParams, req.headers);
 }
 /** Lets the service read the bearer token for order authorization. */
 export function bearerOf(req) {

package/dist/bin.js

@@ -4,11 +4,11 @@
 // Output is always JSON; exit code 1 on an error or a failed check.
 import * as cmd from './commands.js';
 import { CliError, print } from './output.js';
-const VALUE_OPTIONS = new Set(['--name', '--sku', '--quantity', '--country', '--code', '--file', '--store', '--item', '--email', '--first-name', '--last-name', '--phone', '--street', '--city', '--postal-code', '--region', '--shipping']);
+const VALUE_OPTIONS = new Set(['--name', '--sku', '--quantity', '--country', '--code', '--file', '--store', '--item', '--email', '--first-name', '--last-name', '--phone', '--street', '--city', '--postal-code', '--region', '--shipping', '--category', '--min-price', '--max-price', '--status', '--payment', '--fulfillment', '--limit', '--archived', '--amount', '--carrier', '--tracking', '--tracking-url']);
 const argv = process.argv.slice(2);
 const flags = new Set();
 const values = {};
-/** Every value of an option given more than once (--item, --code), in order; values keeps the last. */
+/** Every value of an option given more than once (--item, --code, --category), in order; values keeps the last. */
 const lists = {};
 const set = (k, v) => {
     values[k] = v;
@@ -93,17 +93,27 @@ async function run() {
             if (sub === 'test')
                 return cmd.ordersTest(flags, values);
             if (sub === 'list')
-                return cmd.ordersList();
+                return cmd.ordersList(values, flags);
             if (sub === 'show')
                 return cmd.ordersShow(args[2]);
-            throw new CliError('unknown_command', `There is no command "orders ${sub ?? ''}".`, 'Use `c11r orders test`, `orders list` or `orders show <id>`.');
+            if (sub === 'approve' || sub === 'capture' || sub === 'cancel' || sub === 'refund' || sub === 'archive' || sub === 'unarchive')
+                return cmd.ordersAct(sub, args[2], values, flags);
+            throw new CliError('unknown_command', `There is no command "orders ${sub ?? ''}".`, 'Use `c11r orders list`, `show <number>`, `approve <number> [--capture]`, `capture`, `cancel`, `refund <number> [--amount <n>]`, `archive`, `unarchive`, or `orders test`.');
+        case 'fulfillment':
+            if (sub === 'list')
+                return cmd.fulfillmentList(values);
+            if (sub === 'show')
+                return cmd.fulfillmentShow(args[2]);
+            if (sub === 'hold' || sub === 'pick' || sub === 'pack' || sub === 'ready' || sub === 'ship' || sub === 'deliver')
+                return cmd.fulfillmentAct(sub, args[2], values);
+            throw new CliError('unknown_command', `There is no command "fulfillment ${sub ?? ''}".`, 'Use `c11r fulfillment list`, `show <shipment>`, `hold`, `pick`, `pack`, `ready`, `ship <shipment> [--carrier --tracking --tracking-url]` or `deliver`.');
         case 'ucp':
             if (sub === 'profile')
                 return cmd.ucpProfile(flags);
             if (sub === 'check')
                 return cmd.ucpCheck();
             if (sub === 'search')
-                return cmd.ucpSearch(args.slice(2).join(' '), values);
+                return cmd.ucpSearch(args.slice(2).join(' '), values, lists);
             if (sub === 'product')
                 return cmd.ucpProduct(args[2], values);
             if (sub === 'order')

package/dist/catalog.js

@@ -9,7 +9,8 @@ import YAML from 'yaml';
 import { credential, paths } from './files.js';
 import { CliError, fail } from './output.js';
 import { parseCsv, readProductFile, toCsv } from './products.js';
-import { canonical, checkProducts, readStoreFile } from './store.js';
+import { ISO_639_1, setPlain, setTranslated, translatedColumn, TRANSLATED } from './languages.js';
+import { canonical, checkProducts, readStoreFile, storeLanguage } from './store.js';
 export const SOURCES = ['supabase', 'sheets', 'merchant'];
 export const catalogFile = path.join(paths.products, 'catalog.csv');
 const FIELDS = ['sku', 'name', 'description', 'image_url', 'category'];
@@ -33,7 +34,21 @@ function readConfig(doc) {
             ? 'Set url to the Google Sheet\'s CSV link (File > Share > Publish to web > Comma-separated values), or to the sheet\'s own link if it is shared with anyone who has the link.'
             : 'Set url to the Merchant Center product feed (RSS/XML or TSV), as Merchant Center fetches it.');
     }
-    return { source: c.source, url, table };
+    const translations = {};
+    if (c.translations !== undefined && c.translations !== null) {
+        if (c.source !== 'merchant')
+            fail('invalid_catalog', `catalog.translations is for merchant feeds; this source is ${c.source}.`, 'In a sheet or a table, translations are columns: name_it, description_it, category_it.');
+        if (typeof c.translations !== 'object' || Array.isArray(c.translations))
+            fail('invalid_catalog', 'catalog.translations in store.yml is not a map.', 'Map each language to its feed: translations: { it: https://..., fr: https://... }.');
+        for (const [ll, u] of Object.entries(c.translations)) {
+            if (!ISO_639_1.has(ll))
+                fail('invalid_catalog', `catalog.translations.${ll} is not a language.`, 'Use ISO 639-1 codes in lower case: it, fr, de, ...');
+            if (!/^https?:\/\//.test(String(u)))
+                fail('invalid_catalog', `catalog.translations.${ll} is not a URL.`, 'Set it to the Merchant Center feed in that language (RSS/XML or TSV).');
+            translations[ll] = String(u);
+        }
+    }
+    return { source: c.source, url, table, translations };
 }
 async function get(url, what, headers = {}) {
     try {
@@ -51,13 +66,16 @@ function fromTable(header, rows, where, label, currencies) {
         const key = h.trim().toLowerCase();
         if (FIELDS.includes(key))
             return { field: key };
+        const t = translatedColumn(key);
+        if (t)
+            return { translated: t.field, language: t.language };
         if (key === '' || IGNORED.includes(key))
             return null;
         const code = /^[a-z]{3}$/.test(key);
         if (code && (currencies.length === 0 || currencies.includes(key.toUpperCase())))
             return { currency: key.toUpperCase() };
         const why = key === 'stock' ? 'Stock is not part of the catalog: inventory is tracked live in Commerce Layer. ' : code ? `${key.toUpperCase()} is not the currency of a market in store.yml. ` : '';
-        fail('invalid_product', `${where} has a column "${h}" that is not a product field.`, `${why}The catalog columns are ${FIELDS.join(', ')} and one price column per market currency, named by its ISO 4217 code in lowercase (${prices}). Ask the human to rename or remove the column.`);
+        fail('invalid_product', `${where} has a column "${h}" that is not a product field.`, `${why}The catalog columns are ${FIELDS.join(', ')}, name_<ll>, description_<ll> and category_<ll> for other languages (name_it), and one price column per market currency, named by its ISO 4217 code in lowercase (${prices}). Ask the human to rename or remove the column.`);
     });
     if (!columns.some((c) => c && 'field' in c && c.field === 'sku'))
         fail('invalid_product', `${where} has no sku column.`, `The catalog columns are ${FIELDS.join(', ')} and one price column per market currency (${prices}).`);
@@ -76,6 +94,10 @@ function fromTable(header, rows, where, label, currencies) {
                     fail('invalid_product', `${label(i)}: ${col.currency} price "${v}" is not a number.`, 'Write prices as plain decimals, such as 14.50, with no currency sign or thousands separator.');
                 product.prices[col.currency] = price;
             }
+            else if ('translated' in col)
+                setTranslated(product, col.translated, col.language, String(v).trim());
+            else if (TRANSLATED.includes(col.field))
+                setPlain(product, col.field, String(v).trim());
             else
                 product[col.field] = String(v).trim();
         });
@@ -233,6 +255,20 @@ async function fromMerchant(c) {
         bySku.set(item.id, sourced);
         out.push(sourced);
     });
+    // A feed per language: title, description and product_type of the same ids, in that language.
+    for (const [ll, url] of Object.entries(c.translations)) {
+        const res = await get(url, `the ${ll} Merchant feed`);
+        if (!res.ok)
+            fail('catalog_error', `The ${ll} Merchant feed answered ${res.status}.`, `Check catalog.translations.${ll} in store.yml: it is the feed URL Merchant Center fetches for that language.`);
+        for (const item of feedRows(await res.text()).items) {
+            const target = item.id ? bySku.get(item.id)?.product : undefined;
+            if (!target)
+                continue;
+            for (const [tag, field] of [['title', 'name'], ['description', 'description'], ['product_type', 'category']])
+                if (item[tag])
+                    setTranslated(target, field, ll, item[tag]);
+        }
+    }
     return out;
 }
 export async function pull() {
@@ -254,7 +290,7 @@ export async function pull() {
         const rls = config.source === 'supabase' ? ' If the table has rows, row level security hides them from the anon key: ask the human to add a policy that allows select.' : '';
         fail('empty_catalog', `The ${config.source} catalog has no products.`, `Ask the human to add products to it, then pull again.${rls}`);
     }
-    const products = checkProducts(sourced, currencies);
+    const products = checkProducts(sourced, currencies, storeLanguage(doc.language));
     let before = new Map();
     if (fs.existsSync(catalogFile)) {
         try {