@replohq/canopy-sdk 1.0.2 → 1.0.3

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.
@@ -18,6 +18,8 @@ interface PostHogReplayWindow {
18
18
  };
19
19
  addEventListener(type: "message", listener: PostHogReplayMessageListener): void;
20
20
  removeEventListener(type: "message", listener: PostHogReplayMessageListener): void;
21
+ setTimeout(listener: () => void, timeout: number): number;
22
+ clearTimeout(timeoutId: number): void;
21
23
  }
22
24
  declare global {
23
25
  interface Window {
@@ -29,7 +31,13 @@ declare global {
29
31
  export declare function requestChildPostHogReplaySnapshots({ targetWindow, }: {
30
32
  targetWindow: PostHogReplayWindow;
31
33
  }): void;
32
- export declare function startChildPostHogReplaySnapshotRelay({ targetWindow, }: {
34
+ export declare function startPostHogReplaySnapshotCascade({ isRecordingStarted, targetWindow, onReady, }: {
35
+ isRecordingStarted: () => boolean;
36
+ targetWindow: PostHogReplayWindow;
37
+ onReady?: () => void;
38
+ }): () => void;
39
+ export declare function startChildPostHogReplaySnapshotRelay({ isRecordingStarted, targetWindow, }: {
40
+ isRecordingStarted: () => boolean;
33
41
  targetWindow: PostHogReplayWindow;
34
42
  }): () => void;
35
43
  export {};
@@ -1,5 +1,7 @@
1
1
  // ../replo-utils/lib/posthogReplay.ts
2
2
  var POSTHOG_REPLAY_SNAPSHOT_REQUEST = "posthog:replay:request-full-snapshot";
3
+ var POSTHOG_REPLAY_READY_POLL_INTERVAL_MS = 100;
4
+ var POSTHOG_REPLAY_READY_POLL_TIMEOUT_MS = 1e4;
3
5
  function requestChildPostHogReplaySnapshots({
4
6
  targetWindow
5
7
  }) {
@@ -11,8 +13,12 @@ function requestChildPostHogReplaySnapshots({
11
13
  }
12
14
  }
13
15
  function takePostHogReplayFullSnapshot({
16
+ isRecordingStarted,
14
17
  targetWindow
15
18
  }) {
19
+ if (!isRecordingStarted()) {
20
+ return false;
21
+ }
16
22
  const takeFullSnapshot = targetWindow.__PosthogExtensions__?.rrweb?.record.takeFullSnapshot;
17
23
  if (!takeFullSnapshot) {
18
24
  return false;
@@ -24,20 +30,92 @@ function takePostHogReplayFullSnapshot({
24
30
  return false;
25
31
  }
26
32
  }
33
+ function startPostHogReplaySnapshotCascade({
34
+ isRecordingStarted,
35
+ targetWindow,
36
+ onReady
37
+ }) {
38
+ const replayReadyPollDeadline = Date.now() + POSTHOG_REPLAY_READY_POLL_TIMEOUT_MS;
39
+ let timeoutId;
40
+ let stopCascading;
41
+ const startCascadingWhenReady = () => {
42
+ const record = targetWindow.__PosthogExtensions__?.rrweb?.record;
43
+ const takeFullSnapshot = record?.takeFullSnapshot;
44
+ if (!record || !takeFullSnapshot || !isRecordingStarted()) {
45
+ if (Date.now() < replayReadyPollDeadline) {
46
+ timeoutId = targetWindow.setTimeout(
47
+ startCascadingWhenReady,
48
+ POSTHOG_REPLAY_READY_POLL_INTERVAL_MS
49
+ );
50
+ }
51
+ return;
52
+ }
53
+ const takeFullSnapshotAndCascade = () => {
54
+ takeFullSnapshot();
55
+ requestChildPostHogReplaySnapshots({ targetWindow });
56
+ };
57
+ record.takeFullSnapshot = takeFullSnapshotAndCascade;
58
+ stopCascading = () => {
59
+ if (record.takeFullSnapshot === takeFullSnapshotAndCascade) {
60
+ record.takeFullSnapshot = takeFullSnapshot;
61
+ }
62
+ };
63
+ onReady?.();
64
+ };
65
+ startCascadingWhenReady();
66
+ return () => {
67
+ if (timeoutId !== void 0) {
68
+ targetWindow.clearTimeout(timeoutId);
69
+ }
70
+ stopCascading?.();
71
+ };
72
+ }
27
73
  function startChildPostHogReplaySnapshotRelay({
74
+ isRecordingStarted,
28
75
  targetWindow
29
76
  }) {
77
+ if (targetWindow.parent === targetWindow) {
78
+ return () => {
79
+ };
80
+ }
81
+ let hasPendingSnapshotRequest = false;
82
+ let isSnapshotCascadeReady = false;
83
+ let stopCascadingSnapshots = () => {
84
+ };
85
+ const startCascadingSnapshots = () => {
86
+ stopCascadingSnapshots();
87
+ isSnapshotCascadeReady = false;
88
+ stopCascadingSnapshots = startPostHogReplaySnapshotCascade({
89
+ isRecordingStarted,
90
+ targetWindow,
91
+ onReady: () => {
92
+ isSnapshotCascadeReady = true;
93
+ if (hasPendingSnapshotRequest) {
94
+ hasPendingSnapshotRequest = false;
95
+ takePostHogReplayFullSnapshot({ isRecordingStarted, targetWindow });
96
+ }
97
+ }
98
+ });
99
+ };
100
+ startCascadingSnapshots();
30
101
  const onMessage = (event) => {
31
102
  if (event.source !== targetWindow.parent || event.data !== POSTHOG_REPLAY_SNAPSHOT_REQUEST) {
32
103
  return;
33
104
  }
34
- if (!takePostHogReplayFullSnapshot({ targetWindow })) {
105
+ if (!takePostHogReplayFullSnapshot({ isRecordingStarted, targetWindow })) {
106
+ hasPendingSnapshotRequest = true;
107
+ startCascadingSnapshots();
35
108
  return;
36
109
  }
37
- requestChildPostHogReplaySnapshots({ targetWindow });
110
+ if (!isSnapshotCascadeReady) {
111
+ requestChildPostHogReplaySnapshots({ targetWindow });
112
+ }
38
113
  };
39
114
  targetWindow.addEventListener("message", onMessage);
40
- return () => targetWindow.removeEventListener("message", onMessage);
115
+ return () => {
116
+ stopCascadingSnapshots();
117
+ targetWindow.removeEventListener("message", onMessage);
118
+ };
41
119
  }
42
120
 
43
- export { POSTHOG_REPLAY_SNAPSHOT_REQUEST, requestChildPostHogReplaySnapshots, startChildPostHogReplaySnapshotRelay };
121
+ export { POSTHOG_REPLAY_SNAPSHOT_REQUEST, requestChildPostHogReplaySnapshots, startChildPostHogReplaySnapshotRelay, startPostHogReplaySnapshotCascade };
@@ -1,5 +1,6 @@
1
1
  interface PostHog {
2
2
  init: (apiKey: string, config: Record<string, unknown>) => void;
3
+ sessionRecordingStarted: () => boolean;
3
4
  }
4
5
  declare global {
5
6
  interface Window {
@@ -56,6 +56,9 @@ function initPostHogRelay() {
56
56
  function PostHogRelay() {
57
57
  useEffect(() => {
58
58
  const stopRelayingSnapshotRequests = startChildPostHogReplaySnapshotRelay({
59
+ isRecordingStarted: () => {
60
+ return window.posthog?.sessionRecordingStarted() ?? false;
61
+ },
59
62
  targetWindow: window
60
63
  });
61
64
  void initPostHogRelay();
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../editor/posthog-relay.tsx"],
4
- "sourcesContent": ["\"use client\";\n\n/**\n * PostHog Cross-Origin Iframe Relay\n *\n * Initializes PostHog inside the sandbox iframe as a \"relay\" - it captures DOM\n * mutations via rrweb and sends them to the parent window's PostHog instance\n * via postMessage, enabling session recordings to include iframe content.\n */\nimport { useEffect } from \"react\";\n\nimport { startChildPostHogReplaySnapshotRelay } from \"replo-utils/lib/posthogReplay\";\n\nconst POSTHOG_API_KEY = \"phc_dRETsj85vNkKrvQQszEFRBibH5kUF9l7rbjACuKPanZ\";\nconst POSTHOG_API_HOST = \"https://d99bbtllqsaif.cloudfront.net\";\n\ninterface PostHog {\n init: (apiKey: string, config: Record<string, unknown>) => void;\n}\n\ndeclare global {\n interface Window {\n posthog?: PostHog;\n }\n}\n\nlet initPromise: Promise<void> | null = null;\n\nfunction loadPostHogScript() {\n return new Promise<void>((resolve) => {\n if (window.posthog) {\n resolve();\n return;\n }\n\n const script = document.createElement(\"script\");\n script.src = `${POSTHOG_API_HOST}/static/array.js`;\n script.async = true;\n script.addEventListener(\"load\", () => resolve());\n script.addEventListener(\"error\", () => {\n resolve();\n console.warn(\"[PostHog Relay] Failed to load PostHog script\");\n });\n document.head.append(script);\n });\n}\n\nfunction initPostHogRelay() {\n if (window.self === window.top) {\n return Promise.resolve();\n }\n\n if (initPromise) {\n return initPromise;\n }\n\n initPromise = (async () => {\n await loadPostHogScript();\n\n if (!window.posthog) {\n initPromise = null;\n console.warn(\"[PostHog Relay] PostHog not available after script load\");\n return;\n }\n\n window.posthog.init(POSTHOG_API_KEY, {\n api_host: POSTHOG_API_HOST,\n persistence: \"localStorage\",\n autocapture: false,\n // (Noah, 2026-07-14, REPL-29305): Disable performance capture \u2014 its PerformanceObserver\n // relays a non-cloneable PerformanceServerTiming across the iframe boundary via postMessage,\n // throwing a DataCloneError in the preview. Matches the bedrock-sdk relay.\n capture_performance: false,\n capture_pageview: false,\n session_recording: {\n recordCrossOriginIframes: true,\n // NOTE (Nick, 2026-02-02, REPL-23284): Disable canvas recording to prevent SecurityError on tainted canvases\n captureCanvas: { recordCanvas: false },\n },\n });\n })();\n\n return initPromise;\n}\n\nexport default function PostHogRelay() {\n // eslint-disable-next-line replo/no-use-effect -- External replay script and cross-frame listener lifecycle.\n useEffect(() => {\n const stopRelayingSnapshotRequests = startChildPostHogReplaySnapshotRelay({\n targetWindow: window,\n });\n void initPostHogRelay();\n return stopRelayingSnapshotRequests;\n }, []);\n\n return null;\n}\n"],
5
- "mappings": ";AASA,SAAS,iBAAiB;AAE1B,SAAS,4CAA4C;AAErD,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AAYzB,IAAI,cAAoC;AAExC,SAAS,oBAAoB;AAC3B,SAAO,IAAI,QAAc,CAAC,YAAY;AACpC,QAAI,OAAO,SAAS;AAClB,cAAQ;AACR;AAAA,IACF;AAEA,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,MAAM,GAAG,gBAAgB;AAChC,WAAO,QAAQ;AACf,WAAO,iBAAiB,QAAQ,MAAM,QAAQ,CAAC;AAC/C,WAAO,iBAAiB,SAAS,MAAM;AACrC,cAAQ;AACR,cAAQ,KAAK,+CAA+C;AAAA,IAC9D,CAAC;AACD,aAAS,KAAK,OAAO,MAAM;AAAA,EAC7B,CAAC;AACH;AAEA,SAAS,mBAAmB;AAC1B,MAAI,OAAO,SAAS,OAAO,KAAK;AAC9B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAEA,MAAI,aAAa;AACf,WAAO;AAAA,EACT;AAEA,iBAAe,YAAY;AACzB,UAAM,kBAAkB;AAExB,QAAI,CAAC,OAAO,SAAS;AACnB,oBAAc;AACd,cAAQ,KAAK,yDAAyD;AACtE;AAAA,IACF;AAEA,WAAO,QAAQ,KAAK,iBAAiB;AAAA,MACnC,UAAU;AAAA,MACV,aAAa;AAAA,MACb,aAAa;AAAA;AAAA;AAAA;AAAA,MAIb,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,QACjB,0BAA0B;AAAA;AAAA,QAE1B,eAAe,EAAE,cAAc,MAAM;AAAA,MACvC;AAAA,IACF,CAAC;AAAA,EACH,GAAG;AAEH,SAAO;AACT;AAEe,SAAR,eAAgC;AAErC,YAAU,MAAM;AACd,UAAM,+BAA+B,qCAAqC;AAAA,MACxE,cAAc;AAAA,IAChB,CAAC;AACD,SAAK,iBAAiB;AACtB,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,SAAO;AACT;",
4
+ "sourcesContent": ["\"use client\";\n\n/**\n * PostHog Cross-Origin Iframe Relay\n *\n * Initializes PostHog inside the sandbox iframe as a \"relay\" - it captures DOM\n * mutations via rrweb and sends them to the parent window's PostHog instance\n * via postMessage, enabling session recordings to include iframe content.\n */\nimport { useEffect } from \"react\";\n\nimport { startChildPostHogReplaySnapshotRelay } from \"replo-utils/lib/posthogReplay\";\n\nconst POSTHOG_API_KEY = \"phc_dRETsj85vNkKrvQQszEFRBibH5kUF9l7rbjACuKPanZ\";\nconst POSTHOG_API_HOST = \"https://d99bbtllqsaif.cloudfront.net\";\n\ninterface PostHog {\n init: (apiKey: string, config: Record<string, unknown>) => void;\n sessionRecordingStarted: () => boolean;\n}\n\ndeclare global {\n interface Window {\n posthog?: PostHog;\n }\n}\n\nlet initPromise: Promise<void> | null = null;\n\nfunction loadPostHogScript() {\n return new Promise<void>((resolve) => {\n if (window.posthog) {\n resolve();\n return;\n }\n\n const script = document.createElement(\"script\");\n script.src = `${POSTHOG_API_HOST}/static/array.js`;\n script.async = true;\n script.addEventListener(\"load\", () => resolve());\n script.addEventListener(\"error\", () => {\n resolve();\n console.warn(\"[PostHog Relay] Failed to load PostHog script\");\n });\n document.head.append(script);\n });\n}\n\nfunction initPostHogRelay() {\n if (window.self === window.top) {\n return Promise.resolve();\n }\n\n if (initPromise) {\n return initPromise;\n }\n\n initPromise = (async () => {\n await loadPostHogScript();\n\n if (!window.posthog) {\n initPromise = null;\n console.warn(\"[PostHog Relay] PostHog not available after script load\");\n return;\n }\n\n window.posthog.init(POSTHOG_API_KEY, {\n api_host: POSTHOG_API_HOST,\n persistence: \"localStorage\",\n autocapture: false,\n // (Noah, 2026-07-14, REPL-29305): Disable performance capture \u2014 its PerformanceObserver\n // relays a non-cloneable PerformanceServerTiming across the iframe boundary via postMessage,\n // throwing a DataCloneError in the preview. Matches the bedrock-sdk relay.\n capture_performance: false,\n capture_pageview: false,\n session_recording: {\n recordCrossOriginIframes: true,\n // NOTE (Nick, 2026-02-02, REPL-23284): Disable canvas recording to prevent SecurityError on tainted canvases\n captureCanvas: { recordCanvas: false },\n },\n });\n })();\n\n return initPromise;\n}\n\nexport default function PostHogRelay() {\n // eslint-disable-next-line replo/no-use-effect -- External replay script and cross-frame listener lifecycle.\n useEffect(() => {\n const stopRelayingSnapshotRequests = startChildPostHogReplaySnapshotRelay({\n isRecordingStarted: () => {\n return window.posthog?.sessionRecordingStarted() ?? false;\n },\n targetWindow: window,\n });\n void initPostHogRelay();\n return stopRelayingSnapshotRequests;\n }, []);\n\n return null;\n}\n"],
5
+ "mappings": ";AASA,SAAS,iBAAiB;AAE1B,SAAS,4CAA4C;AAErD,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AAazB,IAAI,cAAoC;AAExC,SAAS,oBAAoB;AAC3B,SAAO,IAAI,QAAc,CAAC,YAAY;AACpC,QAAI,OAAO,SAAS;AAClB,cAAQ;AACR;AAAA,IACF;AAEA,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,MAAM,GAAG,gBAAgB;AAChC,WAAO,QAAQ;AACf,WAAO,iBAAiB,QAAQ,MAAM,QAAQ,CAAC;AAC/C,WAAO,iBAAiB,SAAS,MAAM;AACrC,cAAQ;AACR,cAAQ,KAAK,+CAA+C;AAAA,IAC9D,CAAC;AACD,aAAS,KAAK,OAAO,MAAM;AAAA,EAC7B,CAAC;AACH;AAEA,SAAS,mBAAmB;AAC1B,MAAI,OAAO,SAAS,OAAO,KAAK;AAC9B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAEA,MAAI,aAAa;AACf,WAAO;AAAA,EACT;AAEA,iBAAe,YAAY;AACzB,UAAM,kBAAkB;AAExB,QAAI,CAAC,OAAO,SAAS;AACnB,oBAAc;AACd,cAAQ,KAAK,yDAAyD;AACtE;AAAA,IACF;AAEA,WAAO,QAAQ,KAAK,iBAAiB;AAAA,MACnC,UAAU;AAAA,MACV,aAAa;AAAA,MACb,aAAa;AAAA;AAAA;AAAA;AAAA,MAIb,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,QACjB,0BAA0B;AAAA;AAAA,QAE1B,eAAe,EAAE,cAAc,MAAM;AAAA,MACvC;AAAA,IACF,CAAC;AAAA,EACH,GAAG;AAEH,SAAO;AACT;AAEe,SAAR,eAAgC;AAErC,YAAU,MAAM;AACd,UAAM,+BAA+B,qCAAqC;AAAA,MACxE,oBAAoB,MAAM;AACxB,eAAO,OAAO,SAAS,wBAAwB,KAAK;AAAA,MACtD;AAAA,MACA,cAAc;AAAA,IAChB,CAAC;AACD,SAAK,iBAAiB;AACtB,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,SAAO;AACT;",
6
6
  "names": []
7
7
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@replohq/canopy-sdk",
3
- "version": "1.0.2",
3
+ "version": "1.0.3",
4
4
  "description": "Replo Canopy SDK — cart, analytics, data loaders, and editor runtime for agent-built Next.js sites.",
5
5
  "type": "module",
6
6
  "sideEffects": false,