@commercelayer/agent-cli 0.8.1 → 1.0.0-dev.0

package/dist/inspect.js

@@ -1,237 +0,0 @@
-// c11r storefront inspect <url>: what a brand's website says about itself, for a demo store that
-// looks like it: title, languages, the logo, the colours, the currencies and countries it sells
-// in, the platform, and whether robots.txt lets catalog pull read its products. Read-only: it
-// writes no file and downloads nothing to keep; the logo is used by its URL (hot-linked).
-import { fail } from './output.js';
-import { absoluteUrl, BudgetExceeded, hreflangs, isType, jsonLd, metas, oneLine, platformOf, robotsAllows, siteOrigin, tags, unreachable, Web } from './web.js';
-const MAX_STYLESHEETS = 3;
-const MAX_LOGOS = 5;
-const MAX_COLORS = 5;
-const hex6 = (h) => {
-    const x = h.replace('#', '').toLowerCase();
-    return `#${x.length === 3 ? [...x].map((c) => c + c).join('') : x}`;
-};
-const rgbHex = (r, g, b) => `#${[r, g, b].map((n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, '0')).join('')}`;
-/** Greys, white and black: a page's text and background, rarely its brand colour. */
-const neutral = (hex) => {
-    const [r, g, b] = [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16));
-    return Math.max(r, g, b) - Math.min(r, g, b) < 16;
-};
-/** Every colour written in CSS: #rgb, #rrggbb and rgb()/rgba(), counted. */
-export function cssColors(css, into = new Map()) {
-    const add = (h) => into.set(h, (into.get(h) ?? 0) + 1);
-    for (const m of css.matchAll(/#([0-9a-f]{6}|[0-9a-f]{3})(?![0-9a-z_-])/gi))
-        add(hex6(m[1]));
-    for (const m of css.matchAll(/rgba?\(\s*(\d{1,3})[\s,]+(\d{1,3})[\s,]+(\d{1,3})(?:\s*[,/]\s*([\d.]+%?))?\s*\)/gi)) {
-        // A transparent colour is an overlay, not a colour of the brand.
-        if (m[4] !== undefined && parseFloat(m[4]) === 0)
-            continue;
-        add(rgbHex(Number(m[1]), Number(m[2]), Number(m[3])));
-    }
-    return into;
-}
-const num = (v) => {
-    const n = Number(String(v ?? '').replace(/px$/, ''));
-    return Number.isFinite(n) && n > 0 ? n : undefined;
-};
-/** Where the header is: the <header> element, else the top of the body. */
-const headerOf = (html) => {
-    const h = html.match(/<header\b[\s\S]*?<\/header>/i)?.[0];
-    if (h)
-        return h;
-    const body = html.search(/<body\b/i);
-    return html.slice(Math.max(0, body), Math.max(0, body) + 20_000);
-};
-export function logoCandidates(html, base, siteTitle) {
-    const out = [];
-    for (const node of jsonLd(html)) {
-        if (!['Organization', 'Brand', 'OnlineStore', 'Store', 'Corporation', 'LocalBusiness', 'WebSite'].some((t) => isType(node, t)))
-            continue;
-        const l = Array.isArray(node.logo) ? node.logo[0] : node.logo;
-        const url = absoluteUrl(typeof l === 'string' ? l : (l?.url ?? l?.contentUrl), base);
-        if (url)
-            out.push({ url, source: 'json_ld', score: 4, ...(num(l?.width) ? { width: num(l.width) } : {}), ...(num(l?.height) ? { height: num(l.height) } : {}) });
-    }
-    const words = (siteTitle ?? '').toLowerCase();
-    const scan = (region, source, bonus) => {
-        for (const t of tags(region, 'img')) {
-            const a = t.attrs;
-            const src = a.src || a['data-src'] || (a.srcset ?? a['data-srcset'] ?? '').split(',')[0]?.trim().split(/\s+/)[0];
-            // Shopify themes leave {width} in lazy sources.
-            const url = absoluteUrl(src?.replace(/\{width\}/g, '600'), base);
-            if (!url)
-                continue;
-            const own = [a.class, a.id, a.alt, src].join(' ').toLowerCase();
-            // The element around it (a link or a wrapper named logo), not just anything near.
-            const parents = [...region.slice(Math.max(0, t.index - 600), t.index).matchAll(/<(?!img\b|\/)[a-z][^>]*>/gi)].slice(-2).map((m) => m[0]).join(' ').toLowerCase();
-            const alt = (a.alt ?? '').trim().toLowerCase();
-            const score = (own.includes('logo') ? 3 : 0) + (alt && words && (words.includes(alt) || alt.includes(words.split(/\s[|–—-]\s/)[0])) ? 2 : 0) + (parents.includes('logo') ? 1 : 0);
-            if (score === 0)
-                continue;
-            out.push({ url, source, score: score + bonus, ...(a.alt ? { alt: a.alt.trim() } : {}), ...(num(a.width) ? { width: num(a.width) } : {}), ...(num(a.height) ? { height: num(a.height) } : {}) });
-        }
-    };
-    const header = headerOf(html);
-    scan(header, 'header_img', 1);
-    scan(html, 'img', 0);
-    // An inline <svg> logo has no URL to link: say so, so the agent asks for a file or picks another.
-    for (const t of tags(header, 'svg')) {
-        const own = [t.attrs.class, t.attrs.id, t.attrs['aria-label']].join(' ').toLowerCase();
-        const titled = header.slice(t.index, t.index + 400).match(/<title>([^<]*)<\/title>/i)?.[1]?.toLowerCase();
-        if (!own.includes('logo') && !(titled && words && words.includes(titled.trim())))
-            continue;
-        out.push({ url: null, source: 'header_svg', score: 2, note: 'An inline SVG in the header: it has no URL to link. Use another candidate, or ask the human for the logo file (img/logo.svg).' });
-        break;
-    }
-    const seen = new Set();
-    return out
-        .sort((a, b) => b.score - a.score)
-        .filter((l) => {
-        const key = l.url ?? `svg:${l.source}`;
-        if (seen.has(key))
-            return false;
-        seen.add(key);
-        return true;
-    })
-        .slice(0, MAX_LOGOS)
-        .map(({ score: _, ...l }) => l);
-}
-const ISO_CURRENCY = /^[A-Z]{3}$/;
-export function currenciesSeen(html, meta) {
-    const found = new Set();
-    const add = (c) => typeof c === 'string' && ISO_CURRENCY.test(c.trim().toUpperCase()) && found.add(c.trim().toUpperCase());
-    add(meta['og:price:currency']);
-    add(meta['product:price:currency']);
-    for (const m of html.matchAll(/Shopify\.currency\s*=\s*\{[^}]*"active"\s*:\s*"([A-Za-z]{3})"/g))
-        add(m[1]);
-    for (const m of html.matchAll(/"priceCurrency"\s*:\s*"([A-Za-z]{3})"/g))
-        add(m[1]);
-    for (const m of html.matchAll(/"currency_code"\s*:\s*"([A-Za-z]{3})"/g))
-        add(m[1]);
-    for (const m of html.matchAll(/data-currency(?:-code)?\s*=\s*["']([A-Za-z]{3})["']/g))
-        add(m[1]);
-    // A currency selector: <select name="currency"> with ISO codes as values.
-    for (const s of html.matchAll(/<select\b[^>]*name\s*=\s*["']?currency[^>]*>([\s\S]*?)<\/select>/gi))
-        for (const o of tags(s[1], 'option'))
-            add(o.attrs.value);
-    return [...found].sort();
-}
-export function countriesSeen(html, base) {
-    const found = new Set();
-    const add = (c) => typeof c === 'string' && /^[A-Z]{2}$/.test(c.trim()) && found.add(c.trim());
-    for (const h of hreflangs(html, base))
-        if (h.region && /^[A-Z]{2}$/.test(h.region))
-            found.add(h.region);
-    for (const m of html.matchAll(/Shopify\.country\s*=\s*"([A-Z]{2})"/g))
-        add(m[1]);
-    // A country selector: Shopify's localization form, or a <select name="country...">.
-    for (const f of html.matchAll(/<form\b[^>]*localization[^>]*>([\s\S]*?)<\/form>/gi))
-        for (const m of f[1].matchAll(/data-value\s*=\s*["']([A-Z]{2})["']/g))
-            add(m[1]);
-    for (const s of html.matchAll(/<select\b[^>]*name\s*=\s*["']?country[^>]*>([\s\S]*?)<\/select>/gi))
-        for (const o of tags(s[1], 'option'))
-            add(o.attrs.value);
-    return [...found].sort();
-}
-/** The paths catalog pull reads, by strategy: whether robots.txt lets c11r read them. */
-const PRODUCT_PATHS = { shopify: ['/products.json', '/collections/all/products.json'], woocommerce: ['/wp-json/wc/store/v1/products'], structured_data: ['/sitemap.xml'] };
-export async function inspect(raw) {
-    if (!raw)
-        fail('missing_argument', 'storefront inspect needs the website address.', 'Run c11r storefront inspect https://brand.example.');
-    const origin = siteOrigin(raw, 'The address');
-    const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(raw) ? raw : `https://${raw}`;
-    const start = absoluteUrl(withScheme, origin) ?? `${origin}/`;
-    const web = new Web();
-    let page;
-    try {
-        page = await web.get(start);
-    }
-    catch (e) {
-        if (e instanceof BudgetExceeded)
-            fail('site_unreachable', `${start} did not answer in time.`, 'Try again later.');
-        unreachable(start, e);
-    }
-    if (page === null)
-        fail('robots_disallowed', `${start}'s robots.txt does not let c11r read that page.`, 'c11r does not go around robots.txt. Ask the human for the logo, colours and products instead (a feed or a sheet for catalog pull).');
-    if (page.status === 0)
-        fail('site_unreachable', `${start} did not answer within ${Math.round(web.timeout / 1000)} s.`, 'Check the address with the human (open it in a browser), and try again later.');
-    if (!page.ok)
-        fail('site_error', `${start} answered ${page.status}.`, 'Check the address with the human: open it in a browser.');
-    const html = page.text;
-    const base = page.url;
-    const finalOrigin = new URL(base).origin;
-    const meta = metas(html);
-    const title = oneLine(html.match(/<title\b[^>]*>([\s\S]*?)<\/title>/i)?.[1] ?? '') || null;
-    const siteName = meta['og:site_name'] || null;
-    const lang = html.match(/<html\b[^>]*\blang\s*=\s*["']?([A-Za-z]{2,3}(?:[-_][A-Za-z0-9]+)*)/)?.[1] ?? null;
-    const alternates = hreflangs(html, base);
-    const languages = [...new Set([lang?.slice(0, 2).toLowerCase(), ...alternates.map((h) => h.language)].filter((l) => !!l))];
-    const icons = tags(html, 'link')
-        .filter((t) => /\b(icon|apple-touch-icon|mask-icon)\b/i.test(t.attrs.rel ?? ''))
-        .map((t) => ({ url: absoluteUrl(t.attrs.href, base), rel: t.attrs.rel, ...(t.attrs.sizes ? { sizes: t.attrs.sizes } : {}), ...(t.attrs.type ? { type: t.attrs.type } : {}) }))
-        .filter((i) => i.url);
-    // Colours: theme-color first, then the CSS: inline <style>, style="" and the first linked stylesheets.
-    const counts = new Map();
-    for (const m of html.matchAll(/<style\b[^>]*>([\s\S]*?)<\/style>/gi))
-        cssColors(m[1], counts);
-    for (const m of html.matchAll(/\sstyle\s*=\s*"([^"]*)"/gi))
-        cssColors(m[1], counts);
-    const sheets = tags(html, 'link')
-        .filter((t) => /\bstylesheet\b/i.test(t.attrs.rel ?? '') && t.attrs.href)
-        .map((t) => absoluteUrl(t.attrs.href, base))
-        .filter((u) => !!u)
-        .slice(0, MAX_STYLESHEETS);
-    let stylesheetsRead = 0;
-    for (const url of sheets) {
-        try {
-            const css = await web.get(url, 'text/css,*/*;q=0.1');
-            if (css?.ok) {
-                cssColors(css.text, counts);
-                stylesheetsRead++;
-            }
-        }
-        catch (e) {
-            if (e instanceof BudgetExceeded)
-                break;
-        }
-    }
-    const themeColor = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(meta['theme-color'] ?? '') ? hex6(meta['theme-color']) : null;
-    const colors = [
-        ...(themeColor ? [{ hex: themeColor, source: 'theme_color', count: counts.get(themeColor) ?? 0, neutral: neutral(themeColor) }] : []),
-        ...[...counts.entries()]
-            .filter(([h]) => h !== themeColor)
-            .sort((a, b) => b[1] - a[1])
-            .map(([hex, count]) => ({ hex, source: 'css', count, neutral: neutral(hex) })),
-    ].slice(0, MAX_COLORS);
-    const ogImage = absoluteUrl(meta['og:image:secure_url'] || meta['og:image'], base);
-    const logos = logoCandidates(html, base, siteName ?? title);
-    const ogFile = ogImage ? decodeURIComponent(new URL(ogImage).pathname.split('/').pop() ?? '') : '';
-    const robots = await web.robotsFor(finalOrigin).catch(() => ({ rules: [], sitemaps: [] }));
-    const paths = Object.fromEntries(Object.values(PRODUCT_PATHS).flat().map((p) => [p, robotsAllows(robots, p)]));
-    const platform = platformOf(html, page.headers);
-    const relevant = platform === 'unknown' ? Object.values(PRODUCT_PATHS).flat() : [...PRODUCT_PATHS[platform], ...PRODUCT_PATHS.structured_data];
-    return {
-        url: base,
-        title,
-        site_name: siteName,
-        description: meta.description || meta['og:description'] || null,
-        language: lang,
-        languages,
-        theme_color: themeColor,
-        icons,
-        og_image: ogImage,
-        og_image_width: num(meta['og:image:width']) ?? null,
-        og_image_height: num(meta['og:image:height']) ?? null,
-        // The hero is a photo: an og:image that is the logo (a candidate, or logo in its file name) is not one.
-        og_image_is_logo: ogImage ? logos.some((l) => l.url === ogImage) || /logo/i.test(ogFile) : false,
-        logo_candidates: logos,
-        colors,
-        currencies_seen: currenciesSeen(html, meta),
-        countries_seen: countriesSeen(html, base),
-        platform,
-        robots: { products_allowed: relevant.some((p) => paths[p]), paths },
-        stylesheets_read: stylesheetsRead,
-        requests: web.requests,
-        next: 'Pick theme.color from colors (the first one that is not neutral, usually) and theme.logo from logo_candidates (its url, hot-linked: nothing is copied), and show the human what you picked. Then catalog: { source: website, url: <this site> } in store.yml and c11r catalog pull.' + (relevant.some((p) => paths[p]) ? '' : ' robots.txt disallows the paths catalog pull reads: ask the human for a feed or a sheet instead.'),
-    };
-}

package/dist/languages.js

@@ -1,49 +0,0 @@
-// Languages: the store has one base language (store.yml `language:`, default en) and products
-// may carry name, description and category in others, as a { <ll>: text } map in YAML or as
-// name_<ll>, description_<ll>, category_<ll> columns in CSV and the catalog sources. They are
-// normalised into the base-language strings plus translations: { <ll>: { name, ... } }.
-/** ISO 639-1: the two-letter language codes. */
-export const ISO_639_1 = new Set('aa ab ae af ak am an ar as av ay az ba be bg bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik io is it iu ja jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu'.split(' '));
-export const DEFAULT_LANGUAGE = 'en';
-/** The product fields that can be translated. */
-export const TRANSLATED = ['name', 'description', 'category'];
-/** A column name_it, description_fr, category_de: the field and the language, or null. */
-export function translatedColumn(header) {
-    const m = header.trim().toLowerCase().match(/^(name|description|category)_([a-z]{2})$/);
-    return m ? { field: m[1], language: m[2] } : null;
-}
-/**
- * The key a plain column (name, description, category) goes under when a product also has
- * translated columns: it is the base language's text, whatever the base language is.
- */
-export const PLAIN = '';
-/** Put one language's text of a field on a product being read from a table: the field becomes a map. */
-export function setTranslated(product, field, language, value) {
-    const current = product[field];
-    const map = current && typeof current === 'object' ? current : current === undefined || current === '' ? {} : { [PLAIN]: String(current) };
-    map[language] = value;
-    product[field] = map;
-}
-/** Put the plain column's text on a product, keeping any translations already read. */
-export function setPlain(product, field, value) {
-    const current = product[field];
-    if (current && typeof current === 'object')
-        current[PLAIN] = value;
-    else
-        product[field] = value;
-}
-/** The languages in a set of translations, sorted, and the fields each column set needs, for CSV output. */
-export function translationColumns(all) {
-    const columns = new Set();
-    for (const t of all)
-        for (const [language, fields] of Object.entries(t ?? {}))
-            for (const f of TRANSLATED)
-                if (fields[f] !== undefined)
-                    columns.add(`${f}_${language}`);
-    const order = (c) => [c.slice(-2), TRANSLATED.indexOf(c.slice(0, -3))];
-    return [...columns].sort((a, b) => {
-        const [la, fa] = order(a);
-        const [lb, fb] = order(b);
-        return la < lb ? -1 : la > lb ? 1 : fa - fb;
-    });
-}

package/dist/links.js

@@ -1,118 +0,0 @@
-// Links: shareable URLs that open a hosted microstore for one SKU, a set of SKUs or a
-// category, or the hosted checkout for an order. Live configuration in Commerce Layer, made
-// with c11r links create; never in store.yml. The CLI validates the spec against store.yml
-// (skus, categories, markets) and sends one normalized link; the API makes the CL link.
-import { isoDate } from './promotions.js';
-import { fail } from './output.js';
-const KEYS = ['id', 'name', 'for', 'market', 'markets', 'starts', 'ends', 'params'];
-const FOR = ['sku', 'skus', 'category', 'order'];
-/** The SKUs one link can sell: the API's limit. */
-const MAX_SKUS = 100;
-const SHAPE_HINT = 'See the links skill for the shape: https://commercelayer.ai/skills/links.md';
-const isObj = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
-const seconds = (d) => d.toISOString().replace(/\.\d{3}Z$/, 'Z');
-/** One calendar month after a date-time, in UTC. */
-function monthAfter(iso) {
-    const d = new Date(iso);
-    d.setUTCMonth(d.getUTCMonth() + 1);
-    return seconds(d);
-}
-/**
- * Validate one link spec (YAML or JSON, as given to links create) and normalize it to the
- * wire shape, or fail invalid_link naming the path inside the spec. A category becomes its
- * products' skus as they are now, from store.yml.
- */
-export function checkLink(raw, markets, products, now = new Date()) {
-    const skus = new Set(products.map((p) => p.sku));
-    const bad = (msg, hint, path = 'link') => fail('invalid_link', `${path}: ${msg}`, hint);
-    if (!isObj(raw))
-        bad('is not a map.', `A link is a map with id, name and for. ${SHAPE_HINT}`);
-    const l = raw;
-    if (typeof l.id !== 'string' || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(l.id))
-        bad(`id is ${l.id === undefined ? 'missing' : `"${String(l.id)}"`}.`, 'Give the link an id of lowercase letters, digits and dashes, such as summer-bundle: the handle for show, enable, disable and delete.');
-    const id = l.id;
-    for (const k of Object.keys(l))
-        if (!KEYS.includes(k))
-            bad(`unknown key ${k}.`, `A link's keys are ${KEYS.join(', ')}.`);
-    const link = { id, name: l.name === undefined ? id : String(l.name), for: { sku: '' }, starts: '', ends: '' };
-    if (!link.name.trim() || link.name.length > 255)
-        bad('name is empty or longer than 255 characters.', 'Write a short name the human will recognize in the dashboard.');
-    // for: exactly one of sku, skus, category, order. show prints a category with its skus: those are read again.
-    const f = l.for;
-    if (!isObj(f))
-        bad(f === undefined ? 'has no for.' : 'for is not a map.', `Say what the link sells: for: { sku: <sku> }, { skus: [...] }, { category: "A > B" } or { order: <number> }. ${SHAPE_HINT}`);
-    const given = Object.keys(f).filter((k) => !('category' in f && k === 'skus'));
-    if (given.includes('sku_list'))
-        bad('sku_list is a list made in the dashboard.', 'Name the skus (for: { skus: [...] }) or a category instead.', 'for');
-    for (const k of given)
-        if (!FOR.includes(k))
-            bad(`unknown key ${k}.`, `for takes one of ${FOR.join(', ')}.`, 'for');
-    if (given.length !== 1)
-        bad(`has ${given.length ? given.join(' and ') : 'nothing'}.`, 'Give exactly one of sku, skus, category or order: a link sells one thing.', 'for');
-    const kind = given[0];
-    const v = f[kind];
-    if (kind === 'sku') {
-        if (typeof v !== 'string' || !skus.has(v))
-            bad(`${String(v)} is not a product.`, "Use the SKU of one of the store's products.", 'for.sku');
-        link.for = { sku: v };
-    }
-    else if (kind === 'skus') {
-        if (!Array.isArray(v) || !v.length)
-            bad('is not a list of SKUs.', 'List one or more SKUs: skus: [ETH, COL].', 'for.skus');
-        if (v.length > MAX_SKUS)
-            bad(`has ${v.length} SKUs.`, `A link sells at most ${MAX_SKUS} SKUs: make several links.`, 'for.skus');
-        v.forEach((s, i) => {
-            if (typeof s !== 'string' || !skus.has(s))
-                bad(`${String(s)} is not a product.`, "Use SKUs of the store's products.", `for.skus[${i}]`);
-        });
-        link.for = { skus: [...new Set(v)] };
-    }
-    else if (kind === 'category') {
-        const name = String(v).split('>').map((s) => s.trim()).filter(Boolean).join(' > ');
-        const found = products.filter((x) => x.category === name || x.category?.startsWith(`${name} > `)).map((x) => x.sku);
-        if (!name || !found.length)
-            bad(`no product is in category "${String(v)}".`, `Use a category of the store's products, written as in the products: ${[...new Set(products.map((x) => x.category).filter(Boolean))].join(', ') || 'none has a category yet'}.`, 'for.category');
-        if (found.length > MAX_SKUS)
-            bad(`"${name}" has ${found.length} products.`, `A link sells at most ${MAX_SKUS} SKUs: use a narrower category, or several links.`, 'for.category');
-        link.for = { category: name, skus: found.sort() };
-    }
-    else {
-        if (!(typeof v === 'string' && v.trim()) && !(Number.isInteger(v) && v > 0))
-            bad(`${String(v)} is not an order number.`, 'Use the number of a draft or pending order, or the id of a UCP cart or checkout (cart_..., chk_...): the order behind it.', 'for.order');
-        link.for = { order: String(v).trim().replace(/^#/, '') };
-    }
-    // Markets: a code or a list, under market or markets; none means every market. An order has its own.
-    if (l.market !== undefined && l.markets !== undefined)
-        bad('has market and markets.', 'Use one of them.');
-    const m = l.market ?? l.markets;
-    const path = l.market !== undefined ? 'market' : 'markets';
-    if (kind === 'order') {
-        if (m !== undefined)
-            bad(`${path}: an order link has the order's market.`, 'Remove market: the checkout opens in the market the order was placed in.');
-    }
-    else if (m === undefined)
-        link.markets = markets.map((x) => x.code);
-    else {
-        const codes = Array.isArray(m) ? m : [m];
-        if (!codes.length)
-            bad('is empty.', 'List one or more market codes, or leave it out for every market.', path);
-        codes.forEach((c, i) => {
-            if (!markets.some((x) => x.code === c))
-                bad(`${String(c)} is not in markets.`, `Use the code of one of the store's markets: ${markets.map((x) => x.code).join(', ')}.`, Array.isArray(m) ? `${path}[${i}]` : path);
-        });
-        link.markets = [...new Set(codes)];
-    }
-    link.starts = l.starts === undefined ? seconds(now) : isoDate(l.starts, false, (msg, h) => bad(`starts ${msg}`, h));
-    link.ends = l.ends === undefined ? monthAfter(link.starts) : isoDate(l.ends, true, (msg, h) => bad(`ends ${msg}`, h));
-    if (Date.parse(link.ends) <= Date.parse(link.starts))
-        bad('ends is not after starts.', 'Make the end date later than the start date.');
-    if (l.params !== undefined) {
-        if (!isObj(l.params))
-            bad('params is not a map.', 'params is a map of names to text, numbers or true/false, added to the link URL.');
-        for (const [k, p] of Object.entries(l.params))
-            if (!['string', 'number', 'boolean'].includes(typeof p))
-                bad(`${k} is not text, a number or true/false.`, 'params values are plain values, added to the link URL.', `params.${k}`);
-        link.params = l.params;
-    }
-    return link;
-}

package/dist/locales.js

@@ -1,43 +0,0 @@
-// Mirrored byte for byte from the API's src/api/locales.ts at 5cee8ba (TABLE, languageOf, localesOf):
-// keep it in step. The API derives a store's locales; the CLI needs them offline for plan and the stub.
-const TABLE = `
-AD:ca AE:ar AF:fa AG:en AI:en AL:sq AM:hy AO:pt AQ:en AR:es AS:en AT:de AU:en AW:nl AX:sv AZ:az
-BA:bs BB:en BD:bn BE:nl BF:fr BG:bg BH:ar BI:fr BJ:fr BL:fr BM:en BN:ms BO:es BQ:nl BR:pt BS:en BT:dz BV:no BW:en BY:be BZ:en
-CA:en CC:en CD:fr CF:fr CG:fr CH:de CI:fr CK:en CL:es CM:fr CN:zh CO:es CR:es CU:es CV:pt CW:nl CX:en CY:el CZ:cs
-DE:de DJ:fr DK:da DM:en DO:es DZ:ar EC:es EE:et EG:ar EH:ar ER:ti ES:es ET:am FI:fi FJ:en FK:en FM:en FO:fo FR:fr
-GA:fr GB:en GD:en GE:ka GF:fr GG:en GH:en GI:en GL:kl GM:en GN:fr GP:fr GQ:es GR:el GS:en GT:es GU:en GW:pt GY:en
-HK:zh HM:en HN:es HR:hr HT:fr HU:hu ID:id IE:en IL:he IM:en IN:en IO:en IQ:ar IR:fa IS:is IT:it JE:en JM:en JO:ar JP:ja
-KE:en KG:ky KH:km KI:en KM:ar KN:en KP:ko KR:ko KW:ar KY:en KZ:kk LA:lo LB:ar LC:en LI:de LK:si LR:en LS:en LT:lt LU:fr LV:lv LY:ar
-MA:ar MC:fr MD:ro ME:sr MF:fr MG:mg MH:en MK:mk ML:fr MM:my MN:mn MO:zh MP:en MQ:fr MR:ar MS:en MT:mt MU:en MV:dv MW:en MX:es MY:ms MZ:pt
-NA:en NC:fr NE:fr NF:en NG:en NI:es NL:nl NO:no NP:ne NR:en NU:en NZ:en OM:ar
-PA:es PE:es PF:fr PG:en PH:en PK:ur PL:pl PM:fr PN:en PR:es PS:ar PT:pt PW:en PY:es QA:ar RE:fr RO:ro RS:sr RU:ru RW:rw
-SA:ar SB:en SC:en SD:ar SE:sv SG:en SH:en SI:sl SJ:no SK:sk SL:en SM:it SN:fr SO:so SR:nl SS:en ST:pt SV:es SX:nl SY:ar SZ:en
-TC:en TD:fr TF:fr TG:fr TH:th TJ:tg TK:en TL:pt TM:tk TN:ar TO:en TR:tr TT:en TV:en TW:zh TZ:sw
-UA:uk UG:en UM:en US:en UY:es UZ:uz VA:it VC:en VE:es VG:en VI:en VN:vi VU:en WF:fr WS:en YE:ar YT:fr ZA:en ZM:en ZW:en
-`;
-/** Country code → its language. */
-export const COUNTRY_LANGUAGES = Object.freeze(Object.fromEntries(TABLE.trim().split(/\s+/).map((pair) => pair.split(':'))));
-/** A country's language: the table's, else en. */
-export const languageOf = (country) => COUNTRY_LANGUAGES[country.toUpperCase()] ?? 'en';
-/** The store's base language, in which plain names and descriptions are written. */
-export const baseLanguage = (applied) => applied?.language ?? 'en';
-export const LANGUAGE_LIMIT = 6;
-/**
- * The store's locales: one per country, in the order of its markets and their
- * countries. A country listed in two markets is the first market's.
- */
-export function localesOf(applied) {
-    const out = [];
-    const seen = new Set();
-    for (const m of Object.values(applied?.markets ?? {})) {
-        for (const raw of m.countries) {
-            const country = raw.toUpperCase();
-            if (seen.has(country))
-                continue;
-            seen.add(country);
-            const language = languageOf(country);
-            out.push({ country, language, market: m.code, path: `${country.toLowerCase()}-${language}` });
-        }
-    }
-    return out;
-}

package/dist/ops.js

@@ -1,190 +0,0 @@
-// The merchant agent running the store on a schedule: what is new since the last run, what the
-// policy approves and captures, what it holds for the human, what is stuck. The policy is the
-// human's, read here and never sent to the API; the cursor (.commercelayer/ops.json) keeps a
-// run from reporting the same order twice. Shipping and cancelling stay with the human.
-import fs from 'node:fs';
-import path from 'node:path';
-import YAML from 'yaml';
-import { jsonCursor, MAX_SEEN, strings } from './cursor.js';
-import { paths } from './files.js';
-import { fail } from './output.js';
-import { minorUnits } from './ucp/platform.js';
-// ---------- the policy
-/**
- * Where the policy is read from: .commercelayer/ops.yml, the whole file (key null). Committed
- * with the store and agreed with the human; never sent to the API.
- */
-export const POLICY_SOURCE = { file: 'ops.yml', key: null };
-export const DEFAULT_POLICY = { auto_approve: false, auto_capture: false, review_above: null, hold_countries: [], stuck_days: 2, transit_days: 7, mail_orders: { auto_place: false, labels: { pending: 'pending', ordered: 'ordered', declined: 'declined' } } };
-const POLICY_KEYS = Object.keys(DEFAULT_POLICY);
-export const policyPath = () => path.join(paths.dir, POLICY_SOURCE.file);
-/** The policy, the defaults where it says nothing; invalid_policy with the fix when it is wrong. */
-export function loadPolicy() {
-    const file = policyPath();
-    if (!fs.existsSync(file))
-        return { ...DEFAULT_POLICY, source: null };
-    let doc;
-    try {
-        doc = YAML.parse(fs.readFileSync(file, 'utf8'));
-    }
-    catch (e) {
-        fail('invalid_policy', `${file} is not valid YAML: ${e.message.split('\n')[0]}`, 'Fix the YAML, then run the command again.');
-    }
-    const raw = POLICY_SOURCE.key ? doc?.[POLICY_SOURCE.key] : doc;
-    const where = POLICY_SOURCE.key ? `${POLICY_SOURCE.key} in ${file}` : file;
-    return { ...checkPolicy(raw, where), source: file };
-}
-export function checkPolicy(raw, where) {
-    if (raw === undefined || raw === null)
-        return { ...DEFAULT_POLICY };
-    const bad = (what, hint) => fail('invalid_policy', `${where}: ${what}`, hint);
-    if (typeof raw !== 'object' || Array.isArray(raw))
-        bad('the policy is not a set of settings.', `Write it as settings, one per line: auto_approve: true, review_above: 500, … (${POLICY_KEYS.join(', ')}).`);
-    const p = raw;
-    const unknown = Object.keys(p).filter((k) => !POLICY_KEYS.includes(k));
-    if (unknown.length)
-        bad(`${unknown.join(', ')} ${unknown.length === 1 ? 'is not a setting' : 'are not settings'} of the policy.`, `The settings are ${POLICY_KEYS.join(', ')}.`);
-    const out = { ...DEFAULT_POLICY, mail_orders: { auto_place: false, labels: { ...DEFAULT_POLICY.mail_orders.labels } } };
-    for (const k of ['auto_approve', 'auto_capture']) {
-        if (p[k] === undefined)
-            continue;
-        if (typeof p[k] !== 'boolean')
-            bad(`${k} is ${JSON.stringify(p[k])}, not true or false.`, `Write ${k}: true or ${k}: false.`);
-        out[k] = p[k];
-    }
-    if (p.review_above !== undefined && p.review_above !== null) {
-        if (typeof p.review_above !== 'number' || !Number.isFinite(p.review_above) || p.review_above < 0)
-            bad(`review_above is ${JSON.stringify(p.review_above)}, not an amount.`, 'Give it in major units of the order\'s currency, for example review_above: 500, or leave it out to hold none for their total.');
-        out.review_above = p.review_above;
-    }
-    if (p.hold_countries !== undefined) {
-        const list = p.hold_countries;
-        if (!Array.isArray(list) || list.some((c) => typeof c !== 'string' || !/^[A-Za-z]{2}$/.test(c)))
-            bad(`hold_countries is ${JSON.stringify(list)}, not a list of country codes.`, 'Write ISO 3166 codes: hold_countries: [US, CA].');
-        out.hold_countries = list.map((c) => c.toUpperCase());
-    }
-    for (const k of ['stuck_days', 'transit_days']) {
-        if (p[k] === undefined)
-            continue;
-        const n = p[k];
-        if (typeof n !== 'number' || !Number.isFinite(n) || n <= 0)
-            bad(`${k} is ${JSON.stringify(n)}, not a number of days.`, `Write a number of days above 0, for example ${k}: ${DEFAULT_POLICY[k]}.`);
-        out[k] = n;
-    }
-    if (p.mail_orders !== undefined && p.mail_orders !== null) {
-        const m = p.mail_orders;
-        const fix = 'Write it as mail_orders: { auto_place: false, labels: { pending: pending, ordered: ordered, declined: declined } }; every setting is optional.';
-        if (typeof m !== 'object' || Array.isArray(m))
-            bad(`mail_orders is ${JSON.stringify(m)}, not a set of settings.`, fix);
-        const extra = Object.keys(m).filter((k) => k !== 'auto_place' && k !== 'labels');
-        if (extra.length)
-            bad(`mail_orders.${extra[0]} is not a setting: mail_orders has auto_place and labels.`, fix);
-        if (m.auto_place !== undefined && typeof m.auto_place !== 'boolean')
-            bad(`mail_orders.auto_place is ${JSON.stringify(m.auto_place)}, not true or false.`, fix);
-        out.mail_orders.auto_place = m.auto_place === true;
-        if (m.labels !== undefined && m.labels !== null) {
-            const l = m.labels;
-            if (typeof l !== 'object' || Array.isArray(l))
-                bad(`mail_orders.labels is ${JSON.stringify(l)}, not a set of names.`, fix);
-            const names = Object.keys(DEFAULT_POLICY.mail_orders.labels);
-            const other = Object.keys(l).filter((k) => !names.includes(k));
-            if (other.length)
-                bad(`mail_orders.labels.${other[0]} is not a label: the labels are ${names.join(', ')}.`, fix);
-            for (const k of names) {
-                const v = l[k];
-                if (v === undefined)
-                    continue;
-                if (typeof v !== 'string' || !v.trim() || v.length > 50 || v.startsWith('\\'))
-                    bad(`mail_orders.labels.${k} is ${JSON.stringify(v)}, not a label name.`, 'A label is a name of 1 to 50 characters, not starting with a backslash (\\Seen and the like are IMAP flags).');
-                out.mail_orders.labels[k] = v;
-            }
-        }
-    }
-    return out;
-}
-export const cursorPath = () => path.join(paths.dir, 'ops.json');
-// Machine state, rewritten on every run: kept out of git like the credentials.
-const cursor = () => jsonCursor(cursorPath(), (c) => ({ last_run: typeof c?.last_run === 'string' ? c.last_run : null, seen: strings(c?.seen) }));
-export const readCursor = () => cursor().read();
-export const writeCursor = (c) => cursor().write({ last_run: c.last_run, seen: c.seen.slice(0, MAX_SEEN) });
-// ---------- time
-const UNITS = { h: 3600_000, d: 86_400_000, w: 7 * 86_400_000 };
-/** "24h", "7d", "2w" or an ISO date or time: the instant it means, relative to now. */
-export function parseSince(raw, flag, now = Date.now()) {
-    const rel = raw.trim().match(/^(\d+(?:\.\d+)?)\s*([hdw])$/i);
-    if (rel)
-        return new Date(now - Number(rel[1]) * UNITS[rel[2].toLowerCase()]);
-    const t = Date.parse(raw);
-    if (!/^\d{4}-\d{2}-\d{2}/.test(raw.trim()) || Number.isNaN(t))
-        fail('invalid_argument', `--${flag} ${raw} is not a time.`, `Use a span back from now (24h, 7d, 30d) or an ISO date (2026-11-01, 2026-11-01T09:00:00Z).`);
-    return new Date(t);
-}
-const DAY = 86_400_000;
-const days = (ms) => Math.round((ms / DAY) * 10) / 10;
-const brief = (o) => ({ id: o.id, number: o.number, placed_at: o.placed_at, country: o.country, channel: o.channel, email: o.email, items: o.items, total: o.total, payment_status: o.payment_status });
-/** Why the policy holds an order for the human, if it does. */
-export function holdReason(o, p) {
-    const reasons = [];
-    if (p.review_above !== null && o.total.major > p.review_above)
-        reasons.push(`its total ${o.total.display} is above ${o.currency} ${p.review_above.toFixed(2)} (review_above)`);
-    if (o.country && p.hold_countries.includes(o.country.toUpperCase()))
-        reasons.push(`it ships to ${o.country.toUpperCase()} (hold_countries)`);
-    return reasons.length ? reasons.join(' and ') : undefined;
-}
-/** What the policy does with a placed order. */
-export function decidePlaced(o, p) {
-    const held = holdReason(o, p);
-    if (held)
-        return { order: brief(o), action: 'hold', reason: held };
-    if (!p.auto_approve)
-        return { order: brief(o), action: 'wait', reason: 'auto_approve is off: the human approves orders' };
-    if (p.auto_capture && o.payment_status === 'authorized')
-        return { order: brief(o), action: 'approve_capture' };
-    return { order: brief(o), action: 'approve' };
-}
-/** What the policy does with an approved order whose payment is only authorized. */
-export function decideApproved(o, p) {
-    if (!p.auto_capture)
-        return { order: brief(o), action: 'wait', reason: 'auto_capture is off: the human says when to take the payment' };
-    return { order: brief(o), action: 'capture' };
-}
-/** Picking, packing or ready to ship for too long is stuck; on hold is the merchant's choice, never stuck. */
-const WORKING = ['picking', 'packing', 'ready_to_ship'];
-/** A stuck shipment as ops prints it, from its row and its age in days. */
-export function stuckView(s, age, p) {
-    const since = s.status_changed_at ?? s.dates?.[`${s.status}_at`] ?? '';
-    const reason = s.status === 'shipped' ? `shipped ${age} days ago and not delivered (transit_days ${p.transit_days})` : `${s.status.replace(/_/g, ' ')} for ${age} days (stuck_days ${p.stuck_days})`;
-    return { shipment: { id: s.id, number: s.number, status: s.status, order: s.order, country: s.country, tracking: s.tracking }, days: age, since, reason };
-}
-/**
- * The same as the API's snapshot, for an API without it: shipments picking, packing or ready to
- * ship longer than stuck_days, or shipped longer than transit_days, from when they entered it.
- */
-export function stuckShipments(list, p, now = Date.now()) {
-    const out = [];
-    for (const s of list) {
-        const d = (s.dates ?? {});
-        const entered = Date.parse(s.status_changed_at ?? d[`${s.status}_at`] ?? '');
-        if (Number.isNaN(entered))
-            continue;
-        const age = days(now - entered);
-        if ((WORKING.includes(s.status) && now - entered > p.stuck_days * DAY) || (s.status === 'shipped' && now - entered > p.transit_days * DAY))
-            out.push(stuckView(s, age, p));
-    }
-    return out.sort((a, b) => b.days - a.days);
-}
-// ---------- words
-/** "EUR 20.00 + USD 12.00": money in several currencies, summed per currency. */
-export function totalsByCurrency(list) {
-    const by = new Map();
-    for (const m of list)
-        by.set(m.currency, (by.get(m.currency) ?? 0) + m.amount);
-    return [...by].map(([currency, amount]) => {
-        const unit = minorUnits(currency);
-        const major = amount / unit;
-        return { amount, currency, major, display: `${currency} ${major.toFixed(Math.round(Math.log10(unit)))}` };
-    });
-}
-export const moneyText = (list) => (list.length ? list.map((m) => m.display).join(' + ') : '0');
-export const numbers = (list) => list.map((d) => `#${d.order.number}`).join(', ');
-export const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;