@contentful/experiences-svelte 0.6.5 → 0.6.7

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## 0.6.7 (2026-09-22)
+
+### 🚀 Features
+
+- **live-preview:** expose connection errors [SPA-5151] ([#198](https://github.com/contentful/experiences/pull/198))
+
+### 🧱 Updated Dependencies
+
+- Updated live-preview to 0.1.5
+
+## 0.6.6 (2026-09-21)
+
+### 🚀 Features
+
+- deprecate the SDK viewport surface, guard absent viewports [SPA-5272] ([4a74473](https://github.com/contentful/experiences/commit/4a74473))
+
+### 🩹 Fixes
+
+- reword deprecation notices, drop internal ticket link [SPA-5272] ([8361460](https://github.com/contentful/experiences/commit/8361460))
+
+### 🧱 Updated Dependencies
+
+- Updated live-preview to 0.1.4
+- Updated client to 0.4.5
+- Updated design to 0.8.4
+- Updated core to 0.8.4
+
 ## 0.6.5 (2026-09-21)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -101,6 +101,9 @@ For separate access to the raw payload and rendered plan, use
 into the `PortableRenderPlan` consumed by the renderer and keeps the current rendered
 experience while an update is being resolved.
 
+The live-preview results also expose `error` when the Preview Session connection
+fails. The last valid `data` remains available.
+
 ### Renderers
 
 ```ts
@@ -145,6 +148,7 @@ isCssProperty, toCssKey, CSS_PROPERTIES
 // From client
 fetchExperience, fetchPreviewSession, createClient, ContentfulViewDelivery,
 ContentfulViewDeliveryClient, NotFoundError, PreviewSessionFetchError,
+LivePreviewConnectionError,
 DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST
 
 type ExperienceOptions, PreviewSessionExperienceOptions, PreviewSessionClientOptions,

package/dist/index.d.ts

@@ -13,8 +13,8 @@ export { useLivePreview } from './use-live-preview.svelte.js';
 export type { UseLivePreviewOptions, UseLivePreviewResult } from './use-live-preview.svelte.js';
 export { useExperiencePlan } from './use-experience-plan.svelte.js';
 export type { ExperiencePlanResolveOptions, UseExperiencePlanOptions, UseExperiencePlanResult, } from './use-experience-plan.svelte.js';
-export type { LivePreviewClient, PreviewSessionClientOptions, PreviewSessionExperienceOptions, PreviewSessionOptions, PreviewSessionResolveOptions, } from '@contentful/experiences-live-preview';
-export { fetchPreviewSession, PREVIEW_WEBSOCKET_HOST, PreviewSessionFetchError, } from '@contentful/experiences-live-preview';
+export type { LivePreviewClient, LivePreviewResult, PreviewSessionClientOptions, PreviewSessionExperienceOptions, PreviewSessionOptions, PreviewSessionResolveOptions, } from '@contentful/experiences-live-preview';
+export { fetchPreviewSession, LivePreviewConnectionError, PREVIEW_WEBSOCKET_HOST, PreviewSessionFetchError, } from '@contentful/experiences-live-preview';
 export { getExperience, getContentfulComponent, getContentfulExperienceTemplate, } from './context.js';
 export { getDesignValues } from './get-design-values.js';
 export { toCss } from './design-utils.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,IAAI,uBAAuB,EACxD,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,UAAU,EACV,MAAM,EACN,mBAAmB,EACnB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAGjG,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,QAAQ,EACR,eAAe,GAChB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -26,7 +26,7 @@ export { useActiveViewport } from './use-active-viewport.svelte.js';
 export { useLivePreviewExperience } from './use-live-preview-experience.svelte.js';
 export { useLivePreview } from './use-live-preview.svelte.js';
 export { useExperiencePlan } from './use-experience-plan.svelte.js';
-export { fetchPreviewSession, PREVIEW_WEBSOCKET_HOST, PreviewSessionFetchError, } from '@contentful/experiences-live-preview';
+export { fetchPreviewSession, LivePreviewConnectionError, PREVIEW_WEBSOCKET_HOST, PreviewSessionFetchError, } from '@contentful/experiences-live-preview';
 // ─── Runtime context helpers ─────────────────────────────────────────────
 export { getExperience, getContentfulComponent, getContentfulExperienceTemplate, } from './context.js';
 export { getDesignValues } from './get-design-values.js';

package/dist/server-renderer.test.js

@@ -767,6 +767,24 @@ describe('ServerExperienceRenderer — server pre-resolved design values', () =>
         expect(container.innerHTML).toContain('data-padding="12px"');
     });
 });
+describe('ServerExperienceRenderer — absent payload.viewports', () => {
+    it('renders flat design values when the payload has no viewports field', async () => {
+        const cfg = { components: { heading: HeadingFixture } };
+        const plan = await resolveExperience({
+            nodes: [
+                componentNode('heading', {
+                    id: 'h',
+                    designProperties: { cfFontSize: m('32px') },
+                }),
+            ],
+        }, cfg);
+        expect(plan.viewports).toEqual([]);
+        const { container } = render(ServerExperienceRenderer, {
+            props: { experience: plan, config: cfg },
+        });
+        expect(container.innerHTML).toContain('data-font-size="32px"');
+    });
+});
 describe('toCss (Svelte)', () => {
     it('converts bare (non-cf) CSS keys — the shape real payloads use', () => {
         expect(toCss({ fontSize: '20px', backgroundColor: '#4f39f6' })).toEqual({

package/dist/test-fixtures/LivePreviewExperienceProbe.svelte

@@ -6,4 +6,6 @@
   const livePreview = useLivePreviewExperience(() => options);
 </script>
 
-<output>{livePreview.data?.nodes[0]?.contentProperties?.title ?? ''}</output>
+<output data-error={livePreview.error?.name ?? ''}>
+  {livePreview.data?.nodes[0]?.contentProperties?.title ?? ''}
+</output>

package/dist/test-fixtures/LivePreviewExperienceProbe.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LivePreviewExperienceProbe.svelte.d.ts","sourceRoot":"","sources":["../../src/test-fixtures/LivePreviewExperienceProbe.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAG/F,KAAK,gBAAgB,GAAI;IAAE,OAAO,EAAE,+BAA+B,CAAA;CAAE,CAAC;AAavE,QAAA,MAAM,0BAA0B,sDAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"LivePreviewExperienceProbe.svelte.d.ts","sourceRoot":"","sources":["../../src/test-fixtures/LivePreviewExperienceProbe.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAG/F,KAAK,gBAAgB,GAAI;IAAE,OAAO,EAAE,+BAA+B,CAAA;CAAE,CAAC;AAevE,QAAA,MAAM,0BAA0B,sDAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}

package/dist/use-active-viewport.svelte.d.ts

@@ -1,4 +1,9 @@
 import type { ViewportDef } from '@contentful/experiences-sdk-core';
+/**
+ * @deprecated Viewports are being removed from the Experiences APIs, with no
+ * direct replacement — use CSS media queries or `window.matchMedia` instead.
+ * Will not be removed before 2026-10-06.
+ */
 export interface UseActiveViewportResult {
     readonly activeViewportIndex: number;
 }
@@ -9,6 +14,10 @@ export interface UseActiveViewportResult {
  *
  * Must be called at the top level of a `.svelte` component or a function
  * that's itself called during component setup (because of `$effect`).
+ *
+ * @deprecated Viewports are being removed from the Experiences APIs, with no
+ * direct replacement — use CSS media queries or `window.matchMedia` instead.
+ * Will not be removed before 2026-10-06.
  */
 export declare function useActiveViewport(viewports: ViewportDef[], initialViewportId?: string): UseActiveViewportResult;
 //# sourceMappingURL=use-active-viewport.svelte.d.ts.map

package/dist/use-active-viewport.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-active-viewport.svelte.d.ts","sourceRoot":"","sources":["../src/use-active-viewport.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EAAE,EACxB,iBAAiB,CAAC,EAAE,MAAM,GACzB,uBAAuB,CAiDzB"}
+{"version":3,"file":"use-active-viewport.svelte.d.ts","sourceRoot":"","sources":["../src/use-active-viewport.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EAAE,EACxB,iBAAiB,CAAC,EAAE,MAAM,GACzB,uBAAuB,CAiDzB"}

package/dist/use-active-viewport.svelte.js

@@ -18,6 +18,10 @@ import { createMediaQueryMatchers, getViewportIndex } from '@contentful/experien
  *
  * Must be called at the top level of a `.svelte` component or a function
  * that's itself called during component setup (because of `$effect`).
+ *
+ * @deprecated Viewports are being removed from the Experiences APIs, with no
+ * direct replacement — use CSS media queries or `window.matchMedia` instead.
+ * Will not be removed before 2026-10-06.
  */
 export function useActiveViewport(viewports, initialViewportId) {
     const initialIndex = getViewportIndex(viewports, initialViewportId);

package/dist/use-live-preview-experience.svelte.d.ts

@@ -6,6 +6,7 @@ export type UseLivePreviewExperienceOptions = {
 };
 export interface UseLivePreviewExperienceResult {
     readonly data: ExperiencePayload | undefined;
+    readonly error: Error | undefined;
 }
 export declare function useLivePreviewExperience(getOptions: () => UseLivePreviewExperienceOptions): UseLivePreviewExperienceResult;
 //# sourceMappingURL=use-live-preview-experience.svelte.d.ts.map

package/dist/use-live-preview-experience.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-preview-experience.svelte.d.ts","sourceRoot":"","sources":["../src/use-live-preview-experience.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,MAAM,MAAM,+BAA+B,GAAG;IAC5C,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC9C;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,+BAA+B,GAChD,8BAA8B,CA+BhC"}
+{"version":3,"file":"use-live-preview-experience.svelte.d.ts","sourceRoot":"","sources":["../src/use-live-preview-experience.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,MAAM,MAAM,+BAA+B,GAAG;IAC5C,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,+BAA+B,GAChD,8BAA8B,CAqChC"}

package/dist/use-live-preview-experience.svelte.js

@@ -1,19 +1,22 @@
 import { createLivePreviewClient, sendPreviewStatus, } from '@contentful/experiences-live-preview';
 export function useLivePreviewExperience(getOptions) {
     const initialPayload = getOptions().initialPayload;
-    let data = $state(initialPayload);
+    let result = $state({
+        data: initialPayload,
+        error: undefined,
+    });
     $effect(() => {
         const { previewSessionOptions } = getOptions();
-        data = initialPayload;
+        result = { data: initialPayload, error: undefined };
         if (previewSessionOptions === undefined) {
             sendPreviewStatus('static');
             return;
         }
         const client = createLivePreviewClient(previewSessionOptions, initialPayload);
         const unsubscribeStatus = client.subscribeStatus(sendPreviewStatus);
-        data = client.getSnapshot();
+        result = client.getResult();
         const unsubscribe = client.subscribe(() => {
-            data = client.getSnapshot();
+            result = client.getResult();
         });
         return () => {
             unsubscribeStatus();
@@ -22,7 +25,10 @@ export function useLivePreviewExperience(getOptions) {
     });
     return {
         get data() {
-            return data;
+            return result.data;
+        },
+        get error() {
+            return result.error;
         },
     };
 }

package/dist/use-live-preview-experience.test.js

@@ -1,4 +1,5 @@
 import { render } from '@testing-library/svelte';
+import { tick } from 'svelte';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import LivePreviewExperienceProbe from './test-fixtures/LivePreviewExperienceProbe.svelte';
 class FakeWebSocket {
@@ -122,6 +123,17 @@ describe('useLivePreviewExperience', () => {
             status: 'live',
         }, '*');
     });
+    it('exposes a connection error after retries are exhausted', async () => {
+        vi.useFakeTimers();
+        const view = render(LivePreviewExperienceProbe, { props: { options: options() } });
+        for (let retry = 0; retry < 3; retry += 1) {
+            FakeWebSocket.instances.at(-1)?.emitClose({ code: 1006, reason: 'network' });
+            vi.runOnlyPendingTimers();
+        }
+        FakeWebSocket.instances.at(-1)?.emitClose({ code: 1006, reason: 'network' });
+        await tick();
+        expect(view.container.querySelector('output')?.dataset.error).toBe('LivePreviewConnectionError');
+    });
     it('sends static status without Preview Session options', () => {
         const postMessage = vi.spyOn(window.parent, 'postMessage').mockImplementation(() => undefined);
         render(LivePreviewExperienceProbe, {

package/dist/use-live-preview.svelte.d.ts

@@ -9,6 +9,7 @@ export interface UseLivePreviewOptions {
 }
 export interface UseLivePreviewResult {
     readonly data: PortableRenderPlan | undefined;
+    readonly error: Error | undefined;
 }
 export declare function useLivePreview(getOptions: () => UseLivePreviewOptions): UseLivePreviewResult;
 //# sourceMappingURL=use-live-preview.svelte.d.ts.map

package/dist/use-live-preview.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-preview.svelte.d.ts","sourceRoot":"","sources":["../src/use-live-preview.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AAGzC,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,4BAA4B,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC/C;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,qBAAqB,GAAG,oBAAoB,CAU5F"}
+{"version":3,"file":"use-live-preview.svelte.d.ts","sourceRoot":"","sources":["../src/use-live-preview.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AAGzC,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,4BAA4B,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,qBAAqB,GAAG,oBAAoB,CAmB5F"}

package/dist/use-live-preview.svelte.js

@@ -5,8 +5,16 @@ export function useLivePreview(getOptions) {
         const { previewSessionOptions, initialPayload } = getOptions();
         return { previewSessionOptions, initialPayload };
     });
-    return useExperiencePlan(() => {
+    const plan = useExperiencePlan(() => {
         const { initialPlan, resolveOptions } = getOptions();
         return { payload: livePreview.data, initialPlan, resolveOptions };
     });
+    return {
+        get data() {
+            return plan.data;
+        },
+        get error() {
+            return livePreview.error;
+        },
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-svelte",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Svelte adapter for Contentful Experiences — Server and Client renderers over a PortableRenderPlan",
   "license": "MIT",
   "type": "module",
@@ -35,10 +35,10 @@
     "check": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "@contentful/experiences-client": "0.4.4",
-    "@contentful/experiences-sdk-core": "0.8.3",
-    "@contentful/experiences-design": "0.8.3",
-    "@contentful/experiences-live-preview": "0.1.3"
+    "@contentful/experiences-client": "0.4.5",
+    "@contentful/experiences-sdk-core": "0.8.4",
+    "@contentful/experiences-design": "0.8.4",
+    "@contentful/experiences-live-preview": "0.1.5"
   },
   "peerDependencies": {
     "svelte": "^5.55.7"