@obelism/content 0.16.0 → 0.18.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as RichTextFormat, E as Entry, a as RedirectList, b as Redirect, c as EntryList, M as ModelFile, A as Asset, B as Block, I as ImproveBlock, d as EntryStub, e as RichTextNode } from './types-m3j4tltp.js';
-export { C as ContentTypeDefinition, f as ContentTypeKind, g as Environment, F as FieldDefinition, h as FieldType, i as RichTextDocument, j as RichTextMark } from './types-m3j4tltp.js';
+import { R as RichTextFormat, E as Entry, a as RedirectList, b as Redirect, c as EntryList, M as ModelFile, A as Asset, B as Block, I as ImproveBlock, S as ShopifyItem, L as LinkTarget, d as Link, e as EntryStub, f as RichTextNode } from './types-mtjco3a5.js';
+export { C as ContentTypeDefinition, g as ContentTypeKind, h as Environment, F as FieldDefinition, i as FieldType, j as RichTextDocument, k as RichTextMark } from './types-mtjco3a5.js';
 
 type ContentClientOptions = {
     token: string;
@@ -60,6 +60,8 @@ declare const DEFAULT_URL = "https://content.obelism.studio";
 
 declare const UID_ATTRIBUTE = "data-cms-uid";
 declare const ENTRY_ATTRIBUTE = "data-cms-entry";
+declare const PRODUCT_ATTRIBUTE = "data-cms-product";
+declare const PRODUCT_HANDLE_ATTRIBUTE = "data-cms-product-handle";
 type Editable = {
     'data-cms-uid'?: string;
     'data-cms-entry'?: string;
@@ -70,6 +72,14 @@ declare const editable: (target: {
     id: string;
     fields: unknown;
 } | null | undefined) => Editable;
+type EditableProduct = {
+    'data-cms-product'?: string;
+    'data-cms-product-handle'?: string;
+};
+declare const editableProduct: (product: {
+    id: string;
+    handle: string;
+} | null | undefined) => EditableProduct;
 
 declare class ContentApiError extends Error {
     readonly status: number;
@@ -96,6 +106,12 @@ declare const IMPROVE_BLOCK = "_improve";
 declare const isImproveBlock: (block: Block) => block is ImproveBlock;
 declare const pickImproveVariant: <TBlock extends Block>(block: ImproveBlock<TBlock>, option: string | null | undefined, fallback?: string) => TBlock[];
 
+type LinkHrefOptions = {
+    url?: ((path: string) => string) | undefined;
+    product?: ((product: ShopifyItem, page: LinkTarget | null) => string) | undefined;
+};
+declare const linkHref: (link: Link | null | undefined, { url, product, }?: LinkHrefOptions) => string | null;
+
 declare const PREVIEW_PARAMS: {
     readonly preview: "cms_preview";
     readonly entry: "cms_entry";
@@ -110,6 +126,50 @@ type PreviewParams = {
 type SearchParamsInput = URL | URLSearchParams | string | Record<string, string | string[] | undefined>;
 declare const readPreviewParams: (input: SearchParamsInput) => PreviewParams | null;
 
+declare const SHOPIFY_STOREFRONT_API_VERSION = "2026-10";
+type ShopifyStorefrontOptions = {
+    shop: string;
+    storefrontToken: string;
+    country?: string | undefined;
+    language?: string | undefined;
+    init?: RequestInit | undefined;
+    fetch?: typeof fetch | undefined;
+};
+type ShopifyMoney = {
+    amount: string;
+    currencyCode: string;
+};
+type ShopifyImage = {
+    url: string;
+    altText: string | null;
+    width: number | null;
+    height: number | null;
+};
+type ShopifyProduct = {
+    id: string;
+    handle: string;
+    title: string;
+    availableForSale: boolean;
+    featuredImage: ShopifyImage | null;
+    priceRange: {
+        minVariantPrice: ShopifyMoney;
+    };
+};
+type ShopifyCollection = {
+    id: string;
+    handle: string;
+    title: string;
+    products: ShopifyProduct[];
+};
+declare class ShopifyStorefrontError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+declare const fetchShopifyCollection: (item: ShopifyItem, options: ShopifyStorefrontOptions & {
+    first?: number | undefined;
+}) => Promise<ShopifyCollection | null>;
+declare const fetchShopifyProducts: (items: ShopifyItem | ShopifyItem[] | null | undefined, options: ShopifyStorefrontOptions) => Promise<ShopifyProduct[]>;
+
 declare const SAFE_HREF: RegExp;
 declare const escapeHtml: (value: string) => string;
 type RichTextHtmlOptions = {
@@ -135,6 +195,6 @@ type SitemapOptions = LocalizedUrlOptions & {
 };
 declare const sitemapXml: (entries: Iterable<Page>, { exclude, ...options }: SitemapOptions) => string;
 
-export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, ModelFile, PREVIEW_PARAMS, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, alternateLinks, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, isImproveBlock, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
-export type { AlternateLink, ContentClientOptions, EntriesQuery, ImageTransform, LocalizedUrlOptions, PageLookup, PreviewParams, RedirectsQuery, RequestOptions, RichTextHtmlOptions, SitemapOptions };
+export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, Link, LinkTarget, ModelFile, PREVIEW_PARAMS, PRODUCT_ATTRIBUTE, PRODUCT_HANDLE_ATTRIBUTE, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, editableProduct, escapeHtml, fetchShopifyCollection, fetchShopifyProducts, headingLevel, imageSrcSet, imageUrl, isImproveBlock, linkHref, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
+export type { AlternateLink, ContentClientOptions, EntriesQuery, ImageTransform, LinkHrefOptions, LocalizedUrlOptions, PageLookup, PreviewParams, RedirectsQuery, RequestOptions, RichTextHtmlOptions, ShopifyCollection, ShopifyImage, ShopifyMoney, ShopifyProduct, ShopifyStorefrontOptions, SitemapOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/preview.ts","../src/richText.ts","../src/sitemap.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,gBAAgB;AACrB,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA,aAAa,MAAM,SAAS,gBAAgB,YAAY,gBAAgB;AACxE;AACA;AACA;AACA;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,WAAW,WAAW;AACtB;AACA,KAAK,UAAU,gBAAgB,KAAK,GAAG,KAAK;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO,CAAC,UAAU;AAC1G,oDAAoD,cAAc,KAAK,OAAO,CAAC,YAAY;AAC3F,4BAA4B,IAAI,CAAC,cAAc,YAAY,cAAc,CAAC,QAAQ;AAClF,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,wEAAwE,YAAY,KAAK,OAAO,CAAC,SAAS;AACvJ,mCAAmC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,wBAAwB,OAAO;AAC1G,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;ACtDA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,WAAW,IAAI,CAAC,KAAK,WAAW,OAAO,CAAC,IAAI,CAAC,KAAK,wCAAwC,cAAc;AAC9H,cAAc,WAAW,WAAW,IAAI,CAAC,KAAK,WAAW,OAAO,CAAC,IAAI,CAAC,KAAK,0DAA0D,IAAI,CAAC,cAAc;;ACZxJ,cAAc,aAAa;AAC3B,cAAc,cAAc,UAAU,KAAK,cAAc,YAAY;AACrE,cAAc,kBAAkB,kBAAkB,KAAK,SAAS,YAAY;;ACH5E,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACX5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;ACRrD,KAAK,mBAAmB;AACxB;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,IAAI,GAAG,IAAI,CAAC,KAAK,aAAa,OAAO,CAAC,IAAI,CAAC,KAAK;AACrD,cAAc,cAAc,UAAU,IAAI,CAAC,KAAK,oCAAoC,mBAAmB,KAAK,aAAa;AACzH,KAAK,cAAc,GAAG,mBAAmB;AACzC,uBAAuB,IAAI;AAC3B;AACA,cAAc,UAAU,YAAY,QAAQ,CAAC,IAAI,4BAA4B,cAAc;;","names":[]}
+{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/links.ts","../src/preview.ts","../src/shopify.ts","../src/richText.ts","../src/sitemap.ts"],"mappings":"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","names":[]}

package/dist/index.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var config = require('./config-ci2hxmas.js');
-var preview = require('./preview-mpwfmnla.js');
+var preview = require('./preview-ijk3ixwb.js');
 
 // A response from the API that wasn't a success. `message` is the API's own
 // `error` text when it sent one.
@@ -266,6 +266,87 @@ const pickImproveVariant = (block, option, fallback)=>{
     return Object.values(variants)[0] ?? [];
 };
 
+const linkHref = (link, { url = (path)=>`/${path}`, product = ({ handle })=>`/products/${handle}` } = {})=>{
+    if (!link) return null;
+    if (link.type === 'entry' && link.entry.path === null) return null;
+    const base = link.type === 'url' ? link.url : link.type === 'product' ? product(link.product, link.entry) : url(link.entry.path);
+    const hashAt = base.indexOf('#');
+    const address = hashAt === -1 ? base : base.slice(0, hashAt);
+    const ownHash = hashAt === -1 ? null : base.slice(hashAt + 1);
+    const withQuery = link.query ? `${address}${address.includes('?') ? '&' : '?'}${link.query}` : address;
+    const hash = link.hash ?? ownHash;
+    return hash ? `${withQuery}#${hash}` : withQuery;
+};
+
+// What a `shopify` field points at, live from the store: the Storefront API
+// with the space's Storefront token (Settings → Copy as .env:
+// SHOPIFY_STORE_DOMAIN and SHOPIFY_STOREFRONT_TOKEN, safe in the browser).
+// Content stores only `{ id, handle }`, so prices and stock are never stale.
+// A Hydrogen or Liquid site can query by the id itself instead.
+// The Storefront API version the queries are written for.
+const SHOPIFY_STOREFRONT_API_VERSION = '2026-10';
+class ShopifyStorefrontError extends Error {
+    constructor(status, message){
+        super(message), this.status = status;
+        this.name = 'ShopifyStorefrontError';
+    }
+}
+const PRODUCT_FIELDS = 'id handle title availableForSale featuredImage { url altText width height } priceRange { minVariantPrice { amount currencyCode } }';
+const CONTEXT_VARIABLES = '$country: CountryCode, $language: LanguageCode';
+const IN_CONTEXT = '@inContext(country: $country, language: $language)';
+const storefront = async (options, query, variables)=>{
+    const fetchImpl = options.fetch ?? fetch;
+    const response = await fetchImpl(`https://${options.shop}/api/${SHOPIFY_STOREFRONT_API_VERSION}/graphql.json`, {
+        ...options.init,
+        method: 'POST',
+        headers: {
+            ...options.init?.headers,
+            'content-type': 'application/json',
+            'x-shopify-storefront-access-token': options.storefrontToken
+        },
+        body: JSON.stringify({
+            query,
+            variables: {
+                ...variables,
+                country: options.country?.toUpperCase() ?? null,
+                language: options.language?.toUpperCase() ?? null
+            }
+        })
+    });
+    if (!response.ok) throw new ShopifyStorefrontError(response.status, `Shopify's Storefront API answered ${response.status}`);
+    const body = await response.json();
+    if (body.errors?.length || !body.data) throw new ShopifyStorefrontError(response.status, body.errors?.map((error)=>error.message).join('; ') || 'No data from the Storefront API');
+    return body.data;
+};
+// A collection field's collection with its first `first` products (default
+// 12, at most 250), in the collection's order; null when the store no
+// longer has it or it isn't published to the token's sales channel.
+const fetchShopifyCollection = async (item, options)=>{
+    const first = Math.min(Math.max(Math.trunc(options.first ?? 12), 1), 250);
+    const data = await storefront(options, `query Collection($id: ID!, $first: Int!, ${CONTEXT_VARIABLES}) ${IN_CONTEXT} { collection(id: $id) { id handle title products(first: $first) { nodes { ${PRODUCT_FIELDS} } } } }`, {
+        id: item.id,
+        first
+    });
+    if (!data.collection) return null;
+    const { products, ...collection } = data.collection;
+    return {
+        ...collection,
+        products: products.nodes
+    };
+};
+// A product field's products, in the field's order; one the store no
+// longer has (or doesn't sell through this channel) is left out.
+const fetchShopifyProducts = async (items, options)=>{
+    const ids = (Array.isArray(items) ? items : items ? [
+        items
+    ] : []).map(({ id })=>id).slice(0, 250);
+    if (ids.length === 0) return [];
+    const data = await storefront(options, `query Products($ids: [ID!]!, ${CONTEXT_VARIABLES}) ${IN_CONTEXT} { nodes(ids: $ids) { ... on Product { ${PRODUCT_FIELDS} } } }`, {
+        ids
+    });
+    return data.nodes.filter((node)=>Boolean(node && 'id' in node));
+};
+
 // Links are only rendered for these; anything else (`javascript:` …) keeps its
 // text without the link. The same rule the CMS validates with.
 const SAFE_HREF = /^(https?:\/\/|mailto:|tel:|#|\/(?!\/))/i;
@@ -428,19 +509,27 @@ const sitemapXml = (entries, { exclude = hidden, ...options })=>{
 exports.DEFAULT_URL = config.DEFAULT_URL;
 exports.ENTRY_ATTRIBUTE = preview.ENTRY_ATTRIBUTE;
 exports.PREVIEW_PARAMS = preview.PREVIEW_PARAMS;
+exports.PRODUCT_ATTRIBUTE = preview.PRODUCT_ATTRIBUTE;
+exports.PRODUCT_HANDLE_ATTRIBUTE = preview.PRODUCT_HANDLE_ATTRIBUTE;
 exports.UID_ATTRIBUTE = preview.UID_ATTRIBUTE;
 exports.editable = preview.editable;
+exports.editableProduct = preview.editableProduct;
 exports.readPreviewParams = preview.readPreviewParams;
 exports.ContentApiError = ContentApiError;
 exports.ContentClient = ContentClient;
 exports.IMPROVE_BLOCK = IMPROVE_BLOCK;
 exports.SAFE_HREF = SAFE_HREF;
+exports.SHOPIFY_STOREFRONT_API_VERSION = SHOPIFY_STOREFRONT_API_VERSION;
+exports.ShopifyStorefrontError = ShopifyStorefrontError;
 exports.alternateLinks = alternateLinks;
 exports.escapeHtml = escapeHtml;
+exports.fetchShopifyCollection = fetchShopifyCollection;
+exports.fetchShopifyProducts = fetchShopifyProducts;
 exports.headingLevel = headingLevel;
 exports.imageSrcSet = imageSrcSet;
 exports.imageUrl = imageUrl;
 exports.isImproveBlock = isImproveBlock;
+exports.linkHref = linkHref;
 exports.pickImproveVariant = pickImproveVariant;
 exports.richTextToHtml = richTextToHtml;
 exports.richTextToPlainText = richTextToPlainText;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { n as normalizeUrl, a as DEFAULT_TIMEOUT, b as DELIVERY_PATH, D as DEFAULT_URL } from './config-c6qktlz6.mjs';
-export { E as ENTRY_ATTRIBUTE, P as PREVIEW_PARAMS, U as UID_ATTRIBUTE, e as editable, r as readPreviewParams } from './preview-h7rwp06v.mjs';
+export { E as ENTRY_ATTRIBUTE, P as PREVIEW_PARAMS, a as PRODUCT_ATTRIBUTE, b as PRODUCT_HANDLE_ATTRIBUTE, U as UID_ATTRIBUTE, e as editable, c as editableProduct, r as readPreviewParams } from './preview-jcmxxj92.mjs';
 
 // A response from the API that wasn't a success. `message` is the API's own
 // `error` text when it sent one.
@@ -264,6 +264,87 @@ const pickImproveVariant = (block, option, fallback)=>{
     return Object.values(variants)[0] ?? [];
 };
 
+const linkHref = (link, { url = (path)=>`/${path}`, product = ({ handle })=>`/products/${handle}` } = {})=>{
+    if (!link) return null;
+    if (link.type === 'entry' && link.entry.path === null) return null;
+    const base = link.type === 'url' ? link.url : link.type === 'product' ? product(link.product, link.entry) : url(link.entry.path);
+    const hashAt = base.indexOf('#');
+    const address = hashAt === -1 ? base : base.slice(0, hashAt);
+    const ownHash = hashAt === -1 ? null : base.slice(hashAt + 1);
+    const withQuery = link.query ? `${address}${address.includes('?') ? '&' : '?'}${link.query}` : address;
+    const hash = link.hash ?? ownHash;
+    return hash ? `${withQuery}#${hash}` : withQuery;
+};
+
+// What a `shopify` field points at, live from the store: the Storefront API
+// with the space's Storefront token (Settings → Copy as .env:
+// SHOPIFY_STORE_DOMAIN and SHOPIFY_STOREFRONT_TOKEN, safe in the browser).
+// Content stores only `{ id, handle }`, so prices and stock are never stale.
+// A Hydrogen or Liquid site can query by the id itself instead.
+// The Storefront API version the queries are written for.
+const SHOPIFY_STOREFRONT_API_VERSION = '2026-10';
+class ShopifyStorefrontError extends Error {
+    constructor(status, message){
+        super(message), this.status = status;
+        this.name = 'ShopifyStorefrontError';
+    }
+}
+const PRODUCT_FIELDS = 'id handle title availableForSale featuredImage { url altText width height } priceRange { minVariantPrice { amount currencyCode } }';
+const CONTEXT_VARIABLES = '$country: CountryCode, $language: LanguageCode';
+const IN_CONTEXT = '@inContext(country: $country, language: $language)';
+const storefront = async (options, query, variables)=>{
+    const fetchImpl = options.fetch ?? fetch;
+    const response = await fetchImpl(`https://${options.shop}/api/${SHOPIFY_STOREFRONT_API_VERSION}/graphql.json`, {
+        ...options.init,
+        method: 'POST',
+        headers: {
+            ...options.init?.headers,
+            'content-type': 'application/json',
+            'x-shopify-storefront-access-token': options.storefrontToken
+        },
+        body: JSON.stringify({
+            query,
+            variables: {
+                ...variables,
+                country: options.country?.toUpperCase() ?? null,
+                language: options.language?.toUpperCase() ?? null
+            }
+        })
+    });
+    if (!response.ok) throw new ShopifyStorefrontError(response.status, `Shopify's Storefront API answered ${response.status}`);
+    const body = await response.json();
+    if (body.errors?.length || !body.data) throw new ShopifyStorefrontError(response.status, body.errors?.map((error)=>error.message).join('; ') || 'No data from the Storefront API');
+    return body.data;
+};
+// A collection field's collection with its first `first` products (default
+// 12, at most 250), in the collection's order; null when the store no
+// longer has it or it isn't published to the token's sales channel.
+const fetchShopifyCollection = async (item, options)=>{
+    const first = Math.min(Math.max(Math.trunc(options.first ?? 12), 1), 250);
+    const data = await storefront(options, `query Collection($id: ID!, $first: Int!, ${CONTEXT_VARIABLES}) ${IN_CONTEXT} { collection(id: $id) { id handle title products(first: $first) { nodes { ${PRODUCT_FIELDS} } } } }`, {
+        id: item.id,
+        first
+    });
+    if (!data.collection) return null;
+    const { products, ...collection } = data.collection;
+    return {
+        ...collection,
+        products: products.nodes
+    };
+};
+// A product field's products, in the field's order; one the store no
+// longer has (or doesn't sell through this channel) is left out.
+const fetchShopifyProducts = async (items, options)=>{
+    const ids = (Array.isArray(items) ? items : items ? [
+        items
+    ] : []).map(({ id })=>id).slice(0, 250);
+    if (ids.length === 0) return [];
+    const data = await storefront(options, `query Products($ids: [ID!]!, ${CONTEXT_VARIABLES}) ${IN_CONTEXT} { nodes(ids: $ids) { ... on Product { ${PRODUCT_FIELDS} } } }`, {
+        ids
+    });
+    return data.nodes.filter((node)=>Boolean(node && 'id' in node));
+};
+
 // Links are only rendered for these; anything else (`javascript:` …) keeps its
 // text without the link. The same rule the CMS validates with.
 const SAFE_HREF = /^(https?:\/\/|mailto:|tel:|#|\/(?!\/))/i;
@@ -423,4 +504,4 @@ const sitemapXml = (entries, { exclude = hidden, ...options })=>{
     ].join('\n');
 };
 
-export { ContentApiError, ContentClient, DEFAULT_URL, IMPROVE_BLOCK, SAFE_HREF, alternateLinks, escapeHtml, headingLevel, imageSrcSet, imageUrl, isImproveBlock, pickImproveVariant, richTextToHtml, richTextToPlainText, sitemapXml };
+export { ContentApiError, ContentClient, DEFAULT_URL, IMPROVE_BLOCK, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyStorefrontError, alternateLinks, escapeHtml, fetchShopifyCollection, fetchShopifyProducts, headingLevel, imageSrcSet, imageUrl, isImproveBlock, linkHref, pickImproveVariant, richTextToHtml, richTextToPlainText, sitemapXml };

package/dist/{preview-mpwfmnla.js → preview-ijk3ixwb.js}

@@ -1,5 +1,7 @@
 const UID_ATTRIBUTE = 'data-cms-uid';
 const ENTRY_ATTRIBUTE = 'data-cms-entry';
+const PRODUCT_ATTRIBUTE = 'data-cms-product';
+const PRODUCT_HANDLE_ATTRIBUTE = 'data-cms-product-handle';
 // The attribute that lets editors select a block on the page, in the visual
 // editor and on the site. Spread it on the block's outermost element:
 //
@@ -22,6 +24,18 @@ const editable = (target)=>{
     }
     return {};
 };
+// The Shopify product a page shows, on a product route: editing on the site
+// then offers "Add a product page" when the page has no product page yet
+// (no `editable(entry)`), and makes one for this product.
+//
+//   <main {...editableProduct(product)} {...editable(page)}>…</main>
+//
+// `product` is the store's (its GID and handle), from the Storefront API or
+// a Shopify field.
+const editableProduct = (product)=>product?.id ? {
+        'data-cms-product': product.id,
+        'data-cms-product-handle': product.handle
+    } : {};
 
 // The visual editor loads the site in an iframe at the environment's preview
 // URL plus the entry's path, with these parameters added. `cms_token` is a
@@ -72,6 +86,9 @@ const readPreviewParams = (input)=>{
 
 exports.ENTRY_ATTRIBUTE = ENTRY_ATTRIBUTE;
 exports.PREVIEW_PARAMS = PREVIEW_PARAMS;
+exports.PRODUCT_ATTRIBUTE = PRODUCT_ATTRIBUTE;
+exports.PRODUCT_HANDLE_ATTRIBUTE = PRODUCT_HANDLE_ATTRIBUTE;
 exports.UID_ATTRIBUTE = UID_ATTRIBUTE;
 exports.editable = editable;
+exports.editableProduct = editableProduct;
 exports.readPreviewParams = readPreviewParams;

package/dist/{preview-h7rwp06v.mjs → preview-jcmxxj92.mjs}

@@ -1,5 +1,7 @@
 const UID_ATTRIBUTE = 'data-cms-uid';
 const ENTRY_ATTRIBUTE = 'data-cms-entry';
+const PRODUCT_ATTRIBUTE = 'data-cms-product';
+const PRODUCT_HANDLE_ATTRIBUTE = 'data-cms-product-handle';
 // The attribute that lets editors select a block on the page, in the visual
 // editor and on the site. Spread it on the block's outermost element:
 //
@@ -22,6 +24,18 @@ const editable = (target)=>{
     }
     return {};
 };
+// The Shopify product a page shows, on a product route: editing on the site
+// then offers "Add a product page" when the page has no product page yet
+// (no `editable(entry)`), and makes one for this product.
+//
+//   <main {...editableProduct(product)} {...editable(page)}>…</main>
+//
+// `product` is the store's (its GID and handle), from the Storefront API or
+// a Shopify field.
+const editableProduct = (product)=>product?.id ? {
+        'data-cms-product': product.id,
+        'data-cms-product-handle': product.handle
+    } : {};
 
 // The visual editor loads the site in an iframe at the environment's preview
 // URL plus the entry's path, with these parameters added. `cms_token` is a
@@ -70,4 +84,4 @@ const readPreviewParams = (input)=>{
     };
 };
 
-export { ENTRY_ATTRIBUTE as E, PREVIEW_PARAMS as P, UID_ATTRIBUTE as U, editable as e, readPreviewParams as r };
+export { ENTRY_ATTRIBUTE as E, PREVIEW_PARAMS as P, UID_ATTRIBUTE as U, PRODUCT_ATTRIBUTE as a, PRODUCT_HANDLE_ATTRIBUTE as b, editableProduct as c, editable as e, readPreviewParams as r };

package/dist/site.js

@@ -94,6 +94,11 @@ const PROXY_ROUTES = [
         method: 'POST',
         pattern: /^entries$/
     },
+    // "Add a product page" on a product the site marks (editableProduct).
+    {
+        method: 'POST',
+        pattern: /^product-pages$/
+    },
     // The one-time address of the CMS's entry form (the prompt box's Form).
     {
         method: 'POST',

package/dist/site.mjs

@@ -92,6 +92,11 @@ const PROXY_ROUTES = [
         method: 'POST',
         pattern: /^entries$/
     },
+    // "Add a product page" on a product the site marks (editableProduct).
+    {
+        method: 'POST',
+        pattern: /^product-pages$/
+    },
     // The one-time address of the CMS's entry form (the prompt box's Form).
     {
         method: 'POST',

package/dist/{types-m3j4tltp.d.ts → types-mtjco3a5.d.ts}

@@ -31,6 +31,29 @@ type EntryStub<TContentType extends string = string> = {
     id: string;
     contentType: TContentType;
 };
+type LinkTarget = {
+    id: string;
+    title: string | Record<string, string>;
+    slug: string | null;
+    path: string | null;
+};
+type Link = {
+    type: 'entry';
+    entry: LinkTarget;
+    query: string | null;
+    hash: string | null;
+} | {
+    type: 'url';
+    url: string;
+    query: string | null;
+    hash: string | null;
+} | {
+    type: 'product';
+    product: ShopifyItem;
+    entry: LinkTarget | null;
+    query: string | null;
+    hash: string | null;
+};
 type Block<TFields extends Record<string, unknown> = Record<string, unknown>, TType extends string = string> = {
     _uid: string;
     _type: TType;
@@ -71,6 +94,10 @@ type RedirectList = {
     limit: number;
     skip: number;
 };
+type ShopifyItem = {
+    id: string;
+    handle: string;
+};
 type ContentTypeKind = 'page' | 'data' | 'block';
 type BaseField = {
     apiId: string;
@@ -128,11 +155,22 @@ type FieldDefinition = BaseField & ({
     contentTypes?: string[];
     min?: number;
     max?: number;
+} | {
+    type: 'link';
+    contentTypes?: string[];
+    products?: boolean;
 } | {
     type: 'blocks';
     allowedBlocks?: string[];
     min?: number;
     max?: number;
+} | {
+    type: 'shopify';
+    resource: 'collection' | 'product';
+    multiple?: boolean;
+    unique?: boolean;
+    min?: number;
+    max?: number;
 } | {
     type: 'json';
 });
@@ -150,5 +188,5 @@ type ModelFile = {
     contentTypes: ContentTypeDefinition[];
 };
 
-export type { Asset as A, Block as B, ContentTypeDefinition as C, Entry as E, FieldDefinition as F, ImproveBlock as I, ModelFile as M, RichTextFormat as R, RedirectList as a, Redirect as b, EntryList as c, EntryStub as d, RichTextNode as e, ContentTypeKind as f, Environment as g, FieldType as h, RichTextDocument as i, RichTextMark as j };
-//# sourceMappingURL=types-m3j4tltp.d.ts.map
+export type { Asset as A, Block as B, ContentTypeDefinition as C, Entry as E, FieldDefinition as F, ImproveBlock as I, LinkTarget as L, ModelFile as M, RichTextFormat as R, ShopifyItem as S, RedirectList as a, Redirect as b, EntryList as c, Link as d, EntryStub as e, RichTextNode as f, ContentTypeKind as g, Environment as h, FieldType as i, RichTextDocument as j, RichTextMark as k };
+//# sourceMappingURL=types-mtjco3a5.d.ts.map

package/dist/types-mtjco3a5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-mtjco3a5.d.ts","sources":["../src/types.ts"],"mappings":"AAAA,KAAK,WAAW;AAChB,KAAK,cAAc;AACnB,KAAK,KAAK;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA,oBAAoB,MAAM;AAC1B,kBAAkB,MAAM;AACxB;AACA;AACA;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA;AACA;AACA,WAAW,MAAM;AACjB;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS;AACd;AACA;AACA;AACA,KAAK,UAAU;AACf;AACA,oBAAoB,MAAM;AAC1B;AACA;AACA;AACA,KAAK,IAAI;AACT;AACA,WAAW,UAAU;AACrB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,aAAa,WAAW;AACxB,WAAW,UAAU;AACrB;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA,KAAK,YAAY,gBAAgB,KAAK,GAAG,KAAK,IAAI,KAAK;AACvD;AACA;AACA,cAAc,MAAM;AACpB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB,cAAc,YAAY;AAC1B;AACA,YAAY,YAAY;AACxB;AACA,KAAK,gBAAgB,GAAG,YAAY;AACpC;AACA;AACA,KAAK,SAAS,gBAAgB,KAAK,GAAG,KAAK;AAC3C;AACA;AACA;AACA;AACA;AACA,KAAK,QAAQ;AACb;AACA;AACA;AACA;AACA,KAAK,YAAY;AACjB,WAAW,QAAQ;AACnB;AACA;AACA;AACA;AACA,KAAK,WAAW;AAChB;AACA;AACA;AACA,KAAK,eAAe;AACpB,KAAK,SAAS;AACd;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,eAAe,GAAG,SAAS;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS,GAAG,eAAe;AAChC,KAAK,qBAAqB;AAC1B;AACA;AACA,UAAU,eAAe;AACzB;AACA,YAAY,eAAe;AAC3B;AACA,KAAK,SAAS;AACd;AACA;AACA,kBAAkB,qBAAqB;AACvC;;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@obelism/content",
 	"description": "Obelism Content SDK: the delivery API client, the visual editor bridge with prompt editing, editing on your own site, webhook verification, and the content model CLI",
-	"version": "0.16.0",
+	"version": "0.18.0",
 	"keywords": [
 		"cms",
 		"headless-cms",

package/dist/types-m3j4tltp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-m3j4tltp.d.ts","sources":["../src/types.ts"],"mappings":"AAAA,KAAK,WAAW;AAChB,KAAK,cAAc;AACnB,KAAK,KAAK;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA,oBAAoB,MAAM;AAC1B,kBAAkB,MAAM;AACxB;AACA;AACA;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA;AACA;AACA,WAAW,MAAM;AACjB;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS;AACd;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA,KAAK,YAAY,gBAAgB,KAAK,GAAG,KAAK,IAAI,KAAK;AACvD;AACA;AACA,cAAc,MAAM;AACpB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB,cAAc,YAAY;AAC1B;AACA,YAAY,YAAY;AACxB;AACA,KAAK,gBAAgB,GAAG,YAAY;AACpC;AACA;AACA,KAAK,SAAS,gBAAgB,KAAK,GAAG,KAAK;AAC3C;AACA;AACA;AACA;AACA;AACA,KAAK,QAAQ;AACb;AACA;AACA;AACA;AACA,KAAK,YAAY;AACjB,WAAW,QAAQ;AACnB;AACA;AACA;AACA;AACA,KAAK,eAAe;AACpB,KAAK,SAAS;AACd;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,eAAe,GAAG,SAAS;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS,GAAG,eAAe;AAChC,KAAK,qBAAqB;AAC1B;AACA;AACA,UAAU,eAAe;AACzB;AACA,YAAY,eAAe;AAC3B;AACA,KAAK,SAAS;AACd;AACA;AACA,kBAAkB,qBAAqB;AACvC;;","names":[]}