@sixtyninecommerce/client 0.29.0 → 0.31.0

package/dist/seo/artifacts.d.ts

@@ -1,10 +1,73 @@
 /**
- * Platform artifact URLs + the 404 beacon. The platform renders sitemap.xml,
- * robots.txt, llms.txt and the IndexNow key file per channel; the storefront
- * proxies them on its own origin (see `@sixtyninecommerce/client/next`'s
- * `createSeoArtifactHandler`).
+ * Platform artifact URLs, the framework-neutral artifact read, and the 404
+ * beacon. The platform renders sitemap.xml, robots.txt, llms.txt and the
+ * IndexNow key file per channel; the storefront serves them on its own origin
+ * (`createSeoArtifactResponder` from `@sixtyninecommerce/client/web`, or
+ * `createSeoArtifactHandler` from `@sixtyninecommerce/client/next`).
  */
+import { type PublicArtifactRead } from '../core/public-artifact.js';
+import type * as Plugins from '../generated/plugins.js';
 import type { StoreContext } from '../types.js';
+/** Every artifact the platform renders per store. */
+export declare const SEO_ARTIFACTS: readonly ["sitemap", "sitemap-child", "robots", "llms-txt", "indexnow-key"];
+export type SeoArtifact = (typeof SEO_ARTIFACTS)[number];
+/** The `200` body a path item's GET declares, whatever its media type. */
+type DeclaredBody<PathItem> = PathItem extends {
+    get: {
+        responses: {
+            200: {
+                content: infer Content;
+            };
+        };
+    };
+} ? Content[keyof Content] : never;
+/**
+ * One artifact read — see `client.seo.artifacts.fetch`. Narrow on `status`:
+ * only a `200` has a `body`: the text (`robots.txt`, `llms.txt`, the IndexNow
+ * key) or XML (the sitemaps) the plugins service declares — a `string`.
+ */
+export type SeoArtifactResult = PublicArtifactRead<DeclaredBody<Plugins.paths['/seo/artifacts/{channelCode}/sitemap.xml']> | DeclaredBody<Plugins.paths['/seo/artifacts/{channelCode}/sitemaps/{file}']> | DeclaredBody<Plugins.paths['/seo/artifacts/{channelCode}/robots.txt']> | DeclaredBody<Plugins.paths['/seo/artifacts/{channelCode}/llms.txt']> | DeclaredBody<Plugins.paths['/seo/artifacts/{channelCode}/indexnow-key.txt']>>;
+export interface SeoArtifactFetchOptions {
+    /**
+     * The child sitemap's file name (`products-1.xml`) — required for
+     * `'sitemap-child'`, refused for every other artifact.
+     */
+    childFile?: string;
+    /** The validator your caller sent (`If-None-Match`); a match answers `304`. */
+    ifNoneMatch?: string;
+    /** Cancels the read; an abort through it rejects with the signal's reason. */
+    signal?: AbortSignal;
+    /** Deadline for the whole read, body included; past it the result is `503`. Default 15s. */
+    timeoutMs?: number;
+}
+export interface SeoArtifactsModule {
+    /**
+     * Read one platform-rendered SEO artifact for this store — framework-neutral,
+     * so any server can serve it on the storefront's own origin.
+     *
+     * Never throws for an upstream problem: the result is `200` (body, content
+     * type, `ETag`), `304` (unchanged since `ifNoneMatch`), `404` (the platform
+     * has no such file for this store; `detail` says why — llms.txt is off, no
+     * SEO plugin or storefront URL, the child sitemap is gone) or `503` with
+     * `retryAfterSeconds` (another upstream status, in `upstreamStatus` with the
+     * platform's `detail`; or a network failure or the timeout, in `error`).
+     * Throws `StorefrontError` `INVALID_ARGUMENT` before any request
+     * for an unknown artifact, a missing or malformed `childFile` on
+     * `'sitemap-child'` (the platform's own rule: `<kind>-<n>.xml`), or a
+     * `childFile` on any other artifact; rejects with the signal's reason when
+     * YOUR `signal` aborts.
+     *
+     * Sends no credential (the files are public) and no `User-Agent` of the
+     * caller's, uses the client's configured `fetch`, and sets no cache policy.
+     *
+     * @example
+     * ```ts
+     * const robots = await client.seo.artifacts.fetch('robots');
+     * if (robots.status === 200) console.log(robots.etag, robots.body);
+     * ```
+     */
+    fetch(artifact: SeoArtifact, options?: SeoArtifactFetchOptions): Promise<SeoArtifactResult>;
+}
 export interface SeoArtifactUrls {
     /** Platform URL of the sitemap index, or of one child file when `childFile` is given. */
     sitemapUrl(childFile?: string): string;
@@ -14,6 +77,24 @@ export interface SeoArtifactUrls {
     indexnowKeyUrl(): string;
 }
 export declare function createArtifactUrls(ctx: StoreContext): SeoArtifactUrls;
+/** Upstream deadline when the caller names none. */
+export declare const DEFAULT_ARTIFACT_TIMEOUT_MS = 15000;
+/** Whether `name` is a child-sitemap file name the platform can serve. */
+export declare function isSitemapChildFile(name: string): boolean;
+export declare function isSeoArtifact(value: unknown): value is SeoArtifact;
+/**
+ * The platform URL of one artifact, with every argument refused before a
+ * request is made. Reads only the builder it needs, so a caller may pass any
+ * object carrying them (`client.seo` does).
+ */
+export declare function seoArtifactUrl(urls: Partial<SeoArtifactUrls>, artifact: SeoArtifact, childFile: string | undefined): string;
+/**
+ * The one artifact read every surface shares: `client.seo.artifacts.fetch`,
+ * the `/web` responder, the `/next` handler and the MCP preview. `init` adds
+ * framework keys to the request (the Next handler's `next: { tags }`).
+ */
+export declare function fetchSeoArtifact(urls: Partial<SeoArtifactUrls>, fetchFn: typeof globalThis.fetch, artifact: SeoArtifact, options: SeoArtifactFetchOptions | undefined, init?: Record<string, unknown>): Promise<SeoArtifactResult>;
+export declare function createArtifactsModule(ctx: StoreContext, urls: SeoArtifactUrls): SeoArtifactsModule;
 /**
  * Fire-and-forget 404 report — call from the storefront's not-found handler
  * so the platform can suggest redirects for dead URLs. Never throws, never
@@ -22,4 +103,5 @@ export declare function createArtifactUrls(ctx: StoreContext): SeoArtifactUrls;
 export declare function reportNotFound(ctx: StoreContext, path: string, options?: {
     referrer?: string;
 }): void;
+export {};
 //# sourceMappingURL=artifacts.d.ts.map

package/dist/seo/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/seo/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,SAAS,IAAI,MAAM,CAAC;IACpB,UAAU,IAAI,MAAM,CAAC;IACrB,6EAA6E;IAC7E,cAAc,IAAI,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,eAAe,CAkBrE;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,IAAI,CA0BN"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/seo/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/seo/artifacts.js

@@ -1,34 +1,128 @@
 /**
- * Platform artifact URLs + the 404 beacon. The platform renders sitemap.xml,
- * robots.txt, llms.txt and the IndexNow key file per channel; the storefront
- * proxies them on its own origin (see `@sixtyninecommerce/client/next`'s
- * `createSeoArtifactHandler`).
+ * Platform artifact URLs, the framework-neutral artifact read, and the 404
+ * beacon. The platform renders sitemap.xml, robots.txt, llms.txt and the
+ * IndexNow key file per channel; the storefront serves them on its own origin
+ * (`createSeoArtifactResponder` from `@sixtyninecommerce/client/web`, or
+ * `createSeoArtifactHandler` from `@sixtyninecommerce/client/next`).
  */
+import { readPublicArtifact } from '../core/public-artifact.js';
+import { StorefrontError } from '../errors.js';
+/** Every artifact the platform renders per store. */
+export const SEO_ARTIFACTS = [
+    'sitemap',
+    'sitemap-child',
+    'robots',
+    'llms-txt',
+    'indexnow-key',
+];
 export function createArtifactUrls(ctx) {
-    const base = `${ctx.pluginsUrl}/seo/artifacts/${encodeURIComponent(ctx.channel.code)}`;
+    // Per call, never at build: the store's code can move under a running client (a rename), and
+    // the old code's URLs stop answering a while after it.
+    const base = () => `${ctx.pluginsUrl}/seo/artifacts/${encodeURIComponent(ctx.channel.code)}`;
     return {
         sitemapUrl(childFile) {
             return childFile
-                ? `${base}/sitemaps/${encodeURIComponent(childFile)}`
-                : `${base}/sitemap.xml`;
+                ? `${base()}/sitemaps/${encodeURIComponent(childFile)}`
+                : `${base()}/sitemap.xml`;
         },
         robotsUrl() {
-            return `${base}/robots.txt`;
+            return `${base()}/robots.txt`;
         },
         llmsTxtUrl() {
-            return `${base}/llms.txt`;
+            return `${base()}/llms.txt`;
         },
         indexnowKeyUrl() {
-            return `${base}/indexnow-key.txt`;
+            return `${base()}/indexnow-key.txt`;
+        },
+    };
+}
+/** Upstream deadline when the caller names none. */
+export const DEFAULT_ARTIFACT_TIMEOUT_MS = 15_000;
+/**
+ * The platform's child-sitemap rule, verbatim from the plugins service
+ * (`seo/artifacts/artifacts.controller.ts`): `products-1.xml`, `collections-2.xml`.
+ * Checked here too so a crawler probing `/sitemaps/<anything>` is a `404` on
+ * the storefront, not a platform `400` a proxy would report as an outage.
+ * Locked to the controller AND the sitemap builder by
+ * `services/plugins/src/seo/__tests__/sitemap-child-name-parity.spec.ts`: widen
+ * the grammar there and here in the same change, and release this SDK before
+ * the platform emits the new names.
+ */
+const SITEMAP_CHILD_FILE = /^[a-z]+-\d+\.xml$/;
+/** Whether `name` is a child-sitemap file name the platform can serve. */
+export function isSitemapChildFile(name) {
+    return SITEMAP_CHILD_FILE.test(name);
+}
+function invalidArtifactArgument(message) {
+    return new StorefrontError(message, 'plugins', 400, 'INVALID_ARGUMENT');
+}
+export function isSeoArtifact(value) {
+    return typeof value === 'string' && SEO_ARTIFACTS.includes(value);
+}
+/**
+ * The platform URL of one artifact, with every argument refused before a
+ * request is made. Reads only the builder it needs, so a caller may pass any
+ * object carrying them (`client.seo` does).
+ */
+export function seoArtifactUrl(urls, artifact, childFile) {
+    if (!isSeoArtifact(artifact)) {
+        throw invalidArtifactArgument(`Unknown SEO artifact "${String(artifact)}". Expected one of: ${SEO_ARTIFACTS.join(', ')}.`);
+    }
+    if (artifact !== 'sitemap-child' && childFile !== undefined) {
+        throw invalidArtifactArgument(`childFile is only for 'sitemap-child'; '${artifact}' has no child files.`);
+    }
+    const builder = artifactUrlBuilder(urls, artifact);
+    if (artifact === 'sitemap-child') {
+        if (childFile === undefined || childFile === '') {
+            throw invalidArtifactArgument("'sitemap-child' requires childFile, the child sitemap's file name (e.g. products-1.xml).");
+        }
+        if (!isSitemapChildFile(childFile)) {
+            throw invalidArtifactArgument(`"${childFile}" is not a child sitemap file name; the platform serves <kind>-<n>.xml (e.g. products-1.xml).`);
+        }
+        return builder(childFile);
+    }
+    return builder();
+}
+function artifactUrlBuilder(urls, artifact) {
+    const builder = artifact === 'sitemap' || artifact === 'sitemap-child'
+        ? urls.sitemapUrl
+        : artifact === 'robots'
+            ? urls.robotsUrl
+            : artifact === 'llms-txt'
+                ? urls.llmsTxtUrl
+                : urls.indexnowKeyUrl;
+    if (typeof builder !== 'function') {
+        throw new TypeError(`The client has no URL builder for the '${artifact}' artifact.`);
+    }
+    return builder;
+}
+/**
+ * The one artifact read every surface shares: `client.seo.artifacts.fetch`,
+ * the `/web` responder, the `/next` handler and the MCP preview. `init` adds
+ * framework keys to the request (the Next handler's `next: { tags }`).
+ */
+export function fetchSeoArtifact(urls, fetchFn, artifact, options, init) {
+    const url = seoArtifactUrl(urls, artifact, options?.childFile);
+    return readPublicArtifact(fetchFn, url, (response) => response.text(), {
+        timeoutMs: options?.timeoutMs ?? DEFAULT_ARTIFACT_TIMEOUT_MS,
+        ...(options?.ifNoneMatch ? { ifNoneMatch: options.ifNoneMatch } : {}),
+        ...(options?.signal ? { signal: options.signal } : {}),
+        ...(init ? { init } : {}),
+    });
+}
+export function createArtifactsModule(ctx, urls) {
+    return {
+        async fetch(artifact, options) {
+            return fetchSeoArtifact(urls, ctx.fetch, artifact, options);
         },
     };
 }
 const BEACON_TIMEOUT_MS = 2_000;
 /**
- * Per-process dedup set, capped so a long-lived server process being crawled
- * for random URLs can't grow it without bound. Past the cap the set resets:
- * occasional re-reports are fine (the platform aggregates), unbounded memory
- * is not.
+ * Per-process dedup set of `<channel id>\0<path>`, capped so a long-lived
+ * server process being crawled for random URLs can't grow it without bound.
+ * Past the cap the set resets: occasional re-reports are fine (the platform
+ * aggregates), unbounded memory is not.
  */
 const MAX_REPORTED_PATHS = 5_000;
 const reportedPaths = new Set();
@@ -38,13 +132,18 @@ const reportedPaths = new Set();
  * blocks rendering; deduped per process/session.
  */
 export function reportNotFound(ctx, path, options) {
-    if (!path.startsWith('/') || path.length > 2000 || reportedPaths.has(path)) {
+    // Keyed by STORE and path: the set is per process, and a process may serve
+    // several stores (`createStorefrontClient({ resolveStore })`, or two clients
+    // side by side) — keyed by path alone, store B's dead `/sale` was never
+    // reported once store A had reported its own.
+    const key = `${ctx.channel.id}\u0000${path}`;
+    if (!path.startsWith('/') || path.length > 2000 || reportedPaths.has(key)) {
         return;
     }
     if (reportedPaths.size >= MAX_REPORTED_PATHS) {
         reportedPaths.clear();
     }
-    reportedPaths.add(path);
+    reportedPaths.add(key);
     try {
         void ctx
             .fetch(`${ctx.pluginsUrl}/seo/not-found-reports`, {

package/dist/seo/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/seo/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,UAAU,kBAAkB,CAAC,GAAiB;IAClD,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,UAAU,kBAAkB,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACvF,OAAO;QACL,UAAU,CAAC,SAAkB;YAC3B,OAAO,SAAS;gBACd,CAAC,CAAC,GAAG,IAAI,aAAa,kBAAkB,CAAC,SAAS,CAAC,EAAE;gBACrD,CAAC,CAAC,GAAG,IAAI,cAAc,CAAC;QAC5B,CAAC;QACD,SAAS;YACP,OAAO,GAAG,IAAI,aAAa,CAAC;QAC9B,CAAC;QACD,UAAU;YACR,OAAO,GAAG,IAAI,WAAW,CAAC;QAC5B,CAAC;QACD,cAAc;YACZ,OAAO,GAAG,IAAI,mBAAmB,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAiB,EACjB,IAAY,EACZ,OAA+B;IAE/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC7C,aAAa,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,KAAK,GAAG;aACL,KAAK,CAAC,GAAG,GAAG,CAAC,UAAU,wBAAwB,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;aAC/B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC;YACnE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC;SAC/C,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,mCAAmC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;AACH,CAAC"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/seo/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/seo/availability.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Availability for structured data: one variant's stock + merchant publication
+ * state, expressed as the schema.org `ItemAvailability` URL that
+ * `Offer.availability` wants and the OpenGraph token `product:availability`
+ * wants.
+ *
+ * These are separate vocabularies for the same fact, and `ProductSeoExtras`
+ * carries ONE `availability` string that feeds both tags. So the schema.org URL
+ * is the value a storefront passes, and `openGraphAvailability` translates it
+ * back for the OpenGraph tag. Anything the SDK does not recognise is passed
+ * through untouched, which is what every caller that predates this file gets.
+ */
+import type { ProductAvailabilityFragment } from '../generated/shop.js';
+/** The three `ItemAvailability` members this SDK emits. */
+export type SchemaOrgAvailability = 'https://schema.org/InStock' | 'https://schema.org/OutOfStock' | 'https://schema.org/PreOrder';
+/**
+ * What `schemaOrgAvailability` reads; satisfied by every SDK variant shape AND
+ * by a search row. The stock signals are the ones `isPreorderOnly` reads, read
+ * the same way (`knownNothingSaleable`), so the feed and the badge cannot
+ * disagree about whether a pre-order is buyable today.
+ */
+export interface AvailabilityForSeo {
+    /**
+     * The merchant publication state in force. Absent or `null` (a search row
+     * that predates the attribute, an older engine) is read as "nothing in
+     * force" — the pre-order-free behaviour.
+     */
+    availability?: ProductAvailabilityFragment | null;
+    /** Available-to-promise units — the precise signal, preferred when present. */
+    saleable?: number | null;
+    /** A search row's stock flag, the only stock signal `SEARCH_PRODUCTS` selects. */
+    inStock?: boolean | null;
+    /** Vendure's display string — `'IN_STOCK'` / `'OUT_OF_STOCK'`. */
+    stockLevel?: string | null;
+}
+/**
+ * The schema.org `ItemAvailability` URL for a variant. Pass the result as
+ * `extras.availability` to `metaTagsFor` — JSON-LD emits it verbatim as
+ * `Offer.availability`, and the OpenGraph `product:availability` tag gets the
+ * matching Facebook token automatically.
+ *
+ * ```ts
+ * const extras = {
+ *   availability: schemaOrgAvailability(variant),
+ *   availabilityStarts: variant.availability?.availableFrom,
+ *   ...
+ * };
+ * ```
+ *
+ * | state | stock the storefront can SEE | result |
+ * |---|---|---|
+ * | `comingSoon` | anything | `OutOfStock` |
+ * | `preorder` | known nothing to buy | `PreOrder` |
+ * | `preorder` | known stock, or no signal | `InStock` |
+ * | anything else | known nothing to buy | `OutOfStock` |
+ * | anything else | known stock, or no signal | `InStock` |
+ *
+ * **Coming soon is `OutOfStock`, whatever the stock.** schema.org defines
+ * `PreOrder` as "Indicates that the item is available for pre-order" — an
+ * assertion that it can be ORDERED now for later delivery, which is the one
+ * thing this SDK guarantees a coming-soon item is not (`orderable: false`,
+ * `canAddToCart` false, and the engine refuses every add with
+ * `quantityAvailable: 0`, stock on hand or not). Emitting it would advertise a
+ * purchasable offer behind a disabled buy button — a Merchant Center
+ * availability-versus-landing-page mismatch. `OutOfStock` is the honest
+ * member for "not currently purchasable". (`SoldOut` is wrong the other way:
+ * it says the item HAD stock and it went, not that it has not launched.)
+ *
+ * **A pre-order is `PreOrder` only while there is nothing to buy outright** —
+ * exactly when `isPreorderOnly(variant)` is true, through the same
+ * `knownNothingSaleable` predicate. Stock never ENDS a pre-order state (the
+ * merchant may keep selling from the warehouse while it stands), but a variant
+ * with stock on hand ships today: the page shows the ordinary in-stock UI, and
+ * a feed saying "Pre-order, available 12 March" for it is the same mismatch in
+ * the other direction. So it is `InStock`, and the JSON-LD composer drops
+ * `availabilityStarts` for an `InStock` offer. When no stock signal is
+ * readable it is not claimed as a pre-order either, matching the label.
+ *
+ * Everything else is today's rule, read through the same predicate:
+ * `saleable` when the channel exposes it, then a search row's `inStock`, then
+ * the `stockLevel` string, and `InStock` when nothing says otherwise. An
+ * unknown state — one a later engine added — falls through to the stock rule
+ * rather than throwing, which is why this is a chain of comparisons and not a
+ * `switch`.
+ */
+export declare function schemaOrgAvailability(variant: AvailabilityForSeo): SchemaOrgAvailability;
+/**
+ * The OpenGraph `product:availability` token for an availability value.
+ *
+ * Translates the three schema.org URLs into Facebook's vocabulary and passes
+ * anything else through verbatim — so a storefront that has always passed
+ * `'in stock'` keeps emitting `'in stock'`, byte for byte.
+ */
+export declare function openGraphAvailability(availability: string): string;
+//# sourceMappingURL=availability.d.ts.map

package/dist/seo/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../src/seo/availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAIxE,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAC7B,4BAA4B,GAC5B,+BAA+B,GAC/B,6BAA6B,CAAC;AAGlC;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,qBAAqB,CAMxF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKlE"}

package/dist/seo/availability.js

@@ -0,0 +1,89 @@
+/**
+ * Availability for structured data: one variant's stock + merchant publication
+ * state, expressed as the schema.org `ItemAvailability` URL that
+ * `Offer.availability` wants and the OpenGraph token `product:availability`
+ * wants.
+ *
+ * These are separate vocabularies for the same fact, and `ProductSeoExtras`
+ * carries ONE `availability` string that feeds both tags. So the schema.org URL
+ * is the value a storefront passes, and `openGraphAvailability` translates it
+ * back for the OpenGraph tag. Anything the SDK does not recognise is passed
+ * through untouched, which is what every caller that predates this file gets.
+ */
+import { knownNothingSaleable } from '../pricing/validation.js';
+/**
+ * The schema.org `ItemAvailability` URL for a variant. Pass the result as
+ * `extras.availability` to `metaTagsFor` — JSON-LD emits it verbatim as
+ * `Offer.availability`, and the OpenGraph `product:availability` tag gets the
+ * matching Facebook token automatically.
+ *
+ * ```ts
+ * const extras = {
+ *   availability: schemaOrgAvailability(variant),
+ *   availabilityStarts: variant.availability?.availableFrom,
+ *   ...
+ * };
+ * ```
+ *
+ * | state | stock the storefront can SEE | result |
+ * |---|---|---|
+ * | `comingSoon` | anything | `OutOfStock` |
+ * | `preorder` | known nothing to buy | `PreOrder` |
+ * | `preorder` | known stock, or no signal | `InStock` |
+ * | anything else | known nothing to buy | `OutOfStock` |
+ * | anything else | known stock, or no signal | `InStock` |
+ *
+ * **Coming soon is `OutOfStock`, whatever the stock.** schema.org defines
+ * `PreOrder` as "Indicates that the item is available for pre-order" — an
+ * assertion that it can be ORDERED now for later delivery, which is the one
+ * thing this SDK guarantees a coming-soon item is not (`orderable: false`,
+ * `canAddToCart` false, and the engine refuses every add with
+ * `quantityAvailable: 0`, stock on hand or not). Emitting it would advertise a
+ * purchasable offer behind a disabled buy button — a Merchant Center
+ * availability-versus-landing-page mismatch. `OutOfStock` is the honest
+ * member for "not currently purchasable". (`SoldOut` is wrong the other way:
+ * it says the item HAD stock and it went, not that it has not launched.)
+ *
+ * **A pre-order is `PreOrder` only while there is nothing to buy outright** —
+ * exactly when `isPreorderOnly(variant)` is true, through the same
+ * `knownNothingSaleable` predicate. Stock never ENDS a pre-order state (the
+ * merchant may keep selling from the warehouse while it stands), but a variant
+ * with stock on hand ships today: the page shows the ordinary in-stock UI, and
+ * a feed saying "Pre-order, available 12 March" for it is the same mismatch in
+ * the other direction. So it is `InStock`, and the JSON-LD composer drops
+ * `availabilityStarts` for an `InStock` offer. When no stock signal is
+ * readable it is not claimed as a pre-order either, matching the label.
+ *
+ * Everything else is today's rule, read through the same predicate:
+ * `saleable` when the channel exposes it, then a search row's `inStock`, then
+ * the `stockLevel` string, and `InStock` when nothing says otherwise. An
+ * unknown state — one a later engine added — falls through to the stock rule
+ * rather than throwing, which is why this is a chain of comparisons and not a
+ * `switch`.
+ */
+export function schemaOrgAvailability(variant) {
+    const state = variant.availability?.state;
+    if (state === 'comingSoon')
+        return 'https://schema.org/OutOfStock';
+    const nothingSaleable = knownNothingSaleable(variant) === true;
+    if (state === 'preorder' && nothingSaleable)
+        return 'https://schema.org/PreOrder';
+    return nothingSaleable ? 'https://schema.org/OutOfStock' : 'https://schema.org/InStock';
+}
+/**
+ * The OpenGraph `product:availability` token for an availability value.
+ *
+ * Translates the three schema.org URLs into Facebook's vocabulary and passes
+ * anything else through verbatim — so a storefront that has always passed
+ * `'in stock'` keeps emitting `'in stock'`, byte for byte.
+ */
+export function openGraphAvailability(availability) {
+    if (availability === 'https://schema.org/InStock')
+        return 'in stock';
+    if (availability === 'https://schema.org/OutOfStock')
+        return 'out of stock';
+    if (availability === 'https://schema.org/PreOrder')
+        return 'preorder';
+    return availability;
+}
+//# sourceMappingURL=availability.js.map

package/dist/seo/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/seo/availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AA+BhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC;IAC1C,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,+BAA+B,CAAC;IACnE,MAAM,eAAe,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/D,IAAI,KAAK,KAAK,UAAU,IAAI,eAAe;QAAE,OAAO,6BAA6B,CAAC;IAClF,OAAO,eAAe,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,4BAA4B,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,IAAI,YAAY,KAAK,4BAA4B;QAAE,OAAO,UAAU,CAAC;IACrE,IAAI,YAAY,KAAK,+BAA+B;QAAE,OAAO,cAAc,CAAC;IAC5E,IAAI,YAAY,KAAK,6BAA6B;QAAE,OAAO,UAAU,CAAC;IACtE,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/seo/index.d.ts

@@ -2,6 +2,10 @@ import type { StoreContext } from '../types.js';
 import type { SeoModule } from './types.js';
 export declare function createSeoModule(ctx: StoreContext): SeoModule;
 export type { AiSummaryInput, LlmsTxtEntryInput, } from './ai.js';
+export type { SeoArtifact, SeoArtifactFetchOptions, SeoArtifactResult, SeoArtifactsModule, } from './artifacts.js';
+export { isSitemapChildFile, SEO_ARTIFACTS } from './artifacts.js';
+export type { AvailabilityForSeo, SchemaOrgAvailability } from './availability.js';
+export { openGraphAvailability, schemaOrgAvailability } from './availability.js';
 export type { CmsMetaTagsInput, CmsSeoExtras, CollectionMetaTagsInput, CollectionSeoExtras, HreflangLinkTag, MetaTagsEntityInput, MetaTagsResult, OpenGraphTag, ProductMetaTagsInput, ProductSeoExtras, TwitterTag, } from './meta-tags.js';
 export type { RawCmsSeo, RawCollectionSeo, RawProductMetadata } from './metadata-parser.js';
 export { parseCmsItemMetadata, parseCollectionMetadata, parseProductMetadata, robotsFromFlags, } from './metadata-parser.js';

package/dist/seo/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5D,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CAyE5D;AAED,YAAY,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,EACN,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,OAAO,EACP,SAAS,EACT,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5D,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CA2E5D;AAED,YAAY,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACjF,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,EACN,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,OAAO,EACP,SAAS,EACT,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/seo/index.js

@@ -1,7 +1,8 @@
 import { createContextAssetUrlResolver } from '../media/urls.js';
 import { aiSummaryFor, llmsTxtEntryFor } from './ai.js';
 import { alternatesFor } from './alternates.js';
-import { createArtifactUrls, reportNotFound } from './artifacts.js';
+import { createArtifactsModule, createArtifactUrls, reportNotFound } from './artifacts.js';
+import { schemaOrgAvailability } from './availability.js';
 import { canonicalFor } from './canonical.js';
 import { metaTagsFor } from './meta-tags.js';
 import { composePerBotDirectives } from './robots.js';
@@ -16,6 +17,7 @@ export function createSeoModule(ctx) {
         robotsUrl: artifacts.robotsUrl,
         llmsTxtUrl: artifacts.llmsTxtUrl,
         indexnowKeyUrl: artifacts.indexnowKeyUrl,
+        artifacts: createArtifactsModule(ctx, artifacts),
         reportNotFound(path, options) {
             reportNotFound(ctx, path, options);
         },
@@ -72,6 +74,7 @@ export function createSeoModule(ctx) {
                 xRobotsHeaders: [],
             };
         },
+        schemaOrgAvailability,
         aiSummaryFor(entity) {
             return aiSummaryFor(entity);
         },
@@ -80,6 +83,8 @@ export function createSeoModule(ctx) {
         },
     };
 }
+export { isSitemapChildFile, SEO_ARTIFACTS } from './artifacts.js';
+export { openGraphAvailability, schemaOrgAvailability } from './availability.js';
 export { parseCmsItemMetadata, parseCollectionMetadata, parseProductMetadata, robotsFromFlags, } from './metadata-parser.js';
 export { DEFAULT_PRODUCT_PATH_SEGMENT, isUserFacingRoot, normalizeProductPathSegment, pickCanonicalRootIndex, } from './product-path.js';
 export { buildUrl, readUrlStrategy } from './url-builder.js';

package/dist/seo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"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"}

package/dist/seo/json-ld.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../../src/seo/json-ld.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAuB1D,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,eAAe,EAAE,gBAAgB,CAAC;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyDvF;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,iBAAiB,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAClD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkB7F;AAqCD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,gFAAgF;IAChF,eAAe,EAAE,gBAAgB,CAAC;CACnC;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWvF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWhF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtF"}
+{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../../src/seo/json-ld.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAwB1D,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,eAAe,EAAE,gBAAgB,CAAC;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D;AAYD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiFvF;AAGD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,iBAAiB,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAClD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkB7F;AAsCD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,gFAAgF;IAChF,eAAe,EAAE,gBAAgB,CAAC;CACnC;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWvF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWhF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtF"}

package/dist/seo/json-ld.js

@@ -24,6 +24,15 @@ function pickImageUrls(resolveAssetUrl, ...assets) {
     }
     return urls;
 }
+/**
+ * The two `ItemAvailability` values `schemaOrgAvailability` returns for an
+ * offer that cannot be bought outright today — the only ones a future
+ * `availabilityStarts` is consistent with. `InStock` is deliberately absent.
+ */
+const NOT_PURCHASABLE_NOW = new Set([
+    'https://schema.org/PreOrder',
+    'https://schema.org/OutOfStock',
+]);
 export function composeProductJsonLd(input) {
     const { product, metadata, canonical, title, description, extras, reviews } = input;
     const out = {
@@ -50,9 +59,33 @@ export function composeProductJsonLd(input) {
         };
         if (extras.availability) {
             // schema.org expects an ItemAvailability URL, but text is also widely
-            // accepted by validators. Pass-through whatever the storefront provides.
+            // accepted by validators. Pass-through whatever the storefront provides —
+            // `schemaOrgAvailability(variant)` (`./availability.js`) is what produces
+            // the URL, and it is the only way `PreOrder` ever gets emitted: a
+            // pre-order with nothing on hand reads 0 stock, so anything derived from
+            // `stockLevel` alone would say `OutOfStock` and hide a product the
+            // merchant is actively taking orders for.
             offer.availability = extras.availability;
         }
+        if (extras.availabilityStarts && NOT_PURCHASABLE_NOW.has(extras.availability ?? '')) {
+            // `https://schema.org/availabilityStarts` — "The beginning of the
+            // availability of the product or service included in the offer", a
+            // property of `Offer` (verified against schema.org). It is the date half
+            // of the two merchant states: a `PreOrder` with no availability date is
+            // an item-level feed error, and a coming-soon item (mapped to
+            // `OutOfStock`, which says nothing about WHEN) has no other way to say
+            // it is arriving.
+            //
+            // Only beside an offer that is NOT purchasable now. A pre-order with stock
+            // on hand is `InStock` — it ships today — and "in stock, available from
+            // 12 March" contradicts itself; a storefront passing
+            // `variant.availability?.availableFrom` unconditionally must not produce
+            // that. A hand-written availability string is not recognised either: the
+            // SDK cannot tell whether that offer is purchasable now. Nothing is
+            // emitted without a date, so an offer from a storefront that predates this
+            // field is byte-identical.
+            offer.availabilityStarts = extras.availabilityStarts;
+        }
         if (extras.condition) {
             offer.itemCondition = `https://schema.org/${extras.condition === 'new'
                 ? 'NewCondition'