From a4416d41b30283f9ce4ad3565117d26386d463de Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 26 Feb 2026 23:01:37 +0000
Subject: [PATCH 1/2] Initial plan


From 47db8adbdc80f3dbb813655f46c2d2eff5415f2d Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 26 Feb 2026 23:02:40 +0000
Subject: [PATCH 2/2] Add backwards compatibility comments to recorder
 entrypoints

Co-authored-by: pauldambra <984817+pauldambra@users.noreply.github.com>
---
 packages/browser/src/entrypoints/lazy-recorder.ts | 3 +++
 packages/browser/src/entrypoints/recorder-v2.ts   | 3 ++-
 packages/browser/src/entrypoints/recorder.ts      | 3 +++
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/browser/src/entrypoints/lazy-recorder.ts b/packages/browser/src/entrypoints/lazy-recorder.ts
index e755fcda39..6aeefb3edd 100644
--- a/packages/browser/src/entrypoints/lazy-recorder.ts
+++ b/packages/browser/src/entrypoints/lazy-recorder.ts
@@ -1,3 +1,6 @@
+// This file is kept only for backwards compatibility.
+// In almost every case, if you are manually importing a file you should use posthog-recorder instead.
+
 // This is only here for so that users with cached recorder.ts don't get errors during the transition to lazy loading
 // if you have the new eager loaded recording code it will request this file, not `recorder.js`
 // so you don't have the problem that clients get new code and a cached recorder.js
diff --git a/packages/browser/src/entrypoints/recorder-v2.ts b/packages/browser/src/entrypoints/recorder-v2.ts
index d080f9e570..3e1fdc4f0c 100644
--- a/packages/browser/src/entrypoints/recorder-v2.ts
+++ b/packages/browser/src/entrypoints/recorder-v2.ts
@@ -1,2 +1,3 @@
-// This is only here for backwards compatibility
+// This file is kept only for backwards compatibility.
+// In almost every case, if you are manually importing a file you should use posthog-recorder instead.
 export * from './recorder'
diff --git a/packages/browser/src/entrypoints/recorder.ts b/packages/browser/src/entrypoints/recorder.ts
index 0ac68d0179..730a3f8468 100644
--- a/packages/browser/src/entrypoints/recorder.ts
+++ b/packages/browser/src/entrypoints/recorder.ts
@@ -1,3 +1,6 @@
+// This file is kept only for backwards compatibility.
+// In almost every case, if you are manually importing a file you should use posthog-recorder instead.
+
 import { record as rrwebRecord } from '@rrweb/record'
 import { getRecordConsolePlugin } from '@rrweb/rrweb-plugin-console-record'
 import { getRecordNetworkPlugin } from '../extensions/replay/external/network-plugin'