docs: add backwards compatibility warnings to recorder entrypoints (#3167)

* Initial plan

* Add backwards compatibility comments to recorder entrypoints

Co-authored-by: pauldambra <984817+pauldambra@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pauldambra <984817+pauldambra@users.noreply.github.com>

Author: Copilot

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

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'

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'