@obelism/content 0.15.0 → 0.17.0

package/README.md

@@ -295,6 +295,27 @@ const xml = sitemapXml(pages, {
 })
 ```
 
+## Links
+
+A `link` field goes to a page of the space or to any address, each with an
+optional query and anchor. It is delivered as `Link`: the page's `id`,
+`title`, `slug` and `path` (never its fields), or the `url`, plus `query` and
+`hash` without their `?` and `#`. A link to a page that isn't published is
+`null`. Where a page's path lives on your site is your routing, so
+`linkHref` takes it as `url` (default `/<path>`) and adds the query and hash:
+
+```tsx
+import { linkHref } from '@obelism/content'
+
+;<a
+	href={
+		linkHref(button.link, { url: (path) => `/${locale}/${path}` }) ?? undefined
+	}
+>
+	{button.label}
+</a>
+```
+
 ## A/B tests and feature flags
 
 Any blocks field can hold the built-in improve block (`ImproveBlock`,
@@ -319,6 +340,38 @@ const blocks = layout.flatMap((block) => {
 variant, else the first one, when the option is `null` (the test isn't
 active or the visitor isn't in it) or has no variant.
 
+## Shopify
+
+A `shopify` field holds a collection or product of the Shopify store
+connected to the space (Settings in Obelism Content), as `ShopifyItem`:
+`{ id, handle }`. Content stores only that, so fetch prices, stock and images
+live from Shopify's Storefront API with the store's domain and Storefront
+token (Settings → Copy as .env):
+
+```ts
+import { fetchShopifyCollection } from '@obelism/content'
+
+// A productGrid block: { heading, collection, columns }.
+const collection = await fetchShopifyCollection(block.collection, {
+	shop: process.env.SHOPIFY_STORE_DOMAIN!,
+	storefrontToken: process.env.SHOPIFY_STOREFRONT_TOKEN!,
+	first: 12,
+	country: 'NL', // optional: the market's prices
+})
+
+collection?.products.map((product) => ({
+	href: `/products/${product.handle}`,
+	title: product.title,
+	price: product.priceRange.minVariantPrice,
+	image: product.featuredImage,
+}))
+```
+
+`fetchShopifyProducts(items, options)` does the same for a product field
+(one item or a list), in the field's order. Both leave out what the store no
+longer has. A Hydrogen or Liquid site can use the `id` with its own
+Storefront queries instead.
+
 ## CLI
 
 Start a site's repository on a space, in its root:
@@ -372,6 +425,7 @@ locale, rich text as a document), and `| null` when empty:
 | select                   | the options' values, `'a' \| 'b'` (a list when multiple)             |
 | asset                    | `Asset` (a list when multiple)                                       |
 | reference                | the allowed entry types or their `EntryStub`s (a list when multiple) |
+| link                     | `Link`                                                               |
 | blocks                   | a list of the allowed block types and `ImproveBlock`                 |
 | richtext                 | `RichTextDocument`                                                   |
 | json                     | `unknown`                                                            |

package/dist/bin/content.js

@@ -146,6 +146,31 @@ const buildExamples = (model, improve)=>{
                         improveBlock(field.allowedBlocks, depth + 1)
                     ] : blocks;
                 }
+            case 'link':
+                return {
+                    type: 'entry',
+                    entry: {
+                        id: 'entry_example',
+                        title: 'Example page',
+                        slug: 'example',
+                        path: 'example'
+                    },
+                    query: null,
+                    hash: null
+                };
+            case 'shopify':
+                {
+                    const item = field.resource === 'collection' ? {
+                        id: 'gid://shopify/Collection/1',
+                        handle: 'example-collection'
+                    } : {
+                        id: 'gid://shopify/Product/1',
+                        handle: 'example-product'
+                    };
+                    return field.multiple ? [
+                        item
+                    ] : item;
+                }
             case 'json':
                 return {};
         }
@@ -535,7 +560,9 @@ const SDK_TYPES = [
     'Entry',
     'EntryStub',
     'ImproveBlock',
-    'RichTextDocument'
+    'Link',
+    'RichTextDocument',
+    'ShopifyItem'
 ];
 // The unions of every entry and block type the file ends with.
 const UNION_NAMES = [
@@ -607,6 +634,10 @@ const generateTypes = (model)=>{
                         improve
                     ]), true);
                 }
+            case 'link':
+                return use('Link');
+            case 'shopify':
+                return list(use('ShopifyItem'), field.multiple);
             case 'json':
                 return 'unknown';
         }

package/dist/index.d.mts

@@ -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, L as Link, S as ShopifyItem, d as EntryStub, e as RichTextNode } from './types-e5nvgudo.js';
+export { C as ContentTypeDefinition, f as ContentTypeKind, g as Environment, F as FieldDefinition, h as FieldType, i as LinkTarget, j as RichTextDocument, k as RichTextMark } from './types-e5nvgudo.js';
 
 type ContentClientOptions = {
     token: string;
@@ -96,6 +96,11 @@ 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;
+};
+declare const linkHref: (link: Link | null | undefined, { url }?: LinkHrefOptions) => string | null;
+
 declare const PREVIEW_PARAMS: {
     readonly preview: "cms_preview";
     readonly entry: "cms_entry";
@@ -110,6 +115,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 +184,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, ModelFile, PREVIEW_PARAMS, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, 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.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","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":"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","names":[]}
+{"version":3,"file":"index.d.mts","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.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, L as Link, S as ShopifyItem, d as EntryStub, e as RichTextNode } from './types-e5nvgudo.js';
+export { C as ContentTypeDefinition, f as ContentTypeKind, g as Environment, F as FieldDefinition, h as FieldType, i as LinkTarget, j as RichTextDocument, k as RichTextMark } from './types-e5nvgudo.js';
 
 type ContentClientOptions = {
     token: string;
@@ -96,6 +96,11 @@ 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;
+};
+declare const linkHref: (link: Link | null | undefined, { url }?: LinkHrefOptions) => string | null;
+
 declare const PREVIEW_PARAMS: {
     readonly preview: "cms_preview";
     readonly entry: "cms_entry";
@@ -110,6 +115,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 +184,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, ModelFile, PREVIEW_PARAMS, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, 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":"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","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

@@ -186,7 +186,10 @@ class ContentClient {
             headers: {
                 ...headersToObject(merged.headers),
                 Accept: 'application/json',
-                Authorization: `Bearer ${this.#token}`
+                // Not `Authorization`: Cloudflare never caches a request that
+                // carries it, and this header lets the API answer a delivery
+                // token from its edge cache.
+                'Obelism-Token': this.#token
             },
             signal: merged.signal ? AbortSignal.any([
                 merged.signal,
@@ -263,6 +266,87 @@ const pickImproveVariant = (block, option, fallback)=>{
     return Object.values(variants)[0] ?? [];
 };
 
+const linkHref = (link, { url = (path)=>`/${path}` } = {})=>{
+    if (!link) return null;
+    if (link.type === 'entry' && link.entry.path === null) return null;
+    const base = link.type === 'url' ? link.url : 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;
@@ -432,12 +516,17 @@ 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

@@ -184,7 +184,10 @@ class ContentClient {
             headers: {
                 ...headersToObject(merged.headers),
                 Accept: 'application/json',
-                Authorization: `Bearer ${this.#token}`
+                // Not `Authorization`: Cloudflare never caches a request that
+                // carries it, and this header lets the API answer a delivery
+                // token from its edge cache.
+                'Obelism-Token': this.#token
             },
             signal: merged.signal ? AbortSignal.any([
                 merged.signal,
@@ -261,6 +264,87 @@ const pickImproveVariant = (block, option, fallback)=>{
     return Object.values(variants)[0] ?? [];
 };
 
+const linkHref = (link, { url = (path)=>`/${path}` } = {})=>{
+    if (!link) return null;
+    if (link.type === 'entry' && link.entry.path === null) return null;
+    const base = link.type === 'url' ? link.url : 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;
@@ -420,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/{types-m3j4tltp.d.ts → types-e5nvgudo.d.ts}

@@ -31,6 +31,23 @@ 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 Block<TFields extends Record<string, unknown> = Record<string, unknown>, TType extends string = string> = {
     _uid: string;
     _type: TType;
@@ -71,6 +88,10 @@ type RedirectList = {
     limit: number;
     skip: number;
 };
+type ShopifyItem = {
+    id: string;
+    handle: string;
+};
 type ContentTypeKind = 'page' | 'data' | 'block';
 type BaseField = {
     apiId: string;
@@ -128,11 +149,20 @@ type FieldDefinition = BaseField & ({
     contentTypes?: string[];
     min?: number;
     max?: number;
+} | {
+    type: 'link';
+    contentTypes?: string[];
 } | {
     type: 'blocks';
     allowedBlocks?: string[];
     min?: number;
     max?: number;
+} | {
+    type: 'shopify';
+    resource: 'collection' | 'product';
+    multiple?: boolean;
+    min?: number;
+    max?: number;
 } | {
     type: 'json';
 });
@@ -150,5 +180,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, Link as L, ModelFile as M, RichTextFormat as R, ShopifyItem as S, RedirectList as a, Redirect as b, EntryList as c, EntryStub as d, RichTextNode as e, ContentTypeKind as f, Environment as g, FieldType as h, LinkTarget as i, RichTextDocument as j, RichTextMark as k };
+//# sourceMappingURL=types-e5nvgudo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-e5nvgudo.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,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,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.15.0",
+	"version": "0.17.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":[]}