fix: Narrow extension types as non-optional for full bundle

This ensures 100% backwards compatibility

Author: dustinbyrne

packages/browser/src/entrypoints/main.cjs.ts

@@ -1,10 +1,16 @@
 import './default-extensions'
 import './external-scripts-loader'
-import { init_as_module } from '../posthog-core'
-export { PostHog } from '../posthog-core'
+import { init_as_module, PostHog as _PostHog, type PostHogWithExtensions } from '../posthog-core'
+
+// In the full bundle, tree-shakeable extensions are always loaded,
+// so we narrow the type to make them non-optional.
+export const PostHog = _PostHog as typeof _PostHog &
+    (new (...args: ConstructorParameters<typeof _PostHog>) => PostHogWithExtensions)
+export type PostHog = PostHogWithExtensions
+
 export * from '../types'
 export * from '../posthog-surveys-types'
 export * from '../posthog-product-tours-types'
 export * from '../posthog-conversations-types'
-export const posthog = init_as_module()
+export const posthog = init_as_module() as PostHogWithExtensions
 export default posthog

packages/browser/src/entrypoints/module.no-external.es.ts

@@ -1,9 +1,14 @@
 import './default-extensions'
-import { init_as_module } from '../posthog-core'
-export { PostHog } from '../posthog-core'
+import { init_as_module, PostHog as _PostHog, type PostHogWithExtensions } from '../posthog-core'
+
+// In the full bundle, tree-shakeable extensions are always loaded,
+// so we narrow the type to make them non-optional.
+export const PostHog = _PostHog as typeof _PostHog & (new (...args: ConstructorParameters<typeof _PostHog>) => PostHogWithExtensions)
+export type PostHog = PostHogWithExtensions
+
 export * from '../types'
 export * from '../posthog-surveys-types'
 export * from '../posthog-product-tours-types'
 export * from '../posthog-conversations-types'
-export const posthog = init_as_module()
+export const posthog = init_as_module() as PostHogWithExtensions
 export default posthog

packages/browser/src/posthog-core.ts

@@ -3889,6 +3889,13 @@ export function init_from_snippet(): void {
     add_dom_loaded_handler()
 }
 
+/**
+ * When using the full bundle, all tree-shakeable extensions are guaranteed to be available.
+ * The slim bundle keeps them optional.
+ */
+export type PostHogWithExtensions = PostHog &
+    Required<Pick<PostHog, 'surveys' | 'conversations' | 'logs' | 'experiments' | 'toolbar' | 'exceptions'>>
+
 export function init_as_module(): PostHog {
     const posthogMain = (instances[PRIMARY_INSTANCE_NAME] = new PostHog())