@contentful/experiences-sdk-react 1.30.0-dev-20250124T1739-560b81b.0 → 1.30.0-dev-20250128T1255-1f90987.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,7 +6,7 @@ import { sdkFeatures } from '../core/sdkFeatures.js';
6
6
 
7
7
  const useDetectCanvasMode = ({ isClientSide = false } = {}) => {
8
8
  const [mounted, setMounted] = useState(false);
9
- const recievedModeMessage = useRef(false);
9
+ const receivedModeMessage = useRef(false);
10
10
  const [mode, setMode] = useState(() => {
11
11
  // if we are client side and running in an iframe, then initialize to read only,
12
12
  // Editor mode can be requested later.
@@ -29,7 +29,7 @@ const useDetectCanvasMode = ({ isClientSide = false } = {}) => {
29
29
  }
30
30
  const isEditorMode = eventData.eventType === INCOMING_EVENTS.RequestEditorMode;
31
31
  const mode = isEditorMode ? StudioCanvasMode.EDITOR : StudioCanvasMode.READ_ONLY;
32
- recievedModeMessage.current = true;
32
+ receivedModeMessage.current = true;
33
33
  setMode(mode);
34
34
  if (typeof window !== 'undefined') {
35
35
  // Once we definitely know that we are in editor mode, we set this flag so future postMessage connect calls are not made
@@ -43,7 +43,7 @@ const useDetectCanvasMode = ({ isClientSide = false } = {}) => {
43
43
  }, []);
44
44
  useEffect(() => {
45
45
  const handleHandshakeTimeout = () => {
46
- if (!recievedModeMessage.current) {
46
+ if (!receivedModeMessage.current) {
47
47
  setMode(StudioCanvasMode.NONE);
48
48
  }
49
49
  };
@@ -54,14 +54,19 @@ const useDetectCanvasMode = ({ isClientSide = false } = {}) => {
54
54
  window.addEventListener('message', onMessage);
55
55
  sendMessage(OUTGOING_EVENTS.Connected, undefined);
56
56
  sendMessage(OUTGOING_EVENTS.SDKFeatures, sdkFeatures);
57
- setTimeout(handleHandshakeTimeout, 100);
57
+ // FIXME: This causes a race condition by setting the mode sometimes to NONE when
58
+ // reloading the canvas due to a save event.
59
+ const handshakeTimeout = setTimeout(handleHandshakeTimeout, 100);
60
+ return () => {
61
+ window.removeEventListener('message', onMessage);
62
+ clearTimeout(handshakeTimeout);
63
+ };
58
64
  }
59
65
  }
60
66
  else {
61
67
  setMounted(true);
62
68
  }
63
- return () => window.removeEventListener('message', onMessage);
64
- }, [mounted, onMessage]);
69
+ }, [mode, mounted, onMessage]);
65
70
  return mode;
66
71
  };
67
72
  function inIframe() {
@@ -1 +1 @@
1
- {"version":3,"file":"useDetectCanvasMode.js","sources":["../../../src/hooks/useDetectCanvasMode.tsx"],"sourcesContent":["'use client';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n doesMismatchMessageSchema,\n sendMessage,\n tryParseMessage,\n} from '@contentful/experiences-core';\nimport {\n INCOMING_EVENTS,\n OUTGOING_EVENTS,\n StudioCanvasMode,\n} from '@contentful/experiences-core/constants';\nimport { sdkFeatures } from '../core/sdkFeatures';\n\ntype useDetectCanvasModeArgs = {\n /** If running from a known client side only situation (ie: useFetchBySlug),\n * set this to true to kick in editor mode check sooner (which avoids a render cycle) */\n isClientSide?: boolean;\n};\n\nexport const useDetectCanvasMode = ({ isClientSide = false }: useDetectCanvasModeArgs = {}) => {\n const [mounted, setMounted] = useState(false);\n const recievedModeMessage = useRef(false);\n const [mode, setMode] = useState<StudioCanvasMode>(() => {\n // if we are client side and running in an iframe, then initialize to read only,\n // Editor mode can be requested later.\n if (isClientSide && inIframe()) {\n return StudioCanvasMode.READ_ONLY;\n } else {\n return StudioCanvasMode.NONE;\n }\n });\n\n const onMessage = useCallback((event: MessageEvent) => {\n if (doesMismatchMessageSchema(event)) {\n return;\n }\n const eventData = tryParseMessage(event);\n const isRequestingCanvasMode =\n eventData.eventType === INCOMING_EVENTS.RequestEditorMode ||\n eventData.eventType === INCOMING_EVENTS.RequestReadOnlyMode;\n\n if (!isRequestingCanvasMode) {\n return;\n }\n\n const isEditorMode = eventData.eventType === INCOMING_EVENTS.RequestEditorMode;\n const mode = isEditorMode ? StudioCanvasMode.EDITOR : StudioCanvasMode.READ_ONLY;\n\n recievedModeMessage.current = true;\n setMode(mode);\n\n if (typeof window !== 'undefined') {\n // Once we definitely know that we are in editor mode, we set this flag so future postMessage connect calls are not made\n if (!window.__EB__) {\n window.__EB__ = {};\n }\n window.__EB__.isReadOnlyMode = !isEditorMode;\n window.__EB__.isEditorMode = isEditorMode;\n }\n\n window.removeEventListener('message', onMessage);\n }, []);\n\n useEffect(() => {\n const handleHandshakeTimeout = () => {\n if (!recievedModeMessage.current) {\n setMode(StudioCanvasMode.NONE);\n }\n };\n\n // Only run check after component is mounted on the client to avoid hydration ssr issues\n if (mounted) {\n // Double check if we are in editor mode by listening to postMessage events\n if (typeof window !== 'undefined') {\n window.addEventListener('message', onMessage);\n sendMessage(OUTGOING_EVENTS.Connected, undefined);\n sendMessage(OUTGOING_EVENTS.SDKFeatures, sdkFeatures);\n\n setTimeout(handleHandshakeTimeout, 100);\n }\n } else {\n setMounted(true);\n }\n\n return () => window.removeEventListener('message', onMessage);\n }, [mounted, onMessage]);\n\n return mode;\n};\n\nfunction inIframe() {\n try {\n return window.self !== window.top;\n } catch (e) {\n return false;\n }\n}\n"],"names":[],"mappings":";;;;;;AAoBO;;AAEL;;;;AAIE;;;;;;AAKF;AAEA;AACE;;;AAGA;;AAGE;;;;;AAOF;AAEA;;AAGA;;AAEE;AACE;;AAEF;AACA;;AAGF;;;;AAKE;AACE;;AAEJ;;;;AAKE;AACE;AACA;AACA;AAEA;;;;;;;AAON;AAEA;AACF;AAEA;AACE;AACE;;;AAEA;;AAEJ;;"}
1
+ {"version":3,"file":"useDetectCanvasMode.js","sources":["../../../src/hooks/useDetectCanvasMode.tsx"],"sourcesContent":["'use client';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n doesMismatchMessageSchema,\n sendMessage,\n tryParseMessage,\n} from '@contentful/experiences-core';\nimport {\n INCOMING_EVENTS,\n OUTGOING_EVENTS,\n StudioCanvasMode,\n} from '@contentful/experiences-core/constants';\nimport { sdkFeatures } from '../core/sdkFeatures';\n\ntype useDetectCanvasModeArgs = {\n /** If running from a known client side only situation (ie: useFetchBySlug),\n * set this to true to kick in editor mode check sooner (which avoids a render cycle) */\n isClientSide?: boolean;\n};\n\nexport const useDetectCanvasMode = ({ isClientSide = false }: useDetectCanvasModeArgs = {}) => {\n const [mounted, setMounted] = useState(false);\n const receivedModeMessage = useRef(false);\n const [mode, setMode] = useState<StudioCanvasMode>(() => {\n // if we are client side and running in an iframe, then initialize to read only,\n // Editor mode can be requested later.\n if (isClientSide && inIframe()) {\n return StudioCanvasMode.READ_ONLY;\n } else {\n return StudioCanvasMode.NONE;\n }\n });\n\n const onMessage = useCallback((event: MessageEvent) => {\n if (doesMismatchMessageSchema(event)) {\n return;\n }\n const eventData = tryParseMessage(event);\n const isRequestingCanvasMode =\n eventData.eventType === INCOMING_EVENTS.RequestEditorMode ||\n eventData.eventType === INCOMING_EVENTS.RequestReadOnlyMode;\n\n if (!isRequestingCanvasMode) {\n return;\n }\n\n const isEditorMode = eventData.eventType === INCOMING_EVENTS.RequestEditorMode;\n const mode = isEditorMode ? StudioCanvasMode.EDITOR : StudioCanvasMode.READ_ONLY;\n\n receivedModeMessage.current = true;\n setMode(mode);\n\n if (typeof window !== 'undefined') {\n // Once we definitely know that we are in editor mode, we set this flag so future postMessage connect calls are not made\n if (!window.__EB__) {\n window.__EB__ = {};\n }\n window.__EB__.isReadOnlyMode = !isEditorMode;\n window.__EB__.isEditorMode = isEditorMode;\n }\n\n window.removeEventListener('message', onMessage);\n }, []);\n\n useEffect(() => {\n const handleHandshakeTimeout = () => {\n if (!receivedModeMessage.current) {\n setMode(StudioCanvasMode.NONE);\n }\n };\n\n // Only run check after component is mounted on the client to avoid hydration ssr issues\n if (mounted) {\n // Double check if we are in editor mode by listening to postMessage events\n if (typeof window !== 'undefined') {\n window.addEventListener('message', onMessage);\n sendMessage(OUTGOING_EVENTS.Connected, undefined);\n sendMessage(OUTGOING_EVENTS.SDKFeatures, sdkFeatures);\n\n // FIXME: This causes a race condition by setting the mode sometimes to NONE when\n // reloading the canvas due to a save event.\n const handshakeTimeout = setTimeout(handleHandshakeTimeout, 100);\n\n return () => {\n window.removeEventListener('message', onMessage);\n clearTimeout(handshakeTimeout);\n };\n }\n } else {\n setMounted(true);\n }\n }, [mode, mounted, onMessage]);\n\n return mode;\n};\n\nfunction inIframe() {\n try {\n return window.self !== window.top;\n } catch (e) {\n return false;\n }\n}\n"],"names":[],"mappings":";;;;;;AAoBO;;AAEL;;;;AAIE;;;;;;AAKF;AAEA;AACE;;;AAGA;;AAGE;;;;;AAOF;AAEA;;AAGA;;AAEE;AACE;;AAEF;AACA;;AAGF;;;;AAKE;AACE;;AAEJ;;;;AAKE;AACE;AACA;AACA;;;;AAMA;AACE;;AAEF;;;;;;;AAON;AACF;AAEA;AACE;AACE;;;AAEA;;AAEJ;;"}
@@ -27,6 +27,16 @@ const useFetchByBase = (fetchMethod, mode) => {
27
27
  }
28
28
  })();
29
29
  }, [fetchMethod, mode]);
30
+ // When a save event caused a canvas reload, the `receivedModeMessage` might time out and set the
31
+ // mode temporarily to NONE. If it's set to a valid mode afterward, we ignore the fetch result.
32
+ if (mode === StudioCanvasMode.EDITOR || mode === StudioCanvasMode.READ_ONLY) {
33
+ return {
34
+ error: undefined,
35
+ experience: undefined,
36
+ isLoading: false,
37
+ mode,
38
+ };
39
+ }
30
40
  return {
31
41
  error,
32
42
  experience,
@@ -1 +1 @@
1
- {"version":3,"file":"useFetchByBase.js","sources":["../../../src/hooks/useFetchByBase.ts"],"sourcesContent":["'use client';\nimport { useEffect, useState } from 'react';\nimport { EntityStore } from '@contentful/experiences-core';\nimport type { Experience } from '@contentful/experiences-core/types';\nimport { StudioCanvasMode } from '@contentful/experiences-core/constants';\n\nexport const useFetchByBase = (\n fetchMethod: () => Promise<Experience<EntityStore> | undefined>,\n mode: StudioCanvasMode,\n) => {\n const [experience, setExperience] = useState<Experience<EntityStore>>();\n const [isLoading, setIsLoading] = useState(false);\n const [error, setError] = useState<Error>();\n\n useEffect(() => {\n (async () => {\n // if we are in editor/read only mode, we don't want to fetch the experience here\n // it is passed via postMessage instead\n if (mode === StudioCanvasMode.EDITOR || mode === StudioCanvasMode.READ_ONLY) {\n return;\n }\n setIsLoading(true);\n setError(undefined);\n try {\n const exp = await fetchMethod();\n setExperience(exp);\n } catch (error) {\n setError(error as Error);\n } finally {\n setIsLoading(false);\n }\n })();\n }, [fetchMethod, mode]);\n\n return {\n error,\n experience,\n isLoading,\n mode,\n };\n};\n"],"names":[],"mappings":";;;;;;;;;;;;AAkBM;;;;;AAKA;AACE;;;;;;;;;;AAQN;;;;;;;AAQF;;"}
1
+ {"version":3,"file":"useFetchByBase.js","sources":["../../../src/hooks/useFetchByBase.ts"],"sourcesContent":["'use client';\nimport { useEffect, useState } from 'react';\nimport { EntityStore } from '@contentful/experiences-core';\nimport type { Experience } from '@contentful/experiences-core/types';\nimport { StudioCanvasMode } from '@contentful/experiences-core/constants';\n\nexport const useFetchByBase = (\n fetchMethod: () => Promise<Experience<EntityStore> | undefined>,\n mode: StudioCanvasMode,\n) => {\n const [experience, setExperience] = useState<Experience<EntityStore>>();\n const [isLoading, setIsLoading] = useState(false);\n const [error, setError] = useState<Error>();\n\n useEffect(() => {\n (async () => {\n // if we are in editor/read only mode, we don't want to fetch the experience here\n // it is passed via postMessage instead\n if (mode === StudioCanvasMode.EDITOR || mode === StudioCanvasMode.READ_ONLY) {\n return;\n }\n setIsLoading(true);\n setError(undefined);\n try {\n const exp = await fetchMethod();\n setExperience(exp);\n } catch (error) {\n setError(error as Error);\n } finally {\n setIsLoading(false);\n }\n })();\n }, [fetchMethod, mode]);\n\n // When a save event caused a canvas reload, the `receivedModeMessage` might time out and set the\n // mode temporarily to NONE. If it's set to a valid mode afterward, we ignore the fetch result.\n if (mode === StudioCanvasMode.EDITOR || mode === StudioCanvasMode.READ_ONLY) {\n return {\n error: undefined,\n experience: undefined,\n isLoading: false,\n mode,\n };\n }\n\n return {\n error,\n experience,\n isLoading,\n mode,\n };\n};\n"],"names":[],"mappings":";;;;;;;;;;;;AAkBM;;;;;AAKA;AACE;;;;;;;;;;AAQN;;;AAIA;;AAEI;AACA;AACA;;;;;;;;;;AAWN;;"}
package/dist/index.d.ts CHANGED
@@ -8,7 +8,7 @@ import * as _contentful_experiences_core_constants from '@contentful/experiences
8
8
  export { CF_STYLE_ATTRIBUTES, CONTENTFUL_COMPONENTS, LATEST_SCHEMA_VERSION } from '@contentful/experiences-core/constants';
9
9
  import { ContentfulClientApi } from 'contentful';
10
10
 
11
- declare const SDK_VERSION = "1.30.0-dev-20250124T1739-560b81b.0";
11
+ declare const SDK_VERSION = "1.30.0-dev-20250128T1255-1f90987.0";
12
12
 
13
13
  type ExperienceRootProps = {
14
14
  experience?: Experience<EntityStore> | string | null;
@@ -25,13 +25,21 @@ type UseFetchByIdArgs = {
25
25
  hyperlinkPattern?: string;
26
26
  };
27
27
  declare const useFetchById: ({ id, localeCode, client, experienceTypeId, hyperlinkPattern, }: UseFetchByIdArgs) => {
28
+ experience: {
29
+ hyperlinkPattern: string | undefined;
30
+ entityStore?: _contentful_experiences_core.EntityStore | undefined;
31
+ };
32
+ error: undefined;
33
+ isLoading: boolean;
34
+ mode: _contentful_experiences_core_constants.StudioCanvasMode.READ_ONLY | _contentful_experiences_core_constants.StudioCanvasMode.EDITOR;
35
+ } | {
28
36
  experience: {
29
37
  hyperlinkPattern: string | undefined;
30
38
  entityStore?: _contentful_experiences_core.EntityStore | undefined;
31
39
  };
32
40
  error: Error | undefined;
33
41
  isLoading: boolean;
34
- mode: _contentful_experiences_core_constants.StudioCanvasMode;
42
+ mode: _contentful_experiences_core_constants.StudioCanvasMode.NONE;
35
43
  };
36
44
 
37
45
  type UseFetchBySlugArgs = {
@@ -43,13 +51,21 @@ type UseFetchBySlugArgs = {
43
51
  hyperlinkPattern?: string;
44
52
  };
45
53
  declare const useFetchBySlug: ({ slug, localeCode, client, experienceTypeId, hyperlinkPattern, }: UseFetchBySlugArgs) => {
54
+ experience: {
55
+ hyperlinkPattern: string | undefined;
56
+ entityStore?: _contentful_experiences_core.EntityStore | undefined;
57
+ };
58
+ error: undefined;
59
+ isLoading: boolean;
60
+ mode: _contentful_experiences_core_constants.StudioCanvasMode.READ_ONLY | _contentful_experiences_core_constants.StudioCanvasMode.EDITOR;
61
+ } | {
46
62
  experience: {
47
63
  hyperlinkPattern: string | undefined;
48
64
  entityStore?: _contentful_experiences_core.EntityStore | undefined;
49
65
  };
50
66
  error: Error | undefined;
51
67
  isLoading: boolean;
52
- mode: _contentful_experiences_core_constants.StudioCanvasMode;
68
+ mode: _contentful_experiences_core_constants.StudioCanvasMode.NONE;
53
69
  };
54
70
 
55
71
  /**
@@ -1,4 +1,4 @@
1
- const SDK_VERSION = '1.30.0-dev-20250124T1739-560b81b.0';
1
+ const SDK_VERSION = '1.30.0-dev-20250128T1255-1f90987.0';
2
2
 
3
3
  export { SDK_VERSION };
4
4
  //# sourceMappingURL=sdkVersion.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"sdkVersion.js","sources":["../../src/sdkVersion.ts"],"sourcesContent":["export const SDK_VERSION = '1.30.0-dev-20250124T1739-560b81b.0';\n"],"names":[],"mappings":"AAAO,MAAM,WAAW,GAAG;;;;"}
1
+ {"version":3,"file":"sdkVersion.js","sources":["../../src/sdkVersion.ts"],"sourcesContent":["export const SDK_VERSION = '1.30.0-dev-20250128T1255-1f90987.0';\n"],"names":[],"mappings":"AAAO,MAAM,WAAW,GAAG;;;;"}
@@ -2,8 +2,13 @@ import { EntityStore } from '@contentful/experiences-core';
2
2
  import type { Experience } from '@contentful/experiences-core/types';
3
3
  import { StudioCanvasMode } from '@contentful/experiences-core/constants';
4
4
  export declare const useFetchByBase: (fetchMethod: () => Promise<Experience<EntityStore> | undefined>, mode: StudioCanvasMode) => {
5
+ error: undefined;
6
+ experience: undefined;
7
+ isLoading: boolean;
8
+ mode: StudioCanvasMode.READ_ONLY | StudioCanvasMode.EDITOR;
9
+ } | {
5
10
  error: Error | undefined;
6
11
  experience: Experience<EntityStore> | undefined;
7
12
  isLoading: boolean;
8
- mode: StudioCanvasMode;
13
+ mode: StudioCanvasMode.NONE;
9
14
  };
@@ -7,11 +7,19 @@ export type UseFetchByIdArgs = {
7
7
  hyperlinkPattern?: string;
8
8
  };
9
9
  export declare const useFetchById: ({ id, localeCode, client, experienceTypeId, hyperlinkPattern, }: UseFetchByIdArgs) => {
10
+ experience: {
11
+ hyperlinkPattern: string | undefined;
12
+ entityStore?: import("@contentful/experiences-core").EntityStore | undefined;
13
+ };
14
+ error: undefined;
15
+ isLoading: boolean;
16
+ mode: import("@contentful/experiences-core/constants").StudioCanvasMode.READ_ONLY | import("@contentful/experiences-core/constants").StudioCanvasMode.EDITOR;
17
+ } | {
10
18
  experience: {
11
19
  hyperlinkPattern: string | undefined;
12
20
  entityStore?: import("@contentful/experiences-core").EntityStore | undefined;
13
21
  };
14
22
  error: Error | undefined;
15
23
  isLoading: boolean;
16
- mode: import("@contentful/experiences-core/constants").StudioCanvasMode;
24
+ mode: import("@contentful/experiences-core/constants").StudioCanvasMode.NONE;
17
25
  };
@@ -8,11 +8,19 @@ export type UseFetchBySlugArgs = {
8
8
  hyperlinkPattern?: string;
9
9
  };
10
10
  export declare const useFetchBySlug: ({ slug, localeCode, client, experienceTypeId, hyperlinkPattern, }: UseFetchBySlugArgs) => {
11
+ experience: {
12
+ hyperlinkPattern: string | undefined;
13
+ entityStore?: import("@contentful/experiences-core").EntityStore | undefined;
14
+ };
15
+ error: undefined;
16
+ isLoading: boolean;
17
+ mode: import("@contentful/experiences-core/constants").StudioCanvasMode.READ_ONLY | import("@contentful/experiences-core/constants").StudioCanvasMode.EDITOR;
18
+ } | {
11
19
  experience: {
12
20
  hyperlinkPattern: string | undefined;
13
21
  entityStore?: import("@contentful/experiences-core").EntityStore | undefined;
14
22
  };
15
23
  error: Error | undefined;
16
24
  isLoading: boolean;
17
- mode: import("@contentful/experiences-core/constants").StudioCanvasMode;
25
+ mode: import("@contentful/experiences-core/constants").StudioCanvasMode.NONE;
18
26
  };
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "1.30.0-dev-20250124T1739-560b81b.0";
1
+ export declare const SDK_VERSION = "1.30.0-dev-20250128T1255-1f90987.0";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@contentful/experiences-sdk-react",
3
- "version": "1.30.0-dev-20250124T1739-560b81b.0",
3
+ "version": "1.30.0-dev-20250128T1255-1f90987.0",
4
4
  "main": "./dist/index.js",
5
5
  "module": "./dist/index.js",
6
6
  "typings": "./dist/src/index.d.ts",
@@ -41,10 +41,10 @@
41
41
  "depcruise": "depcruise src"
42
42
  },
43
43
  "dependencies": {
44
- "@contentful/experiences-components-react": "1.30.0-dev-20250124T1739-560b81b.0",
45
- "@contentful/experiences-core": "1.30.0-dev-20250124T1739-560b81b.0",
46
- "@contentful/experiences-validators": "1.30.0-dev-20250124T1739-560b81b.0",
47
- "@contentful/experiences-visual-editor-react": "1.30.0-dev-20250124T1739-560b81b.0",
44
+ "@contentful/experiences-components-react": "1.30.0-dev-20250128T1255-1f90987.0",
45
+ "@contentful/experiences-core": "1.30.0-dev-20250128T1255-1f90987.0",
46
+ "@contentful/experiences-validators": "1.30.0-dev-20250128T1255-1f90987.0",
47
+ "@contentful/experiences-visual-editor-react": "1.30.0-dev-20250128T1255-1f90987.0",
48
48
  "@contentful/rich-text-types": "^17.0.0",
49
49
  "classnames": "^2.3.2",
50
50
  "csstype": "^3.1.2",
@@ -102,5 +102,5 @@
102
102
  "dist",
103
103
  "package.json"
104
104
  ],
105
- "gitHead": "5c79b509edb4485c183c4a9b5b44900498698825"
105
+ "gitHead": "e8d9ca1b48f734c139b55d9913fa97579b5fea00"
106
106
  }