@obelism/content 0.28.4 → 0.30.0

package/README.md

@@ -371,8 +371,14 @@ path, paths }`, plus `previousPath` and `previousPaths` when moved), `asset.upda
 `locales.changed` (`data.defaultLocale`, `data.locales`),
 `entry.review_requested` (`data.entry`, `data.revision`, `data.note`) and
 `entry.review_closed` (`data.outcome`: `approved` or `sent_back` with
-`data.reason`) for environments whose publishing is reviewed, and
-`webhook.test`.
+`data.reason`) for environments whose publishing is reviewed,
+`block.published` (`data.entry`: the shared block, `data.entries`: the
+published pages it updated), `release.published` and
+`release.review_requested` (`data.release`: `{ id, name }`, `data.entries`
+with each entry's `action`, `publish` or `unpublish`, and `data.note` on a
+review request), `product.updated`, `product.deleted`, `collection.updated`
+and `collection.deleted` (`data.entries` and `data.tags` a store's change
+touches), and `webhook.test`.
 
 ## Click rates
 
@@ -477,8 +483,26 @@ const blocks = layout.flatMap((block) => {
 ```
 
 `pickImproveVariant(block, option, fallback?)` falls back to `fallback`'s
-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.
+variant, else the block's own `fallback`, 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.
+
+That is for a page rendered per request. A prerendered page carries every
+variant, tagged, and a script in its head shows the visitor's before the
+first paint, with `seedTestCookies` from `@obelism/improve-sdk/server` at the
+edge; the block's `mode` (`instant` or `after-load`, from the page type's
+fold) says whether the other variants are markup or JSON. `content init`
+writes the whole pattern to `content/examples/_improve.md`, and Content's
+[A/B tests guide](https://content.obelism.studio/docs/guides/ab-tests) has
+the same.
+
+## Shared blocks
+
+A block shared between pages arrives as the block it is, with its fields,
+plus `_sharedFrom: { id, name }`: the block entry it comes from. Render it
+like any other block. A page left out of the block's last publish keeps the
+copy that was live then, marked with `heldAt` (ISO 8601). Publishing a shared
+block sends `block.published` (see Webhooks) instead of `entry.published`.
 
 ## Shopify
 
@@ -545,7 +569,8 @@ npx @obelism/content init
 
 It writes the model file (`content/content-model.json`), an example of what
 the delivery API answers for every content type (`content/examples/`, with
-the A/B test or flag block while your organization has improve on),
+the A/B test or flag block and how to render it while your organization has
+improve on),
 installs `@obelism/content` with your package manager, and adds the token variables to
 `.env.example`. Options: `--dir` (default `content`), `--url`,
 `--skip-install`. Agents get the same steps from the CMS's

package/dist/bin/content.js

@@ -87,6 +87,8 @@ const buildExamples = (model, improve)=>{
             _type: '_improve',
             kind: source.kind,
             slug: source.slug,
+            fallback: source.defaultValue ?? source.options[0]?.slug ?? null,
+            mode: 'instant',
             variants: Object.fromEntries(source.options.map((option)=>[
                     option.slug,
                     first && depth < MAX_DEPTH ? [
@@ -212,6 +214,341 @@ const buildExamples = (model, improve)=>{
     return examples;
 };
 
+// The CMS's docs/adr/0035: one copy of the site's half, beside the example.
+const IMPROVE_GUIDE = `# Rendering the improve block
+
+\`_improve.json\` is what the delivery API answers for the improve block: one
+list of blocks per option of an Obelism Improve test or flag. Editors add,
+run and end these tests without you, so set the site up once and a page can
+carry any number of tests without a build, a route or a deploy per test.
+
+Written by \`content init\`; the guide is
+https://content.obelism.studio/docs/guides/ab-tests.
+
+## Rendered per request
+
+If the page is rendered per request, pick the variant while you render and
+skip the rest of this file:
+
+\`\`\`ts
+import { isImproveBlock, pickImproveVariant } from '@obelism/content'
+
+// \`improve\` is Improve's server SDK (@obelism/improve-sdk/server) with its
+// datafile loaded; \`visitorId\` its cookie on the request.
+const blocks = fields.body.flatMap((block) => {
+	if (!isImproveBlock(block)) return [block]
+	const option =
+		block.kind === 'flag'
+			? improve.getFlagValue(block.slug, visitorId, userAgent, { country })
+			: improve.getTestValue(block.slug, visitorId, userAgent, { country })
+	return pickImproveVariant(block, option)
+})
+\`\`\`
+
+## Prerendered: every variant in the page
+
+A page built once (static, ISR) is the same bytes for every visitor. It
+carries every variant, tagged, and a script in the head shows one before the
+first paint. Five pieces, set up once.
+
+### 1. The block renderer
+
+The branch of your block renderer that meets \`_improve\`. \`mode\` is stamped
+when the entry is published: \`instant\` puts every variant in the markup,
+\`after-load\` only the \`fallback\` one, with the others as JSON beside it.
+
+\`\`\`tsx
+import { isImproveBlock, type Block, type ImproveBlock } from '@obelism/content'
+
+import { AfterLoadVariants } from './AfterLoadVariants'
+
+export const BlockRenderer = ({ block }: { block: Block }) => {
+	if (isImproveBlock(block)) {
+		return block.mode === 'after-load' ? (
+			<AfterLoadVariants block={block} />
+		) : (
+			<ImproveVariants block={block} />
+		)
+	}
+	const Component = components[block._type]
+	return Component ? <Component block={block} /> : null
+}
+
+const ImproveVariants = ({ block }: { block: ImproveBlock }) => (
+	<>
+		{Object.entries(block.variants ?? {}).map(([option, blocks]) => (
+			<div key={option} data-ob-imp={block.slug} data-ob-opt={option}>
+				{blocks.map((child) => (
+					<BlockRenderer block={child} key={child._uid} />
+				))}
+			</div>
+		))}
+	</>
+)
+\`\`\`
+
+The element around a variant gets \`display: contents\` from the style below,
+so a block in a grid or a flex row keeps its place.
+
+### 2. The head
+
+The instant tests of the page, their option lists, a classic script and one
+style rule per test, all in \`<head>\` before the body. Never \`type="module"\`,
+\`defer\` or \`async\`: those run after the variants are painted. Allow the
+script in a CSP by its hash; Cloudflare's Rocket Loader needs
+\`data-cfasync="false"\` on it.
+
+\`\`\`ts
+import type { ImproveBlock } from '@obelism/content'
+
+const SAFE = /^[a-z0-9-]+$/
+
+// Every improve block in an entry, however deep.
+export const improveBlocks = (value: unknown, found: ImproveBlock[] = []) => {
+	if (Array.isArray(value)) value.forEach((item) => improveBlocks(item, found))
+	else if (value && typeof value === 'object') {
+		const record = value as Record<string, unknown>
+		if (record._type === '_improve') found.push(value as ImproveBlock)
+		for (const child of Object.values(record)) improveBlocks(child, found)
+	}
+	return found
+}
+
+// The meta's content and the style, from the page's instant placements.
+// Nothing (and no script) when it has none.
+export const improveHead = (entry: unknown) => {
+	const tests = new Map<string, { options: string[]; fallback: string }>()
+	for (const block of improveBlocks(entry)) {
+		if (block.mode === 'after-load' || !SAFE.test(block.slug)) continue
+		const options = Object.keys(block.variants ?? {}).filter((option) =>
+			SAFE.test(option),
+		)
+		const fallback =
+			block.fallback && options.includes(block.fallback)
+				? block.fallback
+				: options[0]
+		if (fallback) tests.set(block.slug, { options, fallback })
+	}
+	if (tests.size === 0) return null
+
+	const meta = JSON.stringify(
+		Object.fromEntries([...tests].map(([slug, { options }]) => [slug, options])),
+	)
+	const hidden = [...tests].flatMap(([slug, { options, fallback }]) => [
+		\`html:not([data-imp-\${slug}]) [data-ob-imp="\${slug}"]:not([data-ob-opt="\${fallback}"])\`,
+		...options.map(
+			(option) =>
+				\`html[data-imp-\${slug}="\${option}"] [data-ob-imp="\${slug}"]:not([data-ob-opt="\${option}"])\`,
+		),
+	])
+	const style = \`[data-ob-imp]{display:contents}\\n\${hidden.join(',\\n')}{display:none}\`
+	return { meta, style }
+}
+\`\`\`
+
+\`\`\`html
+<meta name="obelism-improve" content='{"homepage-hero":["control","variation"]}' />
+<script data-cfasync="false">
+	;(function () {
+		var meta = document.querySelector('meta[name="obelism-improve"]')
+		if (!meta) return
+		var tests = JSON.parse(meta.content)
+		var cookies = document.cookie.split('; ')
+		for (var slug in tests) {
+			for (var i = 0; i < cookies.length; i++) {
+				if (cookies[i].indexOf(slug + '=') !== 0) continue
+				var value = cookies[i].slice(slug.length + 1)
+				if (tests[slug].indexOf(value) > -1)
+					document.documentElement.setAttribute('data-imp-' + slug, value)
+			}
+		}
+	})()
+</script>
+<style>
+	/* improveHead(entry).style */
+</style>
+\`\`\`
+
+In React, \`improveHead(entry)\` gives the meta's \`content\` and the style's
+text: \`<meta name="obelism-improve" content={head.meta} />\`, then the script
+as a string in \`<script dangerouslySetInnerHTML={{ __html: RUNTIME }} />\`,
+then \`<style dangerouslySetInnerHTML={{ __html: head.style }} />\`. The slugs
+and options in both passed \`SAFE\`, so neither can close its tag.
+
+The option list matters: a cookie can name an option the block no longer
+has, and without the check every variant of that block would hide. Only the
+variants that lost are ever hidden; the one that shows keeps your styles.
+
+### 3. The edge
+
+An edge function in front of the page decides every active test and flag
+before the page is served, and keeps the cookies a visitor already has.
+Without one, every visitor gets the fallback and the test measures nothing.
+
+\`\`\`ts
+import { ImproveServerSDK } from '@obelism/improve-sdk/server'
+
+// Per request: the instance keeps its datafile for as long as it lives.
+const improve = new ImproveServerSDK({
+	organizationId: 'org_…',
+	spaceId: 'space_…',
+	environment: 'production',
+	token: env.IMPROVE_TOKEN,
+})
+await improve.fetchConfig()
+
+const { cookies } = improve.seedTestCookies({
+	cookieHeader: request.headers.get('Cookie'),
+	userAgent: request.headers.get('User-Agent') ?? '',
+	geo: { country: request.headers.get('CF-IPCountry') ?? undefined },
+})
+for (const { header } of cookies) response.headers.append('Set-Cookie', header)
+\`\`\`
+
+Leave bots out (they get the fallback and no cookie), never send
+\`Vary: Cookie\`, and keep caching the page itself: only the cookies are per
+visitor.
+
+### 4. The exposure
+
+Results count exposures, and nothing has recorded one: the page decided
+nothing. After paint, ask Improve's client SDK once per test the edge
+decided; it reads the cookie, records the exposure and does not bucket again.
+
+\`\`\`ts
+// improveExposure.ts
+import type { ImproveBlock } from '@obelism/content'
+import { ImproveClientSDK } from '@obelism/improve-sdk/client'
+
+let ready: Promise<ImproveClientSDK> | undefined
+const recorded = new Set<string>()
+
+// Once per test, however many placements the page has.
+export const recordExposure = async ({ slug, kind }: ImproveBlock) => {
+	if (recorded.has(slug)) return
+	recorded.add(slug)
+	ready ??= (async () => {
+		const improve = new ImproveClientSDK({
+			organizationId: 'org_…',
+			spaceId: 'space_…',
+			environment: 'production',
+		})
+		await improve.fetchConfig()
+		return improve
+	})()
+	const improve = await ready
+	if (kind === 'flag') improve.getFlagValue(slug)
+	else improve.getTestValue(slug)
+}
+\`\`\`
+
+\`\`\`tsx
+'use client'
+import { useEffect } from 'react'
+import type { ImproveBlock } from '@obelism/content'
+
+import { recordExposure } from './improveExposure'
+
+// Once per page, with improveBlocks(entry).
+export const ImproveExposures = ({ blocks }: { blocks: ImproveBlock[] }) => {
+	useEffect(() => {
+		for (const block of blocks) {
+			if (block.mode === 'after-load') continue
+			if (document.documentElement.hasAttribute(\`data-imp-\${block.slug}\`))
+				recordExposure(block)
+		}
+	}, [blocks])
+	return null
+}
+\`\`\`
+
+### 5. After-load placements
+
+Below the page type's fold, publishing stamps \`mode: "after-load"\`: the
+fallback variant is markup, the others JSON in the page, swapped in on mount.
+No second variant's markup or images, and no head script for a page that has
+only these. It needs a block renderer that runs in the browser.
+
+\`\`\`tsx
+'use client'
+import { useEffect, useState } from 'react'
+import type { Block, ImproveBlock } from '@obelism/content'
+
+import { BlockRenderer } from './BlockRenderer'
+import { recordExposure } from './improveExposure'
+
+// \`<\` escaped, so a block's text can't close the script.
+const json = (value: unknown) =>
+	JSON.stringify(value).replace(/</g, '\\\\u003c')
+
+const readCookie = (name: string) =>
+	document.cookie
+		.split('; ')
+		.find((row) => row.startsWith(\`\${name}=\`))
+		?.slice(name.length + 1)
+
+export const AfterLoadVariants = ({ block }: { block: ImproveBlock }) => {
+	const variants = block.variants ?? {}
+	const fallback =
+		block.fallback && variants[block.fallback]
+			? block.fallback
+			: Object.keys(variants)[0]
+	const others = Object.fromEntries(
+		Object.entries(variants).filter(([option]) => option !== fallback),
+	)
+	const [shown, setShown] = useState<{ option: string | undefined; blocks: Block[] }>({
+		option: fallback,
+		blocks: (fallback && variants[fallback]) || [],
+	})
+
+	useEffect(() => {
+		const option = readCookie(block.slug)
+		if (!option) return
+		const script = document.querySelector(
+			\`script[data-ob-variants="\${CSS.escape(block.slug)}"]\`,
+		)
+		const arms: Record<string, Block[]> =
+			option === fallback ? variants : JSON.parse(script?.textContent || '{}')
+		// The cookie is the visitor's to edit: only an option the block has.
+		const blocks = Object.hasOwn(arms, option) ? arms[option] : undefined
+		if (!Array.isArray(blocks)) return
+		setShown({ option, blocks })
+		document.documentElement.setAttribute(\`data-imp-\${block.slug}\`, option)
+		recordExposure(block)
+	}, [block.slug])
+
+	return (
+		<>
+			<div
+				data-ob-imp={block.slug}
+				data-ob-opt={shown.option}
+				style={{ display: 'contents' }}
+			>
+				{shown.blocks.map((child) => (
+					<BlockRenderer block={child} key={child._uid} />
+				))}
+			</div>
+			<script
+				type="application/json"
+				data-ob-variants={block.slug}
+				dangerouslySetInnerHTML={{ __html: json(others) }}
+			/>
+		</>
+	)
+}
+\`\`\`
+
+Its own \`display: contents\` is inline: a page with only after-load
+placements has no head style. The exposure is recorded when the swap lands, not before: a visitor who never
+gets the variant is not counted as seeing it.
+
+## Ending a test
+
+Pausing it in Improve only stops new assignments. In Content, **Keep a
+variant** on the block replaces it with that option's blocks; publishing the
+page ends the test for everyone.
+`;
+
 // Turns a model plan from the management API into text for a terminal, or
 // Markdown for a GitHub step summary or pull request comment.
 const ACTION_SIGN = {
@@ -535,8 +872,11 @@ const runInitCommand = async ({ url, token, dir, install: shouldInstall, cwd = p
     for (const [apiId, example] of Object.entries(examples)){
         await writeJson(node_path.join(examplesDir, `${apiId}.json`), example);
     }
+    if (improve.enabled) {
+        await promises.writeFile(node_path.join(examplesDir, '_improve.md'), IMPROVE_GUIDE);
+    }
     const count = Object.keys(examples).length;
-    log(`Wrote ${count} ${count === 1 ? 'example' : 'examples'} to ${node_path.join(dir, 'examples')}${improve.enabled ? ', with the A/B test or flag block (_improve.json): improve is on' : ''}.`);
+    log(`Wrote ${count} ${count === 1 ? 'example' : 'examples'} to ${node_path.join(dir, 'examples')}${improve.enabled ? ', with the A/B test or flag block (_improve.json) and how to render it (_improve.md): improve is on' : ''}.`);
     if (await writeEnvExample(cwd, url)) {
         log('Added the token variables to .env.example.');
     }
@@ -548,7 +888,7 @@ const runInitCommand = async ({ url, token, dir, install: shouldInstall, cwd = p
         '- Set CONTENT_SPACE_ID and CONTENT_ENVIRONMENT, and pass them as space and environment to the ContentClient you read cms_token with, so a cms_token for another space reads nothing.',
         '- Fetch content with ContentClient from @obelism/content; the examples show what each type looks like.',
         ...improve.enabled ? [
-            "- Render _improve blocks: ask improve's SDK for the visitor's option (getTestValue / getFlagValue with the block's slug) and render pickImproveVariant(block, option)."
+            `- Render _improve blocks as ${node_path.join(dir, 'examples', '_improve.md')} says: every variant tagged in the page, a script in the head, seedTestCookies at the edge and an exposure after paint (or pickImproveVariant on a page rendered per request).`
         ] : [],
         `- Keep the model in step with \`content model pull|plan|apply\` (${node_path.join(dir, 'content-model.json')}).`
     ].join('\n'));

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { TokenSource } from './oidc.mjs';
-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-b6jbj3g6.js';
-export { g as AssetProduct, C as ContentTypeAccent, h as ContentTypeDefinition, i as ContentTypeKind, j as Environment, F as FieldCondition, k as FieldDefinition, l as FieldGroup, m as FieldType, n as RichTextDocument, o as RichTextMark } from './types-b6jbj3g6.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-e32p5mys.js';
+export { g as AssetProduct, C as ContentTypeAccent, h as ContentTypeDefinition, i as ContentTypeKind, j as Environment, F as FieldCondition, k as FieldDefinition, l as FieldGroup, m as FieldType, n as RichTextDocument, o as RichTextMark, p as SharedFrom } from './types-e32p5mys.js';
 
 type ContentClientOptions = {
     token: TokenSource;
@@ -117,7 +117,7 @@ declare const imageSrcSet: (asset: (Pick<Asset, "url"> & Partial<Pick<Asset, "fo
 
 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[];
+declare const pickImproveVariant: <TBlock extends Block>(block: ImproveBlock<TBlock>, option: string | null | undefined, fallback?: string | null) => TBlock[];
 
 type LinkHrefOptions = {
     url?: ((path: string) => string) | undefined;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { TokenSource } from './oidc.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-b6jbj3g6.js';
-export { g as AssetProduct, C as ContentTypeAccent, h as ContentTypeDefinition, i as ContentTypeKind, j as Environment, F as FieldCondition, k as FieldDefinition, l as FieldGroup, m as FieldType, n as RichTextDocument, o as RichTextMark } from './types-b6jbj3g6.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-e32p5mys.js';
+export { g as AssetProduct, C as ContentTypeAccent, h as ContentTypeDefinition, i as ContentTypeKind, j as Environment, F as FieldCondition, k as FieldDefinition, l as FieldGroup, m as FieldType, n as RichTextDocument, o as RichTextMark, p as SharedFrom } from './types-e32p5mys.js';
 
 type ContentClientOptions = {
     token: TokenSource;
@@ -117,7 +117,7 @@ declare const imageSrcSet: (asset: (Pick<Asset, "url"> & Partial<Pick<Asset, "fo
 
 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[];
+declare const pickImproveVariant: <TBlock extends Block>(block: ImproveBlock<TBlock>, option: string | null | undefined, fallback?: string | null) => TBlock[];
 
 type LinkHrefOptions = {
     url?: ((path: string) => string) | undefined;

package/dist/index.js

@@ -33,6 +33,9 @@ const fieldParams = (fields)=>Object.fromEntries(Object.entries(fields ?? {}).ma
         ];
     }));
 const trimSlashes = (path)=>path.replace(/^\/+|\/+$/g, '');
+// `/space_…/<environment>`: the part of a scoped delivery path between
+// DELIVERY_PATH and the operation.
+const SCOPE = /^\/space_[^/]+\/[^/]+$/;
 // Reads one space environment's content through the delivery API. The token
 // decides the space, the environment and whether drafts are visible (for a
 // host token, with `drafts`).
@@ -42,11 +45,17 @@ const trimSlashes = (path)=>path.replace(/^\/+|\/+$/g, '');
 class ContentClient {
     #token;
     #place;
+    // Where the API answers this client's token: it sends a token that reads
+    // published content to `/api/delivery/v1/{space}/{environment}/…` with a
+    // 308, so the client asks there directly after the first one. Never used
+    // for a request that reads drafts, which the scoped path refuses.
+    #scope;
     #defaults;
     #timeout;
     #init;
     #fetch;
     constructor({ token, drafts, space, environment, url, locale, depth, richText, timeout, init, fetch: fetchImpl }){
+        this.#scope = null;
         // The page at a path (`blog/hello`), or null when there is none. A site's
         // catch-all route asks for this. The path is looked up in `locale`'s
         // paths (the default locale's when left out or `*`): pages can have a
@@ -171,7 +180,7 @@ class ContentClient {
     }
     // For a 404, null when `notFound` is set, or the body as is for 'body';
     // throws ContentApiError otherwise.
-    async #request(path, query, { init, ...options }, { notFound = false, defaults = true } = {}) {
+    async #request(path, query, { init, ...options }, { notFound = false, defaults = true, scoped = true } = {}) {
         // Checked here rather than in the constructor, so a module creating a
         // client still loads (and a build still runs) without the variable.
         if (!this.#token) throw new Error('ContentClient needs a token');
@@ -190,7 +199,8 @@ class ContentClient {
             if (value !== undefined) params.set(key, String(value));
         }
         const search = params.size > 0 ? `?${params}` : '';
-        const url = `${this.url}${config.DELIVERY_PATH}${path}${search}`;
+        const scope = drafts || !scoped ? null : this.#scope;
+        const url = `${this.url}${config.DELIVERY_PATH}${scope ?? ''}${path}${search}`;
         const merged = {
             ...this.#init,
             ...init
@@ -215,6 +225,21 @@ class ContentClient {
                 timeout
             ]) : timeout
         });
+        // A token that changed, or now reads drafts, is refused on the path
+        // learned for the one before it: ask unscoped once, and learn again.
+        if (scope && (response.status === 401 || response.status === 403)) {
+            if (this.#scope === scope) this.#scope = null;
+            await response.body?.cancel();
+            return this.#request(path, query, {
+                init,
+                ...options
+            }, {
+                notFound,
+                defaults,
+                scoped: false
+            });
+        }
+        if (!scope && !drafts && response.redirected) this.#learnScope(response, path);
         if (notFound === true && response.status === 404) return null;
         const text = await response.text();
         let body = text;
@@ -229,6 +254,18 @@ class ContentClient {
         if (!response.ok) throw new ContentApiError(response.status, url, body);
         return body;
     }
+    #learnScope(response, path) {
+        let redirected;
+        try {
+            redirected = new URL(response.url);
+        } catch  {
+            return;
+        }
+        const { origin, pathname } = redirected;
+        if (origin !== new URL(this.url).origin || !pathname.startsWith(`${config.DELIVERY_PATH}/`) || !pathname.endsWith(path)) return;
+        const scope = pathname.slice(config.DELIVERY_PATH.length, pathname.length - path.length);
+        if (SCOPE.test(scope)) this.#scope = scope;
+    }
 }
 const withoutUndefined = (value)=>Object.fromEntries(Object.entries(value).filter(([, entry])=>entry !== undefined));
 const headersToObject = (headers)=>headers ? Object.fromEntries(new Headers(headers)) : {};
@@ -277,11 +314,14 @@ const isImproveBlock = (block)=>block._type === IMPROVE_BLOCK;
 // improve's SDK returned for the visitor (getTestValue / getFlagValue). It
 // is null when the test or flag isn't active or the visitor isn't in it;
 // then, or for an option the block has no variant for, the `fallback`
-// option's variant, else the first one (usually the control).
+// option's variant, else the first one.
 const pickImproveVariant = (block, option, fallback)=>{
     const variants = block.variants ?? {};
     if (option && variants[option]) return variants[option];
-    if (fallback && variants[fallback]) return variants[fallback];
+    // The arm Improve gives a visitor outside the test, when the caller names
+    // none: it is not always the first variant.
+    const behind = fallback ?? block.fallback;
+    if (behind && variants[behind]) return variants[behind];
     return Object.values(variants)[0] ?? [];
 };
 

package/dist/index.mjs

@@ -31,6 +31,9 @@ const fieldParams = (fields)=>Object.fromEntries(Object.entries(fields ?? {}).ma
         ];
     }));
 const trimSlashes = (path)=>path.replace(/^\/+|\/+$/g, '');
+// `/space_…/<environment>`: the part of a scoped delivery path between
+// DELIVERY_PATH and the operation.
+const SCOPE = /^\/space_[^/]+\/[^/]+$/;
 // Reads one space environment's content through the delivery API. The token
 // decides the space, the environment and whether drafts are visible (for a
 // host token, with `drafts`).
@@ -40,11 +43,17 @@ const trimSlashes = (path)=>path.replace(/^\/+|\/+$/g, '');
 class ContentClient {
     #token;
     #place;
+    // Where the API answers this client's token: it sends a token that reads
+    // published content to `/api/delivery/v1/{space}/{environment}/…` with a
+    // 308, so the client asks there directly after the first one. Never used
+    // for a request that reads drafts, which the scoped path refuses.
+    #scope;
     #defaults;
     #timeout;
     #init;
     #fetch;
     constructor({ token, drafts, space, environment, url, locale, depth, richText, timeout, init, fetch: fetchImpl }){
+        this.#scope = null;
         // The page at a path (`blog/hello`), or null when there is none. A site's
         // catch-all route asks for this. The path is looked up in `locale`'s
         // paths (the default locale's when left out or `*`): pages can have a
@@ -169,7 +178,7 @@ class ContentClient {
     }
     // For a 404, null when `notFound` is set, or the body as is for 'body';
     // throws ContentApiError otherwise.
-    async #request(path, query, { init, ...options }, { notFound = false, defaults = true } = {}) {
+    async #request(path, query, { init, ...options }, { notFound = false, defaults = true, scoped = true } = {}) {
         // Checked here rather than in the constructor, so a module creating a
         // client still loads (and a build still runs) without the variable.
         if (!this.#token) throw new Error('ContentClient needs a token');
@@ -188,7 +197,8 @@ class ContentClient {
             if (value !== undefined) params.set(key, String(value));
         }
         const search = params.size > 0 ? `?${params}` : '';
-        const url = `${this.url}${DELIVERY_PATH}${path}${search}`;
+        const scope = drafts || !scoped ? null : this.#scope;
+        const url = `${this.url}${DELIVERY_PATH}${scope ?? ''}${path}${search}`;
         const merged = {
             ...this.#init,
             ...init
@@ -213,6 +223,21 @@ class ContentClient {
                 timeout
             ]) : timeout
         });
+        // A token that changed, or now reads drafts, is refused on the path
+        // learned for the one before it: ask unscoped once, and learn again.
+        if (scope && (response.status === 401 || response.status === 403)) {
+            if (this.#scope === scope) this.#scope = null;
+            await response.body?.cancel();
+            return this.#request(path, query, {
+                init,
+                ...options
+            }, {
+                notFound,
+                defaults,
+                scoped: false
+            });
+        }
+        if (!scope && !drafts && response.redirected) this.#learnScope(response, path);
         if (notFound === true && response.status === 404) return null;
         const text = await response.text();
         let body = text;
@@ -227,6 +252,18 @@ class ContentClient {
         if (!response.ok) throw new ContentApiError(response.status, url, body);
         return body;
     }
+    #learnScope(response, path) {
+        let redirected;
+        try {
+            redirected = new URL(response.url);
+        } catch  {
+            return;
+        }
+        const { origin, pathname } = redirected;
+        if (origin !== new URL(this.url).origin || !pathname.startsWith(`${DELIVERY_PATH}/`) || !pathname.endsWith(path)) return;
+        const scope = pathname.slice(DELIVERY_PATH.length, pathname.length - path.length);
+        if (SCOPE.test(scope)) this.#scope = scope;
+    }
 }
 const withoutUndefined = (value)=>Object.fromEntries(Object.entries(value).filter(([, entry])=>entry !== undefined));
 const headersToObject = (headers)=>headers ? Object.fromEntries(new Headers(headers)) : {};
@@ -275,11 +312,14 @@ const isImproveBlock = (block)=>block._type === IMPROVE_BLOCK;
 // improve's SDK returned for the visitor (getTestValue / getFlagValue). It
 // is null when the test or flag isn't active or the visitor isn't in it;
 // then, or for an option the block has no variant for, the `fallback`
-// option's variant, else the first one (usually the control).
+// option's variant, else the first one.
 const pickImproveVariant = (block, option, fallback)=>{
     const variants = block.variants ?? {};
     if (option && variants[option]) return variants[option];
-    if (fallback && variants[fallback]) return variants[fallback];
+    // The arm Improve gives a visitor outside the test, when the caller names
+    // none: it is not always the first variant.
+    const behind = fallback ?? block.fallback;
+    if (behind && variants[behind]) return variants[behind];
     return Object.values(variants)[0] ?? [];
 };
 

package/dist/{types-b6jbj3g6.d.ts → types-e32p5mys.d.ts}

@@ -72,10 +72,18 @@ type Link = {
 type Block<TFields extends Record<string, unknown> = Record<string, unknown>, TType extends string = string> = {
     _uid: string;
     _type: TType;
+    _sharedFrom?: SharedFrom;
 } & TFields;
+type SharedFrom = {
+    id: string;
+    name: string;
+    heldAt?: string;
+};
 type ImproveBlock<TBlock extends Block = Block> = Block<{
     kind: 'test' | 'flag';
     slug: string;
+    fallback?: string | null;
+    mode?: 'instant' | 'after-load' | null;
     variants: Record<string, TBlock[]>;
 }, '_improve'>;
 type RichTextMark = {
@@ -225,5 +233,5 @@ type ModelFile = {
     contentTypes: ContentTypeDefinition[];
 };
 
-export type { Asset as A, Block as B, ContentTypeAccent as C, Entry as E, FieldCondition 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, AssetProduct as g, ContentTypeDefinition as h, ContentTypeKind as i, Environment as j, FieldDefinition as k, FieldGroup as l, FieldType as m, RichTextDocument as n, RichTextMark as o };
-//# sourceMappingURL=types-b6jbj3g6.d.ts.map
+export type { Asset as A, Block as B, ContentTypeAccent as C, Entry as E, FieldCondition 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, AssetProduct as g, ContentTypeDefinition as h, ContentTypeKind as i, Environment as j, FieldDefinition as k, FieldGroup as l, FieldType as m, RichTextDocument as n, RichTextMark as o, SharedFrom as p };
+//# sourceMappingURL=types-e32p5mys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-e32p5mys.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,eAAe,YAAY;AAC3B;AACA,KAAK,YAAY;AACjB;AACA;AACA;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;AACA,gBAAgB,WAAW;AAC3B,WAAW,UAAU;AACrB;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA,kBAAkB,UAAU;AAC5B;AACA,KAAK,UAAU;AACf;AACA;AACA;AACA;AACA,KAAK,YAAY,gBAAgB,KAAK,GAAG,KAAK,IAAI,KAAK;AACvD;AACA;AACA;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;AACA,iBAAiB,MAAM;AACvB;AACA,WAAW,cAAc;AACzB;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA,KAAK,UAAU;AACf;AACA;AACA;AACA;AACA,KAAK,iBAAiB;AACtB,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;AACA,KAAK,SAAS,GAAG,eAAe;AAChC,KAAK,qBAAqB;AAC1B;AACA;AACA,UAAU,eAAe;AACzB;AACA;AACA,aAAa,iBAAiB;AAC9B;AACA,aAAa,UAAU;AACvB,YAAY,eAAe;AAC3B;AACA,KAAK,SAAS;AACd;AACA;AACA,kBAAkB,qBAAqB;AACvC;;","names":[]}

package/dist/webhooks.d.mts

@@ -17,6 +17,10 @@ type WebhookEventOf<TType extends string, TData> = {
 type EntryPublishedEvent = WebhookEventOf<'entry.published', {
     entry: WebhookEntry;
 }>;
+type BlockPublishedEvent = WebhookEventOf<'block.published', {
+    entry: WebhookEntry;
+    entries: WebhookEntry[];
+}>;
 type EntryUnpublishedEvent = WebhookEventOf<'entry.unpublished', {
     entry: WebhookEntry;
 }>;
@@ -56,6 +60,22 @@ type EntryReviewClosedEvent = WebhookEventOf<'entry.review_closed', {
     revision: number;
     reason?: string;
 }>;
+type WebhookRelease = {
+    id: string;
+    name: string;
+};
+type WebhookReleaseEntry = WebhookEntry & {
+    action: 'publish' | 'unpublish';
+};
+type ReleasePublishedEvent = WebhookEventOf<'release.published', {
+    release: WebhookRelease;
+    entries: WebhookReleaseEntry[];
+}>;
+type ReleaseReviewRequestedEvent = WebhookEventOf<'release.review_requested', {
+    release: WebhookRelease;
+    note: string | null;
+    entries: WebhookReleaseEntry[];
+}>;
 type WebhookShopifyItem = {
     id: string;
     handle: string | null;
@@ -79,7 +99,7 @@ type CollectionDeletedEvent = WebhookEventOf<'collection.deleted', StoreChange &
     collection: WebhookShopifyItem;
 }>;
 type WebhookTestEvent = WebhookEventOf<'webhook.test', Record<string, never>>;
-type WebhookEvent = EntryPublishedEvent | EntryUnpublishedEvent | EntryDeletedEvent | EntryMovedEvent | AssetUpdatedEvent | ModelChangedEvent | LocalesChangedEvent | EntryReviewRequestedEvent | EntryReviewClosedEvent | ProductUpdatedEvent | ProductDeletedEvent | CollectionUpdatedEvent | CollectionDeletedEvent | WebhookTestEvent;
+type WebhookEvent = EntryPublishedEvent | BlockPublishedEvent | EntryUnpublishedEvent | EntryDeletedEvent | EntryMovedEvent | AssetUpdatedEvent | ModelChangedEvent | LocalesChangedEvent | EntryReviewRequestedEvent | EntryReviewClosedEvent | ReleasePublishedEvent | ReleaseReviewRequestedEvent | ProductUpdatedEvent | ProductDeletedEvent | CollectionUpdatedEvent | CollectionDeletedEvent | WebhookTestEvent;
 type WebhookEventType = WebhookEvent['type'];
 declare class WebhookVerificationError extends Error {
     constructor(message: string);
@@ -103,5 +123,5 @@ type WebhookHandlerOptions = {
 declare const createWebhookHandler: ({ secret, onEvent, tolerance }: WebhookHandlerOptions) => (request: Request) => Promise<Response>;
 
 export { WebhookVerificationError, createWebhookHandler, verifyWebhook };
-export type { AssetUpdatedEvent, CollectionDeletedEvent, CollectionUpdatedEvent, EntryDeletedEvent, EntryMovedEvent, EntryPublishedEvent, EntryReviewClosedEvent, EntryReviewRequestedEvent, EntryUnpublishedEvent, LocalesChangedEvent, ModelChangedEvent, ProductDeletedEvent, ProductUpdatedEvent, VerifyWebhookOptions, WebhookEntry, WebhookEvent, WebhookEventType, WebhookHandlerOptions, WebhookMessage, WebhookShopifyItem, WebhookTestEvent };
+export type { AssetUpdatedEvent, BlockPublishedEvent, CollectionDeletedEvent, CollectionUpdatedEvent, EntryDeletedEvent, EntryMovedEvent, EntryPublishedEvent, EntryReviewClosedEvent, EntryReviewRequestedEvent, EntryUnpublishedEvent, LocalesChangedEvent, ModelChangedEvent, ProductDeletedEvent, ProductUpdatedEvent, ReleasePublishedEvent, ReleaseReviewRequestedEvent, VerifyWebhookOptions, WebhookEntry, WebhookEvent, WebhookEventType, WebhookHandlerOptions, WebhookMessage, WebhookRelease, WebhookReleaseEntry, WebhookShopifyItem, WebhookTestEvent };
 //# sourceMappingURL=webhooks.d.mts.map

package/dist/webhooks.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.mts","sources":["../src/webhooks.ts"],"mappings":";;AACA,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA,WAAW,MAAM;AACjB;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,iBAAiB,WAAW;AAC5B;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC,WAAW,YAAY;AACvB;AACA,KAAK,qBAAqB,GAAG,cAAc;AAC3C,WAAW,YAAY;AACvB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC,WAAW,YAAY;AACvB;AACA,KAAK,eAAe,GAAG,cAAc;AACrC,WAAW,YAAY;AACvB;AACA,mBAAmB,MAAM;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA,aAAa,YAAY;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC;AACA;AACA;AACA,KAAK,yBAAyB,GAAG,cAAc;AAC/C,WAAW,YAAY;AACvB;AACA;AACA;AACA,KAAK,sBAAsB,GAAG,cAAc;AAC5C,WAAW,YAAY;AACvB;AACA;AACA;AACA;AACA,KAAK,kBAAkB;AACvB;AACA;AACA;AACA,KAAK,WAAW;AAChB,aAAa,YAAY;AACzB;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,gBAAgB,GAAG,cAAc,iBAAiB,MAAM;AAC7D,KAAK,YAAY,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,GAAG,gBAAgB;AACzU,KAAK,gBAAgB,GAAG,YAAY;AACpC,cAAc,wBAAwB,SAAS,KAAK;AACpD;AACA;AACA,KAAK,cAAc;AACnB;AACA,aAAa,OAAO,GAAG,MAAM,0CAA0C,QAAQ;AAC/E;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA,cAAc,aAAa,YAAY,OAAO,GAAG,cAAc,wCAAwC,oBAAoB,KAAK,OAAO,CAAC,YAAY;AACpJ,KAAK,qBAAqB;AAC1B;AACA,qBAAqB,YAAY;AACjC;AACA;AACA;AACA;AACA,cAAc,oBAAoB,mCAAmC,qBAAqB,eAAe,OAAO,KAAK,OAAO,CAAC,QAAQ","names":[]}
+{"version":3,"file":"webhooks.d.mts","sources":["../src/webhooks.ts"],"mappings":";;AACA,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA,WAAW,MAAM;AACjB;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,iBAAiB,WAAW;AAC5B;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC,WAAW,YAAY;AACvB;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC,WAAW,YAAY;AACvB,aAAa,YAAY;AACzB;AACA,KAAK,qBAAqB,GAAG,cAAc;AAC3C,WAAW,YAAY;AACvB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC,WAAW,YAAY;AACvB;AACA,KAAK,eAAe,GAAG,cAAc;AACrC,WAAW,YAAY;AACvB;AACA,mBAAmB,MAAM;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA,aAAa,YAAY;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC;AACA;AACA;AACA,KAAK,yBAAyB,GAAG,cAAc;AAC/C,WAAW,YAAY;AACvB;AACA;AACA;AACA,KAAK,sBAAsB,GAAG,cAAc;AAC5C,WAAW,YAAY;AACvB;AACA;AACA;AACA;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,KAAK,mBAAmB,GAAG,YAAY;AACvC;AACA;AACA,KAAK,qBAAqB,GAAG,cAAc;AAC3C,aAAa,cAAc;AAC3B,aAAa,mBAAmB;AAChC;AACA,KAAK,2BAA2B,GAAG,cAAc;AACjD,aAAa,cAAc;AAC3B;AACA,aAAa,mBAAmB;AAChC;AACA,KAAK,kBAAkB;AACvB;AACA;AACA;AACA,KAAK,WAAW;AAChB,aAAa,YAAY;AACzB;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,gBAAgB,GAAG,cAAc,iBAAiB,MAAM;AAC7D,KAAK,YAAY,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,2BAA2B,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,GAAG,gBAAgB;AACrZ,KAAK,gBAAgB,GAAG,YAAY;AACpC,cAAc,wBAAwB,SAAS,KAAK;AACpD;AACA;AACA,KAAK,cAAc;AACnB;AACA,aAAa,OAAO,GAAG,MAAM,0CAA0C,QAAQ;AAC/E;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA,cAAc,aAAa,YAAY,OAAO,GAAG,cAAc,wCAAwC,oBAAoB,KAAK,OAAO,CAAC,YAAY;AACpJ,KAAK,qBAAqB;AAC1B;AACA,qBAAqB,YAAY;AACjC;AACA;AACA;AACA;AACA,cAAc,oBAAoB,mCAAmC,qBAAqB,eAAe,OAAO,KAAK,OAAO,CAAC,QAAQ","names":[]}

package/dist/webhooks.d.ts

@@ -17,6 +17,10 @@ type WebhookEventOf<TType extends string, TData> = {
 type EntryPublishedEvent = WebhookEventOf<'entry.published', {
     entry: WebhookEntry;
 }>;
+type BlockPublishedEvent = WebhookEventOf<'block.published', {
+    entry: WebhookEntry;
+    entries: WebhookEntry[];
+}>;
 type EntryUnpublishedEvent = WebhookEventOf<'entry.unpublished', {
     entry: WebhookEntry;
 }>;
@@ -56,6 +60,22 @@ type EntryReviewClosedEvent = WebhookEventOf<'entry.review_closed', {
     revision: number;
     reason?: string;
 }>;
+type WebhookRelease = {
+    id: string;
+    name: string;
+};
+type WebhookReleaseEntry = WebhookEntry & {
+    action: 'publish' | 'unpublish';
+};
+type ReleasePublishedEvent = WebhookEventOf<'release.published', {
+    release: WebhookRelease;
+    entries: WebhookReleaseEntry[];
+}>;
+type ReleaseReviewRequestedEvent = WebhookEventOf<'release.review_requested', {
+    release: WebhookRelease;
+    note: string | null;
+    entries: WebhookReleaseEntry[];
+}>;
 type WebhookShopifyItem = {
     id: string;
     handle: string | null;
@@ -79,7 +99,7 @@ type CollectionDeletedEvent = WebhookEventOf<'collection.deleted', StoreChange &
     collection: WebhookShopifyItem;
 }>;
 type WebhookTestEvent = WebhookEventOf<'webhook.test', Record<string, never>>;
-type WebhookEvent = EntryPublishedEvent | EntryUnpublishedEvent | EntryDeletedEvent | EntryMovedEvent | AssetUpdatedEvent | ModelChangedEvent | LocalesChangedEvent | EntryReviewRequestedEvent | EntryReviewClosedEvent | ProductUpdatedEvent | ProductDeletedEvent | CollectionUpdatedEvent | CollectionDeletedEvent | WebhookTestEvent;
+type WebhookEvent = EntryPublishedEvent | BlockPublishedEvent | EntryUnpublishedEvent | EntryDeletedEvent | EntryMovedEvent | AssetUpdatedEvent | ModelChangedEvent | LocalesChangedEvent | EntryReviewRequestedEvent | EntryReviewClosedEvent | ReleasePublishedEvent | ReleaseReviewRequestedEvent | ProductUpdatedEvent | ProductDeletedEvent | CollectionUpdatedEvent | CollectionDeletedEvent | WebhookTestEvent;
 type WebhookEventType = WebhookEvent['type'];
 declare class WebhookVerificationError extends Error {
     constructor(message: string);
@@ -103,5 +123,5 @@ type WebhookHandlerOptions = {
 declare const createWebhookHandler: ({ secret, onEvent, tolerance }: WebhookHandlerOptions) => (request: Request) => Promise<Response>;
 
 export { WebhookVerificationError, createWebhookHandler, verifyWebhook };
-export type { AssetUpdatedEvent, CollectionDeletedEvent, CollectionUpdatedEvent, EntryDeletedEvent, EntryMovedEvent, EntryPublishedEvent, EntryReviewClosedEvent, EntryReviewRequestedEvent, EntryUnpublishedEvent, LocalesChangedEvent, ModelChangedEvent, ProductDeletedEvent, ProductUpdatedEvent, VerifyWebhookOptions, WebhookEntry, WebhookEvent, WebhookEventType, WebhookHandlerOptions, WebhookMessage, WebhookShopifyItem, WebhookTestEvent };
+export type { AssetUpdatedEvent, BlockPublishedEvent, CollectionDeletedEvent, CollectionUpdatedEvent, EntryDeletedEvent, EntryMovedEvent, EntryPublishedEvent, EntryReviewClosedEvent, EntryReviewRequestedEvent, EntryUnpublishedEvent, LocalesChangedEvent, ModelChangedEvent, ProductDeletedEvent, ProductUpdatedEvent, ReleasePublishedEvent, ReleaseReviewRequestedEvent, VerifyWebhookOptions, WebhookEntry, WebhookEvent, WebhookEventType, WebhookHandlerOptions, WebhookMessage, WebhookRelease, WebhookReleaseEntry, WebhookShopifyItem, WebhookTestEvent };
 //# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sources":["../src/webhooks.ts"],"mappings":";;AACA,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA,WAAW,MAAM;AACjB;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,iBAAiB,WAAW;AAC5B;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC,WAAW,YAAY;AACvB;AACA,KAAK,qBAAqB,GAAG,cAAc;AAC3C,WAAW,YAAY;AACvB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC,WAAW,YAAY;AACvB;AACA,KAAK,eAAe,GAAG,cAAc;AACrC,WAAW,YAAY;AACvB;AACA,mBAAmB,MAAM;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA,aAAa,YAAY;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC;AACA;AACA;AACA,KAAK,yBAAyB,GAAG,cAAc;AAC/C,WAAW,YAAY;AACvB;AACA;AACA;AACA,KAAK,sBAAsB,GAAG,cAAc;AAC5C,WAAW,YAAY;AACvB;AACA;AACA;AACA;AACA,KAAK,kBAAkB;AACvB;AACA;AACA;AACA,KAAK,WAAW;AAChB,aAAa,YAAY;AACzB;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,gBAAgB,GAAG,cAAc,iBAAiB,MAAM;AAC7D,KAAK,YAAY,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,GAAG,gBAAgB;AACzU,KAAK,gBAAgB,GAAG,YAAY;AACpC,cAAc,wBAAwB,SAAS,KAAK;AACpD;AACA;AACA,KAAK,cAAc;AACnB;AACA,aAAa,OAAO,GAAG,MAAM,0CAA0C,QAAQ;AAC/E;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA,cAAc,aAAa,YAAY,OAAO,GAAG,cAAc,wCAAwC,oBAAoB,KAAK,OAAO,CAAC,YAAY;AACpJ,KAAK,qBAAqB;AAC1B;AACA,qBAAqB,YAAY;AACjC;AACA;AACA;AACA;AACA,cAAc,oBAAoB,mCAAmC,qBAAqB,eAAe,OAAO,KAAK,OAAO,CAAC,QAAQ","names":[]}
+{"version":3,"file":"webhooks.d.ts","sources":["../src/webhooks.ts"],"mappings":";;AACA,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA,WAAW,MAAM;AACjB;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,iBAAiB,WAAW;AAC5B;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC,WAAW,YAAY;AACvB;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC,WAAW,YAAY;AACvB,aAAa,YAAY;AACzB;AACA,KAAK,qBAAqB,GAAG,cAAc;AAC3C,WAAW,YAAY;AACvB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC,WAAW,YAAY;AACvB;AACA,KAAK,eAAe,GAAG,cAAc;AACrC,WAAW,YAAY;AACvB;AACA,mBAAmB,MAAM;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA,aAAa,YAAY;AACzB;AACA,KAAK,iBAAiB,GAAG,cAAc;AACvC;AACA;AACA;AACA;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc;AACzC;AACA;AACA;AACA,KAAK,yBAAyB,GAAG,cAAc;AAC/C,WAAW,YAAY;AACvB;AACA;AACA;AACA,KAAK,sBAAsB,GAAG,cAAc;AAC5C,WAAW,YAAY;AACvB;AACA;AACA;AACA;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA,KAAK,mBAAmB,GAAG,YAAY;AACvC;AACA;AACA,KAAK,qBAAqB,GAAG,cAAc;AAC3C,aAAa,cAAc;AAC3B,aAAa,mBAAmB;AAChC;AACA,KAAK,2BAA2B,GAAG,cAAc;AACjD,aAAa,cAAc;AAC3B;AACA,aAAa,mBAAmB;AAChC;AACA,KAAK,kBAAkB;AACvB;AACA;AACA;AACA,KAAK,WAAW;AAChB,aAAa,YAAY;AACzB;AACA;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,mBAAmB,GAAG,cAAc,oBAAoB,WAAW;AACxE,aAAa,kBAAkB;AAC/B,iBAAiB,kBAAkB;AACnC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,sBAAsB,GAAG,cAAc,uBAAuB,WAAW;AAC9E,gBAAgB,kBAAkB;AAClC;AACA,KAAK,gBAAgB,GAAG,cAAc,iBAAiB,MAAM;AAC7D,KAAK,YAAY,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,2BAA2B,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,GAAG,gBAAgB;AACrZ,KAAK,gBAAgB,GAAG,YAAY;AACpC,cAAc,wBAAwB,SAAS,KAAK;AACpD;AACA;AACA,KAAK,cAAc;AACnB;AACA,aAAa,OAAO,GAAG,MAAM,0CAA0C,QAAQ;AAC/E;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA,cAAc,aAAa,YAAY,OAAO,GAAG,cAAc,wCAAwC,oBAAoB,KAAK,OAAO,CAAC,YAAY;AACpJ,KAAK,qBAAqB;AAC1B;AACA,qBAAqB,YAAY;AACjC;AACA;AACA;AACA;AACA,cAAc,oBAAoB,mCAAmC,qBAAqB,eAAe,OAAO,KAAK,OAAO,CAAC,QAAQ","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.28.4",
+	"version": "0.30.0",
 	"keywords": [
 		"cms",
 		"headless-cms",

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

@@ -1 +0,0 @@
-{"version":3,"file":"types-b6jbj3g6.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,eAAe,YAAY;AAC3B;AACA,KAAK,YAAY;AACjB;AACA;AACA;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;AACA,gBAAgB,WAAW;AAC3B,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;AACA,iBAAiB,MAAM;AACvB;AACA,WAAW,cAAc;AACzB;AACA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA,KAAK,UAAU;AACf;AACA;AACA;AACA;AACA,KAAK,iBAAiB;AACtB,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;AACA,KAAK,SAAS,GAAG,eAAe;AAChC,KAAK,qBAAqB;AAC1B;AACA;AACA,UAAU,eAAe;AACzB;AACA;AACA,aAAa,iBAAiB;AAC9B;AACA,aAAa,UAAU;AACvB,YAAY,eAAe;AAC3B;AACA,KAAK,SAAS;AACd;AACA;AACA,kBAAkB,qBAAqB;AACvC;;","names":[]}