@sixtyninecommerce/client 0.23.1 → 0.25.0

package/dist/seo/metadata-types.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Parsed, strict types for the per-product SEO/social/AI metadata exposed by
+ * `Product.metadata` on the shop API. The raw GraphQL payload uses `JSON`
+ * scalars for several fields — we parse and validate at the SDK boundary so
+ * business logic only ever sees these typed shapes.
+ */
 import type { Asset } from '../types.js';
 export type MetaRobotsIndexDirective = 'index' | 'noindex';
 export type MetaRobotsFollowDirective = 'follow' | 'nofollow';
@@ -11,6 +17,7 @@ export interface MetaRobots {
     maxSnippet: number | null;
     maxImagePreview: MetaRobotsMaxImagePreview;
     maxVideoPreview: number | null;
+    /** ISO-8601 instant with timezone, or null. */
     unavailableAfter: string | null;
 }
 export interface QAPair {
@@ -48,6 +55,13 @@ export interface ProductMetadataAi {
     emitFaqpageJsonld: boolean;
     resolvedBotDirectives: Record<string, BotDirective>;
 }
+/**
+ * The SEO/social metadata subset shared by every page kind (product,
+ * collection, CMS). `metaTagsFor()` operates on this shape so title,
+ * description, canonical, robots, OpenGraph and Twitter resolution is written
+ * once and reused across kinds. Product-only extras (AI directives, review
+ * JSON-LD, hreflang overrides, breadcrumb overrides) live on `ProductMetadata`.
+ */
 export interface CommonSeoMetadata {
     seoTitle: string | null;
     seoDescription: string | null;
@@ -62,7 +76,9 @@ export interface ProductMetadata extends CommonSeoMetadata {
     breadcrumbOverride: BreadcrumbOverrideEntry[];
     includeReviewsInJsonld: boolean;
 }
+/** Per-collection SEO metadata (subset of the product shape). */
 export type CollectionMetadata = CommonSeoMetadata;
+/** Per-CMS-item SEO metadata: the shared subset plus an optional AI summary. */
 export interface CmsItemMetadata extends CommonSeoMetadata {
     aiSummary: string | null;
 }

package/dist/seo/metadata-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-types.d.ts","sourceRoot":"","sources":["../../src/seo/metadata-types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,wBAAwB,CAAC;IAChC,MAAM,EAAE,yBAAyB,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,yBAAyB,CAAC;IAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,qBAAqB,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AACjD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrD;AASD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,EAAE,EAAE,iBAAiB,CAAC;IACtB,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;IAC3C,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAGD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAGnD,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}
+{"version":3,"file":"metadata-types.d.ts","sourceRoot":"","sources":["../../src/seo/metadata-types.ts"],"names":[],"mappings":"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"}

package/dist/seo/product-path.d.ts

@@ -1,10 +1,106 @@
+/**
+ * The ONE rule for where a product's canonical URL lives.
+ *
+ * Three surfaces used to answer this independently, and for a product in
+ * several collections with none flagged canonical they gave three different
+ * answers for the same product at the same moment:
+ *
+ *   - `seo.metaTagsFor` / `canonicalFor`  →  /products/{slug}   (hardcoded)
+ *   - `navigation.getRoutes`              →  shallowest-then-lexicographic
+ *                                            collection path
+ *   - the sitemap artifact                →  whichever collection path the
+ *                                            Shop API happened to return first
+ *
+ * None of them resolved on the storefronts they were generated for, and a
+ * canonical pointing at a 404 is worse than emitting none. This module holds
+ * the decision so the surfaces cannot drift again; `services/plugins` imports
+ * it from the published client rather than reimplementing it.
+ *
+ * The rule:
+ *   1. If the product belongs to a ROOT collection flagged
+ *      `customFields.isCanonical`, its canonical URL nests under that
+ *      collection. Lowest `position` wins; a caller-supplied key breaks ties so
+ *      the choice is stable across runs and across surfaces.
+ *   2. Otherwise the canonical URL is FLAT: `/{productPathSegment}/{slug}`.
+ *      Never a collection path — which collection a product happens to sit in
+ *      is not a property of the product, and letting it decide the canonical is
+ *      what made the three answers diverge.
+ */
+/** Used when a channel sets no `productPathSegment`. */
 export declare const DEFAULT_PRODUCT_PATH_SEGMENT = "products";
+/**
+ * Resolve the channel's configured product path segment.
+ *
+ * NULL, empty and whitespace all mean "unset" → the default, so a channel that
+ * never sets the field keeps the shape it had before the field existed. Leading
+ * and trailing slashes are tolerated and stripped: a merchant typing
+ * `/product/` means the same thing as `product`.
+ *
+ * Lowercased, because storefront routes are. A merchant typing `Products`
+ * would otherwise get `https://site/Products/x` as the canonical for a page
+ * served at `/products/x` — a canonical pointing at a 404, plus a case-variant
+ * duplicate for crawlers. The channel field's validator accepts either case
+ * precisely because this normalizes it.
+ */
 export declare function normalizeProductPathSegment(raw: string | null | undefined): string;
+/**
+ * Index of the canonical-root entry, or null when the product has none and the
+ * caller should therefore use the flat product path.
+ *
+ * `tiebreak` keeps the result deterministic when two roots share a `position`.
+ * Every caller MUST pass the collection's **id**, and the reason is that the id
+ * is the only candidate that is language-invariant:
+ *
+ *   - the route manifest fetches collections PER LANGUAGE, so its `slug` is the
+ *     nl slug on the nl pass;
+ *   - the SDK holds ONE fetched entity and emits every locale's URL from it, so
+ *     its `slug` is whichever language the storefront fetched in.
+ *
+ * Tiebreaking on a slug therefore picks `wijnen` on one side and `deals` on the
+ * other for the same product, and the sitemap ends up flagging a different URL
+ * canonical than the page's own `<link rel="canonical">`. The path is worse
+ * still: `-` (0x2D) sorts below `/` (0x2F), so `shop` vs `shop-nl` diverges even
+ * in one language.
+ *
+ * The cost is that an equal-`position` tie resolves by an opaque id rather than
+ * something a merchant can predict. That is acceptable because it is only
+ * reachable by flagging two root collections canonical at the SAME position —
+ * give them distinct positions to choose deliberately.
+ */
 export declare function pickCanonicalRootIndex(entries: ReadonlyArray<{
     position: number;
     tiebreak: string;
 }>): number | null;
+/** Vendure's synthetic tree root. Never a user-facing collection. */
 export declare const ROOT_COLLECTION_SLUG = "__root_collection__";
+/**
+ * Whether a collection is a USER-FACING root — i.e. `isCanonical` can mean
+ * something on it.
+ *
+ * ONLY a parent that IS the sentinel counts. Two wrong answers to avoid:
+ *
+ *   - `parent == null` was the original predicate and matched nothing real.
+ *     Vendure's Shop API resolves a top-level collection's parent to the
+ *     `__root_collection__` sentinel, not to null (verified against production:
+ *     `collection(id: <top-level>)` returns
+ *     `parent: { slug: "__root_collection__" }`), so canonical roots were never
+ *     found and every product fell back to the flat path.
+ *
+ *   - Treating null as root is ALSO wrong, and is why the null branch is gone.
+ *     On the Shop API `parent` is `undefined` exactly when the real parent is
+ *     PRIVATE (`CollectionEntityResolver.parent`: `apiType === 'shop' &&
+ *     parent?.isPrivate ? undefined : parent`). A public collection under a
+ *     private parent is not a root — and `CollectionService.getBreadcrumbs`
+ *     does NOT filter private ancestors, so the routes manifest sees the full
+ *     chain and does not treat it as one either. Calling it a root here would
+ *     make the page self-declare `/{child}/{product}` while the manifest
+ *     advertises the flat path: a canonical pointing at a URL no route serves.
+ *
+ * A parent with no `slug` selected is likewise not provably a root, so it takes
+ * the flat path. That is the conservative direction throughout — a wrong
+ * nesting is worse than a flat canonical — and the SDK's own product queries
+ * select `parent { id slug }` so its callers get the right answer by default.
+ */
 export declare function isUserFacingRoot(collection: {
     parent?: {
         id: string;

package/dist/seo/product-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-path.d.ts","sourceRoot":"","sources":["../../src/seo/product-path.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAgBvD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQlF;AA0BD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,MAAM,GAAG,IAAI,CAiBf;AAGD,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AA8B1D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE;IAC3C,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C,GAAG,OAAO,CAEV"}
+{"version":3,"file":"product-path.d.ts","sourceRoot":"","sources":["../../src/seo/product-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,wDAAwD;AACxD,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQlF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,MAAM,GAAG,IAAI,CAiBf;AAED,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE;IAC3C,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C,GAAG,OAAO,CAEV"}

package/dist/seo/product-path.js

@@ -1,4 +1,47 @@
+/**
+ * The ONE rule for where a product's canonical URL lives.
+ *
+ * Three surfaces used to answer this independently, and for a product in
+ * several collections with none flagged canonical they gave three different
+ * answers for the same product at the same moment:
+ *
+ *   - `seo.metaTagsFor` / `canonicalFor`  →  /products/{slug}   (hardcoded)
+ *   - `navigation.getRoutes`              →  shallowest-then-lexicographic
+ *                                            collection path
+ *   - the sitemap artifact                →  whichever collection path the
+ *                                            Shop API happened to return first
+ *
+ * None of them resolved on the storefronts they were generated for, and a
+ * canonical pointing at a 404 is worse than emitting none. This module holds
+ * the decision so the surfaces cannot drift again; `services/plugins` imports
+ * it from the published client rather than reimplementing it.
+ *
+ * The rule:
+ *   1. If the product belongs to a ROOT collection flagged
+ *      `customFields.isCanonical`, its canonical URL nests under that
+ *      collection. Lowest `position` wins; a caller-supplied key breaks ties so
+ *      the choice is stable across runs and across surfaces.
+ *   2. Otherwise the canonical URL is FLAT: `/{productPathSegment}/{slug}`.
+ *      Never a collection path — which collection a product happens to sit in
+ *      is not a property of the product, and letting it decide the canonical is
+ *      what made the three answers diverge.
+ */
+/** Used when a channel sets no `productPathSegment`. */
 export const DEFAULT_PRODUCT_PATH_SEGMENT = 'products';
+/**
+ * Resolve the channel's configured product path segment.
+ *
+ * NULL, empty and whitespace all mean "unset" → the default, so a channel that
+ * never sets the field keeps the shape it had before the field existed. Leading
+ * and trailing slashes are tolerated and stripped: a merchant typing
+ * `/product/` means the same thing as `product`.
+ *
+ * Lowercased, because storefront routes are. A merchant typing `Products`
+ * would otherwise get `https://site/Products/x` as the canonical for a page
+ * served at `/products/x` — a canonical pointing at a 404, plus a case-variant
+ * duplicate for crawlers. The channel field's validator accepts either case
+ * precisely because this normalizes it.
+ */
 export function normalizeProductPathSegment(raw) {
     if (typeof raw !== 'string')
         return DEFAULT_PRODUCT_PATH_SEGMENT;
@@ -9,6 +52,30 @@ export function normalizeProductPathSegment(raw) {
         .toLowerCase();
     return trimmed === '' ? DEFAULT_PRODUCT_PATH_SEGMENT : trimmed;
 }
+/**
+ * Index of the canonical-root entry, or null when the product has none and the
+ * caller should therefore use the flat product path.
+ *
+ * `tiebreak` keeps the result deterministic when two roots share a `position`.
+ * Every caller MUST pass the collection's **id**, and the reason is that the id
+ * is the only candidate that is language-invariant:
+ *
+ *   - the route manifest fetches collections PER LANGUAGE, so its `slug` is the
+ *     nl slug on the nl pass;
+ *   - the SDK holds ONE fetched entity and emits every locale's URL from it, so
+ *     its `slug` is whichever language the storefront fetched in.
+ *
+ * Tiebreaking on a slug therefore picks `wijnen` on one side and `deals` on the
+ * other for the same product, and the sitemap ends up flagging a different URL
+ * canonical than the page's own `<link rel="canonical">`. The path is worse
+ * still: `-` (0x2D) sorts below `/` (0x2F), so `shop` vs `shop-nl` diverges even
+ * in one language.
+ *
+ * The cost is that an equal-`position` tie resolves by an opaque id rather than
+ * something a merchant can predict. That is acceptable because it is only
+ * reachable by flagging two root collections canonical at the SAME position —
+ * give them distinct positions to choose deliberately.
+ */
 export function pickCanonicalRootIndex(entries) {
     let best = null;
     for (let i = 0; i < entries.length; i += 1) {
@@ -25,7 +92,36 @@ export function pickCanonicalRootIndex(entries) {
     }
     return best;
 }
+/** Vendure's synthetic tree root. Never a user-facing collection. */
 export const ROOT_COLLECTION_SLUG = '__root_collection__';
+/**
+ * Whether a collection is a USER-FACING root — i.e. `isCanonical` can mean
+ * something on it.
+ *
+ * ONLY a parent that IS the sentinel counts. Two wrong answers to avoid:
+ *
+ *   - `parent == null` was the original predicate and matched nothing real.
+ *     Vendure's Shop API resolves a top-level collection's parent to the
+ *     `__root_collection__` sentinel, not to null (verified against production:
+ *     `collection(id: <top-level>)` returns
+ *     `parent: { slug: "__root_collection__" }`), so canonical roots were never
+ *     found and every product fell back to the flat path.
+ *
+ *   - Treating null as root is ALSO wrong, and is why the null branch is gone.
+ *     On the Shop API `parent` is `undefined` exactly when the real parent is
+ *     PRIVATE (`CollectionEntityResolver.parent`: `apiType === 'shop' &&
+ *     parent?.isPrivate ? undefined : parent`). A public collection under a
+ *     private parent is not a root — and `CollectionService.getBreadcrumbs`
+ *     does NOT filter private ancestors, so the routes manifest sees the full
+ *     chain and does not treat it as one either. Calling it a root here would
+ *     make the page self-declare `/{child}/{product}` while the manifest
+ *     advertises the flat path: a canonical pointing at a URL no route serves.
+ *
+ * A parent with no `slug` selected is likewise not provably a root, so it takes
+ * the flat path. That is the conservative direction throughout — a wrong
+ * nesting is worse than a flat canonical — and the SDK's own product queries
+ * select `parent { id slug }` so its callers get the right answer by default.
+ */
 export function isUserFacingRoot(collection) {
     return collection.parent?.slug === ROOT_COLLECTION_SLUG;
 }

package/dist/seo/product-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"product-path.js","sourceRoot":"","sources":["../../src/seo/product-path.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;AAgBvD,MAAM,UAAU,2BAA2B,CAAC,GAA8B;IACxE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,4BAA4B,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG;SAChB,IAAI,EAAE;SACN,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,OAAO,CAAC;AACjE,CAAC;AA0BD,MAAM,UAAU,sBAAsB,CACpC,OAA8D;IAE9D,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,CAAC;YACT,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAE,CAAC;QACjC,IACE,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ;YACnC,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,EAC9E,CAAC;YACD,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAGD,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AA8B1D,MAAM,UAAU,gBAAgB,CAAC,UAEhC;IACC,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,KAAK,oBAAoB,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"product-path.js","sourceRoot":"","sources":["../../src/seo/product-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAA8B;IACxE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,4BAA4B,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG;SAChB,IAAI,EAAE;SACN,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,OAAO,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA8D;IAE9D,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,CAAC;YACT,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAE,CAAC;QACjC,IACE,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ;YACnC,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,EAC9E,CAAC;YACD,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAEhC;IACC,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,KAAK,oBAAoB,CAAC;AAC1D,CAAC"}

package/dist/seo/robots.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Robots / X-Robots directive composers. Given the parsed `metaRobots` block,
+ * produce the strings & tag descriptors a storefront needs to render in
+ * `<head>` or to attach to HTTP responses for non-HTML resources.
+ */
 import type { BotDirective, MetaRobots, ProductMetadata } from './metadata-types.js';
 export interface RobotsMetaTag {
     name: string;
@@ -16,6 +21,18 @@ export interface PerBotDirectives {
     metaTags: RobotsMetaTag[];
     xRobotsHeaders: RobotsXRobotsHeader[];
 }
+/**
+ * Compose the `<meta name="robots">` value from a parsed `metaRobots` block.
+ * Order matches Google's documented preference: index/noindex, follow/nofollow,
+ * boolean flags, then `max-*` keyed values, then `unavailable_after`.
+ */
 export declare function composeRobotsContent(robots: MetaRobots): string;
+/**
+ * Compose per-bot directives. Each "deny" entry gets a `noindex, nofollow`
+ * directive both as a `<meta>` tag (for HTML pages) and as an `X-Robots-Tag`
+ * header (for non-HTML resources). "allow" entries are not emitted — that's
+ * the implicit default; explicit allow tags would override stricter
+ * site-wide rules.
+ */
 export declare function composePerBotDirectives(metadata: ProductMetadata): PerBotDirectives;
 //# sourceMappingURL=robots.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/seo/robots.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,cAAc,EAAE,mBAAmB,EAAE,CAAC;CACvC;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAY/D;AASD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAkBnF"}
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/seo/robots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,cAAc,EAAE,mBAAmB,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAY/D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAkBnF"}

package/dist/seo/robots.js

@@ -1,3 +1,8 @@
+/**
+ * Compose the `<meta name="robots">` value from a parsed `metaRobots` block.
+ * Order matches Google's documented preference: index/noindex, follow/nofollow,
+ * boolean flags, then `max-*` keyed values, then `unavailable_after`.
+ */
 export function composeRobotsContent(robots) {
     const parts = [robots.index, robots.follow];
     if (robots.noarchive)
@@ -16,6 +21,13 @@ export function composeRobotsContent(robots) {
     }
     return parts.join(', ');
 }
+/**
+ * Compose per-bot directives. Each "deny" entry gets a `noindex, nofollow`
+ * directive both as a `<meta>` tag (for HTML pages) and as an `X-Robots-Tag`
+ * header (for non-HTML resources). "allow" entries are not emitted — that's
+ * the implicit default; explicit allow tags would override stricter
+ * site-wide rules.
+ */
 export function composePerBotDirectives(metadata) {
     const bots = metadata.ai.resolvedBotDirectives;
     const metaTags = [];

package/dist/seo/robots.js.map

@@ -1 +1 @@
-{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/seo/robots.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,eAAe,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AASD,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,qBAAqB,CAAC;IAC/C,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,cAAc,GAA0B,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,SAAS,KAAK,MAAM;YAAE,SAAS;QACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC3D,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,KAAK,OAAO;YAC5C,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ;SAChD;QACD,IAAI;QACJ,QAAQ;QACR,cAAc;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/seo/robots.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,eAAe,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,qBAAqB,CAAC;IAC/C,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,cAAc,GAA0B,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,SAAS,KAAK,MAAM;YAAE,SAAS;QACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC3D,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,KAAK,OAAO;YAC5C,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ;SAChD;QACD,IAAI;QACJ,QAAQ;QACR,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/seo/types.d.ts

@@ -1,8 +1,10 @@
 export type UrlLocaleStrategy = 'path-prefix' | 'subdomain' | 'none';
+/** Locale-aware slug for any translatable entity. */
 export interface TranslatedSlug {
     languageCode: string;
     slug: string;
 }
+/** Minimal Collection shape required for canonical / hreflang resolution. */
 export interface CollectionForSeo {
     id: string;
     slug: string;
@@ -17,15 +19,20 @@ export interface CollectionForSeo {
         isCanonical?: boolean | null;
     } | null;
 }
+/** Product view needed for SEO resolution. Supply the slug + every translation you have. */
 export interface ProductForSeo {
     slug: string;
     translations?: TranslatedSlug[];
     collections: CollectionForSeo[];
 }
+/** CMS resolve-layer item shape for SEO resolution. */
 export interface CmsItemForSeo {
+    /** Path already resolved via CMS ResolveService (locale-free canonical path). */
     path: string;
+    /** Per-language translated paths. `slug_translations` from the resolve response. */
     slug_translations?: Record<string, string> | null;
 }
+/** Discriminated input to the SEO module methods. */
 export type SeoEntityInput = ({
     kind: 'product';
 } & ProductForSeo) | ({
@@ -34,8 +41,14 @@ export type SeoEntityInput = ({
     kind: 'cms';
 } & CmsItemForSeo);
 export interface HreflangLink {
+    /** BCP 47 spelling, ready to put in an `hreflang` attribute (`en-GB`). */
     hreflang: string;
     href: string;
+    /**
+     * The channel's raw Vendure `LanguageCode` for this row (`en_GB`) — the same
+     * locale as `hreflang`, in the spelling the commerce API and OpenGraph use.
+     * Optional so existing callers constructing this type keep compiling.
+     */
     languageCode?: string;
 }
 export interface SeoMeta {
@@ -44,18 +57,44 @@ export interface SeoMeta {
     xDefault: string;
 }
 export interface SeoModule {
+    /** Resolve the canonical URL for an entity (optionally per-locale). */
     canonicalFor(entity: SeoEntityInput, locale?: string): string;
+    /**
+     * Enumerate hreflang alternates. Only languages the entity actually has a
+     * translation in are emitted (plus `x-default`) — Google drops broken pairs.
+     */
     alternatesFor(entity: SeoEntityInput): HreflangLink[];
+    /** Combined meta bundle: canonical + alternates + xDefault. */
     metaFor(entity: SeoEntityInput): SeoMeta;
+    /** Low-level URL builder — composes `{storefrontUrl}{localePrefix}/{segments...}`. */
     buildUrl(segments: string[], locale?: string): string;
+    /**
+     * Full structured meta tag set for an entity: title, description, canonical,
+     * robots, OpenGraph, Twitter, hreflang, JSON-LD. Resolves fallbacks for
+     * missing per-product metadata.
+     */
     metaTagsFor(entity: import('./meta-tags.js').MetaTagsEntityInput): import('./meta-tags.js').MetaTagsResult;
+    /**
+     * Per-bot robots directives: composed `<meta>` tags and `X-Robots-Tag`
+     * headers based on the product's resolved bot directives.
+     */
     robotsDirectiveFor(entity: import('./ai.js').AiSummaryInput): import('./robots.js').PerBotDirectives;
+    /** AI summary string for storefronts to render as a head meta tag or inline section. */
     aiSummaryFor(entity: import('./ai.js').AiSummaryInput): string | null;
+    /** One markdown bullet for the channel `/llms.txt` file. */
     llmsTxtEntryFor(entity: import('./ai.js').LlmsTxtEntryInput): string;
+    /** Platform URL of the rendered sitemap index (or one child file). Proxy at /sitemap.xml. */
     sitemapUrl(childFile?: string): string;
+    /** Platform URL of the rendered robots.txt. Proxy at /robots.txt. */
     robotsUrl(): string;
+    /** Platform URL of the rendered llms.txt (404 unless enabled). Proxy at /llms.txt. */
     llmsTxtUrl(): string;
+    /** Platform URL of the IndexNow key file. Proxy at /{key}.txt. */
     indexnowKeyUrl(): string;
+    /**
+     * Fire-and-forget 404 beacon — call from the storefront's not-found handler
+     * so the platform can suggest redirects. Never throws, never blocks.
+     */
     reportNotFound(path: string, options?: {
         referrer?: string;
     }): void;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/seo/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAGrE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE;QACb,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC5B,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KAC9B,GAAG,IAAI,CAAC;CACV;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAGD,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,MAAM,CAAC;IAEb,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACnD;AAGD,MAAM,MAAM,cAAc,GACtB,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,aAAa,CAAC,GACrC,CAAC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GAAG,gBAAgB,CAAC,GAC3C,CAAC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG,aAAa,CAAC,CAAC;AAEtC,MAAM,WAAW,YAAY;IAE3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IAMb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IAExB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAK9D,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,EAAE,CAAC;IAEtD,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC;IAEzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAMtD,WAAW,CACT,MAAM,EAAE,OAAO,gBAAgB,EAAE,mBAAmB,GACnD,OAAO,gBAAgB,EAAE,cAAc,CAAC;IAK3C,kBAAkB,CAChB,MAAM,EAAE,OAAO,SAAS,EAAE,cAAc,GACvC,OAAO,aAAa,EAAE,gBAAgB,CAAC;IAE1C,YAAY,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;IAEtE,eAAe,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAErE,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvC,SAAS,IAAI,MAAM,CAAC;IAEpB,UAAU,IAAI,MAAM,CAAC;IAErB,cAAc,IAAI,MAAM,CAAC;IAKzB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/seo/types.ts"],"names":[],"mappings":"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"}

package/dist/seo/url-builder.d.ts

@@ -5,12 +5,43 @@ export interface UrlStrategyConfig {
     urlLocaleStrategy: UrlLocaleStrategy;
     urlLocalePrefixDefault: boolean;
     defaultLanguageCode: string;
+    /**
+     * Segment canonical product URLs sit under. Optional on purpose: this type is
+     * public API, and a hand-built config from before the field existed must keep
+     * working — absent normalizes to `products`, the previous hardcoded value.
+     */
     productPathSegment?: string | null;
+    /**
+     * Path prefix the storefront serves ALL commerce routes under, e.g. `/store`.
+     * Applies to products and collections, never to CMS pages — the same rule
+     * the routes manifest applies. Optional for the same compatibility reason.
+     */
     commercePathPrefix?: string | null;
+    /** Per-language `commercePathPrefix` overrides, `{ nl: '/winkel' }`. */
     commercePathPrefixTranslations?: Record<string, string> | null;
 }
+/**
+ * Resolve the URL-strategy config from the channel's customFields. Throws a
+ * structured error when `storefrontUrl` is missing — canonical URLs must be
+ * absolute so there's no safe default.
+ */
 export declare function readUrlStrategy(ctx: StoreContext): UrlStrategyConfig;
+/**
+ * {@link readUrlStrategy} for a channel read from anywhere — e.g. a fresh
+ * `activeChannel` query, whose custom fields can be newer than the snapshot the
+ * client took at startup.
+ */
 export declare function urlStrategyFromChannel(customFields: ChannelCustomFields | null | undefined, defaultLanguageCode: string): UrlStrategyConfig;
+/**
+ * The commerce path prefix for a locale: the per-language override when one
+ * exists, else the channel default. Mirrors `RoutesService.applyCommercePrefix`
+ * exactly, including that an empty string disables prefixing for that locale.
+ */
 export declare function commercePrefixFor(cfg: UrlStrategyConfig, locale: string): string;
+/**
+ * Compose an absolute URL for a given path (segments) and locale, respecting
+ * the channel's URL-locale strategy. Segments are joined with `/` and
+ * individually encoded; empty segments are dropped.
+ */
 export declare function buildUrl(cfg: UrlStrategyConfig, segments: string[], locale?: string): string;
 //# sourceMappingURL=url-builder.d.ts.map

package/dist/seo/url-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/seo/url-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAM5B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMnC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,8BAA8B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAChE;AAOD,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAEpE;AAOD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EACpD,mBAAmB,EAAE,MAAM,GAC1B,iBAAiB,CA2BnB;AA2BD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhF;AAOD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAwC5F"}
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/seo/url-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,wEAAwE;IACxE,8BAA8B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EACpD,mBAAmB,EAAE,MAAM,GAC1B,iBAAiB,CA2BnB;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAwC5F"}

package/dist/seo/url-builder.js

@@ -1,9 +1,19 @@
 import { StorefrontError } from '../errors.js';
 import { toDnsLabel } from './locale-tag.js';
 import { normalizeProductPathSegment } from './product-path.js';
+/**
+ * Resolve the URL-strategy config from the channel's customFields. Throws a
+ * structured error when `storefrontUrl` is missing — canonical URLs must be
+ * absolute so there's no safe default.
+ */
 export function readUrlStrategy(ctx) {
     return urlStrategyFromChannel(ctx.channel.customFields, ctx.channel.defaultLanguageCode);
 }
+/**
+ * {@link readUrlStrategy} for a channel read from anywhere — e.g. a fresh
+ * `activeChannel` query, whose custom fields can be newer than the snapshot the
+ * client took at startup.
+ */
 export function urlStrategyFromChannel(customFields, defaultLanguageCode) {
     const cf = customFields ?? {};
     const storefrontUrl = typeof cf.storefrontUrl === 'string' ? cf.storefrontUrl.trim() : '';
@@ -24,6 +34,11 @@ export function urlStrategyFromChannel(customFields, defaultLanguageCode) {
             : null),
     };
 }
+/**
+ * Parse the JSON-encoded per-language prefix overrides. Invalid JSON yields
+ * null rather than throwing — a malformed channel setting must not take the
+ * canonical URL down with it.
+ */
 function parsePrefixTranslations(raw) {
     if (!raw)
         return null;
@@ -42,6 +57,11 @@ function parsePrefixTranslations(raw) {
         return null;
     }
 }
+/**
+ * The commerce path prefix for a locale: the per-language override when one
+ * exists, else the channel default. Mirrors `RoutesService.applyCommercePrefix`
+ * exactly, including that an empty string disables prefixing for that locale.
+ */
 export function commercePrefixFor(cfg, locale) {
     const translations = cfg.commercePathPrefixTranslations;
     const raw = translations && Object.hasOwn(translations, locale)
@@ -49,6 +69,11 @@ export function commercePrefixFor(cfg, locale) {
         : cfg.commercePathPrefix;
     return (raw ?? '').replace(/\/+$/, '');
 }
+/**
+ * Compose an absolute URL for a given path (segments) and locale, respecting
+ * the channel's URL-locale strategy. Segments are joined with `/` and
+ * individually encoded; empty segments are dropped.
+ */
 export function buildUrl(cfg, segments, locale) {
     const resolvedLocale = locale ?? cfg.defaultLanguageCode;
     const clean = segments
@@ -57,16 +82,27 @@ export function buildUrl(cfg, segments, locale) {
         .map((s) => encodeURI(s));
     const path = clean.length > 0 ? `/${clean.join('/')}` : '';
     const isDefault = resolvedLocale === cfg.defaultLanguageCode;
+    // A blank locale emits no segment at all. The previous implementation got this
+    // for free because it tested the encoded prefix STRING for emptiness; deriving
+    // the flag from `isDefault` alone would turn `locale: ''` into `//path` and, in
+    // subdomain mode, the invalid host `https://.example.com`. `??` above does not
+    // catch `''`, and this is published API a caller may reach with `locale ?? ''`.
     const emitLocale = resolvedLocale !== '' && (!isDefault || cfg.urlLocalePrefixDefault);
     switch (cfg.urlLocaleStrategy) {
         case 'path-prefix': {
+            // The PATH segment keeps the raw Vendure spelling (`/en_GB/...`): the
+            // storefront reads this segment back out and passes it straight to the
+            // commerce and CMS APIs, which key on the Vendure code.
             const localePart = emitLocale ? `/${encodeURIComponent(resolvedLocale)}` : '';
             return `${cfg.storefrontUrl}${localePart}${path}`;
         }
         case 'subdomain': {
             if (!emitLocale)
                 return `${cfg.storefrontUrl}${path}`;
+            // A hostname label may not contain `_`, so a region tag has to be
+            // hyphenated and lower-cased here: `en_GB` → `en-gb.example.com`.
             const label = encodeURIComponent(toDnsLabel(resolvedLocale));
+            // Insert subdomain after the protocol: https://host → https://nl.host
             return (cfg.storefrontUrl.replace(/^(https?:\/\/)([^/]+)/, (_match, scheme, host) => `${scheme}${label}.${host}`) + path);
         }
         case 'none':

package/dist/seo/url-builder.js.map

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