@liforma/client 0.4.6 → 0.4.9

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @liforma/client changelog
 
+## 0.4.9 — 2026-08-31
+
+### Added
+
+- `alreadyConverted` on mint (`startSession`, `<Experience>`, `sessionEndpoint`, `POST /v1/sessions`, `POST /v1/browser-sessions`) — conversion keys this play is already ineligible for (for example `registration`)
+- `createLiformaSessionRouteHandler` forwards `alreadyConverted`; `authorize` may set it from the host session
+
+### Notes
+
+- Conversion rate for a key is acquired conversions ÷ eligible plays (not listed in `alreadyConverted`)
+- Do not fire `conversion('registration')` for a visitor who was already registered
+
+## 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

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