@liforma/client 0.4.5 → 0.4.8

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @liforma/client changelog
 
+## 0.4.8 — 2026-08-30
+
+### Added
+
+- `@liforma/client/react/thumbnail` and `@liforma/client/next/thumbnail` — gallery components without session / widget code
+- CDN `https://cdn.liforma.ai/sdk/v2/thumbnail.js` — registers `<liforma-experience-thumbnail>` only
+
+### Changed
+
+- Package `"sideEffects": false` so bundlers can drop unused barrel exports
+- Docs / snippets default gallery imports to the light thumbnail entries
+- Verify scripts fail if light thumbnail builds contain session SDK markers
+
+## 0.4.7 — 2026-08-30
+
+### Added
+
+- `@liforma/client/thumbnail` — thumbnail helpers without the session player
+- `@liforma/client/svelte/thumbnail` — `<ExperienceThumbnail>` without pulling `<Experience>` / widget
+
+### Notes
+
+- Gallery hosts should import the thumbnail entry so marketing pages do not hydrate the session SDK
+
+## 0.4.6 — 2026-08-30
+
+### Added
+
+- `theme` on `attach` / `<Experience>` for global player chrome tokens (introduction, feedback, panels, shared buttons)
+- Exported types: `PlayerTheme`, `PlayerThemeColors`, `PlayerThemeTypography`, `PlayerThemeButton`
+
+### Notes
+
+- Distinct from `startButton` — CTA appearance overrides still win on the start control
+- Presentation only; does not remint
+
 ## 0.4.5 — 2026-08-30
 
 ### Added

package/README.md

@@ -30,6 +30,24 @@ Optional peers: `svelte` ^5 for the Svelte entry; `react` / `react-dom` ^18 or ^
 <Experience experienceId="exp_01EXAMPLES_COFFEE_BARISTA" />
 ```
 
+Gallery cards — use the light thumbnail entry so landing pages do not load the session SDK:
+
+```svelte
+<script>
+  import { ExperienceThumbnail } from '@liforma/client/svelte/thumbnail';
+</script>
+```
+
+```tsx
+import { ExperienceThumbnail } from '@liforma/client/react/thumbnail';
+// or: import { ExperienceThumbnail } from '@liforma/client/next/thumbnail';
+```
+
+```html
+<script src="https://cdn.liforma.ai/sdk/v2/thumbnail.js" defer></script>
+<liforma-experience-thumbnail experience-id="exp_…" alt="…"></liforma-experience-thumbnail>
+```
+
 ### React
 
 ```tsx
@@ -79,8 +97,12 @@ export function Demo() {
 |--------|---------|
 | `@liforma/client` | JS API (`Experience.startSession`, types) |
 | `@liforma/client/svelte` | `<Experience />`, `<ExperienceThumbnail />`, `<ExperienceWidget />` |
+| `@liforma/client/svelte/thumbnail` | `<ExperienceThumbnail />` only (prefer for galleries) |
+| `@liforma/client/thumbnail` | Shared thumbnail helpers (no session player) |
 | `@liforma/client/react` | React components |
+| `@liforma/client/react/thumbnail` | `<ExperienceThumbnail />` only (prefer for galleries) |
 | `@liforma/client/next` | Next helpers + client components |
+| `@liforma/client/next/thumbnail` | `<ExperienceThumbnail />` only (prefer for galleries) |
 | `@liforma/client/byo` | Shared BYO primitives (PCM/mic/turn helpers) |
 | `@liforma/client/elevenlabs` | `connectElevenLabsAgent` (BYO ElevenLabs Agents → avatar) |
 | `@liforma/client/openai` | `connectOpenAiRealtime` / `connectOpenAiRealtimeWebRtc` (BYO OpenAI Realtime → avatar) |
@@ -88,6 +110,7 @@ export function Demo() {
 | `@liforma/client/google` | `connectGeminiLive` (BYO Gemini Live → avatar) |
 | `@liforma/client/livekit` | `connectLiveKitAgent` (BYO LiveKit remote track → avatar) |
 | CDN `sdk/v2/client.js` | Web components + `window.Liforma` |
+| CDN `sdk/v2/thumbnail.js` | `<liforma-experience-thumbnail>` only |
 
 ## Session minting
 

package/dist/next/index.js

@@ -972,7 +972,7 @@ function tt(e) {
 function nt(e, t, n) {
 	let r = e.trim();
 	if (!r) throw Error("createLaunchMessage requires a non-empty launch string.");
-	let i = n?.startButton, a = n?.showFeedback;
+	let i = n?.startButton, a = n?.theme, o = n?.showFeedback;
 	return {
 		type: "launch",
 		schemaVersion: 2,
@@ -980,7 +980,8 @@ function nt(e, t, n) {
 			launch: r,
 			...t === void 0 ? {} : { session: t },
 			...i ? { startButton: i } : {},
-			...a === void 0 ? {} : { showFeedback: a }
+			...a ? { theme: a } : {},
+			...o === void 0 ? {} : { showFeedback: o }
 		}
 	};
 }
@@ -1423,6 +1424,13 @@ function ft(e) {
 				}
 			});
 		},
+		engage() {
+			return C({
+				type: "engage",
+				schemaVersion: 2,
+				payload: { correlationId: Z() }
+			});
+		},
 		destroy() {
 			if (!r) {
 				r = !0, i && s(!1);
@@ -1496,6 +1504,7 @@ function wt() {
 	return {
 		ready: /* @__PURE__ */ new Set(),
 		started: /* @__PURE__ */ new Set(),
+		sessionMinted: /* @__PURE__ */ new Set(),
 		userTranscript: /* @__PURE__ */ new Set(),
 		userSpeechStarted: /* @__PURE__ */ new Set(),
 		userSpeechEnded: /* @__PURE__ */ new Set(),
@@ -2172,6 +2181,7 @@ var un = class e {
 	eventRegistry = wt();
 	readyEnvelope = null;
 	startedEnvelope = null;
+	sessionMintedEnvelope = null;
 	conversationCache = [];
 	speech;
 	constructor(e) {
@@ -2260,7 +2270,7 @@ var un = class e {
 	}
 	on(e, t) {
 		let n = Tt(this.eventRegistry, e, t);
-		return e === "ready" && this.readyEnvelope && queueMicrotask(() => t(this.readyEnvelope)), e === "started" && this.startedEnvelope && queueMicrotask(() => t(this.startedEnvelope)), n;
+		return e === "ready" && this.readyEnvelope && queueMicrotask(() => t(this.readyEnvelope)), e === "started" && this.startedEnvelope && queueMicrotask(() => t(this.startedEnvelope)), e === "sessionMinted" && this.sessionMintedEnvelope && queueMicrotask(() => t(this.sessionMintedEnvelope)), n;
 	}
 	async attach(e) {
 		if (this.closed) throw Error("Session has ended.");
@@ -2376,11 +2386,15 @@ var un = class e {
 		f.postParentHello();
 		let g = h?.launch ?? (this.bootstrap.kind === "launch" ? this.bootstrap.launch : null), _ = h?.session ?? (this.bootstrap.kind === "launch" ? this.bootstrap.session : void 0);
 		if (!g) throw f.destroy(), this.iframeHost === f && (this.iframeHost = null), Error("Session Launch response did not include a launch token.");
-		return this.launchToken = g, _ ? (this.resolvedSession = _, this.bootstrap.kind === "launch" && Fe(_), f.postLaunch(g, _, {
+		this.launchToken = g;
+		let v = _ ?? (this.bootstrap.kind === "launch" ? this.bootstrap.session : void 0);
+		return v && !this.sessionMintedEnvelope && (this.resolvedSession = v, this.sessionMintedEnvelope = this.emitWrapped("sessionMinted", { session: v })), _ ? (this.resolvedSession = _, this.bootstrap.kind === "launch" && Fe(_), f.postLaunch(g, _, {
 			startButton: e.startButton,
+			theme: e.theme,
 			showFeedback: e.showFeedback
 		}), u.setValue(_)) : f.postLaunch(g, void 0, {
 			startButton: e.startButton,
+			theme: e.theme,
 			showFeedback: e.showFeedback
 		}), await Promise.race([s, new Promise((e, t) => {
 			setTimeout(() => t(/* @__PURE__ */ Error("Timed out waiting for player loading UI.")), 12e4);
@@ -2420,6 +2434,11 @@ var un = class e {
 		if (!this.iframeHost) throw Error("conversion() requires attach() first.");
 		await this.iframeHost.conversion(e);
 	}
+	async engage() {
+		if (this.closed) throw Error("Session has ended.");
+		if (!this.iframeHost) throw Error("engage() requires attach() first.");
+		await this.iframeHost.engage();
+	}
 	getLastTurn() {
 		if (this.conversationCache.length === 0) return [];
 		let e = this.conversationCache[this.conversationCache.length - 1].turnId;