@picked/client 0.0.1-dev.1786072899095 → 0.0.1-dev.1786601464574

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

@@ -1,3 +1,5 @@
-import { i as e } from "../../../api-BzK4kXRt.js";
-import { n as t, r as n, t as r } from "../../../plugin-DJjtc5df.js";
-export { e as createClientHeaders, r as dynamicExperiencesPlugin, t as fetchExperienceContent, n as fetchProject };
+import { t as e } from "../../../plugin-C8hWW3ed.js";
+import { n as t, t as n } from "../../../api-C8B96Kwv.js";
+import { n as r } from "../../../registry-CXZv0uLg.js";
+import { createClientHeaders as i, fetchSchema as a } from "@picked/delivery-api-client";
+export { i as createClientHeaders, e as dynamicExperiencesPlugin, n as fetchExperienceContent, t as fetchProject, a as fetchSchema, 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 { i as s, n as c } from "../../plugin-DJjtc5df.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-C8hWW3ed.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, t) {
-	let { projectConfig: n } = t, i = e.session.store.getState().id;
-	e.conditionResults.reset(), s(e, n, {
+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: i
+		sessionId: o
 	});
-	let a = h(t.attributes), o = t.timeoutMs ?? m, l = new Map(n.steps.map((e) => [e.id, e.layoutContentId !== void 0 && e.layoutContentId !== null])), u = [];
-	for (let t of n.experiences) await r(e, { condition: t.condition }, { context: a }) && u.push(t);
-	let d = /* @__PURE__ */ new Map();
-	for (let n of u) {
-		if (!g(n, l)) continue;
-		let r = t.getContent ? await t.getContent({
-			id: n.id,
-			key: n.key
-		}, { previewToken: t.previewToken }) : await c(e.apiUrl, e.projectId, n.id, {
-			previewToken: t.previewToken,
-			signal: AbortSignal.timeout(o)
-		});
-		if (r) for (let e of r.content) d.set(e.id, e);
-	}
+	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: 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
+	}, {
+		...i,
+		signal: AbortSignal.timeout(l)
+	}))), v = /* @__PURE__ */ new Map();
+	for (let e of _) if (e) for (let t of [...e.references ?? [], ...e.content]) v.set(t.id, t);
 	return {
-		versionId: n.versionId,
-		projectConfig: n,
-		content: Array.from(d.values()),
+		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, s 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-C8hWW3ed.js

@@ -0,0 +1,157 @@
+import "./logger-DMN6TxJJ.js";
+import "./api-C8B96Kwv.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) {
+	return typeof e != "object" || !e ? !1 : "id" in e && "key" in e && "type" in e && "name" in e;
+}
+function c(e, t) {
+	if (Array.isArray(t.fields)) for (let n of t.fields) s(n) && e.registerField(n);
+}
+function l(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 u(e, t) {
+	if (Array.isArray(t.experiences)) for (let n of t.experiences) o(e, n);
+}
+function d(e, t, n) {
+	m(e, t, n.isPreview, n.sessionId), a(e, t), c(e, t), l(e, t), u(e, t);
+}
+function f(e) {
+	let t = e.searchParams["preview-token"];
+	if (t && t.length > 0) return t[0];
+}
+function p(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 m(e, t, n, r) {
+	let i = p(e);
+	for (let a of t.features) i.has(a.id) || h(e, a, n, r);
+}
+function h(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 g(e, t) {
+	for (let n of [...t.references ?? [], ...t.content]) e.registerContent({
+		id: n.id,
+		contentModelKey: n.contentModelKey,
+		data: n.data
+	});
+}
+function _(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 && g(e, n), n;
+			} finally {
+				n.delete(r.id);
+			}
+		})();
+		return n.set(r.id, o), o;
+	};
+}
+function v(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 y() {
+	return {
+		name: "dynamic-experiences",
+		setup: (t) => ({ onStart: e({
+			source: t.session.store.map((e) => e.id),
+			effect: async (e) => {
+				let n = f(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 = _(t, v((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, d(t, a, {
+					isPreview: r,
+					sessionId: e
+				});
+			}
+		}) })
+	};
+}
+//#endregion
+export { d as n, y as t };

package/dist/plugin-Dtg2sOad.cjs

@@ -0,0 +1 @@
+require("./logger-CSTvAyyB.cjs"),require("./api-DS7fA9kj.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){return typeof e!=`object`||!e?!1:`id`in e&&`key`in e&&`type`in e&&`name`in e}function c(e,t){if(Array.isArray(t.fields))for(let n of t.fields)s(n)&&e.registerField(n)}function l(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 u(e,t){if(Array.isArray(t.experiences))for(let n of t.experiences)o(e,n)}function d(e,t,n){m(e,t,n.isPreview,n.sessionId),a(e,t),c(e,t),l(e,t),u(e,t)}function f(e){let t=e.searchParams[`preview-token`];if(t&&t.length>0)return t[0]}function p(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 m(e,t,n,r){let i=p(e);for(let a of t.features)i.has(a.id)||h(e,a,n,r)}function h(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 g(e,t){for(let n of[...t.references??[],...t.content])e.registerContent({id:n.id,contentModelKey:n.contentModelKey,data:n.data})}function _(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&&g(e,n),n}finally{n.delete(r.id)}})();return n.set(r.id,o),o}}function v(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 y(){return{name:`dynamic-experiences`,setup:t=>({onStart:(0,e.attach)({source:t.session.store.map(e=>e.id),effect:async e=>{let n=f(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=_(t,v(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,d(t,a,{isPreview:r,sessionId:e})}})})}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return y}});

package/dist/provider-BEpRDCyr.js

@@ -0,0 +1,69 @@
+import "./logger-DMN6TxJJ.js";
+import { n as e, t } from "./api-C8B96Kwv.js";
+import { r as n, t as r } from "./registry-CXZv0uLg.js";
+//#region src/data-source/provider.ts
+var i = "bundle", a = "api";
+async function o() {
+	try {
+		let e = await import("virtual:picked/data");
+		return n(e) ? e : null;
+	} catch {
+		return null;
+	}
+}
+function s(e) {
+	if (e === void 0 || n(e)) return e;
+}
+function c(n) {
+	let { apiUrl: c, projectId: l, previewToken: u, signal: d } = n, f = !!u, p = f ? a : n.mode, m = s(f ? void 0 : n.bundle), h = f ? void 0 : n.projectConfig, g = n.getContent, _ = {
+		mode: p ?? a,
+		manifest: null
+	}, v, y, b = /* @__PURE__ */ new Map();
+	function x() {
+		if (p === a) return Promise.resolve(null);
+		if (m) return Promise.resolve(m);
+		let e = r();
+		return e ? Promise.resolve(e) : (v ??= o(), v);
+	}
+	function S(e) {
+		_.mode = e ? i : a, _.manifest = e ? e.manifestMetadata : null;
+	}
+	async function C() {
+		if (h) return S(await x()), h;
+		let t = await x();
+		return S(t), t ? t.projectConfig : p === i ? null : e(c, l, {
+			...u !== void 0 && { previewToken: u },
+			...d !== void 0 && { signal: d }
+		});
+	}
+	async function w(e, n) {
+		let r = u === void 0 ? void 0 : { previewToken: u };
+		if (g) return g(e, r);
+		let a = await x();
+		if (S(a), a) try {
+			return await a.experienceContent(e, r);
+		} catch {
+			return `${e.id}`, null;
+		}
+		if (p === i) return null;
+		let o = n ?? d;
+		return t(c, l, e.id, {
+			...u !== void 0 && { previewToken: u },
+			...o !== void 0 && { signal: o }
+		});
+	}
+	return {
+		meta: _,
+		getProjectConfig: () => (y ??= C(), y),
+		getContent: (e, t) => {
+			let n = b.get(e.id);
+			if (n) return n;
+			let r = w(e, t?.signal).finally(() => {
+				b.delete(e.id);
+			});
+			return b.set(e.id, r), r;
+		}
+	};
+}
+//#endregion
+export { c as createPickedDataProvider };

package/dist/provider-ixdOyYTA.cjs

@@ -0,0 +1 @@
+require("./logger-CSTvAyyB.cjs");const e=require("./api-DS7fA9kj.cjs"),t=require("./registry-C1t8l3t9.cjs");var n=`bundle`,r=`api`;async function i(){try{let e=await import(`virtual:picked/data`);return t.r(e)?e:null}catch{return null}}function a(e){if(e===void 0||t.r(e))return e}function o(o){let{apiUrl:s,projectId:c,previewToken:l,signal:u}=o,d=!!l,f=d?r:o.mode,p=a(d?void 0:o.bundle),m=d?void 0:o.projectConfig,h=o.getContent,g={mode:f??r,manifest:null},_,v,y=new Map;function b(){if(f===r)return Promise.resolve(null);if(p)return Promise.resolve(p);let e=t.t();return e?Promise.resolve(e):(_??=i(),_)}function x(e){g.mode=e?n:r,g.manifest=e?e.manifestMetadata:null}async function S(){if(m)return x(await b()),m;let t=await b();return x(t),t?t.projectConfig:f===n?null:e.n(s,c,{...l!==void 0&&{previewToken:l},...u!==void 0&&{signal:u}})}async function C(t,r){let i=l===void 0?void 0:{previewToken:l};if(h)return h(t,i);let a=await b();if(x(a),a)try{return await a.experienceContent(t,i)}catch{return`${t.id}`,null}if(f===n)return null;let o=r??u;return e.t(s,c,t.id,{...l!==void 0&&{previewToken:l},...o!==void 0&&{signal:o}})}return{meta:g,getProjectConfig:()=>(v??=S(),v),getContent:(e,t)=>{let n=y.get(e.id);if(n)return n;let r=C(e,t?.signal).finally(()=>{y.delete(e.id)});return y.set(e.id,r),r}}}exports.createPickedDataProvider=o;

package/dist/registry-C1t8l3t9.cjs

@@ -0,0 +1 @@
+require("./logger-CSTvAyyB.cjs");function e(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 t=null;function n(n){e(n)&&(t=n)}function r(){return t}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}});

package/dist/registry-CXZv0uLg.js

@@ -0,0 +1,18 @@
+import "./logger-DMN6TxJJ.js";
+//#region src/data-source/virtual-data.ts
+function e(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 t = null;
+function n(n) {
+	e(n) && (t = n);
+}
+function r() {
+	return t;
+}
+//#endregion
+export { n, e as r, r as t };

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

@@ -0,0 +1,60 @@
+import type { ExperienceContentResponse, FetchProjectOptions, ProjectConfig } from '@picked/delivery-api-client';
+/**
+ * Minimal shape check: verifies that `data` is an object with a `features` array.
+ *
+ * This is the minimum invariant required to prevent runtime crashes when iterating
+ * `config.features`. Individual feature and experience shapes are trusted from the API.
+ *
+ * @param {unknown} data - Unknown API response to validate.
+ * @returns {boolean} Whether `data` has the minimum required shape.
+ * @example
+ * ```typescript
+ * if (isProjectConfig(json)) { json.features }
+ * ```
+ */
+export declare function isProjectConfig(data: unknown): data is ProjectConfig;
+/**
+ * Minimal shape check for a successful experience-content response.
+ *
+ * @param {unknown} data - Unknown API response to validate.
+ * @returns {boolean} Whether `data` has the minimum required shape.
+ * @example
+ * ```typescript
+ * if (isExperienceContentResponse(json)) { useResponse(json) }
+ * ```
+ */
+export declare function isExperienceContentResponse(data: unknown): data is ExperienceContentResponse;
+/**
+ * Fetches the project configuration from the Picked REST API.
+ *
+ * Returns `null` on network failure, non-OK responses, or invalid JSON shape.
+ * Connection-refused errors from local URLs are suppressed silently.
+ *
+ * @param {string} apiUrl - Base URL for the Picked API.
+ * @param {string} projectId - Project ID to fetch config for.
+ * @param {FetchProjectOptions} [options] - Optional headers, preview token, and abort signal.
+ * @returns {Promise<ProjectConfig | null>} Validated project config, or `null` on any failure.
+ * @example
+ * ```typescript
+ * const config = await fetchProject('https://api.picked.app', 'proj_123')
+ * ```
+ */
+export declare function fetchProject(apiUrl: string, projectId: string, options?: FetchProjectOptions): Promise<ProjectConfig | null>;
+/**
+ * Fetches per-experience content from the Picked API.
+ *
+ * Returns `null` on network failure, non-OK responses, or invalid JSON shape — preserving
+ * the failure-tolerant policy: experiences still render, layouts handle null defensively.
+ *
+ * @param {string} apiUrl - Base URL for the Picked API.
+ * @param {string} projectId - Project ID to fetch content for.
+ * @param {string} experienceId - Experience ID whose content to fetch.
+ * @param {FetchProjectOptions} [options] - Optional headers, preview token, and abort signal.
+ * @returns {Promise<ExperienceContentResponse | null>} Validated content response, or `null` on any failure.
+ * @example
+ * ```typescript
+ * const content = await fetchExperienceContent('https://api.picked.app', 'proj_1', 'exp_1')
+ * ```
+ */
+export declare function fetchExperienceContent(apiUrl: string, projectId: string, experienceId: string, options?: FetchProjectOptions): Promise<ExperienceContentResponse | null>;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/data-source/api.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACd,MAAM,6BAA6B,CAAA;AA6CpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,yBAAyB,CAM5F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAE/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAE3C"}

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

@@ -0,0 +1,90 @@
+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. Used by `'api'` mode and by every preview session. */
+    apiUrl: string;
+    /** Project ID to resolve data for. */
+    projectId: string;
+    /**
+     * Which source to read from. Omit to resolve `'bundle'` when a bundle is available and
+     * `'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, supplied directly to skip both the registry and the
+     * dynamic import. A value that fails the shape guard 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. */
+    getContent?: ContentLoader;
+    /** Abort signal applied to API fetches, such as an `AbortSignal.timeout` deadline. */
+    signal?: AbortSignal;
+}
+/** Read-only description of what a provider resolved to. */
+export interface PickedDataProviderMeta {
+    /** The mode in force, after preview-token resolution. */
+    mode: PickedDataMode;
+    /** The bundle's manifest metadata, or `null` when not reading from a bundle. */
+    manifest: PickedManifestMetadata | null;
+}
+/** Resolves this session's project config and per-experience CMS content. */
+export interface PickedDataProvider {
+    /** What this provider resolved to. `manifest` populates once a bundle has been read. */
+    readonly meta: PickedDataProviderMeta;
+    /** Resolves the project config, or `null` when unavailable. Deduplicated across callers. */
+    getProjectConfig: () => Promise<ProjectConfig | null>;
+    /** Resolves an experience's content, or `null` when unavailable. Deduplicated per experience id. */
+    getContent: (experience: {
+        id: string;
+        key: string;
+    }, options?: {
+        signal?: AbortSignal;
+    }) => Promise<ExperienceContentResponse | null>;
+}
+/**
+ * Attempts to resolve `virtual:picked/data` provided by `@picked/vite-plugin-picked`.
+ *
+ * The dynamic import uses a literal string specifier (intentionally — using a variable plus
+ * `@vite-ignore` defeats Vite's import-analysis, so the plugin's `resolveId` is never called
+ * at build time and the bundle ends up with a runtime fetch to a `virtual:` URL that the
+ * browser cannot resolve). The SDK's own build marks `virtual:picked/data` as external so
+ * this literal import is preserved into the published dist, then downstream Vite builds with
+ * `@picked/vite-plugin-picked` resolve it through the plugin pipeline.
+ *
+ * Returns `null` when the virtual module is unresolvable (the consumer is not using the Vite
+ * plugin, or its build did not generate the module). Errors are swallowed: the caller falls
+ * back to the API path.
+ *
+ * @returns {Promise<VirtualPickedData | null>} The virtual module exports, or `null`.
+ * @example
+ * ```typescript
+ * const bundle = await resolveVirtualDataModule()
+ * ```
+ */
+export declare function resolveVirtualDataModule(): Promise<VirtualPickedData | null>;
+export { isVirtualPickedData };
+/**
+ * Creates the data provider for a session.
+ *
+ * @param {PickedDataProviderOptions} options - Provider configuration.
+ * @returns {PickedDataProvider} A provider resolving config and content from one source.
+ * @example
+ * ```typescript
+ * const provider = createPickedDataProvider({ mode: 'api', apiUrl, projectId })
+ * const config = await provider.getProjectConfig()
+ * ```
+ */
+export declare function createPickedDataProvider(options: PickedDataProviderOptions): PickedDataProvider;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/data-source/provider.ts"],"names":[],"mappings":"AAUA,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;;;;OAIG;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;AAyB9B;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAuK/F"}

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

@@ -0,0 +1,26 @@
+import type { VirtualPickedData } from '../plugins/dynamic-experiences/types';
+/**
+ * Records the bundle the build generated, for this session's data provider to read.
+ *
+ * A value that fails the shape guard is refused, so a malformed registration lands on the
+ * "no bundle" path. Any usable bundle registered earlier is kept.
+ *
+ * @param {unknown} bundle - The generated module's exports.
+ * @returns {void} Nothing.
+ * @example
+ * ```typescript
+ * registerPickedBundle({ projectConfig, experienceContent, manifestMetadata })
+ * ```
+ */
+export declare function registerPickedBundle(bundle: unknown): void;
+/**
+ * Reads the registered bundle.
+ *
+ * @returns {VirtualPickedData | null} The bundle, or `null` when nothing has registered one.
+ * @example
+ * ```typescript
+ * const bundle = readRegisteredBundle()
+ * ```
+ */
+export declare function readRegisteredBundle(): VirtualPickedData | null;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/data-source/registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAK7E;;;;;;;;;;;;GAYG;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"}