@picked/client 0.0.1-dev.1786001783467 → 0.0.1-dev.1786065500148

package/dist/esm/plugins/dynamic-experiences/index.js

@@ -1,3 +1,3 @@
-import { i as e } from "../../../api-i7XfDMTd.js";
-import { a as t, c as n, i as r, l as i, o as a, r as o, s, t as c } from "../../../plugin-Cbhl3kSg.js";
-export { e as createClientHeaders, o as createPickedDataProvider, c as dynamicExperiencesPlugin, n as fetchExperienceContent, i as fetchProject, a as getRegisteredBundle, r as isVirtualPickedData, s as registerPickedBundle, t as resolveVirtualDataModule };
+import { a as e, c as t, i as n, n as r } from "../../../registry-BYtEBdL1.js";
+import { t as i } from "../../../plugin-YytfMG0n.js";
+export { t as createClientHeaders, i as dynamicExperiencesPlugin, n as fetchExperienceContent, e as fetchProject, r as registerPickedBundle };

package/dist/esm/server/index.js

@@ -1,44 +1,41 @@
 import { a as e, c as t, i as n, o as r, s as i, t as a, u as o } from "../../experience-instance-DGk11d8a.js";
-import { c as s, n as c } from "../../plugin-Cbhl3kSg.js";
-import { attach as l, createEffect as u, createEvent as d, createStore as f, sample as p } from "effector";
+import { n as s } from "../../plugin-YytfMG0n.js";
+import { attach as c, createEffect as l, createEvent as u, createStore as d, sample as f } from "effector";
 //#region src/server/serialize.ts
-var m = 1e4;
-function h(e) {
+var p = 1e4;
+function m(e) {
 	if (e?.location !== void 0) return { location: e.location };
 }
-function g(e, t) {
+function h(e, t) {
 	return e.nodes.filter(o).some((e) => t.get(e.stepId) === !0);
 }
-async function _(e, n) {
-	let { projectConfig: i } = n, a = e.session.store.getState().id;
-	e.conditionResults.reset(), c(e, i, {
+async function g(e, n = {}) {
+	let i = n.previewToken === void 0 ? void 0 : { previewToken: n.previewToken }, a = await e.getProjectConfig(i), o = e.session.store.getState().id;
+	e.conditionResults.reset(), s(e, a, {
 		isPreview: !1,
-		sessionId: a
+		sessionId: o
 	});
-	let o = h(n.attributes), l = n.timeoutMs ?? m, u = new Map(i.steps.map((e) => [e.id, e.layoutContentId !== void 0 && e.layoutContentId !== null])), d = Object.fromEntries(i.conditions.map((e) => [e.key, e])), f = i.experiences.filter((e) => !t(e.condition, d)), p = (await Promise.all(f.map(async (t) => ({
+	let c = m(n.attributes), l = n.timeoutMs ?? p, u = new Map(a.steps.map((e) => [e.id, e.layoutContentId !== void 0 && e.layoutContentId !== null])), d = Object.fromEntries(a.conditions.map((e) => [e.key, e])), f = a.experiences.filter((e) => !t(e.condition, d)), g = (await Promise.all(f.map(async (t) => ({
 		experience: t,
-		active: await r(e, { condition: t.condition }, { context: o })
-	})))).filter((e) => e.active).map((e) => e.experience), _ = await Promise.all(p.filter((e) => g(e, u)).map((t) => n.dataProvider ? n.dataProvider.getContent({
+		active: await r(e, { condition: t.condition }, { context: c })
+	})))).filter((e) => e.active).map((e) => e.experience), _ = await Promise.all(g.filter((e) => h(e, u)).map((t) => e.getExperienceContent({
 		id: t.id,
 		key: t.key
-	}) : n.getContent ? n.getContent({
-		id: t.id,
-		key: t.key
-	}, { previewToken: n.previewToken }) : s(e.apiUrl, e.projectId, t.id, {
-		previewToken: n.previewToken,
+	}, {
+		...i,
 		signal: AbortSignal.timeout(l)
 	}))), v = /* @__PURE__ */ new Map();
 	for (let e of _) if (e) for (let t of e.content) v.set(t.id, t);
 	return {
-		versionId: i.versionId,
-		projectConfig: i,
+		versionId: a.versionId,
+		projectConfig: a,
 		content: Array.from(v.values()),
 		conditionResults: e.conditionResults.store.getState()
 	};
 }
 //#endregion
 //#region src/server/index.ts
-function v() {
+function _() {
 	let e, t;
 	return {
 		promise: new Promise((n, r) => {
@@ -48,16 +45,16 @@ function v() {
 		reject: (e) => t(e)
 	};
 }
-function y(e, t) {
-	let { promise: n, resolve: r } = v(), i = d(), o = d(), s = d(), c = d(), m = d(), h = e.experiences.listStore.map((t) => t.map((t) => a({
+function v(e, t) {
+	let { promise: n, resolve: r } = _(), i = u(), o = u(), s = u(), p = u(), m = u(), h = e.experiences.listStore.map((t) => t.map((t) => a({
 		client: e,
 		experience: t
-	}))), g = f({
+	}))), g = d({
 		currentExperienceIndex: 0,
 		renderedExperiences: [],
 		isComplete: !1
-	}), _ = u(async (t) => {
-		let n = l({
+	}), v = l(async (t) => {
+		let n = c({
 			source: t.experience.componentStore,
 			effect: async (n, r) => {
 				let i = t.availableRenderers[r];
@@ -72,7 +69,7 @@ function y(e, t) {
 			if (t) return t;
 		}
 		return null;
-	}), y = u(async ({ experience: e, availableRenderers: t, startRendererIndex: n = 0 }) => e ? _({
+	}), y = l(async ({ experience: e, availableRenderers: t, startRendererIndex: n = 0 }) => e ? v({
 		experience: e,
 		availableRenderers: t,
 		startRendererIndex: n
@@ -84,13 +81,13 @@ function y(e, t) {
 	})).on(m, (e) => ({
 		...e,
 		currentExperienceIndex: e.currentExperienceIndex + 1
-	})).on(c, (e) => ({
+	})).on(p, (e) => ({
 		...e,
 		isComplete: !0
-	})).reset(i), p({
+	})).reset(i), f({
 		clock: i,
 		target: o
-	}), p({
+	}), f({
 		clock: o,
 		source: {
 			experiences: h,
@@ -103,22 +100,22 @@ function y(e, t) {
 			startRendererIndex: 0
 		}),
 		target: y
-	}), p({
+	}), f({
 		clock: y.doneData,
 		filter: (e) => e !== null,
 		fn: (e) => e.rendered.body,
 		target: s
-	}), p({
+	}), f({
 		clock: s,
 		target: o
-	}), p({
+	}), f({
 		clock: y.doneData,
 		filter: (e) => e === null,
 		target: m
-	}), p({
+	}), f({
 		clock: m,
 		target: o
-	}), p({
+	}), f({
 		clock: [
 			o,
 			m,
@@ -129,18 +126,18 @@ function y(e, t) {
 			state: g
 		},
 		filter: ({ experiences: e, state: t }) => t.currentExperienceIndex >= e.length,
-		target: c
+		target: p
 	});
-	let b = l({
+	let b = c({
 		source: g,
 		effect: (e) => {
 			e.isComplete && r(e.renderedExperiences);
 		}
 	});
-	return p({
-		clock: c,
+	return f({
+		clock: p,
 		target: b
 	}), i(), n;
 }
 //#endregion
-export { a as createExperienceInstance, n as evaluateConditionMemo, e as hashRule, r as isExperienceActive, c as registerProjectConfig, y as render, i as ruleReferencesAction, t as ruleReferencesActionDeep, _ as serialize };
+export { a as createExperienceInstance, n as evaluateConditionMemo, e as hashRule, r as isExperienceActive, s as registerProjectConfig, v as render, i as ruleReferencesAction, t as ruleReferencesActionDeep, g as serialize };

package/dist/plugin-EFn9ALEF.cjs

@@ -0,0 +1 @@
+require("./logger-CSTvAyyB.cjs");let e=require("effector");function t(e){let t=2166136261;for(let n of e)t^=n.codePointAt(0)??0,t=Math.imul(t,16777619);return t>>>0}function n(e){let t=e;return t^=t>>>16,t=Math.imul(t,2246822507),t^=t>>>13,t=Math.imul(t,3266489909),t^=t>>>16,t>>>0}function r(e,r){return n(t(`${e}:${r}`))%100}function i(e,t){return t<=0?!1:t>=100||e<t}function a(e,t){if(Array.isArray(t.conditions))for(let n of t.conditions)e.registerCondition(n)}function o(e,t){e.registerExperience({id:t.id,key:t.key,name:t.name,targets:t.targets,nodes:t.nodes,edges:t.edges,condition:t.condition,initializeOpen:t.initializeOpen,componentName:t.componentName})}function s(e,t){if(Array.isArray(t.fields))for(let n of t.fields)e.registerField(n)}function c(e,t){if(!Array.isArray(t.steps))return;let n=new Map(t.fields.map(e=>[e.id,e.key]));for(let r of t.steps){let t=[];for(let e of r.fieldIds??[]){let i=n.get(e);if(i===void 0){`${r.key}${e}`;continue}t.push(i)}let i=r.layoutContentId?e.contents.getById(r.layoutContentId):null;e.registerStep({id:r.id,key:r.key,name:r.name,fieldKeys:t,layoutName:r.layoutName,...r.layoutContentId!==void 0&&{layoutContentId:r.layoutContentId,layoutContentStore:i}})}}function l(e,t){if(Array.isArray(t.experiences))for(let n of t.experiences)o(e,n)}function u(e,t,n){p(e,t,n.isPreview,n.sessionId),a(e,t),s(e,t),c(e,t),l(e,t)}function d(e){let t=e.searchParams[`preview-token`];if(t&&t.length>0)return t[0]}function f(e){let t=new Set,n=e.searchParams.feature;if(!n)return t;for(let e of n){let n=e.indexOf(`:`);n>0&&t.add(e.substring(0,n))}return t}function p(e,t,n,r){let i=f(e);for(let a of t.features)i.has(a.id)||m(e,a,n,r)}function m(e,t,n,a){let o=r(a,t.id);e.registerFeature(t.id,{key:`v${t.version}`,name:t.name,enabled:t.enabled,weight:t.weight,storage:n?`session`:`local`,decide:()=>i(o,t.weight)})}function h(e,t){for(let n of t.content)e.registerContent({id:n.id,contentModelKey:n.contentModelKey,data:n.data})}function g(e,t){let n=new Map;return(r,i)=>{let a=n.get(r.id);if(a)return a;let o=(async()=>{try{let n=await t(r,i);return n&&h(e,n),n}finally{n.delete(r.id)}})();return n.set(r.id,o),o}}function _(e,t){let n=new Set(t&&Array.isArray(t.experiences)?t.experiences.map(e=>e.id):[]);return(t,r)=>n.has(t.id)?e(t,r):Promise.resolve(null)}function v(){return{name:`dynamic-experiences`,setup:t=>({onStart:(0,e.attach)({source:t.session.store.map(e=>e.id),effect:async e=>{let n=d(t),r=n!==void 0,i=n===void 0?void 0:{previewToken:n},a=await t.getProjectConfig(n===void 0?void 0:{previewToken:n}).catch(e=>null);if(t.contentLoader=g(t,_(e=>t.getExperienceContent(e,i),a)),!a)return;let o=t.seededVersionId;if(o!==null&&o!==a.versionId){t.versionSkew={seeded:o,resolved:a.versionId},`${a.versionId}${o}`;return}t.previewEmbedderOrigins=a.previewEmbedderOrigins??null,u(t,a,{isPreview:r,sessionId:e})}})})}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return v}});

package/dist/plugin-YytfMG0n.js

@@ -0,0 +1,153 @@
+import "./logger-DMN6TxJJ.js";
+import { attach as e } from "effector";
+//#region src/plugins/dynamic-experiences/hash.ts
+function t(e) {
+	let t = 2166136261;
+	for (let n of e) t ^= n.codePointAt(0) ?? 0, t = Math.imul(t, 16777619);
+	return t >>> 0;
+}
+function n(e) {
+	let t = e;
+	return t ^= t >>> 16, t = Math.imul(t, 2246822507), t ^= t >>> 13, t = Math.imul(t, 3266489909), t ^= t >>> 16, t >>> 0;
+}
+function r(e, r) {
+	return n(t(`${e}:${r}`)) % 100;
+}
+function i(e, t) {
+	return t <= 0 ? !1 : t >= 100 || e < t;
+}
+//#endregion
+//#region src/plugins/dynamic-experiences/plugin.ts
+function a(e, t) {
+	if (Array.isArray(t.conditions)) for (let n of t.conditions) e.registerCondition(n);
+}
+function o(e, t) {
+	e.registerExperience({
+		id: t.id,
+		key: t.key,
+		name: t.name,
+		targets: t.targets,
+		nodes: t.nodes,
+		edges: t.edges,
+		condition: t.condition,
+		initializeOpen: t.initializeOpen,
+		componentName: t.componentName
+	});
+}
+function s(e, t) {
+	if (Array.isArray(t.fields)) for (let n of t.fields) e.registerField(n);
+}
+function c(e, t) {
+	if (!Array.isArray(t.steps)) return;
+	let n = new Map(t.fields.map((e) => [e.id, e.key]));
+	for (let r of t.steps) {
+		let t = [];
+		for (let e of r.fieldIds ?? []) {
+			let i = n.get(e);
+			if (i === void 0) {
+				`${r.key}${e}`;
+				continue;
+			}
+			t.push(i);
+		}
+		let i = r.layoutContentId ? e.contents.getById(r.layoutContentId) : null;
+		e.registerStep({
+			id: r.id,
+			key: r.key,
+			name: r.name,
+			fieldKeys: t,
+			layoutName: r.layoutName,
+			...r.layoutContentId !== void 0 && {
+				layoutContentId: r.layoutContentId,
+				layoutContentStore: i
+			}
+		});
+	}
+}
+function l(e, t) {
+	if (Array.isArray(t.experiences)) for (let n of t.experiences) o(e, n);
+}
+function u(e, t, n) {
+	p(e, t, n.isPreview, n.sessionId), a(e, t), s(e, t), c(e, t), l(e, t);
+}
+function d(e) {
+	let t = e.searchParams["preview-token"];
+	if (t && t.length > 0) return t[0];
+}
+function f(e) {
+	let t = /* @__PURE__ */ new Set(), n = e.searchParams.feature;
+	if (!n) return t;
+	for (let e of n) {
+		let n = e.indexOf(":");
+		n > 0 && t.add(e.substring(0, n));
+	}
+	return t;
+}
+function p(e, t, n, r) {
+	let i = f(e);
+	for (let a of t.features) i.has(a.id) || m(e, a, n, r);
+}
+function m(e, t, n, a) {
+	let o = r(a, t.id);
+	e.registerFeature(t.id, {
+		key: `v${t.version}`,
+		name: t.name,
+		enabled: t.enabled,
+		weight: t.weight,
+		storage: n ? "session" : "local",
+		decide: () => i(o, t.weight)
+	});
+}
+function h(e, t) {
+	for (let n of t.content) e.registerContent({
+		id: n.id,
+		contentModelKey: n.contentModelKey,
+		data: n.data
+	});
+}
+function g(e, t) {
+	let n = /* @__PURE__ */ new Map();
+	return (r, i) => {
+		let a = n.get(r.id);
+		if (a) return a;
+		let o = (async () => {
+			try {
+				let n = await t(r, i);
+				return n && h(e, n), n;
+			} finally {
+				n.delete(r.id);
+			}
+		})();
+		return n.set(r.id, o), o;
+	};
+}
+function _(e, t) {
+	let n = new Set(t && Array.isArray(t.experiences) ? t.experiences.map((e) => e.id) : []);
+	return (t, r) => n.has(t.id) ? e(t, r) : Promise.resolve(null);
+}
+function v() {
+	return {
+		name: "dynamic-experiences",
+		setup: (t) => ({ onStart: e({
+			source: t.session.store.map((e) => e.id),
+			effect: async (e) => {
+				let n = d(t), r = n !== void 0, i = n === void 0 ? void 0 : { previewToken: n }, a = await t.getProjectConfig(n === void 0 ? void 0 : { previewToken: n }).catch((e) => null);
+				if (t.contentLoader = g(t, _((e) => t.getExperienceContent(e, i), a)), !a) return;
+				let o = t.seededVersionId;
+				if (o !== null && o !== a.versionId) {
+					t.versionSkew = {
+						seeded: o,
+						resolved: a.versionId
+					}, `${a.versionId}${o}`;
+					return;
+				}
+				t.previewEmbedderOrigins = a.previewEmbedderOrigins ?? null, u(t, a, {
+					isPreview: r,
+					sessionId: e
+				});
+			}
+		}) })
+	};
+}
+//#endregion
+export { u as n, v as t };

package/dist/registry-BYtEBdL1.js

@@ -0,0 +1,111 @@
+import "./logger-DMN6TxJJ.js";
+//#region src/utils/client-headers.ts
+var e = "Picked-Client", t = "Picked-Version";
+function n(n, r) {
+	return {
+		[e]: n,
+		[t]: r
+	};
+}
+//#endregion
+//#region src/utils/version.ts
+var r = () => "0.0.1-dev.1786065500148", i = "v1";
+function a(e, t) {
+	return new URL(`/api/${i}/${t}`, e).toString();
+}
+function o(e) {
+	return {
+		...n("sdk", r()),
+		...e
+	};
+}
+async function s(e, t, n, r) {
+	let i = a(e, t);
+	return fetch(i, {
+		headers: o(n),
+		signal: r
+	});
+}
+async function c(e, t, n, r) {
+	let i = a(e, t);
+	return fetch(i, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...o(r)
+		},
+		body: JSON.stringify(n)
+	});
+}
+function l(e) {
+	return typeof e == "object" && !!e;
+}
+function u(e) {
+	return l(e) && "features" in e && Array.isArray(e.features);
+}
+function d(e) {
+	return !l(e) || !("experienceId" in e) || !("content" in e) ? !1 : Array.isArray(e.content);
+}
+function f(e) {
+	try {
+		let t = new URL(e).hostname;
+		return t === "localhost" || t === "127.0.0.1" || t === "::1";
+	} catch {
+		return !1;
+	}
+}
+function p(e) {
+	if (!l(e) || !("cause" in e)) return !1;
+	let { cause: t } = e;
+	return !l(t) || !("code" in t) ? !1 : t.code === "ECONNREFUSED";
+}
+async function m(e, t, n) {
+	let r = n?.previewToken ? `projects/${t}?preview_token=${encodeURIComponent(n.previewToken)}` : `projects/${t}`, i;
+	try {
+		i = await s(e, r, n?.headers, n?.signal);
+	} catch (t) {
+		return f(e) && p(t), null;
+	}
+	if (!i.ok) return `${i.status.toString()}`, null;
+	let a;
+	try {
+		a = await i.json();
+	} catch {
+		return null;
+	}
+	return u(a) ? a : null;
+}
+async function h(e, t, n, r) {
+	let i = r?.previewToken ? `projects/${t}/experiences/${n}/content?preview_token=${encodeURIComponent(r.previewToken)}` : `projects/${t}/experiences/${n}/content`, a;
+	try {
+		a = await s(e, i, r?.headers, r?.signal);
+	} catch (t) {
+		return f(e) && p(t) || `${n}`, null;
+	}
+	if (!a.ok) return `${n}${a.status.toString()}`, null;
+	let o;
+	try {
+		o = await a.json();
+	} catch {
+		return `${n}`, null;
+	}
+	return d(o) ? o : (`${n}`, null);
+}
+//#endregion
+//#region src/data-source/virtual-data.ts
+function g(e) {
+	if (typeof e != "object" || !e || !("projectConfig" in e) || !("experienceContent" in e) || !("manifestMetadata" in e)) return !1;
+	let { experienceContent: t } = e;
+	return typeof t == "function";
+}
+//#endregion
+//#region src/data-source/registry.ts
+var _ = null;
+function v(e) {
+	g(e) && (_ = e);
+}
+function y() {
+	return _;
+}
+//#endregion
+export { m as a, n as c, h as i, v as n, c as o, g as r, r as s, y as t };

package/dist/registry-DtmKJre-.cjs

@@ -0,0 +1 @@
+require("./logger-CSTvAyyB.cjs");var e=`Picked-Client`,t=`Picked-Version`;function n(n,r){return{[e]:n,[t]:r}}var r=()=>`0.0.1-dev.1786065500148`,i=`v1`;function a(e,t){return new URL(`/api/${i}/${t}`,e).toString()}function o(e){return{...n(`sdk`,r()),...e}}async function s(e,t,n,r){let i=a(e,t);return fetch(i,{headers:o(n),signal:r})}async function c(e,t,n,r){let i=a(e,t);return fetch(i,{method:`POST`,headers:{"Content-Type":`application/json`,...o(r)},body:JSON.stringify(n)})}function l(e){return typeof e==`object`&&!!e}function u(e){return l(e)&&`features`in e&&Array.isArray(e.features)}function d(e){return!l(e)||!(`experienceId`in e)||!(`content`in e)?!1:Array.isArray(e.content)}function f(e){try{let t=new URL(e).hostname;return t===`localhost`||t===`127.0.0.1`||t===`::1`}catch{return!1}}function p(e){if(!l(e)||!(`cause`in e))return!1;let{cause:t}=e;return!l(t)||!(`code`in t)?!1:t.code===`ECONNREFUSED`}async function m(e,t,n){let r=n?.previewToken?`projects/${t}?preview_token=${encodeURIComponent(n.previewToken)}`:`projects/${t}`,i;try{i=await s(e,r,n?.headers,n?.signal)}catch(t){return f(e)&&p(t),null}if(!i.ok)return`${i.status.toString()}`,null;let a;try{a=await i.json()}catch{return null}return u(a)?a:null}async function h(e,t,n,r){let i=r?.previewToken?`projects/${t}/experiences/${n}/content?preview_token=${encodeURIComponent(r.previewToken)}`:`projects/${t}/experiences/${n}/content`,a;try{a=await s(e,i,r?.headers,r?.signal)}catch(t){return f(e)&&p(t)||`${n}`,null}if(!a.ok)return`${n}${a.status.toString()}`,null;let o;try{o=await a.json()}catch{return`${n}`,null}return d(o)?o:(`${n}`,null)}function g(e){if(typeof e!=`object`||!e||!(`projectConfig`in e)||!(`experienceContent`in e)||!(`manifestMetadata`in e))return!1;let{experienceContent:t}=e;return typeof t==`function`}var _=null;function v(e){g(e)&&(_=e)}function y(){return _}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return y}});

package/dist/types/data-source/provider.d.ts

@@ -1,18 +1,31 @@
 import type { ContentLoader, ExperienceContentResponse, PickedManifestMetadata, ProjectConfig, VirtualPickedData } from '../plugins/dynamic-experiences/types';
+import { isVirtualPickedData } from './virtual-data';
 /** Where a data provider reads project config and CMS content from. */
 export type PickedDataMode = 'bundle' | 'api';
 /** Options for {@link createPickedDataProvider}. */
 export interface PickedDataProviderOptions {
-    /** Base URL for the Picked API. Read from whenever no bundle is available. */
+    /** Base URL for the Picked API. Used by `'api'` mode and by every preview session. */
     apiUrl: string;
     /** Project ID to resolve data for. */
     projectId: string;
     /**
-     * Preview token from the current session. A present token forces the API for both config
-     * and content and overrides `projectConfig`, because preview renders unpublished data that
-     * no bundled snapshot can contain.
+     * Which source to read from. Omit to keep the legacy behaviour: `'bundle'` when
+     * `virtual:picked/data` resolves, `'api'` otherwise.
+     */
+    mode?: PickedDataMode;
+    /**
+     * Preview token from the current session. A present token forces `'api'` for both config
+     * and content and overrides `bundle` and `projectConfig`, because preview renders
+     * unpublished data that no bundled snapshot can contain.
      */
     previewToken?: string;
+    /**
+     * The `virtual:picked/data` module. Supply it to skip the dynamic import — which is also
+     * how a consumer places the module in a chosen chunk, since a module that is both
+     * statically and dynamically imported is placed in the static chunk. A value that does not
+     * match the module's shape is ignored with a warning, the same as an unresolvable import.
+     */
+    bundle?: VirtualPickedData;
     /** Explicit project config. Supersedes both sources, except under a preview token. */
     projectConfig?: ProjectConfig;
     /** Explicit content loader. Supersedes both sources, except under a preview token. */
@@ -37,6 +50,8 @@ export interface PickedDataProvider {
     getContent: (experience: {
         id: string;
         key: string;
+    }, options?: {
+        signal?: AbortSignal;
     }) => Promise<ExperienceContentResponse | null>;
 }
 /**
@@ -60,17 +75,7 @@ export interface PickedDataProvider {
  * ```
  */
 export declare function resolveVirtualDataModule(): Promise<VirtualPickedData | null>;
-/**
- * Runtime type guard that validates the shape of an imported `virtual:picked/data` module.
- *
- * @param {unknown} value - Candidate module exports.
- * @returns {boolean} Whether `value` matches the {@link VirtualPickedData} shape.
- * @example
- * ```typescript
- * if (isVirtualPickedData(mod)) { useVirtualModule(mod) }
- * ```
- */
-export declare function isVirtualPickedData(value: unknown): value is VirtualPickedData;
+export { isVirtualPickedData };
 /**
  * Creates the data provider for a session.
  *
@@ -78,7 +83,7 @@ export declare function isVirtualPickedData(value: unknown): value is VirtualPic
  * @returns {PickedDataProvider} A provider resolving config and content from one source.
  * @example
  * ```typescript
- * const provider = createPickedDataProvider({ apiUrl, projectId })
+ * const provider = createPickedDataProvider({ mode: 'api', apiUrl, projectId })
  * const config = await provider.getProjectConfig()
  * ```
  */

package/dist/types/data-source/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/data-source/provider.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EAClB,MAAM,sCAAsC,CAAA;AAI7C,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,CAAA;AAQ7C,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sFAAsF;IACtF,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,sFAAsF;IACtF,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,IAAI,EAAE,cAAc,CAAA;IACpB,gFAAgF;IAChF,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;CACxC;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;IACrC,4FAA4F;IAC5F,gBAAgB,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACrD,oGAAoG;IACpG,UAAU,EAAE,CAAC,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CACnG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAYlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAU9E;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CA8J/F"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/data-source/provider.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EAClB,MAAM,sCAAsC,CAAA;AAG7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,CAAA;AAQ7C,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,sFAAsF;IACtF,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,sFAAsF;IACtF,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,IAAI,EAAE,cAAc,CAAA;IACpB,gFAAgF;IAChF,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;CACxC;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;IACrC,4FAA4F;IAC5F,gBAAgB,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACrD,oGAAoG;IACpG,UAAU,EAAE,CACV,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EACvC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC/B,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CAC/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAYlF;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAA;AA0B9B;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAwK/F"}

package/dist/types/data-source/registry.d.ts

@@ -1,36 +1,27 @@
-/**
- * @file The registry the generated `virtual:picked/data` module writes itself into.
- *
- * `@picked/vite-plugin-picked` emits a module whose last statement calls
- * `registerPickedBundle`. That call is a real side effect, so a bare
- * `import 'virtual:picked/data'` in a consumer's client entry survives tree-shaking and places
- * the data chunk in the static graph — which is what earns it a `modulepreload` from a
- * framework's own build manifest. The same call hands the bundle over synchronously, so
- * resolving project config costs no dynamic import.
- *
- * Import-time cost is a single binding declaration, which keeps the core module free of
- * import-time side effects.
- */
 import type { VirtualPickedData } from '../plugins/dynamic-experiences/types';
 /**
- * Records the bundle this page was built with, replacing any earlier registration.
+ * Records the bundle the build generated, for this session's data provider to read.
+ *
+ * A value that does not match the module shape is refused rather than stored, so a malformed
+ * registration lands on the already-defined "no bundle" path instead of an undefined read at
+ * the first content resolution. Any usable bundle registered earlier is kept.
  *
- * @param {VirtualPickedData} bundle - The `virtual:picked/data` module exports.
+ * @param {unknown} bundle - The generated module's exports.
  * @returns {void} Nothing.
  * @example
  * ```typescript
  * registerPickedBundle({ projectConfig, experienceContent, manifestMetadata })
  * ```
  */
-export declare function registerPickedBundle(bundle: VirtualPickedData): void;
+export declare function registerPickedBundle(bundle: unknown): void;
 /**
- * Reads the bundle a generated module registered.
+ * Reads the registered bundle.
  *
- * @returns {VirtualPickedData | undefined} The bundle, or `undefined` when none registered.
+ * @returns {VirtualPickedData | null} The bundle, or `null` when nothing has registered one.
  * @example
  * ```typescript
- * const bundle = getRegisteredBundle()
+ * const bundle = readRegisteredBundle()
  * ```
  */
-export declare function getRegisteredBundle(): VirtualPickedData | undefined;
+export declare function readRegisteredBundle(): VirtualPickedData | null;
 //# sourceMappingURL=registry.d.ts.map

package/dist/types/data-source/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/data-source/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAI7E;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,GAAG,SAAS,CAEnE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/data-source/registry.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAK7E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAQ1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D"}

package/dist/types/data-source/virtual-data.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file The shape guard for the generated `virtual:picked/data` module.
+ *
+ * Lives apart from the provider and the registry because both validate against it, and a guard
+ * shared by two modules that also reference each other would otherwise close an import cycle.
+ */
+import type { VirtualPickedData } from '../plugins/dynamic-experiences/types';
+/**
+ * Runtime type guard that validates the shape of a `virtual:picked/data` module.
+ *
+ * @param {unknown} value - Candidate module exports.
+ * @returns {boolean} Whether `value` matches the {@link VirtualPickedData} shape.
+ * @example
+ * ```typescript
+ * if (isVirtualPickedData(mod)) { useVirtualModule(mod) }
+ * ```
+ */
+export declare function isVirtualPickedData(value: unknown): value is VirtualPickedData;
+//# sourceMappingURL=virtual-data.d.ts.map

package/dist/types/data-source/virtual-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-data.d.ts","sourceRoot":"","sources":["../../../src/data-source/virtual-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAE7E;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAU9E"}